feat: Add process cleanup utility and API skill tests

- Add cleanup-processes CLI command to kill stale stackmemory processes
  - Finds processes older than 24h (configurable) with no log activity
  - Supports --dry-run, --all, --force, --max-age flags
- Add comprehensive tests for API skill (18 tests)
  - Tests for add, list, describe, remove, help
  - Tests for API discovery (GitHub, Stripe, Railway, GCP)
- Bump version to 0.5.5

Author: jonathanpeterwu

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "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",
@@ -10,7 +10,9 @@
   "main": "dist/index.js",
   "bin": {
     "stackmemory": "dist/cli/index.js",
-    "codex-sm": "dist/cli/codex-sm.js"
+    "codex-sm": "dist/cli/codex-sm.js",
+    "claude-sm": "bin/claude-sm",
+    "claude-smd": "bin/claude-smd"
   },
   "types": "dist/src/index.d.ts",
   "files": [

package.json

@@ -0,0 +1,86 @@
+/**
+ * CLI Command for Process Cleanup
+ */
+
+import { Command } from 'commander';
+import {
+  cleanupStaleProcesses,
+  findStaleProcesses,
+  getStackmemoryProcesses,
+} from '../../utils/process-cleanup.js';
+
+export function createCleanupProcessesCommand(): Command {
+  const cmd = new Command('cleanup-processes');
+  cmd.description('Clean up stale stackmemory processes');
+
+  cmd
+    .option('--max-age <hours>', 'Max process age in hours (default: 24)', '24')
+    .option('--dry-run', 'Show what would be killed without actually killing')
+    .option('--all', 'Show all stackmemory processes (not just stale)')
+    .option('--force', 'Kill without checking log activity')
+    .action((options) => {
+      const maxAgeHours = parseInt(options.maxAge, 10);
+
+      if (options.all) {
+        // Just list all processes
+        const processes = getStackmemoryProcesses();
+
+        if (processes.length === 0) {
+          console.log('No stackmemory processes running');
+          return;
+        }
+
+        console.log(`Found ${processes.length} stackmemory process(es):\n`);
+        for (const proc of processes) {
+          const age =
+            proc.ageHours < 1
+              ? `${Math.round(proc.ageHours * 60)}m`
+              : `${Math.round(proc.ageHours)}h`;
+          console.log(`  PID ${proc.pid} (${age} old)`);
+          console.log(`    ${proc.command}`);
+        }
+        return;
+      }
+
+      // Find and optionally kill stale processes
+      const staleProcesses = options.force
+        ? getStackmemoryProcesses().filter((p) => p.ageHours >= maxAgeHours)
+        : findStaleProcesses(maxAgeHours);
+
+      if (staleProcesses.length === 0) {
+        console.log(`No stale processes older than ${maxAgeHours}h found`);
+        return;
+      }
+
+      console.log(
+        `Found ${staleProcesses.length} stale process(es) older than ${maxAgeHours}h:\n`
+      );
+
+      for (const proc of staleProcesses) {
+        const age = `${Math.round(proc.ageHours)}h`;
+        console.log(`  PID ${proc.pid} (${age} old)`);
+        console.log(`    ${proc.command}`);
+        if (proc.lastLogActivity) {
+          console.log(`    Last log: ${proc.lastLogActivity.toISOString()}`);
+        }
+      }
+
+      if (options.dryRun) {
+        console.log('\n[DRY RUN] No processes killed');
+        return;
+      }
+
+      console.log('\nKilling stale processes...');
+      const result = cleanupStaleProcesses({ maxAgeHours, dryRun: false });
+
+      console.log(`\nKilled: ${result.killed.length}`);
+      if (result.errors.length > 0) {
+        console.log(`Errors: ${result.errors.length}`);
+        for (const err of result.errors) {
+          console.log(`  PID ${err.pid}: ${err.error}`);
+        }
+      }
+    });
+
+  return cmd;
+}

src/cli/commands/cleanup-processes.ts

@@ -52,6 +52,7 @@ import { createSweepCommand } from './commands/sweep.js';
 import { createHooksCommand } from './commands/hooks.js';
 import { createShellCommand } from './commands/shell.js';
 import { createAPICommand } from './commands/api.js';
+import { createCleanupProcessesCommand } from './commands/cleanup-processes.js';
 import { ProjectManager } from '../core/projects/project-manager.js';
 import Database from 'better-sqlite3';
 import { join } from 'path';
@@ -64,7 +65,7 @@ import {
   getStorageModeDescription,
 } from '../core/config/storage-config.js';
 
-const VERSION = '0.5.3';
+const VERSION = '0.5.5';
 
 // Check for updates on CLI startup
 UpdateChecker.checkForUpdates(VERSION, true).catch(() => {
@@ -582,6 +583,7 @@ program.addCommand(createSweepCommand());
 program.addCommand(createHooksCommand());
 program.addCommand(createShellCommand());
 program.addCommand(createAPICommand());
+program.addCommand(createCleanupProcessesCommand());
 
 // Register dashboard command
 program