@principles/core 1.73.0

package/dist/runtime-v2/internalization/rule-host-contracts.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Rule Host Contracts — Execution contracts for hosted code implementations
+ *
+ * PURPOSE: Define the constrained interface through which active code
+ * implementations are executed. Implementations receive a frozen snapshot
+ * of context and return one of four decisions.
+ *
+ * TRUST BOUNDARY:
+ *   - RuleHostInput is a frozen snapshot — no live workspace handles
+ *   - Implementations execute in a constrained vm context with minimal helpers
+ *   - No filesystem, process, require, dynamic import, eval, or network access
+ */
+import type { CorrectionProposal } from './correction-proposal.js';
+export interface RuleHostInput {
+    action: {
+        toolName: string;
+        normalizedPath: string | null;
+        paramsSummary: Record<string, unknown>;
+    };
+    workspace: {
+        isRiskPath: boolean;
+        planStatus: 'NONE' | 'DRAFT' | 'READY' | 'UNKNOWN';
+        hasPlanFile: boolean;
+    };
+    session: {
+        sessionId?: string;
+        currentGfi: number;
+        recentThinking: boolean;
+    };
+    evolution: {
+        epTier: number;
+    };
+    derived: {
+        estimatedLineChanges: number;
+        bashRisk: 'safe' | 'normal' | 'dangerous' | 'unknown';
+    };
+}
+export type RuleHostDecision = 'allow' | 'block' | 'requireApproval' | 'auto_correct';
+export interface RuleHostMeta {
+    name: string;
+    version: string;
+    ruleId: string;
+    coversCondition: string;
+}
+export interface RuleHostResult {
+    decision: RuleHostDecision;
+    matched: boolean;
+    reason: string;
+    diagnostics?: Record<string, unknown>;
+    ruleId?: string;
+    principleId?: string;
+    /** Present when decision is 'auto_correct'. Must pass validateCorrectionProposal(). */
+    correctionProposal?: CorrectionProposal;
+}
+export interface LoadedImplementation {
+    implId: string;
+    ruleId: string;
+    meta: RuleHostMeta;
+    evaluate: (_input: RuleHostInput) => RuleHostResult;
+}
+//# sourceMappingURL=rule-host-contracts.d.ts.map

package/dist/runtime-v2/internalization/rule-host-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-host-contracts.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/rule-host-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;QACnD,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE;QACP,oBAAoB,EAAE,MAAM,CAAC;QAC7B,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;KACvD,CAAC;CACH;AAMD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAMtF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAMD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,cAAc,CAAC;CACrD"}

package/dist/runtime-v2/internalization/rule-host-contracts.js

@@ -0,0 +1,14 @@
+/**
+ * Rule Host Contracts — Execution contracts for hosted code implementations
+ *
+ * PURPOSE: Define the constrained interface through which active code
+ * implementations are executed. Implementations receive a frozen snapshot
+ * of context and return one of four decisions.
+ *
+ * TRUST BOUNDARY:
+ *   - RuleHostInput is a frozen snapshot — no live workspace handles
+ *   - Implementations execute in a constrained vm context with minimal helpers
+ *   - No filesystem, process, require, dynamic import, eval, or network access
+ */
+export {};
+//# sourceMappingURL=rule-host-contracts.js.map

package/dist/runtime-v2/internalization/rule-host-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-host-contracts.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/rule-host-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/runtime-v2/internalization/rule-host-evaluator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Rule Host Evaluator �?Pure decision merge logic
+ *
+ * PURPOSE: Iterate loaded code implementations and merge their decisions.
+ * Block short-circuits, auto_correct collects (validated), requireApproval
+ * collects, allow is implicit.
+ *
+ * Precedence: block > auto_correct > requireApproval > allow
+ *
+ * PRI-45: Pure function extracted from the plugin's RuleHost.evaluate().
+ * PRI-114: Added auto_correct handling with fail-closed validation.
+ * No filesystem, no VM, no side effects.
+ */
+import type { RuleHostInput, RuleHostResult, LoadedImplementation } from './rule-host-contracts.js';
+export interface DecisionMergeLogger {
+    warn?: (_message: string) => void;
+}
+/**
+ * Alias for consumers that prefer the RuleHost naming convention.
+ * @deprecated Use DecisionMergeLogger instead.
+ */
+export type RuleHostLogger = DecisionMergeLogger;
+/**
+ * Merge decisions from multiple loaded implementations.
+ *
+ * Rules:
+ *   - If any implementation returns `block`, short-circuit and return block.
+ *   - `auto_correct` proposals are collected and validated.
+ *     First valid proposal wins. Invalid proposals are logged and skipped.
+ *   - Collect all `requireApproval` results and merge their reasons/diagnostics.
+ *   - `allow` results are ignored (no opinion).
+ *   - Individual implementation errors are logged and skipped.
+ *   - Outer errors return undefined (conservative degradation D-08).
+ */
+export declare function mergeDecisions(implementations: readonly LoadedImplementation[], input: RuleHostInput, logger?: DecisionMergeLogger): RuleHostResult | undefined;
+//# sourceMappingURL=rule-host-evaluator.d.ts.map

package/dist/runtime-v2/internalization/rule-host-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-host-evaluator.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/rule-host-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,SAAS,oBAAoB,EAAE,EAChD,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,mBAAmB,GAC3B,cAAc,GAAG,SAAS,CA6F5B"}

package/dist/runtime-v2/internalization/rule-host-evaluator.js

@@ -0,0 +1,103 @@
+/**
+ * Rule Host Evaluator �?Pure decision merge logic
+ *
+ * PURPOSE: Iterate loaded code implementations and merge their decisions.
+ * Block short-circuits, auto_correct collects (validated), requireApproval
+ * collects, allow is implicit.
+ *
+ * Precedence: block > auto_correct > requireApproval > allow
+ *
+ * PRI-45: Pure function extracted from the plugin's RuleHost.evaluate().
+ * PRI-114: Added auto_correct handling with fail-closed validation.
+ * No filesystem, no VM, no side effects.
+ */
+import { validateCorrectionProposal } from './correction-proposal.js';
+/**
+ * Merge decisions from multiple loaded implementations.
+ *
+ * Rules:
+ *   - If any implementation returns `block`, short-circuit and return block.
+ *   - `auto_correct` proposals are collected and validated.
+ *     First valid proposal wins. Invalid proposals are logged and skipped.
+ *   - Collect all `requireApproval` results and merge their reasons/diagnostics.
+ *   - `allow` results are ignored (no opinion).
+ *   - Individual implementation errors are logged and skipped.
+ *   - Outer errors return undefined (conservative degradation D-08).
+ */
+export function mergeDecisions(implementations, input, logger) {
+    if (!implementations || implementations.length === 0) {
+        return undefined;
+    }
+    try {
+        let blocked = undefined;
+        const autoCorrects = [];
+        const approvals = [];
+        for (const impl of implementations) {
+            try {
+                const result = impl.evaluate(input);
+                if (!result.matched) {
+                    continue;
+                }
+                if (result.decision === 'block') {
+                    blocked = result;
+                    break;
+                }
+                if (result.decision === 'auto_correct') {
+                    autoCorrects.push(result);
+                }
+                else if (result.decision === 'requireApproval') {
+                    approvals.push(result);
+                }
+                // 'allow' is implicit �?no action needed
+            }
+            catch (evalError) {
+                logger?.warn?.(`[RuleHost] Implementation ${impl.implId} evaluation failed: ${String(evalError)}`);
+            }
+        }
+        if (blocked) {
+            return blocked;
+        }
+        // auto_correct takes precedence over requireApproval
+        if (autoCorrects.length > 0) {
+            for (const ac of autoCorrects) {
+                if (ac.correctionProposal) {
+                    try {
+                        const validation = validateCorrectionProposal(ac.correctionProposal);
+                        if (validation.valid) {
+                            return ac;
+                        }
+                        logger?.warn?.(`[RuleHost] auto_correct proposal from ${ac.ruleId ?? 'unknown'} failed validation: ${validation.errors.join('; ')}`);
+                    }
+                    catch (validationError) {
+                        logger?.warn?.(`[RuleHost] auto_correct proposal from ${ac.ruleId ?? 'unknown'} threw during validation (fail-closed): ${String(validationError)}`);
+                    }
+                }
+                else {
+                    logger?.warn?.(`[RuleHost] auto_correct decision from ${ac.ruleId ?? 'unknown'} missing correctionProposal`);
+                }
+            }
+            // All auto_correct proposals invalid �?fall through to requireApproval
+        }
+        if (approvals.length > 0) {
+            return {
+                decision: 'requireApproval',
+                matched: true,
+                reason: approvals.map((a) => a.reason).join('; '),
+                diagnostics: approvals.reduce((acc, a, i) => {
+                    const prefix = a.ruleId ?? `approval_${i}`;
+                    const entries = Object.entries(a.diagnostics ?? {});
+                    for (const [k, v] of entries) {
+                        acc[`${prefix}_${k}`] = v;
+                    }
+                    return acc;
+                }, {}),
+            };
+        }
+        return undefined;
+    }
+    catch (hostError) {
+        logger?.warn?.(`[RuleHost] Host evaluation failed, degrading conservatively: ${String(hostError)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=rule-host-evaluator.js.map

package/dist/runtime-v2/internalization/rule-host-evaluator.js.map

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

package/dist/runtime-v2/internalization/rule-host-helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Rule Host Helpers — Minimal whitelisted helper surface for hosted implementations
+ *
+ * PURPOSE: Provide a constrained set of pure functions that hosted implementations
+ * can call. All values are pre-computed from the frozen RuleHostInput snapshot.
+ *
+ * SECURITY:
+ *   - Helpers are a frozen object — cannot be modified by implementations
+ *   - No filesystem, process, require, dynamic import, eval, Function, or network access
+ *   - All functions are pure — no side effects, no external state access
+ */
+import type { RuleHostInput } from './rule-host-contracts.js';
+export interface RuleHostHelpers {
+    isRiskPath(): boolean;
+    getToolName(): string;
+    getEstimatedLineChanges(): number;
+    getBashRisk(): 'safe' | 'normal' | 'dangerous' | 'unknown';
+    hasPlanFile(): boolean;
+    getPlanStatus(): 'NONE' | 'DRAFT' | 'READY' | 'UNKNOWN';
+    getEpTier(): number;
+}
+/**
+ * Create a frozen helper object from the pre-computed input snapshot.
+ * Implementations receive this via the vm context — they cannot modify it.
+ */
+export declare function createRuleHostHelpers(input: RuleHostInput): RuleHostHelpers;
+//# sourceMappingURL=rule-host-helpers.d.ts.map

package/dist/runtime-v2/internalization/rule-host-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-host-helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/rule-host-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,UAAU,IAAI,OAAO,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,uBAAuB,IAAI,MAAM,CAAC;IAClC,WAAW,IAAI,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3D,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAU3E"}

package/dist/runtime-v2/internalization/rule-host-helpers.js

@@ -0,0 +1,27 @@
+/**
+ * Rule Host Helpers — Minimal whitelisted helper surface for hosted implementations
+ *
+ * PURPOSE: Provide a constrained set of pure functions that hosted implementations
+ * can call. All values are pre-computed from the frozen RuleHostInput snapshot.
+ *
+ * SECURITY:
+ *   - Helpers are a frozen object — cannot be modified by implementations
+ *   - No filesystem, process, require, dynamic import, eval, Function, or network access
+ *   - All functions are pure — no side effects, no external state access
+ */
+/**
+ * Create a frozen helper object from the pre-computed input snapshot.
+ * Implementations receive this via the vm context — they cannot modify it.
+ */
+export function createRuleHostHelpers(input) {
+    return Object.freeze({
+        isRiskPath: () => input.workspace.isRiskPath,
+        getToolName: () => input.action.toolName,
+        getEstimatedLineChanges: () => input.derived.estimatedLineChanges,
+        getBashRisk: () => input.derived.bashRisk,
+        hasPlanFile: () => input.workspace.hasPlanFile,
+        getPlanStatus: () => input.workspace.planStatus,
+        getEpTier: () => input.evolution.epTier,
+    });
+}
+//# sourceMappingURL=rule-host-helpers.js.map

package/dist/runtime-v2/internalization/rule-host-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-host-helpers.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/rule-host-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU;QAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ;QACxC,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB;QACjE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ;QACzC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW;QAC9C,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU;QAC/C,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime-v2/internalization/scribe-output.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ScribeOutputV1 — Output schema for the Scribe peer runner.
+ *
+ * The Scribe reads a Philosopher artifact and produces a formal principle
+ * draft with statement, rationale, applicability, and anti-patterns.
+ * This is the third stage in the internalization pipeline
+ * (Dreamer → Philosopher → Scribe → Artificer).
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ */
+import { type Static } from '@sinclair/typebox';
+export interface ScribePrincipleDraft {
+    readonly title: string;
+    readonly statement: string;
+    readonly rationale: string;
+    readonly applicability: readonly string[];
+    readonly antiPatterns: readonly string[];
+    readonly confidence: number;
+}
+export interface ScribeSourceTrace {
+    readonly dreamerArtifactId?: string;
+    readonly philosopherArtifactId: string;
+}
+export interface ScribeOutputV1 {
+    readonly taskId: string;
+    readonly sourcePhilosopherArtifactId: string;
+    readonly principleDraft: ScribePrincipleDraft;
+    readonly sourceTrace: ScribeSourceTrace;
+    readonly risks: readonly string[];
+    readonly generatedAt: string;
+}
+export declare const ScribePrincipleDraftSchema: import("@sinclair/typebox").TObject<{
+    title: import("@sinclair/typebox").TString;
+    statement: import("@sinclair/typebox").TString;
+    rationale: import("@sinclair/typebox").TString;
+    applicability: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    antiPatterns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    confidence: import("@sinclair/typebox").TNumber;
+}>;
+export declare const ScribeSourceTraceSchema: import("@sinclair/typebox").TObject<{
+    dreamerArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    philosopherArtifactId: import("@sinclair/typebox").TString;
+}>;
+export declare const ScribeOutputV1Schema: import("@sinclair/typebox").TObject<{
+    taskId: import("@sinclair/typebox").TString;
+    sourcePhilosopherArtifactId: import("@sinclair/typebox").TString;
+    principleDraft: import("@sinclair/typebox").TObject<{
+        title: import("@sinclair/typebox").TString;
+        statement: import("@sinclair/typebox").TString;
+        rationale: import("@sinclair/typebox").TString;
+        applicability: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        antiPatterns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        confidence: import("@sinclair/typebox").TNumber;
+    }>;
+    sourceTrace: import("@sinclair/typebox").TObject<{
+        dreamerArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        philosopherArtifactId: import("@sinclair/typebox").TString;
+    }>;
+    risks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    generatedAt: import("@sinclair/typebox").TString;
+}>;
+export type ScribeOutputV1TB = Static<typeof ScribeOutputV1Schema>;
+export interface ScribeValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly errorCategory?: string;
+}
+export interface ScribeValidator {
+    validate(output: ScribeOutputV1, taskId: string, expectedSourcePhilosopherArtifactId?: string): Promise<ScribeValidationResult>;
+}
+export declare class DefaultScribeValidator implements ScribeValidator {
+    validate(output: ScribeOutputV1, taskId: string, expectedSourcePhilosopherArtifactId?: string): Promise<ScribeValidationResult>;
+}
+//# sourceMappingURL=scribe-output.d.ts.map

package/dist/runtime-v2/internalization/scribe-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scribe-output.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/scribe-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;EAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mCAAmC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACjI;AAED,qBAAa,sBAAuB,YAAW,eAAe;IAEtD,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mCAAmC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAyDtI"}

package/dist/runtime-v2/internalization/scribe-output.js

@@ -0,0 +1,98 @@
+/**
+ * ScribeOutputV1 — Output schema for the Scribe peer runner.
+ *
+ * The Scribe reads a Philosopher artifact and produces a formal principle
+ * draft with statement, rationale, applicability, and anti-patterns.
+ * This is the third stage in the internalization pipeline
+ * (Dreamer → Philosopher → Scribe → Artificer).
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ */
+import { Type } from '@sinclair/typebox';
+export const ScribePrincipleDraftSchema = Type.Object({
+    title: Type.String({ minLength: 1 }),
+    statement: Type.String({ minLength: 1 }),
+    rationale: Type.String({ minLength: 1 }),
+    applicability: Type.Array(Type.String()),
+    antiPatterns: Type.Array(Type.String()),
+    confidence: Type.Number({ minimum: 0, maximum: 1 }),
+});
+export const ScribeSourceTraceSchema = Type.Object({
+    dreamerArtifactId: Type.Optional(Type.String()),
+    philosopherArtifactId: Type.String({ minLength: 1 }),
+});
+export const ScribeOutputV1Schema = Type.Object({
+    taskId: Type.String({ minLength: 1 }),
+    sourcePhilosopherArtifactId: Type.String({ minLength: 1 }),
+    principleDraft: ScribePrincipleDraftSchema,
+    sourceTrace: ScribeSourceTraceSchema,
+    risks: Type.Array(Type.String()),
+    generatedAt: Type.String({ minLength: 1 }),
+});
+export class DefaultScribeValidator {
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    async validate(output, taskId, expectedSourcePhilosopherArtifactId) {
+        const errors = [];
+        if (typeof output !== 'object' || output === null) {
+            return { valid: false, errors: ['Output is not an object'], errorCategory: 'output_invalid' };
+        }
+        if (output.taskId !== taskId) {
+            errors.push(`taskId mismatch: expected ${taskId}, got ${String(output.taskId)}`);
+        }
+        if (typeof output.sourcePhilosopherArtifactId !== 'string' || output.sourcePhilosopherArtifactId.trim() === '') {
+            errors.push('sourcePhilosopherArtifactId must be non-empty string');
+        }
+        else if (expectedSourcePhilosopherArtifactId && output.sourcePhilosopherArtifactId !== expectedSourcePhilosopherArtifactId) {
+            errors.push(`sourcePhilosopherArtifactId mismatch: expected ${expectedSourcePhilosopherArtifactId}, got ${output.sourcePhilosopherArtifactId}`);
+        }
+        if (typeof output.principleDraft !== 'object' || output.principleDraft === null) {
+            errors.push('principleDraft must be an object');
+        }
+        else {
+            const pd = output.principleDraft;
+            if (typeof pd.title !== 'string' || (pd.title).trim() === '')
+                errors.push('principleDraft.title must be non-empty string');
+            if (typeof pd.statement !== 'string' || (pd.statement).trim() === '')
+                errors.push('principleDraft.statement must be non-empty string');
+            if (typeof pd.rationale !== 'string' || (pd.rationale).trim() === '')
+                errors.push('principleDraft.rationale must be non-empty string');
+            if (!Array.isArray(pd.applicability))
+                errors.push('principleDraft.applicability must be an array');
+            else if (!pd.applicability.every(e => typeof e === 'string'))
+                errors.push('principleDraft.applicability must be an array of strings');
+            if (!Array.isArray(pd.antiPatterns))
+                errors.push('principleDraft.antiPatterns must be an array');
+            else if (!pd.antiPatterns.every(e => typeof e === 'string'))
+                errors.push('principleDraft.antiPatterns must be an array of strings');
+            if (typeof pd.confidence !== 'number')
+                errors.push('principleDraft.confidence must be number');
+            else if (pd.confidence < 0 || pd.confidence > 1)
+                errors.push('principleDraft.confidence must be in [0, 1]');
+        }
+        if (typeof output.sourceTrace !== 'object' || output.sourceTrace === null) {
+            errors.push('sourceTrace must be an object');
+        }
+        else {
+            const st = output.sourceTrace;
+            if (typeof st.philosopherArtifactId !== 'string' || (st.philosopherArtifactId).trim() === '') {
+                errors.push('sourceTrace.philosopherArtifactId must be non-empty string');
+            }
+            else if (expectedSourcePhilosopherArtifactId && st.philosopherArtifactId !== expectedSourcePhilosopherArtifactId) {
+                errors.push(`sourceTrace.philosopherArtifactId mismatch: expected ${expectedSourcePhilosopherArtifactId}, got ${st.philosopherArtifactId}`);
+            }
+        }
+        if (!Array.isArray(output.risks)) {
+            errors.push('risks must be an array');
+        }
+        else if (!output.risks.every(e => typeof e === 'string')) {
+            errors.push('risks must be an array of strings');
+        }
+        if (typeof output.generatedAt !== 'string' || output.generatedAt.trim() === '') {
+            errors.push('generatedAt must be non-empty string');
+        }
+        return errors.length > 0
+            ? { valid: false, errors, errorCategory: 'output_invalid' }
+            : { valid: true, errors: [] };
+    }
+}
+//# sourceMappingURL=scribe-output.js.map

package/dist/runtime-v2/internalization/scribe-output.js.map

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

package/dist/runtime-v2/internalization/scribe-prompt-builder.d.ts

@@ -0,0 +1,24 @@
+export interface ScribePromptBuilderInput {
+    taskId: string;
+    contextHash: string;
+    sourcePhilosopherArtifactId: string;
+    philosopherArtifact: unknown;
+}
+export interface ScribePromptInput {
+    taskId: string;
+    contextHash: string;
+    sourcePhilosopherArtifactId: string;
+    philosopherArtifact: unknown;
+    scribeInstruction: string;
+    promptContractVersion: string;
+}
+export interface ScribePromptBuildResult {
+    readonly message: string;
+    readonly promptInput: ScribePromptInput;
+}
+export declare const SCRIBE_PROTOCOL_INSTRUCTION = "You are a Scribe agent in a principle internalization pipeline. Your role is to distill the Philosopher's analysis into a formal, implementable principle draft.\n\nPROTOCOL:\n1. Review the philosopherArtifact to understand the philosophical thesis and principle candidate\n2. Transform the philosopher's analysis into a formal principle draft with clear statement, rationale, applicability, and anti-patterns\n3. Preserve the lineage trace from dreamer and philosopher artifacts\n4. Identify risks associated with applying this principle\n5. The principle draft should be concrete enough to guide implementation, not just philosophical\n\nOUTPUT FORMAT (pure JSON, no markdown):\n{\n  \"taskId\": \"<from input>\",\n  \"sourcePhilosopherArtifactId\": \"<copy exactly from input.sourcePhilosopherArtifactId>\",\n  \"principleDraft\": {\n    \"title\": \"<concise principle title, <=100 chars>\",\n    \"statement\": \"<formal principle statement describing what should always be done>\",\n    \"rationale\": \"<why this principle addresses the root cause>\",\n    \"applicability\": [\"<context where this principle applies>\"],\n    \"antiPatterns\": [\"<pattern this principle forbids>\"],\n    \"confidence\": 0.8\n  },\n  \"sourceTrace\": {\n    \"dreamerArtifactId\": \"<from philosopher artifact if available, or omit>\",\n    \"philosopherArtifactId\": \"<copy exactly from input.sourcePhilosopherArtifactId>\"\n  },\n  \"risks\": [\"<risk 1>\", \"<risk 2>\"],\n  \"generatedAt\": \"<ISO-8601 timestamp>\"\n}\n\nCONSTRAINTS:\n- Output ONLY valid JSON (no markdown, no explanatory text, no code fences)\n- principleDraft.title MUST be a non-empty string (concise, <=100 chars)\n- principleDraft.statement MUST be a non-empty string describing the principle\n- principleDraft.rationale MUST be a non-empty string\n- principleDraft.applicability MUST be an array of strings (at least one recommended)\n- principleDraft.antiPatterns MUST be an array of strings (can be empty)\n- principleDraft.confidence MUST be a number between 0.0 and 1.0 (NOT a string, NOT a percentage)\n- sourcePhilosopherArtifactId MUST be copied exactly from input.sourcePhilosopherArtifactId (non-empty string)\n- sourceTrace.philosopherArtifactId MUST be copied exactly from input.sourcePhilosopherArtifactId\n- sourceTrace.dreamerArtifactId is optional \u2014 include only if available from philosopher artifact\n- risks MUST be an array of strings (can be empty if no risks identified)\n- generatedAt MUST be an ISO-8601 timestamp string\n";
+export declare const SCRIBE_PROMPT_CONTRACT_VERSION = "scribe-output-v1.prompt.v1";
+export declare class ScribePromptBuilder {
+    buildPrompt(input: ScribePromptBuilderInput): ScribePromptBuildResult;
+}
+//# sourceMappingURL=scribe-prompt-builder.d.ts.map

package/dist/runtime-v2/internalization/scribe-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scribe-prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/scribe-prompt-builder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B,EAAE,MAAM,CAAC;IACpC,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B,EAAE,MAAM,CAAC;IACpC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC;AAED,eAAO,MAAM,2BAA2B,69EA0CvC,CAAC;AAEF,eAAO,MAAM,8BAA8B,+BAA+B,CAAC;AAE3E,qBAAa,mBAAmB;IAE9B,WAAW,CAAC,KAAK,EAAE,wBAAwB,GAAG,uBAAuB;CActE"}

package/dist/runtime-v2/internalization/scribe-prompt-builder.js

@@ -0,0 +1,60 @@
+export const SCRIBE_PROTOCOL_INSTRUCTION = `You are a Scribe agent in a principle internalization pipeline. Your role is to distill the Philosopher's analysis into a formal, implementable principle draft.
+
+PROTOCOL:
+1. Review the philosopherArtifact to understand the philosophical thesis and principle candidate
+2. Transform the philosopher's analysis into a formal principle draft with clear statement, rationale, applicability, and anti-patterns
+3. Preserve the lineage trace from dreamer and philosopher artifacts
+4. Identify risks associated with applying this principle
+5. The principle draft should be concrete enough to guide implementation, not just philosophical
+
+OUTPUT FORMAT (pure JSON, no markdown):
+{
+  "taskId": "<from input>",
+  "sourcePhilosopherArtifactId": "<copy exactly from input.sourcePhilosopherArtifactId>",
+  "principleDraft": {
+    "title": "<concise principle title, <=100 chars>",
+    "statement": "<formal principle statement describing what should always be done>",
+    "rationale": "<why this principle addresses the root cause>",
+    "applicability": ["<context where this principle applies>"],
+    "antiPatterns": ["<pattern this principle forbids>"],
+    "confidence": 0.8
+  },
+  "sourceTrace": {
+    "dreamerArtifactId": "<from philosopher artifact if available, or omit>",
+    "philosopherArtifactId": "<copy exactly from input.sourcePhilosopherArtifactId>"
+  },
+  "risks": ["<risk 1>", "<risk 2>"],
+  "generatedAt": "<ISO-8601 timestamp>"
+}
+
+CONSTRAINTS:
+- Output ONLY valid JSON (no markdown, no explanatory text, no code fences)
+- principleDraft.title MUST be a non-empty string (concise, <=100 chars)
+- principleDraft.statement MUST be a non-empty string describing the principle
+- principleDraft.rationale MUST be a non-empty string
+- principleDraft.applicability MUST be an array of strings (at least one recommended)
+- principleDraft.antiPatterns MUST be an array of strings (can be empty)
+- principleDraft.confidence MUST be a number between 0.0 and 1.0 (NOT a string, NOT a percentage)
+- sourcePhilosopherArtifactId MUST be copied exactly from input.sourcePhilosopherArtifactId (non-empty string)
+- sourceTrace.philosopherArtifactId MUST be copied exactly from input.sourcePhilosopherArtifactId
+- sourceTrace.dreamerArtifactId is optional — include only if available from philosopher artifact
+- risks MUST be an array of strings (can be empty if no risks identified)
+- generatedAt MUST be an ISO-8601 timestamp string
+`;
+export const SCRIBE_PROMPT_CONTRACT_VERSION = 'scribe-output-v1.prompt.v1';
+export class ScribePromptBuilder {
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    buildPrompt(input) {
+        const promptInput = {
+            taskId: input.taskId,
+            contextHash: input.contextHash,
+            sourcePhilosopherArtifactId: input.sourcePhilosopherArtifactId,
+            philosopherArtifact: input.philosopherArtifact,
+            scribeInstruction: SCRIBE_PROTOCOL_INSTRUCTION,
+            promptContractVersion: SCRIBE_PROMPT_CONTRACT_VERSION,
+        };
+        const message = JSON.stringify(promptInput);
+        return { message, promptInput };
+    }
+}
+//# sourceMappingURL=scribe-prompt-builder.js.map

package/dist/runtime-v2/internalization/scribe-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scribe-prompt-builder.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/scribe-prompt-builder.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C1C,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAE3E,MAAM,OAAO,mBAAmB;IAC9B,qEAAqE;IACrE,WAAW,CAAC,KAA+B;QACzC,MAAM,WAAW,GAAsB;YACrC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;YAC9D,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;YAC9C,iBAAiB,EAAE,2BAA2B;YAC9C,qBAAqB,EAAE,8BAA8B;SACtD,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}