agentplane 0.2.25 → 0.2.26

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

@@ -13,51 +13,46 @@ import { collectInitConflicts, handleInitConflicts } from "./init/conflicts.js";
 import { ensureGitRoot } from "./init/git.js";
 import { maybeSyncIde } from "./init/ide-sync.js";
 import { maybeInstallBundledRecipes } from "./init/recipes.js";
+import { ensureInitWorkflow } from "./init/write-workflow.js";
 import { ensureAgentplaneDirs, writeBackendStubs, writeInitConfig } from "./init/write-config.js";
 import { ensureAgentsFiles } from "./init/write-agents.js";
 import { ensureInitGitignore } from "./init/write-gitignore.js";
 import { ensureInitRedmineEnvTemplate } from "./init/write-env.js";
 import { renderInitSection, renderInitWelcome } from "./init/ui.js";
+import { fileExists } from "../../fs-utils.js";
 const setupProfilePresets = {
-    developer: {
-        mode: "full",
-        description: "I am Developer (full setup questionnaire; hooks on; explicit unsafe confirmations on).",
-        defaultHooks: true,
-        defaultStrictUnsafeConfirm: true,
-        defaultRequirePlanApproval: true,
-        defaultRequireNetworkApproval: true,
-        defaultRequireVerifyApproval: true,
-        defaultExecutionProfile: "balanced",
-    },
-    vibecoder: {
+    light: {
         mode: "compact",
-        description: "I am Vibecoder (compact setup; hooks off; approvals off; aggressive execution defaults).",
-        defaultHooks: false,
+        description: "Light profile (maximum flexibility, minimal enforcement, hooks still mandatory).",
+        defaultHooks: true,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: false,
         defaultRequireNetworkApproval: false,
         defaultRequireVerifyApproval: false,
         defaultExecutionProfile: "aggressive",
+        defaultRecipes: [],
     },
-    manager: {
+    normal: {
         mode: "compact",
-        description: "I am Manager / Product owner (compact setup; oversight defaults with approvals on, hooks off).",
-        defaultHooks: false,
+        description: "Normal profile (balanced defaults and approvals enabled for standard team workflows).",
+        defaultHooks: true,
         defaultStrictUnsafeConfirm: false,
         defaultRequirePlanApproval: true,
         defaultRequireNetworkApproval: true,
         defaultRequireVerifyApproval: true,
         defaultExecutionProfile: "balanced",
+        defaultRecipes: [],
     },
-    enterprise: {
+    "full-harness": {
         mode: "full",
-        description: "I am Enterprise / Regulated team (full setup; strict approvals, hooks on, conservative execution).",
+        description: "Full Harness profile (strict guardrails, explicit confirmations, conservative execution).",
         defaultHooks: true,
         defaultStrictUnsafeConfirm: true,
         defaultRequirePlanApproval: true,
         defaultRequireNetworkApproval: true,
         defaultRequireVerifyApproval: true,
         defaultExecutionProfile: "conservative",
+        defaultRecipes: [],
     },
 };
 function parseBooleanValueForInit(flag, value) {
@@ -81,6 +76,22 @@ function parseRecipesSelectionForInit(value) {
         .map((item) => item.trim())
         .filter(Boolean);
 }
+function normalizeSetupProfile(raw) {
+    if (!raw)
+        return undefined;
+    const value = raw.trim().toLowerCase();
+    if (value === "developer")
+        return "full-harness";
+    if (value === "enterprise")
+        return "full-harness";
+    if (value === "manager")
+        return "normal";
+    if (value === "vibecoder")
+        return "light";
+    if (value === "light" || value === "normal" || value === "full-harness")
+        return value;
+    return undefined;
+}
 export const initSpec = {
     id: ["init"],
     group: "Setup",
@@ -90,9 +101,17 @@ export const initSpec = {
         {
             kind: "string",
             name: "setup-profile",
-            valueHint: "<developer|vibecoder|manager|enterprise>",
-            choices: ["developer", "vibecoder", "manager", "enterprise"],
-            description: "Persona preset for init defaults and dialog depth (compact vs full questionnaire).",
+            valueHint: "<light|normal|full-harness>",
+            choices: [
+                "light",
+                "normal",
+                "full-harness",
+                "developer",
+                "vibecoder",
+                "manager",
+                "enterprise",
+            ],
+            description: "Setup profile preset. Preferred values: light, normal, full-harness.",
         },
         {
             kind: "string",
@@ -121,7 +140,7 @@ export const initSpec = {
             kind: "string",
             name: "hooks",
             valueHint: "<true|false>",
-            description: "Install git hooks (non-interactive requires an explicit value).",
+            description: "Hooks are mandatory; only true is accepted.",
         },
         {
             kind: "string",
@@ -188,11 +207,11 @@ export const initSpec = {
     examples: [
         { cmd: "agentplane init", why: "Interactive setup (prompts for missing values)." },
         {
-            cmd: "agentplane init --setup-profile vibecoder --yes",
-            why: "Non-interactive fast setup for autonomous defaults (hooks off, approvals off).",
+            cmd: "agentplane init --setup-profile light --yes",
+            why: "Non-interactive setup with flexible defaults.",
         },
         {
-            cmd: "agentplane init --workflow direct --backend local --hooks false --require-plan-approval true --require-network-approval true --require-verify-approval true --yes",
+            cmd: "agentplane init --workflow direct --backend local --hooks true --require-plan-approval true --require-network-approval true --require-verify-approval true --yes",
             why: "Non-interactive setup with explicit policy flags.",
         },
         {
@@ -220,7 +239,7 @@ export const initSpec = {
         const requireVerifyRaw = raw.opts["require-verify-approval"];
         const recipesRaw = raw.opts.recipes;
         return {
-            setupProfile: raw.opts["setup-profile"],
+            setupProfile: normalizeSetupProfile(raw.opts["setup-profile"]),
             ide: raw.opts.ide,
             workflow: raw.opts.workflow,
             backend: raw.opts.backend,
@@ -253,6 +272,13 @@ export const initSpec = {
                 message: "Use either --force or --backup (not both).",
             });
         }
+        if (p.hooks === false) {
+            throw usageError({
+                spec: initSpec,
+                command: "init",
+                message: "Hooks installation is mandatory. Use --hooks true (or omit the flag).",
+            });
+        }
     },
 };
 export const runInit = (ctx, flags) => cmdInit({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });
@@ -262,7 +288,6 @@ async function cmdInit(opts) {
         ide: "codex",
         workflow: "direct",
         backend: "local",
-        hooks: false,
         recipes: [],
         requirePlanApproval: true,
         requireNetworkApproval: true,
@@ -273,7 +298,6 @@ async function cmdInit(opts) {
     let ide = flags.ide ?? defaults.ide;
     let workflow = flags.workflow ?? defaults.workflow;
     let backend = flags.backend ?? defaults.backend;
-    let hooks = flags.hooks ?? defaults.hooks;
     let recipes = flags.recipes ?? defaults.recipes;
     let requirePlanApproval = flags.requirePlanApproval ?? defaults.requirePlanApproval;
     let requireNetworkApproval = flags.requireNetworkApproval ?? defaults.requireNetworkApproval;
@@ -283,19 +307,18 @@ async function cmdInit(opts) {
     let setupProfile = flags.setupProfile
         ? setupProfilePresets[flags.setupProfile].mode
         : "compact";
-    let setupProfilePreset = flags.setupProfile ?? "manager";
+    let setupProfilePreset = flags.setupProfile ?? "normal";
     const isInteractive = process.stdin.isTTY && !flags.yes;
     if (!process.stdin.isTTY &&
         !flags.yes &&
         (!flags.workflow ||
-            flags.hooks === undefined ||
             flags.requirePlanApproval === undefined ||
             flags.requireNetworkApproval === undefined ||
             flags.requireVerifyApproval === undefined)) {
         throw usageError({
             spec: initSpec,
             command: "init",
-            message: "Non-interactive init requires --yes or explicit values for: --workflow, --hooks, --require-plan-approval, --require-network-approval, --require-verify-approval.",
+            message: "Non-interactive init requires --yes or explicit values for: --workflow, --require-plan-approval, --require-network-approval, --require-verify-approval.",
         });
     }
     if (isInteractive) {
@@ -316,19 +339,17 @@ async function cmdInit(opts) {
         };
         process.stdout.write(renderInitWelcome());
         const presetLines = Object.entries(setupProfilePresets).map(([id, preset]) => `- ${id}: ${preset.description}`);
-        process.stdout.write(renderInitSection("Who Are You?", "Pick the persona that best matches your working style. This sets defaults and controls compact vs full questionnaire."));
+        process.stdout.write(renderInitSection("Setup Profile", "Pick one of three setup profiles. This controls policy strictness and questionnaire depth."));
         process.stdout.write(`${presetLines.join("\n")}\n\n`);
         if (flags.setupProfile) {
             setupProfilePreset = flags.setupProfile;
         }
         else {
-            const selected = await askChoice("Who are you?", ["developer", "vibecoder", "manager", "enterprise"], "manager");
+            const selected = await askChoice("Setup profile", ["light", "normal", "full-harness"], "normal");
             setupProfilePreset = selected;
         }
         const selectedPreset = setupProfilePresets[setupProfilePreset];
         setupProfile = selectedPreset.mode;
-        if (flags.hooks === undefined)
-            hooks = selectedPreset.defaultHooks;
         if (flags.strictUnsafeConfirm === undefined) {
             strictUnsafeConfirm = selectedPreset.defaultStrictUnsafeConfirm;
         }
@@ -360,9 +381,7 @@ async function cmdInit(opts) {
             backend = choice === "redmine" ? "redmine" : "local";
         }
         if (setupProfile === "full") {
-            if (flags.hooks === undefined) {
-                hooks = await askYesNo("Install managed git hooks now?", hooks);
-            }
+            process.stdout.write(renderInitSection("Hooks", "Managed git hooks are mandatory and will be installed automatically."));
             process.stdout.write(renderInitSection("Execution Profile", "Set default autonomy/effort for agents. You can change this later in config."));
             if (!flags.executionProfile) {
                 executionProfile = (await askChoice("Execution profile", ["conservative", "balanced", "aggressive"], executionProfile));
@@ -383,18 +402,27 @@ async function cmdInit(opts) {
             process.stdout.write(renderInitSection("Recipes", "Optional: install recipe packs now (comma-separated IDs) or choose none."));
             if (!flags.recipes) {
                 process.stdout.write(`${renderBundledRecipesHint()}\n`);
-                const answer = await askInput("Install optional recipes (comma separated, or none): ");
-                recipes = answer
-                    ? answer
+                const defaultRecipesLabel = selectedPreset.defaultRecipes.length > 0
+                    ? selectedPreset.defaultRecipes.join(", ")
+                    : "none";
+                const answer = await askInput(`Install optional recipes (comma separated, or none) [default: ${defaultRecipesLabel}]: `);
+                const normalized = answer.trim().toLowerCase();
+                if (normalized === "") {
+                    recipes = [...selectedPreset.defaultRecipes];
+                }
+                else if (normalized === "none") {
+                    recipes = [];
+                }
+                else {
+                    recipes = answer
                         .split(",")
                         .map((item) => item.trim())
-                        .filter(Boolean)
-                    : [];
+                        .filter(Boolean);
+                }
             }
         }
         else {
-            hooks = flags.hooks ?? selectedPreset.defaultHooks;
-            recipes = flags.recipes ?? defaults.recipes;
+            recipes = flags.recipes ?? selectedPreset.defaultRecipes;
             requirePlanApproval = flags.requirePlanApproval ?? selectedPreset.defaultRequirePlanApproval;
             requireNetworkApproval =
                 flags.requireNetworkApproval ?? selectedPreset.defaultRequireNetworkApproval;
@@ -402,7 +430,7 @@ async function cmdInit(opts) {
                 flags.requireVerifyApproval ?? selectedPreset.defaultRequireVerifyApproval;
             executionProfile = flags.executionProfile ?? selectedPreset.defaultExecutionProfile;
             strictUnsafeConfirm = flags.strictUnsafeConfirm ?? selectedPreset.defaultStrictUnsafeConfirm;
-            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for hooks, approvals, execution profile, and recipes.`));
+            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for approvals, execution profile, and recipes. Hooks remain mandatory.`));
         }
     }
     if (flags.yes) {
@@ -410,8 +438,7 @@ async function cmdInit(opts) {
         ide = flags.ide ?? defaults.ide;
         workflow = flags.workflow ?? defaults.workflow;
         backend = flags.backend ?? defaults.backend;
-        hooks = flags.hooks ?? yesPreset.defaultHooks;
-        recipes = flags.recipes ?? defaults.recipes;
+        recipes = flags.recipes ?? yesPreset.defaultRecipes;
         requirePlanApproval = flags.requirePlanApproval ?? yesPreset.defaultRequirePlanApproval;
         requireNetworkApproval =
             flags.requireNetworkApproval ?? yesPreset.defaultRequireNetworkApproval;
@@ -446,6 +473,20 @@ async function cmdInit(opts) {
         ];
         const initFiles = [configPath, backendPath];
         const conflicts = await collectInitConflicts({ initDirs, initFiles });
+        const agentsPath = path.join(resolved.gitRoot, "AGENTS.md");
+        const agentsMissing = !(await fileExists(agentsPath));
+        if (conflicts.length > 0 && agentsMissing) {
+            // Recovery path: if a repo already contains conflicting .agentplane config/backend files,
+            // still materialize missing policy/agent templates before reporting conflicts.
+            await ensureAgentplaneDirs(resolved.agentplaneDir, backend);
+            await ensureAgentsFiles({
+                gitRoot: resolved.gitRoot,
+                agentplaneDir: resolved.agentplaneDir,
+                workflow,
+                configPathAbs: configPath,
+                backendPathAbs: backendPath,
+            });
+        }
         await handleInitConflicts({
             gitRoot: resolved.gitRoot,
             conflicts,
@@ -483,6 +524,13 @@ async function cmdInit(opts) {
             includeAgentPromptFiles: flags.gitignoreAgents === true,
         });
         installPaths.push(".gitignore");
+        const workflowInit = await ensureInitWorkflow({
+            gitRoot: resolved.gitRoot,
+            workflowMode: workflow,
+        });
+        for (const abs of workflowInit.installPaths) {
+            installPaths.push(path.relative(resolved.gitRoot, abs));
+        }
         if (flags.gitignoreAgents) {
             await setPinnedBaseBranch({
                 cwd: resolved.gitRoot,
@@ -490,10 +538,8 @@ async function cmdInit(opts) {
                 value: initBaseBranch,
             });
         }
-        if (hooks) {
-            await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
-            installPaths.push(".agentplane/bin/agentplane");
-        }
+        await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
+        installPaths.push(".agentplane/bin/agentplane");
         const ideRes = await maybeSyncIde({
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
@@ -501,14 +547,18 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
         });
         installPaths.push(...ideRes.installPaths);
-        maybeInstallBundledRecipes(recipes);
+        await maybeInstallBundledRecipes({
+            recipes,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+        });
         if (!flags.gitignoreAgents) {
             await ensureInitCommit({
                 gitRoot: resolved.gitRoot,
                 baseBranch: initBaseBranch,
                 installPaths,
                 version: getVersion(),
-                skipHooks: hooks,
+                skipHooks: true,
             });
         }
         process.stdout.write(`${path.relative(resolved.gitRoot, resolved.agentplaneDir)}\n`);

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

@@ -1 +1 @@
-{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAibA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiL5D"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAoeA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4M5D"}

package/dist/cli/run-cli.js

@@ -15,6 +15,7 @@ import { helpSpec } from "./spec/help.js";
 import { usageError } from "./spec/errors.js";
 import { suggestOne } from "./spec/suggest.js";
 import { COMMANDS } from "./run-cli/command-catalog.js";
+import { getReasonCodeMeta } from "./reason-codes.js";
 const GLOBAL_FLAGS = [
     { key: "help", forms: ["--help", "-h"], takesValue: false, scoped: false },
     { key: "version", forms: ["--version", "-v"], takesValue: false, scoped: false },
@@ -24,6 +25,7 @@ const GLOBAL_FLAGS = [
     { key: "root", forms: ["--root"], takesValue: true, scoped: false },
 ];
 const GLOBAL_FLAG_FORMS = new Map(GLOBAL_FLAGS.flatMap((def) => def.forms.map((form) => [form, def])));
+const HELP_TAIL_OPTIONS = new Set(["--compact", "--json"]);
 function prescanJsonErrors(argv) {
     // If parseGlobalArgs throws (e.g. missing --root value), we still want to honor
     // `--json-errors` in the "scoped global" zone (before the command id).
@@ -135,8 +137,15 @@ function matchCommandCatalog(tokens) {
 }
 function writeError(err, jsonErrors) {
     const guidance = resolveErrorGuidance(err);
+    const contextReasonCode = typeof err.context?.reason_code === "string" ? String(err.context.reason_code) : undefined;
+    const reasonCode = contextReasonCode ?? guidance.nextAction?.reasonCode;
+    const reasonDecode = getReasonCodeMeta(reasonCode);
     if (jsonErrors) {
-        process.stdout.write(`${formatJsonError(err, { hint: guidance.hint, nextAction: guidance.nextAction })}\n`);
+        process.stdout.write(`${formatJsonError(err, {
+            hint: guidance.hint,
+            nextAction: guidance.nextAction,
+            reasonDecode,
+        })}\n`);
     }
     else {
         const header = `error [${err.code}]`;
@@ -152,6 +161,10 @@ function writeError(err, jsonErrors) {
         if (guidance.nextAction) {
             process.stderr.write(`next_action: ${guidance.nextAction.command} (${guidance.nextAction.reason})\n`);
         }
+        if (reasonDecode) {
+            process.stderr.write(`reason_code: ${reasonDecode.code} [${reasonDecode.category}] ${reasonDecode.summary}\n`);
+            process.stderr.write(`reason_action: ${reasonDecode.action}\n`);
+        }
     }
 }
 const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
@@ -163,9 +176,20 @@ function resolveAgentplaneHome() {
 }
 function resolveErrorGuidance(err) {
     const command = typeof err.context?.command === "string" ? err.context.command : undefined;
+    const reasonCode = typeof err.context?.reason_code === "string" ? String(err.context.reason_code) : undefined;
     const usage = command ? `agentplane help ${command} --compact` : "agentplane help";
     switch (err.code) {
         case "E_USAGE": {
+            if (reasonCode === "sync_backend_mismatch") {
+                return {
+                    hint: "Configured backend id mismatch. Check active backend and retry with a matching id.",
+                    nextAction: {
+                        command: "agentplane config show",
+                        reason: "inspect active backend id before running sync",
+                        reasonCode: "sync_backend_mismatch",
+                    },
+                };
+            }
             return {
                 hint: `See \`${usage}\` for usage.`,
                 nextAction: {
@@ -176,6 +200,16 @@ function resolveErrorGuidance(err) {
             };
         }
         case "E_GIT": {
+            if (reasonCode === "reconcile_git_state_unreadable") {
+                return {
+                    hint: "Reconcile check could not read git state.",
+                    nextAction: {
+                        command: "git status --short --untracked-files=no",
+                        reason: "confirm repository state is readable before mutating commands",
+                        reasonCode: "reconcile_git_state_unreadable",
+                    },
+                };
+            }
             if (command?.startsWith("branch")) {
                 return {
                     hint: "Check git repo/branch; run `git branch` or pass --root <path>.",
@@ -236,6 +270,17 @@ function resolveErrorGuidance(err) {
             };
         }
         case "E_VALIDATION": {
+            if (reasonCode === "reconcile_task_scan_failed" ||
+                reasonCode === "reconcile_task_scan_incomplete") {
+                return {
+                    hint: "Reconcile check failed due to task scan drift or parse/read errors.",
+                    nextAction: {
+                        command: "agentplane task list --strict-read",
+                        reason: "surface task scan/read failures before retrying mutating commands",
+                        reasonCode: reasonCode,
+                    },
+                };
+            }
             return {
                 hint: "Fix invalid config/input shape and rerun.",
                 nextAction: {
@@ -390,6 +435,30 @@ export async function runCli(argv) {
         // - agentplane --help
         // - agentplane <cmd...> --help [--compact|--json]
         if (globals.help) {
+            const matchedHelp = matchCommandCatalog(rest);
+            if (matchedHelp) {
+                const rawHelpTail = rest.slice(matchedHelp.consumed);
+                const commandFlags = new Set();
+                for (const opt of matchedHelp.entry.spec.options ?? []) {
+                    const optRecord = opt;
+                    const long = typeof optRecord.name === "string" ? optRecord.name.trim() : "";
+                    if (long)
+                        commandFlags.add(`--${long}`);
+                    const short = typeof optRecord.alias === "string" ? optRecord.alias.trim() : "";
+                    if (short)
+                        commandFlags.add(`-${short}`);
+                }
+                const invalidHelpTail = rawHelpTail.filter((token) => token.startsWith("-") && !HELP_TAIL_OPTIONS.has(token) && !commandFlags.has(token));
+                if (invalidHelpTail.length > 0) {
+                    throw usageError({
+                        spec: helpSpec,
+                        command: "help",
+                        message: `Unsupported flag(s) after --help: ${invalidHelpTail.join(", ")}.`,
+                    });
+                }
+                const helpTail = rawHelpTail.filter((token) => token.startsWith("-") && HELP_TAIL_OPTIONS.has(token));
+                return await runCli2HelpFast(["help", ...matchedHelp.entry.spec.id, ...helpTail]);
+            }
             return await runCli2HelpFast(["help", ...rest]);
         }
         if (rest.length === 0) {

package/dist/commands/backend/sync.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAQtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,8BAEtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}
+{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAQtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,8BAEtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}

package/dist/commands/backend/sync.command.js

@@ -1,3 +1,4 @@
+import { COMMAND_SNIPPETS } from "../../cli/command-snippets.js";
 import { usageError } from "../../cli/spec/errors.js";
 import { suggestOne } from "../../cli/spec/suggest.js";
 import { cmdBackendSyncParsed } from "../backend.js";
@@ -7,7 +8,7 @@ export const backendSpec = {
     summary: "Backend-related operations.",
     description: "This is a command group. Use a subcommand such as `agentplane backend sync ...`.",
     args: [{ name: "cmd", required: false, variadic: true, valueHint: "<cmd>" }],
-    examples: [{ cmd: "agentplane backend sync local --direction pull", why: "Sync the backend." }],
+    examples: [{ cmd: COMMAND_SNIPPETS.backendSync.pullLocal, why: "Sync the backend." }],
     parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
 };
 export const backendSyncSpec = {
@@ -21,8 +22,8 @@ export const backendSyncSpec = {
             name: "direction",
             valueHint: "<push|pull>",
             choices: ["push", "pull"],
-            required: true,
-            description: "Sync direction.",
+            default: "push",
+            description: "Sync direction (default: push).",
         },
         {
             kind: "string",
@@ -36,15 +37,15 @@ export const backendSyncSpec = {
         { kind: "boolean", name: "quiet", default: false, description: "Reduce output noise." },
     ],
     examples: [
-        { cmd: "agentplane backend sync local --direction pull", why: "Pull from backend." },
+        { cmd: COMMAND_SNIPPETS.backendSync.pullLocal, why: "Pull from backend." },
         {
-            cmd: "agentplane backend sync redmine --direction push --yes",
+            cmd: COMMAND_SNIPPETS.backendSync.pushRedmineWithYes,
             why: "Push to a networked backend with explicit approval.",
         },
     ],
     parse: (raw) => ({
         backendId: String(raw.args.id),
-        direction: raw.opts.direction,
+        direction: (raw.opts.direction ?? "push"),
         conflict: (raw.opts.conflict ?? "diff"),
         yes: raw.opts.yes === true,
         quiet: raw.opts.quiet === true,

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

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}

package/dist/commands/backend.js

@@ -15,6 +15,7 @@ export async function cmdBackendSyncParsed(opts) {
                 exitCode: 2,
                 code: "E_USAGE",
                 message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
+                context: { command: "backend sync", reason_code: "sync_backend_mismatch" },
             });
         }
         if (!backend.sync) {
@@ -57,6 +58,7 @@ export async function cmdSyncParsed(opts) {
                 exitCode: 2,
                 code: "E_USAGE",
                 message: `Configured backend is "${backendId}", not "${opts.flags.backendId}"`,
+                context: { command: "sync", reason_code: "sync_backend_mismatch" },
             });
         }
         if (!backend.sync) {

package/dist/commands/doctor.run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsPrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAwBlD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqUrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAmDlD,CAAC"}