@zhivex-ai/harness 1.4.0-rc.8 → 1.4.0

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.
Files changed (55) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +124 -72
  3. package/SECURITY.md +1 -1
  4. package/SUPPORT.md +2 -2
  5. package/dist/acp-cli.js +13 -12
  6. package/dist/{cli-3bzvq594.js → cli-2h37qyvg.js} +4 -4
  7. package/dist/{cli-entry-yqwa1943.js → cli-entry-20w6nh0k.js} +321 -16
  8. package/dist/{cli-entry-25xefnws.js → cli-entry-4ngptr62.js} +3 -3
  9. package/dist/{cli-entry-qav71mxw.js → cli-entry-w0hterjs.js} +1 -1
  10. package/dist/cli.js +2 -2
  11. package/dist/compat/code-support.js +8 -7
  12. package/dist/{config-pwbnze4g.js → config-j9624t6t.js} +1 -1
  13. package/dist/{config-depqpsae.js → config-qt69hkqj.js} +4 -3
  14. package/dist/engine/acp.js +12 -11
  15. package/dist/engine/client.js +11 -10
  16. package/dist/engine/desktop-providers-v1.js +2 -1
  17. package/dist/engine/desktop-state-v1.js +8 -7
  18. package/dist/engine/index.js +15 -14
  19. package/dist/engine/mcp-stdio-v1.js +7 -6
  20. package/dist/engine/protocol.js +12 -0
  21. package/dist/engine/service.js +12 -11
  22. package/dist/hostile-repository-demo.js +322 -17
  23. package/dist/{index-1k248k0w.js → index-5jhgatga.js} +5 -5
  24. package/dist/{index-pcn2bk8j.js → index-61gthdz6.js} +1 -1
  25. package/dist/{index-sbzvrpm7.js → index-6dft2vev.js} +2 -2
  26. package/dist/{index-09zphhwt.js → index-8zjmnyw5.js} +2 -2
  27. package/dist/{index-txrqqd2r.js → index-937cb7y8.js} +6 -6
  28. package/dist/{index-jdb1q8yn.js → index-bpc596v3.js} +15 -10
  29. package/dist/index-fm84men1.js +239 -0
  30. package/dist/{index-zmx264xy.js → index-m34q25jj.js} +2 -2
  31. package/dist/index-m49jx72n.js +220 -0
  32. package/dist/{index-9v72fpya.js → index-m82cfspw.js} +16 -10
  33. package/dist/{index-ngg2168h.js → index-nmjdwd4p.js} +1 -1
  34. package/dist/{index-w9pjt7td.js → index-pdmevfxv.js} +3 -3
  35. package/dist/{index-nqhnh1hz.js → index-pp474137.js} +5 -5
  36. package/dist/{index-vga76vmb.js → index-rkbf7dqg.js} +2 -2
  37. package/dist/{index-fny13znr.js → index-s2k2edts.js} +3 -3
  38. package/dist/{index-7y6b4yjx.js → index-tfzta544.js} +4 -4
  39. package/dist/index.js +15 -14
  40. package/dist/providers/vertex-auth.d.ts +5 -1
  41. package/dist/runtime/error-diagnostics.d.ts +8 -0
  42. package/dist/runtime/provider-transient.d.ts +33 -0
  43. package/dist/runtime/time-to-safe-fix.d.ts +8 -0
  44. package/dist/service-cli.js +12 -11
  45. package/dist/{service-client-cli-ra3yzvjg.js → service-client-cli-fn54ev6w.js} +3 -3
  46. package/dist/verify-historical-migrations.js +322 -17
  47. package/dist/zhx.js +2 -2
  48. package/docs/CLI.md +1 -1
  49. package/docs/CODE_RELEASE.md +38 -1
  50. package/docs/FIRST_USE.md +6 -6
  51. package/docs/PROJECT_MEMORY.md +1 -1
  52. package/evaluations/representative-assembly-matrix.json +10 -1
  53. package/examples/README.md +5 -5
  54. package/package.json +1 -1
  55. package/dist/index-8705zxpr.js +0 -145
package/CHANGELOG.md CHANGED
@@ -4,6 +4,19 @@ 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.4.1 - 2026-10-14
8
+
9
+ - Classify Vertex and Google transient failures as retryable `PROVIDER_UNAVAILABLE` instead of a generic `EXECUTION_FAILED`. The covered cases are HTTP 409 ABORTED, 429 RESOURCE_EXHAUSTED, 500/502/503/504, UNAVAILABLE, DEADLINE_EXCEEDED, and stream resets. Sanitized diagnostics keep the HTTP status and the closed provider status category, and still omit provider messages, resource names, and credentials.
10
+ - Retry that class, and an empty model turn with no text and no tool call, up to three times with jittered backoff in the Vertex driver. The live continuity and approval-compaction gates use the same classification and do not accept a phase that fails its assertions.
11
+ - Keep the package version at `1.4.0`. This note does not tag, publish, or dispatch a release.
12
+
13
+ ## 1.4.0 - 2026-10-09
14
+
15
+ - Prepare stable Harness 1.4.0 and Code 0.3.0 for npm `latest`, with the exact Code engine pin, private Desktop binding and an additive representative mapping for `v1.4.0` using the unchanged Meta, Qwen and OpenAI models. Retain the SDK pins already on main (Core 1.31.0, Agents 1.11.0 and the existing provider packages). Published `latest` stays Harness 1.3.0 and Code 0.2.0. Published `next` is Harness 1.4.0-rc.8 and Code 0.3.0-rc.8. `release-status.json` keeps the verified 1.3.0 record until this stable publication has its own registry evidence.
16
+ - Engine runtime source under `src/` is identical to annotated `v1.4.0-rc.8` and `code-v0.3.0-rc.8` (`5bba06c86fc82b34b67cec607053948f8e00d0d1`). Root `scripts/`, root `tests/` and `evaluations/` were also unchanged before this preparation's representative-mapping row. Code (`packages/code`), web (`packages/web`) and desktop (`desktop`) are not identical to that tag.
17
+ - Carry the reviewed product changes on main after that tag: the same Code review screen for shell `--continue` and `/pending` ([PR201](https://github.com/Zhivex/zhivex-harness/pull/201)); removal of the desktop fixture waiting button ([PR203](https://github.com/Zhivex/zhivex-harness/pull/203)); B-lite review scope on web and desktop ([PR211](https://github.com/Zhivex/zhivex-harness/pull/211)); the Code status line, one-line summary and 48×24 first-welcome logo ([PR210](https://github.com/Zhivex/zhivex-harness/pull/210)); and the public README ([PR200](https://github.com/Zhivex/zhivex-harness/pull/200)). Packaged Harness docs `README.md` and `docs/CLI.md` differ from the rc.8 tag. `docs/CLI_UX.md` and `docs/images/approval-survives-restart.gif` also differ and are outside the Harness `files` list.
18
+ - Require fresh exact-source/artifact validation and separate explicit approval before any paid campaign, annotated tag or publication. Provider/API tiers remain unchanged. This preparation creates no tags and dispatches no release.
19
+
7
20
  ## 1.4.0-rc.8 - 2026-10-08
8
21
 
9
22
  - Prepare matched Harness 1.4.0-rc.8 and Code 0.3.0-rc.8 for npm `next`, with the exact Code engine pin, private Desktop binding and an additive representative mapping using unchanged models. Retain the SDK pins already on main (Core 1.31.0, Agents 1.11.0 and the existing provider packages). Stable `latest` stays Harness 1.3.0 and Code 0.2.0.
package/README.md CHANGED
@@ -1,110 +1,162 @@
1
- # Zhivex Harness
1
+ # Zhivex Code
2
2
 
3
- **Work on your code with an agent. Review consequential actions before approving them.**
3
+ [![npm @zhivex-ai/code](https://img.shields.io/npm/v/@zhivex-ai/code?label=npm%20%40zhivex-ai%2Fcode)](https://www.npmjs.com/package/@zhivex-ai/code)
4
+ [![CI](https://github.com/Zhivex/zhivex-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/Zhivex/zhivex-harness/actions/workflows/ci.yml)
5
+ [![License: MIT](https://img.shields.io/github/license/Zhivex/zhivex-harness)](LICENSE)
4
6
 
5
- Zhivex Harness is a local terminal assistant and TypeScript library. It supports
6
- OpenAI, Qwen and Meta, with provisional Gemini, Anthropic and Vertex support. Conversations and pending
7
- approvals survive restarts.
7
+ An open-source coding agent for your terminal. It asks before it edits or runs a check, and a pending approval is still there after you quit.
8
8
 
9
- Use it to understand a repository, discuss a design, investigate a failure or
10
- implement a change. Conversation context retains decisions, hypotheses and bounded
11
- diagnostic excerpts across compaction. Edits and command execution keep their
12
- own permission checks; a conversational summary never grants approval.
9
+ **Zhivex Code** ([`@zhivex-ai/code`](https://www.npmjs.com/package/@zhivex-ai/code)) is the product you install and run. **Zhivex Harness** ([`@zhivex-ai/harness`](https://www.npmjs.com/package/@zhivex-ai/harness)) is the engine underneath: a governed, provider-portable TypeScript runtime with durable approvals and isolated execution. MIT licensed.
13
10
 
14
- For the developer-facing terminal product, install
15
- `npm install -g @zhivex-ai/code@0.2.0` and run `zhivex-code` in your project.
16
- See [Code installation and first use](https://github.com/Zhivex/zhivex-harness/blob/main/packages/code/README.md). Harness remains
17
- the reusable engine and its compatibility CLI. The `/task` delivery workflow in
18
- this checkout is an unreleased experimental Code addition, not a published feature.
11
+ ## Approval survives a restart
19
12
 
20
- Version `1.3.0` is the current public npm release on `latest`, with terminal-independent engine
21
- entrypoints and the separately published Code CLI `0.2.0` on `latest`. Harness publication passed registry integrity and provenance verification. Harness `1.4.0-rc.6` and
22
- Code `0.3.0-rc.6` are published on `next`. Annotated `v1.4.0-rc.7` was tagged but
23
- not published after live certification failed. The RC.8 versions prepared in this
24
- checkout remain unpublished. Stable package numbering does
25
- not change API stability tiers: beta and experimental APIs retain their policies,
26
- Gemini/Anthropic/Vertex remain provisional, and Desktop remains a private alpha.
13
+ <!-- Recorded with zhivex-code. Scene: ask for a change, review the diff, leave the approval pending, quit,
14
+ then run `zhivex-code --continue` and show the same approval.
15
+ Inside the session, `/continue` starts a new run from an interrupted task;
16
+ the reopen step in this GIF is the `--continue` flag.
17
+ The file is docs/images/approval-survives-restart.gif. Do not add it to either package `files` list.
18
+ npm shows the absolute raw URL below. That URL resolves from main. -->
27
19
 
28
- ## Quick start
20
+ ![Approval survives a restart](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/docs/images/approval-survives-restart.gif)
21
+
22
+ ## Why it works this way
23
+
24
+ - **You approve the exact change.** Edits and checks wait for an explicit decision bound to that diff. A conversational summary leaves the change unapproved. If the file changed on your side, import fails closed.
25
+ - **The pending decision survives a restart.** Conversations and approvals are stored in SQLite. Quit the terminal, or reboot, and the same approval is waiting.
26
+ - **Your keys, your provider.** OpenAI, Qwen, and Meta pass the release gate. Gemini, Anthropic, and Vertex are provisional. The same CLI talks to each of them.
29
27
 
30
- Requires Node.js 22.13.0 or newer, Git and a provider API key.
28
+ ## Quick start
31
29
 
32
- Install the stable npm release (`latest`, currently `1.3.0`):
30
+ You need Node.js 22.13 or newer, Git, and a provider API key. Linux and macOS are supported. Windows is unsupported.
33
31
 
34
32
  ```sh
35
- npm install -g @zhivex-ai/harness@latest
33
+ npm install -g @zhivex-ai/code
36
34
  cd /path/to/your/project
37
- zhx
35
+ zhivex-code
38
36
  ```
39
37
 
40
- On first use, choose a provider and model, then enter your API key in the hidden
41
- prompt. Save it in the system keychain (macOS/Linux) or use it only for the current
42
- CLI session. Existing environment keys take precedence. See [First use](docs/FIRST_USE.md)
43
- and [Credentials](docs/CREDENTIALS.md) for setup and automation.
38
+ On first launch, choose a provider and model. If no key is already available, enter one in the hidden prompt and save it in the system keychain, or keep it for this session only. An existing environment variable takes precedence. The same prompts are documented for the engine command `zhx` in [First use](docs/FIRST_USE.md) and [Credentials](docs/CREDENTIALS.md).
44
39
 
45
40
  Try: “Explain this repository and suggest a small improvement.”
46
41
 
47
- Type `/` for common actions. `/model` changes the model, `/sessions` finds previous
48
- conversations, and `/diff` shows changes. Review requested actions before approving
49
- them. Ctrl+C stops active work; it does not undo completed changes.
42
+ Type `/` for common actions. `/model` changes the model, `/sessions` finds earlier conversations, and `/diff` shows workspace changes. Review each requested action before you approve it. Ctrl+C stops the active run. It leaves completed work in place.
43
+
44
+ | Command | Purpose |
45
+ | --- | --- |
46
+ | `zhivex-code` | Open the conversation |
47
+ | `zhivex-code --continue` | Reopen the latest conversation. A pending approval opens the review screen |
48
+ | `zhivex-code run "task"` | Run one task for a script |
49
+ | `zhivex-code doctor` | Check local configuration |
50
+ | `zhivex-code --help` | Short guide |
51
+ | `zhivex-code help all` | Full command reference |
52
+
53
+ `zhivex-code <command> --help` shows one command. Inside the session, `/help` lists everyday actions and `/help all` lists the rest.
54
+
55
+ ### Command names
56
+
57
+ Each package owns its own commands. Installing both leaves each command in place. Nothing here adds or renames a command.
58
+
59
+ | Package | Commands |
60
+ | --- | --- |
61
+ | `@zhivex-ai/code` | `zhivex-code` |
62
+ | `@zhivex-ai/harness` | `zhx` and `zhivex-harness` (the same engine CLI), plus `zhx-acp` for the experimental editor protocol |
50
63
 
51
- ## Release candidates
64
+ `zhx chat` remains a supported way to open the engine console.
52
65
 
53
- This checkout prepares Harness `1.4.0-rc.8` and Code `0.3.0-rc.8` for `next`, with an exact engine pin. Project memory, compact terminal review and the local browser workspace ship together after protected validation. See the [release procedure](https://github.com/Zhivex/zhivex-harness/blob/main/docs/RELEASE.md). RC.8 publication is pending. It includes the reviewed duplicate-delegation fix on main after RC.7. Published npm `next` is Harness `1.4.0-rc.6` and Code `0.3.0-rc.6`. Annotated `v1.4.0-rc.7` was tagged but not published after Qwen live certification failed; that source and tag cannot certify RC.8. The held RC.5 campaign and failed RC.4 attempt remain preserved. These prerelease candidates are separate from the stable `latest` channel.
66
+ ### A pending approval is still there
54
67
 
55
- Use candidates only for prerelease validation. Check [npm versions](https://www.npmjs.com/package/@zhivex-ai/harness?activeTab=versions)
56
- and the [release procedure](https://github.com/Zhivex/zhivex-harness/blob/main/docs/RELEASE.md)
57
- before installing a candidate; `next` can still point to an earlier RC.
68
+ Two different actions share the word “continue”:
58
69
 
59
- After publication of this exact candidate:
70
+ | Where | What you type | What happens |
71
+ | --- | --- | --- |
72
+ | Shell, after you quit | `zhivex-code --continue` | Reopens the latest conversation. A pending approval opens the review screen. |
73
+ | Inside the session | `/continue` | Starts a new run from an interrupted task and keeps the earlier results. |
74
+
75
+ `/continue` is the in-session command. The shell flag that reopens the latest conversation is `--continue`, on `zhivex-code` and on `zhx`. On `zhivex-code`, that screen is `r` Reject, `a` Approve N file(s), `d` Details, and Esc to decide later. A check uses `Approve 1 command` instead of the file label. `/pending` opens the same screen. A new turn waits until you decide. On `zhx`, `--continue` reopens and prints the pending approval; `/pending`, then `/approve` or `/deny`, decides it. `/continue` inside that session starts a new run.
76
+
77
+ ### Try it with no API key
78
+
79
+ The Code package includes an offline tutorial. It needs an interactive terminal. It makes no provider calls. Responses, token counts, and prices are synthetic.
60
80
 
61
81
  ```sh
62
- npm install -g @zhivex-ai/harness@1.4.0-rc.8
82
+ node "$(npm root -g)/@zhivex-ai/code/examples/first-use.mjs"
63
83
  ```
64
84
 
65
- ## A few commands are enough
85
+ The script prints the guided sequence and a command to reopen the same temporary workspace.
66
86
 
67
- | Command | Purpose |
87
+ ### Credentials
88
+
89
+ | Provider | What the CLI accepts |
68
90
  | --- | --- |
69
- | `zhx` | Open the conversation |
70
- | `zhx --continue` | Continue the latest conversation |
71
- | `zhx run "task"` | Run one task for automation |
72
- | `zhx doctor` | Diagnose local configuration |
73
- | `zhx --help` | Show the short guide |
91
+ | OpenAI | `OPENAI_API_KEY` |
92
+ | Qwen | `DASHSCOPE_API_KEY` or `QWEN_API_KEY` |
93
+ | Meta | `MODEL_API_KEY` |
94
+ | Gemini (provisional) | `GEMINI_API_KEY` or `GOOGLE_GENERATIVE_AI_API_KEY` |
95
+ | Anthropic (provisional) | `ANTHROPIC_API_KEY` |
96
+ | Vertex (provisional) | Application Default Credentials, plus `GOOGLE_CLOUD_PROJECT` and `VERTEX_LOCATION`. Code does not ask for a Vertex API key. |
74
97
 
75
- Use `zhx <command> --help` for command-specific options, or `zhx help all` for the
76
- complete reference. Existing `zhx chat` and `zhivex-harness` commands remain supported.
98
+ Use `/credentials` later to replace or remove a saved key. `zhivex-code doctor` reports whether a credential is present. It does not call the provider.
77
99
 
78
- ## CLI, library or Desktop?
100
+ ## What you can count on
79
101
 
80
- The npm package includes the CLI and TypeScript library. [Desktop](https://github.com/Zhivex/zhivex-harness/blob/main/desktop/README.md)
81
- is a separate Electron application, currently alpha for macOS Apple Silicon.
82
- It is not included in npm and has its own build and distribution process. Its local
83
- package is unsigned and unnotarized; automatic updates are disabled pending production trust setup and validation.
102
+ | | |
103
+ | --- | --- |
104
+ | Approval | Explicit, bound to the exact diff. Per-file changed regions are shown when a preview is available. |
105
+ | Durability | SQLite keeps the conversation and any pending approval across quit and reboot. |
106
+ | Secrets | `.env`, private keys, Git internals, and dependency directories stay out of model exploration. |
107
+ | Commands | The default runtime exposes no shell tools. Isolated commands need an explicitly configured Docker or Podman environment. |
108
+ | Where it runs | On your machine. Linux and macOS. |
84
109
 
85
- ## Permissions and limits
110
+ From a source checkout, `bun run demo:hostile` runs a reproducible hostile-repository demo (a malicious README and a decoy `.env`, with network denied). See [Hostile repository demonstration](docs/HOSTILE_REPOSITORY_DEMO.md). That demo needs a local build, Docker or Podman, and a preloaded image.
86
111
 
87
- Edits and checks require approval by default. Files such as `.env`, private keys,
88
- Git internals and dependency directories are excluded from model exploration.
89
- The default runtime has no OS isolation and exposes no shell-class tools. Running
90
- commands in isolation requires an explicitly configured Docker or Podman environment;
91
- see [Execution environments](docs/EXECUTION_ENVIRONMENTS.md).
112
+ ## Providers and platforms
92
113
 
93
- Gemini, [Anthropic](docs/ANTHROPIC.md) and [Vertex](docs/VERTEX.md) remain provisional. See the [support matrix](docs/SUPPORT_MATRIX.md) and
94
- [security policy](SECURITY.md) for supported configurations and reporting concerns.
114
+ Release-gated providers are OpenAI, Qwen, and Meta. **Gemini, Anthropic, and Vertex are provisional**: the integrations exist, and they do not yet have the same end-to-end release evidence. Details: [support matrix](docs/SUPPORT_MATRIX.md), [Anthropic](docs/ANTHROPIC.md), [Vertex](docs/VERTEX.md).
115
+
116
+ | Area | Status |
117
+ | --- | --- |
118
+ | Operating systems | Linux and macOS. Windows is unsupported. |
119
+ | Runtime | Node.js 22.13 or newer. Bun is contributor tooling. |
120
+ | MCP | Bounded Streamable HTTP is supported. stdio is outside the default CLI. An experimental host-only path can launch stdio servers in Docker; see [Isolated MCP stdio](docs/MCP_STDIO.md). |
121
+ | Editor protocol | `zhx-acp` is an experimental ACP subset: text sessions, one-time permissions, and cancellation. Output is buffered until the run finishes. ACP cannot load or resume a session. See [ACP](docs/ACP.md). |
122
+ | Isolated commands | Docker on Linux is supported. Podman is provisional. See [Execution environments](docs/EXECUTION_ENVIRONMENTS.md). |
123
+ | Desktop | Separate private alpha for macOS Apple Silicon. Unsigned, and not part of the npm package. See [Desktop](https://github.com/Zhivex/zhivex-harness/blob/main/desktop/README.md). |
124
+
125
+ ## Use the engine as a library
126
+
127
+ Code is the terminal product and has no public library API. Harness is the embeddable runtime. Hosts construct it, supply credentials, and resolve approvals:
128
+
129
+ ```ts
130
+ import { createHarness } from "@zhivex-ai/harness/engine";
131
+ import { createHarnessClientAdapter } from "@zhivex-ai/harness/client";
132
+
133
+ const harness = await createHarness({
134
+ workspace: "/absolute/path/to/project",
135
+ provider: "openai",
136
+ model: "your-supported-model"
137
+ });
138
+ const client = await createHarnessClientAdapter(harness);
139
+ try {
140
+ // Dispatch with the client protocol. Approve each consequential action explicitly.
141
+ } finally {
142
+ client.close();
143
+ await harness.close();
144
+ }
145
+ ```
146
+
147
+ Contracts, stability tiers, and the experimental ACP and MCP entry points are in the [engine API](docs/ENGINE_API.md).
95
148
 
96
149
  ## Documentation
97
150
 
98
- - **Users:** [First use](docs/FIRST_USE.md), [daily workflow](docs/CLI.md#interactive-daily-workflow), [usage reference](docs/USAGE.md).
99
- - **Integrators:** [CLI contracts](docs/CLI.md), [extensibility](docs/EXTENSIBILITY.md), [API stability](docs/STABILITY.md).
100
- - **Contributors:** [Development](https://github.com/Zhivex/zhivex-harness/blob/main/CONTRIBUTING.md) and [maintenance](https://github.com/Zhivex/zhivex-harness/blob/main/docs/MAINTENANCE.md).
151
+ - **Using Code:** [Code package notes](https://github.com/Zhivex/zhivex-harness/blob/main/packages/code/README.md), [first use](docs/FIRST_USE.md), [daily workflow](docs/CLI.md#interactive-daily-workflow), [usage reference](docs/USAGE.md).
152
+ - **Integrating Harness:** [engine API](docs/ENGINE_API.md), [CLI contracts](docs/CLI.md), [extensibility](docs/EXTENSIBILITY.md), [API stability](docs/STABILITY.md).
153
+ - **Limits:** [support matrix](docs/SUPPORT_MATRIX.md), [security policy](SECURITY.md).
154
+ - **Contributing:** [development](https://github.com/Zhivex/zhivex-harness/blob/main/CONTRIBUTING.md) and [maintenance](https://github.com/Zhivex/zhivex-harness/blob/main/docs/MAINTENANCE.md).
155
+
156
+ [Browse the documentation index](docs/README.md).
101
157
 
102
- [Browse documentation](docs/README.md).
158
+ ## Releases
103
159
 
104
- Version `1.3.0` is the current public npm release. Source checkout changes can be
105
- newer than the published package. Consult the [changelog](CHANGELOG.md) and
106
- [repository release status](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/release-status.json)
107
- for the verified 1.3.0 publication; [release evidence](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md)
108
- records validation scope and limitations.
160
+ Version `1.3.0` is the current public npm release. The paired Code package on npm `latest` is `0.2.0`. This checkout prepares Version `1.4.0` and Code `0.3.0` for `latest`. That publication is pending, so the quick start above follows the published `latest` tag. npm `next` is Harness `1.4.0-rc.8` and Code `0.3.0-rc.8`. Confirm dist-tags on the [Code versions](https://www.npmjs.com/package/@zhivex-ai/code?activeTab=versions) and [Harness versions](https://www.npmjs.com/package/@zhivex-ai/harness?activeTab=versions) pages before you install a prerelease.
109
161
 
110
- Experimental next-version work includes [project memory](docs/PROJECT_MEMORY.md): explicit, reviewable notes scoped to one project, with bounded retrieval and deletion controls.
162
+ Release channels, publication, and certification records are in the [release procedure](https://github.com/Zhivex/zhivex-harness/blob/main/docs/RELEASE.md). Releases are verified with npm provenance. Source in this checkout can be newer than the public package. See the [changelog](CHANGELOG.md) and the [repository release status](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/release-status.json).
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 `1.3.x` patch of Harness and the latest stable Code `0.1.x` patch. RCs on `next` are validation candidates; older minors and private checkpoints are not supported release channels. Desktop remains a separate private alpha. Beta and experimental features retain their documented limitations. Registry integrity and provenance do not substitute for the separate provider and execution evidence recorded in [docs/LIVE_CERTIFICATION.md](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md).
5
+ Security fixes are provided for the latest published `1.3.x` patch of Harness and the latest stable Code `0.2.x` patch. Harness `1.4.x` and Code `0.3.x` are supported only after verified publication. RCs on `next` are validation candidates; older minors and private checkpoints are not supported release channels. Desktop remains a separate private alpha. Beta and experimental features retain their documented limitations. Registry integrity and provenance do not substitute for the separate provider and execution evidence recorded in [docs/LIVE_CERTIFICATION.md](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md).
6
6
 
7
7
  ## Reporting a vulnerability
8
8
 
package/SUPPORT.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Support
2
2
 
3
- Zhivex Harness `1.3.x` is the latest supported Node-first CLI and TypeScript library. Stable 1.x contracts follow [the stability policy](./docs/STABILITY.md); incompatible changes require a major release except documented urgent security corrections. Beta and experimental surfaces retain their declared policies. The mutable machine-readable `release-status.json` record records the verified 1.3.0 publication. Harness 1.3.0 and Code 0.1.0 are published and verified on latest through their protected workflows.
3
+ Zhivex Harness `1.3.x` is the latest supported Node-first CLI and TypeScript library. Stable 1.x contracts follow [the stability policy](./docs/STABILITY.md); incompatible changes require a major release except documented urgent security corrections. Beta and experimental surfaces retain their declared policies. The mutable machine-readable `release-status.json` record records the verified 1.3.0 publication. Harness 1.4.0 and Code 0.3.0 are prepared for latest but remain pending their protected workflows. Harness 1.3.0 and Code 0.2.0 stay the published latest packages.
4
4
 
5
5
  The 1.1 support scope is tracked in the [machine-readable support matrix](./docs/support-matrix-1.1.json) and its [human-readable view](./docs/SUPPORT_MATRIX_1_1.md). The [1.0 matrix](./docs/SUPPORT_MATRIX.md) remains historical. Compatibility and removals follow [DEPRECATIONS.md](./docs/DEPRECATIONS.md) for the published 1.x line.
6
6
 
@@ -13,7 +13,7 @@ The 1.1 support scope is tracked in the [machine-readable support matrix](./docs
13
13
  - the provider/model combinations marked certified in the package documentation; and
14
14
  - HTTPS or explicitly allowed loopback-HTTP MCP endpoints using the documented bounded JSON-RPC subset.
15
15
 
16
- Only the most recent published stable minor receives routine fixes. The exact `v1.3.0` tag passed the protected artifact, six-provider live and 42-case representative release jobs. Harness 1.3.x and Code 0.1.x are the supported stable lines. Gemini, Anthropic and Vertex remain provisional despite the release-bound live gates; the representative repository matrix covers only Meta, Qwen and OpenAI. Live provider evidence is account-, model-, endpoint-, artifact-, and date-dependent; see [docs/LIVE_CERTIFICATION.md](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md).
16
+ Only the most recent published stable minor receives routine fixes. The exact `v1.3.0` tag passed the protected artifact, six-provider live and 42-case representative release jobs. Harness 1.3.x and Code 0.2.x are the supported stable lines until 1.4.0 and Code 0.3.0 complete verified publication. Gemini, Anthropic and Vertex remain provisional despite the release-bound live gates; the representative repository matrix covers only Meta, Qwen and OpenAI. Live provider evidence is account-, model-, endpoint-, artifact-, and date-dependent; see [docs/LIVE_CERTIFICATION.md](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md).
17
17
 
18
18
  ## Installation diagnostics
19
19
 
package/dist/acp-cli.js CHANGED
@@ -5,27 +5,27 @@ import {
5
5
  parseHarnessModelRoute,
6
6
  resolveHarnessModelRoutes,
7
7
  validateCliCommandOptions
8
- } from "./index-pcn2bk8j.js";
8
+ } from "./index-61gthdz6.js";
9
9
  import {
10
10
  serveAcpStdio
11
11
  } from "./index-3ah1f369.js";
12
12
  import {
13
13
  createHarnessClientAdapter
14
- } from "./index-txrqqd2r.js";
15
- import"./index-sbzvrpm7.js";
14
+ } from "./index-937cb7y8.js";
15
+ import"./index-6dft2vev.js";
16
16
  import {
17
17
  createHarness
18
- } from "./index-nqhnh1hz.js";
18
+ } from "./index-pp474137.js";
19
19
  import {
20
20
  usagePricingSchema
21
- } from "./index-fny13znr.js";
22
- import"./index-w9pjt7td.js";
21
+ } from "./index-s2k2edts.js";
22
+ import"./index-pdmevfxv.js";
23
23
  import {
24
24
  FileChangedWhileReadingError,
25
25
  FileSizeLimitError,
26
26
  UnsafeFileTypeError,
27
27
  readRegularFileNoFollow
28
- } from "./index-zmx264xy.js";
28
+ } from "./index-m34q25jj.js";
29
29
  import {
30
30
  HARNESS_REQUIRED_CAPABILITIES,
31
31
  HARNESS_SUBAGENT_PROFILES,
@@ -35,14 +35,15 @@ import {
35
35
  providerDescriptor,
36
36
  reasoningEffortSchema,
37
37
  resolveHarnessConfig
38
- } from "./index-09zphhwt.js";
39
- import"./index-8705zxpr.js";
38
+ } from "./index-8zjmnyw5.js";
39
+ import"./index-m49jx72n.js";
40
40
  import"./index-xqxeypt5.js";
41
- import"./index-ngg2168h.js";
41
+ import"./index-nmjdwd4p.js";
42
42
  import {
43
43
  HarnessConfigError,
44
44
  HarnessError
45
- } from "./index-jdb1q8yn.js";
45
+ } from "./index-bpc596v3.js";
46
+ import"./index-fm84men1.js";
46
47
  import {
47
48
  __require
48
49
  } from "./index-1bx83sw4.js";
@@ -926,7 +927,7 @@ var parseCliArgs = (argv) => {
926
927
 
927
928
  // src/cli/cli-credentials.ts
928
929
  async function credentialModel(config, env, modelFactory) {
929
- const { createProviderModel: createProviderModel2 } = await import("./config-depqpsae.js");
930
+ const { createProviderModel: createProviderModel2 } = await import("./config-qt69hkqj.js");
930
931
  const { wrapLanguageModel } = await import("@zhivex-ai/core");
931
932
  const secrets = providerDescriptor(config.provider).credentialNames.map((name) => env[name]).filter((value) => !!value);
932
933
  const safeError = (error) => {
@@ -124,14 +124,14 @@ import {
124
124
  withTemporaryHarnessProfiles,
125
125
  workspaceCheckpointSchema,
126
126
  workspaceRestoreOperationSchema
127
- } from "./cli-entry-25xefnws.js";
127
+ } from "./cli-entry-4ngptr62.js";
128
128
  import {
129
129
  BUN_ENGINE_RANGE,
130
130
  HARNESS_VERSION,
131
131
  NODE_ENGINE_RANGE,
132
132
  formatCliHelp,
133
133
  shortCliHelp
134
- } from "./cli-entry-qav71mxw.js";
134
+ } from "./cli-entry-w0hterjs.js";
135
135
  import {
136
136
  DEFAULT_PROVIDER_REGISTRY,
137
137
  HARNESS_SUBAGENT_PROFILES,
@@ -147,7 +147,7 @@ import {
147
147
  providerDescriptor,
148
148
  reasoningEffortSchema,
149
149
  resolveHarnessConfig
150
- } from "./cli-entry-yqwa1943.js";
150
+ } from "./cli-entry-20w6nh0k.js";
151
151
  import {
152
152
  __require
153
153
  } from "./cli-entry-1bx83sw4.js";
@@ -4488,7 +4488,7 @@ var main = async (argv = process.argv.slice(2)) => {
4488
4488
  parsedOptions = { ...parsedOptions, prompt: await readStdinTask() };
4489
4489
  }
4490
4490
  if (parsedOptions.serviceFile) {
4491
- const { runServiceCli } = await import("./service-client-cli-ra3yzvjg.js");
4491
+ const { runServiceCli } = await import("./service-client-cli-fn54ev6w.js");
4492
4492
  await runServiceCli(parsedOptions, annotateCliStreamError);
4493
4493
  return;
4494
4494
  }