|
1 | 1 | # HUF Repository Map |
2 | 2 |
|
| 3 | +*Updated: 2026-04-09 (S016 — EITT discovery, repo reorganization)* |
| 4 | + |
3 | 5 | ## Folder Structure |
4 | 6 |
|
5 | 7 | ``` |
6 | 8 | HUF/ |
7 | | -├── docs/ # Canonical documents (latest versions only) |
8 | | -│ ├── index.md # Reading order and document status |
9 | | -│ ├── pillars/ # The four core HUF papers |
10 | | -│ │ ├── HUF_Sufficiency_Frontier_v3.6.docx |
11 | | -│ │ ├── HUF_Fourth_Category_v2.6.docx |
12 | | -│ │ ├── HUF_Triad_Synthesis_v1.6.docx |
13 | | -│ │ └── HUF_Collective_Trace_v5.10.docx |
14 | | -│ ├── governance/ # Review tracking and category classification |
15 | | -│ │ ├── review_catalog.md |
16 | | -│ │ ├── HUF_Category_Class_Structure_Tree_v1.4.docx |
17 | | -│ │ └── HUF_Collective_Review_March2026.docx |
18 | | -│ ├── explorations/ # Case studies, proofs, formal explorations |
19 | | -│ ├── reviews/ # Individual AI system review documents |
20 | | -│ └── appendices/ # Code appendix, methodology appendix |
21 | | -├── src/ # Source code |
| 9 | +├── README.md # What HUF claims, EITT discovery, how to test it |
| 10 | +├── START_HERE.md # Tiered entry paths (60s, 5m, 30m) + CoDa welcome |
| 11 | +├── CITATION.cff # Academic citation metadata |
| 12 | +├── CONTRIBUTING.md # 5-AI collective development model |
| 13 | +├── VERSION_MANIFEST.json # Machine-readable version tracking |
| 14 | +├── package.json # Node.js dependency (docx-js) for build system |
| 15 | +│ |
| 16 | +├── huf-gov/ # The open-loop instrument |
| 17 | +│ ├── science/ # MONITOR-001 taxonomy, papers |
| 18 | +│ ├── evidence/case-studies/ # Energy, GDP, Backblaze, Ramsar, Planck, Toronto |
| 19 | +│ ├── governance/ # LOOP-001, KILL-001, SAFE-001, HANDOFF-001 |
| 20 | +│ └── tools/spectrum-analyzer/ # v3 HTML analyzer + JSX source |
| 21 | +│ |
| 22 | +├── huf-cls/ # The closed-loop actuator (published for transparency) |
| 23 | +│ ├── architecture/ # CL-01 through CL-05 |
| 24 | +│ ├── formulas/ # Sigmoid actuator, K_eff, amplifier |
| 25 | +│ └── calibration/ # CL-05 sensitivity analysis |
| 26 | +│ |
| 27 | +├── reference/ # Foundation |
| 28 | +│ ├── machine-readable/ # 68+ JSON specifications |
| 29 | +│ ├── pillars/ # Theory, methodology, architecture (.docx) |
| 30 | +│ ├── technical-notes/ # PLL, calibration, architecture, interaction studies |
| 31 | +│ └── wiki/ # Quick-reference articles |
| 32 | +│ |
| 33 | +├── data/ # Reproducible datasets |
| 34 | +│ ├── manifests/ # Data, benchmark, and release manifests |
| 35 | +│ ├── checksums/ # SHA256 document integrity hashes |
| 36 | +│ ├── codawork-samples/S016/ # EITT adversarial, midrange confirmation, residual |
| 37 | +│ └── eitt_lab/ # ★ EITT calibration lab |
| 38 | +│ ├── copilot_outputs/ # Calibrator suite, boundary condition, PCA variants |
| 39 | +│ └── claude_analysis/ # Residual analysis (Hessian footprint) |
| 40 | +│ |
| 41 | +├── drafts/ # Submission papers, conference materials, work in progress |
| 42 | +│ ├── codawork-2026/ # CoDaWork 2026 full preparation suite |
| 43 | +│ │ ├── EITT_FINDING.md # ★ The EITT discovery |
| 44 | +│ │ ├── EITT_CODA_POSITION.md # ★ What EITT offers CoDa |
| 45 | +│ │ ├── EITT_ENTROPY_LANDSCAPE.md # ★ EITT vs 10 entropy territories |
| 46 | +│ │ ├── EITT_COMPLETE_EXPLANATION.md # ★ Plain-language walkthrough |
| 47 | +│ │ ├── DANCE_CARD.md # Conference strategy + 8 union territories |
| 48 | +│ │ ├── THE_CORE.md # Coherence chain for CoDa community |
| 49 | +│ │ ├── FORMULA_REFERENCE.md # HUF↔CoDa formula reference |
| 50 | +│ │ ├── BATTLE_CARD.md # 10 hardest questions |
| 51 | +│ │ └── ... # Abstract, translator, explorer, ternary, etc. |
| 52 | +│ ├── accord/ # Human-AI Accord |
| 53 | +│ └── papers/ # Academic submissions |
| 54 | +│ |
| 55 | +├── docs/ # Generated canonical documents |
| 56 | +│ ├── explorations/ # Case studies (Backblaze, energy, CDN, Planck, TTC) |
| 57 | +│ ├── governance/ # Review catalog, governance explainer, provenance |
| 58 | +│ ├── papers/ # 7 academic submissions (CBD, CoDa, GEOBON, IEEE, etc.) |
| 59 | +│ ├── reference/ # Handbooks, math foundations, Ramsar package |
| 60 | +│ ├── appendices/ # Code appendix, methodology appendix |
| 61 | +│ └── wiki/ # Quick-reference markdown articles |
| 62 | +│ |
| 63 | +├── src/ # Document build system |
22 | 64 | │ ├── builders/ # JavaScript docx-js builder scripts |
23 | 65 | │ │ ├── pillars/ # Pillar document builders |
24 | 66 | │ │ ├── volumes/ # Volume builders (Triad Synthesis) |
25 | 67 | │ │ ├── governance/ # Trace and tree builders |
26 | 68 | │ │ ├── explorations/ # Case study and proof builders |
27 | 69 | │ │ └── reviews/ # AI review document builders |
28 | 70 | │ ├── shared/ # Common modules (styles, citations, glossary) |
29 | | -│ └── validation/ # Document validation scripts |
30 | | -├── code/ # Executable code and experiments |
31 | | -│ └── helltest/ # MC-4 detection stress test |
32 | | -│ ├── scripts/ # Python scripts |
33 | | -│ ├── notebooks/ # Jupyter notebooks |
34 | | -│ └── results/ # Generated figures and reports |
| 71 | +│ └── validation/ # validate.py (docx integrity checker) |
| 72 | +│ |
| 73 | +├── code/ # Executable analysis tools |
| 74 | +│ ├── analysis/ # Backblaze, energy analysis scripts |
| 75 | +│ ├── helltest/ # MC-4 detection stress test (scripts, notebooks, results) |
| 76 | +│ └── tools/ # JSX diagnostic utilities |
| 77 | +│ |
35 | 78 | ├── notebooks/ # Educational content |
36 | | -│ └── onboarding/ # HUF onboarding notebook series (00-04) |
37 | | -├── data/ # Manifests and integrity data |
38 | | -│ ├── manifests/ # Data, benchmark, and release manifests |
39 | | -│ └── checksums/ # SHA256 document integrity hashes |
40 | | -├── archive/ # Non-canonical historical artifacts |
| 79 | +│ └── onboarding/ # HUF onboarding series (00-04) |
| 80 | +│ |
| 81 | +├── context-books/ # 4 audience editions (general, engineering, physics, sciences) |
| 82 | +├── math-books/ # Formal proofs (42 numbered items) |
| 83 | +│ |
| 84 | +├── process/ # Development record |
| 85 | +│ ├── collective-reports/ # AI collective reviews and master packages |
| 86 | +│ ├── governance-docs/ # Voting register, decision log, deployment strategy |
| 87 | +│ ├── review-traces/ # Version-traced review documents (v1.0-v5.10) |
| 88 | +│ └── session-ledgers/ # Per-session JSON records |
| 89 | +│ |
| 90 | +├── archive/ # Preserved history (nothing deleted, just organized) |
| 91 | +│ ├── HUFv4/ # Pre-Phase 3 working directory (version histories) |
| 92 | +│ ├── concepts/ # Experimental research (Kardashev, unity-vcore) |
| 93 | +│ ├── legacy-builders/ # Superseded builder scripts |
| 94 | +│ ├── legacy-generated-docs/ # Superseded .docx outputs |
| 95 | +│ ├── legacy-traces/ # Early review traces |
| 96 | +│ ├── papers-v1/ # First-draft academic papers |
41 | 97 | │ ├── prototypes/ # Layout prototypes |
42 | | -│ ├── legacy-generated-docs/ # Superseded .docx (prefer git history) |
43 | | -│ └── legacy-builders/ # Superseded builder scripts |
| 98 | +│ ├── ramsar-pre-standardized/ # Early Ramsar materials |
| 99 | +│ ├── superseded/ # Explicitly superseded items |
| 100 | +│ └── tools-pre-coda/ # Pre-CoDa analyzer versions |
| 101 | +│ |
44 | 102 | └── .github/workflows/ # CI: validate and build |
45 | 103 | ``` |
46 | 104 |
|
| 105 | +★ = New in S016 (April 2026) — EITT discovery materials |
| 106 | + |
47 | 107 | ## Document Status Legend |
48 | 108 |
|
49 | 109 | | Status | Meaning | |
50 | 110 | |--------|---------| |
51 | 111 | | **Canonical** | Current latest version, lives in `docs/` | |
52 | | -| **Superseded** | Replaced by a newer version; preserved in git history | |
53 | | -| **Archival** | Historical artifact; lives in `archive/` if needed | |
54 | | -| **Experimental** | Work in progress; lives in `code/` or working branch | |
| 112 | +| **Active Draft** | Work in progress, lives in `drafts/` | |
| 113 | +| **Superseded** | Replaced by newer version; preserved in git history or `archive/` | |
| 114 | +| **Archival** | Historical artifact; lives in `archive/` with provenance note | |
| 115 | +| **Experimental** | Exploratory work; lives in `code/` or `archive/concepts/` | |
55 | 116 |
|
56 | 117 | ## Release Policy |
57 | 118 |
|
58 | 119 | Only canonical documents live on `main`. Superseded versions are accessible through git tags, commit history, or GitHub Releases (binary attachments). The `VERSION_MANIFEST.json` tracks what is current. |
| 120 | + |
| 121 | +## For CoDa Researchers |
| 122 | + |
| 123 | +If you're arriving from CoDaWork 2026 or the compositional data analysis community, start with [`START_HERE.md`](START_HERE.md) — the "For CoDa" section points directly to the EITT finding and all supporting materials. The short version: we found that Shannon entropy is near-invariant under geometric-mean temporal decimation, and we think the CoDa community is best positioned to prove (or disprove) it. |
0 commit comments