@tyroneross/bookmark 0.2.0 → 0.3.2

package/dist/types.d.ts

@@ -5,21 +5,24 @@ export interface Snapshot {
     project_path: string;
     trigger: SnapshotTrigger;
     compaction_cycle: number;
-    context_remaining_pct: number;
-    token_estimate: number;
-    intent: string;
-    progress: string;
-    current_status: string;
-    decisions: Decision[];
-    open_items: OpenItem[];
-    unknowns: string[];
     files_changed: FileActivity[];
-    errors_encountered: ErrorEntry[];
     tools_summary: Record<string, number>;
+    context_remaining_pct?: number;
+    context_used_pct?: number;
+    token_estimate?: number;
+    context_limit_tokens?: number;
+    model?: string;
+    intent?: string;
+    progress?: string;
+    current_status?: string;
+    decisions?: Decision[];
+    open_items?: OpenItem[];
+    unknowns?: string[];
+    errors_encountered?: ErrorEntry[];
     user_sentiment?: 'positive' | 'neutral' | 'negative';
     prior_snapshot_id?: string;
 }
-export type SnapshotTrigger = 'pre_compact' | 'time_interval' | 'manual' | 'session_end';
+export type SnapshotTrigger = 'pre_compact' | 'token_threshold' | 'time_interval' | 'manual' | 'session_end';
 export interface Decision {
     description: string;
     rationale?: string;
@@ -61,11 +64,11 @@ export interface SnapshotEntry {
     timestamp: number;
     trigger: SnapshotTrigger;
     compaction_cycle: number;
-    context_remaining_pct: number;
-    token_estimate: number;
-    decisions_count: number;
     files_changed_count: number;
-    open_items_count: number;
+    context_remaining_pct?: number;
+    token_estimate?: number;
+    decisions_count?: number;
+    open_items_count?: number;
 }
 export interface BookmarkState {
     version: string;
@@ -76,6 +79,17 @@ export interface BookmarkState {
     last_event_time: number;
     snapshot_interval_minutes: number;
     session_history: SessionEntry[];
+    restores_performed?: number;
+    tokens_injected?: number;
+    quality_blocks?: number;
+    boilerplate_caught?: number;
+    latest_model?: string;
+    latest_context_tokens?: number;
+    latest_context_limit_tokens?: number;
+    latest_context_used_pct?: number;
+    latest_context_observed_at?: number;
+    unknown_context_limit_notified_model?: string;
+    token_thresholds_triggered?: number[];
 }
 export interface SessionEntry {
     session_id: string;
@@ -101,29 +115,6 @@ export interface TranscriptContent {
     input?: Record<string, unknown>;
     content?: string | TranscriptContent[];
 }
-export interface TokenEstimate {
-    total_tokens: number;
-    message_count: number;
-    user_tokens: number;
-    assistant_tokens: number;
-    tool_tokens: number;
-    system_tokens: number;
-    context_limit: number;
-    remaining_pct: number;
-    remaining_tokens: number;
-}
-export interface ExtractionResult {
-    intent?: string;
-    progress?: string;
-    current_status: string;
-    decisions: Decision[];
-    open_items: OpenItem[];
-    unknowns: string[];
-    files_changed: FileActivity[];
-    errors_encountered: ErrorEntry[];
-    tools_summary: Record<string, number>;
-    user_sentiment?: 'positive' | 'neutral' | 'negative';
-}
 export interface HookInput {
     session_id: string;
     transcript_path: string;
@@ -133,6 +124,7 @@ export interface HookInput {
     trigger?: 'manual' | 'auto';
     source?: 'startup' | 'resume' | 'compact' | 'clear';
     custom_instructions?: string;
+    prompt?: string;
 }
 export interface HookOutput {
     systemMessage?: string;
@@ -143,20 +135,21 @@ export interface BookmarkConfig {
     thresholds: number[];
     maxThreshold: number;
     intervalMinutes: number;
-    contextLimitTokens: number;
-    charsPerToken: number;
     maxDecisions: number;
     maxOpenItems: number;
     maxFilesTracked: number;
     maxErrorsTracked: number;
-    summaryTokenBudget: number;
     maxActiveSnapshots: number;
     archiveAfterDays: number;
     snapshotOnSessionEnd: boolean;
     restoreOnSessionStart: boolean;
+    tokenThresholds: number[];
+    contextLimitTokens?: number;
     verboseLogging: boolean;
 }
 export interface SetupPreferences {
-    intervalMinutes: number;
+    intervalMinutes?: number;
+    tokenThresholds?: number[];
+    contextLimitTokens?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/hooks/hooks.json

@@ -1,51 +1,49 @@
 {
   "hooks": {
-    "PreCompact": [
+    "Stop": [
       {
         "matcher": "",
         "hooks": [
           {
             "type": "command",
-            "command": "npx @tyroneross/bookmark snapshot --trigger pre_compact 2>/dev/null || true",
-            "timeout": 30000,
-            "async": true
+            "command": "npx @tyroneross/bookmark stop 2>/dev/null || echo '{\"decision\": \"approve\"}'",
+            "timeout": 10000
           }
         ]
       }
     ],
-    "SessionStart": [
+    "PreCompact": [
       {
         "matcher": "",
         "hooks": [
           {
             "type": "command",
-            "command": "npx @tyroneross/bookmark restore 2>/dev/null || echo '{}'",
-            "timeout": 5000
+            "command": "npx @tyroneross/bookmark precompact 2>/dev/null || echo '{}'",
+            "timeout": 10000
           }
         ]
       }
     ],
-    "UserPromptSubmit": [
+    "SessionStart": [
       {
         "matcher": "",
         "hooks": [
           {
             "type": "command",
-            "command": "npx @tyroneross/bookmark check 2>/dev/null || true",
-            "timeout": 3000,
-            "async": true
+            "command": "npx @tyroneross/bookmark restore 2>/dev/null || echo '{}'",
+            "timeout": 5000
           }
         ]
       }
     ],
-    "Stop": [
+    "UserPromptSubmit": [
       {
         "matcher": "",
         "hooks": [
           {
             "type": "command",
-            "command": "npx @tyroneross/bookmark snapshot --trigger session_end 2>/dev/null || true",
-            "timeout": 15000
+            "command": "npx @tyroneross/bookmark context-check 2>/dev/null || echo '{}'",
+            "timeout": 10000
           }
         ]
       }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tyroneross/bookmark",
-  "version": "0.2.0",
-  "description": "Context snapshots for Claude Code — session continuity across compactions and terminals",
+  "version": "0.3.2",
+  "description": "Context snapshots for agent sessions, compactions, and terminal workflows",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,6 +25,8 @@
     "hooks",
     "agents",
     ".claude-plugin",
+    ".codex-plugin",
+    ".mcp.json",
     "scripts/install-plugin.sh",
     "CLAUDE.md",
     "README.md"
@@ -38,10 +40,10 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "postinstall": "node dist/setup/auto-setup.js || true",
-    "install-plugin": "bash scripts/install-plugin.sh --global"
+    "install-plugin": "bash scripts/install-plugin.sh --global",
+    "mcp": "node dist/mcp/server.js"
   },
   "keywords": [
-    "claude-code",
     "context",
     "snapshots",
     "session-continuity",
@@ -49,11 +51,11 @@
     "memory",
     "devtools"
   ],
-  "author": "Tyrone Ross",
-  "license": "MIT",
+  "author": "Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/tyroneross/bookmark"
+    "url": "git+https://github.com/tyroneross/bookmark.git"
   },
   "homepage": "https://github.com/tyroneross/bookmark#readme",
   "bugs": {
@@ -62,6 +64,10 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
     "commander": "^14.0.0",
     "glob": "^13.0.0"

package/scripts/install-plugin.sh

@@ -6,6 +6,41 @@ set -e
 
 SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 PLUGIN_DIR="$SCRIPT_DIR"
+INSTALLED_PLUGINS="$HOME/.claude/plugins/installed_plugins.json"
+
+register_plugin() {
+  # Register bookmark in installed_plugins.json for Claude Code discovery
+  node -e "
+const fs = require('fs');
+const path = '$INSTALLED_PLUGINS';
+const installPath = '$1';
+const now = new Date().toISOString();
+
+let data = { version: 2, plugins: {} };
+try {
+  if (fs.existsSync(path)) {
+    data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+  }
+} catch {}
+
+const key = 'bookmark@local';
+if (data.plugins[key]) {
+  data.plugins[key][0].installPath = installPath;
+  data.plugins[key][0].lastUpdated = now;
+} else {
+  data.plugins[key] = [{
+    scope: 'user',
+    installPath: installPath,
+    version: '0.2.1',
+    installedAt: now,
+    lastUpdated: now
+  }];
+}
+
+fs.mkdirSync(require('path').dirname(path), { recursive: true });
+fs.writeFileSync(path, JSON.stringify(data, null, 2));
+"
+}
 
 if [[ "$1" == "--global" ]]; then
   # Global install — link plugin for all projects
@@ -19,12 +54,25 @@ if [[ "$1" == "--global" ]]; then
   fi
   ln -sf "$PLUGIN_DIR" "$LINK_PATH"
   echo "Bookmark plugin linked globally: $LINK_PATH -> $PLUGIN_DIR"
+
+  # Register in installed_plugins.json
+  register_plugin "$PLUGIN_DIR"
+  echo "Registered bookmark in Claude Code plugin registry"
 else
   # Project-level install
   CWD="${2:-$(pwd)}"
   CLAUDE_DIR="$CWD/.claude"
   mkdir -p "$CLAUDE_DIR"
 
+  # Register globally (commands/skills need global registration)
+  CLAUDE_PLUGINS_DIR="$HOME/.claude/plugins"
+  mkdir -p "$CLAUDE_PLUGINS_DIR"
+  LINK_PATH="$CLAUDE_PLUGINS_DIR/bookmark"
+  if [ ! -L "$LINK_PATH" ] && [ ! -d "$LINK_PATH" ]; then
+    ln -sf "$PLUGIN_DIR" "$LINK_PATH"
+  fi
+  register_plugin "$PLUGIN_DIR"
+
   echo "Bookmark plugin installed for project: $CWD"
   echo ""
   echo "Commands available:"

package/skills/context-continuity/SKILL.md

@@ -1,49 +1,68 @@
 ---
 name: context-continuity
-description: This skill activates when the user mentions "what was I working on", "continue from last session", "restore context", "what did we decide", "pick up where I left off", "compaction happened", "lost context", "session context", or when resuming work after a break. Provides session continuity by accessing bookmark snapshots.
-version: 0.1.0
+description: Use when the user asks "what was I working on", "continue from last session", "restore context", "pick up where I left off", or after compaction/lost context. Restores session via bookmark snapshots.
+version: 0.2.0
+user-invocable: false
 ---
 
 # Context Continuity Workflow
 
-This skill helps restore and maintain context across Claude Code sessions and compactions.
+This skill restores and maintains context across Claude Code sessions and compactions using the Bookmark MCP tools.
 
 ## When to Activate
 
-- User asks about prior session work
+- User asks about prior session work or decisions
 - User wants to continue a previous task
 - After compaction when context was compressed
 - User reports "losing" context or decisions
+- Session start when prior context exists
 
 ## Restoration Flow
 
-1. Check for existing snapshots:
-```bash
-npx @tyroneross/bookmark status
-```
+### 1. Check snapshot inventory
 
-2. If snapshots exist, read the hot context:
-```bash
-npx @tyroneross/bookmark show --latest
-```
+Use the `bookmark status` MCP tool to check if snapshots exist and how fresh they are.
 
-3. Present the restored context to the user:
-   - **Current Status**: What was being worked on
-   - **Decisions Made**: Key choices with rationale
-   - **Open Items**: What still needs doing
-   - **Unknowns**: Blockers or questions
+The status tool returns: snapshot count, last capture time, freshness, compaction count, configured new-session threshold, and the latest measured model/context usage when available.
 
-4. Ask the user which open item to continue with.
+### 2. Restore context
 
-## After Restoration
+Use the `bookmark restore` MCP tool to load the latest session context. This returns a structured summary optimized for continuation:
+- **Current Status**: What was being worked on
+- **Decisions Made**: Key choices with rationale
+- **Open Items**: What still needs doing
+- **Unknowns**: Blockers or questions
+- **Files Changed**: What was modified
+
+### 3. Present and continue
+
+Summarize the restored context to the user. Ask which open item to continue with, or if the user has a new direction.
 
-Once context is restored, continue working normally. The automatic hooks handle future snapshots.
+## Browsing History
+
+To list available snapshots and view a specific one:
+
+1. Use the `bookmark list` MCP tool to see all snapshots with timestamps and triggers
+2. Use the `bookmark show` MCP tool with a snapshot_id to view full content of a specific snapshot
 
 ## Manual Snapshot
 
 If the user wants to explicitly save context before a break:
-```bash
-npx @tyroneross/bookmark snapshot --trigger manual
-```
 
-*bookmark — context snapshot*
+Use the `bookmark snapshot` MCP tool with trigger "manual" to capture current session state.
+
+## After Restoration
+
+Once context is restored, continue working normally. The automatic hooks handle future snapshots — no manual intervention needed.
+
+## MCP Tools Reference
+
+| Tool | Purpose |
+|------|---------|
+| `status` | Snapshot inventory — count, freshness, thresholds |
+| `restore` | Load latest or specific snapshot context for continuation |
+| `list` | Browse all snapshots with metadata |
+| `show` | View full content of a specific snapshot |
+| `snapshot` | Capture a manual snapshot of current session |
+
+*bookmark — session continuity*

package/commands/activate.md

@@ -1,20 +0,0 @@
----
-description: "Activate Bookmark context snapshots for this project"
-allowed-tools: Bash
----
-
-Activate Bookmark (context snapshots) for the current project. This configures hooks, creates storage directories, and sets up automatic context capture.
-
-Run the setup command:
-
-```bash
-npx @tyroneross/bookmark setup --defaults
-```
-
-After activation, confirm to the user:
-- Bookmark is now active for this project
-- Snapshots will be captured automatically before compaction, on 20-minute intervals, and at session end
-- Context will be restored automatically when starting a new session
-- Available commands: `/bookmark:snapshot`, `/bookmark:status`, `/bookmark:list`, `/bookmark:restore`
-
-*bookmark — context snapshot*

package/dist/transcript/estimator.d.ts

@@ -1,20 +0,0 @@
-import type { TokenEstimate } from '../types.js';
-export interface EstimateOptions {
-    contextLimit?: number;
-    charsPerToken?: number;
-    startOffset?: number;
-}
-/**
- * Estimate token usage from a transcript file.
- * Uses a simple chars/4 heuristic — accurate enough for threshold comparison.
- */
-export declare function estimateFromTranscript(transcriptPath: string, options?: EstimateOptions): TokenEstimate;
-/**
- * Quick file-size-based estimation without parsing.
- * Much faster for threshold checks — reads only file metadata.
- */
-export declare function quickEstimate(transcriptPath: string, contextLimit?: number, charsPerToken?: number): {
-    estimatedTokens: number;
-    remainingPct: number;
-};
-//# sourceMappingURL=estimator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"estimator.d.ts","sourceRoot":"","sources":["../../src/transcript/estimator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAMlE,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,aAAa,CA2Df;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,YAAY,SAAwB,EACpC,aAAa,SAAkB,GAC9B;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAiBnD"}

package/dist/transcript/estimator.js

@@ -1,95 +0,0 @@
-import { existsSync, statSync } from 'node:fs';
-import { parseTranscript } from './parser.js';
-const DEFAULT_CONTEXT_LIMIT = 200_000;
-const CHARS_PER_TOKEN = 4;
-/**
- * Estimate token usage from a transcript file.
- * Uses a simple chars/4 heuristic — accurate enough for threshold comparison.
- */
-export function estimateFromTranscript(transcriptPath, options) {
-    const contextLimit = options?.contextLimit ?? DEFAULT_CONTEXT_LIMIT;
-    const charsPerToken = options?.charsPerToken ?? CHARS_PER_TOKEN;
-    if (!existsSync(transcriptPath)) {
-        return emptyEstimate(contextLimit);
-    }
-    const { entries } = parseTranscript(transcriptPath, {
-        startOffset: options?.startOffset,
-    });
-    let userChars = 0;
-    let assistantChars = 0;
-    let toolChars = 0;
-    let systemChars = 0;
-    for (const entry of entries) {
-        const text = typeof entry.content === 'string' ? entry.content : '';
-        const len = text.length;
-        switch (entry.type) {
-            case 'user':
-                userChars += len;
-                break;
-            case 'assistant':
-                assistantChars += len;
-                break;
-            case 'tool_use':
-            case 'tool_result':
-                toolChars += len;
-                break;
-            case 'system':
-                systemChars += len;
-                break;
-        }
-    }
-    const totalChars = userChars + assistantChars + toolChars + systemChars;
-    const totalTokens = Math.ceil(totalChars / charsPerToken);
-    const userTokens = Math.ceil(userChars / charsPerToken);
-    const assistantTokens = Math.ceil(assistantChars / charsPerToken);
-    const toolTokens = Math.ceil(toolChars / charsPerToken);
-    const systemTokens = Math.ceil(systemChars / charsPerToken);
-    const remainingTokens = Math.max(0, contextLimit - totalTokens);
-    const remainingPct = contextLimit > 0 ? remainingTokens / contextLimit : 1;
-    return {
-        total_tokens: totalTokens,
-        message_count: entries.length,
-        user_tokens: userTokens,
-        assistant_tokens: assistantTokens,
-        tool_tokens: toolTokens,
-        system_tokens: systemTokens,
-        context_limit: contextLimit,
-        remaining_pct: Math.round(remainingPct * 100) / 100,
-        remaining_tokens: remainingTokens,
-    };
-}
-/**
- * Quick file-size-based estimation without parsing.
- * Much faster for threshold checks — reads only file metadata.
- */
-export function quickEstimate(transcriptPath, contextLimit = DEFAULT_CONTEXT_LIMIT, charsPerToken = CHARS_PER_TOKEN) {
-    if (!existsSync(transcriptPath)) {
-        return { estimatedTokens: 0, remainingPct: 1 };
-    }
-    try {
-        const stat = statSync(transcriptPath);
-        // File size in bytes ≈ chars for ASCII-heavy content
-        // JSON overhead adds ~30%, so adjust
-        const estimatedContentChars = stat.size * 0.7;
-        const estimatedTokens = Math.ceil(estimatedContentChars / charsPerToken);
-        const remainingPct = Math.max(0, Math.round((1 - estimatedTokens / contextLimit) * 100) / 100);
-        return { estimatedTokens, remainingPct };
-    }
-    catch {
-        return { estimatedTokens: 0, remainingPct: 1 };
-    }
-}
-function emptyEstimate(contextLimit) {
-    return {
-        total_tokens: 0,
-        message_count: 0,
-        user_tokens: 0,
-        assistant_tokens: 0,
-        tool_tokens: 0,
-        system_tokens: 0,
-        context_limit: contextLimit,
-        remaining_pct: 1,
-        remaining_tokens: contextLimit,
-    };
-}
-//# sourceMappingURL=estimator.js.map

package/dist/transcript/estimator.js.map

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