workspai 0.59.0 → 0.59.1

package/docs/ci-workflows.md

@@ -22,6 +22,16 @@ The release workflow requires the cost-bounded
 normal push that touches the contracted generator surface produces this gate;
 maintainers do not need to run the full cross-platform matrix before publishing.
 
+Consumer mirror synchronization does not add another required CLI workflow.
+Local pre-commit synchronizes mirrors when contract sources are staged;
+pre-push requires canonical CLI outputs to be committed but does not require a
+consumer release. The extension's own CI remains responsible for hard parity
+against the CLI version selected for that extension release. Consumer-owned
+version floors remain separate from CLI-owned schema inventories, preventing
+parity checks from coupling product versions. Breaking contract removal or
+incompatible schema changes remain CLI release blockers through the canonical
+compatibility and schema-version gates.
+
 Pushes and pull requests run every contracted generator on the primary Linux
 lane. The weekly schedule and manual dispatch can run the complete Linux,
 macOS, and Windows matrix as a non-blocking compatibility and upstream-drift
@@ -30,6 +40,13 @@ caching generated projects; every smoke run still exercises the current
 upstream generator, generated artifacts, build surface, registry, and Doctor
 evidence.
 
+The Windows coverage lane intentionally uses bounded Vitest worker concurrency
+and platform-aware transaction timeouts. Filesystem-heavy workspace tests must
+finish their transaction before teardown; cleanup retries transient Windows
+`EBUSY` and `ENOTEMPTY` states instead of converting one slow operation into a
+cascade of unrelated missing-file failures. These budgets remain finite and do
+not retry failed assertions or product operations.
+
 ## Release announcements
 
 `packages/cli/releases/release-products.v1.json` maps a release product to its
@@ -46,7 +63,7 @@ Validate or preview the current CLI announcement locally:
 npm --workspace workspai run check:release-announcement
 npm --workspace workspai run release:announcement -- \
   --product workspai-cli \
-  --tag v0.59.0 \
+  --tag v0.59.1 \
   --markdown-output /tmp/workspai-discord-announcement.md
 ```
 

package/docs/contracts/README.md

@@ -28,15 +28,28 @@ Canonical JSON lives in **`../../contracts/`** (CLI package root, published in t
 | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
 | `npm run generate:contracts`                | Regenerate runtime surface, create planner, agent customization pack, import-stack parity, module-layout, infra-stack |
 | `npm run check:generated-contracts`         | Verify committed JSON matches generators                                                                              |
-| `npm run sync:parity-snapshot`              | Copy canonical → vscode `contracts/` mirror                                                                           |
+| `npm run sync:shared-contracts`             | Generate canonical JSON and sync root plus locally available consumer mirrors                                          |
+| `npm run sync:parity-snapshot`              | Compatibility alias for canonical and consumer mirror synchronization                                                  |
 | `npm run check:parity-snapshot`             | Verify mirrors match canonical                                                                                        |
+| `npm run contracts:prepush`                 | Sync local consumers and require generated canonical CLI mirrors to be committed                                      |
 | `npm run validate:contracts`                | Shared-contract checks and focused contract tests                                                                     |
 | `npm run contracts:validate`                | Comprehensive generated/shared contract, parity, runtime-conformance, and adversarial gate                            |
 | `npm run check:agent-customization-drift`   | Verify generated agent customization files are committed in a consumer workspace                                      |
 | `npm run test:real-world -- ...`            | Qualify explicitly selected linked repositories in isolated or cumulative workspaces                                  |
 | `npm run test:real-world:enterprise -- ...` | Exercise the read-mostly, export, archive, agent dry-run, snapshot, and destructive dry-run command surface           |
 
-Workflow: change code → `npm run generate:contracts` → `npm run sync:parity-snapshot` → commit npm + vscode `contracts/`.
+Workflow: change code → `npm run sync:shared-contracts` → review and commit
+the CLI mirrors plus every locally available consumer mirror → push. When the
+VS Code repository is available, pre-commit synchronizes and stages its mirrored
+contracts. Pre-push refuses uncommitted canonical CLI outputs while consumer
+drift remains visible without coupling release cadence.
+
+The CLI does not require a cross-repository consumer workflow before npm
+publication. Workspai VS Code enforces hard parity in its own release CI against
+the CLI version it selects. Consumer-specific version floors remain owned by
+the consumer; schema synchronization never forces a redundant CLI release.
+Breaking schema changes are still blocked by versioned contract compatibility
+gates in the CLI.
 
 ## Documents in this folder
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workspai",
-  "version": "0.59.0",
+  "version": "0.59.1",
   "type": "module",
   "description": "Open-source workspace intelligence CLI for software systems: create, adopt, govern, verify, and align polyglot workspaces for humans, CI, IDEs, and AI agents.",
   "keywords": [
@@ -162,6 +162,7 @@
     "contracts:sync": "corepack npm run sync:contracts && corepack npm run sync:shared-contracts",
     "contracts:check": "corepack npm run check:contracts && corepack npm run check:shared-contracts && corepack npm run check:parity-snapshot && corepack npm run check:generated-contracts && corepack npm run check:agent-customization-drift",
     "contracts:check:local": "corepack npm run check:contracts && corepack npm run check:shared-contracts && corepack npm run check:generated-contracts && corepack npm run check:agent-customization-drift",
+    "contracts:prepush": "corepack npm run sync:shared-contracts && corepack npm run check:shared-contracts -- --require-clean",
     "contracts:validate": "corepack npm run contracts:check && corepack npm run validate:contracts && corepack npm run build && corepack npm run check:workspace-intelligence-runtime && corepack npm run check:workspace-intelligence-adversarial && corepack npm run check:doctor-capabilities",
     "docs:validate": "corepack npm run validate:docs",
     "smoke": "corepack npm run smoke:enterprise-package && corepack npm run smoke:readme && corepack npm run check:generator-smoke-coverage && corepack npm run smoke:official-generators",

package/dist/autopilot-release-KQGDM2AA.js

@@ -1 +0,0 @@
-export{b as AUTOPILOT_RELEASE_ALIAS_FILENAME,a as AUTOPILOT_RELEASE_LAST_RUN_FILENAME,c as runAutopilotRelease}from'./chunk-RHK53ZK7.js';

package/dist/workspace-run-7EJEBHAH.js

@@ -1 +0,0 @@
-export{a as runWorkspaceStage}from'./chunk-UVBPEX3E.js';export{a as WORKSPACE_RUN_LAST_REPORT_FILENAME}from'./chunk-W6FHVXNL.js';