@mrclrchtr/supi-code-intelligence 5.0.0 → 6.0.1

package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts

@@ -10,16 +10,19 @@ import {
   unavailableCodeQuery,
 } from "@mrclrchtr/supi-code-runtime/api";
 import * as projectRoots from "@mrclrchtr/supi-core/project";
+import * as ts from "typescript";
 import {
   LspClient,
   type LspClientLifecycleTransitionKind,
   RECOVERY_CLIENT_STARTUP_BOUND_MS,
   withTimeout,
 } from "../client/client.ts";
+import type { ClientDiagnosticSnapshot } from "../client/client-document-state.ts";
 
 export { RECOVERY_CLIENT_STARTUP_BOUND_MS } from "../client/client.ts";
 
 import { getServerForFile } from "../config/config.ts";
+import { getFileScopeDecision } from "../config/tsconfig-scope.ts";
 import type {
   DetectedProjectServer,
   Diagnostic,
@@ -42,6 +45,11 @@ import {
   summarizeDiagnosticEvidence,
 } from "../diagnostics/evidence.ts";
 import { raceRequestControl } from "../session/readiness.ts";
+import type {
+  ScopeDecisionEntry,
+  ScopeDecisionSummary,
+  WorkspaceDiagnosticReport,
+} from "../session/runtime-diagnostics.ts";
 import {
   displayRelativeFilePath,
   formatCoverageSummaryText,
@@ -89,6 +97,35 @@ import {
 
 type UnavailableReason = "missing-command" | "start-failed" | "runtime-error";
 
+/** Maximum tracked-file entries retained in one scope-decision telemetry summary. */
+const SCOPE_DECISION_MAX_ENTRIES = 24;
+
+interface ScopeDecisionAccumulator {
+  entries: ScopeDecisionEntry[];
+  counts: ScopeDecisionSummary["counts"];
+  basisCounts: Record<string, number>;
+}
+
+function accumulateScopeDecision(
+  accumulator: ScopeDecisionAccumulator,
+  file: string,
+  decision: ReturnType<typeof getFileScopeDecision>,
+): void {
+  const statusKey =
+    decision.status === "no-config"
+      ? "noConfig"
+      : decision.status === "out-of-tree"
+        ? "outOfTree"
+        : decision.status;
+  accumulator.counts[statusKey]++;
+  if (decision.basis) {
+    accumulator.basisCounts[decision.basis] = (accumulator.basisCounts[decision.basis] ?? 0) + 1;
+  }
+  if (accumulator.entries.length < SCOPE_DECISION_MAX_ENTRIES) {
+    accumulator.entries.push({ file, status: decision.status, basis: decision.basis });
+  }
+}
+
 type FileRoute = {
   serverName: string;
   serverConfig: ServerConfig;
@@ -639,6 +676,8 @@ export class LspManager {
     restartIfStillStale?: boolean;
     maxWaitMs?: number;
     quietMs?: number;
+    /** Evidence from a refresh the caller already completed; skips this pass's own refresh when no watched-file changes apply. */
+    initialEvidence?: DiagnosticEvidenceSummary;
     control?: CodeRequestControl;
   }): Promise<WorkspaceRecoveryResult> {
     return recoverWorkspaceDiagnosticsImpl(this, options);
@@ -767,6 +806,55 @@ export class LspManager {
       .filter((entry) => entry.openFiles.length > 0);
     return formatCoverageSummaryText(relevantEntries, maxServers, maxFiles);
   }
+  /**
+   * Capture one coherent diagnostic report from the current client snapshots.
+   *
+   * Summary and detailed projections share the same cache observation so a
+   * caller cannot combine entries from one generation with evidence from
+   * another.
+   */
+  getWorkspaceDiagnosticReport(maxSeverity: number = 2): WorkspaceDiagnosticReport {
+    this.pruneMissingFiles();
+    const snapshots = Array.from(this.clients.values()).map((client) =>
+      client.getDiagnosticSnapshot(),
+    );
+    const evidence = this.toWorkspaceDiagnosticEvidence(
+      snapshots.flatMap((snapshot) =>
+        snapshot.documents.map((document) => ({
+          file: relativeFilePathFromUri(document.uri, this.cwd),
+          status: document.status,
+        })),
+      ),
+    );
+    const current =
+      snapshots.every((snapshot) => snapshot.current) &&
+      evidence.documents.every((document) => document.status === "confirmed");
+    const fileDiags = new Map<string, { errors: number; warnings: number }>();
+    for (const snapshot of snapshots) {
+      for (const entry of snapshot.entries) {
+        collectDiagnosticSummaryCounts(fileDiags, entry, this.cwd, this.excludePatterns);
+      }
+    }
+
+    return {
+      summary: {
+        entries: Array.from(fileDiags.entries()).map(([file, counts]) => ({ file, ...counts })),
+        current,
+        evidence,
+      },
+      outstanding: {
+        entries: collectOutstandingDiagnosticsDetailed(
+          snapshots.map((snapshot) => snapshot.entries),
+          this.cwd,
+          this.excludePatterns,
+          maxSeverity,
+        ),
+        current,
+        evidence,
+      },
+    };
+  }
+
   /** Get a diagnostic summary across all servers and files. */
   getDiagnosticSummary(): DiagnosticSummary[] {
     return this.getDiagnosticSnapshot().entries;
@@ -811,15 +899,16 @@ export class LspManager {
     evidence: DiagnosticEvidenceSummary;
   } {
     this.pruneMissingFiles();
-    const evidence = this.toWorkspaceDiagnosticEvidence(
-      collectClientDiagnosticEvidenceDocuments(this.clients.values(), this.cwd),
+    const snapshots = Array.from(this.clients.values()).map((client) =>
+      client.getDiagnosticSnapshot(),
     );
-    const clientCurrent = Array.from(this.clients.values()).every(
-      (client) => client.getDiagnosticSnapshot().current,
+    const evidence = this.toWorkspaceDiagnosticEvidence(
+      collectClientDiagnosticEvidenceDocuments(snapshots, this.cwd),
     );
+    const clientCurrent = snapshots.every((snapshot) => snapshot.current);
     return {
       entries: collectOutstandingDiagnosticSummaryEntries(
-        this.clients.values(),
+        snapshots,
         this.cwd,
         this.excludePatterns,
         maxSeverity,
@@ -854,29 +943,62 @@ export class LspManager {
     evidence: DiagnosticEvidenceSummary;
   } {
     this.pruneMissingFiles();
-    const clients = Array.from(this.clients.values());
-    let clientCurrent = true;
-    const evidenceDocuments = clients.flatMap((client) => {
-      const snapshot = client.getDiagnosticSnapshot();
-      clientCurrent &&= snapshot.current;
-      return snapshot.documents.map((document) => ({
+    const snapshots = Array.from(this.clients.values()).map((client) =>
+      client.getDiagnosticSnapshot(),
+    );
+    const evidenceDocuments = snapshots.flatMap((snapshot) =>
+      snapshot.documents.map((document) => ({
         file: relativeFilePathFromUri(document.uri, this.cwd),
         status: document.status,
-      }));
-    });
+      })),
+    );
     const evidence = this.toWorkspaceDiagnosticEvidence(evidenceDocuments);
     return {
       entries: collectOutstandingDiagnosticsDetailed(
-        clients,
+        snapshots.map((snapshot) => snapshot.entries),
         this.cwd,
         this.excludePatterns,
         maxSeverity,
       ),
       current:
-        clientCurrent && evidence.documents.every((document) => document.status === "confirmed"),
+        snapshots.every((snapshot) => snapshot.current) &&
+        evidence.documents.every((document) => document.status === "confirmed"),
       evidence,
     };
   }
+
+  /**
+   * Aggregate the tsconfig scope decision for every tracked file.
+   *
+   * The recovery telemetry surface uses this to report why tracked files are
+   * in or out of scope without re-deriving the scope logic. The returned
+   * entry list is bounded; counts are exact.
+   */
+  getScopeDecisionSummary(): ScopeDecisionSummary {
+    this.pruneMissingFiles();
+    const accumulator: ScopeDecisionAccumulator = {
+      entries: [],
+      counts: { included: 0, excluded: 0, noConfig: 0, outOfTree: 0 },
+      basisCounts: {},
+    };
+    let totalFiles = 0;
+
+    for (const client of this.clients.values()) {
+      for (const document of client.getDiagnosticSnapshot().documents) {
+        const file = relativeFilePathFromUri(document.uri, this.cwd);
+        totalFiles++;
+        accumulateScopeDecision(accumulator, file, getFileScopeDecision(file, this.cwd));
+      }
+    }
+
+    return {
+      caseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+      counts: accumulator.counts,
+      basisCounts: accumulator.basisCounts,
+      entries: accumulator.entries,
+      totalFiles,
+    };
+  }
   private toWorkspaceDiagnosticEvidence(
     documents: readonly DiagnosticEvidenceDocument[],
   ): DiagnosticEvidenceSummary {
@@ -1089,11 +1211,11 @@ export class LspManager {
 }
 
 function collectClientDiagnosticEvidenceDocuments(
-  clients: Iterable<LspClient>,
+  snapshots: Iterable<ClientDiagnosticSnapshot>,
   cwd: string,
 ): DiagnosticEvidenceDocument[] {
-  return Array.from(clients).flatMap((client) =>
-    client.getDiagnosticSnapshot().documents.map((document) => ({
+  return Array.from(snapshots).flatMap((snapshot) =>
+    snapshot.documents.map((document) => ({
       file: relativeFilePathFromUri(document.uri, cwd),
       status: document.status,
     })),
@@ -1101,14 +1223,14 @@ function collectClientDiagnosticEvidenceDocuments(
 }
 
 function collectOutstandingDiagnosticSummaryEntries(
-  clients: Iterable<LspClient>,
+  snapshots: Iterable<ClientDiagnosticSnapshot>,
   cwd: string,
   excludePatterns: string[],
   maxSeverity: number,
 ): OutstandingDiagnosticSummaryEntry[] {
   const fileDiags = new Map<string, OutstandingDiagnosticSummaryEntry>();
-  for (const client of clients) {
-    for (const entry of client.getDiagnosticSnapshot().entries) {
+  for (const snapshot of snapshots) {
+    for (const entry of snapshot.entries) {
       const file = relativeFilePathFromUri(entry.uri, cwd);
       if (shouldIgnoreLspPath(file, cwd) || isExcludedByPattern(file, excludePatterns)) continue;
       const existing = fileDiags.get(file) ?? createOutstandingDiagnosticSummary(file);

package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts

@@ -35,6 +35,8 @@ export interface WorkspaceLspDiagnosticSurface {
     restartIfStillStale?: boolean;
     maxWaitMs?: number;
     quietMs?: number;
+    /** Evidence from a refresh the caller already completed; skips this pass's own refresh when no watched-file changes apply. */
+    initialEvidence?: DiagnosticEvidenceSummary;
     control?: CodeRequestControl;
   }): Promise<RecoverDiagnosticsResult>;
 }

package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts

@@ -21,6 +21,20 @@ export interface WorkspaceDiagnosticSummaryEntry {
   warnings: number;
 }
 
+/**
+ * One coherent post-refresh observation of workspace diagnostics.
+ *
+ * Both projections are captured from the same client snapshots. The report is
+ * short-lived and must not be retained as the runtime's last refresh attempt.
+ */
+export interface WorkspaceDiagnosticReport {
+  summary: WorkspaceDiagnosticSnapshot<WorkspaceDiagnosticSummaryEntry>;
+  outstanding: WorkspaceDiagnosticSnapshot<{
+    file: string;
+    diagnostics: Diagnostic[];
+  }>;
+}
+
 /** Outstanding diagnostics grouped by file, including info and hint counts. */
 export interface OutstandingDiagnosticSummaryEntry {
   file: string;
@@ -36,8 +50,10 @@ export interface RecoverDiagnosticsResult {
   /** Active clients targeted by the best-effort refresh, not confirmed successful refreshes. */
   attemptedClients: number;
   restartedClients: number;
-  /** Final document-level evidence from the last refresh in this recovery pass. */
+  /** Evidence collected by the refresh and recovery operations. */
   diagnosticEvidence: DiagnosticEvidenceSummary;
+  /** Final diagnostic report captured after all refresh and recovery work. */
+  diagnosticReport: WorkspaceDiagnosticReport;
   /** Failure from the first refresh, when no later pass replaced it. */
   refreshFailureReason?: string;
   /** Wall-clock duration of the whole recovery pass, for telemetry. */
@@ -48,3 +64,29 @@ export interface RecoverDiagnosticsResult {
     warning: string | null;
   };
 }
+
+/** One tracked file's tsconfig scope decision, for debug telemetry. */
+export interface ScopeDecisionEntry {
+  /** Workspace-relative file path. */
+  file: string;
+  status: "included" | "excluded" | "no-config" | "out-of-tree";
+  /** Decision mechanism; null when no decision applies. */
+  basis: string | null;
+}
+
+/** Aggregate tsconfig scope decisions for all tracked files, for debug telemetry. */
+export interface ScopeDecisionSummary {
+  caseSensitiveFileNames: boolean;
+  counts: {
+    included: number;
+    excluded: number;
+    noConfig: number;
+    outOfTree: number;
+  };
+  /** Exact decision-basis counts; keys are {@link ScopeDecisionEntry.basis} values. */
+  basisCounts: Record<string, number>;
+  /** Bounded workspace-relative entries (oldest first), not the full set. */
+  entries: ScopeDecisionEntry[];
+  /** Total number of tracked files the summary was computed over. */
+  totalFiles: number;
+}

package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts

@@ -45,6 +45,7 @@ export type {
   DiagnosticEvidenceSummary,
   OutstandingDiagnosticSummaryEntry,
   RecoverDiagnosticsResult,
+  WorkspaceDiagnosticReport,
   WorkspaceDiagnosticSnapshot,
   WorkspaceDiagnosticSummaryEntry,
 } from "./runtime-diagnostics.ts";
@@ -63,6 +64,33 @@ function unavailableFileQuery<T>(operation: string, file: string): CodeQueryResu
   return unavailableCodeQuery(`No routed LSP client could complete ${operation} for ${file}.`);
 }
 
+/** Emit one aggregate tsconfig scope-decision event after a recovery pass. */
+function recordScopeDecisionEvent(manager: LspManager): void {
+  try {
+    const summary = manager.getScopeDecisionSummary();
+    recordDebugEvent({
+      source: "lsp",
+      level: "debug",
+      category: "diagnostics.scope",
+      message: "LSP diagnostic tsconfig scope decisions",
+      cwd: truncateIdentity(manager.getCwd()),
+      data: {
+        caseSensitiveFileNames: summary.caseSensitiveFileNames,
+        counts: summary.counts,
+        basisCounts: summary.basisCounts,
+        totalFiles: summary.totalFiles,
+        entries: summary.entries.map((entry) => ({
+          file: truncateIdentity(entry.file),
+          status: entry.status,
+          ...(entry.basis ? { basis: entry.basis } : {}),
+        })),
+      },
+    });
+  } catch {
+    // Telemetry must never turn a completed recovery into a failure.
+  }
+}
+
 class DefaultWorkspaceLspRuntime implements WorkspaceLspRuntime {
   constructor(private readonly manager: LspManager) {}
 
@@ -315,6 +343,8 @@ class DefaultWorkspaceLspRuntime implements WorkspaceLspRuntime {
     restartIfStillStale?: boolean;
     maxWaitMs?: number;
     quietMs?: number;
+    /** Evidence from a refresh the caller already completed; skips this pass's own refresh when no watched-file changes apply. */
+    initialEvidence?: DiagnosticEvidenceSummary;
     control?: CodeRequestControl;
   }): Promise<RecoverDiagnosticsResult> {
     const recoveryStartedAt = Date.now();
@@ -337,6 +367,7 @@ class DefaultWorkspaceLspRuntime implements WorkspaceLspRuntime {
           ...(result.restartReason ? { reason: result.restartReason } : {}),
         },
       });
+      recordScopeDecisionEvent(this.manager);
       return result;
     } catch (error) {
       // A cancelled pass has no result object, so telemetry records the

package/node_modules/@mrclrchtr/supi-tree-sitter/README.md

@@ -6,6 +6,8 @@
 
 # @mrclrchtr/supi-tree-sitter
 
+[![GitHub stars](https://img.shields.io/github/stars/mrclrchtr/supi)](https://github.com/mrclrchtr/supi/stargazers)
+
 Tree-sitter structural code analysis library for the [pi coding agent](https://github.com/earendil-works/pi).
 
 This is a **library-only** package — it has no pi extension surface. Use `@mrclrchtr/supi-code-intelligence`

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/README.md

@@ -6,6 +6,8 @@
 
 # @mrclrchtr/supi-code-runtime
 
+[![GitHub stars](https://img.shields.io/github/stars/mrclrchtr/supi)](https://github.com/mrclrchtr/supi/stargazers)
+
 Shared workspace context, capability contracts, and canonical types for the SuPi code-understanding stack.
 
 This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It is not installed directly — `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` bundle it and use its shared abstractions to communicate capability availability.

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "5.0.0",
+  "version": "6.0.1",
   "description": "Shared workspace context and capability contracts for code intelligence",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md

@@ -6,6 +6,8 @@
 
 # @mrclrchtr/supi-core
 
+[![GitHub stars](https://img.shields.io/github/stars/mrclrchtr/supi)](https://github.com/mrclrchtr/supi/stargazers)
+
 Shared infrastructure for SuPi extensions.
 
 This is a **pure library** — it does not register any pi commands or tools. The `/supi-settings` command is now available through `@mrclrchtr/supi-settings`.

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "5.0.0",
+  "version": "6.0.1",
   "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
@@ -53,7 +53,7 @@
     "./api": "./src/api.ts",
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
-    "./debug": "./src/debug-registry.ts",
+    "./debug": "./src/debug.ts",
     "./evidence-badge": "./src/evidence-badge.ts",
     "./footer-registry": "./src/footer-registry.ts",
     "./llm": "./src/llm.ts",

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -11,7 +11,7 @@ export * from "./config.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./debug-registry.ts";
+export * from "./debug.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./evidence-badge.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts

@@ -4,9 +4,6 @@
 // supi-debug extension owns policy/configuration and exposes events through a
 // command/tool while this module stays dependency-free for producers.
 
-// biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
-export * from "./debug-timing.ts";
-
 export type DebugLevel = "debug" | "info" | "warning" | "error";
 export type DebugAgentAccess = "off" | "sanitized" | "raw";
 export interface DebugRegistryConfig {

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug.ts

@@ -0,0 +1,9 @@
+// Debug domain entry for `@mrclrchtr/supi-core/debug`.
+//
+// Kept separate from debug-registry.ts so debug-timing.ts can import the
+// registry without creating an import cycle through the barrel re-export.
+
+// biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
+export * from "./debug-registry.ts";
+// biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
+export * from "./debug-timing.ts";

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/index.ts

@@ -11,7 +11,7 @@ export * from "./config.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
-export * from "./debug-registry.ts";
+export * from "./debug.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./footer-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel