@girardmedia/bootspring 2.0.18 → 2.0.21

package/bin/bootspring.js

@@ -467,6 +467,18 @@ async function main() {
   try {
     const commandModule = require(scriptPath);
 
+    // Track command usage (silent, best-effort)
+    try {
+      const telemetry = require('../core/telemetry');
+      telemetry.emitEvent('cli.command', {
+        command,
+        subcommand: commandArgs[0] || null,
+        hasFlags: commandArgs.some(arg => arg.startsWith('-'))
+      });
+    } catch {
+      // Telemetry is optional - don't fail commands if it errors
+    }
+
     // Execute command
     if (typeof commandModule.run === 'function') {
       await commandModule.run(commandArgs);

package/cli/generate.js

@@ -218,6 +218,28 @@ ${utils.COLORS.dim}Regenerating AI context...${utils.COLORS.reset}
     return;
   }
 
+  // Generate todo.md if missing (required for 100% score)
+  const todoPath = path.join(cfg._projectRoot, cfg.paths?.todo || 'todo.md');
+  if (!utils.fileExists(todoPath)) {
+    const todoSpinner = utils.createSpinner('Generating todo.md').start();
+    const todoContent = `# ${cfg.project.name} - Todo List
+
+> Last updated: ${utils.formatDate()}
+
+## In Progress
+
+## Pending
+
+- [ ] Review generated context
+- [ ] Configure environment variables
+
+## Completed
+
+`;
+    utils.writeFile(todoPath, todoContent);
+    todoSpinner.succeed('Generated todo.md');
+  }
+
   // Validate context
   const validation = context.validate({ config: cfg });
 
@@ -264,28 +286,6 @@ ${utils.COLORS.bold}Score:${utils.COLORS.reset} ${validation.score}/${validation
       mcpSpinner.succeed('Generated .mcp.json');
     }
 
-    // Generate todo.md if missing
-    const todoPath = path.join(cfg._projectRoot, cfg.paths?.todo || 'todo.md');
-    if (!utils.fileExists(todoPath)) {
-      const todoSpinner = utils.createSpinner('Generating todo.md').start();
-      const todoContent = `# ${cfg.project.name} - Todo List
-
-> Last updated: ${utils.formatDate()}
-
-## In Progress
-
-## Pending
-
-- [ ] Review generated context
-- [ ] Configure environment variables
-
-## Completed
-
-`;
-      utils.writeFile(todoPath, todoContent);
-      todoSpinner.succeed('Generated todo.md');
-    }
-
     // Generate AGENTS.md for multi-tool compatibility
     const agentsPath = path.join(cfg._projectRoot, 'AGENTS.md');
     const agentsSpinner = utils.createSpinner('Generating AGENTS.md').start();

package/cli/seed.js

@@ -1116,7 +1116,7 @@ function extractProblem(docs) {
         // Remove section number prefixes like "2.1 " at start of content
         .replace(/^[\d.]+\s+[A-Z][a-z]+\s+[a-z]+\n/m, '')
         // Convert bullet points to flowing text
-        .replace(/^[\-\*]\s+\*{0,2}([^*\n:]+):?\*{0,2}\s*/gm, '$1: ')
+        .replace(/^[-*]\s+\*{0,2}([^*\n:]+):?\*{0,2}\s*/gm, '$1: ')
         // Remove remaining markdown
         .replace(/\*+/g, '')
         .trim();
@@ -1139,7 +1139,7 @@ function extractProblem(docs) {
       const cleaned = problemSection
         .replace(/^#{1,4}\s+[\d.]+\s+[^\n]+\n/gm, '')
         .replace(/^[\d.]+\s+[A-Z][a-z]+\s+[a-z]+\n/m, '')
-        .replace(/^[\-\*]\s+\*{0,2}([^*\n:]+):?\*{0,2}\s*/gm, '$1: ')
+        .replace(/^[-*]\s+\*{0,2}([^*\n:]+):?\*{0,2}\s*/gm, '$1: ')
         .replace(/\*+/g, '')
         .trim();
 
@@ -1167,7 +1167,7 @@ function extractSolution(docs) {
     if (solutionSection) {
       const paragraphs = solutionSection.split(/\n\n/).filter(p => p.trim().length > 50);
       if (paragraphs.length > 0) {
-        return paragraphs[0].replace(/^[#\*\-\d\.]+\s*/gm, '').replace(/\*+/g, '').trim();
+        return paragraphs[0].replace(/^[#*\d.-]+\s*/gm, '').replace(/\*+/g, '').trim();
       }
     }
 
@@ -1303,10 +1303,10 @@ function extractMVPFeatures(docs) {
   if (features.length === 0) {
     const journeySection = extractSection(prdDoc, 'Core\\s+User\\s+Journeys|User\\s+Journeys', { maxLength: 3000 });
     if (journeySection) {
-      const journeyHeaders = journeySection.match(/^#{1,4}\s+\d+\.\d+\s+Journey\s+\d+\s*[—\-]\s*(.+)$/gm);
+      const journeyHeaders = journeySection.match(/^#{1,4}\s+\d+\.\d+\s+Journey\s+\d+\s*[—-]\s*(.+)$/gm);
       if (journeyHeaders) {
         journeyHeaders.forEach(h => {
-          const match = h.match(/Journey\s+\d+\s*[—\-]\s*(.+)/);
+          const match = h.match(/Journey\s+\d+\s*[—-]\s*(.+)/);
           if (match) features.push(match[1].trim());
         });
       }
@@ -1329,10 +1329,10 @@ function extractTargetUsers(docs) {
 
   // Try AUDIENCE doc first - look for "## X.X Persona PX — Name" pattern
   if (audienceDoc) {
-    const personaMatches = audienceDoc.match(/^#{1,4}\s+\d+\.\d+\s+Persona\s+P?\d+\s*[—\-]\s*(.+)$/gm);
+    const personaMatches = audienceDoc.match(/^#{1,4}\s+\d+\.\d+\s+Persona\s+P?\d+\s*[—-]\s*(.+)$/gm);
     if (personaMatches) {
       personaMatches.forEach(m => {
-        const match = m.match(/[—\-]\s*(.+)/);
+        const match = m.match(/[—-]\s*(.+)/);
         if (match && match[1]) personas.push(match[1].trim());
       });
     }
@@ -1353,7 +1353,7 @@ function extractTargetUsers(docs) {
     const targetSection = extractSection(visionDoc, 'Target\\s+Users|Who\\s+This\\s+Is\\s+For', { maxLength: 2000 });
     if (targetSection) {
       // Look for bold text patterns like "- **AI Agencies & AI Arbitrage Specialists**"
-      const boldMatches = targetSection.match(/^\s*[\-\*]\s*\*{2}([^*]+)\*{2}/gm);
+      const boldMatches = targetSection.match(/^\s*[-*]\s*\*{2}([^*]+)\*{2}/gm);
       if (boldMatches) {
         boldMatches.forEach(m => {
           const match = m.match(/\*{2}([^*]+)\*{2}/);
@@ -1367,10 +1367,10 @@ function extractTargetUsers(docs) {
   if (prdDoc && personas.length === 0) {
     const personaSection = extractSection(prdDoc, 'Personas|Who\\s+We\\s+Serve', { maxLength: 2000 });
     if (personaSection) {
-      const personaMatches = personaSection.match(/^#{1,4}\s+\d+\.\d+\s+Persona\s+[A-Z]\s*[—\-]\s*(.+)$/gm);
+      const personaMatches = personaSection.match(/^#{1,4}\s+\d+\.\d+\s+Persona\s+[A-Z]\s*[—-]\s*(.+)$/gm);
       if (personaMatches) {
         personaMatches.forEach(m => {
-          const match = m.match(/[—\-]\s*(.+)/);
+          const match = m.match(/[—-]\s*(.+)/);
           if (match && match[1]) personas.push(match[1].trim());
         });
       }
@@ -1394,7 +1394,7 @@ function extractDatabaseEntities(docs) {
   const tableSection = extractSection(techDoc, 'Key\\s+tables|Data\\s+Model|Database\\s+Schema', { maxLength: 3000 });
   if (tableSection) {
     // Extract backticked table names from bullet points in this specific section
-    const bulletTableMatches = tableSection.match(/^\s*[\-\*]\s*`(\w+)`/gm);
+    const bulletTableMatches = tableSection.match(/^\s*[-*]\s*`(\w+)`/gm);
     if (bulletTableMatches) {
       bulletTableMatches.forEach(m => {
         const match = m.match(/`(\w+)`/);
@@ -1461,11 +1461,11 @@ function extractImplementationPhases(docs) {
 
   // Prioritize full phase sections: "## X. Phase N —" (with section number)
   // These have the actual deliverables, unlike brief summaries
-  const fullPhaseMatches = roadmapDoc.match(/^##\s+\d+\.\s+Phase\s+\d+\s*[—\-]+\s*(.+)$/gm);
+  const fullPhaseMatches = roadmapDoc.match(/^##\s+\d+\.\s+Phase\s+\d+\s*[—-]+\s*(.+)$/gm);
 
   if (fullPhaseMatches) {
     fullPhaseMatches.forEach(m => {
-      const match = m.match(/Phase\s+(\d+)\s*[—\-]+\s*(.+)$/);
+      const match = m.match(/Phase\s+(\d+)\s*[—-]+\s*(.+)$/);
       if (match && match[1] && match[2]) {
         const phaseNum = match[1];
         if (seenPhases.has(phaseNum)) return;
@@ -1478,7 +1478,7 @@ function extractImplementationPhases(docs) {
         const deliverables = [];
 
         // Find the full section for this specific phase (## X. Phase N — until next ## X. Phase)
-        const phaseRegex = new RegExp(`##\\s+\\d+\\.\\s+Phase\\s+${phaseNum}\\s*[—\\-][\\s\\S]*?(?=##\\s+\\d+\\.\\s+Phase\\s+\\d+|$)`, 'i');
+        const phaseRegex = new RegExp(`##\\s+\\d+\\.\\s+Phase\\s+${phaseNum}\\s*[—-][\\s\\S]*?(?=##\\s+\\d+\\.\\s+Phase\\s+\\d+|$)`, 'i');
         const phaseSectionMatch = roadmapDoc.match(phaseRegex);
 
         if (phaseSectionMatch) {
@@ -1490,10 +1490,10 @@ function extractImplementationPhases(docs) {
 
           if (deliverablesMatch) {
             // Extract bullet points
-            const bullets = deliverablesMatch[0].match(/^[\-\*]\s+(.+)$/gm);
+            const bullets = deliverablesMatch[0].match(/^[-*]\s+(.+)$/gm);
             if (bullets) {
               bullets.slice(0, 6).forEach(b => {
-                const text = b.replace(/^[\-\*]\s+/, '').trim();
+                const text = b.replace(/^[-*]\s+/, '').trim();
                 if (text.length > 3) deliverables.push(text);
               });
             }
@@ -1521,10 +1521,10 @@ function extractImplementationPhases(docs) {
             const exitMatch = phaseContent.match(exitCriteriaRegex);
             if (exitMatch) {
               // Extract checkmark items like "- ✅ Description"
-              const checkItems = exitMatch[0].match(/^[\-\*]\s+[✅✓]\s*(.+)$/gm);
+              const checkItems = exitMatch[0].match(/^[-*]\s+[✅✓]\s*(.+)$/gm);
               if (checkItems) {
                 checkItems.slice(0, 5).forEach(item => {
-                  const text = item.replace(/^[\-\*]\s+[✅✓]\s*/, '').trim();
+                  const text = item.replace(/^[-*]\s+[✅✓]\s*/, '').trim();
                   if (text.length > 5) deliverables.push(text);
                 });
               }
@@ -1537,10 +1537,10 @@ function extractImplementationPhases(docs) {
             const goalMatch = phaseContent.match(goalRegex);
             if (goalMatch) {
               // Extract bullet points or bold items
-              const bullets = goalMatch[0].match(/^[\-\*]\s+(.+)$/gm);
+              const bullets = goalMatch[0].match(/^[-*]\s+(.+)$/gm);
               if (bullets) {
                 bullets.slice(0, 4).forEach(b => {
-                  const text = b.replace(/^[\-\*]\s+/, '').trim();
+                  const text = b.replace(/^[-*]\s+/, '').trim();
                   if (text.length > 3) deliverables.push(text);
                 });
               }
@@ -1639,10 +1639,10 @@ function extractAPIRoutes(docs) {
 
     if (appStructureSection) {
       // Extract page routes like "- `/dashboard`" or "- `/agents`" or "- `/agents/[id]`"
-      const pageRoutes = appStructureSection.match(/[-*]\s*`\/([\w\/\[\]]+)`/g);
+      const pageRoutes = appStructureSection.match(/[-*]\s*`\/([\w/[\]]+)`/g);
       if (pageRoutes) {
         pageRoutes.forEach(r => {
-          const match = r.match(/`(\/[\w\/\[\]]+)`/);
+          const match = r.match(/`(\/[\w/[\]]+)`/);
           if (match && match[1]) {
             const route = match[1];
             // Skip if it looks like a citation URL
@@ -1673,7 +1673,7 @@ function extractAPIRoutes(docs) {
     }
 
     // Also look for explicit /api/ routes in backticks
-    const explicitRoutes = techDoc.match(/`\/api\/[\w\/\[\]-]+`/g);
+    const explicitRoutes = techDoc.match(/`\/api\/[\w/[\]-]+`/g);
     if (explicitRoutes) {
       explicitRoutes.forEach(r => {
         const route = r.replace(/`/g, '');
@@ -1735,7 +1735,7 @@ function extractArchitecture(docs) {
     const archSection = extractSection(techDoc, 'Architecture|System\\s+Components', { maxLength: 2000 });
     if (archSection) {
       // Look for bold component names like "- **Component Name**"
-      const boldMatches = archSection.match(/^\s*[\-\*]\s+\*{2}([^*]+)\*{2}/gm);
+      const boldMatches = archSection.match(/^\s*[-*]\s+\*{2}([^*]+)\*{2}/gm);
       if (boldMatches) {
         boldMatches.forEach(m => {
           const match = m.match(/\*{2}([^*]+)\*{2}/);

package/core/context.js

@@ -251,8 +251,7 @@ function validate(options = {}) {
     checks.push({ name: 'Todo Tracking', status: 'pass', message: 'todo.md exists' });
     score += 1;
   } else {
-    checks.push({ name: 'Todo Tracking', status: 'info', message: 'todo.md not found - optional' });
-    score += 0.5;
+    checks.push({ name: 'Todo Tracking', status: 'fail', message: 'todo.md not found' });
   }
 
   return {

package/core/task-extractor.js

@@ -157,7 +157,7 @@ function extractFromPrd(content) {
   // Extract from Core User Journeys
   const journeySection = extractSection(content, 'Core\\s+User\\s+Journeys|User\\s+Journeys', { maxLength: 5000 });
   if (journeySection) {
-    const journeyMatches = journeySection.matchAll(/^#{1,4}\s+\d+\.\d+\s+Journey\s+\d+\s*[—\-]\s*(.+)$/gm);
+    const journeyMatches = journeySection.matchAll(/^#{1,4}\s+\d+\.\d+\s+Journey\s+\d+\s*[—-]\s*(.+)$/gm);
     for (const match of journeyMatches) {
       const journeyName = match[1].trim();
 
@@ -189,7 +189,7 @@ function extractFromRoadmap(content) {
   const seenPhases = new Set();
 
   // Extract phase headers: "## X. Phase N — Name"
-  const phaseMatches = content.matchAll(/^##\s+\d+\.\s+Phase\s+(\d+)\s*[—\-]+\s*(.+)$/gm);
+  const phaseMatches = content.matchAll(/^##\s+\d+\.\s+Phase\s+(\d+)\s*[—-]+\s*(.+)$/gm);
 
   for (const match of phaseMatches) {
     const phaseNum = match[1];
@@ -205,7 +205,7 @@ function extractFromRoadmap(content) {
 
     // Extract deliverables for this phase
     const phaseRegex = new RegExp(
-      `##\\s+\\d+\\.\\s+Phase\\s+${phaseNum}\\s*[—\\-][\\s\\S]*?(?=##\\s+\\d+\\.\\s+Phase\\s+\\d+|$)`,
+      `##\\s+\\d+\\.\\s+Phase\\s+${phaseNum}\\s*[—-][\\s\\S]*?(?=##\\s+\\d+\\.\\s+Phase\\s+\\d+|$)`,
       'i'
     );
     const phaseSectionMatch = content.match(phaseRegex);
@@ -219,10 +219,10 @@ function extractFromRoadmap(content) {
       const deliverablesMatch = phaseContent.match(deliverablesRegex);
 
       if (deliverablesMatch) {
-        const bullets = deliverablesMatch[0].match(/^[\-\*]\s+(.+)$/gm);
+        const bullets = deliverablesMatch[0].match(/^[-*]\s+(.+)$/gm);
         if (bullets) {
           bullets.slice(0, 8).forEach(b => {
-            const text = b.replace(/^[\-\*]\s+/, '').trim();
+            const text = b.replace(/^[-*]\s+/, '').trim();
             if (text.length > 3) {
               deliverables.push(text);
 
@@ -269,10 +269,10 @@ function extractFromRoadmap(content) {
       const exitCriteriaRegex = /###\s+[\d.]+\s*Exit\s+Criteria[\s\S]*?(?=###|##|$)/i;
       const exitMatch = phaseContent.match(exitCriteriaRegex);
       if (exitMatch) {
-        const checkItems = exitMatch[0].match(/^[\-\*]\s+[✅✓⬜]\s*(.+)$/gm);
+        const checkItems = exitMatch[0].match(/^[-*]\s+[✅✓⬜]\s*(.+)$/gm);
         if (checkItems) {
           checkItems.forEach(item => {
-            const text = item.replace(/^[\-\*]\s+[✅✓⬜]\s*/, '').trim();
+            const text = item.replace(/^[-*]\s+[✅✓⬜]\s*/, '').trim();
             if (text.length > 5 && !deliverables.includes(text)) {
               deliverables.push(text);
             }
@@ -304,7 +304,7 @@ function extractFromTechnicalSpec(content) {
   const dbSection = extractSection(content, 'Data\\s+Model|Database|Key\\s+tables', { maxLength: 3000 });
   if (dbSection) {
     // Look for table names
-    const tableMatches = dbSection.match(/^\s*[\-\*]\s*`(\w+)`/gm);
+    const tableMatches = dbSection.match(/^\s*[-*]\s*`(\w+)`/gm);
     if (tableMatches && tableMatches.length > 0) {
       tasks.push({
         title: 'Set up database schema with Prisma',
@@ -328,7 +328,7 @@ function extractFromTechnicalSpec(content) {
   if (apiSection) {
     // Group related API routes
     const apiGroups = new Map();
-    const apiMatches = apiSection.matchAll(/`\/api\/([^`\/]+)/g);
+    const apiMatches = apiSection.matchAll(/`\/api\/([^`/]+)/g);
 
     for (const match of apiMatches) {
       const group = match[1];
@@ -446,10 +446,10 @@ function extractMvpCriteria(content) {
   const successSection = extractSection(content, 'MVP\\s+Success|Success\\s+Criteria|Definition\\s+of\\s+Done', { maxLength: 3000 });
 
   if (successSection) {
-    const bulletMatches = successSection.match(/^[\-\*]\s+(.+)$/gm);
+    const bulletMatches = successSection.match(/^[-*]\s+(.+)$/gm);
     if (bulletMatches) {
       bulletMatches.forEach(b => {
-        const text = b.replace(/^[\-\*]\s+/, '').replace(/\*+/g, '').trim();
+        const text = b.replace(/^[-*]\s+/, '').replace(/\*+/g, '').trim();
         if (text.length > 5) {
           criteria.push({
             name: text,
@@ -572,10 +572,10 @@ function extractAcceptanceCriteria(content, featureId) {
     const featureContent = featureMatch[0];
 
     // Look for bullet points
-    const bulletMatches = featureContent.match(/^[\-\*]\s+(.+)$/gm);
+    const bulletMatches = featureContent.match(/^[-*]\s+(.+)$/gm);
     if (bulletMatches) {
       bulletMatches.slice(0, 5).forEach(b => {
-        const text = b.replace(/^[\-\*]\s+/, '').replace(/\*+/g, '').trim();
+        const text = b.replace(/^[-*]\s+/, '').replace(/\*+/g, '').trim();
         if (text.length > 5 && text.length < 200) {
           criteria.push(text);
         }

package/mcp/contracts/mcp-contract.v1.json

@@ -1,7 +1,7 @@
 {
   "contractVersion": "v1",
   "packageName": "@girardmedia/bootspring",
-  "packageVersion": "2.0.18",
+  "packageVersion": "2.0.21",
   "tools": [
     {
       "name": "bootspring_assist",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.0.18",
+  "version": "2.0.21",
   "description": "Development scaffolding with intelligence - AI-powered context, agents, and workflows for any MCP-compatible assistant",
   "keywords": [
     "ai",