xtrm-tools 2.1.30 → 2.3.0

package/hooks/branch-state.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// branch-state.mjs — UserPromptSubmit hook
+// Re-injects current git branch and active beads claim at each prompt.
+// Keeps the agent oriented after /compact or long sessions.
+// Output: { hookSpecificOutput: { additionalSystemPrompt } }
+
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+function readInput() {
+  try { return JSON.parse(readFileSync(0, 'utf-8')); } catch { return null; }
+}
+
+function getBranch(cwd) {
+  try {
+    return execSync('git branch --show-current', {
+      encoding: 'utf8', cwd,
+      stdio: ['pipe', 'pipe', 'pipe'], timeout: 3000,
+    }).trim() || null;
+  } catch { return null; }
+}
+
+function getSessionClaim(sessionId, cwd) {
+  try {
+    const out = execSync(`bd kv get "claimed:${sessionId}"`, {
+      encoding: 'utf8', cwd,
+      stdio: ['pipe', 'pipe', 'pipe'], timeout: 3000,
+    }).trim();
+    return out || null;
+  } catch { return null; }
+}
+
+const input = readInput();
+if (!input) process.exit(0);
+
+const cwd = input.cwd || process.cwd();
+const sessionId = input.session_id ?? input.sessionId;
+const branch = getBranch(cwd);
+const isBeads = existsSync(join(cwd, '.beads'));
+const claim = isBeads && sessionId ? getSessionClaim(sessionId, cwd) : null;
+
+if (!branch && !claim) process.exit(0);
+
+const context = `[Context: branch=${branch ?? 'unknown'}${claim ? ', claim=' + claim : ''}]`;
+
+process.stdout.write(JSON.stringify({
+  hookSpecificOutput: { additionalSystemPrompt: context },
+}));
+process.stdout.write('\n');
+process.exit(0);

package/hooks/main-guard-post-push.mjs

@@ -59,11 +59,13 @@ const explicitlyProtectedTarget = protectedBranches
   .some((b) => lastToken === b || lastToken.endsWith(`:${b}`));
 if (explicitlyProtectedTarget) process.exit(0);
 
-process.stdout.write(
-  `✅ Pushed '${branch}'. Next workflow steps:\n\n` +
-  '  1. gh pr create --fill\n' +
-  '  2. gh pr merge --squash\n' +
-  '  3. git checkout main && git reset --hard origin/main\n\n' +
-  'Before/after merge, ensure beads state is updated (e.g. bd close <id>).\n',
-);
+process.stdout.write(JSON.stringify({
+  additionalContext:
+    `✅ Pushed '${branch}'. Next steps:\n` +
+    '  1. gh pr create --fill\n' +
+    '  2. gh pr merge --squash\n' +
+    '  3. git checkout main && git reset --hard origin/main\n' +
+    'Ensure beads state is updated (e.g. bd close <id>).',
+}));
+process.stdout.write('\n');
 process.exit(0);

package/hooks/main-guard.mjs

@@ -37,10 +37,11 @@ const hookEventName = input.hook_event_name ?? 'PreToolUse';
 
 function deny(reason) {
   process.stdout.write(JSON.stringify({
-    systemMessage: reason,
+    decision: 'block',
+    reason,
   }));
   process.stdout.write('\n');
-  process.exit(2);
+  process.exit(0);
 }
 
 const WRITE_TOOLS = new Set([
@@ -55,8 +56,9 @@ const WRITE_TOOLS = new Set([
 ]);
 
 if (WRITE_TOOLS.has(tool)) {
-  deny(`⛔ On '${branch}' — checkout a feature branch first.\n`
-    + '  git checkout -b feature/<name>\n');
+  deny(`⛔ On '${branch}' — start on a feature branch and claim an issue.\n`
+    + '  git checkout -b feature/<name>\n'
+    + '  bd update <id> --claim\n');
 }
 
 const WORKFLOW =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xtrm-tools",
-  "version": "2.1.30",
+  "version": "2.3.0",
   "description": "Claude Code tools installer (skills, hooks, MCP servers)",
   "license": "MIT",
   "type": "module",

package/project-skills/tdd-guard/.claude/skills/using-tdd-guard/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: using-tdd-guard
+description: TDD Guard enforces Test-Driven Development workflow in Claude Code. Blocks implementation code until failing tests are written.
+---
+
 # Using TDD Guard
 
 **TDD Guard** enforces Test-Driven Development workflow in Claude Code. It blocks implementation code until failing tests are written.