gnosys 5.9.1 → 5.9.3

package/dist/lib/setup/coldStart.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Cold-start (linear wizard) rendering helpers — v5.9.3 redesign.
+ *
+ * These pure render functions replace the bespoke banner/box drawing
+ * inside `runSetup()` with the new atom-based layout. They produce
+ * strings (no I/O) so they're snapshot-testable.
+ *
+ * Screens 1.1 (provider), 1.2 (model), 1.3 (key) get their headers
+ * here. The actual provider/model pickers stay in `setup.ts` —
+ * pickProvider / pickModel are called from multiple paths and were
+ * intentionally left untouched per the v5.9.3 brief; the cold-start
+ * sub-screen functions wrap the picker invocations with the header
+ * chrome.
+ */
+/**
+ * Splash screen body (Screen 1.0 in the design handoff). The caller
+ * follows up with the "press enter to begin" prompt.
+ */
+export declare function renderColdStartSplash(version: string): string;
+/**
+ * Step header — used as the banner of each cold-start sub-screen
+ * (1.1 provider, 1.2 model, 1.3 key, 1.5 done). Renders the breadcrumb
+ * with the version on the right plus the "step N of M" mid-line.
+ */
+export declare function renderStepHeader(crumbs: string[], step: number, total: number, version: string): string;
+/**
+ * Body rows for the "ready" panel on screen 1.5. Exported so the wizard
+ * can hand them to Panel() and snapshot tests can verify the rows
+ * independently.
+ */
+export declare function renderDonePanelRows(summary: {
+    provider: string;
+    model: string;
+    keySource: string;
+    ides: string[];
+    dreamEnabled: boolean;
+}): string[];
+/**
+ * Screen 1.1 — provider sub-screen header. Renders the breadcrumb +
+ * step counter + Title + intro line. The caller follows up with the
+ * existing pickProvider() call to print the actual numbered menu.
+ */
+export declare function renderProviderStepHeader(version: string): string;
+/**
+ * Screen 1.2 — model sub-screen header. Includes the provider name in
+ * the breadcrumb so the user knows which catalog they're picking from.
+ */
+export declare function renderModelStepHeader(provider: string, version: string): string;
+/**
+ * Screen 1.3 — API key sub-screen header. Shows the provider name and
+ * a one-line subtitle reminding the user that we validate the key
+ * before saving.
+ */
+export declare function renderKeyStepHeader(provider: string, version: string): string;
+/**
+ * Render the key-source picker rows. Each row has a number, a label, a
+ * meta column, and an optional `◂ found` tag when the env var is
+ * actually set. Returns the array of lines so the caller can
+ * concatenate them around its own prompt.
+ */
+export interface KeySourceRow {
+    /** "environment variable" / "macos keychain" / "paste inline" / "skip for now". */
+    label: string;
+    /** Right-side meta (env var name, "(will store securely)", etc.). */
+    meta: string;
+    /** When true, append the `◂ found` tag in `ok` color. */
+    found?: boolean;
+}
+export declare function renderKeySourceRows(rows: KeySourceRow[]): string[];
+export declare function renderKeyStepFooter(): string;
+//# sourceMappingURL=coldStart.d.ts.map

package/dist/lib/setup/coldStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coldStart.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/coldStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiB7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;CACvB,GAAG,MAAM,EAAE,CAYX;AAQD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAWlE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/lib/setup/coldStart.js

@@ -0,0 +1,122 @@
+/**
+ * Cold-start (linear wizard) rendering helpers — v5.9.3 redesign.
+ *
+ * These pure render functions replace the bespoke banner/box drawing
+ * inside `runSetup()` with the new atom-based layout. They produce
+ * strings (no I/O) so they're snapshot-testable.
+ *
+ * Screens 1.1 (provider), 1.2 (model), 1.3 (key) get their headers
+ * here. The actual provider/model pickers stay in `setup.ts` —
+ * pickProvider / pickModel are called from multiple paths and were
+ * intentionally left untouched per the v5.9.3 brief; the cold-start
+ * sub-screen functions wrap the picker invocations with the header
+ * chrome.
+ */
+import { Header } from "./ui/header.js";
+import { Title } from "./ui/title.js";
+import { Footer } from "./ui/footer.js";
+import { c, color, glyph } from "./ui/tokens.js";
+/**
+ * Splash screen body (Screen 1.0 in the design handoff). The caller
+ * follows up with the "press enter to begin" prompt.
+ */
+export function renderColdStartSplash(version) {
+    const v = version.startsWith("v") ? version : `v${version}`;
+    const lines = [];
+    lines.push(Header(["gnosys", "setup"], { version: v }));
+    lines.push("");
+    lines.push(Title("Welcome."));
+    lines.push("");
+    lines.push(" gnosys gives your AI agents persistent memory — a centralized brain");
+    lines.push(" they keep across sessions. This wizard takes about 90 seconds.");
+    lines.push("");
+    lines.push("   step 1   pick a default LLM provider");
+    lines.push("   step 2   validate the API key");
+    lines.push("   step 3   wire up MCP for detected IDEs");
+    lines.push("   step 4   (optional) task routing & dream mode");
+    lines.push("");
+    lines.push(Footer("^C exits cleanly at any time"));
+    return lines.join("\n");
+}
+/**
+ * Step header — used as the banner of each cold-start sub-screen
+ * (1.1 provider, 1.2 model, 1.3 key, 1.5 done). Renders the breadcrumb
+ * with the version on the right plus the "step N of M" mid-line.
+ */
+export function renderStepHeader(crumbs, step, total, version) {
+    const v = version.startsWith("v") ? version : `v${version}`;
+    return Header([...crumbs], { version: `step ${step} of ${total}    ${v}` });
+}
+/**
+ * Body rows for the "ready" panel on screen 1.5. Exported so the wizard
+ * can hand them to Panel() and snapshot tests can verify the rows
+ * independently.
+ */
+export function renderDonePanelRows(summary) {
+    const idesStr = summary.ides.length === 0 ? "(none)" : summary.ides.join(", ");
+    const dreamStr = summary.dreamEnabled
+        ? "enabled"
+        : "disabled · enable later with `gnosys setup`";
+    return [
+        pad("provider", summary.provider),
+        pad("model", summary.model),
+        pad("api key", summary.keySource),
+        pad("ides", idesStr),
+        pad("dream mode", dreamStr),
+    ];
+}
+function pad(label, value) {
+    return `${label.padEnd(18)}${value}`;
+}
+// ─── Screens 1.1 / 1.2 / 1.3 — sub-screen headers ────────────────────────
+/**
+ * Screen 1.1 — provider sub-screen header. Renders the breadcrumb +
+ * step counter + Title + intro line. The caller follows up with the
+ * existing pickProvider() call to print the actual numbered menu.
+ */
+export function renderProviderStepHeader(version) {
+    const lines = [];
+    lines.push(renderStepHeader(["gnosys", "setup", "provider"], 1, 4, version));
+    lines.push("");
+    lines.push(Title("Choose your LLM provider", "prices are per-1M-tokens (input – output)"));
+    return lines.join("\n");
+}
+/**
+ * Screen 1.2 — model sub-screen header. Includes the provider name in
+ * the breadcrumb so the user knows which catalog they're picking from.
+ */
+export function renderModelStepHeader(provider, version) {
+    const lines = [];
+    lines.push(renderStepHeader(["gnosys", "setup", "provider", "model"], 2, 4, version));
+    lines.push("");
+    lines.push(Title(`Choose a model for ${provider}`));
+    return lines.join("\n");
+}
+/**
+ * Screen 1.3 — API key sub-screen header. Shows the provider name and
+ * a one-line subtitle reminding the user that we validate the key
+ * before saving.
+ */
+export function renderKeyStepHeader(provider, version) {
+    const lines = [];
+    lines.push(renderStepHeader(["gnosys", "setup", "key"], 3, 4, version));
+    lines.push("");
+    lines.push(Title(`API key for ${provider}`, "we'll validate it before saving anything"));
+    return lines.join("\n");
+}
+export function renderKeySourceRows(rows) {
+    const labelW = Math.max(...rows.map((r) => r.label.length)) + 2;
+    const out = [];
+    rows.forEach((r, i) => {
+        const num = color(c.textDim, String(i + 1).padStart(2, " "));
+        const label = color(c.text, r.label.padEnd(labelW));
+        const meta = color(c.textDim, r.meta);
+        const tag = r.found ? `   ${color(c.ok, `${glyph.tag} found`)}` : "";
+        out.push(`    ${num}   ${label}${meta}${tag}`);
+    });
+    return out;
+}
+export function renderKeyStepFooter() {
+    return Footer("1–4 · pick    b · back");
+}
+//# sourceMappingURL=coldStart.js.map

package/dist/lib/setup/coldStart.js.map

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

package/dist/lib/setup/configSetRender.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Known top-level keys accepted by `gnosys config set`. Mirrors the switch
+ * cases in cli.ts; keep these in sync when a new branch is added.
+ */
+export declare const KNOWN_CONFIG_KEYS: readonly string[];
+/**
+ * Validate a user-supplied config key. Returns the closest known key
+ * (by edit distance) when the input doesn't match exactly. The caller
+ * uses the suggestion to render a `did you mean X?` hint.
+ */
+export declare function suggestConfigKey(input: string): string | null;
+/**
+ * Classify a store path as `project` or `global`. Used to label both the
+ * Diff row and the "saved" status line so the user always knows which
+ * store was touched.
+ *
+ * The convention: store paths under `~/.gnosys` (the central user store)
+ * count as global; everything else is project-scoped.
+ */
+export declare function classifyStore(storePath: string, homeDir: string): "project" | "global";
+/**
+ * Compute the Levenshtein edit distance between two strings. Small inputs
+ * only — config keys are at most ~20 chars.
+ */
+export declare function levenshtein(a: string, b: string): number;
+//# sourceMappingURL=configSetRender.d.ts.map

package/dist/lib/setup/configSetRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSetRender.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/configSetRender.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAkB9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAMtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBxD"}

package/dist/lib/setup/configSetRender.js

@@ -0,0 +1,103 @@
+/**
+ * Render helpers for `gnosys config set` (Screen 13).
+ *
+ * Provides:
+ *   - Schema/key validation against a known set of config keys
+ *   - Levenshtein-based "did you mean?" suggestion on typo
+ *   - Helpers to label the active store as `(project)` or `(global)`
+ *
+ * Output rendering is deferred to the cli.ts action so we don't drag the
+ * full config schema into this module — but the validator and the
+ * suggestion logic are pure and snapshot-testable.
+ */
+import path from "path";
+/**
+ * Known top-level keys accepted by `gnosys config set`. Mirrors the switch
+ * cases in cli.ts; keep these in sync when a new branch is added.
+ */
+export const KNOWN_CONFIG_KEYS = [
+    "provider",
+    "model",
+    "task",
+    "ollama-url",
+    "ollama-model",
+    "anthropic-model",
+    "groq-model",
+    "openai-model",
+    "openai-url",
+    "lmstudio-url",
+    "lmstudio-model",
+    "xai-model",
+    "mistral-model",
+    "custom-url",
+    "custom-model",
+    "custom-key",
+    "recall",
+];
+/**
+ * Validate a user-supplied config key. Returns the closest known key
+ * (by edit distance) when the input doesn't match exactly. The caller
+ * uses the suggestion to render a `did you mean X?` hint.
+ */
+export function suggestConfigKey(input) {
+    if (KNOWN_CONFIG_KEYS.includes(input))
+        return null;
+    let best = null;
+    let bestDist = Infinity;
+    for (const candidate of KNOWN_CONFIG_KEYS) {
+        const d = levenshtein(input, candidate);
+        if (d < bestDist) {
+            bestDist = d;
+            best = candidate;
+        }
+    }
+    // Only suggest when the edit distance is small enough to be plausibly
+    // a typo. Anything > 3 is a wild miss — don't suggest.
+    return bestDist <= 3 ? best : null;
+}
+/**
+ * Classify a store path as `project` or `global`. Used to label both the
+ * Diff row and the "saved" status line so the user always knows which
+ * store was touched.
+ *
+ * The convention: store paths under `~/.gnosys` (the central user store)
+ * count as global; everything else is project-scoped.
+ */
+export function classifyStore(storePath, homeDir) {
+    const globalPath = path.join(homeDir, ".gnosys");
+    // Normalize both sides for the comparison so symlinks / trailing slashes
+    // don't trip a false negative.
+    const norm = path.resolve(storePath);
+    return norm === path.resolve(globalPath) ? "global" : "project";
+}
+/**
+ * Compute the Levenshtein edit distance between two strings. Small inputs
+ * only — config keys are at most ~20 chars.
+ */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const m = a.length;
+    const n = b.length;
+    const prev = new Array(n + 1);
+    const curr = new Array(n + 1);
+    for (let j = 0; j <= n; j++)
+        prev[j] = j;
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, // insertion
+            prev[j] + 1, // deletion
+            prev[j - 1] + cost);
+        }
+        for (let j = 0; j <= n; j++)
+            prev[j] = curr[j];
+    }
+    return prev[n];
+}
+//# sourceMappingURL=configSetRender.js.map

package/dist/lib/setup/configSetRender.js.map

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

package/dist/lib/setup/dreamRender.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Render helpers for `gnosys setup dream` (Screen 7).
+ *
+ * The wizard runs inside `runDreamSetup` (in `setup.ts`); this module
+ * owns only the pure helpers that are easy to snapshot-test:
+ *
+ *   - buildDreamDiffRows: the 4-row before/after summary printed at the
+ *     end of the three-step flow
+ *   - renderThresholdsBlock: the static "thresholds + sub-tasks" panel
+ *     rendered on screen 7.2 with default values inside fake `[N ]`
+ *     fields
+ */
+export interface DreamDiffRow {
+    label: string;
+    from: string;
+    to: string;
+}
+export interface DreamSettings {
+    provider: string;
+    model?: string;
+    machine: string;
+    idleMinutes: number;
+    maxRuntimeMinutes: number;
+    selfCritique: boolean;
+    generateSummaries: boolean;
+    discoverRelationships: boolean;
+}
+/**
+ * Build the four canonical rows for the post-save Diff block. Always
+ * emits the same four labels so users have a consistent footprint
+ * across machines.
+ */
+export declare function buildDreamDiffRows(prev: Partial<DreamSettings> | null, next: DreamSettings): DreamDiffRow[];
+/**
+ * Render the static thresholds/sub-tasks block from screen 7.2. Returns
+ * an array of lines (no trailing newline). The wizard prints these
+ * before asking for `enter | e`.
+ */
+export declare function renderThresholdsBlock(idleMinutes: number, maxRuntimeMinutes: number, minMemories: number, subs: {
+    selfCritique: boolean;
+    generateSummaries: boolean;
+    discoverRelationships: boolean;
+}): string[];
+//# sourceMappingURL=dreamRender.d.ts.map

package/dist/lib/setup/dreamRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamRender.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/dreamRender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,CAiB3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAA;CAAE,GAC1F,MAAM,EAAE,CAaV"}

package/dist/lib/setup/dreamRender.js

@@ -0,0 +1,55 @@
+/**
+ * Render helpers for `gnosys setup dream` (Screen 7).
+ *
+ * The wizard runs inside `runDreamSetup` (in `setup.ts`); this module
+ * owns only the pure helpers that are easy to snapshot-test:
+ *
+ *   - buildDreamDiffRows: the 4-row before/after summary printed at the
+ *     end of the three-step flow
+ *   - renderThresholdsBlock: the static "thresholds + sub-tasks" panel
+ *     rendered on screen 7.2 with default values inside fake `[N ]`
+ *     fields
+ */
+/**
+ * Build the four canonical rows for the post-save Diff block. Always
+ * emits the same four labels so users have a consistent footprint
+ * across machines.
+ */
+export function buildDreamDiffRows(prev, next) {
+    const prevProvider = prev?.provider ? `${prev.provider}${prev.model ? " / " + prev.model : ""}` : "—";
+    const nextProvider = `${next.provider}${next.model ? " / " + next.model : ""}`;
+    return [
+        { label: "provider", from: prevProvider, to: nextProvider },
+        { label: "machine", from: prev?.machine ?? "—", to: next.machine },
+        {
+            label: "idle threshold",
+            from: prev?.idleMinutes !== undefined ? `${prev.idleMinutes} min` : "—",
+            to: `${next.idleMinutes} min`,
+        },
+        {
+            label: "max runtime",
+            from: prev?.maxRuntimeMinutes !== undefined ? `${prev.maxRuntimeMinutes} min` : "—",
+            to: `${next.maxRuntimeMinutes} min`,
+        },
+    ];
+}
+/**
+ * Render the static thresholds/sub-tasks block from screen 7.2. Returns
+ * an array of lines (no trailing newline). The wizard prints these
+ * before asking for `enter | e`.
+ */
+export function renderThresholdsBlock(idleMinutes, maxRuntimeMinutes, minMemories, subs) {
+    const fmt = (n) => String(n).padEnd(3);
+    return [
+        `   when to run`,
+        `     idle threshold    [${fmt(idleMinutes)}] minutes      wait this long before starting`,
+        `     max runtime       [${fmt(maxRuntimeMinutes)}] minutes      cap each cycle to avoid runaway`,
+        `     min memories      [${fmt(minMemories)}]              only run if there's enough new material`,
+        "",
+        `   what to do`,
+        `     ${subs.selfCritique ? "✓" : "○"}  self-critique         review and re-rank existing memories`,
+        `     ${subs.generateSummaries ? "✓" : "○"}  generate summaries    produce a "what changed today" digest`,
+        `     ${subs.discoverRelationships ? "✓" : "○"}  discover relationships  link related memories explicitly`,
+    ];
+}
+//# sourceMappingURL=dreamRender.js.map

package/dist/lib/setup/dreamRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamRender.js","sourceRoot":"","sources":["../../../src/lib/setup/dreamRender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmC,EAAE,IAAmB;IACzF,MAAM,YAAY,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACtG,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/E,OAAO;QACL,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE;QAC3D,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE;QAClE;YACE,KAAK,EAAE,gBAAgB;YACvB,IAAI,EAAE,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,GAAG;YACvE,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,MAAM;SAC9B;QACD;YACE,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,IAAI,EAAE,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,MAAM,CAAC,CAAC,CAAC,GAAG;YACnF,EAAE,EAAE,GAAG,IAAI,CAAC,iBAAiB,MAAM;SACpC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,iBAAyB,EACzB,WAAmB,EACnB,IAA2F;IAE3F,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,gBAAgB;QAChB,2BAA2B,GAAG,CAAC,WAAW,CAAC,+CAA+C;QAC1F,2BAA2B,GAAG,CAAC,iBAAiB,CAAC,gDAAgD;QACjG,2BAA2B,GAAG,CAAC,WAAW,CAAC,wDAAwD;QACnG,EAAE;QACF,eAAe;QACf,QAAQ,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,8DAA8D;QACnG,QAAQ,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,+DAA+D;QACzG,QAAQ,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,4DAA4D;KAC3G,CAAC;AACJ,CAAC"}

package/dist/lib/setup/modelsRender.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Render helpers for `gnosys setup models` (Screen 3).
+ *
+ * Currently only owns the small pre-save diff-row builder. The rest of
+ * the screen's chrome (Header, Title, Spinner, Diff, Status) lives in
+ * `runModelsSetup` and is composed inline so we don't drag the entire
+ * provider/model picker through a render layer it doesn't need.
+ */
+export interface ModelDiffRow {
+    label: string;
+    from: string;
+    to: string;
+}
+/**
+ * Build the Diff rows for the pre-save block. Always returns at least
+ * two rows (`provider` + `model`) so the user can see what landed in
+ * gnosys.json, even when nothing actually changed.
+ *
+ * - If the new provider differs from the current one, emit the row.
+ * - If the new model differs from the current one, emit the row.
+ * - When neither changed, emit two rows showing the (unchanged) values
+ *   so the diff block isn't empty.
+ */
+export declare function buildModelsDiffRows(currentProvider: string | undefined, currentModel: string | undefined, newProvider: string, newModel: string): ModelDiffRow[];
+//# sourceMappingURL=modelsRender.d.ts.map

package/dist/lib/setup/modelsRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelsRender.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/modelsRender.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,YAAY,EAAE,CAahB"}

package/dist/lib/setup/modelsRender.js

@@ -0,0 +1,33 @@
+/**
+ * Render helpers for `gnosys setup models` (Screen 3).
+ *
+ * Currently only owns the small pre-save diff-row builder. The rest of
+ * the screen's chrome (Header, Title, Spinner, Diff, Status) lives in
+ * `runModelsSetup` and is composed inline so we don't drag the entire
+ * provider/model picker through a render layer it doesn't need.
+ */
+/**
+ * Build the Diff rows for the pre-save block. Always returns at least
+ * two rows (`provider` + `model`) so the user can see what landed in
+ * gnosys.json, even when nothing actually changed.
+ *
+ * - If the new provider differs from the current one, emit the row.
+ * - If the new model differs from the current one, emit the row.
+ * - When neither changed, emit two rows showing the (unchanged) values
+ *   so the diff block isn't empty.
+ */
+export function buildModelsDiffRows(currentProvider, currentModel, newProvider, newModel) {
+    const rows = [];
+    if (currentProvider && currentProvider !== newProvider) {
+        rows.push({ label: "provider", from: currentProvider, to: newProvider });
+    }
+    if (currentModel && currentModel !== newModel) {
+        rows.push({ label: "model", from: currentModel, to: newModel });
+    }
+    if (rows.length === 0) {
+        rows.push({ label: "provider", from: currentProvider ?? "(unset)", to: newProvider });
+        rows.push({ label: "model", from: currentModel ?? "(unset)", to: newModel });
+    }
+    return rows;
+}
+//# sourceMappingURL=modelsRender.js.map

package/dist/lib/setup/modelsRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelsRender.js","sourceRoot":"","sources":["../../../src/lib/setup/modelsRender.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,eAAmC,EACnC,YAAgC,EAChC,WAAmB,EACnB,QAAgB;IAEhB,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,IAAI,eAAe,IAAI,eAAe,KAAK,WAAW,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,YAAY,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,IAAI,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,IAAI,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/setup/remoteRender.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Sync mode picked in the hierarchical mode menu. Persisted to the
+ * `remote_mode` meta key so other tooling can read it back.
+ */
+export type SyncMode = "read-write" | "pull-only" | "push-only";
+/** Description for each mode — shown as the meta column in the picker. */
+export declare const SYNC_MODE_LABELS: Record<SyncMode, string>;
+/**
+ * Render the validation summary as a bullet list of `✓`/`✗` rows.
+ *
+ * Replaces `showValidationSummary` in the wizard. Each check is one
+ * Status() line — easier to scan than the old col-aligned text dump.
+ */
+export interface ValidationSummaryInput {
+    pathExists: boolean;
+    writable: boolean;
+    sqliteCompatible: boolean;
+    latencyMs: number | null;
+    existing?: {
+        found: boolean;
+        memoryCount: number | null;
+        lastModified: string | null;
+    };
+    warnings: string[];
+    errors: string[];
+}
+export declare function renderValidationSummary(v: ValidationSummaryInput): string;
+/**
+ * Render the leading Header + current-status line for the remote wizard.
+ * Returns a multi-line string the wizard can print as-is.
+ */
+export declare function renderRemoteIntro(localActive: number, localArchived: number, currentRemote: string | null): string;
+/**
+ * Render the final Diff block summarizing what changed at the end of
+ * the wizard run.
+ */
+export interface RemoteDiffInput {
+    previousRemote: string | null;
+    newRemote: string;
+    mode: SyncMode;
+}
+export declare function renderRemoteDiff(d: RemoteDiffInput): string;
+//# sourceMappingURL=remoteRender.d.ts.map

package/dist/lib/setup/remoteRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteRender.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/remoteRender.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhE,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAIrD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAgBzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAWR;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAW3D"}

package/dist/lib/setup/remoteRender.js

@@ -0,0 +1,65 @@
+/**
+ * Render helpers for `gnosys setup remote` (Screen 6).
+ *
+ * The wizard's flow is in `lib/remoteWizard.ts`; this module owns only
+ * the pure render functions and the sync-mode picker payload so the
+ * layout can be snapshot-tested without spinning up an interactive
+ * readline.
+ */
+import { c, color, glyph } from "./ui/tokens.js";
+import { Header } from "./ui/header.js";
+import { Status } from "./ui/status.js";
+/** Description for each mode — shown as the meta column in the picker. */
+export const SYNC_MODE_LABELS = {
+    "read-write": "this machine reads and writes",
+    "pull-only": "read remote, never write",
+    "push-only": "write to remote, never read locally",
+};
+export function renderValidationSummary(v) {
+    const lines = [];
+    lines.push(Status(v.pathExists ? "ok" : "fail", "path exists"));
+    lines.push(Status(v.writable ? "ok" : "fail", "writable"));
+    lines.push(Status(v.sqliteCompatible ? "ok" : "fail", "sqlite compatible"));
+    if (v.latencyMs !== null) {
+        lines.push(Status("ok", "latency", `${v.latencyMs} ms`));
+    }
+    if (v.existing?.found) {
+        const date = v.existing.lastModified ? v.existing.lastModified.split("T")[0] : "unknown";
+        const count = v.existing.memoryCount ?? "?";
+        lines.push(Status("ok", "found existing remote", `${count} memories · last write ${date}`));
+    }
+    for (const w of v.warnings)
+        lines.push(Status("warn", w));
+    for (const e of v.errors)
+        lines.push(Status("fail", e));
+    return lines.join("\n");
+}
+/**
+ * Render the leading Header + current-status line for the remote wizard.
+ * Returns a multi-line string the wizard can print as-is.
+ */
+export function renderRemoteIntro(localActive, localArchived, currentRemote) {
+    const lines = [];
+    lines.push(Header(["gnosys", "setup", "remote"]));
+    lines.push("");
+    lines.push(` ${color(c.text, "Multi-machine sync")}`);
+    lines.push(` ${color(c.textDim, "share your memory store across machines via a path on a NAS, iCloud, Dropbox, etc.")}`);
+    lines.push("");
+    const remoteTxt = currentRemote ?? "not configured";
+    lines.push(`   ${color(c.textDim, "local DB")}    ${color(c.text, `~/.gnosys/gnosys.db (${localActive} active, ${localArchived} archived)`)}`);
+    lines.push(`   ${color(c.textDim, "current")}     ${color(c.text, remoteTxt)}`);
+    return lines.join("\n");
+}
+export function renderRemoteDiff(d) {
+    const lines = [];
+    const indent = "   ";
+    const arrow = color(c.textGhost, glyph.arrow);
+    const fromR = color(c.textMid, (d.previousRemote ?? "not configured").padEnd(20));
+    const labelR = color(c.textDim, "remote".padEnd(8));
+    lines.push(`${indent}${labelR}   ${fromR}   ${arrow}   ${color(c.accentHi, d.newRemote)}`);
+    const labelM = color(c.textDim, "mode".padEnd(8));
+    const fromM = color(c.textMid, "—".padEnd(20));
+    lines.push(`${indent}${labelM}   ${fromM}   ${arrow}   ${color(c.accentHi, d.mode)}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=remoteRender.js.map

package/dist/lib/setup/remoteRender.js.map

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