margin-ts 0.6.2 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -0
- package/dist/adapters/stream.d.ts +5 -2
- package/dist/adapters/stream.d.ts.map +1 -1
- package/dist/adapters/stream.js +15 -5
- package/dist/adapters/stream.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +6 -1
- package/dist/index.js.map +1 -1
- package/dist/observation.d.ts +15 -0
- package/dist/observation.d.ts.map +1 -1
- package/dist/observation.js +58 -2
- package/dist/observation.js.map +1 -1
- package/package.json +9 -2
- package/src/adapters/stream.ts +19 -5
- package/src/index.ts +3 -1
- package/src/observation.ts +56 -1
package/README.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# margin
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/margin-ts)
|
|
4
|
+
[](https://www.npmjs.com/package/margin-ts)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
|
|
3
7
|
**Typed health classification for systems that measure things.**
|
|
4
8
|
|
|
5
9
|
TypeScript port of the [Python margin library](https://github.com/sethc5/margin). Zero dependencies.
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
* Zero dependencies. Works with any framework that supports
|
|
20
20
|
* writable response streams (Express, Fastify, Next.js, raw Node http).
|
|
21
21
|
*/
|
|
22
|
-
import { Expression, Parser, DriftClassification, AnomalyClassification } from '../index.js';
|
|
22
|
+
import { Absence, Expression, Parser, DriftClassification, AnomalyClassification } from '../index.js';
|
|
23
23
|
export declare class StreamingMonitor {
|
|
24
24
|
private parser;
|
|
25
25
|
private windows;
|
|
@@ -33,7 +33,10 @@ export declare class StreamingMonitor {
|
|
|
33
33
|
});
|
|
34
34
|
get expression(): Expression | null;
|
|
35
35
|
get step(): number;
|
|
36
|
-
update(values: Record<string, number>,
|
|
36
|
+
update(values: Record<string, number>, nowOrOptions?: Date | {
|
|
37
|
+
now?: Date;
|
|
38
|
+
absences?: Record<string, Absence>;
|
|
39
|
+
}): Expression;
|
|
37
40
|
drift(component: string): DriftClassification | null;
|
|
38
41
|
anomaly(component: string): AnomalyClassification | null;
|
|
39
42
|
status(): Record<string, unknown>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/adapters/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,
|
|
1
|
+
{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/adapters/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,OAAO,EAEP,UAAU,EACV,MAAM,EAMN,mBAAmB,EAInB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAYrB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO;IAMrF,IAAI,UAAU,IAAI,UAAU,GAAG,IAAI,CAA6B;IAChE,IAAI,IAAI,IAAI,MAAM,CAAuB;IAEzC,MAAM,CACJ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,CAAC,EAAE,IAAI,GAAG;QAAE,GAAG,CAAC,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACvE,UAAU;IAiCb,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAMpD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAQxD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBjC,KAAK,IAAI,IAAI;CAKd;AAeD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAWzD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAoBjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAIlF;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,gDAAgD;AAChD,wBAAgB,YAAY,IAAI,IAAI,CAMnC"}
|
package/dist/adapters/stream.js
CHANGED
|
@@ -43,18 +43,28 @@ class StreamingMonitor {
|
|
|
43
43
|
}
|
|
44
44
|
get expression() { return this._expression; }
|
|
45
45
|
get step() { return this._step; }
|
|
46
|
-
update(values,
|
|
47
|
-
|
|
48
|
-
|
|
46
|
+
update(values, nowOrOptions) {
|
|
47
|
+
let now;
|
|
48
|
+
let absences;
|
|
49
|
+
if (nowOrOptions instanceof Date) {
|
|
50
|
+
now = nowOrOptions;
|
|
51
|
+
}
|
|
52
|
+
else {
|
|
53
|
+
now = nowOrOptions?.now ?? new Date();
|
|
54
|
+
absences = nowOrOptions?.absences;
|
|
55
|
+
}
|
|
56
|
+
this._expression = this.parser.parse(values, { step: this._step, absences });
|
|
49
57
|
this._step++;
|
|
50
|
-
// Update per-component windows
|
|
58
|
+
// Update per-component windows (skip absent observations —
|
|
59
|
+
// they carry no measured value and would corrupt drift/anomaly windows)
|
|
51
60
|
for (const obs of this._expression.observations) {
|
|
61
|
+
if ((0, index_js_1.isAbsent)(obs))
|
|
62
|
+
continue;
|
|
52
63
|
if (!this.windows.has(obs.name)) {
|
|
53
64
|
this.windows.set(obs.name, { values: [], observations: [], maxWindow: this.maxWindow });
|
|
54
65
|
}
|
|
55
66
|
const w = this.windows.get(obs.name);
|
|
56
67
|
w.values.push(obs.value);
|
|
57
|
-
// Stamp the observation with time for drift
|
|
58
68
|
const stamped = { ...obs, measuredAt: now };
|
|
59
69
|
w.observations.push(stamped);
|
|
60
70
|
if (w.values.length > this.maxWindow) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/adapters/stream.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;
|
|
1
|
+
{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/adapters/stream.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*/
|
|
9
9
|
export { Confidence, confidenceRank, confidenceGte, confidenceLt, minConfidence } from './confidence.js';
|
|
10
10
|
export { Health, SEVERITY, Thresholds, createThresholds, isIntact, isAblated, classify, } from './health.js';
|
|
11
|
-
export { Op, Observation, Correction, Expression, observationSigma, observationToAtom, observationToDict, observationFromDict, correctionIsActive, createExpression, healthOf, degraded, expressionToString, expressionToDict, Parser, } from './observation.js';
|
|
11
|
+
export { Absence, Op, Observation, Correction, Expression, isAbsent, observationSigma, observationToAtom, observationToDict, observationFromDict, correctionIsActive, createExpression, healthOf, degraded, absent, intact, expressionToString, expressionToDict, Parser, } from './observation.js';
|
|
12
12
|
export { DriftState, DriftDirection, DriftClassification, classifyDrift, } from './drift.js';
|
|
13
13
|
export { AnomalyState, ANOMALY_SEVERITY, AnomalyClassification, classifyAnomaly, } from './anomaly.js';
|
|
14
14
|
export { marginMiddleware, marginHealthRoute, DEFAULT_THRESHOLDS as EXPRESS_THRESHOLDS, type MarginMiddlewareOptions, type MarginState, type EndpointThresholds, } from './adapters/express.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzG,OAAO,EACL,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAC9C,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EACvC,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAC3E,kBAAkB,EAClB,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzG,OAAO,EACL,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAC9C,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EACvC,QAAQ,EACR,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAC3E,kBAAkB,EAClB,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAC1F,MAAM,GACP,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAC/C,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EACrD,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAAE,iBAAiB,EACnC,kBAAkB,IAAI,kBAAkB,EACxC,KAAK,uBAAuB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,GACxE,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EAAE,iBAAiB,EAChC,wBAAwB,EACxB,KAAK,YAAY,EAAE,KAAK,eAAe,GACxC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,UAAU,EAAE,aAAa,EACzB,mBAAmB,EAAE,sBAAsB,EAC3C,WAAW,EACX,yBAAyB,EACzB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,GAC9C,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAClD,gBAAgB,EAAE,YAAY,GAC/B,MAAM,sBAAsB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
* Copyright (c) 2026 Cope Labs LLC. MIT License.
|
|
9
9
|
*/
|
|
10
10
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
11
|
-
exports.
|
|
11
|
+
exports.marginPoll = exports.marginSSEHandler = exports.marginSSE = exports.broadcast = exports.StreamingMonitor = exports.DEFAULT_NEXTJS_THRESHOLDS = exports.resetRoutes = exports.marginHealthAppHandler = exports.marginHealthHandler = exports.withMarginApp = exports.withMargin = exports.DEFAULT_SUITE_THRESHOLDS = exports.suiteHealthString = exports.classifySuite = exports.EXPRESS_THRESHOLDS = exports.marginHealthRoute = exports.marginMiddleware = exports.classifyAnomaly = exports.ANOMALY_SEVERITY = exports.AnomalyState = exports.classifyDrift = exports.DriftDirection = exports.DriftState = exports.Parser = exports.expressionToDict = exports.expressionToString = exports.intact = exports.absent = exports.degraded = exports.healthOf = exports.createExpression = exports.correctionIsActive = exports.observationFromDict = exports.observationToDict = exports.observationToAtom = exports.observationSigma = exports.isAbsent = exports.Op = exports.Absence = exports.classify = exports.isAblated = exports.isIntact = exports.createThresholds = exports.SEVERITY = exports.Health = exports.minConfidence = exports.confidenceLt = exports.confidenceGte = exports.confidenceRank = exports.Confidence = void 0;
|
|
12
|
+
exports.resetClients = exports.connectedClients = void 0;
|
|
12
13
|
var confidence_js_1 = require("./confidence.js");
|
|
13
14
|
Object.defineProperty(exports, "Confidence", { enumerable: true, get: function () { return confidence_js_1.Confidence; } });
|
|
14
15
|
Object.defineProperty(exports, "confidenceRank", { enumerable: true, get: function () { return confidence_js_1.confidenceRank; } });
|
|
@@ -23,7 +24,9 @@ Object.defineProperty(exports, "isIntact", { enumerable: true, get: function ()
|
|
|
23
24
|
Object.defineProperty(exports, "isAblated", { enumerable: true, get: function () { return health_js_1.isAblated; } });
|
|
24
25
|
Object.defineProperty(exports, "classify", { enumerable: true, get: function () { return health_js_1.classify; } });
|
|
25
26
|
var observation_js_1 = require("./observation.js");
|
|
27
|
+
Object.defineProperty(exports, "Absence", { enumerable: true, get: function () { return observation_js_1.Absence; } });
|
|
26
28
|
Object.defineProperty(exports, "Op", { enumerable: true, get: function () { return observation_js_1.Op; } });
|
|
29
|
+
Object.defineProperty(exports, "isAbsent", { enumerable: true, get: function () { return observation_js_1.isAbsent; } });
|
|
27
30
|
Object.defineProperty(exports, "observationSigma", { enumerable: true, get: function () { return observation_js_1.observationSigma; } });
|
|
28
31
|
Object.defineProperty(exports, "observationToAtom", { enumerable: true, get: function () { return observation_js_1.observationToAtom; } });
|
|
29
32
|
Object.defineProperty(exports, "observationToDict", { enumerable: true, get: function () { return observation_js_1.observationToDict; } });
|
|
@@ -32,6 +35,8 @@ Object.defineProperty(exports, "correctionIsActive", { enumerable: true, get: fu
|
|
|
32
35
|
Object.defineProperty(exports, "createExpression", { enumerable: true, get: function () { return observation_js_1.createExpression; } });
|
|
33
36
|
Object.defineProperty(exports, "healthOf", { enumerable: true, get: function () { return observation_js_1.healthOf; } });
|
|
34
37
|
Object.defineProperty(exports, "degraded", { enumerable: true, get: function () { return observation_js_1.degraded; } });
|
|
38
|
+
Object.defineProperty(exports, "absent", { enumerable: true, get: function () { return observation_js_1.absent; } });
|
|
39
|
+
Object.defineProperty(exports, "intact", { enumerable: true, get: function () { return observation_js_1.intact; } });
|
|
35
40
|
Object.defineProperty(exports, "expressionToString", { enumerable: true, get: function () { return observation_js_1.expressionToString; } });
|
|
36
41
|
Object.defineProperty(exports, "expressionToDict", { enumerable: true, get: function () { return observation_js_1.expressionToDict; } });
|
|
37
42
|
Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return observation_js_1.Parser; } });
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;AAEH,iDAAyG;AAAhG,2GAAA,UAAU,OAAA;AAAE,+GAAA,cAAc,OAAA;AAAE,8GAAA,aAAa,OAAA;AAAE,6GAAA,YAAY,OAAA;AAAE,8GAAA,aAAa,OAAA;AAE/E,yCAGqB;AAFnB,mGAAA,MAAM,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAAc,6GAAA,gBAAgB,OAAA;AAC9C,qGAAA,QAAQ,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAG/B,mDAQ0B;AAPxB,yGAAA,OAAO,OAAA;AACP,oGAAA,EAAE,OAAA;AACF,0GAAA,QAAQ,OAAA;AACR,kHAAA,gBAAgB,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC3E,oHAAA,kBAAkB,OAAA;AAClB,kHAAA,gBAAgB,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAAE,wGAAA,MAAM,OAAA;AAAE,wGAAA,MAAM,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAC1F,wGAAA,MAAM,OAAA;AAGR,uCAGoB;AAFlB,sGAAA,UAAU,OAAA;AAAE,0GAAA,cAAc,OAAA;AAC1B,yGAAA,aAAa,OAAA;AAGf,2CAGsB;AAFpB,0GAAA,YAAY,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAC9B,6GAAA,eAAe,OAAA;AAGjB,WAAW;AACX,oDAI+B;AAH7B,8GAAA,gBAAgB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AACnC,gHAAA,kBAAkB,OAAsB;AAI1C,kDAI8B;AAH5B,0GAAA,aAAa,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAChC,qHAAA,wBAAwB,OAAA;AAI1B,kDAM8B;AAL5B,uGAAA,UAAU,OAAA;AAAE,0GAAA,aAAa,OAAA;AACzB,gHAAA,mBAAmB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAC3C,wGAAA,WAAW,OAAA;AACX,sHAAA,yBAAyB,OAAA;AAI3B,kDAI8B;AAH5B,6GAAA,gBAAgB,OAAA;AAChB,sGAAA,SAAS,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,uGAAA,UAAU,OAAA;AAClD,6GAAA,gBAAgB,OAAA;AAAE,yGAAA,YAAY,OAAA"}
|
package/dist/observation.d.ts
CHANGED
|
@@ -3,6 +3,15 @@
|
|
|
3
3
|
*/
|
|
4
4
|
import { Confidence } from './confidence.js';
|
|
5
5
|
import { Health, Thresholds } from './health.js';
|
|
6
|
+
export declare enum Absence {
|
|
7
|
+
NOT_MEASURED = "not_measured",
|
|
8
|
+
BELOW_DETECTION = "below_detection",
|
|
9
|
+
ABOVE_RANGE = "above_range",
|
|
10
|
+
SENSOR_FAILED = "sensor_failed",
|
|
11
|
+
REDACTED = "redacted",
|
|
12
|
+
NOT_APPLICABLE = "not_applicable",
|
|
13
|
+
PENDING = "pending"
|
|
14
|
+
}
|
|
6
15
|
export interface Observation {
|
|
7
16
|
name: string;
|
|
8
17
|
health: Health;
|
|
@@ -12,7 +21,10 @@ export interface Observation {
|
|
|
12
21
|
higherIsBetter: boolean;
|
|
13
22
|
provenance: string[];
|
|
14
23
|
measuredAt?: Date;
|
|
24
|
+
absence?: Absence;
|
|
25
|
+
absenceDetail?: string;
|
|
15
26
|
}
|
|
27
|
+
export declare function isAbsent(obs: Observation): boolean;
|
|
16
28
|
export declare function observationSigma(obs: Observation): number;
|
|
17
29
|
export declare function observationToAtom(obs: Observation): string;
|
|
18
30
|
export declare function observationToDict(obs: Observation): Record<string, unknown>;
|
|
@@ -42,6 +54,8 @@ export interface Expression {
|
|
|
42
54
|
export declare function createExpression(observations?: Observation[], corrections?: Correction[], label?: string, step?: number): Expression;
|
|
43
55
|
export declare function healthOf(expr: Expression, name: string): Health | undefined;
|
|
44
56
|
export declare function degraded(expr: Expression): Observation[];
|
|
57
|
+
export declare function absent(expr: Expression): Observation[];
|
|
58
|
+
export declare function intact(expr: Expression): Observation[];
|
|
45
59
|
export declare function expressionToString(expr: Expression): string;
|
|
46
60
|
export declare function expressionToDict(expr: Expression): Record<string, unknown>;
|
|
47
61
|
export declare class Parser {
|
|
@@ -54,6 +68,7 @@ export declare class Parser {
|
|
|
54
68
|
label?: string;
|
|
55
69
|
step?: number;
|
|
56
70
|
confidences?: Record<string, Confidence>;
|
|
71
|
+
absences?: Record<string, Absence>;
|
|
57
72
|
}): Expression;
|
|
58
73
|
}
|
|
59
74
|
//# sourceMappingURL=observation.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAkD,MAAM,aAAa,CAAC;AAMjG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"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"}
|
package/dist/observation.js
CHANGED
|
@@ -3,7 +3,8 @@
|
|
|
3
3
|
* Observations, corrections, expressions, and parser.
|
|
4
4
|
*/
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.Parser = exports.Op = void 0;
|
|
6
|
+
exports.Parser = exports.Op = exports.Absence = void 0;
|
|
7
|
+
exports.isAbsent = isAbsent;
|
|
7
8
|
exports.observationSigma = observationSigma;
|
|
8
9
|
exports.observationToAtom = observationToAtom;
|
|
9
10
|
exports.observationToDict = observationToDict;
|
|
@@ -12,10 +13,28 @@ exports.correctionIsActive = correctionIsActive;
|
|
|
12
13
|
exports.createExpression = createExpression;
|
|
13
14
|
exports.healthOf = healthOf;
|
|
14
15
|
exports.degraded = degraded;
|
|
16
|
+
exports.absent = absent;
|
|
17
|
+
exports.intact = intact;
|
|
15
18
|
exports.expressionToString = expressionToString;
|
|
16
19
|
exports.expressionToDict = expressionToDict;
|
|
17
20
|
const confidence_js_1 = require("./confidence.js");
|
|
18
21
|
const health_js_1 = require("./health.js");
|
|
22
|
+
// -----------------------------------------------------------------------
|
|
23
|
+
// Absence — why a value is missing
|
|
24
|
+
// -----------------------------------------------------------------------
|
|
25
|
+
var Absence;
|
|
26
|
+
(function (Absence) {
|
|
27
|
+
Absence["NOT_MEASURED"] = "not_measured";
|
|
28
|
+
Absence["BELOW_DETECTION"] = "below_detection";
|
|
29
|
+
Absence["ABOVE_RANGE"] = "above_range";
|
|
30
|
+
Absence["SENSOR_FAILED"] = "sensor_failed";
|
|
31
|
+
Absence["REDACTED"] = "redacted";
|
|
32
|
+
Absence["NOT_APPLICABLE"] = "not_applicable";
|
|
33
|
+
Absence["PENDING"] = "pending";
|
|
34
|
+
})(Absence || (exports.Absence = Absence = {}));
|
|
35
|
+
function isAbsent(obs) {
|
|
36
|
+
return obs.absence !== undefined;
|
|
37
|
+
}
|
|
19
38
|
function observationSigma(obs) {
|
|
20
39
|
if (obs.baseline === 0)
|
|
21
40
|
return 0;
|
|
@@ -23,6 +42,8 @@ function observationSigma(obs) {
|
|
|
23
42
|
return obs.higherIsBetter ? raw : -raw;
|
|
24
43
|
}
|
|
25
44
|
function observationToAtom(obs) {
|
|
45
|
+
if (obs.absence !== undefined)
|
|
46
|
+
return `${obs.name}:ABSENT(${obs.absence})`;
|
|
26
47
|
if (obs.health === health_js_1.Health.OOD)
|
|
27
48
|
return `${obs.name}:${obs.health}`;
|
|
28
49
|
const sigma = observationSigma(obs);
|
|
@@ -42,10 +63,14 @@ function observationToDict(obs) {
|
|
|
42
63
|
};
|
|
43
64
|
if (obs.measuredAt)
|
|
44
65
|
d.measuredAt = obs.measuredAt.toISOString();
|
|
66
|
+
if (obs.absence !== undefined)
|
|
67
|
+
d.absence = obs.absence;
|
|
68
|
+
if (obs.absenceDetail !== undefined)
|
|
69
|
+
d.absenceDetail = obs.absenceDetail;
|
|
45
70
|
return d;
|
|
46
71
|
}
|
|
47
72
|
function observationFromDict(d) {
|
|
48
|
-
|
|
73
|
+
const obs = {
|
|
49
74
|
name: d.name,
|
|
50
75
|
health: d.health,
|
|
51
76
|
value: d.value,
|
|
@@ -55,6 +80,11 @@ function observationFromDict(d) {
|
|
|
55
80
|
provenance: d.provenance ?? [],
|
|
56
81
|
measuredAt: d.measuredAt ? new Date(d.measuredAt) : undefined,
|
|
57
82
|
};
|
|
83
|
+
if (d.absence !== undefined)
|
|
84
|
+
obs.absence = d.absence;
|
|
85
|
+
if (d.absenceDetail !== undefined)
|
|
86
|
+
obs.absenceDetail = d.absenceDetail;
|
|
87
|
+
return obs;
|
|
58
88
|
}
|
|
59
89
|
// -----------------------------------------------------------------------
|
|
60
90
|
// Correction
|
|
@@ -81,6 +111,12 @@ function healthOf(expr, name) {
|
|
|
81
111
|
function degraded(expr) {
|
|
82
112
|
return expr.observations.filter(o => o.health === health_js_1.Health.DEGRADED || o.health === health_js_1.Health.ABLATED || o.health === health_js_1.Health.RECOVERING);
|
|
83
113
|
}
|
|
114
|
+
function absent(expr) {
|
|
115
|
+
return expr.observations.filter(o => isAbsent(o));
|
|
116
|
+
}
|
|
117
|
+
function intact(expr) {
|
|
118
|
+
return expr.observations.filter(o => o.health === health_js_1.Health.INTACT);
|
|
119
|
+
}
|
|
84
120
|
function expressionToString(expr) {
|
|
85
121
|
if (expr.observations.length === 0)
|
|
86
122
|
return '[∅]';
|
|
@@ -123,8 +159,11 @@ class Parser {
|
|
|
123
159
|
}
|
|
124
160
|
parse(values, options = {}) {
|
|
125
161
|
const confidences = options.confidences ?? {};
|
|
162
|
+
const absences = options.absences ?? {};
|
|
126
163
|
const observations = [];
|
|
127
164
|
for (const [name, val] of Object.entries(values)) {
|
|
165
|
+
if (name in absences)
|
|
166
|
+
continue; // handled below
|
|
128
167
|
const baseline = this.baselines[name] ?? val;
|
|
129
168
|
const conf = confidences[name] ?? confidence_js_1.Confidence.MODERATE;
|
|
130
169
|
const t = this.thresholdsFor(name);
|
|
@@ -140,6 +179,23 @@ class Parser {
|
|
|
140
179
|
measuredAt: undefined,
|
|
141
180
|
});
|
|
142
181
|
}
|
|
182
|
+
// Emit absent observations
|
|
183
|
+
for (const [name, reason] of Object.entries(absences)) {
|
|
184
|
+
const baseline = this.baselines[name] ?? 0;
|
|
185
|
+
const t = this.thresholdsFor(name);
|
|
186
|
+
const conf = confidences[name] ?? confidence_js_1.Confidence.INDETERMINATE;
|
|
187
|
+
observations.push({
|
|
188
|
+
name,
|
|
189
|
+
health: health_js_1.Health.OOD,
|
|
190
|
+
value: baseline,
|
|
191
|
+
baseline,
|
|
192
|
+
confidence: conf,
|
|
193
|
+
higherIsBetter: t.higherIsBetter !== false,
|
|
194
|
+
provenance: [],
|
|
195
|
+
measuredAt: undefined,
|
|
196
|
+
absence: reason,
|
|
197
|
+
});
|
|
198
|
+
}
|
|
143
199
|
return createExpression(observations, [], options.label ?? '', options.step);
|
|
144
200
|
}
|
|
145
201
|
}
|
package/dist/observation.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":";AAAA;;GAEG;;;
|
|
1
|
+
{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "margin-ts",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"description": "Typed health classification for systems that measure things. Zero dependencies.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -18,7 +18,14 @@
|
|
|
18
18
|
"license": "MIT",
|
|
19
19
|
"repository": {
|
|
20
20
|
"type": "git",
|
|
21
|
-
"url": "https://github.com/sethc5/margin-ts"
|
|
21
|
+
"url": "git+https://github.com/sethc5/margin-ts.git"
|
|
22
|
+
},
|
|
23
|
+
"bugs": {
|
|
24
|
+
"url": "https://github.com/sethc5/margin-ts/issues"
|
|
25
|
+
},
|
|
26
|
+
"homepage": "https://github.com/sethc5/margin-ts#readme",
|
|
27
|
+
"engines": {
|
|
28
|
+
"node": ">=18"
|
|
22
29
|
},
|
|
23
30
|
"files": ["dist", "src"],
|
|
24
31
|
"devDependencies": {
|
package/src/adapters/stream.ts
CHANGED
|
@@ -23,9 +23,11 @@
|
|
|
23
23
|
import {
|
|
24
24
|
Confidence,
|
|
25
25
|
Health,
|
|
26
|
+
Absence,
|
|
26
27
|
Observation,
|
|
27
28
|
Expression,
|
|
28
29
|
Parser,
|
|
30
|
+
isAbsent,
|
|
29
31
|
createExpression,
|
|
30
32
|
expressionToString,
|
|
31
33
|
expressionToDict,
|
|
@@ -65,19 +67,31 @@ export class StreamingMonitor {
|
|
|
65
67
|
get expression(): Expression | null { return this._expression; }
|
|
66
68
|
get step(): number { return this._step; }
|
|
67
69
|
|
|
68
|
-
update(
|
|
69
|
-
|
|
70
|
-
|
|
70
|
+
update(
|
|
71
|
+
values: Record<string, number>,
|
|
72
|
+
nowOrOptions?: Date | { now?: Date; absences?: Record<string, Absence> },
|
|
73
|
+
): Expression {
|
|
74
|
+
let now: Date;
|
|
75
|
+
let absences: Record<string, Absence> | undefined;
|
|
76
|
+
if (nowOrOptions instanceof Date) {
|
|
77
|
+
now = nowOrOptions;
|
|
78
|
+
} else {
|
|
79
|
+
now = nowOrOptions?.now ?? new Date();
|
|
80
|
+
absences = nowOrOptions?.absences;
|
|
81
|
+
}
|
|
82
|
+
this._expression = this.parser.parse(values, { step: this._step, absences });
|
|
71
83
|
this._step++;
|
|
72
84
|
|
|
73
|
-
// Update per-component windows
|
|
85
|
+
// Update per-component windows (skip absent observations —
|
|
86
|
+
// they carry no measured value and would corrupt drift/anomaly windows)
|
|
74
87
|
for (const obs of this._expression.observations) {
|
|
88
|
+
if (isAbsent(obs)) continue;
|
|
89
|
+
|
|
75
90
|
if (!this.windows.has(obs.name)) {
|
|
76
91
|
this.windows.set(obs.name, { values: [], observations: [], maxWindow: this.maxWindow });
|
|
77
92
|
}
|
|
78
93
|
const w = this.windows.get(obs.name)!;
|
|
79
94
|
w.values.push(obs.value);
|
|
80
|
-
// Stamp the observation with time for drift
|
|
81
95
|
const stamped = { ...obs, measuredAt: now };
|
|
82
96
|
w.observations.push(stamped);
|
|
83
97
|
if (w.values.length > this.maxWindow) {
|
package/src/index.ts
CHANGED
|
@@ -15,10 +15,12 @@ export {
|
|
|
15
15
|
} from './health.js';
|
|
16
16
|
|
|
17
17
|
export {
|
|
18
|
+
Absence,
|
|
18
19
|
Op, Observation, Correction, Expression,
|
|
20
|
+
isAbsent,
|
|
19
21
|
observationSigma, observationToAtom, observationToDict, observationFromDict,
|
|
20
22
|
correctionIsActive,
|
|
21
|
-
createExpression, healthOf, degraded, expressionToString, expressionToDict,
|
|
23
|
+
createExpression, healthOf, degraded, absent, intact, expressionToString, expressionToDict,
|
|
22
24
|
Parser,
|
|
23
25
|
} from './observation.js';
|
|
24
26
|
|
package/src/observation.ts
CHANGED
|
@@ -5,6 +5,20 @@
|
|
|
5
5
|
import { Confidence, minConfidence } from './confidence.js';
|
|
6
6
|
import { Health, Thresholds, classify, createThresholds, isIntact, SEVERITY } from './health.js';
|
|
7
7
|
|
|
8
|
+
// -----------------------------------------------------------------------
|
|
9
|
+
// Absence — why a value is missing
|
|
10
|
+
// -----------------------------------------------------------------------
|
|
11
|
+
|
|
12
|
+
export enum Absence {
|
|
13
|
+
NOT_MEASURED = 'not_measured',
|
|
14
|
+
BELOW_DETECTION = 'below_detection',
|
|
15
|
+
ABOVE_RANGE = 'above_range',
|
|
16
|
+
SENSOR_FAILED = 'sensor_failed',
|
|
17
|
+
REDACTED = 'redacted',
|
|
18
|
+
NOT_APPLICABLE = 'not_applicable',
|
|
19
|
+
PENDING = 'pending',
|
|
20
|
+
}
|
|
21
|
+
|
|
8
22
|
// -----------------------------------------------------------------------
|
|
9
23
|
// Observation
|
|
10
24
|
// -----------------------------------------------------------------------
|
|
@@ -18,6 +32,12 @@ export interface Observation {
|
|
|
18
32
|
higherIsBetter: boolean;
|
|
19
33
|
provenance: string[];
|
|
20
34
|
measuredAt?: Date;
|
|
35
|
+
absence?: Absence;
|
|
36
|
+
absenceDetail?: string;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function isAbsent(obs: Observation): boolean {
|
|
40
|
+
return obs.absence !== undefined;
|
|
21
41
|
}
|
|
22
42
|
|
|
23
43
|
export function observationSigma(obs: Observation): number {
|
|
@@ -27,6 +47,7 @@ export function observationSigma(obs: Observation): number {
|
|
|
27
47
|
}
|
|
28
48
|
|
|
29
49
|
export function observationToAtom(obs: Observation): string {
|
|
50
|
+
if (obs.absence !== undefined) return `${obs.name}:ABSENT(${obs.absence})`;
|
|
30
51
|
if (obs.health === Health.OOD) return `${obs.name}:${obs.health}`;
|
|
31
52
|
const sigma = observationSigma(obs);
|
|
32
53
|
const sign = sigma >= 0 ? '+' : '';
|
|
@@ -45,11 +66,13 @@ export function observationToDict(obs: Observation): Record<string, unknown> {
|
|
|
45
66
|
provenance: obs.provenance,
|
|
46
67
|
};
|
|
47
68
|
if (obs.measuredAt) d.measuredAt = obs.measuredAt.toISOString();
|
|
69
|
+
if (obs.absence !== undefined) d.absence = obs.absence;
|
|
70
|
+
if (obs.absenceDetail !== undefined) d.absenceDetail = obs.absenceDetail;
|
|
48
71
|
return d;
|
|
49
72
|
}
|
|
50
73
|
|
|
51
74
|
export function observationFromDict(d: Record<string, unknown>): Observation {
|
|
52
|
-
|
|
75
|
+
const obs: Observation = {
|
|
53
76
|
name: d.name as string,
|
|
54
77
|
health: d.health as Health,
|
|
55
78
|
value: d.value as number,
|
|
@@ -59,6 +82,9 @@ export function observationFromDict(d: Record<string, unknown>): Observation {
|
|
|
59
82
|
provenance: (d.provenance as string[]) ?? [],
|
|
60
83
|
measuredAt: d.measuredAt ? new Date(d.measuredAt as string) : undefined,
|
|
61
84
|
};
|
|
85
|
+
if (d.absence !== undefined) obs.absence = d.absence as Absence;
|
|
86
|
+
if (d.absenceDetail !== undefined) obs.absenceDetail = d.absenceDetail as string;
|
|
87
|
+
return obs;
|
|
62
88
|
}
|
|
63
89
|
|
|
64
90
|
// -----------------------------------------------------------------------
|
|
@@ -119,6 +145,14 @@ export function degraded(expr: Expression): Observation[] {
|
|
|
119
145
|
);
|
|
120
146
|
}
|
|
121
147
|
|
|
148
|
+
export function absent(expr: Expression): Observation[] {
|
|
149
|
+
return expr.observations.filter(o => isAbsent(o));
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
export function intact(expr: Expression): Observation[] {
|
|
153
|
+
return expr.observations.filter(o => o.health === Health.INTACT);
|
|
154
|
+
}
|
|
155
|
+
|
|
122
156
|
export function expressionToString(expr: Expression): string {
|
|
123
157
|
if (expr.observations.length === 0) return '[∅]';
|
|
124
158
|
const parts = expr.observations.map(o => {
|
|
@@ -174,12 +208,15 @@ export class Parser {
|
|
|
174
208
|
label?: string;
|
|
175
209
|
step?: number;
|
|
176
210
|
confidences?: Record<string, Confidence>;
|
|
211
|
+
absences?: Record<string, Absence>;
|
|
177
212
|
} = {},
|
|
178
213
|
): Expression {
|
|
179
214
|
const confidences = options.confidences ?? {};
|
|
215
|
+
const absences = options.absences ?? {};
|
|
180
216
|
const observations: Observation[] = [];
|
|
181
217
|
|
|
182
218
|
for (const [name, val] of Object.entries(values)) {
|
|
219
|
+
if (name in absences) continue; // handled below
|
|
183
220
|
const baseline = this.baselines[name] ?? val;
|
|
184
221
|
const conf = confidences[name] ?? Confidence.MODERATE;
|
|
185
222
|
const t = this.thresholdsFor(name);
|
|
@@ -196,6 +233,24 @@ export class Parser {
|
|
|
196
233
|
});
|
|
197
234
|
}
|
|
198
235
|
|
|
236
|
+
// Emit absent observations
|
|
237
|
+
for (const [name, reason] of Object.entries(absences)) {
|
|
238
|
+
const baseline = this.baselines[name] ?? 0;
|
|
239
|
+
const t = this.thresholdsFor(name);
|
|
240
|
+
const conf = confidences[name] ?? Confidence.INDETERMINATE;
|
|
241
|
+
observations.push({
|
|
242
|
+
name,
|
|
243
|
+
health: Health.OOD,
|
|
244
|
+
value: baseline,
|
|
245
|
+
baseline,
|
|
246
|
+
confidence: conf,
|
|
247
|
+
higherIsBetter: t.higherIsBetter !== false,
|
|
248
|
+
provenance: [],
|
|
249
|
+
measuredAt: undefined,
|
|
250
|
+
absence: reason,
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
|
|
199
254
|
return createExpression(observations, [], options.label ?? '', options.step);
|
|
200
255
|
}
|
|
201
256
|
}
|