@sandrinio/vbounce 1.5.0 → 1.7.0

package/scripts/pre_gate_runner.sh

@@ -0,0 +1,176 @@
+#!/usr/bin/env bash
+# pre_gate_runner.sh — Runs pre-gate checks before QA or Architect agents
+# Usage: ./scripts/pre_gate_runner.sh <qa|arch> [worktree-path] [base-branch]
+#
+# Reads .bounce/gate-checks.json for check configuration.
+# If no config exists, runs universal defaults with auto-detected stack.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/pre_gate_common.sh"
+
+# ── Arguments ────────────────────────────────────────────────────────
+
+GATE_TYPE="${1:-}"
+WORKTREE_PATH="${2:-.}"
+BASE_BRANCH="${3:-}"
+PLAIN_RESULTS=""
+
+if [[ -z "$GATE_TYPE" ]] || [[ "$GATE_TYPE" != "qa" && "$GATE_TYPE" != "arch" ]]; then
+  echo "Usage: ./scripts/pre_gate_runner.sh <qa|arch> [worktree-path] [base-branch]"
+  echo ""
+  echo "  qa    — Run QA pre-gate checks (before QA agent)"
+  echo "  arch  — Run Architect pre-gate checks (before Architect agent)"
+  echo ""
+  echo "  worktree-path  — Path to story worktree (default: current dir)"
+  echo "  base-branch    — Branch to diff against (default: auto-detect)"
+  exit 1
+fi
+
+# Resolve to absolute path
+WORKTREE_PATH="$(cd "$WORKTREE_PATH" && pwd)"
+
+echo -e "${CYAN}V-Bounce OS Pre-Gate Scanner${NC}"
+echo -e "Gate: ${YELLOW}${GATE_TYPE}${NC}"
+echo -e "Target: ${WORKTREE_PATH}"
+echo ""
+
+# ── Auto-detect base branch if not provided ──────────────────────────
+
+if [[ -z "$BASE_BRANCH" ]]; then
+  cd "$WORKTREE_PATH"
+  # Try to find the sprint branch this story branched from
+  BASE_BRANCH=$(git log --oneline --merges -1 --format=%H 2>/dev/null || echo "")
+  if [[ -z "$BASE_BRANCH" ]]; then
+    # Fall back to parent branch detection
+    BASE_BRANCH=$(git rev-parse --abbrev-ref HEAD@{upstream} 2>/dev/null || echo "")
+  fi
+fi
+
+# ── Load config or use defaults ──────────────────────────────────────
+
+CONFIG_PATH="${WORKTREE_PATH}/.bounce/gate-checks.json"
+HAS_CONFIG=false
+
+if [[ -f "$CONFIG_PATH" ]]; then
+  HAS_CONFIG=true
+  echo -e "Config: ${GREEN}${CONFIG_PATH}${NC}"
+else
+  # Check parent repo too (worktree might not have it)
+  REPO_ROOT=$(cd "$WORKTREE_PATH" && git rev-parse --show-toplevel 2>/dev/null || echo "$WORKTREE_PATH")
+  CONFIG_PATH="${REPO_ROOT}/.bounce/gate-checks.json"
+  if [[ -f "$CONFIG_PATH" ]]; then
+    HAS_CONFIG=true
+    echo -e "Config: ${GREEN}${CONFIG_PATH}${NC}"
+  else
+    echo -e "Config: ${YELLOW}None found — using universal defaults${NC}"
+  fi
+fi
+
+echo ""
+
+# ── Get modified files ───────────────────────────────────────────────
+
+MODIFIED_FILES=$(get_modified_files "$WORKTREE_PATH" "$BASE_BRANCH")
+
+# ── Run checks ───────────────────────────────────────────────────────
+
+run_checks_from_config() {
+  local gate="$1"
+  local checks_key="${gate}_checks"
+
+  # Parse config with node (available since V-Bounce requires it)
+  local check_ids
+  check_ids=$(node -e "
+    const fs = require('fs');
+    const cfg = JSON.parse(fs.readFileSync('${CONFIG_PATH}', 'utf8'));
+    const checks = cfg['${checks_key}'] || [];
+    checks.filter(c => c.enabled !== false).forEach(c => {
+      console.log(JSON.stringify(c));
+    });
+  " 2>/dev/null)
+
+  while IFS= read -r check_json; do
+    [[ -z "$check_json" ]] && continue
+
+    local id cmd pattern glob should_find max_lines description
+    id=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.id||'')" 2>/dev/null)
+    cmd=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.cmd||'')" 2>/dev/null)
+    pattern=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.pattern||'')" 2>/dev/null)
+    glob=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.glob||'')" 2>/dev/null)
+    should_find=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.should_find||'false')" 2>/dev/null)
+    max_lines=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.max_lines||'500')" 2>/dev/null)
+    description=$(echo "$check_json" | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));console.log(d.description||d.id||'')" 2>/dev/null)
+
+    case "$id" in
+      tests_exist)       check_tests_exist "$WORKTREE_PATH" "$MODIFIED_FILES" ;;
+      tests_pass)        check_tests_pass "$WORKTREE_PATH" ;;
+      build)             check_build "$WORKTREE_PATH" ;;
+      lint)              check_lint "$WORKTREE_PATH" ;;
+      no_debug_output)   check_no_debug_output "$WORKTREE_PATH" "$MODIFIED_FILES" ;;
+      no_todo_fixme)     check_no_todo_fixme "$WORKTREE_PATH" "$MODIFIED_FILES" ;;
+      exports_have_docs) check_exports_have_docs "$WORKTREE_PATH" "$MODIFIED_FILES" ;;
+      no_new_deps)       check_no_new_dependencies "$WORKTREE_PATH" "$BASE_BRANCH" ;;
+      file_size)         check_file_size_limit "$WORKTREE_PATH" "$MODIFIED_FILES" "$max_lines" ;;
+      custom_cmd)        run_custom_check "$WORKTREE_PATH" "$description" "$cmd" "$description" ;;
+      custom_grep)       run_custom_grep_check "$WORKTREE_PATH" "$description" "$pattern" "$glob" "$should_find" ;;
+      *)
+        # Unknown built-in — try as custom command if cmd is provided
+        if [[ -n "$cmd" ]]; then
+          run_custom_check "$WORKTREE_PATH" "$id" "$cmd" "$description"
+        else
+          record_result "$id" "SKIP" "Unknown check type"
+          record_result_plain "$id" "SKIP" "Unknown check type"
+        fi
+        ;;
+    esac
+  done <<< "$check_ids"
+}
+
+run_universal_defaults() {
+  local gate="$1"
+
+  # QA-level checks (always run)
+  check_tests_exist "$WORKTREE_PATH" "$MODIFIED_FILES"
+  check_tests_pass "$WORKTREE_PATH"
+  check_build "$WORKTREE_PATH"
+  check_lint "$WORKTREE_PATH"
+  check_no_debug_output "$WORKTREE_PATH" "$MODIFIED_FILES"
+  check_no_todo_fixme "$WORKTREE_PATH" "$MODIFIED_FILES"
+  check_exports_have_docs "$WORKTREE_PATH" "$MODIFIED_FILES"
+
+  # Architect-level checks (only for arch gate)
+  if [[ "$gate" == "arch" ]]; then
+    check_no_new_dependencies "$WORKTREE_PATH" "$BASE_BRANCH"
+    check_file_size_limit "$WORKTREE_PATH" "$MODIFIED_FILES" 500
+  fi
+}
+
+# ── Execute ──────────────────────────────────────────────────────────
+
+if [[ "$HAS_CONFIG" == "true" ]]; then
+  run_checks_from_config "$GATE_TYPE"
+else
+  run_universal_defaults "$GATE_TYPE"
+fi
+
+# ── Output ───────────────────────────────────────────────────────────
+
+print_summary
+
+# Write report
+REPORT_DIR="${WORKTREE_PATH}/.bounce/reports"
+REPORT_FILE="${REPORT_DIR}/pre-${GATE_TYPE}-scan.txt"
+write_report "$REPORT_FILE"
+echo ""
+echo -e "Report: ${CYAN}${REPORT_FILE}${NC}"
+
+# Exit code
+if [[ $FAIL_COUNT -gt 0 ]]; then
+  echo -e "\n${RED}Gate check failed with ${FAIL_COUNT} failure(s).${NC}"
+  exit 1
+else
+  echo -e "\n${GREEN}All checks passed.${NC}"
+  exit 0
+fi

package/scripts/prep_arch_context.mjs

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+/**
+ * prep_arch_context.mjs
+ * Generates an Architect context pack for a story.
+ *
+ * Usage:
+ *   ./scripts/prep_arch_context.mjs STORY-005-02
+ *
+ * Output: .bounce/arch-context-STORY-005-02.md
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import yaml from 'js-yaml';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+
+const storyId = process.argv[2];
+if (!storyId) {
+  console.error('Usage: prep_arch_context.mjs STORY-ID');
+  process.exit(1);
+}
+
+// Load config
+let config = { maxDiffLines: 500 };
+const configFile = path.join(ROOT, 'vbounce.config.json');
+if (fs.existsSync(configFile)) {
+  try { config = { ...config, ...JSON.parse(fs.readFileSync(configFile, 'utf8')) }; } catch {}
+}
+const MAX_DIFF_LINES = config.maxDiffLines || 500;
+
+function findFilesMatching(dir, pattern) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const e of entries) {
+    const full = path.join(dir, e.name);
+    if (e.isDirectory()) results.push(...findFilesMatching(full, pattern));
+    else if (pattern.test(e.name)) results.push(full);
+  }
+  return results;
+}
+
+const searchDirs = [
+  path.join(ROOT, '.worktrees', storyId, '.bounce', 'reports'),
+  path.join(ROOT, '.bounce', 'reports'),
+  path.join(ROOT, '.bounce', 'archive'),
+];
+
+// 1. Find dev report (required)
+const devPattern = new RegExp(`${storyId.replace(/[-]/g, '[-]')}.*-dev\\.md$`);
+let devReport = null;
+for (const dir of searchDirs) {
+  const m = findFilesMatching(dir, devPattern);
+  if (m.length > 0) { devReport = m[0]; break; }
+}
+if (!devReport) {
+  console.error(`ERROR: Dev report not found for ${storyId}`);
+  process.exit(1);
+}
+
+// 2. Find QA report (optional but warn)
+const qaPattern = new RegExp(`${storyId.replace(/[-]/g, '[-]')}.*-qa.*\\.md$`);
+let qaReport = null;
+for (const dir of searchDirs) {
+  const m = findFilesMatching(dir, qaPattern);
+  if (m.length > 0) { qaReport = m[m.length - 1]; break; } // latest QA report
+}
+if (!qaReport) console.warn(`⚠  QA report not found for ${storyId} — proceeding without it`);
+
+// 3. Find story spec (required)
+const storyPattern = new RegExp(`${storyId.replace(/[-]/g, '[-]')}.*\\.md$`);
+const storyMatches = findFilesMatching(path.join(ROOT, 'product_plans'), storyPattern);
+if (storyMatches.length === 0) {
+  console.error(`ERROR: Story spec not found for ${storyId} in product_plans/`);
+  process.exit(1);
+}
+const storySpecFile = storyMatches[0];
+
+// Parse frontmatters
+let devFm = {}, qaFm = {};
+try {
+  const dc = fs.readFileSync(devReport, 'utf8');
+  const dm = dc.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (dm) devFm = yaml.load(dm[1]) || {};
+} catch {}
+if (qaReport) {
+  try {
+    const qc = fs.readFileSync(qaReport, 'utf8');
+    const qm = qc.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (qm) qaFm = yaml.load(qm[1]) || {};
+  } catch {}
+}
+
+// 4. Get git diff
+let diffContent = '';
+let diffTruncated = false;
+const stateFile = path.join(ROOT, '.bounce', 'state.json');
+try {
+  let diffCmd = 'git diff HEAD~5';
+  if (fs.existsSync(stateFile)) {
+    const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+    const sprintBranch = `sprint/${state.sprint_id}`;
+    try {
+      execSync(`git rev-parse ${sprintBranch}`, { cwd: ROOT, stdio: 'pipe' });
+      diffCmd = `git diff ${sprintBranch}...HEAD`;
+    } catch {}
+  }
+  diffContent = execSync(diffCmd, { cwd: ROOT }).toString();
+
+  if (!diffContent.trim()) {
+    console.warn(`⚠  Git diff is empty — proceeding without diff`);
+  } else {
+    const diffLines = diffContent.split('\n');
+    if (diffLines.length > MAX_DIFF_LINES) {
+      diffTruncated = true;
+      const fullDiffPath = path.join(ROOT, '.bounce', `arch-full-diff-${storyId}.txt`);
+      fs.writeFileSync(fullDiffPath, diffContent);
+      console.warn(`⚠  Diff truncated at ${MAX_DIFF_LINES} lines (was ${diffLines.length}). Full diff saved to .bounce/arch-full-diff-${storyId}.txt`);
+      diffContent = diffLines.slice(0, MAX_DIFF_LINES).join('\n');
+    }
+  }
+} catch (e) {
+  console.warn(`⚠  Could not get git diff: ${e.message}`);
+}
+
+// 5. Read LESSONS.md
+const lessonsFile = path.join(ROOT, 'LESSONS.md');
+let lessonsExcerpt = '_No LESSONS.md found_';
+if (fs.existsSync(lessonsFile)) {
+  const lines = fs.readFileSync(lessonsFile, 'utf8').split('\n');
+  lessonsExcerpt = lines.slice(0, 20).join('\n');
+  if (lines.length > 20) lessonsExcerpt += `\n_(+${lines.length - 20} more lines)_`;
+}
+
+// 6. Assemble context pack
+const lines = [
+  `# Architect Context: ${storyId}`,
+  `> Generated: ${new Date().toISOString().split('T')[0]}`,
+  '',
+  `## Dev Report Summary`,
+  `| Field | Value |`,
+  `|-------|-------|`,
+  `| Status | ${devFm.status || '—'} |`,
+  `| Correction Tax | ${devFm.correction_tax || '—'} |`,
+  `| Tests Written | ${devFm.tests_written ?? '—'} |`,
+  `| Files Modified | ${Array.isArray(devFm.files_modified) ? devFm.files_modified.length : '—'} |`,
+  '',
+  `## QA Report Summary`,
+  qaReport
+    ? [`| Field | Value |`, `|-------|-------|`,
+       `| Status | ${qaFm.status || '—'} |`,
+       `| Bounce Count | ${qaFm.bounce_count ?? '—'} |`,
+       `| Bugs Found | ${qaFm.bugs_found ?? '—'} |`].join('\n')
+    : '_QA report not found_',
+  '',
+  `## Story Spec`,
+  `- File: \`${path.relative(ROOT, storySpecFile)}\``,
+  `- Read §3 Implementation Guide and §3.1 ADR References before auditing`,
+  '',
+  `## Git Diff${diffTruncated ? ` (TRUNCATED at ${MAX_DIFF_LINES} lines — full diff in .bounce/arch-full-diff-${storyId}.txt)` : ''}`,
+  '```diff',
+  diffContent || '(no diff available)',
+  '```',
+  '',
+  `## Relevant Lessons`,
+  lessonsExcerpt,
+];
+
+const output = lines.join('\n');
+const outputFile = path.join(ROOT, '.bounce', `arch-context-${storyId}.md`);
+fs.writeFileSync(outputFile, output);
+console.log(`✓ Architect context pack written to .bounce/arch-context-${storyId}.md`);
+if (diffTruncated) console.log(`  ⚠  Diff truncated — full diff at .bounce/arch-full-diff-${storyId}.txt`);

package/scripts/prep_qa_context.mjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+/**
+ * prep_qa_context.mjs
+ * Generates a QA context pack for a story.
+ *
+ * Usage:
+ *   ./scripts/prep_qa_context.mjs STORY-005-02
+ *
+ * Output: .bounce/qa-context-STORY-005-02.md
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import yaml from 'js-yaml';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+
+const storyId = process.argv[2];
+if (!storyId) {
+  console.error('Usage: prep_qa_context.mjs STORY-ID');
+  process.exit(1);
+}
+
+const MAX_CONTEXT_LINES = 300;
+
+function findFilesMatching(dir, pattern) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const e of entries) {
+    const full = path.join(dir, e.name);
+    if (e.isDirectory()) results.push(...findFilesMatching(full, pattern));
+    else if (pattern.test(e.name)) results.push(full);
+  }
+  return results;
+}
+
+// 1. Find dev report (required)
+const devReportPattern = new RegExp(`${storyId.replace(/[-]/g, '[-]')}.*-dev\\.md$`);
+const searchDirs = [
+  path.join(ROOT, '.worktrees', storyId, '.bounce', 'reports'),
+  path.join(ROOT, '.bounce', 'reports'),
+  path.join(ROOT, '.bounce', 'archive'),
+];
+let devReport = null;
+for (const dir of searchDirs) {
+  const matches = findFilesMatching(dir, devReportPattern);
+  if (matches.length > 0) { devReport = matches[0]; break; }
+}
+
+if (!devReport) {
+  console.error(`ERROR: Dev report not found for ${storyId}. Searched in:`);
+  searchDirs.forEach(d => console.error(`  - ${d}`));
+  process.exit(1);
+}
+
+// Parse dev report frontmatter
+let devFm = {};
+try {
+  const devContent = fs.readFileSync(devReport, 'utf8');
+  const fmMatch = devContent.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (fmMatch) devFm = yaml.load(fmMatch[1]) || {};
+} catch (e) {
+  console.error(`ERROR: Dev report has invalid YAML frontmatter — ${e.message}`);
+  process.exit(1);
+}
+
+// 2. Find story spec (required)
+const storySpecPattern = new RegExp(`${storyId.replace(/[-]/g, '[-]')}.*\\.md$`);
+const storySpecMatches = findFilesMatching(path.join(ROOT, 'product_plans'), storySpecPattern);
+if (storySpecMatches.length === 0) {
+  console.error(`ERROR: Story spec not found for ${storyId} in product_plans/`);
+  process.exit(1);
+}
+const storySpecFile = storySpecMatches[0];
+const storyContent = fs.readFileSync(storySpecFile, 'utf8');
+
+// Extract §2 acceptance criteria
+const criteriaMatch = storyContent.match(/##\s*(2\.|§2|The Truth|Acceptance)[^\n]*\n([\s\S]*?)(?=\n##|\n---|\Z)/i);
+const criteriaSection = criteriaMatch ? criteriaMatch[2].trim().split('\n').slice(0, 30).join('\n') : '_Could not extract §2 — read story spec directly_';
+
+// 3. Read LESSONS.md
+const lessonsFile = path.join(ROOT, 'LESSONS.md');
+let lessonsExcerpt = '_No LESSONS.md found_';
+if (fs.existsSync(lessonsFile)) {
+  const lines = fs.readFileSync(lessonsFile, 'utf8').split('\n');
+  lessonsExcerpt = lines.slice(0, 30).join('\n');
+  if (lines.length > 30) lessonsExcerpt += `\n_(+${lines.length - 30} more lines)_`;
+}
+
+// 4. Format files modified list
+const filesModified = Array.isArray(devFm.files_modified)
+  ? devFm.files_modified.map(f => `- ${f}`).join('\n')
+  : '_Not specified in dev report_';
+
+// 5. Assemble context pack
+const lines = [
+  `# QA Context: ${storyId}`,
+  `> Generated: ${new Date().toISOString().split('T')[0]}`,
+  `> Dev report: ${path.relative(ROOT, devReport)}`,
+  `> Story spec: ${path.relative(ROOT, storySpecFile)}`,
+  '',
+  `## Dev Report Summary`,
+  `| Field | Value |`,
+  `|-------|-------|`,
+  `| Status | ${devFm.status || '—'} |`,
+  `| Correction Tax | ${devFm.correction_tax || '—'} |`,
+  `| Tests Written | ${devFm.tests_written ?? '—'} |`,
+  `| Lessons Flagged | ${devFm.lessons_flagged || 'none'} |`,
+  '',
+  `## Story Acceptance Criteria (§2)`,
+  criteriaSection,
+  '',
+  `## Files Modified`,
+  filesModified,
+  '',
+  `## Relevant Lessons`,
+  lessonsExcerpt,
+];
+
+const output = lines.join('\n');
+const outputLines = output.split('\n');
+let finalOutput = output;
+if (outputLines.length > MAX_CONTEXT_LINES) {
+  finalOutput = outputLines.slice(0, MAX_CONTEXT_LINES).join('\n');
+  finalOutput += `\n\n> ⚠ Truncated at ${MAX_CONTEXT_LINES} lines. Read source files for complete content.`;
+}
+
+const outputFile = path.join(ROOT, '.bounce', `qa-context-${storyId}.md`);
+fs.writeFileSync(outputFile, finalOutput);
+console.log(`✓ QA context pack written to .bounce/qa-context-${storyId}.md`);

package/scripts/prep_sprint_context.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+/**
+ * prep_sprint_context.mjs
+ * Generates a sprint context pack — single file replacing 6+ separate reads.
+ *
+ * Usage:
+ *   ./scripts/prep_sprint_context.mjs S-05
+ *
+ * Output: .bounce/sprint-context-S-05.md
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+
+const sprintId = process.argv[2];
+if (!sprintId) {
+  console.error('Usage: prep_sprint_context.mjs S-XX');
+  process.exit(1);
+}
+
+const MAX_CONTEXT_LINES = 200;
+
+// 1. Read state.json (required)
+const stateFile = path.join(ROOT, '.bounce', 'state.json');
+if (!fs.existsSync(stateFile)) {
+  console.error('ERROR: .bounce/state.json not found. Run: vbounce sprint init');
+  process.exit(1);
+}
+const state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+
+// 2. Find sprint plan
+const sprintNum = sprintId.replace('S-', '');
+const sprintPlanPath = path.join(ROOT, 'product_plans', 'sprints', `sprint-${sprintNum}`, `sprint-${sprintNum}.md`);
+if (!fs.existsSync(sprintPlanPath)) {
+  console.error(`ERROR: Sprint plan not found at ${sprintPlanPath}`);
+  process.exit(1);
+}
+const sprintPlan = fs.readFileSync(sprintPlanPath, 'utf8');
+
+// Extract sprint goal from frontmatter
+const goalMatch = sprintPlan.match(/sprint_goal:\s*"([^"]+)"/);
+const sprintGoal = goalMatch ? goalMatch[1] : 'TBD';
+
+// 3. Read LESSONS.md (first 50 lines)
+const lessonsFile = path.join(ROOT, 'LESSONS.md');
+let lessonsExcerpt = '_No LESSONS.md found_';
+if (fs.existsSync(lessonsFile)) {
+  const lines = fs.readFileSync(lessonsFile, 'utf8').split('\n');
+  lessonsExcerpt = lines.slice(0, 50).join('\n');
+  if (lines.length > 50) lessonsExcerpt += `\n\n_(${lines.length - 50} more lines — read LESSONS.md for full content)_`;
+}
+
+// 4. Find RISK_REGISTRY
+let riskExcerpt = '_No RISK_REGISTRY.md found_';
+const riskPaths = [
+  path.join(ROOT, 'product_plans', 'strategy', 'RISK_REGISTRY.md'),
+  path.join(ROOT, 'RISK_REGISTRY.md'),
+];
+for (const rp of riskPaths) {
+  if (fs.existsSync(rp)) {
+    const lines = fs.readFileSync(rp, 'utf8').split('\n');
+    riskExcerpt = lines.slice(0, 20).join('\n');
+    if (lines.length > 20) riskExcerpt += `\n\n_(${lines.length - 20} more lines — read RISK_REGISTRY.md for full content)_`;
+    break;
+  }
+}
+
+// 5. Build story state table from state.json
+const storyRows = Object.entries(state.stories || {})
+  .map(([id, s]) => `| ${id} | ${s.state} | ${s.qa_bounces} | ${s.arch_bounces} | ${s.worktree || '—'} |`)
+  .join('\n');
+
+// 6. Assemble context pack
+const lines = [
+  `# Sprint Context: ${sprintId}`,
+  `> Generated: ${new Date().toISOString().split('T')[0]} | Sprint: ${sprintId} | Delivery: ${state.delivery_id}`,
+  '',
+  `## Sprint Plan Summary`,
+  `- **Goal**: ${sprintGoal}`,
+  `- **Phase**: ${state.phase || 'N/A'}`,
+  `- **Last action**: ${state.last_action || 'N/A'}`,
+  `- **Stories**: ${Object.keys(state.stories || {}).length}`,
+  '',
+  `## Current State`,
+  `| Story | State | QA Bounces | Arch Bounces | Worktree |`,
+  `|-------|-------|------------|--------------|----------|`,
+  storyRows || '| (no stories) | — | — | — | — |',
+  '',
+  `## Relevant Lessons`,
+  lessonsExcerpt,
+  '',
+  `## Risk Summary`,
+  riskExcerpt,
+];
+
+const output = lines.join('\n');
+const outputLines = output.split('\n');
+
+let finalOutput = output;
+let truncated = false;
+if (outputLines.length > MAX_CONTEXT_LINES) {
+  finalOutput = outputLines.slice(0, MAX_CONTEXT_LINES).join('\n');
+  finalOutput += `\n\n> ⚠ Context pack truncated at ${MAX_CONTEXT_LINES} lines (was ${outputLines.length}). Read source files for complete content.`;
+  truncated = true;
+}
+
+// 7. Write output
+const outputFile = path.join(ROOT, '.bounce', `sprint-context-${sprintId}.md`);
+fs.writeFileSync(outputFile, finalOutput);
+
+console.log(`✓ Sprint context pack written to .bounce/sprint-context-${sprintId}.md`);
+if (truncated) console.warn(`  ⚠  Content was truncated (exceeded ${MAX_CONTEXT_LINES} lines)`);
+console.log(`  Stories: ${Object.keys(state.stories || {}).length} | Phase: ${state.phase || 'N/A'}`);