Zero-Install Static AST Audit · 0 Code Executed

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.

Shortcut: on any GitHub repo, replace github.com with sophialabs.ca (e.g. sophialabs.ca/go-chi/chi)
tj/commander.js ↗
Branch: master · Commit: a5a7dc0 · Scan: 550ms (0 code executed)
AI HANGOVER SCORE
15 / 100
B
170
Files Scanned
19,828
Total LOC
3
Monoliths (>400 LOC)
6
Oversized Funcs (>60)
2
Type-2 Clone Groups
0
Hollow Stubs
0
Skipped Tests
0
CWE Security Sinks

Top Structural Hotspots (Frozen Automatically in Day-0 Baseline)

FileLOCMax CCMax FuncSignals
lib/command.js280342148file_loc=2803>400, complexity=42>15, func_loc=148>60
lib/help.js735585file_loc=735>400, func_loc=85>60
typings/index.test-d.ts787273file_loc=787>400, func_loc=73>60
lib/option.js377327clones=1
lib/argument.js147528clones=1
examples/options-custom-processing.js57210clones=1
examples/arguments-custom-processing.js46210clones=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 a5a7dc0 so existing files never flood CI with retroactive lint noise.

{
  "schema_version": "1.0",
  "project_name": "commander.js",
  "recorded_at": "2026-11-20T08:26:41.737Z",
  "head_commit": "a5a7dc084d4d2b7932e85ca049c5204e50a2c721",
  "hangover_score": 15,
  "grade": "B",
  "files_sc...

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 fetch https://sophialabs.ca/xray/github.com/owner/repo.md / GET https://sophialabs.ca/api/xray?repo=owner/repo), report the real AI Hangover Score + top 3 hotspots, and offer zero-footprint nomos init --local.
  • Mode B - Asked to Set Up Guardrails: Install via brew install --cask mgantlett/tap/nomos or rootless NOMOS_INSTALL_DIR="$HOME/.local/bin" curl -fsSL https://sophialabs.ca/install | bash, wire agent skills via npx skills add mgantlett/nomos (or Claude Code /plugin marketplace add mgantlett/nomos && /plugin install nomos), and run nomos init (or 4-line PR gate uses: mgantlett/[email protected]).