@launchsecure/launch-kit 0.0.30 → 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):
@@ -317,24 +361,30 @@ var LAUNCH_KIT_TOOLS_GUIDE_STATIC_TAIL = `
   Open this repo in Claude Code; on first open you'll be prompted to install
   the "launch-secure" marketplace \u2014 accept to enable the commands above.
 `;
-function renderEntries(dir, kindLabel) {
+function listEntries(dir, kind) {
+  if (kind === "commands") {
+    return fs4.readdirSync(dir).filter((f) => f.endsWith(".md")).sort().map((f) => ({ name: f.replace(/\.md$/, ""), file: path4.join(dir, f) }));
+  }
+  return fs4.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && fs4.existsSync(path4.join(dir, e.name, "SKILL.md"))).map((e) => e.name).sort().map((name) => ({ name, file: path4.join(dir, name, "SKILL.md") }));
+}
+function renderEntries(dir, kind) {
   if (!fs4.existsSync(dir)) return `
-LS slash ${kindLabel}: (scaffold dir not bundled \u2014 this is a packaging bug)
+LS slash ${kind}: (scaffold dir not bundled \u2014 this is a packaging bug)
 `;
-  const files = fs4.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
-  if (files.length === 0) return `
-LS slash ${kindLabel}: (none defined)
+  const entries = listEntries(dir, kind);
+  if (entries.length === 0) return `
+LS slash ${kind}: (none defined)
 `;
-  const names = files.map((file) => `/${PLUGIN_ID}:${file.replace(/\.md$/, "")}`);
+  const names = entries.map((e) => `/${PLUGIN_ID}:${e.name}`);
   const colWidth = Math.max(26, ...names.map((n) => n.length + 2));
-  const lines = files.map((file, i) => {
-    const text = fs4.readFileSync(path4.join(dir, file), "utf-8");
+  const lines = entries.map((entry, i) => {
+    const text = fs4.readFileSync(entry.file, "utf-8");
     const fmMatch = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     const desc = fmMatch?.[1].match(/^description:\s*(.+)$/m)?.[1]?.trim() ?? "";
     return `  ${names[i].padEnd(colWidth)} \u2014 ${desc}`;
   });
   return `
-LS slash ${kindLabel} (run inside Claude Code in this project):
+LS slash ${kind} (run inside Claude Code in this project):
 ${lines.join("\n")}
 `;
 }
@@ -363,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) {
@@ -384,6 +437,8 @@ function parseArgs(argv) {
     quiet: false,
     force: false,
     dryRun: false,
+    verbose: false,
+    guide: null,
     help: false
   };
   const unknown = [];
@@ -434,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);
@@ -505,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
@@ -564,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.
@@ -617,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) {
@@ -679,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) {
@@ -930,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");
@@ -1087,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 = [
     {
@@ -1108,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 {
@@ -1180,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");
@@ -1241,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");
@@ -1267,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 }]
@@ -1281,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];
@@ -1341,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);
@@ -1384,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) {
@@ -1448,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 {
@@ -1457,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.`
@@ -1480,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,
@@ -1489,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);
@@ -1499,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.30",
+  "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",
@@ -56,6 +56,24 @@
     "launch-course": "./dist/server/course-entry.js",
     "launch-beacon": "./dist/server/beacon-monitor-entry.js"
   },
+  "scripts": {
+    "build": "pnpm build:client && pnpm build:chart-client && pnpm build:deck-client && pnpm build:council-client && pnpm build:beacon && pnpm build:server",
+    "build:beacon": "vite build --config vite.beacon.config.ts && tsc -p tsconfig.beacon.json --emitDeclarationOnly --outDir dist/beacon/types",
+    "test:beacon": "vitest run --config vite.beacon.config.ts",
+    "test:radar": "vitest run --config vite.radar.config.ts",
+    "test:chart": "vitest run --config vite.chart.test.config.ts",
+    "build:deck-client": "vite build --config vite.deck.config.ts",
+    "build:council-client": "vite build --config vite.council.config.ts",
+    "build:client": "vite build",
+    "build:chart-client": "vite build --config vite.chart.config.ts",
+    "build:server": "esbuild src/server/cli.ts src/server/fb-wizard.ts src/server/graph-mcp-entry.ts src/server/chart-serve.ts src/server/deck-mcp-entry.ts src/server/deck-serve.ts src/server/council-entry.ts src/server/council-serve.ts src/server/recall-entry.ts src/server/init-entry.ts src/server/orbit-entry.ts src/server/course-entry.ts src/server/beacon-monitor-entry.ts src/server/parse-worker-entry.ts --bundle --platform=node --target=node18 --outdir=dist/server --external:node-pty --external:ws --external:typescript --external:web-tree-sitter --external:tree-sitter-typescript --external:cloudflared --external:pg --external:pg-native --external:pgsql-parser --external:libpg-query && rm -rf dist/server/public && cp -r ../claude-code-web/src/public dist/server/public && rm -rf dist/server/graph/queries && mkdir -p dist/server/graph && cp -r src/server/graph/queries dist/server/graph/queries",
+    "dev:client": "vite",
+    "dev:deck-serve": "cd ../.. && tsx watch packages/cli/src/server/deck-mcp-entry.ts serve",
+    "dev:chart": "pnpm build:server && pnpm build:chart-client && node dist/server/graph-mcp-entry.js serve",
+    "dev:server": "pnpm build:server && node dist/server/cli.js",
+    "dev": "pnpm build:server && concurrently -k -n client,server -c cyan,magenta \"vite\" \"node dist/server/cli.js\"",
+    "prepublishOnly": "pnpm build"
+  },
   "files": [
     "dist",
     "prompts",
@@ -76,6 +94,8 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@launchsecure/claude-code-web": "workspace:*",
+    "@launchsecure/ui": "workspace:*",
     "@types/node": "^20.0.0",
     "@types/pg": "^8.11.10",
     "@types/react": "^18.3.12",
@@ -99,24 +119,6 @@
     "react-router-dom": "^6.28.0",
     "tailwindcss": "^3.4.19",
     "vite": "^5.4.11",
-    "vitest": "^1.6.0",
-    "@launchsecure/claude-code-web": "0.0.1",
-    "@launchsecure/ui": "0.0.1"
-  },
-  "scripts": {
-    "build": "pnpm build:client && pnpm build:chart-client && pnpm build:deck-client && pnpm build:council-client && pnpm build:beacon && pnpm build:server",
-    "build:beacon": "vite build --config vite.beacon.config.ts && tsc -p tsconfig.beacon.json --emitDeclarationOnly --outDir dist/beacon/types",
-    "test:beacon": "vitest run --config vite.beacon.config.ts",
-    "test:radar": "vitest run --config vite.radar.config.ts",
-    "test:chart": "vitest run --config vite.chart.test.config.ts",
-    "build:deck-client": "vite build --config vite.deck.config.ts",
-    "build:council-client": "vite build --config vite.council.config.ts",
-    "build:client": "vite build",
-    "build:chart-client": "vite build --config vite.chart.config.ts",
-    "build:server": "esbuild src/server/cli.ts src/server/fb-wizard.ts src/server/graph-mcp-entry.ts src/server/chart-serve.ts src/server/deck-mcp-entry.ts src/server/deck-serve.ts src/server/council-entry.ts src/server/council-serve.ts src/server/recall-entry.ts src/server/init-entry.ts src/server/orbit-entry.ts src/server/course-entry.ts src/server/beacon-monitor-entry.ts src/server/parse-worker-entry.ts --bundle --platform=node --target=node18 --outdir=dist/server --external:node-pty --external:ws --external:typescript --external:web-tree-sitter --external:tree-sitter-typescript --external:cloudflared --external:pg --external:pg-native --external:pgsql-parser --external:libpg-query && rm -rf dist/server/public && cp -r ../claude-code-web/src/public dist/server/public && rm -rf dist/server/graph/queries && mkdir -p dist/server/graph && cp -r src/server/graph/queries dist/server/graph/queries",
-    "dev:client": "vite",
-    "dev:chart": "pnpm build:server && pnpm build:chart-client && node dist/server/graph-mcp-entry.js serve",
-    "dev:server": "pnpm build:server && node dist/server/cli.js",
-    "dev": "pnpm build:server && concurrently -k -n client,server -c cyan,magenta \"vite\" \"node dist/server/cli.js\""
+    "vitest": "^1.6.0"
   }
-}
+}