spawnfile 0.1.25 → 0.1.28

package/dist/training/candidates/materialize.js

@@ -0,0 +1,39 @@
+import { mkdir, open, readdir, realpath } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { assertPlainDirectory } from './filesystem.js';
+import { digestBytes } from './identity.js';
+import { validateCandidate } from './validation.js';
+export async function materializeCandidate(candidate, freshRoot) {
+    validateCandidate(candidate);
+    await mkdir(freshRoot, { recursive: true, mode: 0o700 });
+    await assertPlainDirectory(freshRoot);
+    if ((await readdir(freshRoot)).length)
+        throw new Error('Candidate installation requires an empty trial-owned directory');
+    const actualRoot = await realpath(freshRoot);
+    const receipts = [];
+    for (const resource of candidate.resources) {
+        for (const destination of resource.destinations) {
+            const path = resolve(actualRoot, destination.path);
+            await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+            const file = await open(path, 'wx', 0o600);
+            try {
+                await file.writeFile(resource.content, 'utf8');
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            const check = await open(path, 'r');
+            try {
+                if (digestBytes(await check.readFile()) !== resource.digest)
+                    throw new Error('Installed candidate bytes do not match their manifest');
+            }
+            finally {
+                await check.close();
+            }
+            receipts.push({ resourceId: resource.id, destination: { ...destination }, digest: resource.digest, evidence: 'installed' });
+        }
+    }
+    return receipts;
+}
+//# sourceMappingURL=materialize.js.map

package/dist/training/candidates/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../src/training/candidates/materialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAA4B,EAAE,SAAiB;IACxF,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACzH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;oBAClE,CAAC;gBAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACxI,CAAC;oBAAS,CAAC;gBAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAC9H,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/training/candidates/snapshot.d.ts

@@ -0,0 +1,5 @@
+import type { CandidateManifest, ResourceMapping } from './types.js';
+export declare function snapshotCandidate(options: {
+    sourceRoot: string;
+    resources: ResourceMapping[];
+}): Promise<CandidateManifest>;

package/dist/training/candidates/snapshot.js

@@ -0,0 +1,22 @@
+import { readSourceFile } from './filesystem.js';
+import { candidateIdentity, digestBytes, freezeCandidate, policyIdentity } from './identity.js';
+import { validateCandidate, validateMappings } from './validation.js';
+export async function snapshotCandidate(options) {
+    validateMappings(options.resources);
+    const seen = new Set();
+    const resources = [];
+    for (const mapping of options.resources) {
+        const source = await readSourceFile(options.sourceRoot, mapping.sourcePath);
+        if (seen.has(source.realPath))
+            throw new Error('Aliased source file has overlapping resource policies');
+        seen.add(source.realPath);
+        const digest = digestBytes(source.text);
+        resources.push({ ...structuredClone(mapping), content: source.text, sourceContent: source.text, sourceDigest: digest, digest });
+    }
+    const body = { schema: 'spawnfile.training.candidate.v1', parentId: null, policyDigest: policyIdentity(resources), resources };
+    const id = candidateIdentity(body);
+    const manifest = { ...body, id, baselineId: id };
+    validateCandidate(manifest);
+    return freezeCandidate(manifest);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/training/candidates/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/training/candidates/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA6D;IACnG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACxG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClI,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,iCAA0C,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxI,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACjD,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/training/candidates/types.d.ts

@@ -0,0 +1,41 @@
+export type ResourceKind = 'instructions' | 'supporting-files' | 'native-skills';
+export interface NativeDestination {
+    kind: ResourceKind;
+    path: string;
+}
+export type EditPolicy = 'locked' | 'whole-file' | {
+    headings: string[][];
+};
+export interface ResourceMapping {
+    id: string;
+    sourcePath: string;
+    destinations: NativeDestination[];
+    edit: EditPolicy;
+}
+export interface CandidateResource extends ResourceMapping {
+    content: string;
+    /** Original bytes permit independent verification of every locked region. */
+    sourceContent: string;
+    sourceDigest: string;
+    digest: string;
+}
+export interface CandidateManifest {
+    schema: 'spawnfile.training.candidate.v1';
+    id: string;
+    baselineId: string;
+    parentId: string | null;
+    policyDigest: string;
+    resources: CandidateResource[];
+}
+export interface CandidateComponent {
+    id: string;
+    resourceId: string;
+    heading?: string[];
+    text: string;
+}
+export interface MaterializationReceipt {
+    resourceId: string;
+    destination: NativeDestination;
+    digest: string;
+    evidence: 'installed';
+}

package/dist/training/candidates/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/training/candidates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/training/candidates/types.ts"],"names":[],"mappings":""}

package/dist/training/candidates/validation.d.ts

@@ -0,0 +1,4 @@
+import type { CandidateManifest, ResourceMapping } from './types.js';
+export declare function validateMappings(resources: ResourceMapping[]): void;
+export declare function validateCandidate(candidate: CandidateManifest): void;
+export declare function assertOriginalPolicy(baseline: CandidateManifest, candidate: CandidateManifest): void;

package/dist/training/candidates/validation.js

@@ -0,0 +1,89 @@
+import { canonicalWireId } from '../contracts/index.js';
+import { candidateIdentity, canonicalCandidate, digestBytes, policyIdentity } from './identity.js';
+import { relativeResourcePath } from './filesystem.js';
+import { lockedSegments, selectSections } from './headings.js';
+export function validateMappings(resources) {
+    if (!Array.isArray(resources) || !resources.length || resources.length > 256)
+        throw new Error('Candidate requires 1..256 explicit resources');
+    const ids = new Set();
+    const sources = new Set();
+    const paths = [];
+    for (const resource of resources) {
+        if (typeof resource.id !== 'string' || !/^[A-Za-z][\w.-]{0,119}$/.test(resource.id) || ids.has(resource.id))
+            throw new Error('Invalid or duplicate candidate resource ID');
+        ids.add(resource.id);
+        relativeResourcePath(resource.sourcePath);
+        if (sources.has(resource.sourcePath))
+            throw new Error('Source file has overlapping resource policies');
+        sources.add(resource.sourcePath);
+        if (!Array.isArray(resource.destinations) || !resource.destinations.length)
+            throw new Error('Every candidate resource requires native destinations');
+        for (const destination of resource.destinations) {
+            if (!['instructions', 'supporting-files', 'native-skills'].includes(destination.kind))
+                throw new Error('Unsupported native resource kind');
+            relativeResourcePath(destination.path);
+            if (paths.some(path => path === destination.path || path.startsWith(`${destination.path}/`) || destination.path.startsWith(`${path}/`)))
+                throw new Error('Native destinations overlap');
+            paths.push(destination.path);
+        }
+        if (resource.edit !== 'locked' && resource.edit !== 'whole-file' &&
+            (!resource.edit || typeof resource.edit !== 'object' || !Array.isArray(resource.edit.headings) || Object.keys(resource.edit).length !== 1)) {
+            throw new Error('Unsupported candidate edit policy');
+        }
+    }
+}
+export function validateCandidate(candidate) {
+    if (canonicalWireId(candidate.schema) !== 'spawnfile.training.candidate.v1')
+        throw new Error('Unsupported candidate schema');
+    validateMappings(candidate.resources);
+    let bytes = 0;
+    for (const resource of candidate.resources) {
+        if (typeof resource.content !== 'string' || resource.content.includes('\0') || Buffer.byteLength(resource.content) > 1_048_576)
+            throw new Error('Candidate resource must be bounded text');
+        if (Buffer.from(resource.content).toString('utf8') !== resource.content)
+            throw new Error('Candidate resource must contain valid UTF-8 text');
+        bytes += Buffer.byteLength(resource.content);
+        if (resource.digest !== digestBytes(resource.content))
+            throw new Error('Candidate resource digest mismatch');
+        if (typeof resource.sourceContent !== 'string' || resource.sourceDigest !== digestBytes(resource.sourceContent))
+            throw new Error('Invalid candidate source digest');
+        assertLockedBytes({ ...resource, content: resource.sourceContent }, resource);
+        if (typeof resource.edit === 'object')
+            selectSections(resource.content, resource.edit.headings);
+    }
+    if (bytes > 16_777_216)
+        throw new Error('Candidate exceeds 16 MiB');
+    if (candidate.policyDigest !== policyIdentity(candidate.resources))
+        throw new Error('Candidate policy digest mismatch');
+    const { id, baselineId, ...identity } = candidate;
+    if (id !== candidateIdentity(identity, candidate.parentId === null ? undefined : baselineId))
+        throw new Error('Candidate identity mismatch');
+    const original = { schema: candidate.schema, parentId: null, policyDigest: candidate.policyDigest, resources: candidate.resources.map(resource => ({ ...resource, content: resource.sourceContent, digest: resource.sourceDigest })) };
+    if (candidate.baselineId !== candidateIdentity(original) || (candidate.parentId === null && baselineId !== id))
+        throw new Error('Invalid candidate baseline');
+}
+export function assertOriginalPolicy(baseline, candidate) {
+    validateCandidate(baseline);
+    validateCandidate(candidate);
+    if (baseline.parentId !== null || candidate.baselineId !== baseline.id || candidate.policyDigest !== baseline.policyDigest)
+        throw new Error('Candidate must retain its original baseline policy');
+    for (const original of baseline.resources) {
+        const resource = candidate.resources.find(item => item.id === original.id);
+        assertLockedBytes(original, resource);
+    }
+}
+function assertLockedBytes(original, resource) {
+    if (original.edit === 'whole-file')
+        return;
+    if (original.edit === 'locked') {
+        if (resource.content !== original.content)
+            throw new Error(`Locked resource changed: ${original.id}`);
+        return;
+    }
+    const before = selectSections(original.content, original.edit.headings);
+    const after = selectSections(resource.content, original.edit.headings);
+    if (canonicalCandidate(lockedSegments(original.content, before)) !== canonicalCandidate(lockedSegments(resource.content, after))) {
+        throw new Error(`Locked heading text or remainder changed: ${original.id}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/training/candidates/validation.js.map

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

package/dist/training/capture/index.d.ts

@@ -0,0 +1,2 @@
+export { captureObservation, capturedCalls, happensBefore, completeToolScope } from './trace.js';
+export type { CapturedCall } from './trace.js';

package/dist/training/capture/index.js

@@ -0,0 +1,2 @@
+export { captureObservation, capturedCalls, happensBefore, completeToolScope } from './trace.js';
+//# sourceMappingURL=index.js.map

package/dist/training/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/training/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/training/capture/trace.d.ts

@@ -0,0 +1,16 @@
+import type { Observation, ObservationCoverage } from '../contracts/execution.js';
+export interface CapturedCall {
+    id: string;
+    wake_id: string;
+    tool: string;
+    args: unknown;
+    result?: unknown;
+    success?: boolean;
+    dispatch?: Observation;
+    completion?: Observation;
+}
+/** Ingestion order is presentation only. Source sequences and causal edges prove order. */
+export declare function captureObservation(events: readonly Observation[], event: Observation): Observation[];
+export declare function capturedCalls(events: readonly Observation[]): CapturedCall[];
+export declare function happensBefore(first: Observation, second: Observation, events: readonly Observation[], coverage: readonly ObservationCoverage[]): boolean | undefined;
+export declare function completeToolScope(closed: boolean, coverage: readonly ObservationCoverage[]): boolean;

package/dist/training/capture/trace.js

@@ -0,0 +1,74 @@
+import { isDeepStrictEqual } from 'node:util';
+/** Ingestion order is presentation only. Source sequences and causal edges prove order. */
+export function captureObservation(events, event) {
+    if (!event.id || !event.source || !event.trialId || !event.wakeId ||
+        !Number.isSafeInteger(event.seq) || event.seq < 0 || !Number.isFinite(Date.parse(event.timestamp))) {
+        throw new Error('Malformed native observation identity');
+    }
+    if (events.some(item => item.trialId !== event.trialId))
+        throw new Error('Cross-trial observation');
+    const duplicate = events.find(item => item.id === event.id);
+    if (duplicate) {
+        if (!isDeepStrictEqual(duplicate, event))
+            throw new Error(`Conflicting event ${event.id}`);
+        return [...events];
+    }
+    if (events.some(item => item.source === event.source && item.seq === event.seq)) {
+        throw new Error('Conflicting source sequence');
+    }
+    return [...events, structuredClone(event)];
+}
+export function capturedCalls(events) {
+    const calls = new Map();
+    for (const event of events) {
+        if (event.type !== 'tool.dispatch' && event.type !== 'tool.complete')
+            continue;
+        if (!event.callId || !event.tool)
+            throw new Error('Tool observation lacks native call identity');
+        const call = calls.get(event.callId) ?? {
+            id: event.callId, wake_id: event.wakeId, tool: event.tool, args: event.args,
+        };
+        if (call.tool !== event.tool || call.wake_id !== event.wakeId)
+            throw new Error('Conflicting call lineage');
+        if (event.type === 'tool.dispatch') {
+            if (call.dispatch)
+                throw new Error('Duplicate call dispatch');
+            call.dispatch = event;
+            call.args = event.args;
+        }
+        else {
+            if (call.completion)
+                throw new Error('Duplicate call completion');
+            call.completion = event;
+            call.result = event.result;
+            call.success = event.success;
+        }
+        calls.set(event.callId, call);
+    }
+    return [...calls.values()];
+}
+export function happensBefore(first, second, events, coverage) {
+    if (first.id === second.id)
+        return false;
+    const tools = coverage.filter(row => row.channel === 'tools');
+    if (first.source === second.source && tools.length > 0 && tools.every(row => row.ordering === 'source' || row.ordering === 'causal'))
+        return first.seq < second.seq;
+    const byId = new Map(events.map(event => [event.id, event]));
+    const pending = [...(second.causalParents ?? [])];
+    const visited = new Set();
+    while (pending.length) {
+        const id = pending.pop();
+        if (id === first.id)
+            return true;
+        if (visited.has(id))
+            continue;
+        visited.add(id);
+        pending.push(...(byId.get(id)?.causalParents ?? []));
+    }
+    return undefined;
+}
+export function completeToolScope(closed, coverage) {
+    const tools = coverage.filter(row => row.channel === 'tools');
+    return closed && tools.length > 0 && tools.every(row => row.completeness === 'complete');
+}
+//# sourceMappingURL=trace.js.map

package/dist/training/capture/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/training/capture/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAc9C,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,MAA8B,EAAE,KAAkB;IACnF,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM;QAC7D,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA8B;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,SAAS;QAC/E,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI;YACtC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI;SAC5E,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC3G,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC9D,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAClE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAkB,EAAE,MAAmB,EAAE,MAA8B,EACvE,QAAwC;IAExC,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CACxE,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAC3F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAG,CAAC;QAC1B,IAAI,EAAE,KAAK,KAAK,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAe,EAAE,QAAwC;IACzF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC9D,OAAO,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC;AAC3F,CAAC"}

package/dist/training/cases/builtin-evaluators.d.ts

@@ -0,0 +1,2 @@
+import type { EvaluatorDefinition } from '../contracts/dataset.js';
+export declare const builtinEvaluatorDefinitions: Readonly<Record<string, EvaluatorDefinition>>;

package/dist/training/cases/builtin-evaluators.js

@@ -0,0 +1,120 @@
+import { validateTextCheck } from './text-checks.js';
+import { validateGraderParameters } from './grader.js';
+import { validatePredicate } from './turn-bindings.js';
+import { compileJsonSchema } from './json-schema.js';
+import { exclusive, fail, fields, number, object, oneOf, safePath, sequence, string, uniqueStrings } from './validation.js';
+function descriptor(kind, allowed, required, validate, version = '1') {
+    return {
+        // Proof capability permits runtime finality assessment, not premature failure.
+        // Repairable checks remain provisional; negated presence can fail decisively.
+        version, kind, incremental: true, stopProof: kind === 'mechanical',
+        validate(parameters, path) {
+            fields(parameters, allowed, path);
+            for (const name of required)
+                if (parameters[name] === undefined)
+                    fail(`${path}.${name}`, 'required field');
+            validate?.(parameters, path);
+        },
+    };
+}
+function textParameters(parameters, path) {
+    string(parameters.input, `${path}.input`);
+}
+function toolParameters(parameters, path) {
+    string(parameters.tool, `${path}.tool`);
+    if (parameters.outcome !== undefined)
+        oneOf(parameters.outcome, ['succeeded', 'failed'], `${path}.outcome`);
+    if (parameters.phase !== undefined)
+        oneOf(parameters.phase, ['dispatch', 'completion'], `${path}.phase`);
+}
+function sequenceParameters(parameters, path) {
+    oneOf(parameters.order, ['happens-before'], `${path}.order`);
+    if (parameters.ending_at !== undefined) {
+        const ending = object(parameters.ending_at, `${path}.ending_at`);
+        fields(ending, ['artifact', 'event'], `${path}.ending_at`);
+        string(ending.artifact, `${path}.ending_at.artifact`);
+        oneOf(ending.event, ['accepted-call'], `${path}.ending_at.event`);
+    }
+    const bindings = new Set();
+    sequence(parameters.steps, `${path}.steps`).forEach((value, index) => {
+        const stepPath = `${path}.steps[${index}]`;
+        const step = object(value, stepPath);
+        fields(step, ['tool', 'where', 'bind'], stepPath);
+        string(step.tool, `${stepPath}.tool`);
+        if (step.where !== undefined) {
+            const where = object(step.where, `${stepPath}.where`);
+            fields(where, ['cel'], `${stepPath}.where`);
+            validatePredicate(where.cel, ['call', 'context', 'bindings'], `${stepPath}.where.cel`);
+        }
+        if (step.bind !== undefined) {
+            const bind = object(step.bind, `${stepPath}.bind`);
+            for (const [name, selector] of Object.entries(bind)) {
+                if (bindings.has(name))
+                    fail(stepPath, `duplicate sequence binding ${name}`);
+                if (!/^call\.(args|result)(\.[A-Za-z_][\w-]*)*$/.test(string(selector, `${stepPath}.bind.${name}`))) {
+                    fail(stepPath, 'bindings must select call.args or call.result fields');
+                }
+                bindings.add(name);
+            }
+        }
+    });
+}
+export const builtinEvaluatorDefinitions = {
+    'word-count': descriptor('mechanical', ['input', 'ignore', 'min', 'max'], ['input'], validateTextCheck),
+    'values-in-source': descriptor('mechanical', ['input', 'source', 'ignore', 'max_missing'], ['input', 'source'], validateTextCheck),
+    grader: descriptor('semantic', ['grader', 'input', 'context', 'grader_binding'], ['grader', 'input'], validateGraderParameters),
+    equals: descriptor('mechanical', ['input', 'value'], ['input', 'value'], textParameters),
+    'contains-any': descriptor('mechanical', ['input', 'values'], ['input', 'values'], (parameters, path) => {
+        textParameters(parameters, path);
+        uniqueStrings(parameters.values, `${path}.values`);
+    }),
+    'json-schema': descriptor('mechanical', ['input', 'schema'], ['input', 'schema'], (parameters, path) => {
+        textParameters(parameters, path);
+        if (typeof parameters.schema === 'string')
+            safePath(parameters.schema, `${path}.schema`);
+        else
+            compileJsonSchema(object(parameters.schema, `${path}.schema`));
+    }, '2'),
+    'tool-called': descriptor('mechanical', ['tool', 'outcome', 'phase'], ['tool'], toolParameters),
+    'tool-count': descriptor('mechanical', ['tool', 'outcome', 'phase', 'exactly', 'at_least', 'at_most'], ['tool'], (parameters, path) => {
+        toolParameters(parameters, path);
+        if (!['exactly', 'at_least', 'at_most'].some(key => parameters[key] !== undefined))
+            fail(path, 'count requires a bound');
+        if (parameters.exactly !== undefined && (parameters.at_least !== undefined || parameters.at_most !== undefined))
+            fail(path, 'exactly cannot combine with other bounds');
+        for (const key of ['exactly', 'at_least', 'at_most']) {
+            if (parameters[key] !== undefined && !Number.isSafeInteger(number(parameters[key], `${path}.${key}`, 0, Number.MAX_SAFE_INTEGER)))
+                fail(path, 'count must be an integer');
+        }
+        if (typeof parameters.at_least === 'number' && typeof parameters.at_most === 'number' && parameters.at_least > parameters.at_most)
+            fail(path, 'inverted count bounds');
+    }),
+    'tool-sequence': descriptor('mechanical', ['order', 'steps', 'ending_at'], ['order', 'steps'], sequenceParameters),
+    'token-efficiency': { ...descriptor('mechanical', ['metric', 'target_tokens'], ['metric', 'target_tokens'], (parameters, path) => {
+            oneOf(parameters.metric, ['input', 'output', 'total'], `${path}.metric`);
+            if (!Number.isSafeInteger(number(parameters.target_tokens, `${path}.target_tokens`, 1, Number.MAX_SAFE_INTEGER))) {
+                fail(`${path}.target_tokens`, 'expected a positive safe integer');
+            }
+        }), stopProof: false },
+    'llm-rubric': descriptor('semantic', ['input', 'evidence', 'judge', 'rubric', 'minimum'], ['input', 'judge', 'rubric', 'minimum'], (parameters, path) => {
+        textParameters(parameters, path);
+        if (parameters.evidence !== undefined)
+            string(parameters.evidence, `${path}.evidence`);
+        string(parameters.judge, `${path}.judge`);
+        number(parameters.minimum, `${path}.minimum`);
+        const rubric = object(parameters.rubric, `${path}.rubric`);
+        fields(rubric, ['prompt', 'file'], `${path}.rubric`);
+        exclusive(rubric, ['prompt', 'file'], `${path}.rubric`, true);
+        if (rubric.prompt !== undefined)
+            string(rubric.prompt, `${path}.rubric.prompt`);
+        if (rubric.file !== undefined)
+            safePath(rubric.file, `${path}.rubric.file`);
+    }, '3'),
+    'embedding-similarity': descriptor('embedding', ['input', 'reference', 'provider', 'model', 'metric', 'calibration', 'minimum'], ['input', 'reference', 'provider', 'model', 'metric', 'calibration', 'minimum'], (parameters, path) => {
+        for (const key of ['input', 'reference', 'provider', 'model', 'calibration'])
+            string(parameters[key], `${path}.${key}`);
+        oneOf(parameters.metric, ['cosine'], `${path}.metric`);
+        number(parameters.minimum, `${path}.minimum`, -1, 1);
+    }),
+};
+//# sourceMappingURL=builtin-evaluators.js.map

package/dist/training/cases/builtin-evaluators.js.map

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

package/dist/training/cases/check-schema.d.ts

@@ -0,0 +1,2 @@
+export declare function checkShape(value: unknown, path: string, identified?: boolean, depth?: number): void;
+export declare function planShape(value: Record<string, unknown>, path: string): void;

package/dist/training/cases/check-schema.js

@@ -0,0 +1,60 @@
+import { exclusive, fail, fields, number, object, sequence, string } from './validation.js';
+const operations = ['eval', 'all', 'any', 'not', 'passed', 'score', 'use'];
+export function checkShape(value, path, identified = false, depth = 0) {
+    if (depth > 48)
+        fail(path, 'check nesting exceeds 48 levels');
+    const node = object(value, path);
+    if (identified || node.id !== undefined)
+        string(node.id, `${path}.id`);
+    exclusive(node, operations, path, true);
+    if (node.eval !== undefined) {
+        string(node.eval, `${path}.eval`);
+        return; // Registered evaluators own their parameter schema.
+    }
+    const op = operations.find(key => node[key] !== undefined);
+    const allowed = op === 'score' ? ['at_least'] : op === 'use' ? ['with'] : [];
+    fields(node, ['id', op, ...allowed], path);
+    if (op === 'all' || op === 'any') {
+        sequence(node[op], `${path}.${op}`).forEach((child, index) => checkShape(child, `${path}.${op}[${index}]`, false, depth + 1));
+    }
+    else if (op === 'not') {
+        checkShape(node.not, `${path}.not`, false, depth + 1);
+    }
+    else {
+        string(node[op], `${path}.${op}`);
+        if (op === 'score')
+            number(node.at_least, `${path}.at_least`);
+        if (op === 'use' && node.with !== undefined)
+            object(node.with, `${path}.with`);
+    }
+}
+export function planShape(value, path) {
+    exclusive(value, ['checks', 'stages'], path);
+    if (value.checks !== undefined) {
+        sequence(value.checks, `${path}.checks`).forEach((check, index) => checkShape(check, `${path}.checks[${index}]`, true));
+    }
+    if (value.stages === undefined)
+        return;
+    sequence(value.stages, `${path}.stages`).forEach((value, index) => {
+        const stagePath = `${path}.stages[${index}]`;
+        const stage = object(value, stagePath);
+        fields(stage, ['id', 'when', 'checks', 'score', 'gate'], stagePath);
+        string(stage.id, `${stagePath}.id`);
+        sequence(stage.checks, `${stagePath}.checks`).forEach((check, checkIndex) => checkShape(check, `${stagePath}.checks[${checkIndex}]`, true));
+        if (stage.when !== undefined)
+            checkShape(stage.when, `${stagePath}.when`);
+        if (stage.gate !== undefined)
+            checkShape(stage.gate, `${stagePath}.gate`);
+        if (stage.score !== undefined) {
+            const score = object(stage.score, `${stagePath}.score`);
+            fields(score, ['linear'], `${stagePath}.score`);
+            const weights = object(score.linear, `${stagePath}.score.linear`);
+            const values = Object.entries(weights).map(([key, weight]) => number(weight, `${stagePath}.score.linear.${key}`, 0, Number.MAX_VALUE));
+            const total = values.reduce((sum, weight) => sum + weight, 0);
+            if (!Number.isFinite(total) || total <= 0) {
+                fail(`${stagePath}.score.linear`, 'weights must have a finite positive total');
+            }
+        }
+    });
+}
+//# sourceMappingURL=check-schema.js.map

package/dist/training/cases/check-schema.js.map

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

package/dist/training/cases/cost-projection.d.ts

@@ -0,0 +1,27 @@
+import type { CheckNode, FileSelector, ResolvedDataset } from '../contracts/dataset.js';
+/** Contains no native inputs or executable evaluation record. */
+export interface CostRecord {
+    schema: 'spawnfile.training.cost-record.v1';
+    id: string;
+    group?: string;
+    lineage?: string[];
+    selectedFiles: FileSelector[];
+    costChecks: Array<{
+        check: CheckNode;
+        live: boolean;
+    }>;
+}
+export interface CostDataset {
+    schema: 'spawnfile.training.cost-dataset.v1';
+    id: string;
+    subject?: string;
+    sourceDigest: string;
+    structureDigest: string;
+    records: CostRecord[];
+    preparation: {
+        status: 'unverified';
+        profiles: string[];
+        checks: readonly ['availability', 'locks', 'parameter-semantics'];
+    };
+}
+export declare function projectDatasetCost(dataset: ResolvedDataset): CostDataset;

package/dist/training/cases/cost-projection.js

@@ -0,0 +1,29 @@
+import { selectedFiles } from './splits.js';
+export function projectDatasetCost(dataset) {
+    const profiles = new Set();
+    for (const record of dataset.records)
+        if (typeof record.setup?.profile === 'string')
+            profiles.add(record.setup.profile);
+    return { schema: 'spawnfile.training.cost-dataset.v1', id: dataset.id, subject: dataset.subject,
+        sourceDigest: dataset.sourceDigest, structureDigest: dataset.sharedPlanDigest,
+        preparation: { status: 'unverified', profiles: [...profiles].sort(), checks: ['availability', 'locks', 'parameter-semantics'] },
+        records: dataset.records.map(projectRecordCost) };
+}
+function projectRecordCost(record) {
+    const costChecks = [];
+    const add = (check, live = false) => { costChecks.push({ check: structuredClone(check), live }); };
+    for (const stage of record.effectiveStages) {
+        if (stage.when)
+            add(stage.when);
+        stage.checks.forEach(check => add(check));
+        if (stage.gate)
+            add(stage.gate);
+    }
+    for (const turn of record.turns ?? [])
+        for (const check of turn.checks ?? [])
+            add(check);
+    for (const check of record.live.checks)
+        add(check, true);
+    return { schema: 'spawnfile.training.cost-record.v1', id: record.id, group: record.group, ...(record.lineage ? { lineage: [...record.lineage] } : {}), selectedFiles: structuredClone(selectedFiles(record)), costChecks };
+}
+//# sourceMappingURL=cost-projection.js.map