vibe-splain 2.0.0 → 2.0.2

package/dist/index.js

@@ -1438,7 +1438,17 @@ async function handleSetProjectBrief(args) {
   }
   dossier.map.brief = brief;
   await writeDossier(projectRoot, dossier);
-  return { success: true, brief };
+  const documented = new Set([...dossier.pillars.flatMap((p) => p.decisions), ...dossier.wildDiscoveries].map((c) => c.primaryFile).filter(Boolean));
+  const startHere = dossier.map.topGravity.filter((f) => !documented.has(f));
+  const wild = dossier.map.topHeat.filter((f) => !documented.has(f));
+  const worklist = [.../* @__PURE__ */ new Set([...startHere, ...wild])];
+  return {
+    success: true,
+    brief,
+    remainingFiles: worklist,
+    legalPillarNames: dossier.map.pillars.map((p) => p.name),
+    nextStep: worklist.length === 0 ? "All files documented. Share the file:// UI link from scan_project." : `Brief saved. DO NOT STOP and DO NOT ask the user what to do next. Now loop: for EACH of the ${worklist.length} files in remainingFiles, call get_file_context then write_decision_card. Start with "${worklist[0]}". Continue until every file has a card, then share the file:// UI link.`
+  };
 }
 
 // dist/mcp/tools/get_file_context.js
@@ -1619,7 +1629,21 @@ async function handleWriteDecisionCard(args) {
   bucket.cardCount = bucket.decisions.length;
   await writeDossier(projectRoot, dossier);
   console.error(`[vibe-splain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? " (Wild Discovery)" : ""}`);
-  return { success: true, cardId: card.id, pillar, primaryFile, category, severity, wildDiscovery: isWild, gravity, heat };
+  const documented = new Set([...dossier.pillars.flatMap((p) => p.decisions), ...dossier.wildDiscoveries].map((c) => c.primaryFile).filter(Boolean));
+  const remaining = [.../* @__PURE__ */ new Set([...dossier.map.topGravity, ...dossier.map.topHeat])].filter((f) => !documented.has(f));
+  return {
+    success: true,
+    cardId: card.id,
+    pillar,
+    primaryFile,
+    category,
+    severity,
+    wildDiscovery: isWild,
+    gravity,
+    heat,
+    remainingFiles: remaining,
+    nextStep: remaining.length === 0 ? "Every Start-Here and Wild-Discovery file now has a card. Share the file:// UI link from scan_project. Done." : `Card saved. DO NOT STOP. ${remaining.length} files left. Next: call get_file_context then write_decision_card for "${remaining[0]}".`
+  };
 }
 
 // dist/mcp/tools/get_strategic_overview.js
@@ -1851,6 +1875,12 @@ PROCESS \u2014 follow in order:
    smellSpans (located tech debt) \u2014 base your evidence on THOSE, never on header comments.
 4. Write one decision card per file via write_decision_card.
 
+This is an AUTONOMOUS loop. Every tool response includes a \`nextStep\` and often a
+\`remainingFiles\` list \u2014 OBEY them. Do NOT stop, summarize, or ask the user "how would
+you like to proceed" until every Start-Here and Wild-Discovery file has a card. Writing
+the brief is the START of the work, not the end. Keep calling get_file_context +
+write_decision_card until remainingFiles is empty.
+
 RULES FOR EVERY CARD \u2014 non-negotiable:
 - The \`thesis\` is a VERDICT in one sentence. Take a position. If you can't, you don't
   understand the file yet \u2014 read more.

package/dist/mcp/server.js

@@ -77,6 +77,12 @@ PROCESS — follow in order:
    smellSpans (located tech debt) — base your evidence on THOSE, never on header comments.
 4. Write one decision card per file via write_decision_card.
 
+This is an AUTONOMOUS loop. Every tool response includes a \`nextStep\` and often a
+\`remainingFiles\` list — OBEY them. Do NOT stop, summarize, or ask the user "how would
+you like to proceed" until every Start-Here and Wild-Discovery file has a card. Writing
+the brief is the START of the work, not the end. Keep calling get_file_context +
+write_decision_card until remainingFiles is empty.
+
 RULES FOR EVERY CARD — non-negotiable:
 - The \`thesis\` is a VERDICT in one sentence. Take a position. If you can't, you don't
   understand the file yet — read more.

package/dist/mcp/tools/set_project_brief.js

@@ -22,6 +22,21 @@ export async function handleSetProjectBrief(args) {
     }
     dossier.map.brief = brief;
     await writeDossier(projectRoot, dossier);
-    return { success: true, brief };
+    // Drive the loop: hand back the exact remaining worklist so the agent does
+    // not stop and ask the user. Weak models treat "brief saved" as done otherwise.
+    const documented = new Set([...dossier.pillars.flatMap(p => p.decisions), ...dossier.wildDiscoveries]
+        .map(c => c.primaryFile).filter(Boolean));
+    const startHere = dossier.map.topGravity.filter(f => !documented.has(f));
+    const wild = dossier.map.topHeat.filter(f => !documented.has(f));
+    const worklist = [...new Set([...startHere, ...wild])];
+    return {
+        success: true,
+        brief,
+        remainingFiles: worklist,
+        legalPillarNames: dossier.map.pillars.map(p => p.name),
+        nextStep: worklist.length === 0
+            ? 'All files documented. Share the file:// UI link from scan_project.'
+            : `Brief saved. DO NOT STOP and DO NOT ask the user what to do next. Now loop: for EACH of the ${worklist.length} files in remainingFiles, call get_file_context then write_decision_card. Start with "${worklist[0]}". Continue until every file has a card, then share the file:// UI link.`,
+    };
 }
 //# sourceMappingURL=set_project_brief.js.map

package/dist/mcp/tools/write_decision_card.js

@@ -122,6 +122,18 @@ export async function handleWriteDecisionCard(args) {
     bucket.cardCount = bucket.decisions.length;
     await writeDossier(projectRoot, dossier);
     console.error(`[vibe-splain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? ' (Wild Discovery)' : ''}`);
-    return { success: true, cardId: card.id, pillar, primaryFile, category, severity, wildDiscovery: isWild, gravity, heat };
+    // Keep the loop going: compute what is still undocumented.
+    const documented = new Set([...dossier.pillars.flatMap(p => p.decisions), ...dossier.wildDiscoveries]
+        .map(c => c.primaryFile).filter(Boolean));
+    const remaining = [...new Set([...dossier.map.topGravity, ...dossier.map.topHeat])]
+        .filter(f => !documented.has(f));
+    return {
+        success: true, cardId: card.id, pillar, primaryFile, category, severity,
+        wildDiscovery: isWild, gravity, heat,
+        remainingFiles: remaining,
+        nextStep: remaining.length === 0
+            ? 'Every Start-Here and Wild-Discovery file now has a card. Share the file:// UI link from scan_project. Done.'
+            : `Card saved. DO NOT STOP. ${remaining.length} files left. Next: call get_file_context then write_decision_card for "${remaining[0]}".`,
+    };
 }
 //# sourceMappingURL=write_decision_card.js.map