@poetic-ai/poetic 1.42.0

package/dist/chunk-2IUXIGQD.js

@@ -0,0 +1,1064 @@
+import {
+  resolveInitiatedBy
+} from "./chunk-6V7HGQFZ.js";
+import {
+  sanitizeSynthesisArtifactForPersistence,
+  sanitizeSynthesisStringForPersistence
+} from "./chunk-GG6KJYW6.js";
+import {
+  COMPLETENESS_VALIDATION_THRESHOLD
+} from "./chunk-6EQKFDBH.js";
+import {
+  normalizeProviderCliVersion
+} from "./chunk-XZYR5EDO.js";
+import {
+  deriveVariantOutcome,
+  repairOutcomeCanSupersedeRawTouchedFailure
+} from "./chunk-ATVKCSGT.js";
+import {
+  canonicalizeVariantIdentifier,
+  formatVariantIdentifier,
+  formatVariantIdentifierFromResult,
+  parseVariantIdentifier
+} from "./chunk-CP7H3HSP.js";
+import {
+  assertSafePathComponent
+} from "./chunk-S2VQCZO4.js";
+import {
+  parseJsonWithContext
+} from "./chunk-QVZMFDYG.js";
+import {
+  redactPersistedTestsExecuted
+} from "./chunk-6Y5U7UFY.js";
+import {
+  LabPathResolver
+} from "./chunk-7GDRQBQC.js";
+import {
+  getExecutionContext
+} from "./chunk-UI2F6DJ5.js";
+import {
+  resolvePoeticRoot
+} from "./chunk-LEIIWPWQ.js";
+
+// src/orchestrator/competition-handle.ts
+import { randomUUID } from "crypto";
+import * as fs from "fs";
+import * as path from "path";
+var TERMINAL_EVALUATION_STATUSES = /* @__PURE__ */ new Set(["completed", "failed"]);
+var _seqCounters = /* @__PURE__ */ new Map();
+function readExistingMaxSeq(eventsPath) {
+  try {
+    if (!fs.existsSync(eventsPath)) return -1;
+    const raw = fs.readFileSync(eventsPath, "utf8");
+    let max = -1;
+    for (const line of raw.split(/\r?\n/)) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed.seq === "number" && Number.isFinite(parsed.seq)) {
+          max = Math.max(max, Math.floor(parsed.seq));
+        }
+      } catch {
+      }
+    }
+    return max;
+  } catch {
+    return -1;
+  }
+}
+function nextSeq(taskId, eventsPath) {
+  let prev = _seqCounters.get(taskId);
+  if (prev === void 0) {
+    prev = readExistingMaxSeq(eventsPath);
+  }
+  const next = prev + 1;
+  _seqCounters.set(taskId, next);
+  return next;
+}
+function sanitizeDiagnosticValue(value, depth = 0) {
+  if (depth > 4) return "[truncated]";
+  if (value == null) return value;
+  if (typeof value === "string") return sanitizeSynthesisStringForPersistence(value);
+  if (typeof value === "number" || typeof value === "boolean") return value;
+  if (Array.isArray(value)) {
+    return value.slice(0, 50).map((entry) => sanitizeDiagnosticValue(entry, depth + 1));
+  }
+  if (value instanceof Error) {
+    const details = {
+      name: sanitizeSynthesisStringForPersistence(value.name),
+      message: sanitizeSynthesisStringForPersistence(value.message)
+    };
+    if (typeof value.stack === "string") {
+      details.stack = sanitizeSynthesisStringForPersistence(value.stack);
+    }
+    return details;
+  }
+  if (typeof value === "object") {
+    const details = {};
+    for (const [key, entry] of Object.entries(value).slice(0, 100)) {
+      const keyAwareValue = sanitizeSynthesisArtifactForPersistence({ [key]: entry });
+      details[key] = keyAwareValue[key] ?? sanitizeDiagnosticValue(entry, depth + 1);
+    }
+    return details;
+  }
+  return sanitizeSynthesisStringForPersistence(String(value));
+}
+function sanitizeHandlePrompt(prompt) {
+  return sanitizeSynthesisStringForPersistence(prompt ?? "");
+}
+function sanitizeHandleErrorMessage(message) {
+  return typeof message === "string" ? sanitizeSynthesisStringForPersistence(message) : void 0;
+}
+var COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_SCORER_ID = "competition-handle-persistence-composite";
+var COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_SCORER_VERSION = "1.0.0";
+var COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_VALIDATION_THRESHOLD = {
+  authority: "core.validation.completeness.competition-handle-persistence-composite",
+  owner: COMPLETENESS_VALIDATION_THRESHOLD.owner,
+  minimumAcceptableScore: COMPLETENESS_VALIDATION_THRESHOLD.minimumAcceptableScore
+};
+var PERSISTENCE_FAIL_CLOSED_EVIDENCE_PROVENANCE = "persistence-fail-closed";
+function failClosedUnderPersistenceComposite(base) {
+  return {
+    score: 0,
+    scorerId: COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_SCORER_ID,
+    scorerVersion: COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_SCORER_VERSION,
+    evidenceProvenance: PERSISTENCE_FAIL_CLOSED_EVIDENCE_PROVENANCE,
+    ok: false,
+    breakdown: base.breakdown,
+    threshold: {
+      authority: COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_VALIDATION_THRESHOLD.authority,
+      value: COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_VALIDATION_THRESHOLD.minimumAcceptableScore
+    },
+    components: [base]
+  };
+}
+function normalizePersistedCompletenessPair(completeness, completenessAssessment) {
+  if (completenessAssessment == null) {
+    return { completeness, completenessAssessment: void 0 };
+  }
+  const rawScore = completenessAssessment.score;
+  const scoreInRange = typeof rawScore === "number" && Number.isFinite(rawScore) && rawScore >= 0 && rawScore <= 100;
+  if (!scoreInRange || completenessAssessment.ok === false) {
+    if (completenessAssessment.scorerId === COMPETITION_HANDLE_PERSISTENCE_COMPOSITE_COMPLETENESS_SCORER_ID && completenessAssessment.score === 0 && completenessAssessment.ok === false) {
+      return {
+        completeness: 0,
+        completenessAssessment
+      };
+    }
+    const normalized = failClosedUnderPersistenceComposite(completenessAssessment);
+    return {
+      completeness: normalized.score,
+      completenessAssessment: normalized
+    };
+  }
+  return {
+    completeness: rawScore,
+    completenessAssessment
+  };
+}
+function extractErrorDetails(error) {
+  if (!error || typeof error !== "object" && !(error instanceof Error)) return void 0;
+  return sanitizeDiagnosticValue(error);
+}
+function getEventsPath(taskId) {
+  const safeTaskId = assertSafePathComponent(taskId, "evaluationId");
+  return path.join(getBaseDir(), `${safeTaskId}.events.jsonl`);
+}
+function sanitizeCompetitionEventData(data) {
+  const sanitized = sanitizeDiagnosticValue(data);
+  if (data.completenessAssessment != null && typeof data.completenessAssessment === "object") {
+    const pair = normalizePersistedCompletenessPair(
+      typeof data.completeness === "number" ? data.completeness : void 0,
+      data.completenessAssessment
+    );
+    sanitized.completeness = typeof pair.completeness === "number" && Number.isFinite(pair.completeness) ? pair.completeness : 0;
+    if (pair.completenessAssessment != null) {
+      sanitized.completenessAssessment = sanitizeDiagnosticValue(pair.completenessAssessment);
+    }
+    return sanitized;
+  }
+  if (typeof data.completeness === "number" && Number.isFinite(data.completeness)) {
+    sanitized.completeness = data.completeness;
+  }
+  return sanitized;
+}
+function appendCompetitionEvent(taskId, event, data = {}) {
+  try {
+    const eventsPath = getEventsPath(taskId);
+    fs.mkdirSync(path.dirname(eventsPath), { recursive: true });
+    const record = {
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      seq: nextSeq(taskId, eventsPath),
+      taskId,
+      event,
+      data: sanitizeCompetitionEventData(data)
+    };
+    fs.appendFileSync(eventsPath, `${JSON.stringify(record)}
+`, "utf8");
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.debug(`[CompetitionHandle] event append failed for ${taskId}: ${msg}`);
+  }
+}
+function getBaseDir() {
+  const poeticDir = getExecutionContext().poeticDir ?? path.join(resolvePoeticRoot(process.cwd()), ".poetic");
+  const stateDir = LabPathResolver.getInstance().getStateDir(poeticDir);
+  return path.join(stateDir, "competitions");
+}
+function getHandlePath(taskId) {
+  const safeTaskId = assertSafePathComponent(taskId, "evaluationId");
+  return path.join(getBaseDir(), `${safeTaskId}.json`);
+}
+function atomicWrite(filePath, payload) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  let fd;
+  try {
+    fd = fs.openSync(tmp, "wx");
+    fs.writeFileSync(fd, payload, "utf8");
+    fs.fsyncSync(fd);
+    fs.closeSync(fd);
+    fd = void 0;
+    fs.renameSync(tmp, filePath);
+  } finally {
+    if (fd !== void 0) {
+      try {
+        fs.closeSync(fd);
+      } catch {
+      }
+    }
+    try {
+      fs.unlinkSync(tmp);
+    } catch {
+    }
+  }
+}
+var LOCK_RETRY_DELAY_MS = 25;
+function sleepSync(ms) {
+  if (ms <= 0) return;
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function readLockOwner(lockPath) {
+  try {
+    const raw = fs.readFileSync(lockPath, "utf8").trim();
+    if (!raw) return void 0;
+    if (/^\d+$/.test(raw)) {
+      return { pid: Number.parseInt(raw, 10) };
+    }
+    const parsed = JSON.parse(raw);
+    return {
+      pid: typeof parsed.pid === "number" && Number.isFinite(parsed.pid) ? parsed.pid : void 0,
+      token: typeof parsed.token === "string" ? parsed.token : void 0
+    };
+  } catch {
+    return void 0;
+  }
+}
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
+function tryAcquireLockOnce(lockPath, payload, staleMs, deadline) {
+  try {
+    fs.writeFileSync(lockPath, payload, { flag: "wx" });
+    return "acquired";
+  } catch (err) {
+    if (err.code !== "EEXIST") throw err;
+    try {
+      const stat = fs.statSync(lockPath);
+      const owner = readLockOwner(lockPath);
+      const ownerAlive = owner?.pid ? isPidAlive(owner.pid) : true;
+      const staleWithoutKnownOwner = !owner?.pid && Date.now() - stat.mtimeMs > staleMs;
+      if (!ownerAlive || staleWithoutKnownOwner) {
+        fs.unlinkSync(lockPath);
+        return "retry";
+      }
+    } catch {
+    }
+    if (Date.now() >= deadline) {
+      return "timeout";
+    }
+    return "wait";
+  }
+}
+function buildLockToken() {
+  const token = `${process.pid}:${randomUUID()}`;
+  return { token, payload: JSON.stringify({ pid: process.pid, token }) };
+}
+async function acquireLock(lockPath, staleMs = 3e4, timeoutMs = 5e3) {
+  const deadline = Date.now() + timeoutMs;
+  fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+  const { token, payload } = buildLockToken();
+  while (true) {
+    const attempt = tryAcquireLockOnce(lockPath, payload, staleMs, deadline);
+    if (attempt === "acquired") return token;
+    if (attempt === "timeout") return void 0;
+    if (attempt === "wait") {
+      await sleep(LOCK_RETRY_DELAY_MS);
+    }
+  }
+}
+function acquireLockSync(lockPath, staleMs = 3e4, timeoutMs = 5e3) {
+  const deadline = Date.now() + timeoutMs;
+  fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+  const { token, payload } = buildLockToken();
+  while (true) {
+    const attempt = tryAcquireLockOnce(lockPath, payload, staleMs, deadline);
+    if (attempt === "acquired") return token;
+    if (attempt === "timeout") return void 0;
+    if (attempt === "wait") {
+      sleepSync(LOCK_RETRY_DELAY_MS);
+    }
+  }
+}
+function releaseLock(lockPath, token) {
+  try {
+    const owner = readLockOwner(lockPath);
+    if (owner?.token !== token) {
+      return;
+    }
+    fs.unlinkSync(lockPath);
+  } catch {
+  }
+}
+function initEvaluationHandle(evaluationId, prompt, candidates, deliverableContract, runMetadata) {
+  const p = getHandlePath(evaluationId);
+  const lockPath = `${p}.lock`;
+  const lockToken = acquireLockSync(lockPath);
+  if (!lockToken) {
+    throw new Error(`Timed out waiting for init lock on ${evaluationId}`);
+  }
+  try {
+    initEvaluationHandleLocked(
+      evaluationId,
+      prompt,
+      candidates,
+      deliverableContract,
+      runMetadata,
+      p
+    );
+  } finally {
+    releaseLock(lockPath, lockToken);
+  }
+}
+async function initEvaluationHandleAsync(evaluationId, prompt, candidates, deliverableContract, runMetadata) {
+  const p = getHandlePath(evaluationId);
+  const lockPath = `${p}.lock`;
+  const lockToken = await acquireLock(lockPath);
+  if (!lockToken) {
+    throw new Error(`Timed out waiting for init lock on ${evaluationId}`);
+  }
+  try {
+    initEvaluationHandleLocked(
+      evaluationId,
+      prompt,
+      candidates,
+      deliverableContract,
+      runMetadata,
+      p
+    );
+  } finally {
+    releaseLock(lockPath, lockToken);
+  }
+}
+function initEvaluationHandleLocked(evaluationId, prompt, candidates, deliverableContract, runMetadata, handlePath) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const safePrompt = sanitizeHandlePrompt(prompt);
+  const labContext = LabPathResolver.getInstance().getContext();
+  const initialCandidates = candidates.map((c) => ({
+    provider: c.provider,
+    requestedProvider: c.requestedProvider,
+    strategy: c.strategy,
+    executionMode: c.executionMode,
+    model: c.model,
+    requestedModel: c.requestedModel,
+    failoverFromProvider: c.failoverFromProvider,
+    failoverReason: c.failoverReason,
+    workspaceMode: c.workspaceMode,
+    ...c.workspaceModeRequested !== void 0 ? { workspaceModeRequested: c.workspaceModeRequested } : {},
+    variant: formatVariantIdentifier(c),
+    reasoningEffort: c.modelReasoningEffort,
+    cursorPromptProfile: c.cursorPromptProfile,
+    variantInstanceId: c.variantInstanceId
+  }));
+  const handle = {
+    taskId: evaluationId,
+    evaluationId,
+    prompt: safePrompt,
+    initiatedBy: resolveInitiatedBy(),
+    createdAt: now,
+    updatedAt: now,
+    status: "running",
+    ...labContext ? { labId: labContext.labId, labRunId: labContext.runId } : {},
+    // Initialize candidate entries without results (populated during execution)
+    candidates: initialCandidates,
+    variants: initialCandidates,
+    // Store contract for downstream access (judges, gates, telemetry)
+    deliverableContract,
+    ...runMetadata ? { runMetadata } : {}
+  };
+  atomicWrite(handlePath, JSON.stringify(handle, null, 2));
+  appendCompetitionEvent(evaluationId, "competition.started", {
+    prompt: safePrompt,
+    candidateCount: initialCandidates.length,
+    candidates: initialCandidates.map((c) => ({
+      provider: c.provider,
+      strategy: c.strategy,
+      executionMode: c.executionMode,
+      variant: c.variant
+    }))
+  });
+}
+function warnHandleFailure(action, evaluationId, error) {
+  const msg = error instanceof Error ? error.message : String(error);
+  console.warn(`[CompetitionHandle] Failed to ${action} for ${evaluationId}: ${msg}`);
+}
+function updateEvaluationHandleWithResult(evaluationId, result) {
+  try {
+    const p = getHandlePath(evaluationId);
+    const lockPath = `${p}.lock`;
+    const lockToken = acquireLockSync(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for update lock on ${evaluationId}`);
+    }
+    try {
+      updateEvaluationHandleWithResultLocked(evaluationId, result, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("update handle", evaluationId, error);
+  }
+}
+async function updateEvaluationHandleWithResultAsync(evaluationId, result) {
+  try {
+    const p = getHandlePath(evaluationId);
+    const lockPath = `${p}.lock`;
+    const lockToken = await acquireLock(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for update lock on ${evaluationId}`);
+    }
+    try {
+      updateEvaluationHandleWithResultLocked(evaluationId, result, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("update handle", evaluationId, error);
+  }
+}
+function updateEvaluationHandleWithResultLocked(evaluationId, result, p) {
+  const raw = fs.existsSync(p) ? fs.readFileSync(p, "utf8") : "";
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  let handle;
+  if (raw) {
+    const parsed = parseJsonWithContext(raw, `Competition handle (${evaluationId})`);
+    if (parsed.status === "completed" || parsed.status === "failed") {
+      return;
+    }
+    handle = {
+      taskId: parsed.evaluationId || parsed.taskId || evaluationId,
+      evaluationId: parsed.evaluationId || parsed.taskId || evaluationId,
+      prompt: sanitizeHandlePrompt(parsed.prompt),
+      initiatedBy: parsed.initiatedBy,
+      createdAt: parsed.createdAt || now,
+      updatedAt: parsed.updatedAt || now,
+      status: parsed.status,
+      outcome: parsed.outcome,
+      completedAt: parsed.completedAt,
+      errorMessage: parsed.errorMessage,
+      winner: parsed.winner,
+      candidates: parsed.candidates || parsed.variants || [],
+      variants: parsed.variants || parsed.candidates || [],
+      labId: parsed.labId,
+      labRunId: parsed.labRunId,
+      runMetadata: parsed.runMetadata,
+      deliverableContract: parsed.deliverableContract,
+      synthesis: parsed.synthesis,
+      application: parsed.application,
+      verification: parsed.verification ?? parsed.winnerVerification
+    };
+  } else {
+    handle = {
+      taskId: evaluationId,
+      evaluationId,
+      createdAt: now,
+      updatedAt: now,
+      candidates: [],
+      variants: []
+    };
+  }
+  const resultWorkspaceMode = result.workspaceMode;
+  const resultWorkspaceModeRequestedRaw = result.workspaceModeRequested;
+  const resultWorkspaceModeIdentity = resultWorkspaceModeRequestedRaw ?? resultWorkspaceMode;
+  const resultReasoningEffort = parseVariantIdentifier(String(result.variant ?? "")).reasoningEffort ?? result.reasoningEffort;
+  const resultCursorPromptProfile = parseVariantIdentifier(String(result.variant ?? "")).cursorPromptProfile ?? result.cursorPromptProfile;
+  const resultVariantInstanceId = result.variantInstanceId;
+  const strictIdx = handle.candidates.findIndex(
+    (c) => c.provider === result.provider && c.strategy === result.strategy && c.executionMode === result.executionMode && strictIdentityFieldMatches(c.model, result.model) && strictIdentityFieldMatches(
+      c.workspaceModeRequested ?? c.workspaceMode,
+      resultWorkspaceModeIdentity
+    ) && strictIdentityFieldMatches(c.reasoningEffort, resultReasoningEffort) && strictIdentityFieldMatches(c.cursorPromptProfile, resultCursorPromptProfile) && strictIdentityFieldMatches(c.variantInstanceId, resultVariantInstanceId)
+  );
+  const idx = strictIdx >= 0 ? strictIdx : handle.candidates.findIndex(
+    (c) => c.provider === result.provider && c.strategy === result.strategy && c.executionMode === result.executionMode && strictIdentityFieldMatches(c.model, result.model) && lateBoundIdentityFieldMatches(
+      c.workspaceModeRequested ?? c.workspaceMode,
+      resultWorkspaceModeIdentity
+    ) && lateBoundIdentityFieldMatches(c.reasoningEffort, resultReasoningEffort) && lateBoundIdentityFieldMatches(c.cursorPromptProfile, resultCursorPromptProfile) && strictIdentityFieldMatches(c.variantInstanceId, resultVariantInstanceId)
+  );
+  const existingCandidate = idx >= 0 ? handle.candidates[idx] : void 0;
+  const resultWorkspaceModeRequested = resultWorkspaceModeRequestedRaw ?? existingCandidate?.workspaceModeRequested;
+  const resultPromptFingerprint = result.promptFingerprint ?? existingCandidate?.promptFingerprint;
+  const resultFinalPromptLength = result.finalPromptLength ?? existingCandidate?.finalPromptLength;
+  const resultVariant = typeof result.variant === "string" && result.variant.length > 0 ? formatVariantIdentifierFromResult(result) : existingCandidate?.variant;
+  const resultForOutcomeDerivation = result.isSynthesis === true ? { ...result, variant: resultVariant ?? result.variant } : (() => {
+    const { outcome: _staleOutcome, ...withoutOutcome } = result;
+    return { ...withoutOutcome, variant: resultVariant ?? result.variant };
+  })();
+  const derivedOutcome = result.isSynthesis === true && result.outcome ? result.outcome : deriveVariantOutcome(resultForOutcomeDerivation);
+  const outcomeVerification = derivedOutcome.verification;
+  const outcomeDelivery = derivedOutcome.delivery;
+  const resultHasChanges = result.hasChanges ?? outcomeDelivery.hasChanges ?? (typeof result.filesChanged === "number" ? result.filesChanged > 0 : void 0);
+  const { completeness: persistedCompleteness, completenessAssessment: persistedAssessment } = normalizePersistedCompletenessPair(result.completeness, result.completenessAssessment);
+  const patch = {
+    provider: result.provider,
+    requestedProvider: result.requestedProvider ?? existingCandidate?.requestedProvider,
+    strategy: result.strategy,
+    executionMode: result.executionMode,
+    model: result.model,
+    requestedModel: result.requestedModel ?? existingCandidate?.requestedModel,
+    failoverFromProvider: result.failoverFromProvider ?? existingCandidate?.failoverFromProvider,
+    failoverReason: result.failoverReason ?? existingCandidate?.failoverReason,
+    workspaceMode: resultWorkspaceMode,
+    ...resultWorkspaceModeRequested !== void 0 ? { workspaceModeRequested: resultWorkspaceModeRequested } : {},
+    ...resultVariant !== void 0 ? { variant: resultVariant } : {},
+    ...resultPromptFingerprint !== void 0 ? { promptFingerprint: resultPromptFingerprint } : {},
+    ...resultFinalPromptLength !== void 0 ? { finalPromptLength: resultFinalPromptLength } : {},
+    reasoningEffort: resultReasoningEffort ?? existingCandidate?.reasoningEffort,
+    cursorPromptProfile: resultCursorPromptProfile ?? existingCandidate?.cursorPromptProfile,
+    variantInstanceId: resultVariantInstanceId ?? existingCandidate?.variantInstanceId,
+    resolvedModel: result.resolvedModel,
+    providerCliVersion: normalizeProviderCliVersion(result.providerCliVersion),
+    submittedOnly: result.submittedOnly === true,
+    prNumber: result.prNumber,
+    prUrl: result.prUrl,
+    cloudTaskId: result.cloudTaskId,
+    success: result.success,
+    outcome: derivedOutcome,
+    retainedWorktreePath: result.retainedWorktreePath,
+    artifactPath: result.artifactPath,
+    completeness: persistedCompleteness,
+    completenessAssessment: persistedAssessment,
+    duration: result.duration,
+    errorMessage: sanitizeHandleErrorMessage(result.error?.message),
+    errorDetails: extractErrorDetails(result.error),
+    providerDiagnostics: result.providerDiagnostics ? sanitizeDiagnosticValue(
+      result.providerDiagnostics
+    ) : void 0,
+    authError: result.authError ? sanitizeDiagnosticValue(result.authError) : void 0,
+    timedOut: result.timedOut === true,
+    terminationReason: result.terminationReason,
+    inputSpecWarning: result.inputSpecWarning,
+    cursorMetadata: result.cursorMetadata,
+    contextInjection: result.contextInjection,
+    testsExecuted: redactPersistedTestsExecuted(result.testsExecuted),
+    buildStatus: result.buildStatus ?? outcomeVerification.buildStatus,
+    lintStatus: result.lintStatus ?? outcomeVerification.lintStatus,
+    // Candidate testStatus/filesChanged stay direct copies for legacy state readers.
+    testStatus: result.testStatus,
+    testMetrics: result.testMetrics,
+    judgeScore: result.judgeScore,
+    judgeEvaluation: result.judgeEvaluation,
+    artifactManifest: result.artifactManifest,
+    acceptedWorkspaceTreeSha: result.acceptedWorkspaceTreeSha,
+    gitMetrics: result.gitMetrics,
+    worktreeSummary: result.worktreeSummary,
+    ignoredPathEvidence: result.ignoredPathEvidence,
+    filesChanged: result.filesChanged,
+    hasChanges: resultHasChanges,
+    linesAdded: result.linesAdded,
+    linesRemoved: result.linesRemoved
+  };
+  if (idx >= 0) {
+    handle.candidates[idx] = { ...handle.candidates[idx], ...patch };
+  } else {
+    handle.candidates.push(patch);
+  }
+  handle.variants = handle.candidates;
+  handle.updatedAt = now;
+  atomicWrite(p, JSON.stringify(handle, null, 2));
+  const variantEventKind = result.success === true ? "variant.completed" : result.success === false || result.error ? "variant.failed" : "variant.completed";
+  appendCompetitionEvent(evaluationId, variantEventKind, {
+    provider: result.provider,
+    strategy: result.strategy,
+    executionMode: result.executionMode,
+    model: result.model,
+    variant: resultVariant,
+    success: result.success,
+    completeness: persistedCompleteness,
+    completenessAssessment: persistedAssessment,
+    duration: result.duration,
+    timedOut: result.timedOut,
+    errorMessage: sanitizeHandleErrorMessage(result.error?.message),
+    errorDetails: extractErrorDetails(result.error),
+    providerDiagnostics: result.providerDiagnostics ? sanitizeDiagnosticValue(result.providerDiagnostics) : void 0,
+    authError: result.authError ? sanitizeDiagnosticValue(result.authError) : void 0,
+    terminationReason: result.terminationReason
+  });
+}
+function strictIdentityFieldMatches(existing, incoming) {
+  return existing === incoming || existing === void 0 && incoming === void 0;
+}
+function lateBoundIdentityFieldMatches(existing, incoming) {
+  return existing === incoming || existing === void 0 || incoming === void 0;
+}
+function candidatesDescribeSameVariant(candidate, other) {
+  return candidate.provider === other.provider && candidate.strategy === other.strategy && candidate.executionMode === other.executionMode && strictIdentityFieldMatches(candidate.model, other.model) && lateBoundIdentityFieldMatches(candidate.workspaceMode, other.workspaceMode) && lateBoundIdentityFieldMatches(candidate.reasoningEffort, other.reasoningEffort) && lateBoundIdentityFieldMatches(candidate.cursorPromptProfile, other.cursorPromptProfile) && strictIdentityFieldMatches(candidate.variantInstanceId, other.variantInstanceId);
+}
+function candidateHasCompletedPeer(candidate, candidates) {
+  return candidates.some(
+    (other) => other !== candidate && other.success !== void 0 && candidatesDescribeSameVariant(candidate, other)
+  );
+}
+function canonicalizeHandleWinner(winner) {
+  if (winner == null) return winner;
+  const variantSeed = typeof winner.variant === "string" ? winner.variant.trim() : "";
+  if (!variantSeed) {
+    return winner;
+  }
+  return {
+    ...winner,
+    variant: canonicalizeVariantIdentifier({
+      variant: variantSeed,
+      provider: winner.provider,
+      model: winner.model,
+      resolvedModel: winner.resolvedModel,
+      strategy: winner.strategy,
+      executionMode: winner.executionMode
+    })
+  };
+}
+function toEvaluationHandleWinnerMetadata(winner) {
+  if (winner === void 0) return void 0;
+  if (!winner) return null;
+  const winnerForOutcomeDerivation = winner.isSynthesis === true ? winner : (() => {
+    const { outcome: _staleOutcome, ...withoutOutcome } = winner;
+    return withoutOutcome;
+  })();
+  const outcome = winner.isSynthesis === true && winner.outcome ? winner.outcome : deriveVariantOutcome(winnerForOutcomeDerivation);
+  return {
+    provider: winner.provider,
+    model: winner.model,
+    resolvedModel: winner.resolvedModel,
+    strategy: winner.strategy,
+    executionMode: winner.executionMode,
+    variant: winner.variant,
+    variantInstanceId: winner.variantInstanceId,
+    winnerSelectionSource: winner.winnerSelectionSource,
+    winnerSelectionReason: winner.winnerSelectionReason,
+    buildStatus: winner.buildStatus ?? outcome.verification.buildStatus,
+    lintStatus: winner.lintStatus ?? outcome.verification.lintStatus,
+    // Explicit unsuccessful testStatus ('failed'/'error'/'timeout'/any
+    // non-neutral spelling — the field permits arbitrary strings the
+    // derivation logic cannot represent) is authoritative, EXCEPT when a
+    // trusted passing repair superseded it: the repair path intentionally
+    // preserves the original provider testStatus while deriveVariantOutcome
+    // recognizes the passing repair, so letting the stale explicit failure
+    // win there would persist a false failure on the handle. Synthesis
+    // winners have no repair path, so their explicit status always wins over
+    // the provider-supplied nested outcome (the #2304 failure-masking fix);
+    // the b46777520 tightening (derived beats a stale top-level 'passed')
+    // is preserved because only unsuccessful explicit statuses take
+    // precedence.
+    testStatus: (() => {
+      const explicitUnsuccessful = winner.testStatus !== void 0 && winner.testStatus !== "passed" && winner.testStatus !== "not_run" && winner.testStatus !== "skipped";
+      const supersededByPassingRepair = winner.isSynthesis !== true && repairOutcomeCanSupersedeRawTouchedFailure(winner);
+      return explicitUnsuccessful && !supersededByPassingRepair ? winner.testStatus : outcome.verification.testStatus;
+    })(),
+    testMetrics: winner.testMetrics,
+    testsExecuted: redactPersistedTestsExecuted(winner.testsExecuted),
+    filesChanged: winner.filesChanged ?? winner.gitMetrics?.filesChanged ?? winner.worktreeSummary?.filesChanged,
+    hasChanges: winner.hasChanges ?? outcome.delivery.hasChanges ?? (typeof winner.filesChanged === "number" ? winner.filesChanged > 0 : void 0)
+  };
+}
+function normalizeTerminalHandleErrorMessage(outcome, errorMessage) {
+  const sanitized = sanitizeHandleErrorMessage(errorMessage)?.trim();
+  return sanitized || `Competition ended with ${outcome}`;
+}
+function createEvaluationHandleFinalState(input) {
+  if (input.outcome === "winner_selected") {
+    if (!input.winner) {
+      throw new TypeError("winner_selected terminal state requires a winner");
+    }
+    return { ...input, status: "completed", outcome: "winner_selected", winner: input.winner };
+  }
+  if (input.outcome === "no_winner") {
+    return { ...input, status: "completed", outcome: "no_winner", winner: null };
+  }
+  if (input.outcome === "all_failed") {
+    return { ...input, status: "failed", outcome: "all_failed", winner: null };
+  }
+  if (input.outcome === "timed_out" || input.outcome === "error") {
+    return {
+      ...input,
+      status: "failed",
+      outcome: input.outcome,
+      winner: null,
+      errorMessage: normalizeTerminalHandleErrorMessage(input.outcome, input.errorMessage)
+    };
+  }
+  throw new TypeError(`Unsupported evaluation-handle terminal outcome: ${String(input.outcome)}`);
+}
+function isValidEvaluationHandleFinalState(state) {
+  if (state.status === "completed") {
+    return state.outcome === "winner_selected" && state.winner != null || state.outcome === "no_winner" && state.winner === null;
+  }
+  if (state.outcome === "all_failed") {
+    return state.winner === null;
+  }
+  return (state.outcome === "timed_out" || state.outcome === "error") && state.winner === null && typeof state.errorMessage === "string" && state.errorMessage.trim().length > 0;
+}
+function isDurableHandleCompletion(result, requested = "completed") {
+  return result.kind === "finalized" && result.status === requested || result.kind === "already_terminal" && result.status === requested;
+}
+var EvaluationHandleDurabilityError = class extends Error {
+  deliveredResult;
+  finalizationResult;
+  constructor(deliveredResult, finalizationResult) {
+    super(
+      `Required evaluation handle did not reach durable completed state (kind=${finalizationResult.kind})`
+    );
+    this.name = "EvaluationHandleDurabilityError";
+    this.deliveredResult = deliveredResult;
+    this.finalizationResult = finalizationResult;
+  }
+};
+async function deliverBeforeRequiredHandleDurabilityCheck(deliver, finalizationResult, options) {
+  const deliveredResult = await deliver();
+  if (options.required && !isDurableHandleCompletion(finalizationResult, options.requested ?? "completed")) {
+    throw new EvaluationHandleDurabilityError(deliveredResult, finalizationResult);
+  }
+  return deliveredResult;
+}
+function classifyFinalizePersistenceError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/timed out waiting for finalize lock/i.test(message)) {
+    return { error: message, cause: "lock_timeout" };
+  }
+  if (error instanceof SyntaxError || /JSON|parse/i.test(message) || error instanceof Error && error.name === "SyntaxError") {
+    return { error: message, cause: "parse" };
+  }
+  if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && String(error.code).startsWith("ERR_") === false && /E[A-Z]+/.test(String(error.code))) {
+    return { error: message, cause: "io" };
+  }
+  return { error: message, cause: "unknown" };
+}
+function finalizeEvaluationHandle(evaluationId, finalState) {
+  try {
+    if (!isValidEvaluationHandleFinalState(finalState)) {
+      throw new TypeError(
+        `Invalid evaluation-handle terminal pair: ${finalState.status}/${finalState.outcome}`
+      );
+    }
+    const p = getHandlePath(evaluationId);
+    if (!fs.existsSync(p)) {
+      return { kind: "absent" };
+    }
+    const lockPath = `${p}.lock`;
+    const lockToken = acquireLockSync(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for finalize lock on ${evaluationId}`);
+    }
+    try {
+      return finalizeEvaluationHandleLocked(evaluationId, finalState, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("finalize handle", evaluationId, error);
+    const classified = classifyFinalizePersistenceError(error);
+    return {
+      kind: "persistence_failed",
+      error: classified.error,
+      cause: classified.cause
+    };
+  }
+}
+async function finalizeEvaluationHandleAsync(evaluationId, finalState) {
+  try {
+    if (!isValidEvaluationHandleFinalState(finalState)) {
+      throw new TypeError(
+        `Invalid evaluation-handle terminal pair: ${finalState.status}/${finalState.outcome}`
+      );
+    }
+    const p = getHandlePath(evaluationId);
+    if (!fs.existsSync(p)) {
+      return { kind: "absent" };
+    }
+    const lockPath = `${p}.lock`;
+    const lockToken = await acquireLock(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for finalize lock on ${evaluationId}`);
+    }
+    try {
+      return finalizeEvaluationHandleLocked(evaluationId, finalState, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("finalize handle", evaluationId, error);
+    const classified = classifyFinalizePersistenceError(error);
+    return {
+      kind: "persistence_failed",
+      error: classified.error,
+      cause: classified.cause
+    };
+  }
+}
+function finalizeEvaluationHandleLocked(evaluationId, finalState, p) {
+  const raw = fs.readFileSync(p, "utf8");
+  const parsed = parseJsonWithContext(raw, `Competition handle (${evaluationId})`);
+  const parsedStatus = parsed.status;
+  const isCompletedReconciliation = parsedStatus === "completed" && finalState.status === "completed";
+  if (typeof parsed.status === "string" && TERMINAL_EVALUATION_STATUSES.has(parsedStatus) && !isCompletedReconciliation) {
+    return {
+      kind: "already_terminal",
+      status: parsedStatus,
+      requested: finalState.status
+    };
+  }
+  const completedAt = finalState.completedAt ?? (isCompletedReconciliation && typeof parsed.completedAt === "string" ? parsed.completedAt : (/* @__PURE__ */ new Date()).toISOString());
+  const candidates = parsed.candidates || parsed.variants || [];
+  const hasActiveCandidates = finalState.status === "completed" && candidates.some(
+    (candidate) => !candidateHasCompletedPeer(candidate, candidates) && (candidate.submittedOnly === true || candidate.success === void 0 && candidate.timedOut !== true && !candidate.errorMessage)
+  );
+  const effectiveStatus = hasActiveCandidates ? "running" : finalState.status;
+  const effectiveOutcome = hasActiveCandidates ? void 0 : finalState.outcome;
+  const effectiveCompletedAt = hasActiveCandidates ? void 0 : completedAt;
+  const effectiveErrorMessage = hasActiveCandidates ? void 0 : sanitizeHandleErrorMessage(
+    "errorMessage" in finalState ? finalState.errorMessage : void 0
+  );
+  const parsedWinner = canonicalizeHandleWinner(
+    parsed.winner ?? null
+  );
+  const finalWinner = canonicalizeHandleWinner(finalState.winner);
+  const effectiveWinner = finalState.status === "failed" ? null : hasActiveCandidates && finalState.winner === void 0 ? parsed.winner ?? null : isCompletedReconciliation && parsedWinner && finalState.winner !== null ? parsedWinner : finalWinner;
+  const resolvedWinner = finalState.status === "failed" ? null : effectiveWinner === void 0 ? parsedWinner : effectiveWinner;
+  const resolvedWinnerVerification = finalState.status === "failed" ? null : finalState.winnerVerification === void 0 ? parsed.winnerVerification ?? null : finalState.winnerVerification;
+  const handle = {
+    taskId: parsed.evaluationId || parsed.taskId || evaluationId,
+    evaluationId: parsed.evaluationId || parsed.taskId || evaluationId,
+    prompt: sanitizeHandlePrompt(parsed.prompt),
+    initiatedBy: parsed.initiatedBy,
+    createdAt: parsed.createdAt || completedAt,
+    updatedAt: completedAt,
+    status: effectiveStatus,
+    outcome: effectiveOutcome,
+    completedAt: effectiveCompletedAt,
+    errorMessage: effectiveErrorMessage,
+    winner: resolvedWinner,
+    candidates,
+    variants: candidates,
+    labId: parsed.labId,
+    labRunId: parsed.labRunId,
+    runMetadata: finalState.runMetadata ?? parsed.runMetadata,
+    deliverableContract: parsed.deliverableContract,
+    winnerVerification: resolvedWinnerVerification,
+    verification: resolvedWinnerVerification,
+    completenessTelemetry: finalState.completenessTelemetry ?? parsed.completenessTelemetry,
+    decision: finalState.decision ?? parsed.decision,
+    judgeFailures: finalState.judgeFailures ?? parsed.judgeFailures,
+    tieBreak: finalState.tieBreak ?? parsed.tieBreak,
+    synthesis: parsed.synthesis,
+    application: parsed.application
+  };
+  atomicWrite(p, JSON.stringify(handle, null, 2));
+  if (isCompletedReconciliation) {
+    if (handle.status === "completed" || handle.status === "failed") {
+      return { kind: "finalized", status: handle.status };
+    }
+    return { kind: "not_terminal", status: "running", reason: "active_candidates" };
+  }
+  const finalEventKind = finalState.status === "failed" ? "competition.failed" : "competition.completed";
+  appendCompetitionEvent(evaluationId, finalEventKind, {
+    status: effectiveStatus,
+    outcome: effectiveOutcome,
+    errorMessage: effectiveErrorMessage,
+    winner: resolvedWinner ? {
+      provider: resolvedWinner.provider,
+      strategy: resolvedWinner.strategy,
+      variant: resolvedWinner.variant
+    } : null
+  });
+  if (handle.status === "completed" || handle.status === "failed") {
+    return { kind: "finalized", status: handle.status };
+  }
+  return { kind: "not_terminal", status: "running", reason: "active_candidates" };
+}
+function updateEvaluationHandleWithSynthesisResult(evaluationId, result) {
+  try {
+    const p = getHandlePath(evaluationId);
+    const lockPath = `${p}.lock`;
+    const lockToken = acquireLockSync(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for synthesis update lock on ${evaluationId}`);
+    }
+    try {
+      updateEvaluationHandleWithSynthesisResultLocked(evaluationId, result, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("update synthesis metadata", evaluationId, error);
+  }
+}
+async function updateEvaluationHandleWithSynthesisResultAsync(evaluationId, result) {
+  try {
+    const p = getHandlePath(evaluationId);
+    const lockPath = `${p}.lock`;
+    const lockToken = await acquireLock(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for synthesis update lock on ${evaluationId}`);
+    }
+    try {
+      updateEvaluationHandleWithSynthesisResultLocked(evaluationId, result, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("update synthesis metadata", evaluationId, error);
+  }
+}
+function updateEvaluationHandleWithSynthesisResultLocked(evaluationId, result, p) {
+  const raw = fs.existsSync(p) ? fs.readFileSync(p, "utf8") : "";
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const parsed = raw ? parseJsonWithContext(raw, `Competition handle (${evaluationId})`) : {};
+  const handle = {
+    taskId: parsed.evaluationId || parsed.taskId || evaluationId,
+    evaluationId: parsed.evaluationId || parsed.taskId || evaluationId,
+    prompt: sanitizeHandlePrompt(parsed.prompt),
+    initiatedBy: parsed.initiatedBy,
+    createdAt: parsed.createdAt || now,
+    updatedAt: now,
+    status: parsed.status,
+    outcome: parsed.outcome,
+    completedAt: parsed.completedAt,
+    errorMessage: parsed.errorMessage,
+    winner: parsed.winner,
+    candidates: parsed.candidates || parsed.variants || [],
+    variants: parsed.variants || parsed.candidates || [],
+    labId: parsed.labId,
+    labRunId: parsed.labRunId,
+    deliverableContract: parsed.deliverableContract,
+    winnerVerification: parsed.winnerVerification,
+    verification: parsed.verification ?? parsed.winnerVerification,
+    completenessTelemetry: parsed.completenessTelemetry,
+    application: parsed.application,
+    synthesis: sanitizeSynthesisArtifactForPersistence({
+      success: result.success,
+      prNumber: result.prNumber,
+      prUrl: result.prUrl,
+      error: result.error,
+      mergedVariants: result.mergedVariants,
+      synthesisIntents: result.synthesisIntents,
+      donorProfiles: result.donorProfiles,
+      donorSelectionDecisions: result.donorSelectionDecisions,
+      intentFilteredHunkCount: result.intentFilteredHunkCount,
+      excludedHunkCount: result.excludedHunkCount,
+      unknownIncludedHunkCount: result.unknownIncludedHunkCount,
+      unknownExcludedHunkCount: result.unknownExcludedHunkCount,
+      intentMaterialSummaries: result.intentMaterialSummaries,
+      overlapRejectedHunkCount: result.overlapRejectedHunkCount,
+      deliverySucceeded: result.deliverySucceeded,
+      synthesisApplied: result.synthesisApplied,
+      winnerFallback: result.winnerFallback,
+      fallbackReason: result.fallbackReason,
+      patchApplyValidated: result.patchApplyValidated,
+      gatesPassed: result.gatesPassed,
+      gateFailureDetails: result.gateFailureDetails,
+      aiGuidedFallbackAttempted: result.aiGuidedFallbackAttempted,
+      aiGuidedFallbackOutcome: result.aiGuidedFallbackOutcome,
+      // Diagnostics that explain WHY a run carried the winner forward
+      // (agent timeout vs invalid response vs corrupt-patch apply vs
+      // deliberate no-pick). Previously only persisted to the richer
+      // .poetic/telemetry/synthesis/<id>.json sidecar, leaving all
+      // fallback reasons indistinguishable in competition state.
+      synthesisOutcomeStatus: result.synthesisOutcomeStatus,
+      synthesisDurationMs: result.synthesisDurationMs,
+      synthesisProvider: result.synthesisProvider,
+      synthesisModel: result.synthesisModel,
+      synthesisProviderDurationMs: result.synthesisProviderDurationMs,
+      synthesisGateDurationMs: result.synthesisGateDurationMs,
+      winnerFirstReview: result.winnerFirstReview,
+      harvestManifest: result.harvestManifest,
+      donorMaterialDiagnostic: result.donorMaterialDiagnostic
+    })
+  };
+  atomicWrite(p, JSON.stringify(handle, null, 2));
+}
+function updateEvaluationHandleApplicationProvenance(evaluationId, provenance) {
+  try {
+    const p = getHandlePath(evaluationId);
+    const lockPath = `${p}.lock`;
+    const lockToken = acquireLockSync(lockPath);
+    if (!lockToken) {
+      throw new Error(`Timed out waiting for application update lock on ${evaluationId}`);
+    }
+    try {
+      updateEvaluationHandleApplicationProvenanceLocked(evaluationId, provenance, p);
+    } finally {
+      releaseLock(lockPath, lockToken);
+    }
+  } catch (error) {
+    warnHandleFailure("update application provenance", evaluationId, error);
+  }
+}
+function updateEvaluationHandleApplicationProvenanceLocked(evaluationId, provenance, p) {
+  if (!fs.existsSync(p)) {
+    return;
+  }
+  const raw = fs.readFileSync(p, "utf8");
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const parsed = parseJsonWithContext(raw, `Competition handle (${evaluationId})`);
+  const candidates = parsed.candidates || parsed.variants || [];
+  const handle = {
+    ...parsed,
+    taskId: parsed.evaluationId || parsed.taskId || evaluationId,
+    evaluationId: parsed.evaluationId || parsed.taskId || evaluationId,
+    prompt: sanitizeHandlePrompt(parsed.prompt),
+    createdAt: parsed.createdAt || now,
+    updatedAt: now,
+    candidates,
+    variants: candidates,
+    application: provenance
+  };
+  atomicWrite(p, JSON.stringify(handle, null, 2));
+}
+
+export {
+  appendCompetitionEvent,
+  initEvaluationHandle,
+  initEvaluationHandleAsync,
+  updateEvaluationHandleWithResult,
+  updateEvaluationHandleWithResultAsync,
+  toEvaluationHandleWinnerMetadata,
+  createEvaluationHandleFinalState,
+  isDurableHandleCompletion,
+  deliverBeforeRequiredHandleDurabilityCheck,
+  finalizeEvaluationHandle,
+  finalizeEvaluationHandleAsync,
+  updateEvaluationHandleWithSynthesisResult,
+  updateEvaluationHandleWithSynthesisResultAsync,
+  updateEvaluationHandleApplicationProvenance
+};
+//# sourceMappingURL=chunk-2IUXIGQD.js.map