@skastr0/pulsar-core 0.1.0

package/dist/observer-model.d.ts

@@ -0,0 +1,129 @@
+import type { Category } from "./category.js";
+import { ProjectModuleScope } from "./calibration.js";
+import type { Diagnostic } from "./diagnostic.js";
+import type { SignalRunResult } from "./runner.js";
+import type { SignalApplicability, SignalOutputMetadata } from "./signal.js";
+export declare const OBSERVER_OUTPUT_SEMANTICS: "applicability-aware-readiness-v1";
+export type ObserverOutputSemantics = typeof OBSERVER_OUTPUT_SEMANTICS;
+/**
+ * The top-level scoring output — a dimension vector grouped by taxonomy
+ * category, the minimum dimension, a weighted mean, and hard-gate status.
+ *
+ * Mirrors ARCHITECTURE.md §Score Output. The public JSON contract keeps
+ * the architecture doc's snake_case keys (`weighted_mean`,
+ * `hard_gate_status`, `hard_gate_violations`). Additional runtime-only
+ * metadata (`inactiveSignals`, `signalResults`) stays attached for
+ * in-process consumers such as tests and compound signals.
+ */
+export interface CategoryOutput {
+    readonly score: number;
+    readonly signals: Record<string, number>;
+    readonly signalCount: number;
+    readonly applicableSignalCount?: number;
+    readonly activeSignalIds: ReadonlyArray<string>;
+    readonly aggregation?: {
+        readonly strategy: "weighted-mean" | "language-group-mean";
+        readonly rawScore: number;
+        readonly aggregateScore: number;
+        readonly lowestSignalScore: number;
+        readonly finalScore: number;
+        readonly shapedByPressure: boolean;
+        readonly pressure: {
+            readonly strategy: "pressure-pnorm-local-max";
+            readonly p: number;
+            readonly meanPressure: number;
+            readonly pnormPressure: number;
+            readonly maxLocalPressure: number;
+            readonly localPressure: number;
+            readonly finalPressure: number;
+        };
+        readonly weightTotal: number;
+        readonly weights: Record<string, number>;
+    };
+    readonly normalization?: {
+        readonly strategy: "language-group-mean";
+        readonly groups: Record<string, {
+            readonly score: number;
+            readonly signals: ReadonlyArray<string>;
+            readonly signalCount: number;
+        }>;
+    };
+}
+export interface MinimumDimension {
+    readonly signal: string;
+    readonly category: Category;
+    readonly score: number;
+    readonly detail: string;
+}
+export interface HardGateViolation {
+    readonly signalId: string;
+    readonly category: Category;
+    readonly diagnostic: Diagnostic;
+}
+export interface ReadinessPressure {
+    readonly signal_id: string;
+    readonly category: Category;
+    readonly score: number;
+    readonly raw_pressure: number;
+    readonly effective_pressure: number;
+    readonly weight: number;
+    readonly confidence: number;
+    readonly applicability: SignalApplicability;
+}
+export interface ReadinessOutput {
+    readonly score: number;
+    readonly pressure: number;
+    readonly status: "green" | "yellow" | "red" | "blocked" | "unknown" | "failed";
+    readonly aggregation: {
+        readonly strategy: "pressure-pnorm-local-max";
+        readonly p: number;
+        readonly mean_pressure: number;
+        readonly pnorm_pressure: number;
+        readonly max_local_pressure: number;
+        readonly failed_signal_pressure: number;
+        readonly hard_gate_pressure: number;
+        readonly hard_gate_score_cap: number;
+        readonly local_warning_threshold: number;
+        readonly local_poison_threshold: number;
+        readonly local_warning_gain: number;
+        readonly applicable_signal_count: number;
+        readonly ignored_signal_count: number;
+        readonly failed_signal_count: number;
+    };
+    readonly top_pressures: ReadonlyArray<ReadinessPressure>;
+}
+export interface ObserverRuntimeProfile {
+    readonly totalMs: number;
+    readonly stages?: Record<string, {
+        readonly durationMs: number;
+    }>;
+    readonly signals: Record<string, {
+        readonly durationMs: number;
+        readonly score: number;
+        readonly diagnostics: number;
+    }>;
+}
+export interface ObserverCalibrationModuleSummary {
+    readonly id: string;
+    readonly version: string;
+    readonly scope: typeof ProjectModuleScope.Type;
+    readonly source: "builtin" | "package" | "workspace" | "repo-local";
+    readonly source_ref?: string;
+    readonly source_fingerprint?: string;
+    readonly fingerprint: string;
+}
+export interface ObserverCalibrationSummary {
+    readonly fingerprint: string;
+    readonly active_modules: ReadonlyArray<ObserverCalibrationModuleSummary>;
+}
+export interface ObserverRuntimeOutput {
+    readonly categories: Record<Category, CategoryOutput>;
+    readonly minimum: MinimumDimension | undefined;
+    readonly readiness?: ReadinessOutput;
+    readonly inactiveSignals: ReadonlyArray<string>;
+    readonly signalResults: ReadonlyMap<string, SignalRunResult>;
+    readonly signalMetadata?: Record<string, SignalOutputMetadata>;
+    readonly runtimeProfile?: ObserverRuntimeProfile;
+    readonly calibration?: ObserverCalibrationSummary;
+}
+//# sourceMappingURL=observer-model.d.ts.map

package/dist/observer-model.d.ts.map

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

package/dist/observer-model.js

@@ -0,0 +1,2 @@
+export const OBSERVER_OUTPUT_SEMANTICS = "applicability-aware-readiness-v1";
+//# sourceMappingURL=observer-model.js.map

package/dist/observer-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-model.js","sourceRoot":"","sources":["../src/observer-model.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAA2C,CAAA"}

package/dist/observer-readiness.d.ts

@@ -0,0 +1,6 @@
+import type { Registry } from "./registry.js";
+import type { SignalRunResult } from "./runner.js";
+import { type PulsarVector } from "./vector.js";
+import type { ReadinessOutput } from "./observer-model.js";
+export declare const computeReadiness: (registry: Registry, signalResults: ReadonlyMap<string, SignalRunResult>, vector: PulsarVector | undefined, hardGateStatus: "pass" | "fail") => ReadinessOutput;
+//# sourceMappingURL=observer-readiness.d.ts.map

package/dist/observer-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-readiness.d.ts","sourceRoot":"","sources":["../src/observer-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAAqB,KAAK,YAAY,EAA4D,MAAM,aAAa,CAAA;AAC5H,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAA;AAI7E,eAAO,MAAM,gBAAgB,GAC3B,UAAU,QAAQ,EAClB,eAAe,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EACnD,QAAQ,YAAY,GAAG,SAAS,EAChC,gBAAgB,MAAM,GAAG,MAAM,KAC9B,eAgCF,CAAA"}

package/dist/observer-readiness.js

@@ -0,0 +1,131 @@
+import { readinessConfigOf, weightOf as vectorWeightOf } from "./vector.js";
+import { localSignalPressure } from "./observer-local-pressure.js";
+import { clamp01, compareAscii, confidenceForSignal, roundScore, signalApplicabilityOf } from "./observer-score-utils.js";
+export const computeReadiness = (registry, signalResults, vector, hardGateStatus) => {
+    const config = readinessConfigOf(vector);
+    const collected = collectReadinessPressures(registry, signalResults, vector, config);
+    const summary = summarizeReadinessPressure(collected, config, hardGateStatus);
+    return {
+        score: summary.score,
+        pressure: summary.pressure,
+        status: readinessStatus(summary.pressure, hardGateStatus, config, collected.applicableSignalCount, collected.failedSignalCount),
+        aggregation: {
+            strategy: "pressure-pnorm-local-max",
+            p: config.p_norm,
+            mean_pressure: roundScore(summary.meanPressure),
+            pnorm_pressure: roundScore(summary.pnormPressure),
+            max_local_pressure: roundScore(collected.maxLocalPressure),
+            failed_signal_pressure: roundScore(summary.failedSignalPressure),
+            hard_gate_pressure: roundScore(summary.hardGatePressure),
+            hard_gate_score_cap: config.hard_gate_score_cap,
+            local_warning_threshold: config.local_warning_threshold,
+            local_poison_threshold: config.local_poison_threshold,
+            local_warning_gain: config.local_warning_gain,
+            applicable_signal_count: collected.applicableSignalCount,
+            ignored_signal_count: collected.ignoredSignalCount,
+            failed_signal_count: collected.failedSignalCount,
+        },
+        top_pressures: topReadinessPressures(collected.pressures, config),
+    };
+};
+const collectReadinessPressures = (registry, signalResults, vector, config) => {
+    const pressures = [];
+    let weightedPressureSum = 0;
+    let weightedPnormSum = 0;
+    let weightTotal = 0;
+    let maxLocalPressure = 0;
+    let applicableSignalCount = 0;
+    let ignoredSignalCount = 0;
+    let failedSignalCount = 0;
+    for (const signal of registry.sorted) {
+        const result = signalResults.get(signal.id);
+        if (result === undefined)
+            continue;
+        const contribution = readinessPressureContribution(signal, result, vector);
+        pressures.push(contribution.pressure);
+        if (contribution.ignored) {
+            ignoredSignalCount += 1;
+            if (contribution.failed) {
+                failedSignalCount += 1;
+            }
+            continue;
+        }
+        applicableSignalCount += 1;
+        weightedPressureSum += contribution.weight * contribution.effectivePressure;
+        weightedPnormSum += contribution.weight * Math.pow(contribution.effectivePressure, config.p_norm);
+        weightTotal += contribution.weight;
+        maxLocalPressure = Math.max(maxLocalPressure, contribution.effectivePressure);
+    }
+    return {
+        pressures,
+        weightedPressureSum,
+        weightedPnormSum,
+        weightTotal,
+        maxLocalPressure,
+        applicableSignalCount,
+        ignoredSignalCount,
+        failedSignalCount,
+    };
+};
+const readinessPressureContribution = (signal, result, vector) => {
+    const applicability = signalApplicabilityOf(result);
+    const ignored = applicability !== "applicable";
+    const confidence = ignored ? 0 : confidenceForSignal(signal, result);
+    const weight = vectorWeightOf(signal, vector);
+    const rawPressure = clamp01(1 - result.score);
+    const effectivePressure = rawPressure * confidence;
+    return {
+        pressure: {
+            signal_id: signal.id,
+            category: signal.category,
+            score: result.score,
+            raw_pressure: roundScore(rawPressure),
+            effective_pressure: roundScore(effectivePressure),
+            weight,
+            confidence: roundScore(confidence),
+            applicability,
+        },
+        ignored,
+        failed: applicability === "failed",
+        weight,
+        effectivePressure,
+    };
+};
+const summarizeReadinessPressure = (collection, config, hardGateStatus) => {
+    const { weightTotal } = collection;
+    const meanPressure = weightTotal === 0 ? 0 : collection.weightedPressureSum / weightTotal;
+    const pnormPressure = weightTotal === 0
+        ? 0
+        : Math.pow(collection.weightedPnormSum / weightTotal, 1 / config.p_norm);
+    const localPressure = localSignalPressure(collection.maxLocalPressure, config);
+    const failedSignalPressure = collection.failedSignalCount > 0 ? 1 : 0;
+    const hardGatePressure = hardGateStatus === "fail" ? 1 - config.hard_gate_score_cap : 0;
+    const pressure = roundScore(clamp01(Math.max(pnormPressure, localPressure, failedSignalPressure, hardGatePressure)));
+    return {
+        score: roundScore(clamp01(1 - pressure)),
+        pressure,
+        meanPressure,
+        pnormPressure,
+        failedSignalPressure,
+        hardGatePressure,
+    };
+};
+const topReadinessPressures = (pressures, config) => [...pressures]
+    .sort((left, right) => right.effective_pressure - left.effective_pressure ||
+    right.raw_pressure - left.raw_pressure ||
+    compareAscii(left.signal_id, right.signal_id))
+    .slice(0, config.top_pressures);
+const readinessStatus = (pressure, hardGateStatus, config, applicableSignalCount, failedSignalCount) => {
+    if (hardGateStatus === "fail")
+        return "blocked";
+    if (failedSignalCount > 0)
+        return "failed";
+    if (applicableSignalCount === 0)
+        return "unknown";
+    if (pressure < config.green_max_pressure)
+        return "green";
+    if (pressure < config.red_min_pressure)
+        return "yellow";
+    return "red";
+};
+//# sourceMappingURL=observer-readiness.js.map

package/dist/observer-readiness.js.map

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

package/dist/observer-score-utils.d.ts

@@ -0,0 +1,8 @@
+import type { SignalRunResult } from "./runner.js";
+import type { ResolvedSignal, SignalApplicability } from "./signal.js";
+export declare const confidenceForSignal: (signal: ResolvedSignal, result: SignalRunResult) => number;
+export declare const signalApplicabilityOf: (result: SignalRunResult) => SignalApplicability;
+export declare const clamp01: (value: number) => number;
+export declare const roundScore: (value: number) => number;
+export declare const compareAscii: (left: string, right: string) => number;
+//# sourceMappingURL=observer-score-utils.d.ts.map

package/dist/observer-score-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-score-utils.d.ts","sourceRoot":"","sources":["../src/observer-score-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,cAAc,EACtB,QAAQ,eAAe,KACtB,MAKA,CAAA;AAEH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,eAAe,KAAG,mBAC2B,CAAA;AAS3F,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,MAAyC,CAAA;AAEjF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAAmC,CAAA;AAE9E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MACjB,CAAA"}

package/dist/observer-score-utils.js

@@ -0,0 +1,17 @@
+export const confidenceForSignal = (signal, result) => clamp01(result.metadata?.effectiveConfidence ??
+    result.metadata?.baseConfidence ??
+    defaultConfidenceForTier(signal.tier));
+export const signalApplicabilityOf = (result) => result.metadata?.applicability ?? (result.output === undefined ? "failed" : "applicable");
+const defaultConfidenceForTier = (tier) => {
+    if (tier === 1)
+        return 1;
+    if (tier === 1.5)
+        return 0.95;
+    if (tier === 2)
+        return 0.85;
+    return 0.5;
+};
+export const clamp01 = (value) => Math.min(1, Math.max(0, value));
+export const roundScore = (value) => Number(value.toFixed(12));
+export const compareAscii = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+//# sourceMappingURL=observer-score-utils.js.map

package/dist/observer-score-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-score-utils.js","sourceRoot":"","sources":["../src/observer-score-utils.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAsB,EACtB,MAAuB,EACf,EAAE,CACV,OAAO,CACL,MAAM,CAAC,QAAQ,EAAE,mBAAmB;IAClC,MAAM,CAAC,QAAQ,EAAE,cAAc;IAC/B,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CACxC,CAAA;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAuB,EAAuB,EAAE,CACpF,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;AAE3F,MAAM,wBAAwB,GAAG,CAAC,IAA4B,EAAU,EAAE;IACxE,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACxB,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC7B,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3B,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;AAEjF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE,CAClE,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/observer-serializer.d.ts

@@ -0,0 +1,3 @@
+import type { ObserverOutput, ObserverOutputPublic } from "./observer-json.js";
+export declare const toObserverJson: (output: ObserverOutput) => ObserverOutputPublic;
+//# sourceMappingURL=observer-serializer.d.ts.map

package/dist/observer-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-serializer.d.ts","sourceRoot":"","sources":["../src/observer-serializer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EAErB,MAAM,oBAAoB,CAAA;AAE3B,eAAO,MAAM,cAAc,GAAI,QAAQ,cAAc,KAAG,oBA2DtD,CAAA"}

package/dist/observer-serializer.js

@@ -0,0 +1,66 @@
+import { OBSERVER_OUTPUT_SEMANTICS } from "./observer-model.js";
+export const toObserverJson = (output) => ({
+    observer_semantics: OBSERVER_OUTPUT_SEMANTICS,
+    categories: {
+        "architectural-drift": toObserverCategorySnapshot(output.categories["architectural-drift"]),
+        "dependency-entropy": toObserverCategorySnapshot(output.categories["dependency-entropy"]),
+        "abstraction-bloat": toObserverCategorySnapshot(output.categories["abstraction-bloat"]),
+        "legibility-decay": toObserverCategorySnapshot(output.categories["legibility-decay"]),
+        "generated-slop": toObserverCategorySnapshot(output.categories["generated-slop"]),
+        "review-pain": toObserverCategorySnapshot(output.categories["review-pain"]),
+    },
+    minimum: output.minimum,
+    weighted_mean: output.weighted_mean,
+    ...(output.readiness !== undefined ? { readiness: output.readiness } : {}),
+    hard_gate_status: output.hard_gate_status,
+    hard_gate_violations: output.hard_gate_violations,
+    ...(output.calibration !== undefined ? { calibration: output.calibration } : {}),
+    ...(output.signalMetadata !== undefined && Object.keys(output.signalMetadata).length > 0
+        ? { signal_metadata: output.signalMetadata }
+        : {}),
+    ...(output.runtimeProfile !== undefined
+        ? {
+            runtime_profile: {
+                total_ms: output.runtimeProfile.totalMs,
+                ...(output.runtimeProfile.stages !== undefined
+                    ? {
+                        stages: Object.fromEntries(Object.entries(output.runtimeProfile.stages).map(([stageId, profile]) => [
+                            stageId,
+                            { duration_ms: profile.durationMs },
+                        ])),
+                    }
+                    : {}),
+                signals: Object.fromEntries(Object.entries(output.runtimeProfile.signals).map(([signalId, profile]) => [
+                    signalId,
+                    {
+                        duration_ms: profile.durationMs,
+                        score: profile.score,
+                        diagnostics: profile.diagnostics,
+                    },
+                ])),
+            },
+        }
+        : {}),
+    ...(signalFactorsJson(output).length > 0
+        ? { signal_factors: Object.fromEntries(signalFactorsJson(output)) }
+        : {}),
+});
+const signalFactorsJson = (output) => [...output.signalResults.entries()]
+    .flatMap(([signalId, result]) => result.factorLedger === undefined
+    ? []
+    : [[signalId, result.factorLedger.entries]])
+    .sort(([left], [right]) => left.localeCompare(right));
+const toObserverCategorySnapshot = (category) => ({
+    score: category.score,
+    signals: category.signals,
+    signalCount: category.signalCount,
+    applicableSignalCount: category.applicableSignalCount ?? category.signalCount,
+    activeSignalIds: [...category.activeSignalIds],
+    ...(category.aggregation !== undefined
+        ? { aggregation: category.aggregation }
+        : {}),
+    ...(category.normalization !== undefined
+        ? { normalization: category.normalization }
+        : {}),
+});
+//# sourceMappingURL=observer-serializer.js.map

package/dist/observer-serializer.js.map

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

package/dist/observer-time.d.ts

@@ -0,0 +1,3 @@
+export declare const nowMs: () => number;
+export declare const roundRuntimeMs: (value: number) => number;
+//# sourceMappingURL=observer-time.d.ts.map

package/dist/observer-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-time.d.ts","sourceRoot":"","sources":["../src/observer-time.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,QAAO,MAGxB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAA+C,CAAA"}

package/dist/observer-time.js

@@ -0,0 +1,7 @@
+export const nowMs = () => {
+    if (typeof performance !== "undefined")
+        return performance.now();
+    return Date.now();
+};
+export const roundRuntimeMs = (value) => Math.max(0, Number(value.toFixed(2)));
+//# sourceMappingURL=observer-time.js.map

package/dist/observer-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-time.js","sourceRoot":"","sources":["../src/observer-time.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,GAAW,EAAE;IAChC,IAAI,OAAO,WAAW,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC,GAAG,EAAE,CAAA;IAChE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;AACnB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/observer-weighted-mean.d.ts

@@ -0,0 +1,4 @@
+import { type Category } from "./category.js";
+import type { CategoryOutput } from "./observer-model.js";
+export declare const computeWeightedMean: (categories: Record<Category, CategoryOutput>) => number;
+//# sourceMappingURL=observer-weighted-mean.d.ts.map

package/dist/observer-weighted-mean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-weighted-mean.d.ts","sourceRoot":"","sources":["../src/observer-weighted-mean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,KAC3C,MAYF,CAAA"}

package/dist/observer-weighted-mean.js

@@ -0,0 +1,17 @@
+import { CATEGORIES } from "./category.js";
+export const computeWeightedMean = (categories) => {
+    let weightedSum = 0;
+    let totalCount = 0;
+    for (const category of CATEGORIES) {
+        const entry = categories[category];
+        const count = entry.applicableSignalCount ?? entry.signalCount;
+        if (count === 0)
+            continue;
+        weightedSum += entry.score * count;
+        totalCount += count;
+    }
+    if (totalCount === 0)
+        return 1;
+    return weightedSum / totalCount;
+};
+//# sourceMappingURL=observer-weighted-mean.js.map

package/dist/observer-weighted-mean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-weighted-mean.js","sourceRoot":"","sources":["../src/observer-weighted-mean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAA;AAGzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAA4C,EACpC,EAAE;IACV,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,WAAW,CAAA;QAC9D,IAAI,KAAK,KAAK,CAAC;YAAE,SAAQ;QACzB,WAAW,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;QAClC,UAAU,IAAI,KAAK,CAAA;IACrB,CAAC;IACD,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,WAAW,GAAG,UAAU,CAAA;AACjC,CAAC,CAAA"}

package/dist/observer.d.ts

@@ -0,0 +1,26 @@
+import { Effect } from "effect";
+import type { Registry } from "./registry.js";
+import type { SignalRequirements } from "./signal-runtime.js";
+import type { PulsarVector } from "./vector.js";
+import type { ObserverOutput } from "./observer-json.js";
+export * from "./observer-model.js";
+export * from "./observer-json.js";
+export { toObserverJson } from "./observer-serializer.js";
+interface ObserverOptions {
+    readonly profile?: boolean;
+}
+/**
+ * Run every active signal in the registry against the ambient context,
+ * then aggregate the results into the canonical ObserverOutput shape.
+ *
+ * Error channel is `never` because per-signal compute failures are
+ * captured as score-0 warn diagnostics inside the signal's category
+ * (AC-8). This keeps one flaky signal from collapsing the whole
+ * observation.
+ *
+ * Requirements `R` is left open — it is whatever the active signals
+ * demand (e.g. TsProjectTag for the TS pack). The caller provides the
+ * layer union exactly as they do for runSignal.
+ */
+export declare const observe: (registry: Registry, vector: PulsarVector | undefined, options?: ObserverOptions) => Effect.Effect<ObserverOutput, never, SignalRequirements>;
+//# sourceMappingURL=observer.d.ts.map

package/dist/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,QAAQ,EAClB,QAAQ,YAAY,GAAG,SAAS,EAChC,UAAU,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,kBAAkB,CAuCtD,CAAA"}

package/dist/observer.js

@@ -0,0 +1,63 @@
+import { Effect, Option } from "effect";
+import { CalibrationContextTag } from "./calibration.js";
+import { aggregateCategories } from "./observer-categories.js";
+import { executeObserverSignals, summarizeCalibration } from "./observer-execution.js";
+import { collectHardGateViolations, findMinimum } from "./observer-minimum.js";
+import { OBSERVER_OUTPUT_SEMANTICS } from "./observer-model.js";
+import { computeReadiness } from "./observer-readiness.js";
+import { nowMs, roundRuntimeMs } from "./observer-time.js";
+import { computeWeightedMean } from "./observer-weighted-mean.js";
+export * from "./observer-model.js";
+export * from "./observer-json.js";
+export { toObserverJson } from "./observer-serializer.js";
+/**
+ * Run every active signal in the registry against the ambient context,
+ * then aggregate the results into the canonical ObserverOutput shape.
+ *
+ * Error channel is `never` because per-signal compute failures are
+ * captured as score-0 warn diagnostics inside the signal's category
+ * (AC-8). This keeps one flaky signal from collapsing the whole
+ * observation.
+ *
+ * Requirements `R` is left open — it is whatever the active signals
+ * demand (e.g. TsProjectTag for the TS pack). The caller provides the
+ * layer union exactly as they do for runSignal.
+ */
+export const observe = (registry, vector, options) => Effect.gen(function* () {
+    const observerStartedAt = nowMs();
+    const executed = yield* executeObserverSignals(registry, vector, options?.profile === true);
+    const categories = aggregateCategories(registry, executed.signalResults, vector);
+    const minimum = findMinimum(registry, executed.signalResults);
+    const weightedMean = computeWeightedMean(categories);
+    const hardGateViolations = collectHardGateViolations(registry, executed.signalResults);
+    const hardGateStatus = hardGateViolations.length > 0 ? "fail" : "pass";
+    const readiness = computeReadiness(registry, executed.signalResults, vector, hardGateStatus);
+    const calibration = yield* Effect.serviceOption(CalibrationContextTag);
+    const calibrationSummary = Option.isSome(calibration)
+        ? summarizeCalibration(calibration.value)
+        : undefined;
+    return {
+        observer_semantics: OBSERVER_OUTPUT_SEMANTICS,
+        categories,
+        minimum,
+        weighted_mean: weightedMean,
+        readiness,
+        hard_gate_status: hardGateStatus,
+        hard_gate_violations: hardGateViolations,
+        inactiveSignals: executed.inactiveSignals,
+        signalResults: executed.signalResults,
+        ...(calibrationSummary !== undefined ? { calibration: calibrationSummary } : {}),
+        ...(Object.keys(executed.signalMetadata).length > 0
+            ? { signalMetadata: executed.signalMetadata }
+            : {}),
+        ...(options?.profile === true
+            ? {
+                runtimeProfile: {
+                    totalMs: roundRuntimeMs(nowMs() - observerStartedAt),
+                    signals: executed.signalProfiles,
+                },
+            }
+            : {}),
+    };
+});
+//# sourceMappingURL=observer.js.map

package/dist/observer.js.map

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

package/dist/presets.d.ts

@@ -0,0 +1,11 @@
+import { Effect } from "effect";
+import { type PulsarVector } from "./vector.js";
+export interface PulsarVectorPresetSummary {
+    readonly id: string;
+    readonly description: string;
+}
+export declare const loadPulsarVectorPresets: () => Effect.Effect<ReadonlyArray<PulsarVector>, Error, never>;
+export declare const loadPulsarVectorPresetById: (presetId: string) => Effect.Effect<PulsarVector, Error, never>;
+export declare const summarizePulsarVectorPresets: (presets: ReadonlyArray<PulsarVector>) => ReadonlyArray<PulsarVectorPresetSummary>;
+export declare const oneLineDescription: (vector: PulsarVector) => string;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAiBnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,eAAO,MAAM,uBAAuB,QAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,CAe9F,CAAA;AAKJ,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAQvC,CAAA;AAEJ,eAAO,MAAM,4BAA4B,GACvC,SAAS,aAAa,CAAC,YAAY,CAAC,KACnC,aAAa,CAAC,yBAAyB,CAMiB,CAAA;AAE3D,eAAO,MAAM,kBAAkB,GAAI,QAAQ,YAAY,KAAG,MAMzD,CAAA"}