Phase Ecology Lab

Phase Ecology Lab

Phase Ecology Lab is a local way to observe agent reports over a small window.

The lab was introduced in PIC-TS v0.5.0 and remains available in v0.6.0. It uses JSON and JSONL files and does not need Python. It stores source file basenames, not absolute local paths.

What It Helps With

Use the lab when you want to see:

• which packets were accepted;
• which packets are still candidate-only;
• what evidence is missing;
• which graph edges are supported;
• whether closure is only a candidate;
• which execution paths are available as data;
• which threshold components still fail.

The lab is useful for routing work. It is not a proof of real ASI, physical truth, simulator truth, or oracle truth.

Basic Flow

npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts runtime step --state .pic-demo/runtime_state.json --input .pic-demo/runtime_step_input.json --output .pic-demo/runtime_step_report.generated.json
npx pic-ts phase lab init --output-dir .pic-lab
npx pic-ts phase lab ingest --store .pic-lab --report .pic-demo/runtime_step_report.generated.json
npx pic-ts phase lab observe --store .pic-lab
npx pic-ts phase lab graph --store .pic-lab
npx pic-ts phase lab closure --store .pic-lab
npx pic-ts phase lab executable-paths --store .pic-lab
npx pic-ts phase lab threshold-status --store .pic-lab --threshold .pic-demo/asi_proxy_development.json
npx pic-ts phase lab certify --store .pic-lab --threshold .pic-demo/asi_proxy_development.json

Store Layout

The local store contains:

manifest.json
events.jsonl
windows/latest.json
windows/<window-id>.json
exports/

The store is for local inspection. It is not a background service.

Main Commands

Command	Purpose
phase lab init	Create a lab store.
phase lab ingest	Add report or packet JSON files.
phase lab list-windows	List known observation windows.
phase lab export	Export sanitized store data.
phase lab observe	Build a phase window observation.
phase lab graph	Build an effective packet graph.
phase lab closure	Inspect closure candidates.
phase lab executable-paths	Detect available execution paths as data.
phase lab threshold-status	Compare observation data with a threshold JSON.
phase lab certify	Build a certificate candidate or abstention report.
phase lab compare-window	Compare two observation windows.

Safety Boundary

• Raw packet volume does not improve positive phase metrics.
• Candidate-only reports do not become accepted packets.
• Available execution paths are not executed.
• Diagnostic route output keeps settled=false unless finite obligations are actually discharged.
• The lab does not grant shell, repository, network, or model mutation authority.

See Safety and Limits for the broader boundary.