@haus-tech/haus-workflow 0.29.0 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.30.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.29.0...v0.30.0) (2026-06-22)
+
+### Features
+
+- auto recommend config setups ([#137](https://github.com/WeAreHausTech/haus-workflow/issues/137)) ([56e7941](https://github.com/WeAreHausTech/haus-workflow/commit/56e79413a6cfe00e35f5e48abd03baeeb377214f))
+- **cloneandsetup:** reuse local env values, never commit secrets ([#130](https://github.com/WeAreHausTech/haus-workflow/issues/130)) ([cf74a19](https://github.com/WeAreHausTech/haus-workflow/commit/cf74a196d369fbc59798de97e76bbcd3120155f7))
+- co-install suppression and recommender gates ([#134](https://github.com/WeAreHausTech/haus-workflow/issues/134)) ([4ca1f20](https://github.com/WeAreHausTech/haus-workflow/commit/4ca1f20a6b90645cd7007d195e6cc474558cc971))
+- curated source tools exempt from non-tsx npx ban and update archetype dependencies ([#132](https://github.com/WeAreHausTech/haus-workflow/issues/132)) ([a63d0b2](https://github.com/WeAreHausTech/haus-workflow/commit/a63d0b224ee9d1fd7b686b9aa3979562228f2333))
+- prune deprecated catalog items on apply/update ([#126](https://github.com/WeAreHausTech/haus-workflow/issues/126)) ([fdf6ecc](https://github.com/WeAreHausTech/haus-workflow/commit/fdf6ecc1d36f4eb090cdaa8d9b044381c5836c77))
+- stripe server gate [#139](https://github.com/WeAreHausTech/haus-workflow/issues/139) ([fb2dc35](https://github.com/WeAreHausTech/haus-workflow/commit/fb2dc35b0d332cdd6f3c7dcbaebef94dce06899c))
+
 ## [0.29.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.28.1...v0.29.0) (2026-06-17)
 
 ### Features

package/README.md

@@ -82,8 +82,10 @@ Content lives in [`haus-workflow-catalog`](https://github.com/WeAreHausTech/haus
 (version pinned in `library/catalog/manifest.json`). Fetched at runtime from the latest release tag (override with `HAUS_CATALOG_REF`; fallback `main` when no release tag resolves).
 Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
 
-On `haus apply` / `haus update`, items **removed from the catalog** are pruned from the
-project when their on-disk copy still matches the lock hash; user-edited copies are kept.
+On `haus apply` / `haus update`, items **removed from the catalog** or marked
+**deprecated** are pruned from the project when their on-disk copy still matches the
+lock hash; user-edited copies are kept. Approved items deselected via `--select` are
+not pruned.
 
 ## Internal docs
 

package/dist/cli.js

@@ -154,7 +154,7 @@ var validation_rules_default = {
   ],
   allowedNpxPattern: { source: "\\bnpx\\s+tsx\\b", flags: "i" },
   anyNpxPattern: { source: "\\bnpx\\s+\\S+", flags: "i" },
-  npxTsxOnlyExemptTypes: ["agent"],
+  npxTsxOnlyExemptSources: ["curated"],
   httpUrlPattern: { source: "^http:\\/\\/", flags: "i" },
   placeholderPattern: { source: "\\bTODO\\b|\\bPLACEHOLDER\\b", flags: "i" },
   allowedStacks: [
@@ -274,7 +274,29 @@ var REQUIRED_SKILL_FRONTMATTER = validation_rules_default.requiredSkillFrontmatt
 var RISKY_INSTALL_PATTERNS = validation_rules_default.riskyInstallPatterns.map(toRegExp);
 var ALLOWED_NPX_PATTERN = toRegExp(validation_rules_default.allowedNpxPattern);
 var ANY_NPX_PATTERN = toRegExp(validation_rules_default.anyNpxPattern);
-var NPX_TSX_ONLY_EXEMPT_TYPES = validation_rules_default.npxTsxOnlyExemptTypes ?? [];
+var NPX_TSX_ONLY_EXEMPT_SOURCES = validation_rules_default.npxTsxOnlyExemptSources ?? [];
+function isNpxTsxOnlyExempt(_itemType, itemSource) {
+  return Boolean(itemSource && NPX_TSX_ONLY_EXEMPT_SOURCES.includes(itemSource));
+}
+function buildItemPathSourceMap(items) {
+  const map = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    if (!item.path) continue;
+    map.set(String(item.path).replace(/\\/g, "/"), item.source);
+  }
+  return map;
+}
+function resolveMarkdownItemSource(relPath, pathSourceMap) {
+  const norm = relPath.replace(/\\/g, "/");
+  let cursor = norm;
+  while (true) {
+    if (pathSourceMap.has(cursor)) return pathSourceMap.get(cursor);
+    const slash = cursor.lastIndexOf("/");
+    if (slash === -1) break;
+    cursor = cursor.slice(0, slash);
+  }
+  return void 0;
+}
 var HTTP_URL_PATTERN = toRegExp(validation_rules_default.httpUrlPattern);
 var PLACEHOLDER_PATTERN = toRegExp(validation_rules_default.placeholderPattern);
 var ALLOWED_STACKS = validation_rules_default.allowedStacks;
@@ -353,7 +375,7 @@ ${extractUseWhenSection(text)}`;
 // src/catalog/ingest-catalog.ts
 function validateCatalogItem(item, content2) {
   const label = item.id;
-  const checkNonTsxNpx = !NPX_TSX_ONLY_EXEMPT_TYPES.includes(item.type);
+  const checkNonTsxNpx = !isNpxTsxOnlyExempt(item.type, item.source);
   const lines = content2.split(/\r?\n/);
   for (let i = 0; i < lines.length; i++) {
     const line2 = lines[i] ?? "";
@@ -803,7 +825,12 @@ async function syncDirectoryFromPrefix(item, catalogPrefix, destDir, base, opts)
     for (const file of fetched) {
       if (file.kind !== "text" || !isMarkdownPath(file.rel)) continue;
       const verdict = validateCatalogItem(
-        { id: item.id, type: "skill", path: catalogPrefix },
+        {
+          id: item.id,
+          type: "skill",
+          path: catalogPrefix,
+          ..."source" in item && item.source ? { source: item.source } : {}
+        },
         file.body
       );
       if (!verdict.ok) {
@@ -2291,7 +2318,7 @@ async function writeClaudeFiles(root, dryRun, selectedIds, opts = {}) {
       `${curatedReviewStatusSkips} curated items skipped: reviewStatus is not approved \u2014 possible catalog field rename upstream`
     );
   }
-  await cleanupStaleCatalogItems(root, new Set(manifestById.keys()), dryRun);
+  await cleanupStaleCatalogItems(root, manifestById, dryRun);
   if (dryRun) return [...new Set(files)];
   const installedItems = catalogItems.filter((r) => installedIds.has(r.id));
   const prevLock = await readJson(hausPath(root, "haus.lock.json"));
@@ -2328,11 +2355,15 @@ async function writeClaudeFiles(root, dryRun, selectedIds, opts = {}) {
   await writeManagedJson(root, hausPath(root, "haus.lock.json"), lock, false);
   return [...new Set(files)];
 }
-async function cleanupStaleCatalogItems(root, knownIds, dryRun) {
+async function cleanupStaleCatalogItems(root, manifestById, dryRun) {
   const prevLock = await readJson(hausPath(root, "haus.lock.json"));
   if (!prevLock?.length) return;
   for (const entry of prevLock) {
-    if (!entry.id || knownIds.has(entry.id)) continue;
+    if (!entry.id) continue;
+    const manifestItem = manifestById.get(entry.id);
+    const removedFromManifest = manifestItem === void 0;
+    const deprecated = manifestItem?.reviewStatus === "deprecated";
+    if (!removedFromManifest && !deprecated) continue;
     const relPaths = entry.paths ?? [];
     if (relPaths.length === 0) continue;
     const existing = [];
@@ -2340,28 +2371,29 @@ async function cleanupStaleCatalogItems(root, knownIds, dryRun) {
       if (await fs12.pathExists(path12.join(root, rel))) existing.push(rel);
     }
     if (existing.length === 0) continue;
+    const pruneReason = deprecated ? "deprecated" : "stale";
     if (entry.hash === void 0) {
       warn(
-        `Stale catalog item ${entry.id} has no lock hash \u2014 leaving in place: ${existing.join(", ")}`
+        `${deprecated ? "Deprecated" : "Stale"} catalog item ${entry.id} has no lock hash \u2014 leaving in place: ${existing.join(", ")}`
       );
       continue;
     }
     const currentHash = await hashInstalledPaths(root, relPaths);
     if (currentHash !== entry.hash) {
       warn(
-        `Stale catalog item ${entry.id} was modified locally \u2014 leaving in place: ${existing.join(", ")}`
+        `${deprecated ? "Deprecated" : "Stale"} catalog item ${entry.id} was modified locally \u2014 leaving in place: ${existing.join(", ")}`
       );
       continue;
     }
     for (const rel of existing) {
       const abs = path12.join(root, rel);
       if (dryRun) {
-        log(`[dry-run] would remove stale ${displayPath(root, abs)} (${entry.id})`);
+        log(`[dry-run] would remove ${pruneReason} ${displayPath(root, abs)} (${entry.id})`);
         continue;
       }
       await fs12.remove(abs);
       await pruneEmptyDir(path12.dirname(abs));
-      log(`Removed stale ${displayPath(root, abs)} (${entry.id})`);
+      log(`Removed ${pruneReason} ${displayPath(root, abs)} (${entry.id})`);
     }
   }
 }
@@ -2371,6 +2403,9 @@ async function cacheHasItems() {
   const data = await readJson(path13.join(getCacheDir(), "manifest.json"));
   return Array.isArray(data?.items) && data.items.length > 0;
 }
+function installableRecommendedItems(recommended) {
+  return recommended.filter((item) => item.install !== false);
+}
 async function runApply(options) {
   if (!options.dryRun && !options.write) {
     log("Use --dry-run or --write");
@@ -2389,28 +2424,31 @@ async function runApply(options) {
     if (!rec) {
       log("No recommendation.json found \u2014 run `haus recommend` first. Writing core files only.");
       selectedIds = [];
-    } else if (rec.recommended.length === 0) {
-      log("Recommendation contains no catalog items. Writing core files only.");
-      selectedIds = [];
     } else {
-      const items = rec.recommended;
-      const choices = items.map((item) => ({
-        name: `${item.id}  [${item.selectionMode}] \u2014 ${item.reason}`,
-        value: item.id,
-        checked: true
-      }));
-      const chosen = await checkbox({
-        message: "Select catalog items to apply (space to toggle, enter to confirm):",
-        choices,
-        pageSize: Math.min(20, items.length + 2)
-      });
-      selectedIds = chosen;
-      log(`Selected ${selectedIds.length} of ${items.length} catalog items.`);
+      const items = installableRecommendedItems(rec.recommended);
+      if (items.length === 0) {
+        log("Recommendation contains no catalog items. Writing core files only.");
+        selectedIds = [];
+      } else {
+        const choices = items.map((item) => ({
+          name: `${item.id}  [${item.selectionMode}] \u2014 ${item.reason}`,
+          value: item.id,
+          checked: true
+        }));
+        const chosen = await checkbox({
+          message: "Select catalog items to apply (space to toggle, enter to confirm):",
+          choices,
+          pageSize: Math.min(20, items.length + 2)
+        });
+        selectedIds = chosen;
+        log(`Selected ${selectedIds.length} of ${items.length} catalog items.`);
+      }
     }
   }
   if (!options.allowEmptyCache && !process.env["HAUS_FIXTURE_CATALOG"]) {
     const rec = await readJson(hausPath(root, "recommendation.json"));
-    const catalogItemCount = selectedIds !== void 0 ? selectedIds.length : rec?.recommended.length ?? 0;
+    const installableRecommended = installableRecommendedItems(rec?.recommended ?? []);
+    const catalogItemCount = selectedIds !== void 0 ? selectedIds.length : installableRecommended.length;
     if (catalogItemCount > 0 && !await cacheHasItems()) {
       const message = "No catalog content found. Run `haus update` first.";
       if (isDryRun) {
@@ -2705,7 +2743,7 @@ var STACK_RULES = [
   { stack: ["tooling", "missing-eslint"], any: [depAbsent("eslint")] },
   {
     stack: ["tooling", "stripe"],
-    any: [dep("@stripe/stripe-js"), dep("@stripe/react-stripe-js")]
+    any: [dep("stripe"), dep("@stripe/stripe-js"), dep("@stripe/react-stripe-js")]
   },
   { stack: ["tooling", "qliro"], any: [dep("@haus-tech/qliro-plugin")] },
   {
@@ -3543,15 +3581,6 @@ async function recommend(root, context) {
       skip(item.id, "unsupported-policy", "Unsupported stack policy");
       continue;
     }
-    if (item.type === "config") {
-      skip(
-        item.id,
-        "config-scaffold-only",
-        "Config item \u2014 install with `haus scaffold`",
-        "type:config"
-      );
-      continue;
-    }
     if (item.reviewStatus === "deprecated") {
       skip(item.id, "deprecated", "Catalog item is deprecated", "reviewStatus:deprecated");
       continue;
@@ -3608,6 +3637,19 @@ async function recommend(root, context) {
       );
       continue;
     }
+    if (item.id === "haus.ecc-database-reviewer" && !roleSet.has("database")) {
+      skip(item.id, "required-role-missing", "Required role missing: database", "role:database");
+      continue;
+    }
+    if (item.id === "haus.ecc-typescript-reviewer" && (stackSet.has("react") || stackSet.has("react19") || stackSet.has("nextjs") || stackSet.has("next") || roleSet.has("react-app") || roleSet.has("next-app"))) {
+      skip(
+        item.id,
+        "co-install-react-reviewer",
+        "Skip typescript-reviewer on React/Next stacks (use react-reviewer)",
+        "stack:react|nextjs|role:react-app|next-app"
+      );
+      continue;
+    }
     const isDefaultBaseline = item.default === true;
     const reasons = [];
     const push = (code, message, signal) => reasons.push({ code, message, signal });
@@ -3652,13 +3694,22 @@ async function recommend(root, context) {
     }
     const hasEvidence = reasons.some((r) => r.code !== "default-baseline");
     if (isDefaultBaseline || hasEvidence) {
+      const isConfig = item.type === "config";
+      const entryReasons = isConfig ? [
+        ...reasons,
+        {
+          code: "config-scaffold",
+          message: "Install with `haus scaffold`",
+          signal: "type:config"
+        }
+      ] : reasons;
       recommended.push({
         id: item.id,
         type: item.type,
-        reason: reasons.length ? reasons.map((x) => x.message).join(", ") : "eligible",
-        reasons,
+        reason: entryReasons.length ? entryReasons.map((x) => x.message).join(", ") : "eligible",
+        reasons: entryReasons,
         selectionMode: isDefaultBaseline && !hasEvidence ? "baseline" : "matched",
-        install: true,
+        install: !isConfig,
         tags: item.tags,
         ecosystem: item.ecosystem,
         tokenEstimate: item.tokenEstimate
@@ -3667,9 +3718,11 @@ async function recommend(root, context) {
       skip(item.id, "no-role-stack-match", "No role/stack match");
     }
   }
+  applyCoInstallSuppression(recommended, skipped);
   recommended.sort((a, b) => a.id.localeCompare(b.id));
   skipped.sort((a, b) => a.id.localeCompare(b.id));
-  const selectedRules = recommended.length;
+  const installableRecommended = recommended.filter((item) => item.install);
+  const selectedRules = installableRecommended.length;
   const skippedRules = skipped.length;
   const estimatedContextTokens = estimateContextTokens(selectedRules);
   const estimatedTokenReductionPct = tokenReductionPct(selectedRules, skippedRules);
@@ -3690,6 +3743,78 @@ function buildStackSet(context) {
     )
   );
 }
+function applyCoInstallSuppression(recommended, skipped) {
+  const recommendedIds = new Set(recommended.map((r) => r.id));
+  const rules = [
+    {
+      suppress: "haus.sentry-sentry-workflow",
+      whenAnyRecommended: [
+        "haus.sentry-sentry-php-sdk",
+        "haus.sentry-sentry-nextjs-sdk",
+        "haus.sentry-sentry-node-sdk",
+        "haus.sentry-sentry-nestjs-sdk"
+      ],
+      code: "co-install-sentry-sdk",
+      message: "Skip sentry-workflow when a stack-specific Sentry SDK skill is selected",
+      signal: "co-install:sentry-sdk"
+    },
+    {
+      suppress: "haus.ecc-e2e-runner",
+      whenAnyRecommended: ["haus.ecc-e2e-testing"],
+      code: "co-install-e2e-skill",
+      message: "Skip e2e-runner when e2e-testing skill covers patterns",
+      signal: "co-install:e2e-testing"
+    },
+    {
+      suppress: "haus.oh-my-claudecode-test-engineer",
+      whenAnyRecommended: ["haus.ecc-e2e-testing", "haus.ecc-e2e-runner"],
+      code: "co-install-e2e-coverage",
+      message: "Skip oh-my test-engineer when ECC e2e skill or agent is selected",
+      signal: "co-install:e2e-coverage"
+    },
+    {
+      suppress: "haus.wshobson-js-testing-patterns",
+      whenAnyRecommended: ["haus.ecc-react-testing"],
+      code: "co-install-react-testing",
+      message: "Skip js-testing-patterns when ecc-react-testing covers component tests",
+      signal: "co-install:react-testing"
+    },
+    {
+      suppress: "haus.superpowers-test-driven-development",
+      whenAnyRecommended: ["haus.wshobson-js-testing-patterns", "haus.ecc-react-testing"],
+      code: "co-install-stack-testing",
+      message: "Skip TDD superpower when a stack testing skill is selected",
+      signal: "co-install:stack-testing"
+    },
+    {
+      suppress: "haus.superpowers-specifying-gates",
+      whenAnyRecommended: ["haus.superpowers-checking-gates"],
+      code: "co-install-gate-workflow",
+      message: "Skip specifying-gates when checking-gates is selected",
+      signal: "co-install:checking-gates"
+    },
+    {
+      suppress: "haus.ecc-redis-patterns",
+      whenAnyRecommended: ["haus.redis-redis-connections"],
+      code: "co-install-redis-official",
+      message: "Skip ecc-redis-patterns when official redis-connections skill is selected",
+      signal: "co-install:redis-connections"
+    }
+  ];
+  for (const rule of rules) {
+    if (!recommendedIds.has(rule.suppress)) continue;
+    if (!rule.whenAnyRecommended.some((id) => recommendedIds.has(id))) continue;
+    const idx = recommended.findIndex((r) => r.id === rule.suppress);
+    if (idx === -1) continue;
+    const [removed] = recommended.splice(idx, 1);
+    recommendedIds.delete(rule.suppress);
+    skipped.push({
+      id: removed.id,
+      reason: rule.message,
+      skipReasons: [{ code: rule.code, message: rule.message, signal: rule.signal }]
+    });
+  }
+}
 
 // src/commands/setup-core.ts
 async function runSetupCore(root, opts) {
@@ -4903,15 +5028,19 @@ function walkMd(dir, fn) {
     else if (entry.name.endsWith(".md")) fn(full);
   }
 }
-function auditMarkdownContent(manifestDir) {
+function auditMarkdownContent(manifestDir, items) {
   const failures = [];
+  const pathSourceMap = buildItemPathSourceMap(items);
   for (const dir of ["skills", "agents", "templates", "commands"]) {
     const abs = path27.join(manifestDir, dir);
     if (!fs21.existsSync(abs)) continue;
-    const checkNonTsxNpx = !NPX_TSX_ONLY_EXEMPT_TYPES.includes(DIR_ITEM_TYPE[dir] ?? "");
+    const dirType = DIR_ITEM_TYPE[dir] ?? "";
     walkMd(abs, (file) => {
       const text = fs21.readFileSync(file, "utf8");
       const rel = path27.relative(manifestDir, file);
+      const norm = rel.replace(/\\/g, "/");
+      const source = resolveMarkdownItemSource(norm, pathSourceMap);
+      const checkNonTsxNpx = !isNpxTsxOnlyExempt(dirType, source);
       const lines = text.split(/\r?\n/);
       for (let i = 0; i < lines.length; i++) {
         const line2 = lines[i] ?? "";
@@ -4921,7 +5050,7 @@ function auditMarkdownContent(manifestDir) {
           failures.push(`${rel}:${i + 1}: disallowed npx (only npx tsx allowed)`);
         }
       }
-      if (!rel.includes("/references/")) failures.push(...auditForbiddenTagsInText(text, rel));
+      if (!norm.includes("/references/")) failures.push(...auditForbiddenTagsInText(text, rel));
     });
   }
   return failures;
@@ -4931,7 +5060,7 @@ function validateCatalogData(manifestDir, manifestVersion, items) {
     ...auditManifestStructure(manifestVersion, items),
     ...auditForbiddenStacks(items),
     ...auditShippedFiles(manifestDir, items),
-    ...auditMarkdownContent(manifestDir),
+    ...auditMarkdownContent(manifestDir, items),
     ...auditDisallowedTags(items)
   ];
   return { ok: failures.length === 0, failures, items };