create-principles-disciple 1.85.0 → 1.87.0

package/core/dist/runtime-v2/diagnostician/router-prompt-builder.js

@@ -0,0 +1,131 @@
+/**
+ * RouterPromptBuilder — Stage C prompt builder for the split diagnostician pipeline.
+ *
+ * The Router stage receives both Stage A (Root Cause) and Stage B (Distiller)
+ * artifacts and produces the final `DiagnosticianOutputV1` — the unchanged
+ * downstream contract consumed by the rest of the system.
+ *
+ * Unlike the monolithic DiagnosticianPromptBuilder which runs the full 5-phase
+ * protocol, the Router does NOT re-derive root causes or invent new principles.
+ * It routes what the distiller produced into the appropriate recommendation
+ * taxonomy kind(s).
+ *
+ * @see PRI-372 — Split diagnostician into Stage A (Root Cause) + Stage B (Distiller) + Stage C (Router)
+ */
+import { DefaultSchemaPromptAdapter } from '../adapter/schema-prompt-adapter.js';
+import { DiagnosticianOutputV1Schema } from '../diagnostician-output.js';
+import { buildLanguageDirective } from '../language-directive.js';
+// ── Builder class ────────────────────────────────────────────────────────────
+/**
+ * Prompt builder for Stage C (Router) of the split diagnostician pipeline.
+ *
+ * The Router takes the root cause from Stage A and the distilled principle
+ * from Stage B, then decides the concrete carrier(s) — the recommendation
+ * taxonomy kind(s) — and assembles the final `DiagnosticianOutputV1`.
+ *
+ * Key constraint: the Router MUST NOT re-derive the root cause or invent
+ * new principles. It routes what the distiller produced.
+ *
+ * @see PRI-372
+ */
+export class RouterPromptBuilder {
+    adapter;
+    schema;
+    constructor(opts = {}) {
+        this.adapter = opts.adapter ?? new DefaultSchemaPromptAdapter();
+        this.schema = opts.schema ?? DiagnosticianOutputV1Schema;
+    }
+    /**
+     * Build the router instruction string — the system-level directive that
+     * tells the LLM its role, input format, routing rules, output requirements,
+     * and constraints.
+     *
+     * @param opts - Optional overrides for adapter, schema, and outputLanguage.
+     *   When provided, these override the constructor defaults for this call only.
+     * @returns The router instruction string.
+     *
+     * @see PRI-372
+     */
+    buildRouterInstruction(opts = {}) {
+        const adapter = opts.adapter ?? this.adapter;
+        const schema = opts.schema ?? this.schema;
+        const { outputLanguage } = opts;
+        const example = adapter.generateExample(schema);
+        const constraints = adapter.generateConstraints(schema);
+        const languageDirective = buildLanguageDirective(outputLanguage);
+        return `You are a principle router. Your job is to take an abstracted principle and root cause, and decide the concrete carrier(s).
+
+INPUT:
+You receive two structured artifacts:
+1. Stage A Root Cause output — contains the causal chain, root cause classification, and evidence.
+2. Stage B Distiller output — contains the abstracted principle, rationale, core axiom grounding, scope, and confidence.
+
+ROUTING RULES:
+Based on the distiller's abstracted principle and the root cause from Stage A, decide the recommendation kind:
+
+- If the principle is broadly applicable across scenarios → kind: "principle"
+  (MUST include abstractedPrinciple field)
+- If a specific trigger pattern can be identified for deterministic interception → kind: "rule"
+  (MUST include triggerPattern and action fields)
+- If code/tool enforcement is possible and practical → kind: "implementation"
+- If a prompt directive can enforce the behavior → kind: "prompt"
+- If insufficient confidence or the finding is too specific/single-instance → kind: "defer"
+
+Default: "principle" is the preferred kind. Only use "defer" for noise signals or genuinely insufficient evidence.
+
+OUTPUT REQUIREMENTS:
+Your output MUST match DiagnosticianOutputV1Schema. You only need to generate these fields:
+
+- violatedPrinciples: array of violated principles, derived from Stage A's rootCause + Stage B's grounding
+  - title: short descriptive name for the violated principle (REQUIRED, 3-8 words)
+  - principleId: if the principle corresponds to a core axiom (e.g. T-01 through T-10), include the axiom ID; otherwise omit
+  - rationale: explanation of why this principle was violated (REQUIRED)
+- recommendations: one or more entries with the appropriate kind from the routing rules above
+- summary: a concise summary combining Stage A's root cause and Stage B's abstracted principle
+
+The following fields are auto-filled by the system from upstream artifacts — do NOT generate them:
+- rootCause (copied from Stage A)
+- evidence (copied from Stage A)
+- confidence (copied from Stage B)
+
+CONSTRAINT:
+You MUST NOT re-derive the root cause or invent new principles. Route what the distiller produced.
+
+CRITICAL: Your ENTIRE response must be ONLY the JSON object below. Do NOT include any text before or after the JSON. Do NOT wrap the JSON in markdown code fences. Do NOT add explanatory prose. Output the raw JSON object and nothing else.
+
+COMPLETE EXAMPLE OUTPUT (follow this exact structure):
+${example}
+
+IMPORTANT: The example above is ILLUSTRATIVE ONLY. Your output MUST be based on the actual Stage A and Stage B data provided — do not copy the example text verbatim.
+
+CONSTRAINTS:
+- Output ONLY valid JSON — no markdown, no explanatory text, no code fences, no prose before or after
+- Do NOT read files, call tools, or write to any database
+${constraints}${languageDirective}`;
+    }
+    /**
+     * Build the full prompt for the Router stage, combining the router
+     * instruction with the structured Stage A + Stage B context.
+     *
+     * @param context - Structured input carrying Stage A and Stage B artifacts.
+     * @param opts - Build options including outputLanguage.
+     * @returns RouterPromptBuildResult with JSON message and RouterPromptInput object.
+     *
+     * @see PRI-372
+     */
+    buildPrompt(context, opts = {}) {
+        const { outputLanguage } = opts;
+        const routerInstruction = this.buildRouterInstruction({ outputLanguage });
+        const promptInput = {
+            taskId: context.rootCauseOutput.taskId,
+            rootCauseArtifactId: context.rootCauseArtifactId,
+            rootCauseOutput: context.rootCauseOutput,
+            distillerArtifactId: context.distillerArtifactId,
+            distillerOutput: context.distillerOutput,
+            routerInstruction,
+        };
+        const message = JSON.stringify(promptInput);
+        return { message, promptInput };
+    }
+}
+//# sourceMappingURL=router-prompt-builder.js.map

package/core/dist/runtime-v2/diagnostician/router-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-prompt-builder.js","sourceRoot":"","sources":["../../../src/runtime-v2/diagnostician/router-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAKzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AA8ElE,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAsB;IAC7B,MAAM,CAAU;IAEjC,YAAY,OAAmC,EAAE;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,0BAA0B,EAAE,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,2BAA2B,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;OAUG;IACH,sBAAsB,CAAC,OAAmC,EAAE;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAC1C,MAAM,EAAC,cAAc,EAAC,GAAG,IAAI,CAAC;QAE9B,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;QAEjE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCT,OAAO;;;;;;;EAOP,WAAW,GAAG,iBAAiB,EAAE,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CACT,OAA2B,EAC3B,OAA2B,EAAE;QAE7B,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAEhC,MAAM,iBAAiB,GAAG,IAAI,CAAC,sBAAsB,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;QAE1E,MAAM,WAAW,GAAsB;YACrC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,MAAM;YACtC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,iBAAiB;SAClB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

package/core/dist/runtime-v2/diagnostician-prompt-builder.d.ts

@@ -4,33 +4,24 @@
  * Phase: m6-03
  * Requirements: DPB-01, DPB-02, DPB-03, DPB-04, DPB-05
  *
- * ## Contract
- *
- * buildPrompt() takes DiagnosticianContextPayload and returns a JSON string
- * to be passed as `openclaw agent --message <json>`.
- *
  * ## Output Structure (DPB-06)
  *
  * PromptInput has explicit top-level fields (taskId, contextHash, diagnosisTarget,
  * conversationWindow, sourceRefs) plus nested `context: DiagnosticianContextPayload`.
  *
- * ## Diagnostic Instruction (5 Whys / Root Cause Protocol)
- *
- * Per SKILL.md (pd-diagnostician): The LLM MUST follow the 5-phase protocol
- * (Phase 0 context → Phase 1 evidence → Phase 2 causal chain → Phase 3 classification
- * → Phase 4 principle extraction). The diagnosticInstruction field makes this explicit
- * so the LLM follows the protocol even if OpenClaw does not load SKILL.md automatically.
- *
- * ## Constraints (LOCKED)
- *
- * - DPB-02: Output is ONLY JSON — no markdown, no file ops, no tool calls
- * - DPB-07: NO extraSystemPrompt field — system prompt is agent profile's responsibility
- * - DPB-05: LLM only analyzes — PD database commits are handled by caller code
+ * (Note: monolithic DiagnosticianPromptBuilder and buildDiagnosticProtocolInstruction have been deleted per PRI-373).
  */
 import type { DiagnosticianContextPayload, HistoryQueryEntry, DiagnosisTarget } from './context-payload.js';
-import type { TSchema } from '@sinclair/typebox';
-import type { SchemaPromptAdapter } from './adapter/schema-prompt-adapter.js';
 import type { OutputLanguage } from './language-directive.js';
+/** Options for DiagnosticianPromptBuilder.buildPrompt() beyond the required payload. */
+export interface BuildPromptOptions {
+    /** Size limits to prevent token overflow (default: DEFAULT_PROMPT_BUILDER_LIMITS) */
+    limits?: PromptBuilderLimits;
+    /** Output language directive (default: none) */
+    outputLanguage?: OutputLanguage;
+    /** T-E (PRI-371): Inject core axiom grounding as PHASE 3.5 (default: false) */
+    coreGrounding?: boolean;
+}
 /**
  * PromptInput — the JSON message sent to openclaw agent via --message flag.
  *
@@ -89,18 +80,6 @@ export interface PromptBuildResult {
     /** The PromptInput object that was serialized to JSON */
     readonly promptInput: PromptInput;
 }
-/**
- * 5-phase diagnostic protocol instruction for the LLM.
- *
- * Per DPB-02 (LOCKED): Output is ONLY JSON — no markdown, no file ops, no tool calls.
- * Per DPB-04: LLM can only analyze the context provided in the prompt; it must NOT
- *   read files, call tools, or write to databases. All evidence must be drawn from
- *   the context payload (sourceRefs, conversationWindow, eventSummaries).
- *
- * The 5-phase protocol is embedded directly in the prompt so the LLM follows it
- * regardless of whether OpenClaw loads SKILL.md as the agent system prompt.
- */
-export declare function buildDiagnosticProtocolInstruction(adapter?: SchemaPromptAdapter, schema?: TSchema, outputLanguage?: OutputLanguage): string;
 /**
  * Summarizes a conversation window for inclusion in the prompt.
  * DPB-04: Prompt includes conversationWindow summary.
@@ -109,23 +88,4 @@ export declare function buildDiagnosticProtocolInstruction(adapter?: SchemaPromp
  * Subclasses or configuration can provide condensation logic.
  */
 export declare function summarizeConversationWindow(entries: HistoryQueryEntry[]): HistoryQueryEntry[];
-export declare class DiagnosticianPromptBuilder {
-    private readonly adapter;
-    private readonly schema;
-    constructor(adapter?: SchemaPromptAdapter, schema?: TSchema);
-    /**
-     * Transform DiagnosticianContextPayload into a PromptInput object,
-     * then serialize to JSON for the --message argument.
-     *
-     * @param payload — DiagnosticianContextPayload from context assembly (DPB-01)
-     * @param limits — Size limits to prevent token overflow (default: DEFAULT_PROMPT_BUILDER_LIMITS)
-     * @returns PromptBuildResult with JSON string + PromptInput object (DPB-02, DPB-03, DPB-04, DPB-06)
-     *
-     * Per DPB-05: This method only builds the prompt; it does NOT commit to PD database.
-     * The caller (DiagnosticianRunner or CLI layer) handles database commits.
-     *
-     * Per DPB-07: NO extraSystemPrompt is added — agent profile is the source of truth.
-     */
-    buildPrompt(payload: DiagnosticianContextPayload, limits?: PromptBuilderLimits, outputLanguage?: OutputLanguage): PromptBuildResult;
-}
 //# sourceMappingURL=diagnostician-prompt-builder.d.ts.map

package/core/dist/runtime-v2/diagnostician-prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostician-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/diagnostician-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,OAAO,EAAE,2BAA2B,CAAC;IACrC;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAIlC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,mBAAsD,EAC/D,MAAM,GAAE,OAAqC,EAC7C,cAAc,CAAC,EAAE,cAAc,GAC9B,MAAM,CAyDR;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAAE,GAC3B,iBAAiB,EAAE,CAErB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAG/B,OAAO,GAAE,mBAAsD,EAC/D,MAAM,GAAE,OAAqC;IAM/C;;;;;;;;;;;;OAYG;IACH,WAAW,CACT,OAAO,EAAE,2BAA2B,EACpC,MAAM,GAAE,mBAAmD,EAC3D,cAAc,CAAC,EAAE,cAAc,GAC9B,iBAAiB;CAkErB"}
+{"version":3,"file":"diagnostician-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/diagnostician-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,OAAO,EAAE,2BAA2B,CAAC;IACrC;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAIlC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAAE,GAC3B,iBAAiB,EAAE,CAErB"}

package/core/dist/runtime-v2/diagnostician-prompt-builder.js

@@ -1,79 +1,8 @@
-import { DefaultSchemaPromptAdapter } from './adapter/schema-prompt-adapter.js';
-import { DiagnosticianOutputV1Schema } from './diagnostician-output.js';
-import { buildLanguageDirective } from './language-directive.js';
 export const DEFAULT_PROMPT_BUILDER_LIMITS = {
     maxConversationEntries: 30,
     maxEntryTextChars: 2000,
     maxMessageChars: 80_000,
 };
-/**
- * 5-phase diagnostic protocol instruction for the LLM.
- *
- * Per DPB-02 (LOCKED): Output is ONLY JSON — no markdown, no file ops, no tool calls.
- * Per DPB-04: LLM can only analyze the context provided in the prompt; it must NOT
- *   read files, call tools, or write to databases. All evidence must be drawn from
- *   the context payload (sourceRefs, conversationWindow, eventSummaries).
- *
- * The 5-phase protocol is embedded directly in the prompt so the LLM follows it
- * regardless of whether OpenClaw loads SKILL.md as the agent system prompt.
- */
-export function buildDiagnosticProtocolInstruction(adapter = new DefaultSchemaPromptAdapter(), schema = DiagnosticianOutputV1Schema, outputLanguage) {
-    const example = adapter.generateExample(schema);
-    const constraints = adapter.generateConstraints(schema);
-    const languageDirective = buildLanguageDirective(outputLanguage);
-    return `You are a root cause analysis expert. Follow this protocol:
-
-PHASE 1 — Evidence Review:
-Review the provided sourceRefs, diagnosisTarget.evidence entries, conversationWindow
-entries, and eventSummaries from the context payload. Do NOT read any files or call any tools.
-Record all evidence by referencing the sourceRef identifiers and conversation
-entries already present in the context. Each evidence item must cite its source.
-Pay special attention to diagnosisTarget.evidence — these are the primary behavioral
-evidence (owner messages and agent actions) that the root cause analysis must address.
-
-PHASE 2 — Causal Chain (5 Whys):
-Build a Why-1 through Why-5 causal chain. Each Why MUST have evidence from Phase 1.
-- Why 1: Surface phenomenon (visible error)
-- Why 2: Direct cause (nearest trigger)
-- Why 3: Process gap (missing check/gate)
-- Why 4: Design flaw (why gap exists)
-- Why 5: Root cause (systemic defect)
-Stop early if you find a directly fixable problem.
-
-PHASE 3 — Root Cause Classification:
-Classify into ONE: People | Design | Assumption | Tooling
-- People: capability blind spots, habit issues
-- Design: architecture defects, missing gates, process gaps
-- Assumption: wrong assumptions about env/versions/deps
-- Tooling: tool misconfiguration, API changes
-
-PHASE 4 — Recommendation Taxonomy & Distillation:
-Analyze the root cause and propose actionable recommendations. Classify each recommendation into one of FIVE categories based on the taxonomy below.
-
-TAXONOMY DEFINITIONS:
-1. "rule": Deterministic constraints. Use for specific tool blocks or path protections. A "rule" MUST have a precise 'triggerPattern' and 'action' for physical interception.
-2. "principle": Abstract, reusable wisdom. Use for high-level architectural guidelines. MUST have 'abstractedPrinciple'.
-3. "implementation": Code-level candidate. Use for extremely specific code patches.
-4. "prompt": Context/Skill injection. Use to influence the agent's workflow habits.
-5. "defer": Insufficient evidence. Use for network timeouts or noise.
-
-EVIDENCE SCOPE GUARD:
-- The root cause MUST describe an agent behavior or decision, not a system monitoring or diagnostic mechanism.
-- If the evidence only describes internal metrics (GFI, friction scores, threshold crossings) with no
-  owner message or agent action context, return confidence < 0.3 and kind="defer".
-
-CRITICAL: Your ENTIRE response must be ONLY the JSON object below. Do NOT include any text before or after the JSON. Do NOT wrap the JSON in markdown code fences. Do NOT add explanatory prose. Output the raw JSON object and nothing else.
-
-COMPLETE EXAMPLE OUTPUT (follow this exact structure):
-${example}
-
-IMPORTANT: The example above is ILLUSTRATIVE ONLY. Your recommendations MUST be based on the actual root cause analysis and evidence in this context — do not copy the example text verbatim.
-
-CONSTRAINTS:
-- Output ONLY valid JSON — no markdown, no explanatory text, no code fences, no prose before or after
-- Do NOT read files, call tools, or write to any database
-${constraints}${languageDirective}`;
-}
 /**
  * Summarizes a conversation window for inclusion in the prompt.
  * DPB-04: Prompt includes conversationWindow summary.
@@ -84,81 +13,4 @@ ${constraints}${languageDirective}`;
 export function summarizeConversationWindow(entries) {
     return entries;
 }
-export class DiagnosticianPromptBuilder {
-    adapter;
-    schema;
-    constructor(adapter = new DefaultSchemaPromptAdapter(), schema = DiagnosticianOutputV1Schema) {
-        this.adapter = adapter;
-        this.schema = schema;
-    }
-    /**
-     * Transform DiagnosticianContextPayload into a PromptInput object,
-     * then serialize to JSON for the --message argument.
-     *
-     * @param payload — DiagnosticianContextPayload from context assembly (DPB-01)
-     * @param limits — Size limits to prevent token overflow (default: DEFAULT_PROMPT_BUILDER_LIMITS)
-     * @returns PromptBuildResult with JSON string + PromptInput object (DPB-02, DPB-03, DPB-04, DPB-06)
-     *
-     * Per DPB-05: This method only builds the prompt; it does NOT commit to PD database.
-     * The caller (DiagnosticianRunner or CLI layer) handles database commits.
-     *
-     * Per DPB-07: NO extraSystemPrompt is added — agent profile is the source of truth.
-     */
-    buildPrompt(payload, limits = DEFAULT_PROMPT_BUILDER_LIMITS, outputLanguage) {
-        const truncationWarnings = [];
-        // DPB-04: Apply truncation to conversationWindow to prevent token overflow
-        const rawWindow = summarizeConversationWindow(payload.conversationWindow);
-        const windowEntries = rawWindow.slice(0, limits.maxConversationEntries);
-        if (rawWindow.length > limits.maxConversationEntries) {
-            truncationWarnings.push(`conversationWindow truncated from ${rawWindow.length} to ${limits.maxConversationEntries} entries`);
-        }
-        // Truncate individual entry text
-        const conversationWindow = windowEntries.map((entry) => {
-            if (entry.text && entry.text.length > limits.maxEntryTextChars) {
-                return {
-                    ...entry,
-                    text: entry.text.slice(0, limits.maxEntryTextChars) + '...[truncated]',
-                };
-            }
-            return entry;
-        });
-        // Build compact context — replace conversationWindow with truncated version
-        // to avoid duplicating full content at top-level AND in context
-        const compactContext = {
-            ...payload,
-            conversationWindow,
-        };
-        const diagnosticInstruction = buildDiagnosticProtocolInstruction(this.adapter, this.schema, outputLanguage);
-        // DPB-04: Explicit top-level fields at the prompt level
-        const promptInput = {
-            taskId: payload.taskId,
-            contextHash: payload.contextHash,
-            diagnosisTarget: payload.diagnosisTarget,
-            conversationWindow,
-            sourceRefs: payload.sourceRefs,
-            context: compactContext,
-            diagnosticInstruction,
-            ...(truncationWarnings.length > 0 ? { truncationWarnings } : {}),
-        };
-        // DPB-02: Output is ONLY JSON — no markdown, no file ops, no tool calls
-        // DPB-03: JSON must conform to what DiagnosticianOutputV1 expects (caller validates)
-        let message = JSON.stringify(promptInput);
-        // If message exceeds maxMessageChars, truncate the diagnostic instruction
-        if (message.length > limits.maxMessageChars) {
-            const surplus = message.length - limits.maxMessageChars;
-            const instruction = diagnosticInstruction;
-            // Keep at least the first 200 chars of the instruction + a note
-            const keepLength = Math.max(200, instruction.length - surplus - 100);
-            const truncatedInstruction = instruction.slice(0, keepLength) +
-                '\n\n[OUTPUT FORMAT section is REQUIRED; other sections may be summarized if needed]';
-            promptInput.diagnosticInstruction = truncatedInstruction;
-            promptInput.truncationWarnings = [
-                ...truncationWarnings,
-                `diagnosticInstruction truncated due to size (${message.length} > ${limits.maxMessageChars})`,
-            ];
-            message = JSON.stringify(promptInput);
-        }
-        return { message, promptInput };
-    }
-}
 //# sourceMappingURL=diagnostician-prompt-builder.js.map

package/core/dist/runtime-v2/diagnostician-prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostician-prompt-builder.js","sourceRoot":"","sources":["../../src/runtime-v2/diagnostician-prompt-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostician-prompt-builder.js","sourceRoot":"","sources":["../../src/runtime-v2/diagnostician-prompt-builder.ts"],"names":[],"mappings":"AA6EA,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,sBAAsB,EAAE,EAAE;IAC1B,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,MAAM;CACf,CAAC;AAeX;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA4B;IAE5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/core/dist/runtime-v2/evidence-guards.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared evidence guard functions for admission gate and pain signal bridge.
+ *
+ * Both gate and bridge must agree on what constitutes "owner explicit manual" paths.
+ * This module is the single source of truth for that logic.
+ *
+ * PRI-345: input-evidence hard gate + empty-evidence short circuit.
+ */
+import type { PainProvenance } from './admission-gate.js';
+/**
+ * Returns true when the provenance indicates an owner explicitly reported
+ * the pain signal (e.g. CLI `pd pain` with no authenticated host session).
+ *
+ * Owner-reported paths are exempt from the input-evidence-empty gate
+ * because the owner's intent itself is evidence of a real problem.
+ */
+export declare function isOwnerExplicitManual(provenance: PainProvenance | undefined): boolean;
+/**
+ * Returns true when the pain signal should be short-circuited before
+ * calling the diagnostician runner.
+ *
+ * Conditions for short circuit:
+ *  - Input evidence array is empty (no evidence to diagnose)
+ *  - Source is NOT one of the owner-initiated channels (manual, pain, skill:pain)
+ *
+ * Owner-initiated sources bypass the short circuit because the owner's
+ * explicit intent is itself a valid reason to run diagnosis even without
+ * pre-collected evidence.
+ */
+export declare function shouldShortCircuitEmptyEvidence(evidenceLength: number, source: string): boolean;
+//# sourceMappingURL=evidence-guards.d.ts.map

package/core/dist/runtime-v2/evidence-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-guards.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/evidence-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAErF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK/F"}

package/core/dist/runtime-v2/evidence-guards.js

@@ -0,0 +1,29 @@
+/**
+ * Returns true when the provenance indicates an owner explicitly reported
+ * the pain signal (e.g. CLI `pd pain` with no authenticated host session).
+ *
+ * Owner-reported paths are exempt from the input-evidence-empty gate
+ * because the owner's intent itself is evidence of a real problem.
+ */
+export function isOwnerExplicitManual(provenance) {
+    return provenance === 'owner_reported_no_host_trace';
+}
+/**
+ * Returns true when the pain signal should be short-circuited before
+ * calling the diagnostician runner.
+ *
+ * Conditions for short circuit:
+ *  - Input evidence array is empty (no evidence to diagnose)
+ *  - Source is NOT one of the owner-initiated channels (manual, pain, skill:pain)
+ *
+ * Owner-initiated sources bypass the short circuit because the owner's
+ * explicit intent is itself a valid reason to run diagnosis even without
+ * pre-collected evidence.
+ */
+export function shouldShortCircuitEmptyEvidence(evidenceLength, source) {
+    return evidenceLength === 0
+        && source !== 'manual'
+        && source !== 'pain'
+        && source !== 'skill:pain';
+}
+//# sourceMappingURL=evidence-guards.js.map

package/core/dist/runtime-v2/evidence-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-guards.js","sourceRoot":"","sources":["../../src/runtime-v2/evidence-guards.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAsC;IAC1E,OAAO,UAAU,KAAK,8BAA8B,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAAC,cAAsB,EAAE,MAAc;IACpF,OAAO,cAAc,KAAK,CAAC;WACtB,MAAM,KAAK,QAAQ;WACnB,MAAM,KAAK,MAAM;WACjB,MAAM,KAAK,YAAY,CAAC;AAC/B,CAAC"}

package/core/dist/runtime-v2/feature-flags/__tests__/feature-flag-contract.test.js

@@ -151,19 +151,29 @@ describe('computeEffectiveFlags', () => {
         expect(result.flags.totally_made_up).toBeUndefined();
         expect(result.warnings.some(w => w.includes('totally_made_up'))).toBe(true);
     });
-    it('preserves core flags as enabled regardless of user config', () => {
+    it('PRI-435: honors explicit emergency disable of core flag when deliberately configured', () => {
         const promptDefault = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'prompt');
-        if (!promptDefault)
-            return;
+        // PRI-435 (CodeRabbit P2): fail loud if the prompt flag is missing from defaults
+        expect(promptDefault).toBeDefined();
         const userFlags = {
             prompt: { enabled: false, since: '2026-01-01' },
         };
         const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
         const promptFlag = result.flags.prompt;
-        if (promptFlag) {
-            expect(promptFlag.enabled).toBe(true);
-        }
-        expect(result.warnings.some(w => w.includes('core') || w.includes('prompt'))).toBe(true);
+        // PRI-435 (CodeRabbit P2): fail loud if computeEffectiveFlags drops the flag
+        expect(promptFlag).toBeDefined();
+        expect(promptFlag?.enabled).toBe(false);
+        expect(result.warnings.some(w => w.includes('core') && w.includes('prompt'))).toBe(true);
+    });
+    it('PRI-435: core flags default ON when config omits enabled value', () => {
+        const userFlags = {
+            prompt: { category: 'core' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const promptFlag = result.flags.prompt;
+        // PRI-435 (CodeRabbit P2): fail loud if the flag is missing
+        expect(promptFlag).toBeDefined();
+        expect(promptFlag?.enabled).toBe(true);
     });
     it('allows explicit enable of quiet flag with valid input', () => {
         const userFlags = {
@@ -184,6 +194,18 @@ describe('computeEffectiveFlags', () => {
                 continue;
             if (flag.id === 'correction_observer')
                 continue;
+            if (flag.id === 'diagnostician_async_cli')
+                continue;
+            if (flag.id === 'diagnostician_core_grounding')
+                continue;
+            if (flag.id === 'diagnostician_split_pipeline')
+                continue;
+            if (flag.id === 'internalization_core_grounding')
+                continue;
+            if (flag.id === 'internalization_auto_consumer')
+                continue;
+            if (flag.id === 'story_a_approval_completion')
+                continue;
             expect(flag.enabled, `quiet flag ${flag.id} should default off`).toBe(false);
         }
     });
@@ -207,6 +229,27 @@ describe('computeEffectiveFlags', () => {
             expect(goneFlag.enabled).toBe(false);
         }
     });
+    it('allows diagnostician_async_cli to be enabled independently', () => {
+        const userFlags = {
+            diagnostician_async_cli: { enabled: true },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const asyncFlag = result.flags.diagnostician_async_cli;
+        if (asyncFlag) {
+            expect(asyncFlag.enabled).toBe(true);
+        }
+    });
+    it('allows diagnostician_split_pipeline to be enabled independently', () => {
+        const userFlags = {
+            diagnostician_split_pipeline: { enabled: true },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const splitFlag = result.flags.diagnostician_split_pipeline;
+        if (splitFlag) {
+            expect(splitFlag.enabled).toBe(true);
+        }
+        expect(result.warnings.some(w => w.includes('invalid combo'))).toBe(false);
+    });
 });
 describe('DEFAULT_FEATURE_FLAGS', () => {
     it('contains prompt core flag', () => {
@@ -225,6 +268,14 @@ describe('DEFAULT_FEATURE_FLAGS', () => {
             expect(flag.enabled).toBe(true);
         }
     });
+    it('contains code_rule_capability core flag (PRI-435: promoted to MVP-Core, default on)', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'code_rule_capability');
+        expect(flag).toBeDefined();
+        if (flag) {
+            expect(flag.category).toBe('core');
+            expect(flag.enabled).toBe(true);
+        }
+    });
     it('contains defer_archive core flag', () => {
         const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'defer_archive');
         expect(flag).toBeDefined();
@@ -282,6 +333,54 @@ describe('DEFAULT_FEATURE_FLAGS', () => {
         expect(flag.since).toBe('2026-06-06');
         expect(flag.description).toContain('PEAT-B1');
     });
+    it('PRI-404: pain_evidence_admission snake_case alias is registered as quiet, default-off', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'pain_evidence_admission');
+        expect(flag).toBeDefined();
+        if (!flag)
+            throw new Error('pain_evidence_admission flag not found');
+        expect(flag.category).toBe('quiet');
+        expect(flag.enabled).toBe(false);
+        expect(flag.since).toBe('2026-06-15');
+        expect(flag.description).toContain('Snake-case');
+    });
+    it('PRI-404: pain_evidence_admission is recognized by computeEffectiveFlags (no unknown warning)', () => {
+        const userFlags = {
+            pain_evidence_admission: { enabled: true },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const flag = result.flags.pain_evidence_admission;
+        expect(flag).toBeDefined();
+        if (flag) {
+            expect(flag.enabled).toBe(true);
+        }
+        expect(result.warnings.some(w => w.includes('pain_evidence_admission') && w.includes('unknown'))).toBe(false);
+    });
+    it('PRI-375: diagnostician_async_cli is registered as quiet, default-off', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'diagnostician_async_cli');
+        expect(flag).toBeDefined();
+        if (!flag)
+            throw new Error('diagnostician_async_cli flag not found');
+        expect(flag.category).toBe('quiet');
+        expect(flag.enabled).toBe(false);
+        expect(flag.since).toBe('2026-06-11');
+        expect(flag.description).toContain('Async pain-record CLI');
+    });
+    it('PRI-369: diagnostician_core_grounding is registered as quiet, default-on', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'diagnostician_core_grounding');
+        expect(flag).toBeDefined();
+        if (!flag)
+            throw new Error('diagnostician_core_grounding flag not found');
+        expect(flag.category).toBe('quiet');
+        expect(flag.enabled).toBe(true);
+    });
+    it('PRI-369: diagnostician_split_pipeline is registered as quiet, default-on', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'diagnostician_split_pipeline');
+        expect(flag).toBeDefined();
+        if (!flag)
+            throw new Error('diagnostician_split_pipeline flag not found');
+        expect(flag.category).toBe('quiet');
+        expect(flag.enabled).toBe(true);
+    });
 });
 describe('VALID_CATEGORIES', () => {
     it('contains exactly core, quiet, gone, legacy_retire', () => {