@zbigniewsobiecki/squint 1.0.0

package/dist/db/schema.d.ts

@@ -0,0 +1,404 @@
+import type { Definition } from '../parser/definition-extractor.js';
+import type { FileReference, ImportedSymbol, SymbolUsage } from '../parser/reference-extractor.js';
+export interface FileInsert {
+    path: string;
+    language: string;
+    contentHash: string;
+    sizeBytes: number;
+    modifiedAt: string;
+}
+export interface CallsiteResult {
+    usageId: number;
+    symbolId: number;
+    definitionId: number | null;
+    filePath: string;
+    line: number;
+    column: number;
+    symbolName: string;
+    localName: string;
+    argumentCount: number;
+    isMethodCall: boolean;
+    isConstructorCall: boolean;
+    receiverName: string | null;
+}
+export interface DependencyInfo {
+    dependencyId: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+}
+export interface ReadySymbolInfo {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    endLine: number;
+    dependencyCount: number;
+}
+export interface DependencyWithMetadata {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    hasAspect: boolean;
+    aspectValue: string | null;
+}
+export interface IncomingDependency {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+}
+export type RelationshipType = 'uses' | 'extends' | 'implements';
+export interface RelationshipAnnotation {
+    id: number;
+    fromDefinitionId: number;
+    toDefinitionId: number;
+    relationshipType: RelationshipType;
+    semantic: string;
+    createdAt: string;
+}
+export interface RelationshipWithDetails {
+    id: number;
+    fromDefinitionId: number;
+    fromName: string;
+    fromKind: string;
+    fromFilePath: string;
+    fromLine: number;
+    toDefinitionId: number;
+    toName: string;
+    toKind: string;
+    toFilePath: string;
+    toLine: number;
+    relationshipType: RelationshipType;
+    semantic: string;
+}
+export interface Domain {
+    id: number;
+    name: string;
+    description: string | null;
+    createdAt: string;
+}
+export interface DomainWithCount extends Domain {
+    symbolCount: number;
+}
+export interface Module {
+    id: number;
+    parentId: number | null;
+    slug: string;
+    fullPath: string;
+    name: string;
+    description: string | null;
+    depth: number;
+    colorIndex: number;
+    isTest: boolean;
+    createdAt: string;
+}
+export interface ModuleMember {
+    moduleId: number;
+    definitionId: number;
+    assignedAt: string;
+}
+export interface ModuleTreeNode extends Module {
+    children: ModuleTreeNode[];
+}
+export interface ModuleWithMembers extends Module {
+    members: Array<{
+        definitionId: number;
+        name: string;
+        kind: string;
+        filePath: string;
+        line: number;
+        isExported: boolean;
+    }>;
+}
+export interface CallGraphEdge {
+    fromId: number;
+    toId: number;
+    weight: number;
+    minUsageLine: number;
+}
+/**
+ * Interaction source type: how the interaction was detected.
+ */
+export type InteractionSource = 'ast' | 'ast-import' | 'llm-inferred';
+/**
+ * Interaction: Point-to-point module connection.
+ *
+ * Represents a uni- or bi-directional relationship between two modules,
+ * with details about which symbols are called and the pattern of usage.
+ */
+export interface Interaction {
+    id: number;
+    fromModuleId: number;
+    toModuleId: number;
+    direction: 'uni' | 'bi';
+    weight: number;
+    pattern: 'utility' | 'business' | 'test-internal' | null;
+    symbols: string | null;
+    semantic: string | null;
+    source: InteractionSource;
+    confidence: 'high' | 'medium' | null;
+    createdAt: string;
+}
+/**
+ * Enriched interaction with module path information for display
+ */
+export interface InteractionWithPaths extends Interaction {
+    fromModulePath: string;
+    toModulePath: string;
+}
+/**
+ * Symbol detail within a module call edge
+ */
+export interface CalledSymbolInfo {
+    name: string;
+    kind: string;
+    callCount: number;
+}
+/**
+ * Module call graph edge for interaction detection
+ */
+export interface ModuleCallEdge {
+    fromModuleId: number;
+    toModuleId: number;
+    weight: number;
+    fromModulePath: string;
+    toModulePath: string;
+}
+/**
+ * Enriched module call edge with symbol-level details for better interaction detection
+ */
+export interface EnrichedModuleCallEdge extends ModuleCallEdge {
+    calledSymbols: CalledSymbolInfo[];
+    avgCallsPerSymbol: number;
+    distinctCallers: number;
+    isHighFrequency: boolean;
+    edgePattern: 'utility' | 'business' | 'test-internal';
+    minUsageLine: number;
+}
+/**
+ * Stakeholder types for flows
+ */
+export type FlowStakeholder = 'user' | 'admin' | 'system' | 'developer' | 'external';
+/**
+ * Flow: A user journey - sequence of interactions triggered by an entry point.
+ *
+ * Represents a complete path from trigger to outcome, documenting how
+ * a feature works end-to-end.
+ */
+export interface Flow {
+    id: number;
+    name: string;
+    slug: string;
+    entryPointModuleId: number | null;
+    entryPointId: number | null;
+    entryPath: string | null;
+    stakeholder: FlowStakeholder | null;
+    description: string | null;
+    actionType: string | null;
+    targetEntity: string | null;
+    tier: number;
+    createdAt: string;
+}
+/**
+ * Subflow step: references a child flow within a composite flow
+ */
+export interface FlowSubflowStep {
+    flowId: number;
+    stepOrder: number;
+    subflowId: number;
+}
+/**
+ * Flow step: An ordered interaction within a flow (module-level)
+ */
+export interface FlowStep {
+    flowId: number;
+    stepOrder: number;
+    interactionId: number;
+}
+/**
+ * Flow definition step: An ordered definition-level call edge within a flow
+ */
+export interface FlowDefinitionStep {
+    flowId: number;
+    stepOrder: number;
+    fromDefinitionId: number;
+    toDefinitionId: number;
+}
+/**
+ * Flow definition step with full details for display
+ */
+export interface FlowDefinitionStepWithDetails extends FlowDefinitionStep {
+    fromDefinitionName: string;
+    fromDefinitionKind: string;
+    fromFilePath: string;
+    fromLine: number;
+    fromModuleId: number | null;
+    fromModulePath: string | null;
+    toDefinitionName: string;
+    toDefinitionKind: string;
+    toFilePath: string;
+    toLine: number;
+    toModuleId: number | null;
+    toModulePath: string | null;
+    semantic: string | null;
+}
+/**
+ * Flow with its steps and interaction details for display (module-level)
+ */
+export interface FlowWithSteps extends Flow {
+    steps: Array<FlowStep & {
+        interaction: InteractionWithPaths;
+    }>;
+}
+/**
+ * Flow with its definition-level steps for display
+ */
+export interface FlowWithDefinitionSteps extends Flow {
+    definitionSteps: FlowDefinitionStepWithDetails[];
+}
+/**
+ * Expanded flow showing flattened interactions in order
+ */
+export interface ExpandedFlow {
+    flow: Flow;
+    interactions: InteractionWithPaths[];
+}
+/**
+ * Flow coverage statistics
+ */
+export interface FlowCoverageStats {
+    totalInteractions: number;
+    coveredByFlows: number;
+    percentage: number;
+}
+/**
+ * Relationship to interaction coverage statistics
+ */
+export interface RelationshipInteractionCoverage {
+    totalRelationships: number;
+    crossModuleRelationships: number;
+    relationshipsContributingToInteractions: number;
+    sameModuleCount: number;
+    orphanedCount: number;
+    coveragePercent: number;
+}
+/**
+ * Detailed breakdown of relationship coverage for diagnostics
+ */
+export interface RelationshipCoverageBreakdown {
+    covered: number;
+    sameModule: number;
+    noCallEdge: number;
+    orphaned: number;
+    byType: {
+        uses: number;
+        extends: number;
+        implements: number;
+    };
+}
+export interface Feature {
+    id: number;
+    name: string;
+    slug: string;
+    description: string | null;
+    createdAt: string;
+}
+export interface FeatureWithFlows extends Feature {
+    flows: Flow[];
+}
+/**
+ * @deprecated Use Interaction instead
+ * Module call graph edge - kept for backward compatibility
+ */
+export interface FlowTreeNode {
+    id: number;
+    name: string;
+    slug: string;
+    fullPath: string;
+    description: string | null;
+    fromModuleId: number | null;
+    toModuleId: number | null;
+    semantic: string | null;
+    depth: number;
+    domain: string | null;
+    parentId: number | null;
+    stepOrder: number;
+    createdAt: string;
+    children: FlowTreeNode[];
+    fromModuleName?: string;
+    toModuleName?: string;
+}
+export interface AnnotatedSymbolInfo {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    endLine: number;
+    isExported: boolean;
+    purpose: string | null;
+    domain: string[] | null;
+    role: string | null;
+}
+export interface AnnotatedEdgeInfo {
+    fromId: number;
+    toId: number;
+    weight: number;
+    semantic: string | null;
+}
+export interface EnhancedRelationshipContext {
+    fromDefinitionId: number;
+    fromName: string;
+    fromKind: string;
+    fromFilePath: string;
+    fromLine: number;
+    fromEndLine: number;
+    toDefinitionId: number;
+    toName: string;
+    toKind: string;
+    toFilePath: string;
+    toLine: number;
+    toEndLine: number;
+    fromPurpose: string | null;
+    fromDomains: string[] | null;
+    fromRole: string | null;
+    fromPure: boolean | null;
+    toPurpose: string | null;
+    toDomains: string[] | null;
+    toRole: string | null;
+    toPure: boolean | null;
+    relationshipType: 'call' | 'import' | 'extends' | 'implements';
+    usageLine: number;
+    otherFromRelationships: string[];
+    otherToRelationships: string[];
+    sharedDomains: string[];
+}
+/**
+ * Interface for database operations, enabling mocking in tests.
+ */
+export interface IIndexWriter {
+    initialize(): void;
+    setMetadata(key: string, value: string): void;
+    insertFile(file: FileInsert): number;
+    insertDefinition(fileId: number, def: Definition): number;
+    insertReference(fromFileId: number, toFileId: number | null, ref: FileReference): number;
+    insertSymbol(refId: number | null, defId: number | null, sym: ImportedSymbol, fileId?: number): number;
+    insertUsage(symbolId: number, usage: SymbolUsage): void;
+    getDefinitionByName(fileId: number, name: string): number | null;
+    getDefinitionCount(): number;
+    getReferenceCount(): number;
+    getUsageCount(): number;
+    getCallsites(definitionId: number): CallsiteResult[];
+    getCallsitesForFile(fileId: number): CallsiteResult[];
+    getCallsiteCount(): number;
+    close(): void;
+}
+export declare const SCHEMA = "\n-- Metadata about the indexing run\nCREATE TABLE metadata (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\n-- Files indexed by this run\nCREATE TABLE files (\n  id INTEGER PRIMARY KEY,\n  path TEXT UNIQUE NOT NULL,\n  language TEXT NOT NULL,\n  content_hash TEXT NOT NULL,\n  size_bytes INTEGER NOT NULL,\n  modified_at TEXT NOT NULL\n);\n\n-- All definitions (functions, classes, variables, types) in each file\nCREATE TABLE definitions (\n  id INTEGER PRIMARY KEY,\n  file_id INTEGER NOT NULL,\n  name TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  is_exported INTEGER NOT NULL,\n  is_default INTEGER NOT NULL,\n  line INTEGER NOT NULL,\n  column INTEGER NOT NULL,\n  end_line INTEGER NOT NULL,\n  end_column INTEGER NOT NULL,\n  declaration_end_line INTEGER NOT NULL,\n  declaration_end_column INTEGER NOT NULL,\n  extends_name TEXT,          -- Parent class name (for classes)\n  implements_names TEXT,      -- JSON array of interface names (for classes)\n  extends_interfaces TEXT,    -- JSON array of parent interfaces (for interfaces)\n  FOREIGN KEY (file_id) REFERENCES files(id)\n);\n\n-- Import/export relationships between files\nCREATE TABLE imports (\n  id INTEGER PRIMARY KEY,\n  from_file_id INTEGER NOT NULL,\n  to_file_id INTEGER,\n  type TEXT NOT NULL,\n  source TEXT NOT NULL,\n  is_external INTEGER NOT NULL,\n  is_type_only INTEGER NOT NULL,\n  line INTEGER NOT NULL,\n  column INTEGER NOT NULL,\n  FOREIGN KEY (from_file_id) REFERENCES files(id),\n  FOREIGN KEY (to_file_id) REFERENCES files(id)\n);\n\n-- Symbols imported in each reference (or internal symbols within a file)\nCREATE TABLE symbols (\n  id INTEGER PRIMARY KEY,\n  reference_id INTEGER,           -- NULL for internal symbols\n  file_id INTEGER,                -- Set for internal symbols (same-file references)\n  definition_id INTEGER,\n  name TEXT NOT NULL,\n  local_name TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  FOREIGN KEY (reference_id) REFERENCES imports(id),\n  FOREIGN KEY (file_id) REFERENCES files(id),\n  FOREIGN KEY (definition_id) REFERENCES definitions(id)\n);\n\n-- Where each imported symbol is used in the file\nCREATE TABLE usages (\n  id INTEGER PRIMARY KEY,\n  symbol_id INTEGER NOT NULL,\n  line INTEGER NOT NULL,\n  column INTEGER NOT NULL,\n  context TEXT NOT NULL,\n  argument_count INTEGER,\n  is_method_call INTEGER,\n  is_constructor_call INTEGER,\n  receiver_name TEXT,\n  FOREIGN KEY (symbol_id) REFERENCES symbols(id)\n);\n\n-- Indexes for efficient queries\nCREATE INDEX idx_files_path ON files(path);\nCREATE INDEX idx_definitions_file ON definitions(file_id);\nCREATE INDEX idx_definitions_name ON definitions(name);\nCREATE INDEX idx_definitions_extends ON definitions(extends_name);\nCREATE INDEX idx_imports_from_file ON imports(from_file_id);\nCREATE INDEX idx_imports_to_file ON imports(to_file_id);\nCREATE INDEX idx_symbols_reference ON symbols(reference_id);\nCREATE INDEX idx_symbols_definition ON symbols(definition_id);\nCREATE INDEX idx_symbols_file ON symbols(file_id);\nCREATE INDEX idx_usages_symbol ON usages(symbol_id);\nCREATE INDEX idx_usages_context ON usages(context);\n\n-- Key-value metadata for definitions\nCREATE TABLE definition_metadata (\n  id INTEGER PRIMARY KEY,\n  definition_id INTEGER NOT NULL,\n  key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  FOREIGN KEY (definition_id) REFERENCES definitions(id) ON DELETE CASCADE,\n  UNIQUE(definition_id, key)\n);\n\nCREATE INDEX idx_definition_metadata_def ON definition_metadata(definition_id);\nCREATE INDEX idx_definition_metadata_key ON definition_metadata(key);\n\n-- Semantic annotations for relationships between definitions\nCREATE TABLE relationship_annotations (\n  id INTEGER PRIMARY KEY,\n  from_definition_id INTEGER NOT NULL,\n  to_definition_id INTEGER NOT NULL,\n  relationship_type TEXT NOT NULL DEFAULT 'uses',  -- 'uses' | 'extends' | 'implements'\n  semantic TEXT NOT NULL,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  FOREIGN KEY (from_definition_id) REFERENCES definitions(id) ON DELETE CASCADE,\n  FOREIGN KEY (to_definition_id) REFERENCES definitions(id) ON DELETE CASCADE,\n  UNIQUE(from_definition_id, to_definition_id)\n);\n\nCREATE INDEX idx_relationship_annotations_from ON relationship_annotations(from_definition_id);\nCREATE INDEX idx_relationship_annotations_to ON relationship_annotations(to_definition_id);\nCREATE INDEX idx_relationship_annotations_type ON relationship_annotations(relationship_type);\n\n-- Domain registry for managing business domains\nCREATE TABLE domains (\n  id INTEGER PRIMARY KEY,\n  name TEXT UNIQUE NOT NULL,\n  description TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX idx_domains_name ON domains(name);\n\n-- Module tree structure\nCREATE TABLE modules (\n  id INTEGER PRIMARY KEY,\n  parent_id INTEGER REFERENCES modules(id) ON DELETE CASCADE,\n  slug TEXT NOT NULL,                    -- e.g., \"login\" (leaf segment)\n  full_path TEXT NOT NULL UNIQUE,        -- e.g., \"project.packages.electron-app.screens.login\"\n  name TEXT NOT NULL,                    -- Human-readable: \"Login Screen\"\n  description TEXT,                      -- Free text description\n  depth INTEGER NOT NULL DEFAULT 0,      -- 0 for root, 1 for children, etc.\n  color_index INTEGER NOT NULL DEFAULT 0,\n  is_test INTEGER NOT NULL DEFAULT 0,    -- 1 if module exists solely for testing\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(parent_id, slug)\n);\n\nCREATE INDEX idx_modules_parent ON modules(parent_id);\nCREATE INDEX idx_modules_path ON modules(full_path);\nCREATE INDEX idx_modules_depth ON modules(depth);\n\n-- Symbol assignments (each symbol belongs to exactly one module)\nCREATE TABLE module_members (\n  module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,\n  definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,\n  assigned_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY (definition_id)\n);\n\nCREATE INDEX idx_module_members_module ON module_members(module_id);\n\n-- Interactions: module-to-module edges (flat, not hierarchical)\nCREATE TABLE interactions (\n  id INTEGER PRIMARY KEY,\n  from_module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,\n  to_module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,\n  direction TEXT NOT NULL DEFAULT 'uni',  -- 'uni' | 'bi'\n  weight INTEGER NOT NULL DEFAULT 1,\n  pattern TEXT,  -- 'utility' | 'business'\n  symbols TEXT,  -- JSON array of symbol names\n  semantic TEXT,  -- What happens in this interaction\n  source TEXT NOT NULL DEFAULT 'ast',  -- 'ast' | 'llm-inferred'\n  confidence TEXT,  -- 'high' | 'medium' | NULL\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(from_module_id, to_module_id)\n);\n\nCREATE INDEX idx_interactions_from_module ON interactions(from_module_id);\nCREATE INDEX idx_interactions_to_module ON interactions(to_module_id);\nCREATE INDEX idx_interactions_pattern ON interactions(pattern);\nCREATE INDEX idx_interactions_source ON interactions(source);\n\n-- Flows: user journeys with entry points\nCREATE TABLE flows (\n  id INTEGER PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  entry_point_module_id INTEGER REFERENCES modules(id) ON DELETE SET NULL,\n  entry_point_id INTEGER REFERENCES definitions(id) ON DELETE SET NULL,\n  entry_path TEXT,  -- e.g., \"POST /api/auth/login\"\n  stakeholder TEXT,  -- 'user' | 'admin' | 'system' | 'developer' | 'external'\n  description TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX idx_flows_slug ON flows(slug);\nCREATE INDEX idx_flows_entry_point_module ON flows(entry_point_module_id);\nCREATE INDEX idx_flows_entry_point ON flows(entry_point_id);\nCREATE INDEX idx_flows_stakeholder ON flows(stakeholder);\n\n-- Flow steps: ordered interactions within a flow (module-level)\nCREATE TABLE flow_steps (\n  flow_id INTEGER NOT NULL REFERENCES flows(id) ON DELETE CASCADE,\n  step_order INTEGER NOT NULL,\n  interaction_id INTEGER NOT NULL REFERENCES interactions(id) ON DELETE CASCADE,\n  PRIMARY KEY (flow_id, step_order)\n);\n\nCREATE INDEX idx_flow_steps_interaction ON flow_steps(interaction_id);\n\n-- Flow definition steps: ordered definition-level call edges within a flow\nCREATE TABLE flow_definition_steps (\n  flow_id INTEGER NOT NULL REFERENCES flows(id) ON DELETE CASCADE,\n  step_order INTEGER NOT NULL,\n  from_definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,\n  to_definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,\n  PRIMARY KEY (flow_id, step_order)\n);\n\nCREATE INDEX idx_flow_def_steps_from ON flow_definition_steps(from_definition_id);\nCREATE INDEX idx_flow_def_steps_to ON flow_definition_steps(to_definition_id);\n";
+export declare function computeHash(content: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"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"}

package/dist/db/schema.js

@@ -0,0 +1,234 @@
+import { createHash } from 'node:crypto';
+// ============================================================
+// SQL Schema Definition
+// ============================================================
+export const SCHEMA = `
+-- Metadata about the indexing run
+CREATE TABLE metadata (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- Files indexed by this run
+CREATE TABLE files (
+  id INTEGER PRIMARY KEY,
+  path TEXT UNIQUE NOT NULL,
+  language TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  size_bytes INTEGER NOT NULL,
+  modified_at TEXT NOT NULL
+);
+
+-- All definitions (functions, classes, variables, types) in each file
+CREATE TABLE definitions (
+  id INTEGER PRIMARY KEY,
+  file_id INTEGER NOT NULL,
+  name TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  is_exported INTEGER NOT NULL,
+  is_default INTEGER NOT NULL,
+  line INTEGER NOT NULL,
+  column INTEGER NOT NULL,
+  end_line INTEGER NOT NULL,
+  end_column INTEGER NOT NULL,
+  declaration_end_line INTEGER NOT NULL,
+  declaration_end_column INTEGER NOT NULL,
+  extends_name TEXT,          -- Parent class name (for classes)
+  implements_names TEXT,      -- JSON array of interface names (for classes)
+  extends_interfaces TEXT,    -- JSON array of parent interfaces (for interfaces)
+  FOREIGN KEY (file_id) REFERENCES files(id)
+);
+
+-- Import/export relationships between files
+CREATE TABLE imports (
+  id INTEGER PRIMARY KEY,
+  from_file_id INTEGER NOT NULL,
+  to_file_id INTEGER,
+  type TEXT NOT NULL,
+  source TEXT NOT NULL,
+  is_external INTEGER NOT NULL,
+  is_type_only INTEGER NOT NULL,
+  line INTEGER NOT NULL,
+  column INTEGER NOT NULL,
+  FOREIGN KEY (from_file_id) REFERENCES files(id),
+  FOREIGN KEY (to_file_id) REFERENCES files(id)
+);
+
+-- Symbols imported in each reference (or internal symbols within a file)
+CREATE TABLE symbols (
+  id INTEGER PRIMARY KEY,
+  reference_id INTEGER,           -- NULL for internal symbols
+  file_id INTEGER,                -- Set for internal symbols (same-file references)
+  definition_id INTEGER,
+  name TEXT NOT NULL,
+  local_name TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  FOREIGN KEY (reference_id) REFERENCES imports(id),
+  FOREIGN KEY (file_id) REFERENCES files(id),
+  FOREIGN KEY (definition_id) REFERENCES definitions(id)
+);
+
+-- Where each imported symbol is used in the file
+CREATE TABLE usages (
+  id INTEGER PRIMARY KEY,
+  symbol_id INTEGER NOT NULL,
+  line INTEGER NOT NULL,
+  column INTEGER NOT NULL,
+  context TEXT NOT NULL,
+  argument_count INTEGER,
+  is_method_call INTEGER,
+  is_constructor_call INTEGER,
+  receiver_name TEXT,
+  FOREIGN KEY (symbol_id) REFERENCES symbols(id)
+);
+
+-- Indexes for efficient queries
+CREATE INDEX idx_files_path ON files(path);
+CREATE INDEX idx_definitions_file ON definitions(file_id);
+CREATE INDEX idx_definitions_name ON definitions(name);
+CREATE INDEX idx_definitions_extends ON definitions(extends_name);
+CREATE INDEX idx_imports_from_file ON imports(from_file_id);
+CREATE INDEX idx_imports_to_file ON imports(to_file_id);
+CREATE INDEX idx_symbols_reference ON symbols(reference_id);
+CREATE INDEX idx_symbols_definition ON symbols(definition_id);
+CREATE INDEX idx_symbols_file ON symbols(file_id);
+CREATE INDEX idx_usages_symbol ON usages(symbol_id);
+CREATE INDEX idx_usages_context ON usages(context);
+
+-- Key-value metadata for definitions
+CREATE TABLE definition_metadata (
+  id INTEGER PRIMARY KEY,
+  definition_id INTEGER NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  FOREIGN KEY (definition_id) REFERENCES definitions(id) ON DELETE CASCADE,
+  UNIQUE(definition_id, key)
+);
+
+CREATE INDEX idx_definition_metadata_def ON definition_metadata(definition_id);
+CREATE INDEX idx_definition_metadata_key ON definition_metadata(key);
+
+-- Semantic annotations for relationships between definitions
+CREATE TABLE relationship_annotations (
+  id INTEGER PRIMARY KEY,
+  from_definition_id INTEGER NOT NULL,
+  to_definition_id INTEGER NOT NULL,
+  relationship_type TEXT NOT NULL DEFAULT 'uses',  -- 'uses' | 'extends' | 'implements'
+  semantic TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (from_definition_id) REFERENCES definitions(id) ON DELETE CASCADE,
+  FOREIGN KEY (to_definition_id) REFERENCES definitions(id) ON DELETE CASCADE,
+  UNIQUE(from_definition_id, to_definition_id)
+);
+
+CREATE INDEX idx_relationship_annotations_from ON relationship_annotations(from_definition_id);
+CREATE INDEX idx_relationship_annotations_to ON relationship_annotations(to_definition_id);
+CREATE INDEX idx_relationship_annotations_type ON relationship_annotations(relationship_type);
+
+-- Domain registry for managing business domains
+CREATE TABLE domains (
+  id INTEGER PRIMARY KEY,
+  name TEXT UNIQUE NOT NULL,
+  description TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_domains_name ON domains(name);
+
+-- Module tree structure
+CREATE TABLE modules (
+  id INTEGER PRIMARY KEY,
+  parent_id INTEGER REFERENCES modules(id) ON DELETE CASCADE,
+  slug TEXT NOT NULL,                    -- e.g., "login" (leaf segment)
+  full_path TEXT NOT NULL UNIQUE,        -- e.g., "project.packages.electron-app.screens.login"
+  name TEXT NOT NULL,                    -- Human-readable: "Login Screen"
+  description TEXT,                      -- Free text description
+  depth INTEGER NOT NULL DEFAULT 0,      -- 0 for root, 1 for children, etc.
+  color_index INTEGER NOT NULL DEFAULT 0,
+  is_test INTEGER NOT NULL DEFAULT 0,    -- 1 if module exists solely for testing
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(parent_id, slug)
+);
+
+CREATE INDEX idx_modules_parent ON modules(parent_id);
+CREATE INDEX idx_modules_path ON modules(full_path);
+CREATE INDEX idx_modules_depth ON modules(depth);
+
+-- Symbol assignments (each symbol belongs to exactly one module)
+CREATE TABLE module_members (
+  module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,
+  definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,
+  assigned_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (definition_id)
+);
+
+CREATE INDEX idx_module_members_module ON module_members(module_id);
+
+-- Interactions: module-to-module edges (flat, not hierarchical)
+CREATE TABLE interactions (
+  id INTEGER PRIMARY KEY,
+  from_module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,
+  to_module_id INTEGER NOT NULL REFERENCES modules(id) ON DELETE CASCADE,
+  direction TEXT NOT NULL DEFAULT 'uni',  -- 'uni' | 'bi'
+  weight INTEGER NOT NULL DEFAULT 1,
+  pattern TEXT,  -- 'utility' | 'business'
+  symbols TEXT,  -- JSON array of symbol names
+  semantic TEXT,  -- What happens in this interaction
+  source TEXT NOT NULL DEFAULT 'ast',  -- 'ast' | 'llm-inferred'
+  confidence TEXT,  -- 'high' | 'medium' | NULL
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(from_module_id, to_module_id)
+);
+
+CREATE INDEX idx_interactions_from_module ON interactions(from_module_id);
+CREATE INDEX idx_interactions_to_module ON interactions(to_module_id);
+CREATE INDEX idx_interactions_pattern ON interactions(pattern);
+CREATE INDEX idx_interactions_source ON interactions(source);
+
+-- Flows: user journeys with entry points
+CREATE TABLE flows (
+  id INTEGER PRIMARY KEY,
+  name TEXT NOT NULL,
+  slug TEXT NOT NULL UNIQUE,
+  entry_point_module_id INTEGER REFERENCES modules(id) ON DELETE SET NULL,
+  entry_point_id INTEGER REFERENCES definitions(id) ON DELETE SET NULL,
+  entry_path TEXT,  -- e.g., "POST /api/auth/login"
+  stakeholder TEXT,  -- 'user' | 'admin' | 'system' | 'developer' | 'external'
+  description TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX idx_flows_slug ON flows(slug);
+CREATE INDEX idx_flows_entry_point_module ON flows(entry_point_module_id);
+CREATE INDEX idx_flows_entry_point ON flows(entry_point_id);
+CREATE INDEX idx_flows_stakeholder ON flows(stakeholder);
+
+-- Flow steps: ordered interactions within a flow (module-level)
+CREATE TABLE flow_steps (
+  flow_id INTEGER NOT NULL REFERENCES flows(id) ON DELETE CASCADE,
+  step_order INTEGER NOT NULL,
+  interaction_id INTEGER NOT NULL REFERENCES interactions(id) ON DELETE CASCADE,
+  PRIMARY KEY (flow_id, step_order)
+);
+
+CREATE INDEX idx_flow_steps_interaction ON flow_steps(interaction_id);
+
+-- Flow definition steps: ordered definition-level call edges within a flow
+CREATE TABLE flow_definition_steps (
+  flow_id INTEGER NOT NULL REFERENCES flows(id) ON DELETE CASCADE,
+  step_order INTEGER NOT NULL,
+  from_definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,
+  to_definition_id INTEGER NOT NULL REFERENCES definitions(id) ON DELETE CASCADE,
+  PRIMARY KEY (flow_id, step_order)
+);
+
+CREATE INDEX idx_flow_def_steps_from ON flow_definition_steps(from_definition_id);
+CREATE INDEX idx_flow_def_steps_to ON flow_definition_steps(to_definition_id);
+`;
+// ============================================================
+// Utility Functions
+// ============================================================
+export function computeHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgezC,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAE/D,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8NrB,CAAC;AAEF,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}