@a-company/sentinel 0.2.0

package/dist/server/index.d.ts

@@ -0,0 +1,82 @@
+import { Express } from 'express';
+
+/**
+ * Symbol index loader for the server
+ *
+ * Uses premise-core aggregator for symbol extraction, with fallback
+ * to local scanning if premise-core is unavailable.
+ */
+interface SymbolEntry {
+    id: string;
+    symbol: string;
+    type: 'component' | 'flow' | 'gate' | 'signal' | 'aspect';
+    source: 'purpose' | 'portal' | 'premise';
+    filePath: string;
+    data: Record<string, unknown>;
+    description?: string;
+    references: string[];
+    referencedBy: string[];
+    tags?: string[];
+}
+interface ParadigmConfig {
+    name?: string;
+    discipline?: string;
+    version?: string;
+    conventions?: Record<string, unknown>;
+}
+/**
+ * Load Paradigm configuration from .paradigm/config.yaml
+ */
+declare function loadParadigmConfig(projectDir: string): Promise<ParadigmConfig>;
+/**
+ * Load symbol index from .paradigm/index.json or scan .purpose files
+ */
+declare function loadSymbolIndex(projectDir: string): Promise<SymbolEntry[]>;
+/**
+ * Get total symbol count for a project
+ */
+declare function getSymbolCount(projectDir: string): Promise<number>;
+
+/**
+ * Git integration for loading commit history
+ */
+interface CommitInfo {
+    hash: string;
+    shortHash: string;
+    date: string;
+    author: string;
+    message: string;
+    symbolsModified: string[];
+    filesChanged: string[];
+}
+/**
+ * Load Git commit history for a project
+ */
+declare function loadGitHistory(projectDir: string, options?: {
+    limit?: number;
+    since?: string;
+}): Promise<CommitInfo[]>;
+/**
+ * Get symbols at a specific commit
+ */
+declare function getSymbolsAtCommit(projectDir: string, commitHash: string): Promise<string[]>;
+
+/**
+ * Sentinel Server - Express server for the visualizer UI
+ */
+
+interface ServerOptions {
+    port: number;
+    projectDir: string;
+    open?: boolean;
+}
+/**
+ * Create the Express application with all routes configured
+ */
+declare function createApp(options: ServerOptions): Express;
+/**
+ * Start the Sentinel server
+ */
+declare function startServer(options: ServerOptions): Promise<void>;
+
+export { type CommitInfo, type ParadigmConfig, type ServerOptions, type SymbolEntry, createApp, getSymbolCount, getSymbolsAtCommit, loadGitHistory, loadParadigmConfig, loadSymbolIndex, startServer };