chat-recall 0.5.27 → 0.5.29

package/dist/init-progress.d.ts

@@ -0,0 +1,52 @@
+export interface WalkSnapshot {
+    done: number;
+    total: number;
+    complete: boolean;
+}
+/** A fixed-width bar. Pure, so the rendering is pinned by tests. */
+export declare function renderBar(done: number, total: number, width?: number): string;
+/** `1,240/15,748` — grouped, because five- and six-digit counts are unreadable raw. */
+export declare function renderCount(done: number, total: number): string;
+/**
+ * The one line shown while a walk is in flight, or the one line shown when it
+ * is handed off / finished. Kept pure and separate from the polling so the exact
+ * wording is testable — the whole point of this change is the wording.
+ */
+export declare function progressLine(snap: WalkSnapshot | null): string;
+export declare function handOffLine(snap: WalkSnapshot | null): string;
+export interface FirstSyncDeps {
+    /** Current walk state, or null when none has been reported yet. */
+    readProgress: () => WalkSnapshot | null;
+    /** Draw the single line, in place. */
+    draw: (text: string) => void;
+    /** Start the detached worker. Returns a stop handle for tests. */
+    startWorker: () => void;
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+    /** How long to watch before handing off. */
+    handOffAfterMs?: number;
+    pollMs?: number;
+}
+export interface FirstSyncOutcome {
+    /** True when the walk reported `complete` before the hand-off deadline. */
+    finished: boolean;
+    snapshot: WalkSnapshot | null;
+}
+/**
+ * Start the sync, watch it on ONE line, and stop watching at the deadline.
+ *
+ * Never kills the worker — handing off means letting it run, not cancelling it.
+ * The caller prints the final line, because only it knows the surrounding
+ * layout.
+ */
+export declare function watchFirstSync(deps: FirstSyncDeps): Promise<FirstSyncOutcome>;
+/**
+ * Spawn `<this cli> sync` fully detached, stdio discarded.
+ *
+ * `stdio: 'ignore'` is the half that silences the daemon log; `detached` +
+ * `unref` is the half that lets a long walk outlive `init`. `argv[1]` rather
+ * than a resolved package path, so a dev checkout, a global install and a
+ * user-prefix install all re-invoke the binary that is actually running.
+ */
+export declare function spawnDetachedSync(extraArgs?: string[]): void;
+//# sourceMappingURL=init-progress.d.ts.map

package/dist/init-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-progress.d.ts","sourceRoot":"","sources":["../src/init-progress.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAKzE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAI9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAK7D;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,YAAY,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACxC,sCAAsC;IACtC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,kEAAkE;IAClE,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAcnF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAM,EAAO,GAAG,IAAI,CAShE"}

package/dist/init-progress.js

@@ -0,0 +1,98 @@
+/**
+ * ONE LINE for the first sync, and a hand-off when it is long.
+ *
+ * ── What this replaces ────────────────────────────────────────────────────
+ * `init` step 5 was `await syncSessions()`. Two problems, both reported by a
+ * user on a 15,748-session machine:
+ *
+ *   1. It BLOCKED for minutes, while step 6 went on to explain that background
+ *      sync runs via the MCP anyway — so the wait bought nothing but a wait.
+ *   2. It printed the daemon's log to the terminal. `sync-client.ts` has 18
+ *      `[sync] …` console.error calls written for a log file nobody tails, and
+ *      onboarding inherited every one of them, including
+ *      "01758d3f… is 115MB (over the 64MB ceiling)" — true, and none of a new
+ *      user's business.
+ *
+ * Running the sync as a DETACHED CHILD fixes both at once: its stdio is
+ * discarded, so the log cannot reach the terminal by construction, and it
+ * survives `init` exiting, so a long walk continues without holding anyone up.
+ *
+ * Progress needs no new plumbing. `sync-client.ts` already calls
+ * `reportWalkProgress()` into the collector-health file on every walk; this
+ * polls that file. So the bar reflects the real walk, not an estimate.
+ */
+import { spawn } from 'node:child_process';
+/** A fixed-width bar. Pure, so the rendering is pinned by tests. */
+export function renderBar(done, total, width = 12) {
+    if (total <= 0)
+        return '░'.repeat(width);
+    const ratio = Math.max(0, Math.min(1, done / total));
+    const filled = Math.round(ratio * width);
+    return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+/** `1,240/15,748` — grouped, because five- and six-digit counts are unreadable raw. */
+export function renderCount(done, total) {
+    const n = (x) => x.toLocaleString('en-US');
+    return `${n(done)}/${n(total)}`;
+}
+/**
+ * The one line shown while a walk is in flight, or the one line shown when it
+ * is handed off / finished. Kept pure and separate from the polling so the exact
+ * wording is testable — the whole point of this change is the wording.
+ */
+export function progressLine(snap) {
+    if (!snap || snap.total <= 0)
+        return 'starting…';
+    if (snap.complete)
+        return `${renderCount(snap.done, snap.total)} indexed`;
+    return `${renderBar(snap.done, snap.total)}  ${renderCount(snap.done, snap.total)}`;
+}
+export function handOffLine(snap) {
+    const where = snap && snap.total > 0
+        ? `${renderCount(snap.done, snap.total)} so far`
+        : 'started';
+    return `${where} — continuing in the background`;
+}
+/**
+ * Start the sync, watch it on ONE line, and stop watching at the deadline.
+ *
+ * Never kills the worker — handing off means letting it run, not cancelling it.
+ * The caller prints the final line, because only it knows the surrounding
+ * layout.
+ */
+export async function watchFirstSync(deps) {
+    const handOffAfterMs = deps.handOffAfterMs ?? 20_000;
+    const pollMs = deps.pollMs ?? 400;
+    const started = deps.now();
+    deps.startWorker();
+    let snap = null;
+    for (;;) {
+        snap = deps.readProgress();
+        if (snap?.complete)
+            return { finished: true, snapshot: snap };
+        if (deps.now() - started >= handOffAfterMs)
+            return { finished: false, snapshot: snap };
+        deps.draw(progressLine(snap));
+        await deps.sleep(pollMs);
+    }
+}
+/**
+ * Spawn `<this cli> sync` fully detached, stdio discarded.
+ *
+ * `stdio: 'ignore'` is the half that silences the daemon log; `detached` +
+ * `unref` is the half that lets a long walk outlive `init`. `argv[1]` rather
+ * than a resolved package path, so a dev checkout, a global install and a
+ * user-prefix install all re-invoke the binary that is actually running.
+ */
+export function spawnDetachedSync(extraArgs = []) {
+    const entry = process.argv[1];
+    if (!entry)
+        return;
+    const child = spawn(process.execPath, [entry, 'sync', ...extraArgs], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+    });
+    child.unref();
+}
+//# sourceMappingURL=init-progress.js.map

package/dist/init-progress.js.map

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

package/dist/init-report.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `init` says two things: installing, then done.
+ *
+ * ── What it used to say ───────────────────────────────────────────────────
+ * Forty lines. A numbered heading per step, then a line per ITEM inside each
+ * step — one per AI tool found AND per tool not found, one per MCP client
+ * configured, one per skills directory, a four-line advert for an optional
+ * companion, a sixty-name list of MCP tools, and the sync daemon's own log,
+ * including "01758d3f… is 115MB (over the 64MB ceiling)".
+ *
+ * ── What it says now ──────────────────────────────────────────────────────
+ *   chat-recall init  v0.5.27
+ *   Installing…
+ *   ✓ Done
+ *
+ * That is the whole contract. No step numbers, no counts, no per-item audit.
+ *
+ * The ONE exception is a thing the user must act on — a config file that would
+ * not parse, an env var to set, a server that cannot be reached. Those print on
+ * their own line, always. A quiet install that hides a failure is not quiet, it
+ * is broken; every bug found on 2026-08-27 was one the output failed to name.
+ */
+export interface InitReporter {
+    /** Show the single "Installing…" line. Idempotent — call it freely. */
+    start: () => void;
+    /** Something the user must act on. ALWAYS printed, on its own line. */
+    warn: (text: string) => void;
+    /** Clear the status line and print the closing line. */
+    done: (text: string) => void;
+}
+export interface ReporterOpts {
+    /** A TTY gets an in-place line it can overwrite; a pipe gets a plain one. */
+    tty: boolean;
+    write: (s: string) => void;
+    line: (s: string) => void;
+}
+export declare function createInitReporter(opts: ReporterOpts): InitReporter;
+//# sourceMappingURL=init-report.d.ts.map

package/dist/init-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-report.d.ts","sourceRoot":"","sources":["../src/init-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wDAAwD;IACxD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3B;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAwBnE"}

package/dist/init-report.js

@@ -0,0 +1,53 @@
+/**
+ * `init` says two things: installing, then done.
+ *
+ * ── What it used to say ───────────────────────────────────────────────────
+ * Forty lines. A numbered heading per step, then a line per ITEM inside each
+ * step — one per AI tool found AND per tool not found, one per MCP client
+ * configured, one per skills directory, a four-line advert for an optional
+ * companion, a sixty-name list of MCP tools, and the sync daemon's own log,
+ * including "01758d3f… is 115MB (over the 64MB ceiling)".
+ *
+ * ── What it says now ──────────────────────────────────────────────────────
+ *   chat-recall init  v0.5.27
+ *   Installing…
+ *   ✓ Done
+ *
+ * That is the whole contract. No step numbers, no counts, no per-item audit.
+ *
+ * The ONE exception is a thing the user must act on — a config file that would
+ * not parse, an env var to set, a server that cannot be reached. Those print on
+ * their own line, always. A quiet install that hides a failure is not quiet, it
+ * is broken; every bug found on 2026-08-27 was one the output failed to name.
+ */
+const INSTALLING = 'Installing…';
+export function createInitReporter(opts) {
+    let painted = false;
+    const clear = () => {
+        if (painted && opts.tty)
+            opts.write(`\r${' '.repeat(INSTALLING.length)}\r`);
+        painted = false;
+    };
+    return {
+        start() {
+            if (painted)
+                return;
+            if (opts.tty) {
+                opts.write(INSTALLING);
+                painted = true;
+            }
+            else
+                opts.line(INSTALLING);
+        },
+        warn(text) {
+            // Clear first, or the warning lands on top of the status line.
+            clear();
+            opts.line(text);
+        },
+        done(text) {
+            clear();
+            opts.line(text);
+        },
+    };
+}
+//# sourceMappingURL=init-report.js.map

package/dist/init-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-report.js","sourceRoot":"","sources":["../src/init-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAkBH,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5E,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;YACH,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC;YAAC,CAAC;;gBACpD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI;YACP,+DAA+D;YAC/D,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,IAAI;YACP,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}