Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions project/handoff/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ SEM-09B and SEM-09C are complete. D045 through D052 migrated all eight module le

The pamphlet shelf then became its own commission. A nine-reader survey judged every existing pamphlet a worthy companion and established the shelf's real position: the manual deliberately carries doctrine with almost no topic exercises, so the pamphlets are the corpus's entire practice apparatus. The survey's gap map guided the expansion that followed, one reviewed pull request per piece: the spoken-punctuation pamphlet grew to carry the full twenty-interjection class and the counterpart-less marks, and five new practice companions covered the adverbial clause relators, tense and aspect, pronouns and topic-drop, the noun phrase with its classifiers, and coordination. The gap map is now empty. Every core grammar topic has a practice home, the shelf holds fourteen pamphlets, and all but source-material are module-free; that one still demonstrates the module choice its own first chapter teaches. The new companions quote validated doctrine examples wherever one exists and lean on cross-references at shared borders rather than reteaching a neighbor's ground. Future pamphlets wait on the maintainer's direct nomination from gap analysis; he ruled the older demonstrated-struggle gate impractical while the documents have no outside readers.

The writing system then consolidated. On 23 July 2026 the maintainer retired the native glyph-mode exploration and moved its studies to `archive/writing_systems/` as history; Phi's one second hand is Tengwar, specified and rendered from `tengwar/` at the repository root. The lexicon explorer now shows every headword's Tengwar rendering in the opened entry, at the Tengwar pamphlet's two-to-one scale, assembled in the browser from build-time placement data kept byte-identical to the Python renderer's output, with the space above and below the rendering balanced by measurement. Displaying all 1,275 headwords at once gave the renderer its first full-lexicon review and its first recorded finding, deferred by the maintainer: the a tehta sits slightly low over the h tengwa. In the same span the compound registry returned to word-pair scale: the maintainer ruled its one four-word entry an overreach of compound toward canonized phrase, so `lothea korua`, love-heart, is registered in its place while `mawha norui` composes freely before it in the Metta Sutta's own lines.

PED-08 is complete. The book is published whole: the cold open, chapters 1 through 14, the close, and a consolidated bibliography, every file merged through its own reviewed pull request and rendered on the site. Post-merge citation audits are archived for chapters 3 through 5, 8 through 10, 12 through 14, and the close, and the planning treatment is archived at `archive/book_treatment.md`. The chapter method that produced the book binds any revision pass: a verification agent pins every source with verbatim quotes before drafting, author names and title lines come from Crossref at entry-writing time, repository receipts are checked by grep rather than recall, a list attributed to a source is treated as a quotation, the register follows the maintainer's hedging-low and warmth-high rulings recorded in [`language_and_voice.md`](language_and_voice.md), the full voice protocol runs with the counting pass, and an audit's own findings are verified before they are applied. The whole-book revision read of 22 July 2026 ran under that method as the first pass over the published whole: a front-to-back read logged findings at the moment of noticing, every finding was verified by grep before it reached the maintainer, and one reviewed pull request repaired all fourteen. That repair removed the chapter 2 and 6 Ring Verse duplication, corrected the primer facts in chapter 9 and a forward reference in chapter 10, thinned hedging to the once-per-book rule where it had crowded, and left every chapter reference byte-identical to its bibliography entry.

No work is commissioned. The book's title remains The Phi Book for now, by the maintainer's ruling, with *A Language You Cannot Hurry* and *Announce, Then Deliver* on record as candidates. The bibliography's citation style is uniform with DOIs intact, and the whole-book revision read is complete, so further revision waits on the maintainer's own reading of the finished book.
Expand Down
4 changes: 2 additions & 2 deletions project/handoff/current_state.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ All eight profiles already have canonical JSON membership, a generated module in

## Corpus state

The literary shelf has completed its full review against the current lexicon. It contains nine close translations and eleven transmutations; seven works have both. *News from Nowhere* is one 32-chapter work with the first three chapters transmuted and reviewed. The current review record is [`documents/evaluation/active_text_corpus_review.md`](../../documents/evaluation/active_text_corpus_review.md).
The literary shelf has completed its full review against the current lexicon. It contains nine close translations and eleven transmutations; seven works have both. *News from Nowhere* is one 32-chapter work with the first three chapters transmuted and reviewed. The current review record is [`documents/evaluation/active_text_corpus_review.md`](../../documents/evaluation/active_text_corpus_review.md). The compound registry holds 76 rows at word-pair and word-triple scale by the maintainer's ruling of 23 July 2026: its one four-word entry overreached from compound toward canonized phrase, so `lothea korua`, love-heart, is registered in its place and `mawha norui` composes freely before it in the Metta Sutta's lines.

SEM-09D is complete. Fifteen literary passes finished the shelf, and all three drafted *News from Nowhere* chapters are among them. All seven manual parts, all twenty-seven primer files, and the nine pamphlets then on the shelf are reviewed without a lexical gap, and the current-documents sweep closed with the evaluation corpus. Parts IV and VI each use one explicitly labelled optional term with a base alternative; Part VII teaches module words only inside their named learning paths, while the general primer and every pamphlet except source-material use no module terms; the source-material pamphlet demonstrates the module choice it teaches. A Phi passage changes only when the current form is more faithful or natural there. A transparent composition stays when its parts still teach or express the thought better, and every changed sentence and dependency receives validation.

Expand Down Expand Up @@ -165,7 +165,7 @@ The live entries are:
| Sexual and reproductive anatomy | Queued scenario-led vocabulary effort | Begin as its own respectful corpus and vocabulary project, not as an unnoticed extension of Medical vocabulary. |
| Legacy vocabulary prose audit | Complete | D044 completed the base queue, D045 through D052 completed all eight module learning paths, and SEM-09D completed the literary shelf, the drafted book, the manual, the primer, the nine pamphlets then current, and the current documents. Reopen a passage only for a real semantic, factual, voice, or corpus problem. |
| Lexical relations between content words | Parked | The explorer or project needs curated related-word navigation strongly enough to add and maintain a schema field. |
| Tengwar renderer verification | Parked | Tengwar work resumes or approaches publication status. |
| Tengwar renderer verification | Parked, with a live review surface | The lexicon explorer now renders all 1,275 headwords in Tengwar, and the first finding is recorded and deferred: the a tehta sits slightly low over the h tengwa, to be adjusted through the placement tweaks in `tengwar/glyphs.json` when the maintainer reopens glyph tuning. |
| Solarpunk community engagement | Open strategic question | Daniel is ready to offer Phi outside its repository and decide what a healthy invitation looks like. |

Speech evidence, outside learner evidence, community governance, and print publication remain evidence-gated or deferred in the roadmap. Do not mark them complete because tools or materials exist. Do not invent participants, observations, or adoption.
Expand Down
6 changes: 4 additions & 2 deletions project/handoff/repository_workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,14 +148,16 @@ After staging intended source and generated changes, rerun the generator and use
python3 scripts/build_site.py
```

It renders the invitation, colophon, short road, primer, manual, book, texts, and pamphlets; generates lexicon and compound data; and checks that the text and pamphlet catalogues match their directories.
It renders the invitation, colophon, short road, primer, manual, book, texts, and pamphlets; generates lexicon, compound, and Tengwar placement data; and checks that the text and pamphlet catalogues match their directories.

The top navigation on every rendered page reads kia, walk, primer, book, manual, pamphlets, texts, lexicon, in that maintainer-set order. The single word walk is the shelf label for the short road; the link target stays `short_road.html` and the page keeps its own title. The nav markup lives in eight templates inside `scripts/build_site.py` and in the static `site/explore.html`, so a shelf change touches all nine.

The maintained shelf order and display metadata live in `texts/catalogue.json` and `pamphlets/catalogue.json`. `scripts/content_catalogues.py` is the shared library that rejects duplicate, missing, uncatalogued, or malformed entries. Update the catalogue in the same PR as any shelf addition, removal, rename, or reorder.

The explorer has several settled interaction rules. `any module` includes base vocabulary and every module word; `base vocabulary` includes only entries whose `modules` array is absent or empty; a named module includes every word listing that module, including words shared with other modules. The `Phi word` search scope matches the entry form alone and never returns registered compounds. Compounds appear in `all fields` when no word facet is active, or under their own search scope. Pressing `/` focuses the search box. Preserve these distinctions when changing `site/app.js` or `site/explore.html`.

The opened entry also shows the headword's Tengwar hand at the pamphlet's two-to-one scale, with the space above and below it balanced. The build writes `tengwar_words.json`, one shared glyph dictionary plus pre-rounded per-word placements from the renderer's own layout, and `app.js` assembles markup kept byte-identical to `render_line()`'s, so a rendering question is answered in `scripts/tengwar.py`, never patched in the browser composer.

Do not leave a local server running by default. Daniel uses SSH to reach the Mac mini. A successful `build_site.py` run is enough for routine repository work. If a specific preview arrangement is requested, the disposable command is:

```bash
Expand All @@ -164,7 +166,7 @@ python3 -m http.server -d build/site

The public site deploys from `build/site/` on each push to `main` through `.github/workflows/pages.yml` and is available at [dcellison.github.io/phi](https://dcellison.github.io/phi/).

Routine content work does not require headless Chrome or a screenshot. Use browser automation only when a UI change genuinely needs visual or interaction verification.
Routine content work does not require headless Chrome or a screenshot. Use browser automation only when a UI change genuinely needs visual or interaction verification. A stylesheet or layout change is exactly that case: measure the computed style and geometry with a headless probe page before shipping, and never trust selector arithmetic alone, because a generic rule such as `.entry-body p` outweighs a new single-class rule and once swallowed three merged spacing adjustments without a visible pixel changing.

## GitHub presence

Expand Down
Loading