agentplane 0.3.14 → 0.3.16

package/dist/cli/error-map.js

@@ -1,42 +1,254 @@
-import { exitCodeForError } from "./exit-codes.js";
-import { CliError } from "../shared/errors.js";
+import { fromZodError, isZodErrorLike } from "zod-validation-error/v3";
+import { readDiagnosticContext } from "../commands/shared/diagnostics.js";
+import { BackendCliError, GitError, IoError, NetworkError, ValidationError, formatJsonError, } from "../shared/errors.js";
 import { BackendError } from "../backends/task-backend.js";
+import { getReasonCodeMeta } from "./reason-codes.js";
+function findZodError(err) {
+    if (isZodErrorLike(err))
+        return err;
+    if (err instanceof Error) {
+        const cause = err.cause;
+        if (isZodErrorLike(cause))
+            return cause;
+    }
+    return null;
+}
+function formatZodErrorForCli(err) {
+    return fromZodError(err, { prefix: "Validation error" }).message;
+}
 export function mapCoreError(err, context) {
     const message = err instanceof Error ? err.message : String(err);
-    if (message.startsWith("Not a git repository")) {
-        return new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
+    const zodError = findZodError(err);
+    if (zodError) {
+        return new ValidationError({
+            message: formatZodErrorForCli(zodError),
+            context,
+        });
+    }
+    if (message.startsWith("Not a git repository") ||
+        message.startsWith("Detached HEAD") ||
+        message.includes("failed to resolve current branch")) {
+        return new GitError({
             message,
             context,
         });
     }
     if (err instanceof SyntaxError) {
-        return new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
+        return new ValidationError({
             message: `Invalid JSON: ${message}`,
             context,
         });
     }
     if (message.includes("schema_version") || message.startsWith("config.")) {
-        return new CliError({
-            exitCode: exitCodeForError("E_VALIDATION"),
-            code: "E_VALIDATION",
+        return new ValidationError({
             message,
             context,
         });
     }
-    return new CliError({ exitCode: exitCodeForError("E_IO"), code: "E_IO", message, context });
+    return new IoError({ message, context });
 }
 export function mapBackendError(err, context) {
     if (err instanceof BackendError) {
-        return new CliError({
-            exitCode: exitCodeForError(err.code),
-            code: err.code,
-            message: err.message,
-            context,
-        });
+        if (err.code === "E_NETWORK")
+            return new NetworkError({ message: err.message, context });
+        return new BackendCliError({ message: err.message, context });
     }
     return mapCoreError(err, context);
 }
+export 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, {
+            state: guidance.state,
+            likelyCause: guidance.likelyCause,
+            hint: guidance.hint,
+            nextAction: guidance.nextAction,
+            reasonDecode,
+        })}\n`);
+        return;
+    }
+    const header = `error [${err.code}]`;
+    if (err.message.includes("\n")) {
+        process.stderr.write(`${header}\n${err.message}\n`);
+    }
+    else {
+        process.stderr.write(`${header}: ${err.message}\n`);
+    }
+    if (guidance.state) {
+        process.stderr.write(`state: ${guidance.state}\n`);
+    }
+    if (guidance.likelyCause) {
+        process.stderr.write(`likely_cause: ${guidance.likelyCause}\n`);
+    }
+    if (guidance.hint) {
+        process.stderr.write(`hint: ${guidance.hint}\n`);
+    }
+    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`);
+    }
+}
+function resolveErrorGuidance(err) {
+    const explicit = readDiagnosticContext(err.context);
+    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";
+    const withExplicit = (fallback) => ({
+        state: explicit.state ?? fallback.state,
+        likelyCause: explicit.likelyCause ?? fallback.likelyCause,
+        hint: explicit.hint ?? fallback.hint,
+        nextAction: explicit.nextAction ?? fallback.nextAction,
+    });
+    switch (err.code) {
+        case "E_USAGE": {
+            if (reasonCode === "sync_backend_mismatch") {
+                return withExplicit({
+                    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 withExplicit({
+                hint: `See \`${usage}\` for usage.`,
+                nextAction: {
+                    command: usage,
+                    reason: "inspect required arguments and flags",
+                    reasonCode: "usage_help",
+                },
+            });
+        }
+        case "E_GIT": {
+            if (reasonCode === "integrate_base_checkout_required") {
+                return withExplicit({
+                    hint: "Integrate must run from the base checkout, not from the task branch worktree.",
+                    nextAction: {
+                        command: "git worktree list",
+                        reason: "locate the registered base checkout if the rerun command is not already provided",
+                        reasonCode,
+                    },
+                });
+            }
+            if (reasonCode === "reconcile_git_state_unreadable") {
+                return withExplicit({
+                    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 withExplicit({
+                    hint: "Check git repo/branch; run `git branch` or pass --root <path>.",
+                    nextAction: {
+                        command: "git branch",
+                        reason: "inspect repository branch state",
+                        reasonCode: "git_branch_state",
+                    },
+                });
+            }
+            if (command === "guard commit" || command === "commit") {
+                return withExplicit({
+                    hint: "Check git status/index; stage changes and retry.",
+                    nextAction: {
+                        command: "git status --short",
+                        reason: "inspect staged/unstaged changes before commit",
+                        reasonCode: "git_index_state",
+                    },
+                });
+            }
+            return withExplicit({
+                hint: "Check git repo context; pass --root <path> if needed.",
+                nextAction: {
+                    command: "git status --short --untracked-files=no",
+                    reason: "confirm repository context and tracked changes",
+                    reasonCode: "git_context",
+                },
+            });
+        }
+        case "E_HANDOFF": {
+            return withExplicit({
+                hint: "This is an intentional handoff route, not a local mutation failure.",
+                nextAction: {
+                    command: command === "integrate" ? "agentplane task handoff show <task-id>" : usage,
+                    reason: "inspect the persisted finalize route and continue through the external handoff path",
+                    reasonCode: "protected_base_integrate_handoff",
+                },
+            });
+        }
+        case "E_NETWORK": {
+            return withExplicit({
+                hint: "Check network access and credentials.",
+                nextAction: {
+                    command: "agentplane preflight --json",
+                    reason: "recheck approvals and network requirements",
+                    reasonCode: "network_gate",
+                },
+            });
+        }
+        case "E_RUNTIME": {
+            return withExplicit({
+                hint: "Inspect runner artifacts and the external runner result before retrying.",
+                nextAction: {
+                    command: "agentplane doctor",
+                    reason: "confirm runtime wiring and recent runner state before rerunning the command",
+                    reasonCode: "runtime_runner_state",
+                },
+            });
+        }
+        case "E_BACKEND": {
+            if (command?.includes("sync")) {
+                return withExplicit({
+                    hint: "Check backend config under .agentplane/backends and retry.",
+                    nextAction: {
+                        command: "agentplane config show",
+                        reason: "verify backend config path and active settings",
+                        reasonCode: "backend_sync_config",
+                    },
+                });
+            }
+            return withExplicit({
+                hint: "Check backend config under .agentplane/backends.",
+                nextAction: {
+                    command: "agentplane config show",
+                    reason: "inspect backend configuration",
+                    reasonCode: "backend_config",
+                },
+            });
+        }
+        case "E_VALIDATION": {
+            if (reasonCode === "reconcile_task_scan_failed" ||
+                reasonCode === "reconcile_task_scan_incomplete") {
+                return withExplicit({
+                    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,
+                    },
+                });
+            }
+            return withExplicit({
+                hint: "Fix invalid config/input shape and rerun.",
+                nextAction: {
+                    command: "agentplane preflight --json",
+                    reason: "pinpoint validation failure in one report",
+                    reasonCode: "validation_preflight",
+                },
+            });
+        }
+        default: {
+            return withExplicit({});
+        }
+    }
+}

package/dist/cli/exit-codes.d.ts

@@ -1,3 +1,15 @@
-import type { ErrorCode } from "../shared/errors.js";
-export declare function exitCodeForError(code: ErrorCode): number;
+import { type ErrorCode } from "../shared/errors.js";
+export declare enum ExitCode {
+    Internal = 1,
+    Usage = 2,
+    Validation = 3,
+    Io = 4,
+    Git = 5,
+    Backend = 6,
+    Network = 7,
+    Runtime = 8,
+    Handoff = 9
+}
+export declare const ERROR_TO_EXIT: Readonly<Record<ErrorCode, ExitCode>>;
+export declare function exitCodeForError(code: ErrorCode): ExitCode;
 //# sourceMappingURL=exit-codes.d.ts.map

package/dist/cli/exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAExD"}
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE/E,oBAAY,QAAQ;IAClB,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,UAAU,IAAI;IACd,EAAE,IAAI;IACN,GAAG,IAAI;IACP,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;CACZ;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAU/D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAE1D"}

package/dist/cli/exit-codes.js

@@ -1,14 +1,27 @@
-const EXIT_CODE_BY_ERROR = {
-    E_USAGE: 2,
-    E_VALIDATION: 3,
-    E_IO: 4,
-    E_GIT: 5,
-    E_BACKEND: 6,
-    E_NETWORK: 7,
-    E_RUNTIME: 8,
-    E_HANDOFF: 9,
-    E_INTERNAL: 1,
+import { DEFAULT_ERROR_EXIT_CODES } from "../shared/errors.js";
+export var ExitCode;
+(function (ExitCode) {
+    ExitCode[ExitCode["Internal"] = 1] = "Internal";
+    ExitCode[ExitCode["Usage"] = 2] = "Usage";
+    ExitCode[ExitCode["Validation"] = 3] = "Validation";
+    ExitCode[ExitCode["Io"] = 4] = "Io";
+    ExitCode[ExitCode["Git"] = 5] = "Git";
+    ExitCode[ExitCode["Backend"] = 6] = "Backend";
+    ExitCode[ExitCode["Network"] = 7] = "Network";
+    ExitCode[ExitCode["Runtime"] = 8] = "Runtime";
+    ExitCode[ExitCode["Handoff"] = 9] = "Handoff";
+})(ExitCode || (ExitCode = {}));
+export const ERROR_TO_EXIT = {
+    E_USAGE: DEFAULT_ERROR_EXIT_CODES.E_USAGE,
+    E_VALIDATION: DEFAULT_ERROR_EXIT_CODES.E_VALIDATION,
+    E_IO: DEFAULT_ERROR_EXIT_CODES.E_IO,
+    E_GIT: DEFAULT_ERROR_EXIT_CODES.E_GIT,
+    E_BACKEND: DEFAULT_ERROR_EXIT_CODES.E_BACKEND,
+    E_NETWORK: DEFAULT_ERROR_EXIT_CODES.E_NETWORK,
+    E_RUNTIME: DEFAULT_ERROR_EXIT_CODES.E_RUNTIME,
+    E_HANDOFF: DEFAULT_ERROR_EXIT_CODES.E_HANDOFF,
+    E_INTERNAL: DEFAULT_ERROR_EXIT_CODES.E_INTERNAL,
 };
 export function exitCodeForError(code) {
-    return EXIT_CODE_BY_ERROR[code];
+    return ERROR_TO_EXIT[code];
 }

package/dist/cli/output.d.ts

@@ -1,3 +1,4 @@
+import { type Logger, type LoggerMode } from "@agentplaneorg/core";
 export type CliOutputWriter = {
     write: (chunk: string) => unknown;
 };
@@ -68,6 +69,8 @@ export declare function workflowModeMessage(actual: string | undefined, expected
 export declare function createCliEmitter(streams?: {
     stdout?: CliOutputWriter;
     stderr?: CliOutputWriter;
+    loggerMode?: LoggerMode;
+    logger?: Logger;
 }): CliEmitter;
 export declare function emitCommandResult(emitter: CliEmitter, result: CommandResult): void;
 export declare function emitCommandResults(emitter: CliEmitter, results: Iterable<CommandResult>): void;

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

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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"}

package/dist/cli/output.js

@@ -1,3 +1,4 @@
+import { createLogger } from "@agentplaneorg/core";
 function ensureTrailingNewline(text) {
     return text.endsWith("\n") ? text : `${text}\n`;
 }
@@ -8,12 +9,6 @@ function renderReportLine(entry) {
         return `${entry.label}:`;
     return `${entry.label}: ${String(entry.value)}`;
 }
-function resolveWriter(stdout, stderr, stream) {
-    return stream === "stderr" ? stderr : stdout;
-}
-function writeChunk(writer, text) {
-    writer.write(text);
-}
 export function successMessage(action, target, details) {
     const base = target ? `${action} ${target}` : action;
     const suffix = details ? ` (${details})` : "";
@@ -86,23 +81,31 @@ function renderJsonSectionBlock(label, value, indent) {
 export function createCliEmitter(streams) {
     const stdout = streams?.stdout ?? process.stdout;
     const stderr = streams?.stderr ?? process.stderr;
+    const logger = streams?.logger ?? createLogger({ mode: streams?.loggerMode, stdout, stderr });
     const line = (text, stream = "stdout") => {
-        writeChunk(resolveWriter(stdout, stderr, stream), renderTextLine(text));
+        logger.write({ kind: "line", text, stream });
     };
     const lines = (values, stream = "stdout") => {
-        writeChunk(resolveWriter(stdout, stderr, stream), renderTextLines(values));
+        for (const value of values) {
+            logger.write({ kind: "line", text: value, stream });
+        }
     };
     const json = (value, stream = "stdout") => {
-        line(renderPrettyJson(value), stream);
+        logger.write({ kind: "json", value, stream });
     };
     const jsonSection = (label, value, options) => {
         const block = renderJsonSectionBlock(label, value, options?.indent ?? "  ");
         if (!block)
             return;
-        writeChunk(resolveWriter(stdout, stderr, options?.stream ?? "stdout"), block);
+        for (const valueLine of block.trimEnd().split("\n")) {
+            logger.write({ kind: "line", text: valueLine, stream: options?.stream ?? "stdout" });
+        }
     };
     const report = (entries, options) => {
-        writeChunk(resolveWriter(stdout, stderr, options?.stream ?? "stdout"), renderReportBlock(entries, options));
+        const block = renderReportBlock(entries, options);
+        for (const valueLine of block.trimEnd().split("\n")) {
+            logger.write({ kind: "line", text: valueLine, stream: options?.stream ?? "stdout" });
+        }
     };
     return {
         line,
@@ -111,13 +114,21 @@ export function createCliEmitter(streams) {
         jsonSection,
         report,
         info: (message, stream = "stdout") => {
-            line(infoMessage(message), stream);
+            logger.write({ kind: "event", level: "info", message: infoMessage(message), stream });
         },
         warn: (message, stream = "stderr") => {
-            line(warnMessage(message), stream);
+            logger.write({ kind: "event", level: "warn", message: warnMessage(message), stream });
         },
         success: (action, target, details, stream = "stdout") => {
-            line(successMessage(action, target, details), stream);
+            logger.write({
+                kind: "event",
+                level: "success",
+                message: successMessage(action, target, details),
+                stream,
+                action,
+                target,
+                details,
+            });
         },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjE"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAkBA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBzF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAejE"}

package/dist/cli/prompts.js

@@ -1,5 +1,28 @@
 import { createInterface } from "node:readline/promises";
+function shouldUseClackPrompts() {
+    return (process.env.AGENTPLANE_PROMPTS !== "plain" &&
+        process.stdin.isTTY === true &&
+        process.stdout.isTTY === true);
+}
+async function loadClackPrompts() {
+    if (!shouldUseClackPrompts())
+        return null;
+    return await import("@clack/prompts");
+}
 export async function promptChoice(prompt, choices, defaultValue) {
+    const clack = await loadClackPrompts();
+    if (clack) {
+        const answer = await clack.select({
+            message: prompt,
+            options: choices.map((value) => ({ value, label: value })),
+            initialValue: defaultValue,
+        });
+        if (clack.isCancel(answer)) {
+            clack.cancel("Prompt cancelled; using default.");
+            return defaultValue;
+        }
+        return String(answer);
+    }
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     const question = `${prompt} [${choices.join("/")}] (default ${defaultValue}): `;
     const answer = await rl.question(question);
@@ -14,6 +37,18 @@ export async function promptChoice(prompt, choices, defaultValue) {
     return trimmed;
 }
 export async function promptYesNo(prompt, defaultValue) {
+    const clack = await loadClackPrompts();
+    if (clack) {
+        const answer = await clack.confirm({
+            message: prompt,
+            initialValue: defaultValue,
+        });
+        if (clack.isCancel(answer)) {
+            clack.cancel("Prompt cancelled; using default.");
+            return defaultValue;
+        }
+        return answer;
+    }
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     const question = `${prompt} [${defaultValue ? "Y/n" : "y/N"}]: `;
     const answer = await rl.question(question);
@@ -28,6 +63,15 @@ export async function promptYesNo(prompt, defaultValue) {
     return defaultValue;
 }
 export async function promptInput(prompt) {
+    const clack = await loadClackPrompts();
+    if (clack) {
+        const answer = await clack.text({ message: prompt });
+        if (clack.isCancel(answer)) {
+            clack.cancel("Prompt cancelled.");
+            return "";
+        }
+        return answer.trim();
+    }
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     const answer = await rl.question(prompt);
     rl.close();

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/core.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,6bAmMkB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/core.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AA8BhE,eAAO,MAAM,aAAa,6bAoDkB,CAAC"}