@stacknext/regression 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @stacknext/regression
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Versioned capture-run, baseline and comparison schemas plus deterministic
+comparison logic for [StackNext](https://github.com/marrrkkk/stacknext).
+
+Playwright-linked samples are compared using medians and explicit thresholds.
+Statuses are `improved`, `regressed`, `unchanged` or `inconclusive`; comparisons
+are not statistical tests and do not prove causality. Records are redacted
+local JSON files under `.stacknext`.
+
+```bash
+npm install --save-dev @stacknext/cli @stacknext/next @stacknext/playwright
+npx stacknext capture --name baseline -- npx playwright test --workers=1
+```
+
+This package is ESM-only and requires Node.js 20.9 or newer.
+
+License: MIT.

package/dist/capture.d.ts

@@ -0,0 +1,47 @@
+import { type DiagnosticFinding, type TraceDetail } from '@stacknext/core';
+import type { CapturedFinding, CapturedSample, CapturedTrace, SampleSubmission, ScenarioIdentity } from './schema.js';
+export interface CorrelationVerification {
+    verified: boolean;
+    reason?: string;
+}
+/**
+ * Proves that a trace belongs to the injected Playwright request. Matching the
+ * random trace id alone is not enough: a server span must name the injected
+ * span id as its parent.
+ */
+export declare function verifyTraceCorrelation(detail: TraceDetail, traceId: string, injectedSpanId: string): CorrelationVerification;
+/** Converts one correlated collector trace into bounded, id-free scenario evidence. */
+export declare function capturedTraceFromDetail(detail: TraceDetail, injectedSpanId: string): CapturedTrace;
+export declare function capturedFinding(finding: DiagnosticFinding): CapturedFinding;
+export declare function dedupeCapturedFindings(findings: CapturedFinding[]): CapturedFinding[];
+export declare function capturedFindings(findings: DiagnosticFinding[]): CapturedFinding[];
+export interface SampleEvidenceInput {
+    submission: SampleSubmission;
+    lookupTrace: (traceId: string) => TraceDetail | null;
+    findingsForTrace: (traceId: string) => DiagnosticFinding[];
+}
+/**
+ * Builds the stored sample from collector state. A sample is verified only when
+ * every submitted trace exists and proves the injected parent relationship.
+ * Missing telemetry is recorded as incomplete instead of being ignored.
+ */
+export declare function capturedSampleFromSubmission(input: SampleEvidenceInput): CapturedSample;
+/** Adds a sample once and returns the merged scenario evidence. */
+export declare function mergeScenarioSample(input: {
+    identity: ScenarioIdentity;
+    samples: CapturedSample[];
+    previousFindings?: CapturedFinding[];
+    notes?: string[];
+    limitations?: string[];
+}): {
+    identity: ScenarioIdentity;
+    samples: CapturedSample[];
+    findings: CapturedFinding[];
+    notes: string[];
+    limitations: string[];
+};
+export declare function createSampleId(): string;
+export declare function createRunId(): string;
+export declare function createBaselineId(): string;
+export declare function createComparisonId(): string;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAA;AAMxB,OAAO,KAAK,EAEV,eAAe,EAEf,cAAc,EAEd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAGpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,uBAAuB,CAezB;AA4CD,uFAAuF;AACvF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,MAAM,GACrB,aAAa,CAiDf;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAQ3E;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EAAE,GAC1B,eAAe,EAAE,CAMnB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,eAAe,EAAE,CAEjF;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,gBAAgB,CAAA;IAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAA;IACpD,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,iBAAiB,EAAE,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,mBAAmB,GACzB,cAAc,CAwDhB;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,GAAG;IACF,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAmBA;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/capture.js

@@ -0,0 +1,207 @@
+import { randomBytes } from 'node:crypto';
+import { fingerprint, redactText, stripUrlQueryInText, } from '@stacknext/core';
+import { diagnosticErrorFingerprint, sqlFingerprint, sqlPreview, } from '@stacknext/diagnostics';
+import { spanIdentity, traceIdentity } from './identity.js';
+/**
+ * Proves that a trace belongs to the injected Playwright request. Matching the
+ * random trace id alone is not enough: a server span must name the injected
+ * span id as its parent.
+ */
+export function verifyTraceCorrelation(detail, traceId, injectedSpanId) {
+    if (detail.traceId.toLowerCase() !== traceId.toLowerCase()) {
+        return { verified: false, reason: 'trace-id-mismatch' };
+    }
+    if (detail.spans.length === 0) {
+        return { verified: false, reason: 'trace-has-no-spans' };
+    }
+    const parent = injectedSpanId.toLowerCase();
+    const linked = detail.spans.some((span) => span.parentSpanId?.toLowerCase() === parent);
+    if (!linked) {
+        return { verified: false, reason: 'injected-parent-not-found' };
+    }
+    return { verified: true };
+}
+function shortText(value, maxLength) {
+    return stripUrlQueryInText(redactText(value, maxLength));
+}
+function capturedSpan(span) {
+    const identity = spanIdentity(span);
+    return {
+        key: identity.key,
+        name: identity.name,
+        kind: span.kind,
+        category: identity.category,
+        durationMs: Math.round(span.durationMs * 1_000) / 1_000,
+        status: span.status,
+        ...(span.nextSpanType ? { nextSpanType: shortText(span.nextSpanType, 200) } : {}),
+    };
+}
+function capturedQuery(query) {
+    const shape = sqlPreview(query.sql);
+    return {
+        key: sqlFingerprint(query.sql),
+        shape,
+        durationMs: query.durationMs,
+        source: query.source,
+        success: query.success,
+    };
+}
+function capturedError(error) {
+    const route = error.route ?? error.requestPath ?? null;
+    return {
+        key: diagnosticErrorFingerprint(error),
+        name: shortText(error.name, 200),
+        message: shortText(error.message, 600),
+        route: route ? shortText(route, 500) : null,
+    };
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Converts one correlated collector trace into bounded, id-free scenario evidence. */
+export function capturedTraceFromDetail(detail, injectedSpanId) {
+    const identity = traceIdentity(detail);
+    const root = detail.spans.find((span) => !span.parentSpanId) ??
+        [...detail.spans].sort((a, b) => a.startTime - b.startTime)[0];
+    const spans = detail.spans
+        .map(capturedSpan)
+        .sort((a, b) => compareStrings(a.key, b.key) ||
+        b.durationMs - a.durationMs ||
+        compareStrings(a.status, b.status))
+        .slice(0, 500);
+    const queries = detail.databaseQueries
+        .map(capturedQuery)
+        .sort((a, b) => compareStrings(a.key, b.key) ||
+        (a.durationMs ?? -1) - (b.durationMs ?? -1) ||
+        Number(a.success) - Number(b.success))
+        .slice(0, 200);
+    const errors = detail.errors
+        .map(capturedError)
+        .sort((a, b) => compareStrings(a.key, b.key) ||
+        compareStrings(a.name, b.name) ||
+        compareStrings(a.message, b.message))
+        .slice(0, 100);
+    return {
+        traceId: detail.traceId.toLowerCase(),
+        injectedSpanId: injectedSpanId.toLowerCase(),
+        key: identity.key,
+        method: identity.method,
+        route: identity.route,
+        rootName: identity.rootName,
+        statusCode: detail.request?.statusCode ?? root?.statusCode ?? null,
+        durationMs: Math.round(detail.durationMs * 1_000) / 1_000,
+        spanCount: detail.spans.length,
+        errorCount: detail.errors.length,
+        databaseQueryCount: detail.databaseQueries.length,
+        fetchCount: spans.filter((span) => span.category === 'http').length,
+        spans,
+        queries,
+        errors,
+    };
+}
+export function capturedFinding(finding) {
+    return {
+        key: fingerprint([finding.ruleId, finding.fingerprint]),
+        ruleId: finding.ruleId,
+        category: finding.category,
+        severity: finding.severity,
+        status: finding.status,
+    };
+}
+export function dedupeCapturedFindings(findings) {
+    const unique = new Map();
+    for (const finding of findings) {
+        if (!unique.has(finding.key))
+            unique.set(finding.key, finding);
+    }
+    return [...unique.values()].sort((a, b) => compareStrings(a.key, b.key));
+}
+export function capturedFindings(findings) {
+    return dedupeCapturedFindings(findings.map(capturedFinding));
+}
+/**
+ * Builds the stored sample from collector state. A sample is verified only when
+ * every submitted trace exists and proves the injected parent relationship.
+ * Missing telemetry is recorded as incomplete instead of being ignored.
+ */
+export function capturedSampleFromSubmission(input) {
+    const reasons = new Set();
+    const traces = [];
+    const findings = [];
+    const seen = new Set();
+    let references = 0;
+    for (const reference of input.submission.traces) {
+        const key = `${reference.traceId.toLowerCase()}:${reference.injectedSpanId.toLowerCase()}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        references += 1;
+        const detail = input.lookupTrace(reference.traceId);
+        if (!detail) {
+            reasons.add('trace-not-found');
+            continue;
+        }
+        const verification = verifyTraceCorrelation(detail, reference.traceId, reference.injectedSpanId);
+        if (!verification.verified) {
+            reasons.add(verification.reason ?? 'correlation-unverified');
+            continue;
+        }
+        traces.push(capturedTraceFromDetail(detail, reference.injectedSpanId));
+        findings.push(...input.findingsForTrace(reference.traceId).map(capturedFinding));
+    }
+    traces.sort((a, b) => compareStrings(a.key, b.key) ||
+        compareStrings(a.rootName, b.rootName) ||
+        compareStrings(a.traceId, b.traceId));
+    if (references === 0)
+        reasons.add('no-request-trace-recorded');
+    const verified = references > 0 && traces.length === references;
+    if (!verified && references > 0 && traces.length === 0) {
+        reasons.add('no-verified-traces');
+    }
+    return {
+        id: input.submission.id,
+        status: input.submission.status,
+        expectedStatus: input.submission.expectedStatus,
+        retry: input.submission.retry,
+        repeatEachIndex: input.submission.repeatEachIndex,
+        durationMs: Math.round(input.submission.durationMs * 1_000) / 1_000,
+        capturedAt: input.submission.capturedAt,
+        correlation: {
+            status: verified ? 'verified' : 'incomplete',
+            reasons: [...reasons].sort().slice(0, 20),
+            traces: traces.slice(0, 20),
+        },
+        findings: dedupeCapturedFindings(findings),
+    };
+}
+/** Adds a sample once and returns the merged scenario evidence. */
+export function mergeScenarioSample(input) {
+    const samples = [...input.samples].sort((a, b) => a.capturedAt - b.capturedAt ||
+        a.retry - b.retry ||
+        a.repeatEachIndex - b.repeatEachIndex ||
+        compareStrings(a.id, b.id));
+    const findings = dedupeCapturedFindings([
+        ...(input.previousFindings ?? []),
+        ...samples.flatMap((sample) => sample.findings),
+    ]);
+    return {
+        identity: input.identity,
+        samples: samples.slice(0, 100),
+        findings,
+        notes: [...new Set(input.notes ?? [])].slice(0, 30),
+        limitations: [...new Set(input.limitations ?? [])].slice(0, 30),
+    };
+}
+export function createSampleId() {
+    return `smp-${randomBytes(8).toString('hex')}`;
+}
+export function createRunId() {
+    return `run-${randomBytes(8).toString('hex')}`;
+}
+export function createBaselineId() {
+    return `base-${randomBytes(8).toString('hex')}`;
+}
+export function createComparisonId() {
+    return `cmp-${randomBytes(8).toString('hex')}`;
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/compare.d.ts

@@ -0,0 +1,11 @@
+import type { Baseline, Comparison, ComparisonOptions, EnvironmentDifference, TestRun } from './schema.js';
+/**
+ * Compares a saved baseline with a candidate run. Ids and timestamps are never
+ * used to match scenarios or traces; matching uses the stored stable keys.
+ */
+export declare function compareBaseline(baseline: Baseline, candidate: TestRun, options?: Partial<ComparisonOptions>, meta?: {
+    id?: string;
+    now?: number;
+}): Comparison;
+export declare function environmentDifferencesOf(comparison: Comparison): EnvironmentDifference[];
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,QAAQ,EAKR,UAAU,EACV,iBAAiB,EAEjB,qBAAqB,EAGrB,OAAO,EACR,MAAM,aAAa,CAAA;AAonBpB;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,EAClB,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,EACxC,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,UAAU,CAwGZ;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,GACrB,qBAAqB,EAAE,CAEzB"}