@stackmemoryai/stackmemory 0.5.64 → 0.5.67

package/dist/src/skills/spec-generator-skill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/skills/spec-generator-skill.ts"],
+  "sourcesContent": ["/**\n * Spec Generator Skill\n * Generates iterative spec documents: ONE_PAGER \u2192 DEV_SPEC \u2192 PROMPT_PLAN \u2192 AGENTS.md\n * Progressive context \u2014 later docs read earlier ones from disk.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { SkillContext, SkillResult } from './claude-skills.js';\nimport { logger } from '../core/monitoring/logger.js';\n\nexport type SpecType = 'one-pager' | 'dev-spec' | 'prompt-plan' | 'agents';\n\ninterface SpecConfig {\n  filename: string;\n  title: string;\n  sections: string[];\n  inputs: SpecType[]; // earlier docs this type reads\n}\n\nconst SPEC_DIR = 'docs/specs';\n\nconst SPEC_CONFIGS: Record<SpecType, SpecConfig> = {\n  'one-pager': {\n    filename: 'ONE_PAGER.md',\n    title: 'One-Pager',\n    sections: [\n      'Problem',\n      'Audience',\n      'Platform',\n      'Core Flow',\n      'MVP Features',\n      'Non-Goals',\n      'Metrics',\n    ],\n    inputs: [],\n  },\n  'dev-spec': {\n    filename: 'DEV_SPEC.md',\n    title: 'Development Specification',\n    sections: [\n      'Architecture',\n      'Tech Stack',\n      'API Contracts',\n      'Data Models',\n      'Auth',\n      'Error Handling',\n      'Deployment',\n    ],\n    inputs: ['one-pager'],\n  },\n  'prompt-plan': {\n    filename: 'PROMPT_PLAN.md',\n    title: 'Prompt Plan',\n    sections: [\n      'Stage A: Project Setup',\n      'Stage B: Core Data Models',\n      'Stage C: API Layer',\n      'Stage D: Business Logic',\n      'Stage E: Frontend / UI',\n      'Stage F: Integration & Testing',\n      'Stage G: Deploy & Polish',\n    ],\n    inputs: ['one-pager', 'dev-spec'],\n  },\n  agents: {\n    filename: 'AGENTS.md',\n    title: 'AGENTS.md',\n    sections: [\n      'Repo Files',\n      'Responsibilities',\n      'Guardrails',\n      'Testing',\n      'When to Ask',\n    ],\n    inputs: ['one-pager', 'dev-spec', 'prompt-plan'],\n  },\n};\n\n// --- Templates ---\n\nfunction onePagerTemplate(title: string): string {\n  return `# ${title} \u2014 One-Pager\n\n## Problem\n<!-- What problem does this solve? Who has this problem? -->\n\n## Audience\n<!-- Primary users and their context -->\n\n## Platform\n<!-- Web / Mobile / CLI / API \u2014 and why -->\n\n## Core Flow\n<!-- Happy-path user journey in 3-5 steps -->\n1.\n2.\n3.\n\n## MVP Features\n<!-- Minimum set of features for first release -->\n- [ ]\n- [ ]\n- [ ]\n\n## Non-Goals\n<!-- Explicitly out of scope for MVP -->\n-\n\n## Metrics\n<!-- How will you measure success? -->\n-\n`;\n}\n\nfunction devSpecTemplate(title: string, onePagerContent: string): string {\n  return `# ${title} \u2014 Development Specification\n\n> Generated from ONE_PAGER.md\n\n<details><summary>Source: ONE_PAGER.md</summary>\n\n${onePagerContent}\n\n</details>\n\n## Architecture\n<!-- High-level system diagram / component breakdown -->\n\n## Tech Stack\n<!-- Languages, frameworks, databases, infra -->\n| Layer | Choice | Rationale |\n|-------|--------|-----------|\n| Frontend | | |\n| Backend | | |\n| Database | | |\n| Hosting | | |\n\n## API Contracts\n<!-- Key endpoints with request/response shapes -->\n\n## Data Models\n<!-- Core entities and relationships -->\n\n## Auth\n<!-- Authentication and authorization strategy -->\n\n## Error Handling\n<!-- Error codes, retry strategies, user-facing messages -->\n\n## Deployment\n<!-- CI/CD, environments, rollback strategy -->\n`;\n}\n\nfunction promptPlanTemplate(\n  title: string,\n  onePagerContent: string,\n  devSpecContent: string\n): string {\n  return `# ${title} \u2014 Prompt Plan\n\n> Generated from ONE_PAGER.md and DEV_SPEC.md\n> Each stage has TDD checkboxes \u2014 check off as tasks complete.\n\n<details><summary>Source: ONE_PAGER.md</summary>\n\n${onePagerContent}\n\n</details>\n\n<details><summary>Source: DEV_SPEC.md</summary>\n\n${devSpecContent}\n\n</details>\n\n## Stage A: Project Setup\n- [ ] Initialize repository and tooling\n- [ ] Configure CI/CD pipeline\n- [ ] Set up development environment\n\n## Stage B: Core Data Models\n- [ ] Define database schema\n- [ ] Create model layer\n- [ ] Write model tests\n\n## Stage C: API Layer\n- [ ] Implement API endpoints\n- [ ] Add input validation\n- [ ] Write API tests\n\n## Stage D: Business Logic\n- [ ] Implement core business rules\n- [ ] Add edge case handling\n- [ ] Write integration tests\n\n## Stage E: Frontend / UI\n- [ ] Build core UI components\n- [ ] Implement user flows\n- [ ] Write UI tests\n\n## Stage F: Integration & Testing\n- [ ] End-to-end test suite\n- [ ] Performance testing\n- [ ] Security audit\n\n## Stage G: Deploy & Polish\n- [ ] Production deployment\n- [ ] Monitoring and alerting\n- [ ] Documentation\n`;\n}\n\nfunction agentsTemplate(title: string, inputs: Record<string, string>): string {\n  const sourceBlocks = Object.entries(inputs)\n    .map(\n      ([name, content]) =>\n        `<details><summary>Source: ${name}</summary>\\n\\n${content}\\n\\n</details>`\n    )\n    .join('\\n\\n');\n\n  return `# ${title} \u2014 AGENTS.md\n\n> Auto-generated agent configuration for Claude Code / Cursor / Windsurf.\n\n${sourceBlocks}\n\n## Repo Files\n<!-- Key files and their purpose -->\n| File | Purpose |\n|------|---------|\n| | |\n\n## Responsibilities\n<!-- What this agent should and shouldn't do -->\n### DO\n-\n\n### DON'T\n-\n\n## Guardrails\n<!-- Safety constraints and limits -->\n- Never commit secrets or credentials\n- Always run tests before committing\n- Keep changes focused and atomic\n\n## Testing\n<!-- How to validate changes -->\n\\`\\`\\`bash\nnpm test\nnpm run lint\nnpm run build\n\\`\\`\\`\n\n## When to Ask\n<!-- Situations where the agent should ask for human input -->\n- Architectural changes affecting multiple systems\n- Security-sensitive modifications\n- Breaking API changes\n- Ambiguous requirements\n`;\n}\n\n// --- Skill Class ---\n\nexport class SpecGeneratorSkill {\n  private baseDir: string;\n\n  constructor(private context: SkillContext) {\n    this.baseDir = process.cwd();\n  }\n\n  /** Generate a spec document by type */\n  async generate(\n    type: SpecType,\n    title: string,\n    opts?: { force?: boolean }\n  ): Promise<SkillResult> {\n    const config = SPEC_CONFIGS[type];\n    if (!config) {\n      return { success: false, message: `Unknown spec type: ${type}` };\n    }\n\n    const specDir = path.join(this.baseDir, SPEC_DIR);\n    const outputPath = path.join(specDir, config.filename);\n\n    // Check if file already exists\n    if (fs.existsSync(outputPath) && !opts?.force) {\n      return {\n        success: false,\n        message: `${config.filename} already exists. Use --force to overwrite.`,\n        data: { path: outputPath },\n      };\n    }\n\n    // Load input documents (progressive context)\n    const inputContents: Record<string, string> = {};\n    for (const inputType of config.inputs) {\n      const inputConfig = SPEC_CONFIGS[inputType];\n      const inputPath = path.join(specDir, inputConfig.filename);\n      if (fs.existsSync(inputPath)) {\n        inputContents[inputConfig.filename] = fs.readFileSync(\n          inputPath,\n          'utf-8'\n        );\n      }\n    }\n\n    // Generate content from template\n    const content = this.renderTemplate(type, title, inputContents);\n\n    // Write file\n    fs.mkdirSync(specDir, { recursive: true });\n    fs.writeFileSync(outputPath, content, 'utf-8');\n\n    logger.info(`Generated spec: ${config.filename}`, { type, title });\n\n    return {\n      success: true,\n      message: `Created ${config.filename}`,\n      data: {\n        path: outputPath,\n        type,\n        sections: config.sections,\n        inputsUsed: Object.keys(inputContents),\n      },\n      action: `Generated ${SPEC_DIR}/${config.filename}`,\n    };\n  }\n\n  /** List existing spec documents */\n  async list(): Promise<SkillResult> {\n    const specDir = path.join(this.baseDir, SPEC_DIR);\n    const specs: Array<{\n      type: SpecType;\n      filename: string;\n      exists: boolean;\n      path: string;\n    }> = [];\n\n    for (const [type, config] of Object.entries(SPEC_CONFIGS)) {\n      const filePath = path.join(specDir, config.filename);\n      specs.push({\n        type: type as SpecType,\n        filename: config.filename,\n        exists: fs.existsSync(filePath),\n        path: filePath,\n      });\n    }\n\n    const existing = specs.filter((s) => s.exists);\n    const missing = specs.filter((s) => !s.exists);\n\n    return {\n      success: true,\n      message: `${existing.length}/${specs.length} specs exist`,\n      data: { specs, existing, missing },\n    };\n  }\n\n  /** Update a spec \u2014 primarily for checking off PROMPT_PLAN items */\n  async update(filePath: string, changes: string): Promise<SkillResult> {\n    const resolvedPath = path.isAbsolute(filePath)\n      ? filePath\n      : path.join(this.baseDir, filePath);\n\n    if (!fs.existsSync(resolvedPath)) {\n      return { success: false, message: `File not found: ${resolvedPath}` };\n    }\n\n    let content = fs.readFileSync(resolvedPath, 'utf-8');\n\n    // Parse checkbox updates: \"Stage A:1\" means check item 1 in Stage A\n    const checkboxPattern = /^(Stage [A-G])(?::(\\d+))?$/;\n    const match = changes.match(checkboxPattern);\n\n    if (match) {\n      const [, stageName, itemNum] = match;\n      content = this.checkItem(\n        content,\n        stageName,\n        itemNum ? parseInt(itemNum) : undefined\n      );\n    } else {\n      // Treat as direct checkbox text match: find \"- [ ] <changes>\" and check it\n      const escaped = changes.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n      const re = new RegExp(`- \\\\[ \\\\] ${escaped}`, 'i');\n      if (re.test(content)) {\n        content = content.replace(re, `- [x] ${changes}`);\n      } else {\n        return {\n          success: false,\n          message: `No unchecked item matching \"${changes}\" found`,\n        };\n      }\n    }\n\n    // Append changelog entry\n    const timestamp = new Date().toISOString().slice(0, 19).replace('T', ' ');\n    const changelog = `\\n<!-- Updated: ${timestamp} | ${changes} -->\\n`;\n    content += changelog;\n\n    fs.writeFileSync(resolvedPath, content, 'utf-8');\n\n    logger.info('Updated spec', { path: resolvedPath, changes });\n\n    return {\n      success: true,\n      message: `Updated: ${changes}`,\n      data: { path: resolvedPath, changes },\n      action: `Checked off item in ${path.basename(resolvedPath)}`,\n    };\n  }\n\n  /** Validate completeness of a spec */\n  async validate(filePath: string): Promise<SkillResult> {\n    const resolvedPath = path.isAbsolute(filePath)\n      ? filePath\n      : path.join(this.baseDir, filePath);\n\n    if (!fs.existsSync(resolvedPath)) {\n      return { success: false, message: `File not found: ${resolvedPath}` };\n    }\n\n    const content = fs.readFileSync(resolvedPath, 'utf-8');\n\n    // Count checkboxes\n    const unchecked = (content.match(/- \\[ \\]/g) || []).length;\n    const checked = (content.match(/- \\[x\\]/gi) || []).length;\n    const total = checked + unchecked;\n\n    // Check for empty sections (## header followed by only whitespace/comments)\n    const emptySections: string[] = [];\n    const sectionRegex = /^## (.+)$/gm;\n    let sectionMatch;\n\n    while ((sectionMatch = sectionRegex.exec(content)) !== null) {\n      const sectionName = sectionMatch[1];\n      const sectionStart = content.indexOf(sectionMatch[0]);\n      const nextSection = content.indexOf('\\n## ', sectionStart + 1);\n      const sectionContent =\n        nextSection === -1\n          ? content.slice(sectionStart + sectionMatch[0].length)\n          : content.slice(sectionStart + sectionMatch[0].length, nextSection);\n\n      // Strip comments and whitespace\n      const stripped = sectionContent\n        .replace(/<!--.*?-->/gs, '')\n        .replace(/\\s+/g, '')\n        .trim();\n\n      if (stripped.length === 0 || stripped === '||') {\n        emptySections.push(sectionName);\n      }\n    }\n\n    const isComplete = unchecked === 0 && emptySections.length === 0;\n\n    return {\n      success: true,\n      message: isComplete\n        ? 'Spec is complete'\n        : `Spec incomplete: ${unchecked} unchecked items, ${emptySections.length} empty sections`,\n      data: {\n        path: resolvedPath,\n        checkboxes: { checked, unchecked, total },\n        emptySections,\n        isComplete,\n        completionPercent:\n          total > 0 ? Math.round((checked / total) * 100) : 100,\n      },\n    };\n  }\n\n  // --- Private helpers ---\n\n  private renderTemplate(\n    type: SpecType,\n    title: string,\n    inputs: Record<string, string>\n  ): string {\n    switch (type) {\n      case 'one-pager':\n        return onePagerTemplate(title);\n\n      case 'dev-spec':\n        return devSpecTemplate(\n          title,\n          inputs['ONE_PAGER.md'] ||\n            '*ONE_PAGER.md not found \u2014 generate it first.*'\n        );\n\n      case 'prompt-plan':\n        return promptPlanTemplate(\n          title,\n          inputs['ONE_PAGER.md'] || '*ONE_PAGER.md not found*',\n          inputs['DEV_SPEC.md'] ||\n            '*DEV_SPEC.md not found \u2014 generate it first.*'\n        );\n\n      case 'agents':\n        return agentsTemplate(title, inputs);\n\n      default:\n        return `# ${title}\\n\\nUnknown spec type: ${type}\\n`;\n    }\n  }\n\n  /** Check off a specific checkbox item in a stage */\n  private checkItem(\n    content: string,\n    stageName: string,\n    itemIndex?: number\n  ): string {\n    const lines = content.split('\\n');\n    let inStage = false;\n    let itemCount = 0;\n\n    for (let i = 0; i < lines.length; i++) {\n      // Detect stage header\n      if (lines[i].startsWith('## ') && lines[i].includes(stageName)) {\n        inStage = true;\n        itemCount = 0;\n        continue;\n      }\n\n      // Exit stage on next header\n      if (inStage && lines[i].startsWith('## ')) {\n        break;\n      }\n\n      // Process checkbox\n      if (inStage && lines[i].match(/^- \\[ \\]/)) {\n        itemCount++;\n        if (itemIndex === undefined || itemCount === itemIndex) {\n          lines[i] = lines[i].replace('- [ ]', '- [x]');\n          if (itemIndex !== undefined) break;\n        }\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "0.5.64",
-  "description": "Lossless memory runtime for AI coding tools - call stack context, predictive edits, AI code review, prompt optimization, model switching, and mobile sync",
+  "version": "0.5.67",
+  "description": "Project-scoped memory for AI coding tools. Durable context across sessions with MCP integration, frames, and smart retrieval.",
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=10.0.0"
@@ -18,6 +18,7 @@
   },
   "types": "dist/src/index.d.ts",
   "files": [
+    "bin",
     "dist",
     "scripts",
     "templates",
@@ -49,8 +50,8 @@
     "model-routing"
   ],
   "scripts": {
-    "start": "node dist/integrations/mcp/server.js",
-    "start:full": "node dist/integrations/mcp/server.js",
+    "start": "node dist/src/integrations/mcp/server.js",
+    "start:full": "node dist/src/integrations/mcp/server.js",
     "setup": "npm install && npm run build && npm run init",
     "postinstall": "node scripts/install-claude-hooks-auto.js || true",
     "init": "node dist/scripts/initialize.js",
@@ -65,11 +66,11 @@
     "test:run": "vitest run",
     "test:pre-publish": "./scripts/test-pre-publish-quick.sh",
     "test:pre-commit": "vitest related --run --reporter=dot --silent --bail=1",
-    "prepublishOnly": "npm run build && npm run test:pre-publish",
+    "prepublishOnly": "npm run build && npm run verify:dist && npm run test:pre-publish",
     "quality": "npm run lint && npm run test:run && npm run build",
-    "dev": "tsx watch src/mcp/mcp-server.ts",
-    "mcp:start": "node dist/integrations/mcp/server.js",
-    "mcp:dev": "tsx src/mcp/mcp-server.ts",
+    "dev": "tsx watch src/integrations/mcp/server.ts",
+    "mcp:start": "node dist/src/integrations/mcp/server.js",
+    "mcp:dev": "tsx src/integrations/mcp/server.ts",
     "status": "node dist/scripts/status.js",
     "linear:sync": "node scripts/sync-linear-graphql.js",
     "linear:mirror": "node scripts/sync-linear-graphql.js --mirror",
@@ -86,7 +87,10 @@
     "daemon:status": "node dist/cli/index.js daemon status",
     "sync:start": "node scripts/background-sync-manager.js",
     "sync:setup": "./scripts/setup-background-sync.sh",
-    "prepare": "echo 'Prepare step completed'"
+    "prepare": "echo 'Prepare step completed'",
+    "verify:dist": "node scripts/verify-dist.cjs",
+    "rebuild:native": "npm rebuild better-sqlite3 || true",
+    "deps:reset": "rm -rf node_modules package-lock.json && npm ci"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
@@ -115,6 +119,7 @@
     "inquirer": "^9.3.8",
     "msgpackr": "^1.10.1",
     "ngrok": "^5.0.0-beta.2",
+    "node-pty": "^1.1.0",
     "open": "^11.0.0",
     "ora": "^9.0.0",
     "pg": "^8.17.1",

package/scripts/claude-code-wrapper.sh

@@ -3,62 +3,50 @@
 # Claude Code wrapper with StackMemory integration
 # Usage: Add alias to ~/.zshrc: alias claude='~/Dev/stackmemory/scripts/claude-code-wrapper.sh'
 
-# Check for auto-sync flag
+# Check for auto-sync flag and filter wrapper-specific args
 AUTO_SYNC=false
 SYNC_INTERVAL=5
+CLAUDE_ARGS=()
+
 for arg in "$@"; do
     case $arg in
         --auto-sync)
             AUTO_SYNC=true
-            shift
             ;;
         --sync-interval=*)
             SYNC_INTERVAL="${arg#*=}"
-            shift
+            ;;
+        *)
+            CLAUDE_ARGS+=("$arg")
             ;;
     esac
 done
 
-# Start Linear auto-sync in background if requested
-SYNC_PID=""
+# Start Linear auto-sync in background if requested (survives exec)
 if [ "$AUTO_SYNC" = true ] && [ -n "$LINEAR_API_KEY" ]; then
     echo "🔄 Starting Linear auto-sync (${SYNC_INTERVAL}min intervals)..."
-    (
+    nohup bash -c "
         while true; do
             sleep $((SYNC_INTERVAL * 60))
-            if [ -d ".stackmemory" ]; then
+            if [ -d \"$PWD/.stackmemory\" ]; then
                 stackmemory linear sync --quiet 2>/dev/null || true
             fi
         done
-    ) &
-    SYNC_PID=$!
+    " > /dev/null 2>&1 &
+    disown
 fi
 
-cleanup() {
-    echo "📝 Saving StackMemory context..."
-    
-    # Kill auto-sync if running
-    if [ -n "$SYNC_PID" ] && kill -0 $SYNC_PID 2>/dev/null; then
-        echo "🛑 Stopping auto-sync..."
-        kill $SYNC_PID 2>/dev/null || true
-    fi
-    
-    # Check if in a git repo with stackmemory
-    if [ -d ".stackmemory" ] && [ -f "stackmemory.json" ]; then
-        # Save current context (without sync)
-        stackmemory status 2>/dev/null || true
-        echo "✅ StackMemory context saved"
-    fi
-}
+# Note: Cleanup is now handled by Claude hooks instead of this wrapper
+# See: stackmemory setup-hooks --cleanup
 
-# Set trap for exit signals
-trap cleanup EXIT INT TERM
+# Run Claude Code with exec for full TTY control (interactive mode)
+# This replaces the shell process, ensuring stdin works properly
+# Note: cleanup trap won't run with exec - use Claude hooks for session cleanup instead
 
-# Run Claude Code (try multiple possible command names)
 if command -v claude-code &> /dev/null; then
-    claude-code "$@"
+    exec claude-code "${CLAUDE_ARGS[@]}"
 elif command -v claude &> /dev/null; then
-    claude "$@"
+    exec claude "${CLAUDE_ARGS[@]}"
 else
     echo "❌ Claude Code not found. Please install it first."
     echo "   Visit: https://github.com/anthropics/claude-code"

package/scripts/demos/ralph-integration-demo.ts

@@ -5,7 +5,6 @@
  */
 
 import { RalphStackMemoryBridge } from './bridge/ralph-stackmemory-bridge.js';
-import { logger } from '../../core/monitoring/logger.js';
 import { RalphStackMemoryConfig } from './types.js';
 
 class RalphIntegrationDemo {
@@ -60,9 +59,12 @@ class RalphIntegrationDemo {
       await this.demonstrateMetrics();
 
       console.log('\n✅ Demo completed successfully!\n');
-    } catch (error: any) {
-      console.error('\n❌ Demo failed:', error.message);
-      throw error;
+    } catch (err: unknown) {
+      console.error(
+        '\n❌ Demo failed:',
+        err instanceof Error ? err.message : err
+      );
+      throw err;
     } finally {
       await this.cleanup();
     }
@@ -158,9 +160,6 @@ class RalphIntegrationDemo {
     console.log('\n🚑 Phase 3: Crash Recovery');
     console.log('===========================');
 
-    // Simulate getting session ID
-    const sessionId = 'demo-session-123';
-
     try {
       console.log('🔄 Simulating session rehydration...');
 
@@ -177,8 +176,10 @@ class RalphIntegrationDemo {
       console.log('  - State reconciled: 0.3s');
       console.log('  - Memory usage: 45MB');
       console.log('  - Cache hit rate: 78%');
-    } catch (error: any) {
-      console.log(`⚠️  Recovery simulation: ${error.message}`);
+    } catch (err: unknown) {
+      console.log(
+        `⚠️  Recovery simulation: ${err instanceof Error ? err.message : err}`
+      );
     }
   }
 
@@ -227,10 +228,10 @@ async function main() {
 
   try {
     await demo.run();
-  } catch (error: any) {
-    console.error('Demo failed:', error.message);
-    if (process.env.DEBUG) {
-      console.error(error.stack);
+  } catch (err: unknown) {
+    console.error('Demo failed:', err instanceof Error ? err.message : err);
+    if (process.env.DEBUG && err instanceof Error) {
+      console.error(err.stack);
     }
     process.exit(1);
   }

package/scripts/demos/trace-demo.ts

@@ -6,33 +6,17 @@
 
 import {
   trace,
-  Trace,
-  TraceClass,
   enableVerboseTracing,
   createTracedDatabase,
   traceStep,
 } from './index.js';
-import { logger } from '../monitoring/logger.js';
-// Type-safe environment variable access
-function getEnv(key: string, defaultValue?: string): string {
-  const value = process.env[key];
-  if (value === undefined) {
-    if (defaultValue !== undefined) return defaultValue;
-    throw new Error(`Environment variable ${key} is required`);
-  }
-  return value;
-}
-
-function getOptionalEnv(key: string): string | undefined {
-  return process.env[key];
-}
 
 // Example class with tracing
 // @TraceClass() - decorators not enabled in tsconfig
 class ExampleService {
-  private data: Map<string, any> = new Map();
+  private data: Map<string, unknown> = new Map();
 
-  async fetchData(id: string): Promise<any> {
+  async fetchData(id: string): Promise<Record<string, unknown>> {
     // Simulate API call
     await this.delay(50);
 
@@ -43,7 +27,9 @@ class ExampleService {
     return { id, value: Math.random() };
   }
 
-  async processData(data: any): Promise<any> {
+  async processData(
+    data: Record<string, unknown>
+  ): Promise<Record<string, unknown>> {
     return traceStep('Data validation', async () => {
       await this.delay(20);
 
@@ -62,7 +48,7 @@ class ExampleService {
     });
   }
 
-  cacheData(key: string, value: any): void {
+  cacheData(key: string, value: unknown): void {
     trace.traceSync('function', 'cacheData', { key, value }, () => {
       this.data.set(key, value);
     });
@@ -161,7 +147,7 @@ async function runDemo() {
 
       try {
         await service.fetchData('error');
-      } catch (error: unknown) {
+      } catch {
         console.log('Error properly traced and handled\n');
       }
     });

package/scripts/demos/trace-test.ts

@@ -3,19 +3,31 @@
  */
 
 import LocalStackMemoryMCP from './server';
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+// Type for accessing private members in tests
+interface MCPTestInstance {
+  traceDetector: {
+    addToolCall: (call: {
+      id: string;
+      tool: string;
+      timestamp: number;
+      arguments: Record<string, unknown>;
+    }) => void;
+    flush: () => void;
+  };
+  handleGetTraceStatistics: (
+    args: Record<string, unknown>
+  ) => Promise<{ content: Array<{ text: string }> }>;
+  handleGetTraces: (args: {
+    limit: number;
+  }) => Promise<{ content: Array<{ text: string }> }>;
+}
 
 async function testTraceIntegration() {
   console.log('🧪 Testing Trace Detection in MCP Server\n');
 
-  // Mock minimal server setup
-  const mockServer = {
-    setRequestHandler: () => {},
-    connect: () => Promise.resolve(),
-  } as any;
-
   // Access the private methods through prototype
-  const MCPClass = LocalStackMemoryMCP as any;
+  const MCPClass = LocalStackMemoryMCP as unknown as new () => MCPTestInstance;
   const mcp = new MCPClass();
 
   // Simulate tool calls directly on the trace detector

package/scripts/install-claude-hooks.sh

@@ -99,7 +99,7 @@ MAX_FILE_SIZE=100000            # Max size per file (100KB)
 MAX_TOTAL_SIZE=500000           # Max total size (500KB)
 
 # Claude CLI settings
-CLAUDE_MODEL=claude-3-opus      # Model to use
+CLAUDE_MODEL=claude-sonnet-4-20250514      # Model to use
 CLAUDE_MAX_TOKENS=4000          # Max tokens per request
 
 # File patterns to check (regex)
@@ -130,4 +130,4 @@ echo ""
 echo "Environment variables you can set:"
 echo "  CLAUDE_AUTO_FIX=true         # Auto-apply suggested fixes"
 echo "  CLAUDE_REVIEW_ENABLED=false  # Skip code review"
-echo "  CLAUDE_TEST_ENABLED=false    # Skip test generation"
+echo "  CLAUDE_TEST_ENABLED=false    # Skip test generation"

package/scripts/verify-dist.cjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+// Verifies expected dist artifacts and bin launchers point to correct paths.
+// Exits non-zero with actionable messages on mismatch.
+
+const { readFileSync, existsSync } = require('fs');
+const { join } = require('path');
+
+function fail(msg) {
+  console.error(`ERROR: ${msg}`);
+  process.exitCode = 1;
+}
+
+function checkFile(path) {
+  if (!existsSync(path)) {
+    fail(`Missing built file: ${path}`);
+    return false;
+  }
+  return true;
+}
+
+function fileContains(path, substr) {
+  try {
+    const c = readFileSync(path, 'utf8');
+    if (!c.includes(substr)) {
+      fail(`Expected reference not found in ${path}: ${substr}`);
+      return false;
+    }
+    return true;
+  } catch (e) {
+    fail(`Unable to read ${path}: ${e.message}`);
+    return false;
+  }
+}
+
+function main() {
+  const dist = 'dist/src';
+
+  // 1) Core CLI and MCP server artifacts
+  const requiredFiles = [
+    join(dist, 'integrations/mcp/server.js'),
+    join(dist, 'cli/index.js'),
+    join(dist, 'cli/codex-sm.js'),
+    join(dist, 'cli/codex-sm-danger.js'),
+    join(dist, 'cli/claude-sm.js'),
+    join(dist, 'cli/claude-sm-danger.js'),
+  ];
+  requiredFiles.forEach(checkFile);
+
+  // 2) Bin launchers reference dist/src/* (ESM dynamic import)
+  fileContains('bin/codex-sm', "import('../dist/src/cli/codex-sm.js')");
+  fileContains('bin/codex-smd', "import('../dist/src/cli/codex-sm-danger.js')");
+  fileContains('bin/claude-sm', "import('../dist/src/cli/claude-sm.js')");
+  fileContains('bin/claude-smd', "import('../dist/src/cli/claude-sm-danger.js')");
+
+  // 3) package.json scripts point to correct paths
+  try {
+    const pkg = JSON.parse(readFileSync('package.json', 'utf8'));
+    const scripts = pkg.scripts || {};
+    const expectations = [
+      ['start', 'dist/src/integrations/mcp/server.js'],
+      ['start:full', 'dist/src/integrations/mcp/server.js'],
+      ['mcp:start', 'dist/src/integrations/mcp/server.js'],
+    ];
+    for (const [key, needle] of expectations) {
+      const val = scripts[key] || '';
+      if (!val.includes(needle)) {
+        fail(`scripts.${key} should reference ${needle}, found: ${val}`);
+      }
+    }
+  } catch (e) {
+    fail(`Failed to validate package.json scripts: ${e.message}`);
+  }
+
+  if (process.exitCode) {
+    console.error('\nOne or more checks failed. Run: npm run build');
+    console.error('Then re-run: npm run verify:dist');
+  } else {
+    console.log('verify-dist: OK');
+  }
+}
+
+main();
+

package/templates/claude-hooks/post-edit-sweep.js

@@ -15,6 +15,10 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+const SWEEP_STATE_DIR =
+  process.env.SWEEP_STATE_DIR ||
+  path.join(process.env.HOME || '/tmp', '.stackmemory');
+
 const CONFIG = {
   enabled: process.env.SWEEP_ENABLED !== 'false',
   maxRecentDiffs: 5,
@@ -46,16 +50,9 @@ const CONFIG = {
     '.svelte',
     '.astro',
   ],
-  stateFile: path.join(
-    process.env.HOME || '/tmp',
-    '.stackmemory',
-    'sweep-state.json'
-  ),
-  logFile: path.join(
-    process.env.HOME || '/tmp',
-    '.stackmemory',
-    'sweep-predictions.log'
-  ),
+  stateFile: path.join(SWEEP_STATE_DIR, 'sweep-state.json'),
+  logFile: path.join(SWEEP_STATE_DIR, 'sweep-predictions.log'),
+  // Python script stays at shared location (shared server)
   pythonScript: path.join(
     process.env.HOME || '/tmp',
     '.stackmemory',