synapse-kit 0.0.0-stage → 0.3.1

package/dist/memory/causal-graveyard.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 실패 가설 및 함정(Trap) 레코드 규격 (Negative Knowledge)
+ */
+export interface FailureHypothesis {
+    readonly id: string;
+    readonly title: string;
+    readonly failedApproach: string;
+    readonly errorSignature?: string;
+    readonly rootCause: string;
+    readonly counterMeasure: string;
+    readonly triggerKeywords: readonly string[];
+    readonly triggerFiles?: readonly string[];
+    readonly environment?: string;
+    readonly hitCount?: number;
+    readonly createdAt: string;
+    readonly lastEncounteredAt?: string;
+    readonly trapPattern?: string;
+    readonly domain?: string;
+    readonly severity?: string;
+    readonly reason?: string;
+    readonly safeAlternative?: string;
+    readonly avoidFiles?: readonly string[];
+}
+/**
+ * 지뢰(Trap) 사전 탐지 결과 규격
+ */
+export interface TrapWarning {
+    readonly trapId: string;
+    readonly title: string;
+    readonly riskLevel: 'CRITICAL' | 'WARNING' | 'NOTICE';
+    readonly matchedBy: 'keyword' | 'file' | 'error_signature';
+    readonly matchedPattern: string;
+    readonly whyItFails: string;
+    readonly recommendedFix: string;
+}
+export type TrapScanResult = TrapWarning[] & {
+    readonly trapped: boolean;
+    readonly triggeredTraps: readonly TrapWarning[];
+    readonly highestSeverity: 'CRITICAL' | 'WARNING' | 'NOTICE' | 'NONE';
+};
+/**
+ * 실패 가설 묘지 데이터베이스 규격
+ */
+export interface GraveyardDatabase {
+    readonly version: string;
+    readonly updatedAt: string;
+    readonly totalTraps: number;
+    readonly traps: readonly FailureHypothesis[];
+}
+/**
+ * 실패 가설 묘지(Negative Memory) 관리 및 지뢰 사전 탐지 엔진 클래스 (SRP 준수)
+ */
+export declare class CausalGraveyardStore {
+    private readonly dbPath;
+    private database;
+    private lastMtimeMs;
+    constructor(customPathOrMemoryStore?: string | unknown);
+    private loadDatabase;
+    reloadIfNeeded(): void;
+    private saveDatabase;
+    /**
+     * 신규 실패 가설(Trap) 등록 또는 갱신
+     */
+    assertTrap(input: any): FailureHypothesis;
+    /**
+     * 작업 컨텍스트(코드, 명령어, 파일, 텍스트)에서 이미 실패했던 지뢰(Trap)가 있는지 사전 스캔
+     */
+    scanTraps(query: {
+        text?: string;
+        code?: string;
+        files?: readonly string[];
+        keywords?: readonly string[];
+    }): TrapScanResult;
+    /**
+     * 저장된 모든 실패 가설 목록 조회
+     */
+    listTraps(): FailureHypothesis[];
+    /**
+     * 하위 호환 alias
+     */
+    getAllTraps(): FailureHypothesis[];
+    /**
+     * 특정 실패 가설 삭제
+     */
+    deleteTrap(id: string): boolean;
+    /**
+     * 지뢰 경고 프롬프트 포맷터
+     */
+    static formatWarningsForAgent(warnings: readonly TrapWarning[]): string;
+    /**
+     * 하위 호환 alias
+     */
+    static formatTrapWarnings(warnings: any): string;
+}

package/dist/memory/causal-lens.d.ts

@@ -0,0 +1,133 @@
+import { CausalMemoryStore } from './causal-store';
+import { ContextCheckpointStore } from './causal-context';
+import { CausalGraveyardStore } from './causal-graveyard';
+import { CausalTimeSeriesEngine } from './causal-timeseries';
+/**
+ * 렌즈 내보내기 결과 보고서 규격
+ */
+export interface LensExportResult {
+    readonly success: boolean;
+    readonly vaultPath: string;
+    readonly exportedRules: number;
+    readonly exportedGraveyard: number;
+    readonly exportedCheckpoints: number;
+    readonly canvasGenerated: boolean;
+    readonly timelineGenerated: boolean;
+    readonly durationMs: number;
+    readonly error?: string;
+}
+/**
+ * 렌즈 가져오기 결과 보고서 규격
+ */
+export interface LensImportResult {
+    readonly success: boolean;
+    readonly vaultPath: string;
+    readonly importedRules: number;
+    readonly importedGraveyard: number;
+    readonly durationMs: number;
+    readonly error?: string;
+}
+/**
+ * 양방향 동기화 결과 보고서 규격
+ */
+export interface LensSyncResult {
+    readonly success: boolean;
+    readonly exportResult: LensExportResult;
+    readonly importResult: LensImportResult;
+    readonly syncedAt: string;
+}
+/**
+ * 옵시디언 캔버스 노드 규격
+ */
+export interface ObsidianCanvasNode {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly type: 'text' | 'file';
+    readonly text?: string;
+    readonly file?: string;
+    readonly color?: string;
+}
+/**
+ * 옵시디언 캔버스 엣지(간선) 규격
+ */
+export interface ObsidianCanvasEdge {
+    readonly id: string;
+    readonly fromNode: string;
+    readonly fromSide: 'top' | 'right' | 'bottom' | 'left';
+    readonly toNode: string;
+    readonly toSide: 'top' | 'right' | 'bottom' | 'left';
+    readonly label?: string;
+    readonly color?: string;
+}
+/**
+ * 옵시디언 캔버스 문서 규격 (.canvas)
+ */
+export interface ObsidianCanvasDocument {
+    readonly nodes: readonly ObsidianCanvasNode[];
+    readonly edges: readonly ObsidianCanvasEdge[];
+}
+/**
+ * 옵시디언(Obsidian) 지식 베이스와 인과율 메모리를 양방향 연동하는 렌즈 엔진 클래스 (SRP 준수)
+ */
+export declare class CausalObsidianLensEngine {
+    private readonly memoryStore;
+    private readonly contextStore;
+    private readonly graveyardStore;
+    private readonly timeSeriesEngine;
+    constructor(memoryStore?: CausalMemoryStore, contextStore?: ContextCheckpointStore, graveyardStore?: CausalGraveyardStore, timeSeriesEngine?: CausalTimeSeriesEngine);
+    /**
+     * 지정된 옵시디언 볼트 경로로 인과율 메모리 전체(규칙, 함정, 스냅샷, 타임라인, 캔버스)를 마크다운으로 내보내기
+     */
+    exportToVault(vaultRoot?: string): Promise<LensExportResult>;
+    /**
+     * 옵시디언 볼트의 마크다운 파일들을 스캔하여 인과율 규칙 및 함정 데이터로 역가져오기 (Import)
+     */
+    importFromVault(vaultRoot?: string): Promise<LensImportResult>;
+    /**
+     * 볼트와의 양방향 동기화 (최신성 기반 안전한 병합)
+     */
+    syncWithVault(vaultRoot?: string): Promise<LensSyncResult>;
+    /**
+     * 단일 CausalRule을 Obsidian 마크다운으로 변환
+     */
+    private renderRuleToMarkdown;
+    /**
+     * 단일 FailureHypothesis(함정)를 Obsidian 마크다운으로 변환
+     */
+    private renderTrapToMarkdown;
+    /**
+     * 단일 컨텍스트 체크포인트를 Obsidian 마크다운으로 변환
+     */
+    private renderCheckpointToMarkdown;
+    /**
+     * 타임라인 마크다운 렌더링
+     */
+    private renderTimelineMarkdown;
+    /**
+     * 옵시디언 캔버스(Canvas) JSON 문서 생성
+     */
+    private generateCanvasDocument;
+    /**
+     * 도메인별 캔버스 색상 코드 매핑 (1: 빨강, 2: 주황, 3: 노랑, 4: 초록, 5: 파랑, 6: 보라)
+     */
+    private getColorForDomain;
+    /**
+     * 마크다운 텍스트로부터 CausalRule 역파싱
+     */
+    private parseRuleMarkdown;
+    /**
+     * 마크다운 텍스트로부터 FailureHypothesis(함정) 역파싱
+     */
+    private parseTrapMarkdown;
+    /**
+     * 원자적 파일 쓰기 (임시 파일 생성 후 renameSync로 덮어쓰기하여 정전/중단 시 손상 0% 보장)
+     */
+    private atomicWriteFile;
+    /**
+     * 파일명에 사용할 수 없는 특수문자 및 Path Traversal 시퀀스 제거
+     */
+    private sanitizeFileName;
+}