agentplane 0.1.9 → 0.2.1

package/dist/commands/upgrade.d.ts

@@ -1,6 +1,23 @@
-export declare function cmdUpgrade(opts: {
+export type UpgradeFlags = {
+    source?: string;
+    tag?: string;
+    bundle?: string;
+    checksum?: string;
+    asset?: string;
+    checksumAsset?: string;
+    dryRun: boolean;
+    backup: boolean;
+    yes: boolean;
+};
+export declare function normalizeFrameworkSourceForUpgrade(source: string): {
+    source: string;
+    owner: string;
+    repo: string;
+    migrated: boolean;
+};
+export declare function cmdUpgradeParsed(opts: {
     cwd: string;
     rootOverride?: string;
-    args: string[];
+    flags: UpgradeFlags;
 }): Promise<number>;
 //# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA8JA,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsLlB"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAmBF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAWA;AAkOD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuQlB"}

package/dist/commands/upgrade.js

@@ -6,87 +6,12 @@ import { backupPath, fileExists, getPathKind } from "../cli/fs-utils.js";
 import { downloadToFile, fetchJson } from "../cli/http.js";
 import { parseSha256Text, sha256File } from "../cli/checksum.js";
 import { extractArchive } from "../cli/archive.js";
-import { invalidFieldMessage, invalidValueMessage, missingValueMessage, requiredFieldMessage, usageMessage, } from "../cli/output.js";
+import { invalidFieldMessage, invalidValueMessage, requiredFieldMessage, warnMessage, } from "../cli/output.js";
 import { exitCodeForError } from "../cli/exit-codes.js";
 import { CliError } from "../shared/errors.js";
 import { ensureNetworkApproved } from "./shared/network-approval.js";
 const DEFAULT_UPGRADE_ASSET = "agentplane-upgrade.tar.gz";
 const DEFAULT_UPGRADE_CHECKSUM_ASSET = "agentplane-upgrade.tar.gz.sha256";
-const UPGRADE_USAGE = "Usage: agentplane upgrade [--tag <tag>] [--dry-run] [--no-backup] [--source <repo-url>] [--bundle <path|url>] [--checksum <path|url>] [--yes]";
-const UPGRADE_USAGE_EXAMPLE = "agentplane upgrade --tag v0.1.4 --dry-run";
-function parseUpgradeFlags(args) {
-    const out = { dryRun: false, backup: true, yes: false };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (!arg)
-            continue;
-        if (!arg.startsWith("--")) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: usageMessage(UPGRADE_USAGE, UPGRADE_USAGE_EXAMPLE),
-            });
-        }
-        if (arg === "--dry-run") {
-            out.dryRun = true;
-            continue;
-        }
-        if (arg === "--no-backup") {
-            out.backup = false;
-            continue;
-        }
-        if (arg === "--yes") {
-            out.yes = true;
-            continue;
-        }
-        const next = args[i + 1];
-        if (!next) {
-            throw new CliError({ exitCode: 2, code: "E_USAGE", message: missingValueMessage(arg) });
-        }
-        switch (arg) {
-            case "--source": {
-                out.source = next;
-                break;
-            }
-            case "--tag": {
-                out.tag = next;
-                break;
-            }
-            case "--bundle": {
-                out.bundle = next;
-                break;
-            }
-            case "--checksum": {
-                out.checksum = next;
-                break;
-            }
-            case "--asset": {
-                out.asset = next;
-                break;
-            }
-            case "--checksum-asset": {
-                out.checksumAsset = next;
-                break;
-            }
-            default: {
-                throw new CliError({
-                    exitCode: 2,
-                    code: "E_USAGE",
-                    message: usageMessage(UPGRADE_USAGE, UPGRADE_USAGE_EXAMPLE),
-                });
-            }
-        }
-        i++;
-    }
-    if ((out.bundle && !out.checksum) || (!out.bundle && out.checksum)) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: usageMessage(UPGRADE_USAGE, UPGRADE_USAGE_EXAMPLE),
-        });
-    }
-    return out;
-}
 function parseGitHubRepo(source) {
     const trimmed = source.trim();
     if (!trimmed)
@@ -105,6 +30,18 @@ function parseGitHubRepo(source) {
         throw new Error(invalidValueMessage("GitHub repo URL", trimmed, "owner/repo"));
     }
 }
+export function normalizeFrameworkSourceForUpgrade(source) {
+    const { owner, repo } = parseGitHubRepo(source);
+    if (owner === "basilisk-labs" && repo === "agent-plane") {
+        return {
+            source: `https://github.com/${owner}/agentplane`,
+            owner,
+            repo: "agentplane",
+            migrated: true,
+        };
+    }
+    return { source: `https://github.com/${owner}/${repo}`, owner, repo, migrated: false };
+}
 async function resolveUpgradeRoot(extractedDir) {
     const entries = await readdir(extractedDir, { withFileTypes: true });
     const dirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -133,14 +70,216 @@ function isAllowedUpgradePath(relPath) {
         return true;
     return relPath.startsWith(".agentplane/");
 }
-export async function cmdUpgrade(opts) {
-    const flags = parseUpgradeFlags(opts.args);
+const LOCAL_OVERRIDES_START = "<!-- AGENTPLANE:LOCAL-START -->";
+const LOCAL_OVERRIDES_END = "<!-- AGENTPLANE:LOCAL-END -->";
+function extractLocalOverridesBlock(text) {
+    const start = text.indexOf(LOCAL_OVERRIDES_START);
+    const end = text.indexOf(LOCAL_OVERRIDES_END);
+    if (start === -1 || end === -1 || end < start)
+        return null;
+    return text.slice(start + LOCAL_OVERRIDES_START.length, end).trim();
+}
+function withLocalOverridesBlock(base, localOverrides) {
+    const start = base.indexOf(LOCAL_OVERRIDES_START);
+    const end = base.indexOf(LOCAL_OVERRIDES_END);
+    if (start === -1 || end === -1 || end < start) {
+        const suffix = "\n\n## Local Overrides (preserved across upgrades)\n\n" +
+            `${LOCAL_OVERRIDES_START}\n` +
+            (localOverrides.trim() ? `${localOverrides.trim()}\n` : "") +
+            `${LOCAL_OVERRIDES_END}\n`;
+        return `${base.trimEnd()}${suffix}`;
+    }
+    const before = base.slice(0, start + LOCAL_OVERRIDES_START.length);
+    const after = base.slice(end);
+    return `${before}\n${localOverrides.trim() ? `${localOverrides.trim()}\n` : ""}${after}`;
+}
+function parseH2Sections(text) {
+    const lines = text.replaceAll("\r\n", "\n").split("\n");
+    const sections = new Map();
+    let current = null;
+    let buf = [];
+    const flush = () => {
+        if (!current)
+            return;
+        if (!sections.has(current)) {
+            sections.set(current, buf.join("\n").trimEnd());
+        }
+    };
+    for (const line of lines) {
+        const m = /^##\s+(.+?)\s*$/.exec(line);
+        if (m) {
+            flush();
+            current = (m[1] ?? "").trim();
+            buf = [];
+            continue;
+        }
+        if (current)
+            buf.push(line);
+    }
+    flush();
+    return sections;
+}
+function mergeAgentsPolicyMarkdown(incoming, current) {
+    const local = extractLocalOverridesBlock(current);
+    if (local !== null) {
+        return withLocalOverridesBlock(incoming, local);
+    }
+    // Fallback: if the user edited AGENTS.md without the local markers, preserve their changes by
+    // appending differing/extra sections into a dedicated local overrides block.
+    const incomingSections = parseH2Sections(incoming);
+    const currentSections = parseH2Sections(current);
+    const overrides = [];
+    for (const [title, body] of currentSections.entries()) {
+        const incomingBody = incomingSections.get(title);
+        if (incomingBody === undefined) {
+            overrides.push(`### Added section: ${title}\n\n${body.trim()}\n`);
+            continue;
+        }
+        if (incomingBody.trim() !== body.trim()) {
+            overrides.push(`### Local edits for: ${title}\n\n${body.trim()}\n`);
+        }
+    }
+    if (overrides.length === 0)
+        return incoming;
+    return withLocalOverridesBlock(incoming, overrides.join("\n"));
+}
+function isJsonRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function mergeAgentJson(incomingText, currentText) {
+    let incoming;
+    let current;
+    try {
+        incoming = JSON.parse(incomingText);
+        current = JSON.parse(currentText);
+    }
+    catch {
+        return null;
+    }
+    if (!isJsonRecord(incoming) || !isJsonRecord(current))
+        return null;
+    const out = { ...incoming };
+    for (const [k, curVal] of Object.entries(current)) {
+        const incVal = incoming[k];
+        if (incVal === undefined) {
+            out[k] = curVal;
+            continue;
+        }
+        if (Array.isArray(incVal) && Array.isArray(curVal)) {
+            const merged = [...incVal];
+            for (const item of curVal) {
+                if (!merged.some((x) => JSON.stringify(x) === JSON.stringify(item)))
+                    merged.push(item);
+            }
+            out[k] = merged;
+            continue;
+        }
+        if (isJsonRecord(incVal) && isJsonRecord(curVal)) {
+            out[k] = { ...incVal, ...curVal };
+            continue;
+        }
+        if (curVal !== incVal && curVal !== null && curVal !== "") {
+            out[k] = curVal;
+            continue;
+        }
+        out[k] = incVal;
+    }
+    return JSON.stringify(out, null, 2) + "\n";
+}
+function mergeAgentJson3Way(opts) {
+    let incoming;
+    let current;
+    let base;
+    try {
+        incoming = JSON.parse(opts.incomingText);
+        current = JSON.parse(opts.currentText);
+        base = JSON.parse(opts.baseText);
+    }
+    catch {
+        return null;
+    }
+    if (!isJsonRecord(incoming) || !isJsonRecord(current) || !isJsonRecord(base))
+        return null;
+    const keys = new Set([...Object.keys(incoming), ...Object.keys(current), ...Object.keys(base)]);
+    const out = {};
+    for (const key of keys) {
+        const incVal = incoming[key];
+        const curVal = current[key];
+        const baseVal = base[key];
+        // Arrays: always take incoming as base; if user changed vs base, append user-only items.
+        if (Array.isArray(incVal) && Array.isArray(curVal) && Array.isArray(baseVal)) {
+            const merged = [...incVal];
+            const userChanged = JSON.stringify(curVal) !== JSON.stringify(baseVal);
+            if (userChanged) {
+                for (const item of curVal) {
+                    if (!merged.some((x) => JSON.stringify(x) === JSON.stringify(item)))
+                        merged.push(item);
+                }
+            }
+            out[key] = merged;
+            continue;
+        }
+        // Objects: shallow merge; for each subkey, prefer incoming unless user changed vs base.
+        if (isJsonRecord(incVal) && isJsonRecord(curVal) && isJsonRecord(baseVal)) {
+            const merged = { ...incVal };
+            const subKeys = new Set([
+                ...Object.keys(incVal),
+                ...Object.keys(curVal),
+                ...Object.keys(baseVal),
+            ]);
+            for (const sk of subKeys) {
+                const incSub = incVal[sk];
+                const curSub = curVal[sk];
+                const baseSub = baseVal[sk];
+                const userChanged = JSON.stringify(curSub) !== JSON.stringify(baseSub);
+                if (userChanged)
+                    merged[sk] = curSub;
+                else if (incSub !== undefined)
+                    merged[sk] = incSub;
+                else if (curSub !== undefined)
+                    merged[sk] = curSub;
+            }
+            out[key] = merged;
+            continue;
+        }
+        // Scalars: prefer incoming unless the user changed vs base.
+        if (JSON.stringify(curVal) !== JSON.stringify(baseVal)) {
+            if (curVal !== undefined)
+                out[key] = curVal;
+            else if (incVal !== undefined)
+                out[key] = incVal;
+            continue;
+        }
+        if (incVal !== undefined)
+            out[key] = incVal;
+        else if (curVal !== undefined)
+            out[key] = curVal;
+    }
+    return JSON.stringify(out, null, 2) + "\n";
+}
+export async function cmdUpgradeParsed(opts) {
+    const flags = opts.flags;
+    if ((flags.bundle && !flags.checksum) || (!flags.bundle && flags.checksum)) {
+        // Defensive: cli2 spec validate should prevent this, but keep invariant enforcement
+        // for any non-CLI callers.
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: "Options --bundle and --checksum must be provided together (or omitted together).",
+        });
+    }
     const resolved = await resolveProject({
         cwd: opts.cwd,
         rootOverride: opts.rootOverride ?? null,
     });
     const loaded = await loadConfig(resolved.agentplaneDir);
-    const source = flags.source ?? loaded.config.framework.source;
+    const sourceFromFlags = typeof flags.source === "string" && flags.source.trim().length > 0;
+    const originalSource = flags.source ?? loaded.config.framework.source;
+    const normalized = normalizeFrameworkSourceForUpgrade(originalSource);
+    const source = normalized.source;
+    if (normalized.migrated) {
+        process.stderr.write(`${warnMessage(`config.framework.source uses deprecated repo basilisk-labs/agent-plane; using ${source}`)}\n`);
+    }
     let networkApproved = false;
     const ensureApproved = async (reason) => {
         if (networkApproved)
@@ -172,7 +311,7 @@ export async function cmdUpgrade(opts) {
             }
         }
         else {
-            const { owner, repo } = parseGitHubRepo(source);
+            const { owner, repo } = normalized;
             const releaseUrl = flags.tag
                 ? `https://api.github.com/repos/${owner}/${repo}/releases/tags/${flags.tag}`
                 : `https://api.github.com/repos/${owner}/${repo}/releases/latest`;
@@ -215,8 +354,6 @@ export async function cmdUpgrade(opts) {
         await extractArchive({
             archivePath: bundlePath,
             destDir: extractRoot,
-            usage: UPGRADE_USAGE,
-            example: UPGRADE_USAGE_EXAMPLE,
         });
         const bundleRoot = await resolveUpgradeRoot(extractRoot);
         const files = await listFilesRecursive(bundleRoot);
@@ -224,6 +361,15 @@ export async function cmdUpgrade(opts) {
         const updates = [];
         const skipped = [];
         const fileContents = new Map();
+        const merged = [];
+        const baselineDir = path.join(resolved.agentplaneDir, "upgrade", "baseline");
+        const toBaselineKey = (rel) => {
+            if (rel === "AGENTS.md")
+                return "AGENTS.md";
+            if (rel.startsWith(".agentplane/"))
+                return rel.slice(".agentplane/".length);
+            return null;
+        };
         for (const filePath of files) {
             let rel = path.relative(bundleRoot, filePath).replaceAll("\\", "/");
             if (!rel || rel.startsWith("..") || path.isAbsolute(rel)) {
@@ -256,14 +402,49 @@ export async function cmdUpgrade(opts) {
                     message: `Upgrade target is a directory: ${rel}`,
                 });
             }
-            const data = await readFile(filePath);
+            if (rel === ".agentplane/config.json") {
+                // Never overwrite local config during upgrade.
+                skipped.push(rel);
+                continue;
+            }
+            let data = await readFile(filePath);
+            if (kind !== null) {
+                const existing = await readFile(destPath, "utf8");
+                if (rel === "AGENTS.md") {
+                    const mergedText = mergeAgentsPolicyMarkdown(data.toString("utf8"), existing);
+                    data = Buffer.from(mergedText, "utf8");
+                    merged.push(rel);
+                }
+                else if (rel.startsWith(".agentplane/agents/") && rel.endsWith(".json")) {
+                    const baselineKey = toBaselineKey(rel);
+                    let mergedText = null;
+                    if (baselineKey) {
+                        try {
+                            const baselineText = await readFile(path.join(baselineDir, baselineKey), "utf8");
+                            mergedText = mergeAgentJson3Way({
+                                incomingText: data.toString("utf8"),
+                                currentText: existing,
+                                baseText: baselineText,
+                            });
+                        }
+                        catch {
+                            mergedText = null;
+                        }
+                    }
+                    mergedText ??= mergeAgentJson(data.toString("utf8"), existing);
+                    if (mergedText) {
+                        data = Buffer.from(mergedText, "utf8");
+                        merged.push(rel);
+                    }
+                }
+            }
             fileContents.set(rel, data);
             if (kind === null) {
                 additions.push(rel);
             }
             else {
-                const existing = await readFile(destPath);
-                if (Buffer.compare(existing, data) === 0) {
+                const existingBuf = await readFile(destPath);
+                if (Buffer.compare(existingBuf, data) === 0) {
                     skipped.push(rel);
                 }
                 else {
@@ -279,8 +460,13 @@ export async function cmdUpgrade(opts) {
                 process.stdout.write(`UPDATE ${rel}\n`);
             for (const rel of skipped)
                 process.stdout.write(`SKIP ${rel}\n`);
+            for (const rel of merged)
+                process.stdout.write(`MERGE ${rel}\n`);
             return 0;
         }
+        if (skipped.includes(".agentplane/config.json")) {
+            process.stderr.write(`${warnMessage("upgrade bundle includes .agentplane/config.json; skipping to preserve local configuration")}\n`);
+        }
         for (const rel of [...additions, ...updates]) {
             const destPath = path.join(resolved.gitRoot, rel);
             if (flags.backup && (await fileExists(destPath))) {
@@ -290,8 +476,18 @@ export async function cmdUpgrade(opts) {
             const data = fileContents.get(rel);
             if (data)
                 await writeFile(destPath, data);
+            // Record a baseline copy for future three-way merges.
+            const baselineKey = toBaselineKey(rel);
+            if (baselineKey && data) {
+                const baselinePath = path.join(baselineDir, baselineKey);
+                await mkdir(path.dirname(baselinePath), { recursive: true });
+                await writeFile(baselinePath, data);
+            }
         }
         const raw = { ...loaded.raw };
+        if (!sourceFromFlags && normalized.migrated) {
+            setByDottedKey(raw, "framework.source", source);
+        }
         setByDottedKey(raw, "framework.last_update", new Date().toISOString());
         await saveConfig(resolved.agentplaneDir, raw);
         process.stdout.write(`Upgrade applied: ${additions.length} add, ${updates.length} update, ${skipped.length} unchanged\n`);

package/dist/commands/verify.command.d.ts

@@ -0,0 +1,16 @@
+import type { CommandCtx, CommandSpec } from "../cli/spec/spec.js";
+import type { CommandContext } from "./shared/task-backend.js";
+type VerifyState = "ok" | "needs_rework";
+export type VerifyParsed = {
+    taskId: string;
+    state: VerifyState;
+    by: string;
+    note: string;
+    details?: string;
+    file?: string;
+    quiet: boolean;
+};
+export declare const verifySpec: CommandSpec<VerifyParsed>;
+export declare function makeRunVerifyHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: VerifyParsed) => Promise<number>;
+export {};
+//# sourceMappingURL=verify.command.d.ts.map

package/dist/commands/verify.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.command.d.ts","sourceRoot":"","sources":["../../src/commands/verify.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,KAAK,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CA8FhD,CAAC;AAEF,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,CAcjE"}

package/dist/commands/verify.command.js

@@ -0,0 +1,113 @@
+import { usageError } from "../cli/spec/errors.js";
+import { cmdVerifyParsed } from "./task/verify-record.js";
+export const verifySpec = {
+    id: ["verify"],
+    group: "Lifecycle",
+    summary: "Record a verification outcome for a task (record-only; does not execute commands).",
+    args: [
+        {
+            name: "task-id",
+            required: true,
+            valueHint: "<task-id>",
+            description: "Existing task id.",
+        },
+    ],
+    options: [
+        {
+            kind: "boolean",
+            name: "ok",
+            default: false,
+            description: "Record an OK verification outcome.",
+        },
+        {
+            kind: "boolean",
+            name: "rework",
+            default: false,
+            description: "Record a needs-rework verification outcome.",
+        },
+        {
+            kind: "string",
+            name: "by",
+            valueHint: "<id>",
+            required: true,
+            description: "Verifier id (e.g. REVIEWER).",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            required: true,
+            description: "Short note describing the verification outcome.",
+        },
+        {
+            kind: "string",
+            name: "details",
+            valueHint: "<text>",
+            description: "Optional free-form details (mutually exclusive with --file).",
+        },
+        {
+            kind: "string",
+            name: "file",
+            valueHint: "<path>",
+            description: "Read details from a file path (mutually exclusive with --details).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane verify 202602030608-F1Q8AB --ok --by REVIEWER --note "Looks good" --quiet',
+            why: "Record an OK verification outcome.",
+        },
+        {
+            cmd: 'agentplane verify 202602030608-F1Q8AB --rework --by REVIEWER --note "Needs changes" --details "Missing tests"',
+            why: "Record a needs-rework outcome with details.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const ok = raw.opts.ok === true;
+        const rework = raw.opts.rework === true;
+        if (ok === rework) {
+            throw usageError({
+                spec: verifySpec,
+                command: "verify",
+                message: "Exactly one of --ok or --rework must be provided.",
+            });
+        }
+        if (typeof raw.opts.details === "string" && typeof raw.opts.file === "string") {
+            throw usageError({
+                spec: verifySpec,
+                command: "verify",
+                message: "Options --details and --file are mutually exclusive.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const ok = raw.opts.ok === true;
+        const state = ok ? "ok" : "needs_rework";
+        return {
+            taskId: typeof raw.args["task-id"] === "string" ? raw.args["task-id"] : "",
+            state,
+            by: raw.opts.by,
+            note: raw.opts.note,
+            details: raw.opts.details,
+            file: raw.opts.file,
+            quiet: raw.opts.quiet === true,
+        };
+    },
+};
+export function makeRunVerifyHandler(getCtx) {
+    return async (ctx, p) => {
+        return await cmdVerifyParsed({
+            ctx: await getCtx("verify"),
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride,
+            taskId: p.taskId,
+            state: p.state,
+            by: p.by,
+            note: p.note,
+            details: p.details,
+            file: p.file,
+            quiet: p.quiet,
+        });
+    };
+}

package/dist/commands/workflow.d.ts

@@ -1,8 +1,6 @@
-export declare const IDE_SYNC_USAGE = "Usage: agentplane ide sync";
-export declare const IDE_SYNC_USAGE_EXAMPLE = "agentplane ide sync";
-export { TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE, TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE, TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE, TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE, TASK_SCAFFOLD_USAGE, TASK_SCAFFOLD_USAGE_EXAMPLE, TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE, TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE, TASK_DOC_SHOW_USAGE, TASK_DOC_SHOW_USAGE_EXAMPLE, TASK_PLAN_USAGE, TASK_PLAN_USAGE_EXAMPLE, TASK_PLAN_SET_USAGE, TASK_PLAN_SET_USAGE_EXAMPLE, TASK_PLAN_APPROVE_USAGE, TASK_PLAN_APPROVE_USAGE_EXAMPLE, TASK_PLAN_REJECT_USAGE, TASK_PLAN_REJECT_USAGE_EXAMPLE, START_USAGE, START_USAGE_EXAMPLE, BLOCK_USAGE, BLOCK_USAGE_EXAMPLE, FINISH_USAGE, FINISH_USAGE_EXAMPLE, VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE, dedupeStrings, cmdTaskNew, cmdTaskAdd, cmdTaskUpdate, cmdTaskScrub, cmdTaskListWithFilters, cmdTaskNext, cmdReady, cmdTaskSearch, cmdTaskScaffold, cmdTaskNormalize, cmdTaskMigrate, cmdTaskMigrateDoc, cmdTaskPlan, cmdTaskComment, cmdTaskSetStatus, cmdTaskShow, cmdTaskList, cmdTaskExport, cmdTaskLint, cmdTaskDocSet, cmdTaskDocShow, cmdStart, cmdBlock, cmdFinish, cmdVerify, cmdTaskVerify, } from "./task/index.js";
-export { BRANCH_BASE_USAGE, BRANCH_BASE_USAGE_EXAMPLE, BRANCH_STATUS_USAGE, BRANCH_STATUS_USAGE_EXAMPLE, BRANCH_REMOVE_USAGE, BRANCH_REMOVE_USAGE_EXAMPLE, WORK_START_USAGE, WORK_START_USAGE_EXAMPLE, CLEANUP_MERGED_USAGE, CLEANUP_MERGED_USAGE_EXAMPLE, gitInitRepo, resolveInitBaseBranch, promptInitBaseBranch, ensureInitCommit, cmdWorkStart, cmdCleanupMerged, cmdBranchBaseGet, cmdBranchBaseSet, cmdBranchBaseClear, cmdBranchBaseExplain, cmdBranchStatus, cmdBranchRemove, } from "./branch/index.js";
-export { PR_OPEN_USAGE, PR_OPEN_USAGE_EXAMPLE, PR_UPDATE_USAGE, PR_UPDATE_USAGE_EXAMPLE, PR_CHECK_USAGE, PR_CHECK_USAGE_EXAMPLE, PR_NOTE_USAGE, PR_NOTE_USAGE_EXAMPLE, INTEGRATE_USAGE, INTEGRATE_USAGE_EXAMPLE, cmdPrOpen, cmdPrUpdate, cmdPrCheck, cmdPrNote, cmdIntegrate, } from "./pr/index.js";
-export { GUARD_COMMIT_USAGE, GUARD_COMMIT_USAGE_EXAMPLE, COMMIT_USAGE, COMMIT_USAGE_EXAMPLE, suggestAllowPrefixes, cmdGuardClean, cmdGuardSuggestAllow, cmdGuardCommit, cmdCommit, } from "./guard/index.js";
+export { dedupeStrings, cmdTaskDerive, cmdTaskAdd, cmdTaskUpdate, cmdTaskScrub, cmdTaskListWithFilters, cmdTaskNext, cmdReady, cmdTaskSearch, cmdTaskScaffold, cmdTaskNormalize, cmdTaskMigrate, cmdTaskMigrateDoc, cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject, cmdTaskComment, cmdTaskSetStatus, cmdTaskShow, cmdTaskList, cmdTaskExport, cmdTaskLint, cmdTaskDocSet, cmdTaskDocShow, cmdStart, cmdBlock, cmdFinish, cmdTaskVerifyOk, cmdTaskVerifyRework, } from "./task/index.js";
+export { gitInitRepo, resolveInitBaseBranch, promptInitBaseBranch, ensureInitCommit, cmdWorkStart, cmdCleanupMerged, cmdBranchBaseGet, cmdBranchBaseSet, cmdBranchBaseClear, cmdBranchBaseExplain, cmdBranchStatus, cmdBranchRemove, } from "./branch/index.js";
+export { cmdPrOpen, cmdPrUpdate, cmdPrCheck, cmdPrNote, cmdIntegrate } from "./pr/index.js";
+export { suggestAllowPrefixes, cmdGuardClean, cmdGuardSuggestAllow, cmdGuardCommit, cmdCommit, } from "./guard/index.js";
 export { HOOK_NAMES, cmdHooksInstall, cmdHooksUninstall, cmdHooksRun } from "./hooks/index.js";
 //# sourceMappingURL=workflow.d.ts.map

package/dist/commands/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,+BAA+B,CAAC;AAC3D,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,EAC9B,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE5F,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/commands/workflow.js

@@ -1,8 +1,5 @@
-// Thin public re-export layer: keep CLI imports stable while command implementations live by domain.
-export const IDE_SYNC_USAGE = "Usage: agentplane ide sync";
-export const IDE_SYNC_USAGE_EXAMPLE = "agentplane ide sync";
-export { TASK_NEW_USAGE, TASK_NEW_USAGE_EXAMPLE, TASK_ADD_USAGE, TASK_ADD_USAGE_EXAMPLE, TASK_SCRUB_USAGE, TASK_SCRUB_USAGE_EXAMPLE, TASK_UPDATE_USAGE, TASK_UPDATE_USAGE_EXAMPLE, TASK_SCAFFOLD_USAGE, TASK_SCAFFOLD_USAGE_EXAMPLE, TASK_MIGRATE_DOC_USAGE, TASK_MIGRATE_DOC_USAGE_EXAMPLE, TASK_DOC_SET_USAGE, TASK_DOC_SET_USAGE_EXAMPLE, TASK_DOC_SHOW_USAGE, TASK_DOC_SHOW_USAGE_EXAMPLE, TASK_PLAN_USAGE, TASK_PLAN_USAGE_EXAMPLE, TASK_PLAN_SET_USAGE, TASK_PLAN_SET_USAGE_EXAMPLE, TASK_PLAN_APPROVE_USAGE, TASK_PLAN_APPROVE_USAGE_EXAMPLE, TASK_PLAN_REJECT_USAGE, TASK_PLAN_REJECT_USAGE_EXAMPLE, START_USAGE, START_USAGE_EXAMPLE, BLOCK_USAGE, BLOCK_USAGE_EXAMPLE, FINISH_USAGE, FINISH_USAGE_EXAMPLE, VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, TASK_VERIFY_USAGE, TASK_VERIFY_USAGE_EXAMPLE, dedupeStrings, cmdTaskNew, cmdTaskAdd, cmdTaskUpdate, cmdTaskScrub, cmdTaskListWithFilters, cmdTaskNext, cmdReady, cmdTaskSearch, cmdTaskScaffold, cmdTaskNormalize, cmdTaskMigrate, cmdTaskMigrateDoc, cmdTaskPlan, cmdTaskComment, cmdTaskSetStatus, cmdTaskShow, cmdTaskList, cmdTaskExport, cmdTaskLint, cmdTaskDocSet, cmdTaskDocShow, cmdStart, cmdBlock, cmdFinish, cmdVerify, cmdTaskVerify, } from "./task/index.js";
-export { BRANCH_BASE_USAGE, BRANCH_BASE_USAGE_EXAMPLE, BRANCH_STATUS_USAGE, BRANCH_STATUS_USAGE_EXAMPLE, BRANCH_REMOVE_USAGE, BRANCH_REMOVE_USAGE_EXAMPLE, WORK_START_USAGE, WORK_START_USAGE_EXAMPLE, CLEANUP_MERGED_USAGE, CLEANUP_MERGED_USAGE_EXAMPLE, gitInitRepo, resolveInitBaseBranch, promptInitBaseBranch, ensureInitCommit, cmdWorkStart, cmdCleanupMerged, cmdBranchBaseGet, cmdBranchBaseSet, cmdBranchBaseClear, cmdBranchBaseExplain, cmdBranchStatus, cmdBranchRemove, } from "./branch/index.js";
-export { PR_OPEN_USAGE, PR_OPEN_USAGE_EXAMPLE, PR_UPDATE_USAGE, PR_UPDATE_USAGE_EXAMPLE, PR_CHECK_USAGE, PR_CHECK_USAGE_EXAMPLE, PR_NOTE_USAGE, PR_NOTE_USAGE_EXAMPLE, INTEGRATE_USAGE, INTEGRATE_USAGE_EXAMPLE, cmdPrOpen, cmdPrUpdate, cmdPrCheck, cmdPrNote, cmdIntegrate, } from "./pr/index.js";
-export { GUARD_COMMIT_USAGE, GUARD_COMMIT_USAGE_EXAMPLE, COMMIT_USAGE, COMMIT_USAGE_EXAMPLE, suggestAllowPrefixes, cmdGuardClean, cmdGuardSuggestAllow, cmdGuardCommit, cmdCommit, } from "./guard/index.js";
+export { dedupeStrings, cmdTaskDerive, cmdTaskAdd, cmdTaskUpdate, cmdTaskScrub, cmdTaskListWithFilters, cmdTaskNext, cmdReady, cmdTaskSearch, cmdTaskScaffold, cmdTaskNormalize, cmdTaskMigrate, cmdTaskMigrateDoc, cmdTaskPlanSet, cmdTaskPlanApprove, cmdTaskPlanReject, cmdTaskComment, cmdTaskSetStatus, cmdTaskShow, cmdTaskList, cmdTaskExport, cmdTaskLint, cmdTaskDocSet, cmdTaskDocShow, cmdStart, cmdBlock, cmdFinish, cmdTaskVerifyOk, cmdTaskVerifyRework, } from "./task/index.js";
+export { gitInitRepo, resolveInitBaseBranch, promptInitBaseBranch, ensureInitCommit, cmdWorkStart, cmdCleanupMerged, cmdBranchBaseGet, cmdBranchBaseSet, cmdBranchBaseClear, cmdBranchBaseExplain, cmdBranchStatus, cmdBranchRemove, } from "./branch/index.js";
+export { cmdPrOpen, cmdPrUpdate, cmdPrCheck, cmdPrNote, cmdIntegrate } from "./pr/index.js";
+export { suggestAllowPrefixes, cmdGuardClean, cmdGuardSuggestAllow, cmdGuardCommit, cmdCommit, } from "./guard/index.js";
 export { HOOK_NAMES, cmdHooksInstall, cmdHooksUninstall, cmdHooksRun } from "./hooks/index.js";

package/dist/meta/release.d.ts

@@ -0,0 +1,2 @@
+export declare function getReleaseCommitDate(): string | null;
+//# sourceMappingURL=release.d.ts.map

package/dist/meta/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/meta/release.ts"],"names":[],"mappings":"AA8BA,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAsBpD"}