@zhivex-ai/harness 1.3.0 → 1.4.0-rc.6

package/CHANGELOG.md

@@ -4,6 +4,62 @@ All notable changes to Zhivex Harness are documented in this file.
 
 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.
 
+## 1.4.0-rc.6 - 2026-10-05
+
+- Prepare matched Harness 1.4.0-rc.6 and Code 0.3.0-rc.6 for npm `next`, with the exact Code engine pin, private Desktop binding and an additive representative mapping using unchanged models and SDK pins.
+- Include the reviewed activity projection fix from PR185: compact bounded UI snapshot previews without failing valid runs, preserve run identities/statuses and truncation markers, and split already-redacted streamed text into bounded Unicode-safe events. Durable policy/event journals, retention limits and approval authority are unchanged.
+- Preserve the held RC.5 campaign and immutable tag/source. Its passing offline, live and 42/42 representative evidence belongs to the older artifact and does not certify RC.6. Keep the RC.4 failure history and SDK store migration requirements.
+- Require fresh exact-source/artifact validation and separate explicit approval before any paid campaign, annotated tag or publication. Stable `latest` channels and provider/API tiers remain unchanged.
+
+## 1.4.0-rc.5 - 2026-10-05
+
+- Prepare matched Harness 1.4.0-rc.5 and Code 0.3.0-rc.5 for npm `next`, with the exact engine pin, Desktop binding and a new representative mapping using unchanged models and SDK pins.
+- Include the reviewed inherited-pipe termination regression correction: account for the existing cleanup grace and verify that the descendant heartbeat stops. Production termination protections are unchanged.
+- Carry the reviewed Desktop lucide-react 1.50.0 update from main. Keep Desktop private alpha and retain all provider and API tiers.
+- Preserve the immutable RC.4 tag and its failed offline campaign. Require a new exact artifact, unchanged protected gates and separate approval for any new paid campaign or publication.
+
+The RC.4 SDK store migration requirements below still apply.
+
+## 1.4.0-rc.4 - 2026-10-05
+
+- Integrate published Core 1.30.1, Agents 1.10.3, Anthropic 0.13.2, OpenAI 0.14.1, Qwen 0.16.4 and Vertex 1.2.4. Keep Meta 0.2.9 and Gemini 0.13.0; align Code and browser contributor pins and retain a single Core runtime in Harness.
+- Prepare matched Harness 1.4.0-rc.4 and Code 0.3.0-rc.4 for npm `next`, with an exact engine pin, Desktop binding and a new representative mapping using unchanged models. Retain immutable RC.2/RC.3 evidence and all protected gates.
+- Preserve Core 1.30.1 canonical identities and memory envelopes through backup/import, retaining verified legacy runs and rejecting mismatched identities. Finalize cooperative cancellation after the worker drains so session reads do not strand at `cancel_requested`.
+- Record bounded continuity response shape, streamed event counts and usage for the next failed phase without retaining provider text. This does not identify or resolve the historical RC.3 Meta cause.
+
+- Extend experimental task acceptance to bounded native reviewed edits and declared package-script checks, tying receipts to selected/protected file digests and the manifest. Block other effect tools and delegation for native task runs. Preserve the separate SDK run status and pending human review.
+- Add a redacted recorded-check projection to beta run-result JSON and experimental Code host helpers. Stable declaration snapshots and Harness run/session/backup schemas are unchanged.
+- Carry forward Meta SDK 0.2.9 reasoning usage as a subset of output tokens, without adding it again to totals.
+
+Migration: stop all workers sharing an SDK store and upgrade them together, keeping a complete backup. Core 1.30.1 uses canonical identities for new runs; verified legacy runs retain their physical keys. Older workers cannot resolve new identities. Legacy default SDK memory without verified ownership requires explicit offline migration; do not rewrite IDs/scopes to bypass validation. See [SDK store migration](https://github.com/Zhivex/zhivex-ai-sdk/blob/4a93004395a80c183b1257bb1d02fb3a3d4050e1/docs/maintainers/AGENT_STORE_MIGRATION.md). Runs without a task contract retain their behavior. Native task contracts now enforce their edit/check tool scope and may report `pending_review`/`verified` when their watched-file requirements pass; they do not receive OCI sandbox, whole-snapshot or import guarantees. Check evidence remains invalid after watched-file drift or uncertain journal recovery.
+
+## 1.4.0-rc.3 - 2026-10-04
+
+- Retain finite stage, assertion and provider-route identities in mixed-routing release diagnostics, preserve typed operational causes across artifact class boundaries, and keep cleanup failures from masking the original gate failure. Add offline fault coverage; historical release evidence remains unchanged.
+
+- Prepare matched Harness 1.4.0-rc.3 and Code 0.3.0-rc.3 for npm `next`, preserving the complete certification workflow, model pins and provider support tiers. Keep RC.2 tags, retained artifacts and failed evidence immutable; RC.3 requires fresh source-bound artifact, OCI, live and representative gates.
+
+## 1.4.0-rc.2 - 2026-10-04
+
+- Recover bounded prior assistant reports and plans through `read_task` after local session compaction, including immediate manual compaction of the first report and continued sessions after reconnect or host restart. Keep recovered text untrusted and separate from operator requests, approvals and acceptance evidence.
+
+- Prepare the matched Harness 1.4.0-rc.2 and Code 0.3.0-rc.2 for npm `next`, retaining exact engine pins, historical model mappings and provider support tiers. Publication requires new release-bound artifact, OCI, live and representative gates.
+
+## 1.4.0-rc.1 - 2026-10-04
+
+- Add experimental, project-scoped operator memory in the existing SQLite memory table, with explicit corrections/deletion, reviewed suggestions, provenance, freshness and bounded per-request retrieval.
+- Add local `memory` commands and `--no-memory` to Harness/Code without terminal layout changes. Curated mode stops automatic last-assistant capture; the stable engine default and explicit SDK memory integrations remain supported.
+- Preserve old state and import compatibility; document active deletion versus separately retained histories/backups and next-release engine pairing. See [Project memory](docs/PROJECT_MEMORY.md). Published to npm `next` on 2026-10-04.
+
+- Pair with Code 0.3.0-rc.1 for compact terminal flow, pageable approval review and the local browser workspace with packaged assets. Publish Harness first to `next`; preserve stable `latest`.
+
+## Code 0.2.0 - 2026-10-03
+
+- Prepare the independent Code package at 0.2.0, pinned to published Harness 1.3.0. Harness stays at 1.3.0.
+- Include guided approval diffs, reviewed checkpoints, per-run estimated budgets and a Node-only offline tutorial from PR158; estimates are not guaranteed financial caps.
+- Fix exact Code payload inspection, add deterministic packaging regressions, require exact-main installed journeys, and validate the retained release tarball with offline PTY acceptance.
+- See [Code changelog](https://github.com/Zhivex/zhivex-harness/blob/main/packages/code/CHANGELOG.md) for migration notes and publication status.
+
 ## 1.3.0 - 2026-10-02
 
 - Prepare Harness 1.3.0 and the independent Code CLI 0.1.0 for protected publication to npm `latest`; Code pins exactly Harness 1.3.0 and must publish after its verified engine dependency.

package/README.md

@@ -11,10 +11,16 @@ implement a change. Conversation context retains decisions, hypotheses and bound
 diagnostic excerpts across compaction. Edits and command execution keep their
 own permission checks; a conversational summary never grants approval.
 
-Version `1.3.0` is prepared for npm `latest`, with terminal-independent engine
-entrypoints and the separately released Code CLI `0.1.0`. Publication remains
-pending the protected workflow. Harness `1.2.0` is currently published on `latest`;
-Harness RC7 and Code RC2 are published on `next`. Stable package numbering does
+For the developer-facing terminal product, install
+`npm install -g @zhivex-ai/code@0.2.0` and run `zhivex-code` in your project.
+See [Code installation and first use](https://github.com/Zhivex/zhivex-harness/blob/main/packages/code/README.md). Harness remains
+the reusable engine and its compatibility CLI. The `/task` delivery workflow in
+this checkout is an unreleased experimental Code addition, not a published feature.
+
+Version `1.3.0` is the current public npm release on `latest`, with terminal-independent engine
+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.1` and
+Code `0.3.0-rc.1` are published on `next`. The RC.6 versions prepared in this
+checkout remain unpublished. Stable package numbering does
 not change API stability tiers: beta and experimental APIs retain their policies,
 Gemini/Anthropic/Vertex remain provisional, and Desktop remains a private alpha.
 
@@ -22,10 +28,10 @@ Gemini/Anthropic/Vertex remain provisional, and Desktop remains a private alpha.
 
 Requires Node.js 22.13.0 or newer, Git and a provider API key.
 
-After protected publication of 1.3.0:
+Install the stable npm release (`latest`, currently `1.3.0`):
 
 ```sh
-npm install -g @zhivex-ai/harness@1.3.0
+npm install -g @zhivex-ai/harness@latest
 cd /path/to/your/project
 zhx
 ```
@@ -41,6 +47,20 @@ Type `/` for common actions. `/model` changes the model, `/sessions` finds previ
 conversations, and `/diff` shows changes. Review requested actions before approving
 them. Ctrl+C stops active work; it does not undo completed changes.
 
+## Release candidates
+
+This checkout prepares Harness `1.4.0-rc.6` and Code `0.3.0-rc.6` 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.6 publication is pending. It includes the reviewed bounded activity snapshot fix; RC.5 remains held and its source/tag cannot be reused for this fix. The failed RC.4 attempt and immutable source are preserved; npm `next` currently points to Harness `1.4.0-rc.1` and Code `0.3.0-rc.1`. These prerelease candidates are separate from the stable `latest` channel.
+
+Use candidates only for prerelease validation. Check [npm versions](https://www.npmjs.com/package/@zhivex-ai/harness?activeTab=versions)
+and the [release procedure](https://github.com/Zhivex/zhivex-harness/blob/main/docs/RELEASE.md)
+before installing a candidate; `next` can still point to an earlier RC.
+
+After publication of this exact candidate:
+
+```sh
+npm install -g @zhivex-ai/harness@1.4.0-rc.6
+```
+
 ## A few commands are enough
 
 | Command | Purpose |
@@ -80,8 +100,10 @@ Gemini, [Anthropic](docs/ANTHROPIC.md) and [Vertex](docs/VERTEX.md) remain provi
 
 [Browse documentation](docs/README.md).
 
-Version `1.2.0` is the current stable public npm release. Source checkout changes can be
+Version `1.3.0` is the current public npm release. Source checkout changes can be
 newer than the published package. Consult the [changelog](CHANGELOG.md) and
 [repository release status](https://raw.githubusercontent.com/Zhivex/zhivex-harness/main/release-status.json)
-for the verified 1.2.0 publication; [release evidence](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md)
+for the verified 1.3.0 publication; [release evidence](https://github.com/Zhivex/zhivex-harness/blob/main/docs/LIVE_CERTIFICATION.md)
 records validation scope and limitations.
+
+Experimental next-version work includes [project memory](docs/PROJECT_MEMORY.md): explicit, reviewable notes scoped to one project, with bounded retrieval and deletion controls.

package/SECURITY.md

@@ -2,7 +2,7 @@
 
 ## Supported versions
 
-Security fixes are provided for the latest published stable Harness minor (currently `1.2.x`; `1.3.x` after verified publication) and the latest stable Code `0.1.x` patch after its 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).
+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).
 
 ## Reporting a vulnerability
 

package/SUPPORT.md

@@ -1,6 +1,6 @@
 # Support
 
-Zhivex Harness `1.2.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.2.0 publication. Harness 1.3.0 and Code 0.1.0 are prepared for latest but remain pending their protected workflows.
+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.
 
 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.
 
@@ -13,7 +13,7 @@ The 1.1 support scope is tracked in the [machine-readable support matrix](./docs
 - the provider/model combinations marked certified in the package documentation; and
 - HTTPS or explicitly allowed loopback-HTTP MCP endpoints using the documented bounded JSON-RPC subset.
 
-Only the most recent published stable minor receives routine fixes. The exact `v1.2.0` tag passed the protected artifact, live-provider and representative release jobs. After verified publication, 1.3.x and Code 0.1.x become the supported stable lines. Gemini, Anthropic and Vertex remain provisional despite RC7 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).
+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).
 
 ## Installation diagnostics
 

package/contracts/engine-api.json

@@ -6,6 +6,56 @@
       "source": "src/engine/index.ts",
       "environment": "node",
       "exports": [
+        {
+          "name": "HARNESS_PROJECT_MEMORY_SCHEMA_VERSION",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "HARNESS_PROJECT_MEMORY_LIMITS",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "openHarnessProjectMemory",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "HarnessProjectMemory",
+          "kind": "type",
+          "tier": "experimental"
+        },
+        {
+          "name": "HarnessProjectMemoryEntry",
+          "kind": "type",
+          "tier": "experimental"
+        },
+        {
+          "name": "HarnessProjectMemoryInput",
+          "kind": "type",
+          "tier": "experimental"
+        },
+        {
+          "name": "HarnessProjectMemoryOptions",
+          "kind": "type",
+          "tier": "experimental"
+        },
+        {
+          "name": "HarnessProjectMemoryView",
+          "kind": "type",
+          "tier": "experimental"
+        },
+        {
+          "name": "HARNESS_MEMORY_COMMANDS",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "executeHarnessMemoryCommand",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
         {
           "name": "DEFAULT_ALLOWED_CHECKS",
           "kind": "runtime",
@@ -2665,6 +2715,26 @@
           "name": "readRegularFileNoFollow",
           "kind": "runtime",
           "tier": "experimental"
+        },
+        {
+          "name": "resolvePackageCheckCommand",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "nativeTaskSnapshot",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "TASK_ACCEPTANCE_EVIDENCE_KEY",
+          "kind": "runtime",
+          "tier": "experimental"
+        },
+        {
+          "name": "checkEvidence",
+          "kind": "runtime",
+          "tier": "experimental"
         }
       ]
     },

package/contracts/public-api.json

@@ -906,6 +906,7 @@
       "checkpoints",
       "changes",
       "state",
+      "memory",
       "help",
       "version"
     ],
@@ -975,6 +976,7 @@
         "allowed": [
           "--service",
           "--session",
+          "--no-memory",
           "--compaction-model",
           "--compaction-provider",
           "--tool-policy",
@@ -1122,6 +1124,7 @@
       "chat": {
         "allowed": [
           "--service",
+          "--no-memory",
           "--compaction-model",
           "--compaction-provider",
           "--tool-policy",
@@ -1237,6 +1240,7 @@
       "policy": {
         "allowed": [
           "--service",
+          "--no-memory",
           "--compaction-model",
           "--compaction-provider",
           "--tool-policy",
@@ -1398,6 +1402,7 @@
       },
       "resume": {
         "allowed": [
+          "--no-memory",
           "--tool-policy",
           "--service",
           "--session",
@@ -1771,6 +1776,163 @@
         "repeatable": [],
         "conflicts": {}
       },
+      "memory:remember": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json",
+          "--source"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:suggest": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json",
+          "--source"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:list": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:read": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:update": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json",
+          "--source"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:forget": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:accept": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:clear": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:enable": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:disable": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
+      "memory:context": {
+        "allowed": [
+          "--workspace",
+          "--state-dir",
+          "--store",
+          "--tenant",
+          "--user",
+          "--namespace",
+          "--json"
+        ],
+        "required": [],
+        "repeatable": [],
+        "conflicts": {}
+      },
       "state:status": {
         "allowed": [
           "--workspace",

package/contracts/stable-api-signatures.json

@@ -13,7 +13,7 @@
     },
     {
       "name": "CLI_COMMAND_OPTION_CONTRACTS",
-      "sha256": "sha256:70276d37fde1bb3f48c953a82ce137b6b2887753118586717077f1c6eb5d08a6"
+      "sha256": "sha256:0ea9c36f10d66fa7f4b5dc3c1d500d12f1e2f80c14d65125d3349980a1f2e192"
     },
     {
       "name": "CLI_EVENT_SCHEMA_VERSION",
@@ -25,11 +25,11 @@
     },
     {
       "name": "CLI_OPTION_DEFINITIONS",
-      "sha256": "sha256:3f9a3159e27e86ceadaa64aabc97ae3f6c8cbe98d03098dfbe3076e6f07460e8"
+      "sha256": "sha256:369aa10cdaaab6721aacb248c99fa0f33d6b47a2135b7f7b64312fa2da4e5e59"
     },
     {
       "name": "CLI_OPTION_NAMES",
-      "sha256": "sha256:389d1612d9eca7df782fc865344b1651e21023a27d0e9180d493d6d915cf793d"
+      "sha256": "sha256:7dd7e64d26a693a5aff7366a9c3a0197eee33cda5da93ff2e5c1a577d00d4bb8"
     },
     {
       "name": "DEFAULT_ALLOWED_CHECKS",
@@ -165,7 +165,7 @@
     },
     {
       "name": "createHarness",
-      "sha256": "sha256:4b2a4e758dd0aef816771f5324758abbea04a13c12530f1ee83daeab439e6e73"
+      "sha256": "sha256:b237f9c2a28c01dbc7e929afd2195af7082bb5533020bf151eba16a5626eba61"
     },
     {
       "name": "createHarnessMcpTools",
@@ -289,7 +289,7 @@
     },
     {
       "name": "validateCliCommandOptions",
-      "sha256": "sha256:eed6e681ab10a33c4f762b08d944a46b321da474763708f6354f45e6e41de087"
+      "sha256": "sha256:db01336efeae394b41ff8585f9c8a496f4dc2a0b98a2b7c581435773939186ed"
     },
     {
       "name": "verifyChangeEnvelope",
@@ -311,7 +311,7 @@
     },
     {
       "name": "CliCommandOptionContractKey",
-      "sha256": "sha256:aa76f78f6e8f82b5d01a3bb1a3cb24ed090cca69ca91a26774f0d88943a324e5"
+      "sha256": "sha256:f8d27a7efeac758dea77cde2c92806815db92d91ac18a1173f67f2e2062875d6"
     },
     {
       "name": "CliInitDocument",
@@ -331,7 +331,7 @@
     },
     {
       "name": "CliOptionName",
-      "sha256": "sha256:4f9f167f8dc6106edb7c5df0904ebabc70407b1d9bf09b4a6ffbdfe6769d6aa5"
+      "sha256": "sha256:70faf9b4c1b10264dd8ac85a87aef4d66871eae592118a29469c79addd024d22"
     },
     {
       "name": "CliReviewGroupDocument",
@@ -375,7 +375,7 @@
     },
     {
       "name": "CreateHarnessOptions",
-      "sha256": "sha256:1be891ae7f190c9b2d03c3e72723f3384c6115fb6f4b83da79c7c710193eab70"
+      "sha256": "sha256:596b95a410a0bd84feb53ae0188177c934b1f7432c155684f7d33e9d49fff898"
     },
     {
       "name": "HarnessBudget",
@@ -490,5 +490,5 @@
       "sha256": "sha256:76de0209fbf835d1427b6ab2764a919e8e814237a1be7b15c9bc0dc002f8fd6e"
     }
   ],
-  "digest": "sha256:6ce71e29460e14ee146eff67d5877129d13cef3817ed9148c0ba46ce15ede59e"
+  "digest": "sha256:0c2cec6bd1dd8de467e8619c18b25e48d56416dec1866ff5a124798525b1a52b"
 }

package/dist/acp-cli.js

@@ -5,27 +5,27 @@ import {
   parseHarnessModelRoute,
   resolveHarnessModelRoutes,
   validateCliCommandOptions
-} from "./index-2jrdcj6b.js";
+} from "./index-wq2tax80.js";
 import {
   serveAcpStdio
 } from "./index-3ah1f369.js";
 import {
   createHarness,
   createHarnessClientAdapter
-} from "./index-hnaxfpb5.js";
-import"./index-h0mqx2ed.js";
-import"./index-8zzhggxv.js";
+} from "./index-4j1h4j8c.js";
+import"./index-rd0s3gqj.js";
+import"./index-a1q355va.js";
 import {
   usagePricingSchema
-} from "./index-42gp2hy8.js";
-import"./index-azmwjp95.js";
-import"./index-z0qxmkm2.js";
+} from "./index-vtqfjnab.js";
+import"./index-0g939pfs.js";
+import"./index-e6r04a18.js";
 import {
   FileChangedWhileReadingError,
   FileSizeLimitError,
   UnsafeFileTypeError,
   readRegularFileNoFollow
-} from "./index-yb239ghk.js";
+} from "./index-r0tdj04h.js";
 import {
   HARNESS_REQUIRED_CAPABILITIES,
   HARNESS_SUBAGENT_PROFILES,
@@ -51,6 +51,17 @@ import { fileURLToPath } from "node:url";
 
 // src/cli/cli-help.ts
 var usage = {
+  "memory:remember": 'zhx memory remember "content" [--source "provenance"]',
+  "memory:suggest": 'zhx memory suggest "content" [--source "provenance"]',
+  "memory:list": "zhx memory list",
+  "memory:read": "zhx memory read <id>",
+  "memory:update": 'zhx memory update <id> <revision> "content" [--source "provenance"]',
+  "memory:forget": "zhx memory forget <id> <revision>",
+  "memory:accept": "zhx memory accept <id> <reviewedRevision>",
+  "memory:clear": "zhx memory clear",
+  "memory:enable": "zhx memory enable",
+  "memory:disable": "zhx memory disable",
+  "memory:context": 'zhx memory context "query"',
   "checkpoints:storage": "zhx checkpoints storage",
   "checkpoints:prune-review": "zhx checkpoints prune-review <checkpoint:id|restore:id> [...]",
   "checkpoints:prune-apply": "zhx checkpoints prune-apply <reviewedPlanId> <checkpoint:id|restore:id> [...]",
@@ -217,7 +228,7 @@ var applyCliProfile = async (options, context = {}) => {
 };
 
 // src/cli/arguments.ts
-var CLI_COMMANDS = ["init", "run", "review", "chat", "providers", "doctor", "policy", "resume", "runs", "sessions", "checkpoints", "changes", "state", "help", "version"];
+var CLI_COMMANDS = ["init", "run", "review", "chat", "providers", "doctor", "policy", "resume", "runs", "sessions", "checkpoints", "changes", "state", "memory", "help", "version"];
 var CLI_RUNS_COMMANDS = ["list", "inspect", "cancel", "cleanup", "export", "report"];
 var CLI_SESSIONS_COMMANDS = ["list", "inspect", "rename", "fork", "archive"];
 var CLI_CHANGES_COMMANDS = ["create", "verify"];
@@ -254,7 +265,7 @@ var optionValue = (argv, index, name) => {
   return value;
 };
 var parseCliArgs = (argv) => {
-  const booleanOptions = new Set(["--token-budget", "--no-token-budget", "--yes", "--approve", "--deny", "--json", "--jsonl", "--continue", "--cascade", "--final", "--apply", "--help", "--version", "--no-project-context", "--update"]);
+  const booleanOptions = new Set(["--token-budget", "--no-token-budget", "--yes", "--approve", "--deny", "--json", "--jsonl", "--continue", "--cascade", "--final", "--apply", "--help", "--version", "--no-project-context", "--no-memory", "--update"]);
   const separator = argv.indexOf("--");
   argv = argv.flatMap((arg, index) => {
     const equals = arg.indexOf("=");
@@ -289,7 +300,7 @@ var parseCliArgs = (argv) => {
         words.push(arg);
     }
     const first = words[0];
-    const parts = first === "help" ? words.slice(1) : first && COMMANDS.has(first) ? words.slice(0, ["runs", "sessions", "checkpoints", "changes", "state"].includes(first) ? 2 : 1) : [];
+    const parts = first === "help" ? words.slice(1) : first && COMMANDS.has(first) ? words.slice(0, ["runs", "sessions", "checkpoints", "changes", "state", "memory"].includes(first) ? 2 : 1) : [];
     try {
       const topic = resolveHelpTopic(parts, parts.length > 0);
       return { ...options, command: "help", ...topic ? { helpTopic: topic } : {} };
@@ -321,6 +332,13 @@ var parseCliArgs = (argv) => {
       continue;
     }
     switch (argument) {
+      case "--no-memory":
+        options.projectMemory = false;
+        break;
+      case "--source":
+        options.memorySource = optionValue(argv, index, argument);
+        index += 1;
+        break;
       case "--update":
         options.updateProfile = true;
         break;
@@ -846,6 +864,13 @@ var parseCliArgs = (argv) => {
     if (positional.length > 0) {
       throw new CliUsageError(`changes ${changesCommand} received unexpected positional arguments.`);
     }
+  } else if (options.command === "memory") {
+    const subcommand = positional.shift();
+    const counts = { remember: 1, list: 0, read: 1, update: 3, forget: 2, suggest: 1, accept: 2, clear: 0, enable: 0, disable: 0, context: 1 };
+    if (!subcommand || !Object.hasOwn(counts, subcommand) || positional.length !== counts[subcommand])
+      throw new CliUsageError("Invalid memory arguments. Use memory --help; quote content as one argument.");
+    options.memoryCommand = subcommand;
+    options.memoryArguments = positional.splice(0);
   } else if (options.command === "state") {
     const stateCommand = positional.shift();
     if (!stateCommand || !STATE_COMMANDS.has(stateCommand)) {
@@ -882,7 +907,7 @@ var parseCliArgs = (argv) => {
   } else if (["run", "resume"].includes(options.command) && optionCounts.has("--session")) {
     throw new CliUsageError("--session for run/resume requires --service.");
   }
-  const commandKey = options.command === "checkpoints" ? `checkpoints:${options.checkpointsCommand}` : options.command === "runs" ? `runs:${options.runsCommand}` : options.command === "sessions" ? `sessions:${options.sessionsCommand}` : options.command === "changes" ? `changes:${options.changesCommand}` : options.command === "state" ? `state:${options.stateCommand}` : options.command;
+  const commandKey = options.command === "checkpoints" ? `checkpoints:${options.checkpointsCommand}` : options.command === "runs" ? `runs:${options.runsCommand}` : options.command === "sessions" ? `sessions:${options.sessionsCommand}` : options.command === "changes" ? `changes:${options.changesCommand}` : options.command === "memory" ? `memory:${options.memoryCommand}` : options.command === "state" ? `state:${options.stateCommand}` : options.command;
   try {
     validateCliCommandOptions(commandKey, optionCounts);
   } catch (error) {
@@ -1020,6 +1045,7 @@ var createConfiguredHarness = async (options, extraProfiles = [], persistedRoute
   const compactionModelInstance = resolvedConfig.compaction.model && compactionEnv ? await credentialModel(resolvedConfig.compaction.model, compactionEnv) : undefined;
   const harness = await createHarness({
     ...options,
+    ...{ projectMemory: options.projectMemory ?? true },
     usageAccounting: {
       ...options.pricingFile ? { pricing: usagePricingSchema.parse(JSON.parse((await readRegularFileNoFollow(path2.resolve(options.pricingFile), { maxBytes: 128 * 1024, label: "Usage pricing" })).contents.toString("utf8"))) } : {},
       ...options.usageLimitUsd !== undefined ? { limitUsd: options.usageLimitUsd } : {}