@whenlabs/when 0.9.2 → 0.10.0

package/README.md

@@ -4,6 +4,8 @@
 
 A single installable toolkit that brings six WhenLabs developer tools into your Claude Code / AI coding agent workflow. Once installed, all tools are available as MCP tools in every session — Claude uses them automatically when relevant.
 
+Five tools (stale, envalid, berth, aware, vow) have CLI scan modes and run on a schedule. Velocity is the sixth tool — it is always-on and embedded (SQLite-backed), so it does not have a CLI scan mode and does not appear in `doctor`/`watch`/`init`/`ci` output.
+
 ## Install
 
 ```bash
@@ -49,18 +51,28 @@ These tools are available to Claude in every session after install:
 | `velocity_history` | Show task history |
 | `stale_scan` | Detect documentation drift |
 | `stale_fix` | Auto-fix documentation drift (wrong paths, dead links, phantom env vars) |
+| `stale_auto_fix` | Scan + auto-fix drift in one call |
 | `envalid_validate` | Validate .env files against schemas |
 | `envalid_detect` | Find undocumented env vars in codebase |
 | `envalid_generate_schema` | Generate .env.schema from code analysis |
+| `envalid_auto_fix` | Detect undocumented vars + auto-generate schema entries |
 | `berth_status` | Show active ports and conflicts |
 | `berth_check` | Scan project for port conflicts |
 | `berth_resolve` | Auto-resolve port conflicts (kill or reassign) |
+| `berth_auto_resolve` | Check + auto-resolve conflicts in one call |
 | `aware_init` | Auto-detect stack, generate AI context files |
 | `aware_doctor` | Diagnose project health and config issues |
+| `aware_auto_sync` | Diagnose + auto-sync stale AI context files |
 | `vow_scan` | Scan and summarize dependency licenses |
 | `vow_check` | Validate licenses against policy |
 | `vow_hook_install` | Install pre-commit license check hook |
 
+> This table shows a highlights subset. Run `when <tool> --help` for all available commands per tool.
+
+### Cross-tool Intelligence
+
+Tools automatically suggest follow-up actions when they detect issues relevant to other tools. For example, `aware_init` triggers a `stale_scan` when it generates new files, and `envalid_detect` suggests `berth_register` when it finds service URL env vars. These cascading suggestions surface as "Tip:" lines in tool output.
+
 ## Multi-Editor Support
 
 Install MCP servers into other editors alongside Claude Code:
@@ -79,7 +91,10 @@ Without flags, `install` targets Claude Code only.
 You can also run tools directly from the command line:
 
 ```bash
-when init            # Onboard a project — detect stack, run all tools
+when init            # Onboard a project — bootstrap configs, run all tools, auto-fix
+when config          # Show unified .whenlabs.yml config
+when config init     # Generate .whenlabs.yml from existing tool configs
+when config validate # Validate config structure
 when stale scan
 when stale fix       # Auto-fix documentation drift
 when envalid validate
@@ -98,7 +113,15 @@ when ci              # Run checks for CI (exits 1 on issues)
 
 ### `when init`
 
-One command to onboard any project. Auto-detects your stack, runs all 5 tools in parallel, generates AI context files if missing, and shows a summary with next steps.
+One command to fully onboard any project:
+1. **Bootstrap** — creates `.env.schema`, `.vow.json`, `.stale.yml`, and registers berth ports based on your project
+2. **Scan** — runs all 5 CLI tools in parallel
+3. **Auto-fix** — automatically fixes stale drift if detected
+4. **Config** — generates a unified `.whenlabs.yml` from the bootstrapped configs
+
+### `when config`
+
+Manage the unified `.whenlabs.yml` project config. All six tools read their settings from this single file instead of separate config files. Subcommands: `init` (generate from existing configs), `validate` (check structure).
 
 ### `when doctor`
 
@@ -106,7 +129,7 @@ Runs all 5 CLI tools against the current project and displays a unified health r
 
 ### `when watch`
 
-Background daemon that runs all 5 tools on intervals and writes results to `~/.whenlabs/status.json`. Powers the Claude Code status line integration. Use `--once` for a single scan or `--interval <seconds>` to customize the schedule.
+Background daemon that runs all 5 CLI tools on intervals and writes results to `~/.whenlabs/status.json`. Powers the Claude Code status line integration. Use `--once` for a single scan or `--interval <seconds>` to customize the schedule.
 
 ### `when ci`
 

package/dist/chunk-JOMP6AU5.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+// src/utils/find-bin.ts
+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;
+  const directCli = resolve(pkgRoot, "node_modules", "@whenlabs", name, "dist", "cli.js");
+  if (existsSync(directCli)) return directCli;
+  return name;
+}
+
+// src/config/whenlabs-config.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+import { parse } from "yaml";
+var CONFIG_FILENAME = ".whenlabs.yml";
+function loadConfig(projectPath) {
+  const dir = projectPath ?? process.cwd();
+  const configPath = resolve2(dir, CONFIG_FILENAME);
+  if (!existsSync2(configPath)) return null;
+  try {
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = parse(raw);
+    if (!parsed || typeof parsed !== "object") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  findBin,
+  CONFIG_FILENAME,
+  loadConfig
+};