@kernel-sig/console 0.1.0

package/backend/alembic/versions/87a008142f17_add_classification_attention_and_ai_.py

@@ -0,0 +1,436 @@
+"""新增分类、关注项与 AI 分析相关的表
+
+Revision ID: 87a008142f17
+Revises: d1275091dfdc
+Create Date: 2026-09-16
+
+- ksp_classification：PR/Issue 的类型、子系统、CVE 归属。规则引擎先算，
+  AI 兜底，人工覆盖后不再被自动任务改写
+- ksp_attention_item：由 domain.attention 的规则求值得到的待办队列。
+  每次重算保留 first_detected_at，已解决的置 resolved_at 而非删除 ——
+  「这条挂了多久」本身就是维护者要看的信号
+- ksp_label_sync_state：记录已建到 AtomGit 的分类标签，避免重复创建
+- ksp_llm_provider / ksp_task_routing / ksp_ai_analysis / ksp_prompt_template：
+  AI 对接。分析结果以 (subject, task) 唯一约束 + input_hash 做幂等，
+  内容未变不重复调用模型
+
+枚举类型 ai_task 被三张表共用，而 op.create_table 默认会为每张表各发一次
+CREATE TYPE，第二次即报「类型已存在」。因此这里先显式建类型，
+列定义上关闭自动创建。
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+revision: str = "87a008142f17"
+down_revision: str | None = "d1275091dfdc"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+# 跨表共用的枚举类型：先建一次，列上不再自动创建
+AI_TASK_VALUES = ("classify", "summarize", "risk_review", "backport_verify")
+
+
+def _ai_task_enum() -> postgresql.ENUM:
+    return postgresql.ENUM(*AI_TASK_VALUES, name="ai_task", create_type=False)
+
+
+def upgrade() -> None:
+    ai_task = _ai_task_enum()
+    ai_task.create(op.get_bind(), checkfirst=True)
+
+    op.create_table(
+        "ksp_prompt_template",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("task", _ai_task_enum(), nullable=False),
+        sa.Column("name", sa.String(length=128), nullable=False),
+        sa.Column("version", sa.Integer(), nullable=False),
+        sa.Column("system_prompt", sa.Text(), nullable=False),
+        sa.Column("user_template", sa.Text(), nullable=False),
+        sa.Column("is_active", sa.Boolean(), nullable=False),
+        sa.Column("created_by", sa.UUID(), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["created_by"],
+            ["ksp_user.id"],
+            name=op.f("fk_ksp_prompt_template_created_by_ksp_user"),
+            ondelete="SET NULL",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_prompt_template")),
+        sa.UniqueConstraint("task", "version", name="uq_ksp_prompt_task_version"),
+    )
+    op.create_index(op.f("ix_ksp_prompt_template_task"), "ksp_prompt_template", ["task"])
+
+    op.create_table(
+        "ksp_llm_provider",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("name", sa.String(length=64), nullable=False),
+        sa.Column(
+            "kind",
+            sa.Enum(
+                "openai_compatible",
+                name="ai_provider_kind",
+            ),
+            nullable=False,
+        ),
+        sa.Column("base_url", sa.String(length=255), nullable=False),
+        sa.Column("credential_id", sa.UUID(), nullable=True),
+        sa.Column("model", sa.String(length=128), nullable=False),
+        sa.Column("temperature", sa.Float(), nullable=False),
+        sa.Column("max_tokens", sa.Integer(), nullable=False),
+        sa.Column("timeout_seconds", sa.Integer(), nullable=False),
+        sa.Column("enabled", sa.Boolean(), nullable=False),
+        sa.Column("is_default", sa.Boolean(), nullable=False),
+        sa.Column("last_used_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("last_error", sa.Text(), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["credential_id"],
+            ["ksp_credential.id"],
+            name=op.f("fk_ksp_llm_provider_credential_id_ksp_credential"),
+            ondelete="SET NULL",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_llm_provider")),
+        sa.UniqueConstraint("name", name=op.f("uq_ksp_llm_provider_name")),
+    )
+
+    op.create_table(
+        "ksp_ai_analysis",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("repository_id", sa.UUID(), nullable=False),
+        sa.Column("subject_type", sa.String(length=32), nullable=False),
+        sa.Column("subject_id", sa.UUID(), nullable=False),
+        sa.Column("task", _ai_task_enum(), nullable=False),
+        sa.Column(
+            "status",
+            sa.Enum(
+                "pending",
+                "running",
+                "succeeded",
+                "failed",
+                name="ai_analysis_status",
+            ),
+            nullable=False,
+        ),
+        sa.Column("provider_name", sa.String(length=64), nullable=True),
+        sa.Column("model", sa.String(length=128), nullable=True),
+        sa.Column("input_hash", sa.String(length=64), nullable=True),
+        sa.Column("prompt_tokens", sa.Integer(), nullable=False),
+        sa.Column("completion_tokens", sa.Integer(), nullable=False),
+        sa.Column("result", postgresql.JSONB(astext_type=sa.Text()), nullable=True),
+        sa.Column("raw_response", sa.Text(), nullable=True),
+        sa.Column("error", sa.Text(), nullable=True),
+        sa.Column("triggered_by", sa.UUID(), nullable=True),
+        sa.Column("started_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("finished_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["repository_id"],
+            ["ksp_repository.id"],
+            name=op.f("fk_ksp_ai_analysis_repository_id_ksp_repository"),
+            ondelete="CASCADE",
+        ),
+        sa.ForeignKeyConstraint(
+            ["triggered_by"],
+            ["ksp_user.id"],
+            name=op.f("fk_ksp_ai_analysis_triggered_by_ksp_user"),
+            ondelete="SET NULL",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_ai_analysis")),
+        sa.UniqueConstraint(
+            "subject_type", "subject_id", "task", name="uq_ksp_ai_analysis_subject_task"
+        ),
+    )
+    op.create_index(op.f("ix_ksp_ai_analysis_created_at"), "ksp_ai_analysis", ["created_at"])
+    op.create_index(op.f("ix_ksp_ai_analysis_input_hash"), "ksp_ai_analysis", ["input_hash"])
+    op.create_index(op.f("ix_ksp_ai_analysis_repository_id"), "ksp_ai_analysis", ["repository_id"])
+    op.create_index(op.f("ix_ksp_ai_analysis_status"), "ksp_ai_analysis", ["status"])
+    op.create_index(op.f("ix_ksp_ai_analysis_subject_id"), "ksp_ai_analysis", ["subject_id"])
+    op.create_index(op.f("ix_ksp_ai_analysis_task"), "ksp_ai_analysis", ["task"])
+
+    op.create_table(
+        "ksp_attention_item",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("repository_id", sa.UUID(), nullable=False),
+        sa.Column("subject_type", sa.String(length=32), nullable=False),
+        sa.Column("subject_id", sa.UUID(), nullable=False),
+        sa.Column("subject_number", sa.BigInteger(), nullable=False),
+        sa.Column("subject_title", sa.Text(), nullable=False),
+        sa.Column("subject_url", sa.String(length=512), nullable=True),
+        sa.Column(
+            "rule",
+            sa.Enum(
+                "stale",
+                "review_sla_breach",
+                "ci_failed",
+                "merge_conflict",
+                "needs_issue",
+                "cla_denied",
+                "cla_pending_long",
+                "rejected",
+                "binary_file",
+                "missing_signed_off",
+                "cve_aging",
+                "issue_unassigned",
+                "issue_stale",
+                name="attention_rule",
+            ),
+            nullable=False,
+        ),
+        sa.Column(
+            "severity",
+            sa.Enum(
+                "blocker",
+                "critical",
+                "warning",
+                "info",
+                name="attention_severity",
+            ),
+            nullable=False,
+        ),
+        sa.Column("title", sa.String(length=255), nullable=False),
+        sa.Column("detail", sa.Text(), nullable=True),
+        sa.Column("evidence", postgresql.JSONB(astext_type=sa.Text()), nullable=True),
+        sa.Column(
+            "first_detected_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "last_evaluated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column("resolved_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("acknowledged_by", sa.UUID(), nullable=True),
+        sa.Column("acknowledged_at", sa.DateTime(timezone=True), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["acknowledged_by"],
+            ["ksp_user.id"],
+            name=op.f("fk_ksp_attention_item_acknowledged_by_ksp_user"),
+            ondelete="SET NULL",
+        ),
+        sa.ForeignKeyConstraint(
+            ["repository_id"],
+            ["ksp_repository.id"],
+            name=op.f("fk_ksp_attention_item_repository_id_ksp_repository"),
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_attention_item")),
+        sa.UniqueConstraint(
+            "subject_type", "subject_id", "rule", name="uq_ksp_attention_subject_rule"
+        ),
+    )
+    op.create_index(
+        op.f("ix_ksp_attention_item_repository_id"), "ksp_attention_item", ["repository_id"]
+    )
+    op.create_index(op.f("ix_ksp_attention_item_rule"), "ksp_attention_item", ["rule"])
+    op.create_index(op.f("ix_ksp_attention_item_severity"), "ksp_attention_item", ["severity"])
+    op.create_index(op.f("ix_ksp_attention_item_subject_id"), "ksp_attention_item", ["subject_id"])
+    op.create_index("ix_ksp_attention_open", "ksp_attention_item", ["resolved_at", "severity"])
+
+    op.create_table(
+        "ksp_classification",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column(
+            "subject_type",
+            sa.Enum(
+                "pull_request",
+                "issue",
+                name="classification_subject_type",
+            ),
+            nullable=False,
+        ),
+        sa.Column("subject_id", sa.UUID(), nullable=False),
+        sa.Column("repository_id", sa.UUID(), nullable=False),
+        sa.Column(
+            "kind",
+            sa.Enum(
+                "cve",
+                "backport",
+                "bugfix",
+                "feature",
+                "refactor",
+                "docs",
+                "cleanup",
+                "unknown",
+                name="pr_kind",
+            ),
+            nullable=False,
+        ),
+        sa.Column("subsystem", sa.String(length=64), nullable=True),
+        sa.Column("related_subsystems", postgresql.ARRAY(sa.Text()), nullable=True),
+        sa.Column("cve_ids", postgresql.ARRAY(sa.Text()), nullable=True),
+        sa.Column("linked_issues", postgresql.ARRAY(sa.BigInteger()), nullable=True),
+        sa.Column("confidence", sa.Float(), nullable=False),
+        sa.Column(
+            "source",
+            sa.Enum(
+                "rule",
+                "ai",
+                "manual",
+                name="classification_source",
+            ),
+            nullable=False,
+        ),
+        sa.Column("rule_name", sa.String(length=64), nullable=True),
+        sa.Column("reason", sa.Text(), nullable=True),
+        sa.Column("is_override", sa.Boolean(), nullable=False),
+        sa.Column("overridden_by", sa.UUID(), nullable=True),
+        sa.Column("overridden_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["overridden_by"],
+            ["ksp_user.id"],
+            name=op.f("fk_ksp_classification_overridden_by_ksp_user"),
+            ondelete="SET NULL",
+        ),
+        sa.ForeignKeyConstraint(
+            ["repository_id"],
+            ["ksp_repository.id"],
+            name=op.f("fk_ksp_classification_repository_id_ksp_repository"),
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_classification")),
+        sa.UniqueConstraint("subject_type", "subject_id", name="uq_ksp_classification_subject"),
+    )
+    op.create_index(op.f("ix_ksp_classification_cve_ids"), "ksp_classification", ["cve_ids"])
+    op.create_index("ix_ksp_classification_kind", "ksp_classification", ["kind"])
+    op.create_index(
+        op.f("ix_ksp_classification_repository_id"), "ksp_classification", ["repository_id"]
+    )
+    op.create_index(
+        op.f("ix_ksp_classification_subject_id"), "ksp_classification", ["subject_id"]
+    )
+    op.create_index(op.f("ix_ksp_classification_subsystem"), "ksp_classification", ["subsystem"])
+
+    op.create_table(
+        "ksp_label_sync_state",
+        sa.Column("id", sa.BigInteger(), autoincrement=True, nullable=False),
+        sa.Column("repository_id", sa.UUID(), nullable=False),
+        sa.Column("label_name", sa.String(length=128), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["repository_id"],
+            ["ksp_repository.id"],
+            name=op.f("fk_ksp_label_sync_state_repository_id_ksp_repository"),
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_label_sync_state")),
+        sa.UniqueConstraint("repository_id", "label_name", name="uq_ksp_label_sync_repo_name"),
+    )
+
+    op.create_table(
+        "ksp_task_routing",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("task", _ai_task_enum(), nullable=False),
+        sa.Column("provider_id", sa.UUID(), nullable=False),
+        sa.Column("fallback_provider_id", sa.UUID(), nullable=True),
+        sa.Column("system_prompt", sa.Text(), nullable=True),
+        sa.Column("enabled", sa.Boolean(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["fallback_provider_id"],
+            ["ksp_llm_provider.id"],
+            name=op.f("fk_ksp_task_routing_fallback_provider_id_ksp_llm_provider"),
+            ondelete="SET NULL",
+        ),
+        sa.ForeignKeyConstraint(
+            ["provider_id"],
+            ["ksp_llm_provider.id"],
+            name=op.f("fk_ksp_task_routing_provider_id_ksp_llm_provider"),
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_ksp_task_routing")),
+        sa.UniqueConstraint("task", name=op.f("uq_ksp_task_routing_task")),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("ksp_task_routing")
+    op.drop_table("ksp_label_sync_state")
+    op.drop_index(op.f("ix_ksp_classification_subsystem"), table_name="ksp_classification")
+    op.drop_index(op.f("ix_ksp_classification_subject_id"), table_name="ksp_classification")
+    op.drop_index(op.f("ix_ksp_classification_repository_id"), table_name="ksp_classification")
+    op.drop_index("ix_ksp_classification_kind", table_name="ksp_classification")
+    op.drop_index(op.f("ix_ksp_classification_cve_ids"), table_name="ksp_classification")
+    op.drop_table("ksp_classification")
+    op.drop_index("ix_ksp_attention_open", table_name="ksp_attention_item")
+    op.drop_index(op.f("ix_ksp_attention_item_subject_id"), table_name="ksp_attention_item")
+    op.drop_index(op.f("ix_ksp_attention_item_severity"), table_name="ksp_attention_item")
+    op.drop_index(op.f("ix_ksp_attention_item_rule"), table_name="ksp_attention_item")
+    op.drop_index(op.f("ix_ksp_attention_item_repository_id"), table_name="ksp_attention_item")
+    op.drop_table("ksp_attention_item")
+    op.drop_index(op.f("ix_ksp_ai_analysis_task"), table_name="ksp_ai_analysis")
+    op.drop_index(op.f("ix_ksp_ai_analysis_subject_id"), table_name="ksp_ai_analysis")
+    op.drop_index(op.f("ix_ksp_ai_analysis_status"), table_name="ksp_ai_analysis")
+    op.drop_index(op.f("ix_ksp_ai_analysis_repository_id"), table_name="ksp_ai_analysis")
+    op.drop_index(op.f("ix_ksp_ai_analysis_input_hash"), table_name="ksp_ai_analysis")
+    op.drop_index(op.f("ix_ksp_ai_analysis_created_at"), table_name="ksp_ai_analysis")
+    op.drop_table("ksp_ai_analysis")
+    op.drop_table("ksp_llm_provider")
+    op.drop_index(op.f("ix_ksp_prompt_template_task"), table_name="ksp_prompt_template")
+    op.drop_table("ksp_prompt_template")
+
+    # 枚举类型由本迁移创建，且为多表共用，需显式删除
+    postgresql.ENUM(*AI_TASK_VALUES, name="ai_task").drop(op.get_bind(), checkfirst=True)

package/backend/alembic/versions/a1c7d90e4b52_branch_belongs_to_a_repository.py

@@ -0,0 +1,72 @@
+"""分支登记表按仓库区分
+
+Revision ID: a1c7d90e4b52
+Revises: fcf3c186d63b
+Create Date: 2026-09-17
+
+sig-info.yaml 的 repo_branch 段里，每条分支都写着它属于哪个仓库，但写入时
+只取了分支名 —— 于是这张表成了全局表。纳管第二个仓库后，OLK-6.6 会出现在
+src-openeuler/kernel 的分支页上；而 master、openEuler-24.03-LTS-SP4 这类
+两个仓库都有的名字，页面上根本分不出指的是哪一个。
+
+已存在的行归属不明，一律留空：回填需要有仓库名才能对上，而旧数据里没有。
+下一次 sig_info 同步会把它们写正确。
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "a1c7d90e4b52"
+down_revision: str | None = "fcf3c186d63b"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "ksp_release_branch",
+        sa.Column("repository_id", sa.UUID(), nullable=True),
+    )
+    op.create_foreign_key(
+        "fk_ksp_release_branch_repository_id_ksp_repository",
+        "ksp_release_branch",
+        "ksp_repository",
+        ["repository_id"],
+        ["id"],
+        ondelete="CASCADE",
+    )
+    # 唯一约束由 name 改成 (repository_id, name)：同名分支在两个仓库里是两件事
+    op.drop_constraint("uq_ksp_release_branch_name", "ksp_release_branch", type_="unique")
+    op.create_unique_constraint(
+        "uq_ksp_release_branch_repo_name",
+        "ksp_release_branch",
+        ["repository_id", "name"],
+    )
+    op.create_index(
+        "ix_ksp_release_branch_repository_id",
+        "ksp_release_branch",
+        ["repository_id"],
+    )
+
+    # 旧行的归属无从判断（原先根本没存），而同一批分支会在下一次 sig_info
+    # 同步时带着正确归属重新写入。留着它们只会变成永远不会显示的孤儿 ——
+    # 查询按仓库过滤，归属为空的行谁也看不到。
+    #
+    # 删之前核对过：这些行没有人工填写的内容，state 全是默认值，
+    # note 与 aliases 全为空。若某个环境里有人填过生命周期说明，
+    # 这一步会连说明一起删掉 —— 那种情况需要先把列值搬到新行上。
+    op.execute("DELETE FROM ksp_release_branch WHERE repository_id IS NULL")
+
+
+def downgrade() -> None:
+    op.drop_index("ix_ksp_release_branch_repository_id", table_name="ksp_release_branch")
+    op.drop_constraint("uq_ksp_release_branch_repo_name", "ksp_release_branch", type_="unique")
+    op.create_unique_constraint("uq_ksp_release_branch_name", "ksp_release_branch", ["name"])
+    op.drop_constraint(
+        "fk_ksp_release_branch_repository_id_ksp_repository",
+        "ksp_release_branch",
+        type_="foreignkey",
+    )
+    op.drop_column("ksp_release_branch", "repository_id")

package/backend/alembic/versions/b41c9d7e5f28_extend_pr_kind_categories.py

@@ -0,0 +1,43 @@
+"""扩展 pr_kind 的取值
+
+Revision ID: b41c9d7e5f28
+Revises: 350e2d9b6553
+
+新增五类：新增驱动、驱动更新、处理器/SoC 支持、自研特性、性能优化。
+
+依据来自实测：作者在提交信息里自填 ``category:`` 与 ``<X> inclusion``
+（1264 条提交中 1235 条带 category），以及厂商与自研子系统的命名习惯。
+原来的七类无法区分"回合自上游的补丁"和"厂商新驱动"—— 而这两者
+的评审方式完全不同，混在一起维护者没法按类别分流。
+
+Alembic 不会自动检测枚举取值的新增，因此这里手写。
+PostgreSQL 12 起允许在事务中 ADD VALUE，只要同一事务内不使用该新值，
+本迁移正是如此（只加值，不改数据）。
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "b41c9d7e5f28"
+down_revision: str | None = "350e2d9b6553"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+# 顺序需与 models.classification.PRKind 保持一致，便于人工比对
+NEW_VALUES = ("driver_new", "driver_update", "soc_support", "out_of_tree", "perf")
+
+
+def upgrade() -> None:
+    for value in NEW_VALUES:
+        op.execute(f"ALTER TYPE pr_kind ADD VALUE IF NOT EXISTS '{value}'")
+
+
+def downgrade() -> None:
+    # PostgreSQL 不支持从枚举中删除取值。要回退只能重建类型并改写
+    # 所有引用列，代价高且需在无数据依赖时进行。
+    # 因此这里显式报错，而不是留下一个"看起来成功"的空操作。
+    raise NotImplementedError(
+        "pr_kind 的取值无法删除（PostgreSQL 限制）。"
+        "如需回退，请重建类型并重写 ksp_classification.kind 列。"
+    )

package/backend/alembic/versions/c8e4f2a71b93_add_release_kind.py

@@ -0,0 +1,40 @@
+"""pr_kind 增加「版本发布」一类
+
+Revision ID: c8e4f2a71b93
+Revises: a1c7d90e4b52
+
+纳管 src-openeuler/kernel 之后发现的：那个仓库的 PR 是版本发布动作
+（``release 6.6.0-173.0.0.155``），而现有十三类是针对内核补丁的内容划分，
+没有一类装得下它 —— 实测 1309 个 PR 里 1156 个落进 unknown，界面上看
+像是分类没跑。同一条规则在 openeuler/kernel 上只命中 1 个 PR，
+所以加这一类不会影响那边的统计。
+
+Alembic 不会自动检测枚举取值的新增，因此这里手写。
+PostgreSQL 12 起允许在事务中 ADD VALUE，只要同一事务内不使用该新值，
+本迁移正是如此（只加值，不改数据）。
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "c8e4f2a71b93"
+down_revision: str | None = "a1c7d90e4b52"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+NEW_VALUE = "release"
+
+
+def upgrade() -> None:
+    op.execute(f"ALTER TYPE pr_kind ADD VALUE IF NOT EXISTS '{NEW_VALUE}'")
+
+
+def downgrade() -> None:
+    # PostgreSQL 不支持从枚举中删除取值。要回退只能重建类型并改写
+    # 所有引用列，代价高且需在无数据依赖时进行。
+    # 因此这里显式报错，而不是留下一个"看起来成功"的空操作。
+    raise NotImplementedError(
+        "pr_kind 的取值无法删除（PostgreSQL 限制）。"
+        "如需回退，请重建类型并重写 ksp_classification.kind 列。"
+    )

package/backend/alembic/versions/d1275091dfdc_add_needs_detail_flag_to_pull_request.py

@@ -0,0 +1,44 @@
+"""为 Pull Request 添加增量同步所需的派生列
+
+Revision ID: d1275091dfdc
+Revises: 5a31ade90136
+Create Date: 2026-09-16
+
+- needs_detail：内容变化后才置位，把详情同步量从"每轮全部 PR"
+  降到"每轮仅变化项"，否则每轮会产生数千次上游请求
+- gate_stage：由标签推导的门禁阶段，供列表按"待评审/可合入"筛选与排序。
+  属于刻意的反规范化 —— 1000+ 条记录无法在应用层逐条推导再分页
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "d1275091dfdc"
+down_revision: str | None = "5a31ade90136"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "ksp_pull_request",
+        sa.Column("needs_detail", sa.Boolean(), server_default=sa.text("true"), nullable=False),
+    )
+    op.add_column(
+        "ksp_pull_request",
+        sa.Column(
+            "gate_stage",
+            sa.String(32),
+            server_default="cla_pending",
+            nullable=False,
+        ),
+    )
+    op.create_index("ix_ksp_pull_request_gate_stage", "ksp_pull_request", ["gate_stage"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_ksp_pull_request_gate_stage", table_name="ksp_pull_request")
+    op.drop_column("ksp_pull_request", "gate_stage")
+    op.drop_column("ksp_pull_request", "needs_detail")