septum 0.1.0 → 0.1.2

package/src/core/database/repository.ts

@@ -1,242 +1,242 @@
-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 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);
-  }
-
-  // --- 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 { 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 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);
+  }
+
+  // --- 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

@@ -0,0 +1,120 @@
+import type { Database } from "bun:sqlite";
+
+export const CURRENT_SCHEMA_VERSION = 2;
+
+export const TABLE_STATEMENTS = [
+  `CREATE TABLE IF NOT EXISTS domains (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE,
+    root_path TEXT NOT NULL,
+    allowed_deps_json TEXT NOT NULL DEFAULT '[]',
+    forbidden_deps_json TEXT NOT NULL DEFAULT '[]',
+    archetypes_json TEXT NOT NULL DEFAULT '{}',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS files (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    domain_id INTEGER NOT NULL,
+    path TEXT NOT NULL UNIQUE,
+    archetype TEXT NOT NULL DEFAULT 'unknown',
+    content_hash TEXT NOT NULL,
+    line_count INTEGER NOT NULL DEFAULT 0,
+    mtime_ms INTEGER NOT NULL DEFAULT 0,
+    size_bytes INTEGER NOT NULL DEFAULT 0,
+    last_scanned_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (domain_id) REFERENCES domains(id) ON DELETE CASCADE
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS symbols (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    kind TEXT NOT NULL,
+    signature TEXT NOT NULL,
+    visibility TEXT NOT NULL DEFAULT 'public',
+    line_start INTEGER NOT NULL DEFAULT 0,
+    line_end INTEGER NOT NULL DEFAULT 0,
+    line_count INTEGER NOT NULL DEFAULT 1,
+    FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS dependencies (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_file_id INTEGER NOT NULL,
+    target_symbol_or_path TEXT NOT NULL,
+    import_statement TEXT NOT NULL,
+    line_number INTEGER NOT NULL DEFAULT 0,
+    is_external BOOLEAN NOT NULL DEFAULT 0,
+    FOREIGN KEY (source_file_id) REFERENCES files(id) ON DELETE CASCADE
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS vertical_slices (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    domain_id INTEGER,
+    feature_key TEXT,
+    http_method TEXT NOT NULL,
+    route_uri TEXT NOT NULL,
+    route_name TEXT,
+    controller_class TEXT NOT NULL,
+    action_name TEXT NOT NULL,
+    controller_file TEXT,
+    controller_line INTEGER DEFAULT 0,
+    architecture_style TEXT NOT NULL DEFAULT 'clean',
+    entry_kind TEXT NOT NULL DEFAULT 'http_route',
+    execution_chain_json TEXT NOT NULL,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (domain_id) REFERENCES domains(id) ON DELETE CASCADE
+  );`,
+
+  `CREATE TABLE IF NOT EXISTS repo_meta (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+  );`,
+];
+
+export const INDEX_STATEMENTS = [
+  "CREATE INDEX IF NOT EXISTS idx_domains_name ON domains(name);",
+  "CREATE INDEX IF NOT EXISTS idx_files_domain_id ON files(domain_id);",
+  "CREATE INDEX IF NOT EXISTS idx_files_path ON files(path);",
+  "CREATE INDEX IF NOT EXISTS idx_symbols_file_id ON symbols(file_id);",
+  "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_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);",
+];
+
+const DROP_ALL_TABLES = `
+  DROP TABLE IF EXISTS repo_meta;
+  DROP TABLE IF EXISTS vertical_slices;
+  DROP TABLE IF EXISTS dependencies;
+  DROP TABLE IF EXISTS symbols;
+  DROP TABLE IF EXISTS files;
+  DROP TABLE IF EXISTS domains;
+`;
+
+export function initializeDatabaseSchema(db: Database): void {
+  const versionRow = db.query<{ user_version: number }, []>("PRAGMA user_version;").get();
+  const userVersion = versionRow?.user_version ?? 0;
+
+  if (userVersion !== 0 && userVersion !== CURRENT_SCHEMA_VERSION) {
+    // Zero-kludge cache invalidation: outdated schema versions are cleanly dropped and recreated
+    db.run(DROP_ALL_TABLES);
+  }
+
+  for (const tableSql of TABLE_STATEMENTS) {
+    db.run(tableSql);
+  }
+
+  for (const indexSql of INDEX_STATEMENTS) {
+    db.run(indexSql);
+  }
+
+  db.run(`PRAGMA user_version = ${CURRENT_SCHEMA_VERSION};`);
+}