@principles/core 1.123.0 → 1.124.0

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

@@ -0,0 +1,156 @@
+/**
+ * DistillerPromptBuilder — Stage B prompt builder for the split diagnostician pipeline.
+ *
+ * Constructs the prompt for the Distiller stage (Stage B). It receives the
+ * Stage A root cause artifact as input and produces an abstracted principle
+ * grounded on core axioms (T-01..T-10).
+ *
+ * ## Prompt Sections
+ *
+ * 1. Role — principle distiller identity
+ * 2. Input — Stage A root cause output (structured data)
+ * 3. Core Axioms — T-01..T-10 list (when coreGrounding=true)
+ * 4. Output Requirements — DiagDistillerOutputV1Schema
+ * 5. Quality Guard — abstract vs rule-like distinction
+ *
+ * @see PRI-372
+ */
+import { DefaultSchemaPromptAdapter } from '../adapter/schema-prompt-adapter.js';
+import { DiagDistillerOutputV1Schema } from './diag-distiller-output.js';
+import { CORE_PRINCIPLES } from '../core-principles/core-principle-registry.js';
+import { buildLanguageDirective } from '../language-directive.js';
+// ── Instruction builder ──────────────────────────────────────────────────────
+/**
+ * Build the Stage B distiller protocol instruction.
+ *
+ * When `coreGrounding` is true, the Core Axioms section is included with
+ * the full T-01..T-10 list and a strict instruction prohibiting fabricated
+ * axiom IDs. When false or undefined, the section is omitted.
+ *
+ * @see PRI-372
+ */
+export function buildDistillerProtocolInstruction(opts = {}) {
+    const adapter = opts.adapter ?? new DefaultSchemaPromptAdapter();
+    const schema = opts.schema ?? DiagDistillerOutputV1Schema;
+    const { outputLanguage, coreGrounding } = opts;
+    const example = adapter.generateExample(schema);
+    const constraints = adapter.generateConstraints(schema);
+    const languageDirective = buildLanguageDirective(outputLanguage);
+    // Core Axioms section — only when coreGrounding is true
+    const coreAxiomsBlock = coreGrounding
+        ? `
+CORE AXIOMS:
+The following core axioms are the system's foundational behavioral principles.
+You MUST only reference axiom IDs from this list. Fabricating IDs not in this
+list will cause validation failure.
+
+${CORE_PRINCIPLES.map(p => `${p.id}: ${p.statement}`).join('\n')}
+
+`
+        : '';
+    return `You are a principle distiller. Your job is to abstract a specific root cause into a general, cross-scenario principle.
+
+INPUT:
+You will receive the Stage A root cause output as structured data. This contains:
+- summary: a concise description of the diagnosis
+- causalChain: the 5-Whys causal chain
+- rootCause: the classified root cause with category prefix
+- rootCauseCategory: People | Design | Assumption | Tooling
+- evidence: supporting evidence entries
+- confidence: the Stage A confidence score
+${coreAxiomsBlock}OUTPUT REQUIREMENTS:
+Your output MUST match the following JSON schema exactly.
+
+COMPLETE EXAMPLE OUTPUT (follow this exact structure):
+${example}
+
+Key fields:
+- abstractedPrinciple: ≤200 chars, abstract, cross-scenario principle that grows from the root cause
+- groundedOnCorePrincipleIds: subset of the provided axiom IDs above (empty array if none apply)
+- sourceRootCauseArtifactId: MUST match the provided artifact ID exactly
+- scope: 'general' | 'domain' | 'scenario'
+- rationale: why this principle addresses the root cause
+- confidence: 0-1 scale
+
+QUALITY GUARD:
+Your principle must be ABSTRACT, not rule-like. Avoid concrete trigger patterns,
+specific tools, or implementation details. A principle is directional wisdom;
+a rule is a boundary condition.
+
+Examples:
+- GOOD (abstract principle): "Prefer understanding the existing structure before modifying it"
+- BAD (rule-like): "Always run grep before editing files" or "Never use as casts"
+- GOOD (intent over technique): "Explicitly stated user constraints take precedence over inferred optimal paths"
+- BAD (technique-specific): "Do not create project files in /tmp directory"
+
+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
+- abstractedPrinciple MUST be ≤200 characters
+- groundedOnCorePrincipleIds MUST only contain IDs from the provided axiom list${coreGrounding ? ' above' : ''}; fabricated IDs cause validation failure
+- sourceRootCauseArtifactId MUST match the provided artifact ID
+${constraints}${languageDirective}`;
+}
+// ── Prompt builder class ─────────────────────────────────────────────────────
+/**
+ * DistillerPromptBuilder — Stage B prompt builder for the split diagnostician pipeline.
+ *
+ * Receives the Stage A root cause artifact as input and produces an abstracted
+ * principle grounded on core axioms (T-01..T-10).
+ *
+ * Uses an opts-object pattern for all methods to satisfy @typescript-eslint/max-params.
+ *
+ * @see PRI-372
+ */
+export class DistillerPromptBuilder {
+    adapter;
+    schema;
+    constructor(opts = {}) {
+        this.adapter = opts.adapter ?? new DefaultSchemaPromptAdapter();
+        this.schema = opts.schema ?? DiagDistillerOutputV1Schema;
+    }
+    /**
+     * Build the Stage B distiller protocol instruction.
+     *
+     * Contains the role definition, input description, core axioms section
+     * (when coreGrounding=true), output requirements, and quality guard.
+     *
+     * @see PRI-372
+     */
+    buildDistillerInstruction(opts = {}) {
+        return buildDistillerProtocolInstruction({
+            adapter: opts.adapter ?? this.adapter,
+            schema: opts.schema ?? this.schema,
+            outputLanguage: opts.outputLanguage,
+            coreGrounding: opts.coreGrounding,
+        });
+    }
+    /**
+     * Build the full prompt for Stage B.
+     *
+     * Constructs a DistillerPromptBuildResult containing the JSON message to pass
+     * as the --message argument to the LLM agent. The message includes the
+     * distiller instruction and the Stage A root cause context.
+     *
+     * Per DPB-02: Output is ONLY JSON — no markdown, no file ops, no tool calls.
+     * Per DPB-05: This method only builds the prompt; it does NOT commit to PD database.
+     *
+     * @see PRI-372
+     */
+    buildPrompt(context, opts = {}) {
+        const { outputLanguage } = opts;
+        const coreGrounding = context.coreGrounding ?? opts.coreGrounding;
+        const distillerInstruction = this.buildDistillerInstruction({
+            outputLanguage,
+            coreGrounding,
+        });
+        const promptInput = {
+            rootCauseArtifactId: context.rootCauseArtifactId,
+            rootCauseOutput: context.rootCauseOutput,
+            distillerInstruction,
+        };
+        const message = JSON.stringify(promptInput);
+        return { message, promptInput };
+    }
+}
+//# sourceMappingURL=distiller-prompt-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distiller-prompt-builder.js","sourceRoot":"","sources":["../../../src/runtime-v2/diagnostician/distiller-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AA6ElE,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAsC,EAAE;IAExC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,0BAA0B,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,2BAA2B,CAAC;IAC1D,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAE/C,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAEjE,wDAAwD;IACxD,MAAM,eAAe,GAAG,aAAa;QACnC,CAAC,CAAC;;;;;;EAMJ,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;CAE/D;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;EAUP,eAAe;;;;EAIf,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;iFAyBwE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;;EAE5G,WAAW,GAAG,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAsB;IAC7B,MAAM,CAAU;IAEjC,YAAY,OAAsC,EAAE;QAClD,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;;;;;;;OAOG;IACH,yBAAyB,CAAC,OAAsC,EAAE;QAChE,OAAO,iCAAiC,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAClC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CACT,OAA8B,EAC9B,OAA2B,EAAE;QAE7B,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC;QAElE,MAAM,oBAAoB,GAAG,IAAI,CAAC,yBAAyB,CAAC;YAC1D,cAAc;YACd,aAAa;SACd,CAAC,CAAC;QAEH,MAAM,WAAW,GAAyB;YACxC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,oBAAoB;SACrB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,96 @@
+/**
+ * RootCausePromptBuilder — Stage A prompt builder for the split diagnostician pipeline.
+ *
+ * Constructs the prompt for the Root Cause stage (Stage A), which identifies
+ * the underlying cause of a pain signal using a 5-Whys causal chain and
+ * categorises it into one of four root-cause categories.
+ *
+ * ## Phases
+ *
+ * - PHASE 1 — Evidence Review
+ * - PHASE 2 — Causal Chain (5 Whys)
+ * - PHASE 3 — Root Cause Classification
+ * - PHASE 3.5 — Core Axiom Grounding (when coreGrounding=true, PRI-371)
+ *
+ * ## Output
+ *
+ * The prompt requires output matching DiagRootCauseOutputV1Schema.
+ *
+ * @see PRI-372
+ */
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaPromptAdapter } from '../adapter/schema-prompt-adapter.js';
+import type { DiagnosticianContextPayload } from '../context-payload.js';
+import type { OutputLanguage } from '../language-directive.js';
+import type { BuildPromptOptions, PromptBuildResult } from '../diagnostician-prompt-builder.js';
+/**
+ * Options for RootCausePromptBuilder constructor and buildRootCauseInstruction.
+ *
+ * Uses an opts-object pattern to satisfy @typescript-eslint/max-params.
+ *
+ * @see PRI-372
+ */
+export interface RootCausePromptBuilderOptions {
+    /** Schema prompt adapter (default: DefaultSchemaPromptAdapter) */
+    adapter?: SchemaPromptAdapter;
+    /** TypeBox schema for output validation (default: DiagRootCauseOutputV1Schema) */
+    schema?: TSchema;
+    /** Output language directive (default: none) */
+    outputLanguage?: OutputLanguage;
+    /** T-E (PRI-371): Inject core axiom grounding as PHASE 3.5 (default: false) */
+    coreGrounding?: boolean;
+}
+/**
+ * Build the Stage A diagnostic protocol instruction (PHASE 1–3 + optional PHASE 3.5).
+ *
+ * Per DPB-02 (LOCKED): Output is ONLY JSON — no markdown, no file ops, no tool calls.
+ * Per DPB-04: LLM can only analyse the context provided in the prompt; it must NOT
+ *   read files, call tools, or write to databases.
+ *
+ * When `coreGrounding` is true, PHASE 3.5 (Core Axiom Grounding) is inserted
+ * between PHASE 3 and the final output instruction. When false or undefined,
+ * a newline is inserted to preserve byte-identical output (EP-03: no silent fallback).
+ *
+ * @see PRI-372
+ */
+export declare function buildRootCauseProtocolInstruction(opts?: RootCausePromptBuilderOptions): string;
+/**
+ * RootCausePromptBuilder — Stage A prompt builder for the split diagnostician pipeline.
+ *
+ * Transforms DiagnosticianContextPayload into a PromptBuildResult for the
+ * Root Cause stage (Stage A). The output prompt requires the LLM to produce
+ * JSON matching DiagRootCauseOutputV1Schema.
+ *
+ * Uses an opts-object pattern for all methods to satisfy @typescript-eslint/max-params.
+ *
+ * @see PRI-372
+ */
+export declare class RootCausePromptBuilder {
+    private readonly adapter;
+    private readonly schema;
+    constructor(opts?: RootCausePromptBuilderOptions);
+    /**
+     * Build the Stage A diagnostic protocol instruction.
+     *
+     * Contains PHASE 1 (evidence review), PHASE 2 (causal chain / 5-Whys),
+     * PHASE 3 (root cause classification), and optional PHASE 3.5 (core axiom
+     * grounding when coreGrounding=true).
+     *
+     * @see PRI-372
+     */
+    buildRootCauseInstruction(opts?: RootCausePromptBuilderOptions): string;
+    /**
+     * Build the full prompt for Stage A.
+     *
+     * Transforms DiagnosticianContextPayload into a PromptBuildResult containing
+     * the JSON message to pass as the --message argument to the LLM agent.
+     *
+     * Per DPB-02: Output is ONLY JSON — no markdown, no file ops, no tool calls.
+     * Per DPB-05: This method only builds the prompt; it does NOT commit to PD database.
+     * Per DPB-07: NO extraSystemPrompt is added — agent profile is the source of truth.
+     *
+     * @see PRI-372
+     */
+    buildPrompt(payload: DiagnosticianContextPayload, opts?: BuildPromptOptions): PromptBuildResult;
+}
+//# sourceMappingURL=rootcause-prompt-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rootcause-prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/diagnostician/rootcause-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAS5C;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kEAAkE;IAClE,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,GAAE,6BAAkC,GACvC,MAAM,CAsER;AAID;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,IAAI,GAAE,6BAAkC;IAKpD;;;;;;;;OAQG;IACH,yBAAyB,CAAC,IAAI,GAAE,6BAAkC,GAAG,MAAM;IAS3E;;;;;;;;;;;OAWG;IACH,WAAW,CACT,OAAO,EAAE,2BAA2B,EACpC,IAAI,GAAE,kBAAuB,GAC5B,iBAAiB;CAwErB"}

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

@@ -0,0 +1,216 @@
+/**
+ * RootCausePromptBuilder — Stage A prompt builder for the split diagnostician pipeline.
+ *
+ * Constructs the prompt for the Root Cause stage (Stage A), which identifies
+ * the underlying cause of a pain signal using a 5-Whys causal chain and
+ * categorises it into one of four root-cause categories.
+ *
+ * ## Phases
+ *
+ * - PHASE 1 — Evidence Review
+ * - PHASE 2 — Causal Chain (5 Whys)
+ * - PHASE 3 — Root Cause Classification
+ * - PHASE 3.5 — Core Axiom Grounding (when coreGrounding=true, PRI-371)
+ *
+ * ## Output
+ *
+ * The prompt requires output matching DiagRootCauseOutputV1Schema.
+ *
+ * @see PRI-372
+ */
+import { DefaultSchemaPromptAdapter } from '../adapter/schema-prompt-adapter.js';
+import { DiagRootCauseOutputV1Schema } from './diag-rootcause-output.js';
+import { buildLanguageDirective } from '../language-directive.js';
+import { CORE_PRINCIPLES } from '../core-principles/core-principle-registry.js';
+import { DEFAULT_PROMPT_BUILDER_LIMITS, summarizeConversationWindow, } from '../diagnostician-prompt-builder.js';
+// ── Instruction builder ──────────────────────────────────────────────────────
+/**
+ * Build the Stage A diagnostic protocol instruction (PHASE 1–3 + optional PHASE 3.5).
+ *
+ * Per DPB-02 (LOCKED): Output is ONLY JSON — no markdown, no file ops, no tool calls.
+ * Per DPB-04: LLM can only analyse the context provided in the prompt; it must NOT
+ *   read files, call tools, or write to databases.
+ *
+ * When `coreGrounding` is true, PHASE 3.5 (Core Axiom Grounding) is inserted
+ * between PHASE 3 and the final output instruction. When false or undefined,
+ * a newline is inserted to preserve byte-identical output (EP-03: no silent fallback).
+ *
+ * @see PRI-372
+ */
+export function buildRootCauseProtocolInstruction(opts = {}) {
+    const adapter = opts.adapter ?? new DefaultSchemaPromptAdapter();
+    const schema = opts.schema ?? DiagRootCauseOutputV1Schema;
+    const { outputLanguage, coreGrounding } = opts;
+    const example = adapter.generateExample(schema);
+    const constraints = adapter.generateConstraints(schema);
+    const languageDirective = buildLanguageDirective(outputLanguage);
+    // T-E (PRI-371): When coreGrounding is true, insert PHASE 3.5.
+    // When false or undefined, output is byte-identical to the original
+    // (EP-03: no silent fallback).
+    const phase35Block = coreGrounding
+        ? `
+PHASE 3.5 — Core Axiom Grounding:
+The following core axioms are the system's foundational behavioral principles.
+If the root cause relates to any of these axioms, note the axiom ID (e.g. T-01)
+in the ambiguityNotes field of your output.
+
+Core Axioms:
+${CORE_PRINCIPLES.map(p => `${p.id}: ${p.statement}`).join('\n')}
+
+`
+        : '\n';
+    return `You are a root cause analysis expert. Follow this protocol:
+
+PHASE 1 — Evidence Review:
+Review the provided sourceRefs, diagnosisTarget.evidence entries, and conversationWindow
+entries 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 at least one evidenceRefs entry referencing a sourceRef from Phase 1.
+- If no evidence is available for a Why level, reference the closest available evidence and note the gap in ambiguityNotes.
+- evidenceRefs MUST NOT be an empty array — every causal chain entry must cite at least one evidence source.
+- 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
+${phase35Block}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 root cause analysis MUST be based on the actual 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
+- rootCause MUST include category prefix: "People: ..." or "Design: ..." or "Assumption: ..." or "Tooling: ..."
+- rootCauseCategory MUST match the category prefix in rootCause
+- If diagnosisTarget.evidence is an empty array (length === 0), you MUST NOT fabricate evidence entries.
+  Output confidence < 0.3 and set ambiguityNotes to include "Insufficient evidence".
+- evidence: list all evidence items that support your analysis. If sourceRefs or diagnosisTarget.evidence
+  were provided in the input, you MUST reference them here. Only leave empty if the input genuinely
+  contains no evidence at all.
+${constraints}${languageDirective}`;
+}
+// ── Prompt builder class ─────────────────────────────────────────────────────
+/**
+ * RootCausePromptBuilder — Stage A prompt builder for the split diagnostician pipeline.
+ *
+ * Transforms DiagnosticianContextPayload into a PromptBuildResult for the
+ * Root Cause stage (Stage A). The output prompt requires the LLM to produce
+ * JSON matching DiagRootCauseOutputV1Schema.
+ *
+ * Uses an opts-object pattern for all methods to satisfy @typescript-eslint/max-params.
+ *
+ * @see PRI-372
+ */
+export class RootCausePromptBuilder {
+    adapter;
+    schema;
+    constructor(opts = {}) {
+        this.adapter = opts.adapter ?? new DefaultSchemaPromptAdapter();
+        this.schema = opts.schema ?? DiagRootCauseOutputV1Schema;
+    }
+    /**
+     * Build the Stage A diagnostic protocol instruction.
+     *
+     * Contains PHASE 1 (evidence review), PHASE 2 (causal chain / 5-Whys),
+     * PHASE 3 (root cause classification), and optional PHASE 3.5 (core axiom
+     * grounding when coreGrounding=true).
+     *
+     * @see PRI-372
+     */
+    buildRootCauseInstruction(opts = {}) {
+        return buildRootCauseProtocolInstruction({
+            adapter: opts.adapter ?? this.adapter,
+            schema: opts.schema ?? this.schema,
+            outputLanguage: opts.outputLanguage,
+            coreGrounding: opts.coreGrounding,
+        });
+    }
+    /**
+     * Build the full prompt for Stage A.
+     *
+     * Transforms DiagnosticianContextPayload into a PromptBuildResult containing
+     * the JSON message to pass as the --message argument to the LLM agent.
+     *
+     * Per DPB-02: Output is ONLY JSON — no markdown, no file ops, no tool calls.
+     * Per DPB-05: This method only builds the prompt; it does NOT commit to PD database.
+     * Per DPB-07: NO extraSystemPrompt is added — agent profile is the source of truth.
+     *
+     * @see PRI-372
+     */
+    buildPrompt(payload, opts = {}) {
+        const limits = opts.limits ?? DEFAULT_PROMPT_BUILDER_LIMITS;
+        const { outputLanguage, coreGrounding } = opts;
+        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
+        const compactContext = {
+            ...payload,
+            conversationWindow,
+        };
+        const diagnosticInstruction = this.buildRootCauseInstruction({
+            outputLanguage,
+            coreGrounding,
+        });
+        // 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
+        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=rootcause-prompt-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rootcause-prompt-builder.js","sourceRoot":"","sources":["../../../src/runtime-v2/diagnostician/rootcause-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAGzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAKhF,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,oCAAoC,CAAC;AAuB5C,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAsC,EAAE;IAExC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,0BAA0B,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,2BAA2B,CAAC;IAC1D,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAE/C,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAEjE,+DAA+D;IAC/D,oEAAoE;IACpE,+BAA+B;IAC/B,MAAM,YAAY,GAAG,aAAa;QAChC,CAAC,CAAC;;;;;;;EAOJ,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;CAE/D;QACG,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BP,YAAY;;;EAGZ,OAAO;;;;;;;;;;;;;;EAcP,WAAW,GAAG,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAsB;IAC7B,MAAM,CAAU;IAEjC,YAAY,OAAsC,EAAE;QAClD,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;;;;;;;;OAQG;IACH,yBAAyB,CAAC,OAAsC,EAAE;QAChE,OAAO,iCAAiC,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAClC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CACT,OAAoC,EACpC,OAA2B,EAAE;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,6BAA6B,CAAC;QAC5D,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QAE/C,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,2EAA2E;QAC3E,MAAM,SAAS,GAAG,2BAA2B,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACxE,IAAI,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,sBAAsB,EAAE,CAAC;YACrD,kBAAkB,CAAC,IAAI,CACrB,qCAAqC,SAAS,CAAC,MAAM,OAAO,MAAM,CAAC,sBAAsB,UAAU,CACpG,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACrD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAC/D,OAAO;oBACL,GAAG,KAAK;oBACR,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,gBAAgB;iBACvE,CAAC;YACJ,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,4EAA4E;QAC5E,MAAM,cAAc,GAAgC;YAClD,GAAG,OAAO;YACV,kBAAkB;SACnB,CAAC;QAEF,MAAM,qBAAqB,GAAG,IAAI,CAAC,yBAAyB,CAAC;YAC3D,cAAc;YACd,aAAa;SACd,CAAC,CAAC;QAEH,wDAAwD;QACxD,MAAM,WAAW,GAAgB;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,kBAAkB;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,cAAc;YACvB,qBAAqB;YACrB,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;QAEF,wEAAwE;QACxE,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE1C,0EAA0E;QAC1E,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;YACxD,MAAM,WAAW,GAAG,qBAAqB,CAAC;YAE1C,gEAAgE;YAChE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC;YACrE,MAAM,oBAAoB,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;gBAC3D,qFAAqF,CAAC;YAExF,WAAW,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;YACzD,WAAW,CAAC,kBAAkB,GAAG;gBAC/B,GAAG,kBAAkB;gBACrB,gDAAgD,OAAO,CAAC,MAAM,MAAM,MAAM,CAAC,eAAe,GAAG;aAC9F,CAAC;YACF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,127 @@
+/**
+ * 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 type { TSchema } from '@sinclair/typebox';
+import type { SchemaPromptAdapter } from '../adapter/schema-prompt-adapter.js';
+import type { DiagRootCauseOutputV1 } from './diag-rootcause-output.js';
+import type { DiagDistillerOutputV1 } from './diag-distiller-output.js';
+import type { BuildPromptOptions } from '../diagnostician-prompt-builder.js';
+import type { OutputLanguage } from '../language-directive.js';
+/**
+ * Options for RouterPromptBuilder constructor and buildRouterInstruction().
+ *
+ * Uses opts-object pattern to stay within max-params limit and allow
+ * partial overrides at both construction and method-call time.
+ *
+ * @see PRI-372
+ */
+export interface RouterPromptBuilderOptions {
+    /** Schema prompt adapter (default: DefaultSchemaPromptAdapter) */
+    adapter?: SchemaPromptAdapter;
+    /** TypeBox schema for output validation (default: DiagnosticianOutputV1Schema) */
+    schema?: TSchema;
+    /** Output language directive (default: none) */
+    outputLanguage?: OutputLanguage;
+}
+/**
+ * Structured input for the Router stage, carrying both Stage A and Stage B
+ * artifacts with their IDs for lineage tracing.
+ *
+ * @see PRI-372
+ */
+export interface RouterContextInput {
+    /** Artifact ID of the Stage A (Root Cause) output */
+    rootCauseArtifactId: string;
+    /** Stage A output — the root cause analysis result */
+    rootCauseOutput: DiagRootCauseOutputV1;
+    /** Artifact ID of the Stage B (Distiller) output */
+    distillerArtifactId: string;
+    /** Stage B output — the distilled principle and grounding */
+    distillerOutput: DiagDistillerOutputV1;
+}
+/**
+ * Prompt input for the Router stage — the JSON message sent to the LLM.
+ *
+ * Unlike the monolithic DiagnosticianPromptBuilder's PromptInput, the router
+ * carries Stage A and Stage B artifacts directly rather than a full
+ * DiagnosticianContextPayload with conversation window and source refs.
+ *
+ * @see PRI-372
+ */
+export interface RouterPromptInput {
+    /** Task being diagnosed — from Stage A output */
+    taskId: string;
+    /** Artifact ID of the Stage A (Root Cause) output for lineage */
+    rootCauseArtifactId: string;
+    /** Stage A output — root cause analysis result */
+    rootCauseOutput: DiagRootCauseOutputV1;
+    /** Artifact ID of the Stage B (Distiller) output for lineage */
+    distillerArtifactId: string;
+    /** Stage B output — distilled principle and grounding */
+    distillerOutput: DiagDistillerOutputV1;
+    /** Router instruction — the system-level directive for the LLM */
+    routerInstruction: string;
+}
+/**
+ * Build result for the Router stage — follows the same pattern as PromptBuildResult.
+ *
+ * @see PRI-372
+ */
+export interface RouterPromptBuildResult {
+    /** JSON string — the exact value to pass as openclaw agent --message argument */
+    readonly message: string;
+    /** The RouterPromptInput object that was serialized to JSON */
+    readonly promptInput: RouterPromptInput;
+}
+/**
+ * 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 declare class RouterPromptBuilder {
+    private readonly adapter;
+    private readonly schema;
+    constructor(opts?: RouterPromptBuilderOptions);
+    /**
+     * 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?: RouterPromptBuilderOptions): string;
+    /**
+     * 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: RouterContextInput, opts?: BuildPromptOptions): RouterPromptBuildResult;
+}
+//# sourceMappingURL=router-prompt-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router-prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/diagnostician/router-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAID;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,eAAe,EAAE,qBAAqB,CAAC;IACvC,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,eAAe,EAAE,qBAAqB,CAAC;CACxC;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,eAAe,EAAE,qBAAqB,CAAC;IACvC,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,eAAe,EAAE,qBAAqB,CAAC;IACvC,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC;AAID;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,IAAI,GAAE,0BAA+B;IAKjD;;;;;;;;;;OAUG;IACH,sBAAsB,CAAC,IAAI,GAAE,0BAA+B,GAAG,MAAM;IA4DrE;;;;;;;;;OASG;IACH,WAAW,CACT,OAAO,EAAE,kBAAkB,EAC3B,IAAI,GAAE,kBAAuB,GAC5B,uBAAuB;CAkB3B"}