docs: normalize canonical book workspace paths

.gitignore

@@ -119,3 +119,33 @@ thailand_proposals/**/*.m4a
 thailand_proposals/**/*.mp3
 thailand_proposals/**/*.wav
 thailand_proposals/**/*.webp
+# Curated public history exceptions. Raw and draft history remains ignored.
+!/uet_history/3_publish/
+!/uet_history/3_publish/books/
+!/uet_history/3_publish/books/README.md
+!/uet_history/3_publish/books/BOOK_REGISTRY.json
+!/uet_history/3_publish/books/00_uet_core_theory/
+/uet_history/3_publish/books/00_uet_core_theory/*
+!/uet_history/3_publish/books/00_uet_core_theory/README.md
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/
+/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/*
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/README.md
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/book_1_blueprint.md
+# Re-open only curated history files while keeping the rest of uet_history local-only.
+!/uet_history/
+/uet_history/*
+!/uet_history/README.md
+!/uet_history/PUBLIC_MANIFEST.md
+!/uet_history/3_publish/
+/uet_history/3_publish/*
+!/uet_history/3_publish/books/
+/uet_history/3_publish/books/*
+!/uet_history/3_publish/books/README.md
+!/uet_history/3_publish/books/BOOK_REGISTRY.json
+!/uet_history/3_publish/books/00_uet_core_theory/
+/uet_history/3_publish/books/00_uet_core_theory/*
+!/uet_history/3_publish/books/00_uet_core_theory/README.md
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/
+/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/*
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/README.md
+!/uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/book_1_blueprint.md

AGENTS.md

@@ -433,6 +433,14 @@ When touching standards such as `docs/topics/For Work/` or `AGENTS.md`, prefer a
 separate commit from topic-level research changes unless the standards update is
 required to explain the same hardening wave.
 
+## Book workspace path discipline
+
+- `uet_history/3_publish/books/BOOK_REGISTRY.json` is the canonical map for book identity and paths.
+- Before creating or publishing a book path, inspect the registry and existing `books/` folders.
+- An existing book folder is canonical. Do not create a semantic alias for the same book.
+- Keep raw and draft directories local unless the registry explicitly lists a reviewed public file.
+- A book update is complete only when the canonical source, registry state, scoped commit, and public `main` path agree.
+- If a public copy differs from the canonical working file, stop and record the drift before publishing another copy.
 ## Agent behavior expectations
 
 - Be useful for audits, critique, normalization, and learning support.

WORK_LEDGER/2026/2026-07-16.md

@@ -0,0 +1,11 @@
+# Work Ledger - 2026-07-16
+
+## Book workspace path normalization
+
+- area: `theory-history`, `book-writing`, `repo-ops`
+- workspace: `uet_history/3_publish/books/`
+- changed: added `BOOK_REGISTRY.json`, aligned Book 1 to `0.1 Econmi - The Origin of Wealth/`, retired the duplicate public alias, and documented the shared path rule
+- verification: registry JSON parsed; public-file and duplicate-path checks passed; Book 1 public file hash matched the local canonical source before whitespace normalization; `git diff --cached --check` passed
+- public-safety: `partial`
+- excluded: raw conversations, media, `1_raw/`, and `ch_drafts/` remain local-only; other book tracks remain registry-only until reviewed
+- next action: push the scoped repair branch, merge through one PR, and verify the canonical Book 1 URL on `main`

uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/README.md

@@ -0,0 +1,14 @@
+# The Origin of Wealth
+
+This is the canonical public entry point for Book 1 in the UET book workspace.
+
+## Public files
+
+- `book_1_blueprint.md` - current reviewed blueprint exported from the existing
+  Book 1 working folder.
+
+Raw notes, chat exports, and chapter drafts remain local to the working folder
+until they pass the project review and publication boundary.
+
+The identity and path for this book are recorded in the parent
+`BOOK_REGISTRY.json`. Do not create a second folder for the same book.

uet_history/3_publish/books/BOOK_REGISTRY.json

@@ -0,0 +1,94 @@
+{
+  "schema_version": 1,
+  "canonical_root": "uet_history/3_publish/books",
+  "rules": {
+    "existing_folder_wins": true,
+    "new_semantic_aliases_allowed": false,
+    "raw_directories_public_by_default": false,
+    "draft_directories": ["1_raw", "ch_drafts"]
+  },
+  "books": [
+    {
+      "book_id": "00_uet_core_theory",
+      "title": "Core UET Theory",
+      "canonical_source_path": "uet_history/3_publish/books/00_uet_core_theory",
+      "public_path": "uet_history/3_publish/books/00_uet_core_theory",
+      "state": "public_curated",
+      "public_files": ["README.md"]
+    },
+    {
+      "book_id": "0.1_origin_of_wealth",
+      "title": "The Origin of Wealth",
+      "canonical_source_path": "uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth",
+      "public_path": "uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth",
+      "state": "public_curated",
+      "public_files": ["README.md", "book_1_blueprint.md"],
+      "excluded_local_paths": ["1_raw/", "ch_drafts/"]
+    },
+    {
+      "book_id": "0.2_ai_and_the_divergence",
+      "title": "AI and the Divergence",
+      "canonical_source_path": "uet_history/3_publish/books/0.2 Econmi - AI and the Divergence",
+      "public_path": "uet_history/3_publish/books/0.2 Econmi - AI and the Divergence",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "0.3_dynamic_energy_money",
+      "title": "Dynamic Energy Money",
+      "canonical_source_path": "uet_history/3_publish/books/0.3 Econmi - Dynamic Energy Money",
+      "public_path": "uet_history/3_publish/books/0.3 Econmi - Dynamic Energy Money",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "01_bio",
+      "title": "Biology",
+      "canonical_source_path": "uet_history/3_publish/books/01 bio",
+      "public_path": "uet_history/3_publish/books/01 bio",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "02_bio_psycho",
+      "title": "Biology and Psychology",
+      "canonical_source_path": "uet_history/3_publish/books/02 bio+psycho",
+      "public_path": "uet_history/3_publish/books/02 bio+psycho",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "03_psy_econmi",
+      "title": "Psychology and Economics",
+      "canonical_source_path": "uet_history/3_publish/books/03 psy + Econmi",
+      "public_path": "uet_history/3_publish/books/03 psy + Econmi",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "04_thai_politics",
+      "title": "Thai Politics",
+      "canonical_source_path": "uet_history/3_publish/books/04_thai_politics",
+      "public_path": "uet_history/3_publish/books/04_thai_politics",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "05_reformation_of_the_mind",
+      "title": "Reformation of the Mind",
+      "canonical_source_path": "uet_history/3_publish/books/05_reformation_of_the_mind",
+      "public_path": "uet_history/3_publish/books/05_reformation_of_the_mind",
+      "state": "local_only",
+      "public_files": []
+    },
+    {
+      "book_id": "deprecated_origin_of_wealth_alias",
+      "title": "Retired duplicate alias",
+      "canonical_source_path": null,
+      "public_path": "uet_history/3_publish/books/origin_of_wealth_and_economics",
+      "state": "deprecated_alias",
+      "replacement_book_id": "0.1_origin_of_wealth",
+      "public_files": []
+    }
+  ]
+}

uet_history/3_publish/books/README.md

@@ -1,20 +1,36 @@
 # UET Book Workspace
 
-This folder contains public-facing book and long-form narrative scaffolds.
+This directory is the public-facing book workspace. `BOOK_REGISTRY.json` is
+the source of truth for book identity, canonical paths, public paths, and
+publication state.
 
-Current public projects:
+## Path rule
 
-- `00_uet_core_theory/` - core UET theory explanation scaffold
-- `origin_of_wealth_and_economics/` - public outline and working blueprint for the economics`r`n  and wealth-origin book track
+Existing book folders are canonical. Agents must inspect this directory and
+the registry before creating a path. A new semantic alias for an existing book
+is not allowed.
 
-Draft inputs and raw chapter sources remain local-only until reviewed.
+The working source and public output use the same book identity. Raw material
+and chapter drafts may remain local, but they must not be silently replaced by
+a renamed public copy.
 
-## Publication Boundary
+## Current public tree
 
-The economics and wealth-origin track now has a small public outline so readers
-can understand what the project is about. The full local drafts are still not
-published here because they need review for encoding, claim strength, source
-boundary, and raw/draft separation.
+| Book | Public path | State |
+| --- | --- | --- |
+| Core UET theory | `00_uet_core_theory/` | curated scaffold |
+| The Origin of Wealth | `0.1 Econmi - The Origin of Wealth/` | curated blueprint |
 
-Future additions should promote reviewed chapter sections in small scoped PRs
-instead of dumping raw notes or unreviewed draft folders into the public tree.
+The remaining book tracks are recorded in `BOOK_REGISTRY.json` as local-only
+until their reviewed public files are promoted. The previous
+`origin_of_wealth_and_economics/` path was a duplicate alias and is retired.
+
+## Publication workflow
+
+1. Update the existing canonical book folder.
+2. Keep `1_raw/` and `ch_drafts/` outside the public file list.
+3. Update the registry state and public file list.
+4. Commit the coherent book change and verify the public `main` path.
+
+One workflow applies to every book. A book-specific change must not create a
+book-specific directory convention.

uet_history/PUBLIC_MANIFEST.md

@@ -1,47 +1,41 @@
 # UET History Public Manifest
 
-**Updated:** 2026-07-08
-**Purpose:** Replace the old public `uet_history` tree with a curated structure
-that reflects the current local workflow without publishing raw folders.
+**Updated:** 2026-07-16
+**Purpose:** Describe the curated public history tree and keep its paths
+aligned with the local book workflow.
 
-## Included In This Public Update
+## Included in the public tree
 
 | Path | Status | Notes |
 | --- | --- | --- |
-| `uet_history/README.md` | included | Public orientation for the current history workspace. |
-| `uet_history/PIPELINE.md` | included | Raw -> digest -> publish workflow boundary. |
-| `uet_history/STATUS_REPORT.md` | included | Current public status summary. |
-| `uet_history/2_digest/README.md` | included | Digest-layer orientation. |
-| `uet_history/2_digest/_index.json` | included | Empty digest registry scaffold. |
-| `uet_history/3_publish/README.md` | included | Publish-layer orientation. |
-| `uet_history/3_publish/books/README.md` | included | Book workspace orientation. |
-| `uet_history/3_publish/books/00_uet_core_theory/README.md` | included | Core UET theory book placeholder. |
-| `uet_history/3_publish/books/origin_of_wealth_and_economics/README.md` | included | Public concept outline for the economics and wealth-origin book track. |
-| `uet_history/3_publish/books/origin_of_wealth_and_economics/the_origin_of_wealth_book_blueprint.md` | included | Working public blueprint for review; not treated as a validated economics result. |
-
-## Excluded From This Public Update
-
-| Local area | Reason |
-| --- | --- |
-| `uet_history/1_raw/` | Raw conversations, notes, transcripts, and source dumps need privacy and provenance review before publication. |
-| `uet_history/_archive/` | Local archive and recovery material; not a current public source tree. |
-| `uet_history/Dev_history/` | Contains raw development snapshots, ZIPs, videos, and large historical assets. |
-| nested `1_raw/` folders inside `3_publish/` | Draft input material; not yet reviewed as public-safe. |
-| remaining economics and wealth-origin book drafts | The public outline and blueprint are included, but remaining local drafts still need encoding, claim-strength, source-boundary, and raw/draft review before promotion. |
-| media/audio/video/PDF/ZIP files | Large or potentially private assets; should be handled by a separate asset plan. |
-
-## Legacy Paths Retired From Main
-
-The older public paths below are removed from the current `main` tree in this
-update because they represented a mixed legacy archive rather than the current
-curated workflow:
-
-- `uet_history/documents/`
-- `uet_history/equations/`
-- `uet_history/media/`
-- `uet_history/obsolete/`
-- `uet_history/research/`
-- `uet_history/theory/`
-
-This does not mean the historical material is erased from Git history. It means
-those paths are no longer the active public organization model.
+| `uet_history/README.md` | included | Public orientation for the history workspace. |
+| `uet_history/PIPELINE.md` | included | Raw -> digest -> publish boundary. |
+| `uet_history/STATUS_REPORT.md` | included | Public status summary. |
+| `uet_history/3_publish/books/README.md` | included | Shared book path and publication rules. |
+| `uet_history/3_publish/books/BOOK_REGISTRY.json` | included | Machine-readable registry for every known book track. |
+| `uet_history/3_publish/books/00_uet_core_theory/README.md` | included | Core theory scaffold. |
+| `uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/README.md` | included | Canonical public entry point for Book 1. |
+| `uet_history/3_publish/books/0.1 Econmi - The Origin of Wealth/book_1_blueprint.md` | included | Curated Book 1 blueprint from the canonical working folder. |
+
+## Path and source policy
+
+`uet_history/3_publish/books/BOOK_REGISTRY.json` is the controlling map. The
+existing numbered or named folder wins when a duplicate public path appears.
+The registry must be updated before a new book path is introduced.
+
+Raw conversations, source dumps, media, audio, PDFs, archives, and nested
+`1_raw/` or `ch_drafts/` folders remain local-only unless explicitly listed as
+reviewed public files.
+
+## Local-only book tracks
+
+The registry records the local source paths for the other book tracks without
+pretending that their drafts are already public. This separates discoverability
+from publication and prevents a missing public file from being mistaken for a
+missing local project.
+
+## Retired duplicate
+
+`uet_history/3_publish/books/origin_of_wealth_and_economics/` was a duplicate
+public alias for Book 1. It is removed from the active public tree; its Git
+history remains available.