ultracode-ai 1.3.0

package/dist/commands/learn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.js","sourceRoot":"","sources":["../../src/commands/learn.ts"],"names":[],"mappings":"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"}

package/dist/commands/list.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `ultracode tools list [--json]` and `ultracode agents list [--json]`.
+ *
+ * Tabular listings of the registered tools and agents (name, category/type,
+ * description, permission/model). `--json` emits the raw definition arrays.
+ */
+import type { Command } from "commander";
+import type { CliContext } from "../context.js";
+/** Register the `tools` and `agents` command groups on `program`. */
+export declare function registerListCommands(program: Command, ctx: CliContext): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQhD,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAwD5E"}

package/dist/commands/list.js

@@ -0,0 +1,58 @@
+/**
+ * `ultracode tools list [--json]` and `ultracode agents list [--json]`.
+ *
+ * Tabular listings of the registered tools and agents (name, category/type,
+ * description, permission/model). `--json` emits the raw definition arrays.
+ */
+import { safeDispose } from "../context.js";
+import { formatTable } from "../utils/text.js";
+/** Register the `tools` and `agents` command groups on `program`. */
+export function registerListCommands(program, ctx) {
+    const tools = program.command("tools").description("inspect the tool registry");
+    tools
+        .command("list")
+        .description("list all registered tools")
+        .option("--json", "output as JSON")
+        .action(async (opts) => {
+        const facade = await ctx.createFacade({ cwd: ctx.cwd });
+        try {
+            const defs = facade.listTools();
+            if (opts.json) {
+                ctx.stdout.write(`${JSON.stringify(defs)}\n`);
+                return;
+            }
+            if (defs.length === 0) {
+                ctx.stdout.write("(no tools registered)\n");
+                return;
+            }
+            ctx.stdout.write(formatTable(["Name", "Category", "Permission", "Description"], defs.map((d) => [d.name, d.category, d.permission, d.description])));
+        }
+        finally {
+            await safeDispose(facade);
+        }
+    });
+    const agents = program.command("agents").description("inspect the agent registry");
+    agents
+        .command("list")
+        .description("list all available agents")
+        .option("--json", "output as JSON")
+        .action(async (opts) => {
+        const facade = await ctx.createFacade({ cwd: ctx.cwd });
+        try {
+            const defs = facade.listAgents();
+            if (opts.json) {
+                ctx.stdout.write(`${JSON.stringify(defs)}\n`);
+                return;
+            }
+            if (defs.length === 0) {
+                ctx.stdout.write("(no agents available)\n");
+                return;
+            }
+            ctx.stdout.write(formatTable(["Name", "Type", "Model", "Description"], defs.map((d) => [d.name, d.type, d.model ?? "(active model)", d.description])));
+        }
+        finally {
+            await safeDispose(facade);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"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"}

package/dist/commands/run.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `ultracode run -p/--print <prompt> [--agent <name>] [--json]`
+ *
+ * Single non-interactive agent run. Text chunks are streamed to stdout as
+ * they arrive; with `--json` the final {@link AgentRunResult} is printed as a
+ * single machine-readable JSON line instead. Errors propagate to the global
+ * handler (exit code 1).
+ */
+import type { Command } from "commander";
+import type { CliContext } from "../context.js";
+/** Register the `run` command on `program`. */
+export declare function registerRunCommand(program: Command, ctx: CliContext): void;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAShD,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAgC1E"}

package/dist/commands/run.js

@@ -0,0 +1,46 @@
+/**
+ * `ultracode run -p/--print <prompt> [--agent <name>] [--json]`
+ *
+ * Single non-interactive agent run. Text chunks are streamed to stdout as
+ * they arrive; with `--json` the final {@link AgentRunResult} is printed as a
+ * single machine-readable JSON line instead. Errors propagate to the global
+ * handler (exit code 1).
+ */
+import { safeDispose } from "../context.js";
+/** Register the `run` command on `program`. */
+export function registerRunCommand(program, ctx) {
+    program
+        .command("run")
+        .description("run a single prompt non-interactively and print the result")
+        .requiredOption("-p, --print <prompt>", "prompt to run")
+        .option("-a, --agent <name>", "agent to use for this run")
+        .option("--json", "print the full run result as JSON instead of streaming text")
+        .action(async (opts) => {
+        const facade = await ctx.createFacade({ cwd: ctx.cwd });
+        try {
+            if (opts.json) {
+                const result = await facade.run(opts.print, { agent: opts.agent });
+                ctx.stdout.write(`${JSON.stringify(result)}\n`);
+                return;
+            }
+            let streamed = false;
+            const result = await facade.run(opts.print, {
+                agent: opts.agent,
+                onChunk: (chunk) => {
+                    if (chunk.type === "text" && typeof chunk.text === "string" && chunk.text !== "") {
+                        streamed = true;
+                        ctx.stdout.write(chunk.text);
+                    }
+                },
+            });
+            // Providers that do not stream still produce a final text.
+            if (!streamed && result.text !== "")
+                ctx.stdout.write(result.text);
+            ctx.stdout.write("\n");
+        }
+        finally {
+            await safeDispose(facade);
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,GAAe;IAClE,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,4DAA4D,CAAC;SACzE,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC;SACvD,MAAM,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,6DAA6D,CAAC;SAC/E,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACnE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,CAAC,KAAsB,EAAE,EAAE;oBAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;wBACjF,QAAQ,GAAG,IAAI,CAAC;wBAChB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;YACH,2DAA2D;YAC3D,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE;gBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `ultracode --setup` — interactive first-run wizard.
+ *
+ * Asks for provider, API key (masked input, echoed as `*`), default agent and
+ * theme. Provider/agent/theme are persisted through the facade's
+ * ConfigManager (`set` + `save("user")`); the API key is written to
+ * `~/.ultracode/.env` (keys never belong in `config.toml`, see
+ * docs/GETTING-STARTED/configuration.md). The key is only ever echoed masked.
+ */
+import type { CliContext } from "../context.js";
+/** Providers offered by the wizard. */
+export declare const SETUP_PROVIDERS: readonly ["mistral", "anthropic", "openai", "local"];
+/** Interaction surface of the wizard — injectable for tests. */
+export interface SetupIO {
+    /** Ask a question, echoing the user's input. */
+    ask(question: string): Promise<string>;
+    /** Ask a question with hidden input (echoed as `*`). */
+    askMasked(question: string): Promise<string>;
+    /** Write informational output. */
+    write(s: string): void;
+}
+/** Default {@link SetupIO} backed by the context's stdin/stdout. */
+export declare function createTerminalIO(ctx: CliContext): SetupIO;
+/**
+ * Persist an API key into `~/.ultracode/.env` (created with mode 0600 where
+ * supported). An existing entry for the same variable is replaced; other
+ * lines — including `\r\n`-terminated ones — are preserved.
+ *
+ * @returns the absolute path of the env file.
+ */
+export declare function writeApiKey(ctx: CliContext, provider: string, apiKey: string): Promise<string>;
+/**
+ * Run the interactive setup wizard.
+ *
+ * @param ctx - CLI context.
+ * @param io - interaction surface; defaults to a raw-mode terminal reader.
+ * @throws {ConfigError} when an unknown provider is chosen.
+ */
+export declare function runSetup(ctx: CliContext, io?: SetupIO): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD,uCAAuC;AACvC,eAAO,MAAM,eAAe,sDAAuD,CAAC;AAEpF,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACtB,gDAAgD;IAChD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,wDAAwD;IACxD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,kCAAkC;IAClC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA+CD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,GAAE,OAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDlG"}

package/dist/commands/setup.js

@@ -0,0 +1,146 @@
+/**
+ * `ultracode --setup` — interactive first-run wizard.
+ *
+ * Asks for provider, API key (masked input, echoed as `*`), default agent and
+ * theme. Provider/agent/theme are persisted through the facade's
+ * ConfigManager (`set` + `save("user")`); the API key is written to
+ * `~/.ultracode/.env` (keys never belong in `config.toml`, see
+ * docs/GETTING-STARTED/configuration.md). The key is only ever echoed masked.
+ */
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { ConfigError, USER_ENV_FILE } from "ultracode-shared";
+import { safeDispose } from "../context.js";
+import { ThemeManager } from "../themes/index.js";
+import { resolveHome } from "../utils/resolve-home.js";
+import { maskSecret } from "../utils/text.js";
+/** Providers offered by the wizard. */
+export const SETUP_PROVIDERS = ["mistral", "anthropic", "openai", "local"];
+/**
+ * Read one line from `ctx.stdin` in raw mode.
+ * Handles Enter (`\r`/`\n`), backspace (`\b`/DEL) and Ctrl+C (returns "").
+ * With `mask`, every typed character is echoed as `*`.
+ */
+function readLine(ctx, prompt, mask) {
+    ctx.stdout.write(prompt);
+    const stdin = ctx.stdin;
+    return new Promise((resolve) => {
+        stdin.setRawMode?.(true);
+        stdin.resume?.();
+        let buf = "";
+        const finish = (value) => {
+            stdin.removeListener("data", onData);
+            stdin.setRawMode?.(false);
+            stdin.pause?.();
+            ctx.stdout.write("\n");
+            resolve(value);
+        };
+        const onData = (chunk) => {
+            const s = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            for (const ch of s) {
+                if (ch === "\u0003") {
+                    finish("");
+                    return;
+                }
+                if (ch === "\r" || ch === "\n") {
+                    finish(buf);
+                    return;
+                }
+                if (ch === "\u007F" || ch === "\b") {
+                    if (buf.length > 0) {
+                        buf = Array.from(buf).slice(0, -1).join("");
+                        ctx.stdout.write("\b \b");
+                    }
+                    continue;
+                }
+                buf += ch;
+                ctx.stdout.write(mask ? "*" : ch);
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+/** Default {@link SetupIO} backed by the context's stdin/stdout. */
+export function createTerminalIO(ctx) {
+    return {
+        ask: (q) => readLine(ctx, q, false),
+        askMasked: (q) => readLine(ctx, q, true),
+        write: (s) => ctx.stdout.write(s),
+    };
+}
+/**
+ * Persist an API key into `~/.ultracode/.env` (created with mode 0600 where
+ * supported). An existing entry for the same variable is replaced; other
+ * lines — including `\r\n`-terminated ones — are preserved.
+ *
+ * @returns the absolute path of the env file.
+ */
+export async function writeApiKey(ctx, provider, apiKey) {
+    const envPath = resolveHome(USER_ENV_FILE, ctx.homedir);
+    const varName = `${provider.toUpperCase()}_API_KEY`;
+    await fs.mkdir(path.dirname(envPath), { recursive: true });
+    let lines = [];
+    try {
+        const existing = await fs.readFile(envPath, "utf8");
+        lines = existing.split(/\r?\n/).filter((l) => l.trim() !== "" && !l.startsWith(`${varName}=`));
+    }
+    catch {
+        // no existing env file — start fresh
+    }
+    lines.push(`${varName}=${apiKey}`);
+    await fs.writeFile(envPath, `${lines.join("\n")}\n`, { encoding: "utf8", mode: 0o600 });
+    return envPath;
+}
+/**
+ * Run the interactive setup wizard.
+ *
+ * @param ctx - CLI context.
+ * @param io - interaction surface; defaults to a raw-mode terminal reader.
+ * @throws {ConfigError} when an unknown provider is chosen.
+ */
+export async function runSetup(ctx, io = createTerminalIO(ctx)) {
+    io.write("UltraCode Setup\n\n");
+    const provAnswer = (await io.ask(`Provider (${SETUP_PROVIDERS.join("/")}) [mistral]: `))
+        .trim()
+        .toLowerCase();
+    const provider = provAnswer === "" ? "mistral" : provAnswer;
+    if (!SETUP_PROVIDERS.includes(provider)) {
+        throw new ConfigError(`Unknown provider "${provAnswer}". Choose one of: ${SETUP_PROVIDERS.join(", ")}`);
+    }
+    let apiKey = "";
+    if (provider !== "local") {
+        apiKey = (await io.askMasked(`API key for ${provider} (input hidden, Enter to skip): `)).trim();
+    }
+    const agent = (await io.ask("Default agent [default]: ")).trim() || "default";
+    const themes = new ThemeManager();
+    const themeAnswer = (await io.ask(`Theme (${themes.list().join("/")}) [dark]: `)).trim();
+    const theme = themes.has(themeAnswer) ? themes.get(themeAnswer).name : "dark";
+    if (themeAnswer !== "" && !themes.has(themeAnswer)) {
+        io.write(`! Unknown theme "${themeAnswer}" — falling back to "dark"\n`);
+    }
+    const facade = await ctx.createFacade({ cwd: ctx.cwd });
+    try {
+        const manager = facade.configManager;
+        if (manager && typeof manager.set === "function" && typeof manager.save === "function") {
+            manager.set("core.activeProvider", provider);
+            manager.set("providers.default", provider);
+            manager.set("core.defaultAgent", agent);
+            manager.set("agents.default", agent);
+            manager.set("ui.theme", theme);
+            await manager.save("user");
+            io.write("✓ configuration saved (user layer)\n");
+        }
+        else {
+            io.write("! ConfigManager not available — provider/agent/theme were NOT persisted\n");
+        }
+        if (apiKey !== "") {
+            const envPath = await writeApiKey(ctx, provider, apiKey);
+            io.write(`✓ API key for ${provider} stored in ${envPath} (${maskSecret(apiKey)})\n`);
+        }
+        io.write(`\nDone. Provider: ${provider}, agent: ${agent}, theme: ${theme}\n`);
+    }
+    finally {
+        await safeDispose(facade);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/commands/skills.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `ultracode skills list|show <name>|create|test|upgrade`
+ *
+ * Skill authoring commands backed by the facade's `authoring` sub-API
+ * (Module B). `create`/`upgrade` build an {@link AuthoringProposal} from
+ * knowledge material (a JSON file or inline `--topic`/`--catalog` flags),
+ * `test` validates a proposal/skill, and `persist` is gated behind `--yes`
+ * (no implicit writes).
+ *
+ * Every subcommand supports `--json`.
+ */
+import type { Command } from "commander";
+import type { CliContext } from "../context.js";
+/** Register the `skills` command group on `program`. */
+export declare function registerSkillsCommands(program: Command, ctx: CliContext): void;
+//# sourceMappingURL=skills.d.ts.map

package/dist/commands/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAgFhD,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CA2E9E"}

package/dist/commands/skills.js

@@ -0,0 +1,148 @@
+/**
+ * `ultracode skills list|show <name>|create|test|upgrade`
+ *
+ * Skill authoring commands backed by the facade's `authoring` sub-API
+ * (Module B). `create`/`upgrade` build an {@link AuthoringProposal} from
+ * knowledge material (a JSON file or inline `--topic`/`--catalog` flags),
+ * `test` validates a proposal/skill, and `persist` is gated behind `--yes`
+ * (no implicit writes).
+ *
+ * Every subcommand supports `--json`.
+ */
+import path from "node:path";
+import process from "node:process";
+import { promises as fs } from "node:fs";
+import { ValidationError } from "ultracode-shared";
+import { authoringOf, withExtFacade } from "./ext-helpers.js";
+import { formatBlock, formatSkillList, formatTestResult } from "./ext-format.js";
+/** Build {@link KnowledgeMaterial} from a JSON file or inline flags. */
+async function loadMaterial(ctx, opts) {
+    if (opts.file !== undefined) {
+        const target = path.resolve(ctx.cwd, opts.file);
+        let raw;
+        try {
+            raw = await fs.readFile(target, "utf8");
+        }
+        catch (cause) {
+            throw new ValidationError(`Cannot read material file: ${target}`, { cause });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw.replace(/^/, ""));
+        }
+        catch (cause) {
+            throw new ValidationError(`Invalid JSON in material file: ${target}`, { cause });
+        }
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new ValidationError(`Material file must contain a JSON object: ${target}`);
+        }
+        return parsed;
+    }
+    if (opts.topic === undefined || opts.catalog === undefined) {
+        throw new ValidationError("Provide --file <material.json>, or both --topic and --catalog to create skill material inline.");
+    }
+    return {
+        catalog: opts.catalog,
+        topic: opts.topic,
+        summary: opts.summary ?? "",
+        facts: [],
+        codeSnippets: [],
+        sources: [],
+    };
+}
+/** Print a proposal in either JSON or human form. */
+function writeProposal(ctx, proposal, json) {
+    if (json) {
+        ctx.stdout.write(`${JSON.stringify(proposal)}\n`);
+        return;
+    }
+    ctx.stdout.write(`Proposal (${proposal.kind}): ${proposal.name}\n`);
+    ctx.stdout.write(formatBlock("Rationale", proposal.rationale));
+    if (proposal.diffFromExisting !== undefined) {
+        ctx.stdout.write(formatBlock("Diff", proposal.diffFromExisting));
+    }
+}
+async function createOrUpgrade(ctx, opts) {
+    await withExtFacade(ctx, async (facade) => {
+        const material = await loadMaterial(ctx, opts);
+        const proposal = await authoringOf(facade).createSkill(material);
+        writeProposal(ctx, proposal, opts.json === true);
+        if (opts.yes === true) {
+            await authoringOf(facade).persist(proposal, { approved: true });
+            if (opts.json !== true)
+                ctx.stdout.write(`✓ skill "${proposal.name}" persisted\n`);
+        }
+        else if (opts.json !== true) {
+            ctx.stdout.write("Run again with --yes to persist this skill.\n");
+        }
+    });
+}
+/** Register the `skills` command group on `program`. */
+export function registerSkillsCommands(program, ctx) {
+    const skills = program.command("skills").description("author and inspect skills");
+    skills
+        .command("list")
+        .description("list authored skills")
+        .argument("[catalog]", "restrict to a catalog")
+        .option("--json", "output as JSON")
+        .action(async (catalog, opts) => withExtFacade(ctx, async (facade) => {
+        const list = await authoringOf(facade).skills.list(catalog);
+        ctx.stdout.write(opts.json ? `${JSON.stringify(list)}\n` : formatSkillList(list));
+    }));
+    skills
+        .command("show")
+        .description("print a single skill (frontmatter + body)")
+        .argument("<name>", "skill name")
+        .option("--json", "output as JSON")
+        .action(async (name, opts) => withExtFacade(ctx, async (facade) => {
+        const skill = await authoringOf(facade).skills.get(name);
+        if (skill === null)
+            throw new ValidationError(`Unknown skill: "${name}"`);
+        if (opts.json) {
+            ctx.stdout.write(`${JSON.stringify(skill)}\n`);
+            return;
+        }
+        ctx.stdout.write(`# ${skill.name} v${skill.version} [${skill.status}]\n`);
+        ctx.stdout.write(`catalog: ${skill.catalog}\n`);
+        ctx.stdout.write(`triggers: ${skill.triggers.join(", ")}\n`);
+        ctx.stdout.write(`score: ${authoringOf(facade).scoreSkill(skill)}\n\n`);
+        ctx.stdout.write(`${skill.body}\n`);
+    }));
+    skills
+        .command("create")
+        .description("create a new skill from knowledge material (proposal only unless --yes)")
+        .option("--file <path>", "knowledge material JSON file")
+        .option("--topic <topic>", "skill topic (inline material)")
+        .option("--catalog <catalog>", "skill catalog (inline material)")
+        .option("--summary <text>", "skill summary (inline material)")
+        .option("--yes", "persist the proposal instead of only printing it")
+        .option("--json", "output as JSON")
+        .action(async (opts) => createOrUpgrade(ctx, opts));
+    skills
+        .command("upgrade")
+        .description("upgrade an existing skill from new material (proposal only unless --yes)")
+        .option("--file <path>", "knowledge material JSON file")
+        .option("--topic <topic>", "skill topic (inline material)")
+        .option("--catalog <catalog>", "skill catalog (inline material)")
+        .option("--summary <text>", "skill summary (inline material)")
+        .option("--yes", "persist the proposal instead of only printing it")
+        .option("--json", "output as JSON")
+        .action(async (opts) => createOrUpgrade(ctx, opts));
+    skills
+        .command("test")
+        .description("test a skill proposal built from material, without persisting")
+        .option("--file <path>", "knowledge material JSON file")
+        .option("--topic <topic>", "skill topic (inline material)")
+        .option("--catalog <catalog>", "skill catalog (inline material)")
+        .option("--summary <text>", "skill summary (inline material)")
+        .option("--json", "output as JSON")
+        .action(async (opts) => withExtFacade(ctx, async (facade) => {
+        const material = await loadMaterial(ctx, opts);
+        const proposal = await authoringOf(facade).createSkill(material);
+        const result = await authoringOf(facade).test(proposal);
+        ctx.stdout.write(opts.json ? `${JSON.stringify(result)}\n` : formatTestResult(result));
+        if (!result.passed)
+            process.exitCode = 1;
+    }));
+}
+//# sourceMappingURL=skills.js.map

package/dist/commands/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"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"}

package/dist/commands/versioning.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Versioning commands:
+ * - `ultracode version analyze [range]` / `version suggest [range]`
+ * - `ultracode release plan [version]`
+ * - `ultracode quality` (exits 1 when the quality gates fail — CI-friendly)
+ *
+ * All subcommands support `--json` for machine-readable output.
+ */
+import type { Command } from "commander";
+import type { CliContext } from "../context.js";
+/** Register `version`, `release` and `quality` commands on `program`. */
+export declare function registerVersioningCommands(program: Command, ctx: CliContext): void;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/commands/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/commands/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAyBjE,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAoDlF"}

package/dist/commands/versioning.js

@@ -0,0 +1,63 @@
+/**
+ * Versioning commands:
+ * - `ultracode version analyze [range]` / `version suggest [range]`
+ * - `ultracode release plan [version]`
+ * - `ultracode quality` (exits 1 when the quality gates fail — CI-friendly)
+ *
+ * All subcommands support `--json` for machine-readable output.
+ */
+import process from "node:process";
+import { safeDispose } from "../context.js";
+import { formatChangeAnalysis, formatQualityReport, formatReleasePlan, formatVersionSuggestion, } from "../format.js";
+async function withFacade(ctx, fn) {
+    const facade = await ctx.createFacade({ cwd: ctx.cwd });
+    try {
+        return await fn(facade);
+    }
+    finally {
+        await safeDispose(facade);
+    }
+}
+/** Register `version`, `release` and `quality` commands on `program`. */
+export function registerVersioningCommands(program, ctx) {
+    const version = program.command("version").description("AI versioning: change analysis and version suggestions");
+    version
+        .command("analyze")
+        .description("analyze the changes in the working tree / commit range")
+        .argument("[range]", 'git range to analyze, e.g. "v1.2.0..HEAD"')
+        .option("--json", "output as JSON")
+        .action(async (range, opts) => withFacade(ctx, async (facade) => {
+        const analysis = await facade.versioning.analyze(range);
+        ctx.stdout.write(opts.json ? `${JSON.stringify(analysis)}\n` : formatChangeAnalysis(analysis));
+    }));
+    version
+        .command("suggest")
+        .description("suggest the next version based on the analyzed changes")
+        .argument("[range]", 'git range to analyze, e.g. "v1.2.0..HEAD"')
+        .option("--json", "output as JSON")
+        .action(async (range, opts) => withFacade(ctx, async (facade) => {
+        const suggestion = await facade.versioning.suggest(range);
+        ctx.stdout.write(opts.json ? `${JSON.stringify(suggestion)}\n` : formatVersionSuggestion(suggestion));
+    }));
+    const release = program.command("release").description("release planning");
+    release
+        .command("plan")
+        .description("draft a release plan for the given (or suggested) version")
+        .argument("[version]", "target version; suggested automatically when omitted")
+        .option("--json", "output as JSON")
+        .action(async (target, opts) => withFacade(ctx, async (facade) => {
+        const plan = await facade.versioning.plan(target);
+        ctx.stdout.write(opts.json ? `${JSON.stringify(plan)}\n` : formatReleasePlan(plan));
+    }));
+    program
+        .command("quality")
+        .description("run the release quality gates (exit code 1 when gates fail)")
+        .option("--json", "output as JSON")
+        .action(async (opts) => withFacade(ctx, async (facade) => {
+        const report = await facade.versioning.quality();
+        ctx.stdout.write(opts.json ? `${JSON.stringify(report)}\n` : formatQualityReport(report));
+        if (!report.passed)
+            process.exitCode = 1;
+    }));
+}
+//# sourceMappingURL=versioning.js.map