wtclaude
bf470c7658
THROWAWAY BRANCH — evidence for the Phase 1 contract, never merged. See
modules/uo/SPIKE.md and docs/website/MODULE_API.md Part 7.
The six public spawn-atlas routes now live in modules/uo/, reached only through
the ctx/register surface, with the client half loading as a prebuilt ESM chunk.
All three exit criteria met:
• zero internal-file imports from the module into core; the built chunk has
zero bare import specifiers and bundles no React
• routes.manifest.json AND routes.guards.json are byte-identical
• /uo/atlas renders from /modules/uo/entry.js under script-src 'self' with
zero CSP violation reports
729 core tests and 81 module tests pass. Verified end to end against the real
database: the schema fragment replays after core's, onBoot runs the atlas
refresh, and the six API URLs answer unchanged.
Two things the spike changed in the contract:
• ctx.express / ctx.validator. A module lives outside server/, so Node never
reaches server/node_modules and require('express') fails outright — the
server-side twin of the one-React rule, which §2.6 had only for the client.
• window.__rg.jsxRuntime, so a module can build with the automatic JSX
runtime its tooling already assumes rather than being forced to classic.
And it confirmed §6.1 empirically: regenerating the OpenAPI spec silently
deleted all 361 lines of the atlas paths with "Swagger-autogen: Success", while
the route manifest kept all six in the same run. That is exactly the
static-analysis-vs-runtime split the fragment merge exists to prevent.
Co-Authored-By: Claude <noreply@anthropic.com>
45 lines
1.3 KiB
JavaScript
45 lines
1.3 KiB
JavaScript
// ── Shard feature visibility (model) ───────────────────────────────────────
|
|
//
|
|
// Thin row-shaping layer over shardVisibility.db. The policy — the ladder, the
|
|
// feature catalog, the locked fields, the kind→feature map — lives in
|
|
// utils/shardVisibility.js; this file only reads and writes rows.
|
|
|
|
const db = require('./shardVisibility.db')
|
|
|
|
// The `field_rules` JSON column comes back as a string on the mariadb driver.
|
|
function parseRules(raw) {
|
|
if (raw == null) return {}
|
|
if (typeof raw === 'object') return raw
|
|
try {
|
|
const parsed = JSON.parse(raw)
|
|
return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {}
|
|
} catch {
|
|
return {}
|
|
}
|
|
}
|
|
|
|
const toSafe = (row) =>
|
|
row && {
|
|
feature: row.feature,
|
|
enabled: !!row.enabled,
|
|
audience: row.audience,
|
|
stream: row.stream == null ? null : !!row.stream,
|
|
fieldRules: parseRules(row.field_rules),
|
|
updatedBy: row.updated_by,
|
|
updatedAt: row.updated_at,
|
|
}
|
|
|
|
async function listAll() {
|
|
const rows = await db.listAll()
|
|
return rows.map(toSafe)
|
|
}
|
|
|
|
async function getOne(feature) {
|
|
const rows = await db.getOne(feature)
|
|
return toSafe(rows[0])
|
|
}
|
|
|
|
const upsert = (entry) => db.upsert(entry)
|
|
|
|
module.exports = { listAll, getOne, upsert }
|