@tangle-network/starter-foundry 0.5.4 → 0.7.0

package/dist/eval/scaffold-bridge.js

@@ -0,0 +1,492 @@
+// Scaffold-bridge — adapts starter-foundry's compose surface to
+// agent-eval's BuilderSession + SandboxHarness. Given a spec (family +
+// layers + variables), this module:
+//
+//   1. composes the scaffold to a tempdir
+//   2. returns a HarnessConfig tuned for the family's build toolchain
+//      (pnpm / cargo / go / aptos / node — dispatch on taxonomy.language)
+//   3. registers family-aware judges that grade meta_score against the
+//      composed output (manifest compliance, idiomatic layout, deps
+//      resolved)
+//
+// The glue is deliberately thin. Every primitive (sandbox driver, judge
+// factory, workspace assertions) comes from agent-eval. Nothing new here
+// lives in starter-foundry except the composition adapter + family
+// dispatch table.
+import { readFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileExists } from '@tangle-network/agent-eval';
+// ──────────────────────────────────────────────────────────────────
+// Per-family harness dispatch
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Build the harness config for a family based on its taxonomy.language.
+ * The resolved setup/test commands run inside the composed tempdir, so
+ * the agent-eval SandboxHarness can subprocess-invoke them.
+ *
+ * Keep this table in sync with the registry's families — when a new
+ * language surface lands (e.g. a Zig family), add a dispatch here.
+ */
+export function makeHarnessConfig(components) {
+    const language = components.family.taxonomy?.language ?? 'unknown';
+    const surface = components.family.taxonomy?.surface ?? 'unknown';
+    switch (language) {
+        case 'typescript':
+        case 'javascript':
+            // pnpm for the foundry-native JS projects. `--frozen-lockfile` off:
+            // composed scaffolds don't carry a pnpm-lock.yaml; fresh install.
+            return {
+                setupCommand: 'pnpm install --prefer-offline',
+                testCommand: surface === 'contracts'
+                    ? 'pnpm run validate || pnpm run build || true'
+                    : 'pnpm run validate || pnpm run build || true',
+                timeoutMs: 180_000,
+            };
+        case 'rust':
+            // Cargo workspace handling — `cargo check` is far cheaper than
+            // `cargo build --release` and catches the same class of errors
+            // (resolve + typecheck). Users running real builds can override.
+            return {
+                setupCommand: 'cargo fetch',
+                testCommand: 'cargo check --workspace || cargo check',
+                timeoutMs: 300_000,
+            };
+        case 'go':
+            return {
+                setupCommand: 'go mod tidy',
+                testCommand: 'go build ./... && go vet ./...',
+                timeoutMs: 180_000,
+            };
+        case 'python':
+            return {
+                // pip install -e would need a venv; most python starters ship a
+                // requirements.txt or pyproject.toml. Use a light import smoke.
+                setupCommand: '[ -f requirements.txt ] && pip install -r requirements.txt || true',
+                testCommand: 'python -m compileall -q .',
+                timeoutMs: 120_000,
+            };
+        case 'solidity':
+            return {
+                setupCommand: 'forge install --no-git || true',
+                testCommand: 'forge build',
+                timeoutMs: 180_000,
+            };
+        case 'move':
+            return {
+                setupCommand: '',
+                testCommand: 'aptos move compile --dev',
+                timeoutMs: 300_000,
+            };
+        default:
+            // Unknown language — run only the family's `validate-*` script if
+            // present. Never block the eval; return a no-op test.
+            return {
+                setupCommand: '',
+                testCommand: 'true',
+                timeoutMs: 60_000,
+            };
+    }
+}
+// ──────────────────────────────────────────────────────────────────
+// Workspace assertions — manifest.files → real files on disk
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate workspace assertions from a resolved component tree. Every
+ * file the manifest declares must exist after compose. This is the
+ * structural correctness floor — no LLM needed.
+ *
+ * Uses agent-eval's `fileExists(path)` helper which returns a
+ * WorkspaceAssertion whose `.check(snapshot)` resolves against the
+ * snapshot's `files` record at eval time.
+ */
+export function manifestComplianceAssertions(components) {
+    const assertions = [];
+    const seen = new Set();
+    const addFile = (target) => {
+        if (seen.has(target))
+            return;
+        seen.add(target);
+        assertions.push(fileExists(target));
+    };
+    for (const file of components.family.files ?? [])
+        addFile(file.target);
+    for (const layer of components.layers) {
+        for (const file of layer.files ?? [])
+            addFile(file.target);
+    }
+    return assertions;
+}
+// ──────────────────────────────────────────────────────────────────
+// Snapshot helper — reads a composed scaffold into a WorkspaceSnapshot
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Walk the composed scaffold directory, return a WorkspaceSnapshot the
+ * agent-eval `InMemoryWorkspaceInspector` + `runAssertions` understand.
+ *
+ * Content handling:
+ *   - UTF-8-valid text of any size → `files[path] = content` (full).
+ *     Assertions like `fileContains(path, needle)` work against the
+ *     complete file regardless of size. No arbitrary truncation.
+ *   - Binary / non-UTF-8 files → `blobs[path] = { size, hash, mimeType }`.
+ *     This is exactly what agent-eval's blob channel is for — keeps the
+ *     snapshot small while preserving "this file exists and is binary"
+ *     for file-exists-style assertions.
+ *
+ * Excluded: node_modules, target (cargo), .git, dist — noise that
+ * would 10× the snapshot with no value for eval.
+ */
+export function snapshotScaffold(scaffoldDir) {
+    const files = {};
+    const blobs = {};
+    const res = spawnSync('find', [scaffoldDir, '-type', 'f', '-not', '-path', '*/node_modules/*', '-not', '-path', '*/target/*', '-not', '-path', '*/.git/*', '-not', '-path', '*/dist/*'], { encoding: 'utf8' });
+    if (res.status === 0) {
+        for (const absPath of res.stdout.trim().split('\n').filter(Boolean)) {
+            const relPath = absPath.startsWith(scaffoldDir + '/') ? absPath.slice(scaffoldDir.length + 1) : absPath;
+            try {
+                const buf = readFileSync(absPath);
+                if (isProbablyText(buf)) {
+                    files[relPath] = buf.toString('utf8');
+                }
+                else {
+                    blobs[relPath] = {
+                        size: buf.length,
+                        // Don't compute hash here — it's O(size) on every eval; caller
+                        // adds it selectively when assertions need it.
+                        mimeType: guessMimeType(relPath),
+                    };
+                }
+            }
+            catch {
+                // Read error (permissions, broken symlink): record as empty text
+                // so file-exists assertions still resolve truthy while read-
+                // dependent assertions fail with an empty content mismatch.
+                files[relPath] = '';
+            }
+        }
+    }
+    return { files, rows: {}, kv: {}, blobs: Object.keys(blobs).length ? blobs : undefined };
+}
+/**
+ * Heuristic: a file is "probably text" if the first 4KB contains no
+ * NUL byte and is decodable as UTF-8 without replacement chars. This
+ * catches the common cases (source code, configs, markdown, json) and
+ * correctly diverts binaries (wasm, .zkey, images, compiled elf) to
+ * the blob channel.
+ */
+function isProbablyText(buf) {
+    const head = buf.subarray(0, Math.min(4096, buf.length));
+    if (head.includes(0))
+        return false;
+    // Attempt strict decode — if the bytes form invalid UTF-8, TextDecoder
+    // with `fatal: true` throws.
+    try {
+        new TextDecoder('utf-8', { fatal: true }).decode(head);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function guessMimeType(path) {
+    const ext = path.toLowerCase().split('.').pop() ?? '';
+    switch (ext) {
+        case 'wasm': return 'application/wasm';
+        case 'zkey': return 'application/octet-stream+zkey';
+        case 'png': return 'image/png';
+        case 'jpg':
+        case 'jpeg': return 'image/jpeg';
+        case 'webp': return 'image/webp';
+        case 'woff':
+        case 'woff2': return 'font/woff2';
+        case 'pdf': return 'application/pdf';
+        default: return undefined;
+    }
+}
+// ──────────────────────────────────────────────────────────────────
+// Judge factory — scaffold meta_score rubric
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Build a JudgeFn that grades a composed scaffold on five dimensions:
+ *   1. correctness       — imports resolve, build recipe valid
+ *   2. completeness      — all manifest-declared files present
+ *   3. idiomatic         — workspace layout matches family convention
+ *   4. production-ready  — env vars documented, secrets not in source
+ *   5. over-scaffold     — no extraneous layers attached for the prompt
+ *
+ * The judge is meant to be plugged into agent-eval's BuilderSession via
+ * `recordMetaScore(await judge(...))`. The fn itself doesn't call an LLM
+ * — it builds the prompt and expects the caller (driver script) to hand
+ * off to `createLlmReviewer`.
+ *
+ * Why this shape: agent-eval's JudgeFn takes a context object with
+ * scenario+artifacts; the scaffold eval's "scenario" IS the user prompt,
+ * and "artifacts" are the composed files. This adapter packs them up.
+ */
+export function buildScaffoldMetaPrompt(args) {
+    const { userPrompt, composedSpec, snapshot } = args;
+    const paths = Object.keys(snapshot.files).sort();
+    const fileList = paths
+        .slice(0, 80) // cap prompt length
+        .join('\n  ');
+    const keyFiles = pickKeyFiles(snapshot);
+    // Prompt-budget truncation (distinct from snapshot completeness —
+    // the snapshot has the full file; this is render-only).
+    const PROMPT_FILE_CAP = 4000;
+    const keyFilesSection = keyFiles
+        .map((f) => {
+        const truncated = f.content.length > PROMPT_FILE_CAP;
+        const body = truncated
+            ? `${f.content.slice(0, PROMPT_FILE_CAP)}\n\n[... ${f.content.length - PROMPT_FILE_CAP} more characters truncated for prompt budget — full content is in the snapshot ...]`
+            : f.content;
+        return `\n### ${f.path}${truncated ? ' (truncated for prompt)' : ''}\n\`\`\`\n${body}\n\`\`\``;
+    })
+        .join('\n');
+    return [
+        '# Scaffold quality assessment',
+        '',
+        'You are grading a composed project scaffold. The user gave a prompt and the',
+        'planner selected a family + capability layers + variables. After composition,',
+        'these files are on disk:',
+        '',
+        '## User prompt',
+        userPrompt,
+        '',
+        '## Resolved composition',
+        `- family: ${composedSpec.family}`,
+        `- layers: ${(composedSpec.layers ?? []).join(', ')}`,
+        `- partner: ${composedSpec.partner ?? '(none)'}`,
+        '',
+        '## File list',
+        '  ' + fileList,
+        ...(paths.length > 80 ? [`  ... ${paths.length - 80} more`] : []),
+        '',
+        '## Key files',
+        keyFilesSection,
+        '',
+        '## Rubric (0-1 per dimension, 1 = perfect)',
+        '',
+        '1. **correctness**    — do imports resolve? Is the build recipe plausible? Any obvious typos or broken references?',
+        '2. **completeness**   — does the scaffold cover the prompt\'s stated surfaces? (if prompt says "ZK prover + frontend", do both exist?)',
+        '3. **idiomatic**      — does the layout match the framework\'s canonical pattern? (risczero has methods/guest+host; SP1 has program/+script/)',
+        '4. **production-ready** — are env vars documented? secrets NOT in source? build caching hints present?',
+        '5. **over-scaffold**  — score 1 if ZERO layers are extraneous; lower if capabilities are attached that the prompt doesn\'t justify.',
+        '',
+        '## Output',
+        '',
+        'Return a single JSON object:',
+        '```json',
+        '{',
+        '  "correctness": 0.9,',
+        '  "completeness": 0.95,',
+        '  "idiomatic": 0.85,',
+        '  "productionReady": 0.8,',
+        '  "overScaffold": 1.0,',
+        '  "overall": 0.9,',
+        '  "issues": [{"dimension": "...", "severity": "low|medium|high", "description": "..."}],',
+        '  "verdict": "pass | fail | borderline"',
+        '}',
+        '```',
+    ].join('\n');
+}
+/**
+ * Pick the "key files" agent-eval's judge should see in full. We don't
+ * want to ship the entire scaffold into the prompt (token explosion);
+ * instead surface the files that carry the scaffold's signal.
+ */
+function pickKeyFiles(snapshot) {
+    const priorities = [
+        /^package\.json$/,
+        /^Cargo\.toml$/,
+        /^go\.mod$/,
+        /^Move\.toml$/,
+        /^foundry\.toml$/,
+        /^requirements\.txt$/,
+        /^pyproject\.toml$/,
+        /^README\.md$/,
+        /^tsconfig\.json$/,
+        /^src\/main\.(ts|rs|py|go)$/,
+        /^src\/App\.tsx$/,
+        /^src\/index\.(ts|tsx)$/,
+        /^methods\/guest\/src\/main\.rs$/,
+        /^program\/src\/main\.rs$/,
+        /^host\/src\/main\.rs$/,
+    ];
+    const paths = Object.keys(snapshot.files);
+    const out = [];
+    for (const pattern of priorities) {
+        const match = paths.find((p) => pattern.test(p));
+        if (match)
+            out.push({ path: match, content: snapshot.files[match] });
+        if (out.length >= 6)
+            break;
+    }
+    return out;
+}
+/**
+ * Compose a spec to a tempdir + package up everything the driver needs
+ * to run agent-eval's BuilderSession: sandbox config, file snapshot,
+ * structural assertions, cleanup thunk.
+ *
+ * Compose failure throws. Caller handles by scoring the build_score as
+ * 0 and proceeding with a failed-compose meta judgment.
+ */
+export async function prepareScaffoldForEval(args) {
+    const scaffoldDir = mkdtempSync(join(tmpdir(), 'scaffold-eval-'));
+    // Invoke the compose CLI. Runs against the live `dist/` so the bridge
+    // stays registry-version-agnostic; no in-process coupling to compose.
+    const specPath = join(scaffoldDir, 'spec.json');
+    const { writeFileSync } = await import('node:fs');
+    writeFileSync(specPath, JSON.stringify(args.spec));
+    const res = spawnSync('node', ['dist/cli.js', 'compose', '--spec', specPath, '--out', scaffoldDir, '--json'], {
+        cwd: process.cwd(),
+        encoding: 'utf8',
+    });
+    if (res.status !== 0) {
+        rmSync(scaffoldDir, { recursive: true, force: true });
+        throw new Error(`compose failed (exit ${res.status}): ${res.stderr.slice(-500)}`);
+    }
+    const snapshot = snapshotScaffold(scaffoldDir);
+    const harness = makeHarnessConfig(args.components);
+    const assertions = manifestComplianceAssertions(args.components);
+    return {
+        scaffoldDir,
+        harness,
+        snapshot,
+        assertions,
+        cleanup: () => {
+            try {
+                rmSync(scaffoldDir, { recursive: true, force: true });
+            }
+            catch { /* noop */ }
+        },
+    };
+}
+/**
+ * Meta judge — Ax-structured scaffold quality assessment.
+ *
+ * Uses AxSignature + AxGen so the output schema is enforced at the library
+ * layer, not via my hand-rolled regex-JSON-parse. Ax handles:
+ *   - retries on malformed output
+ *   - field-type coercion (number fields get numbers, not strings)
+ *   - structured error reporting when the LLM refuses schema compliance
+ *
+ * Routes through `createLLM` which uses router.tangle.tools when
+ * TANGLE_ROUTER_USER_KEY is set (preferred — centralized spend + governance),
+ * else falls back to direct provider keys.
+ */
+// AxSignature DSL: '"<instruction>" input1:type, ... -> output1:type, ...'
+// Each field can have a ':string' / ':number' / ':string[]' / ':boolean' type
+// annotation. Ax coerces output into the declared type and retries if the
+// model returns something uncoercible.
+const META_JUDGE_SIGNATURE = '"Grade a freshly-composed project STARTER SCAFFOLD on five rubric dimensions (0..1 each, 1=perfect). ' +
+    'CRITICAL CALIBRATION: a starter scaffold is a SKELETON the agent extends. ' +
+    'Do NOT penalize for missing business logic, missing API client implementations, or missing domain-specific code. ' +
+    'The scaffold\'s job is to give the agent a buildable floor — extension is the agent\'s job. ' +
+    'Judge ONLY what is given; do not hallucinate missing files. ' +
+    'correctness = imports resolve, build recipe plausible, no obvious taxonomy/implementation mismatches (e.g. frontend surface with Node HTTP server in main.ts). ' +
+    'completeness = scaffold has the expected slot files for its (language, runtime, surface) — e.g. frontend TS needs package.json + vite.config + index.html + entrypoint + README. Does NOT require business-logic implementation. ' +
+    'idiomatic = layout + configs + dep versions match the framework\'s current canonical pattern (e.g. vite+react with TS5, not jest+TS4). ' +
+    'productionReady = env vars documented via .env.example or README Environment section, no secrets in source, scripts are the conventional ones for the runtime. ' +
+    'overScaffold = 1 if zero extraneous dependencies or capabilities beyond what the surface justifies. ' +
+    'overall = weighted aggregate; a SKELETON-COMPLETE scaffold with no taxonomy mismatches should score ≥ 0.8 and verdict=pass. ' +
+    'verdict = pass | fail | borderline. issues = concrete defects ONLY (not missing business logic)." ' +
+    'userPrompt:string, family:string, layers:string, fileList:string, keyFiles:string -> ' +
+    'correctness:number, completeness:number, idiomatic:number, productionReady:number, overScaffold:number, ' +
+    'overall:number, verdict:string, issues:string[], rationale:string';
+export async function invokeMetaJudge(args) {
+    const { createLLM } = await import('../lib/llm.js');
+    const { ax } = await import('@ax-llm/ax');
+    // Don't pin a router-specific model slug like "anthropic/claude-sonnet-4-6" —
+    // it 404s on non-router providers in the fallback chain. createLLM() picks
+    // each provider's default (Claude Haiku on Anthropic, Llama 3.3 on Together,
+    // gpt-4o-mini on OpenAI, Haiku via router when the router key is present).
+    // Any of these are capable enough to run a 5-dimensional rubric judge.
+    const llm = createLLM();
+    const judge = ax(META_JUDGE_SIGNATURE);
+    const paths = Object.keys(args.snapshot.files).sort();
+    const fileList = paths.slice(0, 80).join('\n') + (paths.length > 80 ? `\n[+${paths.length - 80} more]` : '');
+    const keyFiles = renderKeyFilesForSignature(args.snapshot);
+    const raw = (await judge.forward(llm, {
+        userPrompt: args.userPrompt,
+        family: args.composedSpec.family ?? 'unknown',
+        layers: (args.composedSpec.layers ?? []).join(', ') || '(none)',
+        fileList,
+        keyFiles,
+    }, { stream: false }));
+    const num = (v, fallback = 0) => {
+        if (typeof v !== 'number' || Number.isNaN(v))
+            return fallback;
+        if (v > 1 && v <= 10)
+            return v / 10; // defensive: tolerate 0-10 scale drift
+        return Math.max(0, Math.min(1, v));
+    };
+    const issues = normalizeIssues(raw.issues);
+    const correctness = num(raw.correctness);
+    const completeness = num(raw.completeness);
+    const idiomatic = num(raw.idiomatic);
+    const productionReady = num(raw.productionReady);
+    const overScaffold = num(raw.overScaffold, 1);
+    const overallFallback = correctness * 0.3 + completeness * 0.3 + idiomatic * 0.2 + productionReady * 0.1 + overScaffold * 0.1;
+    const verdict = raw.verdict === 'pass' || raw.verdict === 'fail' || raw.verdict === 'borderline' ? raw.verdict : 'borderline';
+    return {
+        correctness,
+        completeness,
+        idiomatic,
+        productionReady,
+        overScaffold,
+        overall: num(raw.overall, overallFallback),
+        issues,
+        verdict,
+        rationale: raw.rationale,
+    };
+}
+/**
+ * Normalize the LLM's `issues` output into our typed shape. The AxSignature
+ * declares issues:string[] (simple list of concerns). We then parse each
+ * line for a "dimension: severity: description" pattern; if it doesn't
+ * match, treat the whole line as a medium-severity unscoped issue. This
+ * lets the judge use free-form language while giving the scorecard
+ * consumer a structured shape.
+ */
+function normalizeIssues(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (typeof item === 'string') {
+            const m = item.match(/^\s*(\w[\w-]*)\s*:\s*(low|medium|high)\s*:\s*(.+)$/i);
+            if (m) {
+                out.push({ dimension: m[1], severity: m[2].toLowerCase(), description: m[3].trim() });
+            }
+            else {
+                out.push({ dimension: 'general', severity: 'medium', description: item.trim() });
+            }
+        }
+        else if (item && typeof item === 'object') {
+            const o = item;
+            const sev = (o.severity === 'low' || o.severity === 'high') ? o.severity : 'medium';
+            out.push({
+                dimension: typeof o.dimension === 'string' ? o.dimension : 'general',
+                severity: sev,
+                description: typeof o.description === 'string' ? o.description : JSON.stringify(o),
+            });
+        }
+    }
+    return out;
+}
+function renderKeyFilesForSignature(snapshot) {
+    const keyFiles = pickKeyFiles(snapshot);
+    const PROMPT_FILE_CAP = 4000;
+    return keyFiles
+        .map((f) => {
+        const truncated = f.content.length > PROMPT_FILE_CAP;
+        const body = truncated
+            ? `${f.content.slice(0, PROMPT_FILE_CAP)}\n[... ${f.content.length - PROMPT_FILE_CAP} more chars truncated for prompt — full content is in the snapshot ...]`
+            : f.content;
+        return `### ${f.path}${truncated ? ' (truncated for prompt)' : ''}\n${body}`;
+    })
+        .join('\n\n---\n\n');
+}
+//# sourceMappingURL=scaffold-bridge.js.map

package/dist/eval/scaffold-bridge.js.map

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

package/dist/lib/ab.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A/B experiment primitive.
+ *
+ * Experiments live as JSON files in `.evolve/experiments/*.json`. They are
+ * loaded and consulted at runtime by abDecide(), which deterministically
+ * bucket a caller into a variant based on an opaque key (typically the
+ * sessionId or compose spec signature) and the experiment's ramp.
+ *
+ * Deterministic: same (experimentId, bucketKey) always yields the same variant.
+ * This is critical so that:
+ *   - a single session sees one variant throughout,
+ *   - analysis by bucketKey is consistent across re-processing.
+ *
+ * Ramp semantics:
+ *   - rampPct: 0..100 — fraction of keys that participate. The rest see
+ *     controlVariant (if set) or are "excluded" (variant=null).
+ *   - Among participants, variants are weighted by their `weight` field
+ *     (defaults to equal weight).
+ */
+interface ExperimentVariant {
+    id: string;
+    /** Relative weight within the participating population (defaults to 1). */
+    weight?: number;
+}
+interface Experiment {
+    schemaVersion: 1;
+    /** Unique experiment id, e.g. "brand-voice-test". */
+    id: string;
+    /** Human-readable description. */
+    description: string;
+    /** Absolute percentage of keys that participate (0-100). */
+    rampPct: number;
+    /** ISO 8601. null = running. */
+    startedAt: string;
+    stoppedAt: string | null;
+    /** Variants the experiment splits traffic across. At least two. */
+    variants: ExperimentVariant[];
+    /**
+     * Fallback variant id for callers outside the ramp. null = those callers
+     * get variant = null from abDecide().
+     */
+    controlVariantId: string | null;
+    /** Primary success metric (free-form, for analysis). */
+    primaryMetric: string;
+}
+/** Back-compat alias — earlier API shipped as `AbExperiment`. */
+export type AbExperiment = Experiment;
+export interface AbDecision {
+    experimentId: string;
+    variantId: string | null;
+    /** True if the key fell inside the ramp. */
+    inRamp: boolean;
+    /** The hash bucket in [0,1). Useful for debugging + per-key audit. */
+    bucket: number;
+}
+/**
+ * Deterministically assign a bucket key to a variant of the given experiment.
+ * Stable across process invocations.
+ */
+export declare function abDecide(experiment: Experiment, bucketKey: string): AbDecision;
+export {};

package/dist/lib/ab.js

@@ -0,0 +1,80 @@
+/**
+ * A/B experiment primitive.
+ *
+ * Experiments live as JSON files in `.evolve/experiments/*.json`. They are
+ * loaded and consulted at runtime by abDecide(), which deterministically
+ * bucket a caller into a variant based on an opaque key (typically the
+ * sessionId or compose spec signature) and the experiment's ramp.
+ *
+ * Deterministic: same (experimentId, bucketKey) always yields the same variant.
+ * This is critical so that:
+ *   - a single session sees one variant throughout,
+ *   - analysis by bucketKey is consistent across re-processing.
+ *
+ * Ramp semantics:
+ *   - rampPct: 0..100 — fraction of keys that participate. The rest see
+ *     controlVariant (if set) or are "excluded" (variant=null).
+ *   - Among participants, variants are weighted by their `weight` field
+ *     (defaults to equal weight).
+ */
+import { createHash } from 'node:crypto';
+function hashToBucket(experimentId, bucketKey) {
+    // SHA-256 first 8 bytes interpreted as big-endian uint64, divided by max.
+    const h = createHash('sha256').update(`${experimentId}::${bucketKey}`).digest();
+    // Use top 52 bits (max precision of Number) to avoid precision loss.
+    let n = 0;
+    for (let i = 0; i < 7; i++) {
+        n = n * 256 + h[i];
+    }
+    // 7 bytes = 56 bits; divide by 2^56.
+    return n / 2 ** 56;
+}
+/**
+ * Deterministically assign a bucket key to a variant of the given experiment.
+ * Stable across process invocations.
+ */
+export function abDecide(experiment, bucketKey) {
+    if (!experiment.variants.length) {
+        throw new Error(`abDecide: experiment ${experiment.id} has no variants`);
+    }
+    if (experiment.rampPct < 0 || experiment.rampPct > 100) {
+        throw new Error(`abDecide: experiment ${experiment.id} has invalid rampPct ${experiment.rampPct}`);
+    }
+    // Two independent buckets derived from the same key so ramp and
+    // variant selection don't correlate.
+    const rampBucket = hashToBucket(`${experiment.id}::ramp`, bucketKey);
+    const inRamp = rampBucket * 100 < experiment.rampPct;
+    if (!inRamp) {
+        return {
+            experimentId: experiment.id,
+            variantId: experiment.controlVariantId,
+            inRamp: false,
+            bucket: rampBucket,
+        };
+    }
+    const variantBucket = hashToBucket(`${experiment.id}::variant`, bucketKey);
+    const weights = experiment.variants.map((v) => v.weight ?? 1);
+    const total = weights.reduce((a, b) => a + b, 0);
+    if (total <= 0)
+        throw new Error(`abDecide: total variant weight is 0 for ${experiment.id}`);
+    let cum = 0;
+    for (let i = 0; i < experiment.variants.length; i++) {
+        cum += weights[i] / total;
+        if (variantBucket < cum) {
+            return {
+                experimentId: experiment.id,
+                variantId: experiment.variants[i].id,
+                inRamp: true,
+                bucket: variantBucket,
+            };
+        }
+    }
+    // Numerical fallback (shouldn't hit unless floating point slop).
+    return {
+        experimentId: experiment.id,
+        variantId: experiment.variants[experiment.variants.length - 1].id,
+        inRamp: true,
+        bucket: variantBucket,
+    };
+}
+//# sourceMappingURL=ab.js.map

package/dist/lib/ab.js.map

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