@principles/core 1.73.0

package/dist/runtime-v2/internalization/internalization-orchestrator.d.ts

@@ -0,0 +1,182 @@
+/**
+ * InternalizationOrchestrator — Core-owned Skeleton (PRI-68)
+ *
+ * Consumes hydrated PITaskRecords, applies state-machine decisions,
+ * acquires leases through RuntimeStateManager, and proposes successor
+ * tasks — WITHOUT executing LLM calls or calling peer runners.
+ *
+ * Design:
+ *   - Single-step processing: wakeOnce() handles one task per call
+ *   - Host (plugin CLI or heartbeat trigger) decides when to call
+ *   - All task mutation goes through RuntimeStateManager (not direct store)
+ *   - Pure orchestration: no timers, no LLM calls, no peer runner imports
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ */
+import type { PDTaskStatus } from '../task-status.js';
+import type { RuntimeStateManager } from '../store/runtime-state-manager.js';
+import type { PeerRunnerKind } from './peer-runner-contracts.js';
+import type { DependencyGateResult, NextTaskProposal } from './internalization-state-machine.js';
+export interface NoReadyTasksResult {
+    decision: 'no_ready_tasks';
+    inspectedCount: number;
+    /** Why no task could be leased: specific diagnosis */
+    reason: 'no_candidates' | 'filtered_out' | 'all_hydration_failed' | 'all_blocked' | 'all_dependency_failed' | 'all_lease_conflict' | 'all_retry_wait_pending';
+}
+export interface BlockedResult {
+    decision: 'blocked';
+    taskId: string;
+    taskKind: PeerRunnerKind;
+    blockedBy: string[];
+}
+export interface DependencyFailedResult {
+    decision: 'dependency_failed';
+    taskId: string;
+    taskKind: PeerRunnerKind;
+    failedDependencies: string[];
+}
+export interface LeasedResult {
+    decision: 'leased';
+    taskId: string;
+    taskKind: PeerRunnerKind;
+    attemptCount: number;
+}
+export interface WouldLeaseResult {
+    decision: 'would_lease';
+    taskId: string;
+    taskKind: PeerRunnerKind;
+    gateResult: DependencyGateResult;
+}
+export interface LeaseConflictResult {
+    decision: 'lease_conflict';
+    taskId: string;
+    conflictReason: string;
+}
+export interface InvalidTaskMetadataResult {
+    decision: 'invalid_task_metadata';
+    taskId: string;
+    taskKind: string;
+}
+/**
+ * Runtime decision labels for WakeOnceResult — used by host layers for
+ * logging, metrics bucketing, and switch-statement exhaustiveness checks.
+ * @experimental — consumed at runtime only; not used by the TypeScript
+ * type system (discriminated union handles compile-time exhaustiveness).
+ */
+export declare const WAKE_ONCE_DECISIONS: readonly ["no_ready_tasks", "blocked", "dependency_failed", "leased", "would_lease", "lease_conflict", "invalid_task_metadata"];
+export type WakeOnceResult = NoReadyTasksResult | BlockedResult | DependencyFailedResult | LeasedResult | WouldLeaseResult | LeaseConflictResult | InvalidTaskMetadataResult;
+export interface ProposalCreatedResult {
+    decision: 'proposal_created';
+    taskId: string;
+    taskKind: PeerRunnerKind;
+    proposal: NextTaskProposal;
+}
+export type ProposeNextTaskResult = ProposalCreatedResult | null;
+export type CommitNextTaskResult = {
+    decision: 'successor_created';
+    sourceTaskId: string;
+    successorTaskId: string;
+    successorKind: PeerRunnerKind;
+} | {
+    decision: 'successor_exists';
+    sourceTaskId: string;
+    successorTaskId: string;
+    successorKind: PeerRunnerKind;
+} | {
+    decision: 'no_successor';
+    sourceTaskId: string;
+    reason: string;
+} | {
+    decision: 'invalid_task_metadata';
+    taskId: string;
+    reason: string;
+} | {
+    decision: 'source_not_succeeded';
+    taskId: string;
+    status: PDTaskStatus;
+} | {
+    decision: 'task_not_found';
+    taskId: string;
+};
+export interface InternalizationOrchestratorOptions {
+    /** Lease owner identifier (injected by host) */
+    owner: string;
+    /** Runtime kind for lease records */
+    runtimeKind: string;
+    /** If true, evaluate but do NOT acquire lease (inspection / dry-run mode) */
+    dryRun?: boolean;
+}
+export interface InternalizationOrchestratorDeps {
+    readonly stateManager: RuntimeStateManager;
+}
+export declare class InternalizationOrchestrator {
+    private readonly owner;
+    private readonly runtimeKind;
+    private readonly dryRun;
+    private readonly stateManager;
+    constructor(deps: InternalizationOrchestratorDeps, options: InternalizationOrchestratorOptions);
+    /**
+     * Find the first leasable PI task, validate dependencies, and acquire lease
+     * (or return a structured decision without mutating state).
+     *
+     * Algorithm:
+     *   1. listTasks(pending) → filter PeerRunnerKind → hydrate
+     *   2. If none, try listTasks(retry_wait) for recovery candidates
+     *   3. For first valid PITaskRecord, resolve dependencyTaskIds via getTask
+     *   4. validateInternalizationTaskReady → branch on gate result
+     *   5. On proceed + dryRun → would_lease; on proceed + !dryRun → acquireLease
+     *   6. On lease_conflict PDRuntimeError → structured LeaseConflictResult
+     */
+    wakeOnce(taskKind?: PeerRunnerKind): Promise<WakeOnceResult>;
+    /**
+     * Generate a successor task proposal for a succeeded task.
+     *
+     * Does NOT create the task — the caller decides whether to persist
+     * the proposal via RuntimeStateManager.createTask().
+     *
+     * Note: existingTasks is hardcoded to [] — the host layer is responsible
+     * for deduplicating proposals against tasks already in the queue before
+     * calling createTask().
+     *
+     * Returns null if:
+     *   - Task not found
+     *   - Task not a valid PITaskRecord (hydration fails)
+     *   - Task status is not 'succeeded'
+     *   - No valid successor exists in the job graph
+     */
+    proposeNextTask(taskId: string): Promise<ProposeNextTaskResult>;
+    /**
+     * Commit a successor task proposal for a succeeded source task.
+     *
+     * Idempotent: if a matching successor already exists (same parentTaskId +
+     * successorKind + channel), returns successor_exists without creating a duplicate.
+     *
+     * Steps:
+     *   1. getTask(taskId) → null → task_not_found
+     *   2. hydratePITaskRecord(task) → null → invalid_task_metadata
+     *   3. task.status !== 'succeeded' → source_not_succeeded
+     *   4. proposeNextTask(taskId) → null → no_successor
+     *   5. Deduplicate: scan pending tasks for matching successor
+     *   6. Found → successor_exists
+     *   7. Not found → createTask + write PI metadata → successor_created
+     */
+    commitNextTaskProposal(taskId: string): Promise<CommitNextTaskResult>;
+    /**
+     * Find an existing successor task matching parentTaskId + successorKind + channel.
+     * Scans pending tasks and hydrates to check PI metadata.
+     * Returns the matching TaskRecord or null.
+     */
+    private findExistingSuccessor;
+    /**
+     * Find candidate PI tasks by querying pending and retry_wait statuses.
+     * Filters to only PeerRunnerKind taskKinds and hydrates to PITaskRecord.
+     */
+    private findCandidates;
+    /**
+     * Resolve an array of dependency task IDs into TaskRecord instances.
+     * Missing tasks (not yet created) are excluded from the result — this
+     * causes validateInternalizationTaskReady to fail closed (treat as blocked).
+     */
+    private resolveDependencies;
+}
+//# sourceMappingURL=internalization-orchestrator.d.ts.map

package/dist/runtime-v2/internalization/internalization-orchestrator.d.ts.map

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

package/dist/runtime-v2/internalization/internalization-orchestrator.js

@@ -0,0 +1,355 @@
+/**
+ * InternalizationOrchestrator — Core-owned Skeleton (PRI-68)
+ *
+ * Consumes hydrated PITaskRecords, applies state-machine decisions,
+ * acquires leases through RuntimeStateManager, and proposes successor
+ * tasks — WITHOUT executing LLM calls or calling peer runners.
+ *
+ * Design:
+ *   - Single-step processing: wakeOnce() handles one task per call
+ *   - Host (plugin CLI or heartbeat trigger) decides when to call
+ *   - All task mutation goes through RuntimeStateManager (not direct store)
+ *   - Pure orchestration: no timers, no LLM calls, no peer runner imports
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ */
+import { hydratePITaskRecord, createPITaskDiagnosticJson } from './pitask-metadata.js';
+import { isPeerRunnerKind } from './peer-runner-contracts.js';
+import { validateInternalizationTaskReady, createNextTaskProposal, } from './internalization-state-machine.js';
+import { PDRuntimeError } from '../error-categories.js';
+/**
+ * Runtime decision labels for WakeOnceResult — used by host layers for
+ * logging, metrics bucketing, and switch-statement exhaustiveness checks.
+ * @experimental — consumed at runtime only; not used by the TypeScript
+ * type system (discriminated union handles compile-time exhaustiveness).
+ */
+export const WAKE_ONCE_DECISIONS = [
+    'no_ready_tasks',
+    'blocked',
+    'dependency_failed',
+    'leased',
+    'would_lease',
+    'lease_conflict',
+    'invalid_task_metadata',
+];
+// ── InternalizationOrchestrator ───────────────────────────────────────────────
+export class InternalizationOrchestrator {
+    owner;
+    runtimeKind;
+    dryRun;
+    stateManager;
+    constructor(deps, options) {
+        if (!options.owner || !options.runtimeKind) {
+            throw new PDRuntimeError('input_invalid', 'InternalizationOrchestrator requires non-empty owner and runtimeKind');
+        }
+        this.stateManager = deps.stateManager;
+        this.owner = options.owner;
+        this.runtimeKind = options.runtimeKind;
+        this.dryRun = options.dryRun ?? false;
+    }
+    // ── wakeOnce ──────────────────────────────────────────────────────────────
+    /**
+     * Find the first leasable PI task, validate dependencies, and acquire lease
+     * (or return a structured decision without mutating state).
+     *
+     * Algorithm:
+     *   1. listTasks(pending) → filter PeerRunnerKind → hydrate
+     *   2. If none, try listTasks(retry_wait) for recovery candidates
+     *   3. For first valid PITaskRecord, resolve dependencyTaskIds via getTask
+     *   4. validateInternalizationTaskReady → branch on gate result
+     *   5. On proceed + dryRun → would_lease; on proceed + !dryRun → acquireLease
+     *   6. On lease_conflict PDRuntimeError → structured LeaseConflictResult
+     */
+    async wakeOnce(taskKind) {
+        const candidates = await this.findCandidates(taskKind);
+        const inspectedCount = candidates.length;
+        if (inspectedCount === 0) {
+            const allPeerCount = taskKind ? (await this.findCandidates()).length : 0;
+            return {
+                decision: 'no_ready_tasks',
+                inspectedCount: 0,
+                reason: allPeerCount > 0 ? 'filtered_out' : 'no_candidates',
+            };
+        }
+        let hydrationFailures = 0;
+        let blockedCount = 0;
+        let dependencyFailures = 0;
+        let retryWaitPendingCount = 0;
+        let leaseConflictCount = 0;
+        for (const rawTask of candidates) {
+            const piTask = hydratePITaskRecord(rawTask);
+            if (!piTask) {
+                // Hydration failed — invalid PI metadata, skip and try next candidate
+                hydrationFailures++;
+                continue;
+            }
+            // Resolve all dependency records
+            const dependencies = await this.resolveDependencies(piTask.dependencyTaskIds);
+            // Evaluate dependency gate
+            const gateResult = validateInternalizationTaskReady(piTask, dependencies);
+            if (gateResult.decision === 'blocked') {
+                // Non-terminal — skip and try next candidate
+                blockedCount++;
+                continue;
+            }
+            if (gateResult.decision === 'dependency_failed') {
+                // Non-terminal — skip and try next candidate
+                dependencyFailures++;
+                continue;
+            }
+            if (gateResult.decision === 'retry_wait_pending') {
+                retryWaitPendingCount++;
+                continue;
+            }
+            // gateResult.decision === 'proceed'
+            if (this.dryRun) {
+                return {
+                    decision: 'would_lease',
+                    taskId: piTask.taskId,
+                    taskKind: piTask.taskKind,
+                    gateResult,
+                };
+            }
+            // Actually attempt to acquire the lease
+            try {
+                const leased = await this.stateManager.acquireLease({
+                    taskId: piTask.taskId,
+                    owner: this.owner,
+                    runtimeKind: this.runtimeKind,
+                });
+                return {
+                    decision: 'leased',
+                    taskId: leased.taskId,
+                    taskKind: piTask.taskKind,
+                    attemptCount: leased.attemptCount,
+                };
+            }
+            catch (error) {
+                if (error instanceof PDRuntimeError && error.category === 'lease_conflict') {
+                    // Non-terminal — skip and try next candidate
+                    leaseConflictCount++;
+                    continue;
+                }
+                // Re-throw with task context for correlation
+                const pdError = error instanceof PDRuntimeError ? error : new PDRuntimeError('runtime_unavailable', String(error));
+                throw new PDRuntimeError(pdError.category ?? 'runtime_unavailable', `wakeOnce lease acquisition failed for task ${piTask.taskId}: ${pdError.message}`, { cause: error });
+            }
+        }
+        // All candidates exhausted — determine dominant failure mode for diagnosis
+        // Dominant mode: pick the failure type with the highest count; ties broken
+        // by specificity priority (hydration > dependency > blocked > lease).
+        // Hydration participates when it is the highest count (not just 100%).
+        const reason = retryWaitPendingCount > 0 && retryWaitPendingCount >= hydrationFailures && retryWaitPendingCount >= dependencyFailures && retryWaitPendingCount >= blockedCount && retryWaitPendingCount >= leaseConflictCount
+            ? 'all_retry_wait_pending'
+            : hydrationFailures > 0 && hydrationFailures >= dependencyFailures && hydrationFailures >= blockedCount && hydrationFailures >= leaseConflictCount
+                ? 'all_hydration_failed'
+                : dependencyFailures >= blockedCount && dependencyFailures >= leaseConflictCount
+                    ? 'all_dependency_failed'
+                    : blockedCount >= leaseConflictCount
+                        ? 'all_blocked'
+                        : leaseConflictCount > 0
+                            ? 'all_lease_conflict'
+                            : 'no_candidates';
+        return {
+            decision: 'no_ready_tasks',
+            inspectedCount,
+            reason,
+        };
+    }
+    // ── proposeNextTask ──────────────────────────────────────────────────────
+    /**
+     * Generate a successor task proposal for a succeeded task.
+     *
+     * Does NOT create the task — the caller decides whether to persist
+     * the proposal via RuntimeStateManager.createTask().
+     *
+     * Note: existingTasks is hardcoded to [] — the host layer is responsible
+     * for deduplicating proposals against tasks already in the queue before
+     * calling createTask().
+     *
+     * Returns null if:
+     *   - Task not found
+     *   - Task not a valid PITaskRecord (hydration fails)
+     *   - Task status is not 'succeeded'
+     *   - No valid successor exists in the job graph
+     */
+    async proposeNextTask(taskId) {
+        const rawTask = await this.stateManager.getTask(taskId);
+        if (!rawTask) {
+            return null;
+        }
+        const piTask = hydratePITaskRecord(rawTask);
+        if (!piTask) {
+            return null;
+        }
+        // Guard against non-PI task kinds (would cause getAllowedSuccessors to return undefined)
+        if (!isPeerRunnerKind(piTask.taskKind)) {
+            return null;
+        }
+        if (piTask.status !== 'succeeded') {
+            return null;
+        }
+        const proposal = createNextTaskProposal(piTask, []);
+        if (!proposal) {
+            return null;
+        }
+        return {
+            decision: 'proposal_created',
+            taskId: piTask.taskId,
+            taskKind: piTask.taskKind,
+            proposal,
+        };
+    }
+    // ── commitNextTaskProposal ──────────────────────────────────────────────
+    /**
+     * Commit a successor task proposal for a succeeded source task.
+     *
+     * Idempotent: if a matching successor already exists (same parentTaskId +
+     * successorKind + channel), returns successor_exists without creating a duplicate.
+     *
+     * Steps:
+     *   1. getTask(taskId) → null → task_not_found
+     *   2. hydratePITaskRecord(task) → null → invalid_task_metadata
+     *   3. task.status !== 'succeeded' → source_not_succeeded
+     *   4. proposeNextTask(taskId) → null → no_successor
+     *   5. Deduplicate: scan pending tasks for matching successor
+     *   6. Found → successor_exists
+     *   7. Not found → createTask + write PI metadata → successor_created
+     */
+    async commitNextTaskProposal(taskId) {
+        const rawTask = await this.stateManager.getTask(taskId);
+        if (!rawTask) {
+            return { decision: 'task_not_found', taskId };
+        }
+        const piTask = hydratePITaskRecord(rawTask);
+        if (!piTask) {
+            return { decision: 'invalid_task_metadata', taskId, reason: 'Failed to hydrate PITaskRecord from diagnosticJson' };
+        }
+        if (piTask.status !== 'succeeded') {
+            return { decision: 'source_not_succeeded', taskId, status: piTask.status };
+        }
+        const proposalResult = await this.proposeNextTask(taskId);
+        if (!proposalResult) {
+            return { decision: 'no_successor', sourceTaskId: taskId, reason: 'No valid successor in job graph for this task kind and channel' };
+        }
+        const { proposal } = proposalResult;
+        const existingSuccessor = await this.findExistingSuccessor(taskId, proposal.taskKind, proposal.channel);
+        if (existingSuccessor) {
+            return {
+                decision: 'successor_exists',
+                sourceTaskId: taskId,
+                successorTaskId: existingSuccessor.taskId,
+                successorKind: proposal.taskKind,
+            };
+        }
+        const successorTaskId = `${proposal.taskKind}-${taskId}-${proposal.channel}`;
+        const successorMetadata = {
+            dependencyTaskIds: proposal.dependencyTaskIds,
+            channel: proposal.channel,
+            timeoutMs: 300_000,
+            inputArtifactRefs: proposal.inputArtifactRefs,
+            outputArtifactRefs: [],
+            parentTaskId: proposal.parentTaskId,
+            correlationId: proposal.correlationId,
+        };
+        // eslint-disable-next-line @typescript-eslint/init-declarations
+        let successorRecord;
+        try {
+            successorRecord = await this.stateManager.createTask({
+                taskId: successorTaskId,
+                taskKind: proposal.taskKind,
+                status: 'pending',
+                attemptCount: 0,
+                maxAttempts: 3,
+                inputRef: undefined,
+                resultRef: undefined,
+                lastError: undefined,
+                leaseOwner: undefined,
+                leaseExpiresAt: undefined,
+                diagnosticJson: createPITaskDiagnosticJson(successorMetadata),
+            });
+        }
+        catch (createErr) {
+            const errMsg = createErr instanceof Error ? createErr.message : String(createErr);
+            if (errMsg.includes('UNIQUE constraint') || errMsg.includes('PRIMARY KEY') || errMsg.includes('already exists')) {
+                return {
+                    decision: 'successor_exists',
+                    sourceTaskId: taskId,
+                    successorTaskId,
+                    successorKind: proposal.taskKind,
+                };
+            }
+            throw createErr;
+        }
+        return {
+            decision: 'successor_created',
+            sourceTaskId: taskId,
+            successorTaskId: successorRecord.taskId,
+            successorKind: proposal.taskKind,
+        };
+    }
+    // ── Private helpers ───────────────────────────────────────────────────────
+    /**
+     * Find an existing successor task matching parentTaskId + successorKind + channel.
+     * Scans pending tasks and hydrates to check PI metadata.
+     * Returns the matching TaskRecord or null.
+     */
+    async findExistingSuccessor(parentTaskId, successorKind, channel) {
+        const pendingTasks = await this.stateManager.listTasks({ status: 'pending' });
+        const retryWaitTasks = await this.stateManager.listTasks({ status: 'retry_wait' });
+        const candidates = [...pendingTasks, ...retryWaitTasks];
+        for (const task of candidates) {
+            if (task.taskKind !== successorKind)
+                continue;
+            const piTask = hydratePITaskRecord(task);
+            if (!piTask)
+                continue;
+            if (piTask.parentTaskId === parentTaskId && piTask.channel === channel) {
+                return task;
+            }
+        }
+        return null;
+    }
+    /**
+     * Find candidate PI tasks by querying pending and retry_wait statuses.
+     * Filters to only PeerRunnerKind taskKinds and hydrates to PITaskRecord.
+     */
+    async findCandidates(taskKind) {
+        if (taskKind && !isPeerRunnerKind(taskKind)) {
+            throw new PDRuntimeError('input_invalid', `findCandidates: invalid taskKind filter: ${taskKind}`);
+        }
+        const allCandidates = [];
+        try {
+            const pending = await this.stateManager.listTasks({ status: 'pending' });
+            const retryWait = await this.stateManager.listTasks({ status: 'retry_wait' });
+            allCandidates.push(...pending, ...retryWait);
+        }
+        catch (error) {
+            if (error instanceof PDRuntimeError)
+                throw error;
+            throw new PDRuntimeError('runtime_unavailable', 'findCandidates failed', { cause: error });
+        }
+        let peerTasks = allCandidates.filter(t => isPeerRunnerKind(t.taskKind));
+        if (taskKind) {
+            peerTasks = peerTasks.filter(t => t.taskKind === taskKind);
+        }
+        return peerTasks;
+    }
+    /**
+     * Resolve an array of dependency task IDs into TaskRecord instances.
+     * Missing tasks (not yet created) are excluded from the result — this
+     * causes validateInternalizationTaskReady to fail closed (treat as blocked).
+     */
+    async resolveDependencies(depIds) {
+        if (depIds.length === 0) {
+            return [];
+        }
+        // Use allSettled so one bad depId doesn't kill the entire resolution
+        const results = await Promise.allSettled(depIds.map(depId => this.stateManager.getTask(depId)));
+        return results
+            .filter((r) => r.status === 'fulfilled')
+            .map(r => r.value)
+            .filter((t) => t !== null);
+    }
+}
+//# sourceMappingURL=internalization-orchestrator.js.map

package/dist/runtime-v2/internalization/internalization-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalization-orchestrator.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/internalization-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmDxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB;IAChB,SAAS;IACT,mBAAmB;IACnB,QAAQ;IACR,aAAa;IACb,gBAAgB;IAChB,uBAAuB;CACf,CAAC;AA6CX,iFAAiF;AAEjF,MAAM,OAAO,2BAA2B;IACrB,KAAK,CAAS;IACd,WAAW,CAAS;IACpB,MAAM,CAAU;IAChB,YAAY,CAAsB;IAEnD,YAAY,IAAqC,EAAE,OAA2C;QAC5F,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,sEAAsE,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACxC,CAAC;IAED,6EAA6E;IAE7E;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;QAEzC,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,OAAO;gBACL,QAAQ,EAAE,gBAAgB;gBAC1B,cAAc,EAAE,CAAC;gBACjB,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe;aAC5D,CAAC;QACJ,CAAC;QAED,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAC3B,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAC9B,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAE3B,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAE5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,sEAAsE;gBACtE,iBAAiB,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,iCAAiC;YACjC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAE9E,2BAA2B;YAC3B,MAAM,UAAU,GAAG,gCAAgC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAE1E,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACtC,6CAA6C;gBAC7C,YAAY,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,IAAI,UAAU,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;gBAChD,6CAA6C;gBAC7C,kBAAkB,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,UAAU,CAAC,QAAQ,KAAK,oBAAoB,EAAE,CAAC;gBACjD,qBAAqB,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,oCAAoC;YACpC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO;oBACL,QAAQ,EAAE,aAAa;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,UAAU;iBACX,CAAC;YACJ,CAAC;YAED,wCAAwC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;oBAClD,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;oBAC3E,6CAA6C;oBAC7C,kBAAkB,EAAE,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,6CAA6C;gBAC7C,MAAM,OAAO,GAAG,KAAK,YAAY,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnH,MAAM,IAAI,cAAc,CACtB,OAAO,CAAC,QAAQ,IAAI,qBAAqB,EACzC,8CAA8C,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,EACjF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,2EAA2E;QAC3E,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,MAAM,GACV,qBAAqB,GAAG,CAAC,IAAI,qBAAqB,IAAI,iBAAiB,IAAI,qBAAqB,IAAI,kBAAkB,IAAI,qBAAqB,IAAI,YAAY,IAAI,qBAAqB,IAAI,kBAAkB;YAC5M,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,IAAI,kBAAkB,IAAI,iBAAiB,IAAI,YAAY,IAAI,iBAAiB,IAAI,kBAAkB;gBAChJ,CAAC,CAAC,sBAAsB;gBACxB,CAAC,CAAC,kBAAkB,IAAI,YAAY,IAAI,kBAAkB,IAAI,kBAAkB;oBAC9E,CAAC,CAAC,uBAAuB;oBACzB,CAAC,CAAC,YAAY,IAAI,kBAAkB;wBAClC,CAAC,CAAC,aAAa;wBACf,CAAC,CAAC,kBAAkB,GAAG,CAAC;4BACtB,CAAC,CAAC,oBAAoB;4BACtB,CAAC,CAAC,eAAe,CAAC;QAE9B,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,cAAc;YACd,MAAM;SACP,CAAC;IACJ,CAAC;IAED,4EAA4E;IAE5E;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yFAAyF;QACzF,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,sBAAsB,CAAC,MAAc;QACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,oDAAoD,EAAE,CAAC;QACrH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7E,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,gEAAgE,EAAE,CAAC;QACtI,CAAC;QAED,MAAM,EAAC,QAAQ,EAAC,GAAG,cAAc,CAAC;QAElC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxG,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,YAAY,EAAE,MAAM;gBACpB,eAAe,EAAE,iBAAiB,CAAC,MAAM;gBACzC,aAAa,EAAE,QAAQ,CAAC,QAAQ;aACjC,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,GAAG,QAAQ,CAAC,QAAQ,IAAI,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7E,MAAM,iBAAiB,GAAmB;YACxC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,OAAO;YAClB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,kBAAkB,EAAE,EAAE;YACtB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;SACtC,CAAC;QAEF,gEAAgE;QAChE,IAAI,eAA2B,CAAC;QAChC,IAAI,CAAC;YACH,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;gBACnD,MAAM,EAAE,eAAe;gBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,SAAS;gBACpB,UAAU,EAAE,SAAS;gBACrB,cAAc,EAAE,SAAS;gBACzB,cAAc,EAAE,0BAA0B,CAAC,iBAAiB,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClF,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAChH,OAAO;oBACL,QAAQ,EAAE,kBAAkB;oBAC5B,YAAY,EAAE,MAAM;oBACpB,eAAe;oBACf,aAAa,EAAE,QAAQ,CAAC,QAAQ;iBACjC,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,mBAAmB;YAC7B,YAAY,EAAE,MAAM;YACpB,eAAe,EAAE,eAAe,CAAC,MAAM;YACvC,aAAa,EAAE,QAAQ,CAAC,QAAQ;SACjC,CAAC;IACJ,CAAC;IAED,6EAA6E;IAE7E;;;;OAIG;IACK,KAAK,CAAC,qBAAqB,CACjC,YAAoB,EACpB,aAA6B,EAC7B,OAAe;QAEf,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9E,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,cAAc,CAAC,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;gBAAE,SAAS;YAC9C,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,MAAM,CAAC,YAAY,KAAK,YAAY,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACvE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc,CAAC,QAAyB;QACpD,IAAI,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,4CAA4C,QAAQ,EAAE,CAAC,CAAC;QACpG,CAAC;QAED,MAAM,aAAa,GAAiB,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9E,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,KAAK,CAAC;YACjD,MAAM,IAAI,cAAc,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAExE,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,mBAAmB,CAAC,MAAyB;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,qEAAqE;QACrE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACtD,CAAC;QAEF,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAkD,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;aACvF,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACjB,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/runtime-v2/internalization/internalization-route.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Internalization Route Model — Maps recommendation kinds to pipeline routes
+ *
+ * PURPOSE: Pure, deterministic mapping from DiagnosticianRecommendation kinds
+ * to internalization pipeline routes. No I/O, no filesystem, no side effects.
+ *
+ * ROUTES:
+ *   principle-ledger          — wisdom/principle write path
+ *   rule-candidate            — rule compilation pipeline (requires trigger + action)
+ *   implementation-candidate  — code implementation pipeline
+ *   prompt-injection-candidate — prompt/skill injection pipeline
+ *   deferred                  — intentionally skipped, never enters executable pipeline
+ */
+import type { DiagnosticianRecommendation } from '../diagnostician-output.js';
+export type InternalizationRouteKind = 'principle-ledger' | 'rule-candidate' | 'implementation-candidate' | 'prompt-injection-candidate' | 'deferred';
+/** Field name union — only these three fields can appear in missingFields */
+export type RouteMissingField = 'abstractedPrinciple' | 'triggerPattern' | 'action';
+export interface InternalizationRouteDecision {
+    /** Whether this recommendation can enter its next internalization pipeline */
+    ready: boolean;
+    route: InternalizationRouteKind;
+    /** Which required fields are missing for the recommendation to be ready */
+    missingFields: RouteMissingField[];
+    reason: string;
+    nextAction: string;
+}
+export declare function decideInternalizationRoute(recommendation: DiagnosticianRecommendation): InternalizationRouteDecision;
+//# sourceMappingURL=internalization-route.d.ts.map

package/dist/runtime-v2/internalization/internalization-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalization-route.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/internalization-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAsB,MAAM,4BAA4B,CAAC;AAIlG,MAAM,MAAM,wBAAwB,GAChC,kBAAkB,GAClB,gBAAgB,GAChB,0BAA0B,GAC1B,4BAA4B,GAC5B,UAAU,CAAC;AAIf,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEpF,MAAM,WAAW,4BAA4B;IAC3C,8EAA8E;IAC9E,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,wBAAwB,CAAC;IAChC,2EAA2E;IAC3E,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,2BAA2B,GAC1C,4BAA4B,CAgG9B"}