@pcircle/footprint 1.1.1 → 1.2.0

package/README.md

@@ -5,7 +5,7 @@
 
 Model Context Protocol (MCP) server that automatically captures and encrypts LLM conversations as legal evidence.
 
-## Why EvidenceMCP?
+## Why Footprint?
 
 - **Prove IP Ownership** - Timestamped evidence of LLM-assisted work
 - **Zero Effort** - Automatic capture via MCP protocol
@@ -21,12 +21,14 @@ npm install -g @pcircle/footprint
 ## Quick Start
 
 1. **Set environment variables:**
+
 ```bash
-export EVIDENCEMCP_DB_PATH="./evidence.db"
-export EVIDENCEMCP_PASSWORD="your-secure-password"
+export FOOTPRINT_DB_PATH="./evidence.db"
+export FOOTPRINT_PASSWORD="your-secure-password"
 ```
 
 2. **Configure Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
 ```json
 {
   "mcpServers": {
@@ -34,8 +36,8 @@ export EVIDENCEMCP_PASSWORD="your-secure-password"
       "command": "npx",
       "args": ["footprint"],
       "env": {
-        "EVIDENCEMCP_DB_PATH": "/path/to/evidence.db",
-        "EVIDENCEMCP_PASSWORD": "your-password"
+        "FOOTPRINT_DB_PATH": "/path/to/evidence.db",
+        "FOOTPRINT_PASSWORD": "your-password"
       }
     }
   }
@@ -50,20 +52,171 @@ export EVIDENCEMCP_PASSWORD="your-secure-password"
 - 🕒 Git commit timestamps
 - 📦 Tamper-proof ZIP exports
 - 🔍 Search and retrieve evidence
+- 🤖 AI-powered capture suggestions
+- ✅ Integrity verification
+- 🏷️ Tag management
+- 📊 Interactive UI dashboard
+
+## Architecture
+
+The Footprint MCP server follows a modular, layered architecture:
+
+```
+src/
+├── index.ts              # Main MCP server
+├── tools/                # MCP tool handlers (11 tools)
+│   ├── capture-footprint.ts
+│   ├── list-footprints.ts
+│   ├── get-footprint.ts
+│   ├── export-footprints.ts
+│   ├── search-footprints.ts
+│   ├── verify-footprint.ts
+│   ├── suggest-capture.ts
+│   ├── delete-footprints.ts
+│   ├── rename-tag.ts
+│   ├── remove-tag.ts
+│   └── get-tag-stats.ts
+├── analyzers/            # Content analysis modules
+│   └── content-analyzer.ts
+├── lib/
+│   ├── crypto/           # Encryption & key derivation
+│   ├── storage/          # Database & export
+│   ├── tool-wrapper.ts   # Error handling wrapper
+│   └── tool-response.ts  # Response formatters
+└── ui/                   # Interactive dashboards
+```
+
+### Design Principles
+
+- **Modular**: Each tool is self-contained with schema, metadata, and handler
+- **Type-Safe**: Full TypeScript with Zod schema validation
+- **Testable**: Dependency injection enables isolated testing
+- **Secure**: Encrypted storage with integrity verification
+- **Maintainable**: Clear separation of concerns across layers
 
 ## MCP Tools
 
-### capture-footprint
-Captures and encrypts an LLM conversation.
+### Core Tools
+
+#### capture-footprint
+
+Captures and encrypts an LLM conversation as evidence.
+
+**Parameters:**
+
+- `conversationId` - Unique identifier for the conversation
+- `llmProvider` - LLM provider name (e.g., "Claude Sonnet 4.5")
+- `content` - Full conversation content
+- `messageCount` - Number of messages in conversation
+- `tags` (optional) - Comma-separated tags
+
+#### list-footprints
+
+Lists all captured evidence with pagination support.
 
-### list-footprints
-Lists all captured evidence with pagination.
+**Parameters:**
+
+- `limit` (optional) - Maximum results per page
+- `offset` (optional) - Pagination offset
+
+#### get-footprint
 
-### get-footprint
 Retrieves and decrypts specific evidence by ID.
 
-### export-footprints
-Exports evidence to encrypted ZIP archive.
+**Parameters:**
+
+- `id` - Evidence ID
+
+#### export-footprints
+
+Exports evidence to tamper-proof encrypted ZIP archive.
+
+**Parameters:**
+
+- `evidenceIds` - Array of evidence IDs to export
+- `includeGitInfo` (optional) - Include git metadata
+
+### Search & Discovery
+
+#### search-footprints
+
+Search and filter evidence by query, tags, or date range.
+
+**Parameters:**
+
+- `query` (optional) - Search text (matches conversationId, tags)
+- `tags` (optional) - Array of tags to filter by
+- `dateFrom` (optional) - Start date (ISO format)
+- `dateTo` (optional) - End date (ISO format)
+- `limit` (optional) - Maximum results
+- `offset` (optional) - Pagination offset
+
+#### suggest-capture
+
+Analyze conversation content and suggest whether to capture it as evidence.
+
+**Parameters:**
+
+- `summary` - Conversation summary or key content to analyze
+
+**Returns:**
+
+- `shouldCapture` - Whether to capture (based on keyword analysis)
+- `reason` - Human-readable explanation
+- `suggestedTags` - Recommended tags
+- `suggestedConversationId` - Recommended ID
+- `confidence` - Confidence score (0-1)
+
+### Verification
+
+#### verify-footprint
+
+Verify the integrity and authenticity of captured evidence.
+
+**Parameters:**
+
+- `id` - Evidence ID to verify
+
+**Returns:**
+
+- `verified` - Overall verification status
+- `checks` - Detailed checks (content integrity, git timestamp, encryption)
+- `legalReadiness` - Whether evidence meets legal standards
+
+### Management
+
+#### delete-footprints
+
+Delete evidence records permanently.
+
+**Parameters:**
+
+- `evidenceIds` - Array of evidence IDs to delete
+
+#### rename-tag
+
+Rename a tag across all evidence.
+
+**Parameters:**
+
+- `oldTag` - Current tag name
+- `newTag` - New tag name
+
+#### remove-tag
+
+Remove a tag from all evidence.
+
+**Parameters:**
+
+- `tag` - Tag name to remove
+
+#### get-tag-stats
+
+Get statistics about tag usage.
+
+**Returns:**
+
+- Tag names and their usage counts
 
 ## Security
 

package/SKILL.md

@@ -1,6 +1,10 @@
 # Footprint Agent Skill
 
-Capture and encrypt LLM conversations as tamper-proof legal evidence with Git timestamps.
+> MCP server for capturing and encrypting AI conversations as verifiable records with Git timestamps.
+
+**Package:** `@pcircle/footprint` (v1.1.1)  
+**Protocol:** Model Context Protocol (MCP)  
+**License:** MIT
 
 ## Decision Tree: Should I Capture This?
 
@@ -149,7 +153,7 @@ Human: We need to decide on the OAuth implementation...
 Assistant: I recommend using PKCE flow...
 ```
 
-### 4. `search-evidence`
+### 4. `search-footprints`
 Find evidence by content or tags.
 
 **Input Parameters:**
@@ -161,7 +165,7 @@ Find evidence by content or tags.
 }
 ```
 
-### 5. `export-evidence`
+### 5. `export-footprints`
 Export evidence as encrypted archive.
 
 **Input Parameters:**
@@ -183,6 +187,39 @@ Export evidence as encrypted archive.
 }
 ```
 
+### 6. `verify-footprint`
+Verify evidence integrity (checksum + Git timestamp).
+
+**Input Parameters:**
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+**Expected Output (text):**
+```
+🔐 Evidence Verification Report
+- ID: 550e8400-e29b-41d4-a716-446655440000
+- Content Hash: ✅ Valid (SHA-256 matches)
+- Git Timestamp: ✅ Verified (2026-01-28T14:30:45Z)
+- Encryption: ✅ Decryption successful
+- Status: AUTHENTIC - No tampering detected
+```
+
+**Expected Output (structuredContent):**
+```json
+{
+  "type": "verification_result",
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "contentHashValid": true,
+  "gitTimestampVerified": true,
+  "decryptionSuccessful": true,
+  "status": "authentic",
+  "timestamp": "2026-01-28T14:30:45Z"
+}
+```
+
 ## Best Practices
 
 ### Naming conversationId
@@ -216,9 +253,10 @@ Export evidence as encrypted archive.
 ### When to Use Each Tool
 - **capture-footprint**: Primary tool for saving conversations
 - **list-footprints**: Browse/overview existing evidence
-- **search-evidence**: Find specific content across evidence
+- **search-footprints**: Find specific content across evidence
 - **get-footprint**: Retrieve full content of specific evidence
-- **export-evidence**: Legal/audit export needs
+- **export-footprints**: Legal/audit export needs
+- **verify-footprint**: Verify evidence integrity and checksums
 
 ## Token-Efficient Agent Responses
 
@@ -249,10 +287,10 @@ Tags: {tags}
 
 | Error | Likely Cause | Recovery Action |
 |-------|--------------|-----------------|
-| "Password required" | EVIDENCEMCP_PASSWORD not set | 1. Check env config<br>2. Restart MCP server<br>3. Verify password in env |
+| "Password required" | FOOTPRINT_PASSWORD not set | 1. Check env config<br>2. Restart MCP server<br>3. Verify password in env |
 | "Evidence not found" | Invalid/wrong ID | 1. Use `list-footprints` to find correct ID<br>2. Search by conversationId<br>3. Check if user meant different evidence |
 | "Decryption failed" | Password changed/wrong | 1. Verify current password matches<br>2. Check if evidence pre-dates password change<br>3. Try with backup password if available |
-| "Database error" | DB path/permissions issues | 1. Check EVIDENCEMCP_DB_PATH exists<br>2. Verify file permissions<br>3. Create directory if missing |
+| "Database error" | DB path/permissions issues | 1. Check FOOTPRINT_DB_PATH exists<br>2. Verify file permissions<br>3. Create directory if missing |
 | "Git repository error" | Git not initialized | 1. Initialize git in evidence directory<br>2. Set git user.name/user.email<br>3. Make initial commit |
 | "Capture timeout" | Large conversation size | 1. Split into smaller chunks<br>2. Reduce messageCount<br>3. Compress content before capture |
 
@@ -309,11 +347,12 @@ Agent:
 
 ## Security & Verification
 
-- **Password**: Set via `EVIDENCEMCP_PASSWORD` env var (never ask user in chat)
-- **Encryption**: AES-256-GCM with Argon2id key derivation  
+- **Password**: Set via `FOOTPRINT_PASSWORD` env var (never ask user in chat)
+- **Encryption**: XChaCha20-Poly1305 (256-bit) with Argon2id key derivation  
 - **Git Timestamps**: Cryptographic proof of creation time
 - **SHA-256 Checksums**: Detect any content tampering
 - **Evidence Chain**: Each capture creates immutable Git commit
+- **Storage**: Local SQLite with encrypted BLOBs (no cloud, no tracking)
 
 **For legal proceedings:**
 1. Export evidence with `export-evidence` 
@@ -327,23 +366,41 @@ Agent:
 This section is for humans setting up the agent environment:
 
 ```bash
-# Install MCP server
-npm install -g @pcircle/footprint-server
+# Install MCP server globally
+npm install -g @pcircle/footprint
 
-# Claude Desktop config (~/.config/claude/claude_desktop_config.json)
+# Or run directly with npx
+npx @pcircle/footprint
+```
+
+**Claude Desktop config location:**
+
+| Platform | Config Path |
+|----------|-------------|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+
+**Config content:**
+```json
 {
   "mcpServers": {
     "footprint": {
-      "command": "footprint",
+      "command": "npx",
+      "args": ["@pcircle/footprint"],
       "env": {
-        "EVIDENCEMCP_DB_PATH": "~/evidence/evidence.db",
-        "EVIDENCEMCP_PASSWORD": "your-secure-password-here"
+        "FOOTPRINT_DB_PATH": "/path/to/evidence.db",
+        "FOOTPRINT_PASSWORD": "your-secure-password-here"
       }
     }
   }
 }
 ```
 
+**Environment Variables:**
+- `FOOTPRINT_PASSWORD` (required): Encryption passphrase
+- `FOOTPRINT_DB_PATH` (optional): Path to SQLite database (default: `./evidence.db` in current directory)
+
 ## Performance Notes
 
 - **Capture time**: ~1-3 seconds per conversation

package/dist/src/analyzers/content-analyzer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Content analyzer for determining if conversation content should be captured as evidence
+ * Analyzes keywords, calculates confidence, and generates appropriate metadata
+ */
+export interface AnalysisResult {
+    shouldCapture: boolean;
+    reason: string;
+    suggestedTags: string[];
+    suggestedConversationId: string;
+    confidence: number;
+    [key: string]: unknown;
+}
+/**
+ * Analyze conversation content and determine if it should be captured as evidence
+ *
+ * @param summary - Conversation summary or key content to analyze
+ * @returns Analysis result with capture recommendation and metadata
+ */
+export declare function analyzeContent(summary: string): AnalysisResult;
+//# sourceMappingURL=content-analyzer.d.ts.map

package/dist/src/analyzers/content-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analyzers/content-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAkLD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAuB9D"}

package/dist/src/analyzers/content-analyzer.js

@@ -0,0 +1,169 @@
+/**
+ * Content analyzer for determining if conversation content should be captured as evidence
+ * Analyzes keywords, calculates confidence, and generates appropriate metadata
+ */
+/**
+ * Keyword categories for detecting important content
+ */
+const KEYWORD_CATEGORIES = {
+    ip: [
+        "patent",
+        "intellectual property",
+        "invention",
+        "algorithm",
+        "proprietary",
+        "innovation",
+        "design",
+    ],
+    legal: [
+        "contract",
+        "agreement",
+        "legal",
+        "copyright",
+        "license",
+        "terms",
+        "clause",
+        "liability",
+    ],
+    business: [
+        "decision",
+        "milestone",
+        "deliverable",
+        "approval",
+        "strategy",
+        "roadmap",
+        "budget",
+        "timeline",
+    ],
+    research: [
+        "hypothesis",
+        "findings",
+        "proof",
+        "research",
+        "study",
+        "experiment",
+        "analysis",
+        "data",
+    ],
+    compliance: [
+        "audit",
+        "compliance",
+        "evidence",
+        "documentation",
+        "regulation",
+        "policy",
+        "requirement",
+    ],
+};
+/**
+ * Match whole words only to avoid false positives
+ * (e.g., "logarithm" should not match "algorithm")
+ */
+function matchesWord(text, word) {
+    const regex = new RegExp(`\\b${word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, "i");
+    return regex.test(text);
+}
+/**
+ * Detect matching keyword categories in the text
+ */
+function findKeywordMatches(text) {
+    const matches = [];
+    for (const [category, keywords] of Object.entries(KEYWORD_CATEGORIES)) {
+        const foundKeywords = keywords.filter((keyword) => matchesWord(text, keyword));
+        if (foundKeywords.length > 0) {
+            const weight = foundKeywords.length / keywords.length;
+            matches.push({ category, keywords: foundKeywords, weight });
+        }
+    }
+    return matches;
+}
+/**
+ * Calculate confidence score based on keyword matches and text characteristics
+ *
+ * @param matches - Keyword matches found in text
+ * @param wordCount - Total word count in text
+ * @returns Confidence score between 0 and 1
+ */
+function calculateConfidence(matches, wordCount) {
+    if (matches.length === 0) {
+        // No keywords found = low importance confidence
+        // Longer text without keywords = slightly higher (might have missed something)
+        const lengthFactor = Math.min(wordCount / 200, 0.3); // Max 0.3 for very long text
+        return 0.1 + lengthFactor; // Range: 0.1 to 0.4
+    }
+    // More keywords and categories = higher importance confidence
+    const totalKeywords = matches.reduce((sum, match) => sum + match.keywords.length, 0);
+    const keywordDensity = totalKeywords / Math.max(wordCount, 1);
+    const categoryBonus = matches.length * 0.15;
+    const keywordBonus = Math.min(totalKeywords * 0.1, 0.4);
+    return Math.min(0.95, 0.3 + categoryBonus + keywordBonus + keywordDensity);
+}
+/**
+ * Generate human-readable reason for capture recommendation
+ */
+function generateReason(matches) {
+    if (matches.length === 0) {
+        return "Appears to be casual conversation with no critical business, legal, or IP content";
+    }
+    const categories = matches.map((m) => m.category === "ip" ? "IP" : m.category);
+    if (categories.length === 1) {
+        return `Contains ${categories[0]} keywords: ${matches[0].keywords.join(", ")}`;
+    }
+    return `Contains multiple important categories: ${categories.join(", ")}`;
+}
+/**
+ * Generate suggested tags from keyword matches
+ */
+function generateTags(matches) {
+    if (matches.length === 0) {
+        return [];
+    }
+    return [
+        ...new Set(matches.flatMap((m) => [m.category, ...m.keywords.slice(0, 2)])),
+    ];
+}
+/**
+ * Generate conversation ID based on matches and current date
+ */
+function generateConversationId(matches) {
+    const currentDate = new Date().toISOString().slice(0, 10);
+    if (matches.length === 0) {
+        return `conversation-${currentDate}`;
+    }
+    // Extract key terms for ID generation
+    const primaryKeywords = matches[0].keywords.slice(0, 2);
+    const cleanKeywords = primaryKeywords
+        .map((k) => k.replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, ""))
+        .filter((k) => k.length > 0);
+    if (cleanKeywords.length > 0) {
+        return `${cleanKeywords.join("-")}-${currentDate}`;
+    }
+    return `${matches[0].category}-discussion-${currentDate}`;
+}
+/**
+ * Analyze conversation content and determine if it should be captured as evidence
+ *
+ * @param summary - Conversation summary or key content to analyze
+ * @returns Analysis result with capture recommendation and metadata
+ */
+export function analyzeContent(summary) {
+    const normalizedText = summary.toLowerCase();
+    const wordCount = normalizedText.split(/\s+/).length;
+    // Find keyword matches
+    const matches = findKeywordMatches(normalizedText);
+    const shouldCapture = matches.length > 0;
+    // Calculate confidence
+    const confidence = calculateConfidence(matches, wordCount);
+    // Generate metadata
+    const reason = generateReason(matches);
+    const suggestedTags = generateTags(matches);
+    const suggestedConversationId = generateConversationId(matches);
+    return {
+        shouldCapture,
+        reason,
+        suggestedTags,
+        suggestedConversationId,
+        confidence: Math.round(confidence * 100) / 100,
+    };
+}
+//# sourceMappingURL=content-analyzer.js.map

package/dist/src/analyzers/content-analyzer.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import type { ServerConfig } from "./types.js";
+/**
+ * Footprint Server - Captures LLM conversations as encrypted evidence
+ * with Git timestamps and export capabilities.
+ */
+export declare class FootprintServer {
+    private server;
+    private config;
+    private db;
+    private derivedKey;
+    private keyDerivationPromise;
+    constructor(config: ServerConfig);
+    /**
+     * Get or derive encryption key using stored salt (thread-safe)
+     * Caches key in memory for performance, with cleanup on shutdown
+     * Handles concurrent calls by ensuring only one derivation happens at a time
+     *
+     * @returns 32-byte encryption key
+     * @throws Error if salt storage fails
+     */
+    private getDerivedKey;
+    /**
+     * Securely clear derived key from memory
+     * Should be called on server shutdown
+     */
+    private clearDerivedKey;
+    private registerTools;
+    private registerResources;
+    start(): Promise<void>;
+    /**
+     * Cleanup server resources
+     * Clears derived key from memory and closes database
+     */
+    close(): void;
+}
+export { FootprintTestHelpers } from "./test-helpers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAuC/C;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,oBAAoB,CAAoC;gBAEpD,MAAM,EAAE,YAAY;IAuBhC;;;;;;;OAOG;YACW,aAAa;IAsC3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IA2HrB,OAAO,CAAC,iBAAiB;IAqCnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACH,KAAK,IAAI,IAAI;CAId;AA6DD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}