gnosys 5.9.2 → 5.9.3

package/dist/lib/setup/syncProjectsRender.js

@@ -0,0 +1,168 @@
+/**
+ * Render helpers for `gnosys setup sync-projects` output (Screen 10).
+ *
+ * These pure render functions turn the sync result data into the new
+ * hierarchical layout from the v5.9.3 design handoff §4 Screen 10:
+ *
+ *   - Header at the top with breadcrumb + version
+ *   - Inline summary spinner line
+ *   - Hierarchical sections: upgraded, skipped, machines
+ *   - Light dividers between sections
+ *   - Paths collapsed to `~/…` when long
+ *   - ⚠ + `← older` tag on out-of-date machines
+ *
+ * Pure string output, no I/O — snapshot-testable.
+ */
+import os from "os";
+import path from "path";
+import { c, color, glyph, width } from "./ui/tokens.js";
+import { Header } from "./ui/header.js";
+import { Status } from "./ui/status.js";
+const MAX_PATH_DISPLAY = 50;
+const MAX_VISIBLE_ROWS = 5;
+/**
+ * Render the leading Header for the sync-projects screen.
+ * Caller follows with a blank line.
+ */
+export function renderSyncHeader(version) {
+    const v = version.startsWith("v") ? version : `v${version}`;
+    return Header(["gnosys", "upgrading registered projects"], { version: v });
+}
+/**
+ * Collapse a long path with a leading `~/…` so it fits on screen.
+ * Returns the original path unchanged when already short enough.
+ */
+export function collapsePath(p, homeDir = os.homedir()) {
+    // Always prefer ~/ shorthand when path is under home.
+    let display = p;
+    if (homeDir && p.startsWith(homeDir + path.sep)) {
+        display = "~" + p.slice(homeDir.length);
+    }
+    else if (homeDir && p === homeDir) {
+        display = "~";
+    }
+    if (display.length <= MAX_PATH_DISPLAY)
+        return display;
+    // Path is still too long: keep the head + ellipsis.
+    const head = display.slice(0, MAX_PATH_DISPLAY - 2);
+    return `${head}/…`;
+}
+/**
+ * Render the "upgraded N projects" section. Returns an array of lines
+ * (with no trailing newline). Returns [] when there are no rows.
+ */
+export function renderUpgradedSection(rows) {
+    if (rows.length === 0)
+        return [];
+    const lines = [];
+    lines.push(` ${color(c.text, `upgraded   ${rows.length} projects`)}`);
+    const visible = rows.slice(0, MAX_VISIBLE_ROWS);
+    for (const r of visible) {
+        lines.push(formatProjectRow("ok", r));
+    }
+    const remaining = rows.length - visible.length;
+    if (remaining > 0) {
+        lines.push(`   ${color(c.textDim, `(${remaining} more)`)}`);
+    }
+    return lines;
+}
+/**
+ * Render the "skipped N projects" section. Same shape as upgraded but
+ * uses the hollow dot glyph. Returns [] when empty.
+ */
+export function renderSkippedSection(rows) {
+    if (rows.length === 0)
+        return [];
+    const lines = [];
+    lines.push(` ${color(c.text, `skipped    ${rows.length} projects`)} ${color(c.textDim, "· no .gnosys directory")}`);
+    const visible = rows.slice(0, MAX_VISIBLE_ROWS);
+    for (const r of visible) {
+        lines.push(formatProjectRow("skip", r));
+    }
+    const remaining = rows.length - visible.length;
+    if (remaining > 0) {
+        lines.push(`   ${color(c.textDim, `(${remaining} more)`)}`);
+    }
+    return lines;
+}
+/**
+ * Render the "failed N projects" section. Renders all rows (no "more"
+ * collapse) since failures matter.
+ */
+export function renderFailedSection(rows) {
+    if (rows.length === 0)
+        return [];
+    const lines = [];
+    lines.push(` ${color(c.text, `failed     ${rows.length} projects`)}`);
+    for (const r of rows) {
+        lines.push(formatProjectRow("fail", r));
+    }
+    return lines;
+}
+/**
+ * Render the connected-machines callout. Returns [] when there's only
+ * one machine (no callout needed).
+ */
+export function renderMachinesSection(rows, currentVersion) {
+    if (rows.length <= 1)
+        return [];
+    const lines = [];
+    lines.push(` ${color(c.text, "connected machines")}`);
+    lines.push("");
+    const nameW = Math.max(...rows.map((r) => r.hostname.length));
+    for (const r of rows) {
+        const isOlder = r.version !== currentVersion;
+        const dot = isOlder ? color(c.warn, glyph.warn) : color(c.ok, glyph.ok);
+        const name = color(c.text, r.hostname.padEnd(nameW));
+        const versionDisplay = r.isCurrent && !isOlder ? "" : `v${r.version}`;
+        const versionCol = color(c.textDim, versionDisplay.padEnd(10));
+        const lastSeenDate = r.lastSeen.split("T")[0];
+        const lastSeen = r.isCurrent
+            ? color(c.textDim, "this machine")
+            : color(c.textDim, `last seen ${lastSeenDate}`);
+        const tag = isOlder ? `   ${color(c.warn, "← older")}` : "";
+        lines.push(`   ${dot}  ${name}   ${versionCol}   ${lastSeen}${tag}`);
+    }
+    return lines;
+}
+/** Render a horizontal divider (1-col indent, thin rule). */
+export function renderDivider() {
+    const W = width();
+    return ` ${color(c.textGhost, glyph.ruleLight.repeat(Math.max(1, W - 1)))}`;
+}
+/**
+ * Final "done · central DB stamped vX.Y.Z" status line.
+ */
+export function renderDoneLine(version) {
+    const v = version.startsWith("v") ? version : `v${version}`;
+    return Status("ok", "done", `central DB stamped ${v}`);
+}
+/**
+ * Build the dashboard summary lines (printed after the divider when
+ * regeneration succeeded).
+ */
+export function renderDashboardSummary(htmlPath, mdPath) {
+    const lines = [];
+    lines.push(` ${color(c.text, "portfolio dashboard regenerated")}`);
+    lines.push(`   ${color(c.textDim, "html  ")}  ${color(c.textDim, collapsePath(htmlPath))}`);
+    lines.push(`   ${color(c.textDim, "md    ")}  ${color(c.textDim, collapsePath(mdPath))}`);
+    return lines;
+}
+function formatProjectRow(kind, r) {
+    let dot;
+    switch (kind) {
+        case "ok":
+            dot = color(c.ok, glyph.ok);
+            break;
+        case "skip":
+            dot = color(c.textDim, glyph.dotHollow);
+            break;
+        case "fail":
+            dot = color(c.fail, glyph.fail);
+            break;
+    }
+    const title = color(c.text, r.title.padEnd(28));
+    const fullPath = collapsePath(r.fullPath);
+    return `   ${dot}  ${title}  ${color(c.textDim, fullPath)}`;
+}
+//# sourceMappingURL=syncProjectsRender.js.map

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

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

package/dist/lib/setup/ui/diff.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Diff atom — `label    from  →  to` table shown after any mutation.
+ *
+ * Replaces the silent "Configuration saved" messages with a visible
+ * before/after summary. `to` is rendered in `accent-hi` to draw the eye.
+ */
+export interface DiffRow {
+    label: string;
+    from: string;
+    to: string;
+}
+/**
+ * Render a diff block. Columns are auto-sized by widest entry in each
+ * column. Caller follows with the success line / next status.
+ */
+export declare function Diff(rows: DiffRow[]): string;
+/** Convenience: print diff + trailing blank line. */
+export declare function printDiff(rows: DiffRow[]): void;
+//# sourceMappingURL=diff.d.ts.map

package/dist/lib/setup/ui/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAc5C;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAG/C"}

package/dist/lib/setup/ui/diff.js

@@ -0,0 +1,34 @@
+/**
+ * Diff atom — `label    from  →  to` table shown after any mutation.
+ *
+ * Replaces the silent "Configuration saved" messages with a visible
+ * before/after summary. `to` is rendered in `accent-hi` to draw the eye.
+ */
+import { c, color, glyph } from "./tokens.js";
+/**
+ * Render a diff block. Columns are auto-sized by widest entry in each
+ * column. Caller follows with the success line / next status.
+ */
+export function Diff(rows) {
+    if (rows.length === 0)
+        return "";
+    const labelW = Math.max(...rows.map((r) => r.label.length));
+    const fromW = Math.max(...rows.map((r) => r.from.length));
+    const indent = "   ";
+    const arrow = color(c.textGhost, glyph.arrow);
+    const lines = [];
+    for (const r of rows) {
+        const label = color(c.textDim, r.label.padEnd(labelW));
+        const from = color(c.textMid, r.from.padEnd(fromW));
+        const to = color(c.accentHi, r.to);
+        lines.push(`${indent}${label}   ${from}   ${arrow}   ${to}`);
+    }
+    return lines.join("\n");
+}
+/** Convenience: print diff + trailing blank line. */
+export function printDiff(rows) {
+    if (rows.length === 0)
+        return;
+    process.stdout.write(`${Diff(rows)}\n\n`);
+}
+//# sourceMappingURL=diff.js.map

package/dist/lib/setup/ui/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQ9C;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,IAAe;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC;IACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/setup/ui/footer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Footer atom — single right-aligned dim hint at the bottom of long lists,
+ * shown immediately before the Prompt.
+ */
+/**
+ * Render a right-aligned `text-dim` hint line.
+ */
+export declare function Footer(hint: string): string;
+/** Convenience: print footer + newline. */
+export declare function printFooter(hint: string): void;
+//# sourceMappingURL=footer.d.ts.map

package/dist/lib/setup/ui/footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/footer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/dist/lib/setup/ui/footer.js

@@ -0,0 +1,21 @@
+/**
+ * Footer atom — single right-aligned dim hint at the bottom of long lists,
+ * shown immediately before the Prompt.
+ */
+import { c, color, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a right-aligned `text-dim` hint line.
+ */
+export function Footer(hint) {
+    const W = width();
+    const txt = color(c.textDim, hint);
+    const bare = stripAnsi(txt);
+    const pad = " ".repeat(Math.max(1, W - 1 - bare.length));
+    return `${pad}${txt}`;
+}
+/** Convenience: print footer + newline. */
+export function printFooter(hint) {
+    process.stdout.write(`${Footer(hint)}\n`);
+}
+//# sourceMappingURL=footer.js.map

package/dist/lib/setup/ui/footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/footer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,OAAO,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/setup/ui/header.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Header atom — breadcrumb + thin rule on every redesigned screen.
+ *
+ * Renders two lines: breadcrumb `⬢ gnosys ▸ setup ▸ models` (left) with a
+ * right-aligned version label, followed by a full-width `─` rule. Caller
+ * is responsible for following with one blank line via the normal flow.
+ */
+export interface HeaderOptions {
+    /** Version label, right-aligned. Pass `undefined` to omit. */
+    version?: string;
+}
+/**
+ * Render a header for the given breadcrumb segments. Returns the full
+ * 2-line string (no trailing newline).
+ *
+ * @param crumbs  Path segments. First should always be `gnosys`.
+ * @param opts    Optional version label.
+ */
+export declare function Header(crumbs: string[], opts?: HeaderOptions): string;
+/** Strip ANSI escapes so we can measure printable width. Exported for callers/tests that need printable measurement. */
+export declare function stripAnsi(s: string): string;
+/** Convenience: print header + trailing blank line to stdout. */
+export declare function printHeader(crumbs: string[], opts?: HeaderOptions): void;
+//# sourceMappingURL=header.d.ts.map

package/dist/lib/setup/ui/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/header.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CA0BzE;AAED,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,IAAI,CAE5E"}

package/dist/lib/setup/ui/header.js

@@ -0,0 +1,49 @@
+/**
+ * Header atom — breadcrumb + thin rule on every redesigned screen.
+ *
+ * Renders two lines: breadcrumb `⬢ gnosys ▸ setup ▸ models` (left) with a
+ * right-aligned version label, followed by a full-width `─` rule. Caller
+ * is responsible for following with one blank line via the normal flow.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+/**
+ * Render a header for the given breadcrumb segments. Returns the full
+ * 2-line string (no trailing newline).
+ *
+ * @param crumbs  Path segments. First should always be `gnosys`.
+ * @param opts    Optional version label.
+ */
+export function Header(crumbs, opts = {}) {
+    const W = width();
+    const brand = color(c.accent, glyph.brand);
+    const head = `${brand} ${color(c.textHi, crumbs[0] ?? "gnosys")}`;
+    const tail = crumbs
+        .slice(1)
+        .map((s) => `${color(c.textDim, glyph.sep)} ${color(c.textDim, s)}`)
+        .join(" ");
+    const left = tail ? `${head} ${tail}` : head;
+    // Pad the right-aligned version. We measure printable width without ANSI.
+    const versionTxt = opts.version ? color(c.textDim, opts.version) : "";
+    const leftBare = stripAnsi(left);
+    const versionBare = opts.version ?? "";
+    // 1-col indent on the left ("content at col 2"), plus one space before the
+    // version, plus the version. Pad with spaces to push version to col W-1.
+    const indent = " ";
+    const usable = W - indent.length - leftBare.length - versionBare.length;
+    const pad = " ".repeat(Math.max(1, usable));
+    const line1 = `${indent}${left}${pad}${versionTxt}`;
+    // Rule line — full width with single space indent for alignment.
+    const ruleLen = Math.max(1, W - indent.length);
+    const line2 = `${indent}${color(c.textGhost, glyph.ruleLight.repeat(ruleLen))}`;
+    return `${line1}\n${line2}`;
+}
+/** Strip ANSI escapes so we can measure printable width. Exported for callers/tests that need printable measurement. */
+export function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/** Convenience: print header + trailing blank line to stdout. */
+export function printHeader(crumbs, opts = {}) {
+    process.stdout.write(`${Header(crumbs, opts)}\n\n`);
+}
+//# sourceMappingURL=header.js.map

package/dist/lib/setup/ui/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/header.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOrD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,MAAgB,EAAE,OAAsB,EAAE;IAC/D,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,MAAM;SAChB,KAAK,CAAC,CAAC,CAAC;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7C,0EAA0E;IAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,MAAM,GAAG,GAAG,CAAC;IACnB,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IACxE,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,GAAG,UAAU,EAAE,CAAC;IAEpD,iEAAiE;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;IAEhF,OAAO,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,4CAA4C;IAC5C,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,MAAgB,EAAE,OAAsB,EAAE;IACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/lib/setup/ui/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Public re-exports for the gnosys CLI UI atoms (v5.9.3 redesign).
+ *
+ * Always import from this module — never reach into individual files from
+ * outside `setup/ui/`. That keeps the atom boundaries clean and lets us
+ * rework internals (e.g. swap truecolor detection) without ripple.
+ */
+export { c, color, glyph, COLS, width, TRUECOLOR, RESET } from "./tokens.js";
+export type { ColorTokens } from "./tokens.js";
+export { Header, printHeader, stripAnsi } from "./header.js";
+export type { HeaderOptions } from "./header.js";
+export { Title, printTitle } from "./title.js";
+export { Menu, printMenu } from "./menu.js";
+export type { MenuItem } from "./menu.js";
+export { Prompt } from "./prompt.js";
+export type { PromptOptions } from "./prompt.js";
+export { Status, printStatus } from "./status.js";
+export type { StatusKind } from "./status.js";
+export { Diff, printDiff } from "./diff.js";
+export type { DiffRow } from "./diff.js";
+export { Panel, printPanel } from "./panel.js";
+export type { PanelOptions } from "./panel.js";
+export { Spinner } from "./spinner.js";
+export type { SpinnerHandle } from "./spinner.js";
+export { Footer, printFooter } from "./footer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/setup/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/setup/ui/index.js

@@ -0,0 +1,18 @@
+/**
+ * Public re-exports for the gnosys CLI UI atoms (v5.9.3 redesign).
+ *
+ * Always import from this module — never reach into individual files from
+ * outside `setup/ui/`. That keeps the atom boundaries clean and lets us
+ * rework internals (e.g. swap truecolor detection) without ripple.
+ */
+export { c, color, glyph, COLS, width, TRUECOLOR, RESET } from "./tokens.js";
+export { Header, printHeader, stripAnsi } from "./header.js";
+export { Title, printTitle } from "./title.js";
+export { Menu, printMenu } from "./menu.js";
+export { Prompt } from "./prompt.js";
+export { Status, printStatus } from "./status.js";
+export { Diff, printDiff } from "./diff.js";
+export { Panel, printPanel } from "./panel.js";
+export { Spinner } from "./spinner.js";
+export { Footer, printFooter } from "./footer.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/setup/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/setup/ui/menu.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Menu atom — the single numbered-menu format the redesign uses.
+ *
+ * 3-col number gutter, lowercase labels by convention, right-aligned
+ * meta column, optional `◂ tag` (recommended | current | detected) to
+ * the right of meta.
+ */
+export interface MenuItem {
+    /** The shortcut digit/letter (`1`, `2`, `b`, `q`, …). */
+    n: string;
+    /** Primary label text. */
+    label: string;
+    /** Optional right-side metadata (price, status, etc.). */
+    meta?: string;
+    /** Optional `◂ recommended` / `◂ current` / `◂ detected` style tag. */
+    tag?: string;
+    /** Render the whole row in `text-dim` (used for skip / back). */
+    dim?: boolean;
+}
+/**
+ * Render a numbered menu as a single string (no trailing newline).
+ * Caller follows with one blank line then a Prompt/Footer.
+ */
+export declare function Menu(items: MenuItem[]): string;
+/** Convenience: print menu + trailing blank line. */
+export declare function printMenu(items: MenuItem[]): void;
+//# sourceMappingURL=menu.d.ts.map

package/dist/lib/setup/ui/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/menu.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CA0D9C;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAEjD"}

package/dist/lib/setup/ui/menu.js

@@ -0,0 +1,75 @@
+/**
+ * Menu atom — the single numbered-menu format the redesign uses.
+ *
+ * 3-col number gutter, lowercase labels by convention, right-aligned
+ * meta column, optional `◂ tag` (recommended | current | detected) to
+ * the right of meta.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a numbered menu as a single string (no trailing newline).
+ * Caller follows with one blank line then a Prompt/Footer.
+ */
+export function Menu(items) {
+    const W = width();
+    // Column layout:
+    //   col 1: " " indent (content lives at col 2 per the spec)
+    //   col 2-4: 3-char gutter for number, right-aligned
+    //   col 5: " "
+    //   col 6+: label
+    //   meta is right-aligned within W-2
+    //   tag (◂ ...) follows meta, right-aligned at the very right
+    const indent = "    "; // menu items at col 4 — 4-space indent (1 base + 3)
+    const lines = [];
+    for (const it of items) {
+        // Numbers are always text-dim per design §3 (numbered-menu spec).
+        const labelColor = it.dim ? c.textDim : c.text;
+        const metaColor = it.dim ? c.textDim : c.textMid;
+        const tagColor = c.accentHi;
+        const num = color(c.textDim, it.n.padStart(2, " "));
+        const label = color(labelColor, it.label);
+        const meta = it.meta ? color(metaColor, it.meta) : "";
+        const tag = it.tag ? color(tagColor, `${glyph.tag} ${it.tag}`) : "";
+        // Build the inner content then right-pad meta + tag.
+        const leftSide = `${indent}${num}  ${label}`;
+        const leftBare = stripAnsi(leftSide);
+        // Reserve room: leftBare | gap | meta | gap | tag, ending at col W-1.
+        const tagBare = it.tag ? `${glyph.tag} ${it.tag}` : "";
+        const metaBare = it.meta ?? "";
+        const tagWidth = tagBare.length;
+        const metaWidth = metaBare.length;
+        // tag occupies the rightmost slot if present; meta column ends before
+        // the tag with a one-space gap. If no tag, meta ends at col W-1.
+        const rightEnd = W - 1;
+        let line;
+        if (it.tag && it.meta) {
+            const tagStart = rightEnd - tagWidth;
+            const metaEnd = tagStart - 1; // one space between meta and tag
+            const metaStart = metaEnd - metaWidth;
+            const gap1 = " ".repeat(Math.max(1, metaStart - leftBare.length));
+            const gap2 = " ";
+            line = `${leftSide}${gap1}${meta}${gap2}${tag}`;
+        }
+        else if (it.tag) {
+            const tagStart = rightEnd - tagWidth;
+            const gap = " ".repeat(Math.max(1, tagStart - leftBare.length));
+            line = `${leftSide}${gap}${tag}`;
+        }
+        else if (it.meta) {
+            const metaStart = rightEnd - metaWidth;
+            const gap = " ".repeat(Math.max(1, metaStart - leftBare.length));
+            line = `${leftSide}${gap}${meta}`;
+        }
+        else {
+            line = leftSide;
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+/** Convenience: print menu + trailing blank line. */
+export function printMenu(items) {
+    process.stdout.write(`${Menu(items)}\n\n`);
+}
+//# sourceMappingURL=menu.js.map

package/dist/lib/setup/ui/menu.js.map

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

package/dist/lib/setup/ui/panel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Panel atom — rounded `╭─╮ │ ╰─╯` box in `accent-dim`.
+ *
+ * Used ONLY for summary views (settings overview, completion screen).
+ * Flow screens use Header + Title + content + Prompt — no box. The
+ * design handoff is strict about this.
+ */
+export interface PanelOptions {
+    /** Right-side glyph on a row (e.g. `✓` to mark "edited this session"). */
+    trailing?: Record<number, string>;
+}
+/**
+ * Render a panel. Each row is a string (already formatted/colored). The
+ * panel wraps each row in `│ … │` with `accent-dim` border. The title
+ * sits in the top border: `╭─ title ────╮`.
+ *
+ * Width is fixed to the lesser of W or 68 cols of inner content (matches
+ * the spec mockup) so summary panels never spill on wider terminals.
+ */
+export declare function Panel(title: string, rows: string[], opts?: PanelOptions): string;
+/** Convenience: print panel + trailing blank line. */
+export declare function printPanel(title: string, rows: string[], opts?: PanelOptions): void;
+//# sourceMappingURL=panel.d.ts.map

package/dist/lib/setup/ui/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/panel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAkCpF;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CAEvF"}

package/dist/lib/setup/ui/panel.js

@@ -0,0 +1,53 @@
+/**
+ * Panel atom — rounded `╭─╮ │ ╰─╯` box in `accent-dim`.
+ *
+ * Used ONLY for summary views (settings overview, completion screen).
+ * Flow screens use Header + Title + content + Prompt — no box. The
+ * design handoff is strict about this.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a panel. Each row is a string (already formatted/colored). The
+ * panel wraps each row in `│ … │` with `accent-dim` border. The title
+ * sits in the top border: `╭─ title ────╮`.
+ *
+ * Width is fixed to the lesser of W or 68 cols of inner content (matches
+ * the spec mockup) so summary panels never spill on wider terminals.
+ */
+export function Panel(title, rows, opts = {}) {
+    const W = width();
+    const indent = " ";
+    // Inner content width: target 66 chars inner (between `│  ` and `  │`),
+    // clamp by terminal width.
+    const innerW = Math.min(66, Math.max(40, W - 4));
+    const border = c.accentDim;
+    // Top border: `╭─ title ──────╮`
+    const titleStyled = color(c.textHi, title);
+    const topHead = `${color(border, `${glyph.boxTL}${glyph.boxH} `)}${titleStyled} `;
+    const topHeadBare = stripAnsi(topHead);
+    const topPadLen = Math.max(1, innerW + 2 - topHeadBare.length);
+    const top = `${indent}${topHead}${color(border, `${glyph.boxH.repeat(topPadLen)}${glyph.boxTR}`)}`;
+    // Each row: `│  <content>  │` — pad content to innerW.
+    const left = color(border, `${glyph.boxV} `);
+    const right = color(border, ` ${glyph.boxV}`);
+    const middle = [];
+    rows.forEach((rowStyled, idx) => {
+        const bare = stripAnsi(rowStyled);
+        const trail = opts.trailing?.[idx] ?? "";
+        const trailBare = stripAnsi(trail);
+        // Reserve room for the optional trailing glyph (e.g. ✓), right-aligned.
+        const usable = innerW - bare.length - (trailBare ? trailBare.length + 1 : 0);
+        const padContent = " ".repeat(Math.max(0, usable));
+        const trailingPart = trail ? ` ${trail}` : "";
+        middle.push(`${indent}${left}${rowStyled}${padContent}${trailingPart}${right}`);
+    });
+    // Bottom border: `╰──────────────╯`
+    const bottom = `${indent}${color(border, `${glyph.boxBL}${glyph.boxH.repeat(innerW + 2)}${glyph.boxBR}`)}`;
+    return [top, ...middle, bottom].join("\n");
+}
+/** Convenience: print panel + trailing blank line. */
+export function printPanel(title, rows, opts = {}) {
+    process.stdout.write(`${Panel(title, rows, opts)}\n\n`);
+}
+//# sourceMappingURL=panel.js.map

package/dist/lib/setup/ui/panel.js.map

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