agentplane 0.3.24 → 0.3.27

package/dist/commands/hooks/install.js

@@ -1,167 +0,0 @@
-import { chmod, mkdir, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { mapCoreError } from "../../cli/error-map.js";
-import { fileExists } from "../../cli/fs-utils.js";
-import { infoMessage, successMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-import { resolveAgentplaneBinPath } from "../../shared/package-paths.js";
-import { fileIsManaged, HOOK_MARKER, HOOK_NAMES, resolveGitHooksDir, SHIM_MARKER, } from "./shared.js";
-function hookScriptText(hook) {
-    return [
-        "#!/usr/bin/env sh",
-        `# ${HOOK_MARKER} (do not edit)`,
-        "set -e",
-        'REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"',
-        'SHIM="$REPO_ROOT/.agentplane/bin/agentplane"',
-        'if [ -x "$SHIM" ]; then',
-        '  exec "$SHIM" hooks run ' + hook + ' "$@"',
-        "fi",
-        "if ! command -v agentplane >/dev/null 2>&1; then",
-        '  echo "agentplane hooks: runner not found (PATH missing and shim unavailable)." >&2',
-        "  exit 127",
-        "fi",
-        "exec agentplane hooks run " + hook + ' "$@"',
-        "",
-    ].join("\n");
-}
-function shellSingleQuote(value) {
-    return `'${value.replaceAll("'", String.raw `'\''`)}'`;
-}
-function resolveInstalledHookRunnerPath() {
-    const activeBin = String(process.env.AGENTPLANE_RUNTIME_ACTIVE_BIN ?? "").trim();
-    return activeBin || resolveAgentplaneBinPath();
-}
-export async function collectHooksInstallConflicts(opts) {
-    const hooksDir = await resolveGitHooksDir(opts.gitRoot);
-    const conflicts = [];
-    const shimPath = path.join(opts.agentplaneDir, "bin", "agentplane");
-    if (await fileExists(shimPath)) {
-        const managed = await fileIsManaged(shimPath, SHIM_MARKER);
-        if (!managed)
-            conflicts.push(shimPath);
-    }
-    for (const hook of HOOK_NAMES) {
-        const hookPath = path.join(hooksDir, hook);
-        if (!(await fileExists(hookPath)))
-            continue;
-        const managed = await fileIsManaged(hookPath, HOOK_MARKER);
-        if (!managed)
-            conflicts.push(hookPath);
-    }
-    return conflicts;
-}
-function shimScriptText(installedRunnerPath) {
-    return [
-        "#!/usr/bin/env sh",
-        `# ${SHIM_MARKER} (do not edit)`,
-        "set -e",
-        'SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"',
-        'REPO_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"',
-        'LOCAL_BIN="$REPO_ROOT/packages/agentplane/bin/agentplane.js"',
-        'if command -v node >/dev/null 2>&1 && [ -f "$LOCAL_BIN" ]; then',
-        '  exec node "$LOCAL_BIN" "$@"',
-        "fi",
-        `INSTALL_BIN=${shellSingleQuote(installedRunnerPath)}`,
-        'if command -v node >/dev/null 2>&1 && [ -f "$INSTALL_BIN" ]; then',
-        '  exec node "$INSTALL_BIN" "$@"',
-        "fi",
-        'ENV_BIN="${AGENTPLANE_HOOK_RUNNER:-}"',
-        'if [ -n "$ENV_BIN" ] && command -v node >/dev/null 2>&1 && [ -f "$ENV_BIN" ]; then',
-        '  exec node "$ENV_BIN" "$@"',
-        "fi",
-        "if command -v agentplane >/dev/null 2>&1; then",
-        '  exec agentplane "$@"',
-        "fi",
-        'if [ "${AGENTPLANE_HOOK_ALLOW_NPX:-}" = "1" ] && command -v npx >/dev/null 2>&1; then',
-        '  exec npx --yes agentplane "$@"',
-        "fi",
-        'echo "agentplane shim: runner not found (need installed runner, env runner, repo-local source, agentplane in PATH, or AGENTPLANE_HOOK_ALLOW_NPX=1)." >&2',
-        "  exit 127",
-        "",
-    ].join("\n");
-}
-async function ensureShim(agentplaneDir, gitRoot) {
-    const shimDir = path.join(agentplaneDir, "bin");
-    const shimPath = path.join(shimDir, "agentplane");
-    await mkdir(shimDir, { recursive: true });
-    if (await fileExists(shimPath)) {
-        const managed = await fileIsManaged(shimPath, SHIM_MARKER);
-        if (!managed) {
-            throw new CliError({
-                exitCode: 5,
-                code: "E_GIT",
-                message: `Refusing to overwrite existing shim: ${path.relative(gitRoot, shimPath)}`,
-            });
-        }
-    }
-    await writeFile(shimPath, shimScriptText(resolveInstalledHookRunnerPath()), "utf8");
-    await chmod(shimPath, 0o755);
-}
-export async function cmdHooksInstall(opts) {
-    try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const hooksDir = await resolveGitHooksDir(resolved.gitRoot);
-        await mkdir(hooksDir, { recursive: true });
-        await mkdir(resolved.agentplaneDir, { recursive: true });
-        await ensureShim(resolved.agentplaneDir, resolved.gitRoot);
-        for (const hook of HOOK_NAMES) {
-            const hookPath = path.join(hooksDir, hook);
-            if (await fileExists(hookPath)) {
-                const managed = await fileIsManaged(hookPath, HOOK_MARKER);
-                if (!managed) {
-                    throw new CliError({
-                        exitCode: 5,
-                        code: "E_GIT",
-                        message: `Refusing to overwrite existing hook: ${path.relative(resolved.gitRoot, hookPath)}`,
-                    });
-                }
-            }
-            await writeFile(hookPath, hookScriptText(hook), "utf8");
-            await chmod(hookPath, 0o755);
-        }
-        if (!opts.quiet) {
-            process.stdout.write(`${path.relative(resolved.gitRoot, hooksDir)}\n`);
-        }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "hooks install", root: opts.rootOverride ?? null });
-    }
-}
-export async function cmdHooksUninstall(opts) {
-    try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const hooksDir = await resolveGitHooksDir(resolved.gitRoot);
-        let removed = 0;
-        for (const hook of HOOK_NAMES) {
-            const hookPath = path.join(hooksDir, hook);
-            if (!(await fileExists(hookPath)))
-                continue;
-            const managed = await fileIsManaged(hookPath, HOOK_MARKER);
-            if (!managed)
-                continue;
-            await rm(hookPath, { force: true });
-            removed++;
-        }
-        if (!opts.quiet) {
-            process.stdout.write(removed > 0
-                ? `${successMessage("removed hooks", undefined, `count=${removed}`)}\n`
-                : `${infoMessage("no agentplane hooks found")}\n`);
-        }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "hooks uninstall", root: opts.rootOverride ?? null });
-    }
-}

package/dist/commands/hooks/run.command.d.ts

@@ -1,9 +0,0 @@
-import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-import { HOOK_NAMES } from "./index.js";
-export type HooksRunParsed = {
-    hook: (typeof HOOK_NAMES)[number];
-    args: string[];
-};
-export declare const hooksRunSpec: CommandSpec<HooksRunParsed>;
-export declare const runHooksRun: CommandHandler<HooksRunParsed>;
-//# sourceMappingURL=run.command.d.ts.map

package/dist/commands/hooks/run.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.command.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEnF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CA4BpD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,cAAc,CAOtD,CAAC"}

package/dist/commands/hooks/run.command.js

@@ -1,39 +0,0 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { HOOK_NAMES, cmdHooksRun } from "./index.js";
-export const hooksRunSpec = {
-    id: ["hooks", "run"],
-    group: "Hooks",
-    summary: "Run a managed hook (use `--` to pass through additional arguments).",
-    args: [
-        { name: "hook", required: true, valueHint: "<hook>" },
-        { name: "args", required: false, variadic: true, valueHint: "<args...>" },
-    ],
-    examples: [
-        { cmd: "agentplane hooks run pre-commit", why: "Run the pre-commit checks." },
-        {
-            cmd: "agentplane hooks run commit-msg -- .git/COMMIT_EDITMSG",
-            why: "Run commit-msg with a message file argument.",
-        },
-    ],
-    validateRaw: (raw) => {
-        const hook = String(raw.args.hook);
-        if (!HOOK_NAMES.includes(hook)) {
-            throw usageError({
-                spec: hooksRunSpec,
-                message: `Unknown hook: ${hook} (expected one of: ${HOOK_NAMES.join(", ")})`,
-            });
-        }
-    },
-    parse: (raw) => ({
-        hook: String(raw.args.hook),
-        args: Array.isArray(raw.args.args) ? raw.args.args.map(String) : [],
-    }),
-};
-export const runHooksRun = async (ctx, p) => {
-    return await cmdHooksRun({
-        cwd: ctx.cwd,
-        rootOverride: ctx.rootOverride,
-        hook: p.hook,
-        args: p.args,
-    });
-};

package/dist/commands/hooks/run.commit-msg.d.ts

@@ -1,3 +0,0 @@
-import type { HooksRunOptions } from "./run.js";
-export declare function runCommitMsgHook(opts: HooksRunOptions): Promise<number>;
-//# sourceMappingURL=run.commit-msg.d.ts.map

package/dist/commands/hooks/run.commit-msg.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.commit-msg.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.commit-msg.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyBhD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C7E"}

package/dist/commands/hooks/run.commit-msg.js

@@ -1,68 +0,0 @@
-import { resolveProject } from "@agentplaneorg/core/project";
-import { readFile } from "node:fs/promises";
-import { loadConfig } from "@agentplaneorg/core/config";
-import { evaluatePolicy } from "../../policy/evaluate.js";
-import { CliError } from "../../shared/errors.js";
-import { throwIfPolicyDenied } from "../shared/policy-deny.js";
-import { gitCurrentBranch } from "../shared/git-ops.js";
-import { parseTaskIdFromBranch, parseTaskIdFromCloseBranch } from "@agentplaneorg/core/git";
-async function inferTaskIdFromBranchContext(opts) {
-    try {
-        const branch = await gitCurrentBranch(opts.gitRoot);
-        return (parseTaskIdFromBranch(opts.taskPrefix, branch) ?? parseTaskIdFromCloseBranch(branch) ?? "");
-    }
-    catch {
-        return "";
-    }
-}
-function readCommitSubject(message) {
-    for (const line of message.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#"))
-            continue;
-        return trimmed;
-    }
-    return "";
-}
-export async function runCommitMsgHook(opts) {
-    const messagePath = opts.args[0];
-    if (!messagePath) {
-        throw new CliError({
-            exitCode: 2,
-            code: "E_USAGE",
-            message: "Missing commit message file path",
-        });
-    }
-    const raw = await readFile(messagePath, "utf8");
-    const subject = readCommitSubject(raw);
-    const resolved = await resolveProject({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    const loaded = await loadConfig(resolved.agentplaneDir);
-    const taskId = (process.env.AGENTPLANE_TASK_ID ?? "").trim() ||
-        (await inferTaskIdFromBranchContext({
-            gitRoot: resolved.gitRoot,
-            taskPrefix: loaded.config.branch.task_prefix,
-        }));
-    const statusTo = (process.env.AGENTPLANE_STATUS_TO ?? "").trim().toUpperCase();
-    const emoji = subject.split(/\s+/).find(Boolean) ?? "";
-    if (taskId && statusTo === "DONE" && emoji !== "✅") {
-        throw new CliError({
-            exitCode: 5,
-            code: "E_GIT",
-            message: "Finish commits must use a checkmark emoji.\n" +
-                "Expected:\n" +
-                "  ✅ <TASK_SUFFIX> <scope>: <summary>",
-        });
-    }
-    const res = evaluatePolicy({
-        action: "hook_commit_msg",
-        config: loaded.config,
-        taskId,
-        git: { stagedPaths: [] },
-        commit: { subject },
-    });
-    throwIfPolicyDenied(res);
-    return 0;
-}

package/dist/commands/hooks/run.d.ts

@@ -1,9 +0,0 @@
-import type { HookName } from "./shared.js";
-export type HooksRunOptions = {
-    cwd: string;
-    rootOverride?: string;
-    hook: HookName;
-    args: string[];
-};
-export declare function cmdHooksRun(opts: HooksRunOptions): Promise<number>;
-//# sourceMappingURL=run.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAmBF,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBxE"}

package/dist/commands/hooks/run.js

@@ -1,45 +0,0 @@
-import { mapBackendError } from "../../cli/error-map.js";
-import { CliError } from "../../shared/errors.js";
-import { runCommitMsgHook } from "./run.commit-msg.js";
-import { runPostMergeHook } from "./run.post-merge.js";
-import { runPreCommitHook } from "./run.pre-commit.js";
-import { runPrePushHook } from "./run.pre-push.js";
-async function runHook(opts) {
-    switch (opts.hook) {
-        case "commit-msg": {
-            return await runCommitMsgHook(opts);
-        }
-        case "pre-commit": {
-            return await runPreCommitHook(opts);
-        }
-        case "pre-push": {
-            return await runPrePushHook(opts);
-        }
-        case "post-merge": {
-            return await runPostMergeHook(opts);
-        }
-    }
-}
-export async function cmdHooksRun(opts) {
-    try {
-        return await runHook(opts);
-    }
-    catch (err) {
-        const status = err?.status;
-        const stdout = err?.stdout;
-        const stderr = err?.stderr;
-        if (typeof stdout === "string" && stdout.length > 0)
-            process.stdout.write(stdout);
-        if (typeof stderr === "string" && stderr.length > 0)
-            process.stderr.write(stderr);
-        if (typeof status === "number" && Number.isInteger(status) && status >= 0) {
-            return status;
-        }
-        if (err instanceof CliError)
-            throw err;
-        throw mapBackendError(err, {
-            command: `hooks run ${opts.hook}`,
-            root: opts.rootOverride ?? null,
-        });
-    }
-}

package/dist/commands/hooks/run.post-merge.d.ts

@@ -1,3 +0,0 @@
-import type { HooksRunOptions } from "./run.js";
-export declare function runPostMergeHook(opts: HooksRunOptions): Promise<number>;
-//# sourceMappingURL=run.post-merge.d.ts.map

package/dist/commands/hooks/run.post-merge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.post-merge.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.post-merge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC7E"}

package/dist/commands/hooks/run.post-merge.js

@@ -1,44 +0,0 @@
-import { resolveBaseBranch } from "@agentplaneorg/core/git";
-import { cmdCleanupMerged } from "../branch/index.js";
-import { gitCurrentBranch } from "../shared/git-ops.js";
-import { loadCommandContext } from "../shared/task-backend.js";
-export async function runPostMergeHook(opts) {
-    try {
-        const ctx = await loadCommandContext({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        if (ctx.config.workflow_mode !== "branch_pr")
-            return 0;
-        const baseBranch = await resolveBaseBranch({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            cliBaseOpt: null,
-            mode: ctx.config.workflow_mode,
-        });
-        if (!baseBranch)
-            return 0;
-        const currentBranch = await gitCurrentBranch(ctx.resolvedProject.gitRoot);
-        if (currentBranch !== baseBranch)
-            return 0;
-        return await cmdCleanupMerged({
-            ctx,
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride,
-            base: baseBranch,
-            yes: true,
-            archive: false,
-            deleteRemoteBranches: false,
-            fetch: false,
-            quiet: true,
-            skipUnsafeWorktrees: true,
-        });
-    }
-    catch (error) {
-        const message = error instanceof Error && error.message.trim().length > 0
-            ? error.message.trim()
-            : String(error);
-        process.stderr.write(`warning: post-merge cleanup skipped: ${message}\n`);
-        return 0;
-    }
-}

package/dist/commands/hooks/run.pre-commit.d.ts

@@ -1,3 +0,0 @@
-import type { HooksRunOptions } from "./run.js";
-export declare function runPreCommitHook(opts: HooksRunOptions): Promise<number>;
-//# sourceMappingURL=run.pre-commit.d.ts.map

package/dist/commands/hooks/run.pre-commit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.pre-commit.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.pre-commit.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC7E"}

package/dist/commands/hooks/run.pre-commit.js

@@ -1,49 +0,0 @@
-import { loadConfig } from "@agentplaneorg/core/config";
-import { resolveProject } from "@agentplaneorg/core/project";
-import { resolveBaseBranch, GitContext } from "@agentplaneorg/core/git";
-import { evaluatePolicy } from "../../policy/evaluate.js";
-import { gitCurrentBranch } from "../shared/git-ops.js";
-import { throwIfPolicyDenied } from "../shared/policy-deny.js";
-function envFlag(name) {
-    return (process.env[name] ?? "").trim() === "1";
-}
-export async function runPreCommitHook(opts) {
-    const resolved = await resolveProject({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    const staged = await new GitContext({ gitRoot: resolved.gitRoot }).statusStagedPaths();
-    if (staged.length === 0)
-        return 0;
-    const loaded = await loadConfig(resolved.agentplaneDir);
-    const inBranchPr = loaded.config.workflow_mode === "branch_pr";
-    const baseBranch = inBranchPr
-        ? await resolveBaseBranch({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-            cliBaseOpt: null,
-            mode: loaded.config.workflow_mode,
-        })
-        : null;
-    const currentBranch = inBranchPr ? await gitCurrentBranch(resolved.gitRoot) : undefined;
-    const res = evaluatePolicy({
-        action: "hook_pre_commit",
-        config: loaded.config,
-        taskId: (process.env.AGENTPLANE_TASK_ID ?? "").trim(),
-        git: {
-            stagedPaths: staged,
-            currentBranch,
-            baseBranch,
-        },
-        allow: {
-            allowTasks: envFlag("AGENTPLANE_ALLOW_TASKS"),
-            allowBase: envFlag("AGENTPLANE_ALLOW_BASE"),
-            allowPolicy: envFlag("AGENTPLANE_ALLOW_POLICY"),
-            allowConfig: envFlag("AGENTPLANE_ALLOW_CONFIG"),
-            allowHooks: envFlag("AGENTPLANE_ALLOW_HOOKS"),
-            allowCI: envFlag("AGENTPLANE_ALLOW_CI"),
-        },
-    });
-    throwIfPolicyDenied(res);
-    return 0;
-}

package/dist/commands/hooks/run.pre-push.d.ts

@@ -1,6 +0,0 @@
-import type { HooksRunOptions } from "./run.js";
-export declare function resolvePrePushHookScriptPath(gitRoot: string, opts?: {
-    bundledScriptPath?: string;
-}): Promise<string | null>;
-export declare function runPrePushHook(opts: HooksRunOptions): Promise<number>;
-//# sourceMappingURL=run.pre-push.d.ts.map

package/dist/commands/hooks/run.pre-push.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.pre-push.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.pre-push.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyBhD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAiUD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3E"}