@launchsecure/launch-kit 0.0.31 → 0.0.32

package/dist/server/init-entry.js

@@ -295,6 +295,50 @@ function recoverCred(targetDir, opts) {
 init_statusline_install();
 var DEFAULT_SERVER_URL = "https://launchsecure-v2.vercel.app";
 var ONBOARD_SCRIPT_NAME = "onboard";
+var TTY = process.stdout.isTTY === true && process.env.NO_COLOR !== "1";
+var c = {
+  dim: (s) => TTY ? `\x1B[2m${s}\x1B[0m` : s,
+  bold: (s) => TTY ? `\x1B[1m${s}\x1B[0m` : s,
+  cyan: (s) => TTY ? `\x1B[36m${s}\x1B[0m` : s,
+  green: (s) => TTY ? `\x1B[32m${s}\x1B[0m` : s,
+  yellow: (s) => TTY ? `\x1B[33m${s}\x1B[0m` : s,
+  red: (s) => TTY ? `\x1B[31m${s}\x1B[0m` : s
+};
+var PHASE_NAME_COL = 16;
+var HEADER_WIDTH = 64;
+function header(title, kv) {
+  if (VERBOSE) return;
+  const dashes = "\u2500".repeat(Math.max(3, HEADER_WIDTH - title.length - 5));
+  console.log("");
+  console.log(c.cyan(`\u2500\u2500\u2500 ${c.bold(title)} ${dashes}`));
+  if (kv.length > 0) {
+    const labelWidth = Math.max(...kv.map(([k]) => k.length));
+    for (const [k, v] of kv) console.log(`    ${c.dim(k.padEnd(labelWidth))}  ${v}`);
+  }
+  console.log("");
+}
+function phase(name, result) {
+  if (VERBOSE) return;
+  const mark = result.status === "ok" ? c.green("\u2713") : result.status === "in-sync" ? c.dim("\xB7") : result.status === "skipped" ? c.dim("\u2212") : c.yellow("\u26A0");
+  const summary = result.status === "in-sync" || result.status === "skipped" ? c.dim(result.summary) : result.summary;
+  const label = name.padEnd(PHASE_NAME_COL);
+  console.log(`  ${result.status === "warn" ? c.yellow(label) : label} ${mark} ${summary}`);
+}
+function section(title) {
+  if (VERBOSE) return;
+  console.log("");
+  console.log(`  ${c.dim("\u2500 " + title + " \u2500")}`);
+}
+function footer(msg, hints = []) {
+  if (VERBOSE) return;
+  console.log("");
+  console.log(`  ${c.bold(msg)}`);
+  for (const h of hints) console.log(`  ${c.dim(h)}`);
+  console.log("");
+}
+function warn(msg) {
+  console.log(`  ${c.yellow("\u26A0")} ${msg}`);
+}
 var LAUNCH_KIT_PKG = "@launchsecure/launch-kit";
 var LAUNCH_KIT_TOOLS_GUIDE_STATIC_HEAD = `
 Wired in Claude Code (.mcp.json):
@@ -369,7 +413,10 @@ var KNOWN_BOOL_FLAGS = /* @__PURE__ */ new Set([
   "--refresh-scaffolds",
   "--quiet",
   "--force",
-  "--dry-run"
+  "--dry-run",
+  "--verbose",
+  "--guide",
+  "--no-guide"
 ]);
 var KNOWN_KV_KEYS = /* @__PURE__ */ new Set(["token", "org", "project", "url", "dir", "course"]);
 function parseArgs(argv) {
@@ -390,6 +437,8 @@ function parseArgs(argv) {
     quiet: false,
     force: false,
     dryRun: false,
+    verbose: false,
+    guide: null,
     help: false
   };
   const unknown = [];
@@ -440,6 +489,18 @@ function parseArgs(argv) {
       args.dryRun = true;
       continue;
     }
+    if (raw === "--verbose") {
+      args.verbose = true;
+      continue;
+    }
+    if (raw === "--guide") {
+      args.guide = true;
+      continue;
+    }
+    if (raw === "--no-guide") {
+      args.guide = false;
+      continue;
+    }
     const eq = raw.indexOf("=");
     if (raw.startsWith("--") && eq > 0) {
       const key = raw.slice(2, eq);
@@ -511,8 +572,15 @@ Options:
   --refresh-scaffolds      Force-overwrite migrate-safety files (default is to
                            preserve user edits). Use this to pull updates
                            published to @launchsecure/launch-kit.
-  --quiet                  Suppress the post-run tools guide.
+  --verbose                Print the legacy per-line debug log instead of the
+                           default compact phase summary. Useful when refresh
+                           reports a warn-status phase and you want detail.
+  --guide                  Print the trailing tools guide (MCP table + every
+                           /kit:* command). Off by default on refresh.
+  --quiet                  Suppress the tools guide and the next-steps hint.
+                           Overrides --guide.
   --dry-run                Preview every file write without making changes.
+                           Implies --verbose.
   --help                   Show this help.
 
 Tip: prefix the command with @latest (\`launch-kit@latest refresh\`) to force
@@ -570,9 +638,17 @@ Options:
                            user edits; use this to pull updates published to
                            @launchsecure/launch-kit (e.g., a newer
                            migrate-with-backup.sh).
-  --quiet                  Suppress the post-run tools guide (the long block
-                           listing /kit:* commands and wired MCPs). Useful for
-                           idempotent re-runs in CI or scripts.
+  --verbose                Print the legacy per-line debug log instead of the
+                           default compact phase summary. Useful when a phase
+                           reports a warn status and you want per-file detail.
+  --guide                  Print the trailing tools guide (MCP table + every
+                           /kit:* command). On by default for init; pair with
+                           --no-guide to suppress.
+  --no-guide               Suppress the trailing tools guide (handy after the
+                           first init, when you don't need the catalog again).
+  --quiet                  Suppress the post-run tools guide AND the next-steps
+                           hint. Useful for idempotent re-runs in CI or scripts.
+                           Overrides --guide.
   --force                  Skip the auto-delegate-to-refresh check. By default
                            init detects an existing bootstrap (cred file +
                            launch-secure MCP entry) and runs refresh instead.
@@ -623,11 +699,12 @@ function fail(msg) {
   console.error(`[launch-kit] \u2717 ${msg}`);
   process.exit(1);
 }
+var VERBOSE = false;
 function info(msg) {
-  console.log(`[launch-kit] ${msg}`);
+  if (VERBOSE) console.log(`[launch-kit] ${msg}`);
 }
 function ok(msg) {
-  console.log(`[launch-kit] \u2713 ${msg}`);
+  if (VERBOSE) console.log(`[launch-kit] \u2713 ${msg}`);
 }
 var DRY_RUN = false;
 function dryNote(msg) {
@@ -685,7 +762,7 @@ function attemptProjectInfo(args) {
       },
       (res) => {
         const chunks = [];
-        res.on("data", (c) => chunks.push(c));
+        res.on("data", (c2) => chunks.push(c2));
         res.on("end", () => {
           const text = Buffer.concat(chunks).toString("utf-8");
           if (res.statusCode === 401) {
@@ -936,13 +1013,15 @@ function mergeMcpFile(targetDir, launchKitEntries) {
     }
   }
   if (DRY_RUN) {
-    const action2 = hadExisting && existingServerCount > 0 ? "would merge into" : "would write";
-    dryNote(`${action2} .mcp.json \u2014 overwriting [${overwrites.join(", ") || "none"}], adding [${additions.join(", ") || "none"}]`);
-    return;
+    const action = hadExisting && existingServerCount > 0 ? "would merge into" : "would write";
+    dryNote(`${action} .mcp.json \u2014 overwriting [${overwrites.join(", ") || "none"}], adding [${additions.join(", ") || "none"}]`);
+    return { status: "skipped", summary: "(dry-run)" };
   }
   fs4.writeFileSync(p, JSON.stringify(merged, null, 2) + "\n", "utf-8");
-  const action = hadExisting && existingServerCount > 0 ? "merged into" : "wrote";
-  ok(`${action} .mcp.json (${Object.keys(launchKitEntries).length} launch-kit entries)`);
+  const verb = hadExisting && existingServerCount > 0 ? "merged" : "wrote";
+  ok(`${verb === "merged" ? "merged into" : "wrote"} .mcp.json (${Object.keys(launchKitEntries).length} launch-kit entries)`);
+  const total = Object.keys(launchKitEntries).length;
+  return { status: "ok", summary: `${verb} ${total} entries` };
 }
 function detectPackageManager(repoDir) {
   const pkgPath = path4.join(repoDir, "package.json");
@@ -1093,8 +1172,8 @@ function copyScaffoldDirAlways(srcDir, destDir, labelPrefix) {
 function scaffoldMigrateSafety(targetDir, refreshScaffolds = false) {
   const scaffoldsRoot = path4.resolve(__dirname, "..", "..", "scaffolds", "migrate-safety");
   if (!fs4.existsSync(scaffoldsRoot)) {
-    info(`\u26A0 migrate-safety scaffolds not found at ${scaffoldsRoot} \u2014 skipping (this is a packaging bug; main onboarding is unaffected)`);
-    return;
+    warn(`migrate-safety scaffolds missing at ${scaffoldsRoot} \u2014 packaging bug; main onboarding unaffected`);
+    return { status: "warn", summary: "scaffolds missing (packaging bug)" };
   }
   const files = [
     {
@@ -1114,9 +1193,33 @@ function scaffoldMigrateSafety(targetDir, refreshScaffolds = false) {
     }
   ];
   info(`scaffolding migrate-safety (pg_dump wrapper + GHA backup workflow + runbook)${refreshScaffolds ? " \u2014 --refresh-scaffolds active" : ""} \u2026`);
-  for (const f of files) copyScaffoldDriftAware(f.src, f.dest, f.label, refreshScaffolds);
+  const counts = { wrote: 0, inSync: 0, drifted: 0, refreshed: 0, missing: 0 };
+  for (const f of files) {
+    const r = copyScaffoldDriftAware(f.src, f.dest, f.label, refreshScaffolds);
+    if (r === "wrote") counts.wrote++;
+    else if (r === "in-sync") counts.inSync++;
+    else if (r === "drifted-preserved") counts.drifted++;
+    else if (r === "drifted-refreshed") counts.refreshed++;
+    else counts.missing++;
+  }
   ensureGitignoreLine(targetDir, ".backups/");
   ok("migrate-safety ready \u2014 see docs/migrations-runbook.md for db:migrate wiring + PROD_DATABASE_URL secret setup");
+  return summarizeFileCounts(counts);
+}
+function summarizeFileCounts(counts) {
+  const total = counts.wrote + counts.inSync + counts.drifted + counts.refreshed + counts.missing;
+  const parts = [];
+  if (counts.wrote) parts.push(`${counts.wrote} written`);
+  if (counts.refreshed) parts.push(`${counts.refreshed} refreshed`);
+  if (counts.drifted) parts.push(`${counts.drifted} drifted (preserved \u2014 pass --refresh-scaffolds to update)`);
+  if (counts.inSync && (counts.wrote || counts.refreshed || counts.drifted)) parts.push(`${counts.inSync} in sync`);
+  if (counts.missing) parts.push(`${counts.missing} missing scaffold src`);
+  if (parts.length === 0) parts.push(`in sync (${total} file${total === 1 ? "" : "s"})`);
+  else if (!counts.wrote && !counts.refreshed && !counts.drifted && counts.inSync === total) {
+    return { status: "in-sync", summary: `in sync (${total} file${total === 1 ? "" : "s"})` };
+  }
+  const status = counts.drifted || counts.missing ? "warn" : counts.wrote || counts.refreshed ? "ok" : "in-sync";
+  return { status, summary: parts.join(", ") };
 }
 function hashFile(p) {
   try {
@@ -1186,21 +1289,22 @@ function isDogfoodMarketplace(targetDir) {
 function scaffoldLsMarketplace(targetDir) {
   const scaffoldsRoot = path4.resolve(__dirname, "..", "..", "scaffolds", "ls-marketplace");
   if (!fs4.existsSync(scaffoldsRoot)) {
-    info(`\u26A0 ls-marketplace scaffolds not found at ${scaffoldsRoot} \u2014 skipping (this is a packaging bug; main onboarding is unaffected)`);
-    return;
+    warn(`ls-marketplace scaffolds missing at ${scaffoldsRoot} \u2014 packaging bug`);
+    return { status: "warn", summary: "scaffolds missing (packaging bug)" };
   }
   const dogfood = isDogfoodMarketplace(targetDir);
   if (dogfood.isDogfood) {
     info(`dogfood marketplace pointer detected (${dogfood.existingPath}) \u2014 skipping copy, only refreshing enabledPlugins`);
     wireLsSettings(targetDir);
     ok(`launch-secure marketplace (dogfood) \u2014 Claude Code loads commands from ${dogfood.existingPath}`);
-    return;
+    return { status: "ok", summary: `dogfood pointer (${dogfood.existingPath})` };
   }
   const marketplaceRoot = path4.join(targetDir, ".claude", "marketplace");
   info("scaffolding launch-secure marketplace (Claude Code /kit: namespace \u2014 refreshes every /kit:* command found in the scaffold) \u2026");
   copyScaffoldDirAlways(scaffoldsRoot, marketplaceRoot, ".claude/marketplace");
   wireLsSettings(targetDir);
   ok(`launch-secure marketplace ready \u2014 open this repo in Claude Code, approve the "${MARKETPLACE_ID}" marketplace prompt, then try /kit:activate-beacon, /kit:standup, or /kit:show-mcp-status`);
+  return { status: "ok", summary: "marketplace tree + settings refreshed" };
 }
 function wireLsSettings(targetDir) {
   const p = path4.join(targetDir, ".claude", "settings.json");
@@ -1247,13 +1351,14 @@ var RECALL_HOOK_COMMAND = 'bash "${CLAUDE_PROJECT_DIR:-$PWD}/scripts/ensure-reca
 function scaffoldRecallHook(targetDir) {
   const scaffoldsRoot = path4.resolve(__dirname, "..", "..", "scaffolds", "recall-hook");
   if (!fs4.existsSync(scaffoldsRoot)) {
-    info(`\u26A0 recall-hook scaffolds not found at ${scaffoldsRoot} \u2014 skipping (this is a packaging bug; main onboarding is unaffected)`);
-    return;
+    warn(`recall-hook scaffolds missing at ${scaffoldsRoot} \u2014 packaging bug`);
+    return { status: "warn", summary: "scaffolds missing (packaging bug)" };
   }
   info("scaffolding recall-hook (SessionStart watcher-respawn hook + ensure-recall.sh) \u2026");
   copyScaffoldDirAlways(scaffoldsRoot, targetDir, "");
-  wireRecallHook(targetDir);
+  const wired = wireRecallHook(targetDir);
   ok("recall-hook ready \u2014 opens with Claude Code will respawn the launch-recall watcher if it died between sessions");
+  return wired ? { status: "ok", summary: "ensure-recall.sh refreshed + SessionStart hook appended" } : { status: "ok", summary: "ensure-recall.sh refreshed (hook already wired)" };
 }
 function wireRecallHook(targetDir) {
   const p = path4.join(targetDir, ".claude", "settings.json");
@@ -1273,7 +1378,7 @@ function wireRecallHook(targetDir) {
   );
   if (alreadyWired) {
     info(".claude/settings.json SessionStart hook already references ensure-recall.sh \u2014 leaving alone");
-    return;
+    return false;
   }
   const newGroup = {
     hooks: [{ type: "command", command: RECALL_HOOK_COMMAND }]
@@ -1287,23 +1392,28 @@ function wireRecallHook(targetDir) {
   };
   if (DRY_RUN) {
     dryNote(`would append SessionStart hook to .claude/settings.json (bash scripts/ensure-recall.sh; preserves every other key + existing hooks)`);
-    return;
+    return true;
   }
   fs4.mkdirSync(path4.dirname(p), { recursive: true });
   fs4.writeFileSync(p, JSON.stringify(merged, null, 2) + "\n", "utf-8");
   ok(`appended SessionStart hook to .claude/settings.json (bash scripts/ensure-recall.sh)`);
+  return true;
 }
 function tryActivateStatusline() {
   if (DRY_RUN) {
     dryNote(`would wrap ~/.claude/settings.json statusLine.command with launch-kit's MCP chip wrapper (skips silently if no statusline configured)`);
-    return;
+    return { status: "skipped", summary: "(dry-run)" };
   }
   const res = activateStatusline();
   if (res.ok && res.outcome === "activated") {
     ok(`statusline wrapped \u2014 MCP chips will render alongside your existing statusline next session`);
-  } else if (res.ok && res.outcome === "refreshed") {
+    return { status: "ok", summary: "wrapped \u2014 MCP chips render next session" };
+  }
+  if (res.ok && res.outcome === "refreshed") {
     info(`statusline already wrapped \u2014 refreshed chip scripts`);
+    return { status: "ok", summary: "chip scripts refreshed" };
   }
+  return null;
 }
 async function main() {
   const subcommand = process.argv[2];
@@ -1347,11 +1457,12 @@ async function main() {
     fail(`Unknown subcommand "${subcommand}". Supported: init, refresh, statusline. Run with --help for usage.`);
   }
   DRY_RUN = args.dryRun;
+  VERBOSE = args.verbose || DRY_RUN;
   if (DRY_RUN) {
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    info("DRY RUN \u2014 no files will be written, no commands will run.");
-    info("Lines tagged (dry-run) show what would happen.");
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(c.bold("DRY RUN") + c.dim(" \u2014 no files will be written, no commands will run."));
+    console.log(c.dim("Lines tagged (dry-run) show what would happen."));
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   }
   if (subcommand === "refresh") return mainRefresh(args);
   return mainInit(args);
@@ -1390,25 +1501,34 @@ async function mainRefresh(args) {
   const active = nested.profiles[nested.active];
   if (!active) fail(`${CONFIG_FILENAME} active profile "${nested.active}" is not present in profiles.`);
   info(`refreshing launch-kit in ${targetDir} (course: ${nested.active}, project: ${active.orgSlug}/${active.projectSlug}) \u2026`);
+  header("launch-kit refresh", [
+    ["course", nested.active],
+    ["project", `${active.orgSlug}/${active.projectSlug}`],
+    ["dir", path4.relative(cwd, targetDir) || "."]
+  ]);
   const cfg = { pat: active.pat, orgSlug: active.orgSlug, projectSlug: active.projectSlug, serverUrl: active.serverUrl };
-  mergeMcpFile(targetDir, buildLaunchKitMcpEntries(cfg));
+  phase(".mcp.json", mergeMcpFile(targetDir, buildLaunchKitMcpEntries(cfg)));
   ensureGitignoreLine(targetDir, CONFIG_FILENAME);
-  if (!args.noMigrateSafety) scaffoldMigrateSafety(targetDir, args.refreshScaffolds);
-  if (!args.noLsMarketplace) scaffoldLsMarketplace(targetDir);
-  if (!args.noRecallHook) scaffoldRecallHook(targetDir);
-  tryActivateStatusline();
-  console.log("");
+  if (!args.noMigrateSafety) phase("migrate-safety", scaffoldMigrateSafety(targetDir, args.refreshScaffolds));
+  if (!args.noLsMarketplace) phase("ls-marketplace", scaffoldLsMarketplace(targetDir));
+  if (!args.noRecallHook) phase("recall-hook", scaffoldRecallHook(targetDir));
+  const slR = tryActivateStatusline();
+  if (slR) phase("statusline", slR);
   if (DRY_RUN) {
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    info(`DRY RUN COMPLETE \u2014 refresh would have applied the above; no files modified.`);
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log("");
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(c.bold("DRY RUN COMPLETE") + c.dim(" \u2014 refresh would have applied the above; no files modified."));
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     return;
   }
   ok(`refresh complete \u2014 restart Claude Code to pick up any new /kit:* commands`);
-  if (!args.quiet) {
-    console.log(`
-Skipped (refresh never runs these): clone, dependency install, onboard script, launch-recall init. Use \`npx @launchsecure/launch-kit init\` for a full bootstrap.
-${getLaunchKitToolsGuide()}`);
+  const showGuide = args.quiet ? false : args.guide === true;
+  const hints = ["Restart Claude Code to pick up any new /kit:* commands."];
+  if (!showGuide && !args.quiet) hints.push("Run with --guide to print the full MCP + slash-command catalog. --verbose for per-file detail.");
+  footer("Refresh complete.", hints);
+  if (showGuide) {
+    console.log(c.dim(`(refresh never runs these: clone, dependency install, onboard script, launch-recall init \u2014 use \`launch-kit init\` for a full bootstrap)`));
+    console.log(getLaunchKitToolsGuide());
   }
 }
 async function mainInit(args) {
@@ -1454,7 +1574,13 @@ async function mainInit(args) {
   if (!/^ls_pat_/.test(args.token)) fail("Token does not look like a LaunchSecure PAT (expected prefix ls_pat_).");
   if (!args.orgSlug) fail("--org=<orgSlug> is required.");
   if (!args.projectSlug) fail("--project=<projectSlug> is required.");
+  header("launch-kit init", [
+    ["org", args.orgSlug],
+    ["project", args.projectSlug],
+    ["server", args.serverUrl]
+  ]);
   const { hasGh } = preflight();
+  phase("preflight", { status: "ok", summary: `node ${process.versions.node}${hasGh ? " \xB7 git \xB7 gh" : " \xB7 git (gh not found \u2014 will use git for clone)"}` });
   info(`resolving project ${args.orgSlug}/${args.projectSlug} on ${args.serverUrl} \u2026`);
   let resolved;
   try {
@@ -1463,6 +1589,7 @@ async function mainInit(args) {
     fail(err instanceof Error ? err.message : String(err));
   }
   ok(`resolved "${resolved.projectName}"`);
+  phase("project_info", { status: "ok", summary: `"${resolved.projectName}"` });
   if (!resolved.repositoryUrl) {
     fail(
       `Project "${resolved.projectSlug}" has no GitHub repository configured. Connect GitHub at ${args.serverUrl}/${resolved.orgSlug}/projects/${resolved.projectSlug}/settings/integrations, then re-run init.`
@@ -1486,7 +1613,14 @@ async function mainInit(args) {
       fail(`${targetDir} exists and is not empty (and not a matching git repo). Refusing to clone into it. Pass --dir=<other-path>.`);
     }
   }
-  if (!skipClone) cloneRepo(repoUrl, targetDir, hasGh);
+  const relTarget = path4.relative(cwd, targetDir) || ".";
+  if (!skipClone) {
+    section(`Cloning ${repoUrl}`);
+    cloneRepo(repoUrl, targetDir, hasGh);
+    phase("clone", { status: "ok", summary: `\u2192 ${relTarget}` });
+  } else {
+    phase("clone", { status: "in-sync", summary: `${relTarget} (already a clone of this repo)` });
+  }
   const cfg = {
     pat: args.token,
     orgSlug: resolved.orgSlug,
@@ -1495,7 +1629,8 @@ async function mainInit(args) {
   };
   const courseName = args.course ?? inferCourseName(cfg.serverUrl);
   writeConfigFile(targetDir, cfg, courseName);
-  mergeMcpFile(targetDir, buildLaunchKitMcpEntries(cfg));
+  phase("cred file", { status: "ok", summary: `course=${courseName}, active` });
+  phase(".mcp.json", mergeMcpFile(targetDir, buildLaunchKitMcpEntries(cfg)));
   ensureGitignoreLine(targetDir, CONFIG_FILENAME);
   let installSkippedReason = null;
   const detected = detectPackageManager(targetDir);
@@ -1505,43 +1640,51 @@ async function mainInit(args) {
   } else if (!detected) {
     installSkippedReason = "no package.json found";
   } else {
+    section(`Installing dependencies (${detected.pm.name})`);
     runInstall(targetDir, detected);
-    if (!args.noOnboard && hasOnboardScript(targetDir)) runOnboard(targetDir, detected.pm);
+    phase("install", { status: "ok", summary: `${detected.pm.binary} ${detected.pm.installArgs.join(" ")}` });
+    if (!args.noOnboard && hasOnboardScript(targetDir)) {
+      section(`Running ${detected.pm.binary} run ${ONBOARD_SCRIPT_NAME}`);
+      runOnboard(targetDir, detected.pm);
+      phase("onboard", { status: "ok", summary: `${detected.pm.binary} run ${ONBOARD_SCRIPT_NAME}` });
+    }
   }
   const hasOnboard = hasOnboardScript(targetDir);
-  if (!args.noRecall) runRecallInit(targetDir);
-  if (!args.noMigrateSafety) scaffoldMigrateSafety(targetDir, args.refreshScaffolds);
-  if (!args.noLsMarketplace) scaffoldLsMarketplace(targetDir);
-  if (!args.noRecallHook) scaffoldRecallHook(targetDir);
-  tryActivateStatusline();
-  const relTarget = path4.relative(cwd, targetDir) || ".";
-  console.log("");
+  if (installSkippedReason) phase("install", { status: "skipped", summary: installSkippedReason });
+  if (!args.noRecall) {
+    section("Initializing launch-recall (shadow git backup)");
+    runRecallInit(targetDir);
+    phase("launch-recall", { status: "ok", summary: "shadow git ready" });
+  }
+  if (!args.noMigrateSafety) phase("migrate-safety", scaffoldMigrateSafety(targetDir, args.refreshScaffolds));
+  if (!args.noLsMarketplace) phase("ls-marketplace", scaffoldLsMarketplace(targetDir));
+  if (!args.noRecallHook) phase("recall-hook", scaffoldRecallHook(targetDir));
+  const slR = tryActivateStatusline();
+  if (slR) phase("statusline", slR);
   if (DRY_RUN) {
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-    info(`DRY RUN COMPLETE \u2014 no files were modified, no commands ran.`);
-    info(`Target: ${targetDir}`);
-    info(`Re-run without --dry-run to apply the changes shown above.`);
-    info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log("");
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(c.bold("DRY RUN COMPLETE") + c.dim(` \u2014 no files were modified, no commands ran.`));
+    console.log(c.dim(`Target: ${targetDir}`));
+    console.log(c.dim(`Re-run without --dry-run to apply the changes shown above.`));
+    console.log(c.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     return;
   }
   ok(`done \u2014 ${resolved.projectName} is ready at ${targetDir}`);
+  const showGuide = args.quiet ? false : args.guide ?? true;
+  const nextSteps = [`cd ${relTarget}`];
   if (installSkippedReason) {
-    const installLine = detected ? `  ${detected.pm.binary} ${detected.pm.installArgs.join(" ")}` : `  npm install              # or your package manager of choice`;
-    const onboardLine = hasOnboard && detected && !args.noOnboard ? `
-  ${detected.pm.binary} run ${ONBOARD_SCRIPT_NAME}      # project setup hook` : "";
-    console.log(`
-Next steps (install skipped: ${installSkippedReason}):
-  cd ${relTarget}
-${installLine}${onboardLine}
-  claude                   # launch Claude Code (5 MCPs wired)${args.quiet ? "" : `
-${getLaunchKitToolsGuide()}`}`);
-  } else if (!args.quiet) {
-    console.log(`
-Next steps:
-  cd ${relTarget}
-  claude                   # launch Claude Code (5 MCPs wired)
-${getLaunchKitToolsGuide()}`);
+    nextSteps.push(detected ? `${detected.pm.binary} ${detected.pm.installArgs.join(" ")}     # install skipped: ${installSkippedReason}` : `npm install                                                   # install skipped: ${installSkippedReason}`);
+    if (hasOnboard && detected && !args.noOnboard) {
+      nextSteps.push(`${detected.pm.binary} run ${ONBOARD_SCRIPT_NAME}     # project setup hook`);
+    }
   }
+  nextSteps.push("claude                                                   # launch Claude Code (5 MCPs wired)");
+  footer(`${resolved.projectName} is ready at ${relTarget}.`, [
+    "Next:",
+    ...nextSteps.map((s) => "  " + s)
+  ]);
+  if (showGuide) console.log(getLaunchKitToolsGuide());
 }
 main().catch((err) => {
   console.error(`[launch-kit] unexpected error: ${err instanceof Error ? err.stack ?? err.message : String(err)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchsecure/launch-kit",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "LaunchSecure toolkit — launch-pod (pipeline), launch-chart (project graph MCP), launch-deck (visual playground MCP), launch-kit-beacon (feedback Web Component), launch-recall (file-watcher backup).",
   "license": "MIT",
   "author": "LaunchSecure - AutomateWithUs",

package/scaffolds/ls-marketplace/plugins/kit/skills/diagram/SKILL.md

@@ -31,7 +31,7 @@ Parse `$ARGUMENTS`:
 - **--scope=<filter>** — for ERDs, limit to one module or table set (e.g. `--scope=auth` or `--scope=User,Org,Membership`). Default: all tables.
 - **--session=<id>** — deck session name. Default `diagram-<kind>-<subject-slug>`.
 - **--dsl=<raw-mermaid>** — bypass auto-generation; push the user's DSL verbatim.
-- **--feedback** — push in feedback mode and await response.
+- **--no-feedback** — skip feedback round-trip (rare; only when the caller has already validated the DSL).
 
 Examples:
 - `/kit:diagram flowchart user login flow`
@@ -97,18 +97,38 @@ Rules:
 - `read_graph(layer: "db")` returns 0 nodes
 - the chart shows tables but `inspect_node` returns no `columns` (parser misconfiguration)
 
-## Push to deck
+## Push to deck — feedback mode is the default
+
+**Always use `mode: "feedback"` for diagrams.** Mermaid DSL frequently fails on the first attempt (syntax pitfalls below), and the deck server's auto-error poll is racy (1500ms timeout in `deck-mcp.ts`). Feedback mode gives you two backstops: a synchronous render-error capture *and* explicit user confirmation. Skip only when `--no-feedback` was passed.
 
 Call `mcp__launch-deck__deck` with:
 - `session: <session>`
-- `mode: "show"` or `"feedback"` (+ `prompt: "Does this match the schema you expected?"` for ERDs)
+- `mode: "feedback"`
+- `prompt: "Diagram render OK? Reply 'ok' to accept, or paste the error / describe what's wrong."` (ERDs: append "Does this match the schema you expected?")
 - `blocks: [{ type: "mermaid", label: <kind>-<subject>, content: <mermaid-dsl> }]`
 
-If `--feedback`, call `await_feedback` and surface the response.
+### Render-error retry loop
+
+The deck MCP catches mermaid parse/render errors via the browser's `onMermaidError` → `/api/render-errors` channel and surfaces them on the `deck` tool response. Handle both signal paths:
+
+1. **Synchronous render error** — if the `deck` response is `{ok: false, mermaid_error, failed_source, ...}`, inspect `failed_source` first:
+   - If `failed_source` matches the DSL you just pushed → real error. Fix the DSL based on `mermaid_error` and re-push immediately (same session — the tab is already open). Cap at 2 auto-retries before surfacing to the user.
+   - If `failed_source` does NOT match what you just pushed → **stale error**. The deck server's `lastRenderError` is a module-level pop register (`consumeRenderError` in `deck-serve.ts`) populated via WebSocket from the browser; if the previous push's render error arrived AFTER its 1500ms MCP poll, it leaks into this push's response. Ignore it and proceed to `await_feedback`.
+2. **User feedback** — if `deck` returned `ok: true`, call `mcp__launch-deck__await_feedback({ session })`. If the reply is positive ("ok", "looks good", thumbs up), you're done. Otherwise treat the reply as a correction (syntax error pasted, "missing X", "wrong direction") and regenerate. Cap at 2 user-feedback retries before stopping and asking for a clearer instruction.
+
+### Common Mermaid pitfalls (avoid on first attempt)
+
+- **No `<br/>` in participant aliases.** `participant Pod as LaunchPod CLI<br/>(agent)` breaks the parser in many Mermaid builds. Use one-line names or a trailing parenthetical.
+- **Multi-line notes are fragile.** `Note over X: line1<br/>line2` is risky inside `rect` blocks. Keep notes one-line, or chain two `Note` statements.
+- **Multiple `else` branches.** `alt … else … else … else … end` works in current Mermaid but failure modes are noisy; prefer 2-branch alts or split into separate alt blocks.
+- **`rect rgb(...)`** uses **space-separated** values, not commas: `rect rgb(230 240 255)` — not `rect rgb(230,240,255)`. Comma form errors silently in some builds.
+- **Special chars in labels** — wrap in double quotes when using `:`, `(`, `,`, or unicode arrows: `A->>B: "step (1): start"`.
+- **Reserved keywords as actor names** — avoid `end`, `note`, `loop`, `alt`, `opt` as participant ids.
+- **ERD column types** must be one word: `string`, `int`, `datetime`, `enum`. No spaces, no parens.
 
 ## Open in browser
 
-After the push (and after `await_feedback` if `--feedback`), open the per-session URL so the user lands directly on this diagram:
+After the final successful push (and after `await_feedback` returns positive), open the per-session URL so the user lands directly on this diagram:
 
 ```
 open "<deck-url>/#<session>"          # macOS
@@ -150,3 +170,5 @@ Then fall back: render a `flowchart` placeholder explaining "DB layer not availa
 - **Cap entities at 25.** Past that, Mermaid wraps unreadably; ask the user to narrow scope.
 - **Mermaid only.** This skill does not draw raster images — Mermaid DSL is the deliverable.
 - **One block per push.**
+- **Feedback mode by default.** Never push a diagram with `mode: "show"` unless `--no-feedback` was explicitly passed. Diagrams are validated artifacts, not fire-and-forget output.
+- **Retry caps.** 2 auto-retries on synchronous render error + 2 user-feedback retries. Beyond that, hand the broken DSL back to the user with the last error message and stop.

package/dist/deck-client/assets/channel-DmR7Tyyt.js

@@ -1 +0,0 @@
-import{aq as o,ar as n}from"./index-CB-qlwRT.js";const t=(r,a)=>o.lang.round(n.parse(r)[a]);export{t as c};

package/dist/deck-client/assets/classDiagram-6PBFFD2Q-Bl4ozQWs.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-4TB4RGXK-DtKQqaI7.js";import{_ as i}from"./index-CB-qlwRT.js";import"./chunk-FMBD7UC4-CmuA5UKn.js";import"./chunk-YZCP3GAM-C44yr620.js";import"./chunk-55IACEB6-COy9hEae.js";import"./chunk-EDXVE4YY-D_f861An.js";var u={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/deck-client/assets/classDiagram-v2-HSJHXN6E-Bl4ozQWs.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-4TB4RGXK-DtKQqaI7.js";import{_ as i}from"./index-CB-qlwRT.js";import"./chunk-FMBD7UC4-CmuA5UKn.js";import"./chunk-YZCP3GAM-C44yr620.js";import"./chunk-55IACEB6-COy9hEae.js";import"./chunk-EDXVE4YY-D_f861An.js";var u={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/deck-client/assets/clone-BAy58j24.js

@@ -1 +0,0 @@
-import{b as r}from"./graph-CifKx6G1.js";var e=4;function a(o){return r(o,e)}export{a as c};

package/dist/deck-client/assets/stateDiagram-v2-QKLJ7IA2-CR7riiab.js

@@ -1 +0,0 @@
-import{s as t,b as r,a,S as s}from"./chunk-OYMX7WX6-vT8z8D-0.js";import{_ as i}from"./index-CB-qlwRT.js";import"./chunk-55IACEB6-COy9hEae.js";import"./chunk-EDXVE4YY-D_f861An.js";var l={parser:a,get db(){return new s(2)},renderer:r,styles:t,init:i(e=>{e.state||(e.state={}),e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},"init")};export{l as diagram};