promptkaizen-agent 0.2.0 → 0.3.0

package/dist/store/local-store.d.ts

@@ -0,0 +1,167 @@
+import type { ParsedEntry } from '../types';
+export declare const DEFAULT_DB_PATH: string;
+/** ブロックイベント (PreToolUse deny)。生機密を含まない。 */
+export interface StoredBlock {
+    recordedAt: string;
+    sessionId: string | null;
+    cwd: string | null;
+    toolName: string | null;
+    detections: unknown[];
+}
+export interface SearchOptions {
+    /** 結果上限 (既定 20)。 */
+    limit?: number;
+    /** セッションで絞り込む。 */
+    sessionId?: string;
+    /** cwd (完全一致) で絞り込む (pk_recall の scope=project / Issue #95)。 */
+    cwd?: string;
+}
+export interface EventRow {
+    id: number;
+    sessionId: string | null;
+    source: string;
+    type: string | null;
+    toolName: string | null;
+    cwd: string | null;
+    ts: string | null;
+    recordedAt: string;
+    body: string | null;
+}
+export interface StoreStats {
+    events: number;
+    sessions: number;
+    blocks: number;
+    unsent: number;
+    dbPath: string;
+    sizeBytes: number;
+}
+/** セッション状態スナップショット (Issue #95 / R3)。summary/detailJson はマスク済みであること。 */
+export interface StoredSnapshot {
+    sessionId: string | null;
+    cwd: string | null;
+    trigger: 'pre_compact' | 'stop';
+    createdAt: string;
+    summary: string;
+    detailJson: string | null;
+}
+/** 退避したツール出力 (Issue #93 / R1)。body はマスク済みであること。 */
+export interface StoredToolOutputRef {
+    refId: string;
+    sessionId: string | null;
+    toolName: string | null;
+    cwd: string | null;
+    createdAt: string;
+    originalBytes: number;
+    originalTokens: number;
+    replacedTokens: number;
+    savedTokens: number;
+    body: string;
+    /** Read 特化 (#110): 退避元のファイルパス (Read/NotebookRead のみ)。 */
+    filePath?: string | null;
+    /** Read 特化 (#110): 退避内容 (マスク後) の sha256。再読込キャッシュ判定に使う。 */
+    contentHash?: string | null;
+    /** Read 特化 (#110): 'offload' = 退避 / 'cache_hit' = 再読込キャッシュ種。既定 offload。 */
+    kind?: 'offload' | 'cache_hit';
+}
+/** read_cache の 1 行 (session × file の直近 Read 状態)。 */
+export interface ReadCacheRow {
+    sessionId: string;
+    filePath: string;
+    contentHash: string;
+    refId: string | null;
+    updatedAt: string;
+    invalidated: boolean;
+}
+/**
+ * better-sqlite3 ベースのローカルストア。同期 API なので hook の同期判定にも使える。
+ */
+export declare class LocalStore {
+    private readonly db;
+    readonly dbPath: string;
+    constructor(dbPath?: string);
+    /** PRAGMA user_version を見て差分マイグレーションを適用する。 */
+    private migrate;
+    /** PRAGMA table_info を見て、未存在の列だけ ALTER TABLE ADD COLUMN する。 */
+    private addColumnIfMissing;
+    /**
+     * マスク済み entry を 1 件保存し rowid を返す。session も upsert する。
+     * body は raw からマスク済み文字列を連結したもの (検索用)。
+     */
+    recordEvent(entry: ParsedEntry, recordedAt?: string): number;
+    /** 複数 entry をトランザクションで保存し rowid 配列を返す。 */
+    recordEvents(entries: ParsedEntry[], recordedAt?: string): number[];
+    private readonly txRecord;
+    /** PreToolUse の deny を記録し、session の block_count を増やす。 */
+    recordBlock(block: StoredBlock): number;
+    private bumpSession;
+    /** 未送信 event を取得 (送信対象の決定に使う)。 */
+    unsentEvents(limit?: number): EventRow[];
+    /** 送信済みフラグを立てる。 */
+    markSent(ids: number[]): void;
+    /**
+     * ローカル全文検索。trigram は 3 文字以上のクエリが必要なので、
+     * 2 文字以下は LIKE にフォールバックする。マスク済み本文のみが対象。
+     */
+    search(query: string, opts?: SearchOptions): EventRow[];
+    /** セッションの直近 event (PreToolUse の同期文脈参照用)。 */
+    recentBySession(sessionId: string, limit?: number): EventRow[];
+    /** 退避したツール出力を 1 件保存する。body は呼び出し側で必ずマスク済みであること。 */
+    recordToolOutputRef(ref: StoredToolOutputRef): void;
+    /** ref_id で退避内容を取得する (pk_fetch の全文取得)。 */
+    getToolOutputRef(refId: string): StoredToolOutputRef | null;
+    /** (session, file) の直近 Read 状態を取得する。未記録なら null。 */
+    getReadCache(sessionId: string, filePath: string): ReadCacheRow | null;
+    /** (session, file) の Read 状態を upsert する (内容ハッシュ更新時は invalidated を 0 に戻す)。 */
+    upsertReadCache(row: {
+        sessionId: string;
+        filePath: string;
+        contentHash: string;
+        refId: string | null;
+        updatedAt: string;
+    }): void;
+    /** (session, file) のキャッシュを無効化する (Edit/Write 後)。次回 Read は全文を返す。 */
+    invalidateReadCache(sessionId: string, filePath: string): void;
+    /**
+     * ローカル衛生 (#110): TTL 超過の退避レコード / キャッシュ行を削除し、
+     * tool_output_refs が maxRefs を超える分を古い順に削除する。戻り値は削除した行数。
+     */
+    pruneReductionStore(opts: {
+        ttlDays: number;
+        maxRefs: number;
+        now?: Date;
+    }): number;
+    /**
+     * 退避内容を query で絞り込む (pk_fetch の絞り込み取得)。
+     * FTS5 (trigram) で該当 ref に query がヒットするか確認したうえで、
+     * マッチ行 ± contextLines 行を抜粋して返す (ログ向けには行コンテキストが有用)。
+     * 3 文字未満のクエリは trigram の制約により行スキャンのみで判定する。
+     */
+    queryToolOutputRef(refId: string, query: string, opts?: {
+        maxMatches?: number;
+        contextLines?: number;
+    }): {
+        excerpts: string[];
+        totalMatches: number;
+    } | null;
+    /** スナップショットを保存する。summary / detailJson は必ずマスク済みであること。 */
+    recordSnapshot(s: StoredSnapshot): number;
+    /**
+     * 復元対象のスナップショットを返す。同一セッションを優先し、無ければ
+     * 同一 cwd の最新を返す (maxAgeMs より古いものは対象外 = 古い文脈を注入しない)。
+     */
+    latestSnapshot(p: {
+        sessionId?: string | null;
+        cwd?: string | null;
+        maxAgeMs?: number;
+    }): StoredSnapshot | null;
+    /** スナップショット要約の全文検索 (pk_recall 用)。3 文字未満は LIKE フォールバック。 */
+    searchSnapshots(query: string, opts?: {
+        limit?: number;
+        cwd?: string;
+    }): StoredSnapshot[];
+    /** cwd の直近セッション ID (pk_recall の scope=current_session 用)。 */
+    latestSessionIdForCwd(cwd: string): string | null;
+    stats(): StoreStats;
+    close(): void;
+}
+//# sourceMappingURL=local-store.d.ts.map

package/dist/store/local-store.d.ts.map

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