crumbtrail-node 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1795,6 +1795,13 @@ declare class McpServer {
     /** Shared failed-requests body; notFoundMsg differs per caller. */
     private failedRequestsFor;
     private toolListSessions;
+    /**
+     * Surfaces release/build as first-class list-row fields regardless of which
+     * alias the app used (release/releaseId/version, build/buildId/commit/sha), so
+     * an agent can label and group sessions by release without re-reading each
+     * meta. Additive: the raw meta keys are preserved.
+     */
+    private withReleaseBuild;
     private sessionMetadataMatches;
     private toolGetIndex;
     private toolGetEvents;
@@ -2487,8 +2494,8 @@ interface SessionComparison {
     schemaVersion: typeof SESSION_COMPARE_SCHEMA_VERSION;
     verdict: ComparisonVerdict;
     confidence: ComparisonConfidence;
-    a: SessionRef;
-    b: SessionRef;
+    a: SessionRef$1;
+    b: SessionRef$1;
     alignment: {
         matchedSteps: number;
         unmatchedA: number;
@@ -2503,8 +2510,49 @@ interface SessionComparison {
     evidence: EvidenceItem[];
     /** Intent inference. Empty until the git-host connector (slice 2) lands. */
     intent: IntentSignal[];
+    /**
+     * Structured environment/flag/config/release/build delta between A and B —
+     * the "works in QA, fails in prod, here is the config delta" channel. Present
+     * only when the env plane diverges (mirrors the single `env.snapshot`
+     * divergence). Additive: existing consumers that ignore it are unaffected.
+     */
+    envDelta?: EnvDiff;
+}
+/** One environment key that was added, removed, or changed between two sessions. */
+interface EnvValueChange {
+    key: string;
+    /** Value in session A. Omitted for keys added in B. */
+    before?: unknown;
+    /** Value in session B. Omitted for keys removed in B. */
+    after?: unknown;
 }
-interface SessionRef {
+/** Added/removed/changed breakdown for one env channel (flags or config). */
+interface EnvChannelDelta {
+    added: EnvValueChange[];
+    removed: EnvValueChange[];
+    changed: EnvValueChange[];
+}
+/**
+ * A clear added/removed/changed delta of the declared environment between two
+ * sessions: feature flags, config, and the release/build labels. Only the keys
+ * the noise model treats as real signal appear here (timestamp/uuid churn is
+ * suppressed exactly as in the divergence channel).
+ */
+interface EnvDiff {
+    flags: EnvChannelDelta;
+    config: EnvChannelDelta;
+    /** Present only when the release label differs between A and B. */
+    release?: {
+        before?: string;
+        after?: string;
+    };
+    /** Present only when the build/commit label differs between A and B. */
+    build?: {
+        before?: string;
+        after?: string;
+    };
+}
+interface SessionRef$1 {
     sessionId: string;
     release?: string;
     build?: string;
@@ -2519,6 +2567,12 @@ interface Divergence {
     before: unknown;
     after: unknown;
     brief: string;
+    /**
+     * Structured added/removed/changed breakdown, attached to the env-plane
+     * `env.snapshot` divergence. Lets consumers render the config delta without
+     * re-diffing the opaque before/after blobs. Undefined on all other planes.
+     */
+    envDelta?: EnvDiff;
 }
 interface CompareOptions {
     alignmentWindow?: number;
@@ -2530,12 +2584,27 @@ declare class CompareError extends Error {
 }
 declare function compareSessions(aDir: string, bDir: string, options?: CompareOptions): Promise<SessionComparison>;
 
+type SessionRef = SessionComparison["a"];
 declare function renderCompareReport(comparison: SessionComparison): string;
 declare function formatComparisonSummary(comparison: SessionComparison): string;
+/**
+ * Short, release-first label for a session: the release tag when one exists
+ * (e.g. "R181"), otherwise the bare session id. Used to build "R181 vs R182"
+ * comparison titles. Exported so the regression witness reuses one convention.
+ */
+declare function sessionRefLabel(ref: SessionRef): string;
+/** "R181 vs R182" when releases exist, else falls back to bare session ids. */
+declare function comparisonTitle(comparison: SessionComparison): string;
 
 declare const REGRESSION_CONTEXT_SCHEMA_VERSION: "regression-context.v1";
 interface RegressionContext {
     schemaVersion: typeof REGRESSION_CONTEXT_SCHEMA_VERSION;
+    /**
+     * Release-first witness title, e.g. "R181 vs R182", falling back to bare
+     * session ids when no release metadata exists. Lets a consumer name the
+     * regression by release without re-deriving it from the comparison.
+     */
+    title: string;
     comparison: SessionComparison;
     divergent_interaction: {
         sig: string;
@@ -2554,6 +2623,12 @@ interface RegressionContext {
         before: unknown;
         after: unknown;
     }>;
+    /**
+     * The "works in QA, fails in prod, here is the config delta" channel: the
+     * structured added/removed/changed env/flag/config/release/build delta between
+     * the two sessions. Null when the env plane did not diverge.
+     */
+    env_delta: EnvDiff | null;
     repro_hint: string;
 }
 declare function buildRegressionContext(comparison: SessionComparison, bDir: string): RegressionContext;
@@ -2795,4 +2870,4 @@ interface OtlpLogsRequest {
 declare function decodeOtlpTraceProtobuf(buffer: Uint8Array): OtlpTraceRequest;
 declare function decodeOtlpLogsProtobuf(buffer: Uint8Array): OtlpLogsRequest;
 
-export { AUTO_CAPTURE_ERROR_EVENT, type AdapterEvidence, type AdapterSourceStats, type AdfDoc, type AdfNode, type AdvisoryCommentGap, type AdvisoryCommentMatch, type AutoCaptureHandle, type AutoCaptureOptions, type AutoCaptureSource, type BoundedRetryOptions, type BugQueueConfig, BugQueueManager, type BuildAdvisoryCommentInput, type BuildDbDiffEventInput, type BuildDbReadBulkEventInput, type BuildDbReadEventInput, type BuildFixContextOptions, CLOUDFLARE_AUTH_FIELDS, CLOUDFLARE_DESCRIPTOR, CLOUDFLARE_R2_ACCESS_KEY_ID_ENV, CLOUDFLARE_R2_ACCOUNT_ID_ENV, CLOUDFLARE_R2_BUCKET_ENV, CLOUDFLARE_R2_DATASET_ENV, CLOUDFLARE_R2_ENDPOINT_ENV, CLOUDFLARE_R2_PREFIX_ENV, CLOUDFLARE_R2_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_ACCESS_KEY_ID_ENV, CLOUDWATCH_AUTH_FIELDS, CLOUDWATCH_DESCRIPTOR, CLOUDWATCH_ENDPOINT_ENV, CLOUDWATCH_LOG_GROUPS_ENV, CLOUDWATCH_REGION_ENV, CLOUDWATCH_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_SESSION_TOKEN_ENV, CRUMBTRAIL_USER_AGENT, CloudWatchEvidenceSource, type CloudWatchQueryPlan, type CloudWatchResultRow, type CloudWatchSourceConfig, type CloudflareDataset, CloudflareEvidenceSource, type CloudflarePlan, type CloudflareSourceConfig, type CommentingTicketConnector, CompareError, type CompareOptions, type ComparisonConfidence, type ComparisonVerdict, type CrumbtrailExpressErrorMiddleware, type CrumbtrailExpressErrorNext, type CrumbtrailExpressMiddleware, type CrumbtrailExpressNext, type CrumbtrailExpressOptions, type CrumbtrailExpressRequest, type CrumbtrailExpressResponse, type BackendIntakeWarning as CrumbtrailExpressWarning, type BackendIntakeWarningKind as CrumbtrailExpressWarningKind, DATADOG_API_KEY_ENV, DATADOG_APP_KEY_ENV, DATADOG_AUTH_FIELDS, DATADOG_DEFAULT_SITE, DATADOG_DESCRIPTOR, DATADOG_SITE_ENV, DEFAULT_MAX_TOTAL_BYTES, DEFAULT_SENSITIVE_DB_COLUMNS, DEFAULT_SOURCE_TIMEOUT_MS, DEFAULT_SWEEP_CHECKPOINT_MS, DEFAULT_SWEEP_IDLE_MS, DEFAULT_SWEEP_INTERVAL_MS, DISTINCT_BUGS_SCHEMA_VERSION, DatadogEvidenceSource, type DatadogLog, type DatadogQueryPlan, type DatadogSourceConfig, type DatadogSpan, type DbRequestContext, type DistinctBug, type DistinctBugEvidenceRef, type DistinctBugRecurrence, type DistinctBugRecurrenceInput, type DistinctBugRecurrenceOccurrence, type DistinctBugSeverity, type Divergence, type DuckTypedMssqlPool, type DuckTypedMssqlRequest, type DuckTypedMssqlResult, type DuckTypedMysqlClient, type DuckTypedMysqlResultHeader, type DuckTypedPgClient, type DuckTypedPgQueryResult, type DuckTypedSqliteDatabase, type DuckTypedSqliteRunResult, type DuckTypedSqliteStatement, EVIDENCE_SOURCE_PROVIDERS, CRUMBTRAIL_USER_AGENT as EVIDENCE_SOURCE_USER_AGENT, type EvidenceSource, type EvidenceSourceProvider, FIX_CONTEXT_SCHEMA_VERSION, type FetchAdapterEvidenceOptions, FilesystemSessionStore, type FixContext, type FixContextDbDiff, type FixContextDbRead, FixContextError, type FixContextPrimaryWindow, type FixContextReproHint, type FixContextSession, type HeadlessSession, type HeadlessSessionOptions, InspectError, type InspectSessionOptions, type InstrumentDbClientOptions, type InstrumentPgClientOptions, type JiraAuth, type JiraBasicAuth, type JiraBearerAuth, JiraTicketClient, type JiraTicketClientConfig, type JiraTicketClientConfigLegacy, type JiraTicketClientConfigWithAuth, McpServer, type McpServerConfig, type OtlpLogsRequest, type OtlpResourceLogs, type OtlpResourceSpans, type OtlpTraceRequest, POSTHOG_API_KEY_ENV, POSTHOG_AUTH_FIELDS, POSTHOG_DEFAULT_HOST, POSTHOG_DESCRIPTOR, POSTHOG_HOST_ENV, POSTHOG_PROJECT_ID_ENV, PROVIDER_IDS, PROVIDER_RECIPES, type PostHogEvent, PostHogEvidenceSource, type PostHogPropertyFilter, type PostHogQueryPlan, type PostHogRecording, type PostHogSourceConfig, type ProviderId, type ProviderRecipe, REGRESSION_CONTEXT_SCHEMA_VERSION, REPLAY_RESULT_SCHEMA_VERSION, type RegressionContext, type ReplayDivergence, type ReplayResult, type ReplayStepResult, SENTRY_AUTH_FIELDS, SENTRY_AUTH_TOKEN_ENV, SENTRY_DEFAULT_HOST, SENTRY_DESCRIPTOR, SENTRY_HOST_ENV, SENTRY_ORG_ENV, SESSION_COMPARE_SCHEMA_VERSION, SPLUNK_AUTH_FIELDS, SPLUNK_DESCRIPTOR, SPLUNK_HOST_ENV, SPLUNK_INDEX_ENV, SPLUNK_TOKEN_ENV, SPLUNK_WEB_URL_ENV, SentryEvidenceSource, type SentryQueryPlan, type SentrySourceConfig, type BugReport as ServerBugReport, type ServerConfig, type SessionComparison, type SessionFileFlags, type SessionFinalizationResult, type SessionInspection, type SessionInspectionArtifact, type SessionListItem, SessionManager, type SessionStore, type SessionSummary, type SessionSweepOptions, type SessionSweepResult, type SessionSweeperHandle, type Severity, type SigV4Input, type SignedHeaders, type SourceHealth, SplunkEvidenceSource, type SplunkQueryPlan, type SplunkResultRow, type SplunkSourceConfig, type StepResolution, type TicketConnector, TicketError, type TicketProvider, autoCapture, buildAdvisoryComment, buildCloudWatchQuery, buildCloudflarePlan, buildDatadogQuery, buildDbDiffEvent, buildDbReadBulkEvent, buildDbReadEvent, buildDistinctBugSignature, buildFixContext, buildPostHogQuery, buildRegressionContext, buildReplayResult, buildSentryQuery, buildSessionSummary, buildSplunkQuery, cloudWatchDeepLink, cloudWatchEvidenceProvider, cloudflareEvidenceProvider, compareSessions, createCrumbtrailExpressErrorMiddleware, createCrumbtrailExpressMiddleware, createServer, datadogAppBase, datadogEvidenceProvider, decodeOtlpLogsProtobuf, decodeOtlpTraceProtobuf, defaultSessionStore, evidenceRequestHeaders, evidenceSourcesFromEnv, fetchAdapterEvidence, formatComparisonSummary, formatDuration, formatInspection, getProviderRecipe, groupDistinctBugRecurrences, groupDistinctBugs, inspectSession, instrumentMssqlPool, instrumentMysqlClient, instrumentPgClient, instrumentSqliteDatabase, isProviderId, jiraToSymptom, normalizeCloudWatchRow, normalizeDatadogLog, normalizeDatadogSpan, normalizePostHogEvent, normalizePostHogRecording, normalizeSentryIssue, normalizeSplunkRow, parseMutation, parseRead, parseReplayResult, posthogEventDeepLink, posthogEvidenceProvider, posthogRecordingDeepLink, readPackageVersion, redactEvidenceGap, redactEvidenceItem, redactSourceResult, registerEvidenceProvider, renderCompareReport, renderProviderCliOutput, renderProviderConfig, renderProviderDoc, renderProviderReadme, resolveDbRequestContext, sentryEvidenceProvider, signSigV4, splunkEvidenceProvider, splunkSearchDeepLink, splunkWebBase, startHeadlessSession, startSessionSweeper, sweepIdleSessions, withBoundedRetry, writeReplayResult };
+export { AUTO_CAPTURE_ERROR_EVENT, type AdapterEvidence, type AdapterSourceStats, type AdfDoc, type AdfNode, type AdvisoryCommentGap, type AdvisoryCommentMatch, type AutoCaptureHandle, type AutoCaptureOptions, type AutoCaptureSource, type BoundedRetryOptions, type BugQueueConfig, BugQueueManager, type BuildAdvisoryCommentInput, type BuildDbDiffEventInput, type BuildDbReadBulkEventInput, type BuildDbReadEventInput, type BuildFixContextOptions, CLOUDFLARE_AUTH_FIELDS, CLOUDFLARE_DESCRIPTOR, CLOUDFLARE_R2_ACCESS_KEY_ID_ENV, CLOUDFLARE_R2_ACCOUNT_ID_ENV, CLOUDFLARE_R2_BUCKET_ENV, CLOUDFLARE_R2_DATASET_ENV, CLOUDFLARE_R2_ENDPOINT_ENV, CLOUDFLARE_R2_PREFIX_ENV, CLOUDFLARE_R2_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_ACCESS_KEY_ID_ENV, CLOUDWATCH_AUTH_FIELDS, CLOUDWATCH_DESCRIPTOR, CLOUDWATCH_ENDPOINT_ENV, CLOUDWATCH_LOG_GROUPS_ENV, CLOUDWATCH_REGION_ENV, CLOUDWATCH_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_SESSION_TOKEN_ENV, CRUMBTRAIL_USER_AGENT, CloudWatchEvidenceSource, type CloudWatchQueryPlan, type CloudWatchResultRow, type CloudWatchSourceConfig, type CloudflareDataset, CloudflareEvidenceSource, type CloudflarePlan, type CloudflareSourceConfig, type CommentingTicketConnector, CompareError, type CompareOptions, type ComparisonConfidence, type ComparisonVerdict, type CrumbtrailExpressErrorMiddleware, type CrumbtrailExpressErrorNext, type CrumbtrailExpressMiddleware, type CrumbtrailExpressNext, type CrumbtrailExpressOptions, type CrumbtrailExpressRequest, type CrumbtrailExpressResponse, type BackendIntakeWarning as CrumbtrailExpressWarning, type BackendIntakeWarningKind as CrumbtrailExpressWarningKind, DATADOG_API_KEY_ENV, DATADOG_APP_KEY_ENV, DATADOG_AUTH_FIELDS, DATADOG_DEFAULT_SITE, DATADOG_DESCRIPTOR, DATADOG_SITE_ENV, DEFAULT_MAX_TOTAL_BYTES, DEFAULT_SENSITIVE_DB_COLUMNS, DEFAULT_SOURCE_TIMEOUT_MS, DEFAULT_SWEEP_CHECKPOINT_MS, DEFAULT_SWEEP_IDLE_MS, DEFAULT_SWEEP_INTERVAL_MS, DISTINCT_BUGS_SCHEMA_VERSION, DatadogEvidenceSource, type DatadogLog, type DatadogQueryPlan, type DatadogSourceConfig, type DatadogSpan, type DbRequestContext, type DistinctBug, type DistinctBugEvidenceRef, type DistinctBugRecurrence, type DistinctBugRecurrenceInput, type DistinctBugRecurrenceOccurrence, type DistinctBugSeverity, type Divergence, type DuckTypedMssqlPool, type DuckTypedMssqlRequest, type DuckTypedMssqlResult, type DuckTypedMysqlClient, type DuckTypedMysqlResultHeader, type DuckTypedPgClient, type DuckTypedPgQueryResult, type DuckTypedSqliteDatabase, type DuckTypedSqliteRunResult, type DuckTypedSqliteStatement, EVIDENCE_SOURCE_PROVIDERS, CRUMBTRAIL_USER_AGENT as EVIDENCE_SOURCE_USER_AGENT, type EnvChannelDelta, type EnvDiff, type EnvValueChange, type EvidenceSource, type EvidenceSourceProvider, FIX_CONTEXT_SCHEMA_VERSION, type FetchAdapterEvidenceOptions, FilesystemSessionStore, type FixContext, type FixContextDbDiff, type FixContextDbRead, FixContextError, type FixContextPrimaryWindow, type FixContextReproHint, type FixContextSession, type HeadlessSession, type HeadlessSessionOptions, InspectError, type InspectSessionOptions, type InstrumentDbClientOptions, type InstrumentPgClientOptions, type JiraAuth, type JiraBasicAuth, type JiraBearerAuth, JiraTicketClient, type JiraTicketClientConfig, type JiraTicketClientConfigLegacy, type JiraTicketClientConfigWithAuth, McpServer, type McpServerConfig, type OtlpLogsRequest, type OtlpResourceLogs, type OtlpResourceSpans, type OtlpTraceRequest, POSTHOG_API_KEY_ENV, POSTHOG_AUTH_FIELDS, POSTHOG_DEFAULT_HOST, POSTHOG_DESCRIPTOR, POSTHOG_HOST_ENV, POSTHOG_PROJECT_ID_ENV, PROVIDER_IDS, PROVIDER_RECIPES, type PostHogEvent, PostHogEvidenceSource, type PostHogPropertyFilter, type PostHogQueryPlan, type PostHogRecording, type PostHogSourceConfig, type ProviderId, type ProviderRecipe, REGRESSION_CONTEXT_SCHEMA_VERSION, REPLAY_RESULT_SCHEMA_VERSION, type RegressionContext, type ReplayDivergence, type ReplayResult, type ReplayStepResult, SENTRY_AUTH_FIELDS, SENTRY_AUTH_TOKEN_ENV, SENTRY_DEFAULT_HOST, SENTRY_DESCRIPTOR, SENTRY_HOST_ENV, SENTRY_ORG_ENV, SESSION_COMPARE_SCHEMA_VERSION, SPLUNK_AUTH_FIELDS, SPLUNK_DESCRIPTOR, SPLUNK_HOST_ENV, SPLUNK_INDEX_ENV, SPLUNK_TOKEN_ENV, SPLUNK_WEB_URL_ENV, SentryEvidenceSource, type SentryQueryPlan, type SentrySourceConfig, type BugReport as ServerBugReport, type ServerConfig, type SessionComparison, type SessionFileFlags, type SessionFinalizationResult, type SessionInspection, type SessionInspectionArtifact, type SessionListItem, SessionManager, type SessionStore, type SessionSummary, type SessionSweepOptions, type SessionSweepResult, type SessionSweeperHandle, type Severity, type SigV4Input, type SignedHeaders, type SourceHealth, SplunkEvidenceSource, type SplunkQueryPlan, type SplunkResultRow, type SplunkSourceConfig, type StepResolution, type TicketConnector, TicketError, type TicketProvider, autoCapture, buildAdvisoryComment, buildCloudWatchQuery, buildCloudflarePlan, buildDatadogQuery, buildDbDiffEvent, buildDbReadBulkEvent, buildDbReadEvent, buildDistinctBugSignature, buildFixContext, buildPostHogQuery, buildRegressionContext, buildReplayResult, buildSentryQuery, buildSessionSummary, buildSplunkQuery, cloudWatchDeepLink, cloudWatchEvidenceProvider, cloudflareEvidenceProvider, compareSessions, comparisonTitle, createCrumbtrailExpressErrorMiddleware, createCrumbtrailExpressMiddleware, createServer, datadogAppBase, datadogEvidenceProvider, decodeOtlpLogsProtobuf, decodeOtlpTraceProtobuf, defaultSessionStore, evidenceRequestHeaders, evidenceSourcesFromEnv, fetchAdapterEvidence, formatComparisonSummary, formatDuration, formatInspection, getProviderRecipe, groupDistinctBugRecurrences, groupDistinctBugs, inspectSession, instrumentMssqlPool, instrumentMysqlClient, instrumentPgClient, instrumentSqliteDatabase, isProviderId, jiraToSymptom, normalizeCloudWatchRow, normalizeDatadogLog, normalizeDatadogSpan, normalizePostHogEvent, normalizePostHogRecording, normalizeSentryIssue, normalizeSplunkRow, parseMutation, parseRead, parseReplayResult, posthogEventDeepLink, posthogEvidenceProvider, posthogRecordingDeepLink, readPackageVersion, redactEvidenceGap, redactEvidenceItem, redactSourceResult, registerEvidenceProvider, renderCompareReport, renderProviderCliOutput, renderProviderConfig, renderProviderDoc, renderProviderReadme, resolveDbRequestContext, sentryEvidenceProvider, sessionRefLabel, signSigV4, splunkEvidenceProvider, splunkSearchDeepLink, splunkWebBase, startHeadlessSession, startSessionSweeper, sweepIdleSessions, withBoundedRetry, writeReplayResult };

package/dist/index.d.ts

@@ -1795,6 +1795,13 @@ declare class McpServer {
     /** Shared failed-requests body; notFoundMsg differs per caller. */
     private failedRequestsFor;
     private toolListSessions;
+    /**
+     * Surfaces release/build as first-class list-row fields regardless of which
+     * alias the app used (release/releaseId/version, build/buildId/commit/sha), so
+     * an agent can label and group sessions by release without re-reading each
+     * meta. Additive: the raw meta keys are preserved.
+     */
+    private withReleaseBuild;
     private sessionMetadataMatches;
     private toolGetIndex;
     private toolGetEvents;
@@ -2487,8 +2494,8 @@ interface SessionComparison {
     schemaVersion: typeof SESSION_COMPARE_SCHEMA_VERSION;
     verdict: ComparisonVerdict;
     confidence: ComparisonConfidence;
-    a: SessionRef;
-    b: SessionRef;
+    a: SessionRef$1;
+    b: SessionRef$1;
     alignment: {
         matchedSteps: number;
         unmatchedA: number;
@@ -2503,8 +2510,49 @@ interface SessionComparison {
     evidence: EvidenceItem[];
     /** Intent inference. Empty until the git-host connector (slice 2) lands. */
     intent: IntentSignal[];
+    /**
+     * Structured environment/flag/config/release/build delta between A and B —
+     * the "works in QA, fails in prod, here is the config delta" channel. Present
+     * only when the env plane diverges (mirrors the single `env.snapshot`
+     * divergence). Additive: existing consumers that ignore it are unaffected.
+     */
+    envDelta?: EnvDiff;
+}
+/** One environment key that was added, removed, or changed between two sessions. */
+interface EnvValueChange {
+    key: string;
+    /** Value in session A. Omitted for keys added in B. */
+    before?: unknown;
+    /** Value in session B. Omitted for keys removed in B. */
+    after?: unknown;
 }
-interface SessionRef {
+/** Added/removed/changed breakdown for one env channel (flags or config). */
+interface EnvChannelDelta {
+    added: EnvValueChange[];
+    removed: EnvValueChange[];
+    changed: EnvValueChange[];
+}
+/**
+ * A clear added/removed/changed delta of the declared environment between two
+ * sessions: feature flags, config, and the release/build labels. Only the keys
+ * the noise model treats as real signal appear here (timestamp/uuid churn is
+ * suppressed exactly as in the divergence channel).
+ */
+interface EnvDiff {
+    flags: EnvChannelDelta;
+    config: EnvChannelDelta;
+    /** Present only when the release label differs between A and B. */
+    release?: {
+        before?: string;
+        after?: string;
+    };
+    /** Present only when the build/commit label differs between A and B. */
+    build?: {
+        before?: string;
+        after?: string;
+    };
+}
+interface SessionRef$1 {
     sessionId: string;
     release?: string;
     build?: string;
@@ -2519,6 +2567,12 @@ interface Divergence {
     before: unknown;
     after: unknown;
     brief: string;
+    /**
+     * Structured added/removed/changed breakdown, attached to the env-plane
+     * `env.snapshot` divergence. Lets consumers render the config delta without
+     * re-diffing the opaque before/after blobs. Undefined on all other planes.
+     */
+    envDelta?: EnvDiff;
 }
 interface CompareOptions {
     alignmentWindow?: number;
@@ -2530,12 +2584,27 @@ declare class CompareError extends Error {
 }
 declare function compareSessions(aDir: string, bDir: string, options?: CompareOptions): Promise<SessionComparison>;
 
+type SessionRef = SessionComparison["a"];
 declare function renderCompareReport(comparison: SessionComparison): string;
 declare function formatComparisonSummary(comparison: SessionComparison): string;
+/**
+ * Short, release-first label for a session: the release tag when one exists
+ * (e.g. "R181"), otherwise the bare session id. Used to build "R181 vs R182"
+ * comparison titles. Exported so the regression witness reuses one convention.
+ */
+declare function sessionRefLabel(ref: SessionRef): string;
+/** "R181 vs R182" when releases exist, else falls back to bare session ids. */
+declare function comparisonTitle(comparison: SessionComparison): string;
 
 declare const REGRESSION_CONTEXT_SCHEMA_VERSION: "regression-context.v1";
 interface RegressionContext {
     schemaVersion: typeof REGRESSION_CONTEXT_SCHEMA_VERSION;
+    /**
+     * Release-first witness title, e.g. "R181 vs R182", falling back to bare
+     * session ids when no release metadata exists. Lets a consumer name the
+     * regression by release without re-deriving it from the comparison.
+     */
+    title: string;
     comparison: SessionComparison;
     divergent_interaction: {
         sig: string;
@@ -2554,6 +2623,12 @@ interface RegressionContext {
         before: unknown;
         after: unknown;
     }>;
+    /**
+     * The "works in QA, fails in prod, here is the config delta" channel: the
+     * structured added/removed/changed env/flag/config/release/build delta between
+     * the two sessions. Null when the env plane did not diverge.
+     */
+    env_delta: EnvDiff | null;
     repro_hint: string;
 }
 declare function buildRegressionContext(comparison: SessionComparison, bDir: string): RegressionContext;
@@ -2795,4 +2870,4 @@ interface OtlpLogsRequest {
 declare function decodeOtlpTraceProtobuf(buffer: Uint8Array): OtlpTraceRequest;
 declare function decodeOtlpLogsProtobuf(buffer: Uint8Array): OtlpLogsRequest;
 
-export { AUTO_CAPTURE_ERROR_EVENT, type AdapterEvidence, type AdapterSourceStats, type AdfDoc, type AdfNode, type AdvisoryCommentGap, type AdvisoryCommentMatch, type AutoCaptureHandle, type AutoCaptureOptions, type AutoCaptureSource, type BoundedRetryOptions, type BugQueueConfig, BugQueueManager, type BuildAdvisoryCommentInput, type BuildDbDiffEventInput, type BuildDbReadBulkEventInput, type BuildDbReadEventInput, type BuildFixContextOptions, CLOUDFLARE_AUTH_FIELDS, CLOUDFLARE_DESCRIPTOR, CLOUDFLARE_R2_ACCESS_KEY_ID_ENV, CLOUDFLARE_R2_ACCOUNT_ID_ENV, CLOUDFLARE_R2_BUCKET_ENV, CLOUDFLARE_R2_DATASET_ENV, CLOUDFLARE_R2_ENDPOINT_ENV, CLOUDFLARE_R2_PREFIX_ENV, CLOUDFLARE_R2_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_ACCESS_KEY_ID_ENV, CLOUDWATCH_AUTH_FIELDS, CLOUDWATCH_DESCRIPTOR, CLOUDWATCH_ENDPOINT_ENV, CLOUDWATCH_LOG_GROUPS_ENV, CLOUDWATCH_REGION_ENV, CLOUDWATCH_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_SESSION_TOKEN_ENV, CRUMBTRAIL_USER_AGENT, CloudWatchEvidenceSource, type CloudWatchQueryPlan, type CloudWatchResultRow, type CloudWatchSourceConfig, type CloudflareDataset, CloudflareEvidenceSource, type CloudflarePlan, type CloudflareSourceConfig, type CommentingTicketConnector, CompareError, type CompareOptions, type ComparisonConfidence, type ComparisonVerdict, type CrumbtrailExpressErrorMiddleware, type CrumbtrailExpressErrorNext, type CrumbtrailExpressMiddleware, type CrumbtrailExpressNext, type CrumbtrailExpressOptions, type CrumbtrailExpressRequest, type CrumbtrailExpressResponse, type BackendIntakeWarning as CrumbtrailExpressWarning, type BackendIntakeWarningKind as CrumbtrailExpressWarningKind, DATADOG_API_KEY_ENV, DATADOG_APP_KEY_ENV, DATADOG_AUTH_FIELDS, DATADOG_DEFAULT_SITE, DATADOG_DESCRIPTOR, DATADOG_SITE_ENV, DEFAULT_MAX_TOTAL_BYTES, DEFAULT_SENSITIVE_DB_COLUMNS, DEFAULT_SOURCE_TIMEOUT_MS, DEFAULT_SWEEP_CHECKPOINT_MS, DEFAULT_SWEEP_IDLE_MS, DEFAULT_SWEEP_INTERVAL_MS, DISTINCT_BUGS_SCHEMA_VERSION, DatadogEvidenceSource, type DatadogLog, type DatadogQueryPlan, type DatadogSourceConfig, type DatadogSpan, type DbRequestContext, type DistinctBug, type DistinctBugEvidenceRef, type DistinctBugRecurrence, type DistinctBugRecurrenceInput, type DistinctBugRecurrenceOccurrence, type DistinctBugSeverity, type Divergence, type DuckTypedMssqlPool, type DuckTypedMssqlRequest, type DuckTypedMssqlResult, type DuckTypedMysqlClient, type DuckTypedMysqlResultHeader, type DuckTypedPgClient, type DuckTypedPgQueryResult, type DuckTypedSqliteDatabase, type DuckTypedSqliteRunResult, type DuckTypedSqliteStatement, EVIDENCE_SOURCE_PROVIDERS, CRUMBTRAIL_USER_AGENT as EVIDENCE_SOURCE_USER_AGENT, type EvidenceSource, type EvidenceSourceProvider, FIX_CONTEXT_SCHEMA_VERSION, type FetchAdapterEvidenceOptions, FilesystemSessionStore, type FixContext, type FixContextDbDiff, type FixContextDbRead, FixContextError, type FixContextPrimaryWindow, type FixContextReproHint, type FixContextSession, type HeadlessSession, type HeadlessSessionOptions, InspectError, type InspectSessionOptions, type InstrumentDbClientOptions, type InstrumentPgClientOptions, type JiraAuth, type JiraBasicAuth, type JiraBearerAuth, JiraTicketClient, type JiraTicketClientConfig, type JiraTicketClientConfigLegacy, type JiraTicketClientConfigWithAuth, McpServer, type McpServerConfig, type OtlpLogsRequest, type OtlpResourceLogs, type OtlpResourceSpans, type OtlpTraceRequest, POSTHOG_API_KEY_ENV, POSTHOG_AUTH_FIELDS, POSTHOG_DEFAULT_HOST, POSTHOG_DESCRIPTOR, POSTHOG_HOST_ENV, POSTHOG_PROJECT_ID_ENV, PROVIDER_IDS, PROVIDER_RECIPES, type PostHogEvent, PostHogEvidenceSource, type PostHogPropertyFilter, type PostHogQueryPlan, type PostHogRecording, type PostHogSourceConfig, type ProviderId, type ProviderRecipe, REGRESSION_CONTEXT_SCHEMA_VERSION, REPLAY_RESULT_SCHEMA_VERSION, type RegressionContext, type ReplayDivergence, type ReplayResult, type ReplayStepResult, SENTRY_AUTH_FIELDS, SENTRY_AUTH_TOKEN_ENV, SENTRY_DEFAULT_HOST, SENTRY_DESCRIPTOR, SENTRY_HOST_ENV, SENTRY_ORG_ENV, SESSION_COMPARE_SCHEMA_VERSION, SPLUNK_AUTH_FIELDS, SPLUNK_DESCRIPTOR, SPLUNK_HOST_ENV, SPLUNK_INDEX_ENV, SPLUNK_TOKEN_ENV, SPLUNK_WEB_URL_ENV, SentryEvidenceSource, type SentryQueryPlan, type SentrySourceConfig, type BugReport as ServerBugReport, type ServerConfig, type SessionComparison, type SessionFileFlags, type SessionFinalizationResult, type SessionInspection, type SessionInspectionArtifact, type SessionListItem, SessionManager, type SessionStore, type SessionSummary, type SessionSweepOptions, type SessionSweepResult, type SessionSweeperHandle, type Severity, type SigV4Input, type SignedHeaders, type SourceHealth, SplunkEvidenceSource, type SplunkQueryPlan, type SplunkResultRow, type SplunkSourceConfig, type StepResolution, type TicketConnector, TicketError, type TicketProvider, autoCapture, buildAdvisoryComment, buildCloudWatchQuery, buildCloudflarePlan, buildDatadogQuery, buildDbDiffEvent, buildDbReadBulkEvent, buildDbReadEvent, buildDistinctBugSignature, buildFixContext, buildPostHogQuery, buildRegressionContext, buildReplayResult, buildSentryQuery, buildSessionSummary, buildSplunkQuery, cloudWatchDeepLink, cloudWatchEvidenceProvider, cloudflareEvidenceProvider, compareSessions, createCrumbtrailExpressErrorMiddleware, createCrumbtrailExpressMiddleware, createServer, datadogAppBase, datadogEvidenceProvider, decodeOtlpLogsProtobuf, decodeOtlpTraceProtobuf, defaultSessionStore, evidenceRequestHeaders, evidenceSourcesFromEnv, fetchAdapterEvidence, formatComparisonSummary, formatDuration, formatInspection, getProviderRecipe, groupDistinctBugRecurrences, groupDistinctBugs, inspectSession, instrumentMssqlPool, instrumentMysqlClient, instrumentPgClient, instrumentSqliteDatabase, isProviderId, jiraToSymptom, normalizeCloudWatchRow, normalizeDatadogLog, normalizeDatadogSpan, normalizePostHogEvent, normalizePostHogRecording, normalizeSentryIssue, normalizeSplunkRow, parseMutation, parseRead, parseReplayResult, posthogEventDeepLink, posthogEvidenceProvider, posthogRecordingDeepLink, readPackageVersion, redactEvidenceGap, redactEvidenceItem, redactSourceResult, registerEvidenceProvider, renderCompareReport, renderProviderCliOutput, renderProviderConfig, renderProviderDoc, renderProviderReadme, resolveDbRequestContext, sentryEvidenceProvider, signSigV4, splunkEvidenceProvider, splunkSearchDeepLink, splunkWebBase, startHeadlessSession, startSessionSweeper, sweepIdleSessions, withBoundedRetry, writeReplayResult };
+export { AUTO_CAPTURE_ERROR_EVENT, type AdapterEvidence, type AdapterSourceStats, type AdfDoc, type AdfNode, type AdvisoryCommentGap, type AdvisoryCommentMatch, type AutoCaptureHandle, type AutoCaptureOptions, type AutoCaptureSource, type BoundedRetryOptions, type BugQueueConfig, BugQueueManager, type BuildAdvisoryCommentInput, type BuildDbDiffEventInput, type BuildDbReadBulkEventInput, type BuildDbReadEventInput, type BuildFixContextOptions, CLOUDFLARE_AUTH_FIELDS, CLOUDFLARE_DESCRIPTOR, CLOUDFLARE_R2_ACCESS_KEY_ID_ENV, CLOUDFLARE_R2_ACCOUNT_ID_ENV, CLOUDFLARE_R2_BUCKET_ENV, CLOUDFLARE_R2_DATASET_ENV, CLOUDFLARE_R2_ENDPOINT_ENV, CLOUDFLARE_R2_PREFIX_ENV, CLOUDFLARE_R2_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_ACCESS_KEY_ID_ENV, CLOUDWATCH_AUTH_FIELDS, CLOUDWATCH_DESCRIPTOR, CLOUDWATCH_ENDPOINT_ENV, CLOUDWATCH_LOG_GROUPS_ENV, CLOUDWATCH_REGION_ENV, CLOUDWATCH_SECRET_ACCESS_KEY_ENV, CLOUDWATCH_SESSION_TOKEN_ENV, CRUMBTRAIL_USER_AGENT, CloudWatchEvidenceSource, type CloudWatchQueryPlan, type CloudWatchResultRow, type CloudWatchSourceConfig, type CloudflareDataset, CloudflareEvidenceSource, type CloudflarePlan, type CloudflareSourceConfig, type CommentingTicketConnector, CompareError, type CompareOptions, type ComparisonConfidence, type ComparisonVerdict, type CrumbtrailExpressErrorMiddleware, type CrumbtrailExpressErrorNext, type CrumbtrailExpressMiddleware, type CrumbtrailExpressNext, type CrumbtrailExpressOptions, type CrumbtrailExpressRequest, type CrumbtrailExpressResponse, type BackendIntakeWarning as CrumbtrailExpressWarning, type BackendIntakeWarningKind as CrumbtrailExpressWarningKind, DATADOG_API_KEY_ENV, DATADOG_APP_KEY_ENV, DATADOG_AUTH_FIELDS, DATADOG_DEFAULT_SITE, DATADOG_DESCRIPTOR, DATADOG_SITE_ENV, DEFAULT_MAX_TOTAL_BYTES, DEFAULT_SENSITIVE_DB_COLUMNS, DEFAULT_SOURCE_TIMEOUT_MS, DEFAULT_SWEEP_CHECKPOINT_MS, DEFAULT_SWEEP_IDLE_MS, DEFAULT_SWEEP_INTERVAL_MS, DISTINCT_BUGS_SCHEMA_VERSION, DatadogEvidenceSource, type DatadogLog, type DatadogQueryPlan, type DatadogSourceConfig, type DatadogSpan, type DbRequestContext, type DistinctBug, type DistinctBugEvidenceRef, type DistinctBugRecurrence, type DistinctBugRecurrenceInput, type DistinctBugRecurrenceOccurrence, type DistinctBugSeverity, type Divergence, type DuckTypedMssqlPool, type DuckTypedMssqlRequest, type DuckTypedMssqlResult, type DuckTypedMysqlClient, type DuckTypedMysqlResultHeader, type DuckTypedPgClient, type DuckTypedPgQueryResult, type DuckTypedSqliteDatabase, type DuckTypedSqliteRunResult, type DuckTypedSqliteStatement, EVIDENCE_SOURCE_PROVIDERS, CRUMBTRAIL_USER_AGENT as EVIDENCE_SOURCE_USER_AGENT, type EnvChannelDelta, type EnvDiff, type EnvValueChange, type EvidenceSource, type EvidenceSourceProvider, FIX_CONTEXT_SCHEMA_VERSION, type FetchAdapterEvidenceOptions, FilesystemSessionStore, type FixContext, type FixContextDbDiff, type FixContextDbRead, FixContextError, type FixContextPrimaryWindow, type FixContextReproHint, type FixContextSession, type HeadlessSession, type HeadlessSessionOptions, InspectError, type InspectSessionOptions, type InstrumentDbClientOptions, type InstrumentPgClientOptions, type JiraAuth, type JiraBasicAuth, type JiraBearerAuth, JiraTicketClient, type JiraTicketClientConfig, type JiraTicketClientConfigLegacy, type JiraTicketClientConfigWithAuth, McpServer, type McpServerConfig, type OtlpLogsRequest, type OtlpResourceLogs, type OtlpResourceSpans, type OtlpTraceRequest, POSTHOG_API_KEY_ENV, POSTHOG_AUTH_FIELDS, POSTHOG_DEFAULT_HOST, POSTHOG_DESCRIPTOR, POSTHOG_HOST_ENV, POSTHOG_PROJECT_ID_ENV, PROVIDER_IDS, PROVIDER_RECIPES, type PostHogEvent, PostHogEvidenceSource, type PostHogPropertyFilter, type PostHogQueryPlan, type PostHogRecording, type PostHogSourceConfig, type ProviderId, type ProviderRecipe, REGRESSION_CONTEXT_SCHEMA_VERSION, REPLAY_RESULT_SCHEMA_VERSION, type RegressionContext, type ReplayDivergence, type ReplayResult, type ReplayStepResult, SENTRY_AUTH_FIELDS, SENTRY_AUTH_TOKEN_ENV, SENTRY_DEFAULT_HOST, SENTRY_DESCRIPTOR, SENTRY_HOST_ENV, SENTRY_ORG_ENV, SESSION_COMPARE_SCHEMA_VERSION, SPLUNK_AUTH_FIELDS, SPLUNK_DESCRIPTOR, SPLUNK_HOST_ENV, SPLUNK_INDEX_ENV, SPLUNK_TOKEN_ENV, SPLUNK_WEB_URL_ENV, SentryEvidenceSource, type SentryQueryPlan, type SentrySourceConfig, type BugReport as ServerBugReport, type ServerConfig, type SessionComparison, type SessionFileFlags, type SessionFinalizationResult, type SessionInspection, type SessionInspectionArtifact, type SessionListItem, SessionManager, type SessionStore, type SessionSummary, type SessionSweepOptions, type SessionSweepResult, type SessionSweeperHandle, type Severity, type SigV4Input, type SignedHeaders, type SourceHealth, SplunkEvidenceSource, type SplunkQueryPlan, type SplunkResultRow, type SplunkSourceConfig, type StepResolution, type TicketConnector, TicketError, type TicketProvider, autoCapture, buildAdvisoryComment, buildCloudWatchQuery, buildCloudflarePlan, buildDatadogQuery, buildDbDiffEvent, buildDbReadBulkEvent, buildDbReadEvent, buildDistinctBugSignature, buildFixContext, buildPostHogQuery, buildRegressionContext, buildReplayResult, buildSentryQuery, buildSessionSummary, buildSplunkQuery, cloudWatchDeepLink, cloudWatchEvidenceProvider, cloudflareEvidenceProvider, compareSessions, comparisonTitle, createCrumbtrailExpressErrorMiddleware, createCrumbtrailExpressMiddleware, createServer, datadogAppBase, datadogEvidenceProvider, decodeOtlpLogsProtobuf, decodeOtlpTraceProtobuf, defaultSessionStore, evidenceRequestHeaders, evidenceSourcesFromEnv, fetchAdapterEvidence, formatComparisonSummary, formatDuration, formatInspection, getProviderRecipe, groupDistinctBugRecurrences, groupDistinctBugs, inspectSession, instrumentMssqlPool, instrumentMysqlClient, instrumentPgClient, instrumentSqliteDatabase, isProviderId, jiraToSymptom, normalizeCloudWatchRow, normalizeDatadogLog, normalizeDatadogSpan, normalizePostHogEvent, normalizePostHogRecording, normalizeSentryIssue, normalizeSplunkRow, parseMutation, parseRead, parseReplayResult, posthogEventDeepLink, posthogEvidenceProvider, posthogRecordingDeepLink, readPackageVersion, redactEvidenceGap, redactEvidenceItem, redactSourceResult, registerEvidenceProvider, renderCompareReport, renderProviderCliOutput, renderProviderConfig, renderProviderDoc, renderProviderReadme, resolveDbRequestContext, sentryEvidenceProvider, sessionRefLabel, signSigV4, splunkEvidenceProvider, splunkSearchDeepLink, splunkWebBase, startHeadlessSession, startSessionSweeper, sweepIdleSessions, withBoundedRetry, writeReplayResult };

package/dist/index.js

@@ -91,6 +91,7 @@ import {
   cloudWatchEvidenceProvider,
   cloudflareEvidenceProvider,
   compareSessions,
+  comparisonTitle,
   createServer,
   datadogAppBase,
   datadogEvidenceProvider,
@@ -133,6 +134,7 @@ import {
   renderProviderReadme,
   resolveBackendRequestCorrelation,
   sentryEvidenceProvider,
+  sessionRefLabel,
   signSigV4,
   splunkEvidenceProvider,
   splunkSearchDeepLink,
@@ -140,7 +142,7 @@ import {
   startSessionSweeper,
   sweepIdleSessions,
   withBoundedRetry
-} from "./chunk-EASSXKUJ.js";
+} from "./chunk-5HPWIOG3.js";
 import "./chunk-QGM4M3NI.js";
 
 // src/db/columns.ts
@@ -2458,6 +2460,7 @@ export {
   cloudWatchEvidenceProvider,
   cloudflareEvidenceProvider,
   compareSessions,
+  comparisonTitle,
   createCrumbtrailExpressErrorMiddleware,
   createCrumbtrailExpressMiddleware,
   createServer,
@@ -2507,6 +2510,7 @@ export {
   renderProviderReadme,
   resolveDbRequestContext,
   sentryEvidenceProvider,
+  sessionRefLabel,
   signSigV4,
   splunkEvidenceProvider,
   splunkSearchDeepLink,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "crumbtrail-node",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local Crumbtrail server, MCP evidence tools, Express middleware, and CLI for self-hosted debugging sessions.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/oshabana/crumbtrail.git",
+    "url": "git+https://github.com/crumbtrail-dev/crumbtrail-js.git",
     "directory": "packages/node"
   },
   "keywords": [
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "protobufjs": "^8.6.5",
-    "crumbtrail-core": "^0.1.0"
+    "crumbtrail-core": "^0.2.0"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",
@@ -50,6 +50,10 @@
     "express": "^5.2.1",
     "typescript": "^5.7.0"
   },
+  "homepage": "https://github.com/crumbtrail-dev/crumbtrail-js/tree/main/packages/node#readme",
+  "bugs": {
+    "url": "https://github.com/crumbtrail-dev/crumbtrail-js/issues"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",