Add side-effect-free versioned JSON resolution

[solnikhil]

Summary

• add di resolve <domain>[/sub][@version] --json backed by the same typed resolution model used by human verify
• publish and package an immutable v1 JSON Schema, compatibility policy, stable outcomes, error codes, resolver provenance, registry state, mapping conflicts, and read-only pin diffs
• guarantee one JSON stdout document for success, expected failures, and opted-in usage failures; add a non-mutating pin inspection path that never creates, chmods, locks, or rewrites trust state
• add cross-platform contract and process tests for every outcome and package the schema/docs in the npm artifact

Exit codes

• 0 resolved
• 2 invalid input / usage
• 3 authoritative absence (NXDOMAIN/NODATA distinguished in JSON)
• 4 provider exhaustion
• 5 conflicting mappings
• 6 registry failure
• 7 pin change
• 8 internal or unsafe pin-state failure
• 9 invalid declaration

Verification

• npm test — 393 passed on Windows (124 primary + 269 exhaustive; POSIX adds two permission-preservation assertions)
• npm run test:e2e — live project/global install and verify passed
• live resolve zuraai.xyz --json — exit 0, strict parsed schema v1 JSON, no state directory created
• piped conflict regression — complete parseable JSON above 1 MiB with 64 mappings, no truncation
• npm run verify:package — reproducible tarball, schema and compatibility doc included, clean install, all aliases
• npm audit --omit=dev --audit-level=high — 0 vulnerabilities

Closes #23

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 188f049e-c996-45f7-9043-90906093cf9f

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}