pi-herdsman 0.36.2 → 0.37.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +8955 -7962
- package/dist/index.js.map +4 -4
- package/dist/peer-bridge.js +195 -194
- package/dist/peer-bridge.js.map +4 -4
- package/docs/adr/0005-use-files-for-explicit-evidence-handoffs.md +7 -2
- package/docs/adr/0028-reference-historical-assignment-evidence.md +14 -6
- package/docs/adr/0035-separate-assignment-handle-from-checked-out-branch.md +63 -0
- package/docs/concepts/coordination.md +25 -15
- package/docs/development/validation.md +8 -0
- package/docs/guides/handoffs.md +9 -8
- package/docs/guides/project-orchestration.md +41 -11
- package/docs/reference/agent.md +4 -3
- package/docs/reference/staff.md +33 -22
- package/docs/reference/status-widget.md +55 -12
- package/docs/reference/supervisor.md +3 -0
- package/package.json +5 -2
package/dist/peer-bridge.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../bin/peer-bridge.ts", "../extension/compatibility.ts", "../extension/storage.ts", "../extension/
|
|
4
|
-
"sourcesContent": ["#!/usr/bin/env node\nimport { createHash, randomUUID } from \"node:crypto\";\nimport {\n closeSync,\n fsyncSync,\n linkSync,\n mkdirSync,\n openSync,\n readFileSync,\n renameSync,\n rmSync,\n writeSync,\n writeFileSync,\n} from \"node:fs\";\nimport { basename, dirname, isAbsolute, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport {\n isRuntimeBuild,\n runtimeBuild,\n sameRuntimeBuild,\n} from \"../extension/compatibility.ts\";\nimport { nodeOnlyAgentDir, herdsmanDataRoot } from \"../extension/storage.ts\";\nimport {\n listPeerLeadRecords,\n globalProjectAssignmentSnapshot,\n isRemoteOrdinaryLead,\n withProjectAssignmentAuthority,\n peerRuntime,\n chiefMessagePath,\n coordinationMessageDigest,\n hasPeerDeliveryReceipt,\n readCoordinationMessage,\n writeCoordinationMessage,\n} from \"../extension/supervision.ts\";\nimport {\n persistPeerAttachment,\n persistPeerResultArtifact,\n peerAttachmentPath,\n isCanonicalResultRef,\n resultPath,\n} from \"../extension/storage.ts\";\nimport {\n assertPeerDataRoot,\n acknowledgePeerReply,\n finalizePeerCorrespondence,\n peerPayloadDigest,\n pollPeerReplies,\n storePeerCorrespondence,\n verifyPeerCorrespondence,\n readPeerCorrespondence,\n updatePeerOriginGeneration,\n updatePeerRecipientGeneration,\n type PeerCorrespondence,\n} from \"../extension/peer-correspondence.ts\";\nimport { PEER_TRANSPORT_FRAME_LIMIT_BYTES } from \"../extension/peer-transport.ts\";\nimport {\n afterDurablePeerAcceptanceStep,\n afterPendingMarkerTempWriteForTests,\n beforePendingMarkerPublishForTests,\n pendingMarkerWriteLimitForTests,\n afterAcceptedMarkerTempWriteForTests,\n} from \"./peer-bridge-fault-seam.ts\";\n\nlet action = process.argv[2];\nif (\n ![\n \"probe\",\n \"accept\",\n \"poll\",\n \"ack\",\n \"finalize\",\n \"recover\",\n \"recover-recipient\",\n \"status\",\n ].includes(action) ||\n process.argv.length !== 3\n) {\n console.error(\n \"usage: pi-herdsman-peer probe|accept|status|poll|ack|finalize|recover|recover-recipient\",\n );\n process.exit(2);\n}\n\nconst agentDir = nodeOnlyAgentDir();\nif (!isAbsolute(agentDir)) {\n console.error(\n \"PI_CODING_AGENT_DIR must resolve to an absolute path for remote probing\",\n );\n process.exit(1);\n}\n\nconst runtime = peerRuntime();\nconst bridgeDirectory = dirname(fileURLToPath(import.meta.url));\nconst packageRoot = dirname(bridgeDirectory);\nconst compatible = (peer: { build?: unknown }): boolean => {\n try {\n const metadata = JSON.parse(\n readFileSync(join(packageRoot, \"package.json\"), \"utf8\"),\n );\n const build = runtimeBuild(\n metadata.version,\n basename(bridgeDirectory) === \"bin\"\n ? join(packageRoot, \"extension\", \"index.ts\")\n : join(packageRoot, \"dist\", \"index.js\"),\n );\n return (\n isRuntimeBuild(build) &&\n isRuntimeBuild(peer.build) &&\n sameRuntimeBuild(build, peer.build)\n );\n } catch {\n return false;\n }\n};\nlet recoveringStatus = false;\nconst syncDirectory = (directory: string): void => {\n if (process.platform === \"win32\") return;\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n};\nif (action === \"probe\") {\n const peers = listPeerLeadRecords(runtime);\n let ordinaryLeadsComplete = true;\n let eligibleLeads: typeof peers = [];\n try {\n const assignments = globalProjectAssignmentSnapshot();\n eligibleLeads = peers.filter((peer) =>\n isRemoteOrdinaryLead(peer, assignments),\n );\n } catch {\n ordinaryLeadsComplete = false;\n }\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n peers: [\n ...peers.filter((peer) => peer.role === \"manager\"),\n ...eligibleLeads,\n ],\n ordinaryLeadsComplete,\n }),\n );\n} else {\n const chunks: Buffer[] = [];\n let bytes = 0;\n for await (const chunk of process.stdin) {\n const buffer = Buffer.from(chunk);\n bytes += buffer.length;\n if (bytes > PEER_TRANSPORT_FRAME_LIMIT_BYTES)\n throw new Error(\"peer transfer exceeds the size limit\");\n chunks.push(buffer);\n }\n let envelope = JSON.parse(Buffer.concat(chunks).toString(\"utf8\")) as {\n record?: Record<string, any>;\n recipientClaimId?: unknown;\n attachments?: Array<{\n name?: unknown;\n ref?: unknown;\n marker?: unknown;\n text?: unknown;\n sha256?: unknown;\n }>;\n correspondence?: PeerCorrespondence;\n id?: string;\n expectedDataRoot?: string;\n capability?: string;\n originSession?: string;\n originGeneration?: string;\n recipientSession?: string;\n recipientGeneration?: string;\n previousOriginGeneration?: string;\n newRecipientGeneration?: string;\n replyId?: string;\n digest?: string;\n };\n if (action === \"status\") {\n const { id, originSession, recipientSession, digest, expectedDataRoot } =\n envelope;\n assertPeerDataRoot(herdsmanDataRoot(), expectedDataRoot ?? \"\");\n if (\n !process.env.SSH_CONNECTION ||\n typeof id !== \"string\" ||\n typeof originSession !== \"string\" ||\n typeof recipientSession !== \"string\" ||\n typeof digest !== \"string\" ||\n !/^[0-9a-f]{64}$/u.test(digest)\n )\n throw new Error(\"invalid peer acceptance status request\");\n const key = createHash(\"sha256\")\n .update(`${originSession}\\0${id}`)\n .digest(\"hex\");\n const marker = join(runtime.root, \"peer-acceptances\", `${key}.json`);\n try {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n status?: unknown;\n recipientSession?: unknown;\n transfer?: typeof envelope;\n };\n const status =\n prior.digest !== digest || prior.recipientSession !== recipientSession\n ? \"conflict\"\n : prior.status === \"accepted\"\n ? \"accepted\"\n : prior.status === \"pending\"\n ? \"pending\"\n : \"conflict\";\n if (status === \"pending\" && prior.transfer) {\n envelope = prior.transfer;\n action = \"accept\";\n recoveringStatus = true;\n } else {\n console.log(\n JSON.stringify({ dataRoot: herdsmanDataRoot(), id, digest, status }),\n );\n process.exit(0);\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n id,\n digest,\n status: \"absent\",\n }),\n );\n }\n if (action === \"status\") process.exit(0);\n }\n if (action !== \"accept\") {\n const {\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n previousOriginGeneration,\n } = envelope;\n if (\n typeof id !== \"string\" ||\n typeof capability !== \"string\" ||\n typeof originSession !== \"string\" ||\n typeof originGeneration !== \"string\" ||\n typeof recipientSession !== \"string\" ||\n typeof recipientGeneration !== \"string\"\n )\n throw new Error(\"invalid peer correspondence request\");\n assertPeerDataRoot(herdsmanDataRoot(), envelope.expectedDataRoot ?? \"\");\n const liveRecipientGeneration =\n action === \"recover-recipient\"\n ? envelope.newRecipientGeneration\n : recipientGeneration;\n const runCorrespondenceOperation = (\n assignments?: Map<\n string,\n import(\"../extension/supervision.ts\").GlobalProjectAssignment[]\n >,\n ) => {\n const correspondence = readPeerCorrespondence(id);\n const correspondenceRole = correspondence?.role ?? \"manager\";\n const live = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === recipientSession &&\n peer.claim.id === liveRecipientGeneration,\n );\n const recipientIsLive =\n !!live &&\n (correspondenceRole === \"manager\"\n ? live.role === \"manager\"\n : correspondenceRole === \"lead\" &&\n !!assignments &&\n isRemoteOrdinaryLead(live, assignments));\n if (\n !recipientIsLive ||\n (action !== \"poll\" && !compatible(live!)) ||\n !correspondence ||\n correspondenceRole !== (correspondence?.role ?? \"manager\") ||\n correspondence.originSession !== originSession ||\n correspondence.recipientSession !== recipientSession ||\n correspondence.capability !== capability\n )\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (action === \"recover\") {\n if (typeof previousOriginGeneration !== \"string\")\n throw new Error(\"invalid peer correspondence recovery\");\n updatePeerOriginGeneration(\n id,\n capability,\n originSession,\n previousOriginGeneration,\n originGeneration,\n );\n console.log(JSON.stringify({ recovered: true, id }));\n } else if (action === \"recover-recipient\") {\n if (typeof envelope.newRecipientGeneration !== \"string\")\n throw new Error(\"invalid peer recipient recovery\");\n updatePeerRecipientGeneration(\n id,\n capability,\n recipientSession,\n recipientGeneration,\n envelope.newRecipientGeneration,\n );\n console.log(JSON.stringify({ recovered: true, id }));\n } else if (action === \"poll\") {\n let replies: ReturnType<typeof pollPeerReplies>;\n try {\n replies = pollPeerReplies(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n } catch (error) {\n const detail = error instanceof Error ? error.message : String(error);\n console.error(\n JSON.stringify({\n action: \"poll\",\n correspondenceId: id,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n expectedDataRoot: envelope.expectedDataRoot,\n error: detail,\n }),\n );\n process.exit(1);\n }\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies,\n hasReplies: (readPeerCorrespondence(id)?.replies.length ?? 0) > 0,\n }),\n );\n } else if (action === \"ack\") {\n if (typeof envelope.replyId !== \"string\")\n throw new Error(\"invalid reply acknowledgement\");\n acknowledgePeerReply(\n id,\n capability,\n envelope.replyId,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n console.log(\n JSON.stringify({ acknowledged: true, replyId: envelope.replyId }),\n );\n } else {\n finalizePeerCorrespondence(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n console.log(JSON.stringify({ finalized: true, id }));\n }\n };\n // Keep the live Lead check and every synchronous correspondence mutation/read\n // under the assignment authority lock; otherwise eligibility can be revoked\n // after the check but before an ACK discards the durable reply.\n const role = readPeerCorrespondence(id)?.role ?? \"manager\";\n if (role === \"lead\") {\n withProjectAssignmentAuthority((assignments) =>\n runCorrespondenceOperation(assignments),\n );\n } else {\n runCorrespondenceOperation();\n }\n process.exit(0);\n }\n const record = envelope.record;\n assertPeerDataRoot(herdsmanDataRoot(), envelope.expectedDataRoot ?? \"\");\n if (\n !record ||\n record.kind !== \"peer_message\" ||\n !record.peerSource ||\n typeof record.id !== \"string\" ||\n typeof record.fromSessionId !== \"string\" ||\n typeof record.toSessionId !== \"string\"\n )\n throw new Error(\"invalid peer transfer\");\n const correspondenceRole = envelope.correspondence?.role ?? \"manager\";\n const remoteOrdinarySource =\n record.peerSource.role === \"lead\" &&\n record.peerSource.remoteOrdinary === true &&\n Object.keys(record.peerSource).length === 2;\n if (\n (correspondenceRole !== \"manager\" && correspondenceRole !== \"lead\") ||\n (correspondenceRole === \"manager\" &&\n record.peerSource.role !== \"manager\") ||\n (correspondenceRole === \"lead\" && !remoteOrdinarySource)\n )\n throw new Error(\"peer source role does not match correspondence role\");\n if (!Array.isArray(envelope.attachments) || envelope.attachments.length > 32)\n throw new Error(\"invalid peer transfer evidence\");\n const connection = process.env.SSH_CONNECTION;\n if (!connection)\n throw new Error(\"authenticated SSH connection identity is unavailable\");\n if (\n !envelope.correspondence ||\n envelope.correspondence.recipientSession !== record.toSessionId ||\n envelope.correspondence.recipientGeneration !== envelope.recipientClaimId ||\n envelope.correspondence.originSession !== record.fromSessionId ||\n envelope.correspondence.originGeneration !== record.leaseId\n )\n throw new Error(\"peer correspondence does not match message route\");\n const digest = peerPayloadDigest({\n record,\n attachments: envelope.attachments,\n });\n const markerDir = join(runtime.root, \"peer-acceptances\");\n const key = createHash(\"sha256\")\n .update(`${record.fromSessionId}\\0${record.id}`)\n .digest(\"hex\");\n const marker = join(markerDir, `${key}.json`);\n let acceptedRace = false;\n try {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n status?: unknown;\n recipientSession?: unknown;\n transfer?: typeof envelope;\n };\n if (\n prior.digest !== digest ||\n prior.recipientSession !== record.toSessionId\n )\n throw new Error(\"conflicting peer message identity\");\n if (prior.status === \"accepted\") {\n console.log(JSON.stringify({ accepted: true, id: record.id }));\n process.exit(0);\n }\n if (prior.status !== \"pending\" || !prior.transfer)\n throw new Error(\"invalid pending peer message acceptance\");\n if (\n prior.transfer.record?.id !== record.id ||\n prior.transfer.record?.fromSessionId !== record.fromSessionId ||\n prior.transfer.record?.toSessionId !== record.toSessionId ||\n (prior.transfer.correspondence?.role ?? \"manager\") !==\n correspondenceRole ||\n peerPayloadDigest({\n record: prior.transfer.record,\n attachments: prior.transfer.attachments ?? [],\n }) !== prior.digest\n )\n throw new Error(\"invalid pending peer message transfer\");\n envelope = prior.transfer;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n const liveRecipient = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n const authorized =\n liveRecipient &&\n (correspondenceRole === \"manager\"\n ? liveRecipient.role === \"manager\"\n : withProjectAssignmentAuthority((assignments) =>\n isRemoteOrdinaryLead(liveRecipient, assignments),\n ));\n if (!authorized || !compatible(liveRecipient))\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n mkdirSync(markerDir, { recursive: true, mode: 0o700 });\n syncDirectory(runtime.root);\n const content = `${JSON.stringify({ connection, digest, status: \"pending\", recipientSession: record.toSessionId, transfer: envelope })}\\n`;\n const temp = `${marker}.${randomUUID()}.tmp`;\n let fd: number | undefined;\n try {\n fd = openSync(temp, \"wx\", 0o600);\n const bytes = Buffer.from(content, \"utf8\");\n let offset = 0;\n while (offset < bytes.length) {\n const requested = bytes.length - offset;\n const length = pendingMarkerWriteLimitForTests(requested);\n if (!Number.isInteger(length) || length <= 0 || length > requested)\n throw new Error(\"invalid pending peer acceptance write length\");\n const written = writeSync(fd, bytes, offset, length);\n if (\n !Number.isInteger(written) ||\n written <= 0 ||\n written > bytes.length - offset\n )\n throw new Error(\n \"unable to write complete pending peer acceptance marker\",\n );\n offset += written;\n afterPendingMarkerTempWriteForTests();\n }\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n beforePendingMarkerPublishForTests(marker, content);\n let alreadyExists = false;\n try {\n linkSync(temp, marker);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n alreadyExists = true;\n }\n syncDirectory(markerDir);\n if (alreadyExists) {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n recipientSession?: unknown;\n status?: unknown;\n transfer?: typeof envelope;\n };\n if (\n prior.digest !== digest ||\n prior.recipientSession !== record.toSessionId\n )\n throw new Error(\"conflicting peer message identity\");\n if (prior.status === \"accepted\") acceptedRace = true;\n else if (\n prior.status !== \"pending\" ||\n !prior.transfer ||\n prior.transfer.record?.id !== record.id ||\n prior.transfer.record?.fromSessionId !== record.fromSessionId ||\n prior.transfer.record?.toSessionId !== record.toSessionId ||\n (prior.transfer.correspondence?.role ?? \"manager\") !==\n correspondenceRole ||\n peerPayloadDigest({\n record: prior.transfer.record,\n attachments: prior.transfer.attachments ?? [],\n }) !== prior.digest\n )\n throw new Error(\"invalid pending peer message acceptance\");\n else envelope = prior.transfer;\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n rmSync(temp, { force: true });\n }\n if (!acceptedRace) afterDurablePeerAcceptanceStep(\"pending-marker-durable\");\n }\n acceptTransfer: {\n if (acceptedRace) {\n console.log(JSON.stringify({ accepted: true, id: record.id }));\n break acceptTransfer;\n }\n if (\n !envelope.correspondence ||\n envelope.correspondence.recipientSession !== record.toSessionId ||\n envelope.correspondence.recipientGeneration !==\n envelope.recipientClaimId ||\n envelope.correspondence.originSession !== record.fromSessionId ||\n envelope.correspondence.originGeneration !== record.leaseId\n )\n throw new Error(\"peer correspondence does not match message route\");\n const receivedRefs: string[] = [];\n let receivedText = record.text as string;\n for (const attachment of envelope.attachments) {\n if (\n typeof attachment.name !== \"string\" ||\n typeof attachment.marker !== \"string\" ||\n typeof attachment.text !== \"string\" ||\n typeof attachment.sha256 !== \"string\" ||\n !/^[0-9a-f]{64}$/u.test(attachment.sha256)\n )\n throw new Error(\"invalid peer attachment metadata\");\n const contentDigest = createHash(\"sha256\")\n .update(attachment.text, \"utf8\")\n .digest(\"hex\");\n if (contentDigest !== attachment.sha256)\n throw new Error(\"peer attachment integrity check failed\");\n const markerIndex = receivedText.indexOf(attachment.marker);\n if (\n markerIndex < 0 ||\n receivedText.indexOf(attachment.marker, markerIndex + 1) !== -1\n )\n throw new Error(\"peer attachment marker is missing or ambiguous\");\n receivedText =\n receivedText.slice(0, markerIndex) +\n attachment.text +\n receivedText.slice(markerIndex + attachment.marker.length);\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n if (binding && !isCanonicalResultRef(binding.canonicalRef))\n throw new Error(\"invalid peer result artifact\");\n const path = binding\n ? resultPath(binding.canonicalRef.slice(\"result:\".length))\n : peerAttachmentPath(attachment.name, attachment.text);\n receivedRefs.push(\n `${attachment.name}: ${binding ? `${binding.ref} (canonical ${binding.canonicalRef})` : path}`,\n );\n }\n const acceptedRecord = {\n ...record,\n ...(receivedRefs.length\n ? {\n text: `${receivedText}\\n\\nForwardable received files:\\n${receivedRefs.join(\"\\n\")}`,\n }\n : { text: receivedText }),\n };\n const accepted = acceptedRecord as never;\n let published = false;\n try {\n const existing = readCoordinationMessage(\n chiefMessagePath(runtime, record.toSessionId, record.id),\n );\n if (!isDeepStrictEqual(existing, accepted))\n throw new Error(\"conflicting peer inbox message identity\");\n published = true;\n } catch (error) {\n const cause = error instanceof Error ? error.cause : undefined;\n if ((cause as NodeJS.ErrnoException | undefined)?.code !== \"ENOENT\")\n throw error;\n }\n const acceptedDigest = coordinationMessageDigest(accepted);\n if (\n !published &&\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n published = true;\n if (!published) {\n const liveRecipient = listPeerLeadRecords(runtime).find(\n (peer) => peer.piSessionId === record.toSessionId,\n );\n if (!liveRecipient || !compatible(liveRecipient))\n throw new Error(\n correspondenceRole === \"manager\"\n ? \"exact destination Manager is not live\"\n : \"exact correspondence recipient is not live\",\n );\n if (liveRecipient.claim.id !== envelope.recipientClaimId) {\n envelope = {\n ...envelope,\n recipientClaimId: liveRecipient.claim.id,\n correspondence: {\n ...envelope.correspondence,\n recipientGeneration: liveRecipient.claim.id,\n },\n };\n const pendingTemp = `${marker}.${randomUUID()}.tmp`;\n try {\n writeFileSync(\n pendingTemp,\n `${JSON.stringify({ connection, digest, status: \"pending\", recipientSession: record.toSessionId, transfer: envelope })}\\n`,\n { encoding: \"utf8\", flag: \"wx\", mode: 0o600, flush: true },\n );\n renameSync(pendingTemp, marker);\n } finally {\n rmSync(pendingTemp, { force: true });\n }\n syncDirectory(markerDir);\n }\n for (const attachment of envelope.attachments) {\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n if (binding)\n persistPeerResultArtifact(\n binding.canonicalRef,\n attachment.text as string,\n );\n else\n persistPeerAttachment(\n attachment.name as string,\n attachment.text as string,\n );\n }\n } else {\n for (const attachment of envelope.attachments) {\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n const path = binding\n ? resultPath(binding.canonicalRef.slice(\"result:\".length))\n : peerAttachmentPath(\n attachment.name as string,\n attachment.text as string,\n );\n if (\n !readFileSync(path).equals(\n Buffer.from(attachment.text as string, \"utf8\"),\n )\n )\n throw new Error(\"peer attachment content identity collision\");\n }\n verifyPeerCorrespondence(envelope.correspondence!);\n }\n const publish = () => {\n if (published && correspondenceRole === \"manager\") {\n return;\n }\n const current = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n const authorized =\n current &&\n (correspondenceRole === \"manager\"\n ? current.role === \"manager\"\n : isRemoteOrdinaryLead(current, globalProjectAssignmentSnapshot()));\n if (!authorized || (!published && !compatible(current)))\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (!published) {\n if (\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n verifyPeerCorrespondence(envelope.correspondence!);\n else {\n storePeerCorrespondence(envelope.correspondence!);\n writeCoordinationMessage(accepted, runtime);\n }\n }\n };\n if (correspondenceRole === \"lead\") {\n withProjectAssignmentAuthority((assignments) => {\n const current = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n if (\n !current ||\n !isRemoteOrdinaryLead(current, assignments) ||\n (!published && !compatible(current))\n )\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (!published) {\n if (\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n verifyPeerCorrespondence(envelope.correspondence!);\n else {\n storePeerCorrespondence(envelope.correspondence!);\n writeCoordinationMessage(accepted, runtime);\n }\n }\n });\n } else publish();\n if (!published) afterDurablePeerAcceptanceStep(\"inbox-publication-durable\");\n const markerTemp = `${marker}.${randomUUID()}.tmp`;\n try {\n writeFileSync(\n markerTemp,\n `${JSON.stringify({ connection, digest, status: \"accepted\", recipientSession: record.toSessionId })}\\n`,\n {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n },\n );\n afterAcceptedMarkerTempWriteForTests(markerTemp, marker);\n renameSync(markerTemp, marker);\n } finally {\n rmSync(markerTemp, { force: true });\n }\n syncDirectory(markerDir);\n console.log(\n JSON.stringify(\n recoveringStatus\n ? {\n dataRoot: herdsmanDataRoot(),\n id: record.id,\n digest,\n status: \"accepted\",\n }\n : { accepted: true, id: record.id },\n ),\n );\n }\n}\n", "import { createHash } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport { fail } from \"./errors.ts\";\n\nconst SHA256 = /^[0-9a-f]{64}$/;\n\nexport type RuntimeBuild = Readonly<{\n version: string;\n sha256: string;\n}>;\n\nexport function runtimeBuild(version: string, path: string): RuntimeBuild {\n return Object.freeze({\n version,\n sha256: createHash(\"sha256\").update(readFileSync(path)).digest(\"hex\"),\n });\n}\n\nexport function isRuntimeBuild(value: unknown): value is RuntimeBuild {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\n const record = value as Record<string, unknown>;\n return (\n Object.keys(record).length === 2 &&\n typeof record.version === \"string\" &&\n record.version.length > 0 &&\n record.version.length <= 128 &&\n typeof record.sha256 === \"string\" &&\n SHA256.test(record.sha256)\n );\n}\n\nexport function sameRuntimeBuild(\n left: RuntimeBuild,\n right: RuntimeBuild,\n): boolean {\n return left.version === right.version && left.sha256 === right.sha256;\n}\n\nexport function formatRuntimeBuild(build: RuntimeBuild): string {\n return `v${build.version} \u00B7 ${build.sha256.slice(0, 12)}`;\n}\n\nexport function requireCompatibleBuild(\n local: RuntimeBuild,\n remote: RuntimeBuild | undefined,\n operation: string,\n target: string,\n): asserts remote is RuntimeBuild {\n if (remote && sameRuntimeBuild(local, remote)) return;\n\n fail(\n \"incompatible_build\",\n remote\n ? `Pi Herdsman build mismatch for ${target}: local ${formatRuntimeBuild(local)}, target ${formatRuntimeBuild(remote)}.`\n : `Cannot establish Pi Herdsman build compatibility for ${target}; the target predates the current runtime identity contract.`,\n operation,\n {\n nextAction: remote\n ? \"Restart the Pi session that remained running across the Herdsman update. If uncertain, restart this session and any still-running target session, then retry.\"\n : `Restart ${target} so it reloads the current Pi Herdsman build.`,\n details: { localBuild: local, remoteBuild: remote ?? null },\n },\n );\n}\n", "import type { Dirent } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport {\n chmodSync,\n closeSync,\n constants,\n fstatSync,\n fsyncSync,\n mkdirSync,\n openSync,\n readdirSync,\n readFileSync,\n renameSync,\n lstatSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst RESULT_PREFIX = \"result:\";\nconst RESULT_ID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\nconst SEMANTIC_RESULT_REF = /^result:([a-z][a-z0-9_-]{0,31})#([1-9][0-9]*)$/;\nconst SEMANTIC_EVIDENCE_REF =\n /^evidence:([a-z][a-z0-9_-]{0,31})#([1-9][0-9]*)$/;\nconst INCIDENTAL_METADATA = new Set([\n \".ds_store\",\n \"desktop.ini\",\n \"thumbs.db\",\n \".directory\",\n]);\n\nexport function isIncidentalMetadata(entry: Dirent): boolean {\n return entry.isFile() && INCIDENTAL_METADATA.has(entry.name.toLowerCase());\n}\n\nexport type ResultBinding = Readonly<{\n ref: string;\n canonicalRef: string;\n}>;\n\nexport type RequiredEvidence = Readonly<\n | {\n id: string;\n ref?: string;\n name: string;\n sourceAssignmentId: string;\n path: string;\n sha256: string;\n }\n | { id: string; name: string; result: ResultBinding }\n>;\n\nconst EVIDENCE_ID = RESULT_ID;\nconst EVIDENCE_SNAPSHOT_MAX_BYTES = 1024 * 1024;\n\nexport function isRequiredEvidence(value: unknown): value is RequiredEvidence {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n if (\n typeof r.id !== \"string\" ||\n !EVIDENCE_ID.test(r.id) ||\n typeof r.name !== \"string\" ||\n !r.name ||\n r.name.length > 255\n )\n return false;\n if (Object.hasOwn(r, \"result\"))\n return Object.keys(r).length === 3 && isResultBinding(r.result);\n const keys = Object.keys(r).sort();\n const legacyKeys = [\"id\", \"name\", \"path\", \"sha256\", \"sourceAssignmentId\"];\n const semanticKeys = [...legacyKeys, \"ref\"].sort();\n return (\n (keys.join(\"\\0\") === legacyKeys.join(\"\\0\") ||\n keys.join(\"\\0\") === semanticKeys.join(\"\\0\")) &&\n (!Object.hasOwn(r, \"ref\") || isCanonicalSemanticEvidenceRef(r.ref)) &&\n typeof r.sourceAssignmentId === \"string\" &&\n EVIDENCE_ID.test(r.sourceAssignmentId) &&\n typeof r.path === \"string\" &&\n r.path.length > 0 &&\n typeof r.sha256 === \"string\" &&\n /^[a-f0-9]{64}$/.test(r.sha256)\n );\n}\n\nexport function isCanonicalSemanticEvidenceRef(\n value: unknown,\n): value is string {\n if (typeof value !== \"string\") return false;\n const match = SEMANTIC_EVIDENCE_REF.exec(value);\n return !!match && Number.isSafeInteger(Number(match[2]));\n}\n\n/** Existing result identities remain unchanged; legacy snapshots must be upgraded before display. */\nexport function semanticEvidenceRef(evidence: RequiredEvidence): string {\n if (\"result\" in evidence) return evidence.result.ref;\n if (!evidence.ref)\n throw new Error(\"required evidence has no semantic reference\");\n return evidence.ref;\n}\n\n/** Lazily gives pre-reference snapshots one durable identity without changing snapshot provenance. */\nexport function upgradeRequiredEvidence(value: unknown): RequiredEvidence {\n if (!isRequiredEvidence(value)) throw new Error(\"invalid required evidence\");\n if (\"result\" in value || value.ref) return value;\n const ref = reserveSemanticEvidenceRef(value.id, value.name);\n return { ...value, ref };\n}\n\n/** Checks an existing snapshot identity without allocating or repairing it. */\nexport function verifySemanticEvidenceReservation(\n evidenceId: string,\n ref: string,\n): void {\n if (!EVIDENCE_ID.test(evidenceId) || !isCanonicalSemanticEvidenceRef(ref))\n throw new Error(\"invalid semantic evidence reservation\");\n const match = SEMANTIC_EVIDENCE_REF.exec(ref)!;\n const root = join(herdsmanDataRoot(), \"evidence-ref-reservations\");\n const paths = [\n join(root, \"by-id\", evidenceId),\n join(root, \"refs\", match[1]!, match[2]!),\n ];\n const contents = paths.map((path) => {\n const stat = lstatSync(path);\n if (!stat.isFile() || stat.isSymbolicLink())\n throw new Error(\"invalid semantic evidence reservation\");\n return readFileSync(path, \"utf8\");\n });\n const [byId, byRef] = contents;\n if (byId !== `${ref}\\n` || byRef !== `${evidenceId}\\n`)\n throw new Error(\"invalid semantic evidence reservation\");\n}\n\n/** Upgrades legacy snapshots first, then verifies the durable identity. */\nexport function upgradeAndVerifyRequiredEvidence(\n value: unknown,\n): RequiredEvidence {\n const evidence = upgradeRequiredEvidence(value);\n if (!(\"result\" in evidence))\n verifySemanticEvidenceReservation(evidence.id, evidence.ref!);\n return evidence;\n}\n\nexport function requiredEvidenceDirectory(assignmentId: string): string {\n if (!EVIDENCE_ID.test(assignmentId))\n throw new Error(\"invalid evidence assignment id\");\n return join(herdsmanDataRoot(), \"evidence\", assignmentId);\n}\n\nfunction assertEvidenceDirectory(\n assignmentId: string,\n create: boolean,\n): string {\n const directory = requiredEvidenceDirectory(assignmentId);\n const paths = [\n herdsmanDataRoot(),\n join(herdsmanDataRoot(), \"evidence\"),\n directory,\n ];\n for (const path of paths) {\n if (create) {\n try {\n mkdirSync(path, { mode: 0o700 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n }\n const stat = lstatSync(path);\n if (!stat.isDirectory() || stat.isSymbolicLink())\n throw new Error(\"required evidence directory is unsafe\");\n }\n return directory;\n}\n\nfunction safeEvidenceName(name: string): string {\n const base = basename(name)\n .replace(/[^A-Za-z0-9._-]/g, \"_\")\n .slice(0, 100);\n return base || \"evidence.txt\";\n}\n\n/** Persist validated UTF-8 text under private storage; returns its immutable identity. */\nexport function persistRequiredEvidenceSnapshot(\n assignmentId: string,\n name: string,\n text: string,\n): RequiredEvidence {\n const bytes = Buffer.from(text, \"utf8\");\n if (\n bytes.length > EVIDENCE_SNAPSHOT_MAX_BYTES ||\n bytes.includes(0) ||\n new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes) !== text\n )\n throw new Error(\n \"Required evidence must be supported UTF-8 text no larger than 1 MiB\",\n );\n const directory = assertEvidenceDirectory(assignmentId, true);\n chmodSync(directory, 0o700);\n const id = randomUUID();\n const path = join(directory, `${id}-${safeEvidenceName(name)}`);\n const temporary = `${path}.${randomUUID()}.tmp`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, bytes);\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n assertEvidenceDirectory(assignmentId, false);\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n if (process.platform !== \"win32\") {\n const dirFd = openSync(directory, \"r\");\n try {\n fsyncSync(dirFd);\n } finally {\n closeSync(dirFd);\n }\n }\n return {\n id,\n ref: reserveSemanticEvidenceRef(id, name),\n name: safeEvidenceName(name),\n sourceAssignmentId: assignmentId,\n path,\n sha256: createHash(\"sha256\").update(bytes).digest(\"hex\"),\n };\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function reserveSemanticEvidenceRef(\n evidenceId: string,\n name: string,\n): string {\n if (!EVIDENCE_ID.test(evidenceId)) throw new Error(\"invalid evidence id\");\n const root = join(herdsmanDataRoot(), \"evidence-ref-reservations\");\n const byId = join(root, \"by-id\");\n mkdirSync(byId, { recursive: true, mode: 0o700 });\n chmodSync(byId, 0o700);\n const mapping = join(byId, evidenceId);\n try {\n const existing = readFileSync(mapping, \"utf8\").trim();\n if (isCanonicalSemanticEvidenceRef(existing)) return existing;\n throw new Error(\"invalid semantic evidence reservation\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n\n const label =\n safeEvidenceName(name)\n .replace(/\\.[^.]*$/, \"\")\n .toLowerCase()\n .replace(/[^a-z0-9_-]+/g, \"-\")\n .replace(/^[^a-z]+/, \"\")\n .slice(0, 32) || \"evidence\";\n const directory = join(root, \"refs\", label);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n let index = 1;\n for (const entry of readdirSync(directory)) {\n if (/^[1-9][0-9]*$/.test(entry)) index = Math.max(index, Number(entry) + 1);\n }\n for (;;) {\n if (!Number.isSafeInteger(index))\n throw new Error(\"Semantic evidence index exhausted\");\n const ref = `evidence:${label}#${index}`;\n try {\n writeFileSync(join(directory, String(index)), `${evidenceId}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n try {\n writeFileSync(mapping, `${ref}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n return reserveSemanticEvidenceRef(evidenceId, name);\n }\n return ref;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n index++;\n continue;\n }\n throw error;\n }\n }\n}\n\n/** Read only the exact regular snapshot for this assignment and verify its digest. */\nexport function readRequiredEvidenceSnapshot(\n assignmentId: string,\n evidence: RequiredEvidence,\n): string {\n if (!isRequiredEvidence(evidence) || \"result\" in evidence)\n throw new Error(\"invalid required evidence snapshot\");\n if (evidence.sourceAssignmentId !== assignmentId)\n throw new Error(\"required evidence source assignment mismatch\");\n const directory = requiredEvidenceDirectory(evidence.sourceAssignmentId);\n if (\n evidence.path !==\n join(directory, `${evidence.id}-${safeEvidenceName(evidence.name)}`)\n )\n throw new Error(\"required evidence path mismatch\");\n assertEvidenceDirectory(evidence.sourceAssignmentId, false);\n const before = lstatSync(evidence.path);\n if (\n !before.isFile() ||\n before.isSymbolicLink() ||\n before.size > EVIDENCE_SNAPSHOT_MAX_BYTES\n )\n throw new Error(\n \"required evidence snapshot is missing, unsafe, or oversized\",\n );\n const fd = openSync(\n evidence.path,\n constants.O_RDONLY |\n (constants.O_NOFOLLOW ?? 0) |\n (constants.O_NONBLOCK ?? 0),\n );\n try {\n const opened = fstatSync(fd);\n if (\n !opened.isFile() ||\n opened.dev !== before.dev ||\n opened.ino !== before.ino\n )\n throw new Error(\"required evidence snapshot changed during read\");\n const bytes = readFileSync(fd);\n if (\n bytes.length > EVIDENCE_SNAPSHOT_MAX_BYTES ||\n createHash(\"sha256\").update(bytes).digest(\"hex\") !== evidence.sha256\n )\n throw new Error(\"required evidence snapshot integrity check failed\");\n return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } finally {\n closeSync(fd);\n }\n}\n\nexport function parseSemanticResultRef(\n input: string,\n): { agent: string; index: number } | undefined {\n const match = SEMANTIC_RESULT_REF.exec(input);\n if (!match) return undefined;\n\n const index = Number(match[2]);\n if (!Number.isSafeInteger(index)) return undefined;\n\n return { agent: match[1], index };\n}\n\nexport function isCanonicalResultRef(value: unknown): value is string {\n return (\n typeof value === \"string\" &&\n value.startsWith(RESULT_PREFIX) &&\n RESULT_ID.test(value.slice(RESULT_PREFIX.length))\n );\n}\n\nexport function isResultBinding(value: unknown): value is ResultBinding {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\n const record = value as Record<string, unknown>;\n return (\n Object.keys(record).length === 2 &&\n typeof record.ref === \"string\" &&\n !!parseSemanticResultRef(record.ref) &&\n isCanonicalResultRef(record.canonicalRef)\n );\n}\n\nexport function herdsmanDataRoot(): string {\n return join(nodeOnlyAgentDir(), \"pi-herdsman\");\n}\n\n/** Match Pi 1.3.0 getAgentDir() normalization without importing the Pi SDK. */\nexport function nodeOnlyAgentDir(): string {\n let directory = process.env.PI_CODING_AGENT_DIR;\n if (!directory) return join(homedir(), \".pi\", \"agent\");\n\n if (\n process.platform === \"win32\" &&\n directory.startsWith(\"/\") &&\n !directory.startsWith(\"//\") &&\n !directory.includes(\"\\\\\")\n ) {\n const match = directory.match(\n /^\\/(?:mnt\\/|cygdrive\\/)?([a-z])(?:\\/(.*))?$/i,\n );\n if (match)\n directory = `${match[1].toUpperCase()}:\\\\${(match[2] ?? \"\").replaceAll(\"/\", \"\\\\\")}`;\n }\n if (directory === \"~\") return homedir();\n if (\n directory.startsWith(\"~/\") ||\n (process.platform === \"win32\" && directory.startsWith(\"~\\\\\"))\n )\n return join(homedir(), directory.slice(2));\n if (/^file:\\/\\//.test(directory)) return fileURLToPath(directory);\n return directory;\n}\n\nexport function herdsmanConfigPath(): string {\n return join(herdsmanDataRoot(), \"config.json\");\n}\n\nexport function herdsmanTempRoot(): string {\n return join(tmpdir(), `pi-herdsman-${process.getuid?.() ?? \"user\"}`);\n}\n\nfunction validateResultId(requestId: string): void {\n if (!RESULT_ID.test(requestId)) throw new Error(\"invalid result request id\");\n}\n\nexport function resultPath(requestId: string): string {\n validateResultId(requestId);\n return join(herdsmanDataRoot(), \"results\", requestId);\n}\n\nexport function peerAttachmentPath(name: string, text: string): string {\n if (\n typeof name !== \"string\" ||\n !name ||\n name.length > 255 ||\n /[\\\\/\\0]/u.test(name) ||\n typeof text !== \"string\"\n )\n throw new Error(\"invalid peer attachment\");\n const bytes = Buffer.from(text, \"utf8\");\n if (new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes) !== text)\n throw new Error(\"invalid peer attachment text\");\n const directory = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"peers-v2\",\n \"received-evidence\",\n );\n const digest = createHash(\"sha256\").update(bytes).digest(\"hex\");\n return join(directory, `${digest}-${name}`);\n}\n\n/** Persist a received text attachment as immutable recipient-local content. */\nexport function persistPeerAttachment(name: string, text: string): string {\n const path = peerAttachmentPath(name, text);\n const bytes = Buffer.from(text, \"utf8\");\n mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n chmodSync(dirname(path), 0o700);\n try {\n writeFileSync(path, bytes, { flag: \"wx\", mode: 0o600, flush: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n if (!readFileSync(path).equals(bytes))\n throw new Error(\"peer attachment content identity collision\");\n }\n return path;\n}\n\n/** Import a forwarded result artifact without allowing canonical-ID rebinding. */\nexport function persistPeerResultArtifact(\n canonicalRef: string,\n text: string,\n): string {\n if (!isCanonicalResultRef(canonicalRef) || typeof text !== \"string\")\n throw new Error(\"invalid peer result artifact\");\n const path = resultPath(canonicalRef.slice(RESULT_PREFIX.length));\n mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n chmodSync(dirname(path), 0o700);\n const bytes = Buffer.from(text, \"utf8\");\n try {\n writeFileSync(path, bytes, { flag: \"wx\", mode: 0o600, flush: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n if (!readFileSync(path).equals(bytes))\n throw new Error(\"peer result identity collision\");\n }\n return path;\n}\n\nexport function resultRef(requestId: string): string {\n validateResultId(requestId);\n return `${RESULT_PREFIX}${requestId}`;\n}\n\nexport function reserveSemanticResultRef(\n agentLabel: string,\n minimumIndex = 1,\n): Readonly<{ ref: string; index: number }> {\n if (!parseSemanticResultRef(`result:${agentLabel}#${minimumIndex}`))\n throw new Error(\"Invalid semantic result identity\");\n\n const directory = join(\n herdsmanDataRoot(),\n \"result-ref-reservations\",\n agentLabel,\n );\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n\n let index = minimumIndex;\n // ponytail: immutable reservation scan; replace with a counter only if\n // allocation volume makes this measurably expensive.\n for (const name of readdirSync(directory)) {\n if (!/^[1-9][0-9]*$/.test(name)) continue;\n const reserved = Number(name);\n if (Number.isSafeInteger(reserved)) index = Math.max(index, reserved + 1);\n }\n\n for (;;) {\n if (!Number.isSafeInteger(index))\n throw new Error(\"Semantic result index exhausted\");\n try {\n writeFileSync(join(directory, String(index)), \"reserved\\n\", {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n if (process.platform !== \"win32\") {\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n }\n return { index, ref: `result:${agentLabel}#${index}` };\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n index++;\n continue;\n }\n throw error;\n }\n }\n}\n\nexport function resolveResultRef(input: string): string | undefined {\n if (!input.startsWith(RESULT_PREFIX)) return undefined;\n return resultPath(input.slice(RESULT_PREFIX.length));\n}\n", "import { constants } from \"node:fs\";\nimport {\n chmodSync,\n closeSync,\n fsyncSync,\n lstatSync,\n fstatSync,\n readdirSync,\n rmSync,\n mkdirSync,\n openSync,\n readFileSync,\n readSync,\n statSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, isAbsolute, join, normalize } from \"node:path\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport {\n acquireProcessLock,\n ProcessLockOccupiedError,\n isProcessLockClaim,\n readLiveProcessLock,\n readProcessLockStatus,\n type ProcessLockClaim,\n} from \"./lock.ts\";\nimport {\n herdsmanDataRoot,\n isIncidentalMetadata,\n isResultBinding,\n isRequiredEvidence,\n upgradeAndVerifyRequiredEvidence,\n verifySemanticEvidenceReservation,\n type RequiredEvidence,\n type ResultBinding,\n} from \"./storage.ts\";\nimport {\n isRuntimeBuild,\n sameRuntimeBuild,\n type RuntimeBuild,\n} from \"./compatibility.ts\";\nimport type { ExtensionContext } from \"@earendil-works/pi-coding-agent\";\n\n// Authority edges are deliberately asymmetric: Chief -> Manager -> Lead -> Agent.\n// Staff and supervisor cross one edge; only Lead/Manager sessions may be peers.\nexport type SessionRole = \"lead\" | \"manager\" | \"chief\";\nexport type CoordinatorRole = \"lead\" | \"manager\";\nexport type PeerRole = CoordinatorRole;\nexport type LeadRole = SessionRole;\n\nexport type SessionKindEntry =\n | { version: 1; sessionId: string; kind: \"ordinary\" }\n | {\n version: 1;\n sessionId: string;\n kind: \"managed\";\n repoKey: string;\n branch: string;\n };\n\n// Identity is session-wide, unlike branch-local role and execution preferences.\nexport function readSessionKind(\n entries: readonly unknown[],\n sessionId: string,\n): SessionKindEntry | undefined {\n let identity: SessionKindEntry | undefined;\n for (const candidate of entries as readonly any[]) {\n if (\n candidate?.type !== \"custom\" ||\n candidate.customType !== \"pi-herdsman-session-kind\" ||\n candidate.data?.sessionId !== sessionId\n )\n continue;\n const data = candidate.data;\n if (\n !validSession(sessionId) ||\n Array.isArray(data) ||\n data.version !== 1 ||\n (data.kind !== \"ordinary\" && data.kind !== \"managed\") ||\n Object.keys(data).length !== (data.kind === \"managed\" ? 5 : 3) ||\n (data.kind === \"managed\" &&\n (typeof data.repoKey !== \"string\" ||\n !data.repoKey.trim() ||\n typeof data.branch !== \"string\" ||\n !data.branch.trim()))\n )\n throw new Error(\"invalid pi-herdsman-session-kind entry\");\n if (identity && !isDeepStrictEqual(identity, data))\n throw new Error(\"conflicting pi-herdsman-session-kind entries\");\n identity = data;\n }\n return identity;\n}\n\nexport type LeadRoleState = Readonly<{\n role: LeadRole;\n leadTools: readonly string[];\n}>;\n\nexport function sessionLeadRoleState(\n entries: readonly unknown[],\n sessionId: string,\n): LeadRoleState | undefined {\n let state: LeadRoleState | undefined;\n for (const candidate of entries as readonly any[]) {\n if (\n candidate?.type !== \"custom\" ||\n candidate.customType !== \"pi-herdsman-role\" ||\n candidate.data?.sessionId !== sessionId\n )\n continue;\n const data = candidate.data;\n if (\n !data ||\n typeof data !== \"object\" ||\n Array.isArray(data) ||\n Object.keys(data).length !== 3 ||\n !Object.hasOwn(data, \"role\") ||\n !Object.hasOwn(data, \"leadTools\") ||\n (data.role !== \"lead\" &&\n data.role !== \"manager\" &&\n data.role !== \"chief\") ||\n !Array.isArray(data.leadTools) ||\n data.leadTools.some(\n (name: unknown) => typeof name !== \"string\" || name.length === 0,\n ) ||\n new Set(data.leadTools).size !== data.leadTools.length\n )\n throw new Error(\"invalid pi-herdsman-role entry\");\n state = { role: data.role, leadTools: [...data.leadTools] };\n }\n return state;\n}\n\nexport type ChiefDescriptor = {\n version: 1;\n build?: RuntimeBuild;\n leaseId: string;\n claim: ProcessLockClaim;\n piSessionId: string;\n piSessionFile?: string;\n paneId: string;\n tabId?: string;\n workspaceId: string;\n createdAt: number;\n};\n\nexport type ChiefIdentity = Omit<\n ChiefDescriptor,\n \"version\" | \"leaseId\" | \"claim\" | \"createdAt\"\n> & {\n build: RuntimeBuild;\n createdAt?: number;\n};\n\nexport type SupervisionRuntime = {\n root: string;\n lock: string;\n descriptor: string;\n inbox: string;\n coordinators: string;\n managers: string;\n assignments: string;\n /** Old caller spelling until the integration lane switches to coordinators. */\n leads: string;\n};\n\nexport type ChiefLease = {\n descriptor: ChiefDescriptor;\n runtime: SupervisionRuntime;\n release: () => void;\n};\n\nexport const COORDINATION_MESSAGE_KINDS = [\n \"chief_message\",\n \"lead_message\",\n \"manager_message\",\n \"project_assignment\",\n \"peer_message\",\n] as const;\n\nexport type ChiefMessageKind = (typeof COORDINATION_MESSAGE_KINDS)[number];\n\n/** Shared durable transport record used by Chief and Lead peer traffic. */\nexport type CoordinationMessageKind = ChiefMessageKind;\n\nexport type ChiefMessageRecord = {\n version: 2;\n build?: RuntimeBuild;\n id: string;\n leaseId: string;\n kind: ChiefMessageKind;\n fromSessionId: string;\n toSessionId: string;\n leadSessionId: string;\n branch?: string;\n text: string;\n resultBindings?: ResultBinding[];\n peerSource?: PeerSource;\n createdAt: number;\n};\n\ntype OverflowBodyRef = { bytes: number; sha256: string };\ntype StoredChiefMessage = Omit<\n ChiefMessageRecord,\n \"text\" | \"resultBindings\"\n> & {\n text: string;\n resultBindings?: ResultBinding[];\n bodyRef?: OverflowBodyRef;\n};\n\nexport type PeerGroup = Readonly<{\n repoKey: string;\n primaryWorkspaceId: string;\n}>;\ntype LocalPeerSource =\n | { role: \"manager\" }\n | { role: \"lead\"; socket: string; group: PeerGroup | null; managed: boolean };\nexport type PeerSource =\n LocalPeerSource | { role: \"lead\"; remoteOrdinary: true };\nexport type PeerContext = LocalPeerSource;\n\nexport function canMessagePeer(a: PeerContext, b: PeerContext): boolean {\n if (a.role !== b.role) return false;\n if (a.role === \"manager\") return true;\n if (b.role !== \"lead\") return false;\n if (!a.managed && !b.managed) return true;\n return (\n !!a.group &&\n !!b.group &&\n a.socket === b.socket &&\n a.group.repoKey === b.group.repoKey &&\n a.group.primaryWorkspaceId === b.group.primaryWorkspaceId\n );\n}\n\nexport function isRemoteOrdinaryLead(\n peer: PeerLeadRecord,\n assignments: Map<string, GlobalProjectAssignment[]>,\n): boolean {\n return (\n peer.role === \"lead\" &&\n peer.sessionKind === \"ordinary\" &&\n (assignments.get(peer.piSessionId)?.length ?? 0) === 0\n );\n}\n\nexport type CoordinationMessageRecord = ChiefMessageRecord;\n\nexport type ChiefInboxDrainOptions = {\n runtime: SupervisionRuntime;\n sessionId: string;\n signal?: AbortSignal;\n isAuthorized: (record: ChiefMessageRecord) => boolean | Promise<boolean>;\n isDelivered: (id: string) => boolean;\n deliveryMode?: (\n record: ChiefMessageRecord,\n ) =>\n | \"steer\"\n | \"followUp\"\n | undefined\n | Promise<\"steer\" | \"followUp\" | undefined>;\n senderTarget?: (\n record: ChiefMessageRecord,\n ) => string | undefined | Promise<string | undefined>;\n sendMessage: (\n message: unknown,\n options: {\n deliverAs?: \"steer\" | \"followUp\";\n triggerTurn: boolean;\n },\n record: ChiefMessageRecord,\n ) => void | Promise<void>;\n accepted?: (record: ChiefMessageRecord) => void | Promise<void>;\n rejected?: (record: ChiefMessageRecord) => void | Promise<void>;\n cleanupError?: (error: unknown) => void | Promise<void>;\n /** Guards state belonging to one lead session/generation transaction. */\n transaction?: {\n begin: (record: ChiefMessageRecord) => unknown | Promise<unknown>;\n revalidate: (token: unknown, phase: string) => void | Promise<void>;\n clear: (token: unknown) => void | Promise<void>;\n };\n};\n\nexport type CoordinationInboxDrainOptions = ChiefInboxDrainOptions;\n\nexport const COORDINATION_MESSAGE_MAX_BYTES = 8 * 1024;\nexport const COORDINATION_INBOX_SCAN_LIMIT = 32;\nconst CHIEF_DESCRIPTOR_MAX_BYTES = 2048;\nconst COORDINATION_BODY_MAX_BYTES = 1024 * 1024;\n\nconst UUID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\nconst MESSAGE_KINDS = new Set<ChiefMessageKind>(COORDINATION_MESSAGE_KINDS);\n\nfunction validOverflowBodyRef(value: unknown): value is OverflowBodyRef {\n return (\n !!value &&\n typeof value === \"object\" &&\n !Array.isArray(value) &&\n Object.keys(value).length === 2 &&\n Number.isInteger((value as any).bytes) &&\n (value as any).bytes > 0 &&\n (value as any).bytes <= COORDINATION_BODY_MAX_BYTES &&\n /^[a-f0-9]{64}$/.test((value as any).sha256)\n );\n}\n\nfunction validSession(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0 && value.length <= 512;\n}\n\nfunction sameRuntimeBuildEvidence(\n left: RuntimeBuild | undefined,\n right: RuntimeBuild | undefined,\n): boolean {\n return left?.version === right?.version && left?.sha256 === right?.sha256;\n}\n\nfunction validNativeIdentity(value: unknown): value is string {\n return (\n typeof value === \"string\" && value.trim().length > 0 && value.length <= 512\n );\n}\n\nfunction validMessage(value: unknown): value is ChiefMessageRecord {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"id\",\n \"leaseId\",\n \"kind\",\n \"fromSessionId\",\n \"toSessionId\",\n \"leadSessionId\",\n \"text\",\n \"createdAt\",\n ];\n const optional = [\n \"branch\",\n \"resultBindings\",\n \"build\",\n \"peerSource\",\n \"bodyRef\",\n ];\n if (\n Object.keys(record).some(\n (key) => !keys.includes(key) && !optional.includes(key),\n ) ||\n Object.keys(record).length < keys.length ||\n keys.some((key) => !Object.hasOwn(record, key))\n )\n return false;\n const projectMessage = record.kind === \"project_assignment\";\n const peerMessage = record.kind === \"peer_message\";\n const source = record.peerSource as Record<string, unknown> | undefined;\n const validPeerSource =\n source &&\n typeof source === \"object\" &&\n (source.role === \"manager\"\n ? Object.keys(source).length === 1\n : source.role === \"lead\" &&\n ((Object.keys(source).length === 2 && source.remoteOrdinary === true) ||\n (Object.keys(source).length === 4 &&\n typeof source.socket === \"string\" &&\n source.socket.length > 0 &&\n source.socket.length <= 4096 &&\n typeof source.managed === \"boolean\" &&\n (source.group === null\n ? !source.managed\n : !!source.group &&\n typeof source.group === \"object\" &&\n Object.keys(source.group).length === 2 &&\n validNativeIdentity(\n (source.group as Record<string, unknown>).repoKey,\n ) &&\n validNativeIdentity(\n (source.group as Record<string, unknown>).primaryWorkspaceId,\n )))));\n if (\n projectMessage\n ? !validNativeIdentity(record.branch)\n : record.branch !== undefined &&\n (record.kind !== \"manager_message\" ||\n !validNativeIdentity(record.branch))\n ) {\n return false;\n }\n return (\n record.version === 2 &&\n (peerMessage ? !!validPeerSource : record.peerSource === undefined) &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n typeof record.id === \"string\" &&\n UUID.test(record.id) &&\n typeof record.leaseId === \"string\" &&\n UUID.test(record.leaseId) &&\n typeof record.kind === \"string\" &&\n MESSAGE_KINDS.has(record.kind as ChiefMessageKind) &&\n validSession(record.fromSessionId) &&\n validSession(record.toSessionId) &&\n validSession(record.leadSessionId) &&\n typeof record.text === \"string\" &&\n (record.bodyRef === undefined\n ? record.text.length > 0\n : record.text === \"\" &&\n record.resultBindings === undefined &&\n validOverflowBodyRef(record.bodyRef)) &&\n (record.resultBindings === undefined ||\n (Array.isArray(record.resultBindings) &&\n record.resultBindings.every(isResultBinding))) &&\n Number.isInteger(record.createdAt) &&\n (record.createdAt as number) >= 0\n );\n}\n\nexport function chiefMessageBytes(record: ChiefMessageRecord): number {\n return Buffer.byteLength(`${JSON.stringify(record)}\\n`, \"utf8\");\n}\n\nfunction assertMessage(value: unknown): asserts value is ChiefMessageRecord {\n if (!validMessage(value)) throw new Error(\"Invalid Chief message record\");\n if (chiefMessageBytes(value) > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"Chief message record is too large\");\n}\n\nfunction compactChiefMessage(\n record: ChiefMessageRecord,\n path: string,\n): StoredChiefMessage {\n if (chiefMessageBytes(record) <= COORDINATION_MESSAGE_MAX_BYTES)\n return record;\n const bodyRef = writeOverflowBody(`${path}.body`, {\n text: record.text,\n ...(record.resultBindings ? { resultBindings: record.resultBindings } : {}),\n });\n const stored: StoredChiefMessage = { ...record, text: \"\", bodyRef };\n delete stored.resultBindings;\n if (\n chiefMessageBytes(stored as ChiefMessageRecord) >\n COORDINATION_MESSAGE_MAX_BYTES\n )\n throw new Error(\"Chief message routing metadata is too large\");\n return stored;\n}\n\nfunction inboxFor(runtime: SupervisionRuntime, toSessionId: string): string {\n if (!validSession(toSessionId))\n throw new Error(\"Invalid Chief message target\");\n return join(\n runtime.inbox,\n createHash(\"sha256\").update(toSessionId).digest(\"hex\"),\n );\n}\n\nexport function chiefMessagePath(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): string {\n if (!UUID.test(id)) throw new Error(\"Invalid Chief message ID\");\n return join(inboxFor(runtime, toSessionId), `${id}.json`);\n}\n\nfunction peerDeliveryReceiptPath(\n runtime: SupervisionRuntime,\n sessionId: string,\n id: string,\n): string {\n if (!UUID.test(id) || !validSession(sessionId))\n throw new Error(\"Invalid peer delivery receipt identity\");\n return join(\n runtime.root,\n \"peer-delivery-receipts\",\n createHash(\"sha256\").update(sessionId).digest(\"hex\"),\n `${id}.json`,\n );\n}\n\n/** Digest used to bind the Pi-history delivery receipt to exact inbox content. */\nexport function coordinationMessageDigest(record: ChiefMessageRecord): string {\n const canonical = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(canonical);\n if (!value || typeof value !== \"object\") return value;\n return Object.fromEntries(\n Object.entries(value)\n .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))\n .map(([key, item]) => [key, canonical(item)]),\n );\n };\n const content = {\n version: record.version,\n build: record.build,\n id: record.id,\n leaseId: record.leaseId,\n kind: record.kind,\n fromSessionId: record.fromSessionId,\n toSessionId: record.toSessionId,\n leadSessionId: record.leadSessionId,\n branch: record.branch,\n text: record.text,\n resultBindings: record.resultBindings,\n peerSource: record.peerSource,\n createdAt: record.createdAt,\n };\n return createHash(\"sha256\")\n .update(JSON.stringify(canonical(content)))\n .digest(\"hex\");\n}\n\n/** The live Pi-history predicate shared by inbox draining and receipt tests. */\nexport function coordinationMessageDelivered(\n record: ChiefMessageRecord,\n sessionId: string,\n entries: readonly unknown[],\n): boolean {\n return (\n record.toSessionId === sessionId &&\n entries.some((value) => {\n const entry = value as {\n customType?: unknown;\n details?: Record<string, unknown>;\n } | null;\n return (\n entry?.customType === `pi-herdsman-${record.kind}` &&\n entry.details?.id === record.id &&\n entry.details?.leaseId === record.leaseId &&\n entry.details?.fromSessionId === record.fromSessionId &&\n entry.details?.leadSessionId === record.leadSessionId &&\n entry.details?.branch === record.branch &&\n (record.kind !== \"peer_message\" ||\n entry.details?.digest === coordinationMessageDigest(record))\n );\n })\n );\n}\n\n/** Persist only after the live Pi-history receipt has been verified. */\nexport function writePeerDeliveryReceipt(\n runtime: SupervisionRuntime,\n record: ChiefMessageRecord,\n): void {\n if (record.kind !== \"peer_message\")\n throw new Error(\"Peer delivery receipt requires a peer message\");\n const path = peerDeliveryReceiptPath(runtime, record.toSessionId, record.id);\n const directory = dirname(path);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n const receipt = {\n sessionId: record.toSessionId,\n id: record.id,\n digest: coordinationMessageDigest(record),\n };\n const content = `${JSON.stringify(receipt)}\\n`;\n try {\n const existing = JSON.parse(readFileSync(path, \"utf8\"));\n if (!isDeepStrictEqual(existing, receipt))\n throw new Error(\"Conflicting peer delivery receipt\");\n return;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n publishRecord(path, content);\n fsyncDirectory(dirname(directory));\n}\n\n/** Missing is distinct from unreadable or mismatched; callers must fail closed. */\nexport function hasPeerDeliveryReceipt(\n runtime: SupervisionRuntime,\n sessionId: string,\n id: string,\n digest: string,\n): boolean {\n try {\n const receipt = JSON.parse(\n readFileSync(peerDeliveryReceiptPath(runtime, sessionId, id), \"utf8\"),\n ) as { sessionId?: unknown; id?: unknown; digest?: unknown };\n if (\n receipt.sessionId !== sessionId ||\n receipt.id !== id ||\n receipt.digest !== digest\n )\n throw new Error(\"Conflicting peer delivery receipt\");\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n throw error;\n }\n}\n\nfunction fsyncDirectory(directory: string): void {\n if (process.platform === \"win32\") return;\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n}\n\nfunction publishRecord(path: string, content: string): string {\n const directory = dirname(path);\n const temporary = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n return path;\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nfunction writeOverflowBody(\n path: string,\n body: {\n text: string;\n resultBindings?: ResultBinding[];\n },\n): OverflowBodyRef {\n const content = `${JSON.stringify(body)}\\n`;\n const bytes = Buffer.byteLength(content, \"utf8\");\n if (bytes > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Coordination message body is too large\");\n const sha256 = createHash(\"sha256\").update(content).digest(\"hex\");\n try {\n const stat = lstatSync(path);\n if (!stat.isFile() || stat.size > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Unsafe existing coordination message body\");\n const fd = openSync(\n path,\n constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | constants.O_NONBLOCK,\n );\n let existing: Buffer;\n try {\n const current = fstatSync(fd);\n if (!current.isFile() || current.size > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Unsafe existing coordination message body\");\n existing = Buffer.alloc(current.size);\n let offset = 0;\n while (offset < existing.length) {\n const count = readSync(\n fd,\n existing,\n offset,\n existing.length - offset,\n offset,\n );\n if (!count)\n throw new Error(\"Existing coordination message body is truncated\");\n offset += count;\n }\n if (fstatSync(fd).size !== current.size)\n throw new Error(\n \"Existing coordination message body changed while reading\",\n );\n } finally {\n closeSync(fd);\n }\n if (\n existing.length !== bytes ||\n createHash(\"sha256\").update(existing).digest(\"hex\") !== sha256\n )\n throw new Error(\"Coordination message ID already has a different body\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n publishRecord(path, content);\n }\n return { bytes, sha256 };\n}\n\nfunction readOverflowBody(\n path: string,\n ref: OverflowBodyRef,\n): {\n text: string;\n resultBindings?: ResultBinding[];\n} {\n if (\n !ref ||\n !Number.isInteger(ref.bytes) ||\n ref.bytes < 1 ||\n ref.bytes > COORDINATION_BODY_MAX_BYTES ||\n !/^[a-f0-9]{64}$/.test(ref.sha256)\n )\n throw new Error(\"Invalid coordination message body reference\");\n let fd: number | undefined;\n try {\n fd = openSync(\n path,\n constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | constants.O_NONBLOCK,\n );\n const stat = fstatSync(fd);\n if (!stat.isFile() || stat.size !== ref.bytes)\n throw new Error(\"Coordination message body size mismatch\");\n const bytes = Buffer.alloc(ref.bytes);\n let offset = 0;\n while (offset < bytes.length) {\n const count = readSync(fd, bytes, offset, bytes.length - offset, offset);\n if (!count) throw new Error(\"Coordination message body is truncated\");\n offset += count;\n }\n if (createHash(\"sha256\").update(bytes).digest(\"hex\") !== ref.sha256)\n throw new Error(\"Coordination message body integrity check failed\");\n const parsed: unknown = JSON.parse(\n new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes),\n );\n if (\n !parsed ||\n typeof parsed !== \"object\" ||\n Array.isArray(parsed) ||\n Object.keys(parsed).some(\n (key) => ![\"text\", \"resultBindings\"].includes(key),\n ) ||\n typeof (parsed as any).text !== \"string\" ||\n !(parsed as any).text.length ||\n ((parsed as any).resultBindings !== undefined &&\n (!Array.isArray((parsed as any).resultBindings) ||\n !(parsed as any).resultBindings.every(isResultBinding)))\n )\n throw new Error(\"Invalid coordination message body\");\n return parsed as { text: string; resultBindings?: ResultBinding[] };\n } catch (error) {\n throw new Error(\"Unable to read coordination message body\", {\n cause: error,\n });\n } finally {\n if (fd !== undefined) closeSync(fd);\n }\n}\n\nfunction withChiefMessageLock<T>(path: string, operation: () => T): T {\n const lock = `${path}.lock`;\n // Publish a verified PID/UUID owner so a crash-held lock can be reclaimed\n // only after its recorded PID no longer exists. Live, ambiguous, and\n // malformed locks fail closed and are retried by the caller.\n const lease = acquireProcessLock(lock, { name: \"Chief message lock\" });\n try {\n return operation();\n } finally {\n lease.release();\n }\n}\n\nfunction removeMalformedChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): Error[] {\n const path = chiefMessagePath(runtime, toSessionId, id);\n try {\n return withChiefMessageLock(path, () =>\n removeMalformedChiefMessageUnlocked(runtime, toSessionId, id),\n );\n } catch (error) {\n return [error instanceof Error ? error : new Error(String(error))];\n }\n}\n\nfunction removeMalformedChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): Error[] {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const errors: Error[] = [];\n try {\n // Establish the recovery marker before making the malformed record\n // disappear. If this cannot be made durable, retain the JSON record.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n } catch (error) {\n errors.push(error instanceof Error ? error : new Error(String(error)));\n return errors;\n }\n try {\n const claimed = join(\n dirname(path),\n `.${basename(path, \".json\")}.${randomUUID()}.cleanup`,\n );\n renameSync(path, claimed);\n fsyncDirectory(dirname(path));\n try {\n unlinkSync(claimed);\n fsyncDirectory(dirname(path));\n } catch (error) {\n try {\n renameSync(claimed, path);\n fsyncDirectory(dirname(path));\n } catch {}\n throw error;\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n // An unlink race is safe only after confirming that the JSON is gone.\n // The marker still applies back-pressure until its removal is durable.\n try {\n statSync(path);\n errors.push(\n new Error(\"Unable to confirm malformed Chief message removal\"),\n );\n return errors;\n } catch (confirmationError) {\n if ((confirmationError as NodeJS.ErrnoException).code !== \"ENOENT\") {\n errors.push(\n confirmationError instanceof Error\n ? confirmationError\n : new Error(String(confirmationError)),\n );\n return errors;\n }\n }\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (markerError) {\n if ((markerError as NodeJS.ErrnoException).code !== \"ENOENT\")\n errors.push(\n markerError instanceof Error\n ? markerError\n : new Error(String(markerError)),\n );\n }\n return errors;\n }\n errors.push(error instanceof Error ? error : new Error(String(error)));\n }\n if (errors.length === 0) {\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (markerError) {\n if ((markerError as NodeJS.ErrnoException).code !== \"ENOENT\")\n errors.push(\n markerError instanceof Error\n ? markerError\n : new Error(String(markerError)),\n );\n }\n }\n return errors;\n}\n\nfunction removeChiefMessageQuarantineUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n try {\n unlinkSync(`${path}.quarantine`);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n try {\n // The marker was removed before durability was established. Restore it\n // and only report success if the replacement is durable.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n } catch (recoveryError) {\n throw new Error(\"Unable to restore Chief message quarantine\", {\n cause: recoveryError,\n });\n }\n throw new Error(\"Unable to remove Chief message quarantine\", {\n cause: error,\n });\n }\n}\n\nexport function writeChiefMessage(\n record: ChiefMessageRecord,\n runtime = supervisionRuntime(),\n clearQuarantine = true,\n): string {\n if (!record.build)\n throw new Error(\"Coordination message build identity is required\");\n if (!validMessage(record) || record.bodyRef !== undefined)\n throw new Error(\"Invalid Chief message record\");\n return withChiefMessageLock(\n chiefMessagePath(runtime, record.toSessionId, record.id),\n () => writeChiefMessageUnlocked(record, runtime, clearQuarantine),\n );\n}\n\nfunction writeChiefMessageUnlocked(\n record: ChiefMessageRecord,\n runtime: SupervisionRuntime,\n clearQuarantine: boolean,\n): string {\n const directory = inboxFor(runtime, record.toSessionId);\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.inbox, { recursive: true, mode: 0o700 });\n chmodSync(runtime.inbox, 0o700);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n const path = chiefMessagePath(runtime, record.toSessionId, record.id);\n if (record.kind !== \"project_assignment\") {\n try {\n statSync(path);\n const existing = readChiefMessage(path);\n if (!isDeepStrictEqual(existing, record))\n throw new Error(\n \"Chief message ID already exists with a different payload\",\n );\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n const stored = compactChiefMessage(record, path);\n const temporary = join(directory, `.${record.id}.${randomUUID()}.tmp`);\n const content = `${JSON.stringify(stored)}\\n`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n // Replacing a quarantined ID is an explicit retry/reconciliation. Keep\n // the marker fail-closed until the replacement is durable, then release it.\n if (clearQuarantine) {\n const hadQuarantine = chiefMessageQuarantined(\n runtime,\n record.toSessionId,\n record.id,\n );\n try {\n unlinkSync(`${path}.quarantine`);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n fsyncDirectory(directory);\n } catch (error) {\n if (hadQuarantine) {\n try {\n quarantineChiefMessageUnlocked(\n runtime,\n record.toSessionId,\n record.id,\n );\n } catch (recoveryError) {\n throw new Error(\"Unable to restore Chief message quarantine\", {\n cause: recoveryError,\n });\n }\n }\n throw error;\n }\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n return path;\n}\n\nfunction conclusivelyMalformedChiefMessage(path: string): boolean {\n let content: string;\n try {\n if (statSync(path).size > COORDINATION_MESSAGE_MAX_BYTES) return true;\n content = readFileSync(path, \"utf8\");\n } catch {\n return false;\n }\n try {\n return !validMessage(JSON.parse(content));\n } catch {\n return true;\n }\n}\n\nfunction assertChiefMessageNotQuarantined(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n if (chiefMessageQuarantined(runtime, toSessionId, id))\n throw new Error(\"Chief message is quarantined\");\n}\n\nfunction readStoredChiefMessage(path: string): StoredChiefMessage {\n let size: number;\n try {\n size = statSync(path).size;\n } catch (error) {\n throw new Error(\"Unable to read Chief message\", { cause: error });\n }\n if (size > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"Chief message record is too large\");\n try {\n const parsed = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n assertMessage(parsed);\n return parsed as StoredChiefMessage;\n } catch (error) {\n if (error instanceof Error && /Chief message record/.test(error.message))\n throw error;\n throw new Error(\"Invalid Chief message record\", { cause: error });\n }\n}\n\nexport function readChiefMessage(path: string): ChiefMessageRecord {\n const parsed = readStoredChiefMessage(path);\n if (parsed.bodyRef) {\n const body = readOverflowBody(`${path}.body`, parsed.bodyRef);\n const logical = { ...parsed, ...body } as ChiefMessageRecord;\n delete (logical as any).bodyRef;\n if (!validMessage(logical)) throw new Error(\"Invalid Chief message body\");\n return logical;\n }\n return parsed as ChiefMessageRecord;\n}\n\nfunction allChiefMessagePaths(\n runtime: SupervisionRuntime,\n toSessionId: string,\n): string[] {\n const directory = inboxFor(runtime, toSessionId);\n let entries: string[];\n try {\n entries = readdirSync(directory).sort();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw new Error(\"Unable to scan Chief inbox\", { cause: error });\n }\n const paths = entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .map((entry) => join(directory, entry));\n // The directory scan parses all candidates; only the delivery batch is\n // bounded. Malformed UUID-named files are best-effort cleanup candidates\n // and may be deferred behind a full valid delivery batch.\n return paths\n .flatMap((path) => {\n try {\n const record = readStoredChiefMessage(path);\n return [{ path, record }];\n } catch {\n return [{ path, record: undefined }];\n }\n })\n .sort((a, b) => {\n if (!a.record || !b.record) return a.record ? -1 : b.record ? 1 : 0;\n return (\n a.record.createdAt - b.record.createdAt ||\n a.record.id.localeCompare(b.record.id)\n );\n })\n .map(({ path }) => path);\n}\n\nexport function listChiefMessagePaths(\n runtime: SupervisionRuntime,\n toSessionId: string,\n limit = COORDINATION_INBOX_SCAN_LIMIT,\n): string[] {\n if (!Number.isInteger(limit) || limit < 0)\n throw new Error(\"Invalid inbox limit\");\n return allChiefMessagePaths(runtime, toSessionId).slice(\n 0,\n Math.min(limit, COORDINATION_INBOX_SCAN_LIMIT),\n );\n}\n\nexport function removeChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n expected?: ChiefMessageRecord,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n withChiefMessageLock(path, () =>\n removeChiefMessageUnlocked(runtime, toSessionId, id, expected),\n );\n}\n\nfunction removeChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n expected?: ChiefMessageRecord,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const directory = dirname(path);\n const matchesExpected = (): boolean => {\n if (!expected) return true;\n try {\n const stored = readStoredChiefMessage(path);\n if ((expected as StoredChiefMessage).bodyRef)\n return isDeepStrictEqual(stored, expected);\n return isDeepStrictEqual(readChiefMessage(path), expected);\n } catch {\n return false;\n }\n };\n if (!matchesExpected())\n throw new Error(\"Chief message changed during removal\");\n // Establish recovery before making any record disappear. This also covers\n // direct callers, not only the inbox drain fallback.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n if (!matchesExpected())\n throw new Error(\"Chief message changed during removal\");\n try {\n const claimed = join(\n directory,\n `.${basename(path, \".json\")}.${randomUUID()}.cleanup`,\n );\n // Detach the exact path atomically. All same-ID writers use the same\n // narrow lock, so a replacement cannot become the object we delete.\n renameSync(path, claimed);\n fsyncDirectory(directory);\n try {\n unlinkSync(claimed);\n fsyncDirectory(directory);\n } catch (error) {\n try {\n renameSync(claimed, path);\n fsyncDirectory(directory);\n } catch {}\n throw error;\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n throw new Error(\"Unable to remove Chief message\", { cause: error });\n }\n try {\n unlinkSync(`${path}.body`);\n fsyncDirectory(directory);\n } catch {}\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\n/** Persist an exclusion when a queued message cannot be removed safely. */\nexport function quarantineChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n withChiefMessageLock(path, () =>\n quarantineChiefMessageUnlocked(runtime, toSessionId, id),\n );\n}\n\nfunction quarantineChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const quarantine = `${path}.quarantine`;\n // This sidecar is separate from the JSON removal, so a crash between those\n // operations can leave the marker until a retry or explicit recovery;\n // all marker checks fail closed.\n let fd: number | undefined;\n try {\n try {\n fd = openSync(quarantine, \"wx\", 0o600);\n writeFileSync(fd, \"quarantined\\n\", \"utf8\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n fd = openSync(quarantine, process.platform === \"win32\" ? \"r+\" : \"r\");\n }\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n // Re-fsync the directory even for an existing marker so this call only\n // succeeds after the marker's presence is durably established.\n fsyncDirectory(dirname(quarantine));\n } finally {\n if (fd !== undefined) closeSync(fd);\n }\n}\n\nexport function chiefMessageQuarantined(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): boolean {\n try {\n statSync(`${chiefMessagePath(runtime, toSessionId, id)}.quarantine`);\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n return true;\n }\n}\n\nfunction deliveredMessageContent(\n record: CoordinationMessageRecord,\n senderTarget?: string,\n): string {\n const prefix =\n record.kind === \"chief_message\"\n ? \"From your Chief: \"\n : record.kind === \"manager_message\"\n ? `From Manager${senderTarget ? ` ${senderTarget}` : \"\"}: `\n : record.kind === \"lead_message\"\n ? `From Lead${senderTarget ? ` ${senderTarget}` : \"\"}: `\n : `Peer message${senderTarget ? ` from ${senderTarget}` : \"\"}: `;\n const content =\n record.kind === \"project_assignment\"\n ? `Project assignment for branch ${record.branch}:\\n\\n${record.text}`\n : `${prefix}${record.text}`;\n return content;\n}\n\n/** Drain only this session's inbox. Files remain when Pi rejects delivery. */\nexport async function drainCoordinationInbox(\n options: ChiefInboxDrainOptions,\n): Promise<number> {\n let delivered = 0;\n let examined = 0;\n for (const path of allChiefMessagePaths(options.runtime, options.sessionId)) {\n if (examined >= COORDINATION_INBOX_SCAN_LIMIT) break;\n if (options.signal?.aborted) break;\n const id = basename(path, \".json\");\n if (\n UUID.test(id) &&\n chiefMessageQuarantined(options.runtime, options.sessionId, id)\n )\n continue;\n let stored: StoredChiefMessage;\n let record: ChiefMessageRecord;\n try {\n stored = readStoredChiefMessage(path);\n record = stored as ChiefMessageRecord;\n } catch {\n if (UUID.test(id) && conclusivelyMalformedChiefMessage(path)) {\n for (const cleanupError of removeMalformedChiefMessage(\n options.runtime,\n options.sessionId,\n id,\n ))\n try {\n await options.cleanupError?.(cleanupError);\n } catch {}\n }\n continue;\n }\n examined++;\n let token: unknown;\n const clearTransaction = async (): Promise<void> => {\n if (token === undefined) return;\n try {\n await options.transaction?.clear(token);\n } catch {\n // Clearing bookkeeping is best effort; the inbox record remains the\n // durable retry marker.\n }\n };\n try {\n token = await options.transaction?.begin(record);\n await options.transaction?.revalidate(token, \"before-authorization\");\n } catch {\n await clearTransaction();\n continue;\n }\n let deliverAs: \"steer\" | \"followUp\" | undefined;\n try {\n deliverAs = options.deliveryMode\n ? await options.deliveryMode(record)\n : \"followUp\";\n } catch {\n await clearTransaction();\n continue;\n }\n const wasAlreadyDelivered = options.isDelivered(record.id);\n if (!deliverAs && !wasAlreadyDelivered) {\n await clearTransaction();\n continue;\n }\n let authorized: boolean;\n try {\n authorized = await options.isAuthorized(record);\n } catch {\n await clearTransaction();\n continue;\n }\n if (!authorized) {\n try {\n await options.transaction?.revalidate(token, \"before-rejection\");\n await options.rejected?.(record);\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.transaction?.revalidate(token, \"before-rejected-remove\");\n } catch {\n // A shutdown or replacement wins over cleanup of this old record.\n await clearTransaction();\n continue;\n }\n try {\n quarantineChiefMessage(options.runtime, options.sessionId, record.id);\n removeChiefMessage(\n options.runtime,\n options.sessionId,\n record.id,\n record,\n );\n await options.transaction?.clear(token);\n } catch (cleanupError) {\n try {\n await options.cleanupError?.(cleanupError);\n } catch {}\n }\n await clearTransaction();\n continue;\n }\n if (!options.isDelivered(record.id)) {\n try {\n await options.transaction?.revalidate(token, \"before-send\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n // Authorization may have yielded while Pi persisted an earlier send.\n if (!options.isDelivered(record.id)) {\n if (stored.bodyRef) {\n try {\n const body = readOverflowBody(`${path}.body`, stored.bodyRef);\n record = { ...record, ...body } as ChiefMessageRecord;\n } catch {\n examined--;\n await options.cleanupError?.(\n new Error(\n `Unable to read overflow body for Chief message ${id}`,\n ),\n );\n await clearTransaction();\n continue;\n }\n }\n const senderTarget =\n options.senderTarget &&\n (record.kind === \"peer_message\" ||\n record.kind === \"lead_message\" ||\n record.kind === \"manager_message\")\n ? await options.senderTarget(record)\n : undefined;\n await options.sendMessage(\n {\n customType: `pi-herdsman-${record.kind}`,\n content: deliveredMessageContent(record, senderTarget),\n display: true,\n details: {\n id: record.id,\n leaseId: record.leaseId,\n fromSessionId: record.fromSessionId,\n toSessionId: record.toSessionId,\n leadSessionId: record.leadSessionId,\n ...(senderTarget ? { senderTarget } : {}),\n ...(record.branch ? { branch: record.branch } : {}),\n ...(record.kind === \"peer_message\"\n ? { digest: coordinationMessageDigest(record) }\n : {}),\n },\n },\n { deliverAs: deliverAs ?? \"followUp\", triggerTurn: true },\n record,\n );\n await options.transaction?.revalidate(token, \"after-send\");\n }\n } catch {\n await clearTransaction();\n continue;\n }\n if (!options.isDelivered(record.id)) {\n // Pi submission is not a persistence acknowledgement.\n await clearTransaction();\n continue;\n }\n if (!wasAlreadyDelivered) delivered += 1;\n try {\n await options.transaction?.revalidate(token, \"before-accepted\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.accepted?.(record);\n await options.transaction?.revalidate(token, \"after-accepted\");\n } catch {\n await clearTransaction();\n continue;\n }\n } else {\n try {\n if (!wasAlreadyDelivered) delivered += 1;\n await options.transaction?.revalidate(token, \"already-delivered\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.accepted?.(record);\n } catch {\n await clearTransaction();\n continue;\n }\n }\n try {\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.transaction?.revalidate(token, \"before-remove\");\n } catch {\n await clearTransaction();\n continue;\n }\n try {\n removeChiefMessage(options.runtime, options.sessionId, record.id, record);\n } catch (removalError) {\n try {\n await options.cleanupError?.(removalError);\n } catch {}\n await clearTransaction();\n continue;\n }\n try {\n await options.transaction?.revalidate(token, \"after-remove\");\n await options.transaction?.clear(token);\n } catch {\n // A shutdown or replacement wins over bookkeeping after removal.\n await clearTransaction();\n }\n }\n return delivered;\n}\n\nexport const coordinationMessagePath = chiefMessagePath;\nexport const readCoordinationMessage = readChiefMessage;\nexport const listCoordinationMessagePaths = listChiefMessagePaths;\nexport const writeCoordinationMessage = writeChiefMessage;\nexport const removeCoordinationMessage = removeChiefMessage;\nexport const coordinationMessageBytes = chiefMessageBytes;\n\nfunction socketPath(): string {\n const value = process.env.HERDR_SOCKET_PATH;\n if (!value) throw new Error(\"HERDR_SOCKET_PATH is required\");\n return value;\n}\n\nexport function supervisionRuntime(socket = socketPath()): SupervisionRuntime {\n if (!socket) throw new Error(\"HERDR_SOCKET_PATH is required\");\n const runtimeHash = createHash(\"sha256\").update(socket).digest(\"hex\");\n const root = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"supervision-v2\",\n runtimeHash,\n );\n return {\n root,\n lock: join(root, \"chief.lock\"),\n descriptor: join(root, \"chief.json\"),\n inbox: join(root, \"inbox\"),\n coordinators: join(root, \"coordinators\"),\n leads: join(root, \"coordinators\"),\n managers: join(root, \"managers\"),\n assignments: join(root, \"assignments\"),\n };\n}\n\nconst projectAuthorityLock = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"project-assignment-authority.lock\",\n);\n\nexport function projectAssignmentAuthorityLockPath(): string {\n return projectAuthorityLock;\n}\n\nfunction withProjectAssignmentLock<T>(operation: () => T): T {\n const lease = acquireProcessLock(projectAuthorityLock, {\n name: \"project assignment authority\",\n });\n try {\n const result = operation();\n if (result && typeof (result as { then?: unknown }).then === \"function\")\n throw new Error(\n \"Project assignment authority operation must be synchronous\",\n );\n return result;\n } finally {\n lease.release();\n }\n}\n\n/** Wait briefly for global authority, but keep every lock-held operation synchronous. */\nexport async function withProjectAssignmentAuthorityWait<T>(\n operation: () => T,\n signal?: AbortSignal,\n onOccupied?: () => void,\n): Promise<T> {\n // Match the existing project-lock contention budget; callers fail closed after brief contention.\n const deadline = Date.now() + 2_000;\n while (true) {\n signal?.throwIfAborted();\n let lease: ReturnType<typeof acquireProcessLock>;\n try {\n lease = acquireProcessLock(projectAuthorityLock, {\n name: \"project assignment authority\",\n });\n } catch (error) {\n if (!(error instanceof ProcessLockOccupiedError)) throw error;\n onOccupied?.();\n const remaining = deadline - Date.now();\n if (remaining <= 0) throw error;\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(done, Math.min(25, remaining));\n function done() {\n signal?.removeEventListener(\"abort\", aborted);\n resolve();\n }\n function aborted() {\n clearTimeout(timer);\n signal?.removeEventListener(\"abort\", aborted);\n reject(signal?.reason ?? new Error(\"Operation aborted\"));\n }\n signal?.addEventListener(\"abort\", aborted, { once: true });\n if (signal?.aborted) aborted();\n });\n continue;\n }\n try {\n const result = operation();\n if (result && typeof (result as { then?: unknown }).then === \"function\")\n throw new Error(\n \"Project assignment authority operation must be synchronous\",\n );\n return result;\n } finally {\n lease.release();\n }\n }\n}\n\n/** Run a synchronous final action against the exact branch assignment under global authority. */\nexport function withCurrentProjectAssignment<T>(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n operation: (assignment: ProjectAssignment | undefined) => T,\n): T {\n return withProjectAssignmentLock(() =>\n operation(readProjectAssignment(runtime, repoKey, branch)),\n );\n}\n\nexport type PeerRuntime = SupervisionRuntime & {\n peers: string;\n};\n\nexport type PeerRecord = Readonly<{\n version: 2;\n build?: RuntimeBuild;\n role?: PeerRole;\n sessionKind: \"ordinary\" | \"managed\";\n piSessionId: string;\n paneId: string;\n tabId: string;\n workspaceId: string;\n socket: string;\n group?: PeerGroup | null;\n name?: string;\n cwd?: string;\n repo?: string;\n branch?: string;\n workspaceLabel?: string;\n claim: ProcessLockClaim;\n updatedAt: number;\n}>;\nexport type PeerLeadRecord = PeerRecord;\n\nconst PEER_LEAD_RECORD_MAX_BYTES = 4096;\n\nexport function peerRuntime(_socket?: string): PeerRuntime {\n const root = join(herdsmanDataRoot(), \"runtime\", \"peers-v2\");\n return {\n root,\n lock: join(root, \"chief.lock\"),\n descriptor: join(root, \"chief.json\"),\n inbox: join(root, \"inbox\"),\n coordinators: join(root, \"coordinators\"),\n leads: join(root, \"coordinators\"),\n managers: join(root, \"managers\"),\n assignments: join(root, \"assignments\"),\n peers: join(root, \"peers\"),\n };\n}\n\nfunction peerDirectory(runtime: PeerRuntime): string {\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.peers, { recursive: true, mode: 0o700 });\n chmodSync(runtime.peers, 0o700);\n return runtime.peers;\n}\n\nexport function peerLeadRecordPath(\n runtime: PeerRuntime,\n piSessionId: string,\n): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid peer session ID\");\n return join(runtime.peers, peerLeadRecordFilename(piSessionId));\n}\n\nfunction peerLeadRecordFilename(piSessionId: string): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid peer session ID\");\n return `${createHash(\"sha256\").update(piSessionId).digest(\"hex\")}.json`;\n}\n\nexport function peerLeadLockPath(\n runtime: PeerRuntime,\n piSessionId: string,\n): string {\n return `${peerLeadRecordPath(runtime, piSessionId)}.lock`;\n}\n\nfunction validPeerLeadRecord(value: unknown): value is PeerLeadRecord {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const metadata = [\"name\", \"cwd\", \"repo\", \"branch\", \"workspaceLabel\"];\n return (\n Object.keys(record).every((key) =>\n [\n \"version\",\n \"build\",\n \"role\",\n \"sessionKind\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"socket\",\n \"group\",\n \"claim\",\n \"updatedAt\",\n ...metadata,\n ].includes(key),\n ) &&\n [\n \"version\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"socket\",\n \"claim\",\n \"updatedAt\",\n ].every((key) => Object.hasOwn(record, key)) &&\n record.version === 2 &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n (record.role === undefined ||\n record.role === \"lead\" ||\n record.role === \"manager\") &&\n (record.sessionKind === \"ordinary\" || record.sessionKind === \"managed\") &&\n validSession(record.piSessionId) &&\n validNativeIdentity(record.paneId) &&\n validNativeIdentity(record.tabId) &&\n validNativeIdentity(record.workspaceId) &&\n typeof record.socket === \"string\" &&\n record.socket.length > 0 &&\n record.socket.length <= 4096 &&\n (record.group === undefined ||\n record.group === null ||\n (!!record.group &&\n typeof record.group === \"object\" &&\n Object.keys(record.group).length === 2 &&\n validNativeIdentity(\n (record.group as Record<string, unknown>).repoKey,\n ) &&\n validNativeIdentity(\n (record.group as Record<string, unknown>).primaryWorkspaceId,\n ))) &&\n metadata.every(\n (key) => !Object.hasOwn(record, key) || validNativeIdentity(record[key]),\n ) &&\n isProcessLockClaim(record.claim) &&\n Number.isInteger(record.updatedAt) &&\n (record.updatedAt as number) >= 0\n );\n}\n\nfunction livePeerClaim(\n runtime: PeerRuntime,\n piSessionId: string,\n): ProcessLockClaim {\n return readLiveProcessLock(peerLeadLockPath(runtime, piSessionId));\n}\n\nexport function samePeerLeadRecord(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n actual.version === expected.version &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.sessionKind === expected.sessionKind &&\n (actual.role ?? \"lead\") === (expected.role ?? \"lead\") &&\n actual.piSessionId === expected.piSessionId &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.socket === expected.socket &&\n JSON.stringify(actual.group) === JSON.stringify(expected.group) &&\n actual.name === expected.name &&\n actual.cwd === expected.cwd &&\n actual.repo === expected.repo &&\n actual.branch === expected.branch &&\n actual.workspaceLabel === expected.workspaceLabel &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.updatedAt === expected.updatedAt\n );\n}\n\nexport function samePeerLeadGeneration(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n actual.piSessionId === expected.piSessionId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id\n );\n}\n\n/** Authorization provenance, excluding presentation metadata. */\nexport function samePeerLeadAuthority(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n samePeerLeadGeneration(actual, expected) &&\n actual.sessionKind === expected.sessionKind &&\n (actual.role ?? \"lead\") === (expected.role ?? \"lead\") &&\n actual.socket === expected.socket &&\n actual.workspaceId === expected.workspaceId &&\n isDeepStrictEqual(actual.group, expected.group)\n );\n}\n\nexport function readPeerLeadRecord(\n runtime: PeerRuntime,\n piSessionId: string,\n): PeerLeadRecord | undefined {\n const path = peerLeadRecordPath(runtime, piSessionId);\n let value: unknown;\n try {\n const text = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(text, \"utf8\") > PEER_LEAD_RECORD_MAX_BYTES)\n throw new Error(\"peer lead record too large\");\n value = JSON.parse(text);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw new Error(\"Unable to read peer lead record\", { cause: error });\n }\n if (!validPeerLeadRecord(value) || value.piSessionId !== piSessionId)\n throw new Error(\"Unable to read peer lead record\");\n const claim = livePeerClaim(runtime, piSessionId);\n if (claim.pid !== value.claim.pid || claim.id !== value.claim.id)\n throw new Error(\"Peer lead process-lock generation changed\");\n return value;\n}\n\nexport function writePeerLeadRecord(\n runtime: PeerRuntime,\n record: PeerLeadRecord,\n): string {\n if (!record.build) throw new Error(\"Peer lead build identity is required\");\n if (!validPeerLeadRecord(record)) throw new Error(\"Invalid peer lead record\");\n const live = livePeerClaim(runtime, record.piSessionId);\n if (live.pid !== record.claim.pid || live.id !== record.claim.id)\n throw new Error(\"Peer lead process-lock generation changed\");\n peerDirectory(runtime);\n const path = peerLeadRecordPath(runtime, record.piSessionId);\n const content = `${JSON.stringify(record)}\\n`;\n if (Buffer.byteLength(content, \"utf8\") > PEER_LEAD_RECORD_MAX_BYTES)\n throw new Error(\"Peer lead record is too large\");\n return publishRecord(path, content);\n}\n\nexport function removePeerLeadRecord(\n runtime: PeerRuntime,\n piSessionId: string,\n expected?: PeerLeadRecord,\n): void {\n const path = peerLeadRecordPath(runtime, piSessionId);\n try {\n if (expected) {\n const current = readPeerLeadRecord(runtime, piSessionId);\n if (!current || !samePeerLeadRecord(current, expected)) return;\n }\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nexport function listPeerLeadRecords(\n runtime: PeerRuntime = peerRuntime(),\n): PeerLeadRecord[] {\n let entries: string[];\n try {\n entries = readdirSync(runtime.peers);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw new Error(\"Unable to scan peer lead records\", { cause: error });\n }\n return entries\n .filter((entry) => /^[0-9a-f]{64}\\.json$/.test(entry))\n .sort()\n .flatMap((entry) => {\n try {\n const path = join(runtime.peers, entry);\n if (statSync(path).size > PEER_LEAD_RECORD_MAX_BYTES) return [];\n const text = readFileSync(path, \"utf8\");\n const value = JSON.parse(text);\n if (\n !validPeerLeadRecord(value) ||\n peerLeadRecordFilename(value.piSessionId) !== entry\n )\n return [];\n const record = readPeerLeadRecord(runtime, value.piSessionId);\n return record ? [record] : [];\n } catch {\n return [];\n }\n });\n}\n\nfunction validDescriptor(value: unknown): value is ChiefDescriptor {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"leaseId\",\n \"claim\",\n \"piSessionId\",\n \"paneId\",\n \"workspaceId\",\n \"createdAt\",\n ];\n const optional = [\"tabId\", \"piSessionFile\", \"build\"];\n return (\n Object.keys(record).every(\n (key) => keys.includes(key) || optional.includes(key),\n ) &&\n Object.keys(record).length >= keys.length &&\n keys.every((key) => Object.hasOwn(record, key)) &&\n record.version === 1 &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n typeof record.leaseId === \"string\" &&\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(\n record.leaseId,\n ) &&\n isProcessLockClaim(record.claim) &&\n typeof record.piSessionId === \"string\" &&\n record.piSessionId.length > 0 &&\n record.piSessionId.length <= 512 &&\n (record.piSessionFile === undefined ||\n (typeof record.piSessionFile === \"string\" &&\n record.piSessionFile.length > 0)) &&\n typeof record.paneId === \"string\" &&\n record.paneId.length > 0 &&\n record.paneId.length <= 512 &&\n (record.tabId === undefined ||\n (typeof record.tabId === \"string\" &&\n record.tabId.length > 0 &&\n record.tabId.length <= 512)) &&\n typeof record.workspaceId === \"string\" &&\n record.workspaceId.length > 0 &&\n record.workspaceId.length <= 512 &&\n typeof record.createdAt === \"number\" &&\n Number.isInteger(record.createdAt) &&\n record.createdAt >= 0\n );\n}\n\nexport function readChiefDescriptor(\n path = supervisionRuntime().descriptor,\n): ChiefDescriptor {\n let parsed: unknown;\n try {\n const content = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(content, \"utf8\") > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"descriptor too large\");\n parsed = JSON.parse(content);\n } catch (error) {\n throw new Error(\"Unable to verify Chief descriptor\", { cause: error });\n }\n if (!validDescriptor(parsed))\n throw new Error(\"Unable to verify Chief descriptor\");\n return parsed;\n}\n\nexport function chiefLeaseIsHeld(runtime: SupervisionRuntime): boolean {\n try {\n const claim = readLiveProcessLock(runtime.lock, \"Chief supervision lease\");\n const descriptor = readChiefDescriptor(runtime.descriptor);\n return (\n descriptor.claim.pid === claim.pid && descriptor.claim.id === claim.id\n );\n } catch {\n return false;\n }\n}\n\nfunction writeDescriptor(\n path: string,\n descriptor: ChiefDescriptor | ManagerDescriptor,\n): void {\n const temporary = join(\n dirname(path),\n `.${basename(path)}.${randomUUID()}.tmp`,\n );\n const content = `${JSON.stringify(descriptor)}\\n`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n chmodSync(temporary, 0o600);\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(dirname(path));\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function sameChiefDescriptor(\n actual: ChiefDescriptor,\n expected: ChiefDescriptor,\n): boolean {\n return (\n actual.leaseId === expected.leaseId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.piSessionId === expected.piSessionId &&\n actual.piSessionFile === expected.piSessionFile &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.createdAt === expected.createdAt\n );\n}\n\nexport function claimChiefLease(identity: ChiefIdentity): ChiefLease {\n if (\n !identity ||\n !isRuntimeBuild(identity.build) ||\n typeof identity.piSessionId !== \"string\" ||\n !identity.piSessionId ||\n identity.piSessionId.length > 512 ||\n (identity.piSessionFile !== undefined &&\n (typeof identity.piSessionFile !== \"string\" ||\n !identity.piSessionFile)) ||\n typeof identity.paneId !== \"string\" ||\n !identity.paneId ||\n identity.paneId.length > 512 ||\n (identity.tabId !== undefined &&\n (typeof identity.tabId !== \"string\" ||\n !identity.tabId ||\n identity.tabId.length > 512)) ||\n typeof identity.workspaceId !== \"string\" ||\n !identity.workspaceId ||\n identity.workspaceId.length > 512 ||\n (identity.createdAt !== undefined &&\n (typeof identity.createdAt !== \"number\" ||\n !Number.isInteger(identity.createdAt) ||\n identity.createdAt < 0))\n )\n throw new Error(\"Invalid Chief identity\");\n const runtime = supervisionRuntime();\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.inbox, { recursive: true, mode: 0o700 });\n chmodSync(runtime.inbox, 0o700);\n const lease = acquireProcessLock(runtime.lock, {\n name: \"Chief supervision lease\",\n });\n const descriptor: ChiefDescriptor = {\n version: 1,\n build: identity.build,\n leaseId: randomUUID(),\n claim: lease.claim,\n piSessionId: identity.piSessionId,\n ...(identity.piSessionFile !== undefined\n ? { piSessionFile: identity.piSessionFile }\n : {}),\n paneId: identity.paneId,\n ...(identity.tabId ? { tabId: identity.tabId } : {}),\n workspaceId: identity.workspaceId,\n createdAt: identity.createdAt ?? Date.now(),\n };\n try {\n writeDescriptor(runtime.descriptor, descriptor);\n } catch (error) {\n lease.release();\n throw error;\n }\n let released = false;\n return {\n descriptor,\n runtime,\n release: () => {\n if (released) return;\n released = true;\n try {\n if (\n sameChiefDescriptor(\n readChiefDescriptor(runtime.descriptor),\n descriptor,\n )\n )\n unlinkSync(runtime.descriptor);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n // A malformed or replaced descriptor is not ours to remove.\n }\n } finally {\n lease.release();\n }\n },\n };\n}\n\nexport type ManagerDescriptor = {\n version: 1;\n build?: RuntimeBuild;\n leaseId: string;\n claim: ProcessLockClaim;\n piSessionId: string;\n piSessionFile?: string;\n paneId: string;\n tabId: string;\n workspaceId: string;\n repoKey: string;\n createdAt: number;\n};\nexport type ManagerIdentity = Pick<\n ManagerDescriptor,\n | \"piSessionId\"\n | \"piSessionFile\"\n | \"paneId\"\n | \"tabId\"\n | \"workspaceId\"\n | \"repoKey\"\n> & { build: RuntimeBuild; createdAt?: number };\nexport type ManagerLease = {\n descriptor: ManagerDescriptor;\n runtime: SupervisionRuntime;\n release: () => void;\n};\nexport type ManagerDescriptorStatus = Readonly<{\n descriptor: ManagerDescriptor;\n live: boolean;\n}>;\n\nexport function managerDescriptorPath(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): string {\n if (!validNativeIdentity(workspaceId))\n throw new Error(\"Invalid Manager workspace ID\");\n return join(\n runtime.managers,\n `${createHash(\"sha256\").update(workspaceId).digest(\"hex\")}.json`,\n );\n}\n\nfunction validManagerDescriptor(value: unknown): value is ManagerDescriptor {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"leaseId\",\n \"claim\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"repoKey\",\n \"createdAt\",\n ];\n return (\n Object.keys(r).every(\n (key) => keys.includes(key) || key === \"piSessionFile\" || key === \"build\",\n ) &&\n keys.every((key) => Object.hasOwn(r, key)) &&\n r.version === 1 &&\n (r.build === undefined || isRuntimeBuild(r.build)) &&\n UUID.test(String(r.leaseId)) &&\n isProcessLockClaim(r.claim) &&\n validSession(r.piSessionId) &&\n (r.piSessionFile === undefined ||\n (typeof r.piSessionFile === \"string\" && r.piSessionFile.length > 0)) &&\n validNativeIdentity(r.paneId) &&\n validNativeIdentity(r.tabId) &&\n validNativeIdentity(r.workspaceId) &&\n validNativeIdentity(r.repoKey) &&\n Number.isInteger(r.createdAt) &&\n (r.createdAt as number) >= 0\n );\n}\n\nexport function sameManagerDescriptor(\n actual: ManagerDescriptor,\n expected: ManagerDescriptor,\n): boolean {\n return (\n actual.version === expected.version &&\n actual.leaseId === expected.leaseId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.piSessionId === expected.piSessionId &&\n actual.piSessionFile === expected.piSessionFile &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.repoKey === expected.repoKey &&\n actual.createdAt === expected.createdAt\n );\n}\n\nexport function readManagerDescriptorStatus(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): ManagerDescriptorStatus | undefined {\n const path = managerDescriptorPath(runtime, workspaceId);\n const lockPath = `${path}.lock`;\n let content: string;\n try {\n if (statSync(path).size > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"descriptor too large\");\n content = readFileSync(path, \"utf8\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n try {\n if (!statSync(lockPath, { throwIfNoEntry: false })) return undefined;\n } catch (lockError) {\n throw new Error(\"Unable to verify Manager descriptor\", {\n cause: lockError,\n });\n }\n }\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n let descriptor: unknown;\n try {\n descriptor = JSON.parse(content);\n } catch (error) {\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n if (\n !validManagerDescriptor(descriptor) ||\n descriptor.workspaceId !== workspaceId\n )\n throw new Error(\"Unable to verify Manager descriptor\");\n let status: ReturnType<typeof readProcessLockStatus>;\n try {\n status = readProcessLockStatus(lockPath, \"Manager supervision lease\");\n } catch (error) {\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n if (\n status.claim.pid !== descriptor.claim.pid ||\n status.claim.id !== descriptor.claim.id\n )\n throw new Error(\"Manager process-lock generation changed\");\n return { descriptor, live: status.live };\n}\n\nexport function readManagerDescriptor(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): ManagerDescriptor | undefined {\n const status = readManagerDescriptorStatus(runtime, workspaceId);\n if (!status) return undefined;\n if (!status.live)\n throw new Error(\"Unable to verify Manager supervision lease\");\n return status.descriptor;\n}\n\nexport function listManagerDescriptors(\n runtime = supervisionRuntime(),\n strict = false,\n): ManagerDescriptor[] {\n let entries: string[];\n try {\n entries = readdirSync(runtime.managers);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => /^[0-9a-f]{64}\\.json$/.test(entry))\n .sort()\n .flatMap((entry) => {\n try {\n const path = join(runtime.managers, entry);\n if (statSync(path).size > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"Manager descriptor too large\");\n const candidate: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !validManagerDescriptor(candidate) ||\n basename(managerDescriptorPath(runtime, candidate.workspaceId)) !==\n entry\n )\n throw new Error(\"Invalid Manager descriptor\");\n const status = readManagerDescriptorStatus(\n runtime,\n candidate.workspaceId,\n );\n return status?.live ? [status.descriptor] : [];\n } catch (error) {\n if (strict) throw error;\n return [];\n }\n });\n}\n\nexport function claimManagerLease(\n identity: ManagerIdentity,\n runtime = supervisionRuntime(),\n): ManagerLease {\n if (\n !identity ||\n !isRuntimeBuild(identity.build) ||\n !validSession(identity.piSessionId) ||\n (identity.piSessionFile !== undefined &&\n (typeof identity.piSessionFile !== \"string\" ||\n !identity.piSessionFile)) ||\n !validNativeIdentity(identity.paneId) ||\n !validNativeIdentity(identity.tabId) ||\n !validNativeIdentity(identity.workspaceId) ||\n !validNativeIdentity(identity.repoKey) ||\n (identity.createdAt !== undefined &&\n (!Number.isInteger(identity.createdAt) || identity.createdAt < 0))\n )\n throw new Error(\"Invalid Manager identity\");\n mkdirSync(runtime.managers, { recursive: true, mode: 0o700 });\n chmodSync(runtime.managers, 0o700);\n const path = managerDescriptorPath(runtime, identity.workspaceId);\n const lease = acquireProcessLock(`${path}.lock`, {\n name: \"Manager supervision lease\",\n });\n const descriptor: ManagerDescriptor = {\n version: 1,\n build: identity.build,\n leaseId: randomUUID(),\n claim: lease.claim,\n piSessionId: identity.piSessionId,\n ...(identity.piSessionFile !== undefined\n ? { piSessionFile: identity.piSessionFile }\n : {}),\n paneId: identity.paneId,\n tabId: identity.tabId,\n workspaceId: identity.workspaceId,\n repoKey: identity.repoKey,\n createdAt: identity.createdAt ?? Date.now(),\n };\n try {\n writeDescriptor(path, descriptor);\n } catch (error) {\n lease.release();\n throw error;\n }\n let released = false;\n return {\n descriptor,\n runtime,\n release: () => {\n if (released) return;\n released = true;\n try {\n const current = readManagerDescriptor(runtime, identity.workspaceId);\n if (current && sameManagerDescriptor(current, descriptor)) {\n unlinkSync(path);\n fsyncDirectory(runtime.managers);\n }\n } catch {\n /* A replaced or malformed descriptor is not ours to remove. */\n } finally {\n lease.release();\n }\n },\n };\n}\n\nexport type ProjectAssignment = Readonly<{\n version: 2;\n id: string;\n repoKey: string;\n branch: string;\n text: string;\n checkoutPath?: string;\n piSessionFile?: string;\n resultBindings?: ResultBinding[];\n requiredEvidence?: RequiredEvidence[];\n currentEvidenceIds?: string[];\n}>;\n\nexport const PROJECT_ASSIGNMENT_MAX_BYTES = 1024 * 1024;\nconst PROJECT_ASSIGNMENT_FILE_MAX_BYTES = PROJECT_ASSIGNMENT_MAX_BYTES * 2;\n\nexport function projectAssignmentBytes(assignment: ProjectAssignment): number {\n const { checkoutPath: _, piSessionFile: __, ...payload } = assignment;\n return Buffer.byteLength(`${JSON.stringify(payload)}\\n`, \"utf8\");\n}\n\nexport function projectAssignmentPath(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): string {\n if (!validNativeIdentity(repoKey) || !validNativeIdentity(branch))\n throw new Error(\"Invalid project assignment identity\");\n return join(\n runtime.assignments,\n createHash(\"sha256\").update(repoKey).digest(\"hex\"),\n `${createHash(\"sha256\").update(branch).digest(\"hex\")}.json`,\n );\n}\n\nfunction validProjectAssignment(value: unknown): value is ProjectAssignment {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n const required = [\"version\", \"id\", \"repoKey\", \"branch\", \"text\"];\n const optional = [\n \"checkoutPath\",\n \"piSessionFile\",\n \"resultBindings\",\n \"requiredEvidence\",\n \"currentEvidenceIds\",\n ];\n return (\n required.every((key) => Object.hasOwn(r, key)) &&\n Object.keys(r).every(\n (key) => required.includes(key) || optional.includes(key),\n ) &&\n Object.keys(r).length >= required.length &&\n r.version === 2 &&\n UUID.test(String(r.id)) &&\n validNativeIdentity(r.repoKey) &&\n validNativeIdentity(r.branch) &&\n typeof r.text === \"string\" &&\n r.text.length > 0 &&\n (r.checkoutPath === undefined ||\n (typeof r.checkoutPath === \"string\" &&\n isAbsolute(r.checkoutPath) &&\n normalize(r.checkoutPath) === r.checkoutPath &&\n !/[\\u0000-\\u001f]/.test(r.checkoutPath))) &&\n (r.piSessionFile === undefined ||\n (typeof r.piSessionFile === \"string\" && r.piSessionFile.length > 0)) &&\n (r.resultBindings === undefined ||\n (Array.isArray(r.resultBindings) &&\n r.resultBindings.every(isResultBinding))) &&\n (r.requiredEvidence === undefined ||\n (Array.isArray(r.requiredEvidence) &&\n r.requiredEvidence.every(isRequiredEvidence) &&\n r.requiredEvidence.every(\n (evidence) =>\n \"result\" in evidence || evidence.sourceAssignmentId === r.id,\n ) &&\n new Set(r.requiredEvidence.map((evidence) => evidence.id)).size ===\n r.requiredEvidence.length)) &&\n (r.currentEvidenceIds === undefined ||\n (Array.isArray(r.currentEvidenceIds) &&\n new Set(r.currentEvidenceIds).size === r.currentEvidenceIds.length &&\n r.currentEvidenceIds.every(\n (id) =>\n typeof id === \"string\" &&\n (r.requiredEvidence as RequiredEvidence[] | undefined)?.some(\n (evidence) => evidence.id === id,\n ),\n )))\n );\n}\n\nexport function writeProjectAssignment(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n withProjectAssignmentLock(() =>\n writeProjectAssignmentUnlocked(runtime, assignment),\n );\n}\n\nexport function writeProjectAssignmentAfter(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n assignment: ProjectAssignment,\n signal?: AbortSignal,\n verifyAuthority?: () => void,\n onOccupied?: () => void,\n): Promise<void> {\n return withProjectAssignmentAuthorityWait(\n () => {\n verifyAuthority?.();\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || !isDeepStrictEqual(current, expected))\n throw new Error(\n \"Project assignment changed before required evidence was updated\",\n );\n writeProjectAssignmentUnlocked(runtime, assignment);\n },\n signal,\n onOccupied,\n );\n}\n\nfunction writeProjectAssignmentUnlocked(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n assignment = upgradeProjectAssignmentEvidence(assignment);\n if (!validProjectAssignment(assignment))\n throw new Error(\"Invalid project assignment\");\n const content = `${JSON.stringify(assignment)}\\n`;\n if (\n projectAssignmentBytes(assignment) > PROJECT_ASSIGNMENT_MAX_BYTES ||\n Buffer.byteLength(content, \"utf8\") > PROJECT_ASSIGNMENT_FILE_MAX_BYTES\n )\n throw new Error(\"Project assignment is too large\");\n const path = projectAssignmentPath(\n runtime,\n assignment.repoKey,\n assignment.branch,\n );\n const directory = dirname(path);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n chmodSync(runtime.assignments, 0o700);\n chmodSync(directory, 0o700);\n const temporary = join(directory, `.${assignment.id}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nfunction upgradeProjectAssignmentEvidence(\n assignment: ProjectAssignment,\n): ProjectAssignment {\n if (!assignment.requiredEvidence?.length) return assignment;\n const requiredEvidence = assignment.requiredEvidence.map(\n upgradeAndVerifyRequiredEvidence,\n );\n if (\n requiredEvidence.every(\n (evidence, index) => evidence === assignment.requiredEvidence![index],\n )\n )\n return assignment;\n return {\n ...assignment,\n requiredEvidence,\n };\n}\n\n/** Persist legacy snapshot refs under the assignment authority lock before a resume advertises them. */\nexport function migrateProjectAssignmentEvidence(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n expectedAssignmentId?: string,\n): ProjectAssignment | undefined {\n return withProjectAssignmentLock(() => {\n const current = readProjectAssignment(runtime, repoKey, branch);\n if (\n !current ||\n (expectedAssignmentId && current.id !== expectedAssignmentId)\n )\n return undefined;\n const upgraded = upgradeProjectAssignmentEvidence(current);\n if (upgraded !== current) writeProjectAssignmentUnlocked(runtime, upgraded);\n return upgraded;\n });\n}\n\nexport function migrateProjectAssignmentEvidenceAfter(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n signal?: AbortSignal,\n): Promise<ProjectAssignment | undefined> {\n return withProjectAssignmentAuthorityWait(() => {\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || !isDeepStrictEqual(current, expected)) return undefined;\n const upgraded = upgradeProjectAssignmentEvidence(current);\n if (upgraded !== current) writeProjectAssignmentUnlocked(runtime, upgraded);\n return upgraded;\n }, signal);\n}\n\nexport function readProjectAssignment(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectAssignment | undefined {\n const path = projectAssignmentPath(runtime, repoKey, branch);\n return readProjectAssignmentFile(path, repoKey, branch);\n}\n\nfunction readProjectAssignmentFile(\n path: string,\n repoKey: string | undefined,\n branch?: string,\n pending = false,\n): ProjectAssignment | undefined {\n let value: unknown;\n try {\n const file = lstatSync(path);\n if (!file.isFile() || file.isSymbolicLink())\n throw new Error(\"invalid file\");\n if (file.size > PROJECT_ASSIGNMENT_FILE_MAX_BYTES)\n throw new Error(\"file is too large\");\n value = JSON.parse(readFileSync(path, \"utf8\"));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n const reason =\n error instanceof SyntaxError\n ? \"invalid JSON\"\n : error instanceof Error && error.message === \"file is too large\"\n ? error.message\n : `read failed${safeFilesystemCode(error)}`;\n throw projectAssignmentReadError(path, reason);\n }\n if (!validProjectAssignment(value))\n throw projectAssignmentReadError(path, \"invalid assignment schema\");\n try {\n for (const evidence of value.requiredEvidence ?? [])\n if (!(\"result\" in evidence) && evidence.ref)\n verifySemanticEvidenceReservation(evidence.id, evidence.ref);\n } catch {\n throw projectAssignmentReadError(path, \"invalid evidence identity\");\n }\n if (projectAssignmentBytes(value) > PROJECT_ASSIGNMENT_MAX_BYTES)\n throw projectAssignmentReadError(path, \"assignment payload is too large\");\n if (\n (repoKey !== undefined && value.repoKey !== repoKey) ||\n basename(dirname(path)) !==\n createHash(\"sha256\").update(value.repoKey).digest(\"hex\") ||\n (branch !== undefined && value.branch !== branch) ||\n basename(path) !==\n `${createHash(\"sha256\").update(value.branch).digest(\"hex\")}${pending ? `.${value.id}` : \"\"}.json`\n )\n throw projectAssignmentReadError(path, \"assignment identity mismatch\");\n return value;\n}\n\nfunction safeFilesystemCode(error: unknown): string {\n const code = (error as NodeJS.ErrnoException)?.code;\n return typeof code === \"string\" && /^[A-Z0-9_]{1,32}$/.test(code)\n ? ` (${code})`\n : \"\";\n}\n\nfunction projectAssignmentReadError(path: string, reason: string): Error {\n return new Error(`Unable to read project assignment ${path}: ${reason}`);\n}\n\nexport function listProjectAssignments(\n runtime: SupervisionRuntime,\n repoKey: string,\n): ProjectAssignment[] {\n const directory = dirname(projectAssignmentPath(runtime, repoKey, \"lookup\"));\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => /^[a-f0-9]{64}\\.json$/.test(entry))\n .map((entry) => {\n const assignment = readProjectAssignmentFile(\n join(directory, entry),\n repoKey,\n );\n if (!assignment)\n throw projectAssignmentReadError(\n join(directory, entry),\n \"file disappeared while listing\",\n );\n return assignment;\n })\n .sort((a, b) => a.branch.localeCompare(b.branch));\n}\n\nexport function findProjectAssignmentBySession(\n runtime: SupervisionRuntime,\n repoKey: string,\n sessionId: string,\n): ProjectAssignment[] {\n return listProjectAssignments(runtime, repoKey).filter(\n (assignment) => assignment.id === sessionId,\n );\n}\n\nexport function removeProjectAssignment(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): void {\n withProjectAssignmentLock(() =>\n removeProjectAssignmentUnlocked(runtime, repoKey, branch),\n );\n}\n\n// Caller holds the exact branch lock; the global lock serializes authority writers.\nexport function retireProjectAssignment(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): boolean {\n return withProjectAssignmentLock(() => {\n for (const directory of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n runtime.assignments,\n dirname(\n projectAssignmentPath(runtime, expected.repoKey, expected.branch),\n ),\n ])\n assignmentDirectory(directory);\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || current.id !== expected.id) return false;\n const source = projectAssignmentPath(\n runtime,\n current.repoKey,\n current.branch,\n );\n const destination = pendingRetirementPath(runtime, current);\n const root = join(runtime.root, \"retirements\");\n for (const directory of [root, dirname(destination)]) {\n try {\n mkdirSync(directory, { mode: 0o700 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n assignmentDirectory(directory);\n }\n if (lstatSync(destination, { throwIfNoEntry: false }))\n throw new Error(\"Pending retirement already exists\");\n renameSync(source, destination);\n // A sync failure is indeterminate durability: never restore authority or retry the move.\n fsyncDirectory(dirname(source));\n fsyncDirectory(dirname(destination));\n fsyncDirectory(root);\n fsyncDirectory(runtime.root);\n return true;\n });\n}\n\nfunction pendingRetirementPath(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): string {\n if (!validProjectAssignment(expected))\n throw new Error(\"Invalid project assignment\");\n const active = projectAssignmentPath(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n return join(\n runtime.root,\n \"retirements\",\n basename(dirname(active)),\n `${basename(active, \".json\")}.${expected.id}.json`,\n );\n}\n\nexport function listPendingRetirements(\n runtime: SupervisionRuntime,\n repoKey: string,\n options: {\n after?: string;\n recordLimit?: number;\n onReadError?: (error: Error) => void;\n onScanned?: (entry: string) => void;\n } = {},\n): ProjectAssignment[] {\n const repository = basename(\n dirname(projectAssignmentPath(runtime, repoKey, \"lookup\")),\n );\n const root = join(runtime.root, \"retirements\");\n const directory = join(root, repository);\n let entries: string[];\n try {\n for (const parent of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n root,\n directory,\n ])\n assignmentDirectory(parent);\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n entries.sort();\n const start = options.after\n ? Math.max(\n 0,\n entries.findIndex((entry) => entry > options.after!),\n )\n : 0;\n const ordered = [...entries.slice(start), ...entries.slice(0, start)];\n const records: ProjectAssignment[] = [];\n const recordLimit = Math.min(\n options.recordLimit ?? COORDINATION_INBOX_SCAN_LIMIT,\n COORDINATION_INBOX_SCAN_LIMIT,\n );\n for (const entry of ordered.slice(0, COORDINATION_INBOX_SCAN_LIMIT)) {\n options.onScanned?.(entry);\n const path = join(directory, entry);\n try {\n const record = readProjectAssignmentFile(path, repoKey, undefined, true);\n if (!record)\n throw projectAssignmentReadError(\n path,\n \"file disappeared while listing\",\n );\n records.push(record);\n if (records.length >= recordLimit) break;\n } catch (error) {\n const failure = error instanceof Error ? error : new Error(String(error));\n if (!options.onReadError) throw failure;\n options.onReadError(failure);\n }\n }\n return records.sort(\n (a, b) => a.branch.localeCompare(b.branch) || a.id.localeCompare(b.id),\n );\n}\n\nexport function removePendingRetirement(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): void {\n withProjectAssignmentLock(() => {\n const path = pendingRetirementPath(runtime, expected);\n const root = join(runtime.root, \"retirements\");\n for (const directory of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n root,\n dirname(path),\n ])\n assignmentDirectory(directory);\n const record = readProjectAssignmentFile(\n path,\n expected.repoKey,\n expected.branch,\n true,\n );\n if (!record) return;\n if (record.id !== expected.id)\n throw new Error(\"Pending retirement identity mismatch\");\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n });\n}\n\nfunction removeProjectAssignmentUnlocked(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): void {\n const path = projectAssignmentPath(runtime, repoKey, branch);\n try {\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nexport type GlobalProjectAssignment = Readonly<{\n socketHash: string;\n assignment: ProjectAssignment;\n}>;\n\nfunction assignmentDirectory(path: string): void {\n const stat = lstatSync(path);\n if (!stat.isDirectory() || stat.isSymbolicLink())\n throw new Error(`Invalid project assignment authority directory ${path}`);\n}\n\nfunction scanGlobalProjectAssignments(): Map<\n string,\n GlobalProjectAssignment[]\n> {\n const dataRoot = herdsmanDataRoot();\n const runtimeRoot = join(dataRoot, \"runtime\");\n const root = join(runtimeRoot, \"supervision-v2\");\n let sockets: import(\"node:fs\").Dirent[];\n try {\n // lstat every authority path component: checking supervision-v2 alone\n // would still follow a symlinked runtime directory.\n assignmentDirectory(dataRoot);\n assignmentDirectory(runtimeRoot);\n assignmentDirectory(root);\n sockets = readdirSync(root, { withFileTypes: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return new Map();\n throw error;\n }\n const bySession = new Map<string, GlobalProjectAssignment[]>();\n for (const socket of sockets) {\n if (isIncidentalMetadata(socket)) continue;\n if (!/^[a-f0-9]{64}$/.test(socket.name))\n throw new Error(\n `Unexpected project assignment socket entry ${socket.name}`,\n );\n if (!socket.isDirectory() || socket.isSymbolicLink())\n throw new Error(\n `Invalid project assignment socket directory ${socket.name}`,\n );\n const socketRoot = join(root, socket.name);\n assignmentDirectory(socketRoot);\n const assignmentsRoot = join(socketRoot, \"assignments\");\n let repositories: import(\"node:fs\").Dirent[];\n try {\n assignmentDirectory(assignmentsRoot);\n repositories = readdirSync(assignmentsRoot, { withFileTypes: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") continue;\n throw error;\n }\n assignmentDirectory(assignmentsRoot);\n for (const repository of repositories) {\n if (isIncidentalMetadata(repository)) continue;\n if (!/^[a-f0-9]{64}$/.test(repository.name))\n throw new Error(\n `Unexpected project assignment repository entry ${repository.name}`,\n );\n if (!repository.isDirectory() || repository.isSymbolicLink())\n throw new Error(\n `Invalid project assignment repository directory ${repository.name}`,\n );\n const directory = join(assignmentsRoot, repository.name);\n assignmentDirectory(directory);\n for (const entry of readdirSync(directory, { withFileTypes: true })) {\n if (isIncidentalMetadata(entry)) continue;\n if (/^[a-f0-9]{64}\\.messages$/.test(entry.name)) {\n if (!entry.isDirectory() || entry.isSymbolicLink())\n throw new Error(`Invalid project message directory ${entry.name}`);\n continue;\n }\n if (/^[a-f0-9]{64}\\.json\\.lock$/.test(entry.name)) {\n if (!entry.isDirectory() || entry.isSymbolicLink())\n throw new Error(`Invalid project assignment lock ${entry.name}`);\n continue;\n }\n // Atomic writer temporaries are not committed authority records.\n if (/^\\..+\\.[a-f0-9-]{36}\\.tmp$/.test(entry.name)) {\n if (!entry.isFile() || entry.isSymbolicLink())\n throw new Error(\n `Invalid project assignment publication temporary ${entry.name}`,\n );\n continue;\n }\n if (!/^[a-f0-9]{64}\\.json$/.test(entry.name))\n throw new Error(`Unexpected project assignment record ${entry.name}`);\n if (!entry.isFile() || entry.isSymbolicLink())\n throw new Error(`Invalid project assignment record ${entry.name}`);\n const path = join(directory, entry.name);\n const assignment = readProjectAssignmentFile(\n path,\n undefined,\n undefined,\n );\n if (\n !assignment ||\n createHash(\"sha256\").update(assignment.repoKey).digest(\"hex\") !==\n repository.name\n )\n throw projectAssignmentReadError(\n path,\n \"assignment repository hash mismatch\",\n );\n const matches = bySession.get(assignment.id) ?? [];\n matches.push({ socketHash: socket.name, assignment });\n bySession.set(assignment.id, matches);\n }\n }\n }\n return bySession;\n}\n\n/** The full O(N) scan and caller's final synchronous action share the authority lock. */\n// ponytail: global lock + full assignment scan. Add session-keyed indexing only if measured contention warrants it.\nexport function withProjectAssignmentAuthority<T>(\n operation: (assignments: Map<string, GlobalProjectAssignment[]>) => T,\n): T {\n return withProjectAssignmentLock(() =>\n operation(scanGlobalProjectAssignments()),\n );\n}\n\nexport function globalProjectAssignmentSnapshot(): Map<\n string,\n GlobalProjectAssignment[]\n> {\n return withProjectAssignmentAuthority((snapshot) => snapshot);\n}\n\nexport type ProjectMessage = Readonly<{\n version: 2;\n id: string;\n repoKey: string;\n branch: string;\n fromSessionId: string;\n text: string;\n kind?: \"execution_failure\";\n resultBindings?: ResultBinding[];\n createdAt: number;\n}>;\n\nexport type ProjectMessageHeader = Omit<\n ProjectMessage,\n \"text\" | \"resultBindings\"\n> & {\n text: string;\n resultBindings?: ResultBinding[];\n bodyRef?: OverflowBodyRef;\n};\ntype StoredProjectMessage = ProjectMessageHeader;\n\nfunction projectMessageDirectory(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): string {\n const assignment = projectAssignmentPath(runtime, repoKey, branch);\n return join(dirname(assignment), `${basename(assignment, \".json\")}.messages`);\n}\n\nfunction validProjectMessage(value: unknown): value is ProjectMessage {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n return (\n Object.keys(r).every((key) =>\n [\n \"version\",\n \"id\",\n \"repoKey\",\n \"branch\",\n \"fromSessionId\",\n \"text\",\n \"kind\",\n \"createdAt\",\n \"resultBindings\",\n \"bodyRef\",\n ].includes(key),\n ) &&\n Object.keys(r).length >= 7 &&\n [\n \"version\",\n \"id\",\n \"repoKey\",\n \"branch\",\n \"fromSessionId\",\n \"text\",\n \"createdAt\",\n ].every((key) => Object.hasOwn(r, key)) &&\n r.version === 2 &&\n UUID.test(String(r.id)) &&\n validNativeIdentity(r.repoKey) &&\n validNativeIdentity(r.branch) &&\n validSession(r.fromSessionId) &&\n typeof r.text === \"string\" &&\n (r.bodyRef === undefined\n ? r.text.length > 0\n : r.text === \"\" &&\n r.resultBindings === undefined &&\n validOverflowBodyRef(r.bodyRef)) &&\n (r.kind === undefined || r.kind === \"execution_failure\") &&\n (r.resultBindings === undefined ||\n (Array.isArray(r.resultBindings) &&\n r.resultBindings.every(isResultBinding))) &&\n Number.isInteger(r.createdAt) &&\n (r.createdAt as number) >= 0\n );\n}\n\nexport function projectMessageBytes(record: ProjectMessage): number {\n return Buffer.byteLength(`${JSON.stringify(record)}\\n`, \"utf8\");\n}\n\nexport function writeProjectMessage(\n record: ProjectMessage,\n runtime: SupervisionRuntime,\n): void {\n if (!validProjectMessage(record) || (record as any).bodyRef !== undefined)\n throw new Error(\"Invalid project message\");\n const path = join(\n projectMessageDirectory(runtime, record.repoKey, record.branch),\n `${record.id}.json`,\n );\n withChiefMessageLock(path, () =>\n writeProjectMessageUnlocked(record, runtime),\n );\n}\n\nfunction writeProjectMessageUnlocked(\n record: ProjectMessage,\n runtime: SupervisionRuntime,\n): void {\n if (!validProjectMessage(record) || (record as any).bodyRef !== undefined)\n throw new Error(\"Invalid project message\");\n const directory = projectMessageDirectory(\n runtime,\n record.repoKey,\n record.branch,\n );\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n chmodSync(runtime.assignments, 0o700);\n chmodSync(dirname(directory), 0o700);\n chmodSync(directory, 0o700);\n const path = join(directory, `${record.id}.json`);\n let stored: StoredProjectMessage = record;\n if (projectMessageBytes(record) > COORDINATION_MESSAGE_MAX_BYTES) {\n const bodyRef = writeOverflowBody(`${path}.body`, {\n text: record.text,\n ...(record.resultBindings\n ? { resultBindings: record.resultBindings }\n : {}),\n });\n stored = { ...record, text: \"\", bodyRef };\n delete (stored as any).resultBindings;\n if (\n projectMessageBytes(stored as ProjectMessage) >\n COORDINATION_MESSAGE_MAX_BYTES\n )\n throw new Error(\"Project message routing metadata is too large\");\n }\n const temporary = join(directory, `.${record.id}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, `${JSON.stringify(stored)}\\n`, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n let existing: ProjectMessage | undefined;\n try {\n existing = readProjectMessageFile(path);\n } catch (error) {\n if (\n (error as any).cause?.code !== \"ENOENT\" &&\n (error as NodeJS.ErrnoException).code !== \"ENOENT\"\n )\n throw new Error(`Unable to verify existing project message ${path}`, {\n cause: error,\n });\n }\n if (existing !== undefined) {\n if (JSON.stringify(existing) !== JSON.stringify(record))\n throw new Error(\n \"Project message identity conflicts with durable payload\",\n );\n } else {\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function listProjectMessages(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectMessage[] {\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .flatMap((entry) => {\n let value: ProjectMessage;\n try {\n value = readProjectMessageFile(join(directory, entry));\n } catch (error) {\n // Pending records may be consumed after directory enumeration.\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n return [];\n throw error;\n }\n if (value.repoKey !== repoKey || value.branch !== branch)\n throw new Error(`Project message identity does not match ${directory}`);\n return [value];\n })\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));\n}\n\n/** Lists compact pending records without opening or validating overflow bodies. */\nexport function listProjectMessageHeaders(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectMessageHeader[] {\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .flatMap((entry) => {\n try {\n const value = readStoredProjectMessageFile(join(directory, entry));\n if (value.repoKey !== repoKey || value.branch !== branch)\n throw new Error(\n `Project message identity does not match ${directory}`,\n );\n return [value];\n } catch (error) {\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n return [];\n throw error;\n }\n })\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));\n}\n\n/** Resolves one previously listed project message after its delivery is authorized. */\nexport function readProjectMessage(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n id: string,\n): ProjectMessage {\n if (!UUID.test(id)) throw new Error(\"Invalid project message ID\");\n const record = readProjectMessageFile(\n join(projectMessageDirectory(runtime, repoKey, branch), `${id}.json`),\n );\n if (record.repoKey !== repoKey || record.branch !== branch)\n throw new Error(\"Project message identity does not match its directory\");\n return record;\n}\n\nexport function removeProjectMessage(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n id: string,\n): void {\n if (!UUID.test(id)) throw new Error(\"Invalid project message ID\");\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n try {\n if (!statSync(directory).isDirectory())\n throw new Error(\"Invalid project message directory\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n throw error;\n }\n const path = join(directory, `${id}.json`);\n withChiefMessageLock(path, () => removeProjectMessageUnlocked(directory, id));\n}\n\nfunction removeProjectMessageUnlocked(directory: string, id: string): void {\n try {\n unlinkSync(join(directory, `${id}.json`));\n fsyncDirectory(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n unlinkSync(join(directory, `${id}.json.body`));\n fsyncDirectory(directory);\n } catch {}\n}\n\nfunction readProjectMessageFile(path: string): ProjectMessage {\n try {\n const stored = readStoredProjectMessageFile(path);\n if ((stored as StoredProjectMessage).bodyRef) {\n const compact = stored as StoredProjectMessage;\n const body = readOverflowBody(`${path}.body`, compact.bodyRef!);\n const value = { ...compact, ...body } as ProjectMessage;\n delete (value as any).bodyRef;\n if (!validProjectMessage(value)) throw new Error(\"invalid body\");\n return value;\n }\n return stored as ProjectMessage;\n } catch (error) {\n if (\n error instanceof Error &&\n error.message.startsWith(\"Unable to read project message \")\n )\n throw error;\n throw new Error(`Unable to read project message ${path}`, { cause: error });\n }\n}\n\nfunction readStoredProjectMessageFile(path: string): StoredProjectMessage {\n try {\n if (statSync(path).size > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"large\");\n const stored: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !validProjectMessage(stored) ||\n basename(path) !== `${(stored as ProjectMessage).id}.json`\n )\n throw new Error(\"invalid\");\n return stored as StoredProjectMessage;\n } catch (error) {\n throw new Error(`Unable to read project message ${path}`, { cause: error });\n }\n}\n\nexport function removeProjectMessagesForAssignment(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n for (const message of listProjectMessageHeaders(\n runtime,\n assignment.repoKey,\n assignment.branch,\n )) {\n if (message.fromSessionId === assignment.id)\n removeProjectMessage(\n runtime,\n assignment.repoKey,\n assignment.branch,\n message.id,\n );\n }\n}\n\nexport function recoverStaleProjectMessages(\n runtime: SupervisionRuntime,\n repoKey: string,\n): void {\n withProjectAssignmentLock(() => {\n const directory = dirname(\n projectAssignmentPath(runtime, repoKey, \"lookup\"),\n );\n let entries: string[];\n try {\n const dataRoot = herdsmanDataRoot();\n for (const path of [\n dataRoot,\n join(dataRoot, \"runtime\"),\n join(dataRoot, \"runtime\", \"supervision-v2\"),\n runtime.root,\n runtime.assignments,\n directory,\n ])\n assignmentDirectory(path);\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n throw error;\n }\n for (const entry of entries.filter((entry) =>\n /^[a-f0-9]{64}\\.messages$/.test(entry),\n )) {\n const messages = join(directory, entry);\n assignmentDirectory(messages);\n for (const file of readdirSync(messages).filter(\n (file) => UUID.test(file.slice(0, -5)) && file.endsWith(\".json\"),\n )) {\n const path = join(messages, file);\n let message: ProjectMessageHeader;\n try {\n message = readStoredProjectMessageFile(path);\n } catch (error) {\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n continue;\n throw error;\n }\n if (\n message.repoKey !== repoKey ||\n projectMessageDirectory(runtime, message.repoKey, message.branch) !==\n messages\n )\n throw new Error(`Project message identity does not match ${path}`);\n const current = readProjectAssignment(runtime, repoKey, message.branch);\n if (!current || current.id !== message.fromSessionId)\n removeProjectMessage(runtime, repoKey, message.branch, message.id);\n }\n }\n });\n}\n\nexport type CoordinatorState = {\n version: 1;\n build?: RuntimeBuild;\n role?: CoordinatorRole;\n instanceId: string;\n piSessionId: string;\n updatedAt: number;\n};\nexport type LeadCoordinationState = CoordinatorState;\n\nexport function verifyManagerCoordinationAuthority(\n descriptor: ManagerDescriptor,\n coordinator: LeadCoordinationState | undefined,\n build: RuntimeBuild,\n requireCompatibleBuild: typeof import(\"./compatibility.ts\").requireCompatibleBuild,\n): void {\n if (\n !coordinator ||\n coordinator.role !== \"manager\" ||\n coordinator.piSessionId !== descriptor.piSessionId\n )\n throw new Error(\n \"Manager authority exists but its coordination state could not be verified\",\n );\n requireCompatibleBuild(\n build,\n descriptor.build,\n \"supervision\",\n `Manager ${descriptor.piSessionId}`,\n );\n requireCompatibleBuild(\n build,\n coordinator.build,\n \"supervision\",\n `Manager ${descriptor.piSessionId}`,\n );\n}\n\nexport async function verifyRemoteChiefAuthority(\n descriptor: ChiefDescriptor,\n options: {\n remoteIdentity(): Promise<unknown | undefined>;\n requireCompatibleBuild: typeof import(\"./compatibility.ts\").requireCompatibleBuild;\n build: RuntimeBuild;\n },\n): Promise<boolean> {\n if (!(await options.remoteIdentity())) return false;\n options.requireCompatibleBuild(\n options.build,\n descriptor.build,\n \"supervision\",\n `Chief ${descriptor.piSessionId}`,\n );\n return true;\n}\n\nexport async function leadSupervisorState(\n ctx: ExtensionContext,\n host: {\n workspaceId(): string | undefined;\n resolveEffectiveSupervisor(\n ctx: ExtensionContext,\n sessionId: string,\n workspaceId: string,\n ): Promise<\n | { kind: \"assigned\" }\n | { kind: \"manager\" }\n | { kind: \"chief\" }\n | { kind: \"none\" }\n >;\n currentManager(ctx: ExtensionContext): Promise<unknown | undefined>;\n },\n): Promise<string> {\n try {\n const workspaceId = host.workspaceId();\n if (!workspaceId) throw new Error(\"Lead workspace is unavailable\");\n const supervisor = await host.resolveEffectiveSupervisor(\n ctx,\n ctx.sessionManager.getSessionId(),\n workspaceId,\n );\n if (supervisor.kind === \"assigned\") {\n try {\n if (await host.currentManager(ctx))\n return `<supervisor_state>\\nsupervisor: manager\\navailability: available\\nproject_messages: retained across Manager turnover\\n</supervisor_state>`;\n } catch {\n return `<supervisor_state>\\nsupervisor: manager\\navailability: unknown\\nproject_messages: retained for the Manager role\\n</supervisor_state>`;\n }\n return `<supervisor_state>\\nsupervisor: manager\\navailability: unavailable\\nproject_messages: retained for the Manager role\\n</supervisor_state>`;\n }\n if (supervisor.kind === \"manager\")\n return `<supervisor_state>\\nsupervisor: manager\\navailability: available\\n</supervisor_state>`;\n if (supervisor.kind === \"chief\")\n return `<supervisor_state>\\nsupervisor: chief\\navailability: available\\n</supervisor_state>`;\n return `<supervisor_state>\\nsupervisor: none\\navailability: unavailable\\nguidance: continue independently; do not use message_supervisor until a supervisor is available\\n</supervisor_state>`;\n } catch {\n return `<supervisor_state>\\nsupervisor: unverified\\navailability: unknown\\nguidance: continue independently; do not use message_supervisor until a supervisor is verified\\n</supervisor_state>`;\n }\n}\n\nexport function supervisorStateMessage(\n customType: string,\n content: string,\n latestContent: string | undefined,\n): { customType: string; content: string; display: false } | undefined {\n return latestContent === content\n ? undefined\n : { customType, content, display: false };\n}\n\nexport type SupervisedLead = {\n relationship?: \"assigned\" | \"supervised\";\n lead: string;\n branch?: string;\n herdRunStartedAt?: number;\n contextPercent?: number;\n /** Internal: path to a non-empty persisted session candidate. */\n piSessionFile?: string;\n instanceId?: string;\n displayName: string;\n workspaceId: string;\n workspaceLabel?: string;\n tabId: string;\n paneId: string;\n runtimeState: RuntimeState;\n agentCounts: { active: number; blocked: number; total: number };\n availableActions: Array<\"inspect\" | \"transcript\" | \"message\">;\n agents: Array<{ id: string; label: string; state: RuntimeState }>;\n};\n\nexport function staffToolName(\n action: \"inspect\" | \"transcript\" | \"message\",\n): string {\n switch (action) {\n case \"inspect\":\n return \"inspect_staff\";\n case \"transcript\":\n return \"read_staff_transcript\";\n case \"message\":\n return \"message_staff\";\n }\n}\n/** Chief can act on these Managers only; nested Leads are observational. */\nexport type SupervisedManager = {\n session: string;\n instanceId?: string;\n displayName: string;\n project: string;\n workspaceId: string;\n paneId: string;\n tabId: string;\n runtimeState: RuntimeState;\n agentCounts: { active: number; blocked: number; total: number };\n leadCounts: { active: number; blocked: number; total: number };\n incompatibleLeadCount?: number;\n leads: Array<{\n session: string;\n instanceId?: string;\n paneId?: string;\n tabId?: string;\n workspaceId?: string;\n displayName: string;\n runtimeState: RuntimeState;\n agentCounts?: { active: number; blocked: number; total: number };\n compatibility?: \"incompatible\";\n build?: RuntimeBuild;\n }>;\n availableActions: Array<\"inspect\" | \"transcript\" | \"message\">;\n};\n/** A Chief snapshot has Managers as its only actionable reports. */\nexport type ChiefManagerReportSnapshot = {\n managers: SupervisedManager[];\n leads?: SupervisedLead[];\n incompatible?: IncompatibleStaff[];\n diagnostics?: string[];\n};\nexport type IncompatibleStaff = Readonly<{\n role: \"manager\" | \"lead\";\n session: string;\n instanceId: string;\n displayName: string;\n workspaceId: string;\n paneId: string;\n tabId: string;\n runtimeState: RuntimeState;\n build: RuntimeBuild;\n reason: \"incompatible_build\";\n}>;\nexport type SupervisionSnapshot = {\n leads: SupervisedLead[];\n incompatible?: IncompatibleStaff[];\n project?: string;\n work?: ProjectWorkSnapshot[];\n openWorkspaces?: readonly OpenProjectWorkspace[];\n diagnostics?: string[];\n};\nexport type OpenProjectWorkspace = Readonly<{\n workspaceId: string;\n branch?: string;\n path: string;\n linked: boolean;\n}>;\nexport type ProjectWorkStatus = \"active\" | \"paused\" | \"unknown\" | \"conflict\";\nexport type UnverifiedAssignedLead = Readonly<{\n lead: string;\n status: \"unknown\" | \"conflict\";\n issue: string;\n}>;\nexport type ProjectWorkSnapshot = Readonly<{\n branch: string;\n session: string;\n status: ProjectWorkStatus;\n runtimeState?: RuntimeState;\n task?: string;\n issue?: string;\n}>;\nexport function projectTaskSummary(text: string): string | undefined {\n const task = text\n .replace(/[\\u0000-\\u001f\\u007f]/g, \" \")\n .replace(/\\s+/gu, \" \")\n .trim();\n\n if (!task) return undefined;\n\n const characters = Array.from(task);\n return characters.length <= 160\n ? task\n : `${characters.slice(0, 159).join(\"\")}\u2026`;\n}\n/** Derive work from one caller-validated Lead inventory and one Herdr worktree list. */\nexport function projectWorkSnapshot(options: {\n assignments: readonly ProjectAssignment[];\n worktrees: readonly Readonly<{\n branch: string;\n open_workspace_id?: string | null;\n }>[];\n leads: readonly Pick<\n SupervisedLead,\n \"lead\" | \"workspaceId\" | \"runtimeState\"\n >[];\n unverified?: readonly UnverifiedAssignedLead[];\n}): ProjectWorkSnapshot[] {\n return options.assignments.map((assignment) => {\n const worktrees = options.worktrees.filter(\n (item) => item.branch === assignment.branch,\n );\n const exact = options.leads.filter((lead) => lead.lead === assignment.id);\n const uncertain =\n options.unverified?.filter((lead) => lead.lead === assignment.id) ?? [];\n let status: ProjectWorkStatus;\n let runtimeState: RuntimeState | undefined;\n let issue: string | undefined;\n if (\n worktrees.length > 1 ||\n exact.length > 1 ||\n uncertain.length > 1 ||\n (exact.length > 0 && uncertain.length > 0)\n ) {\n status = \"conflict\";\n issue = \"project runtime identity is ambiguous\";\n } else if (uncertain.length === 1) {\n status = uncertain[0]!.status;\n issue = uncertain[0]!.issue;\n } else {\n const workspaceId = worktrees[0]?.open_workspace_id ?? undefined;\n if (\n exact.length === 1 &&\n (!workspaceId || exact[0]!.workspaceId !== workspaceId)\n ) {\n status = \"conflict\";\n issue = \"assigned Lead is running outside its branch worktree\";\n } else if (exact.length === 1) {\n status = \"active\";\n runtimeState = exact[0]!.runtimeState;\n } else {\n status = \"paused\";\n }\n }\n const task = projectTaskSummary(assignment.text);\n return {\n branch: assignment.branch,\n session: assignment.id,\n status,\n ...(runtimeState ? { runtimeState } : {}),\n ...(task ? { task } : {}),\n ...(issue ? { issue } : {}),\n };\n });\n}\nexport type SupervisionPresentationSnapshot =\n SupervisionSnapshot | ChiefManagerReportSnapshot;\nexport type RuntimeState =\n | \"idle\"\n | \"working\"\n | \"blocked\"\n | \"settling\"\n | \"starting\"\n | \"done\"\n | \"unknown\"\n | \"lost\";\nexport type LiveAgent = {\n sessionId: string;\n /** Internal: path to a non-empty persisted session candidate. */\n piSessionFile?: string;\n sessionKind: \"id\";\n workspaceId: string;\n paneId: string;\n tabId: string;\n workspaceCwd?: string;\n herdrName?: string;\n tabLabel?: string;\n tokens?: Readonly<Record<string, unknown>>;\n runtimeState?: RuntimeState;\n};\nexport type WorkspaceProvenance = Readonly<{\n workspaceLabel?: string;\n workspaceCwd?: string;\n repoName?: string;\n branch?: string;\n}>;\nexport type ValidatedManagedAgentEvidence = {\n piSessionId: string;\n ownerSessionId: string;\n workspaceId: string;\n paneId: string;\n runtimeState: RuntimeState;\n agentLabel?: string;\n};\n\nexport const LEAD_STATE_MAX_BYTES = COORDINATION_MESSAGE_MAX_BYTES * 2;\n/** Fits the complete coordination record, including JSON and UTF-8 overhead. */\nfunction leadStateDirectory(runtime: SupervisionRuntime): string {\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.leads, { recursive: true, mode: 0o700 });\n chmodSync(runtime.leads, 0o700);\n return runtime.leads;\n}\nexport function leadCoordinationStatePath(\n runtime: SupervisionRuntime,\n piSessionId: string,\n): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid lead session ID\");\n return join(\n runtime.leads,\n createHash(\"sha256\").update(piSessionId).digest(\"hex\") + \".json\",\n );\n}\nfunction validLeadState(value: unknown): value is CoordinatorState {\n if (!value || typeof value !== \"object\") return false;\n const r = value as Record<string, unknown>;\n const keys = [\"version\", \"instanceId\", \"piSessionId\", \"updatedAt\"];\n if (\n Object.keys(r).some(\n (k) => !keys.includes(k) && k !== \"role\" && k !== \"build\",\n ) ||\n keys.some((k) => !Object.hasOwn(r, k))\n )\n return false;\n return (\n r.version === 1 &&\n (r.build === undefined || isRuntimeBuild(r.build)) &&\n (r.role === undefined || r.role === \"lead\" || r.role === \"manager\") &&\n UUID.test(String(r.instanceId)) &&\n validSession(r.piSessionId) &&\n Number.isInteger(r.updatedAt) &&\n (r.updatedAt as number) >= 0\n );\n}\nexport function readLeadCoordinationState(\n runtime: SupervisionRuntime,\n piSessionId: string,\n): LeadCoordinationState | undefined {\n const path = leadCoordinationStatePath(runtime, piSessionId);\n try {\n const text = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(text, \"utf8\") > LEAD_STATE_MAX_BYTES)\n throw new Error(\"lead state too large\");\n const value: unknown = JSON.parse(text);\n const currentState =\n value && typeof value === \"object\" && !Array.isArray(value)\n ? Object.fromEntries(\n Object.entries(value).filter(([key]) => key !== \"pendingAsk\"),\n )\n : value;\n if (\n !validLeadState(currentState) ||\n currentState.piSessionId !== piSessionId\n )\n throw new Error(\"invalid lead state\");\n return currentState;\n } catch (e) {\n if ((e as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw new Error(\"Unable to read lead coordination state\", { cause: e });\n }\n}\nexport function writeLeadCoordinationState(\n runtime: SupervisionRuntime,\n state: LeadCoordinationState,\n): string {\n if (!state.build || !validLeadState(state))\n throw new Error(\"Invalid lead coordination state\");\n leadStateDirectory(runtime);\n const path = leadCoordinationStatePath(runtime, state.piSessionId);\n const content = JSON.stringify(state) + \"\\n\";\n if (Buffer.byteLength(content, \"utf8\") > LEAD_STATE_MAX_BYTES)\n throw new Error(\"Lead coordination state is too large\");\n return publishRecord(path, content);\n}\n\n/** Remove a failed publication so an older generation cannot remain authority. */\nexport function invalidateLeadCoordinationState(\n runtime: SupervisionRuntime,\n piSessionId: string,\n expectedInstanceId?: string,\n): void {\n const path = leadCoordinationStatePath(runtime, piSessionId);\n if (expectedInstanceId !== undefined) {\n const current = readLeadCoordinationState(runtime, piSessionId);\n if (!current || current.instanceId !== expectedInstanceId) return;\n }\n try {\n unlinkSync(path);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n return;\n }\n fsyncDirectory(dirname(path));\n}\n\nexport function normalizeHerdrLifecycleState(agent: any): RuntimeState {\n const state = agent?.agent_status;\n return state === \"idle\" ||\n state === \"working\" ||\n state === \"blocked\" ||\n state === \"done\"\n ? state\n : \"unknown\";\n}\n\nfunction metadataInteger(\n tokens: Readonly<Record<string, unknown>> | undefined,\n key: string,\n): number | undefined {\n const raw = tokens?.[key];\n if (typeof raw !== \"string\" || !/^\\d+$/.test(raw)) return undefined;\n const value = Number(raw);\n return Number.isSafeInteger(value) ? value : undefined;\n}\n\n/** Projects caller-proven live leads and validated agent evidence; metadata is never authority. */\nexport function projectSupervision(options: {\n agents: LiveAgent[];\n managedAgents: ValidatedManagedAgentEvidence[];\n coordinationStates: LeadCoordinationState[];\n openWorkspaces?: readonly OpenProjectWorkspace[];\n workspaceProvenance?: ReadonlyMap<string, WorkspaceProvenance>;\n chiefSessionId?: string;\n excludedSessionIds?: ReadonlySet<string>;\n /** Leads already reported to an active Manager must not also report to Chief. */\n managerSupervisedLeadSessionIds?: ReadonlySet<string>;\n localBuild?: RuntimeBuild;\n managedAgentSessionIds?: Set<string>;\n}): SupervisionSnapshot {\n const states = new Map<string, LeadCoordinationState>();\n const duplicateStates = new Set<string>();\n for (const state of options.coordinationStates) {\n if (states.has(state.piSessionId)) duplicateStates.add(state.piSessionId);\n else states.set(state.piSessionId, state);\n }\n const leads: SupervisedLead[] = [];\n const incompatible: IncompatibleStaff[] = [];\n const validAgents = options.agents.filter(\n (agent) =>\n agent.sessionKind === \"id\" &&\n validSession(agent.sessionId) &&\n validNativeIdentity(agent.workspaceId) &&\n validNativeIdentity(agent.tabId) &&\n validNativeIdentity(agent.paneId),\n );\n const duplicatePhysical = new Set<string>();\n const physical = new Map<string, string>();\n for (const agent of validAgents) {\n const key = `${agent.workspaceId}\\0${agent.tabId}\\0${agent.paneId}`;\n const previous = physical.get(key);\n if (previous && previous !== agent.sessionId) duplicatePhysical.add(key);\n else physical.set(key, agent.sessionId);\n }\n const seenLeads = new Set<string>();\n const duplicateAgents = new Set<string>();\n for (const agent of validAgents) {\n if (seenLeads.has(agent.sessionId)) duplicateAgents.add(agent.sessionId);\n else seenLeads.add(agent.sessionId);\n }\n seenLeads.clear();\n for (const agent of validAgents) {\n if (seenLeads.has(agent.sessionId)) continue;\n seenLeads.add(agent.sessionId);\n const state = states.get(agent.sessionId);\n if (\n !state ||\n (state.role ?? \"lead\") !== \"lead\" ||\n duplicateAgents.has(agent.sessionId) ||\n duplicateStates.has(agent.sessionId) ||\n agent.sessionId === options.chiefSessionId ||\n options.excludedSessionIds?.has(agent.sessionId) ||\n options.managerSupervisedLeadSessionIds?.has(agent.sessionId) ||\n options.managedAgentSessionIds?.has(agent.sessionId) ||\n duplicatePhysical.has(\n `${agent.workspaceId}\\0${agent.tabId}\\0${agent.paneId}`,\n )\n )\n continue;\n if (options.localBuild && !isRuntimeBuild(state.build)) continue;\n if (\n options.localBuild &&\n !sameRuntimeBuild(options.localBuild, state.build)\n ) {\n incompatible.push({\n role: \"lead\",\n session: agent.sessionId,\n instanceId: state.instanceId,\n displayName: `${agent.workspaceId}/lead-${agent.sessionId.slice(0, 8)}`,\n workspaceId: agent.workspaceId,\n paneId: agent.paneId,\n tabId: agent.tabId,\n runtimeState: agent.runtimeState ?? \"unknown\",\n build: state.build,\n reason: \"incompatible_build\",\n });\n continue;\n }\n const runtimeState = agent.runtimeState ?? \"unknown\";\n const provenance =\n options.workspaceProvenance?.get(agent.workspaceId) ??\n (agent.workspaceCwd ? { workspaceCwd: agent.workspaceCwd } : undefined);\n const workspaceLabel =\n provenance?.repoName && provenance.branch\n ? `${provenance.repoName}/${provenance.branch}`\n : provenance?.workspaceLabel ||\n (provenance?.workspaceCwd\n ? basename(provenance.workspaceCwd)\n : undefined) ||\n agent.workspaceId;\n const tokensName =\n typeof agent.tokens?.pi_herdsman_name === \"string\"\n ? agent.tokens.pi_herdsman_name.trim()\n : \"\";\n const herdrName = agent.herdrName?.trim();\n const tabLabel = agent.tabLabel?.trim();\n const name =\n tokensName ||\n (herdrName &&\n herdrName !== agent.sessionId &&\n !/_[0-9a-f]{16}$/iu.test(herdrName)\n ? herdrName\n : undefined) ||\n tabLabel ||\n `lead-${agent.sessionId.slice(0, 8)}`;\n const herdRunStartedAt = metadataInteger(\n agent.tokens,\n \"pi_herdsman_herd_run_started_at\",\n );\n const contextPercent = metadataInteger(\n agent.tokens,\n \"pi_herdsman_context_percent\",\n );\n leads.push({\n lead: agent.sessionId,\n ...(herdRunStartedAt !== undefined ? { herdRunStartedAt } : {}),\n ...(contextPercent !== undefined ? { contextPercent } : {}),\n instanceId: state.instanceId,\n displayName: `${workspaceLabel || agent.workspaceId}/${name}`,\n ...(provenance?.branch ? { branch: provenance.branch } : {}),\n workspaceId: agent.workspaceId,\n ...(workspaceLabel ? { workspaceLabel } : {}),\n tabId: agent.tabId,\n paneId: agent.paneId,\n runtimeState,\n agentCounts: { active: 0, blocked: 0, total: 0 },\n ...(agent.piSessionFile ? { piSessionFile: agent.piSessionFile } : {}),\n availableActions: [\n \"inspect\",\n ...(agent.piSessionFile ? [\"transcript\" as const] : []),\n ],\n agents: [],\n });\n }\n const leadIds = new Set(leads.map((r) => r.lead));\n const ambiguousAgents = new Set<string>();\n const byId = new Map<string, ValidatedManagedAgentEvidence>();\n for (const managedAgent of options.managedAgents) {\n if (byId.has(managedAgent.piSessionId))\n ambiguousAgents.add(managedAgent.piSessionId);\n else byId.set(managedAgent.piSessionId, managedAgent);\n }\n for (const managedAgent of options.managedAgents) {\n if (ambiguousAgents.has(managedAgent.piSessionId)) continue;\n let owner = managedAgent.ownerSessionId;\n const seen = new Set<string>();\n while (!leadIds.has(owner)) {\n if (ambiguousAgents.has(owner) || seen.has(owner)) {\n owner = \"\";\n break;\n }\n seen.add(owner);\n owner = byId.get(owner)?.ownerSessionId ?? \"\";\n }\n const lead = leads.find((r) => r.lead === owner);\n if (!lead) continue;\n lead.agentCounts.total++;\n if (\n managedAgent.runtimeState === \"working\" ||\n managedAgent.runtimeState === \"settling\" ||\n managedAgent.runtimeState === \"starting\"\n )\n lead.agentCounts.active++;\n if (managedAgent.runtimeState === \"blocked\") lead.agentCounts.blocked++;\n if (lead.agents.length < 32)\n lead.agents.push({\n id: managedAgent.piSessionId,\n label: managedAgent.agentLabel ?? managedAgent.piSessionId,\n state: managedAgent.runtimeState,\n });\n }\n for (const lead of leads) {\n lead.availableActions.push(\"message\");\n }\n leads.sort(\n (a, b) =>\n a.displayName.localeCompare(b.displayName) ||\n a.lead.localeCompare(b.lead),\n );\n return {\n leads,\n ...(incompatible.length ? { incompatible } : {}),\n ...(options.openWorkspaces\n ? { openWorkspaces: options.openWorkspaces }\n : {}),\n };\n}\n\nexport function serializeSupervision(snapshot: SupervisionSnapshot) {\n return {\n ...(snapshot.diagnostics?.length\n ? { diagnostics: snapshot.diagnostics }\n : {}),\n leads: snapshot.leads.map((r) => ({\n session: r.lead,\n display_name: r.displayName,\n workspace_id: r.workspaceId,\n ...(r.workspaceLabel ? { workspace_label: r.workspaceLabel } : {}),\n tab_id: r.tabId,\n pane_id: r.paneId,\n runtime_state: r.runtimeState,\n agent_counts: r.agentCounts,\n available_tools: r.availableActions.map(staffToolName),\n agents: r.agents,\n })),\n };\n}\n", "import * as fs from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, join } from \"node:path\";\nimport { herdsmanTempRoot, isIncidentalMetadata } from \"./storage.ts\";\n\nexport class ProcessLockOccupiedError extends Error {\n readonly code = \"PROCESS_LOCK_OCCUPIED\";\n}\n\nexport type ProcessLockClaim = { pid: number; id: string };\n\nexport function assignmentLockPath(mailbox: string): string {\n return join(\n herdsmanTempRoot(),\n \"locks\",\n `assignment-${createHash(\"sha256\").update(mailbox).digest(\"hex\")}`,\n );\n}\n\nexport function sessionActivationLockPath(\n canonicalSessionPath: string,\n): string {\n return join(\n herdsmanTempRoot(),\n \"locks\",\n `session-${createHash(\"sha256\").update(canonicalSessionPath).digest(\"hex\")}`,\n );\n}\n\nexport function claimAssignmentLock(mailbox: string): () => void {\n return claimProcessLock(assignmentLockPath(mailbox), {\n name: \"managed assignment\",\n occupiedMessage: \"Managed assignment is already changing\",\n });\n}\n\nexport function tryClaimAssignmentLock(\n mailbox: string,\n): (() => void) | undefined {\n try {\n return claimAssignmentLock(mailbox);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) return undefined;\n throw error;\n }\n}\n\nexport function claimSessionActivationLock(\n canonicalSessionPath: string,\n): () => void {\n return claimProcessLock(sessionActivationLockPath(canonicalSessionPath), {\n name: \"session activation\",\n occupiedMessage: \"The exact Pi session is already being activated\",\n });\n}\n\nconst UUID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\ntype ProcessLockLease = { claim: ProcessLockClaim; release: () => void };\ntype LockOwner = ProcessLockClaim & {\n linuxBirth?: { bootId: string; startTicks: string };\n};\n\ntype ProcessLockOptions = {\n afterStaleOwnerRemoved?: () => void;\n name?: string;\n occupiedMessage?: string;\n};\n\nexport function isProcessLockClaim(value: unknown): value is ProcessLockClaim {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const claim = value as Record<string, unknown>;\n if (\n Object.keys(claim).length !== 2 ||\n !Object.hasOwn(claim, \"pid\") ||\n !Object.hasOwn(claim, \"id\") ||\n !Number.isInteger(claim.pid) ||\n (claim.pid as number) <= 0 ||\n typeof claim.id !== \"string\" ||\n !UUID.test(claim.id)\n )\n return false;\n return true;\n}\n\nfunction readProcessLockOwner(path: string, owner: string): LockOwner {\n const value: unknown = JSON.parse(fs.readFileSync(join(path, owner), \"utf8\"));\n if (!value || typeof value !== \"object\" || Array.isArray(value))\n throw new Error(\"invalid process lock claim\");\n const record = value as Record<string, unknown>;\n const claim = { pid: record.pid, id: record.id };\n if (\n !isProcessLockClaim(claim) ||\n owner !== `${claim.pid}-${claim.id}` ||\n (Object.keys(record).length !== 2 && Object.keys(record).length !== 3) ||\n (Object.keys(record).length === 3 && !Object.hasOwn(record, \"linuxBirth\"))\n )\n throw new Error(\"invalid process lock claim\");\n if (Object.hasOwn(record, \"linuxBirth\")) {\n const birth = record.linuxBirth;\n if (\n !birth ||\n typeof birth !== \"object\" ||\n Array.isArray(birth) ||\n Object.keys(birth).length !== 2 ||\n typeof (birth as Record<string, unknown>).bootId !== \"string\" ||\n !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(\n (birth as Record<string, string>).bootId,\n ) ||\n typeof (birth as Record<string, unknown>).startTicks !== \"string\" ||\n !/^(0|[1-9][0-9]*)$/.test((birth as Record<string, string>).startTicks)\n )\n throw new Error(\"invalid process lock identity\");\n return { ...claim, linuxBirth: birth as LockOwner[\"linuxBirth\"] };\n }\n return claim;\n}\n\nfunction readLinuxBirth(\n pid: number,\n): NonNullable<LockOwner[\"linuxBirth\"]> | undefined {\n const bootId = fs\n .readFileSync(\"/proc/sys/kernel/random/boot_id\", \"utf8\")\n .trim();\n let stat: string;\n try {\n stat = fs.readFileSync(`/proc/${pid}/stat`, \"utf8\");\n } catch (error) {\n if (\n (error as NodeJS.ErrnoException).code === \"ENOENT\" &&\n !processExists(pid)\n )\n return undefined;\n throw error;\n }\n const end = stat.lastIndexOf(\") \");\n if (end < 0 || !stat.startsWith(`${pid} (`))\n throw new Error(\"Invalid Linux process stat\");\n const fields = stat\n .slice(end + 2)\n .trim()\n .split(/\\s+/);\n const startTicks = fields[19];\n if (\n !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(bootId) ||\n fields.length < 20 ||\n !startTicks ||\n !/^(0|[1-9][0-9]*)$/.test(startTicks)\n )\n throw new Error(\"Invalid Linux process identity\");\n return { bootId, startTicks };\n}\n\nfunction processOwnerExists(owner: LockOwner): boolean {\n if (!processExists(owner.pid)) return false;\n if (process.platform !== \"linux\") return true;\n if (!owner.linuxBirth)\n throw new Error(\"Linux lock owner identity is unverifiable\");\n const current = readLinuxBirth(owner.pid);\n if (!current) return false;\n return (\n current.bootId === owner.linuxBirth.bootId &&\n current.startTicks === owner.linuxBirth.startTicks\n );\n}\n\nfunction publicClaim(owner: LockOwner): ProcessLockClaim {\n return { pid: owner.pid, id: owner.id };\n}\n\nfunction ownerMissing(path: string): boolean {\n try {\n fs.lstatSync(path);\n return false;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return true;\n throw error;\n }\n}\n\nfunction lockOwnerEntry(path: string): { owner: string; metadata: string[] } {\n const entries = fs.readdirSync(path, { withFileTypes: true });\n const owners = entries.filter((entry) => !isIncidentalMetadata(entry));\n if (owners.length !== 1 || !owners[0]!.isFile())\n throw new Error(\"Invalid process lock owner\");\n return {\n owner: owners[0]!.name,\n metadata: entries.filter(isIncidentalMetadata).map((entry) => entry.name),\n };\n}\n\nfunction processExists(pid: number): boolean {\n try {\n process.kill(pid, 0);\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ESRCH\") return false;\n throw error;\n }\n}\n\nfunction publishClaim(\n parent: string,\n claimDir: string,\n owner: string,\n payload: string,\n): void {\n // Publish the owner record before the canonical rename so observers never\n // see an empty canonical lock.\n const temporary = join(parent, `.${basename(claimDir)}.${randomUUID()}.tmp`);\n fs.mkdirSync(temporary, 0o700);\n const temporaryOwner = join(temporary, owner);\n let fd: number | undefined;\n try {\n fd = fs.openSync(temporaryOwner, \"wx\", 0o600);\n fs.writeSync(fd, payload);\n fs.fsyncSync(fd);\n fs.closeSync(fd);\n fd = undefined;\n fs.chmodSync(temporaryOwner, 0o600);\n fs.renameSync(temporary, claimDir);\n } finally {\n if (fd !== undefined) fs.closeSync(fd);\n try {\n fs.unlinkSync(temporaryOwner);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n fs.rmdirSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function readLiveProcessLock(\n path: string,\n name = \"process lock\",\n): ProcessLockClaim {\n const { claim, live } = readProcessLockStatus(path, name);\n if (!live) throw new Error(`Unable to verify ${name}`);\n return claim;\n}\n\nexport function readProcessLockStatus(\n path: string,\n name = \"process lock\",\n): { claim: ProcessLockClaim; live: boolean } {\n const verifyMessage = `Unable to verify ${name}`;\n let owner: string;\n try {\n ({ owner } = lockOwnerEntry(path));\n } catch (error) {\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n const record = readProcessLockOwner(path, owner);\n return { claim: publicClaim(record), live: processOwnerExists(record) };\n } catch (error) {\n throw new Error(verifyMessage, { cause: error });\n }\n}\n\nexport function acquireProcessLock(\n path: string,\n options: ProcessLockOptions = {},\n): ProcessLockLease {\n const name = options.name ?? \"process lock\";\n const verifyMessage = `Unable to verify ${name}`;\n const occupiedMessage =\n options.occupiedMessage ??\n `${name[0].toUpperCase()}${name.slice(1)} is in progress`;\n const recoverMessage = `Unable to recover ${name}`;\n const parent = dirname(path);\n fs.mkdirSync(parent, { recursive: true, mode: 0o700 });\n fs.chmodSync(parent, 0o700);\n const claimDir = path;\n const claim: ProcessLockClaim = { pid: process.pid, id: randomUUID() };\n const lockOwner: LockOwner =\n process.platform === \"linux\"\n ? { ...claim, linuxBirth: readLinuxBirth(process.pid)! }\n : claim;\n const owner = `${claim.pid}-${claim.id}`;\n const payload = JSON.stringify(lockOwner);\n const ownerPath = join(claimDir, owner);\n\n // An empty canonical directory is ambiguous and must not be replaced.\n try {\n lockOwnerEntry(claimDir);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n throw new Error(verifyMessage, { cause: error });\n }\n\n try {\n // Publish the complete claim with one rename. In particular, never\n // create the canonical directory before its owner record exists.\n publishClaim(parent, claimDir, owner, payload);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code !== \"EEXIST\" && code !== \"ENOTEMPTY\" && code !== \"EPERM\")\n throw error;\n let observedOwner: string;\n try {\n ({ owner: observedOwner } = lockOwnerEntry(claimDir));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(verifyMessage, { cause: error });\n }\n let staleOwner: LockOwner;\n try {\n staleOwner = readProcessLockOwner(claimDir, observedOwner);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n let currentOwner: string;\n try {\n ({ owner: currentOwner } = lockOwnerEntry(claimDir));\n } catch (checkError) {\n if ((checkError as NodeJS.ErrnoException).code === \"ENOENT\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(verifyMessage, { cause: checkError });\n }\n\n if (currentOwner !== observedOwner) {\n try {\n readProcessLockOwner(claimDir, currentOwner);\n } catch (checkError) {\n throw new Error(verifyMessage, { cause: checkError });\n }\n\n throw new ProcessLockOccupiedError(occupiedMessage);\n }\n }\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n if (processOwnerExists(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n // Move the complete, verified stale claim out of the canonical name in one\n // operation. Never unlink the owner while leaving an empty canonical\n // directory behind.\n const quarantine = join(\n parent,\n `.${basename(claimDir)}.${randomUUID()}.stale`,\n );\n try {\n const { owner: currentOwner } = lockOwnerEntry(claimDir);\n if (currentOwner !== observedOwner)\n throw new ProcessLockOccupiedError(occupiedMessage);\n const currentClaim = readProcessLockOwner(claimDir, observedOwner);\n if (JSON.stringify(currentClaim) !== JSON.stringify(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n fs.renameSync(claimDir, quarantine);\n } catch (removeError) {\n const code = (removeError as NodeJS.ErrnoException).code;\n if (code === \"ENOENT\" || code === \"ENOTEMPTY\" || code === \"EEXIST\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(recoverMessage, { cause: removeError });\n }\n\n // A concurrent claimant may have won the canonical name while it was\n // absent. Never clean up a quarantined directory unless it is still the\n // exact stale claim that was verified above.\n let quarantinedOwner: string;\n let metadata: string[];\n try {\n ({ owner: quarantinedOwner, metadata } = lockOwnerEntry(quarantine));\n } catch (error) {\n throw new Error(recoverMessage, { cause: error });\n }\n if (quarantinedOwner !== observedOwner)\n throw new ProcessLockOccupiedError(occupiedMessage);\n try {\n const quarantinedClaim = readProcessLockOwner(quarantine, observedOwner);\n if (JSON.stringify(quarantinedClaim) !== JSON.stringify(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n options.afterStaleOwnerRemoved?.();\n try {\n unlinkMetadata(quarantine, metadata);\n fs.unlinkSync(join(quarantine, observedOwner));\n fs.rmdirSync(quarantine);\n } catch (cleanupError) {\n throw new Error(recoverMessage, { cause: cleanupError });\n }\n try {\n publishClaim(parent, claimDir, owner, payload);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code === \"EEXIST\" || code === \"ENOTEMPTY\" || code === \"EPERM\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw error;\n }\n }\n return {\n claim,\n release: () => releaseProcessLock(claimDir, ownerPath, claim, name),\n };\n}\n\nexport function claimProcessLock(\n path: string,\n options: ProcessLockOptions = {},\n): () => void {\n return acquireProcessLock(path, options).release;\n}\n\nfunction releaseProcessLock(\n claimDir: string,\n ownerPath: string,\n claim: ProcessLockClaim,\n name: string,\n): void {\n let owner: string;\n try {\n ({ owner } = lockOwnerEntry(claimDir));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n // A lease whose owner has already disappeared or been replaced must not\n // affect the current lock generation.\n try {\n if (ownerMissing(ownerPath)) return;\n } catch (missing) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: missing });\n }\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n if (owner !== basename(ownerPath)) {\n try {\n if (ownerMissing(ownerPath)) return;\n } catch (error) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n throw new Error(\n `${name[0].toUpperCase()}${name.slice(1)} ownership changed`,\n );\n }\n let current: LockOwner;\n try {\n current = readProcessLockOwner(claimDir, basename(ownerPath));\n } catch (error) {\n if (\n (error as NodeJS.ErrnoException).code === \"ENOENT\" &&\n ownerMissing(ownerPath)\n )\n return;\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n if (current.pid !== claim.pid || current.id !== claim.id)\n throw new Error(\n `${name[0].toUpperCase()}${name.slice(1)} ownership changed`,\n );\n // Retire the complete claim before cleanup; a new canonical owner may follow.\n const retired = join(\n dirname(claimDir),\n `.${basename(claimDir)}.${randomUUID()}.released`,\n );\n fs.renameSync(claimDir, retired);\n let retiredOwner: string;\n let metadata: string[];\n try {\n ({ owner: retiredOwner, metadata } = lockOwnerEntry(retired));\n if (retiredOwner !== basename(ownerPath))\n throw new Error(\"Process lock owner changed\");\n const relocated = readProcessLockOwner(retired, retiredOwner);\n if (relocated.pid !== claim.pid || relocated.id !== claim.id)\n throw new Error(\"Process lock generation changed\");\n } catch (error) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n unlinkMetadata(retired, metadata);\n fs.unlinkSync(join(retired, retiredOwner));\n try {\n fs.rmdirSync(retired);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code !== \"ENOENT\" && code !== \"ENOTEMPTY\") throw error;\n }\n}\n\nfunction unlinkMetadata(path: string, entries: string[]): void {\n for (const entry of entries) {\n try {\n fs.unlinkSync(join(path, entry));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n", "import {\n createHash,\n randomBytes,\n randomUUID,\n timingSafeEqual,\n} from \"node:crypto\";\nimport {\n chmodSync,\n mkdirSync,\n readFileSync,\n readdirSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { acquireProcessLock, ProcessLockOccupiedError } from \"./lock.ts\";\nimport { herdsmanDataRoot } from \"./storage.ts\";\nimport { isResultBinding, type ResultBinding } from \"./storage.ts\";\nimport {\n PEER_TRANSPORT_FRAME_LIMIT_BYTES,\n peerPayloadDigest,\n} from \"./peer-transport.ts\";\nexport { peerPayloadDigest } from \"./peer-transport.ts\";\n\nexport type PeerPortableAttachment = Readonly<{\n name: string;\n ref?: string;\n marker: string;\n text: string;\n sha256: string;\n}>;\nexport type PeerEvidence = Readonly<{\n attachments: PeerPortableAttachment[];\n resultBindings?: ResultBinding[];\n}>;\n\nexport function resolvePeerResultBindings(\n bindings: readonly ResultBinding[],\n existingRefs: (semanticRef: string) => ReadonlySet<string>,\n): { bindings: ResultBinding[]; conflicts: ResultBinding[] } {\n const accepted: ResultBinding[] = [];\n const conflicts: ResultBinding[] = [];\n for (const binding of bindings) {\n const existing = existingRefs(binding.ref);\n if (\n existing.size > 1 ||\n (existing.size === 1 && !existing.has(binding.canonicalRef))\n )\n conflicts.push(binding);\n else accepted.push(binding);\n }\n return { bindings: accepted, conflicts };\n}\n\nexport type PeerCorrespondence = {\n id: string;\n capability: string;\n role?: \"manager\" | \"lead\";\n originSession: string;\n originGeneration: string;\n recipientSession: string;\n recipientGeneration: string;\n acceptanceId: string;\n originDisplay?: PeerOriginDisplay;\n finalized?: boolean;\n replies: Array<{\n id: string;\n digest: string;\n text: string;\n attachments?: PeerPortableAttachment[];\n resultBindings?: ResultBinding[];\n createdAt: number;\n acknowledged: boolean;\n }>;\n};\n\nexport type PeerOriginDisplay = {\n name?: string;\n workspaceLabel?: string;\n};\n\nexport function validPeerDisplayText(value: unknown): value is string {\n return (\n typeof value === \"string\" &&\n value.trim().length > 0 &&\n value.length <= 512 &&\n !/[\\u0000-\\u001f\\u007f-\\u009f\\u061c\\u200e\\u200f\\u2028-\\u202e\\u2066-\\u2069]/u.test(\n value,\n )\n );\n}\n\nfunction validOriginDisplay(value: unknown): value is PeerOriginDisplay {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const fields = Object.entries(value);\n return (\n fields.length > 0 &&\n fields.every(\n ([key, text]) =>\n (key === \"name\" || key === \"workspaceLabel\") &&\n validPeerDisplayText(text),\n )\n );\n}\n\nconst ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;\nexport function assertPeerDataRoot(actual: string, expected: string): void {\n if (!actual || !expected || actual !== expected)\n throw new Error(\"peer endpoint data root does not match the active route\");\n}\nfunction directory(): string {\n const path = join(herdsmanDataRoot(), \"runtime\", \"peer-correspondences\");\n mkdirSync(path, { recursive: true, mode: 0o700 });\n chmodSync(path, 0o700);\n return path;\n}\nfunction valid(value: unknown): value is PeerCorrespondence {\n if (!value || typeof value !== \"object\") return false;\n const c = value as PeerCorrespondence;\n return (\n ID.test(c.id) &&\n /^[0-9a-f]{64}$/u.test(c.capability) &&\n (c.role === undefined || c.role === \"manager\" || c.role === \"lead\") &&\n [\n c.originSession,\n c.originGeneration,\n c.recipientSession,\n c.recipientGeneration,\n c.acceptanceId,\n ].every((s) => typeof s === \"string\" && s.length > 0 && s.length <= 512) &&\n (c.originDisplay === undefined || validOriginDisplay(c.originDisplay)) &&\n (c.finalized === undefined || typeof c.finalized === \"boolean\") &&\n Array.isArray(c.replies) &&\n c.replies.every(\n (reply) =>\n !!reply &&\n ID.test(reply.id) &&\n /^[0-9a-f]{64}$/u.test(reply.digest) &&\n typeof reply.text === \"string\" &&\n (reply.attachments === undefined ||\n (Array.isArray(reply.attachments) &&\n reply.attachments.every(\n (attachment) =>\n typeof attachment.name === \"string\" &&\n typeof attachment.marker === \"string\" &&\n typeof attachment.text === \"string\" &&\n /^[0-9a-f]{64}$/u.test(attachment.sha256) &&\n createHash(\"sha256\")\n .update(attachment.text, \"utf8\")\n .digest(\"hex\") === attachment.sha256,\n ))) &&\n (reply.resultBindings === undefined ||\n (Array.isArray(reply.resultBindings) &&\n reply.resultBindings.every(isResultBinding))) &&\n Number.isFinite(reply.createdAt) &&\n typeof reply.acknowledged === \"boolean\",\n )\n );\n}\nfunction save(c: PeerCorrespondence): void {\n const path = join(directory(), `${c.id}.json`);\n const tmp = `${path}.${randomUUID()}.tmp`;\n writeFileSync(tmp, `${JSON.stringify(c)}\\n`, {\n mode: 0o600,\n flag: \"wx\",\n flush: true,\n });\n renameSync(tmp, path);\n}\nfunction mutate<T>(id: string, action: (c: PeerCorrespondence) => T): T {\n let lock: ReturnType<typeof acquireProcessLock> | undefined;\n const deadline = Date.now() + 15_000;\n while (!lock) {\n try {\n lock = acquireProcessLock(join(directory(), `${id}.lock`), {\n name: \"peer correspondence mutation\",\n });\n } catch (error) {\n if (\n !(error instanceof ProcessLockOccupiedError) ||\n Date.now() >= deadline\n )\n throw error;\n Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 10);\n }\n }\n try {\n const c = listPeerCorrespondences().find((item) => item.id === id);\n if (!c) throw new Error(\"peer correspondence not found\");\n const result = action(c);\n save(c);\n return result;\n } finally {\n lock.release();\n }\n}\nexport function createPeerCorrespondence(\n input: Omit<PeerCorrespondence, \"id\" | \"capability\" | \"replies\">,\n): PeerCorrespondence {\n const c: PeerCorrespondence = {\n ...input,\n role: input.role ?? \"manager\",\n id: randomUUID(),\n capability: randomBytes(32).toString(\"hex\"),\n replies: [],\n };\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n save(c);\n return c;\n}\nexport function storePeerCorrespondence(c: PeerCorrespondence): void {\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n const existing = listPeerCorrespondences().find((item) => item.id === c.id);\n if (existing) {\n mutate(c.id, (current) => {\n if (current.finalized)\n throw new Error(\"peer correspondence is already finalized\");\n if ((current.role ?? \"manager\") !== (c.role ?? \"manager\"))\n throw new Error(\"conflicting peer correspondence role\");\n if (\n [\n \"capability\",\n \"originSession\",\n \"originGeneration\",\n \"recipientSession\",\n ].some(\n (key) =>\n current[key as keyof PeerCorrespondence] !==\n c[key as keyof PeerCorrespondence],\n )\n )\n throw new Error(\"conflicting peer correspondence\");\n current.recipientGeneration = c.recipientGeneration;\n if (c.originDisplay) {\n current.originDisplay = {\n ...current.originDisplay,\n ...c.originDisplay,\n };\n }\n });\n return;\n }\n save({ ...c, role: c.role ?? \"manager\" });\n}\nexport function readPeerCorrespondence(\n id: string,\n): PeerCorrespondence | undefined {\n if (!ID.test(id)) throw new Error(\"invalid peer correspondence id\");\n const path = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"peer-correspondences\",\n `${id}.json`,\n );\n let current: unknown;\n try {\n current = JSON.parse(readFileSync(path, \"utf8\"));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw error;\n }\n if (!valid(current) || current.id !== id)\n throw new Error(\"invalid peer correspondence\");\n return current;\n}\nexport function verifyPeerCorrespondence(c: PeerCorrespondence): void {\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n const current = readPeerCorrespondence(c.id);\n if (\n !valid(current) ||\n current.finalized ||\n (current.role ?? \"manager\") !== (c.role ?? \"manager\") ||\n [\n \"capability\",\n \"originSession\",\n \"originGeneration\",\n \"recipientSession\",\n \"recipientGeneration\",\n \"acceptanceId\",\n ].some(\n (key) =>\n current[key as keyof PeerCorrespondence] !==\n c[key as keyof PeerCorrespondence],\n )\n )\n throw new Error(\"conflicting peer correspondence\");\n}\nexport function updatePeerOriginGeneration(\n id: string,\n capability: string,\n originSession: string,\n oldGeneration: string,\n newGeneration: string,\n): PeerCorrespondence {\n if (!newGeneration) throw new Error(\"peer correspondence recovery rejected\");\n return mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession\n )\n throw new Error(\"peer correspondence recovery rejected\");\n if (c.originGeneration === newGeneration) return c;\n if (c.originGeneration !== oldGeneration)\n throw new Error(\"peer correspondence recovery rejected\");\n c.originGeneration = newGeneration;\n return c;\n });\n}\nexport function updatePeerRecipientGeneration(\n id: string,\n capability: string,\n recipientSession: string,\n oldGeneration: string,\n newGeneration: string,\n): PeerCorrespondence {\n if (!newGeneration)\n throw new Error(\"peer correspondence recipient recovery rejected\");\n return mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.recipientSession !== recipientSession\n )\n throw new Error(\"peer correspondence recipient recovery rejected\");\n if (c.recipientGeneration === newGeneration) return c;\n if (c.recipientGeneration !== oldGeneration)\n throw new Error(\"peer correspondence recipient recovery rejected\");\n c.recipientGeneration = newGeneration;\n return c;\n });\n}\nexport function removePeerCorrespondence(id: string): void {\n if (!ID.test(id)) return;\n try {\n unlinkSync(join(directory(), `${id}.json`));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\nexport function listPeerCorrespondences(): PeerCorrespondence[] {\n return readdirSync(directory()).flatMap((name) => {\n if (!ID.test(name.replace(/\\.json$/u, \"\")) || !name.endsWith(\".json\"))\n return [];\n try {\n const c: unknown = JSON.parse(\n readFileSync(join(directory(), name), \"utf8\"),\n );\n return valid(c) ? [c] : [];\n } catch {\n return [];\n }\n });\n}\nfunction matchesCapability(actual: string, expected: string): boolean {\n if (!/^[0-9a-f]{64}$/u.test(expected) || !/^[0-9a-f]{64}$/u.test(actual))\n return false;\n const actualBytes = Buffer.from(actual, \"hex\");\n const expectedBytes = Buffer.from(expected, \"hex\");\n if (timingSafeEqual(actualBytes, expectedBytes)) return true;\n return timingSafeEqual(\n Buffer.from(\n createHash(\"sha256\").update(expectedBytes).digest(\"hex\"),\n \"hex\",\n ),\n actualBytes,\n );\n}\nexport function queuePeerReply(\n c: PeerCorrespondence,\n replyId: string,\n text: string,\n evidence: PeerEvidence = { attachments: [] },\n): \"queued\" | \"duplicate\" {\n const payload = {\n text,\n ...(evidence.attachments.length\n ? { attachments: evidence.attachments }\n : {}),\n ...(evidence.resultBindings?.length\n ? { resultBindings: evidence.resultBindings }\n : {}),\n };\n if (\n !ID.test(replyId) ||\n !text ||\n Buffer.byteLength(JSON.stringify(payload), \"utf8\") >\n PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n throw new Error(\"invalid peer reply\");\n const digest = peerPayloadDigest(payload);\n return mutate(c.id, (current) => {\n if (current.finalized) throw new Error(\"peer correspondence is finalized\");\n const prior = current.replies.find((r) => r.id === replyId);\n if (prior) {\n if (prior.digest !== digest)\n throw new Error(\"conflicting peer reply identity\");\n return \"duplicate\";\n }\n const reply = {\n id: replyId,\n digest,\n text,\n ...(evidence.attachments.length\n ? { attachments: [...evidence.attachments] }\n : {}),\n ...(evidence.resultBindings?.length\n ? { resultBindings: [...evidence.resultBindings] }\n : {}),\n createdAt: Date.now(),\n acknowledged: false,\n };\n const envelope = (replies: typeof current.replies) =>\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies,\n hasReplies: true,\n });\n const single = Buffer.byteLength(envelope([reply]), \"utf8\") + 1;\n if (single > PEER_TRANSPORT_FRAME_LIMIT_BYTES)\n throw new Error(\"peer reply exceeds response limit\");\n current.replies.push(reply);\n return \"queued\";\n });\n}\nexport function pollPeerReplies(\n id: string,\n capability: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): PeerCorrespondence[\"replies\"] {\n const c = listPeerCorrespondences().find((item) => item.id === id);\n if (\n !c ||\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n const batch: PeerCorrespondence[\"replies\"] = [];\n for (const reply of c.replies.filter((item) => !item.acknowledged)) {\n const candidate = [...batch, reply];\n if (\n Buffer.byteLength(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies: candidate,\n hasReplies: c.replies.length > 0,\n }),\n \"utf8\",\n ) +\n 1 >\n PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n break;\n batch.push(reply);\n }\n return batch;\n}\nexport function acknowledgePeerReply(\n id: string,\n capability: string,\n replyId: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): void {\n pollPeerReplies(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n const reply = c.replies.find((item) => item.id === replyId);\n if (!reply) throw new Error(\"unknown peer reply\");\n reply.acknowledged = true;\n reply.text = \"\";\n delete reply.attachments;\n delete reply.resultBindings;\n });\n}\nexport function finalizePeerCorrespondence(\n id: string,\n capability: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): void {\n mutate(id, (c) => {\n if (\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n if (c.replies.some((reply) => !reply.acknowledged))\n throw new Error(\n \"cannot finalize peer correspondence with pending replies\",\n );\n if (c.finalized) return;\n c.capability = createHash(\"sha256\")\n .update(Buffer.from(capability, \"hex\"))\n .digest(\"hex\");\n c.replies = [];\n c.finalized = true;\n });\n}\n", "import {\n mkdirSync,\n chmodSync,\n lstatSync,\n readFileSync,\n readdirSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { spawn } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { acquireProcessLock, ProcessLockOccupiedError } from \"./lock.ts\";\nimport { herdsmanDataRoot } from \"./storage.ts\";\n\nexport type SavedPeerMachine = Readonly<{\n id: string;\n label: string;\n target: string;\n reachable: boolean;\n}>;\nexport type RemotePeerSnapshot = Readonly<{\n dataRoot: string;\n peers: Array<{\n role?: string;\n piSessionId: string;\n claim: { id: string };\n name?: string;\n cwd?: string;\n repo?: string;\n branch?: string;\n workspaceLabel?: string;\n sessionKind?: \"ordinary\" | \"managed\";\n build?: unknown;\n }>;\n ordinaryLeadsComplete?: boolean;\n}>;\n\nexport function peerRecoveryRequest(\n request: Readonly<{\n id: string;\n capability: string;\n originSession: string;\n originGeneration: string;\n previousOriginGeneration: string;\n recipientSession: string;\n recipientGeneration: string;\n }>,\n expectedDataRoot: string,\n): string {\n return JSON.stringify({ ...request, expectedDataRoot });\n}\n\nconst COMMAND_TIMEOUT_MS = 15_000;\nexport const PEER_TRANSPORT_FRAME_LIMIT_BYTES = 2 * 1024 * 1024;\nconst OUTPUT_LIMIT = PEER_TRANSPORT_FRAME_LIMIT_BYTES;\nconst OUTBOUND_RECORD_LIMIT_BYTES = 12 * 1024 * 1024;\n\nexport function peerPayloadDigest(value: unknown): string {\n const canonical = (item: unknown): string => {\n if (item === null || typeof item !== \"object\") {\n const scalar = JSON.stringify(item);\n if (scalar === undefined) throw new Error(\"invalid peer digest payload\");\n return scalar;\n }\n if (Array.isArray(item)) return `[${item.map(canonical).join(\",\")}]`;\n const object = item as Record<string, unknown>;\n return `{${Object.keys(object)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${canonical(object[key])}`)\n .join(\",\")}}`;\n };\n return createHash(\"sha256\").update(canonical(value), \"utf8\").digest(\"hex\");\n}\n\nexport type RemotePeerOutbound = Readonly<{\n id: string;\n machine: SavedPeerMachine;\n dataRoot: string;\n session: string;\n claimId: string;\n recipientSession: string;\n digest: string;\n envelope: string;\n}>;\n\nexport function resolveRemotePeerOutboundRetry(\n outbound: RemotePeerOutbound,\n status: {\n dataRoot?: unknown;\n id?: unknown;\n digest?: unknown;\n status?: unknown;\n },\n snapshot: RemotePeerSnapshot,\n): { kind: \"accepted\" | \"pending\" } | { kind: \"retry\"; envelope: string } {\n if (\n status.dataRoot !== outbound.dataRoot ||\n status.id !== outbound.id ||\n status.digest !== outbound.digest ||\n snapshot.dataRoot !== outbound.dataRoot\n )\n return { kind: \"pending\" };\n if (status.status === \"accepted\") return { kind: \"accepted\" };\n if (status.status !== \"absent\") return { kind: \"pending\" };\n let correspondenceRole: \"manager\" | \"lead\";\n try {\n const parsed: unknown = JSON.parse(outbound.envelope);\n if (!parsed || typeof parsed !== \"object\") return { kind: \"pending\" };\n const correspondence = (parsed as { correspondence?: { role?: unknown } })\n .correspondence;\n const source = (\n parsed as {\n record?: { peerSource?: { role?: unknown; remoteOrdinary?: unknown } };\n }\n ).record?.peerSource;\n correspondenceRole =\n correspondence?.role === undefined\n ? \"manager\"\n : (correspondence.role as \"manager\" | \"lead\");\n if (\n (correspondenceRole !== \"manager\" && correspondenceRole !== \"lead\") ||\n (correspondenceRole === \"manager\" && source?.role !== \"manager\") ||\n (correspondenceRole === \"lead\" &&\n (source?.role !== \"lead\" || source.remoteOrdinary !== true)) ||\n (correspondenceRole === \"lead\" && snapshot.ordinaryLeadsComplete !== true)\n )\n return { kind: \"pending\" };\n } catch {\n return { kind: \"pending\" };\n }\n const recipient = snapshot.peers.find(\n (peer) =>\n peer.role === correspondenceRole &&\n peer.piSessionId === outbound.recipientSession &&\n (correspondenceRole !== \"lead\" || peer.sessionKind === \"ordinary\"),\n );\n if (!recipient) return { kind: \"pending\" };\n const envelope = JSON.parse(outbound.envelope) as {\n record?: { id?: unknown; fromSessionId?: unknown; toSessionId?: unknown };\n recipientClaimId?: unknown;\n correspondence?: {\n originSession?: unknown;\n recipientSession?: unknown;\n recipientGeneration?: unknown;\n };\n };\n if (\n envelope.record?.id !== outbound.id ||\n envelope.record.fromSessionId !== outbound.session ||\n envelope.record.toSessionId !== outbound.recipientSession ||\n envelope.correspondence?.originSession !== outbound.session ||\n envelope.correspondence.recipientSession !== outbound.recipientSession\n )\n return { kind: \"pending\" };\n const full = JSON.parse(outbound.envelope) as {\n record: unknown;\n attachments?: unknown;\n };\n if (\n peerPayloadDigest({\n record: full.record,\n attachments: full.attachments,\n }) !== outbound.digest\n )\n return { kind: \"pending\" };\n if (envelope.recipientClaimId !== recipient.claim.id) {\n envelope.recipientClaimId = recipient.claim.id;\n envelope.correspondence.recipientGeneration = recipient.claim.id;\n }\n return { kind: \"retry\", envelope: JSON.stringify(envelope) };\n}\n\nfunction outboundDirectory(): string {\n const path = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"peers-v2\",\n \"remote-outbound\",\n );\n mkdirSync(path, { recursive: true, mode: 0o700 });\n chmodSync(path, 0o700);\n return path;\n}\n\nexport function tryClaimRemotePeerOutbound(\n id: string,\n): (() => void) | undefined {\n try {\n return acquireProcessLock(\n join(outboundDirectory(), `${id}.delivery.lock`),\n { name: \"peer outbound delivery\" },\n ).release;\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) return undefined;\n throw error;\n }\n}\n\nexport function persistRemotePeerOutbound(outbound: RemotePeerOutbound): void {\n const frameBytes = Buffer.byteLength(outbound.envelope, \"utf8\");\n const recordBytes = Buffer.byteLength(JSON.stringify(outbound), \"utf8\");\n if (\n !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u.test(\n outbound.id,\n ) ||\n frameBytes > PEER_TRANSPORT_FRAME_LIMIT_BYTES ||\n recordBytes > OUTBOUND_RECORD_LIMIT_BYTES\n )\n throw new Error(\"invalid remote peer outbound record\");\n const path = join(outboundDirectory(), `${outbound.id}.json`);\n writeFileSync(path, `${JSON.stringify(outbound)}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n}\n\nexport function retargetRemotePeerOutbound(\n id: string,\n digest: string,\n recipientSession: string,\n envelope: string,\n): RemotePeerOutbound {\n const path = join(outboundDirectory(), `${id}.json`);\n const lock = acquireProcessLock(`${path}.lock`, {\n name: \"peer outbound update\",\n });\n try {\n const current = listRemotePeerOutbounds().find((item) => item.id === id);\n if (\n !current ||\n current.digest !== digest ||\n current.recipientSession !== recipientSession\n )\n throw new Error(\"remote peer outbound identity changed\");\n const updated = { ...current, envelope };\n if (\n Buffer.byteLength(JSON.stringify(updated), \"utf8\") >\n OUTBOUND_RECORD_LIMIT_BYTES ||\n Buffer.byteLength(envelope, \"utf8\") > PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n throw new Error(\"invalid remote peer outbound record\");\n const temporary = `${path}.${randomUUID()}.tmp`;\n writeFileSync(temporary, `${JSON.stringify(updated)}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n try {\n renameSync(temporary, path);\n } catch (error) {\n unlinkSync(temporary);\n throw error;\n }\n return updated;\n } finally {\n lock.release();\n }\n}\n\nexport function listRemotePeerOutbounds(): RemotePeerOutbound[] {\n const directory = outboundDirectory();\n return readdirSync(directory)\n .filter((name) =>\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\.json$/u.test(\n name,\n ),\n )\n .flatMap((name) => {\n const path = join(directory, name);\n try {\n const stat = lstatSync(path);\n if (\n !stat.isFile() ||\n stat.isSymbolicLink() ||\n stat.size > OUTBOUND_RECORD_LIMIT_BYTES\n )\n return [];\n const value: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !value ||\n typeof value !== \"object\" ||\n (value as RemotePeerOutbound).id !== name.slice(0, -5) ||\n typeof (value as RemotePeerOutbound).envelope !== \"string\"\n )\n return [];\n return [value as RemotePeerOutbound];\n } catch {\n return [];\n }\n });\n}\n\nexport function removeRemotePeerOutbound(id: string): void {\n if (\n !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u.test(id)\n )\n return;\n try {\n unlinkSync(join(outboundDirectory(), `${id}.json`));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nfunction run(\n command: string,\n args: readonly string[],\n input?: string,\n signal?: AbortSignal,\n): Promise<string> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(new Error(\"Peer transport was cancelled\"));\n return;\n }\n const child = spawn(command, [...args], {\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n });\n let stdout = \"\";\n let stderr = \"\";\n let size = 0;\n let settled = false;\n let stdinError: Error | undefined;\n const timeout = setTimeout(() => child.kill(\"SIGKILL\"), COMMAND_TIMEOUT_MS);\n let abortKill: ReturnType<typeof setTimeout> | undefined;\n const cancel = () => {\n child.kill(\"SIGTERM\");\n abortKill = setTimeout(() => child.kill(\"SIGKILL\"), 1_000);\n };\n signal?.addEventListener(\"abort\", cancel, { once: true });\n const cleanup = () => {\n clearTimeout(timeout);\n if (abortKill) clearTimeout(abortKill);\n signal?.removeEventListener(\"abort\", cancel);\n child.stdin.removeListener(\"error\", onStdinError);\n };\n const finish = (error?: Error, value?: string) => {\n if (settled) return;\n settled = true;\n cleanup();\n if (error) reject(error);\n else resolve(value ?? \"\");\n };\n const onStdinError = (error: Error) => {\n stdinError ??= error;\n };\n child.stdin.on(\"error\", onStdinError);\n const collect = (target: \"stdout\" | \"stderr\", chunk: Buffer) => {\n size += chunk.length;\n if (size > OUTPUT_LIMIT) {\n child.kill(\"SIGKILL\");\n return;\n }\n if (target === \"stdout\") stdout += chunk.toString(\"utf8\");\n else stderr += chunk.toString(\"utf8\");\n };\n child.stdout.on(\"data\", (chunk: Buffer) => collect(\"stdout\", chunk));\n child.stderr.on(\"data\", (chunk: Buffer) => collect(\"stderr\", chunk));\n child.once(\"error\", (error) => {\n finish(error);\n });\n child.once(\"close\", (code) => {\n if (stdinError) finish(stdinError);\n else if (signal?.aborted)\n finish(new Error(\"Peer transport was cancelled\"));\n else if (code === 0) finish(undefined, stdout);\n else {\n const error = new Error(stderr.trim() || `${command} exited ${code}`);\n Object.assign(error, { exitCode: code });\n finish(error);\n }\n });\n child.stdin.end(input);\n });\n}\n\nexport async function listSavedPeerMachines(\n signal?: AbortSignal,\n): Promise<SavedPeerMachine[]> {\n const [listText, statusText] = await Promise.all([\n run(\"herdr\", [\"machine\", \"list\", \"--json\"], undefined, signal),\n run(\"herdr\", [\"machine\", \"status\", \"--json\"], undefined, signal),\n ]);\n const list: unknown = JSON.parse(listText);\n const statuses: unknown = JSON.parse(statusText);\n if (!Array.isArray(list) || !Array.isArray(statuses))\n throw new Error(\"Herdr returned invalid machine data\");\n const statusById = new Map<string, string>(\n statuses\n .filter(\n (item): item is { id: string; status: string } =>\n !!item &&\n typeof item === \"object\" &&\n typeof (item as { id?: unknown }).id === \"string\" &&\n (item as { status?: unknown }).status === \"reachable\",\n )\n .map((item) => [item.id, item.status]),\n );\n const machines = list.flatMap((item) => {\n if (\n !item ||\n typeof item !== \"object\" ||\n (item as { enabled?: unknown }).enabled !== true ||\n typeof (item as { id?: unknown }).id !== \"string\" ||\n typeof (item as { label?: unknown }).label !== \"string\" ||\n typeof (item as { target?: unknown }).target !== \"string\"\n )\n return [];\n return [\n {\n id: (item as { id: string }).id,\n label: (item as { label: string }).label,\n target: (item as { target: string }).target,\n reachable: statusById.get((item as { id: string }).id) === \"reachable\",\n },\n ];\n });\n return machines;\n}\n\nexport function parsePeerSshTarget(target: string): {\n host: string;\n port?: string;\n} {\n if (target.startsWith(\"ssh://\")) {\n const url = new URL(target);\n if (\n url.protocol !== \"ssh:\" ||\n !url.hostname ||\n (url.pathname !== \"\" && url.pathname !== \"/\") ||\n url.search ||\n url.hash\n )\n throw new Error(\"Unsupported saved SSH target\");\n const username = url.username ? `${decodeURIComponent(url.username)}@` : \"\";\n const host = `${username}${url.hostname}`;\n if (/^[\\s-]|[\\s\\0]/u.test(host))\n throw new Error(\"Unsupported saved SSH target\");\n return {\n host,\n ...(url.port ? { port: url.port } : {}),\n };\n }\n if (!target || /[\\s\\0]/u.test(target) || target.startsWith(\"-\"))\n throw new Error(\"Unsupported saved SSH target\");\n return { host: target };\n}\n\nexport async function runPeerEndpoint(\n machine: SavedPeerMachine,\n action:\n | \"probe\"\n | \"accept\"\n | \"status\"\n | \"poll\"\n | \"ack\"\n | \"finalize\"\n | \"recover\"\n | \"recover-recipient\",\n input?: string,\n signal?: AbortSignal,\n): Promise<string> {\n const target = parsePeerSshTarget(machine.target);\n const args = [\n \"-T\",\n \"-o\",\n \"BatchMode=yes\",\n \"-o\",\n \"StrictHostKeyChecking=yes\",\n \"-o\",\n \"ConnectTimeout=10\",\n ...(target.port ? [\"-p\", target.port] : []),\n target.host,\n `pi-herdsman-peer ${action}`,\n ];\n return run(\"ssh\", args, input, signal);\n}\n\nexport async function tryPollPeerReplies(\n poll: () => Promise<string>,\n): Promise<string | undefined> {\n try {\n return await poll();\n } catch {\n return undefined;\n }\n}\n\nexport async function probePeerEndpoint(\n machine: SavedPeerMachine,\n signal?: AbortSignal,\n): Promise<RemotePeerSnapshot> {\n const output = await runPeerEndpoint(machine, \"probe\", undefined, signal);\n const probe: unknown = JSON.parse(output);\n if (\n !probe ||\n typeof probe !== \"object\" ||\n typeof (probe as { dataRoot?: unknown }).dataRoot !== \"string\" ||\n !Array.isArray((probe as { peers?: unknown }).peers)\n )\n throw new Error(\"Peer endpoint returned invalid probe data\");\n const snapshot = probe as RemotePeerSnapshot;\n if (\n snapshot.peers.some(\n (peer) =>\n !peer ||\n typeof peer !== \"object\" ||\n typeof peer.piSessionId !== \"string\" ||\n peer.piSessionId.length === 0 ||\n !peer.claim ||\n typeof peer.claim.id !== \"string\" ||\n peer.claim.id.length === 0 ||\n (peer.role !== \"manager\" && peer.role !== \"lead\") ||\n (peer.role === \"lead\" &&\n peer.sessionKind !== \"ordinary\" &&\n peer.sessionKind !== \"managed\"),\n ) ||\n (snapshot.ordinaryLeadsComplete !== undefined &&\n typeof snapshot.ordinaryLeadsComplete !== \"boolean\")\n )\n throw new Error(\"Peer endpoint returned invalid probe data\");\n return snapshot;\n}\n", "export type PeerAcceptanceCutPoint =\n \"pending-marker-durable\" | \"inbox-publication-durable\";\n\nlet testHook: ((cutPoint: PeerAcceptanceCutPoint) => void) | undefined;\nlet pendingMarkerTempWriteHook: (() => void) | undefined;\nlet pendingMarkerWriteLimitHook: ((requested: number) => number) | undefined;\nlet pendingMarkerPublishHook:\n ((marker: string, content: string) => void) | undefined;\nlet acceptedMarkerTempWriteHook:\n ((temporary: string, marker: string) => void) | undefined;\n\nexport function afterDurablePeerAcceptanceStep(\n cutPoint: PeerAcceptanceCutPoint,\n): void {\n testHook?.(cutPoint);\n}\n\n/** Internal dependency seam used only by child-process crash regression tests. */\nexport function setPeerAcceptanceFaultHookForTests(\n hook: (cutPoint: PeerAcceptanceCutPoint) => void,\n): void {\n testHook = hook;\n}\n\nexport function afterPendingMarkerTempWriteForTests(): void {\n pendingMarkerTempWriteHook?.();\n}\n\nexport function setPendingMarkerTempWriteHookForTests(hook: () => void): void {\n pendingMarkerTempWriteHook = hook;\n}\n\nexport function pendingMarkerWriteLimitForTests(requested: number): number {\n return pendingMarkerWriteLimitHook?.(requested) ?? requested;\n}\n\nexport function setPendingMarkerWriteLimitForTests(\n hook: (requested: number) => number,\n): void {\n pendingMarkerWriteLimitHook = hook;\n}\n\nexport function beforePendingMarkerPublishForTests(\n marker: string,\n content: string,\n): void {\n pendingMarkerPublishHook?.(marker, content);\n}\n\nexport function setPendingMarkerPublishHookForTests(\n hook: (marker: string, content: string) => void,\n): void {\n pendingMarkerPublishHook = hook;\n}\n\nexport function afterAcceptedMarkerTempWriteForTests(\n temporary: string,\n marker: string,\n): void {\n acceptedMarkerTempWriteHook?.(temporary, marker);\n}\n\nexport function setAcceptedMarkerTempWriteHookForTests(\n hook: (temporary: string, marker: string) => void,\n): void {\n acceptedMarkerTempWriteHook = hook;\n}\n"],
|
|
5
|
-
"mappings": "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",
|
|
6
|
-
"names": ["createHash", "randomUUID", "closeSync", "fsyncSync", "mkdirSync", "openSync", "readFileSync", "renameSync", "rmSync", "writeSync", "writeFileSync", "basename", "dirname", "isAbsolute", "join", "fileURLToPath", "isDeepStrictEqual", "
|
|
3
|
+
"sources": ["../bin/peer-bridge.ts", "../extension/compatibility.ts", "../extension/storage.ts", "../extension/lock.ts", "../extension/supervision.ts", "../extension/peer-correspondence.ts", "../extension/peer-transport.ts", "../bin/peer-bridge-fault-seam.ts"],
|
|
4
|
+
"sourcesContent": ["#!/usr/bin/env node\nimport { createHash, randomUUID } from \"node:crypto\";\nimport {\n closeSync,\n fsyncSync,\n linkSync,\n mkdirSync,\n openSync,\n readFileSync,\n renameSync,\n rmSync,\n writeSync,\n writeFileSync,\n} from \"node:fs\";\nimport { basename, dirname, isAbsolute, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport {\n isRuntimeBuild,\n runtimeBuild,\n sameRuntimeBuild,\n} from \"../extension/compatibility.ts\";\nimport { nodeOnlyAgentDir, herdsmanDataRoot } from \"../extension/storage.ts\";\nimport {\n listPeerLeadRecords,\n globalProjectAssignmentSnapshot,\n isRemoteOrdinaryLead,\n withProjectAssignmentAuthority,\n peerRuntime,\n chiefMessagePath,\n coordinationMessageDigest,\n hasPeerDeliveryReceipt,\n readCoordinationMessage,\n writeCoordinationMessage,\n} from \"../extension/supervision.ts\";\nimport {\n persistPeerAttachment,\n persistPeerResultArtifact,\n peerAttachmentPath,\n isCanonicalResultRef,\n resultPath,\n} from \"../extension/storage.ts\";\nimport {\n assertPeerDataRoot,\n acknowledgePeerReply,\n finalizePeerCorrespondence,\n peerPayloadDigest,\n pollPeerReplies,\n storePeerCorrespondence,\n verifyPeerCorrespondence,\n readPeerCorrespondence,\n updatePeerOriginGeneration,\n updatePeerRecipientGeneration,\n type PeerCorrespondence,\n} from \"../extension/peer-correspondence.ts\";\nimport { PEER_TRANSPORT_FRAME_LIMIT_BYTES } from \"../extension/peer-transport.ts\";\nimport {\n afterDurablePeerAcceptanceStep,\n afterPendingMarkerTempWriteForTests,\n beforePendingMarkerPublishForTests,\n pendingMarkerWriteLimitForTests,\n afterAcceptedMarkerTempWriteForTests,\n} from \"./peer-bridge-fault-seam.ts\";\n\nlet action = process.argv[2];\nif (\n ![\n \"probe\",\n \"accept\",\n \"poll\",\n \"ack\",\n \"finalize\",\n \"recover\",\n \"recover-recipient\",\n \"status\",\n ].includes(action) ||\n process.argv.length !== 3\n) {\n console.error(\n \"usage: pi-herdsman-peer probe|accept|status|poll|ack|finalize|recover|recover-recipient\",\n );\n process.exit(2);\n}\n\nconst agentDir = nodeOnlyAgentDir();\nif (!isAbsolute(agentDir)) {\n console.error(\n \"PI_CODING_AGENT_DIR must resolve to an absolute path for remote probing\",\n );\n process.exit(1);\n}\n\nconst runtime = peerRuntime();\nconst bridgeDirectory = dirname(fileURLToPath(import.meta.url));\nconst packageRoot = dirname(bridgeDirectory);\nconst compatible = (peer: { build?: unknown }): boolean => {\n try {\n const metadata = JSON.parse(\n readFileSync(join(packageRoot, \"package.json\"), \"utf8\"),\n );\n const build = runtimeBuild(\n metadata.version,\n basename(bridgeDirectory) === \"bin\"\n ? join(packageRoot, \"extension\", \"index.ts\")\n : join(packageRoot, \"dist\", \"index.js\"),\n );\n return (\n isRuntimeBuild(build) &&\n isRuntimeBuild(peer.build) &&\n sameRuntimeBuild(build, peer.build)\n );\n } catch {\n return false;\n }\n};\nlet recoveringStatus = false;\nconst syncDirectory = (directory: string): void => {\n if (process.platform === \"win32\") return;\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n};\nif (action === \"probe\") {\n const peers = listPeerLeadRecords(runtime);\n let ordinaryLeadsComplete = true;\n let eligibleLeads: typeof peers = [];\n try {\n const assignments = globalProjectAssignmentSnapshot();\n eligibleLeads = peers.filter((peer) =>\n isRemoteOrdinaryLead(peer, assignments),\n );\n } catch {\n ordinaryLeadsComplete = false;\n }\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n peers: [\n ...peers.filter((peer) => peer.role === \"manager\"),\n ...eligibleLeads,\n ],\n ordinaryLeadsComplete,\n }),\n );\n} else {\n const chunks: Buffer[] = [];\n let bytes = 0;\n for await (const chunk of process.stdin) {\n const buffer = Buffer.from(chunk);\n bytes += buffer.length;\n if (bytes > PEER_TRANSPORT_FRAME_LIMIT_BYTES)\n throw new Error(\"peer transfer exceeds the size limit\");\n chunks.push(buffer);\n }\n let envelope = JSON.parse(Buffer.concat(chunks).toString(\"utf8\")) as {\n record?: Record<string, any>;\n recipientClaimId?: unknown;\n attachments?: Array<{\n name?: unknown;\n ref?: unknown;\n marker?: unknown;\n text?: unknown;\n sha256?: unknown;\n }>;\n correspondence?: PeerCorrespondence;\n id?: string;\n expectedDataRoot?: string;\n capability?: string;\n originSession?: string;\n originGeneration?: string;\n recipientSession?: string;\n recipientGeneration?: string;\n previousOriginGeneration?: string;\n newRecipientGeneration?: string;\n replyId?: string;\n digest?: string;\n };\n if (action === \"status\") {\n const { id, originSession, recipientSession, digest, expectedDataRoot } =\n envelope;\n assertPeerDataRoot(herdsmanDataRoot(), expectedDataRoot ?? \"\");\n if (\n !process.env.SSH_CONNECTION ||\n typeof id !== \"string\" ||\n typeof originSession !== \"string\" ||\n typeof recipientSession !== \"string\" ||\n typeof digest !== \"string\" ||\n !/^[0-9a-f]{64}$/u.test(digest)\n )\n throw new Error(\"invalid peer acceptance status request\");\n const key = createHash(\"sha256\")\n .update(`${originSession}\\0${id}`)\n .digest(\"hex\");\n const marker = join(runtime.root, \"peer-acceptances\", `${key}.json`);\n try {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n status?: unknown;\n recipientSession?: unknown;\n transfer?: typeof envelope;\n };\n const status =\n prior.digest !== digest || prior.recipientSession !== recipientSession\n ? \"conflict\"\n : prior.status === \"accepted\"\n ? \"accepted\"\n : prior.status === \"pending\"\n ? \"pending\"\n : \"conflict\";\n if (status === \"pending\" && prior.transfer) {\n envelope = prior.transfer;\n action = \"accept\";\n recoveringStatus = true;\n } else {\n console.log(\n JSON.stringify({ dataRoot: herdsmanDataRoot(), id, digest, status }),\n );\n process.exit(0);\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n id,\n digest,\n status: \"absent\",\n }),\n );\n }\n if (action === \"status\") process.exit(0);\n }\n if (action !== \"accept\") {\n const {\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n previousOriginGeneration,\n } = envelope;\n if (\n typeof id !== \"string\" ||\n typeof capability !== \"string\" ||\n typeof originSession !== \"string\" ||\n typeof originGeneration !== \"string\" ||\n typeof recipientSession !== \"string\" ||\n typeof recipientGeneration !== \"string\"\n )\n throw new Error(\"invalid peer correspondence request\");\n assertPeerDataRoot(herdsmanDataRoot(), envelope.expectedDataRoot ?? \"\");\n const liveRecipientGeneration =\n action === \"recover-recipient\"\n ? envelope.newRecipientGeneration\n : recipientGeneration;\n const runCorrespondenceOperation = (\n assignments?: Map<\n string,\n import(\"../extension/supervision.ts\").GlobalProjectAssignment[]\n >,\n ) => {\n const correspondence = readPeerCorrespondence(id);\n const correspondenceRole = correspondence?.role ?? \"manager\";\n const live = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === recipientSession &&\n peer.claim.id === liveRecipientGeneration,\n );\n const recipientIsLive =\n !!live &&\n (correspondenceRole === \"manager\"\n ? live.role === \"manager\"\n : correspondenceRole === \"lead\" &&\n !!assignments &&\n isRemoteOrdinaryLead(live, assignments));\n if (\n !recipientIsLive ||\n (action !== \"poll\" && !compatible(live!)) ||\n !correspondence ||\n correspondenceRole !== (correspondence?.role ?? \"manager\") ||\n correspondence.originSession !== originSession ||\n correspondence.recipientSession !== recipientSession ||\n correspondence.capability !== capability\n )\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (action === \"recover\") {\n if (typeof previousOriginGeneration !== \"string\")\n throw new Error(\"invalid peer correspondence recovery\");\n updatePeerOriginGeneration(\n id,\n capability,\n originSession,\n previousOriginGeneration,\n originGeneration,\n );\n console.log(JSON.stringify({ recovered: true, id }));\n } else if (action === \"recover-recipient\") {\n if (typeof envelope.newRecipientGeneration !== \"string\")\n throw new Error(\"invalid peer recipient recovery\");\n updatePeerRecipientGeneration(\n id,\n capability,\n recipientSession,\n recipientGeneration,\n envelope.newRecipientGeneration,\n );\n console.log(JSON.stringify({ recovered: true, id }));\n } else if (action === \"poll\") {\n let replies: ReturnType<typeof pollPeerReplies>;\n try {\n replies = pollPeerReplies(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n } catch (error) {\n const detail = error instanceof Error ? error.message : String(error);\n console.error(\n JSON.stringify({\n action: \"poll\",\n correspondenceId: id,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n expectedDataRoot: envelope.expectedDataRoot,\n error: detail,\n }),\n );\n process.exit(1);\n }\n console.log(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies,\n hasReplies: (readPeerCorrespondence(id)?.replies.length ?? 0) > 0,\n }),\n );\n } else if (action === \"ack\") {\n if (typeof envelope.replyId !== \"string\")\n throw new Error(\"invalid reply acknowledgement\");\n acknowledgePeerReply(\n id,\n capability,\n envelope.replyId,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n console.log(\n JSON.stringify({ acknowledged: true, replyId: envelope.replyId }),\n );\n } else {\n finalizePeerCorrespondence(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n console.log(JSON.stringify({ finalized: true, id }));\n }\n };\n // Keep the live Lead check and every synchronous correspondence mutation/read\n // under the assignment authority lock; otherwise eligibility can be revoked\n // after the check but before an ACK discards the durable reply.\n const role = readPeerCorrespondence(id)?.role ?? \"manager\";\n if (role === \"lead\") {\n withProjectAssignmentAuthority((assignments) =>\n runCorrespondenceOperation(assignments),\n );\n } else {\n runCorrespondenceOperation();\n }\n process.exit(0);\n }\n const record = envelope.record;\n assertPeerDataRoot(herdsmanDataRoot(), envelope.expectedDataRoot ?? \"\");\n if (\n !record ||\n record.kind !== \"peer_message\" ||\n !record.peerSource ||\n typeof record.id !== \"string\" ||\n typeof record.fromSessionId !== \"string\" ||\n typeof record.toSessionId !== \"string\"\n )\n throw new Error(\"invalid peer transfer\");\n const correspondenceRole = envelope.correspondence?.role ?? \"manager\";\n const remoteOrdinarySource =\n record.peerSource.role === \"lead\" &&\n record.peerSource.remoteOrdinary === true &&\n Object.keys(record.peerSource).length === 2;\n if (\n (correspondenceRole !== \"manager\" && correspondenceRole !== \"lead\") ||\n (correspondenceRole === \"manager\" &&\n record.peerSource.role !== \"manager\") ||\n (correspondenceRole === \"lead\" && !remoteOrdinarySource)\n )\n throw new Error(\"peer source role does not match correspondence role\");\n if (!Array.isArray(envelope.attachments) || envelope.attachments.length > 32)\n throw new Error(\"invalid peer transfer evidence\");\n const connection = process.env.SSH_CONNECTION;\n if (!connection)\n throw new Error(\"authenticated SSH connection identity is unavailable\");\n if (\n !envelope.correspondence ||\n envelope.correspondence.recipientSession !== record.toSessionId ||\n envelope.correspondence.recipientGeneration !== envelope.recipientClaimId ||\n envelope.correspondence.originSession !== record.fromSessionId ||\n envelope.correspondence.originGeneration !== record.leaseId\n )\n throw new Error(\"peer correspondence does not match message route\");\n const digest = peerPayloadDigest({\n record,\n attachments: envelope.attachments,\n });\n const markerDir = join(runtime.root, \"peer-acceptances\");\n const key = createHash(\"sha256\")\n .update(`${record.fromSessionId}\\0${record.id}`)\n .digest(\"hex\");\n const marker = join(markerDir, `${key}.json`);\n let acceptedRace = false;\n try {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n status?: unknown;\n recipientSession?: unknown;\n transfer?: typeof envelope;\n };\n if (\n prior.digest !== digest ||\n prior.recipientSession !== record.toSessionId\n )\n throw new Error(\"conflicting peer message identity\");\n if (prior.status === \"accepted\") {\n console.log(JSON.stringify({ accepted: true, id: record.id }));\n process.exit(0);\n }\n if (prior.status !== \"pending\" || !prior.transfer)\n throw new Error(\"invalid pending peer message acceptance\");\n if (\n prior.transfer.record?.id !== record.id ||\n prior.transfer.record?.fromSessionId !== record.fromSessionId ||\n prior.transfer.record?.toSessionId !== record.toSessionId ||\n (prior.transfer.correspondence?.role ?? \"manager\") !==\n correspondenceRole ||\n peerPayloadDigest({\n record: prior.transfer.record,\n attachments: prior.transfer.attachments ?? [],\n }) !== prior.digest\n )\n throw new Error(\"invalid pending peer message transfer\");\n envelope = prior.transfer;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n const liveRecipient = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n const authorized =\n liveRecipient &&\n (correspondenceRole === \"manager\"\n ? liveRecipient.role === \"manager\"\n : withProjectAssignmentAuthority((assignments) =>\n isRemoteOrdinaryLead(liveRecipient, assignments),\n ));\n if (!authorized || !compatible(liveRecipient))\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n mkdirSync(markerDir, { recursive: true, mode: 0o700 });\n syncDirectory(runtime.root);\n const content = `${JSON.stringify({ connection, digest, status: \"pending\", recipientSession: record.toSessionId, transfer: envelope })}\\n`;\n const temp = `${marker}.${randomUUID()}.tmp`;\n let fd: number | undefined;\n try {\n fd = openSync(temp, \"wx\", 0o600);\n const bytes = Buffer.from(content, \"utf8\");\n let offset = 0;\n while (offset < bytes.length) {\n const requested = bytes.length - offset;\n const length = pendingMarkerWriteLimitForTests(requested);\n if (!Number.isInteger(length) || length <= 0 || length > requested)\n throw new Error(\"invalid pending peer acceptance write length\");\n const written = writeSync(fd, bytes, offset, length);\n if (\n !Number.isInteger(written) ||\n written <= 0 ||\n written > bytes.length - offset\n )\n throw new Error(\n \"unable to write complete pending peer acceptance marker\",\n );\n offset += written;\n afterPendingMarkerTempWriteForTests();\n }\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n beforePendingMarkerPublishForTests(marker, content);\n let alreadyExists = false;\n try {\n linkSync(temp, marker);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n alreadyExists = true;\n }\n syncDirectory(markerDir);\n if (alreadyExists) {\n const prior = JSON.parse(readFileSync(marker, \"utf8\")) as {\n digest?: unknown;\n recipientSession?: unknown;\n status?: unknown;\n transfer?: typeof envelope;\n };\n if (\n prior.digest !== digest ||\n prior.recipientSession !== record.toSessionId\n )\n throw new Error(\"conflicting peer message identity\");\n if (prior.status === \"accepted\") acceptedRace = true;\n else if (\n prior.status !== \"pending\" ||\n !prior.transfer ||\n prior.transfer.record?.id !== record.id ||\n prior.transfer.record?.fromSessionId !== record.fromSessionId ||\n prior.transfer.record?.toSessionId !== record.toSessionId ||\n (prior.transfer.correspondence?.role ?? \"manager\") !==\n correspondenceRole ||\n peerPayloadDigest({\n record: prior.transfer.record,\n attachments: prior.transfer.attachments ?? [],\n }) !== prior.digest\n )\n throw new Error(\"invalid pending peer message acceptance\");\n else envelope = prior.transfer;\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n rmSync(temp, { force: true });\n }\n if (!acceptedRace) afterDurablePeerAcceptanceStep(\"pending-marker-durable\");\n }\n acceptTransfer: {\n if (acceptedRace) {\n console.log(JSON.stringify({ accepted: true, id: record.id }));\n break acceptTransfer;\n }\n if (\n !envelope.correspondence ||\n envelope.correspondence.recipientSession !== record.toSessionId ||\n envelope.correspondence.recipientGeneration !==\n envelope.recipientClaimId ||\n envelope.correspondence.originSession !== record.fromSessionId ||\n envelope.correspondence.originGeneration !== record.leaseId\n )\n throw new Error(\"peer correspondence does not match message route\");\n const receivedRefs: string[] = [];\n let receivedText = record.text as string;\n for (const attachment of envelope.attachments) {\n if (\n typeof attachment.name !== \"string\" ||\n typeof attachment.marker !== \"string\" ||\n typeof attachment.text !== \"string\" ||\n typeof attachment.sha256 !== \"string\" ||\n !/^[0-9a-f]{64}$/u.test(attachment.sha256)\n )\n throw new Error(\"invalid peer attachment metadata\");\n const contentDigest = createHash(\"sha256\")\n .update(attachment.text, \"utf8\")\n .digest(\"hex\");\n if (contentDigest !== attachment.sha256)\n throw new Error(\"peer attachment integrity check failed\");\n const markerIndex = receivedText.indexOf(attachment.marker);\n if (\n markerIndex < 0 ||\n receivedText.indexOf(attachment.marker, markerIndex + 1) !== -1\n )\n throw new Error(\"peer attachment marker is missing or ambiguous\");\n receivedText =\n receivedText.slice(0, markerIndex) +\n attachment.text +\n receivedText.slice(markerIndex + attachment.marker.length);\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n if (binding && !isCanonicalResultRef(binding.canonicalRef))\n throw new Error(\"invalid peer result artifact\");\n const path = binding\n ? resultPath(binding.canonicalRef.slice(\"result:\".length))\n : peerAttachmentPath(attachment.name, attachment.text);\n receivedRefs.push(\n `${attachment.name}: ${binding ? `${binding.ref} (canonical ${binding.canonicalRef})` : path}`,\n );\n }\n const acceptedRecord = {\n ...record,\n ...(receivedRefs.length\n ? {\n text: `${receivedText}\\n\\nForwardable received files:\\n${receivedRefs.join(\"\\n\")}`,\n }\n : { text: receivedText }),\n };\n const accepted = acceptedRecord as never;\n let published = false;\n try {\n const existing = readCoordinationMessage(\n chiefMessagePath(runtime, record.toSessionId, record.id),\n );\n if (!isDeepStrictEqual(existing, accepted))\n throw new Error(\"conflicting peer inbox message identity\");\n published = true;\n } catch (error) {\n const cause = error instanceof Error ? error.cause : undefined;\n if ((cause as NodeJS.ErrnoException | undefined)?.code !== \"ENOENT\")\n throw error;\n }\n const acceptedDigest = coordinationMessageDigest(accepted);\n if (\n !published &&\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n published = true;\n if (!published) {\n const liveRecipient = listPeerLeadRecords(runtime).find(\n (peer) => peer.piSessionId === record.toSessionId,\n );\n if (!liveRecipient || !compatible(liveRecipient))\n throw new Error(\n correspondenceRole === \"manager\"\n ? \"exact destination Manager is not live\"\n : \"exact correspondence recipient is not live\",\n );\n if (liveRecipient.claim.id !== envelope.recipientClaimId) {\n envelope = {\n ...envelope,\n recipientClaimId: liveRecipient.claim.id,\n correspondence: {\n ...envelope.correspondence,\n recipientGeneration: liveRecipient.claim.id,\n },\n };\n const pendingTemp = `${marker}.${randomUUID()}.tmp`;\n try {\n writeFileSync(\n pendingTemp,\n `${JSON.stringify({ connection, digest, status: \"pending\", recipientSession: record.toSessionId, transfer: envelope })}\\n`,\n { encoding: \"utf8\", flag: \"wx\", mode: 0o600, flush: true },\n );\n renameSync(pendingTemp, marker);\n } finally {\n rmSync(pendingTemp, { force: true });\n }\n syncDirectory(markerDir);\n }\n for (const attachment of envelope.attachments) {\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n if (binding)\n persistPeerResultArtifact(\n binding.canonicalRef,\n attachment.text as string,\n );\n else\n persistPeerAttachment(\n attachment.name as string,\n attachment.text as string,\n );\n }\n } else {\n for (const attachment of envelope.attachments) {\n const binding = record.resultBindings?.find(\n (item: { ref?: unknown }) => item.ref === attachment.ref,\n );\n const path = binding\n ? resultPath(binding.canonicalRef.slice(\"result:\".length))\n : peerAttachmentPath(\n attachment.name as string,\n attachment.text as string,\n );\n if (\n !readFileSync(path).equals(\n Buffer.from(attachment.text as string, \"utf8\"),\n )\n )\n throw new Error(\"peer attachment content identity collision\");\n }\n verifyPeerCorrespondence(envelope.correspondence!);\n }\n const publish = () => {\n if (published && correspondenceRole === \"manager\") {\n return;\n }\n const current = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n const authorized =\n current &&\n (correspondenceRole === \"manager\"\n ? current.role === \"manager\"\n : isRemoteOrdinaryLead(current, globalProjectAssignmentSnapshot()));\n if (!authorized || (!published && !compatible(current)))\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (!published) {\n if (\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n verifyPeerCorrespondence(envelope.correspondence!);\n else {\n storePeerCorrespondence(envelope.correspondence!);\n writeCoordinationMessage(accepted, runtime);\n }\n }\n };\n if (correspondenceRole === \"lead\") {\n withProjectAssignmentAuthority((assignments) => {\n const current = listPeerLeadRecords(runtime).find(\n (peer) =>\n peer.piSessionId === record.toSessionId &&\n peer.claim.id === envelope.recipientClaimId,\n );\n if (\n !current ||\n !isRemoteOrdinaryLead(current, assignments) ||\n (!published && !compatible(current))\n )\n throw new Error(\n \"exact correspondence recipient is not live or authorized\",\n );\n if (!published) {\n if (\n hasPeerDeliveryReceipt(\n runtime,\n record.toSessionId,\n record.id,\n acceptedDigest,\n )\n )\n verifyPeerCorrespondence(envelope.correspondence!);\n else {\n storePeerCorrespondence(envelope.correspondence!);\n writeCoordinationMessage(accepted, runtime);\n }\n }\n });\n } else publish();\n if (!published) afterDurablePeerAcceptanceStep(\"inbox-publication-durable\");\n const markerTemp = `${marker}.${randomUUID()}.tmp`;\n try {\n writeFileSync(\n markerTemp,\n `${JSON.stringify({ connection, digest, status: \"accepted\", recipientSession: record.toSessionId })}\\n`,\n {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n },\n );\n afterAcceptedMarkerTempWriteForTests(markerTemp, marker);\n renameSync(markerTemp, marker);\n } finally {\n rmSync(markerTemp, { force: true });\n }\n syncDirectory(markerDir);\n console.log(\n JSON.stringify(\n recoveringStatus\n ? {\n dataRoot: herdsmanDataRoot(),\n id: record.id,\n digest,\n status: \"accepted\",\n }\n : { accepted: true, id: record.id },\n ),\n );\n }\n}\n", "import { createHash } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport { fail } from \"./errors.ts\";\n\nconst SHA256 = /^[0-9a-f]{64}$/;\n\nexport type RuntimeBuild = Readonly<{\n version: string;\n sha256: string;\n}>;\n\nexport function runtimeBuild(version: string, path: string): RuntimeBuild {\n return Object.freeze({\n version,\n sha256: createHash(\"sha256\").update(readFileSync(path)).digest(\"hex\"),\n });\n}\n\nexport function isRuntimeBuild(value: unknown): value is RuntimeBuild {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\n const record = value as Record<string, unknown>;\n return (\n Object.keys(record).length === 2 &&\n typeof record.version === \"string\" &&\n record.version.length > 0 &&\n record.version.length <= 128 &&\n typeof record.sha256 === \"string\" &&\n SHA256.test(record.sha256)\n );\n}\n\nexport function sameRuntimeBuild(\n left: RuntimeBuild,\n right: RuntimeBuild,\n): boolean {\n return left.version === right.version && left.sha256 === right.sha256;\n}\n\nexport function formatRuntimeBuild(build: RuntimeBuild): string {\n return `v${build.version} \u00B7 ${build.sha256.slice(0, 12)}`;\n}\n\nexport function requireCompatibleBuild(\n local: RuntimeBuild,\n remote: RuntimeBuild | undefined,\n operation: string,\n target: string,\n): asserts remote is RuntimeBuild {\n if (remote && sameRuntimeBuild(local, remote)) return;\n\n fail(\n \"incompatible_build\",\n remote\n ? `Pi Herdsman build mismatch for ${target}: local ${formatRuntimeBuild(local)}, target ${formatRuntimeBuild(remote)}.`\n : `Cannot establish Pi Herdsman build compatibility for ${target}; the target predates the current runtime identity contract.`,\n operation,\n {\n nextAction: remote\n ? \"Restart the Pi session that remained running across the Herdsman update. If uncertain, restart this session and any still-running target session, then retry.\"\n : `Restart ${target} so it reloads the current Pi Herdsman build.`,\n details: { localBuild: local, remoteBuild: remote ?? null },\n },\n );\n}\n", "import type { Dirent } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport {\n chmodSync,\n closeSync,\n constants,\n fstatSync,\n fsyncSync,\n mkdirSync,\n openSync,\n readdirSync,\n readFileSync,\n renameSync,\n lstatSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { acquireProcessLock } from \"./lock.ts\";\n\nconst RESULT_PREFIX = \"result:\";\nconst RESULT_ID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\nconst SEMANTIC_RESULT_REF = /^result:([a-z][a-z0-9_-]{0,31})#([1-9][0-9]*)$/;\nconst SEMANTIC_EVIDENCE_REF =\n /^evidence:([a-z][a-z0-9_-]{0,31})#([1-9][0-9]*)$/;\nconst INCIDENTAL_METADATA = new Set([\n \".ds_store\",\n \"desktop.ini\",\n \"thumbs.db\",\n \".directory\",\n]);\n\nexport function isIncidentalMetadata(entry: Dirent): boolean {\n return entry.isFile() && INCIDENTAL_METADATA.has(entry.name.toLowerCase());\n}\n\nexport type ResultBinding = Readonly<{\n ref: string;\n canonicalRef: string;\n}>;\n\nexport type RequiredEvidence = Readonly<\n | {\n id: string;\n ref?: string;\n name: string;\n sourceAssignmentId: string;\n path: string;\n sha256: string;\n }\n | { id: string; name: string; result: ResultBinding }\n>;\n\nconst EVIDENCE_ID = RESULT_ID;\nconst EVIDENCE_SNAPSHOT_MAX_BYTES = 1024 * 1024;\n\nexport function isRequiredEvidence(value: unknown): value is RequiredEvidence {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n if (\n typeof r.id !== \"string\" ||\n !EVIDENCE_ID.test(r.id) ||\n typeof r.name !== \"string\" ||\n !r.name ||\n r.name.length > 255\n )\n return false;\n if (Object.hasOwn(r, \"result\"))\n return Object.keys(r).length === 3 && isResultBinding(r.result);\n const keys = Object.keys(r).sort();\n const legacyKeys = [\"id\", \"name\", \"path\", \"sha256\", \"sourceAssignmentId\"];\n const semanticKeys = [...legacyKeys, \"ref\"].sort();\n return (\n (keys.join(\"\\0\") === legacyKeys.join(\"\\0\") ||\n keys.join(\"\\0\") === semanticKeys.join(\"\\0\")) &&\n (!Object.hasOwn(r, \"ref\") || isCanonicalSemanticEvidenceRef(r.ref)) &&\n typeof r.sourceAssignmentId === \"string\" &&\n EVIDENCE_ID.test(r.sourceAssignmentId) &&\n typeof r.path === \"string\" &&\n r.path.length > 0 &&\n typeof r.sha256 === \"string\" &&\n /^[a-f0-9]{64}$/.test(r.sha256)\n );\n}\n\nexport function isCanonicalSemanticEvidenceRef(\n value: unknown,\n): value is string {\n if (typeof value !== \"string\") return false;\n const match = SEMANTIC_EVIDENCE_REF.exec(value);\n return !!match && Number.isSafeInteger(Number(match[2]));\n}\n\n/** Existing result identities remain unchanged; legacy snapshots must be upgraded before display. */\nexport function semanticEvidenceRef(evidence: RequiredEvidence): string {\n if (\"result\" in evidence) return evidence.result.ref;\n if (!evidence.ref)\n throw new Error(\"required evidence has no semantic reference\");\n return evidence.ref;\n}\n\n/** Lazily gives pre-reference snapshots one durable identity without changing snapshot provenance. */\nexport function upgradeRequiredEvidence(value: unknown): RequiredEvidence {\n if (!isRequiredEvidence(value)) throw new Error(\"invalid required evidence\");\n if (\"result\" in value || value.ref) return value;\n const ref = reserveSemanticEvidenceRef(value.id, value.name);\n return { ...value, ref };\n}\n\n/** Checks an existing snapshot identity without allocating or repairing it. */\nexport function verifySemanticEvidenceReservation(\n evidenceId: string,\n ref: string,\n): void {\n if (!EVIDENCE_ID.test(evidenceId) || !isCanonicalSemanticEvidenceRef(ref))\n throw new Error(\"invalid semantic evidence reservation\");\n const match = SEMANTIC_EVIDENCE_REF.exec(ref)!;\n const root = join(herdsmanDataRoot(), \"evidence-ref-reservations\");\n const paths = [\n join(root, \"by-id\", evidenceId),\n join(root, \"refs\", match[1]!, match[2]!),\n ];\n const contents = paths.map((path) => {\n const stat = lstatSync(path);\n if (!stat.isFile() || stat.isSymbolicLink())\n throw new Error(\"invalid semantic evidence reservation\");\n return readFileSync(path, \"utf8\");\n });\n const [byId, byRef] = contents;\n if (byId !== `${ref}\\n` || byRef !== `${evidenceId}\\n`)\n throw new Error(\"invalid semantic evidence reservation\");\n}\n\n/** Upgrades legacy snapshots first, then verifies the durable identity. */\nexport function upgradeAndVerifyRequiredEvidence(\n value: unknown,\n): RequiredEvidence {\n const evidence = upgradeRequiredEvidence(value);\n if (!(\"result\" in evidence))\n verifySemanticEvidenceReservation(evidence.id, evidence.ref!);\n return evidence;\n}\n\nexport function requiredEvidenceDirectory(assignmentId: string): string {\n if (!EVIDENCE_ID.test(assignmentId))\n throw new Error(\"invalid evidence assignment id\");\n return join(herdsmanDataRoot(), \"evidence\", assignmentId);\n}\n\nfunction assertEvidenceDirectory(\n assignmentId: string,\n create: boolean,\n): string {\n const directory = requiredEvidenceDirectory(assignmentId);\n const paths = [\n herdsmanDataRoot(),\n join(herdsmanDataRoot(), \"evidence\"),\n directory,\n ];\n for (const path of paths) {\n if (create) {\n try {\n mkdirSync(path, { mode: 0o700 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n }\n const stat = lstatSync(path);\n if (!stat.isDirectory() || stat.isSymbolicLink())\n throw new Error(\"required evidence directory is unsafe\");\n }\n return directory;\n}\n\nfunction safeEvidenceName(name: string): string {\n const base = basename(name)\n .replace(/[^A-Za-z0-9._-]/g, \"_\")\n .slice(0, 100);\n return base || \"evidence.txt\";\n}\n\n/** Persist validated UTF-8 text under private storage; returns its immutable identity. */\nexport function persistRequiredEvidenceSnapshot(\n assignmentId: string,\n name: string,\n text: string,\n): RequiredEvidence {\n const bytes = Buffer.from(text, \"utf8\");\n if (\n bytes.length > EVIDENCE_SNAPSHOT_MAX_BYTES ||\n bytes.includes(0) ||\n new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes) !== text\n )\n throw new Error(\n \"Required evidence must be supported UTF-8 text no larger than 1 MiB\",\n );\n const directory = assertEvidenceDirectory(assignmentId, true);\n chmodSync(directory, 0o700);\n const id = randomUUID();\n const path = join(directory, `${id}-${safeEvidenceName(name)}`);\n const temporary = `${path}.${randomUUID()}.tmp`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, bytes);\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n assertEvidenceDirectory(assignmentId, false);\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n if (process.platform !== \"win32\") {\n const dirFd = openSync(directory, \"r\");\n try {\n fsyncSync(dirFd);\n } finally {\n closeSync(dirFd);\n }\n }\n return {\n id,\n ref: reserveSemanticEvidenceRef(id, name),\n name: safeEvidenceName(name),\n sourceAssignmentId: assignmentId,\n path,\n sha256: createHash(\"sha256\").update(bytes).digest(\"hex\"),\n };\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function reserveSemanticEvidenceRef(\n evidenceId: string,\n name: string,\n): string {\n if (!EVIDENCE_ID.test(evidenceId)) throw new Error(\"invalid evidence id\");\n const root = join(herdsmanDataRoot(), \"evidence-ref-reservations\");\n const byId = join(root, \"by-id\");\n mkdirSync(byId, { recursive: true, mode: 0o700 });\n chmodSync(byId, 0o700);\n const mapping = join(byId, evidenceId);\n try {\n const existing = readFileSync(mapping, \"utf8\").trim();\n if (isCanonicalSemanticEvidenceRef(existing)) return existing;\n throw new Error(\"invalid semantic evidence reservation\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n\n const label =\n safeEvidenceName(name)\n .replace(/\\.[^.]*$/, \"\")\n .toLowerCase()\n .replace(/[^a-z0-9_-]+/g, \"-\")\n .replace(/^[^a-z]+/, \"\")\n .slice(0, 32) || \"evidence\";\n const directory = join(root, \"refs\", label);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n let index = 1;\n for (const entry of readdirSync(directory)) {\n if (/^[1-9][0-9]*$/.test(entry)) index = Math.max(index, Number(entry) + 1);\n }\n for (;;) {\n if (!Number.isSafeInteger(index))\n throw new Error(\"Semantic evidence index exhausted\");\n const ref = `evidence:${label}#${index}`;\n try {\n writeFileSync(join(directory, String(index)), `${evidenceId}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n try {\n writeFileSync(mapping, `${ref}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n return reserveSemanticEvidenceRef(evidenceId, name);\n }\n return ref;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n index++;\n continue;\n }\n throw error;\n }\n }\n}\n\n/** Read only the exact regular snapshot for this assignment and verify its digest. */\nexport function readRequiredEvidenceSnapshot(\n assignmentId: string,\n evidence: RequiredEvidence,\n): string {\n if (!isRequiredEvidence(evidence) || \"result\" in evidence)\n throw new Error(\"invalid required evidence snapshot\");\n if (evidence.sourceAssignmentId !== assignmentId)\n throw new Error(\"required evidence source assignment mismatch\");\n const directory = requiredEvidenceDirectory(evidence.sourceAssignmentId);\n if (\n evidence.path !==\n join(directory, `${evidence.id}-${safeEvidenceName(evidence.name)}`)\n )\n throw new Error(\"required evidence path mismatch\");\n assertEvidenceDirectory(evidence.sourceAssignmentId, false);\n const before = lstatSync(evidence.path);\n if (\n !before.isFile() ||\n before.isSymbolicLink() ||\n before.size > EVIDENCE_SNAPSHOT_MAX_BYTES\n )\n throw new Error(\n \"required evidence snapshot is missing, unsafe, or oversized\",\n );\n const fd = openSync(\n evidence.path,\n constants.O_RDONLY |\n (constants.O_NOFOLLOW ?? 0) |\n (constants.O_NONBLOCK ?? 0),\n );\n try {\n const opened = fstatSync(fd);\n if (\n !opened.isFile() ||\n opened.dev !== before.dev ||\n opened.ino !== before.ino\n )\n throw new Error(\"required evidence snapshot changed during read\");\n const bytes = readFileSync(fd);\n if (\n bytes.length > EVIDENCE_SNAPSHOT_MAX_BYTES ||\n createHash(\"sha256\").update(bytes).digest(\"hex\") !== evidence.sha256\n )\n throw new Error(\"required evidence snapshot integrity check failed\");\n return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } finally {\n closeSync(fd);\n }\n}\n\nexport function parseSemanticResultRef(\n input: string,\n): { agent: string; index: number } | undefined {\n const match = SEMANTIC_RESULT_REF.exec(input);\n if (!match) return undefined;\n\n const index = Number(match[2]);\n if (!Number.isSafeInteger(index)) return undefined;\n\n return { agent: match[1], index };\n}\n\nexport function isCanonicalResultRef(value: unknown): value is string {\n return (\n typeof value === \"string\" &&\n value.startsWith(RESULT_PREFIX) &&\n RESULT_ID.test(value.slice(RESULT_PREFIX.length))\n );\n}\n\nexport function isResultBinding(value: unknown): value is ResultBinding {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\n const record = value as Record<string, unknown>;\n return (\n Object.keys(record).length === 2 &&\n typeof record.ref === \"string\" &&\n !!parseSemanticResultRef(record.ref) &&\n isCanonicalResultRef(record.canonicalRef)\n );\n}\n\nexport function herdsmanDataRoot(): string {\n return join(nodeOnlyAgentDir(), \"pi-herdsman\");\n}\n\n/** Match Pi 1.3.0 getAgentDir() normalization without importing the Pi SDK. */\nexport function nodeOnlyAgentDir(): string {\n let directory = process.env.PI_CODING_AGENT_DIR;\n if (!directory) return join(homedir(), \".pi\", \"agent\");\n\n if (\n process.platform === \"win32\" &&\n directory.startsWith(\"/\") &&\n !directory.startsWith(\"//\") &&\n !directory.includes(\"\\\\\")\n ) {\n const match = directory.match(\n /^\\/(?:mnt\\/|cygdrive\\/)?([a-z])(?:\\/(.*))?$/i,\n );\n if (match)\n directory = `${match[1].toUpperCase()}:\\\\${(match[2] ?? \"\").replaceAll(\"/\", \"\\\\\")}`;\n }\n if (directory === \"~\") return homedir();\n if (\n directory.startsWith(\"~/\") ||\n (process.platform === \"win32\" && directory.startsWith(\"~\\\\\"))\n )\n return join(homedir(), directory.slice(2));\n if (/^file:\\/\\//.test(directory)) return fileURLToPath(directory);\n return directory;\n}\n\nexport function herdsmanConfigPath(): string {\n return join(herdsmanDataRoot(), \"config.json\");\n}\n\nexport function herdsmanTempRoot(): string {\n return join(tmpdir(), `pi-herdsman-${process.getuid?.() ?? \"user\"}`);\n}\n\nfunction validateResultId(requestId: string): void {\n if (!RESULT_ID.test(requestId)) throw new Error(\"invalid result request id\");\n}\n\nexport function resultPath(requestId: string): string {\n validateResultId(requestId);\n return join(herdsmanDataRoot(), \"results\", requestId);\n}\n\nexport function peerAttachmentPath(name: string, text: string): string {\n if (\n typeof name !== \"string\" ||\n !name ||\n name.length > 255 ||\n /[\\\\/\\0]/u.test(name) ||\n typeof text !== \"string\"\n )\n throw new Error(\"invalid peer attachment\");\n const bytes = Buffer.from(text, \"utf8\");\n if (new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes) !== text)\n throw new Error(\"invalid peer attachment text\");\n const directory = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"peers-v2\",\n \"received-evidence\",\n );\n const digest = createHash(\"sha256\").update(bytes).digest(\"hex\");\n return join(directory, `${digest}-${name}`);\n}\n\n/** Persist a received text attachment as immutable recipient-local content. */\nexport function persistPeerAttachment(name: string, text: string): string {\n const path = peerAttachmentPath(name, text);\n const bytes = Buffer.from(text, \"utf8\");\n mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n chmodSync(dirname(path), 0o700);\n try {\n writeFileSync(path, bytes, { flag: \"wx\", mode: 0o600, flush: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n if (!readFileSync(path).equals(bytes))\n throw new Error(\"peer attachment content identity collision\");\n }\n return path;\n}\n\n/** Import a forwarded result artifact without allowing canonical-ID rebinding. */\nexport function persistPeerResultArtifact(\n canonicalRef: string,\n text: string,\n): string {\n if (!isCanonicalResultRef(canonicalRef) || typeof text !== \"string\")\n throw new Error(\"invalid peer result artifact\");\n const path = resultPath(canonicalRef.slice(RESULT_PREFIX.length));\n mkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n chmodSync(dirname(path), 0o700);\n const bytes = Buffer.from(text, \"utf8\");\n try {\n writeFileSync(path, bytes, { flag: \"wx\", mode: 0o600, flush: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n if (!readFileSync(path).equals(bytes))\n throw new Error(\"peer result identity collision\");\n }\n return path;\n}\n\nexport function resultRef(requestId: string): string {\n validateResultId(requestId);\n return `${RESULT_PREFIX}${requestId}`;\n}\n\nexport function reserveSemanticResultRef(\n agentLabel: string,\n minimumIndex = 1,\n): Readonly<{ ref: string; index: number }> {\n if (!parseSemanticResultRef(`result:${agentLabel}#${minimumIndex}`))\n throw new Error(\"Invalid semantic result identity\");\n\n const directory = join(\n herdsmanDataRoot(),\n \"result-ref-reservations\",\n agentLabel,\n );\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n\n let index = minimumIndex;\n // ponytail: immutable reservation scan; replace with a counter only if\n // allocation volume makes this measurably expensive.\n for (const name of readdirSync(directory)) {\n if (!/^[1-9][0-9]*$/.test(name)) continue;\n const reserved = Number(name);\n if (Number.isSafeInteger(reserved)) index = Math.max(index, reserved + 1);\n }\n\n for (;;) {\n if (!Number.isSafeInteger(index))\n throw new Error(\"Semantic result index exhausted\");\n try {\n writeFileSync(join(directory, String(index)), \"reserved\\n\", {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n if (process.platform !== \"win32\") {\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n }\n return { index, ref: `result:${agentLabel}#${index}` };\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n index++;\n continue;\n }\n throw error;\n }\n }\n}\n\nexport interface PublishedResult {\n version: 1;\n canonicalRef: string;\n rootSessionId: string;\n}\n\n/** Publishes an immutable ownership mapping in the semantic reservation slot. */\nexport function publishScopedResult(\n agentLabel: string,\n minimumIndex: number,\n canonicalRef: string,\n rootSessionId: string,\n): Readonly<{ ref: string; index: number }> {\n if (\n !parseSemanticResultRef(`result:${agentLabel}#${minimumIndex}`) ||\n !isCanonicalResultRef(canonicalRef) ||\n typeof rootSessionId !== \"string\" ||\n !rootSessionId.trim() ||\n rootSessionId.length > 512\n )\n throw new Error(\"Invalid scoped result identity\");\n const artifact = resolveResultRef(canonicalRef);\n if (!artifact) throw new Error(\"Invalid scoped result artifact\");\n const stat = lstatSync(artifact);\n if (!stat.isFile() || stat.isSymbolicLink())\n throw new Error(\"Invalid scoped result artifact\");\n const dataRoot = herdsmanDataRoot();\n const reservationRoot = join(dataRoot, \"result-ref-reservations\");\n const directory = join(reservationRoot, agentLabel);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n if (process.platform !== \"win32\") {\n // Persist each newly created directory entry before publishing beneath it.\n const dataParentFd = openSync(dirname(dataRoot), \"r\");\n try {\n fsyncSync(dataParentFd);\n } finally {\n closeSync(dataParentFd);\n }\n const dataRootFd = openSync(dataRoot, \"r\");\n try {\n fsyncSync(dataRootFd);\n } finally {\n closeSync(dataRootFd);\n }\n const reservationRootFd = openSync(reservationRoot, \"r\");\n try {\n fsyncSync(reservationRootFd);\n } finally {\n closeSync(reservationRootFd);\n }\n }\n const lease = acquireProcessLock(\n join(dataRoot, \"locks\", \"scoped-result-publication\"),\n { name: \"scoped result publication\" },\n );\n try {\n let index = minimumIndex;\n for (const name of readdirSync(directory)) {\n if (!/^[1-9][0-9]*$/.test(name)) continue;\n const reserved = Number(name);\n if (Number.isSafeInteger(reserved)) index = Math.max(index, reserved + 1);\n const path = join(directory, name);\n let record: unknown;\n try {\n record = JSON.parse(readFileSync(path, \"utf8\"));\n } catch {\n continue;\n }\n if (record && typeof record === \"object\" && !Array.isArray(record)) {\n const metadata = record as Record<string, unknown>;\n if (\n Object.keys(metadata).length === 3 &&\n metadata.version === 1 &&\n isCanonicalResultRef(metadata.canonicalRef) &&\n typeof metadata.rootSessionId === \"string\" &&\n metadata.rootSessionId.trim() &&\n metadata.canonicalRef === canonicalRef\n ) {\n if (metadata.rootSessionId !== rootSessionId)\n throw new Error(\"Conflicting scoped result ownership\");\n return {\n ref: `result:${agentLabel}#${Number(name)}`,\n index: Number(name),\n };\n }\n }\n }\n for (;;) {\n if (!Number.isSafeInteger(index))\n throw new Error(\"Semantic result index exhausted\");\n const path = join(directory, String(index));\n try {\n writeFileSync(\n path,\n `${JSON.stringify({ version: 1, canonicalRef, rootSessionId })}\\n`,\n { encoding: \"utf8\", flag: \"wx\", mode: 0o600, flush: true },\n );\n if (process.platform !== \"win32\") {\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n }\n return { ref: `result:${agentLabel}#${index}`, index };\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n index++;\n }\n }\n } finally {\n lease.release();\n }\n}\n\nexport function resolveScopedResult(\n ref: string,\n): PublishedResult | \"reserved\" | \"invalid\" | undefined {\n const semantic = parseSemanticResultRef(ref);\n if (!semantic) return undefined;\n const path = join(\n herdsmanDataRoot(),\n \"result-ref-reservations\",\n semantic.agent,\n String(semantic.index),\n );\n let stat: Stats;\n try {\n stat = lstatSync(path);\n } catch (error) {\n return (error as NodeJS.ErrnoException).code === \"ENOENT\"\n ? undefined\n : \"invalid\";\n }\n try {\n if (!stat.isFile() || stat.isSymbolicLink()) return \"invalid\";\n const contents = readFileSync(path, \"utf8\");\n if (contents === \"reserved\\n\") return \"reserved\";\n const value: unknown = JSON.parse(contents);\n if (!value || typeof value !== \"object\" || Array.isArray(value))\n return \"invalid\";\n const record = value as Record<string, unknown>;\n if (\n Object.keys(record).length !== 3 ||\n record.version !== 1 ||\n !isCanonicalResultRef(record.canonicalRef) ||\n typeof record.rootSessionId !== \"string\" ||\n !record.rootSessionId.trim() ||\n record.rootSessionId.length > 512\n )\n return \"invalid\";\n const artifact = resolveResultRef(record.canonicalRef);\n if (!artifact) return \"invalid\";\n const artifactStat = lstatSync(artifact);\n if (!artifactStat.isFile() || artifactStat.isSymbolicLink())\n return \"invalid\";\n return record as PublishedResult;\n } catch {\n return \"invalid\";\n }\n}\n\nexport function resolveResultRef(input: string): string | undefined {\n if (!input.startsWith(RESULT_PREFIX)) return undefined;\n return resultPath(input.slice(RESULT_PREFIX.length));\n}\n", "import * as fs from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, join } from \"node:path\";\nimport { herdsmanTempRoot, isIncidentalMetadata } from \"./storage.ts\";\n\nexport class ProcessLockOccupiedError extends Error {\n readonly code = \"PROCESS_LOCK_OCCUPIED\";\n}\n\nexport type ProcessLockClaim = { pid: number; id: string };\n\nexport function assignmentLockPath(mailbox: string): string {\n return join(\n herdsmanTempRoot(),\n \"locks\",\n `assignment-${createHash(\"sha256\").update(mailbox).digest(\"hex\")}`,\n );\n}\n\nexport function sessionActivationLockPath(\n canonicalSessionPath: string,\n): string {\n return join(\n herdsmanTempRoot(),\n \"locks\",\n `session-${createHash(\"sha256\").update(canonicalSessionPath).digest(\"hex\")}`,\n );\n}\n\nexport function claimAssignmentLock(mailbox: string): () => void {\n return claimProcessLock(assignmentLockPath(mailbox), {\n name: \"managed assignment\",\n occupiedMessage: \"Managed assignment is already changing\",\n });\n}\n\nexport function tryClaimAssignmentLock(\n mailbox: string,\n): (() => void) | undefined {\n try {\n return claimAssignmentLock(mailbox);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) return undefined;\n throw error;\n }\n}\n\nexport function claimSessionActivationLock(\n canonicalSessionPath: string,\n): () => void {\n return claimProcessLock(sessionActivationLockPath(canonicalSessionPath), {\n name: \"session activation\",\n occupiedMessage: \"The exact Pi session is already being activated\",\n });\n}\n\nconst UUID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\ntype ProcessLockLease = { claim: ProcessLockClaim; release: () => void };\ntype LockOwner = ProcessLockClaim & {\n linuxBirth?: { bootId: string; startTicks: string };\n};\n\ntype ProcessLockOptions = {\n afterStaleOwnerRemoved?: () => void;\n name?: string;\n occupiedMessage?: string;\n};\n\nexport function isProcessLockClaim(value: unknown): value is ProcessLockClaim {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const claim = value as Record<string, unknown>;\n if (\n Object.keys(claim).length !== 2 ||\n !Object.hasOwn(claim, \"pid\") ||\n !Object.hasOwn(claim, \"id\") ||\n !Number.isInteger(claim.pid) ||\n (claim.pid as number) <= 0 ||\n typeof claim.id !== \"string\" ||\n !UUID.test(claim.id)\n )\n return false;\n return true;\n}\n\nfunction readProcessLockOwner(path: string, owner: string): LockOwner {\n const value: unknown = JSON.parse(fs.readFileSync(join(path, owner), \"utf8\"));\n if (!value || typeof value !== \"object\" || Array.isArray(value))\n throw new Error(\"invalid process lock claim\");\n const record = value as Record<string, unknown>;\n const claim = { pid: record.pid, id: record.id };\n if (\n !isProcessLockClaim(claim) ||\n owner !== `${claim.pid}-${claim.id}` ||\n (Object.keys(record).length !== 2 && Object.keys(record).length !== 3) ||\n (Object.keys(record).length === 3 && !Object.hasOwn(record, \"linuxBirth\"))\n )\n throw new Error(\"invalid process lock claim\");\n if (Object.hasOwn(record, \"linuxBirth\")) {\n const birth = record.linuxBirth;\n if (\n !birth ||\n typeof birth !== \"object\" ||\n Array.isArray(birth) ||\n Object.keys(birth).length !== 2 ||\n typeof (birth as Record<string, unknown>).bootId !== \"string\" ||\n !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(\n (birth as Record<string, string>).bootId,\n ) ||\n typeof (birth as Record<string, unknown>).startTicks !== \"string\" ||\n !/^(0|[1-9][0-9]*)$/.test((birth as Record<string, string>).startTicks)\n )\n throw new Error(\"invalid process lock identity\");\n return { ...claim, linuxBirth: birth as LockOwner[\"linuxBirth\"] };\n }\n return claim;\n}\n\nfunction readLinuxBirth(\n pid: number,\n): NonNullable<LockOwner[\"linuxBirth\"]> | undefined {\n const bootId = fs\n .readFileSync(\"/proc/sys/kernel/random/boot_id\", \"utf8\")\n .trim();\n let stat: string;\n try {\n stat = fs.readFileSync(`/proc/${pid}/stat`, \"utf8\");\n } catch (error) {\n if (\n (error as NodeJS.ErrnoException).code === \"ENOENT\" &&\n !processExists(pid)\n )\n return undefined;\n throw error;\n }\n const end = stat.lastIndexOf(\") \");\n if (end < 0 || !stat.startsWith(`${pid} (`))\n throw new Error(\"Invalid Linux process stat\");\n const fields = stat\n .slice(end + 2)\n .trim()\n .split(/\\s+/);\n const startTicks = fields[19];\n if (\n !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(bootId) ||\n fields.length < 20 ||\n !startTicks ||\n !/^(0|[1-9][0-9]*)$/.test(startTicks)\n )\n throw new Error(\"Invalid Linux process identity\");\n return { bootId, startTicks };\n}\n\nfunction processOwnerExists(owner: LockOwner): boolean {\n if (!processExists(owner.pid)) return false;\n if (process.platform !== \"linux\") return true;\n if (!owner.linuxBirth)\n throw new Error(\"Linux lock owner identity is unverifiable\");\n const current = readLinuxBirth(owner.pid);\n if (!current) return false;\n return (\n current.bootId === owner.linuxBirth.bootId &&\n current.startTicks === owner.linuxBirth.startTicks\n );\n}\n\nfunction publicClaim(owner: LockOwner): ProcessLockClaim {\n return { pid: owner.pid, id: owner.id };\n}\n\nfunction ownerMissing(path: string): boolean {\n try {\n fs.lstatSync(path);\n return false;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return true;\n throw error;\n }\n}\n\nfunction lockOwnerEntry(path: string): { owner: string; metadata: string[] } {\n const entries = fs.readdirSync(path, { withFileTypes: true });\n const owners = entries.filter((entry) => !isIncidentalMetadata(entry));\n if (owners.length !== 1 || !owners[0]!.isFile())\n throw new Error(\"Invalid process lock owner\");\n return {\n owner: owners[0]!.name,\n metadata: entries.filter(isIncidentalMetadata).map((entry) => entry.name),\n };\n}\n\nfunction processExists(pid: number): boolean {\n try {\n process.kill(pid, 0);\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ESRCH\") return false;\n throw error;\n }\n}\n\nfunction publishClaim(\n parent: string,\n claimDir: string,\n owner: string,\n payload: string,\n): void {\n // Publish the owner record before the canonical rename so observers never\n // see an empty canonical lock.\n const temporary = join(parent, `.${basename(claimDir)}.${randomUUID()}.tmp`);\n fs.mkdirSync(temporary, 0o700);\n const temporaryOwner = join(temporary, owner);\n let fd: number | undefined;\n try {\n fd = fs.openSync(temporaryOwner, \"wx\", 0o600);\n fs.writeSync(fd, payload);\n fs.fsyncSync(fd);\n fs.closeSync(fd);\n fd = undefined;\n fs.chmodSync(temporaryOwner, 0o600);\n fs.renameSync(temporary, claimDir);\n } finally {\n if (fd !== undefined) fs.closeSync(fd);\n try {\n fs.unlinkSync(temporaryOwner);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n fs.rmdirSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function readLiveProcessLock(\n path: string,\n name = \"process lock\",\n): ProcessLockClaim {\n const { claim, live } = readProcessLockStatus(path, name);\n if (!live) throw new Error(`Unable to verify ${name}`);\n return claim;\n}\n\nexport function readProcessLockStatus(\n path: string,\n name = \"process lock\",\n): { claim: ProcessLockClaim; live: boolean } {\n const verifyMessage = `Unable to verify ${name}`;\n let owner: string;\n try {\n ({ owner } = lockOwnerEntry(path));\n } catch (error) {\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n const record = readProcessLockOwner(path, owner);\n return { claim: publicClaim(record), live: processOwnerExists(record) };\n } catch (error) {\n throw new Error(verifyMessage, { cause: error });\n }\n}\n\nexport function acquireProcessLock(\n path: string,\n options: ProcessLockOptions = {},\n): ProcessLockLease {\n const name = options.name ?? \"process lock\";\n const verifyMessage = `Unable to verify ${name}`;\n const occupiedMessage =\n options.occupiedMessage ??\n `${name[0].toUpperCase()}${name.slice(1)} is in progress`;\n const recoverMessage = `Unable to recover ${name}`;\n const parent = dirname(path);\n fs.mkdirSync(parent, { recursive: true, mode: 0o700 });\n fs.chmodSync(parent, 0o700);\n const claimDir = path;\n const claim: ProcessLockClaim = { pid: process.pid, id: randomUUID() };\n const lockOwner: LockOwner =\n process.platform === \"linux\"\n ? { ...claim, linuxBirth: readLinuxBirth(process.pid)! }\n : claim;\n const owner = `${claim.pid}-${claim.id}`;\n const payload = JSON.stringify(lockOwner);\n const ownerPath = join(claimDir, owner);\n\n // An empty canonical directory is ambiguous and must not be replaced.\n try {\n lockOwnerEntry(claimDir);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n throw new Error(verifyMessage, { cause: error });\n }\n\n try {\n // Publish the complete claim with one rename. In particular, never\n // create the canonical directory before its owner record exists.\n publishClaim(parent, claimDir, owner, payload);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code !== \"EEXIST\" && code !== \"ENOTEMPTY\" && code !== \"EPERM\")\n throw error;\n let observedOwner: string;\n try {\n ({ owner: observedOwner } = lockOwnerEntry(claimDir));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(verifyMessage, { cause: error });\n }\n let staleOwner: LockOwner;\n try {\n staleOwner = readProcessLockOwner(claimDir, observedOwner);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n let currentOwner: string;\n try {\n ({ owner: currentOwner } = lockOwnerEntry(claimDir));\n } catch (checkError) {\n if ((checkError as NodeJS.ErrnoException).code === \"ENOENT\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(verifyMessage, { cause: checkError });\n }\n\n if (currentOwner !== observedOwner) {\n try {\n readProcessLockOwner(claimDir, currentOwner);\n } catch (checkError) {\n throw new Error(verifyMessage, { cause: checkError });\n }\n\n throw new ProcessLockOccupiedError(occupiedMessage);\n }\n }\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n if (processOwnerExists(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n // Move the complete, verified stale claim out of the canonical name in one\n // operation. Never unlink the owner while leaving an empty canonical\n // directory behind.\n const quarantine = join(\n parent,\n `.${basename(claimDir)}.${randomUUID()}.stale`,\n );\n try {\n const { owner: currentOwner } = lockOwnerEntry(claimDir);\n if (currentOwner !== observedOwner)\n throw new ProcessLockOccupiedError(occupiedMessage);\n const currentClaim = readProcessLockOwner(claimDir, observedOwner);\n if (JSON.stringify(currentClaim) !== JSON.stringify(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n try {\n fs.renameSync(claimDir, quarantine);\n } catch (removeError) {\n const code = (removeError as NodeJS.ErrnoException).code;\n if (code === \"ENOENT\" || code === \"ENOTEMPTY\" || code === \"EEXIST\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw new Error(recoverMessage, { cause: removeError });\n }\n\n // A concurrent claimant may have won the canonical name while it was\n // absent. Never clean up a quarantined directory unless it is still the\n // exact stale claim that was verified above.\n let quarantinedOwner: string;\n let metadata: string[];\n try {\n ({ owner: quarantinedOwner, metadata } = lockOwnerEntry(quarantine));\n } catch (error) {\n throw new Error(recoverMessage, { cause: error });\n }\n if (quarantinedOwner !== observedOwner)\n throw new ProcessLockOccupiedError(occupiedMessage);\n try {\n const quarantinedClaim = readProcessLockOwner(quarantine, observedOwner);\n if (JSON.stringify(quarantinedClaim) !== JSON.stringify(staleOwner))\n throw new ProcessLockOccupiedError(occupiedMessage);\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) throw error;\n throw new Error(verifyMessage, { cause: error });\n }\n options.afterStaleOwnerRemoved?.();\n try {\n unlinkMetadata(quarantine, metadata);\n fs.unlinkSync(join(quarantine, observedOwner));\n fs.rmdirSync(quarantine);\n } catch (cleanupError) {\n throw new Error(recoverMessage, { cause: cleanupError });\n }\n try {\n publishClaim(parent, claimDir, owner, payload);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code === \"EEXIST\" || code === \"ENOTEMPTY\" || code === \"EPERM\")\n throw new ProcessLockOccupiedError(occupiedMessage);\n throw error;\n }\n }\n return {\n claim,\n release: () => releaseProcessLock(claimDir, ownerPath, claim, name),\n };\n}\n\nexport function claimProcessLock(\n path: string,\n options: ProcessLockOptions = {},\n): () => void {\n return acquireProcessLock(path, options).release;\n}\n\nfunction releaseProcessLock(\n claimDir: string,\n ownerPath: string,\n claim: ProcessLockClaim,\n name: string,\n): void {\n let owner: string;\n try {\n ({ owner } = lockOwnerEntry(claimDir));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n // A lease whose owner has already disappeared or been replaced must not\n // affect the current lock generation.\n try {\n if (ownerMissing(ownerPath)) return;\n } catch (missing) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: missing });\n }\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n if (owner !== basename(ownerPath)) {\n try {\n if (ownerMissing(ownerPath)) return;\n } catch (error) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n throw new Error(\n `${name[0].toUpperCase()}${name.slice(1)} ownership changed`,\n );\n }\n let current: LockOwner;\n try {\n current = readProcessLockOwner(claimDir, basename(ownerPath));\n } catch (error) {\n if (\n (error as NodeJS.ErrnoException).code === \"ENOENT\" &&\n ownerMissing(ownerPath)\n )\n return;\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n if (current.pid !== claim.pid || current.id !== claim.id)\n throw new Error(\n `${name[0].toUpperCase()}${name.slice(1)} ownership changed`,\n );\n // Retire the complete claim before cleanup; a new canonical owner may follow.\n const retired = join(\n dirname(claimDir),\n `.${basename(claimDir)}.${randomUUID()}.released`,\n );\n fs.renameSync(claimDir, retired);\n let retiredOwner: string;\n let metadata: string[];\n try {\n ({ owner: retiredOwner, metadata } = lockOwnerEntry(retired));\n if (retiredOwner !== basename(ownerPath))\n throw new Error(\"Process lock owner changed\");\n const relocated = readProcessLockOwner(retired, retiredOwner);\n if (relocated.pid !== claim.pid || relocated.id !== claim.id)\n throw new Error(\"Process lock generation changed\");\n } catch (error) {\n throw new Error(`Unable to verify ${name} ownership`, { cause: error });\n }\n unlinkMetadata(retired, metadata);\n fs.unlinkSync(join(retired, retiredOwner));\n try {\n fs.rmdirSync(retired);\n } catch (error) {\n const code = (error as NodeJS.ErrnoException).code;\n if (code !== \"ENOENT\" && code !== \"ENOTEMPTY\") throw error;\n }\n}\n\nfunction unlinkMetadata(path: string, entries: string[]): void {\n for (const entry of entries) {\n try {\n fs.unlinkSync(join(path, entry));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n", "import { constants } from \"node:fs\";\nimport {\n chmodSync,\n closeSync,\n fsyncSync,\n lstatSync,\n fstatSync,\n readdirSync,\n rmSync,\n mkdirSync,\n openSync,\n readFileSync,\n readSync,\n statSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { basename, dirname, isAbsolute, join, normalize } from \"node:path\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport {\n acquireProcessLock,\n ProcessLockOccupiedError,\n isProcessLockClaim,\n readLiveProcessLock,\n readProcessLockStatus,\n type ProcessLockClaim,\n} from \"./lock.ts\";\nimport {\n herdsmanDataRoot,\n isIncidentalMetadata,\n isResultBinding,\n isRequiredEvidence,\n upgradeAndVerifyRequiredEvidence,\n verifySemanticEvidenceReservation,\n type RequiredEvidence,\n type ResultBinding,\n} from \"./storage.ts\";\nimport {\n isRuntimeBuild,\n sameRuntimeBuild,\n type RuntimeBuild,\n} from \"./compatibility.ts\";\nimport type { ExtensionContext } from \"@earendil-works/pi-coding-agent\";\n\n// Authority edges are deliberately asymmetric: Chief -> Manager -> Lead -> Agent.\n// Staff and supervisor cross one edge; only Lead/Manager sessions may be peers.\nexport type SessionRole = \"lead\" | \"manager\" | \"chief\";\nexport type CoordinatorRole = \"lead\" | \"manager\";\nexport type PeerRole = CoordinatorRole;\nexport type LeadRole = SessionRole;\n\nexport type SessionKindEntry =\n | { version: 1; sessionId: string; kind: \"ordinary\" }\n | {\n version: 1;\n sessionId: string;\n kind: \"managed\";\n repoKey: string;\n branch: string;\n };\n\n// Identity is session-wide, unlike branch-local role and execution preferences.\nexport function readSessionKind(\n entries: readonly unknown[],\n sessionId: string,\n): SessionKindEntry | undefined {\n let identity: SessionKindEntry | undefined;\n for (const candidate of entries as readonly any[]) {\n if (\n candidate?.type !== \"custom\" ||\n candidate.customType !== \"pi-herdsman-session-kind\" ||\n candidate.data?.sessionId !== sessionId\n )\n continue;\n const data = candidate.data;\n if (\n !validSession(sessionId) ||\n Array.isArray(data) ||\n data.version !== 1 ||\n (data.kind !== \"ordinary\" && data.kind !== \"managed\") ||\n Object.keys(data).length !== (data.kind === \"managed\" ? 5 : 3) ||\n (data.kind === \"managed\" &&\n (typeof data.repoKey !== \"string\" ||\n !data.repoKey.trim() ||\n typeof data.branch !== \"string\" ||\n !data.branch.trim()))\n )\n throw new Error(\"invalid pi-herdsman-session-kind entry\");\n if (identity && !isDeepStrictEqual(identity, data))\n throw new Error(\"conflicting pi-herdsman-session-kind entries\");\n identity = data;\n }\n return identity;\n}\n\nexport type LeadRoleState = Readonly<{\n role: LeadRole;\n leadTools: readonly string[];\n}>;\n\nexport function sessionLeadRoleState(\n entries: readonly unknown[],\n sessionId: string,\n): LeadRoleState | undefined {\n let state: LeadRoleState | undefined;\n for (const candidate of entries as readonly any[]) {\n if (\n candidate?.type !== \"custom\" ||\n candidate.customType !== \"pi-herdsman-role\" ||\n candidate.data?.sessionId !== sessionId\n )\n continue;\n const data = candidate.data;\n if (\n !data ||\n typeof data !== \"object\" ||\n Array.isArray(data) ||\n Object.keys(data).length !== 3 ||\n !Object.hasOwn(data, \"role\") ||\n !Object.hasOwn(data, \"leadTools\") ||\n (data.role !== \"lead\" &&\n data.role !== \"manager\" &&\n data.role !== \"chief\") ||\n !Array.isArray(data.leadTools) ||\n data.leadTools.some(\n (name: unknown) => typeof name !== \"string\" || name.length === 0,\n ) ||\n new Set(data.leadTools).size !== data.leadTools.length\n )\n throw new Error(\"invalid pi-herdsman-role entry\");\n state = { role: data.role, leadTools: [...data.leadTools] };\n }\n return state;\n}\n\nexport type ChiefDescriptor = {\n version: 1;\n build?: RuntimeBuild;\n leaseId: string;\n claim: ProcessLockClaim;\n piSessionId: string;\n piSessionFile?: string;\n paneId: string;\n tabId?: string;\n workspaceId: string;\n createdAt: number;\n};\n\nexport type ChiefIdentity = Omit<\n ChiefDescriptor,\n \"version\" | \"leaseId\" | \"claim\" | \"createdAt\"\n> & {\n build: RuntimeBuild;\n createdAt?: number;\n};\n\nexport type SupervisionRuntime = {\n root: string;\n lock: string;\n descriptor: string;\n inbox: string;\n coordinators: string;\n managers: string;\n assignments: string;\n /** Old caller spelling until the integration lane switches to coordinators. */\n leads: string;\n};\n\nexport type ChiefLease = {\n descriptor: ChiefDescriptor;\n runtime: SupervisionRuntime;\n release: () => void;\n};\n\nexport const COORDINATION_MESSAGE_KINDS = [\n \"chief_message\",\n \"lead_message\",\n \"manager_message\",\n \"project_assignment\",\n \"peer_message\",\n] as const;\n\nexport type ChiefMessageKind = (typeof COORDINATION_MESSAGE_KINDS)[number];\n\n/** Shared durable transport record used by Chief and Lead peer traffic. */\nexport type CoordinationMessageKind = ChiefMessageKind;\n\nexport type ChiefMessageRecord = {\n version: 2;\n build?: RuntimeBuild;\n id: string;\n leaseId: string;\n kind: ChiefMessageKind;\n fromSessionId: string;\n toSessionId: string;\n leadSessionId: string;\n branch?: string;\n text: string;\n resultBindings?: ResultBinding[];\n peerSource?: PeerSource;\n createdAt: number;\n};\n\ntype OverflowBodyRef = { bytes: number; sha256: string };\ntype StoredChiefMessage = Omit<\n ChiefMessageRecord,\n \"text\" | \"resultBindings\"\n> & {\n text: string;\n resultBindings?: ResultBinding[];\n bodyRef?: OverflowBodyRef;\n};\n\nexport type PeerGroup = Readonly<{\n repoKey: string;\n primaryWorkspaceId: string;\n}>;\ntype LocalPeerSource =\n | { role: \"manager\" }\n | { role: \"lead\"; socket: string; group: PeerGroup | null; managed: boolean };\nexport type PeerSource =\n LocalPeerSource | { role: \"lead\"; remoteOrdinary: true };\nexport type PeerContext = LocalPeerSource;\n\nexport function canMessagePeer(a: PeerContext, b: PeerContext): boolean {\n if (a.role !== b.role) return false;\n if (a.role === \"manager\") return true;\n if (b.role !== \"lead\") return false;\n if (!a.managed && !b.managed) return true;\n return (\n !!a.group &&\n !!b.group &&\n a.socket === b.socket &&\n a.group.repoKey === b.group.repoKey &&\n a.group.primaryWorkspaceId === b.group.primaryWorkspaceId\n );\n}\n\nexport function isRemoteOrdinaryLead(\n peer: PeerLeadRecord,\n assignments: Map<string, GlobalProjectAssignment[]>,\n): boolean {\n return (\n peer.role === \"lead\" &&\n peer.sessionKind === \"ordinary\" &&\n (assignments.get(peer.piSessionId)?.length ?? 0) === 0\n );\n}\n\nexport type CoordinationMessageRecord = ChiefMessageRecord;\n\nexport type ChiefInboxDrainOptions = {\n runtime: SupervisionRuntime;\n sessionId: string;\n signal?: AbortSignal;\n isAuthorized: (record: ChiefMessageRecord) => boolean | Promise<boolean>;\n isDelivered: (id: string) => boolean;\n deliveryMode?: (\n record: ChiefMessageRecord,\n ) =>\n | \"steer\"\n | \"followUp\"\n | undefined\n | Promise<\"steer\" | \"followUp\" | undefined>;\n senderTarget?: (\n record: ChiefMessageRecord,\n ) => string | undefined | Promise<string | undefined>;\n sendMessage: (\n message: unknown,\n options: {\n deliverAs?: \"steer\" | \"followUp\";\n triggerTurn: boolean;\n },\n record: ChiefMessageRecord,\n ) => void | Promise<void>;\n accepted?: (record: ChiefMessageRecord) => void | Promise<void>;\n rejected?: (record: ChiefMessageRecord) => void | Promise<void>;\n cleanupError?: (error: unknown) => void | Promise<void>;\n /** Guards state belonging to one lead session/generation transaction. */\n transaction?: {\n begin: (record: ChiefMessageRecord) => unknown | Promise<unknown>;\n revalidate: (token: unknown, phase: string) => void | Promise<void>;\n clear: (token: unknown) => void | Promise<void>;\n };\n};\n\nexport type CoordinationInboxDrainOptions = ChiefInboxDrainOptions;\n\nexport const COORDINATION_MESSAGE_MAX_BYTES = 8 * 1024;\nexport const COORDINATION_INBOX_SCAN_LIMIT = 32;\nconst CHIEF_DESCRIPTOR_MAX_BYTES = 2048;\nconst COORDINATION_BODY_MAX_BYTES = 1024 * 1024;\n\nconst UUID =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\nconst MESSAGE_KINDS = new Set<ChiefMessageKind>(COORDINATION_MESSAGE_KINDS);\n\nfunction validOverflowBodyRef(value: unknown): value is OverflowBodyRef {\n return (\n !!value &&\n typeof value === \"object\" &&\n !Array.isArray(value) &&\n Object.keys(value).length === 2 &&\n Number.isInteger((value as any).bytes) &&\n (value as any).bytes > 0 &&\n (value as any).bytes <= COORDINATION_BODY_MAX_BYTES &&\n /^[a-f0-9]{64}$/.test((value as any).sha256)\n );\n}\n\nfunction validSession(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0 && value.length <= 512;\n}\n\nfunction sameRuntimeBuildEvidence(\n left: RuntimeBuild | undefined,\n right: RuntimeBuild | undefined,\n): boolean {\n return left?.version === right?.version && left?.sha256 === right?.sha256;\n}\n\nfunction validNativeIdentity(value: unknown): value is string {\n return (\n typeof value === \"string\" && value.trim().length > 0 && value.length <= 512\n );\n}\n\nfunction validMessage(value: unknown): value is ChiefMessageRecord {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"id\",\n \"leaseId\",\n \"kind\",\n \"fromSessionId\",\n \"toSessionId\",\n \"leadSessionId\",\n \"text\",\n \"createdAt\",\n ];\n const optional = [\n \"branch\",\n \"resultBindings\",\n \"build\",\n \"peerSource\",\n \"bodyRef\",\n ];\n if (\n Object.keys(record).some(\n (key) => !keys.includes(key) && !optional.includes(key),\n ) ||\n Object.keys(record).length < keys.length ||\n keys.some((key) => !Object.hasOwn(record, key))\n )\n return false;\n const projectMessage = record.kind === \"project_assignment\";\n const peerMessage = record.kind === \"peer_message\";\n const source = record.peerSource as Record<string, unknown> | undefined;\n const validPeerSource =\n source &&\n typeof source === \"object\" &&\n (source.role === \"manager\"\n ? Object.keys(source).length === 1\n : source.role === \"lead\" &&\n ((Object.keys(source).length === 2 && source.remoteOrdinary === true) ||\n (Object.keys(source).length === 4 &&\n typeof source.socket === \"string\" &&\n source.socket.length > 0 &&\n source.socket.length <= 4096 &&\n typeof source.managed === \"boolean\" &&\n (source.group === null\n ? !source.managed\n : !!source.group &&\n typeof source.group === \"object\" &&\n Object.keys(source.group).length === 2 &&\n validNativeIdentity(\n (source.group as Record<string, unknown>).repoKey,\n ) &&\n validNativeIdentity(\n (source.group as Record<string, unknown>).primaryWorkspaceId,\n )))));\n if (\n projectMessage\n ? !validNativeIdentity(record.branch)\n : record.branch !== undefined &&\n (record.kind !== \"manager_message\" ||\n !validNativeIdentity(record.branch))\n ) {\n return false;\n }\n return (\n record.version === 2 &&\n (peerMessage ? !!validPeerSource : record.peerSource === undefined) &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n typeof record.id === \"string\" &&\n UUID.test(record.id) &&\n typeof record.leaseId === \"string\" &&\n UUID.test(record.leaseId) &&\n typeof record.kind === \"string\" &&\n MESSAGE_KINDS.has(record.kind as ChiefMessageKind) &&\n validSession(record.fromSessionId) &&\n validSession(record.toSessionId) &&\n validSession(record.leadSessionId) &&\n typeof record.text === \"string\" &&\n (record.bodyRef === undefined\n ? record.text.length > 0\n : record.text === \"\" &&\n record.resultBindings === undefined &&\n validOverflowBodyRef(record.bodyRef)) &&\n (record.resultBindings === undefined ||\n (Array.isArray(record.resultBindings) &&\n record.resultBindings.every(isResultBinding))) &&\n Number.isInteger(record.createdAt) &&\n (record.createdAt as number) >= 0\n );\n}\n\nexport function chiefMessageBytes(record: ChiefMessageRecord): number {\n return Buffer.byteLength(`${JSON.stringify(record)}\\n`, \"utf8\");\n}\n\nfunction assertMessage(value: unknown): asserts value is ChiefMessageRecord {\n if (!validMessage(value)) throw new Error(\"Invalid Chief message record\");\n if (chiefMessageBytes(value) > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"Chief message record is too large\");\n}\n\nfunction compactChiefMessage(\n record: ChiefMessageRecord,\n path: string,\n): StoredChiefMessage {\n if (chiefMessageBytes(record) <= COORDINATION_MESSAGE_MAX_BYTES)\n return record;\n const bodyRef = writeOverflowBody(`${path}.body`, {\n text: record.text,\n ...(record.resultBindings ? { resultBindings: record.resultBindings } : {}),\n });\n const stored: StoredChiefMessage = { ...record, text: \"\", bodyRef };\n delete stored.resultBindings;\n if (\n chiefMessageBytes(stored as ChiefMessageRecord) >\n COORDINATION_MESSAGE_MAX_BYTES\n )\n throw new Error(\"Chief message routing metadata is too large\");\n return stored;\n}\n\nfunction inboxFor(runtime: SupervisionRuntime, toSessionId: string): string {\n if (!validSession(toSessionId))\n throw new Error(\"Invalid Chief message target\");\n return join(\n runtime.inbox,\n createHash(\"sha256\").update(toSessionId).digest(\"hex\"),\n );\n}\n\nexport function chiefMessagePath(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): string {\n if (!UUID.test(id)) throw new Error(\"Invalid Chief message ID\");\n return join(inboxFor(runtime, toSessionId), `${id}.json`);\n}\n\nfunction peerDeliveryReceiptPath(\n runtime: SupervisionRuntime,\n sessionId: string,\n id: string,\n): string {\n if (!UUID.test(id) || !validSession(sessionId))\n throw new Error(\"Invalid peer delivery receipt identity\");\n return join(\n runtime.root,\n \"peer-delivery-receipts\",\n createHash(\"sha256\").update(sessionId).digest(\"hex\"),\n `${id}.json`,\n );\n}\n\n/** Digest used to bind the Pi-history delivery receipt to exact inbox content. */\nexport function coordinationMessageDigest(record: ChiefMessageRecord): string {\n const canonical = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(canonical);\n if (!value || typeof value !== \"object\") return value;\n return Object.fromEntries(\n Object.entries(value)\n .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))\n .map(([key, item]) => [key, canonical(item)]),\n );\n };\n const content = {\n version: record.version,\n build: record.build,\n id: record.id,\n leaseId: record.leaseId,\n kind: record.kind,\n fromSessionId: record.fromSessionId,\n toSessionId: record.toSessionId,\n leadSessionId: record.leadSessionId,\n branch: record.branch,\n text: record.text,\n resultBindings: record.resultBindings,\n peerSource: record.peerSource,\n createdAt: record.createdAt,\n };\n return createHash(\"sha256\")\n .update(JSON.stringify(canonical(content)))\n .digest(\"hex\");\n}\n\n/** The live Pi-history predicate shared by inbox draining and receipt tests. */\nexport function coordinationMessageDelivered(\n record: ChiefMessageRecord,\n sessionId: string,\n entries: readonly unknown[],\n): boolean {\n return (\n record.toSessionId === sessionId &&\n entries.some((value) => {\n const entry = value as {\n customType?: unknown;\n details?: Record<string, unknown>;\n } | null;\n return (\n entry?.customType === `pi-herdsman-${record.kind}` &&\n entry.details?.id === record.id &&\n entry.details?.leaseId === record.leaseId &&\n entry.details?.fromSessionId === record.fromSessionId &&\n entry.details?.leadSessionId === record.leadSessionId &&\n entry.details?.branch === record.branch &&\n (record.kind !== \"peer_message\" ||\n entry.details?.digest === coordinationMessageDigest(record))\n );\n })\n );\n}\n\n/** Persist only after the live Pi-history receipt has been verified. */\nexport function writePeerDeliveryReceipt(\n runtime: SupervisionRuntime,\n record: ChiefMessageRecord,\n): void {\n if (record.kind !== \"peer_message\")\n throw new Error(\"Peer delivery receipt requires a peer message\");\n const path = peerDeliveryReceiptPath(runtime, record.toSessionId, record.id);\n const directory = dirname(path);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n const receipt = {\n sessionId: record.toSessionId,\n id: record.id,\n digest: coordinationMessageDigest(record),\n };\n const content = `${JSON.stringify(receipt)}\\n`;\n try {\n const existing = JSON.parse(readFileSync(path, \"utf8\"));\n if (!isDeepStrictEqual(existing, receipt))\n throw new Error(\"Conflicting peer delivery receipt\");\n return;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n publishRecord(path, content);\n fsyncDirectory(dirname(directory));\n}\n\n/** Missing is distinct from unreadable or mismatched; callers must fail closed. */\nexport function hasPeerDeliveryReceipt(\n runtime: SupervisionRuntime,\n sessionId: string,\n id: string,\n digest: string,\n): boolean {\n try {\n const receipt = JSON.parse(\n readFileSync(peerDeliveryReceiptPath(runtime, sessionId, id), \"utf8\"),\n ) as { sessionId?: unknown; id?: unknown; digest?: unknown };\n if (\n receipt.sessionId !== sessionId ||\n receipt.id !== id ||\n receipt.digest !== digest\n )\n throw new Error(\"Conflicting peer delivery receipt\");\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n throw error;\n }\n}\n\nfunction fsyncDirectory(directory: string): void {\n if (process.platform === \"win32\") return;\n const fd = openSync(directory, \"r\");\n try {\n fsyncSync(fd);\n } finally {\n closeSync(fd);\n }\n}\n\nfunction publishRecord(path: string, content: string): string {\n const directory = dirname(path);\n const temporary = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n return path;\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nfunction writeOverflowBody(\n path: string,\n body: {\n text: string;\n resultBindings?: ResultBinding[];\n },\n): OverflowBodyRef {\n const content = `${JSON.stringify(body)}\\n`;\n const bytes = Buffer.byteLength(content, \"utf8\");\n if (bytes > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Coordination message body is too large\");\n const sha256 = createHash(\"sha256\").update(content).digest(\"hex\");\n try {\n const stat = lstatSync(path);\n if (!stat.isFile() || stat.size > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Unsafe existing coordination message body\");\n const fd = openSync(\n path,\n constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | constants.O_NONBLOCK,\n );\n let existing: Buffer;\n try {\n const current = fstatSync(fd);\n if (!current.isFile() || current.size > COORDINATION_BODY_MAX_BYTES)\n throw new Error(\"Unsafe existing coordination message body\");\n existing = Buffer.alloc(current.size);\n let offset = 0;\n while (offset < existing.length) {\n const count = readSync(\n fd,\n existing,\n offset,\n existing.length - offset,\n offset,\n );\n if (!count)\n throw new Error(\"Existing coordination message body is truncated\");\n offset += count;\n }\n if (fstatSync(fd).size !== current.size)\n throw new Error(\n \"Existing coordination message body changed while reading\",\n );\n } finally {\n closeSync(fd);\n }\n if (\n existing.length !== bytes ||\n createHash(\"sha256\").update(existing).digest(\"hex\") !== sha256\n )\n throw new Error(\"Coordination message ID already has a different body\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n publishRecord(path, content);\n }\n return { bytes, sha256 };\n}\n\nfunction readOverflowBody(\n path: string,\n ref: OverflowBodyRef,\n): {\n text: string;\n resultBindings?: ResultBinding[];\n} {\n if (\n !ref ||\n !Number.isInteger(ref.bytes) ||\n ref.bytes < 1 ||\n ref.bytes > COORDINATION_BODY_MAX_BYTES ||\n !/^[a-f0-9]{64}$/.test(ref.sha256)\n )\n throw new Error(\"Invalid coordination message body reference\");\n let fd: number | undefined;\n try {\n fd = openSync(\n path,\n constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | constants.O_NONBLOCK,\n );\n const stat = fstatSync(fd);\n if (!stat.isFile() || stat.size !== ref.bytes)\n throw new Error(\"Coordination message body size mismatch\");\n const bytes = Buffer.alloc(ref.bytes);\n let offset = 0;\n while (offset < bytes.length) {\n const count = readSync(fd, bytes, offset, bytes.length - offset, offset);\n if (!count) throw new Error(\"Coordination message body is truncated\");\n offset += count;\n }\n if (createHash(\"sha256\").update(bytes).digest(\"hex\") !== ref.sha256)\n throw new Error(\"Coordination message body integrity check failed\");\n const parsed: unknown = JSON.parse(\n new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes),\n );\n if (\n !parsed ||\n typeof parsed !== \"object\" ||\n Array.isArray(parsed) ||\n Object.keys(parsed).some(\n (key) => ![\"text\", \"resultBindings\"].includes(key),\n ) ||\n typeof (parsed as any).text !== \"string\" ||\n !(parsed as any).text.length ||\n ((parsed as any).resultBindings !== undefined &&\n (!Array.isArray((parsed as any).resultBindings) ||\n !(parsed as any).resultBindings.every(isResultBinding)))\n )\n throw new Error(\"Invalid coordination message body\");\n return parsed as { text: string; resultBindings?: ResultBinding[] };\n } catch (error) {\n throw new Error(\"Unable to read coordination message body\", {\n cause: error,\n });\n } finally {\n if (fd !== undefined) closeSync(fd);\n }\n}\n\nfunction withChiefMessageLock<T>(path: string, operation: () => T): T {\n const lock = `${path}.lock`;\n // Publish a verified PID/UUID owner so a crash-held lock can be reclaimed\n // only after its recorded PID no longer exists. Live, ambiguous, and\n // malformed locks fail closed and are retried by the caller.\n const lease = acquireProcessLock(lock, { name: \"Chief message lock\" });\n try {\n return operation();\n } finally {\n lease.release();\n }\n}\n\nfunction removeMalformedChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): Error[] {\n const path = chiefMessagePath(runtime, toSessionId, id);\n try {\n return withChiefMessageLock(path, () =>\n removeMalformedChiefMessageUnlocked(runtime, toSessionId, id),\n );\n } catch (error) {\n return [error instanceof Error ? error : new Error(String(error))];\n }\n}\n\nfunction removeMalformedChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): Error[] {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const errors: Error[] = [];\n try {\n // Establish the recovery marker before making the malformed record\n // disappear. If this cannot be made durable, retain the JSON record.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n } catch (error) {\n errors.push(error instanceof Error ? error : new Error(String(error)));\n return errors;\n }\n try {\n const claimed = join(\n dirname(path),\n `.${basename(path, \".json\")}.${randomUUID()}.cleanup`,\n );\n renameSync(path, claimed);\n fsyncDirectory(dirname(path));\n try {\n unlinkSync(claimed);\n fsyncDirectory(dirname(path));\n } catch (error) {\n try {\n renameSync(claimed, path);\n fsyncDirectory(dirname(path));\n } catch {}\n throw error;\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n // An unlink race is safe only after confirming that the JSON is gone.\n // The marker still applies back-pressure until its removal is durable.\n try {\n statSync(path);\n errors.push(\n new Error(\"Unable to confirm malformed Chief message removal\"),\n );\n return errors;\n } catch (confirmationError) {\n if ((confirmationError as NodeJS.ErrnoException).code !== \"ENOENT\") {\n errors.push(\n confirmationError instanceof Error\n ? confirmationError\n : new Error(String(confirmationError)),\n );\n return errors;\n }\n }\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (markerError) {\n if ((markerError as NodeJS.ErrnoException).code !== \"ENOENT\")\n errors.push(\n markerError instanceof Error\n ? markerError\n : new Error(String(markerError)),\n );\n }\n return errors;\n }\n errors.push(error instanceof Error ? error : new Error(String(error)));\n }\n if (errors.length === 0) {\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (markerError) {\n if ((markerError as NodeJS.ErrnoException).code !== \"ENOENT\")\n errors.push(\n markerError instanceof Error\n ? markerError\n : new Error(String(markerError)),\n );\n }\n }\n return errors;\n}\n\nfunction removeChiefMessageQuarantineUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n try {\n unlinkSync(`${path}.quarantine`);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n try {\n // The marker was removed before durability was established. Restore it\n // and only report success if the replacement is durable.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n } catch (recoveryError) {\n throw new Error(\"Unable to restore Chief message quarantine\", {\n cause: recoveryError,\n });\n }\n throw new Error(\"Unable to remove Chief message quarantine\", {\n cause: error,\n });\n }\n}\n\nexport function writeChiefMessage(\n record: ChiefMessageRecord,\n runtime = supervisionRuntime(),\n clearQuarantine = true,\n): string {\n if (!record.build)\n throw new Error(\"Coordination message build identity is required\");\n if (!validMessage(record) || record.bodyRef !== undefined)\n throw new Error(\"Invalid Chief message record\");\n return withChiefMessageLock(\n chiefMessagePath(runtime, record.toSessionId, record.id),\n () => writeChiefMessageUnlocked(record, runtime, clearQuarantine),\n );\n}\n\nfunction writeChiefMessageUnlocked(\n record: ChiefMessageRecord,\n runtime: SupervisionRuntime,\n clearQuarantine: boolean,\n): string {\n const directory = inboxFor(runtime, record.toSessionId);\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.inbox, { recursive: true, mode: 0o700 });\n chmodSync(runtime.inbox, 0o700);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(directory, 0o700);\n const path = chiefMessagePath(runtime, record.toSessionId, record.id);\n if (record.kind !== \"project_assignment\") {\n try {\n statSync(path);\n const existing = readChiefMessage(path);\n if (!isDeepStrictEqual(existing, record))\n throw new Error(\n \"Chief message ID already exists with a different payload\",\n );\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n const stored = compactChiefMessage(record, path);\n const temporary = join(directory, `.${record.id}.${randomUUID()}.tmp`);\n const content = `${JSON.stringify(stored)}\\n`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n // Replacing a quarantined ID is an explicit retry/reconciliation. Keep\n // the marker fail-closed until the replacement is durable, then release it.\n if (clearQuarantine) {\n const hadQuarantine = chiefMessageQuarantined(\n runtime,\n record.toSessionId,\n record.id,\n );\n try {\n unlinkSync(`${path}.quarantine`);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n fsyncDirectory(directory);\n } catch (error) {\n if (hadQuarantine) {\n try {\n quarantineChiefMessageUnlocked(\n runtime,\n record.toSessionId,\n record.id,\n );\n } catch (recoveryError) {\n throw new Error(\"Unable to restore Chief message quarantine\", {\n cause: recoveryError,\n });\n }\n }\n throw error;\n }\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n return path;\n}\n\nfunction conclusivelyMalformedChiefMessage(path: string): boolean {\n let content: string;\n try {\n if (statSync(path).size > COORDINATION_MESSAGE_MAX_BYTES) return true;\n content = readFileSync(path, \"utf8\");\n } catch {\n return false;\n }\n try {\n return !validMessage(JSON.parse(content));\n } catch {\n return true;\n }\n}\n\nfunction assertChiefMessageNotQuarantined(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n if (chiefMessageQuarantined(runtime, toSessionId, id))\n throw new Error(\"Chief message is quarantined\");\n}\n\nfunction readStoredChiefMessage(path: string): StoredChiefMessage {\n let size: number;\n try {\n size = statSync(path).size;\n } catch (error) {\n throw new Error(\"Unable to read Chief message\", { cause: error });\n }\n if (size > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"Chief message record is too large\");\n try {\n const parsed = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n assertMessage(parsed);\n return parsed as StoredChiefMessage;\n } catch (error) {\n if (error instanceof Error && /Chief message record/.test(error.message))\n throw error;\n throw new Error(\"Invalid Chief message record\", { cause: error });\n }\n}\n\nexport function readChiefMessage(path: string): ChiefMessageRecord {\n const parsed = readStoredChiefMessage(path);\n if (parsed.bodyRef) {\n const body = readOverflowBody(`${path}.body`, parsed.bodyRef);\n const logical = { ...parsed, ...body } as ChiefMessageRecord;\n delete (logical as any).bodyRef;\n if (!validMessage(logical)) throw new Error(\"Invalid Chief message body\");\n return logical;\n }\n return parsed as ChiefMessageRecord;\n}\n\nfunction allChiefMessagePaths(\n runtime: SupervisionRuntime,\n toSessionId: string,\n): string[] {\n const directory = inboxFor(runtime, toSessionId);\n let entries: string[];\n try {\n entries = readdirSync(directory).sort();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw new Error(\"Unable to scan Chief inbox\", { cause: error });\n }\n const paths = entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .map((entry) => join(directory, entry));\n // The directory scan parses all candidates; only the delivery batch is\n // bounded. Malformed UUID-named files are best-effort cleanup candidates\n // and may be deferred behind a full valid delivery batch.\n return paths\n .map((path): { path: string; record: StoredChiefMessage | undefined } => {\n try {\n const record = readStoredChiefMessage(path);\n return { path, record };\n } catch {\n return { path, record: undefined };\n }\n })\n .sort((a, b) => {\n if (!a.record || !b.record) return a.record ? -1 : b.record ? 1 : 0;\n return (\n a.record.createdAt - b.record.createdAt ||\n a.record.id.localeCompare(b.record.id)\n );\n })\n .map(({ path }) => path);\n}\n\nexport function listChiefMessagePaths(\n runtime: SupervisionRuntime,\n toSessionId: string,\n limit = COORDINATION_INBOX_SCAN_LIMIT,\n): string[] {\n if (!Number.isInteger(limit) || limit < 0)\n throw new Error(\"Invalid inbox limit\");\n return allChiefMessagePaths(runtime, toSessionId).slice(\n 0,\n Math.min(limit, COORDINATION_INBOX_SCAN_LIMIT),\n );\n}\n\nexport function removeChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n expected?: ChiefMessageRecord,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n withChiefMessageLock(path, () =>\n removeChiefMessageUnlocked(runtime, toSessionId, id, expected),\n );\n}\n\nfunction removeChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n expected?: ChiefMessageRecord,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const directory = dirname(path);\n const matchesExpected = (): boolean => {\n if (!expected) return true;\n try {\n const stored = readStoredChiefMessage(path);\n if ((expected as StoredChiefMessage).bodyRef)\n return isDeepStrictEqual(stored, expected);\n return isDeepStrictEqual(readChiefMessage(path), expected);\n } catch {\n return false;\n }\n };\n if (!matchesExpected())\n throw new Error(\"Chief message changed during removal\");\n // Establish recovery before making any record disappear. This also covers\n // direct callers, not only the inbox drain fallback.\n quarantineChiefMessageUnlocked(runtime, toSessionId, id);\n if (!matchesExpected())\n throw new Error(\"Chief message changed during removal\");\n try {\n const claimed = join(\n directory,\n `.${basename(path, \".json\")}.${randomUUID()}.cleanup`,\n );\n // Detach the exact path atomically. All same-ID writers use the same\n // narrow lock, so a replacement cannot become the object we delete.\n renameSync(path, claimed);\n fsyncDirectory(directory);\n try {\n unlinkSync(claimed);\n fsyncDirectory(directory);\n } catch (error) {\n try {\n renameSync(claimed, path);\n fsyncDirectory(directory);\n } catch {}\n throw error;\n }\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n throw new Error(\"Unable to remove Chief message\", { cause: error });\n }\n try {\n unlinkSync(`${path}.body`);\n fsyncDirectory(directory);\n } catch {}\n try {\n removeChiefMessageQuarantineUnlocked(runtime, toSessionId, id);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\n/** Persist an exclusion when a queued message cannot be removed safely. */\nexport function quarantineChiefMessage(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n withChiefMessageLock(path, () =>\n quarantineChiefMessageUnlocked(runtime, toSessionId, id),\n );\n}\n\nfunction quarantineChiefMessageUnlocked(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): void {\n const path = chiefMessagePath(runtime, toSessionId, id);\n const quarantine = `${path}.quarantine`;\n // This sidecar is separate from the JSON removal, so a crash between those\n // operations can leave the marker until a retry or explicit recovery;\n // all marker checks fail closed.\n let fd: number | undefined;\n try {\n try {\n fd = openSync(quarantine, \"wx\", 0o600);\n writeFileSync(fd, \"quarantined\\n\", \"utf8\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n fd = openSync(quarantine, process.platform === \"win32\" ? \"r+\" : \"r\");\n }\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n // Re-fsync the directory even for an existing marker so this call only\n // succeeds after the marker's presence is durably established.\n fsyncDirectory(dirname(quarantine));\n } finally {\n if (fd !== undefined) closeSync(fd);\n }\n}\n\nexport function chiefMessageQuarantined(\n runtime: SupervisionRuntime,\n toSessionId: string,\n id: string,\n): boolean {\n try {\n statSync(`${chiefMessagePath(runtime, toSessionId, id)}.quarantine`);\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n return true;\n }\n}\n\nfunction deliveredMessageContent(\n record: CoordinationMessageRecord,\n senderTarget?: string,\n): string {\n const prefix =\n record.kind === \"chief_message\"\n ? \"From your Chief: \"\n : record.kind === \"manager_message\"\n ? `From Manager${senderTarget ? ` ${senderTarget}` : \"\"}: `\n : record.kind === \"lead_message\"\n ? `From Lead${senderTarget ? ` ${senderTarget}` : \"\"}: `\n : `Peer message${senderTarget ? ` from ${senderTarget}` : \"\"}: `;\n const content =\n record.kind === \"project_assignment\"\n ? `Project assignment for branch ${record.branch}:\\n\\n${record.text}`\n : `${prefix}${record.text}`;\n return content;\n}\n\n/** Drain only this session's inbox. Files remain when Pi rejects delivery. */\nexport async function drainCoordinationInbox(\n options: ChiefInboxDrainOptions,\n): Promise<number> {\n let delivered = 0;\n let examined = 0;\n for (const path of allChiefMessagePaths(options.runtime, options.sessionId)) {\n if (examined >= COORDINATION_INBOX_SCAN_LIMIT) break;\n if (options.signal?.aborted) break;\n const id = basename(path, \".json\");\n if (\n UUID.test(id) &&\n chiefMessageQuarantined(options.runtime, options.sessionId, id)\n )\n continue;\n let stored: StoredChiefMessage;\n let record: ChiefMessageRecord;\n try {\n stored = readStoredChiefMessage(path);\n record = stored as ChiefMessageRecord;\n } catch {\n if (UUID.test(id) && conclusivelyMalformedChiefMessage(path)) {\n for (const cleanupError of removeMalformedChiefMessage(\n options.runtime,\n options.sessionId,\n id,\n ))\n try {\n await options.cleanupError?.(cleanupError);\n } catch {}\n }\n continue;\n }\n examined++;\n let token: unknown;\n const clearTransaction = async (): Promise<void> => {\n if (token === undefined) return;\n try {\n await options.transaction?.clear(token);\n } catch {\n // Clearing bookkeeping is best effort; the inbox record remains the\n // durable retry marker.\n }\n };\n try {\n token = await options.transaction?.begin(record);\n await options.transaction?.revalidate(token, \"before-authorization\");\n } catch {\n await clearTransaction();\n continue;\n }\n let deliverAs: \"steer\" | \"followUp\" | undefined;\n try {\n deliverAs = options.deliveryMode\n ? await options.deliveryMode(record)\n : \"followUp\";\n } catch {\n await clearTransaction();\n continue;\n }\n const wasAlreadyDelivered = options.isDelivered(record.id);\n if (!deliverAs && !wasAlreadyDelivered) {\n await clearTransaction();\n continue;\n }\n let authorized: boolean;\n try {\n authorized = await options.isAuthorized(record);\n } catch {\n await clearTransaction();\n continue;\n }\n if (!authorized) {\n try {\n await options.transaction?.revalidate(token, \"before-rejection\");\n await options.rejected?.(record);\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.transaction?.revalidate(token, \"before-rejected-remove\");\n } catch {\n // A shutdown or replacement wins over cleanup of this old record.\n await clearTransaction();\n continue;\n }\n try {\n quarantineChiefMessage(options.runtime, options.sessionId, record.id);\n removeChiefMessage(\n options.runtime,\n options.sessionId,\n record.id,\n record,\n );\n await options.transaction?.clear(token);\n } catch (cleanupError) {\n try {\n await options.cleanupError?.(cleanupError);\n } catch {}\n }\n await clearTransaction();\n continue;\n }\n if (!options.isDelivered(record.id)) {\n try {\n await options.transaction?.revalidate(token, \"before-send\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n // Authorization may have yielded while Pi persisted an earlier send.\n if (!options.isDelivered(record.id)) {\n if (stored.bodyRef) {\n try {\n const body = readOverflowBody(`${path}.body`, stored.bodyRef);\n record = { ...record, ...body } as ChiefMessageRecord;\n } catch {\n examined--;\n await options.cleanupError?.(\n new Error(\n `Unable to read overflow body for Chief message ${id}`,\n ),\n );\n await clearTransaction();\n continue;\n }\n }\n const senderTarget =\n options.senderTarget &&\n (record.kind === \"peer_message\" ||\n record.kind === \"lead_message\" ||\n record.kind === \"manager_message\")\n ? await options.senderTarget(record)\n : undefined;\n await options.sendMessage(\n {\n customType: `pi-herdsman-${record.kind}`,\n content: deliveredMessageContent(record, senderTarget),\n display: true,\n details: {\n id: record.id,\n leaseId: record.leaseId,\n fromSessionId: record.fromSessionId,\n toSessionId: record.toSessionId,\n leadSessionId: record.leadSessionId,\n ...(senderTarget ? { senderTarget } : {}),\n ...(record.branch ? { branch: record.branch } : {}),\n ...(record.kind === \"peer_message\"\n ? { digest: coordinationMessageDigest(record) }\n : {}),\n },\n },\n { deliverAs: deliverAs ?? \"followUp\", triggerTurn: true },\n record,\n );\n await options.transaction?.revalidate(token, \"after-send\");\n }\n } catch {\n await clearTransaction();\n continue;\n }\n if (!options.isDelivered(record.id)) {\n // Pi submission is not a persistence acknowledgement.\n await clearTransaction();\n continue;\n }\n if (!wasAlreadyDelivered) delivered += 1;\n try {\n await options.transaction?.revalidate(token, \"before-accepted\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.accepted?.(record);\n await options.transaction?.revalidate(token, \"after-accepted\");\n } catch {\n await clearTransaction();\n continue;\n }\n } else {\n try {\n if (!wasAlreadyDelivered) delivered += 1;\n await options.transaction?.revalidate(token, \"already-delivered\");\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.accepted?.(record);\n } catch {\n await clearTransaction();\n continue;\n }\n }\n try {\n assertChiefMessageNotQuarantined(\n options.runtime,\n options.sessionId,\n record.id,\n );\n await options.transaction?.revalidate(token, \"before-remove\");\n } catch {\n await clearTransaction();\n continue;\n }\n try {\n removeChiefMessage(options.runtime, options.sessionId, record.id, record);\n } catch (removalError) {\n try {\n await options.cleanupError?.(removalError);\n } catch {}\n await clearTransaction();\n continue;\n }\n try {\n await options.transaction?.revalidate(token, \"after-remove\");\n await options.transaction?.clear(token);\n } catch {\n // A shutdown or replacement wins over bookkeeping after removal.\n await clearTransaction();\n }\n }\n return delivered;\n}\n\nexport const coordinationMessagePath = chiefMessagePath;\nexport const readCoordinationMessage = readChiefMessage;\nexport const listCoordinationMessagePaths = listChiefMessagePaths;\nexport const writeCoordinationMessage = writeChiefMessage;\nexport const removeCoordinationMessage = removeChiefMessage;\nexport const coordinationMessageBytes = chiefMessageBytes;\n\nfunction socketPath(): string {\n const value = process.env.HERDR_SOCKET_PATH;\n if (!value) throw new Error(\"HERDR_SOCKET_PATH is required\");\n return value;\n}\n\nexport function supervisionRuntime(socket = socketPath()): SupervisionRuntime {\n if (!socket) throw new Error(\"HERDR_SOCKET_PATH is required\");\n const runtimeHash = createHash(\"sha256\").update(socket).digest(\"hex\");\n const root = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"supervision-v2\",\n runtimeHash,\n );\n return {\n root,\n lock: join(root, \"chief.lock\"),\n descriptor: join(root, \"chief.json\"),\n inbox: join(root, \"inbox\"),\n coordinators: join(root, \"coordinators\"),\n leads: join(root, \"coordinators\"),\n managers: join(root, \"managers\"),\n assignments: join(root, \"assignments\"),\n };\n}\n\nconst projectAuthorityLock = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"project-assignment-authority.lock\",\n);\n\nexport function projectAssignmentAuthorityLockPath(): string {\n return projectAuthorityLock;\n}\n\nfunction withProjectAssignmentLock<T>(operation: () => T): T {\n const lease = acquireProcessLock(projectAuthorityLock, {\n name: \"project assignment authority\",\n });\n try {\n const result = operation();\n if (result && typeof (result as { then?: unknown }).then === \"function\")\n throw new Error(\n \"Project assignment authority operation must be synchronous\",\n );\n return result;\n } finally {\n lease.release();\n }\n}\n\n/** Wait briefly for global authority, but keep every lock-held operation synchronous. */\nexport async function withProjectAssignmentAuthorityWait<T>(\n operation: () => T,\n signal?: AbortSignal,\n onOccupied?: () => void,\n): Promise<T> {\n // Match the existing project-lock contention budget; callers fail closed after brief contention.\n const deadline = Date.now() + 2_000;\n while (true) {\n signal?.throwIfAborted();\n let lease: ReturnType<typeof acquireProcessLock>;\n try {\n lease = acquireProcessLock(projectAuthorityLock, {\n name: \"project assignment authority\",\n });\n } catch (error) {\n if (!(error instanceof ProcessLockOccupiedError)) throw error;\n onOccupied?.();\n const remaining = deadline - Date.now();\n if (remaining <= 0) throw error;\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(done, Math.min(25, remaining));\n function done() {\n signal?.removeEventListener(\"abort\", aborted);\n resolve();\n }\n function aborted() {\n clearTimeout(timer);\n signal?.removeEventListener(\"abort\", aborted);\n reject(signal?.reason ?? new Error(\"Operation aborted\"));\n }\n signal?.addEventListener(\"abort\", aborted, { once: true });\n if (signal?.aborted) aborted();\n });\n continue;\n }\n try {\n const result = operation();\n if (result && typeof (result as { then?: unknown }).then === \"function\")\n throw new Error(\n \"Project assignment authority operation must be synchronous\",\n );\n return result;\n } finally {\n lease.release();\n }\n }\n}\n\n/** Run a synchronous final action against the exact branch assignment under global authority. */\nexport function withCurrentProjectAssignment<T>(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n operation: (assignment: ProjectAssignment | undefined) => T,\n): T {\n return withProjectAssignmentLock(() =>\n operation(readProjectAssignment(runtime, repoKey, branch)),\n );\n}\n\nexport type PeerRuntime = SupervisionRuntime & {\n peers: string;\n};\n\nexport type PeerRecord = Readonly<{\n version: 2;\n build?: RuntimeBuild;\n role?: PeerRole;\n sessionKind: \"ordinary\" | \"managed\";\n piSessionId: string;\n paneId: string;\n tabId: string;\n workspaceId: string;\n socket: string;\n group?: PeerGroup | null;\n name?: string;\n cwd?: string;\n repo?: string;\n branch?: string;\n workspaceLabel?: string;\n claim: ProcessLockClaim;\n updatedAt: number;\n}>;\nexport type PeerLeadRecord = PeerRecord;\n\nconst PEER_LEAD_RECORD_MAX_BYTES = 4096;\n\nexport function peerRuntime(_socket?: string): PeerRuntime {\n const root = join(herdsmanDataRoot(), \"runtime\", \"peers-v2\");\n return {\n root,\n lock: join(root, \"chief.lock\"),\n descriptor: join(root, \"chief.json\"),\n inbox: join(root, \"inbox\"),\n coordinators: join(root, \"coordinators\"),\n leads: join(root, \"coordinators\"),\n managers: join(root, \"managers\"),\n assignments: join(root, \"assignments\"),\n peers: join(root, \"peers\"),\n };\n}\n\nfunction peerDirectory(runtime: PeerRuntime): string {\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.peers, { recursive: true, mode: 0o700 });\n chmodSync(runtime.peers, 0o700);\n return runtime.peers;\n}\n\nexport function peerLeadRecordPath(\n runtime: PeerRuntime,\n piSessionId: string,\n): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid peer session ID\");\n return join(runtime.peers, peerLeadRecordFilename(piSessionId));\n}\n\nfunction peerLeadRecordFilename(piSessionId: string): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid peer session ID\");\n return `${createHash(\"sha256\").update(piSessionId).digest(\"hex\")}.json`;\n}\n\nexport function peerLeadLockPath(\n runtime: PeerRuntime,\n piSessionId: string,\n): string {\n return `${peerLeadRecordPath(runtime, piSessionId)}.lock`;\n}\n\nfunction validPeerLeadRecord(value: unknown): value is PeerLeadRecord {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const metadata = [\"name\", \"cwd\", \"repo\", \"branch\", \"workspaceLabel\"];\n return (\n Object.keys(record).every((key) =>\n [\n \"version\",\n \"build\",\n \"role\",\n \"sessionKind\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"socket\",\n \"group\",\n \"claim\",\n \"updatedAt\",\n ...metadata,\n ].includes(key),\n ) &&\n [\n \"version\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"socket\",\n \"claim\",\n \"updatedAt\",\n ].every((key) => Object.hasOwn(record, key)) &&\n record.version === 2 &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n (record.role === undefined ||\n record.role === \"lead\" ||\n record.role === \"manager\") &&\n (record.sessionKind === \"ordinary\" || record.sessionKind === \"managed\") &&\n validSession(record.piSessionId) &&\n validNativeIdentity(record.paneId) &&\n validNativeIdentity(record.tabId) &&\n validNativeIdentity(record.workspaceId) &&\n typeof record.socket === \"string\" &&\n record.socket.length > 0 &&\n record.socket.length <= 4096 &&\n (record.group === undefined ||\n record.group === null ||\n (!!record.group &&\n typeof record.group === \"object\" &&\n Object.keys(record.group).length === 2 &&\n validNativeIdentity(\n (record.group as Record<string, unknown>).repoKey,\n ) &&\n validNativeIdentity(\n (record.group as Record<string, unknown>).primaryWorkspaceId,\n ))) &&\n metadata.every(\n (key) => !Object.hasOwn(record, key) || validNativeIdentity(record[key]),\n ) &&\n isProcessLockClaim(record.claim) &&\n Number.isInteger(record.updatedAt) &&\n (record.updatedAt as number) >= 0\n );\n}\n\nfunction livePeerClaim(\n runtime: PeerRuntime,\n piSessionId: string,\n): ProcessLockClaim {\n return readLiveProcessLock(peerLeadLockPath(runtime, piSessionId));\n}\n\nexport function samePeerLeadRecord(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n actual.version === expected.version &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.sessionKind === expected.sessionKind &&\n (actual.role ?? \"lead\") === (expected.role ?? \"lead\") &&\n actual.piSessionId === expected.piSessionId &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.socket === expected.socket &&\n JSON.stringify(actual.group) === JSON.stringify(expected.group) &&\n actual.name === expected.name &&\n actual.cwd === expected.cwd &&\n actual.repo === expected.repo &&\n actual.branch === expected.branch &&\n actual.workspaceLabel === expected.workspaceLabel &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.updatedAt === expected.updatedAt\n );\n}\n\nexport function samePeerLeadGeneration(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n actual.piSessionId === expected.piSessionId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id\n );\n}\n\n/** Authorization provenance, excluding presentation metadata. */\nexport function samePeerLeadAuthority(\n actual: PeerLeadRecord,\n expected: PeerLeadRecord,\n): boolean {\n return (\n samePeerLeadGeneration(actual, expected) &&\n actual.sessionKind === expected.sessionKind &&\n (actual.role ?? \"lead\") === (expected.role ?? \"lead\") &&\n actual.socket === expected.socket &&\n actual.workspaceId === expected.workspaceId &&\n isDeepStrictEqual(actual.group, expected.group)\n );\n}\n\nexport function readPeerLeadRecord(\n runtime: PeerRuntime,\n piSessionId: string,\n): PeerLeadRecord | undefined {\n const path = peerLeadRecordPath(runtime, piSessionId);\n let value: unknown;\n try {\n const text = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(text, \"utf8\") > PEER_LEAD_RECORD_MAX_BYTES)\n throw new Error(\"peer lead record too large\");\n value = JSON.parse(text);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw new Error(\"Unable to read peer lead record\", { cause: error });\n }\n if (!validPeerLeadRecord(value) || value.piSessionId !== piSessionId)\n throw new Error(\"Unable to read peer lead record\");\n const claim = livePeerClaim(runtime, piSessionId);\n if (claim.pid !== value.claim.pid || claim.id !== value.claim.id)\n throw new Error(\"Peer lead process-lock generation changed\");\n return value;\n}\n\nexport function writePeerLeadRecord(\n runtime: PeerRuntime,\n record: PeerLeadRecord,\n): string {\n if (!record.build) throw new Error(\"Peer lead build identity is required\");\n if (!validPeerLeadRecord(record)) throw new Error(\"Invalid peer lead record\");\n const live = livePeerClaim(runtime, record.piSessionId);\n if (live.pid !== record.claim.pid || live.id !== record.claim.id)\n throw new Error(\"Peer lead process-lock generation changed\");\n peerDirectory(runtime);\n const path = peerLeadRecordPath(runtime, record.piSessionId);\n const content = `${JSON.stringify(record)}\\n`;\n if (Buffer.byteLength(content, \"utf8\") > PEER_LEAD_RECORD_MAX_BYTES)\n throw new Error(\"Peer lead record is too large\");\n return publishRecord(path, content);\n}\n\nexport function removePeerLeadRecord(\n runtime: PeerRuntime,\n piSessionId: string,\n expected?: PeerLeadRecord,\n): void {\n const path = peerLeadRecordPath(runtime, piSessionId);\n try {\n if (expected) {\n const current = readPeerLeadRecord(runtime, piSessionId);\n if (!current || !samePeerLeadRecord(current, expected)) return;\n }\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nexport function listPeerLeadRecords(\n runtime: PeerRuntime = peerRuntime(),\n): PeerLeadRecord[] {\n let entries: string[];\n try {\n entries = readdirSync(runtime.peers);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw new Error(\"Unable to scan peer lead records\", { cause: error });\n }\n return entries\n .filter((entry) => /^[0-9a-f]{64}\\.json$/.test(entry))\n .sort()\n .flatMap((entry) => {\n try {\n const path = join(runtime.peers, entry);\n if (statSync(path).size > PEER_LEAD_RECORD_MAX_BYTES) return [];\n const text = readFileSync(path, \"utf8\");\n const value = JSON.parse(text);\n if (\n !validPeerLeadRecord(value) ||\n peerLeadRecordFilename(value.piSessionId) !== entry\n )\n return [];\n const record = readPeerLeadRecord(runtime, value.piSessionId);\n return record ? [record] : [];\n } catch {\n return [];\n }\n });\n}\n\nfunction validDescriptor(value: unknown): value is ChiefDescriptor {\n if (!value || typeof value !== \"object\") return false;\n const record = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"leaseId\",\n \"claim\",\n \"piSessionId\",\n \"paneId\",\n \"workspaceId\",\n \"createdAt\",\n ];\n const optional = [\"tabId\", \"piSessionFile\", \"build\"];\n return (\n Object.keys(record).every(\n (key) => keys.includes(key) || optional.includes(key),\n ) &&\n Object.keys(record).length >= keys.length &&\n keys.every((key) => Object.hasOwn(record, key)) &&\n record.version === 1 &&\n (record.build === undefined || isRuntimeBuild(record.build)) &&\n typeof record.leaseId === \"string\" &&\n /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(\n record.leaseId,\n ) &&\n isProcessLockClaim(record.claim) &&\n typeof record.piSessionId === \"string\" &&\n record.piSessionId.length > 0 &&\n record.piSessionId.length <= 512 &&\n (record.piSessionFile === undefined ||\n (typeof record.piSessionFile === \"string\" &&\n record.piSessionFile.length > 0)) &&\n typeof record.paneId === \"string\" &&\n record.paneId.length > 0 &&\n record.paneId.length <= 512 &&\n (record.tabId === undefined ||\n (typeof record.tabId === \"string\" &&\n record.tabId.length > 0 &&\n record.tabId.length <= 512)) &&\n typeof record.workspaceId === \"string\" &&\n record.workspaceId.length > 0 &&\n record.workspaceId.length <= 512 &&\n typeof record.createdAt === \"number\" &&\n Number.isInteger(record.createdAt) &&\n record.createdAt >= 0\n );\n}\n\nexport function readChiefDescriptor(\n path = supervisionRuntime().descriptor,\n): ChiefDescriptor {\n let parsed: unknown;\n try {\n const content = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(content, \"utf8\") > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"descriptor too large\");\n parsed = JSON.parse(content);\n } catch (error) {\n throw new Error(\"Unable to verify Chief descriptor\", { cause: error });\n }\n if (!validDescriptor(parsed))\n throw new Error(\"Unable to verify Chief descriptor\");\n return parsed;\n}\n\nexport function chiefLeaseIsHeld(runtime: SupervisionRuntime): boolean {\n try {\n const claim = readLiveProcessLock(runtime.lock, \"Chief supervision lease\");\n const descriptor = readChiefDescriptor(runtime.descriptor);\n return (\n descriptor.claim.pid === claim.pid && descriptor.claim.id === claim.id\n );\n } catch {\n return false;\n }\n}\n\nfunction writeDescriptor(\n path: string,\n descriptor: ChiefDescriptor | ManagerDescriptor,\n): void {\n const temporary = join(\n dirname(path),\n `.${basename(path)}.${randomUUID()}.tmp`,\n );\n const content = `${JSON.stringify(descriptor)}\\n`;\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n chmodSync(temporary, 0o600);\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(dirname(path));\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function sameChiefDescriptor(\n actual: ChiefDescriptor,\n expected: ChiefDescriptor,\n): boolean {\n return (\n actual.leaseId === expected.leaseId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.piSessionId === expected.piSessionId &&\n actual.piSessionFile === expected.piSessionFile &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.createdAt === expected.createdAt\n );\n}\n\nexport function claimChiefLease(identity: ChiefIdentity): ChiefLease {\n if (\n !identity ||\n !isRuntimeBuild(identity.build) ||\n typeof identity.piSessionId !== \"string\" ||\n !identity.piSessionId ||\n identity.piSessionId.length > 512 ||\n (identity.piSessionFile !== undefined &&\n (typeof identity.piSessionFile !== \"string\" ||\n !identity.piSessionFile)) ||\n typeof identity.paneId !== \"string\" ||\n !identity.paneId ||\n identity.paneId.length > 512 ||\n (identity.tabId !== undefined &&\n (typeof identity.tabId !== \"string\" ||\n !identity.tabId ||\n identity.tabId.length > 512)) ||\n typeof identity.workspaceId !== \"string\" ||\n !identity.workspaceId ||\n identity.workspaceId.length > 512 ||\n (identity.createdAt !== undefined &&\n (typeof identity.createdAt !== \"number\" ||\n !Number.isInteger(identity.createdAt) ||\n identity.createdAt < 0))\n )\n throw new Error(\"Invalid Chief identity\");\n const runtime = supervisionRuntime();\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.inbox, { recursive: true, mode: 0o700 });\n chmodSync(runtime.inbox, 0o700);\n const lease = acquireProcessLock(runtime.lock, {\n name: \"Chief supervision lease\",\n });\n const descriptor: ChiefDescriptor = {\n version: 1,\n build: identity.build,\n leaseId: randomUUID(),\n claim: lease.claim,\n piSessionId: identity.piSessionId,\n ...(identity.piSessionFile !== undefined\n ? { piSessionFile: identity.piSessionFile }\n : {}),\n paneId: identity.paneId,\n ...(identity.tabId ? { tabId: identity.tabId } : {}),\n workspaceId: identity.workspaceId,\n createdAt: identity.createdAt ?? Date.now(),\n };\n try {\n writeDescriptor(runtime.descriptor, descriptor);\n } catch (error) {\n lease.release();\n throw error;\n }\n let released = false;\n return {\n descriptor,\n runtime,\n release: () => {\n if (released) return;\n released = true;\n try {\n if (\n sameChiefDescriptor(\n readChiefDescriptor(runtime.descriptor),\n descriptor,\n )\n )\n unlinkSync(runtime.descriptor);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n // A malformed or replaced descriptor is not ours to remove.\n }\n } finally {\n lease.release();\n }\n },\n };\n}\n\nexport type ManagerDescriptor = {\n version: 1;\n build?: RuntimeBuild;\n leaseId: string;\n claim: ProcessLockClaim;\n piSessionId: string;\n piSessionFile?: string;\n paneId: string;\n tabId: string;\n workspaceId: string;\n repoKey: string;\n createdAt: number;\n};\nexport type ManagerIdentity = Pick<\n ManagerDescriptor,\n | \"piSessionId\"\n | \"piSessionFile\"\n | \"paneId\"\n | \"tabId\"\n | \"workspaceId\"\n | \"repoKey\"\n> & { build: RuntimeBuild; createdAt?: number };\nexport type ManagerLease = {\n descriptor: ManagerDescriptor;\n runtime: SupervisionRuntime;\n release: () => void;\n};\nexport type ManagerDescriptorStatus = Readonly<{\n descriptor: ManagerDescriptor;\n live: boolean;\n}>;\n\nexport function managerDescriptorPath(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): string {\n if (!validNativeIdentity(workspaceId))\n throw new Error(\"Invalid Manager workspace ID\");\n return join(\n runtime.managers,\n `${createHash(\"sha256\").update(workspaceId).digest(\"hex\")}.json`,\n );\n}\n\nfunction validManagerDescriptor(value: unknown): value is ManagerDescriptor {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n const keys = [\n \"version\",\n \"leaseId\",\n \"claim\",\n \"piSessionId\",\n \"paneId\",\n \"tabId\",\n \"workspaceId\",\n \"repoKey\",\n \"createdAt\",\n ];\n return (\n Object.keys(r).every(\n (key) => keys.includes(key) || key === \"piSessionFile\" || key === \"build\",\n ) &&\n keys.every((key) => Object.hasOwn(r, key)) &&\n r.version === 1 &&\n (r.build === undefined || isRuntimeBuild(r.build)) &&\n UUID.test(String(r.leaseId)) &&\n isProcessLockClaim(r.claim) &&\n validSession(r.piSessionId) &&\n (r.piSessionFile === undefined ||\n (typeof r.piSessionFile === \"string\" && r.piSessionFile.length > 0)) &&\n validNativeIdentity(r.paneId) &&\n validNativeIdentity(r.tabId) &&\n validNativeIdentity(r.workspaceId) &&\n validNativeIdentity(r.repoKey) &&\n Number.isInteger(r.createdAt) &&\n (r.createdAt as number) >= 0\n );\n}\n\nexport function sameManagerDescriptor(\n actual: ManagerDescriptor,\n expected: ManagerDescriptor,\n): boolean {\n return (\n actual.version === expected.version &&\n actual.leaseId === expected.leaseId &&\n sameRuntimeBuildEvidence(actual.build, expected.build) &&\n actual.claim.pid === expected.claim.pid &&\n actual.claim.id === expected.claim.id &&\n actual.piSessionId === expected.piSessionId &&\n actual.piSessionFile === expected.piSessionFile &&\n actual.paneId === expected.paneId &&\n actual.tabId === expected.tabId &&\n actual.workspaceId === expected.workspaceId &&\n actual.repoKey === expected.repoKey &&\n actual.createdAt === expected.createdAt\n );\n}\n\nexport function readManagerDescriptorStatus(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): ManagerDescriptorStatus | undefined {\n const path = managerDescriptorPath(runtime, workspaceId);\n const lockPath = `${path}.lock`;\n let content: string;\n try {\n if (statSync(path).size > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"descriptor too large\");\n content = readFileSync(path, \"utf8\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n try {\n if (!statSync(lockPath, { throwIfNoEntry: false })) return undefined;\n } catch (lockError) {\n throw new Error(\"Unable to verify Manager descriptor\", {\n cause: lockError,\n });\n }\n }\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n let descriptor: unknown;\n try {\n descriptor = JSON.parse(content);\n } catch (error) {\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n if (\n !validManagerDescriptor(descriptor) ||\n descriptor.workspaceId !== workspaceId\n )\n throw new Error(\"Unable to verify Manager descriptor\");\n let status: ReturnType<typeof readProcessLockStatus>;\n try {\n status = readProcessLockStatus(lockPath, \"Manager supervision lease\");\n } catch (error) {\n throw new Error(\"Unable to verify Manager descriptor\", { cause: error });\n }\n if (\n status.claim.pid !== descriptor.claim.pid ||\n status.claim.id !== descriptor.claim.id\n )\n throw new Error(\"Manager process-lock generation changed\");\n return { descriptor, live: status.live };\n}\n\nexport function readManagerDescriptor(\n runtime: SupervisionRuntime,\n workspaceId: string,\n): ManagerDescriptor | undefined {\n const status = readManagerDescriptorStatus(runtime, workspaceId);\n if (!status) return undefined;\n if (!status.live)\n throw new Error(\"Unable to verify Manager supervision lease\");\n return status.descriptor;\n}\n\nexport function listManagerDescriptors(\n runtime = supervisionRuntime(),\n strict = false,\n): ManagerDescriptor[] {\n let entries: string[];\n try {\n entries = readdirSync(runtime.managers);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => /^[0-9a-f]{64}\\.json$/.test(entry))\n .sort()\n .flatMap((entry) => {\n try {\n const path = join(runtime.managers, entry);\n if (statSync(path).size > CHIEF_DESCRIPTOR_MAX_BYTES)\n throw new Error(\"Manager descriptor too large\");\n const candidate: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !validManagerDescriptor(candidate) ||\n basename(managerDescriptorPath(runtime, candidate.workspaceId)) !==\n entry\n )\n throw new Error(\"Invalid Manager descriptor\");\n const status = readManagerDescriptorStatus(\n runtime,\n candidate.workspaceId,\n );\n return status?.live ? [status.descriptor] : [];\n } catch (error) {\n if (strict) throw error;\n return [];\n }\n });\n}\n\nexport function claimManagerLease(\n identity: ManagerIdentity,\n runtime = supervisionRuntime(),\n): ManagerLease {\n if (\n !identity ||\n !isRuntimeBuild(identity.build) ||\n !validSession(identity.piSessionId) ||\n (identity.piSessionFile !== undefined &&\n (typeof identity.piSessionFile !== \"string\" ||\n !identity.piSessionFile)) ||\n !validNativeIdentity(identity.paneId) ||\n !validNativeIdentity(identity.tabId) ||\n !validNativeIdentity(identity.workspaceId) ||\n !validNativeIdentity(identity.repoKey) ||\n (identity.createdAt !== undefined &&\n (!Number.isInteger(identity.createdAt) || identity.createdAt < 0))\n )\n throw new Error(\"Invalid Manager identity\");\n mkdirSync(runtime.managers, { recursive: true, mode: 0o700 });\n chmodSync(runtime.managers, 0o700);\n const path = managerDescriptorPath(runtime, identity.workspaceId);\n const lease = acquireProcessLock(`${path}.lock`, {\n name: \"Manager supervision lease\",\n });\n const descriptor: ManagerDescriptor = {\n version: 1,\n build: identity.build,\n leaseId: randomUUID(),\n claim: lease.claim,\n piSessionId: identity.piSessionId,\n ...(identity.piSessionFile !== undefined\n ? { piSessionFile: identity.piSessionFile }\n : {}),\n paneId: identity.paneId,\n tabId: identity.tabId,\n workspaceId: identity.workspaceId,\n repoKey: identity.repoKey,\n createdAt: identity.createdAt ?? Date.now(),\n };\n try {\n writeDescriptor(path, descriptor);\n } catch (error) {\n lease.release();\n throw error;\n }\n let released = false;\n return {\n descriptor,\n runtime,\n release: () => {\n if (released) return;\n released = true;\n try {\n const current = readManagerDescriptor(runtime, identity.workspaceId);\n if (current && sameManagerDescriptor(current, descriptor)) {\n unlinkSync(path);\n fsyncDirectory(runtime.managers);\n }\n } catch {\n /* A replaced or malformed descriptor is not ours to remove. */\n } finally {\n lease.release();\n }\n },\n };\n}\n\nexport type ProjectAssignment = Readonly<{\n version: 2;\n id: string;\n repoKey: string;\n branch: string;\n text: string;\n checkoutPath?: string;\n piSessionFile?: string;\n resultBindings?: ResultBinding[];\n requiredEvidence?: RequiredEvidence[];\n currentEvidenceIds?: string[];\n gitBaselineSha?: string;\n}>;\n\nexport const PROJECT_ASSIGNMENT_MAX_BYTES = 1024 * 1024;\nconst PROJECT_ASSIGNMENT_FILE_MAX_BYTES = PROJECT_ASSIGNMENT_MAX_BYTES * 2;\n\nexport function projectAssignmentBytes(assignment: ProjectAssignment): number {\n const { checkoutPath: _, piSessionFile: __, ...payload } = assignment;\n return Buffer.byteLength(`${JSON.stringify(payload)}\\n`, \"utf8\");\n}\n\nexport function projectAssignmentPath(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): string {\n if (!validNativeIdentity(repoKey) || !validNativeIdentity(branch))\n throw new Error(\"Invalid project assignment identity\");\n return join(\n runtime.assignments,\n createHash(\"sha256\").update(repoKey).digest(\"hex\"),\n `${createHash(\"sha256\").update(branch).digest(\"hex\")}.json`,\n );\n}\n\nfunction validProjectAssignment(value: unknown): value is ProjectAssignment {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n const required = [\"version\", \"id\", \"repoKey\", \"branch\", \"text\"];\n const optional = [\n \"checkoutPath\",\n \"piSessionFile\",\n \"resultBindings\",\n \"requiredEvidence\",\n \"currentEvidenceIds\",\n \"gitBaselineSha\",\n ];\n return (\n required.every((key) => Object.hasOwn(r, key)) &&\n Object.keys(r).every(\n (key) => required.includes(key) || optional.includes(key),\n ) &&\n Object.keys(r).length >= required.length &&\n r.version === 2 &&\n UUID.test(String(r.id)) &&\n validNativeIdentity(r.repoKey) &&\n validNativeIdentity(r.branch) &&\n typeof r.text === \"string\" &&\n r.text.length > 0 &&\n (r.gitBaselineSha === undefined ||\n (typeof r.gitBaselineSha === \"string\" &&\n /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u.test(r.gitBaselineSha))) &&\n (r.checkoutPath === undefined ||\n (typeof r.checkoutPath === \"string\" &&\n isAbsolute(r.checkoutPath) &&\n normalize(r.checkoutPath) === r.checkoutPath &&\n !/[\\u0000-\\u001f]/.test(r.checkoutPath))) &&\n (r.piSessionFile === undefined ||\n (typeof r.piSessionFile === \"string\" && r.piSessionFile.length > 0)) &&\n (r.resultBindings === undefined ||\n (Array.isArray(r.resultBindings) &&\n r.resultBindings.every(isResultBinding))) &&\n (r.requiredEvidence === undefined ||\n (Array.isArray(r.requiredEvidence) &&\n r.requiredEvidence.every(isRequiredEvidence) &&\n r.requiredEvidence.every(\n (evidence) =>\n \"result\" in evidence || evidence.sourceAssignmentId === r.id,\n ) &&\n new Set(r.requiredEvidence.map((evidence) => evidence.id)).size ===\n r.requiredEvidence.length)) &&\n (r.currentEvidenceIds === undefined ||\n (Array.isArray(r.currentEvidenceIds) &&\n new Set(r.currentEvidenceIds).size === r.currentEvidenceIds.length &&\n r.currentEvidenceIds.every(\n (id) =>\n typeof id === \"string\" &&\n (r.requiredEvidence as RequiredEvidence[] | undefined)?.some(\n (evidence) => evidence.id === id,\n ),\n )))\n );\n}\n\nexport function writeProjectAssignment(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n withProjectAssignmentLock(() =>\n writeProjectAssignmentUnlocked(runtime, assignment),\n );\n}\n\nexport function writeProjectAssignmentAfter(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n assignment: ProjectAssignment,\n signal?: AbortSignal,\n verifyAuthority?: () => void,\n onOccupied?: () => void,\n): Promise<void> {\n return withProjectAssignmentAuthorityWait(\n () => {\n verifyAuthority?.();\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || !isDeepStrictEqual(current, expected))\n throw new Error(\n \"Project assignment changed before required evidence was updated\",\n );\n writeProjectAssignmentUnlocked(runtime, assignment);\n },\n signal,\n onOccupied,\n );\n}\n\nfunction writeProjectAssignmentUnlocked(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n assignment = upgradeProjectAssignmentEvidence(assignment);\n if (!validProjectAssignment(assignment))\n throw new Error(\"Invalid project assignment\");\n const content = `${JSON.stringify(assignment)}\\n`;\n if (\n projectAssignmentBytes(assignment) > PROJECT_ASSIGNMENT_MAX_BYTES ||\n Buffer.byteLength(content, \"utf8\") > PROJECT_ASSIGNMENT_FILE_MAX_BYTES\n )\n throw new Error(\"Project assignment is too large\");\n const path = projectAssignmentPath(\n runtime,\n assignment.repoKey,\n assignment.branch,\n );\n const directory = dirname(path);\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n chmodSync(runtime.assignments, 0o700);\n chmodSync(directory, 0o700);\n const temporary = join(directory, `.${assignment.id}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, content, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nfunction upgradeProjectAssignmentEvidence(\n assignment: ProjectAssignment,\n): ProjectAssignment {\n if (!assignment.requiredEvidence?.length) return assignment;\n const requiredEvidence = assignment.requiredEvidence.map(\n upgradeAndVerifyRequiredEvidence,\n );\n if (\n requiredEvidence.every(\n (evidence, index) => evidence === assignment.requiredEvidence![index],\n )\n )\n return assignment;\n return {\n ...assignment,\n requiredEvidence,\n };\n}\n\n/** Persist legacy snapshot refs under the assignment authority lock before a resume advertises them. */\nexport function migrateProjectAssignmentEvidence(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n expectedAssignmentId?: string,\n): ProjectAssignment | undefined {\n return withProjectAssignmentLock(() => {\n const current = readProjectAssignment(runtime, repoKey, branch);\n if (\n !current ||\n (expectedAssignmentId && current.id !== expectedAssignmentId)\n )\n return undefined;\n const upgraded = upgradeProjectAssignmentEvidence(current);\n if (upgraded !== current) writeProjectAssignmentUnlocked(runtime, upgraded);\n return upgraded;\n });\n}\n\nexport function migrateProjectAssignmentEvidenceAfter(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n signal?: AbortSignal,\n): Promise<ProjectAssignment | undefined> {\n return withProjectAssignmentAuthorityWait(() => {\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || !isDeepStrictEqual(current, expected)) return undefined;\n const upgraded = upgradeProjectAssignmentEvidence(current);\n if (upgraded !== current) writeProjectAssignmentUnlocked(runtime, upgraded);\n return upgraded;\n }, signal);\n}\n\nexport function readProjectAssignment(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectAssignment | undefined {\n const path = projectAssignmentPath(runtime, repoKey, branch);\n return readProjectAssignmentFile(path, repoKey, branch);\n}\n\nfunction readProjectAssignmentFile(\n path: string,\n repoKey: string | undefined,\n branch?: string,\n pending = false,\n): ProjectAssignment | undefined {\n let value: unknown;\n try {\n const file = lstatSync(path);\n if (!file.isFile() || file.isSymbolicLink())\n throw new Error(\"invalid file\");\n if (file.size > PROJECT_ASSIGNMENT_FILE_MAX_BYTES)\n throw new Error(\"file is too large\");\n value = JSON.parse(readFileSync(path, \"utf8\"));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n const reason =\n error instanceof SyntaxError\n ? \"invalid JSON\"\n : error instanceof Error && error.message === \"file is too large\"\n ? error.message\n : `read failed${safeFilesystemCode(error)}`;\n throw projectAssignmentReadError(path, reason);\n }\n if (!validProjectAssignment(value))\n throw projectAssignmentReadError(path, \"invalid assignment schema\");\n try {\n for (const evidence of value.requiredEvidence ?? [])\n if (!(\"result\" in evidence) && evidence.ref)\n verifySemanticEvidenceReservation(evidence.id, evidence.ref);\n } catch {\n throw projectAssignmentReadError(path, \"invalid evidence identity\");\n }\n if (projectAssignmentBytes(value) > PROJECT_ASSIGNMENT_MAX_BYTES)\n throw projectAssignmentReadError(path, \"assignment payload is too large\");\n if (\n (repoKey !== undefined && value.repoKey !== repoKey) ||\n basename(dirname(path)) !==\n createHash(\"sha256\").update(value.repoKey).digest(\"hex\") ||\n (branch !== undefined && value.branch !== branch) ||\n basename(path) !==\n `${createHash(\"sha256\").update(value.branch).digest(\"hex\")}${pending ? `.${value.id}` : \"\"}.json`\n )\n throw projectAssignmentReadError(path, \"assignment identity mismatch\");\n return value;\n}\n\nfunction safeFilesystemCode(error: unknown): string {\n const code = (error as NodeJS.ErrnoException)?.code;\n return typeof code === \"string\" && /^[A-Z0-9_]{1,32}$/.test(code)\n ? ` (${code})`\n : \"\";\n}\n\nfunction projectAssignmentReadError(path: string, reason: string): Error {\n return new Error(`Unable to read project assignment ${path}: ${reason}`);\n}\n\nexport function listProjectAssignments(\n runtime: SupervisionRuntime,\n repoKey: string,\n): ProjectAssignment[] {\n const directory = dirname(projectAssignmentPath(runtime, repoKey, \"lookup\"));\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => /^[a-f0-9]{64}\\.json$/.test(entry))\n .map((entry) => {\n const assignment = readProjectAssignmentFile(\n join(directory, entry),\n repoKey,\n );\n if (!assignment)\n throw projectAssignmentReadError(\n join(directory, entry),\n \"file disappeared while listing\",\n );\n return assignment;\n })\n .sort((a, b) => a.branch.localeCompare(b.branch));\n}\n\nexport function findProjectAssignmentBySession(\n runtime: SupervisionRuntime,\n repoKey: string,\n sessionId: string,\n): ProjectAssignment[] {\n return listProjectAssignments(runtime, repoKey).filter(\n (assignment) => assignment.id === sessionId,\n );\n}\n\nexport function removeProjectAssignment(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): void {\n withProjectAssignmentLock(() =>\n removeProjectAssignmentUnlocked(runtime, repoKey, branch),\n );\n}\n\n// Caller holds the exact branch lock; the global lock serializes authority writers.\nexport function retireProjectAssignment(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): boolean {\n return withProjectAssignmentLock(() => {\n for (const directory of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n runtime.assignments,\n dirname(\n projectAssignmentPath(runtime, expected.repoKey, expected.branch),\n ),\n ])\n assignmentDirectory(directory);\n const current = readProjectAssignment(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n if (!current || current.id !== expected.id) return false;\n const source = projectAssignmentPath(\n runtime,\n current.repoKey,\n current.branch,\n );\n const destination = pendingRetirementPath(runtime, current);\n const root = join(runtime.root, \"retirements\");\n for (const directory of [root, dirname(destination)]) {\n try {\n mkdirSync(directory, { mode: 0o700 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n assignmentDirectory(directory);\n }\n if (lstatSync(destination, { throwIfNoEntry: false }))\n throw new Error(\"Pending retirement already exists\");\n renameSync(source, destination);\n // A sync failure is indeterminate durability: never restore authority or retry the move.\n fsyncDirectory(dirname(source));\n fsyncDirectory(dirname(destination));\n fsyncDirectory(root);\n fsyncDirectory(runtime.root);\n return true;\n });\n}\n\nfunction pendingRetirementPath(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): string {\n if (!validProjectAssignment(expected))\n throw new Error(\"Invalid project assignment\");\n const active = projectAssignmentPath(\n runtime,\n expected.repoKey,\n expected.branch,\n );\n return join(\n runtime.root,\n \"retirements\",\n basename(dirname(active)),\n `${basename(active, \".json\")}.${expected.id}.json`,\n );\n}\n\nexport function listPendingRetirements(\n runtime: SupervisionRuntime,\n repoKey: string,\n options: {\n after?: string;\n recordLimit?: number;\n onReadError?: (error: Error) => void;\n onScanned?: (entry: string) => void;\n } = {},\n): ProjectAssignment[] {\n const repository = basename(\n dirname(projectAssignmentPath(runtime, repoKey, \"lookup\")),\n );\n const root = join(runtime.root, \"retirements\");\n const directory = join(root, repository);\n let entries: string[];\n try {\n for (const parent of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n root,\n directory,\n ])\n assignmentDirectory(parent);\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n entries.sort();\n const start = options.after\n ? Math.max(\n 0,\n entries.findIndex((entry) => entry > options.after!),\n )\n : 0;\n const ordered = [...entries.slice(start), ...entries.slice(0, start)];\n const records: ProjectAssignment[] = [];\n const recordLimit = Math.min(\n options.recordLimit ?? COORDINATION_INBOX_SCAN_LIMIT,\n COORDINATION_INBOX_SCAN_LIMIT,\n );\n for (const entry of ordered.slice(0, COORDINATION_INBOX_SCAN_LIMIT)) {\n options.onScanned?.(entry);\n const path = join(directory, entry);\n try {\n const record = readProjectAssignmentFile(path, repoKey, undefined, true);\n if (!record)\n throw projectAssignmentReadError(\n path,\n \"file disappeared while listing\",\n );\n records.push(record);\n if (records.length >= recordLimit) break;\n } catch (error) {\n const failure = error instanceof Error ? error : new Error(String(error));\n if (!options.onReadError) throw failure;\n options.onReadError(failure);\n }\n }\n return records.sort(\n (a, b) => a.branch.localeCompare(b.branch) || a.id.localeCompare(b.id),\n );\n}\n\nexport function removePendingRetirement(\n runtime: SupervisionRuntime,\n expected: ProjectAssignment,\n): void {\n withProjectAssignmentLock(() => {\n const path = pendingRetirementPath(runtime, expected);\n const root = join(runtime.root, \"retirements\");\n for (const directory of [\n herdsmanDataRoot(),\n dirname(dirname(runtime.root)),\n dirname(runtime.root),\n runtime.root,\n root,\n dirname(path),\n ])\n assignmentDirectory(directory);\n const record = readProjectAssignmentFile(\n path,\n expected.repoKey,\n expected.branch,\n true,\n );\n if (!record) return;\n if (record.id !== expected.id)\n throw new Error(\"Pending retirement identity mismatch\");\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n });\n}\n\nfunction removeProjectAssignmentUnlocked(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): void {\n const path = projectAssignmentPath(runtime, repoKey, branch);\n try {\n unlinkSync(path);\n fsyncDirectory(dirname(path));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nexport type GlobalProjectAssignment = Readonly<{\n socketHash: string;\n assignment: ProjectAssignment;\n}>;\n\nfunction assignmentDirectory(path: string): void {\n const stat = lstatSync(path);\n if (!stat.isDirectory() || stat.isSymbolicLink())\n throw new Error(`Invalid project assignment authority directory ${path}`);\n}\n\nfunction scanGlobalProjectAssignments(): Map<\n string,\n GlobalProjectAssignment[]\n> {\n const dataRoot = herdsmanDataRoot();\n const runtimeRoot = join(dataRoot, \"runtime\");\n const root = join(runtimeRoot, \"supervision-v2\");\n let sockets: import(\"node:fs\").Dirent[];\n try {\n // lstat every authority path component: checking supervision-v2 alone\n // would still follow a symlinked runtime directory.\n assignmentDirectory(dataRoot);\n assignmentDirectory(runtimeRoot);\n assignmentDirectory(root);\n sockets = readdirSync(root, { withFileTypes: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return new Map();\n throw error;\n }\n const bySession = new Map<string, GlobalProjectAssignment[]>();\n for (const socket of sockets) {\n if (isIncidentalMetadata(socket)) continue;\n if (!/^[a-f0-9]{64}$/.test(socket.name))\n throw new Error(\n `Unexpected project assignment socket entry ${socket.name}`,\n );\n if (!socket.isDirectory() || socket.isSymbolicLink())\n throw new Error(\n `Invalid project assignment socket directory ${socket.name}`,\n );\n const socketRoot = join(root, socket.name);\n assignmentDirectory(socketRoot);\n const assignmentsRoot = join(socketRoot, \"assignments\");\n let repositories: import(\"node:fs\").Dirent[];\n try {\n assignmentDirectory(assignmentsRoot);\n repositories = readdirSync(assignmentsRoot, { withFileTypes: true });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") continue;\n throw error;\n }\n assignmentDirectory(assignmentsRoot);\n for (const repository of repositories) {\n if (isIncidentalMetadata(repository)) continue;\n if (!/^[a-f0-9]{64}$/.test(repository.name))\n throw new Error(\n `Unexpected project assignment repository entry ${repository.name}`,\n );\n if (!repository.isDirectory() || repository.isSymbolicLink())\n throw new Error(\n `Invalid project assignment repository directory ${repository.name}`,\n );\n const directory = join(assignmentsRoot, repository.name);\n assignmentDirectory(directory);\n for (const entry of readdirSync(directory, { withFileTypes: true })) {\n if (isIncidentalMetadata(entry)) continue;\n if (/^[a-f0-9]{64}\\.messages$/.test(entry.name)) {\n if (!entry.isDirectory() || entry.isSymbolicLink())\n throw new Error(`Invalid project message directory ${entry.name}`);\n continue;\n }\n if (/^[a-f0-9]{64}\\.json\\.lock$/.test(entry.name)) {\n if (!entry.isDirectory() || entry.isSymbolicLink())\n throw new Error(`Invalid project assignment lock ${entry.name}`);\n continue;\n }\n // Atomic writer temporaries are not committed authority records.\n if (/^\\..+\\.[a-f0-9-]{36}\\.tmp$/.test(entry.name)) {\n if (!entry.isFile() || entry.isSymbolicLink())\n throw new Error(\n `Invalid project assignment publication temporary ${entry.name}`,\n );\n continue;\n }\n if (!/^[a-f0-9]{64}\\.json$/.test(entry.name))\n throw new Error(`Unexpected project assignment record ${entry.name}`);\n if (!entry.isFile() || entry.isSymbolicLink())\n throw new Error(`Invalid project assignment record ${entry.name}`);\n const path = join(directory, entry.name);\n const assignment = readProjectAssignmentFile(\n path,\n undefined,\n undefined,\n );\n if (\n !assignment ||\n createHash(\"sha256\").update(assignment.repoKey).digest(\"hex\") !==\n repository.name\n )\n throw projectAssignmentReadError(\n path,\n \"assignment repository hash mismatch\",\n );\n const matches = bySession.get(assignment.id) ?? [];\n matches.push({ socketHash: socket.name, assignment });\n bySession.set(assignment.id, matches);\n }\n }\n }\n return bySession;\n}\n\n/** The full O(N) scan and caller's final synchronous action share the authority lock. */\n// ponytail: global lock + full assignment scan. Add session-keyed indexing only if measured contention warrants it.\nexport function withProjectAssignmentAuthority<T>(\n operation: (assignments: Map<string, GlobalProjectAssignment[]>) => T,\n): T {\n return withProjectAssignmentLock(() =>\n operation(scanGlobalProjectAssignments()),\n );\n}\n\nexport function globalProjectAssignmentSnapshot(): Map<\n string,\n GlobalProjectAssignment[]\n> {\n return withProjectAssignmentAuthority((snapshot) => snapshot);\n}\n\nexport type ProjectMessage = Readonly<{\n version: 2;\n id: string;\n repoKey: string;\n branch: string;\n fromSessionId: string;\n text: string;\n kind?: ProjectMessageKind;\n resultBindings?: ResultBinding[];\n createdAt: number;\n}>;\n\nexport type ProjectMessageKind =\n | \"supervisor_message\"\n | \"direct_response\"\n | \"herd_settlement\"\n | \"execution_failure\"\n | \"execution_cancelled\";\n\nexport function projectMessageLabel(kind?: ProjectMessageKind): string {\n switch (kind) {\n case \"supervisor_message\":\n return \"Lead \u2192 Manager\";\n case \"direct_response\":\n return \"Lead response\";\n case \"herd_settlement\":\n return \"Herd settled\";\n case \"execution_failure\":\n return \"Lead execution failed\";\n case \"execution_cancelled\":\n return \"Lead cancelled\";\n default:\n return \"Lead update\";\n }\n}\n\nexport function projectMessageEnvelope(\n kind: ProjectMessageKind | undefined,\n branch: string,\n sessionId: string,\n): string {\n return kind === undefined\n ? `Project ${branch} from lead ${sessionId}:\\n\\n`\n : `${projectMessageLabel(kind)} for assignment ${branch} from lead ${sessionId}:\\n\\n`;\n}\n\nexport type ProjectMessageHeader = Omit<\n ProjectMessage,\n \"text\" | \"resultBindings\"\n> & {\n text: string;\n resultBindings?: ResultBinding[];\n bodyRef?: OverflowBodyRef;\n};\ntype StoredProjectMessage = ProjectMessageHeader;\n\nfunction projectMessageDirectory(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): string {\n const assignment = projectAssignmentPath(runtime, repoKey, branch);\n return join(dirname(assignment), `${basename(assignment, \".json\")}.messages`);\n}\n\nfunction validProjectMessage(value: unknown): value is ProjectMessage {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const r = value as Record<string, unknown>;\n return (\n Object.keys(r).every((key) =>\n [\n \"version\",\n \"id\",\n \"repoKey\",\n \"branch\",\n \"fromSessionId\",\n \"text\",\n \"kind\",\n \"createdAt\",\n \"resultBindings\",\n \"bodyRef\",\n ].includes(key),\n ) &&\n Object.keys(r).length >= 7 &&\n [\n \"version\",\n \"id\",\n \"repoKey\",\n \"branch\",\n \"fromSessionId\",\n \"text\",\n \"createdAt\",\n ].every((key) => Object.hasOwn(r, key)) &&\n r.version === 2 &&\n UUID.test(String(r.id)) &&\n validNativeIdentity(r.repoKey) &&\n validNativeIdentity(r.branch) &&\n validSession(r.fromSessionId) &&\n typeof r.text === \"string\" &&\n (r.bodyRef === undefined\n ? r.text.length > 0\n : r.text === \"\" &&\n r.resultBindings === undefined &&\n validOverflowBodyRef(r.bodyRef)) &&\n (r.kind === undefined ||\n [\n \"supervisor_message\",\n \"direct_response\",\n \"herd_settlement\",\n \"execution_failure\",\n \"execution_cancelled\",\n ].includes(r.kind as ProjectMessageKind)) &&\n (r.resultBindings === undefined ||\n (Array.isArray(r.resultBindings) &&\n r.resultBindings.every(isResultBinding))) &&\n Number.isInteger(r.createdAt) &&\n (r.createdAt as number) >= 0\n );\n}\n\nexport function projectMessageBytes(record: ProjectMessage): number {\n return Buffer.byteLength(`${JSON.stringify(record)}\\n`, \"utf8\");\n}\n\nexport function writeProjectMessage(\n record: ProjectMessage,\n runtime: SupervisionRuntime,\n): void {\n if (!validProjectMessage(record) || (record as any).bodyRef !== undefined)\n throw new Error(\"Invalid project message\");\n const path = join(\n projectMessageDirectory(runtime, record.repoKey, record.branch),\n `${record.id}.json`,\n );\n withChiefMessageLock(path, () =>\n writeProjectMessageUnlocked(record, runtime),\n );\n}\n\nfunction writeProjectMessageUnlocked(\n record: ProjectMessage,\n runtime: SupervisionRuntime,\n): void {\n if (!validProjectMessage(record) || (record as any).bodyRef !== undefined)\n throw new Error(\"Invalid project message\");\n const directory = projectMessageDirectory(\n runtime,\n record.repoKey,\n record.branch,\n );\n mkdirSync(directory, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n chmodSync(runtime.assignments, 0o700);\n chmodSync(dirname(directory), 0o700);\n chmodSync(directory, 0o700);\n const path = join(directory, `${record.id}.json`);\n let stored: StoredProjectMessage = record;\n if (projectMessageBytes(record) > COORDINATION_MESSAGE_MAX_BYTES) {\n const bodyRef = writeOverflowBody(`${path}.body`, {\n text: record.text,\n ...(record.resultBindings\n ? { resultBindings: record.resultBindings }\n : {}),\n });\n stored = { ...record, text: \"\", bodyRef };\n delete (stored as any).resultBindings;\n if (\n projectMessageBytes(stored as ProjectMessage) >\n COORDINATION_MESSAGE_MAX_BYTES\n )\n throw new Error(\"Project message routing metadata is too large\");\n }\n const temporary = join(directory, `.${record.id}.${randomUUID()}.tmp`);\n let fd: number | undefined;\n try {\n fd = openSync(temporary, \"wx\", 0o600);\n writeFileSync(fd, `${JSON.stringify(stored)}\\n`, \"utf8\");\n fsyncSync(fd);\n closeSync(fd);\n fd = undefined;\n let existing: ProjectMessage | undefined;\n try {\n existing = readProjectMessageFile(path);\n } catch (error) {\n if (\n (error as any).cause?.code !== \"ENOENT\" &&\n (error as NodeJS.ErrnoException).code !== \"ENOENT\"\n )\n throw new Error(`Unable to verify existing project message ${path}`, {\n cause: error,\n });\n }\n if (existing !== undefined) {\n if (JSON.stringify(existing) !== JSON.stringify(record))\n throw new Error(\n \"Project message identity conflicts with durable payload\",\n );\n } else {\n renameSync(temporary, path);\n chmodSync(path, 0o600);\n fsyncDirectory(directory);\n }\n } finally {\n if (fd !== undefined) closeSync(fd);\n try {\n unlinkSync(temporary);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n }\n}\n\nexport function listProjectMessages(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectMessage[] {\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .flatMap((entry) => {\n let value: ProjectMessage;\n try {\n value = readProjectMessageFile(join(directory, entry));\n } catch (error) {\n // Pending records may be consumed after directory enumeration.\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n return [];\n throw error;\n }\n if (value.repoKey !== repoKey || value.branch !== branch)\n throw new Error(`Project message identity does not match ${directory}`);\n return [value];\n })\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));\n}\n\n/** Lists compact pending records without opening or validating overflow bodies. */\nexport function listProjectMessageHeaders(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n): ProjectMessageHeader[] {\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n let entries: string[];\n try {\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n throw error;\n }\n return entries\n .filter((entry) => UUID.test(entry.slice(0, -5)) && entry.endsWith(\".json\"))\n .flatMap((entry) => {\n try {\n const value = readStoredProjectMessageFile(join(directory, entry));\n if (value.repoKey !== repoKey || value.branch !== branch)\n throw new Error(\n `Project message identity does not match ${directory}`,\n );\n return [value];\n } catch (error) {\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n return [];\n throw error;\n }\n })\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));\n}\n\n/** Resolves one previously listed project message after its delivery is authorized. */\nexport function readProjectMessage(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n id: string,\n): ProjectMessage {\n if (!UUID.test(id)) throw new Error(\"Invalid project message ID\");\n const record = readProjectMessageFile(\n join(projectMessageDirectory(runtime, repoKey, branch), `${id}.json`),\n );\n if (record.repoKey !== repoKey || record.branch !== branch)\n throw new Error(\"Project message identity does not match its directory\");\n return record;\n}\n\nexport function removeProjectMessage(\n runtime: SupervisionRuntime,\n repoKey: string,\n branch: string,\n id: string,\n): void {\n if (!UUID.test(id)) throw new Error(\"Invalid project message ID\");\n const directory = projectMessageDirectory(runtime, repoKey, branch);\n try {\n if (!statSync(directory).isDirectory())\n throw new Error(\"Invalid project message directory\");\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n throw error;\n }\n const path = join(directory, `${id}.json`);\n withChiefMessageLock(path, () => removeProjectMessageUnlocked(directory, id));\n}\n\nfunction removeProjectMessageUnlocked(directory: string, id: string): void {\n try {\n unlinkSync(join(directory, `${id}.json`));\n fsyncDirectory(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n try {\n unlinkSync(join(directory, `${id}.json.body`));\n fsyncDirectory(directory);\n } catch {}\n}\n\nfunction readProjectMessageFile(path: string): ProjectMessage {\n try {\n const stored = readStoredProjectMessageFile(path);\n if ((stored as StoredProjectMessage).bodyRef) {\n const compact = stored as StoredProjectMessage;\n const body = readOverflowBody(`${path}.body`, compact.bodyRef!);\n const value = { ...compact, ...body } as ProjectMessage;\n delete (value as any).bodyRef;\n if (!validProjectMessage(value)) throw new Error(\"invalid body\");\n return value;\n }\n return stored as ProjectMessage;\n } catch (error) {\n if (\n error instanceof Error &&\n error.message.startsWith(\"Unable to read project message \")\n )\n throw error;\n throw new Error(`Unable to read project message ${path}`, { cause: error });\n }\n}\n\nfunction readStoredProjectMessageFile(path: string): StoredProjectMessage {\n try {\n if (statSync(path).size > COORDINATION_MESSAGE_MAX_BYTES)\n throw new Error(\"large\");\n const stored: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !validProjectMessage(stored) ||\n basename(path) !== `${(stored as ProjectMessage).id}.json`\n )\n throw new Error(\"invalid\");\n return stored as StoredProjectMessage;\n } catch (error) {\n throw new Error(`Unable to read project message ${path}`, { cause: error });\n }\n}\n\nexport function removeProjectMessagesForAssignment(\n runtime: SupervisionRuntime,\n assignment: ProjectAssignment,\n): void {\n for (const message of listProjectMessageHeaders(\n runtime,\n assignment.repoKey,\n assignment.branch,\n )) {\n if (message.fromSessionId === assignment.id)\n removeProjectMessage(\n runtime,\n assignment.repoKey,\n assignment.branch,\n message.id,\n );\n }\n}\n\nexport function recoverStaleProjectMessages(\n runtime: SupervisionRuntime,\n repoKey: string,\n): void {\n withProjectAssignmentLock(() => {\n const directory = dirname(\n projectAssignmentPath(runtime, repoKey, \"lookup\"),\n );\n let entries: string[];\n try {\n const dataRoot = herdsmanDataRoot();\n for (const path of [\n dataRoot,\n join(dataRoot, \"runtime\"),\n join(dataRoot, \"runtime\", \"supervision-v2\"),\n runtime.root,\n runtime.assignments,\n directory,\n ])\n assignmentDirectory(path);\n entries = readdirSync(directory);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n throw error;\n }\n for (const entry of entries.filter((entry) =>\n /^[a-f0-9]{64}\\.messages$/.test(entry),\n )) {\n const messages = join(directory, entry);\n assignmentDirectory(messages);\n for (const file of readdirSync(messages).filter(\n (file) => UUID.test(file.slice(0, -5)) && file.endsWith(\".json\"),\n )) {\n const path = join(messages, file);\n let message: ProjectMessageHeader;\n try {\n message = readStoredProjectMessageFile(path);\n } catch (error) {\n if (\n error instanceof Error &&\n (error.cause as NodeJS.ErrnoException)?.code === \"ENOENT\"\n )\n continue;\n throw error;\n }\n if (\n message.repoKey !== repoKey ||\n projectMessageDirectory(runtime, message.repoKey, message.branch) !==\n messages\n )\n throw new Error(`Project message identity does not match ${path}`);\n const current = readProjectAssignment(runtime, repoKey, message.branch);\n if (!current || current.id !== message.fromSessionId)\n removeProjectMessage(runtime, repoKey, message.branch, message.id);\n }\n }\n });\n}\n\n/** Advisory only. Delivery must still verify current assignment authority. */\nexport function mightHaveProjectMessages(\n runtime: SupervisionRuntime,\n repoKey: string,\n): boolean {\n const directory = dirname(projectAssignmentPath(runtime, repoKey, \"lookup\"));\n let entries: import(\"node:fs\").Dirent[];\n try {\n entries = readdirSync(directory, { withFileTypes: true });\n } catch (error) {\n return (error as NodeJS.ErrnoException).code !== \"ENOENT\";\n }\n\n for (const entry of entries) {\n if (!/^[a-f0-9]{64}\\.messages$/u.test(entry.name)) continue;\n if (!entry.isDirectory() || entry.isSymbolicLink()) return true;\n\n try {\n if (\n readdirSync(join(directory, entry.name)).some(\n (name) => name.endsWith(\".json\") && UUID.test(name.slice(0, -5)),\n )\n )\n return true;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") return true;\n }\n }\n return false;\n}\n\nexport type CoordinatorState = {\n version: 1;\n build?: RuntimeBuild;\n role?: CoordinatorRole;\n instanceId: string;\n piSessionId: string;\n updatedAt: number;\n};\nexport type LeadCoordinationState = CoordinatorState;\n\nexport function verifyManagerCoordinationAuthority(\n descriptor: ManagerDescriptor,\n coordinator: LeadCoordinationState | undefined,\n build: RuntimeBuild,\n requireCompatibleBuild: typeof import(\"./compatibility.ts\").requireCompatibleBuild,\n): void {\n if (\n !coordinator ||\n coordinator.role !== \"manager\" ||\n coordinator.piSessionId !== descriptor.piSessionId\n )\n throw new Error(\n \"Manager authority exists but its coordination state could not be verified\",\n );\n requireCompatibleBuild(\n build,\n descriptor.build,\n \"supervision\",\n `Manager ${descriptor.piSessionId}`,\n );\n requireCompatibleBuild(\n build,\n coordinator.build,\n \"supervision\",\n `Manager ${descriptor.piSessionId}`,\n );\n}\n\nexport async function verifyRemoteChiefAuthority(\n descriptor: ChiefDescriptor,\n options: {\n remoteIdentity(): Promise<unknown | undefined>;\n requireCompatibleBuild: typeof import(\"./compatibility.ts\").requireCompatibleBuild;\n build: RuntimeBuild;\n },\n): Promise<boolean> {\n if (!(await options.remoteIdentity())) return false;\n options.requireCompatibleBuild(\n options.build,\n descriptor.build,\n \"supervision\",\n `Chief ${descriptor.piSessionId}`,\n );\n return true;\n}\n\nexport async function leadSupervisorState(\n ctx: ExtensionContext,\n host: {\n workspaceId(): string | undefined;\n resolveEffectiveSupervisor(\n ctx: ExtensionContext,\n sessionId: string,\n workspaceId: string,\n ): Promise<\n | { kind: \"assigned\" }\n | { kind: \"manager\" }\n | { kind: \"chief\" }\n | { kind: \"none\" }\n >;\n currentManager(ctx: ExtensionContext): Promise<unknown | undefined>;\n },\n): Promise<string> {\n try {\n const workspaceId = host.workspaceId();\n if (!workspaceId) throw new Error(\"Lead workspace is unavailable\");\n const supervisor = await host.resolveEffectiveSupervisor(\n ctx,\n ctx.sessionManager.getSessionId(),\n workspaceId,\n );\n if (supervisor.kind === \"assigned\") {\n try {\n if (await host.currentManager(ctx))\n return `<supervisor_state>\\nsupervisor: manager\\navailability: available\\nproject_messages: retained across Manager turnover\\n</supervisor_state>`;\n } catch {\n return `<supervisor_state>\\nsupervisor: manager\\navailability: unknown\\nproject_messages: retained for the Manager role\\n</supervisor_state>`;\n }\n return `<supervisor_state>\\nsupervisor: manager\\navailability: unavailable\\nproject_messages: retained for the Manager role\\n</supervisor_state>`;\n }\n if (supervisor.kind === \"manager\")\n return `<supervisor_state>\\nsupervisor: manager\\navailability: available\\n</supervisor_state>`;\n if (supervisor.kind === \"chief\")\n return `<supervisor_state>\\nsupervisor: chief\\navailability: available\\n</supervisor_state>`;\n return `<supervisor_state>\\nsupervisor: none\\navailability: unavailable\\nguidance: continue independently; do not use message_supervisor until a supervisor is available\\n</supervisor_state>`;\n } catch {\n return `<supervisor_state>\\nsupervisor: unverified\\navailability: unknown\\nguidance: continue independently; do not use message_supervisor until a supervisor is verified\\n</supervisor_state>`;\n }\n}\n\nexport function supervisorStateMessage(\n customType: string,\n content: string,\n latestContent: string | undefined,\n): { customType: string; content: string; display: false } | undefined {\n return latestContent === content\n ? undefined\n : { customType, content, display: false };\n}\n\nexport type SupervisedLead = {\n relationship?: \"assigned\" | \"supervised\";\n lead: string;\n branch?: string;\n herdRunStartedAt?: number;\n contextPercent?: number;\n /** Internal: path to a non-empty persisted session candidate. */\n piSessionFile?: string;\n instanceId?: string;\n displayName: string;\n workspaceId: string;\n workspaceLabel?: string;\n tabId: string;\n paneId: string;\n runtimeState: RuntimeState;\n agentCounts: { active: number; blocked: number; total: number };\n availableActions: Array<\"inspect\" | \"transcript\" | \"message\">;\n agents: Array<{ id: string; label: string; state: RuntimeState }>;\n};\n\nexport function staffToolName(\n action: \"inspect\" | \"transcript\" | \"message\",\n): string {\n switch (action) {\n case \"inspect\":\n return \"inspect_staff\";\n case \"transcript\":\n return \"read_staff_transcript\";\n case \"message\":\n return \"message_staff\";\n }\n}\n/** Chief can act on these Managers only; nested Leads are observational. */\nexport type SupervisedManager = {\n session: string;\n instanceId?: string;\n displayName: string;\n project: string;\n workspaceId: string;\n paneId: string;\n tabId: string;\n runtimeState: RuntimeState;\n agentCounts: { active: number; blocked: number; total: number };\n leadCounts: { active: number; blocked: number; total: number };\n incompatibleLeadCount?: number;\n leads: Array<{\n session: string;\n instanceId?: string;\n paneId?: string;\n tabId?: string;\n workspaceId?: string;\n displayName: string;\n runtimeState: RuntimeState;\n agentCounts?: { active: number; blocked: number; total: number };\n compatibility?: \"incompatible\";\n build?: RuntimeBuild;\n }>;\n availableActions: Array<\"inspect\" | \"transcript\" | \"message\">;\n};\n/** A Chief snapshot has Managers as its only actionable reports. */\nexport type ChiefManagerReportSnapshot = {\n managers: SupervisedManager[];\n leads?: SupervisedLead[];\n incompatible?: IncompatibleStaff[];\n diagnostics?: string[];\n};\nexport type IncompatibleStaff = Readonly<{\n role: \"manager\" | \"lead\";\n session: string;\n instanceId: string;\n displayName: string;\n workspaceId: string;\n paneId: string;\n tabId: string;\n runtimeState: RuntimeState;\n build: RuntimeBuild;\n reason: \"incompatible_build\";\n}>;\nexport type SupervisionSnapshot = {\n leads: SupervisedLead[];\n incompatible?: IncompatibleStaff[];\n project?: string;\n work?: ProjectWorkSnapshot[];\n openWorkspaces?: readonly OpenProjectWorkspace[];\n diagnostics?: string[];\n managerCheckoutPath?: string;\n};\nexport type OpenProjectWorkspace = Readonly<{\n workspaceId: string;\n branch?: string;\n path: string;\n linked: boolean;\n}>;\nexport type ProjectWorkStatus = \"active\" | \"paused\" | \"unknown\" | \"conflict\";\nexport type UnverifiedAssignedLead = Readonly<{\n lead: string;\n status: \"unknown\" | \"conflict\";\n issue: string;\n}>;\nexport type ProjectWorkSnapshot = Readonly<{\n branch: string;\n session: string;\n status: ProjectWorkStatus;\n runtimeState?: RuntimeState;\n task?: string;\n issue?: string;\n checkoutPath?: string;\n gitBaselineSha?: string;\n}>;\nexport function projectTaskSummary(text: string): string | undefined {\n const task = text\n .replace(/[\\u0000-\\u001f\\u007f]/g, \" \")\n .replace(/\\s+/gu, \" \")\n .trim();\n\n if (!task) return undefined;\n\n const characters = Array.from(task);\n return characters.length <= 160\n ? task\n : `${characters.slice(0, 159).join(\"\")}\u2026`;\n}\n/** Derive work from one caller-validated Lead inventory and one Herdr worktree list. */\nexport function projectWorkSnapshot(options: {\n assignments: readonly ProjectAssignment[];\n worktrees: readonly Readonly<{\n branch: string;\n open_workspace_id?: string | null;\n }>[];\n placements?: ReadonlyMap<\n string,\n Readonly<{\n status: \"matched\" | \"unknown\" | \"conflict\";\n path?: string;\n worktree?: Readonly<{\n branch?: string;\n open_workspace_id?: string | null;\n }>;\n }>\n >;\n leads: readonly Pick<\n SupervisedLead,\n \"lead\" | \"workspaceId\" | \"runtimeState\"\n >[];\n unverified?: readonly UnverifiedAssignedLead[];\n}): ProjectWorkSnapshot[] {\n return options.assignments.map((assignment) => {\n const placement = options.placements?.get(assignment.id);\n const worktrees = placement\n ? placement.status === \"matched\" && placement.worktree\n ? [placement.worktree]\n : []\n : options.worktrees.filter((item) => item.branch === assignment.branch);\n const exact = options.leads.filter((lead) => lead.lead === assignment.id);\n const uncertain =\n options.unverified?.filter((lead) => lead.lead === assignment.id) ?? [];\n let status: ProjectWorkStatus;\n let runtimeState: RuntimeState | undefined;\n let issue: string | undefined;\n if (\n worktrees.length > 1 ||\n exact.length > 1 ||\n uncertain.length > 1 ||\n (exact.length > 0 && uncertain.length > 0)\n ) {\n status = \"conflict\";\n issue = \"project runtime identity is ambiguous\";\n } else if (placement && placement.status !== \"matched\") {\n status = placement.status;\n issue =\n placement.status === \"conflict\"\n ? \"assigned checkout placement conflicts\"\n : \"assigned checkout placement is unavailable\";\n } else if (uncertain.length === 1) {\n status = uncertain[0]!.status;\n issue = uncertain[0]!.issue;\n } else {\n const workspaceId = worktrees[0]?.open_workspace_id ?? undefined;\n if (\n exact.length === 1 &&\n (!workspaceId || exact[0]!.workspaceId !== workspaceId)\n ) {\n status = \"conflict\";\n issue = \"assigned Lead is running outside its branch worktree\";\n } else if (exact.length === 1) {\n status = \"active\";\n runtimeState = exact[0]!.runtimeState;\n } else {\n status = \"paused\";\n }\n }\n const task = projectTaskSummary(assignment.text);\n return {\n branch: assignment.branch,\n session: assignment.id,\n status,\n ...(placement?.status === \"matched\" &&\n typeof placement.path === \"string\" &&\n (status === \"active\" || status === \"paused\")\n ? {\n checkoutPath: placement.path,\n ...(assignment.gitBaselineSha\n ? { gitBaselineSha: assignment.gitBaselineSha }\n : {}),\n }\n : {}),\n ...(runtimeState ? { runtimeState } : {}),\n ...(task ? { task } : {}),\n ...(issue ? { issue } : {}),\n };\n });\n}\nexport type SupervisionPresentationSnapshot =\n SupervisionSnapshot | ChiefManagerReportSnapshot;\nexport type RuntimeState =\n | \"idle\"\n | \"working\"\n | \"blocked\"\n | \"settling\"\n | \"starting\"\n | \"done\"\n | \"unknown\"\n | \"lost\";\nexport type LiveAgent = {\n sessionId: string;\n /** Internal: path to a non-empty persisted session candidate. */\n piSessionFile?: string;\n sessionKind: \"id\";\n workspaceId: string;\n paneId: string;\n tabId: string;\n workspaceCwd?: string;\n herdrName?: string;\n tabLabel?: string;\n tokens?: Readonly<Record<string, unknown>>;\n runtimeState?: RuntimeState;\n};\nexport type WorkspaceProvenance = Readonly<{\n workspaceLabel?: string;\n workspaceCwd?: string;\n repoName?: string;\n branch?: string;\n}>;\nexport type ValidatedManagedAgentEvidence = {\n piSessionId: string;\n ownerSessionId: string;\n workspaceId: string;\n paneId: string;\n runtimeState: RuntimeState;\n agentLabel?: string;\n};\n\nexport const LEAD_STATE_MAX_BYTES = COORDINATION_MESSAGE_MAX_BYTES * 2;\n/** Fits the complete coordination record, including JSON and UTF-8 overhead. */\nfunction leadStateDirectory(runtime: SupervisionRuntime): string {\n mkdirSync(runtime.root, { recursive: true, mode: 0o700 });\n chmodSync(runtime.root, 0o700);\n mkdirSync(runtime.leads, { recursive: true, mode: 0o700 });\n chmodSync(runtime.leads, 0o700);\n return runtime.leads;\n}\nexport function leadCoordinationStatePath(\n runtime: SupervisionRuntime,\n piSessionId: string,\n): string {\n if (!validSession(piSessionId)) throw new Error(\"Invalid lead session ID\");\n return join(\n runtime.leads,\n createHash(\"sha256\").update(piSessionId).digest(\"hex\") + \".json\",\n );\n}\nfunction validLeadState(value: unknown): value is CoordinatorState {\n if (!value || typeof value !== \"object\") return false;\n const r = value as Record<string, unknown>;\n const keys = [\"version\", \"instanceId\", \"piSessionId\", \"updatedAt\"];\n if (\n Object.keys(r).some(\n (k) => !keys.includes(k) && k !== \"role\" && k !== \"build\",\n ) ||\n keys.some((k) => !Object.hasOwn(r, k))\n )\n return false;\n return (\n r.version === 1 &&\n (r.build === undefined || isRuntimeBuild(r.build)) &&\n (r.role === undefined || r.role === \"lead\" || r.role === \"manager\") &&\n UUID.test(String(r.instanceId)) &&\n validSession(r.piSessionId) &&\n Number.isInteger(r.updatedAt) &&\n (r.updatedAt as number) >= 0\n );\n}\nexport function readLeadCoordinationState(\n runtime: SupervisionRuntime,\n piSessionId: string,\n): LeadCoordinationState | undefined {\n const path = leadCoordinationStatePath(runtime, piSessionId);\n try {\n const text = readFileSync(path, \"utf8\");\n if (Buffer.byteLength(text, \"utf8\") > LEAD_STATE_MAX_BYTES)\n throw new Error(\"lead state too large\");\n const value: unknown = JSON.parse(text);\n const currentState =\n value && typeof value === \"object\" && !Array.isArray(value)\n ? Object.fromEntries(\n Object.entries(value).filter(([key]) => key !== \"pendingAsk\"),\n )\n : value;\n if (\n !validLeadState(currentState) ||\n currentState.piSessionId !== piSessionId\n )\n throw new Error(\"invalid lead state\");\n return currentState;\n } catch (e) {\n if ((e as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw new Error(\"Unable to read lead coordination state\", { cause: e });\n }\n}\nexport function writeLeadCoordinationState(\n runtime: SupervisionRuntime,\n state: LeadCoordinationState,\n): string {\n if (!state.build || !validLeadState(state))\n throw new Error(\"Invalid lead coordination state\");\n leadStateDirectory(runtime);\n const path = leadCoordinationStatePath(runtime, state.piSessionId);\n const content = JSON.stringify(state) + \"\\n\";\n if (Buffer.byteLength(content, \"utf8\") > LEAD_STATE_MAX_BYTES)\n throw new Error(\"Lead coordination state is too large\");\n return publishRecord(path, content);\n}\n\n/** Remove a failed publication so an older generation cannot remain authority. */\nexport function invalidateLeadCoordinationState(\n runtime: SupervisionRuntime,\n piSessionId: string,\n expectedInstanceId?: string,\n): void {\n const path = leadCoordinationStatePath(runtime, piSessionId);\n if (expectedInstanceId !== undefined) {\n const current = readLeadCoordinationState(runtime, piSessionId);\n if (!current || current.instanceId !== expectedInstanceId) return;\n }\n try {\n unlinkSync(path);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n return;\n }\n fsyncDirectory(dirname(path));\n}\n\nexport function normalizeHerdrLifecycleState(agent: any): RuntimeState {\n const state = agent?.agent_status;\n return state === \"idle\" ||\n state === \"working\" ||\n state === \"blocked\" ||\n state === \"done\"\n ? state\n : \"unknown\";\n}\n\nfunction metadataInteger(\n tokens: Readonly<Record<string, unknown>> | undefined,\n key: string,\n): number | undefined {\n const raw = tokens?.[key];\n if (typeof raw !== \"string\" || !/^\\d+$/.test(raw)) return undefined;\n const value = Number(raw);\n return Number.isSafeInteger(value) ? value : undefined;\n}\n\n/** Projects caller-proven live leads and validated agent evidence; metadata is never authority. */\nexport function projectSupervision(options: {\n agents: LiveAgent[];\n managedAgents: ValidatedManagedAgentEvidence[];\n coordinationStates: LeadCoordinationState[];\n openWorkspaces?: readonly OpenProjectWorkspace[];\n workspaceProvenance?: ReadonlyMap<string, WorkspaceProvenance>;\n chiefSessionId?: string;\n excludedSessionIds?: ReadonlySet<string>;\n /** Leads already reported to an active Manager must not also report to Chief. */\n managerSupervisedLeadSessionIds?: ReadonlySet<string>;\n localBuild?: RuntimeBuild;\n managedAgentSessionIds?: Set<string>;\n}): SupervisionSnapshot {\n const states = new Map<string, LeadCoordinationState>();\n const duplicateStates = new Set<string>();\n for (const state of options.coordinationStates) {\n if (states.has(state.piSessionId)) duplicateStates.add(state.piSessionId);\n else states.set(state.piSessionId, state);\n }\n const leads: SupervisedLead[] = [];\n const incompatible: IncompatibleStaff[] = [];\n const validAgents = options.agents.filter(\n (agent) =>\n agent.sessionKind === \"id\" &&\n validSession(agent.sessionId) &&\n validNativeIdentity(agent.workspaceId) &&\n validNativeIdentity(agent.tabId) &&\n validNativeIdentity(agent.paneId),\n );\n const duplicatePhysical = new Set<string>();\n const physical = new Map<string, string>();\n for (const agent of validAgents) {\n const key = `${agent.workspaceId}\\0${agent.tabId}\\0${agent.paneId}`;\n const previous = physical.get(key);\n if (previous && previous !== agent.sessionId) duplicatePhysical.add(key);\n else physical.set(key, agent.sessionId);\n }\n const seenLeads = new Set<string>();\n const duplicateAgents = new Set<string>();\n for (const agent of validAgents) {\n if (seenLeads.has(agent.sessionId)) duplicateAgents.add(agent.sessionId);\n else seenLeads.add(agent.sessionId);\n }\n seenLeads.clear();\n for (const agent of validAgents) {\n if (seenLeads.has(agent.sessionId)) continue;\n seenLeads.add(agent.sessionId);\n const state = states.get(agent.sessionId);\n if (\n !state ||\n (state.role ?? \"lead\") !== \"lead\" ||\n duplicateAgents.has(agent.sessionId) ||\n duplicateStates.has(agent.sessionId) ||\n agent.sessionId === options.chiefSessionId ||\n options.excludedSessionIds?.has(agent.sessionId) ||\n options.managerSupervisedLeadSessionIds?.has(agent.sessionId) ||\n options.managedAgentSessionIds?.has(agent.sessionId) ||\n duplicatePhysical.has(\n `${agent.workspaceId}\\0${agent.tabId}\\0${agent.paneId}`,\n )\n )\n continue;\n if (options.localBuild && !isRuntimeBuild(state.build)) continue;\n if (\n options.localBuild &&\n !sameRuntimeBuild(options.localBuild, state.build)\n ) {\n incompatible.push({\n role: \"lead\",\n session: agent.sessionId,\n instanceId: state.instanceId,\n displayName: `${agent.workspaceId}/lead-${agent.sessionId.slice(0, 8)}`,\n workspaceId: agent.workspaceId,\n paneId: agent.paneId,\n tabId: agent.tabId,\n runtimeState: agent.runtimeState ?? \"unknown\",\n build: state.build,\n reason: \"incompatible_build\",\n });\n continue;\n }\n const runtimeState = agent.runtimeState ?? \"unknown\";\n const provenance =\n options.workspaceProvenance?.get(agent.workspaceId) ??\n (agent.workspaceCwd ? { workspaceCwd: agent.workspaceCwd } : undefined);\n const workspaceLabel =\n provenance?.repoName && provenance.branch\n ? `${provenance.repoName}/${provenance.branch}`\n : provenance?.workspaceLabel ||\n (provenance?.workspaceCwd\n ? basename(provenance.workspaceCwd)\n : undefined) ||\n agent.workspaceId;\n const tokensName =\n typeof agent.tokens?.pi_herdsman_name === \"string\"\n ? agent.tokens.pi_herdsman_name.trim()\n : \"\";\n const herdrName = agent.herdrName?.trim();\n const tabLabel = agent.tabLabel?.trim();\n const name =\n tokensName ||\n (herdrName &&\n herdrName !== agent.sessionId &&\n !/_[0-9a-f]{16}$/iu.test(herdrName)\n ? herdrName\n : undefined) ||\n tabLabel ||\n `lead-${agent.sessionId.slice(0, 8)}`;\n const herdRunStartedAt = metadataInteger(\n agent.tokens,\n \"pi_herdsman_herd_run_started_at\",\n );\n const contextPercent = metadataInteger(\n agent.tokens,\n \"pi_herdsman_context_percent\",\n );\n leads.push({\n lead: agent.sessionId,\n ...(herdRunStartedAt !== undefined ? { herdRunStartedAt } : {}),\n ...(contextPercent !== undefined ? { contextPercent } : {}),\n instanceId: state.instanceId,\n displayName: `${workspaceLabel || agent.workspaceId}/${name}`,\n ...(provenance?.branch ? { branch: provenance.branch } : {}),\n workspaceId: agent.workspaceId,\n ...(workspaceLabel ? { workspaceLabel } : {}),\n tabId: agent.tabId,\n paneId: agent.paneId,\n runtimeState,\n agentCounts: { active: 0, blocked: 0, total: 0 },\n ...(agent.piSessionFile ? { piSessionFile: agent.piSessionFile } : {}),\n availableActions: [\n \"inspect\",\n ...(agent.piSessionFile ? [\"transcript\" as const] : []),\n ],\n agents: [],\n });\n }\n const leadIds = new Set(leads.map((r) => r.lead));\n const ambiguousAgents = new Set<string>();\n const byId = new Map<string, ValidatedManagedAgentEvidence>();\n for (const managedAgent of options.managedAgents) {\n if (byId.has(managedAgent.piSessionId))\n ambiguousAgents.add(managedAgent.piSessionId);\n else byId.set(managedAgent.piSessionId, managedAgent);\n }\n for (const managedAgent of options.managedAgents) {\n if (ambiguousAgents.has(managedAgent.piSessionId)) continue;\n let owner = managedAgent.ownerSessionId;\n const seen = new Set<string>();\n while (!leadIds.has(owner)) {\n if (ambiguousAgents.has(owner) || seen.has(owner)) {\n owner = \"\";\n break;\n }\n seen.add(owner);\n owner = byId.get(owner)?.ownerSessionId ?? \"\";\n }\n const lead = leads.find((r) => r.lead === owner);\n if (!lead) continue;\n lead.agentCounts.total++;\n if (\n managedAgent.runtimeState === \"working\" ||\n managedAgent.runtimeState === \"settling\" ||\n managedAgent.runtimeState === \"starting\"\n )\n lead.agentCounts.active++;\n if (managedAgent.runtimeState === \"blocked\") lead.agentCounts.blocked++;\n if (lead.agents.length < 32)\n lead.agents.push({\n id: managedAgent.piSessionId,\n label: managedAgent.agentLabel ?? managedAgent.piSessionId,\n state: managedAgent.runtimeState,\n });\n }\n for (const lead of leads) {\n lead.availableActions.push(\"message\");\n }\n leads.sort(\n (a, b) =>\n a.displayName.localeCompare(b.displayName) ||\n a.lead.localeCompare(b.lead),\n );\n return {\n leads,\n ...(incompatible.length ? { incompatible } : {}),\n ...(options.openWorkspaces\n ? { openWorkspaces: options.openWorkspaces }\n : {}),\n };\n}\n\nexport function serializeSupervision(snapshot: SupervisionSnapshot) {\n return {\n ...(snapshot.diagnostics?.length\n ? { diagnostics: snapshot.diagnostics }\n : {}),\n leads: snapshot.leads.map((r) => ({\n session: r.lead,\n display_name: r.displayName,\n workspace_id: r.workspaceId,\n ...(r.workspaceLabel ? { workspace_label: r.workspaceLabel } : {}),\n tab_id: r.tabId,\n pane_id: r.paneId,\n runtime_state: r.runtimeState,\n agent_counts: r.agentCounts,\n available_tools: r.availableActions.map(staffToolName),\n agents: r.agents,\n })),\n };\n}\n", "import {\n createHash,\n randomBytes,\n randomUUID,\n timingSafeEqual,\n} from \"node:crypto\";\nimport {\n chmodSync,\n mkdirSync,\n readFileSync,\n readdirSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { acquireProcessLock, ProcessLockOccupiedError } from \"./lock.ts\";\nimport { herdsmanDataRoot } from \"./storage.ts\";\nimport { isResultBinding, type ResultBinding } from \"./storage.ts\";\nimport {\n PEER_TRANSPORT_FRAME_LIMIT_BYTES,\n peerPayloadDigest,\n} from \"./peer-transport.ts\";\nexport { peerPayloadDigest } from \"./peer-transport.ts\";\n\nexport type PeerPortableAttachment = Readonly<{\n name: string;\n ref?: string;\n marker: string;\n text: string;\n sha256: string;\n}>;\nexport type PeerEvidence = Readonly<{\n attachments: PeerPortableAttachment[];\n resultBindings?: ResultBinding[];\n}>;\n\nexport function resolvePeerResultBindings(\n bindings: readonly ResultBinding[],\n existingRefs: (semanticRef: string) => ReadonlySet<string>,\n): { bindings: ResultBinding[]; conflicts: ResultBinding[] } {\n const accepted: ResultBinding[] = [];\n const conflicts: ResultBinding[] = [];\n for (const binding of bindings) {\n const existing = existingRefs(binding.ref);\n if (\n existing.size > 1 ||\n (existing.size === 1 && !existing.has(binding.canonicalRef))\n )\n conflicts.push(binding);\n else accepted.push(binding);\n }\n return { bindings: accepted, conflicts };\n}\n\nexport type PeerCorrespondence = {\n id: string;\n capability: string;\n role?: \"manager\" | \"lead\";\n originSession: string;\n originGeneration: string;\n recipientSession: string;\n recipientGeneration: string;\n acceptanceId: string;\n originDisplay?: PeerOriginDisplay;\n finalized?: boolean;\n replies: Array<{\n id: string;\n digest: string;\n text: string;\n attachments?: PeerPortableAttachment[];\n resultBindings?: ResultBinding[];\n createdAt: number;\n acknowledged: boolean;\n }>;\n};\n\nexport type PeerOriginDisplay = {\n name?: string;\n workspaceLabel?: string;\n};\n\nexport function validPeerDisplayText(value: unknown): value is string {\n return (\n typeof value === \"string\" &&\n value.trim().length > 0 &&\n value.length <= 512 &&\n !/[\\u0000-\\u001f\\u007f-\\u009f\\u061c\\u200e\\u200f\\u2028-\\u202e\\u2066-\\u2069]/u.test(\n value,\n )\n );\n}\n\nfunction validOriginDisplay(value: unknown): value is PeerOriginDisplay {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n const fields = Object.entries(value);\n return (\n fields.length > 0 &&\n fields.every(\n ([key, text]) =>\n (key === \"name\" || key === \"workspaceLabel\") &&\n validPeerDisplayText(text),\n )\n );\n}\n\nconst ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;\nexport function assertPeerDataRoot(actual: string, expected: string): void {\n if (!actual || !expected || actual !== expected)\n throw new Error(\"peer endpoint data root does not match the active route\");\n}\nfunction directory(): string {\n const path = join(herdsmanDataRoot(), \"runtime\", \"peer-correspondences\");\n mkdirSync(path, { recursive: true, mode: 0o700 });\n chmodSync(path, 0o700);\n return path;\n}\nfunction valid(value: unknown): value is PeerCorrespondence {\n if (!value || typeof value !== \"object\") return false;\n const c = value as PeerCorrespondence;\n return (\n ID.test(c.id) &&\n /^[0-9a-f]{64}$/u.test(c.capability) &&\n (c.role === undefined || c.role === \"manager\" || c.role === \"lead\") &&\n [\n c.originSession,\n c.originGeneration,\n c.recipientSession,\n c.recipientGeneration,\n c.acceptanceId,\n ].every((s) => typeof s === \"string\" && s.length > 0 && s.length <= 512) &&\n (c.originDisplay === undefined || validOriginDisplay(c.originDisplay)) &&\n (c.finalized === undefined || typeof c.finalized === \"boolean\") &&\n Array.isArray(c.replies) &&\n c.replies.every(\n (reply) =>\n !!reply &&\n ID.test(reply.id) &&\n /^[0-9a-f]{64}$/u.test(reply.digest) &&\n typeof reply.text === \"string\" &&\n (reply.attachments === undefined ||\n (Array.isArray(reply.attachments) &&\n reply.attachments.every(\n (attachment) =>\n typeof attachment.name === \"string\" &&\n typeof attachment.marker === \"string\" &&\n typeof attachment.text === \"string\" &&\n /^[0-9a-f]{64}$/u.test(attachment.sha256) &&\n createHash(\"sha256\")\n .update(attachment.text, \"utf8\")\n .digest(\"hex\") === attachment.sha256,\n ))) &&\n (reply.resultBindings === undefined ||\n (Array.isArray(reply.resultBindings) &&\n reply.resultBindings.every(isResultBinding))) &&\n Number.isFinite(reply.createdAt) &&\n typeof reply.acknowledged === \"boolean\",\n )\n );\n}\nfunction save(c: PeerCorrespondence): void {\n const path = join(directory(), `${c.id}.json`);\n const tmp = `${path}.${randomUUID()}.tmp`;\n writeFileSync(tmp, `${JSON.stringify(c)}\\n`, {\n mode: 0o600,\n flag: \"wx\",\n flush: true,\n });\n renameSync(tmp, path);\n}\nfunction mutate<T>(id: string, action: (c: PeerCorrespondence) => T): T {\n let lock: ReturnType<typeof acquireProcessLock> | undefined;\n const deadline = Date.now() + 15_000;\n while (!lock) {\n try {\n lock = acquireProcessLock(join(directory(), `${id}.lock`), {\n name: \"peer correspondence mutation\",\n });\n } catch (error) {\n if (\n !(error instanceof ProcessLockOccupiedError) ||\n Date.now() >= deadline\n )\n throw error;\n Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 10);\n }\n }\n try {\n const c = listPeerCorrespondences().find((item) => item.id === id);\n if (!c) throw new Error(\"peer correspondence not found\");\n const result = action(c);\n save(c);\n return result;\n } finally {\n lock.release();\n }\n}\nexport function createPeerCorrespondence(\n input: Omit<PeerCorrespondence, \"id\" | \"capability\" | \"replies\">,\n): PeerCorrespondence {\n const c: PeerCorrespondence = {\n ...input,\n role: input.role ?? \"manager\",\n id: randomUUID(),\n capability: randomBytes(32).toString(\"hex\"),\n replies: [],\n };\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n save(c);\n return c;\n}\nexport function storePeerCorrespondence(c: PeerCorrespondence): void {\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n const existing = listPeerCorrespondences().find((item) => item.id === c.id);\n if (existing) {\n mutate(c.id, (current) => {\n if (current.finalized)\n throw new Error(\"peer correspondence is already finalized\");\n if ((current.role ?? \"manager\") !== (c.role ?? \"manager\"))\n throw new Error(\"conflicting peer correspondence role\");\n if (\n [\n \"capability\",\n \"originSession\",\n \"originGeneration\",\n \"recipientSession\",\n ].some(\n (key) =>\n current[key as keyof PeerCorrespondence] !==\n c[key as keyof PeerCorrespondence],\n )\n )\n throw new Error(\"conflicting peer correspondence\");\n current.recipientGeneration = c.recipientGeneration;\n if (c.originDisplay) {\n current.originDisplay = {\n ...current.originDisplay,\n ...c.originDisplay,\n };\n }\n });\n return;\n }\n save({ ...c, role: c.role ?? \"manager\" });\n}\nexport function readPeerCorrespondence(\n id: string,\n): PeerCorrespondence | undefined {\n if (!ID.test(id)) throw new Error(\"invalid peer correspondence id\");\n const path = join(\n herdsmanDataRoot(),\n \"runtime\",\n \"peer-correspondences\",\n `${id}.json`,\n );\n let current: unknown;\n try {\n current = JSON.parse(readFileSync(path, \"utf8\"));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw error;\n }\n if (!valid(current) || current.id !== id)\n throw new Error(\"invalid peer correspondence\");\n return current;\n}\nexport function verifyPeerCorrespondence(c: PeerCorrespondence): void {\n if (!valid(c)) throw new Error(\"invalid peer correspondence\");\n const current = readPeerCorrespondence(c.id);\n if (\n !valid(current) ||\n current.finalized ||\n (current.role ?? \"manager\") !== (c.role ?? \"manager\") ||\n [\n \"capability\",\n \"originSession\",\n \"originGeneration\",\n \"recipientSession\",\n \"recipientGeneration\",\n \"acceptanceId\",\n ].some(\n (key) =>\n current[key as keyof PeerCorrespondence] !==\n c[key as keyof PeerCorrespondence],\n )\n )\n throw new Error(\"conflicting peer correspondence\");\n}\nexport function updatePeerOriginGeneration(\n id: string,\n capability: string,\n originSession: string,\n oldGeneration: string,\n newGeneration: string,\n): PeerCorrespondence {\n if (!newGeneration) throw new Error(\"peer correspondence recovery rejected\");\n return mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession\n )\n throw new Error(\"peer correspondence recovery rejected\");\n if (c.originGeneration === newGeneration) return c;\n if (c.originGeneration !== oldGeneration)\n throw new Error(\"peer correspondence recovery rejected\");\n c.originGeneration = newGeneration;\n return c;\n });\n}\nexport function updatePeerRecipientGeneration(\n id: string,\n capability: string,\n recipientSession: string,\n oldGeneration: string,\n newGeneration: string,\n): PeerCorrespondence {\n if (!newGeneration)\n throw new Error(\"peer correspondence recipient recovery rejected\");\n return mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.recipientSession !== recipientSession\n )\n throw new Error(\"peer correspondence recipient recovery rejected\");\n if (c.recipientGeneration === newGeneration) return c;\n if (c.recipientGeneration !== oldGeneration)\n throw new Error(\"peer correspondence recipient recovery rejected\");\n c.recipientGeneration = newGeneration;\n return c;\n });\n}\nexport function removePeerCorrespondence(id: string): void {\n if (!ID.test(id)) return;\n try {\n unlinkSync(join(directory(), `${id}.json`));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\nexport function listPeerCorrespondences(): PeerCorrespondence[] {\n return readdirSync(directory()).flatMap((name) => {\n if (!ID.test(name.replace(/\\.json$/u, \"\")) || !name.endsWith(\".json\"))\n return [];\n try {\n const c: unknown = JSON.parse(\n readFileSync(join(directory(), name), \"utf8\"),\n );\n return valid(c) ? [c] : [];\n } catch {\n return [];\n }\n });\n}\nfunction matchesCapability(actual: string, expected: string): boolean {\n if (!/^[0-9a-f]{64}$/u.test(expected) || !/^[0-9a-f]{64}$/u.test(actual))\n return false;\n const actualBytes = Buffer.from(actual, \"hex\");\n const expectedBytes = Buffer.from(expected, \"hex\");\n if (timingSafeEqual(actualBytes, expectedBytes)) return true;\n return timingSafeEqual(\n Buffer.from(\n createHash(\"sha256\").update(expectedBytes).digest(\"hex\"),\n \"hex\",\n ),\n actualBytes,\n );\n}\nexport function queuePeerReply(\n c: PeerCorrespondence,\n replyId: string,\n text: string,\n evidence: PeerEvidence = { attachments: [] },\n): \"queued\" | \"duplicate\" {\n const payload = {\n text,\n ...(evidence.attachments.length\n ? { attachments: evidence.attachments }\n : {}),\n ...(evidence.resultBindings?.length\n ? { resultBindings: evidence.resultBindings }\n : {}),\n };\n if (\n !ID.test(replyId) ||\n !text ||\n Buffer.byteLength(JSON.stringify(payload), \"utf8\") >\n PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n throw new Error(\"invalid peer reply\");\n const digest = peerPayloadDigest(payload);\n return mutate(c.id, (current) => {\n if (current.finalized) throw new Error(\"peer correspondence is finalized\");\n const prior = current.replies.find((r) => r.id === replyId);\n if (prior) {\n if (prior.digest !== digest)\n throw new Error(\"conflicting peer reply identity\");\n return \"duplicate\";\n }\n const reply = {\n id: replyId,\n digest,\n text,\n ...(evidence.attachments.length\n ? { attachments: [...evidence.attachments] }\n : {}),\n ...(evidence.resultBindings?.length\n ? { resultBindings: [...evidence.resultBindings] }\n : {}),\n createdAt: Date.now(),\n acknowledged: false,\n };\n const envelope = (replies: typeof current.replies) =>\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies,\n hasReplies: true,\n });\n const single = Buffer.byteLength(envelope([reply]), \"utf8\") + 1;\n if (single > PEER_TRANSPORT_FRAME_LIMIT_BYTES)\n throw new Error(\"peer reply exceeds response limit\");\n current.replies.push(reply);\n return \"queued\";\n });\n}\nexport function pollPeerReplies(\n id: string,\n capability: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): PeerCorrespondence[\"replies\"] {\n const c = listPeerCorrespondences().find((item) => item.id === id);\n if (\n !c ||\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n const batch: PeerCorrespondence[\"replies\"] = [];\n for (const reply of c.replies.filter((item) => !item.acknowledged)) {\n const candidate = [...batch, reply];\n if (\n Buffer.byteLength(\n JSON.stringify({\n dataRoot: herdsmanDataRoot(),\n replies: candidate,\n hasReplies: c.replies.length > 0,\n }),\n \"utf8\",\n ) +\n 1 >\n PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n break;\n batch.push(reply);\n }\n return batch;\n}\nexport function acknowledgePeerReply(\n id: string,\n capability: string,\n replyId: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): void {\n pollPeerReplies(\n id,\n capability,\n originSession,\n originGeneration,\n recipientSession,\n recipientGeneration,\n );\n mutate(id, (c) => {\n if (\n c.finalized ||\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n const reply = c.replies.find((item) => item.id === replyId);\n if (!reply) throw new Error(\"unknown peer reply\");\n reply.acknowledged = true;\n reply.text = \"\";\n delete reply.attachments;\n delete reply.resultBindings;\n });\n}\nexport function finalizePeerCorrespondence(\n id: string,\n capability: string,\n originSession: string,\n originGeneration: string,\n recipientSession: string,\n recipientGeneration: string,\n): void {\n mutate(id, (c) => {\n if (\n !matchesCapability(c.capability, capability) ||\n c.originSession !== originSession ||\n c.originGeneration !== originGeneration ||\n c.recipientSession !== recipientSession ||\n c.recipientGeneration !== recipientGeneration\n )\n throw new Error(\"peer correspondence authorization failed\");\n if (c.replies.some((reply) => !reply.acknowledged))\n throw new Error(\n \"cannot finalize peer correspondence with pending replies\",\n );\n if (c.finalized) return;\n c.capability = createHash(\"sha256\")\n .update(Buffer.from(capability, \"hex\"))\n .digest(\"hex\");\n c.replies = [];\n c.finalized = true;\n });\n}\n", "import {\n mkdirSync,\n chmodSync,\n lstatSync,\n readFileSync,\n readdirSync,\n renameSync,\n unlinkSync,\n writeFileSync,\n} from \"node:fs\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { spawn } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { acquireProcessLock, ProcessLockOccupiedError } from \"./lock.ts\";\nimport { herdsmanDataRoot } from \"./storage.ts\";\n\nexport type SavedPeerMachine = Readonly<{\n id: string;\n label: string;\n target: string;\n reachable: boolean;\n}>;\nexport type RemotePeerSnapshot = Readonly<{\n dataRoot: string;\n peers: Array<{\n role?: string;\n piSessionId: string;\n claim: { id: string };\n name?: string;\n cwd?: string;\n repo?: string;\n branch?: string;\n workspaceLabel?: string;\n sessionKind?: \"ordinary\" | \"managed\";\n build?: unknown;\n }>;\n ordinaryLeadsComplete?: boolean;\n}>;\n\nexport function peerRecoveryRequest(\n request: Readonly<{\n id: string;\n capability: string;\n originSession: string;\n originGeneration: string;\n previousOriginGeneration: string;\n recipientSession: string;\n recipientGeneration: string;\n }>,\n expectedDataRoot: string,\n): string {\n return JSON.stringify({ ...request, expectedDataRoot });\n}\n\nconst COMMAND_TIMEOUT_MS = 15_000;\nexport const PEER_TRANSPORT_FRAME_LIMIT_BYTES = 2 * 1024 * 1024;\nconst OUTPUT_LIMIT = PEER_TRANSPORT_FRAME_LIMIT_BYTES;\nconst OUTBOUND_RECORD_LIMIT_BYTES = 12 * 1024 * 1024;\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;\n\nexport function peerPayloadDigest(value: unknown): string {\n const canonical = (item: unknown): string => {\n if (item === null || typeof item !== \"object\") {\n const scalar = JSON.stringify(item);\n if (scalar === undefined) throw new Error(\"invalid peer digest payload\");\n return scalar;\n }\n if (Array.isArray(item)) return `[${item.map(canonical).join(\",\")}]`;\n const object = item as Record<string, unknown>;\n return `{${Object.keys(object)\n .sort()\n .map((key) => `${JSON.stringify(key)}:${canonical(object[key])}`)\n .join(\",\")}}`;\n };\n return createHash(\"sha256\").update(canonical(value), \"utf8\").digest(\"hex\");\n}\n\nexport type RemotePeerOutbound = Readonly<{\n id: string;\n machine: SavedPeerMachine;\n dataRoot: string;\n session: string;\n claimId: string;\n recipientSession: string;\n digest: string;\n envelope: string;\n}>;\n\nexport function resolveRemotePeerOutboundRetry(\n outbound: RemotePeerOutbound,\n status: {\n dataRoot?: unknown;\n id?: unknown;\n digest?: unknown;\n status?: unknown;\n },\n snapshot: RemotePeerSnapshot,\n): { kind: \"accepted\" | \"pending\" } | { kind: \"retry\"; envelope: string } {\n if (\n status.dataRoot !== outbound.dataRoot ||\n status.id !== outbound.id ||\n status.digest !== outbound.digest ||\n snapshot.dataRoot !== outbound.dataRoot\n )\n return { kind: \"pending\" };\n if (status.status === \"accepted\") return { kind: \"accepted\" };\n if (status.status !== \"absent\") return { kind: \"pending\" };\n let correspondenceRole: \"manager\" | \"lead\";\n try {\n const parsed: unknown = JSON.parse(outbound.envelope);\n if (!parsed || typeof parsed !== \"object\") return { kind: \"pending\" };\n const correspondence = (parsed as { correspondence?: { role?: unknown } })\n .correspondence;\n const source = (\n parsed as {\n record?: { peerSource?: { role?: unknown; remoteOrdinary?: unknown } };\n }\n ).record?.peerSource;\n correspondenceRole =\n correspondence?.role === undefined\n ? \"manager\"\n : (correspondence.role as \"manager\" | \"lead\");\n if (\n (correspondenceRole !== \"manager\" && correspondenceRole !== \"lead\") ||\n (correspondenceRole === \"manager\" && source?.role !== \"manager\") ||\n (correspondenceRole === \"lead\" &&\n (source?.role !== \"lead\" || source.remoteOrdinary !== true)) ||\n (correspondenceRole === \"lead\" && snapshot.ordinaryLeadsComplete !== true)\n )\n return { kind: \"pending\" };\n } catch {\n return { kind: \"pending\" };\n }\n const recipient = snapshot.peers.find(\n (peer) =>\n peer.role === correspondenceRole &&\n peer.piSessionId === outbound.recipientSession &&\n (correspondenceRole !== \"lead\" || peer.sessionKind === \"ordinary\"),\n );\n if (!recipient) return { kind: \"pending\" };\n const envelope = JSON.parse(outbound.envelope) as {\n record?: { id?: unknown; fromSessionId?: unknown; toSessionId?: unknown };\n recipientClaimId?: unknown;\n correspondence?: {\n originSession?: unknown;\n recipientSession?: unknown;\n recipientGeneration?: unknown;\n };\n };\n if (\n envelope.record?.id !== outbound.id ||\n envelope.record.fromSessionId !== outbound.session ||\n envelope.record.toSessionId !== outbound.recipientSession ||\n envelope.correspondence?.originSession !== outbound.session ||\n envelope.correspondence.recipientSession !== outbound.recipientSession\n )\n return { kind: \"pending\" };\n const full = JSON.parse(outbound.envelope) as {\n record: unknown;\n attachments?: unknown;\n };\n if (\n peerPayloadDigest({\n record: full.record,\n attachments: full.attachments,\n }) !== outbound.digest\n )\n return { kind: \"pending\" };\n if (envelope.recipientClaimId !== recipient.claim.id) {\n envelope.recipientClaimId = recipient.claim.id;\n envelope.correspondence.recipientGeneration = recipient.claim.id;\n }\n return { kind: \"retry\", envelope: JSON.stringify(envelope) };\n}\n\nfunction outboundDirectoryPath(): string {\n return join(herdsmanDataRoot(), \"runtime\", \"peers-v2\", \"remote-outbound\");\n}\n\nfunction outboundDirectory(): string {\n const path = outboundDirectoryPath();\n mkdirSync(path, { recursive: true, mode: 0o700 });\n chmodSync(path, 0o700);\n return path;\n}\n\nexport function tryClaimRemotePeerOutbound(\n id: string,\n): (() => void) | undefined {\n try {\n return acquireProcessLock(\n join(outboundDirectory(), `${id}.delivery.lock`),\n { name: \"peer outbound delivery\" },\n ).release;\n } catch (error) {\n if (error instanceof ProcessLockOccupiedError) return undefined;\n throw error;\n }\n}\n\nexport function persistRemotePeerOutbound(outbound: RemotePeerOutbound): void {\n const frameBytes = Buffer.byteLength(outbound.envelope, \"utf8\");\n const recordBytes = Buffer.byteLength(JSON.stringify(outbound), \"utf8\");\n if (\n !UUID.test(outbound.id) ||\n frameBytes > PEER_TRANSPORT_FRAME_LIMIT_BYTES ||\n recordBytes > OUTBOUND_RECORD_LIMIT_BYTES\n )\n throw new Error(\"invalid remote peer outbound record\");\n const path = join(outboundDirectory(), `${outbound.id}.json`);\n writeFileSync(path, `${JSON.stringify(outbound)}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n}\n\nexport function retargetRemotePeerOutbound(\n id: string,\n digest: string,\n recipientSession: string,\n envelope: string,\n): RemotePeerOutbound {\n const path = join(outboundDirectory(), `${id}.json`);\n const lock = acquireProcessLock(`${path}.lock`, {\n name: \"peer outbound update\",\n });\n try {\n const current = listRemotePeerOutbounds().find((item) => item.id === id);\n if (\n !current ||\n current.digest !== digest ||\n current.recipientSession !== recipientSession\n )\n throw new Error(\"remote peer outbound identity changed\");\n const updated = { ...current, envelope };\n if (\n Buffer.byteLength(JSON.stringify(updated), \"utf8\") >\n OUTBOUND_RECORD_LIMIT_BYTES ||\n Buffer.byteLength(envelope, \"utf8\") > PEER_TRANSPORT_FRAME_LIMIT_BYTES\n )\n throw new Error(\"invalid remote peer outbound record\");\n const temporary = `${path}.${randomUUID()}.tmp`;\n writeFileSync(temporary, `${JSON.stringify(updated)}\\n`, {\n encoding: \"utf8\",\n flag: \"wx\",\n mode: 0o600,\n flush: true,\n });\n try {\n renameSync(temporary, path);\n } catch (error) {\n unlinkSync(temporary);\n throw error;\n }\n return updated;\n } finally {\n lock.release();\n }\n}\n\nfunction loadRemotePeerOutbound(\n path: string,\n id: string,\n): RemotePeerOutbound | undefined {\n try {\n const stat = lstatSync(path);\n if (\n !stat.isFile() ||\n stat.isSymbolicLink() ||\n stat.size > OUTBOUND_RECORD_LIMIT_BYTES\n )\n return undefined;\n const value: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n !value ||\n typeof value !== \"object\" ||\n (value as RemotePeerOutbound).id !== id ||\n typeof (value as RemotePeerOutbound).envelope !== \"string\"\n )\n return undefined;\n return value as RemotePeerOutbound;\n } catch {\n return undefined;\n }\n}\n\nexport function readRemotePeerOutbound(\n id: string,\n): RemotePeerOutbound | undefined {\n if (!UUID.test(id)) return undefined;\n return loadRemotePeerOutbound(\n join(outboundDirectoryPath(), `${id}.json`),\n id,\n );\n}\n\nexport function listRemotePeerOutbounds(): RemotePeerOutbound[] {\n const directory = outboundDirectory();\n return readdirSync(directory)\n .filter((name) => UUID.test(name.slice(0, -5)) && name.endsWith(\".json\"))\n .flatMap((name) => {\n const outbound = loadRemotePeerOutbound(\n join(directory, name),\n name.slice(0, -5),\n );\n return outbound ? [outbound] : [];\n });\n}\n\nexport function removeRemotePeerOutbound(id: string): void {\n if (!UUID.test(id)) return;\n try {\n unlinkSync(join(outboundDirectory(), `${id}.json`));\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n }\n}\n\nfunction run(\n command: string,\n args: readonly string[],\n input?: string,\n signal?: AbortSignal,\n): Promise<string> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(new Error(\"Peer transport was cancelled\"));\n return;\n }\n const child = spawn(command, [...args], {\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n });\n let stdout = \"\";\n let stderr = \"\";\n let size = 0;\n let settled = false;\n let stdinError: Error | undefined;\n const timeout = setTimeout(() => child.kill(\"SIGKILL\"), COMMAND_TIMEOUT_MS);\n let abortKill: ReturnType<typeof setTimeout> | undefined;\n const cancel = () => {\n child.kill(\"SIGTERM\");\n abortKill = setTimeout(() => child.kill(\"SIGKILL\"), 1_000);\n };\n signal?.addEventListener(\"abort\", cancel, { once: true });\n const cleanup = () => {\n clearTimeout(timeout);\n if (abortKill) clearTimeout(abortKill);\n signal?.removeEventListener(\"abort\", cancel);\n child.stdin.removeListener(\"error\", onStdinError);\n };\n const finish = (error?: Error, value?: string) => {\n if (settled) return;\n settled = true;\n cleanup();\n if (error) reject(error);\n else resolve(value ?? \"\");\n };\n const onStdinError = (error: Error) => {\n stdinError ??= error;\n };\n child.stdin.on(\"error\", onStdinError);\n const collect = (target: \"stdout\" | \"stderr\", chunk: Buffer) => {\n size += chunk.length;\n if (size > OUTPUT_LIMIT) {\n child.kill(\"SIGKILL\");\n return;\n }\n if (target === \"stdout\") stdout += chunk.toString(\"utf8\");\n else stderr += chunk.toString(\"utf8\");\n };\n child.stdout.on(\"data\", (chunk: Buffer) => collect(\"stdout\", chunk));\n child.stderr.on(\"data\", (chunk: Buffer) => collect(\"stderr\", chunk));\n child.once(\"error\", (error) => {\n finish(error);\n });\n child.once(\"close\", (code) => {\n if (stdinError) finish(stdinError);\n else if (signal?.aborted)\n finish(new Error(\"Peer transport was cancelled\"));\n else if (code === 0) finish(undefined, stdout);\n else {\n const error = new Error(stderr.trim() || `${command} exited ${code}`);\n Object.assign(error, { exitCode: code });\n finish(error);\n }\n });\n child.stdin.end(input);\n });\n}\n\nexport async function listSavedPeerMachines(\n signal?: AbortSignal,\n): Promise<SavedPeerMachine[]> {\n const [listText, statusText] = await Promise.all([\n run(\"herdr\", [\"machine\", \"list\", \"--json\"], undefined, signal),\n run(\"herdr\", [\"machine\", \"status\", \"--json\"], undefined, signal),\n ]);\n const list: unknown = JSON.parse(listText);\n const statuses: unknown = JSON.parse(statusText);\n if (!Array.isArray(list) || !Array.isArray(statuses))\n throw new Error(\"Herdr returned invalid machine data\");\n const statusById = new Map<string, string>(\n statuses\n .filter(\n (item): item is { id: string; status: string } =>\n !!item &&\n typeof item === \"object\" &&\n typeof (item as { id?: unknown }).id === \"string\" &&\n (item as { status?: unknown }).status === \"reachable\",\n )\n .map((item) => [item.id, item.status]),\n );\n const machines = list.flatMap((item) => {\n if (\n !item ||\n typeof item !== \"object\" ||\n (item as { enabled?: unknown }).enabled !== true ||\n typeof (item as { id?: unknown }).id !== \"string\" ||\n typeof (item as { label?: unknown }).label !== \"string\" ||\n typeof (item as { target?: unknown }).target !== \"string\"\n )\n return [];\n return [\n {\n id: (item as { id: string }).id,\n label: (item as { label: string }).label,\n target: (item as { target: string }).target,\n reachable: statusById.get((item as { id: string }).id) === \"reachable\",\n },\n ];\n });\n return machines;\n}\n\nexport function parsePeerSshTarget(target: string): {\n host: string;\n port?: string;\n} {\n if (target.startsWith(\"ssh://\")) {\n const url = new URL(target);\n if (\n url.protocol !== \"ssh:\" ||\n !url.hostname ||\n (url.pathname !== \"\" && url.pathname !== \"/\") ||\n url.search ||\n url.hash\n )\n throw new Error(\"Unsupported saved SSH target\");\n const username = url.username ? `${decodeURIComponent(url.username)}@` : \"\";\n const host = `${username}${url.hostname}`;\n if (/^[\\s-]|[\\s\\0]/u.test(host))\n throw new Error(\"Unsupported saved SSH target\");\n return {\n host,\n ...(url.port ? { port: url.port } : {}),\n };\n }\n if (!target || /[\\s\\0]/u.test(target) || target.startsWith(\"-\"))\n throw new Error(\"Unsupported saved SSH target\");\n return { host: target };\n}\n\nexport async function runPeerEndpoint(\n machine: SavedPeerMachine,\n action:\n | \"probe\"\n | \"accept\"\n | \"status\"\n | \"poll\"\n | \"ack\"\n | \"finalize\"\n | \"recover\"\n | \"recover-recipient\",\n input?: string,\n signal?: AbortSignal,\n): Promise<string> {\n const target = parsePeerSshTarget(machine.target);\n const args = [\n \"-T\",\n \"-o\",\n \"BatchMode=yes\",\n \"-o\",\n \"StrictHostKeyChecking=yes\",\n \"-o\",\n \"ConnectTimeout=10\",\n ...(target.port ? [\"-p\", target.port] : []),\n target.host,\n `pi-herdsman-peer ${action}`,\n ];\n return run(\"ssh\", args, input, signal);\n}\n\nexport async function tryPollPeerReplies(\n poll: () => Promise<string>,\n): Promise<string | undefined> {\n try {\n return await poll();\n } catch {\n return undefined;\n }\n}\n\nexport async function probePeerEndpoint(\n machine: SavedPeerMachine,\n signal?: AbortSignal,\n): Promise<RemotePeerSnapshot> {\n const output = await runPeerEndpoint(machine, \"probe\", undefined, signal);\n const probe: unknown = JSON.parse(output);\n if (\n !probe ||\n typeof probe !== \"object\" ||\n typeof (probe as { dataRoot?: unknown }).dataRoot !== \"string\" ||\n !Array.isArray((probe as { peers?: unknown }).peers)\n )\n throw new Error(\"Peer endpoint returned invalid probe data\");\n const snapshot = probe as RemotePeerSnapshot;\n if (\n snapshot.peers.some(\n (peer) =>\n !peer ||\n typeof peer !== \"object\" ||\n typeof peer.piSessionId !== \"string\" ||\n peer.piSessionId.length === 0 ||\n !peer.claim ||\n typeof peer.claim.id !== \"string\" ||\n peer.claim.id.length === 0 ||\n (peer.role !== \"manager\" && peer.role !== \"lead\") ||\n (peer.role === \"lead\" &&\n peer.sessionKind !== \"ordinary\" &&\n peer.sessionKind !== \"managed\"),\n ) ||\n (snapshot.ordinaryLeadsComplete !== undefined &&\n typeof snapshot.ordinaryLeadsComplete !== \"boolean\")\n )\n throw new Error(\"Peer endpoint returned invalid probe data\");\n return snapshot;\n}\n", "export type PeerAcceptanceCutPoint =\n \"pending-marker-durable\" | \"inbox-publication-durable\";\n\nlet testHook: ((cutPoint: PeerAcceptanceCutPoint) => void) | undefined;\nlet pendingMarkerTempWriteHook: (() => void) | undefined;\nlet pendingMarkerWriteLimitHook: ((requested: number) => number) | undefined;\nlet pendingMarkerPublishHook:\n ((marker: string, content: string) => void) | undefined;\nlet acceptedMarkerTempWriteHook:\n ((temporary: string, marker: string) => void) | undefined;\n\nexport function afterDurablePeerAcceptanceStep(\n cutPoint: PeerAcceptanceCutPoint,\n): void {\n testHook?.(cutPoint);\n}\n\n/** Internal dependency seam used only by child-process crash regression tests. */\nexport function setPeerAcceptanceFaultHookForTests(\n hook: (cutPoint: PeerAcceptanceCutPoint) => void,\n): void {\n testHook = hook;\n}\n\nexport function afterPendingMarkerTempWriteForTests(): void {\n pendingMarkerTempWriteHook?.();\n}\n\nexport function setPendingMarkerTempWriteHookForTests(hook: () => void): void {\n pendingMarkerTempWriteHook = hook;\n}\n\nexport function pendingMarkerWriteLimitForTests(requested: number): number {\n return pendingMarkerWriteLimitHook?.(requested) ?? requested;\n}\n\nexport function setPendingMarkerWriteLimitForTests(\n hook: (requested: number) => number,\n): void {\n pendingMarkerWriteLimitHook = hook;\n}\n\nexport function beforePendingMarkerPublishForTests(\n marker: string,\n content: string,\n): void {\n pendingMarkerPublishHook?.(marker, content);\n}\n\nexport function setPendingMarkerPublishHookForTests(\n hook: (marker: string, content: string) => void,\n): void {\n pendingMarkerPublishHook = hook;\n}\n\nexport function afterAcceptedMarkerTempWriteForTests(\n temporary: string,\n marker: string,\n): void {\n acceptedMarkerTempWriteHook?.(temporary, marker);\n}\n\nexport function setAcceptedMarkerTempWriteHookForTests(\n hook: (temporary: string, marker: string) => void,\n): void {\n acceptedMarkerTempWriteHook = hook;\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["createHash", "randomUUID", "closeSync", "fsyncSync", "mkdirSync", "openSync", "readFileSync", "renameSync", "rmSync", "writeSync", "writeFileSync", "basename", "dirname", "isAbsolute", "join", "fileURLToPath", "isDeepStrictEqual", "chmodSync", "closeSync", "fsyncSync", "mkdirSync", "openSync", "readdirSync", "readFileSync", "renameSync", "lstatSync", "unlinkSync", "createHash", "randomUUID", "basename", "dirname", "join", "createHash", "error", "code", "join", "lstatSync", "readFileSync", "join", "directory", "join", "directory", "createHash", "mkdirSync", "dirname", "chmodSync", "readFileSync", "constants", "chmodSync", "closeSync", "fsyncSync", "lstatSync", "fstatSync", "readdirSync", "mkdirSync", "openSync", "readFileSync", "renameSync", "unlinkSync", "writeFileSync", "createHash", "randomUUID", "basename", "dirname", "join", "UUID", "UUID", "runtime", "join", "createHash", "runtime", "readFileSync", "directory", "openSync", "fsyncSync", "closeSync", "dirname", "join", "basename", "randomUUID", "writeFileSync", "renameSync", "chmodSync", "unlinkSync", "createHash", "lstatSync", "constants", "fstatSync", "runtime", "directory", "mkdirSync", "chmodSync", "join", "randomUUID", "openSync", "writeFileSync", "fsyncSync", "closeSync", "renameSync", "unlinkSync", "readFileSync", "runtime", "openSync", "writeFileSync", "fsyncSync", "closeSync", "dirname", "createHash", "join", "join", "runtime", "join", "createHash", "runtime", "readFileSync", "runtime", "readdirSync", "join", "readFileSync", "UUID", "lstatSync", "readFileSync", "basename", "dirname", "createHash", "lstatSync", "join", "readdirSync", "directory", "createHash", "createHash", "randomUUID", "chmodSync", "mkdirSync", "readFileSync", "readdirSync", "renameSync", "unlinkSync", "writeFileSync", "join", "createHash", "randomUUID", "createHash", "join", "mkdirSync", "chmodSync", "createHash", "randomUUID", "writeFileSync", "renameSync", "action", "join", "readFileSync", "readdirSync", "readFileSync", "join", "createHash", "createHash", "isAbsolute", "dirname", "fileURLToPath", "readFileSync", "join", "basename", "directory", "openSync", "fsyncSync", "closeSync", "digest", "key", "createHash", "marker", "correspondenceRole", "mkdirSync", "randomUUID", "bytes", "writeSync", "error", "rmSync", "isDeepStrictEqual", "writeFileSync", "renameSync"]
|
|
7
7
|
}
|