chat-recall 0.0.1 → 0.4.8

package/dist/install-skills.js

@@ -0,0 +1,223 @@
+/**
+ * Install the bundled chat-recall Agent Skills into every local AI tool.
+ *
+ * chat-recall ships a set of SKILL.md skills (../skills, bundled in the npm
+ * package) that teach any agent when/how to use the recall_* MCP tools. Every
+ * supported tool reads the SAME SKILL.md shape from its own skills dir, so one
+ * set covers Claude Code, Gemini, Codex, OpenCode and Antigravity. We drop the
+ * files straight into each tool's dir (the only mechanism that works across all
+ * of them — Claude *plugins* are Claude-only).
+ *
+ * Idempotent + updatable + uninstallable despite drop-in having no native
+ * versioning: each installed skill dir gets a `.chat-recall-managed` marker
+ * holding the version. We only ever overwrite/remove dirs that carry OUR marker,
+ * so a user's own skill of the same name is never clobbered.
+ */
+import { readdirSync, existsSync, mkdirSync, rmSync, cpSync, writeFileSync, readFileSync, statSync, realpathSync } from 'fs';
+import { join, basename } from 'path';
+import { claudeHomeDirs } from '@chat-recall/engine/core/tool-paths.js';
+import { claudeBackend } from '@chat-recall/engine/core/backends/claude.js';
+import { geminiBackend } from '@chat-recall/engine/core/backends/gemini.js';
+import { opencodeBackend } from '@chat-recall/engine/core/backends/opencode.js';
+import { codexBackend } from '@chat-recall/engine/core/backends/codex.js';
+import { agyBackend } from '@chat-recall/engine/core/backends/agy.js';
+// NOTE: Antigravity (agy) has no skills dir of its own — it reads Gemini's
+// ~/.gemini/skills (same decision as team-merge.installPathFor). So the Gemini
+// target covers agy; we surface agy only for the "available" hint.
+const MARKER = '.chat-recall-managed';
+/** Bundled skills source dir: <package-root>/skills (dist/install-skills.js → ..). */
+export function skillsSourceDir() {
+    return join(import.meta.dirname, '..', 'skills');
+}
+function version() {
+    try {
+        return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8')).version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** The skill directory names we ship (any dir under skills/ containing SKILL.md). */
+export function bundledSkillNames() {
+    const src = skillsSourceDir();
+    if (!existsSync(src))
+        return [];
+    return readdirSync(src, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && existsSync(join(src, e.name, 'SKILL.md')))
+        .map((e) => e.name)
+        .sort();
+}
+/** Resolve symlinks so two targets that name the SAME directory collapse to one.
+ *  A dir that does not exist yet has nothing to resolve — use it as written. */
+function realPathOrSelf(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+/**
+ * Claude profile targets: one per home returned by `claudeHomeDirs()`.
+ *
+ * Claude is the only backend with profiles. `CLAUDE_CONFIG_DIR=~/.claude-work`
+ * makes that directory the ENTIRE config root for the session — Claude Code
+ * reads skills from `<that home>/skills` and nowhere else. So installing into
+ * `~/.claude/skills` alone means a profile session sees zero recall skills,
+ * while its transcripts index normally and every other check looks green.
+ *
+ * Deduped by REAL path because the usual multi-profile setup symlinks each
+ * profile's `skills/` back to the primary. Without this, one directory would be
+ * reported as four separate installs.
+ */
+function claudeSkillTargets() {
+    const targets = [];
+    const seen = new Set();
+    for (const home of claudeHomeDirs()) {
+        const dir = join(home, 'skills');
+        const key = realPathOrSelf(dir);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const primary = targets.length === 0;
+        targets.push({
+            id: primary ? 'claude' : `claude:${basename(home)}`,
+            label: primary ? 'Claude Code' : `Claude Code (${basename(home)})`,
+            dir,
+            // Judge each profile on ITS OWN transcripts, not the primary's: a home
+            // with no projects/ is a directory someone made, not a Claude install.
+            available: existsSync(join(home, 'projects')),
+        });
+    }
+    // A machine with no Claude home at all still gets the primary target, so
+    // `--all-tools` can install ahead of first launch.
+    if (targets.length === 0) {
+        targets.push({ id: 'claude', label: 'Claude Code', dir: claudeBackend.skillsDir(), available: claudeBackend.isAvailable() });
+    }
+    return targets;
+}
+/** Per-tool skills dir. agy keeps its own (~/.gemini/antigravity-cli/skills) AND
+ *  we also cover ~/.agents/skills (tool-neutral) so any future consumer sees them. */
+export function skillTargets() {
+    return [
+        // Per-tool dirs ONLY. We deliberately do NOT also write ~/.agents/skills:
+        // some tools (e.g. Gemini) read BOTH ~/.agents/skills and their own dir, so
+        // installing to both produces "skill conflict" duplicate warnings. Every tool
+        // we support has its own dir, so per-tool coverage is complete.
+        // Antigravity (agy) has no dir of its own — it reads Gemini's ~/.gemini/skills
+        // (same mapping as team-merge), so the Gemini target covers it.
+        ...claudeSkillTargets(),
+        { id: 'gemini', label: 'Gemini CLI / Antigravity', dir: geminiBackend.skillsDir(), available: geminiBackend.isAvailable() || agyBackend.isAvailable() },
+        { id: 'codex', label: 'Codex', dir: codexBackend.skillsDir(), available: codexBackend.isAvailable() },
+        { id: 'opencode', label: 'OpenCode', dir: opencodeBackend.skillsDir(), available: opencodeBackend.isAvailable() },
+    ];
+}
+/** True if a dir is a chat-recall-managed skill (safe to overwrite/remove). */
+function isManaged(dir) {
+    return existsSync(join(dir, MARKER));
+}
+/** Install (or update) the bundled skills into every target tool.
+ *  @param onlyAvailable install only to tools detected on this machine (default true). */
+export function installSkills(opts = {}) {
+    const onlyAvailable = opts.onlyAvailable ?? true;
+    const src = skillsSourceDir();
+    const names = bundledSkillNames();
+    const v = version();
+    const perTarget = [];
+    for (const t of skillTargets()) {
+        const installed = [];
+        const skippedUserOwned = [];
+        if (onlyAvailable && !t.available) {
+            perTarget.push({ ...t, installed, skippedUserOwned });
+            continue;
+        }
+        for (const name of names) {
+            const dest = join(t.dir, name);
+            // Never clobber a user's own skill that happens to share the name.
+            if (existsSync(dest) && !isManaged(dest)) {
+                skippedUserOwned.push(name);
+                continue;
+            }
+            mkdirSync(t.dir, { recursive: true });
+            rmSync(dest, { recursive: true, force: true });
+            cpSync(join(src, name), dest, { recursive: true });
+            writeFileSync(join(dest, MARKER), `${v}\n`);
+            installed.push(name);
+        }
+        perTarget.push({ ...t, installed, skippedUserOwned });
+    }
+    return { version: v, perTarget };
+}
+/** Remove only chat-recall-managed skills (identified by the marker). */
+export function uninstallSkills() {
+    const names = new Set(bundledSkillNames());
+    const perTarget = [];
+    for (const t of skillTargets()) {
+        const removed = [];
+        if (!existsSync(t.dir)) {
+            perTarget.push({ id: t.id, label: t.label, removed });
+            continue;
+        }
+        for (const entry of readdirSync(t.dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const dir = join(t.dir, entry.name);
+            // Remove anything we manage; restrict to our known names as a safety belt.
+            if (isManaged(dir) && (names.has(entry.name) || entry.name.startsWith('chat-recall'))) {
+                rmSync(dir, { recursive: true, force: true });
+                removed.push(entry.name);
+            }
+        }
+        perTarget.push({ id: t.id, label: t.label, removed });
+    }
+    return { perTarget };
+}
+/** True if any AVAILABLE tool is missing a bundled skill or has an out-of-date
+ *  version. The MCP boot uses this to refresh only when needed (cheap: stat a
+ *  marker per skill), so it doesn't churn the disk on every tool launch. */
+export function skillsNeedRefresh() {
+    const cur = version();
+    const names = bundledSkillNames();
+    if (names.length === 0)
+        return false;
+    for (const t of skillTargets()) {
+        if (!t.available)
+            continue;
+        for (const name of names) {
+            const marker = join(t.dir, name, MARKER);
+            if (!existsSync(marker))
+                return true;
+            try {
+                if (readFileSync(marker, 'utf-8').trim() !== cur)
+                    return true;
+            }
+            catch {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/** For `doctor`: which tools have the current skill version installed. */
+export function skillStatus() {
+    const names = bundledSkillNames();
+    const cur = version();
+    return skillTargets().map((t) => {
+        let installed = 0;
+        let ver = null;
+        for (const name of names) {
+            const marker = join(t.dir, name, MARKER);
+            if (existsSync(marker)) {
+                installed++;
+                try {
+                    ver = readFileSync(marker, 'utf-8').trim();
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return { id: t.id, label: t.label, available: t.available, installed, version: installed === names.length ? ver : (installed ? `${ver} (partial)` : null) };
+    }).filter((s) => s.available || s.installed > 0);
+}
+// Silence unused import in some toolchains; statSync kept for future mtime checks.
+void statSync;
+//# sourceMappingURL=install-skills.js.map

package/dist/install-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.js","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC7H,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,2EAA2E;AAC3E,+EAA+E;AAC/E,mEAAmE;AAEnE,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,sFAAsF;AACtF,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,OAAO;IACd,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3G,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC;IAAC,CAAC;AAC7B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;SAC3E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC;AAID;gFACgF;AAChF,SAAS,cAAc,CAAC,CAAS;IAC/B,IAAI,CAAC;QAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,IAAI,CAAC,EAAE;YACnD,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,QAAQ,CAAC,IAAI,CAAC,GAAG;YAClE,GAAG;YACH,uEAAuE;YACvE,uEAAuE;YACvE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IACD,yEAAyE;IACzE,mDAAmD;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;sFACsF;AACtF,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,0EAA0E;QAC1E,4EAA4E;QAC5E,8EAA8E;QAC9E,gEAAgE;QAChE,+EAA+E;QAC/E,gEAAgE;QAChE,GAAG,kBAAkB,EAAE;QACvB,EAAE,EAAE,EAAE,QAAQ,EAAI,KAAK,EAAE,0BAA0B,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE;QACzJ,EAAE,EAAE,EAAE,OAAO,EAAK,KAAK,EAAE,OAAO,EAAS,GAAG,EAAE,YAAY,CAAC,SAAS,EAAE,EAAK,SAAS,EAAE,YAAY,CAAC,WAAW,EAAE,EAAE;QAClH,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAM,GAAG,EAAE,eAAe,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,WAAW,EAAE,EAAE;KACtH,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AACvC,CAAC;AAOD;0FAC0F;AAC1F,MAAM,UAAU,aAAa,CAAC,OAAoC,EAAE;IAClE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,MAAM,SAAS,GAA+B,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,gBAAgB,GAAa,EAAE,CAAC;QACtC,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACvG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,mEAAmE;YACnE,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YACpF,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAID,yEAAyE;AACzE,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAiC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC5F,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,2EAA2E;YAC3E,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;gBACtF,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED;;4EAE4E;AAC5E,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,SAAS;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrC,IAAI,CAAC;gBAAC,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG;oBAAE,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,IAAI,SAAS,GAAG,CAAC,CAAC;QAAC,IAAI,GAAG,GAAkB,IAAI,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,SAAS,EAAE,CAAC;gBACZ,IAAI,CAAC;oBAAC,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAC9J,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,mFAAmF;AACnF,KAAK,QAAQ,CAAC"}

package/dist/intent-drain.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-tool sync intent drainer (Model B, local executor side).
+ *
+ * The web UI (local or SaaS) enqueues intents on the server. This runs on the
+ * user's machine — where the actual `~/.claude` / `~/.config/opencode` dirs
+ * live — polls each logged-in server for pending intents, performs the
+ * filesystem copy via the engine executor, and acks status back.
+ *
+ * Invoked on a short interval from the watch daemon, and once via the
+ * `chat-recall toolkit drain` command.
+ */
+export interface DrainResult {
+    processed: number;
+    done: number;
+    errored: number;
+}
+/**
+ * Poll every logged-in server once, execute pending intents locally, ack each.
+ * Best-effort: network failures are swallowed (the intent stays pending and is
+ * retried on the next drain since it was never acked).
+ */
+export declare function drainSyncIntents(opts?: {
+    verbose?: boolean;
+}): Promise<DrainResult>;
+//# sourceMappingURL=intent-drain.d.ts.map

package/dist/intent-drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-drain.d.ts","sourceRoot":"","sources":["../src/intent-drain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+DH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAmDD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CA4D7F"}

package/dist/intent-drain.js

@@ -0,0 +1,189 @@
+/**
+ * Cross-tool sync intent drainer (Model B, local executor side).
+ *
+ * The web UI (local or SaaS) enqueues intents on the server. This runs on the
+ * user's machine — where the actual `~/.claude` / `~/.config/opencode` dirs
+ * live — polls each logged-in server for pending intents, performs the
+ * filesystem copy via the engine executor, and acks status back.
+ *
+ * Invoked on a short interval from the watch daemon, and once via the
+ * `chat-recall toolkit drain` command.
+ */
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from 'node:fs';
+import { fetchWithTimeout } from './http.js';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { loadAllCredentials, syncIncremental } from './sync-client.js';
+// Concrete module, NOT the engine barrel: the barrel statically re-exports
+// MemoryIndex -> @lancedb/lancedb, and a static barrel import hoists that
+// native dep to boot-time in the published bundle (breaks fresh installs).
+import { executeSyncAll, executeCopy, } from '@chat-recall/engine/core/toolkit-sync.js';
+import { pushProjectTaskStatuses } from './project-tasks.js';
+/** Apply a code recommendation locally. Currently: append a rule to the
+ *  project's CLAUDE.md (idempotent — skips if the exact rule is already there). */
+function applyCodeRecommendation(intent) {
+    try {
+        const meta = JSON.parse(intent.name || '{}');
+        if (intent.artifact_type === 'write_tasks_file') {
+            if (!meta.rootPath || !meta.content)
+                return { status: 'error', result: JSON.stringify({ error: 'missing rootPath or content' }) };
+            const file = join(meta.rootPath, meta.filename || 'CODE_TASKS.md');
+            writeFileSync(file, meta.content); // overwrite — it's a regenerated task list
+            return { status: 'done', result: JSON.stringify({ wrote: file }) };
+        }
+        if (intent.artifact_type === 'append_claude_md') {
+            const text = meta.payload?.text?.trim();
+            const isGlobal = meta.global || meta.payload?.global;
+            if (!text)
+                return { status: 'error', result: JSON.stringify({ error: 'missing text' }) };
+            // global → ~/.claude/CLAUDE.md (user-wide); else the project's CLAUDE.md.
+            let file;
+            if (isGlobal) {
+                const dir = join(homedir(), '.claude');
+                try {
+                    mkdirSync(dir, { recursive: true });
+                }
+                catch { /* exists */ }
+                file = join(dir, 'CLAUDE.md');
+            }
+            else {
+                if (!meta.rootPath)
+                    return { status: 'error', result: JSON.stringify({ error: 'missing rootPath' }) };
+                file = join(meta.rootPath, 'CLAUDE.md');
+            }
+            const existing = existsSync(file) ? readFileSync(file, 'utf8') : '';
+            if (existing.includes(text))
+                return { status: 'done', result: JSON.stringify({ skipped: 'rule already present', file }) };
+            const block = `${existing && !existing.endsWith('\n') ? '\n' : ''}\n## Rule (added by chat-recall recommendation)\n${text}\n`;
+            if (existing)
+                appendFileSync(file, block);
+            else
+                writeFileSync(file, `# ${(meta.rootPath?.split('/').pop()) || 'Global'} instructions\n${block}`);
+            return { status: 'done', result: JSON.stringify({ appended: file }) };
+        }
+        return { status: 'error', result: JSON.stringify({ error: `unsupported code_apply action: ${intent.artifact_type}` }) };
+    }
+    catch (e) {
+        return { status: 'error', result: JSON.stringify({ error: e instanceof Error ? e.message : 'failed' }) };
+    }
+}
+/** Run one intent and return the (status, result-json) to ack with. */
+async function runIntent(intent, ctx) {
+    try {
+        if (intent.kind === 'recheck_session') {
+            // The server has a thin/absent copy of this session and is asking us to
+            // re-verify from THIS machine (disk + shadow = the fullest local truth)
+            // and re-push if we have more. repairSession does exactly that, scoped to
+            // the requesting server, writing (not a dry run).
+            const id = intent.name;
+            if (!id)
+                return { status: 'error', result: JSON.stringify({ error: 'recheck missing session id' }) };
+            const { repairSession } = await import('./repair.js');
+            const r = await repairSession(id, { dryRun: false, server: ctx.base });
+            return { status: r.status === 'error' ? 'error' : 'done', result: JSON.stringify(r) };
+        }
+        if (intent.kind === 'code_apply') {
+            return applyCodeRecommendation(intent);
+        }
+        if (intent.kind === 'sync_all') {
+            const report = await executeSyncAll();
+            const status = report.failed.length > 0 ? 'error' : 'done';
+            return { status, result: JSON.stringify({ copied: report.copied.length, skipped: report.skipped.length, failed: report.failed }) };
+        }
+        // copy
+        if (!intent.artifact_type || !intent.name || !intent.from_tool || !intent.to_tool) {
+            return { status: 'error', result: JSON.stringify({ error: 'copy intent missing fields' }) };
+        }
+        const r = await executeCopy(intent.artifact_type, intent.name, intent.from_tool, intent.to_tool);
+        // 409 (already exists) is a benign skip, not a failure.
+        const status = r.ok || r.status === 409 ? 'done' : 'error';
+        return { status, result: JSON.stringify(r) };
+    }
+    catch (e) {
+        return { status: 'error', result: JSON.stringify({ error: e instanceof Error ? e.message : 'failed' }) };
+    }
+}
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+let ownVersion = '0.0.0';
+try {
+    const dir = dirname(fileURLToPath(import.meta.url));
+    ownVersion = JSON.parse(readFileSync(join(dir, '../package.json'), 'utf-8')).version || ownVersion;
+}
+catch {
+    try {
+        // @ts-ignore
+        if (typeof __CLI_VERSION__ === 'string')
+            ownVersion = __CLI_VERSION__;
+    }
+    catch { }
+}
+/**
+ * Poll every logged-in server once, execute pending intents locally, ack each.
+ * Best-effort: network failures are swallowed (the intent stays pending and is
+ * retried on the next drain since it was never acked).
+ */
+export async function drainSyncIntents(opts = {}) {
+    const out = { processed: 0, done: 0, errored: 0 };
+    for (const cred of loadAllCredentials()) {
+        const base = cred.serverUrl.replace(/\/+$/, '');
+        const authHeaders = cred.token ? { authorization: `Bearer ${cred.token}` } : {};
+        let pending;
+        try {
+            const res = await fetchWithTimeout(`${base}/api/sync-intents/pending`, { headers: authHeaders });
+            if (!res.ok)
+                continue;
+            const data = (await res.json());
+            pending = data.intents || [];
+            if (data.cli && data.cli.version) {
+                const { planAutoUpdate, runAutoUpdate } = await import('./auto-update.js');
+                const plan = planAutoUpdate(base, { cli: data.cli }, ownVersion, process.env.CHAT_RECALL_AUTO_UPDATE);
+                if (plan.update) {
+                    void runAutoUpdate(base, authHeaders, ownVersion).catch(() => { });
+                }
+            }
+        }
+        catch {
+            continue; // server unreachable — try again next tick
+        }
+        for (const intent of pending) {
+            const { status, result } = await runIntent(intent, { base });
+            out.processed++;
+            if (status === 'done')
+                out.done++;
+            else
+                out.errored++;
+            if (opts.verbose) {
+                const label = intent.kind === 'sync_all' ? 'sync_all'
+                    : intent.kind === 'recheck_session' ? `recheck ${intent.name}`
+                        : `${intent.artifact_type} "${intent.name}" ${intent.from_tool}→${intent.to_tool}`;
+                console.error(`[sync-intent] ${label}: ${status}`);
+            }
+            try {
+                await fetchWithTimeout(`${base}/api/sync-intents/${intent.id}/ack`, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json', ...authHeaders },
+                    body: JSON.stringify({ status, result }),
+                });
+            }
+            catch {
+                // Ack failed — leave it; it'll be re-pulled and re-run (copy is
+                // idempotent: an already-present target acks as a 409 skip).
+            }
+        }
+        // Read-back: push any SECURITY_TASKS.md / CODE_TASKS.md edits (checkbox/
+        // status) up to the server — the file→server half of the two-way sync.
+        try {
+            await pushProjectTaskStatuses(base, authHeaders, { verbose: opts.verbose });
+        }
+        catch { /* never let read-back abort the drain */ }
+    }
+    if (out.processed > 0) {
+        try {
+            await syncIncremental({ scope: 'changed' });
+        }
+        catch { /* best-effort */ }
+    }
+    return out;
+}
+//# sourceMappingURL=intent-drain.js.map

package/dist/intent-drain.js.map

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

package/dist/keyring.d.ts

@@ -0,0 +1,28 @@
+export type KeyringBackendId = 'macos-keychain' | 'libsecret' | 'windows-dpapi' | 'none';
+export interface KeyringProbe {
+    backend: KeyringBackendId;
+    available: boolean;
+    /** Actionable one-liner when unavailable — shown verbatim to the user. */
+    hint?: string;
+}
+/** Injectable process runner (tests pass a fake; nothing else should). */
+export interface Runner {
+    /** Run `file args…`, optionally writing `input` to stdin. Returns stdout. */
+    run(file: string, args: string[], input?: string): string;
+    platform: NodeJS.Platform;
+}
+/** Which backend this platform uses, and whether it's actually usable here. */
+export declare function probeKeyring(r?: Runner): KeyringProbe;
+/** Thrown when the keyring is unusable. Callers surface .message as-is. */
+export declare class KeyringUnavailableError extends Error {
+}
+export declare function keyringSet(secret: string, r?: Runner): void;
+/** The stored passphrase, or null when absent. Throws only if unusable. */
+export declare function keyringGet(r?: Runner): string | null;
+/** Remove the stored passphrase. True if something was removed. */
+export declare function keyringDelete(r?: Runner): boolean;
+/** Single-quote for the `security -i` command line (POSIX-ish tokenizer). */
+export declare function shQuote(s: string): string;
+/** Single-quote for PowerShell, where '' is the escaped quote. */
+export declare function psQuote(s: string): string;
+//# sourceMappingURL=keyring.d.ts.map

package/dist/keyring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyring.d.ts","sourceRoot":"","sources":["../src/keyring.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;AAEzF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,MAAM;IACrB,6EAA6E;IAC7E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AAaD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,GAAE,MAAmB,GAAG,YAAY,CAyBjE;AAED,2EAA2E;AAC3E,qBAAa,uBAAwB,SAAQ,KAAK;CAAG;AAiBrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAE,MAAmB,GAAG,IAAI,CAiBvE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,CAAC,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAmBhE;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,GAAE,MAAmB,GAAG,OAAO,CAgB7D;AAID,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}