@zhivex-ai/harness 0.11.0 → 1.0.0-rc.7
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 +129 -0
- package/README.md +9 -8
- package/ROADMAP.md +31 -8
- package/SECURITY.md +4 -2
- package/SUPPORT.md +4 -2
- package/contracts/public-api.json +1359 -0
- package/contracts/security-controls.json +15 -0
- package/contracts/stable-api-signatures.json +490 -0
- package/dist/cli-options.d.ts +40 -0
- package/dist/cli-stream.d.ts +15 -15
- package/dist/cli.d.ts +20 -6
- package/dist/cli.js +2103 -496
- package/dist/config.d.ts +14 -0
- package/dist/errors.d.ts +68 -0
- package/dist/file-security.d.ts +29 -0
- package/dist/hostile-repository-demo.js +793 -329
- package/dist/index.d.ts +12 -4
- package/dist/index.js +7392 -5216
- package/dist/json-contracts.d.ts +1707 -0
- package/dist/operations.d.ts +1 -1
- package/dist/providers.d.ts +5 -0
- package/dist/state-backup.d.ts +148 -0
- package/dist/time-to-safe-fix.d.ts +43 -2
- package/dist/verify-historical-migrations.js +7667 -0
- package/dist/zhx.js +2103 -496
- package/docs/CLI.md +21 -4
- package/docs/DEPRECATIONS.md +9 -0
- package/docs/DURABLE_OPERATIONS.md +18 -1
- package/docs/EXTENSIBILITY.md +3 -3
- package/docs/GA_READINESS.md +23 -0
- package/docs/GEMINI_1_0_DECISION.md +9 -0
- package/docs/LIVE_CERTIFICATION.md +22 -2
- package/docs/PUBLIC_SECURITY.md +39 -0
- package/docs/RELEASE.md +17 -10
- package/docs/ROLLBACK.md +9 -0
- package/docs/SECURITY_REVIEW_EVIDENCE.md +15 -0
- package/docs/STABILITY.md +13 -0
- package/docs/SUPPORT_MATRIX.md +17 -0
- package/docs/THREAT_MODEL.md +28 -0
- package/docs/TIME_TO_SAFE_FIX.md +2 -2
- package/docs/ga-readiness.json +235 -0
- package/docs/support-matrix.json +29 -0
- package/evaluations/representative-assembly-matrix.json +138 -0
- package/evaluations/representative-matrix.json +179 -0
- package/evaluations/representative-repositories.jsonl +7 -0
- package/examples/mcp-config.json +1 -1
- package/fixtures/contracts/v1/doctor.json +45 -0
- package/fixtures/contracts/v1/error.json +9 -0
- package/fixtures/contracts/v1/observational-documents.json +34 -0
- package/fixtures/contracts/v1/providers.json +17 -0
- package/fixtures/contracts/v1/run-result-forward.json +37 -0
- package/fixtures/contracts/v1/run-result.json +34 -0
- package/fixtures/contracts/v1/run-stream-result.jsonl +1 -0
- package/fixtures/migrations/0.10.0.json +315 -0
- package/fixtures/migrations/0.10.0.sqlite +0 -0
- package/fixtures/migrations/0.11.1.json +319 -0
- package/fixtures/migrations/0.11.1.sqlite +0 -0
- package/fixtures/migrations/README.md +20 -0
- package/package.json +16 -9
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,135 @@ All notable changes to Zhivex Harness are documented in this file.
|
|
|
4
4
|
|
|
5
5
|
The project follows Semantic Versioning. During `0.x`, minor releases may change user-facing contracts when the change is documented with a migration note. Patch releases remain backwards compatible bug fixes.
|
|
6
6
|
|
|
7
|
+
## 1.0.0-rc.7 - 2026-08-25
|
|
8
|
+
|
|
9
|
+
### Fixed
|
|
10
|
+
|
|
11
|
+
- Keep `@zhivex-ai/core@1.10.0`, `@zhivex-ai/agents@1.3.0`, and `@zhivex-ai/openai@0.10.0`, while restoring `@zhivex-ai/qwen@0.10.2`, the last adapter that passed the complete release-bound Qwen representative matrix. Qwen `0.10.3` failed closed before the Harness durable tool-call-ID normalizer could recover the affected turns.
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
|
|
15
|
+
- Record the immutable, unpublished RC.6 attempt as failed after exact-artifact and release-bound live certification passed, while Qwen resolved only 12/14 representative cases in both the original protected run and one retry; npm publication remained skipped.
|
|
16
|
+
- Extend the representative release matrix through `v1.0.0-rc.7`; because RC.6 cannot count toward GA, a later independent passing candidate will still be required before stable promotion.
|
|
17
|
+
|
|
18
|
+
## 1.0.0-rc.6 - 2026-08-25
|
|
19
|
+
|
|
20
|
+
### Fixed
|
|
21
|
+
|
|
22
|
+
- Upgrade the coordinated Zhivex SDK batch to `@zhivex-ai/core@1.10.0`, `@zhivex-ai/agents@1.3.0`, `@zhivex-ai/openai@0.10.0`, and `@zhivex-ai/qwen@0.10.3`, retaining exact pins and one Core override across every provider adapter.
|
|
23
|
+
- Preserve the sanitized OpenAI Responses tool-call diagnostic and retryability from durable SDK failures in Time-to-Safe-Fix evidence without retaining raw arguments, provider payloads, or error messages.
|
|
24
|
+
- Complete the governed representative driver from the signed, journaled `apply_environment_patch` receipt after its separate edit, verifier, inspection, and import approvals, avoiding a redundant final provider turn after the authorized repair is already durable.
|
|
25
|
+
|
|
26
|
+
### Changed
|
|
27
|
+
|
|
28
|
+
- Record the immutable, unpublished RC.5 attempt as failed after exact-artifact validation and release-bound live certification passed but OpenAI resolved only 13/14 representative cases.
|
|
29
|
+
- Advance the next candidate to `v1.0.0-rc.6`; because RC.5 cannot count toward GA, a later independent passing candidate will still be required before stable promotion.
|
|
30
|
+
|
|
31
|
+
## 1.0.0-rc.5 - 2026-08-24
|
|
32
|
+
|
|
33
|
+
### Fixed
|
|
34
|
+
|
|
35
|
+
- Replace missing, whitespace-only, and legacy numeric Qwen streaming tool-call IDs with deterministic, turn-durable IDs before agent state can observe them; preserve valid provider IDs and reject real duplicates fail-closed.
|
|
36
|
+
- Persist a bounded failure origin and allowlisted provider diagnostic code in Time-to-Safe-Fix failures, including through typed Harness error causes, without retaining provider messages or raw output.
|
|
37
|
+
|
|
38
|
+
### Changed
|
|
39
|
+
|
|
40
|
+
- Record the immutable, unpublished RC.4 attempt as failed after its release-bound live-provider gate passed but Qwen resolved only 13/14 representative cases.
|
|
41
|
+
- Extend the representative release matrix through `v1.0.0-rc.6`; RC.5 and RC.6 must both pass independently before GA.
|
|
42
|
+
|
|
43
|
+
## 1.0.0-rc.4 - 2026-08-24
|
|
44
|
+
|
|
45
|
+
### Fixed
|
|
46
|
+
|
|
47
|
+
- Preserve stable typed Harness failure `code`, `category`, and `retryable` metadata alongside Time-to-Safe-Fix semantic classification, so transient provider and OCI execution failures remain machine-classifiable without retaining raw error text.
|
|
48
|
+
|
|
49
|
+
### Changed
|
|
50
|
+
|
|
51
|
+
- Record the immutable, unpublished RC.3 release attempt as failed at the representative-evaluation gate after exact-artifact, release-bound live certification, and the Meta matrix passed.
|
|
52
|
+
- Extend the representative release matrix through `v1.0.0-rc.5` because RC.1, RC.2, and RC.3 cannot count toward the two-passing-candidate GA requirement.
|
|
53
|
+
|
|
54
|
+
## 1.0.0-rc.3 - 2026-08-24
|
|
55
|
+
|
|
56
|
+
### Fixed
|
|
57
|
+
|
|
58
|
+
- Persist bounded structured diagnostics for failed representative-provider cases while continuing to exclude raw prompts, model output, raw provider error text, and workspace contents from release artifacts.
|
|
59
|
+
- Record whether the release-bound live-provider gate passed or failed independently from other failed release gates, and reject contradictory ledger evidence.
|
|
60
|
+
|
|
61
|
+
### Changed
|
|
62
|
+
|
|
63
|
+
- Record the immutable, unpublished RC.2 release attempt as failed at the representative-evaluation gate after exact-artifact and release-bound live certification passed.
|
|
64
|
+
- Extend the representative release matrix through `v1.0.0-rc.4` because RC.1 and RC.2 cannot count toward the two-passing-candidate GA requirement.
|
|
65
|
+
|
|
66
|
+
## 1.0.0-rc.2 - 2026-08-23
|
|
67
|
+
|
|
68
|
+
### Fixed
|
|
69
|
+
|
|
70
|
+
- Normalize missing or whitespace-only Qwen tool-call IDs at the built-in provider boundary before durable agent state, approvals, or tool journals can observe them; preserve valid provider IDs and reject duplicate IDs fail-closed.
|
|
71
|
+
|
|
72
|
+
### Changed
|
|
73
|
+
|
|
74
|
+
- Record immutable release attempts that fail protected gates without claiming npm publication or provenance, exclude them from passing GA evidence, and require two later passing candidates before stable promotion.
|
|
75
|
+
- Extend the representative release matrix through `v1.0.0-rc.3` because the failed, unpublished RC.1 attempt cannot count toward the two-candidate GA requirement.
|
|
76
|
+
|
|
77
|
+
## 1.0.0-rc.1 - 2026-08-23
|
|
78
|
+
|
|
79
|
+
### Added
|
|
80
|
+
|
|
81
|
+
- Add a machine-checked 1.0 public API/CLI/schema baseline, support matrix, threat/control map, deprecation and rollback policies, representative-evidence schema, and a fail-closed GA readiness ledger.
|
|
82
|
+
- Add an explicit config schema `4` to `5` migration helper that preserves the older authority boundary by disabling project context and OCI shell exposure unless the operator opts in after review.
|
|
83
|
+
- Add stable machine error codes with typed configuration/CLI usage errors and compile a TypeScript consumer against the installed release tarball.
|
|
84
|
+
- Add schema-1 parsers and golden fixtures for public JSON/JSONL output, a command-specific CLI option manifest, and provider-free logical SQLite state status/export/import commands.
|
|
85
|
+
- Add byte-for-byte SQLite migration fixtures generated from the integrity-verified published `0.10.0` and `0.11.1` artifacts and verify them through current run and session APIs.
|
|
86
|
+
- Add a seven-repository, 14-run representative matrix with strict per-case evidence generation, sanitized cross-provider assembly, and a protected Meta/Qwen/OpenAI release job that blocks npm publication.
|
|
87
|
+
- Add a strict release-candidate security-review schema covering every control, trust boundary, authority-bearing tool, finding, reviewer, artifact binding, and remotely verified CI/CodeQL/release workflow.
|
|
88
|
+
|
|
89
|
+
### Changed
|
|
90
|
+
|
|
91
|
+
- Allow protected `1.0.0-rc.N` artifacts only on npm `next`, keep stable releases on `latest`, and reject version/channel drift before publication.
|
|
92
|
+
- Bind each GA release-candidate record to a distinct annotated tag, main-reachable commit, published npm integrity, SLSA provenance statement, and successful release workflow; require every declared provider/scenario on both candidates, verify the evaluation workflows through GitHub, and require a concrete security-review artifact.
|
|
93
|
+
- Expose CLI command/subcommand constants as the source for the frozen command manifest and document previously omitted child-budget options in help output.
|
|
94
|
+
- Emit a distinct compact `run-stream-result` JSONL terminal record, keep machine errors message-free, and delay terminal JSONL output until asynchronous persistence/environment cleanup succeeds.
|
|
95
|
+
- Run installed-package smoke against the exact inspected tarball in CI, reject SQLite WAL/SHM sidecars, and clean `dist` before every build.
|
|
96
|
+
- Classify all 213 runtime and 166 type exports explicitly as Stable, Beta, or Experimental, and compare the complete partition with the installed tarball namespace and declarations.
|
|
97
|
+
- Bind every Stable runtime and type export to a reproducible declaration-closure hash and verify that signature snapshot against source-emitted and installed-tarball declarations.
|
|
98
|
+
- Keep Gemini explicitly provisional and outside the 1.0 certified cohort; accept later corrective RCs only as a contiguous sequence after the required RC.1 and RC.2.
|
|
99
|
+
|
|
100
|
+
### Security
|
|
101
|
+
|
|
102
|
+
- Stream integrity-pinned historical npm archives directly into an isolated extractor instead of persisting network bytes, constrain MCP authentication to canonical credential headers backed by dedicated `ZHIVEX_MCP_*` variables, publish state backups atomically without clobbering existing targets, and reject orphaned active leases for runs being imported.
|
|
103
|
+
|
|
104
|
+
### Migration
|
|
105
|
+
|
|
106
|
+
- Existing schema `5` configuration is unchanged. Call `migrateHarnessConfigInput` for an explicitly versioned schema `4` input; the pure migration does not read environment variables or filesystem state. Paused approvals remain bound to the exact older artifact and are never rewritten.
|
|
107
|
+
- Existing schema-1 JSON observers may accept additive fields, but JSONL consumers must recognize the distinct `run-stream-result` and `run-stream-error` terminal kinds. The literal durable `userId` value `"*"` is now rejected because it is reserved for the absent-user scope marker.
|
|
108
|
+
- Rename MCP credential variables to the `ZHIVEX_MCP_*` namespace; HTTP `headerEnv` entries now accept only `authorization` and `x-api-key`.
|
|
109
|
+
|
|
110
|
+
## 0.11.1 - 2026-08-23
|
|
111
|
+
|
|
112
|
+
### Changed
|
|
113
|
+
|
|
114
|
+
- Make provider live certification a fail-closed dependency of the publish job and bind manual certification runs to an explicit release tag.
|
|
115
|
+
- Remove release-version defaults from GitHub workflow inputs. Maintainers enter the annotated tag at dispatch, and release readiness validates it against the single version source in `package.json`.
|
|
116
|
+
- Keep release-artifact transfer actions pinned to immutable commit SHAs while allowing Dependabot SHA upgrades, and represent successful remote tag-bound certification explicitly in the release-status schema.
|
|
117
|
+
- Add a mutable machine-readable repository release-status record, keep it outside immutable npm artifacts, and validate public documentation, release gates, and repository security configuration against it.
|
|
118
|
+
- Bound installed-package smoke subprocesses by time and captured output so a stalled child process cannot hang release validation indefinitely.
|
|
119
|
+
- Keep public documentation consistent with candidate and published artifact state while preserving live-provider certification as a separate evidence boundary.
|
|
120
|
+
- Retry only transient HTTP failures in the opt-in base provider smoke, using fresh temporary state and a bounded three-attempt schedule; contract and approval failures still fail immediately.
|
|
121
|
+
- Preserve transient provider status from failed agent outputs before release-smoke contract assertions so retryable 429/5xx responses reach the bounded retry loop.
|
|
122
|
+
- Mark create-only `expectedDigest: null` as an explicitly required tool-schema field and reinforce that contract in live certification prompts for providers that otherwise omit null-valued arguments.
|
|
123
|
+
- Record current worktree live evidence separately from release-bound certification: the certified cohort passed every local gate, while Gemini Flash 3.7 passed base editing and delegation but remained blocked on provider quota/capacity during OCI execution.
|
|
124
|
+
|
|
125
|
+
### Security
|
|
126
|
+
|
|
127
|
+
- Add CodeQL, Dependabot, CODEOWNERS, and documented public-repository security controls. GitHub-side controls that are free for public repositories are enabled; optional cost-bearing analysis remains disabled and explicitly recorded. Live provider credentials are scoped only to the final provider-call step rather than checkout, setup, dependency installation, or deterministic validation.
|
|
128
|
+
- Bind workspace, context, OCI, change-envelope, and release-artifact reads to bounded regular-file descriptors that reject symbolic links, hard-linked OCI exports, special files, and concurrent content replacement.
|
|
129
|
+
- Create SQLite state files and benchmark canaries exclusively, stage release archives from the exact inspected bytes, pin registry identity independently of package metadata, and classify adversarial benchmark failures with a linear complete-token scanner.
|
|
130
|
+
- Recover canonical `.cleanup-<artifact>-<uuid>` OCI artifact directories after interrupted cleanup without weakening inode and metadata revalidation.
|
|
131
|
+
|
|
132
|
+
### Migration from 0.11.0
|
|
133
|
+
|
|
134
|
+
No configuration, SQLite, approval, or execution-policy migration is required. Existing `0.11.0` state remains compatible; this patch tightens failure classification, cleanup recovery, and release boundaries.
|
|
135
|
+
|
|
7
136
|
## 0.11.0 - 2026-08-21
|
|
8
137
|
|
|
9
138
|
### Added
|
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ Zhivex Harness runs coding agents against real repositories with conflict-safe e
|
|
|
13
13
|
|
|
14
14
|
The model provides capability. The harness controls what it may inspect, execute, change, resume, and prove. Every provider uses the same bounded tool and approval contract.
|
|
15
15
|
|
|
16
|
-
Version `0.11.
|
|
16
|
+
Version `0.11.1` is the current public npm release and `latest` distribution tag. Its annotated tag, exact registry integrity, SLSA provenance, and release-bound Meta/Qwen/OpenAI certification are recorded in the [repository release status](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/release-status.json). Publication remains fail-closed on deterministic, installed-package, real-OCI, base-provider, orchestration, routing, and model-directed execution gates. The planned 1.0 promotion is tracked by the [machine-checked readiness gate](./docs/GA_READINESS.md), [API stability policy](./docs/STABILITY.md), [support matrix](./docs/SUPPORT_MATRIX.md), and [threat model](./docs/THREAT_MODEL.md). See [ROADMAP.md](./ROADMAP.md), [CHANGELOG.md](./CHANGELOG.md), [public repository security](./docs/PUBLIC_SECURITY.md), the [change-envelope guide](./docs/CHANGE_ENVELOPES.md), the [CLI contract](./docs/CLI.md), the [context-engineering guide](./docs/CONTEXT_ENGINEERING.md), the [extensibility guide](./docs/EXTENSIBILITY.md), and the [durable-operations guide](./docs/DURABLE_OPERATIONS.md).
|
|
17
17
|
|
|
18
18
|
## Why Zhivex Harness
|
|
19
19
|
|
|
@@ -109,10 +109,10 @@ It does not include arbitrary host shell access, `stdio` MCP, permanent deletion
|
|
|
109
109
|
|
|
110
110
|
## Installation
|
|
111
111
|
|
|
112
|
-
Install the
|
|
112
|
+
Install the Node-first `0.11.1` artifact with an exact version:
|
|
113
113
|
|
|
114
114
|
```bash
|
|
115
|
-
npx --yes --package=@zhivex-ai/harness@0.
|
|
115
|
+
npx --yes --package=@zhivex-ai/harness@0.11.1 zhx --version
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
To exercise the source checkout, contributors use Bun for deterministic repository tooling while the built CLI itself runs on Node:
|
|
@@ -196,7 +196,7 @@ zhx run --provider openai --route explorer=qwen --route reviewer=gemini \
|
|
|
196
196
|
"implement the change, then review it independently"
|
|
197
197
|
```
|
|
198
198
|
|
|
199
|
-
Routing with `--max-cost-usd` remains rejected in `0.11.
|
|
199
|
+
Routing with `--max-cost-usd` remains rejected in `0.11.1`: aggregate usage cannot yet be priced correctly when roles use different models.
|
|
200
200
|
|
|
201
201
|
Writes and checks pause for approval. In a non-interactive execution, state is saved in `.zhivex-harness/runs/operations.sqlite`:
|
|
202
202
|
|
|
@@ -282,14 +282,14 @@ zhivex-harness run --execution oci --oci-shell ask "use a reviewed shell pipelin
|
|
|
282
282
|
|
|
283
283
|
| Provider | Default model | Current support |
|
|
284
284
|
| --- | --- | --- |
|
|
285
|
-
| Meta | `muse-spark-1.2` | `MODEL_API_KEY` · 0.
|
|
286
|
-
| Qwen | `qwen3.8-max` | `DASHSCOPE_API_KEY` or `QWEN_API_KEY` · 0.
|
|
287
|
-
| OpenAI | `gpt-5.6-luna` | `OPENAI_API_KEY` ·
|
|
285
|
+
| Meta | `muse-spark-1.2` | `MODEL_API_KEY` · 0.11.1 release-bound base, delegation, and OCI execution certified |
|
|
286
|
+
| Qwen | `qwen3.8-max` | `DASHSCOPE_API_KEY` or `QWEN_API_KEY` · 0.11.1 release-bound base, delegation, routing, and OCI execution certified |
|
|
287
|
+
| OpenAI | `gpt-5.6-luna` | `OPENAI_API_KEY` · 0.11.1 release-bound base, delegation, routing, and OCI execution certified |
|
|
288
288
|
| Gemini | `gemini-3.6-flash` | `GEMINI_API_KEY` or `GOOGLE_GENERATIVE_AI_API_KEY` · provisional until the harness live matrix passes |
|
|
289
289
|
|
|
290
290
|
Override any model with `--model`. Optional provider overrides are `META_BASE_URL`, `QWEN_BASE_URL`, `QWEN_WORKSPACE_ID`, `QWEN_REGION`, `OPENAI_BASE_URL`, and `GEMINI_BASE_URL`. Non-credential transport settings are hash-bound to durable resumes without persisting their values.
|
|
291
291
|
|
|
292
|
-
|
|
292
|
+
The exact `v0.11.1` tag passed proposal/approval/restart, bounded delegation, OpenAI-parent/Qwen-reviewer routing, and model-directed OCI execution for Meta `muse-spark-1.2`, Qwen `qwen3.8-max`, and OpenAI `gpt-5.6-luna` on 2026-08-23. Luna remains the OpenAI default, while Terra and Sol remain explicit `--model` selections with older local base evidence only. Controlled and official-SDK MCP interoperability are verified separately and do not imply compatibility with every server or protocol feature. Provider capability claims remain artifact- and date-bound under the [live certification contract](./docs/LIVE_CERTIFICATION.md); credential detection and deterministic tests do not replace real provider evidence.
|
|
293
293
|
|
|
294
294
|
## Security boundaries
|
|
295
295
|
|
|
@@ -318,6 +318,7 @@ The default `none` backend provides governance but no OS isolation and therefore
|
|
|
318
318
|
|
|
319
319
|
```bash
|
|
320
320
|
bun run typecheck
|
|
321
|
+
bun run readiness:1.0
|
|
321
322
|
bun test
|
|
322
323
|
bun run build
|
|
323
324
|
bun run evaluate
|
package/ROADMAP.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
- Status: active
|
|
4
4
|
- Baseline date: 2026-08-21
|
|
5
5
|
|
|
6
|
-
This roadmap takes the harness from its `0.1.0` MVP to a stable CLI and library contract. The `0.2.0` source baseline is tagged locally, `0.3.0` and `0.4.0` are private checkpoints, and `0.5.0` through `0.
|
|
6
|
+
This roadmap takes the harness from its `0.1.0` MVP to a stable CLI and library contract. The `0.2.0` source baseline is tagged locally, `0.3.0` and `0.4.0` are private checkpoints, and `0.5.0` through `0.11.1` are published on npm. Version `0.11.1` delivers file and release hardening without a `0.11.x` contract change; registry publication, supply-chain provenance, and provider certification remain separate evidence boundaries. Releases are ordered by dependency and safety risk, not by calendar date. A version ships only when its exit criteria are satisfied.
|
|
7
7
|
|
|
8
8
|
## Planning principles
|
|
9
9
|
|
|
@@ -44,7 +44,8 @@ The `0.6.0` dependency batch pins and overrides `@zhivex-ai/core@1.6.0`, retaini
|
|
|
44
44
|
| `0.8.0` | SDK refresh and GPT-5.6 | One Core runtime, current adapters, and a GPT-5.6-first OpenAI path | Published on npm | M |
|
|
45
45
|
| `0.9.0` | Fast governed change admission | Lower repository/OCI overhead plus portable offline evidence bound to exact patch bytes | Published on npm | L |
|
|
46
46
|
| `0.10.0` | Node-first portability | Node CLI/library, portable SQLite/processes, manager-aware checks, and Node OCI | Published on npm | L |
|
|
47
|
-
| `0.11.0` | Daily-driver foundations | Richer terminal operation, governed context/skills/hooks, and opt-in OCI shell |
|
|
47
|
+
| `0.11.0` | Daily-driver foundations | Richer terminal operation, governed context/skills/hooks, and opt-in OCI shell | Published on npm | L |
|
|
48
|
+
| `0.11.1` | Security and release hardening | Bounded reads, recoverable cleanup, and fail-closed release evidence | Published on npm | S |
|
|
48
49
|
| `1.0.0` | Stable contract | Supported compatibility and release guarantees | Planned | L |
|
|
49
50
|
|
|
50
51
|
Relative size is for sequencing only; dates require a capacity decision.
|
|
@@ -313,7 +314,7 @@ Exit criteria:
|
|
|
313
314
|
|
|
314
315
|
## 0.11.0 — daily-driver foundations
|
|
315
316
|
|
|
316
|
-
Status:
|
|
317
|
+
Status: published on npm as `latest` with annotated tag `v0.11.0`, exact registry integrity, and SLSA provenance. Release-bound remote provider certification remains pending and is not implied by publication.
|
|
317
318
|
|
|
318
319
|
Goal: make the governed runtime practical for daily interactive work without giving repository content or shell syntax authority over host policy.
|
|
319
320
|
|
|
@@ -330,10 +331,32 @@ Exit criteria:
|
|
|
330
331
|
- TTY, no-color, approval-resume, context traversal/symlink, skill disclosure, hook redaction/failure, and OCI shell policy regressions pass.
|
|
331
332
|
- The full deterministic, package, and real-OCI gates pass from a clean commit before any release number, tag, or publication is claimed.
|
|
332
333
|
|
|
334
|
+
## 0.11.1 — security and release hardening
|
|
335
|
+
|
|
336
|
+
Status: published on npm as `latest` with annotated tag `v0.11.1`, exact registry integrity, SLSA provenance, and successful release-bound Meta/Qwen/OpenAI certification.
|
|
337
|
+
|
|
338
|
+
Goal: ship the reviewed security and release hardening accumulated after `0.11.0` without changing configuration, durable state, or execution-policy contracts.
|
|
339
|
+
|
|
340
|
+
Scope:
|
|
341
|
+
|
|
342
|
+
- bind sensitive reads and release archive staging to bounded, no-follow regular-file snapshots;
|
|
343
|
+
- recover cleanup directories left by interrupted OCI artifact deletion;
|
|
344
|
+
- preserve transient provider status through the live-smoke retry boundary;
|
|
345
|
+
- classify tool failures with complete tokens in one linear scan; and
|
|
346
|
+
- keep publication fail-closed on the exact tag, tarball, live-provider matrix, registry integrity, and provenance.
|
|
347
|
+
|
|
348
|
+
Exit criteria:
|
|
349
|
+
|
|
350
|
+
- focused security regressions, the complete deterministic gate, installed-package smoke, and real OCI pass;
|
|
351
|
+
- the exact annotated tag passes base, orchestration, routing, and model-directed live execution; and
|
|
352
|
+
- npm `latest`, tarball SHA-512, SLSA provenance, tag, and source commit agree.
|
|
353
|
+
|
|
333
354
|
## 1.0.0 — Stable CLI and library contract
|
|
334
355
|
|
|
335
356
|
Goal: freeze a supportable public contract after the pre-1.0 safety and operational surfaces have been exercised in real repositories.
|
|
336
357
|
|
|
358
|
+
Status: RC.1 through RC.6 passed exact-artifact validation but failed protected certification, so every publication was skipped and npm remained unchanged. RC.6 passed release-bound live certification and Meta's complete representative matrix, then failed closed at Qwen with 12/14 safe resolutions in both the original run and one retry. RC.7 keeps the Core, Agents, and OpenAI corrections while restoring the last Qwen adapter that passed this exact release-bound matrix. Public API/CLI/schema baselines, config `4 → 5` migration, historical tarball fixtures, support/security/rollback policy, RC channel enforcement, representative-evaluation generation, and evidence requirements remain machine-checked. GA remains blocked on the two open evidence classes in [`docs/ga-readiness.json`](./docs/ga-readiness.json): representative results across two passing release candidates and the final-candidate security review.
|
|
359
|
+
|
|
337
360
|
Scope:
|
|
338
361
|
|
|
339
362
|
- Stabilize CLI commands, config schema, JSON/event schemas, library exports, state migrations, and error taxonomy.
|
|
@@ -375,8 +398,8 @@ These can become separate post-1.0 tracks after the CLI/runtime contract and sec
|
|
|
375
398
|
|
|
376
399
|
## Immediate next actions
|
|
377
400
|
|
|
378
|
-
1.
|
|
379
|
-
2.
|
|
380
|
-
3.
|
|
381
|
-
4.
|
|
382
|
-
5.
|
|
401
|
+
1. Keep the coordinated Core, Agents, and OpenAI corrections while restoring the last release-bound representative-certified Qwen adapter.
|
|
402
|
+
2. Create and dispatch the exact annotated `v1.0.0-rc.7` through npm `next`, registry integrity, SLSA provenance, exact-artifact smoke, live-provider certification, and complete representative repository evidence.
|
|
403
|
+
3. If RC.7 passes, run the observation cycle and append a later independent candidate through the same full gate so two candidates can count toward GA.
|
|
404
|
+
4. Complete the named security review against the final passing candidate and close every critical/high finding.
|
|
405
|
+
5. Promote a separately tagged and verified `1.0.0` artifact to `latest` only after the release-mode readiness gate passes with two passing candidates.
|
package/SECURITY.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## Supported versions
|
|
4
4
|
|
|
5
|
-
Security fixes are provided for the latest published `0.
|
|
5
|
+
Security fixes are provided for the latest published `0.11.x` patch. Older minors and private checkpoints are not supported release channels. Registry integrity and provenance do not substitute for the separate provider and execution evidence recorded in [docs/LIVE_CERTIFICATION.md](./docs/LIVE_CERTIFICATION.md).
|
|
6
6
|
|
|
7
7
|
## Reporting a vulnerability
|
|
8
8
|
|
|
@@ -14,7 +14,9 @@ Do not open a public issue for a suspected vulnerability. Use [GitHub private vu
|
|
|
14
14
|
- the practical impact; and
|
|
15
15
|
- any suggested mitigation.
|
|
16
16
|
|
|
17
|
-
Private vulnerability reporting
|
|
17
|
+
Private vulnerability reporting is enabled for this public repository. If GitHub reports that the channel is unavailable, do not disclose exploit details in a public issue; wait for the maintainers to restore the private channel.
|
|
18
|
+
|
|
19
|
+
The enabled no-cost public controls and the explicitly cost-gated features left disabled are recorded in [docs/PUBLIC_SECURITY.md](./docs/PUBLIC_SECURITY.md).
|
|
18
20
|
|
|
19
21
|
## Scope
|
|
20
22
|
|
package/SUPPORT.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# Support
|
|
2
2
|
|
|
3
|
-
Zhivex Harness `0.
|
|
3
|
+
Zhivex Harness `0.11.x` is the latest supported pre-1.0 Node-first CLI and TypeScript library. Observable contracts may change in a later minor release when the change and migration path are documented in [CHANGELOG.md](./CHANGELOG.md). The mutable machine-readable public release state is recorded in the repository [release-status.json](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/release-status.json), outside immutable npm artifacts.
|
|
4
|
+
|
|
5
|
+
The detailed 1.0 target is tracked in the [machine-readable support matrix](./docs/support-matrix.json) and its [human-readable view](./docs/SUPPORT_MATRIX.md). Compatibility and removals follow [DEPRECATIONS.md](./docs/DEPRECATIONS.md) once 1.0 is promoted.
|
|
4
6
|
|
|
5
7
|
## Supported baseline
|
|
6
8
|
|
|
@@ -11,7 +13,7 @@ Zhivex Harness `0.10.x` is a pre-1.0 Node-first CLI and TypeScript library. Obse
|
|
|
11
13
|
- the provider/model combinations marked certified in the package documentation; and
|
|
12
14
|
- HTTPS or explicitly allowed loopback-HTTP MCP endpoints using the documented bounded JSON-RPC subset.
|
|
13
15
|
|
|
14
|
-
Only the most recent published patch receives routine fixes.
|
|
16
|
+
Only the most recent published `0.11.x` patch receives routine fixes. The exact `v0.11.1` tag passed the protected release-bound base, orchestration, routing, and model-directed execution matrix for Meta, Qwen, and OpenAI on 2026-08-23. Gemini remains provisional until its complete harness live matrix passes against an exact release candidate. Live provider evidence is account-, model-, endpoint-, artifact-, and date-dependent; see [docs/LIVE_CERTIFICATION.md](./docs/LIVE_CERTIFICATION.md).
|
|
15
17
|
|
|
16
18
|
## Support channels
|
|
17
19
|
|