agentplane 0.2.5 → 0.2.6

package/assets/AGENTS.md

@@ -6,7 +6,7 @@ default_initiator: ORCHESTRATOR
 
 # PURPOSE
 
-This document defines the **behavioral policy** for agents operating in an agentplane-managed development workspace.
+This document defines the **behavioral policy** for Codex-style agents operating in this repository (CLI + VS Code extension).
 Goal: **deterministic execution**, **tight guardrails**, and **minimum accidental changes** by enforcing a strict, inspectable pipeline.
 
 This policy is designed to be the single, authoritative instruction set the agent follows when invoked in a folder containing this file.
@@ -28,11 +28,9 @@ If two sources conflict, prefer the higher-priority source.
 
 All commands in this policy are written as `agentplane ...` and MUST use the `agentplane` CLI available on `PATH`.
 
-Do not use repository-relative entrypoints (for example `node .../bin/agentplane.js`) in instructions or automation.
-
 ## Scope boundary
 
-- All operations must remain within the workspace unless explicitly approved (see Approval Gates + Overrides).
+- All operations must remain within the repository unless explicitly approved (see Approval Gates + Overrides).
 - Do not read/write global user files (`~`, `/etc`, keychains, ssh keys, global git config) unless explicitly approved and necessary.
 
 ## Agent roles (authority boundaries)
@@ -62,16 +60,16 @@ Execution agents are defined by JSON files under `.agentplane/agents/*.json`. Th
 
 ## Definitions (remove ambiguity)
 
-- **Read-only inspection**: commands that may read workspace state but must not change tracked files or commit history.
+- **Read-only inspection**: commands that may read repo state but must not change tracked files or commit history.
   Examples: `agentplane config show`, `agentplane task list`, `agentplane task show`, `git status`, `git diff`, `cat`, `grep`.
-- **Mutating action**: anything that can change tracked files, task state, commits, branches, or outside-workspace state.
+- **Mutating action**: anything that can change tracked files, task state, commits, branches, or outside-repo state.
   Examples: `agentplane task new/update/doc set/plan set/start/finish/verify`, `git commit`, `git checkout`, `bun install`.
 
 If unsure whether an action mutates state, treat it as mutating.
 
 ## Truthfulness & safety (hard invariants)
 
-- Never invent facts about workspace state. Prefer inspection over guessing.
+- Never invent facts about repo state. Prefer inspection over guessing.
 - Never modify `.agentplane/tasks.json` manually. It is an **export-only snapshot** generated via `agentplane task export`.
 - Never expose raw internal chain-of-thought. Use structured artifacts instead (see OUTPUT CONTRACTS).
 
@@ -82,7 +80,7 @@ If unsure whether an action mutates state, treat it as mutating.
 - “Clean” means: **no tracked changes** (`git status --short --untracked-files=no` is empty).
 - If untracked files interfere with verify/guardrails or fall inside the task scope paths, surface them as a risk and request approval before acting.
 
-## Approval gates (network vs outside-workspace)
+## Approval gates (network vs outside-repo)
 
 ### Network
 
@@ -97,20 +95,15 @@ Network use includes (non-exhaustive):
 - `git fetch`, `git pull`
 - calling external HTTP APIs or remote services
 
-### Outside-workspace
+### Outside-repo
 
-Outside-workspace reading/writing is **always prohibited** unless the user explicitly approves it (regardless of `require_network`).
+Outside-repo reading/writing is **always prohibited** unless the user explicitly approves it (regardless of `require_network`).
 
-Outside-workspace includes (non-exhaustive):
+Outside-repo includes (non-exhaustive):
 
-- reading/writing outside the workspace (`~`, `/etc`, global configs)
+- reading/writing outside the repo (`~`, `/etc`, global configs)
 - modifying keychains, ssh keys, credential stores
-- any tool that mutates outside-workspace state
-
-### Interactive vs non-interactive runs (approvals mechanics)
-
-- Interactive: the user can approve prompts (for example network use) during the run.
-- Non-interactive (CI, scripted runs): approvals MUST be expressed via flags/config up front (for example `--yes`). If an approval is required and not granted, stop and request explicit user instruction.
+- any tool that mutates outside-repo state
 
 ---
 
@@ -156,18 +149,13 @@ This is the required substitute for raw chain-of-thought.
 
 Preflight is **read-only inspection**. It is allowed before user approval.
 
-Before any planning or execution, ORCHESTRATOR must:
+Before any planning or execution, ORCHESTRATOR must run:
 
-1. Determine whether the current directory is an initialized agentplane workspace (e.g. `.agentplane/config.json` exists).
-2. Attempt git inspection:
-   - `git status --short --untracked-files=no`
-   - `git rev-parse --abbrev-ref HEAD`
-3. If the workspace is initialized, also run:
-   - `agentplane config show`
-   - `agentplane quickstart` (CLI instructions)
-   - `agentplane task list`
-
-If a command fails because the workspace is not initialized or not a git repo, record that fact in the Preflight Summary instead of guessing or proceeding with mutating actions.
+1. `agentplane config show`
+2. `agentplane quickstart` (CLI instructions)
+3. `agentplane task list`
+4. `git status --short --untracked-files=no`
+5. `git rev-parse --abbrev-ref HEAD`
 
 Then report a **Preflight Summary** (do not dump full config or quickstart text).
 
@@ -178,8 +166,6 @@ You MUST explicitly state:
 - Config loaded: yes/no
 - CLI instructions loaded: yes/no
 - Task list loaded: yes/no
-- Workspace initialized: yes/no
-- Git repository detected: yes/no
 - Working tree clean (tracked-only): yes/no
 - Current git branch: `<name>`
 - `workflow_mode`: `direct` / `branch_pr` / unknown
@@ -187,7 +173,7 @@ You MUST explicitly state:
   - `require_plan`: true/false/unknown
   - `require_verify`: true/false/unknown
   - `require_network`: true/false/unknown
-- Outside-workspace: not needed / needed (if needed, requires explicit user approval)
+- Outside-repo: not needed / needed (if needed, requires explicit user approval)
 
 Do not output the full contents of config or quickstart unless the user explicitly asks.
 
@@ -199,7 +185,7 @@ Do not output the full contents of config or quickstart unless the user explicit
 - ORCHESTRATOR starts by producing a top-level plan + task decomposition.
 - **Before explicit user approval, do not perform mutating actions.**
   - Allowed: read-only inspection (including preflight).
-  - Prohibited: creating/updating tasks, editing files, starting/finishing tasks, commits, branching, verify runs that mutate task state, network use, outside-workspace access.
+  - Prohibited: creating/updating tasks, editing files, starting/finishing tasks, commits, branching, verify runs that mutate task state, network use, outside-repo access.
 
 ---
 
@@ -219,7 +205,7 @@ ORCHESTRATOR MUST produce:
 - **Decomposition**
   - Atomic tasks assignable to existing agents
 - **Approvals**
-  - Whether network and/or outside-workspace actions will be needed
+  - Whether network and/or outside-repo actions will be needed
   - Any requested overrides (see Override Protocol)
 - **Verification criteria**
   - What will be considered "done" + checks to run
@@ -234,7 +220,7 @@ ORCHESTRATOR MUST produce:
 - PLANNER creates any additional tasks from the approved decomposition.
 - Task IDs are referenced in comments/notes for traceability.
 
-**Task tracking is mandatory** for any work that changes workspace state. Exceptions require explicit user approval (Override Protocol).
+**Task tracking is mandatory** for any work that changes repo state. Exceptions require explicit user approval (Override Protocol).
 
 ---
 
@@ -244,7 +230,7 @@ Overrides exist to let the user intentionally relax guardrails **in a controlled
 
 ## Hard invariants (cannot be overridden)
 
-- No fabricated workspace facts.
+- No fabricated repo facts.
 - No raw chain-of-thought.
 - No manual editing of `.agentplane/tasks.json` (exports are generated, not edited).
 
@@ -253,7 +239,7 @@ Overrides exist to let the user intentionally relax guardrails **in a controlled
 Common overridable guardrails:
 
 - **Network**: allow network access even when `require_network=true`.
-- **Outside-workspace**: allow reading/writing outside the workspace (scoped).
+- **Outside-repo**: allow reading/writing outside the repo (scoped).
 - **Pipeline**: skip/relax steps (e.g., skip task tracking for analysis-only; skip exports).
 - **Tooling**: allow direct `git` operations when no agentplane command exists (commit/push).
 - **Force flags**: allow `--force` status transitions / dependency bypass.
@@ -282,7 +268,7 @@ Any approved override MUST be recorded:
 
 ## Golden rule
 
-If an agent changes workspace state, that work must be traceable to a task ID and a filled task README.
+If an agent changes repo state, that work must be traceable to a task ID and a filled task README.
 
 ## Scaffold is mandatory
 
@@ -396,9 +382,7 @@ If config sets `agents.approvals.require_plan=true`:
 
 # COMMIT WORKFLOW
 
-Default: commits and pushes should go through `agentplane` commands (instead of direct `git commit`/`git push`) to enforce policy and allowlists.
-
-Override: direct git operations are allowed only with explicit user approval, and must be logged under the task `## Notes` → `### Approvals / Overrides`.
+- Commits and pushes must go through `agentplane` commands (no direct `git commit`/`git push`) unless explicitly overridden.
 
 ## Commit message semantics (canonical)
 
@@ -431,12 +415,25 @@ In this mode:
 
 `<emoji> <suffix> <scope>: <summary>`
 
+`<suffix>` rules:
+
+- Task commits: `<suffix>` must equal the task id suffix (e.g. task `202601010101-ABCDEF` -> `ABCDEF`).
+- Non-task commits: `<suffix>` may be omitted. Preferred: `<emoji> <scope>: <summary>`.
+- Optional explicit non-task suffix: `DEV` is allowed as `<emoji> DEV <scope>: <summary>`.
+
 Recommended action/status emojis:
 
 - `🚧` start / DOING
 - `⛔` blocked / BLOCKED
 - `✅` finish / DONE
 
+Executor agent emoji policy (status/comment-driven commits):
+
+- In `workflow_mode=direct`, status/comment-driven commits prefer the active `work start` lock (`.agentplane/cache/direct-work.json`) when present.
+- The emoji for status/comment-driven commits is derived from the executor agent id (recorded by `agentplane work start ... --agent <ID>`).
+- Users may override the emoji per agent by adding `commit_emoji` to `.agentplane/agents/<ID>.json`.
+- Finish commits MUST use `✅` (enforced by CLI and by the `commit-msg` hook for agentplane-generated commits).
+
 Agents must not reinterpret `-m` as "body-only" or "comment-only". `-m` is a commit message.
 
 ## Allowlist staging (guardrails)
@@ -509,7 +506,7 @@ Re-approval is required if any of the following becomes true:
 
 - Scope expands beyond the approved in-scope paths/artifacts.
 - New tasks are needed that were not in the approved decomposition.
-- Any network or outside-workspace access becomes necessary (and was not approved).
+- Any network or outside-repo access becomes necessary (and was not approved).
 - Verification criteria change materially.
 - Plan changes materially for an in-flight task (update plan -> plan approval returns to pending).
 - Guardrails require `--force` to proceed.

package/bin/agentplane.js

@@ -1,2 +1,110 @@
 #!/usr/bin/env node
-import "../dist/cli.js";
+import path from "node:path";
+import { readdir, stat } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+
+async function exists(p) {
+  try {
+    await stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isTestLikePath(absPath) {
+  // The repo build does not emit test files to dist. If we treat test mtimes as
+  // "src is newer than dist", we can block normal commits that only change tests.
+  const normalized = absPath.replaceAll("\\", "/");
+  if (normalized.includes("/__snapshots__/")) return true;
+  if (normalized.endsWith(".snap")) return true;
+  if (/\.(unit\.)?test\.[cm]?ts$/.test(normalized)) return true;
+  if (/\.(unit\.)?test\.tsx$/.test(normalized)) return true;
+  return false;
+}
+
+// Keep this file dependency-free and simple: rely on directory mtime scans below.
+async function newestMtimeMsInDir(dir) {
+  let newest = 0;
+  const stack = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (!current) continue;
+    let entries;
+    try {
+      entries = await readdir(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const abs = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(abs);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (isTestLikePath(abs)) continue;
+      try {
+        const s = await stat(abs);
+        if (s.mtimeMs > newest) newest = s.mtimeMs;
+      } catch {
+        // ignore
+      }
+    }
+  }
+  return newest;
+}
+
+async function assertDistUpToDate() {
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const agentplaneRoot = path.resolve(here, "..");
+  const inRepo = await exists(path.join(agentplaneRoot, "src", "cli.ts"));
+  if (!inRepo) return true;
+
+  const allowStale = (process.env.AGENTPLANE_DEV_ALLOW_STALE_DIST ?? "").trim() === "1";
+  const agentplaneDistDir = path.join(agentplaneRoot, "dist");
+  if (!(await exists(agentplaneDistDir))) {
+    process.stderr.write(
+      "error: agentplane dist is missing for this repo checkout.\n" +
+        "Fix:\n" +
+        "  bun run --filter=@agentplaneorg/core build\n" +
+        "  bun run --filter=agentplane build\n",
+    );
+    process.exitCode = 2;
+    return false;
+  }
+
+  const agentplaneSrcDir = path.join(agentplaneRoot, "src");
+  const agentplaneSrcNewest = await newestMtimeMsInDir(agentplaneSrcDir);
+  const agentplaneDistNewest = await newestMtimeMsInDir(agentplaneDistDir);
+  const isStaleAgentplane = agentplaneSrcNewest > agentplaneDistNewest;
+
+  // If we're in the monorepo, also check core dist because the CLI imports it.
+  const repoRoot = path.resolve(agentplaneRoot, "..", "..");
+  const coreRoot = path.join(repoRoot, "packages", "core");
+  const coreSrcDir = path.join(coreRoot, "src");
+  const coreDistDir = path.join(coreRoot, "dist");
+  let isStaleCore = false;
+  if ((await exists(coreSrcDir)) && (await exists(coreDistDir))) {
+    const coreSrcNewest = await newestMtimeMsInDir(coreSrcDir);
+    const coreDistNewest = await newestMtimeMsInDir(coreDistDir);
+    isStaleCore = coreSrcNewest > coreDistNewest;
+  }
+
+  if ((isStaleAgentplane || isStaleCore) && !allowStale) {
+    process.stderr.write(
+      "error: refusing to run a stale repo build (dist is older than src).\n" +
+        "Fix:\n" +
+        "  bun run --filter=@agentplaneorg/core build\n" +
+        "  bun run --filter=agentplane build\n" +
+        "Override (not recommended): set AGENTPLANE_DEV_ALLOW_STALE_DIST=1\n",
+    );
+    process.exitCode = 2;
+    return false;
+  }
+
+  return true;
+}
+
+const ok = await assertDistUpToDate();
+if (ok) await import("../dist/cli.js");

package/dist/cli/critical/cli-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/cli/critical/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../../../src/cli/critical/cli-runner.ts"],"names":[],"mappings":""}

package/dist/cli/critical/cli-runner.js

@@ -0,0 +1,11 @@
+import { runCli } from "../run-cli.js";
+async function main() {
+    const argv = process.argv.slice(2);
+    const code = await runCli(argv);
+    process.exitCode = code;
+}
+main().catch((err) => {
+    // Last-resort fallback. The contract for tests is "exit non-zero and surface the error".
+    console.error(err);
+    process.exitCode = 1;
+});

package/dist/cli/critical/harness.d.ts

@@ -0,0 +1,22 @@
+export type RunCliResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export declare function makeTempDir(prefix?: string): Promise<string>;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function writeText(filePath: string, content: string): Promise<void>;
+export declare function readText(filePath: string): Promise<string>;
+export declare function real(p: string): Promise<string>;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function listDirRecursive(root: string): Promise<string[]>;
+export declare function gitInit(repoRoot: string, branch?: string): Promise<void>;
+export declare function gitCommitAll(repoRoot: string, message: string): Promise<void>;
+export declare function gitHead(repoRoot: string): Promise<string>;
+export declare function runCli(args: string[], opts: {
+    cwd: string;
+    extraEnv?: Record<string, string>;
+}): Promise<RunCliResult>;
+export declare function expectCliError(result: RunCliResult, code: number, errCode: string): void;
+export declare function cleanGitEnv(): NodeJS.ProcessEnv;
+//# sourceMappingURL=harness.d.ts.map

package/dist/cli/critical/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/cli/critical/harness.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAgBF,wBAAsB,WAAW,CAAC,MAAM,SAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErD;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAatE;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9E;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/D;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvD,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAexF;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAqB/C"}

package/dist/cli/critical/harness.js

@@ -0,0 +1,164 @@
+import { execFile } from "node:child_process";
+import { mkdir, mkdtemp, readFile, readdir, realpath, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+function renderExecField(v) {
+    if (v == null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (Buffer.isBuffer(v))
+        return v.toString("utf8");
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+export async function makeTempDir(prefix = "agentplane-critical-") {
+    return await mkdtemp(path.join(os.tmpdir(), prefix));
+}
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+export async function writeText(filePath, content) {
+    await ensureDir(path.dirname(filePath));
+    await writeFile(filePath, content, "utf8");
+}
+export async function readText(filePath) {
+    return await readFile(filePath, "utf8");
+}
+export async function real(p) {
+    return await realpath(p);
+}
+export async function pathExists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function listDirRecursive(root) {
+    const out = [];
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const abs = path.join(dir, entry.name);
+            const rel = path.relative(root, abs);
+            out.push(rel);
+            if (entry.isDirectory())
+                await walk(abs);
+        }
+    }
+    if (await pathExists(root))
+        await walk(root);
+    return out.toSorted((a, b) => a.localeCompare(b));
+}
+export async function gitInit(repoRoot, branch = "main") {
+    await ensureDir(repoRoot);
+    // Use real git, but avoid reading developer global/system configs.
+    await execFileAsync("git", ["init", "-q", "-b", branch], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    }).catch(async () => {
+        // Older git: init without -b, then create branch.
+        await execFileAsync("git", ["init", "-q"], { cwd: repoRoot, env: cleanGitEnv() });
+        await execFileAsync("git", ["checkout", "-q", "-b", branch], {
+            cwd: repoRoot,
+            env: cleanGitEnv(),
+        });
+    });
+    // Repo-local identity to avoid relying on global git config.
+    await execFileAsync("git", ["config", "user.email", "agentplane-test@example.com"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+    await execFileAsync("git", ["config", "user.name", "Agentplane Test"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+}
+export async function gitCommitAll(repoRoot, message) {
+    await execFileAsync("git", ["add", "-A"], { cwd: repoRoot, env: cleanGitEnv() });
+    await execFileAsync("git", ["commit", "-m", message], { cwd: repoRoot, env: cleanGitEnv() });
+}
+export async function gitHead(repoRoot) {
+    const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
+        cwd: repoRoot,
+        env: cleanGitEnv(),
+    });
+    return String(stdout).trim();
+}
+export async function runCli(args, opts) {
+    // Run as a separate process using bun to execute the TS runner.
+    const runnerPath = path.join(process.cwd(), "packages", "agentplane", "src", "cli", "critical", "cli-runner.ts");
+    const isolatedHome = await makeTempDir("agentplane-critical-home-");
+    const isolatedAgentplaneHome = await makeTempDir("agentplane-critical-ap-home-");
+    const env = {
+        ...process.env,
+        ...cleanGitEnv(),
+        HOME: isolatedHome,
+        XDG_CONFIG_HOME: path.join(isolatedHome, ".config"),
+        AGENTPLANE_HOME: isolatedAgentplaneHome,
+        AGENTPLANE_NO_UPDATE_CHECK: "1",
+        ...opts.extraEnv,
+    };
+    // execFileAsync throws on non-zero exit. Normalize into a stable `{code,stdout,stderr}` shape.
+    let code = 0;
+    let stdout = "";
+    let stderr = "";
+    try {
+        const ok = (await execFileAsync("bun", [runnerPath, ...args], {
+            cwd: opts.cwd,
+            env,
+            encoding: "utf8",
+            maxBuffer: 10 * 1024 * 1024,
+        }));
+        stdout = String(ok.stdout ?? "");
+        stderr = String(ok.stderr ?? "");
+    }
+    catch (err) {
+        const e = err;
+        stdout = renderExecField(e.stdout);
+        stderr = renderExecField(e.stderr);
+        code = typeof e.code === "number" ? e.code : 1;
+    }
+    return { code, stdout, stderr };
+}
+export function expectCliError(result, code, errCode) {
+    if (result.code !== code) {
+        throw new Error(`Expected exit code ${code} but got ${result.code}\n` +
+            `stdout:\n${result.stdout}\n` +
+            `stderr:\n${result.stderr}\n`);
+    }
+    if (!result.stderr.includes(`error [${errCode}]`)) {
+        throw new Error(`Expected stderr to include error [${errCode}]\n` +
+            `stdout:\n${result.stdout}\n` +
+            `stderr:\n${result.stderr}\n`);
+    }
+}
+export function cleanGitEnv() {
+    const env = { ...process.env };
+    // Prevent git from inheriting caller-specific repository bindings.
+    delete env.GIT_DIR;
+    delete env.GIT_WORK_TREE;
+    delete env.GIT_COMMON_DIR;
+    delete env.GIT_INDEX_FILE;
+    delete env.GIT_OBJECT_DIRECTORY;
+    delete env.GIT_ALTERNATE_OBJECT_DIRECTORIES;
+    // Disable global/system configs to avoid developer machine drift.
+    env.GIT_CONFIG_GLOBAL = "/dev/null";
+    env.GIT_CONFIG_SYSTEM = "/dev/null";
+    env.GIT_TERMINAL_PROMPT = "0";
+    // Provide identity for commits when commands rely on it.
+    env.GIT_AUTHOR_NAME = env.GIT_AUTHOR_NAME ?? "Agentplane Test";
+    env.GIT_AUTHOR_EMAIL = env.GIT_AUTHOR_EMAIL ?? "agentplane-test@example.com";
+    env.GIT_COMMITTER_NAME = env.GIT_COMMITTER_NAME ?? "Agentplane Test";
+    env.GIT_COMMITTER_EMAIL = env.GIT_COMMITTER_EMAIL ?? "agentplane-test@example.com";
+    return env;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/git.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CASxD"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/git.ts"],"names":[],"mappings":"AAKA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CAUxD"}

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

@@ -1,12 +1,14 @@
-import { findGitRoot } from "@agentplaneorg/core";
+import path from "node:path";
 import { gitInitRepo } from "../../../../commands/workflow.js";
+import { getPathKind } from "../../../fs-utils.js";
 export async function ensureGitRoot(opts) {
-    const existingGitRoot = await findGitRoot(opts.initRoot);
-    const gitRootExisted = Boolean(existingGitRoot);
-    let gitRoot = existingGitRoot;
-    if (!gitRoot) {
+    // Init is intentionally scoped to initRoot only. We do not search parent directories
+    // for an existing git repository, to avoid accidentally initializing the wrong workspace.
+    const dotGit = path.join(opts.initRoot, ".git");
+    const kind = await getPathKind(dotGit);
+    const gitRootExisted = kind === "dir";
+    if (!gitRootExisted) {
         await gitInitRepo(opts.initRoot, opts.baseBranchFallback);
-        gitRoot = opts.initRoot;
     }
-    return { gitRoot, gitRootExisted };
+    return { gitRoot: opts.initRoot, gitRootExisted };
 }

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":"AAaA,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;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"}

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

@@ -1,5 +1,4 @@
 import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../error-map.js";
 import { promptChoice, promptInput, promptYesNo } from "../../prompts.js";
 import { invalidValueForFlag } from "../../output.js";
@@ -40,7 +39,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 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 writes an initial install commit. In interactive mode it prompts for missing inputs; use --yes for non-interactive mode.",
     options: [
         {
             kind: "string",
@@ -253,10 +252,7 @@ async function cmdInit(opts) {
         const initRoot = path.resolve(opts.rootOverride ?? opts.cwd);
         const baseBranchFallback = "main";
         const { gitRoot, gitRootExisted } = await ensureGitRoot({ initRoot, baseBranchFallback });
-        const resolved = await resolveProject({
-            cwd: gitRoot,
-            rootOverride: gitRoot,
-        });
+        const resolved = { gitRoot, agentplaneDir: path.join(gitRoot, ".agentplane") };
         const initBaseBranch = await resolveInitBaseBranchForInit({
             gitRoot: resolved.gitRoot,
             baseBranchFallback,

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":"AAmVA,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":"AAwVA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoI5D"}

package/dist/cli/run-cli.js

@@ -298,7 +298,10 @@ async function maybeResolveProject(opts) {
         });
     }
     catch (err) {
-        if (err instanceof Error && err.message.startsWith("Not a git repository")) {
+        if (err instanceof Error &&
+            (err.message.startsWith("Not an agentplane project") ||
+                err.message.startsWith("Not a git repository") ||
+                err.message.startsWith("Agentplane project root is not a git repository"))) {
             return null;
         }
         throw err;

package/dist/commands/guard/impl/comment-commit.d.ts

@@ -5,6 +5,7 @@ export declare function commitFromComment(opts: {
     cwd: string;
     rootOverride?: string;
     taskId: string;
+    executorAgent?: string;
     author?: string;
     statusFrom?: string;
     statusTo?: string;

package/dist/commands/guard/impl/comment-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAS/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAoEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4F/D"}
+{"version":3,"file":"comment-commit.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/comment-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAS/E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAsEvF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+F/D"}

package/dist/commands/guard/impl/comment-commit.js

@@ -47,7 +47,8 @@ function deriveCommitMessageFromComment(opts) {
 function deriveCommitBodyFromComment(opts) {
     const lines = [
         `Task: ${opts.taskId}`,
-        ...(opts.author ? [`Agent: ${opts.author}`] : []),
+        ...(opts.executorAgent ? [`Agent: ${opts.executorAgent}`] : []),
+        ...(opts.author ? [`Author: ${opts.author}`] : []),
         ...(opts.statusFrom && opts.statusTo ? [`Status: ${opts.statusFrom} -> ${opts.statusTo}`] : []),
         `Comment: ${normalizeCommentBodyForCommit(opts.formattedComment || opts.commentBody)}`,
     ];
@@ -95,6 +96,7 @@ export async function commitFromComment(opts) {
     const formattedComment = opts.formattedComment ?? formatCommentBodyForCommit(opts.commentBody, opts.config);
     const body = deriveCommitBodyFromComment({
         taskId: opts.taskId,
+        executorAgent: opts.executorAgent,
         author: opts.author,
         statusFrom: opts.statusFrom,
         statusTo: opts.statusTo,
@@ -121,6 +123,8 @@ export async function commitFromComment(opts) {
     // Base overrides must be explicit via the `commit` command's --allow-base flag.
     const env = buildGitCommitEnv({
         taskId: opts.taskId,
+        agentId: opts.executorAgent,
+        statusTo: opts.statusTo,
         allowTasks: opts.allowTasks,
         allowBase: false,
         allowPolicy: false,

package/dist/commands/guard/impl/env.d.ts

@@ -1,5 +1,7 @@
 export declare function buildGitCommitEnv(opts: {
     taskId: string;
+    agentId?: string;
+    statusTo?: string;
     allowTasks: boolean;
     allowBase: boolean;
     allowPolicy: boolean;

package/dist/commands/guard/impl/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAAC,UAAU,CAWpB"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAAC,UAAU,CAapB"}

package/dist/commands/guard/impl/env.js

@@ -2,6 +2,8 @@ export function buildGitCommitEnv(opts) {
     return {
         ...process.env,
         AGENTPLANE_TASK_ID: opts.taskId,
+        ...(opts.agentId ? { AGENTPLANE_AGENT_ID: opts.agentId } : null),
+        ...(opts.statusTo ? { AGENTPLANE_STATUS_TO: opts.statusTo } : null),
         AGENTPLANE_ALLOW_TASKS: opts.allowTasks ? "1" : "0",
         AGENTPLANE_ALLOW_BASE: opts.allowBase ? "1" : "0",
         AGENTPLANE_ALLOW_POLICY: opts.allowPolicy ? "1" : "0",

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":"AAgBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAgG5E,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,CA2FlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAgG5E,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,CA8HlB"}

package/dist/commands/hooks/index.js

@@ -1,14 +1,17 @@
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { getStagedFiles, loadConfig, resolveBaseBranch, resolveProject } from "@agentplaneorg/core";
+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 { resolveCommitEmojiForAgent } from "../../shared/agent-emoji.js";
 import { CliError } from "../../shared/errors.js";
+import { GitContext } from "../shared/git-context.js";
 import { throwIfPolicyDenied } from "../shared/policy-deny.js";
 import { gitCurrentBranch, gitRevParse } from "../shared/git-ops.js";
 import { isPathWithin } from "../shared/path.js";
+import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
 const HOOK_MARKER = "agentplane-hook";
 const SHIM_MARKER = "agentplane-hook-shim";
 export const HOOK_NAMES = ["commit-msg", "pre-commit", "pre-push"];
@@ -183,6 +186,42 @@ export async function cmdHooksRun(opts) {
             });
             const loaded = await loadConfig(resolved.agentplaneDir);
             const taskId = (process.env.AGENTPLANE_TASK_ID ?? "").trim();
+            const statusTo = (process.env.AGENTPLANE_STATUS_TO ?? "").trim().toUpperCase();
+            const agentsDirAbs = path.join(resolved.gitRoot, loaded.config.paths.agents_dir);
+            let agentId = (process.env.AGENTPLANE_AGENT_ID ?? "").trim();
+            if (!agentId && loaded.config.workflow_mode === "direct" && taskId) {
+                const lock = await readDirectWorkLock(resolved.agentplaneDir);
+                const lockAgent = lock?.agent?.trim() ?? "";
+                if (lock?.task_id === taskId && lockAgent)
+                    agentId = lockAgent;
+            }
+            const emoji = subject.split(/\s+/).find(Boolean) ?? "";
+            if (taskId) {
+                if (statusTo === "DONE") {
+                    if (emoji !== "✅") {
+                        throw new CliError({
+                            exitCode: 5,
+                            code: "E_GIT",
+                            message: "Finish commits must use a checkmark emoji.\n" +
+                                "Expected:\n" +
+                                "  ✅ <TASK_SUFFIX> <scope>: <summary>",
+                        });
+                    }
+                }
+                else if (agentId) {
+                    const expectedEmoji = await resolveCommitEmojiForAgent({ agentsDirAbs, agentId });
+                    if (emoji !== expectedEmoji) {
+                        throw new CliError({
+                            exitCode: 5,
+                            code: "E_GIT",
+                            message: "Commit emoji does not match the executor agent policy.\n" +
+                                `executor_agent=${agentId}\n` +
+                                "Expected:\n" +
+                                `  ${expectedEmoji} <TASK_SUFFIX> <scope>: <summary>`,
+                        });
+                    }
+                }
+            }
             const res = evaluatePolicy({
                 action: "hook_commit_msg",
                 config: loaded.config,
@@ -194,10 +233,11 @@ export async function cmdHooksRun(opts) {
             return 0;
         }
         if (opts.hook === "pre-commit") {
-            const staged = await getStagedFiles({
+            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";
@@ -206,10 +246,6 @@ export async function cmdHooksRun(opts) {
             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 resolved = await resolveProject({
-                cwd: opts.cwd,
-                rootOverride: opts.rootOverride ?? null,
-            });
             const loaded = await loadConfig(resolved.agentplaneDir);
             const inBranchPr = loaded.config.workflow_mode === "branch_pr";
             const baseBranch = inBranchPr

package/dist/commands/recipes/impl/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project.ts"],"names":[],"mappings":"AASA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAa7D"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/commands/recipes/impl/project.ts"],"names":[],"mappings":"AAaA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAa7D"}

package/dist/commands/recipes/impl/project.js

@@ -1,7 +1,9 @@
 import { resolveProject } from "@agentplaneorg/core";
-function isNotGitRepoError(err) {
+function isNoProjectError(err) {
     if (err instanceof Error) {
-        return err.message.startsWith("Not a git repository");
+        return (err.message.startsWith("Not an agentplane project") ||
+            err.message.startsWith("Not a git repository") ||
+            err.message.startsWith("Agentplane project root is not a git repository"));
     }
     return false;
 }
@@ -13,7 +15,7 @@ export async function maybeResolveProject(opts) {
         });
     }
     catch (err) {
-        if (isNotGitRepoError(err)) {
+        if (isNoProjectError(err)) {
             if (opts.rootOverride)
                 throw err;
             return null;

package/dist/commands/shared/git-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-ops.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-ops.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBnE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}

package/dist/commands/shared/git-ops.js

@@ -28,8 +28,13 @@ export async function gitCurrentBranch(cwd) {
         env: gitEnv(),
     });
     const trimmed = stdout.trim();
-    if (!trimmed || trimmed === "HEAD")
-        throw new Error("Failed to resolve git branch");
+    if (!trimmed || trimmed === "HEAD") {
+        throw new CliError({
+            code: "E_GIT",
+            exitCode: exitCodeForError("E_GIT"),
+            message: "Detached HEAD: failed to resolve current branch",
+        });
+    }
     return trimmed;
 }
 export async function gitBranchExists(cwd, branch) {

package/dist/commands/task/block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAYnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGlB"}
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/commands/task/block.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAcnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuHlB"}

package/dist/commands/task/block.js

@@ -1,11 +1,12 @@
 import { mapBackendError } from "../../cli/error-map.js";
-import { successMessage } from "../../cli/output.js";
+import { invalidValueMessage, successMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
 import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
-import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
+import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
+import { appendTaskEvent, defaultCommitEmojiForAgentId, enforceStatusCommitPolicy, isTransitionAllowed, nowIso, requireStructuredComment, } from "./shared.js";
 export async function cmdBlock(opts) {
     try {
         const ctx = opts.ctx ??
@@ -63,17 +64,34 @@ export async function cmdBlock(opts) {
             : ctx.taskBackend.writeTask(nextTask));
         let commitInfo = null;
         if (opts.commitFromComment) {
+            const mode = ctx.config.workflow_mode;
+            let executorAgent = opts.author;
+            if (mode === "direct") {
+                const lock = await readDirectWorkLock(ctx.resolvedProject.agentplaneDir);
+                const lockAgent = lock?.task_id === opts.taskId ? (lock.agent?.trim() ?? "") : "";
+                if (lockAgent)
+                    executorAgent = lockAgent;
+            }
+            const expectedEmoji = await defaultCommitEmojiForAgentId(ctx, executorAgent);
+            if (typeof opts.commitEmoji === "string" && opts.commitEmoji.trim() !== expectedEmoji) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueMessage("--commit-emoji", opts.commitEmoji, `${expectedEmoji} (executor agent=${executorAgent})`),
+                });
+            }
             commitInfo = await commitFromComment({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,
+                executorAgent,
                 author: opts.author,
                 statusFrom: currentStatus,
                 statusTo: "BLOCKED",
                 commentBody: opts.body,
                 formattedComment,
-                emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus("BLOCKED"),
+                emoji: opts.commitEmoji ?? expectedEmoji,
                 allow: opts.commitAllow,
                 autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
                 allowTasks: opts.commitAllowTasks,

package/dist/commands/task/finish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AA+BnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgMlB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAiCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmOlB"}

package/dist/commands/task/finish.js

@@ -1,5 +1,5 @@
 import { mapBackendError } from "../../cli/error-map.js";
-import { successMessage } from "../../cli/output.js";
+import { invalidValueMessage, successMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { readFile, rm } from "node:fs/promises";
@@ -7,6 +7,7 @@ import path from "node:path";
 import { commitFromComment } from "../guard/index.js";
 import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
+import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
 import { appendTaskEvent, defaultCommitEmojiForStatus, enforceStatusCommitPolicy, ensureVerificationSatisfiedIfRequired, nowIso, readCommitInfo, readHeadCommit, requireStructuredComment, } from "./shared.js";
 async function clearDirectWorkLockIfMatches(opts) {
     const lockPath = path.join(opts.agentplaneDir, "cache", "direct-work.json");
@@ -140,12 +141,31 @@ export async function cmdFinish(opts) {
                 : ctx.taskBackend.writeTask(nextTask));
         }
         // tasks.json is export-only; generated via `agentplane task export`.
+        let executorAgent = null;
+        if (opts.commitFromComment || opts.statusCommit) {
+            const mode = ctx.config.workflow_mode;
+            executorAgent = opts.author;
+            if (mode === "direct") {
+                const lock = await readDirectWorkLock(ctx.resolvedProject.agentplaneDir);
+                const lockAgent = lock?.task_id === primaryTaskId ? (lock.agent?.trim() ?? "") : "";
+                if (lockAgent)
+                    executorAgent = lockAgent;
+            }
+        }
         if (opts.commitFromComment) {
+            if (typeof opts.commitEmoji === "string" && opts.commitEmoji.trim() !== "✅") {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueMessage("--commit-emoji", opts.commitEmoji, "✅ (finish commits must use a checkmark)"),
+                });
+            }
             await commitFromComment({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
+                executorAgent: executorAgent ?? undefined,
                 author: opts.author,
                 statusFrom: primaryStatusFrom ?? undefined,
                 statusTo: "DONE",
@@ -161,11 +181,19 @@ export async function cmdFinish(opts) {
             });
         }
         if (opts.statusCommit) {
+            if (typeof opts.statusCommitEmoji === "string" && opts.statusCommitEmoji.trim() !== "✅") {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueMessage("--status-commit-emoji", opts.statusCommitEmoji, "✅ (finish commits must use a checkmark)"),
+                });
+            }
             await commitFromComment({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: primaryTaskId,
+                executorAgent: executorAgent ?? undefined,
                 author: opts.author,
                 statusFrom: primaryStatusFrom ?? undefined,
                 statusTo: "DONE",

package/dist/commands/task/shared.d.ts

@@ -40,6 +40,7 @@ export declare function readCommitInfo(cwd: string, rev: string): Promise<{
     message: string;
 }>;
 export declare function defaultCommitEmojiForStatus(status: string): string;
+export declare function defaultCommitEmojiForAgentId(ctx: CommandContext, agentId: string): Promise<string>;
 export type TaskListFilters = {
     status: string[];
     owner: string[];

package/dist/commands/task/shared.d.ts.map

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

package/dist/commands/task/shared.js

@@ -2,6 +2,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { readdir } from "node:fs/promises";
 import path from "node:path";
+import { resolveCommitEmojiForAgent } from "../../shared/agent-emoji.js";
 import { invalidValueForFlag, invalidValueMessage, missingValueMessage, warnMessage, } from "../../cli/output.js";
 import { fileExists } from "../../cli/fs-utils.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
@@ -256,6 +257,10 @@ export function defaultCommitEmojiForStatus(status) {
         return "⛔";
     return "🧩";
 }
+export async function defaultCommitEmojiForAgentId(ctx, agentId) {
+    const agentsDir = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.agents_dir);
+    return await resolveCommitEmojiForAgent({ agentsDirAbs: agentsDir, agentId });
+}
 export function parseTaskListFilters(args, opts) {
     const out = { status: [], owner: [], tag: [], quiet: false };
     for (let i = 0; i < args.length; i++) {

package/dist/commands/task/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAiBnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqKlB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAoBnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2LlB"}

package/dist/commands/task/start.js

@@ -1,11 +1,12 @@
 import { mapBackendError } from "../../cli/error-map.js";
-import { successMessage, warnMessage } from "../../cli/output.js";
+import { invalidValueMessage, successMessage, warnMessage } from "../../cli/output.js";
 import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
 import { CliError } from "../../shared/errors.js";
 import { commitFromComment } from "../guard/index.js";
 import { listTasksMemo, loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
 import { backendIsLocalFileBackend, getTaskStore } from "../shared/task-store.js";
-import { appendTaskEvent, buildDependencyState, ensurePlanApprovedIfRequired, enforceStatusCommitPolicy, extractDocSection, isVerifyStepsFilled, isTransitionAllowed, nowIso, requiresVerify, requireStructuredComment, toStringArray, } from "./shared.js";
+import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
+import { appendTaskEvent, buildDependencyState, ensurePlanApprovedIfRequired, enforceStatusCommitPolicy, defaultCommitEmojiForAgentId, extractDocSection, isVerifyStepsFilled, isTransitionAllowed, nowIso, requiresVerify, requireStructuredComment, toStringArray, } from "./shared.js";
 export async function cmdStart(opts) {
     try {
         const ctx = opts.ctx ??
@@ -120,17 +121,34 @@ export async function cmdStart(opts) {
             : ctx.taskBackend.writeTask(nextTask));
         let commitInfo = null;
         if (opts.commitFromComment) {
+            const mode = ctx.config.workflow_mode;
+            let executorAgent = opts.author;
+            if (mode === "direct") {
+                const lock = await readDirectWorkLock(ctx.resolvedProject.agentplaneDir);
+                const lockAgent = lock?.task_id === opts.taskId ? (lock.agent?.trim() ?? "") : "";
+                if (lockAgent)
+                    executorAgent = lockAgent;
+            }
+            const expectedEmoji = await defaultCommitEmojiForAgentId(ctx, executorAgent);
+            if (typeof opts.commitEmoji === "string" && opts.commitEmoji.trim() !== expectedEmoji) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: invalidValueMessage("--commit-emoji", opts.commitEmoji, `${expectedEmoji} (executor agent=${executorAgent})`),
+                });
+            }
             commitInfo = await commitFromComment({
                 ctx,
                 cwd: opts.cwd,
                 rootOverride: opts.rootOverride,
                 taskId: opts.taskId,
+                executorAgent,
                 author: opts.author,
                 statusFrom: currentStatus,
                 statusTo: "DOING",
                 commentBody: opts.body,
                 formattedComment,
-                emoji: opts.commitEmoji ?? "🚧",
+                emoji: opts.commitEmoji ?? expectedEmoji,
                 allow: opts.commitAllow,
                 autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
                 allowTasks: opts.commitAllowTasks,

package/dist/policy/rules/commit-subject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-subject.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/commit-subject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAkClE"}
+{"version":3,"file":"commit-subject.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/commit-subject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAmBlE"}

package/dist/policy/rules/commit-subject.js

@@ -5,21 +5,9 @@ export function commitSubjectRule(ctx) {
     if (!subject) {
         return { ok: false, errors: [gitError("Commit message subject is empty")], warnings: [] };
     }
-    const taskId = (ctx.taskId ?? "").trim();
-    if (!taskId) {
-        return {
-            ok: false,
-            errors: [
-                gitError(ctx.action === "hook_commit_msg"
-                    ? "AGENTPLANE_TASK_ID is required (use `agentplane commit ...`)"
-                    : "Task id is required for commit subject validation"),
-            ],
-            warnings: [],
-        };
-    }
     const policy = validateCommitSubject({
         subject,
-        taskId,
+        taskId: (ctx.taskId ?? "").trim() || undefined,
         genericTokens: ctx.config.commit.generic_tokens,
     });
     if (!policy.ok) {

package/dist/shared/agent-emoji.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveCommitEmojiForAgent(opts: {
+    agentsDirAbs: string;
+    agentId: string;
+}): Promise<string>;
+//# sourceMappingURL=agent-emoji.d.ts.map

package/dist/shared/agent-emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-emoji.d.ts","sourceRoot":"","sources":["../../src/shared/agent-emoji.ts"],"names":[],"mappings":"AAmCA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

package/dist/shared/agent-emoji.js

@@ -0,0 +1,50 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../cli/fs-utils.js";
+const FALLBACK_EMOJIS = ["🧭", "🧠", "🏗️", "🧪", "🛠️", "🔧", "🧩", "🔍", "📦"];
+const WELL_KNOWN_AGENT_EMOJI = {
+    ORCHESTRATOR: "🧭",
+    PLANNER: "🧠",
+    CREATOR: "🏗️",
+    INTEGRATOR: "🧩",
+    TESTER: "🧪",
+    CODER: "🛠️",
+};
+function stableHash32(input) {
+    // Simple, stable FNV-1a 32-bit hash (good enough for deterministic emoji selection).
+    // FNV-1a offset basis / prime in decimal to avoid numeric-separator style lint quirks.
+    let h = 2_166_136_261;
+    for (const ch of input) {
+        const cp = ch.codePointAt(0) ?? 0;
+        h ^= cp;
+        h = Math.imul(h, 16_777_619);
+    }
+    return h >>> 0;
+}
+function fallbackEmojiForAgentId(agentId) {
+    const wellKnown = WELL_KNOWN_AGENT_EMOJI[agentId];
+    if (wellKnown)
+        return wellKnown;
+    const idx = stableHash32(agentId) % FALLBACK_EMOJIS.length;
+    return FALLBACK_EMOJIS[idx] ?? "🧩";
+}
+export async function resolveCommitEmojiForAgent(opts) {
+    const agentId = opts.agentId.trim();
+    if (!agentId)
+        return "🧩";
+    // Allow users to override the emoji per agent by adding `commit_emoji` to the agent json file.
+    const agentPath = path.join(opts.agentsDirAbs, `${agentId}.json`);
+    if (await fileExists(agentPath)) {
+        try {
+            const text = await readFile(agentPath, "utf8");
+            const parsed = JSON.parse(text);
+            const emoji = parsed && typeof parsed.commit_emoji === "string" ? parsed.commit_emoji.trim() : "";
+            if (emoji)
+                return emoji;
+        }
+        catch {
+            // ignore; fallback below
+        }
+    }
+    return fallbackEmojiForAgentId(agentId);
+}

package/dist/shared/direct-work-lock.d.ts

@@ -0,0 +1,10 @@
+export type DirectWorkLock = {
+    task_id: string;
+    agent: string;
+    slug: string;
+    branch: string;
+    started_at: string;
+};
+export declare function directWorkLockPath(agentplaneDir: string): string;
+export declare function readDirectWorkLock(agentplaneDir: string): Promise<DirectWorkLock | null>;
+//# sourceMappingURL=direct-work-lock.d.ts.map

package/dist/shared/direct-work-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-work-lock.d.ts","sourceRoot":"","sources":["../../src/shared/direct-work-lock.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkB9F"}

package/dist/shared/direct-work-lock.js

@@ -0,0 +1,24 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export function directWorkLockPath(agentplaneDir) {
+    return path.join(agentplaneDir, "cache", "direct-work.json");
+}
+export async function readDirectWorkLock(agentplaneDir) {
+    try {
+        const text = await readFile(directWorkLockPath(agentplaneDir), "utf8");
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (typeof parsed.task_id !== "string" ||
+            typeof parsed.agent !== "string" ||
+            typeof parsed.slug !== "string" ||
+            typeof parsed.branch !== "string" ||
+            typeof parsed.started_at !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -54,7 +54,7 @@
     "prepublishOnly": "npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.2.5",
+    "@agentplaneorg/core": "0.2.6",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {