Redesign Query Insights

.gitignore

@@ -2,6 +2,8 @@
 ## files generated by popular Visual Studio add-ons.
 
 ._local/
+# Local Query Insights prompt override: packaged when present, never committed.
+resources/prompts/local/
 
 # User-specific files
 *.suo

build/verification/browser/fixtures.ts

@@ -15,6 +15,7 @@ import { type ClusterDashboardWebviewConfigurationType } from '../../../src/webv
 import { type CollectionViewWebviewConfigurationType } from '../../../src/webviews/documentdb/collectionView/collectionViewController';
 import { type DocumentsViewWebviewConfigurationType } from '../../../src/webviews/documentdb/documentView/documentsViewController';
 import { type LocalQuickStartConfigurationType } from '../../../src/webviews/documentdb/localQuickStart/localQuickStartController';
+import { type QueryInsightsPrefill } from '../../../src/webviews/documentdb/queryInsightsStandalone/types';
 import { type FixtureInputs, type FixtureOutputs, type RpcFixture, type RpcFixtures } from './core/fixtures';
 
 type Inputs = FixtureInputs;
@@ -82,6 +83,10 @@ const quickStartConfig: LocalQuickStartConfigurationType = {
     initialInstanceState: InstanceState.NotInstalled,
 };
 const atlasConfig: AtlasCredentialsWebviewConfig = { mode: 'add', authMethod: 'apikey' };
+/** A fresh open opens on Welcome; scenarios add {@link queryInsightsSampleExplain} to start on Configure. */
+const queryInsightsConfig: QueryInsightsPrefill = { databaseName: 'demo', collectionName: 'items' };
+export const queryInsightsSampleExplain =
+    '{"queryPlanner":{"winningPlan":{"stage":"COLLSCAN"}},"executionStats":{"nReturned":2,"executionTimeMillis":12,"totalDocsExamined":100,"totalKeysExamined":0}}';
 interface FixtureTableRow {
     readonly id: string;
     readonly 'x-objectid': string;
@@ -245,6 +250,131 @@ export const fixtures = {
             'localQuickStart.onInstanceChanged': { type: 'subscription', results: [instance], keepOpen: true },
         },
     },
+    queryInsightsStandalone: {
+        config: queryInsightsConfig,
+        monaco: false,
+        content: [
+            'Query Insights Explorer',
+            "What you'll need",
+            'Get the explain output',
+            'What is sent to GitHub Copilot',
+        ],
+        styles: [{ selector: 'body', property: 'padding-top', expected: '0px' }],
+        rpc: {
+            ...common,
+            'ai.getAvailableModels': reply<Outputs['ai']['getAvailableModels']>('query', {
+                models: [
+                    {
+                        id: 'copilot-utility',
+                        name: 'Copilot utility',
+                        family: 'copilot-utility',
+                        vendor: 'copilot',
+                        version: '1',
+                        maxInputTokens: 64000,
+                        isUtility: true,
+                        pricing: 'Free',
+                        priceCategory: 'low',
+                        category: 'lightweight',
+                        inputCost: 0,
+                        outputCost: 0,
+                        cacheCost: 0,
+                        supportsToolCalling: true,
+                        supportsImageToText: false,
+                    },
+                ],
+                savedModelId: null,
+                effectiveModelId: 'copilot-utility',
+                effectiveReason: 'first-available',
+            }),
+            'queryInsightsStandalone.validateInput': reply<Outputs['queryInsightsStandalone']['validateInput']>(
+                'query',
+                {
+                    commandType: 'find' as Outputs['queryInsightsStandalone']['validateInput']['commandType'],
+                    query: '{}',
+                },
+            ),
+            'queryInsightsStandalone.inspectInput': reply<Outputs['queryInsightsStandalone']['inspectInput']>('query', {
+                explain: {
+                    ok: true,
+                    detectedCommandType: 'find' as Outputs['queryInsightsStandalone']['validateInput']['commandType'],
+                    planStages: ['COLLSCAN'],
+                },
+                commandType: 'find' as Outputs['queryInsightsStandalone']['validateInput']['commandType'],
+                query: '{}',
+                queryIsExtracted: true,
+                ready: true,
+            }),
+            'queryInsightsStandalone.getStage1': reply<Outputs['queryInsightsStandalone']['getStage1']>('query', {
+                executionTime: 0,
+                stages: [{ stage: 'COLLSCAN', name: 'Collection scan', nReturned: 0 }],
+                efficiencyAnalysis: { executionStrategy: 'Collection scan', indexUsed: null, hasInMemorySort: false },
+            }),
+            'queryInsightsStandalone.getStage2': reply<Outputs['queryInsightsStandalone']['getStage2']>('query', {
+                executionTimeMs: 12,
+                documentsReturned: 2,
+                totalDocsExamined: 100,
+                totalKeysExamined: 0,
+                examinedToReturnedRatio: 50,
+                keysToDocsRatio: 0,
+                executionStrategy: 'Collection scan',
+                indexUsed: false,
+                usedIndexNames: [],
+                hadInMemorySort: false,
+                hadCollectionScan: true,
+                isCoveringQuery: false,
+                concerns: [],
+                rawExecutionStats: {},
+                stages: [{ stage: 'COLLSCAN', name: 'Collection scan', nReturned: 2 }],
+                efficiencyAnalysis: {
+                    selectivity: null,
+                    indexUsed: null,
+                    fetchOverhead: 'Collection scan',
+                    fetchOverheadKind: 'collectionScan',
+                    hasInMemorySort: false,
+                    performanceRating: { score: 'poor', diagnostics: [] },
+                },
+            }),
+            'queryInsightsStandalone.streamStage3': {
+                type: 'subscription',
+                results: [
+                    { type: 'summary', markdown: 'Consider indexing the filter.', complete: true },
+                    { type: 'recommendationStarted', index: 0 },
+                    {
+                        type: 'recommendation',
+                        index: 0,
+                        recommendation: {
+                            action: 'create',
+                            indexSpec: { status: 1 },
+                            indexName: 'status_1',
+                            shellCommand: 'db.items.createIndex({status: 1})',
+                            justification: 'Avoid a collection scan.',
+                            priority: 'high',
+                        },
+                    },
+                    {
+                        type: 'complete',
+                        modelId: 'copilot-utility',
+                        modelFamily: 'copilot-utility',
+                        modelDisplayName: 'Copilot utility',
+                        durationMs: 10,
+                        usage: {
+                            promptTokens: 1200,
+                            responseTokens: 350,
+                            credits: 0,
+                            reportedPromptTokens: 1200,
+                            reportedCompletionTokens: 350,
+                            usageSource: 'provider',
+                        },
+                    },
+                ] as const,
+            },
+            'common.copyToClipboard': reply<Outputs['common']['copyToClipboard']>('mutation', true),
+            'queryInsightsStandalone.openRawExplain': reply<Outputs['queryInsightsStandalone']['openRawExplain']>(
+                'mutation',
+                true,
+            ),
+        },
+    },
     atlasCredentials: {
         config: atlasConfig,
         monaco: false,

build/verification/browser/harness.test.ts

@@ -165,13 +165,14 @@ describe('Stage 0 L2 production browser harness', (): void => {
         }
     });
 
-    it('covers all five registry keys with populated fixture contracts', (): void => {
+    it('covers all six registry keys with populated fixture contracts', (): void => {
         expect(Object.keys(fixtures).sort()).toEqual([
             'atlasCredentials',
             'clusterDashboard',
             'collectionView',
             'documentView',
             'localQuickStart',
+            'queryInsightsStandalone',
         ]);
         for (const fixture of Object.values(fixtures)) {
             expect(fixture.content.length).toBeGreaterThan(0);

build/verification/browser/runtime.ts

@@ -66,6 +66,7 @@ function isHarnessFixture(value: unknown): value is HarnessFixture {
         documentView: true,
         localQuickStart: true,
         atlasCredentials: true,
+        queryInsightsStandalone: true,
     } satisfies Record<WebviewName, boolean>;
     return (
         isObject(value) &&

build/verification/browser/scenarios.test.ts

@@ -12,7 +12,7 @@ import { parseScenarioRoute, runnerRoutes, scenarioHtml, scenarioIndex, scenario
 import { findScenario, scenarioRoutes, scenarios, type Scenario } from './scenarios';
 
 describe('L2-dev manifest and routes', (): void => {
-    it('imports, rather than duplicates, all five settled L2 fixtures', (): void => {
+    it('imports, rather than duplicates, all six settled L2 fixtures', (): void => {
         for (const route of scenarioRoutes().filter((route): boolean => route.scenario === 'default')) {
             const scenario = findScenario(route);
             expect(scenario.config).toBe(fixtures[route.view].config);
@@ -23,8 +23,8 @@ describe('L2-dev manifest and routes', (): void => {
 
     it('round-trips every scenario and theme, without duplicate routes', (): void => {
         const routes = scenarioRoutes();
-        expect(routes).toHaveLength(42);
-        expect(new Set(routes.map((route): string => route.path)).size).toBe(42);
+        expect(routes).toHaveLength(72);
+        expect(new Set(routes.map((route): string => route.path)).size).toBe(72);
         for (const route of routes) expect(parseScenarioRoute(route.path)).toEqual(route);
     });
 
@@ -50,7 +50,8 @@ describe('L2-dev manifest and routes', (): void => {
     });
 
     it('provides path-only all/view/theme helpers and rejects unknown subsets', (): void => {
-        expect(runnerRoutes('/scenarios/run-all.js')).toHaveLength(42);
+        expect(runnerRoutes('/scenarios/run-all.js')).toHaveLength(72);
+        expect(runnerRoutes('/scenarios/run-all/queryInsightsStandalone.js')).toHaveLength(30);
         expect(runnerRoutes('/scenarios/run-all/localQuickStart.js')).toHaveLength(30);
         expect(runnerRoutes('/scenarios/run-all/localQuickStart/dark.js')).toHaveLength(10);
         expect(runnerRoutes('/scenarios/run-all/unknown.js')).toBeUndefined();