@mrclrchtr/supi-code-intelligence 4.4.0 → 4.5.1

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

@@ -1,7 +1,7 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
     <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/logo.png" alt="SuPi" width="50%">
+      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
     </picture>
   </a>
 </div>

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

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": "4.4.0",
+  "version": "4.5.1",
   "description": "SuPi code-runtime — shared workspace context, capability contracts, and canonical types for the code-understanding stack",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "4.4.0"
+    "@mrclrchtr/supi-core": "4.5.1"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

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

@@ -1,7 +1,7 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
     <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/logo.png" alt="SuPi" width="50%">
+      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
     </picture>
   </a>
 </div>

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-tree-sitter",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "SuPi Tree-sitter library — structural AST analysis for pi",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,8 @@
   ],
   "dependencies": {
     "web-tree-sitter": "^0.26.8",
-    "@mrclrchtr/supi-code-runtime": "4.4.0",
-    "@mrclrchtr/supi-core": "4.4.0"
+    "@mrclrchtr/supi-code-runtime": "4.5.1",
+    "@mrclrchtr/supi-core": "4.5.1"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-code-intelligence",
-  "version": "4.4.0",
-  "description": "SuPi Code Intelligence extension — workspace orientation, target resolution and inspection, relationship analysis, code-aware search, live health, and semantic refactoring for pi",
+  "version": "4.5.1",
+  "description": "LSP and Tree-sitter AST code intelligence for the Pi coding agent — semantic navigation, structural search, diagnostics, and safe refactoring",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,8 @@
     "impact-analysis",
     "refactoring",
     "lsp",
-    "tree-sitter"
+    "tree-sitter",
+    "ast"
   ],
   "type": "module",
   "files": [
@@ -34,10 +35,10 @@
   ],
   "dependencies": {
     "yaml": "^2.9.0",
-    "@mrclrchtr/supi-code-runtime": "4.4.0",
-    "@mrclrchtr/supi-core": "4.4.0",
-    "@mrclrchtr/supi-tree-sitter": "4.4.0",
-    "@mrclrchtr/supi-lsp": "4.4.0"
+    "@mrclrchtr/supi-core": "4.5.1",
+    "@mrclrchtr/supi-lsp": "4.5.1",
+    "@mrclrchtr/supi-code-runtime": "4.5.1",
+    "@mrclrchtr/supi-tree-sitter": "4.5.1"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",
@@ -70,7 +71,7 @@
     "extensions": [
       "./src/extension.ts"
     ],
-    "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-code-intelligence.png"
+    "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-code-intelligence/assets/social-preview.png"
   },
   "main": "src/index.ts",
   "exports": {

package/src/extension.ts

@@ -5,6 +5,8 @@ import type { BeforeAgentStartEventResult, ExtensionAPI } from "@earendil-works/
 import { buildArchitectureModel } from "./analysis/architecture/discovery.ts";
 import { createCodeIntelligenceApp } from "./app/app.ts";
 import { registerCodeIntelligenceSettings } from "./config.ts";
+import { estimateTokens, OVERVIEW_TOKEN_BUDGET, renderOverview } from "./overview/overview.ts";
+import { buildOverviewData } from "./overview/overview-data.ts";
 import type { WorkspaceCodeIntelligenceSession } from "./session/session.ts";
 import { registerLspSessionLifecycle } from "./substrate/lsp/lifecycle.ts";
 import { registerWorkspaceRecoveryHandler } from "./substrate/lsp/recovery.ts";
@@ -12,8 +14,6 @@ import { registerLspSettings } from "./substrate/lsp/settings.ts";
 import { createLspAdapterState } from "./substrate/lsp/state.ts";
 import { registerCodeIntelligenceTools } from "./tool/register.ts";
 import { registerLspFooterContribution } from "./ui/footer.ts";
-import { estimateTokens, OVERVIEW_TOKEN_BUDGET, renderOverview } from "./ui/markdown/overview.ts";
-import { buildOverviewData } from "./ui/markdown/overview-data.ts";
 import { registerCiStatusCommand } from "./ui/status-command.ts";
 
 const OVERVIEW_CUSTOM_TYPE = "code-intelligence-overview";

package/src/{ui/markdown → overview}/overview-data.ts

@@ -7,7 +7,7 @@ import type {
   ArchitectureModel,
   ManifestField,
   ModuleInfo,
-} from "../../analysis/architecture/model.ts";
+} from "../analysis/architecture/model.ts";
 import type { OverviewData, OverviewModule } from "./types.ts";
 
 /** Grammar ID to short language tag for the overview. */

package/src/overview/types.ts

@@ -0,0 +1,21 @@
+/** Use-case data for the workspace architecture overview. */
+
+/** One discovered workspace package and its manifest-declared surface. */
+export interface OverviewModule {
+  name: string;
+  shortName: string;
+  description: string | null;
+  /** Manifest-declared package relationships to other discovered packages. */
+  declaredDependencies: string[];
+  /** Field-labelled manifest path declarations, never selected by precedence. */
+  declaredEntrypoints: string[];
+}
+
+/** Project-level overview data rendered by the overview markdown adapter. */
+export interface OverviewData {
+  projectName: string | null;
+  projectDescription: string | null;
+  modules: OverviewModule[];
+  /** Detected source languages (e.g. ["ts", "js", "py"]). */
+  detectedLanguages: string[] | null;
+}

package/src/session/orientation/collect.ts

@@ -15,19 +15,17 @@ import {
   readNextTarget,
 } from "../../analysis/read-next.ts";
 import { diagnosticMessageString } from "../../substrate/lsp/utils.ts";
-import { gatherTreeSitterContext } from "../../ui/markdown/gather.ts";
 import type {
   OrientationDeps,
   OrientationInput,
-  OrientationSection,
-  OrientationTarget,
-} from "../../ui/markdown/types.ts";
-import type {
   OrientationItem,
   OrientationResultData,
+  OrientationSection,
   OrientationSectionData,
 } from "../orientation-types.ts";
+import type { TargetStoreEntry } from "../target-store.ts";
 import { collectContextOrientationFacts } from "./context-facts.ts";
+import { gatherSubstrateContext } from "./gather.ts";
 
 interface TargetSectionCollection {
   readonly items: OrientationItem[];
@@ -126,7 +124,7 @@ async function executeTargetOrientation(
 
 async function buildRequestedSection(options: {
   section: OrientationSection;
-  target: OrientationTarget | null | undefined;
+  target: Readonly<TargetStoreEntry> | null | undefined;
   deps: OrientationDeps;
   limit: number;
   treeContext: Awaited<ReturnType<typeof maybeGatherTreeContext>>;
@@ -159,7 +157,7 @@ async function buildRequestedSection(options: {
 
 /** Build enriched defs section: tree-sitter definitions + LSP definition targets. */
 async function buildEnrichedDefsSection(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   deps: OrientationDeps,
   treeContext: Awaited<ReturnType<typeof maybeGatherTreeContext>>,
   limit: number,
@@ -206,7 +204,7 @@ async function buildEnrichedDefsSection(
 }
 
 async function collectDefinitionTargets(
-  target: OrientationTarget,
+  target: Readonly<TargetStoreEntry>,
   deps: OrientationDeps,
   limit: number,
 ): Promise<
@@ -226,8 +224,8 @@ async function collectDefinitionTargets(
   }
   try {
     const result = await deps.provider.definition(target.file, {
-      line: target.line - 1,
-      character: target.character - 1,
+      line: target.displayLine - 1,
+      character: target.displayCharacter - 1,
     });
     if (result.kind === "unavailable") {
       return {
@@ -275,7 +273,7 @@ async function collectDefinitionTargets(
 }
 
 async function buildDiagnosticsSection(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   deps: OrientationDeps,
   limit: number,
 ): Promise<TargetSectionCollection> {
@@ -306,7 +304,7 @@ async function buildDiagnosticsSection(
       );
     }
     const nearby = result.data.filter(
-      (diagnostic) => Math.abs((diagnostic.range.start.line ?? 0) + 1 - target.line) <= 5,
+      (diagnostic) => Math.abs((diagnostic.range.start.line ?? 0) + 1 - target.displayLine) <= 5,
     );
     const evidence =
       result.kind === "partial"
@@ -380,7 +378,7 @@ function unavailableTargetSection(
 
 // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: JSDoc parsing naturally has state-machine complexity
 async function buildDocsSection(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   deps: OrientationDeps,
   limit: number,
 ): Promise<TargetSectionCollection> {
@@ -404,7 +402,7 @@ async function buildDocsSection(
   try {
     const content = readFileSync(targetFile, "utf-8");
     const lines = content.split("\n");
-    const startIdx = Math.max(0, target.line - 2);
+    const startIdx = Math.max(0, target.displayLine - 2);
     let jsdocStart = -1;
     let jsdocEnd = -1;
 
@@ -483,16 +481,22 @@ async function buildDocsSection(
 }
 
 async function maybeGatherTreeContext(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   deps: OrientationDeps,
 ) {
   if (!target) return null;
   const relPath = path.relative(deps.cwd, target.file);
-  return gatherTreeSitterContext(deps.provider, relPath, target.line, target.character);
+  return gatherSubstrateContext(
+    deps.provider,
+    relPath,
+    target.displayLine,
+    target.displayCharacter,
+    target.anchorKind !== "declaration",
+  );
 }
 
 function buildDefinitionItems(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   cwd: string,
   treeContext: Awaited<ReturnType<typeof maybeGatherTreeContext>>,
 ): OrientationItem[] {
@@ -507,6 +511,12 @@ function buildDefinitionItems(
       text: `Symbol: \`${target.name}\`${target.kind ? ` (${target.kind})` : ""}`,
     });
   }
+  if (target.anchorKind === "declaration") {
+    items.push({
+      kind: "paragraph",
+      text: "Node and hover evidence withheld: this target has a declaration anchor, and position-strict substrates require a name anchor (ADR 0003).",
+    });
+  }
   if (treeContext?.nodeInfo?.type) {
     items.push({ kind: "list-item", text: `Node: \`${treeContext.nodeInfo.type}\`` });
   }
@@ -593,22 +603,25 @@ function hoverBodyItems(lines: readonly string[]): OrientationItem[] {
   return items;
 }
 
-function formatFocusTarget(target: OrientationTarget, cwd: string): string {
+function formatFocusTarget(target: Readonly<TargetStoreEntry>, cwd: string): string {
   const relPath = path.relative(cwd, target.file) || target.file;
-  return `${relPath}:${target.line}:${target.character}`;
+  return `${relPath}:${target.displayLine}:${target.displayCharacter}`;
 }
 
-function buildNextQueries(target: OrientationTarget | null | undefined, cwd: string): string[] {
+function buildNextQueries(
+  target: Readonly<TargetStoreEntry> | null | undefined,
+  cwd: string,
+): string[] {
   if (!target) return ["Use `code_orientation` for a neutral orientation summary."];
 
   const relPath = path.relative(cwd, target.file) || target.file;
   return [
-    `\`code_graph\` with \`target: { anchor: { file: "${relPath}", line: ${target.line}, character: ${target.character} } }\` for relation follow-up`,
+    `\`code_graph\` with \`target: { anchor: { file: "${relPath}", line: ${target.displayLine}, character: ${target.displayCharacter} } }\` for relation follow-up`,
   ];
 }
 
 function buildReadNextGuidance(
-  target: OrientationTarget | null | undefined,
+  target: Readonly<TargetStoreEntry> | null | undefined,
   treeContext: Awaited<ReturnType<typeof maybeGatherTreeContext>>,
   cwd: string,
 ): ReadNextItem[] {
@@ -616,18 +629,18 @@ function buildReadNextGuidance(
   const relPath = path.relative(cwd, target.file) || target.file;
   const enclosing = findEnclosingOutlineItem(target, treeContext);
   if (enclosing) {
-    return [readNextEnclosingScope(relPath, enclosing, target.line)];
+    return [readNextEnclosingScope(relPath, enclosing, target.displayLine)];
   }
-  return [readNextTarget(relPath, target.line, "inspect the target implementation")];
+  return [readNextTarget(relPath, target.displayLine, "inspect the target implementation")];
 }
 
 function findEnclosingOutlineItem(
-  target: OrientationTarget,
+  target: Readonly<TargetStoreEntry>,
   treeContext: Awaited<ReturnType<typeof maybeGatherTreeContext>>,
 ): { name: string; kind: string; startLine: number; endLine: number } | null {
   if (!treeContext || treeContext.outline.length === 0) return null;
   const candidates = treeContext.outline.filter(
-    (item) => item.startLine <= target.line && item.endLine >= target.line,
+    (item) => item.startLine <= target.displayLine && item.endLine >= target.displayLine,
   );
   if (candidates.length === 0) return null;
   const matchingName = candidates.find((item) => target.name && item.name === target.name);

package/src/{ui/markdown → session/orientation}/gather.ts

@@ -1,8 +1,9 @@
 /**
- * Substrate context gathering for symbol briefs and point inspection (code_inspect).
+ * Substrate context gathering for symbol-centered Orientation.
  *
- * Extracted from generate-brief.ts to keep the file within the
- * noExcessiveLinesPerFile threshold.
+ * Best-effort tree-sitter node/outline/imports/exports context plus LSP
+ * hover/definition at one target position. Consumed by the Orientation
+ * evidence collector in `collect.ts`.
  */
 
 import type {
@@ -11,13 +12,18 @@ import type {
   StructuralProvider,
 } from "@mrclrchtr/supi-code-runtime/api";
 
+/** Structural provider subset plus optional semantic hover/definition used for gathering. */
 export type ContextGatherProvider = Pick<
   StructuralProvider,
   "nodeAt" | "outline" | "imports" | "exports"
 > &
   Partial<Pick<SemanticProvider, "hover" | "definition">>;
 
-export interface TreeSitterContext {
+/**
+ * Best-effort substrate evidence at one target position. `null` fields mean
+ * the evidence was unavailable, not that the position is invalid.
+ */
+export interface SubstrateContext {
   nodeInfo: {
     type: string;
     text: string;
@@ -40,32 +46,46 @@ export interface TreeSitterContext {
   definition: Array<{ uri: string; range: SourceRange }> | null;
 }
 
+/**
+ * Gather best-effort substrate context at one target position.
+ *
+ * `line`/`character` are 1-based display coordinates; LSP hover/definition
+ * queries convert to 0-based internally. Position-strict operations
+ * (tree-sitter `nodeAt`, hover-at) run only when `positionStrict` is true —
+ * callers holding a declaration-anchor target must pass false (ADR 0003).
+ * File-level evidence (outline, imports, exports) and position-tolerant
+ * definition lookups run regardless. Failures degrade to `null`/empty.
+ */
 // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: best-effort substrate gathering with independent try/catch blocks kept together for readability
-export async function gatherTreeSitterContext(
+// biome-ignore lint/complexity/useMaxParams: one internal gather call site carries the full position context
+export async function gatherSubstrateContext(
   provider: ContextGatherProvider | null,
   relPath: string,
   line: number,
   character: number,
-): Promise<TreeSitterContext> {
-  let nodeInfo: TreeSitterContext["nodeInfo"] = null;
-  let outline: TreeSitterContext["outline"] = [];
-  let imports: TreeSitterContext["imports"] = [];
-  let exports: TreeSitterContext["exports"] = [];
-  let hover: TreeSitterContext["hover"] = null;
-  let definition: TreeSitterContext["definition"] = null;
+  positionStrict: boolean,
+): Promise<SubstrateContext> {
+  let nodeInfo: SubstrateContext["nodeInfo"] = null;
+  let outline: SubstrateContext["outline"] = [];
+  let imports: SubstrateContext["imports"] = [];
+  let exports: SubstrateContext["exports"] = [];
+  let hover: SubstrateContext["hover"] = null;
+  let definition: SubstrateContext["definition"] = null;
 
   if (!provider) return { nodeInfo, outline, imports, exports, hover, definition: null };
 
   try {
-    const nodeResult = await provider.nodeAt(relPath, line, character);
-    if (nodeResult.kind === "success") {
-      nodeInfo = {
-        type: nodeResult.data.type,
-        text: nodeResult.data.text,
-        startLine: nodeResult.data.startLine,
-        startCharacter: nodeResult.data.startCharacter,
-        ancestry: nodeResult.data.ancestry ?? [],
-      };
+    if (positionStrict) {
+      const nodeResult = await provider.nodeAt(relPath, line, character);
+      if (nodeResult.kind === "success") {
+        nodeInfo = {
+          type: nodeResult.data.type,
+          text: nodeResult.data.text,
+          startLine: nodeResult.data.startLine,
+          startCharacter: nodeResult.data.startCharacter,
+          ancestry: nodeResult.data.ancestry ?? [],
+        };
+      }
     }
 
     const outlineResult = await provider.outline(relPath);
@@ -91,8 +111,8 @@ export async function gatherTreeSitterContext(
       }));
     }
 
-    // Best-effort hover — LSP expects 0-based coordinates
-    if (provider.hover) {
+    // Best-effort hover — LSP expects 0-based coordinates; hover-at is position-strict.
+    if (positionStrict && provider.hover) {
       try {
         const hoverResult = await provider.hover(relPath, {
           line: line - 1,
@@ -104,7 +124,7 @@ export async function gatherTreeSitterContext(
       }
     }
 
-    // Best-effort definition — LSP expects 0-based coordinates
+    // Best-effort definition — LSP expects 0-based coordinates; definitions are position-tolerant.
     if (provider.definition) {
       try {
         const defResult = await provider.definition(relPath, {

package/src/session/orientation-types.ts

@@ -1,6 +1,9 @@
 import type { ConfidenceMode } from "@mrclrchtr/supi-code-runtime/api";
+import type { WorkspaceLspRuntimeState } from "@mrclrchtr/supi-lsp/api";
+import type { ArchitectureModel } from "../analysis/architecture/model.ts";
 import type { EvidenceListMetadata } from "../analysis/evidence.ts";
 import type { InstructionFilesMetadata } from "../analysis/instruction-files.ts";
+import type { CodeProvider } from "../analysis/provider.ts";
 import type { ReadNextItem } from "../analysis/read-next.ts";
 import type { OrientationTargetInput, TargetSymbolKind } from "./target-input.ts";
 import type { AnchorKind, TargetStoreEntry } from "./target-store.ts";
@@ -16,6 +19,26 @@ export interface OrientationWorkflowInput {
   readonly maxResults?: number;
 }
 
+/** Section keys the Orientation evidence collector gathers for a precise target. */
+export type OrientationSection = "defs" | "docs" | "diagnostics";
+
+/** Input to the Orientation evidence collector. */
+export interface OrientationInput {
+  /** Resolved target entry, consumed read-only; absent for context orientation. */
+  target?: Readonly<TargetStoreEntry> | null;
+  /** Resolved orientation focus path for project/module/directory/file orientation. */
+  focus?: string;
+  maxResults?: number;
+}
+
+/** Capabilities the Orientation evidence collector requires. */
+export interface OrientationDeps {
+  readonly model: ArchitectureModel;
+  readonly provider: CodeProvider | null;
+  readonly cwd: string;
+  readonly lspRuntime: WorkspaceLspRuntimeState;
+}
+
 /**
  * Presentation-neutral content atom a collector emits for one Orientation
  * section. Collectors never build headings, section notes, or document

package/src/session/orientation-workflow.ts

@@ -148,17 +148,7 @@ async function orientTarget(options: {
         reason: readiness.kind === "timeout" ? "Semantic readiness timed out" : readiness.reason,
       };
   const result = await executeOrientation(
-    {
-      target: {
-        file: entry.file,
-        line: entry.displayLine,
-        character: entry.displayCharacter,
-        name: entry.name,
-        kind: entry.kind,
-        anchorKind: entry.anchorKind,
-      },
-      maxResults,
-    },
+    { target: entry, maxResults },
     {
       model,
       provider,

package/src/types/execution.ts

@@ -6,7 +6,7 @@ import type {
   InspectDetails,
   ResolveDetails,
   SearchDetails,
-} from "./details.ts";
+} from "../tool/result/types.ts";
 
 /**
  * Execution context passed to every code-intelligence tool executor.

package/src/types/index.ts

@@ -23,4 +23,4 @@ export type {
   OrientationSectionDetails,
   ResolveDetails,
   SearchDetails,
-} from "./details.ts";
+} from "../tool/result/types.ts";

package/src/types/details.ts

@@ -1,18 +0,0 @@
-/**
- * Compatibility export for tool-result detail shapes.
- *
- * Public code-intelligence details are assembled in `src/tool/result/`.
- * Import new result assembly code from `../tool/result/types.ts` directly.
- */
-export type {
-  AnchoredResolutionMetadata,
-  AnchoredResolutionSource,
-  ContextDetails,
-  DisambiguationCandidate,
-  HealthDetails,
-  HealthSectionDetails,
-  InspectDetails,
-  OrientationSectionDetails,
-  ResolveDetails,
-  SearchDetails,
-} from "../tool/result/types.ts";

package/src/ui/markdown/types.ts

@@ -1,75 +0,0 @@
-// Shared typed data interfaces between use-case and presentation layers.
-
-import type { WorkspaceLspRuntimeState } from "@mrclrchtr/supi-lsp/api";
-import type { ArchitectureModel } from "../../analysis/architecture/model.ts";
-import type { CodeProvider } from "../../analysis/provider.ts";
-import type { AnchorKind } from "../../session/target-store.ts";
-import type { InspectDetails } from "../../types/details.ts";
-
-// ── Overview use-case ───────────────────────────────────────────────
-
-export interface OverviewModule {
-  name: string;
-  shortName: string;
-  description: string | null;
-  /** Manifest-declared package relationships to other discovered packages. */
-  declaredDependencies: string[];
-  /** Field-labelled manifest path declarations, never selected by precedence. */
-  declaredEntrypoints: string[];
-}
-
-export interface OverviewData {
-  projectName: string | null;
-  projectDescription: string | null;
-  modules: OverviewModule[];
-  /** Detected source languages (e.g. ["ts", "js", "py"]). */
-  detectedLanguages: string[] | null;
-}
-
-// ── Inspect use-case ─────────────────────────────────────────────────
-
-export interface InspectInput {
-  file: string;
-  line: number;
-  character: number;
-  maxResults?: number;
-}
-
-export interface InspectDeps {
-  provider: CodeProvider | null;
-  cwd: string;
-  lspRuntime: WorkspaceLspRuntimeState;
-}
-
-export interface InspectUseCaseResult {
-  content: string;
-  details: InspectDetails;
-}
-
-// ── Orientation use-case ─────────────────────────────────────────────────
-
-export type OrientationSection = "defs" | "docs" | "diagnostics";
-
-export interface OrientationTarget {
-  file: string;
-  line: number;
-  character: number;
-  name: string | null;
-  kind: string | null;
-  /** Which anchor this target carries; strict consumers refuse declaration anchors. */
-  anchorKind: AnchorKind;
-}
-
-export interface OrientationInput {
-  target?: OrientationTarget | null;
-  /** Resolved orientation focus path for project/module/directory/file orientation. */
-  focus?: string;
-  maxResults?: number;
-}
-
-export interface OrientationDeps {
-  model: ArchitectureModel;
-  provider: CodeProvider | null;
-  cwd: string;
-  lspRuntime: WorkspaceLspRuntimeState;
-}