watashi-db 0.0.5

package/dist/database/queries.d.ts

@@ -0,0 +1,227 @@
+import type { ClaimRow, ClaimHistoryRow, ClaimRelationRow, ClaimEvidenceRow, ClaimCheckRow, DecisionRow, AuditLogRow, EpisodeRow } from "../types.js";
+import type { ProvenanceData } from "../provenance.js";
+/**
+ * 新規Claim挿入
+ * 2026-02-11 修正: client_name, client_version追加（Provenance自動付与対応）
+ * 元の実装: source_tool/source_sessionのみ（自己申告値）
+ */
+export declare function insertClaim(params: {
+    subject: string;
+    predicate: string;
+    object: string;
+    category: string;
+    scope: string;
+    confidence: number;
+    evidence?: string;
+    falsifier?: string;
+    source_tool?: string;
+    source_session?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+}): ClaimRow;
+/**
+ * Claim取得（ID指定）
+ */
+export declare function getClaimById(id: string): ClaimRow | undefined;
+/**
+ * Claim更新（変更履歴付き）
+ */
+export declare function updateClaim(id: string, updates: Record<string, unknown>, reason: string): ClaimRow | undefined;
+/**
+ * Claim撤回（削除ではなくステータス変更 + 履歴記録）
+ */
+export declare function retractClaim(id: string, reason: string): ClaimRow | undefined;
+/**
+ * Claim置き換え（旧Claimをsuperseded化し、新旧関係を記録）
+ */
+export declare function supersedeClaim(oldId: string, newId: string, reason: string): {
+    oldClaim: ClaimRow;
+    newClaim: ClaimRow;
+} | undefined;
+/**
+ * Decision ステータス遷移（reverse / obsolete）
+ */
+export declare function updateDecisionStatus(id: string, newStatus: string, reason: string): DecisionRow | undefined;
+/**
+ * Claim検索（条件指定）
+ */
+export declare function searchClaims(params: {
+    category?: string;
+    scope?: string;
+    status?: string;
+    query?: string;
+    limit: number;
+}): ClaimRow[];
+/**
+ * トピックに関連するコンテキスト検索（FTS5使用）
+ * 2026-02-11 修正: FTS5構文エラー耐性強化（サニタイズ + LIKEフォールバック）
+ * 元の実装: topic + "*" をそのまま渡していた
+ */
+export declare function queryContext(topic: string, scope: string | undefined, limit: number): ClaimRow[];
+/**
+ * Claimの変更履歴を取得
+ */
+export declare function getClaimHistory(claimId: string): ClaimHistoryRow[];
+/**
+ * 意思決定ログ記録
+ * 2026-02-11 修正: client_name, client_version追加（Provenance自動付与対応）
+ * 元の実装: source_toolのみ（自己申告値）
+ */
+export declare function insertDecision(params: {
+    title: string;
+    description: string;
+    reasoning: string;
+    alternatives: string[];
+    related_claim_ids: string[];
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+}): DecisionRow;
+/**
+ * Decision取得（ID指定）
+ */
+export declare function getDecisionById(id: string): DecisionRow | undefined;
+/**
+ * Decision検索
+ */
+export declare function listDecisions(params: {
+    status?: string;
+    query?: string;
+    limit: number;
+}): DecisionRow[];
+/**
+ * データベース統計情報を取得
+ */
+export declare function getStats(): {
+    total_claims: number;
+    active_claims: number;
+    retracted_claims: number;
+    superseded_claims: number;
+    total_decisions: number;
+    active_decisions: number;
+    total_history_entries: number;
+    categories: Record<string, number>;
+};
+/**
+ * 全アクティブClaimを取得（リソース用）
+ */
+export declare function getAllActiveClaims(): ClaimRow[];
+/**
+ * 直近の意思決定を取得（リソース用）
+ */
+export declare function getRecentDecisions(limit?: number): DecisionRow[];
+/**
+ * Claim間関係を記録
+ */
+export declare function insertClaimRelation(params: {
+    source_claim_id: string;
+    target_claim_id: string;
+    relation_type: string;
+    confidence: number;
+    reasoning?: string;
+    source_tool?: string;
+}): ClaimRelationRow;
+/**
+ * 特定Claimの関係を取得（source/target両方向）
+ */
+export declare function getClaimRelations(claimId: string): ClaimRelationRow[];
+/**
+ * Claimの構造化根拠を記録
+ */
+export declare function insertClaimEvidence(params: {
+    claim_id: string;
+    evidence_type: string;
+    uri?: string;
+    span?: string;
+    content_hash?: string;
+    description?: string;
+    source_tool?: string;
+}): ClaimEvidenceRow;
+/**
+ * 特定Claimの根拠一覧を取得
+ */
+export declare function getClaimEvidenceList(claimId: string): ClaimEvidenceRow[];
+/**
+ * Claimの検証結果を記録
+ */
+export declare function insertClaimCheck(params: {
+    claim_id: string;
+    check_type: string;
+    result: string;
+    details?: string;
+    source_tool?: string;
+}): ClaimCheckRow;
+/**
+ * 特定Claimの検証ログを取得
+ */
+export declare function getClaimChecks(claimId: string): ClaimCheckRow[];
+/**
+ * 監査ログを記録する内部ヘルパー
+ * 全書き込み操作から呼び出される
+ */
+export declare function insertAuditLog(params: {
+    operation: string;
+    entity_type: string;
+    entity_id: string;
+    summary: string;
+    details?: string;
+    provenance?: ProvenanceData;
+    source_tool?: string;
+}): void;
+/**
+ * 特定エンティティの監査ログを取得
+ */
+export declare function getAuditLog(entityType: string, entityId: string): AuditLogRow[];
+/**
+ * 監査ログ検索（全エンティティ横断）
+ */
+export declare function searchAuditLog(params: {
+    operation?: string;
+    entity_type?: string;
+    session_id?: string;
+    limit: number;
+}): AuditLogRow[];
+/**
+ * Episode記録
+ * 思考パターン・意思決定エピソードを記録する。
+ * context→trigger→problems→desires→decisions→outcomes→principles の流れで格納。
+ */
+export declare function insertEpisode(params: {
+    title: string;
+    context?: string;
+    trigger?: string;
+    problems: string[];
+    desires: string[];
+    decisions: string[];
+    outcomes: string[];
+    principles: string[];
+    evidence_refs: string[];
+    tags: string[];
+    source_tool?: string;
+    client_name?: string | null;
+    client_version?: string | null;
+    session_id?: string | null;
+}): EpisodeRow;
+/**
+ * Episode取得（ID指定）
+ */
+export declare function getEpisodeById(id: string): EpisodeRow | undefined;
+/**
+ * Episode一覧取得（検索・フィルタ対応）
+ * FTS5検索 + タグフィルタ + ステータスフィルタ
+ */
+export declare function listEpisodes(params: {
+    status?: string;
+    query?: string;
+    tag?: string;
+    limit: number;
+}): EpisodeRow[];
+/**
+ * Episode統計情報を取得
+ */
+export declare function getEpisodeStats(): {
+    total_episodes: number;
+    active_episodes: number;
+    archived_episodes: number;
+};
+//# sourceMappingURL=queries.d.ts.map