@tyroneross/bookmark 0.1.0 → 0.3.2

package/dist/trails/identity.js

@@ -0,0 +1,117 @@
+/**
+ * BOOKMARK_IDENTITY block parser + validator.
+ *
+ * The identity block is an HTML comment at the top of bookmark.context.md
+ * that declares which project/repo/branch the summary belongs to. It makes
+ * cross-session restoration unambiguous — you can always verify the
+ * bookmark you're restoring from matches the CWD you're restoring into.
+ *
+ * Example:
+ *   <!-- BOOKMARK_IDENTITY
+ *   scope: repo
+ *   project: travel-planner
+ *   repo_path: /Users/me/Desktop/git-folder/Travel Planner
+ *   branch: feature/summer-camps
+ *   head: 4988383
+ *   written: 2026-04-11
+ *   -->
+ *
+ * Two scopes are supported:
+ *  - `repo`    — bookmark belongs to a specific git repo (or directory)
+ *  - `home`    — bookmark is a POINTER, no active context itself; delegates
+ *                via `points_to_canonical` to a repo-scoped bookmark
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+const IDENTITY_BLOCK = /<!--\s*BOOKMARK_IDENTITY\s*\n([\s\S]*?)\n\s*-->/;
+/**
+ * Parse a bookmark.context.md file's content and extract the identity block.
+ * Returns `identity: null` if no block is present — callers should treat that
+ * as a legacy/untagged file and fall back to current behavior.
+ */
+export function parseIdentity(content) {
+    const match = content.match(IDENTITY_BLOCK);
+    if (!match) {
+        return { identity: null, bodyWithoutIdentity: content };
+    }
+    const raw = {};
+    for (const line of match[1].split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon < 0)
+            continue;
+        const key = line.slice(0, colon).trim();
+        const value = line.slice(colon + 1).trim();
+        if (!key)
+            continue;
+        raw[key] = value;
+    }
+    const scopeRaw = (raw.scope ?? 'repo').toLowerCase();
+    const scope = scopeRaw === 'home' ? 'home' : 'repo';
+    const identity = {
+        scope,
+        project: raw.project,
+        repo_path: raw.repo_path,
+        repo_name: raw.repo_name,
+        branch: raw.branch,
+        head: raw.head,
+        base: raw.base,
+        written: raw.written,
+        written_by: raw.written_by,
+        points_to_project: raw.points_to_project,
+        points_to_repo: raw.points_to_repo,
+        points_to_canonical: raw.points_to_canonical,
+        raw,
+    };
+    // Body with block stripped — preserve surrounding content
+    const bodyWithoutIdentity = content.slice(0, match.index) + content.slice(match.index + match[0].length);
+    return { identity, bodyWithoutIdentity: bodyWithoutIdentity.replace(/^\s*\n+/, '') };
+}
+/**
+ * Validate a repo-scoped identity against the storage path that was loaded.
+ *
+ * Returns a warning string if the identity's `repo_path` disagrees with the
+ * working directory, suggesting the bookmark file was moved or the CWD is
+ * not the repo it describes. Returns null when they match or when we can't
+ * determine (missing field).
+ */
+export function validateRepoIdentity(identity, cwd) {
+    if (identity.scope !== 'repo')
+        return null;
+    if (!identity.repo_path)
+        return null;
+    const declared = resolve(identity.repo_path);
+    const actual = resolve(cwd);
+    if (declared === actual)
+        return null;
+    // Allow the case where CWD is a subdirectory of the declared repo
+    if (actual.startsWith(declared + '/'))
+        return null;
+    return (`[Bookmark identity mismatch] This bookmark.context.md declares ` +
+        `repo_path=${declared} but was loaded from cwd=${actual}. ` +
+        `Verify you are in the correct project before acting on the context below.`);
+}
+export function followPointer(identity) {
+    if (identity.scope !== 'home')
+        return null;
+    if (!identity.points_to_canonical)
+        return null;
+    const target = identity.points_to_canonical;
+    if (!existsSync(target))
+        return null;
+    try {
+        const content = readFileSync(target, 'utf-8');
+        const mtime = statSync(target).mtimeMs;
+        const staleness_hours = Math.round((Date.now() - mtime) / (1000 * 60 * 60));
+        const { identity: targetIdentity } = parseIdentity(content);
+        return {
+            canonical_path: target,
+            content,
+            identity: targetIdentity,
+            staleness_hours,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/trails/identity.js.map

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

package/dist/trails/reader.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read the bookmark.context.md trailhead file.
+ * This is the primary restoration source — compact (<400 tokens)
+ * with routing pointers to deeper trail files.
+ */
+export declare function readContextMd(storagePath: string): string | null;
+//# sourceMappingURL=reader.d.ts.map

package/dist/trails/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/trails/reader.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE"}

package/dist/trails/reader.js

@@ -0,0 +1,22 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Read the bookmark.context.md trailhead file.
+ * This is the primary restoration source — compact (<400 tokens)
+ * with routing pointers to deeper trail files.
+ */
+export function readContextMd(storagePath) {
+    const contextPath = join(storagePath, 'bookmark.context.md');
+    if (!existsSync(contextPath))
+        return null;
+    try {
+        const content = readFileSync(contextPath, 'utf-8');
+        if (!content.trim())
+            return null;
+        return content;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/trails/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/trails/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/trails/writer.d.ts

@@ -0,0 +1,9 @@
+import type { Snapshot } from '../types.js';
+/**
+ * Trail-routed memory writer.
+ *
+ * Writes file tracking data to trails/files.md.
+ * bookmark.context.md is Claude's domain — written via Stop/PreCompact prompt hooks.
+ */
+export declare function writeTrails(storagePath: string, snapshot: Snapshot): void;
+//# sourceMappingURL=writer.d.ts.map

package/dist/trails/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/trails/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAE1D;;;;;GAKG;AAIH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGzE"}

package/dist/trails/writer.js

@@ -0,0 +1,110 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Trail-routed memory writer.
+ *
+ * Writes file tracking data to trails/files.md.
+ * bookmark.context.md is Claude's domain — written via Stop/PreCompact prompt hooks.
+ */
+// ─── Public API ───
+export function writeTrails(storagePath, snapshot) {
+    const trailsDir = ensureTrailsDir(storagePath);
+    writeFileTrail(trailsDir, snapshot);
+}
+// ─── File Trail ───
+function writeFileTrail(trailsDir, snapshot) {
+    const trailPath = join(trailsDir, 'files.md');
+    // Load existing file entries and merge with new
+    const fileMap = loadFileEntries(trailPath);
+    for (const f of snapshot.files_changed) {
+        const shortPath = f.path.startsWith(snapshot.project_path)
+            ? f.path.slice(snapshot.project_path.length).replace(/^\//, '')
+            : f.path;
+        const existing = fileMap.get(shortPath);
+        if (existing) {
+            const ops = new Set([...existing.operations, ...f.operations]);
+            existing.operations = [...ops];
+            // Use max, not sum — same transcript produces same totals across snapshots
+            existing.lines_changed = Math.max(existing.lines_changed ?? 0, f.lines_changed ?? 0);
+            // Merge summaries: combine unique structural hints
+            if (f.summary) {
+                if (existing.summary) {
+                    const existingHints = new Set(existing.summary.split(', '));
+                    const newHints = f.summary.split(', ');
+                    for (const h of newHints)
+                        existingHints.add(h);
+                    existing.summary = [...existingHints].slice(0, 6).join(', ');
+                }
+                else {
+                    existing.summary = f.summary;
+                }
+            }
+        }
+        else {
+            fileMap.set(shortPath, {
+                path: shortPath,
+                operations: [...f.operations],
+                lines_changed: f.lines_changed,
+                summary: f.summary,
+            });
+        }
+    }
+    // Sort by lines changed descending
+    const files = [...fileMap.values()].sort((a, b) => (b.lines_changed ?? 0) - (a.lines_changed ?? 0));
+    const totalLines = files.reduce((sum, f) => sum + (f.lines_changed ?? 0), 0);
+    const lines = [];
+    lines.push('# File Trail');
+    lines.push(`> ${files.length} files, ~${totalLines} lines changed total`);
+    lines.push('');
+    for (const f of files) {
+        const lc = f.lines_changed ? ` ~${f.lines_changed}L` : '';
+        let line = `- \`${f.path}\` (${f.operations.join('/')}${lc})`;
+        if (f.summary) {
+            line += ` — ${f.summary}`;
+        }
+        lines.push(line);
+    }
+    writeFileSync(trailPath, lines.join('\n'), 'utf-8');
+    // Return top files with summaries for bookmark.context.md
+    const topFiles = files
+        .filter(f => f.summary)
+        .slice(0, 5)
+        .map(f => ({ path: f.path, summary: f.summary }));
+    return { count: files.length, totalLines, topFiles };
+}
+function loadFileEntries(trailPath) {
+    if (!existsSync(trailPath))
+        return new Map();
+    try {
+        const content = readFileSync(trailPath, 'utf-8');
+        const fileMap = new Map();
+        for (const line of content.split('\n')) {
+            // Parse: - `src/foo.ts` (edit/write ~123L) — +fn registerPlugin, +fn ensurePluginSymlink
+            const match = line.match(/^- `(.+?)` \(([^)]+)\)/);
+            if (match) {
+                const path = match[1];
+                const opsStr = match[2];
+                const ops = opsStr.replace(/\s*~\d+L/, '').split('/');
+                const lcMatch = opsStr.match(/~(\d+)L/);
+                const linesChanged = lcMatch ? parseInt(lcMatch[1], 10) : undefined;
+                // Extract summary after " — " if present
+                const summaryMatch = line.match(/\) — (.+)$/);
+                const summary = summaryMatch ? summaryMatch[1] : undefined;
+                fileMap.set(path, { path, operations: ops, lines_changed: linesChanged, summary });
+            }
+        }
+        return fileMap;
+    }
+    catch {
+        return new Map();
+    }
+}
+// ─── Helpers ───
+function ensureTrailsDir(storagePath) {
+    const trailsDir = join(storagePath, 'trails');
+    if (!existsSync(trailsDir)) {
+        mkdirSync(trailsDir, { recursive: true });
+    }
+    return trailsDir;
+}
+//# sourceMappingURL=writer.js.map

package/dist/trails/writer.js.map

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

package/dist/transcript/extractor.d.ts

@@ -1,7 +1,20 @@
-import type { TranscriptEntry, ExtractionResult } from '../types.js';
+import type { TranscriptEntry, FileActivity } from '../types.js';
+export interface ExtractOptions {
+    projectPath?: string;
+}
+export interface FilesAndToolsResult {
+    files_changed: FileActivity[];
+    tools_summary: Record<string, number>;
+}
 /**
- * Extract structured context from transcript entries using pattern matching.
- * Zero LLM calls — pure heuristic extraction.
+ * Extract file changes and tool usage from transcript entries.
+ * These are the two extraction functions that actually produce accurate data.
  */
-export declare function extractFromEntries(entries: TranscriptEntry[]): ExtractionResult;
+export declare function extractFilesAndTools(entries: TranscriptEntry[], options?: ExtractOptions): FilesAndToolsResult;
+export interface CommitGap {
+    edits_since_commit: number;
+    files_since_commit: number;
+    last_commit_index: number;
+}
+export declare function extractCommitGap(entries: TranscriptEntry[]): CommitGap;
 //# sourceMappingURL=extractor.d.ts.map

package/dist/transcript/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/transcript/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAA+D,MAAM,aAAa,CAAC;AA+BlI;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAkB/E"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/transcript/extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAyChF,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,mBAAmB,CAM9G;AAyID,MAAM,WAAW,SAAS;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,CA+BtE"}