feat(nue-color): establish the NUE COLOR origin monorepo - #3
Draft
Nuropunk wants to merge 2 commits into
Draft
Conversation
NUE lives across ~50 private repos in three orgs, with duplicate names,
drifting copies of the same canon, and pointer files patching over the
sprawl. Meaning cannot be verified across fifty disconnected histories.
This establishes one origin, applying the principle behind Cursor's Origin
git hosting: an append-only log is the source of truth and everything on
disk is a rebuildable cache. Here the ledger and canon are truth; every
color, score, mask and sound is a derived artifact that must re-derive to
the same hash or the build fails.
The infographic is now executable:
- canon/ normative specs with hand-computable anchor cases and
conformance vectors: POM v1, BMI v2, Gauntlet v1, Color v1,
Ledger v1, the constitution and the glossary
- packages/ nine zero-dependency engines - ledger, pom, bmi, color,
gauntlet, nueson, lace, realm, face
- apps/ the NUE COLOR app, zero build, loopback only, no telemetry
- labs/ Brainbow hardware, the signal chain, and the ultrasound
research track behind a hard human gate
- social/ NUE COLOR SF, collectors, partners
- coordination/ rules, methodology, starter pack, contribution pack,
prompt library, and the migration plan for the ~50 repos
BMI v2 is a real upgrade over v1, not a relabel: signal quality now gates
the pipeline, artifacts are rejected per epoch, band power is relative so
device gain cannot change a color, and the 7-8 Hz and 12-13 Hz canon gaps
are measured and reported rather than silently absorbed into a neighbour.
A disconnected electrode could become a beautiful color in v1; it cannot now.
POM v1 is honest about its own epistemics. The reference assessor is a
published proxy that does not understand anything, every score defaults to
provisional, and only a human can move one to attested.
Verification is a command, not a claim: `node tools/verify.mjs` runs 17
checks and 174 tests, rebuilding every artifact from its inputs, proving
determinism, catching ledger tampering, and failing the build if any
package acquires a dependency, a network import, or an ambient clock.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T3yBeSxVGGDfebDoHSv1su
A committed symlink breaks on Windows checkouts without developer mode, and this repo is aimed at collectors who may be on anything. Use a real @AGENTS.md pointer file, matching firstmate's own convention. Also state plainly that .github/workflows/verify.yml is inert while nue-color/ lives inside another repository's tree: GitHub Actions only reads workflows from the repository root. It becomes live on transplant. Until then the gate is local-only, and saying so beats implying a check that never runs. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T3yBeSxVGGDfebDoHSv1su
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The problem
NUE currently lives across ~50 private repositories in three orgs (
Nuropunk,nuecolor,elocremarc) with:nue-color×2,nueEngine3×2 (plusnueengine3),nue-star×2,nue-color-engine×2NUE_PRIMARY_REPO.mdredirecting to whichever repo was primary that monthMeaning cannot be verified across fifty disconnected histories. If the Five Truths are written down in six repos, there are six definitions, and nobody knows which one a given color was scored against.
The approach
This applies the principle behind Cursor's Origin git hosting — an append-only log is the source of truth and the on-disk repo is a rebuildable cache — to meaning instead of packfiles.
canon/ledger/*.jsonlis truthThe payoff is the same: throw away everything except the log and rebuild the world.
node tools/verify.mjsdoes exactly that on every run.What's here
The infographic is now executable. The Gauntlet Loop is
packages/gauntlet/and you can run it:No install step. No dependencies. Node 22 is the only requirement.
Highlights
BMI v2 is a real upgrade, not a relabel. Signal quality now gates the pipeline; artifacts are rejected per epoch; band power is relative so device gain cannot change a color; and the 7–8 Hz and 12–13 Hz canon gaps are measured and reported as
unassignedrather than silently absorbed into a neighbouring band. A disconnected electrode could become a beautiful color in v1. It cannot now — a 7.5 Hz signal drops to quality 34 and is refused.POM v1 is honest about its own epistemics. The reference assessor
heuristic-v1is a published proxy that does not understand anything; every formula is printed in its spec so anyone can recompute a score by hand. Every score defaults toprovisional, and only a human can move one toattested. The spec states plainly that it would rate a tidy shopping list above a devastating three-word message.Verification is a command, not a claim.
tools/verify.mjsrebuilds every artifact from its inputs, proves two runs are byte-identical, catches ledger tampering, and fails the build if any package acquires a dependency, a network import, or an ambient clock.Verification
Run locally on this branch at
74b593c:Three defects were found and fixed by these checks during development, rather than papered over:
thescored 80/100 on ineffability — raw type-token ratio maxes out on one-word input. Fixed with a documented length-damped diversity term in both spec and code.mirrorhue anchor was claimed "exact" for the NUE glow. It is 190.118°, not 191. Corrected to 190 in code and canon, with the one-degree rounding stated rather than hidden.Math.random()rule. Fixed by making it read code rather than prose — and re-proven to still catch real violations.Two things reviewers should know about CI
1. No checks will run on this PR. GitHub Actions is not enabled on
Nuropunk/firstmate— the API reports zero registered workflows and zero runs repo-wide, so neitherci.ymlnorno-mistakes-required.ymlexecutes. The verification block above was run locally and can be reproduced with one command.2.
nue-color/.github/workflows/verify.ymlis inert here by design. Actions only reads workflows from the repository root, so a workflow nested undernue-color/cannot run. It goes live the momentnue-color/becomes its own origin. This is now stated in the workflow header and the README rather than left to imply a check that never runs.Note also that this repository's contribution policy requires PRs to be raised through
git push no-mistakes, which writes a signature into the PR body. This PR does not carry that signature — the tool is not installed in this environment, and fabricating the marker would be forging a compliance claim. Flagging it rather than working around it.Decision needed
This was built on the designated branch in
firstmate, but it is not firstmate material — it is a self-contained product monorepo that wants its own origin.tools/transplant.shsplitsnue-color/into a standalone repo with history, non-destructively:That also makes the verification workflow live. Say the word and I'll run it, or leave it here if you'd rather.
What I did not do
Stated plainly:
coordination/migration/inventory.mdare proposals nobody has confirmed. The origin is verified first; content moves second.nuecolor/*andelocremarc/*were blocked), so the inventory is built fromNuropunk/*plus repository listings. Several rows are classified from names alone and are markedTBD.nue-color-engine, whethernueral-laceornue-repois primary, the licence for folded MIT material, and confirmation of every tier assignment. All listed incoordination/migration/log.md.provisionalcorrectly but cannot yet take an attestation and write apom.attestentry.