@monoes/monograph 1.5.6 → 1.5.8

package/src/mcp/tool-builders.ts

@@ -1,203 +0,0 @@
-// CLI argument builders that convert structured MCP params into argv arrays
-// for all monograph CLI tools.
-
-import type {
-  ExtendedAnalyzeParams, ExtendedHealthParams, AuditParams, ExtendedFindDupesParams,
-  TraceExportParams, TraceFileParams, TraceDependencyParams,
-  TraceCloneParams, ProjectInfoParams, FeatureFlagsParams,
-  ListBoundariesParams, CheckRuntimeCoverageParams,
-} from './params.js';
-
-// Alias for backward-compat internal use
-type AnalyzeParams = ExtendedAnalyzeParams;
-type HealthParams = ExtendedHealthParams;
-type FindDupesParams = ExtendedFindDupesParams;
-
-function flag(key: string, val: unknown): string[] {
-  if (val === undefined || val === null || val === false) return [];
-  if (val === true) return [`--${key}`];
-  if (Array.isArray(val)) return val.flatMap(v => [`--${key}`, String(v)]);
-  return [`--${key}`, String(val)];
-}
-
-export interface CheckChangedParams {
-  root: string;
-  gitRef?: string;
-  filters?: string[];
-  workspace?: string;
-  includeEntryFiles?: boolean;
-}
-
-export interface FixParams {
-  root: string;
-  apply?: boolean;
-  filterUnused?: boolean;
-  filterDeps?: boolean;
-}
-
-export interface ExplainParams {
-  ruleId: string;
-  verbose?: boolean;
-}
-
-export function buildAnalyzeArgs(p: AnalyzeParams): string[] {
-  return [
-    'analyze',
-    p.root,
-    ...flag('entry', p.entryPatterns),
-    ...flag('project', p.tsconfig),
-    ...flag('reporter', p.reporter),
-    ...flag('no-gitignore', p.noGitignore),
-    ...flag('production', p.production),
-    ...flag('include-entry-exports', p.includeEntryExports),
-  ].filter(Boolean);
-}
-
-export function buildHealthArgs(p: HealthParams): string[] {
-  return [
-    'health',
-    p.root,
-    ...flag('complexity-threshold', p.complexityThreshold),
-    ...flag('crap-threshold', p.crapThreshold),
-    ...flag('reporter', p.reporter),
-    ...flag('include-hotspots', p.includeHotspots),
-    ...flag('coverage-file', p.coverageFile),
-  ].filter(Boolean);
-}
-
-export function buildAuditArgs(p: AuditParams): string[] {
-  return ['audit', p.root, ...flag('gate', p.gate), ...flag('reporter', p.reporter)].filter(Boolean);
-}
-
-export function buildFindDupesArgs(p: FindDupesParams): string[] {
-  return [
-    'find-dupes',
-    p.root,
-    ...flag('min-lines', p.minLines),
-    ...flag('min-tokens', p.minTokens),
-    ...flag('reporter', p.reporter),
-  ].filter(Boolean);
-}
-
-export function buildTraceExportArgs(p: TraceExportParams): string[] {
-  return ['trace-export', p.root, p.exportName, p.filePath].filter(Boolean) as string[];
-}
-
-export function buildTraceFileArgs(p: TraceFileParams): string[] {
-  return ['trace-file', p.root, p.filePath].filter(Boolean) as string[];
-}
-
-export function buildTraceDependencyArgs(p: TraceDependencyParams): string[] {
-  return ['trace-dependency', p.root, p.from, p.to].filter(Boolean) as string[];
-}
-
-export function buildTraceCloneArgs(p: TraceCloneParams): string[] {
-  return ['trace-clone', p.root, ...flag('group-id', p.groupId)].filter(Boolean);
-}
-
-export function buildProjectInfoArgs(p: ProjectInfoParams): string[] {
-  return ['project-info', p.root, ...flag('reporter', p.reporter)].filter(Boolean);
-}
-
-export function buildFeatureFlagsArgs(p: FeatureFlagsParams): string[] {
-  return ['feature-flags', p.root, ...flag('reporter', p.reporter)].filter(Boolean);
-}
-
-export function buildListBoundariesArgs(p: ListBoundariesParams): string[] {
-  return ['list-boundaries', p.root, ...flag('reporter', p.reporter)].filter(Boolean);
-}
-
-export function buildCheckRuntimeCoverageArgs(p: CheckRuntimeCoverageParams): string[] {
-  return ['check-runtime-coverage', p.root, ...flag('reporter', p.reporter), ...flag('min-confidence', p.minConfidence)].filter(Boolean);
-}
-
-export function buildCheckChangedArgs(p: CheckChangedParams): string[] {
-  return [
-    'check',
-    p.root,
-    ...flag('changed-since', p.gitRef),
-    ...flag('workspace', p.workspace),
-    ...flag('include-entry-files', p.includeEntryFiles),
-    ...flag('filter', p.filters),
-  ].filter(Boolean);
-}
-
-export function buildFixPreviewArgs(p: FixParams): string[] {
-  return [
-    'fix',
-    p.root,
-    '--dry-run',
-    ...flag('unused', p.filterUnused),
-    ...flag('deps', p.filterDeps),
-  ].filter(Boolean);
-}
-
-export function buildFixApplyArgs(p: FixParams): string[] {
-  return [
-    'fix',
-    p.root,
-    ...flag('unused', p.filterUnused),
-    ...flag('deps', p.filterDeps),
-  ].filter(Boolean);
-}
-
-export function buildExplainArgs(p: ExplainParams): string[] {
-  return ['explain', p.ruleId, ...flag('verbose', p.verbose)].filter(Boolean);
-}
-
-// ── Round 10: runtime-coverage sub-command builders ───────────────────────────
-
-export interface GetHotPathsParams {
-  root: string;
-  minRequestsPerDay?: number;
-  limit?: number;
-}
-
-export interface GetBlastRadiusParams {
-  root: string;
-  filePath: string;
-  limit?: number;
-}
-
-export interface GetImportanceParams {
-  root: string;
-  limit?: number;
-  minScore?: number;
-}
-
-export interface GetCleanupCandidatesParams {
-  root: string;
-  maxCoveragePct?: number;
-  limit?: number;
-}
-
-export function buildGetHotPathsArgs(p: GetHotPathsParams): string[] {
-  return [
-    'get-hot-paths', p.root,
-    ...flag('min-requests-per-day', p.minRequestsPerDay),
-    ...flag('limit', p.limit),
-  ].filter(Boolean);
-}
-
-export function buildGetBlastRadiusArgs(p: GetBlastRadiusParams): string[] {
-  return [
-    'get-blast-radius', p.root, p.filePath,
-    ...flag('limit', p.limit),
-  ].filter(Boolean);
-}
-
-export function buildGetImportanceArgs(p: GetImportanceParams): string[] {
-  return [
-    'get-importance', p.root,
-    ...flag('limit', p.limit),
-    ...flag('min-score', p.minScore),
-  ].filter(Boolean);
-}
-
-export function buildGetCleanupCandidatesArgs(p: GetCleanupCandidatesParams): string[] {
-  return [
-    'get-cleanup-candidates', p.root,
-    ...flag('max-coverage-pct', p.maxCoveragePct),
-    ...flag('limit', p.limit),
-  ].filter(Boolean);
-}

package/src/mcp-resources/communities-resource.ts

@@ -1,72 +0,0 @@
-import type Database from 'better-sqlite3';
-
-export interface CommunityMember {
-  name: string;
-  label: string;
-  filePath: string | null;
-}
-
-export interface CommunityEntry {
-  id: number;
-  label: string | null;
-  memberCount: number;
-  topMembers: CommunityMember[];
-}
-
-export interface CommunitiesResourceData {
-  communities: CommunityEntry[];
-}
-
-/**
- * Returns all community clusters with their member symbols.
- * Pulls community metadata from the communities table and top 5 members
- * (by name, alphabetical) from the nodes table.
- */
-export function getCommunitiesResource(db: Database.Database): CommunitiesResourceData {
-  // Get all communities with their member counts from nodes
-  const communityRows = db
-    .prepare(
-      `SELECT n.community_id, c.label, COUNT(*) AS member_count
-       FROM nodes n
-       LEFT JOIN communities c ON c.id = n.community_id
-       WHERE n.community_id IS NOT NULL
-       GROUP BY n.community_id
-       ORDER BY member_count DESC`,
-    )
-    .all() as Array<{
-    community_id: number;
-    label: string | null;
-    member_count: number;
-  }>;
-
-  const topMembersQuery = db.prepare(
-    `SELECT name, label, file_path
-     FROM nodes
-     WHERE community_id = ?
-     ORDER BY name
-     LIMIT 5`,
-  );
-
-  const communities: CommunityEntry[] = communityRows.map((row) => {
-    const memberRows = topMembersQuery.all(row.community_id) as Array<{
-      name: string;
-      label: string;
-      file_path: string | null;
-    }>;
-
-    const topMembers: CommunityMember[] = memberRows.map((m) => ({
-      name: m.name,
-      label: m.label,
-      filePath: m.file_path,
-    }));
-
-    return {
-      id: row.community_id,
-      label: row.label,
-      memberCount: row.member_count,
-      topMembers,
-    };
-  });
-
-  return { communities };
-}

package/src/mcp-resources/graph-resource.ts

@@ -1,14 +0,0 @@
-import type Database from 'better-sqlite3';
-import { queryGraphData as queryGraph } from '../web/api.js';
-import type { GraphData } from '../web/api.js';
-
-export type { GraphData };
-
-/**
- * Returns the full graph export: up to 2000 nodes, edges between those nodes,
- * and the community membership map. Delegates to queryGraph from web/api.ts
- * to stay consistent with the HTTP API shape.
- */
-export function getGraphResource(db: Database.Database): GraphData {
-  return queryGraph(db);
-}

package/src/mcp-resources/index.ts

@@ -1,9 +0,0 @@
-export * from './processes-resource.js';
-export * from './communities-resource.js';
-export * from './schema-resource.js';
-export * from './graph-resource.js';
-export * from './repos-resource.js';
-export * from './named-cluster-resource.js';
-export * from './named-process-resource.js';
-export * from './repo-context-resource.js';
-export * from './wiki-resource.js';

package/src/mcp-resources/named-cluster-resource.ts

@@ -1,35 +0,0 @@
-import type Database from 'better-sqlite3';
-import type { McpResourceDefinition } from './repos-resource.js';
-
-/**
- * Returns a named community cluster with its member nodes.
- * Looks up the community by label and returns all nodes that belong to it.
- */
-export const namedClusterResource: McpResourceDefinition = {
-  uri: 'monograph://cluster/{name}',
-  name: 'named-cluster',
-  mimeType: 'application/json',
-  handler(db, params) {
-    const name = params?.['name'];
-    if (!name) return null;
-    try {
-      const row = db
-        .prepare('SELECT id, label FROM communities WHERE label = ?')
-        .get(name) as { id: number; label: string } | undefined;
-      if (!row) return null;
-      const members = db
-        .prepare(
-          'SELECT id, name, label, file_path FROM nodes WHERE community_id = ?',
-        )
-        .all(row.id) as Array<{
-        id: string;
-        name: string;
-        label: string;
-        file_path: string | null;
-      }>;
-      return { id: row.id, label: row.label, members };
-    } catch {
-      return null;
-    }
-  },
-};

package/src/mcp-resources/named-process-resource.ts

@@ -1,26 +0,0 @@
-import type Database from 'better-sqlite3';
-import type { McpResourceDefinition } from './repos-resource.js';
-
-/**
- * Returns a single node looked up by name.
- * Useful for resolving a named process/function/class to its location metadata.
- */
-export const namedProcessResource: McpResourceDefinition = {
-  uri: 'monograph://process/{name}',
-  name: 'named-process',
-  mimeType: 'application/json',
-  handler(db, params) {
-    const name = params?.['name'];
-    if (!name) return null;
-    try {
-      const row = db
-        .prepare(
-          'SELECT id, name, label, file_path, start_line, end_line, community_id FROM nodes WHERE name = ? LIMIT 1',
-        )
-        .get(name) as Record<string, unknown> | undefined;
-      return row ?? null;
-    } catch {
-      return null;
-    }
-  },
-};

package/src/mcp-resources/processes-resource.ts

@@ -1,67 +0,0 @@
-import type Database from 'better-sqlite3';
-
-export interface ProcessStep {
-  name: string;
-  label: string;
-  filePath: string | null;
-  startLine: number | null;
-}
-
-export interface ProcessEntry {
-  id: string;
-  name: string;
-  filePath: string | null;
-  stepCount: number;
-  steps: ProcessStep[];
-}
-
-export interface ProcessesResourceData {
-  processes: ProcessEntry[];
-}
-
-/**
- * Returns all Process nodes with their steps (via STEP_IN_PROCESS edges).
- * Process nodes are defined by label='Process' in the monograph schema.
- * Steps are nodes connected via outgoing STEP_IN_PROCESS edges (limit 50 per process).
- */
-export function getProcessesResource(db: Database.Database): ProcessesResourceData {
-  const processRows = db
-    .prepare(
-      `SELECT id, name, file_path FROM nodes WHERE label = 'Process' ORDER BY name`,
-    )
-    .all() as Array<{ id: string; name: string; file_path: string | null }>;
-
-  const stepQuery = db.prepare(
-    `SELECT n.name, n.label, n.file_path, n.start_line
-     FROM edges e
-     JOIN nodes n ON n.id = e.target_id
-     WHERE e.source_id = ? AND e.relation = 'STEP_IN_PROCESS'
-     LIMIT 50`,
-  );
-
-  const processes: ProcessEntry[] = processRows.map((p) => {
-    const stepRows = stepQuery.all(p.id) as Array<{
-      name: string;
-      label: string;
-      file_path: string | null;
-      start_line: number | null;
-    }>;
-
-    const steps: ProcessStep[] = stepRows.map((s) => ({
-      name: s.name,
-      label: s.label,
-      filePath: s.file_path,
-      startLine: s.start_line,
-    }));
-
-    return {
-      id: p.id,
-      name: p.name,
-      filePath: p.file_path,
-      stepCount: steps.length,
-      steps,
-    };
-  });
-
-  return { processes };
-}

package/src/mcp-resources/repo-context-resource.ts

@@ -1,36 +0,0 @@
-import type Database from 'better-sqlite3';
-import type { McpResourceDefinition } from './repos-resource.js';
-
-const AVAILABLE_TOOLS = [
-  'monograph_context', 'monograph_impact', 'monograph_cypher', 'monograph_rename',
-  'monograph_api_impact', 'monograph_route_map', 'monograph_tool_map',
-  'monograph_detect_changes', 'monograph_shape_check', 'monograph_neighbors',
-  'monograph_explain', 'monograph_query_graph',
-];
-
-export const repoContextResource: McpResourceDefinition = {
-  uri: 'monograph://repo/context',
-  name: 'repo-context',
-  mimeType: 'application/json',
-  handler(db) {
-    const nodeCount = (db.prepare('SELECT COUNT(*) as c FROM nodes').get() as { c: number }).c;
-    const edgeCount = (db.prepare('SELECT COUNT(*) as c FROM edges').get() as { c: number }).c;
-    const communityCount = (
-      db.prepare('SELECT COUNT(DISTINCT community_id) as c FROM nodes WHERE community_id IS NOT NULL').get() as { c: number }
-    ).c;
-
-    let indexedAt: string | null = null;
-    try {
-      const row = db.prepare("SELECT value FROM index_meta WHERE key = 'indexed_at'").get() as { value: string } | undefined;
-      indexedAt = row?.value ?? null;
-    } catch { /* ok */ }
-
-    return {
-      nodeCount,
-      edgeCount,
-      communityCount,
-      indexedAt,
-      availableTools: AVAILABLE_TOOLS,
-    };
-  },
-};

package/src/mcp-resources/repos-resource.ts

@@ -1,21 +0,0 @@
-import type Database from 'better-sqlite3';
-
-export interface McpResourceDefinition {
-  uri: string;
-  name: string;
-  mimeType: string;
-  handler(db: Database.Database, params?: Record<string, string>): unknown;
-}
-
-/**
- * Returns the list of indexed repositories.
- * When no repo registry is available, returns an empty array as a safe default.
- */
-export const reposResource: McpResourceDefinition = {
-  uri: 'monograph://repos',
-  name: 'repos',
-  mimeType: 'application/json',
-  handler(_db) {
-    return [];
-  },
-};

package/src/mcp-resources/schema-resource.ts

@@ -1,46 +0,0 @@
-import type Database from 'better-sqlite3';
-
-export interface NodeLabelCount {
-  label: string;
-  count: number;
-}
-
-export interface EdgeRelationCount {
-  relation: string;
-  count: number;
-}
-
-export interface SchemaResourceData {
-  nodeLabels: NodeLabelCount[];
-  edgeRelations: EdgeRelationCount[];
-  totalNodes: number;
-  totalEdges: number;
-}
-
-/**
- * Returns the graph schema: node label distribution, edge relation distribution,
- * and total counts. Useful for understanding what's in the index at a glance.
- */
-export function getSchemaResource(db: Database.Database): SchemaResourceData {
-  const labelRows = db
-    .prepare(
-      `SELECT label, COUNT(*) AS count FROM nodes GROUP BY label ORDER BY count DESC`,
-    )
-    .all() as Array<{ label: string; count: number }>;
-
-  const relationRows = db
-    .prepare(
-      `SELECT relation, COUNT(*) AS count FROM edges GROUP BY relation ORDER BY count DESC`,
-    )
-    .all() as Array<{ relation: string; count: number }>;
-
-  const totalNodes = labelRows.reduce((sum, r) => sum + r.count, 0);
-  const totalEdges = relationRows.reduce((sum, r) => sum + r.count, 0);
-
-  return {
-    nodeLabels: labelRows.map((r) => ({ label: r.label, count: r.count })),
-    edgeRelations: relationRows.map((r) => ({ relation: r.relation, count: r.count })),
-    totalNodes,
-    totalEdges,
-  };
-}

package/src/mcp-resources/wiki-resource.ts

@@ -1,23 +0,0 @@
-import type Database from 'better-sqlite3';
-import { listWikiPages, getWikiPage } from '../wiki/wiki-store.js';
-import type { McpResourceDefinition } from './repos-resource.js';
-
-export const wikiResource: McpResourceDefinition = {
-  uri: 'monograph://wiki',
-  name: 'wiki',
-  mimeType: 'application/json',
-  handler(db) {
-    return listWikiPages(db as any);
-  },
-};
-
-export const wikiPageResource: McpResourceDefinition = {
-  uri: 'monograph://wiki/{communityId}',
-  name: 'wiki-page',
-  mimeType: 'application/json',
-  handler(db, params) {
-    const communityId = params?.['communityId'];
-    if (!communityId) return null;
-    return getWikiPage(db as any, communityId);
-  },
-};