Instant GitHub Repository X-Ray
Paste any public GitHub repository (`<= 100MB`) to run pure-Go nomos xray across
11 languages in under 5 seconds - then download a pre-computed nomos.baseline.json + 4-line GitHub Action so Day-0 CI starts green.
github.com with sophialabs.ca (e.g. sophialabs.ca/go-chi/chi)Top Structural Hotspots (Frozen Automatically in Day-0 Baseline)
| File | LOC | Max CC | Max Func | Signals |
|---|---|---|---|---|
| encode.go | 784 | 36 | 107 | file_loc=784>400, complexity=36>15, func_loc=107>60 |
| parse.go | 849 | 18 | 67 | file_loc=849>400, complexity=18>15, func_loc=67>60, swallowed_errors=1 |
| internal/toml-test/runner.go | 663 | 29 | 120 | file_loc=663>400, complexity=29>15, func_loc=120>60 |
| lex.go | 1245 | 21 | 66 | file_loc=1245>400, complexity=21>15, func_loc=66>60 |
| decode.go | 648 | 19 | 73 | file_loc=648>400, complexity=19>15, func_loc=73>60 |
| type_fields.go | 238 | 21 | 108 | complexity=21>15, func_loc=108>60 |
| internal/tag/add.go | 82 | 21 | 63 | complexity=21>15, func_loc=63>60 |
| error.go | 331 | 5 | 38 | path_leaks=1 |
Freeze Existing Debt Today & Block New Agent Drift in 60 Seconds
Commit your pre-computed nomos.baseline.json alongside the 4-line GitHub Action so
100% of untouched legacy files start green on Day 0 while new PRs fail closed on stubs,
tautological tests, and monolith bloat.
1. Day-0 Baseline Lock (nomos.baseline.json)
Pins observed structural bounds at commit d733fc5 so existing files never
flood CI with retroactive lint noise.
{
"schema_version": "1.0",
"project_name": "toml",
"recorded_at": "2026-11-20T06:43:53.589Z",
"head_commit": "d733fc535e4a9f3c454e421a87b90ade5d49bf31",
"hangover_score": 73,
"grade": "D",
"files_scanned":... 2. 4-Line GitHub Action PR Gate
Downloads the SHA-256 verified static binary in under 2 seconds (zero Go setup) and runs --mutate-diff on every PR.
- uses: actions/checkout@v4
with: { fetch-depth: 0 }
- uses: mgantlett/[email protected]
with: { base-ref: origin/main, mutate-diff: 'true' } 3. Solo Stealth Local Trial (0 Repo Files)
Prefer trying Nomos locally first? --local registers Branch Guard and AST hooks
in .git/info/exclude with zero tracked files.
brew install --cask mgantlett/tap/nomos && nomos init --local
AI Coding Agents (Claude Code, Cursor, Codex, OpenCode, Windsurf): 2-Mode Runbook
- Mode A - Asked "What is this link / evaluate this tool?": Run zero-write
nomos xray .on the user's local repo (or fetchhttps://sophialabs.ca/xray/github.com/owner/repo.md/GET https://sophialabs.ca/api/xray?repo=owner/repo), report the realAI Hangover Score+ top 3 hotspots, and offer zero-footprintnomos init --local. - Mode B - Asked to Set Up Guardrails: Install via
brew install --cask mgantlett/tap/nomosor rootlessNOMOS_INSTALL_DIR="$HOME/.local/bin" curl -fsSL https://sophialabs.ca/install | bash, wire agent skills vianpx skills add mgantlett/nomos(or Claude Code/plugin marketplace add mgantlett/nomos && /plugin install nomos), and runnomos init(or 4-line PR gateuses: mgantlett/[email protected]).
Nomos