miriad-viz 0.1.2 → 0.1.3

package/dist-cli/index.js

@@ -343,32 +343,51 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
     const hasArtifacts = !!(flags["artifact-input"] || progress.extractConfig?.artifactInput);
     if (!hasRepo && !hasChat && !hasArtifacts) {
       output.push("");
-      output.push("  Data sources (all optional \u2014 use what you have):");
+      output.push("  \u26D4 BEFORE EXTRACTING: Ask the human these questions:");
+      output.push("    1. Which channel to visualize? (this one, or a different one?)");
+      output.push("    2. What time range? (full history, or a specific sprint/period?)");
+      output.push("    3. Is there a git repo? (adds commit + PR lanes)");
+      output.push("  Wait for answers before running any extraction commands.");
       output.push("");
-      output.push("    Git repo (commits + PRs):");
-      output.push("      --repo-path /path/to/local/repo");
+      output.push("  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+      output.push("  STEP A: EXTRACT CHANNEL DATA (do this FIRST)");
+      output.push("  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
       output.push("");
-      output.push("    Chat messages (from Miriad MCP):");
-      output.push("      1. Extract chat using extract-channel.sh (see project KB)");
-      output.push("      2. Pass:    --chat-input ./messages.json");
+      output.push("  \u{1F4D6} Read the extraction script from the KB:");
+      output.push('     kb_read(kb: "root", doc: "miriad-viz-extraction-script")');
       output.push("");
-      output.push("    Artifacts (from Miriad MCP):");
-      output.push("      --artifact-input ./artifacts.json");
+      output.push("  Follow the instructions there EXACTLY. It gives you a shell");
+      output.push("  script that extracts messages, artifacts, and roster with");
+      output.push("  zero token usage. Run it, wait for it to finish, then come");
+      output.push("  back here with --chat-input and --artifact-input flags.");
       output.push("");
-      output.push("    Date range filter (optional):");
-      output.push("      --from 2026-02-10       Only include data from this date");
-      output.push("      --to 2026-02-17         Only include data up to this date");
-      output.push("      (ISO dates, both inclusive. Omit either for no bound.)");
+      output.push("  \u26A0\uFE0F  DO NOT use get_messages or any MCP tools to extract");
+      output.push("  messages \u2014 it wastes massive tokens. Use the shell script.");
       output.push("");
-      output.push("  Chat-only (no git repo) and git-only (no chat) are both valid.");
-      output.push("  All flags are optional \u2014 extract runs with whatever data you provide.");
+      output.push("  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+      output.push("  STEP B: RUN EXTRACT (after shell script completes)");
+      output.push("  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+      output.push("");
+      output.push("  Once you have the raw data, run extract with these flags:");
+      output.push("    --chat-input ./raw-data/messages.json");
+      output.push("    --artifact-input ./raw-data/artifacts.json");
+      output.push("");
+      output.push("  Optional \u2014 git repo (adds commit + PR lanes):");
+      output.push("    --repo-path /path/to/local/repo");
+      output.push("");
+      output.push("  Optional \u2014 date range filter:");
+      output.push("    --from 2026-02-10    --to 2026-02-17");
+      output.push("");
+      output.push("  Chat-only (no git) is valid. All flags are optional.");
     }
   }
   output.push("", "  Run this command:");
   output.push(`    nohup ${command} &> ${logFile} &`);
-  output.push("", "  Then check progress:");
+  output.push("");
+  output.push("  \u26D4 MANDATORY: Set a 3-minute alarm to check progress.");
+  output.push("  DO NOT go silent. Report progress to the human every 3 minutes.");
   output.push(`    tail -5 ${logFile}`);
-  output.push("", "  Or set a 3-minute alarm and run 'npx miriad-viz next' again.");
+  output.push("  Then run 'npx miriad-viz next' to check if outputs are ready.");
   progress.steps[step] = { status: "in_progress" };
   return { action: "printed_command", step, command, progress, output };
 }