@haus-tech/haus-workflow 5.10.1 → 5.12.0

package/library/global/skills/haus-workflow/SKILL.md

@@ -164,7 +164,13 @@ Bring haus current. Global half always runs; the project half depends on scope.
      `optInGroup` (purpose + tokenEstimate as plain language) and `recommended[]`
      config entries with `install: false` whose files aren't present. One
      multi-select `AskUserQuestion`, all unchecked. Then one single
-     `haus recommend --include <id> <id> …` with every chosen id followed by
+     `haus recommend --declare-role <role> <role> …` with the common role of each
+     chosen group that has one, passed as the name after `role=` (every entry's
+     `requires` names only roles, `role=<name>`, and the same role first; a
+     declared role also admits the shared helpers listed under other groups),
+     then one single
+     `haus recommend --include <id> <id> …` with the ids of the chosen groups that
+     have none (skip a command with nothing to pass), followed by
      `haus apply --write`; configs via `haus configs <id>` (`--force` only if the
      user chose to replace an existing file). Nothing eligible → say so and stop.
      Reached directly by the `add-skills`/`opt-in` aliases. In workspace scope, ask

package/library/global/skills/haus-workflow/references/init.md

@@ -41,10 +41,19 @@ Do this in order:
      `optInGroup` label and present one `AskUserQuestion` option per group
      (use each item's `purpose` and `tokenEstimate` to describe it in plain
      language, e.g. "Code review workflow — request/receive structured reviews").
-     Collect the item ids from **all** the groups the user picked into one list
-     and run a **single** `haus recommend --include <id> <id> …` (one command with
-     every chosen id). Don't run it once per group — each run rewrites
-     `recommendation.json`, so repeated calls would drop the earlier includes.
+     Opt the user in by role wherever a group has one. A chosen group has a
+     common role when every entry's `requires` names only roles (`role=<name>`,
+     several joined by `|` when a helper serves more than one group) and all
+     its entries name the same role first. Collect each common role as the name
+     after `role=` (`interview-workflow`, not `role=interview-workflow`) and run a
+     **single** `haus recommend --declare-role <role> <role> …` with all of them:
+     haus records them in `.haus-workflow/haus.config.json`, and a declared role
+     also admits the shared helpers listed under other groups, which the group's
+     own ids would miss. Then, only for chosen groups with no common role (a
+     `requires` that names a stack or a dependency, or entries whose first roles
+     differ), run a **single** `haus recommend --include <id> <id> …` with all of
+     their ids. Skip a command that has nothing to pass, and never run either
+     once per group: each run re-scores the whole catalog.
    - **Project config** (entries in `recommended[]` with `install: false`, e.g.
      Haus ESLint / Prettier baselines): offer each as a plain choice ("Add the
      Haus ESLint baseline"). On confirm, run `haus configs <id>`. `haus configs`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "5.10.1",
+  "version": "5.12.0",
   "description": "Haus AI workflow CLI for Claude Code.",
   "type": "module",
   "bin": {