@principles/core 1.73.0

package/dist/runtime-v2/activation/activation-dispatcher.js

@@ -0,0 +1,231 @@
+import { isLowRiskChannel, getChannelRiskLevel, makeIdempotencyKey, } from './activation-types.js';
+import { decideAutoPromotion } from './approval-queue.js';
+import { extractPrincipleId } from './low-risk-writers.js';
+async function checkCanActivate(writer, artifact) {
+    try {
+        const result = await writer.canActivate(artifact);
+        if (!result.ok) {
+            return {
+                decision: {
+                    decision: 'refused',
+                    reason: result.reason ?? 'can_activate_refused',
+                    riskLevel: result.riskLevel,
+                    channel: writer.channel,
+                },
+            };
+        }
+        return { decision: null, result };
+    }
+    catch {
+        return { decision: { decision: 'refused', reason: 'can_activate_check_failed', channel: writer.channel } };
+    }
+}
+// eslint-disable-next-line @typescript-eslint/max-params
+function buildApprovalContext(artifact, channel, riskLevel, confidence) {
+    let principleText = '';
+    try {
+        const parsed = JSON.parse(artifact.contentJson);
+        principleText = String(parsed.text ?? parsed.description ?? '');
+    }
+    catch { /* best-effort */ }
+    const kindLabel = artifact.artifactKind ?? 'artifact';
+    const confidencePct = confidence !== undefined ? Math.round(confidence * 100) + '%' : 'unknown';
+    const CHANNEL_EFFECTS = {
+        skill: 'This principle will be activated as a skill that monitors and influences agent behavior in real-time.',
+        code_tool_hook: 'This principle will be injected as a code tool hook that intercepts and validates tool calls before execution.',
+        model_training: 'This principle will be used as training data for model fine-tuning, affecting future model responses.',
+    };
+    return {
+        summary: principleText
+            ? `Activate ${kindLabel}: "${principleText.slice(0, 200)}"`
+            : `Activate ${kindLabel} artifact ${artifact.artifactId}`,
+        triggerReason: `Rollout reviewer recommended activation via ${channel} channel (risk: ${riskLevel}).`,
+        confidenceExplanation: confidence !== undefined
+            ? `Confidence score: ${confidencePct}. ` + (confidence >= 0.8 ? 'High confidence based on multiple validations.' : confidence >= 0.5 ? 'Moderate confidence, additional review recommended.' : 'Low confidence, manual review strongly recommended.')
+            : 'Confidence score not available.',
+        effectDescription: CHANNEL_EFFECTS[channel] ?? `This artifact will be activated via the ${channel} channel.`,
+        rejectionEffect: `The artifact will remain inactive and will not be deployed to the ${channel} channel. You can request activation again later.`,
+    };
+}
+export class ActivationDispatcher {
+    artifactReadModel;
+    stateReadModel;
+    writers;
+    approvalQueueStore;
+    constructor(artifactReadModel, stateReadModel, config) {
+        this.artifactReadModel = artifactReadModel;
+        this.stateReadModel = stateReadModel;
+        this.approvalQueueStore = config.approvalQueueStore;
+        this.writers = new Map();
+        for (const writer of config.writers) {
+            this.writers.set(writer.channel, writer);
+        }
+    }
+    async dispatch(input) {
+        const artifactResult = await this.readArtifact(input.artifactId);
+        if (artifactResult.decision)
+            return artifactResult.decision;
+        const { artifact } = artifactResult;
+        if (!artifact.artifactId || typeof artifact.artifactKind !== 'string') {
+            return { decision: 'invalid_artifact', reason: 'malformed_artifact' };
+        }
+        const idempotencyKey = input.idempotencyKey ?? makeIdempotencyKey(input.artifactId, input.channel);
+        const existingResult = await this.checkIdempotency(idempotencyKey);
+        if (existingResult.decision)
+            return existingResult.decision;
+        if (input.rolloutDecision === 'reject') {
+            return { decision: 'refused', reason: 'rollout_rejected', channel: input.channel };
+        }
+        // Auto-promotion bypasses both channel-risk gating AND explicit require_approval from the rollout gate.
+        // This is intentional: high-confidence skill artifacts are safe enough to activate without human review.
+        const needsApproval = input.rolloutDecision === 'require_approval' || !isLowRiskChannel(input.channel);
+        if (needsApproval) {
+            if (decideAutoPromotion(input.channel, input.confidence)) {
+                return this.activateArtifact(input, artifact, idempotencyKey);
+            }
+            return this.enqueueForApproval(input, artifact, idempotencyKey);
+        }
+        return this.activateArtifact(input, artifact, idempotencyKey);
+    }
+    async enqueueForApproval(input, artifact, idempotencyKey) {
+        const riskLevel = getChannelRiskLevel(input.channel);
+        if (!this.approvalQueueStore) {
+            return {
+                decision: 'refused',
+                reason: 'requires_approval',
+                channel: input.channel,
+                riskLevel,
+            };
+        }
+        const writer = this.writers.get(input.channel);
+        if (writer) {
+            const canActivateResult = await checkCanActivate(writer, artifact);
+            if (canActivateResult.decision)
+                return canActivateResult.decision;
+        }
+        // Dry-run: preview what would be queued without persisting
+        if (!input.confirm) {
+            return {
+                decision: 'queued_for_approval',
+                approvalId: 'apr_' + input.channel + '_' + input.artifactId,
+                queuedAt: input.now,
+                channel: input.channel,
+                riskLevel,
+            };
+        }
+        try {
+            const writerContext = writer?.buildApprovalContext?.({
+                artifactId: input.artifactId,
+                channel: input.channel,
+                principleId: extractPrincipleId(artifact) ?? '',
+                idempotencyKey: idempotencyKey,
+                now: input.now,
+            }, artifact, input.confidence);
+            const record = await this.approvalQueueStore.enqueue({
+                artifactId: input.artifactId,
+                channel: input.channel,
+                riskLevel,
+                confidence: input.confidence,
+                ...(writerContext ?? buildApprovalContext(artifact, input.channel, riskLevel, input.confidence)),
+            }, input.now);
+            return {
+                decision: 'queued_for_approval',
+                approvalId: record.approvalId,
+                queuedAt: record.requestedAt,
+                channel: input.channel,
+                riskLevel,
+            };
+        }
+        catch {
+            return { decision: 'refused', reason: 'approval_enqueue_failed', channel: input.channel, riskLevel };
+        }
+    }
+    async activateArtifact(input, artifact, idempotencyKey) {
+        const principleId = extractPrincipleId(artifact);
+        if (!principleId) {
+            return { decision: 'invalid_artifact', reason: 'no_principle_id' };
+        }
+        const writer = this.writers.get(input.channel);
+        if (!writer) {
+            return { decision: 'refused', reason: 'no_writer_for_channel_' + input.channel, channel: input.channel };
+        }
+        const canActivateResult = await checkCanActivate(writer, artifact);
+        if (canActivateResult.decision)
+            return canActivateResult.decision;
+        const writerInput = {
+            artifactId: input.artifactId,
+            channel: input.channel,
+            principleId,
+            idempotencyKey,
+            now: input.now,
+        };
+        // eslint-disable-next-line @typescript-eslint/init-declarations
+        let writerResult;
+        try {
+            writerResult = await writer.activate(writerInput, artifact);
+        }
+        catch {
+            return { decision: 'refused', reason: 'activation_write_failed', channel: input.channel };
+        }
+        if (!input.confirm) {
+            return {
+                decision: 'would_activate',
+                activationId: writerResult.activationId,
+                action: writerResult.action,
+                targetRef: writerResult.targetRef,
+            };
+        }
+        try {
+            await this.stateReadModel.recordActivation({
+                activationId: writerResult.activationId,
+                idempotencyKey,
+                artifactId: input.artifactId,
+                channel: input.channel,
+                action: writerResult.action,
+                targetRef: writerResult.targetRef,
+                activatedAt: input.now,
+            });
+        }
+        catch {
+            return { decision: 'refused', reason: 'activation_record_failed', channel: input.channel };
+        }
+        return {
+            decision: 'activated',
+            activationId: writerResult.activationId,
+            action: writerResult.action,
+            targetRef: writerResult.targetRef,
+        };
+    }
+    async readArtifact(artifactId) {
+        try {
+            const result = await this.artifactReadModel.getArtifactById(artifactId);
+            if (!result) {
+                return { artifact: null, decision: { decision: 'invalid_artifact', reason: 'artifact_not_found' } };
+            }
+            return { artifact: result, decision: null };
+        }
+        catch {
+            return { artifact: null, decision: { decision: 'refused', reason: 'artifact_read_failed' } };
+        }
+    }
+    async checkIdempotency(idempotencyKey) {
+        try {
+            const existing = await this.stateReadModel.getActivationStatus(idempotencyKey);
+            if (existing) {
+                return {
+                    decision: {
+                        decision: 'already_activated',
+                        activationId: existing.activationId,
+                        action: existing.action,
+                        targetRef: existing.targetRef,
+                    },
+                };
+            }
+            return { decision: null };
+        }
+        catch {
+            return { decision: { decision: 'refused', reason: 'activation_state_read_failed' } };
+        }
+    }
+}
+//# sourceMappingURL=activation-dispatcher.js.map

package/dist/runtime-v2/activation/activation-dispatcher.js.map

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

package/dist/runtime-v2/activation/activation-types.d.ts

@@ -0,0 +1,195 @@
+import type { InternalizationChannel, PIArtifactKind, PIArtifactValidationStatus } from '../internalization/peer-runner-contracts.js';
+export type { InternalizationChannel, PIArtifactKind, PIArtifactValidationStatus };
+export type ActivationRiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export declare const LOW_RISK_CHANNELS: readonly InternalizationChannel[];
+export declare const HIGH_RISK_CHANNEL_MAP: Readonly<Record<string, ActivationRiskLevel>>;
+export declare const AUTO_PROMOTION_CONFIDENCE_THRESHOLD = 0.95;
+export declare const AUTO_PROMOTABLE_CHANNELS: readonly InternalizationChannel[];
+export type ActivationActor = {
+    kind: 'system';
+    source: 'rollout_reviewer' | 'recovery_sweep';
+} | {
+    kind: 'agent';
+    agentId: string;
+} | {
+    kind: 'human';
+    userId: string;
+};
+export type RolloutActivationDecision = 'auto_activate' | 'require_approval' | 'reject';
+export interface DispatchInput {
+    artifactId: string;
+    channel: InternalizationChannel;
+    rolloutDecision: RolloutActivationDecision;
+    actor: ActivationActor;
+    idempotencyKey?: string;
+    now: string;
+    confirm: boolean;
+    confidence?: number;
+}
+export type ActivationDecision = {
+    decision: 'would_activate';
+    activationId: string;
+    action: string;
+    targetRef: string;
+} | {
+    decision: 'activated';
+    activationId: string;
+    action: string;
+    targetRef: string;
+} | {
+    decision: 'already_activated';
+    activationId: string;
+    action: string;
+    targetRef: string;
+} | {
+    decision: 'queued_for_approval';
+    approvalId: string;
+    queuedAt: string;
+    channel: InternalizationChannel;
+    riskLevel: ActivationRiskLevel;
+} | {
+    decision: 'refused';
+    reason: string;
+    riskLevel?: ActivationRiskLevel;
+    channel?: InternalizationChannel;
+} | {
+    decision: 'invalid_artifact';
+    reason: string;
+};
+export interface PIArtifactSnapshot {
+    artifactId: string;
+    artifactKind: PIArtifactKind;
+    sourceTaskId: string;
+    sourcePrincipleId?: string;
+    sourceRuleId?: string;
+    lineageArtifactIds: string[];
+    validationStatus: PIArtifactValidationStatus;
+    contentJson: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ActivationArtifactReadModel {
+    getArtifactById(artifactId: string): Promise<PIArtifactSnapshot | null>;
+}
+export interface ActivationStatusRecord {
+    activationId: string;
+    idempotencyKey: string;
+    artifactId: string;
+    channel: InternalizationChannel;
+    action: string;
+    targetRef: string;
+    activatedAt: string;
+}
+export interface ActivationStateReadModel {
+    getActivationStatus(idempotencyKey: string): Promise<ActivationStatusRecord | null>;
+    recordActivation(record: ActivationStatusRecord): Promise<void>;
+    listPromptActivations(): Promise<ActivationStatusRecord[]>;
+}
+export interface WriterInput {
+    artifactId: string;
+    channel: InternalizationChannel;
+    principleId: string;
+    idempotencyKey: string;
+    now: string;
+}
+export interface WriterResult {
+    activationId: string;
+    action: string;
+    targetRef: string;
+}
+export interface CanActivateResult {
+    ok: boolean;
+    reason?: string;
+    riskLevel: ActivationRiskLevel;
+}
+export interface ChannelWriter {
+    readonly channel: InternalizationChannel;
+    canActivate(artifact: PIArtifactSnapshot): Promise<CanActivateResult>;
+    activate(input: WriterInput, artifact: PIArtifactSnapshot): Promise<WriterResult>;
+    buildApprovalContext?(input: WriterInput, artifact: PIArtifactSnapshot, confidence?: number): Pick<ApprovalEnqueueInput, 'summary' | 'triggerReason' | 'confidenceExplanation' | 'effectDescription' | 'rejectionEffect'>;
+}
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'cancelled';
+export interface ApprovalRecord {
+    approvalId: string;
+    artifactId: string;
+    channel: InternalizationChannel;
+    riskLevel: ActivationRiskLevel;
+    status: ApprovalStatus;
+    confidence?: number;
+    requestedAt: string;
+    decidedAt?: string;
+    decidedBy?: string;
+    decisionNote?: string;
+    rejectionReason?: string;
+    summary?: string;
+    triggerReason?: string;
+    confidenceExplanation?: string;
+    effectDescription?: string;
+    rejectionEffect?: string;
+}
+export type ConfidenceLabel = 'high' | 'medium' | 'low';
+export declare function mapConfidenceToLabel(confidence: number | undefined): ConfidenceLabel;
+export interface ApprovalWithContext extends ApprovalRecord {
+    summary?: string;
+    triggerReason?: string;
+    confidenceLabel: ConfidenceLabel;
+    confidenceExplanation?: string;
+    effectDescription?: string;
+    rejectionEffect?: string;
+}
+export interface ApprovalListFilter {
+    status?: ApprovalStatus;
+    channel?: InternalizationChannel;
+    page?: number;
+    pageSize?: number;
+}
+export interface ApprovalStats {
+    pending: number;
+    approved: number;
+    rejected: number;
+    cancelled: number;
+}
+export interface ApprovalListResult {
+    items: ApprovalWithContext[];
+    total: number;
+    stats: ApprovalStats;
+}
+export interface ApprovalEnqueueInput {
+    artifactId: string;
+    channel: InternalizationChannel;
+    riskLevel: ActivationRiskLevel;
+    confidence?: number;
+    summary?: string;
+    triggerReason?: string;
+    confidenceExplanation?: string;
+    effectDescription?: string;
+    rejectionEffect?: string;
+}
+export interface ApprovalFilter {
+    channel?: InternalizationChannel;
+    riskLevel?: ActivationRiskLevel;
+}
+export type ApprovalDecisionResult = {
+    ok: true;
+    record: ApprovalRecord;
+} | {
+    ok: false;
+    error: 'already_decided';
+    status: ApprovalStatus;
+} | {
+    ok: false;
+    error: 'not_found';
+};
+export interface ApprovalQueueStore {
+    enqueue(input: ApprovalEnqueueInput, now: string): Promise<ApprovalRecord>;
+    getById(approvalId: string): Promise<ApprovalRecord | null>;
+    listPending(filter?: ApprovalFilter): Promise<ApprovalRecord[]>;
+    listAll(filter?: ApprovalListFilter): Promise<ApprovalRecord[]>;
+    countByStatus(): Promise<ApprovalStats>;
+    approve(approvalId: string, decidedBy: string, note?: string): Promise<ApprovalDecisionResult>;
+    reject(approvalId: string, decidedBy: string, reason: string): Promise<ApprovalDecisionResult>;
+}
+export declare function makeIdempotencyKey(artifactId: string, channel: InternalizationChannel): string;
+export declare function isLowRiskChannel(channel: InternalizationChannel): boolean;
+export declare function getChannelRiskLevel(channel: InternalizationChannel): ActivationRiskLevel;
+//# sourceMappingURL=activation-types.d.ts.map

package/dist/runtime-v2/activation/activation-types.d.ts.map

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

package/dist/runtime-v2/activation/activation-types.js

@@ -0,0 +1,29 @@
+export const LOW_RISK_CHANNELS = ['prompt', 'defer_archive'];
+export const HIGH_RISK_CHANNEL_MAP = {
+    skill: 'medium',
+    code_tool_hook: 'high',
+    model_training: 'critical',
+};
+export const AUTO_PROMOTION_CONFIDENCE_THRESHOLD = 0.95;
+export const AUTO_PROMOTABLE_CHANNELS = ['skill'];
+export function mapConfidenceToLabel(confidence) {
+    if (confidence === undefined || confidence === null)
+        return 'medium';
+    if (confidence >= 0.8)
+        return 'high';
+    if (confidence >= 0.5)
+        return 'medium';
+    return 'low';
+}
+export function makeIdempotencyKey(artifactId, channel) {
+    return `${artifactId}::${channel}`;
+}
+export function isLowRiskChannel(channel) {
+    return LOW_RISK_CHANNELS.includes(channel);
+}
+export function getChannelRiskLevel(channel) {
+    if (isLowRiskChannel(channel))
+        return 'low';
+    return HIGH_RISK_CHANNEL_MAP[channel] ?? 'high';
+}
+//# sourceMappingURL=activation-types.js.map

package/dist/runtime-v2/activation/activation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-types.js","sourceRoot":"","sources":["../../../src/runtime-v2/activation/activation-types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,iBAAiB,GAAsC,CAAC,QAAQ,EAAE,eAAe,CAAU,CAAC;AAEzG,MAAM,CAAC,MAAM,qBAAqB,GAAkD;IAClF,KAAK,EAAE,QAAQ;IACf,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,UAAU;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAsC,CAAC,OAAO,CAAU,CAAC;AAqH9F,MAAM,UAAU,oBAAoB,CAAC,UAA8B;IACjE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACrE,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,MAAM,CAAC;IACrC,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AA+DD,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,OAA+B;IACpF,OAAO,GAAG,UAAU,KAAK,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA+B;IAC9D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA+B;IACjE,IAAI,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,qBAAqB,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC;AAClD,CAAC"}

package/dist/runtime-v2/activation/approval-queue.d.ts

@@ -0,0 +1,15 @@
+import type { InternalizationChannel } from '../internalization/peer-runner-contracts.js';
+import type { ApprovalDecisionResult, ApprovalEnqueueInput, ApprovalFilter, ApprovalListFilter, ApprovalQueueStore, ApprovalRecord, ApprovalStats } from './activation-types.js';
+export declare function decideAutoPromotion(channel: InternalizationChannel, confidence: number | undefined): boolean;
+export declare class ApprovalQueue {
+    private readonly store;
+    constructor(store: ApprovalQueueStore);
+    enqueue(input: ApprovalEnqueueInput, now: string): Promise<ApprovalRecord>;
+    getById(approvalId: string): Promise<ApprovalRecord | null>;
+    listPending(filter?: ApprovalFilter): Promise<ApprovalRecord[]>;
+    approve(approvalId: string, decidedBy: string, note?: string): Promise<ApprovalDecisionResult>;
+    reject(approvalId: string, decidedBy: string, reason: string): Promise<ApprovalDecisionResult>;
+    listAll(filter?: ApprovalListFilter): Promise<ApprovalRecord[]>;
+    countByStatus(): Promise<ApprovalStats>;
+}
+//# sourceMappingURL=approval-queue.d.ts.map

package/dist/runtime-v2/activation/approval-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-queue.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/activation/approval-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAM/B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAK5G;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEhD,OAAO,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI1E,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI/D,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAS9F,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAS9F,OAAO,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI/D,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;CAG9C"}

package/dist/runtime-v2/activation/approval-queue.js

@@ -0,0 +1,50 @@
+import { AUTO_PROMOTABLE_CHANNELS, AUTO_PROMOTION_CONFIDENCE_THRESHOLD, } from './activation-types.js';
+export function decideAutoPromotion(channel, confidence) {
+    if (confidence === undefined || confidence === null)
+        return false;
+    if (confidence < 0 || confidence > 1)
+        return false;
+    if (!AUTO_PROMOTABLE_CHANNELS.includes(channel))
+        return false;
+    return confidence >= AUTO_PROMOTION_CONFIDENCE_THRESHOLD;
+}
+export class ApprovalQueue {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async enqueue(input, now) {
+        return this.store.enqueue(input, now);
+    }
+    async getById(approvalId) {
+        return this.store.getById(approvalId);
+    }
+    async listPending(filter) {
+        return this.store.listPending(filter);
+    }
+    async approve(approvalId, decidedBy, note) {
+        const existing = await this.store.getById(approvalId);
+        if (!existing)
+            return { ok: false, error: 'not_found' };
+        if (existing.status !== 'pending') {
+            return { ok: false, error: 'already_decided', status: existing.status };
+        }
+        return this.store.approve(approvalId, decidedBy, note);
+    }
+    async reject(approvalId, decidedBy, reason) {
+        const existing = await this.store.getById(approvalId);
+        if (!existing)
+            return { ok: false, error: 'not_found' };
+        if (existing.status !== 'pending') {
+            return { ok: false, error: 'already_decided', status: existing.status };
+        }
+        return this.store.reject(approvalId, decidedBy, reason);
+    }
+    async listAll(filter) {
+        return this.store.listAll(filter);
+    }
+    async countByStatus() {
+        return this.store.countByStatus();
+    }
+}
+//# sourceMappingURL=approval-queue.js.map

package/dist/runtime-v2/activation/approval-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-queue.js","sourceRoot":"","sources":["../../../src/runtime-v2/activation/approval-queue.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,wBAAwB,EACxB,mCAAmC,GACpC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,mBAAmB,CAAC,OAA+B,EAAE,UAA8B;IACjG,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,UAAU,IAAI,mCAAmC,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO,CAAC,KAA2B,EAAE,GAAW;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAuB;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,SAAiB,EAAE,IAAa;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,SAAiB,EAAE,MAAc;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/runtime-v2/activation/index.d.ts

@@ -0,0 +1,15 @@
+export type { ActivationRiskLevel, ActivationActor, RolloutActivationDecision, DispatchInput, ActivationDecision, PIArtifactSnapshot, ActivationArtifactReadModel, ActivationStatusRecord, ActivationStateReadModel, WriterInput, WriterResult, CanActivateResult, ChannelWriter, InternalizationChannel, PIArtifactKind, PIArtifactValidationStatus, ApprovalStatus, ApprovalRecord, ApprovalEnqueueInput, ApprovalFilter, ApprovalDecisionResult, ApprovalQueueStore, ConfidenceLabel, ApprovalWithContext, ApprovalListFilter, ApprovalStats, ApprovalListResult, } from './activation-types.js';
+export { LOW_RISK_CHANNELS, HIGH_RISK_CHANNEL_MAP, makeIdempotencyKey, isLowRiskChannel, getChannelRiskLevel, AUTO_PROMOTION_CONFIDENCE_THRESHOLD, AUTO_PROMOTABLE_CHANNELS, mapConfidenceToLabel, } from './activation-types.js';
+export { ActivationDispatcher } from './activation-dispatcher.js';
+export type { DispatcherConfig } from './activation-dispatcher.js';
+export { PromptWriter, DeferArchiveWriter, extractPrincipleId, } from './low-risk-writers.js';
+export { MemoryActivationStateStore, MemoryArtifactReadModel, } from './memory-activation-state-store.js';
+export { SqliteActivationStateStore } from './sqlite-activation-state-store.js';
+export { SqliteConfirmFirstStateStore } from './sqlite-confirm-first-state-store.js';
+export type { ConfirmFirstStateRecord } from './sqlite-confirm-first-state-store.js';
+export { ApprovalQueue, decideAutoPromotion } from './approval-queue.js';
+export { MemoryApprovalQueueStore } from './memory-approval-store.js';
+export { SqliteApprovalQueueStore } from './sqlite-approval-store.js';
+export { RuleHostWriter } from './writers/rule-host-writer.js';
+export type { RuleHostWriterConfig } from './writers/rule-host-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/activation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/activation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,mCAAmC,EACnC,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,YAAY,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime-v2/activation/index.js

@@ -0,0 +1,11 @@
+export { LOW_RISK_CHANNELS, HIGH_RISK_CHANNEL_MAP, makeIdempotencyKey, isLowRiskChannel, getChannelRiskLevel, AUTO_PROMOTION_CONFIDENCE_THRESHOLD, AUTO_PROMOTABLE_CHANNELS, mapConfidenceToLabel, } from './activation-types.js';
+export { ActivationDispatcher } from './activation-dispatcher.js';
+export { PromptWriter, DeferArchiveWriter, extractPrincipleId, } from './low-risk-writers.js';
+export { MemoryActivationStateStore, MemoryArtifactReadModel, } from './memory-activation-state-store.js';
+export { SqliteActivationStateStore } from './sqlite-activation-state-store.js';
+export { SqliteConfirmFirstStateStore } from './sqlite-confirm-first-state-store.js';
+export { ApprovalQueue, decideAutoPromotion } from './approval-queue.js';
+export { MemoryApprovalQueueStore } from './memory-approval-store.js';
+export { SqliteApprovalQueueStore } from './sqlite-approval-store.js';
+export { RuleHostWriter } from './writers/rule-host-writer.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/activation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/activation/index.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,mCAAmC,EACnC,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime-v2/activation/low-risk-writers.d.ts

@@ -0,0 +1,14 @@
+import type { PIArtifactSnapshot, CanActivateResult, ChannelWriter, WriterInput, WriterResult } from './activation-types.js';
+declare function extractPrincipleId(artifact: PIArtifactSnapshot): string | null;
+export declare class PromptWriter implements ChannelWriter {
+    readonly channel: "prompt";
+    canActivate(artifact: PIArtifactSnapshot): Promise<CanActivateResult>;
+    activate(input: WriterInput, _artifact: PIArtifactSnapshot): Promise<WriterResult>;
+}
+export declare class DeferArchiveWriter implements ChannelWriter {
+    readonly channel: "defer_archive";
+    canActivate(artifact: PIArtifactSnapshot): Promise<CanActivateResult>;
+    activate(input: WriterInput, _artifact: PIArtifactSnapshot): Promise<WriterResult>;
+}
+export { extractPrincipleId };
+//# sourceMappingURL=low-risk-writers.d.ts.map

package/dist/runtime-v2/activation/low-risk-writers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"low-risk-writers.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/activation/low-risk-writers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM7H,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAwBvE;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAU;IAG/B,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAerE,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;CAOzF;AAED,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,OAAO,EAAG,eAAe,CAAU;IAGtC,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAerE,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;CAOzF;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}