synapse-kit 0.0.0-stage → 0.3.1

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

@@ -0,0 +1,11 @@
+/**
+ * 구형 지식 그래프(memory_backup)를 차세대 인과율 메모리(Causal Memory 2.1)로 무손실 변환합니다.
+ * 엔티티뿐만 아니라 모든 인과 간선(Relations)을 100% 보존하며, 도메인 오분류를 방지합니다.
+ */
+export declare function migrateLegacyMemoryGraph(sourceBackupPath?: string, targetGlobalPath?: string, targetLocalPath?: string): {
+    readonly ok: boolean;
+    readonly totalRules: number;
+    readonly totalRelations: number;
+    readonly alwaysActiveCount: number;
+    readonly domains: readonly string[];
+};

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

@@ -0,0 +1,53 @@
+import type { CausalQueryOptions, CausalResonanceResult } from './causal-store';
+export interface TailscalePeerNode {
+    readonly id: string;
+    readonly hostName: string;
+    readonly ip: string;
+    readonly os: string;
+    readonly online: boolean;
+    readonly active: boolean;
+    readonly isSelf: boolean;
+}
+export interface PeerHealthResult {
+    readonly host: string;
+    readonly port: number;
+    readonly url: string;
+    readonly reachable: boolean;
+    readonly rttMs: number;
+    readonly version?: string;
+    readonly totalRules?: number;
+    readonly totalRelations?: number;
+    readonly error?: string;
+}
+export interface PeerSyncResult {
+    readonly targetHost: string;
+    readonly direction: 'pull' | 'push';
+    readonly success: boolean;
+    readonly durationMs: number;
+    readonly addedRules?: number;
+    readonly updatedRules?: number;
+    readonly addedRelations?: number;
+    readonly totalRules?: number;
+    readonly totalRelations?: number;
+    readonly error?: string;
+}
+/**
+ * Tailscale CLI 상태를 파싱하여 활성 피어 목록을 조회합니다.
+ */
+export declare function getTailscalePeers(): Promise<{
+    selfIp?: string;
+    selfHost?: string;
+    peers: TailscalePeerNode[];
+}>;
+/**
+ * 대상 호스트의 Causal Memory Daemon 헬스체크 및 RTT 측정
+ */
+export declare function pingPeer(host: string, port?: number): Promise<PeerHealthResult>;
+/**
+ * 원격 Causal Memory Daemon에 공명 쿼리 실행
+ */
+export declare function queryRemotePeer(remoteUrl: string, options: CausalQueryOptions): Promise<CausalResonanceResult>;
+/**
+ * 피어 노드 간 인과율 규칙 및 간선 동기화 (Sync)
+ */
+export declare function syncWithPeer(remoteHost: string, port?: number, direction?: 'pull' | 'push', dbPath?: string): Promise<PeerSyncResult>;

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

@@ -0,0 +1,42 @@
+import { CausalMemoryStore } from './causal-store';
+import { ContextCheckpointStore } from './causal-context';
+/**
+ * 연쇄 파급 영향 노드 규격
+ */
+export interface AffectedNode {
+    readonly name: string;
+    readonly domain: string;
+    readonly hopLevel: number;
+    readonly relationType: string;
+    readonly riskScore: number;
+    readonly riskReason: string;
+    readonly requiredInvariants: readonly string[];
+}
+/**
+ * 인과 연쇄 폭발 반경(Blast Radius) 분석 보고서 규격
+ */
+export interface BlastRadiusReport {
+    readonly triggerFiles: readonly string[];
+    readonly overallRisk: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    readonly maxRiskScore: number;
+    readonly affectedNodes: readonly AffectedNode[];
+    readonly prefetchedInvariants: readonly string[];
+    readonly suggestedTargetFiles: readonly string[];
+    readonly durationMs: number;
+}
+/**
+ * 인과 연쇄 파급 예측 및 Blast Radius 분석 엔진 클래스 (SRP 준수)
+ */
+export declare class CausalPredictorEngine {
+    private readonly memoryStore;
+    private readonly contextStore;
+    constructor(memoryStore?: CausalMemoryStore, contextStore?: ContextCheckpointStore);
+    /**
+     * 파일 수정 시 2~3단계 뒤에 발생할 연쇄 파급 반경 계산
+     */
+    analyzeBlastRadius(files: readonly string[], maxHops?: number): BlastRadiusReport;
+    /**
+     * 예측 보고서 마크다운 포맷터
+     */
+    static formatPredictReport(report: BlastRadiusReport): string;
+}

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

@@ -0,0 +1,21 @@
+import { type CausalResonanceResult } from './causal-store';
+/**
+ * Git 작업 트리의 변경 파일 목록 자동 추출
+ */
+export declare function detectModifiedFiles(cwd?: string): Promise<string[]>;
+/**
+ * 인과율 공명 쿼리 실행기
+ */
+export declare function runCausalQuery(rawOptions: {
+    files?: string[];
+    keywords?: string[];
+    command?: string;
+    domain?: string;
+    autoGit?: boolean;
+    cwd?: string;
+    propagateRelations?: boolean;
+}, storeCustomPath?: string): Promise<CausalResonanceResult>;
+/**
+ * AI 에이전트 주입용 초경량 마크다운/텍스트 포맷터
+ */
+export declare function formatResonanceForAgent(result: CausalResonanceResult, compact?: boolean): string;