agentplane 0.1.9 → 0.2.0

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":"AAkBA,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;AAgDF,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,CA6LlB"}

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 } 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)
@@ -133,8 +58,17 @@ function isAllowedUpgradePath(relPath) {
         return true;
     return relPath.startsWith(".agentplane/");
 }
-export async function cmdUpgrade(opts) {
-    const flags = parseUpgradeFlags(opts.args);
+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,
@@ -215,8 +149,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);

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"}

package/dist/meta/release.js

@@ -0,0 +1,50 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getVersion } from "./version.js";
+let cachedReleaseDate;
+function findGitRootSync(startDir) {
+    let dir = path.resolve(startDir);
+    for (;;) {
+        if (existsSync(path.join(dir, ".git")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function resolveGitRootForReleaseLookup() {
+    // Prefer the caller's CWD, but fall back to the package location when invoked
+    // outside of the repository.
+    const fromCwd = findGitRootSync(process.cwd());
+    if (fromCwd)
+        return fromCwd;
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const pkgRoot = path.resolve(here, "../../..");
+    return findGitRootSync(pkgRoot);
+}
+export function getReleaseCommitDate() {
+    if (cachedReleaseDate !== undefined)
+        return cachedReleaseDate;
+    const version = getVersion();
+    const tag = `v${version}`;
+    const gitRoot = resolveGitRootForReleaseLookup();
+    if (!gitRoot) {
+        cachedReleaseDate = null;
+        return cachedReleaseDate;
+    }
+    try {
+        const out = execFileSync("git", ["-C", gitRoot, "show", "-s", "--format=%cs", tag], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        cachedReleaseDate = out || null;
+        return cachedReleaseDate;
+    }
+    catch {
+        cachedReleaseDate = null;
+        return cachedReleaseDate;
+    }
+}

package/dist/policy/evaluate.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "./types.js";
+export declare function evaluatePolicy(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/policy/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/policy/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO9D,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CA2B/D"}

package/dist/policy/evaluate.js

@@ -0,0 +1,27 @@
+import { gitError, mergeResults, okResult } from "./result.js";
+import { allowlistRule } from "./rules/allowlist.js";
+import { branchPrBaseRule } from "./rules/branch-pr-base.js";
+import { cleanTreeRule } from "./rules/clean-tree.js";
+import { commitSubjectRule } from "./rules/commit-subject.js";
+import { protectedPathsRule } from "./rules/protected-paths.js";
+export function evaluatePolicy(ctx) {
+    const taskId = (ctx.taskId ?? "").trim();
+    if (!taskId && (ctx.action === "guard_commit" || ctx.action === "commit")) {
+        return { ok: false, errors: [gitError("Task id is required")], warnings: [] };
+    }
+    switch (ctx.action) {
+        case "hook_commit_msg": {
+            return commitSubjectRule(ctx);
+        }
+        case "hook_pre_commit": {
+            return mergeResults(protectedPathsRule(ctx), branchPrBaseRule(ctx));
+        }
+        case "guard_commit":
+        case "commit": {
+            return mergeResults(commitSubjectRule(ctx), cleanTreeRule(ctx), branchPrBaseRule(ctx), protectedPathsRule(ctx), allowlistRule(ctx));
+        }
+        default: {
+            return okResult();
+        }
+    }
+}

package/dist/policy/result.d.ts

@@ -0,0 +1,7 @@
+import type { PolicyProblem, PolicyResult } from "./types.js";
+export declare function okResult(): PolicyResult;
+export declare function usageError(message: string): PolicyProblem;
+export declare function gitError(message: string): PolicyProblem;
+export declare function internalError(message: string): PolicyProblem;
+export declare function mergeResults(...items: PolicyResult[]): PolicyResult;
+//# sourceMappingURL=result.d.ts.map

package/dist/policy/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/policy/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,QAAQ,IAAI,YAAY,CAEvC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEzD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEvD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED,wBAAgB,YAAY,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,CAQnE"}

package/dist/policy/result.js

@@ -0,0 +1,21 @@
+export function okResult() {
+    return { ok: true, errors: [], warnings: [] };
+}
+export function usageError(message) {
+    return { code: "E_USAGE", exitCode: 2, message };
+}
+export function gitError(message) {
+    return { code: "E_GIT", exitCode: 5, message };
+}
+export function internalError(message) {
+    return { code: "E_INTERNAL", exitCode: 1, message };
+}
+export function mergeResults(...items) {
+    const out = okResult();
+    for (const item of items) {
+        out.errors.push(...item.errors);
+        out.warnings.push(...item.warnings);
+    }
+    out.ok = out.errors.length === 0;
+    return out;
+}

package/dist/policy/rules/allowlist.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "../types.js";
+export declare function allowlistRule(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/policy/rules/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/allowlist.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CA+B9D"}

package/dist/policy/rules/allowlist.js

@@ -0,0 +1,30 @@
+import { gitPathIsUnderPrefix, normalizeGitPathPrefix } from "../../shared/git-path.js";
+import { gitError, okResult } from "../result.js";
+export function allowlistRule(ctx) {
+    const allowRaw = ctx.allow?.prefixes ?? [];
+    const staged = ctx.git.stagedPaths ?? [];
+    if (staged.length === 0) {
+        return { ok: false, errors: [gitError("No staged files (git index empty)")], warnings: [] };
+    }
+    if (allowRaw.length === 0) {
+        const message = ctx.action === "guard_commit" || ctx.action === "commit"
+            ? "Provide at least one --allow <path> prefix"
+            : "Provide at least one allowlist prefix";
+        return {
+            ok: false,
+            errors: [gitError(message)],
+            warnings: [],
+        };
+    }
+    const allow = allowRaw.map((p) => normalizeGitPathPrefix(p));
+    const errors = [];
+    for (const filePath of staged) {
+        if (!allow.some((prefix) => gitPathIsUnderPrefix(filePath, prefix))) {
+            errors.push(`Staged file is outside allowlist: ${filePath}`);
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors: errors.map((msg) => gitError(msg)), warnings: [] };
+    }
+    return okResult();
+}

package/dist/policy/rules/branch-pr-base.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "../types.js";
+export declare function branchPrBaseRule(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=branch-pr-base.d.ts.map

package/dist/policy/rules/branch-pr-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-pr-base.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/branch-pr-base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CA4CjE"}

package/dist/policy/rules/branch-pr-base.js

@@ -0,0 +1,43 @@
+import { gitError, internalError, okResult, usageError } from "../result.js";
+export function branchPrBaseRule(ctx) {
+    if (ctx.config.workflow_mode !== "branch_pr")
+        return okResult();
+    const baseBranch = ctx.git.baseBranch;
+    const currentBranch = ctx.git.currentBranch;
+    const staged = ctx.git.stagedPaths ?? [];
+    const tasksPath = ctx.config.paths.tasks_path;
+    if (!baseBranch) {
+        return {
+            ok: false,
+            errors: [usageError("Base branch could not be resolved (use `agentplane branch base set`).")],
+            warnings: [],
+        };
+    }
+    if (!currentBranch) {
+        return {
+            ok: false,
+            errors: [internalError("Internal error: current branch is required in branch_pr mode")],
+            warnings: [],
+        };
+    }
+    const allowBase = ctx.allow?.allowBase === true;
+    const tasksStaged = staged.includes(tasksPath);
+    const nonTasks = staged.filter((p) => p !== tasksPath);
+    if (tasksStaged && currentBranch !== baseBranch) {
+        return {
+            ok: false,
+            errors: [
+                gitError(`${tasksPath} commits are allowed only on ${baseBranch} in branch_pr mode`),
+            ],
+            warnings: [],
+        };
+    }
+    if (nonTasks.length > 0 && currentBranch === baseBranch && !allowBase) {
+        return {
+            ok: false,
+            errors: [gitError(`Code commits are forbidden on ${baseBranch} in branch_pr mode`)],
+            warnings: [],
+        };
+    }
+    return okResult();
+}

package/dist/policy/rules/clean-tree.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "../types.js";
+export declare function cleanTreeRule(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=clean-tree.d.ts.map

package/dist/policy/rules/clean-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-tree.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/clean-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAgB9D"}

package/dist/policy/rules/clean-tree.js

@@ -0,0 +1,19 @@
+import { gitError, internalError, okResult } from "../result.js";
+export function cleanTreeRule(ctx) {
+    if (ctx.requireClean !== true)
+        return okResult();
+    const unstaged = ctx.git.unstagedTrackedPaths ?? null;
+    if (!unstaged) {
+        return {
+            ok: false,
+            errors: [
+                internalError("Internal error: unstaged tracked paths are required for requireClean"),
+            ],
+            warnings: [],
+        };
+    }
+    if (unstaged.length > 0) {
+        return { ok: false, errors: [gitError("Working tree is dirty")], warnings: [] };
+    }
+    return okResult();
+}

package/dist/policy/rules/commit-subject.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "../types.js";
+export declare function commitSubjectRule(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=commit-subject.d.ts.map

package/dist/policy/rules/commit-subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-subject.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/commit-subject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAkClE"}

package/dist/policy/rules/commit-subject.js

@@ -0,0 +1,33 @@
+import { validateCommitSubject } from "@agentplaneorg/core";
+import { gitError, okResult } from "../result.js";
+export function commitSubjectRule(ctx) {
+    const subject = (ctx.commit?.subject ?? "").trim();
+    if (!subject) {
+        return { ok: false, errors: [gitError("Commit message subject is empty")], warnings: [] };
+    }
+    const taskId = (ctx.taskId ?? "").trim();
+    if (!taskId) {
+        return {
+            ok: false,
+            errors: [
+                gitError(ctx.action === "hook_commit_msg"
+                    ? "AGENTPLANE_TASK_ID is required (use `agentplane commit ...`)"
+                    : "Task id is required for commit subject validation"),
+            ],
+            warnings: [],
+        };
+    }
+    const policy = validateCommitSubject({
+        subject,
+        taskId,
+        genericTokens: ctx.config.commit.generic_tokens,
+    });
+    if (!policy.ok) {
+        return {
+            ok: false,
+            errors: policy.errors.map((msg) => gitError(msg)),
+            warnings: [],
+        };
+    }
+    return okResult();
+}

package/dist/policy/rules/protected-paths.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyResult } from "../types.js";
+export declare function protectedPathsRule(ctx: PolicyContext): PolicyResult;
+//# sourceMappingURL=protected-paths.d.ts.map

package/dist/policy/rules/protected-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-paths.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/protected-paths.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAgDnE"}