@haus-tech/haus-workflow 4.0.1 → 4.1.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [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,39 @@ 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`, and `haus workspace
+setup` (issue #325 extended `apply`'s original ADR-0060 gate to the other two): 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 is recorded `failed`, not `ok`.
+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