Skip to content

docs(README): document BitNet HLS pipeline + R-TT track + chip submodules (Closes #805)#806

Merged
gHashTag merged 1 commit into
masterfrom
docs/readme-bitnet-rtt
May 24, 2026
Merged

docs(README): document BitNet HLS pipeline + R-TT track + chip submodules (Closes #805)#806
gHashTag merged 1 commit into
masterfrom
docs/readme-bitnet-rtt

Conversation

@gHashTag
Copy link
Copy Markdown
Owner

Closes #805

Doc-only update bringing README.md current with the state of the toolchain
after W36-W45. README had been frozen at W13 (2026-05-22) and no longer
reflected the BitNet HLS pipeline, host stack, or R-TT track.

What changed

README.md only. +110 / -0 lines.

Added rows to ## System Status

Domain Component Status
BitNet HLS RTL pipeline GREEN (9/9 modules)
Host stack Rust driver + IRQ harness GREEN (2/3 layers)
R-TT track Tiny Tapeout reproducibility YELLOW (2/4)
Chips tt-trinity-{phi,euler,gamma} GREEN (pinned submodules)

New section ## BitNet HLS Pipeline & R-TT Reproducibility Track

  • 9/9 BitNet HLS module table with wave attribution (W36a-f + W38 bundle + R-BV-2)
  • Host stack CLIs (W39 + W40)
  • R-TT CLIs: tt-manifest (W42), tt-profile + tt-conform (W45)
  • Submodule layout for chips/{phi,euler,gamma} + clone instructions
  • Test coverage summary (365 / 366 integration)
  • Cross-link to docs/NOW.md as the live wave log

Constitutional gates

  • L1 TRACEABILITY: Closes #805 in title + body + commit
  • L2 SCOPE: doc-only. README.md (repo root) -- one-off doc-update. No code, RTL, spec, kernel, or test changes. W42 expansion (.gitmodules + chips/) untouched.
  • L3 ASCII: ASCII-only
  • L4 TESTS: doc-only update, no tests required
  • L5 KERNEL UNTOUCHED: zero edits to numeric kernel. phi^2 + 1/phi^2 = 3 invariant reaffirmed
  • L6 SPEC FROZEN: zero spec changes
  • *L7 NO NEW .sh: only .md

Known orthogonal CI failures (inherited, NOT blocking)

  • fpga-formal
  • fpga-synthesis-arty
  • fpga-bitstream

Roadmap

Next wave: W46 R-TT-3 tt-debug (TT-debug wrapper with version CSR + error
counters + self-test trigger).

@github-actions
Copy link
Copy Markdown

PR Dashboard

Generated at: 2026-05-24 04:07:04 UTC

Summary

Status Count
Total Open PRs 8
PRs with Failing Checks 0
PRs with All Checks Green 8
READY 7
FAILING 0
PENDING 0

@github-actions
Copy link
Copy Markdown

📓 NotebookLM Notebook linked to this PR

This notebook contains session context, decisions, and artifacts for this work.

…(W42, W45) + chip submodules (Closes #805)

- Add System Status rows for BitNet HLS / Host stack / R-TT / Chips
- New section 'BitNet HLS Pipeline & R-TT Reproducibility Track':
  * 9/9 module table with wave attribution
  * Host stack CLIs (host-smoke, host-poll-vs-irq)
  * R-TT CLIs (tt-manifest, tt-profile, tt-conform)
  * Submodule layout (chips/{phi,euler,gamma})
  * Test coverage summary (365/366)
- Links to docs/NOW.md for the live wave log

Doc-only update. L5/L6/L7 untouched.
phi^2 + 1/phi^2 = 3 invariant reaffirmed.

Closes #805
@gHashTag gHashTag force-pushed the docs/readme-bitnet-rtt branch from 1ae89be to f35d710 Compare May 24, 2026 04:11
@github-actions
Copy link
Copy Markdown

📓 NotebookLM Notebook linked to this PR

This notebook contains session context, decisions, and artifacts for this work.

@github-actions
Copy link
Copy Markdown

PR Dashboard

Generated at: 2026-05-24 04:11:45 UTC

Summary

Status Count
Total Open PRs 8
PRs with Failing Checks 0
PRs with All Checks Green 8
READY 7
FAILING 0
PENDING 0

@gHashTag gHashTag merged commit ef9e63e into master May 24, 2026
16 checks passed
@gHashTag gHashTag deleted the docs/readme-bitnet-rtt branch May 24, 2026 04:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(README): document BitNet HLS pipeline (W36a-f+W38) + R-TT track (W42, W45) + chip submodules

1 participant