Skip to content

docs(figures): journal figures for the EPIC-01 and EPIC-12 entries - #138

Merged
superposition merged 1 commit into
mainfrom
journal/figures-epic-01-and-12
Sep 11, 2026
Merged

superposition merged 1 commit into
mainfrom
journal/figures-epic-01-and-12

Conversation

@superposition

Copy link
Copy Markdown
Owner
agent: T37Journal1
branch: journal/figures-epic-01-and-12
commit: e919757bdef1b59b14de0e0b53354ae6c1a61431
state: review
next: merge; the site entries reference these files by pinned commit URL
blocked_on: none
evidence: docs/figures/the-licence-and-the-clean-room-snapshot/, docs/figures/the-operating-model/

What this adds

The figures for the two journal entries written so far, one directory per entry:

Directory Figures
the-licence-and-the-clean-room-snapshot/ provenance-check.svg (chart), licence-flow.svg (diagram)
the-operating-model/ ledger-status.svg (chart), operating-loop.svg (diagram)

Each directory carries its generating script, its data file (provenance.json,
ledger-snapshot.json), both an SVG and a PNG of every figure, and a README.md
naming what each figure encodes and where its numbers come from. Every file is
under 120 KB (budget: 400 KB).

docs/figures/_house.py holds the palette and the box/arrow vocabulary once, so
the two entries cannot drift apart in colour or line weight.

Verification

  • Two consecutive runs are byte-identical for all four figures (cmp over each
    SVG and PNG); metadata dates are suppressed and the SVG hash salt is fixed.
  • Sizes: largest is operating-loop.svg at 118,071 bytes.
  • Layout was checked from the artists' own extents (no text outside the figure,
    no overlapping text) because this session has no vision.
  • The charts draw only committed data: the provenance counts are the recorded
    output of scripts/provenance_check.py at 144bb6d (104 files compared, 0
    identical) and at a59b836 (110/0); the ledger counts are one timestamped
    reading of gh issue list.

Notes

…ng-model entries

Two figure directories under docs/figures/, one per entry, drawn from committed
data by a committed script:

- the-licence-and-the-clean-room-snapshot: a chart of what scripts/provenance_check.py
  compared and how much of it was byte-identical (0), and a diagram of the
  clean-room boundary and the three attribution sources that NOTICE carries.
- the-operating-model: a chart of the 95 ticket issues by status label and of the
  ids the committed dependency diagram omits, and a diagram of the operating loop
  with its blocked and agent-dies edges and the resume command.

docs/figures/_house.py holds the palette and the box/arrow vocabulary once, so
the figures cannot drift apart. Also ignores Python bytecode: the figure scripts
are Python, and one .pyc had already been committed by accident.
@superposition
superposition merged commit e087c28 into main Sep 11, 2026
4 of 5 checks passed
@superposition
superposition deleted the journal/figures-epic-01-and-12 branch September 11, 2026 09:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant