This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/state/scratch.md
2026-08-11 06:56:16 +02:00

2.1 KiB

Scratch

Disposable working memory for one bounded rite.

Current Subgoal

Give Eyes, Modeling, and Soul a governed read-only directory inventory so they can source-ground artifact-retention claims instead of trusting operator prose.

Live finding

Exact aa841873 on copied c006 accepted one fresh user proposal and issued one proposal-bound Modeling grant. Self held awaiting-fulfillment, then completed once at revision 46 with zero retry. Runtime ended at 48 jobs/results, zero open jobs, and no Hands/Eyes frontier. Modeling used five governed source calls and correctly refused the operator-supplied 72 directories / 4.2 MiB claim: the native source adapter could read files and Git objects but could not enumerate or measure .epiphany-smoke/heartbeat-c006-c9a2a979. The copied brake was re-engaged and both direct PID containers exited zero. Actual c006 was not touched.

Authority map

  • Owner: the native epiphany_source adapter owns bounded read-only workspace observation.
  • Inputs: one canonical workspace-confined directory plus explicit depth, entry, and sample ceilings.
  • Outputs: deterministic entry/file/directory/symlink counts, total regular-file bytes, bounded samples, and explicit entry/depth truncation state.
  • Derived state: samples are display only. Totals are admissible evidence only when complete=true.
  • Forbidden writers: shell execution, symlink traversal, outside-workspace reads, mutation, operator counts, and Heartbeat-specific policy.
  • Shared paths: Eyes, Modeling, and Soul receive the same model tool definition, native execution path, and typed intent/receipt boundary.
  • Cut line: add one general directory_inventory beside read_file; do not add a special Heartbeat inspector or teach prompts to trust proposal prose.
  • Verification: focused native execution tests must prove exact totals, deterministic ordering, confinement, and explicit truncation; OpenAI request tests must prove the tool and completeness mandate are visible to workers. Then package and replay the copied proposal with the original operator counts omitted so Epiphany itself measures the artifact family.