agentplane 0.2.6 → 0.2.12

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

@@ -1,7 +1,8 @@
 import path from "node:path";
-import { loadConfig, resolveProject, saveConfig, setByDottedKey } from "@agentplaneorg/core";
+import { saveConfig, setByDottedKey } from "@agentplaneorg/core";
 import { mapCoreError } from "../../error-map.js";
 import { usageError } from "../../spec/errors.js";
+import { CliError } from "../../../shared/errors.js";
 export const configShowSpec = {
     id: ["config", "show"],
     group: "Config",
@@ -11,19 +12,19 @@ export const configShowSpec = {
 };
 async function cmdConfigShow(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const loaded = await opts.deps.getLoadedConfig("config show");
         process.stdout.write(`${JSON.stringify(loaded.raw, null, 2)}\n`);
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, { command: "config show", root: opts.rootOverride ?? null });
     }
 }
-export const runConfigShow = (ctx) => cmdConfigShow({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export function makeRunConfigShowHandler(deps) {
+    return (ctx) => cmdConfigShow({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, deps });
+}
 export const configSetSpec = {
     id: ["config", "set"],
     group: "Config",
@@ -43,11 +44,8 @@ export const configSetSpec = {
 };
 async function cmdConfigSet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const resolved = await opts.deps.getResolvedProject("config set");
+        const loaded = await opts.deps.getLoadedConfig("config set");
         const raw = { ...loaded.raw };
         setByDottedKey(raw, opts.key, opts.value);
         await saveConfig(resolved.agentplaneDir, raw);
@@ -55,6 +53,8 @@ async function cmdConfigSet(opts) {
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, {
             command: "config set",
             key: opts.key,
@@ -62,7 +62,15 @@ async function cmdConfigSet(opts) {
         });
     }
 }
-export const runConfigSet = (ctx, p) => cmdConfigSet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, key: p.key, value: p.value });
+export function makeRunConfigSetHandler(deps) {
+    return (ctx, p) => cmdConfigSet({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        key: p.key,
+        value: p.value,
+        deps,
+    });
+}
 export const modeGetSpec = {
     id: ["mode", "get"],
     group: "Config",
@@ -72,19 +80,19 @@ export const modeGetSpec = {
 };
 async function cmdModeGet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const loaded = await opts.deps.getLoadedConfig("mode get");
         process.stdout.write(`${loaded.config.workflow_mode}\n`);
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, { command: "mode get", root: opts.rootOverride ?? null });
     }
 }
-export const runModeGet = (ctx) => cmdModeGet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });
+export function makeRunModeGetHandler(deps) {
+    return (ctx) => cmdModeGet({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, deps });
+}
 export const modeSetSpec = {
     id: ["mode", "set"],
     group: "Config",
@@ -104,11 +112,8 @@ export const modeSetSpec = {
 };
 async function cmdModeSet(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const loaded = await loadConfig(resolved.agentplaneDir);
+        const resolved = await opts.deps.getResolvedProject("mode set");
+        const loaded = await opts.deps.getLoadedConfig("mode set");
         const raw = { ...loaded.raw };
         setByDottedKey(raw, "workflow_mode", opts.mode);
         await saveConfig(resolved.agentplaneDir, raw);
@@ -116,6 +121,8 @@ async function cmdModeSet(opts) {
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, {
             command: "mode set",
             root: opts.rootOverride ?? null,
@@ -123,8 +130,11 @@ async function cmdModeSet(opts) {
         });
     }
 }
-export const runModeSet = (ctx, p) => cmdModeSet({
-    cwd: ctx.cwd,
-    rootOverride: ctx.rootOverride,
-    mode: p.mode,
-});
+export function makeRunModeSetHandler(deps) {
+    return (ctx, p) => cmdModeSet({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        mode: p.mode,
+        deps,
+    });
+}

package/dist/cli/run-cli/commands/core.d.ts

@@ -1,4 +1,5 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import type { RunDeps } from "../command-catalog.js";
 type QuickstartParsed = Record<string, never>;
 export declare const quickstartSpec: CommandSpec<QuickstartParsed>;
 export declare const runQuickstart: CommandHandler<QuickstartParsed>;
@@ -9,6 +10,6 @@ export declare const roleSpec: CommandSpec<RoleParsed>;
 export declare const runRole: CommandHandler<RoleParsed>;
 type AgentsParsed = Record<string, never>;
 export declare const agentsSpec: CommandSpec<AgentsParsed>;
-export declare const runAgents: CommandHandler<AgentsParsed>;
+export declare function makeRunAgentsHandler(deps: RunDeps): CommandHandler<AgentsParsed>;
 export {};
 //# sourceMappingURL=core.d.ts.map

package/dist/cli/run-cli/commands/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAOxD,CAAC;AAYF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAG1D,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAO5C,CAAC;AA8BF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAG9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAkEF,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CACU,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAOxD,CAAC;AAYF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAG1D,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAO5C,CAAC;AAgLF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAE9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CA+DhF"}

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

@@ -7,6 +7,7 @@ import { CliError } from "../../../shared/errors.js";
 import { dedupeStrings } from "../../../shared/strings.js";
 import { usageError } from "../../spec/errors.js";
 import { listRoles, renderQuickstart, renderRole } from "../../command-guide.js";
+import { toStringList } from "../../spec/parse-utils.js";
 export const quickstartSpec = {
     id: ["quickstart"],
     group: "Core",
@@ -38,7 +39,79 @@ export const roleSpec = {
     examples: [{ cmd: "agentplane role ORCHESTRATOR", why: "Show ORCHESTRATOR guide." }],
     parse: (raw) => ({ role: String(raw.args.role ?? "") }),
 };
-function cmdRole(opts) {
+function normalizeRoleId(roleRaw) {
+    return roleRaw.trim().toUpperCase();
+}
+async function listAgentProfileIds(opts) {
+    try {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        const agentsDir = path.join(resolved.agentplaneDir, "agents");
+        if (!(await fileExists(agentsDir)))
+            return null;
+        const entriesRaw = await readdir(agentsDir);
+        const entries = entriesRaw.filter((n) => n.endsWith(".json")).toSorted();
+        const ids = entries.map((n) => n.replace(/\.json$/i, ""));
+        return { agentplaneDir: resolved.agentplaneDir, ids };
+    }
+    catch {
+        // Best-effort: role should not fail if we're not in an agentplane project.
+        return null;
+    }
+}
+async function readAgentProfile(opts) {
+    const listing = await listAgentProfileIds({ cwd: opts.cwd, rootOverride: opts.rootOverride });
+    if (!listing)
+        return null;
+    const roleId = normalizeRoleId(opts.roleId);
+    const candidates = [roleId, opts.roleId.trim()].filter(Boolean);
+    const idsLower = new Map();
+    for (const id of listing.ids)
+        idsLower.set(id.toLowerCase(), id);
+    let foundId = null;
+    for (const c of candidates) {
+        const exact = listing.ids.find((id) => id === c);
+        if (exact) {
+            foundId = exact;
+            break;
+        }
+        const ci = idsLower.get(c.toLowerCase());
+        if (ci) {
+            foundId = ci;
+            break;
+        }
+    }
+    if (!foundId)
+        return null;
+    const filename = `${foundId}.json`;
+    const filePath = path.join(listing.agentplaneDir, "agents", filename);
+    const raw = JSON.parse(await readFile(filePath, "utf8"));
+    return { agentplaneDir: listing.agentplaneDir, filename, profile: raw };
+}
+function renderAgentProfileBlock(opts) {
+    const id = (typeof opts.profile.id === "string" ? opts.profile.id : "").trim() || opts.roleId;
+    const role = (typeof opts.profile.role === "string" ? opts.profile.role : "").trim();
+    const description = (typeof opts.profile.description === "string" ? opts.profile.description : "").trim();
+    const inputs = toStringList(opts.profile.inputs);
+    const outputs = toStringList(opts.profile.outputs);
+    const permissions = toStringList(opts.profile.permissions);
+    const workflow = toStringList(opts.profile.workflow);
+    const lines = [
+        `### ${id}`,
+        ...(role ? [`Role: ${role}`] : []),
+        ...(description ? [`Description: ${description}`] : []),
+        ...(inputs.length > 0 ? ["", "Inputs:", ...inputs.map((s) => `- ${s}`)] : []),
+        ...(outputs.length > 0 ? ["", "Outputs:", ...outputs.map((s) => `- ${s}`)] : []),
+        ...(permissions.length > 0 ? ["", "Permissions:", ...permissions.map((s) => `- ${s}`)] : []),
+        ...(workflow.length > 0 ? ["", "Workflow:", ...workflow.map((s) => `- ${s}`)] : []),
+        "",
+        `Source: .agentplane/agents/${opts.filename} (lower priority; see AGENTS.md)`,
+    ];
+    return lines.join("\n").trimEnd();
+}
+async function cmdRole(opts) {
     try {
         const roleRaw = opts.role.trim();
         if (!roleRaw) {
@@ -48,17 +121,54 @@ function cmdRole(opts) {
                 message: "Missing required argument: role",
             });
         }
-        const guide = renderRole(roleRaw);
-        if (!guide) {
-            const roles = listRoles();
-            const available = roles.length > 0 ? `\nAvailable roles: ${roles.join(", ")}` : "";
+        const normalizedRole = normalizeRoleId(roleRaw);
+        const guide = renderRole(normalizedRole);
+        const agentProfile = await readAgentProfile({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            roleId: normalizedRole,
+        });
+        if (!guide && !agentProfile) {
+            const builtin = listRoles();
+            const agentIds = await listAgentProfileIds({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+            });
+            const discovered = agentIds ? agentIds.ids : [];
+            const availableList = dedupeStrings([...builtin, ...discovered]).toSorted();
+            const available = availableList.length > 0 ? `\nAvailable roles: ${availableList.join(", ")}` : "";
             throw usageError({
                 spec: roleSpec,
                 command: "role",
                 message: `Unknown role: ${roleRaw}.${available}`,
             });
         }
-        process.stdout.write(`${guide}\n`);
+        if (guide) {
+            process.stdout.write(`${guide}\n`);
+            if (agentProfile) {
+                const block = renderAgentProfileBlock({
+                    filename: agentProfile.filename,
+                    roleId: normalizedRole,
+                    profile: agentProfile.profile,
+                });
+                process.stdout.write(`\n## Agent profile\n\n${block}\n`);
+            }
+            return 0;
+        }
+        if (!agentProfile) {
+            // Defensive: this should be unreachable due to the earlier guard.
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: `Unknown role: ${roleRaw}.`,
+            });
+        }
+        const block = renderAgentProfileBlock({
+            filename: agentProfile.filename,
+            roleId: normalizedRole,
+            profile: agentProfile.profile,
+        });
+        process.stdout.write(`${block}\n`);
         return 0;
     }
     catch (err) {
@@ -68,8 +178,7 @@ function cmdRole(opts) {
     }
 }
 export const runRole = (ctx, p) => {
-    cmdRole({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, role: p.role });
-    return Promise.resolve(0);
+    return cmdRole({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, role: p.role });
 };
 export const agentsSpec = {
     id: ["agents"],
@@ -78,67 +187,65 @@ export const agentsSpec = {
     examples: [{ cmd: "agentplane agents", why: "Print available agent ids and roles." }],
     parse: () => ({}),
 };
-async function cmdAgents(opts) {
-    try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
-        const agentsDir = path.join(resolved.agentplaneDir, "agents");
-        if (!(await fileExists(agentsDir))) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Agents directory not found: ${agentsDir} (run \`agentplane init\`)`,
-            });
-        }
-        const entriesRaw = await readdir(agentsDir);
-        const entries = entriesRaw.filter((name) => name.endsWith(".json")).toSorted();
-        if (entries.length === 0) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `No agent definitions found under ${agentsDir} (expected *.json)`,
-            });
-        }
-        const rows = [];
-        const seen = new Set();
-        const duplicates = [];
-        for (const entry of entries) {
-            const filePath = path.join(agentsDir, entry);
-            const raw = JSON.parse(await readFile(filePath, "utf8"));
-            const rawId = typeof raw.id === "string" ? raw.id : "";
-            const rawRole = typeof raw.role === "string" ? raw.role : "";
-            const agentId = rawId.trim() || "<missing-id>";
-            const role = rawRole.trim() || "-";
-            if (seen.has(agentId)) {
-                duplicates.push(agentId);
+export function makeRunAgentsHandler(deps) {
+    return async (ctx) => {
+        try {
+            const resolved = await deps.getResolvedProject("agents");
+            const agentsDir = path.join(resolved.agentplaneDir, "agents");
+            if (!(await fileExists(agentsDir))) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Agents directory not found: ${agentsDir} (run \`agentplane init\`)`,
+                });
             }
-            else {
-                seen.add(agentId);
+            const entriesRaw = await readdir(agentsDir);
+            const entries = entriesRaw.filter((name) => name.endsWith(".json")).toSorted();
+            if (entries.length === 0) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `No agent definitions found under ${agentsDir} (expected *.json)`,
+                });
             }
-            rows.push([agentId, role, entry]);
-        }
-        const widthId = Math.max(...rows.map((row) => row[0].length), "ID".length);
-        const widthFile = Math.max(...rows.map((row) => row[2].length), "FILE".length);
-        process.stdout.write(`${"ID".padEnd(widthId)}  ${"FILE".padEnd(widthFile)}  ROLE\n`);
-        process.stdout.write(`${"-".repeat(widthId)}  ${"-".repeat(widthFile)}  ----\n`);
-        for (const [agentId, role, filename] of rows) {
-            process.stdout.write(`${agentId.padEnd(widthId)}  ${filename.padEnd(widthFile)}  ${role}\n`);
+            const rows = [];
+            const seen = new Set();
+            const duplicates = [];
+            for (const entry of entries) {
+                const filePath = path.join(agentsDir, entry);
+                const raw = JSON.parse(await readFile(filePath, "utf8"));
+                const rawId = typeof raw.id === "string" ? raw.id : "";
+                const rawRole = typeof raw.role === "string" ? raw.role : "";
+                const agentId = rawId.trim() || "<missing-id>";
+                const role = rawRole.trim() || "-";
+                if (seen.has(agentId)) {
+                    duplicates.push(agentId);
+                }
+                else {
+                    seen.add(agentId);
+                }
+                rows.push([agentId, role, entry]);
+            }
+            const widthId = Math.max(...rows.map((row) => row[0].length), "ID".length);
+            const widthFile = Math.max(...rows.map((row) => row[2].length), "FILE".length);
+            process.stdout.write(`${"ID".padEnd(widthId)}  ${"FILE".padEnd(widthFile)}  ROLE\n`);
+            process.stdout.write(`${"-".repeat(widthId)}  ${"-".repeat(widthFile)}  ----\n`);
+            for (const [agentId, role, filename] of rows) {
+                process.stdout.write(`${agentId.padEnd(widthId)}  ${filename.padEnd(widthFile)}  ${role}\n`);
+            }
+            if (duplicates.length > 0) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: `Duplicate agent ids: ${dedupeStrings(duplicates).toSorted().join(", ")}`,
+                });
+            }
+            return 0;
         }
-        if (duplicates.length > 0) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: `Duplicate agent ids: ${dedupeStrings(duplicates).toSorted().join(", ")}`,
-            });
+        catch (err) {
+            if (err instanceof CliError)
+                throw err;
+            throw mapCoreError(err, { command: "agents", root: ctx.rootOverride ?? null });
         }
-        return 0;
-    }
-    catch (err) {
-        if (err instanceof CliError)
-            throw err;
-        throw mapCoreError(err, { command: "agents", root: opts.rootOverride ?? null });
-    }
+    };
 }
-export const runAgents = (ctx) => cmdAgents({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

package/dist/cli/run-cli/commands/ide.d.ts

@@ -1,4 +1,5 @@
 import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import type { RunDeps } from "../command-catalog.js";
 type IdeSyncParsed = {
     ide?: "cursor" | "windsurf";
 };
@@ -7,7 +8,8 @@ export declare function cmdIdeSync(opts: {
     cwd: string;
     rootOverride?: string;
     ide?: "cursor" | "windsurf";
+    deps: RunDeps;
 }): Promise<number>;
-export declare const runIdeSync: CommandHandler<IdeSyncParsed>;
+export declare function makeRunIdeSyncHandler(deps: RunDeps): CommandHandler<IdeSyncParsed>;
 export {};
 //# sourceMappingURL=ide.d.ts.map

package/dist/cli/run-cli/commands/ide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ide.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/ide.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,KAAK,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAkBlD,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AAED,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACqB,CAAC"}
+{"version":3,"file":"ide.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/ide.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,KAAK,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAkBlD,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ClB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAElF"}

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

@@ -1,8 +1,8 @@
 import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
-import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../error-map.js";
 import { writeTextIfChanged } from "../../../shared/write-if-changed.js";
+import { CliError } from "../../../shared/errors.js";
 export const ideSyncSpec = {
     id: ["ide", "sync"],
     group: "IDE",
@@ -24,10 +24,7 @@ export const ideSyncSpec = {
 };
 export async function cmdIdeSync(opts) {
     try {
-        const resolved = await resolveProject({
-            cwd: opts.cwd,
-            rootOverride: opts.rootOverride ?? null,
-        });
+        const resolved = await opts.deps.getResolvedProject("ide sync");
         const agentsPath = path.join(resolved.gitRoot, "AGENTS.md");
         const agentsText = await readFile(agentsPath, "utf8");
         const header = [
@@ -61,7 +58,11 @@ export async function cmdIdeSync(opts) {
         return 0;
     }
     catch (err) {
+        if (err instanceof CliError)
+            throw err;
         throw mapCoreError(err, { command: "ide sync", root: opts.rootOverride ?? null });
     }
 }
-export const runIdeSync = (ctx, p) => cmdIdeSync({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, ide: p.ide });
+export function makeRunIdeSyncHandler(deps) {
+    return (ctx, p) => cmdIdeSync({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, ide: p.ide, deps });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"ide-sync.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/ide-sync.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAetC"}
+{"version":3,"file":"ide-sync.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/ide-sync.ts"],"names":[],"mappings":"AAOA,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BtC"}

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

@@ -4,7 +4,16 @@ import { cmdIdeSync } from "../ide.js";
 export async function maybeSyncIde(opts) {
     if (opts.ide === "codex")
         return { installPaths: [] };
-    await cmdIdeSync({ cwd: opts.cwd, rootOverride: opts.rootOverride, ide: opts.ide });
+    const deps = {
+        getCtx: (_cmd) => Promise.reject(new Error("getCtx is not available during init")),
+        getResolvedProject: (_cmd) => Promise.resolve({
+            gitRoot: opts.gitRoot,
+            agentplaneDir: path.join(opts.gitRoot, ".agentplane"),
+        }),
+        getLoadedConfig: (_cmd) => Promise.reject(new Error("getLoadedConfig is not available during init")),
+        getHelpJsonForDocs: () => [],
+    };
+    await cmdIdeSync({ cwd: opts.cwd, rootOverride: opts.rootOverride, ide: opts.ide, deps });
     const installPaths = [];
     const cursorPath = path.join(opts.gitRoot, ".cursor", "rules", "agentplane.mdc");
     const windsurfPath = path.join(opts.gitRoot, ".windsurf", "rules", "agentplane.md");

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

@@ -1 +1 @@
-{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAQ1E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+CtC"}
+{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAQ1E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6BtC"}

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

@@ -1,45 +1,25 @@
-import { lstat, symlink } from "node:fs/promises";
 import path from "node:path";
 import { atomicWriteFile } from "@agentplaneorg/core";
 import { filterAgentsByWorkflow, loadAgentTemplates, loadAgentsTemplate, } from "../../../../agents/agents-template.js";
 import { fileExists } from "../../../fs-utils.js";
 export async function ensureAgentsFiles(opts) {
-    const agentsLinkPath = path.join(opts.gitRoot, "AGENTS.md");
-    const agentsManagedPath = path.join(opts.agentplaneDir, "AGENTS.md");
+    const agentsPath = path.join(opts.gitRoot, "AGENTS.md");
     const installPaths = [
         path.relative(opts.gitRoot, opts.configPathAbs),
         path.relative(opts.gitRoot, opts.backendPathAbs),
     ];
     let wroteAgents = false;
-    if (await fileExists(agentsManagedPath)) {
+    if (await fileExists(agentsPath)) {
         // nothing
     }
     else {
         const template = await loadAgentsTemplate();
         const filtered = filterAgentsByWorkflow(template, opts.workflow);
-        await atomicWriteFile(agentsManagedPath, filtered, "utf8");
+        await atomicWriteFile(agentsPath, filtered, "utf8");
         wroteAgents = true;
     }
     if (wroteAgents) {
-        installPaths.push(path.relative(opts.gitRoot, agentsManagedPath));
-    }
-    // The workspace-root AGENTS.md is a symlink to the managed copy under .agentplane/.
-    // This keeps the root policy path stable while making upgrades deterministic.
-    if (await fileExists(agentsLinkPath)) {
-        try {
-            const st = await lstat(agentsLinkPath);
-            if (!st.isSymbolicLink()) {
-                // Do not overwrite user-owned AGENTS.md in init; upgrade handles migration.
-            }
-        }
-        catch {
-            // ignore
-        }
-    }
-    else {
-        const relTarget = path.relative(opts.gitRoot, agentsManagedPath);
-        await symlink(relTarget, agentsLinkPath);
-        installPaths.push(path.relative(opts.gitRoot, agentsLinkPath));
+        installPaths.push(path.relative(opts.gitRoot, agentsPath));
     }
     const agentTemplates = await loadAgentTemplates();
     for (const agent of agentTemplates) {

package/dist/cli/run-cli/commands/init/write-gitignore.d.ts

@@ -0,0 +1,4 @@
+export declare function ensureGitignoreAgents(opts: {
+    gitRoot: string;
+}): Promise<void>;
+//# sourceMappingURL=write-gitignore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-gitignore.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-gitignore.ts"],"names":[],"mappings":"AAeA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpF"}

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

@@ -0,0 +1,35 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { writeTextIfChanged } from "../../../../shared/write-if-changed.js";
+async function readTextIfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function ensureGitignoreAgents(opts) {
+    const gitignorePath = path.join(opts.gitRoot, ".gitignore");
+    const existing = (await readTextIfExists(gitignorePath)) ?? "";
+    const ensuredLines = [
+        "# agentplane: ignore local agent prompts/templates",
+        "AGENTS.md",
+        ".agentplane/agents/",
+    ];
+    const existingLines = existing.split(/\r?\n/);
+    const existingSet = new Set(existingLines.map((line) => line.trimEnd()));
+    const missing = ensuredLines.filter((line) => !existingSet.has(line));
+    if (missing.length === 0)
+        return;
+    const nextLines = [...existingLines];
+    // Keep content stable and append a trailing newline.
+    if (nextLines.length > 0 && nextLines.at(-1) !== "")
+        nextLines.push("");
+    nextLines.push(...missing, "");
+    const nextText = `${nextLines.join("\n")}`.replaceAll(/\n{2,}$/g, "\n");
+    await writeTextIfChanged(gitignorePath, nextText);
+}

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

@@ -4,6 +4,7 @@ type InitFlags = {
     workflow?: "direct" | "branch_pr";
     backend?: "local" | "redmine";
     hooks?: boolean;
+    gitignoreAgents?: boolean;
     requirePlanApproval?: boolean;
     requireNetworkApproval?: boolean;
     requireVerifyApproval?: boolean;

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":"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"}
+{"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;AAetE,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,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,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,CAsJ5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}