@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/dist/lib/validate-plan.js

@@ -0,0 +1,74 @@
+// Pre-compose validation for a ComposeSpec or WorkspaceSpec.
+// Downstream consumers (blueprint-agent, VB, any bench) can call this to
+// ensure a plan will compose cleanly without actually writing files.
+//
+// Checks:
+//   - family exists in the loaded registry
+//   - every referenced layer exists
+//   - each layer's appliesTo includes the family
+//   - partner (if present) exists and is compatible with the family
+//   - every slot selection is in the family's slot options
+//
+// Does NOT check: file-render outcomes, validation-check command success.
+// Those require the compose step to actually run.
+import { loadRegistry } from './registry.js';
+export async function validatePlan(spec) {
+    const registry = await loadRegistry();
+    const issues = [];
+    const check = (s, path) => {
+        const family = registry.families.get(s.family);
+        if (!family) {
+            issues.push({ path: `${path}.family`, message: `unknown family "${s.family}"` });
+            return;
+        }
+        for (const layerRef of s.layers ?? []) {
+            const layer = registry.layers.get(layerRef);
+            if (!layer) {
+                issues.push({ path: `${path}.layers`, message: `unknown layer "${layerRef}"` });
+                continue;
+            }
+            if (Array.isArray(layer.appliesTo) && !layer.appliesTo.includes(s.family)) {
+                issues.push({
+                    path: `${path}.layers`,
+                    message: `layer "${layerRef}" does not apply to family "${s.family}" (appliesTo: ${layer.appliesTo.join(', ')})`,
+                });
+            }
+        }
+        if (s.partner) {
+            const partner = registry.partners.get(s.partner);
+            if (!partner) {
+                issues.push({ path: `${path}.partner`, message: `unknown partner "${s.partner}"` });
+            }
+            else if (Array.isArray(partner.appliesTo) && !partner.appliesTo.includes(s.family)) {
+                issues.push({
+                    path: `${path}.partner`,
+                    message: `partner "${s.partner}" does not apply to family "${s.family}" (appliesTo: ${partner.appliesTo.join(', ')})`,
+                });
+            }
+        }
+        for (const [slotName, selection] of Object.entries(s.slots ?? {})) {
+            const slotConfig = family.slots?.[slotName];
+            if (!slotConfig) {
+                issues.push({ path: `${path}.slots.${slotName}`, message: `family "${s.family}" has no slot "${slotName}"` });
+                continue;
+            }
+            if (Array.isArray(slotConfig.options) && !slotConfig.options.includes(selection)) {
+                issues.push({
+                    path: `${path}.slots.${slotName}`,
+                    message: `slot "${slotName}" selection "${selection}" not in options (${slotConfig.options.join(', ')})`,
+                });
+            }
+        }
+    };
+    if ('projects' in spec) {
+        for (let i = 0; i < spec.projects.length; i++) {
+            const project = spec.projects[i];
+            check(project.spec, `projects[${i}]`);
+        }
+    }
+    else {
+        check(spec, 'spec');
+    }
+    return { ok: issues.length === 0, issues };
+}
+//# sourceMappingURL=validate-plan.js.map

package/dist/lib/validate-plan.js.map

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

package/dist/lib/vb-outcomes.d.ts

@@ -37,7 +37,7 @@ export interface VBExecutionTrace {
     };
 }
 /** Aggregate stats per scenarioId — the training-relevant projection. */
-export interface ScenarioOutcome {
+interface ScenarioOutcome {
     scenarioId: string;
     partner: string;
     runs: number;
@@ -59,3 +59,4 @@ export declare function failingLayerHistogram(traces: VBExecutionTrace[]): Recor
 export declare function brokenScenarios(outcomes: ScenarioOutcome[]): ScenarioOutcome[];
 /** Scenarios consistently reaching satisfied — high-confidence positives. */
 export declare function strongScenarios(outcomes: ScenarioOutcome[]): ScenarioOutcome[];
+export {};

package/dist/lib/version-history.d.ts

@@ -0,0 +1,15 @@
+export interface RollbackRecord {
+    schemaVersion: 1;
+    loggedAt: string;
+    fromVersion: string;
+    toTag: string;
+    newVersion: string;
+    reason: string;
+    dryRun?: boolean;
+    actor?: string;
+}
+/** Version that was rolled back AWAY from — consumers should avoid pinning this. */
+export declare function isVersionRolledBack(version: string): boolean;
+/** Returns the latest version we've seen a successful rollback to (or null). */
+export declare function getLastKnownGoodVersion(): string | null;
+export declare function listRollbacks(): RollbackRecord[];

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