@stackmemoryai/stackmemory 1.2.8 → 1.3.0

package/templates/claude-hooks/team-subagent-stop.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * Team Subagent Stop Hook (SubagentStop)
+ *
+ * Fires when a subagent finishes. Captures the last assistant message
+ * as shared team context so other agents can see findings without
+ * manual team_context_share calls.
+ *
+ * Fire-and-forget: exits 0 always, never blocks the agent.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const MAX_CONTENT = 500;
+
+function hasStackmemory(cwd) {
+  let dir = cwd || process.cwd();
+  for (let i = 0; i < 20; i++) {
+    if (fs.existsSync(path.join(dir, '.stackmemory', 'context.db'))) {
+      return true;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
+
+async function readInput() {
+  let input = '';
+  for await (const chunk of process.stdin) {
+    input += chunk;
+  }
+  return JSON.parse(input);
+}
+
+async function main() {
+  try {
+    const input = await readInput();
+    const { agent_id, last_assistant_message, cwd } = input;
+
+    if (!hasStackmemory(cwd || process.cwd())) return;
+
+    const message = (last_assistant_message || '').slice(0, MAX_CONTENT).trim();
+    if (!message) return;
+
+    const args = [
+      'team',
+      'share',
+      '-c',
+      message,
+      '-t',
+      'FACT',
+      '-p',
+      '7',
+      '--source',
+      'subagent',
+    ];
+    if (agent_id) {
+      args.push('--agent-id', String(agent_id));
+    }
+
+    const child = spawn('stackmemory', args, {
+      stdio: 'ignore',
+      detached: true,
+      cwd: cwd || process.cwd(),
+    });
+    child.unref();
+  } catch {
+    // Silent fail — never block the agent
+  }
+}
+
+main();

package/templates/claude-hooks/team-task-complete.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+/**
+ * Team Task Complete Hook (TaskCompleted)
+ *
+ * Fires when a task is marked complete. Shares the completion summary
+ * as a DECISION anchor so other agents know what was accomplished.
+ *
+ * Fire-and-forget: exits 0 always, never blocks the agent.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const MAX_CONTENT = 800;
+
+function hasStackmemory(cwd) {
+  let dir = cwd || process.cwd();
+  for (let i = 0; i < 20; i++) {
+    if (fs.existsSync(path.join(dir, '.stackmemory', 'context.db'))) {
+      return true;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
+
+async function readInput() {
+  let input = '';
+  for await (const chunk of process.stdin) {
+    input += chunk;
+  }
+  return JSON.parse(input);
+}
+
+async function main() {
+  try {
+    const input = await readInput();
+    const { task_id, task_subject, task_description, teammate_name, cwd } =
+      input;
+
+    if (!hasStackmemory(cwd || process.cwd())) return;
+
+    const who = teammate_name || 'agent';
+    const subject = task_subject || 'unknown task';
+    const desc = task_description || '';
+    const content = `Task completed by ${who}: ${subject}. ${desc}`
+      .slice(0, MAX_CONTENT)
+      .trim();
+
+    if (!content) return;
+
+    const args = [
+      'team',
+      'share',
+      '-c',
+      content,
+      '-t',
+      'DECISION',
+      '-p',
+      '8',
+      '--source',
+      'task-complete',
+    ];
+    if (task_id) {
+      args.push('--task-id', String(task_id));
+    }
+
+    const child = spawn('stackmemory', args, {
+      stdio: 'ignore',
+      detached: true,
+      cwd: cwd || process.cwd(),
+    });
+    child.unref();
+  } catch {
+    // Silent fail — never block the agent
+  }
+}
+
+main();

package/templates/claude-hooks/team-teammate-idle.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * Team Teammate Idle Hook (TeammateIdle)
+ *
+ * Fires when a teammate is about to go idle. Logs the idle event
+ * for audit and shares a low-priority FACT anchor.
+ *
+ * Fire-and-forget: exits 0 always, never blocks the agent.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const HOME = process.env.HOME || '/tmp';
+
+function hasStackmemory(cwd) {
+  let dir = cwd || process.cwd();
+  for (let i = 0; i < 20; i++) {
+    if (fs.existsSync(path.join(dir, '.stackmemory', 'context.db'))) {
+      return true;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
+
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+async function readInput() {
+  let input = '';
+  for await (const chunk of process.stdin) {
+    input += chunk;
+  }
+  return JSON.parse(input);
+}
+
+async function main() {
+  try {
+    const input = await readInput();
+    const { teammate_name, team_name, cwd } = input;
+
+    if (!hasStackmemory(cwd || process.cwd())) return;
+
+    const name = teammate_name || 'unknown';
+
+    // Log idle event for audit
+    const auditDir = path.join(HOME, '.stackmemory', 'team-events');
+    ensureDir(auditDir);
+    const entry = {
+      event: 'teammate_idle',
+      teammate: name,
+      team: team_name || 'default',
+      ts: new Date().toISOString(),
+      cwd: cwd || process.cwd(),
+    };
+    const auditFile = path.join(
+      auditDir,
+      `idle-${new Date().toISOString().slice(0, 10)}.jsonl`
+    );
+    fs.appendFileSync(auditFile, JSON.stringify(entry) + '\n');
+
+    // Share low-priority anchor
+    const content = `Teammate ${name} idle`;
+    const args = [
+      'team',
+      'share',
+      '-c',
+      content,
+      '-t',
+      'FACT',
+      '-p',
+      '4',
+      '--source',
+      'teammate-idle',
+    ];
+
+    const child = spawn('stackmemory', args, {
+      stdio: 'ignore',
+      detached: true,
+      cwd: cwd || process.cwd(),
+    });
+    child.unref();
+  } catch {
+    // Silent fail — never block the agent
+  }
+}
+
+main();