watashi-db 0.0.7 → 0.0.8

package/dist/database/queries-core.d.ts

@@ -4,10 +4,13 @@
  * 後方互換ラッパーは queries.ts を参照。
  */
 import type Database from "better-sqlite3";
-import type { ClaimRow, ClaimHistoryRow, ClaimRelationRow, ClaimEvidenceRow, ClaimCheckRow, DecisionRow, AuditLogRow, EpisodeRow, TheoryRow } from "../types.js";
+import type { ClaimRow, ClaimHistoryRow, ClaimRelationRow, ClaimEvidenceRow, ClaimCheckRow, DecisionRow, AuditLogRow, EpisodeRow, TheoryRow, InsightRow, ModelRow, TopicSummary, StaleClaimRow, GroomingEpisodeRow } from "../types.js";
 import type { ProvenanceData } from "../provenance.js";
 /**
  * FTS5クエリのサニタイズ
+ * 2026-02-22 改善 (Issue #20): trigram tokenizer 対応
+ * - 全トークンが3文字未満の場合は null を返し LIKE フォールバックに誘導
+ * - 3文字未満のトークンをフィルタアウト
  */
 export declare function sanitizeFtsQuery(input: string): string | null;
 export declare function insertClaim(db: Database.Database, params: {
@@ -19,7 +22,9 @@ export declare function insertClaim(db: Database.Database, params: {
     confidence: number;
     evidence?: string;
     falsifier?: string;
+    l1_content?: string;
     search_summary?: string;
+    l1_embedding?: Buffer | null;
     source_tool?: string;
     source_session?: string;
     client_name?: string | null;
@@ -46,16 +51,21 @@ export declare function queryContext(db: Database.Database, topic: string, scope
     episodes: EpisodeRow[];
     decisions: DecisionRow[];
     theories: TheoryRow[];
+    insights: InsightRow[];
+    models: ModelRow[];
 };
 export declare function getClaimHistory(db: Database.Database, claimId: string): ClaimHistoryRow[];
 export declare function insertDecision(db: Database.Database, params: {
     title: string;
     description: string;
-    reasoning: string;
-    alternatives: string[];
+    l1_content?: string;
+    l2_reasoning: string;
+    l2_alternatives: string[];
     related_claim_ids: string[];
     scope?: string;
     search_summary?: string;
+    user_input?: string;
+    l1_embedding?: Buffer | null;
     source_tool?: string;
     client_name?: string | null;
     client_version?: string | null;
@@ -76,6 +86,10 @@ export declare function getStats(db: Database.Database): {
     active_decisions: number;
     total_history_entries: number;
     categories: Record<string, number>;
+    active_episodes: number;
+    active_insights: number;
+    active_theories: number;
+    active_models: number;
 };
 export declare function getAllActiveClaims(db: Database.Database): ClaimRow[];
 export declare function getRecentDecisions(db: Database.Database, limit?: number): DecisionRow[];
@@ -116,6 +130,7 @@ export declare function insertAuditLog(db: Database.Database, params: {
     source_tool?: string;
 }): void;
 export declare function getAuditLog(db: Database.Database, entityType: string, entityId: string): AuditLogRow[];
+export declare function getLastCreateAuditTimestamp(db: Database.Database): string | null;
 export declare function searchAuditLog(db: Database.Database, params: {
     operation?: string;
     entity_type?: string;
@@ -124,17 +139,20 @@ export declare function searchAuditLog(db: Database.Database, params: {
 }): AuditLogRow[];
 export declare function insertEpisode(db: Database.Database, params: {
     title: string;
-    context?: string;
-    trigger?: string;
-    problems: string[];
-    desires: string[];
-    decisions: string[];
-    outcomes: string[];
-    principles: string[];
+    l1_content?: string;
+    l2_context?: string;
+    l2_trigger?: string;
+    l2_problems: string[];
+    l2_desires: string[];
+    l2_decisions: string[];
+    l2_outcomes: string[];
+    l2_principles: string[];
     evidence_refs: string[];
     tags: string[];
     scope?: string;
     search_summary?: string;
+    user_input?: string;
+    l1_embedding?: Buffer | null;
     source_tool?: string;
     client_name?: string | null;
     client_version?: string | null;
@@ -153,19 +171,33 @@ export declare function getEpisodeStats(db: Database.Database): {
     active_episodes: number;
     archived_episodes: number;
 };
+export declare function listUngroomedEpisodes(db: Database.Database, params: {
+    scope?: string;
+    tag?: string;
+    include_groomed?: boolean;
+    limit: number;
+}): GroomingEpisodeRow[];
+export declare function markEpisodesGroomed(db: Database.Database, episodeIds: string[]): string[];
+export declare function getTopicSummary(db: Database.Database, tagLimit?: number, decisionLimit?: number, scope?: string): TopicSummary;
 export declare function insertTheory(db: Database.Database, params: {
     title: string;
     description?: string;
-    core_thesis?: string;
-    principles: string[];
+    l1_content?: string;
+    l2_core_thesis?: string;
+    l2_principles: string[];
+    l2_trigger_conditions?: string[];
+    l2_resolution_steps?: string[];
+    l2_applicable_context?: string;
     non_goals: string[];
     open_questions: string[];
     supporting_episode_ids: string[];
     supporting_claim_ids: string[];
+    evidence_refs?: string[];
     tags: string[];
     scope?: string;
     confidence?: number;
     search_summary?: string;
+    l1_embedding?: Buffer | null;
     source_tool?: string;
     client_name?: string | null;
     client_version?: string | null;
@@ -179,4 +211,280 @@ export declare function listTheories(db: Database.Database, params: {
     scope?: string;
     limit: number;
 }): TheoryRow[];
+export declare function searchPrinciplesForRecall(db: Database.Database, promptText: string, limit: number): Array<{
+    source: string;
+    title: string;
+    principles: string[];
+    description?: string;
+    core_thesis?: string;
+}>;
+export declare function listEpisodesWithPrinciples(db: Database.Database, limit: number, scope?: string): EpisodeRow[];
+import type { EscalationCandidate } from "../types.js";
+export declare function listEscalationCandidates(db: Database.Database, params: {
+    scope?: string;
+    limit: number;
+}): EscalationCandidate[];
+/**
+ * 陳腐化した Claim を検出してスコア付きで返す。
+ * SQL で active claim + claim_checks 集計を取得し、
+ * TypeScript 側で陳腐化スコアを計算してソート・フィルタする。
+ */
+export declare function getStaleClaims(db: Database.Database, params: {
+    limit: number;
+    scope?: string;
+    category?: string;
+}): StaleClaimRow[];
+/**
+ * Hook用: 未統合アイテム数をカウント。
+ * 最新の Theory/Insight/Model 作成日時以降に作成された
+ * active な Claim + Decision + Episode の合計件数を返す。
+ * Theory/Insight/Model が1件もない場合は全アクティブアイテムの合計を返す。
+ */
+export declare function countUnconsolidatedItems(db: Database.Database): number;
+/**
+ * Hook用軽量版: 30日以上更新されていない active claim の件数を返す
+ */
+export declare function countStaleClaims(db: Database.Database): number;
+/**
+ * 検証通過時の鮮度リセット: updated_at を現在時刻に更新する
+ */
+export declare function touchClaimUpdatedAt(db: Database.Database, id: string): void;
+/** Claim の l1_embedding を更新 */
+export declare function updateClaimL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** Decision の l1_embedding を更新 */
+export declare function updateDecisionL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** Episode の l1_embedding を更新 */
+export declare function updateEpisodeL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** Theory の l1_embedding を更新 */
+export declare function updateTheoryL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** l1_embedding が NULL の active Claim を取得（バックフィル用） */
+export declare function getClaimsWithoutL1Embedding(db: Database.Database, limit: number): ClaimRow[];
+/** l1_embedding が NULL の active Decision を取得（バックフィル用） */
+export declare function getDecisionsWithoutL1Embedding(db: Database.Database, limit: number): DecisionRow[];
+/** l1_embedding が NULL の active Episode を取得（バックフィル用） */
+export declare function getEpisodesWithoutL1Embedding(db: Database.Database, limit: number): EpisodeRow[];
+/** l1_embedding が NULL の active Theory を取得（バックフィル用） */
+export declare function getTheoriesWithoutL1Embedding(db: Database.Database, limit: number): TheoryRow[];
+/** 指定テーブルで l1_embedding が存在するレコードを取得 */
+export declare function getClaimsWithL1Embedding(db: Database.Database, scope?: string, limit?: number): ClaimRow[];
+export declare function getDecisionsWithL1Embedding(db: Database.Database, scope?: string, limit?: number): DecisionRow[];
+export declare function getEpisodesWithL1Embedding(db: Database.Database, scope?: string, limit?: number): EpisodeRow[];
+export declare function getTheoriesWithL1Embedding(db: Database.Database, scope?: string, limit?: number): TheoryRow[];
+export declare function insertInsight(db: Database.Database, params: {
+    title: string;
+    description?: string;
+    l1_content?: string;
+    l2_core_thesis?: string;
+    l2_principles: string[];
+    l2_trigger_conditions?: string[];
+    l2_resolution_steps?: string[];
+    l2_applicable_context?: string;
+    supporting_episode_ids: string[];
+    supporting_claim_ids: string[];
+    evidence_refs?: string[];
+    tags: string[];
+    scope?: string;
+    confidence?: number;
+    search_summary?: string;
+    l1_embedding?: Buffer | null;
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+    session_id?: string | null;
+}): InsightRow;
+export declare function getInsightById(db: Database.Database, id: string): InsightRow | undefined;
+export declare function listInsights(db: Database.Database, params: {
+    status?: string;
+    query?: string;
+    tag?: string;
+    scope?: string;
+    limit: number;
+}): InsightRow[];
+/** Insight の l1_embedding を更新 */
+export declare function updateInsightL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** l1_embedding が NULL の active Insight を取得（バックフィル用） */
+export declare function getInsightsWithoutL1Embedding(db: Database.Database, limit: number): InsightRow[];
+export declare function getInsightsWithL1Embedding(db: Database.Database, scope?: string, limit?: number): InsightRow[];
+export declare function insertModel(db: Database.Database, params: {
+    title: string;
+    description?: string;
+    l1_content?: string;
+    l2_core_thesis?: string;
+    l2_principles: string[];
+    l2_trigger_conditions?: string[];
+    l2_resolution_steps?: string[];
+    l2_applicable_context?: string;
+    non_goals: string[];
+    open_questions: string[];
+    supporting_episode_ids: string[];
+    supporting_claim_ids: string[];
+    evidence_refs?: string[];
+    tags: string[];
+    scope?: string;
+    confidence?: number;
+    search_summary?: string;
+    l1_embedding?: Buffer | null;
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+    session_id?: string | null;
+}): ModelRow;
+export declare function getModelById(db: Database.Database, id: string): ModelRow | undefined;
+export declare function listModels(db: Database.Database, params: {
+    status?: string;
+    query?: string;
+    tag?: string;
+    scope?: string;
+    limit: number;
+}): ModelRow[];
+/** Model の l1_embedding を更新 */
+export declare function updateModelL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+/** l1_embedding が NULL の active Model を取得（バックフィル用） */
+export declare function getModelsWithoutL1Embedding(db: Database.Database, limit: number): ModelRow[];
+export declare function getModelsWithL1Embedding(db: Database.Database, scope?: string, limit?: number): ModelRow[];
+import type { UserMemoRow } from "../types.js";
+export declare function insertUserMemo(db: Database.Database, params: {
+    title: string;
+    l1_content: string;
+    usage_policy?: string;
+    tags: string[];
+    scope?: string;
+    search_summary?: string;
+    user_input?: string;
+    l1_embedding?: Buffer | null;
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+}): UserMemoRow;
+export declare function getUserMemoById(db: Database.Database, id: string): UserMemoRow | undefined;
+export declare function updateUserMemo(db: Database.Database, id: string, updates: {
+    title?: string;
+    l1_content?: string;
+    usage_policy?: string;
+    tags?: string[];
+    scope?: string;
+    search_summary?: string;
+    status?: string;
+}): UserMemoRow | undefined;
+export declare function listUserMemos(db: Database.Database, params: {
+    query?: string;
+    tag?: string;
+    usage_policy?: string;
+    scope?: string;
+    status?: string;
+    limit?: number;
+}): UserMemoRow[];
+export declare function listAutoUserMemos(db: Database.Database, scope?: string, limit?: number): UserMemoRow[];
+export declare function updateUserMemoL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+export declare function getUserMemosWithoutL1Embedding(db: Database.Database, limit: number): UserMemoRow[];
+export declare function getUserMemosWithL1Embedding(db: Database.Database, scope?: string, limit?: number): UserMemoRow[];
+import type { UserPlanRow, UserIssueRow } from "../types.js";
+export declare function insertUserPlan(db: Database.Database, params: {
+    title: string;
+    l1_content: string;
+    usage_policy?: string;
+    tags: string[];
+    scope?: string;
+    search_summary?: string;
+    user_input?: string;
+    l1_embedding?: Buffer | null;
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+}): UserPlanRow;
+export declare function getUserPlanById(db: Database.Database, id: string): UserPlanRow | undefined;
+export declare function updateUserPlan(db: Database.Database, id: string, updates: {
+    title?: string;
+    l1_content?: string;
+    usage_policy?: string;
+    tags?: string[];
+    scope?: string;
+    search_summary?: string;
+    status?: string;
+}): UserPlanRow | undefined;
+export declare function listUserPlans(db: Database.Database, params: {
+    query?: string;
+    tag?: string;
+    usage_policy?: string;
+    scope?: string;
+    status?: string;
+    limit?: number;
+}): UserPlanRow[];
+export declare function listAutoUserPlans(db: Database.Database, scope?: string, limit?: number): UserPlanRow[];
+export declare function updateUserPlanL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+export declare function getUserPlansWithoutL1Embedding(db: Database.Database, limit: number): UserPlanRow[];
+export declare function getUserPlansWithL1Embedding(db: Database.Database, scope?: string, limit?: number): UserPlanRow[];
+export declare function insertUserIssue(db: Database.Database, params: {
+    title: string;
+    l1_content: string;
+    entries?: string;
+    priority?: string;
+    usage_policy?: string;
+    tags: string[];
+    scope?: string;
+    search_summary?: string;
+    user_input?: string;
+    l1_embedding?: Buffer | null;
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+}): UserIssueRow;
+export declare function getUserIssueById(db: Database.Database, id: string): UserIssueRow | undefined;
+export declare function updateUserIssue(db: Database.Database, id: string, updates: {
+    title?: string;
+    l1_content?: string;
+    entries?: string;
+    priority?: string;
+    usage_policy?: string;
+    tags?: string[];
+    scope?: string;
+    search_summary?: string;
+    status?: string;
+}): UserIssueRow | undefined;
+export declare function listUserIssues(db: Database.Database, params: {
+    query?: string;
+    tag?: string;
+    priority?: string;
+    usage_policy?: string;
+    scope?: string;
+    status?: string;
+    limit?: number;
+}): UserIssueRow[];
+export declare function updateUserIssueL1Embedding(db: Database.Database, id: string, l1_embedding: Buffer): void;
+export declare function getUserIssuesWithoutL1Embedding(db: Database.Database, limit: number): UserIssueRow[];
+export declare function getUserIssuesWithL1Embedding(db: Database.Database, scope?: string, limit?: number): UserIssueRow[];
+import type { UnifiedSearchRow } from "../types.js";
+/**
+ * 横断検索（FTS5 + LIKEフォールバック）
+ * unified_search_items テーブルを使い、全6エンティティを横断してFTS5検索する。
+ * FTS5で結果が得られない場合はLIKEフォールバック（既存パターンと同一）。
+ */
+export declare function unifiedSearch(db: Database.Database, query: string, scope: string | undefined, entityTypes: string[] | undefined, limit: number): UnifiedSearchRow[];
+/**
+ * 横断検索テーブルからl1_embedding付きレコードを取得（ベクトル検索用）
+ */
+export declare function getUnifiedSearchWithL1Embedding(db: Database.Database, scope: string | undefined, entityTypes: string[] | undefined, limit: number): UnifiedSearchRow[];
+/**
+ * 横断検索テーブルの全件再構築
+ * 全ソーステーブルからアクティブレコードを取得し、unified_search_items を再構築する。
+ * マイグレーション後の整合性チェックや手動メンテナンスに使用。
+ */
+export declare function rebuildUnifiedSearch(db: Database.Database): {
+    total: number;
+};
+/**
+ * entity_id から entity_type を解決する（unified_search_items を使用）。
+ * Issue #60: entity_type 省略時の自動解決に使用。
+ *
+ * 注意: unified_search_items には active 状態のエンティティのみ同期される。
+ * retracted/superseded/promoted 等の非 active エンティティは解決できない。
+ * 非 active エンティティを取得する場合は entity_type を明示指定すること。
+ */
+export declare function resolveEntityType(db: Database.Database, entityId: string): string | undefined;
+/**
+ * 任意エンティティの search_summary を更新する。
+ * UPDATE トリガーにより unified_search_items も自動同期される。
+ * @returns 更新された行数（0 = ID不在）
+ */
+export declare function updateSearchSummary(db: Database.Database, entityType: string, entityId: string, searchSummary: string): number;
 //# sourceMappingURL=queries-core.d.ts.map