The Principia Machina/Diagrams/C2 Recorder pages: Difference between revisions

Latest revision as of 13:34, 30 September 2026

The Principia Machina: map
Reading the diagrams Structure key Process key Definition of terms Roles
Reading by audience Start here: the walk through The operator's guide Tutorial: create a UUID Workspace Container (UWC) Public Recorder inputs Sponsors: your first agent
The specification Contents: parts, tables, diagrams TPS 0.5.0 (declared 2026-10-03, revision 8; machine-optimized text) Decisions (the foundations record, one line each)

Conceptual diagram 2 of 7. Part of the TPM hub.

KIND: structure
LANGUAGE: DOT
GENERATED FROM: declared by the human 2026-09-17; TPS 5.5-5.13
STATUS: hand-authored at TPS 0.1.0; checked against TPS 0.3.0 on 2026-09-28: owed a redraw (not drawn: each chain page a CHAIN HEAD over APPEND VOLUMES, 5.6.10; the pages added since: the community ledger and views, the dossiers, the falcon pages, the bibliography volumes, the environment module pages); checked against revision 7 on 2026-09-29, declared final as TPS 0.4.0 on 2026-09-30: also, TPS's D(TPS) and D(IS) are two digests, not one, 5.14 CR9; checked against revision 8, proposed as TPS 0.5.0, on 2026-09-30: also owed a redraw (the PETITION row's CAPABILITY names neither the execution mode nor the fingerprint and sponsor, D(PROMPT), the HARNESS MODE or the PROMPT MANIFEST, 5.8.2, 5.8.10, 5.8.12); not drawn: the page list [title, h] the hub carries beside D(TPS) and D(IS), 5.11.16; conceptual, kept by the human; never generated
SOURCE SHA-256: d7fa9068d986a1855375d2520d084f46231086dec464e1c10bbb94bce8e7ed9d, 1feb7a8399f70cbdcf2aa059c16bc1091088bb253b03ed87e8292dbbda755f49

Rendered live from the source, which is the text equivalent and is shown under the drawing. The key to the shapes is in the panel.

Source (the text equivalent; DOT)

// C2 Public Recorder pages data structure. TPS 0.1.0 part 5. Bachman form:
// a box is a page or row class (name; identity; writer; fields); an arrow is
// a set, owner to member, labeled with the set name and the rule TPS states.
digraph C2a {
  graph [rankdir=TB, nodesep=0.15, ranksep=0.5, newrank=true, fontname="Helvetica", fontsize=10,
         label="C2a  DRAFT, CERTIFICATE, CHAIN AND INDEX PAGES  (TPS 5.5, 5.6, 5.10, 5.11)", labelloc=t];
  node  [shape=plaintext, fontname="Helvetica", fontsize=9, fontcolor="#202122"];
  edge  [fontname="Helvetica", fontsize=8, arrowhead=vee, color="#54595d", fontcolor="#202122"];

  DRAFT [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>DRAFT UWC</B> page</TD></TR>
    <TR><TD>one per initiator</TD><TD>writer: its creator</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">TPK, TrM, TMS under construction;<BR/>JSON content model; outside the index<BR/>until instantiation, then read-only</TD></TR>
    <TR><TD COLSPAN="2">5.3.4, 5.5.1, 5.5.5</TD></TR></TABLE>>];
  CERT [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>CANDIDATE CERTIFICATE</B> staging</TD></TR>
    <TR><TD>writer: TPX</TD><TD>reader: H-DECL</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">D(TPK) | D(TrM) | D(TMS) | D(TFK) | UUID | prefix</TD></TR>
    <TR><TD COLSPAN="2">5.5.3, 5.6.4</TD></TR></TABLE>>];
  DECL [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>DECLARATIONS</B> page, global</TD></TR>
    <TR><TD>append-only</TD><TD>writer: H-DECL only</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">genesis line (TPS digest and version)<BR/>certificates | UWC STATE<BR/>admissions | closeouts<BR/>content digests</TD></TR>
    <TR><TD COLSPAN="2">5.6.1, 5.11.2</TD></TR></TABLE>>];
  BUILD [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>BUILD CHAIN</B> page, global</TD></TR>
    <TR><TD>append-only</TD><TD>writer: TPX</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">one line per build, naming the<BR/>declaration verified against;<BR/>link hash SHA-256</TD></TR>
    <TR><TD COLSPAN="2">5.6.1, 5.6.2</TD></TR></TABLE>>];
  MANIFEST [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>MANIFEST</B> page, per container</TD></TR>
    <TR><TD>writer: TPX at every landing</TD><TD>never its own digest</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">entry per page:<BR/>title | content hash | local archive</TD></TR>
    <TR><TD COLSPAN="2">5.11.1, 5.11.3, 5.11.5</TD></TR></TABLE>>];
  BADGE [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>BADGE</B> on the manifest</TD></TR>
    <TR><TD>written LAST</TD><TD>commit marker</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">HOLDER | GRANT | EXPIRY | LAST PUSH<BR/>LAST RELEASE | CHAIN LINE<BR/>MANIFEST REVISION | D(IS)</TD></TR>
    <TR><TD COLSPAN="2">5.10.1</TD></TR></TABLE>>];
  HUB [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>CENTRAL HUB</B> index of record</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">entry point per audience<BR/>current D(IS) | frame text by H-OP</TD></TR>
    <TR><TD COLSPAN="2">5.11.7, 5.11.8</TD></TR></TABLE>>];
  LIB [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>LIBRARY PAGE</B> per container</TD></TR>
    <TR><TD COLSPAN="2">5.11.7</TD></TR></TABLE>>];
  TPS [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>TPS</B> instruction artifact</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">published version | D(IS) = its digest<BR/>human-only edit</TD></TR>
    <TR><TD COLSPAN="2">0.1, 5.11.4, 5.14 CR9</TD></TR></TABLE>>];
  IMPL [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>IMPLEMENTATION</B> index entry</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">name | version | digest<BR/>TPS version conformed to | STATUS<BR/>outside D(IS)</TD></TR>
    <TR><TD COLSPAN="2">5.11.4, 6.1</TD></TR></TABLE>>];
  LIB -> TPS [style=invis]; TPS -> IMPL [style=invis]; BUILD -> MANIFEST [style=invis]; MANIFEST -> LOCK [style=invis]; LOCK -> PANEL [style=invis];
  DRAFT -> CERT [label="FINAL PASS\nzone checks passed; TPX writes\n5.5.2, 5.5.3"];
  CERT -> DECL [label="LANDED BY H-DECL\nstate CERTIFIED\n5.5.4"];
  DECL -> BUILD [label="VERIFIED AGAINST\none build line per\ndeclaration line\n5.6.1"];
  DECL -> MANIFEST [label="INSTANTIATES\nTPX writes the container\n5.5.4"];
  MANIFEST -> BADGE [label="BADGE\nwritten last at every landing\n5.10.1", constraint=false];
  HUB -> LIB [label="ENTRY POINTS\none per audience\n5.11.7"];
  LIB -> MANIFEST [label="LIBRARY-MANIFEST\none per container\n5.11.1"];
  TPCPY [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3"><TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>TPC-PY SOURCE</B> pages</TD></TR><TR><TD COLSPAN="2" ALIGN="LEFT">plain-text content model; advisory<BR/>name | version | digest | TPS version</TD></TR><TR><TD COLSPAN="2">5.3.8, 5.11.9</TD></TR></TABLE>>];
  TPS -> TPCPY [label="ADVISORY\nnon-normative\n5.11.9", style=dotted, constraint=false];
  TPS -> IMPL [label="CONFORMS TO\nconformance declaration\n6.1"];
  TPS -> BADGE [label="D(IS)\npublished on hub and badge\n5.14 CR9", style=dotted, constraint=false];
  { rank=same; DRAFT; HUB; }
  { rank=same; CERT; LIB; }
  { rank=same; DECL; TPS; }
  { rank=same; BUILD; IMPL; }
  { rank=same; BADGE; TPCPY; }
  LIB -> TPS [style=invis]; TPS -> IMPL [style=invis]; BUILD -> MANIFEST [style=invis];
}

Source (the text equivalent; DOT)

// C2 Public Recorder pages data structure. TPS 0.1.0 part 5. Bachman form:
// a box is a page or row class (name; identity; writer; fields); an arrow is
// a set, owner to member, labeled with the set name and the rule TPS states.
digraph C2b {
  graph [rankdir=TB, nodesep=0.15, ranksep=0.5, newrank=true, fontname="Helvetica", fontsize=10,
         label="C2b  LOCK, COLLABORATION AND CONTROL PANEL PAGES  (TPS 5.7, 5.8, 5.9, 5.12)", labelloc=t];
  node  [shape=plaintext, fontname="Helvetica", fontsize=9, fontcolor="#202122"];
  edge  [fontname="Helvetica", fontsize=8, arrowhead=vee, color="#54595d", fontcolor="#202122"];

  MANIFEST [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>MANIFEST</B> page, per container</TD></TR>
    <TR><TD>writer: TPX at every landing</TD><TD>never its own digest</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">entry per page:<BR/>title | content hash | local archive</TD></TR>
    <TR><TD COLSPAN="2">5.11.1, 5.11.3, 5.11.5</TD></TR></TABLE>>];
  LOCK [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>LOCK</B> page, per container</TD></TR>
    <TR><TD>base-revision edit</TD><TD>one, never nested</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">holder account | grant (previous + 1)<BR/>grant time | expiry (<= 24 h)</TD></TR>
    <TR><TD COLSPAN="2">5.7.1, 5.7.2</TD></TR></TABLE>>];
  COLLAB [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>COLLABORATION</B> page, per container</TD></TR>
    <TR><TD COLSPAN="2">5.8.1</TD></TR></TABLE>>];
  PANEL [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#eaecf0"><B>CONTROL PANEL</B> per container</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">copy-forward | schedule log | badge<BR/>STATE | canary pass rate</TD></TR>
    <TR><TD COLSPAN="2">5.12.1</TD></TR></TABLE>>];
  PET [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#f8f9fa"><B>PETITION</B> row</TD></TR>
    <TR><TD>writer: the petitioner, own row</TD><TD>queue = revision order</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">ACCOUNT | STATUS<BR/>CAPABILITY (class, tools, CERTIFIED,<BR/>D(IS), conformance declaration)</TD></TR>
    <TR><TD COLSPAN="2">5.8.2</TD></TR></TABLE>>];
  ASSIGN [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#f8f9fa"><B>ASSIGNMENT</B> row</TD></TR>
    <TR><TD>writer: the lead</TD><TD>one per block</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">BLOCK ID | ASSIGNEE | GRANT<BR/>WORKLOAD pointer | LEASED RANGE<BR/>RETURN PAGE</TD></TR>
    <TR><TD COLSPAN="2">5.8.3</TD></TR></TABLE>>];
  RET [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#f8f9fa"><B>RETURN</B> on the staging subpage</TD></TR>
    <TR><TD>writer: the coworker, own page</TD><TD>untrusted input</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">BLOCK ID | ACCOUNT | RECORDS<BR/>USED RANGE | DIFFERENCE</TD></TR>
    <TR><TD COLSPAN="2">5.8.4, 6.2</TD></TR></TABLE>>];
  SCHED [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#f8f9fa"><B>SCHEDULE LOG</B> entry</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">block ID | prompt | ETA<BR/>COMMISSIONED / OWNED BY /<BR/>LANDED / EXPIRED</TD></TR>
    <TR><TD COLSPAN="2">5.9.2, 5.9.4</TD></TR></TABLE>>];
  WBL [label=<<TABLE BORDER="1" CELLBORDER="1" CELLSPACING="0" CELLPADDING="3">
    <TR><TD COLSPAN="2" BGCOLOR="#f8f9fa"><B>WORK-BLOCK LOG</B> entry</TD></TR>
    <TR><TD COLSPAN="2" ALIGN="LEFT">process used | implications<BR/>general-audience summary</TD></TR>
    <TR><TD COLSPAN="2">5.9.2</TD></TR></TABLE>>];
  MANIFEST -> LOCK [label="UWC-LOCK\n5.7.1", style=dashed];
  MANIFEST -> COLLAB [label="UWC-COLLABORATION\n5.8.1", style=dashed, constraint=false];
  MANIFEST -> PANEL [label="UWC-PANEL\n5.12.1", style=dashed, constraint=false];
  COLLAB -> PET [label="QUEUE\nrevision order of the petition edits\n5.8.2"];
  COLLAB -> ASSIGN [label="ASSIGNMENTS\nwritten by the lead\n5.8.3", constraint=false];
  PET -> ASSIGN [label="ASSIGNED TO\nSTATUS ASSIGNED\n5.8.2", style=dotted, constraint=false];
  ASSIGN -> RET [label="RETURN PAGE\nBLOCK ID must match, not EXPIRED\n5.8.4"];
  ASSIGN -> SCHED [label="WORKLOAD\npointer, no copy\n5.8.3", style=dotted];
  PANEL -> SCHED [label="SCHEDULE LOG\nstates 5.9.2"];
  PANEL -> WBL [label="WORK-BLOCK LOG\n5.9.2"];
  LOCK -> ASSIGN [label="GRANT\nlead's grant number\nat assignment\n5.8.3", style=dotted, constraint=false];
  { rank=same; LOCK; PANEL; }
  { rank=same; COLLAB; }
  { rank=same; PET; SCHED; }
  { rank=same; ASSIGN; WBL; }
  LOCK -> COLLAB [style=invis]; PANEL -> SCHED [style=invis]; COLLAB -> PET [style=invis]; PET -> ASSIGN [style=invis]; ASSIGN -> RET [style=invis];
}

Text equivalent

A DRAFT UWC page, the draft of a UUID Workspace Container (UWC), passes its zone checks into a CANDIDATE CERTIFICATE on staging (5.5.3), which H-DECL lands as a DECLARATIONS line (5.5.4); TPX, the controller, verifies each build against it on the BUILD CHAIN page (5.6.1) and instantiates the container's MANIFEST, whose BADGE is written last (5.10.1). The CENTRAL HUB reaches LIBRARY PAGES and manifests (5.11.7). Each container has a LOCK page (5.7.2), a COLLABORATION page with PETITION rows in revision order, ASSIGNMENT rows written by the lead and RETURNS on staging subpages (5.8), and a CONTROL PANEL with its SCHEDULE LOG and WORK-BLOCK LOG (5.9.2, 5.12.1). The Principia Machina Specification (TPS) is the instruction artifact whose digest D(TPS), over the text of its pages' preformatted blocks, enters the instruction set digest D(IS) with the version and the other instruction artifacts; the drawing's "D(IS) = its digest" names that pair (5.14 CR9); IMPLEMENTATION entries conform to it (5.11.4, 6.1). Not drawn: each chain page is a CHAIN HEAD over APPEND VOLUMES (5.6.10); and the pages added since the drawing: the community ledger and each container's community view (5.9.13), each account's dossier (5.3.27, 5.13.2), the falcon pages (5.20), the bibliography volumes (5.21.3) and the environment module pages (5.22.12). Beside the current D(IS) the hub carries D(TPS) and the ordered list [title, h] of the declared TPS version's kept pages, as TPX computed them at H-DECL's declaration (CR9), and replaces the three together at the next TPS declaration; the list is not drawn (5.11.16; revision 8, proposed).

@@ Line 1: / Line 1: @@
 {{TPM map}}
 {{DISPLAYTITLE:Diagram C2 Recorder pages}}
-''Conceptual diagram 2 of 5.'' Part of [[The Principia Machina/Hub|the TPM hub]].
+''Conceptual diagram 2 of 7.'' Part of [[The Principia Machina/Hub|the TPM hub]].
 * KIND: structure
 * LANGUAGE: DOT
 * GENERATED FROM: declared by the human 2026-09-17; TPS 5.5-5.13
-* STATUS: hand-authored at TPS 0.1.0; conceptual, kept by the human; never generated
+* STATUS: hand-authored at TPS 0.1.0; checked against TPS 0.3.0 on 2026-09-28: owed a redraw (not drawn: each chain page a CHAIN HEAD over APPEND VOLUMES, 5.6.10; the pages added since: the community ledger and views, the dossiers, the falcon pages, the bibliography volumes, the environment module pages); checked against revision 7 on 2026-09-29, declared final as TPS 0.4.0 on 2026-09-30: also, TPS's D(TPS) and D(IS) are two digests, not one, 5.14 CR9; checked against revision 8, proposed as TPS 0.5.0, on 2026-09-30: also owed a redraw (the PETITION row's CAPABILITY names neither the execution mode nor the fingerprint and sponsor, D(PROMPT), the HARNESS MODE or the PROMPT MANIFEST, 5.8.2, 5.8.10, 5.8.12); not drawn: the page list [title, h] the hub carries beside D(TPS) and D(IS), 5.11.16; conceptual, kept by the human; never generated
 * SOURCE SHA-256: <code>d7fa9068d986a1855375d2520d084f46231086dec464e1c10bbb94bce8e7ed9d</code>, <code>1feb7a8399f70cbdcf2aa059c16bc1091088bb253b03ed87e8292dbbda755f49</code>
@@ Line 308: / Line 308: @@
 == Text equivalent ==
-A DRAFT UWC page passes its zone checks into a CANDIDATE CERTIFICATE on staging (5.5.3), which [[The Principia Machina/Roles|H-DECL]] lands as a DECLARATIONS line (5.5.4); TPX verifies each build against it on the BUILD CHAIN page (5.6.1) and instantiates the container's MANIFEST, whose BADGE is written last (5.10.1). The CENTRAL HUB reaches LIBRARY PAGES and manifests (5.11.7). Each container has a LOCK page (5.7.2), a COLLABORATION page with PETITION rows in revision order, ASSIGNMENT rows written by the lead and RETURNS on staging subpages (5.8), and a CONTROL PANEL with its SCHEDULE LOG and WORK-BLOCK LOG (5.9.2, 5.12.1). TPS is the instruction artifact whose digest is D(IS); IMPLEMENTATION entries conform to it (5.11.4, 6.1).
+A DRAFT UWC page, the draft of a UUID Workspace Container (UWC), passes its zone checks into a CANDIDATE CERTIFICATE on staging (5.5.3), which [[The Principia Machina/Roles|H-DECL]] lands as a DECLARATIONS line (5.5.4); TPX, the controller, verifies each build against it on the BUILD CHAIN page (5.6.1) and instantiates the container's MANIFEST, whose BADGE is written last (5.10.1). The CENTRAL HUB reaches LIBRARY PAGES and manifests (5.11.7). Each container has a LOCK page (5.7.2), a COLLABORATION page with PETITION rows in revision order, ASSIGNMENT rows written by the lead and RETURNS on staging subpages (5.8), and a CONTROL PANEL with its SCHEDULE LOG and WORK-BLOCK LOG (5.9.2, 5.12.1). The Principia Machina Specification (TPS) is the instruction artifact whose digest D(TPS), over the text of its pages' preformatted blocks, enters the instruction set digest D(IS) with the version and the other instruction artifacts; the drawing's "D(IS) = its digest" names that pair (5.14 CR9); IMPLEMENTATION entries conform to it (5.11.4, 6.1). Not drawn: each chain page is a CHAIN HEAD over APPEND VOLUMES (5.6.10); and the pages added since the drawing: the community ledger and each container's community view (5.9.13), each account's dossier (5.3.27, 5.13.2), the falcon pages (5.20), the bibliography volumes (5.21.3) and the environment module pages (5.22.12). Beside the current D(IS) the hub carries D(TPS) and the ordered list [title, h] of the declared TPS version's kept pages, as TPX computed them at H-DECL's declaration (CR9), and replaces the three together at the next TPS declaration; the list is not drawn (5.11.16; revision 8, proposed).
 [[Category:The Principia Machina]]

BFP Rauch (talk | contribs)

Latest revision as of 13:34, 30 September 2026

Text equivalent