agentplane 0.1.9 → 0.2.1

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

@@ -0,0 +1,204 @@
+import { initSpec } from "./commands/init.js";
+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 { taskAddSpec } from "../../commands/task/add.command.js";
+import { taskUpdateSpec } from "../../commands/task/update.command.js";
+import { taskCommentSpec } from "../../commands/task/comment.command.js";
+import { taskSetStatusSpec } from "../../commands/task/set-status.command.js";
+import { taskDocSpec } from "../../commands/task/doc.command.js";
+import { taskDocShowSpec } from "../../commands/task/doc-show.command.js";
+import { taskDocSetSpec } from "../../commands/task/doc-set.command.js";
+import { taskScrubSpec } from "../../commands/task/scrub.command.js";
+import { taskScaffoldSpec } from "../../commands/task/scaffold.command.js";
+import { taskNormalizeSpec } from "../../commands/task/normalize.command.js";
+import { taskExportSpec } from "../../commands/task/export.command.js";
+import { taskLintSpec } from "../../commands/task/lint.command.js";
+import { taskMigrateSpec } from "../../commands/task/migrate.command.js";
+import { taskMigrateDocSpec } from "../../commands/task/migrate-doc.command.js";
+import { taskDeriveSpec } from "../../commands/task/derive.command.js";
+import { taskPlanSetSpec } from "../../commands/task/plan-set.command.js";
+import { taskPlanApproveSpec } from "../../commands/task/plan-approve.command.js";
+import { taskPlanRejectSpec } from "../../commands/task/plan-reject.command.js";
+import { taskVerifySpec } from "../../commands/task/verify.command.js";
+import { taskVerifyOkSpec } from "../../commands/task/verify-ok.command.js";
+import { taskVerifyReworkSpec } from "../../commands/task/verify-rework.command.js";
+import { taskVerifyShowSpec } from "../../commands/task/verify-show.command.js";
+import { workStartSpec } from "../../commands/branch/work-start.command.js";
+import { branchBaseClearSpec, branchBaseExplainSpec, branchBaseGetSpec, branchBaseSetSpec, branchBaseSpec, } from "../../commands/branch/base.command.js";
+import { branchStatusSpec } from "../../commands/branch/status.command.js";
+import { branchRemoveSpec } from "../../commands/branch/remove.command.js";
+import { recipesInstallSpec } from "../../commands/recipes/install.command.js";
+import { recipesListSpec } from "../../commands/recipes/list.command.js";
+import { recipesListRemoteSpec } from "../../commands/recipes/list-remote.command.js";
+import { recipesInfoSpec } from "../../commands/recipes/info.command.js";
+import { recipesExplainSpec } from "../../commands/recipes/explain.command.js";
+import { recipesRemoveSpec } from "../../commands/recipes/remove.command.js";
+import { recipesCachePruneSpec } from "../../commands/recipes/cache-prune.command.js";
+import { recipesSpec } from "../../commands/recipes/recipes.command.js";
+import { recipesCacheSpec } from "../../commands/recipes/cache.command.js";
+import { upgradeSpec } from "../../commands/upgrade.command.js";
+import { backendSpec, backendSyncSpec } from "../../commands/backend/sync.command.js";
+import { syncSpec } from "../../commands/sync.command.js";
+import { scenarioListSpec } from "../../commands/scenario/list.command.js";
+import { scenarioInfoSpec } from "../../commands/scenario/info.command.js";
+import { scenarioRunSpec } from "../../commands/scenario/run.command.js";
+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 { readySpec } from "../../commands/ready.command.js";
+import { docsCliSpec } from "../../commands/docs/cli.command.js";
+import { hooksSpec } from "../../commands/hooks/hooks.command.js";
+import { hooksInstallSpec } from "../../commands/hooks/install.command.js";
+import { hooksUninstallSpec } from "../../commands/hooks/uninstall.command.js";
+import { hooksRunSpec } from "../../commands/hooks/run.command.js";
+import { cleanupMergedSpec, cleanupSpec } from "../../commands/cleanup/merged.command.js";
+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";
+function entry(spec, load, meta) {
+    return {
+        spec: spec,
+        load: (deps) => load(deps),
+        needsProject: meta?.needsProject ?? true,
+        needsConfig: meta?.needsConfig ?? meta?.needsProject ?? true,
+        needsTaskContext: meta?.needsTaskContext ?? true,
+    };
+}
+export const COMMANDS = [
+    entry(initSpec, () => import("./commands/init.js").then((m) => m.runInit), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(upgradeSpec, () => import("../../commands/upgrade.command.js").then((m) => m.runUpgrade), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(quickstartSpec, () => import("./commands/core.js").then((m) => m.runQuickstart), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(roleSpec, () => import("./commands/core.js").then((m) => m.runRole), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(agentsSpec, () => import("./commands/core.js").then((m) => m.runAgents), {
+        needsProject: true,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(configShowSpec, () => import("./commands/config.js").then((m) => m.runConfigShow), {
+        needsProject: true,
+        needsConfig: true,
+        needsTaskContext: false,
+    }),
+    entry(configSetSpec, () => import("./commands/config.js").then((m) => m.runConfigSet), {
+        needsProject: true,
+        needsConfig: true,
+        needsTaskContext: false,
+    }),
+    entry(modeGetSpec, () => import("./commands/config.js").then((m) => m.runModeGet), {
+        needsProject: true,
+        needsConfig: true,
+        needsTaskContext: false,
+    }),
+    entry(modeSetSpec, () => import("./commands/config.js").then((m) => m.runModeSet), {
+        needsProject: true,
+        needsConfig: true,
+        needsTaskContext: false,
+    }),
+    entry(ideSyncSpec, () => import("./commands/ide.js").then((m) => m.runIdeSync), {
+        needsProject: true,
+        needsConfig: true,
+        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(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))),
+    entry(taskUpdateSpec, (deps) => import("../../commands/task/update.command.js").then((m) => m.makeRunTaskUpdateHandler(deps.getCtx))),
+    entry(taskCommentSpec, (deps) => import("../../commands/task/comment.command.js").then((m) => m.makeRunTaskCommentHandler(deps.getCtx))),
+    entry(taskSetStatusSpec, (deps) => import("../../commands/task/set-status.command.js").then((m) => m.makeRunTaskSetStatusHandler(deps.getCtx))),
+    entry(taskDocSpec, () => import("../../commands/task/doc.command.js").then((m) => m.runTaskDoc)),
+    entry(taskDocShowSpec, (deps) => import("../../commands/task/doc-show.command.js").then((m) => m.makeRunTaskDocShowHandler(deps.getCtx))),
+    entry(taskDocSetSpec, (deps) => import("../../commands/task/doc-set.command.js").then((m) => m.makeRunTaskDocSetHandler(deps.getCtx))),
+    entry(taskScrubSpec, (deps) => import("../../commands/task/scrub.command.js").then((m) => m.makeRunTaskScrubHandler(deps.getCtx))),
+    entry(taskScaffoldSpec, (deps) => import("../../commands/task/scaffold.command.js").then((m) => m.makeRunTaskScaffoldHandler(deps.getCtx))),
+    entry(taskNormalizeSpec, (deps) => import("../../commands/task/normalize.command.js").then((m) => m.makeRunTaskNormalizeHandler(deps.getCtx))),
+    entry(taskExportSpec, (deps) => import("../../commands/task/export.command.js").then((m) => m.makeRunTaskExportHandler(deps.getCtx))),
+    entry(taskLintSpec, () => import("../../commands/task/lint.command.js").then((m) => m.runTaskLint)),
+    entry(taskMigrateSpec, (deps) => import("../../commands/task/migrate.command.js").then((m) => m.makeRunTaskMigrateHandler(deps.getCtx))),
+    entry(taskMigrateDocSpec, () => import("../../commands/task/migrate-doc.command.js").then((m) => m.runTaskMigrateDoc)),
+    entry(taskPlanSetSpec, (deps) => import("../../commands/task/plan-set.command.js").then((m) => m.makeRunTaskPlanSetHandler(deps.getCtx))),
+    entry(taskPlanApproveSpec, (deps) => import("../../commands/task/plan-approve.command.js").then((m) => m.makeRunTaskPlanApproveHandler(deps.getCtx))),
+    entry(taskPlanRejectSpec, (deps) => import("../../commands/task/plan-reject.command.js").then((m) => m.makeRunTaskPlanRejectHandler(deps.getCtx))),
+    entry(taskVerifySpec, () => import("../../commands/task/verify.command.js").then((m) => m.runTaskVerify)),
+    entry(taskVerifyOkSpec, (deps) => import("../../commands/task/verify-ok.command.js").then((m) => m.makeRunTaskVerifyOkHandler(deps.getCtx))),
+    entry(taskVerifyReworkSpec, (deps) => import("../../commands/task/verify-rework.command.js").then((m) => m.makeRunTaskVerifyReworkHandler(deps.getCtx))),
+    entry(taskVerifyShowSpec, (deps) => import("../../commands/task/verify-show.command.js").then((m) => m.makeRunTaskVerifyShowHandler(deps.getCtx))),
+    entry(workStartSpec, (deps) => import("../../commands/branch/work-start.command.js").then((m) => m.makeRunWorkStartHandler(deps.getCtx))),
+    entry(recipesSpec, () => import("../../commands/recipes/recipes.command.js").then((m) => m.runRecipes)),
+    entry(recipesCacheSpec, () => import("../../commands/recipes/cache.command.js").then((m) => m.runRecipesCache)),
+    entry(recipesListSpec, () => import("../../commands/recipes/list.command.js").then((m) => m.runRecipesList)),
+    entry(recipesListRemoteSpec, () => import("../../commands/recipes/list-remote.command.js").then((m) => m.runRecipesListRemote)),
+    entry(recipesInfoSpec, () => import("../../commands/recipes/info.command.js").then((m) => m.runRecipesInfo)),
+    entry(recipesExplainSpec, () => import("../../commands/recipes/explain.command.js").then((m) => m.runRecipesExplain)),
+    entry(recipesRemoveSpec, () => import("../../commands/recipes/remove.command.js").then((m) => m.runRecipesRemove)),
+    entry(recipesCachePruneSpec, () => import("../../commands/recipes/cache-prune.command.js").then((m) => m.runRecipesCachePrune)),
+    entry(recipesInstallSpec, () => import("../../commands/recipes/install.command.js").then((m) => m.runRecipesInstall)),
+    entry(scenarioSpec, () => import("../../commands/scenario/scenario.command.js").then((m) => m.runScenario)),
+    entry(scenarioListSpec, () => import("../../commands/scenario/list.command.js").then((m) => m.runScenarioList)),
+    entry(scenarioInfoSpec, () => import("../../commands/scenario/info.command.js").then((m) => m.runScenarioInfo)),
+    entry(scenarioRunSpec, () => import("../../commands/scenario/run.command.js").then((m) => m.runScenarioRun)),
+    entry(branchBaseSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBase)),
+    entry(branchBaseGetSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseGet)),
+    entry(branchBaseSetSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseSet)),
+    entry(branchBaseClearSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseClear)),
+    entry(branchBaseExplainSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseExplain)),
+    entry(branchStatusSpec, () => import("../../commands/branch/status.command.js").then((m) => m.runBranchStatus)),
+    entry(branchRemoveSpec, () => import("../../commands/branch/remove.command.js").then((m) => m.runBranchRemove)),
+    entry(backendSpec, (deps) => import("../../commands/backend/sync.command.js").then((m) => m.makeRunBackendHandler(deps.getCtx))),
+    entry(backendSyncSpec, (deps) => import("../../commands/backend/sync.command.js").then((m) => m.makeRunBackendSyncHandler(deps.getCtx))),
+    entry(syncSpec, (deps) => import("../../commands/sync.command.js").then((m) => m.makeRunSyncHandler(deps.getCtx))),
+    entry(prSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrHandler(deps.getCtx))),
+    entry(prOpenSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrOpenHandler(deps.getCtx))),
+    entry(prUpdateSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrUpdateHandler(deps.getCtx))),
+    entry(prCheckSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrCheckHandler(deps.getCtx))),
+    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(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)),
+    entry(hooksInstallSpec, () => import("../../commands/hooks/install.command.js").then((m) => m.runHooksInstall)),
+    entry(hooksUninstallSpec, () => import("../../commands/hooks/uninstall.command.js").then((m) => m.runHooksUninstall)),
+    entry(hooksRunSpec, () => import("../../commands/hooks/run.command.js").then((m) => m.runHooksRun)),
+    entry(cleanupSpec, () => import("../../commands/cleanup/merged.command.js").then((m) => m.runCleanup)),
+    entry(cleanupMergedSpec, (deps) => import("../../commands/cleanup/merged.command.js").then((m) => m.makeRunCleanupMergedHandler(deps.getCtx))),
+    entry(guardSpec, () => import("../../commands/guard/guard.command.js").then((m) => m.runGuard)),
+    entry(guardCleanSpec, () => import("../../commands/guard/clean.command.js").then((m) => m.runGuardClean)),
+    entry(guardSuggestAllowSpec, () => import("../../commands/guard/suggest-allow.command.js").then((m) => m.runGuardSuggestAllow)),
+    entry(guardCommitSpec, (deps) => import("../../commands/guard/commit.command.js").then((m) => m.makeRunGuardCommitHandler(deps.getCtx))),
+];

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

@@ -0,0 +1,20 @@
+import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+type ConfigShowParsed = Record<string, never>;
+export declare const configShowSpec: CommandSpec<ConfigShowParsed>;
+export declare const runConfigShow: CommandHandler<ConfigShowParsed>;
+type ConfigSetParsed = {
+    key: string;
+    value: string;
+};
+export declare const configSetSpec: CommandSpec<ConfigSetParsed>;
+export declare const runConfigSet: CommandHandler<ConfigSetParsed>;
+type ModeGetParsed = Record<string, never>;
+export declare const modeGetSpec: CommandSpec<ModeGetParsed>;
+export declare const runModeGet: CommandHandler<ModeGetParsed>;
+type ModeSetParsed = {
+    mode: string;
+};
+export declare const modeSetSpec: CommandSpec<ModeSetParsed>;
+export declare const runModeSet: CommandHandler<ModeSetParsed>;
+export {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,130 @@
+import path from "node:path";
+import { loadConfig, resolveProject, saveConfig, setByDottedKey } from "@agentplaneorg/core";
+import { mapCoreError } from "../../error-map.js";
+import { usageError } from "../../spec/errors.js";
+export const configShowSpec = {
+    id: ["config", "show"],
+    group: "Config",
+    summary: "Print resolved config JSON.",
+    examples: [{ cmd: "agentplane config show", why: "Show the active config." }],
+    parse: () => ({}),
+};
+async function cmdConfigShow(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        process.stdout.write(`${JSON.stringify(loaded.raw, null, 2)}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, { command: "config show", root: opts.rootOverride ?? null });
+    }
+}
+export const runConfigShow = (ctx) => cmdConfigShow({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export const configSetSpec = {
+    id: ["config", "set"],
+    group: "Config",
+    summary: "Update project config (dotted keys).",
+    args: [
+        { name: "key", required: true, valueHint: "<key>" },
+        { name: "value", required: true, valueHint: "<value>" },
+    ],
+    examples: [
+        { cmd: "agentplane config set workflow_mode direct", why: "Set workflow mode." },
+        {
+            cmd: 'agentplane config set tasks.verify.required_tags \'["code","backend"]\'',
+            why: "Set a JSON list value (pass JSON as a string).",
+        },
+    ],
+    parse: (raw) => ({ key: String(raw.args.key ?? ""), value: String(raw.args.value ?? "") }),
+};
+async function cmdConfigSet(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        const raw = { ...loaded.raw };
+        setByDottedKey(raw, opts.key, opts.value);
+        await saveConfig(resolved.agentplaneDir, raw);
+        process.stdout.write(`${path.relative(resolved.gitRoot, path.join(resolved.agentplaneDir, "config.json"))}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, {
+            command: "config set",
+            key: opts.key,
+            root: opts.rootOverride ?? null,
+        });
+    }
+}
+export const runConfigSet = (ctx, p) => cmdConfigSet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, key: p.key, value: p.value });
+export const modeGetSpec = {
+    id: ["mode", "get"],
+    group: "Config",
+    summary: "Print workflow mode.",
+    examples: [{ cmd: "agentplane mode get", why: "Print workflow_mode (direct|branch_pr)." }],
+    parse: () => ({}),
+};
+async function cmdModeGet(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        process.stdout.write(`${loaded.config.workflow_mode}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, { command: "mode get", root: opts.rootOverride ?? null });
+    }
+}
+export const runModeGet = (ctx) => cmdModeGet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export const modeSetSpec = {
+    id: ["mode", "set"],
+    group: "Config",
+    summary: "Set workflow mode.",
+    args: [{ name: "mode", required: true, valueHint: "<direct|branch_pr>" }],
+    examples: [{ cmd: "agentplane mode set branch_pr", why: "Switch to branch_pr mode." }],
+    parse: (raw) => ({ mode: String(raw.args.mode ?? "") }),
+    validate: (p) => {
+        if (p.mode !== "direct" && p.mode !== "branch_pr") {
+            throw usageError({
+                spec: modeSetSpec,
+                command: "mode set",
+                message: `Invalid value for mode: ${p.mode} (expected: direct|branch_pr)`,
+            });
+        }
+    },
+};
+async function cmdModeSet(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const loaded = await loadConfig(resolved.agentplaneDir);
+        const raw = { ...loaded.raw };
+        setByDottedKey(raw, "workflow_mode", opts.mode);
+        await saveConfig(resolved.agentplaneDir, raw);
+        process.stdout.write(`${opts.mode}\n`);
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, {
+            command: "mode set",
+            root: opts.rootOverride ?? null,
+            mode: opts.mode,
+        });
+    }
+}
+export const runModeSet = (ctx, p) => cmdModeSet({
+    cwd: ctx.cwd,
+    rootOverride: ctx.rootOverride,
+    mode: p.mode,
+});

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

@@ -0,0 +1,14 @@
+import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+type QuickstartParsed = Record<string, never>;
+export declare const quickstartSpec: CommandSpec<QuickstartParsed>;
+export declare const runQuickstart: CommandHandler<QuickstartParsed>;
+type RoleParsed = {
+    role: string;
+};
+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 {};
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,144 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../error-map.js";
+import { fileExists } from "../../fs-utils.js";
+import { CliError } from "../../../shared/errors.js";
+import { dedupeStrings } from "../../../shared/strings.js";
+import { usageError } from "../../spec/errors.js";
+import { listRoles, renderQuickstart, renderRole } from "../../command-guide.js";
+export const quickstartSpec = {
+    id: ["quickstart"],
+    group: "Core",
+    summary: "Print CLI quickstart and command cheat sheet.",
+    options: [],
+    examples: [{ cmd: "agentplane quickstart", why: "Show quickstart." }],
+    parse: () => ({}),
+};
+function cmdQuickstart(opts) {
+    try {
+        process.stdout.write(`${renderQuickstart()}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "quickstart", root: opts.rootOverride ?? null });
+    }
+}
+export const runQuickstart = (ctx) => {
+    cmdQuickstart({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+    return Promise.resolve(0);
+};
+export const roleSpec = {
+    id: ["role"],
+    group: "Core",
+    summary: "Show role-specific workflow guidance.",
+    args: [{ name: "role", required: true, valueHint: "<role>" }],
+    examples: [{ cmd: "agentplane role ORCHESTRATOR", why: "Show ORCHESTRATOR guide." }],
+    parse: (raw) => ({ role: String(raw.args.role ?? "") }),
+};
+function cmdRole(opts) {
+    try {
+        const roleRaw = opts.role.trim();
+        if (!roleRaw) {
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: "Missing required argument: role",
+            });
+        }
+        const guide = renderRole(roleRaw);
+        if (!guide) {
+            const roles = listRoles();
+            const available = roles.length > 0 ? `\nAvailable roles: ${roles.join(", ")}` : "";
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: `Unknown role: ${roleRaw}.${available}`,
+            });
+        }
+        process.stdout.write(`${guide}\n`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "role", root: opts.rootOverride ?? null });
+    }
+}
+export const runRole = (ctx, p) => {
+    cmdRole({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, role: p.role });
+    return Promise.resolve(0);
+};
+export const agentsSpec = {
+    id: ["agents"],
+    group: "Core",
+    summary: "List agent definitions under .agentplane/agents.",
+    examples: [{ cmd: "agentplane agents", why: "Print available agent ids and roles." }],
+    parse: () => ({}),
+};
+async function cmdAgents(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const agentsDir = path.join(resolved.agentplaneDir, "agents");
+        if (!(await fileExists(agentsDir))) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Agents directory not found: ${agentsDir} (run \`agentplane init\`)`,
+            });
+        }
+        const entriesRaw = await readdir(agentsDir);
+        const entries = entriesRaw.filter((name) => name.endsWith(".json")).toSorted();
+        if (entries.length === 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `No agent definitions found under ${agentsDir} (expected *.json)`,
+            });
+        }
+        const rows = [];
+        const seen = new Set();
+        const duplicates = [];
+        for (const entry of entries) {
+            const filePath = path.join(agentsDir, entry);
+            const raw = JSON.parse(await readFile(filePath, "utf8"));
+            const rawId = typeof raw.id === "string" ? raw.id : "";
+            const rawRole = typeof raw.role === "string" ? raw.role : "";
+            const agentId = rawId.trim() || "<missing-id>";
+            const role = rawRole.trim() || "-";
+            if (seen.has(agentId)) {
+                duplicates.push(agentId);
+            }
+            else {
+                seen.add(agentId);
+            }
+            rows.push([agentId, role, entry]);
+        }
+        const widthId = Math.max(...rows.map((row) => row[0].length), "ID".length);
+        const widthFile = Math.max(...rows.map((row) => row[2].length), "FILE".length);
+        process.stdout.write(`${"ID".padEnd(widthId)}  ${"FILE".padEnd(widthFile)}  ROLE\n`);
+        process.stdout.write(`${"-".repeat(widthId)}  ${"-".repeat(widthFile)}  ----\n`);
+        for (const [agentId, role, filename] of rows) {
+            process.stdout.write(`${agentId.padEnd(widthId)}  ${filename.padEnd(widthFile)}  ${role}\n`);
+        }
+        if (duplicates.length > 0) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Duplicate agent ids: ${dedupeStrings(duplicates).toSorted().join(", ")}`,
+            });
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapCoreError(err, { command: "agents", root: opts.rootOverride ?? null });
+    }
+}
+export const runAgents = (ctx) => cmdAgents({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

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

@@ -0,0 +1,13 @@
+import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+type IdeSyncParsed = {
+    ide?: "cursor" | "windsurf";
+};
+export declare const ideSyncSpec: CommandSpec<IdeSyncParsed>;
+export declare function cmdIdeSync(opts: {
+    cwd: string;
+    rootOverride?: string;
+    ide?: "cursor" | "windsurf";
+}): Promise<number>;
+export declare const runIdeSync: CommandHandler<IdeSyncParsed>;
+export {};
+//# sourceMappingURL=ide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ide.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/ide.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,KAAK,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAkBlD,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AAED,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACqB,CAAC"}

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

@@ -0,0 +1,67 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+import { mapCoreError } from "../../error-map.js";
+import { writeTextIfChanged } from "../../../shared/write-if-changed.js";
+export const ideSyncSpec = {
+    id: ["ide", "sync"],
+    group: "IDE",
+    summary: "Generate IDE entrypoints from AGENTS.md.",
+    options: [
+        {
+            kind: "string",
+            name: "ide",
+            valueHint: "<cursor|windsurf>",
+            choices: ["cursor", "windsurf"],
+            description: "Only generate rules for a single IDE (default: both).",
+        },
+    ],
+    examples: [
+        { cmd: "agentplane ide sync", why: "Generate Cursor + Windsurf rules." },
+        { cmd: "agentplane ide sync --ide cursor", why: "Generate Cursor rules only." },
+    ],
+    parse: (raw) => ({ ide: raw.opts.ide }),
+};
+export async function cmdIdeSync(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const agentsPath = path.join(resolved.gitRoot, "AGENTS.md");
+        const agentsText = await readFile(agentsPath, "utf8");
+        const header = [
+            "<!--",
+            "  AUTOGENERATED by agentplane ide sync.",
+            "  DO NOT EDIT MANUALLY.",
+            "  Source: AGENTS.md",
+            "-->",
+            "",
+        ].join("\n");
+        const content = `${header}${agentsText.trimEnd()}\n`;
+        const targets = opts.ide === "cursor"
+            ? ["cursor"]
+            : opts.ide === "windsurf"
+                ? ["windsurf"]
+                : ["cursor", "windsurf"];
+        if (targets.includes("cursor")) {
+            const cursorDir = path.join(resolved.gitRoot, ".cursor", "rules");
+            await mkdir(cursorDir, { recursive: true });
+            const cursorPath = path.join(cursorDir, "agentplane.mdc");
+            await writeTextIfChanged(cursorPath, content);
+            process.stdout.write(`${path.relative(resolved.gitRoot, cursorPath)}\n`);
+        }
+        if (targets.includes("windsurf")) {
+            const windsurfDir = path.join(resolved.gitRoot, ".windsurf", "rules");
+            await mkdir(windsurfDir, { recursive: true });
+            const windsurfPath = path.join(windsurfDir, "agentplane.md");
+            await writeTextIfChanged(windsurfPath, content);
+            process.stdout.write(`${path.relative(resolved.gitRoot, windsurfPath)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        throw mapCoreError(err, { command: "ide sync", root: opts.rootOverride ?? null });
+    }
+}
+export const runIdeSync = (ctx, p) => cmdIdeSync({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, ide: p.ide });

package/dist/cli/run-cli/commands/init/base-branch.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowMode } from "../../../../agents/agents-template.js";
+export declare function resolveInitBaseBranchForInit(opts: {
+    gitRoot: string;
+    baseBranchFallback: string;
+    isInteractive: boolean;
+    workflow: WorkflowMode;
+    gitRootExisted: boolean;
+}): Promise<string>;
+//# sourceMappingURL=base-branch.d.ts.map

package/dist/cli/run-cli/commands/init/base-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-branch.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/base-branch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAG1E,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CASlB"}

package/dist/cli/run-cli/commands/init/base-branch.js

@@ -0,0 +1,11 @@
+import { promptInitBaseBranch, resolveInitBaseBranch } from "../../../../commands/workflow.js";
+export async function resolveInitBaseBranchForInit(opts) {
+    let initBaseBranch = await resolveInitBaseBranch(opts.gitRoot, opts.baseBranchFallback);
+    if (opts.isInteractive && opts.workflow === "branch_pr" && opts.gitRootExisted) {
+        initBaseBranch = await promptInitBaseBranch({
+            gitRoot: opts.gitRoot,
+            fallback: initBaseBranch,
+        });
+    }
+    return initBaseBranch;
+}