@clauderecallhq/cli 0.0.1 → 0.11.0

package/dist/daemon/git-correlator.js

@@ -0,0 +1,256 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { stat } from 'node:fs/promises';
+import { getDb } from '../db/client.js';
+const execFileP = promisify(execFile);
+/**
+ * v0.10b — Git correlator.
+ *
+ * For any session whose `cwd` is a live git worktree, we record every commit
+ * authored in that worktree during the session's [started_at, ended_at]
+ * window. The invariants are non-negotiable:
+ *
+ *   - `git` is always spawned with `cwd: sessionCwd`. It is never invoked at
+ *     the user's HOME or anywhere else. This is what keeps blast radius
+ *     scoped to the worktree the user was working in.
+ *   - Only read-only subcommands run (`rev-parse`, `log`). No `fetch`, no
+ *     `push`, no `pull`, no `checkout`. We never touch refs or disk state.
+ *   - Arguments are passed via the execFile array form — no shell, no
+ *     interpolation. A malicious branch name or commit subject cannot inject
+ *     a command.
+ *   - Missing cwds, non-repos, or permission errors are swallowed silently.
+ *     This is a best-effort enrichment; it must never crash ingest.
+ */
+const GIT_TIMEOUT_MS = 10_000;
+const LOG_PRETTY = '%H%x09%aI%x09%s';
+async function isGitWorktree(cwd) {
+    try {
+        const { stdout } = await execFileP('git', ['rev-parse', '--is-inside-work-tree'], { cwd, timeout: GIT_TIMEOUT_MS });
+        return stdout.trim() === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+async function gitLogCommits(cwd, since, until) {
+    // --no-color / --no-pager for scriptable output.
+    // --all ensures we catch commits on any branch authored during the window,
+    // not just the current HEAD lineage. Recall users frequently rebase or
+    // branch-hop mid-session.
+    const args = [
+        '--no-pager',
+        'log',
+        '--all',
+        '--no-color',
+        '--since',
+        since,
+        '--until',
+        until,
+        `--pretty=format:${LOG_PRETTY}`,
+    ];
+    const { stdout } = await execFileP('git', args, {
+        cwd,
+        timeout: GIT_TIMEOUT_MS,
+        maxBuffer: 8 * 1024 * 1024,
+    });
+    const rows = [];
+    const seen = new Set();
+    for (const line of stdout.split('\n')) {
+        if (!line)
+            continue;
+        const [sha, iso, ...rest] = line.split('\t');
+        if (!sha || seen.has(sha))
+            continue;
+        seen.add(sha);
+        rows.push({
+            commit_sha: sha,
+            committed_at: iso ?? null,
+            subject: rest.join('\t') || null,
+        });
+    }
+    return rows;
+}
+function getSession(sessionId) {
+    const db = getDb();
+    return (db
+        .prepare(`SELECT id, cwd, started_at, ended_at
+         FROM sessions WHERE id = ?`)
+        .get(sessionId) ?? null);
+}
+function persistCommits(sessionId, cwdSnapshot, commits) {
+    if (commits.length === 0)
+        return 0;
+    const db = getDb();
+    const now = new Date().toISOString();
+    const ins = db.prepare(`INSERT OR IGNORE INTO session_commits
+       (session_id, commit_sha, committed_at, subject, cwd_snapshot, correlated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`);
+    let inserted = 0;
+    const txn = db.transaction((rows) => {
+        for (const r of rows) {
+            const result = ins.run(sessionId, r.commit_sha, r.committed_at, r.subject, cwdSnapshot, now);
+            if (result.changes > 0)
+                inserted += 1;
+        }
+    });
+    txn(commits);
+    return inserted;
+}
+/**
+ * Correlate one session. Silently skips any graceful-failure path — the
+ * CLI and API endpoints surface the result code for user-facing calls; the
+ * watcher hook discards it.
+ */
+export async function correlateSession(sessionId) {
+    const session = getSession(sessionId);
+    if (!session) {
+        return { sessionId, status: 'error', commitsFound: 0, commitsInserted: 0, error: 'session not found' };
+    }
+    if (!session.cwd) {
+        return { sessionId, status: 'no-cwd', commitsFound: 0, commitsInserted: 0 };
+    }
+    if (!session.started_at || !session.ended_at) {
+        return { sessionId, status: 'no-window', commitsFound: 0, commitsInserted: 0 };
+    }
+    // Tolerate zero-length windows by extending the upper bound by 1 second —
+    // very short sessions sometimes share a timestamp across started_at and
+    // ended_at, which `git log --since=X --until=X` rejects.
+    const sinceIso = session.started_at;
+    const untilIso = session.ended_at === session.started_at
+        ? new Date(Date.parse(session.ended_at) + 1000).toISOString()
+        : session.ended_at;
+    try {
+        const s = await stat(session.cwd);
+        if (!s.isDirectory()) {
+            return { sessionId, status: 'cwd-missing', commitsFound: 0, commitsInserted: 0 };
+        }
+    }
+    catch {
+        return { sessionId, status: 'cwd-missing', commitsFound: 0, commitsInserted: 0 };
+    }
+    const isRepo = await isGitWorktree(session.cwd);
+    if (!isRepo) {
+        return { sessionId, status: 'not-a-repo', commitsFound: 0, commitsInserted: 0 };
+    }
+    try {
+        const commits = await gitLogCommits(session.cwd, sinceIso, untilIso);
+        const inserted = persistCommits(sessionId, session.cwd, commits);
+        return {
+            sessionId,
+            status: 'ok',
+            commitsFound: commits.length,
+            commitsInserted: inserted,
+        };
+    }
+    catch (err) {
+        return {
+            sessionId,
+            status: 'error',
+            commitsFound: 0,
+            commitsInserted: 0,
+            error: err.message,
+        };
+    }
+}
+/**
+ * Correlate every session that has a cwd and a closed time window. Safe to
+ * re-run: INSERT OR IGNORE on the composite PK means a second pass just
+ * tops up newly-visible commits.
+ */
+export async function correlateAll(opts = {}) {
+    const db = getDb();
+    const limit = Math.max(1, Math.min(100_000, opts.limit ?? 10_000));
+    const rows = db
+        .prepare(`SELECT id FROM sessions
+       WHERE cwd IS NOT NULL AND started_at IS NOT NULL AND ended_at IS NOT NULL
+       ORDER BY COALESCE(ended_at, started_at) DESC
+       LIMIT ?`)
+        .all(limit);
+    const summary = {
+        total: rows.length,
+        ok: 0,
+        skipped: 0,
+        errors: 0,
+        commitsInserted: 0,
+        results: [],
+    };
+    let done = 0;
+    for (const r of rows) {
+        const res = await correlateSession(r.id);
+        summary.results.push(res);
+        if (res.status === 'ok') {
+            summary.ok += 1;
+            summary.commitsInserted += res.commitsInserted;
+        }
+        else if (res.status === 'error') {
+            summary.errors += 1;
+        }
+        else {
+            summary.skipped += 1;
+        }
+        done += 1;
+        opts.onProgress?.(done, rows.length);
+    }
+    return summary;
+}
+export function findSessionsByCommit(shaOrPrefix) {
+    const db = getDb();
+    const trimmed = shaOrPrefix.trim();
+    if (!/^[0-9a-fA-F]{4,40}$/.test(trimmed))
+        return [];
+    const like = `${trimmed.toLowerCase()}%`;
+    return db
+        .prepare(`SELECT sc.session_id     AS sessionId,
+              NULLIF(sa.alias, '') AS alias,
+              p.name            AS project,
+              s.started_at      AS startedAt,
+              s.ended_at        AS endedAt,
+              sc.commit_sha     AS commitSha,
+              sc.committed_at   AS committedAt,
+              sc.subject        AS subject
+       FROM session_commits sc
+       JOIN sessions s ON s.id = sc.session_id
+       JOIN projects p ON p.id = s.project_id
+       LEFT JOIN session_aliases sa ON sa.session_id = sc.session_id
+       WHERE lower(sc.commit_sha) = lower(?)
+          OR lower(sc.commit_sha) LIKE ?
+       ORDER BY COALESCE(sc.committed_at, s.started_at, '') DESC`)
+        .all(trimmed, like);
+}
+/** Commits already correlated for a given session. Used by the UI strip. */
+export function getCommitsForSession(sessionId) {
+    const db = getDb();
+    return db
+        .prepare(`SELECT commit_sha, committed_at, subject, correlated_at
+       FROM session_commits
+       WHERE session_id = ?
+       ORDER BY COALESCE(committed_at, correlated_at) ASC`)
+        .all(sessionId);
+}
+/**
+ * Non-blocking hook for the watcher. Fires correlation for a session id,
+ * swallows all errors, and never blocks the caller. If the session already
+ * has correlated rows younger than `freshness_ms`, skip to avoid hammering
+ * git on every debounced reindex while a session is still being written.
+ */
+const RECORRELATE_COOLDOWN_MS = 30_000;
+export function maybeCorrelateInBackground(sessionId) {
+    try {
+        const db = getDb();
+        const row = db
+            .prepare(`SELECT MAX(correlated_at) AS last_at
+         FROM session_commits WHERE session_id = ?`)
+            .get(sessionId);
+        const lastAt = row?.last_at ? Date.parse(row.last_at) : 0;
+        if (lastAt && Date.now() - lastAt < RECORRELATE_COOLDOWN_MS)
+            return;
+    }
+    catch {
+        // DB read failures should never prevent correlation from attempting.
+    }
+    void correlateSession(sessionId).catch((err) => {
+        // eslint-disable-next-line no-console
+        console.error(`[git-correlator] ${sessionId.slice(0, 8)} failed:`, err);
+    });
+}
+//# sourceMappingURL=git-correlator.js.map

package/dist/daemon/git-correlator.js.map

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

package/dist/daemon/mcp-installer.js

@@ -0,0 +1,108 @@
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * One-click "Install Claude Recall MCP in Claude Code" helper. Reads the
+ * user's Claude Code user config at ~/.claude.json, surgically adds a
+ * `mcpServers.recall` entry, and writes it back preserving every other key.
+ *
+ * We pick the best command shape at install time:
+ *   1. If `claude-recall-mcp` is on PATH (globally installed via npm), use
+ *      that as the command — shortest, works anywhere.
+ *   2. Otherwise, locate the bundled `dist/mcp/server.js` relative to this
+ *      module and write an absolute-path invocation via `node`. This is
+ *      what local-dev users (npm link not run) need.
+ */
+const CLAUDE_CONFIG_FILE = join(homedir(), '.claude.json');
+// Resolve dist/mcp/server.js by walking up from this file. When built,
+// this file lives at <repo>/dist/daemon/mcp-installer.js → go up two → <repo>/dist
+// → join mcp/server.js.
+const HERE = dirname(fileURLToPath(import.meta.url));
+const BUNDLED_MCP_SCRIPT = resolve(HERE, '..', 'mcp', 'server.js');
+function readClaudeConfig() {
+    if (!existsSync(CLAUDE_CONFIG_FILE))
+        return {};
+    try {
+        const raw = readFileSync(CLAUDE_CONFIG_FILE, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch (err) {
+        console.error('[mcp-installer] failed to parse ~/.claude.json:', err);
+        return {};
+    }
+}
+function hasBinaryOnPath(name) {
+    try {
+        execSync(`command -v ${name}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Pick the best MCP invocation for THIS machine. Globally-installed users
+ * get the short form; local-dev / npm-link-skipped users get an absolute
+ * path to the bundled script so Claude Code can actually find it.
+ */
+function preferredCommand() {
+    if (hasBinaryOnPath('claude-recall-mcp')) {
+        return { command: 'claude-recall-mcp', args: [] };
+    }
+    return { command: process.execPath, args: [BUNDLED_MCP_SCRIPT] };
+}
+export function getMcpInstallStatus() {
+    const cfg = readClaudeConfig();
+    const entry = cfg.mcpServers?.['recall'];
+    return {
+        configPath: CLAUDE_CONFIG_FILE,
+        configExists: existsSync(CLAUDE_CONFIG_FILE),
+        installed: Boolean(entry && typeof entry.command === 'string'),
+        command: entry?.command ?? null,
+        args: entry?.args ?? null,
+    };
+}
+export function installMcp() {
+    const cfg = readClaudeConfig();
+    const existing = (cfg.mcpServers ?? {});
+    const desired = preferredCommand();
+    const already = existing['recall'];
+    const alreadyMatches = already?.command === desired.command &&
+        JSON.stringify(already?.args ?? []) === JSON.stringify(desired.args);
+    if (alreadyMatches)
+        return getMcpInstallStatus();
+    // Build the entry — omit `args` field when empty to keep the config tidy.
+    const recallEntry = { command: desired.command };
+    if (desired.args.length > 0)
+        recallEntry.args = desired.args;
+    const next = {
+        ...cfg,
+        mcpServers: {
+            ...existing,
+            recall: recallEntry,
+        },
+    };
+    writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(next, null, 2));
+    return getMcpInstallStatus();
+}
+export function uninstallMcp() {
+    const cfg = readClaudeConfig();
+    const existing = (cfg.mcpServers ?? {});
+    if (!existing['recall'])
+        return getMcpInstallStatus();
+    const { recall: _removed, ...rest } = existing;
+    void _removed;
+    const next = {
+        ...cfg,
+        mcpServers: rest,
+    };
+    writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(next, null, 2));
+    return getMcpInstallStatus();
+}
+//# sourceMappingURL=mcp-installer.js.map

package/dist/daemon/mcp-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-installer.js","sourceRoot":"","sources":["../../src/daemon/mcp-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;GAWG;AAEH,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAE3D,uEAAuE;AACvE,mFAAmF;AACnF,wBAAwB;AACxB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAenE,SAAS,gBAAgB;IACvB,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAA2B,CAAC;QACrC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;QACtE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB;IACvB,IAAI,eAAe,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,QAAQ,CAE1B,CAAC;IACd,OAAO;QACL,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,UAAU,CAAC,kBAAkB,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC9D,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,IAAI;QAC/B,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;IACnE,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAsD,CAAC;IACxF,MAAM,cAAc,GAClB,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO;QACpC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,cAAc;QAAE,OAAO,mBAAmB,EAAE,CAAC;IAEjD,0EAA0E;IAC1E,MAAM,WAAW,GAAyC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IACvF,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D,MAAM,IAAI,GAAsB;QAC9B,GAAG,GAAG;QACN,UAAU,EAAE;YACV,GAAG,QAAQ;YACX,MAAM,EAAE,WAAW;SACpB;KACF,CAAC;IACF,aAAa,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACtD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IAC/C,KAAK,QAAQ,CAAC;IACd,MAAM,IAAI,GAAsB;QAC9B,GAAG,GAAG;QACN,UAAU,EAAE,IAAI;KACjB,CAAC;IACF,aAAa,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC"}

package/dist/daemon/onboarding-state.js

@@ -0,0 +1,140 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { z } from 'zod';
+/**
+ * First-run onboarding state (v0.14a).
+ *
+ * The local web UI fires a 3-step tour on first open to put the
+ * context-re-injection moat in front of the user inside the first minute.
+ * Completion is persisted here so the tour does not fire again. A "replay
+ * onboarding" button in the Command Center resets the state.
+ *
+ * File: `$RECALL_HOME/onboarding.json` (default `~/.recall/onboarding.json`).
+ * Dedicated file — not merged into `config.json` — so it is easy to inspect,
+ * reset, or wipe without risking auto-tag configuration.
+ *
+ * Reads are tolerant: a missing or malformed file yields defaults rather than
+ * throwing. The daemon must boot even if a prior version wrote an incompatible
+ * shape. `RECALL_HOME` is resolved lazily on every call so tests can redirect
+ * the data root per-test without a module-cache dance (matches the approach
+ * used by auto-tag-config.ts).
+ *
+ * No secrets ever live in this file — it stores only booleans and timestamps,
+ * so default filesystem permissions are fine (no chmod 0600 needed).
+ */
+function recallHome() {
+    return process.env.RECALL_HOME ?? join(homedir(), '.recall');
+}
+function ensureHome() {
+    const home = recallHome();
+    if (!existsSync(home))
+        mkdirSync(home, { recursive: true });
+}
+function stateFile() {
+    return join(recallHome(), 'onboarding.json');
+}
+/**
+ * Persisted onboarding state. `version` lets us evolve the shape later
+ * without silently misreading old files — if an incompatible version
+ * lands, `read` falls back to defaults.
+ */
+export const OnboardingStateSchema = z.object({
+    version: z.literal(1).default(1),
+    /** True once the user reaches the final step. */
+    completed: z.boolean().default(false),
+    /** True if the user dismissed via "Skip" / "I'll explore myself". */
+    skipped: z.boolean().default(false),
+    /** ISO timestamp of the terminal event (complete OR skip). Null until then. */
+    finishedAt: z.string().nullable().default(null),
+    /** Which step ids the user made it through. Append-only; history-friendly. */
+    completedSteps: z.array(z.string()).default([]),
+    /**
+     * v0.15a.2 — first-run explainer for the Threads view. Flipped to true
+     * the first time the user either finishes or skips the Threads intro
+     * overlay. The "Replay threads tour" button in the Command Center and
+     * the matching Cmd+K command reset this flag back to false.
+     */
+    threadsIntroSeen: z.boolean().default(false),
+});
+const DEFAULTS = {
+    version: 1,
+    completed: false,
+    skipped: false,
+    finishedAt: null,
+    completedSteps: [],
+    threadsIntroSeen: false,
+};
+/**
+ * Read the current state. A missing or malformed file yields defaults —
+ * the web UI treats defaults as "fire the tour".
+ */
+export function readOnboardingState() {
+    const path = stateFile();
+    if (!existsSync(path))
+        return { ...DEFAULTS };
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        const parsed = OnboardingStateSchema.safeParse(raw);
+        return parsed.success ? parsed.data : { ...DEFAULTS };
+    }
+    catch (err) {
+        console.error('[onboarding-state] failed to parse onboarding.json, using defaults:', err);
+        return { ...DEFAULTS };
+    }
+}
+/**
+ * Merge a patch into the on-disk state and return the merged result.
+ * Writes are immutable: we build a new object and never mutate the
+ * existing one in place.
+ */
+export function writeOnboardingState(patch) {
+    ensureHome();
+    const existing = readOnboardingState();
+    const merged = OnboardingStateSchema.parse({
+        ...existing,
+        ...patch,
+        // completedSteps merges additively — never drops history.
+        completedSteps: dedupe([
+            ...(existing.completedSteps ?? []),
+            ...(patch.completedSteps ?? []),
+        ]),
+        version: 1,
+    });
+    writeFileSync(stateFile(), JSON.stringify(merged, null, 2));
+    return merged;
+}
+/**
+ * Reset the flags so the tour fires again. Keeps the completedSteps
+ * history intact as a breadcrumb of prior runs (useful for debugging
+ * "why does the modal keep showing?" later on).
+ */
+export function resetOnboardingState() {
+    ensureHome();
+    const existing = readOnboardingState();
+    const reset = {
+        version: 1,
+        completed: false,
+        skipped: false,
+        finishedAt: null,
+        completedSteps: existing.completedSteps,
+        // The Threads first-run explainer is an independent flow; resetting the
+        // main onboarding tour does not roll it back. Replaying the Threads tour
+        // goes through a separate PUT { threadsIntroSeen: false } patch.
+        threadsIntroSeen: existing.threadsIntroSeen,
+    };
+    writeFileSync(stateFile(), JSON.stringify(reset, null, 2));
+    return reset;
+}
+function dedupe(xs) {
+    const seen = new Set();
+    const out = [];
+    for (const x of xs) {
+        if (seen.has(x))
+            continue;
+        seen.add(x);
+        out.push(x);
+    }
+    return out;
+}
+//# sourceMappingURL=onboarding-state.js.map

package/dist/daemon/onboarding-state.js.map

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

package/dist/daemon/pidfile.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { RECALL_HOME, ensureRecallHome } from '../utils/paths.js';
+export const PID_FILE = join(RECALL_HOME, 'daemon.pid');
+export const PORT_FILE = join(RECALL_HOME, 'daemon.port');
+export const LOG_FILE = join(RECALL_HOME, 'daemon.log');
+export function writeDaemonInfo(info) {
+    ensureRecallHome();
+    writeFileSync(PID_FILE, JSON.stringify(info), { encoding: 'utf8' });
+    writeFileSync(PORT_FILE, String(info.port), { encoding: 'utf8' });
+}
+export function readDaemonInfo() {
+    if (!existsSync(PID_FILE))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(PID_FILE, 'utf8'));
+        if (typeof data.pid !== 'number' || typeof data.port !== 'number')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearDaemonInfo() {
+    for (const path of [PID_FILE, PORT_FILE]) {
+        if (existsSync(path)) {
+            try {
+                unlinkSync(path);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+export function isProcessAlive(pid) {
+    try {
+        // Signal 0 checks process existence without sending a signal.
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getRunningDaemon() {
+    const info = readDaemonInfo();
+    if (!info)
+        return null;
+    if (!isProcessAlive(info.pid)) {
+        clearDaemonInfo();
+        return null;
+    }
+    return info;
+}
+//# sourceMappingURL=pidfile.js.map

package/dist/daemon/pidfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.js","sourceRoot":"","sources":["../../src/daemon/pidfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAQxD,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,gBAAgB,EAAE,CAAC;IACnB,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAe,CAAC;QACtE,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,eAAe,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/daemon/ports.js

@@ -0,0 +1,48 @@
+import { createServer } from 'node:net';
+function tryPort(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port, '127.0.0.1');
+    });
+}
+/**
+ * Pick a free localhost port from the ephemeral range.
+ * We deliberately avoid well-known dev ports (3000, 3001, 4200, 5000, 5173, 8000, 8080, 8888, 9000)
+ * to prevent clobbering the user's other local services.
+ */
+export async function pickFreePort() {
+    const blocked = new Set([3000, 3001, 4200, 5000, 5173, 8000, 8080, 8888, 9000]);
+    // Try a deterministic preferred port first so the port is predictable across restarts.
+    const preferred = 51370;
+    if (!blocked.has(preferred) && (await tryPort(preferred)))
+        return preferred;
+    // Then try random ephemeral ports.
+    for (let i = 0; i < 50; i++) {
+        const candidate = 49152 + Math.floor(Math.random() * (65535 - 49152));
+        if (blocked.has(candidate))
+            continue;
+        if (await tryPort(candidate))
+            return candidate;
+    }
+    // Last resort: ask the OS for any free port.
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            if (addr && typeof addr === 'object') {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                server.close();
+                reject(new Error('could not determine a free port'));
+            }
+        });
+    });
+}
+//# sourceMappingURL=ports.js.map

package/dist/daemon/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/daemon/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAEhF,uFAAuF;IACvF,MAAM,SAAS,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5E,mCAAmC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QACrC,IAAI,MAAM,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IACjD,CAAC;IAED,6CAA6C;IAC7C,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}