@jinn-network/client 0.1.9 → 0.2.0

package/dist/solver-types/_swe-rebench-v2-harvest-state.js

@@ -0,0 +1,349 @@
+/**
+ * Durable commit-echo harvest state.
+ *
+ * The v2 file separates repository discovery cursors from independently
+ * resumable build/task jobs.  A candidate is written as a job in the same
+ * atomic file update that advances the cursor, so a process crash can create
+ * at worst a duplicate discovery attempt, never a lost commit.
+ */
+import { createHash } from 'node:crypto';
+import { readFile, writeFile, mkdir, rename } from 'node:fs/promises';
+import { join, resolve as resolvePath } from 'node:path';
+import { canonicalJson } from '../harnesses/engine/canonical-json.js';
+const HARVEST_STATE_FILE = 'harvest-state.json';
+const SCHEMA_VERSION_V1 = 'swe-rebench-v2-harvest-state.v1';
+const SCHEMA_VERSION = 'swe-rebench-v2-harvest-state.v2';
+export const MAX_HARVEST_INFRA_RETRIES = 3;
+/** Stable awaiting-input reason prefixes used to decide safe requeue policy. */
+export const AWAITING_RECIPE_REQUIRED = 'awaiting_input:recipe-required';
+export const AWAITING_RECIPE_BINDING_MISMATCH = 'awaiting_input:recipe-binding-mismatch';
+export const AWAITING_TEST_PATCH_REQUIRED = 'awaiting_input:test-patch-required';
+export const AWAITING_TARGETED_TEST_COMMAND_REQUIRED = 'awaiting_input:unsupported-test-targeting';
+/** A local receipt exists, but no public CID may be invented during --no-post harvesting. */
+export const AWAITING_RECEIPT_PUBLICATION_REQUIRED = 'awaiting_input:receipt-publication-required';
+export function isRecipeAwaitingReason(reason) {
+    return Boolean(reason?.startsWith(`${AWAITING_RECIPE_REQUIRED}:`) ||
+        reason?.startsWith(`${AWAITING_RECIPE_BINDING_MISMATCH}:`) ||
+        reason?.startsWith(`${AWAITING_TARGETED_TEST_COMMAND_REQUIRED}:`));
+}
+function isReceiptPublicationAwaitingReason(reason) {
+    return Boolean(reason?.startsWith(`${AWAITING_RECEIPT_PUBLICATION_REQUIRED}:`));
+}
+export function harvestTaskKey(repo, fixCommit) {
+    return `task:${repo}@${fixCommit}`;
+}
+export function harvestBuildKey(repo, baseCommit, recipeHash, platform) {
+    return `build:${repo}@${baseCommit}:${recipeHash}:${platform}`;
+}
+export function empiricalEvidenceKey(binding) {
+    return `sha256:${createHash('sha256').update(canonicalJson(binding)).digest('hex')}`;
+}
+/** Classify a failed step without mistaking missing operator input for denial. */
+export function classifyHarvestFailure(reason) {
+    const normalized = reason.toLowerCase();
+    if (/\b(private|denied|license|rights|policy|forbidden)\b/.test(normalized))
+        return 'terminal_policy';
+    if (/\b(awaiting_input|unsupported|unconfigured|no admitted source|no trusted recipe)\b/.test(normalized)) {
+        return 'awaiting_input';
+    }
+    if (/\b(flaky|non-reproducible|nonreproducible|empirical-dead|gold-patch-not-resolved|weak-suite)\b/.test(normalized))
+        return 'quarantined';
+    return 'retrying';
+}
+function isV1(raw) {
+    return typeof raw === 'object' && raw !== null &&
+        raw.schemaVersion === SCHEMA_VERSION_V1 &&
+        typeof raw.repos === 'object' && raw.repos !== null;
+}
+function isV2(raw) {
+    return typeof raw === 'object' && raw !== null &&
+        raw.schemaVersion === SCHEMA_VERSION &&
+        typeof raw.repos === 'object' && raw.repos !== null &&
+        typeof raw.jobs === 'object' && raw.jobs !== null &&
+        typeof raw.empiricalEvidence === 'object' && raw.empiricalEvidence !== null;
+}
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export class HarvestStateStore {
+    file;
+    cache = null;
+    constructor(opts) {
+        this.file = resolvePath(join(opts.stateDir, HARVEST_STATE_FILE));
+    }
+    fresh() {
+        return {
+            schemaVersion: SCHEMA_VERSION,
+            updatedAt: new Date().toISOString(),
+            repos: {},
+            jobs: {},
+            empiricalEvidence: {},
+        };
+    }
+    migrateV1(file) {
+        return {
+            schemaVersion: SCHEMA_VERSION,
+            updatedAt: file.updatedAt,
+            repos: file.repos,
+            jobs: {},
+            empiricalEvidence: {},
+        };
+    }
+    async load() {
+        if (this.cache)
+            return this.cache;
+        try {
+            const raw = JSON.parse(await readFile(this.file, 'utf8'));
+            if (isV2(raw)) {
+                this.cache = raw;
+                return raw;
+            }
+            if (isV1(raw)) {
+                const migrated = this.migrateV1(raw);
+                await this.persist(migrated);
+                return migrated;
+            }
+        }
+        catch {
+            // missing local state starts clean; immutable published artifacts remain external.
+        }
+        this.cache = this.fresh();
+        return this.cache;
+    }
+    async persist(file) {
+        file.updatedAt = new Date().toISOString();
+        await mkdir(resolvePath(join(this.file, '..')), { recursive: true });
+        const tmp = `${this.file}.${process.pid}.${Date.now()}.tmp`;
+        await writeFile(tmp, `${JSON.stringify(file, null, 2)}\n`, 'utf8');
+        await rename(tmp, this.file);
+        this.cache = file;
+    }
+    async getRepo(repoKey) {
+        const file = await this.load();
+        return file.repos[repoKey] ? clone(file.repos[repoKey]) : null;
+    }
+    async setLastScannedCommit(repoKey, commit) {
+        const file = await this.load();
+        const prev = file.repos[repoKey] ?? { lastScannedCommit: '', rejected: {} };
+        file.repos[repoKey] = { ...prev, lastScannedCommit: commit };
+        await this.persist(file);
+    }
+    /** Compatibility shim for old callers; v2 callers should record a job disposition. */
+    async recordRejected(repoKey, instanceId, reason) {
+        const file = await this.load();
+        const prev = file.repos[repoKey] ?? { lastScannedCommit: '', rejected: {} };
+        prev.rejected[instanceId] = { reason, at: new Date().toISOString() };
+        file.repos[repoKey] = prev;
+        await this.persist(file);
+    }
+    isRejected(repoState, instanceId) {
+        return Boolean(repoState?.rejected[instanceId]);
+    }
+    /**
+     * Atomically write new task jobs before advancing a repo cursor. Existing
+     * task keys are preserved, making discovery idempotent after restart.
+     */
+    async persistDiscoveredJobs(args) {
+        const file = await this.load();
+        const now = new Date().toISOString();
+        const recipeHash = args.recipeHash ?? 'unconfigured';
+        const platform = args.platform ?? 'linux/amd64';
+        const created = [];
+        for (const candidate of args.candidates) {
+            const taskKey = harvestTaskKey(candidate.repo, candidate.fix_commit);
+            const existing = file.jobs[taskKey];
+            if (existing) {
+                created.push(clone(existing));
+                continue;
+            }
+            const job = {
+                taskKey,
+                buildKey: harvestBuildKey(candidate.repo, candidate.base_commit, recipeHash, platform),
+                repo: candidate.repo,
+                baseCommit: candidate.base_commit,
+                fixCommit: candidate.fix_commit,
+                recipeHash,
+                platform,
+                stage: 'discovered',
+                disposition: 'pending',
+                attempts: 0,
+                candidate: clone(candidate),
+                artifactRefs: {},
+                resourceUse: {},
+                createdAt: now,
+                updatedAt: now,
+            };
+            file.jobs[taskKey] = job;
+            created.push(clone(job));
+        }
+        const prev = file.repos[args.repo] ?? { lastScannedCommit: '', rejected: {} };
+        file.repos[args.repo] = { ...prev, lastScannedCommit: args.cursor };
+        await this.persist(file);
+        return created;
+    }
+    async getJob(taskKey) {
+        const file = await this.load();
+        return file.jobs[taskKey] ? clone(file.jobs[taskKey]) : null;
+    }
+    async getDueJobs(now = new Date()) {
+        const file = await this.load();
+        const current = now.getTime();
+        return Object.values(file.jobs)
+            .filter((job) => job.disposition === 'pending' || job.disposition === 'retrying')
+            .filter((job) => !job.nextAttemptAt || new Date(job.nextAttemptAt).getTime() <= current)
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.taskKey.localeCompare(b.taskKey))
+            .map(clone);
+    }
+    /**
+     * Re-open only awaiting-input jobs whose newly supplied trusted recipe
+     * explicitly claims them. This never revives policy/quarantine failures and
+     * leaves an incompatible configuration inert, preventing per-tick churn.
+     */
+    async resumeAwaitingInputJobs(args) {
+        const file = await this.load();
+        const platform = args.platform ?? 'linux/amd64';
+        const resumed = [];
+        for (const job of Object.values(file.jobs)) {
+            if (job.repo !== args.repo ||
+                job.disposition !== 'awaiting_input' ||
+                !isRecipeAwaitingReason(job.reason) ||
+                !args.predicate(clone(job)))
+                continue;
+            job.recipeHash = args.recipeHash;
+            job.platform = platform;
+            job.buildKey = harvestBuildKey(job.repo, job.baseCommit, args.recipeHash, platform);
+            job.stage = 'discovered';
+            job.disposition = 'pending';
+            job.reason = undefined;
+            job.nextAttemptAt = undefined;
+            job.updatedAt = new Date().toISOString();
+            resumed.push(clone(job));
+        }
+        if (resumed.length > 0)
+            await this.persist(file);
+        return resumed;
+    }
+    /**
+     * Re-open local receipt evidence only when this tick is allowed to publish.
+     * Its environment/receipt binding remains intact; only the terminal waiting
+     * disposition changes, so no empirical evidence is rerun just to acquire a
+     * CID.
+     */
+    async resumeAwaitingPublicationJobs(args) {
+        const file = await this.load();
+        const resumed = [];
+        for (const job of Object.values(file.jobs)) {
+            if (job.repo !== args.repo ||
+                job.recipeHash !== args.recipeHash ||
+                job.disposition !== 'awaiting_input' ||
+                !isReceiptPublicationAwaitingReason(job.reason) ||
+                !args.predicate(clone(job)))
+                continue;
+            job.disposition = 'pending';
+            job.reason = undefined;
+            job.nextAttemptAt = undefined;
+            job.updatedAt = new Date().toISOString();
+            resumed.push(clone(job));
+        }
+        if (resumed.length > 0)
+            await this.persist(file);
+        return resumed;
+    }
+    /**
+     * A retried job may receive a different explicit recipe for the same base
+     * commit. Its old checkpoint bindings must not cross that boundary: retain
+     * the task key, but start a fresh environment chain under the new build key.
+     */
+    async rebindJobRecipe(args) {
+        const file = await this.load();
+        const job = file.jobs[args.taskKey];
+        if (!job)
+            throw new Error(`unknown harvest job ${args.taskKey}`);
+        const platform = args.platform ?? 'linux/amd64';
+        job.recipeHash = args.recipeHash;
+        job.platform = platform;
+        job.buildKey = harvestBuildKey(job.repo, job.baseCommit, args.recipeHash, platform);
+        job.stage = 'discovered';
+        job.artifactRefs = {};
+        job.resourceUse = {};
+        job.reason = undefined;
+        job.nextAttemptAt = undefined;
+        job.updatedAt = new Date().toISOString();
+        await this.persist(file);
+        return clone(job);
+    }
+    async updateJob(taskKey, update) {
+        const file = await this.load();
+        const job = file.jobs[taskKey];
+        if (!job)
+            throw new Error(`unknown harvest job ${taskKey}`);
+        if (update.stage)
+            job.stage = update.stage;
+        if (update.artifactRefs)
+            job.artifactRefs = { ...job.artifactRefs, ...update.artifactRefs };
+        if (update.resourceUse)
+            job.resourceUse = { ...job.resourceUse, ...update.resourceUse };
+        if (update.differentialAdmission)
+            job.differentialAdmission = clone(update.differentialAdmission);
+        if (update.reason !== undefined)
+            job.reason = update.reason;
+        if (update.nextAttemptAt !== undefined)
+            job.nextAttemptAt = update.nextAttemptAt;
+        job.updatedAt = new Date().toISOString();
+        await this.persist(file);
+        return clone(job);
+    }
+    async markJobAdmitted(taskKey) {
+        const file = await this.load();
+        const job = file.jobs[taskKey];
+        if (!job)
+            throw new Error(`unknown harvest job ${taskKey}`);
+        job.stage = 'complete';
+        job.disposition = 'admitted';
+        job.nextAttemptAt = undefined;
+        job.updatedAt = new Date().toISOString();
+        await this.persist(file);
+        return clone(job);
+    }
+    async markJobFailure(taskKey, reason, opts = {}) {
+        const file = await this.load();
+        const job = file.jobs[taskKey];
+        if (!job)
+            throw new Error(`unknown harvest job ${taskKey}`);
+        const classified = classifyHarvestFailure(reason);
+        job.reason = reason;
+        job.updatedAt = (opts.now ?? new Date()).toISOString();
+        if (classified === 'retrying') {
+            job.attempts += 1;
+            if (job.attempts >= MAX_HARVEST_INFRA_RETRIES) {
+                job.disposition = 'failed_infrastructure';
+                job.nextAttemptAt = undefined;
+            }
+            else {
+                job.disposition = 'retrying';
+                const delay = opts.retryDelayMs ?? 60_000;
+                job.nextAttemptAt = new Date((opts.now ?? new Date()).getTime() + delay).toISOString();
+            }
+        }
+        else {
+            job.disposition = classified;
+            job.nextAttemptAt = undefined;
+        }
+        await this.persist(file);
+        return clone(job);
+    }
+    async getEmpiricalEvidence(binding) {
+        const file = await this.load();
+        const evidence = file.empiricalEvidence[empiricalEvidenceKey(binding)];
+        if (!evidence || canonicalJson(evidence.binding) !== canonicalJson(binding))
+            return null;
+        return clone(evidence);
+    }
+    async recordEmpiricalEvidence(evidence) {
+        const file = await this.load();
+        const key = empiricalEvidenceKey(evidence.binding);
+        file.empiricalEvidence[key] = clone(evidence);
+        await this.persist(file);
+    }
+}
+//# sourceMappingURL=_swe-rebench-v2-harvest-state.js.map

package/dist/solver-types/_swe-rebench-v2-harvest-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_swe-rebench-v2-harvest-state.js","sourceRoot":"","sources":["../../src/solver-types/_swe-rebench-v2-harvest-state.ts"],"names":[],"mappings":"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"}

package/dist/solver-types/_swe-rebench-v2-harvest.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Commit-echo harvest orchestration — source-instance mapping, empirical tests,
+ * mint pipeline feed. Spec §5.2.
+ */
+import type { PoolTask } from './_swe-rebench-v2-pool.js';
+import type { CommitEchoCandidate } from './_swe-rebench-v2-commit-echo.js';
+import { type MintedEnvironmentBindingV1, type MintedProvenance } from './_swe-rebench-v2-minted-pool.js';
+import type { MineableTraceRecord } from './_swe-rebench-v2-mineable-store-port.js';
+import type { EvalRunner, HfFetcher, HfRow } from '../harnesses/impls/swe-rebench-v2-evaluator/index.js';
+import { type EmpiricalTestDerivationResult } from './_swe-rebench-v2-empirical-tests.js';
+import { runMintTasksPipeline, type DifferentialAdmissionReceiptCandidateV2, type MintTasksInput } from './_swe-rebench-v2-mint-cli.js';
+import { ValidatedPoolStore } from './_swe-rebench-v2-validated-pool.js';
+import { MintedPoolStore, type SweRebenchV2MintedPoolArtifact } from './_swe-rebench-v2-minted-pool.js';
+import type { PublicRepoChecker } from './_swe-rebench-v2-guards.js';
+import type { MintedEnvironmentVerifier } from './_swe-rebench-v2-minted-environment-verifier.js';
+import { type EnvironmentBuildRecipeV1, type CommandSpec } from '../task-creator/environment/contracts.js';
+import { type BoundEmpiricalEvidenceBindingV1, type BoundEmpiricalEvidenceV1, type DifferentialAdmissionEvidenceV2 } from './_swe-rebench-v2-harvest-state.js';
+export declare const MINTED_DATASET_PLACEHOLDER: "ipfs://local-minted-pending";
+export declare function commitEchoLineageHash(repo: string, fixCommit: string): string;
+export declare function findSourceInstanceForRepo(pool: PoolTask[], scorableIds: Set<string>, repo: string): PoolTask | null;
+export interface BuiltMintCandidate {
+    poolTask: PoolTask;
+    goldPatch: string;
+    provenance: MintedProvenance;
+    row: HfRow;
+    /** Selects the v2 minted-pool artifact contract when present. */
+    environment?: MintedEnvironmentBindingV1;
+    /** Public fix identity paired with hardened differential evidence. */
+    fixCommit?: string;
+    /** Repeated path-scoped causal evidence required by a hardened v2 admission. */
+    differentialAdmission?: DifferentialAdmissionReceiptCandidateV2;
+}
+/** An operator-approved recipe and its already-published evaluator binding. */
+export interface ExplicitRecipeBootstrap {
+    recipe: EnvironmentBuildRecipeV1;
+    environment: MintedEnvironmentBindingV1;
+}
+/** Runtime parse for an operator-provided config entry. */
+export declare function parseExplicitRecipeBootstrap(raw: unknown): ExplicitRecipeBootstrap;
+export interface EmpiricalEvidenceStore {
+    getEmpiricalEvidence(binding: BoundEmpiricalEvidenceBindingV1): Promise<BoundEmpiricalEvidenceV1 | null>;
+    recordEmpiricalEvidence(evidence: BoundEmpiricalEvidenceV1): Promise<void>;
+}
+/** Serialise a trusted structured recipe command only at the evaluator edge. */
+export declare function commandSpecToEvaluatorCommand(command: CommandSpec): string;
+export declare function explicitRecipeBootstrapError(candidate: CommitEchoCandidate, bootstrap: ExplicitRecipeBootstrap): string | null;
+export declare function buildCommitEchoMintCandidate(args: {
+    candidate: CommitEchoCandidate;
+    /** Legacy Rebench source backing; omitted for explicit trusted recipes. */
+    source?: PoolTask;
+    explicitRecipe?: ExplicitRecipeBootstrap;
+    fetcher: HfFetcher;
+    runner: EvalRunner;
+    minterSafe?: string;
+    empiricalEvidenceStore?: EmpiricalEvidenceStore;
+    /** A persisted hardened receipt may resume; legacy V1 observations cannot. */
+    differentialAdmissionEvidence?: DifferentialAdmissionEvidenceV2;
+}): Promise<{
+    built: BuiltMintCandidate | null;
+    reason?: string;
+    empirical?: EmpiricalTestDerivationResult;
+}>;
+/**
+ * Session-echo instance id — blinded (spec §7): derived only from the repo
+ * slug and the FULL {@link lineageHash} of the session's opaque local
+ * `sourceId`, never the `sourceId` itself. `<repo-slug>__session-<hash12>`.
+ */
+export declare function sessionEchoInstanceId(repo: string, sourceId: string): string;
+/**
+ * Session-echo mint candidate — sibling of {@link buildCommitEchoMintCandidate}.
+ * v0 session-echo mints the record's whole `acceptedDiff` as gold at the
+ * record's true `repo @ baseCommit` (one candidate per record; hunk-subset
+ * echo is deferred — `base ⊕ S ⊖ H` isn't representable as a swe-rebench row).
+ * `source` borrows eval infra (image, install config, test framework) from an
+ * already-admitted instance in the same repo — it plays no role in naming or
+ * provenance, so nothing about the session's origin leaks through it.
+ */
+export declare function buildSessionEchoMintCandidate(args: {
+    record: MineableTraceRecord;
+    source: PoolTask;
+    fetcher: HfFetcher;
+    runner: EvalRunner;
+    minterSafe?: string;
+    /** Recording operator's Safe — stamped as `sourceSolverSafe` so
+     *  `syntheticClaimBlocked` refuses that operator's own claim (§7). */
+    operatorSafe?: string;
+}): Promise<{
+    built: BuiltMintCandidate | null;
+    reason?: string;
+    empirical?: EmpiricalTestDerivationResult;
+}>;
+export declare function inMemoryMintedArtifactFetcher(rows: Map<string, HfRow>): (cid: string) => Promise<SweRebenchV2MintedPoolArtifact>;
+export interface HarvestMintDeps {
+    stateDir: string;
+    ipfsRegistryUrl: string;
+    ipfsGatewayUrl: string;
+    validatedStore: ValidatedPoolStore;
+    mintedStore: MintedPoolStore;
+    hfFetcher: HfFetcher;
+    runner: EvalRunner;
+    upstreamRepoDir: string;
+    publicRepoChecker: PublicRepoChecker;
+    /** Optional test/operator seam for v2 signed environment-spec admission. */
+    environmentVerifier?: MintedEnvironmentVerifier;
+    minterSafe?: string;
+    publish?: boolean;
+    progress?: MintTasksInput['progress'];
+    withPublicationAuthorization?: MintTasksInput['withPublicationAuthorization'];
+}
+export declare function admitBuiltMintCandidates(built: BuiltMintCandidate[], deps: HarvestMintDeps): Promise<Awaited<ReturnType<typeof runMintTasksPipeline>>>;
+export declare function escrowInputsFromPatch(goldPatch: string, failToPass: string[]): {
+    loc: number;
+    files: number;
+    tests: number;
+};
+export declare const DEFAULT_SYNTHETIC_ESCROW_PARAMS: {
+    readonly alpha: 0.5;
+    readonly beta: 0.3;
+    readonly gamma: 0.2;
+    readonly loc_normalizer: 100;
+    readonly files_normalizer: 5;
+    readonly tests_normalizer: 10;
+};