@principles/core 2.1.1 → 4.0.0

package/dist/runtime-v2/gfi/gfi-read-model.js

@@ -1,129 +0,0 @@
-/**
- * GFI Observability Read Model
- *
- * Pure domain model for building workspace-level GFI snapshots.
- * Partitions sessions into active vs stale and produces an authoritative snapshot
- * for operator visibility.
- *
- * PRI-78: GFI Observability
- */
-import { DEFAULT_GFI_POLICY } from './gfi-policy.js';
-import { createGfiSnapshot } from './gfi-kernel.js';
-const DEFAULT_STALE_CUTOFF_MS = 2 * 60 * 60 * 1000; // 2 hours
-const DEFAULT_STALE_GFI_DEGRADED_THRESHOLD = 40;
-export function classifyGfiWorkspaceHealth(snapshot, options) {
-    const staleGfiDegradedThreshold = options?.staleGfiDegradedThreshold ?? DEFAULT_STALE_GFI_DEGRADED_THRESHOLD;
-    if (snapshot.active !== null && snapshot.active.currentGfi >= staleGfiDegradedThreshold) {
-        return {
-            status: 'degraded',
-            reason: `Active session has elevated GFI (${snapshot.active.currentGfi})`,
-            staleGfiDegradedThreshold,
-        };
-    }
-    if (snapshot.activeSessionCount === 0 && snapshot.staleSessionCount > 0) {
-        const maxStaleGfi = snapshot.staleGfiRange?.max ?? 0;
-        if (maxStaleGfi >= staleGfiDegradedThreshold) {
-            return {
-                status: 'degraded',
-                reason: `No active sessions, ${snapshot.staleSessionCount} stale sessions with high GFI (max: ${maxStaleGfi})`,
-                staleGfiDegradedThreshold,
-            };
-        }
-        return {
-            status: 'healthy',
-            reason: `No active sessions, ${snapshot.staleSessionCount} stale sessions with low GFI (max: ${maxStaleGfi})`,
-            staleGfiDegradedThreshold,
-        };
-    }
-    return {
-        status: 'healthy',
-        reason: `${snapshot.activeSessionCount} active, ${snapshot.staleSessionCount} stale sessions`,
-        staleGfiDegradedThreshold,
-    };
-}
-/**
- * Convert a session's fields to a GfiState for snapshot creation.
- * Note: lastErrorHash is not persisted across sessions, so we omit it.
- */
-function sessionToGfiState(session) {
-    return {
-        currentGfi: session.currentGfi ?? 0,
-        gfiBySource: (session.gfiBySource ?? {}),
-        lastErrorSource: session.lastErrorSource,
-        consecutiveErrors: session.consecutiveErrors ?? 0,
-        lastGfiDecayAt: session.lastGfiDecayAt,
-        dailyGfiPeak: session.dailyGfiPeak,
-    };
-}
-/**
- * Build a workspace-level GFI snapshot from session data.
- *
- * Algorithm:
- * 1. Default stale cutoff to 2 hours if not provided
- * 2. Partition sessions into active (lastActivityAt >= nowMs - staleCutoffMs) and stale
- * 3. Select active session with highest currentGfi (tie-break: most recent lastActivityAt)
- * 4. Build GfiSnapshot for selected active session using createGfiSnapshot
- * 5. Compute staleGfiRange from stale sessions' currentGfi values
- * 6. Return GfiWorkspaceSnapshot
- *
- * Key invariant: stale sessions do NOT influence the active snapshot.
- * This prevents old UAT sessions with GFI=197.8 from making current health look critical.
- */
-export function buildGfiWorkspaceSnapshot(input) {
-    const { sessions, nowMs, policy = DEFAULT_GFI_POLICY } = input;
-    const staleCutoffMs = input.staleCutoffMs ?? DEFAULT_STALE_CUTOFF_MS;
-    if (sessions.length === 0) {
-        return {
-            active: null,
-            staleSessionCount: 0,
-            staleGfiRange: null,
-            totalSessionCount: 0,
-            activeSessionCount: 0,
-            generatedAt: new Date(nowMs).toISOString(),
-        };
-    }
-    const cutoffTime = nowMs - staleCutoffMs;
-    // Partition sessions
-    const activeSessions = [];
-    const staleSessions = [];
-    for (const session of sessions) {
-        if ((session.lastActivityAt ?? 0) >= cutoffTime) {
-            activeSessions.push(session);
-        }
-        else {
-            staleSessions.push(session);
-        }
-    }
-    // Select active session: highest currentGfi, tie-break by most recent lastActivityAt
-    let selectedActive = null;
-    for (const session of activeSessions) {
-        if (selectedActive === null ||
-            (session.currentGfi ?? 0) > (selectedActive.currentGfi ?? 0) ||
-            ((session.currentGfi ?? 0) === (selectedActive.currentGfi ?? 0) &&
-                (session.lastActivityAt ?? 0) > (selectedActive.lastActivityAt ?? 0))) {
-            selectedActive = session;
-        }
-    }
-    // Build snapshot for active session
-    const activeSnapshot = selectedActive
-        ? createGfiSnapshot(sessionToGfiState(selectedActive), policy)
-        : null;
-    // Compute stale GFI range
-    let staleGfiRange = null;
-    if (staleSessions.length > 0) {
-        const staleGfis = staleSessions.map((s) => s.currentGfi ?? 0);
-        staleGfiRange = {
-            min: staleGfis.reduce((a, b) => Math.min(a, b), Infinity),
-            max: staleGfis.reduce((a, b) => Math.max(a, b), -Infinity),
-        };
-    }
-    return {
-        active: activeSnapshot,
-        staleSessionCount: staleSessions.length,
-        staleGfiRange,
-        totalSessionCount: sessions.length,
-        activeSessionCount: activeSessions.length,
-        generatedAt: new Date(nowMs).toISOString(),
-    };
-}
-//# sourceMappingURL=gfi-read-model.js.map

package/dist/runtime-v2/gfi/gfi-read-model.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gfi-read-model.js","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/gfi-read-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA6CpD,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAE9D,MAAM,oCAAoC,GAAG,EAAE,CAAC;AAQhD,MAAM,UAAU,0BAA0B,CACxC,QAA8B,EAC9B,OAAgD;IAEhD,MAAM,yBAAyB,GAAG,OAAO,EAAE,yBAAyB,IAAI,oCAAoC,CAAC;IAE7G,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,IAAI,yBAAyB,EAAE,CAAC;QACxF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,oCAAoC,QAAQ,CAAC,MAAM,CAAC,UAAU,GAAG;YACzE,yBAAyB;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,kBAAkB,KAAK,CAAC,IAAI,QAAQ,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;QACrD,IAAI,WAAW,IAAI,yBAAyB,EAAE,CAAC;YAC7C,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,uBAAuB,QAAQ,CAAC,iBAAiB,uCAAuC,WAAW,GAAG;gBAC9G,yBAAyB;aAC1B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,uBAAuB,QAAQ,CAAC,iBAAiB,sCAAsC,WAAW,GAAG;YAC7G,yBAAyB;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,GAAG,QAAQ,CAAC,kBAAkB,YAAY,QAAQ,CAAC,iBAAiB,iBAAiB;QAC7F,yBAAyB;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CACxB,OAAyC;IAEzC,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;QACjD,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAwB;IAExB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,GAAG,KAAK,CAAC;IAC/D,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAErE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,CAAC;YACpB,kBAAkB,EAAE,CAAC;YACrB,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;IAEzC,qBAAqB;IACrB,MAAM,cAAc,GAAkC,EAAE,CAAC;IACzD,MAAM,aAAa,GAAkC,EAAE,CAAC;IAExD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;YAChD,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,IAAI,cAAc,GAA4C,IAAI,CAAC;IAEnE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IACE,cAAc,KAAK,IAAI;YACvB,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC;YAC5D,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC;gBAC7D,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,EACvE,CAAC;YACD,cAAc,GAAG,OAAO,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAuB,cAAc;QACvD,CAAC,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAC9D,CAAC,CAAC,IAAI,CAAC;IAET,0BAA0B;IAC1B,IAAI,aAAa,GAAwC,IAAI,CAAC;IAE9D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QAC9D,aAAa,GAAG;YACd,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC;YACzD,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,iBAAiB,EAAE,aAAa,CAAC,MAAM;QACvC,aAAa;QACb,iBAAiB,EAAE,QAAQ,CAAC,MAAM;QAClC,kBAAkB,EAAE,cAAc,CAAC,MAAM;QACzC,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;KAC3C,CAAC;AACJ,CAAC"}

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

@@ -1,70 +0,0 @@
-export type GfiSource = 'tool_failure' | 'dispatch_error' | 'user_empathy' | 'manual_pain' | 'correction_cue' | 'llm_paralysis' | 'gate_block' | 'unknown';
-export type GfiStage = 'stable' | 'elevated' | 'critical' | 'saturated';
-export interface GfiState {
-    currentGfi: number;
-    /**
-     * Per-source GFI ledger. Invariant: when gfiBySource is non-empty,
-     * currentGfi MUST equal the sum of all source values (within rounding).
-     *
-     * Exception: after session restart or persistence boundary, gfiBySource
-     * may be empty while currentGfi > 0 (source ledger not persisted).
-     * In this state, applyDecay falls back to direct currentGfi decay
-     * using the stage rate until source events repopulate the ledger.
-     */
-    gfiBySource: Partial<Record<GfiSource, number>>;
-    lastErrorHash?: string;
-    lastErrorSource?: string;
-    consecutiveErrors: number;
-    lastGfiDecayAt?: number;
-    dailyGfiPeak?: number;
-}
-export interface GfiPolicy {
-    stageThresholds: {
-        elevated: number;
-        critical: number;
-        saturated: number;
-    };
-    repeatedFailureMultiplier: {
-        base: number;
-        max: number;
-    };
-    decayRatesPerMinute: {
-        stable: number;
-        elevated: number;
-        critical: number;
-        saturated: number;
-    };
-    relief: {
-        toolSuccessRatio: number;
-        minPruneBelow: number;
-    };
-    sourceWeights: Partial<Record<GfiSource, number>>;
-}
-export interface GfiEvent {
-    source: GfiSource;
-    baseScore: number;
-    hash?: string;
-    at?: number;
-    detail?: string;
-}
-export interface GfiSnapshot {
-    currentGfi: number;
-    stage: GfiStage;
-    sources: Partial<Record<GfiSource, number>>;
-    dominantSource: string | null;
-    consecutiveErrors: number;
-    lastErrorSource?: string;
-    lastDecayAt?: string;
-    dailyGfiPeak?: number;
-    policy: {
-        elevatedThreshold: number;
-        criticalThreshold: number;
-        saturatedThreshold: number;
-        repeatedFailureMultiplierMax: number;
-    };
-    consumers: {
-        attitudeMode: 'efficient' | 'conciliatory' | 'humble_recovery';
-        painDiagnosticReason: 'none' | 'high_gfi';
-    };
-}
-//# sourceMappingURL=gfi-types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gfi-types.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/gfi-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,yBAAyB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,mBAAmB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACN,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,SAAS,EAAE;QACT,YAAY,EAAE,WAAW,GAAG,cAAc,GAAG,iBAAiB,CAAC;QAC/D,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;KAC3C,CAAC;CACH"}

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=gfi-types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gfi-types.js","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/gfi-types.ts"],"names":[],"mappings":""}

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

@@ -1,6 +0,0 @@
-export { DEFAULT_GFI_POLICY } from './gfi-policy.js';
-export { applyFriction, applyDecay, applyRelief, classifyGfiStage, createGfiSnapshot, } from './gfi-kernel.js';
-export { buildGfiWorkspaceSnapshot, classifyGfiWorkspaceHealth } from './gfi-read-model.js';
-export type { GfiState, GfiEvent, GfiPolicy, GfiStage, GfiSource, GfiSnapshot, } from './gfi-types.js';
-export type { GfiReadModelInput, GfiWorkspaceSnapshot, GfiWorkspaceHealthAssessment } from './gfi-read-model.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAE5F,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -1,4 +0,0 @@
-export { DEFAULT_GFI_POLICY } from './gfi-policy.js';
-export { applyFriction, applyDecay, applyRelief, classifyGfiStage, createGfiSnapshot, } from './gfi-kernel.js';
-export { buildGfiWorkspaceSnapshot, classifyGfiWorkspaceHealth } from './gfi-read-model.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}