@aiiware/aii 0.25.14 → 0.26.0

package/README.md

@@ -9,7 +9,7 @@ An autonomous AI assistant that lives in your terminal. Ask it anything — it r
 </p>
 
 <p align="center">
-  <strong>npm:</strong> <code>@aiiware/aii</code> · <strong>Version:</strong> 0.25.0 · <strong>Node.js:</strong> >= 20
+  <strong>npm:</strong> <code>@aiiware/aii</code> · <strong>Version:</strong> 0.26.0 · <strong>Node.js:</strong> >= 20
 </p>
 
 ---
@@ -109,6 +109,43 @@ Manage directories offered for new web conversations with `aii cloud workspace l
 
 The pre-GA `--remote`, `--local` and `aii cloud connect` entry points have been removed. Use the single launcher above; the old spellings are not aliases.
 
+### Memory foundation (v0.26)
+
+Save complete project facts or personal preferences, inspect what was recalled, and correct or forget them. Generated suggestions stay pending until you review their exact text and scope. Retrieval is local lexical search; it makes no ranking-model request. Conditions and exceptions are kept together.
+
+**Activation is explicit.** Installing the update does not migrate or enable the new store. Stop other Aii processes, then use these commands in a local interactive session—even if you have no old memories:
+
+```text
+/memory migrate bind-project
+/memory migrate preview
+/memory migrate confirm <preview-token>
+/memory migrate activate <migration-id> --offline-confirm
+/memory review
+```
+
+Use the token and migration ID printed by the preceding commands. Staging imports candidates without approving them; activation preserves inventoried originals in quarantine. The inventory covers your profile and current project. Activation disables legacy learned-memory readers and writers for the whole local home; other projects must be bound and staged separately. After activation, do not run older Aii versions against that home. `-y` and unattended modes cannot approve migration or candidates.
+
+After activation:
+
+```text
+/memory save --project "Use pnpm, except the legacy release job uses npm ci."
+/memory save --profile "Prefer concise progress reports."
+/memory show <id>
+/memory recall
+/memory replace <id> "The complete corrected fact, including exceptions."
+/memory forget <id>
+/memory settings use off
+/memory settings learn off
+```
+
+Use and Learn are independent; explicit saves still work with Learn off. `/memory review` shows candidate text, scope and hash before approval. `/memory list`, `/memory use` and `/memory reload` retain their authored-instruction meanings.
+
+If a changed or revoked memory influenced the current conversation, inference pauses. `/memory clean` starts an empty continuation once local work has settled; it transfers no old transcript or summary. Bound remote sessions and ambiguous request outcomes require a fresh local session. Stateful server-managed sessions, remote Ask, and child delegation into a different project binding are refused under active foundation until their history/scope can be verified. Forgetting prevents future learned-memory use; it does not erase historical transcripts or undo external actions.
+
+Storage and retrieval stay local, but selected memory can be sent through your configured inference provider. This follows Aii’s trusted-host model: it does not protect runtime files from a malicious unrestricted process running as your OS user. Paraphrase matching is limited in this lexical baseline.
+
+To roll back after activation, stop Aii, preserve the new memory authority and its revocations, and run the older CLI only with a separate clean configuration home and learned memory disabled. Do not restore quarantined files into discovery paths or resume old conversations into inference on the downgrade.
+
 ### Switch models on the fly
 
 ```bash