@whenlabs/when 0.9.2 → 0.10.0

package/dist/index.js

@@ -1,24 +1,19 @@
 #!/usr/bin/env node
+import {
+  CONFIG_FILENAME,
+  findBin,
+  loadConfig
+} from "./chunk-JOMP6AU5.js";
 import {
   getStatusPath
 } from "./chunk-4ZVSCJCJ.js";
 
 // src/index.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 
 // src/commands/delegate.ts
 import { Command } from "commander";
 import { spawn } from "child_process";
-import { resolve, dirname } from "path";
-import { existsSync } from "fs";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-function findBin(name) {
-  const pkgRoot = resolve(__dirname, "..");
-  const localBin = resolve(pkgRoot, "node_modules", ".bin", name);
-  if (existsSync(localBin)) return localBin;
-  return name;
-}
 function createDelegateCommand(name, description, binName) {
   const cmd = new Command(name);
   cmd.description(description);
@@ -53,14 +48,14 @@ import { Command as Command2 } from "commander";
 
 // src/utils/tool-runner.ts
 import { spawn as spawn2 } from "child_process";
-import { resolve as resolve2, dirname as dirname2 } from "path";
-import { existsSync as existsSync2 } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+import { resolve, dirname } from "path";
+import { existsSync } from "fs";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
 function findBin2(name) {
-  const pkgRoot = resolve2(__dirname2, "..", "..");
-  const localBin = resolve2(pkgRoot, "node_modules", ".bin", name);
-  if (existsSync2(localBin)) return localBin;
+  const pkgRoot = resolve(__dirname, "..", "..");
+  const localBin = resolve(pkgRoot, "node_modules", ".bin", name);
+  if (existsSync(localBin)) return localBin;
   return name;
 }
 function runTool(bin, args) {
@@ -303,10 +298,11 @@ function createDoctorCommand() {
 // src/commands/init.ts
 import { Command as Command3 } from "commander";
 import { spawn as spawn3 } from "child_process";
-import { resolve as resolve3, dirname as dirname3, basename } from "path";
-import { existsSync as existsSync3, readFileSync } from "fs";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
+import { resolve as resolve2, dirname as dirname2, basename } from "path";
+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",
   bold: "\x1B[1m",
@@ -319,16 +315,10 @@ var c2 = {
 function colorize2(text, ...codes) {
   return codes.join("") + text + c2.reset;
 }
-function findBin3(name) {
-  const pkgRoot = resolve3(__dirname3, "..");
-  const localBin = resolve3(pkgRoot, "node_modules", ".bin", name);
-  if (existsSync3(localBin)) return localBin;
-  return name;
-}
 function detectProject(cwd) {
   let name = basename(cwd);
-  const pkgPath = resolve3(cwd, "package.json");
-  if (existsSync3(pkgPath)) {
+  const pkgPath = resolve2(cwd, "package.json");
+  if (existsSync2(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
       if (pkg.name) name = pkg.name;
@@ -349,15 +339,31 @@ function detectProject(cwd) {
   ];
   const stacks = [];
   for (const [file, stack] of stackFiles) {
-    if (existsSync3(resolve3(cwd, file)) && !stacks.includes(stack)) {
+    if (existsSync2(resolve2(cwd, file)) && !stacks.includes(stack)) {
       stacks.push(stack);
     }
   }
   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 = "";
@@ -372,8 +378,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);
@@ -384,7 +457,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 {
@@ -396,7 +469,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);
@@ -407,7 +480,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;
@@ -423,14 +496,14 @@ async function scanVow(cwd) {
   }
 }
 async function scanAware(cwd) {
-  const hasConfig = existsSync3(resolve3(cwd, ".aware.json"));
+  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;
@@ -450,7 +523,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("");
@@ -461,6 +534,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),
@@ -478,17 +598,36 @@ 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));
-    const mcpInstalled = existsSync3(resolve3(process.env.HOME ?? "~", ".claude", "settings.json"));
+    const mcpInstalled = existsSync2(resolve2(process.env.HOME ?? "~", ".claude", "settings.json"));
     if (!mcpInstalled) {
       console.log(`    ${colorize2("\u2022", c2.cyan)} Run ${colorize2("when install", c2.bold)} to connect MCP tools to Claude Code`);
     }
@@ -505,7 +644,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;
@@ -542,14 +681,14 @@ 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((resolve5) => setTimeout(resolve5, ms));
 }
 function createWatchCommand() {
   const cmd = new Command4("watch");
-  cmd.description("Run all 5 WhenLabs tools on a schedule and write results to ~/.whenlabs/status.json");
+  cmd.description("Run all 5 CLI tools on a schedule and write results to ~/.whenlabs/status.json (velocity is embedded and always-on \u2014 it does not participate in scheduled scans)");
   cmd.option("--once", "Run a single scan and exit");
   cmd.option("--interval <seconds>", "Override the default scan interval (seconds)", "60");
   cmd.action(async (options) => {
@@ -592,11 +731,213 @@ function createWatchCommand() {
   return cmd;
 }
 
+// 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/index.ts
-var program = new Command5();
-program.name("when").version("0.1.0").description("The WhenLabs developer toolkit \u2014 6 tools, one install");
+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(readFileSync3(resolve4(__dirname3, "..", "package.json"), "utf8"));
+var program = new Command6();
+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-F46OPKIA.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) => {
@@ -614,6 +955,7 @@ 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(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"));