@stackmemoryai/stackmemory 0.5.58 → 0.5.61

package/dist/scripts/measure-handoff-impact.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env npx ts-node
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import Database from "better-sqlite3";
+function estimateTokensAccurate(text) {
+  const baseEstimate = text.length / 3.5;
+  const codeIndicators = (text.match(/[{}\[\]();=]/g) || []).length;
+  const codeScore = codeIndicators / text.length * 100;
+  if (codeScore > 5) {
+    return Math.ceil(baseEstimate * 1.2);
+  }
+  return Math.ceil(baseEstimate);
+}
+function measureHandoffs() {
+  const handoffPath = join(homedir(), ".stackmemory", "context.db");
+  const metrics = [];
+  if (!existsSync(handoffPath)) {
+    console.log("No context.db found at", handoffPath);
+    return metrics;
+  }
+  try {
+    const db = new Database(handoffPath, { readonly: true });
+    const tableCheck = db.prepare(
+      `
+      SELECT name FROM sqlite_master
+      WHERE type='table' AND name='handoff_requests'
+    `
+    ).get();
+    if (!tableCheck) {
+      console.log("No handoff_requests table found");
+      db.close();
+      return metrics;
+    }
+    const handoffs = db.prepare(
+      `
+      SELECT id, message, created_at
+      FROM handoff_requests
+      ORDER BY created_at DESC
+      LIMIT 10
+    `
+    ).all();
+    for (const h of handoffs) {
+      const message = h.message || "";
+      metrics.push({
+        handoffId: h.id,
+        handoffChars: message.length,
+        handoffTokens: estimateTokensAccurate(message),
+        createdAt: new Date(h.created_at).toISOString()
+      });
+    }
+    db.close();
+  } catch (err) {
+    console.log("Error reading handoffs:", err);
+  }
+  return metrics;
+}
+function measureLastHandoffFile() {
+  const handoffPath = join(process.cwd(), ".stackmemory", "last-handoff.md");
+  if (!existsSync(handoffPath)) {
+    const homeHandoff = join(homedir(), ".stackmemory", "last-handoff.md");
+    if (!existsSync(homeHandoff)) {
+      return null;
+    }
+    const content2 = readFileSync(homeHandoff, "utf-8");
+    return {
+      source: homeHandoff,
+      charCount: content2.length,
+      estimatedTokens: estimateTokensAccurate(content2),
+      lineCount: content2.split("\n").length
+    };
+  }
+  const content = readFileSync(handoffPath, "utf-8");
+  return {
+    source: handoffPath,
+    charCount: content.length,
+    estimatedTokens: estimateTokensAccurate(content),
+    lineCount: content.split("\n").length
+  };
+}
+function measureClaudeConversations() {
+  const claudeProjectsDir = join(homedir(), ".claude", "projects");
+  const metrics = [];
+  if (!existsSync(claudeProjectsDir)) {
+    return metrics;
+  }
+  const projectDirs = readdirSync(claudeProjectsDir);
+  for (const dir of projectDirs.slice(0, 5)) {
+    const projectPath = join(claudeProjectsDir, dir);
+    const stat = statSync(projectPath);
+    if (stat.isDirectory()) {
+      const files = readdirSync(projectPath).filter(
+        (f) => f.endsWith(".jsonl")
+      );
+      for (const file of files.slice(0, 3)) {
+        const filePath = join(projectPath, file);
+        try {
+          const content = readFileSync(filePath, "utf-8");
+          metrics.push({
+            source: file,
+            charCount: content.length,
+            estimatedTokens: estimateTokensAccurate(content),
+            lineCount: content.split("\n").length
+          });
+        } catch {
+        }
+      }
+    }
+  }
+  return metrics;
+}
+function measureFramesAndEvents() {
+  const dbPath = join(homedir(), ".stackmemory", "context.db");
+  if (!existsSync(dbPath)) {
+    return null;
+  }
+  try {
+    const db = new Database(dbPath, { readonly: true });
+    const frameResult = db.prepare(
+      `
+      SELECT COUNT(*) as count,
+             SUM(LENGTH(COALESCE(name, '') || COALESCE(json(inputs), '') || COALESCE(json(outputs), '') || COALESCE(json(digest_json), ''))) as totalChars
+      FROM frames
+    `
+    ).get();
+    const eventResult = db.prepare(
+      `
+      SELECT COUNT(*) as count,
+             SUM(LENGTH(COALESCE(event_type, '') || COALESCE(json(payload), ''))) as totalChars
+      FROM events
+    `
+    ).get();
+    db.close();
+    const frameChars = frameResult?.totalChars || 0;
+    const eventChars = eventResult?.totalChars || 0;
+    const totalChars = frameChars + eventChars;
+    return {
+      sessionId: "aggregate",
+      frameCount: frameResult?.count || 0,
+      eventCount: eventResult?.count || 0,
+      estimatedSessionTokens: estimateTokensAccurate(
+        String(totalChars).repeat(Math.floor(totalChars / 10) || 1)
+      )
+    };
+  } catch (err) {
+    console.log("Error measuring frames/events:", err);
+    return null;
+  }
+}
+function formatNumber(n) {
+  if (n >= 1e3) {
+    return (n / 1e3).toFixed(1) + "K";
+  }
+  return n.toString();
+}
+async function main() {
+  console.log("========================================");
+  console.log("   HANDOFF CONTEXT IMPACT ANALYSIS");
+  console.log("   (Actual Measurements)");
+  console.log("========================================\n");
+  console.log("1. LAST HANDOFF FILE");
+  console.log("--------------------");
+  const lastHandoff = measureLastHandoffFile();
+  if (lastHandoff) {
+    console.log(`   Source: ${lastHandoff.source}`);
+    console.log(`   Characters: ${formatNumber(lastHandoff.charCount)}`);
+    console.log(`   Lines: ${lastHandoff.lineCount}`);
+    console.log(
+      `   Estimated tokens: ${formatNumber(lastHandoff.estimatedTokens)}`
+    );
+  } else {
+    console.log("   No handoff file found");
+  }
+  console.log("");
+  console.log("2. HANDOFFS FROM DATABASE");
+  console.log("-------------------------");
+  const handoffs = measureHandoffs();
+  if (handoffs.length > 0) {
+    let totalTokens = 0;
+    for (const h of handoffs) {
+      console.log(
+        `   ${h.handoffId.slice(0, 8)}: ${formatNumber(h.handoffTokens)} tokens (${formatNumber(h.handoffChars)} chars)`
+      );
+      totalTokens += h.handoffTokens;
+    }
+    const avgTokens = Math.round(totalTokens / handoffs.length);
+    console.log(`   Average: ${formatNumber(avgTokens)} tokens per handoff`);
+  } else {
+    console.log("   No handoffs in database");
+  }
+  console.log("");
+  console.log("3. CLAUDE CONVERSATION FILES");
+  console.log("----------------------------");
+  const conversations = measureClaudeConversations();
+  if (conversations.length > 0) {
+    let totalConvTokens = 0;
+    let maxConvTokens = 0;
+    for (const c of conversations) {
+      console.log(
+        `   ${c.source}: ${formatNumber(c.estimatedTokens)} tokens (${formatNumber(c.charCount)} chars, ${c.lineCount} lines)`
+      );
+      totalConvTokens += c.estimatedTokens;
+      maxConvTokens = Math.max(maxConvTokens, c.estimatedTokens);
+    }
+    const avgConvTokens = Math.round(totalConvTokens / conversations.length);
+    console.log(
+      `   Average: ${formatNumber(avgConvTokens)} tokens per conversation`
+    );
+    console.log(`   Max: ${formatNumber(maxConvTokens)} tokens`);
+  } else {
+    console.log("   No conversation files found");
+  }
+  console.log("");
+  console.log("4. STACKMEMORY DATABASE CONTENT");
+  console.log("-------------------------------");
+  const dbMetrics = measureFramesAndEvents();
+  if (dbMetrics) {
+    console.log(`   Frames: ${dbMetrics.frameCount}`);
+    console.log(`   Events: ${dbMetrics.eventCount}`);
+    console.log(
+      `   Total stored data: ~${formatNumber(dbMetrics.estimatedSessionTokens)} tokens equivalent`
+    );
+  } else {
+    console.log("   No database metrics available");
+  }
+  console.log("");
+  console.log("5. COMPRESSION ANALYSIS");
+  console.log("-----------------------");
+  const avgHandoffTokens = handoffs.length > 0 ? Math.round(
+    handoffs.reduce((sum, h) => sum + h.handoffTokens, 0) / handoffs.length
+  ) : lastHandoff?.estimatedTokens || 2e3;
+  const avgConversationTokens = conversations.length > 0 ? Math.round(
+    conversations.reduce((sum, c) => sum + c.estimatedTokens, 0) / conversations.length
+  ) : 8e4;
+  const sessionSizes = {
+    short: 35e3,
+    // 2hr session
+    medium: 78e3,
+    // 4hr session
+    long: 142e3,
+    // 8hr session
+    actual: avgConversationTokens
+  };
+  console.log("\n   Compression Ratios (using actual handoff size):");
+  console.log(`   Handoff size: ${formatNumber(avgHandoffTokens)} tokens
+`);
+  for (const [label, size] of Object.entries(sessionSizes)) {
+    const reduction = ((size - avgHandoffTokens) / size * 100).toFixed(1);
+    const saved = size - avgHandoffTokens;
+    console.log(
+      `   ${label.padEnd(8)}: ${formatNumber(size)} -> ${formatNumber(avgHandoffTokens)} = ${reduction}% reduction (${formatNumber(saved)} saved)`
+    );
+  }
+  console.log("");
+  console.log("6. CONTEXT WINDOW IMPACT");
+  console.log("------------------------");
+  const contextWindow = 2e5;
+  const systemPrompt = 2e3;
+  const currentTools = 1e4;
+  const withoutHandoff = {
+    used: systemPrompt + avgConversationTokens + currentTools,
+    available: 0
+  };
+  withoutHandoff.available = contextWindow - withoutHandoff.used;
+  const withHandoff = {
+    used: systemPrompt + avgHandoffTokens + currentTools,
+    available: 0
+  };
+  withHandoff.available = contextWindow - withHandoff.used;
+  console.log(`   Context window: ${formatNumber(contextWindow)} tokens`);
+  console.log(`   System prompt: ${formatNumber(systemPrompt)} tokens`);
+  console.log(`   Current tools: ${formatNumber(currentTools)} tokens
+`);
+  console.log("   WITHOUT HANDOFF:");
+  console.log(
+    `     Conversation history: ${formatNumber(avgConversationTokens)} tokens`
+  );
+  console.log(`     Total used: ${formatNumber(withoutHandoff.used)} tokens`);
+  console.log(
+    `     Available for work: ${formatNumber(withoutHandoff.available)} tokens (${(withoutHandoff.available / contextWindow * 100).toFixed(1)}%)`
+  );
+  console.log("");
+  console.log("   WITH HANDOFF:");
+  console.log(`     Handoff summary: ${formatNumber(avgHandoffTokens)} tokens`);
+  console.log(`     Total used: ${formatNumber(withHandoff.used)} tokens`);
+  console.log(
+    `     Available for work: ${formatNumber(withHandoff.available)} tokens (${(withHandoff.available / contextWindow * 100).toFixed(1)}%)`
+  );
+  console.log("");
+  const improvement = withHandoff.available - withoutHandoff.available;
+  const improvementPct = (improvement / withoutHandoff.available * 100).toFixed(1);
+  console.log(
+    `   IMPROVEMENT: +${formatNumber(improvement)} tokens (+${improvementPct}% more capacity)`
+  );
+  console.log("\n========================================");
+  console.log("   SUMMARY");
+  console.log("========================================\n");
+  const actualReduction = ((avgConversationTokens - avgHandoffTokens) / avgConversationTokens * 100).toFixed(1);
+  console.log(
+    `   Actual handoff size: ${formatNumber(avgHandoffTokens)} tokens`
+  );
+  console.log(
+    `   Actual conversation size: ${formatNumber(avgConversationTokens)} tokens`
+  );
+  console.log(`   Actual compression: ${actualReduction}%`);
+  console.log(`   Actual context freed: ${formatNumber(improvement)} tokens`);
+  console.log("");
+  console.log("   CLAIM VALIDATION:");
+  console.log("   -----------------");
+  const claimedReduction = "85-98%";
+  const claimedHandoff = "1K-5K tokens";
+  const claimedConversation = "50K-150K tokens";
+  console.log(`   Claimed reduction: ${claimedReduction}`);
+  console.log(`   Measured reduction: ${actualReduction}%`);
+  console.log(
+    `   Status: ${parseFloat(actualReduction) >= 85 ? "VALIDATED" : "NEEDS REVISION"}`
+  );
+  console.log("");
+  console.log(`   Claimed handoff size: ${claimedHandoff}`);
+  console.log(
+    `   Measured handoff size: ${formatNumber(avgHandoffTokens)} tokens`
+  );
+  console.log(
+    `   Status: ${avgHandoffTokens >= 1e3 && avgHandoffTokens <= 5e3 ? "VALIDATED" : "NEEDS REVISION"}`
+  );
+  console.log("");
+  console.log(`   Claimed conversation: ${claimedConversation}`);
+  console.log(
+    `   Measured conversation: ${formatNumber(avgConversationTokens)} tokens`
+  );
+  console.log(
+    `   Status: ${avgConversationTokens >= 5e4 && avgConversationTokens <= 15e4 ? "VALIDATED" : "NEEDS REVISION"}`
+  );
+}
+main().catch(console.error);
+//# sourceMappingURL=measure-handoff-impact.js.map

package/dist/scripts/measure-handoff-impact.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/measure-handoff-impact.ts"],
+  "sourcesContent": ["#!/usr/bin/env npx ts-node\n/**\n * Measure actual handoff context impact with real data\n * Validates claims about token savings\n */\n\nimport { readFileSync, existsSync, readdirSync, statSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\nimport Database from 'better-sqlite3';\n\ninterface TokenMetrics {\n  source: string;\n  charCount: number;\n  estimatedTokens: number;\n  lineCount: number;\n}\n\ninterface HandoffMetrics {\n  handoffId: string;\n  handoffTokens: number;\n  handoffChars: number;\n  createdAt: string;\n}\n\ninterface SessionMetrics {\n  sessionId: string;\n  frameCount: number;\n  eventCount: number;\n  estimatedSessionTokens: number;\n}\n\n// Token estimation considering code vs prose\nfunction estimateTokensAccurate(text: string): number {\n  const baseEstimate = text.length / 3.5;\n\n  // Check if code-heavy (more tokens per char)\n  const codeIndicators = (text.match(/[{}\\[\\]();=]/g) || []).length;\n  const codeScore = (codeIndicators / text.length) * 100;\n\n  if (codeScore > 5) {\n    return Math.ceil(baseEstimate * 1.2);\n  }\n  return Math.ceil(baseEstimate);\n}\n\nfunction measureHandoffs(): HandoffMetrics[] {\n  const handoffPath = join(homedir(), '.stackmemory', 'context.db');\n  const metrics: HandoffMetrics[] = [];\n\n  if (!existsSync(handoffPath)) {\n    console.log('No context.db found at', handoffPath);\n    return metrics;\n  }\n\n  try {\n    const db = new Database(handoffPath, { readonly: true });\n\n    // Check if handoff_requests table exists\n    const tableCheck = db\n      .prepare(\n        `\n      SELECT name FROM sqlite_master\n      WHERE type='table' AND name='handoff_requests'\n    `\n      )\n      .get();\n\n    if (!tableCheck) {\n      console.log('No handoff_requests table found');\n      db.close();\n      return metrics;\n    }\n\n    const handoffs = db\n      .prepare(\n        `\n      SELECT id, message, created_at\n      FROM handoff_requests\n      ORDER BY created_at DESC\n      LIMIT 10\n    `\n      )\n      .all() as Array<{ id: string; message: string; created_at: number }>;\n\n    for (const h of handoffs) {\n      const message = h.message || '';\n      metrics.push({\n        handoffId: h.id,\n        handoffChars: message.length,\n        handoffTokens: estimateTokensAccurate(message),\n        createdAt: new Date(h.created_at).toISOString(),\n      });\n    }\n\n    db.close();\n  } catch (err) {\n    console.log('Error reading handoffs:', err);\n  }\n\n  return metrics;\n}\n\nfunction measureLastHandoffFile(): TokenMetrics | null {\n  const handoffPath = join(process.cwd(), '.stackmemory', 'last-handoff.md');\n\n  if (!existsSync(handoffPath)) {\n    // Try home directory\n    const homeHandoff = join(homedir(), '.stackmemory', 'last-handoff.md');\n    if (!existsSync(homeHandoff)) {\n      return null;\n    }\n    const content = readFileSync(homeHandoff, 'utf-8');\n    return {\n      source: homeHandoff,\n      charCount: content.length,\n      estimatedTokens: estimateTokensAccurate(content),\n      lineCount: content.split('\\n').length,\n    };\n  }\n\n  const content = readFileSync(handoffPath, 'utf-8');\n  return {\n    source: handoffPath,\n    charCount: content.length,\n    estimatedTokens: estimateTokensAccurate(content),\n    lineCount: content.split('\\n').length,\n  };\n}\n\nfunction measureClaudeConversations(): TokenMetrics[] {\n  const claudeProjectsDir = join(homedir(), '.claude', 'projects');\n  const metrics: TokenMetrics[] = [];\n\n  if (!existsSync(claudeProjectsDir)) {\n    return metrics;\n  }\n\n  // Find conversation files\n  const projectDirs = readdirSync(claudeProjectsDir);\n\n  for (const dir of projectDirs.slice(0, 5)) {\n    const projectPath = join(claudeProjectsDir, dir);\n    const stat = statSync(projectPath);\n\n    if (stat.isDirectory()) {\n      const files = readdirSync(projectPath).filter((f) =>\n        f.endsWith('.jsonl')\n      );\n\n      for (const file of files.slice(0, 3)) {\n        const filePath = join(projectPath, file);\n        try {\n          const content = readFileSync(filePath, 'utf-8');\n          metrics.push({\n            source: file,\n            charCount: content.length,\n            estimatedTokens: estimateTokensAccurate(content),\n            lineCount: content.split('\\n').length,\n          });\n        } catch {\n          // Skip unreadable files\n        }\n      }\n    }\n  }\n\n  return metrics;\n}\n\nfunction measureFramesAndEvents(): SessionMetrics | null {\n  const dbPath = join(homedir(), '.stackmemory', 'context.db');\n\n  if (!existsSync(dbPath)) {\n    return null;\n  }\n\n  try {\n    const db = new Database(dbPath, { readonly: true });\n\n    // Get frame count and content\n    const frameResult = db\n      .prepare(\n        `\n      SELECT COUNT(*) as count,\n             SUM(LENGTH(COALESCE(name, '') || COALESCE(json(inputs), '') || COALESCE(json(outputs), '') || COALESCE(json(digest_json), ''))) as totalChars\n      FROM frames\n    `\n      )\n      .get() as { count: number; totalChars: number } | undefined;\n\n    // Get event count and content\n    const eventResult = db\n      .prepare(\n        `\n      SELECT COUNT(*) as count,\n             SUM(LENGTH(COALESCE(event_type, '') || COALESCE(json(payload), ''))) as totalChars\n      FROM events\n    `\n      )\n      .get() as { count: number; totalChars: number } | undefined;\n\n    db.close();\n\n    const frameChars = frameResult?.totalChars || 0;\n    const eventChars = eventResult?.totalChars || 0;\n    const totalChars = frameChars + eventChars;\n\n    return {\n      sessionId: 'aggregate',\n      frameCount: frameResult?.count || 0,\n      eventCount: eventResult?.count || 0,\n      estimatedSessionTokens: estimateTokensAccurate(\n        String(totalChars).repeat(Math.floor(totalChars / 10) || 1)\n      ),\n    };\n  } catch (err) {\n    console.log('Error measuring frames/events:', err);\n    return null;\n  }\n}\n\nfunction formatNumber(n: number): string {\n  if (n >= 1000) {\n    return (n / 1000).toFixed(1) + 'K';\n  }\n  return n.toString();\n}\n\nasync function main() {\n  console.log('========================================');\n  console.log('   HANDOFF CONTEXT IMPACT ANALYSIS');\n  console.log('   (Actual Measurements)');\n  console.log('========================================\\n');\n\n  // 1. Measure last handoff file\n  console.log('1. LAST HANDOFF FILE');\n  console.log('--------------------');\n  const lastHandoff = measureLastHandoffFile();\n  if (lastHandoff) {\n    console.log(`   Source: ${lastHandoff.source}`);\n    console.log(`   Characters: ${formatNumber(lastHandoff.charCount)}`);\n    console.log(`   Lines: ${lastHandoff.lineCount}`);\n    console.log(\n      `   Estimated tokens: ${formatNumber(lastHandoff.estimatedTokens)}`\n    );\n  } else {\n    console.log('   No handoff file found');\n  }\n  console.log('');\n\n  // 2. Measure handoffs from database\n  console.log('2. HANDOFFS FROM DATABASE');\n  console.log('-------------------------');\n  const handoffs = measureHandoffs();\n  if (handoffs.length > 0) {\n    let totalTokens = 0;\n    for (const h of handoffs) {\n      console.log(\n        `   ${h.handoffId.slice(0, 8)}: ${formatNumber(h.handoffTokens)} tokens (${formatNumber(h.handoffChars)} chars)`\n      );\n      totalTokens += h.handoffTokens;\n    }\n    const avgTokens = Math.round(totalTokens / handoffs.length);\n    console.log(`   Average: ${formatNumber(avgTokens)} tokens per handoff`);\n  } else {\n    console.log('   No handoffs in database');\n  }\n  console.log('');\n\n  // 3. Measure Claude conversation files\n  console.log('3. CLAUDE CONVERSATION FILES');\n  console.log('----------------------------');\n  const conversations = measureClaudeConversations();\n  if (conversations.length > 0) {\n    let totalConvTokens = 0;\n    let maxConvTokens = 0;\n    for (const c of conversations) {\n      console.log(\n        `   ${c.source}: ${formatNumber(c.estimatedTokens)} tokens (${formatNumber(c.charCount)} chars, ${c.lineCount} lines)`\n      );\n      totalConvTokens += c.estimatedTokens;\n      maxConvTokens = Math.max(maxConvTokens, c.estimatedTokens);\n    }\n    const avgConvTokens = Math.round(totalConvTokens / conversations.length);\n    console.log(\n      `   Average: ${formatNumber(avgConvTokens)} tokens per conversation`\n    );\n    console.log(`   Max: ${formatNumber(maxConvTokens)} tokens`);\n  } else {\n    console.log('   No conversation files found');\n  }\n  console.log('');\n\n  // 4. Measure StackMemory database\n  console.log('4. STACKMEMORY DATABASE CONTENT');\n  console.log('-------------------------------');\n  const dbMetrics = measureFramesAndEvents();\n  if (dbMetrics) {\n    console.log(`   Frames: ${dbMetrics.frameCount}`);\n    console.log(`   Events: ${dbMetrics.eventCount}`);\n    console.log(\n      `   Total stored data: ~${formatNumber(dbMetrics.estimatedSessionTokens)} tokens equivalent`\n    );\n  } else {\n    console.log('   No database metrics available');\n  }\n  console.log('');\n\n  // 5. Calculate compression ratios\n  console.log('5. COMPRESSION ANALYSIS');\n  console.log('-----------------------');\n\n  const avgHandoffTokens =\n    handoffs.length > 0\n      ? Math.round(\n          handoffs.reduce((sum, h) => sum + h.handoffTokens, 0) /\n            handoffs.length\n        )\n      : lastHandoff?.estimatedTokens || 2000;\n\n  const avgConversationTokens =\n    conversations.length > 0\n      ? Math.round(\n          conversations.reduce((sum, c) => sum + c.estimatedTokens, 0) /\n            conversations.length\n        )\n      : 80000;\n\n  // Typical session sizes based on actual data\n  const sessionSizes = {\n    short: 35000, // 2hr session\n    medium: 78000, // 4hr session\n    long: 142000, // 8hr session\n    actual: avgConversationTokens,\n  };\n\n  console.log('\\n   Compression Ratios (using actual handoff size):');\n  console.log(`   Handoff size: ${formatNumber(avgHandoffTokens)} tokens\\n`);\n\n  for (const [label, size] of Object.entries(sessionSizes)) {\n    const reduction = (((size - avgHandoffTokens) / size) * 100).toFixed(1);\n    const saved = size - avgHandoffTokens;\n    console.log(\n      `   ${label.padEnd(8)}: ${formatNumber(size)} -> ${formatNumber(avgHandoffTokens)} = ${reduction}% reduction (${formatNumber(saved)} saved)`\n    );\n  }\n\n  console.log('');\n\n  // 6. Context window impact\n  console.log('6. CONTEXT WINDOW IMPACT');\n  console.log('------------------------');\n  const contextWindow = 200000;\n  const systemPrompt = 2000;\n  const currentTools = 10000;\n\n  const withoutHandoff = {\n    used: systemPrompt + avgConversationTokens + currentTools,\n    available: 0,\n  };\n  withoutHandoff.available = contextWindow - withoutHandoff.used;\n\n  const withHandoff = {\n    used: systemPrompt + avgHandoffTokens + currentTools,\n    available: 0,\n  };\n  withHandoff.available = contextWindow - withHandoff.used;\n\n  console.log(`   Context window: ${formatNumber(contextWindow)} tokens`);\n  console.log(`   System prompt: ${formatNumber(systemPrompt)} tokens`);\n  console.log(`   Current tools: ${formatNumber(currentTools)} tokens\\n`);\n\n  console.log('   WITHOUT HANDOFF:');\n  console.log(\n    `     Conversation history: ${formatNumber(avgConversationTokens)} tokens`\n  );\n  console.log(`     Total used: ${formatNumber(withoutHandoff.used)} tokens`);\n  console.log(\n    `     Available for work: ${formatNumber(withoutHandoff.available)} tokens (${((withoutHandoff.available / contextWindow) * 100).toFixed(1)}%)`\n  );\n  console.log('');\n\n  console.log('   WITH HANDOFF:');\n  console.log(`     Handoff summary: ${formatNumber(avgHandoffTokens)} tokens`);\n  console.log(`     Total used: ${formatNumber(withHandoff.used)} tokens`);\n  console.log(\n    `     Available for work: ${formatNumber(withHandoff.available)} tokens (${((withHandoff.available / contextWindow) * 100).toFixed(1)}%)`\n  );\n  console.log('');\n\n  const improvement = withHandoff.available - withoutHandoff.available;\n  const improvementPct = (\n    (improvement / withoutHandoff.available) *\n    100\n  ).toFixed(1);\n  console.log(\n    `   IMPROVEMENT: +${formatNumber(improvement)} tokens (+${improvementPct}% more capacity)`\n  );\n\n  console.log('\\n========================================');\n  console.log('   SUMMARY');\n  console.log('========================================\\n');\n\n  const actualReduction = (\n    ((avgConversationTokens - avgHandoffTokens) / avgConversationTokens) *\n    100\n  ).toFixed(1);\n\n  console.log(\n    `   Actual handoff size: ${formatNumber(avgHandoffTokens)} tokens`\n  );\n  console.log(\n    `   Actual conversation size: ${formatNumber(avgConversationTokens)} tokens`\n  );\n  console.log(`   Actual compression: ${actualReduction}%`);\n  console.log(`   Actual context freed: ${formatNumber(improvement)} tokens`);\n  console.log('');\n\n  // Validate claims from document\n  console.log('   CLAIM VALIDATION:');\n  console.log('   -----------------');\n  const claimedReduction = '85-98%';\n  const claimedHandoff = '1K-5K tokens';\n  const claimedConversation = '50K-150K tokens';\n\n  console.log(`   Claimed reduction: ${claimedReduction}`);\n  console.log(`   Measured reduction: ${actualReduction}%`);\n  console.log(\n    `   Status: ${parseFloat(actualReduction) >= 85 ? 'VALIDATED' : 'NEEDS REVISION'}`\n  );\n  console.log('');\n  console.log(`   Claimed handoff size: ${claimedHandoff}`);\n  console.log(\n    `   Measured handoff size: ${formatNumber(avgHandoffTokens)} tokens`\n  );\n  console.log(\n    `   Status: ${avgHandoffTokens >= 1000 && avgHandoffTokens <= 5000 ? 'VALIDATED' : 'NEEDS REVISION'}`\n  );\n  console.log('');\n  console.log(`   Claimed conversation: ${claimedConversation}`);\n  console.log(\n    `   Measured conversation: ${formatNumber(avgConversationTokens)} tokens`\n  );\n  console.log(\n    `   Status: ${avgConversationTokens >= 50000 && avgConversationTokens <= 150000 ? 'VALIDATED' : 'NEEDS REVISION'}`\n  );\n}\n\nmain().catch(console.error);\n"],
+  "mappings": "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",
+  "names": ["content"]
+}

package/dist/scripts/query-chromadb.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env tsx
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { ChromaClient } from "chromadb";
+import dotenv from "dotenv";
+import chalk from "chalk";
+dotenv.config();
+async function queryChromaDB() {
+  const apiKey = process.env.CHROMADB_API_KEY;
+  const tenant = process.env.CHROMADB_TENANT;
+  const database = process.env.CHROMADB_DATABASE || "stackmemory";
+  console.log(chalk.cyan("\u{1F50D} Querying ChromaDB Contexts\n"));
+  const client = new ChromaClient({
+    ssl: true,
+    host: "api.trychroma.com",
+    port: 443,
+    headers: {
+      "X-Chroma-Token": apiKey
+    },
+    tenant,
+    database
+  });
+  const collections = await client.listCollections();
+  console.log(chalk.yellow("\u{1F4DA} Available Collections:"));
+  collections.forEach((col) => {
+    console.log(`   - ${col.name}`);
+  });
+  console.log();
+  let collection;
+  try {
+    collection = await client.getCollection({
+      name: "claude_context"
+    });
+    console.log(chalk.green("\u2713 Using collection: claude_context\n"));
+  } catch {
+    collection = await client.getCollection({
+      name: "stackmemory_contexts"
+    });
+    console.log(chalk.green("\u2713 Using collection: stackmemory_contexts\n"));
+  }
+  console.log(chalk.yellow("\u{1F4CA} Collection Stats:"));
+  const count = await collection.count();
+  console.log(`   Total documents: ${count}
+`);
+  console.log(chalk.cyan("\u{1F4DA} All Stored Contexts:\n"));
+  const allDocs = await collection.get({
+    limit: 100
+  });
+  if (allDocs.ids.length > 0) {
+    for (let i = 0; i < allDocs.ids.length; i++) {
+      const metadata = allDocs.metadatas[i];
+      const document = allDocs.documents[i];
+      console.log(chalk.green(`${i + 1}. ${allDocs.ids[i]}`));
+      console.log(`   Type: ${metadata.type}`);
+      console.log(`   Timestamp: ${metadata.timestamp}`);
+      console.log(`   User: ${metadata.user_id}`);
+      console.log(`   Project: ${metadata.project}`);
+      console.log(`   Content: ${document?.substring(0, 100)}...`);
+      console.log();
+    }
+  }
+  console.log(chalk.cyan('\n\u{1F50E} Search Results for "TypeScript lint error":\n'));
+  const searchResults = await collection.query({
+    queryTexts: ["TypeScript lint error fix"],
+    nResults: 5
+  });
+  if (searchResults.ids[0].length > 0) {
+    for (let i = 0; i < searchResults.ids[0].length; i++) {
+      const metadata = searchResults.metadatas[0][i];
+      const document = searchResults.documents[0][i];
+      const distance = searchResults.distances[0][i];
+      console.log(chalk.yellow(`Match ${i + 1} (distance: ${distance.toFixed(3)}):`));
+      console.log(`   ID: ${searchResults.ids[0][i]}`);
+      console.log(`   Type: ${metadata.type}`);
+      console.log(`   Timestamp: ${metadata.timestamp}`);
+      console.log(`   Content: ${document?.substring(0, 150)}...`);
+      console.log();
+    }
+  } else {
+    console.log("No results found");
+  }
+  console.log(chalk.cyan("\n\u{1F4CB} Recent Task Completions:\n"));
+  const taskCompletions = await collection.get({
+    where: {
+      type: "task_complete"
+    },
+    limit: 10
+  });
+  if (taskCompletions.ids.length > 0) {
+    for (let i = 0; i < taskCompletions.ids.length; i++) {
+      const metadata = taskCompletions.metadatas[i];
+      const document = taskCompletions.documents[i];
+      console.log(chalk.green(`Task ${i + 1}:`));
+      console.log(`   ID: ${taskCompletions.ids[i]}`);
+      console.log(`   Timestamp: ${metadata.timestamp}`);
+      console.log(`   Task ID: ${metadata.task_id}`);
+      console.log(`   Duration: ${metadata.duration}ms`);
+      console.log(`   Files Changed: ${metadata.files_changed}`);
+      console.log(`   Content: ${document?.substring(0, 100)}...`);
+      console.log();
+    }
+  } else {
+    console.log("No task completions found");
+  }
+  console.log(chalk.cyan("\n\u23F0 Periodic Checkpoints:\n"));
+  const periodicSaves = await collection.get({
+    where: {
+      type: "periodic_save"
+    },
+    limit: 10
+  });
+  if (periodicSaves.ids.length > 0) {
+    for (let i = 0; i < periodicSaves.ids.length; i++) {
+      const metadata = periodicSaves.metadatas[i];
+      const document = periodicSaves.documents[i];
+      console.log(chalk.blue(`Checkpoint ${i + 1}:`));
+      console.log(`   Timestamp: ${metadata.timestamp}`);
+      console.log(`   Interval: ${metadata.interval}`);
+      console.log(`   Active Files: ${metadata.active_files}`);
+      console.log(`   Git Status: ${document?.substring(0, 150)}...`);
+      console.log();
+    }
+  } else {
+    console.log("No periodic saves found");
+  }
+  console.log(chalk.cyan("\n\u{1F4A1} Decisions Made:\n"));
+  const decisions = await collection.get({
+    where: {
+      type: "decision_made"
+    },
+    limit: 10
+  });
+  if (decisions.ids.length > 0) {
+    for (let i = 0; i < decisions.ids.length; i++) {
+      const metadata = decisions.metadatas[i];
+      const document = decisions.documents[i];
+      console.log(chalk.magenta(`Decision ${i + 1}:`));
+      console.log(`   Category: ${metadata.category}`);
+      console.log(`   Alternatives: ${metadata.alternatives}`);
+      console.log(`   Reasoning: ${metadata.reasoning}`);
+      console.log(`   Decision: ${document?.substring(0, 200)}...`);
+      console.log();
+    }
+  } else {
+    console.log("No decisions found");
+  }
+  console.log(chalk.cyan("\n\u{1F4C8} Context Types Summary:\n"));
+  const types = /* @__PURE__ */ new Map();
+  for (let i = 0; i < allDocs.ids.length; i++) {
+    const type = allDocs.metadatas[i].type || "unknown";
+    types.set(type, (types.get(type) || 0) + 1);
+  }
+  for (const [type, count2] of types.entries()) {
+    console.log(`   ${type}: ${count2} documents`);
+  }
+}
+queryChromaDB().catch(console.error);
+//# sourceMappingURL=query-chromadb.js.map

package/dist/scripts/query-chromadb.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../scripts/query-chromadb.ts"],
+  "sourcesContent": ["#!/usr/bin/env tsx\n\n/**\n * Query ChromaDB for stored contexts\n */\n\nimport { ChromaClient } from 'chromadb';\nimport dotenv from 'dotenv';\nimport chalk from 'chalk';\n\n// Load environment variables\ndotenv.config();\n\nasync function queryChromaDB() {\n  const apiKey = process.env.CHROMADB_API_KEY;\n  const tenant = process.env.CHROMADB_TENANT;\n  const database = process.env.CHROMADB_DATABASE || 'stackmemory';\n\n  console.log(chalk.cyan('\uD83D\uDD0D Querying ChromaDB Contexts\\n'));\n\n  // Connect to ChromaDB\n  const client = new ChromaClient({\n    ssl: true,\n    host: 'api.trychroma.com',\n    port: 443,\n    headers: {\n      'X-Chroma-Token': apiKey\n    },\n    tenant: tenant,\n    database: database\n  });\n\n  // List all collections first\n  const collections = await client.listCollections();\n  console.log(chalk.yellow('\uD83D\uDCDA Available Collections:'));\n  collections.forEach(col => {\n    console.log(`   - ${col.name}`);\n  });\n  console.log();\n\n  // Get collection - try claude_context first (from hooks), then stackmemory_contexts\n  let collection;\n  try {\n    collection = await client.getCollection({\n      name: 'claude_context'\n    });\n    console.log(chalk.green('\u2713 Using collection: claude_context\\n'));\n  } catch {\n    collection = await client.getCollection({\n      name: 'stackmemory_contexts'\n    });\n    console.log(chalk.green('\u2713 Using collection: stackmemory_contexts\\n'));\n  }\n\n  console.log(chalk.yellow('\uD83D\uDCCA Collection Stats:'));\n  const count = await collection.count();\n  console.log(`   Total documents: ${count}\\n`);\n\n  // Query 1: Get all documents\n  console.log(chalk.cyan('\uD83D\uDCDA All Stored Contexts:\\n'));\n  \n  const allDocs = await collection.get({\n    limit: 100\n  });\n\n  if (allDocs.ids.length > 0) {\n    for (let i = 0; i < allDocs.ids.length; i++) {\n      const metadata = allDocs.metadatas[i];\n      const document = allDocs.documents[i];\n      \n      console.log(chalk.green(`${i + 1}. ${allDocs.ids[i]}`));\n      console.log(`   Type: ${metadata.type}`);\n      console.log(`   Timestamp: ${metadata.timestamp}`);\n      console.log(`   User: ${metadata.user_id}`);\n      console.log(`   Project: ${metadata.project}`);\n      console.log(`   Content: ${document?.substring(0, 100)}...`);\n      console.log();\n    }\n  }\n\n  // Query 2: Search for specific content\n  console.log(chalk.cyan('\\n\uD83D\uDD0E Search Results for \"TypeScript lint error\":\\n'));\n  \n  const searchResults = await collection.query({\n    queryTexts: ['TypeScript lint error fix'],\n    nResults: 5\n  });\n\n  if (searchResults.ids[0].length > 0) {\n    for (let i = 0; i < searchResults.ids[0].length; i++) {\n      const metadata = searchResults.metadatas[0][i];\n      const document = searchResults.documents[0][i];\n      const distance = searchResults.distances[0][i];\n      \n      console.log(chalk.yellow(`Match ${i + 1} (distance: ${distance.toFixed(3)}):`));\n      console.log(`   ID: ${searchResults.ids[0][i]}`);\n      console.log(`   Type: ${metadata.type}`);\n      console.log(`   Timestamp: ${metadata.timestamp}`);\n      console.log(`   Content: ${document?.substring(0, 150)}...`);\n      console.log();\n    }\n  } else {\n    console.log('No results found');\n  }\n\n  // Query 3: Filter by metadata\n  console.log(chalk.cyan('\\n\uD83D\uDCCB Recent Task Completions:\\n'));\n  \n  const taskCompletions = await collection.get({\n    where: {\n      type: 'task_complete'\n    },\n    limit: 10\n  });\n\n  if (taskCompletions.ids.length > 0) {\n    for (let i = 0; i < taskCompletions.ids.length; i++) {\n      const metadata = taskCompletions.metadatas[i];\n      const document = taskCompletions.documents[i];\n      \n      console.log(chalk.green(`Task ${i + 1}:`));\n      console.log(`   ID: ${taskCompletions.ids[i]}`);\n      console.log(`   Timestamp: ${metadata.timestamp}`);\n      console.log(`   Task ID: ${metadata.task_id}`);\n      console.log(`   Duration: ${metadata.duration}ms`);\n      console.log(`   Files Changed: ${metadata.files_changed}`);\n      console.log(`   Content: ${document?.substring(0, 100)}...`);\n      console.log();\n    }\n  } else {\n    console.log('No task completions found');\n  }\n\n  // Query 4: Get periodic saves\n  console.log(chalk.cyan('\\n\u23F0 Periodic Checkpoints:\\n'));\n  \n  const periodicSaves = await collection.get({\n    where: {\n      type: 'periodic_save'\n    },\n    limit: 10\n  });\n\n  if (periodicSaves.ids.length > 0) {\n    for (let i = 0; i < periodicSaves.ids.length; i++) {\n      const metadata = periodicSaves.metadatas[i];\n      const document = periodicSaves.documents[i];\n      \n      console.log(chalk.blue(`Checkpoint ${i + 1}:`));\n      console.log(`   Timestamp: ${metadata.timestamp}`);\n      console.log(`   Interval: ${metadata.interval}`);\n      console.log(`   Active Files: ${metadata.active_files}`);\n      console.log(`   Git Status: ${document?.substring(0, 150)}...`);\n      console.log();\n    }\n  } else {\n    console.log('No periodic saves found');\n  }\n\n  // Query 5: Get decisions\n  console.log(chalk.cyan('\\n\uD83D\uDCA1 Decisions Made:\\n'));\n  \n  const decisions = await collection.get({\n    where: {\n      type: 'decision_made'\n    },\n    limit: 10\n  });\n\n  if (decisions.ids.length > 0) {\n    for (let i = 0; i < decisions.ids.length; i++) {\n      const metadata = decisions.metadatas[i];\n      const document = decisions.documents[i];\n      \n      console.log(chalk.magenta(`Decision ${i + 1}:`));\n      console.log(`   Category: ${metadata.category}`);\n      console.log(`   Alternatives: ${metadata.alternatives}`);\n      console.log(`   Reasoning: ${metadata.reasoning}`);\n      console.log(`   Decision: ${document?.substring(0, 200)}...`);\n      console.log();\n    }\n  } else {\n    console.log('No decisions found');\n  }\n\n  // Query 6: Group by type\n  console.log(chalk.cyan('\\n\uD83D\uDCC8 Context Types Summary:\\n'));\n  \n  const types = new Map();\n  for (let i = 0; i < allDocs.ids.length; i++) {\n    const type = allDocs.metadatas[i].type || 'unknown';\n    types.set(type, (types.get(type) || 0) + 1);\n  }\n\n  for (const [type, count] of types.entries()) {\n    console.log(`   ${type}: ${count} documents`);\n  }\n}\n\n// Run query\nqueryChromaDB().catch(console.error);"],
+  "mappings": "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",
+  "names": ["count"]
+}