@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/dist/lib/version-history.js

@@ -0,0 +1,40 @@
+// version-history — reads .evolve/rollbacks.jsonl, exposes queries consumers
+// use to avoid pinning rolled-back versions.
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+const ROLLBACK_LOG = join(REPO, '.evolve/rollbacks.jsonl');
+function readRollbacks() {
+    if (!existsSync(ROLLBACK_LOG))
+        return [];
+    return readFileSync(ROLLBACK_LOG, 'utf8')
+        .split('\n')
+        .filter((l) => l.trim().length > 0)
+        .map((l) => {
+        try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((r) => r !== null && !r.dryRun);
+}
+/** Version that was rolled back AWAY from — consumers should avoid pinning this. */
+export function isVersionRolledBack(version) {
+    return readRollbacks().some((r) => r.fromVersion === version);
+}
+/** Returns the latest version we've seen a successful rollback to (or null). */
+export function getLastKnownGoodVersion() {
+    const rollbacks = readRollbacks();
+    if (rollbacks.length === 0)
+        return null;
+    // `toTag` is the version rolled to; strip the leading "v" if present.
+    const last = rollbacks[rollbacks.length - 1];
+    return last.toTag.replace(/^v/, '');
+}
+export function listRollbacks() {
+    return readRollbacks();
+}
+//# sourceMappingURL=version-history.js.map

package/dist/lib/version-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-history.js","sourceRoot":"","sources":["../../src/lib/version-history.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6CAA6C;AAE7C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AACzE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAA;AAa1D,SAAS,aAAa;IACpB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAA;IACxC,OAAO,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC;SACtC,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAmB,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAChE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAA;AAC/D,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB;IACrC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;IACjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,sEAAsE;IACtE,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC"}

package/dist/lib/visual-regression.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Visual regression primitive. Not a pixel differ — a **structural** differ
+ * over the composed scaffold.
+ *
+ * For code scaffolds, "what the agent sees first" is the filesystem shape +
+ * entrypoint contents. A regression in the composed scaffold is a byte-level
+ * change to any file inside a family's composed output.
+ *
+ * snapshot() walks a composed output directory and records, per file:
+ *   - relative path
+ *   - byte size
+ *   - SHA-256 of the bytes
+ *
+ * diff() compares two snapshots. The result is three buckets:
+ *   - added: files only in B
+ *   - removed: files only in A
+ *   - changed: files with different hashes
+ *
+ * Used by the visual golden set pipeline: we snapshot the top 20 family
+ * compositions once, commit them as golden state, and re-snapshot on every
+ * PR. A diff that isn't explicitly allowed fails CI.
+ */
+export interface VisualFileEntry {
+    /** Forward-slash relative path from the snapshot root. */
+    path: string;
+    /** Byte size. */
+    bytes: number;
+    /** SHA-256 hex digest of the file bytes. */
+    sha256: string;
+}
+export interface VisualSnapshot {
+    schemaVersion: 1;
+    /** Identifier for the subject (e.g. "nextjs-ts" or "composed:nextjs-ts+auth:clerk"). */
+    subject: string;
+    /** ISO 8601 timestamp. */
+    generatedAt: string;
+    /** Files in the snapshot, sorted by path for stable JSON output. */
+    files: VisualFileEntry[];
+}
+export interface VisualDiff {
+    /** Paths present in `after` but not `before`. */
+    added: string[];
+    /** Paths present in `before` but not `after`. */
+    removed: string[];
+    /**
+     * Paths present in both but with different sha256.
+     * Each entry records the before/after hashes for debugging.
+     */
+    changed: Array<{
+        path: string;
+        beforeSha256: string;
+        afterSha256: string;
+        beforeBytes: number;
+        afterBytes: number;
+    }>;
+}
+interface SnapshotOptions {
+    /** Additional globs to ignore beyond the defaults. */
+    ignore?: string[];
+}
+/**
+ * Walk `rootDir` recursively and produce a deterministic snapshot.
+ * `subject` is an opaque label recorded in the snapshot (typically a
+ * family id or composed-spec signature).
+ */
+export declare function snapshot(rootDir: string, subject: string, options?: SnapshotOptions): Promise<VisualSnapshot>;
+/**
+ * Compare two snapshots. Returns the three buckets of change.
+ * A snapshot with identical files (same paths, same hashes) produces
+ * empty arrays.
+ */
+export declare function diff(before: VisualSnapshot, after: VisualSnapshot): VisualDiff;
+/** True when the diff has no meaningful changes. */
+export declare function isClean(d: VisualDiff): boolean;
+export {};

package/dist/lib/visual-regression.js

@@ -0,0 +1,125 @@
+/**
+ * Visual regression primitive. Not a pixel differ — a **structural** differ
+ * over the composed scaffold.
+ *
+ * For code scaffolds, "what the agent sees first" is the filesystem shape +
+ * entrypoint contents. A regression in the composed scaffold is a byte-level
+ * change to any file inside a family's composed output.
+ *
+ * snapshot() walks a composed output directory and records, per file:
+ *   - relative path
+ *   - byte size
+ *   - SHA-256 of the bytes
+ *
+ * diff() compares two snapshots. The result is three buckets:
+ *   - added: files only in B
+ *   - removed: files only in A
+ *   - changed: files with different hashes
+ *
+ * Used by the visual golden set pipeline: we snapshot the top 20 family
+ * compositions once, commit them as golden state, and re-snapshot on every
+ * PR. A diff that isn't explicitly allowed fails CI.
+ */
+import { createHash } from 'node:crypto';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, sep } from 'node:path';
+const DEFAULT_IGNORES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    'out',
+    '.cache',
+    '.turbo',
+    'coverage',
+    '.DS_Store',
+];
+function shouldIgnore(relPath, extraIgnores) {
+    const segments = relPath.split('/');
+    const all = new Set([...DEFAULT_IGNORES, ...extraIgnores]);
+    return segments.some((s) => all.has(s));
+}
+async function sha256OfFile(abs) {
+    const buf = await readFile(abs);
+    const sha = createHash('sha256').update(buf).digest('hex');
+    return { sha, bytes: buf.length };
+}
+async function walk(root, rel, ignore, out) {
+    const abs = rel ? join(root, rel) : root;
+    const entries = await readdir(abs, { withFileTypes: true });
+    for (const e of entries) {
+        const entryRel = rel ? `${rel}/${e.name}` : e.name;
+        if (shouldIgnore(entryRel, ignore))
+            continue;
+        const entryAbs = join(abs, e.name);
+        if (e.isDirectory()) {
+            await walk(root, entryRel, ignore, out);
+        }
+        else if (e.isFile()) {
+            const { sha, bytes } = await sha256OfFile(entryAbs);
+            out.push({ path: entryRel, bytes, sha256: sha });
+        }
+    }
+}
+/**
+ * Walk `rootDir` recursively and produce a deterministic snapshot.
+ * `subject` is an opaque label recorded in the snapshot (typically a
+ * family id or composed-spec signature).
+ */
+export async function snapshot(rootDir, subject, options = {}) {
+    const s = await stat(rootDir);
+    if (!s.isDirectory())
+        throw new Error(`snapshot: not a directory: ${rootDir}`);
+    const files = [];
+    await walk(rootDir, '', options.ignore ?? [], files);
+    // Normalize separators (windows) to forward slash for cross-platform diffs.
+    for (const f of files)
+        f.path = f.path.split(sep).join('/');
+    files.sort((a, b) => a.path.localeCompare(b.path));
+    return {
+        schemaVersion: 1,
+        subject,
+        generatedAt: new Date().toISOString(),
+        files,
+    };
+}
+/**
+ * Compare two snapshots. Returns the three buckets of change.
+ * A snapshot with identical files (same paths, same hashes) produces
+ * empty arrays.
+ */
+export function diff(before, after) {
+    const beforeMap = new Map(before.files.map((f) => [f.path, f]));
+    const afterMap = new Map(after.files.map((f) => [f.path, f]));
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [p, f] of afterMap) {
+        const b = beforeMap.get(p);
+        if (!b)
+            added.push(p);
+        else if (b.sha256 !== f.sha256) {
+            changed.push({
+                path: p,
+                beforeSha256: b.sha256,
+                afterSha256: f.sha256,
+                beforeBytes: b.bytes,
+                afterBytes: f.bytes,
+            });
+        }
+    }
+    for (const p of beforeMap.keys()) {
+        if (!afterMap.has(p))
+            removed.push(p);
+    }
+    added.sort();
+    removed.sort();
+    changed.sort((a, b) => a.path.localeCompare(b.path));
+    return { added, removed, changed };
+}
+/** True when the diff has no meaningful changes. */
+export function isClean(d) {
+    return d.added.length === 0 && d.removed.length === 0 && d.changed.length === 0;
+}
+//# sourceMappingURL=visual-regression.js.map

package/dist/lib/visual-regression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-regression.js","sourceRoot":"","sources":["../../src/lib/visual-regression.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,26 @@
+export interface ProposeCapabilityInput {
+    id: string;
+    description: string;
+    /** Family ids this capability slots into. Must reference existing families. */
+    appliesTo: string[];
+    /** Files the capability provides. Kept small — real capabilities ship 1-4 files. */
+    slotFiles?: string[];
+    productCues?: string[];
+}
+export interface CapabilityProposal {
+    id: string;
+    proposalDir: string;
+    manifest: Record<string, unknown>;
+    templateFiles: Array<{
+        path: string;
+        body: string;
+    }>;
+    peerCapabilities: string[];
+    mode: 'llm' | 'llm-rlm' | 'deterministic';
+    reasoning: string;
+}
+export interface ProposeCapabilityOptions {
+    maxShots?: number;
+}
+export declare function proposeCapabilityWithRLM(input: ProposeCapabilityInput, opts?: ProposeCapabilityOptions): Promise<CapabilityProposal | null>;
+export declare function proposeCapabilityWithRLMToDisk(input: ProposeCapabilityInput, opts?: ProposeCapabilityOptions): Promise<CapabilityProposal>;

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":"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"}

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 {};