@haus-tech/haus-workflow 1.6.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [2.0.0](https://github.com/WeAreHausTech/haus-workflow/compare/v1.7.0...v2.0.0) (2026-08-17)
+
+### Features
+
+- **catalog:** durable per-project catalog ref pin ([a5317ee](https://github.com/WeAreHausTech/haus-workflow/commit/a5317eec9aa85f167ea869d47353e839fb8bab98))
+- **catalog:** gate catalog installs on manifestFormat ([fa2625d](https://github.com/WeAreHausTech/haus-workflow/commit/fa2625d1e064fcf2bd3b83eae761853d4ba3ccb3))
+- **catalog:** install a curated skill's declared dependencies, without running its scripts ([ae98119](https://github.com/WeAreHausTech/haus-workflow/commit/ae9811920951047401b12043f9196e3def899260))
+- **catalog:** install rule and asset items by mirroring their upstream path ([5735329](https://github.com/WeAreHausTech/haus-workflow/commit/5735329179851fb239d8d53d26e30a2af8bbf702))
+- **catalog:** pin the lifecycle of mirrored rule items, and stop them clobbering core output ([652f3e7](https://github.com/WeAreHausTech/haus-workflow/commit/652f3e7df6095b131df2501481fafe1fe310871b))
+- **catalog:** ship the format-2 snapshot, and close the validator drift it exposed ([6a6cc2b](https://github.com/WeAreHausTech/haus-workflow/commit/6a6cc2beb89e55c0af10fe37e3e2e5f88c8236ca))
+- **doctor:** report catalog renames, and stop a too-new catalog silencing the report ([b85bfed](https://github.com/WeAreHausTech/haus-workflow/commit/b85bfed556fbf34c552516d376df007e36e6f3b1))
+
+### Bug Fixes
+
+- **catalog:** drop dead backslash normalisation, render the config-dir label posix ([9004bbf](https://github.com/WeAreHausTech/haus-workflow/commit/9004bbf8a088702f751b53a15f39078cca3a4313))
+- **catalog:** honour the format refusal in update, and bind the cache to its ref ([74f8c43](https://github.com/WeAreHausTech/haus-workflow/commit/74f8c431fbdbfcd4e3db5214bf8598feb5673d0c)), closes [#285](https://github.com/WeAreHausTech/haus-workflow/issues/285) [#239](https://github.com/WeAreHausTech/haus-workflow/issues/239)
+- **catalog:** round-trip manifestFormat through the catalog cache ([82e82c5](https://github.com/WeAreHausTech/haus-workflow/commit/82e82c5022f09cb85762c139d8448bbfb92a8292))
+- **doctor,install:** stop two paths that delete files haus said it would keep ([a1e500b](https://github.com/WeAreHausTech/haus-workflow/commit/a1e500b09a4e14cb33cb622cb51ff724785a04c5)), closes [#285](https://github.com/WeAreHausTech/haus-workflow/issues/285)
+- **hooks:** stop the format hook skipping .js ([#287](https://github.com/WeAreHausTech/haus-workflow/issues/287)) ([0dbaefb](https://github.com/WeAreHausTech/haus-workflow/commit/0dbaefb2a5c3ce00103db6242a02693ece27798c))
+- **install:** resolve the global install through CLAUDE_CONFIG_DIR ([#278](https://github.com/WeAreHausTech/haus-workflow/issues/278)) ([046828e](https://github.com/WeAreHausTech/haus-workflow/commit/046828e395e10bdf9edfa0644de4f41e56d38cc2))
+- **scanner:** let doctor survive a too-new catalog on an unscanned project ([e4ccc00](https://github.com/WeAreHausTech/haus-workflow/commit/e4ccc00ed92514d334fe20f61a14b1bdb647f780))
+
+## [1.7.0](https://github.com/WeAreHausTech/haus-workflow/compare/v1.6.0...v1.7.0) (2026-08-13)
+
+### Features
+
+- **cli:** --dry-run on destructive commands; doctor states what --force discards ([#283](https://github.com/WeAreHausTech/haus-workflow/issues/283)) ([35dfe55](https://github.com/WeAreHausTech/haus-workflow/commit/35dfe553e8282011d365492a3168fee7aee819b4)), closes [#237](https://github.com/WeAreHausTech/haus-workflow/issues/237) [#248](https://github.com/WeAreHausTech/haus-workflow/issues/248)
+- **cli:** add --json to workspace worktree and backups subcommands ([#280](https://github.com/WeAreHausTech/haus-workflow/issues/280)) ([bf1f7b2](https://github.com/WeAreHausTech/haus-workflow/commit/bf1f7b219432ee7cf2dfe6a70e8ae74ab8963b46)), closes [#235](https://github.com/WeAreHausTech/haus-workflow/issues/235) [#236](https://github.com/WeAreHausTech/haus-workflow/issues/236)
+- **cli:** doctor --json and explain-recommendation hint in recommend output ([#281](https://github.com/WeAreHausTech/haus-workflow/issues/281)) ([12fa8ff](https://github.com/WeAreHausTech/haus-workflow/commit/12fa8ff3723a07b735529cfdb32e193302a90bc2)), closes [#234](https://github.com/WeAreHausTech/haus-workflow/issues/234) [#234](https://github.com/WeAreHausTech/haus-workflow/issues/234) [#247](https://github.com/WeAreHausTech/haus-workflow/issues/247)
+- **cli:** upgrade visibility — release notes on update, lingering deprecated-item detection in doctor ([#284](https://github.com/WeAreHausTech/haus-workflow/issues/284)) ([e8d0c04](https://github.com/WeAreHausTech/haus-workflow/commit/e8d0c04b2e7d457cc0e4ea20f18a55fd4d8ee394)), closes [#242](https://github.com/WeAreHausTech/haus-workflow/issues/242) [#251](https://github.com/WeAreHausTech/haus-workflow/issues/251)
+
 ## [1.6.0](https://github.com/WeAreHausTech/haus-workflow/compare/v1.5.8...v1.6.0) (2026-08-13)
 
 ### Features

package/README.md

@@ -83,9 +83,17 @@ haus uninstall                # remove Haus-managed files from ~/.claude/
 ## Catalog
 
 Content lives in [`haus-workflow-catalog`](https://github.com/WeAreHausTech/haus-workflow-catalog)
-(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).
+(version pinned in `library/catalog/manifest.json`). Fetched at runtime from the latest
+release tag. Ref precedence: `HAUS_CATALOG_REF` env → a project's
+`.haus-workflow/haus.config.json#catalogRef` pin → latest release tag → bundled snapshot
+→ `main`.
 Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
 
+Items install by **flattening** (`skill`, `agent`, `template`, `command` — basename only)
+or by **mirroring** their upstream path under `sources/<slug>/` (`rule`, `asset` — so
+`.claude/rules/react/hooks.md` lands where the curated prose that references it expects).
+See [ADR-0046](docs/decisions/0046-manifest-format-2-install-contract.md).
+
 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
@@ -95,6 +103,10 @@ not pruned.
 > If an older CLI left deprecated skills on disk, upgrade first
 > (`npm i -g @haus-tech/haus-workflow`) then run `haus update` to prune them.
 
+> **Upgrading to `2.0.0`:** see [docs/upgrading-2.0.md](docs/upgrading-2.0.md). It carries
+> the rollout order (CLI first, catalog second), the two renamed skill directories, what
+> `.claude/rules/` now contains, and how to pin to a format-1 catalog to defer.
+
 ## Internal docs
 
 [docs/SUMMARY.md](docs/SUMMARY.md) — full documentation index