margin-ts 0.6.0 → 0.6.1

package/dist/adapters/express.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Express middleware adapter for margin.
+ *
+ * Tracks per-route health: latency, error rate, request rate.
+ * Exposes /margin/health endpoint with typed classifications.
+ *
+ * Usage:
+ *   import express from 'express';
+ *   import { marginMiddleware, marginHealthRoute } from 'margin-ts/adapters/express';
+ *
+ *   const app = express();
+ *   app.use(marginMiddleware());
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Zero dependencies beyond margin-ts core (express types are optional).
+ */
+import { Thresholds } from '../index.js';
+interface RouteMetrics {
+    route: string;
+    totalRequests: number;
+    totalErrors: number;
+    total4xx: number;
+    latencies: number[];
+    timestamps: Date[];
+    maxWindow: number;
+}
+export interface EndpointThresholds {
+    p50Latency: Thresholds;
+    p99Latency: Thresholds;
+    errorRate: Thresholds;
+    requestRate: Thresholds;
+}
+export declare const DEFAULT_THRESHOLDS: EndpointThresholds;
+export interface MarginMiddlewareOptions {
+    /** Track per-route or aggregate only (default: true) */
+    perRoute?: boolean;
+    /** Max latency samples to keep per route (default: 200) */
+    window?: number;
+    /** Custom thresholds */
+    thresholds?: EndpointThresholds;
+    /** Routes to ignore (e.g. ['/margin/health', '/favicon.ico']) */
+    ignore?: string[];
+    /** Normalize route paths: replace numeric segments with :id (default: true) */
+    normalizePaths?: boolean;
+}
+/** The shared state object — accessible for custom endpoints */
+export interface MarginState {
+    routes: Map<string, RouteMetrics>;
+    aggregate: RouteMetrics;
+    options: Required<MarginMiddlewareOptions>;
+}
+/**
+ * Express middleware that tracks request latency and error rates.
+ *
+ * Attach to your app before routes:
+ *   app.use(marginMiddleware());
+ */
+export declare function marginMiddleware(options?: MarginMiddlewareOptions): any;
+export interface HealthResponse {
+    status: string;
+    expression: string;
+    aggregate: Record<string, unknown>;
+    routes?: Record<string, Record<string, unknown>>;
+    drift?: Record<string, unknown>;
+}
+/**
+ * Express route handler for /margin/health.
+ *
+ * Returns typed health classification for all tracked routes.
+ *
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Or pass the middleware directly:
+ *   const mw = marginMiddleware();
+ *   app.use(mw);
+ *   app.get('/margin/health', marginHealthRoute(mw));
+ */
+export declare function marginHealthRoute(middleware?: any): any;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAGL,UAAU,EAcX,MAAM,aAAa,CAAC;AAMrB,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8BD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAKhC,CAAC;AAmFF,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;CAC5C;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,GAAG,CAoD3E;AAMD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,CA4DvD"}

package/dist/adapters/express.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Express middleware adapter for margin.
+ *
+ * Tracks per-route health: latency, error rate, request rate.
+ * Exposes /margin/health endpoint with typed classifications.
+ *
+ * Usage:
+ *   import express from 'express';
+ *   import { marginMiddleware, marginHealthRoute } from 'margin-ts/adapters/express';
+ *
+ *   const app = express();
+ *   app.use(marginMiddleware());
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Zero dependencies beyond margin-ts core (express types are optional).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_THRESHOLDS = void 0;
+exports.marginMiddleware = marginMiddleware;
+exports.marginHealthRoute = marginHealthRoute;
+const index_js_1 = require("../index.js");
+function createRouteMetrics(route, maxWindow = 200) {
+    return {
+        route,
+        totalRequests: 0,
+        totalErrors: 0,
+        total4xx: 0,
+        latencies: [],
+        timestamps: [],
+        maxWindow,
+    };
+}
+function recordRequest(rm, latencyMs, statusCode) {
+    rm.totalRequests++;
+    if (statusCode >= 500)
+        rm.totalErrors++;
+    if (statusCode >= 400 && statusCode < 500)
+        rm.total4xx++;
+    rm.latencies.push(latencyMs);
+    rm.timestamps.push(new Date());
+    if (rm.latencies.length > rm.maxWindow) {
+        rm.latencies.shift();
+        rm.timestamps.shift();
+    }
+}
+exports.DEFAULT_THRESHOLDS = {
+    p50Latency: (0, index_js_1.createThresholds)(100, 500, false), // ms, lower is better
+    p99Latency: (0, index_js_1.createThresholds)(500, 2000, false), // ms, lower is better
+    errorRate: (0, index_js_1.createThresholds)(0.01, 0.10, false), // ratio, lower is better
+    requestRate: (0, index_js_1.createThresholds)(1.0, 0.1, true), // req/s, higher is better
+};
+// -----------------------------------------------------------------------
+// Metrics → Observations
+// -----------------------------------------------------------------------
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.ceil(sorted.length * p) - 1;
+    return sorted[Math.max(0, Math.min(idx, sorted.length - 1))];
+}
+function classifyRoute(rm, thresholds, now) {
+    if (rm.latencies.length < 3)
+        return [];
+    const sorted = [...rm.latencies].sort((a, b) => a - b);
+    const p50 = percentile(sorted, 0.5);
+    const p99 = percentile(sorted, 0.99);
+    const errorRate = rm.totalRequests > 0 ? rm.totalErrors / rm.totalRequests : 0;
+    // Request rate: requests in window / window duration
+    let requestRate = 0;
+    if (rm.timestamps.length >= 2) {
+        const windowMs = rm.timestamps[rm.timestamps.length - 1].getTime() - rm.timestamps[0].getTime();
+        if (windowMs > 0)
+            requestRate = (rm.timestamps.length / windowMs) * 1000;
+    }
+    const prefix = rm.route === '*' ? '' : `${rm.route}:`;
+    const observations = [
+        {
+            name: `${prefix}p50_latency`,
+            health: (0, index_js_1.classify)(p50, index_js_1.Confidence.HIGH, thresholds.p50Latency),
+            value: p50,
+            baseline: thresholds.p50Latency.intact,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}p99_latency`,
+            health: (0, index_js_1.classify)(p99, index_js_1.Confidence.HIGH, thresholds.p99Latency),
+            value: p99,
+            baseline: thresholds.p99Latency.intact,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}error_rate`,
+            health: (0, index_js_1.classify)(errorRate, index_js_1.Confidence.HIGH, thresholds.errorRate),
+            value: errorRate,
+            baseline: 0.001,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}request_rate`,
+            health: (0, index_js_1.classify)(requestRate, index_js_1.Confidence.MODERATE, thresholds.requestRate),
+            value: requestRate,
+            baseline: 10.0,
+            confidence: index_js_1.Confidence.MODERATE,
+            higherIsBetter: true,
+            provenance: [],
+            measuredAt: now,
+        },
+    ];
+    return observations;
+}
+function normalizePath(path) {
+    return path.replace(/\/\d+/g, '/:id').replace(/\/[0-9a-f]{24}/g, '/:id');
+}
+/**
+ * Express middleware that tracks request latency and error rates.
+ *
+ * Attach to your app before routes:
+ *   app.use(marginMiddleware());
+ */
+function marginMiddleware(options = {}) {
+    const opts = {
+        perRoute: options.perRoute ?? true,
+        window: options.window ?? 200,
+        thresholds: options.thresholds ?? exports.DEFAULT_THRESHOLDS,
+        ignore: options.ignore ?? ['/margin/health', '/favicon.ico'],
+        normalizePaths: options.normalizePaths ?? true,
+    };
+    const state = {
+        routes: new Map(),
+        aggregate: createRouteMetrics('*', opts.window),
+        options: opts,
+    };
+    const middleware = (req, res, next) => {
+        const path = req.path || req.url || '/';
+        if (opts.ignore.includes(path)) {
+            next();
+            return;
+        }
+        const start = Date.now();
+        // Hook into response finish
+        const onFinish = () => {
+            res.removeListener('finish', onFinish);
+            const latency = Date.now() - start;
+            const status = res.statusCode || 200;
+            // Aggregate
+            recordRequest(state.aggregate, latency, status);
+            // Per-route
+            if (opts.perRoute) {
+                const route = opts.normalizePaths ? normalizePath(path) : path;
+                if (!state.routes.has(route)) {
+                    state.routes.set(route, createRouteMetrics(route, opts.window));
+                }
+                recordRequest(state.routes.get(route), latency, status);
+            }
+        };
+        res.on('finish', onFinish);
+        next();
+    };
+    // Attach state to middleware for access by health route
+    middleware.__marginState = state;
+    return middleware;
+}
+/**
+ * Express route handler for /margin/health.
+ *
+ * Returns typed health classification for all tracked routes.
+ *
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Or pass the middleware directly:
+ *   const mw = marginMiddleware();
+ *   app.use(mw);
+ *   app.get('/margin/health', marginHealthRoute(mw));
+ */
+function marginHealthRoute(middleware) {
+    return (req, res) => {
+        // Find state from middleware
+        let state;
+        if (middleware && middleware.__marginState) {
+            state = middleware.__marginState;
+        }
+        else if (req.app) {
+            // Walk through app middleware stack to find ours
+            const stack = req.app._router?.stack || [];
+            for (const layer of stack) {
+                if (layer.handle?.__marginState) {
+                    state = layer.handle.__marginState;
+                    break;
+                }
+            }
+        }
+        if (!state) {
+            res.status(500).json({ error: 'margin middleware not found' });
+            return;
+        }
+        const now = new Date();
+        const thresholds = state.options.thresholds;
+        // Aggregate health
+        const aggObs = classifyRoute(state.aggregate, thresholds, now);
+        const aggExpr = (0, index_js_1.createExpression)(aggObs, [], 'aggregate');
+        // Determine overall status
+        const SEVERITY_MAP = {
+            [index_js_1.Health.INTACT]: 0, [index_js_1.Health.RECOVERING]: 1, [index_js_1.Health.DEGRADED]: 2,
+            [index_js_1.Health.ABLATED]: 3, [index_js_1.Health.OOD]: 4,
+        };
+        const worstHealth = aggObs.reduce((worst, o) => SEVERITY_MAP[o.health] > SEVERITY_MAP[worst] ? o.health : worst, index_js_1.Health.INTACT);
+        const response = {
+            status: worstHealth,
+            expression: (0, index_js_1.expressionToString)(aggExpr),
+            aggregate: (0, index_js_1.expressionToDict)(aggExpr),
+        };
+        // Per-route health
+        if (state.options.perRoute && state.routes.size > 0) {
+            const routes = {};
+            for (const [route, metrics] of state.routes) {
+                const obs = classifyRoute(metrics, thresholds, now);
+                if (obs.length > 0) {
+                    const expr = (0, index_js_1.createExpression)(obs, [], route);
+                    routes[route] = (0, index_js_1.expressionToDict)(expr);
+                }
+            }
+            response.routes = routes;
+        }
+        res.json(response);
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

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

package/dist/adapters/vitest.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vitest/Jest test health reporter for margin.
+ *
+ * Classifies test suite health after every run: pass rate, duration,
+ * flake rate. The JS equivalent of margin's pytest plugin.
+ *
+ * Usage with vitest:
+ *   // vitest.config.ts
+ *   import { marginReporter } from 'margin-ts/adapters/vitest';
+ *   export default { test: { reporters: ['default', marginReporter()] } };
+ *
+ * Or use standalone after collecting results:
+ *   import { classifySuite } from 'margin-ts/adapters/vitest';
+ *   const health = classifySuite({ passed: 95, failed: 3, skipped: 2, durationMs: 4500 });
+ */
+import { Thresholds, Expression } from '../index.js';
+export interface SuiteThresholds {
+    passRate: Thresholds;
+    skipRate: Thresholds;
+    meanDurationMs: Thresholds;
+    totalDurationMs: Thresholds;
+}
+export declare const DEFAULT_SUITE_THRESHOLDS: SuiteThresholds;
+export interface SuiteResults {
+    passed: number;
+    failed: number;
+    skipped: number;
+    durationMs: number;
+    testDurations?: number[];
+}
+export declare function classifySuite(results: SuiteResults, thresholds?: SuiteThresholds, label?: string): Expression;
+/**
+ * Format suite health as a printable string.
+ */
+export declare function suiteHealthString(results: SuiteResults, thresholds?: SuiteThresholds): string;
+//# sourceMappingURL=vitest.d.ts.map

package/dist/adapters/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../src/adapters/vitest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,UAAU,EAIV,UAAU,EAGX,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,cAAc,EAAE,UAAU,CAAC;IAC3B,eAAe,EAAE,UAAU,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,EAAE,eAKtC,CAAC;AAMF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,eAA0C,EACtD,KAAK,SAAK,GACT,UAAU,CAiEZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,MAAM,CAQ7F"}

package/dist/adapters/vitest.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Vitest/Jest test health reporter for margin.
+ *
+ * Classifies test suite health after every run: pass rate, duration,
+ * flake rate. The JS equivalent of margin's pytest plugin.
+ *
+ * Usage with vitest:
+ *   // vitest.config.ts
+ *   import { marginReporter } from 'margin-ts/adapters/vitest';
+ *   export default { test: { reporters: ['default', marginReporter()] } };
+ *
+ * Or use standalone after collecting results:
+ *   import { classifySuite } from 'margin-ts/adapters/vitest';
+ *   const health = classifySuite({ passed: 95, failed: 3, skipped: 2, durationMs: 4500 });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SUITE_THRESHOLDS = void 0;
+exports.classifySuite = classifySuite;
+exports.suiteHealthString = suiteHealthString;
+const index_js_1 = require("../index.js");
+exports.DEFAULT_SUITE_THRESHOLDS = {
+    passRate: (0, index_js_1.createThresholds)(0.95, 0.70, true), // higher is better
+    skipRate: (0, index_js_1.createThresholds)(0.05, 0.20, false), // lower is better
+    meanDurationMs: (0, index_js_1.createThresholds)(100, 1000, false), // lower is better
+    totalDurationMs: (0, index_js_1.createThresholds)(30000, 120000, false), // lower is better
+};
+function classifySuite(results, thresholds = exports.DEFAULT_SUITE_THRESHOLDS, label = '') {
+    const total = results.passed + results.failed + results.skipped;
+    if (total === 0)
+        return (0, index_js_1.createExpression)([], [], label);
+    const passRate = results.passed / total;
+    const skipRate = results.skipped / total;
+    const meanDuration = results.testDurations && results.testDurations.length > 0
+        ? results.testDurations.reduce((a, b) => a + b, 0) / results.testDurations.length
+        : results.durationMs / total;
+    const now = new Date();
+    const observations = [
+        {
+            name: 'pass_rate',
+            health: (0, index_js_1.classify)(passRate, index_js_1.Confidence.HIGH, thresholds.passRate),
+            value: passRate,
+            baseline: 1.0,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: true,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: 'skip_rate',
+            health: (0, index_js_1.classify)(skipRate, index_js_1.Confidence.HIGH, thresholds.skipRate),
+            value: skipRate,
+            baseline: 0.0,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: 'mean_duration',
+            health: (0, index_js_1.classify)(meanDuration, index_js_1.Confidence.HIGH, thresholds.meanDurationMs),
+            value: meanDuration,
+            baseline: 50,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: 'total_duration',
+            health: (0, index_js_1.classify)(results.durationMs, index_js_1.Confidence.MODERATE, thresholds.totalDurationMs),
+            value: results.durationMs,
+            baseline: 10000,
+            confidence: index_js_1.Confidence.MODERATE,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: 'failures',
+            health: (0, index_js_1.classify)(results.failed, index_js_1.Confidence.HIGH, (0, index_js_1.createThresholds)(0, 5, false)),
+            value: results.failed,
+            baseline: 0,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+    ];
+    return (0, index_js_1.createExpression)(observations, [], label || `suite (${total} tests)`);
+}
+/**
+ * Format suite health as a printable string.
+ */
+function suiteHealthString(results, thresholds) {
+    const expr = classifySuite(results, thresholds);
+    const total = results.passed + results.failed + results.skipped;
+    const lines = [
+        `margin health: ${total} tests (${results.passed} passed, ${results.failed} failed, ${results.skipped} skipped)`,
+        `  ${(0, index_js_1.expressionToString)(expr)}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=vitest.js.map

package/dist/adapters/vitest.js.map

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

package/dist/index.d.ts

@@ -11,4 +11,6 @@ export { Health, SEVERITY, Thresholds, createThresholds, isIntact, isAblated, cl
 export { Op, Observation, Correction, Expression, observationSigma, observationToAtom, observationToDict, observationFromDict, correctionIsActive, createExpression, healthOf, degraded, expressionToString, expressionToDict, Parser, } from './observation.js';
 export { DriftState, DriftDirection, DriftClassification, classifyDrift, } from './drift.js';
 export { AnomalyState, ANOMALY_SEVERITY, AnomalyClassification, classifyAnomaly, } from './anomaly.js';
+export { marginMiddleware, marginHealthRoute, DEFAULT_THRESHOLDS as EXPRESS_THRESHOLDS, type MarginMiddlewareOptions, type MarginState, type EndpointThresholds, } from './adapters/express.js';
+export { classifySuite, suiteHealthString, DEFAULT_SUITE_THRESHOLDS, type SuiteResults, type SuiteThresholds, } from './adapters/vitest.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -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,EAC1E,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"}
+{"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,EAC1E,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"}

package/dist/index.js

@@ -8,7 +8,7 @@
  * Copyright (c) 2026 Cope Labs LLC. MIT License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.classifyAnomaly = exports.ANOMALY_SEVERITY = exports.AnomalyState = exports.classifyDrift = exports.DriftDirection = exports.DriftState = exports.Parser = exports.expressionToDict = exports.expressionToString = exports.degraded = exports.healthOf = exports.createExpression = exports.correctionIsActive = exports.observationFromDict = exports.observationToDict = exports.observationToAtom = exports.observationSigma = exports.Op = exports.classify = exports.isAblated = exports.isIntact = exports.createThresholds = exports.SEVERITY = exports.Health = exports.minConfidence = exports.confidenceLt = exports.confidenceGte = exports.confidenceRank = exports.Confidence = void 0;
+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.degraded = exports.healthOf = exports.createExpression = exports.correctionIsActive = exports.observationFromDict = exports.observationToDict = exports.observationToAtom = exports.observationSigma = exports.Op = exports.classify = exports.isAblated = exports.isIntact = exports.createThresholds = exports.SEVERITY = exports.Health = exports.minConfidence = exports.confidenceLt = exports.confidenceGte = exports.confidenceRank = exports.Confidence = void 0;
 var confidence_js_1 = require("./confidence.js");
 Object.defineProperty(exports, "Confidence", { enumerable: true, get: function () { return confidence_js_1.Confidence; } });
 Object.defineProperty(exports, "confidenceRank", { enumerable: true, get: function () { return confidence_js_1.confidenceRank; } });
@@ -43,4 +43,13 @@ var anomaly_js_1 = require("./anomaly.js");
 Object.defineProperty(exports, "AnomalyState", { enumerable: true, get: function () { return anomaly_js_1.AnomalyState; } });
 Object.defineProperty(exports, "ANOMALY_SEVERITY", { enumerable: true, get: function () { return anomaly_js_1.ANOMALY_SEVERITY; } });
 Object.defineProperty(exports, "classifyAnomaly", { enumerable: true, get: function () { return anomaly_js_1.classifyAnomaly; } });
+// Adapters
+var express_js_1 = require("./adapters/express.js");
+Object.defineProperty(exports, "marginMiddleware", { enumerable: true, get: function () { return express_js_1.marginMiddleware; } });
+Object.defineProperty(exports, "marginHealthRoute", { enumerable: true, get: function () { return express_js_1.marginHealthRoute; } });
+Object.defineProperty(exports, "EXPRESS_THRESHOLDS", { enumerable: true, get: function () { return express_js_1.DEFAULT_THRESHOLDS; } });
+var vitest_js_1 = require("./adapters/vitest.js");
+Object.defineProperty(exports, "classifySuite", { enumerable: true, get: function () { return vitest_js_1.classifySuite; } });
+Object.defineProperty(exports, "suiteHealthString", { enumerable: true, get: function () { return vitest_js_1.suiteHealthString; } });
+Object.defineProperty(exports, "DEFAULT_SUITE_THRESHOLDS", { enumerable: true, get: function () { return vitest_js_1.DEFAULT_SUITE_THRESHOLDS; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,mDAM0B;AALxB,oGAAA,EAAE,OAAA;AACF,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,oHAAA,kBAAkB,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAC1E,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"}
+{"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,mDAM0B;AALxB,oGAAA,EAAE,OAAA;AACF,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,oHAAA,kBAAkB,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAC1E,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "margin-ts",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Typed health classification for systems that measure things. Zero dependencies.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/adapters/express.ts

@@ -0,0 +1,342 @@
+/**
+ * Express middleware adapter for margin.
+ *
+ * Tracks per-route health: latency, error rate, request rate.
+ * Exposes /margin/health endpoint with typed classifications.
+ *
+ * Usage:
+ *   import express from 'express';
+ *   import { marginMiddleware, marginHealthRoute } from 'margin-ts/adapters/express';
+ *
+ *   const app = express();
+ *   app.use(marginMiddleware());
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Zero dependencies beyond margin-ts core (express types are optional).
+ */
+
+import {
+  Confidence,
+  Health,
+  Thresholds,
+  createThresholds,
+  classify,
+  Observation,
+  Expression,
+  createExpression,
+  observationSigma,
+  expressionToString,
+  expressionToDict,
+  DriftState,
+  DriftDirection,
+  classifyDrift,
+  AnomalyState,
+  classifyAnomaly,
+} from '../index.js';
+
+// -----------------------------------------------------------------------
+// Route metrics tracking
+// -----------------------------------------------------------------------
+
+interface RouteMetrics {
+  route: string;
+  totalRequests: number;
+  totalErrors: number;       // status >= 500
+  total4xx: number;          // status 400-499
+  latencies: number[];       // last N response times in ms
+  timestamps: Date[];        // when each request happened
+  maxWindow: number;
+}
+
+function createRouteMetrics(route: string, maxWindow = 200): RouteMetrics {
+  return {
+    route,
+    totalRequests: 0,
+    totalErrors: 0,
+    total4xx: 0,
+    latencies: [],
+    timestamps: [],
+    maxWindow,
+  };
+}
+
+function recordRequest(rm: RouteMetrics, latencyMs: number, statusCode: number): void {
+  rm.totalRequests++;
+  if (statusCode >= 500) rm.totalErrors++;
+  if (statusCode >= 400 && statusCode < 500) rm.total4xx++;
+  rm.latencies.push(latencyMs);
+  rm.timestamps.push(new Date());
+  if (rm.latencies.length > rm.maxWindow) {
+    rm.latencies.shift();
+    rm.timestamps.shift();
+  }
+}
+
+// -----------------------------------------------------------------------
+// Default thresholds
+// -----------------------------------------------------------------------
+
+export interface EndpointThresholds {
+  p50Latency: Thresholds;
+  p99Latency: Thresholds;
+  errorRate: Thresholds;
+  requestRate: Thresholds;
+}
+
+export const DEFAULT_THRESHOLDS: EndpointThresholds = {
+  p50Latency: createThresholds(100, 500, false),     // ms, lower is better
+  p99Latency: createThresholds(500, 2000, false),     // ms, lower is better
+  errorRate: createThresholds(0.01, 0.10, false),     // ratio, lower is better
+  requestRate: createThresholds(1.0, 0.1, true),      // req/s, higher is better
+};
+
+// -----------------------------------------------------------------------
+// Metrics → Observations
+// -----------------------------------------------------------------------
+
+function percentile(sorted: number[], p: number): number {
+  if (sorted.length === 0) return 0;
+  const idx = Math.ceil(sorted.length * p) - 1;
+  return sorted[Math.max(0, Math.min(idx, sorted.length - 1))];
+}
+
+function classifyRoute(
+  rm: RouteMetrics,
+  thresholds: EndpointThresholds,
+  now: Date,
+): Observation[] {
+  if (rm.latencies.length < 3) return [];
+
+  const sorted = [...rm.latencies].sort((a, b) => a - b);
+  const p50 = percentile(sorted, 0.5);
+  const p99 = percentile(sorted, 0.99);
+  const errorRate = rm.totalRequests > 0 ? rm.totalErrors / rm.totalRequests : 0;
+
+  // Request rate: requests in window / window duration
+  let requestRate = 0;
+  if (rm.timestamps.length >= 2) {
+    const windowMs = rm.timestamps[rm.timestamps.length - 1].getTime() - rm.timestamps[0].getTime();
+    if (windowMs > 0) requestRate = (rm.timestamps.length / windowMs) * 1000;
+  }
+
+  const prefix = rm.route === '*' ? '' : `${rm.route}:`;
+
+  const observations: Observation[] = [
+    {
+      name: `${prefix}p50_latency`,
+      health: classify(p50, Confidence.HIGH, thresholds.p50Latency),
+      value: p50,
+      baseline: thresholds.p50Latency.intact,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: `${prefix}p99_latency`,
+      health: classify(p99, Confidence.HIGH, thresholds.p99Latency),
+      value: p99,
+      baseline: thresholds.p99Latency.intact,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: `${prefix}error_rate`,
+      health: classify(errorRate, Confidence.HIGH, thresholds.errorRate),
+      value: errorRate,
+      baseline: 0.001,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: `${prefix}request_rate`,
+      health: classify(requestRate, Confidence.MODERATE, thresholds.requestRate),
+      value: requestRate,
+      baseline: 10.0,
+      confidence: Confidence.MODERATE,
+      higherIsBetter: true,
+      provenance: [],
+      measuredAt: now,
+    },
+  ];
+
+  return observations;
+}
+
+// -----------------------------------------------------------------------
+// Middleware
+// -----------------------------------------------------------------------
+
+export interface MarginMiddlewareOptions {
+  /** Track per-route or aggregate only (default: true) */
+  perRoute?: boolean;
+  /** Max latency samples to keep per route (default: 200) */
+  window?: number;
+  /** Custom thresholds */
+  thresholds?: EndpointThresholds;
+  /** Routes to ignore (e.g. ['/margin/health', '/favicon.ico']) */
+  ignore?: string[];
+  /** Normalize route paths: replace numeric segments with :id (default: true) */
+  normalizePaths?: boolean;
+}
+
+/** The shared state object — accessible for custom endpoints */
+export interface MarginState {
+  routes: Map<string, RouteMetrics>;
+  aggregate: RouteMetrics;
+  options: Required<MarginMiddlewareOptions>;
+}
+
+function normalizePath(path: string): string {
+  return path.replace(/\/\d+/g, '/:id').replace(/\/[0-9a-f]{24}/g, '/:id');
+}
+
+/**
+ * Express middleware that tracks request latency and error rates.
+ *
+ * Attach to your app before routes:
+ *   app.use(marginMiddleware());
+ */
+export function marginMiddleware(options: MarginMiddlewareOptions = {}): any {
+  const opts: Required<MarginMiddlewareOptions> = {
+    perRoute: options.perRoute ?? true,
+    window: options.window ?? 200,
+    thresholds: options.thresholds ?? DEFAULT_THRESHOLDS,
+    ignore: options.ignore ?? ['/margin/health', '/favicon.ico'],
+    normalizePaths: options.normalizePaths ?? true,
+  };
+
+  const state: MarginState = {
+    routes: new Map(),
+    aggregate: createRouteMetrics('*', opts.window),
+    options: opts,
+  };
+
+  const middleware = (req: any, res: any, next: any) => {
+    const path: string = req.path || req.url || '/';
+
+    if (opts.ignore.includes(path)) {
+      next();
+      return;
+    }
+
+    const start = Date.now();
+
+    // Hook into response finish
+    const onFinish = () => {
+      res.removeListener('finish', onFinish);
+      const latency = Date.now() - start;
+      const status: number = res.statusCode || 200;
+
+      // Aggregate
+      recordRequest(state.aggregate, latency, status);
+
+      // Per-route
+      if (opts.perRoute) {
+        const route = opts.normalizePaths ? normalizePath(path) : path;
+        if (!state.routes.has(route)) {
+          state.routes.set(route, createRouteMetrics(route, opts.window));
+        }
+        recordRequest(state.routes.get(route)!, latency, status);
+      }
+    };
+
+    res.on('finish', onFinish);
+    next();
+  };
+
+  // Attach state to middleware for access by health route
+  (middleware as any).__marginState = state;
+
+  return middleware;
+}
+
+// -----------------------------------------------------------------------
+// Health endpoint
+// -----------------------------------------------------------------------
+
+export interface HealthResponse {
+  status: string;
+  expression: string;
+  aggregate: Record<string, unknown>;
+  routes?: Record<string, Record<string, unknown>>;
+  drift?: Record<string, unknown>;
+}
+
+/**
+ * Express route handler for /margin/health.
+ *
+ * Returns typed health classification for all tracked routes.
+ *
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Or pass the middleware directly:
+ *   const mw = marginMiddleware();
+ *   app.use(mw);
+ *   app.get('/margin/health', marginHealthRoute(mw));
+ */
+export function marginHealthRoute(middleware?: any): any {
+  return (req: any, res: any) => {
+    // Find state from middleware
+    let state: MarginState | undefined;
+    if (middleware && (middleware as any).__marginState) {
+      state = (middleware as any).__marginState;
+    } else if (req.app) {
+      // Walk through app middleware stack to find ours
+      const stack = req.app._router?.stack || [];
+      for (const layer of stack) {
+        if (layer.handle?.__marginState) {
+          state = layer.handle.__marginState;
+          break;
+        }
+      }
+    }
+
+    if (!state) {
+      res.status(500).json({ error: 'margin middleware not found' });
+      return;
+    }
+
+    const now = new Date();
+    const thresholds = state.options.thresholds;
+
+    // Aggregate health
+    const aggObs = classifyRoute(state.aggregate, thresholds, now);
+    const aggExpr = createExpression(aggObs, [], 'aggregate');
+
+    // Determine overall status
+    const SEVERITY_MAP: Record<Health, number> = {
+      [Health.INTACT]: 0, [Health.RECOVERING]: 1, [Health.DEGRADED]: 2,
+      [Health.ABLATED]: 3, [Health.OOD]: 4,
+    };
+    const worstHealth = aggObs.reduce(
+      (worst, o) => SEVERITY_MAP[o.health] > SEVERITY_MAP[worst] ? o.health : worst,
+      Health.INTACT,
+    );
+
+    const response: HealthResponse = {
+      status: worstHealth,
+      expression: expressionToString(aggExpr),
+      aggregate: expressionToDict(aggExpr),
+    };
+
+    // Per-route health
+    if (state.options.perRoute && state.routes.size > 0) {
+      const routes: Record<string, Record<string, unknown>> = {};
+      for (const [route, metrics] of state.routes) {
+        const obs = classifyRoute(metrics, thresholds, now);
+        if (obs.length > 0) {
+          const expr = createExpression(obs, [], route);
+          routes[route] = expressionToDict(expr);
+        }
+      }
+      response.routes = routes;
+    }
+
+    res.json(response);
+  };
+}

package/src/adapters/vitest.ts

@@ -0,0 +1,141 @@
+/**
+ * Vitest/Jest test health reporter for margin.
+ *
+ * Classifies test suite health after every run: pass rate, duration,
+ * flake rate. The JS equivalent of margin's pytest plugin.
+ *
+ * Usage with vitest:
+ *   // vitest.config.ts
+ *   import { marginReporter } from 'margin-ts/adapters/vitest';
+ *   export default { test: { reporters: ['default', marginReporter()] } };
+ *
+ * Or use standalone after collecting results:
+ *   import { classifySuite } from 'margin-ts/adapters/vitest';
+ *   const health = classifySuite({ passed: 95, failed: 3, skipped: 2, durationMs: 4500 });
+ */
+
+import {
+  Confidence,
+  Health,
+  Thresholds,
+  createThresholds,
+  classify,
+  Observation,
+  Expression,
+  createExpression,
+  expressionToString,
+} from '../index.js';
+
+// -----------------------------------------------------------------------
+// Suite metrics thresholds
+// -----------------------------------------------------------------------
+
+export interface SuiteThresholds {
+  passRate: Thresholds;
+  skipRate: Thresholds;
+  meanDurationMs: Thresholds;
+  totalDurationMs: Thresholds;
+}
+
+export const DEFAULT_SUITE_THRESHOLDS: SuiteThresholds = {
+  passRate: createThresholds(0.95, 0.70, true),        // higher is better
+  skipRate: createThresholds(0.05, 0.20, false),        // lower is better
+  meanDurationMs: createThresholds(100, 1000, false),   // lower is better
+  totalDurationMs: createThresholds(30000, 120000, false), // lower is better
+};
+
+// -----------------------------------------------------------------------
+// Suite results → Expression
+// -----------------------------------------------------------------------
+
+export interface SuiteResults {
+  passed: number;
+  failed: number;
+  skipped: number;
+  durationMs: number;
+  testDurations?: number[];  // per-test durations in ms
+}
+
+export function classifySuite(
+  results: SuiteResults,
+  thresholds: SuiteThresholds = DEFAULT_SUITE_THRESHOLDS,
+  label = '',
+): Expression {
+  const total = results.passed + results.failed + results.skipped;
+  if (total === 0) return createExpression([], [], label);
+
+  const passRate = results.passed / total;
+  const skipRate = results.skipped / total;
+  const meanDuration = results.testDurations && results.testDurations.length > 0
+    ? results.testDurations.reduce((a, b) => a + b, 0) / results.testDurations.length
+    : results.durationMs / total;
+
+  const now = new Date();
+  const observations: Observation[] = [
+    {
+      name: 'pass_rate',
+      health: classify(passRate, Confidence.HIGH, thresholds.passRate),
+      value: passRate,
+      baseline: 1.0,
+      confidence: Confidence.HIGH,
+      higherIsBetter: true,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: 'skip_rate',
+      health: classify(skipRate, Confidence.HIGH, thresholds.skipRate),
+      value: skipRate,
+      baseline: 0.0,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: 'mean_duration',
+      health: classify(meanDuration, Confidence.HIGH, thresholds.meanDurationMs),
+      value: meanDuration,
+      baseline: 50,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: 'total_duration',
+      health: classify(results.durationMs, Confidence.MODERATE, thresholds.totalDurationMs),
+      value: results.durationMs,
+      baseline: 10000,
+      confidence: Confidence.MODERATE,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+    {
+      name: 'failures',
+      health: classify(results.failed, Confidence.HIGH, createThresholds(0, 5, false)),
+      value: results.failed,
+      baseline: 0,
+      confidence: Confidence.HIGH,
+      higherIsBetter: false,
+      provenance: [],
+      measuredAt: now,
+    },
+  ];
+
+  return createExpression(observations, [], label || `suite (${total} tests)`);
+}
+
+/**
+ * Format suite health as a printable string.
+ */
+export function suiteHealthString(results: SuiteResults, thresholds?: SuiteThresholds): string {
+  const expr = classifySuite(results, thresholds);
+  const total = results.passed + results.failed + results.skipped;
+  const lines = [
+    `margin health: ${total} tests (${results.passed} passed, ${results.failed} failed, ${results.skipped} skipped)`,
+    `  ${expressionToString(expr)}`,
+  ];
+  return lines.join('\n');
+}

package/src/index.ts

@@ -31,3 +31,16 @@ export {
   AnomalyState, ANOMALY_SEVERITY, AnomalyClassification,
   classifyAnomaly,
 } from './anomaly.js';
+
+// Adapters
+export {
+  marginMiddleware, marginHealthRoute,
+  DEFAULT_THRESHOLDS as EXPRESS_THRESHOLDS,
+  type MarginMiddlewareOptions, type MarginState, type EndpointThresholds,
+} from './adapters/express.js';
+
+export {
+  classifySuite, suiteHealthString,
+  DEFAULT_SUITE_THRESHOLDS,
+  type SuiteResults, type SuiteThresholds,
+} from './adapters/vitest.js';