@zhivex-ai/harness 1.3.0-rc.7 → 1.4.0-rc.1

package/CHANGELOG.md

@@ -4,6 +4,29 @@ 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.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). The candidate is not yet published.
+
+- 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.
+- Preserve the RC7 runtime and Code RC2 provider/terminal fixes; no new product features or changes to historical Harness binaries, state contracts or stable API signatures.
+- Validate Code stable/latest and RC/next channels, canonical versions, exact engine pins, channel ordering and immutable artifact recovery. Preserve annotated-tag, exact main CI/CodeQL, installed acceptance, integrity and provenance gates.
+- Keep beta and experimental API tiers, provisional Anthropic/Gemini/Vertex support and private Desktop alpha unchanged. RC7's six-provider live gates and Meta/Qwen/OpenAI 42-case representative evidence remain bound to RC7; stable artifacts require new protected evidence.
+- Refresh the recorded verified latest publication to Harness 1.2.0 without fabricating an uncreated GitHub Release, and align active release/installation documentation without claiming that the prepared stable versions are already published.
+
 ## 1.3.0-rc.7 - 2026-10-01
 
 - Pin Qwen contract certification to zero sampling temperature in approval and conversation continuity smokes, preserving all approval, compaction, effect and context assertions. Application model defaults remain unchanged.

package/README.md

@@ -11,19 +11,22 @@ 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-rc.7` prepares the terminal-independent engine API and the local
-Code package for candidate validation on npm `next`. Publication remains pending
-the protected release workflow. RC4 includes Anthropic, Gemini/Vertex, Desktop package migration, isolated MCP/ACP,
-checkpoints and experimental governance controls. Code publication is independent.
-Stable `1.2.0` remains available under npm `latest`.
-Desktop retains its separate private alpha status.
+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 RC7 and
+Code RC2 remain published on `next`. 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.
+
+This checkout prepares Harness `1.4.0-rc.1` and Code `0.3.0-rc.1` 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). The candidates are not yet published.
 
 ## Quick start
 
 Requires Node.js 22.13.0 or newer, Git and a provider API key.
 
+After RC publication, install the candidate below. Until then, use npm `latest` for stable Harness 1.3.0:
+
 ```sh
-npm install -g @zhivex-ai/harness@1.3.0-rc.7
+npm install -g @zhivex-ai/harness@1.4.0-rc.1
 cd /path/to/your/project
 zhx
 ```
@@ -78,8 +81,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 recorded 1.0.0 release; [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 `1.1.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](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.1.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 preserves the verified 1.0.0 release; check npm for the current published version.
+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,11 +13,11 @@ 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 `1.1.x` patch receives routine fixes. The exact `v1.1.1` tag passed the protected artifact, live-provider and representative release jobs. 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](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
 
-Follow the [stable installation commands](./README.md#installation) or [isolated Bun example](./examples/README.md). Run `zhx --version`, `zhx --help`, and `zhx doctor` before reporting an installation issue. Doctor is local: a missing provider credential produces a diagnostic failure until that credential is configured. Include the version, OS, Node/Bun versions and sanitized diagnostics in a report; never include keys or your `.env` file.
+Follow the [stable installation commands](./README.md#quick-start) or [isolated Bun example](./examples/README.md). Run `zhx --version`, `zhx --help`, and `zhx doctor` before reporting an installation issue. Doctor is local: a missing provider credential produces a diagnostic failure until that credential is configured. Include the version, OS, Node/Bun versions and sanitized diagnostics in a report; never include keys or your `.env` file.
 
 ## Support channels
 
@@ -25,4 +25,4 @@ Use [GitHub Issues](https://github.com/Zhivex/zhivex-harness/issues) for reprodu
 
 ## Explicit limits
 
-The harness does not promise arbitrary shell access, `stdio` MCP, permanent deletion, Windows support, a managed sandbox, a desktop UI, or exact feature parity between upstream providers. Tools run with the permissions of the local harness process unless an application supplies a stronger execution environment.
+The harness does not promise arbitrary shell access, general-purpose `stdio` MCP interoperability, permanent deletion, Windows support, a managed sandbox, a stable desktop UI, or exact feature parity between upstream providers. Tools run with the permissions of the local harness process unless an application supplies a stronger execution environment.

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",

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,20 +5,20 @@ import {
   parseHarnessModelRoute,
   resolveHarnessModelRoutes,
   validateCliCommandOptions
-} from "./index-2jrdcj6b.js";
+} from "./index-wq2tax80.js";
 import {
   serveAcpStdio
 } from "./index-3ah1f369.js";
 import {
   createHarness,
   createHarnessClientAdapter
-} from "./index-jgrx804e.js";
-import"./index-h0mqx2ed.js";
-import"./index-8zzhggxv.js";
+} from "./index-4nf70nq1.js";
+import"./index-aqe7236b.js";
+import"./index-g0wfcb65.js";
 import {
   usagePricingSchema
-} from "./index-42gp2hy8.js";
-import"./index-t60rva31.js";
+} from "./index-ds5e9x3a.js";
+import"./index-fm6ahk8m.js";
 import"./index-z0qxmkm2.js";
 import {
   FileChangedWhileReadingError,
@@ -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 } : {}

package/dist/cli/arguments.d.ts

@@ -2,7 +2,7 @@ import { type HarnessReasoningEffort } from "../providers/reasoning.js";
 import { type AgentStatus } from "@zhivex-ai/agents";
 import { type HarnessSubagentProfile } from "../runtime/config.js";
 import { HarnessError } from "../runtime/errors.js";
-export declare const CLI_COMMANDS: readonly ["init", "run", "review", "chat", "providers", "doctor", "policy", "resume", "runs", "sessions", "checkpoints", "changes", "state", "help", "version"];
+export declare const CLI_COMMANDS: readonly ["init", "run", "review", "chat", "providers", "doctor", "policy", "resume", "runs", "sessions", "checkpoints", "changes", "state", "memory", "help", "version"];
 export declare const CLI_RUNS_COMMANDS: readonly ["list", "inspect", "cancel", "cleanup", "export", "report"];
 export declare const CLI_SESSIONS_COMMANDS: readonly ["list", "inspect", "rename", "fork", "archive"];
 export declare const CLI_CHANGES_COMMANDS: readonly ["create", "verify"];
@@ -80,6 +80,10 @@ export interface CliOptions {
     checkpointsCommand?: "list" | "capture" | "inspect" | "prepare" | "review" | "apply" | "recover" | "storage" | "prune-review" | "prune-apply";
     checkpointArguments?: string[];
     changesCommand?: ChangesCommand;
+    memoryCommand?: string;
+    memoryArguments?: string[];
+    memorySource?: string;
+    projectMemory?: boolean;
     stateCommand?: StateCommand;
     artifactPath?: string;
     patchPath?: string;

package/dist/cli/memory.d.ts

@@ -0,0 +1,2 @@
+import type { CliOptions } from "./arguments.js";
+export declare function manageMemory(options: CliOptions): Promise<void>;