@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/harnesses/engine/packaging.js

@@ -0,0 +1,424 @@
+/**
+ * Harness engine — workingDir provisioning + artifact walking + artifact storage.
+ *
+ * §6.6 workdir layout, §5.3 artifact artifactType conventions.
+ *
+ * Responsibilities:
+ *   1. Provision workingDir at PRE_SNAPSHOT time: write task.json, env/ files,
+ *      sessions/ dir.
+ *   2. After impl returns: walk workingDir, read OUTPUTS.json (if present),
+ *      compute sha256, persist each artifact, return structured list.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
+import { join, relative, resolve, extname, isAbsolute } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { createGzip } from 'node:zlib';
+import { createWriteStream } from 'node:fs';
+import { z } from 'zod';
+import { uploadToIpfs } from '../../adapters/mech/ipfs.js';
+import { DONATION_ARTIFACT_ENCODING, scrubArtifactBytes, } from './artifact-scrub.js';
+// ── OUTPUTS.json schema ───────────────────────────────────────────────────────
+//
+// OUTPUTS.json access descriptor shape (no `kind` field):
+//   { "endpoint": "https://…", "priceUsdc": "0" }       — free
+//   { "endpoint": "https://…", "priceUsdc": "0.001" }   — x402-gated
+//
+// Use explicit priceUsdc: "0" for free artifacts.
+// Omit the access object entirely to inherit the operator default price.
+const OutputEntrySchema = z.object({
+    path: z.string(),
+    artifactType: z.string(),
+    metadata: z.record(z.unknown()).optional(),
+    tags: z.array(z.string()).optional(),
+    access: z
+        .object({
+        endpoint: z.string().optional(),
+        priceUsdc: z.string().regex(/^\d+(\.\d+)?$/),
+    })
+        .optional(),
+}).superRefine((val, ctx) => {
+    if ('role' in val && !('artifactType' in val)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "OUTPUTS.json field 'role' is renamed to 'artifactType' — update your outputs declaration",
+        });
+    }
+});
+const OutputsJsonSchema = z.object({
+    outputs: z.array(OutputEntrySchema),
+});
+const SYSTEM_SNAPSHOT_EXCLUDED_DIR_NAMES = new Set([
+    'env',
+    'repo',
+    '.git',
+    '.hg',
+    '.svn',
+    'node_modules',
+    '.venv',
+    'venv',
+    '__pycache__',
+    '.pytest_cache',
+    '.mypy_cache',
+    '.ruff_cache',
+    '.tox',
+    '.nox',
+    '.cache',
+    'dist',
+    'build',
+]);
+function isExcludedFromSystemSnapshot(relPath) {
+    return relPath
+        .split(/[\\/]+/)
+        .some((part) => SYSTEM_SNAPSHOT_EXCLUDED_DIR_NAMES.has(part));
+}
+// ── WorkingDir provisioning ───────────────────────────────────────────────────
+/**
+ * Provision the working directory at PRE_SNAPSHOT time.
+ *
+ * Creates:
+ *   <workingDir>/task.json     — canonical Task JSON
+ *   <workingDir>/env/<VAR>       — one file per env var (mode 0600)
+ *   <workingDir>/sessions/       — directory for session transcripts
+ */
+export function provisionWorkingDir(workingDir, task, envVars = {}) {
+    mkdirSync(workingDir, { recursive: true, mode: 0o755 });
+    // task.json
+    writeFileSync(join(workingDir, 'task.json'), JSON.stringify(task, null, 2), 'utf-8');
+    // env/ directory — one file per var, mode 0600
+    const envDir = join(workingDir, 'env');
+    mkdirSync(envDir, { recursive: true, mode: 0o700 });
+    for (const [name, value] of Object.entries(envVars)) {
+        writeFileSync(join(envDir, name), value, { encoding: 'utf-8', mode: 0o600 });
+    }
+    // sessions/ directory
+    mkdirSync(join(workingDir, 'sessions'), { recursive: true, mode: 0o755 });
+}
+/**
+ * Provision the impl state directory on first invocation.
+ * Never deleted by the engine — persistent across attempts.
+ */
+export function provisionImplStateDir(implStateDir) {
+    mkdirSync(implStateDir, { recursive: true, mode: 0o755 });
+}
+// ── Tarball helper ────────────────────────────────────────────────────────────
+/**
+ * Create a gzipped tar of the workingDir at the given output path.
+ * Returns the output path.
+ *
+ * Uses native Node.js streams — no external binary required.
+ *
+ * DETERMINISM: uses epoch-0 mtime for all entries so the resulting tarball
+ * is byte-for-byte identical across retries (same file contents → same CID).
+ * The `excludeName` parameter is used to skip the tarball itself so it does
+ * not include itself.
+ */
+async function createWorkdirTarball(workingDir, outputPath, excludeName, scrub) {
+    // Build a simple tar manually using Buffer operations to avoid spawning
+    // external processes. For correctness and portability we use a pure-JS
+    // approach: read all files, pack them into a POSIX tar, gzip the result.
+    const entries = [];
+    function walk(dir) {
+        for (const name of readdirSync(dir)) {
+            const full = join(dir, name);
+            const st = statSync(full);
+            if (st.isDirectory()) {
+                const relDir = relative(workingDir, full);
+                if (isExcludedFromSystemSnapshot(relDir))
+                    continue;
+                walk(full);
+            }
+            else if (st.isFile()) {
+                const relPath = relative(workingDir, full);
+                // Exclude the tarball itself to prevent self-inclusion
+                if (excludeName && relPath === excludeName)
+                    continue;
+                if (isExcludedFromSystemSnapshot(relPath))
+                    continue;
+                const rawContent = readFileSync(full);
+                const content = scrub ? scrubArtifactBytes(rawContent, scrub).bytes : rawContent;
+                entries.push({ relPath, content });
+            }
+        }
+    }
+    walk(workingDir);
+    // Build ustar-format tar in memory
+    const blocks = [];
+    function padStr(s, len) {
+        const buf = Buffer.alloc(len, 0);
+        buf.write(s.slice(0, len), 'utf-8');
+        return buf;
+    }
+    function octalField(n, len) {
+        const s = n.toString(8).padStart(len - 1, '0') + ' ';
+        return Buffer.from(s, 'ascii');
+    }
+    for (const { relPath, content } of entries) {
+        const header = Buffer.alloc(512, 0);
+        // name (100)
+        padStr(relPath, 100).copy(header, 0);
+        // mode (8)
+        octalField(0o644, 8).copy(header, 100);
+        // uid (8)
+        octalField(0, 8).copy(header, 108);
+        // gid (8)
+        octalField(0, 8).copy(header, 116);
+        // size (12)
+        octalField(content.length, 12).copy(header, 124);
+        // mtime (12) — fixed epoch 0 for deterministic/reproducible tarballs
+        octalField(0, 12).copy(header, 136);
+        // typeflag
+        header[156] = 0x30; // '0' = regular file
+        // magic
+        Buffer.from('ustar  \0', 'ascii').copy(header, 257);
+        // Compute checksum
+        header.fill(0x20, 148, 156); // space out checksum field
+        let checksum = 0;
+        for (let i = 0; i < 512; i++)
+            checksum += header[i];
+        octalField(checksum, 8).copy(header, 148);
+        blocks.push(header);
+        // Content + padding to 512-byte boundary
+        blocks.push(content);
+        const remainder = content.length % 512;
+        if (remainder > 0) {
+            blocks.push(Buffer.alloc(512 - remainder, 0));
+        }
+    }
+    // Two 512-byte zero blocks as end-of-archive marker
+    blocks.push(Buffer.alloc(1024, 0));
+    const tarData = Buffer.concat(blocks);
+    // Gzip compress
+    await pipeline((async function* () { yield tarData; })(), createGzip(), createWriteStream(outputPath));
+    return outputPath;
+}
+// ── Path containment helper ───────────────────────────────────────────────────
+/**
+ * Returns true iff `candidate` resolves to a path strictly inside `workingDir`.
+ * Rejects dotdot traversal, symlink escapes (after resolve), and paths that
+ * are equal to workingDir itself (directories, not files).
+ */
+function isInsideWorkingDir(workingDir, candidate) {
+    const wd = resolve(workingDir);
+    const c = resolve(candidate);
+    const rel = relative(wd, c);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+}
+// ── sha256 helper ─────────────────────────────────────────────────────────────
+function sha256Hex(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+function donationEnabled(deps) {
+    return deps.donation?.enabled === true;
+}
+// ── Artifact walking ──────────────────────────────────────────────────────────
+/**
+ * Walk the working directory and collect declared + default artifacts.
+ *
+ * Priority: OUTPUTS.json overrides defaults. After collecting declared entries,
+ * we also always add a tarball of the full workingDir as `system_snapshot`.
+ */
+export async function walkArtifacts(workingDir, implArtifacts = [], options = {}) {
+    const result = [];
+    // 1. Check for OUTPUTS.json
+    const outputsJsonPath = join(workingDir, 'OUTPUTS.json');
+    let usedOutputsJson = false;
+    if (existsSync(outputsJsonPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(outputsJsonPath, 'utf-8'));
+            const parsed = OutputsJsonSchema.parse(raw);
+            for (const entry of parsed.outputs) {
+                const fullPath = join(workingDir, entry.path);
+                if (!isInsideWorkingDir(workingDir, fullPath)) {
+                    console.warn(`[harness-engine] OUTPUTS.json path traversal detected (skipped): ${entry.path}`);
+                    continue;
+                }
+                if (existsSync(fullPath) && statSync(fullPath).isFile()) {
+                    result.push({
+                        localPath: fullPath,
+                        artifactType: entry.artifactType,
+                        metadata: entry.metadata,
+                        tags: entry.tags,
+                        access: entry.access,
+                    });
+                }
+            }
+            usedOutputsJson = true;
+        }
+        catch (err) {
+            console.warn(`[harness-engine] OUTPUTS.json parse failed (ignored): ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    if (!usedOutputsJson) {
+        // 2. Apply impl-provided OutputArtifact entries
+        for (const art of implArtifacts) {
+            // Reject absolute paths outright — impl must use workingDir-relative paths
+            if (isAbsolute(art.path)) {
+                console.warn(`[harness-engine] impl artifact absolute path rejected (skipped): ${art.path}`);
+                continue;
+            }
+            const fullPath = join(workingDir, art.path);
+            if (!isInsideWorkingDir(workingDir, fullPath)) {
+                console.warn(`[harness-engine] impl artifact path traversal detected (skipped): ${art.path}`);
+                continue;
+            }
+            if (existsSync(fullPath) && statSync(fullPath).isFile()) {
+                result.push({
+                    localPath: fullPath,
+                    artifactType: art.artifactType,
+                    metadata: art.metadata,
+                    tags: art.tags,
+                    access: art.access,
+                });
+            }
+        }
+        // 3. Apply default conventions for files not already declared
+        const declared = new Set(result.map((r) => r.localPath));
+        // sessions/ → session_transcript
+        const sessionsDir = join(workingDir, 'sessions');
+        if (existsSync(sessionsDir)) {
+            for (const name of readdirSync(sessionsDir)) {
+                const full = join(sessionsDir, name);
+                if (statSync(full).isFile() && !declared.has(full)) {
+                    result.push({ localPath: full, artifactType: 'session_transcript', access: { priceUsdc: '0' } });
+                }
+            }
+        }
+        // Markdown files at root → design_document
+        const rootFiles = readdirSync(workingDir);
+        for (const name of rootFiles) {
+            const full = join(workingDir, name);
+            if (statSync(full).isFile() &&
+                extname(name).toLowerCase() === '.md' &&
+                !declared.has(full)) {
+                result.push({ localPath: full, artifactType: 'design_document', access: { priceUsdc: '0' } });
+            }
+        }
+        // logs/ → runtime_log
+        const logsDir = join(workingDir, 'logs');
+        if (existsSync(logsDir)) {
+            for (const name of readdirSync(logsDir)) {
+                const full = join(logsDir, name);
+                if (statSync(full).isFile() && !declared.has(full)) {
+                    result.push({ localPath: full, artifactType: 'runtime_log', access: { priceUsdc: '0' } });
+                }
+            }
+        }
+    }
+    // 4. Always add system_snapshot tarball of the full workingDir.
+    // Deterministic filename inside workingDir so retries produce the same CID.
+    const SNAPSHOT_FILENAME = 'system_snapshot.tar.gz';
+    const tarballPath = join(workingDir, SNAPSHOT_FILENAME);
+    try {
+        await createWorkdirTarball(workingDir, tarballPath, SNAPSHOT_FILENAME, options.scrub);
+        result.push({
+            localPath: tarballPath,
+            artifactType: 'system_snapshot',
+            metadata: { description: 'Scrubbed workingDir snapshot excluding secrets, task checkouts, VCS data, dependencies, and caches' },
+            access: { priceUsdc: '0' },
+        });
+    }
+    catch (err) {
+        console.warn(`[harness-engine] workingDir tarball creation failed (non-fatal): ${err instanceof Error ? err.message : err}`);
+    }
+    return result;
+}
+// ── Upload pipeline ───────────────────────────────────────────────────────────
+/**
+ * Write all collected artifacts to the operator-local served_artifacts store.
+ *
+ * Default behavior writes artifact bytes to the operator-local artifact store.
+ * Public-testnet donation mode is IPFS-first: scrubbed bytes are pinned
+ * publicly to IPFS and recorded in artifact.sources[] so peers can retrieve
+ * and verify them without a public operator endpoint. The endpoint/price
+ * fields remain compatibility plumbing for direct fallback and future paid
+ * data-market flows.
+ *
+ * Returns an array of `UploadedArtifact` (= Artifact + localPath).
+ */
+export async function uploadArtifacts(artifacts, deps) {
+    if (!deps.operatorEndpoint) {
+        throw new Error('uploadArtifacts: operatorEndpoint is required for local artifact descriptors');
+    }
+    const results = [];
+    const now = new Date().toISOString();
+    const donate = donationEnabled(deps) ? deps.donation : null;
+    for (const art of artifacts) {
+        try {
+            const rawContent = readFileSync(art.localPath);
+            const content = donate
+                ? scrubArtifactBytes(rawContent, donate.scrub).bytes
+                : rawContent;
+            const hash = sha256Hex(content);
+            const priceUsdc = art.access?.priceUsdc
+                ?? deps.perArtifactTypePrice[art.artifactType]
+                ?? deps.defaultPriceUsdc;
+            const endpoint = art.access?.endpoint ?? deps.operatorEndpoint;
+            const sources = [];
+            if (donate) {
+                const cid = await uploadToIpfs(donate.ipfsRegistryUrl, {
+                    schemaVersion: DONATION_ARTIFACT_ENCODING,
+                    artifactType: art.artifactType,
+                    sha256: hash,
+                    encoding: DONATION_ARTIFACT_ENCODING,
+                    data: content.toString('base64'),
+                });
+                sources.push({
+                    kind: 'ipfs',
+                    cid,
+                    sha256: hash,
+                    encoding: DONATION_ARTIFACT_ENCODING,
+                });
+            }
+            const uploaded = {
+                sha256: hash,
+                artifactType: art.artifactType,
+                metadata: art.metadata,
+                access: { endpoint, priceUsdc },
+                ...(sources.length > 0 ? { sources } : {}),
+                localPath: art.localPath,
+            };
+            deps.store.saveServedArtifact({
+                sha256: hash,
+                artifactType: art.artifactType,
+                requestId: deps.requestId,
+                content,
+                priceUsdc,
+                createdAt: now,
+            });
+            // Forward linkage: emit a jinn.artifact.emit span and attach a producedBy
+            // back-reference so readers can look up which span produced this artifact.
+            // trajectoryCid is unknown at packaging time — the engine backfills it after
+            // emitTrajectory completes (Task 16 backward linkage).
+            if (deps.collector) {
+                const nowNano = String(BigInt(Date.now()) * 1000000n);
+                const span = deps.collector.addSpan({
+                    name: 'artifact.emit',
+                    kind: 'INTERNAL',
+                    startTimeUnixNano: nowNano,
+                    endTimeUnixNano: nowNano,
+                    attributes: {
+                        'jinn.span.kind': 'jinn.artifact.emit',
+                        'jinn.artifact.sha256': hash,
+                        'jinn.artifact.artifactType': art.artifactType,
+                    },
+                    events: [],
+                    status: { code: 'OK' },
+                });
+                uploaded.metadata = {
+                    ...uploaded.metadata,
+                    producedBy: { spanId: span.spanId, trajectoryCid: '' },
+                };
+            }
+            results.push(uploaded);
+        }
+        catch (err) {
+            console.error(`[harness-engine] artifact write failed for ${art.localPath}: ${err instanceof Error ? err.message : err}`);
+            if (donate)
+                throw err;
+            // Non-fatal: continue with remaining artifacts
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=packaging.js.map

package/dist/harnesses/engine/packaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaging.js","sourceRoot":"","sources":["../../../src/harnesses/engine/packaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAEL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,iFAAiF;AACjF,EAAE;AACF,0DAA0D;AAC1D,+DAA+D;AAC/D,qEAAqE;AACrE,EAAE;AACF,kDAAkD;AAClD,yEAAyE;AAEzE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC;KAC7C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IAC1B,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,0FAA0F;SACpG,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACpC,CAAC,CAAC;AAIH,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAC;IACjD,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,cAAc;IACd,OAAO;IACP,MAAM;IACN,aAAa;IACb,eAAe;IACf,aAAa;IACb,aAAa;IACb,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,SAAS,4BAA4B,CAAC,OAAe;IACnD,OAAO,OAAO;SACX,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kCAAkC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAwCD,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,IAAU,EACV,UAAkC,EAAE;IAEpC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAExD,YAAY;IACZ,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAErF,+CAA+C;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACvC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,sBAAsB;IACtB,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,KAAK,UAAU,oBAAoB,CACjC,UAAkB,EAClB,UAAkB,EAClB,WAAoB,EACpB,KAA2B;IAE3B,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,OAAO,GAAgD,EAAE,CAAC;IAEhE,SAAS,IAAI,CAAC,GAAW;QACvB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,4BAA4B,CAAC,MAAM,CAAC;oBAAE,SAAS;gBACnD,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC3C,uDAAuD;gBACvD,IAAI,WAAW,IAAI,OAAO,KAAK,WAAW;oBAAE,SAAS;gBACrD,IAAI,4BAA4B,CAAC,OAAO,CAAC;oBAAE,SAAS;gBACpD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;gBACtC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;gBACjF,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjB,mCAAmC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,SAAS,MAAM,CAAC,CAAS,EAAE,GAAW;QACpC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,UAAU,CAAC,CAAS,EAAE,GAAW;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpC,aAAa;QACb,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrC,WAAW;QACX,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvC,UAAU;QACV,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,UAAU;QACV,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,YAAY;QACZ,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjD,qEAAqE;QACrE,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,WAAW;QACX,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,qBAAqB;QACzC,QAAQ;QACR,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEpD,mBAAmB;QACnB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,2BAA2B;QACxD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;QACpD,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpB,yCAAyC;QACzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;QACvC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEtC,gBAAgB;IAChB,MAAM,QAAQ,CACZ,CAAC,KAAK,SAAS,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACzC,UAAU,EAAE,EACZ,iBAAiB,CAAC,UAAU,CAAC,CAC9B,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,UAAkB,EAAE,SAAiB;IAC/D,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,iFAAiF;AAEjF,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,IAAmB;IAG1C,OAAO,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AACzC,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,gBAAkC,EAAE,EACpC,UAAgC,EAAE;IAElC,MAAM,MAAM,GAMP,EAAE,CAAC;IAER,4BAA4B;IAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACzD,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;oBAC9C,OAAO,CAAC,IAAI,CAAC,oEAAoE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC/F,SAAS;gBACX,CAAC;gBACD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;oBACxD,MAAM,CAAC,IAAI,CAAC;wBACV,SAAS,EAAE,QAAQ;wBACnB,YAAY,EAAE,KAAK,CAAC,YAAY;wBAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,yDAAyD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,gDAAgD;QAChD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,2EAA2E;YAC3E,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,oEAAoE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7F,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,qEAAqE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9F,SAAS;YACX,CAAC;YACD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,QAAQ;oBACnB,YAAY,EAAE,GAAG,CAAC,YAAY;oBAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAEzD,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBACnG,CAAC;YACH,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpC,IACE,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;gBACrC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EACnB,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACjC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,4EAA4E;IAC5E,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,oBAAoB,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,WAAW;YACtB,YAAY,EAAE,iBAAiB;YAC/B,QAAQ,EAAE,EAAE,WAAW,EAAE,oGAAoG,EAAE;YAC/H,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,oEAAoE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/H,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAME,EACF,IAAmB;IAEnB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM;gBACpB,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK;gBACpD,CAAC,CAAC,UAAU,CAAC;YACf,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAEhC,MAAM,SAAS,GACb,GAAG,CAAC,MAAM,EAAE,SAAS;mBAClB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC;mBAC3C,IAAI,CAAC,gBAAgB,CAAC;YAE3B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,gBAAgB,CAAC;YAE/D,MAAM,OAAO,GAAgC,EAAE,CAAC;YAChD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE;oBACrD,aAAa,EAAE,0BAA0B;oBACzC,YAAY,EAAE,GAAG,CAAC,YAAY;oBAC9B,MAAM,EAAE,IAAI;oBACZ,QAAQ,EAAE,0BAA0B;oBACpC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACjC,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,MAAM;oBACZ,GAAG;oBACH,MAAM,EAAE,IAAI;oBACZ,QAAQ,EAAE,0BAA0B;iBACrC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,QAAQ,GAAqB;gBACjC,MAAM,EAAE,IAAI;gBACZ,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,QAAQ,EAAE,GAAG,CAAC,QAAwC;gBACtD,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;gBAC/B,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;gBAC5B,MAAM,EAAE,IAAI;gBACZ,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO;gBACP,SAAS;gBACT,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YAEH,0EAA0E;YAC1E,2EAA2E;YAC3E,6EAA6E;YAC7E,uDAAuD;YACvD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAU,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;oBAClC,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE,UAAU;oBAChB,iBAAiB,EAAE,OAAO;oBAC1B,eAAe,EAAE,OAAO;oBACxB,UAAU,EAAE;wBACV,gBAAgB,EAAE,oBAAoB;wBACtC,sBAAsB,EAAE,IAAI;wBAC5B,4BAA4B,EAAE,GAAG,CAAC,YAAY;qBAC/C;oBACD,MAAM,EAAE,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;iBACvB,CAAC,CAAC;gBACH,QAAQ,CAAC,QAAQ,GAAG;oBAClB,GAAG,QAAQ,CAAC,QAAQ;oBACpB,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE;iBACvD,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,8CAA8C,GAAG,CAAC,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1H,IAAI,MAAM;gBAAE,MAAM,GAAG,CAAC;YACtB,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harnesses/engine/persistence.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Harness engine — SQLite persistence helpers.
+ *
+ * §6.4 of spec/2026-04-17-portfolio-v0-design.md
+ *
+ * Wraps the Store's underlying Database instance via the Store class — the
+ * Store itself holds the DB handle; we extend it with engine-specific queries.
+ * To keep concerns clean, this module exports a standalone `TaskRunPersistence`
+ * class that is constructed with a `Database` instance (passed from Store).
+ */
+import type Database from 'better-sqlite3';
+import { type TaskRunState } from './state.js';
+import type { Task } from '../../types/task.js';
+/**
+ * Thrown by `transition()` and `markFailed()` when the DB row has already been
+ * updated by a concurrent call before the UPDATE could land.
+ *
+ * Callers should treat this as a signal to retry from the fresh DB state or
+ * abandon the operation (the concurrent call has already advanced the task).
+ */
+export declare class ConcurrentTransitionError extends Error {
+    readonly requestId: string;
+    readonly expectedState: TaskRunState;
+    readonly attemptedNewState: string;
+    constructor(requestId: string, expectedState: TaskRunState, attemptedNewState: string);
+}
+export declare const TASK_RUNS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS task_runs (\n  request_id              TEXT PRIMARY KEY,\n  task_id                 TEXT,\n  attempt_index           INTEGER,\n  task_cid              TEXT NOT NULL,\n  onchain_creation_tx     TEXT NOT NULL,\n  onchain_creation_block  INTEGER NOT NULL,\n  solver_type               TEXT,\n  task_role             TEXT,     -- 'restoration' | 'evaluation' | NULL (legacy)\n  impl_name               TEXT,\n\n  state                   TEXT NOT NULL,\n  state_updated_at        INTEGER NOT NULL,\n\n  working_dir             TEXT,\n  impl_state_dir          TEXT,\n\n  window_start_ts         INTEGER NOT NULL,\n  window_end_ts           INTEGER NOT NULL,\n\n  pre_snapshot_captured_at  INTEGER,\n  pre_snapshot_payload      TEXT,\n  post_snapshot_captured_at INTEGER,\n  post_snapshot_payload     TEXT,\n  fills_payload             TEXT,\n  gating_claim              TEXT,\n  informational_claim       TEXT,\n\n  artifact_cids           TEXT,\n  manifest_cid            TEXT,\n  delivery_tx_hash        TEXT,\n\n  -- Additive columns (schema migration 2026-04-17):\n  -- manifest_generated_at: persisted once at first PACKAGING entry; reused on\n  --   retry to keep manifest CID deterministic (idempotent PACKAGING).\n  -- evidence_hash: keccak256 of the signed manifest canonical JSON; dedicated\n  --   column replaces the former _evidenceHash stash in informational_claim.\n  manifest_generated_at   INTEGER,\n  evidence_hash           TEXT,\n\n  -- Additive column (schema migration 2026-04-17, full Task threading):\n  -- task_payload: full Task JSON, captured at observe() time.\n  -- NULL for pre-migration rows (legacy fallback in engine consumers).\n  task_payload   TEXT,\n\n  -- Additive column (added by WT-C for PACKAGING recovery fidelity):\n  -- solution_outputs_json: serialised Solution persisted before the\n  --   RUNNING \u2192 PACKAGING transition. Enables pack() to recover solution outputs\n  --   after a crash without re-executing the impl. NULL once pack() succeeds.\n  solution_outputs_json       TEXT,\n  runtime_plugins_json        TEXT,\n\n  -- Additive columns for ERC-8004 payload v2 (jinn-mono-9fe5):\n  --   executor_mode: 'train' | 'frozen', captured by pack() from the freeze-fence\n  --     and reused by deliver() to emit a payload v2 setMetadata.\n  --   executor_code_digest: sha256:<hex> form, same source.\n  -- NULL for pre-migration rows; deliver() falls back to the v1 encoder.\n  executor_mode               TEXT,\n  executor_code_digest        TEXT,\n\n  failure_reason          TEXT,\n  failure_at              INTEGER\n);\n\nCREATE INDEX IF NOT EXISTS idx_task_runs_state\n  ON task_runs(state);\n\nCREATE INDEX IF NOT EXISTS idx_task_runs_window_start_ts\n  ON task_runs(window_start_ts);\n";
+/** Input when first observing an task from an on-chain event. */
+export interface PersistedTaskRunInput {
+    requestId: string;
+    taskId?: string;
+    attemptIndex?: number;
+    taskCid: string;
+    onchainCreationTx: string;
+    onchainCreationBlock: number;
+    solverType?: string;
+    /** 'restoration' (default) or 'evaluation'. Captured from Task.type at observe() time. */
+    taskRole?: 'restoration' | 'evaluation';
+    windowStartTs: number;
+    windowEndTs: number;
+    /**
+     * Full Task payload, captured at observe() time.
+     * Required: production callers always thread it (daemon.ts); making this
+     * required provides a type-level guarantee against silent regression to the
+     * stub path. Tests that need to exercise the pre-migration NULL row path
+     * must use a direct raw SQL INSERT.
+     */
+    task: Task;
+}
+/** Full persisted task row (all columns). */
+export interface PersistedTaskRun {
+    requestId: string;
+    taskId: string | null;
+    attemptIndex: number | null;
+    taskCid: string;
+    onchainCreationTx: string;
+    onchainCreationBlock: number;
+    solverType: string | null;
+    taskRole: 'restoration' | 'evaluation' | null;
+    implName: string | null;
+    state: TaskRunState;
+    stateUpdatedAt: number;
+    workingDir: string | null;
+    implStateDir: string | null;
+    windowStartTs: number;
+    windowEndTs: number;
+    preSnapshotCapturedAt: number | null;
+    preSnapshotPayload: unknown | null;
+    postSnapshotCapturedAt: number | null;
+    postSnapshotPayload: unknown | null;
+    fillsPayload: unknown[] | null;
+    gatingClaim: Record<string, unknown> | null;
+    informationalClaim: Record<string, unknown> | null;
+    artifactCids: Record<string, string> | null;
+    manifestCid: string | null;
+    deliveryTxHash: string | null;
+    /** Persisted once at first PACKAGING entry; reused on retry for manifest CID determinism. */
+    manifestGeneratedAt: number | null;
+    /** keccak256 of signed manifest canonical JSON; used by deliver() as evidenceHash. */
+    evidenceHash: string | null;
+    /** Full Task payload as recorded at observe() time; null for pre-migration rows. */
+    task: Task | null;
+    /**
+     * Serialised Solution from runImpl, persisted before the
+     * RUNNING → PACKAGING transition. Used by pack() to recover solution outputs
+     * after a crash so the manifest CID remains deterministic. Null for
+     * pre-migration rows and tasks that have already been packed.
+     * Added by WT-C for PACKAGING recovery fidelity.
+     */
+    solutionOutputsJson: string | null;
+    runtimePluginsJson: string | null;
+    /**
+     * Executor mode declared on this run ('train' | 'frozen').
+     * Captured by `pack()` from the freeze-fence's HarnessExecutionMode and
+     * read by `deliver()` to emit a payload v2 setMetadata. Null for legacy
+     * rows that completed before payload v2 wiring (deliver() defaults to v1).
+     */
+    executorMode: 'train' | 'frozen' | null;
+    /**
+     * Executor codeDigest (`sha256:<hex>` form) declared on this run.
+     * Captured by `pack()` from the freeze-fence and read by `deliver()` for
+     * payload v2 setMetadata. Null for legacy rows; deliver() defaults to v1.
+     */
+    executorCodeDigest: string | null;
+    failureReason: string | null;
+    failureAt: number | null;
+}
+/**
+ * Fields that can be patched during a transition.
+ * Only lists fields that `transition()` actually writes — attempting to patch
+ * other fields (e.g. `solverType`, window timestamps) gives a compile-time error
+ * instead of silently dropping the value.
+ */
+export type TaskRunPatch = Partial<{
+    implName: string | null;
+    workingDir: string | null;
+    implStateDir: string | null;
+    preSnapshotCapturedAt: number | null;
+    preSnapshotPayload: unknown;
+    postSnapshotCapturedAt: number | null;
+    postSnapshotPayload: unknown;
+    fillsPayload: unknown;
+    gatingClaim: unknown;
+    informationalClaim: unknown;
+    artifactCids: Record<string, string> | null;
+    manifestCid: string | null;
+    deliveryTxHash: string | null;
+    /** Persisted once at first PACKAGING entry; reused on retry. */
+    manifestGeneratedAt: number | null;
+    /** keccak256 of signed manifest canonical JSON (evidenceHash for claimDelivery). */
+    evidenceHash: string | null;
+    /**
+     * Serialised Solution JSON, persisted before RUNNING → PACKAGING.
+     * Enables pack() to recover solution outputs after a crash without re-executing
+     * the impl. Set by engine.runImpl(); cleared by engine after successful pack().
+     * Added by WT-C for PACKAGING recovery fidelity.
+     */
+    solutionOutputsJson: string | null;
+    runtimePluginsJson: string | null;
+    /** Executor mode captured from freeze-fence. Reused by deliver() for v2 setMetadata. */
+    executorMode: 'train' | 'frozen' | null;
+    /** Executor codeDigest captured from freeze-fence. Reused by deliver() for v2 setMetadata. */
+    executorCodeDigest: string | null;
+}>;
+/**
+ * Low-level CRUD helpers for `task_runs`.
+ *
+ * Constructed with the raw better-sqlite3 `Database` instance. The `Store`
+ * class exposes it via `store.db` — callers that have a `Store` can pass
+ * `store.db` here.
+ */
+export declare class TaskRunPersistence {
+    private readonly db;
+    constructor(db: Database.Database);
+    /**
+     * Insert a DISCOVERED task row. Idempotent: if a row with the same
+     * `requestId` already exists, this is a no-op (INSERT OR IGNORE).
+     */
+    insertDiscovered(input: PersistedTaskRunInput): void;
+    /**
+     * Transition an task to a new state. Validates the transition and writes
+     * the new state + optional patch fields atomically (persist-before-invoke).
+     */
+    transition(requestId: string, toState: TaskRunState, patch?: TaskRunPatch): void;
+    /** Fetch a single task by request ID. Returns null if not found. */
+    getByRequestId(requestId: string): PersistedTaskRun | null;
+    /**
+     * Fetch a single task by request ID. Throws if not found.
+     * Use this in code paths where the task is guaranteed to exist
+     * (e.g. immediately after a successful `transition()` call).
+     */
+    getOrThrow(requestId: string): PersistedTaskRun;
+    /** Fetch all tasks in a given state. */
+    getByState(state: TaskRunState): PersistedTaskRun[];
+    /** Fetch all in-flight tasks (not in any terminal state). */
+    getInFlight(): PersistedTaskRun[];
+    hasInFlightFor(args: {
+        solverType: string;
+        taskRole: 'restoration' | 'evaluation';
+        excludeRequestId?: string;
+    }): boolean;
+    /**
+     * Persist `deliveryTxHash` without triggering a state transition (state
+     * remains DELIVERING). Called after deliverToMarketplace lands on-chain but
+     * before claimDelivery runs, so that a crash between the two steps can be
+     * recovered without re-submitting the deliver transaction.
+     */
+    setDeliveryTxHash(requestId: string, deliveryTxHash: string): void;
+    /**
+     * Persist `manifestGeneratedAt` for the first time without triggering a
+     * state transition. Used by pack() to lock in the generatedAt timestamp
+     * before assembling the manifest, ensuring idempotent CID on retry.
+     * No-op if already set.
+     */
+    setManifestGeneratedAt(requestId: string, generatedAt: number): void;
+    /** Mark an task FAILED with a reason (valid from any non-terminal state). */
+    markFailed(requestId: string, reason: string): void;
+}