feat(artifact): add durable fresh-root handoff #38

Merged

lost-rob0t merged 22 commits from feature/issue-16-durable-artifacts into main

2026-08-13 02:14:38 +00:00

lost-rob0t commented

2026-08-13 02:11:38 +00:00

(Migrated from github.com)

Summary

add a backend-neutral durable artifact store with memory and SWI library(persistency) backends
add immutable per-key versioning, exact historical refs, latest lookup, stale/superseded ref detection, and bounded fresh-root context packs
persist explicit producer/consumer trace links for artifact publication and consumption
integrate artifact refs with supervised agent checkpoint state without inheriting transcript payloads
integrate artifact refs with typed graph state/checkpoints and fresh-node context resolution
add a real two-process checkpoint/artifact restart gate proving durable handoff survives a fresh SWI process
add a three-root deterministic fixture proving later roots receive compact artifacts, stale refs resolve explicitly, and message/transcript fields are not inherited
document the runtime contract and mark RLM-RESEARCH-009 verified with implementation evidence

Validation

Exact PR head 46bf0cc76c7b1324b6646047e604d04ddc93ad32 passed deterministic branch/PR validation for:

supported SWI runtime check
production static-load
live integration definition static-load
complete deterministic PlUnit suite
persistent graph restart/resume across fresh SWI processes
durable artifact handoff across fresh SWI processes
whitespace checks

The existing REAL OpenRouter core and structured-repair gates are required green before merge.

Closes #16

## Summary - add a backend-neutral durable artifact store with memory and SWI `library(persistency)` backends - add immutable per-key versioning, exact historical refs, latest lookup, stale/superseded ref detection, and bounded fresh-root context packs - persist explicit producer/consumer trace links for artifact publication and consumption - integrate artifact refs with supervised agent checkpoint state without inheriting transcript payloads - integrate artifact refs with typed graph state/checkpoints and fresh-node context resolution - add a real two-process checkpoint/artifact restart gate proving durable handoff survives a fresh SWI process - add a three-root deterministic fixture proving later roots receive compact artifacts, stale refs resolve explicitly, and message/transcript fields are not inherited - document the runtime contract and mark `RLM-RESEARCH-009` verified with implementation evidence ## Validation Exact PR head `46bf0cc76c7b1324b6646047e604d04ddc93ad32` passed deterministic branch/PR validation for: - supported SWI runtime check - production static-load - live integration definition static-load - complete deterministic PlUnit suite - persistent graph restart/resume across fresh SWI processes - durable artifact handoff across fresh SWI processes - whitespace checks The existing REAL OpenRouter core and structured-repair gates are required green before merge. Closes #16