Expand description
borg memory: the evidence behind each lesson, for an outside store to take over long-term knowledge.
borg memory export [--json] [--dir DIR] [--absorbed] [--since YYYY-MM-DD]: read-only, 0 tokens. One evidence record per lesson of the collective DIR (default: the current directory) routes to; an off directory prints nothing.--absorbedlists the absorbed lessons only,--sincethe lessons whose last change (Evidence::last_change_ms) is on or after that UTC day.borg memory absorb <id>... [--note TEXT]andborg memory release <id>...: the lesson is now held outside Borg, or no longer (absorb.rs, which also says what an absorb does to delivery).
The record (--json: {"schema": SCHEMA, "collective", "lessons": [...]}, document): the
lesson as stored (id, version, repo, question, situations, consequence, area, scope, reach team or
repo, overrides, supersedes and the computed superseded_by, source, origin, support, engineers
under this machine’s aliases, history: the old versions’ wording); its memory exactly as the
conscience weighs it (memory.rs derive over outcome.rs read_team, as conscience.rs load): the
Beta belief’s α, β, mean and 95% equal-tailed credible interval, the per-session result counts,
activation, consolidated and dormant; its breadth: the distinct sessions that changed their work on
it and the distinct repos of those changes (team lines carry hashed repos, so counts, never names);
the raw counts of its placebo and tail-sample judgements from this machine’s outcome log (Judged),
no estimate and no threshold; whether it is absorbed ({note, ms, by, version}, else null) and,
absorbed, its recurrence: the episodes merged into it since the absorbed version.
Every text field but the ids (id, supersedes, superseded_by) and reach goes through notes.rs
redact, the engineers and an absorb’s by too. A personal lesson’s tombstone (reach
personal) is left out, and the store’s personal.jsonl is never read. A field the logs do not hold is omitted, never guessed:
version, support and history for a lesson line without them (an older or hand-written line),
placebo and tail when the log holds no such judgement of the lesson, recurrence when the
absorb named no version (the lesson was not in the store yet) or the store no longer holds that
version’s line.
Structs§
- Absorbed
- The lesson’s absorb (absorb.rs
Record). - Breadth
- The distinct sessions that changed their work on the lesson, and the distinct repos of those changes: what memory.rs counts to consolidate it.
- Evidence
- One lesson’s evidence record (module doc).
- Filter
- Which lessons
evidencelists. - Judged
- Raw judgement counts. Placebo: the judge’s verdicts on the lesson where it was routed nowhere
(outcome.rs
PLACEBO), and of them the ones that found the drone changed its work on its point anyway. Tail: the graded checks whose tail sample showed the lesson past the pool budget (outcome.rsOutcome::tail), and of them the ones whose model graded it as applying. - Memory
View - The memory the conscience weighs the lesson by (memory.rs
Memory), rounded to 4 decimals.
Constants§
- FLAGS
- SCHEMA
- Protocol: the export’s schema version. A change to a field’s meaning or a removed field raises it; an added field does not.
- SUBS
borg memory’s subcommands and flags (completions.rs).
Functions§
- document
- The export of the store
storeas one JSON document,{"schema": SCHEMA, "collective", "lessons"}: whatborg memory export --jsonprints and borg-web’s/api/memoryserves. - evidence
- The evidence records of the store
store(the directory of itslessons.jsonl) thatfilterlets through, by first correction then id. Never fails: missing logs are no evidence. - interval
- The equal-tailed
levelcredible interval of Beta(a, b). - main
borg memory <export|absorb|release> ...; the exit code.- summary
borg status’s line of a store: its absorbed lessons, and how many of them recurred (a correction merged into one since its absorb,recurrence). An absorbed id the store does not hold yet is not counted.