@haus-tech/haus-workflow 6.8.0 → 7.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +27 -0
- package/README.md +41 -85
- package/dist/cli.js +25386 -33982
- package/docs/before-you-start.md +17 -22
- package/docs/glossary.md +10 -8
- package/package.json +1 -6
- package/packages/agents/issue-creator.md +3 -5
- package/packages/skills/adr-decisions/SKILL.md +8 -9
- package/packages/skills/bullmq-patterns/SKILL.md +1 -11
- package/packages/skills/haus-workflow/SKILL.md +28 -41
- package/packages/skills/haus-workflow/references/init.md +38 -69
- package/packages/skills/haus-workflow/references/new.md +15 -20
- package/packages/skills/i18next-patterns/SKILL.md +1 -11
- package/packages/skills/issue-authoring/SKILL.md +18 -25
- package/packages/skills/laravel-nova-patterns/SKILL.md +1 -11
- package/packages/skills/strapi-patterns/SKILL.md +1 -11
- package/packages/skills/vendure-app-patterns/SKILL.md +1 -11
- package/packages/skills/vendure-plugin-patterns/SKILL.md +1 -11
- package/packages/skills/whats-installed/SKILL.md +10 -8
- package/packages/skills/writing-documentation/SKILL.md +2 -10
- package/packages/templates/agentic-workflow-standard.md +15 -5
- package/packages/templates/decisions-ci-gate.yml +1 -1
- package/packages/templates/lefthook-lighthouse.yml +2 -2
- package/library/catalog/decisions-triggers.json +0 -26
- package/library/catalog/haus-lock.schema.json +0 -4
- package/library/catalog/manifest.json +0 -5941
- package/library/catalog/validation-rules.json +0 -169
- package/library/global/settings-fragments/hooks.json +0 -53
- package/scripts/postinstall.mjs +0 -62
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [7.1.0](https://github.com/WeAreHausTech/haus-workflow/compare/v7.0.0...v7.1.0) (2026-10-27)
|
|
4
|
+
|
|
5
|
+
### Features
|
|
6
|
+
|
|
7
|
+
- **apply:** write haus.json in a project with none, one layout left ([#940](https://github.com/WeAreHausTech/haus-workflow/issues/940)) ([5dc3be5](https://github.com/WeAreHausTech/haus-workflow/commit/5dc3be5c02cbe9cc1de8836366d618146095ff9a))
|
|
8
|
+
|
|
9
|
+
## [7.0.0](https://github.com/WeAreHausTech/haus-workflow/compare/v6.8.0...v7.0.0) (2026-10-26)
|
|
10
|
+
|
|
11
|
+
### ⚠ BREAKING CHANGES
|
|
12
|
+
|
|
13
|
+
- **sync:** removes haus configs, workspace link-context, global plugins, the catalog commands and the recommender (haus recommend is a no-op stub). haus install drops --force, --check, --postinstall, --internal and --no-internal, and the npm postinstall step is gone. HAUS_INTERNAL_CHANNEL, HAUS_NO_POSTINSTALL and HAUS_DEBUG are ignored. backups restore --json drops kept and records. Templates and configs in packages/ are copied by hand.
|
|
14
|
+
|
|
15
|
+
[adr-skip] implements ADR-0190 and ADR-0191, no new decision
|
|
16
|
+
|
|
17
|
+
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
|
18
|
+
Claude-Session: https://claude.ai/code/session_01HD37gCdJYcuy7sZdj6gnAX
|
|
19
|
+
|
|
20
|
+
### Features
|
|
21
|
+
|
|
22
|
+
- **release:** haus release start, merge, status, ship, tag and deploy ([#926](https://github.com/WeAreHausTech/haus-workflow/issues/926)) ([63a950d](https://github.com/WeAreHausTech/haus-workflow/commit/63a950df237de6298e35af91fdb3933083536c9c))
|
|
23
|
+
- **release:** release init and suite commands, guard closures and docs for the release model ([#934](https://github.com/WeAreHausTech/haus-workflow/issues/934)) ([df34f82](https://github.com/WeAreHausTech/haus-workflow/commit/df34f82e88c4ece85c8a0d4d34df9e610a106d2b)), closes [#909](https://github.com/WeAreHausTech/haus-workflow/issues/909)
|
|
24
|
+
- **sync:** remove copy-install, catalog pipeline and machine-wide installs ([#936](https://github.com/WeAreHausTech/haus-workflow/issues/936)) ([94e104f](https://github.com/WeAreHausTech/haus-workflow/commit/94e104f1d0c4c818d288369098f9df285cc6a477))
|
|
25
|
+
|
|
26
|
+
### Bug Fixes
|
|
27
|
+
|
|
28
|
+
- **sync:** adopt identical copies and untrack synced paths ([#930](https://github.com/WeAreHausTech/haus-workflow/issues/930)) ([e8168a6](https://github.com/WeAreHausTech/haus-workflow/commit/e8168a6d1ab80437ecd485b63b98deaa7589f96e))
|
|
29
|
+
|
|
3
30
|
## [6.8.0](https://github.com/WeAreHausTech/haus-workflow/compare/v6.7.1...v6.8.0) (2026-10-26)
|
|
4
31
|
|
|
5
32
|
### Features
|
package/README.md
CHANGED
|
@@ -20,11 +20,9 @@ npm install -g @haus-tech/haus-workflow
|
|
|
20
20
|
Install the haus-workflow CLI globally by running `npm install -g @haus-tech/haus-workflow`.
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
It is non-fatal, idempotent, and global-only. Skip it with `HAUS_NO_POSTINSTALL=1`;
|
|
27
|
-
re-run or repair any time with `haus install`. Undo with `haus uninstall`.
|
|
23
|
+
haus writes nothing to `~/.claude/` on install: skills, agents, hooks and superpowers come
|
|
24
|
+
from `haus sync` in each project. `haus install --session-labels` adds the one opt-in
|
|
25
|
+
user-level hook, and `haus uninstall` removes what an older haus put in `~/.claude/`.
|
|
28
26
|
|
|
29
27
|
---
|
|
30
28
|
|
|
@@ -34,7 +32,7 @@ Once installed, Claude Code gains a `/haus-workflow` slash command.
|
|
|
34
32
|
|
|
35
33
|
Task names are plain verbs; each detects its own scope (a single haus-set-up repo, a
|
|
36
34
|
multi-repo workspace, or neither) before acting. `refresh` also updates this machine's
|
|
37
|
-
haus install (
|
|
35
|
+
haus install (npm) first; `uninstall` acts ONLY on the machine, never on a
|
|
38
36
|
repo. Every old `project:`-prefixed name (and other legacy aliases like `setup`, `fix`,
|
|
39
37
|
`add-skills`) still works as an alias into the task it merged into.
|
|
40
38
|
|
|
@@ -44,7 +42,7 @@ repo. Every old `project:`-prefixed name (and other legacy aliases like `setup`,
|
|
|
44
42
|
/haus-workflow clone [name] # clone one repo by name, or a whole workspace (repos.manifest.json); offers local-dev setup after
|
|
45
43
|
/haus-workflow new [description] # create a brand-new project from a plain-language request
|
|
46
44
|
/haus-workflow doctor # health check for this project or workspace; offers to apply suggested fixes
|
|
47
|
-
/haus-workflow refresh # update haus itself (package
|
|
45
|
+
/haus-workflow refresh # update haus itself (npm package and core files), then fully sync this project or just add packages
|
|
48
46
|
/haus-workflow uninstall # remove haus global files from ~/.claude — never touches this project
|
|
49
47
|
```
|
|
50
48
|
|
|
@@ -55,23 +53,23 @@ Without an argument, the skill presents a menu so you can pick the task. With an
|
|
|
55
53
|
## Commands
|
|
56
54
|
|
|
57
55
|
```bash
|
|
58
|
-
haus init # full setup: scan
|
|
56
|
+
haus init # full setup: scan, write haus.json and the core files (safe to re-run)
|
|
59
57
|
haus init --dry-run # preview the .claude/ write only; scan artifacts are still written
|
|
60
|
-
haus
|
|
58
|
+
haus init --packages software-engineering,web-react # set the packages haus.json names
|
|
59
|
+
haus sync # pull the packages haus.json names into .claude/, pinned to its release
|
|
60
|
+
haus clone <url> [dir] # clone a single git repo by URL (the primitive the clone task loops over)
|
|
61
61
|
haus scan # scan repo and write context-map
|
|
62
|
-
haus
|
|
63
|
-
haus apply --
|
|
64
|
-
haus apply --write # write .claude/ files (skills, agents, commands, templates)
|
|
65
|
-
haus apply --select # interactively choose which recommended items to install
|
|
62
|
+
haus apply --dry-run # preview the core files apply would write
|
|
63
|
+
haus apply --write # write the core files (settings, hooks, CLAUDE.md and AGENTS.md blocks, WORKFLOW.md)
|
|
66
64
|
haus apply --refill-config # fill still-blank workflow-config.md fields, keep edits
|
|
67
|
-
haus update # check npm for new CLI
|
|
68
|
-
haus update --check #
|
|
69
|
-
haus undo # remove haus-managed project files (
|
|
70
|
-
haus doctor # health check: hooks, CLAUDE.md, imports,
|
|
65
|
+
haus update # check npm for a new CLI and re-apply this project's core files
|
|
66
|
+
haus update --check # report whether the synced files follow haus.json
|
|
67
|
+
haus undo # remove haus-managed project files (core files; synced folders stay)
|
|
68
|
+
haus doctor # health check: hooks, CLAUDE.md, imports, haus sync state, CLI version
|
|
71
69
|
haus guard bash|file-access # security guard hook; invoked by PreToolUse
|
|
72
70
|
haus pr wait <n> # wait for a PR to merge after gh pr merge --auto; updates a branch that falls behind
|
|
73
71
|
haus workspace # multi-repo ops: discover, scan, setup, doctor across a workspace
|
|
74
|
-
haus uninstall # remove
|
|
72
|
+
haus uninstall # remove what an older haus put in ~/.claude/
|
|
75
73
|
```
|
|
76
74
|
|
|
77
75
|
> Cross-session learnings use Claude Code's **native memory** (`MEMORY.md`); haus
|
|
@@ -79,77 +77,35 @@ haus uninstall # remove Haus-managed files from ~/.claude/
|
|
|
79
77
|
|
|
80
78
|
---
|
|
81
79
|
|
|
82
|
-
##
|
|
83
|
-
|
|
84
|
-
Content lives in [`haus-workflow-catalog`](https://github.com/WeAreHausTech/haus-workflow-catalog)
|
|
85
|
-
(version pinned in `library/catalog/manifest.json`). Fetched at runtime from the latest
|
|
86
|
-
release tag. Ref precedence: `HAUS_CATALOG_REF` env → a project's
|
|
87
|
-
`.haus-workflow/haus.config.json#catalogRef` pin → latest release tag → bundled snapshot
|
|
88
|
-
→ `main`. **The bundled snapshot is metadata only — it has no item content to install**
|
|
89
|
-
(see "Offline and air-gapped use" below); it exists so the CLI still has a manifest to
|
|
90
|
-
read with no network access, not as a usable install source.
|
|
91
|
-
Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
|
|
92
|
-
|
|
93
|
-
Items install by **flattening** (`skill`, `agent`, `template`, `command` — basename only)
|
|
94
|
-
or by **mirroring** their upstream path under `sources/<slug>/` (`rule`, `asset` — so
|
|
95
|
-
`.claude/rules/react/hooks.md` lands where the curated prose that references it expects).
|
|
96
|
-
See [ADR-0046](docs/decisions/0046-manifest-format-2-install-contract.md).
|
|
97
|
-
|
|
98
|
-
On `haus apply` / `haus update`, items **removed from the catalog** or marked
|
|
99
|
-
**deprecated** are pruned from the project when their on-disk copy still matches the
|
|
100
|
-
lock hash; user-edited copies are kept, lock entry and all. Every lock-tracked catalog item
|
|
101
|
-
haus deletes is snapshotted under `.haus-workflow/backups/` first and can be put back with
|
|
102
|
-
`haus backups restore` (`haus undo` also strips haus's parts of `.claude/settings.json` and
|
|
103
|
-
the root `CLAUDE.md` and removes `.claude/rules/haus.md` when haus owns it; its `undo-`
|
|
104
|
-
snapshot covers those too, and it keeps the lock rows of the edited items it leaves behind,
|
|
105
|
-
see [docs/cli.md](docs/cli.md) → `haus undo`). Approved items deselected via
|
|
106
|
-
`--select` are not pruned.
|
|
107
|
-
|
|
108
|
-
> **Upgrading from a pre-`0.30.0` CLI:** deprecated-skill pruning shipped in `0.30.0`.
|
|
109
|
-
> If an older CLI left deprecated skills on disk, upgrade first
|
|
110
|
-
> (`npm i -g @haus-tech/haus-workflow`) then run `haus update` to prune them.
|
|
111
|
-
|
|
112
|
-
> **Upgrading to `2.0.0`:** see [docs/upgrading-2.0.md](docs/upgrading-2.0.md). It carries
|
|
113
|
-
> the rollout order (CLI first, catalog second), the two renamed skill directories, what
|
|
114
|
-
> `.claude/rules/` now contains, and how to pin to a format-1 catalog to defer.
|
|
115
|
-
|
|
116
|
-
### Offline and air-gapped use
|
|
117
|
-
|
|
118
|
-
The npm package ships catalog **metadata** only — the manifest, validation rules, ADR
|
|
119
|
-
triggers and the lock schema. It does not contain any catalog item content. A machine with
|
|
120
|
-
no populated cache can write core files (`CLAUDE.md`, `settings.json`, `WORKFLOW.md`) but
|
|
121
|
-
cannot install skills, agents, or rules until it has real content — from a network sync
|
|
122
|
-
or an imported bundle (see [ADR-0060](docs/decisions/0060-offline-catalog-honesty.md)).
|
|
123
|
-
|
|
124
|
-
To set up a disconnected machine:
|
|
80
|
+
## Packages
|
|
125
81
|
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
82
|
+
Shipped content (skills, agents, templates, configs) lives in [`packages/`](packages/) in
|
|
83
|
+
this repo, grouped into packages in [`packages/packages.yaml`](packages/packages.yaml)
|
|
84
|
+
(ADR-0191). Some packages also name upstream content by pinned commit: superpowers by tag,
|
|
85
|
+
a few Matt Pocock skills and ECC agents.
|
|
86
|
+
|
|
87
|
+
A project commits one file, `haus.json`, naming a haus release and its packages:
|
|
130
88
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
haus apply --write --offline
|
|
89
|
+
```json
|
|
90
|
+
{ "release": "7.0.0", "packages": ["software-engineering", "web-react"] }
|
|
134
91
|
```
|
|
135
92
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
`haus
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
the
|
|
151
|
-
|
|
152
|
-
exact flags and behaviour.
|
|
93
|
+
`haus sync` reads it, pulls `packages.yaml` at tag `v<release>` and the content it names from
|
|
94
|
+
git into a mirror cache (`~/.cache/haus`, or `HAUS_CACHE_DIR`), and writes the package folders
|
|
95
|
+
into `.claude/skills/` and `.claude/agents/`. Those folders are listed in the git exclude
|
|
96
|
+
file, never committed, and recorded in `.haus-workflow/synced.json`, so the next sync replaces
|
|
97
|
+
or removes only what it wrote (ADR-0190, ADR-0151). Lefthook runs `haus sync` after checkout,
|
|
98
|
+
merge and rebase, and a SessionStart hook syncs from the cache, so `.claude/` follows
|
|
99
|
+
`haus.json` without a hand run. A project from before haus sync keeps its old
|
|
100
|
+
`haus.lock.json` until its first `haus sync`, which retires it.
|
|
101
|
+
|
|
102
|
+
### Offline use
|
|
103
|
+
|
|
104
|
+
Pass `--offline` (or set `HAUS_OFFLINE=1`) to skip the network legs up front: `haus sync` and
|
|
105
|
+
the worktree hydration read the mirror cache only, and the npm version check is skipped. A
|
|
106
|
+
machine whose cache already holds the pinned commits syncs offline; one without them reports
|
|
107
|
+
the commit that is not in the local mirror and writes nothing. See [docs/cli.md](docs/cli.md) for
|
|
108
|
+
each command's exact flags and behaviour.
|
|
153
109
|
|
|
154
110
|
## Internal docs
|
|
155
111
|
|