memory-consolidate::on-config-change
Internal: hot-reload memory-consolidate from the authoritative configuration when it changes.
- idstring
- okbooleanrequired
$worker
memory-consolidate
v0.1.9Scheduled hygiene for the memory worker — deterministic dedup of near-duplicate memories, applied supersede-only through the public memory functions, pinned untouchable, with catch-up-on-boot scheduling. Install, stop, or remove it without touching stored memory.
iiiverifiedinstall
$iii trigger compose::add worker=memory-consolidate@0.1.9
- macOS: arm64 · x64
- Linux: arm64 · armv7 · x64
- Windows: arm64 · x64 · x86
repoiii-hq/workers
exact versions are immutable; binary and bundle artifacts are digest-pinned.
functions
4function
memory-consolidate::on-tick
Internal: schedule heartbeat (cron trigger + boot catch-up backstop). Runs a pass only when interval_hours have elapsed since the last one.
- actual_timestring
- job_idstring
- scheduled_timestring
- triggerstring
- ranbooleanrequired
A pass actually ran (false = not due yet or disabled).
memory-consolidate::run
Run one consolidation pass now (all configured banks, or one bank). Deterministic near-duplicate dedup applied strictly through memory::supersede + memory::save; pinned memories are untouchable. dry_run plans without writing.
- bankstring
Consolidate only this bank (must be in the configured allowlist, when one is set).
- dry_runboolean
Override the configured dry_run for this call.
- banksobject[]required
- bankstringrequired
- cappedinteger· uintmin 0
Work left behind by the per-run cap; the next pass picks it up.
- errorsstring[]
- groupsobject[]required
- loser_idsstring[]required
- loser_textsstring[]required
Texts of the losers, aligned with `loser_ids` (the judge tier and human review need the words, not just ids).
- report_onlyboolean
True = surfaced for review only (token-set match: same words, different order — potentially different meaning). Never written automatically.
- skipped_pinnedstring[]
Losers left alone because they are pinned (pinned is untouchable).
- winner_idstringrequired
- winner_textstringrequired
- llm_mergedinteger· uintmin 0
Reorder groups merged after the LLM judge confirmed equivalence.
- promotedinteger· uintmin 0
Standing-instruction lines the judge promoted into the bank's `learned` rule.
- reinforcedinteger· uintrequiredmin 0
Winner reinforcements applied (one per absorbed duplicate).
- scannedinteger· uintrequiredmin 0
Live memories scanned.
- supersededinteger· uintrequiredmin 0
Supersedes actually applied (0 on dry runs).
- checkpointedbooleanrequired
The pass completed cleanly AND its last-run checkpoint persisted. False = the schedule will retry the pass next check.
- dry_runbooleanrequired
- supersededinteger· uintrequiredmin 0
Total supersedes applied across banks this pass.
memory-consolidate::status
Schedule and last-pass report: enabled, interval, last run, whether a pass is due, and the most recent per-bank results.
empty object
- dry_runbooleanrequired
- duebooleanrequired
A scheduled pass is overdue right now.
- enabledbooleanrequired
- interval_hoursinteger· uint64requiredmin 0
- last_reportunknown
- last_runinteger· uint64requiredmin 0
Milliseconds since epoch of the last completed pass; 0 = never.
triggers
0no triggers registered