septum 0.1.0 → 0.1.2

package/src/types/index.ts

@@ -1,296 +1,296 @@
-export type EnforcementMode = "strict" | "warn";
-
-export type ArchetypeKind =
-  | "controller"
-  | "service"
-  | "model"
-  | "repository"
-  | "action"
-  | "job"
-  | "event"
-  | "listener"
-  | "middleware"
-  | "request"
-  | "resource"
-  | "util"
-  | "unknown";
-
-export type SymbolKind =
-  | "class"
-  | "interface"
-  | "trait"
-  | "enum"
-  | "method"
-  | "function"
-  | "type"
-  | "property";
-
-export type Visibility = "public" | "protected" | "private";
-
-export interface SeptumConfig {
-  version: string;
-  settings: {
-    enforcement: EnforcementMode;
-    db_path?: string;
-    ignore_patterns?: string[];
-  };
-  domains: Record<string, DomainConfig>;
-  features?: Record<string, FeatureConfig>;
-}
-
-export interface DomainConfig {
-  root: string;
-  allowed_dependencies?: string[];
-  forbidden_dependencies?: string[];
-  archetypes?: Record<string, string>;
-  description?: string;
-}
-
-export interface FeatureConfig {
-  domain: string;
-  description?: string;
-  allowed_touchpoints: string[];
-  reuse_symbols?: string[];
-  input_contract?: Record<string, unknown>;
-  output_contract?: Record<string, unknown>;
-}
-
-export interface FeatureContextResponse {
-  feature: string;
-  domain: string;
-  description?: string;
-  allowed_touchpoints: string[];
-  reuse_symbols: Array<{
-    name: string;
-    kind: string;
-    signature?: string;
-    methods?: string[];
-    properties?: string[];
-    file_path?: string;
-    domain?: string;
-  }>;
-  input_contract: Record<string, unknown>;
-  output_contract: Record<string, unknown>;
-  governance_directives?: string[];
-}
-
-export interface CheckBoundaryArgs {
-  file_path: string;
-  proposed_imports: string[];
-  feature_key?: string;
-}
-
-export interface DomainRecord {
-  id: number;
-  name: string;
-  root_path: string;
-  allowed_deps_json: string;
-  forbidden_deps_json: string;
-  archetypes_json: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface FileRecord {
-  id: number;
-  domain_id: number;
-  path: string;
-  archetype: ArchetypeKind;
-  content_hash: string;
-  line_count: number;
-  mtime_ms: number;
-  size_bytes: number;
-  last_scanned_at: string;
-}
-
-export interface ActiveFeatureSession {
-  feature_key: string;
-  domain: string;
-  touchpoints: string[];
-  locked_at: string;
-}
-
-export interface SymbolRecord {
-  id: number;
-  file_id: number;
-  name: string;
-  kind: SymbolKind;
-  signature: string;
-  visibility: Visibility;
-  line_start: number;
-  line_end: number;
-  line_count: number;
-}
-
-export interface DependencyRecord {
-  id: number;
-  source_file_id: number;
-  target_symbol_or_path: string;
-  import_statement: string;
-  line_number: number;
-  is_external: boolean;
-}
-
-export interface ExtractedSymbol {
-  name: string;
-  kind: SymbolKind;
-  signature: string;
-  visibility: Visibility;
-  line_start: number;
-  line_end: number;
-  line_count: number;
-}
-
-export interface ExtractedDependency {
-  target: string;
-  statement: string;
-  line_number: number;
-  is_external: boolean;
-}
-
-export interface ParsedFileAST {
-  symbols: ExtractedSymbol[];
-  dependencies: ExtractedDependency[];
-}
-
-export type BoundaryViolationRule =
-  | "forbidden_dependency"
-  | "disallowed_dependency"
-  | "touchpoint_violation"
-  | "unknown_feature";
-
-export interface BoundaryViolation {
-  file: string;
-  line: number;
-  source_domain: string;
-  target_domain: string;
-  imported_target: string;
-  rule: BoundaryViolationRule;
-  message: string;
-}
-
-export interface DomainCatalogResponse {
-  domain: string;
-  root: string;
-  allowed_dependencies: string[];
-  forbidden_dependencies: string[];
-  files: Array<{
-    path: string;
-    archetype: ArchetypeKind;
-    symbols: Array<{
-      name: string;
-      kind: SymbolKind;
-      properties?: string[];
-      methods?: string[];
-      signatures?: string[];
-    }>;
-  }>;
-}
-
-export interface ExecutionChainNode {
-  stage:
-    | "ingress"
-    | "validation"
-    | "controller"
-    | "orchestrator"
-    | "use_case"
-    | "domain"
-    | "entity"
-    | "egress"
-    | "repository"
-    | string;
-  symbol: string;
-  file?: string;
-  line?: number;
-  description?: string;
-}
-
-export interface VerticalSliceRecord {
-  id: number;
-  domain_id: number | null;
-  feature_key: string | null;
-  http_method: string;
-  route_uri: string;
-  route_name: string | null;
-  controller_class: string;
-  action_name: string;
-  controller_file: string | null;
-  controller_line: number;
-  architecture_style: string;
-  entry_kind: string;
-  execution_chain_json: string;
-  created_at: string;
-}
-
-export interface VerticalSliceTraceResponse {
-  query: string;
-  found: boolean;
-  confidence?: "exact" | "inferred";
-  is_exact_match?: boolean;
-  architecture_style?: string;
-  entrypoint?: {
-    method: string;
-    uri: string;
-    name?: string | null;
-    controller: string;
-    action: string;
-    file?: string | null;
-    line?: number;
-  };
-  chain?: ExecutionChainNode[];
-  alternatives?: Array<{
-    method: string;
-    uri: string;
-    controller: string;
-    action: string;
-  }>;
-  message: string;
-}
-
-export interface GetSymbolArgs {
-  symbol: string;
-  domain?: string;
-  include_dependencies?: boolean;
-}
-
-export interface SymbolExactRange {
-  start_line: number;
-  end_line: number;
-  total_lines: number;
-}
-
-export interface GetSymbolDetailsResponse {
-  symbol: string;
-  kind: SymbolKind | string;
-  file_path: string;
-  domain?: string;
-  exact_range: SymbolExactRange;
-  signature: string;
-  visibility?: Visibility | string;
-  dependencies_injected: string[];
-  outbound_calls: string[];
-  sibling_methods?: string[];
-}
-
-export interface GetSymbolImpactArgs {
-  symbol: string;
-}
-
-export interface InboundCaller {
-  file: string;
-  caller: string;
-  line: number;
-  kind?: string;
-  domain?: string;
-}
-
-export interface GetSymbolImpactResponse {
-  target_symbol: string;
-  impact_summary: {
-    total_dependents: number;
-    risk_level: "low" | "medium" | "high";
-    affected_files_count: number;
-  };
-  inbound_callers: InboundCaller[];
-}
-
+export type EnforcementMode = "strict" | "warn";
+
+export type ArchetypeKind =
+  | "controller"
+  | "service"
+  | "model"
+  | "repository"
+  | "action"
+  | "job"
+  | "event"
+  | "listener"
+  | "middleware"
+  | "request"
+  | "resource"
+  | "util"
+  | "unknown";
+
+export type SymbolKind =
+  | "class"
+  | "interface"
+  | "trait"
+  | "enum"
+  | "method"
+  | "function"
+  | "type"
+  | "property";
+
+export type Visibility = "public" | "protected" | "private";
+
+export interface SeptumConfig {
+  version: string;
+  settings: {
+    enforcement: EnforcementMode;
+    db_path?: string;
+    ignore_patterns?: string[];
+  };
+  domains: Record<string, DomainConfig>;
+  features?: Record<string, FeatureConfig>;
+}
+
+export interface DomainConfig {
+  root: string;
+  allowed_dependencies?: string[];
+  forbidden_dependencies?: string[];
+  archetypes?: Record<string, string>;
+  description?: string;
+}
+
+export interface FeatureConfig {
+  domain: string;
+  description?: string;
+  allowed_touchpoints: string[];
+  reuse_symbols?: string[];
+  input_contract?: Record<string, unknown>;
+  output_contract?: Record<string, unknown>;
+}
+
+export interface FeatureContextResponse {
+  feature: string;
+  domain: string;
+  description?: string;
+  allowed_touchpoints: string[];
+  reuse_symbols: Array<{
+    name: string;
+    kind: string;
+    signature?: string;
+    methods?: string[];
+    properties?: string[];
+    file_path?: string;
+    domain?: string;
+  }>;
+  input_contract: Record<string, unknown>;
+  output_contract: Record<string, unknown>;
+  governance_directives?: string[];
+}
+
+export interface CheckBoundaryArgs {
+  file_path: string;
+  proposed_imports: string[];
+  feature_key?: string;
+}
+
+export interface DomainRecord {
+  id: number;
+  name: string;
+  root_path: string;
+  allowed_deps_json: string;
+  forbidden_deps_json: string;
+  archetypes_json: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface FileRecord {
+  id: number;
+  domain_id: number;
+  path: string;
+  archetype: ArchetypeKind;
+  content_hash: string;
+  line_count: number;
+  mtime_ms: number;
+  size_bytes: number;
+  last_scanned_at: string;
+}
+
+export interface ActiveFeatureSession {
+  feature_key: string;
+  domain: string;
+  touchpoints: string[];
+  locked_at: string;
+}
+
+export interface SymbolRecord {
+  id: number;
+  file_id: number;
+  name: string;
+  kind: SymbolKind;
+  signature: string;
+  visibility: Visibility;
+  line_start: number;
+  line_end: number;
+  line_count: number;
+}
+
+export interface DependencyRecord {
+  id: number;
+  source_file_id: number;
+  target_symbol_or_path: string;
+  import_statement: string;
+  line_number: number;
+  is_external: boolean;
+}
+
+export interface ExtractedSymbol {
+  name: string;
+  kind: SymbolKind;
+  signature: string;
+  visibility: Visibility;
+  line_start: number;
+  line_end: number;
+  line_count: number;
+}
+
+export interface ExtractedDependency {
+  target: string;
+  statement: string;
+  line_number: number;
+  is_external: boolean;
+}
+
+export interface ParsedFileAST {
+  symbols: ExtractedSymbol[];
+  dependencies: ExtractedDependency[];
+}
+
+export type BoundaryViolationRule =
+  | "forbidden_dependency"
+  | "disallowed_dependency"
+  | "touchpoint_violation"
+  | "unknown_feature";
+
+export interface BoundaryViolation {
+  file: string;
+  line: number;
+  source_domain: string;
+  target_domain: string;
+  imported_target: string;
+  rule: BoundaryViolationRule;
+  message: string;
+}
+
+export interface DomainCatalogResponse {
+  domain: string;
+  root: string;
+  allowed_dependencies: string[];
+  forbidden_dependencies: string[];
+  files: Array<{
+    path: string;
+    archetype: ArchetypeKind;
+    symbols: Array<{
+      name: string;
+      kind: SymbolKind;
+      properties?: string[];
+      methods?: string[];
+      signatures?: string[];
+    }>;
+  }>;
+}
+
+export interface ExecutionChainNode {
+  stage:
+    | "ingress"
+    | "validation"
+    | "controller"
+    | "orchestrator"
+    | "use_case"
+    | "domain"
+    | "entity"
+    | "egress"
+    | "repository"
+    | string;
+  symbol: string;
+  file?: string;
+  line?: number;
+  description?: string;
+}
+
+export interface VerticalSliceRecord {
+  id: number;
+  domain_id: number | null;
+  feature_key: string | null;
+  http_method: string;
+  route_uri: string;
+  route_name: string | null;
+  controller_class: string;
+  action_name: string;
+  controller_file: string | null;
+  controller_line: number;
+  architecture_style: string;
+  entry_kind: string;
+  execution_chain_json: string;
+  created_at: string;
+}
+
+export interface VerticalSliceTraceResponse {
+  query: string;
+  found: boolean;
+  confidence?: "exact" | "inferred";
+  is_exact_match?: boolean;
+  architecture_style?: string;
+  entrypoint?: {
+    method: string;
+    uri: string;
+    name?: string | null;
+    controller: string;
+    action: string;
+    file?: string | null;
+    line?: number;
+  };
+  chain?: ExecutionChainNode[];
+  alternatives?: Array<{
+    method: string;
+    uri: string;
+    controller: string;
+    action: string;
+  }>;
+  message: string;
+}
+
+export interface GetSymbolArgs {
+  symbol: string;
+  domain?: string;
+  include_dependencies?: boolean;
+}
+
+export interface SymbolExactRange {
+  start_line: number;
+  end_line: number;
+  total_lines: number;
+}
+
+export interface GetSymbolDetailsResponse {
+  symbol: string;
+  kind: SymbolKind | string;
+  file_path: string;
+  domain?: string;
+  exact_range: SymbolExactRange;
+  signature: string;
+  visibility?: Visibility | string;
+  dependencies_injected: string[];
+  outbound_calls: string[];
+  sibling_methods?: string[];
+}
+
+export interface GetSymbolImpactArgs {
+  symbol: string;
+}
+
+export interface InboundCaller {
+  file: string;
+  caller: string;
+  line: number;
+  kind?: string;
+  domain?: string;
+}
+
+export interface GetSymbolImpactResponse {
+  target_symbol: string;
+  impact_summary: {
+    total_dependents: number;
+    risk_level: "low" | "medium" | "high";
+    affected_files_count: number;
+  };
+  inbound_callers: InboundCaller[];
+}
+

package/src/version.ts

@@ -0,0 +1,3 @@
+import packageJson from "../package.json" with { type: "json" };
+
+export const SEPTUM_VERSION: string = packageJson.version;

package/src/core/database/schema.sql

@@ -1,92 +0,0 @@
--- Septum Embedded SQLite Database Schema
--- Version 1.0
-
-PRAGMA foreign_keys = ON;
-
-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, -- 'class' | 'interface' | 'trait' | 'method' | 'function' | 'property'
-    signature TEXT NOT NULL,
-    visibility TEXT NOT NULL DEFAULT 'public', -- 'public' | 'protected' | 'private'
-    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
-);
-
--- Fast Lookup Indexes
-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 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 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);
-
--- Synchronization & Watermark SSOT Tracking
-CREATE TABLE IF NOT EXISTS repo_meta (
-    key TEXT PRIMARY KEY,
-    value TEXT NOT NULL,
-    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
-