@haus-tech/haus-workflow 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.27.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.26.1...v0.27.0) (2026-06-15)
+
+### Features
+
+- **install:** suggest Caveman and RTK after global install ([#111](https://github.com/WeAreHausTech/haus-workflow/issues/111)) ([ab39845](https://github.com/WeAreHausTech/haus-workflow/commit/ab3984550f931f10083aa8e9e5b736c9a7765e94))
+
+## [0.26.1](https://github.com/WeAreHausTech/haus-workflow/compare/v0.26.0...v0.26.1) (2026-06-15)
+
 ## [0.26.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.25.1...v0.26.0) (2026-06-15)
 
 ### Features

package/README.md

@@ -87,8 +87,11 @@ project when their on-disk copy still matches the lock hash; user-edited copies
 
 ## Internal docs
 
+[docs/SUMMARY.md](docs/SUMMARY.md) — full documentation index
+
 - [Architecture](docs/architecture.md)
+- [Codebase](docs/codebase.md)
 - [CLI reference](docs/cli.md)
+- [Developer scripts & release](docs/dev.md)
 - [Security](docs/security.md)
-- [Developer scripts](docs/dev.md)
 - [Runbook](docs/runbook.md)

package/dist/cli.js

@@ -3794,6 +3794,59 @@ function printApplyResult(result, dryRun) {
   }
 }
 
+// src/install/companion-tools.ts
+import { execaSync } from "execa";
+var COMPANION_TOOLS = [
+  {
+    bin: "caveman",
+    label: "Caveman",
+    blurb: "Ultra-compressed Claude Code responses \u2014 cuts output tokens ~75%.",
+    installCmds: [
+      "curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash"
+    ],
+    url: "https://github.com/JuliusBrussee/caveman"
+  },
+  {
+    bin: "rtk",
+    label: "RTK (Rust Token Killer)",
+    blurb: "Token-optimized CLI proxy \u2014 60-90% savings on dev operations.",
+    installCmds: [
+      "brew install rtk",
+      "cargo install --git https://github.com/rtk-ai/rtk   # if Homebrew is unavailable"
+    ],
+    url: "https://github.com/rtk-ai/rtk",
+    note: 'Another crate named "rtk" (Rust Type Kit) exists on crates.io \u2014 use the commands above, not a bare `cargo install rtk`.'
+  }
+];
+function buildCompanionSuggestions(tools, isInstalled) {
+  const missing = tools.filter((t) => !isInstalled(t.bin));
+  if (missing.length === 0) return [];
+  const lines = ["", "Optional token-saving tools you can add:"];
+  for (const tool of missing) {
+    lines.push("", `  ${tool.label} \u2014 ${tool.blurb}`);
+    for (const cmd of tool.installCmds) {
+      lines.push(`    ${cmd}`);
+    }
+    if (tool.note) lines.push(`    note: ${tool.note}`);
+    lines.push(`    ${tool.url}`);
+  }
+  return lines;
+}
+function commandExists(bin) {
+  try {
+    const r = execaSync("sh", ["-c", 'command -v -- "$1"', "probe", bin], { reject: false });
+    return r.exitCode === 0;
+  } catch {
+    return false;
+  }
+}
+function printCompanionToolSuggestions(deps = {}) {
+  const isInstalled = deps.isInstalled ?? commandExists;
+  const emit2 = deps.log ?? log;
+  const lines = buildCompanionSuggestions(COMPANION_TOOLS, isInstalled);
+  for (const line2 of lines) emit2(line2);
+}
+
 // src/commands/install.ts
 async function runInstall(options) {
   try {
@@ -3806,6 +3859,7 @@ async function runInstall(options) {
     if (options.check && result.drift) {
       process.exitCode = 1;
     } else if (!options.check && !options.dryRun) {
+      printCompanionToolSuggestions();
       const total = result.created.length + result.updated.length;
       if (options.postinstall) {
         log("haus configured Claude Code for you:");

package/library/catalog/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.7.0",
+  "version": "2.7.2",
   "items": [
     {
       "id": "haus.nextjs-patterns",
@@ -1648,7 +1648,7 @@
     },
     {
       "id": "haus.superpowers-using-git-worktrees",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "curated",
       "type": "skill",
       "path": "skills/superpowers/using-git-worktrees",
@@ -1658,7 +1658,7 @@
       "whenNotToUse": "Do not use when current workspace isolation is already sufficient.",
       "tags": ["workflow", "workflow-skill"],
       "repoRoles": [],
-      "tokenEstimate": 1996,
+      "tokenEstimate": 2140,
       "installMode": "copy-selected",
       "default": true,
       "reviewStatus": "approved",
@@ -1667,8 +1667,9 @@
       "license": "MIT",
       "licenseConfidence": "high",
       "originSourceId": "superpowers-pcvelz",
-      "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/using-git-worktrees",
-      "ecosystem": "superpowers"
+      "originUrl": "https://github.com/pcvelz/superpowers/tree/20c0b1ed71cb073c847432fe01379f48c5278a5f/skills/using-git-worktrees",
+      "ecosystem": "superpowers",
+      "pinnedRef": "20c0b1ed71cb073c847432fe01379f48c5278a5f"
     },
     {
       "id": "haus.superpowers-using-superpowers",
@@ -1889,7 +1890,7 @@
     },
     {
       "id": "haus.superpowers-onboard",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "curated",
       "type": "command",
       "path": "commands/superpowers/onboard.md",
@@ -1899,7 +1900,7 @@
       "whenNotToUse": "Do not use when a more specific skill or command applies.",
       "tags": ["workflow"],
       "repoRoles": [],
-      "tokenEstimate": 2871,
+      "tokenEstimate": 3567,
       "installMode": "copy-selected",
       "default": true,
       "reviewStatus": "approved",
@@ -1908,8 +1909,8 @@
       "license": "MIT",
       "licenseConfidence": "high",
       "originSourceId": "superpowers-pcvelz",
-      "originUrl": "https://github.com/pcvelz/superpowers/blob/48f5123e18a1a92dfba962da8dc2509391c821ee/commands/onboard.md",
-      "pinnedRef": "48f5123e18a1a92dfba962da8dc2509391c821ee",
+      "originUrl": "https://github.com/pcvelz/superpowers/blob/20c0b1ed71cb073c847432fe01379f48c5278a5f/commands/onboard.md",
+      "pinnedRef": "20c0b1ed71cb073c847432fe01379f48c5278a5f",
       "ecosystem": "superpowers"
     },
     {

package/library/global/commands/haus-cloneandsetup.md

@@ -34,7 +34,7 @@ Specify the least. Infer the rest from the repo's stack + these conventions, and
 
 - **IMPORTANT — never install anything without asking first; global/system tools especially** (Homebrew, Docker, Laravel Herd, global `npm`/`composer` packages). Detect what's already present; if something required is missing, name it, say why it's needed, and get an explicit **yes** before installing. Prefer the least-invasive option, and don't switch or override tools the dev already has.
 - **PHP / WordPress sites are served by the developer's own PHP environment.** If they already have one — detect `valet`, `herd`, `ddev`, or `php` on PATH — **use it**: just satisfy the env contract (docroot → the repo's `web/`, HTTPS) and report the URL; never override what they already run. **Only when no local PHP environment exists** (a completely fresh machine) suggest installing **[Laravel Herd](https://herd.laravel.com)** as the default (asking first) and point its docroot at `web/` + `herd secure`.
-- **Databases and other services (a repo's `needs:`) run in Docker as standalone containers.** Bring each up with a **clean `docker run`** — image, host port, and env from the house convention for that service (e.g. `mysql` → `mysql:8` on `127.0.0.1:3306`, root password from generated secrets; `postgres` → `postgres:16` on `5432`). **Do not provision a `needs:` service from the repo's own `docker-compose.yml` when that compose bind-mounts repo-relative init files** (e.g. `./seed.sql`, `./docker-entrypoint-initdb.d/`): those mounts need files the guard won't let us create, and they conflate bring-up with seeding (which is the separate `seed:` step). **If Docker isn't installed** it's a prerequisite (surfaced in the Step 2 gate) — **ask before installing it** (global install). **Port-conflict caveat:** if the conventional host port is already taken, pick the next free port, use it, and **record the chosen port in the workspace `localdev.yml` `env` map** so sink repos point at the right place. A `needs:` service comes up **empty** — populating it is always the separate `seed:` step.
+- **Databases and other services (a repo's `needs:`) run in Docker as a shared, workspace-owned `docker-compose` project** — grouped and self-contained (`up`/`down` together, named volumes), namespaced per workspace instance via `COMPOSE_PROJECT_NAME` + its own host ports so the workspace can run multiple times side by side. Image/port/env per the house convention (`mysql:8`, `postgres:16`, …). Don't reuse a repo's own compose that bind-mounts repo-relative init files (`seed.sql`) — author the service in the workspace compose. Services come up **empty** (seeding is the separate `seed:` step); record chosen host ports in the workspace `localdev.yml` `env` map.
 - **Dependencies** install from the lockfile (Step 3).
 - A repo's `localdev.yml` carries **only what can't be inferred** — its `needs`, repo-specific `build`/`seed` commands, env keys, and URL. Detect the stack (e.g. Bedrock = `composer.json` + `web/` docroot + `wp-cli.yml`; Vendure/Node = `docker-compose.yml` + `@vendure/*`) and apply the matching convention.
 
@@ -84,7 +84,7 @@ env:
 1. **Discover** `.haus-workflow/localdev.yml` in the workspace root and each repo.
 2. **Resolve order** from the workspace `order` (repos not listed run last, in manifest order). No workspace file → manifest order.
 3. **Per repo, in order**, apply intent via the conventions:
-   - **`needs`** → bring up each service as a **standalone `docker run`** (image/port/env from conventions; **not** the repo's compose when it bind-mounts repo-relative init files) if not already running. The service comes up **empty**; record its values in the workspace `localdev.yml` `env` map. No data is created here, so no overwrite prompt at this step — data lands in `seed:`.
+   - **`needs`** → add the service to the **workspace compose project** and `docker compose up -d` if not already running (namespaced by `COMPOSE_PROJECT_NAME`, free host ports per instance; not the repo's own bind-mounting compose). Comes up **empty**; record host ports in the workspace `localdev.yml` `env` map — data lands in `seed:`.
    - **`build`** → run it (honor any node version the repo's docs note).
    - **`serve`** → for `via: herd` / PHP envs, install nothing — verify the dev's environment serves `web/`, and report the URL.
    - **`seed`** → populate the empty datastore. **Always a distinct, confirm-gated step, separate from `needs:` bring-up** (don't conflate "DB up" with "DB has data"). Before running, **check its prerequisites and report any gap instead of running blind** — e.g. WP-CLI present (for `wp` / `db:pull` seeds), the target repo's **`.env` written** (the seed reads connection values from it — done in the Env step above), the **SSH alias resolves** (for remote pulls like `dep db:pull staging-oderland`). **Confirm first** for every remote (SSH) or destructive (overwrites data) seed — every run, even on re-run. Missing prerequisite → skip with a clear message, don't guess.
@@ -112,13 +112,13 @@ env:
    - **Yes** → start each repo in the workspace `order` (its `serve.start`, e.g. `yarn dev`; bring up any remaining foreground services), run any follow-ups (e.g. `wp sync-products sync`), then **print the live URLs** (each repo's `serve.url`).
    - **No** → just print the ordered start commands + follow-ups as next steps; start nothing.
 
-**Default is "ready to run" (D2):** the preparation — datastores up (standalone `docker run`), seeds applied (confirm-gated), links, builds, each repo's `.env` written — always happens. Starting the **foreground** dev servers and the initial product sync happen **only if the user says yes** to the start prompt above; otherwise they're printed, not run.
+**Default is "ready to run" (D2):** the preparation — datastores up (workspace `docker compose` project), seeds applied (confirm-gated), links, builds, each repo's `.env` written — always happens. Starting the **foreground** dev servers and the initial product sync happen **only if the user says yes** to the start prompt above; otherwise they're printed, not run.
 
 ## Step 5 — Report and define "done"
 
 **"Done" is an explicit terminal state**, not "looks set up". The preparation reaches:
 
-- datastores up (standalone containers),
+- datastores up (workspace `docker compose` project),
 - dependencies installed and builds green,
 - links wired,
 - each repo's `.env` written from known values.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Haus AI workflow CLI for Claude Code.",
   "type": "module",
   "bin": {
@@ -22,7 +22,8 @@
   "scripts": {
     "build": "tsup src/cli.ts --format esm --dts --clean --out-dir dist --external @inquirer/checkbox",
     "dev": "tsx src/cli.ts",
-    "test": "node --import tsx --test tests/**/*.test.js",
+    "test": "node scripts/run-tests.mjs tests/**/*.test.js",
+    "test:fast": "node scripts/test-fast.mjs",
     "test:coverage": "c8 yarn test",
     "coverage:check": "c8 --check-coverage yarn test",
     "lint": "eslint src",