@mrclrchtr/supi-code-intelligence 3.2.0 → 4.0.0

package/src/analysis/brief/inventory.ts

@@ -1,177 +0,0 @@
-/**
- * Directory inventory collection — flat file counts by extension and landmark detection.
- *
- * Extracted from brief-focused.ts to keep the focus-generation modules
- * cohesive and avoid a single 800+ line file.
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-// ── Types ─────────────────────────────────────────────────────────────
-
-/** Flat inventory of a directory tree. */
-export interface DirectoryInventory {
-  totalFiles: number;
-  byExtension: Map<string, number>;
-  landmarkFiles: string[];
-}
-
-// ── Public API ────────────────────────────────────────────────────────
-
-/** Walk a directory tree collecting extension breakdown and landmark files. */
-export function collectDirectoryInventory(dir: string): DirectoryInventory {
-  const byExtension = new Map<string, number>();
-  const landmarkFiles: string[] = [];
-  const state = { totalFiles: 0, byExtension, landmarkFiles };
-
-  function walk(currentPath: string) {
-    let entries: fs.Dirent[];
-    try {
-      entries = fs.readdirSync(currentPath, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      processInventoryEntry(entry, currentPath, walk, state);
-    }
-  }
-
-  walk(dir);
-  landmarkFiles.sort((a, b) => a.localeCompare(b));
-  return { totalFiles: state.totalFiles, byExtension, landmarkFiles };
-}
-
-/** Append inventory (extension breakdown + landmarks) to a lines array. */
-export function addInventoryToLines(lines: string[], inventory: DirectoryInventory): void {
-  if (inventory.totalFiles === 0) return;
-
-  lines.push(`**Files:** ${inventory.totalFiles} total`);
-
-  const sortedExts = [...inventory.byExtension.entries()].sort((a, b) => b[1] - a[1]).slice(0, 10);
-  for (const [ext, count] of sortedExts) {
-    const label = EXTENSION_LABELS.get(ext) ?? (ext || "(no extension)");
-    lines.push(`- ${label}: ${count}`);
-  }
-  if (inventory.byExtension.size > 10) {
-    lines.push(`- _+${inventory.byExtension.size - 10} more extensions_`);
-  }
-
-  if (inventory.landmarkFiles.length > 0) {
-    const unique = [...new Set(inventory.landmarkFiles)].sort((a, b) => a.localeCompare(b));
-    lines.push("");
-    lines.push("**Landmark files:**");
-    for (const f of unique) {
-      lines.push(`- \`${f}\``);
-    }
-  }
-}
-
-// ── Internal helpers ──────────────────────────────────────────────────
-
-/** Process a single directory entry during inventory collection. */
-function processInventoryEntry(
-  entry: fs.Dirent,
-  currentPath: string,
-  walkFn: (p: string) => void,
-  state: {
-    totalFiles: number;
-    byExtension: Map<string, number>;
-    landmarkFiles: string[];
-  },
-): void {
-  if (entry.name.startsWith(".") && entry.isDirectory()) return;
-  if (SKIP_DIRS.has(entry.name)) return;
-  if (entry.isDirectory()) {
-    walkFn(path.join(currentPath, entry.name));
-    return;
-  }
-  state.totalFiles++;
-  const ext = path.extname(entry.name).toLowerCase();
-  state.byExtension.set(ext, (state.byExtension.get(ext) ?? 0) + 1);
-  if (LANDMARK_FILES.has(entry.name)) {
-    state.landmarkFiles.push(entry.name);
-  }
-}
-
-// ── Constants ─────────────────────────────────────────────────────────
-
-/** Human-readable labels for common file extensions. */
-const EXTENSION_LABELS: Map<string, string> = new Map([
-  [".ts", "TypeScript"],
-  [".tsx", "TSX"],
-  [".js", "JavaScript"],
-  [".jsx", "JSX"],
-  [".mts", "TypeScript"],
-  [".cts", "TypeScript"],
-  [".mjs", "JavaScript"],
-  [".cjs", "JavaScript"],
-  [".py", "Python"],
-  [".pyi", "Python"],
-  [".rs", "Rust"],
-  [".go", "Go"],
-  [".mod", "Go"],
-  [".java", "Java"],
-  [".kt", "Kotlin"],
-  [".kts", "Kotlin"],
-  [".rb", "Ruby"],
-  [".php", "PHP"],
-  [".swift", "Swift"],
-  [".cpp", "C++"],
-  [".hpp", "C++"],
-  [".cc", "C++"],
-  [".cxx", "C++"],
-  [".hxx", "C++ Header"],
-  [".c++", "C++"],
-  [".h++", "C++ Header"],
-  [".c", "C"],
-  [".h", "C Header"],
-  [".css", "CSS"],
-  [".scss", "SCSS"],
-  [".less", "Less"],
-  [".html", "HTML"],
-  [".htm", "HTML"],
-  [".xhtml", "HTML"],
-  [".json", "JSON"],
-  [".yaml", "YAML"],
-  [".yml", "YAML"],
-  [".toml", "TOML"],
-  [".md", "Markdown"],
-  [".sh", "Shell"],
-  [".bash", "Shell"],
-  [".zsh", "Shell"],
-  [".r", "R"],
-  [".sql", "SQL"],
-  [".cs", "C#"],
-]);
-
-/** Landmark files — well-known project configuration files. */
-const LANDMARK_FILES = new Set([
-  "package.json",
-  "tsconfig.json",
-  "jsconfig.json",
-  "vite.config.ts",
-  "vitest.config.ts",
-  "jest.config.ts",
-  "playwright.config.ts",
-  "biome.json",
-  "eslint.config.js",
-  ".eslintrc.js",
-  "deno.json",
-  "deno.jsonc",
-  "Cargo.toml",
-  "go.mod",
-  "pyproject.toml",
-  "setup.py",
-  "requirements.txt",
-  "Makefile",
-  "justfile",
-  "Taskfile.yml",
-  "Dockerfile",
-  "docker-compose.yml",
-  ".env.example",
-  ".env.local.example",
-]);
-
-/** Skip these directories during flat inventory walks. */
-const SKIP_DIRS = new Set(["node_modules", "dist", "build", ".git"]);

package/src/analysis/brief/main.ts

@@ -1,176 +0,0 @@
-/**
- * Focused brief generation — dispatches to file or directory brief.
- *
- * This is the main entry point, extracted from the original 800+ line
- * brief-focused.ts. File and directory brief logic now live in sibling
- * modules under use-case/brief/.
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ConfidenceMode } from "@mrclrchtr/supi-code-runtime/api";
-import type { BriefDetails } from "../../types/index.ts";
-import type { ArchitectureModel } from "../architecture/model.ts";
-import { findModuleForPath } from "../architecture/model.ts";
-import { formatGitContext, gatherGitContext } from "../signals/git.ts";
-import {
-  appendPrioritySignalsSection,
-  summarizePrioritySignalsForFiles,
-} from "../signals/project.ts";
-import { generateDirectoryBrief } from "./directory.ts";
-import { generateFileBrief } from "./file.ts";
-import type { BriefOpts } from "./models.ts";
-import { summarizeDirectoryRecursively } from "./summarize.ts";
-
-/**
- * Generate a focused brief for a specific path (directory or file).
- *
- * When opts.provider is available, file briefs include structural
- * context (outline, imports, exports) and inline diagnostics.
- * Module briefs include aggregated diagnostics across source files.
- */
-export async function generateFocusedBrief(
-  model: ArchitectureModel,
-  focusPath: string,
-  opts?: BriefOpts,
-): Promise<{ content: string; details: BriefDetails }> {
-  const resolvedPath = path.resolve(focusPath);
-
-  if (!fs.existsSync(resolvedPath)) {
-    return {
-      content: `**Error:** Path not found: \`${focusPath}\``,
-      details: {
-        confidence: "unavailable",
-        focusTarget: focusPath,
-        startHere: [],
-        publicSurfaces: [],
-        dependencySummary: null,
-        omittedCount: 0,
-        nextQueries: [],
-      },
-    };
-  }
-
-  const stat = fs.statSync(resolvedPath);
-
-  if (stat.isDirectory()) {
-    return await generateDirectoryFocused(model, resolvedPath, focusPath, opts);
-  }
-
-  return await generateFileFocused(model, resolvedPath, focusPath, opts);
-}
-
-// ── Directory dispatch ────────────────────────────────────────────────
-
-async function generateDirectoryFocused(
-  model: ArchitectureModel,
-  resolvedPath: string,
-  originalPath: string,
-  opts?: BriefOpts,
-): Promise<{ content: string; details: BriefDetails }> {
-  const confidence: ConfidenceMode = "structural";
-
-  const { lines, publicSurfaces, nextQueries, startHere } = await generateDirectoryBrief(
-    model,
-    resolvedPath,
-    originalPath,
-    opts,
-  );
-
-  // Determine module info for dependency summary
-  const mod = findModuleForPath(model, resolvedPath);
-  const isModuleRoot = mod && mod.root === resolvedPath;
-
-  // Priority signals
-  const lspService =
-    opts?.lspService ??
-    ({
-      kind: "unavailable" as const,
-      reason: "No LSP service",
-    } as import("@mrclrchtr/supi-lsp/api").SessionLspServiceState);
-  const prioritySignals = summarizePrioritySignalsForFiles(
-    model.root,
-    summarizeDirectoryRecursively(resolvedPath).allFiles,
-    lspService,
-  );
-  appendPrioritySignalsSection(lines, prioritySignals);
-
-  // Git context
-  if (opts?.showGitContext !== false) {
-    const gitCtx = gatherGitContext(model.root);
-    if (gitCtx) {
-      lines.push(formatGitContext(gitCtx));
-    }
-  }
-
-  lines.push("");
-
-  return {
-    content: lines.join("\n"),
-    details: {
-      confidence,
-      focusTarget: originalPath,
-      startHere: startHere.slice(0, 3),
-      publicSurfaces: publicSurfaces.slice(0, 5),
-      dependencySummary: isModuleRoot
-        ? { moduleCount: 1, edgeCount: mod.internalDeps.length }
-        : null,
-      omittedCount: 0,
-      nextQueries,
-      prioritySignals,
-    },
-  };
-}
-
-// ── File dispatch ─────────────────────────────────────────────────────
-
-async function generateFileFocused(
-  model: ArchitectureModel,
-  resolvedPath: string,
-  originalPath: string,
-  opts?: BriefOpts,
-): Promise<{ content: string; details: BriefDetails }> {
-  const {
-    content: briefContent,
-    publicSurfaces,
-    nextQueries,
-  } = await generateFileBrief(model, resolvedPath, opts);
-
-  // Priority signals
-  const lspService =
-    opts?.lspService ??
-    ({
-      kind: "unavailable" as const,
-      reason: "No LSP service",
-    } as import("@mrclrchtr/supi-lsp/api").SessionLspServiceState);
-  const prioritySignals = summarizePrioritySignalsForFiles(model.root, [resolvedPath], lspService);
-  const extraLines: string[] = [];
-  if (prioritySignals) {
-    appendPrioritySignalsSection(extraLines, prioritySignals);
-  }
-
-  // Git context
-  if (opts?.showGitContext !== false) {
-    const gitCtx = gatherGitContext(model.root);
-    if (gitCtx) {
-      extraLines.push(formatGitContext(gitCtx));
-    }
-  }
-
-  const extraStr = extraLines.filter((l) => l.trim()).join("\n");
-  const combinedContent = extraStr ? `${briefContent.trim()}\n\n${extraStr}\n` : briefContent;
-
-  return {
-    content: combinedContent,
-    details: {
-      confidence: "structural",
-      focusTarget: originalPath,
-      startHere: [],
-      publicSurfaces,
-      dependencySummary: null,
-      omittedCount: 0,
-      nextQueries,
-      prioritySignals,
-    },
-  };
-}

package/src/analysis/brief/models.ts

@@ -1,75 +0,0 @@
-// Typed DTOs for brief pipeline stages.
-//
-// Each brief mode produces a typed model (sync, manifest + fs), then
-// enrichment adds provider context (async), then renderers consume
-// the enriched model to produce markdown.
-
-// ── Brief models (build stage output) ────────────────────────────────
-
-/** Model for a single-file brief. */
-export interface FileBriefModel {
-  kind: "file";
-  file: string;
-  relPath: string;
-  lineCount: number;
-  isEntrypoint: boolean;
-  moduleName: string | null;
-  moduleRelativePath: string | null;
-}
-
-/** Model for a module (package) brief. */
-export interface ModuleBriefModel {
-  kind: "module";
-  name: string;
-  shortName: string;
-  description: string | null;
-  relativePath: string;
-  entrypoints: string[];
-  sourceFiles: string[];
-  allFiles: string[];
-}
-
-/** Model for a non-module directory brief. */
-export interface DirectoryBriefModel {
-  kind: "directory";
-  path: string;
-  relPath: string;
-  directFiles: string[];
-  subdirs: Array<{ name: string; fileCount: number }>;
-  totalSourceFiles: number;
-}
-
-// ── Enrichment (async provider context) ──────────────────────────────
-
-/** A single file's diagnostic entry. */
-export interface BriefDiagnostic {
-  line: number;
-  severity: number;
-  message: string;
-}
-
-/** Provider-enriched context for a file or module. */
-export interface BriefEnrichment {
-  outline: Array<{ name: string; kind: string; startLine: number; endLine: number }>;
-  imports: Array<{ moduleSpecifier: string }>;
-  exports: Array<{ name: string; kind: string }>;
-  diagnostics: BriefDiagnostic[];
-  /** Per-file aggregated diagnostics for module briefs. */
-  fileDiagnostics?: Array<{ file: string; errors: number; warnings: number }>;
-  /** Entrypoint outlines for module briefs. */
-  entrypointOutlines?: Array<{
-    entrypoint: string;
-    items: Array<{ name: string; kind: string; startLine: number }>;
-  }>;
-}
-
-/** Options for generateFocusedBrief. */
-export interface BriefOpts {
-  provider?: import("../provider.ts").CodeProvider | null;
-  maxResults?: number;
-  cwd: string;
-  /** Show git context in orientation output. Defaults to true. */
-  showGitContext?: boolean;
-  /** LSP service state for diagnostic access. */
-  lspService?: import("@mrclrchtr/supi-lsp/api").SessionLspServiceState;
-}

package/src/analysis/brief/public-brief.ts

@@ -1,179 +0,0 @@
-// Public facade — delegates to the new use-case and presentation layers.
-// Existing callers (api.ts and index.ts) remain compatible.
-
-import type { ConfidenceMode } from "@mrclrchtr/supi-code-runtime/api";
-import type { BriefDetails } from "../../types/details.ts";
-import { renderOverview } from "../../ui/markdown/overview.ts";
-import { buildOverviewData } from "../../ui/markdown/overview-data.ts";
-import type { ArchitectureModel } from "../architecture/model.ts";
-import { getDependents } from "../architecture/model.ts";
-import { formatGitContext, gatherGitContext } from "../signals/git.ts";
-
-// Re-export focused brief generation
-export { generateFocusedBrief } from "./main.ts";
-
-// ── Overview (first-turn injection) ───────────────────────────────────
-
-/**
- * Generate a compact architecture overview for first-turn session injection.
- * Targets roughly 500 tokens or less; prefers dense module-edge format.
- *
- * Delegates to analysis overview data + ui/markdown/overview.
- */
-export function generateOverview(model: ArchitectureModel): string | null {
-  const data = buildOverviewData(model);
-  if (!data) return null;
-  return renderOverview(data);
-}
-
-// ── Full-project brief ────────────────────────────────────────────────
-
-/**
- * Generate a full-project brief from the architecture model.
- */
-export function generateProjectBrief(
-  model: ArchitectureModel,
-  opts?: { showGitContext?: boolean },
-): {
-  content: string;
-  details: BriefDetails;
-} {
-  const lines: string[] = [];
-  const confidence: ConfidenceMode = "structural";
-
-  lines.push("# Project Brief");
-  lines.push("");
-
-  if (model.name) {
-    lines.push(`**${model.name}**${model.description ? ` — ${model.description}` : ""}`);
-    lines.push("");
-  }
-
-  if (opts?.showGitContext !== false) {
-    const gitCtx = gatherGitContext(model.root);
-    if (gitCtx) {
-      lines.push(formatGitContext(gitCtx));
-    }
-  }
-
-  if (model.modules.length === 0) {
-    lines.push(
-      "No structured modules detected. This appears to be a minimal or source-only project.",
-    );
-    return {
-      content: lines.join("\n"),
-      details: {
-        confidence,
-        focusTarget: null,
-        startHere: [],
-        publicSurfaces: [],
-        dependencySummary: null,
-        omittedCount: 0,
-        nextQueries: [],
-      },
-    };
-  }
-
-  const { startHere, publicSurfaces } = addModuleSections(lines, model);
-  addDependencyGraph(lines, model);
-
-  const topStartHere = startHere.sort((a, b) => b.reason.length - a.reason.length).slice(0, 3);
-  addStartHereSection(lines, topStartHere);
-
-  const nextQueries = buildNextQueries(model, publicSurfaces);
-
-  return {
-    content: lines.join("\n"),
-    details: {
-      confidence,
-      focusTarget: null,
-      startHere: topStartHere,
-      publicSurfaces: publicSurfaces.slice(0, 5),
-      dependencySummary: { moduleCount: model.modules.length, edgeCount: model.edges.length },
-      omittedCount: 0,
-      nextQueries,
-    },
-  };
-}
-
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: module section generation with conditional formatting
-function addModuleSections(
-  lines: string[],
-  model: ArchitectureModel,
-): { startHere: Array<{ target: string; reason: string }>; publicSurfaces: string[] } {
-  lines.push("## Modules");
-  lines.push("");
-
-  const startHere: Array<{ target: string; reason: string }> = [];
-  const publicSurfaces: string[] = [];
-
-  for (const mod of model.modules) {
-    const shortName = mod.name.replace(/^@[^/]+\//, "");
-    const deps = mod.internalDeps.map((d) => d.replace(/^@[^/]+\//, "")).join(", ");
-    const dependents = getDependents(model, mod.name);
-    const depCount = dependents.length;
-
-    lines.push(`### ${shortName}`);
-    if (mod.description) lines.push(`${mod.description}`);
-    lines.push(`- Path: \`${mod.relativePath}\``);
-    if (mod.entrypoints.length > 0) {
-      lines.push(`- Entrypoints: ${mod.entrypoints.map((e) => `\`${e}\``).join(", ")}`);
-      publicSurfaces.push(`${shortName}: ${mod.entrypoints[0]}`);
-    }
-    if (deps) lines.push(`- Dependencies: ${deps}`);
-    if (depCount > 0) lines.push(`- Dependents: ${depCount} module${depCount > 1 ? "s" : ""}`);
-    if (mod.isLeaf) lines.push("- _(leaf — no internal dependents)_");
-    lines.push("");
-
-    if (depCount >= 2) {
-      startHere.push({
-        target: `${shortName} (${mod.relativePath})`,
-        reason: `core dependency used by ${depCount} modules`,
-      });
-    }
-  }
-
-  return { startHere, publicSurfaces };
-}
-
-function addDependencyGraph(lines: string[], model: ArchitectureModel): void {
-  if (model.edges.length === 0) return;
-  lines.push("## Dependency Graph");
-  lines.push("");
-  for (const edge of model.edges.slice(0, 15)) {
-    const from = edge.from.replace(/^@[^/]+\//, "");
-    const to = edge.to.replace(/^@[^/]+\//, "");
-    lines.push(`- ${from} → ${to}`);
-  }
-  if (model.edges.length > 15) {
-    lines.push(`- _+${model.edges.length - 15} more edges omitted_`);
-  }
-  lines.push("");
-}
-
-function addStartHereSection(
-  lines: string[],
-  topStartHere: Array<{ target: string; reason: string }>,
-): void {
-  if (topStartHere.length === 0) return;
-  lines.push("## Start Here");
-  lines.push("");
-  for (const item of topStartHere) {
-    lines.push(`- **${item.target}** — ${item.reason}`);
-  }
-  lines.push("");
-}
-
-function buildNextQueries(model: ArchitectureModel, publicSurfaces: string[]): string[] {
-  const nextQueries: string[] = [];
-  if (model.modules.length > 0) {
-    const firstMod = model.modules[0];
-    nextQueries.push(
-      `\`code_orientation\` with \`focus: "${firstMod.relativePath}"\` for a focused module brief`,
-    );
-  }
-  if (publicSurfaces.length > 0) {
-    nextQueries.push("`code_impact` before modifying shared exports");
-  }
-  return nextQueries;
-}