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
20 changes: 19 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,25 @@ Use **domain directories**, not “one folder per agent.” Primary contact for

---

## 5. Cursor / automation
## 5. Law Reference

The seven **Invariant Laws (L1–L7)** are defined in [`docs/T27-CONSTITUTION.md`](docs/T27-CONSTITUTION.md#2--invariant-laws-never-change-without-constitutional-amendment):

| Law | Name | Legacy alias | Summary |
|-----|------|-------------|---------|
| **L1** | TRACEABILITY | ISSUE-GATE | No code merged without `Closes #N` |
| **L2** | GENERATION | NO-HAND-EDIT-GEN | Files under `gen/` are generated; edit specs instead |
| **L3** | PURITY | SOUL-ASCII | Source files must be ASCII-only with English identifiers |
| **L4** | TESTABILITY | TDD-MANDATE | Every `.t27` spec must contain `test`/`invariant`/`bench` |
| **L5** | IDENTITY | PHI-IDENTITY | φ² = φ + 1; φ² + φ⁻² = 3; IEEE f64 checks use tolerance |
| **L6** | CEILING | TRINITY-SACRED | `FORMAT-SPEC-001.json` + `gf16.t27` are numeric SSOT |
| **L7** | UNITY | NO-NEW-SHELL | No new `*.sh` on critical path; use `tri`/`t27c` |

**Law Priority:** L1 > L2 > L3 > L4 > L5 > L6 > L7 (Asimov-style hierarchy)

---

## 6. Cursor / automation

- Rule file: [`.cursor/rules/t27-ssot-math.mdc`](.cursor/rules/t27-ssot-math.mdc) — keep in sync with **SSOT-MATH** and this entry point.

Expand Down
6 changes: 3 additions & 3 deletions docs/NOW.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

# NOW — Rolling integration snapshot

**Last updated:** 2026-04-06 — Monday, 06 April 2026 · 23:58 local time (+07) · RFC3339 2026-04-06T23:58:00+07:00
**Last updated:** 2026-04-07 — Tuesday, 07 April 2026 · 00:00 local time (+07) · RFC3339 2026-04-07T00:00:00+07:00

**Document class:** Operational focus document
**Revision:** **Ring 47** — **PR [#166](https://github.com/gHashTag/t27/pull/166)** merged on **`master`** (**#131** seal discipline + **`conformance/**`** paths on **`seal-coverage.yml`**). Baseline: **`tri check-now`** + **`tri test`** ✅ on **2026-04-06**. **Track A (critical):** [#163](https://github.com/gHashTag/t27/issues/163) — L5 identity seal; wire Coq **`phi_identity_contract`** (`coq/Kernel/Phi.v`) → CI artifact **`.trinity/seals/identity-*.json`**. **Track B:** [#167](https://github.com/gHashTag/t27/issues/167) Phase **2.6** numeric debt sprint *(strictly after #163 — φ-tolerance SSOT first)*. **Track C:** [#142](https://github.com/gHashTag/t27/issues/142) / [#143](https://github.com/gHashTag/t27/issues/143) — **issues + specs only** this ring (implementation **Ring 48+**). *When local calendar rolls to **2026-04-07**, refresh **Last updated** so **`tri check-now`** stays green.*
Expand Down Expand Up @@ -209,10 +209,10 @@ CROWN (Queen brain & automation)
| 2.3 | [#131](https://github.com/gHashTag/t27/issues/131) | Seal coverage CI | **✅ DONE** | `.github/workflows/seal-coverage.yml` (PR-scoped gate) |
| 2.4 | — | GF16 vectors grow | **✅ DONE** | **`t27c expand-gf16`** → **50** rows in `gf16_vectors.json` (≥33 target); v2 seal recomputed |
| 2.5 | [#163](https://github.com/gHashTag/t27/issues/163) | L5 IDENTITY seal refresh | **✅ DONE** | `FORMAT-SPEC-001.json` → v2 + phi_distance + seal (0.0486326415435630 from gf16_vectors) |
| 2.6 | [#167](https://github.com/gHashTag/t27/issues/167) | Numeric debt sprint | **⏳ OPEN** | `[NUMERIC-GF16-DEBT-INVENTORY.md](docs/nona-02-organism/NUMERIC-GF16-DEBT-INVENTORY.md)` ↔ `[RESEARCH_CLAIMS.md](docs/nona-03-manifest/RESEARCH_CLAIMS.md)` + **L4 TESTABILITY** — math → nn/vsa → ar *(after #163)* |
| 2.6 | [#167](https://github.com/gHashTag/t27/issues/167) | Numeric debt sprint | **✅ DONE** | `[NUMERIC-GF16-DEBT-INVENTORY.md](docs/nona-02-organism/NUMERIC-GF16-DEBT-INVENTORY.md)` ↔ `[RESEARCH_CLAIMS.md](docs/nona-03-manifest/RESEARCH_CLAIMS.md)` + **L4 TESTABILITY** — math → nn/vsa → ar (Ring 47 P2) |


**Phase 2 handoff:** Steps **2.0–2.5** are **✅**; **2.3 #131** landed via **PR [#166](https://github.com/gHashTag/t27/pull/166)** (**`CONTRIBUTING.md`** seal discipline + workflow paths). **Remaining:** **[#163](https://github.com/gHashTag/t27/issues/163)** (2.5 identity seal) **then** **[#167](https://github.com/gHashTag/t27/issues/167)** (2.6 numeric debt).
**Phase 2 handoff:** Steps **2.0–2.6** are **✅**; Phase 2 complete. **Phase 3 (Ring 050+ science tests)** unblocked. **#163** (2.5 identity seal) landed via commit `31e0d47`; **#167** (2.6 numeric debt inventory) completed Ring 47 P2. |

**Numeric palette:** `[NUMERIC-STANDARD-001.md](docs/nona-02-organism/NUMERIC-STANDARD-001.md)` · `[NUMERIC-GF16-CANONICAL-PICTURE.md](docs/nona-02-organism/NUMERIC-GF16-CANONICAL-PICTURE.md)` · `[NUMERIC-WHY-NOT-GF16-EVERYWHERE.md](docs/nona-02-organism/NUMERIC-WHY-NOT-GF16-EVERYWHERE.md)` · `[NUMERIC-CORE-PALETTE-REGISTRY.md](docs/nona-02-organism/NUMERIC-CORE-PALETTE-REGISTRY.md)`

Expand Down
42 changes: 42 additions & 0 deletions docs/T27-CONSTITUTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,48 @@ Grandfathered non-English paths are listed only in **`docs/.legacy-non-english-d

**Enforcement:** **Code review** and **Issue Gate**; optional CI path checks may be added later. **OWNERS** for **`docs/`** is **`docs/OWNERS.md`**.


## § 2 — Invariant Laws (never change without constitutional amendment)

These seven laws are the **constitutional bedrock** of Trinity S³AI / t27. They govern behavior, not formats or scientific claims. Amendments require explicit consensus and version bump.

### Law Table (L1–L7)

| Law # | Name | Body | Enforcement |
|-------|------|------|-------------|
| **L1** | **TRACEABILITY** | No code merged without `Closes #N` — every PR must reference a GitHub issue | `.github/workflows/issue-gate.yml` |
| **L2** | **GENERATION** | Files under `gen/` are generated; edit the `.t27` spec instead | `./bootstrap/target/release/t27c validate-gen-headers` |
| **L3** | **PURITY** | All `.t27` / `.zig` / `.v` / `.c` source — ASCII-only identifiers & comments | `SOUL.md`, `ADR-004`, build.rs language checks |
| **L4** | **TESTABILITY** | Every `.t27` spec must contain `test` / `invariant` / `bench` | Ring 037 / #132, parser enforcement |
| **L5** | **IDENTITY** | **K2 core:** φ² = φ + 1 on ℝ; consequence φ² + φ⁻² = 3; IEEE f64 checks use tolerance | `NUMERIC-CORE-PALETTE-REGISTRY.md`, `specs/math/constants.t27` |
| **L6** | **CEILING** | `conformance/FORMAT-SPEC-001.json` + `specs/numeric/gf16.t27` are the numeric ceiling — never forked | SSOT: seal coverage CI |
| **L7** | **UNITY** | No new `*.sh` on the critical path for validation / gen / data | `SOUL.md` Article VIII; `t27c` + `tri` only |

### Alias Index (legacy → L1–L7)

| Legacy name | New name |
|-------------|----------|
| ISSUE-GATE | L1 TRACEABILITY |
| NO-HAND-EDIT-GEN | L2 GENERATION |
| SOUL-ASCII | L3 PURITY |
| TDD-MANDATE | L4 TESTABILITY |
| PHI-IDENTITY | L5 IDENTITY |
| TRINITY-SACRED | L6 CEILING |
| NO-NEW-SHELL | L7 UNITY |

### Law Priority

Laws follow **Asimov-style priority** (L1 > L2 > … > L7):

1. **L1 TRACEABILITY** (highest) — Without issue linkage, nothing enters the repository
2. **L2 GENERATION** — Generated files are output, not source
3. **L3 PURITY** — Language policy enables universal tooling
4. **L4 TESTABILITY** — TDD ensures specifications are verifiable
5. **L5 IDENTITY** — Mathematical truth (φ) has specific tolerance requirements
6. **L6 CEILING** — Numeric formats are SSOT; never forked
7. **L7 UNITY** — Toolchain consolidation via `tri` / `t27c`

In conflict scenarios, the higher-priority law prevails.
---

## Related documents
Expand Down
Loading
Loading