@stackmemoryai/stackmemory 1.5.8 → 1.6.0

package/dist/src/cli/commands/orchestrator.js

@@ -4,6 +4,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
 import { spawn, execSync } from "child_process";
 import {
+  appendFileSync,
   existsSync,
   mkdirSync,
   readFileSync,
@@ -19,6 +20,7 @@ import { createInterface } from "readline";
 import { fileURLToPath } from "url";
 import { Transform } from "stream";
 import { logger } from "../../core/monitoring/logger.js";
+import { isProcessAlive } from "../../utils/process-cleanup.js";
 import {
   LinearClient
 } from "../../integrations/linear/client.js";
@@ -28,6 +30,14 @@ import {
 } from "../../core/worktree/preflight.js";
 import { ContextCapture } from "../../core/worktree/capture.js";
 import { extractKeywords } from "../../core/utils/text.js";
+function getOutcomesLogPath() {
+  return join(homedir(), ".stackmemory", "conductor", "outcomes.jsonl");
+}
+function logAgentOutcome(entry) {
+  const dir = join(homedir(), ".stackmemory", "conductor");
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  appendFileSync(getOutcomesLogPath(), JSON.stringify(entry) + "\n");
+}
 function findPackageRoot() {
   const currentFile = fileURLToPath(import.meta.url);
   let dir = dirname(currentFile);
@@ -635,6 +645,18 @@ class Conductor {
         await this.runAgent(issue, run);
         run.status = "completed";
         this.completeCount++;
+        logAgentOutcome({
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          issue: issue.identifier,
+          attempt: run.attempt,
+          outcome: "success",
+          phase: run.phase,
+          toolCalls: run.toolCalls,
+          filesModified: run.filesModified,
+          tokensUsed: run.tokensUsed,
+          durationMs: Date.now() - run.startedAt,
+          hasCommits: true
+        });
         await this.runHook(
           "after-run",
           run.workspacePath,
@@ -1271,7 +1293,32 @@ class Conductor {
       }
     }
   }
+  /**
+   * Build the agent prompt. If a custom template exists at
+   * ~/.stackmemory/conductor/prompt-template.md, use it with variable
+   * substitution. Otherwise fall back to the default template.
+   *
+   * Template variables: {{ISSUE_ID}}, {{TITLE}}, {{DESCRIPTION}},
+   * {{LABELS}}, {{PRIORITY}}, {{ATTEMPT}}, {{PRIOR_CONTEXT}}
+   */
   buildPrompt(issue, attempt) {
+    const templatePath = join(
+      homedir(),
+      ".stackmemory",
+      "conductor",
+      "prompt-template.md"
+    );
+    const priority = ["None", "Urgent", "High", "Medium", "Low"][issue.priority] || "None";
+    const labels = issue.labels.length > 0 ? issue.labels.map((l) => l.name).join(", ") : "";
+    const priorContext = attempt > 1 ? `This is attempt ${attempt}. Check .stackmemory/conductor-context.md for context from prior attempts.` : "";
+    if (existsSync(templatePath)) {
+      try {
+        let template = readFileSync(templatePath, "utf-8");
+        template = template.replace(/\{\{ISSUE_ID\}\}/g, issue.identifier).replace(/\{\{TITLE\}\}/g, issue.title).replace(/\{\{DESCRIPTION\}\}/g, issue.description || "").replace(/\{\{LABELS\}\}/g, labels).replace(/\{\{PRIORITY\}\}/g, priority).replace(/\{\{ATTEMPT\}\}/g, String(attempt)).replace(/\{\{PRIOR_CONTEXT\}\}/g, priorContext);
+        return template;
+      } catch {
+      }
+    }
     const lines = [
       `You are working on Linear issue ${issue.identifier}: ${issue.title}`,
       ""
@@ -1279,17 +1326,12 @@ class Conductor {
     if (issue.description) {
       lines.push("## Description", "", issue.description, "");
     }
-    if (issue.labels.length > 0) {
-      lines.push(`Labels: ${issue.labels.map((l) => l.name).join(", ")}`);
+    if (labels) {
+      lines.push(`Labels: ${labels}`);
     }
-    lines.push(
-      `Priority: ${["None", "Urgent", "High", "Medium", "Low"][issue.priority] || "None"}`
-    );
-    if (attempt > 1) {
-      lines.push(
-        "",
-        `This is attempt ${attempt}. Check .stackmemory/conductor-context.md for context from prior attempts.`
-      );
+    lines.push(`Priority: ${priority}`);
+    if (priorContext) {
+      lines.push("", priorContext);
     }
     lines.push(
       "",
@@ -1428,14 +1470,7 @@ class Conductor {
       if (elapsed < staleThresholdMs) continue;
       const elapsedMin = Math.round(elapsed / 6e4);
       const pid = run.process?.pid;
-      let alive = false;
-      if (pid) {
-        try {
-          process.kill(pid, 0);
-          alive = true;
-        } catch {
-        }
-      }
+      const alive = pid ? isProcessAlive(pid) : false;
       if (!alive) {
         logger.warn("Stale agent process is dead, cleaning up", {
           identifier: run.issue.identifier,
@@ -1485,6 +1520,35 @@ class Conductor {
       hasCommits = log.trim().length > 0;
     } catch {
     }
+    let errorTail;
+    if (!hasCommits) {
+      try {
+        const logPath = join(
+          getAgentStatusDir(run.issue.identifier),
+          "output.log"
+        );
+        if (existsSync(logPath)) {
+          const content = readFileSync(logPath, "utf-8");
+          const lines = content.trim().split("\n");
+          errorTail = lines.slice(-5).join("\n");
+        }
+      } catch {
+      }
+    }
+    const durationMs = Date.now() - run.startedAt;
+    logAgentOutcome({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      issue: run.issue.identifier,
+      attempt: run.attempt,
+      outcome: hasCommits ? "success" : "failure",
+      phase: run.phase,
+      toolCalls: run.toolCalls,
+      filesModified: run.filesModified,
+      tokensUsed: run.tokensUsed,
+      durationMs,
+      hasCommits,
+      errorTail
+    });
     if (hasCommits) {
       logger.info("Stale agent had commits, transitioning to In Review", {
         identifier: run.issue.identifier
@@ -1567,5 +1631,6 @@ class Conductor {
 }
 export {
   Conductor,
-  getAgentStatusDir
+  getAgentStatusDir,
+  getOutcomesLogPath
 };

package/dist/src/daemon/daemon-config.js

@@ -5,6 +5,7 @@ const __dirname = __pathDirname(__filename);
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
+import { isProcessAlive } from "../utils/process-cleanup.js";
 const DEFAULT_DAEMON_CONFIG = {
   version: "1.0.0",
   context: {
@@ -139,9 +140,7 @@ function readDaemonStatus() {
   try {
     const pidContent = readFileSync(pidFile, "utf8").trim();
     const pid = parseInt(pidContent, 10);
-    try {
-      process.kill(pid, 0);
-    } catch {
+    if (!isProcessAlive(pid)) {
       return defaultStatus;
     }
     if (!existsSync(statusFile)) {

package/dist/src/daemon/session-daemon.js

@@ -6,6 +6,7 @@ const __dirname = __pathDirname(__filename);
 import * as fs from "fs";
 import * as path from "path";
 import { execSync } from "child_process";
+import { isProcessAlive } from "../utils/process-cleanup.js";
 class SessionDaemon {
   config;
   state;
@@ -69,16 +70,14 @@ class SessionDaemon {
       try {
         const existingPid = fs.readFileSync(this.pidFile, "utf8").trim();
         const pid = parseInt(existingPid, 10);
-        try {
-          process.kill(pid, 0);
+        if (isProcessAlive(pid)) {
           this.log("WARN", "Daemon already running for this session", {
             existingPid: pid
           });
           return false;
-        } catch {
-          this.log("INFO", "Cleaning up stale PID file", { stalePid: pid });
-          fs.unlinkSync(this.pidFile);
         }
+        this.log("INFO", "Cleaning up stale PID file", { stalePid: pid });
+        fs.unlinkSync(this.pidFile);
       } catch {
         try {
           fs.unlinkSync(this.pidFile);

package/dist/src/daemon/unified-daemon.js

@@ -10,6 +10,7 @@ import {
   appendFileSync,
   readFileSync
 } from "fs";
+import { isProcessAlive } from "../utils/process-cleanup.js";
 import {
   loadDaemonConfig,
   getDaemonPaths,
@@ -75,14 +76,12 @@ class UnifiedDaemon {
       try {
         const existingPid = readFileSync(this.paths.pidFile, "utf8").trim();
         const pid = parseInt(existingPid, 10);
-        try {
-          process.kill(pid, 0);
+        if (isProcessAlive(pid)) {
           this.log("WARN", "daemon", "Daemon already running", { pid });
           return false;
-        } catch {
-          this.log("INFO", "daemon", "Cleaning stale PID file", { pid });
-          unlinkSync(this.paths.pidFile);
         }
+        this.log("INFO", "daemon", "Cleaning stale PID file", { pid });
+        unlinkSync(this.paths.pidFile);
       } catch {
         try {
           unlinkSync(this.paths.pidFile);

package/dist/src/features/sweep/sweep-server-manager.js

@@ -10,6 +10,7 @@ import {
 } from "./types.js";
 import { createPredictionClient } from "./prediction-client.js";
 import { logger } from "../../core/monitoring/logger.js";
+import { isProcessAlive } from "../../utils/process-cleanup.js";
 const HOME = process.env["HOME"] || "/tmp";
 const PID_FILE = join(HOME, ".stackmemory", "sweep", "server.pid");
 const LOG_FILE = join(HOME, ".stackmemory", "sweep", "server.log");
@@ -149,9 +150,7 @@ Download with: huggingface-cli download sweepai/sweep-next-edit-1.5B sweep-next-
       process.kill(status.pid, "SIGTERM");
       await new Promise((resolve) => {
         const checkInterval = setInterval(() => {
-          try {
-            process.kill(status.pid, 0);
-          } catch {
+          if (!isProcessAlive(status.pid)) {
             clearInterval(checkInterval);
             resolve();
           }
@@ -186,9 +185,7 @@ Download with: huggingface-cli download sweepai/sweep-next-edit-1.5B sweep-next-
     try {
       const data = JSON.parse(readFileSync(PID_FILE, "utf-8"));
       const { pid, port, host, modelPath, startedAt } = data;
-      try {
-        process.kill(pid, 0);
-      } catch {
+      if (!isProcessAlive(pid)) {
         return { running: false };
       }
       const client = createPredictionClient({ port, host });

package/dist/src/hooks/daemon.js

@@ -13,6 +13,7 @@ import {
 import { join, extname, relative } from "path";
 import { spawn } from "child_process";
 import { loadConfig } from "./config.js";
+import { isProcessAlive } from "../utils/process-cleanup.js";
 import {
   hookEmitter
 } from "./events.js";
@@ -51,13 +52,11 @@ async function startDaemon(options = {}) {
   const pidFile = config.daemon.pid_file;
   if (existsSync(pidFile)) {
     const pid = parseInt(readFileSync(pidFile, "utf-8").trim(), 10);
-    try {
-      process.kill(pid, 0);
+    if (isProcessAlive(pid)) {
       log("warn", "Daemon already running", { pid });
       return;
-    } catch {
-      unlinkSync(pidFile);
     }
+    unlinkSync(pidFile);
   }
   if (!options.foreground) {
     const child = spawn(
@@ -117,17 +116,15 @@ function getDaemonStatus() {
     return { running: false };
   }
   const pid = parseInt(readFileSync(pidFile, "utf-8").trim(), 10);
-  try {
-    process.kill(pid, 0);
+  if (isProcessAlive(pid)) {
     return {
       running: true,
       pid,
       uptime: state.running ? Date.now() - state.startTime : void 0,
       eventsProcessed: state.eventsProcessed
     };
-  } catch {
-    return { running: false };
   }
+  return { running: false };
 }
 function setupLogStream() {
   const logFile = config.daemon.log_file;

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

@@ -7,6 +7,14 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import { logger } from "../core/monitoring/logger.js";
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
 const STACKMEMORY_PROCESS_PATTERNS = [
   "stackmemory",
   "ralph orchestrate",
@@ -131,5 +139,6 @@ export {
   cleanupStaleProcesses,
   findStaleProcesses,
   getStackmemoryProcesses,
+  isProcessAlive,
   killStaleProcesses
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "1.5.8",
+  "version": "1.6.0",
   "description": "Lossless, project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, snapshot capture, pre-flight overlap checks, Claude/Codex/OpenCode wrappers, Linear sync, and automatic hooks.",
   "engines": {
     "node": ">=20.0.0",

package/scripts/gepa/.before-optimize.md

@@ -103,38 +103,6 @@ Located at `api/app/graphql/{api,private}/v1/`
 - Use `test()` instead of `it()` in tests
 - Use `toBeCalled()` instead of `toHaveBeenCalledWith()` in jest assertions
 
-## LSP Setup (Code Intelligence)
-
-Claude Code uses LSP plugins for go-to-definition, find-references, and real-time diagnostics.
-
-### Installed Plugins
-- **vtsls** (JS/TS) - `vtsls@claude-code-lsps` from boostvolt marketplace
-- **ruby-lsp** (Ruby) - `ruby-lsp@ruby-skills` + `ruby-skills@ruby-skills` from st0012 marketplace
-
-### Prerequisites
-```bash
-# TypeScript/JS language server
-npm install -g @vtsls/language-server
-
-# Ruby language server (use rbenv gem, not system)
-/Users/jwu/.rbenv/versions/3.3.5/bin/gem install ruby-lsp
-```
-
-### Known Issues
-- Official `typescript-lsp@claude-plugins-official` is broken (missing plugin.json) — use `vtsls@claude-code-lsps` instead
-- Ruby LSP launch script patched at `~/.claude/plugins/cache/ruby-skills/ruby-lsp/1.0.0/scripts/launch-ruby-lsp.sh` — macOS lacks GNU `timeout` which breaks the version manager detection. Patch hardcodes rbenv PATH.
-- Plugin auto-updates may overwrite the patch — re-apply if Ruby LSP stops working
-
-### Reinstall Commands
-```bash
-claude plugin marketplace add boostvolt/claude-code-lsps
-claude plugin install vtsls@claude-code-lsps
-
-claude plugin marketplace add st0012/ruby-skills
-claude plugin install ruby-lsp@ruby-skills
-claude plugin install ruby-skills@ruby-skills
-```
-
 ## Key Configuration Files
 
 - `api/config/database.yml` - Database connections (primary + timescale)

package/scripts/gepa/generations/gen-000/baseline.md

@@ -103,38 +103,6 @@ Located at `api/app/graphql/{api,private}/v1/`
 - Use `test()` instead of `it()` in tests
 - Use `toBeCalled()` instead of `toHaveBeenCalledWith()` in jest assertions
 
-## LSP Setup (Code Intelligence)
-
-Claude Code uses LSP plugins for go-to-definition, find-references, and real-time diagnostics.
-
-### Installed Plugins
-- **vtsls** (JS/TS) - `vtsls@claude-code-lsps` from boostvolt marketplace
-- **ruby-lsp** (Ruby) - `ruby-lsp@ruby-skills` + `ruby-skills@ruby-skills` from st0012 marketplace
-
-### Prerequisites
-```bash
-# TypeScript/JS language server
-npm install -g @vtsls/language-server
-
-# Ruby language server (use rbenv gem, not system)
-/Users/jwu/.rbenv/versions/3.3.5/bin/gem install ruby-lsp
-```
-
-### Known Issues
-- Official `typescript-lsp@claude-plugins-official` is broken (missing plugin.json) — use `vtsls@claude-code-lsps` instead
-- Ruby LSP launch script patched at `~/.claude/plugins/cache/ruby-skills/ruby-lsp/1.0.0/scripts/launch-ruby-lsp.sh` — macOS lacks GNU `timeout` which breaks the version manager detection. Patch hardcodes rbenv PATH.
-- Plugin auto-updates may overwrite the patch — re-apply if Ruby LSP stops working
-
-### Reinstall Commands
-```bash
-claude plugin marketplace add boostvolt/claude-code-lsps
-claude plugin install vtsls@claude-code-lsps
-
-claude plugin marketplace add st0012/ruby-skills
-claude plugin install ruby-lsp@ruby-skills
-claude plugin install ruby-skills@ruby-skills
-```
-
 ## Key Configuration Files
 
 - `api/config/database.yml` - Database connections (primary + timescale)

package/scripts/gepa/generations/gen-001/baseline.md

@@ -103,38 +103,6 @@ Located at `api/app/graphql/{api,private}/v1/`
 - Use `test()` instead of `it()` in tests
 - Use `toBeCalled()` instead of `toHaveBeenCalledWith()` in jest assertions
 
-## LSP Setup (Code Intelligence)
-
-Claude Code uses LSP plugins for go-to-definition, find-references, and real-time diagnostics.
-
-### Installed Plugins
-- **vtsls** (JS/TS) - `vtsls@claude-code-lsps` from boostvolt marketplace
-- **ruby-lsp** (Ruby) - `ruby-lsp@ruby-skills` + `ruby-skills@ruby-skills` from st0012 marketplace
-
-### Prerequisites
-```bash
-# TypeScript/JS language server
-npm install -g @vtsls/language-server
-
-# Ruby language server (use rbenv gem, not system)
-/Users/jwu/.rbenv/versions/3.3.5/bin/gem install ruby-lsp
-```
-
-### Known Issues
-- Official `typescript-lsp@claude-plugins-official` is broken (missing plugin.json) — use `vtsls@claude-code-lsps` instead
-- Ruby LSP launch script patched at `~/.claude/plugins/cache/ruby-skills/ruby-lsp/1.0.0/scripts/launch-ruby-lsp.sh` — macOS lacks GNU `timeout` which breaks the version manager detection. Patch hardcodes rbenv PATH.
-- Plugin auto-updates may overwrite the patch — re-apply if Ruby LSP stops working
-
-### Reinstall Commands
-```bash
-claude plugin marketplace add boostvolt/claude-code-lsps
-claude plugin install vtsls@claude-code-lsps
-
-claude plugin marketplace add st0012/ruby-skills
-claude plugin install ruby-lsp@ruby-skills
-claude plugin install ruby-skills@ruby-skills
-```
-
 ## Key Configuration Files
 
 - `api/config/database.yml` - Database connections (primary + timescale)

package/scripts/gepa/generations/gen-001/variant-a.md

@@ -1 +1,107 @@
-API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You have reached your specified API usage limits. You will regain access on 2026-04-01 at 00:00 UTC."},"request_id":"req_011CYrHCd5bajfrRXjhYqSFH"}
+# CLAUDE.md
+
+Guidance for Claude Code when working in this repository.
+
+## Project Overview
+
+Sol is the **Rize** monorepo (automatic time tracking). Stack:
+- **api/** - Rails 7.1 GraphQL backend (Ruby 3.3.5)
+- **web/** - Next.js 14 React app (Node 22)
+- **electron/** - Electron desktop app (Node 22)
+- **services/** - Bun TypeScript event consumers/workers
+- **vanity/** - Webflow marketing scripts (deprecated)
+- **voyager/** - Marketing website (Next.js)
+- **puppet/** - Puppeteer server for images/PDFs
+- **chrome/** - Chrome extension
+- **docs/** - Docusaurus site
+- **zapier/** - Zapier integration
+
+## Development Commands
+
+### Start Dev Environment
+```bash
+./scripts/run-dev.sh  # All services (requires iTerm2 on macOS)
+
+# Individually:
+cd api && hivemind Procfile.dev      # Rails + AnyCable + Sidekiq + Clockwork
+cd web && npm run dev                # Next.js (port 3001)
+cd electron && npm run dev           # Electron with hot reload
+cd services && hivemind Procfile.dev # Bun services
+```
+
+### Docker (required before api/services)
+```bash
+cd api && docker-compose up -d
+# TimescaleDB: localhost:15432 | Redis: localhost:16379
+# Kafka: localhost:9092 | MySQL: localhost:13306
+```
+
+### Testing
+```bash
+# API (RSpec)
+cd api && bundle exec rspec
+cd api && bundle exec rspec spec/path/to/file_spec.rb
+cd api && bundle exec rspec spec/path/to/file_spec.rb:42
+
+# Electron (Jest)
+cd electron && npm test
+cd electron && npm run test:watch
+cd electron && npm run test:coverage
+
+# Web: no active tests (exits 0)
+```
+
+### Building
+```bash
+cd api && bundle install && rake db:migrate
+cd web && npm run build       # gql-gen + tailwind + next build
+cd electron && npm run build  # Electron Forge make
+cd services && bun install
+```
+
+### GraphQL Code Generation
+- `cd web && npm run build` — includes gql codegen
+- `cd electron && npm run dev` — runs gql codegen automatically
+
+## Architecture
+
+### GraphQL API
+Two endpoints:
+- **api/v1** — Public API (OAuth, Zapier) → `api/app/graphql/api/v1/`
+- **private/v1** — Internal API (web, electron) → `api/app/graphql/private/v1/`
+
+### Real-time
+- AnyCable WebSocket subscriptions
+- ActionCable channels: `api/app/channels/`
+- Config: `api/config/cable.yml`, `api/config/anycable.yml`
+
+### Background Jobs
+- Sidekiq (async): `api/config/sidekiq.yml`
+- Clockwork (scheduled): `api/config/clock.rb`
+
+### Event Streaming
+- Kafka publish/consume via `services/consumers/`
+- Config: `api/config/initializers/kafka.rb`
+
+### Databases
+- **PostgreSQL** — primary app data
+- **TimescaleDB** — time-series (separate connection in `database.yml`)
+- **MySQL** — legacy integrations
+- **Redis** — caching, ActionCable, Sidekiq
+
+## Style Guidelines
+
+### JavaScript/TypeScript Tests
+- Use `test()` not `it()`
+- Use `toBeCalled()` not `toHaveBeenCalledWith()`
+
+## Key Config Files
+
+| File | Purpose |
+|------|---------|
+| `api/config/database.yml` | DB connections (primary + timescale) |
+| `api/config/cable.yml` | AnyCable WebSocket config |
+| `api/Procfile.dev` | Dev processes (rails, anycable, sidekiq, clockwork) |
+| `sol.code-workspace` | VS Code multi-folder workspace |
+
+Each subproject needs its own `.env` file (not committed).