Edition README
Self-Improving Intelligence: visual guide
README.md
1 # Self-Improving Intelligence — A Visual Guide
2
3 **Komorebi P. · Operation Komorebi · Visual companion v1.0.0 · 8 October 2026**
4
5 A 36-page standalone companion to *Self-Improving Intelligence: Representation,
6 Discovery, and Recursive Revision*, first edition v1.0.0. The unchanged 60-page
7 manuscript is included under `references/`.
8
9 ## Read
10
11 Open `Self_Improving_Intelligence_Visual_Guide_v1.0.0.pdf`. All 36 pages have
12 bookmarks. The final reading-route table links back to the corresponding guide
13 pages. Source footers use `[S]` for the included manuscript, with its **printed**
14 page numbers rather than the PDF viewer's page index.
15
16 | Guide pages | Subject |
17 |---|---|
18 | 3–12 | What changes, the eight-cell diagnosis, complete trees, model uncertainty, and transport |
19 | 13–21 | Checked compiler shortcuts, a learned pruning rule, and repair-relative scope |
20 | 22–28 | Learned equations, exact evidence preservation, dependency updates, and costs |
21 | 29–36 | Fresh evidence, recursive continuation, remaining supplied structure, and reference routes |
22
23 Each illustrated page pairs a mechanism with its interpretation and a boundary.
24 The guide distinguishes constructed or acquired artifacts from the grammar,
25 teacher, checker, models, and other structures supplied by the designer.
26
27 ## What is in this package
28
29 - `code/build_guide.py`: editable Python/ReportLab drawing and text source.
30 - `code/check_guide.py`: focused exact examples, source-count transcription
31 checks, PDF geometry, glyph, and navigation checks.
32 - `code/export_pages.py`: exports the vector plates and selected previews.
33 - `code/verify_release.py`: verifies this frozen snapshot before rebuilding.
34 - `vector_pages/`: 36 individual SVG plates. Text is outlined for portable
35 appearance. Edit wording in the Python source, then regenerate.
36 - `previews/`: the cover, full-tree/path plate, and certificate-dependency plate.
37 - `data/`: page summaries and a source crosswalk in JSON/CSV.
38 - `references/`: the unchanged source manuscript, its statement/assumption
39 indexes and resource ledger, and selected unchanged JSON evidence records.
40 - `validation/`: focused checks, source integrity, rendering, and rebuild records.
41 - `REVIEW_NOTES.md`: changes, actual failures and corrections, and review limits.
42
43 This is the **guide source package**, not a replacement for the original full
44 research source package. The original research programs and complete test suite
45 remain in that original release.
46
47 ## Rebuild
48
49 Python 3.10 or newer is needed. Versions used here are pinned in `requirements.txt`.
50 Run from this directory:
51
52 ```bash
53 python code/verify_release.py
54 python -m pip install -r requirements.txt
55 python code/build_guide.py
56 python code/check_guide.py
57 python code/export_pages.py
58 ```
59
60 The verifier should run **before** commands that replace generated outputs or
61 execution receipts. Changed files will no longer match the frozen inventory.
62
63 The same Python commands can be used from PowerShell. Windows execution has not
64 been tested in this release.
65
66 ## Host fonts
67
68 No standalone font files are included. The PDF embeds its used fonts; SVG plates
69 carry their glyph outlines. Regenerating the source uses host-installed fonts.
70 The script searches common Linux locations for Lato, Noto Serif, and DejaVu.
71 Alternatively, set `KOMOREBI_FONT_DIR` to a directory containing these six font
72 roles as `Body.ttf`, `Bold.ttf`, `Italic.ttf`, `Serif.ttf`, `SerifBold.ttf`, and
73 `Math.ttf`. Select legally available fonts with the necessary mathematical glyphs.
74
75 Substituting fonts can change line breaks. The builder deliberately rejects text
76 that exceeds its allocated space. Mathematical glyphs unsupported by the chosen
77 text face are rendered with the math face instead of silently disappearing.
78
79 ## Evidence boundary
80
81 The guide restates the first-edition theory. It does not report a new learned
82 agent, a new compiler benchmark, or new general mathematical results. Larger
83 algorithmic counters are transcribed from the included original JSON receipts.
84 Local examples are checked independently in the guide script.
85
86 The original 336,867-assertion suite was **not rerun** for this companion. Its
87 frozen 325-file source snapshot passed its original integrity verifier. Neither
88 checksum equality nor guide checks establish independent peer review or a
89 proof-assistant certificate.