vibe-forge 0.8.1 → 0.8.2

package/{bin → src}/lib/frontmatter.js

@@ -1,106 +1,106 @@
-#!/usr/bin/env node
-/**
- * frontmatter.js - Safe YAML frontmatter field extractor
- *
- * Replaces grep/cut pipelines for extracting frontmatter fields from
- * task and attention markdown files (RT-20260405-001 MEDIUM-5).
- *
- * Usage:
- *   node frontmatter.js <file> <field1> [field2] ...
- *   node frontmatter.js --section <file> <heading>
- *
- * Output (field mode):
- *   field1=value1
- *   field2=value2
- *
- * Output (section mode):
- *   First non-heading line under the matched ## heading
- *
- * Values are sanitized for safe shell consumption:
- *   - Shell metacharacters removed
- *   - Length capped at 200 chars
- *   - Missing fields output as empty: field=
- */
-
-'use strict';
-
-const fs = require('fs');
-const yaml = require('js-yaml');
-
-const MAX_VALUE_LENGTH = 200;
-
-// Strip characters unsafe for shell interpolation
-function sanitize(val) {
-    if (val == null) return '';
-    const str = String(val)
-        .replace(/[\0\r]/g, '')
-        .replace(/[\n]/g, ' ')
-        .replace(/[$`"'\\(){}[\]!#;|&<>]/g, '')
-        .trim();
-    return str.substring(0, MAX_VALUE_LENGTH);
-}
-
-function extractFrontmatter(content) {
-    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-    if (!match) return {};
-    try {
-        const parsed = yaml.load(match[1]);
-        return typeof parsed === 'object' && parsed !== null ? parsed : {};
-    } catch (_) {
-        return {};
-    }
-}
-
-function extractSection(content, heading) {
-    const pattern = new RegExp(`^## ${heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'im');
-    const idx = content.search(pattern);
-    if (idx === -1) return '';
-    const after = content.substring(idx).split('\n').slice(1);
-    for (const line of after) {
-        if (line.startsWith('## ')) break;
-        const trimmed = line.trim();
-        if (trimmed) return sanitize(trimmed);
-    }
-    return '';
-}
-
-// Main
-const args = process.argv.slice(2);
-
-if (args.length < 2) {
-    process.stderr.write('Usage: node frontmatter.js <file> <field1> [field2] ...\n');
-    process.stderr.write('       node frontmatter.js --section <file> <heading>\n');
-    process.exit(1);
-}
-
-// Section mode: --section <file> <heading>
-if (args[0] === '--section') {
-    const file = args[1];
-    const heading = args[2];
-    if (!file || !heading) {
-        process.stderr.write('Usage: node frontmatter.js --section <file> <heading>\n');
-        process.exit(1);
-    }
-    let content;
-    try { content = fs.readFileSync(file, 'utf8'); } catch (_) { process.exit(0); }
-    process.stdout.write(extractSection(content, heading) + '\n');
-    process.exit(0);
-}
-
-// Field mode: <file> <field1> [field2] ...
-const file = args[0];
-const fields = args.slice(1);
-
-let content;
-try { content = fs.readFileSync(file, 'utf8'); } catch (_) {
-    // File unreadable: output empty values
-    for (const f of fields) process.stdout.write(`${f}=\n`);
-    process.exit(0);
-}
-
-const data = extractFrontmatter(content);
-
-for (const field of fields) {
-    const val = sanitize(data[field]);
-    process.stdout.write(`${field}=${val}\n`);
-}
+#!/usr/bin/env node
+/**
+ * frontmatter.js - Safe YAML frontmatter field extractor
+ *
+ * Replaces grep/cut pipelines for extracting frontmatter fields from
+ * task and attention markdown files (RT-20260405-001 MEDIUM-5).
+ *
+ * Usage:
+ *   node frontmatter.js <file> <field1> [field2] ...
+ *   node frontmatter.js --section <file> <heading>
+ *
+ * Output (field mode):
+ *   field1=value1
+ *   field2=value2
+ *
+ * Output (section mode):
+ *   First non-heading line under the matched ## heading
+ *
+ * Values are sanitized for safe shell consumption:
+ *   - Shell metacharacters removed
+ *   - Length capped at 200 chars
+ *   - Missing fields output as empty: field=
+ */
+
+'use strict';
+
+const fs = require('fs');
+const yaml = require('js-yaml');
+
+const MAX_VALUE_LENGTH = 200;
+
+// Strip characters unsafe for shell interpolation
+function sanitize(val) {
+    if (val == null) return '';
+    const str = String(val)
+        .replace(/[\0\r]/g, '')
+        .replace(/[\n]/g, ' ')
+        .replace(/[$`"'\\(){}[\]!#;|&<>]/g, '')
+        .trim();
+    return str.substring(0, MAX_VALUE_LENGTH);
+}
+
+function extractFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match) return {};
+    try {
+        const parsed = yaml.load(match[1]);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    } catch (_) {
+        return {};
+    }
+}
+
+function extractSection(content, heading) {
+    const pattern = new RegExp(`^## ${heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'im');
+    const idx = content.search(pattern);
+    if (idx === -1) return '';
+    const after = content.substring(idx).split('\n').slice(1);
+    for (const line of after) {
+        if (line.startsWith('## ')) break;
+        const trimmed = line.trim();
+        if (trimmed) return sanitize(trimmed);
+    }
+    return '';
+}
+
+// Main
+const args = process.argv.slice(2);
+
+if (args.length < 2) {
+    process.stderr.write('Usage: node frontmatter.js <file> <field1> [field2] ...\n');
+    process.stderr.write('       node frontmatter.js --section <file> <heading>\n');
+    process.exit(1);
+}
+
+// Section mode: --section <file> <heading>
+if (args[0] === '--section') {
+    const file = args[1];
+    const heading = args[2];
+    if (!file || !heading) {
+        process.stderr.write('Usage: node frontmatter.js --section <file> <heading>\n');
+        process.exit(1);
+    }
+    let content;
+    try { content = fs.readFileSync(file, 'utf8'); } catch (_) { process.exit(0); }
+    process.stdout.write(extractSection(content, heading) + '\n');
+    process.exit(0);
+}
+
+// Field mode: <file> <field1> [field2] ...
+const file = args[0];
+const fields = args.slice(1);
+
+let content;
+try { content = fs.readFileSync(file, 'utf8'); } catch (_) {
+    // File unreadable: output empty values
+    for (const f of fields) process.stdout.write(`${f}=\n`);
+    process.exit(0);
+}
+
+const data = extractFrontmatter(content);
+
+for (const field of fields) {
+    const val = sanitize(data[field]);
+    process.stdout.write(`${field}=${val}\n`);
+}

package/{bin → src}/lib/heimdall-setup.js

@@ -1,113 +1,113 @@
-#!/usr/bin/env node
-/**
- * Heimdall Setup -- writes .claude/settings.local.json into a worker's
- * working directory to register Heimdall as a PreToolUse hook.
- *
- * Called by the forge daemon at inbox-write time, before the worker
- * picks up a lab task.
- *
- * Uses a merge strategy: if settings.local.json already exists, the
- * Heimdall hooks are merged into the existing PreToolUse array rather
- * than overwriting the file.
- */
-
-'use strict'
-
-const fs = require('fs')
-const path = require('path')
-
-// Absolute path to heimdall.js -- resolvable from any working directory
-const HEIMDALL_PATH = path.resolve(__dirname, 'heimdall.js').replace(/\\/g, '/')
-
-const HEIMDALL_HOOKS = ['Bash', 'Write', 'Edit'].map(matcher => ({
-  matcher,
-  hooks: [{ type: 'command', command: `node "${HEIMDALL_PATH}"` }],
-}))
-
-/**
- * writeHeimdallHooks(worktreePath)
- *
- * Writes or merges Heimdall PreToolUse hooks into:
- *   <worktreePath>/.claude/settings.local.json
- *
- * Safe to call multiple times -- idempotent.
- *
- * @param {string} worktreePath  Absolute path to the worker's worktree root
- */
-function writeHeimdallHooks(worktreePath) {
-  const claudeDir = path.join(worktreePath, '.claude')
-  const settingsPath = path.join(claudeDir, 'settings.local.json')
-
-  // Ensure .claude/ exists
-  if (!fs.existsSync(claudeDir)) {
-    fs.mkdirSync(claudeDir, { recursive: true })
-  }
-
-  // Read existing settings if present
-  let existing = {}
-  if (fs.existsSync(settingsPath)) {
-    try {
-      existing = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
-    } catch (_) {
-      // Corrupt file -- start fresh
-      existing = {}
-    }
-  }
-
-  // Ensure hooks structure exists
-  if (!existing.hooks) existing.hooks = {}
-  if (!existing.hooks.PreToolUse) existing.hooks.PreToolUse = []
-
-  // Merge: add Heimdall hook entries for matchers not already registered
-  const existingMatchers = new Set(
-    existing.hooks.PreToolUse.map(h => h.matcher)
-  )
-
-  for (const heimdallHook of HEIMDALL_HOOKS) {
-    if (!existingMatchers.has(heimdallHook.matcher)) {
-      existing.hooks.PreToolUse.push(heimdallHook)
-    }
-  }
-
-  fs.writeFileSync(settingsPath, JSON.stringify(existing, null, 2) + '\n')
-}
-
-/**
- * writeContextFile(worktreePath, context)
- *
- * Writes the Heimdall context file to the worktree root so Heimdall
- * can read per-task policy on every invocation.
- *
- * @param {string} worktreePath  Absolute path to the worker's worktree root
- * @param {object} context       Context object matching the schema below
- *
- * Context schema:
- * {
- *   story_id:       string   -- lab story ID (e.g. "FORGE-3")
- *   agent:          string   -- worker name (e.g. "anvil")
- *   worktree_path:  string   -- absolute path to worktree (same as worktreePath)
- *   assigned_branch: string  -- git branch for this story
- *   handoff_dir:    string   -- absolute path to _vibe-chain-output/handoffs/
- *   escalation_dir: string   -- absolute path to worker-inbox/<agent>/ dir
- *   audit_log:      string   -- absolute path to heimdall-audit.log
- *   has_db_migration: boolean
- *   has_api_changes:  boolean
- *   allowed_paths:  string[] -- absolute paths the worker may read/write
- * }
- */
-function writeContextFile(worktreePath, context) {
-  const contextPath = path.join(worktreePath, '.context.json')
-  fs.writeFileSync(contextPath, JSON.stringify(context, null, 2) + '\n')
-}
-
-/**
- * setup(worktreePath, context)
- *
- * Convenience function: writes both hooks and context file in one call.
- */
-function setup(worktreePath, context) {
-  writeHeimdallHooks(worktreePath)
-  writeContextFile(worktreePath, context)
-}
-
-module.exports = { setup, writeHeimdallHooks, writeContextFile, HEIMDALL_PATH }
+#!/usr/bin/env node
+/**
+ * Heimdall Setup -- writes .claude/settings.local.json into a worker's
+ * working directory to register Heimdall as a PreToolUse hook.
+ *
+ * Called by the forge daemon at inbox-write time, before the worker
+ * picks up a lab task.
+ *
+ * Uses a merge strategy: if settings.local.json already exists, the
+ * Heimdall hooks are merged into the existing PreToolUse array rather
+ * than overwriting the file.
+ */
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+// Absolute path to heimdall.js -- resolvable from any working directory
+const HEIMDALL_PATH = path.resolve(__dirname, 'heimdall.js').replace(/\\/g, '/')
+
+const HEIMDALL_HOOKS = ['Bash', 'Write', 'Edit'].map(matcher => ({
+  matcher,
+  hooks: [{ type: 'command', command: `node "${HEIMDALL_PATH}"` }],
+}))
+
+/**
+ * writeHeimdallHooks(worktreePath)
+ *
+ * Writes or merges Heimdall PreToolUse hooks into:
+ *   <worktreePath>/.claude/settings.local.json
+ *
+ * Safe to call multiple times -- idempotent.
+ *
+ * @param {string} worktreePath  Absolute path to the worker's worktree root
+ */
+function writeHeimdallHooks(worktreePath) {
+  const claudeDir = path.join(worktreePath, '.claude')
+  const settingsPath = path.join(claudeDir, 'settings.local.json')
+
+  // Ensure .claude/ exists
+  if (!fs.existsSync(claudeDir)) {
+    fs.mkdirSync(claudeDir, { recursive: true })
+  }
+
+  // Read existing settings if present
+  let existing = {}
+  if (fs.existsSync(settingsPath)) {
+    try {
+      existing = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
+    } catch (_) {
+      // Corrupt file -- start fresh
+      existing = {}
+    }
+  }
+
+  // Ensure hooks structure exists
+  if (!existing.hooks) existing.hooks = {}
+  if (!existing.hooks.PreToolUse) existing.hooks.PreToolUse = []
+
+  // Merge: add Heimdall hook entries for matchers not already registered
+  const existingMatchers = new Set(
+    existing.hooks.PreToolUse.map(h => h.matcher)
+  )
+
+  for (const heimdallHook of HEIMDALL_HOOKS) {
+    if (!existingMatchers.has(heimdallHook.matcher)) {
+      existing.hooks.PreToolUse.push(heimdallHook)
+    }
+  }
+
+  fs.writeFileSync(settingsPath, JSON.stringify(existing, null, 2) + '\n')
+}
+
+/**
+ * writeContextFile(worktreePath, context)
+ *
+ * Writes the Heimdall context file to the worktree root so Heimdall
+ * can read per-task policy on every invocation.
+ *
+ * @param {string} worktreePath  Absolute path to the worker's worktree root
+ * @param {object} context       Context object matching the schema below
+ *
+ * Context schema:
+ * {
+ *   story_id:       string   -- lab story ID (e.g. "FORGE-3")
+ *   agent:          string   -- worker name (e.g. "anvil")
+ *   worktree_path:  string   -- absolute path to worktree (same as worktreePath)
+ *   assigned_branch: string  -- git branch for this story
+ *   handoff_dir:    string   -- absolute path to _vibe-chain-output/handoffs/
+ *   escalation_dir: string   -- absolute path to worker-inbox/<agent>/ dir
+ *   audit_log:      string   -- absolute path to heimdall-audit.log
+ *   has_db_migration: boolean
+ *   has_api_changes:  boolean
+ *   allowed_paths:  string[] -- absolute paths the worker may read/write
+ * }
+ */
+function writeContextFile(worktreePath, context) {
+  const contextPath = path.join(worktreePath, '.context.json')
+  fs.writeFileSync(contextPath, JSON.stringify(context, null, 2) + '\n')
+}
+
+/**
+ * setup(worktreePath, context)
+ *
+ * Convenience function: writes both hooks and context file in one call.
+ */
+function setup(worktreePath, context) {
+  writeHeimdallHooks(worktreePath)
+  writeContextFile(worktreePath, context)
+}
+
+module.exports = { setup, writeHeimdallHooks, writeContextFile, HEIMDALL_PATH }