septum 0.1.0 → 0.1.2

package/src/mcp/tools/get-symbol-hotspots.ts

@@ -1,49 +1,49 @@
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { DatabaseRepository } from "../../core/database/repository.ts";
-import type { SymbolKind } from "../../types/index.ts";
-
-export interface GetSymbolHotspotsArgs {
-  min_lines?: number;
-  kind?: SymbolKind;
-  domain?: string;
-  limit?: number;
-}
-
-export function handleGetSymbolHotspots(
-  repo: DatabaseRepository,
-  _config: ValidatedSeptumConfig,
-  args: GetSymbolHotspotsArgs
-) {
-  const minLines = args.min_lines ?? 30;
-  const limit = args.limit ?? 30;
-
-  const hotspots = repo.getHotspotSymbols({
-    minLines,
-    kind: args.kind,
-    domain: args.domain,
-    limit,
-  });
-
-  const payload = {
-    total_found: hotspots.length,
-    threshold_min_lines: minLines,
-    hotspots: hotspots.map((h) => ({
-      name: h.name,
-      kind: h.kind,
-      line_count: h.line_count,
-      line_span: `${h.line_start}-${h.line_end}`,
-      file_path: h.file_path,
-      domain: h.domain_name,
-      signature: h.signature,
-    })),
-  };
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(payload, null, 2),
-      },
-    ],
-  };
-}
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { DatabaseRepository } from "../../core/database/repository.ts";
+import type { SymbolKind } from "../../types/index.ts";
+
+export interface GetSymbolHotspotsArgs {
+  min_lines?: number;
+  kind?: SymbolKind;
+  domain?: string;
+  limit?: number;
+}
+
+export function handleGetSymbolHotspots(
+  repo: DatabaseRepository,
+  _config: ValidatedSeptumConfig,
+  args: GetSymbolHotspotsArgs
+) {
+  const minLines = args.min_lines ?? 30;
+  const limit = args.limit ?? 30;
+
+  const hotspots = repo.getHotspotSymbols({
+    minLines,
+    kind: args.kind,
+    domain: args.domain,
+    limit,
+  });
+
+  const payload = {
+    total_found: hotspots.length,
+    threshold_min_lines: minLines,
+    hotspots: hotspots.map((h) => ({
+      name: h.name,
+      kind: h.kind,
+      line_count: h.line_count,
+      line_span: `${h.line_start}-${h.line_end}`,
+      file_path: h.file_path,
+      domain: h.domain_name,
+      signature: h.signature,
+    })),
+  };
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(payload, null, 2),
+      },
+    ],
+  };
+}

package/src/mcp/tools/get-symbol-impact.ts

@@ -1,26 +1,26 @@
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-import type { GetSymbolImpactArgs } from "../../types/index.ts";
-
-export function handleGetSymbolImpact(
-  repo: SeptumRepository,
-  _config: ValidatedSeptumConfig,
-  args: GetSymbolImpactArgs
-) {
-  if (!args.symbol) {
-    throw new Error(
-      "Missing required argument: 'symbol' (e.g. 'OrderService::cancelOrder', 'OrderService', or 'cancelOrder')"
-    );
-  }
-
-  const impact = repo.getSymbolImpact(args.symbol);
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(impact, null, 2),
-      },
-    ],
-  };
-}
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+import type { GetSymbolImpactArgs } from "../../types/index.ts";
+
+export function handleGetSymbolImpact(
+  repo: SeptumRepository,
+  _config: ValidatedSeptumConfig,
+  args: GetSymbolImpactArgs
+) {
+  if (!args.symbol) {
+    throw new Error(
+      "Missing required argument: 'symbol' (e.g. 'OrderService::cancelOrder', 'OrderService', or 'cancelOrder')"
+    );
+  }
+
+  const impact = repo.getSymbolImpact(args.symbol);
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(impact, null, 2),
+      },
+    ],
+  };
+}

package/src/mcp/tools/get-symbol.ts

@@ -1,63 +1,63 @@
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-import { SymbolLocator } from "../../core/resolver/symbol-locator.ts";
-import type { GetSymbolArgs } from "../../types/index.ts";
-
-export function handleGetSymbol(
-  repo: SeptumRepository,
-  _config: ValidatedSeptumConfig,
-  args: GetSymbolArgs
-) {
-  if (!args.symbol) {
-    throw new Error(
-      "Missing required argument: 'symbol' (e.g. 'OrderController::cancelOrder', 'OrderService', or 'cancelOrder')"
-    );
-  }
-
-  const details = repo.getSymbolDetails(args.symbol, {
-    domain: args.domain,
-    includeDependencies: args.include_dependencies,
-  });
-
-  if (details) {
-    return {
-      content: [
-        {
-          type: "text" as const,
-          text: JSON.stringify(details, null, 2),
-        },
-      ],
-    };
-  }
-
-  // Fallback to fuzzy SymbolLocator to provide actionable hints
-  const locator = new SymbolLocator(repo);
-  const fallback = locator.locate(args.symbol, args.domain);
-
-  const payload = {
-    symbol: args.symbol,
-    found: false,
-    message: `Symbol '${args.symbol}' was not found in the deterministic catalog.`,
-    suggestions: fallback.suggestions.map((s) => ({
-      name: s.name,
-      similarity_score: Math.round(s.similarity_score * 100) / 100,
-      exact_range: {
-        start_line: s.line_start,
-        end_line: s.line_end,
-        total_lines: s.line_end - s.line_start + 1,
-      },
-      signature: s.signature,
-      file_path: s.file_path,
-    })),
-    sibling_methods: fallback.sibling_methods,
-  };
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(payload, null, 2),
-      },
-    ],
-  };
-}
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+import { SymbolLocator } from "../../core/resolver/symbol-locator.ts";
+import type { GetSymbolArgs } from "../../types/index.ts";
+
+export function handleGetSymbol(
+  repo: SeptumRepository,
+  _config: ValidatedSeptumConfig,
+  args: GetSymbolArgs
+) {
+  if (!args.symbol) {
+    throw new Error(
+      "Missing required argument: 'symbol' (e.g. 'OrderController::cancelOrder', 'OrderService', or 'cancelOrder')"
+    );
+  }
+
+  const details = repo.getSymbolDetails(args.symbol, {
+    domain: args.domain,
+    includeDependencies: args.include_dependencies,
+  });
+
+  if (details) {
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(details, null, 2),
+        },
+      ],
+    };
+  }
+
+  // Fallback to fuzzy SymbolLocator to provide actionable hints
+  const locator = new SymbolLocator(repo);
+  const fallback = locator.locate(args.symbol, args.domain);
+
+  const payload = {
+    symbol: args.symbol,
+    found: false,
+    message: `Symbol '${args.symbol}' was not found in the deterministic catalog.`,
+    suggestions: fallback.suggestions.map((s) => ({
+      name: s.name,
+      similarity_score: Math.round(s.similarity_score * 100) / 100,
+      exact_range: {
+        start_line: s.line_start,
+        end_line: s.line_end,
+        total_lines: s.line_end - s.line_start + 1,
+      },
+      signature: s.signature,
+      file_path: s.file_path,
+    })),
+    sibling_methods: fallback.sibling_methods,
+  };
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(payload, null, 2),
+      },
+    ],
+  };
+}

package/src/mcp/tools/locate-symbol.ts

@@ -1,74 +1,74 @@
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-import {
-  SymbolLocator,
-  type SymbolLocationResult,
-} from "../../core/resolver/symbol-locator.ts";
-
-export interface LocateSymbolArgs {
-  query: string;
-  domain?: string;
-}
-
-export function handleLocateSymbol(
-  repo: SeptumRepository,
-  config: ValidatedSeptumConfig,
-  args: LocateSymbolArgs
-) {
-  if (!args.query) {
-    throw new Error(
-      "Missing required argument: 'query' (e.g. 'OrderController::calculateTotal' or error log snippet)"
-    );
-  }
-
-  const locator = new SymbolLocator(repo);
-  const result: SymbolLocationResult = locator.locate(args.query, args.domain);
-
-  let formattedText = "";
-
-  if (result.found) {
-    formattedText = `=== SYMBOL LOCATED ===\n`;
-    formattedText += `Status: FOUND (Exact Match)\n`;
-    formattedText += `File: ${result.file_path}\n`;
-    if (result.exact_symbol) {
-      formattedText += `Symbol: ${result.exact_symbol.name} [${result.exact_symbol.kind.toUpperCase()}]\n`;
-      formattedText += `Signature: ${result.exact_symbol.signature}\n`;
-      formattedText += `Lines: ${result.exact_symbol.line_start} - ${result.exact_symbol.line_end}\n`;
-    }
-    if (result.sibling_methods && result.sibling_methods.length > 0) {
-      formattedText += `\nSibling Methods in ${result.container_name || "Container"} (${result.sibling_methods.length}):\n`;
-      formattedText += `  ${result.sibling_methods.join(", ")}\n`;
-    }
-  } else {
-    formattedText = `=== SYMBOL NOT FOUND / DIAGNOSTIC RESOLUTION ===\n`;
-    formattedText += `Status: NOT FOUND\n`;
-    if (result.file_path) {
-      formattedText += `Target File: ${result.file_path}\n`;
-      formattedText += `Target Container: ${result.container_name || "Unknown"}\n`;
-    }
-    formattedText += `Message: ${result.message}\n`;
-
-    if (result.sibling_methods && result.sibling_methods.length > 0) {
-      formattedText += `\nExisting Methods in ${result.container_name || "Container"} (${result.sibling_methods.length}):\n`;
-      formattedText += `  ${result.sibling_methods.join(", ")}\n`;
-    }
-
-    if (result.suggestions.length > 0) {
-      formattedText += `\nTop Suggestions (Ranked by Similarity):\n`;
-      for (const sug of result.suggestions) {
-        const percent = Math.round(sug.similarity_score * 100);
-        formattedText += `  • ${sug.name} [${percent}% match] -> lines ${sug.line_start}-${sug.line_end} (${sug.signature})\n`;
-      }
-    }
-  }
-
-  return {
-    content: [
-      {
-        type: "text",
-        text: formattedText.trim(),
-      },
-    ],
-    metadata: result,
-  };
-}
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+import {
+  SymbolLocator,
+  type SymbolLocationResult,
+} from "../../core/resolver/symbol-locator.ts";
+
+export interface LocateSymbolArgs {
+  query: string;
+  domain?: string;
+}
+
+export function handleLocateSymbol(
+  repo: SeptumRepository,
+  config: ValidatedSeptumConfig,
+  args: LocateSymbolArgs
+) {
+  if (!args.query) {
+    throw new Error(
+      "Missing required argument: 'query' (e.g. 'OrderController::calculateTotal' or error log snippet)"
+    );
+  }
+
+  const locator = new SymbolLocator(repo);
+  const result: SymbolLocationResult = locator.locate(args.query, args.domain);
+
+  let formattedText = "";
+
+  if (result.found) {
+    formattedText = `=== SYMBOL LOCATED ===\n`;
+    formattedText += `Status: FOUND (Exact Match)\n`;
+    formattedText += `File: ${result.file_path}\n`;
+    if (result.exact_symbol) {
+      formattedText += `Symbol: ${result.exact_symbol.name} [${result.exact_symbol.kind.toUpperCase()}]\n`;
+      formattedText += `Signature: ${result.exact_symbol.signature}\n`;
+      formattedText += `Lines: ${result.exact_symbol.line_start} - ${result.exact_symbol.line_end}\n`;
+    }
+    if (result.sibling_methods && result.sibling_methods.length > 0) {
+      formattedText += `\nSibling Methods in ${result.container_name || "Container"} (${result.sibling_methods.length}):\n`;
+      formattedText += `  ${result.sibling_methods.join(", ")}\n`;
+    }
+  } else {
+    formattedText = `=== SYMBOL NOT FOUND / DIAGNOSTIC RESOLUTION ===\n`;
+    formattedText += `Status: NOT FOUND\n`;
+    if (result.file_path) {
+      formattedText += `Target File: ${result.file_path}\n`;
+      formattedText += `Target Container: ${result.container_name || "Unknown"}\n`;
+    }
+    formattedText += `Message: ${result.message}\n`;
+
+    if (result.sibling_methods && result.sibling_methods.length > 0) {
+      formattedText += `\nExisting Methods in ${result.container_name || "Container"} (${result.sibling_methods.length}):\n`;
+      formattedText += `  ${result.sibling_methods.join(", ")}\n`;
+    }
+
+    if (result.suggestions.length > 0) {
+      formattedText += `\nTop Suggestions (Ranked by Similarity):\n`;
+      for (const sug of result.suggestions) {
+        const percent = Math.round(sug.similarity_score * 100);
+        formattedText += `  • ${sug.name} [${percent}% match] -> lines ${sug.line_start}-${sug.line_end} (${sug.signature})\n`;
+      }
+    }
+  }
+
+  return {
+    content: [
+      {
+        type: "text",
+        text: formattedText.trim(),
+      },
+    ],
+    metadata: result,
+  };
+}

package/src/mcp/tools/register-domain.ts

@@ -1,64 +1,64 @@
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-import { IngestionPipeline, type IngestionMetrics } from "../../core/ingestion/pipeline.ts";
-import type { DomainConfig } from "../../types/index.ts";
-
-export interface RegisterDomainArgs {
-  name: string;
-  root: string;
-  description?: string;
-  allowed_dependencies?: string[];
-  forbidden_dependencies?: string[];
-  archetypes?: Record<string, string>;
-  ingest_now?: boolean;
-}
-
-export async function handleRegisterDomain(
-  repo: SeptumRepository,
-  config: ValidatedSeptumConfig,
-  args: RegisterDomainArgs
-) {
-  if (!args.name || !args.root) {
-    throw new Error("Missing required arguments: 'name' and 'root' are required.");
-  }
-
-  const domainConfig: DomainConfig = {
-    root: args.root,
-    description: args.description || `Domain: ${args.name}`,
-    allowed_dependencies: args.allowed_dependencies || [],
-    forbidden_dependencies: args.forbidden_dependencies || [],
-    archetypes: args.archetypes || {},
-  };
-
-  const domainId = repo.domains.upsertDomain(args.name, domainConfig);
-
-  config.domains[args.name] = domainConfig;
-
-  let ingestionMetrics: IngestionMetrics | null = null;
-  if (args.ingest_now) {
-    const pipeline = new IngestionPipeline(repo);
-    ingestionMetrics = await pipeline.run(config);
-  }
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(
-          {
-            status: "success",
-            message: `Domain '${args.name}' successfully registered in SQLite SSOT.${
-              args.ingest_now ? " Initial ingestion completed." : ""
-            }`,
-            domain_id: domainId,
-            domain: args.name,
-            config: domainConfig,
-            ...(ingestionMetrics ? { ingestion_metrics: ingestionMetrics } : {}),
-          },
-          null,
-          2
-        ),
-      },
-    ],
-  };
-}
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+import { IngestionPipeline, type IngestionMetrics } from "../../core/ingestion/pipeline.ts";
+import type { DomainConfig } from "../../types/index.ts";
+
+export interface RegisterDomainArgs {
+  name: string;
+  root: string;
+  description?: string;
+  allowed_dependencies?: string[];
+  forbidden_dependencies?: string[];
+  archetypes?: Record<string, string>;
+  ingest_now?: boolean;
+}
+
+export async function handleRegisterDomain(
+  repo: SeptumRepository,
+  config: ValidatedSeptumConfig,
+  args: RegisterDomainArgs
+) {
+  if (!args.name || !args.root) {
+    throw new Error("Missing required arguments: 'name' and 'root' are required.");
+  }
+
+  const domainConfig: DomainConfig = {
+    root: args.root,
+    description: args.description || `Domain: ${args.name}`,
+    allowed_dependencies: args.allowed_dependencies || [],
+    forbidden_dependencies: args.forbidden_dependencies || [],
+    archetypes: args.archetypes || {},
+  };
+
+  const domainId = repo.domains.upsertDomain(args.name, domainConfig);
+
+  config.domains[args.name] = domainConfig;
+
+  let ingestionMetrics: IngestionMetrics | null = null;
+  if (args.ingest_now) {
+    const pipeline = new IngestionPipeline(repo);
+    ingestionMetrics = await pipeline.run(config);
+  }
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(
+          {
+            status: "success",
+            message: `Domain '${args.name}' successfully registered in SQLite SSOT.${
+              args.ingest_now ? " Initial ingestion completed." : ""
+            }`,
+            domain_id: domainId,
+            domain: args.name,
+            config: domainConfig,
+            ...(ingestionMetrics ? { ingestion_metrics: ingestionMetrics } : {}),
+          },
+          null,
+          2
+        ),
+      },
+    ],
+  };
+}