Refactor/code wiki kb

backend/.env.example

@@ -213,6 +213,11 @@ WIKI_ENABLED=True
 # The team's bot MUST have a model configured (bind_model or custom config)
 # If no model is configured, wiki generation will be disabled in the frontend
 WIKI_DEFAULT_TEAM_NAME=wiki-team
+# Team that runs knowledge-base code wikis (matches init_data/02-public-resources.yaml)
+# Separate from WIKI_DEFAULT_TEAM_NAME: the two paths give their agents different
+# instructions and different submission rules, so they cannot share one team.
+# Its bot MUST have a model configured (bind_model or custom config)
+WIKI_CODE_WIKI_TEAM_NAME=code-wiki-team
 # Default agent type for wiki generation
 WIKI_DEFAULT_AGENT_TYPE=ClaudeCode
 # Default language for wiki documentation generation (en = English, zh = Chinese)

backend/alembic/versions/20260731_bd9c871a93d2_add_knowledge_content_origin_and_wiki_.py

@@ -0,0 +1,77 @@
+"""add knowledge content origin and wiki generation kb link
+
+Revision ID: bd9c871a93d2
+Revises: b9c0d1e2f3a4
+
+Adds the two things a code wiki needs to coexist with ordinary knowledge content:
+
+- ``origin`` on documents and folders, marking whether a row is agent-generated or
+  user-owned. It defaults to ``user`` so that every existing row, and every row this
+  service does not create itself, is excluded from the generated-content projection.
+  Getting this backwards would let a regeneration delete content nobody can restore.
+- ``kind_id`` on wiki generations, binding a version line to a knowledge base. The
+  versions previously hung off ``wiki_projects``, whose ``source_url`` is globally
+  unique; leaving them there would share one version line between knowledge bases
+  tracking the same repository. ``0`` marks rows that predate code wikis.
+
+All three columns are NOT NULL with a server default, as required for existing rows to
+backfill without a nullable intermediate state.
+"""
+
+from collections.abc import Sequence
+from typing import Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "bd9c871a93d2"
+down_revision: Union[str, Sequence[str], None] = "b9c0d1e2f3a4"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column(
+        "knowledge_documents",
+        sa.Column(
+            "origin",
+            sa.String(length=20),
+            nullable=False,
+            server_default="user",
+            comment="Content ownership: 'generated' (agent-owned) or 'user'",
+        ),
+    )
+    op.add_column(
+        "knowledge_folders",
+        sa.Column(
+            "origin",
+            sa.String(length=20),
+            nullable=False,
+            server_default="user",
+            comment="Content ownership: 'generated' (agent-owned) or 'user'",
+        ),
+    )
+    op.add_column(
+        "wiki_generations",
+        sa.Column(
+            "kind_id",
+            sa.Integer(),
+            nullable=False,
+            server_default="0",
+            comment="Knowledge base this version line belongs to; 0 = legacy row",
+        ),
+    )
+    op.create_index(
+        "ix_wiki_generations_kind_id", "wiki_generations", ["kind_id"], unique=False
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index("ix_wiki_generations_kind_id", table_name="wiki_generations")
+    op.drop_column("wiki_generations", "kind_id")
+    op.drop_column("knowledge_folders", "origin")
+    op.drop_column("knowledge_documents", "origin")

backend/alembic/versions/20260804_2b5791acc5fa_link_wiki_projects_to_their_code_wiki.py

@@ -0,0 +1,48 @@
+"""link wiki projects to their code wiki
+
+Revision ID: 2b5791acc5fa
+Revises: bd9c871a93d2
+
+``wiki_projects.source_url`` is already UNIQUE, which makes this table the only place
+that can enforce "one repository, one code wiki" against two people creating at the
+same moment. Recording the knowledge base here, rather than checking a JSON field on
+the knowledge base itself, turns a check-then-insert into a database constraint.
+
+``0`` marks a project row with no code wiki, which is every row that exists today.
+"""
+
+from collections.abc import Sequence
+from typing import Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "2b5791acc5fa"
+down_revision: Union[str, Sequence[str], None] = "bd9c871a93d2"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column(
+        "wiki_projects",
+        sa.Column(
+            "kind_id",
+            sa.Integer(),
+            nullable=False,
+            server_default="0",
+            comment="Code wiki knowledge base built from this repository; 0 = none",
+        ),
+    )
+    op.create_index(
+        "ix_wiki_projects_kind_id", "wiki_projects", ["kind_id"], unique=False
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index("ix_wiki_projects_kind_id", table_name="wiki_projects")
+    op.drop_column("wiki_projects", "kind_id")