@haus-tech/haus-workflow 4.0.1 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [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
+
+- **skill:** AI-driven project:new flow ([#328](https://github.com/WeAreHausTech/haus-workflow/issues/328)) ([caba292](https://github.com/WeAreHausTech/haus-workflow/commit/caba29275b5a8e8dd6e8f70f876fab2f292fe75a))
+
+### Bug Fixes
+
+- init and workspace-setup share apply's installable-content honesty gate ([#331](https://github.com/WeAreHausTech/haus-workflow/issues/331)) ([9d5c05f](https://github.com/WeAreHausTech/haus-workflow/commit/9d5c05face1a573af7be4c07460a3a4ef00d39d2)), closes [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [243/#325](https://github.com/243/haus-workflow/issues/325) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325) [#326](https://github.com/WeAreHausTech/haus-workflow/issues/326) [#326](https://github.com/WeAreHausTech/haus-workflow/issues/326) [#326](https://github.com/WeAreHausTech/haus-workflow/issues/326) [#326](https://github.com/WeAreHausTech/haus-workflow/issues/326) [#326](https://github.com/WeAreHausTech/haus-workflow/issues/326) [#325](https://github.com/WeAreHausTech/haus-workflow/issues/325)
+- offline/air-gapped apply reports what it actually installed ([#327](https://github.com/WeAreHausTech/haus-workflow/issues/327)) ([562daf4](https://github.com/WeAreHausTech/haus-workflow/commit/562daf46bc341cd4df4fe93824f5fe46b1994fc2)), closes [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [ADR-0059/#243](https://github.com/ADR-0059/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243) [#243](https://github.com/WeAreHausTech/haus-workflow/issues/243)
+- type backupTrackedPaths prefix so unregistered backup is a compile error ([#295](https://github.com/WeAreHausTech/haus-workflow/issues/295)) ([#324](https://github.com/WeAreHausTech/haus-workflow/issues/324)) ([0ac81a9](https://github.com/WeAreHausTech/haus-workflow/commit/0ac81a96c68f77bee7b845bc07b35e57cfe895cd)), closes [#293](https://github.com/WeAreHausTech/haus-workflow/issues/293) [#294](https://github.com/WeAreHausTech/haus-workflow/issues/294)
+
 ## [4.0.1](https://github.com/WeAreHausTech/haus-workflow/compare/v4.0.0...v4.0.1) (2026-08-20)
 
 ### Bug Fixes

package/README.md

@@ -86,7 +86,9 @@ 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. Ref precedence: `HAUS_CATALOG_REF` env → a project's
 `.haus-workflow/haus.config.json#catalogRef` pin → latest release tag → bundled snapshot
-→ `main`.
+→ `main`. **The bundled snapshot is metadata only — it has no item content to install**
+(see "Offline and air-gapped use" below); it exists so the CLI still has a manifest to
+read with no network access, not as a usable install source.
 Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
 
 Items install by **flattening** (`skill`, `agent`, `template`, `command` — basename only)
@@ -111,6 +113,42 @@ snapshotted — see [docs/cli.md](docs/cli.md) → `haus backups`). Approved ite
 > 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.
 
+### Offline and air-gapped use
+
+The npm package ships catalog **metadata** only — the manifest, validation rules, ADR
+triggers and the lock schema. It does not contain any catalog item content. A machine with
+no populated cache can write core files (`CLAUDE.md`, `settings.json`, `WORKFLOW.md`) but
+cannot install skills, agents, or rules until it has real content — from a network sync
+or an imported bundle (see [ADR-0060](docs/decisions/0060-offline-catalog-honesty.md)).
+
+To set up a disconnected machine:
+
+```bash
+# On a machine with network access:
+haus update
+haus catalog bundle export --out catalog.tgz
+
+# Move catalog.tgz across, then on the disconnected machine:
+haus catalog bundle import catalog.tgz
+haus apply --write --offline
+```
+
+Pass `--offline` (or set `HAUS_OFFLINE=1`) to skip the network legs up front rather than
+waiting on timeouts (catalog sync, npm version check, workflow-template fetch, llms.txt
+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`, `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
 
 [docs/SUMMARY.md](docs/SUMMARY.md) — full documentation index