a2a-memory 0.12.26 → 0.12.28

package/dist/db/database.d.ts

@@ -80,6 +80,11 @@ export declare class MemoryDatabase {
         tier?: MemoryTier;
         projectPath?: string;
     }): number;
+    /**
+     * #57 (ADR-048 Phase 1): 작업셋(active) 조건 단일 source — MERGE 사본(merged_into)과
+     * ARCHIVE(archived_at)는 기본 검색·주입에서 제외. 명시 옵션/refine CLI로만 접근.
+     */
+    private activeFilter;
     listMemories(options?: {
         limit?: number;
         offset?: number;
@@ -88,6 +93,7 @@ export declare class MemoryDatabase {
         projectPath?: string;
         excludeParents?: boolean;
         includeInvalid?: boolean;
+        includeInactive?: boolean;
     }): Memory[];
     searchByFTS(query: string, limit?: number, options?: {
         projectPath?: string;
@@ -211,6 +217,172 @@ export declare class MemoryDatabase {
     }>;
     saveEmbedding(memoryId: string, embedding: number[]): void;
     getEmbedding(memoryId: string): number[] | null;
+    /**
+     * #43: 저장 quantization level에 따른 embedding 복원 단일 source —
+     * getEmbedding(단건)과 searchByVector(후보 배치 JOIN)가 공유한다.
+     * int8인데 stats가 없으면 복원 불가 → null (검색 경로에서는 후보 제외).
+     */
+    private dequantizeEmbedding;
+    /** 56b: embedding 보유 메모리 전체를 dequantize하여 batch 로드 (sim k-NN 입력). */
+    getAllEmbeddingRows(): Array<{
+        id: string;
+        embedding: number[];
+    }>;
+    /** type별 엣지 전체 교체 (clear + batch insert, 단일 트랜잭션). shadow 재계산용. */
+    replaceEdges(type: string, edges: Array<{
+        src: string;
+        dst: string;
+        weight: number;
+    }>): number;
+    /** type별 엣지 카운트 (shadow 관찰). */
+    countEdgesByType(): Array<{
+        type: string;
+        count: number;
+    }>;
+    /** 56e: type별 엣지 read — per-memory 신호 계산 입력 (sim uniqueness/generic/dup, ref/cooc local). */
+    getEdges(type: string): Array<{
+        src: string;
+        dst: string;
+        weight: number;
+    }>;
+    /** 56e: per-memory 신호 계산 입력 (activation/dump). content는 LENGTH만 — 본문 미로딩. */
+    getSignalInputRows(): Array<{
+        id: string;
+        access_count: number;
+        created_at: string;
+        last_accessed_at: string | null;
+        content_length: number;
+        quality_score: number | null;
+    }>;
+    /** 56e: per-memory 신호 컬럼 batch 기록 (shadow, 단일 트랜잭션 — 액션 0). */
+    updateSignals(updates: Array<{
+        id: string;
+        activation: number;
+        uniqueness: number;
+        generic_penalty: number;
+        dup_score: number;
+        dump_score: number;
+        reliability: number;
+        cluster_id: string | null;
+    }>, computedAt: string): number;
+    /** 56e/g: 계산된 per-memory 신호 read (shadow 검증 + 56g 분포 관찰. computed된 것만). */
+    getComputedSignals(): Array<{
+        id: string;
+        activation: number | null;
+        uniqueness: number | null;
+        generic_penalty: number | null;
+        dup_score: number | null;
+        dump_score: number | null;
+        reliability: number | null;
+        cluster_id: string | null;
+    }>;
+    /** 56f: rank 계산 입력 — 56e 신호 + teleport prior(quality/tier) + retention/prune 입력. content 미로딩. */
+    getRankInputRows(): Array<{
+        id: string;
+        tier: string;
+        category: string;
+        quality_score: number | null;
+        access_count: number;
+        created_at: string;
+        last_accessed_at: string | null;
+        activation: number | null;
+        uniqueness: number | null;
+        generic_penalty: number | null;
+        dup_score: number | null;
+        dump_score: number | null;
+        reliability: number | null;
+        cluster_id: string | null;
+    }>;
+    /** 56f: rank/retention/prune/decision batch 기록 (shadow, 단일 트랜잭션 — 액션 0). */
+    updateRanks(updates: Array<{
+        id: string;
+        struct_rank: number;
+        memoryrank: number;
+        retention_score: number;
+        prune_score: number;
+        decision: string;
+    }>, computedAt: string): number;
+    /**
+     * #57 (ADR-048 Phase 1 — 섹션 7.4/7.5): MERGE/ARCHIVE reversible 실행.
+     * - MERGE: decision='MERGE' + cluster_id 클러스터별 canonical(argmax memoryrank·quality)
+     *   1벌 유지, 나머지 merged_into=canonical + access_count는 canonical에 합산.
+     * - ARCHIVE: decision='ARCHIVE' → archived_at 설정 (기본 작업셋 제외, 명시 조회 가능).
+     * - hard rule 재검증(방어 심층 — DecisionGate가 이미 적용했으나 실행 시점 이중 가드):
+     *   보호 카테고리/태그 메모리는 MERGE 사본 전환 대상에서 제외 (canonical 지위는 무관).
+     * - 자동 DELETE 없음 — DELETE_CANDIDATE는 L1 승인 배치(#58) 전용 (섹션 7.5).
+     * - revert 시 access_count 합산은 역산하지 않음 (사용 통계 통합값 유지 — 무해).
+     */
+    applyPhase1Refine(dryRun?: boolean): {
+        clusters: number;
+        merged: number;
+        archived: number;
+        hardRuleSkipped: number;
+        singletonClusters: number;
+    };
+    /**
+     * #58 (ADR-048 섹션 7.5): DELETE 라벨 항목을 L1 승인 큐에 등재.
+     * proposed_action='DELETE'만 대상 — 실제 삭제는 executePruneBatch(사용자 L1 승인 후)에서만.
+     */
+    fillPruneQueue(entries: Array<{
+        memoryId: string;
+        pruneScore: number | null;
+        reason: string;
+    }>): number;
+    listPruneQueue(status?: string): Array<{
+        memory_id: string;
+        prune_score: number | null;
+        reason: string | null;
+        proposed_action: string;
+        status: string;
+        created_at: string;
+    }>;
+    /**
+     * #58: L1 승인 후 batch 삭제 실행 — pending_approval + DELETE 항목을 deleteMemories로
+     * 삭제(child cascade + tombstone 전파는 기존 경로 재사용) 후 큐 status 갱신.
+     * ⚠️ 사용자 L1 승인 없이 호출 금지 (CLI --approve 게이트).
+     */
+    executePruneBatch(): {
+        deleted: number;
+    };
+    /** #57: Phase 1 전체 되돌림 — merged_into/archived_at 해제 (access 합산은 유지). */
+    revertPhase1Refine(): {
+        unmerged: number;
+        unarchived: number;
+    };
+    /** 56f/g: 계산된 rank/decision read (shadow 검증 + 56g 분포/상관 관찰). */
+    getComputedRanks(): Array<{
+        id: string;
+        struct_rank: number | null;
+        memoryrank: number | null;
+        retention_score: number | null;
+        prune_score: number | null;
+        decision: string | null;
+    }>;
+    /** 56c: injection_hits.matched_memory_ids (JSON 배열) 중 2+ 매칭 세션 집합. */
+    getInjectionMatchedSets(): string[][];
+    /** 56c: memory_usage_events session_id별 공동 사용 메모리 집합 (2+). */
+    getUsageSessionSets(): string[][];
+    /** 56c: (memory_id, tag) 전체 페어 — tag-cooc + hub IDF/PPMI 필터 입력. */
+    getTagMemoryPairs(): Array<{
+        memory_id: string;
+        tag: string;
+    }>;
+    /** 56d: memories.session_id 공유 2+ 메모리 집합 (temp 엣지 — 동일 세션 공동 생성, 대칭). */
+    getSessionSharedSets(): string[][];
+    /**
+     * 56d: content 내 `[[...]]` 보유 메모리 (id, content) — ref 엣지 파싱 입력.
+     * bash test 문법(`[[ -n ... ]]` 등) 제외 + slug→id resolve는 edge-builder에서 수행.
+     * (memories에 name/slug 컬럼 부재 — ADR 섹션 15 Q3 미확정. resolve율 shadow 관찰.)
+     */
+    getRefLinkSources(): Array<{
+        id: string;
+        content: string;
+    }>;
+    /**
+     * 56d: slug substring을 content에 포함하는 memory id 목록 (ref resolve, self 제외).
+     * LIKE 와일드카드(`%`/`_`) 이스케이프 — slug의 underscore를 literal로 매칭.
+     */
+    findMemoryIdsContaining(needle: string, excludeId: string): string[];
     getMemoriesOlderThan(days: number): Memory[];
     getMemoriesWithoutEmbedding(limit?: number): Memory[];
     deleteMemories(ids: string[]): number;