agentplane 0.3.15 → 0.3.17

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

@@ -1 +0,0 @@
-{"version":3,"file":"error-guidance.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/error-guidance.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AASF,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CA4CnE;AAID,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C"}

package/dist/cli/run-cli/error-guidance.js

@@ -1,210 +0,0 @@
-import os from "node:os";
-import path from "node:path";
-import { readDiagnosticContext } from "../../shared/diagnostics.js";
-import { formatJsonError } from "../../shared/errors.js";
-import { getReasonCodeMeta } from "../reason-codes.js";
-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`);
-    }
-    else {
-        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`);
-        }
-    }
-}
-const AGENTPLANE_HOME_ENV = "AGENTPLANE_HOME";
-export function resolveAgentplaneHome() {
-    const overridden = process.env[AGENTPLANE_HOME_ENV]?.trim();
-    if (overridden)
-        return overridden;
-    return path.join(os.homedir(), ".agentplane");
-}
-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/run-cli.test-helpers.d.ts

@@ -1,2 +0,0 @@
-export * from "../testing/index.js";
-//# sourceMappingURL=run-cli.test-helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"run-cli.test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.test-helpers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/cli/run-cli.test-helpers.js

@@ -1 +0,0 @@
-export * from "../testing/index.js";

package/dist/commands/recipes.test-helpers.d.ts

@@ -1,202 +0,0 @@
-export { captureStdIO, createRecipeArchive, mkGitRepoRoot, writeDefaultConfig, } from "../cli/run-cli.test-helpers.js";
-export declare function installRecipesCommandHarness(): void;
-export declare function requireRecipesTempHome(): string;
-export declare function signIndexPayload(indexText: string): {
-    schema_version: 1;
-    key_id: string;
-    signature: string;
-};
-export declare function writeSignedIndex(indexPath: string, payload: unknown): Promise<void>;
-export declare function resolveProjectRecipeDir(projectDir: string, recipeId: string): string;
-export declare function resolveProjectRecipesRegistryPath(projectDir: string): string;
-export declare function writeInstalledRecipes(projectDir: string, recipes: unknown[]): Promise<void>;
-export declare function writeInstalledRecipesRegistry(recipes: unknown[]): Promise<void>;
-export declare function skillEntry(overrides?: Partial<Record<string, unknown>>): {
-    id: string;
-    summary: string;
-    file: string;
-};
-export declare function toolEntry(overrides?: Partial<Record<string, unknown>>): {
-    id: string;
-    summary: string;
-    runtime: string;
-    entrypoint: string;
-};
-export declare function agentEntry(overrides?: Partial<Record<string, unknown>>): {
-    id: string;
-    display_name: string;
-    role: string;
-    summary: string;
-    skills: string[];
-    tools: string[];
-    file: string;
-};
-export declare function scenarioDescriptor(overrides?: Partial<Record<string, unknown>>): {
-    id: string;
-    name: string;
-    summary: string;
-    use_when: string[];
-    required_inputs: never[];
-    outputs: never[];
-    permissions: never[];
-    artifacts: never[];
-    agents_involved: string[];
-    skills_used: string[];
-    tools_used: string[];
-    run_profile: {
-        mode: string;
-    };
-    file: string;
-};
-export declare function baseRecipeManifest(overrides?: Partial<Record<string, unknown>>): {
-    schema_version: string;
-    id: string;
-    version: string;
-    name: string;
-    summary: string;
-    description: string;
-    tags: string[];
-    compatibility: {
-        min_agentplane_version: string;
-        manifest_api_version: string;
-        scenario_api_version: string;
-        runtime_api_version: string;
-        platforms: string[];
-        repo_types: string[];
-    };
-    skills: {
-        id: string;
-        summary: string;
-        file: string;
-    }[];
-    agents: {
-        id: string;
-        display_name: string;
-        role: string;
-        summary: string;
-        skills: string[];
-        tools: string[];
-        file: string;
-    }[];
-    tools: {
-        id: string;
-        summary: string;
-        runtime: string;
-        entrypoint: string;
-    }[];
-    scenarios: {
-        id: string;
-        name: string;
-        summary: string;
-        use_when: string[];
-        required_inputs: never[];
-        outputs: never[];
-        permissions: never[];
-        artifacts: never[];
-        agents_involved: string[];
-        skills_used: string[];
-        tools_used: string[];
-        run_profile: {
-            mode: string;
-        };
-        file: string;
-    }[];
-};
-export declare function baseRecipeEntry(overrides?: Partial<Record<string, unknown>>): {
-    id: string;
-    version: string;
-    source: string;
-    installed_at: string;
-    tags: string[];
-    manifest: {
-        schema_version: string;
-        id: string;
-        version: string;
-        name: string;
-        summary: string;
-        description: string;
-        tags: string[];
-        compatibility: {
-            min_agentplane_version: string;
-            manifest_api_version: string;
-            scenario_api_version: string;
-            runtime_api_version: string;
-            platforms: string[];
-            repo_types: string[];
-        };
-        skills: {
-            id: string;
-            summary: string;
-            file: string;
-        }[];
-        agents: {
-            id: string;
-            display_name: string;
-            role: string;
-            summary: string;
-            skills: string[];
-            tools: string[];
-            file: string;
-        }[];
-        tools: {
-            id: string;
-            summary: string;
-            runtime: string;
-            entrypoint: string;
-        }[];
-        scenarios: {
-            id: string;
-            name: string;
-            summary: string;
-            use_when: string[];
-            required_inputs: never[];
-            outputs: never[];
-            permissions: never[];
-            artifacts: never[];
-            agents_involved: string[];
-            skills_used: string[];
-            tools_used: string[];
-            run_profile: {
-                mode: string;
-            };
-            file: string;
-        }[];
-    };
-};
-export declare function installRecipe(opts: {
-    projectDir: string;
-    archivePath?: string;
-    tags?: string[];
-    vendor?: boolean;
-    mode?: "copy" | "link";
-}): Promise<void>;
-export declare function installRecipeFixture(opts: {
-    projectDir: string;
-    tags?: string[];
-}): Promise<{
-    archivePath: string;
-    manifest: Record<string, unknown>;
-    manifestId: string;
-}>;
-export declare function createInstalledRecipeProject(opts?: {
-    tags?: string[];
-}): Promise<{
-    projectDir: string;
-    archivePath: string;
-    manifest: Record<string, unknown>;
-    manifestId: string;
-}>;
-export declare function resolveInstalledScenarioPath(projectDir: string, recipeId: string, scenarioFile?: string): string;
-export declare function runRecipesTest(opts: {
-    cwd: string;
-    rootOverride?: string;
-    command: string | undefined;
-    args: string[];
-}): Promise<number>;
-export declare function runScenarioTest(opts: {
-    cwd: string;
-    rootOverride?: string;
-    command: string | undefined;
-    args: string[];
-}): Promise<number>;
-//# sourceMappingURL=recipes.test-helpers.d.ts.map

package/dist/commands/recipes.test-helpers.d.ts.map

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