agentplane 0.3.24 → 0.3.26

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

@@ -1,34 +0,0 @@
-import path from "node:path";
-import { readFile } from "node:fs/promises";
-import { AGENT_PROMPT_GITIGNORE_LINES, RUNTIME_GITIGNORE_LINES, } from "../../../../runtime/shared/runtime-artifacts.js";
-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;
-    }
-}
-export async function ensureInitGitignore(opts) {
-    const gitignorePath = path.join(opts.gitRoot, ".gitignore");
-    const existing = (await readTextIfExists(gitignorePath)) ?? "";
-    const ensuredLines = opts.includeAgentPromptFiles
-        ? [...RUNTIME_GITIGNORE_LINES, ...AGENT_PROMPT_GITIGNORE_LINES]
-        : [...RUNTIME_GITIGNORE_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/write-workflow.d.ts

@@ -1,12 +0,0 @@
-export declare function ensureInitWorkflow(opts: {
-    gitRoot: string;
-    workflowMode: "direct" | "branch_pr";
-    approvals: {
-        requirePlanApproval: boolean;
-        requireVerifyApproval: boolean;
-        requireNetworkApproval: boolean;
-    };
-}): Promise<{
-    installPaths: string[];
-}>;
-//# sourceMappingURL=write-workflow.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"write-workflow.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-workflow.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE;QACT,mBAAmB,EAAE,OAAO,CAAC;QAC7B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,sBAAsB,EAAE,OAAO,CAAC;KACjC,CAAC;CACH,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAOtC"}

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

@@ -1,9 +0,0 @@
-import { ensureWorkflowArtifacts } from "../../../../shared/workflow-artifacts.js";
-export async function ensureInitWorkflow(opts) {
-    const ensured = await ensureWorkflowArtifacts({
-        gitRoot: opts.gitRoot,
-        workflowMode: opts.workflowMode,
-        approvals: opts.approvals,
-    });
-    return { installPaths: ensured.installPaths };
-}

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

@@ -1,6 +0,0 @@
-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

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

@@ -1,17 +0,0 @@
-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/globals.d.ts

@@ -1,25 +0,0 @@
-import { CliError } from "../../shared/errors.js";
-export type ParsedArgs = {
-    help: boolean;
-    version: boolean;
-    noUpdateCheck: boolean;
-    root?: string;
-    jsonErrors: boolean;
-    allowNetwork: boolean;
-    outputMode?: "text" | "json";
-};
-export type CliOutputMode = "text" | "json";
-export type ParsedGlobalArgsResult = {
-    globals: ParsedArgs;
-    rest: string[];
-    jsonErrorMode: boolean;
-    error?: CliError;
-};
-export declare function parseGlobalArgs(argv: string[]): ParsedGlobalArgsResult;
-export declare function resolveOutputMode(modeFromFlag: "text" | "json" | undefined): CliOutputMode;
-export declare function runWithOutputMode(opts: {
-    mode: CliOutputMode;
-    command: string;
-    run: () => Promise<number>;
-}): Promise<number>;
-//# sourceMappingURL=globals.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/globals.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B,CAAC;AAgCF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAG5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAUF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAsFtE;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAU1F;AA0ED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlB"}

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

@@ -1,193 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { CliError } from "../../shared/errors.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: "outputMode", forms: ["--output"], takesValue: true, scoped: false },
-    { 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 OUTPUT_MODE_ENV = "AGENTPLANE_OUTPUT";
-function makeGlobalUsageError(message) {
-    return new CliError({
-        exitCode: 2,
-        code: "E_USAGE",
-        message,
-    });
-}
-export function parseGlobalArgs(argv) {
-    let help = false;
-    let version = false;
-    let noUpdateCheck = false;
-    let jsonErrors = false;
-    let root;
-    let allowNetwork = false;
-    let outputMode;
-    const rest = [];
-    const result = (error) => ({
-        globals: { help, version, noUpdateCheck, root, jsonErrors, allowNetwork, outputMode },
-        rest,
-        jsonErrorMode: jsonErrors || outputMode === "json",
-        ...(error ? { error } : {}),
-    });
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (!arg)
-            continue;
-        const def = GLOBAL_FLAG_FORMS.get(arg);
-        if (!def) {
-            rest.push(arg);
-            continue;
-        }
-        if (def.scoped && rest.length > 0) {
-            rest.push(arg);
-            continue;
-        }
-        switch (def.key) {
-            case "help": {
-                help = true;
-                break;
-            }
-            case "version": {
-                version = true;
-                break;
-            }
-            case "noUpdateCheck": {
-                noUpdateCheck = true;
-                break;
-            }
-            case "allowNetwork": {
-                allowNetwork = true;
-                break;
-            }
-            case "jsonErrors": {
-                jsonErrors = true;
-                break;
-            }
-            case "root": {
-                const next = argv[i + 1];
-                if (!next) {
-                    return result(makeGlobalUsageError("Missing value after --root (expected repository path)"));
-                }
-                root = next;
-                i++;
-                break;
-            }
-            case "outputMode": {
-                const next = argv[i + 1];
-                if (!next) {
-                    return result(makeGlobalUsageError("Missing value after --output (expected text|json)"));
-                }
-                const normalized = next.trim().toLowerCase();
-                if (normalized !== "text" && normalized !== "json") {
-                    return result(makeGlobalUsageError(`Invalid value for --output: ${next} (expected text|json)`));
-                }
-                outputMode = normalized;
-                i++;
-                break;
-            }
-            default: {
-                rest.push(arg);
-                break;
-            }
-        }
-    }
-    return result();
-}
-export function resolveOutputMode(modeFromFlag) {
-    if (modeFromFlag)
-        return modeFromFlag;
-    const fromEnv = process.env[OUTPUT_MODE_ENV]?.trim().toLowerCase();
-    if (!fromEnv || fromEnv === "text")
-        return "text";
-    if (fromEnv === "json")
-        return "json";
-    throw new CliError({
-        exitCode: 2,
-        code: "E_USAGE",
-        message: `Invalid ${OUTPUT_MODE_ENV}: ${fromEnv} (expected text|json)`,
-    });
-}
-function chunkToString(chunk, encoding) {
-    if (typeof chunk === "string")
-        return chunk;
-    if (chunk instanceof Uint8Array)
-        return Buffer.from(chunk).toString(encoding);
-    return String(chunk);
-}
-const structuredOutputStore = new AsyncLocalStorage();
-let passthroughStdoutWrite = process.stdout.write.bind(process.stdout);
-let passthroughStderrWrite = process.stderr.write.bind(process.stderr);
-function appendStructuredChunk(channel, chunk, rest) {
-    const store = structuredOutputStore.getStore();
-    if (!store)
-        return false;
-    const encoding = typeof rest[0] === "string" ? rest[0] : undefined;
-    store[channel].push(chunkToString(chunk, encoding));
-    const callback = rest.find((item) => typeof item === "function");
-    callback?.(null);
-    return true;
-}
-const structuredStdoutWrite = ((chunk, ...rest) => {
-    if (appendStructuredChunk("stdout", chunk, rest))
-        return true;
-    return passthroughStdoutWrite(chunk, ...rest);
-});
-const structuredStderrWrite = ((chunk, ...rest) => {
-    if (appendStructuredChunk("stderr", chunk, rest))
-        return true;
-    return passthroughStderrWrite(chunk, ...rest);
-});
-function ensureStructuredOutputProxyInstalled() {
-    if (process.stdout.write !== structuredStdoutWrite) {
-        passthroughStdoutWrite = process.stdout.write.bind(process.stdout);
-        process.stdout.write = structuredStdoutWrite;
-    }
-    if (process.stderr.write !== structuredStderrWrite) {
-        passthroughStderrWrite = process.stderr.write.bind(process.stderr);
-        process.stderr.write = structuredStderrWrite;
-    }
-}
-async function collectStructuredOutput(run) {
-    ensureStructuredOutputProxyInstalled();
-    return await structuredOutputStore.run({ stdout: [], stderr: [] }, async () => {
-        const exitCode = await run();
-        const store = structuredOutputStore.getStore();
-        return {
-            exitCode,
-            stdout: store?.stdout.join("").trim() ?? "",
-            stderr: store?.stderr.join("").trim() ?? "",
-        };
-    });
-}
-export async function runWithOutputMode(opts) {
-    if (opts.mode === "text")
-        return await opts.run();
-    const { exitCode, stdout, stderr } = await collectStructuredOutput(opts.run);
-    let parsed;
-    if (stdout.length > 0) {
-        try {
-            parsed = JSON.parse(stdout);
-        }
-        catch {
-            parsed = undefined;
-        }
-    }
-    const payload = {
-        schema_version: 1,
-        mode: "agent_json_v1",
-        command: opts.command,
-        ok: exitCode === 0,
-        exit_code: exitCode,
-        stdout,
-        stderr,
-    };
-    if (parsed !== undefined) {
-        payload.data = parsed;
-    }
-    passthroughStdoutWrite(`${JSON.stringify(payload, null, 2)}\n`);
-    return exitCode;
-}

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

@@ -1,8 +0,0 @@
-import { CommandRegistry } from "../spec/registry.js";
-import type { RunDeps } from "./command-catalog/kernel.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 +0,0 @@
-{"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;AAKtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE3D,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

@@ -1,24 +0,0 @@
-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(opts) {
-    const registry = new CommandRegistry();
-    const getHelpJsonForDocs = () => makeHelpJsonFromSpecs(registry.list().map((e) => e.spec));
-    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) => {
-            loaded ??= entry.load(deps);
-            const handler = await loaded;
-            return await handler(ctx, parsed);
-        });
-    }
-    registry.register(helpSpec, makeHelpHandler(registry));
-    return registry;
-}

package/dist/cli/run-cli/update-warning.d.ts

@@ -1,7 +0,0 @@
-export declare function resolveAgentplaneHome(): string;
-export declare function maybeWarnOnUpdate(opts: {
-    currentVersion: string;
-    skip: boolean;
-    jsonErrors: boolean;
-}): Promise<void>;
-//# sourceMappingURL=update-warning.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"update-warning.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/update-warning.ts"],"names":[],"mappings":"AAqBA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAQD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhB"}

package/dist/cli/run-cli/update-warning.js

@@ -1,72 +0,0 @@
-import os from "node:os";
-import path from "node:path";
-import { warnMessage } from "../output.js";
-import { fetchLatestNpmVersion, readUpdateCheckCache, resolveUpdateCheckCachePath, shouldCheckNow, UPDATE_CHECK_SCHEMA_VERSION, UPDATE_CHECK_TIMEOUT_MS, UPDATE_CHECK_TTL_MS, writeUpdateCheckCache, } from "../update-check.js";
-import { compareVersions } from "../../runtime/shared/version-compare.js";
-const UPDATE_CHECK_PACKAGE = "agentplane";
-const UPDATE_CHECK_URL = `https://registry.npmjs.org/${UPDATE_CHECK_PACKAGE}/latest`;
-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 isTruthyEnv(value) {
-    if (!value)
-        return false;
-    const normalized = value.trim().toLowerCase();
-    return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
-}
-export async function maybeWarnOnUpdate(opts) {
-    if (opts.skip || opts.jsonErrors)
-        return;
-    if (isTruthyEnv(process.env.AGENTPLANE_NO_UPDATE_CHECK))
-        return;
-    const now = new Date();
-    const cachePath = resolveUpdateCheckCachePath(resolveAgentplaneHome());
-    const cache = await readUpdateCheckCache(cachePath);
-    if (cache && !shouldCheckNow(cache.checked_at, now, UPDATE_CHECK_TTL_MS)) {
-        if (cache.status === "ok" &&
-            cache.latest_version &&
-            compareVersions(cache.latest_version, opts.currentVersion) > 0) {
-            const message = `Update available: ${UPDATE_CHECK_PACKAGE} ${opts.currentVersion} → ${cache.latest_version}. Run: npm i -g ${UPDATE_CHECK_PACKAGE}@latest`;
-            process.stderr.write(`${warnMessage(message)}\n`);
-        }
-        return;
-    }
-    const result = await fetchLatestNpmVersion({
-        url: UPDATE_CHECK_URL,
-        timeoutMs: UPDATE_CHECK_TIMEOUT_MS,
-        etag: cache?.etag ?? null,
-    });
-    const nextCache = {
-        schema_version: UPDATE_CHECK_SCHEMA_VERSION,
-        checked_at: now.toISOString(),
-        latest_version: cache?.latest_version ?? null,
-        etag: cache?.etag ?? null,
-        status: "error",
-    };
-    if (result.status === "ok") {
-        nextCache.status = "ok";
-        nextCache.latest_version = result.latestVersion;
-        nextCache.etag = result.etag;
-    }
-    else if (result.status === "not_modified") {
-        nextCache.status = "not_modified";
-        nextCache.etag = result.etag ?? nextCache.etag;
-    }
-    try {
-        await writeUpdateCheckCache(cachePath, nextCache);
-    }
-    catch {
-        // Best-effort cache: ignore write failures.
-    }
-    const latest = result.status === "ok" ? result.latestVersion : nextCache.latest_version;
-    if (!latest || result.status === "error")
-        return;
-    if (compareVersions(latest, opts.currentVersion) <= 0)
-        return;
-    const message = `Update available: ${UPDATE_CHECK_PACKAGE} ${opts.currentVersion} → ${latest}. Run: npm i -g ${UPDATE_CHECK_PACKAGE}@latest`;
-    process.stderr.write(`${warnMessage(message)}\n`);
-}

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

@@ -1,2 +0,0 @@
-export declare function runCli(argv: string[]): Promise<number>;
-//# sourceMappingURL=run-cli.d.ts.map

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

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