@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/dist/training/capability_proposer/propose.js

@@ -0,0 +1,305 @@
+// Gen-6 Track C: capability proposer with RLM refinement.
+//
+// Capabilities are the lower-blast-radius complement to families. A family
+// owns the root of a project (package.json, tsconfig, entrypoint). A
+// capability slots into one or more families, adding a feature. The
+// promotion bar is lower — a capability that doesn't compose is easy to
+// remove; a broken family takes a whole project down.
+//
+// Schema mirrors registry/layers/capability/<id>/manifest.json:
+//   { id, description, appliesTo[], defaults, files[], contextHints,
+//     capabilityRequires[], keywords[], tieredKeywords }
+//
+// Propose surface: { id, description, appliesTo[], slotFiles[] }. RLM
+// refines via the same ax propose→verify→review loop as family-proposer.
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ax } from '@ax-llm/ax';
+import { runProposeReview, } from '@tangle-network/agent-eval';
+import { createLLM, isLLMAvailable } from '../../lib/llm.js';
+const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+const PROPOSALS_DIR = join(REPO, '.evolve/capability-proposals');
+function loadPeerCapabilities(appliesTo, limit) {
+    const root = join(REPO, 'registry/layers/capability');
+    if (!existsSync(root))
+        return [];
+    const rows = [];
+    for (const id of readdirSync(root)) {
+        if (id.startsWith('.') || id.startsWith('_'))
+            continue;
+        const mp = join(root, id, 'manifest.json');
+        if (!existsSync(mp))
+            continue;
+        try {
+            const m = JSON.parse(readFileSync(mp, 'utf8'));
+            rows.push({
+                id: m.id,
+                description: m.description ?? '',
+                appliesTo: m.appliesTo ?? [],
+                keywords: m.keywords ?? [],
+            });
+        }
+        catch { /* skip */ }
+    }
+    // Rank by appliesTo overlap with the target — closest analogs first.
+    return rows
+        .map((r) => ({ r, score: r.appliesTo.filter((f) => appliesTo.includes(f)).length }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map(({ r }) => r);
+}
+const hintsAuthor = ax('capabilityId:string, capabilityDescription:string, appliesToFamilies:string, slotFilesSummary:string, productCues:string, peerCapabilitiesSummary:string -> whenToUse:string, extensionPoints:string[], capabilityRequires:string[], keywordsTier1:string[], keywordsTier2:string[], defaultsJson:string, reasoning:string');
+const fileAuthor = ax('capabilityId:string, capabilityDescription:string, appliesToFamilies:string, filePath:string, fileRole:string, peerCapabilitiesSummary:string -> fileBody:string');
+function slotForFile(filePath) {
+    if (filePath.endsWith('.json'))
+        return 'configuration or data JSON the capability wires in';
+    if (filePath.endsWith('.md'))
+        return 'capability documentation — when to use, extension points, gotchas';
+    if (filePath.endsWith('.ts') || filePath.endsWith('.tsx'))
+        return 'TypeScript source — a component, route, or handler the capability drops in';
+    return `${filePath} — slot file for the capability`;
+}
+function slotFilesForCapability(input) {
+    const explicit = input.slotFiles ?? [];
+    if (explicit.length > 0)
+        return explicit.map((p) => ({ path: p, role: slotForFile(p) }));
+    // Default: one config json + one markdown doc. Agent extends from there.
+    return [
+        { path: `${input.id}-config.json`, role: slotForFile(`${input.id}-config.json`) },
+        { path: `${input.id}.md`, role: slotForFile(`${input.id}.md`) },
+    ];
+}
+async function proposeViaLLM(input, peers) {
+    if (!isLLMAvailable())
+        return null;
+    const llm = createLLM({ fallback: true });
+    const peerSummary = peers
+        .map((p) => `- ${p.id} (${p.appliesTo.join(', ') || '*'}): ${p.description}`)
+        .join('\n');
+    const slotFiles = slotFilesForCapability(input);
+    try {
+        const hints = (await hintsAuthor.forward(llm, {
+            capabilityId: input.id,
+            capabilityDescription: input.description,
+            appliesToFamilies: input.appliesTo.join(', '),
+            slotFilesSummary: slotFiles.map((f) => `${f.path} — ${f.role}`).join('\n'),
+            productCues: (input.productCues ?? []).join('\n- ') || '(none)',
+            peerCapabilitiesSummary: peerSummary || '(no peers found)',
+        }));
+        const templateFiles = [];
+        for (const f of slotFiles) {
+            try {
+                const body = (await fileAuthor.forward(llm, {
+                    capabilityId: input.id,
+                    capabilityDescription: input.description,
+                    appliesToFamilies: input.appliesTo.join(', '),
+                    filePath: f.path,
+                    fileRole: f.role,
+                    peerCapabilitiesSummary: peerSummary,
+                }));
+                if (body.fileBody && body.fileBody.length > 10) {
+                    templateFiles.push({ path: f.path, body: body.fileBody });
+                }
+            }
+            catch (err) {
+                console.error(`[capability-propose] file ${f.path} failed: ${err.message}`);
+            }
+        }
+        let parsedDefaults = {};
+        try {
+            parsedDefaults = JSON.parse(hints.defaultsJson ?? '{}');
+        }
+        catch { /* tolerate bad JSON; defaults are optional */ }
+        const manifest = {
+            id: input.id,
+            description: input.description.length >= 20 ? input.description : `${input.description} — capability`,
+            appliesTo: input.appliesTo,
+            defaults: parsedDefaults,
+            files: templateFiles.map((f) => ({ source: `files/${f.path}`, target: f.path })),
+            contextHints: {
+                extensionPoints: hints.extensionPoints ?? templateFiles.map((f) => f.path),
+            },
+            capabilityRequires: hints.capabilityRequires ?? [],
+            keywords: [...(hints.keywordsTier1 ?? []), ...(hints.keywordsTier2 ?? [])],
+            tieredKeywords: {
+                tier1: hints.keywordsTier1 ?? [input.id],
+                tier2: hints.keywordsTier2 ?? [],
+            },
+            buildHints: {
+                whenToUse: hints.whenToUse ?? input.description,
+            },
+        };
+        return {
+            id: input.id,
+            proposalDir: join(PROPOSALS_DIR, input.id),
+            manifest,
+            templateFiles,
+            peerCapabilities: peers.map((p) => p.id),
+            mode: 'llm',
+            reasoning: hints.reasoning ?? '',
+        };
+    }
+    catch (err) {
+        console.error(`[capability-propose] LLM call failed: ${err.message}`);
+        return null;
+    }
+}
+function proposeDeterministic(input, peers) {
+    const manifest = {
+        id: input.id,
+        description: `${input.description} — capability (regenerate before shipping)`,
+        appliesTo: input.appliesTo,
+        defaults: {},
+        files: [],
+        contextHints: { extensionPoints: [] },
+        capabilityRequires: [],
+        keywords: [input.id],
+        tieredKeywords: { tier1: [input.id], tier2: [] },
+        buildHints: { whenToUse: `TODO: when to use ${input.id}. Peers: ${peers.slice(0, 3).map((p) => p.id).join(', ')}` },
+    };
+    return {
+        id: input.id,
+        proposalDir: join(PROPOSALS_DIR, input.id),
+        manifest,
+        templateFiles: [],
+        peerCapabilities: peers.map((p) => p.id),
+        mode: 'deterministic',
+        reasoning: 'No LLM provider available — emitting TODO skeleton.',
+    };
+}
+function validateCapabilityDraft(state, id, appliesTo) {
+    const errors = [];
+    const m = state.manifest;
+    if (!m)
+        return ['manifest is null'];
+    if (m['id'] !== id)
+        errors.push(`id mismatch: 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');
+    const applies = m['appliesTo'];
+    if (!Array.isArray(applies) || applies.length === 0)
+        errors.push('appliesTo must be non-empty array');
+    else {
+        for (const fam of appliesTo) {
+            if (!applies.includes(fam))
+                errors.push(`appliesTo must include ${fam}`);
+        }
+    }
+    const serialized = JSON.stringify(m);
+    if (serialized.includes('TODO:') || serialized.includes('TODO '))
+        errors.push('TODO placeholders present');
+    const tier1 = m['tieredKeywords']?.['tier1'];
+    if (!Array.isArray(tier1) || tier1.length < 2)
+        errors.push('tieredKeywords.tier1 must have ≥2 entries');
+    if (state.templateFiles.length === 0)
+        errors.push('no template files generated');
+    for (const f of state.templateFiles) {
+        if (typeof f.body !== 'string' || f.body.length < 20) {
+            errors.push(`file ${f.path} body <20 chars (stub)`);
+        }
+    }
+    return errors;
+}
+const capabilityReviewer = ax('"Direct the next shot of a capability proposer. You do NOT grade — the verifier flagged failures. Identify root cause (missing appliesTo? weak description? stub file bodies?) and emit a concrete next-shot instruction. Do not restate failures." goal:string, currentDraftSummary:string, verificationFailures:string[], priorShotsMemory:string -> observations:string, diagnosis:string, nextShotInstruction:string, shouldContinue:boolean, confidence:number');
+export async function proposeCapabilityWithRLM(input, opts = {}) {
+    if (!isLLMAvailable())
+        return null;
+    const peers = loadPeerCapabilities(input.appliesTo, 5);
+    const llm = createLLM({ fallback: true });
+    const maxShots = opts.maxShots ?? 3;
+    const propose = async ({ priorReview }) => {
+        const cues = priorReview?.nextShotInstruction
+            ? [...(input.productCues ?? []), `REVIEWER DIRECTIVE: ${priorReview.nextShotInstruction}`]
+            : (input.productCues ?? []);
+        const p = await proposeViaLLM({ ...input, productCues: cues }, peers);
+        if (!p) {
+            return { state: { manifest: null, templateFiles: [], reasoning: '(proposer returned null)' } };
+        }
+        return { state: { manifest: p.manifest, templateFiles: p.templateFiles, reasoning: p.reasoning } };
+    };
+    const verify = async (state) => {
+        const errors = validateCapabilityDraft(state, input.id, input.appliesTo);
+        const pass = errors.length === 0;
+        const score = pass ? 1 : Math.max(0, 1 - errors.length / 8);
+        const result = { pass, score, failingLayers: errors.slice(0, 5), details: errors };
+        return result;
+    };
+    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 tier1Len = Array.isArray(tier1) ? tier1.length : 0;
+        const desc = typeof state.manifest?.['description'] === 'string' ? state.manifest['description'] : '';
+        const applies = state.manifest?.['appliesTo'];
+        const summary = `id=${String(state.manifest?.['id'])} desc="${desc.slice(0, 120)}" applies=${Array.isArray(applies) ? applies.join(',') : '?'} files=${state.templateFiles.length} tier1=${tier1Len}`;
+        const raw = (await capabilityReviewer.forward(llm, {
+            goal,
+            currentDraftSummary: summary,
+            verificationFailures: failures,
+            priorShotsMemory: priorMem,
+        }));
+        return {
+            observations: String(raw.observations ?? `shot ${shot} had ${failures.length} failures`),
+            diagnosis: String(raw.diagnosis ?? 'no diagnosis'),
+            nextShotInstruction: String(raw.nextShotInstruction ?? 'fix failures'),
+            shouldContinue: typeof raw.shouldContinue === 'boolean' ? raw.shouldContinue : shot < maxShots,
+            confidence: Number.isFinite(raw.confidence) ? Number(raw.confidence) : 0.5,
+        };
+    };
+    const initialState = { manifest: null, templateFiles: [], reasoning: '' };
+    const report = await runProposeReview({
+        goal: `Generate a complete, promotable capability registry entry for ${input.id}: ${input.description}`,
+        initialState,
+        propose,
+        verify,
+        review,
+        maxShots,
+        scenarioId: 'capability-proposer',
+        projectId: input.id,
+    });
+    if (!report.finalState.manifest)
+        return null;
+    return {
+        id: input.id,
+        proposalDir: join(PROPOSALS_DIR, input.id),
+        manifest: report.finalState.manifest,
+        templateFiles: report.finalState.templateFiles,
+        peerCapabilities: peers.map((p) => p.id),
+        mode: 'llm-rlm',
+        reasoning: `RLM ${report.shots.length} shot(s), pass=${report.finalVerification.pass}, score=${report.score.toFixed(2)}. ${report.finalState.reasoning}`,
+    };
+}
+export async function proposeCapabilityWithRLMToDisk(input, opts = {}) {
+    const rlmProposal = await proposeCapabilityWithRLM(input, opts);
+    const peers = loadPeerCapabilities(input.appliesTo, 5);
+    const proposal = rlmProposal ?? proposeDeterministic(input, peers);
+    mkdirSync(proposal.proposalDir, { recursive: true });
+    writeFileSync(join(proposal.proposalDir, 'manifest.json'), JSON.stringify(proposal.manifest, null, 2) + '\n');
+    writeFileSync(join(proposal.proposalDir, '.meta.json'), JSON.stringify({
+        id: proposal.id,
+        appliesTo: input.appliesTo,
+        peerCapabilities: proposal.peerCapabilities,
+        mode: proposal.mode,
+        reasoning: proposal.reasoning,
+        generatedAt: new Date().toISOString(),
+    }, null, 2) + '\n');
+    for (const f of proposal.templateFiles) {
+        const abs = join(proposal.proposalDir, 'files', f.path);
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, f.body);
+    }
+    const filesDir = join(proposal.proposalDir, 'files');
+    mkdirSync(filesDir, { recursive: true });
+    const stat = statSync(filesDir);
+    if (stat.isDirectory()) {
+        const keep = join(filesDir, '.gitkeep');
+        if (!existsSync(keep))
+            writeFileSync(keep, '');
+    }
+    return proposal;
+}
+//# sourceMappingURL=propose.js.map

package/dist/training/capability_proposer/propose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../../src/training/capability_proposer/propose.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,oEAAoE;AACpE,wEAAwE;AACxE,sDAAsD;AACtD,EAAE;AACF,gEAAgE;AAChE,qEAAqE;AACrE,yDAAyD;AACzD,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACnG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EACL,gBAAgB,GAKjB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAE5D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAC/E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;AA6BhE,SAAS,oBAAoB,CAAC,SAAmB,EAAE,KAAa;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAA;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAChC,MAAM,IAAI,GAAkB,EAAE,CAAA;IAC9B,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,eAAe,CAAC,CAAA;QAC1C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,SAAQ;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAK5C,CAAA;YACD,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;gBAChC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;gBAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;aAC3B,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IACD,qEAAqE;IACrE,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACnF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,EAAE,CACpB,4TAA4T,CAC7T,CAAA;AAED,MAAM,UAAU,GAAG,EAAE,CACnB,kKAAkK,CACnK,CAAA;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,oDAAoD,CAAA;IAC3F,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,mEAAmE,CAAA;IACxG,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,4EAA4E,CAAA;IAC9I,OAAO,GAAG,QAAQ,iCAAiC,CAAA;AACrD,CAAC;AAED,SAAS,sBAAsB,CAAC,KAA6B;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAA;IACtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACxF,yEAAyE;IACzE,OAAO;QACL,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,EAAE,cAAc,CAAC,EAAE;QACjF,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE;KAChE,CAAA;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAA6B,EAAE,KAAoB;IAC9E,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAA;IAClC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,MAAM,WAAW,GAAG,KAAK;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE;YAC5C,YAAY,EAAE,KAAK,CAAC,EAAE;YACtB,qBAAqB,EAAE,KAAK,CAAC,WAAW;YACxC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7C,gBAAgB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1E,WAAW,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ;YAC/D,uBAAuB,EAAE,WAAW,IAAI,kBAAkB;SAC3D,CAAC,CAQD,CAAA;QACD,MAAM,aAAa,GAA0C,EAAE,CAAA;QAC/D,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC1C,YAAY,EAAE,KAAK,CAAC,EAAE;oBACtB,qBAAqB,EAAE,KAAK,CAAC,WAAW;oBACxC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC7C,QAAQ,EAAE,CAAC,CAAC,IAAI;oBAChB,QAAQ,EAAE,CAAC,CAAC,IAAI;oBAChB,uBAAuB,EAAE,WAAW;iBACrC,CAAC,CAA0B,CAAA;gBAC5B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;oBAC/C,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAC3D,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC,IAAI,YAAa,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;YACxF,CAAC;QACH,CAAC;QACD,IAAI,cAAc,GAA4B,EAAE,CAAA;QAChD,IAAI,CAAC;YACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAA4B,CAAA;QACpF,CAAC;QAAC,MAAM,CAAC,CAAC,8CAA8C,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,eAAe;YACrG,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,cAAc;YACxB,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChF,YAAY,EAAE;gBACZ,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAC3E;YACD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,EAAE;YAClD,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YAC1E,cAAc,EAAE;gBACd,KAAK,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;aACjC;YACD,UAAU,EAAE;gBACV,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,WAAW;aAChD;SACF,CAAA;QACD,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1C,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;SACjC,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,yCAA0C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;QAChF,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAA6B,EAAE,KAAoB;IAC/E,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,GAAG,KAAK,CAAC,WAAW,4CAA4C;QAC7E,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACrC,kBAAkB,EAAE,EAAE;QACtB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAChD,UAAU,EAAE,EAAE,SAAS,EAAE,qBAAqB,KAAK,CAAC,EAAE,YAAY,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;KACpH,CAAA;IACD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;QAC1C,QAAQ;QACR,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,qDAAqD;KACjE,CAAA;AACH,CAAC;AAQD,SAAS,uBAAuB,CAAC,KAA2B,EAAE,EAAU,EAAE,SAAmB;IAC3F,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAA;IACxB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAA;IACjG,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACzE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IAC9E,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,CAAA;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;SAChG,CAAC;QACJ,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IACpC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;IAC1G,MAAM,KAAK,GAAI,CAAC,CAAC,gBAAgB,CAAyC,EAAE,CAAC,OAAO,CAAC,CAAA;IACrF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;IACvG,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IAChF,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,kBAAkB,GAAG,EAAE,CAC3B,qcAAqc,CACtc,CAAA;AAMD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA6B,EAC7B,OAAiC,EAAE;IAEnC,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAA;IAClC,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACtD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAoC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACzE,MAAM,IAAI,GAAG,WAAW,EAAE,mBAAmB;YAC3C,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,uBAAuB,WAAW,CAAC,mBAAmB,EAAE,CAAC;YAC1F,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;QAC7B,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;QACrE,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE,EAAE,CAAA;QAChG,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,CAAA;IACpG,CAAC,CAAA;IAED,MAAM,MAAM,GAAmC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;QACxE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;QAChG,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,MAAM,MAAM,GAAmC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACnG,MAAM,QAAQ,GAAI,YAAY,CAAC,OAAgC,IAAI,EAAE,CAAA;QACrE,MAAM,QAAQ,GAAG,MAAM;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;aAC3G,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAA;QACzB,MAAM,KAAK,GAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAyC,EAAE,CAAC,OAAO,CAAC,CAAA;QACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAY,CAAC,CAAC,CAAC,EAAE,CAAA;QACjH,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,KAAK,CAAC,aAAa,CAAC,MAAM,UAAU,QAAQ,EAAE,CAAA;QACrM,MAAM,GAAG,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE;YACjD,IAAI;YACJ,mBAAmB,EAAE,OAAO;YAC5B,oBAAoB,EAAE,QAAQ;YAC9B,gBAAgB,EAAE,QAAQ;SAC3B,CAAC,CAMD,CAAA;QACD,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,QAAQ,IAAI,QAAQ,QAAQ,CAAC,MAAM,WAAW,CAAC;YACxF,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,cAAc,CAAC;YAClD,mBAAmB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,cAAc,CAAC;YACtE,cAAc,EAAE,OAAO,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ;YAC9F,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG;SAC3E,CAAA;IACH,CAAC,CAAA;IAED,MAAM,YAAY,GAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC/F,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAuB;QAC1D,IAAI,EAAE,iEAAiE,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE;QACvG,YAAY;QACZ,OAAO;QACP,MAAM;QACN,MAAM;QACN,QAAQ;QACR,UAAU,EAAE,qBAAqB;QACjC,SAAS,EAAE,KAAK,CAAC,EAAE;KACpB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE5C,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;QAC1C,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;QACpC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa;QAC9C,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,kBAAkB,MAAM,CAAC,iBAAiB,CAAC,IAAI,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE;KACzJ,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,KAA6B,EAC7B,OAAiC,EAAE;IAEnC,MAAM,WAAW,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC/D,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,WAAW,IAAI,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAElE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpD,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC7G,aAAa,CACX,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,EACxC,IAAI,CAAC,SAAS,CACZ;QACE,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACvD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACpD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/training/family_proposer/propose.d.ts

@@ -0,0 +1,35 @@
+interface ProposeFamilyInput {
+    id: string;
+    description: string;
+    taxonomy: {
+        language: string;
+        runtime: string;
+        surface: string;
+    };
+    /** Optional: rough list of what the scaffold must ship. */
+    productCues?: string[];
+}
+interface FamilyProposal {
+    id: string;
+    proposalDir: string;
+    manifest: unknown;
+    frameworkManifest: unknown;
+    templateFiles: Array<{
+        path: string;
+        body: string;
+    }>;
+    peerFamilies: string[];
+    mode: 'llm' | 'deterministic';
+    reasoning: string;
+}
+export declare function proposeFamily(input: ProposeFamilyInput): Promise<FamilyProposal>;
+export interface ProposeWithRLMOptions {
+    maxShots?: number;
+}
+export declare function proposeFamilyWithRLM(input: ProposeFamilyInput, opts?: ProposeWithRLMOptions): Promise<FamilyProposal | null>;
+/**
+ * Same disk-write semantics as proposeFamily, but drives the RLM loop.
+ * Writes .meta.json with shot telemetry for debuggability.
+ */
+export declare function proposeFamilyWithRLMToDisk(input: ProposeFamilyInput, opts?: ProposeWithRLMOptions): Promise<FamilyProposal>;
+export {};