@tea-agent/loop-agent 0.37.0 → 0.37.1-beta.0

package/dist/shared/operator/capabilities.js

@@ -13,13 +13,6 @@ const CONTROLLER_PROTOCOL_CAPABILITIES = [
     "worker-attempt-revision-v1",
     "recovery-decision-v2",
 ];
-function officialModelCallable(coverage, kind) {
-    if (coverage === "human-gated-required")
-        return "prepare-only";
-    if (coverage === "advanced" && kind !== "read")
-        return "never";
-    return "always";
-}
 const officialAction = (action, cli, kind, coverage) => ({
     action,
     cli,
@@ -58,7 +51,11 @@ const officialAction = (action, cli, kind, coverage) => ({
             ]
             : []),
     ],
-    modelCallable: officialModelCallable(coverage, kind),
+    modelCallable: coverage === "human-gated-required"
+        ? "prepare-only"
+        : coverage === "advanced" && kind !== "read"
+            ? "never"
+            : "always",
     humanConfirmation: coverage === "human-gated-required" ? "required" : "none",
 });
 const OFFICIAL_ACTIONS = [
@@ -145,13 +142,13 @@ const OFFICIAL_ACTIONS = [
         ["stats", "loop-agent stats", "read", "model-callable"],
         [
             "promoteRun",
-            "loop-agent task advance",
+            "loop-agent task advance <id> --json",
             "mutation",
             "model-callable",
         ],
         [
             "closeoutTask",
-            "loop-agent task advance",
+            "loop-agent task advance <id> --json",
             "mutation",
             "model-callable",
         ],
@@ -448,49 +445,6 @@ export function buildOperatorCapabilitiesDocument() {
             modelCallable: "always",
             humanConfirmation: "none",
         },
-        {
-            action: "operationWait",
-            cli: "console canonical operation wait (read-only event-driven long poll)",
-            kind: "read",
-            inputSchemaVersion: 1,
-            resultSchemaVersion: 1,
-            resultPolicy: { readOnly: true, bounded: true, redacted: true },
-            envelopeSchemaVersion: 1,
-            requiredErrorCodes: [
-                "NOT_FOUND",
-                "INVALID_INPUT",
-                "EVENT_CURSOR_EXPIRED",
-            ],
-            description: "Read-only event-driven wait on the canonical operation event ring. Default wakeOn=meaningful: heartbeats never settle the wait and are never returned as event payload (nextSeq still covers them); state/result/stdout/stderr/reconcile/error settle immediately; terminal or needs-reconcile flushes immediately. Every subsequent wait MUST pass afterSeq equal to the previous response nextSeq; omitting or reusing an older cursor replays already-consumed startup events. The response includes recommendedNextCall with the safe cursor. wakeOn=all (diagnostic compatibility) resolves on the first new event including heartbeats. maxWaitMs elapsing returns timedOut:true (a success summary, not a command failure).",
-            inputParams: [
-                {
-                    name: "operationId",
-                    type: "string",
-                    required: true,
-                    description: "canonical operation id",
-                },
-                {
-                    name: "afterSeq",
-                    type: "number",
-                    required: false,
-                    description: "event cursor; first wait may use 0, every later wait MUST use the previous response nextSeq (>= 0)",
-                },
-                {
-                    name: "maxWaitMs",
-                    type: "number",
-                    required: false,
-                    description: "bounded wait budget; clamped server-side (default 180000, floor 60000)",
-                },
-                {
-                    name: "wakeOn",
-                    type: "string",
-                    required: false,
-                    description: "wake policy: meaningful (default; heartbeats are cursor-only liveness) | all (first event settles, diagnostics)",
-                },
-            ],
-            modelCallable: "always",
-            humanConfirmation: "none",
-        },
         {
             action: "contractShow",
             cli: "loop-agent task status <taskId> --json",
@@ -942,74 +896,6 @@ export function buildOperatorCapabilitiesDocument() {
             modelCallable: "always",
             humanConfirmation: "none",
         },
-        {
-            action: "taskAdvance",
-            cli: "loop-agent task advance <taskId> [title] --task-kind <kind> --allowed-path <glob> --forbidden-path <glob> --verify <label:command> --json",
-            kind: "long-running",
-            inputSchemaVersion: 1,
-            resultSchemaVersion: 1,
-            envelopeSchemaVersion: 1,
-            requiredErrorCodes: [
-                ...COMMON_MUTATION_ERRORS,
-                "INVALID_INPUT",
-            ],
-            description: "Canonical typed task advance mutation. Use after task creation/PRD import to apply explicit taskKind and engineering boundaries, generate + strict-validate the DAG, and stop at the writeSet gate. Never pass placeholder ids such as <id>. A successful child process may still return a blocked business outcome; inspect lifecycleState, blockers, gate, and next.",
-            inputParams: [
-                {
-                    name: "taskId",
-                    type: "string",
-                    required: true,
-                    description: "canonical YYYY-MM-DD-<slug> task id; placeholders are rejected",
-                },
-                {
-                    name: "title",
-                    type: "string",
-                    required: false,
-                    description: "optional task title for create/first advance",
-                },
-                {
-                    name: "taskKind",
-                    type: "string",
-                    required: false,
-                    description: "business DAG template; ordinary fixes/docs use standard",
-                },
-                {
-                    name: "featureId",
-                    type: "string",
-                    required: false,
-                    description: "required only by feature-scoped task kinds such as knowledge-sync",
-                },
-                {
-                    name: "profile",
-                    type: "string",
-                    required: false,
-                    description: "governance profile auto|minimal|standard|reviewed|supervised",
-                },
-                {
-                    name: "allowedPaths",
-                    type: "array",
-                    itemsType: "string",
-                    required: false,
-                    description: "explicit writer boundary globs",
-                },
-                {
-                    name: "forbiddenPaths",
-                    type: "array",
-                    itemsType: "string",
-                    required: false,
-                    description: "explicit forbidden path globs",
-                },
-                {
-                    name: "verifyCommands",
-                    type: "array",
-                    itemsType: "string",
-                    required: false,
-                    description: "verification entries as label:command strings",
-                },
-            ],
-            modelCallable: "always",
-            humanConfirmation: "none",
-        },
         {
             action: "dagRunTask",
             cli: "loop-agent task advance <taskId> --profile auto --dag-output <path> --json",
@@ -1079,7 +965,7 @@ export function buildOperatorCapabilitiesDocument() {
                 "CONTROLLER_MISMATCH",
                 "INVALID_INPUT",
             ],
-            description: "Consume a single-use execution receipt and execute the reviewed DAG (prefer task advance --approve-gate when gate token present). accepted/queued/running/operationId are NOT completion — supervise via operationGet/status/dagReport/dagDoctor/operationWait.",
+            description: "Consume a single-use execution receipt and execute the reviewed DAG (prefer task advance --approve-gate when gate token present). accepted/queued/running/operationId are NOT completion — supervise via operationGet/status/dagReport/dagDoctor.",
             inputParams: [
                 {
                     name: "executionId",
@@ -1102,7 +988,7 @@ export function buildOperatorCapabilitiesDocument() {
             resultSchemaVersion: 1,
             envelopeSchemaVersion: 1,
             requiredErrorCodes: ["INVALID_INPUT", "NOT_FOUND"],
-            description: "Read-only R1 subgraph plan (no mutation). Call before dagRerun. Prefer primaryFailure.nodeId from dagReport. If eligible=false (writer/decision/fingerprint, unsafe shell, worker-managed, workspace/controller drift), do not force execute — Worker-owned runs use workerTaskRetry; standalone runs use standaloneTaskRerun or same-task advance after fixing the root cause (contract changes must be adopted first). Returns planHash required by execute.",
+            description: "Read-only R1 subgraph plan (no mutation). Call before dagRerun. Prefer primaryFailure.nodeId from dagReport. If eligible=false (writer/decision/fingerprint), do not force execute — fall back to standaloneTaskRerun or same-task advance. Returns planHash required by execute.",
             inputParams: [
                 {
                     name: "runId",
@@ -1165,73 +1051,6 @@ export function buildOperatorCapabilitiesDocument() {
             modelCallable: "always",
             humanConfirmation: "none",
         },
-        {
-            action: "dagInterruptEligibility",
-            cli: "console dag-interrupt-eligibility",
-            kind: "read",
-            inputSchemaVersion: 1,
-            resultSchemaVersion: 1,
-            envelopeSchemaVersion: 1,
-            requiredErrorCodes: ["INVALID_INPUT", "NOT_FOUND"],
-            description: "Read-only eligibility for cooperative live-DAG interrupt. v1 only Console-owned active running operations. Worker-managed / unknown owner / orphaned / terminal runs return eligible=false with stable reasonCodes. Does not create a Human Gate receipt or mutate the run.",
-            inputParams: [
-                {
-                    name: "runId",
-                    type: "string",
-                    required: true,
-                    description: "active dag run id to inspect for interrupt eligibility",
-                },
-            ],
-            modelCallable: "always",
-            humanConfirmation: "none",
-        },
-        {
-            action: "dagRequestInterrupt",
-            cli: "loop-agent dag request-interrupt --run-id <id> --request-id <id> --target-operation-id <id> --reason-code <code> --reason <detail> --json",
-            kind: "mutation",
-            inputSchemaVersion: 1,
-            resultSchemaVersion: 1,
-            envelopeSchemaVersion: 1,
-            requiredErrorCodes: [
-                ...COMMON_MUTATION_ERRORS,
-                "HUMAN_CONFIRMATION_REQUIRED",
-                "RUN_NOT_ACTIVE",
-                "RUN_NOT_CONSOLE_OWNED",
-                "RUNNER_IDENTITY_MISMATCH",
-                "INTERRUPT_ALREADY_PENDING",
-                "RUN_ALREADY_TERMINAL",
-                "INTERRUPT_NEEDS_RECONCILE",
-            ],
-            description: "Request cooperative abort of a Console-owned running DAG. Success means interrupt.json is requested, not that the run has already stopped. Browser Human Gate only; model must not call this action.",
-            inputParams: [
-                {
-                    name: "runId",
-                    type: "string",
-                    required: true,
-                    description: "active dag run id",
-                },
-                {
-                    name: "reasonCode",
-                    type: "string",
-                    required: true,
-                    description: "requirements-changed | suspected-runaway | resource-protection | operator-request | other",
-                },
-                {
-                    name: "reasonDetail",
-                    type: "string",
-                    required: true,
-                    description: "10–500 character operator reason; do not auto-fill placeholders",
-                },
-                {
-                    name: "confirmationId",
-                    type: "string",
-                    required: true,
-                    description: "human confirmation receipt id from prepareMutationGate",
-                },
-            ],
-            modelCallable: "prepare-only",
-            humanConfirmation: "required",
-        },
         {
             action: "prepareMutationGate",
             cli: "console prepare-mutation-gate",
@@ -1240,13 +1059,13 @@ export function buildOperatorCapabilitiesDocument() {
             resultSchemaVersion: 1,
             envelopeSchemaVersion: 1,
             requiredErrorCodes: ["INVALID_INPUT", "NOT_FOUND"],
-            description: "Prepare a one-shot Human Gate receipt for destructive reconcile, live DAG interrupt, and Night Scheduler mutations. Model may prepare; only the browser mutation gate may consume. Do not use for dagRerun / standaloneTaskRerun / workerTaskRetry.",
+            description: "Prepare a one-shot Human Gate receipt for Night Scheduler mutations. Model may prepare; only the browser mutation gate may consume.",
             inputParams: [
                 {
                     name: "action",
                     type: "string",
                     required: true,
-                    description: "target action: dagReconcileRun | dagRequestInterrupt | workerAdmissionPrepare | workerSchedulerAdd | workerSchedulerCancel | workerSchedulerHarvest | workerSchedulerDiscard. Not for standaloneTaskRerun / workerTaskRetry / dagRerun (those are autonomous).",
+                    description: "target action: workerAdmissionPrepare | workerSchedulerAdd | workerSchedulerCancel | workerSchedulerHarvest | workerSchedulerDiscard",
                 },
                 {
                     name: "actionParams",
@@ -1498,7 +1317,7 @@ export function buildOperatorCapabilitiesDocument() {
                 "INVALID_INPUT",
                 "HUMAN_CONFIRMATION_REQUIRED",
             ],
-            description: "Full standalone task regenerate → validate → execute with parent lineage. Only when node rerun plan is ineligible or primaryRecovery recommends rerun-task; the server checks read-only run facts before accepting. Regeneration reuses the CURRENT contract snapshot: if the failure requires contract changes (e.g. allowing a catalog index path), first update the contract (re-import PRD, or adopt externally-edited sources via `task contract adopt`) BEFORE calling this action, otherwise the regenerated DAG repeats the same failure.",
+            description: "Full standalone task regenerate → validate → execute with parent lineage. Only when node rerun plan is ineligible or primaryRecovery recommends rerun-task; the server checks read-only run facts before accepting.",
             inputParams: [
                 {
                     name: "runId",
@@ -1619,7 +1438,7 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
     {
         command: "loop-agent task advance",
         coverage: "model-callable",
-        action: "taskAdvance",
+        action: "newTask",
         source: "loop-agent",
     },
     {
@@ -2059,12 +1878,6 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
         action: "dagReconcileRun",
         source: "loop-agent",
     },
-    {
-        command: "loop-agent dag request-interrupt",
-        coverage: "human-gated-required",
-        action: "dagRequestInterrupt",
-        source: "loop-agent",
-    },
     {
         command: "loop-agent dag rerun",
         coverage: "model-callable",

package/dist/shared/package-metadata.js

@@ -45,48 +45,6 @@ export function readPackageName(packageDir) {
     }
     return undefined;
 }
-/**
- * Read the build stamp (git SHA + build time) written by the build pipeline
- * into `<packageDir>/dist/build-stamp.json`. `undefined` when absent (e.g.
- * running from source via tsx, or a hand-assembled package), which callers
- * treat as "no stamp available".
- */
-export function readBuildStamp(packageDir) {
-    try {
-        const raw = readFileSync(path.join(packageDir, "dist", "build-stamp.json"), "utf-8");
-        const parsed = JSON.parse(raw);
-        if (parsed.schemaVersion !== 1 ||
-            typeof parsed.version !== "string" ||
-            typeof parsed.builtAt !== "string")
-            return undefined;
-        return parsed;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Human-readable CLI version label: plain version, enriched with the build
- * stamp (short git SHA + build date) when available so a stale dist/ that was
- * built from an old commit is immediately recognizable in `--version`.
- */
-export function readCliVersionLabel(packageDir) {
-    const version = readPackageVersion(packageDir) ?? "0.0.0";
-    const stamp = readBuildStamp(packageDir);
-    if (!stamp?.gitSha)
-        return version;
-    return `${version} (build ${stamp.gitSha.slice(0, 8)} ${stamp.builtAt.slice(0, 10)})`;
-}
-/**
- * Strip the build-stamp suffix from a CLI `--version` label, returning the bare
- * SemVer. Controller-identity/preflight comparisons must use this rather than
- * the raw label so a build-stamped `0.35.0 (build 7f8c5b5b …)` still matches
- * `packageVersion === "0.35.0"`.
- */
-export function normalizeCliVersionLabel(label) {
-    const match = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?/.exec(label.trim());
-    return match ? match[0] : label.trim();
-}
 /**
  * Compute the SHA-256 hash of a file on disk.
  *

package/dist/task/contract/project.js

@@ -46,10 +46,6 @@ export function projectRequirementMarkdown(draft) {
             lines.push(`- ${item}`);
         }
     }
-    // References / Source Resolutions remain projected into 需求.md (durable
-    // provenance for human readers); the managed read-back validator accepts
-    // the projector's own canonical forms instead of rejecting them
-    // (2026-08-16 L1: writer/reader round-trip invariant).
     if (draft.sourceResolutions && draft.sourceResolutions.length > 0) {
         lines.push("", "## Source Resolutions", "");
         for (const res of draft.sourceResolutions) {

package/dist/task/source-prepare/completeness.js

@@ -2,13 +2,6 @@ const FRESH_SOURCE_MISSING_CODES = new Set([
     "MISSING_REQUIREMENT",
     "MISSING_CONSTRAINTS",
 ]);
-function hasKnowledgeSyncFeatureSurface(featureId, allowedPaths) {
-    const featureRoot = `features/${featureId}/`;
-    return allowedPaths.some((pathGlob) => {
-        const normalized = pathGlob.replaceAll("\\", "/").replace(/^\.\//, "");
-        return normalized === `features/${featureId}` || normalized.startsWith(featureRoot);
-    });
-}
 export function isFreshLegacyUnversioned(state, sourceFilesPresent) {
     if (state.effectiveStatus !== "legacy-unversioned")
         return false;
@@ -68,15 +61,6 @@ export function listPrepareGaps(input) {
             level: "blocking",
             field: "objective",
             message: "requirement.objective is required",
-            details: { headingAliases: ["目标", "objective", "业务目标", "需求概述"] },
-            selfHealing: {
-                action: "reimport-prd",
-                steps: [
-                    "检查 PRD 是否含「## 目标」或「## Objective」章节；中文括号后缀（如「目标（概述）」）已被识别",
-                    "若确实缺失：补全 PRD 后重新 importPrd（同 taskId），advance 会自动重投影",
-                    "不要手改 source/需求.md（会触发 DIRTY_SOURCE）；不要在 PRD 目录生成 sidecar draft JSON",
-                ],
-            },
         });
     }
     if (draft.requirement.acceptanceCriteria.length === 0) {
@@ -85,25 +69,6 @@ export function listPrepareGaps(input) {
             level: "blocking",
             field: "acceptanceCriteria",
             message: "at least one acceptance criterion is required",
-            details: {
-                recognizedHeadings: [
-                    "验收标准",
-                    "acceptance criteria",
-                    "完成标准",
-                    "完成定义",
-                    "验收",
-                    "dod",
-                ],
-                note: "标题含括号/破折号后缀会被自动归一；AC 需为列表项（- / 1.）或 AC-NNN 标题/行内格式",
-            },
-            selfHealing: {
-                action: "reimport-prd",
-                steps: [
-                    "检查 PRD 验收章节标题（如「完成标准（验收）」已可识别）与列表格式：需为「- 项目」或「AC-001: 文本」",
-                    "格式修正后重新 importPrd（同 taskId）；advance 内置 semantic intake 兜底，文档语义完整时会自动结构化",
-                    "若 advance 已返回 SEMANTIC_INTAKE_FAILED：补全 PRD 后重试，不要手改 source/ 需求.md",
-                ],
-            },
         });
     }
     if (input.acceptanceConflicts && input.acceptanceConflicts.length > 0) {
@@ -140,16 +105,6 @@ export function listPrepareGaps(input) {
             message: "featureId is required when taskKind is knowledge-sync",
         });
     }
-    if (draft.taskKind === "knowledge-sync" &&
-        draft.featureId &&
-        !hasKnowledgeSyncFeatureSurface(draft.featureId, draft.constraints.allowedPaths)) {
-        gaps.push({
-            code: "KNOWLEDGE_SYNC_PATH_MISMATCH",
-            level: "blocking",
-            field: "allowedPaths",
-            message: `knowledge-sync for ${draft.featureId} requires an allowed path under features/${draft.featureId}/; ordinary docs-only work should use taskKind standard`,
-        });
-    }
     if (draft.requirement.scope.length === 0) {
         gaps.push({
             code: "EMPTY_SCOPE",
@@ -216,14 +171,6 @@ export function listPrepareGaps(input) {
             code: "DIRTY_SOURCE",
             level: "blocking",
             message: "existing non-empty or externally-modified source refuses --apply; use show/diff/adopt/recover or --force-overwrite-source",
-            selfHealing: {
-                action: "adopt-contract",
-                steps: [
-                    "task status --json 读取 contract.observedCanonicalHash 与当前 revision",
-                    "若变更确属预期：task contract adopt --task <id> --expected-revision <n> --expected-observed-hash <hash> --request-id <id> --request-payload-sha256 <sha>",
-                    "若变更不是预期的：改 PRD 后重新 importPrd 走完整重投影；禁止手改 lifecycle.json / .transactions/ 绕过",
-                ],
-            },
         });
         risks.push({
             code: "DIRTY_SOURCE",

package/dist/task/source-prepare/parse-intent.js

@@ -15,21 +15,7 @@ const HEADING_ALIASES = {
         "已确认需求",
     ]),
     nonGoals: new Set(["非目标", "out of scope", "non-goals", "non goals"]),
-    acceptance: new Set([
-        "验收标准",
-        "acceptance criteria",
-        "acceptance",
-        // Common zh-CN product-writing variants seen in real PRDs; without
-        // these a PRD re-import flips to deterministic parse and loses all AC
-        // (EMPTY_ACCEPTANCE deadlock on the pendingPrdRefresh path).
-        "完成定义",
-        "完成标准",
-        "验收",
-        "验收条件",
-        "验收准则",
-        "dod",
-        "definition of done",
-    ]),
+    acceptance: new Set(["验收标准", "acceptance criteria", "acceptance"]),
     constraints: new Set(["约束", "constraints", "不变式", "invariants"]),
     openQuestions: new Set(["待决问题", "open questions", "open-questions"]),
     assumptions: new Set(["假设", "assumptions"]),
@@ -44,6 +30,15 @@ function stripFencedAndComments(text) {
         .replace(/~~~[\s\S]*?~~~/g, "\n")
         .replace(/<!--[\s\S]*?-->/g, "\n");
 }
+function normalizeHeadingText(raw) {
+    return raw
+        .trim()
+        // Strip leading section numbers: "2. 业务目标" / "3.1 已确认范围" / "3.2、非目标"
+        .replace(/^(?:\d+(?:\.\d+)*[.．、]?\s*)+/u, "")
+        .toLowerCase()
+        .replace(/[:：]\s*$/u, "")
+        .replace(/\s+/g, " ");
+}
 function normalizeAcceptanceId(raw) {
     return raw
         .trim()
@@ -60,67 +55,12 @@ function parseEmbeddedAcHeading(headingText) {
     const text = match[2]?.trim() || id;
     return { id, text };
 }
-function normalizeHeadingText(raw) {
-    return raw
-        .trim()
-        // Strip leading section numbers: "2. 业务目标" / "3.1 已确认范围" / "3.2、非目标"
-        .replace(/^(?:\d+(?:\.\d+)*[.．、]?\s*)+/u, "")
-        .toLowerCase()
-        .replace(/[:：]\s*$/u, "")
-        .replace(/\s+/g, " ");
-}
-/**
- * Strip decorative suffixes that real PRD writers attach to section
- * headings: "完成标准（验收）" → "完成标准", "Acceptance Criteria (DoD):" →
- * "acceptance criteria", "验收标准 — 交付门槛" → "验收标准". Handles zh/en
- * parens, dashes, colons and trailing separators before the suffix.
- */
-function stripHeadingDecorations(normalized) {
-    return normalized
-        .replace(/[（(][^（()）]*[)）]\s*$/u, "")
-        .replace(/\s*[—–\-|]\s*[^—–\-|]+$/u, "")
-        .replace(/[:：]\s*$/u, "")
-        .trim();
-}
-const HEADING_PREFIX_HINTS = [
-    { key: "objective", hint: "目标" },
-    { key: "objective", hint: "objective" },
-    { key: "scope", hint: "范围" },
-    { key: "scope", hint: "scope" },
-    { key: "nonGoals", hint: "非目标" },
-    { key: "nonGoals", hint: "out of scope" },
-    { key: "acceptance", hint: "验收" },
-    { key: "acceptance", hint: "acceptance" },
-    { key: "acceptance", hint: "完成标准" },
-    { key: "acceptance", hint: "完成定义" },
-    { key: "acceptance", hint: "dod" },
-    { key: "constraints", hint: "约束" },
-    { key: "constraints", hint: "constraints" },
-    { key: "openQuestions", hint: "待决问题" },
-    { key: "openQuestions", hint: "open questions" },
-    { key: "assumptions", hint: "假设" },
-    { key: "assumptions", hint: "assumptions" },
-];
 function classifyHeading(text) {
     const normalized = normalizeHeadingText(text);
     for (const [key, aliases] of Object.entries(HEADING_ALIASES)) {
         if (aliases.has(normalized))
             return key;
     }
-    // Decoration-stripped exact match: "完成标准（验收）" → "完成标准".
-    const stripped = stripHeadingDecorations(normalized);
-    if (stripped && stripped !== normalized) {
-        for (const [key, aliases] of Object.entries(HEADING_ALIASES)) {
-            if (aliases.has(stripped))
-                return key;
-        }
-    }
-    // Prefix-contains fallback: "验收标准与测试" starts with "验收"; keep the
-    // hint list narrow (whole-word/leading-substring) to avoid false hits.
-    for (const { key, hint } of HEADING_PREFIX_HINTS) {
-        if (stripped === hint || stripped.startsWith(hint))
-            return key;
-    }
     return "other";
 }
 function isAtxHeading(line) {
@@ -454,20 +394,10 @@ export function fillMissingRequirementFacts(base, supplemental) {
 export function parseVerifyFlag(raw) {
     const idx = raw.indexOf(":");
     if (idx <= 0 || idx === raw.length - 1) {
-        // Actionable error with concrete examples (2026-08-16 L3'-style):
-        // models were guessing flag names (--verify-label) and separator
-        // shapes; the example makes the contract self-evident.
-        const hint = !raw.includes(":")
-            ? `no label separator found; write it as <label>:<command>, e.g. --verify "typecheck:npm run typecheck"`
-            : `empty ${idx === 0 ? "label" : "command"}; write it as <label>:<command>, e.g. --verify "typecheck:npm run typecheck"`;
-        throw new Error(`invalid --verify value "${raw}"; expected <label>:<command> — ${hint}`);
-    }
-    const label = raw.slice(0, idx).trim();
-    if (!/^[a-z0-9][a-z0-9-]*$/i.test(label)) {
-        throw new Error(`invalid --verify label "${label}"; use short kebab-case letters/digits/hyphens (e.g. typecheck, unit-tests, build) — value was "${raw}"`);
+        throw new Error(`invalid --verify value "${raw}"; expected <label>:<command>`);
     }
     return {
-        label,
+        label: raw.slice(0, idx).trim(),
         command: raw.slice(idx + 1).trim(),
     };
 }