septum 0.1.3 → 0.1.5

package/src/core/database/repository.ts

@@ -1,255 +1,264 @@
-import type { Database } from "bun:sqlite";
-import type {
-  ArchetypeKind,
-  DomainCatalogResponse,
-  DomainConfig,
-  DomainRecord,
-  ExtractedDependency,
-  ExtractedSymbol,
-  FileRecord,
-  GetSymbolDetailsResponse,
-  GetSymbolImpactResponse,
-  InboundCaller,
-  SymbolKind,
-  SymbolRecord,
-  VerticalSliceRecord,
-} from "../../types/index.ts";
-
-export type {
-  ArchetypeKind,
-  DomainCatalogResponse,
-  DomainConfig,
-  DomainRecord,
-  ExtractedDependency,
-  ExtractedSymbol,
-  FileRecord,
-  GetSymbolDetailsResponse,
-  GetSymbolImpactResponse,
-  InboundCaller,
-  SymbolKind,
-  SymbolRecord,
-  VerticalSliceRecord,
-} from "../../types/index.ts";
-import { DependencyRepository } from "./repositories/dependency.repository.ts";
-import { DomainRepository } from "./repositories/domain.repository.ts";
-import { FileRepository } from "./repositories/file.repository.ts";
-import { MetaRepository } from "./repositories/meta.repository.ts";
-import { SymbolRepository } from "./repositories/symbol.repository.ts";
-
-export type DatabaseRepository = SeptumRepository;
-
-export class SeptumRepository {
-  public readonly domains: DomainRepository;
-  public readonly files: FileRepository;
-  public readonly symbols: SymbolRepository;
-  public readonly dependencies: DependencyRepository;
-  public readonly meta: MetaRepository;
-
-  constructor(private db: Database) {
-    this.domains = new DomainRepository(db);
-    this.files = new FileRepository(db);
-    this.symbols = new SymbolRepository(db);
-    this.dependencies = new DependencyRepository(db);
-    this.meta = new MetaRepository(db);
-  }
-
-  public runInTransaction<T>(fn: () => T): T {
-    return this.db.transaction(fn)();
-  }
-
-  // --- Domain Methods ---
-  public upsertDomain(name: string, config: DomainConfig): number {
-    return this.domains.upsertDomain(name, config);
-  }
-
-  public getDomainByName(name: string): DomainRecord | null {
-    return this.domains.getDomainByName(name);
-  }
-
-  public getAllDomains(): DomainRecord[] {
-    return this.domains.getAllDomains();
-  }
-
-  // --- File Methods ---
-  public getFileByPath(path: string): FileRecord | null {
-    return this.files.getFileByPath(path);
-  }
-
-  public countFiles(): number {
-    return this.files.countFiles();
-  }
-
-  public getFilesByDomain(domainId: number): FileRecord[] {
-    return this.files.getFilesByDomain(domainId);
-  }
-
-  public upsertFile(
-    domainId: number,
-    path: string,
-    archetype: ArchetypeKind,
-    contentHash: string,
-    lineCount: number,
-    mtimeMs: number = 0,
-    sizeBytes: number = 0
-  ): number {
-    return this.files.upsertFile(
-      domainId,
-      path,
-      archetype,
-      contentHash,
-      lineCount,
-      mtimeMs,
-      sizeBytes
-    );
-  }
-
-  public updateFileMetadataOnly(id: number, mtimeMs: number, sizeBytes: number): void {
-    this.files.updateFileMetadataOnly(id, mtimeMs, sizeBytes);
-  }
-
-  public deleteFilesNotInPaths(domainId: number, validPaths: string[]): number {
-    return this.files.deleteFilesNotInPaths(domainId, validPaths);
-  }
-
-  public deleteFile(path: string): void {
-    this.files.deleteFile(path);
-  }
-
-  public getDomainCatalog(
-    domainName: string,
-    archetypeFilter?: string
-  ): DomainCatalogResponse | null {
-    return this.domains.getDomainCatalog(domainName, archetypeFilter);
-  }
-
-  // --- Symbol Methods ---
-  public replaceFileSymbols(fileId: number, symbols: ExtractedSymbol[]): void {
-    this.symbols.replaceFileSymbols(fileId, symbols);
-  }
-
-  public getSymbolsByFileId(fileId: number): SymbolRecord[] {
-    return this.symbols.getSymbolsByFileId(fileId);
-  }
-
-  public findSymbolsByName(name: string): Array<SymbolRecord & { file_path: string }> {
-    return this.symbols.findSymbolsByName(name);
-  }
-
-  public findContainers(
-    containerName: string
-  ): Array<{ file: FileRecord; symbol?: SymbolRecord }> {
-    return this.symbols.findContainers(containerName);
-  }
-
-  public getAllSymbolsWithFiles(): Array<SymbolRecord & { file_path: string }> {
-    return this.symbols.getAllSymbolsWithFiles();
-  }
-
-  // --- Dependency & Slice Methods ---
-  public replaceFileDependencies(fileId: number, deps: ExtractedDependency[]): void {
-    this.dependencies.replaceFileDependencies(fileId, deps);
-  }
-
-  public upsertVerticalSlice(
-    slice: Omit<VerticalSliceRecord, "id" | "created_at">
-  ): void {
-    this.dependencies.upsertVerticalSlice(slice);
-  }
-
-  public findVerticalSlices(searchTerm: string): VerticalSliceRecord[] {
-    return this.dependencies.findVerticalSlices(searchTerm);
-  }
-
-  public getAllVerticalSlices(): VerticalSliceRecord[] {
-    return this.dependencies.getAllVerticalSlices();
-  }
-
-  public clearVerticalSlices(domainId?: number): void {
-    this.dependencies.clearVerticalSlices(domainId);
-  }
-
-  public getAllDependenciesWithDomains(): Array<{
-    source_file: string;
-    source_domain: string;
-    line_number: number;
-    target: string;
-    statement: string;
-    is_external: boolean;
-  }> {
-    return this.dependencies.getAllDependenciesWithDomains();
-  }
-
-  public findSymbolWithDomain(
-    symbolName: string
-  ): {
-    symbol_name: string;
-    kind: string;
-    file_path: string;
-    domain_name: string;
-  } | null {
-    return this.symbols.findSymbolWithDomain(symbolName);
-  }
-
-  public findSymbolWithMembers(symbolName: string): {
-    symbol_name: string;
-    kind: string;
-    signature: string;
-    file_path: string;
-    domain_name: string;
-    methods: string[];
-    properties: string[];
-  } | null {
-    return this.symbols.findSymbolWithMembers(symbolName);
-  }
-
-  public getFileWithDomain(filePath: string): {
-    file_id: number;
-    file_path: string;
-    domain_name: string;
-  } | null {
-    return this.symbols.getFileWithDomain(filePath);
-  }
-
-  public getHotspotSymbols(options: {
-    minLines?: number;
-    kind?: SymbolKind;
-    domain?: string;
-    limit?: number;
-  } = {}): Array<SymbolRecord & { file_path: string; domain_name: string }> {
-    return this.symbols.getHotspotSymbols(options);
-  }
-
-  public getSymbolDetails(
-    symbolQuery: string,
-    options: { domain?: string; includeDependencies?: boolean } = {}
-  ): GetSymbolDetailsResponse | null {
-    return this.symbols.getSymbolDetails(symbolQuery, options);
-  }
-
-  public getSymbolImpact(symbolName: string): GetSymbolImpactResponse {
-    return this.dependencies.getSymbolImpact(symbolName);
-  }
-
-  public getFileInboundImpact(filePath: string): {
-    direct_dependents_count: number;
-    top_consumers: string[];
-    symbols_count: number;
-    risk_level: "low" | "medium" | "high";
-  } {
-    return this.dependencies.getFileInboundImpact(filePath);
-  }
-
-  // --- Metadata Methods ---
-  public getMeta(key: string): string | null {
-    return this.meta.getMeta(key);
-  }
-
-  public setMeta(key: string, value: string): void {
-    this.meta.setMeta(key, value);
-  }
-
-  public getAllMeta(): Record<string, string> {
-    return this.meta.getAllMeta();
-  }
-}
-
+import type { Database } from "bun:sqlite";
+import type {
+  ArchetypeKind,
+  DomainCatalogResponse,
+  DomainConfig,
+  DomainRecord,
+  ExtractedDependency,
+  ExtractedSymbol,
+  FileRecord,
+  GetSymbolDetailsResponse,
+  GetSymbolImpactResponse,
+  InboundCaller,
+  SymbolKind,
+  SymbolRecord,
+  VerticalSliceRecord,
+} from "../../types/index.ts";
+
+export type {
+  ArchetypeKind,
+  DomainCatalogResponse,
+  DomainConfig,
+  DomainRecord,
+  ExtractedDependency,
+  ExtractedSymbol,
+  FileRecord,
+  GetSymbolDetailsResponse,
+  GetSymbolImpactResponse,
+  InboundCaller,
+  SymbolKind,
+  SymbolRecord,
+  VerticalSliceRecord,
+} from "../../types/index.ts";
+import { DependencyRepository } from "./repositories/dependency.repository.ts";
+import { DomainRepository } from "./repositories/domain.repository.ts";
+import { EnvironmentRepository } from "./repositories/environment.repository.ts";
+import { FileRepository } from "./repositories/file.repository.ts";
+import { MetaRepository } from "./repositories/meta.repository.ts";
+import { SymbolRepository } from "./repositories/symbol.repository.ts";
+
+export type DatabaseRepository = SeptumRepository;
+
+export class SeptumRepository {
+  public readonly domains: DomainRepository;
+  public readonly files: FileRepository;
+  public readonly symbols: SymbolRepository;
+  public readonly dependencies: DependencyRepository;
+  public readonly meta: MetaRepository;
+  public readonly environment: EnvironmentRepository;
+
+  constructor(private db: Database) {
+    this.domains = new DomainRepository(db);
+    this.files = new FileRepository(db);
+    this.symbols = new SymbolRepository(db);
+    this.dependencies = new DependencyRepository(db);
+    this.meta = new MetaRepository(db);
+    this.environment = new EnvironmentRepository(db);
+  }
+
+  public runInTransaction<T>(fn: () => T): T {
+    return this.db.transaction(fn)();
+  }
+
+  // --- Domain Methods ---
+  public upsertDomain(name: string, config: DomainConfig): number {
+    return this.domains.upsertDomain(name, config);
+  }
+
+  public getDomainByName(name: string): DomainRecord | null {
+    return this.domains.getDomainByName(name);
+  }
+
+  public getAllDomains(): DomainRecord[] {
+    return this.domains.getAllDomains();
+  }
+
+  // --- File Methods ---
+  public getFileByPath(path: string): FileRecord | null {
+    return this.files.getFileByPath(path);
+  }
+
+  public countFiles(): number {
+    return this.files.countFiles();
+  }
+
+  public getFilesByDomain(domainId: number): FileRecord[] {
+    return this.files.getFilesByDomain(domainId);
+  }
+
+  public getAllFiles(): FileRecord[] {
+    return this.files.getAllFiles();
+  }
+
+  public upsertFile(
+    domainId: number,
+    path: string,
+    archetype: ArchetypeKind,
+    contentHash: string,
+    lineCount: number,
+    mtimeMs: number = 0,
+    sizeBytes: number = 0
+  ): number {
+    return this.files.upsertFile(
+      domainId,
+      path,
+      archetype,
+      contentHash,
+      lineCount,
+      mtimeMs,
+      sizeBytes
+    );
+  }
+
+  public updateFileMetadataOnly(id: number, mtimeMs: number, sizeBytes: number): void {
+    this.files.updateFileMetadataOnly(id, mtimeMs, sizeBytes);
+  }
+
+  public deleteFilesNotInPaths(domainId: number, validPaths: string[]): number {
+    return this.files.deleteFilesNotInPaths(domainId, validPaths);
+  }
+
+  public deleteFile(path: string): void {
+    this.files.deleteFile(path);
+  }
+
+  public getDomainCatalog(
+    domainName: string,
+    archetypeFilter?: string
+  ): DomainCatalogResponse | null {
+    return this.domains.getDomainCatalog(domainName, archetypeFilter);
+  }
+
+  // --- Symbol Methods ---
+  public replaceFileSymbols(fileId: number, symbols: ExtractedSymbol[]): void {
+    this.symbols.replaceFileSymbols(fileId, symbols);
+  }
+
+  public getSymbolsByFileId(fileId: number): SymbolRecord[] {
+    return this.symbols.getSymbolsByFileId(fileId);
+  }
+
+  public findSymbolsByName(name: string): Array<SymbolRecord & { file_path: string }> {
+    return this.symbols.findSymbolsByName(name);
+  }
+
+  public findContainers(
+    containerName: string
+  ): Array<{ file: FileRecord; symbol?: SymbolRecord }> {
+    return this.symbols.findContainers(containerName);
+  }
+
+  public getAllSymbolsWithFiles(): Array<SymbolRecord & { file_path: string }> {
+    return this.symbols.getAllSymbolsWithFiles();
+  }
+
+  // --- Dependency & Slice Methods ---
+  public replaceFileDependencies(fileId: number, deps: ExtractedDependency[]): void {
+    this.dependencies.replaceFileDependencies(fileId, deps);
+  }
+
+  public upsertVerticalSlice(
+    slice: Omit<VerticalSliceRecord, "id" | "created_at">
+  ): void {
+    this.dependencies.upsertVerticalSlice(slice);
+  }
+
+  public findVerticalSlices(searchTerm: string): VerticalSliceRecord[] {
+    return this.dependencies.findVerticalSlices(searchTerm);
+  }
+
+  public getAllVerticalSlices(): VerticalSliceRecord[] {
+    return this.dependencies.getAllVerticalSlices();
+  }
+
+  public clearVerticalSlices(domainId?: number): void {
+    this.dependencies.clearVerticalSlices(domainId);
+  }
+
+  public getAllDependenciesWithDomains(): Array<{
+    source_file: string;
+    source_domain: string;
+    line_number: number;
+    target: string;
+    statement: string;
+    is_external: boolean;
+  }> {
+    return this.dependencies.getAllDependenciesWithDomains();
+  }
+
+  public findSymbolWithDomain(
+    symbolName: string
+  ): {
+    symbol_name: string;
+    kind: string;
+    file_path: string;
+    domain_name: string;
+  } | null {
+    return this.symbols.findSymbolWithDomain(symbolName);
+  }
+
+  public findSymbolWithMembers(symbolName: string): {
+    symbol_name: string;
+    kind: string;
+    signature: string;
+    file_path: string;
+    domain_name: string;
+    methods: string[];
+    properties: string[];
+  } | null {
+    return this.symbols.findSymbolWithMembers(symbolName);
+  }
+
+  public getFileWithDomain(filePath: string): {
+    file_id: number;
+    file_path: string;
+    domain_name: string;
+  } | null {
+    return this.symbols.getFileWithDomain(filePath);
+  }
+
+  public getHotspotSymbols(options: {
+    minLines?: number;
+    minNesting?: number;
+    kind?: SymbolKind;
+    domain?: string;
+    limit?: number;
+    sortBy?: "lines" | "nesting" | "risk_score";
+  } = {}): Array<SymbolRecord & { file_path: string; domain_name: string; risk_score: number }> {
+    return this.symbols.getHotspotSymbols(options);
+  }
+
+  public getSymbolDetails(
+    symbolQuery: string,
+    options: { domain?: string; includeDependencies?: boolean } = {}
+  ): GetSymbolDetailsResponse | null {
+    return this.symbols.getSymbolDetails(symbolQuery, options);
+  }
+
+  public getSymbolImpact(symbolName: string): GetSymbolImpactResponse {
+    return this.dependencies.getSymbolImpact(symbolName);
+  }
+
+  public getFileInboundImpact(filePath: string): {
+    direct_dependents_count: number;
+    top_consumers: string[];
+    symbols_count: number;
+    risk_level: "low" | "medium" | "high";
+  } {
+    return this.dependencies.getFileInboundImpact(filePath);
+  }
+
+  // --- Metadata Methods ---
+  public getMeta(key: string): string | null {
+    return this.meta.getMeta(key);
+  }
+
+  public setMeta(key: string, value: string): void {
+    this.meta.setMeta(key, value);
+  }
+
+  public getAllMeta(): Record<string, string> {
+    return this.meta.getAllMeta();
+  }
+}
+

package/src/core/database/schema.ts

@@ -1,6 +1,6 @@
 import type { Database } from "bun:sqlite";
 
-export const CURRENT_SCHEMA_VERSION = 2;
+export const CURRENT_SCHEMA_VERSION = 4;
 
 export const TABLE_STATEMENTS = [
   `CREATE TABLE IF NOT EXISTS domains (
@@ -37,6 +37,7 @@ export const TABLE_STATEMENTS = [
     line_start INTEGER NOT NULL DEFAULT 0,
     line_end INTEGER NOT NULL DEFAULT 0,
     line_count INTEGER NOT NULL DEFAULT 1,
+    nesting_depth INTEGER NOT NULL DEFAULT 1,
     FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
   );`,
 
@@ -73,6 +74,32 @@ export const TABLE_STATEMENTS = [
     value TEXT NOT NULL,
     updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
   );`,
+
+  `CREATE TABLE IF NOT EXISTS environment_topology (
+    layer TEXT PRIMARY KEY,
+    platform TEXT,
+    status TEXT NOT NULL,
+    detected_from_json TEXT NOT NULL DEFAULT '[]',
+    constraints_json TEXT NOT NULL DEFAULT '[]',
+    unresolved_inquiry TEXT,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS environment_nodes (
+    id TEXT PRIMARY KEY,
+    layer TEXT NOT NULL,
+    name TEXT NOT NULL,
+    platform TEXT NOT NULL,
+    canonical_tag TEXT NOT NULL DEFAULT 'unspecified',
+    domain_or_ip TEXT,
+    role TEXT,
+    status TEXT NOT NULL,
+    detected_from_json TEXT NOT NULL DEFAULT '[]',
+    constraints_json TEXT NOT NULL DEFAULT '[]',
+    connected_to_json TEXT NOT NULL DEFAULT '[]',
+    unresolved_inquiry TEXT,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+  );`,
 ];
 
 export const INDEX_STATEMENTS = [
@@ -83,14 +110,20 @@ export const INDEX_STATEMENTS = [
   "CREATE INDEX IF NOT EXISTS idx_symbols_name ON symbols(name);",
   "CREATE INDEX IF NOT EXISTS idx_symbols_kind ON symbols(kind);",
   "CREATE INDEX IF NOT EXISTS idx_symbols_line_count ON symbols(kind, line_count DESC);",
+  "CREATE INDEX IF NOT EXISTS idx_symbols_nesting_depth ON symbols(nesting_depth DESC);",
   "CREATE INDEX IF NOT EXISTS idx_dependencies_source ON dependencies(source_file_id);",
   "CREATE INDEX IF NOT EXISTS idx_dependencies_target ON dependencies(target_symbol_or_path);",
   "CREATE INDEX IF NOT EXISTS idx_slices_route_uri ON vertical_slices(route_uri);",
   "CREATE INDEX IF NOT EXISTS idx_slices_route_name ON vertical_slices(route_name);",
   "CREATE INDEX IF NOT EXISTS idx_slices_controller ON vertical_slices(controller_class, action_name);",
+  "CREATE INDEX IF NOT EXISTS idx_env_topology_status ON environment_topology(status);",
+  "CREATE INDEX IF NOT EXISTS idx_env_nodes_layer ON environment_nodes(layer);",
+  "CREATE INDEX IF NOT EXISTS idx_env_nodes_status ON environment_nodes(status);",
 ];
 
 const DROP_ALL_TABLES = `
+  DROP TABLE IF EXISTS environment_nodes;
+  DROP TABLE IF EXISTS environment_topology;
   DROP TABLE IF EXISTS repo_meta;
   DROP TABLE IF EXISTS vertical_slices;
   DROP TABLE IF EXISTS dependencies;