Repository navigation
@staix/agent-mem v0.25.0
-
Add the person-owned
preferencenote kind (amem note add --kind preference,amem_rememberwithkind: "preference"): a standing instruction that is long-term, project orsharedscope, superseded and forgotten like any note, and never inferred or merged byamem consolidate. Briefs show it by its own slot instead of path- or intent-ranked rows:amem_briefreserves at most half its budget for up to five current preferences (this project's plus everysharedone, newest first) and emits whole lines of at most 240 bytes, dropping one that does not fit and reportingtruncatedrather than clipping a rule in half; the SessionStart hook carries the same slot from its own prebuilt sidecarbrief-preferences.json, written besidebrief-curated.jsonunder the same profile binding, 24-hour freshness and 32 KiB cap, at most 480 bytes, before the curated rows. A preference never takes a curated row, so one is never shown twice. Refs #370. -
Compatibility with N-1 (0.24.0), measured: a
preferencerow is not additive for an older reader. The published 0.24.0 reading a home whose own segment holds one lists 0 rows and returnssyncMemory{ ok: false, pushed: false, entries: 0 }with "this machine's long-term segment is not readable as complete valid rows, so it was not screened; inspect the local input and reopen the store before retrying". So the write fails closed:note add,importNoteand accepting a preference candidate are refused until the memory home records{"surface":"curated","minReader":"0.25.0","since":"<date>"}informats.json, and at that floor 0.24.0 refuses the home at store open withcode: "format_floor"instead of breaking its sync, as measured on the same home. Reads, briefs andamem_rememberqueueing need no floor; a queued candidate cannot be accepted until the floor is raised, and the refusal leaves itpending.amemnever writesformats.json. -
Compatibility with N-1 (0.24.0), indexes and brief cache:
INDEX_VERSION4 names its own curated index file (index-v4.db, andindex-v2-i4.dbfor the v2 public-prune view), so each release keeps its own warm index on one home and neither drops the other's; an older index skips preference rows, so sharing one file would be wrong. The cost is one refresh for a reader whose own file this release no longer advances: 0.24.0 rebuilds from the log and answers, and a reader that predates the vault generation meets the same refusal it already had for an op it does not know. The preference sidecar uses a new file name and metadata key, so 0.24.0 neither parses nor invalidates it, and the curated section it does read now excludes preference rows. Existing rows, hashes, schemas and paths are unchanged. -
Extract canonical capture-only Records from positively completed main-session Codex, Pi and Kimi messages through the existing staging, receipt and replay path. Respect
records: false, existing forward cursors, privacy, anchor and brief caps; add numeric JSON counts. Qwen and Jcode stage no Records without a native finality witness and reportfinality-unavailable; their ordinary capture remains unchanged. Refs #369. -
Compatibility with N-1 (0.24.0), capture spool: non-Claude Records use the additive format-4
hook-v4-prefix, which 0.24.0 leaves pending while draining unchanged format-2/3 rows. The new reader drains all three formats with the same receipts and dedupe. Existing Claude publication bytes, curated schemas and floors are unchanged. -
Select the hosted macOS StopBurst RSS regression baseline by CPU hardware class: keep 93.58 MB for M1 and unknown CPUs, and use the qualified M2 Pro cohort median of 103.19 MB. Retain the strict +10% gate and 150 MB ceiling; receipts name the class and applied baseline. Other groups and runners are unchanged. Refs #365.
-
Propose curated candidates from capture
Recordrows inamem consolidate: the newest 32 main-session Records of the project, grouped by kind and anchor set (by kind and text when the Record carries-anchors), one candidate citing up to 8 rows, with decision/contract/finding keeping their own note kind,fixbecoming afindingtitledfix:andfailfilling symptom and retry-when from the two recorded groups. Additive only: the candidate input gains optionalabout(the anchors aspath:andsymbol:edges) and optionalrecord(group key, anchors, and each cited row's session hash, time and line hash), the report gains arecordsblock (found,queued,grouped,alreadyQueued,alreadyReviewed,excluded,refused,truncated), and acceptance point-reads the cited turns, so a candidate that outlives the 32-row window still proves its rows instead of reading them as pruned.canonical()drops undefined, so every existing candidate id, payload and hash is unchanged, and no index version, capture format or format floor moves; a host that passes norecordscallback consolidates exactly as before. Refs #368. -
Compatibility with N-1 (0.24.0), candidates: the candidate store schema and every existing candidate id are unchanged. By code reading, 0.24.0 has no cited-row check and builds an accepted note's edges from its target alone, so accept Record-derived candidates with 0.25.0, which proves the cited rows and keeps the Record's
path:andsymbol:edges. -
Compatibility with N-1 (0.24.0), root exports: the root now re-exports
src/memory/record-candidates.ts(Record proposal constants, types and helpers); this is additive and existing export names remain. Hosts must pin 0.25.0 before calling them.