agentplane 0.2.5 → 0.2.12

package/dist/cli/command-guide.js

@@ -69,7 +69,7 @@ const ROLE_GUIDES = [
         role: "ORCHESTRATOR",
         lines: [
             "- Plan intake: `agentplane task list` / `agentplane task show <task-id>`",
-            '- After plan approval (unless the user opts out): `agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --depends-on "[]" --tag <tag>`',
+            '- After plan approval (unless the user opts out): create exactly one tracking task: `agentplane task new --title "..." --description "..." --priority med --owner ORCHESTRATOR --depends-on "[]" --tag <tag>`',
             "- Optional scaffold: `agentplane task scaffold <task-id>`",
             "- Two-stage verification: `## Verify Steps` is the ex-ante contract; `agentplane verify ...` appends an ex-post entry into `## Verification`.",
         ],
@@ -187,9 +187,11 @@ export function renderQuickstart() {
     return [
         "# agentplane quickstart",
         "",
-        "agentplane CLI is the source of truth for task, PR, verify, and commit commands.",
+        "AGENTS.md is the source of truth for the workflow/process policy; quickstart and role output are the source of truth for CLI syntax and artifacts.",
         "Do not edit `.agentplane/tasks.json` by hand.",
         "",
+        "- See AGENTS.md for the canonical workflow policy and approval gates.",
+        "",
         "## Project setup",
         "",
         "- `agentplane init` (bootstrap `.agentplane/`)",

package/dist/cli/critical/cli-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/cli/critical/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../../../src/cli/critical/cli-runner.ts"],"names":[],"mappings":""}

package/dist/cli/critical/cli-runner.js

@@ -0,0 +1,11 @@
+import { runCli } from "../run-cli.js";
+async function main() {
+    const argv = process.argv.slice(2);
+    const code = await runCli(argv);
+    process.exitCode = code;
+}
+main().catch((err) => {
+    // Last-resort fallback. The contract for tests is "exit non-zero and surface the error".
+    console.error(err);
+    process.exitCode = 1;
+});

package/dist/cli/critical/harness.d.ts

@@ -0,0 +1,22 @@
+export type RunCliResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export declare function makeTempDir(prefix?: string): Promise<string>;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function writeText(filePath: string, content: string): Promise<void>;
+export declare function readText(filePath: string): Promise<string>;
+export declare function real(p: string): Promise<string>;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function listDirRecursive(root: string): Promise<string[]>;
+export declare function gitInit(repoRoot: string, branch?: string): Promise<void>;
+export declare function gitCommitAll(repoRoot: string, message: string): Promise<void>;
+export declare function gitHead(repoRoot: string): Promise<string>;
+export declare function runCli(args: string[], opts: {
+    cwd: string;
+    extraEnv?: Record<string, string>;
+}): Promise<RunCliResult>;
+export declare function expectCliError(result: RunCliResult, code: number, errCode: string): void;
+export declare function cleanGitEnv(): NodeJS.ProcessEnv;
+//# sourceMappingURL=harness.d.ts.map

package/dist/cli/critical/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/cli/critical/harness.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAgBF,wBAAsB,WAAW,CAAC,MAAM,SAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErD;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAatE;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9E;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/D;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvD,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAexF;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAqB/C"}

package/dist/cli/critical/harness.js

@@ -0,0 +1,164 @@
+import { execFile } from "node:child_process";
+import { mkdir, mkdtemp, readFile, readdir, realpath, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+function renderExecField(v) {
+    if (v == null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (Buffer.isBuffer(v))
+        return v.toString("utf8");
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+export async function makeTempDir(prefix = "agentplane-critical-") {
+    return await mkdtemp(path.join(os.tmpdir(), prefix));
+}
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+export async function writeText(filePath, content) {
+    await ensureDir(path.dirname(filePath));
+    await writeFile(filePath, content, "utf8");
+}
+export async function readText(filePath) {
+    return await readFile(filePath, "utf8");
+}
+export async function real(p) {
+    return await realpath(p);
+}
+export async function pathExists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function listDirRecursive(root) {
+    const out = [];
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const abs = path.join(dir, entry.name);
+            const rel = path.relative(root, abs);
+            out.push(rel);
+            if (entry.isDirectory())
+                await walk(abs);
+        }
+    }
+    if (await pathExists(root))
+        await walk(root);
+    return out.toSorted((a, b) => a.localeCompare(b));
+}
+export async function gitInit(repoRoot, branch = "main") {
+    await ensureDir(repoRoot);
+    // Use real git, but avoid reading developer global/system configs.
+    await execFileAsync("git", ["init", "-q", "-b", branch], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    }).catch(async () => {
+        // Older git: init without -b, then create branch.
+        await execFileAsync("git", ["init", "-q"], { cwd: repoRoot, env: cleanGitEnv() });
+        await execFileAsync("git", ["checkout", "-q", "-b", branch], {
+            cwd: repoRoot,
+            env: cleanGitEnv(),
+        });
+    });
+    // Repo-local identity to avoid relying on global git config.
+    await execFileAsync("git", ["config", "user.email", "agentplane-test@example.com"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+    await execFileAsync("git", ["config", "user.name", "Agentplane Test"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+}
+export async function gitCommitAll(repoRoot, message) {
+    await execFileAsync("git", ["add", "-A"], { cwd: repoRoot, env: cleanGitEnv() });
+    await execFileAsync("git", ["commit", "-m", message], { cwd: repoRoot, env: cleanGitEnv() });
+}
+export async function gitHead(repoRoot) {
+    const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+    return String(stdout).trim();
+}
+export async function runCli(args, opts) {
+    // Run as a separate process using bun to execute the TS runner.
+    const runnerPath = path.join(process.cwd(), "packages", "agentplane", "src", "cli", "critical", "cli-runner.ts");
+    const isolatedHome = await makeTempDir("agentplane-critical-home-");
+    const isolatedAgentplaneHome = await makeTempDir("agentplane-critical-ap-home-");
+    const env = {
+        ...process.env,
+        ...cleanGitEnv(),
+        HOME: isolatedHome,
+        XDG_CONFIG_HOME: path.join(isolatedHome, ".config"),
+        AGENTPLANE_HOME: isolatedAgentplaneHome,
+        AGENTPLANE_NO_UPDATE_CHECK: "1",
+        ...opts.extraEnv,
+    };
+    // execFileAsync throws on non-zero exit. Normalize into a stable `{code,stdout,stderr}` shape.
+    let code = 0;
+    let stdout = "";
+    let stderr = "";
+    try {
+        const ok = (await execFileAsync("bun", [runnerPath, ...args], {
+            cwd: opts.cwd,
+            env,
+            encoding: "utf8",
+            maxBuffer: 10 * 1024 * 1024,
+        }));
+        stdout = String(ok.stdout ?? "");
+        stderr = String(ok.stderr ?? "");
+    }
+    catch (err) {
+        const e = err;
+        stdout = renderExecField(e.stdout);
+        stderr = renderExecField(e.stderr);
+        code = typeof e.code === "number" ? e.code : 1;
+    }
+    return { code, stdout, stderr };
+}
+export function expectCliError(result, code, errCode) {
+    if (result.code !== code) {
+        throw new Error(`Expected exit code ${code} but got ${result.code}\n` +
+            `stdout:\n${result.stdout}\n` +
+            `stderr:\n${result.stderr}\n`);
+    }
+    if (!result.stderr.includes(`error [${errCode}]`)) {
+        throw new Error(`Expected stderr to include error [${errCode}]\n` +
+            `stdout:\n${result.stdout}\n` +
+            `stderr:\n${result.stderr}\n`);
+    }
+}
+export function cleanGitEnv() {
+    const env = { ...process.env };
+    // Prevent git from inheriting caller-specific repository bindings.
+    delete env.GIT_DIR;
+    delete env.GIT_WORK_TREE;
+    delete env.GIT_COMMON_DIR;
+    delete env.GIT_INDEX_FILE;
+    delete env.GIT_OBJECT_DIRECTORY;
+    delete env.GIT_ALTERNATE_OBJECT_DIRECTORIES;
+    // Disable global/system configs to avoid developer machine drift.
+    env.GIT_CONFIG_GLOBAL = "/dev/null";
+    env.GIT_CONFIG_SYSTEM = "/dev/null";
+    env.GIT_TERMINAL_PROMPT = "0";
+    // Provide identity for commits when commands rely on it.
+    env.GIT_AUTHOR_NAME = env.GIT_AUTHOR_NAME ?? "Agentplane Test";
+    env.GIT_AUTHOR_EMAIL = env.GIT_AUTHOR_EMAIL ?? "agentplane-test@example.com";
+    env.GIT_COMMITTER_NAME = env.GIT_COMMITTER_NAME ?? "Agentplane Test";
+    env.GIT_COMMITTER_EMAIL = env.GIT_COMMITTER_EMAIL ?? "agentplane-test@example.com";
+    return env;
+}

package/dist/cli/run-cli/command-catalog.d.ts

@@ -1,8 +1,11 @@
 import type { CommandHandler, CommandSpec } from "../spec/spec.js";
 import type { HelpJson } from "../spec/help-render.js";
 import type { CommandContext } from "../../commands/shared/task-backend.js";
+import type { LoadedConfig, ResolvedProject } from "@agentplaneorg/core";
 export type RunDeps = {
     getCtx: (commandForErrorContext: string) => Promise<CommandContext>;
+    getResolvedProject: (commandForErrorContext: string) => Promise<ResolvedProject>;
+    getLoadedConfig: (commandForErrorContext: string) => Promise<LoadedConfig>;
     getHelpJsonForDocs: () => readonly HelpJson[];
 };
 export type CommandEntry = {
@@ -12,5 +15,5 @@ export type CommandEntry = {
     needsConfig: boolean;
     needsTaskContext: boolean;
 };
-export declare const COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
+export declare const COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
 //# sourceMappingURL=command-catalog.d.ts.map

package/dist/cli/run-cli/command-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA8FvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,+rCA0VuB,CAAC"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,yuCAuYuB,CAAC"}

package/dist/cli/run-cli/command-catalog.js

@@ -3,10 +3,10 @@ import { agentsSpec, quickstartSpec, roleSpec } from "./commands/core.js";
 import { configSetSpec, configShowSpec, modeGetSpec, modeSetSpec } from "./commands/config.js";
 import { ideSyncSpec } from "./commands/ide.js";
 import { taskNewSpec } from "../../commands/task/new.spec.js";
-import { taskListSpec } from "../../commands/task/list.command.js";
-import { taskNextSpec } from "../../commands/task/next.command.js";
-import { taskSearchSpec } from "../../commands/task/search.command.js";
-import { taskShowSpec } from "../../commands/task/show.command.js";
+import { taskListSpec } from "../../commands/task/list.spec.js";
+import { taskNextSpec } from "../../commands/task/next.spec.js";
+import { taskSearchSpec } from "../../commands/task/search.spec.js";
+import { taskShowSpec } from "../../commands/task/show.spec.js";
 import { taskAddSpec } from "../../commands/task/add.command.js";
 import { taskUpdateSpec } from "../../commands/task/update.command.js";
 import { taskCommentSpec } from "../../commands/task/comment.command.js";
@@ -53,10 +53,10 @@ import { scenarioSpec } from "../../commands/scenario/scenario.command.js";
 import { prCheckSpec, prNoteSpec, prOpenSpec, prSpec, prUpdateSpec, } from "../../commands/pr/pr.command.js";
 import { integrateSpec } from "../../commands/integrate.command.js";
 import { commitSpec } from "../../commands/commit.spec.js";
-import { startSpec } from "../../commands/start.command.js";
-import { blockSpec } from "../../commands/block.command.js";
-import { verifySpec } from "../../commands/verify.command.js";
-import { finishSpec } from "../../commands/finish.command.js";
+import { startSpec } from "../../commands/start.spec.js";
+import { blockSpec } from "../../commands/block.spec.js";
+import { verifySpec } from "../../commands/verify.spec.js";
+import { finishSpec } from "../../commands/finish.spec.js";
 import { readySpec } from "../../commands/ready.command.js";
 import { doctorSpec } from "../../commands/doctor.command.js";
 import { docsCliSpec } from "../../commands/docs/cli.command.js";
@@ -69,6 +69,9 @@ import { guardSpec } from "../../commands/guard/guard.command.js";
 import { guardCleanSpec } from "../../commands/guard/clean.command.js";
 import { guardSuggestAllowSpec } from "../../commands/guard/suggest-allow.command.js";
 import { guardCommitSpec } from "../../commands/guard/commit.command.js";
+import { releaseSpec } from "../../commands/release/release.command.js";
+import { releasePlanSpec } from "../../commands/release/plan.command.js";
+import { releaseApplySpec } from "../../commands/release/apply.command.js";
 function entry(spec, load, meta) {
     return {
         spec: spec,
@@ -89,6 +92,21 @@ export const COMMANDS = [
         needsConfig: false,
         needsTaskContext: false,
     }),
+    entry(releaseSpec, () => import("../../commands/release/release.command.js").then((m) => m.runRelease), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(releasePlanSpec, () => import("../../commands/release/plan.command.js").then((m) => m.runReleasePlan), {
+        needsProject: true,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(releaseApplySpec, () => import("../../commands/release/apply.command.js").then((m) => m.runReleaseApply), {
+        needsProject: true,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(quickstartSpec, () => import("./commands/core.js").then((m) => m.runQuickstart), {
         needsProject: false,
         needsConfig: false,
@@ -99,32 +117,32 @@ export const COMMANDS = [
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(agentsSpec, () => import("./commands/core.js").then((m) => m.runAgents), {
+    entry(agentsSpec, (deps) => import("./commands/core.js").then((m) => m.makeRunAgentsHandler(deps)), {
         needsProject: true,
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(configShowSpec, () => import("./commands/config.js").then((m) => m.runConfigShow), {
+    entry(configShowSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunConfigShowHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(configSetSpec, () => import("./commands/config.js").then((m) => m.runConfigSet), {
+    entry(configSetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunConfigSetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(modeGetSpec, () => import("./commands/config.js").then((m) => m.runModeGet), {
+    entry(modeGetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunModeGetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(modeSetSpec, () => import("./commands/config.js").then((m) => m.runModeSet), {
+    entry(modeSetSpec, (deps) => import("./commands/config.js").then((m) => m.makeRunModeSetHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
     }),
-    entry(ideSyncSpec, () => import("./commands/ide.js").then((m) => m.runIdeSync), {
+    entry(ideSyncSpec, (deps) => import("./commands/ide.js").then((m) => m.makeRunIdeSyncHandler(deps)), {
         needsProject: true,
         needsConfig: true,
         needsTaskContext: false,
@@ -134,10 +152,10 @@ export const COMMANDS = [
         needsConfig: false,
         needsTaskContext: false,
     }),
-    entry(taskListSpec, (deps) => import("../../commands/task/list.command.js").then((m) => m.makeRunTaskListHandler(deps.getCtx))),
-    entry(taskNextSpec, (deps) => import("../../commands/task/next.command.js").then((m) => m.makeRunTaskNextHandler(deps.getCtx))),
-    entry(taskSearchSpec, (deps) => import("../../commands/task/search.command.js").then((m) => m.makeRunTaskSearchHandler(deps.getCtx))),
-    entry(taskShowSpec, (deps) => import("../../commands/task/show.command.js").then((m) => m.makeRunTaskShowHandler(deps.getCtx))),
+    entry(taskListSpec, (deps) => import("../../commands/task/list.run.js").then((m) => m.makeRunTaskListHandler(deps.getCtx))),
+    entry(taskNextSpec, (deps) => import("../../commands/task/next.run.js").then((m) => m.makeRunTaskNextHandler(deps.getCtx))),
+    entry(taskSearchSpec, (deps) => import("../../commands/task/search.run.js").then((m) => m.makeRunTaskSearchHandler(deps.getCtx))),
+    entry(taskShowSpec, (deps) => import("../../commands/task/show.run.js").then((m) => m.makeRunTaskShowHandler(deps.getCtx))),
     entry(taskNewSpec, (deps) => import("../../commands/task/new.command.js").then((m) => m.makeRunTaskNewHandler(deps.getCtx))),
     entry(taskDeriveSpec, (deps) => import("../../commands/task/derive.command.js").then((m) => m.makeRunTaskDeriveHandler(deps.getCtx))),
     entry(taskAddSpec, (deps) => import("../../commands/task/add.command.js").then((m) => m.makeRunTaskAddHandler(deps.getCtx))),
@@ -193,10 +211,10 @@ export const COMMANDS = [
     entry(prNoteSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrNoteHandler(deps.getCtx))),
     entry(integrateSpec, (deps) => import("../../commands/integrate.command.js").then((m) => m.makeRunIntegrateHandler(deps.getCtx))),
     entry(commitSpec, (deps) => import("../../commands/commit.command.js").then((m) => m.makeRunCommitHandler(deps.getCtx))),
-    entry(startSpec, (deps) => import("../../commands/start.command.js").then((m) => m.makeRunStartHandler(deps.getCtx))),
-    entry(blockSpec, (deps) => import("../../commands/block.command.js").then((m) => m.makeRunBlockHandler(deps.getCtx))),
-    entry(verifySpec, (deps) => import("../../commands/verify.command.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
-    entry(finishSpec, (deps) => import("../../commands/finish.command.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
+    entry(startSpec, (deps) => import("../../commands/start.run.js").then((m) => m.makeRunStartHandler(deps.getCtx))),
+    entry(blockSpec, (deps) => import("../../commands/block.run.js").then((m) => m.makeRunBlockHandler(deps.getCtx))),
+    entry(verifySpec, (deps) => import("../../commands/verify.run.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
+    entry(finishSpec, (deps) => import("../../commands/finish.run.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
     entry(readySpec, (deps) => import("../../commands/ready.command.js").then((m) => m.makeRunReadyHandler(deps.getCtx))),
     entry(docsCliSpec, (deps) => import("../../commands/docs/cli.command.js").then((m) => m.makeRunDocsCliHandler(deps.getHelpJsonForDocs))),
     entry(hooksSpec, () => import("../../commands/hooks/hooks.command.js").then((m) => m.runHooks)),

package/dist/cli/run-cli/commands/config.d.ts

@@ -1,20 +1,21 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import type { RunDeps } from "../command-catalog.js";
 type ConfigShowParsed = Record<string, never>;
 export declare const configShowSpec: CommandSpec<ConfigShowParsed>;
-export declare const runConfigShow: CommandHandler<ConfigShowParsed>;
+export declare function makeRunConfigShowHandler(deps: RunDeps): CommandHandler<ConfigShowParsed>;
 type ConfigSetParsed = {
     key: string;
     value: string;
 };
 export declare const configSetSpec: CommandSpec<ConfigSetParsed>;
-export declare const runConfigSet: CommandHandler<ConfigSetParsed>;
+export declare function makeRunConfigSetHandler(deps: RunDeps): CommandHandler<ConfigSetParsed>;
 type ModeGetParsed = Record<string, never>;
 export declare const modeGetSpec: CommandSpec<ModeGetParsed>;
-export declare const runModeGet: CommandHandler<ModeGetParsed>;
+export declare function makeRunModeGetHandler(deps: RunDeps): CommandHandler<ModeGetParsed>;
 type ModeSetParsed = {
     mode: string;
 };
 export declare const modeSetSpec: CommandSpec<ModeSetParsed>;
-export declare const runModeSet: CommandHandler<ModeSetParsed>;
+export declare function makeRunModeSetHandler(deps: RunDeps): CommandHandler<ModeSetParsed>;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/cli/run-cli/commands/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAgBF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CACM,CAAC;AAElE,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgBtD,CAAC;AA8BF,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,eAAe,CACmC,CAAC;AAE7F,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAMlD,CAAC;AAgBF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACS,CAAC;AAE/D,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAgBlD,CAAC;AA2BF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CAKjD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAMxD,CAAC;AAiBF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAExF;AAED,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgBtD,CAAC;AA6BF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,CAStF;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAMlD,CAAC;AAiBF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAElF;AAED,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAgBlD,CAAC;AA0BF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAQlF"}

package/dist/cli/run-cli/commands/config.js

@@ -1,7 +1,8 @@
 import path from "node:path";
-import { loadConfig, resolveProject, saveConfig, setByDottedKey } from "@agentplaneorg/core";
+import { saveConfig, setByDottedKey } from "@agentplaneorg/core";
 import { mapCoreError } from "../../error-map.js";
 import { usageError } from "../../spec/errors.js";
+import { CliError } from "../../../shared/errors.js";
 export const configShowSpec = {
     id: ["config", "show"],
     group: "Config",
@@ -11,19 +12,19 @@ export const configShowSpec = {
 };
 async function cmdConfigShow(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const loaded = await opts.deps.getLoadedConfig("config show");
         process.stdout.write(`${JSON.stringify(loaded.raw, null, 2)}\n`);
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, { command: "config show", root: opts.rootOverride ?? null });
     }
 }
-export const runConfigShow = (ctx) => cmdConfigShow({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export function makeRunConfigShowHandler(deps) {
+    return (ctx) => cmdConfigShow({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, deps });
+}
 export const configSetSpec = {
     id: ["config", "set"],
     group: "Config",
@@ -43,11 +44,8 @@ export const configSetSpec = {
 };
 async function cmdConfigSet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const resolved = await opts.deps.getResolvedProject("config set");
+        const loaded = await opts.deps.getLoadedConfig("config set");
         const raw = { ...loaded.raw };
         setByDottedKey(raw, opts.key, opts.value);
         await saveConfig(resolved.agentplaneDir, raw);
@@ -55,6 +53,8 @@ async function cmdConfigSet(opts) {
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, {
             command: "config set",
             key: opts.key,
@@ -62,7 +62,15 @@ async function cmdConfigSet(opts) {
         });
     }
 }
-export const runConfigSet = (ctx, p) => cmdConfigSet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, key: p.key, value: p.value });
+export function makeRunConfigSetHandler(deps) {
+    return (ctx, p) => cmdConfigSet({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        key: p.key,
+        value: p.value,
+        deps,
+    });
+}
 export const modeGetSpec = {
     id: ["mode", "get"],
     group: "Config",
@@ -72,19 +80,19 @@ export const modeGetSpec = {
 };
 async function cmdModeGet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const loaded = await opts.deps.getLoadedConfig("mode get");
         process.stdout.write(`${loaded.config.workflow_mode}\n`);
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, { command: "mode get", root: opts.rootOverride ?? null });
     }
 }
-export const runModeGet = (ctx) => cmdModeGet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export function makeRunModeGetHandler(deps) {
+    return (ctx) => cmdModeGet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, deps });
+}
 export const modeSetSpec = {
     id: ["mode", "set"],
     group: "Config",
@@ -104,11 +112,8 @@ export const modeSetSpec = {
 };
 async function cmdModeSet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const resolved = await opts.deps.getResolvedProject("mode set");
+        const loaded = await opts.deps.getLoadedConfig("mode set");
         const raw = { ...loaded.raw };
         setByDottedKey(raw, "workflow_mode", opts.mode);
         await saveConfig(resolved.agentplaneDir, raw);
@@ -116,6 +121,8 @@ async function cmdModeSet(opts) {
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, {
             command: "mode set",
             root: opts.rootOverride ?? null,
@@ -123,8 +130,11 @@ async function cmdModeSet(opts) {
         });
     }
 }
-export const runModeSet = (ctx, p) => cmdModeSet({
-    cwd: ctx.cwd,
-    rootOverride: ctx.rootOverride,
-    mode: p.mode,
-});
+export function makeRunModeSetHandler(deps) {
+    return (ctx, p) => cmdModeSet({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        mode: p.mode,
+        deps,
+    });
+}

package/dist/cli/run-cli/commands/core.d.ts

@@ -1,4 +1,5 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import type { RunDeps } from "../command-catalog.js";
 type QuickstartParsed = Record<string, never>;
 export declare const quickstartSpec: CommandSpec<QuickstartParsed>;
 export declare const runQuickstart: CommandHandler<QuickstartParsed>;
@@ -9,6 +10,6 @@ export declare const roleSpec: CommandSpec<RoleParsed>;
 export declare const runRole: CommandHandler<RoleParsed>;
 type AgentsParsed = Record<string, never>;
 export declare const agentsSpec: CommandSpec<AgentsParsed>;
-export declare const runAgents: CommandHandler<AgentsParsed>;
+export declare function makeRunAgentsHandler(deps: RunDeps): CommandHandler<AgentsParsed>;
 export {};
 //# sourceMappingURL=core.d.ts.map

package/dist/cli/run-cli/commands/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAOxD,CAAC;AAYF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAG1D,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAO5C,CAAC;AA8BF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAG9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAkEF,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CACU,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAOxD,CAAC;AAYF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAG1D,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAO5C,CAAC;AAgLF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAE9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CA+DhF"}