@blamechris/repo-memory 0.1.0

package/dist/persistence/db.js

@@ -0,0 +1,146 @@
+import Database from 'better-sqlite3';
+import { mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+const REPO_MEMORY_DIR = '.repo-memory';
+const DB_FILENAME = 'cache.db';
+let instance = null;
+let instancePath = null;
+const MIGRATIONS = [
+    {
+        version: 1,
+        up: (db) => {
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS files (
+          path TEXT PRIMARY KEY,
+          hash TEXT NOT NULL,
+          last_checked INTEGER NOT NULL,
+          summary_json TEXT
+        );
+      `);
+        },
+    },
+    {
+        version: 2,
+        up: (db) => {
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS tasks (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          state TEXT NOT NULL DEFAULT 'created',
+          created_at INTEGER NOT NULL,
+          updated_at INTEGER NOT NULL,
+          session_id TEXT,
+          metadata_json TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS task_files (
+          task_id TEXT NOT NULL,
+          file_path TEXT NOT NULL,
+          status TEXT NOT NULL DEFAULT 'explored',
+          notes TEXT,
+          explored_at INTEGER NOT NULL,
+          PRIMARY KEY (task_id, file_path),
+          FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE
+        );
+      `);
+        },
+    },
+    {
+        version: 3,
+        up: (db) => {
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS imports (
+          source TEXT NOT NULL,
+          target TEXT NOT NULL,
+          specifiers TEXT NOT NULL,
+          import_type TEXT NOT NULL,
+          PRIMARY KEY (source, target, import_type)
+        );
+        CREATE INDEX IF NOT EXISTS idx_imports_target ON imports (target);
+      `);
+        },
+    },
+    {
+        version: 4,
+        up: (db) => {
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS telemetry (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          timestamp INTEGER NOT NULL,
+          event_type TEXT NOT NULL,
+          file_path TEXT,
+          tokens_estimated INTEGER,
+          metadata_json TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_telemetry_type ON telemetry (event_type);
+        CREATE INDEX IF NOT EXISTS idx_telemetry_timestamp ON telemetry (timestamp);
+      `);
+        },
+    },
+    {
+        version: 5,
+        up: (db) => {
+            db.exec(`
+        CREATE TABLE IF NOT EXISTS sessions (
+          id TEXT PRIMARY KEY,
+          started_at INTEGER NOT NULL,
+          ended_at INTEGER,
+          metadata_json TEXT
+        );
+      `);
+        },
+    },
+];
+function runMigrations(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_version (
+      version INTEGER PRIMARY KEY,
+      applied_at INTEGER NOT NULL
+    );
+  `);
+    const applied = db
+        .prepare('SELECT version FROM schema_version ORDER BY version DESC LIMIT 1')
+        .get();
+    const currentVersion = applied?.version ?? 0;
+    const sortedMigrations = [...MIGRATIONS].sort((a, b) => a.version - b.version);
+    const insertVersion = db.prepare('INSERT INTO schema_version (version, applied_at) VALUES (?, ?)');
+    const applyMigrations = db.transaction(() => {
+        for (const migration of sortedMigrations) {
+            if (migration.version > currentVersion) {
+                migration.up(db);
+                insertVersion.run(migration.version, Date.now());
+            }
+        }
+    });
+    applyMigrations();
+}
+export function getDatabase(projectRoot) {
+    const dbDir = join(projectRoot, REPO_MEMORY_DIR);
+    const dbPath = join(dbDir, DB_FILENAME);
+    if (instance && instancePath === dbPath) {
+        return instance;
+    }
+    if (instance && instancePath !== dbPath) {
+        instance.close();
+        instance = null;
+        instancePath = null;
+    }
+    if (!existsSync(dbDir)) {
+        mkdirSync(dbDir, { recursive: true });
+    }
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    runMigrations(db);
+    instance = db;
+    instancePath = dbPath;
+    return db;
+}
+export function closeDatabase() {
+    if (instance) {
+        instance.close();
+        instance = null;
+        instancePath = null;
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/persistence/db.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { getFileSummary } from './tools/get-file-summary.js';
+import { getChangedFiles } from './tools/get-changed-files.js';
+import { getProjectMap } from './tools/get-project-map.js';
+import { forceReread } from './tools/force-reread.js';
+import { invalidateCache } from './tools/invalidate.js';
+import { getDependencyGraphTool } from './tools/get-dependency-graph.js';
+import { createTaskTool, getTaskContext, markExploredTool } from './tools/task-context.js';
+import { getTokenReport } from './tools/get-token-report.js';
+const server = new McpServer({
+    name: 'repo-memory',
+    version: '0.1.0',
+});
+server.registerTool('get_file_summary', {
+    title: 'Get File Summary',
+    description: 'Returns a cached summary of a file. If the file has not changed since last read, returns the cached summary without re-reading. Use this instead of reading files directly to save tokens.',
+    inputSchema: {
+        path: z.string().describe('File path relative to project root'),
+    },
+}, async ({ path }) => {
+    try {
+        const projectRoot = process.cwd();
+        const result = await getFileSummary(projectRoot, path);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const isNotFound = error instanceof Error && 'code' in error && error.code === 'ENOENT';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: isNotFound ? 'file_not_found' : 'internal_error',
+                        message,
+                        path,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.registerTool('get_changed_files', {
+    title: 'Get Changed Files',
+    description: 'Returns files that have changed since the last check. Compares current file hashes against cached hashes.',
+    inputSchema: {
+        since: z.string().optional().describe('ISO timestamp or "last_check"'),
+    },
+}, async ({ since }) => {
+    const projectRoot = process.cwd();
+    const result = await getChangedFiles(projectRoot, since);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('get_project_map', {
+    title: 'Get Project Map',
+    description: 'Returns a structural overview of the project including directory tree, entry points, and key modules.',
+    inputSchema: {
+        project_root: z.string().describe('Absolute path to the project root'),
+        depth: z.number().optional().describe('Max directory depth to include'),
+    },
+}, async ({ project_root, depth }) => {
+    const projectMap = await getProjectMap(project_root, depth);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(projectMap) }],
+    };
+});
+server.registerTool('force_reread', {
+    title: 'Force Re-read',
+    description: 'Re-reads a file from disk, generates a fresh summary, and updates the cache. Use when you know a file has changed or want guaranteed-fresh data.',
+    inputSchema: {
+        path: z.string().describe('File path relative to project root'),
+    },
+}, async ({ path }) => {
+    const projectRoot = process.cwd();
+    const result = await forceReread(projectRoot, path);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('invalidate', {
+    title: 'Invalidate Cache',
+    description: 'Invalidates cached entries. If a path is provided, only that entry is removed. If no path is provided, all entries are removed.',
+    inputSchema: {
+        path: z.string().optional().describe('File path to invalidate, or omit to invalidate all'),
+    },
+}, async ({ path }) => {
+    const projectRoot = process.cwd();
+    const result = await invalidateCache(projectRoot, path);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('get_dependency_graph', {
+    title: 'Get Dependency Graph',
+    description: 'Returns dependency graph information. If a path is given, returns its dependencies/dependents. If no path, returns a summary of the most connected files.',
+    inputSchema: {
+        path: z.string().optional().describe('File path to query, or omit for full graph summary'),
+        direction: z
+            .enum(['dependencies', 'dependents', 'both'])
+            .optional()
+            .describe('Query direction (default: both)'),
+        depth: z.number().optional().describe('Max traversal depth'),
+    },
+}, async ({ path, direction, depth }) => {
+    const projectRoot = process.cwd();
+    const result = await getDependencyGraphTool(projectRoot, path, direction, depth);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('create_task', {
+    title: 'Create Task',
+    description: 'Creates a new investigation task for tracking file exploration.',
+    inputSchema: {
+        name: z.string().describe('Human-readable task name'),
+    },
+}, async ({ name }) => {
+    const projectRoot = process.cwd();
+    const task = createTaskTool(projectRoot, name);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(task) }],
+    };
+});
+server.registerTool('get_task_context', {
+    title: 'Get Task Context',
+    description: 'Returns task state, explored files, and frontier. If no task_id, returns list of all tasks.',
+    inputSchema: {
+        task_id: z.string().optional().describe('Task ID to query, or omit to list all tasks'),
+    },
+}, async ({ task_id }) => {
+    const projectRoot = process.cwd();
+    const result = getTaskContext(projectRoot, task_id);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('mark_explored', {
+    title: 'Mark Explored',
+    description: 'Marks a file as explored for a task, with optional status and notes.',
+    inputSchema: {
+        task_id: z.string().describe('Task ID'),
+        path: z.string().describe('File path relative to project root'),
+        status: z
+            .enum(['explored', 'skipped', 'flagged'])
+            .optional()
+            .describe('Exploration status (default: explored)'),
+        notes: z.string().optional().describe('Optional notes about the file'),
+    },
+}, async ({ task_id, path, status, notes }) => {
+    const projectRoot = process.cwd();
+    const result = markExploredTool(projectRoot, task_id, path, status, notes);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
+server.registerTool('get_token_report', {
+    title: 'Get Token Report',
+    description: 'Get aggregated token usage telemetry report showing cache efficiency and token savings',
+    inputSchema: {
+        period: z
+            .enum(['session', 'all', 'last_n_hours'])
+            .optional()
+            .describe('Time period for the report'),
+        hours: z
+            .number()
+            .optional()
+            .describe('Number of hours to look back (only for last_n_hours period)'),
+        session_id: z
+            .string()
+            .optional()
+            .describe('Session ID (only for session period)'),
+    },
+}, async ({ period, hours, session_id }) => {
+    const projectRoot = process.cwd();
+    const report = getTokenReport(projectRoot, period, hours, session_id);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
+    process.stderr.write(`Fatal error: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/telemetry/tracker.d.ts

@@ -0,0 +1,40 @@
+export type TelemetryEvent = 'cache_hit' | 'cache_miss' | 'invalidation' | 'force_reread' | 'summary_served';
+export interface TelemetryEntry {
+    id: number;
+    timestamp: number;
+    eventType: TelemetryEvent;
+    filePath: string | null;
+    tokensEstimated: number | null;
+    metadata: Record<string, unknown> | null;
+}
+export declare class TelemetryTracker {
+    private readonly projectRoot;
+    private enabled;
+    private samplingRate;
+    constructor(projectRoot: string, enabled?: boolean, samplingRate?: number);
+    trackEvent(eventType: TelemetryEvent, filePath?: string, tokensEstimated?: number, metadata?: Record<string, unknown>): void;
+    getEvents(filter?: {
+        eventType?: TelemetryEvent;
+        since?: number;
+        limit?: number;
+    }): TelemetryEntry[];
+    getStats(since?: number): {
+        totalEvents: number;
+        cacheHits: number;
+        cacheMisses: number;
+        hitRatio: number;
+        totalTokensSaved: number;
+        eventsByType: Record<string, number>;
+    };
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    getSamplingRate(): number;
+    setSamplingRate(rate: number): void;
+    exportEvents(filter?: {
+        since?: number;
+        eventType?: TelemetryEvent;
+    }): string;
+    enforceRetention(maxAgeDays: number): number;
+    private rowToEntry;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/telemetry/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracker.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAWD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc,EAAE,YAAY,GAAE,MAAY;IAMpF,UAAU,CACR,SAAS,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAgBP,SAAS,CAAC,MAAM,CAAC,EAAE;QACjB,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,cAAc,EAAE;IA4BpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC;IA0CD,SAAS,IAAI,OAAO;IAIpB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,eAAe,IAAI,MAAM;IAIzB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,YAAY,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,MAAM;IAmC7E,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAO5C,OAAO,CAAC,UAAU;CAUnB"}

package/dist/telemetry/tracker.js

@@ -0,0 +1,136 @@
+import { getDatabase } from '../persistence/db.js';
+export class TelemetryTracker {
+    projectRoot;
+    enabled;
+    samplingRate;
+    constructor(projectRoot, enabled = true, samplingRate = 1.0) {
+        this.projectRoot = projectRoot;
+        this.enabled = enabled;
+        this.samplingRate = Math.max(0.0, Math.min(1.0, samplingRate));
+    }
+    trackEvent(eventType, filePath, tokensEstimated, metadata) {
+        if (!this.enabled)
+            return;
+        if (this.samplingRate < 1.0 && Math.random() > this.samplingRate)
+            return;
+        const db = getDatabase(this.projectRoot);
+        db.prepare('INSERT INTO telemetry (timestamp, event_type, file_path, tokens_estimated, metadata_json) VALUES (?, ?, ?, ?, ?)').run(Date.now(), eventType, filePath ?? null, tokensEstimated ?? null, metadata ? JSON.stringify(metadata) : null);
+    }
+    getEvents(filter) {
+        const db = getDatabase(this.projectRoot);
+        const conditions = [];
+        const params = [];
+        if (filter?.eventType) {
+            conditions.push('event_type = ?');
+            params.push(filter.eventType);
+        }
+        if (filter?.since) {
+            conditions.push('timestamp >= ?');
+            params.push(filter.since);
+        }
+        let sql = 'SELECT * FROM telemetry';
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY timestamp DESC';
+        if (filter?.limit) {
+            sql += ' LIMIT ?';
+            params.push(filter.limit);
+        }
+        const rows = db.prepare(sql).all(...params);
+        return rows.map(this.rowToEntry);
+    }
+    getStats(since) {
+        const db = getDatabase(this.projectRoot);
+        const whereClause = since ? ' WHERE timestamp >= ?' : '';
+        const params = since ? [since] : [];
+        const countRows = db
+            .prepare(`SELECT event_type, COUNT(*) as cnt FROM telemetry${whereClause} GROUP BY event_type`)
+            .all(...params);
+        const eventsByType = {};
+        let totalEvents = 0;
+        let cacheHits = 0;
+        let cacheMisses = 0;
+        for (const row of countRows) {
+            eventsByType[row.event_type] = row.cnt;
+            totalEvents += row.cnt;
+            if (row.event_type === 'cache_hit')
+                cacheHits = row.cnt;
+            if (row.event_type === 'cache_miss')
+                cacheMisses = row.cnt;
+        }
+        const hitTotal = cacheHits + cacheMisses;
+        const hitRatio = hitTotal > 0 ? cacheHits / hitTotal : 0;
+        const tokenRow = db
+            .prepare(`SELECT COALESCE(SUM(tokens_estimated), 0) as total FROM telemetry WHERE event_type = 'cache_hit'${since ? ' AND timestamp >= ?' : ''}`)
+            .get(...params);
+        return {
+            totalEvents,
+            cacheHits,
+            cacheMisses,
+            hitRatio,
+            totalTokensSaved: tokenRow.total,
+            eventsByType,
+        };
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    getSamplingRate() {
+        return this.samplingRate;
+    }
+    setSamplingRate(rate) {
+        this.samplingRate = Math.max(0.0, Math.min(1.0, rate));
+    }
+    exportEvents(filter) {
+        const db = getDatabase(this.projectRoot);
+        const conditions = [];
+        const params = [];
+        if (filter?.eventType) {
+            conditions.push('event_type = ?');
+            params.push(filter.eventType);
+        }
+        if (filter?.since) {
+            conditions.push('timestamp >= ?');
+            params.push(filter.since);
+        }
+        let sql = 'SELECT * FROM telemetry';
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY timestamp ASC';
+        const rows = db.prepare(sql).all(...params);
+        return rows
+            .map((row) => {
+            const entry = this.rowToEntry(row);
+            return JSON.stringify({
+                timestamp: entry.timestamp,
+                eventType: entry.eventType,
+                filePath: entry.filePath,
+                tokensEstimated: entry.tokensEstimated,
+                metadata: entry.metadata,
+            });
+        })
+            .join('\n');
+    }
+    enforceRetention(maxAgeDays) {
+        const db = getDatabase(this.projectRoot);
+        const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+        const result = db.prepare('DELETE FROM telemetry WHERE timestamp < ?').run(cutoff);
+        return result.changes;
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            timestamp: row.timestamp,
+            eventType: row.event_type,
+            filePath: row.file_path,
+            tokensEstimated: row.tokens_estimated,
+            metadata: row.metadata_json ? JSON.parse(row.metadata_json) : null,
+        };
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/telemetry/tracker.js.map

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

package/dist/tools/force-reread.d.ts

@@ -0,0 +1,9 @@
+import type { FileSummary } from '../types.js';
+export declare function forceReread(projectRoot: string, relativePath: string): Promise<{
+    path: string;
+    hash: string;
+    summary: FileSummary;
+    reread: true;
+    reason: string;
+}>;
+//# sourceMappingURL=force-reread.d.ts.map

package/dist/tools/force-reread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-reread.d.ts","sourceRoot":"","sources":["../../src/tools/force-reread.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAW7F"}

package/dist/tools/force-reread.js

@@ -0,0 +1,17 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { hashContents } from '../cache/hash.js';
+import { CacheStore } from '../cache/store.js';
+import { summarizeFile } from '../indexer/summarizer.js';
+import { validatePath } from '../utils/validate-path.js';
+export async function forceReread(projectRoot, relativePath) {
+    relativePath = validatePath(projectRoot, relativePath);
+    const absolutePath = join(projectRoot, relativePath);
+    const contents = await readFile(absolutePath, 'utf-8');
+    const hash = hashContents(contents);
+    const summary = summarizeFile(relativePath, contents);
+    const store = new CacheStore(projectRoot);
+    store.setEntry(relativePath, hash, summary);
+    return { path: relativePath, hash, summary, reread: true, reason: 'force_reread: explicitly requested' };
+}
+//# sourceMappingURL=force-reread.js.map

package/dist/tools/force-reread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-reread.js","sourceRoot":"","sources":["../../src/tools/force-reread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,YAAoB;IAEpB,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1C,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;AAC3G,CAAC"}

package/dist/tools/get-changed-files.d.ts

@@ -0,0 +1,8 @@
+export interface ChangedFilesResult {
+    changed: string[];
+    added: string[];
+    deleted: string[];
+    checkedAt: string;
+}
+export declare function getChangedFiles(projectRoot: string, since?: string): Promise<ChangedFilesResult>;
+//# sourceMappingURL=get-changed-files.d.ts.map

package/dist/tools/get-changed-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-changed-files.d.ts","sourceRoot":"","sources":["../../src/tools/get-changed-files.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CAuD7B"}