@principles/core 1.259.0 → 1.260.0

package/dist/runtime-v2/internalization/internalization-transition-decision.js

@@ -0,0 +1,84 @@
+/**
+ * InternalizationTransitionDecision — 单一迁移决策 (P0-D, MVP_CORE_LOOP_CONTRACT INV-02/INV-07)。
+ *
+ * 审计背景 (ISSUE-005): 修复前 auto-consumer 对 runResult.status === 'succeeded'
+ * 一律 commitNextTaskProposal → evaluator needs_revision 也会 seed rollout_reviewer
+ * (错误并行分支); 即使打开 PRI-509 repair flag, repair_seeded 仍 fall through 到
+ * succeeded → 双播种。
+ *
+ * 语义: runner 输出内容(evaluation/review 的 verdict)与状态迁移必须经同一个
+ * 纯决策函数仲裁。非终态必须满足 INV-07: 有自动 successor 或有 Owner action。
+ *
+ * P0-3 (外部复核): 决策型 runner 的 verdict **fail-closed** —
+ *   - durable runnerDecision (任务元数据) 是第一判据;
+ *   - 缺失时,只有 runs.output_payload 里**显式可解析**的历史 verdict 才可作为
+ *     legacy 判据 (评估器/评审器的真实产物,不是猜测);
+ *   - 两者皆无 → NOT_ADVANCEABLE (blocked, 需人工/reconciliation),
+ *     禁止 "missing decision = legacy ADVANCE" —— 那会复活审计要消灭的
+ *     needs_revision 错误旁路。
+ */
+const EVALUATOR_VERDICTS = new Set(['approved', 'needs_revision', 'rejected']);
+const ROLLOUT_VERDICTS = new Set(['approve_rollout', 'needs_revision', 'reject']);
+/**
+ * 纯决策: 依据任务状态 + runner 判定,决定该任务完成后链上应发生什么。
+ * 调用方 (orchestrator.commitNextTaskProposal) 是唯一后继播种漏斗。
+ */
+export function decideInternalizationTransition(input) {
+    const { taskKind, taskStatus, runnerDecision, legacyRunnerDecision, isRepairTask, revisionCount } = input;
+    // 1. 状态门: 只有 succeeded 的任务参与推进仲裁
+    if (taskStatus === 'needs_human_review') {
+        return { kind: 'HUMAN_REVIEW_REQUIRED', reason: 'task_awaiting_owner_attention' };
+    }
+    if (taskStatus !== 'succeeded') {
+        return { kind: 'NOT_ADVANCEABLE', reason: `task_status_${taskStatus}` };
+    }
+    // 2. Repair 任务 (artificer + repairPayload) 完成 → reopen 来源 evaluator,
+    //    不走正常后继 seeding (evaluator 任务已存在于同 lineage, 稳定 id 会冲突)。
+    if (isRepairTask && taskKind === 'artificer') {
+        return { kind: 'REOPEN_SOURCE_EVALUATOR', reason: `repair_round_complete_revision_${revisionCount}` };
+    }
+    // 3. 决策型 runner: durable verdict 第一,显式 legacy verdict 第二,皆无 → 阻断 (P0-3)
+    if (taskKind === 'evaluator') {
+        const verdict = runnerDecision
+            ?? (legacyRunnerDecision !== undefined && EVALUATOR_VERDICTS.has(legacyRunnerDecision) ? legacyRunnerDecision : undefined);
+        if (verdict === undefined) {
+            return { kind: 'BLOCKED_MISSING_VERDICT', reason: 'evaluator_verdict_missing_durable_and_legacy' };
+        }
+        if (verdict === 'approved') {
+            return { kind: 'ADVANCE', reason: 'evaluator_approved' };
+        }
+        if (verdict === 'needs_revision') {
+            return { kind: 'REVISION_REQUIRED', reason: 'evaluator_needs_revision_repair_loop' };
+        }
+        return { kind: 'TERMINAL_REJECT', reason: 'evaluator_rejected' };
+    }
+    if (taskKind === 'rollout_reviewer') {
+        const verdict = runnerDecision
+            ?? (legacyRunnerDecision !== undefined && ROLLOUT_VERDICTS.has(legacyRunnerDecision) ? legacyRunnerDecision : undefined);
+        if (verdict === undefined) {
+            return { kind: 'BLOCKED_MISSING_VERDICT', reason: 'rollout_verdict_missing_durable_and_legacy' };
+        }
+        if (verdict === 'approve_rollout') {
+            // job-graph 终节点: ADVANCE 语义 = activation dispatch (runner 侧已内联执行)
+            return { kind: 'ADVANCE', reason: 'rollout_approved_dispatch_activation' };
+        }
+        if (verdict === 'needs_revision') {
+            return { kind: 'REVISION_REQUIRED', reason: 'rollout_needs_revision_routed_upstream' };
+        }
+        return { kind: 'TERMINAL_REJECT', reason: 'rollout_rejected_no_activation' };
+    }
+    // 4. 非决策型 runner (dreamer/philosopher/scribe/artificer 常规): 正常推进
+    return { kind: 'ADVANCE', reason: `task_succeeded_${taskKind}` };
+}
+/** 从 PITaskRecord 提取决策输入的便利投影 (legacy 判据由调用方解析后传入) */
+export function transitionInputFromTask(piTask, legacyRunnerDecision) {
+    return {
+        taskKind: piTask.taskKind,
+        taskStatus: piTask.status,
+        runnerDecision: piTask.runnerDecision,
+        legacyRunnerDecision,
+        isRepairTask: piTask.repairPayload !== undefined,
+        revisionCount: piTask.revisionCount ?? 0,
+    };
+}
+//# sourceMappingURL=internalization-transition-decision.js.map

package/dist/runtime-v2/internalization/internalization-transition-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalization-transition-decision.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/internalization-transition-decision.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/internalization/legacy-rule-contract-scanner.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Legacy RuleHost contract dependency scanner (2026-08-19).
+ *
+ * When a public RuleHost contract symbol is retired (e.g.
+ * `RuleHostInput.session.recentThinking`, `workspace.planStatus`,
+ * `workspace.hasPlanFile`, the `getPlanStatus()`/`hasPlanFile()` helpers),
+ * source-level deletion is not enough: persisted, owner-approved RuleCode in
+ * existing workspaces may still reference the symbol. Executing such a rule
+ * against the new contract silently changes its semantics (`undefined`
+ * instead of a value) — the most dangerous failure mode because nothing
+ * throws and the owner-approved behavior drifts quietly.
+ *
+ * This scanner is the shared detection point for:
+ *   - runtime load backstops (plugin RuleHost + host-runtime gate) — a rule
+ *     with a retired-contract dependency is NOT executed;
+ *   - upgrade preflights (installer, console update) — refuse to replace the
+ *     runtime while an active rule depends on a removed contract.
+ *
+ * Matching is deliberately conservative: a symbol mentioned anywhere in the
+ * implementation source (including comments) is reported. A false positive
+ * costs one migration/deactivation; a false negative silently changes the
+ * behavior of an owner-approved rule.
+ */
+/** Retired public RuleHost contract symbols and how they appear in RuleCode. */
+export type LegacyRuleContractSymbol = 'recentThinking' | 'planStatus' | 'hasPlanFile' | 'getPlanStatus' | 'hasPlanFileHelper';
+/** A rule implementation to scan, with its lineage for owner-facing output. */
+export interface LegacyRuleContractRuleSource {
+    activationId?: string;
+    artifactId: string;
+    ruleId?: string;
+    principleId?: string;
+    /** Raw RuleCode source as persisted in the artifact. */
+    implementationCode: string;
+}
+/** One retired-symbol usage found in one active rule. */
+export interface LegacyRuleContractFinding {
+    activationId?: string;
+    artifactId: string;
+    ruleId?: string;
+    principleId?: string;
+    symbol: LegacyRuleContractSymbol;
+    channel: 'code_tool_hook';
+}
+/**
+ * Scan persisted RuleCode sources for retired RuleHost contract symbols.
+ * Pure function — no I/O; callers own loading the code from persistence.
+ */
+export declare function scanLegacyRuleContractDependencies(rules: readonly LegacyRuleContractRuleSource[]): LegacyRuleContractFinding[];
+/** Human-readable remediation text shared by all consumers of the scanner. */
+export declare function formatLegacyRuleContractRemediation(findings: readonly LegacyRuleContractFinding[]): string;
+//# sourceMappingURL=legacy-rule-contract-scanner.d.ts.map

package/dist/runtime-v2/internalization/legacy-rule-contract-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-rule-contract-scanner.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/legacy-rule-contract-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gFAAgF;AAChF,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,YAAY,GACZ,aAAa,GACb,eAAe,GACf,mBAAmB,CAAC;AAExB,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAmBD;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,4BAA4B,EAAE,GAC7C,yBAAyB,EAAE,CAuB7B;AAED,8EAA8E;AAC9E,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,GAAG,MAAM,CAgB1G"}

package/dist/runtime-v2/internalization/legacy-rule-contract-scanner.js

@@ -0,0 +1,81 @@
+/**
+ * Legacy RuleHost contract dependency scanner (2026-08-19).
+ *
+ * When a public RuleHost contract symbol is retired (e.g.
+ * `RuleHostInput.session.recentThinking`, `workspace.planStatus`,
+ * `workspace.hasPlanFile`, the `getPlanStatus()`/`hasPlanFile()` helpers),
+ * source-level deletion is not enough: persisted, owner-approved RuleCode in
+ * existing workspaces may still reference the symbol. Executing such a rule
+ * against the new contract silently changes its semantics (`undefined`
+ * instead of a value) — the most dangerous failure mode because nothing
+ * throws and the owner-approved behavior drifts quietly.
+ *
+ * This scanner is the shared detection point for:
+ *   - runtime load backstops (plugin RuleHost + host-runtime gate) — a rule
+ *     with a retired-contract dependency is NOT executed;
+ *   - upgrade preflights (installer, console update) — refuse to replace the
+ *     runtime while an active rule depends on a removed contract.
+ *
+ * Matching is deliberately conservative: a symbol mentioned anywhere in the
+ * implementation source (including comments) is reported. A false positive
+ * costs one migration/deactivation; a false negative silently changes the
+ * behavior of an owner-approved rule.
+ */
+// Field-form vs helper-form are distinguished so remediation guidance can
+// name the exact contract element. A call site (`hasPlanFile(`) is reported
+// once as the helper form — the field pattern excludes call sites with a
+// negative lookahead so one occurrence never yields two findings.
+const SYMBOL_PATTERNS = [
+    { symbol: 'recentThinking', pattern: /\brecentThinking\b/ },
+    { symbol: 'planStatus', pattern: /\bplanStatus\b/ },
+    { symbol: 'getPlanStatus', pattern: /\bgetPlanStatus\s*\(/ },
+    { symbol: 'hasPlanFileHelper', pattern: /\bhasPlanFile\s*\(/ },
+    { symbol: 'hasPlanFile', pattern: /\bhasPlanFile\b(?!\s*\()/ },
+];
+/**
+ * Scan persisted RuleCode sources for retired RuleHost contract symbols.
+ * Pure function — no I/O; callers own loading the code from persistence.
+ */
+export function scanLegacyRuleContractDependencies(rules) {
+    const findings = [];
+    for (const rule of rules) {
+        if (typeof rule.implementationCode !== 'string' || rule.implementationCode.length === 0) {
+            continue;
+        }
+        const seen = new Set();
+        for (const { symbol, pattern } of SYMBOL_PATTERNS) {
+            if (seen.has(symbol))
+                continue;
+            if (pattern.test(rule.implementationCode)) {
+                seen.add(symbol);
+                findings.push({
+                    ...(rule.activationId !== undefined ? { activationId: rule.activationId } : {}),
+                    artifactId: rule.artifactId,
+                    ...(rule.ruleId !== undefined ? { ruleId: rule.ruleId } : {}),
+                    ...(rule.principleId !== undefined ? { principleId: rule.principleId } : {}),
+                    symbol,
+                    channel: 'code_tool_hook',
+                });
+            }
+        }
+    }
+    return findings;
+}
+/** Human-readable remediation text shared by all consumers of the scanner. */
+export function formatLegacyRuleContractRemediation(findings) {
+    const byRule = new Map();
+    for (const f of findings) {
+        const key = f.ruleId ?? f.artifactId;
+        const list = byRule.get(key) ?? [];
+        list.push(f);
+        byRule.set(key, list);
+    }
+    const lines = [...byRule.entries()].map(([rule, fs]) => `  - ${rule}${fs[0]?.activationId ? ` (activation ${fs[0].activationId})` : ''}: ${fs.map(f => f.symbol).join(', ')}`);
+    return [
+        'One or more active owner-approved rules depend on a RuleHost contract symbol removed by this version.',
+        'Affected rules:',
+        ...lines,
+        'Next: migrate or deactivate the listed rules before upgrading. The old installation is untouched.',
+    ].join('\n');
+}
+//# sourceMappingURL=legacy-rule-contract-scanner.js.map

package/dist/runtime-v2/internalization/legacy-rule-contract-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-rule-contract-scanner.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/legacy-rule-contract-scanner.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/internalization/peer-runner-contracts.d.ts

@@ -14,7 +14,7 @@
  * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
  */
 import type { TaskRecord } from '../task-status.js';
-import type { RepairPayload } from './pitask-metadata.js';
+import type { RepairPayload, RunnerDecision, RolloutRevisionPayload, RunnerCompletionIntent } from './pitask-metadata.js';
 /**
  * The 4 channels through which principle internalization can occur.
  *
@@ -105,6 +105,22 @@ export interface PITaskRecord extends TaskRecord {
     adversarialFeedback?: string;
     /** Evaluator repair payload (PRI-509); present only on artificer repair tasks. */
     repairPayload?: RepairPayload;
+    /** Runner decision (evaluator/rollout_reviewer LLM verdict) — transition control (INV-02). */
+    runnerDecision?: RunnerDecision;
+    /** Times this task has been reopened for revision (bounded revision budget). */
+    revisionCount?: number;
+    /** Feedback injected when this task is reopened by rollout needs_revision routing. */
+    revisionFeedback?: string;
+    /** P0-4 stable revision identity — same-cause reopen replays are no-ops. */
+    revisionCauseId?: string;
+    /** Rollout needs_revision routing payload; present on rollout_reviewer tasks that routed a revision. */
+    rolloutRevisionPayload?: RolloutRevisionPayload;
+    /**
+     * P0 (verdict drift): durable completion intent of one LLM verdict. Pending
+     * intent in the same revision epoch is the recovery authority — re-runs
+     * resume it instead of re-invoking the LLM. See pitask-metadata.ts.
+     */
+    completionIntent?: RunnerCompletionIntent;
 }
 /**
  * All valid peer runner kinds. Useful for validation and iteration.

package/dist/runtime-v2/internalization/peer-runner-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peer-runner-contracts.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/peer-runner-contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"peer-runner-contracts.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/peer-runner-contracts.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/internalization/peer-runner-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"peer-runner-contracts.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/peer-runner-contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"peer-runner-contracts.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/peer-runner-contracts.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/internalization/pitask-metadata.d.ts

@@ -71,8 +71,8 @@ export interface PITaskMetadata {
     /**
      * Prior adversarial replay failures to inject into a Round-2+ Artificer
      * prompt (RuleHost MVP, PRI-428). Set by runAdversarialLoop when a prior
-     * Evaluator round returned needs_revision. Treated as opaque text by the
-     * metadata layer; the ArtificerRunner forwards it to the prompt builder.
+     * Evaluator round returned needs_revision. Treated as opaque text by
+     * the metadata layer; the ArtificerRunner forwards it to the prompt builder.
      */
     adversarialFeedback?: string;
     /**
@@ -82,6 +82,93 @@ export interface PITaskMetadata {
      * can address each required change. Undefined on Round-1 artificer tasks.
      */
     repairPayload?: RepairPayload;
+    /**
+     * Runner 判定(evaluator / rollout_reviewer 的 LLM 决策),由 runner 在
+     * succeedTask 收尾时写入。commitNextTaskProposal 依据它做单一迁移决策
+     * (MVP_CORE_LOOP_CONTRACT INV-02: needs_revision 不得同时 seed 正常后继)。
+     */
+    runnerDecision?: RunnerDecision;
+    /**
+     * 该任务被 revision reopen 的次数(每次 reopen +1)。revision 有界性的
+     * 一部分: 配合 rolloutRevisionPayload.revisionIteration / repairIteration
+     * 构成 lineage 级 revision budget。
+     */
+    revisionCount?: number;
+    /**
+     * Rollout reviewer needs_revision 时注入到被 reopen 修订目标的反馈
+     * (scribe / artificer 的 prompt 侧注入,由各 runner buildContext 消费)。
+     */
+    revisionFeedback?: string;
+    /**
+     * P0-4 revision identity: 触发本次 reopen 的稳定 cause 标识
+     * (如 `repair-<repairTaskId>` / `rollout-<rolloutTaskId>-r<iteration>`)。
+     * reopenTaskForRevision 对相同 causeId 的重放是真正 no-op。
+     */
+    revisionCauseId?: string;
+    /**
+     * Rollout reviewer needs_revision 的修订路由载荷: 记录修订目标 stage、
+     * 迭代号与来源,保证 revision budget 可判定 (MVP_CORE_LOOP_CONTRACT INV-07)。
+     */
+    rolloutRevisionPayload?: RolloutRevisionPayload;
+    /**
+     * P0 (verdict drift): 一次 LLM verdict 的 durable completion intent。
+     *
+     * 与 runnerDecision 在同一次 metadata 写入中落库 (原子): intent 存在且
+     * status='pending' ⇒ 该 verdict 的治理 transition 尚未完成。同一
+     * execution epoch 内 crash/retry/restart 重跑时,run() 入口必须 RESUME
+     * 该 intent (跳过 LLM,幂等重放 effects),禁止让新的 LLM 输出覆盖它
+     * —— LLM 非确定性下,重问可能产生 approve/reject 漂移,与已发生的
+     * side effect (activation / repair seed / validation) 形成治理矛盾。
+     *
+     * epoch 语义: revisionEpoch = 落库时的 revisionCount。真正的 revision
+     * reopen 会递增 revisionCount 并清空本字段 (新 epoch 允许新 verdict);
+     * epoch 不匹配的残留 intent 视为 stale,不得 resume。
+     */
+    completionIntent?: RunnerCompletionIntent;
+}
+/** evaluator / rollout_reviewer 的合法 runner 决策值 */
+export type RunnerDecision = 'approved' | 'needs_revision' | 'rejected' | 'approve_rollout' | 'reject';
+/**
+ * 一次 verdict completion 的 durable intent (P0 verdict drift 修复)。
+ * effectPayload 语义按 decision 分派:
+ *   - needs_revision (rollout): revisionIteration = 本次 completion 的修订轮号
+ *     (record 时由已 APPLIED 的 rolloutRevisionPayload 计出并锁定,resume
+ *     据此继续同一轮,消除"applied 载荷属于上一轮还是本轮"的歧义);
+ *   - 其余 decision: 无 effect 载荷。
+ */
+export interface RunnerCompletionIntent {
+    readonly decision: RunnerDecision;
+    /** 产出该 verdict 的 run — resume 时从其 outputPayload 恢复已验证输出 */
+    readonly sourceRunId: string;
+    /** 落库时任务的 revisionCount — 同 epoch 才允许 resume */
+    readonly revisionEpoch: number;
+    readonly status: 'pending' | 'applied';
+    readonly revisionIteration?: number;
+    /**
+     * P0-A (completion-intent 完整性): 该 completion 的效果类型。
+     * - 'governance_transition' (缺省): 正常治理 transition (dispatch /
+     *   revision routing / repair seed / validation),由 runner 的 effects 执行;
+     * - 'needs_human_review': 终态人工裁决效果 (rollout budget exhausted 等)
+     *   — crash resume 必须继续该效果 (重写 needs_human_review),禁止重问 LLM。
+     */
+    readonly effect?: 'governance_transition' | 'needs_human_review';
+}
+/** rollout needs_revision 的修订路由载荷 */
+export interface RolloutRevisionPayload {
+    readonly requiredChanges: readonly string[];
+    readonly revisionIteration: number;
+    readonly sourceRolloutTaskId: string;
+    readonly sourceArtifactId: string;
+    readonly targetTaskKind: 'scribe' | 'artificer';
+    /**
+     * B (最终复核) intent 状态机:
+     * - 'pending': intent 已持久化,transition 尚未 materialize — crash/retry/
+     *   restart 必须继续执行同一 iteration N,禁止自动 N+1;
+     * - 'applied': reopen 已 materialize — 只有新的 needs_revision verdict 才
+     *   能 N→N+1;budget 按 APPLIED 计数,不按 intent 写入次数计。
+     * - undefined: 旧形状 (本状态机引入前) — 兼容视为 'applied'。
+     */
+    readonly status?: 'pending' | 'applied';
 }
 /**
  * Serialize PITaskMetadata into a JSON string suitable for TaskRecord.diagnosticJson.
@@ -90,6 +177,16 @@ export interface PITaskMetadata {
 export declare function serializePITaskMetadata(metadata: PITaskMetadata): string;
 /** Alias for serializePITaskMetadata — explicit name for adapter/consumer use. */
 export declare const createPITaskDiagnosticJson: typeof serializePITaskMetadata;
+/**
+ * 从已 hydrate 的 PITaskRecord 重建可写 PITaskMetadata,浅覆盖指定字段。
+ *
+ * 单一重建点 (DRY): evaluator/rollout 的 verdict 记录、修订路由记录、
+ * orchestrator 的 revision reopen 共用同一字段搬运逻辑——此前 4 处手写
+ * 逐字段 spread,新增字段时容易漏抄 (Phase 3.5 consolidation)。
+ * 注意: overrides 中显式 undefined 会覆盖为 undefined (serialize 时省略键),
+ * 用于"清除旧 verdict"语义。
+ */
+export declare function mergePITaskMetadata(base: PITaskRecord, overrides: Partial<PITaskMetadata>): PITaskMetadata;
 /**
  * Parse a diagnosticJson string into PITaskMetadata.
  * Returns null on any parse/validation failure (fail closed).

package/dist/runtime-v2/internalization/pitask-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pitask-metadata.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/pitask-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACZ,MAAM,4BAA4B,CAAC;AAGpC,uEAAuE;AACvE,eAAO,MAAM,eAAe,EAAG,aAAsB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,kBAAkB,EAAE,WAAW,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAexE;AAED,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,gCAA0B,CAAC;AA6DlE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAkFjF;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CA4BzE"}
+{"version":3,"file":"pitask-metadata.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/pitask-metadata.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/internalization/pitask-metadata.js

@@ -27,6 +27,9 @@
 import { isInternalizationChannel, isRunnerKind } from './peer-runner-contracts.js';
 /** Namespace key used inside diagnosticJson to isolate PI metadata. */
 export const PI_METADATA_KEY = 'pi_metadata';
+const RUNNER_DECISIONS = new Set([
+    'approved', 'needs_revision', 'rejected', 'approve_rollout', 'reject',
+]);
 // ── Serialization ──────────────────────────────────────────────────────────────
 /**
  * Serialize PITaskMetadata into a JSON string suitable for TaskRecord.diagnosticJson.
@@ -45,11 +48,47 @@ export function serializePITaskMetadata(metadata) {
             rejectionCount: metadata.rejectionCount,
             adversarialFeedback: metadata.adversarialFeedback,
             repairPayload: metadata.repairPayload,
+            runnerDecision: metadata.runnerDecision,
+            revisionCount: metadata.revisionCount,
+            revisionFeedback: metadata.revisionFeedback,
+            revisionCauseId: metadata.revisionCauseId,
+            rolloutRevisionPayload: metadata.rolloutRevisionPayload,
+            completionIntent: metadata.completionIntent,
         },
     });
 }
 /** Alias for serializePITaskMetadata — explicit name for adapter/consumer use. */
 export const createPITaskDiagnosticJson = serializePITaskMetadata;
+/**
+ * 从已 hydrate 的 PITaskRecord 重建可写 PITaskMetadata,浅覆盖指定字段。
+ *
+ * 单一重建点 (DRY): evaluator/rollout 的 verdict 记录、修订路由记录、
+ * orchestrator 的 revision reopen 共用同一字段搬运逻辑——此前 4 处手写
+ * 逐字段 spread,新增字段时容易漏抄 (Phase 3.5 consolidation)。
+ * 注意: overrides 中显式 undefined 会覆盖为 undefined (serialize 时省略键),
+ * 用于"清除旧 verdict"语义。
+ */
+export function mergePITaskMetadata(base, overrides) {
+    return {
+        dependencyTaskIds: base.dependencyTaskIds,
+        channel: base.channel,
+        timeoutMs: base.timeoutMs,
+        inputArtifactRefs: base.inputArtifactRefs,
+        outputArtifactRefs: base.outputArtifactRefs,
+        parentTaskId: base.parentTaskId,
+        correlationId: base.correlationId,
+        rejectionCount: base.rejectionCount,
+        adversarialFeedback: base.adversarialFeedback,
+        repairPayload: base.repairPayload,
+        runnerDecision: base.runnerDecision,
+        revisionCount: base.revisionCount,
+        revisionFeedback: base.revisionFeedback,
+        revisionCauseId: base.revisionCauseId,
+        rolloutRevisionPayload: base.rolloutRevisionPayload,
+        completionIntent: base.completionIntent,
+        ...overrides,
+    };
+}
 // ── ArtifactRef validation ─────────────────────────────────────────────────────
 /**
  * Validates a value is a valid ArtifactRef { artifactType: string, ref: string }.
@@ -207,6 +246,101 @@ export function parsePITaskMetadata(diagnosticJson) {
             return null;
         ({ repairPayload } = m);
     }
+    // runnerDecision (transition control, INV-02): optional literal union.
+    if (Object.hasOwn(m, 'runnerDecision') && m.runnerDecision !== undefined) {
+        if (typeof m.runnerDecision !== 'string' || !RUNNER_DECISIONS.has(m.runnerDecision))
+            return null;
+    }
+    // revisionCount: optional non-negative integer.
+    if (Object.hasOwn(m, 'revisionCount') && m.revisionCount !== undefined) {
+        if (typeof m.revisionCount !== 'number' || !Number.isInteger(m.revisionCount) || m.revisionCount < 0)
+            return null;
+    }
+    // revisionFeedback / revisionCauseId: optional non-empty strings.
+    if (Object.hasOwn(m, 'revisionFeedback') && m.revisionFeedback !== undefined) {
+        if (typeof m.revisionFeedback !== 'string' || m.revisionFeedback.trim() === '')
+            return null;
+    }
+    if (Object.hasOwn(m, 'revisionCauseId') && m.revisionCauseId !== undefined) {
+        if (typeof m.revisionCauseId !== 'string' || m.revisionCauseId.trim() === '')
+            return null;
+    }
+    // rolloutRevisionPayload: optional, full validation (rc-1/rc-4).
+    let rolloutRevisionPayload;
+    if (Object.hasOwn(m, 'rolloutRevisionPayload') && m.rolloutRevisionPayload !== undefined) {
+        const p = m.rolloutRevisionPayload;
+        if (typeof p !== 'object' || p === null || Array.isArray(p))
+            return null;
+        const r = p;
+        if (!Array.isArray(r.requiredChanges) || r.requiredChanges.length === 0)
+            return null;
+        for (const c of r.requiredChanges) {
+            if (typeof c !== 'string' || c.trim() === '')
+                return null;
+        }
+        if (typeof r.revisionIteration !== 'number' || !Number.isInteger(r.revisionIteration)
+            || r.revisionIteration < 1 || r.revisionIteration > 2)
+            return null;
+        if (typeof r.sourceRolloutTaskId !== 'string' || r.sourceRolloutTaskId.trim() === '')
+            return null;
+        if (typeof r.sourceArtifactId !== 'string' || r.sourceArtifactId.trim() === '')
+            return null;
+        if (r.targetTaskKind !== 'scribe' && r.targetTaskKind !== 'artificer')
+            return null;
+        // B: 可选 intent 状态,缺失视为旧形状 (=applied)
+        let intentStatus;
+        if (r.status !== undefined && r.status !== 'pending' && r.status !== 'applied')
+            return null;
+        if (r.status === 'pending' || r.status === 'applied')
+            intentStatus = r.status;
+        rolloutRevisionPayload = {
+            requiredChanges: r.requiredChanges,
+            revisionIteration: r.revisionIteration,
+            sourceRolloutTaskId: r.sourceRolloutTaskId,
+            sourceArtifactId: r.sourceArtifactId,
+            targetTaskKind: r.targetTaskKind,
+            status: intentStatus,
+        };
+    }
+    // completionIntent: optional, full validation (rc-1/rc-4). Malformed intent
+    // invalidates the whole metadata (fail-closed) — a corrupted authority
+    // record must never silently degrade into "no intent, re-ask the LLM".
+    let completionIntent;
+    if (Object.hasOwn(m, 'completionIntent') && m.completionIntent !== undefined) {
+        const p = m.completionIntent;
+        if (typeof p !== 'object' || p === null || Array.isArray(p))
+            return null;
+        const r = p;
+        if (typeof r.decision !== 'string' || !RUNNER_DECISIONS.has(r.decision))
+            return null;
+        if (typeof r.sourceRunId !== 'string' || r.sourceRunId.trim() === '')
+            return null;
+        if (typeof r.revisionEpoch !== 'number' || !Number.isInteger(r.revisionEpoch) || r.revisionEpoch < 0)
+            return null;
+        if (r.status !== 'pending' && r.status !== 'applied')
+            return null;
+        let revisionIteration;
+        if (r.revisionIteration !== undefined) {
+            if (typeof r.revisionIteration !== 'number' || !Number.isInteger(r.revisionIteration)
+                || r.revisionIteration < 1 || r.revisionIteration > 2)
+                return null;
+            ({ revisionIteration } = r);
+        }
+        // P0-A: 可选效果类型,缺失 = governance_transition
+        let effect;
+        if (r.effect !== undefined && r.effect !== 'governance_transition' && r.effect !== 'needs_human_review')
+            return null;
+        if (r.effect === 'needs_human_review')
+            ({ effect } = r);
+        completionIntent = {
+            decision: r.decision,
+            sourceRunId: r.sourceRunId,
+            revisionEpoch: r.revisionEpoch,
+            status: r.status,
+            revisionIteration,
+            ...(effect !== undefined ? { effect } : {}),
+        };
+    }
     return {
         dependencyTaskIds: m.dependencyTaskIds,
         channel: m.channel,
@@ -218,6 +352,14 @@ export function parsePITaskMetadata(diagnosticJson) {
         rejectionCount,
         adversarialFeedback: typeof m.adversarialFeedback === 'string' ? m.adversarialFeedback : undefined,
         repairPayload,
+        runnerDecision: typeof m.runnerDecision === 'string' && RUNNER_DECISIONS.has(m.runnerDecision)
+            ? m.runnerDecision
+            : undefined,
+        revisionCount: typeof m.revisionCount === 'number' ? m.revisionCount : undefined,
+        revisionFeedback: typeof m.revisionFeedback === 'string' ? m.revisionFeedback : undefined,
+        revisionCauseId: typeof m.revisionCauseId === 'string' ? m.revisionCauseId : undefined,
+        rolloutRevisionPayload,
+        completionIntent,
     };
 }
 // ── Hydration ───────────────────────────────────────────────────────────────────
@@ -264,6 +406,12 @@ export function hydratePITaskRecord(task) {
         rejectionCount: meta.rejectionCount ?? 0,
         adversarialFeedback: meta.adversarialFeedback,
         repairPayload: meta.repairPayload,
+        runnerDecision: meta.runnerDecision,
+        revisionCount: meta.revisionCount,
+        revisionFeedback: meta.revisionFeedback,
+        revisionCauseId: meta.revisionCauseId,
+        rolloutRevisionPayload: meta.rolloutRevisionPayload,
+        completionIntent: meta.completionIntent,
     };
 }
 //# sourceMappingURL=pitask-metadata.js.map