agentplane 0.3.16 → 0.3.17

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,20 @@
-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 { 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,CAyBhB;AAyBD,wBAAsB,4CAA4C,CAAC,IAAI,EAAE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}

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

@@ -0,0 +1,110 @@
+import { copyFile, cp, mkdir, readdir, rm, symlink } from "node:fs/promises";
+import path from "node:path";
+import { LocalBackend } from "../../backends/task-backend.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { resolveRuntimeSourceInfo } from "../../runtime/shared/runtime-source.js";
+import { isPathWithin } from "../shared/path.js";
+function isPresentString(value) {
+    return value !== null;
+}
+export 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 });
+        }
+    }
+}
+export async function materializeRepoLocalDistForWorktree(opts) {
+    const sourceRoots = resolveRuntimeSourceRoots(opts.repoRoot);
+    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;
+}
+export async function materializeRepoLocalInstallLayoutForWorktree(opts) {
+    const sourceRoots = resolveRuntimeSourceRoots(opts.repoRoot);
+    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,
+        });
+    }
+}
+function resolveRuntimeSourceRoots(repoRoot) {
+    const runtimeSource = resolveRuntimeSourceInfo({ cwd: process.cwd() });
+    return [
+        ...new Set([
+            path.resolve(repoRoot),
+            path.resolve(process.cwd()),
+            runtimeSource.agentplane.packageRoot
+                ? path.resolve(runtimeSource.agentplane.packageRoot, "..", "..")
+                : null,
+        ].filter((value) => isPresentString(value))),
+    ];
+}

package/dist/commands/doctor/fixes.d.ts

@@ -1,4 +1,3 @@
-import type { CommandContext } from "../shared/task-backend.js";
 export declare function safeFixGitignore(repoRoot: string): Promise<{
     changed: boolean;
     note: string;
@@ -7,8 +6,4 @@ export declare function safeFixTaskIndex(repoRoot: string): Promise<{
     changed: boolean;
     note: string;
 }>;
-export declare function safeFixLegacyUntrackedTaskReadmes(repoRoot: string, ctx?: CommandContext): Promise<{
-    changed: boolean;
-    note: string;
-}>;
 //# sourceMappingURL=fixes.d.ts.map

package/dist/commands/doctor/fixes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/fixes.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB7C;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7C;AAED,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA8E7C"}
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/fixes.ts"],"names":[],"mappings":"AAMA,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB7C;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7C"}

package/dist/commands/doctor/fixes.js

@@ -1,8 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { parseTaskReadme } from "@agentplaneorg/core";
 import { RUNTIME_GITIGNORE_LINES } from "../../runtime/shared/runtime-artifacts.js";
-import { GitContext } from "../shared/git-context.js";
 import { loadCommandContext } from "../shared/task-backend.js";
 export async function safeFixGitignore(repoRoot) {
     const gitignorePath = path.join(repoRoot, ".gitignore");
@@ -40,71 +38,3 @@ export async function safeFixTaskIndex(repoRoot) {
         return { changed: false, note: "Skip: could not rebuild tasks index cache." };
     }
 }
-export async function safeFixLegacyUntrackedTaskReadmes(repoRoot, ctx) {
-    const commandCtx = ctx ??
-        (await loadCommandContext({
-            cwd: repoRoot,
-            rootOverride: null,
-        }));
-    const workflowDir = (commandCtx.config.paths.workflow_dir ?? ".agentplane/tasks").replaceAll("\\", "/");
-    const git = commandCtx.git ?? new GitContext({ gitRoot: repoRoot });
-    let untracked = [];
-    try {
-        untracked = await git.statusUntrackedPaths();
-    }
-    catch {
-        return { changed: false, note: "Skip: could not inspect untracked task README collisions." };
-    }
-    const candidates = untracked.filter((relPath) => relPath.startsWith(`${workflowDir}/`) && relPath.endsWith("/README.md"));
-    if (candidates.length === 0) {
-        return { changed: false, note: "OK: no legacy untracked task README collisions." };
-    }
-    const removed = [];
-    for (const relPath of candidates) {
-        const absPath = path.join(repoRoot, relPath);
-        let text = "";
-        try {
-            text = await fs.readFile(absPath, "utf8");
-        }
-        catch {
-            continue;
-        }
-        let parsed;
-        try {
-            parsed = parseTaskReadme(text);
-        }
-        catch {
-            continue;
-        }
-        const taskId = path.basename(path.dirname(absPath));
-        const parsedId = typeof parsed.frontmatter.id === "string" && parsed.frontmatter.id.trim().length > 0
-            ? parsed.frontmatter.id.trim()
-            : taskId;
-        const status = typeof parsed.frontmatter.status === "string"
-            ? parsed.frontmatter.status.trim().toUpperCase()
-            : "";
-        if (parsedId !== taskId || status !== "DONE")
-            continue;
-        await fs.rm(absPath, { force: true });
-        try {
-            const remaining = await fs.readdir(path.dirname(absPath));
-            if (remaining.length === 0) {
-                await fs.rmdir(path.dirname(absPath));
-            }
-        }
-        catch {
-            // Ignore cleanup failures for parent directories; the file removal is the actual fix.
-        }
-        removed.push(taskId);
-    }
-    if (removed.length === 0) {
-        return {
-            changed: false,
-            note: "OK: no safe-to-remove legacy untracked DONE task README collisions.",
-        };
-    }
-    return {
-        changed: true,
-        note: `Fixed: removed legacy untracked DONE task README collisions (${removed.join(", ")}).`,
-    };
-}

package/dist/commands/doctor/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workflow.ts"],"names":[],"mappings":"AAWA,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU/E;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAyD7C"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workflow.ts"],"names":[],"mappings":"AAWA,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU/E;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqC7C"}

package/dist/commands/doctor/workflow.js

@@ -14,18 +14,11 @@ export async function checkWorkflowContract(repoRoot) {
 export async function safeFixWorkflow(repoRoot) {
     const paths = resolveWorkflowPaths(repoRoot);
     let current = "";
-    let sourcePath = paths.workflowPath;
     try {
         current = await fs.readFile(paths.workflowPath, "utf8");
     }
     catch {
-        try {
-            current = await fs.readFile(paths.legacyWorkflowPath, "utf8");
-            sourcePath = paths.legacyWorkflowPath;
-        }
-        catch {
-            return { changed: false, note: "Skip: workflow contract file not found." };
-        }
+        return { changed: false, note: "Skip: workflow contract file not found." };
     }
     const loaded = await loadConfig(path.join(repoRoot, ".agentplane"));
     const fixed = safeAutofixWorkflowText(current, {
@@ -44,24 +37,10 @@ export async function safeFixWorkflow(repoRoot) {
         };
     }
     if (!fixed.changed) {
-        if (sourcePath === paths.workflowPath) {
-            return { changed: false, note: "OK: workflow contract already normalized." };
-        }
-        await fs.mkdir(path.dirname(paths.workflowPath), { recursive: true });
-        await fs.writeFile(paths.workflowPath, current, "utf8");
-        await fs.rm(paths.legacyWorkflowPath, { force: true });
-        await fs.mkdir(paths.workflowDir, { recursive: true });
-        await fs.copyFile(paths.workflowPath, paths.lastKnownGoodPath);
-        return {
-            changed: true,
-            note: "Fixed: moved legacy WORKFLOW.md into .agentplane and refreshed last-known-good.",
-        };
+        return { changed: false, note: "OK: workflow contract already normalized." };
     }
     await fs.mkdir(path.dirname(paths.workflowPath), { recursive: true });
     await fs.writeFile(paths.workflowPath, fixed.text, "utf8");
-    if (sourcePath === paths.legacyWorkflowPath) {
-        await fs.rm(paths.legacyWorkflowPath, { force: true });
-    }
     await fs.mkdir(paths.workflowDir, { recursive: true });
     await fs.copyFile(paths.workflowPath, paths.lastKnownGoodPath);
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqBrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAiElD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiBrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CA+DlD,CAAC"}

package/dist/commands/doctor.run.js

@@ -3,7 +3,7 @@ import { warnMessage, successMessage } from "../cli/output.js";
 import { loadCommandContext } from "./shared/task-backend.js";
 import { checkDoneTaskCommitInvariants } from "./doctor/archive.js";
 import { checkBranchPrDoneTaskOpenPrDrift, checkBranchPrShippedTaskDrift, } from "./doctor/branch-pr.js";
-import { safeFixGitignore, safeFixLegacyUntrackedTaskReadmes, safeFixTaskIndex, } from "./doctor/fixes.js";
+import { safeFixGitignore, safeFixTaskIndex } from "./doctor/fixes.js";
 import { checkLayering } from "./doctor/layering.js";
 import { checkRuntimeSourceFacts, findingSeverity } from "./doctor/runtime.js";
 import { checkWorkspace } from "./doctor/workspace.js";
@@ -41,8 +41,6 @@ export const runDoctor = async (ctx, p) => {
     if (p.fix) {
         const fix = await safeFixGitignore(repoRoot);
         console.log(successMessage("doctor fix", undefined, fix.note));
-        const legacyTaskReadmes = await safeFixLegacyUntrackedTaskReadmes(repoRoot, commandCtx);
-        console.log(successMessage("doctor fix", undefined, legacyTaskReadmes.note));
         const idx = await safeFixTaskIndex(repoRoot);
         console.log(successMessage("doctor fix", undefined, idx.note));
         const workflowFix = await safeFixWorkflow(repoRoot);

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,UAAU,iEAAkE,CAAC;AAoI1F,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AA4CD,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,CA8LlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC"}