@whenlabs/when 0.9.3 → 0.11.0

package/dist/index.js

@@ -1,13 +1,20 @@
 #!/usr/bin/env node
 import {
-  findBin
-} from "./chunk-2A2EZZF4.js";
+  CACHE_DIR,
+  CONFIG_FILENAME,
+  deriveProject,
+  findBin,
+  generateDashboard,
+  loadConfig,
+  runCli,
+  writeCache
+} from "./chunk-JI5NCJQ2.js";
 import {
   getStatusPath
 } from "./chunk-4ZVSCJCJ.js";
 
 // src/index.ts
-import { Command as Command5 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/delegate.ts
 import { Command } from "commander";
@@ -297,8 +304,9 @@ function createDoctorCommand() {
 import { Command as Command3 } from "commander";
 import { spawn as spawn3 } from "child_process";
 import { resolve as resolve2, dirname as dirname2, basename } from "path";
-import { existsSync as existsSync2, readFileSync } from "fs";
+import { existsSync as existsSync2, readFileSync, writeFileSync } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
+import { stringify } from "yaml";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
 var c2 = {
   reset: "\x1B[0m",
@@ -312,12 +320,6 @@ var c2 = {
 function colorize2(text, ...codes) {
   return codes.join("") + text + c2.reset;
 }
-function findBin3(name) {
-  const pkgRoot = resolve2(__dirname2, "..");
-  const localBin = resolve2(pkgRoot, "node_modules", ".bin", name);
-  if (existsSync2(localBin)) return localBin;
-  return name;
-}
 function detectProject(cwd) {
   let name = basename(cwd);
   const pkgPath = resolve2(cwd, "package.json");
@@ -348,9 +350,25 @@ function detectProject(cwd) {
   }
   return { name, stack: stacks.length > 0 ? stacks.join(", ") : "unknown" };
 }
-function runTool2(bin, args) {
+function detectLicenseTemplate(cwd) {
+  const pkgPath = resolve2(cwd, "package.json");
+  if (existsSync2(pkgPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      const license = (pkg.license ?? "").toLowerCase();
+      if (["mit", "isc", "apache-2.0", "apache2", "bsd-2-clause", "bsd-3-clause"].some((l) => license.includes(l))) {
+        return "opensource";
+      }
+      if (license) return "commercial";
+    } catch {
+    }
+  }
+  return "opensource";
+}
+function runTool2(bin, args, cwd) {
   return new Promise((resolveP) => {
     const child = spawn3(bin, args, {
+      cwd,
       env: { ...process.env, FORCE_COLOR: "0", NO_COLOR: "1" }
     });
     let stdout = "";
@@ -365,8 +383,75 @@ function runTool2(bin, args) {
     child.on("close", (code) => resolveP({ stdout, stderr, exitCode: code ?? 1 }));
   });
 }
+async function bootstrapConfigs(cwd) {
+  const results = [];
+  const hasEnv = existsSync2(resolve2(cwd, ".env"));
+  const hasEnvSchema = existsSync2(resolve2(cwd, ".env.schema"));
+  if (hasEnv && !hasEnvSchema) {
+    const { exitCode } = await runTool2(findBin("envalid"), ["init"], cwd);
+    if (exitCode === 0) {
+      results.push({ label: ".env.schema", action: "created", detail: "Created .env.schema from .env" });
+    } else if (exitCode === 127) {
+      results.push({ label: ".env.schema", action: "error", detail: "envalid not found" });
+    } else {
+      results.push({ label: ".env.schema", action: "error", detail: "envalid init failed" });
+    }
+  } else if (hasEnvSchema) {
+    results.push({ label: ".env.schema", action: "skipped", detail: "Skipped (already exists)" });
+  } else {
+    results.push({ label: ".env.schema", action: "skipped", detail: "Skipped (no .env found)" });
+  }
+  const hasVowConfig = existsSync2(resolve2(cwd, ".vow.json"));
+  if (!hasVowConfig) {
+    const template = detectLicenseTemplate(cwd);
+    const { exitCode } = await runTool2(findBin("vow"), ["init", "--template", template], cwd);
+    if (exitCode === 0) {
+      results.push({ label: ".vow.json", action: "created", detail: `Created .vow.json (template: ${template})` });
+    } else if (exitCode === 127) {
+      results.push({ label: ".vow.json", action: "error", detail: "vow not found" });
+    } else {
+      results.push({ label: ".vow.json", action: "error", detail: "vow init failed" });
+    }
+  } else {
+    results.push({ label: ".vow.json", action: "skipped", detail: "Skipped (already exists)" });
+  }
+  const hasStaleConfig = existsSync2(resolve2(cwd, ".stale.yml"));
+  let staleScanNeeded = false;
+  if (!hasStaleConfig) {
+    const { exitCode } = await runTool2(findBin("stale"), ["init"], cwd);
+    if (exitCode === 0) {
+      results.push({ label: ".stale.yml", action: "created", detail: "Created .stale.yml" });
+      staleScanNeeded = true;
+    } else if (exitCode === 127) {
+      results.push({ label: ".stale.yml", action: "error", detail: "stale not found" });
+    } else {
+      results.push({ label: ".stale.yml", action: "error", detail: "stale init failed" });
+    }
+  } else {
+    results.push({ label: ".stale.yml", action: "skipped", detail: "Skipped (already exists)" });
+  }
+  const { exitCode: berthCode } = await runTool2(findBin("berth"), ["register", "--yes", "--dir", cwd], cwd);
+  if (berthCode === 0) {
+    results.push({ label: "berth ports", action: "created", detail: "Registered project ports" });
+  } else if (berthCode === 127) {
+    results.push({ label: "berth ports", action: "error", detail: "berth not found" });
+  } else {
+    results.push({ label: "berth ports", action: "error", detail: "berth register failed" });
+  }
+  return { results, staleScanNeeded };
+}
+function bootstrapIcon(action) {
+  switch (action) {
+    case "created":
+      return colorize2("+", c2.green);
+    case "skipped":
+      return colorize2("-", c2.dim);
+    case "error":
+      return colorize2("!", c2.yellow);
+  }
+}
 async function scanStale(cwd) {
-  const { stdout, exitCode } = await runTool2(findBin3("stale"), ["scan", "--format", "json", "--path", cwd]);
+  const { stdout, exitCode } = await runTool2(findBin("stale"), ["scan", "--format", "json", "--path", cwd]);
   if (exitCode === 127) return { label: "Doc drift (stale)", status: "error", detail: "stale not found" };
   try {
     const json = JSON.parse(stdout);
@@ -377,7 +462,7 @@ async function scanStale(cwd) {
   }
 }
 async function scanEnvalid(cwd) {
-  const { stdout, exitCode } = await runTool2(findBin3("envalid"), ["validate", "--format", "json"]);
+  const { stdout, exitCode } = await runTool2(findBin("envalid"), ["validate", "--format", "json"]);
   if (exitCode === 127) return { label: "Env validation (envalid)", status: "error", detail: "envalid not found" };
   if (exitCode === 2 || stdout.includes("not found")) return { label: "Env validation (envalid)", status: "skipped", detail: "No .env.schema \u2014 run `envalid init`" };
   try {
@@ -389,7 +474,7 @@ async function scanEnvalid(cwd) {
   }
 }
 async function scanBerth(cwd) {
-  const { stdout, exitCode } = await runTool2(findBin3("berth"), ["check", cwd, "--json"]);
+  const { stdout, exitCode } = await runTool2(findBin("berth"), ["check", cwd, "--json"]);
   if (exitCode === 127) return { label: "Port conflicts (berth)", status: "error", detail: "berth not found" };
   try {
     const json = JSON.parse(stdout);
@@ -400,7 +485,7 @@ async function scanBerth(cwd) {
   }
 }
 async function scanVow(cwd) {
-  const { stdout, exitCode } = await runTool2(findBin3("vow"), ["scan", "--format", "json", "--path", cwd]);
+  const { stdout, exitCode } = await runTool2(findBin("vow"), ["scan", "--format", "json", "--path", cwd]);
   if (exitCode === 127) return { label: "License scan (vow)", status: "error", detail: "vow not found" };
   const jsonStart = stdout.indexOf("{");
   const jsonStr = jsonStart >= 0 ? stdout.slice(jsonStart) : stdout;
@@ -418,12 +503,12 @@ async function scanVow(cwd) {
 async function scanAware(cwd) {
   const hasConfig = existsSync2(resolve2(cwd, ".aware.json"));
   if (!hasConfig) {
-    const { exitCode: exitCode2 } = await runTool2(findBin3("aware"), ["init"]);
+    const { exitCode: exitCode2 } = await runTool2(findBin("aware"), ["init", "--force"], cwd);
     if (exitCode2 === 0) return { label: "AI context (aware)", status: "ok", detail: "Generated .aware.json and context files" };
     if (exitCode2 === 127) return { label: "AI context (aware)", status: "error", detail: "aware not found" };
     return { label: "AI context (aware)", status: "skipped", detail: "Could not generate \u2014 run `aware init` manually" };
   }
-  const { stdout, stderr, exitCode } = await runTool2(findBin3("aware"), ["doctor"]);
+  const { stdout, stderr, exitCode } = await runTool2(findBin("aware"), ["doctor"], cwd);
   if (exitCode === 127) return { label: "AI context (aware)", status: "error", detail: "aware not found" };
   const combined = (stdout + stderr).trim();
   const warnings = combined.split("\n").filter((l) => l.includes("\u26A0") || /warn/i.test(l)).length;
@@ -443,7 +528,7 @@ function statusIcon2(status) {
 }
 function createInitCommand() {
   const cmd = new Command3("init");
-  cmd.description("Interactive onboarding \u2014 detect stack, run all checks, suggest next steps");
+  cmd.description("Interactive onboarding \u2014 detect stack, bootstrap tool configs, run all checks");
   cmd.action(async () => {
     const cwd = process.cwd();
     console.log("");
@@ -454,6 +539,53 @@ function createInitCommand() {
     console.log(`  Stack:    ${colorize2(project.stack, c2.cyan)}`);
     console.log(`  Path:     ${colorize2(cwd, c2.dim)}`);
     console.log("");
+    process.stdout.write(colorize2("  Bootstrapping tool configs\u2026", c2.dim) + "\n");
+    const { results: bootstrapResults, staleScanNeeded } = await bootstrapConfigs(cwd);
+    process.stdout.write("\x1B[1A\x1B[2K");
+    console.log(colorize2("  Bootstrap", c2.bold));
+    console.log(colorize2("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c2.dim));
+    for (const r of bootstrapResults) {
+      const icon = bootstrapIcon(r.action);
+      const label = r.label.padEnd(20);
+      const detail = r.action === "created" ? colorize2(r.detail, c2.green) : r.action === "error" ? colorize2(r.detail, c2.yellow) : colorize2(r.detail, c2.dim);
+      console.log(`  ${icon}  ${label} ${detail}`);
+    }
+    const whenlabsConfigPath = resolve2(cwd, CONFIG_FILENAME);
+    if (!existsSync2(whenlabsConfigPath)) {
+      try {
+        const mergedConfig = {};
+        const staleConfigPath = resolve2(cwd, ".stale.yml");
+        if (existsSync2(staleConfigPath)) {
+          mergedConfig["stale"] = {};
+        }
+        const vowConfigPath = resolve2(cwd, ".vow.json");
+        if (existsSync2(vowConfigPath)) {
+          try {
+            const vowData = JSON.parse(readFileSync(vowConfigPath, "utf-8"));
+            mergedConfig["vow"] = {
+              ...typeof vowData.policy === "string" ? { policy: vowData.policy } : {},
+              ...typeof vowData.production_only === "boolean" ? { production_only: vowData.production_only } : {}
+            };
+          } catch {
+            mergedConfig["vow"] = {};
+          }
+        }
+        const envSchemaPath = resolve2(cwd, ".env.schema");
+        if (existsSync2(envSchemaPath)) {
+          mergedConfig["envalid"] = { schema: ".env.schema" };
+        }
+        mergedConfig["berth"] = {};
+        mergedConfig["aware"] = {};
+        mergedConfig["velocity"] = {};
+        writeFileSync(whenlabsConfigPath, stringify(mergedConfig, { lineWidth: 0 }), "utf-8");
+        console.log(`  ${colorize2("+", c2.green)}  ${colorize2(CONFIG_FILENAME, c2.bold)} ${colorize2("created", c2.green)}`);
+      } catch {
+        console.log(`  ${colorize2("!", c2.yellow)}  Could not generate ${colorize2(CONFIG_FILENAME, c2.bold)}`);
+      }
+    } else {
+      console.log(`  ${colorize2("-", c2.dim)}  ${colorize2(CONFIG_FILENAME, c2.bold)} ${colorize2("already exists", c2.dim)}`);
+    }
+    console.log("");
     process.stdout.write(colorize2("  Scanning project\u2026", c2.dim) + "\n");
     const results = await Promise.all([
       scanStale(cwd),
@@ -471,13 +603,32 @@ function createInitCommand() {
       const detail = r.status === "ok" ? colorize2(r.detail, c2.green) : r.status === "skipped" ? colorize2(r.detail, c2.dim) : r.status === "error" ? colorize2(r.detail, c2.yellow) : colorize2(r.detail, c2.red);
       console.log(`  ${icon}  ${label} ${detail}`);
     }
+    const staleResult = results.find((r) => r.label === "Doc drift (stale)");
+    if (staleResult?.status === "issues" || staleScanNeeded) {
+      process.stdout.write(colorize2("  Auto-fixing doc drift\u2026", c2.dim) + "\n");
+      const { exitCode: fixCode } = await runTool2(findBin("stale"), ["fix", "--apply"], cwd);
+      process.stdout.write("\x1B[1A\x1B[2K");
+      if (fixCode === 0) {
+        console.log(`  ${colorize2("\u2713", c2.green)}  ${colorize2("Doc drift auto-fixed", c2.green)}`);
+      } else if (fixCode === 127) {
+        console.log(`  ${colorize2("!", c2.yellow)}  ${colorize2("stale not found for auto-fix", c2.yellow)}`);
+      } else {
+        console.log(`  ${colorize2("-", c2.dim)}  ${colorize2("No high-confidence fixes available", c2.dim)}`);
+      }
+    }
     const issueCount = results.filter((r) => r.status === "issues").length;
     const errorCount = results.filter((r) => r.status === "error").length;
+    const bootstrapErrors = bootstrapResults.filter((r) => r.action === "error").length;
+    const bootstrapCreated = bootstrapResults.filter((r) => r.action === "created").length;
     console.log(colorize2("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c2.dim));
-    if (issueCount + errorCount === 0) {
+    if (issueCount + errorCount + bootstrapErrors === 0) {
       console.log(colorize2("  All clear \u2014 project looks healthy!", c2.green, c2.bold));
     } else {
-      console.log(colorize2(`  ${issueCount} tool(s) found issues, ${errorCount} could not run`, c2.yellow, c2.bold));
+      const parts = [];
+      if (bootstrapCreated > 0) parts.push(`${bootstrapCreated} config(s) created`);
+      if (issueCount > 0) parts.push(`${issueCount} scan(s) found issues`);
+      if (errorCount + bootstrapErrors > 0) parts.push(`${errorCount + bootstrapErrors} tool(s) could not run`);
+      console.log(colorize2(`  ${parts.join(", ")}`, c2.yellow, c2.bold));
     }
     console.log("");
     console.log(colorize2("  Next steps:", c2.bold));
@@ -498,7 +649,7 @@ function createInitCommand() {
 import { Command as Command4 } from "commander";
 import { join } from "path";
 import { homedir } from "os";
-import { mkdirSync, writeFileSync } from "fs";
+import { mkdirSync, writeFileSync as writeFileSync2 } from "fs";
 var STATUS_DIR = join(homedir(), ".whenlabs");
 function toolResultToStatus(r) {
   const count = r.issues + r.warnings;
@@ -535,10 +686,10 @@ function writeStatus(results) {
     },
     summary: buildSummary(results)
   };
-  writeFileSync(getStatusPath(), JSON.stringify(status, null, 2) + "\n");
+  writeFileSync2(getStatusPath(), JSON.stringify(status, null, 2) + "\n");
 }
 function sleep(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 function createWatchCommand() {
   const cmd = new Command4("watch");
@@ -585,16 +736,541 @@ function createWatchCommand() {
   return cmd;
 }
 
-// src/index.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve3, dirname as dirname3 } from "path";
+// src/commands/config.ts
+import { Command as Command5 } from "commander";
+import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "fs";
+import { resolve as resolve3 } from "path";
+import { parse, stringify as stringify2 } from "yaml";
+var c3 = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m"
+};
+function colorize3(text, ...codes) {
+  return codes.join("") + text + c3.reset;
+}
+function readExistingToolConfigs(cwd) {
+  const config = {};
+  const stalePath = resolve3(cwd, ".stale.yml");
+  if (existsSync3(stalePath)) {
+    try {
+      const raw = readFileSync2(stalePath, "utf-8");
+      const parsed = parse(raw);
+      config.stale = {
+        ignore: Array.isArray(parsed?.ignore) ? parsed.ignore : void 0,
+        deep: typeof parsed?.deep === "boolean" ? parsed.deep : void 0
+      };
+    } catch {
+      config.stale = {};
+    }
+  }
+  const vowPath = resolve3(cwd, ".vow.json");
+  if (existsSync3(vowPath)) {
+    try {
+      const vow = JSON.parse(readFileSync2(vowPath, "utf-8"));
+      config.vow = {
+        policy: typeof vow.policy === "string" ? vow.policy : void 0,
+        production_only: typeof vow.production_only === "boolean" ? vow.production_only : void 0
+      };
+    } catch {
+    }
+  }
+  const schemaPath = resolve3(cwd, ".env.schema");
+  if (existsSync3(schemaPath)) {
+    config.envalid = { schema: ".env.schema" };
+  }
+  return config;
+}
+function generateDefaultConfig(cwd) {
+  const base = readExistingToolConfigs(cwd);
+  return {
+    stale: base.stale ?? {},
+    envalid: base.envalid ?? {},
+    vow: base.vow ?? {},
+    berth: {},
+    aware: {},
+    velocity: {}
+  };
+}
+function validateConfig(config) {
+  const errors = [];
+  if (config.stale !== void 0 && typeof config.stale !== "object") {
+    errors.push("stale: must be an object");
+  }
+  if (config.stale?.ignore !== void 0 && !Array.isArray(config.stale.ignore)) {
+    errors.push("stale.ignore: must be an array of strings");
+  }
+  if (config.stale?.deep !== void 0 && typeof config.stale.deep !== "boolean") {
+    errors.push("stale.deep: must be a boolean");
+  }
+  if (config.envalid !== void 0 && typeof config.envalid !== "object") {
+    errors.push("envalid: must be an object");
+  }
+  if (config.envalid?.schema !== void 0 && typeof config.envalid.schema !== "string") {
+    errors.push("envalid.schema: must be a string");
+  }
+  if (config.envalid?.environments !== void 0 && !Array.isArray(config.envalid.environments)) {
+    errors.push("envalid.environments: must be an array of strings");
+  }
+  if (config.vow !== void 0 && typeof config.vow !== "object") {
+    errors.push("vow: must be an object");
+  }
+  if (config.vow?.policy !== void 0 && typeof config.vow.policy !== "string") {
+    errors.push("vow.policy: must be a string");
+  }
+  if (config.vow?.production_only !== void 0 && typeof config.vow.production_only !== "boolean") {
+    errors.push("vow.production_only: must be a boolean");
+  }
+  if (config.berth !== void 0 && typeof config.berth !== "object") {
+    errors.push("berth: must be an object");
+  }
+  if (config.berth?.ports !== void 0) {
+    if (typeof config.berth.ports !== "object" || Array.isArray(config.berth.ports)) {
+      errors.push("berth.ports: must be a key/value map of port names to numbers");
+    } else {
+      for (const [k, v] of Object.entries(config.berth.ports)) {
+        if (typeof v !== "number") errors.push(`berth.ports.${k}: must be a number`);
+      }
+    }
+  }
+  if (config.aware !== void 0 && typeof config.aware !== "object") {
+    errors.push("aware: must be an object");
+  }
+  if (config.aware?.targets !== void 0 && !Array.isArray(config.aware.targets)) {
+    errors.push("aware.targets: must be an array of strings");
+  }
+  if (config.velocity !== void 0 && typeof config.velocity !== "object") {
+    errors.push("velocity: must be an object");
+  }
+  if (config.velocity?.project !== void 0 && typeof config.velocity.project !== "string") {
+    errors.push("velocity.project: must be a string");
+  }
+  return errors;
+}
+function createConfigCommand() {
+  const cmd = new Command5("config");
+  cmd.description("Manage unified .whenlabs.yml project config");
+  cmd.action(() => {
+    const cwd = process.cwd();
+    const configPath = resolve3(cwd, CONFIG_FILENAME);
+    console.log("");
+    console.log(colorize3("  when config", c3.bold, c3.cyan));
+    console.log(colorize3("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c3.dim));
+    if (!existsSync3(configPath)) {
+      console.log(`  ${colorize3("-", c3.dim)}  No ${colorize3(CONFIG_FILENAME, c3.bold)} found`);
+      console.log(`  ${colorize3("\u2022", c3.dim)} Run ${colorize3("when config init", c3.bold)} to generate one`);
+      console.log("");
+      return;
+    }
+    const raw = readFileSync2(configPath, "utf-8");
+    console.log(`  ${colorize3(configPath, c3.dim)}`);
+    console.log("");
+    for (const line of raw.split("\n")) {
+      console.log(`  ${line}`);
+    }
+  });
+  const initCmd = new Command5("init");
+  initCmd.description(`Generate ${CONFIG_FILENAME} from existing tool configs`);
+  initCmd.option("--force", "Overwrite existing config");
+  initCmd.action((options) => {
+    const cwd = process.cwd();
+    const configPath = resolve3(cwd, CONFIG_FILENAME);
+    console.log("");
+    console.log(colorize3("  when config init", c3.bold, c3.cyan));
+    console.log(colorize3("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c3.dim));
+    if (existsSync3(configPath) && !options.force) {
+      console.log(`  ${colorize3("-", c3.dim)}  ${colorize3(CONFIG_FILENAME, c3.bold)} already exists \u2014 use ${colorize3("--force", c3.bold)} to overwrite`);
+      console.log("");
+      return;
+    }
+    const config = generateDefaultConfig(cwd);
+    const yaml = stringify2(config, { lineWidth: 0 });
+    writeFileSync3(configPath, yaml, "utf-8");
+    console.log(`  ${colorize3("+", c3.green)}  Created ${colorize3(CONFIG_FILENAME, c3.bold)}`);
+    console.log("");
+    for (const line of yaml.split("\n")) {
+      if (line.trim()) console.log(`  ${colorize3(line, c3.dim)}`);
+    }
+    console.log("");
+  });
+  const validateCmd = new Command5("validate");
+  validateCmd.description(`Validate ${CONFIG_FILENAME} structure`);
+  validateCmd.action(() => {
+    const cwd = process.cwd();
+    const configPath = resolve3(cwd, CONFIG_FILENAME);
+    console.log("");
+    console.log(colorize3("  when config validate", c3.bold, c3.cyan));
+    console.log(colorize3("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c3.dim));
+    if (!existsSync3(configPath)) {
+      console.log(`  ${colorize3("-", c3.dim)}  No ${colorize3(CONFIG_FILENAME, c3.bold)} found \u2014 nothing to validate`);
+      console.log("");
+      return;
+    }
+    const config = loadConfig(cwd);
+    if (!config) {
+      console.log(`  ${colorize3("!", c3.yellow)}  Could not parse ${colorize3(CONFIG_FILENAME, c3.bold)} \u2014 invalid YAML`);
+      console.log("");
+      process.exitCode = 1;
+      return;
+    }
+    const errors = validateConfig(config);
+    if (errors.length === 0) {
+      console.log(`  ${colorize3("\u2713", c3.green)}  ${colorize3(CONFIG_FILENAME, c3.bold)} is valid`);
+    } else {
+      for (const err of errors) {
+        console.log(`  ${colorize3("\u2717", c3.red)}  ${err}`);
+      }
+      process.exitCode = 1;
+    }
+    console.log("");
+  });
+  cmd.addCommand(initCmd);
+  cmd.addCommand(validateCmd);
+  return cmd;
+}
+
+// src/commands/upgrade.ts
+import { Command as Command6 } from "commander";
+import { execSync } from "child_process";
+import { readFileSync as readFileSync3 } from "fs";
+import { resolve as resolve4, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
-var { version } = JSON.parse(readFileSync2(resolve3(__dirname3, "..", "package.json"), "utf8"));
-var program = new Command5();
+var c4 = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m"
+};
+function colorize4(text, ...codes) {
+  return codes.join("") + text + c4.reset;
+}
+function parseVersion(v) {
+  return v.trim().split(".").map(Number);
+}
+function versionGte(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0;
+    const nb = pb[i] ?? 0;
+    if (na > nb) return true;
+    if (na < nb) return false;
+  }
+  return true;
+}
+function createUpgradeCommand() {
+  const cmd = new Command6("upgrade");
+  cmd.description("Upgrade @whenlabs/when to the latest version");
+  cmd.action(async () => {
+    console.log("");
+    console.log(colorize4("  when upgrade", c4.bold, c4.cyan));
+    console.log(colorize4("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c4.dim));
+    const pkgPath = resolve4(__dirname3, "..", "..", "package.json");
+    let current;
+    try {
+      const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+      current = pkg.version;
+    } catch {
+      console.log(`  ${colorize4("!", c4.red)}  Could not read current version`);
+      console.log("");
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`  ${colorize4("current", c4.dim)}  ${colorize4(current, c4.bold)}`);
+    let latest;
+    try {
+      latest = execSync("npm view @whenlabs/when version", { encoding: "utf-8" }).trim();
+    } catch {
+      console.log(`  ${colorize4("!", c4.yellow)}  Could not reach npm registry \u2014 check your network connection`);
+      console.log("");
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`  ${colorize4("latest", c4.dim)}   ${colorize4(latest, c4.bold)}`);
+    console.log("");
+    if (versionGte(current, latest)) {
+      console.log(`  ${colorize4("\u2713", c4.green)}  Already up to date`);
+      console.log("");
+      return;
+    }
+    console.log(`  ${colorize4("\u2191", c4.yellow)}  Upgrade available: ${colorize4(current, c4.dim)} \u2192 ${colorize4(latest, c4.green + c4.bold)}`);
+    console.log(`  ${colorize4("\u2022", c4.dim)} Running: ${colorize4("npm install -g @whenlabs/when@latest", c4.bold)}`);
+    console.log("");
+    try {
+      execSync("npm install -g @whenlabs/when@latest", { stdio: "inherit" });
+      console.log("");
+      console.log(`  ${colorize4("\u2713", c4.green)}  Upgraded to ${colorize4(latest, c4.bold)}`);
+    } catch {
+      console.log(`  ${colorize4("\u2717", c4.red)}  Install failed \u2014 try running with sudo or check npm permissions`);
+      process.exitCode = 1;
+    }
+    console.log("");
+  });
+  return cmd;
+}
+
+// src/commands/eject.ts
+import { Command as Command7 } from "commander";
+import { existsSync as existsSync4, writeFileSync as writeFileSync4, copyFileSync } from "fs";
+import { resolve as resolve5 } from "path";
+import { stringify as stringify3 } from "yaml";
+var c5 = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m"
+};
+function colorize5(text, ...codes) {
+  return codes.join("") + text + c5.reset;
+}
+function createEjectCommand() {
+  const cmd = new Command7("eject");
+  cmd.description("Write each tool section of .whenlabs.yml back to its native config format");
+  cmd.option("--force", "Overwrite existing files without prompting");
+  cmd.action((options) => {
+    const cwd = process.cwd();
+    console.log("");
+    console.log(colorize5("  when eject", c5.bold, c5.cyan));
+    console.log(colorize5("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c5.dim));
+    const config = loadConfig(cwd);
+    if (!config) {
+      console.log(`  ${colorize5("!", c5.yellow)}  No ${colorize5(".whenlabs.yml", c5.bold)} found \u2014 nothing to eject`);
+      console.log(`  ${colorize5("\u2022", c5.dim)} Run ${colorize5("when config init", c5.bold)} to generate one first`);
+      console.log("");
+      return;
+    }
+    let ejected = 0;
+    let skipped = 0;
+    if (config.stale && Object.keys(config.stale).length > 0) {
+      const dest = resolve5(cwd, ".stale.yml");
+      if (existsSync4(dest) && !options.force) {
+        console.log(`  ${colorize5("!", c5.yellow)}  ${colorize5(".stale.yml", c5.bold)} already exists \u2014 use ${colorize5("--force", c5.bold)} to overwrite`);
+        skipped++;
+      } else {
+        const yaml = stringify3(config.stale, { lineWidth: 0 });
+        writeFileSync4(dest, yaml, "utf-8");
+        console.log(`  ${colorize5("+", c5.green)}  Wrote ${colorize5(".stale.yml", c5.bold)}`);
+        ejected++;
+      }
+    } else if (config.stale !== void 0) {
+      console.log(`  ${colorize5("-", c5.dim)}  stale: empty config \u2014 skipping .stale.yml`);
+    }
+    if (config.vow && Object.keys(config.vow).length > 0) {
+      const dest = resolve5(cwd, ".vow.json");
+      if (existsSync4(dest) && !options.force) {
+        console.log(`  ${colorize5("!", c5.yellow)}  ${colorize5(".vow.json", c5.bold)} already exists \u2014 use ${colorize5("--force", c5.bold)} to overwrite`);
+        skipped++;
+      } else {
+        writeFileSync4(dest, JSON.stringify(config.vow, null, 2) + "\n", "utf-8");
+        console.log(`  ${colorize5("+", c5.green)}  Wrote ${colorize5(".vow.json", c5.bold)}`);
+        ejected++;
+      }
+    } else if (config.vow !== void 0) {
+      console.log(`  ${colorize5("-", c5.dim)}  vow: empty config \u2014 skipping .vow.json`);
+    }
+    if (config.envalid?.schema) {
+      const src = resolve5(cwd, config.envalid.schema);
+      const dest = resolve5(cwd, ".env.schema");
+      const isSamePath = resolve5(src) === resolve5(dest);
+      if (isSamePath) {
+        console.log(`  ${colorize5("-", c5.dim)}  envalid.schema already points to ${colorize5(".env.schema", c5.bold)}`);
+      } else if (!existsSync4(src)) {
+        console.log(`  ${colorize5("!", c5.yellow)}  envalid.schema source ${colorize5(config.envalid.schema, c5.bold)} not found \u2014 skipping`);
+        skipped++;
+      } else if (existsSync4(dest) && !options.force) {
+        console.log(`  ${colorize5("!", c5.yellow)}  ${colorize5(".env.schema", c5.bold)} already exists \u2014 use ${colorize5("--force", c5.bold)} to overwrite`);
+        skipped++;
+      } else {
+        copyFileSync(src, dest);
+        console.log(`  ${colorize5("+", c5.green)}  Copied ${colorize5(config.envalid.schema, c5.bold)} \u2192 ${colorize5(".env.schema", c5.bold)}`);
+        ejected++;
+      }
+    }
+    if (config.berth !== void 0) {
+      const portCount = config.berth.ports ? Object.keys(config.berth.ports).length : 0;
+      if (portCount > 0) {
+        console.log(`  ${colorize5("\u2022", c5.dim)}  berth: ${portCount} port(s) configured \u2014 berth has no standalone config file, managed via ${colorize5(".whenlabs.yml", c5.bold)}`);
+      } else {
+        console.log(`  ${colorize5("-", c5.dim)}  berth: no standalone config file`);
+      }
+    }
+    console.log("");
+    if (ejected > 0) {
+      console.log(`  ${colorize5("\u2713", c5.green)}  Ejected ${colorize5(String(ejected), c5.bold)} file(s)`);
+    }
+    if (skipped > 0) {
+      console.log(`  ${colorize5("!", c5.yellow)}  Skipped ${colorize5(String(skipped), c5.bold)} file(s) \u2014 run with ${colorize5("--force", c5.bold)} to overwrite`);
+    }
+    if (ejected === 0 && skipped === 0) {
+      console.log(`  ${colorize5("-", c5.dim)}  Nothing to eject`);
+    }
+    console.log("");
+  });
+  return cmd;
+}
+
+// src/commands/diff.ts
+import { Command as Command8 } from "commander";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { join as join2 } from "path";
+var c6 = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m"
+};
+function colorize6(text, ...codes) {
+  return codes.join("") + text + c6.reset;
+}
+function readCache(tool, project) {
+  const file = join2(CACHE_DIR, `${tool}_${project}.json`);
+  if (!existsSync5(file)) return null;
+  try {
+    return JSON.parse(readFileSync5(file, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function diffLines(oldOutput, newOutput) {
+  const oldLines = new Set(oldOutput.split("\n").map((l) => l.trim()).filter(Boolean));
+  const newLines = new Set(newOutput.split("\n").map((l) => l.trim()).filter(Boolean));
+  const added = [];
+  const removed = [];
+  const unchanged = [];
+  for (const line of newLines) {
+    if (oldLines.has(line)) {
+      unchanged.push(line);
+    } else {
+      added.push(line);
+    }
+  }
+  for (const line of oldLines) {
+    if (!newLines.has(line)) {
+      removed.push(line);
+    }
+  }
+  return { added, removed, unchanged };
+}
+var TOOLS = [
+  { bin: "stale", args: ["scan"], label: "stale" },
+  { bin: "envalid", args: ["validate"], label: "envalid" },
+  { bin: "berth", args: ["status"], label: "berth" },
+  { bin: "vow", args: ["scan"], label: "vow" },
+  { bin: "aware", args: ["doctor"], label: "aware" }
+];
+function createDiffCommand() {
+  const cmd = new Command8("diff");
+  cmd.description("Compare cached tool results to fresh runs and show what changed");
+  cmd.action(async () => {
+    const cwd = process.cwd();
+    const project = deriveProject(cwd);
+    console.log("");
+    console.log(colorize6("  when diff", c6.bold, c6.cyan));
+    console.log(colorize6("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500", c6.dim));
+    console.log(`  ${colorize6("project", c6.dim)}  ${colorize6(project, c6.bold)}`);
+    console.log("");
+    let anyChanges = false;
+    for (const tool of TOOLS) {
+      const cached = readCache(tool.label, project);
+      const fresh = await runCli(tool.bin, tool.args, cwd);
+      const freshOutput = fresh.stdout.trim() || fresh.stderr.trim() || "";
+      if (!cached) {
+        console.log(`  ${colorize6(tool.label, c6.bold, c6.cyan)}`);
+        if (freshOutput) {
+          for (const line of freshOutput.split("\n").slice(0, 5)) {
+            if (line.trim()) console.log(`    ${colorize6(line, c6.dim)}`);
+          }
+          const total = freshOutput.split("\n").filter(Boolean).length;
+          if (total > 5) console.log(`    ${colorize6(`\u2026 ${total - 5} more lines`, c6.dim)}`);
+        } else {
+          console.log(`    ${colorize6("no output", c6.dim)}`);
+        }
+        console.log(`    ${colorize6("(no prior cache \u2014 this is now the baseline)", c6.dim)}`);
+      } else {
+        const oldOutput = cached.output.trim();
+        const { added, removed, unchanged } = diffLines(oldOutput, freshOutput);
+        const hasChanges = added.length > 0 || removed.length > 0;
+        if (hasChanges) anyChanges = true;
+        console.log(`  ${colorize6(tool.label, c6.bold, c6.cyan)}`);
+        if (!hasChanges) {
+          console.log(`    ${colorize6("\u2713", c6.dim)}  ${colorize6("no changes", c6.dim)} ${colorize6(`(${unchanged.length} line(s))`, c6.dim)}`);
+        } else {
+          for (const line of added) {
+            console.log(`    ${colorize6("+", c6.green)}  ${colorize6(line, c6.green)}`);
+          }
+          for (const line of removed) {
+            console.log(`    ${colorize6("-", c6.red)}  ${colorize6(line, c6.red)}`);
+          }
+          if (unchanged.length > 0) {
+            console.log(`    ${colorize6("\xB7", c6.dim)}  ${colorize6(`${unchanged.length} line(s) unchanged`, c6.dim)}`);
+          }
+        }
+      }
+      writeCache(tool.label, project, freshOutput, fresh.code);
+      console.log("");
+    }
+    if (!anyChanges) {
+      console.log(`  ${colorize6("\u2713", c6.green)}  All tools unchanged since last run`);
+    } else {
+      console.log(`  ${colorize6("\u2022", c6.dim)}  Cache updated with latest results`);
+    }
+    console.log("");
+  });
+  return cmd;
+}
+
+// src/commands/dashboard.ts
+import { Command as Command9 } from "commander";
+import { execSync as execSync2 } from "child_process";
+function createDashboardCommand() {
+  const cmd = new Command9("dashboard");
+  cmd.description("Generate an HTML velocity dashboard and open it in the browser");
+  cmd.option("--no-open", "Write the HTML file without opening the browser");
+  cmd.action(async (options) => {
+    const { path, summary } = await generateDashboard();
+    console.log(summary);
+    if (options.open !== false) {
+      const platform = process.platform;
+      try {
+        if (platform === "darwin") {
+          execSync2(`open "${path}"`, { stdio: "ignore" });
+        } else if (platform === "linux") {
+          execSync2(`xdg-open "${path}"`, { stdio: "ignore" });
+        } else {
+          console.log(`Dashboard written to: ${path}`);
+        }
+      } catch {
+        console.log(`Dashboard written to: ${path}`);
+      }
+    }
+  });
+  return cmd;
+}
+
+// src/index.ts
+import { readFileSync as readFileSync6 } from "fs";
+import { resolve as resolve6, dirname as dirname4 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
+var { version } = JSON.parse(readFileSync6(resolve6(__dirname4, "..", "package.json"), "utf8"));
+var program = new Command10();
 program.name("when").version(version).description("The WhenLabs developer toolkit \u2014 6 tools, one install");
 program.command("install").description("Install all WhenLabs tools globally (MCP server + CLAUDE.md instructions)").option("--cursor", "Install MCP servers into Cursor (~/.cursor/mcp.json)").option("--vscode", "Install MCP servers into VS Code (settings.json)").option("--windsurf", "Install MCP servers into Windsurf (~/.codeium/windsurf/mcp_config.json)").option("--all", "Install MCP servers into all supported editors").action(async (options) => {
-  const { install } = await import("./install-V24JHOA2.js");
+  const { install } = await import("./install-33GE3HKA.js");
   await install(options);
 });
 program.command("uninstall").description("Remove all WhenLabs tools").option("--cursor", "Remove MCP servers from Cursor").option("--vscode", "Remove MCP servers from VS Code").option("--windsurf", "Remove MCP servers from Windsurf").option("--all", "Remove MCP servers from all supported editors").action(async (options) => {
@@ -612,10 +1288,16 @@ program.command("ci").description("Run stale, envalid, and vow checks \u2014 exi
 program.addCommand(createInitCommand());
 program.addCommand(createDoctorCommand());
 program.addCommand(createWatchCommand());
+program.addCommand(createConfigCommand());
+program.addCommand(createUpgradeCommand());
+program.addCommand(createEjectCommand());
+program.addCommand(createDiffCommand());
 program.addCommand(createDelegateCommand("stale", "Detect documentation drift in your codebase"));
 program.addCommand(createDelegateCommand("envalid", "Validate .env files against a type-safe schema"));
 program.addCommand(createDelegateCommand("berth", "Detect and resolve port conflicts"));
 program.addCommand(createDelegateCommand("aware", "Auto-detect your stack and generate AI context files"));
 program.addCommand(createDelegateCommand("vow", "Scan dependency licenses and validate against policies"));
-program.addCommand(createDelegateCommand("velocity", "velocity-mcp task timing server", "velocity-mcp"));
+var velocityCmd = createDelegateCommand("velocity", "velocity-mcp task timing server", "velocity-mcp");
+velocityCmd.addCommand(createDashboardCommand());
+program.addCommand(velocityCmd);
 program.parse();