spawnfile 0.1.25 → 0.1.28

package/dist/training/cli/spawnfile/context.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+declare const schema: z.ZodObject<{
+    version: z.ZodLiteral<"spawnfile.training-context.v1">;
+    producer: z.ZodObject<{
+        package: z.ZodLiteral<"spawnfile">;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    project: z.ZodObject<{
+        root: z.ZodString;
+        manifest: z.ZodString;
+        sourceDigest: z.ZodString;
+    }, z.core.$strict>;
+    agent: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        source: z.ZodString;
+        runtime: z.ZodString;
+        engine: z.ZodNullable<z.ZodString>;
+        model: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            name: z.ZodString;
+            authMethod: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    sources: z.ZodArray<z.ZodObject<{
+        sourcePath: z.ZodString;
+        destinationPath: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>;
+    documents: z.ZodArray<z.ZodObject<{
+        sourcePath: z.ZodString;
+        destinationPath: z.ZodString;
+        sha256: z.ZodString;
+        role: z.ZodString;
+    }, z.core.$strict>>;
+    skills: z.ZodArray<z.ZodObject<{
+        sourcePath: z.ZodString;
+        destinationPath: z.ZodString;
+        sha256: z.ZodString;
+        name: z.ZodString;
+        ref: z.ZodString;
+        requiresMcp: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    resources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            bundle: "bundle";
+            git: "git";
+            volume: "volume";
+        }>;
+        mount: z.ZodString;
+        mode: z.ZodEnum<{
+            readonly: "readonly";
+            mutable: "mutable";
+        }>;
+        sharing: z.ZodEnum<{
+            per_agent: "per_agent";
+            team: "team";
+        }>;
+        definitionDigest: z.ZodString;
+        pin: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    requirements: z.ZodObject<{
+        nativeCompilation: z.ZodLiteral<true>;
+        isolatedPreparation: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SpawnfileTrainingContext = z.infer<typeof schema>;
+/** Container receipt reader; host composition passes the same context directly. */
+export declare function readSpawnfileContext(path: string): SpawnfileTrainingContext;
+/** Recheck canonical source bytes for either a container receipt or an in-process context. */
+export declare function validateSpawnfileContext(value: unknown): SpawnfileTrainingContext;
+/** Never let a file receipt override a context supplied by trusted host composition. */
+export declare function resolveSpawnfileContext(path: string | undefined, context?: SpawnfileTrainingContext): SpawnfileTrainingContext;
+export {};

package/dist/training/cli/spawnfile/context.js

@@ -0,0 +1,78 @@
+import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+import { z } from 'zod';
+import { readCliBytes, readCliText } from '../datasets.js';
+const digest = z.string().regex(/^sha256:[a-f0-9]{64}$/);
+const text = z.string().min(1);
+const source = z.object({ sourcePath: text, destinationPath: text, sha256: digest }).strict();
+const schema = z.object({ version: z.literal('spawnfile.training-context.v1'),
+    producer: z.object({ package: z.literal('spawnfile'), version: text }).strict(),
+    project: z.object({ root: text, manifest: text, sourceDigest: digest }).strict(),
+    agent: z.object({ id: text, name: text, source: text, runtime: text, engine: text.nullable(),
+        model: z.object({ provider: text, name: text, authMethod: text }).strict().nullable() }).strict(),
+    sources: z.array(source).min(1).max(10000),
+    documents: z.array(source.extend({ role: text }).strict()).max(128),
+    skills: z.array(source.extend({ name: text, ref: text, requiresMcp: z.array(text) }).strict()).max(1000),
+    resources: z.array(z.object({ id: text, kind: z.enum(['bundle', 'git', 'volume']), mount: text,
+        mode: z.enum(['mutable', 'readonly']), sharing: z.enum(['per_agent', 'team']),
+        definitionDigest: digest, pin: text.nullable() }).strict()).max(1000),
+    requirements: z.object({ nativeCompilation: z.literal(true), isolatedPreparation: z.literal(true) }).strict(),
+}).strict();
+/** Container receipt reader; host composition passes the same context directly. */
+export function readSpawnfileContext(path) {
+    return validateSpawnfileContext(JSON.parse(readCliText(path, 2_000_000)));
+}
+/** Recheck canonical source bytes for either a container receipt or an in-process context. */
+export function validateSpawnfileContext(value) {
+    const context = schema.parse(value);
+    const root = context.project.root;
+    if (!isAbsolute(root) || realpathSync(root) !== root)
+        throw new Error('Spawnfile project root must be canonical and absolute');
+    const entries = new Map();
+    let previous;
+    for (const entry of context.sources) {
+        const destination = entry.destinationPath;
+        if (previous !== undefined && previous >= destination)
+            throw new Error('Spawnfile sources must have unique sorted destinations');
+        previous = destination;
+        if (isAbsolute(destination) || destination.includes('\\') || destination.split('/').some(segment => ['', '.', '..'].includes(segment))) {
+            throw new Error('Spawnfile source destination must be a confined project-relative path');
+        }
+        const expected = resolve(root, destination);
+        const canonical = realpathSync(expected);
+        const within = relative(root, canonical);
+        if (isAbsolute(within) || within === '..' || within.startsWith(`..${sep}`) || entry.sourcePath !== expected) {
+            throw new Error('Spawnfile source mapping escapes or differs from its canonical project path');
+        }
+        const actual = `sha256:${createHash('sha256').update(readCliBytes(canonical, 16 * 1024 * 1024)).digest('hex')}`;
+        if (actual !== entry.sha256)
+            throw new Error(`Spawnfile source changed: ${destination}`);
+        entries.set(destination, entry);
+    }
+    const actualDigest = `sha256:${createHash('sha256').update(JSON.stringify(context.sources.map(({ destinationPath, sha256 }) => ({ destinationPath, sha256 })))).digest('hex')}`;
+    if (actualDigest !== context.project.sourceDigest)
+        throw new Error('Spawnfile project source digest does not match its pinned inventory');
+    for (const document of [...context.documents, ...context.skills]) {
+        const selected = entries.get(document.destinationPath);
+        if (!selected || selected.sourcePath !== document.sourcePath || selected.sha256 !== document.sha256)
+            throw new Error('Spawnfile document or skill is not pinned in the source inventory');
+    }
+    for (const manifest of [context.project.manifest, context.agent.source]) {
+        if (!context.sources.some(entry => entry.sourcePath === manifest))
+            throw new Error('Spawnfile manifest is not pinned in the source inventory');
+    }
+    return context;
+}
+/** Never let a file receipt override a context supplied by trusted host composition. */
+export function resolveSpawnfileContext(path, context) {
+    if (context !== undefined) {
+        if (path !== undefined)
+            throw new Error('Spawnfile context must be supplied either in-process or by file, not both');
+        return validateSpawnfileContext(context);
+    }
+    if (path === undefined)
+        throw new Error('Spawnfile training requires a canonical context');
+    return readSpawnfileContext(path);
+}
+//# sourceMappingURL=context.js.map

package/dist/training/cli/spawnfile/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/training/cli/spawnfile/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;AACzD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9F,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,+BAA+B,CAAC;IAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAChF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE;QAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACnG,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxG,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI;QAC5F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7E,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACvE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC9G,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC/H,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;IAClE,IAAI,QAA4B,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,eAAe,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACjI,QAAQ,GAAG,WAAW,CAAC;QACvB,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACvI,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5G,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChH,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,YAAY,GAAG,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAChL,IAAI,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAC1I,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC5L,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACjJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAC,IAAwB,EAAE,OAAkC;IAClG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QACrH,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC3F,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/training/cli/spawnfile/index.d.ts

@@ -0,0 +1,5 @@
+export { readSpawnfileContext, validateSpawnfileContext, resolveSpawnfileContext } from './context.js';
+export type { SpawnfileTrainingContext } from './context.js';
+export { prepareSpawnfileInputs } from './selection.js';
+export { spawnfileEnvironment } from './moments.js';
+export type { TrainingMomentCase, TrainingMomentReceipt, TrainingMomentPreparation } from './moments.js';

package/dist/training/cli/spawnfile/index.js

@@ -0,0 +1,4 @@
+export { readSpawnfileContext, validateSpawnfileContext, resolveSpawnfileContext } from './context.js';
+export { prepareSpawnfileInputs } from './selection.js';
+export { spawnfileEnvironment } from './moments.js';
+//# sourceMappingURL=index.js.map

package/dist/training/cli/spawnfile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/training/cli/spawnfile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/training/cli/spawnfile/moments.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import type { NativeTrialServices, SpawnfileCliIntegration } from '../types.js';
+import type { SpawnfileTrainingContext } from './context.js';
+import type { NativePreparationContext, StoredTrialOptions } from '../../experiments/index.js';
+declare const momentSchema: z.ZodObject<{
+    version: z.ZodLiteral<"spawnfile.training-moment-case.v1">;
+    projectRoot: z.ZodString;
+    agent: z.ZodString;
+    example: z.ZodString;
+    role: z.ZodEnum<{
+        validation: "validation";
+        test: "test";
+        train: "train";
+    }>;
+    dataset: z.ZodString;
+    at: z.ZodISODateTime;
+    effectiveAt: z.ZodISODateTime;
+    wake: z.ZodObject<{
+        surface: z.ZodLiteral<"moltnet">;
+        room: z.ZodString;
+        from: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>;
+    group: z.ZodString;
+    lineage: z.ZodString;
+    momentRoot: z.ZodString;
+    historyDir: z.ZodOptional<z.ZodString>;
+    hook: z.ZodString;
+}, z.core.$strict>;
+/** Frozen authored metadata; the lowered bundle is never reused as writable trial state. */
+export type TrainingMomentCase = z.infer<typeof momentSchema>;
+export interface TrainingMomentReceipt {
+    version: 'spawnfile.training.training-moment-prepared.v1';
+    trialId: string;
+    example: string;
+    momentRoot: string;
+    at: string;
+}
+export type TrainingMomentPreparation = (paths: Parameters<NonNullable<StoredTrialOptions['prepareEnvironment']>>[0], signal: AbortSignal, trial: NativePreparationContext, context: SpawnfileTrainingContext, moment: TrainingMomentCase, services: NativeTrialServices) => Promise<Awaited<ReturnType<NonNullable<StoredTrialOptions['prepareEnvironment']>>> & {
+    momentReceipt: TrainingMomentReceipt;
+}>;
+/** Static hook registration, fresh destination and rewind evidence are required before subject start. */
+export declare function spawnfileEnvironment(integration: SpawnfileCliIntegration, context: SpawnfileTrainingContext, services: NativeTrialServices): NonNullable<StoredTrialOptions['prepareEnvironment']>;
+export {};

package/dist/training/cli/spawnfile/moments.js

@@ -0,0 +1,71 @@
+import { canonicalWireId } from '../../contracts/index.js';
+import { lstat, readFile, realpath } from 'node:fs/promises';
+import { isAbsolute, join, resolve } from 'node:path';
+import { z } from 'zod';
+const absolute = z.string().refine(value => isAbsolute(value) && resolve(value) === value);
+const instant = z.iso.datetime({ offset: true });
+const momentSchema = z.object({
+    version: z.literal('spawnfile.training-moment-case.v1'), projectRoot: absolute,
+    agent: z.string().min(1), example: z.string().min(1), role: z.enum(['train', 'validation', 'test']),
+    dataset: z.string().min(1), at: instant, effectiveAt: instant,
+    wake: z.object({ surface: z.literal('moltnet'), room: z.string().min(1), from: z.string().min(1), text: z.string().min(1) }).strict(),
+    group: z.string().min(1), lineage: z.string().min(1), momentRoot: absolute,
+    historyDir: absolute.optional(), hook: z.string().min(1),
+}).strict();
+async function boundedJson(path) {
+    const stat = await lstat(path);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 2_000_000)
+        throw new Error('Moment evidence must be a bounded regular file');
+    return JSON.parse(await readFile(path, 'utf8'));
+}
+/** Static hook registration, fresh destination and rewind evidence are required before subject start. */
+export function spawnfileEnvironment(integration, context, services) {
+    return async (paths, signal, trial) => {
+        const declared = trial.record.setup?.trainingMoment;
+        if (declared === undefined)
+            return integration.prepareEnvironment(paths, signal, trial, context, services);
+        const moment = momentSchema.parse(declared);
+        const id = moment.example.slice(moment.role.length + 1);
+        // An internal holdout changes evaluation phase, never the authored rewind selector.
+        const phaseMatches = moment.role === trial.phase || (moment.role === 'train' && trial.phase === 'validation');
+        if (!moment.example.startsWith(`${moment.role}:`) || id !== trial.record.id || !phaseMatches ||
+            moment.agent !== context.agent.id || moment.projectRoot !== context.project.root ||
+            moment.group !== trial.record.group || JSON.stringify([moment.lineage]) !== JSON.stringify(trial.record.lineage)) {
+            throw new Error('Training moment case identity mismatch');
+        }
+        const hooks = integration.momentPreparations;
+        if (!hooks || !Object.hasOwn(hooks, moment.hook))
+            throw new Error(`Undeclared training moment hook: ${moment.hook}`);
+        const destination = join(paths.control, 'moment');
+        if (await lstat(destination).then(() => true, error => {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }))
+            throw new Error('Training moment destination is not fresh');
+        signal.throwIfAborted();
+        const prepared = await hooks[moment.hook](paths, signal, trial, context, moment, services);
+        signal.throwIfAborted();
+        const receipt = prepared.momentReceipt;
+        if (!receipt || canonicalWireId(receipt.version) !== 'spawnfile.training.training-moment-prepared.v1' || receipt.trialId !== trial.id ||
+            receipt.example !== moment.example || receipt.at !== moment.effectiveAt || receipt.momentRoot !== destination) {
+            throw new Error('Training moment preparation receipt mismatch');
+        }
+        if (!(await lstat(destination)).isDirectory() || await realpath(destination) !== destination)
+            throw new Error('Training moment root is not an isolated real directory');
+        const evidence = await boundedJson(join(destination, 'moment.json'));
+        const example = evidence.example;
+        const leak = evidence.leakCheck;
+        if (evidence.version !== 'spawnfile.materialized-moment.v1' || evidence.status !== 'materialized' ||
+            evidence.agent !== moment.agent || evidence.at !== moment.at || evidence.effectiveAt !== moment.effectiveAt ||
+            example?.id !== id || example.role !== moment.role || example.dataset !== moment.dataset || leak?.ok !== true) {
+            throw new Error('Training moment rewind evidence mismatch or refusal');
+        }
+        const check = await boundedJson(join(destination, 'leak-check.json'));
+        if (check.ok !== true)
+            throw new Error('Training moment leak check refused');
+        const { momentReceipt: _receipt, ...environment } = prepared;
+        return environment;
+    };
+}
+//# sourceMappingURL=moments.js.map

package/dist/training/cli/spawnfile/moments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moments.js","sourceRoot":"","sources":["../../../../src/training/cli/spawnfile/moments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;AAC3F,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,mCAAmC,CAAC,EAAE,WAAW,EAAE,QAAQ;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACnG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACrI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ;IAC1E,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC,MAAM,EAAE,CAAC;AAkBZ,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACxI,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAC;AAC7E,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,oBAAoB,CAAC,WAAoC,EAAE,OAAiC,EAC1G,QAA6B;IAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,WAAW,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC3G,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxD,oFAAoF;QACpF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;QAC9G,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY;YACxF,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI;YAChF,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACrH,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,kBAAkB,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACrH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YACpD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACrE,MAAM,KAAK,CAAC;QACd,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5F,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,gDAAgD,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;YACjI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YAClH,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxK,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA8C,CAAC;QACxE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAgD,CAAC;QACvE,IAAI,QAAQ,CAAC,OAAO,KAAK,kCAAkC,IAAI,QAAQ,CAAC,MAAM,KAAK,cAAc;YAC7F,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW;YAC3G,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;YAClH,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC7E,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC;QAC7D,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/training/cli/spawnfile/selection.d.ts

@@ -0,0 +1,83 @@
+import type { InferenceProviderRegistry } from '../../contracts/index.js';
+import { type CliArguments } from '../arguments.js';
+import { CliDatasets } from '../datasets.js';
+import type { CliIO, SpawnfileCliIntegration } from '../types.js';
+import { type SpawnfileTrainingContext } from './context.js';
+export declare function prepareSpawnfileInputs(args: CliArguments, io: CliIO, integration?: SpawnfileCliIntegration, providedContext?: SpawnfileTrainingContext, inferenceProviders?: InferenceProviderRegistry): Promise<{
+    runtime: string;
+    model: string;
+    candidate: import("../../candidates/types.js").CandidateManifest;
+    judges: Record<string, string>;
+    citationRepairs: Record<string, 0 | 1>;
+    sourceRoot: string;
+    out: string;
+    resources: {
+        [k: string]: string;
+    };
+    datasets: CliDatasets;
+    maxTrials: number;
+    context: {
+        version: "spawnfile.training-context.v1";
+        producer: {
+            package: "spawnfile";
+            version: string;
+        };
+        project: {
+            root: string;
+            manifest: string;
+            sourceDigest: string;
+        };
+        agent: {
+            id: string;
+            name: string;
+            source: string;
+            runtime: string;
+            engine: string | null;
+            model: {
+                provider: string;
+                name: string;
+                authMethod: string;
+            } | null;
+        };
+        sources: {
+            sourcePath: string;
+            destinationPath: string;
+            sha256: string;
+        }[];
+        documents: {
+            sourcePath: string;
+            destinationPath: string;
+            sha256: string;
+            role: string;
+        }[];
+        skills: {
+            sourcePath: string;
+            destinationPath: string;
+            sha256: string;
+            name: string;
+            ref: string;
+            requiresMcp: string[];
+        }[];
+        resources: {
+            id: string;
+            kind: "bundle" | "git" | "volume";
+            mount: string;
+            mode: "readonly" | "mutable";
+            sharing: "per_agent" | "team";
+            definitionDigest: string;
+            pin: string | null;
+        }[];
+        requirements: {
+            nativeCompilation: true;
+            isolatedPreparation: true;
+        };
+    };
+    readiness: {
+        runnable: boolean;
+        integration: {
+            id: string;
+            version: string;
+        } | null;
+        reason: string;
+    };
+}>;

package/dist/training/cli/spawnfile/selection.js

@@ -0,0 +1,54 @@
+import { judgeVersions } from '../training/index.js';
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+import { snapshotCandidate } from '../../candidates/index.js';
+import { count, judgeCitationRepairs, one, pairs } from '../arguments.js';
+import { CliDatasets } from '../datasets.js';
+import { resolveSpawnfileContext } from './context.js';
+export async function prepareSpawnfileInputs(args, io, integration, providedContext, inferenceProviders) {
+    const context = resolveSpawnfileContext(args.flags['spawnfile-context']
+        ? resolve(io.cwd, one(args, 'spawnfile-context')) : undefined, providedContext);
+    for (const flag of ['runtime', 'instructions', 'supporting', 'locked', 'source-root']) {
+        if (args.flags[flag])
+            throw new Error(`--${flag} cannot replace canonical Spawnfile configuration`);
+    }
+    const model = one(args, 'model', context.agent.model?.name);
+    const editable = args.flags.editable ?? [];
+    if (new Set(editable).size !== editable.length)
+        throw new Error('Editable selections must be unique');
+    const resources = context.documents.map(document => ({
+        id: `document-${createHash('sha256').update(document.destinationPath).digest('hex').slice(0, 16)}`,
+        sourcePath: document.destinationPath,
+        destinations: [{ kind: document.role === 'system' ? 'instructions' : 'supporting-files', path: document.destinationPath }],
+        edit: editable.includes(document.destinationPath) && document.role === 'system'
+            ? integration?.editPolicies?.[document.destinationPath] ?? 'whole-file' : 'locked',
+    }));
+    for (const skill of context.skills)
+        resources.push({ id: `skill-${createHash('sha256').update(skill.destinationPath).digest('hex').slice(0, 16)}`,
+            sourcePath: skill.destinationPath, destinations: [{ kind: 'native-skills', path: skill.destinationPath }],
+            edit: editable.includes(skill.destinationPath) ? integration?.editPolicies?.[skill.destinationPath] ?? 'whole-file' : 'locked' });
+    if (editable.some(path => !resources.some(resource => resource.sourcePath === path && resource.edit !== 'locked'))) {
+        throw new Error('Editable paths must select canonical system instructions or textual skills; identity and policy remain locked');
+    }
+    const candidate = await snapshotCandidate({ sourceRoot: context.project.root, resources });
+    for (const resource of candidate.resources) {
+        if (context.sources.find(source => source.destinationPath === resource.sourcePath)?.sha256 !== resource.sourceDigest) {
+            throw new Error('Canonical source changed while selecting the candidate');
+        }
+    }
+    const judges = pairs(args.flags.judge ?? []);
+    if (integration && (!integration.id.trim() || !integration.version.trim()))
+        throw new Error('Project integration requires a stable id and version');
+    return { runtime: context.agent.runtime, model, candidate, judges,
+        citationRepairs: judgeCitationRepairs(args, judges),
+        sourceRoot: context.project.root,
+        out: resolve(io.cwd, one(args, 'out', args.flags['dry-run'] ? '.runtime/training' : undefined)),
+        resources: Object.fromEntries(Object.entries(pairs(args.flags.resource ?? [])).map(([name, path]) => [name, resolve(io.cwd, path)])),
+        datasets: new CliDatasets(judges, io.cwd, { subject: context.agent.name, inferenceProviders, inferenceExecutionIdentity: integration?.inferenceExecutionIdentity,
+            registry: { preparations: integration?.preparations }, unlockedSetupPaths: integration?.unlockedSetupPaths }, judgeVersions(args.training, integration?.inferenceExecutionIdentity, Object.keys(judges), inferenceProviders), args.frozenDataset),
+        maxTrials: count(args, 'max-trials', 20, 10000), context,
+        readiness: { runnable: false, integration: integration ? { id: integration.id, version: integration.version } : null,
+            reason: 'Native compilation, authentication and isolated startup are checked during execution. Dry-run probes none of them.' },
+    };
+}
+//# sourceMappingURL=selection.js.map

package/dist/training/cli/spawnfile/selection.js.map

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

package/dist/training/cli/training/cache.d.ts

@@ -0,0 +1,4 @@
+import type { JudgeRoute } from '../../contracts/evaluation.js';
+import type { CliArguments } from '../arguments.js';
+/** Persistent caches are protected execution resources, opened only on actual execution. */
+export declare function prepareJudgeCaches(args: CliArguments, judges: Record<string, JudgeRoute>, out: string, executionRoot?: string): Promise<string[]>;

package/dist/training/cli/training/cache.js

@@ -0,0 +1,43 @@
+import { dirname, isAbsolute, resolve } from 'node:path';
+import { lstat, realpath } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { openJudgeCache } from '../../storage/index.js';
+/** Persistent caches are protected execution resources, opened only on actual execution. */
+export async function prepareJudgeCaches(args, judges, out, executionRoot) {
+    const policy = args.training?.cache;
+    if (policy?.mode !== 'persistent' || !Object.keys(judges).length)
+        return [];
+    if (executionRoot !== undefined && (!isAbsolute(executionRoot) || await realpath(executionRoot) !== executionRoot || !(await lstat(executionRoot)).isDirectory())) {
+        throw new Error('Judge cache execution root must be an existing canonical absolute directory');
+    }
+    const root = executionRoot !== undefined ? await containedCacheRoot(executionRoot, policy.directory ?? 'judge-cache')
+        : policy.directory === undefined ? resolve(out, 'judge-cache')
+            : await containedCacheRoot(dirname(args.frozenDataset.path), policy.directory);
+    for (const [name, route] of Object.entries(judges)) {
+        if (!route.identity)
+            throw new Error('Persistent cache requires an authored judge route');
+        const namespace = createHash('sha256').update(JSON.stringify([policy.namespace, name])).digest('hex');
+        route.cache = await openJudgeCache({ root, namespace,
+            maxEntries: policy.max_entries ?? 1000, maxBytes: 32 * 1024 * 1024 });
+    }
+    return [await realpath(root)];
+}
+async function containedCacheRoot(directory, relative) {
+    let current = await realpath(directory);
+    for (const component of relative.split('/')) {
+        if (!component || component === '.' || component === '..' || component.includes('\\') || component.includes('\0') || /^[A-Za-z]:/.test(component)) {
+            throw new Error('Cache directory requires a contained relative path');
+        }
+        current = resolve(current, component);
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                throw new Error('Cache directory cannot contain symlinks');
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=cache.js.map

package/dist/training/cli/training/cache.js.map

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

package/dist/training/cli/training/checkpoint.d.ts

@@ -0,0 +1,19 @@
+import type { MeasurementRepairReceipt } from '../../experiments/repair/index.js';
+import type { CliArguments } from '../arguments.js';
+import type { CliDependencies, CliExecutionIdentityContext } from '../types.js';
+import type { prepareCliInputs } from '../native.js';
+export declare function commandCheckpoint(args: CliArguments, inputs: Awaited<ReturnType<typeof prepareCliInputs>>, dependencies: CliDependencies, context?: CliExecutionIdentityContext, repair?: {
+    receipt: MeasurementRepairReceipt;
+    digest: string;
+}): Promise<{
+    directory: string;
+    resume: boolean;
+    schema: "spawnfile.training.command-checkpoint.v1";
+    id: string;
+    identity: string;
+    lineage?: {
+        parentId: string;
+        parentIdentity: string;
+        receiptDigest: string;
+    } | undefined;
+}>;

package/dist/training/cli/training/checkpoint.js

@@ -0,0 +1,62 @@
+import { COMMAND_EXECUTION_DOMAIN } from '../../contracts/index.js';
+import { compatibleWireLiteral } from '../../contracts/index.js';
+import { trainingInferencePolicies } from '../../providers/index.js';
+import { createHash, randomUUID } from 'node:crypto';
+import { link, mkdir, open, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { readCliText } from '../datasets.js';
+const stateSchema = z.object({ schema: compatibleWireLiteral('spawnfile.training.command-checkpoint.v1'), id: z.string().uuid(),
+    identity: z.string().regex(/^[a-f0-9]{64}$/),
+    lineage: z.object({ parentId: z.string(), parentIdentity: z.string(), receiptDigest: z.string() }).strict().optional() }).strict();
+export async function commandCheckpoint(args, inputs, dependencies, context = {}, repair) {
+    const integration = dependencies.spawnfile;
+    const environment = await integration?.executionIdentity?.(context);
+    if (inputs.context !== undefined && args.flags.resume && !environment)
+        throw new Error('Resuming a native project requires its immutable execution identity');
+    const flags = Object.fromEntries(Object.entries(args.flags).filter(([name]) => !['resume', 'view', 'out', 'spawnfile-context', 'dry-run'].includes(name)).sort(([a], [b]) => a.localeCompare(b)));
+    const identity = createHash('sha256').update(JSON.stringify({
+        ...(repair ? { measurementRepair: repair.digest } : {}),
+        version: COMMAND_EXECUTION_DOMAIN, comparisonCandidateId: context.comparisonCandidateId, providerPolicies: trainingInferencePolicies(args.training, integration?.inferenceExecutionIdentity, dependencies.inferenceProviders), flags, training: args.training, candidate: inputs.candidate.id,
+        sourceRoot: inputs.sourceRoot, resources: inputs.resources, model: inputs.model,
+        context: inputs.context !== undefined ? inputs.context : null,
+        integration: integration ? { id: integration.id, version: integration.version, environment: environment ?? null,
+            subjectRoot: integration.subjectRoot ?? null,
+            ...(integration.judgeCacheRoot === undefined ? {} : { judgeCacheRoot: integration.judgeCacheRoot }) } : null,
+    })).digest('hex');
+    const directory = join(inputs.out, 'checkpoint');
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const path = join(directory, 'command.json');
+    if (args.flags.resume) {
+        const state = stateSchema.parse(JSON.parse(readCliText(path, 16384)));
+        if (state.identity !== identity)
+            throw new Error('Command checkpoint inputs changed; re-prepare with Spawnfile before resuming');
+        return { ...state, directory, resume: true };
+    }
+    const state = { schema: 'spawnfile.training.command-checkpoint.v1', id: randomUUID(), identity,
+        ...(repair ? { lineage: { parentId: repair.receipt.parent.experimentId, parentIdentity: repair.receipt.parent.executionIdentity, receiptDigest: repair.digest } } : {}) };
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    const file = await open(temporary, 'wx', 0o600);
+    try {
+        try {
+            await file.writeFile(JSON.stringify(state));
+            await file.sync();
+        }
+        finally {
+            await file.close();
+        }
+        await link(temporary, path);
+    }
+    finally {
+        await unlink(temporary);
+    }
+    const folder = await open(directory, 'r');
+    try {
+        await folder.sync();
+    }
+    finally {
+        await folder.close();
+    }
+    return { ...state, directory, resume: false };
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/training/cli/training/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../../../src/training/cli/training/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAC,MAAM,EAAC,qBAAqB,CAAC,0CAA0C,CAAC,EAAC,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzH,QAAQ,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC3C,OAAO,EAAC,CAAC,CAAC,MAAM,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC,MAAM,EAAE,EAAC,cAAc,EAAC,CAAC,CAAC,MAAM,EAAE,EAAC,aAAa,EAAC,CAAC,CAAC,MAAM,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAE5H,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAkB,EAAE,MAAoD,EAC9G,YAA6B,EAAE,UAAuC,EAAE,EACxE,MAA8D;IAC9D,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,WAAW,EAAE,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAC9J,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAC5E,CAAC,CAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,EAAC,mBAAmB,EAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChH,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,iBAAiB,EAAC,MAAM,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,EAAC,wBAAwB,EAAC,qBAAqB,EAAC,OAAO,CAAC,qBAAqB,EAAC,gBAAgB,EAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,YAAY,CAAC,kBAAkB,CAAC,EAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,CAAC,QAAQ,EAAC,SAAS,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACnR,UAAU,EAAC,MAAM,CAAC,UAAU,EAAC,SAAS,EAAC,MAAM,CAAC,SAAS,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK;QAC1E,OAAO,EAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC5D,WAAW,EAAC,WAAW,CAAC,CAAC,CAAC,EAAC,EAAE,EAAC,WAAW,CAAC,EAAE,EAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAC,WAAW,EAAC,WAAW,IAAI,IAAI;YACtG,WAAW,EAAC,WAAW,CAAC,WAAW,IAAI,IAAI;YAC3C,GAAG,CAAC,WAAW,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,cAAc,EAAC,WAAW,CAAC,cAAc,EAAC,CAAC,EAAC,CAAC,CAAC,CAAC,IAAI;KAC3G,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAC,YAAY,CAAC,CAAC;IAChD,MAAM,KAAK,CAAC,SAAS,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QACjI,OAAO,EAAC,GAAG,KAAK,EAAC,SAAS,EAAC,MAAM,EAAC,IAAI,EAAC,CAAC;IAC1C,CAAC;IACD,MAAM,KAAK,GAAG,EAAC,MAAM,EAAC,0CAAmD,EAAC,EAAE,EAAC,UAAU,EAAE,EAAC,QAAQ;QAChG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,EAAC,QAAQ,EAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAC,cAAc,EAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAC,aAAa,EAAC,MAAM,CAAC,MAAM,EAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC;IACjK,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,IAAI,CAAC;YAAA,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAAA,CAAC;gBAAS,CAAC;YAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAAA,CAAC;QAClG,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;IAC9D,OAAO,EAAC,GAAG,KAAK,EAAC,SAAS,EAAC,MAAM,EAAC,KAAK,EAAC,CAAC;AAC3C,CAAC"}

package/dist/training/cli/training/comparison.d.ts

@@ -0,0 +1,8 @@
+import { type CandidateManifest } from '../../candidates/index.js';
+import { type CliArguments } from '../arguments.js';
+import type { CliIO } from '../types.js';
+/** Freeze dataset-relative replacement bytes before runtime or inference construction. */
+export declare function prepareComparison(args: CliArguments, io: CliIO, baseline: CandidateManifest): {
+    candidate: CandidateManifest;
+    name: string;
+} | undefined;