feat(domain): add the typed registry view and its ClickHouse SQL compiler

[JeremyFunk]

What this layer contains

Maple's typed view of the registry artifact, under the @maple/domain/ai-registry subpath export:

• schema.ts — Effect Schema for the whole document; registry.json is decoded at module load and exported deep-frozen.
• validate.ts / validate.test.ts — the semantic invariants Schema cannot express (globally unique integer priorities, the D4 priority bands, the closed slug set with unknown: reserved, value_prefix confined to pseudo-keys, justification on sufficient resource matchers).
• compile-sql.ts and its unit + ClickHouse e2e tests — lowers the registry to ClickHouse expressions over a traces row.
• registry-fixtures.ts, index.ts, the ./ai-registry export in package.json, resolveJsonModule in tsconfig.json, and the README's "TypeScript consumers" section.

Why it is shaped this way

Decoding at module load means a resync that changes the artifact's shape fails the import rather than the first classification, and validate.test.ts is the gate a future resync must pass — it reports violations and never repairs them, because a violation means the upstream compiler produced a bad artifact and must be fixed in trace-capture.

The SQL compiler exists for two consumers that both need to evaluate the registry without the Rust classifier: the differential tests that prove the two evaluators agree, and the rollup rebuild job, which cannot read the stored AiVendor because that is the column it is repairing. It emits no hash SQL, only because nothing in v1 consumes one: sessionKeyValueExpr yields the winning candidate's raw value and cityHash64 over it is a one-liner the caller can write. The subpath export keeps the ~280 KB artifact off the root @maple/domain barrel that web and cli import.

Gates run at this level

• bun typecheck — 37/37 tasks pass.
• packages/domain vitest — 532 passed, 7 skipped.
• compile-sql.clickhouse.e2e.test.ts under CLICKHOUSE_E2E=1 against a real ClickHouse — 7 passed.

Dependencies

Requires #430 for registry.json. Independent of the Rust layer in #432 — the two evaluators are only tied together in #435.

Partition note: index.ts here exports everything except the rollup-enablement constants; that module belongs to the rollup and its export line is restored in #436.

🤖 Generated with Claude Code

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

[JeremyFunk]

Superseded by the v2 stack: #451 → #452 → #453. The registry-artifact + SQL-equivalence design this stack implemented was dropped in the write-side plan's v2 revision; vendor rules are now plain Rust with the vendored classification fixture as the CI gate.

[github-actions]

🍁 Maple PR preview

Note

Preview resources were removed when this pull request closed.

Final commit e621844 · View workflow run