Skip to content

Commit 26c2ba5

Browse files
Structure for fast refresh and component integrity
1 parent 7a6804f commit 26c2ba5

141 files changed

Lines changed: 44039 additions & 19 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitattributes

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,10 @@
22
*.docx filter=lfs diff=lfs merge=lfs -text
33
*.pdf filter=lfs diff=lfs merge=lfs -text
44
*.xlsx filter=lfs diff=lfs merge=lfs -text
5+
*.pptx filter=lfs diff=lfs merge=lfs -text
56
*.png filter=lfs diff=lfs merge=lfs -text
67
*.ipynb filter=lfs diff=lfs merge=lfs -text
8+
*.zip filter=lfs diff=lfs merge=lfs -text
79

810
# Ensure consistent line endings for text files
911
*.js text eol=lf
@@ -14,3 +16,6 @@
1416
*.yml text eol=lf
1517
*.txt text eol=lf
1618
*.cff text eol=lf
19+
*.html text eol=lf
20+
*.jsx text eol=lf
21+
*.csv text eol=lf

INDEX.json

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
{
2+
"_meta": {
3+
"type": "HUF-REPO-INDEX",
4+
"version": "2.0",
5+
"created": "2026-04-13",
6+
"author": "Peter Higgins / Claude",
7+
"purpose": "Master index of the Higgins Unity Framework repository. Maps every folder with status, purpose, and AI training notes.",
8+
"refresh_entry": "ai-refresh/HUF_FAST_REFRESH.json → ai-refresh/HUF_INTEGRITY_MANIFEST.json → this file"
9+
},
10+
11+
"repository_structure": {
12+
"ai-refresh": {
13+
"purpose": "AI speed-loading context. Any AI starts here.",
14+
"status": "active",
15+
"load_order": ["HUF_FAST_REFRESH.json", "HUF_INTEGRITY_MANIFEST.json", "huf_spec_v2.0.json"]
16+
},
17+
"science": {
18+
"purpose": "All scientific work organized by subject.",
19+
"subfolders": {
20+
"reference": "Core reference collection — 9 documents, start-here learning path",
21+
"core": "EITT mathematics, complete explanation, formulas, user handbook",
22+
"methodology": "Compositional governance scale, confidence index",
23+
"chemistry": "EITT chemistry results (CheMixHub), HUF-IDX, PRISM",
24+
"quantum": "HUF-QIT correspondence — 9 isomorphisms, Bell test, 3 books [NEW]",
25+
"eitt": "EITT evidence chain — 4 proofs, adversarial tests, Grok/ChatGPT briefs [NEW]",
26+
"coda-monitoring": "Perturbation-based drift detection protocol, EMBER/NGFS results [NEW]",
27+
"spectral": "Frequency-domain analysis of compositions [NEW]",
28+
"loudspeaker-analogy": "Origin story — crossover networks as compositions [NEW]",
29+
"wetlands": "Ramsar Convention monitoring, hidden variables [NEW]",
30+
"governance": "201-country ranking, governance science outputs [NEW]"
31+
}
32+
},
33+
"huf-gov": {
34+
"purpose": "Active governance — standards, protocols, kill tests, evidence, case studies.",
35+
"status": "active — operational"
36+
},
37+
"tools": {
38+
"purpose": "Everything runnable — pipeline scripts, diagnostics, spectrum analyzers.",
39+
"status": "active"
40+
},
41+
"drafts": {
42+
"purpose": "Conference materials, paper submissions, proposals, books.",
43+
"subfolders": {
44+
"codawork-2026": "CoDaWork 2026 Coimbra — presentation, primers, preparation, extended materials",
45+
"codawork-2026/presentation": "Main talk slide deck [NEW]",
46+
"codawork-2026/primers": "4 personalized researcher primers [NEW]",
47+
"codawork-2026/preparation": "Q&A prep, conversation guide [NEW]",
48+
"codawork-2026/extended": "Extended results, EITT handout, coffee table [NEW]",
49+
"papers": "Paper submissions across 7 target venues + Ramsar outreach",
50+
"proposals": "Unified proposal, complementary integration [NEW]",
51+
"books": "Book-length QIT treatments (Book 0-2) [NEW]",
52+
"accord": "Human-AI Accord for Ramsar"
53+
}
54+
},
55+
"briefings": {
56+
"purpose": "Session briefings and AI handoffs — chronological discovery record. [NEW]",
57+
"status": "active"
58+
},
59+
"data": {
60+
"purpose": "Datasets organized by domain.",
61+
"subfolders": {
62+
"backblaze": "Hard drive failure data",
63+
"codawork-samples": "Reproducible samples for CoDaWork",
64+
"eitt-lab": "EITT laboratory package",
65+
"energy": "EMBER and OWID energy data",
66+
"ember": "EMBER Global Electricity Review processed data [NEW]",
67+
"ngfs": "NGFS Phase 4 scenario analysis [NEW]",
68+
"toronto": "TTC transit data",
69+
"manifests": "Data manifests",
70+
"checksums": "Integrity checksums"
71+
}
72+
},
73+
"dormant": {
74+
"purpose": "Paused branches — sleeping, not dead. Nothing dies here. [NEW]",
75+
"branches": ["pre-coda-metrics", "early-governance", "planck-case", "peterson-outreach", "hagf", "deceptive-drift"]
76+
},
77+
"archive": {
78+
"purpose": "Superseded, rejected, or completed work. What failed always speaks louder.",
79+
"status": "archived"
80+
}
81+
},
82+
83+
"ai_training_notes": {
84+
"start_here": "ai-refresh/HUF_FAST_REFRESH.json",
85+
"verify_with": "ai-refresh/HUF_INTEGRITY_MANIFEST.json",
86+
"known_pitfalls": [
87+
"EITT = Entropy-Invariant Time Transformer. NEVER Ternary or Temporal.",
88+
"Japan drift: 2013-2014 d_A=9.05. NOT 2011-2012.",
89+
"Germany drift: 2023-2024 d_A=9.07, 2024-2025 d_A=5.73. NOT 2011.",
90+
"UK: three values (2.98, 3.23, 3.26). NEVER 'approximately 3'.",
91+
"HUF-GOV: open loop ONLY. Instrument reads, never actuates.",
92+
"Dormant branches are valuable. Do not discard."
93+
]
94+
}
95+
}

README.md

Lines changed: 71 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ HUF proposes that **composition** — the internal proportional balance of a sys
88

99
## The Discovery: EITT
1010

11-
**Entropy Invariance under Temporal Transformation.** Shannon entropy appears empirically near-invariant under geometric-mean block decimation of compositional time series.
11+
**Entropy-Invariant Time Transformer.** Shannon entropy appears empirically near-invariant under geometric-mean block decimation of compositional time series.
1212

1313
Measured: **0.18% variation** across a 341:1 compression ratio (daily to annual European electricity compositions, 8 carriers, 4089 trading days). Confirmed across energy, hardware degradation, cosmological observation, commodities, and chemistry.
1414

@@ -41,33 +41,78 @@ This produced three new frameworks:
4141

4242
```
4343
HUF/
44-
├── science/ # The unified front
45-
│ ├── reference/ # Core reference collection (start here, 9 docs, ~105 min)
46-
│ ├── chemistry/ # EITT chemistry results, HUF-IDX, PRISM
47-
│ ├── core/ # EITT mathematics, complete explanation, formulas
48-
│ └── methodology/ # Compositional governance scale, confidence index
44+
├── ai-refresh/ # AI STARTS HERE — fast context loading
45+
│ ├── HUF_FAST_REFRESH.json # All canonical values, single file
46+
│ ├── HUF_INTEGRITY_MANIFEST.json # Hash verification, drift patterns
47+
│ └── huf_spec_v2.0.json # Complete framework specification
4948
50-
├── huf-gov/ # Active governance
51-
│ ├── governance/ # Standards, protocols, kill tests
52-
│ ├── science/ # Monitoring taxonomy, ontological foundation
53-
│ └── evidence/ # Case studies (energy, backblaze, planck, ramsar)
49+
├── science/ # All scientific work by subject
50+
│ ├── reference/ # Core reference (9 docs, ~105 min)
51+
│ ├── core/ # EITT maths, formulas, user handbook
52+
│ ├── methodology/ # Governance scale, confidence index
53+
│ ├── chemistry/ # CheMixHub results, HUF-IDX, PRISM
54+
│ ├── quantum/ # HUF-QIT: 9 isomorphisms, Bell test
55+
│ ├── eitt/ # EITT evidence: 4 proofs, adversarial
56+
│ ├── coda-monitoring/ # Perturbation drift detection protocol
57+
│ ├── spectral/ # Frequency-domain analysis
58+
│ ├── loudspeaker-analogy/ # Origin: crossover networks as CoDa
59+
│ ├── wetlands/ # Ramsar Convention monitoring
60+
│ └── governance/ # 201-country ranking outputs
5461
55-
├── tools/ # Everything runnable
56-
│ ├── pipeline/ # EITT pipeline, preparsers, analysis scripts
57-
│ ├── diagnostics/ # Validators, dashboards, diagnostic JSX
58-
│ ├── spectrum-analyzer/ # HUF Spectrum Analyzer (all versions)
59-
│ └── shared/ # Build utilities, styles, glossary
62+
├── huf-gov/ # Active governance
63+
│ ├── governance/ # Standards, protocols, kill tests
64+
│ ├── science/ # Monitoring taxonomy, ontology
65+
│ └── evidence/ # Case studies (energy, backblaze, etc.)
6066
61-
├── drafts/codawork-2026/ # CoDaWork 2026 conference materials
67+
├── tools/ # Everything runnable
68+
│ ├── pipeline/ # EITT pipeline, preparsers, scripts
69+
│ ├── diagnostics/ # Validators, dashboards, UML diagrams
70+
│ ├── spectrum-analyzer/ # HUF Spectrum Analyzer (all versions)
71+
│ └── shared/ # Build utilities, styles, glossary
6272
63-
├── data/ # Datasets (energy, backblaze, toronto, eitt-lab)
73+
├── drafts/ # Conference materials, papers, proposals
74+
│ ├── codawork-2026/ # CoDaWork 2026, Coimbra
75+
│ │ ├── presentation/ # Main talk slide deck
76+
│ │ ├── primers/ # 4 personalized researcher primers
77+
│ │ ├── preparation/ # Q&A prep, conversation guide
78+
│ │ └── extended/ # Extended results, EITT handout
79+
│ ├── papers/ # Paper submissions (7 venues)
80+
│ ├── proposals/ # Unified proposal, integration briefs
81+
│ └── books/ # Book-length QIT treatments
6482
65-
└── archive/ # Development history (everything pre-restructure)
83+
├── briefings/ # Session briefings & AI handoffs
84+
85+
├── data/ # Datasets by domain
86+
│ ├── backblaze/ # Hard drive failure data
87+
│ ├── energy/ # EMBER/OWID energy data
88+
│ ├── ember/ # EMBER processed results
89+
│ ├── ngfs/ # NGFS Phase 4 scenarios
90+
│ ├── codawork-samples/ # Reproducible CoDaWork samples
91+
│ ├── eitt-lab/ # EITT lab package
92+
│ └── toronto/ # TTC transit data
93+
94+
├── dormant/ # Paused branches — sleeping, not dead
95+
│ ├── pre-coda-metrics/ # Pre-CoDa metric formulations
96+
│ ├── early-governance/ # Multi-AI collective experiments
97+
│ ├── planck-case/ # Planck sky map analysis
98+
│ ├── peterson-outreach/ # Peterson letters (paused)
99+
│ ├── hagf/ # Adaptive governance (superseded)
100+
│ └── deceptive-drift/ # Arithmetic hiding composition changes
101+
102+
└── archive/ # Superseded work — what failed speaks loudest
66103
```
67104

68105
---
69106

70-
## Start Here
107+
## For AI Systems
108+
109+
**Start here:** Read `ai-refresh/HUF_FAST_REFRESH.json` first. It contains every canonical name, number, formula, and structural rule. If anything elsewhere disagrees with FAST_REFRESH, the FAST_REFRESH wins. Then verify with `ai-refresh/HUF_INTEGRITY_MANIFEST.json`. Then read `INDEX.json` for the full file map.
110+
111+
**Known drift traps:** EITT is "Entropy-Invariant Time Transformer" (never Ternary). Japan drift flag is 2013-2014 (never 2011-2012). Germany is 2023-2024/2024-2025 (never 2011). UK has three specific values (2.98, 3.23, 3.26), never "approximately 3".
112+
113+
---
114+
115+
## Start Here (Humans)
71116

72117
| Time | What | Where |
73118
|------|------|-------|
@@ -76,6 +121,7 @@ HUF/
76121
| 15 min | **User Handbook** — fast summary + guided links | [`science/core/HUF_USER_HANDBOOK.md`](science/core/HUF_USER_HANDBOOK.md) |
77122
| 20 min | Chemistry results (the new frontier) | [`science/chemistry/`](science/chemistry/) |
78123
| 30 min | The kill test — 19 documented failure modes | [`huf-gov/governance/`](huf-gov/governance/) |
124+
| 10 min | Quantum correspondence (advanced) | [`science/quantum/`](science/quantum/) |
79125

80126
If you want to break it, the kill test is where to start.
81127

@@ -97,6 +143,12 @@ If you want to break it, the kill test is where to start.
97143

98144
---
99145

146+
## Dormant Branches
147+
148+
Nothing dies here — only goes dormant. The `dormant/` folder preserves paused work with documented reasons and conditions for reawakening. The `archive/` folder holds superseded and rejected approaches as reference for what was tried and why. What failed always speaks louder.
149+
150+
---
151+
100152
## Governance
101153

102154
**Standard:** RWA-001 (Rogue Wave Audio Corporate Reference)

0 commit comments

Comments
 (0)