@stacknext/diagnostics 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,19 @@
-# Temporary Holding Version
+# @stacknext/diagnostics
 
-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.
+Deterministic, evidence-backed diagnostics for [StackNext](https://github.com/marrrkkk/stacknext)
+telemetry. The engine evaluates four conservative rules over the current
+retention sample: repeated SQL shapes, slow spans, repeated external HTTP
+endpoints and error fingerprints.
+
+Findings are heuristics, not confirmed root causes. The same report is exposed
+by the StackNext CLI, dashboard, JSON export and read-only MCP server.
+
+```bash
+npm install --save-dev @stacknext/cli @stacknext/next
+npx stacknext diagnose
+```
+
+This package is normally consumed through the StackNext CLI and collector. It
+is ESM-only and requires Node.js 20.9 or newer.
+
+License: MIT.

package/dist/classify.d.ts

@@ -0,0 +1,24 @@
+import { type DiagnosticSpanCategory, type DiagnosticSpanEvidence, type StackNextConfig, type StackNextSpan } from '@stacknext/core';
+/**
+ * Classifies a span for threshold selection. Manual spans carrying documented
+ * database attributes are treated as database work, even though the explorer
+ * labels them app/custom.
+ */
+export declare function diagnosticSpanCategory(span: StackNextSpan): DiagnosticSpanCategory;
+export declare function spanThresholdMs(category: DiagnosticSpanCategory, config: StackNextConfig['diagnostics']): number;
+export declare function spanHttpMethod(span: StackNextSpan): string | null;
+/**
+ * Extracts a bounded, credential-free endpoint from a fetch span. Returns null
+ * when no URL-like attribute or path can be identified.
+ */
+export declare function spanHttpEndpoint(span: StackNextSpan): string | null;
+/**
+ * Defense-in-depth for evidence output. Stored telemetry is already redacted,
+ * but diagnostics must never reintroduce URL query values or credentials when
+ * it copies a span name into a finding.
+ */
+export declare function safeSpanName(name: string): string;
+/** Bounded route evidence with URL query values and credentials removed. */
+export declare function safeRoute(value: string | null | undefined): string | null;
+export declare function spanEvidence(span: StackNextSpan, category?: DiagnosticSpanCategory): DiagnosticSpanEvidence;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAA;AAcxB;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,CAclF;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,eAAe,CAAC,aAAa,CAAC,GACrC,MAAM,CAKR;AASD,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAiBnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,QAAQ,yBAA+B,GACtC,sBAAsB,CAYxB"}

package/dist/classify.js

@@ -0,0 +1,94 @@
+import { isDatabaseSpan, isFetchSpan, redactText, stripUrlQueryInText, } from '@stacknext/core';
+import { httpEndpoint } from './fingerprints.js';
+function stringAttribute(attributes, ...keys) {
+    for (const key of keys) {
+        const value = attributes[key];
+        if (typeof value === 'string' && value.trim() !== '')
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Classifies a span for threshold selection. Manual spans carrying documented
+ * database attributes are treated as database work, even though the explorer
+ * labels them app/custom.
+ */
+export function diagnosticSpanCategory(span) {
+    if (isDatabaseSpan(span.attributes))
+        return 'database';
+    if (isFetchSpan(span.nextSpanType, span.kind, span.attributes))
+        return 'http';
+    const manualKind = span.attributes['stacknext.span.kind'];
+    if (manualKind === 'custom' ||
+        manualKind === 'action' ||
+        span.attributes['stacknext.manual'] === true) {
+        return 'custom';
+    }
+    if (span.nextSpanType !== undefined)
+        return 'framework';
+    if (span.kind === 'server' && !span.parentSpanId)
+        return 'framework';
+    return 'other';
+}
+export function spanThresholdMs(category, config) {
+    if (category === 'database')
+        return config.slowSpans.databaseMs;
+    if (category === 'http')
+        return config.slowSpans.httpMs;
+    if (category === 'custom')
+        return config.slowSpans.customMs;
+    return config.slowSpans.otherMs;
+}
+function methodFromName(name) {
+    const match = /^(?:fetch\s+)?(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS|TRACE|CONNECT)\s+/i.exec(name);
+    return match?.[1]?.toUpperCase();
+}
+export function spanHttpMethod(span) {
+    return (span.method ??
+        stringAttribute(span.attributes, 'http.method', 'http.request.method')?.toUpperCase() ??
+        methodFromName(span.name) ??
+        null);
+}
+/**
+ * Extracts a bounded, credential-free endpoint from a fetch span. Returns null
+ * when no URL-like attribute or path can be identified.
+ */
+export function spanHttpEndpoint(span) {
+    const direct = stringAttribute(span.attributes, 'http.url', 'url.full', 'http.target', 'url.path', 'http.route');
+    if (direct) {
+        const endpoint = httpEndpoint(direct);
+        if (endpoint)
+            return endpoint;
+    }
+    const match = /^(?:fetch\s+)?(?:GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS|TRACE|CONNECT)\s+(\S+)/i.exec(span.name);
+    return match?.[1] ? httpEndpoint(match[1]) : null;
+}
+/**
+ * Defense-in-depth for evidence output. Stored telemetry is already redacted,
+ * but diagnostics must never reintroduce URL query values or credentials when
+ * it copies a span name into a finding.
+ */
+export function safeSpanName(name) {
+    return stripUrlQueryInText(redactText(name, 300));
+}
+/** Bounded route evidence with URL query values and credentials removed. */
+export function safeRoute(value) {
+    if (!value)
+        return null;
+    const sanitized = stripUrlQueryInText(redactText(value, 500));
+    return sanitized.length <= 500 ? sanitized : `${sanitized.slice(0, 500)}…`;
+}
+export function spanEvidence(span, category = diagnosticSpanCategory(span)) {
+    const route = safeRoute(span.route);
+    return {
+        spanId: span.spanId,
+        traceId: span.traceId,
+        name: safeSpanName(span.name),
+        durationMs: Math.round(span.durationMs * 10) / 10,
+        category,
+        status: span.status,
+        ...(route ? { route } : {}),
+        ...(span.nextSpanType ? { nextSpanType: span.nextSpanType } : {}),
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,17 @@
+import { type DiagnosticCounts, type DiagnosticDetailResponse, type DiagnosticFilters, type DiagnosticFinding, type DiagnosticListResponse, type DiagnosticOverview, type DiagnosticReport, type DiagnosticSnapshot, type StackNextConfig } from '@stacknext/core';
+export declare const DIAGNOSTICS_ENGINE_VERSION = "0.6.1";
+export interface DiagnosticEngineOptions {
+    projectName: string;
+    collectorVersion: string;
+    config: StackNextConfig['diagnostics'];
+    generatedAt?: number;
+    connected?: boolean;
+    connectedInstances?: number;
+    engineVersion?: string;
+}
+export declare function countFindings(findings: DiagnosticFinding[]): DiagnosticCounts;
+export declare function generateDiagnosticReport(snapshot: DiagnosticSnapshot, options: DiagnosticEngineOptions): DiagnosticReport;
+export declare function listDiagnosticFindings(report: DiagnosticReport, filters?: DiagnosticFilters): DiagnosticListResponse;
+export declare function getDiagnosticDetail(report: DiagnosticReport, id: string, snapshot: DiagnosticSnapshot): DiagnosticDetailResponse | null;
+export declare function diagnosticOverview(report: DiagnosticReport, topLimit?: number): DiagnosticOverview;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAErB,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EAErB,MAAM,iBAAiB,CAAA;AAGxB,eAAO,MAAM,0BAA0B,UAAU,CAAA;AAEjD,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AA6BD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,CAS7E;AAoDD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CA2BlB;AAOD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,iBAAsB,GAC9B,sBAAsB,CA4CxB;AAmDD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,kBAAkB,GAC3B,wBAAwB,GAAG,IAAI,CAQjC;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,SAAI,GACX,kBAAkB,CAUpB"}

package/dist/engine.js

@@ -0,0 +1,213 @@
+import { STACKNEXT_DIAGNOSTICS_FORMAT, STACKNEXT_DIAGNOSTICS_FORMAT_VERSION, STACKNEXT_DIAGNOSTICS_RULE_SET_VERSION, } from '@stacknext/core';
+import { evaluateDiagnosticRules } from './rules.js';
+export const DIAGNOSTICS_ENGINE_VERSION = '0.6.1';
+const REPORT_LIMITATIONS = [
+    'Findings are deterministic heuristics over the current in-memory sample, not confirmed root causes.',
+    'StackNext does not read application source, run EXPLAIN, inspect query plans or modify code.',
+    'Null durations are unknown, not zero, and span durations include child work.',
+    'Only OpenTelemetry and adapter evidence received by the collector is analyzed.',
+    'Redaction and truncation may reduce the specificity of SQL and error signatures.',
+];
+function emptyCounts() {
+    return {
+        total: 0,
+        bySeverity: { info: 0, warning: 0, error: 0 },
+        byCategory: {
+            database: 0,
+            http: 0,
+            performance: 0,
+            errors: 0,
+            runtime: 0,
+        },
+        byStatus: {
+            observed: 0,
+            'insufficient-evidence': 0,
+            possible: 0,
+        },
+    };
+}
+export function countFindings(findings) {
+    const counts = emptyCounts();
+    counts.total = findings.length;
+    for (const finding of findings) {
+        counts.bySeverity[finding.severity] += 1;
+        counts.byCategory[finding.category] += 1;
+        counts.byStatus[finding.status] += 1;
+    }
+    return counts;
+}
+function sampleFor(snapshot, options) {
+    return {
+        firstEventTime: snapshot.firstEventTime,
+        lastEventTime: snapshot.lastEventTime,
+        retentionMs: snapshot.retentionMs,
+        requests: snapshot.requests.length,
+        spans: snapshot.spans.length,
+        errors: snapshot.errors.length,
+        databaseQueries: snapshot.databaseQueries.length,
+        connectedInstances: options.connectedInstances ?? 0,
+        connected: options.connected ?? false,
+    };
+}
+function buildNotes(snapshot, totalFindings, visibleFindings, config) {
+    const notes = [];
+    if (!config.enabled) {
+        notes.push('Diagnostics are disabled by configuration.');
+        return notes;
+    }
+    if (snapshot.spans.length === 0 &&
+        snapshot.errors.length === 0 &&
+        snapshot.databaseQueries.length === 0) {
+        notes.push('No telemetry is available in the current retention window.');
+        return notes;
+    }
+    if (totalFindings === 0) {
+        notes.push('No diagnostic findings matched the configured rules in the current sample.');
+    }
+    if (totalFindings > visibleFindings) {
+        notes.push(`Showing the top ${visibleFindings} of ${totalFindings} findings. Narrow the filters or raise diagnostics.maxFindings to inspect the rest.`);
+    }
+    if (snapshot.databaseQueries.some((query) => query.durationMs === null)) {
+        notes.push('One or more database queries have no measured duration; null is not treated as zero.');
+    }
+    return notes;
+}
+export function generateDiagnosticReport(snapshot, options) {
+    const requestByTrace = new Map(snapshot.requests.map((request) => [request.traceId, request]));
+    const evaluated = options.config.enabled
+        ? evaluateDiagnosticRules({
+            snapshot,
+            config: options.config,
+            requestByTrace,
+        })
+        : [];
+    const maxFindings = options.config.maxFindings;
+    const findings = evaluated.slice(0, maxFindings);
+    return {
+        format: STACKNEXT_DIAGNOSTICS_FORMAT,
+        version: STACKNEXT_DIAGNOSTICS_FORMAT_VERSION,
+        engineVersion: options.engineVersion ?? DIAGNOSTICS_ENGINE_VERSION,
+        ruleSetVersion: STACKNEXT_DIAGNOSTICS_RULE_SET_VERSION,
+        generatedAt: options.generatedAt ?? Date.now(),
+        projectName: options.projectName,
+        collectorVersion: options.collectorVersion,
+        sample: sampleFor(snapshot, options),
+        counts: countFindings(findings),
+        findings,
+        notes: buildNotes(snapshot, evaluated.length, findings.length, options.config),
+        limitations: [...REPORT_LIMITATIONS],
+    };
+}
+function clampLimit(value, fallback, maximum) {
+    if (!Number.isFinite(value) || value === undefined)
+        return fallback;
+    return Math.min(maximum, Math.max(1, Math.trunc(value)));
+}
+export function listDiagnosticFindings(report, filters = {}) {
+    const q = filters.q?.trim().toLowerCase();
+    const route = filters.route?.trim().toLowerCase();
+    const traceId = filters.traceId?.trim();
+    const items = report.findings.filter((finding) => {
+        if (filters.category && finding.category !== filters.category)
+            return false;
+        if (filters.severity && finding.severity !== filters.severity)
+            return false;
+        if (filters.status && finding.status !== filters.status)
+            return false;
+        if (filters.ruleId && finding.ruleId !== filters.ruleId)
+            return false;
+        if (route && !finding.route?.toLowerCase().includes(route))
+            return false;
+        if (traceId && !finding.traceIds.includes(traceId))
+            return false;
+        if (filters.since !== undefined && finding.lastSeen < filters.since)
+            return false;
+        if (filters.until !== undefined && finding.firstSeen > filters.until)
+            return false;
+        if (q &&
+            !(finding.title.toLowerCase().includes(q) ||
+                finding.summary.toLowerCase().includes(q) ||
+                finding.detail.toLowerCase().includes(q) ||
+                finding.fingerprint.toLowerCase().includes(q) ||
+                finding.route?.toLowerCase().includes(q) === true ||
+                finding.ruleId.toLowerCase().includes(q))) {
+            return false;
+        }
+        return true;
+    });
+    const total = items.length;
+    const limit = clampLimit(filters.limit, 50, 200);
+    const offset = Math.max(0, Math.trunc(filters.offset ?? 0));
+    return {
+        items: items.slice(offset, offset + limit),
+        total,
+        limit,
+        offset,
+        generatedAt: report.generatedAt,
+        engineVersion: report.engineVersion,
+        ruleSetVersion: report.ruleSetVersion,
+        sample: report.sample,
+        counts: countFindings(items),
+        notes: report.notes,
+        limitations: report.limitations,
+    };
+}
+function traceContext(traceId, snapshot) {
+    const spans = snapshot.spans
+        .filter((span) => span.traceId === traceId)
+        .sort((a, b) => a.startTime - b.startTime || a.spanId.localeCompare(b.spanId));
+    const errors = snapshot.errors.filter((error) => (error.resolvedTraceId ?? error.traceId ?? null) === traceId);
+    const databaseQueries = snapshot.databaseQueries.filter((query) => query.resolvedTraceId === traceId);
+    if (spans.length === 0 && errors.length === 0 && databaseQueries.length === 0)
+        return null;
+    const request = snapshot.requests.find((entry) => entry.traceId === traceId) ?? null;
+    const eventTimes = [
+        ...spans.map((span) => span.startTime),
+        ...errors.map((error) => error.timestamp),
+        ...databaseQueries.map((query) => query.timestamp),
+    ];
+    const startTime = eventTimes.length > 0 ? Math.min(...eventTimes) : 0;
+    const endTime = spans.reduce((maximum, span) => Math.max(maximum, span.endTime), startTime);
+    const presentSpanIds = new Set(spans.map((span) => span.spanId));
+    const missingParentSpanIds = [
+        ...new Set(spans
+            .map((span) => span.parentSpanId)
+            .filter((parent) => Boolean(parent) && !presentSpanIds.has(parent))),
+    ];
+    return {
+        traceId,
+        request,
+        startTime,
+        endTime,
+        durationMs: Math.max(0, endTime - startTime),
+        spanCount: spans.length,
+        errorCount: errors.length,
+        databaseQueryCount: databaseQueries.length,
+        spans,
+        errors,
+        databaseQueries,
+        missingParentSpanIds,
+    };
+}
+export function getDiagnosticDetail(report, id, snapshot) {
+    const finding = report.findings.find((entry) => entry.id === id);
+    if (!finding)
+        return null;
+    const traceId = finding.traceIds[0] ?? null;
+    return {
+        finding,
+        trace: traceId ? traceContext(traceId, snapshot) : null,
+    };
+}
+export function diagnosticOverview(report, topLimit = 5) {
+    return {
+        generatedAt: report.generatedAt,
+        engineVersion: report.engineVersion,
+        ruleSetVersion: report.ruleSetVersion,
+        sample: report.sample,
+        counts: report.counts,
+        topFindings: report.findings.slice(0, Math.max(1, Math.trunc(topLimit))),
+        limitations: report.limitations,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/fingerprints.d.ts

@@ -0,0 +1,22 @@
+import { type StackNextError } from '@stacknext/core';
+/**
+ * Produces a stable SQL shape without literals or bind parameters. The shape is
+ * used for grouping only; it is never treated as proof of an N+1 pattern.
+ */
+export declare function sqlFingerprint(sql: string): string;
+/** Safe, bounded SQL shape used in finding evidence instead of raw SQL. */
+export declare function sqlPreview(sql: string, maxLength?: number): string;
+/**
+ * Reduces a URL or path to an endpoint shape: credentials, query values,
+ * fragments and ID-like path segments are removed.
+ */
+export declare function httpEndpoint(value: string | undefined): string | null;
+export declare function normalizeErrorMessage(message: string): string;
+export declare function errorOperationCategory(error: StackNextError): string;
+/**
+ * Route-independent error signature. Routes and methods are deliberately
+ * excluded so the same failure can be grouped across entry points.
+ */
+export declare function diagnosticErrorFingerprint(error: StackNextError): string;
+export declare function diagnosticFindingId(ruleId: string, findingFingerprint: string, scope?: string): string;
+//# sourceMappingURL=fingerprints.d.ts.map

package/dist/fingerprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprints.d.ts","sourceRoot":"","sources":["../src/fingerprints.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAMxB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAclD;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAM/D;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAYrE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7D;AAmBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAOpE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQxE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,KAAK,SAAK,GACT,MAAM,CAIR"}

package/dist/fingerprints.js

@@ -0,0 +1,127 @@
+import { fingerprint, stripUrlQuery, } from '@stacknext/core';
+const UUID_PATTERN = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+const LONG_HEX_PATTERN = /\b[0-9a-f]{16,}\b/gi;
+/**
+ * Produces a stable SQL shape without literals or bind parameters. The shape is
+ * used for grouping only; it is never treated as proof of an N+1 pattern.
+ */
+export function sqlFingerprint(sql) {
+    let value = sql.replace(/\/\*[\s\S]*?\*\//g, ' ');
+    value = value.replace(/--[^\n]*/g, ' ');
+    value = value.replace(/\$[a-z_]*\$[\s\S]*?\$[a-z_]*\$/gi, '?');
+    value = value.replace(/'(?:''|[^'])*'/g, '?');
+    value = value.replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, '?');
+    value = value.replace(/\$\d+/g, '?');
+    value = value.replace(/(?<!:):[a-zA-Z_][a-zA-Z0-9_]*/g, '?');
+    value = value.replace(/@[a-zA-Z_][a-zA-Z0-9_]*/g, '?');
+    value = value.replace(/\b[0-9a-f]{16,}\b/gi, '?');
+    value = value.replace(/\b\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/gi, '?');
+    value = value.replace(/\(\s*\?(?:\s*,\s*\?)+\s*\)/g, '(?)');
+    value = value.replace(/\s+/g, ' ').trim().toLowerCase();
+    return value;
+}
+/** Safe, bounded SQL shape used in finding evidence instead of raw SQL. */
+export function sqlPreview(sql, maxLength = 500) {
+    const shape = sqlFingerprint(sql);
+    if (shape.length <= maxLength)
+        return shape;
+    const suffix = '… [truncated]';
+    if (maxLength <= suffix.length)
+        return shape.slice(0, maxLength);
+    return `${shape.slice(0, maxLength - suffix.length)}${suffix}`;
+}
+function normalizePath(pathname) {
+    const segments = pathname.split('/').filter((segment) => segment.length > 0);
+    const normalized = segments.map((segment) => {
+        if (/^\d+$/.test(segment))
+            return ':id';
+        if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(segment)) {
+            return ':id';
+        }
+        if (/^[0-9a-f]{16,}$/i.test(segment))
+            return ':id';
+        if (/^[a-zA-Z0-9_-]{32,}$/.test(segment))
+            return ':id';
+        return segment;
+    });
+    return normalized.length === 0 ? '/' : `/${normalized.join('/')}`;
+}
+/**
+ * Reduces a URL or path to an endpoint shape: credentials, query values,
+ * fragments and ID-like path segments are removed.
+ */
+export function httpEndpoint(value) {
+    if (!value)
+        return null;
+    const stripped = stripUrlQuery(value.trim());
+    if (stripped === '')
+        return null;
+    try {
+        const url = new URL(stripped);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            return null;
+        return `${url.host.toLowerCase()}${normalizePath(url.pathname)}`;
+    }
+    catch {
+        if (!stripped.startsWith('/'))
+            return null;
+        return normalizePath(stripped);
+    }
+}
+export function normalizeErrorMessage(message) {
+    let value = message.toLowerCase();
+    value = value.replace(/https?:\/\/[^\s]+/g, '<url>');
+    value = value.replace(UUID_PATTERN, '<id>');
+    value = value.replace(LONG_HEX_PATTERN, '<hex>');
+    value = value.replace(/\b\d+(?:\.\d+)?\b/g, '<n>');
+    value = value.replace(/'(?:''|[^'])*'/g, '<str>');
+    value = value.replace(/"[^"]*"/g, '<str>');
+    value = value.replace(/\s+/g, ' ').trim();
+    return value.slice(0, 600);
+}
+function stackSignature(stack) {
+    if (!stack)
+        return '';
+    const frames = stack
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('at '))
+        .slice(0, 4)
+        .map((line) => line
+        .replace(/(?:[A-Za-z]:)?[\\/][^\s()]+[\\/]([^\\/()]+)/g, '$1')
+        .replace(/:\d+:\d+/g, ':?:?')
+        .replace(/\b\d+\b/g, '?')
+        .replace(/\s+/g, ' '));
+    return frames.join('|').slice(0, 600);
+}
+export function errorOperationCategory(error) {
+    if (error.routeType)
+        return error.routeType.toLowerCase().slice(0, 80);
+    const text = `${error.name} ${error.message}`.toLowerCase();
+    if (/(sql|database|drizzle|prisma|sqlite|postgres|mysql)/.test(text))
+        return 'database';
+    if (/(fetch|network|http|socket|econn)/.test(text))
+        return 'http';
+    if (/(render|component|jsx|hydration)/.test(text))
+        return 'render';
+    return 'runtime';
+}
+/**
+ * Route-independent error signature. Routes and methods are deliberately
+ * excluded so the same failure can be grouped across entry points.
+ */
+export function diagnosticErrorFingerprint(error) {
+    return fingerprint([
+        'error-fingerprint',
+        error.name.toLowerCase().slice(0, 200),
+        normalizeErrorMessage(error.message),
+        stackSignature(error.stack),
+        errorOperationCategory(error),
+    ]);
+}
+export function diagnosticFindingId(ruleId, findingFingerprint, scope = '') {
+    const first = fingerprint([ruleId, findingFingerprint]);
+    const second = fingerprint([ruleId, findingFingerprint, scope]);
+    return `diag-${first}-${second}`;
+}
+//# sourceMappingURL=fingerprints.js.map

package/dist/fingerprints.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './fingerprints.js';
+export * from './classify.js';
+export * from './rules.js';
+export * from './engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './fingerprints.js';
+export * from './classify.js';
+export * from './rules.js';
+export * from './engine.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/rules.d.ts

@@ -0,0 +1,8 @@
+import { type DiagnosticFinding, type DiagnosticSnapshot, type StackNextConfig, type RequestSummary } from '@stacknext/core';
+export interface DiagnosticRuleContext {
+    snapshot: DiagnosticSnapshot;
+    config: StackNextConfig['diagnostics'];
+    requestByTrace: Map<string, RequestSummary>;
+}
+export declare function evaluateDiagnosticRules(context: DiagnosticRuleContext): DiagnosticFinding[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,iBAAiB,EAEtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAIpB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAkBxB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IACtC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAC5C;AAsZD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAkB3F"}

package/dist/rules.js

@@ -0,0 +1,401 @@
+import { DIAGNOSTIC_RULES, fingerprint, redactText, stripUrlQueryInText, } from '@stacknext/core';
+import { diagnosticSpanCategory, safeRoute, safeSpanName, spanEvidence, spanHttpEndpoint, spanHttpMethod, spanThresholdMs, } from './classify.js';
+import { diagnosticErrorFingerprint, diagnosticFindingId, errorOperationCategory, sqlFingerprint, sqlPreview, } from './fingerprints.js';
+const RULE_VERSION = 1;
+const SAMPLE_LIMITATION = 'Only the current in-memory retention window is analyzed; findings disappear when evidence ages out.';
+const NULL_DURATION_LIMITATION = 'Database durations can be null when an adapter does not measure them. Null is never treated as zero.';
+function ruleSummary(ruleId) {
+    const rule = DIAGNOSTIC_RULES.find((entry) => entry.id === ruleId);
+    if (!rule)
+        throw new Error(`Unknown diagnostic rule: ${ruleId}`);
+    return rule;
+}
+function roundMs(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.round(value * 10) / 10;
+}
+function formatTimestamp(value) {
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? 'unknown time' : date.toISOString();
+}
+function shortText(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.slice(0, maxLength)}…`;
+}
+function queryEvidence(query) {
+    return {
+        id: query.id,
+        traceId: query.traceId ?? null,
+        ...(query.spanId ? { spanId: query.spanId } : {}),
+        sqlFingerprint: sqlFingerprint(query.sql),
+        sqlPreview: sqlPreview(query.sql),
+        durationMs: query.durationMs,
+        databaseSystem: query.databaseSystem,
+        ...(query.operation ? { operation: query.operation } : {}),
+        success: query.success,
+        timestamp: query.timestamp,
+    };
+}
+function errorEvidence(error, groupFingerprint) {
+    const route = safeRoute(error.route);
+    return {
+        id: error.id,
+        name: shortText(stripUrlQueryInText(redactText(error.name, 200)), 200),
+        message: shortText(stripUrlQueryInText(redactText(error.message, 600)), 600),
+        timestamp: error.timestamp,
+        ...(route ? { route } : {}),
+        ...(error.method ? { method: error.method } : {}),
+        traceId: error.resolvedTraceId ?? error.traceId ?? null,
+        fingerprint: groupFingerprint,
+    };
+}
+function routeForTrace(context, traceId) {
+    return safeRoute(context.requestByTrace.get(traceId)?.route);
+}
+function methodForTrace(context, traceId) {
+    return context.requestByTrace.get(traceId)?.method ?? null;
+}
+function nPlusOneFindings(context) {
+    const groups = new Map();
+    for (const query of context.snapshot.databaseQueries) {
+        const traceId = query.resolvedTraceId;
+        if (!traceId)
+            continue;
+        const shape = sqlFingerprint(query.sql);
+        if (shape === '')
+            continue;
+        const key = `${traceId}\u0000${query.databaseSystem.toLowerCase()}\u0000${shape}`;
+        const existing = groups.get(key);
+        if (existing)
+            existing.queries.push(query);
+        else {
+            groups.set(key, {
+                traceId,
+                databaseSystem: query.databaseSystem,
+                shape,
+                queries: [query],
+            });
+        }
+    }
+    const findings = [];
+    for (const group of groups.values()) {
+        if (group.queries.length < context.config.repeatedQueryMin)
+            continue;
+        const queries = [...group.queries].sort((a, b) => a.timestamp - b.timestamp);
+        const first = queries[0];
+        const last = queries[queries.length - 1];
+        if (!first || !last)
+            continue;
+        const rule = ruleSummary('n-plus-one-queries');
+        const route = safeRoute(first.route) ?? routeForTrace(context, group.traceId);
+        const method = methodForTrace(context, group.traceId);
+        const findingFingerprint = fingerprint([
+            'n-plus-one-queries',
+            group.databaseSystem.toLowerCase(),
+            group.shape,
+        ]);
+        const preview = shortText(group.shape, 180);
+        findings.push({
+            id: diagnosticFindingId(rule.id, findingFingerprint, group.traceId),
+            ruleId: rule.id,
+            ruleVersion: RULE_VERSION,
+            category: rule.category,
+            severity: rule.severity,
+            status: 'possible',
+            title: `Possible N+1 queries: ${queries.length} similar ${group.databaseSystem} queries`,
+            summary: `${queries.length} queries with the same normalized SQL shape ran in one trace: ${preview}`,
+            detail: `The same normalized SQL shape ran ${queries.length} times in trace ${group.traceId}${route ? ` (${route})` : ''}. This is consistent with a per-item query loop, but StackNext cannot confirm an N+1 bug without reviewing the calling code.`,
+            route,
+            method,
+            traceIds: [group.traceId],
+            firstSeen: first.timestamp,
+            lastSeen: last.timestamp,
+            fingerprint: findingFingerprint,
+            evidence: {
+                traceIds: [group.traceId],
+                spans: [],
+                queries: queries.slice(0, 10).map(queryEvidence),
+                errors: [],
+                measurements: [
+                    { label: 'matching queries', value: queries.length },
+                    { label: 'threshold', value: context.config.repeatedQueryMin },
+                    { label: 'database system', value: group.databaseSystem },
+                    { label: 'normalized SQL shape', value: preview },
+                ],
+            },
+            verification: [
+                'Confirm that the query count matches a list size, page size or other per-item loop.',
+                'Inspect the calling code and ORM loading strategy; StackNext does not read source or run EXPLAIN.',
+                'Compare the behavior with a batched or joined query and verify the count drops.',
+            ],
+            limitations: [
+                SAMPLE_LIMITATION,
+                NULL_DURATION_LIMITATION,
+                'SQL bind values are never captured; the fingerprint replaces literals and parameters.',
+                'Repeated query shapes can be intentional, for example when fetching independent resources.',
+            ],
+        });
+    }
+    return findings;
+}
+function slowSpanFindings(context) {
+    const findings = [];
+    for (const span of context.snapshot.spans) {
+        if (!Number.isFinite(span.durationMs) || span.durationMs <= 0)
+            continue;
+        const category = diagnosticSpanCategory(span);
+        const threshold = spanThresholdMs(category, context.config);
+        if (span.durationMs < threshold)
+            continue;
+        const rule = ruleSummary('slow-span');
+        const request = context.requestByTrace.get(span.traceId);
+        const route = safeRoute(span.route) ?? routeForTrace(context, span.traceId);
+        const method = span.method ?? request?.method ?? null;
+        const findingFingerprint = fingerprint([
+            'slow-span',
+            category,
+            span.name,
+            span.nextSpanType ?? '',
+        ]);
+        const duration = roundMs(span.durationMs);
+        const displayName = safeSpanName(span.name);
+        const evidenceSpan = spanEvidence(span, category);
+        const relatedQueries = context.snapshot.databaseQueries
+            .filter((query) => query.spanId === span.spanId && query.traceId === span.traceId)
+            .slice(0, 5)
+            .map(queryEvidence);
+        findings.push({
+            id: diagnosticFindingId(rule.id, findingFingerprint, `${span.traceId}:${span.spanId}`),
+            ruleId: rule.id,
+            ruleVersion: RULE_VERSION,
+            category: rule.category,
+            severity: rule.severity,
+            status: 'observed',
+            title: `Slow ${category} span: ${shortText(displayName, 120)}`,
+            summary: `${duration} ms exceeded the ${threshold} ms ${category} threshold in trace ${span.traceId}.`,
+            detail: `Span ${displayName} (${span.spanId}) took ${duration} ms, above the configured ${threshold} ms threshold for ${category} spans. Span duration includes child work, so it must not be summed with overlapping spans.`,
+            route,
+            method,
+            traceIds: [span.traceId],
+            firstSeen: span.startTime,
+            lastSeen: span.startTime,
+            fingerprint: findingFingerprint,
+            evidence: {
+                traceIds: [span.traceId],
+                spans: [evidenceSpan],
+                queries: relatedQueries,
+                errors: [],
+                measurements: [
+                    { label: 'duration', value: duration, unit: 'ms' },
+                    { label: 'threshold', value: threshold, unit: 'ms' },
+                    { label: 'span category', value: category },
+                ],
+            },
+            verification: [
+                'Confirm the duration was measured rather than estimated.',
+                'Check whether child spans, queueing or cold starts explain the duration.',
+                'Reproduce under the same conditions before changing code or infrastructure.',
+            ],
+            limitations: [
+                SAMPLE_LIMITATION,
+                'Span duration includes child work and is not additive across overlapping spans.',
+                'A threshold crossing is evidence of slow work, not proof of the cause.',
+                'Clock skew between processes can distort span timing.',
+            ],
+        });
+    }
+    return findings;
+}
+function repeatedHttpFindings(context) {
+    const groups = new Map();
+    for (const span of context.snapshot.spans) {
+        if (diagnosticSpanCategory(span) !== 'http')
+            continue;
+        const endpoint = spanHttpEndpoint(span);
+        if (!endpoint)
+            continue;
+        const method = spanHttpMethod(span) ?? 'UNKNOWN';
+        const key = `${span.traceId}\u0000${method}\u0000${endpoint}`;
+        const existing = groups.get(key);
+        if (existing)
+            existing.spans.push(span);
+        else
+            groups.set(key, { traceId: span.traceId, method, endpoint, spans: [span] });
+    }
+    const findings = [];
+    for (const group of groups.values()) {
+        if (group.spans.length < context.config.repeatedHttpMin)
+            continue;
+        const spans = [...group.spans].sort((a, b) => a.startTime - b.startTime);
+        const first = spans[0];
+        const last = spans[spans.length - 1];
+        if (!first || !last)
+            continue;
+        const rule = ruleSummary('repeated-external-http');
+        const request = context.requestByTrace.get(group.traceId);
+        const route = routeForTrace(context, group.traceId);
+        const method = request?.method ?? null;
+        const findingFingerprint = fingerprint([
+            'repeated-external-http',
+            group.method,
+            group.endpoint,
+        ]);
+        findings.push({
+            id: diagnosticFindingId(rule.id, findingFingerprint, group.traceId),
+            ruleId: rule.id,
+            ruleVersion: RULE_VERSION,
+            category: rule.category,
+            severity: rule.severity,
+            status: 'possible',
+            title: `Repeated HTTP calls: ${group.method} ${shortText(group.endpoint, 140)}`,
+            summary: `${spans.length} outbound ${group.method} calls to ${group.endpoint} ran in trace ${group.traceId}.`,
+            detail: `The same outbound endpoint was called ${spans.length} times in one trace. This may indicate missing caching or request deduplication, but repeated calls can be intentional.`,
+            route,
+            method,
+            traceIds: [group.traceId],
+            firstSeen: first.startTime,
+            lastSeen: last.startTime,
+            fingerprint: findingFingerprint,
+            evidence: {
+                traceIds: [group.traceId],
+                spans: spans.slice(0, 10).map((span) => spanEvidence(span, 'http')),
+                queries: [],
+                errors: [],
+                measurements: [
+                    { label: 'matching calls', value: spans.length },
+                    { label: 'threshold', value: context.config.repeatedHttpMin },
+                    { label: 'method', value: group.method },
+                    { label: 'endpoint', value: group.endpoint },
+                ],
+            },
+            verification: [
+                'Confirm the calls target the same logical resource and are not intentionally independent.',
+                'Check whether caching, request deduplication or batching is appropriate.',
+                'Verify the endpoint count changes after the fix.',
+            ],
+            limitations: [
+                SAMPLE_LIMITATION,
+                'Only fetch spans that StackNext receives can be counted; missing instrumentation hides calls.',
+                'Query strings and credentials are removed, so different query values share one endpoint.',
+                'Repeated calls may be intentional, for example retries or independent resources.',
+            ],
+        });
+    }
+    return findings;
+}
+function errorGroupFindings(context) {
+    if (!context.config.errorGrouping)
+        return [];
+    const groups = new Map();
+    for (const error of context.snapshot.errors) {
+        const key = diagnosticErrorFingerprint(error);
+        const existing = groups.get(key);
+        if (existing)
+            existing.push(error);
+        else
+            groups.set(key, [error]);
+    }
+    const findings = [];
+    for (const [groupFingerprint, errors] of groups.entries()) {
+        if (errors.length < context.config.errorGroupMin)
+            continue;
+        const sorted = [...errors].sort((a, b) => b.timestamp - a.timestamp);
+        const latest = sorted[0];
+        if (!latest)
+            continue;
+        const rule = ruleSummary('error-fingerprint');
+        const routes = [
+            ...new Set(sorted
+                .map((error) => error.route ?? error.requestPath ?? null)
+                .filter((route) => Boolean(route))
+                .map((route) => safeRoute(route))
+                .filter((route) => Boolean(route))),
+        ];
+        const methods = [
+            ...new Set(sorted
+                .map((error) => error.method ?? null)
+                .filter((method) => Boolean(method))),
+        ];
+        const route = routes.length === 1 ? routes[0] ?? null : null;
+        const method = methods.length === 1 ? methods[0] ?? null : null;
+        const traceIds = [
+            ...new Set(sorted
+                .map((error) => error.resolvedTraceId ?? error.traceId ?? null)
+                .filter((traceId) => Boolean(traceId))),
+        ];
+        const traceLastSeen = new Map();
+        for (const error of sorted) {
+            const traceId = error.resolvedTraceId ?? error.traceId ?? null;
+            if (!traceId)
+                continue;
+            const previous = traceLastSeen.get(traceId);
+            if (previous === undefined || error.timestamp > previous) {
+                traceLastSeen.set(traceId, error.timestamp);
+            }
+        }
+        traceIds.sort((a, b) => (traceLastSeen.get(b) ?? 0) - (traceLastSeen.get(a) ?? 0) || a.localeCompare(b));
+        const operation = errorOperationCategory(latest);
+        const safeName = shortText(stripUrlQueryInText(redactText(latest.name, 200)), 120);
+        findings.push({
+            id: diagnosticFindingId(rule.id, groupFingerprint),
+            ruleId: rule.id,
+            ruleVersion: RULE_VERSION,
+            category: rule.category,
+            severity: rule.severity,
+            status: 'observed',
+            title: `Repeated error: ${safeName}`,
+            summary: `${errors.length} occurrences across ${traceIds.length} trace${traceIds.length === 1 ? '' : 's'} share a route-independent error signature.`,
+            detail: `The latest occurrence is ${latest.id} at ${formatTimestamp(latest.timestamp)}. Grouping uses the normalized error name, message, stack shape and operation category (${operation}), not the route. Grouping is heuristic and does not establish a root cause.`,
+            route,
+            method,
+            traceIds,
+            firstSeen: Math.min(...errors.map((error) => error.timestamp)),
+            lastSeen: latest.timestamp,
+            fingerprint: groupFingerprint,
+            evidence: {
+                traceIds,
+                spans: [],
+                queries: [],
+                errors: sorted.slice(0, 10).map((error) => errorEvidence(error, groupFingerprint)),
+                measurements: [
+                    { label: 'occurrences', value: errors.length },
+                    { label: 'threshold', value: context.config.errorGroupMin },
+                    { label: 'traces', value: traceIds.length },
+                    { label: 'operation category', value: operation },
+                    { label: 'latest error id', value: latest.id },
+                ],
+            },
+            verification: [
+                'Confirm the grouped occurrences share the same code path and failure mode.',
+                'Inspect the latest trace and error record before changing code.',
+                'After a fix, verify the group stops growing in a fresh sample window.',
+            ],
+            limitations: [
+                SAMPLE_LIMITATION,
+                'Grouping is heuristic; different root causes can share a normalized message or stack shape.',
+                'Redaction and truncation can reduce the specificity of error signatures.',
+                'Routes and methods are intentionally excluded from the group fingerprint.',
+            ],
+        });
+    }
+    return findings;
+}
+export function evaluateDiagnosticRules(context) {
+    const findings = [
+        ...nPlusOneFindings(context),
+        ...slowSpanFindings(context),
+        ...repeatedHttpFindings(context),
+        ...errorGroupFindings(context),
+    ];
+    const severityRank = {
+        error: 0,
+        warning: 1,
+        info: 2,
+    };
+    return findings.sort((a, b) => severityRank[a.severity] - severityRank[b.severity] ||
+        b.lastSeen - a.lastSeen ||
+        a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@stacknext/diagnostics",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.1",
+  "description": "Deterministic, evidence-backed runtime diagnostics for StackNext telemetry",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@stacknext/core": "0.6.1"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "author": "StackNext contributors",
+  "homepage": "https://github.com/marrrkkk/stacknext#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marrrkkk/stacknext.git",
+    "directory": "packages/diagnostics"
+  },
+  "bugs": {
+    "url": "https://github.com/marrrkkk/stacknext/issues"
+  },
+  "keywords": [
+    "stacknext",
+    "nextjs",
+    "diagnostics",
+    "n-plus-one",
+    "observability",
+    "debugging"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }