@query-doctor/core 0.10.7 → 0.10.8

package/dist/index.cjs

@@ -4,6 +4,7 @@ const require_pg_identifier = require("./sql/pg-identifier.cjs");
 const require_schema = require("./schema.cjs");
 const require_nudges = require("./sql/nudges.cjs");
 const require_analyzer = require("./sql/analyzer.cjs");
+const require_test_origin = require("./sql/test-origin.cjs");
 const require_database = require("./sql/database.cjs");
 const require_display_query = require("./sql/display-query.cjs");
 const require_normalized_fingerprint = require("./sql/normalized-fingerprint.cjs");
@@ -73,5 +74,7 @@ exports.ignoredIdentifier = require_analyzer.ignoredIdentifier;
 exports.indexCovers = require_index_coverage.indexCovers;
 exports.isIndexProbablyDroppable = require_indexes.isIndexProbablyDroppable;
 exports.isIndexSupported = require_indexes.isIndexSupported;
+exports.isTestFilePath = require_test_origin.isTestFilePath;
+exports.isTestOriginQuery = require_test_origin.isTestOriginQuery;
 exports.normalizedFingerprint = require_normalized_fingerprint.normalizedFingerprint;
 exports.parseNudges = require_nudges.parseNudges;

package/dist/index.d.cts

@@ -8,6 +8,7 @@ import { ColumnMetadata, ComputedColumnStats, ComputedReltuples, ComputedStats,
 import { IndexIdentifier, IndexOptimizer, IndexToCreate, OptimizeResult, PROCEED, PermutedIndexCandidate, RootIndexCandidate, SKIP } from "./optimizer/genalgo.cjs";
 import { Nudge, parseNudges } from "./sql/nudges.cjs";
 import { AnalysisResult, Analyzer, DatabaseDriver, DiscoveredColumnReference, JsonbOperator, Parser, SQLCommenterExtraction, SQLCommenterTag, SortContext, StatementType, TableReference, ignoredIdentifier } from "./sql/analyzer.cjs";
+import { isTestFilePath, isTestOriginQuery } from "./sql/test-origin.cjs";
 import { CompactSelectListOptions, compactSelectList } from "./sql/display-query.cjs";
 import { FingerprintFn, normalizedFingerprint } from "./sql/normalized-fingerprint.cjs";
 import { DuplicateIndexGroup, groupDuplicateIndexes, isIndexProbablyDroppable, isIndexSupported } from "./sql/indexes.cjs";
@@ -20,4 +21,4 @@ import { ActionPlanNudgeQuery, ActionableStep, AffectedQueryCost, CostReduction,
 import { deriveSentryEnvironment } from "./sentry.cjs";
 import { ClientApi, ConnectionMode, ExtensionPresence, IndexDefinition, RepoConfig, ServerApi, UnauthenticatedServerApi } from "./websocket-server.cjs";
 import { QueryFinding, QueryFindingCode, QueryFindingSeverity, analyzeQueryFindings } from "./findings/query-findings.cjs";
-export { ActionPlanNudgeQuery, ActionPlanQuery, ActionableStep, AffectedQueryCost, AggregatedIndexRecommendation, AnalysisResult, Analyzer, ClientApi, ColumnMetadata, CombinedExport, CompactSelectListOptions, ComputedColumnStats, ComputedReltuples, ComputedStats, ConnectionMode, CostReduction, DUMP_STATS_SQL, DatabaseDriver, DiscoveredColumnReference, DomainLabel, DuplicateIndexGroup, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, ExtensionPresence, FingerprintFn, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexAction, IndexDefinition, IndexGroup, IndexIdentifier, IndexOptimizer, IndexRecommendation, IndexToCreate, JsonbOperator, LiveQueryOptimization, Nudge, NudgeFinding, OptimizationResult, OptimizeResult, OptimizedQuery, PROCEED, Parameter, Parser, Path, PermutedIndexCandidate, PgIdentifier, Postgres, PostgresConnectionInput, PostgresExplainResult, PostgresExplainStage, PostgresExplainStageCommon, PostgresExplainStageSchema, PostgresFactory, PostgresQueryBuilder, PostgresQueryBuilderCommand, PostgresStage, PostgresStageId, PostgresTransaction, PostgresVersion, PssRewriter, QueryFinding, QueryFindingCode, QueryFindingSeverity, QueryHash, QuerySource, RecentQuery, RegressionBreach, RepoConfig, RootIndexCandidate, SKIP, SQLCommenterExtraction, SQLCommenterTag, SerializeResult, ServerApi, SortContext, StatementType, Statistics, StatisticsMode, StatisticsSource, TableMetadata, TableReference, TableStats, UnauthenticatedServerApi, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, normalizedFingerprint, parseNudges };
+export { ActionPlanNudgeQuery, ActionPlanQuery, ActionableStep, AffectedQueryCost, AggregatedIndexRecommendation, AnalysisResult, Analyzer, ClientApi, ColumnMetadata, CombinedExport, CompactSelectListOptions, ComputedColumnStats, ComputedReltuples, ComputedStats, ConnectionMode, CostReduction, DUMP_STATS_SQL, DatabaseDriver, DiscoveredColumnReference, DomainLabel, DuplicateIndexGroup, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, ExtensionPresence, FingerprintFn, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexAction, IndexDefinition, IndexGroup, IndexIdentifier, IndexOptimizer, IndexRecommendation, IndexToCreate, JsonbOperator, LiveQueryOptimization, Nudge, NudgeFinding, OptimizationResult, OptimizeResult, OptimizedQuery, PROCEED, Parameter, Parser, Path, PermutedIndexCandidate, PgIdentifier, Postgres, PostgresConnectionInput, PostgresExplainResult, PostgresExplainStage, PostgresExplainStageCommon, PostgresExplainStageSchema, PostgresFactory, PostgresQueryBuilder, PostgresQueryBuilderCommand, PostgresStage, PostgresStageId, PostgresTransaction, PostgresVersion, PssRewriter, QueryFinding, QueryFindingCode, QueryFindingSeverity, QueryHash, QuerySource, RecentQuery, RegressionBreach, RepoConfig, RootIndexCandidate, SKIP, SQLCommenterExtraction, SQLCommenterTag, SerializeResult, ServerApi, SortContext, StatementType, Statistics, StatisticsMode, StatisticsSource, TableMetadata, TableReference, TableStats, UnauthenticatedServerApi, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, isTestFilePath, isTestOriginQuery, normalizedFingerprint, parseNudges };

package/dist/index.d.mts

@@ -8,6 +8,7 @@ import { ColumnMetadata, ComputedColumnStats, ComputedReltuples, ComputedStats,
 import { IndexIdentifier, IndexOptimizer, IndexToCreate, OptimizeResult, PROCEED, PermutedIndexCandidate, RootIndexCandidate, SKIP } from "./optimizer/genalgo.mjs";
 import { Nudge, parseNudges } from "./sql/nudges.mjs";
 import { AnalysisResult, Analyzer, DatabaseDriver, DiscoveredColumnReference, JsonbOperator, Parser, SQLCommenterExtraction, SQLCommenterTag, SortContext, StatementType, TableReference, ignoredIdentifier } from "./sql/analyzer.mjs";
+import { isTestFilePath, isTestOriginQuery } from "./sql/test-origin.mjs";
 import { CompactSelectListOptions, compactSelectList } from "./sql/display-query.mjs";
 import { FingerprintFn, normalizedFingerprint } from "./sql/normalized-fingerprint.mjs";
 import { DuplicateIndexGroup, groupDuplicateIndexes, isIndexProbablyDroppable, isIndexSupported } from "./sql/indexes.mjs";
@@ -20,4 +21,4 @@ import { ActionPlanNudgeQuery, ActionableStep, AffectedQueryCost, CostReduction,
 import { deriveSentryEnvironment } from "./sentry.mjs";
 import { ClientApi, ConnectionMode, ExtensionPresence, IndexDefinition, RepoConfig, ServerApi, UnauthenticatedServerApi } from "./websocket-server.mjs";
 import { QueryFinding, QueryFindingCode, QueryFindingSeverity, analyzeQueryFindings } from "./findings/query-findings.mjs";
-export { ActionPlanNudgeQuery, ActionPlanQuery, ActionableStep, AffectedQueryCost, AggregatedIndexRecommendation, AnalysisResult, Analyzer, ClientApi, ColumnMetadata, CombinedExport, CompactSelectListOptions, ComputedColumnStats, ComputedReltuples, ComputedStats, ConnectionMode, CostReduction, DUMP_STATS_SQL, DatabaseDriver, DiscoveredColumnReference, DomainLabel, DuplicateIndexGroup, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, ExtensionPresence, FingerprintFn, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexAction, IndexDefinition, IndexGroup, IndexIdentifier, IndexOptimizer, IndexRecommendation, IndexToCreate, JsonbOperator, LiveQueryOptimization, Nudge, NudgeFinding, OptimizationResult, OptimizeResult, OptimizedQuery, PROCEED, Parameter, Parser, Path, PermutedIndexCandidate, PgIdentifier, Postgres, PostgresConnectionInput, PostgresExplainResult, PostgresExplainStage, PostgresExplainStageCommon, PostgresExplainStageSchema, PostgresFactory, PostgresQueryBuilder, PostgresQueryBuilderCommand, PostgresStage, PostgresStageId, PostgresTransaction, PostgresVersion, PssRewriter, QueryFinding, QueryFindingCode, QueryFindingSeverity, QueryHash, QuerySource, RecentQuery, RegressionBreach, RepoConfig, RootIndexCandidate, SKIP, SQLCommenterExtraction, SQLCommenterTag, SerializeResult, ServerApi, SortContext, StatementType, Statistics, StatisticsMode, StatisticsSource, TableMetadata, TableReference, TableStats, UnauthenticatedServerApi, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, normalizedFingerprint, parseNudges };
+export { ActionPlanNudgeQuery, ActionPlanQuery, ActionableStep, AffectedQueryCost, AggregatedIndexRecommendation, AnalysisResult, Analyzer, ClientApi, ColumnMetadata, CombinedExport, CompactSelectListOptions, ComputedColumnStats, ComputedReltuples, ComputedStats, ConnectionMode, CostReduction, DUMP_STATS_SQL, DatabaseDriver, DiscoveredColumnReference, DomainLabel, DuplicateIndexGroup, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, ExtensionPresence, FingerprintFn, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexAction, IndexDefinition, IndexGroup, IndexIdentifier, IndexOptimizer, IndexRecommendation, IndexToCreate, JsonbOperator, LiveQueryOptimization, Nudge, NudgeFinding, OptimizationResult, OptimizeResult, OptimizedQuery, PROCEED, Parameter, Parser, Path, PermutedIndexCandidate, PgIdentifier, Postgres, PostgresConnectionInput, PostgresExplainResult, PostgresExplainStage, PostgresExplainStageCommon, PostgresExplainStageSchema, PostgresFactory, PostgresQueryBuilder, PostgresQueryBuilderCommand, PostgresStage, PostgresStageId, PostgresTransaction, PostgresVersion, PssRewriter, QueryFinding, QueryFindingCode, QueryFindingSeverity, QueryHash, QuerySource, RecentQuery, RegressionBreach, RepoConfig, RootIndexCandidate, SKIP, SQLCommenterExtraction, SQLCommenterTag, SerializeResult, ServerApi, SortContext, StatementType, Statistics, StatisticsMode, StatisticsSource, TableMetadata, TableReference, TableStats, UnauthenticatedServerApi, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, isTestFilePath, isTestOriginQuery, normalizedFingerprint, parseNudges };

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { PgIdentifier } from "./sql/pg-identifier.mjs";
 import { FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, dumpSchema } from "./schema.mjs";
 import { parseNudges } from "./sql/nudges.mjs";
 import { Analyzer, ignoredIdentifier } from "./sql/analyzer.mjs";
+import { isTestFilePath, isTestOriginQuery } from "./sql/test-origin.mjs";
 import { PostgresExplainStageSchema, PostgresVersion, dropIndex } from "./sql/database.mjs";
 import { compactSelectList } from "./sql/display-query.mjs";
 import { normalizedFingerprint } from "./sql/normalized-fingerprint.mjs";
@@ -18,4 +19,4 @@ import { buildActionPlan } from "./action-plan/build-action-plan.mjs";
 import { deriveSentryEnvironment } from "./sentry.mjs";
 import { OptimizedQuery, RecentQuery } from "./query.mjs";
 import { analyzeQueryFindings } from "./findings/query-findings.mjs";
-export { Analyzer, CombinedExport, ComputedColumnStats, ComputedReltuples, ComputedStats, DUMP_STATS_SQL, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexOptimizer, OptimizedQuery, PROCEED, PgIdentifier, PostgresExplainStageSchema, PostgresQueryBuilder, PostgresVersion, PssRewriter, RecentQuery, SKIP, Statistics, StatisticsMode, StatisticsSource, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, normalizedFingerprint, parseNudges };
+export { Analyzer, CombinedExport, ComputedColumnStats, ComputedReltuples, ComputedStats, DUMP_STATS_SQL, ExportedQuery, ExportedStats, ExportedStatsColumns, ExportedStatsIndex, ExportedStatsStatistics, ExportedStatsV1, FullSchema, FullSchemaColumn, FullSchemaCompositeAttribute, FullSchemaConstraint, FullSchemaExtension, FullSchemaFunction, FullSchemaIncludedColumn, FullSchemaIndex, FullSchemaKeyColumn, FullSchemaTable, FullSchemaTrigger, FullSchemaType, FullSchemaTypeConstraint, FullSchemaView, IndexOptimizer, OptimizedQuery, PROCEED, PgIdentifier, PostgresExplainStageSchema, PostgresQueryBuilder, PostgresVersion, PssRewriter, RecentQuery, SKIP, Statistics, StatisticsMode, StatisticsSource, aggregateIndexRecommendations, analyzeQueryFindings, buildActionPlan, combinedDumpSql, compactSelectList, deriveSentryEnvironment, dropIndex, dumpQueriesSql, dumpSchema, groupDuplicateIndexes, groupIndexesByCoverage, ignoredIdentifier, indexCovers, isIndexProbablyDroppable, isIndexSupported, isTestFilePath, isTestOriginQuery, normalizedFingerprint, parseNudges };

package/dist/sql/test-origin.cjs

@@ -0,0 +1,52 @@
+"use client";
+//#region src/sql/test-origin.ts
+/**
+* Whether a query originated from a test file, decided from its SQLCommenter
+* `file` tag.
+*
+* The CI gate should never flag a query that no production route runs — e.g. a
+* read-back assertion in `tests/pg/postgres.test.ts` — yet before this such
+* queries had to be ignored one hash at a time (#3199). SQLCommenter already
+* carries the caller's file (surfaced in query detail per #2585); this reads it
+* so both the analyzer's gate and the server's alert engine can bucket
+* test-origin queries out with a single shared rule instead of drifting apart.
+*
+* Conservative by construction: the decision keys only off the `file` tag's
+* origin path. A query with no `file` tag is never test-origin, so untagged
+* codebases behave exactly as before.
+*/
+function isTestOriginQuery(tags) {
+	if (!tags) return false;
+	for (const tag of tags) {
+		if (tag.key !== "file") continue;
+		const originFile = tag.value.split(";")[0]?.trim();
+		if (originFile && isTestFilePath(originFile)) return true;
+	}
+	return false;
+}
+/**
+* Whether a source path looks like a test file. Query Doctor analyzes clients in
+* any language, so this spans the common cross-language conventions rather than
+* assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,
+* Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python
+* `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,
+* Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or
+* `latest/report.py` don't get mistaken for tests.
+*/
+function isTestFilePath(path) {
+	return TEST_PATH_PATTERNS.some((pattern) => pattern.test(path));
+}
+const TEST_PATH_PATTERNS = [
+	/(?:^|\/)(?:tests?|__tests__|specs?|e2e)\//i,
+	/(?:^|\/)src\/test\//i,
+	/\.(?:test|spec|e2e)\.[cm]?[jt]sx?$/i,
+	/(?:^|\/)(?:test_[^/]+|[^/]+_test|conftest)\.py$/i,
+	/_test\.go$/i,
+	/_(?:test|spec)\.rb$/i,
+	/Tests?\.(?:java|kt)$/
+];
+//#endregion
+exports.isTestFilePath = isTestFilePath;
+exports.isTestOriginQuery = isTestOriginQuery;
+
+//# sourceMappingURL=test-origin.cjs.map

package/dist/sql/test-origin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-origin.cjs","names":[],"sources":["../../src/sql/test-origin.ts"],"sourcesContent":["import type { SQLCommenterTag } from \"./analyzer.js\";\n\n/**\n * Whether a query originated from a test file, decided from its SQLCommenter\n * `file` tag.\n *\n * The CI gate should never flag a query that no production route runs — e.g. a\n * read-back assertion in `tests/pg/postgres.test.ts` — yet before this such\n * queries had to be ignored one hash at a time (#3199). SQLCommenter already\n * carries the caller's file (surfaced in query detail per #2585); this reads it\n * so both the analyzer's gate and the server's alert engine can bucket\n * test-origin queries out with a single shared rule instead of drifting apart.\n *\n * Conservative by construction: the decision keys only off the `file` tag's\n * origin path. A query with no `file` tag is never test-origin, so untagged\n * codebases behave exactly as before.\n */\nexport function isTestOriginQuery(\n  tags: readonly SQLCommenterTag[] | undefined | null,\n): boolean {\n  if (!tags) return false;\n  for (const tag of tags) {\n    if (tag.key !== \"file\") continue;\n    // SQLCommenter can pack a caller stack into one `file` value, `;`-separated\n    // and most-specific-first (the frontend renders `files[0]` as the origin).\n    // The first entry is the query's own call site, so it decides origin — a\n    // production query that merely threads through a test helper deeper in the\n    // stack stays gated.\n    const originFile = tag.value.split(\";\")[0]?.trim();\n    if (originFile && isTestFilePath(originFile)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether a source path looks like a test file. Query Doctor analyzes clients in\n * any language, so this spans the common cross-language conventions rather than\n * assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,\n * Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python\n * `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,\n * Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or\n * `latest/report.py` don't get mistaken for tests.\n */\nexport function isTestFilePath(path: string): boolean {\n  return TEST_PATH_PATTERNS.some((pattern) => pattern.test(path));\n}\n\nconst TEST_PATH_PATTERNS: readonly RegExp[] = [\n  // A directory segment dedicated to tests, anywhere in the path.\n  /(?:^|\\/)(?:tests?|__tests__|specs?|e2e)\\//i,\n  // Maven/Gradle layout: src/test/java/...\n  /(?:^|\\/)src\\/test\\//i,\n  // JS/TS: foo.test.ts, foo.spec.tsx, foo.e2e.mts\n  /\\.(?:test|spec|e2e)\\.[cm]?[jt]sx?$/i,\n  // Python: test_foo.py, foo_test.py, conftest.py\n  /(?:^|\\/)(?:test_[^/]+|[^/]+_test|conftest)\\.py$/i,\n  // Go: foo_test.go\n  /_test\\.go$/i,\n  // Ruby: foo_test.rb, foo_spec.rb\n  /_(?:test|spec)\\.rb$/i,\n  // Java/Kotlin: FooTest.java, FooTests.kt\n  /Tests?\\.(?:java|kt)$/,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,kBACd,MACS;AACT,KAAI,CAAC,KAAM,QAAO;AAClB,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,IAAI,QAAQ,OAAQ;EAMxB,MAAM,aAAa,IAAI,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM;AAClD,MAAI,cAAc,eAAe,WAAW,CAAE,QAAO;;AAEvD,QAAO;;;;;;;;;;;AAYT,SAAgB,eAAe,MAAuB;AACpD,QAAO,mBAAmB,MAAM,YAAY,QAAQ,KAAK,KAAK,CAAC;;AAGjE,MAAM,qBAAwC;CAE5C;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CACD"}

package/dist/sql/test-origin.d.cts

@@ -0,0 +1,34 @@
+'use client';
+
+import { SQLCommenterTag } from "./analyzer.cjs";
+
+//#region src/sql/test-origin.d.ts
+/**
+ * Whether a query originated from a test file, decided from its SQLCommenter
+ * `file` tag.
+ *
+ * The CI gate should never flag a query that no production route runs — e.g. a
+ * read-back assertion in `tests/pg/postgres.test.ts` — yet before this such
+ * queries had to be ignored one hash at a time (#3199). SQLCommenter already
+ * carries the caller's file (surfaced in query detail per #2585); this reads it
+ * so both the analyzer's gate and the server's alert engine can bucket
+ * test-origin queries out with a single shared rule instead of drifting apart.
+ *
+ * Conservative by construction: the decision keys only off the `file` tag's
+ * origin path. A query with no `file` tag is never test-origin, so untagged
+ * codebases behave exactly as before.
+ */
+declare function isTestOriginQuery(tags: readonly SQLCommenterTag[] | undefined | null): boolean;
+/**
+ * Whether a source path looks like a test file. Query Doctor analyzes clients in
+ * any language, so this spans the common cross-language conventions rather than
+ * assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,
+ * Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python
+ * `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,
+ * Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or
+ * `latest/report.py` don't get mistaken for tests.
+ */
+declare function isTestFilePath(path: string): boolean;
+//#endregion
+export { isTestFilePath, isTestOriginQuery };
+//# sourceMappingURL=test-origin.d.cts.map

package/dist/sql/test-origin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-origin.d.cts","names":[],"sources":["../../src/sql/test-origin.ts"],"mappings":";;;;;;;;AAiBA;;;;;AA0BA;;;;;;;iBA1BgB,iBAAA,CACd,IAAA,WAAe,eAAA;;;;;;;;;;iBAyBD,cAAA,CAAe,IAAA"}

package/dist/sql/test-origin.d.mts

@@ -0,0 +1,34 @@
+'use client';
+
+import { SQLCommenterTag } from "./analyzer.mjs";
+
+//#region src/sql/test-origin.d.ts
+/**
+ * Whether a query originated from a test file, decided from its SQLCommenter
+ * `file` tag.
+ *
+ * The CI gate should never flag a query that no production route runs — e.g. a
+ * read-back assertion in `tests/pg/postgres.test.ts` — yet before this such
+ * queries had to be ignored one hash at a time (#3199). SQLCommenter already
+ * carries the caller's file (surfaced in query detail per #2585); this reads it
+ * so both the analyzer's gate and the server's alert engine can bucket
+ * test-origin queries out with a single shared rule instead of drifting apart.
+ *
+ * Conservative by construction: the decision keys only off the `file` tag's
+ * origin path. A query with no `file` tag is never test-origin, so untagged
+ * codebases behave exactly as before.
+ */
+declare function isTestOriginQuery(tags: readonly SQLCommenterTag[] | undefined | null): boolean;
+/**
+ * Whether a source path looks like a test file. Query Doctor analyzes clients in
+ * any language, so this spans the common cross-language conventions rather than
+ * assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,
+ * Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python
+ * `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,
+ * Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or
+ * `latest/report.py` don't get mistaken for tests.
+ */
+declare function isTestFilePath(path: string): boolean;
+//#endregion
+export { isTestFilePath, isTestOriginQuery };
+//# sourceMappingURL=test-origin.d.mts.map

package/dist/sql/test-origin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-origin.d.mts","names":[],"sources":["../../src/sql/test-origin.ts"],"mappings":";;;;;;;;AAiBA;;;;;AA0BA;;;;;;;iBA1BgB,iBAAA,CACd,IAAA,WAAe,eAAA;;;;;;;;;;iBAyBD,cAAA,CAAe,IAAA"}

package/dist/sql/test-origin.mjs

@@ -0,0 +1,51 @@
+"use client";
+//#region src/sql/test-origin.ts
+/**
+* Whether a query originated from a test file, decided from its SQLCommenter
+* `file` tag.
+*
+* The CI gate should never flag a query that no production route runs — e.g. a
+* read-back assertion in `tests/pg/postgres.test.ts` — yet before this such
+* queries had to be ignored one hash at a time (#3199). SQLCommenter already
+* carries the caller's file (surfaced in query detail per #2585); this reads it
+* so both the analyzer's gate and the server's alert engine can bucket
+* test-origin queries out with a single shared rule instead of drifting apart.
+*
+* Conservative by construction: the decision keys only off the `file` tag's
+* origin path. A query with no `file` tag is never test-origin, so untagged
+* codebases behave exactly as before.
+*/
+function isTestOriginQuery(tags) {
+	if (!tags) return false;
+	for (const tag of tags) {
+		if (tag.key !== "file") continue;
+		const originFile = tag.value.split(";")[0]?.trim();
+		if (originFile && isTestFilePath(originFile)) return true;
+	}
+	return false;
+}
+/**
+* Whether a source path looks like a test file. Query Doctor analyzes clients in
+* any language, so this spans the common cross-language conventions rather than
+* assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,
+* Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python
+* `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,
+* Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or
+* `latest/report.py` don't get mistaken for tests.
+*/
+function isTestFilePath(path) {
+	return TEST_PATH_PATTERNS.some((pattern) => pattern.test(path));
+}
+const TEST_PATH_PATTERNS = [
+	/(?:^|\/)(?:tests?|__tests__|specs?|e2e)\//i,
+	/(?:^|\/)src\/test\//i,
+	/\.(?:test|spec|e2e)\.[cm]?[jt]sx?$/i,
+	/(?:^|\/)(?:test_[^/]+|[^/]+_test|conftest)\.py$/i,
+	/_test\.go$/i,
+	/_(?:test|spec)\.rb$/i,
+	/Tests?\.(?:java|kt)$/
+];
+//#endregion
+export { isTestFilePath, isTestOriginQuery };
+
+//# sourceMappingURL=test-origin.mjs.map

package/dist/sql/test-origin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-origin.mjs","names":[],"sources":["../../src/sql/test-origin.ts"],"sourcesContent":["import type { SQLCommenterTag } from \"./analyzer.js\";\n\n/**\n * Whether a query originated from a test file, decided from its SQLCommenter\n * `file` tag.\n *\n * The CI gate should never flag a query that no production route runs — e.g. a\n * read-back assertion in `tests/pg/postgres.test.ts` — yet before this such\n * queries had to be ignored one hash at a time (#3199). SQLCommenter already\n * carries the caller's file (surfaced in query detail per #2585); this reads it\n * so both the analyzer's gate and the server's alert engine can bucket\n * test-origin queries out with a single shared rule instead of drifting apart.\n *\n * Conservative by construction: the decision keys only off the `file` tag's\n * origin path. A query with no `file` tag is never test-origin, so untagged\n * codebases behave exactly as before.\n */\nexport function isTestOriginQuery(\n  tags: readonly SQLCommenterTag[] | undefined | null,\n): boolean {\n  if (!tags) return false;\n  for (const tag of tags) {\n    if (tag.key !== \"file\") continue;\n    // SQLCommenter can pack a caller stack into one `file` value, `;`-separated\n    // and most-specific-first (the frontend renders `files[0]` as the origin).\n    // The first entry is the query's own call site, so it decides origin — a\n    // production query that merely threads through a test helper deeper in the\n    // stack stays gated.\n    const originFile = tag.value.split(\";\")[0]?.trim();\n    if (originFile && isTestFilePath(originFile)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether a source path looks like a test file. Query Doctor analyzes clients in\n * any language, so this spans the common cross-language conventions rather than\n * assuming JS/TS — directory-scoped (`tests/`, `__tests__/`, `spec/`, `e2e/`,\n * Maven's `src/test/`) and filename-scoped (`*.test.*` / `*.spec.*`, Python\n * `test_*.py` / `*_test.py`, Go `*_test.go`, Ruby `*_test.rb` / `*_spec.rb`,\n * Java `*Test.java`). Anchored on path separators so `testimonials/user.ts` or\n * `latest/report.py` don't get mistaken for tests.\n */\nexport function isTestFilePath(path: string): boolean {\n  return TEST_PATH_PATTERNS.some((pattern) => pattern.test(path));\n}\n\nconst TEST_PATH_PATTERNS: readonly RegExp[] = [\n  // A directory segment dedicated to tests, anywhere in the path.\n  /(?:^|\\/)(?:tests?|__tests__|specs?|e2e)\\//i,\n  // Maven/Gradle layout: src/test/java/...\n  /(?:^|\\/)src\\/test\\//i,\n  // JS/TS: foo.test.ts, foo.spec.tsx, foo.e2e.mts\n  /\\.(?:test|spec|e2e)\\.[cm]?[jt]sx?$/i,\n  // Python: test_foo.py, foo_test.py, conftest.py\n  /(?:^|\\/)(?:test_[^/]+|[^/]+_test|conftest)\\.py$/i,\n  // Go: foo_test.go\n  /_test\\.go$/i,\n  // Ruby: foo_test.rb, foo_spec.rb\n  /_(?:test|spec)\\.rb$/i,\n  // Java/Kotlin: FooTest.java, FooTests.kt\n  /Tests?\\.(?:java|kt)$/,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,kBACd,MACS;AACT,KAAI,CAAC,KAAM,QAAO;AAClB,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,IAAI,QAAQ,OAAQ;EAMxB,MAAM,aAAa,IAAI,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM;AAClD,MAAI,cAAc,eAAe,WAAW,CAAE,QAAO;;AAEvD,QAAO;;;;;;;;;;;AAYT,SAAgB,eAAe,MAAuB;AACpD,QAAO,mBAAmB,MAAM,YAAY,QAAQ,KAAK,KAAK,CAAC;;AAGjE,MAAM,qBAAwC;CAE5C;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@query-doctor/core",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "private": false,
   "description": "Core logic for Query Doctor",
   "license": "",