promptspeak-mcp-server 0.1.0

package/dist/symbols/graph-types.d.ts

@@ -0,0 +1,291 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * PROMPTSPEAK GRAPH TYPES
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Type definitions for graph relationships between symbols.
+ * Based on research from:
+ * - Microsoft GraphRAG relationship model
+ * - Neo4j knowledge graph patterns
+ * - FIBO (Financial Industry Business Ontology)
+ * - FinDKG (Financial Dynamic Knowledge Graph)
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * Primary relationship categories aligned with GraphRAG research.
+ * Each category contains semantically related relationship types.
+ */
+export type RelationshipCategory = 'CAUSAL' | 'TEMPORAL' | 'HIERARCHICAL' | 'ASSOCIATIVE' | 'COMPETITIVE' | 'DEPENDENCY' | 'OWNERSHIP' | 'REGULATORY';
+/**
+ * Specific relationship types for financial/business domains.
+ * Based on FIBO and FinDKG ontologies.
+ */
+export type RelationshipType = 'CAUSES' | 'TRIGGERS' | 'LEADS_TO' | 'RESULTS_IN' | 'ENABLES' | 'PREVENTS' | 'PRECEDES' | 'FOLLOWS' | 'CONCURRENT_WITH' | 'SUPERSEDES' | 'SUPERSEDED_BY' | 'PARENT_OF' | 'CHILD_OF' | 'CONTAINS' | 'PART_OF' | 'ELABORATES' | 'SUMMARIZES' | 'RELATED_TO' | 'REFERENCES' | 'SIMILAR_TO' | 'CONTRASTS_WITH' | 'COMPLEMENTS' | 'COMPETES_WITH' | 'OUTPERFORMS' | 'UNDERPERFORMS' | 'DISRUPTS' | 'CHALLENGES' | 'DEPENDS_ON' | 'REQUIRES' | 'SUPPORTS' | 'BLOCKS' | 'EXPOSED_TO' | 'OWNS' | 'CONTROLS' | 'SUBSIDIARY_OF' | 'ACQUIRED_BY' | 'MERGED_WITH' | 'PARTNERS_WITH' | 'REGULATED_BY' | 'COMPLIANT_WITH' | 'SUBJECT_TO' | 'FILED_WITH' | 'AUDITED_BY';
+/**
+ * Maps relationship types to their categories for filtering.
+ */
+export declare const RELATIONSHIP_CATEGORIES: Record<RelationshipType, RelationshipCategory>;
+/**
+ * Inverse relationship mappings for bidirectional traversal.
+ */
+export declare const INVERSE_RELATIONSHIPS: Partial<Record<RelationshipType, RelationshipType>>;
+/**
+ * Represents a directed relationship between two symbols.
+ */
+export interface SymbolRelationship {
+    /** Unique relationship ID */
+    id: number;
+    /** Source symbol ID (from) */
+    fromSymbolId: string;
+    /** Target symbol ID (to) */
+    toSymbolId: string;
+    /** Type of relationship */
+    relationshipType: RelationshipType;
+    /** Relationship category (derived from type) */
+    category: RelationshipCategory;
+    /**
+     * Relationship weight/strength (0.0-1.0)
+     * Based on:
+     * - Source authority (SEC > press release > news)
+     * - Extraction confidence
+     * - Corroboration (multiple sources)
+     * - Recency
+     */
+    weight: number;
+    /**
+     * Confidence score for extracted relationships (0.0-1.0)
+     */
+    confidence: number;
+    /** Additional properties as JSON */
+    properties?: RelationshipProperties;
+    /** Evidence/source for this relationship */
+    evidence?: string;
+    /** When the relationship was created */
+    createdAt: string;
+    /** Who created the relationship */
+    createdBy?: string;
+}
+/**
+ * Optional properties that can be attached to relationships.
+ */
+export interface RelationshipProperties {
+    /** Source document/URL for this relationship */
+    source?: string;
+    /** Specific text that evidences the relationship */
+    evidenceText?: string;
+    /** Time period this relationship is valid for */
+    validFrom?: string;
+    validUntil?: string;
+    /** Quantitative attributes */
+    percentage?: number;
+    amount?: number;
+    currency?: string;
+    /** Custom attributes */
+    [key: string]: unknown;
+}
+/**
+ * Request to create a new relationship.
+ */
+export interface CreateRelationshipRequest {
+    fromSymbolId: string;
+    toSymbolId: string;
+    relationshipType: RelationshipType;
+    weight?: number;
+    confidence?: number;
+    properties?: RelationshipProperties;
+    evidence?: string;
+    createdBy?: string;
+    /** If true, also create the inverse relationship */
+    bidirectional?: boolean;
+}
+/**
+ * Options for querying relationships.
+ */
+export interface RelationshipQueryOptions {
+    /** Filter by relationship types */
+    types?: RelationshipType[];
+    /** Filter by relationship categories */
+    categories?: RelationshipCategory[];
+    /** Minimum weight threshold */
+    minWeight?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Include inverse relationships in results */
+    includeBidirectional?: boolean;
+    /** Maximum number of results */
+    limit?: number;
+    /** Order by field */
+    orderBy?: 'weight' | 'confidence' | 'createdAt';
+    orderDirection?: 'ASC' | 'DESC';
+}
+/**
+ * Options for graph traversal operations.
+ */
+export interface TraversalOptions {
+    /** Maximum traversal depth (hops) */
+    maxDepth?: number;
+    /** Filter by relationship types */
+    relationshipTypes?: RelationshipType[];
+    /** Filter by relationship categories */
+    categories?: RelationshipCategory[];
+    /** Minimum weight for traversal */
+    minWeight?: number;
+    /** Whether to traverse in both directions */
+    bidirectional?: boolean;
+    /** Maximum nodes to return */
+    limit?: number;
+    /** Include path information */
+    includePaths?: boolean;
+}
+/**
+ * A node in the traversal result with distance information.
+ */
+export interface TraversalNode {
+    /** Symbol ID */
+    symbolId: string;
+    /** Distance from starting node (hops) */
+    depth: number;
+    /** Path from start to this node */
+    path?: string[];
+    /** Relationships used to reach this node */
+    pathRelationships?: RelationshipType[];
+    /** Cumulative weight along the path */
+    pathWeight?: number;
+    /** The relationship that led to this node (from parent) */
+    viaRelationship?: RelationshipType;
+    /** Parent node in the traversal */
+    viaNode?: string;
+}
+/**
+ * Result of a neighborhood traversal.
+ */
+export interface NeighborhoodResult {
+    /** Starting symbol ID */
+    startSymbol: string;
+    /** All reachable nodes within maxDepth */
+    nodes: TraversalNode[];
+    /** Total edges traversed */
+    edgesTraversed: number;
+    /** Traversal statistics */
+    stats: {
+        nodesAtDepth: Record<number, number>;
+        byRelationshipType: Record<RelationshipType, number>;
+    };
+}
+/**
+ * Result of a path-finding operation.
+ */
+export interface PathResult {
+    /** Source symbol ID */
+    from: string;
+    /** Target symbol ID */
+    to: string;
+    /** Whether a path was found */
+    found: boolean;
+    /** All paths found (if any) */
+    paths: PathInfo[];
+}
+/**
+ * Information about a single path.
+ */
+export interface PathInfo {
+    /** Ordered list of symbol IDs in the path */
+    nodes: string[];
+    /** Relationship types between nodes */
+    relationships: RelationshipType[];
+    /** Path length (number of hops) */
+    length: number;
+    /** Cumulative weight of the path */
+    totalWeight: number;
+    /** Minimum confidence along the path */
+    minConfidence: number;
+}
+/**
+ * Result of finding related symbols.
+ */
+export interface RelatedSymbolsResult {
+    /** The symbol we searched from */
+    symbolId: string;
+    /** Directly related symbols */
+    related: Array<{
+        symbolId: string;
+        relationship: RelationshipType;
+        direction: 'outgoing' | 'incoming';
+        weight: number;
+        confidence: number;
+    }>;
+    /** Count by relationship type */
+    countByType: Record<RelationshipType, number>;
+}
+/**
+ * Centrality metrics for a symbol in the graph.
+ */
+export interface SymbolCentrality {
+    symbolId: string;
+    /** Degree centrality (number of connections) */
+    degreeCentrality: number;
+    /** In-degree (incoming relationships) */
+    inDegree: number;
+    /** Out-degree (outgoing relationships) */
+    outDegree: number;
+    /** Weighted degree (sum of weights) */
+    weightedDegree: number;
+}
+/**
+ * Graph-level statistics.
+ */
+export interface GraphStats {
+    /** Total number of symbols (nodes) */
+    nodeCount: number;
+    /** Total number of relationships (edges) */
+    edgeCount: number;
+    /** Average degree per node */
+    averageDegree: number;
+    /** Distribution of relationship types */
+    relationshipDistribution: Record<RelationshipType, number>;
+    /** Distribution of relationship categories */
+    categoryDistribution: Record<RelationshipCategory, number>;
+    /** Top N symbols by centrality */
+    topSymbolsByCentrality: SymbolCentrality[];
+    /** Graph density (edges / possible edges) */
+    density: number;
+}
+/**
+ * A relationship extracted from a document.
+ */
+export interface ExtractedRelationship {
+    /** Source entity/symbol */
+    fromEntity: string;
+    /** Target entity/symbol */
+    toEntity: string;
+    /** Detected relationship type */
+    relationshipType: RelationshipType;
+    /** Extraction confidence (0.0-1.0) */
+    confidence: number;
+    /** Text that evidences this relationship */
+    evidenceText: string;
+    /** Position in source document */
+    sourcePosition?: {
+        start: number;
+        end: number;
+        chunk?: number;
+    };
+}
+/**
+ * Result of relationship extraction from a document.
+ */
+export interface RelationshipExtractionResult {
+    /** Extracted relationships */
+    relationships: ExtractedRelationship[];
+    /** Entities mentioned that might need symbols */
+    mentionedEntities: string[];
+    /** Processing metadata */
+    metadata: {
+        documentSource: string;
+        processingTimeMs: number;
+        modelUsed: string;
+        totalChunks: number;
+    };
+}
+//# sourceMappingURL=graph-types.d.ts.map

package/dist/symbols/graph-types.d.ts.map

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

package/dist/symbols/graph-types.js

@@ -0,0 +1,93 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * PROMPTSPEAK GRAPH TYPES
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Type definitions for graph relationships between symbols.
+ * Based on research from:
+ * - Microsoft GraphRAG relationship model
+ * - Neo4j knowledge graph patterns
+ * - FIBO (Financial Industry Business Ontology)
+ * - FinDKG (Financial Dynamic Knowledge Graph)
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * Maps relationship types to their categories for filtering.
+ */
+export const RELATIONSHIP_CATEGORIES = {
+    // Causal
+    CAUSES: 'CAUSAL',
+    TRIGGERS: 'CAUSAL',
+    LEADS_TO: 'CAUSAL',
+    RESULTS_IN: 'CAUSAL',
+    ENABLES: 'CAUSAL',
+    PREVENTS: 'CAUSAL',
+    // Temporal
+    PRECEDES: 'TEMPORAL',
+    FOLLOWS: 'TEMPORAL',
+    CONCURRENT_WITH: 'TEMPORAL',
+    SUPERSEDES: 'TEMPORAL',
+    SUPERSEDED_BY: 'TEMPORAL',
+    // Hierarchical
+    PARENT_OF: 'HIERARCHICAL',
+    CHILD_OF: 'HIERARCHICAL',
+    CONTAINS: 'HIERARCHICAL',
+    PART_OF: 'HIERARCHICAL',
+    ELABORATES: 'HIERARCHICAL',
+    SUMMARIZES: 'HIERARCHICAL',
+    // Associative
+    RELATED_TO: 'ASSOCIATIVE',
+    REFERENCES: 'ASSOCIATIVE',
+    SIMILAR_TO: 'ASSOCIATIVE',
+    CONTRASTS_WITH: 'ASSOCIATIVE',
+    COMPLEMENTS: 'ASSOCIATIVE',
+    // Competitive
+    COMPETES_WITH: 'COMPETITIVE',
+    OUTPERFORMS: 'COMPETITIVE',
+    UNDERPERFORMS: 'COMPETITIVE',
+    DISRUPTS: 'COMPETITIVE',
+    CHALLENGES: 'COMPETITIVE',
+    // Dependency
+    DEPENDS_ON: 'DEPENDENCY',
+    REQUIRES: 'DEPENDENCY',
+    SUPPORTS: 'DEPENDENCY',
+    BLOCKS: 'DEPENDENCY',
+    EXPOSED_TO: 'DEPENDENCY',
+    // Ownership
+    OWNS: 'OWNERSHIP',
+    CONTROLS: 'OWNERSHIP',
+    SUBSIDIARY_OF: 'OWNERSHIP',
+    ACQUIRED_BY: 'OWNERSHIP',
+    MERGED_WITH: 'OWNERSHIP',
+    PARTNERS_WITH: 'OWNERSHIP',
+    // Regulatory
+    REGULATED_BY: 'REGULATORY',
+    COMPLIANT_WITH: 'REGULATORY',
+    SUBJECT_TO: 'REGULATORY',
+    FILED_WITH: 'REGULATORY',
+    AUDITED_BY: 'REGULATORY',
+};
+/**
+ * Inverse relationship mappings for bidirectional traversal.
+ */
+export const INVERSE_RELATIONSHIPS = {
+    CAUSES: 'RESULTS_IN',
+    RESULTS_IN: 'CAUSES',
+    TRIGGERS: 'RESULTS_IN',
+    PRECEDES: 'FOLLOWS',
+    FOLLOWS: 'PRECEDES',
+    SUPERSEDES: 'SUPERSEDED_BY',
+    SUPERSEDED_BY: 'SUPERSEDES',
+    PARENT_OF: 'CHILD_OF',
+    CHILD_OF: 'PARENT_OF',
+    CONTAINS: 'PART_OF',
+    PART_OF: 'CONTAINS',
+    ELABORATES: 'SUMMARIZES',
+    SUMMARIZES: 'ELABORATES',
+    OWNS: 'SUBSIDIARY_OF',
+    SUBSIDIARY_OF: 'OWNS',
+    CONTROLS: 'SUBSIDIARY_OF',
+    ACQUIRED_BY: 'OWNS',
+};
+//# sourceMappingURL=graph-types.js.map

package/dist/symbols/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../src/symbols/graph-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoFH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmD;IACrF,SAAS;IACT,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAElB,WAAW;IACX,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,UAAU;IACnB,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE,UAAU;IACtB,aAAa,EAAE,UAAU;IAEzB,eAAe;IACf,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;IAE1B,cAAc;IACd,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,aAAa;IAC7B,WAAW,EAAE,aAAa;IAE1B,cAAc;IACd,aAAa,EAAE,aAAa;IAC5B,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,aAAa;IACvB,UAAU,EAAE,aAAa;IAEzB,aAAa;IACb,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,YAAY;IAExB,YAAY;IACZ,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,WAAW;IACrB,aAAa,EAAE,WAAW;IAC1B,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,WAAW;IAE1B,aAAa;IACb,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,YAAY;IAC5B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwD;IACxF,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,YAAY;IAC3B,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,eAAe;IACrB,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,eAAe;IACzB,WAAW,EAAE,MAAM;CACpB,CAAC"}

package/dist/symbols/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * PROMPTSPEAK DIRECTIVE SYMBOL MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Exports for the directive symbol registry system.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+export * from './types.js';
+export { SymbolManager, initializeSymbolManager, getSymbolManager, } from './manager.js';
+export { symbolToolDefinitions, handleSymbolTool, formatSymbolForPrompt, } from './tools.js';
+export { sanitizeContent, validateSymbolContent, verifySymbolUsage, calculateEntropy, wrapWithSafetyDelimiters, normalizeUnicode, detectUnicodeEvasion, SAFETY_HEADER, SAFETY_FOOTER, SANITIZER_CONFIG, sanitizer, type SanitizationResult, type FullValidationResult, type InjectionViolation, type ViolationSeverity, type UsageVerificationResult, } from './sanitizer.js';
+export { AuditLogger, initializeAuditLogger, getAuditLogger, type AuditEntry, type AuditEventType, type AuditStats, } from './audit.js';
+export { SymbolDatabase, initializeDatabase, getDatabase, closeDatabase, type SymbolRow, type AuditRow, type DatabaseStats, } from './database.js';
+export * from './graph-types.js';
+export { GraphManager, getGraphManager, resetGraphManager, } from './graph-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/symbols/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/symbols/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAGvB,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/symbols/index.js

@@ -0,0 +1,26 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * PROMPTSPEAK DIRECTIVE SYMBOL MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Exports for the directive symbol registry system.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+// Types
+export * from './types.js';
+// Manager
+export { SymbolManager, initializeSymbolManager, getSymbolManager, } from './manager.js';
+// MCP Tools
+export { symbolToolDefinitions, handleSymbolTool, formatSymbolForPrompt, } from './tools.js';
+// Security: Sanitizer
+export { sanitizeContent, validateSymbolContent, verifySymbolUsage, calculateEntropy, wrapWithSafetyDelimiters, normalizeUnicode, detectUnicodeEvasion, SAFETY_HEADER, SAFETY_FOOTER, SANITIZER_CONFIG, sanitizer, } from './sanitizer.js';
+// Security: Audit Logging
+export { AuditLogger, initializeAuditLogger, getAuditLogger, } from './audit.js';
+// Database (SQLite backend)
+export { SymbolDatabase, initializeDatabase, getDatabase, closeDatabase, } from './database.js';
+// Graph Types
+export * from './graph-types.js';
+// Graph Manager
+export { GraphManager, getGraphManager, resetGraphManager, } from './graph-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/symbols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/symbols/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,UAAU;AACV,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY;AACZ,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,GAMV,MAAM,gBAAgB,CAAC;AAExB,0BAA0B;AAC1B,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,cAAc,GAIf,MAAM,YAAY,CAAC;AAEpB,4BAA4B;AAC5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,GAId,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/symbols/manager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * PROMPTSPEAK SYMBOL MANAGER
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Manages storage, retrieval, and validation of directive symbols.
+ * Now backed by SQLite for ACID transactions, concurrent safety, and performance.
+ *
+ * Migration from JSON to SQLite provides:
+ * - Atomic commits (no partial writes)
+ * - WAL mode for concurrent read/write
+ * - Indexed queries (O(log n) vs O(n))
+ * - Built-in integrity constraints
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import type { DirectiveSymbol, SymbolCategory, SymbolRegistry, SymbolIdValidation, CreateSymbolRequest, CreateSymbolResponse, GetSymbolRequest, GetSymbolResponse, UpdateSymbolRequest, UpdateSymbolResponse, ListSymbolsRequest, ListSymbolsResponse, DeleteSymbolRequest, DeleteSymbolResponse, ImportSymbolsRequest, ImportSymbolsResponse } from './types.js';
+export declare class SymbolManager {
+    private symbolsRoot;
+    private db;
+    private cache;
+    constructor(symbolsRoot: string);
+    private migrateFromJsonIfNeeded;
+    validateSymbolId(symbolId: string): SymbolIdValidation;
+    calculateHash(symbol: Partial<DirectiveSymbol>): string;
+    create(request: CreateSymbolRequest): CreateSymbolResponse;
+    get(request: GetSymbolRequest): GetSymbolResponse;
+    update(request: UpdateSymbolRequest): UpdateSymbolResponse;
+    list(request: ListSymbolsRequest): ListSymbolsResponse;
+    delete(request: DeleteSymbolRequest): DeleteSymbolResponse;
+    import(request: ImportSymbolsRequest): ImportSymbolsResponse;
+    /**
+     * Export all symbols to JSON format for backup/portability
+     */
+    exportToJson(outputPath?: string): {
+        success: boolean;
+        path?: string;
+        count: number;
+        error?: string;
+    };
+    /**
+     * Verify a symbol claim - update its epistemic status based on human review.
+     * This is used to promote claims from INFERENCE → VERIFIED or mark as DISPUTED.
+     */
+    verifySymbol(request: {
+        symbolId: string;
+        new_status: 'VERIFIED' | 'DISPUTED' | 'CORROBORATED';
+        new_confidence?: number;
+        evidence_added?: string[];
+        reviewer: string;
+        notes?: string;
+    }): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * List symbols that require human review due to epistemic concerns.
+     */
+    listUnverifiedSymbols(request: {
+        claim_type?: string;
+        min_confidence?: number;
+        max_confidence?: number;
+        limit?: number;
+        offset?: number;
+    }): {
+        symbols: Array<{
+            symbolId: string;
+            category: SymbolCategory;
+            commanders_intent: string;
+            epistemic_status: string;
+            confidence: number;
+            review_reason?: string;
+            triggered_patterns?: string[];
+            created_at: string;
+        }>;
+        total: number;
+        has_more: boolean;
+    };
+    /**
+     * Add an alternative explanation to a symbol's evidence basis.
+     * This is crucial for preventing false positives in accusatory findings.
+     */
+    addAlternativeExplanation(request: {
+        symbolId: string;
+        alternative: string;
+        likelihood: number;
+        reasoning?: string;
+        added_by: string;
+    }): {
+        success: boolean;
+        error?: string;
+    };
+    getStats(): SymbolRegistry['stats'];
+    clearCache(): void;
+    reload(): void;
+    /**
+     * Get database-specific stats
+     */
+    getDatabaseStats(): import("./database.js").DatabaseStats;
+    /**
+     * Optimize the database
+     */
+    optimizeDatabase(): void;
+    /**
+     * Check database integrity
+     */
+    checkIntegrity(): {
+        ok: boolean;
+        errors: string[];
+    };
+}
+export declare function initializeSymbolManager(symbolsRoot: string): SymbolManager;
+export declare function getSymbolManager(): SymbolManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/symbols/manager.d.ts.map

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