@haus-tech/haus-workflow 4.1.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [4.3.0](https://github.com/WeAreHausTech/haus-workflow/compare/v4.2.0...v4.3.0) (2026-08-24)
+
+### Features
+
+- **doctor:** advisory hint when project docs were never generated ([#341](https://github.com/WeAreHausTech/haus-workflow/issues/341)) ([711ca0f](https://github.com/WeAreHausTech/haus-workflow/commit/711ca0fa5d2ed27e0bf05601c2e7a556ce542733))
+- **install:** allow all non-destructive subcommands ([#338](https://github.com/WeAreHausTech/haus-workflow/issues/338)) ([47d4636](https://github.com/WeAreHausTech/haus-workflow/commit/47d463689ca9e82faaf1f3eed74e1a308a47890f))
+- **new:** add react-router stack; project:new writes docs, sets structure, stays private ([#345](https://github.com/WeAreHausTech/haus-workflow/issues/345)) ([2a45cd9](https://github.com/WeAreHausTech/haus-workflow/commit/2a45cd9b44aa35ecf38aaa623cd7ce02fdff62d8)), closes [#339](https://github.com/WeAreHausTech/haus-workflow/issues/339) [#340](https://github.com/WeAreHausTech/haus-workflow/issues/340) [#342](https://github.com/WeAreHausTech/haus-workflow/issues/342) [#343](https://github.com/WeAreHausTech/haus-workflow/issues/343) [#339](https://github.com/WeAreHausTech/haus-workflow/issues/339) [#340](https://github.com/WeAreHausTech/haus-workflow/issues/340) [#342](https://github.com/WeAreHausTech/haus-workflow/issues/342) [#343](https://github.com/WeAreHausTech/haus-workflow/issues/343)
+- **scanner:** detect python and go repos as backend stack tokens ([#344](https://github.com/WeAreHausTech/haus-workflow/issues/344)) ([6a062d9](https://github.com/WeAreHausTech/haus-workflow/commit/6a062d989408634810a7a7007718c981960a2814))
+- **skill:** update the request-pipeline skills to the current working versions ([#334](https://github.com/WeAreHausTech/haus-workflow/issues/334)) ([7e2c556](https://github.com/WeAreHausTech/haus-workflow/commit/7e2c556be36e333b4577814daf7f09ac63cc023f))
+
+### Bug Fixes
+
+- **request-classify:** redefine B2 around what the change requires ([#335](https://github.com/WeAreHausTech/haus-workflow/issues/335)) ([5ef8418](https://github.com/WeAreHausTech/haus-workflow/commit/5ef84184273f151e93fb1daee7a60bd0f0a80b7c))
+
+## [4.2.0](https://github.com/WeAreHausTech/haus-workflow/compare/v4.1.0...v4.2.0) (2026-08-21)
+
+### Features
+
+- **install:** bundle request-pipeline and slack-cowork global skills ([#332](https://github.com/WeAreHausTech/haus-workflow/issues/332)) ([1978b5d](https://github.com/WeAreHausTech/haus-workflow/commit/1978b5d2cb5098a8c87e9db7148633ebef5b4c33))
+
+### Bug Fixes
+
+- haus new empty-cache flag and setupOk signal ([#333](https://github.com/WeAreHausTech/haus-workflow/issues/333)) ([5a9004a](https://github.com/WeAreHausTech/haus-workflow/commit/5a9004ae23d7189d5645dc7e830e3b4cbb420203)), closes [#329](https://github.com/WeAreHausTech/haus-workflow/issues/329) [#330](https://github.com/WeAreHausTech/haus-workflow/issues/330)
+
 ## [4.1.0](https://github.com/WeAreHausTech/haus-workflow/compare/v4.0.1...v4.1.0) (2026-08-21)
 
 ### Features

package/README.md

@@ -138,13 +138,16 @@ waiting on timeouts (catalog sync, npm version check, workflow-template fetch, l
 reference fetch, global-plugin install; the read-only local plugin probe still runs — see
 [docs/cli.md](docs/cli.md) → `--offline` for why). It never changes what gets installed.
 
-The honest-shortfall reporting covers `haus apply`, `haus init`, and `haus workspace
-setup` (issue #325 extended `apply`'s original ADR-0060 gate to the other two): a run
-that cannot install everything it wanted reports `K of N catalog items installed` and
-exits 1 if it installed none, unless `--allow-empty-cache` opts into writing core files
-anyway (still exits 1 having installed nothing). `workspace setup` reports this per
-member repo — a repo that installed zero catalog items is recorded `failed`, not `ok`.
-See [docs/cli.md](docs/cli.md) for each command's exact flags and behaviour.
+The honest-shortfall reporting covers `haus apply`, `haus init`, `haus new`, and
+`haus workspace setup` (issue #325 extended `apply`'s original ADR-0060 gate to `init`
+and `workspace setup`; issue #329 threaded the same `--allow-empty-cache` flag through
+`haus new`): a run that cannot install everything it wanted reports `K of N catalog
+items installed` and exits 1 if it installed none, unless `--allow-empty-cache` opts
+into writing core files anyway (still exits 1 having installed nothing). `workspace
+setup` reports this per member repo — a repo that installed zero catalog items, hit
+the zero-signal guard, or was refused for an unsupported catalog format is recorded
+`failed`, not `ok` (issue #330). See [docs/cli.md](docs/cli.md) for each command's
+exact flags and behaviour.
 
 ## Internal docs
 

package/dist/cli.js

@@ -1225,10 +1225,6 @@ var init_validation_rules = __esm({
   "library/catalog/validation-rules.json"() {
     validation_rules_default = {
       forbiddenTags: [
-        "python",
-        "django",
-        "go",
-        "golang",
         "rust",
         "rustlang",
         "java",
@@ -1278,6 +1274,8 @@ var init_validation_rules = __esm({
         "typescript",
         "php",
         "csharp",
+        "python",
+        "golang",
         "vendure",
         "vendure3",
         "nestjs",
@@ -2380,9 +2378,6 @@ function isRecord(v) {
 
 // src/scanner/detection.ts
 var UNSUPPORTED_MARKERS = {
-  "requirements.txt": "python",
-  "pyproject.toml": "python",
-  "go.mod": "go",
   "Cargo.toml": "rust",
   "pom.xml": "java",
   "build.gradle": "java",
@@ -2818,7 +2813,55 @@ async function writeManagedJson(root, filePath, value, dryRun, quiet = false) {
 }
 
 // src/install/allow-rules.ts
-var ALLOWED_SUBCOMMANDS = ["init", "apply", "doctor", "scan", "recommend"];
+var ALLOWED_SUBCOMMANDS = [
+  // Setup / health / recommendation flow
+  "init",
+  "apply",
+  "doctor",
+  "scan",
+  "recommend",
+  "explain-recommendation",
+  "fetch-refs",
+  "rescan",
+  // Project creation (create-only; refuses existing targets)
+  "clone",
+  "new",
+  // Global install / update (writes ~/.claude + plugin pins, never deletes user content)
+  "update",
+  "install",
+  "configs",
+  // Read-only reporting and validation
+  "ci-gate",
+  "catalog-audit",
+  "validate-catalog",
+  "backups list",
+  "guard file-access",
+  "guard bash",
+  // Catalog cache maintenance (staged + validated, never deletes user content)
+  "catalog bundle export",
+  "catalog bundle import",
+  // Decision gate (read-only; `suggest` prints a draft, it does not write one)
+  "decisions check",
+  "decisions suggest",
+  "decisions next-number",
+  "decisions guard",
+  "decisions validate",
+  "adr check",
+  "adr suggest",
+  "adr next-number",
+  "adr guard",
+  "adr validate",
+  // Workspace (planning previews, scans, setup merge; no deleters)
+  "workspace discover",
+  "workspace scan",
+  "workspace setup",
+  "workspace doctor",
+  "workspace link-context",
+  "workspace worktree add",
+  "workspace worktree hydrate",
+  "workspace worktree list",
+  "workspace worktree doctor"
+];
 function buildAllowRules() {
   return [...new Set(ALLOWED_SUBCOMMANDS.map((sub) => `Bash(haus ${sub}:*)`))];
 }
@@ -7587,7 +7630,23 @@ var STACK_RULES = [
     stack: ["auth", "saml2"],
     any: [dep("24slides/laravel-saml2"), dep("aacotroneo/laravel-saml2")]
   },
-  { stack: ["auth", "next-auth"], any: [dep("next-auth"), dep("@auth/core")] }
+  { stack: ["auth", "next-auth"], any: [dep("next-auth"), dep("@auth/core")] },
+  // Python — broad language signal so python-tooling catalog items gated on
+  // { stack: 'python' } are recommendable on any Python project (same rationale as
+  // the 'php' rule above: composer.json presence). Appended at the end so existing
+  // bucket insertion order is untouched.
+  {
+    stack: ["backend", "python"],
+    any: [
+      fileEndsWith("pyproject.toml"),
+      fileEndsWith("requirements.txt"),
+      fileEndsWith("setup.py"),
+      fileEquals("Pipfile")
+    ]
+  },
+  // Go — broad language signal, same rationale: catalog items gated on
+  // { stack: 'go' } become recommendable on any Go module.
+  { stack: ["backend", "go"], any: [fileEndsWith("go.mod")] }
 ];
 function runDetection(ctx, rules = STACK_RULES) {
   const roles = [];
@@ -7707,11 +7766,17 @@ var SAFE_FILES = [
   "**/*.sln",
   "docker-compose.*",
   "Dockerfile",
-  // Unsupported-ecosystem markers — matched by PRESENCE only (never content-read; none
-  // match the content-blob extensions). Drive detectionStatus / unsupportedSignals.
+  // Python/Go detection signals — matched by PRESENCE only (never content-read; none
+  // match the content-blob extensions). Drive the `python`/`go` stack rules in
+  // detection-registry.ts; requirements.txt / pyproject.toml / go.mod also still feed
+  // detectionStatus / unsupportedSignals (UNSUPPORTED_MARKERS in detection.ts).
   "requirements.txt",
   "pyproject.toml",
+  "setup.py",
+  "Pipfile",
   "go.mod",
+  // Unsupported-ecosystem markers — matched by PRESENCE only (never content-read; none
+  // match the content-blob extensions). Drive detectionStatus / unsupportedSignals.
   "Cargo.toml",
   "pom.xml",
   "build.gradle",
@@ -8032,6 +8097,20 @@ async function runDoctor(options) {
       ok("- .haus-workflow/workflow-config.md: OK (project-owned)");
     }
   }
+  const docsSkillInstalled = await fs37.pathExists(
+    path45.join(root, ".claude", "skills", "writing-documentation", "SKILL.md")
+  );
+  if (docsSkillInstalled) {
+    if (await fs37.pathExists(path45.join(root, "docs", "SUMMARY.md"))) {
+      ok("- PROJECT DOCS: OK (docs/SUMMARY.md present)");
+    } else {
+      suggest(
+        "- PROJECT DOCS: docs/SUMMARY.md missing \u2014 run the writing-documentation skill (`/docs` in Claude Code) to generate the project docs",
+        "The project docs index (docs/SUMMARY.md) has not been generated yet",
+        "run `/docs` in Claude Code (the writing-documentation skill)"
+      );
+    }
+  }
   if (workflowExists) {
     const prettierIgnore = await readText(path45.join(root, ".prettierignore")) ?? "";
     const lines = prettierIgnore.split("\n");
@@ -10585,8 +10664,10 @@ async function runSetupCore(root, opts) {
       hooksOk: false,
       written: [],
       // Pre-existing zero-signal guard, not the #325 catalog-install honesty check —
-      // deliberately left out of scope for `catalogInstallOk` (see its doc comment).
-      catalogInstallOk: true
+      // `catalogInstallOk` stays true; `setupOk` is false so workspace setup cannot
+      // record this repo as ok (issue #330).
+      catalogInstallOk: true,
+      setupOk: false
     };
   }
   await writeJson(hausPath(root, "recommendation.json"), recommendation);
@@ -10616,7 +10697,8 @@ async function runSetupCore(root, opts) {
     warnings: warningLines,
     hooksOk,
     written: [],
-    catalogInstallOk: true
+    catalogInstallOk: true,
+    setupOk: true
   };
   const envelope = (hooksResult) => ({
     scan: scanResult,
@@ -10645,7 +10727,7 @@ async function runSetupCore(root, opts) {
       error(sync.formatRefusal);
       process.exitCode = 1;
       emitJsonEnvelope(json, quiet, envelope(hooks));
-      return baseResult;
+      return { ...baseResult, setupOk: false };
     }
     if (sync.newItems.length > 0) {
       say(`Catalog cache populated: ${sync.newItems.length} new item(s).`);
@@ -10680,7 +10762,7 @@ async function runSetupCore(root, opts) {
           error(message2);
           process.exitCode = 1;
           emitJsonEnvelope(json, quiet, envelope(hooks));
-          return { ...baseResult, catalogInstallOk: false };
+          return { ...baseResult, catalogInstallOk: false, setupOk: false };
         }
       } else {
         warn(
@@ -10727,7 +10809,13 @@ async function runSetupCore(root, opts) {
     say(`- HOOKS OK: ${hooksAfter.message}`);
   }
   emitJsonEnvelope(json, quiet, envelope(hooksAfter));
-  return { ...baseResult, hooksOk: hooksOkAfter, written: files, catalogInstallOk };
+  return {
+    ...baseResult,
+    hooksOk: hooksOkAfter,
+    written: files,
+    catalogInstallOk,
+    setupOk: catalogInstallOk
+  };
 }
 
 // src/commands/init.ts
@@ -10963,6 +11051,29 @@ var STACKS = [
     overlayConfigIds: ["haus.eslint-config", "haus.prettier-config"],
     expectedRole: "react-app"
   },
+  {
+    id: "react-router",
+    title: "React Router app (framework mode, TypeScript)",
+    scaffold: {
+      package: "create-react-router",
+      majorPin: 8,
+      // --yes skips all option prompts; --no-git-init because the git step here
+      // owns init/branch/commit; --no-agent-skills because haus installs its own
+      // context assets. Default template ships react-router + @react-router/node,
+      // which is exactly the detection registry's react-router-app rule.
+      args: [
+        "{name}",
+        "--no-install",
+        "--no-git-init",
+        "--no-agent-skills",
+        "--package-manager",
+        "{pm}",
+        "--yes"
+      ]
+    },
+    overlayConfigIds: ["haus.eslint-config", "haus.prettier-config"],
+    expectedRole: "react-router-app"
+  },
   {
     id: "nest",
     title: "NestJS API",
@@ -11153,13 +11264,15 @@ async function createProject(opts, deps = defaultDeps) {
     phase = "init";
     if (!opts.json) log("\u25B6 init: haus setup pipeline");
     const exitCodeBeforeSetup = process.exitCode;
+    let setupResult;
     try {
-      await deps.setup(projectPath, {
+      setupResult = await deps.setup(projectPath, {
         json: false,
         apply: true,
         dryRun: false,
         quiet: opts.json,
-        confirm: opts.yes ? async () => true : () => confirm("Approve and write Claude files now?")
+        confirm: opts.yes ? async () => true : () => confirm("Approve and write Claude files now?"),
+        allowEmptyCache: opts.allowEmptyCache
       });
     } catch (err) {
       steps.push({
@@ -11169,15 +11282,26 @@ async function createProject(opts, deps = defaultDeps) {
       });
       return { ok: false, projectPath, repoUrl, installHint, steps };
     }
+    const catalogInstallRefused = setupResult?.catalogInstallOk === false;
+    const retryCmd = catalogInstallRefused ? `cd ${opts.name} && haus init --allow-empty-cache` : `cd ${opts.name} && haus init`;
     if (process.exitCode === 1 && exitCodeBeforeSetup !== 1) {
-      steps.push({
-        step: "init",
-        status: "failed",
-        detail: `haus init reported failure. Project and repo are intact \u2014 cd ${opts.name} && haus init to retry.`
-      });
-      return { ok: false, projectPath, repoUrl, installHint, steps };
+      if (opts.allowEmptyCache && catalogInstallRefused) {
+        steps.push({
+          step: "init",
+          status: "done",
+          detail: "core files written; catalog items skipped (--allow-empty-cache)"
+        });
+      } else {
+        steps.push({
+          step: "init",
+          status: "failed",
+          detail: `haus init reported failure. Project and repo are intact \u2014 ${retryCmd} to retry.`
+        });
+        return { ok: false, projectPath, repoUrl, installHint, steps };
+      }
+    } else {
+      steps.push({ step: "init", status: "done" });
     }
-    steps.push({ step: "init", status: "done" });
     phase = "overlay";
     if (!opts.json) log("\u25B6 overlay: haus config items");
     let overlay;
@@ -11264,7 +11388,7 @@ async function createProject(opts, deps = defaultDeps) {
   }
   if (!opts.json) log(`\u2713 Created ${projectPath}${repoUrl ? ` \u2192 ${repoUrl}` : ""}
   ${installHint}`);
-  return { ok: true, projectPath, repoUrl, installHint, steps };
+  return { ok: process.exitCode !== 1, projectPath, repoUrl, installHint, steps };
 }
 
 // src/commands/new.ts
@@ -11297,7 +11421,8 @@ function resolveNewOptions(stackArg, nameArg, flags, parentDir) {
       pm,
       yes: flags.yes === true,
       dryRun,
-      json: flags.json === true
+      json: flags.json === true,
+      allowEmptyCache: flags.allowEmptyCache === true
     }
   };
 }
@@ -14232,8 +14357,8 @@ async function runWorkspaceSetup(workspaceRoot, options = {}) {
       error(`Setup failed for ${repo.name}: ${message2}`);
       continue;
     }
-    if (!res.catalogInstallOk) {
-      const message2 = "No catalog items were installed for this repo (zero installable content) \u2014 see the per-repo output above, or re-run with --allow-empty-cache.";
+    if (!res.setupOk) {
+      const message2 = !res.catalogInstallOk ? "No catalog items were installed for this repo (zero installable content) \u2014 see the per-repo output above, or re-run with --allow-empty-cache." : "Setup wrote nothing for this repo \u2014 see the per-repo output above.";
       statuses.push({
         name: repo.name,
         path: repo.path,
@@ -14769,7 +14894,10 @@ program.command("init").description("Full setup: scan, recommend, and optionally
   "--allow-empty-cache",
   "Proceed when no catalog item has installable content: write core files and skip the catalog items. Still exits 1 if none installed (ADR-0060)"
 ).action(runInit);
-program.command("new").description("Create a new project from an allowed Haus stack, push it to GitHub, and run init").argument("[stack]", "Stack id (omit to pick interactively; see --list)").argument("[name]", "Project directory and repo name").option("--list", "Print the allowed stacks and exit").option("--org <org>", "GitHub org to create the repo in (default: personal account)").option("--public", "Create the GitHub repo public").option("--private", "Create the GitHub repo private (default)").option("--no-github", "Skip GitHub repo creation and push").option("--pm <pm>", "Package manager: yarn | npm | pnpm", "yarn").option("-y, --yes", "Skip confirmations (non-interactive)").option("--dry-run", "Print the full plan without executing anything").option("--json", "Emit a machine-readable result document").action(runNew);
+program.command("new").description("Create a new project from an allowed Haus stack, push it to GitHub, and run init").argument("[stack]", "Stack id (omit to pick interactively; see --list)").argument("[name]", "Project directory and repo name").option("--list", "Print the allowed stacks and exit").option("--org <org>", "GitHub org to create the repo in (default: personal account)").option("--public", "Create the GitHub repo public").option("--private", "Create the GitHub repo private (default)").option("--no-github", "Skip GitHub repo creation and push").option("--pm <pm>", "Package manager: yarn | npm | pnpm", "yarn").option("-y, --yes", "Skip confirmations (non-interactive)").option("--dry-run", "Print the full plan without executing anything").option("--json", "Emit a machine-readable result document").option(
+  "--allow-empty-cache",
+  "Proceed when no catalog item has installable content: write core files and skip the catalog items. Still exits 1 if none installed (ADR-0060)"
+).action(runNew);
 program.command("clone").description("Clone a single git repository by URL").argument("<url>", "Git URL to clone").argument("[dir]", "Target directory (default: repo name derived from the URL)").option("--dry-run", "Print what would happen without cloning").action(
   (url, dir, opts) => runClone(url, { dir, dryRun: opts.dryRun })
 );