@knights-eye-chess/ai-analysis 0.1.0-dev.17 → 0.1.0-dev.18

package/dist/{chunk-XQDZJOYD.js → chunk-6OXAG5H3.js}

@@ -1284,7 +1284,7 @@ function rejectionReason(context, hash, witness) {
   if (witness.authority !== "bounded-engine" || !Array.isArray(witness.licenses) || witness.licenses.length !== 1 || witness.licenses[0] !== "engine.bounded-continuation") return "missing-authority-license";
   if (witness.contextHash !== hash) return "context-mismatch";
   if (!["before", "after"].includes(witness.phase) || witness.fen !== (witness.phase === "before" ? context.fenBefore : context.fenAfter)) return "root-mismatch";
-  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length !== witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
+  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length < 1 || witness.lines.length > witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
   if (witness.lines.some((line) => !line || typeof line.rootMove !== "string")) return "invalid-pv";
   const roots = witness.lines.map((line) => line.rootMove);
   if (new Set(roots).size !== roots.length || witness.rootMoves.some((root) => !roots.includes(root)) || witness.rootMoves.length > 0 && roots.some((root) => !witness.rootMoves.includes(root))) return "root-set-mismatch";

package/dist/{chunk-PLKNJRPF.js → chunk-TYQ5WIL2.js}

@@ -50,7 +50,7 @@ import {
   validateEvidenceLicenseClaims,
   validateReasoningPositionContext,
   withEvidenceLicenses
-} from "./chunk-XQDZJOYD.js";
+} from "./chunk-6OXAG5H3.js";
 
 // src/chess-reasoning/branch-expansion-policy.ts
 var BRANCH_EXPANSION_OPTIONS = { maxNodes: 8, maxPlies: 4, maxLines: 2, depthFloor: 14, depthMode: "decreasing", maxElapsedMs: 2e4 };

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   simpleSystemPolicy,
   simpleToolDescription,
   validateSimpleToolInput
-} from "./chunk-PLKNJRPF.js";
+} from "./chunk-TYQ5WIL2.js";
 import {
   DEFAULT_REASONING_RUN_CONTROLS,
   EVIDENCE_SHARING_VERSION,
@@ -71,7 +71,7 @@ import {
   toPositionAnalysisProvider,
   validateReasoningPositionContext,
   validateSimpleAgentConfig
-} from "./chunk-XQDZJOYD.js";
+} from "./chunk-6OXAG5H3.js";
 export {
   DEFAULT_REASONING_RUN_CONTROLS,
   EVIDENCE_SHARING_VERSION,

package/dist/owner-tests/pipeline-host-preparation.test.mjs

@@ -5879,7 +5879,7 @@ function rejectionReason(context2, hash, witness) {
   if (witness.authority !== "bounded-engine" || !Array.isArray(witness.licenses) || witness.licenses.length !== 1 || witness.licenses[0] !== "engine.bounded-continuation") return "missing-authority-license";
   if (witness.contextHash !== hash) return "context-mismatch";
   if (!["before", "after"].includes(witness.phase) || witness.fen !== (witness.phase === "before" ? context2.fenBefore : context2.fenAfter)) return "root-mismatch";
-  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length !== witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
+  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length < 1 || witness.lines.length > witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
   if (witness.lines.some((line) => !line || typeof line.rootMove !== "string")) return "invalid-pv";
   const roots = witness.lines.map((line) => line.rootMove);
   if (new Set(roots).size !== roots.length || witness.rootMoves.some((root) => !roots.includes(root)) || witness.rootMoves.length > 0 && roots.some((root) => !witness.rootMoves.includes(root))) return "root-set-mismatch";

package/dist/owner-tests/prose-reference-admission.test.mjs

@@ -1037,7 +1037,7 @@ function rejectionReason(context, hash, witness) {
   if (witness.authority !== "bounded-engine" || !Array.isArray(witness.licenses) || witness.licenses.length !== 1 || witness.licenses[0] !== "engine.bounded-continuation") return "missing-authority-license";
   if (witness.contextHash !== hash) return "context-mismatch";
   if (!["before", "after"].includes(witness.phase) || witness.fen !== (witness.phase === "before" ? context.fenBefore : context.fenAfter)) return "root-mismatch";
-  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length !== witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
+  if (typeof witness.engineBuild !== "string" || !witness.engineBuild || typeof witness.command !== "string" || !witness.command || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32 || !Array.isArray(witness.lines) || witness.lines.length < 1 || witness.lines.length > witness.multiPv || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32 || witness.rootMoves.some((root) => typeof root !== "string" || !UCI.test(root)) || new Set(witness.rootMoves).size !== witness.rootMoves.length) return "invalid-search-scope";
   if (witness.lines.some((line) => !line || typeof line.rootMove !== "string")) return "invalid-pv";
   const roots = witness.lines.map((line) => line.rootMove);
   if (new Set(roots).size !== roots.length || witness.rootMoves.some((root) => !roots.includes(root)) || witness.rootMoves.length > 0 && roots.some((root) => !witness.rootMoves.includes(root))) return "root-set-mismatch";
@@ -1768,3 +1768,54 @@ test("fresh answer witnesses preserve shipped v22 reference geometry and reject
   assert.equal(rejected.referenceGapCounts.unresolvedReferences, 1);
   assert.equal(rejected.blocks[0].tokens[0].reference, void 0);
 });
+test("completed unrestricted MultiPV witnesses accept fewer lines without changing requested scope", () => {
+  const fen = "7r/p1p1p1kp/2p2rpQ/3q4/3P4/2P5/P1P2PP1/R3K2R b KQ - 5 18";
+  const context = { kind: "position", nodeId: "two-legal", historyStartFen: fen, historyUci: [], moveUci: "", moveSan: "", fenBefore: fen, fenAfter: fen };
+  const roots = ["g7g8", "g7f7"];
+  assert.deepEqual(new Set(new Chess34(fen).moves({ verbose: true }).map((m) => m.from + m.to)), new Set(roots));
+  const witness = {
+    version: "fresh-engine-pv-witness/1",
+    acquisition: "same-answer-engine",
+    acquisitionId: 1,
+    evidenceId: "server-engine-acquisition:two-legal",
+    contextHash: reasoningContextHash(context),
+    phase: "before",
+    fen,
+    engineBuild: "test-engine",
+    command: "go depth 18",
+    requestedDepth: 18,
+    multiPv: 3,
+    rootMoves: [],
+    authority: "bounded-engine",
+    licenses: ["engine.bounded-continuation"],
+    lines: roots.map((rootMove, index) => ({
+      rootMove,
+      pv: [rootMove],
+      depth: 18,
+      scoreCp: -200 - index,
+      mateInMoves: null,
+      scoreProvenance: { kind: "root-search", fen, engineBuild: "test-engine", command: "go depth 18", originatingDepth: 18, reportedDepth: 18 }
+    }))
+  };
+  const admitted = admitFreshEnginePvWitnesses(context, [witness]);
+  assert.equal(admitted.audit.acceptedLines, 2);
+  assert.equal(witness.multiPv, 3, "requested MultiPV remains provenance, not returned-line count");
+  assert.equal(admitFreshEnginePvWitnesses(context, [{ ...witness, lines: [witness.lines[0]] }]).audit.acceptedLines, 1);
+  for (const patch of [{ lines: [] }, { multiPv: 1 }, { rootMoves: roots, lines: [witness.lines[0]] }]) {
+    assert.equal(admitFreshEnginePvWitnesses(context, [{ ...witness, ...patch }]).audit.acceptedLines, 0);
+  }
+  for (const change of [(line) => {
+    line.depth = 17;
+  }, (line) => {
+    line.scoreCp = null;
+  }, (line) => {
+    line.pv = ["g7g6"];
+  }]) {
+    const invalid = structuredClone(witness);
+    change(invalid.lines[1]);
+    assert.equal(admitFreshEnginePvWitnesses(context, [invalid]).audit.acceptedLines, 0);
+  }
+  const rendered = simpleProseReferences("[Kg8](move:before:g7g8)", context, [], void 0, void 0, void 0, { freshEnginePvWitnesses: [witness] });
+  assert.equal(rendered.referenceGapCounts.unresolvedReferences, 0);
+  assert.equal(rendered.freshEnginePvAdmission.acceptedLines, 2);
+});

package/dist/research.js

@@ -211,7 +211,7 @@ import {
   wikibooksTargetsForTool,
   withBranchPreparation,
   withRecordedPositionTools
-} from "./chunk-PLKNJRPF.js";
+} from "./chunk-TYQ5WIL2.js";
 import {
   CHESS_REASONING_POLICY_VERSION,
   CHESS_REASONING_SCHEMA_VERSION,
@@ -316,7 +316,7 @@ import {
   validateReasoningPositionContext,
   validateSimpleAgentConfig,
   withEvidenceLicenses
-} from "./chunk-XQDZJOYD.js";
+} from "./chunk-6OXAG5H3.js";
 
 // src/chess-reasoning/ablation-direct-synthesis.ts
 import { SQUARES } from "chess.js";

package/dist/runtime-closure.json

@@ -99,5 +99,5 @@
     "@ai-sdk/provider",
     "@ai-sdk/provider-utils"
   ],
-  "runtimeBytes": 969108
+  "runtimeBytes": 969134
 }

package/dist/shared.js

@@ -62,7 +62,7 @@ import {
   toPositionAnalysisProvider,
   validateReasoningPositionContext,
   validateSimpleAgentConfig
-} from "./chunk-XQDZJOYD.js";
+} from "./chunk-6OXAG5H3.js";
 
 // src/player-perspective.ts
 function normalizedPlayerName(value) {

package/docs/API.md

@@ -80,3 +80,12 @@ remain in the canonical tool wrappers and host.
 
 
 See the [pipeline source](../src/chess-reasoning/answer-pipeline.ts) and [connector contract](../src/chess-reasoning/answer-model-connector.ts).
+
+
+### Completed MultiPV results
+
+Fresh engine presentation witnesses interpret `multiPv` as the requested maximum.
+An unrestricted completed search can return one through that many valid lines;
+the original requested count remains in the witness even when fewer lines arrive.
+Explicit `rootMoves` searches must still cover their entire requested root set.
+Depth, score, provenance, distinct-root and legal-PV checks remain unchanged.

package/npm-release.json

@@ -1,5 +1,5 @@
 {
   "registryDependencies": {
-    "@knights-eye-chess/move-classifier": "0.1.0-dev.13"
+    "@knights-eye-chess/move-classifier": "0.1.0-dev.14"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knights-eye-chess/ai-analysis",
-  "version": "0.1.0-dev.17",
+  "version": "0.1.0-dev.18",
   "type": "module",
   "files": [
     "dist",
@@ -51,7 +51,7 @@
   "dependencies": {
     "@ai-sdk/provider": "4.0.9",
     "@ai-sdk/provider-utils": "5.0.34",
-    "@knights-eye-chess/move-classifier": "0.1.0-dev.13",
+    "@knights-eye-chess/move-classifier": "0.1.0-dev.14",
     "@types/json-schema": "7.0.15",
     "@types/node": "22.19.19",
     "ai": "7.0.85",

package/scripts/check-release-tooling.mjs

@@ -7,7 +7,7 @@ import path from 'node:path';
 export function assertReleaseTooling(root = fileURLToPath(new URL('../', import.meta.url))) {
   const manifest = JSON.parse(readFileSync(path.join(root, 'scripts/release-tooling.json'), 'utf8'));
   if (manifest.schema !== 1 || manifest.canonical !== 'knightseye-net/tools/release-tooling') throw Error('Invalid release tooling stamp');
-  const required = ['scripts/pack.mjs', 'scripts/publish-reviewed.mjs', '.github/workflows/npm-publish.yml', 'scripts/verify-release.mjs', 'scripts/update-dependency.mjs', 'scripts/check-release-tooling.mjs', '.github/workflows/quality.yml'];
+  const required = ['scripts/check-review-marker.mjs', 'scripts/pack.mjs', 'scripts/publish-reviewed.mjs', '.github/workflows/npm-publish.yml', 'scripts/verify-release.mjs', 'scripts/update-dependency.mjs', 'scripts/check-release-tooling.mjs', '.github/workflows/quality.yml'];
   if (!manifest.sha256 || required.some(relative => !/^[a-f0-9]{64}$/.test(manifest.sha256[relative] || ''))) throw Error('Incomplete release tooling stamp');
   for (const [relative, expected] of Object.entries(manifest.sha256)) {
     if (path.isAbsolute(relative) || relative.split('/').includes('..')) throw Error(`Invalid tooling path: ${relative}`);

package/scripts/check-review-marker.mjs

@@ -0,0 +1,79 @@
+// Canonical source: knightseye-net/tools/release-tooling/templates/check-review-marker.mjs.
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const shaPattern = /^[a-f0-9]{40}$/;
+export async function requireReview({ repository, sha, branch, reviewer, token, checkoutSha,
+  fetchImpl = fetch }) {
+  if (!/^[\w.-]+\/[\w.-]+$/.test(repository || '') || !shaPattern.test(sha || '') ||
+      checkoutSha !== sha || !['dev', 'production'].includes(branch) || reviewer !== 'Shedal' || !token) {
+    throw Error('Review gate requires repository, exact checkout SHA, release branch, Shedal and GitHub token');
+  }
+  const prefix = `/repos/${repository}`;
+  async function get(route) {
+    let response;
+    try {
+      response = await fetchImpl(`https://api.github.com${prefix}${route}`, {
+        headers: { Authorization: `Bearer ${token}`, Accept: 'application/vnd.github+json',
+          'X-GitHub-Api-Version': '2022-11-28' }, signal: AbortSignal.timeout(30000), redirect: 'error',
+      });
+    } catch { throw Error('Review evidence API unavailable'); }
+    if (!response.ok) throw Error(`Review evidence API failed: HTTP ${response.status}`);
+    try { return await response.json(); } catch { throw Error('Invalid review evidence JSON'); }
+  }
+  async function list(route) {
+    const all = [];
+    for (let page = 1; page <= 100; page++) {
+      const items = await get(`${route}?per_page=100&page=${page}`);
+      if (!Array.isArray(items)) throw Error('Invalid review evidence list');
+      all.push(...items);
+      if (items.length < 100) return all;
+    }
+    throw Error('Review evidence pagination limit reached');
+  }
+  const associated = await list(`/commits/${sha}/pulls`);
+  const matches = [];
+  const seen = new Set();
+  for (const candidate of associated) {
+    if (!Number.isSafeInteger(candidate.number) || candidate.number <= 0) throw Error('Invalid associated PR');
+    if (seen.has(candidate.number)) continue;
+    seen.add(candidate.number);
+    // Resolve current PR metadata, not the commit-association response's snapshot.
+    const pr = await get(`/pulls/${candidate.number}`);
+    if (pr.number === candidate.number && pr.merged === true && pr.merged_at &&
+        pr.merge_commit_sha === sha && pr.base?.ref === branch &&
+        pr.base?.repo?.full_name === repository) matches.push(pr);
+  }
+  if (matches.length !== 1) throw Error('Expected one merged release PR for the exact checkout SHA');
+  const pr = matches[0];
+  const comments = await list(`/issues/${pr.number}/comments`);
+  const decisions = [];
+  for (const comment of comments) {
+    if (comment.user?.login !== reviewer || typeof comment.body !== 'string') continue;
+    // Standalone line permits Claude's normal generated footer after the decision.
+    const markers = comment.body.split(/\r?\n/).filter(line =>
+      new RegExp(`^claude-review: (approved|rejected) ${sha}$`).test(line));
+    if (!markers.length) continue;
+    const created = Date.parse(comment.created_at), updated = Date.parse(comment.updated_at);
+    if (!Number.isSafeInteger(comment.id) || !Number.isFinite(created) || !Number.isFinite(updated) || updated < created) {
+      throw Error('Invalid review decision metadata');
+    }
+    const edited = updated !== created;
+    decisions.push({ id: comment.id, time: updated, approved: !edited && markers.length === 1 &&
+      markers[0] === `claude-review: approved ${sha}` });
+  }
+  decisions.sort((a, b) => a.time - b.time || a.id - b.id);
+  const latest = decisions.at(-1);
+  if (!latest?.approved) throw Error('Exact commit has no current unedited approval; post a fresh review decision');
+  return { repository, sha, reviewer, pullRequest: pr.number,
+    reviewUrl: `https://github.com/${repository}/pull/${pr.number}#issuecomment-${latest.id}` };
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const checkoutSha = execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf8' }).trim();
+  const receipt = await requireReview({ repository: process.env.GITHUB_REPOSITORY,
+    sha: process.env.GITHUB_SHA, branch: process.env.REVIEW_RELEASE_BRANCH,
+    reviewer: process.env.REVIEWER_LOGIN, token: process.env.GH_TOKEN, checkoutSha });
+  console.log(JSON.stringify(receipt));
+}

package/scripts/publish-reviewed.mjs

@@ -1,8 +1,9 @@
 // Generated from knightseye-net/tools/release-tooling; edit the canonical template and sync.
+import { requireReview } from './check-review-marker.mjs';
 import { assertReleaseTooling } from './check-release-tooling.mjs';
 import { readFileSync } from 'node:fs';
 import { createHash } from 'node:crypto';
-import { spawnSync } from 'node:child_process';
+import { spawnSync, execFileSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 
@@ -81,5 +82,8 @@ export function publishReviewed({root, version, sha256, env = process.env, run =
 }
 if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
   assertReleaseTooling();
+  await requireReview({ repository: process.env.GITHUB_REPOSITORY, sha: process.env.GITHUB_SHA,
+    checkoutSha: execFileSync('git', ['rev-parse', 'HEAD'], { cwd: fileURLToPath(new URL('../', import.meta.url)), encoding: 'utf8' }).trim(),
+    branch: 'dev', reviewer: 'Shedal', token: process.env.GH_TOKEN });
   console.log(JSON.stringify(publishReviewed({root: fileURLToPath(new URL('../', import.meta.url)), version: process.argv[2], sha256: process.argv[3]})));
 }

package/scripts/release-tooling.json

@@ -3,11 +3,12 @@
   "canonical": "knightseye-net/tools/release-tooling",
   "sha256": {
     "scripts/pack.mjs": "334aa4041e59b14fd2b072969f50beea64449136f7f9146d63d7277fc2e4808a",
-    "scripts/publish-reviewed.mjs": "b91c7aa578bc34c490b42006038de4ee8b9c596a592aa079bacd836d02feb647",
-    ".github/workflows/npm-publish.yml": "b25cec136db205d69a407284dae2bb66f3d56be13ed2a1367f0db167a232050d",
+    "scripts/check-review-marker.mjs": "1d06c9139a835e47f78eef1bff221d5ccdc57c10f0731796ca6f5f0e3ca49e7f",
+    "scripts/publish-reviewed.mjs": "e046dda0c47cb4f7b2d044e22d7c719d5f1fda02762bef4d013125da6258fbd3",
+    ".github/workflows/npm-publish.yml": "0bb481c699566136e271babf8bdb7860b545c0e789034c0e06f5c0556d84b250",
     "scripts/verify-release.mjs": "d0f9baead779e553385bb7c26f1238ad4e60a189a818d4db4f721a1e5f88dedc",
     "scripts/update-dependency.mjs": "9919f172be33973f124eabf56c1dc70e41e941e601783ef01aba1c47dd70db9d",
-    "scripts/check-release-tooling.mjs": "29563619bdc3e86ef10dec1e983274e36138193f04d33f2455501b59a4016e0d",
+    "scripts/check-release-tooling.mjs": "667e9c096ef28cddaefb90be92601828e7268c39f8a285f6644d3784db6f5064",
     ".github/workflows/quality.yml": "a014920a9f89dc494a020bee5f69aec779cf58825f491690f9ed1ec089ed6fa0"
   }
 }

package/src/chess-reasoning/fresh-engine-pv-witnesses.ts

@@ -52,7 +52,7 @@ function rejectionReason(context: ReasoningPositionContext, hash: string, witnes
     || witness.fen !== (witness.phase === 'before' ? context.fenBefore : context.fenAfter)) return 'root-mismatch';
   if (typeof witness.engineBuild !== 'string' || !witness.engineBuild || typeof witness.command !== 'string' || !witness.command
     || !positiveInteger(witness.requestedDepth) || !positiveInteger(witness.multiPv) || witness.multiPv > 32
-    || !Array.isArray(witness.lines) || witness.lines.length !== witness.multiPv
+    || !Array.isArray(witness.lines) || witness.lines.length < 1 || witness.lines.length > witness.multiPv
     || !Array.isArray(witness.rootMoves) || witness.rootMoves.length > 32
     || witness.rootMoves.some(root => typeof root !== 'string' || !UCI.test(root))
     || new Set(witness.rootMoves).size !== witness.rootMoves.length) return 'invalid-search-scope';

package/test/owner/prose-reference-admission.test.mjs

@@ -24,3 +24,31 @@ test('fresh answer witnesses preserve shipped v22 reference geometry and reject
   assert.equal(rejected.referenceGapCounts.unresolvedReferences,1);
   assert.equal(rejected.blocks[0].tokens[0].reference,undefined);
 });
+
+
+test('completed unrestricted MultiPV witnesses accept fewer lines without changing requested scope', () => {
+  const fen='7r/p1p1p1kp/2p2rpQ/3q4/3P4/2P5/P1P2PP1/R3K2R b KQ - 5 18';
+  const context={kind:'position',nodeId:'two-legal',historyStartFen:fen,historyUci:[],moveUci:'',moveSan:'',fenBefore:fen,fenAfter:fen};
+  const roots=['g7g8','g7f7'];
+  assert.deepEqual(new Set(new Chess(fen).moves({verbose:true}).map(m=>m.from+m.to)),new Set(roots));
+  const witness={version:'fresh-engine-pv-witness/1',acquisition:'same-answer-engine',acquisitionId:1,
+    evidenceId:'server-engine-acquisition:two-legal',contextHash:reasoningContextHash(context),phase:'before',fen,
+    engineBuild:'test-engine',command:'go depth 18',requestedDepth:18,multiPv:3,rootMoves:[],
+    authority:'bounded-engine',licenses:['engine.bounded-continuation'],
+    lines:roots.map((rootMove,index)=>({rootMove,pv:[rootMove],depth:18,scoreCp:-200-index,mateInMoves:null,
+      scoreProvenance:{kind:'root-search',fen,engineBuild:'test-engine',command:'go depth 18',originatingDepth:18,reportedDepth:18}}))};
+  const admitted=admitFreshEnginePvWitnesses(context,[witness]);
+  assert.equal(admitted.audit.acceptedLines,2);
+  assert.equal(witness.multiPv,3,'requested MultiPV remains provenance, not returned-line count');
+  assert.equal(admitFreshEnginePvWitnesses(context,[{...witness,lines:[witness.lines[0]]}]).audit.acceptedLines,1);
+  for (const patch of [{lines:[]},{multiPv:1},{rootMoves:roots,lines:[witness.lines[0]]}]) {
+    assert.equal(admitFreshEnginePvWitnesses(context,[{...witness,...patch}]).audit.acceptedLines,0);
+  }
+  for (const change of [line=>{line.depth=17;},line=>{line.scoreCp=null;},line=>{line.pv=['g7g6'];}]) {
+    const invalid=structuredClone(witness);change(invalid.lines[1]);
+    assert.equal(admitFreshEnginePvWitnesses(context,[invalid]).audit.acceptedLines,0);
+  }
+  const rendered=simpleProseReferences('[Kg8](move:before:g7g8)',context,[],undefined,undefined,undefined,{freshEnginePvWitnesses:[witness]});
+  assert.equal(rendered.referenceGapCounts.unresolvedReferences,0);
+  assert.equal(rendered.freshEnginePvAdmission.acceptedLines,2);
+});