@stackmemoryai/stackmemory 1.5.8 → 1.5.9

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

@@ -17,7 +17,8 @@ import Database from "better-sqlite3";
 import { logger } from "../../core/monitoring/logger.js";
 import { Conductor } from "./orchestrator.js";
 import {
-  getAgentStatusDir
+  getAgentStatusDir,
+  getOutcomesLogPath
 } from "./orchestrator.js";
 function getGlobalStorePath() {
   const dir = join(homedir(), ".stackmemory", "conductor");
@@ -75,6 +76,8 @@ function budgetBar(pct, width = 30) {
   const rst = "\x1B[0m";
   return `${color}${"\u2588".repeat(filled)}${dim}${"\u2591".repeat(empty)}${rst} ${String(pct).padStart(3)}%`;
 }
+const STALE_UI_THRESHOLD_MS = 5 * 60 * 1e3;
+const STALE_FINALIZE_THRESHOLD_MS = 60 * 60 * 1e3;
 const c = {
   r: "\x1B[0m",
   // reset
@@ -170,6 +173,32 @@ function progressBar(pct, width) {
   const col = pct >= 90 ? c.green : pct >= 50 ? c.yellow : c.cyan;
   return `${col}${"\u2501".repeat(filled)}${c.d}${"\u254C".repeat(empty)}${c.r}`;
 }
+function scanAgentStatuses() {
+  const agentsDir2 = join(homedir(), ".stackmemory", "conductor", "agents");
+  if (!existsSync(agentsDir2)) return [];
+  const entries = readdirSync(agentsDir2, { withFileTypes: true });
+  const statuses = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const statusPath = join(agentsDir2, entry.name, "status.json");
+    if (!existsSync(statusPath)) continue;
+    try {
+      const data = JSON.parse(readFileSync(statusPath, "utf-8"));
+      statuses.push({ ...data, dir: entry.name });
+    } catch {
+    }
+  }
+  statuses.sort(
+    (a, b) => new Date(b.lastUpdate).getTime() - new Date(a.lastUpdate).getTime()
+  );
+  return statuses;
+}
+function enrichStatus(s) {
+  const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
+  const alive = isProcessAlive(s.pid);
+  const stale = alive && elapsed > STALE_UI_THRESHOLD_MS;
+  return { elapsed, alive, stale };
+}
 function fmtMinutes(m) {
   if (m < 0) return "N/A";
   if (m >= 60) return `${Math.floor(m / 60)}h ${m % 60}m`;
@@ -186,24 +215,20 @@ function printUsageSummary(u) {
   const mins5x = u.minutesRemaining5x ?? -1;
   const mins20x = u.minutesRemaining20x ?? -1;
   const cacheHitRate = u.cacheHitRate || 0;
-  const b = "\x1B[1m";
-  const d2 = "\x1B[2m";
-  const w = "\x1B[37m";
-  const r2 = "\x1B[0m";
-  console.log(`${b}Token Usage${r2}`);
+  console.log(`${c.b}Token Usage${c.r}`);
   console.log(
-    `  Input  ${w}${fmtTokens(inputTokens)}${r2}  ${d2}|${r2}  Output  ${w}${fmtTokens(outputTokens)}${r2}  ${d2}|${r2}  Total  ${w}${fmtTokens(totalTokens)}${r2}`
+    `  Input  ${c.white}${fmtTokens(inputTokens)}${c.r}  ${c.d}|${c.r}  Output  ${c.white}${fmtTokens(outputTokens)}${c.r}  ${c.d}|${c.r}  Total  ${c.white}${fmtTokens(totalTokens)}${c.r}`
   );
   console.log(
-    `  Rate   ${w}${fmtTokens(tokensPerMin)}/min${r2}  ${d2}|${r2}  Messages  ${w}${estMessages}${r2}  ${d2}|${r2}  Cache hit  ${w}${cacheHitRate}%${r2}`
+    `  Rate   ${c.white}${fmtTokens(tokensPerMin)}/min${c.r}  ${c.d}|${c.r}  Messages  ${c.white}${estMessages}${c.r}  ${c.d}|${c.r}  Cache hit  ${c.white}${cacheHitRate}%${c.r}`
   );
   console.log("");
-  console.log(`${b}Budget (Max plan, 5h window)${r2}`);
+  console.log(`${c.b}Budget (Max plan, 5h window)${c.r}`);
   console.log(
-    `  5x  (225 msgs)  ${budgetBar(budgetPct5x)}  ${d2}~${fmtMinutes(mins5x)} left${r2}`
+    `  5x  (225 msgs)  ${budgetBar(budgetPct5x)}  ${c.d}~${fmtMinutes(mins5x)} left${c.r}`
   );
   console.log(
-    `  20x (900 msgs)  ${budgetBar(budgetPct20x)}  ${d2}~${fmtMinutes(mins20x)} left${r2}`
+    `  20x (900 msgs)  ${budgetBar(budgetPct20x)}  ${c.d}~${fmtMinutes(mins20x)} left${c.r}`
   );
 }
 function createConductorCommands() {
@@ -323,14 +348,14 @@ function createConductorCommands() {
         const risks = anchors.filter((a) => a.type === "RISK");
         if (decisions.length > 0) {
           lines.push("", "### Decisions");
-          for (const d2 of decisions.slice(0, 10)) {
-            lines.push(`- ${d2.text}`);
+          for (const d of decisions.slice(0, 10)) {
+            lines.push(`- ${d.text}`);
           }
         }
         if (risks.length > 0) {
           lines.push("", "### Risks");
-          for (const r2 of risks.slice(0, 5)) {
-            lines.push(`- ${r2.text}`);
+          for (const r of risks.slice(0, 5)) {
+            lines.push(`- ${r.text}`);
           }
         }
       } catch {
@@ -414,48 +439,28 @@ function createConductorCommands() {
     }
     console.log(`Found ${results.length} result(s) for "${query}":
 `);
-    for (const r2 of results) {
-      const date = new Date(r2.captured_at * 1e3).toISOString().slice(0, 16);
+    for (const r of results) {
+      const date = new Date(r.captured_at * 1e3).toISOString().slice(0, 16);
       console.log(
-        `  ${r2.issue_id} [${r2.context_type}] attempt ${r2.attempt} (${date})`
+        `  ${r.issue_id} [${r.context_type}] attempt ${r.attempt} (${date})`
       );
-      if (r2.summary) {
-        const snippet = r2.summary.slice(0, 120).replace(/\n/g, " ");
+      if (r.summary) {
+        const snippet = r.summary.slice(0, 120).replace(/\n/g, " ");
         console.log(`    ${snippet}`);
       }
     }
     globalDb.close();
   });
   cmd.command("status").description("Show running agent status table").action(async () => {
-    const agentsDir = join(homedir(), ".stackmemory", "conductor", "agents");
-    if (!existsSync(agentsDir)) {
-      console.log("No agent status files found");
-      return;
-    }
-    const entries = readdirSync(agentsDir, { withFileTypes: true });
-    const statuses = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const statusPath = join(agentsDir, entry.name, "status.json");
-      if (!existsSync(statusPath)) continue;
-      try {
-        const data = JSON.parse(readFileSync(statusPath, "utf-8"));
-        statuses.push(data);
-      } catch {
-      }
-    }
+    const statuses = scanAgentStatuses();
     if (statuses.length === 0) {
       console.log("No agent status files found");
       return;
     }
-    statuses.sort(
-      (a, b) => new Date(b.lastUpdate).getTime() - new Date(a.lastUpdate).getTime()
-    );
-    const active = statuses.filter((s) => isProcessAlive(s.pid));
-    const stalled = statuses.filter(
-      (s) => isProcessAlive(s.pid) && Date.now() - new Date(s.lastUpdate).getTime() > 5 * 60 * 1e3
-    );
-    const dead = statuses.filter((s) => !isProcessAlive(s.pid));
+    const enriched = statuses.map((s) => ({ ...s, ...enrichStatus(s) }));
+    const active = enriched.filter((s) => s.alive);
+    const stalled = enriched.filter((s) => s.stale);
+    const dead = enriched.filter((s) => !s.alive);
     const healthy = active.length - stalled.length;
     const parts = [];
     if (healthy > 0) parts.push(`${c.green}\u25CF ${healthy}${c.r}`);
@@ -467,21 +472,18 @@ function createConductorCommands() {
 `);
     const cols = (process.stdout.columns || 80) >= 90 ? 2 : 1;
     const rows = [];
-    for (const s of statuses) {
-      const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
-      const staleFlag = elapsed > 5 * 60 * 1e3;
-      const alive = isProcessAlive(s.pid);
+    for (const s of enriched) {
       const { icon, color, pct, label } = phaseProgress(
         s.phase,
         s.toolCalls,
-        staleFlag,
-        alive
+        s.stale,
+        s.alive
       );
       const bar = progressBar(pct, 8);
-      const timeColor = !alive ? c.red : staleFlag ? c.orange : c.gray;
+      const timeColor = !s.alive ? c.red : s.stale ? c.orange : c.gray;
       const cell = [
         `${color}${icon}${c.r} ${c.b}${s.issue}${c.r} ${color}${label}${c.r}`,
-        `  ${bar} ${c.d}${pct}%${c.r} ${c.gray}${s.toolCalls}t ${s.filesModified}f${c.r} ${timeColor}${formatElapsed(elapsed)}${c.r}`
+        `  ${bar} ${c.d}${pct}%${c.r} ${c.gray}${s.toolCalls}t ${s.filesModified}f${c.r} ${timeColor}${formatElapsed(s.elapsed)}${c.r}`
       ];
       rows.push(cell);
     }
@@ -517,27 +519,9 @@ function createConductorCommands() {
     console.log("");
   });
   cmd.command("finalize").description("Clean up completed/dead agents that conductor missed").option("--dry-run", "Show what would be done without doing it", false).action(async (options) => {
-    const agentsDir = join(homedir(), ".stackmemory", "conductor", "agents");
-    if (!existsSync(agentsDir)) {
-      console.log("No agent status files found");
-      return;
-    }
-    const entries = readdirSync(agentsDir, { withFileTypes: true });
-    const statuses = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const statusPath = join(agentsDir, entry.name, "status.json");
-      if (!existsSync(statusPath)) continue;
-      try {
-        const data = JSON.parse(readFileSync(statusPath, "utf-8"));
-        statuses.push({ ...data, dir: entry.name });
-      } catch {
-      }
-    }
-    const needsFinalize = statuses.filter((s) => {
-      const alive = isProcessAlive(s.pid);
-      const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
-      return !alive || elapsed > 60 * 60 * 1e3;
+    const statuses = scanAgentStatuses();
+    const needsFinalize = statuses.map((s) => ({ ...s, ...enrichStatus(s) })).filter((s) => {
+      return !s.alive || s.elapsed > STALE_FINALIZE_THRESHOLD_MS;
     });
     if (needsFinalize.length === 0) {
       console.log(
@@ -551,9 +535,7 @@ function createConductorCommands() {
 `
     );
     for (const s of needsFinalize) {
-      const alive = isProcessAlive(s.pid);
-      const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
-      const elapsedStr = formatElapsed(elapsed).replace(" ago", "");
+      const elapsedStr = formatElapsed(s.elapsed).replace(" ago", "");
       let hasCommits = false;
       if (s.workspacePath && existsSync(s.workspacePath)) {
         try {
@@ -566,11 +548,11 @@ function createConductorCommands() {
         } catch {
         }
       }
-      const statusIcon = !alive ? `${c.red}\u2717 dead${c.r}` : `${c.orange}\u23F8 stalled ${elapsedStr}${c.r}`;
+      const statusIcon = !s.alive ? `${c.red}\u2717 dead${c.r}` : `${c.orange}\u23F8 stalled ${elapsedStr}${c.r}`;
       const commitStatus = hasCommits ? `${c.green}has commits \u2192 In Review${c.r}` : `${c.gray}no commits \u2192 mark failed${c.r}`;
       console.log(`  ${c.b}${s.issue}${c.r}  ${statusIcon}  ${commitStatus}`);
       if (options.dryRun) continue;
-      if (alive) {
+      if (s.alive) {
         try {
           process.kill(s.pid, "SIGTERM");
           console.log(`     ${c.gray}Sent SIGTERM to pid ${s.pid}${c.r}`);
@@ -629,6 +611,189 @@ function createConductorCommands() {
       process.on("SIGTERM", forward);
     });
   });
+  cmd.command("learn").description(
+    "Analyze agent outcomes and generate improved prompt templates"
+  ).option("--last <n>", "Analyze last N outcomes (default: all)", "0").option("--failures-only", "Only analyze failures", false).option("--export", "Export analysis as JSON", false).action(async (options) => {
+    const logPath = getOutcomesLogPath();
+    if (!existsSync(logPath)) {
+      console.log(
+        `${c.yellow}No outcomes log found.${c.r} Run conductor to generate data.`
+      );
+      return;
+    }
+    const raw = readFileSync(logPath, "utf-8").trim().split("\n").filter((l) => l.length > 0);
+    let outcomes = raw.map(
+      (line) => JSON.parse(line)
+    );
+    if (options.failuresOnly) {
+      outcomes = outcomes.filter((o) => o.outcome === "failure");
+    }
+    const lastN = parseInt(options.last, 10);
+    if (lastN > 0) {
+      outcomes = outcomes.slice(-lastN);
+    }
+    if (outcomes.length === 0) {
+      console.log(`${c.gray}No matching outcomes to analyze.${c.r}`);
+      return;
+    }
+    const total = outcomes.length;
+    const successes = outcomes.filter((o) => o.outcome === "success").length;
+    const failures = outcomes.filter((o) => o.outcome === "failure").length;
+    const successRate = Math.round(successes / total * 100);
+    const avgTokens = Math.round(
+      outcomes.reduce((s, o) => s + o.tokensUsed, 0) / total
+    );
+    const avgDuration = Math.round(
+      outcomes.reduce((s, o) => s + o.durationMs, 0) / total / 6e4
+    );
+    const avgTools = Math.round(
+      outcomes.reduce((s, o) => s + o.toolCalls, 0) / total
+    );
+    const failPhases = {};
+    for (const o of outcomes.filter((o2) => o2.outcome === "failure")) {
+      failPhases[o.phase] = (failPhases[o.phase] || 0) + 1;
+    }
+    const retries = outcomes.filter((o) => o.attempt > 1);
+    const retrySuccessRate = retries.length > 0 ? Math.round(
+      retries.filter((o) => o.outcome === "success").length / retries.length * 100
+    ) : 0;
+    const errorPatterns = {};
+    for (const o of outcomes.filter(
+      (o2) => o2.outcome === "failure" && o2.errorTail
+    )) {
+      const tail = o.errorTail;
+      if (tail.includes("lint"))
+        errorPatterns["lint_failure"] = (errorPatterns["lint_failure"] || 0) + 1;
+      else if (tail.includes("test"))
+        errorPatterns["test_failure"] = (errorPatterns["test_failure"] || 0) + 1;
+      else if (tail.includes("timeout") || tail.includes("timed out"))
+        errorPatterns["timeout"] = (errorPatterns["timeout"] || 0) + 1;
+      else if (tail.includes("conflict"))
+        errorPatterns["git_conflict"] = (errorPatterns["git_conflict"] || 0) + 1;
+      else if (tail.includes("429") || tail.includes("rate"))
+        errorPatterns["rate_limit"] = (errorPatterns["rate_limit"] || 0) + 1;
+      else errorPatterns["unknown"] = (errorPatterns["unknown"] || 0) + 1;
+    }
+    if (options.export) {
+      const analysis = {
+        total,
+        successes,
+        failures,
+        successRate,
+        avgTokens,
+        avgDurationMin: avgDuration,
+        avgToolCalls: avgTools,
+        failPhases,
+        retrySuccessRate,
+        errorPatterns,
+        outcomes
+      };
+      console.log(JSON.stringify(analysis, null, 2));
+      return;
+    }
+    console.log(`
+  ${c.b}${c.purple}Conductor Learning Report${c.r}
+`);
+    const rateColor = successRate >= 80 ? c.green : successRate >= 50 ? c.yellow : c.red;
+    console.log(
+      `  ${c.b}Outcomes${c.r}  ${c.white}${total}${c.r} total  ${c.green}${successes}${c.r} success  ${c.red}${failures}${c.r} failed  ${rateColor}${successRate}%${c.r} success rate`
+    );
+    console.log(
+      `  ${c.b}Averages${c.r}  ${c.white}${avgDuration}m${c.r} duration  ${c.white}${fmtTokens(avgTokens)}${c.r} tokens  ${c.white}${avgTools}${c.r} tool calls`
+    );
+    if (retries.length > 0) {
+      console.log(
+        `  ${c.b}Retries${c.r}   ${c.white}${retries.length}${c.r} attempts  ${c.white}${retrySuccessRate}%${c.r} retry success rate`
+      );
+    }
+    if (failures > 0) {
+      console.log(`
+  ${c.b}Failure Phases${c.r}`);
+      const sorted = Object.entries(failPhases).sort((a, b) => b[1] - a[1]);
+      for (const [phase, count] of sorted) {
+        const pct = Math.round(count / failures * 100);
+        const bar = progressBar(pct, 10);
+        console.log(
+          `    ${phaseIcon[phase] || "\u25CB"} ${phase.padEnd(14)} ${bar} ${c.white}${count}${c.r} ${c.gray}(${pct}%)${c.r}`
+        );
+      }
+    }
+    if (Object.keys(errorPatterns).length > 0) {
+      console.log(`
+  ${c.b}Error Patterns${c.r}`);
+      const sorted = Object.entries(errorPatterns).sort(
+        (a, b) => b[1] - a[1]
+      );
+      for (const [pattern, count] of sorted) {
+        console.log(
+          `    ${c.red}\u25CF${c.r} ${pattern.padEnd(16)} ${c.white}${count}${c.r}`
+        );
+      }
+    }
+    console.log(`
+  ${c.b}Recommendations${c.r}`);
+    const recs = [];
+    if (errorPatterns["lint_failure"] > 0) {
+      recs.push(
+        "Add explicit lint rules to prompt template (ESLint conventions, import style)"
+      );
+    }
+    if (errorPatterns["test_failure"] > 0) {
+      recs.push(
+        'Add "run tests before committing" emphasis, include test command in prompt'
+      );
+    }
+    if (errorPatterns["timeout"] > 0) {
+      recs.push(
+        "Reduce scope per issue or increase turnTimeoutMs in conductor config"
+      );
+    }
+    if (failPhases["implementing"] > failures * 0.5) {
+      recs.push(
+        "Agents stall during implementation \u2014 add examples or break issues smaller"
+      );
+    }
+    if (failPhases["reading"] > 0) {
+      recs.push(
+        "Agents fail during reading \u2014 improve issue descriptions or add context pointers"
+      );
+    }
+    if (retrySuccessRate < 30 && retries.length > 2) {
+      recs.push(
+        "Low retry success \u2014 consider better prior-attempt context injection"
+      );
+    }
+    if (successRate >= 80) {
+      recs.push(
+        "High success rate \u2014 current prompt template is working well"
+      );
+    }
+    if (recs.length === 0) {
+      recs.push("Collect more data for actionable recommendations");
+    }
+    for (const rec of recs) {
+      console.log(`    ${c.cyan}\u2192${c.r} ${rec}`);
+    }
+    const templatePath = join(
+      homedir(),
+      ".stackmemory",
+      "conductor",
+      "prompt-template.md"
+    );
+    if (!existsSync(templatePath)) {
+      console.log(
+        `
+  ${c.d}Tip: Create ${templatePath} to customize agent prompts.${c.r}`
+      );
+      console.log(
+        `  ${c.d}Variables: {{ISSUE_ID}} {{TITLE}} {{DESCRIPTION}} {{LABELS}} {{PRIORITY}} {{ATTEMPT}} {{PRIOR_CONTEXT}}${c.r}`
+      );
+    } else {
+      console.log(`
+  ${c.d}Using custom template: ${templatePath}${c.r}`);
+    }
+    console.log("");
+  });
   cmd.command("usage").description("Show token usage, budget, and time-to-exhaustion").option("--json", "Output as JSON", false).option("--scan", "Scan Claude Code JSONL logs for historical data", false).action(async (options) => {
     const statusPath = join(
       process.cwd(),
@@ -721,27 +886,7 @@ function createConductorCommands() {
     let refreshInterval = interval;
     let phaseFilter = options.phase || null;
     function readStatuses() {
-      const agentsDir = join(
-        homedir(),
-        ".stackmemory",
-        "conductor",
-        "agents"
-      );
-      if (!existsSync(agentsDir)) return [];
-      const entries = readdirSync(agentsDir, { withFileTypes: true });
-      const statuses = [];
-      for (const entry of entries) {
-        if (!entry.isDirectory()) continue;
-        const statusPath = join(agentsDir, entry.name, "status.json");
-        if (!existsSync(statusPath)) continue;
-        try {
-          statuses.push(JSON.parse(readFileSync(statusPath, "utf-8")));
-        } catch {
-        }
-      }
-      statuses.sort(
-        (a, b) => new Date(b.lastUpdate).getTime() - new Date(a.lastUpdate).getTime()
-      );
+      const statuses = scanAgentStatuses();
       if (phaseFilter) {
         return statuses.filter((s) => s.phase === phaseFilter);
       }
@@ -754,9 +899,7 @@ function createConductorCommands() {
         return;
       }
       for (const s of statuses) {
-        const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
-        const stale = elapsed > 5 * 60 * 1e3;
-        const alive = isProcessAlive(s.pid);
+        const { elapsed, alive, stale } = enrichStatus(s);
         const prog = phaseProgress(s.phase, s.toolCalls, stale, alive);
         const bar = progressBar(prog.pct, 10);
         const timeColor = !alive ? c.red : stale ? c.orange : c.gray;
@@ -788,9 +931,7 @@ function createConductorCommands() {
         return;
       }
       for (const s of statuses) {
-        const elapsed = Date.now() - new Date(s.lastUpdate).getTime();
-        const stale = elapsed > 5 * 60 * 1e3;
-        const alive = isProcessAlive(s.pid);
+        const { elapsed, alive, stale } = enrichStatus(s);
         const prog = phaseProgress(s.phase, s.toolCalls, stale, alive);
         console.log(
           `  ${prog.color}${prog.icon}${c.r}  ${c.b}${s.issue}${c.r}  ${prog.color}${prog.label}${c.r}  ${c.gray}${formatElapsed(elapsed)}${c.r}`
@@ -813,10 +954,10 @@ function createConductorCommands() {
         console.log("");
       }
     }
+    const cachedConductor = new Conductor({ repoRoot: process.cwd() });
     async function getUsage() {
-      const conductor = new Conductor({ repoRoot: process.cwd() });
-      await conductor.scanUsageLogs();
-      return conductor.getUsageSummary();
+      await cachedConductor.scanUsageLogs();
+      return cachedConductor.getUsageSummary();
     }
     async function render() {
       process.stdout.write("\x1B[2J\x1B[H");
@@ -867,7 +1008,7 @@ function createConductorCommands() {
       }
       console.log("");
       console.log(
-        `${d}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${r}`
+        `${c.d}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${c.r}`
       );
     }
     await render();

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,
@@ -28,6 +29,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 +644,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 +1292,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 +1325,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(
       "",
@@ -1485,6 +1526,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 +1637,6 @@ class Conductor {
 }
 export {
   Conductor,
-  getAgentStatusDir
+  getAgentStatusDir,
+  getOutcomesLogPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "1.5.8",
+  "version": "1.5.9",
   "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",