Context
AS-08 added akta reconstruct and institutional docs (docs/RELEASE.md, docs/operator_pilot_guide.md, docs/integration_guide.md). The reconstructable demo is available via make demo-reconstructable (writes under dist/), and there is a checked-in tree at examples/reconstructable_experiment/. Contributors still lack a single, low-friction Makefile entry that runs akta reconstruct against a known local release path and is documented next to the CLI examples—so the reconstruct path is harder to discover than other demo targets.
Goal
Add a small Makefile target (and a short docs mention) that runs akta reconstruct on a documented example/release directory and prints or writes a reconstruction report newcomers can inspect.
Suggested work
- Add a Makefile target such as
reconstruct-example (name can vary) that:
- Invokes
akta reconstruct --release <path> --out <report.json> (or equivalent documented flags).
- Uses either
examples/reconstructable_experiment/ or the output of make demo-reconstructable under dist/reconstructable_experiment/—pick whichever path actually validates cleanly today; if the checked-in example needs a thin README note about regenerating via the demo, say so.
- Document the target in
docs/RELEASE.md (reconstruction checklist) and/or docs/operator_pilot_guide.md / docs/integration_guide.md beside existing akta reconstruct snippets.
- Ensure the target is listed in
.PHONY if that is the Makefile convention.
- Keep the change tiny: no new packaging features, no cross-repo SCOPE requirements.
Out of scope
- Changing reconstruct library semantics.
- Making
ci / ci-pilot depend on the new target unless maintainers explicitly want that (default: keep it optional/manual).
- Fixing unrelated stale example artifacts beyond what is required for the target to succeed (if large, open a follow-up).
Acceptance criteria
Suggested files
Makefile
docs/RELEASE.md and/or docs/operator_pilot_guide.md / docs/integration_guide.md
- Possibly a one-line note under
examples/reconstructable_experiment/reconstruction_report.md
How to test
\\�ash
pip install -e ".[dev,security]"
if the target depends on generated dist artifacts:
make demo-reconstructable
make reconstruct-example # or the chosen target name
\\
- Open the written reconstruction JSON/report and confirm bindings/checksums look populated.
- Optionally:
pytest tests/test_as08_reconstruct.py -v to ensure library/CLI tests remain green.
Context
AS-08 added
akta reconstructand institutional docs (docs/RELEASE.md,docs/operator_pilot_guide.md,docs/integration_guide.md). The reconstructable demo is available viamake demo-reconstructable(writes underdist/), and there is a checked-in tree atexamples/reconstructable_experiment/. Contributors still lack a single, low-friction Makefile entry that runsakta reconstructagainst a known local release path and is documented next to the CLI examples—so the reconstruct path is harder to discover than other demo targets.Goal
Add a small Makefile target (and a short docs mention) that runs
akta reconstructon a documented example/release directory and prints or writes a reconstruction report newcomers can inspect.Suggested work
reconstruct-example(name can vary) that:akta reconstruct --release <path> --out <report.json>(or equivalent documented flags).examples/reconstructable_experiment/or the output ofmake demo-reconstructableunderdist/reconstructable_experiment/—pick whichever path actually validates cleanly today; if the checked-in example needs a thin README note about regenerating via the demo, say so.docs/RELEASE.md(reconstruction checklist) and/ordocs/operator_pilot_guide.md/docs/integration_guide.mdbeside existingakta reconstructsnippets..PHONYif that is the Makefile convention.Out of scope
ci/ci-pilotdepend on the new target unless maintainers explicitly want that (default: keep it optional/manual).Acceptance criteria
make <target>runs successfully on a clean clone after install and (if required)make demo-reconstructable.ok=trueor equivalent documented field) for the chosen path.Suggested files
Makefiledocs/RELEASE.mdand/ordocs/operator_pilot_guide.md/docs/integration_guide.mdexamples/reconstructable_experiment/reconstruction_report.mdHow to test
\\�ash
pip install -e ".[dev,security]"
if the target depends on generated dist artifacts:
make demo-reconstructable
make reconstruct-example # or the chosen target name
\\
pytest tests/test_as08_reconstruct.py -vto ensure library/CLI tests remain green.