@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/utils/process-cleanup.js

@@ -0,0 +1,136 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { logger } from "../core/monitoring/logger.js";
+const STACKMEMORY_PROCESS_PATTERNS = [
+  "stackmemory",
+  "ralph orchestrate",
+  "ralph swarm",
+  "ralph loop",
+  "hooks start"
+];
+function getStackmemoryProcesses() {
+  const processes = [];
+  try {
+    const psOutput = execSync(
+      "ps -eo pid,lstart,command 2>/dev/null || ps -eo pid,start,args 2>/dev/null",
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
+    );
+    const lines = psOutput.trim().split("\n").slice(1);
+    for (const line of lines) {
+      const isStackmemory = STACKMEMORY_PROCESS_PATTERNS.some(
+        (pattern) => line.toLowerCase().includes(pattern.toLowerCase())
+      );
+      if (!isStackmemory) continue;
+      const match = line.match(
+        /^\s*(\d+)\s+(\w+\s+\w+\s+\d+\s+[\d:]+\s+\d+)\s+(.+)$/
+      );
+      if (match) {
+        const pid = parseInt(match[1], 10);
+        const startTimeStr = match[2];
+        const command = match[3];
+        if (pid === process.pid) continue;
+        const startTime = new Date(startTimeStr);
+        const ageMs = Date.now() - startTime.getTime();
+        const ageHours = ageMs / (1e3 * 60 * 60);
+        processes.push({
+          pid,
+          command: command.slice(0, 100),
+          // Truncate long commands
+          startTime,
+          ageHours
+        });
+      }
+    }
+  } catch (error) {
+    logger.warn("Failed to get process list:", error);
+  }
+  return processes;
+}
+function hasRecentLogActivity(proc, maxAgeHours) {
+  const logDir = path.join(os.homedir(), ".stackmemory", "logs");
+  if (!fs.existsSync(logDir)) return false;
+  try {
+    const logFiles = fs.readdirSync(logDir).filter((f) => f.endsWith(".log"));
+    for (const logFile of logFiles) {
+      const logPath = path.join(logDir, logFile);
+      const stats = fs.statSync(logPath);
+      const logAgeHours = (Date.now() - stats.mtimeMs) / (1e3 * 60 * 60);
+      if (logAgeHours < maxAgeHours) {
+        try {
+          const content = fs.readFileSync(logPath, "utf-8").slice(-1e4);
+          if (content.includes(`pid:${proc.pid}`) || content.includes(`PID ${proc.pid}`)) {
+            proc.logFile = logPath;
+            proc.lastLogActivity = stats.mtime;
+            return true;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch (error) {
+    logger.warn("Failed to check log activity:", error);
+  }
+  return false;
+}
+function findStaleProcesses(maxAgeHours = 24) {
+  const allProcesses = getStackmemoryProcesses();
+  return allProcesses.filter((proc) => {
+    if (proc.ageHours < maxAgeHours) return false;
+    if (hasRecentLogActivity(proc, maxAgeHours)) return false;
+    return true;
+  });
+}
+function killStaleProcesses(processes, dryRun = false) {
+  const result = {
+    found: processes,
+    killed: [],
+    errors: []
+  };
+  for (const proc of processes) {
+    if (dryRun) {
+      logger.info(`[DRY RUN] Would kill PID ${proc.pid}: ${proc.command}`);
+      continue;
+    }
+    try {
+      process.kill(proc.pid, "SIGTERM");
+      result.killed.push(proc.pid);
+      logger.info(`Killed stale process ${proc.pid}: ${proc.command}`);
+    } catch (error) {
+      const err = error;
+      if (err.code === "ESRCH") {
+        result.killed.push(proc.pid);
+      } else {
+        result.errors.push({
+          pid: proc.pid,
+          error: err.message || "Unknown error"
+        });
+        logger.warn(`Failed to kill PID ${proc.pid}:`, err.message);
+      }
+    }
+  }
+  return result;
+}
+function cleanupStaleProcesses(options = {}) {
+  const { maxAgeHours = 24, dryRun = false } = options;
+  logger.info(`Looking for stale processes older than ${maxAgeHours}h...`);
+  const staleProcesses = findStaleProcesses(maxAgeHours);
+  if (staleProcesses.length === 0) {
+    logger.info("No stale processes found");
+    return { found: [], killed: [], errors: [] };
+  }
+  logger.info(`Found ${staleProcesses.length} stale process(es)`);
+  return killStaleProcesses(staleProcesses, dryRun);
+}
+export {
+  cleanupStaleProcesses,
+  findStaleProcesses,
+  getStackmemoryProcesses,
+  killStaleProcesses
+};
+//# sourceMappingURL=process-cleanup.js.map

package/dist/src/utils/process-cleanup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/process-cleanup.ts"],
+  "sourcesContent": ["/**\n * Process Cleanup Utility\n * Automatically cleans up stale stackmemory processes older than 24h\n * with no recent log activity.\n */\n\nimport { execSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { logger } from '../core/monitoring/logger.js';\n\nexport interface StaleProcess {\n  pid: number;\n  command: string;\n  startTime: Date;\n  ageHours: number;\n  logFile?: string;\n  lastLogActivity?: Date;\n}\n\nexport interface CleanupResult {\n  found: StaleProcess[];\n  killed: number[];\n  errors: Array<{ pid: number; error: string }>;\n}\n\nconst STACKMEMORY_PROCESS_PATTERNS = [\n  'stackmemory',\n  'ralph orchestrate',\n  'ralph swarm',\n  'ralph loop',\n  'hooks start',\n];\n\n/**\n * Get all running stackmemory-related processes\n */\nexport function getStackmemoryProcesses(): StaleProcess[] {\n  const processes: StaleProcess[] = [];\n\n  try {\n    // Get process list with start time (macOS/Linux compatible)\n    const psOutput = execSync(\n      'ps -eo pid,lstart,command 2>/dev/null || ps -eo pid,start,args 2>/dev/null',\n      { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }\n    );\n\n    const lines = psOutput.trim().split('\\n').slice(1); // Skip header\n\n    for (const line of lines) {\n      // Check if it's a stackmemory process\n      const isStackmemory = STACKMEMORY_PROCESS_PATTERNS.some((pattern) =>\n        line.toLowerCase().includes(pattern.toLowerCase())\n      );\n\n      if (!isStackmemory) continue;\n\n      // Parse the line - format varies by OS\n      // macOS: PID \"Day Mon DD HH:MM:SS YYYY\" COMMAND\n      const match = line.match(\n        /^\\s*(\\d+)\\s+(\\w+\\s+\\w+\\s+\\d+\\s+[\\d:]+\\s+\\d+)\\s+(.+)$/\n      );\n\n      if (match) {\n        const pid = parseInt(match[1], 10);\n        const startTimeStr = match[2];\n        const command = match[3];\n\n        // Skip current process\n        if (pid === process.pid) continue;\n\n        // Parse start time\n        const startTime = new Date(startTimeStr);\n        const ageMs = Date.now() - startTime.getTime();\n        const ageHours = ageMs / (1000 * 60 * 60);\n\n        processes.push({\n          pid,\n          command: command.slice(0, 100), // Truncate long commands\n          startTime,\n          ageHours,\n        });\n      }\n    }\n  } catch (error) {\n    logger.warn('Failed to get process list:', error);\n  }\n\n  return processes;\n}\n\n/**\n * Check if a process has recent log activity\n */\nfunction hasRecentLogActivity(\n  proc: StaleProcess,\n  maxAgeHours: number\n): boolean {\n  const logDir = path.join(os.homedir(), '.stackmemory', 'logs');\n\n  if (!fs.existsSync(logDir)) return false;\n\n  try {\n    // Look for log files that might be related to this process\n    const logFiles = fs.readdirSync(logDir).filter((f) => f.endsWith('.log'));\n\n    for (const logFile of logFiles) {\n      const logPath = path.join(logDir, logFile);\n      const stats = fs.statSync(logPath);\n      const logAgeHours = (Date.now() - stats.mtimeMs) / (1000 * 60 * 60);\n\n      if (logAgeHours < maxAgeHours) {\n        // Check if log contains this PID\n        try {\n          const content = fs.readFileSync(logPath, 'utf-8').slice(-10000); // Last 10KB\n          if (\n            content.includes(`pid:${proc.pid}`) ||\n            content.includes(`PID ${proc.pid}`)\n          ) {\n            proc.logFile = logPath;\n            proc.lastLogActivity = stats.mtime;\n            return true;\n          }\n        } catch {\n          // Ignore read errors\n        }\n      }\n    }\n  } catch (error) {\n    logger.warn('Failed to check log activity:', error);\n  }\n\n  return false;\n}\n\n/**\n * Find stale processes older than specified hours with no recent log activity\n */\nexport function findStaleProcesses(maxAgeHours: number = 24): StaleProcess[] {\n  const allProcesses = getStackmemoryProcesses();\n\n  return allProcesses.filter((proc) => {\n    // Must be older than threshold\n    if (proc.ageHours < maxAgeHours) return false;\n\n    // Check for recent log activity\n    if (hasRecentLogActivity(proc, maxAgeHours)) return false;\n\n    return true;\n  });\n}\n\n/**\n * Kill stale processes\n */\nexport function killStaleProcesses(\n  processes: StaleProcess[],\n  dryRun: boolean = false\n): CleanupResult {\n  const result: CleanupResult = {\n    found: processes,\n    killed: [],\n    errors: [],\n  };\n\n  for (const proc of processes) {\n    if (dryRun) {\n      logger.info(`[DRY RUN] Would kill PID ${proc.pid}: ${proc.command}`);\n      continue;\n    }\n\n    try {\n      process.kill(proc.pid, 'SIGTERM');\n      result.killed.push(proc.pid);\n      logger.info(`Killed stale process ${proc.pid}: ${proc.command}`);\n    } catch (error: unknown) {\n      const err = error as NodeJS.ErrnoException;\n      if (err.code === 'ESRCH') {\n        // Process already dead\n        result.killed.push(proc.pid);\n      } else {\n        result.errors.push({\n          pid: proc.pid,\n          error: err.message || 'Unknown error',\n        });\n        logger.warn(`Failed to kill PID ${proc.pid}:`, err.message);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Main cleanup function\n */\nexport function cleanupStaleProcesses(\n  options: {\n    maxAgeHours?: number;\n    dryRun?: boolean;\n  } = {}\n): CleanupResult {\n  const { maxAgeHours = 24, dryRun = false } = options;\n\n  logger.info(`Looking for stale processes older than ${maxAgeHours}h...`);\n\n  const staleProcesses = findStaleProcesses(maxAgeHours);\n\n  if (staleProcesses.length === 0) {\n    logger.info('No stale processes found');\n    return { found: [], killed: [], errors: [] };\n  }\n\n  logger.info(`Found ${staleProcesses.length} stale process(es)`);\n\n  return killStaleProcesses(staleProcesses, dryRun);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "0.5.57",
+  "version": "0.5.59",
   "description": "Lossless memory runtime for AI coding tools - organizes context as a call stack instead of linear chat logs, with team collaboration and infinite retention",
   "engines": {
     "node": ">=20.0.0",
@@ -11,6 +11,7 @@
   "bin": {
     "stackmemory": "dist/cli/index.js",
     "codex-sm": "dist/cli/codex-sm.js",
+    "codex-smd": "bin/codex-smd",
     "claude-sm": "bin/claude-sm",
     "claude-smd": "bin/claude-smd",
     "opencode-sm": "bin/opencode-sm"
@@ -63,7 +64,7 @@
     "prepublishOnly": "npm run build && 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/src/integrations/mcp/server.js",
+    "mcp:start": "node dist/integrations/mcp/server.js",
     "mcp:dev": "tsx src/mcp/mcp-server.ts",
     "status": "node dist/scripts/status.js",
     "linear:sync": "node scripts/sync-linear-graphql.js",
@@ -88,7 +89,7 @@
     "@browsermcp/mcp": "^0.1.3",
     "@google-cloud/storage": "^7.18.0",
     "@linear/sdk": "^68.1.0",
-    "@modelcontextprotocol/sdk": "^0.5.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "@stackmemoryai/stackmemory": "^0.3.19",
     "@types/blessed": "^0.1.27",
     "@types/inquirer": "^9.0.9",

package/scripts/create-cleanup-issues.js

@@ -0,0 +1,302 @@
+#!/usr/bin/env node
+/**
+ * Create cleanup issues in Linear
+ */
+
+import dotenv from 'dotenv';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+dotenv.config({ path: path.join(__dirname, '..', '.env') });
+
+const TEAM_ID = 'STA'; // Stackmemoryai team
+
+const cleanupTasks = [
+  {
+    title: 'Add tests for monitoring module (0% coverage)',
+    description: `## Problem
+The \`/src/core/monitoring/\` module has 0% test coverage.
+
+## Files affected
+- src/core/monitoring/logger.ts
+- src/core/monitoring/health-check.ts
+- src/core/monitoring/metrics-collector.ts
+- src/core/monitoring/performance-tracker.ts
+- src/core/monitoring/index.ts
+
+## Acceptance criteria
+- [ ] Add unit tests for all public functions
+- [ ] Test error handling paths
+- [ ] Achieve >80% coverage`,
+    priority: 2, // High
+    labels: ['tech-debt', 'testing'],
+  },
+  {
+    title: 'Add tests for performance module (0% coverage)',
+    description: `## Problem
+The \`/src/core/performance/\` module has 0% test coverage.
+
+## Files affected
+- src/core/performance/profiler.ts
+- src/core/performance/metrics.ts
+- src/core/performance/index.ts
+
+## Acceptance criteria
+- [ ] Add unit tests for profiler
+- [ ] Add unit tests for metrics collection
+- [ ] Achieve >80% coverage`,
+    priority: 2, // High
+    labels: ['tech-debt', 'testing'],
+  },
+  {
+    title: 'Add tests for session module (0% coverage)',
+    description: `## Problem
+The \`/src/core/session/\` module has 0% test coverage.
+
+## Files affected
+- src/core/session/session-manager.ts
+- src/core/session/enhanced-handoff.ts
+- src/core/session/index.ts
+
+## Acceptance criteria
+- [ ] Add unit tests for session lifecycle
+- [ ] Add unit tests for handoff
+- [ ] Achieve >80% coverage`,
+    priority: 2, // High
+    labels: ['tech-debt', 'testing'],
+  },
+  {
+    title: 'Add tests for claude-code integration (7 files, 0% coverage)',
+    description: `## Problem
+The \`/src/integrations/claude-code/\` module has no tests.
+
+## Files affected
+- src/integrations/claude-code/agent-bridge.ts
+- src/integrations/claude-code/context-injector.ts
+- src/integrations/claude-code/hook-manager.ts
+- src/integrations/claude-code/index.ts
+- src/integrations/claude-code/mcp-client.ts
+- src/integrations/claude-code/session-detector.ts
+- src/integrations/claude-code/types.ts
+
+## Acceptance criteria
+- [ ] Add unit tests for all modules
+- [ ] Mock external dependencies
+- [ ] Achieve >80% coverage`,
+    priority: 2, // High
+    labels: ['tech-debt', 'testing'],
+  },
+  {
+    title: 'Improve trace module test coverage (9%)',
+    description: `## Problem
+The \`/src/core/trace/\` module has only ~9% test coverage.
+
+## Files affected (11 files)
+- src/core/trace/trace-detector.ts
+- src/core/trace/trace-bundler.ts
+- src/core/trace/pattern-matcher.ts
+- And 8 more...
+
+## Acceptance criteria
+- [ ] Add tests for trace detection
+- [ ] Add tests for pattern matching
+- [ ] Add tests for trace bundling
+- [ ] Achieve >80% coverage`,
+    priority: 3, // Medium
+    labels: ['tech-debt', 'testing'],
+  },
+  {
+    title: 'Reorganize scripts directory (112 files)',
+    description: `## Problem
+The \`/scripts/\` directory has 112 files with no clear organization.
+
+## Proposed structure
+\`\`\`
+scripts/
+  setup/        # Installation & configuration
+  test/         # Test runners
+  cli/          # CLI wrappers
+  maintenance/  # Cleanup & sync tasks
+  demos/        # Demo & example scripts (DONE)
+  archive/      # Archived scripts
+\`\`\`
+
+## Acceptance criteria
+- [ ] Create subdirectories
+- [ ] Move scripts to appropriate directories
+- [ ] Update any references in package.json
+- [ ] Update documentation`,
+    priority: 4, // Low
+    labels: ['tech-debt', 'organization'],
+  },
+  {
+    title: 'Remove ESLint blanket exclusion of /src/integrations/',
+    description: `## Problem
+ESLint config (line 55) excludes entire \`/src/integrations/\` directory from linting.
+
+## Impact
+- Potential code quality issues not caught
+- Inconsistent code style
+- 33 warnings not shown
+
+## Acceptance criteria
+- [ ] Remove blanket exclusion from eslint.config.js
+- [ ] Fix any lint errors that appear
+- [ ] Keep specific exclusions only if truly needed`,
+    priority: 3, // Medium
+    labels: ['tech-debt', 'code-quality'],
+  },
+  {
+    title: 'Resolve service duplication (context-service.ts)',
+    description: `## Problem
+\`context-service.ts\` exists in two locations with different implementations:
+- /src/services/context-service.ts
+- /src/daemon/services/context-service.ts
+
+## Acceptance criteria
+- [ ] Analyze both implementations
+- [ ] Rename daemon version to DaemonContextService or consolidate
+- [ ] Update all imports
+- [ ] Document the difference if both needed`,
+    priority: 3, // Medium
+    labels: ['tech-debt', 'organization'],
+  },
+  {
+    title: 'Rename temporary-named files (refactored-*, enhanced-*)',
+    description: `## Problem
+Several files have temporary-sounding names:
+- refactored-frame-manager.ts
+- enhanced-hybrid-digest.ts
+- enhanced-rehydration.ts
+- enhanced-handoff.ts
+
+## Acceptance criteria
+- [ ] Rename to final names (remove prefix)
+- [ ] Update all imports
+- [ ] Verify tests pass`,
+    priority: 4, // Low
+    labels: ['tech-debt', 'naming'],
+  },
+  {
+    title: 'Add documentation for monitoring, trace, and performance modules',
+    description: `## Problem
+Critical modules lack documentation:
+- /src/core/monitoring/ - no docs
+- /src/core/trace/ - demos but no guide
+- /src/core/performance/ - no docs
+
+## Acceptance criteria
+- [ ] Add README.md or docs for each module
+- [ ] Document public APIs
+- [ ] Add usage examples`,
+    priority: 4, // Low
+    labels: ['documentation'],
+  },
+];
+
+async function queryLinear(query, variables = {}) {
+  const apiKey =
+    process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY;
+  const response = await fetch('https://api.linear.app/graphql', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: apiKey,
+    },
+    body: JSON.stringify({ query, variables }),
+  });
+
+  const data = await response.json();
+  if (data.errors) {
+    throw new Error(data.errors[0].message);
+  }
+  return data.data;
+}
+
+async function getTeamId() {
+  const teams = await queryLinear(`
+    query {
+      teams {
+        nodes {
+          id
+          key
+          name
+        }
+      }
+    }
+  `);
+
+  const team = teams.teams.nodes.find((t) => t.key === TEAM_ID);
+  if (!team) {
+    throw new Error(`Team ${TEAM_ID} not found`);
+  }
+  return team.id;
+}
+
+async function createIssue(teamId, task) {
+  const mutation = `
+    mutation CreateIssue($input: IssueCreateInput!) {
+      issueCreate(input: $input) {
+        success
+        issue {
+          id
+          identifier
+          title
+          url
+        }
+      }
+    }
+  `;
+
+  const result = await queryLinear(mutation, {
+    input: {
+      teamId,
+      title: task.title,
+      description: task.description,
+      priority: task.priority,
+    },
+  });
+
+  return result.issueCreate;
+}
+
+async function main() {
+  const apiKey =
+    process.env.STACKMEMORY_LINEAR_API_KEY || process.env.LINEAR_API_KEY;
+  if (!apiKey) {
+    console.error('❌ LINEAR_API_KEY not set');
+    process.exit(1);
+  }
+
+  console.log('🔄 Connecting to Linear...');
+
+  // Verify connection
+  const viewer = await queryLinear('{ viewer { name email } }');
+  console.log(`✅ Connected as: ${viewer.viewer.name}`);
+
+  // Get team ID
+  const teamId = await getTeamId();
+  console.log(`📋 Team: ${TEAM_ID} (${teamId})\n`);
+
+  // Create issues
+  console.log(`Creating ${cleanupTasks.length} cleanup issues...\n`);
+
+  for (const task of cleanupTasks) {
+    try {
+      const result = await createIssue(teamId, task);
+      if (result.success) {
+        console.log(`✅ ${result.issue.identifier}: ${task.title}`);
+        console.log(`   ${result.issue.url}\n`);
+      } else {
+        console.log(`❌ Failed: ${task.title}`);
+      }
+    } catch (error) {
+      console.log(`❌ Error creating "${task.title}": ${error.message}`);
+    }
+  }
+
+  console.log('✅ Done!');
+}
+
+main().catch(console.error);

package/scripts/demos/browser-test.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Test Browser MCP integration locally
+ */
+
+import { BrowserMCPIntegration } from '../features/browser/browser-mcp.js';
+
+async function testBrowserMCP() {
+  console.log('Testing Browser MCP Integration...\n');
+
+  const browser = new BrowserMCPIntegration({
+    headless: false, // Show browser for testing
+    defaultViewport: { width: 1280, height: 720 },
+  });
+
+  await browser.initialize();
+
+  console.log('Browser MCP initialized successfully!');
+  console.log('\nAvailable tools:');
+  console.log('  - browser_navigate');
+  console.log('  - browser_screenshot');
+  console.log('  - browser_click');
+  console.log('  - browser_type');
+  console.log('  - browser_evaluate');
+  console.log('  - browser_wait');
+  console.log('  - browser_get_content');
+  console.log('  - browser_close');
+
+  console.log('\nBrowser MCP is ready to use with StackMemory!');
+
+  // Clean up
+  await browser.cleanup();
+  process.exit(0);
+}
+
+testBrowserMCP().catch((error) => {
+  console.error('Browser MCP test failed:', error);
+  process.exit(1);
+});