@stitchdb/cli 0.8.0 → 0.10.0

package/dist/cli.js

@@ -628,6 +628,7 @@ async function cmdHook(args) {
         try {
             const stitch = client(cfg);
             const projectTag = (threadName.split('/')[0] || threadName).toLowerCase();
+            const baseUrl = cfg.baseUrl || 'https://db.stitchdb.com';
             const [thread, memHits, workspaces, fileSummaries, aboutMems] = await Promise.all([
                 stitch.thread(threadName).recall({ last: 5 }).catch(() => ({ thread_id: '', recent: [], semantic: [] })),
                 stitch.recall(projectTag, { k: 8 }).catch(() => []),
@@ -635,10 +636,26 @@ async function cmdHook(args) {
                 stitch.list({ limit: 12 }).then((all) => all.filter((m) => m.tags.some((t) => t.startsWith('file:')))).catch(() => []),
                 stitch.list({ tag: 'workspace:about', limit: 1 }).catch(() => []),
             ]);
-            const currentWs = Array.isArray(workspaces) && workspaces.length > 0 ? workspaces[0] : null;
+            // Look up the current workspace using the client's resolved id; fall
+            // back to first if resolveWorkspace failed (shouldn't normally).
+            const currentWsId = await stitch.resolveWorkspace().catch(() => null);
+            const currentWs = (Array.isArray(workspaces) ? workspaces : [])
+                .find((w) => w.id === currentWsId) || (Array.isArray(workspaces) ? workspaces[0] : null);
+            // Cross-project user-level memories from the special `_global` workspace.
+            // Pull top 8 most-recent — these are user preferences / rules that apply
+            // EVERYWHERE, regardless of which project this session is in.
+            let globalMems = [];
+            try {
+                const globalWs = (Array.isArray(workspaces) ? workspaces : []).find((w) => w.name === '_global');
+                if (globalWs) {
+                    const globalClient = new Stitch({ apiKey: cfg.apiKey, baseUrl, workspace: globalWs.id });
+                    globalMems = await globalClient.list({ limit: 8 }).catch(() => []);
+                }
+            }
+            catch { /* ignore */ }
             const lines = [];
             lines.push('<stitch-context>');
-            lines.push(`Project: ${threadName} · Workspace: ${currentWs?.name || '(unknown)'} · Stitch MCP tools: recall, remember, thread_recall, thread_append, workspace_setup, file_summary, file_summary_save.`);
+            lines.push(`Project: ${threadName} · Workspace: ${currentWs?.name || '(unknown)'} · Stitch MCP tools: recall, remember, recall_global, remember_global, thread_recall, thread_append, workspace_setup, file_summary, file_summary_save.`);
             lines.push('');
             // Nudge the AI to set a meaningful workspace name once.
             if (currentWs?.name === 'default') {
@@ -646,6 +663,15 @@ async function cmdHook(args) {
                 lines.push('Call the `workspace_setup` MCP tool with a slug-style name based on this project (e.g. the package.json name or repo dir).');
                 lines.push('');
             }
+            // Global preferences first — they should bias everything else.
+            if (globalMems.length > 0) {
+                lines.push('### User-level rules & preferences (apply across all projects)');
+                for (const m of globalMems) {
+                    const txt = String(m.content || '').replace(/\n+/g, ' ').slice(0, 350);
+                    lines.push(`- **[${m.kind}]** ${txt}`);
+                }
+                lines.push('');
+            }
             if (Array.isArray(aboutMems) && aboutMems.length > 0) {
                 lines.push('### About this workspace');
                 lines.push(String(aboutMems[0].content || '').slice(0, 400));
@@ -657,7 +683,13 @@ async function cmdHook(args) {
                 for (const m of sortedMems) {
                     const isAuto = Array.isArray(m.tags) && m.tags.includes('auto');
                     const txt = String(m.content || '').replace(/\n+/g, ' ').slice(0, 350);
-                    lines.push(`- **[${m.kind}${isAuto ? '·auto' : ''}]** ${txt}`);
+                    // Source receipt: when this memory came from a distilled thread,
+                    // mark the source so the agent knows it can call thread_recall on
+                    // that thread for verbatim context behind the fact.
+                    const src = m.source_thread_id
+                        ? ` _(from thread, ${m.source_turn_ids?.length || 0} turns)_`
+                        : '';
+                    lines.push(`- **[${m.kind}${isAuto ? '·auto' : ''}]** ${txt}${src}`);
                 }
                 lines.push('');
             }
@@ -679,7 +711,7 @@ async function cmdHook(args) {
                 }
                 lines.push('');
             }
-            lines.push('Call `recall` for deeper search, `thread_recall` for older turns, `file_summary` BEFORE reading any non-trivial file (saves tokens).');
+            lines.push('Call `recall` for project memory, `recall_global` for cross-project user prefs, `thread_recall` for older turns, `file_summary` BEFORE reading any non-trivial file. Save user-level habits/preferences with `remember_global`; project facts with `remember`.');
             lines.push('</stitch-context>');
             process.stdout.write(lines.join('\n'));
         }
@@ -1054,7 +1086,6 @@ async function cmdSummarizeFile(args) {
         return;
     try {
         const stitch = client(cfg);
-        const projectTag = (inferThread() || 'default').split('/')[0];
         // Replace any prior summary for this path.
         const prior = await stitch.list({ tag: `file:${rel}`, limit: 50 }).catch(() => []);
         for (const p of prior) {
@@ -1063,9 +1094,13 @@ async function cmdSummarizeFile(args) {
             }
             catch { }
         }
+        // No project:* tag — the workspace itself is the project identity now.
+        // Adding a project tag based on inferThread() is the bug that caused
+        // cross-workspace contamination when the workspace pin and the thread
+        // pin disagreed.
         await stitch.remember(summary, {
             kind: 'snippet',
-            tags: [`file:${rel}`, `hash:${hashPrefix}`, 'auto:file-summary', `project:${projectTag}`],
+            tags: [`file:${rel}`, `hash:${hashPrefix}`, 'auto:file-summary'],
         });
     }
     catch { /* silent — never break a session */ }
@@ -1209,13 +1244,25 @@ async function cmdDistill(args) {
         bumpDistillCooldown(thread);
         return;
     }
-    // Push each to Stitch as a memory with auto:true tag.
-    const projectTag = thread.split('/')[0] || thread;
+    // Push each to Stitch as a memory with auto:true tag, plus receipts:
+    // the source thread + the IDs of the turns this distill batch covered,
+    // and a short excerpt from the most recent user turn so the dashboard /
+    // recall surface can preview the conversational context behind the fact
+    // without an extra round-trip.
+    const sourceTurnIds = recall.recent.map((t) => t.id);
+    const lastUserTurn = [...recall.recent].reverse().find((t) => t.role === 'user');
+    const sourceExcerpt = lastUserTurn ? String(lastUserTurn.content || '').slice(0, 300) : undefined;
     let saved = 0;
     for (const m of memories) {
         try {
-            const tags = ['auto', 'auto:distill', `thread:${thread}`, `project:${projectTag}`, ...(m.tags || [])];
-            await stitch.remember(m.content, { kind: m.kind, tags });
+            const tags = ['auto', 'auto:distill', `thread:${thread}`, ...(m.tags || [])];
+            await stitch.remember(m.content, {
+                kind: m.kind,
+                tags,
+                source_thread_id: recall.thread_id,
+                source_turn_ids: sourceTurnIds,
+                source_excerpt: sourceExcerpt,
+            });
             saved++;
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stitchdb/cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Stitch CLI — manage memory + run agents from your terminal",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "license": "MIT",
   "engines": { "node": ">=20" },
   "dependencies": {
-    "@stitchdb/agent": "^0.2.0"
+    "@stitchdb/agent": "^0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0",