agentplane 0.1.9 → 0.2.1

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

package/dist/policy/rules/protected-paths.js

@@ -0,0 +1,53 @@
+import { getProtectedPathOverride, protectedPathKindForFile, } from "../../shared/protected-paths.js";
+import { gitError, okResult } from "../result.js";
+function renderProtectedMessage(opts) {
+    if (opts.action === "hook_pre_commit") {
+        return `${opts.filePath} is protected by agentplane hooks (set ${opts.overrideEnvVar}=1 to override)`;
+    }
+    return `Staged file is protected by default: ${opts.filePath} (use ${opts.overrideFlag} to override)`;
+}
+export function protectedPathsRule(ctx) {
+    const staged = ctx.git.stagedPaths ?? [];
+    if (staged.length === 0)
+        return okResult();
+    const tasksPath = ctx.config.paths.tasks_path;
+    const allowTasks = ctx.allow?.allowTasks === true;
+    const allowPolicy = ctx.allow?.allowPolicy === true;
+    const allowConfig = ctx.allow?.allowConfig === true;
+    const allowHooks = ctx.allow?.allowHooks === true;
+    const allowCI = ctx.allow?.allowCI === true;
+    const errors = [];
+    for (const filePath of staged) {
+        const kind = protectedPathKindForFile({ filePath, tasksPath });
+        if (!kind)
+            continue;
+        if (kind === "tasks" && !allowTasks) {
+            const override = getProtectedPathOverride(kind);
+            errors.push(ctx.action === "hook_pre_commit"
+                ? `${tasksPath} is protected by agentplane hooks (set ${override.envVar}=1 to override)`
+                : `Staged file is forbidden by default: ${filePath} (use ${override.cliFlag} to override)`);
+            continue;
+        }
+        if (kind === "policy" && allowPolicy)
+            continue;
+        if (kind === "config" && allowConfig)
+            continue;
+        if (kind === "hooks" && allowHooks)
+            continue;
+        if (kind === "ci" && allowCI)
+            continue;
+        if (kind !== "tasks") {
+            const override = getProtectedPathOverride(kind);
+            errors.push(renderProtectedMessage({
+                action: ctx.action,
+                filePath,
+                overrideFlag: override.cliFlag,
+                overrideEnvVar: override.envVar,
+            }));
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors: errors.map((msg) => gitError(msg)), warnings: [] };
+    }
+    return okResult();
+}

package/dist/policy/types.d.ts

@@ -0,0 +1,38 @@
+import type { AgentplaneConfig } from "@agentplaneorg/core";
+export type PolicyAction = "guard_commit" | "commit" | "hook_pre_commit" | "hook_commit_msg";
+export type PolicyProblemCode = "E_USAGE" | "E_GIT" | "E_INTERNAL";
+export type PolicyProblem = {
+    code: PolicyProblemCode;
+    exitCode: number;
+    message: string;
+};
+export type PolicyResult = {
+    ok: boolean;
+    errors: PolicyProblem[];
+    warnings: PolicyProblem[];
+};
+export type PolicyContext = {
+    action: PolicyAction;
+    config: AgentplaneConfig;
+    taskId: string;
+    git: {
+        stagedPaths: string[];
+        unstagedTrackedPaths?: string[];
+        currentBranch?: string;
+        baseBranch?: string | null;
+    };
+    commit?: {
+        subject?: string;
+    };
+    allow?: {
+        prefixes?: string[];
+        allowTasks?: boolean;
+        allowBase?: boolean;
+        allowPolicy?: boolean;
+        allowConfig?: boolean;
+        allowHooks?: boolean;
+        allowCI?: boolean;
+    };
+    requireClean?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/policy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,QAAQ,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE7F,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,YAAY,CAAC;IAErB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IAGf,GAAG,EAAE;QACH,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IAEF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC"}

package/dist/policy/types.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/write-if-changed.d.ts

@@ -0,0 +1,3 @@
+export declare function writeTextIfChanged(filePath: string, content: string): Promise<boolean>;
+export declare function writeJsonStableIfChanged(filePath: string, obj: unknown): Promise<boolean>;
+//# sourceMappingURL=write-if-changed.d.ts.map

package/dist/shared/write-if-changed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-if-changed.d.ts","sourceRoot":"","sources":["../../src/shared/write-if-changed.ts"],"names":[],"mappings":"AAcA,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK5F;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/F"}

package/dist/shared/write-if-changed.js

@@ -0,0 +1,25 @@
+import { readFile } from "node:fs/promises";
+import { atomicWriteFile, canonicalizeJson } from "@agentplaneorg/core";
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function writeTextIfChanged(filePath, content) {
+    const existing = await readTextIfExists(filePath);
+    if (existing !== null && existing === content)
+        return false;
+    await atomicWriteFile(filePath, content, "utf8");
+    return true;
+}
+export async function writeJsonStableIfChanged(filePath, obj) {
+    const stable = canonicalizeJson(obj);
+    const text = `${JSON.stringify(stable, null, 2)}\n`;
+    return await writeTextIfChanged(filePath, text);
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "agentplane",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
-    "agent-plane",
+    "agentplane-framework",
     "cli",
     "tasks",
     "workflow",
@@ -54,7 +54,7 @@
     "prepublishOnly": "npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.1.9",
+    "@agentplaneorg/core": "0.2.1",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {

package/dist/cli/help.d.ts

@@ -1,2 +0,0 @@
-export declare function renderHelp(): string;
-//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,MAAM,CA8HnC"}

package/dist/cli/help.js

@@ -1,127 +0,0 @@
-export function renderHelp() {
-    return [
-        "agentplane (v1 prototype)",
-        "",
-        "Usage:",
-        "  agentplane [--root <path>] [--json] [--no-update-check] <namespace> <command> [options]",
-        "  agentplane [--root <path>] [--json] [--no-update-check] <command> [options]",
-        "",
-        "Core namespaces (implemented in this prototype): config, mode, task, ide, recipes, backend",
-        "",
-        "Flags:",
-        "  --help, -h           Show help",
-        "  --version            Show version",
-        "  --root <path>        Treat <path> as project root",
-        "  --no-update-check    Skip checking npm for a newer CLI version",
-        "",
-        "Quickstart commands:",
-        "  agentplane quickstart",
-        "",
-        "Init commands:",
-        "  agentplane init [--ide <codex|cursor|windsurf>] [--workflow <direct|branch_pr>] [--hooks <yes|no>] [--require-plan-approval <yes|no>] [--require-network-approval <yes|no>] [--require-verify-approval <yes|no>] [--recipes <list>] [--yes] [--force|--backup]",
-        "",
-        "Upgrade commands:",
-        "  agentplane upgrade [--tag <tag>] [--dry-run] [--no-backup] [--source <repo-url>] [--bundle <path|url>] [--checksum <path|url>] [--yes]",
-        "",
-        "Config commands:",
-        "  agentplane config show",
-        "  agentplane config set <key> <value>",
-        "",
-        "Mode commands:",
-        "  agentplane mode get",
-        "  agentplane mode set <direct|branch_pr>",
-        "",
-        "IDE commands:",
-        "  agentplane ide sync",
-        "",
-        "Recipe commands:",
-        "  agentplane recipes list [--full] [--tag <tag>]",
-        "  agentplane recipes list-remote [--refresh] [--index <path|url>] [--yes]",
-        "  agentplane recipes info <id>",
-        "  agentplane recipes explain <id>",
-        "  agentplane recipes install --name <id> [--index <path|url>] [--refresh] [--yes]",
-        "  agentplane recipes install --path <path> | --url <url> [--yes]",
-        "  agentplane recipes remove <id>",
-        "  agentplane recipes cache prune [--dry-run] [--all]",
-        "  agentplane scenario list",
-        "  agentplane scenario info <recipe:scenario>",
-        "  agentplane scenario run <recipe:scenario>",
-        "",
-        "Backend commands:",
-        "  agentplane backend sync <id> --direction <push|pull> [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]",
-        "  agentplane sync [<id>] [--direction <push|pull>] [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]",
-        "",
-        "Branch commands:",
-        "  agentplane branch base get",
-        "  agentplane branch base set <name>",
-        "  agentplane branch status [--branch <name>] [--base <name>]",
-        "  agentplane branch remove [--branch <name>] [--worktree <path>] [--force] [--quiet]",
-        "",
-        "Work commands:",
-        "  agentplane work start <task-id> --agent <id> --slug <slug> --worktree",
-        "",
-        "PR commands:",
-        "  agentplane pr open <task-id> --author <id> [--branch <name>]",
-        "  agentplane pr update <task-id>",
-        "  agentplane pr check <task-id>",
-        "  agentplane pr note <task-id> --author <id> --body <text>",
-        "",
-        "Integrate commands:",
-        "  agentplane integrate <task-id> [--branch <name>] [--base <name>] [--merge-strategy squash|merge|rebase] [--run-verify] [--dry-run] [--quiet]",
-        "",
-        "Cleanup commands:",
-        "  agentplane cleanup merged [--base <name>] [--yes] [--archive] [--quiet]",
-        "",
-        "Guard commands:",
-        "  agentplane guard clean [--quiet]",
-        "  agentplane guard suggest-allow [--format lines|args]",
-        "  agentplane guard commit <task-id> -m <message> --allow <path> [--allow <path>...] [--auto-allow] [--allow-tasks] [--require-clean] [--quiet]",
-        "",
-        "Commit commands:",
-        "  agentplane commit <task-id> -m <message> --allow <path> [--allow <path>...]",
-        "  agentplane commit <task-id> -m <message> --auto-allow",
-        "",
-        "Hooks commands:",
-        "  agentplane hooks install [--quiet]",
-        "  agentplane hooks uninstall [--quiet]",
-        "",
-        "Support commands:",
-        "  agentplane ready <task-id>",
-        "  agentplane role <role>",
-        "  agentplane agents",
-        "",
-        "Task commands:",
-        "  agentplane task list",
-        "  agentplane task next",
-        "  agentplane task search <query>",
-        "  agentplane task show <task-id>",
-        "  agentplane task new --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]",
-        "  agentplane task add <task-id> [<task-id>...] --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]",
-        "  agentplane task update <task-id> [--title <text>] [--description <text>] [--priority <low|normal|med|high>] [--owner <id>]",
-        "  agentplane task scrub --find <text> [--replace <text>] [--dry-run]",
-        "  agentplane task scaffold <task-id> [--title <text>] [--overwrite] [--force]",
-        "  agentplane task doc set <task-id> --section <name> (--text <text> | --file <path>)",
-        "  agentplane task doc show <task-id> [--section <name>]",
-        "  agentplane task comment <task-id> --author <id> --body <text>",
-        "  agentplane task set-status <task-id> <status>",
-        "  agentplane task export",
-        "  agentplane task lint",
-        "  agentplane task normalize",
-        "  agentplane task migrate [--source <path>]",
-        "  agentplane task migrate-doc [<task-id> ...] [--all] [--quiet]",
-        "",
-        "Start commands:",
-        "  agentplane start <task-id> --author <id> --body <text> [--commit-from-comment] [--force]",
-        "",
-        "Block commands:",
-        "  agentplane block <task-id> --author <id> --body <text> [--commit-from-comment] [--force]",
-        "",
-        "Verify commands:",
-        "  agentplane verify <task-id> (--ok | --rework) --by <id> --note <text> [--details <text> | --file <path>] [--quiet]",
-        "  agentplane task verify <ok|rework> <task-id> --by <id> --note <text> [--details <text> | --file <path>]",
-        "",
-        "Finish commands:",
-        "  agentplane finish <task-id> [<task-id>...] --author <id> --body <text> [--commit-from-comment] [--status-commit]",
-        "",
-    ].join("\n");
-}

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

@@ -1,2 +0,0 @@
-export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify-record.js";
-//# sourceMappingURL=verify.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/commands/task/verify.js

@@ -1 +0,0 @@
-export { VERIFY_USAGE, VERIFY_USAGE_EXAMPLE, cmdVerify } from "./verify-record.js";