@skastr0/pulsar-core 0.1.0

package/dist/elicitation/revealed-preference.js

@@ -0,0 +1,101 @@
+import { Schema } from "effect";
+import { clampWeight } from "./proposal-utils.js";
+export const RevealedPreferenceOutcome = Schema.Literal("accepted", "revised", "reverted");
+export const RevealedPreferenceSample = Schema.Struct({
+    id: Schema.String,
+    outcome: RevealedPreferenceOutcome,
+    signal_scores: Schema.Record({ key: Schema.String, value: Schema.Number }),
+    confidence: Schema.optionalWith(Schema.Number.pipe(Schema.between(0, 1)), {
+        default: () => 1,
+    }),
+});
+export const MINIMUM_REVEALED_PREFERENCE_SAMPLES = 24;
+export const inferRevealedPreferencePairwise = (samples, prior = {}) => {
+    const accepted = samples.filter((sample) => sample.outcome === "accepted");
+    const rejected = samples.filter((sample) => sample.outcome !== "accepted");
+    const signalIds = collectSignalIds(samples);
+    const evidence = new Map();
+    for (const kept of accepted) {
+        for (const discarded of rejected) {
+            const pairConfidence = kept.confidence * discarded.confidence;
+            for (const signalId of signalIds) {
+                const keptScore = kept.signal_scores[signalId] ?? 0;
+                const discardedScore = discarded.signal_scores[signalId] ?? 0;
+                const diff = keptScore - discardedScore;
+                if (Math.abs(diff) < 0.05)
+                    continue;
+                const entry = evidence.get(signalId) ?? { signed: 0, magnitude: 0 };
+                entry.signed += diff * pairConfidence;
+                entry.magnitude += Math.abs(diff) * pairConfidence;
+                evidence.set(signalId, entry);
+            }
+        }
+    }
+    return {
+        algorithm: "pairwise",
+        sampleCount: samples.length,
+        comparedPairs: accepted.length * rejected.length,
+        weights: materializeWeights(signalIds, evidence, prior, 0.6),
+        support: materializeSupport(signalIds, evidence),
+    };
+};
+export const inferRevealedPreferenceFrequency = (samples, prior = {}) => {
+    const accepted = samples.filter((sample) => sample.outcome === "accepted");
+    const rejected = samples.filter((sample) => sample.outcome !== "accepted");
+    const signalIds = collectSignalIds(samples);
+    const evidence = new Map();
+    for (const signalId of signalIds) {
+        const acceptedMean = average(accepted.map((sample) => (sample.signal_scores[signalId] ?? 0) * sample.confidence));
+        const rejectedMean = average(rejected.map((sample) => (sample.signal_scores[signalId] ?? 0) * sample.confidence));
+        const diff = acceptedMean - rejectedMean;
+        evidence.set(signalId, {
+            signed: diff,
+            magnitude: Math.abs(diff),
+        });
+    }
+    return {
+        algorithm: "frequency",
+        sampleCount: samples.length,
+        comparedPairs: accepted.length * rejected.length,
+        weights: materializeWeights(signalIds, evidence, prior, 0.45),
+        support: materializeSupport(signalIds, evidence),
+    };
+};
+export const inferRevealedPreferencePriorAdjusted = (samples, prior = {}) => {
+    const pairwise = inferRevealedPreferencePairwise(samples, prior);
+    const blend = Math.min(1, samples.length / MINIMUM_REVEALED_PREFERENCE_SAMPLES);
+    const weights = Object.fromEntries(Object.keys(pairwise.weights).map((signalId) => {
+        const priorWeight = prior[signalId] ?? 1;
+        const observed = pairwise.weights[signalId] ?? 1;
+        return [signalId, clampWeight(priorWeight + (observed - priorWeight) * blend)];
+    }));
+    return {
+        algorithm: "prior-adjusted",
+        sampleCount: samples.length,
+        comparedPairs: pairwise.comparedPairs,
+        weights,
+        support: pairwise.support,
+    };
+};
+const collectSignalIds = (samples) => [...new Set(samples.flatMap((sample) => Object.keys(sample.signal_scores)))].sort((left, right) => left.localeCompare(right));
+const materializeWeights = (signalIds, evidence, prior, multiplier) => Object.fromEntries(signalIds.map((signalId) => {
+    const entry = evidence.get(signalId);
+    const priorWeight = prior[signalId] ?? 1;
+    if (entry === undefined || entry.magnitude === 0) {
+        return [signalId, clampWeight(priorWeight)];
+    }
+    const normalized = entry.signed / entry.magnitude;
+    return [signalId, clampWeight(priorWeight + normalized * multiplier)];
+}));
+const materializeSupport = (signalIds, evidence) => Object.fromEntries(signalIds.map((signalId) => {
+    const entry = evidence.get(signalId);
+    if (entry === undefined || entry.magnitude === 0)
+        return [signalId, 0];
+    return [signalId, Number((entry.signed / entry.magnitude).toFixed(3))];
+}));
+const average = (values) => {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+};
+//# sourceMappingURL=revealed-preference.js.map

package/dist/elicitation/revealed-preference.js.map

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

package/dist/elicitation.d.ts

@@ -0,0 +1,5 @@
+export * from "./presets.js";
+export * from "./elicitation/proposals.js";
+export * from "./elicitation/revealed-preference.js";
+export * from "./elicitation/quiz.js";
+//# sourceMappingURL=elicitation.d.ts.map

package/dist/elicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sCAAsC,CAAA;AACpD,cAAc,uBAAuB,CAAA"}

package/dist/elicitation.js

@@ -0,0 +1,5 @@
+export * from "./presets.js";
+export * from "./elicitation/proposals.js";
+export * from "./elicitation/revealed-preference.js";
+export * from "./elicitation/quiz.js";
+//# sourceMappingURL=elicitation.js.map

package/dist/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sCAAsC,CAAA;AACpD,cAAc,uBAAuB,CAAA"}

package/dist/enforcement.d.ts

@@ -0,0 +1,13 @@
+import { Schema } from "effect";
+import type { SignalKind, Tier } from "./tier.js";
+export declare const EnforcementCeiling: Schema.Array$<Schema.Literal<["hard-gate", "soft-warning", "trend", "dashboard", "review-routing"]>>;
+export type EnforcementCeiling = typeof EnforcementCeiling.Type;
+/**
+ * Derive the enforcement ceiling for a (tier, kind) pair as specified
+ * by the architecture document's Enforcement Policy Matrix.
+ *
+ * Signal weights in a pulsar vector adjust sensitivity WITHIN this ceiling.
+ * They never lift it.
+ */
+export declare const deriveEnforcement: (tier: Tier, kind: SignalKind) => EnforcementCeiling;
+//# sourceMappingURL=enforcement.d.ts.map

package/dist/enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement.d.ts","sourceRoot":"","sources":["../src/enforcement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAWjD,eAAO,MAAM,kBAAkB,sGAAiC,CAAA;AAChE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,IAAI,EACV,MAAM,UAAU,KACf,kBAcF,CAAA"}

package/dist/enforcement.js

@@ -0,0 +1,31 @@
+import { Schema } from "effect";
+const EnforcementLevel = Schema.Literal("hard-gate", "soft-warning", "trend", "dashboard", "review-routing");
+export const EnforcementCeiling = Schema.Array(EnforcementLevel);
+/**
+ * Derive the enforcement ceiling for a (tier, kind) pair as specified
+ * by the architecture document's Enforcement Policy Matrix.
+ *
+ * Signal weights in a pulsar vector adjust sensitivity WITHIN this ceiling.
+ * They never lift it.
+ */
+export const deriveEnforcement = (tier, kind) => {
+    if (kind === "compound") {
+        if (tier === 1 || tier === 1.5)
+            return ["trend", "review-routing", "dashboard"];
+        if (tier === 2)
+            return ["trend"];
+        return [];
+    }
+    if (kind === "structural") {
+        if (tier === 1 || tier === 2)
+            return ["hard-gate"];
+        return [];
+    }
+    // legibility
+    if (tier === 1 || tier === 2)
+        return ["soft-warning", "trend"];
+    if (tier === 3)
+        return ["soft-warning"];
+    return [];
+};
+//# sourceMappingURL=enforcement.js.map

package/dist/enforcement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement.js","sourceRoot":"","sources":["../src/enforcement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CACrC,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,gBAAgB,CACjB,CAAA;AAGD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;AAGhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAU,EACV,IAAgB,EACI,EAAE;IACtB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAA;QAC/E,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QAClD,OAAO,EAAE,CAAA;IACX,CAAC;IACD,aAAa;IACb,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAC9D,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACvC,OAAO,EAAE,CAAA;AACX,CAAC,CAAA"}

package/dist/errors.d.ts

@@ -0,0 +1,132 @@
+import { Schema } from "effect";
+import type { TimeSeriesError } from "./time-series-model.js";
+declare const DuplicateSignalIdError_base: Schema.TaggedErrorClass<DuplicateSignalIdError, "DuplicateSignalIdError", {
+    readonly _tag: Schema.tag<"DuplicateSignalIdError">;
+} & {
+    id: typeof Schema.String;
+}>;
+export declare class DuplicateSignalIdError extends DuplicateSignalIdError_base {
+}
+declare const MissingDependencyError_base: Schema.TaggedErrorClass<MissingDependencyError, "MissingDependencyError", {
+    readonly _tag: Schema.tag<"MissingDependencyError">;
+} & {
+    signalId: typeof Schema.String;
+    missingInputId: typeof Schema.String;
+}>;
+export declare class MissingDependencyError extends MissingDependencyError_base {
+}
+declare const CycleDetectedError_base: Schema.TaggedErrorClass<CycleDetectedError, "CycleDetectedError", {
+    readonly _tag: Schema.tag<"CycleDetectedError">;
+} & {
+    chain: Schema.Array$<typeof Schema.String>;
+}>;
+export declare class CycleDetectedError extends CycleDetectedError_base {
+}
+declare const CompositionTooDeepError_base: Schema.TaggedErrorClass<CompositionTooDeepError, "CompositionTooDeepError", {
+    readonly _tag: Schema.tag<"CompositionTooDeepError">;
+} & {
+    signalId: typeof Schema.String;
+    depth: typeof Schema.Number;
+    max: typeof Schema.Number;
+}>;
+export declare class CompositionTooDeepError extends CompositionTooDeepError_base {
+}
+declare const UnknownSignalIdError_base: Schema.TaggedErrorClass<UnknownSignalIdError, "UnknownSignalIdError", {
+    readonly _tag: Schema.tag<"UnknownSignalIdError">;
+} & {
+    id: typeof Schema.String;
+}>;
+export declare class UnknownSignalIdError extends UnknownSignalIdError_base {
+}
+declare const UnknownSignalFactorError_base: Schema.TaggedErrorClass<UnknownSignalFactorError, "UnknownSignalFactorError", {
+    readonly _tag: Schema.tag<"UnknownSignalFactorError">;
+} & {
+    signalId: typeof Schema.String;
+    factorPath: typeof Schema.String;
+}>;
+export declare class UnknownSignalFactorError extends UnknownSignalFactorError_base {
+}
+declare const ConfigValidationError_base: Schema.TaggedErrorClass<ConfigValidationError, "ConfigValidationError", {
+    readonly _tag: Schema.tag<"ConfigValidationError">;
+} & {
+    signalId: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class ConfigValidationError extends ConfigValidationError_base {
+}
+declare const ReferenceDataMissingError_base: Schema.TaggedErrorClass<ReferenceDataMissingError, "ReferenceDataMissingError", {
+    readonly _tag: Schema.tag<"ReferenceDataMissingError">;
+} & {
+    signalId: typeof Schema.String;
+    key: typeof Schema.String;
+}>;
+export declare class ReferenceDataMissingError extends ReferenceDataMissingError_base {
+}
+declare const ReferenceDataLoadFailed_base: Schema.TaggedErrorClass<ReferenceDataLoadFailed, "ReferenceDataLoadFailed", {
+    readonly _tag: Schema.tag<"ReferenceDataLoadFailed">;
+} & {
+    repoPath: typeof Schema.String;
+    path: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class ReferenceDataLoadFailed extends ReferenceDataLoadFailed_base {
+}
+declare const RoutingPatternLoadFailed_base: Schema.TaggedErrorClass<RoutingPatternLoadFailed, "RoutingPatternLoadFailed", {
+    readonly _tag: Schema.tag<"RoutingPatternLoadFailed">;
+} & {
+    repoPath: typeof Schema.String;
+    path: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class RoutingPatternLoadFailed extends RoutingPatternLoadFailed_base {
+}
+declare const SignalComputeError_base: Schema.TaggedErrorClass<SignalComputeError, "SignalComputeError", {
+    readonly _tag: Schema.tag<"SignalComputeError">;
+} & {
+    signalId: typeof Schema.String;
+    message: typeof Schema.String;
+    cause: Schema.optional<typeof Schema.Unknown>;
+}>;
+export declare class SignalComputeError extends SignalComputeError_base {
+}
+declare const WorktreeCreateFailed_base: Schema.TaggedErrorClass<WorktreeCreateFailed, "WorktreeCreateFailed", {
+    readonly _tag: Schema.tag<"WorktreeCreateFailed">;
+} & {
+    repoPath: typeof Schema.String;
+    sha: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class WorktreeCreateFailed extends WorktreeCreateFailed_base {
+}
+declare const WorktreeRemoveFailed_base: Schema.TaggedErrorClass<WorktreeRemoveFailed, "WorktreeRemoveFailed", {
+    readonly _tag: Schema.tag<"WorktreeRemoveFailed">;
+} & {
+    worktreePath: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class WorktreeRemoveFailed extends WorktreeRemoveFailed_base {
+}
+declare const CommitNotFound_base: Schema.TaggedErrorClass<CommitNotFound, "CommitNotFound", {
+    readonly _tag: Schema.tag<"CommitNotFound">;
+} & {
+    repoPath: typeof Schema.String;
+    sha: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class CommitNotFound extends CommitNotFound_base {
+}
+declare const GitRevListFailed_base: Schema.TaggedErrorClass<GitRevListFailed, "GitRevListFailed", {
+    readonly _tag: Schema.tag<"GitRevListFailed">;
+} & {
+    repoPath: typeof Schema.String;
+    fromSha: typeof Schema.String;
+    toSha: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class GitRevListFailed extends GitRevListFailed_base {
+}
+export type RegistryError = DuplicateSignalIdError | MissingDependencyError | CycleDetectedError | CompositionTooDeepError;
+export type SignalError = UnknownSignalIdError | UnknownSignalFactorError | ConfigValidationError | ReferenceDataMissingError | SignalComputeError;
+export type ScoringEngineError = WorktreeCreateFailed | WorktreeRemoveFailed | CommitNotFound | GitRevListFailed | ReferenceDataLoadFailed | TimeSeriesError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;AAE7D,qBAAa,sBAAuB,SAAQ,2BAG3C;CAAG;;;;;;;AAEJ,qBAAa,sBAAuB,SAAQ,2BAM3C;CAAG;;;;;;AAEJ,qBAAa,kBAAmB,SAAQ,uBAGvC;CAAG;;;;;;;;AAEJ,qBAAa,uBAAwB,SAAQ,4BAO5C;CAAG;;;;;;AAEJ,qBAAa,oBAAqB,SAAQ,yBAGzC;CAAG;;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAM7C;CAAG;;;;;;;AAEJ,qBAAa,qBAAsB,SAAQ,0BAM1C;CAAG;;;;;;;AAEJ,qBAAa,yBAA0B,SAAQ,8BAM9C;CAAG;;;;;;;;AAEJ,qBAAa,uBAAwB,SAAQ,4BAO5C;CAAG;;;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAO7C;CAAG;;;;;;;;AAEJ,qBAAa,kBAAmB,SAAQ,uBAOvC;CAAG;;;;;;;;AAEJ,qBAAa,oBAAqB,SAAQ,yBAOzC;CAAG;;;;;;;AAEJ,qBAAa,oBAAqB,SAAQ,yBAMzC;CAAG;;;;;;;;AAEJ,qBAAa,cAAe,SAAQ,mBAOnC;CAAG;;;;;;;;;AAEJ,qBAAa,gBAAiB,SAAQ,qBAQrC;CAAG;AAEJ,MAAM,MAAM,aAAa,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,CAAA;AAE3B,MAAM,MAAM,WAAW,GACnB,oBAAoB,GACpB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,CAAA;AAEtB,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,uBAAuB,GACvB,eAAe,CAAA"}

package/dist/errors.js

@@ -0,0 +1,76 @@
+import { Schema } from "effect";
+export class DuplicateSignalIdError extends Schema.TaggedError()("DuplicateSignalIdError", { id: Schema.String }) {
+}
+export class MissingDependencyError extends Schema.TaggedError()("MissingDependencyError", {
+    signalId: Schema.String,
+    missingInputId: Schema.String,
+}) {
+}
+export class CycleDetectedError extends Schema.TaggedError()("CycleDetectedError", { chain: Schema.Array(Schema.String) }) {
+}
+export class CompositionTooDeepError extends Schema.TaggedError()("CompositionTooDeepError", {
+    signalId: Schema.String,
+    depth: Schema.Number,
+    max: Schema.Number,
+}) {
+}
+export class UnknownSignalIdError extends Schema.TaggedError()("UnknownSignalIdError", { id: Schema.String }) {
+}
+export class UnknownSignalFactorError extends Schema.TaggedError()("UnknownSignalFactorError", {
+    signalId: Schema.String,
+    factorPath: Schema.String,
+}) {
+}
+export class ConfigValidationError extends Schema.TaggedError()("ConfigValidationError", {
+    signalId: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class ReferenceDataMissingError extends Schema.TaggedError()("ReferenceDataMissingError", {
+    signalId: Schema.String,
+    key: Schema.String,
+}) {
+}
+export class ReferenceDataLoadFailed extends Schema.TaggedError()("ReferenceDataLoadFailed", {
+    repoPath: Schema.String,
+    path: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class RoutingPatternLoadFailed extends Schema.TaggedError()("RoutingPatternLoadFailed", {
+    repoPath: Schema.String,
+    path: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class SignalComputeError extends Schema.TaggedError()("SignalComputeError", {
+    signalId: Schema.String,
+    message: Schema.String,
+    cause: Schema.optional(Schema.Unknown),
+}) {
+}
+export class WorktreeCreateFailed extends Schema.TaggedError()("WorktreeCreateFailed", {
+    repoPath: Schema.String,
+    sha: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class WorktreeRemoveFailed extends Schema.TaggedError()("WorktreeRemoveFailed", {
+    worktreePath: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class CommitNotFound extends Schema.TaggedError()("CommitNotFound", {
+    repoPath: Schema.String,
+    sha: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class GitRevListFailed extends Schema.TaggedError()("GitRevListFailed", {
+    repoPath: Schema.String,
+    fromSha: Schema.String,
+    toSha: Schema.String,
+    message: Schema.String,
+}) {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/factor-ledger.d.ts

@@ -0,0 +1,38 @@
+import { Context } from "effect";
+import type { SignalFactorDefinition, SignalFactorLedger, SignalFactorLedgerEntry, SignalFactorValue } from "./signal-factor-model.js";
+import type { AnySignal } from "./signal.js";
+import { type PulsarVector, type SignalFactorOverrideMap } from "./vector.js";
+export declare const SIGNAL_FACTOR_POLICY_PRECEDENCE: readonly ["signal-default", "module", "vector"];
+interface SignalFactorPolicyContext {
+    readonly signalId: string;
+    readonly precedence: typeof SIGNAL_FACTOR_POLICY_PRECEDENCE;
+    readonly vectorOverrides: SignalFactorOverrideMap;
+    readonly vectorSourceRef?: string;
+}
+declare const SignalFactorPolicyTag_base: Context.TagClass<SignalFactorPolicyTag, "@skastr0/pulsar-core/SignalFactorPolicy", SignalFactorPolicyContext>;
+export declare class SignalFactorPolicyTag extends SignalFactorPolicyTag_base {
+}
+export declare const makeSignalFactorPolicyContext: (signal: AnySignal, vector?: PulsarVector, options?: {
+    readonly vectorSourceRef?: string;
+}) => SignalFactorPolicyContext;
+export declare const withConfigFactorLedger: <S extends AnySignal>(signal: S) => S;
+interface FactorDefinitionValidationIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare const validateFactorDefinitions: (definitions: ReadonlyArray<SignalFactorDefinition>) => ReadonlyArray<FactorDefinitionValidationIssue>;
+export declare const assertValidFactorDefinitions: (definitions: ReadonlyArray<SignalFactorDefinition>) => void;
+export declare const makeFactorEntry: (definition: SignalFactorDefinition, value: SignalFactorValue, options?: {
+    readonly source?: SignalFactorLedgerEntry["source"];
+    readonly affectsScore?: boolean;
+    readonly attribution?: SignalFactorLedgerEntry["attribution"];
+}) => SignalFactorLedgerEntry;
+export declare const makeFactorLedger: (signalId: string, entries: ReadonlyArray<SignalFactorLedgerEntry>) => SignalFactorLedger;
+export declare const applyFactorOverrides: (entries: ReadonlyArray<SignalFactorLedgerEntry>, overrides: SignalFactorOverrideMap, options?: {
+    readonly sourceRef?: string;
+    readonly ruleId?: string;
+}) => ReadonlyArray<SignalFactorLedgerEntry>;
+export declare const applySignalFactorPolicy: (ledger: SignalFactorLedger, policy: SignalFactorPolicyContext) => SignalFactorLedger;
+export declare const overriddenFactorValue: <Value extends SignalFactorValue>(path: string, defaultValue: Value, overrides: SignalFactorOverrideMap) => Value | SignalFactorValue;
+export {};
+//# sourceMappingURL=factor-ledger.d.ts.map

package/dist/factor-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factor-ledger.d.ts","sourceRoot":"","sources":["../src/factor-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EAEvB,iBAAiB,EAClB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAA;AAIpB,eAAO,MAAM,+BAA+B,iDAIlC,CAAA;AAEV,UAAU,yBAAyB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,+BAA+B,CAAA;IAC3D,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAA;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;;AAED,qBAAa,qBAAsB,SAAQ,0BAEU;CAAG;AAExD,eAAO,MAAM,6BAA6B,GACxC,QAAQ,SAAS,EACjB,SAAS,YAAY,EACrB,UAAU;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,KAC9C,yBAOD,CAAA;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,SAAS,EAAE,QAAQ,CAAC,KAAG,CAuBvE,CAAA;AAwED,UAAU,+BAA+B;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,yBAAyB,GACpC,aAAa,aAAa,CAAC,sBAAsB,CAAC,KACjD,aAAa,CAAC,+BAA+B,CAsB/C,CAAA;AAED,eAAO,MAAM,4BAA4B,GACvC,aAAa,aAAa,CAAC,sBAAsB,CAAC,KACjD,IAKF,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,YAAY,sBAAsB,EAClC,OAAO,iBAAiB,EACxB,UAAU;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAA;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAA;CAC9D,KACA,uBAQD,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,SAAS,aAAa,CAAC,uBAAuB,CAAC,KAC9C,kBAGD,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,aAAa,CAAC,uBAAuB,CAAC,EAC/C,WAAW,uBAAuB,EAClC,UAAU;IACR,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KACA,aAAa,CAAC,uBAAuB,CA4BpC,CAAA;AAEJ,eAAO,MAAM,uBAAuB,GAClC,QAAQ,kBAAkB,EAC1B,QAAQ,yBAAyB,KAChC,kBAKD,CAAA;AAEF,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,iBAAiB,EACnE,MAAM,MAAM,EACZ,cAAc,KAAK,EACnB,WAAW,uBAAuB,KACjC,KAAK,GAAG,iBACgE,CAAA"}

package/dist/factor-ledger.js

@@ -0,0 +1,184 @@
+import { Context } from "effect";
+import { factorOverridesOf, } from "./vector.js";
+const FACTOR_PATH_PATTERN = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;
+export const SIGNAL_FACTOR_POLICY_PRECEDENCE = [
+    "signal-default",
+    "module",
+    "vector",
+];
+export class SignalFactorPolicyTag extends Context.Tag("@skastr0/pulsar-core/SignalFactorPolicy")() {
+}
+export const makeSignalFactorPolicyContext = (signal, vector, options) => ({
+    signalId: signal.id,
+    precedence: SIGNAL_FACTOR_POLICY_PRECEDENCE,
+    vectorOverrides: factorOverridesOf(signal, vector),
+    ...(options?.vectorSourceRef !== undefined
+        ? { vectorSourceRef: options.vectorSourceRef }
+        : {}),
+});
+export const withConfigFactorLedger = (signal) => {
+    const configDefinitions = configFactorDefinitions(signal);
+    if (configDefinitions.length === 0)
+        return signal;
+    const existingDefinitions = signal.factorDefinitions ?? [];
+    const existingPaths = new Set(existingDefinitions.map((definition) => definition.path));
+    const extraDefinitions = configDefinitions.filter((definition) => !existingPaths.has(definition.path));
+    if (extraDefinitions.length === 0)
+        return signal;
+    return {
+        ...signal,
+        factorDefinitions: [...existingDefinitions, ...extraDefinitions],
+        factorLedger: (output) => {
+            const existingLedger = signal.factorLedger?.(output);
+            return makeFactorLedger(signal.id, [
+                ...(existingLedger?.entries ?? []),
+                ...extraDefinitions.map((definition) => makeFactorEntry(definition, definition.defaultValue ?? null, {
+                    source: "signal-default",
+                })),
+            ]);
+        },
+    };
+};
+const configFactorDefinitions = (signal) => {
+    const config = signal.defaultConfig;
+    if (config === null || typeof config !== "object" || Array.isArray(config))
+        return [];
+    return Object.entries(config)
+        .flatMap(([key, value]) => {
+        const factorValue = toSignalFactorValue(value);
+        if (factorValue === undefined)
+            return [];
+        return [{
+                path: `config.${normalizeFactorPathSegment(key)}`,
+                title: `Config ${key.replaceAll("_", " ")}`,
+                valueKind: signalFactorValueKind(factorValue),
+                scoreRole: configScoreRole(key, factorValue),
+                defaultValue: factorValue,
+            }];
+    });
+};
+const normalizeFactorPathSegment = (value) => value
+    .replace(/[A-Z]/g, (match) => `_${match.toLowerCase()}`)
+    .replace(/[^a-zA-Z0-9._-]+/g, "_")
+    .replace(/^_+|_+$/g, "")
+    .toLowerCase();
+const configScoreRole = (key, value) => {
+    if (typeof value === "number")
+        return key.includes("weight") ? "weight" : "threshold";
+    if (typeof value === "boolean")
+        return "threshold";
+    return "metadata";
+};
+const signalFactorValueKind = (value) => {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    if (typeof value === "object")
+        return "object";
+    if (typeof value === "string")
+        return "string";
+    if (typeof value === "number")
+        return "number";
+    return "boolean";
+};
+const toSignalFactorValue = (value) => {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const items = value.map(toSignalFactorValue);
+        return items.every((item) => item !== undefined)
+            ? items
+            : undefined;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value)
+            .map(([key, item]) => [key, toSignalFactorValue(item)]);
+        if (!entries.every((entry) => entry[1] !== undefined)) {
+            return undefined;
+        }
+        return Object.fromEntries(entries);
+    }
+    return undefined;
+};
+export const validateFactorDefinitions = (definitions) => {
+    const issues = [];
+    const seen = new Set();
+    for (const definition of definitions) {
+        if (!FACTOR_PATH_PATTERN.test(definition.path)) {
+            issues.push({
+                path: definition.path,
+                message: "Factor paths must be stable lowercase dot/underscore/hyphen paths.",
+            });
+        }
+        if (seen.has(definition.path)) {
+            issues.push({
+                path: definition.path,
+                message: "Factor path is declared more than once.",
+            });
+        }
+        seen.add(definition.path);
+    }
+    return issues;
+};
+export const assertValidFactorDefinitions = (definitions) => {
+    const issues = validateFactorDefinitions(definitions);
+    if (issues.length === 0)
+        return;
+    const detail = issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ");
+    throw new Error(`Invalid signal factor definitions: ${detail}`);
+};
+export const makeFactorEntry = (definition, value, options) => ({
+    path: definition.path,
+    title: definition.title,
+    scoreRole: definition.scoreRole,
+    value,
+    source: options?.source ?? "computed",
+    affectsScore: options?.affectsScore ?? definition.scoreRole !== "metadata",
+    ...(options?.attribution !== undefined ? { attribution: options.attribution } : {}),
+});
+export const makeFactorLedger = (signalId, entries) => ({
+    signalId,
+    entries: [...entries].sort((left, right) => left.path.localeCompare(right.path)),
+});
+export const applyFactorOverrides = (entries, overrides, options) => entries.map((entry) => {
+    if (!Object.hasOwn(overrides, entry.path))
+        return entry;
+    const nextValue = overrides[entry.path] ?? null;
+    if (entry.source === "vector" && Object.is(entry.value, nextValue)) {
+        return entry;
+    }
+    const ruleId = options?.ruleId ?? "vector.factor-override";
+    const mutation = {
+        path: entry.path,
+        source: "vector",
+        action: entry.source === "module" ? "override-module-factor" : "override-factor",
+        before: entry.value,
+        after: nextValue,
+        ruleId,
+        ...(options?.sourceRef !== undefined ? { sourceRef: options.sourceRef } : {}),
+    };
+    return {
+        ...entry,
+        value: nextValue,
+        source: "vector",
+        attribution: {
+            ...entry.attribution,
+            ruleId,
+            ...(mutation.sourceRef !== undefined ? { sourceRef: mutation.sourceRef } : {}),
+        },
+        mutations: [...(entry.mutations ?? []), mutation],
+    };
+});
+export const applySignalFactorPolicy = (ledger, policy) => ({
+    signalId: ledger.signalId,
+    entries: applyFactorOverrides(ledger.entries, policy.vectorOverrides, {
+        ...(policy.vectorSourceRef !== undefined ? { sourceRef: policy.vectorSourceRef } : {}),
+    }),
+});
+export const overriddenFactorValue = (path, defaultValue, overrides) => Object.hasOwn(overrides, path) ? (overrides[path] ?? null) : defaultValue;
+//# sourceMappingURL=factor-ledger.js.map