agentplane 0.3.15 → 0.3.17

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

@@ -1,18 +1,5 @@
-export declare const HOOK_NAMES: readonly ["commit-msg", "pre-commit", "pre-push", "post-merge"];
-export declare function cmdHooksInstall(opts: {
-    cwd: string;
-    rootOverride?: string;
-    quiet: boolean;
-}): Promise<number>;
-export declare function cmdHooksUninstall(opts: {
-    cwd: string;
-    rootOverride?: string;
-    quiet: boolean;
-}): Promise<number>;
-export declare function cmdHooksRun(opts: {
-    cwd: string;
-    rootOverride?: string;
-    hook: (typeof HOOK_NAMES)[number];
-    args: string[];
-}): Promise<number>;
+export { HOOK_NAMES, type HookName } from "./shared.js";
+export { cmdHooksInstall, cmdHooksUninstall } from "./install.js";
+export { cmdHooksRun } from "./run.js";
+export { resolvePrePushHookScriptPath } from "./run.pre-push.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,UAAU,iEAAkE,CAAC;AA8K1F,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoLlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commands/hooks/index.js

@@ -1,415 +1,4 @@
-import { spawnSync } from "node:child_process";
-import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { loadConfig, resolveBaseBranch, resolveProject } from "@agentplaneorg/core";
-import { evaluatePolicy } from "../../policy/evaluate.js";
-import { mapBackendError, 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 { cmdCleanupMerged } from "../branch/index.js";
-import { GitContext } from "../shared/git-context.js";
-import { throwIfPolicyDenied } from "../shared/policy-deny.js";
-import { gitCurrentBranch, gitRevParse } from "../shared/git-ops.js";
-import { parseTaskIdFromBranch, parseTaskIdFromCloseBranch } from "../shared/git-worktree.js";
-import { isPathWithin } from "../shared/path.js";
-import { loadCommandContext } from "../shared/task-backend.js";
-const HOOK_MARKER = "agentplane-hook";
-const SHIM_MARKER = "agentplane-hook-shim";
-export const HOOK_NAMES = ["commit-msg", "pre-commit", "pre-push", "post-merge"];
-async function inferTaskIdFromBranchContext(opts) {
-    try {
-        const branch = await gitCurrentBranch(opts.gitRoot);
-        return (parseTaskIdFromBranch(opts.taskPrefix, branch) ?? parseTaskIdFromCloseBranch(branch) ?? "");
-    }
-    catch {
-        return "";
-    }
-}
-async function resolveGitHooksDir(cwd) {
-    const repoRoot = await gitRevParse(cwd, ["--show-toplevel"]);
-    const commonDirRaw = await gitRevParse(cwd, ["--git-common-dir"]);
-    const hooksRaw = await gitRevParse(cwd, ["--git-path", "hooks"]);
-    const commonDir = path.resolve(path.isAbsolute(commonDirRaw) ? commonDirRaw : path.join(repoRoot, commonDirRaw));
-    const hooksDir = path.resolve(path.isAbsolute(hooksRaw) ? hooksRaw : path.join(repoRoot, hooksRaw));
-    const resolvedRoot = path.resolve(repoRoot);
-    if (!isPathWithin(resolvedRoot, hooksDir) && !isPathWithin(commonDir, hooksDir)) {
-        throw new CliError({
-            exitCode: 5,
-            code: "E_GIT",
-            message: [
-                "Refusing to manage git hooks outside the repository.",
-                `hooks_path=${hooksDir}`,
-                `repo_root=${resolvedRoot}`,
-                `common_dir=${commonDir}`,
-                "Fix:",
-                "  1) Use a repo-relative core.hooksPath (e.g., .git/hooks)",
-                "  2) Re-run `agentplane hooks install`",
-            ].join("\n"),
-        });
-    }
-    return hooksDir;
-}
-async function fileIsManaged(filePath, marker) {
-    try {
-        const content = await readFile(filePath, "utf8");
-        return content.includes(marker);
-    }
-    catch {
-        return false;
-    }
-}
-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 shimScriptText() {
-    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",
-        '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 command -v npx >/dev/null 2>&1; then",
-        '  exec npx --yes agentplane "$@"',
-        "fi",
-        'echo "agentplane shim: runner not found (need env runner, repo-local source, agentplane in PATH, or node+npx)." >&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(), "utf8");
-    await chmod(shimPath, 0o755);
-}
-function readCommitSubject(message) {
-    for (const line of message.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#"))
-            continue;
-        return trimmed;
-    }
-    return "";
-}
-function resolveBundledPrePushHookScriptPath() {
-    return fileURLToPath(new URL("../../../../../scripts/run-pre-push-hook.mjs", import.meta.url));
-}
-async function readHookStdinUtf8(timeoutMs = 25) {
-    if (process.stdin.isTTY)
-        return "";
-    const chunks = [];
-    const consume = () => {
-        let chunk = process.stdin.read();
-        while (chunk !== null) {
-            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
-            chunk = process.stdin.read();
-        }
-    };
-    consume();
-    if (chunks.length > 0 || process.stdin.readableEnded) {
-        return Buffer.concat(chunks).toString("utf8");
-    }
-    await new Promise((resolve) => {
-        const finish = () => {
-            clearTimeout(timer);
-            process.stdin.off("readable", onReadable);
-            process.stdin.off("end", onEnd);
-            resolve();
-        };
-        const onReadable = () => {
-            consume();
-            finish();
-        };
-        const onEnd = () => {
-            consume();
-            finish();
-        };
-        const timer = setTimeout(finish, timeoutMs);
-        process.stdin.on("readable", onReadable);
-        process.stdin.on("end", onEnd);
-        process.stdin.resume();
-    });
-    consume();
-    return Buffer.concat(chunks).toString("utf8");
-}
-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 });
-    }
-}
-export async function cmdHooksRun(opts) {
-    try {
-        if (opts.hook === "commit-msg") {
-            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;
-        }
-        if (opts.hook === "pre-commit") {
-            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 allowTasks = (process.env.AGENTPLANE_ALLOW_TASKS ?? "").trim() === "1";
-            const allowBase = (process.env.AGENTPLANE_ALLOW_BASE ?? "").trim() === "1";
-            const allowPolicy = (process.env.AGENTPLANE_ALLOW_POLICY ?? "").trim() === "1";
-            const allowConfig = (process.env.AGENTPLANE_ALLOW_CONFIG ?? "").trim() === "1";
-            const allowHooks = (process.env.AGENTPLANE_ALLOW_HOOKS ?? "").trim() === "1";
-            const allowCI = (process.env.AGENTPLANE_ALLOW_CI ?? "").trim() === "1";
-            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,
-                    allowBase,
-                    allowPolicy,
-                    allowConfig,
-                    allowHooks,
-                    allowCI,
-                },
-            });
-            throwIfPolicyDenied(res);
-            return 0;
-        }
-        if (opts.hook === "pre-push") {
-            const resolved = await resolveProject({
-                cwd: opts.cwd,
-                rootOverride: opts.rootOverride ?? null,
-            });
-            const scriptPath = resolveBundledPrePushHookScriptPath();
-            if (!(await fileExists(scriptPath))) {
-                throw new CliError({
-                    exitCode: 2,
-                    code: "E_USAGE",
-                    message: `Missing pre-push hook script: ${scriptPath}`,
-                });
-            }
-            const result = spawnSync("node", [scriptPath], {
-                cwd: resolved.gitRoot,
-                env: process.env,
-                encoding: "utf8",
-                input: await readHookStdinUtf8(),
-                stdio: ["pipe", "inherit", "inherit"],
-            });
-            if (result.error)
-                throw result.error;
-            return result.status ?? (result.signal ? 1 : 0);
-        }
-        if (opts.hook === "post-merge") {
-            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;
-            }
-        }
-        return 0;
-    }
-    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,
-        });
-    }
-}
+export { HOOK_NAMES } from "./shared.js";
+export { cmdHooksInstall, cmdHooksUninstall } from "./install.js";
+export { cmdHooksRun } from "./run.js";
+export { resolvePrePushHookScriptPath } from "./run.pre-push.js";

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

@@ -0,0 +1,11 @@
+export declare function cmdHooksInstall(opts: {
+    cwd: string;
+    rootOverride?: string;
+    quiet: boolean;
+}): Promise<number>;
+export declare function cmdHooksUninstall(opts: {
+    cwd: string;
+    rootOverride?: string;
+    quiet: boolean;
+}): Promise<number>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/install.ts"],"names":[],"mappings":"AAkFA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB"}

package/dist/commands/hooks/install.js

@@ -0,0 +1,136 @@
+import { chmod, mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveProject } from "@agentplaneorg/core";
+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 { 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 shimScriptText() {
+    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",
+        '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 command -v npx >/dev/null 2>&1; then",
+        '  exec npx --yes agentplane "$@"',
+        "fi",
+        'echo "agentplane shim: runner not found (need env runner, repo-local source, agentplane in PATH, or node+npx)." >&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(), "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.commit-msg.d.ts

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.commit-msg.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/run.commit-msg.ts"],"names":[],"mappings":"AASA,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

@@ -0,0 +1,67 @@
+import { readFile } from "node:fs/promises";
+import { loadConfig, resolveProject } from "@agentplaneorg/core";
+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 "../shared/git-worktree.js";
+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;
+}