agentplane 0.3.16 → 0.3.18

package/dist/commands/branch/base.js

@@ -1,4 +1,6 @@
-import { clearPinnedBaseBranch, getPinnedBaseBranch, loadConfig, resolveBaseBranch, resolveProject, setPinnedBaseBranch, } from "@agentplaneorg/core";
+import { loadConfig } from "@agentplaneorg/core/config";
+import { resolveProject } from "@agentplaneorg/core/project";
+import { clearPinnedBaseBranch, getPinnedBaseBranch, resolveBaseBranch, setPinnedBaseBranch, } from "@agentplaneorg/core/git";
 import { mapCoreError } from "../../cli/error-map.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";

package/dist/commands/branch/cleanup-merged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup-merged.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/cleanup-merged.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAgInC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyJlB"}
+{"version":3,"file":"cleanup-merged.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/cleanup-merged.ts"],"names":[],"mappings":"AAwBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAgInC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyJlB"}

package/dist/commands/branch/cleanup-merged.js

@@ -1,15 +1,14 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { resolveBaseBranch } from "@agentplaneorg/core";
+import { resolveBaseBranch, gitEnv, gitDiffNames, findWorktreeForBranch, gitListBranchesByPrefixes, parseTaskIdFromCloseBranch, parseTaskIdFromBranch, } from "@agentplaneorg/core/git";
+import { normalizeTaskStatus } from "@agentplaneorg/core/tasks";
 import { mapBackendError } from "../../cli/error-map.js";
 import { createCliEmitter, unknownEntityMessage, workflowModeMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { ensureGitClean } from "../guard/index.js";
-import { execFileAsync, gitEnv } from "../shared/git.js";
-import { gitDiffNames } from "../shared/git-diff.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
 import { gitBranchExists, gitCurrentBranch, gitIsAncestor } from "../shared/git-ops.js";
 import { cleanupMergedLocalBranch } from "../shared/merged-branch-cleanup.js";
-import { findWorktreeForBranch, gitListBranchesByPrefixes, parseTaskIdFromCloseBranch, parseTaskIdFromBranch, } from "../shared/git-worktree.js";
 import { isPathWithin, resolvePathFallback } from "../shared/path.js";
 import { parsePrMeta } from "../shared/pr-meta.js";
 import { loadTaskFromContext, loadCommandContext, } from "../shared/task-backend.js";
@@ -70,7 +69,7 @@ async function resolveCleanupCandidates(opts) {
         }
         if (!task)
             continue;
-        const status = String(task.status || "").toUpperCase();
+        const status = normalizeTaskStatus(task.status);
         if (status !== "DONE")
             continue;
         const diff = await gitDiffNames(opts.gitRoot, opts.baseBranch, branch);

package/dist/commands/branch/remove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/remove.ts"],"names":[],"mappings":"AAYA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqElB"}
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/remove.ts"],"names":[],"mappings":"AAcA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqElB"}

package/dist/commands/branch/remove.js

@@ -1,10 +1,12 @@
 import path from "node:path";
-import { loadConfig, resolveProject } from "@agentplaneorg/core";
+import { loadConfig } from "@agentplaneorg/core/config";
+import { resolveProject } from "@agentplaneorg/core/project";
 import { mapCoreError } from "../../cli/error-map.js";
 import { createCliEmitter, unknownEntityMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
 import { ensureActionApproved } from "../shared/approval-requirements.js";
-import { execFileAsync, gitEnv } from "../shared/git.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { gitEnv } from "@agentplaneorg/core/git";
 import { gitBranchExists } from "../shared/git-ops.js";
 import { isPathWithin, resolvePathFallback } from "../shared/path.js";
 export async function cmdBranchRemove(opts) {

package/dist/commands/branch/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/status.ts"],"names":[],"mappings":"AAWA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/status.ts"],"names":[],"mappings":"AAgBA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB"}

package/dist/commands/branch/status.js

@@ -1,11 +1,11 @@
-import { loadConfig, resolveBaseBranch, resolveProject } from "@agentplaneorg/core";
+import { loadConfig } from "@agentplaneorg/core/config";
+import { resolveProject } from "@agentplaneorg/core/project";
+import { resolveBaseBranch, gitAheadBehind, findWorktreeForBranch, parseTaskIdFromBranch, } from "@agentplaneorg/core/git";
 import { mapCoreError } from "../../cli/error-map.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { createCliEmitter, unknownEntityMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { gitAheadBehind } from "../shared/git-diff.js";
 import { gitBranchExists, gitCurrentBranch } from "../shared/git-ops.js";
-import { findWorktreeForBranch, parseTaskIdFromBranch } from "../shared/git-worktree.js";
 const output = createCliEmitter();
 export async function cmdBranchStatus(opts) {
     try {

package/dist/commands/branch/work-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAsRnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}
+{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmBnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}

package/dist/commands/branch/work-start.direct.d.ts

@@ -0,0 +1,13 @@
+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>;
+export declare function writeDirectWorkLock(agentplaneDir: string, lock: DirectWorkLock): Promise<void>;
+export declare function ensureGitClean(gitRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=work-start.direct.d.ts.map

package/dist/commands/branch/work-start.direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.direct.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.direct.ts"],"names":[],"mappings":"AAQA,KAAK,cAAc,GAAG;IACpB,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,CAGhE;AAED,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkB9F;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCnE"}

package/dist/commands/branch/work-start.direct.js

@@ -0,0 +1,76 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { gitEnv } from "@agentplaneorg/core/git";
+export function directWorkLockPath(agentplaneDir) {
+    // Intentionally under cache/ so it stays out of git by default.
+    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;
+    }
+}
+export async function writeDirectWorkLock(agentplaneDir, lock) {
+    const dir = path.dirname(directWorkLockPath(agentplaneDir));
+    await mkdir(dir, { recursive: true });
+    await writeFile(directWorkLockPath(agentplaneDir), JSON.stringify(lock, null, 2) + "\n", "utf8");
+}
+export async function ensureGitClean(gitRoot) {
+    const { stdout } = await execFileAsync("git", ["status", "--porcelain"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+    });
+    const lines = stdout
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return;
+    // Allow task workflow artifacts to be dirty. In direct mode we want a single-stream
+    // workflow without task branches, but we still expect task docs to change.
+    const allowedPrefixes = [
+        ".agentplane/tasks/",
+        ".agentplane/tasks.json",
+        ".agentplane/cache/",
+        ".agentplane/.upgrade/",
+        ".agentplane/upgrade/",
+    ];
+    const isAllowed = (p) => allowedPrefixes.some((prefix) => p.startsWith(prefix));
+    const dirty = lines
+        .map((line) => {
+        // Format: XY <path> (we only need the path-ish tail).
+        const rest = line.slice(2).trim();
+        if (!rest)
+            return "";
+        // Rename/copy format: "old -> new"
+        const arrow = rest.lastIndexOf(" -> ");
+        if (arrow === -1)
+            return rest;
+        return rest.slice(arrow + 4).trim();
+    })
+        .filter((p) => p.length > 0 && !isAllowed(p));
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: "Working tree has non-task changes. In workflow_mode=direct, agentplane runs tasks in a single stream on the current branch; commit/stash your changes before starting a different task.",
+    });
+}

package/dist/commands/branch/work-start.git.d.ts

@@ -0,0 +1,3 @@
+export { resolveBaseBranch } from "@agentplaneorg/core/git";
+export declare function ensureCurrentBaseBranch(gitRoot: string, baseBranch: string): Promise<void>;
+//# sourceMappingURL=work-start.git.d.ts.map

package/dist/commands/branch/work-start.git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.git.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.git.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG"}

package/dist/commands/branch/work-start.git.js

@@ -0,0 +1,19 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { gitAheadBehind } from "@agentplaneorg/core/git";
+import { gitBranchUpstream } from "../shared/git-ops.js";
+export { resolveBaseBranch } from "@agentplaneorg/core/git";
+export async function ensureCurrentBaseBranch(gitRoot, baseBranch) {
+    const upstreamBranch = await gitBranchUpstream(gitRoot, baseBranch);
+    if (!upstreamBranch)
+        return;
+    const { behind } = await gitAheadBehind(gitRoot, upstreamBranch, baseBranch);
+    if (behind === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `Base branch ${baseBranch} is behind its upstream ${upstreamBranch} by ${behind} commit(s). ` +
+            "Refresh the base branch before `agentplane work start` to avoid DIRTY hosted PRs.",
+    });
+}

package/dist/commands/branch/work-start.hook-shim.d.ts

@@ -0,0 +1,2 @@
+export declare function materializeHookShimForWorktree(worktreePath: string): Promise<void>;
+//# sourceMappingURL=work-start.hook-shim.d.ts.map

package/dist/commands/branch/work-start.hook-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.hook-shim.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.hook-shim.ts"],"names":[],"mappings":"AAkCA,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxF"}

package/dist/commands/branch/work-start.hook-shim.js

@@ -0,0 +1,38 @@
+import { chmod, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../../cli/fs-utils.js";
+const HOOK_SHIM_MARKER = "agentplane-hook-shim";
+function repoLocalHookShimText() {
+    return [
+        "#!/usr/bin/env sh",
+        `# ${HOOK_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");
+}
+export async function materializeHookShimForWorktree(worktreePath) {
+    const shimPath = path.join(worktreePath, ".agentplane", "bin", "agentplane");
+    if (await fileExists(shimPath))
+        return;
+    await mkdir(path.dirname(shimPath), { recursive: true });
+    await writeFile(shimPath, repoLocalHookShimText(), "utf8");
+    await chmod(shimPath, 0o755);
+}

package/dist/commands/branch/work-start.js

@@ -1,249 +1,21 @@
-import { chmod, copyFile, cp, mkdir, readFile, readdir, rm, symlink, writeFile, } from "node:fs/promises";
+import { mkdir } from "node:fs/promises";
 import path from "node:path";
-import { resolveBaseBranch } from "@agentplaneorg/core";
-import { LocalBackend } from "../../backends/task-backend.js";
 import { mapBackendError } from "../../cli/error-map.js";
 import { fileExists } from "../../cli/fs-utils.js";
 import { exitCodeForError } from "../../cli/exit-codes.js";
 import { createCliEmitter } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { execFileAsync, gitEnv } from "../shared/git.js";
-import { gitAheadBehind } from "../shared/git-diff.js";
-import { gitBranchExists, gitBranchUpstream, gitCurrentBranch } from "../shared/git-ops.js";
+import { execFileAsync } from "@agentplaneorg/core/process";
+import { gitEnv } from "@agentplaneorg/core/git";
+import { gitBranchExists, gitCurrentBranch } from "../shared/git-ops.js";
 import { isPathWithin } from "../shared/path.js";
-import { resolveRuntimeSourceInfo } from "../../runtime/shared/runtime-source.js";
 import { loadBackendTask, loadCommandContext, } from "../shared/task-backend.js";
-function isPresentString(value) {
-    return value !== null;
-}
 import { ensurePlanApprovedIfRequired } from "../task/shared.js";
 import { validateWorkAgent, validateWorkSlug } from "./internal/work-validate.js";
-const HOOK_SHIM_MARKER = "agentplane-hook-shim";
-function repoLocalHookShimText() {
-    return [
-        "#!/usr/bin/env sh",
-        `# ${HOOK_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");
-}
-function directWorkLockPath(agentplaneDir) {
-    // Intentionally under cache/ so it stays out of git by default.
-    return path.join(agentplaneDir, "cache", "direct-work.json");
-}
-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;
-    }
-}
-async function writeDirectWorkLock(agentplaneDir, lock) {
-    const dir = path.dirname(directWorkLockPath(agentplaneDir));
-    await mkdir(dir, { recursive: true });
-    await writeFile(directWorkLockPath(agentplaneDir), JSON.stringify(lock, null, 2) + "\n", "utf8");
-}
-async function materializeLocalBackendReadmesForWorktree(opts) {
-    if (!(opts.backend instanceof LocalBackend))
-        return;
-    const sourceRoot = path.resolve(opts.backend.root);
-    if (!isPathWithin(opts.repoRoot, sourceRoot))
-        return;
-    const relativeRoot = path.relative(opts.repoRoot, sourceRoot);
-    const targetRoot = path.join(opts.worktreePath, relativeRoot);
-    const entries = await readdir(sourceRoot, { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        const sourceTaskRoot = path.join(sourceRoot, entry.name);
-        const sourceReadme = path.join(sourceRoot, entry.name, "README.md");
-        if (!(await fileExists(sourceReadme)))
-            continue;
-        const targetReadme = path.join(targetRoot, entry.name, "README.md");
-        await mkdir(path.dirname(targetReadme), { recursive: true });
-        await copyFile(sourceReadme, targetReadme);
-        if (entry.name !== opts.taskId)
-            continue;
-        // Hand off ownership of the active task README to the task worktree so
-        // later merges cannot collide with a stale untracked copy on the base checkout.
-        await rm(sourceReadme, { force: true });
-        const remainingEntries = await readdir(sourceTaskRoot).catch(() => []);
-        if (remainingEntries.length === 0) {
-            await rm(sourceTaskRoot, { recursive: true, force: true });
-        }
-    }
-}
-async function materializeRepoLocalDistForWorktree(opts) {
-    const runtimeSource = resolveRuntimeSourceInfo({ cwd: process.cwd() });
-    const sourceRoots = [
-        ...new Set([
-            path.resolve(opts.repoRoot),
-            path.resolve(process.cwd()),
-            runtimeSource.agentplane.packageRoot
-                ? path.resolve(runtimeSource.agentplane.packageRoot, "..", "..")
-                : null,
-        ].filter((value) => isPresentString(value))),
-    ];
-    const copyTargets = [
-        ["packages/core/dist", "packages/core/dist"],
-        ["packages/agentplane/dist", "packages/agentplane/dist"],
-        ["packages/agentplane/bin", "packages/agentplane/bin"],
-    ];
-    for (const [sourceRelativePath, targetRelativePath] of copyTargets) {
-        let sourcePath = "";
-        for (const sourceRoot of sourceRoots) {
-            const candidate = path.join(sourceRoot, sourceRelativePath);
-            if (await fileExists(candidate)) {
-                sourcePath = candidate;
-                break;
-            }
-        }
-        if (!sourcePath)
-            continue;
-        const targetPath = path.join(opts.worktreePath, targetRelativePath);
-        if (await fileExists(targetPath))
-            continue;
-        await mkdir(path.dirname(targetPath), { recursive: true });
-        await cp(sourcePath, targetPath, { recursive: true });
-    }
-}
-async function linkDirectoryIntoWorktree(opts) {
-    let sourcePath = "";
-    for (const sourceRoot of opts.sourceRoots) {
-        const candidate = path.join(sourceRoot, opts.relativePath);
-        if (await fileExists(candidate)) {
-            sourcePath = candidate;
-            break;
-        }
-    }
-    if (!sourcePath)
-        return false;
-    const targetPath = path.join(opts.worktreePath, opts.relativePath);
-    if (await fileExists(targetPath))
-        return false;
-    await mkdir(path.dirname(targetPath), { recursive: true });
-    await symlink(sourcePath, targetPath, process.platform === "win32" ? "junction" : "dir");
-    return true;
-}
-async function materializeRepoLocalInstallLayoutForWorktree(opts) {
-    const runtimeSource = resolveRuntimeSourceInfo({ cwd: process.cwd() });
-    const sourceRoots = [
-        ...new Set([
-            path.resolve(opts.repoRoot),
-            path.resolve(process.cwd()),
-            runtimeSource.agentplane.packageRoot
-                ? path.resolve(runtimeSource.agentplane.packageRoot, "..", "..")
-                : null,
-        ].filter((value) => isPresentString(value))),
-    ];
-    const linkTargets = [
-        "node_modules",
-        path.join("packages", "core", "node_modules"),
-        path.join("packages", "agentplane", "node_modules"),
-        "agentplane-recipes",
-    ];
-    for (const relativePath of linkTargets) {
-        await linkDirectoryIntoWorktree({
-            sourceRoots,
-            worktreePath: opts.worktreePath,
-            relativePath,
-        });
-    }
-}
-async function materializeHookShimForWorktree(worktreePath) {
-    const shimPath = path.join(worktreePath, ".agentplane", "bin", "agentplane");
-    if (await fileExists(shimPath))
-        return;
-    await mkdir(path.dirname(shimPath), { recursive: true });
-    await writeFile(shimPath, repoLocalHookShimText(), "utf8");
-    await chmod(shimPath, 0o755);
-}
-async function ensureGitClean(gitRoot) {
-    const { stdout } = await execFileAsync("git", ["status", "--porcelain"], {
-        cwd: gitRoot,
-        env: gitEnv(),
-    });
-    const lines = stdout
-        .split("\n")
-        .map((line) => line.trimEnd())
-        .filter((line) => line.trim().length > 0);
-    if (lines.length === 0)
-        return;
-    // Allow task workflow artifacts to be dirty. In direct mode we want a single-stream
-    // workflow without task branches, but we still expect task docs to change.
-    const allowedPrefixes = [
-        ".agentplane/tasks/",
-        ".agentplane/tasks.json",
-        ".agentplane/cache/",
-        ".agentplane/.upgrade/",
-        ".agentplane/upgrade/",
-    ];
-    const isAllowed = (p) => allowedPrefixes.some((prefix) => p.startsWith(prefix));
-    const dirty = lines
-        .map((line) => {
-        // Format: XY <path> (we only need the path-ish tail).
-        const rest = line.slice(2).trim();
-        if (!rest)
-            return "";
-        // Rename/copy format: "old -> new"
-        const arrow = rest.lastIndexOf(" -> ");
-        if (arrow === -1)
-            return rest;
-        return rest.slice(arrow + 4).trim();
-    })
-        .filter((p) => p.length > 0 && !isAllowed(p));
-    if (dirty.length === 0)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: "Working tree has non-task changes. In workflow_mode=direct, agentplane runs tasks in a single stream on the current branch; commit/stash your changes before starting a different task.",
-    });
-}
-async function ensureCurrentBaseBranch(gitRoot, baseBranch) {
-    const upstreamBranch = await gitBranchUpstream(gitRoot, baseBranch);
-    if (!upstreamBranch)
-        return;
-    const { behind } = await gitAheadBehind(gitRoot, upstreamBranch, baseBranch);
-    if (behind === 0)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: `Base branch ${baseBranch} is behind its upstream ${upstreamBranch} by ${behind} commit(s). ` +
-            "Refresh the base branch before `agentplane work start` to avoid DIRTY hosted PRs.",
-    });
-}
+import { directWorkLockPath, ensureGitClean, readDirectWorkLock, writeDirectWorkLock, } from "./work-start.direct.js";
+import { ensureCurrentBaseBranch, resolveBaseBranch } from "./work-start.git.js";
+import { materializeHookShimForWorktree } from "./work-start.hook-shim.js";
+import { materializeLocalBackendReadmesForWorktree, materializeRepoLocalDistForWorktree, materializeRepoLocalInstallLayoutForWorktree, } from "./work-start.materialize.js";
 export async function cmdWorkStart(opts) {
     try {
         const output = createCliEmitter();

package/dist/commands/branch/work-start.materialize.d.ts

@@ -0,0 +1,16 @@
+import type { CommandContext } from "../shared/task-backend.js";
+export declare function materializeLocalBackendReadmesForWorktree(opts: {
+    backend: CommandContext["taskBackend"];
+    repoRoot: string;
+    worktreePath: string;
+    taskId: string;
+}): Promise<void>;
+export declare function materializeRepoLocalDistForWorktree(opts: {
+    repoRoot: string;
+    worktreePath: string;
+}): Promise<void>;
+export declare function materializeRepoLocalInstallLayoutForWorktree(opts: {
+    repoRoot: string;
+    worktreePath: string;
+}): Promise<void>;
+//# sourceMappingURL=work-start.materialize.d.ts.map

package/dist/commands/branch/work-start.materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.materialize.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.materialize.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAOhE,wBAAsB,yCAAyC,CAAC,IAAI,EAAE;IACpE,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAyBD,wBAAsB,4CAA4C,CAAC,IAAI,EAAE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}