agentplane 0.2.6 → 0.2.13

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

@@ -0,0 +1,48 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { writeTextIfChanged } from "../../../../shared/write-if-changed.js";
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+const RUNTIME_IGNORE_LINES = [
+    "# agentplane: ignore runtime/transient workspace artifacts",
+    ".agentplane/worktrees",
+    ".agentplane/cache",
+    ".agentplane/recipes-cache",
+    ".agentplane/.upgrade",
+    ".agentplane/.release",
+    ".agentplane/upgrade",
+    ".agentplane/tasks.json",
+];
+const AGENT_PROMPT_IGNORE_LINES = [
+    "# agentplane: ignore local agent prompts/templates",
+    "AGENTS.md",
+    ".agentplane/agents/",
+];
+export async function ensureInitGitignore(opts) {
+    const gitignorePath = path.join(opts.gitRoot, ".gitignore");
+    const existing = (await readTextIfExists(gitignorePath)) ?? "";
+    const ensuredLines = opts.includeAgentPromptFiles
+        ? [...RUNTIME_IGNORE_LINES, ...AGENT_PROMPT_IGNORE_LINES]
+        : [...RUNTIME_IGNORE_LINES];
+    const existingLines = existing.split(/\r?\n/);
+    const existingSet = new Set(existingLines.map((line) => line.trimEnd()));
+    const missing = ensuredLines.filter((line) => !existingSet.has(line));
+    if (missing.length === 0)
+        return;
+    const nextLines = [...existingLines];
+    // Keep content stable and append a trailing newline.
+    if (nextLines.length > 0 && nextLines.at(-1) !== "")
+        nextLines.push("");
+    nextLines.push(...missing, "");
+    const nextText = `${nextLines.join("\n")}`.replaceAll(/\n{2,}$/g, "\n");
+    await writeTextIfChanged(gitignorePath, nextText);
+}

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

@@ -4,6 +4,7 @@ type InitFlags = {
     workflow?: "direct" | "branch_pr";
     backend?: "local" | "redmine";
     hooks?: boolean;
+    gitignoreAgents?: boolean;
     requirePlanApproval?: boolean;
     requireNetworkApproval?: boolean;
     requireVerifyApproval?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAatE,KAAK,SAAS,GAAG;IACf,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAsBF,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CA0I5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAetE,KAAK,SAAS,GAAG;IACf,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAsBF,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAsJ5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

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

@@ -7,6 +7,7 @@ import { usageError } from "../../spec/errors.js";
 import { CliError } from "../../../shared/errors.js";
 import { getVersion } from "../../../meta/version.js";
 import { cmdHooksInstall, ensureInitCommit } from "../../../commands/workflow.js";
+import { setPinnedBaseBranch } from "@agentplaneorg/core";
 import { resolveInitBaseBranchForInit } from "./init/base-branch.js";
 import { collectInitConflicts, handleInitConflicts } from "./init/conflicts.js";
 import { ensureGitRoot } from "./init/git.js";
@@ -14,6 +15,7 @@ import { maybeSyncIde } from "./init/ide-sync.js";
 import { maybeInstallBundledRecipes } from "./init/recipes.js";
 import { ensureAgentplaneDirs, writeBackendStubs, writeInitConfig } from "./init/write-config.js";
 import { ensureAgentsFiles } from "./init/write-agents.js";
+import { ensureInitGitignore } from "./init/write-gitignore.js";
 function parseBooleanValueForInit(flag, value) {
     const normalized = value.trim().toLowerCase();
     if (["1", "true", "yes", "y", "on"].includes(normalized))
@@ -39,7 +41,7 @@ export const initSpec = {
     id: ["init"],
     group: "Setup",
     summary: "Initialize agentplane project files under .agentplane/.",
-    description: "Creates .agentplane/ config, backend stubs, and agent templates in the target directory. If the target directory is not a git repository, it initializes one and writes an initial install commit. In interactive mode it prompts for missing inputs; use --yes for non-interactive mode.",
+    description: "Creates .agentplane/ config, backend stubs, and agent templates in the target directory. If the target directory is not a git repository, it initializes one and (by default) writes an initial install commit. Use --gitignore-agents to keep agent templates local (gitignored) and skip the install commit. In interactive mode it prompts for missing inputs; use --yes for non-interactive mode.",
     options: [
         {
             kind: "string",
@@ -112,6 +114,12 @@ export const initSpec = {
             default: false,
             description: "Non-interactive mode (do not prompt; use defaults for missing flags).",
         },
+        {
+            kind: "boolean",
+            name: "gitignore-agents",
+            default: false,
+            description: "Add agent files (AGENTS.md and .agentplane/agents/) to .gitignore and skip the initial install commit.",
+        },
     ],
     examples: [
         { cmd: "agentplane init", why: "Interactive setup (prompts for missing values)." },
@@ -123,6 +131,10 @@ export const initSpec = {
             cmd: "agentplane init --force --yes",
             why: "Re-initialize, overwriting conflicts (non-interactive).",
         },
+        {
+            cmd: "agentplane init --yes --gitignore-agents",
+            why: "Initialize without committing and keep agent prompts/templates local (gitignored).",
+        },
     ],
     validateRaw: (raw) => {
         if (raw.extra.length > 0) {
@@ -157,6 +169,7 @@ export const initSpec = {
             force: raw.opts.force === true,
             backup: raw.opts.backup === true,
             yes: raw.opts.yes === true,
+            gitignoreAgents: raw.opts["gitignore-agents"] === true,
         };
     },
     validate: (p) => {
@@ -299,6 +312,17 @@ async function cmdInit(opts) {
             configPathAbs: configPath,
             backendPathAbs: backendPath,
         });
+        await ensureInitGitignore({
+            gitRoot: resolved.gitRoot,
+            includeAgentPromptFiles: flags.gitignoreAgents === true,
+        });
+        if (flags.gitignoreAgents) {
+            await setPinnedBaseBranch({
+                cwd: resolved.gitRoot,
+                rootOverride: resolved.gitRoot,
+                value: initBaseBranch,
+            });
+        }
         if (hooks) {
             await cmdHooksInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, quiet: true });
         }
@@ -310,13 +334,15 @@ async function cmdInit(opts) {
         });
         installPaths.push(...ideRes.installPaths);
         maybeInstallBundledRecipes(recipes);
-        await ensureInitCommit({
-            gitRoot: resolved.gitRoot,
-            baseBranch: initBaseBranch,
-            installPaths,
-            version: getVersion(),
-            skipHooks: hooks,
-        });
+        if (!flags.gitignoreAgents) {
+            await ensureInitCommit({
+                gitRoot: resolved.gitRoot,
+                baseBranch: initBaseBranch,
+                installPaths,
+                version: getVersion(),
+                skipHooks: hooks,
+            });
+        }
         process.stdout.write(`${path.relative(resolved.gitRoot, resolved.agentplaneDir)}\n`);
         return 0;
     }

package/dist/cli/run-cli/commands/wrap-command.d.ts

@@ -0,0 +1,6 @@
+export declare function wrapCommand<T>(opts: {
+    command: string;
+    rootOverride?: string;
+    context?: Record<string, unknown>;
+}, fn: () => Promise<T> | T): Promise<T>;
+//# sourceMappingURL=wrap-command.d.ts.map

package/dist/cli/run-cli/commands/wrap-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/wrap-command.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,EACD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/cli/run-cli/commands/wrap-command.js

@@ -0,0 +1,17 @@
+import { mapCoreError } from "../../error-map.js";
+import { CliError } from "../../../shared/errors.js";
+export async function wrapCommand(opts, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        const context = opts.context ?? {};
+        throw mapCoreError(err, {
+            command: opts.command,
+            root: opts.rootOverride ?? null,
+            ...context,
+        });
+    }
+}

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

@@ -1,4 +1,8 @@
 import { CommandRegistry } from "../spec/registry.js";
-import type { CommandContext } from "../../commands/shared/task-backend.js";
-export declare function buildRegistry(getCtx: (commandForErrorContext: string) => Promise<CommandContext>): CommandRegistry;
+import { type RunDeps } from "./command-catalog.js";
+export declare function buildRegistry(opts: {
+    getCtx: RunDeps["getCtx"];
+    getResolvedProject: RunDeps["getResolvedProject"];
+    getLoadedConfig: RunDeps["getLoadedConfig"];
+}): CommandRegistry;
 //# sourceMappingURL=registry.run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.run.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/registry.run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,eAAe,CAcjB"}
+{"version":3,"file":"registry.run.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/registry.run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE9D,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClD,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7C,GAAG,eAAe,CAmBlB"}

package/dist/cli/run-cli/registry.run.js

@@ -2,10 +2,15 @@ import { CommandRegistry } from "../spec/registry.js";
 import { helpSpec, makeHelpHandler } from "../spec/help.js";
 import { makeHelpJsonFromSpecs } from "../../commands/docs/cli.command.js";
 import { COMMANDS } from "./command-catalog.js";
-export function buildRegistry(getCtx) {
+export function buildRegistry(opts) {
     const registry = new CommandRegistry();
     const getHelpJsonForDocs = () => makeHelpJsonFromSpecs(registry.list().map((e) => e.spec));
-    const deps = { getCtx, getHelpJsonForDocs };
+    const deps = {
+        getCtx: opts.getCtx,
+        getResolvedProject: opts.getResolvedProject,
+        getLoadedConfig: opts.getLoadedConfig,
+        getHelpJsonForDocs,
+    };
     for (const entry of COMMANDS) {
         let loaded = null;
         registry.register(entry.spec, async (ctx, parsed) => {

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":"AAwVA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoI5D"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAmWA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuK5D"}

package/dist/cli/run-cli.js

@@ -1,6 +1,6 @@
 import os from "node:os";
 import path from "node:path";
-import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { loadConfig, resolveProject, } from "@agentplaneorg/core";
 import { mapCoreError } from "./error-map.js";
 import { exitCodeForError } from "./exit-codes.js";
 import { warnMessage } from "./output.js";
@@ -14,43 +14,35 @@ 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";
+const GLOBAL_FLAGS = [
+    { key: "help", forms: ["--help", "-h"], takesValue: false, scoped: false },
+    { key: "version", forms: ["--version", "-v"], takesValue: false, scoped: false },
+    { key: "noUpdateCheck", forms: ["--no-update-check"], takesValue: false, scoped: false },
+    { key: "allowNetwork", forms: ["--allow-network"], takesValue: false, scoped: true },
+    { key: "jsonErrors", forms: ["--json-errors"], takesValue: false, scoped: true },
+    { key: "root", forms: ["--root"], takesValue: true, scoped: false },
+];
+const GLOBAL_FLAG_FORMS = new Map(GLOBAL_FLAGS.flatMap((def) => def.forms.map((form) => [form, def])));
 function prescanJsonErrors(argv) {
     // If parseGlobalArgs throws (e.g. missing --root value), we still want to honor
-    // `--json` in the "scoped global" zone (before the command id).
+    // `--json-errors` in the "scoped global" zone (before the command id).
     let hasRest = false;
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
         if (!arg)
             continue;
-        // Global flags that do not accept values.
-        if (arg === "--help" || arg === "-h")
-            continue;
-        if (arg === "--version" || arg === "-v")
-            continue;
-        if (arg === "--no-update-check")
-            continue;
-        if (arg === "--allow-network")
-            continue;
-        // Scoped global: only before the command id.
-        if (arg === "--json-errors") {
-            if (!hasRest)
-                return true;
-            continue;
-        }
-        if (arg === "--json") {
-            if (!hasRest)
-                return true;
-            continue;
+        const def = GLOBAL_FLAG_FORMS.get(arg);
+        if (!def) {
+            // First non-global token is treated as the start of the command id.
+            hasRest = true;
+            break;
         }
-        // Global flags with values.
-        if (arg === "--root") {
+        if (def.key === "jsonErrors" && !hasRest)
+            return true;
+        if (def.takesValue) {
             // Skip the value if present; do not throw on missing value here.
             i++;
-            continue;
         }
-        // First non-global token is treated as the start of the command id.
-        hasRest = true;
-        break;
     }
     return false;
 }
@@ -66,61 +58,56 @@ function parseGlobalArgs(argv) {
         const arg = argv[i];
         if (!arg)
             continue;
-        if (arg === "--help" || arg === "-h") {
-            help = true;
-            continue;
-        }
-        if (arg === "--version" || arg === "-v") {
-            version = true;
+        const def = GLOBAL_FLAG_FORMS.get(arg);
+        if (!def) {
+            rest.push(arg);
             continue;
         }
-        if (arg === "--no-update-check") {
-            noUpdateCheck = true;
+        // Scoped globals are only recognized before the command id token.
+        if (def.scoped && rest.length > 0) {
+            rest.push(arg);
             continue;
         }
-        if (arg === "--allow-network") {
-            // Scoped global: only treat `--allow-network` as a global approval if it appears
-            // before the command id. This avoids accidental capture of command-specific flags.
-            if (rest.length === 0) {
+        switch (def.key) {
+            case "help": {
+                help = true;
+                break;
+            }
+            case "version": {
+                version = true;
+                break;
+            }
+            case "noUpdateCheck": {
+                noUpdateCheck = true;
+                break;
+            }
+            case "allowNetwork": {
                 allowNetwork = true;
-                continue;
+                break;
             }
-            rest.push(arg);
-            continue;
-        }
-        if (arg === "--json-errors") {
-            // Scoped global: only treat `--json-errors` as "JSON errors" if it appears
-            // before the command id. This mirrors the existing `--json` behavior.
-            if (rest.length === 0) {
+            case "jsonErrors": {
                 jsonErrors = true;
-                continue;
+                break;
             }
-            rest.push(arg);
-            continue;
-        }
-        if (arg === "--json") {
-            // Scoped global: only treat `--json` as "JSON errors" if it appears
-            // before the command id. This allows per-command `--json` (e.g. `help`).
-            if (rest.length === 0) {
-                jsonErrors = true;
-                continue;
+            case "root": {
+                const next = argv[i + 1];
+                if (!next) {
+                    throw new CliError({
+                        exitCode: 2,
+                        code: "E_USAGE",
+                        message: "Missing value after --root (expected repository path)",
+                    });
+                }
+                root = next;
+                i++;
+                break;
+            }
+            default: {
+                // Exhaustive by construction; keep a defensive fallback.
+                rest.push(arg);
+                break;
             }
-            rest.push(arg);
-            continue;
-        }
-        if (arg === "--root") {
-            const next = argv[i + 1];
-            if (!next)
-                throw new CliError({
-                    exitCode: 2,
-                    code: "E_USAGE",
-                    message: "Missing value after --root (expected repository path)",
-                });
-            root = next;
-            i++;
-            continue;
         }
-        rest.push(arg);
     }
     return { globals: { help, version, noUpdateCheck, root, jsonErrors, allowNetwork }, rest };
 }
@@ -318,7 +305,12 @@ export async function runCli(argv) {
         }
         const runCli2HelpFast = async (helpArgv) => {
             const { buildRegistry } = await import("./run-cli/registry.run.js");
-            const registry = buildRegistry((_cmd) => Promise.reject(new Error("getCtx should not be called for help")));
+            const reject = (name) => (_cmd) => Promise.reject(new Error(`${name} should not be called for help`));
+            const registry = buildRegistry({
+                getCtx: reject("getCtx"),
+                getResolvedProject: reject("getResolvedProject"),
+                getLoadedConfig: reject("getLoadedConfig"),
+            });
             const match = registry.match(helpArgv);
             if (!match) {
                 throw new CliError({
@@ -352,12 +344,37 @@ export async function runCli(argv) {
         if (resolved) {
             await loadDotEnv(resolved.gitRoot);
         }
+        let projectPromise = resolved
+            ? Promise.resolve(resolved)
+            : null;
+        const getResolvedProject = async (commandForErrorContext) => {
+            projectPromise ??= resolveProject({ cwd, rootOverride: globals.root ?? null });
+            try {
+                return await projectPromise;
+            }
+            catch (err) {
+                throw mapCoreError(err, { command: commandForErrorContext, root: globals.root ?? null });
+            }
+        };
+        let configPromise = null;
+        const getLoadedConfig = async (commandForErrorContext) => {
+            configPromise ??= (async () => {
+                const project = await getResolvedProject(commandForErrorContext);
+                return await loadConfig(project.agentplaneDir);
+            })();
+            try {
+                return await configPromise;
+            }
+            catch (err) {
+                throw mapCoreError(err, { command: commandForErrorContext, root: globals.root ?? null });
+            }
+        };
         // `require_network=true` means "no network without explicit approval".
         // Update-check is an optional network call, so it must be gated after config load.
         let skipUpdateCheckForPolicy = true;
         if (resolved && matched?.entry.needsConfig !== false) {
             try {
-                const loaded = await loadConfig(resolved.agentplaneDir);
+                const loaded = await getLoadedConfig("update-check");
                 const requireNetwork = loaded.config.agents?.approvals.require_network === true;
                 const explicitlyApproved = globals.allowNetwork;
                 skipUpdateCheckForPolicy = requireNetwork && !explicitlyApproved;
@@ -394,7 +411,11 @@ export async function runCli(argv) {
         };
         // cli2 command routing (single router).
         const { buildRegistry } = await import("./run-cli/registry.run.js");
-        const registry = buildRegistry(getCtxOrThrow);
+        const registry = buildRegistry({
+            getCtx: getCtxOrThrow,
+            getResolvedProject,
+            getLoadedConfig,
+        });
         const match = registry.match(rest);
         if (match) {
             const tail = rest.slice(match.consumed);

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

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

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

@@ -5,6 +5,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
+import { gzipSync } from "node:zlib";
 import { afterAll, beforeAll } from "vitest";
 import { defaultConfig } from "@agentplaneorg/core";
 import { runCli } from "./run-cli.js";
@@ -12,6 +13,10 @@ const execFileAsync = promisify(execFile);
 let agentplaneHome = null;
 const originalAgentplaneHome = process.env.AGENTPLANE_HOME;
 const originalNoUpdateCheck = process.env.AGENTPLANE_NO_UPDATE_CHECK;
+const originalGitAuthorName = process.env.GIT_AUTHOR_NAME;
+const originalGitAuthorEmail = process.env.GIT_AUTHOR_EMAIL;
+const originalGitCommitterName = process.env.GIT_COMMITTER_NAME;
+const originalGitCommitterEmail = process.env.GIT_COMMITTER_EMAIL;
 const originalStdoutWrite = process.stdout.write.bind(process.stdout);
 const originalStderrWrite = process.stderr.write.bind(process.stderr);
 let stdioSilenceDepth = 0;
@@ -24,6 +29,12 @@ async function ensureGitTemplateRoot() {
     gitTemplatePromise ??= (async () => {
         const root = await mkdtemp(path.join(os.tmpdir(), "agentplane-git-template-"));
         await execFileAsync("git", ["init", "-q"], { cwd: root });
+        // Tests must not rely on global git config. Configure author identity locally
+        // so any helper that creates commits works in CI.
+        await execFileAsync("git", ["config", "user.email", "agentplane-test@example.com"], {
+            cwd: root,
+        });
+        await execFileAsync("git", ["config", "user.name", "agentplane-test"], { cwd: root });
         return root;
     })();
     gitTemplateRoot = await gitTemplatePromise;
@@ -38,6 +49,11 @@ export function registerAgentplaneHome() {
         agentplaneHome = await mkdtemp(path.join(os.tmpdir(), "agentplane-home-"));
         process.env.AGENTPLANE_HOME = agentplaneHome;
         process.env.AGENTPLANE_NO_UPDATE_CHECK = "1";
+        // Keep tests hermetic: never rely on global git config for commit authorship.
+        process.env.GIT_AUTHOR_NAME ??= "agentplane-test";
+        process.env.GIT_AUTHOR_EMAIL ??= "agentplane-test@example.com";
+        process.env.GIT_COMMITTER_NAME ??= "agentplane-test";
+        process.env.GIT_COMMITTER_EMAIL ??= "agentplane-test@example.com";
     });
     afterAll(async () => {
         if (agentplaneHome) {
@@ -55,6 +71,22 @@ export function registerAgentplaneHome() {
         else {
             process.env.AGENTPLANE_NO_UPDATE_CHECK = originalNoUpdateCheck;
         }
+        if (originalGitAuthorName === undefined)
+            delete process.env.GIT_AUTHOR_NAME;
+        else
+            process.env.GIT_AUTHOR_NAME = originalGitAuthorName;
+        if (originalGitAuthorEmail === undefined)
+            delete process.env.GIT_AUTHOR_EMAIL;
+        else
+            process.env.GIT_AUTHOR_EMAIL = originalGitAuthorEmail;
+        if (originalGitCommitterName === undefined)
+            delete process.env.GIT_COMMITTER_NAME;
+        else
+            process.env.GIT_COMMITTER_NAME = originalGitCommitterName;
+        if (originalGitCommitterEmail === undefined)
+            delete process.env.GIT_COMMITTER_EMAIL;
+        else
+            process.env.GIT_COMMITTER_EMAIL = originalGitCommitterEmail;
     });
 }
 export function getAgentplaneHome() {
@@ -278,11 +310,75 @@ export async function createUnsafeRecipeArchive(opts) {
     const entryPath = opts.entryPath ?? "../evil.txt";
     await writeFile(path.join(baseDir, "evil.txt"), "evil", "utf8");
     const archivePath = opts.format === "zip" ? path.join(baseDir, "unsafe.zip") : path.join(baseDir, "unsafe.tar.gz");
-    await (opts.format === "zip"
-        ? execFileAsync("zip", ["-qr", archivePath, ".", entryPath], { cwd: recipeDir })
-        : execFileAsync("tar", ["-czf", archivePath, "-C", recipeDir, ".", entryPath]));
+    if (opts.format === "zip") {
+        await execFileAsync("zip", ["-qr", archivePath, ".", entryPath], { cwd: recipeDir });
+        return archivePath;
+    }
+    // Build a deterministic tar.gz containing a traversal entry, without relying on system tar behavior.
+    // This keeps the archive validation tests stable across GNU tar / bsdtar.
+    const tar = buildTar([
+        {
+            name: "./manifest.json",
+            data: Buffer.from(JSON.stringify(manifest, null, 2) + "\n", "utf8"),
+        },
+        { name: entryPath, data: Buffer.from("evil\n", "utf8") },
+    ]);
+    const gz = gzipSync(tar);
+    await writeFile(archivePath, gz);
     return archivePath;
 }
+function buildTar(entries) {
+    const out = [];
+    for (const ent of entries) {
+        const header = tarHeader({
+            name: ent.name,
+            size: ent.data.length,
+            mtime: 0,
+            typeflag: "0",
+        });
+        out.push(header, ent.data, zeroPadTo512(ent.data.length));
+    }
+    // Two empty blocks mark end-of-archive.
+    out.push(Buffer.alloc(1024, 0));
+    return Buffer.concat(out);
+}
+function zeroPadTo512(n) {
+    const rem = n % 512;
+    if (rem === 0)
+        return Buffer.alloc(0);
+    return Buffer.alloc(512 - rem, 0);
+}
+function tarHeader(opts) {
+    const buf = Buffer.alloc(512, 0);
+    writeTarString(buf, 0, 100, opts.name);
+    writeTarOctal(buf, 100, 8, 0o644); // mode
+    writeTarOctal(buf, 108, 8, 0); // uid
+    writeTarOctal(buf, 116, 8, 0); // gid
+    writeTarOctal(buf, 124, 12, opts.size);
+    writeTarOctal(buf, 136, 12, opts.mtime);
+    // checksum field must be treated as spaces for calculation
+    buf.fill(0x20, 148, 156);
+    writeTarString(buf, 156, 1, opts.typeflag);
+    writeTarString(buf, 257, 6, "ustar"); // magic
+    writeTarString(buf, 263, 2, "00"); // version
+    const sum = buf.reduce((acc, b) => acc + b, 0);
+    writeTarChecksum(buf, sum);
+    return buf;
+}
+function writeTarString(buf, offset, length, value) {
+    const b = Buffer.from(value, "utf8");
+    b.copy(buf, offset, 0, Math.min(length, b.length));
+}
+function writeTarOctal(buf, offset, length, value) {
+    const raw = Math.max(0, value).toString(8);
+    const padded = raw.padStart(length - 1, "0") + "\0";
+    writeTarString(buf, offset, length, padded);
+}
+function writeTarChecksum(buf, sum) {
+    // 6 digits, NUL, space (common convention).
+    const raw = Math.max(0, sum).toString(8).padStart(6, "0");
+    writeTarString(buf, 148, 8, `${raw}\0 `);
+}
 export async function createUpgradeBundle(files) {
     const manifestUrl = new URL("../../assets/framework.manifest.json", import.meta.url);
     const manifestText = typeof files["framework.manifest.json"] === "string"

package/dist/cli/spec/parse-utils.d.ts

@@ -0,0 +1,11 @@
+import type { CommandSpec } from "./spec.js";
+export declare function asTrimmedString(value: unknown): string;
+export declare function toStringList(value: unknown): string[];
+export declare function assertNonEmptyStrings(opts: {
+    list: readonly string[];
+    flagName: string;
+    spec: CommandSpec<unknown>;
+    command: string;
+    message?: string;
+}): void;
+//# sourceMappingURL=parse-utils.d.ts.map

package/dist/cli/spec/parse-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-utils.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/parse-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAGrD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAYP"}