@tyroneross/bookmark 0.1.0 → 0.3.2

package/dist/registry.js

@@ -0,0 +1,134 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+const REGISTRY_VERSION = '1.0.0';
+const MAX_ENTRIES = 500;
+/**
+ * Resolve a human-readable project name from a directory path.
+ *
+ * Resolution order:
+ * 1. package.json "name" field in cwd
+ * 2. basename of git repo root (walk up until .git is found)
+ * 3. basename of cwd — unless it's the home directory
+ * 4. Fallback: basename(cwd) regardless
+ */
+export function resolveProjectName(cwd) {
+    const home = homedir();
+    // 1. package.json name
+    const pkgPath = join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.name && pkg.name.trim()) {
+                // Strip scoped package prefix (@scope/name → name)
+                return pkg.name.replace(/^@[^/]+\//, '').trim();
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // 2. Walk up looking for .git directory
+    let dir = cwd;
+    const root = dirname(home); // Stop before going above home's parent
+    while (dir && dir !== root && dir !== dirname(dir)) {
+        if (existsSync(join(dir, '.git'))) {
+            return basename(dir);
+        }
+        dir = dirname(dir);
+    }
+    // 3. Avoid returning home dir basename as the name
+    const cwdBase = basename(cwd);
+    if (cwd === home || cwdBase === basename(home)) {
+        return 'home';
+    }
+    return cwdBase;
+}
+export function getRegistryPath() {
+    return join(homedir(), '.bookmark', 'registry.json');
+}
+function ensureRegistryDir() {
+    const dir = join(homedir(), '.bookmark');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+export function loadRegistry() {
+    const path = getRegistryPath();
+    if (!existsSync(path)) {
+        return { version: REGISTRY_VERSION, last_updated: 0, snapshots: [] };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed.snapshots)
+            parsed.snapshots = [];
+        return parsed;
+    }
+    catch {
+        return { version: REGISTRY_VERSION, last_updated: 0, snapshots: [] };
+    }
+}
+function saveRegistry(registry) {
+    ensureRegistryDir();
+    registry.last_updated = Date.now();
+    writeFileSync(getRegistryPath(), JSON.stringify(registry, null, 2), 'utf-8');
+}
+export function appendToRegistry(snapshot, canonicalFile) {
+    try {
+        const registry = loadRegistry();
+        const entry = {
+            id: snapshot.snapshot_id,
+            timestamp: snapshot.timestamp,
+            trigger: snapshot.trigger,
+            project_path: snapshot.project_path,
+            project_name: resolveProjectName(snapshot.project_path),
+            canonical_file: canonicalFile,
+            files_changed_count: snapshot.files_changed.length,
+        };
+        // Dedupe by id, newest wins
+        registry.snapshots = [entry, ...registry.snapshots.filter(e => e.id !== entry.id)];
+        if (registry.snapshots.length > MAX_ENTRIES) {
+            registry.snapshots.length = MAX_ENTRIES;
+        }
+        registry.last_project = {
+            path: snapshot.project_path,
+            name: entry.project_name,
+            last_activity_at: snapshot.timestamp,
+        };
+        saveRegistry(registry);
+    }
+    catch {
+        // Never break capture for registry bookkeeping
+    }
+}
+export function touchLastProject(projectPath) {
+    try {
+        const registry = loadRegistry();
+        registry.last_project = {
+            path: projectPath,
+            name: resolveProjectName(projectPath),
+            last_activity_at: Date.now(),
+        };
+        saveRegistry(registry);
+    }
+    catch {
+        // Silent — never break restore for bookkeeping
+    }
+}
+export function findById(id) {
+    const registry = loadRegistry();
+    return registry.snapshots.find(e => e.id === id) ?? null;
+}
+export function getLastProject() {
+    return loadRegistry().last_project ?? null;
+}
+/** Prune entries whose canonical_file is missing. Lazy cleanup on read paths. */
+export function pruneStale() {
+    const registry = loadRegistry();
+    const live = registry.snapshots.filter(e => existsSync(e.canonical_file));
+    if (live.length !== registry.snapshots.length) {
+        registry.snapshots = live;
+        saveRegistry(registry);
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/restore/index.d.ts

@@ -7,7 +7,19 @@ export interface RestoreOptions {
 }
 /**
  * Generate restoration context for a SessionStart hook.
- * Returns a HookOutput with systemMessage containing the LATEST.md content.
+ *
+ * v0.4 adds:
+ *  1. BOOKMARK_IDENTITY parsing + repo_path validation
+ *  2. Home-scope pointer delegation to a canonical repo bookmark
+ *  3. Hard staleness block at 72h (instead of soft warning only)
+ *
+ * Cascade:
+ *  1. bookmark.context.md — if present and useful
+ *     1a. If identity scope=home + points_to_canonical, follow the pointer
+ *     1b. If identity scope=repo and path mismatch, prefix a warning
+ *     1c. If age >= STALENESS_HARD_BLOCK_HOURS, return staleness block
+ *  2. LATEST.md — file tracking fallback
+ *  3. Empty
  */
 export declare function restoreContext(options: RestoreOptions): HookOutput;
 //# sourceMappingURL=index.d.ts.map

package/dist/restore/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/restore/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAoDlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/restore/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;CACjD;AAWD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAqFlE"}

package/dist/restore/index.js

@@ -1,67 +1,190 @@
-import { existsSync } from 'node:fs';
-import { readLatestMd, loadLatestSnapshot, getSnapshotCount } from '../snapshot/storage.js';
+import { existsSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { readLatestMd, getSnapshotCount } from '../snapshot/storage.js';
+import { readContextMd } from '../trails/reader.js';
+import { parseIdentity, validateRepoIdentity, followPointer, } from '../trails/identity.js';
 import { loadState, saveState, resetForNewSession, incrementCompaction } from '../threshold/state.js';
 import { loadConfig, getStoragePath } from '../config.js';
+import { touchLastProject } from '../registry.js';
+/**
+ * Hours after which a bookmark is considered too stale to auto-restore.
+ * Below this threshold: restore with a soft warning.
+ * At or above: hard-block — return an empty context with guidance instead
+ * of risking a confident wrong start from stale content.
+ */
+const STALENESS_HARD_BLOCK_HOURS = 72;
+const STALENESS_SOFT_WARN_HOURS = 24;
 /**
  * Generate restoration context for a SessionStart hook.
- * Returns a HookOutput with systemMessage containing the LATEST.md content.
+ *
+ * v0.4 adds:
+ *  1. BOOKMARK_IDENTITY parsing + repo_path validation
+ *  2. Home-scope pointer delegation to a canonical repo bookmark
+ *  3. Hard staleness block at 72h (instead of soft warning only)
+ *
+ * Cascade:
+ *  1. bookmark.context.md — if present and useful
+ *     1a. If identity scope=home + points_to_canonical, follow the pointer
+ *     1b. If identity scope=repo and path mismatch, prefix a warning
+ *     1c. If age >= STALENESS_HARD_BLOCK_HOURS, return staleness block
+ *  2. LATEST.md — file tracking fallback
+ *  3. Empty
  */
 export function restoreContext(options) {
     const config = loadConfig(options.cwd);
     const storagePath = getStoragePath(options.cwd, config);
     const state = loadState(storagePath);
-    // Handle session state transitions
     handleSessionTransition(storagePath, state, options, config.thresholds);
-    // Check if restoration is needed
-    if (!config.restoreOnSessionStart) {
-        return {};
+    const stopRequestedPath = join(storagePath, '.stop-requested');
+    if (existsSync(stopRequestedPath)) {
+        try {
+            unlinkSync(stopRequestedPath);
+        }
+        catch { /* ignore */ }
     }
-    // On resume, context is likely intact — skip restoration
-    if (options.source === 'resume') {
+    if (!config.restoreOnSessionStart)
         return {};
+    if (options.source === 'resume')
+        return {};
+    // Primary: bookmark.context.md with identity-aware handling
+    const rawContextMd = readContextMd(storagePath);
+    if (rawContextMd && isContextMdUseful(rawContextMd)) {
+        const contextPath = join(storagePath, 'bookmark.context.md');
+        const { identity, bodyWithoutIdentity } = parseIdentity(rawContextMd);
+        // 1a. Home-scope pointer? Follow it to the canonical repo bookmark.
+        if (identity?.scope === 'home') {
+            const target = followPointer(identity);
+            if (target) {
+                const targetAge = target.staleness_hours ?? 0;
+                if (targetAge >= STALENESS_HARD_BLOCK_HOURS) {
+                    trackRestore(storagePath, 0);
+                    return { systemMessage: buildHardStalenessMessage(target.canonical_path, targetAge) };
+                }
+                // Strip identity block from target content for cleaner display
+                const { bodyWithoutIdentity: targetBody } = parseIdentity(target.content);
+                const header = buildPointerFollowHeader(identity, target.canonical_path, targetAge);
+                const message = `${header}\n\n${targetBody}`;
+                trackRestore(storagePath, message.length);
+                if (identity.points_to_canonical) {
+                    touchLastProject(derivProjectFromCanonical(identity.points_to_canonical));
+                }
+                return { systemMessage: message };
+            }
+            // Pointer target missing — fall through to present the pointer body itself
+        }
+        // 1c. Hard staleness block
+        const ageHours = getAgeHours(contextPath);
+        if (ageHours !== null && ageHours >= STALENESS_HARD_BLOCK_HOURS) {
+            trackRestore(storagePath, 0);
+            return { systemMessage: buildHardStalenessMessage(contextPath, ageHours) };
+        }
+        // 1b. Path-mismatch warning for repo-scoped identities
+        const mismatchWarning = identity ? validateRepoIdentity(identity, options.cwd) : null;
+        // Soft staleness warning
+        const softWarning = ageHours !== null && ageHours >= STALENESS_SOFT_WARN_HOURS
+            ? `[Note: This bookmark context is ${ageHours}h old and may be outdated.]`
+            : null;
+        const prefixes = [mismatchWarning, softWarning].filter(Boolean).join('\n\n');
+        const message = prefixes ? `${prefixes}\n\n${bodyWithoutIdentity}` : bodyWithoutIdentity;
+        trackRestore(storagePath, message.length);
+        touchLastProject(options.cwd);
+        return { systemMessage: message };
     }
-    // Check for existing snapshots
-    const snapshotCount = getSnapshotCount(storagePath);
-    if (snapshotCount === 0) {
-        // First run — tell Claude that bookmark is active
-        return {
-            systemMessage: '[Bookmark: Active — no snapshots yet. Snapshots will be captured automatically ' +
-                'before compaction, on 20-minute intervals, and at session end.]\n\n' +
-                'Briefly let the user know that Bookmark is active and will start capturing context snapshots automatically.',
-        };
+    if (rawContextMd) {
+        trackBoilerplateCaught(storagePath);
     }
-    // Read LATEST.md
+    // Fallback: LATEST.md
+    const snapshotCount = getSnapshotCount(storagePath);
     const latestMd = readLatestMd(storagePath);
-    if (!latestMd) {
-        return {};
+    if (latestMd) {
+        const message = buildFallbackRestoration(latestMd, snapshotCount);
+        trackRestore(storagePath, message.length);
+        touchLastProject(options.cwd);
+        return { systemMessage: message };
+    }
+    // No local bookmark and no LATEST.md — stay silent rather than inject
+    // another repo's context. The home-scope pointer at ~/.bookmark/bookmark.context.md
+    // is the supported way to redirect from an empty CWD to a canonical project.
+    return {};
+}
+/** Derive the project path from a canonical bookmark.context.md path. */
+function derivProjectFromCanonical(canonicalPath) {
+    // .../<project>/.bookmark/bookmark.context.md → <project>
+    const marker = `/.bookmark/`;
+    const idx = canonicalPath.lastIndexOf(marker);
+    return idx > 0 ? canonicalPath.slice(0, idx) : canonicalPath;
+}
+/** Record a successful restore — chars injected / 4 ≈ tokens */
+function trackRestore(storagePath, charCount) {
+    try {
+        const state = loadState(storagePath);
+        state.restores_performed = (state.restores_performed ?? 0) + 1;
+        state.tokens_injected = (state.tokens_injected ?? 0) + Math.round(charCount / 4);
+        saveState(storagePath, state);
+    }
+    catch { /* never break restore for tracking */ }
+}
+function trackBoilerplateCaught(storagePath) {
+    try {
+        const state = loadState(storagePath);
+        state.boilerplate_caught = (state.boilerplate_caught ?? 0) + 1;
+        saveState(storagePath, state);
     }
-    if (options.format === 'json') {
-        const snapshot = loadLatestSnapshot(storagePath);
-        return {
-            systemMessage: JSON.stringify(snapshot, null, 2),
-        };
+    catch { /* never break restore for tracking */ }
+}
+function isContextMdUseful(content) {
+    if (content.length < 200)
+        return false;
+    if (content.startsWith('[Bookmark Context') && !content.includes('## '))
+        return false;
+    const markers = ['## ', '**Task', '**Status', '**Progress', 'done', 'remaining', '- '];
+    return markers.some(m => content.includes(m));
+}
+function getAgeHours(path) {
+    try {
+        const mtime = statSync(path).mtimeMs;
+        return Math.round((Date.now() - mtime) / (1000 * 60 * 60));
     }
-    if (options.format === 'markdown') {
-        return {
-            systemMessage: latestMd,
-        };
+    catch {
+        return null;
     }
-    // Default: system_message format
-    const systemMessage = buildRestorationMessage(latestMd, snapshotCount);
-    return { systemMessage };
 }
-function buildRestorationMessage(latestMd, snapshotCount) {
+function buildHardStalenessMessage(path, ageHours) {
+    return [
+        `[Bookmark: auto-restore BLOCKED — source is ${ageHours}h stale (threshold ${STALENESS_HARD_BLOCK_HOURS}h).]`,
+        '',
+        `The bookmark file at ${path} is too old to treat as current context.`,
+        'Stale auto-restore creates confident wrong starts — worse than no restore at all.',
+        '',
+        'To proceed, either:',
+        '- Run `/bookmark:list` and pick a specific snapshot explicitly',
+        '- Read the stale file manually if you still want its content: ' +
+            `\`cat "${path}"\``,
+        '- Ask the user what they were working on most recently',
+    ].join('\n');
+}
+function buildPointerFollowHeader(pointer, canonicalPath, ageHours) {
+    const lines = [
+        `[Bookmark: followed home-scope pointer → repo-scope bookmark]`,
+        '',
+        `Canonical file: ${canonicalPath}`,
+    ];
+    if (pointer.points_to_project) {
+        lines.push(`Project: ${pointer.points_to_project}`);
+    }
+    if (ageHours >= STALENESS_SOFT_WARN_HOURS) {
+        lines.push(`Age: ${ageHours}h (approaching staleness threshold of ${STALENESS_HARD_BLOCK_HOURS}h)`);
+    }
+    return lines.join('\n');
+}
+function buildFallbackRestoration(latestMd, snapshotCount) {
     const lines = [];
     lines.push('[Bookmark: Context recovered from previous session]');
     lines.push('');
-    lines.push('Briefly notify the user that their prior session context has been recovered by Bookmark.');
-    lines.push('');
-    lines.push('## Prior Session Context (Bookmark)');
-    lines.push('');
     lines.push(latestMd);
-    lines.push('');
     if (snapshotCount > 1) {
-        lines.push(`> ${snapshotCount} snapshots available. Use \`/bookmark:list\` for history or \`/bookmark:restore\` for a specific snapshot.`);
+        lines.push('');
+        lines.push(`> ${snapshotCount} snapshots available. \`/bookmark:list\` for history.`);
     }
     return lines.join('\n');
 }
@@ -72,16 +195,13 @@ function handleSessionTransition(storagePath, state, options, thresholds) {
     switch (source) {
         case 'startup':
         case 'clear':
-            // New session — reset compaction count
             updatedState = resetForNewSession(state, sessionId, thresholds);
             break;
         case 'compact':
-            // After compaction — increment compaction count
             updatedState = incrementCompaction(state, thresholds);
             updatedState.session_id = sessionId;
             break;
         case 'resume':
-            // Resuming — keep state, just update session ID if different
             updatedState = { ...state, session_id: sessionId, last_event_time: Date.now() };
             break;
         default:

package/dist/restore/index.js.map

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

package/dist/setup/auto-setup.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Register bookmark in Claude Code's installed_plugins.json.
+ * This is required for skill/command discovery — the symlink alone isn't enough.
+ */
+export declare function registerPlugin(): boolean;
 /**
  * Check if bookmark hooks are already configured in a project.
  */
@@ -9,8 +14,9 @@ export declare function isProjectConfigured(cwd: string): boolean;
  */
 export declare function setupProject(cwd: string): string[];
 /**
- * Auto-bootstrap: silently configure hooks if bookmark CLI runs in an unconfigured project.
- * Called at the top of CLI commands. No-op if already configured.
+ * Auto-bootstrap: silently configure storage if bookmark CLI runs in an unconfigured project.
+ * Called at the top of CLI commands. Creates .bookmark/ if needed.
+ * Works in any directory — not just npm projects.
  */
 export declare function ensureProjectBootstrapped(cwd: string): void;
 //# sourceMappingURL=auto-setup.d.ts.map

package/dist/setup/auto-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-setup.d.ts","sourceRoot":"","sources":["../../src/setup/auto-setup.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgClD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAW3D"}
+{"version":3,"file":"auto-setup.d.ts","sourceRoot":"","sources":["../../src/setup/auto-setup.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAqDxC;AA+CD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA2ClD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB3D"}