@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/dist/training/template_v1/correctness.js

@@ -0,0 +1,194 @@
+// correctness.ts — cheap static checks that run as part of audit() on a
+// candidate template before we accept it.
+//
+// Two bugs the pipeline shipped in 2026-04-21 motivated this file:
+//   1. An App.tsx candidate scored 0.56 and passed audit while carrying
+//      `import { useState } from 'react'` that was never referenced.
+//      `tsc --noEmit` doesn't flag unused imports without
+//      `noUnusedLocals: true` — and none of the 50 family tsconfigs
+//      enable it. The unused import is a quality smell AND would fail
+//      consumer projects that do turn on strict mode.
+//   2. An index.html candidate scored 0.70 and passed audit with
+//      `<div id="root">` + `<script src="/src/main.tsx">` — but the
+//      react-vite-ts scaffold uses `<div id="app">` and `main.ts`.
+//      Audit's typecheck doesn't parse HTML and doesn't cross-reference
+//      script-src against existing files; the composed project would
+//      ship a blank screen at runtime.
+//
+// Both checks are fast, deterministic, and run on the composed
+// directory after compose + install + typecheck succeed. Either check
+// failing turns audit.ok=false with stage='correctness'.
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { extname, join, relative } from 'node:path';
+/**
+ * Check a single candidate TS/TSX source string for unused imports.
+ * Parses top-of-file `import ... from '...'` statements and verifies
+ * every bound name appears elsewhere in the file body.
+ */
+export function findUnusedImports(source, file) {
+    const failures = [];
+    // Only scan the import block — everything before the first non-import,
+    // non-comment, non-blank line. Keeps the scan O(imports), not O(file).
+    const lines = source.split('\n');
+    const importLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const l = lines[i];
+        const t = l.trim();
+        if (t === '' || t.startsWith('//') || t.startsWith('/*') || t.startsWith('*'))
+            continue;
+        if (t.startsWith('import ') || t.startsWith('import{')) {
+            importLines.push({ line: l, lineNo: i + 1 });
+            // multi-line import: keep accumulating until we see the closing `from '...'` or `;`
+            while (i + 1 < lines.length && !/ from ['"]/.test(importLines[importLines.length - 1].line) && !importLines[importLines.length - 1].line.trim().endsWith(';')) {
+                i++;
+                importLines[importLines.length - 1].line += '\n' + lines[i];
+            }
+            continue;
+        }
+        // First non-import, non-comment line — import block ended.
+        break;
+    }
+    // Body = source minus the imports we just collected. Strip line comments
+    // and block comments so commented-out usages don't count as real uses.
+    const bodyStart = importLines.length > 0
+        ? importLines[importLines.length - 1].lineNo
+        : 0;
+    const body = lines
+        .slice(bodyStart)
+        .join('\n')
+        .replace(/\/\/[^\n]*/g, '')
+        .replace(/\/\*[\s\S]*?\*\//g, '');
+    for (const { line } of importLines) {
+        // Extract bound names from the import. Handles:
+        //   import X from '...'
+        //   import { A, B as C } from '...'
+        //   import * as NS from '...'
+        //   import X, { A } from '...'
+        //   import '...'  (side-effect; nothing to check)
+        const names = [];
+        const defaultMatch = line.match(/^\s*import\s+([A-Za-z_$][\w$]*)\s*(?:,|from)/);
+        if (defaultMatch)
+            names.push(defaultMatch[1]);
+        const nsMatch = line.match(/\*\s+as\s+([A-Za-z_$][\w$]*)/);
+        if (nsMatch)
+            names.push(nsMatch[1]);
+        const namedBlock = line.match(/\{([^}]+)\}/);
+        if (namedBlock) {
+            for (const piece of namedBlock[1].split(',')) {
+                const renamed = piece.trim().match(/(?:[A-Za-z_$][\w$]*\s+as\s+)?([A-Za-z_$][\w$]*)\s*$/);
+                if (renamed)
+                    names.push(renamed[1]);
+            }
+        }
+        // Type-only imports can be unused at value level but still affect
+        // d.ts — TypeScript handles those; skip `import type`.
+        if (/^\s*import\s+type\b/.test(line))
+            continue;
+        for (const name of names) {
+            // Whole-word match on the name in the body.
+            const re = new RegExp(`\\b${name.replace(/[$]/g, '\\$')}\\b`);
+            if (!re.test(body)) {
+                failures.push({
+                    kind: 'unused-import',
+                    file,
+                    detail: `\`${name}\` is imported but never referenced`,
+                });
+            }
+        }
+    }
+    return failures;
+}
+/**
+ * Walk a composed scaffold directory and check HTML/TS wire-up:
+ *   - every <script type="module" src="/X"> must resolve to an existing
+ *     file in the composed tree (src/X or X from root)
+ *   - every document.getElementById('ID') in the entry TS must match
+ *     some <div id="ID"> (or any element with that id) in some HTML
+ *   - every <div id="ID"> with a matching getElementById in the entry
+ *     is considered consistent; the check is one-directional (missing
+ *     TS counterpart isn't a bug — HTML may add extra mount points)
+ *
+ * Keeps the scan shallow: only HTML/TS at the project root + src/.
+ */
+export function checkHtmlTsWireup(composedDir) {
+    const failures = [];
+    const htmlFiles = shallowFindFiles(composedDir, ['.html']);
+    if (htmlFiles.length === 0)
+        return failures; // no HTML, no wire-up
+    // Aggregate all ids across every HTML file — a TS lookup of 'root'
+    // is consistent if ANY HTML has <div id="root">.
+    const allIds = new Set();
+    for (const html of htmlFiles) {
+        const body = readFileSync(html, 'utf8');
+        for (const m of body.matchAll(/\bid\s*=\s*["']([^"']+)["']/g)) {
+            allIds.add(m[1]);
+        }
+        // Each <script type="module" src="..."> must resolve.
+        for (const m of body.matchAll(/<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/g)) {
+            const src = m[1];
+            if (/^https?:\/\//.test(src))
+                continue; // external
+            // Strip leading slash; resolve relative to composedDir.
+            const rel = src.replace(/^\//, '');
+            const path = join(composedDir, rel);
+            if (!existsSync(path)) {
+                failures.push({
+                    kind: 'missing-script-src',
+                    file: relative(composedDir, html),
+                    detail: `script src="${src}" does not exist in composed project`,
+                });
+            }
+        }
+    }
+    // Scan entry TS/TSX files for getElementById calls; each must match
+    // an id found in some HTML. Skip if no entries exist (non-web family).
+    const entryFiles = shallowFindFiles(composedDir, ['.ts', '.tsx', '.js', '.jsx'])
+        .filter((p) => /\/(main|index|App)\.(ts|tsx|js|jsx)$/.test(p));
+    for (const entry of entryFiles) {
+        const src = readFileSync(entry, 'utf8');
+        for (const m of src.matchAll(/document\s*\.\s*getElementById\s*\(\s*["']([^"']+)["']\s*\)/g)) {
+            const id = m[1];
+            if (!allIds.has(id)) {
+                failures.push({
+                    kind: 'missing-element-id',
+                    file: relative(composedDir, entry),
+                    detail: `document.getElementById('${id}') has no matching id="${id}" in any HTML file`,
+                });
+            }
+        }
+    }
+    return failures;
+}
+function shallowFindFiles(dir, extensions) {
+    const hits = [];
+    const walk = (d, depth) => {
+        if (depth > 4)
+            return;
+        let entries = [];
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (name === 'node_modules' || name === '.starter-foundry' || name === '.git')
+                continue;
+            const full = join(d, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                walk(full, depth + 1);
+            else if (extensions.includes(extname(name)))
+                hits.push(full);
+        }
+    };
+    walk(dir, 0);
+    return hits;
+}
+//# sourceMappingURL=correctness.js.map

package/dist/training/template_v1/correctness.js.map

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

package/dist/training/template_v1/harvest.d.ts

@@ -0,0 +1,25 @@
+export interface HarvestSummary {
+    templatePath: string;
+    tupleCount: number;
+    writeCount: number;
+    editCount: number;
+    /** Lines that appear in many agents' "new" outputs but NOT in the current template. */
+    frequentlyAddedLines: Array<{
+        line: string;
+        frequency: number;
+    }>;
+    /** Imports + dependency tokens agents consistently add. */
+    frequentImports: Array<{
+        token: string;
+        frequency: number;
+    }>;
+    /** Sample "after" bodies for reference. */
+    samplesAfter: string[];
+    /** Sample "before → after" diffs for Edit calls. */
+    editPatterns: Array<{
+        before: string;
+        after: string;
+        count: number;
+    }>;
+}
+export declare function harvest(templateKey: string): HarvestSummary;

package/dist/training/template_v1/harvest.js

@@ -0,0 +1,101 @@
+// harvest.ts — turn mined template-rewrite tuples into structured patterns.
+// Input: .evolve/template-rewrites/<key>.jsonl files
+// Output: HarvestSummary { templatePath, tuples, addedLines, removedLines,
+//         commonStructuralEdits, sampleBefore, sampleAfter }
+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 REWRITES_DIR = join(REPO, '.evolve/template-rewrites');
+function readTuples(key) {
+    // Key is e.g. "src.App.tsx" — the filesystem-safe form of the template path.
+    const candidate = join(REWRITES_DIR, `${key}.jsonl`);
+    if (!existsSync(candidate))
+        return [];
+    return readFileSync(candidate, 'utf8')
+        .split('\n')
+        .filter((l) => l.length > 0)
+        .map((l) => JSON.parse(l));
+}
+function tokenize(source) {
+    // Very small tokenizer — split on whitespace + punct, filter short.
+    return source
+        .split(/[^a-zA-Z0-9@/._-]+/)
+        .filter((t) => t.length >= 3);
+}
+function lineFrequency(bodies) {
+    const freq = new Map();
+    for (const body of bodies) {
+        const seenInBody = new Set();
+        for (const raw of body.split('\n')) {
+            const line = raw.trim();
+            if (line.length < 8 || line.length > 160)
+                continue;
+            if (seenInBody.has(line))
+                continue;
+            seenInBody.add(line);
+            freq.set(line, (freq.get(line) ?? 0) + 1);
+        }
+    }
+    return freq;
+}
+function importFrequency(bodies) {
+    const freq = new Map();
+    const importRe = /(?:import|from)\s+['"]([^'"]+)['"]/g;
+    for (const body of bodies) {
+        const seen = new Set();
+        let match;
+        while ((match = importRe.exec(body)) !== null) {
+            const mod = match[1];
+            if (seen.has(mod))
+                continue;
+            seen.add(mod);
+            freq.set(mod, (freq.get(mod) ?? 0) + 1);
+        }
+    }
+    return freq;
+}
+function editPatterns(tuples) {
+    const buckets = new Map();
+    for (const t of tuples) {
+        if (t.tool !== 'Edit' || !t.old)
+            continue;
+        // Bucket on a short signature — first 80 chars of the before.
+        const sig = `${t.old.slice(0, 80)}→${t.new.slice(0, 80)}`;
+        const existing = buckets.get(sig);
+        if (existing)
+            existing.count++;
+        else
+            buckets.set(sig, { before: t.old.slice(0, 240), after: t.new.slice(0, 240), count: 1 });
+    }
+    return [...buckets.values()].sort((a, b) => b.count - a.count).slice(0, 10);
+}
+export function harvest(templateKey) {
+    const tuples = readTuples(templateKey);
+    const writes = tuples.filter((t) => t.tool === 'Write');
+    const edits = tuples.filter((t) => t.tool === 'Edit');
+    const newBodies = tuples.map((t) => t.new);
+    const linefreq = lineFrequency(newBodies);
+    const frequentlyAddedLines = [...linefreq.entries()]
+        .filter(([, n]) => n >= Math.max(3, Math.floor(tuples.length * 0.2)))
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 30)
+        .map(([line, frequency]) => ({ line, frequency }));
+    const impfreq = importFrequency(newBodies);
+    const frequentImports = [...impfreq.entries()]
+        .filter(([, n]) => n >= Math.max(2, Math.floor(tuples.length * 0.1)))
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 20)
+        .map(([token, frequency]) => ({ token, frequency }));
+    return {
+        templatePath: tuples[0]?.templatePath ?? templateKey,
+        tupleCount: tuples.length,
+        writeCount: writes.length,
+        editCount: edits.length,
+        frequentlyAddedLines,
+        frequentImports,
+        samplesAfter: writes.slice(0, 3).map((t) => t.new.slice(0, 1200)),
+        editPatterns: editPatterns(edits),
+    };
+}
+//# sourceMappingURL=harvest.js.map

package/dist/training/template_v1/harvest.js.map

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

package/dist/training/template_v1/judge.d.ts

@@ -0,0 +1,26 @@
+import type { HarvestSummary } from './harvest.js';
+interface JudgeInput {
+    templatePath: string;
+    currentSource: string;
+    candidate: string;
+    harvest: HarvestSummary;
+    /** Optional. When present, the judge reads family-pass-rate-trend.jsonl and
+     * adjusts the score by the 2-week trend slope for this family (Branch 2.4).
+     * Generated by scripts/family-pass-rate-trend.mjs. */
+    familyId?: string;
+}
+export interface JudgeResult {
+    /** Total composite score. */
+    score: number;
+    /** Sub-scores by dimension, each [0, 1]. */
+    dimensions: Record<string, number>;
+    reasoning: string;
+    /** Does the candidate contain lines agents routinely REMOVE from the current? */
+    removesFrequentlyDeletedLines: number;
+    /** Does the candidate incorporate lines agents routinely ADD? */
+    incorporatesFrequentlyAddedLines: number;
+    /** Raw size change. Negative when candidate is shorter (usually better). */
+    sizeDelta: number;
+}
+export declare function judge(input: JudgeInput): JudgeResult;
+export {};

package/dist/training/template_v1/judge.js

@@ -0,0 +1,104 @@
+// judge.ts — score a synthesized candidate template against the current
+// one. Deterministic metrics + optional LLM-as-judge for qualitative
+// differences. Scores are numeric [0, 1] where higher = better candidate.
+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 TREND_PATH = join(REPO, '.evolve/traces/family-pass-rate-trend.jsonl');
+function countOverlap(source, needles) {
+    let hits = 0;
+    for (const needle of needles) {
+        if (source.includes(needle))
+            hits++;
+    }
+    return needles.length === 0 ? 0 : hits / needles.length;
+}
+function loadRecentTrend(familyId) {
+    if (!existsSync(TREND_PATH))
+        return null;
+    try {
+        const rows = readFileSync(TREND_PATH, 'utf8')
+            .split('\n')
+            .filter((l) => l.trim().length > 0)
+            .map((l) => JSON.parse(l))
+            .filter((r) => r.family === familyId)
+            .sort((a, b) => a.isoWeek.localeCompare(b.isoWeek));
+        if (rows.length < 2) {
+            return rows.length === 1 ? { slope: 0, latestRate: rows[0].passRate, weeks: 1 } : null;
+        }
+        // Simple two-point slope across the two most recent weeks.
+        const tail = rows.slice(-2);
+        const slope = (tail[1].passRate - tail[0].passRate);
+        return { slope, latestRate: tail[1].passRate, weeks: rows.length };
+    }
+    catch {
+        return null;
+    }
+}
+export function judge(input) {
+    const addedLines = input.harvest.frequentlyAddedLines.map((e) => e.line);
+    // Score 1: does the candidate INCLUDE the lines agents keep adding?
+    const incorporatesFrequentlyAddedLines = countOverlap(input.candidate, addedLines);
+    const currentIncorporates = countOverlap(input.currentSource, addedLines);
+    const addLift = incorporatesFrequentlyAddedLines - currentIncorporates;
+    // Score 2: does the candidate REMOVE the lines agents keep deleting?
+    // Proxy: find lines in the current that DON'T appear in any agent rewrite.
+    const agentBodies = input.harvest.samplesAfter.join('\n\n');
+    const currentLines = input.currentSource.split('\n').map((l) => l.trim()).filter((l) => l.length >= 8);
+    let removedByAgents = 0;
+    let removedInCandidate = 0;
+    for (const line of currentLines) {
+        const inAgents = agentBodies.includes(line);
+        if (inAgents)
+            continue;
+        removedByAgents++;
+        if (!input.candidate.includes(line))
+            removedInCandidate++;
+    }
+    const removesFrequentlyDeletedLines = removedByAgents === 0 ? 0 : removedInCandidate / removedByAgents;
+    // Score 3: size delta. Slightly prefer smaller (agents tend to trim).
+    const sizeDelta = input.candidate.length - input.currentSource.length;
+    const sizeScore = sizeDelta < 0 ? 1 : Math.max(0, 1 - (sizeDelta / Math.max(1, input.currentSource.length)));
+    // Score 4 (optional): downstream VB pass-rate trend for the family. When
+    // positive slope, the current direction is working — lean toward keeping
+    // current shape (smaller candidate delta rewarded). When negative slope,
+    // reward structural candidate changes more (addLift weight bumped).
+    // See scripts/family-pass-rate-trend.mjs for the data source.
+    let vbTrendSignal = 0.5;
+    const reasoningLines = [];
+    if (input.familyId) {
+        const trend = loadRecentTrend(input.familyId);
+        if (trend) {
+            // slope ∈ [-1, 1] — map to [0, 1] centered on 0.5.
+            vbTrendSignal = Math.max(0, Math.min(1, 0.5 + trend.slope));
+            reasoningLines.push(`vbPassRateTrend[${input.familyId}]: latest=${trend.latestRate.toFixed(2)} slope=${trend.slope >= 0 ? '+' : ''}${trend.slope.toFixed(2)} (weeks=${trend.weeks})`);
+        }
+    }
+    // Composite: weighted average. vbTrend weight is small (5%) so it nudges
+    // without dominating the deterministic rewrite signal.
+    const composite = 0.45 * Math.max(0, addLift + 0.5) +
+        0.3 * removesFrequentlyDeletedLines +
+        0.2 * sizeScore +
+        0.05 * vbTrendSignal;
+    const reasoning = [
+        `incorporatesFrequentlyAddedLines: ${incorporatesFrequentlyAddedLines.toFixed(2)} (current: ${currentIncorporates.toFixed(2)}, lift: ${addLift.toFixed(2)})`,
+        `removesFrequentlyDeletedLines: ${removesFrequentlyDeletedLines.toFixed(2)} (${removedInCandidate}/${removedByAgents})`,
+        `sizeDelta: ${sizeDelta} chars (score ${sizeScore.toFixed(2)})`,
+        ...reasoningLines,
+    ].join('\n');
+    return {
+        score: Math.max(0, Math.min(1, composite)),
+        dimensions: {
+            addLift: Math.max(0, addLift + 0.5),
+            removeMatch: removesFrequentlyDeletedLines,
+            sizeScore,
+            vbTrend: vbTrendSignal,
+        },
+        reasoning,
+        removesFrequentlyDeletedLines,
+        incorporatesFrequentlyAddedLines,
+        sizeDelta,
+    };
+}
+//# sourceMappingURL=judge.js.map

package/dist/training/template_v1/judge.js.map

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

package/dist/training/template_v1/multi-propose.d.ts

@@ -0,0 +1,27 @@
+import type { HarvestSummary } from './harvest.js';
+import { type SynthesizeResult } from './synthesize.js';
+import { type JudgeResult } from './judge.js';
+interface MultiProposeInput {
+    templatePath: string;
+    currentSource: string;
+    harvest: HarvestSummary;
+    familyId: string;
+    /** Default 3. Increase for hard cases; decrease for fast dry-runs. */
+    proposerCount?: number;
+    /** Score spread below which we emit a tie-break flag. Default 0.05. */
+    tieThreshold?: number;
+}
+export interface MultiProposeResult {
+    winner: {
+        candidate: SynthesizeResult;
+        score: JudgeResult;
+    };
+    runnerUps: Array<{
+        candidate: SynthesizeResult;
+        score: JudgeResult;
+    }>;
+    needsHumanTieBreak: boolean;
+    proposerCount: number;
+}
+export declare function multiPropose(input: MultiProposeInput): Promise<MultiProposeResult>;
+export {};

package/dist/training/template_v1/multi-propose.js

@@ -0,0 +1,34 @@
+// Multi-proposer synthesis — generate N candidates (mix of LLM prompts +
+// deterministic) in parallel, judge each, pick the winner. If scores are
+// too close, flag for human review.
+import { synthesize } from './synthesize.js';
+import { judge } from './judge.js';
+export async function multiPropose(input) {
+    const count = input.proposerCount ?? 3;
+    const proposals = await Promise.all(Array.from({ length: count }, () => synthesize({
+        templatePath: input.templatePath,
+        currentSource: input.currentSource,
+        harvest: input.harvest,
+        familyId: input.familyId,
+    })));
+    const judged = proposals.map((candidate) => ({
+        candidate,
+        score: judge({
+            templatePath: input.templatePath,
+            currentSource: input.currentSource,
+            candidate: candidate.candidate,
+            harvest: input.harvest,
+        }),
+    }));
+    judged.sort((a, b) => b.score.score - a.score.score);
+    const winner = judged[0];
+    const runnerUps = judged.slice(1);
+    const tie = runnerUps[0] && Math.abs(winner.score.score - runnerUps[0].score.score) < (input.tieThreshold ?? 0.05);
+    return {
+        winner,
+        runnerUps,
+        needsHumanTieBreak: !!tie,
+        proposerCount: count,
+    };
+}
+//# sourceMappingURL=multi-propose.js.map

package/dist/training/template_v1/multi-propose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-propose.js","sourceRoot":"","sources":["../../../src/training/template_v1/multi-propose.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AACzE,oCAAoC;AAGpC,OAAO,EAAE,UAAU,EAAyB,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAA;AAoBpD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAA;IACtC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CACjC,UAAU,CAAC;QACT,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CACH,CACF,CAAA;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3C,SAAS;QACT,KAAK,EAAE,KAAK,CAAC;YACX,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;KACH,CAAC,CAAC,CAAA;IAEH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;IACzB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAA;IAElH,OAAO;QACL,MAAM;QACN,SAAS;QACT,kBAAkB,EAAE,CAAC,CAAC,GAAG;QACzB,aAAa,EAAE,KAAK;KACrB,CAAA;AACH,CAAC"}

package/dist/training/template_v1/run.d.ts

@@ -0,0 +1 @@
+export {};