@tangle-network/starter-foundry 0.7.2 → 0.13.0

package/dist/training/family_proposer/propose.js

@@ -8,7 +8,7 @@
 //
 // When a router key is present, the LLM drafts fresh manifests +
 // real template bodies. Without a key, we fall back to the existing
-// `scripts/new-family.mjs` skeleton (deterministic TODO stubs).
+// `scripts/new-family.ts` skeleton (deterministic TODO stubs).
 import { readFileSync, existsSync, readdirSync, writeFileSync, mkdirSync, statSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -19,11 +19,11 @@ const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
 const PROPOSALS_DIR = join(REPO, '.evolve/family-proposals');
 function taxonomyDistance(a, b) {
     let dist = 0;
-    if (a.language !== b['language'])
+    if (a.language !== b.language)
         dist += 1;
-    if (a.runtime !== b['runtime'])
+    if (a.runtime !== b.runtime)
         dist += 1;
-    if (a.surface !== b['surface'])
+    if (a.surface !== b.surface)
         dist += 1;
     return dist;
 }
@@ -99,7 +99,7 @@ function slotForFile(filePath, runtime, surface) {
         return `main entrypoint for the ${runtime} starter`;
     }
     if (filePath === 'src/App.tsx')
-        return 'React App component — functional component with useState for app-local state, renders a simple UI surfacing the family\'s domain.';
+        return "React App component — functional component with useState for app-local state, renders a simple UI surfacing the family's domain.";
     if (filePath === 'src/index.ts') {
         if (surface === 'api')
             return 'HTTP server entrypoint using Hono or native Node http, /health endpoint returning 200.';
@@ -137,8 +137,43 @@ function slotForFile(filePath, runtime, surface) {
         return 'Go binary entrypoint with main() and top-level wiring';
     if (filePath.endsWith('.mjs'))
         return 'Node validator asserting key files + deps structure';
-    if (filePath === 'README.md')
+    if (filePath === 'README.md') {
+        if (surface === 'agent-runtime')
+            return 'Bundle README with THESE exact sections in order: "## What this bundle is" (one paragraph: this is a system prompt + domain templates + cron/webhook triggers for an agent-in-a-sandbox; no `pnpm build` step), "## How a sandbox spawns it" (what file the agent reads first — system-prompt.md — and how templates/ get resolved), "## Domain capabilities" (bullet list mirroring defaults.declaredCapabilities), "## Extension Points" (the 2-3 files a downstream BA-dispatched agent will edit). NO start scripts, NO npm install instructions for non-Worker bundles.';
         return 'Project README with THESE exact section headers in order: "## Quickstart" (npm/pnpm install + dev command), "## Environment" (list every VITE_ / env var from .env.example with a one-line description + where to obtain the value), "## Architecture" (what src/main and src/App do, what deps are used for), "## Extension Points" (the 2-3 files an agent will most likely edit when building on this starter). Write as if the reader is a staff engineer who has never seen the domain — explain every non-obvious design choice. No marketing fluff, no emojis.';
+    }
+    // multi-agent-team surface — curated team of role agents with an
+    // OpenCode-native subagent registry (agents.json) and an orchestrator
+    // AGENTS.md that includes a "## Coordination" section.
+    if (surface === 'multi-agent-team') {
+        if (filePath === 'AGENTS.md')
+            return 'Top-level orchestrator system prompt. MUST start with YAML frontmatter (name / role / domain / team / version). Required sections: "## Role" (one paragraph naming the N roles), "## The team and what each role is for" (bulleted role list with one-line descriptions), "## Delegation protocol" (routing rules + 3-4 concrete examples), "## Coordination" (folds in the team protocol — routing table or rules, handoff format with code block, escalation triggers, joint-decision cadence if applicable, failure modes). The Coordination section is the source of truth for inter-role behavior; when the role training disagrees with it, the protocol wins.';
+        if (filePath === 'agents.json')
+            return 'OpenCode-native subagent registry consumed by the Tangle sandbox sidecar (apps/sidecar/src/agents/subagents/load-agents-config.ts). Shape: {"<role-id>":{"mode":"subagent","description":"<one-line>","prompt":"<INLINE FULL TEXT of roles/<role-id>/AGENTS.md — not a path>","tools":{"bash":<bool>,"edit":<bool>,"read":<bool>,"write":<bool>,"webfetch":<bool>},"permission":{"edit":"allow|deny","webfetch":"allow|deny","bash":"allow|deny"}}}. Conservative defaults: read+write+webfetch on; bash+edit deny. High-stakes bundles handling PII set webfetch:false + permission.webfetch:"deny" on intake roles.';
+        if (filePath.startsWith('roles/') && filePath.endsWith('/AGENTS.md'))
+            return 'Per-role system prompt. MUST start with YAML frontmatter (name / role / domain / allowedDomains / allowedEnv / version). MUST reference the orchestrator AGENTS.md Coordination section and the team-wide rules. MUST list initiating + receiving handoffs with concrete triggers. Must declare role-specific authoritative skills loadable from methodology/. The full text becomes the inline `prompt` in agents.json.';
+        if (filePath.startsWith('roles/') &&
+            filePath.includes('/methodology/') &&
+            filePath.endsWith('.md'))
+            return 'Per-role methodology (>=60 lines, no stub). Real craft methodology — diagnostics, procedures, artifact shapes, anti-patterns, when-to-escalate. When the methodology has a cross-medium variant (e.g., scoring for picture, voice signature for cover), include that variant explicitly with concrete examples; do not bury it in prose.';
+    }
+    // agent-runtime surface — bundles ship a system prompt + domain templates + (CF Worker or local-CLI) triggers.
+    if (surface === 'agent-runtime') {
+        if (filePath === 'system-prompt.md')
+            return 'Layered system prompt for the agent-in-sandbox. MUST start with YAML frontmatter (---\\nname: <id>\\nrole: <one-line>\\ndomain: <one-line>\\nallowedDomains: []\\nallowedEnv: []\\n---) followed by sections: "## Role", "## Authoritative skills" (relative refs to skills/*.md), "## Output blocks" (declares :::<block> grammar the UI parses, e.g. :::proposal, :::filing, :::artifact), "## Refusal & escalation" (when to refuse, when to escalate to a human). Concise, directive, no examples in the prompt body — examples live in templates/.';
+        if (filePath === 'templates/index.json')
+            return 'JSON index of domain templates. Shape: {"entries":[{"id":"<slug>","capability":"<declared-capability-id>","path":"./<file.md>","tags":["..."],"version":"0.1.0"}]}. Every declared capability in defaults.declaredCapabilities MUST appear as the capability field on at least one entry. Every "path" MUST resolve to an existing file relative to this index.';
+        if (filePath.startsWith('templates/') && filePath.endsWith('.md'))
+            return 'Domain template (>=40 lines, no stub). Reference content the agent reads at runtime — examples, rule files, form-mappings, persona briefs. Concrete, sourced, dated where applicable. Frontmatter MUST include source + retrieved (ISO date) when citing factual material; no factual claim ships without provenance.';
+        if (filePath.startsWith('skills/') && filePath.endsWith('.md'))
+            return 'Conditional skill (>=30 lines). Loaded by name from system-prompt.md "Authoritative skills" list. Domain rules + cross-references to templates. No directive that contradicts the base prompt.';
+        if (filePath === 'wrangler.toml')
+            return 'Cloudflare Worker config for agent-runtime bundle. Sections: [vars] (only allowlisted public vars from defaults.publicVars — NEVER secrets), [[d1_databases]] with binding="DB" + database_name="<replace-me>" + database_id="<replace-me>" placeholder (consumer provisions), [[kv_namespaces]] with binding="VAULT", [triggers] crons = ["<minute> <hour> * * *"] where <minute> is the literal token RANDOM_MINUTE (substituted at compose time per bundleId hash). NO inline secrets, NO `* * * * *` crons.';
+        if (filePath === 'src/index.ts')
+            return 'CF Worker entrypoint exporting fetch + scheduled handlers. fetch: streaming chat against the agent — POST /api/chat dispatches to the agent loop, reads system-prompt.md + templates index, passes through structured output blocks. scheduled(): wakes on cron, runs deadline/feedback checks declared in defaults.scheduled. Both handlers MUST gate on Authorization unless the route is in defaults.routes with auth: "none".';
+        if (filePath === 'agent.config.json')
+            return 'Local-CLI bundle config. Shape: {"runtime":"local-cli","triggers":[{"id":"<slug>","cron":"<expr>","cmd":"<argv>"}],"tools":["<sandbox-tool-id>"]}. Substitutes for wrangler.toml on local-CLI variant; same cron-syntax constraints apply.';
+    }
     return `${filePath} — agent-extensible entry file`;
 }
 function filesForTaxonomy(taxonomy) {
@@ -147,23 +182,96 @@ function filesForTaxonomy(taxonomy) {
     const surface = taxonomy.surface;
     const validator = `validate-${runtime}.mjs`;
     const toFiles = (paths) => paths.map((p) => ({ path: p, role: slotForFile(p, runtime, surface) }));
+    // multi-agent-team surface — curated team bundle: harness-native
+    // AGENTS.md (orchestrator + Coordination section) + agents.json
+    // (OpenCode-native subagent registry consumed by the Tangle sandbox
+    // sidecar) + per-role AGENTS.md + per-role methodology files.
+    // Markdown + JSON only; no Worker shell.
+    if (surface === 'multi-agent-team') {
+        return toFiles([
+            'AGENTS.md',
+            'agents.json',
+            'roles/example-role/AGENTS.md',
+            'README.md',
+            validator,
+        ]);
+    }
+    // agent-runtime surface — bundles span markdown + (CF Worker or local-CLI) triggers.
+    // Triggered via taxonomy.surface, not language: a bundle whose primary content
+    // is markdown still ships a TS Worker shell when runtime=cloudflare-worker.
+    if (surface === 'agent-runtime') {
+        const baseMd = [
+            'system-prompt.md',
+            'templates/index.json',
+            'templates/example.md',
+            'README.md',
+            validator,
+        ];
+        if (runtime === 'cloudflare-worker') {
+            return toFiles([...baseMd, 'wrangler.toml', 'src/index.ts', 'package.json', 'tsconfig.json']);
+        }
+        if (runtime === 'local-cli') {
+            return toFiles([...baseMd, 'agent.config.json']);
+        }
+        return toFiles(baseMd);
+    }
     // TypeScript / Node / Bun / Deno / CF-Worker permutations
     if (lang === 'typescript' || lang === 'javascript') {
         if (surface === 'frontend') {
-            return toFiles(['package.json', 'tsconfig.json', 'vite.config.ts', 'index.html', 'src/main.tsx', 'src/App.tsx', '.env.example', 'README.md', validator]);
+            return toFiles([
+                'package.json',
+                'tsconfig.json',
+                'vite.config.ts',
+                'index.html',
+                'src/main.tsx',
+                'src/App.tsx',
+                '.env.example',
+                'README.md',
+                validator,
+            ]);
         }
         if (surface === 'api' || surface === 'inference') {
-            return toFiles(['package.json', 'tsconfig.json', 'src/index.ts', '.env.example', 'README.md', validator]);
+            return toFiles([
+                'package.json',
+                'tsconfig.json',
+                'src/index.ts',
+                '.env.example',
+                'README.md',
+                validator,
+            ]);
         }
         if (surface === 'cli') {
-            return toFiles(['package.json', 'tsconfig.json', 'src/cli.ts', 'src/index.ts', 'README.md', validator]);
+            return toFiles([
+                'package.json',
+                'tsconfig.json',
+                'src/cli.ts',
+                'src/index.ts',
+                'README.md',
+                validator,
+            ]);
         }
         if (surface === 'agent') {
-            return toFiles(['package.json', 'tsconfig.json', 'src/agent.ts', 'src/index.ts', '.env.example', 'README.md', validator]);
+            return toFiles([
+                'package.json',
+                'tsconfig.json',
+                'src/agent.ts',
+                'src/index.ts',
+                '.env.example',
+                'README.md',
+                validator,
+            ]);
         }
         if (surface === 'tooling') {
             // Eval/test-harness-shaped project: scenarios + judges + runner + validator.
-            return toFiles(['package.json', 'tsconfig.json', 'src/runner.ts', 'scenarios/example.ts', 'judges/example.ts', 'README.md', validator]);
+            return toFiles([
+                'package.json',
+                'tsconfig.json',
+                'src/runner.ts',
+                'scenarios/example.ts',
+                'judges/example.ts',
+                'README.md',
+                validator,
+            ]);
         }
         // Unknown TS surface: still give a real scaffold, not a bare README.
         return toFiles(['package.json', 'tsconfig.json', 'src/index.ts', 'README.md', validator]);
@@ -171,16 +279,37 @@ function filesForTaxonomy(taxonomy) {
     // Python permutations
     if (lang === 'python') {
         if (surface === 'api') {
-            return toFiles(['pyproject.toml', 'requirements.txt', 'src/main.py', '.env.example', 'README.md', validator]);
+            return toFiles([
+                'pyproject.toml',
+                'requirements.txt',
+                'src/main.py',
+                '.env.example',
+                'README.md',
+                validator,
+            ]);
         }
         if (surface === 'cli') {
             return toFiles(['pyproject.toml', 'requirements.txt', 'src/cli.py', 'README.md', validator]);
         }
         if (surface === 'agent') {
-            return toFiles(['pyproject.toml', 'requirements.txt', 'src/agent.py', 'src/main.py', 'README.md', validator]);
+            return toFiles([
+                'pyproject.toml',
+                'requirements.txt',
+                'src/agent.py',
+                'src/main.py',
+                'README.md',
+                validator,
+            ]);
         }
         // Default python surface
-        return toFiles(['pyproject.toml', 'requirements.txt', 'src/main.py', '.env.example', 'README.md', validator]);
+        return toFiles([
+            'pyproject.toml',
+            'requirements.txt',
+            'src/main.py',
+            '.env.example',
+            'README.md',
+            validator,
+        ]);
     }
     // Rust permutations
     if (lang === 'rust') {
@@ -207,7 +336,7 @@ async function proposeViaLLM(input, peers) {
         return null;
     const llm = createLLM();
     const peerSummary = peers
-        .map((p) => `- ${p.id} (${p.taxonomy['language'] ?? '?'}/${p.taxonomy['runtime'] ?? '?'}/${p.taxonomy['surface'] ?? '?'}): ${p.description}`)
+        .map((p) => `- ${p.id} (${p.taxonomy.language ?? '?'}/${p.taxonomy.runtime ?? '?'}/${p.taxonomy.surface ?? '?'}): ${p.description}`)
         .join('\n');
     const cues = (input.productCues ?? []).join('\n- ') || '(none)';
     try {
@@ -228,9 +357,7 @@ async function proposeViaLLM(input, peers) {
         // string[] inputs as missing — use ['(no refinements yet)'] as the
         // shot-1 sentinel so the field is always populated.
         const directives = (input.productCues ?? []).filter((c) => /REVIEWER DIRECTIVE|REFINEMENT GUIDANCE|prior fidelity rejection/i.test(c));
-        const refinementHints = directives.length > 0
-            ? directives
-            : ['(shot 1 — no prior reviewer directives)'];
+        const refinementHints = directives.length > 0 ? directives : ['(shot 1 — no prior reviewer directives)'];
         for (const f of wantedFiles) {
             try {
                 const body = (await fileAuthor.forward(llm, {
@@ -261,7 +388,9 @@ async function proposeViaLLM(input, peers) {
         }
         const manifest = {
             id: input.id,
-            description: input.description.length >= 20 ? input.description : `${input.description} — ${input.taxonomy.runtime} ${input.taxonomy.surface} starter`,
+            description: input.description.length >= 20
+                ? input.description
+                : `${input.description} — ${input.taxonomy.runtime} ${input.taxonomy.surface} starter`,
             tags: [input.taxonomy.runtime, input.taxonomy.surface, input.taxonomy.language],
             taxonomy: input.taxonomy,
             defaults: { projectType: input.taxonomy.surface, serviceName: `starter-foundry-${input.id}` },
@@ -286,7 +415,12 @@ async function proposeViaLLM(input, peers) {
                 gotchas: hints.gotchas ?? [],
                 architectureNotes: hints.architectureNotes ?? [],
                 placeholders: hints.primaryEntrypoint
-                    ? [{ path: hints.primaryEntrypoint, description: `Primary entrypoint agents must extend.` }]
+                    ? [
+                        {
+                            path: hints.primaryEntrypoint,
+                            description: `Primary entrypoint agents must extend.`,
+                        },
+                    ]
                     : [],
             },
             ...(Object.keys(deps).length > 0 ? { packageDeps: { dependencies: deps } } : {}),
@@ -316,7 +450,9 @@ async function proposeViaLLM(input, peers) {
 function proposeDeterministic(input, peers) {
     const manifest = {
         id: input.id,
-        description: input.description.length >= 20 ? input.description : `${input.description} — starter (regenerate before shipping)`,
+        description: input.description.length >= 20
+            ? input.description
+            : `${input.description} — starter (regenerate before shipping)`,
         tags: [input.taxonomy.runtime, input.taxonomy.surface, input.taxonomy.language],
         taxonomy: input.taxonomy,
         defaults: { projectType: input.taxonomy.surface, serviceName: `starter-foundry-${input.id}` },
@@ -326,10 +462,19 @@ function proposeDeterministic(input, peers) {
         keywords: [input.id],
         tieredKeywords: { tier1: [input.id], tier2: [] },
         buildHints: {
-            whenToUse: `TODO: describe when a prompt should route to ${input.id}. Derive from peer families: ${peers.slice(0, 3).map((p) => p.id).join(', ')}.`,
-            firstSteps: ['TODO: install command', 'TODO: dev-server command', 'TODO: entrypoint an agent should extend'],
+            whenToUse: `TODO: describe when a prompt should route to ${input.id}. Derive from peer families: ${peers
+                .slice(0, 3)
+                .map((p) => p.id)
+                .join(', ')}.`,
+            firstSteps: [
+                'TODO: install command',
+                'TODO: dev-server command',
+                'TODO: entrypoint an agent should extend',
+            ],
             gotchas: ['TODO: one non-obvious trap specific to this runtime'],
-            placeholders: [{ path: 'TODO/entrypoint.xyz', description: 'TODO: primary file agents must replace.' }],
+            placeholders: [
+                { path: 'TODO/entrypoint.xyz', description: 'TODO: primary file agents must replace.' },
+            ],
         },
     };
     const frameworkManifest = {
@@ -433,18 +578,18 @@ function validateDraftForRLM(state, id, taxonomy) {
     const m = state.manifest;
     if (!m)
         return ['manifest is null'];
-    if (m['id'] !== id)
-        errors.push(`manifest.id=${String(m['id'])} but expected ${id}`);
-    const desc = typeof m['description'] === 'string' ? m['description'] : '';
+    if (m.id !== id)
+        errors.push(`manifest.id=${String(m.id)} but expected ${id}`);
+    const desc = typeof m.description === 'string' ? m.description : '';
     if (!desc || desc.length < 20)
         errors.push('description missing or <20 chars');
-    if (!m['taxonomy'])
+    if (!m.taxonomy)
         errors.push('missing taxonomy');
     const serialized = JSON.stringify(m);
     if (serialized.includes('TODO:') || serialized.includes('TODO ')) {
         errors.push('TODO placeholders present — proposer emitted a skeleton');
     }
-    const tier1 = m['tieredKeywords']?.['tier1'];
+    const tier1 = m.tieredKeywords?.tier1;
     if (!Array.isArray(tier1) || tier1.length < 3)
         errors.push('tieredKeywords.tier1 must have ≥3 entries');
     // R3: tier1 must be domain-specific, not taxonomy restatements. The LLM
@@ -476,11 +621,11 @@ function validateDraftForRLM(state, id, taxonomy) {
         try {
             const parsed = JSON.parse(pkg);
             const scripts = parsed.scripts ?? {};
-            if (surface === 'frontend' && !scripts['dev']) {
+            if (surface === 'frontend' && !scripts.dev) {
                 errors.push('package.json missing "dev" script — frontend scaffold must expose a dev server command (e.g. "vite")');
             }
             const allDeps = { ...(parsed.dependencies ?? {}), ...(parsed.devDependencies ?? {}) };
-            const tsVersion = allDeps['typescript'];
+            const tsVersion = allDeps.typescript;
             if (tsVersion && /^\^?4\./.test(tsVersion)) {
                 errors.push(`typescript pinned to ${tsVersion} — use TypeScript 5.x for new scaffolds`);
             }
@@ -510,6 +655,75 @@ function validateDraftForRLM(state, id, taxonomy) {
             errors.push(`${surface} surface should document env vars — add .env.example or an "Environment" section to README.md`);
         }
     }
+    // agent-runtime surface — structural rules the proposer must obey, mirroring the
+    // gate-2 validators (prompt-frontmatter-valid, template-index-valid, cron-syntax-valid).
+    // Without these checks the LLM happily ships a markdown bundle that schema-passes
+    // but has no frontmatter / dangling templates / a cron storm.
+    if (surface === 'agent-runtime') {
+        const promptBody = byPath['system-prompt.md'];
+        if (!promptBody) {
+            errors.push('agent-runtime bundle missing system-prompt.md — every bundle must declare its layered base prompt');
+        }
+        else if (!promptBody.startsWith('---')) {
+            errors.push('system-prompt.md does not begin with YAML frontmatter (---) — gate-2 prompt-frontmatter-valid will fail');
+        }
+        else {
+            const closeIdx = promptBody.indexOf('\n---', 4);
+            if (closeIdx === -1) {
+                errors.push('system-prompt.md frontmatter is unterminated (missing closing "---")');
+            }
+        }
+        const indexBody = byPath['templates/index.json'];
+        if (!indexBody) {
+            errors.push('agent-runtime bundle missing templates/index.json — capability ↔ template mapping is required');
+        }
+        else {
+            try {
+                const parsed = JSON.parse(indexBody);
+                const entries = parsed.entries ?? [];
+                if (entries.length === 0) {
+                    errors.push('templates/index.json has zero entries — bundle ships no domain content');
+                }
+                for (const entry of entries) {
+                    if (!entry.path) {
+                        errors.push(`templates/index.json entry id=${entry.id ?? '?'} has no path`);
+                        continue;
+                    }
+                    const normalized = entry.path
+                        .replace(/^\.?\//, 'templates/')
+                        .replace(/^templates\/templates\//, 'templates/');
+                    if (!(normalized in byPath) && !(entry.path in byPath)) {
+                        errors.push(`templates/index.json entry "${entry.path}" does not resolve to a generated file (dangling reference)`);
+                    }
+                }
+            }
+            catch {
+                errors.push('templates/index.json is not valid JSON');
+            }
+        }
+        const wrangler = byPath['wrangler.toml'];
+        if (wrangler) {
+            const cronMatch = /crons\s*=\s*\[([^\]]*)\]/.exec(wrangler);
+            if (cronMatch && cronMatch[1]) {
+                const exprs = Array.from(cronMatch[1].matchAll(/"([^"]+)"/g)).map((m) => m[1] ?? '');
+                for (const expr of exprs) {
+                    if (expr.trim() === '* * * * *') {
+                        errors.push(`wrangler.toml ships a "* * * * *" cron — fires 60×/hour, gate-2 cron-syntax-valid will fail`);
+                    }
+                }
+            }
+        }
+        // Anti-stub: every template under templates/ (except index.json) must be substantive.
+        for (const [p, body] of Object.entries(byPath)) {
+            if (!p.startsWith('templates/') || !p.endsWith('.md'))
+                continue;
+            const lines = body.split('\n').filter((l) => l.trim().length > 0).length;
+            const hasStubFrontmatter = /^---[\s\S]*?\bstatus:\s*stub\b[\s\S]*?---/.test(body);
+            if (lines < 40 && !hasStubFrontmatter) {
+                errors.push(`${p} is too short (${lines} non-empty lines) — templates need >=40 lines of substance, or explicit "status: stub" frontmatter (which fails the substance gate honestly)`);
+            }
+        }
+    }
     // Frontend mainfile shape: if surface=frontend and language=typescript/javascript,
     // src/main.ts|tsx shouldn't import node-only modules like 'http'. That was
     // the R2 smoking gun — description said frontend, main.ts shipped Node HTTP.
@@ -518,21 +732,23 @@ function validateDraftForRLM(state, id, taxonomy) {
             const body = byPath[p];
             if (!body)
                 continue;
-            if (/\bfrom\s+['"]http['"]/.test(body) || /require\(['"]http['"]\)/.test(body) || /createServer/.test(body)) {
+            if (/\bfrom\s+['"]http['"]/.test(body) ||
+                /require\(['"]http['"]\)/.test(body) ||
+                body.includes('createServer')) {
                 errors.push(`${p} imports node:http / createServer — frontend surface must not ship a Node HTTP server in the UI entrypoint`);
             }
         }
     }
     const fm = state.frameworkManifest;
     if (fm) {
-        const applies = fm['appliesTo'];
+        const applies = fm.appliesTo;
         if (!Array.isArray(applies) || !applies.includes(id)) {
             errors.push('frameworkManifest.appliesTo must include family id');
         }
     }
     return errors;
 }
-export async function proposeFamilyWithRLM(input, opts = {}) {
+async function proposeFamilyWithRLM(input, opts = {}) {
     if (!isLLMAvailable())
         return null;
     const peers = loadPeerSummaries(input.taxonomy, 5);
@@ -540,12 +756,22 @@ export async function proposeFamilyWithRLM(input, opts = {}) {
     const maxShots = opts.maxShots ?? 3;
     const propose = async ({ priorReview }) => {
         const cues = priorReview?.nextShotInstruction
-            ? [...(input.productCues ?? []), `REVIEWER DIRECTIVE (shot refinement): ${priorReview.nextShotInstruction}`]
+            ? [
+                ...(input.productCues ?? []),
+                `REVIEWER DIRECTIVE (shot refinement): ${priorReview.nextShotInstruction}`,
+            ]
             : (input.productCues ?? []);
         const p = await proposeViaLLM({ ...input, productCues: cues }, peers);
         if (!p) {
             // Proposer failed entirely — return empty state so the verifier flags it.
-            return { state: { manifest: null, frameworkManifest: null, templateFiles: [], reasoning: '(proposer returned null)' } };
+            return {
+                state: {
+                    manifest: null,
+                    frameworkManifest: null,
+                    templateFiles: [],
+                    reasoning: '(proposer returned null)',
+                },
+            };
         }
         return {
             state: {
@@ -563,15 +789,15 @@ export async function proposeFamilyWithRLM(input, opts = {}) {
         const result = { pass, score, failingLayers: errors.slice(0, 5), details: errors };
         return result;
     };
-    const review = async ({ state, verification, memory, shot, goal }) => {
+    const review = async ({ state, verification, memory, shot, goal, }) => {
         const failures = verification.details ?? [];
         const priorMem = memory
             .map((m) => `shot ${m.shot} conf=${m.confidence.toFixed(2)} instr="${m.nextShotInstruction.slice(0, 200)}"`)
             .join('\n') || '(none)';
-        const tier1 = state.manifest?.['tieredKeywords']?.['tier1'];
+        const tier1 = state.manifest?.tieredKeywords?.tier1;
         const tier1Len = Array.isArray(tier1) ? tier1.length : 0;
-        const desc = typeof state.manifest?.['description'] === 'string' ? state.manifest['description'] : '';
-        const summary = `id=${String(state.manifest?.['id'])} desc="${desc.slice(0, 120)}" files=${state.templateFiles.length} tier1=${tier1Len}`;
+        const desc = typeof state.manifest?.description === 'string' ? state.manifest.description : '';
+        const summary = `id=${String(state.manifest?.id)} desc="${desc.slice(0, 120)}" files=${state.templateFiles.length} tier1=${tier1Len}`;
         const raw = (await proposalReviewer.forward(llm, {
             goal,
             currentDraftSummary: summary,
@@ -587,7 +813,9 @@ export async function proposeFamilyWithRLM(input, opts = {}) {
         const hasBudget = shot < maxShots;
         const shouldContinue = failures.length > 0 && hasBudget
             ? true
-            : typeof raw.shouldContinue === 'boolean' ? raw.shouldContinue : hasBudget;
+            : typeof raw.shouldContinue === 'boolean'
+                ? raw.shouldContinue
+                : hasBudget;
         return {
             observations: String(raw.observations ?? `shot ${shot} produced ${failures.length} verification failures`),
             diagnosis: String(raw.diagnosis ?? 'reviewer returned no diagnosis'),
@@ -600,7 +828,12 @@ export async function proposeFamilyWithRLM(input, opts = {}) {
     // Gives shot 1 the benefit of what the downstream fidelity judge flagged in
     // prior sessions — the proposer stops repeating the same failure.
     const priorFidelityEntries = loadPriorFidelityEntries(input.id);
-    const initialState = { manifest: null, frameworkManifest: null, templateFiles: [], reasoning: '' };
+    const initialState = {
+        manifest: null,
+        frameworkManifest: null,
+        templateFiles: [],
+        reasoning: '',
+    };
     const report = await runProposeReview({
         goal: `Generate a complete, promotable family registry entry for ${input.id}: ${input.description}`,
         initialState,