@galileodev/core 0.1.0

package/dist/playbook/types.d.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+export declare const PlaybookEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    source: z.ZodEnum<["generator", "reflector", "curator", "verifier", "solver"]>;
+    kind: z.ZodEnum<["trajectory", "lesson", "delta", "verification-failure", "remediation-attempt"]>;
+    content: z.ZodString;
+    utility: z.ZodNumber;
+    harmfulness: z.ZodNumber;
+    supersedes: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    section: z.ZodOptional<z.ZodString>;
+    helpful: z.ZodDefault<z.ZodNumber>;
+    harmful: z.ZodDefault<z.ZodNumber>;
+    embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    archived: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    timestamp: string;
+    source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+    kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+    content: string;
+    utility: number;
+    harmfulness: number;
+    metadata: Record<string, unknown>;
+    helpful: number;
+    harmful: number;
+    archived: boolean;
+    supersedes?: string | undefined;
+    section?: string | undefined;
+    embedding?: number[] | undefined;
+}, {
+    id: string;
+    timestamp: string;
+    source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+    kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+    content: string;
+    utility: number;
+    harmfulness: number;
+    metadata: Record<string, unknown>;
+    supersedes?: string | undefined;
+    section?: string | undefined;
+    helpful?: number | undefined;
+    harmful?: number | undefined;
+    embedding?: number[] | undefined;
+    archived?: boolean | undefined;
+}>;
+export type PlaybookEntry = z.infer<typeof PlaybookEntrySchema>;
+export declare const DeltaUpdateSchema: z.ZodObject<{
+    additions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        source: z.ZodEnum<["generator", "reflector", "curator", "verifier", "solver"]>;
+        kind: z.ZodEnum<["trajectory", "lesson", "delta", "verification-failure", "remediation-attempt"]>;
+        content: z.ZodString;
+        utility: z.ZodNumber;
+        harmfulness: z.ZodNumber;
+        supersedes: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        section: z.ZodOptional<z.ZodString>;
+        helpful: z.ZodDefault<z.ZodNumber>;
+        harmful: z.ZodDefault<z.ZodNumber>;
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        archived: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        timestamp: string;
+        source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+        kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+        content: string;
+        utility: number;
+        harmfulness: number;
+        metadata: Record<string, unknown>;
+        helpful: number;
+        harmful: number;
+        archived: boolean;
+        supersedes?: string | undefined;
+        section?: string | undefined;
+        embedding?: number[] | undefined;
+    }, {
+        id: string;
+        timestamp: string;
+        source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+        kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+        content: string;
+        utility: number;
+        harmfulness: number;
+        metadata: Record<string, unknown>;
+        supersedes?: string | undefined;
+        section?: string | undefined;
+        helpful?: number | undefined;
+        harmful?: number | undefined;
+        embedding?: number[] | undefined;
+        archived?: boolean | undefined;
+    }>, "many">;
+    deprecations: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    additions: {
+        id: string;
+        timestamp: string;
+        source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+        kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+        content: string;
+        utility: number;
+        harmfulness: number;
+        metadata: Record<string, unknown>;
+        helpful: number;
+        harmful: number;
+        archived: boolean;
+        supersedes?: string | undefined;
+        section?: string | undefined;
+        embedding?: number[] | undefined;
+    }[];
+    deprecations: string[];
+}, {
+    additions: {
+        id: string;
+        timestamp: string;
+        source: "generator" | "reflector" | "curator" | "verifier" | "solver";
+        kind: "trajectory" | "lesson" | "delta" | "verification-failure" | "remediation-attempt";
+        content: string;
+        utility: number;
+        harmfulness: number;
+        metadata: Record<string, unknown>;
+        supersedes?: string | undefined;
+        section?: string | undefined;
+        helpful?: number | undefined;
+        harmful?: number | undefined;
+        embedding?: number[] | undefined;
+        archived?: boolean | undefined;
+    }[];
+    deprecations: string[];
+}>;
+export type DeltaUpdate = z.infer<typeof DeltaUpdateSchema>;
+export interface PlaybookSnapshot {
+    entries: PlaybookEntry[];
+    takenAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/playbook/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/playbook/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/playbook/types.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export const PlaybookEntrySchema = z.object({
+    id: z.string().min(1),
+    timestamp: z.string().datetime(),
+    source: z.enum(['generator', 'reflector', 'curator', 'verifier', 'solver']),
+    kind: z.enum(['trajectory', 'lesson', 'delta', 'verification-failure', 'remediation-attempt']),
+    content: z.string(),
+    utility: z.number().min(0).max(1),
+    harmfulness: z.number().min(0).max(1),
+    supersedes: z.string().optional(),
+    metadata: z.record(z.unknown()),
+    // New fields for grounded spec revision
+    section: z.string().optional(), // playbook section (e.g., "auth", "testing")
+    helpful: z.number().int().min(0).default(0), // positive reinforcement counter
+    harmful: z.number().int().min(0).default(0), // negative reinforcement counter
+    embedding: z.array(z.number()).optional(), // cached embedding vector
+    archived: z.boolean().default(false), // soft-delete flag
+});
+export const DeltaUpdateSchema = z.object({
+    additions: z.array(PlaybookEntrySchema),
+    deprecations: z.array(z.string()),
+});
+//# sourceMappingURL=types.js.map

package/dist/playbook/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/playbook/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,CAAC,CAAC;IAC9F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/B,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAqB,6CAA6C;IAChG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAQ,iCAAiC;IACpF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAQ,iCAAiC;IACpF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAW,0BAA0B;IAC9E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAgB,mBAAmB;CACxE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAC"}

package/dist/primitives/execution-sandbox.d.ts

@@ -0,0 +1,7 @@
+import type { SandboxOptions, SandboxResult } from './types.js';
+export declare class ExecutionSandbox {
+    exec(command: string, args: string[], options: SandboxOptions): Promise<SandboxResult>;
+    private execProcess;
+    private execContainer;
+}
+//# sourceMappingURL=execution-sandbox.d.ts.map

package/dist/primitives/execution-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-sandbox.d.ts","sourceRoot":"","sources":["../../src/primitives/execution-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,gBAAgB;IACrB,IAAI,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAOzB,OAAO,CAAC,WAAW;YAoEL,aAAa;CAyB5B"}

package/dist/primitives/execution-sandbox.js

@@ -0,0 +1,87 @@
+import { spawn } from 'node:child_process';
+export class ExecutionSandbox {
+    async exec(command, args, options) {
+        if (options.containerMode) {
+            return this.execContainer(command, args, options);
+        }
+        return this.execProcess(command, args, options);
+    }
+    execProcess(command, args, options) {
+        return new Promise((resolve) => {
+            const start = Date.now();
+            const controller = new AbortController();
+            const maxBuffer = options.maxBuffer ?? 10 * 1024 * 1024;
+            const child = spawn(command, args, {
+                cwd: options.workingDir,
+                env: options.env ? { ...process.env, ...options.env } : process.env,
+                signal: controller.signal,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, options.timeoutMs);
+            child.stdout.on('data', (chunk) => {
+                if (stdout.length < maxBuffer) {
+                    stdout += chunk.toString();
+                    if (stdout.length > maxBuffer) {
+                        stdout = stdout.slice(0, maxBuffer);
+                    }
+                }
+            });
+            child.stderr.on('data', (chunk) => {
+                if (stderr.length < maxBuffer) {
+                    stderr += chunk.toString();
+                    if (stderr.length > maxBuffer) {
+                        stderr = stderr.slice(0, maxBuffer);
+                    }
+                }
+            });
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? 1,
+                    timedOut,
+                    durationMs: Date.now() - start,
+                });
+            });
+            child.on('error', () => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: 1,
+                    timedOut,
+                    durationMs: Date.now() - start,
+                });
+            });
+        });
+    }
+    async execContainer(command, args, options) {
+        if (!options.containerImage) {
+            throw new Error('containerImage is required when containerMode is enabled.');
+        }
+        const dockerArgs = [
+            'run', '--rm',
+            '-w', '/workspace',
+            '-v', `${options.workingDir}:/workspace`,
+            ...(options.env
+                ? Object.entries(options.env).flatMap(([k, v]) => ['-e', `${k}=${v}`])
+                : []),
+            options.containerImage,
+            command,
+            ...args,
+        ];
+        return this.execProcess('docker', dockerArgs, {
+            ...options,
+            containerMode: false,
+            workingDir: options.workingDir,
+        });
+    }
+}
+//# sourceMappingURL=execution-sandbox.js.map

package/dist/primitives/execution-sandbox.js.map

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

package/dist/primitives/ratchet-guard.d.ts

@@ -0,0 +1,10 @@
+export declare class RatchetGuard {
+    private readonly workingDir;
+    private checkpointRef;
+    constructor(workingDir: string);
+    checkpoint(): Promise<string>;
+    keepOrRevert(predicate: () => Promise<boolean>): Promise<boolean>;
+    revert(ref: string): Promise<void>;
+    private git;
+}
+//# sourceMappingURL=ratchet-guard.d.ts.map

package/dist/primitives/ratchet-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-guard.d.ts","sourceRoot":"","sources":["../../src/primitives/ratchet-guard.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,aAAa,CAAuB;gBAEf,UAAU,EAAE,MAAM;IAEzC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,YAAY,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,OAAO,CAAC,GAAG;CAMZ"}

package/dist/primitives/ratchet-guard.js

@@ -0,0 +1,44 @@
+import { execFileSync } from 'node:child_process';
+export class RatchetGuard {
+    workingDir;
+    checkpointRef = null;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    async checkpoint() {
+        const sha = this.git(['rev-parse', 'HEAD']);
+        this.checkpointRef = sha;
+        return sha;
+    }
+    async keepOrRevert(predicate) {
+        if (!this.checkpointRef) {
+            throw new Error('No checkpoint set. Call checkpoint() first.');
+        }
+        let keep;
+        try {
+            keep = await predicate();
+        }
+        catch {
+            keep = false;
+        }
+        if (keep) {
+            this.checkpointRef = this.git(['rev-parse', 'HEAD']);
+            return true;
+        }
+        else {
+            await this.revert(this.checkpointRef);
+            return false;
+        }
+    }
+    async revert(ref) {
+        this.git(['reset', '--hard', ref]);
+        this.checkpointRef = ref;
+    }
+    git(args) {
+        return execFileSync('git', args, {
+            cwd: this.workingDir,
+            encoding: 'utf-8',
+        }).trim();
+    }
+}
+//# sourceMappingURL=ratchet-guard.js.map

package/dist/primitives/ratchet-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratchet-guard.js","sourceRoot":"","sources":["../../src/primitives/ratchet-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,OAAO,YAAY;IAGM;IAFrB,aAAa,GAAkB,IAAI,CAAC;IAE5C,YAA6B,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IAAG,CAAC;IAEnD,KAAK,CAAC,UAAU;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiC;QAClD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;IAC3B,CAAC;IAEO,GAAG,CAAC,IAAc;QACxB,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,UAAU;YACpB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/primitives/token-budget.d.ts

@@ -0,0 +1,10 @@
+export declare class TokenBudget {
+    readonly ceiling: number;
+    private _used;
+    constructor(ceiling: number);
+    consume(tokens: number): void;
+    remaining(): number;
+    exhausted(): boolean;
+    used(): number;
+}
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/primitives/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/primitives/token-budget.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,KAAK,CAAK;gBAEN,OAAO,EAAE,MAAM;IAO3B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY7B,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,OAAO;IAIpB,IAAI,IAAI,MAAM;CAGf"}

package/dist/primitives/token-budget.js

@@ -0,0 +1,29 @@
+export class TokenBudget {
+    ceiling;
+    _used = 0;
+    constructor(ceiling) {
+        if (!Number.isFinite(ceiling) || ceiling <= 0) {
+            throw new Error('Token budget ceiling must be a finite positive number.');
+        }
+        this.ceiling = ceiling;
+    }
+    consume(tokens) {
+        if (tokens < 0) {
+            throw new Error('Token consumption must be non-negative.');
+        }
+        if (this._used + tokens > this.ceiling) {
+            throw new Error(`Token budget exceeded: consuming ${tokens} would use ${this._used + tokens} of ${this.ceiling} ceiling.`);
+        }
+        this._used += tokens;
+    }
+    remaining() {
+        return this.ceiling - this._used;
+    }
+    exhausted() {
+        return this._used >= this.ceiling;
+    }
+    used() {
+        return this._used;
+    }
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/primitives/token-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../src/primitives/token-budget.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACb,OAAO,CAAS;IACjB,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,OAAe;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,cAAc,IAAI,CAAC,KAAK,GAAG,MAAM,OAAO,IAAI,CAAC,OAAO,WAAW,CAC1G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/primitives/types.d.ts

@@ -0,0 +1,16 @@
+export interface SandboxOptions {
+    workingDir: string;
+    timeoutMs: number;
+    maxBuffer?: number;
+    env?: Record<string, string>;
+    containerMode?: boolean;
+    containerImage?: string;
+}
+export interface SandboxResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/primitives/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/primitives/types.js

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

package/dist/primitives/types.js.map

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

package/dist/reflector/reflector.d.ts

@@ -0,0 +1,17 @@
+import type { LLMProvider } from '../llm/types.js';
+import type { GenerationResult } from '../generator/types.js';
+import type { ReflectionResult, ReflectorConfig, GroundTruth } from './types.js';
+interface ReflectorInput {
+    taskId: string;
+    generation: GenerationResult;
+    groundTruth?: GroundTruth;
+}
+export declare class Reflector {
+    private readonly llm;
+    private readonly config;
+    constructor(llm: LLMProvider, config?: ReflectorConfig);
+    run(input: ReflectorInput): Promise<ReflectionResult>;
+    private buildPrompt;
+}
+export {};
+//# sourceMappingURL=reflector.d.ts.map

package/dist/reflector/reflector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector.d.ts","sourceRoot":"","sources":["../../src/reflector/reflector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAYjF,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,GAAG,EAAE,WAAW,EAChB,MAAM,GAAE,eAAoB;IAGzC,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAc3D,OAAO,CAAC,WAAW;CAgCpB"}

package/dist/reflector/reflector.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+const ReflectionResponseSchema = z.object({
+    lessons: z.array(z.object({
+        insight: z.string(),
+        source: z.enum(['success', 'failure', 'heuristic']),
+        confidence: z.number().min(0).max(1),
+    })),
+});
+export class Reflector {
+    llm;
+    config;
+    constructor(llm, config = {}) {
+        this.llm = llm;
+        this.config = config;
+    }
+    async run(input) {
+        const prompt = this.buildPrompt(input);
+        const response = await this.llm.structured(prompt, ReflectionResponseSchema, {
+            model: this.config.model,
+            temperature: this.config.temperature,
+        });
+        return {
+            taskId: input.taskId,
+            sourceGenerationTaskId: input.generation.taskId,
+            lessons: response.lessons,
+        };
+    }
+    buildPrompt(input) {
+        const parts = [
+            'You are the Reflector in an ACE (Agentic Context Engineering) pipeline.',
+            'Your role is to analyze a generation result and extract factual and heuristic lessons.',
+            '',
+            '## Generation Trajectories',
+            ...input.generation.trajectories.map((t) => `Step ${t.step}: ${t.reasoning} → ${t.action}`),
+            '',
+            '## Generated Artifacts',
+            ...input.generation.artifacts.map((a) => `${a.path} (${a.language}):\n${a.content}`),
+        ];
+        if (input.groundTruth) {
+            parts.push('', `## Ground Truth (${input.groundTruth.type})`, input.groundTruth.content);
+        }
+        parts.push('', 'Extract lessons: what worked (success), what failed (failure), and general heuristics.', 'Rate your confidence in each lesson from 0 to 1.');
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=reflector.js.map

package/dist/reflector/reflector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector.js","sourceRoot":"","sources":["../../src/reflector/reflector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACrC,CAAC,CACH;CACF,CAAC,CAAC;AAQH,MAAM,OAAO,SAAS;IAED;IACA;IAFnB,YACmB,GAAgB,EAChB,SAA0B,EAAE;QAD5B,QAAG,GAAH,GAAG,CAAa;QAChB,WAAM,GAAN,MAAM,CAAsB;IAC5C,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,wBAAwB,EAAE;YAC3E,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACrC,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,sBAAsB,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;YAC/C,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,KAAqB;QACvC,MAAM,KAAK,GAAG;YACZ,yEAAyE;YACzE,wFAAwF;YACxF,EAAE;YACF,4BAA4B;YAC5B,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,EAAE,CACtD;YACD,EAAE;YACF,wBAAwB;YACxB,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,OAAO,EAAE,CAClD;SACF,CAAC;QAEF,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,oBAAoB,KAAK,CAAC,WAAW,CAAC,IAAI,GAAG,EAC7C,KAAK,CAAC,WAAW,CAAC,OAAO,CAC1B,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,wFAAwF,EACxF,kDAAkD,CACnD,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/reflector/types.d.ts

@@ -0,0 +1,19 @@
+export interface Lesson {
+    insight: string;
+    source: 'success' | 'failure' | 'heuristic';
+    confidence: number;
+}
+export interface GroundTruth {
+    type: 'test-results' | 'error-log' | 'manual';
+    content: string;
+}
+export interface ReflectorConfig {
+    model?: string;
+    temperature?: number;
+}
+export interface ReflectionResult {
+    taskId: string;
+    sourceGenerationTaskId: string;
+    lessons: Lesson[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reflector/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reflector/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/reflector/types.js

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

package/dist/reflector/types.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@galileodev/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@huggingface/transformers": "^3.0.0",
+    "ulid": "^2.3.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0"
+  }
+}