@girardmedia/bootspring 2.1.1 → 2.1.2

package/cli/build.js

@@ -1229,6 +1229,83 @@ ${c.bold}Next steps:${c.reset}
 `);
 }
 
+/**
+ * Extract non-task supplementary content from TASK_QUEUE.md.
+ * Captures context notes, architecture diagrams, integration guidelines,
+ * and any section that isn't the task table or per-task detail blocks.
+ */
+function extractSupplementaryContent(queueContent) {
+  const lines = queueContent.split('\n');
+  const sections = [];
+  let currentSection = null;
+  let inTaskTable = false;
+  let inTaskDetail = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    // Detect task table (starts with | Position | or | # |)
+    if (/^\|\s*(Position|#)\s*\|/.test(line)) {
+      inTaskTable = true;
+      continue;
+    }
+    // Still in task table (rows starting with |)
+    if (inTaskTable && /^\|/.test(line)) {
+      continue;
+    }
+    if (inTaskTable && !/^\|/.test(line)) {
+      inTaskTable = false;
+    }
+
+    // Detect per-task detail blocks (### task-XXX: or ### bs-XXX:)
+    if (/^###\s+(task-\d+|bs-\d+)\s*:/.test(line)) {
+      inTaskDetail = true;
+      continue;
+    }
+    // End task detail at next ### or ## heading
+    if (inTaskDetail && /^#{2,3}\s+/.test(line) && !/^###\s+(task-\d+|bs-\d+)\s*:/.test(line)) {
+      inTaskDetail = false;
+    }
+    if (inTaskDetail) continue;
+
+    // Skip the header, queue status heading, and generated boilerplate
+    if (/^#\s+.*Implementation Queue/.test(line)) continue;
+    if (/^>\s*(Ordered task queue|Last Updated|Current Version)/.test(line)) continue;
+    if (/^## Queue Status/.test(line)) { inTaskTable = true; continue; }
+    if (/^## Task Details/.test(line)) { inTaskDetail = true; continue; }
+    if (/^\*Generated by/.test(line)) continue;
+    if (/^---$/.test(line.trim())) continue;
+
+    // Detect section headings for supplementary content
+    if (/^##\s+/.test(line) && !/^## (Queue Status|Task Details|Execution Guidelines)/.test(line)) {
+      if (currentSection) sections.push(currentSection);
+      currentSection = { heading: line, lines: [] };
+      continue;
+    }
+
+    // Execution Guidelines is useful — keep it
+    if (/^## Execution Guidelines/.test(line)) {
+      if (currentSection) sections.push(currentSection);
+      currentSection = { heading: line, lines: [] };
+      continue;
+    }
+
+    if (currentSection) {
+      currentSection.lines.push(line);
+    }
+  }
+
+  if (currentSection) sections.push(currentSection);
+
+  // Filter out empty sections and build output
+  const output = sections
+    .filter(s => s.lines.some(l => l.trim().length > 0))
+    .map(s => `${s.heading}\n\n${s.lines.join('\n').trim()}`)
+    .join('\n\n---\n\n');
+
+  return output.trim();
+}
+
 /**
  * Migrate from TASK_QUEUE.md to TODO.md as single source of truth.
  */
@@ -1266,17 +1343,33 @@ ${c.cyan}${c.bold}Migrating to TODO.md as Single Source of Truth${c.reset}
     }
   }
 
-  // Step 2: Generate enriched TODO.md with full acceptance criteria
+  // Step 2: Extract non-task content from TASK_QUEUE.md (context notes, diagrams, guidelines)
+  let supplementaryContent = '';
+  if (fs.existsSync(queuePath)) {
+    const queueContent = fs.readFileSync(queuePath, 'utf-8');
+    supplementaryContent = extractSupplementaryContent(queueContent);
+  }
+
+  // Step 3: Generate enriched TODO.md with full task metadata
   const planningTemplate = require('../generators/templates/build-planning.template');
-  const todo = planningTemplate.generateTodo(state.implementationQueue, {
+  let todo = planningTemplate.generateTodo(state.implementationQueue, {
     projectName: state.projectName
   });
+
+  // Append supplementary content if any was extracted
+  if (supplementaryContent) {
+    todo += `\n---\n\n## Reference (from TASK_QUEUE.md)\n\n${supplementaryContent}\n`;
+  }
+
   fs.writeFileSync(todoPath, todo);
 
   const stats = buildState.getStats(projectRoot);
   console.log(`${c.green}✓${c.reset} Generated TODO.md with ${state.implementationQueue.length} tasks (${stats?.completed || 0} completed)`);
+  if (supplementaryContent) {
+    console.log(`${c.green}✓${c.reset} Preserved supplementary content (context notes, diagrams, guidelines)`);
+  }
 
-  // Step 3: Archive TASK_QUEUE.md unless --keep-queue
+  // Step 4: Archive TASK_QUEUE.md unless --keep-queue
   if (fs.existsSync(queuePath) && !keepQueue) {
     const archivePath = path.join(planningDir, 'TASK_QUEUE.md.bak');
     fs.renameSync(queuePath, archivePath);
@@ -1290,7 +1383,8 @@ ${c.green}${c.bold}Migration complete${c.reset}
 
 ${c.bold}What changed:${c.reset}
   - ${c.cyan}planning/TODO.md${c.reset} is now the single source of truth
-  - Task IDs, acceptance criteria, and status are all inline
+  - Task IDs, source, description, acceptance criteria, and status are all inline
+  - Non-task content (context notes, diagrams, guidelines) preserved in Reference section
   - Build loop reads TODO.md instead of TASK_QUEUE.md
 ${!keepQueue && fs.existsSync(path.join(planningDir, 'TASK_QUEUE.md.bak')) ? `  - Old TASK_QUEUE.md archived as TASK_QUEUE.md.bak
 ` : ''}

package/generators/templates/build-planning.template.js

@@ -288,7 +288,28 @@ function generateTodo(tasks, options = {}) {
         task.status === 'skipped' ? ' (`skipped`)' : '';
       content += `- ${checkbox} \`${task.id}\` ${task.title}${statusTag}\n`;
 
-      // Add acceptance criteria as sub-items (all of them — this is the source of truth)
+      // Source traceability
+      if (task.source) {
+        const sourceStr = task.sourceSection
+          ? `${task.source} (${task.sourceSection})`
+          : task.source;
+        content += `  - **Source:** ${sourceStr}\n`;
+      }
+
+      // Description
+      if (task.description) {
+        content += `  - **Description:** ${task.description}\n`;
+      }
+
+      // Complexity and dependencies
+      if (task.estimatedComplexity && task.estimatedComplexity !== 'medium') {
+        content += `  - **Complexity:** ${task.estimatedComplexity}\n`;
+      }
+      if (task.dependencies && task.dependencies.length > 0) {
+        content += `  - **Dependencies:** ${task.dependencies.join(', ')}\n`;
+      }
+
+      // Acceptance criteria as sub-items (all of them — this is the source of truth)
       if (task.acceptanceCriteria && task.acceptanceCriteria.length > 0) {
         for (const criteria of task.acceptanceCriteria) {
           const subCheckbox = task.status === 'completed' ? '[x]' : '[ ]';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
   "keywords": [
     "ai",