@akagilnc/pi-workflow-roles 0.1.5941 → 0.1.5949

package/dist/acp-host/production-host.js

@@ -1519,15 +1519,15 @@ function withTerminatingOutputDeclarations(schema) {
     ...baseProperties ?? {},
     ...baseProperties?.ticketNumber === void 0 ? {
       ticketNumber: Type2.Unknown({
-        description: "\u53EF\u9009\u672C\u7968\u53F7\u3002\u5C1A\u672A\u7ED1\u5B9A\u65F6\u7531\u89D2\u8272\u5728\u65E2\u6709\u56DE\u6267\u4E2D\u7533\u62A5\uFF08\u6B63\u6574\u6570\u3001\u6570\u5B57\u4E32\u6216\u524D\u5BFC #N\uFF1B\u5F52\u4F4D\u53EA\u8BFB\u672C\u5B57\u6BB5\uFF09\u3002"
+        description: "\u4EC5\u5C1A\u672A\u7ED1\u5B9A\u65F6\u586B\u672C\u7968\u53F7\uFF08\u6B63\u6574\u6570\u3001\u6570\u5B57\u4E32\u6216\u524D\u5BFC #N\uFF1B\u5F52\u4F4D\u53EA\u8BFB\u672C\u5B57\u6BB5\uFF09\uFF1B\u6CA1\u6709\u5C31\u586B null"
       })
     } : {},
     ...baseProperties?.summary === void 0 ? {
       summary: Type2.Unknown({
-        description: "\u672C\u5E2D\u81EA\u884C\u586B\u5199\u7684\u4E00\u4E24\u53E5\u300120\u201350 \u5B57\u7ED3\u8BBA\u6458\u8981\u3002\u53EF\u9009\uFF1B\u4E0D\u56E0\u7F3A\u5931\u6216\u8D85\u957F\u62D2\u6536\u3001\u622A\u65AD\u6216\u4EE3\u586B\u3002"
+        description: "\u4EC5\u672C\u5E2D\u6709\u7ED3\u8BBA\u65F6\u586B\u4E00\u4E24\u53E5\u300120\u201350 \u5B57\u7ED3\u8BBA\u6458\u8981\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002\u4E0D\u56E0\u7F3A\u5931\u6216\u8D85\u957F\u62D2\u6536\u3001\u622A\u65AD\u6216\u4EE3\u586B\u3002"
       })
     } : {},
-    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureDeclarationSchema.properties[INFRASTRUCTURE_FAILURE_DECLARATION_KEY]
+    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureField
   };
   const object = Type2.Object(properties, { additionalProperties: true });
   const incoming = schema.required;
@@ -1535,30 +1535,14 @@ function withTerminatingOutputDeclarations(schema) {
   object.required = preserved;
   return object;
 }
-var INFRASTRUCTURE_FAILURE_DECLARATION_KEY, INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY, infrastructureFailureNested, infrastructureFailureDeclarationSchema;
+var INFRASTRUCTURE_FAILURE_DECLARATION_KEY, infrastructureFailureField;
 var init_terminating_infrastructure = __esm({
   "src/package-contracts/terminating-infrastructure.ts"() {
     "use strict";
     INFRASTRUCTURE_FAILURE_DECLARATION_KEY = "infrastructureFailure";
-    INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
-    infrastructureFailureNested = Type2.Object(
-      {
-        [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type2.Unknown({
-          description: "\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD\u5B57\u7B26\u4E32\u3002"
-        })
-      },
-      {
-        additionalProperties: true,
-        description: "\u4EC5\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u65F6\u51FA\u73B0\u3002"
-      }
-    );
-    infrastructureFailureNested.required = [];
-    infrastructureFailureDeclarationSchema = Type2.Object(
-      {
-        [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureNested
-      },
-      { additionalProperties: true }
-    );
+    infrastructureFailureField = Type2.Unknown({
+      description: "\u4EC5\u57FA\u7840\u8BBE\u65BD\u771F\u5B9E\u5931\u8D25\u65F6\u586B {diagnostic}\uFF1B\u6CA1\u6709\u5C31\u586B null"
+    });
   }
 });
 
@@ -1578,10 +1562,10 @@ var init_gatekeeper_output = __esm({
           description: "dispatch | pass"
         }),
         officer: Type3.Unknown({
-          description: "status \u4E3A dispatch \u65F6\u4E3A inspector | notary"
+          description: "\u4EC5 status \u4E3A dispatch \u65F6\u586B inspector | notary\uFF1B\u6CA1\u6709\u5C31\u586B null"
         }),
         findings: Type3.Unknown({
-          description: "status \u4E3A pass \u65F6\u53EF\u9009 string[] findings"
+          description: "\u4EC5 status \u4E3A pass \u65F6\u586B string[] findings\uFF1B\u6CA1\u6709\u5C31\u586B null"
         })
       })
     );
@@ -1682,13 +1666,13 @@ var init_navigator_output = __esm({
     NAVIGATOR_OUTPUT_TOOL_NAME = "ak_navigator_output";
     navigatorAdviceFields = {
       prose: Type4.Unknown({
-        description: "\u5355\u6761\u6563\u6587\u5EFA\u8BAE\u3002\u65E0\u72B6\u6001\u5206\u53C9\u65F6\u4F7F\u7528\uFF1B\u539F\u6837\u5448\u73B0\u3002"
+        description: "\u4EC5\u65E0\u72B6\u6001\u5206\u53C9\u65F6\u586B\u5355\u6761\u6563\u6587\u5EFA\u8BAE\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002\u539F\u6837\u5448\u73B0\u3002"
       }),
       byStatus: Type4.Unknown({
         description: "\u6309\u4E3B\u8859\u95E8\u7ED3\u5C40 status \u9884\u5199\u7684\u6563\u6587\u5EFA\u8BAE\u3002\u952E\u4E3A status \u5B57\u9762\u91CF\uFF0C\u503C\u4E3A\u5EFA\u8BAE\u6B63\u6587\u3002\u7ED3\u7B97\u65F6\u4EE3\u7801\u53EA\u6309\u5B9E\u9645 status \u53D6\u5BF9\u5E94\u539F\u6587\uFF0C\u4E0D\u89E3\u6790\u5EFA\u8BAE\u8BED\u4E49\u3002"
       }),
       byRole: Type4.Unknown({
-        description: "\u6574\u5F20\u8DEF\u7EBF\u8868\uFF1A\u952E\u4E3A\u8859\u95E8\u89D2\u8272\uFF0C\u503C\u4E3A\u8BE5\u8859\u95E8 status \u2192 \u5EFA\u8BAE\u3002\u76F4\u63A5\u5165\u53E3\u4E0D\u7ED9\u89D2\u8272\u65F6\u4F7F\u7528\u3002"
+        description: "\u4EC5\u76F4\u63A5\u5165\u53E3\u4E0D\u7ED9\u89D2\u8272\u65F6\u586B\u6574\u5F20\u8DEF\u7EBF\u8868\uFF08\u952E\u4E3A\u8859\u95E8\u89D2\u8272\uFF0C\u503C\u4E3A\u8BE5\u8859\u95E8 status \u2192 \u5EFA\u8BAE\uFF09\uFF1B\u6CA1\u6709\u5C31\u586B null"
       })
     };
     navigatorAdviceBodySchema = openToolObject(Type4.Object(navigatorAdviceFields));
@@ -1721,7 +1705,7 @@ var init_review_submission = __esm({
       reason: Type5.Optional(Type5.Unknown({ description: "\u4E0A\u5448\u7406\u7531" })),
       violations: Type5.Optional(Type5.Unknown({ description: "\u8FDD\u89C4\u6761\u76EE" })),
       conflicts: Type5.Optional(Type5.Unknown({ description: "\u5F85\u51B3\u51B2\u7A81" })),
-      fix: Type5.Optional(Type5.Unknown({ description: "continue \u65F6\u7684\u8865\u6551\u8BF4\u660E\uFF1B\u53EF\u5199 summary \u6458\u8981\uFF0C\u5176\u4F59\u5185\u5BB9\u539F\u6837\u7559\u5B58" })),
+      fix: Type5.Optional(Type5.Unknown({ description: "\u4EC5 continue \u65F6\u586B\u8865\u6551\u8BF4\u660E\uFF08\u53EF\u5199 summary \u6458\u8981\uFF0C\u5176\u4F59\u5185\u5BB9\u539F\u6837\u7559\u5B58\uFF09\uFF1B\u6CA1\u6709\u5C31\u586B null" })),
       classes: Type5.Optional(Type5.Unknown({ description: "\u5DF2\u88C1\u51B3 finding \u7C7B\uFF1B\u53EF\u8BF4\u660E name\u3001owner\u3001boundary\u3001disposition\uFF0C\u539F\u6837\u7559\u5B58" })),
       note: Type5.Optional(Type5.Unknown({ description: "\u88C1\u51B3\u9644\u6CE8" })),
       evidence: Type5.Optional(Type5.Unknown({ description: "\u7559\u5B58\u8BC1\u636E" })),
@@ -1812,7 +1796,7 @@ var init_reviewer_output = __esm({
     init_open_tool_schema();
     init_terminating_infrastructure();
     REVIEWER_OUTPUT_TOOL_NAME = "ak_reviewer_output";
-    REVIEWER_AMENDMENTS_DESCRIPTION = "\u5DF2\u8FD0\u884C lens \u7684 amendments \u627F\u8F7D candidates\u3001\u9010\u6761\u5904\u7F6E\u4E0E verdict \u7684\u5B8C\u6574\u62A5\u544A\uFF08\u975E\u4EC5 verdict \u884C\uFF09\uFF1B\u663E\u5F0F\u5355\u8F74\u65F6\u53E6\u4E00\u8F74\u53EF\u7701\u7565\uFF08completeness / correctness\uFF09\u3002hard-stop\uFF0Fusage error \u4E3A refused \u65F6\uFF0C\u5DF2\u4EA7\u51FA\u62A5\u544A\u4ECD\u7167\u5F55\u5BF9\u5E94 lens \u5B57\u6BB5\u3002";
+    REVIEWER_AMENDMENTS_DESCRIPTION = "\u5DF2\u8FD0\u884C lens \u7684 amendments \u627F\u8F7D candidates\u3001\u9010\u6761\u5904\u7F6E\u4E0E verdict \u7684\u5B8C\u6574\u62A5\u544A\uFF08\u975E\u4EC5 verdict \u884C\uFF09\uFF1B\u5404\u8F74\uFF08completeness / correctness\uFF09\u4EC5\u6709\u5DF2\u4EA7\u51FA\u62A5\u544A\u65F6\u586B\u62A5\u544A\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002hard-stop\uFF0Fusage error \u4E3A refused \u65F6\uFF0C\u5DF2\u4EA7\u51FA\u62A5\u544A\u4ECD\u7167\u5F55\u5BF9\u5E94 lens \u5B57\u6BB5\u3002";
     REVIEWER_STATUS_DESCRIPTION = "completed | refused\u3002\u4E24\u79CD\u6B63\u5E38 lens verdict\uFF08completeness / correctness\uFF09\u5747 completed\uFF1Bhard-stop \u4E0E usage error \u4E3A refused\uFF08\u5DF2\u4EA7\u51FA\u62A5\u544A\u4ECD\u7167\u5F55\u8FDB\u6240\u9009 lens amendments\uFF09\u3002";
     reviewerOutputObject = Type6.Object({
       status: Type6.Unknown({ description: REVIEWER_STATUS_DESCRIPTION }),
@@ -1871,7 +1855,7 @@ var init_fixer_output = __esm({
       }),
       diffItems: diffItemsField,
       testEvidence: Type8.Unknown({
-        description: "\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1Bdiff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u63D0\u4EA4\uFF1B\u673A\u5668\u4E0D\u6838\u9A8C\u3002\u53EF\u5199 contract\uFF08\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6\uFF09\u3001minimumNecessaryCost\uFF08\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C\uFF09\u3001measuredDuration\uFF08\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F\uFF09\u3002"
+        description: "\u4EC5 diff \u542B\u6D4B\u8BD5\u6539\u52A8\u65F6\u586B\u6D4B\u8BD5\u8BC1\u636E\u6761\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002\u673A\u5668\u4E0D\u6838\u9A8C\u3002\u53EF\u5199 contract\uFF08\u6D4B\u8BD5\u6539\u52A8\u6240\u8BC1\u660E\u7684\u5951\u7EA6\uFF09\u3001minimumNecessaryCost\uFF08\u6D4B\u8BD5\u6539\u52A8\u7684\u4E00\u884C\u6700\u5C0F\u5FC5\u8981\u6210\u672C\uFF09\u3001measuredDuration\uFF08\u805A\u7126\u9A8C\u8BC1\u5B9E\u6D4B\u65F6\u957F\uFF09\u3002"
       })
     });
     fixerOutputSchema = withTerminatingOutputDeclarations(
@@ -1956,7 +1940,7 @@ var init_doctor_contracts = __esm({
         description: `\u9010\u6761\u8D44\u4EA7\u89C2\u5BDF\u4E0E\u5904\u65B9\uFF0C\u539F\u6837\u7559\u5B58\u3002\u4E00\u6761\u53EF\u542B targetKey\u3001targetKind\uFF08${DOCTOR_TARGET_KINDS.join(" | ")}\uFF09\u3001observation\u3001evidenceIds\u3001disposition\uFF08${DOCTOR_DISPOSITIONS.join(" | ")}\uFF09\u3001assetEvidence\uFF08targetKey\u3001targetKind\u3001evidenceId\uFF09\u3001guardrails\uFF08reproducibleFailure\u3001owningSeamOrInvariant\u3001deletionOrSimplificationSuffices\uFF0C\u5404\u9879\u53EF\u542B answer\u3001evidenceIds\u3001explanation\uFF09\u3001prescription\uFF08kind \u4E3A ${DOCTOR_PRESCRIPTION_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 recommendation\u3001necessityExplanation\uFF09\u3001lastRealBite\uFF08kind \u4E3A ${DOCTOR_BITE_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 targetKey\u3001evidenceId\u3001eligibleEvidenceIds\uFF09\u3002\u4E0D\u8981\u6C42\u4EFB\u4F55\u5904\u65B9\u6216\u53EF\u590D\u7528 finding\uFF1B\u7F3A\u53EF\u590D\u7528\u8D44\u4EA7\u6216 bounded-bite \u8BC1\u636E\u53EA\u6392\u9664\u5BF9\u5E94\u8D44\u4EA7\u5904\u65B9\u3002\u673A\u5668\u4E0D\u6838\u9A8C\u3002`
       }),
       reason: Type10.Unknown({
-        description: "\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0\uFF1B\u4EC5 refused \u65F6\u7528\u3002"
+        description: "\u4EC5 refused \u65F6\u586B\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0\uFF1B\u6CA1\u6709\u5C31\u586B null"
       }),
       missingEvidence: Type10.Unknown({
         description: "\u5982\u5B9E\u8BC1\u8BCD\u6240\u9700\u800C\u5C1A\u7F3A\u7684\u8BC1\u636E\uFF0C\u539F\u6837\u7559\u5B58\uFF08\u5982\u6BCF\u9879 need\u3001targetKeys\uFF09\u3002"
@@ -2247,7 +2231,7 @@ var init_ticket_provenance_contracts = __esm({
 import { Type as Type13 } from "typebox";
 function projectDiaristSessions(value) {
   const raw = value?.sessions;
-  if (raw === void 0) return [];
+  if (raw == null) return [];
   return projectTicketProvenanceSessions(raw);
 }
 function projectDiaristTicketSessions(value) {
@@ -2284,15 +2268,17 @@ var init_diarist_contracts = __esm({
           }),
           ticketNumber: Type13.Optional(
             Type13.Unknown({
-              description: "\u672C\u5EAD\u5BF9\u8C61\u7968\u53F7\uFF08\u6B63\u6574\u6570\uFF09\u6216 null/\u7701\u7565\uFF1D\u771F\u65E0\u7968\uFF1B\u4E0B\u6E38\u8D70 typed \u952E\uFF1B\u8BA4\u4E0D\u51FA\u7528 status=escalate\uFF0C\u4E0D\u6D17\u6210\u65E0\u5F55\u3002\u673A\u68B0\u5C42\u4E0D\u91CD\u5224\u3002"
+              description: "\u4EC5\u6709\u672C\u5EAD\u5BF9\u8C61\u65F6\u586B\u7968\u53F7\uFF08\u6B63\u6574\u6570\uFF09\uFF1B\u6CA1\u6709\u5C31\u586B null\uFF1D\u771F\u65E0\u7968\uFF1B\u4E0B\u6E38\u8D70 typed \u952E\uFF1B\u8BA4\u4E0D\u51FA\u7528 status=escalate\uFF0C\u4E0D\u6D17\u6210\u65E0\u5F55\u3002\u673A\u68B0\u5C42\u4E0D\u91CD\u5224\u3002"
             })
           ),
           reason: Type13.Unknown({
-            description: "status \u4E3A escalate \u65F6\uFF1A\u4E0A\u5448\u7684\u539F\u56E0"
+            description: "\u4EC5 status \u4E3A escalate \u65F6\u586B\u4E0A\u5448\u7684\u539F\u56E0\uFF1B\u6CA1\u6709\u5C31\u586B null"
           }),
-          sessions: Type13.Optional(Type13.Unknown({ description: DIARIST_SESSIONS_DESCRIPTION })),
+          sessions: Type13.Optional(Type13.Unknown({
+            description: `\u4EC5\u5355\u7968\u5EAD\u65F6\u586B\u5BF9\u8BDD\u8FB9\u754C\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002${DIARIST_SESSIONS_DESCRIPTION}`
+          })),
           ticketSessions: Type13.Unknown({
-            description: `\u591A\u7968\u5EAD\u9010\u7968\u5BF9\u8BDD\u8FB9\u754C\uFF1B\u6BCF\u7968\u542B ticketNumber\uFF08\u672C\u6761\u8FB9\u754C\u6240\u5F52\u7968\u53F7\uFF0C\u6B63\u6574\u6570\uFF09\u4E0E sessions\uFF08${DIARIST_SESSIONS_DESCRIPTION}\uFF09\u3002\u4E00\u6B21\u4EA4\u5377\u5404\u7968\u5404\u81EA\u5206\u5F55\u3002\u4E0E\u5355\u7968 sessions \u4E8C\u9009\u4E00\u3002`
+            description: `\u4EC5\u591A\u7968\u5EAD\u65F6\u586B\u9010\u7968\u5BF9\u8BDD\u8FB9\u754C\uFF1B\u6CA1\u6709\u5C31\u586B null\u3002\u6BCF\u7968\u542B ticketNumber\uFF08\u672C\u6761\u8FB9\u754C\u6240\u5F52\u7968\u53F7\uFF0C\u6B63\u6574\u6570\uFF09\u4E0E sessions\uFF08${DIARIST_SESSIONS_DESCRIPTION}\uFF09\u3002\u4E00\u6B21\u4EA4\u5377\u5404\u7968\u5404\u81EA\u5206\u5F55\u3002`
           })
         })
       )
@@ -3119,7 +3105,7 @@ var init_collector_tool_schemas = __esm({
           description: "\u6309\u673A\u5668\u8EAB\u4EFD\u5F52\u7EC4\u7684\u51FA\u5E2D\u3001\u6750\u6599\u4E0E\u9010\u6761 findings\uFF08LLM \u81EA\u884C\u4ECE\u5BBF\u4E3B CLI \u53D6\u8BC1\u6574\u7406\uFF1B\u4EE3\u7801\u4E0D\u4EE3\u6536\u4E0D\u5F52\u5E76\uFF09\u3002"
         }),
         unfinishedReasons: Type15.Unknown({
-          description: "\u672A\u5B8C\u6210\u539F\u56E0\uFF1B\u53D6\u8BC1\u53D7\u9650\u65F6\u5982\u5B9E\u62A5\u544A\u3002"
+          description: "\u4EC5\u53D6\u8BC1\u53D7\u9650\u65F6\u586B\u672A\u5B8C\u6210\u539F\u56E0\uFF1B\u6CA1\u6709\u5C31\u586B null"
         })
       })
     );
@@ -14233,24 +14219,48 @@ var init_post_admission = __esm({
 });
 
 // src/public-cli/seat-ticket-binding.ts
+import { join as join22 } from "node:path";
+function resumedSessionIdMissing(result, runId) {
+  if (typeof result !== "object" || result === null) return false;
+  const terminal = result.terminal;
+  if (typeof terminal !== "object" || terminal === null) return false;
+  if (terminal.runId !== runId) return false;
+  const outcome = terminal.roleOutcome;
+  if (typeof outcome !== "object" || outcome === null) return false;
+  if (outcome.kind !== "failure") return false;
+  const facts = outcome.decisiveFacts;
+  if (typeof facts !== "object" || facts === null) return false;
+  return facts.errorCode === SESSION_ID_MISSING;
+}
+async function writerLockBlocksFreshSummons(runDirectory) {
+  const autopsy = await autopsyWriterLock(join22(runDirectory, WRITER_LOCK_FILE));
+  return autopsy.verdict === "alive" || autopsy.verdict === "unknown";
+}
 async function tryResumeSameTicketSeatRun(input) {
   if (input.freshSummons === true) return void 0;
   if (input.parentRunPath.trim() === "") return void 0;
+  const bookKey = resolveBookKeyFromGit(input.projectRoot);
   const previous = await findLatestRunForSeatTicket({
     home: input.home,
-    bookKey: resolveBookKeyFromGit(input.projectRoot),
+    bookKey,
     role: input.role,
     parentRunPath: input.parentRunPath,
     ...input.ticketNumber === void 0 ? {} : { ticketNumber: input.ticketNumber }
   });
   if (previous === void 0) return void 0;
-  return await input.resume(previous.runId, input.summons, previous.runDirectory);
+  const resumed = await input.resume(previous.runId, input.summons, previous.runDirectory);
+  if (!resumedSessionIdMissing(resumed, previous.runId)) return resumed;
+  const live = await resolveLiveRunDirectoryPath(previous.runDirectory, input.home, bookKey);
+  if (live !== void 0 && await writerLockBlocksFreshSummons(live)) return resumed;
+  return void 0;
 }
+var SESSION_ID_MISSING;
 var init_seat_ticket_binding = __esm({
   "src/public-cli/seat-ticket-binding.ts"() {
     "use strict";
     init_activation_ledger_git();
     init_run_lifecycle();
+    SESSION_ID_MISSING = "session-id-missing";
   }
 });
 
@@ -15909,10 +15919,10 @@ var init_analyst_book_key = __esm({
 // src/atomic-write.ts
 import { randomUUID as randomUUID7 } from "node:crypto";
 import { rename as rename2, rm, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname14, join as join22 } from "node:path";
+import { dirname as dirname14, join as join23 } from "node:path";
 async function writeFileAtomically(destination, contents, options) {
   const parent = dirname14(destination);
-  const temporary = join22(parent, `.atomic-write-${randomUUID7()}.tmp`);
+  const temporary = join23(parent, `.atomic-write-${randomUUID7()}.tmp`);
   try {
     await writeFile3(temporary, contents, options);
     await rename2(temporary, destination);
@@ -15929,12 +15939,12 @@ var init_atomic_write = __esm({
 
 // src/analyst-index.ts
 import { open, readFile as readFile10, unlink } from "node:fs/promises";
-import { dirname as dirname15, join as join23 } from "node:path";
+import { dirname as dirname15, join as join24 } from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
 async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   const indexPath = analystLibraryIndexPath(ledgerHome);
   ensureRealDirectoryTree(ledgerHome, dirname15(indexPath));
-  const lockPath = join23(dirname15(indexPath), LIBRARY_INDEX_LOCK_NAME);
+  const lockPath = join24(dirname15(indexPath), LIBRARY_INDEX_LOCK_NAME);
   assertLedgerFileInsideHome(lockPath, ledgerHome);
   const startedAt = Date.now();
   while (true) {
@@ -15961,7 +15971,7 @@ async function withAnalystLibraryIndexLock(ledgerHome, fn) {
   }
 }
 function analystLibraryIndexPath(ledgerHome) {
-  return join23(ledgerHome, "analyst", "library-index.json");
+  return join24(ledgerHome, "analyst", "library-index.json");
 }
 function rowFromIssueMetricsPage(page) {
   return {
@@ -16255,7 +16265,7 @@ var init_analyst_cohort = __esm({
 });
 
 // src/archivist-record-pointer.ts
-import { basename as basename11, join as join24 } from "node:path";
+import { basename as basename11, join as join25 } from "node:path";
 async function resolveOfficerPointer(raw, parentRunDirectory) {
   const where = `${parentRunDirectory} officers`;
   if (!isRecord(raw) || raw.kind !== DIRECT_OFFICER_RUN_POINTER_KIND || raw.version !== 1) {
@@ -16288,7 +16298,7 @@ async function resolveOfficerPointer(raw, parentRunDirectory) {
   };
 }
 async function readBookedOfficerPointers(parentRunDirectory) {
-  const { records, diagnostics } = await readSitianRecords(join24(parentRunDirectory, RUN_HISTORY_FILE));
+  const { records, diagnostics } = await readSitianRecords(join25(parentRunDirectory, RUN_HISTORY_FILE));
   if (diagnostics.length > 0) {
     throw new Error(
       `${RUN_HISTORY_FILE} has ${diagnostics.length} malformed row(s); officer pointers unreadable: ${parentRunDirectory}`
@@ -16571,7 +16581,7 @@ var init_analyst_gate_cycles_read = __esm({
 
 // src/analyst-ledger.ts
 import { readdir as readdir3 } from "node:fs/promises";
-import { basename as basename12, join as join25 } from "node:path";
+import { basename as basename12, join as join26 } from "node:path";
 async function readExistingRunLifecycleState(runDirectory) {
   return (await readRoleRunIdentity(runDirectory))?.state;
 }
@@ -16591,7 +16601,7 @@ function ghostLeaseCheckFromAutopsy(autopsy) {
   }
 }
 async function classifyGhostCandidate(input) {
-  const autopsy = await autopsyWriterLock(join25(input.runDirectory, "writer.lock"));
+  const autopsy = await autopsyWriterLock(join26(input.runDirectory, "writer.lock"));
   const leaseCheck = ghostLeaseCheckFromAutopsy(autopsy);
   if (leaseCheck === void 0) return { kind: "live" };
   return {
@@ -16881,7 +16891,7 @@ async function classifyScopedRun(input) {
 async function scanAnalystIssueRuns(input) {
   const ledgerHome = resolveActivationLedgerHome(input.home);
   const scopeTicketNumber = input.ticketNumber;
-  const booksRoot = join25(ledgerHome, "books");
+  const booksRoot = join26(ledgerHome, "books");
   let wholeBook = false;
   let scopeRootIdentity;
   let bookNames;
@@ -16914,7 +16924,7 @@ async function scanAnalystIssueRuns(input) {
   const ghostLegs = [];
   const scopeConflicts = [];
   for (const book of bookNames) {
-    const bookDir = join25(booksRoot, book);
+    const bookDir = join26(booksRoot, book);
     let runDirectories;
     try {
       runDirectories = await listBookRunDirectories(bookDir);
@@ -17660,7 +17670,7 @@ var init_analyst_metric_family = __esm({
 });
 
 // src/analyst-page.ts
-import { dirname as dirname16, join as join26 } from "node:path";
+import { dirname as dirname16, join as join27 } from "node:path";
 function analystIssuePageKey(address) {
   const parts = ["book", address.bookKey];
   if (address.issueNumber !== void 0) {
@@ -17671,7 +17681,7 @@ function analystIssuePageKey(address) {
   return sha256Hex(parts.join("\0")).slice(0, 32);
 }
 function analystIssuePagePath(ledgerHome, address) {
-  return join26(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
+  return join27(ledgerHome, "analyst", "issues", `${analystIssuePageKey(address)}.json`);
 }
 function analystIssuePageAddressFromPage(page) {
   return {
@@ -19235,7 +19245,7 @@ __export(public_role_summons_exports, {
 import { execFile as execFile3 } from "node:child_process";
 import { existsSync as existsSync12 } from "node:fs";
 import { realpath as realpath6 } from "node:fs/promises";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 function createCapturingIo() {
   const chunks = [];
@@ -19259,7 +19269,7 @@ function parentDir(path) {
 function walkPackageRoot(start) {
   let dir = start;
   for (let i = 0; i < 12; i += 1) {
-    if (existsSync12(join27(dir, "package.json")) && existsSync12(join27(dir, "souls"))) {
+    if (existsSync12(join28(dir, "package.json")) && existsSync12(join28(dir, "souls"))) {
       return dir;
     }
     const parent = parentDir(dir);
@@ -19808,7 +19818,7 @@ var init_compliance_transport = __esm({
 });
 
 // src/role-run-relocation.ts
-import { dirname as dirname17, join as join28 } from "node:path";
+import { dirname as dirname17, join as join29 } from "node:path";
 async function retainedRunPathsMatch(recordedPath, currentPath, currentRunDirectory) {
   if (recordedPath === currentPath) return true;
   if (typeof recordedPath !== "string") return false;
@@ -19854,6 +19864,7 @@ var run_lifecycle_exports = {};
 __export(run_lifecycle_exports, {
   AUTO_RESUME_LIMIT: () => AUTO_RESUME_LIMIT,
   RunWriterLeaseHeldError: () => RunWriterLeaseHeldError,
+  WRITER_LOCK_FILE: () => WRITER_LOCK_FILE,
   acquireRunWriterLease: () => acquireRunWriterLease,
   autopsyWriterLock: () => autopsyWriterLock,
   clearCurrentCourt: () => clearCurrentCourt,
@@ -19876,7 +19887,7 @@ __export(run_lifecycle_exports, {
 });
 import { existsSync as existsSync13 } from "node:fs";
 import { chmod, lstat as lstat3, open as open2, readdir as readdir4, readFile as readFile14, unlink as unlink2 } from "node:fs/promises";
-import { basename as basename13, join as join29 } from "node:path";
+import { basename as basename13, join as join30 } from "node:path";
 async function writeRoleRunState(runDirectory, record) {
   const payload = { ...record, runDirectory };
   writeSectionSync(runDirectory, "runState", { ...payload });
@@ -20171,7 +20182,7 @@ async function createWriterLease(lockPath, runDirectory, reportCleanupFailure) {
     },
     relocate(nextRunDirectory) {
       currentRunDirectory = nextRunDirectory;
-      currentLockPath = join29(nextRunDirectory, WRITER_LOCK_FILE);
+      currentLockPath = join30(nextRunDirectory, WRITER_LOCK_FILE);
     },
     async release() {
       if (released) return;
@@ -20210,10 +20221,10 @@ async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
   };
   const reportReadFailure = (error) => {
     reportDiagnostic(
-      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join29(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
+      `writer lease lock read failed (holder liveness unverifiable; lock left in place) at ${join30(runDirectory, WRITER_LOCK_FILE)}: ${describeErrorIdentity(error)}`
     );
   };
-  const lockPath = join29(runDirectory, WRITER_LOCK_FILE);
+  const lockPath = join30(runDirectory, WRITER_LOCK_FILE);
   let lastAutopsy = { verdict: "absent" };
   let lastReclaimFailure;
   for (let reclaimsLeft = WRITER_LEASE_RECLAIM_ROUNDS; ; reclaimsLeft -= 1) {
@@ -20279,7 +20290,7 @@ async function findRunDirectoryById(home, runId, onlyBookKey, onlyRole, knownRun
   }
   if (runId.trim() === "") return void 0;
   const ledgerHome = resolveActivationLedgerHome(home);
-  const booksRoot = join29(ledgerHome, "books");
+  const booksRoot = join30(ledgerHome, "books");
   let bookKeys;
   try {
     bookKeys = await readdir4(booksRoot);
@@ -20329,7 +20340,7 @@ async function findLatestRunForSeatTicket(input) {
   let runDirectories;
   try {
     runDirectories = await listBookRunDirectories(
-      input.ticketNumber === void 0 ? bookDir : join29(bookDir, String(input.ticketNumber))
+      input.ticketNumber === void 0 ? bookDir : join30(bookDir, String(input.ticketNumber))
     );
   } catch (error) {
     if (errorCodeOf(error) === "ENOENT") return void 0;
@@ -21068,7 +21079,7 @@ init_submission_ledger();
 init_filed_submission();
 init_report_ticket_tool();
 import { writeSync as writeSync2 } from "node:fs";
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 import { Value as Value2 } from "typebox/value";
 
 // src/activation-trace.ts
@@ -22865,7 +22876,7 @@ function readRoleRunCoordinates(ctx, label) {
   if (runDirectory === void 0) throw new Error(`${label} requires AK_ROLE_RUN_DIR`);
   const admitted = readPageSync(runDirectory, "admitted");
   if (typeof admitted?.projectRoot !== "string" || admitted.projectRoot.trim() === "") {
-    throw new Error(`${label} state.jsonl admitted-request row missing projectRoot (${join30(runDirectory, RUN_STATE_FILE)})`);
+    throw new Error(`${label} state.jsonl admitted-request row missing projectRoot (${join31(runDirectory, RUN_STATE_FILE)})`);
   }
   return {
     runDirectory,
@@ -24632,12 +24643,12 @@ function createAcpRoleTurnHost(config) {
 // src/acp-host/seat-profile-soul.ts
 import { constants as constants3 } from "node:fs";
 import { access as access3, copyFile, lstat as lstat4, mkdir as mkdir4, readlink, symlink as symlink2, unlink as unlink3 } from "node:fs/promises";
-import { dirname as dirname19, join as join31, relative as relative4, resolve as resolve16 } from "node:path";
+import { dirname as dirname19, join as join32, relative as relative4, resolve as resolve16 } from "node:path";
 function seatProfileName(spec, role) {
   return `${spec.namePrefix}${role}`;
 }
 function packageRoleSoulPath(packageRoot, role) {
-  return join31(packageRoot, "souls", `${role}.md`);
+  return join32(packageRoot, "souls", `${role}.md`);
 }
 async function pathExists2(path) {
   try {
@@ -24654,16 +24665,16 @@ async function ensureSeatProfileSoul(options) {
   if (!await pathExists2(soulTarget)) {
     throw new Error(`packaged role soul missing: ${soulTarget}`);
   }
-  const profilesRoot = join31(operatorHome, ...spec.profilesRootFromHome);
-  const profileDir = join31(profilesRoot, profileName);
+  const profilesRoot = join32(operatorHome, ...spec.profilesRootFromHome);
+  const profileDir = join32(profilesRoot, profileName);
   const hostRoot = dirname19(profilesRoot);
-  const soulPath = join31(profileDir, spec.soulFileName);
+  const soulPath = join32(profileDir, spec.soulFileName);
   if (!await pathExists2(profileDir)) {
     await mkdir4(profileDir, { recursive: true });
     for (const name of ["auth.json", ".env", "config.yaml"]) {
-      const source = join31(hostRoot, name);
+      const source = join32(hostRoot, name);
       if (!await pathExists2(source)) continue;
-      await copyFile(source, join31(profileDir, name));
+      await copyFile(source, join32(profileDir, name));
     }
   } else {
     await mkdir4(profileDir, { recursive: true });

package/dist/collector-tool-schemas.js

@@ -11,7 +11,7 @@ export const collectorOutputBaseSchema = openToolObject(Type.Object({
         description: "按机器身份归组的出席、材料与逐条 findings（LLM 自行从宿主 CLI 取证整理；代码不代收不归并）。",
     }),
     unfinishedReasons: Type.Unknown({
-        description: "未完成原因；取证受限时如实报告。",
+        description: "仅取证受限时填未完成原因；没有就填 null",
     }),
 }));
 /** Runtime does not enrich findings; the model submits the receipt and signals sole-final. */

package/dist/diarist-contracts.js

@@ -31,11 +31,11 @@ export function validateRecordedDiaristOutput(value) {
 }
 /**
  * Project sessions from a completed diarist payload.
- * Absent key → empty (lawful). Present but unusable → undefined (caller reasks).
+ * Null / absent key → empty (lawful). Non-null but unusable → undefined (caller reasks).
  */
 export function projectDiaristSessions(value) {
     const raw = value?.sessions;
-    if (raw === undefined)
+    if (raw == null)
         return [];
     return projectTicketProvenanceSessions(raw);
 }
@@ -72,13 +72,15 @@ export const diaristOutputSchema = withTerminatingOutputDeclarations(openToolObj
         description: "completed | escalate",
     }),
     ticketNumber: Type.Optional(Type.Unknown({
-        description: "本庭对象票号（正整数）或 null/省略＝真无票；下游走 typed 键；认不出用 status=escalate，不洗成无录。机械层不重判。",
+        description: "仅有本庭对象时填票号（正整数）；没有就填 null＝真无票；下游走 typed 键；认不出用 status=escalate，不洗成无录。机械层不重判。",
     })),
     reason: Type.Unknown({
-        description: "status 为 escalate 时：上呈的原因",
+        description: "仅 status 为 escalate 时填上呈的原因；没有就填 null",
     }),
-    sessions: Type.Optional(Type.Unknown({ description: DIARIST_SESSIONS_DESCRIPTION })),
+    sessions: Type.Optional(Type.Unknown({
+        description: `仅单票庭时填对话边界；没有就填 null。${DIARIST_SESSIONS_DESCRIPTION}`,
+    })),
     ticketSessions: Type.Unknown({
-        description: `多票庭逐票对话边界；每票含 ticketNumber（本条边界所归票号，正整数）与 sessions（${DIARIST_SESSIONS_DESCRIPTION}）。一次交卷各票各自分录。与单票 sessions 二选一。`,
+        description: `仅多票庭时填逐票对话边界；没有就填 null。每票含 ticketNumber（本条边界所归票号，正整数）与 sessions（${DIARIST_SESSIONS_DESCRIPTION}）。一次交卷各票各自分录。`,
     }),
 })));

package/dist/doctor-contracts.js

@@ -23,7 +23,7 @@ const doctorSubmissionObject = Type.Object({
     description: `\u9010\u6761\u8D44\u4EA7\u89C2\u5BDF\u4E0E\u5904\u65B9\uFF0C\u539F\u6837\u7559\u5B58\u3002\u4E00\u6761\u53EF\u542B targetKey\u3001targetKind\uFF08${DOCTOR_TARGET_KINDS.join(" | ")}\uFF09\u3001observation\u3001evidenceIds\u3001disposition\uFF08${DOCTOR_DISPOSITIONS.join(" | ")}\uFF09\u3001assetEvidence\uFF08targetKey\u3001targetKind\u3001evidenceId\uFF09\u3001guardrails\uFF08reproducibleFailure\u3001owningSeamOrInvariant\u3001deletionOrSimplificationSuffices\uFF0C\u5404\u9879\u53EF\u542B answer\u3001evidenceIds\u3001explanation\uFF09\u3001prescription\uFF08kind \u4E3A ${DOCTOR_PRESCRIPTION_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 recommendation\u3001necessityExplanation\uFF09\u3001lastRealBite\uFF08kind \u4E3A ${DOCTOR_BITE_KINDS.join(" | ")}\uFF0C\u53E6\u53EF\u5199 targetKey\u3001evidenceId\u3001eligibleEvidenceIds\uFF09\u3002\u4E0D\u8981\u6C42\u4EFB\u4F55\u5904\u65B9\u6216\u53EF\u590D\u7528 finding\uFF1B\u7F3A\u53EF\u590D\u7528\u8D44\u4EA7\u6216 bounded-bite \u8BC1\u636E\u53EA\u6392\u9664\u5BF9\u5E94\u8D44\u4EA7\u5904\u65B9\u3002\u673A\u5668\u4E0D\u6838\u9A8C\u3002`
   }),
   reason: Type.Unknown({
-    description: "\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0\uFF1B\u4EC5 refused \u65F6\u7528\u3002"
+    description: "\u4EC5 refused \u65F6\u586B\u8BC1\u636E\u4E0D\u8DB3\u4EE5\u652F\u6491\u5982\u5B9E\u8BC1\u8BCD\u7684\u539F\u56E0\uFF1B\u6CA1\u6709\u5C31\u586B null"
   }),
   missingEvidence: Type.Unknown({
     description: "\u5982\u5B9E\u8BC1\u8BCD\u6240\u9700\u800C\u5C1A\u7F3A\u7684\u8BC1\u636E\uFF0C\u539F\u6837\u7559\u5B58\uFF08\u5982\u6BCF\u9879 need\u3001targetKeys\uFF09\u3002"