ultracode-ai 1.3.0

package/dist/commands/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/commands/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAMtB,KAAK,UAAU,UAAU,CACvB,GAAe,EACf,EAA2C;IAE3C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,OAAgB,EAAE,GAAe;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,wDAAwD,CAAC,CAAC;IAEjH,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wDAAwD,CAAC;SACrE,QAAQ,CAAC,SAAS,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,IAAgB,EAAE,EAAE,CAC5D,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjG,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wDAAwD,CAAC;SACrE,QAAQ,CAAC,SAAS,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,IAAgB,EAAE,EAAE,CAC5D,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC,CACH,CAAC;IAEJ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAE3E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2DAA2D,CAAC;SACxE,QAAQ,CAAC,WAAW,EAAE,sDAAsD,CAAC;SAC7E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,MAA0B,EAAE,IAAgB,EAAE,EAAE,CAC7D,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE,CACjC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACjD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,60 @@
+/**
+ * CLI execution context.
+ *
+ * Everything the commands need from the outside world (streams, environment,
+ * facade construction, git probing) is bundled in a {@link CliContext} and
+ * passed down explicitly. Production code uses {@link createDefaultContext};
+ * tests inject fakes, which keeps every command fully unit-testable, offline
+ * and cross-platform.
+ */
+import type { UltraCode, UltraCodeCreateOptions } from "ultracode-core";
+/** Instance type of the UltraCode facade. */
+export type UltraCodeFacade = UltraCode;
+/** Minimal writable stream surface used by the CLI. */
+export interface CliWriter {
+    write(s: string): unknown;
+    isTTY?: boolean;
+}
+/** Minimal readable stream surface used by the CLI (stdin). */
+export interface CliReader {
+    isTTY?: boolean;
+    setRawMode?(mode: boolean): unknown;
+    on(event: "data", listener: (chunk: Buffer | string) => void): unknown;
+    removeListener(event: "data", listener: (chunk: Buffer | string) => void): unknown;
+    resume?(): unknown;
+    pause?(): unknown;
+}
+/** Dependency bundle handed to every CLI command. */
+export interface CliContext {
+    /** Working directory commands resolve project paths against. */
+    cwd: string;
+    /** Environment snapshot (API-key presence checks etc.). */
+    env: NodeJS.ProcessEnv;
+    /** Home directory used to expand `~`-prefixed shared constants. */
+    homedir: string;
+    /** Node.js runtime version (`process.versions.node`). */
+    nodeVersion: string;
+    /** Standard output. */
+    stdout: CliWriter;
+    /** Standard error. */
+    stderr: CliWriter;
+    /** Standard input. */
+    stdin: CliReader;
+    /** Construct the UltraCode facade (lazily imports `ultracode-core`). */
+    createFacade(options?: UltraCodeCreateOptions): Promise<UltraCodeFacade>;
+    /** Probe `git --version`; resolves `null` when git is unavailable. */
+    gitVersion(): Promise<string | null>;
+}
+/**
+ * Probe for a working `git` binary by spawning `git --version`.
+ * Never rejects: missing binaries and spawn failures resolve to `null`.
+ */
+export declare function defaultGitVersion(): Promise<string | null>;
+/**
+ * Build the production {@link CliContext} from the real process streams and
+ * the dynamically imported `ultracode-core` facade.
+ */
+export declare function createDefaultContext(): CliContext;
+/** Dispose a facade, swallowing secondary errors (never masks the original). */
+export declare function safeDispose(facade: UltraCodeFacade): Promise<void>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC;AAExC,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACpC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IACvE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IACnF,MAAM,CAAC,IAAI,OAAO,CAAC;IACnB,KAAK,CAAC,IAAI,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzE,sEAAsE;IACtE,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoB1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAejD;AAED,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE"}

package/dist/context.js

@@ -0,0 +1,69 @@
+/**
+ * CLI execution context.
+ *
+ * Everything the commands need from the outside world (streams, environment,
+ * facade construction, git probing) is bundled in a {@link CliContext} and
+ * passed down explicitly. Production code uses {@link createDefaultContext};
+ * tests inject fakes, which keeps every command fully unit-testable, offline
+ * and cross-platform.
+ */
+import os from "node:os";
+import process from "node:process";
+import { spawn } from "node:child_process";
+import { loadCore } from "./core-loader.js";
+/**
+ * Probe for a working `git` binary by spawning `git --version`.
+ * Never rejects: missing binaries and spawn failures resolve to `null`.
+ */
+export function defaultGitVersion() {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("git", ["--version"], { stdio: ["ignore", "pipe", "ignore"] });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        child.once("error", () => {
+            resolve(null);
+        });
+        child.stdout?.on("data", (d) => {
+            out += String(d);
+        });
+        child.once("close", (code) => {
+            resolve(code === 0 && out.trim() !== "" ? out.trim() : null);
+        });
+    });
+}
+/**
+ * Build the production {@link CliContext} from the real process streams and
+ * the dynamically imported `ultracode-core` facade.
+ */
+export function createDefaultContext() {
+    return {
+        cwd: process.cwd(),
+        env: process.env,
+        homedir: os.homedir(),
+        nodeVersion: process.versions.node,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        stdin: process.stdin,
+        createFacade: async (options) => {
+            const core = await loadCore();
+            return core.UltraCode.create({ cwd: process.cwd(), ...options });
+        },
+        gitVersion: defaultGitVersion,
+    };
+}
+/** Dispose a facade, swallowing secondary errors (never masks the original). */
+export async function safeDispose(facade) {
+    try {
+        await facade.dispose();
+    }
+    catch {
+        // Disposal failures must never shadow the primary command outcome.
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA2C5C;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;QACrB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,KAAK,EAAE,OAAgC,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,UAAU,EAAE,iBAAiB;KAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAuB;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC"}

package/dist/core-loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Indirection module for loading `ultracode-core`.
+ *
+ * The CLI never imports `ultracode-core` statically: the import happens
+ * lazily inside {@link loadCore}. This keeps startup fast for non-interactive
+ * commands and — crucially — lets tests replace the whole core package by
+ * mocking *this local module* (`vi.mock("./core-loader.js", ...)`), which works
+ * even while `ultracode-core` is not built yet.
+ */
+import type { UltraCode } from "ultracode-core";
+/** Shape of the dynamically imported `ultracode-core` module. */
+export interface CoreModule {
+    /** The UltraCode facade class. */
+    UltraCode: typeof UltraCode;
+}
+/**
+ * Dynamically import `ultracode-core`.
+ *
+ * @returns the core module, exposing the {@link CoreModule.UltraCode} facade.
+ */
+export declare function loadCore(): Promise<CoreModule>;
+//# sourceMappingURL=core-loader.d.ts.map

package/dist/core-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loader.d.ts","sourceRoot":"","sources":["../src/core-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAMpD"}

package/dist/core-loader.js

@@ -0,0 +1,22 @@
+/**
+ * Indirection module for loading `ultracode-core`.
+ *
+ * The CLI never imports `ultracode-core` statically: the import happens
+ * lazily inside {@link loadCore}. This keeps startup fast for non-interactive
+ * commands and — crucially — lets tests replace the whole core package by
+ * mocking *this local module* (`vi.mock("./core-loader.js", ...)`), which works
+ * even while `ultracode-core` is not built yet.
+ */
+/**
+ * Dynamically import `ultracode-core`.
+ *
+ * @returns the core module, exposing the {@link CoreModule.UltraCode} facade.
+ */
+export async function loadCore() {
+    // The `@vite-ignore` hint stops Vitest's (Vite's) import analysis from
+    // eagerly resolving the not-yet-built core package at transform time.
+    // Node's runtime behaviour is unaffected.
+    const specifier = "ultracode-core";
+    return (await import(/* @vite-ignore */ specifier));
+}
+//# sourceMappingURL=core-loader.js.map

package/dist/core-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loader.js","sourceRoot":"","sources":["../src/core-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,uEAAuE;IACvE,sEAAsE;IACtE,0CAA0C;IAC1C,MAAM,SAAS,GAAG,gBAAgB,CAAC;IACnC,OAAO,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAe,CAAC;AACpE,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Human-readable formatters for the versioning subsystem's result types
+ * (`ChangeAnalysis`, `VersionSuggestion`, `ReleasePlan`, `QualityReport`).
+ * All formatters are pure, total and ANSI-free.
+ */
+import type { ChangeAnalysis, QualityReport, ReleasePlan, VersionSuggestion } from "ultracode-shared";
+/** Format a {@link ChangeAnalysis} as an indented plain-text report. */
+export declare function formatChangeAnalysis(a: ChangeAnalysis): string;
+/** Format a {@link VersionSuggestion} including bump, confidence and reasons. */
+export declare function formatVersionSuggestion(s: VersionSuggestion): string;
+/** Format a {@link ReleasePlan} with milestones, risks and changelog draft. */
+export declare function formatReleasePlan(p: ReleasePlan): string;
+/** Format a {@link QualityReport}: per-gate `✓`/`✗` plus the overall score. */
+export declare function formatQualityReport(q: QualityReport): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAM1B,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAsB9D;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAWpE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAoBxD;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAU5D"}

package/dist/format.js

@@ -0,0 +1,80 @@
+/**
+ * Human-readable formatters for the versioning subsystem's result types
+ * (`ChangeAnalysis`, `VersionSuggestion`, `ReleasePlan`, `QualityReport`).
+ * All formatters are pure, total and ANSI-free.
+ */
+import { truncate } from "ultracode-shared";
+/** Cap applied to free-form blocks (changelog drafts etc.). */
+const MAX_BLOCK_CHARS = 10_000;
+/** Format a {@link ChangeAnalysis} as an indented plain-text report. */
+export function formatChangeAnalysis(a) {
+    const additions = a.files.reduce((n, f) => n + f.additions, 0);
+    const deletions = a.files.reduce((n, f) => n + f.deletions, 0);
+    const cats = Object.entries(a.categories)
+        .map(([k, v]) => `${k} ${v}`)
+        .join(", ");
+    const lines = [
+        "Change Analysis",
+        `  Files:   ${a.files.length} changed (+${additions} / -${deletions})`,
+        `  Commits: ${a.commits.length} (${cats})`,
+        `  Breaking changes: ${a.breakingChanges.length}`,
+    ];
+    for (const b of a.breakingChanges) {
+        lines.push(`    - [${b.source}] ${b.description}${b.location ? ` (${b.location})` : ""}`);
+    }
+    lines.push(`  Security findings: ${a.securityFindings.length}`);
+    for (const s of a.securityFindings) {
+        lines.push(`    - [${s.severity}] ${s.rule} in ${s.file}${s.line !== undefined ? `:${s.line}` : ""} — ${s.description}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Format a {@link VersionSuggestion} including bump, confidence and reasons. */
+export function formatVersionSuggestion(s) {
+    const confidence = Math.round(s.confidence * 100);
+    const lines = [
+        "Version Suggestion",
+        `  ${s.currentVersion} → ${s.suggestedVersion} (${s.bump} bump, confidence ${confidence}%)`,
+    ];
+    if (s.reasons.length > 0) {
+        lines.push("  Reasons:");
+        for (const r of s.reasons)
+            lines.push(`    - ${truncate(r, 200)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Format a {@link ReleasePlan} with milestones, risks and changelog draft. */
+export function formatReleasePlan(p) {
+    const lines = [
+        `Release Plan ${p.version}${p.targetDate ? ` (target ${p.targetDate})` : ""}`,
+    ];
+    lines.push(`  Milestones: ${p.milestones.length}`);
+    for (const m of p.milestones) {
+        lines.push(`    [${m.done ? "x" : " "}] ${m.title}`);
+        for (const item of m.items)
+            lines.push(`        - ${truncate(item, 200)}`);
+    }
+    lines.push(`  Risks: ${p.risks.length}`);
+    for (const r of p.risks) {
+        lines.push(`    - [${r.severity}] ${r.description} — mitigation: ${r.mitigation}`);
+    }
+    if (p.changelogDraft.trim() !== "") {
+        lines.push("  Changelog draft:");
+        for (const l of truncate(p.changelogDraft, MAX_BLOCK_CHARS).split(/\r?\n/)) {
+            lines.push(`    ${l}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Format a {@link QualityReport}: per-gate `✓`/`✗` plus the overall score. */
+export function formatQualityReport(q) {
+    const lines = [
+        `Quality Report — ${q.passed ? "✓ PASSED" : "✗ FAILED"} (overall score ${q.overallScore})`,
+    ];
+    for (const g of q.gates) {
+        const mark = g.passed ? "✓" : "✗";
+        const score = g.score !== undefined ? ` (${g.score})` : "";
+        lines.push(`  ${mark} ${g.gate}${score} — ${truncate(g.details, 200)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * UltraCode CLI entry point.
+ *
+ * All argument parsing, command dispatch and error handling lives in
+ * {@link runCli}; this file only forwards `process.argv` and propagates the
+ * resulting exit code via `process.exitCode` (never `process.exit`, so
+ * pending stdout writes are flushed).
+ */
+/**
+ * Silence the single `node:sqlite` `ExperimentalWarning` so the CLI's
+ * first-run output stays clean.
+ *
+ * Persistent sessions dynamically import `node:sqlite` (still flagged
+ * experimental), which makes Node emit a noisy multi-line warning to stderr on
+ * first use. We register a `warning` listener *before* anything loads the module
+ * and re-emit every warning except that one — so all other warnings (including
+ * unrelated `ExperimentalWarning`s) reach the user unchanged. The guard is
+ * idempotent and returns a disposer for tests.
+ */
+export declare function suppressSqliteExperimentalWarning(proc?: NodeJS.Process): () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAMH;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,GAAE,MAAM,CAAC,OAAiB,GAAG,MAAM,IAAI,CAkB5F"}

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * UltraCode CLI entry point.
+ *
+ * All argument parsing, command dispatch and error handling lives in
+ * {@link runCli}; this file only forwards `process.argv` and propagates the
+ * resulting exit code via `process.exitCode` (never `process.exit`, so
+ * pending stdout writes are flushed).
+ */
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { runCli } from "./program.js";
+/**
+ * Silence the single `node:sqlite` `ExperimentalWarning` so the CLI's
+ * first-run output stays clean.
+ *
+ * Persistent sessions dynamically import `node:sqlite` (still flagged
+ * experimental), which makes Node emit a noisy multi-line warning to stderr on
+ * first use. We register a `warning` listener *before* anything loads the module
+ * and re-emit every warning except that one — so all other warnings (including
+ * unrelated `ExperimentalWarning`s) reach the user unchanged. The guard is
+ * idempotent and returns a disposer for tests.
+ */
+export function suppressSqliteExperimentalWarning(proc = process) {
+    const isSqliteExperimental = (warning) => warning.name === "ExperimentalWarning" && /\bSQLite\b/i.test(warning.message);
+    // Capture the default printer once, then take over emission ourselves.
+    const previous = proc.listeners("warning");
+    for (const listener of previous)
+        proc.removeListener("warning", listener);
+    const filter = (warning) => {
+        if (isSqliteExperimental(warning))
+            return;
+        for (const listener of previous)
+            listener.call(proc, warning);
+    };
+    proc.on("warning", filter);
+    return () => {
+        proc.removeListener("warning", filter);
+        for (const listener of previous)
+            proc.on("warning", listener);
+    };
+}
+/** True when this module is the process entry point (not imported by a test). */
+function isMainModule() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return fileURLToPath(import.meta.url) === entry;
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
+    suppressSqliteExperimentalWarning();
+    process.exitCode = await runCli(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAuB,OAAO;IAC9E,MAAM,oBAAoB,GAAG,CAAC,OAAc,EAAW,EAAE,CACvD,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhF,uEAAuE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAiC,CAAC;IAC3E,KAAK,MAAM,QAAQ,IAAI,QAAQ;QAAE,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAG,CAAC,OAAc,EAAQ,EAAE;QACtC,IAAI,oBAAoB,CAAC,OAAO,CAAC;YAAE,OAAO;QAC1C,KAAK,MAAM,QAAQ,IAAI,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3B,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,KAAK,MAAM,QAAQ,IAAI,QAAQ;YAAE,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,YAAY,EAAE,EAAE,CAAC;IACnB,iCAAiC,EAAE,CAAC;IACpC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/program.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Commander program assembly and the top-level error boundary.
+ *
+ * {@link createProgram} wires all subcommands against a {@link CliContext};
+ * {@link runCli} parses an argv, maps every failure mode to a process exit
+ * code (UltraCodeError → red message + 1, unknown → message + `--debug` hint
+ * + 1) and never calls `process.exit` itself — only `process.exitCode`.
+ */
+import { Command } from "commander";
+import type { CliContext } from "./context.js";
+/** Build the fully wired commander program for the given context. */
+export declare function createProgram(ctx: CliContext): Command;
+/**
+ * Parse and execute an argv (node-style: `[node, script, ...args]`).
+ *
+ * @returns the process exit code (also assigned to `process.exitCode`).
+ */
+export declare function runCli(argv: readonly string[], ctx?: CliContext): Promise<number>;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB/C,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAwDtD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCvF"}

package/dist/program.js

@@ -0,0 +1,120 @@
+/**
+ * Commander program assembly and the top-level error boundary.
+ *
+ * {@link createProgram} wires all subcommands against a {@link CliContext};
+ * {@link runCli} parses an argv, maps every failure mode to a process exit
+ * code (UltraCodeError → red message + 1, unknown → message + `--debug` hint
+ * + 1) and never calls `process.exit` itself — only `process.exitCode`.
+ */
+import process from "node:process";
+import { Command, CommanderError } from "commander";
+import { UltraCodeError } from "ultracode-shared";
+import { createDefaultContext } from "./context.js";
+import { registerConfigCommand } from "./commands/config.js";
+import { registerDoctorCommand } from "./commands/doctor.js";
+import { registerListCommands } from "./commands/list.js";
+import { registerRunCommand } from "./commands/run.js";
+import { runSetup } from "./commands/setup.js";
+import { registerVersioningCommands } from "./commands/versioning.js";
+import { registerBudgetCommands } from "./commands/budget.js";
+import { registerSkillsCommands } from "./commands/skills.js";
+import { registerAuthoringAgentCommands } from "./commands/authoring-agents.js";
+import { registerLearnCommands } from "./commands/learn.js";
+import { getCliVersion } from "./utils/cli-version.js";
+import { paint } from "./utils/text.js";
+/** Build the fully wired commander program for the given context. */
+export function createProgram(ctx) {
+    const program = new Command();
+    program
+        .name("ultracode-ai")
+        .description("UltraCode — interactive AI code assistant for the terminal")
+        .version(getCliVersion(), "-V, --version", "print the CLI version")
+        .option("--debug", "print stack traces for unexpected errors")
+        .option("--setup", "run the interactive setup wizard")
+        .exitOverride()
+        .configureOutput({
+        writeOut: (s) => {
+            ctx.stdout.write(s);
+        },
+        writeErr: (s) => {
+            ctx.stderr.write(s);
+        },
+    });
+    registerRunCommand(program, ctx);
+    registerConfigCommand(program, ctx);
+    registerListCommands(program, ctx);
+    // Must run after registerListCommands so it attaches to the existing `agents` group.
+    registerAuthoringAgentCommands(program, ctx);
+    registerVersioningCommands(program, ctx);
+    registerBudgetCommands(program, ctx);
+    registerSkillsCommands(program, ctx);
+    registerLearnCommands(program, ctx);
+    registerDoctorCommand(program, ctx);
+    // Default action: setup wizard via --setup, otherwise the interactive UI.
+    program.action(async (opts) => {
+        if (program.args.length > 0) {
+            ctx.stderr.write(`error: unknown command '${program.args[0]}'\n`);
+            ctx.stderr.write("Run `ultracode --help` for a list of commands.\n");
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.setup) {
+            await runSetup(ctx);
+            return;
+        }
+        if (ctx.stdout.isTTY !== true || ctx.stdin.isTTY !== true) {
+            ctx.stdout.write("No interactive terminal detected. Use `ultracode run -p \"<prompt>\"` for one-shot runs.\n\n");
+            ctx.stdout.write(program.helpInformation());
+            process.exitCode = 1;
+            return;
+        }
+        // Ink/React are only loaded when the interactive UI actually starts.
+        const { startInteractive } = await import("./ui/start.js");
+        await startInteractive(ctx);
+    });
+    return program;
+}
+/**
+ * Parse and execute an argv (node-style: `[node, script, ...args]`).
+ *
+ * @returns the process exit code (also assigned to `process.exitCode`).
+ */
+export async function runCli(argv, ctx) {
+    const context = ctx ?? createDefaultContext();
+    const debug = argv.includes("--debug");
+    const program = createProgram(context);
+    try {
+        await program.parseAsync([...argv]);
+        const code = typeof process.exitCode === "number" ? process.exitCode : 0;
+        return code;
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            // --help/--version and usage errors; commander already wrote the output.
+            const code = err.code === "commander.helpDisplayed" || err.code === "commander.version"
+                ? 0
+                : (err.exitCode ?? 1);
+            process.exitCode = code;
+            return code;
+        }
+        const colored = context.stderr.isTTY === true;
+        if (err instanceof UltraCodeError) {
+            context.stderr.write(paint(`✗ ${err.code}: ${err.message}\n`, "31", colored));
+            if (debug && err.stack !== undefined)
+                context.stderr.write(`${err.stack}\n`);
+            process.exitCode = 1;
+            return 1;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        context.stderr.write(paint(`✗ Unexpected error: ${message}\n`, "31", colored));
+        if (debug && err instanceof Error && err.stack !== undefined) {
+            context.stderr.write(`${err.stack}\n`);
+        }
+        else {
+            context.stderr.write("Run again with --debug for a stack trace.\n");
+        }
+        process.exitCode = 1;
+        return 1;
+    }
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/themes/dark.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "./theme.js";
+/** Default dark theme (Ink colour names, safe on dark terminal backgrounds). */
+export declare const dark: Theme;
+//# sourceMappingURL=dark.d.ts.map

package/dist/themes/dark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark.d.ts","sourceRoot":"","sources":["../../src/themes/dark.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,gFAAgF;AAChF,eAAO,MAAM,IAAI,EAAE,KAalB,CAAC"}

package/dist/themes/dark.js

@@ -0,0 +1,16 @@
+/** Default dark theme (Ink colour names, safe on dark terminal backgrounds). */
+export const dark = {
+    name: "dark",
+    primary: "cyan",
+    secondary: "magenta",
+    accent: "blueBright",
+    text: "white",
+    dim: "gray",
+    success: "green",
+    warning: "yellow",
+    error: "red",
+    user: "cyanBright",
+    assistant: "white",
+    tool: "yellow",
+};
+//# sourceMappingURL=dark.js.map

package/dist/themes/dark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark.js","sourceRoot":"","sources":["../../src/themes/dark.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,CAAC,MAAM,IAAI,GAAU;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,YAAY;IAClB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,QAAQ;CACf,CAAC"}

package/dist/themes/dracula.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "./theme.js";
+/** Dracula theme (https://draculatheme.com palette). */
+export declare const dracula: Theme;
+//# sourceMappingURL=dracula.d.ts.map

package/dist/themes/dracula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dracula.d.ts","sourceRoot":"","sources":["../../src/themes/dracula.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wDAAwD;AACxD,eAAO,MAAM,OAAO,EAAE,KAarB,CAAC"}

package/dist/themes/dracula.js

@@ -0,0 +1,16 @@
+/** Dracula theme (https://draculatheme.com palette). */
+export const dracula = {
+    name: "dracula",
+    primary: "#bd93f9",
+    secondary: "#ff79c6",
+    accent: "#8be9fd",
+    text: "#f8f8f2",
+    dim: "#6272a4",
+    success: "#50fa7b",
+    warning: "#f1fa8c",
+    error: "#ff5555",
+    user: "#8be9fd",
+    assistant: "#f8f8f2",
+    tool: "#ffb86c",
+};
+//# sourceMappingURL=dracula.js.map

package/dist/themes/dracula.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dracula.js","sourceRoot":"","sources":["../../src/themes/dracula.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAU;IAC5B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;CAChB,CAAC"}