agentplane 0.3.7 → 0.3.9

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

@@ -0,0 +1,43 @@
+import { renderQuickstart } from "../../../command-guide.js";
+import { createCliEmitter } from "../../../output.js";
+import { wrapCommand } from "../wrap-command.js";
+const output = createCliEmitter();
+export const quickstartSpec = {
+    id: ["quickstart"],
+    group: "Core",
+    summary: "Print the canonical agent bootstrap path and startup guidance.",
+    options: [
+        {
+            kind: "boolean",
+            name: "json",
+            default: false,
+            description: "Emit compact machine-readable output for agent runtimes.",
+        },
+    ],
+    examples: [{ cmd: "agentplane quickstart", why: "Show quickstart." }],
+    parse: (raw) => ({ json: raw.opts.json === true }),
+};
+async function cmdQuickstart(opts) {
+    return wrapCommand({ command: "quickstart", rootOverride: opts.rootOverride }, () => {
+        const text = renderQuickstart();
+        if (opts.json) {
+            const lines = text
+                .split("\n")
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0);
+            output.json({
+                source_of_truth: {
+                    workflow_policy: "AGENTS.md|CLAUDE.md",
+                    cli_syntax: "quickstart/role output",
+                },
+                lines,
+            });
+            return 0;
+        }
+        output.line(text);
+        return 0;
+    });
+}
+export const runQuickstart = (ctx, parsed) => {
+    return cmdQuickstart({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, json: parsed.json });
+};

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

@@ -0,0 +1,9 @@
+import type { CommandHandler, CommandSpec } from "../../../spec/spec.js";
+type RoleParsed = {
+    role: string;
+    json: boolean;
+};
+export declare const roleSpec: CommandSpec<RoleParsed>;
+export declare const runRole: CommandHandler<RoleParsed>;
+export {};
+//# sourceMappingURL=role.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/core/role.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAazE,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAe5C,CAAC;AA+GF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAO9C,CAAC"}

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

@@ -0,0 +1,128 @@
+import { getRoleSupplementLines, listRoles, renderRole } from "../../../command-guide.js";
+import { createCliEmitter } from "../../../output.js";
+import { usageError } from "../../../spec/errors.js";
+import { dedupeStrings } from "../../../../shared/strings.js";
+import { listAgentProfileIds, normalizeRoleId, readAgentProfile, toRoleProfileGuide, } from "./agent-profiles.js";
+import { wrapCommand } from "../wrap-command.js";
+const output = createCliEmitter();
+export const roleSpec = {
+    id: ["role"],
+    group: "Core",
+    summary: "Show role-specific workflow guidance.",
+    args: [{ name: "role", required: true, valueHint: "<role>" }],
+    options: [
+        {
+            kind: "boolean",
+            name: "json",
+            default: false,
+            description: "Emit compact machine-readable role payload.",
+        },
+    ],
+    examples: [{ cmd: "agentplane role ORCHESTRATOR", why: "Show ORCHESTRATOR guide." }],
+    parse: (raw) => ({ role: String(raw.args.role ?? ""), json: raw.opts.json === true }),
+};
+async function cmdRole(opts) {
+    return wrapCommand({ command: "role", rootOverride: opts.rootOverride }, async () => {
+        const roleRaw = opts.role.trim();
+        if (!roleRaw) {
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: "Missing required argument: role",
+            });
+        }
+        const normalizedRole = normalizeRoleId(roleRaw);
+        const agentProfile = await readAgentProfile({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            roleId: normalizedRole,
+        });
+        const normalizedProfile = agentProfile
+            ? toRoleProfileGuide({
+                filename: agentProfile.filename,
+                roleId: normalizedRole,
+                profile: agentProfile.profile,
+            })
+            : null;
+        const guide = renderRole(normalizedRole, { profile: normalizedProfile });
+        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}`,
+            });
+        }
+        if (guide) {
+            if (opts.json) {
+                const payload = {
+                    role: normalizedRole,
+                    guide: guide
+                        .split("\n")
+                        .map((line) => line.trim())
+                        .filter((line) => line.length > 0),
+                };
+                const supplementLines = getRoleSupplementLines(normalizedRole);
+                if (supplementLines) {
+                    payload.builtin_guide = supplementLines;
+                }
+                if (agentProfile) {
+                    payload.agent_profile = {
+                        filename: agentProfile.filename,
+                        profile: agentProfile.profile,
+                    };
+                }
+                output.json(payload);
+                return 0;
+            }
+            output.line(guide);
+            return 0;
+        }
+        if (!agentProfile) {
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: `Unknown role: ${roleRaw}.`,
+            });
+        }
+        const block = renderRole(normalizedRole, { profile: normalizedProfile });
+        if (!block) {
+            throw usageError({
+                spec: roleSpec,
+                command: "role",
+                message: `Unknown role: ${roleRaw}.`,
+            });
+        }
+        if (opts.json) {
+            output.json({
+                role: normalizedRole,
+                guide: block
+                    .split("\n")
+                    .map((line) => line.trim())
+                    .filter((line) => line.length > 0),
+                agent_profile: {
+                    filename: agentProfile.filename,
+                    profile: agentProfile.profile,
+                },
+            });
+            return 0;
+        }
+        output.line(block);
+        return 0;
+    });
+}
+export const runRole = (ctx, parsed) => {
+    return cmdRole({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride,
+        role: parsed.role,
+        json: parsed.json,
+    });
+};

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

@@ -1,25 +1,5 @@
-import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
-import type { RunDeps } from "../command-catalog.js";
-type QuickstartParsed = {
-    json: boolean;
-};
-export declare const quickstartSpec: CommandSpec<QuickstartParsed>;
-export declare const runQuickstart: CommandHandler<QuickstartParsed>;
-type PreflightMode = "quick" | "full";
-type PreflightParsed = {
-    json: boolean;
-    mode: PreflightMode;
-};
-export declare const preflightSpec: CommandSpec<PreflightParsed>;
-export declare const runPreflight: CommandHandler<PreflightParsed>;
-type RoleParsed = {
-    role: string;
-    json: boolean;
-};
-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 function makeRunAgentsHandler(deps: RunDeps): CommandHandler<AgentsParsed>;
-export {};
+export { agentsSpec, makeRunAgentsHandler } from "./core/agents.js";
+export { preflightSpec, runPreflight } from "./core/preflight.js";
+export { quickstartSpec, runQuickstart } from "./core/quickstart.js";
+export { roleSpec, runRole } from "./core/role.js";
 //# 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":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAatE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,KAAK,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAcxD,CAAC;AA6BF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAE1D,CAAC;AAEF,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AACtC,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAkP9D,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAuCtD,CAAC;AAiDF,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,eAAe,CAExD,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAe5C,CAAC;AA4OF,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,CA0FhF"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}