@devcxl/opencode-cabbage 1.1.0 → 1.3.0

package/dist/kernel/task.d.ts

@@ -1,213 +0,0 @@
-import { type ProjectProfile } from "./profile.js";
-import { type WorkspaceBaseline } from "./tdd/evidence.js";
-import type { AcceptanceCriterion, TaskRecordRef, TddEvidence, TddPolicy } from "./types.js";
-/** Task Record 状态标签前缀：cabbage:task:<status> */
-export declare const TASK_STATUS_LABEL_PREFIX = "cabbage:task:";
-/** Task 状态标签取值 */
-export type TaskStatus = "running" | "reviewing" | "merged" | "cancelled";
-/** 默认最大并行 Task 数（PRD R7，Profile 可覆盖但内核按此判定） */
-export declare const MAX_PARALLEL_TASKS = 5;
-/** 内核内置风险 pattern（spec §12 #12：migrations/auth/permissions/release workflow/密钥/公共 API），与 Profile riskPatterns 合并 */
-export declare const BUILTIN_RISK_PATTERNS: string[];
-export type CmdResult = {
-    stdout: string;
-    stderr: string;
-};
-export type CmdFn = (args: string) => Promise<CmdResult>;
-export declare function setTaskGhExecutor(fn: CmdFn | null): void;
-export declare function setTaskGitExecutor(fn: CmdFn | null): void;
-export declare function taskGh(args: string, timeout?: number): Promise<CmdResult>;
-export declare function taskGit(args: string): Promise<CmdResult>;
-/**
- * 新建 Task Record 的 body：acceptance criteria + 依赖 + 状态 checklist + Closes 约定。
- * criteria 渲染为 `- [ ] <id>: <description> [<verification>]`，可被 parseCriteriaFromBody 还原。
- */
-export declare function buildTaskBody(slug: string, criteria: AcceptanceCriterion[], dependencies: Array<number | string>): string;
-/** TDD 跨批协议：Task Record body 内 TDD 上下文块 marker（tdd_checkpoint 工具解析；spec §2.3/§4） */
-export declare const TASK_TDD_TAG = "<!-- cabbage-task-tdd -->";
-/** 构造 TDD 上下文块 JSON（policy + criteria + worktreeDir），供 tdd_checkpoint resolveTaskContext 解析 */
-export declare function buildTaskTddBlock(policy: TddPolicy, criteria: AcceptanceCriterion[], worktreePath: string): string;
-/** 解析 create-task 传入的 acceptance_criteria JSON（字符串数组 → AcceptanceCriterion[]）；非法返回 null */
-export declare function parseAcceptanceCriteria(json: string): AcceptanceCriterion[] | null;
-/** 从 Task Record body 还原 acceptance criteria（buildTaskBody 的逆操作） */
-export declare function parseCriteriaFromBody(body: string): AcceptanceCriterion[];
-/** 从 Task Record body 的 Dependencies 区块解析依赖：`- #12` → 编号；`- @slug` → slug（门禁时解析） */
-export declare function parseDependenciesFromBody(body: string): Array<number | string>;
-/**
- * 解析 create-task 的 depends_on 参数：支持 Issue 编号（"12" / "#12"）与
- * task_id（slug，如 "user-auth"）混合，以逗号分隔。非法项忽略。
- * 返回 string 表示 slug（需在门禁时解析成编号）。
- */
-export declare function parseDependenciesArg(raw: string | undefined): Array<number | string>;
-/** 从 Project Profile 冻结 TDD policy：enforcement 固定 runtime（PRD R6 行为变更强制 Runtime TDD） */
-export declare function freezeTddPolicy(profile: ProjectProfile): TddPolicy;
-/** 轻量 glob 匹配（支持 **、*、?），风险 pattern 匹配专用 */
-export declare function matchRiskPattern(filePath: string, pattern: string): boolean;
-/**
- * 风险双层判定：模型初判 + 内核按实际 diff 升级，只升不降（PRD R8 / spec §12 #12）。
- * modelRisk 为 high → high；否则 diff 命中任一 risk pattern → high；否则 low。
- */
-export declare function escalateRisk(modelRisk: "low" | "high", changedFiles: string[], riskPatterns: string[]): "low" | "high";
-export interface ParsedEvidenceBlock {
-    stage: string;
-    fields: Record<string, string>;
-}
-/** 解析受控 evidence comment 为结构化 blocks；无 marker 或畸形返回 null */
-export declare function parseEvidenceComment(body: string): ParsedEvidenceBlock[] | null;
-/** 把受控 comment 还原为 TddEvidence（供 evaluateTddCompliance 判定）；无 marker 返回 null */
-export declare function evidenceCommentToTddEvidence(comment: {
-    id: number;
-    body: string;
-    revision: number;
-}): TddEvidence | null;
-export interface TaskRuntimeState {
-    slug: string;
-    parentIssueNumber: number;
-    issueNumber: number;
-    branch: string;
-    worktreePath: string;
-    policy: TddPolicy;
-    baseline: WorkspaceBaseline;
-    startedAt: string;
-}
-export declare function taskStatePath(projectDir: string, slug: string): string;
-export declare function writeTaskState(projectDir: string, state: TaskRuntimeState): Promise<void>;
-export declare function readTaskState(projectDir: string, slug: string): Promise<TaskRuntimeState | null>;
-export declare function setTaskStatusLabel(issueNumber: number, status: TaskStatus): Promise<{
-    ok: boolean;
-    error?: string;
-}>;
-export interface CreateTaskInput {
-    projectDir: string;
-    parentIssueNumber: number;
-    title: string;
-    acceptanceCriteriaJson?: string;
-    /** 依赖：Issue 编号或 task_id（slug），create-task 的 depends_on 原样传递 */
-    dependencies?: Array<number | string>;
-}
-export type CreateTaskResult = {
-    ok: true;
-    ref: TaskRecordRef;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-/**
- * create-task（spec §2.3）：validateTitle → slug → 未完成同名冲突检查（branch/worktree 已存在）→
- * createTaskRecord（Sub Issue，body 含 acceptance criteria、依赖、Closes 约定）关联 Parent。
- */
-export declare function createTask(input: CreateTaskInput): Promise<CreateTaskResult>;
-export type StartTaskResult = {
-    ok: true;
-    issueNumber: number;
-    branch: string;
-    worktreePath: string;
-    policy: TddPolicy;
-    baseline: WorkspaceBaseline;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-/**
- * start-task（spec §2.3）：前置门禁（Planning Baseline 已合并、依赖 Task 已 merged、并行数 <5）→
- * worktree-start → captureWorkspaceBaseline → freezeTddPolicy → 写 Task Record 状态。
- */
-export declare function startTask(projectDir: string, parentIssueNumber: number, taskId: string): Promise<StartTaskResult>;
-export type SubmitTaskResult = {
-    ok: true;
-    prNumber: number;
-    evidenceRevision: number;
-    warning?: string;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-    missing?: string[];
-};
-/**
- * submit-task（spec §4.4）：TDD 硬门禁——evidence 不完整（无 comment、regression 未 pass、
- * compliance 未 pass）→ 拒绝创建 PR；通过后 push 分支 → gh pr create（body 引用 Task Record +
- * evidence comment 链接，含 Closes 约定）→ 标记 reviewing。
- */
-export declare function submitTask(projectDir: string, parentIssueNumber: number, taskId: string): Promise<SubmitTaskResult>;
-export type SubmitReviewResult = {
-    ok: true;
-    prNumber: number;
-    verdict: "approve" | "request-changes";
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-/** submit-review（spec §2.3）：primary 提交 reviewer 双轴审查结果（reviewer 本身只读） */
-export declare function submitReview(prNumber: number, verdict: "approve" | "request-changes", comment?: string): Promise<SubmitReviewResult>;
-export type MergeTaskResult = {
-    ok: true;
-    prNumber: number;
-    risk: "low" | "high";
-    warning?: string;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-/**
- * merge-task（spec §2.3 + PRD R8）：CI checks 通过 + 分支保护 + 风险双层判定（只升不降）+
- * 高风险需非作者人类 approval → mergeTaskPR（--match-head-commit）→ 关闭 Sub Issue →
- * worktree 干净销毁。
- */
-export declare function mergeTask(projectDir: string, parentIssueNumber: number, taskId: string, modelRisk: "low" | "high"): Promise<MergeTaskResult>;
-/** 将原始 statusCheckRollup 映射为 {name, state}（纯函数，供测试直接验证 jq 语义） */
-export declare function mapCheckRollup(raw: unknown[]): Array<{
-    name: string;
-    state: string;
-}>;
-export type TaskLifecycleResult = {
-    ok: true;
-    issueNumber: number;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-export type DestroyTaskWorktreeResult = {
-    ok: true;
-    reason: string;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-export interface TaskStatusReport {
-    task: {
-        issueNumber: number;
-        slug: string;
-        state: string;
-        labels: string[];
-    };
-    pullRequests: Array<{
-        number: number;
-        state: string;
-        headRefName: string;
-        checks: Array<{
-            name: string;
-            state: string;
-        }>;
-    }>;
-}
-export type TaskStatusResult = {
-    ok: true;
-    report: TaskStatusReport;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
-/** cancel-task：受控取消（user_confirmed）→ 关闭 Sub Issue + 状态标签 cancelled */
-export declare function cancelTask(_projectDir: string, parentIssueNumber: number, taskId: string, userConfirmed: boolean): Promise<TaskLifecycleResult>;
-/** destroy-worktree：preflight 销毁（§3.3），需 user_confirmed（除非 PR 已合并且干净） */
-export declare function destroyTaskWorktree(projectDir: string, parentIssueNumber: number, taskId: string, userConfirmed: boolean): Promise<DestroyTaskWorktreeResult>;
-/** status-task：读 Task Record + PR + checks 汇总 */
-export declare function readTaskStatus(_projectDir: string, parentIssueNumber: number, taskId: string): Promise<TaskStatusResult>;