agentplane 0.3.11 → 0.3.13

package/dist/cli/run-cli.test-helpers.js

@@ -308,7 +308,7 @@ export async function writeConfig(root, config) {
 export async function resetAgentplaneHomeRecipes() {
     if (!agentplaneHome)
         return;
-    await rm(path.join(agentplaneHome, "recipes"), { recursive: true, force: true });
+    await rm(path.join(agentplaneHome, "recipes-store"), { recursive: true, force: true });
     await rm(path.join(agentplaneHome, "recipes.json"), { force: true });
     await rm(path.join(agentplaneHome, "recipes-index.json"), { force: true });
 }
@@ -349,8 +349,7 @@ export async function createRecipeArchive(opts) {
             {
                 id: "RECIPE_SKILL",
                 summary: "Recipe analysis skill",
-                kind: "agent-skill",
-                file: "skills/analysis.json",
+                file: "skills/analysis.md",
             },
         ],
         agents: [
@@ -361,7 +360,7 @@ export async function createRecipeArchive(opts) {
                 summary: "Recipe agent",
                 skills: ["RECIPE_SKILL"],
                 tools: ["RECIPE_TOOL"],
-                file: "agents/recipe.json",
+                file: "agents/recipe.md",
             },
         ],
         tools: [
@@ -395,18 +394,23 @@ export async function createRecipeArchive(opts) {
     await writeFile(path.join(recipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
     const agentsDir = path.join(recipeDir, "agents");
     await mkdir(agentsDir, { recursive: true });
-    await writeFile(path.join(agentsDir, "recipe.json"), JSON.stringify({
-        id: "RECIPE_AGENT",
-        role: "Recipe agent",
-        description: "Example agent installed from a recipe.",
-    }, null, 2), "utf8");
+    await writeFile(path.join(agentsDir, "recipe.md"), [
+        "# Recipe Agent",
+        "",
+        "Role: executor",
+        "",
+        "Instructions:",
+        "- Use recipe local policy.",
+        "- Materialize the declared scenario artifacts.",
+    ].join("\n"), "utf8");
     const skillsDir = path.join(recipeDir, "skills");
     await mkdir(skillsDir, { recursive: true });
-    await writeFile(path.join(skillsDir, "analysis.json"), JSON.stringify({
-        id: "RECIPE_SKILL",
-        summary: "Recipe analysis skill",
-        kind: "agent-skill",
-    }, null, 2), "utf8");
+    await writeFile(path.join(skillsDir, "analysis.md"), [
+        "# Recipe Skill",
+        "",
+        "- Inspect the generated bundle before acting.",
+        "- Keep recipe-owned artifacts inside the declared output paths.",
+    ].join("\n"), "utf8");
     const toolsDir = path.join(recipeDir, "tools");
     await mkdir(toolsDir, { recursive: true });
     await writeFile(path.join(toolsDir, "run.js"), [
@@ -496,8 +500,7 @@ export async function createUnsafeRecipeArchive(opts) {
             {
                 id: "RECIPE_SKILL",
                 summary: "Recipe skill",
-                kind: "agent-skill",
-                file: "skills/recipe.json",
+                file: "skills/recipe.md",
             },
         ],
         agents: [
@@ -508,7 +511,7 @@ export async function createUnsafeRecipeArchive(opts) {
                 summary: "Recipe agent",
                 skills: ["RECIPE_SKILL"],
                 tools: ["RECIPE_TOOL"],
-                file: "agents/recipe.json",
+                file: "agents/recipe.md",
             },
         ],
         tools: [
@@ -535,10 +538,10 @@ export async function createUnsafeRecipeArchive(opts) {
     await writeFile(path.join(recipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
     const agentsDir = path.join(recipeDir, "agents");
     await mkdir(agentsDir, { recursive: true });
-    await writeFile(path.join(agentsDir, "recipe.json"), JSON.stringify({ id: "RECIPE_AGENT", role: "Recipe agent" }, null, 2), "utf8");
+    await writeFile(path.join(agentsDir, "recipe.md"), "# Recipe Agent\n\nFollow the unsafe archive validation path.\n", "utf8");
     const skillsDir = path.join(recipeDir, "skills");
     await mkdir(skillsDir, { recursive: true });
-    await writeFile(path.join(skillsDir, "recipe.json"), JSON.stringify({ id: "RECIPE_SKILL" }), "utf8");
+    await writeFile(path.join(skillsDir, "recipe.md"), "# Recipe Skill\n\nInspect archive contents before materialization.\n", "utf8");
     const toolsDir = path.join(recipeDir, "tools");
     await mkdir(toolsDir, { recursive: true });
     await writeFile(path.join(toolsDir, "run.sh"), "#!/usr/bin/env bash\n", "utf8");
@@ -744,6 +747,20 @@ export async function commitAll(root, message) {
         env: cleanGitEnv(),
     });
 }
+export async function commitPathsIfChanged(root, paths, message) {
+    await execFileAsync("git", ["add", "--", ...paths], { cwd: root, env: cleanGitEnv() });
+    const { stdout } = await execFileAsync("git", ["diff", "--cached", "--name-only", "--", ...paths], {
+        cwd: root,
+        env: cleanGitEnv(),
+    });
+    if (!stdout.trim())
+        return false;
+    await execFileAsync("git", ["commit", "--no-verify", "-m", message], {
+        cwd: root,
+        env: cleanGitEnv(),
+    });
+    return true;
+}
 export async function stageGitignoreIfPresent(root) {
     const gitignorePath = path.join(root, ".gitignore");
     if (!(await pathExists(gitignorePath)))

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

@@ -9,5 +9,6 @@ export declare function cmdCleanupMerged(opts: {
     deleteRemoteBranches: boolean;
     fetch: boolean;
     quiet: boolean;
+    skipUnsafeWorktrees?: boolean;
 }): Promise<number>;
 //# sourceMappingURL=cleanup-merged.d.ts.map

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":"AAqBA,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;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiJlB"}
+{"version":3,"file":"cleanup-merged.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/cleanup-merged.ts"],"names":[],"mappings":"AAqBA,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,CA8JlB"}

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

@@ -185,18 +185,26 @@ export async function cmdCleanupMerged(opts) {
             }
             return 0;
         }
+        const skipUnsafeWorktrees = opts.skipUnsafeWorktrees === true;
         let deletedRemoteBranches = 0;
+        let skippedUnsafe = 0;
         for (const item of sortedCandidates) {
             const worktreePath = item.worktreePath ? await resolvePathFallback(item.worktreePath) : null;
             if (worktreePath) {
-                if (!isPathWithin(repoRoot, worktreePath)) {
-                    throw new CliError({
-                        exitCode: 5,
-                        code: "E_GIT",
-                        message: `Refusing to remove worktree outside repo: ${worktreePath}`,
-                    });
-                }
-                if (worktreePath === repoRoot) {
+                const outsideRepo = !isPathWithin(repoRoot, worktreePath);
+                const currentWorktree = worktreePath === repoRoot;
+                if (outsideRepo || currentWorktree) {
+                    if (skipUnsafeWorktrees) {
+                        skippedUnsafe += 1;
+                        continue;
+                    }
+                    if (outsideRepo) {
+                        throw new CliError({
+                            exitCode: 5,
+                            code: "E_GIT",
+                            message: `Refusing to remove worktree outside repo: ${worktreePath}`,
+                        });
+                    }
                     throw new CliError({
                         exitCode: 5,
                         code: "E_GIT",
@@ -234,7 +242,8 @@ export async function cmdCleanupMerged(opts) {
             const remoteDetail = opts.deleteRemoteBranches
                 ? ` remote_deleted=${deletedRemoteBranches}`
                 : "";
-            output.success("cleanup merged", undefined, `deleted=${candidates.length}${remoteDetail}`);
+            const skippedDetail = skipUnsafeWorktrees ? ` skipped_unsafe=${skippedUnsafe}` : "";
+            output.success("cleanup merged", undefined, `deleted=${candidates.length - skippedUnsafe}${remoteDetail}${skippedDetail}`);
         }
         return 0;
     }

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":"AAeA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAkMnC,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,CA6JlB"}
+{"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"}

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

@@ -1,4 +1,4 @@
-import { copyFile, cp, mkdir, readFile, readdir, symlink, writeFile } from "node:fs/promises";
+import { chmod, copyFile, cp, mkdir, readFile, readdir, rm, symlink, writeFile, } from "node:fs/promises";
 import path from "node:path";
 import { resolveBaseBranch } from "@agentplaneorg/core";
 import { LocalBackend } from "../../backends/task-backend.js";
@@ -11,9 +11,40 @@ import { execFileAsync, gitEnv } from "../shared/git.js";
 import { gitAheadBehind } from "../shared/git-diff.js";
 import { gitBranchExists, gitBranchUpstream, gitCurrentBranch } from "../shared/git-ops.js";
 import { isPathWithin } from "../shared/path.js";
+import { resolveRuntimeSourceInfo } from "../../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");
@@ -54,16 +85,35 @@ async function materializeLocalBackendReadmesForWorktree(opts) {
     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 sourceRoots = [path.resolve(opts.repoRoot), path.resolve(process.cwd())];
+    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"],
@@ -88,8 +138,15 @@ async function materializeRepoLocalDistForWorktree(opts) {
     }
 }
 async function linkDirectoryIntoWorktree(opts) {
-    const sourcePath = path.join(opts.repoRoot, opts.relativePath);
-    if (!(await fileExists(sourcePath)))
+    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))
@@ -99,6 +156,16 @@ async function linkDirectoryIntoWorktree(opts) {
     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"),
@@ -107,12 +174,20 @@ async function materializeRepoLocalInstallLayoutForWorktree(opts) {
     ];
     for (const relativePath of linkTargets) {
         await linkDirectoryIntoWorktree({
-            repoRoot: opts.repoRoot,
+            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,
@@ -278,6 +353,7 @@ export async function cmdWorkStart(opts) {
                 backend: ctx.taskBackend,
                 repoRoot: resolved.gitRoot,
                 worktreePath,
+                taskId: opts.taskId,
             });
             await materializeRepoLocalDistForWorktree({
                 repoRoot: resolved.gitRoot,
@@ -287,6 +363,7 @@ export async function cmdWorkStart(opts) {
                 repoRoot: resolved.gitRoot,
                 worktreePath,
             });
+            await materializeHookShimForWorktree(worktreePath);
         }
         else {
             if (branchExists) {

package/dist/commands/codex/plugin-install.d.ts

@@ -0,0 +1,26 @@
+export declare const AGENTPLANE_CODEX_HOME_ENV = "AGENTPLANE_CODEX_HOME";
+export type CodexPluginInstallScope = "user" | "repo";
+export type CodexPluginInstallResult = {
+    scope: CodexPluginInstallScope;
+    installRoot: string;
+    pluginRoot: string;
+    manifestPath: string;
+    marketplacePath: string;
+    copiedAssets: string[];
+};
+type JsonObject = Record<string, unknown>;
+export declare function buildCodexPluginManifest(version?: string): JsonObject;
+export declare function resolveCodexInstallRoot(opts: {
+    scope: CodexPluginInstallScope;
+    repoRoot?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function resolveCodexPluginRoot(installRoot: string): string;
+export declare function resolveCodexMarketplacePath(installRoot: string): string;
+export declare function installBundledCodexPlugin(opts: {
+    scope: CodexPluginInstallScope;
+    installRoot: string;
+    version?: string;
+}): Promise<CodexPluginInstallResult>;
+export {};
+//# sourceMappingURL=plugin-install.d.ts.map

package/dist/commands/codex/plugin-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-install.d.ts","sourceRoot":"","sources":["../../../src/commands/codex/plugin-install.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwG1C,wBAAgB,wBAAwB,CAAC,OAAO,SAAe,GAAG,UAAU,CA8B3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,MAAM,CAiBT;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAyCpC"}

package/dist/commands/codex/plugin-install.js

@@ -0,0 +1,209 @@
+import { copyFile, mkdir, readFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { CliError } from "../../shared/errors.js";
+import { getVersion } from "../../meta/version.js";
+import { writeJsonStableIfChanged, writeTextIfChanged } from "../../shared/write-if-changed.js";
+const PLUGIN_NAME = "agentplane";
+const DEFAULT_MARKETPLACE_NAME = "agentplane-local-marketplace";
+const DEFAULT_MARKETPLACE_DISPLAY_NAME = "AgentPlane Local Plugins";
+const ASSET_ROOT_URL = new URL("../../../assets/codex-plugin/", import.meta.url);
+const TEXT_ASSETS = [
+    {
+        source: new URL("skills/agentplane/SKILL.md", ASSET_ROOT_URL),
+        relativePath: "skills/agentplane/SKILL.md",
+    },
+];
+const BINARY_ASSETS = [
+    {
+        source: new URL("assets/icon.svg", ASSET_ROOT_URL),
+        relativePath: "assets/icon.svg",
+    },
+    {
+        source: new URL("assets/logo.svg", ASSET_ROOT_URL),
+        relativePath: "assets/logo.svg",
+    },
+    {
+        source: new URL("assets/header.png", ASSET_ROOT_URL),
+        relativePath: "assets/header.png",
+    },
+];
+export const AGENTPLANE_CODEX_HOME_ENV = "AGENTPLANE_CODEX_HOME";
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidMarketplaceError(message) {
+    return new CliError({
+        exitCode: 3,
+        code: "E_VALIDATION",
+        message,
+    });
+}
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+function defaultMarketplaceDocument() {
+    return {
+        name: DEFAULT_MARKETPLACE_NAME,
+        interface: {
+            displayName: DEFAULT_MARKETPLACE_DISPLAY_NAME,
+        },
+        plugins: [],
+    };
+}
+function parseMarketplaceDocument(text) {
+    if (text === null)
+        return defaultMarketplaceDocument();
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw invalidMarketplaceError(`Invalid Codex marketplace JSON: ${err instanceof Error ? err.message : "unknown parse error"}`);
+    }
+    if (!isJsonObject(parsed)) {
+        throw invalidMarketplaceError("Invalid Codex marketplace JSON: expected a top-level object.");
+    }
+    if ("plugins" in parsed && !Array.isArray(parsed.plugins)) {
+        throw invalidMarketplaceError("Invalid Codex marketplace JSON: `plugins` must be an array.");
+    }
+    if ("interface" in parsed && parsed.interface !== undefined && !isJsonObject(parsed.interface)) {
+        throw invalidMarketplaceError("Invalid Codex marketplace JSON: `interface` must be an object when present.");
+    }
+    return parsed;
+}
+function marketplaceEntry() {
+    return {
+        name: PLUGIN_NAME,
+        source: {
+            source: "local",
+            path: `./plugins/${PLUGIN_NAME}`,
+        },
+        policy: {
+            installation: "AVAILABLE",
+            authentication: "ON_INSTALL",
+        },
+        category: "Productivity",
+    };
+}
+function upsertMarketplaceDocument(text) {
+    const document = parseMarketplaceDocument(text);
+    const interfaceObject = isJsonObject(document.interface) ? { ...document.interface } : {};
+    if (typeof document.name !== "string" || document.name.trim().length === 0) {
+        document.name = DEFAULT_MARKETPLACE_NAME;
+    }
+    if (typeof interfaceObject.displayName !== "string" ||
+        interfaceObject.displayName.trim().length === 0) {
+        interfaceObject.displayName = DEFAULT_MARKETPLACE_DISPLAY_NAME;
+    }
+    const plugins = Array.isArray(document.plugins) ? document.plugins : [];
+    const nextEntry = marketplaceEntry();
+    const existingIndex = plugins.findIndex((entry) => isJsonObject(entry) && entry.name === PLUGIN_NAME);
+    if (existingIndex === -1) {
+        plugins.push(nextEntry);
+    }
+    else {
+        plugins.splice(existingIndex, 1, nextEntry);
+    }
+    return {
+        ...document,
+        interface: interfaceObject,
+        plugins,
+    };
+}
+export function buildCodexPluginManifest(version = getVersion()) {
+    return {
+        name: PLUGIN_NAME,
+        version,
+        description: "Bundle AgentPlane workflow guidance for the Codex plugins UI.",
+        homepage: "https://github.com/basilisk-labs/agentplane",
+        repository: "https://github.com/basilisk-labs/agentplane",
+        license: "MIT",
+        keywords: ["agentplane", "codex", "workflow", "tasks", "git"],
+        skills: "./skills/",
+        interface: {
+            displayName: "AgentPlane",
+            shortDescription: "Governed git-native workflow guidance for Codex",
+            longDescription: "Install AgentPlane into Codex through a local marketplace and give Codex explicit task, planning, verification, and branch_pr workflow guidance.",
+            developerName: "basilisk-labs",
+            category: "Productivity",
+            capabilities: ["Read", "Write"],
+            websiteURL: "https://github.com/basilisk-labs/agentplane",
+            defaultPrompt: [
+                "Use AgentPlane to initialize a governed workflow in this repository.",
+                "Use AgentPlane to create a task, approve the plan, and start work in branch_pr mode.",
+                "Use AgentPlane to verify the active task and record evidence before finish.",
+            ],
+            brandColor: "#111827",
+            composerIcon: "./assets/icon.svg",
+            logo: "./assets/logo.svg",
+            screenshots: ["./assets/header.png"],
+        },
+    };
+}
+export function resolveCodexInstallRoot(opts) {
+    if (opts.scope === "repo") {
+        const repoRoot = opts.repoRoot?.trim();
+        if (!repoRoot) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Repo scope requires a resolved repository root.",
+            });
+        }
+        return path.resolve(repoRoot);
+    }
+    const env = opts.env ?? process.env;
+    const overridden = env[AGENTPLANE_CODEX_HOME_ENV]?.trim();
+    if (overridden)
+        return path.resolve(overridden);
+    return os.homedir();
+}
+export function resolveCodexPluginRoot(installRoot) {
+    return path.join(installRoot, "plugins", PLUGIN_NAME);
+}
+export function resolveCodexMarketplacePath(installRoot) {
+    return path.join(installRoot, ".agents", "plugins", "marketplace.json");
+}
+export async function installBundledCodexPlugin(opts) {
+    const installRoot = path.resolve(opts.installRoot);
+    const pluginRoot = resolveCodexPluginRoot(installRoot);
+    const manifestPath = path.join(pluginRoot, ".codex-plugin", "plugin.json");
+    const marketplacePath = resolveCodexMarketplacePath(installRoot);
+    await mkdir(path.dirname(manifestPath), { recursive: true });
+    await mkdir(path.dirname(marketplacePath), { recursive: true });
+    await writeJsonStableIfChanged(manifestPath, buildCodexPluginManifest(opts.version ?? getVersion()));
+    const copiedAssets = [];
+    for (const asset of TEXT_ASSETS) {
+        const targetPath = path.join(pluginRoot, asset.relativePath);
+        await mkdir(path.dirname(targetPath), { recursive: true });
+        const contents = await readFile(asset.source, "utf8");
+        await writeTextIfChanged(targetPath, contents);
+        copiedAssets.push(targetPath);
+    }
+    for (const asset of BINARY_ASSETS) {
+        const targetPath = path.join(pluginRoot, asset.relativePath);
+        await mkdir(path.dirname(targetPath), { recursive: true });
+        await copyFile(fileURLToPath(asset.source), targetPath);
+        copiedAssets.push(targetPath);
+    }
+    const nextMarketplace = upsertMarketplaceDocument(await readTextIfExists(marketplacePath));
+    await writeJsonStableIfChanged(marketplacePath, nextMarketplace);
+    return {
+        scope: opts.scope,
+        installRoot,
+        pluginRoot,
+        manifestPath,
+        marketplacePath,
+        copiedAssets,
+    };
+}

package/dist/commands/doctor/branch-pr.js

@@ -56,8 +56,8 @@ export async function checkBranchPrDoneTaskOpenPrDrift(ctx) {
             state: "DONE branch_pr tasks still have open or unmerged PR artifacts",
             likelyCause: "the task was marked DONE, but its branch_pr PR artifacts were never reconciled to MERGED and the task branch still exists",
             nextAction: {
-                command: "agentplane task normalize --sync-hosted-merges --task-id <task-id>",
-                reason: "reconcile the shipped task's branch_pr PR artifacts to MERGED without scanning unrelated task history",
+                command: "agentplane task normalize --sync-branch-pr-state --task-id <task-id>",
+                reason: "reconcile the shipped task's local branch_pr state and PR artifacts to MERGED without scanning unrelated task history",
             },
             details: [
                 `Affected tasks: ${matches.length}`,

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

@@ -32,5 +32,6 @@ export declare function cmdCommit(opts: {
     closeUnstageOthers: boolean;
     closeCheckOnly: boolean;
     closeStageTaskArtifacts?: boolean;
+    closeRefreshTaskArtifacts?: boolean;
 }): Promise<number>;
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAsOxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,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;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,CAAC,CA4OlB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/guard/impl/commands.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQvF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA8SxE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,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;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAsPlB"}