agentplane 0.3.1 → 0.3.3

package/dist/commands/doctor.run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyUrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAmDlD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAuDlD,CAAC"}

package/dist/commands/doctor.run.js

@@ -1,316 +1,27 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { warnMessage, successMessage } from "../cli/output.js";
-import { RUNTIME_GITIGNORE_LINES } from "../shared/runtime-artifacts.js";
-import { resolvePolicyGatewayForRepo } from "../shared/policy-gateway.js";
-import { execFileAsync, gitEnv } from "./shared/git.js";
-import { loadCommandContext } from "./shared/task-backend.js";
-import { emitWorkflowEvent, isWorkflowEnforcementDisabled, resolveWorkflowPaths, safeAutofixWorkflowText, validateWorkflowAtPath, workflowEnforcementEnvHint, } from "../workflow-runtime/index.js";
-async function listTsFiles(rootDir) {
-    const out = [];
-    async function walk(absDir) {
-        const entries = await fs.readdir(absDir, { withFileTypes: true });
-        for (const ent of entries) {
-            if (ent.name.startsWith("."))
-                continue;
-            if (ent.name === "__snapshots__")
-                continue;
-            if (ent.name === "node_modules")
-                continue;
-            const abs = path.join(absDir, ent.name);
-            if (ent.isDirectory()) {
-                await walk(abs);
-                continue;
-            }
-            if (ent.isFile() && ent.name.endsWith(".ts")) {
-                out.push({ absPath: abs, relPath: path.relative(rootDir, abs) });
-            }
-        }
-    }
-    await walk(rootDir);
-    return out;
-}
-function extractImports(source) {
-    const imports = [];
-    const re = /^\s*import\s+(?:type\s+)?(?:[^"']*?\s+from\s+)?["']([^"']+)["']\s*;?/gm;
-    for (const match of source.matchAll(re)) {
-        imports.push(match[1] ?? "");
-    }
-    return imports.filter(Boolean);
-}
-async function pathExists(absPath) {
-    try {
-        await fs.access(absPath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function isDirectory(absPath) {
-    try {
-        const st = await fs.stat(absPath);
-        return st.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-async function checkWorkspace(repoRoot) {
-    const problems = [];
-    const requiredFiles = [path.join(repoRoot, ".agentplane", "config.json")];
-    for (const filePath of requiredFiles) {
-        if (!(await pathExists(filePath))) {
-            problems.push(`Missing required file: ${path.relative(repoRoot, filePath)}`);
-        }
-    }
-    const gateway = await resolvePolicyGatewayForRepo({
-        gitRoot: repoRoot,
-        fallbackFlavor: "codex",
-    });
-    if (!(await pathExists(gateway.absPath))) {
-        problems.push("Missing required policy gateway file: AGENTS.md or CLAUDE.md");
-    }
-    const agentsDir = path.join(repoRoot, ".agentplane", "agents");
-    if (!(await isDirectory(agentsDir))) {
-        problems.push("Missing required directory: .agentplane/agents");
-        return problems;
-    }
-    const entries = await fs.readdir(agentsDir);
-    const hasJson = entries.some((name) => name.endsWith(".json"));
-    if (!hasJson) {
-        problems.push("No agent profiles found in .agentplane/agents (*.json expected).");
-    }
-    return problems;
-}
-async function checkLayering(repoRoot) {
-    const problems = [];
-    const agentplaneSrcRoot = path.join(repoRoot, "packages", "agentplane", "src");
-    if (!(await isDirectory(agentplaneSrcRoot))) {
-        problems.push("Dev source checks requested but packages/agentplane/src was not found in this workspace.");
-        return problems;
-    }
-    const cliRoot = path.join(agentplaneSrcRoot, "cli");
-    const cliFiles = await listTsFiles(cliRoot);
-    for (const f of cliFiles) {
-        const src = await fs.readFile(f.absPath, "utf8");
-        const imports = extractImports(src);
-        const hits = imports.filter((s) => s.includes("/adapters/") ||
-            s.includes("../adapters") ||
-            s.includes("../../adapters") ||
-            s.includes("../../../adapters"));
-        if (hits.length > 0) {
-            problems.push(`${f.relPath} imports adapters directly: ${hits.join(", ")}`);
-        }
-    }
-    const roots = [path.join(agentplaneSrcRoot, "usecases"), path.join(agentplaneSrcRoot, "ports")];
-    const banned = [
-        "node:fs",
-        "node:fs/promises",
-        "fs",
-        "fs/promises",
-        "node:path",
-        "path",
-        "simple-git",
-        "isomorphic-git",
-    ];
-    for (const root of roots) {
-        const files = await listTsFiles(root);
-        for (const f of files) {
-            const src = await fs.readFile(f.absPath, "utf8");
-            const imports = extractImports(src);
-            const hits = imports.filter((s) => banned.some((b) => s === b || s.startsWith(`${b}/`)));
-            if (hits.length > 0) {
-                problems.push(`${f.relPath} imports banned modules: ${hits.join(", ")}`);
-            }
-        }
-    }
-    return problems;
-}
-async function safeFixGitignore(repoRoot) {
-    const gitignorePath = path.join(repoRoot, ".gitignore");
-    let existing = "";
-    try {
-        existing = await fs.readFile(gitignorePath, "utf8");
-    }
-    catch {
-        // If .gitignore doesn't exist, do not create it implicitly (keep doctor safe).
-        return { changed: false, note: "Skip: .gitignore not found." };
-    }
-    const lines = existing.split(/\r?\n/);
-    const existingSet = new Set(lines.map((line) => line.trimEnd()));
-    const missing = RUNTIME_GITIGNORE_LINES.filter((line) => !existingSet.has(line));
-    if (missing.length === 0) {
-        return { changed: false, note: "OK: .gitignore already contains agentplane runtime ignores." };
-    }
-    const nextLines = [...lines];
-    if (nextLines.length > 0 && nextLines.at(-1) !== "")
-        nextLines.push("");
-    nextLines.push(...missing, "");
-    const next = `${nextLines.join("\n")}`.replaceAll(/\n{2,}$/g, "\n");
-    await fs.writeFile(gitignorePath, next, "utf8");
-    return {
-        changed: true,
-        note: `Fixed: added agentplane runtime ignores to .gitignore (${missing.length} lines).`,
-    };
-}
-async function safeFixTaskIndex(repoRoot) {
-    try {
-        // Best-effort: rebuilding the index is a side-effect of listing tasks for the local backend.
-        const ctx = await loadCommandContext({ cwd: repoRoot, rootOverride: null });
-        await ctx.taskBackend.listTasks();
-        return { changed: true, note: "OK: rebuilt tasks index cache (best-effort)." };
-    }
-    catch {
-        return { changed: false, note: "Skip: could not rebuild tasks index cache." };
-    }
-}
-async function checkWorkflowContract(repoRoot) {
-    const result = await validateWorkflowAtPath(repoRoot);
-    const findings = result.diagnostics.map((d) => `[${d.severity}] ${d.code} ${d.path}: ${d.message}`);
-    emitWorkflowEvent({
-        event: "workflow_doctor_check",
-        details: { ok: result.ok, findings: result.diagnostics.length },
-    });
-    return findings;
-}
-function findingSeverity(problem) {
-    const normalized = problem.trimStart();
-    if (normalized.startsWith("[WARN]"))
-        return "WARN";
-    if (normalized.startsWith("[INFO]"))
-        return "INFO";
-    if (normalized.startsWith("[ERROR]"))
-        return "ERROR";
-    return "ERROR";
-}
-async function safeFixWorkflow(repoRoot) {
-    const paths = resolveWorkflowPaths(repoRoot);
-    let current = "";
-    let sourcePath = paths.workflowPath;
-    try {
-        current = await fs.readFile(paths.workflowPath, "utf8");
-    }
-    catch {
-        try {
-            current = await fs.readFile(paths.legacyWorkflowPath, "utf8");
-            sourcePath = paths.legacyWorkflowPath;
-        }
-        catch {
-            return { changed: false, note: "Skip: workflow contract file not found." };
-        }
-    }
-    const fixed = safeAutofixWorkflowText(current);
-    if (fixed.diagnostics.some((d) => d.code === "WF_FIX_SKIPPED_UNSAFE")) {
-        const details = fixed.diagnostics.map((d) => `${d.path}`).join(", ");
-        return {
-            changed: false,
-            note: `Skip: unsafe workflow autofix required (unknown keys). Proposed manual review: ${details}`,
-        };
-    }
-    if (!fixed.changed) {
-        if (sourcePath === paths.workflowPath) {
-            return { changed: false, note: "OK: workflow contract already normalized." };
-        }
-        await fs.mkdir(path.dirname(paths.workflowPath), { recursive: true });
-        await fs.writeFile(paths.workflowPath, current, "utf8");
-        await fs.rm(paths.legacyWorkflowPath, { force: true });
-        await fs.mkdir(paths.workflowDir, { recursive: true });
-        await fs.copyFile(paths.workflowPath, paths.lastKnownGoodPath);
-        return {
-            changed: true,
-            note: "Fixed: moved legacy WORKFLOW.md into .agentplane and refreshed last-known-good.",
-        };
-    }
-    await fs.mkdir(path.dirname(paths.workflowPath), { recursive: true });
-    await fs.writeFile(paths.workflowPath, fixed.text, "utf8");
-    if (sourcePath === paths.legacyWorkflowPath) {
-        await fs.rm(paths.legacyWorkflowPath, { force: true });
-    }
-    await fs.mkdir(paths.workflowDir, { recursive: true });
-    await fs.copyFile(paths.workflowPath, paths.lastKnownGoodPath);
-    return {
-        changed: true,
-        note: "Fixed: normalized workflow contract and refreshed last-known-good.",
-    };
-}
-async function checkDoneTaskCommitInvariants(repoRoot) {
-    const tasksPath = path.join(repoRoot, ".agentplane", "tasks.json");
-    let raw = "";
-    try {
-        raw = await fs.readFile(tasksPath, "utf8");
-    }
-    catch {
-        return [];
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return [`Invalid JSON snapshot: ${path.relative(repoRoot, tasksPath)}`];
-    }
-    const all = Array.isArray(parsed.tasks) ? parsed.tasks : [];
-    const done = all.filter((t) => {
-        const status = typeof t.status === "string" ? t.status : "";
-        return status.toUpperCase() === "DONE";
-    });
-    if (done.length === 0)
-        return [];
-    const problems = [];
-    const hashes = new Set();
-    for (const task of done) {
-        const id = typeof task.id === "string" ? task.id : "<unknown>";
-        const hash = typeof task.commit?.hash === "string" ? task.commit.hash.trim() : "";
-        if (!hash) {
-            problems.push(`DONE task is missing implementation commit hash: ${id} (finish with --commit <hash>).`);
-            continue;
-        }
-        hashes.add(hash);
-    }
-    if (hashes.size === 0)
-        return problems;
-    const subjectByHash = new Map();
-    for (const hash of hashes) {
-        try {
-            const { stdout } = await execFileAsync("git", ["show", "-s", "--format=%s", hash], {
-                cwd: repoRoot,
-                env: gitEnv(),
-            });
-            subjectByHash.set(hash, String(stdout ?? "").trim());
-        }
-        catch {
-            subjectByHash.set(hash, "");
-        }
-    }
-    for (const task of done) {
-        const id = typeof task.id === "string" ? task.id : "<unknown>";
-        const hash = typeof task.commit?.hash === "string" ? task.commit.hash.trim() : "";
-        if (!hash)
-            continue;
-        const subject = subjectByHash.get(hash) ?? "";
-        if (!subject) {
-            problems.push(`[WARN] DONE task references unknown commit hash: ${id} -> ${hash}`);
-            continue;
-        }
-        if (/\bclose:/iu.test(subject)) {
-            problems.push(`[WARN] DONE task implementation commit points to a close commit: ${id} -> ${hash} (${subject})`);
-        }
-    }
-    return problems;
-}
+import { checkDoneTaskCommitInvariants } from "./doctor/archive.js";
+import { safeFixGitignore, safeFixTaskIndex } from "./doctor/fixes.js";
+import { checkLayering } from "./doctor/layering.js";
+import { checkRuntimeSourceFacts, findingSeverity } from "./doctor/runtime.js";
+import { checkWorkspace } from "./doctor/workspace.js";
+import { checkWorkflowContract, safeFixWorkflow } from "./doctor/workflow.js";
+import { isWorkflowEnforcementDisabled, workflowEnforcementEnvHint, } from "../workflow-runtime/index.js";
 export const runDoctor = async (ctx, p) => {
     const resolved = await resolveProject({ cwd: ctx.cwd, rootOverride: ctx.rootOverride ?? null });
     const repoRoot = resolved.gitRoot;
+    const loadedConfig = await loadConfig(resolved.agentplaneDir);
     const runChecks = async () => {
-        const checks = await checkWorkspace(repoRoot);
-        checks.push(...(await checkDoneTaskCommitInvariants(repoRoot)));
+        let checks = [
+            ...(await checkWorkspace(repoRoot)),
+            ...checkRuntimeSourceFacts(ctx.cwd, loadedConfig.config),
+            ...(await checkDoneTaskCommitInvariants(repoRoot, { fullArchive: p.archiveFull })),
+        ];
         if (!isWorkflowEnforcementDisabled()) {
-            checks.push(...(await checkWorkflowContract(repoRoot)));
+            checks = [...checks, ...(await checkWorkflowContract(repoRoot))];
         }
         if (p.dev) {
-            checks.push(...(await checkLayering(repoRoot)));
+            checks = [...checks, ...(await checkLayering(repoRoot))];
         }
         return checks;
     };

package/dist/commands/doctor.spec.d.ts

@@ -2,6 +2,7 @@ import type { CommandSpec } from "../cli/spec/spec.js";
 export type DoctorParsed = {
     fix: boolean;
     dev: boolean;
+    archiveFull?: boolean;
 };
 export declare const doctorSpec: CommandSpec<DoctorParsed>;
 //# sourceMappingURL=doctor.spec.d.ts.map

package/dist/commands/doctor.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.spec.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAoBhD,CAAC"}
+{"version":3,"file":"doctor.spec.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAkChD,CAAC"}

package/dist/commands/doctor.spec.js

@@ -10,11 +10,25 @@ export const doctorSpec = {
             default: false,
             description: "Run monorepo source-layer checks (requires packages/agentplane/src).",
         },
+        {
+            kind: "boolean",
+            name: "archive-full",
+            default: false,
+            description: "Run the full historical task archive audit instead of the bounded recent scan.",
+        },
     ],
     examples: [
         { cmd: "agentplane doctor", why: "Check installed workspace invariants." },
+        {
+            cmd: "agentplane doctor --archive-full",
+            why: "Also scan the full historical task archive for older commit anomalies.",
+        },
         { cmd: "agentplane doctor --dev", why: "Also run monorepo source-layer checks." },
         { cmd: "agentplane doctor --fix", why: "Apply safe-only fixes (idempotent)." },
     ],
-    parse: (raw) => ({ fix: raw.opts.fix === true, dev: raw.opts.dev === true }),
+    parse: (raw) => ({
+        fix: raw.opts.fix === true,
+        dev: raw.opts.dev === true,
+        archiveFull: raw.opts["archive-full"] === true,
+    }),
 };

package/dist/commands/finish.run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish.run.d.ts","sourceRoot":"","sources":["../../src/commands/finish.run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAsCjE"}
+{"version":3,"file":"finish.run.d.ts","sourceRoot":"","sources":["../../src/commands/finish.run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IACrE,KAAK,UAAU,EAAE,GAAG,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAuCjE"}

package/dist/commands/finish.run.js

@@ -36,6 +36,7 @@ export function makeRunFinishHandler(getCtx) {
             statusCommitRequireClean: p.statusCommitRequireClean,
             confirmStatusCommit: p.confirmStatusCommit,
             closeCommit: p.closeCommit,
+            noCloseCommit: p.noCloseCommit,
             closeUnstageOthers: p.closeUnstageOthers,
             quiet: p.quiet,
         });

package/dist/commands/finish.spec.d.ts

@@ -22,6 +22,7 @@ export type FinishParsed = {
     statusCommitRequireClean: boolean;
     confirmStatusCommit: boolean;
     closeCommit: boolean;
+    noCloseCommit: boolean;
     closeUnstageOthers: boolean;
     quiet: boolean;
 };

package/dist/commands/finish.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish.spec.d.ts","sourceRoot":"","sources":["../../src/commands/finish.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAsShD,CAAC"}
+{"version":3,"file":"finish.spec.d.ts","sourceRoot":"","sources":["../../src/commands/finish.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA6ThD,CAAC"}

package/dist/commands/finish.spec.js

@@ -145,6 +145,12 @@ export const finishSpec = {
             default: false,
             description: "After finishing, run a deterministic close commit for the task README (single-task only).",
         },
+        {
+            kind: "boolean",
+            name: "no-close-commit",
+            default: false,
+            description: "Disable the default deterministic close commit in direct mode (single-task only).",
+        },
         {
             kind: "boolean",
             name: "close-unstage-others",
@@ -228,12 +234,26 @@ export const finishSpec = {
                 message: "--close-commit requires exactly one task id",
             });
         }
-        if (raw.opts["close-commit"] === true &&
+        if (raw.opts["no-close-commit"] === true && taskIds.length !== 1) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--no-close-commit requires exactly one task id",
+            });
+        }
+        if (raw.opts["close-commit"] === true && raw.opts["no-close-commit"] === true) {
+            throw usageError({
+                spec: finishSpec,
+                command: "finish",
+                message: "--close-commit and --no-close-commit are mutually exclusive",
+            });
+        }
+        if ((raw.opts["close-commit"] === true || raw.opts["no-close-commit"] === true) &&
             (raw.opts["commit-from-comment"] === true || raw.opts["status-commit"] === true)) {
             throw usageError({
                 spec: finishSpec,
                 command: "finish",
-                message: "--close-commit cannot be combined with --commit-from-comment/--status-commit",
+                message: "--close-commit/--no-close-commit cannot be combined with --commit-from-comment/--status-commit",
             });
         }
         if (raw.opts["close-unstage-others"] === true && raw.opts["close-commit"] !== true) {
@@ -279,6 +299,7 @@ export const finishSpec = {
         statusCommitRequireClean: raw.opts["status-commit-require-clean"] === true,
         confirmStatusCommit: raw.opts["confirm-status-commit"] === true,
         closeCommit: raw.opts["close-commit"] === true,
+        noCloseCommit: raw.opts["no-close-commit"] === true,
         closeUnstageOthers: raw.opts["close-unstage-others"] === true,
         quiet: raw.opts.quiet === true,
     }),

package/dist/commands/guard/impl/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAyDxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmJlB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAuExE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgKlB"}

package/dist/commands/guard/impl/commands.js

@@ -1,5 +1,6 @@
 import { mapCoreError } from "../../../cli/error-map.js";
 import { successMessage } from "../../../cli/output.js";
+import { withDiagnosticContext } from "../../../shared/diagnostics.js";
 import { CliError } from "../../../shared/errors.js";
 import { loadCommandContext } from "../../shared/task-backend.js";
 import { loadTaskFromContext } from "../../shared/task-backend.js";
@@ -50,6 +51,15 @@ function asCommitFailure(err) {
                 exitCode: 5,
                 code: "E_GIT",
                 message: lines.join("\n"),
+                context: withDiagnosticContext({ command: "commit" }, {
+                    state: "git rejected the generated close commit",
+                    likelyCause: "a hook or commit policy blocked the deterministic task close commit after the task README was staged",
+                    nextAction: {
+                        command: "git status --short --untracked-files=no",
+                        reason: "inspect the staged close-commit payload before fixing the hook or policy failure",
+                        reasonCode: "git_close_commit_blocked",
+                    },
+                }),
             });
         }
         return null;
@@ -150,6 +160,15 @@ export async function cmdCommit(opts) {
                     exitCode: 5,
                     code: "E_GIT",
                     message: "Staged files exist (close commit requires an empty index; rerun with --unstage-others to auto-unstage).",
+                    context: withDiagnosticContext({ command: "commit" }, {
+                        state: "close commit cannot run with a non-empty git index",
+                        likelyCause: "deterministic close commits only stage the task README, but other staged files are already in the index",
+                        nextAction: {
+                            command: "git restore --staged -- .",
+                            reason: "clear the current index before rerunning the close commit flow",
+                            reasonCode: "git_close_commit_dirty_index",
+                        },
+                    }),
                 });
             }
             const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });

package/dist/commands/release/apply.command.d.ts

@@ -1,11 +1,6 @@
 import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-export type ReleaseApplyFlags = {
-    plan?: string;
-    yes: boolean;
-    push: boolean;
-    remote: string;
-};
-export type ReleaseApplyParsed = ReleaseApplyFlags;
+import type { ReleaseApplyParsed } from "./apply.types.js";
 export declare const releaseApplySpec: CommandSpec<ReleaseApplyParsed>;
 export declare const runReleaseApply: CommandHandler<ReleaseApplyParsed>;
+export { pushReleaseRefs } from "./apply.reporting.js";
 //# sourceMappingURL=apply.command.d.ts.map

package/dist/commands/release/apply.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAU1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AA4VnD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiF5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAoL9D,CAAC"}
+{"version":3,"file":"apply.command.d.ts","sourceRoot":"","sources":["../../../src/commands/release/apply.command.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA4B1E,OAAO,KAAK,EAAE,kBAAkB,EAA0C,MAAM,kBAAkB,CAAC;AA2NnG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAiF5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAmE9D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}