@spences10/pi-context 0.0.2 → 0.0.4

package/dist/policy.js

@@ -0,0 +1,30 @@
+export const DEFAULT_CONTEXT_RETENTION_DAYS = 7;
+export function parse_context_retention_policy(env = process.env) {
+    const retention_days = parse_optional_positive_number(env.MY_PI_CONTEXT_RETENTION_DAYS, DEFAULT_CONTEXT_RETENTION_DAYS);
+    const max_mb = parse_optional_positive_number(env.MY_PI_CONTEXT_MAX_MB, null);
+    return {
+        retention_days,
+        purge_on_shutdown: parse_boolean_env(env.MY_PI_CONTEXT_PURGE_ON_SHUTDOWN),
+        max_mb,
+        max_bytes: max_mb === null ? null : max_mb * 1024 * 1024,
+    };
+}
+function parse_optional_positive_number(value, fallback) {
+    if (value === undefined || value.trim() === '')
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === '0' ||
+        normalized === 'off' ||
+        normalized === 'false' ||
+        normalized === 'none' ||
+        normalized === 'disabled')
+        return null;
+    const parsed = Number(normalized);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parse_boolean_env(value) {
+    if (!value)
+        return false;
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAEhD,MAAM,UAAU,8BAA8B,CAC7C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,cAAc,GAAG,8BAA8B,CACpD,GAAG,CAAC,4BAA4B,EAChC,8BAA8B,CAC9B,CAAC;IACF,MAAM,MAAM,GAAG,8BAA8B,CAC5C,GAAG,CAAC,oBAAoB,EACxB,IAAI,CACJ,CAAC;IACF,OAAO;QACN,cAAc;QACd,iBAAiB,EAAE,iBAAiB,CACnC,GAAG,CAAC,+BAA+B,CACnC;QACD,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI;KACxD,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B,CACtC,KAAyB,EACzB,QAAuB;IAEvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IACC,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,KAAK;QACpB,UAAU,KAAK,OAAO;QACtB,UAAU,KAAK,MAAM;QACrB,UAAU,KAAK,UAAU;QAEzB,OAAO,IAAI,CAAC;IACb,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAyB;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CACzC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAC1B,CAAC;AACH,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function apply_schema(db: DatabaseSync): void;

package/dist/schema.js

@@ -0,0 +1,45 @@
+import { readFileSync } from 'node:fs';
+const SCHEMA = readFileSync(new URL('./schema.sql', import.meta.url), 'utf8');
+const LATEST_CONTEXT_SCHEMA_VERSION = 1;
+const PERSISTENT_PRAGMAS = `
+PRAGMA journal_mode = WAL;
+`;
+const CONNECTION_PRAGMAS = `
+PRAGMA foreign_keys = ON;
+PRAGMA busy_timeout = 5000;
+`;
+const MIGRATIONS = {
+    1: SCHEMA,
+};
+function get_user_version(db) {
+    const row = db.prepare('PRAGMA user_version').get();
+    return row.user_version;
+}
+export function apply_schema(db) {
+    db.exec(PERSISTENT_PRAGMAS);
+    db.exec(CONNECTION_PRAGMAS);
+    const current_version = get_user_version(db);
+    if (current_version > LATEST_CONTEXT_SCHEMA_VERSION) {
+        db.close();
+        throw new Error(`Context database schema version ${current_version} is newer than supported version ${LATEST_CONTEXT_SCHEMA_VERSION}`);
+    }
+    for (let next_version = current_version + 1; next_version <= LATEST_CONTEXT_SCHEMA_VERSION; next_version++) {
+        const migration = MIGRATIONS[next_version];
+        if (!migration) {
+            db.close();
+            throw new Error(`Missing context migration for schema version ${next_version}`);
+        }
+        db.exec('BEGIN');
+        try {
+            db.exec(migration);
+            db.exec(`PRAGMA user_version = ${next_version}`);
+            db.exec('COMMIT');
+        }
+        catch (error) {
+            db.exec('ROLLBACK');
+            db.close();
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,MAAM,GAAG,YAAY,CAC1B,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EACxC,MAAM,CACN,CAAC;AACF,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,MAAM,kBAAkB,GAAG;;CAE1B,CAAC;AACF,MAAM,kBAAkB,GAAG;;;CAG1B,CAAC;AACF,MAAM,UAAU,GAA2B;IAC1C,CAAC,EAAE,MAAM;CACT,CAAC;AAEF,SAAS,gBAAgB,CAAC,EAAgB;IACzC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAEhD,CAAC;IACF,OAAO,GAAG,CAAC,YAAY,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC5C,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE5B,MAAM,eAAe,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,eAAe,GAAG,6BAA6B,EAAE,CAAC;QACrD,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACd,mCAAmC,eAAe,oCAAoC,6BAA6B,EAAE,CACrH,CAAC;IACH,CAAC;IAED,KACC,IAAI,YAAY,GAAG,eAAe,GAAG,CAAC,EACtC,YAAY,IAAI,6BAA6B,EAC7C,YAAY,EAAE,EACb,CAAC;QACF,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACd,gDAAgD,YAAY,EAAE,CAC9D,CAAC;QACH,CAAC;QAED,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC;YACJ,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnB,EAAE,CAAC,IAAI,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;YACjD,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/schema.sql

@@ -0,0 +1,49 @@
+CREATE TABLE IF NOT EXISTS context_sources (
+  id TEXT PRIMARY KEY,
+  session_id TEXT,
+  project_path TEXT,
+  tool_name TEXT NOT NULL,
+  input_summary TEXT,
+  created_at INTEGER NOT NULL,
+  byte_count INTEGER NOT NULL,
+  line_count INTEGER NOT NULL,
+  content_hash TEXT NOT NULL,
+  preview_byte_count INTEGER NOT NULL DEFAULT 0,
+  returned_byte_count INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE TABLE IF NOT EXISTS context_chunks (
+  id TEXT PRIMARY KEY,
+  source_id TEXT NOT NULL REFERENCES context_sources(id) ON DELETE CASCADE,
+  ordinal INTEGER NOT NULL,
+  title TEXT,
+  content TEXT NOT NULL,
+  byte_count INTEGER NOT NULL
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS context_chunks_fts USING fts5(
+  title,
+  content,
+  content='context_chunks',
+  content_rowid='rowid'
+);
+
+CREATE TRIGGER IF NOT EXISTS context_chunks_ai AFTER INSERT ON context_chunks BEGIN
+  INSERT INTO context_chunks_fts(rowid, title, content) VALUES (new.rowid, new.title, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS context_chunks_ad AFTER DELETE ON context_chunks BEGIN
+  INSERT INTO context_chunks_fts(context_chunks_fts, rowid, title, content)
+  VALUES('delete', old.rowid, old.title, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS context_chunks_au AFTER UPDATE ON context_chunks BEGIN
+  INSERT INTO context_chunks_fts(context_chunks_fts, rowid, title, content)
+  VALUES('delete', old.rowid, old.title, old.content);
+  INSERT INTO context_chunks_fts(rowid, title, content) VALUES (new.rowid, new.title, new.content);
+END;
+
+CREATE INDEX IF NOT EXISTS idx_context_sources_created ON context_sources(created_at);
+CREATE INDEX IF NOT EXISTS idx_context_sources_session ON context_sources(session_id);
+CREATE INDEX IF NOT EXISTS idx_context_sources_project ON context_sources(project_path);
+CREATE INDEX IF NOT EXISTS idx_context_chunks_source ON context_chunks(source_id, ordinal);

package/dist/store.d.ts

@@ -1,69 +1,12 @@
-export declare const DEFAULT_CONTEXT_MAX_BYTES: number;
-export declare const DEFAULT_CONTEXT_MAX_LINES = 300;
-export interface ContextStoreOptions {
-    db_path?: string;
-    project_path?: string;
-    session_id?: string | null;
-    max_bytes?: number;
-    max_lines?: number;
-}
-export interface StoreContextInput {
-    text: string;
-    tool_name: string;
-    input_summary?: string | null;
-    session_id?: string | null;
-    project_path?: string | null;
-    force?: boolean;
-}
-export interface StoredContextOutput {
-    source_id: string;
-    bytes: number;
-    lines: number;
-    preview: string;
-    receipt: string;
-    chunk_count: number;
-    returned_bytes: number;
-}
-export interface ContextSearchResult {
-    source_id: string;
-    chunk_id: string;
-    ordinal: number;
-    title: string | null;
-    content: string;
-    tool_name: string;
-    created_at: number;
-    bytes: number;
-    lines: number;
-    rank: number;
-}
-export interface ContextStats {
-    sources: number;
-    chunks: number;
-    bytes_stored: number;
-    bytes_returned: number;
-    bytes_saved: number;
-    reduction_pct: number;
-    db_bytes: number;
-    wal_bytes: number;
-    total_bytes: number;
-}
-interface ChunkRow {
-    id: string;
-    source_id: string;
-    ordinal: number;
-    title: string | null;
-    content: string;
-    byte_count: number;
-}
+import type { ContextChunk, ContextCleanupResult, ContextListResult, ContextPurgeDetails, ContextRetentionPolicy, ContextScopeOptions, ContextSearchResult, ContextStats, ContextStoreOptions, StoreContextInput, StoredContextOutput } from './types.js';
+export { DEFAULT_CONTEXT_RETENTION_DAYS, parse_context_retention_policy, } from './policy.js';
+export { DEFAULT_CONTEXT_MAX_BYTES, DEFAULT_CONTEXT_MAX_LINES, count_lines, escape_fts5_query, make_preview, should_index_text, } from './text.js';
+export type { ContextChunk, ContextCleanupResult, ContextListResult, ContextPurgeDetails, ContextRetentionPolicy, ContextScopeOptions, ContextSearchResult, ContextStats, ContextStoreOptions, StoreContextInput, StoredContextOutput, } from './types.js';
 export declare function default_context_db_path(): string;
 export declare function set_context_sidecar_enabled(enabled: boolean, options?: ContextStoreOptions): void;
 export declare function is_context_sidecar_enabled(): boolean;
 export declare function get_context_store(options?: ContextStoreOptions): ContextStore;
 export declare function maybe_store_context_output(input: StoreContextInput, options?: ContextStoreOptions): StoredContextOutput | null;
-export declare function count_lines(text: string): number;
-export declare function should_index_text(text: string, options?: Pick<ContextStoreOptions, 'max_bytes' | 'max_lines'>): boolean;
-export declare function escape_fts5_query(query: string): string;
-export declare function make_preview(text: string, max_lines?: number, max_bytes?: number): string;
 export declare class ContextStore {
     readonly db_path: string;
     private db;
@@ -72,18 +15,35 @@ export declare class ContextStore {
     private max_bytes;
     private max_lines;
     constructor(options?: ContextStoreOptions);
+    configure(options?: ContextStoreOptions): void;
+    private scoped_filter;
+    private find_duplicate_source;
     store(input: StoreContextInput): StoredContextOutput | null;
-    search(query: string, options?: {
+    list(options?: ContextScopeOptions & {
+        source_id?: string;
+        tool_name?: string;
+        limit?: number;
+        offset?: number;
+        newer_than_days?: number;
+        older_than_days?: number;
+    }): ContextListResult[];
+    search(query: string, options?: ContextScopeOptions & {
         source_id?: string;
         limit?: number;
         tool_name?: string;
     }): ContextSearchResult[];
-    get(source_id: string, chunk_id?: string): ChunkRow[];
-    stats(): ContextStats;
-    purge(options?: {
+    get(source_id: string, chunk_id?: string, options?: ContextScopeOptions): ContextChunk[];
+    private count_stats;
+    stats(options?: ContextScopeOptions): ContextStats;
+    cleanup(policy?: ContextRetentionPolicy): ContextCleanupResult;
+    private purge_to_max_stored_bytes;
+    purge(options?: ContextScopeOptions & {
         older_than_days?: number;
         source_id?: string;
     }): number;
+    purge_with_details(options?: ContextScopeOptions & {
+        older_than_days?: number;
+        source_id?: string;
+    }): ContextPurgeDetails;
     close(): void;
 }
-export {};