@pcircle/footprint 1.2.2 → 1.5.0

package/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -3,231 +3,195 @@
 [![npm version](https://img.shields.io/npm/v/@pcircle/footprint)](https://www.npmjs.com/package/@pcircle/footprint)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-Model Context Protocol (MCP) server that automatically captures and encrypts LLM conversations as timestamped footprints.
+MCP server that automatically captures and encrypts AI conversations as verifiable records with Git timestamps and end-to-end encryption.
 
 ## Why Footprint?
 
-- **Prove IP Ownership** - Timestamped footprints of LLM-assisted work
-- **Zero Effort** - Automatic capture via MCP protocol
-- **Privacy First** - End-to-end encrypted, locally stored
-- **Legally Valid** - Git timestamps + SHA-256 checksums
+- **Prove IP Ownership** — Timestamped evidence of AI-assisted work
+- **Zero Effort** — Automatic capture via MCP protocol
+- **Privacy First** — End-to-end encrypted, locally stored
+- **Legally Valid** — Git timestamps + SHA-256 checksums
 
-## Installation
+## Quick Start
 
 ```bash
-npm install -g @pcircle/footprint
+npx @pcircle/footprint setup
 ```
 
-## Quick Start
-
-1. **Set environment variables:**
+The interactive wizard auto-detects your system, validates your encryption password, and configures Claude Desktop automatically.
 
-```bash
-export FOOTPRINT_DB_PATH="./footprints.db"
-export FOOTPRINT_PASSWORD="your-secure-password"
-```
+### Manual Configuration
 
-2. **Configure Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 
 ```json
 {
   "mcpServers": {
     "footprint": {
       "command": "npx",
-      "args": ["footprint"],
+      "args": ["@pcircle/footprint"],
       "env": {
-        "FOOTPRINT_DB_PATH": "/path/to/footprints.db",
-        "FOOTPRINT_PASSWORD": "your-password"
+        "FOOTPRINT_DATA_DIR": "/path/to/footprint-data",
+        "FOOTPRINT_PASSPHRASE": "your-secure-passphrase"
       }
     }
   }
 }
 ```
 
-3. **Restart Claude Desktop** - Footprint collection starts automatically
-
-## Features
-
-- 🔐 XChaCha20-Poly1305 encryption
-- 🕒 Git commit timestamps
-- 📦 Tamper-proof ZIP exports
-- 🔍 Search and retrieve footprints
-- 🤖 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
-
-### Core Tools
-
-#### capture-footprint
-
-Captures and encrypts an LLM conversation as a footprint.
-
-**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
+For Claude Code, add to `~/.claude/mcp_settings.json` with the same structure.
 
-Lists all captured footprints with pagination support.
+## MCP Tools (9 tools)
 
-**Parameters:**
+### capture-footprint
 
-- `limit` (optional) - Maximum results per page
-- `offset` (optional) - Pagination offset
+Capture and encrypt an LLM conversation. Use when: user explicitly asks to save, or high-value content (IP, legal, business, research, compliance).
 
-#### get-footprint
+| Parameter        | Required | Description                                                        |
+| ---------------- | -------- | ------------------------------------------------------------------ |
+| `conversationId` | Yes      | Unique ID, format: `{topic}-{descriptor}-{YYYY-MM-DD}`             |
+| `content`        | Yes      | Full conversation text including both human and assistant messages |
+| `tags`           | No       | Comma-separated tags                                               |
+| `llmProvider`    | No       | Provider name (default: `"unknown"`)                               |
+| `messageCount`   | No       | Number of messages (auto-calculated from content if omitted)       |
 
-Retrieves and decrypts a specific footprint by ID.
+### list-footprints
 
-**Parameters:**
+List all captured evidence with pagination.
 
-- `id` - Footprint ID
+| Parameter | Required | Description                    |
+| --------- | -------- | ------------------------------ |
+| `limit`   | No       | Results per page (default: 10) |
+| `offset`  | No       | Pagination offset              |
+| `tags`    | No       | Filter by tags                 |
 
-#### export-footprints
+### get-footprint
 
-Exports footprints to tamper-proof encrypted ZIP archive.
+Retrieve and decrypt specific evidence by ID.
 
-**Parameters:**
+| Parameter | Required | Description |
+| --------- | -------- | ----------- |
+| `id`      | Yes      | Evidence ID |
 
-- `ids` - Array of footprint IDs to export
-- `includeGitInfo` (optional) - Include git metadata
+### search-footprints
 
-### Search & Discovery
+Search conversations by query, tags, and date range. Query matches conversationId and tags (LIKE). Tags filter uses AND logic.
 
-#### search-footprints
+| Parameter  | Required | Description                    |
+| ---------- | -------- | ------------------------------ |
+| `query`    | No       | Search text                    |
+| `tags`     | No       | Array of tags (AND logic)      |
+| `dateFrom` | No       | Start date (ISO 8601)          |
+| `dateTo`   | No       | End date (ISO 8601)            |
+| `limit`    | No       | Results per page (default: 10) |
+| `offset`   | No       | Pagination offset              |
 
-Search and filter footprints by query, tags, or date range.
+### export-footprints
 
-**Parameters:**
+Export evidence to encrypted ZIP archive.
 
-- `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
+| Parameter     | Required | Description                                           |
+| ------------- | -------- | ----------------------------------------------------- |
+| `evidenceIds` | No       | Specific IDs to export (all if omitted)               |
+| `outputMode`  | No       | `"file"`, `"base64"`, or `"both"` (default: `"both"`) |
 
-#### suggest-capture
+### verify-footprint
 
-Analyze conversation content and suggest whether to capture it as a footprint.
+Verify evidence integrity using stored checksums and Git timestamps.
 
-**Parameters:**
+| Parameter | Required | Description |
+| --------- | -------- | ----------- |
+| `id`      | Yes      | Evidence ID |
 
-- `summary` - Conversation summary or key content to analyze
+Returns: `integrityVerified`, `checksumValid`, `gitTimestamp`
 
-**Returns:**
+### delete-footprints
 
-- `shouldCapture` - Whether to capture (based on keyword analysis)
-- `reason` - Human-readable explanation
-- `suggestedTags` - Recommended tags
-- `suggestedConversationId` - Recommended ID
-- `confidence` - Confidence score (0-1)
+Permanently delete evidence records. Uses two-step confirmation.
 
-### Verification
+| Parameter       | Required | Description                                          |
+| --------------- | -------- | ---------------------------------------------------- |
+| `evidenceIds`   | Yes      | Array of evidence IDs                                |
+| `confirmDelete` | No       | Set `true` to confirm (default: `false` for preview) |
 
-#### verify-footprint
+### suggest-capture
 
-Verify the integrity and authenticity of a captured footprint.
+AI-powered capture suggestion based on keyword analysis.
 
-**Parameters:**
+| Parameter | Required | Description                     |
+| --------- | -------- | ------------------------------- |
+| `content` | Yes      | Conversation content to analyze |
 
-- `id` - Footprint ID to verify
+### manage-tags
 
-**Returns:**
+Unified tag management with three actions: `stats`, `rename`, `remove`.
 
-- `verified` - Overall verification status
-- `checks` - Detailed checks (content integrity, git timestamp, encryption)
-- `legalReadiness` - Whether footprint meets legal standards
+| Parameter | Required   | Description                           |
+| --------- | ---------- | ------------------------------------- |
+| `action`  | Yes        | `"stats"` \| `"rename"` \| `"remove"` |
+| `tag`     | For remove | Tag to remove                         |
+| `oldTag`  | For rename | Current tag name                      |
+| `newTag`  | For rename | New tag name                          |
 
-### Management
+## MCP Prompts (3 prompts)
 
-#### delete-footprints
+- **`footprint-skill`** — Full agent behavior guide (decision tree, triggers, workflows, error recovery)
+- **`footprint-quick-ref`** — Condensed quick reference for tool selection and tag conventions
+- **`footprint-should-capture`** — Semantic decision framework for evaluating capture worthiness (takes `conversationSummary` argument)
 
-Delete footprint records permanently.
-
-**Parameters:**
-
-- `ids` - Array of footprint IDs to delete
-
-#### rename-tag
-
-Rename a tag across all footprints.
-
-**Parameters:**
-
-- `oldTag` - Current tag name
-- `newTag` - New tag name
-
-#### remove-tag
-
-Remove a tag from all footprints.
-
-**Parameters:**
-
-- `tag` - Tag name to remove
-
-#### get-tag-stats
-
-Get statistics about tag usage.
-
-**Returns:**
+## Architecture
 
-- Tag names and their usage counts
+```
+packages/mcp-server/
+├── src/
+│   ├── index.ts              # Main MCP server
+│   ├── prompts/              # MCP prompt handlers
+│   │   └── skill-prompt.ts
+│   ├── tools/                # MCP tool handlers (9 tools)
+│   │   ├── capture-footprint.ts
+│   │   ├── list-footprints.ts
+│   │   ├── get-footprint.ts
+│   │   ├── search-footprints.ts
+│   │   ├── export-footprints.ts
+│   │   ├── verify-footprint.ts
+│   │   ├── delete-footprints.ts
+│   │   ├── suggest-capture.ts
+│   │   └── manage-tags.ts
+│   ├── analyzers/            # Content analysis
+│   ├── cli/                  # Setup wizard
+│   ├── lib/
+│   │   ├── crypto/           # XChaCha20-Poly1305 + Argon2id
+│   │   └── storage/          # SQLite + Git timestamps
+│   └── ui/                   # Interactive dashboards
+└── tests/
+```
 
 ## Security
 
 - **Encryption**: XChaCha20-Poly1305 (256-bit)
 - **Key Derivation**: Argon2id (OWASP recommended)
 - **Storage**: Local SQLite with encrypted BLOBs
+- **No cloud, no tracking, no data collection**
+
+> **Store your password securely** — loss means permanent data loss.
 
-⚠️ **Store your password securely** - Loss means permanent data loss.
+## Development
+
+```bash
+git clone https://github.com/PCIRCLE-AI/footprint.git
+cd footprint
+pnpm install
+pnpm build
+pnpm test
+```
 
 ## Support
 
-- [Documentation](https://github.com/PCIRCLE-AI/footprint#readme)
+- [GitHub](https://github.com/PCIRCLE-AI/footprint)
 - [Issues](https://github.com/PCIRCLE-AI/footprint/issues)
-- [License](https://github.com/PCIRCLE-AI/footprint/blob/main/LICENSE)
+- [npm](https://www.npmjs.com/package/@pcircle/footprint)
+- [Website](https://footprint.memesh.ai)
+
+## License
+
+MIT License — see [LICENSE](./LICENSE) for details.

package/SKILL.md

@@ -2,7 +2,7 @@
 
 > MCP server for capturing and encrypting AI conversations as verifiable records with Git timestamps.
 
-**Package:** `@pcircle/footprint` (v1.2.1)  
+**Package:** `@pcircle/footprint` (v1.1.1)  
 **Protocol:** Model Context Protocol (MCP)  
 **License:** MIT
 
@@ -26,7 +26,7 @@ Should I capture this conversation?
 │   ├─ Basic troubleshooting
 │   └─ Draft/brainstorming sessions (unless finalized)
 └─ Uncertain content → ASK user
-    └─ "Would you like me to save this conversation as a footprint?"
+    └─ "Would you like me to save this conversation as evidence?"
 ```
 
 ## Specific Trigger Patterns
@@ -53,7 +53,7 @@ Should I capture this conversation?
 ## Available Tools
 
 ### 1. `capture-footprint`
-Save a conversation as encrypted footprint.
+Save a conversation as encrypted evidence.
 
 **Input Parameters:**
 ```json
@@ -68,22 +68,22 @@ Save a conversation as encrypted footprint.
 
 **Expected Output (text):**
 ```
-✅ Footprint captured successfully
-- Footprint ID: `550e8400-e29b-41d4-a716-446655440000`
+✅ Evidence captured successfully
+- Evidence ID: `550e8400-e29b-41d4-a716-446655440000`
 - Conversation ID: `api-auth-decision-2026-01-28`
 - Messages: 15 
 - Tags: api,oauth,security,decision,approved
 - Git hash: `a1b2c3d4e5f6789...`
 - Created: 2026-01-28T14:30:45Z
 
-Keep this Footprint ID safe for future reference.
+Keep this Evidence ID safe for future reference.
 ```
 
 **Expected Output (structuredContent):**
 ```json
 {
-  "type": "footprint_created",
-  "footprintId": "550e8400-e29b-41d4-a716-446655440000",
+  "type": "evidence_created",
+  "evidenceId": "550e8400-e29b-41d4-a716-446655440000",
   "conversationId": "api-auth-decision-2026-01-28", 
   "messageCount": 15,
   "tags": ["api", "oauth", "security", "decision", "approved"],
@@ -94,7 +94,7 @@ Keep this Footprint ID safe for future reference.
 ```
 
 ### 2. `list-footprints`
-List all captured footprints (metadata only).
+List all captured evidence (metadata only).
 
 **Input Parameters:**
 ```json
@@ -106,7 +106,7 @@ List all captured footprints (metadata only).
 
 **Expected Output (text):**
 ```
-📋 Footprint Archive (10 most recent)
+📋 Evidence Archive (10 most recent)
 1. api-auth-decision-2026-01-28 | 15 msgs | api,oauth,security
 2. patent-algorithm-2026-01-27 | 32 msgs | ip,patent,algorithm  
 3. contract-review-2026-01-26 | 8 msgs | legal,contract
@@ -116,9 +116,9 @@ List all captured footprints (metadata only).
 **Expected Output (structuredContent):**
 ```json
 {
-  "type": "footprint_list",
+  "type": "evidence_list",
   "total": 25,
-  "footprints": [
+  "evidences": [
     {
       "id": "550e8400-e29b-41d4-a716-446655440000",
       "conversationId": "api-auth-decision-2026-01-28",
@@ -131,7 +131,7 @@ List all captured footprints (metadata only).
 ```
 
 ### 3. `get-footprint`
-Retrieve and decrypt a specific footprint.
+Retrieve and decrypt specific evidence.
 
 **Input Parameters:**
 ```json
@@ -142,7 +142,7 @@ Retrieve and decrypt a specific footprint.
 
 **Expected Output (text):**
 ```
-📄 Footprint Retrieved
+📄 Evidence Retrieved
 - ID: 550e8400-e29b-41d4-a716-446655440000
 - Created: 2026-01-28T14:30:45Z
 - Provider: Claude Sonnet 4.5
@@ -154,7 +154,7 @@ Assistant: I recommend using PKCE flow...
 ```
 
 ### 4. `search-footprints`
-Find footprints by content or tags.
+Find evidence by content or tags.
 
 **Input Parameters:**
 ```json
@@ -166,7 +166,7 @@ Find footprints by content or tags.
 ```
 
 ### 5. `export-footprints`
-Export footprints as encrypted archive.
+Export evidence as encrypted archive.
 
 **Input Parameters:**
 ```json
@@ -179,8 +179,8 @@ Export footprints as encrypted archive.
 **Expected Output (structuredContent):**
 ```json
 {
-  "type": "footprint_export",
-  "filename": "footprint-550e8400-export.zip",
+  "type": "evidence_export",
+  "filename": "evidence-550e8400-export.zip",
   "base64Data": "UEsDBBQAAAAIAL...",
   "size": 2048,
   "checksum": "sha256:a1b2c3d4..."
@@ -188,7 +188,7 @@ Export footprints as encrypted archive.
 ```
 
 ### 6. `verify-footprint`
-Verify footprint integrity (checksum + Git timestamp).
+Verify evidence integrity (checksum + Git timestamp).
 
 **Input Parameters:**
 ```json
@@ -199,7 +199,7 @@ Verify footprint integrity (checksum + Git timestamp).
 
 **Expected Output (text):**
 ```
-🔐 Footprint Verification Report
+🔐 Evidence Verification Report
 - ID: 550e8400-e29b-41d4-a716-446655440000
 - Content Hash: ✅ Valid (SHA-256 matches)
 - Git Timestamp: ✅ Verified (2026-01-28T14:30:45Z)
@@ -252,29 +252,29 @@ Verify footprint integrity (checksum + Git timestamp).
 
 ### When to Use Each Tool
 - **capture-footprint**: Primary tool for saving conversations
-- **list-footprints**: Browse/overview existing footprints
-- **search-footprints**: Find specific content across footprints
-- **get-footprint**: Retrieve full content of a specific footprint
+- **list-footprints**: Browse/overview existing evidence
+- **search-footprints**: Find specific content across evidence
+- **get-footprint**: Retrieve full content of specific evidence
 - **export-footprints**: Legal/audit export needs
-- **verify-footprint**: Verify footprint integrity and checksums
+- **verify-footprint**: Verify evidence integrity and checksums
 
 ## Token-Efficient Agent Responses
 
-**After capturing a footprint (keep it brief):**
+**After capturing evidence (keep it brief):**
 ```
-✅ Footprint saved as `{conversationId}`
+✅ Evidence saved as `{conversationId}` 
 ID: `{first-8-chars-of-id}`...
 Tags: {tags}
 ```
 
 **When suggesting capture:**
 ```
-💡 This looks like valuable content (contains {trigger}). Save it as a footprint?
+💡 This looks like valuable evidence (contains {trigger}). Save it?
 ```
 
 **When declining to capture:**
 ```
-ℹ️ Skipping footprint capture (casual conversation)
+ℹ️ Skipping evidence capture (casual conversation)
 ```
 
 **For retrieval:**
@@ -287,11 +287,11 @@ Tags: {tags}
 
 | Error | Likely Cause | Recovery Action |
 |-------|--------------|-----------------|
-| "Password required" | FOOTPRINT_PASSWORD not set | 1. Check env config<br>2. Restart MCP server<br>3. Verify password in env |
-| "Footprint 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 footprint |
-| "Decryption failed" | Password changed/wrong | 1. Verify current password matches<br>2. Check if footprint pre-dates password change<br>3. Try with backup password if available |
-| "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 footprint directory<br>2. Set git user.name/user.email<br>3. Make initial commit |
+| "Password required" | FOOTPRINT_PASSPHRASE not set | 1. Check env config<br>2. Restart MCP server<br>3. Verify passphrase 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 FOOTPRINT_DATA_DIR 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 |
 
 **Agent Recovery Protocol:**
@@ -311,7 +311,7 @@ Agent:
 1. ✅ Capture immediately (explicit request)
 2. Use conversationId: "api-design-discussion-2026-01-28"
 3. Tags: "api,design,architecture"
-4. Report success with Footprint ID
+4. Report success with Evidence ID
 ```
 
 ### 2. High-Value Content Detection  
@@ -320,42 +320,42 @@ User: "We've decided to patent this algorithm approach."
 
 Agent:
 1. 🔍 Detect trigger: "patent" + "decided"
-2. 💡 Suggest: "This looks like valuable content (contains patent decision). Save it as a footprint?"
+2. 💡 Suggest: "This looks like valuable evidence (contains patent decision). Save it?"
 3. ✅ If user agrees, capture with tags: "patent,algorithm,decision,ip"
 ```
 
-### 3. Footprint Retrieval
+### 3. Evidence Retrieval
 ```
 User: "Find the conversation about OAuth implementation"
 
 Agent:
-1. 🔍 Search: list-footprints or search-footprints with "OAuth"
+1. 🔍 Search: list-footprints or search-evidence with "OAuth"
 2. 📄 Present matches with conversationId and brief summary
 3. 🎯 If user selects one, get-footprint to show full content
 ```
 
 ### 4. Legal Export
 ```
-User: "Export the patent footprints for filing"
+User: "Export the patent evidence for filing"
 
-Agent:
-1. 🔍 Help identify relevant footprints (search by "patent" tag)
-2. 📦 Export each footprint as encrypted ZIP
+Agent: 
+1. 🔍 Help identify relevant evidence (search by "patent" tag)
+2. 📦 Export each evidence as encrypted ZIP
 3. ✅ Provide files with verification instructions
 4. 📋 Remind about Git hash verification for legal proof
 ```
 
 ## Security & Verification
 
-- **Password**: Set via `FOOTPRINT_PASSWORD` env var (never ask user in chat)
+- **Password**: Set via `FOOTPRINT_PASSPHRASE` 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
-- **Footprint Chain**: Each capture creates immutable Git commit
+- **Evidence Chain**: Each capture creates immutable Git commit
 - **Storage**: Local SQLite with encrypted BLOBs (no cloud, no tracking)
 
 **For legal proceedings:**
-1. Export footprint with `export-footprints` 
+1. Export evidence with `export-evidence` 
 2. Verify Git hash against repository
 3. Check SHA-256 checksum matches
 4. Git log shows creation timestamp
@@ -389,8 +389,8 @@ npx @pcircle/footprint
       "command": "npx",
       "args": ["@pcircle/footprint"],
       "env": {
-        "FOOTPRINT_DB_PATH": "/path/to/footprints.db",
-        "FOOTPRINT_PASSWORD": "your-secure-password-here"
+        "FOOTPRINT_DATA_DIR": "/path/to/data",
+        "FOOTPRINT_PASSPHRASE": "your-secure-password-here"
       }
     }
   }
@@ -398,15 +398,15 @@ npx @pcircle/footprint
 ```
 
 **Environment Variables:**
-- `FOOTPRINT_PASSWORD` (required): Encryption passphrase
-- `FOOTPRINT_DB_PATH` (optional): Path to SQLite database (default: `./footprints.db` in current directory)
+- `FOOTPRINT_PASSPHRASE` (required): Encryption passphrase
+- `FOOTPRINT_DATA_DIR` (optional): Directory for data storage (default: `~/.footprint`)
 
 ## Performance Notes
 
 - **Capture time**: ~1-3 seconds per conversation
 - **Database size**: ~1KB per message on average
-- **Git overhead**: ~100 bytes per footprint commit
-- **Search speed**: Sub-second for <1000 footprint records
+- **Git overhead**: ~100 bytes per evidence commit
+- **Search speed**: Sub-second for <1000 evidence records
 - **Export time**: ~5-15 seconds depending on content size
 
 Large conversations (>100 messages) may take longer to encrypt and commit.

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

@@ -1 +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"}
+{"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;AAsMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAwB9D"}