@pcircle/footprint 1.2.2 → 1.5.0

package/dist/src/prompts/skill-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/skill-prompt.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiDzE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyF5D"}

package/dist/src/prompts/skill-prompt.js

@@ -0,0 +1,125 @@
+import { fileURLToPath } from "url";
+import * as path from "path";
+import * as fs from "fs";
+import * as z from "zod";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Resolve SKILL.md from the package root.
+ * Handles both dev (src/prompts/) and built (dist/prompts/) paths.
+ */
+function findSkillMd() {
+    const candidates = [
+        path.resolve(__dirname, "../../SKILL.md"), // from dist/prompts/ or src/prompts/
+        path.resolve(__dirname, "../../../SKILL.md"), // fallback
+    ];
+    for (const p of candidates) {
+        if (fs.existsSync(p))
+            return fs.readFileSync(p, "utf-8");
+    }
+    throw new Error("SKILL.md not found");
+}
+const QUICK_REFERENCE = `# Footprint Quick Reference
+
+## Decision Tree
+Should I capture this conversation?
+\u251C\u2500 User explicitly asked \u2192 YES (capture immediately)
+\u251C\u2500 High-value content (IP/Legal/Business/Research/Compliance) \u2192 SUGGEST to user
+\u251C\u2500 Casual chat/small talk \u2192 NO
+\u2514\u2500 Uncertain \u2192 ASK user
+
+## Tool Selection
+- Save conversation \u2192 capture-footprint
+- Browse/overview \u2192 list-footprints
+- Full content retrieval \u2192 get-footprint
+- Find by query/tags/dates \u2192 search-footprints
+- Legal/audit export \u2192 export-footprints
+- Verify integrity \u2192 verify-footprint
+- Tag management \u2192 manage-tags (stats/rename/remove)
+- Keyword pre-filter \u2192 suggest-capture
+- Semantic assessment \u2192 Use footprint-should-capture prompt
+
+## Tag Conventions
+Format: 3-6 tags, comma-separated
+Types: decision, milestone, research, review, approval
+Domains: api, ui, database, security, legal, business
+Status: draft, finalized, approved, rejected
+
+## conversationId Format
+{topic-type}-{descriptive-name}-{YYYY-MM-DD}`;
+/**
+ * Register all Footprint MCP prompts on the server.
+ */
+export function registerSkillPrompts(server) {
+    const skillContent = findSkillMd();
+    // Full SKILL.md content
+    server.registerPrompt("footprint-skill", {
+        description: "Complete Footprint agent skill guide — decision tree, tool reference, best practices, error recovery, and workflow examples",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: skillContent },
+            },
+        ],
+    }));
+    // Condensed quick reference
+    server.registerPrompt("footprint-quick-ref", {
+        description: "Condensed quick reference for Footprint — decision tree, tool selection, tag conventions",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: QUICK_REFERENCE },
+            },
+        ],
+    }));
+    // Semantic capture decision framework
+    server.registerPrompt("footprint-should-capture", {
+        description: "Semantic decision framework for whether to capture a conversation as evidence. Provides structured criteria for the AI to assess, unlike suggest-capture which uses keyword matching.",
+        argsSchema: {
+            conversationSummary: z
+                .string()
+                .min(1, "Conversation summary cannot be empty")
+                .max(10000, "Conversation summary too long (max 10000 characters)")
+                .describe("Brief summary of the conversation content to evaluate"),
+        },
+    }, async ({ conversationSummary }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Evaluate whether this conversation should be captured as evidence using Footprint.
+
+## Conversation Summary
+${conversationSummary}
+
+## Decision Criteria
+Rate each category 0-3 (0=none, 1=low, 2=medium, 3=high):
+
+1. **Intellectual Property Value**: Does it contain inventions, algorithms, novel approaches, patents, trade secrets?
+2. **Legal Significance**: Does it involve contracts, agreements, licenses, legal obligations, regulatory requirements?
+3. **Business Decision Impact**: Does it record decisions, approvals, milestones, deliverables, strategic direction?
+4. **Research Value**: Does it contain hypotheses, findings, experimental results, data analysis, methodology?
+5. **Compliance/Audit Need**: Does it need to be documented for audit trails, regulatory compliance, evidence preservation?
+
+## Decision Rules
+- Any category >= 2 \u2192 RECOMMEND CAPTURE
+- Multiple categories >= 1 \u2192 RECOMMEND CAPTURE
+- All categories = 0 \u2192 DO NOT CAPTURE
+- Uncertain \u2192 ASK USER
+
+## Response Format
+Respond with:
+- **Capture**: yes/no/ask
+- **Confidence**: 0.0-1.0
+- **Primary Reason**: One sentence
+- **Suggested Tags**: comma-separated
+- **Suggested conversationId**: {topic}-{descriptor}-{YYYY-MM-DD} format`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=skill-prompt.js.map

package/dist/src/prompts/skill-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.js","sourceRoot":"","sources":["../../../src/prompts/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,qCAAqC;QAChF,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,WAAW;KAC1D,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;6CA2BqB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,YAAY,GAAG,WAAW,EAAE,CAAC;IAEnC,wBAAwB;IACxB,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,WAAW,EACT,6HAA6H;KAChI,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE;aACvD;SACF;KACF,CAAC,CACH,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,WAAW,EACT,0FAA0F;KAC7F,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,EAAE;aAC1D;SACF;KACF,CAAC,CACH,CAAC;IAEF,sCAAsC;IACtC,MAAM,CAAC,cAAc,CACnB,0BAA0B,EAC1B;QACE,WAAW,EACT,uLAAuL;QACzL,UAAU,EAAE;YACV,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;iBAC9C,GAAG,CAAC,KAAK,EAAE,sDAAsD,CAAC;iBAClE,QAAQ,CAAC,uDAAuD,CAAC;SACrE;KACF,EACD,KAAK,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;EAGhB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;yEAuBoD;iBAC9D;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/src/tools/capture-footprint.d.ts

@@ -4,9 +4,9 @@ import type { CaptureEvidenceParams } from "../types.js";
 export declare const captureFootprintSchema: {
     inputSchema: {
         conversationId: z.ZodString;
-        llmProvider: z.ZodString;
+        llmProvider: z.ZodDefault<z.ZodString>;
         content: z.ZodString;
-        messageCount: z.ZodNumber;
+        messageCount: z.ZodOptional<z.ZodNumber>;
         tags: z.ZodOptional<z.ZodString>;
     };
     outputSchema: {

package/dist/src/tools/capture-footprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/capture-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAkBlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;;;;;IAmFzC"}
+{"version":3,"file":"capture-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/capture-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAyClC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAIpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;;;;;IAyHzC"}

package/dist/src/tools/capture-footprint.js

@@ -6,15 +6,28 @@ import { encrypt } from "../lib/crypto/index.js";
 import { getCurrentCommit, } from "../lib/storage/index.js";
 export const captureFootprintSchema = {
     inputSchema: {
-        conversationId: z.string().describe("Conversation ID"),
+        conversationId: z
+            .string()
+            .max(500, "Conversation ID too long (max 500 chars)")
+            .describe("Unique conversation identifier. Recommended format: {topic}-{descriptor}-{YYYY-MM-DD} (e.g., api-auth-decision-2026-01-28)"),
         llmProvider: z
             .string()
-            .describe("LLM provider name (e.g., Claude Sonnet 4.5)"),
+            .default("unknown")
+            .describe("LLM provider name (e.g., Claude Sonnet 4.5). Defaults to 'unknown' if not specified."),
         content: z
             .string()
-            .describe("Conversation content (messages, prompts, responses)"),
-        messageCount: z.number().int().positive().describe("Number of messages"),
-        tags: z.string().optional().describe("Optional tags (comma-separated)"),
+            .max(10 * 1024 * 1024, "Content exceeds 10MB limit")
+            .describe("Full conversation text including both human and assistant messages. Include complete message history for accurate evidence preservation."),
+        messageCount: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Number of messages in the conversation. If omitted, auto-calculated by counting conversation turn markers (Human:/Assistant:/User:/AI:/System:)."),
+        tags: z
+            .string()
+            .optional()
+            .describe("Comma-separated tags for categorization (e.g., 'ip,patent,decision'). Use 3-6 tags. Common types: decision, milestone, research, legal, compliance."),
     },
     outputSchema: {
         id: z.string(),
@@ -25,7 +38,7 @@ export const captureFootprintSchema = {
 };
 export const captureFootprintMetadata = {
     title: "Capture Footprint",
-    description: "Capture and encrypt LLM conversation as footprint",
+    description: "Capture and encrypt an LLM conversation as a tamper-evident footprint. Use when: user explicitly asks to save, or high-value content detected (IP, legal, business, research, compliance). Creates encrypted record with SHA-256 hash and Git timestamp anchor.",
 };
 export function createCaptureFootprintHandler(db, getDerivedKey) {
     return wrapToolHandler("capture-footprint", "Check content is not empty, messageCount is positive, and tags format is valid.", async (params) => {
@@ -33,7 +46,14 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         if (!params.content || params.content.trim().length === 0) {
             throw new Error("Content cannot be empty");
         }
-        if (params.messageCount <= 0) {
+        const MAX_CONTENT_LENGTH = 10 * 1024 * 1024; // 10MB
+        if (params.content.length > MAX_CONTENT_LENGTH) {
+            throw new Error(`Content too large (${(params.content.length / (1024 * 1024)).toFixed(1)}MB). Maximum 10MB allowed.`);
+        }
+        if (params.conversationId.length > 500) {
+            throw new Error("Conversation ID too long (max 500 chars)");
+        }
+        if (params.messageCount !== undefined && params.messageCount <= 0) {
             throw new Error("Message count must be positive");
         }
         // eslint-disable-next-line no-control-regex
@@ -42,6 +62,8 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         }
         // Validate and sanitize tags if provided
         if (params.tags) {
+            const MAX_TAG_LENGTH = 100;
+            const MAX_TAGS_COUNT = 20;
             const tags = params.tags
                 .split(",")
                 .map((t) => t.trim())
@@ -49,14 +71,33 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
             if (tags.length === 0) {
                 throw new Error("All provided tags are empty or whitespace");
             }
+            if (tags.length > MAX_TAGS_COUNT) {
+                throw new Error(`Too many tags (${tags.length}). Maximum ${MAX_TAGS_COUNT} tags allowed.`);
+            }
             for (const tag of tags) {
+                if (tag.length > MAX_TAG_LENGTH) {
+                    throw new Error(`Tag too long (${tag.length} chars). Maximum ${MAX_TAG_LENGTH} characters per tag.`);
+                }
                 // eslint-disable-next-line no-control-regex
                 if (/[\x00\n\r,]/.test(tag)) {
                     throw new Error(`Invalid tag format: "${tag}". Tags cannot contain null bytes, newlines, or commas.`);
                 }
             }
-            params.tags = tags.join(",");
+            // Use sanitized tags without mutating original params
+            params = { ...params, tags: tags.join(",") };
+        }
+        // Auto-calculate messageCount if not provided
+        let messageCount = params.messageCount;
+        if (!messageCount) {
+            const turnPattern = /^(Human|Assistant|User|System|AI):/im;
+            const lines = params.content.split("\n");
+            messageCount = lines.filter((line) => turnPattern.test(line.trim())).length;
+            if (messageCount === 0)
+                messageCount = 1; // Default to 1 if no turns detected
         }
+        // Apply runtime defaults for parameters with Zod schema defaults
+        // (Zod defaults only apply through MCP SDK transport layer)
+        const llmProvider = params.llmProvider || "unknown";
         // Encrypt and capture
         const key = await getDerivedKey();
         const encrypted = await encrypt(params.content, key);
@@ -69,20 +110,20 @@ export function createCaptureFootprintHandler(db, getDerivedKey) {
         const id = db.create({
             timestamp,
             conversationId: params.conversationId,
-            llmProvider: params.llmProvider,
+            llmProvider,
             encryptedContent: encrypted.ciphertext,
             nonce: encrypted.nonce,
             contentHash,
-            messageCount: params.messageCount,
+            messageCount,
             gitCommitHash: gitInfo?.commitHash || null,
             gitTimestamp: gitInfo?.timestamp || null,
             tags: params.tags || null,
         });
-        return formatSuccessResponse("Footprint captured successfully", {
+        return formatSuccessResponse("Evidence captured successfully", {
             ID: id,
             Timestamp: timestamp,
             "Git Commit": gitInfo?.commitHash || "N/A",
-            "Message Count": params.messageCount,
+            "Message Count": messageCount,
         }, {
             id,
             timestamp,

package/dist/src/tools/capture-footprint.js.map

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

package/dist/src/tools/delete-footprints.d.ts

@@ -2,10 +2,17 @@ import * as z from "zod";
 import type { EvidenceDatabase } from "../lib/storage/index.js";
 export declare const deleteFootprintsSchema: {
     inputSchema: {
-        ids: z.ZodArray<z.ZodString, "many">;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        confirmDelete: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     };
     outputSchema: {
         deletedCount: z.ZodNumber;
+        previewed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            conversationId: z.ZodString;
+            timestamp: z.ZodString;
+        }, z.core.$strip>>>;
+        notFoundIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         success: z.ZodBoolean;
     };
 };
@@ -14,9 +21,19 @@ export declare const deleteFootprintsMetadata: {
     description: string;
 };
 export declare function createDeleteFootprintsHandler(db: EvidenceDatabase): (params: {
-    ids: string[];
+    evidenceIds: string[];
+    confirmDelete?: boolean;
 }) => Promise<import("../lib/tool-response.js").ToolResponse<{
     deletedCount: number;
+    previewed: {
+        id: string;
+        conversationId: string | null;
+        timestamp: string;
+    }[];
+    success: boolean;
+}> | import("../lib/tool-response.js").ToolResponse<{
+    deletedCount: number;
+    notFoundIds: string[];
     success: boolean;
 }>>;
 //# sourceMappingURL=delete-footprints.d.ts.map

package/dist/src/tools/delete-footprints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;CAWlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAGpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;SAIxC,MAAM,EAAE;;;;IAejC"}
+{"version":3,"file":"delete-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CA+BlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;CAIpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;iBAIhC,MAAM,EAAE;oBAAkB,OAAO;;;;;;;;;;;;;IA2DlE"}

package/dist/src/tools/delete-footprints.js

@@ -3,31 +3,79 @@ import { wrapToolHandler } from "../lib/tool-wrapper.js";
 import { createToolResponse } from "../lib/tool-response.js";
 export const deleteFootprintsSchema = {
     inputSchema: {
-        ids: z
+        evidenceIds: z
             .array(z.string())
             .min(1)
-            .describe("Array of footprint IDs to delete"),
+            .max(100, "Maximum 100 IDs per delete operation")
+            .describe("Array of footprint IDs to delete. Always verify IDs first with search-footprints or list-footprints."),
+        confirmDelete: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Set to true to confirm deletion. Without this, returns a preview of records to be deleted without actually deleting them. Two-step pattern: first call without confirmDelete to preview, then call with confirmDelete: true to execute."),
     },
     outputSchema: {
         deletedCount: z.number(),
+        previewed: z
+            .array(z.object({
+            id: z.string(),
+            conversationId: z.string(),
+            timestamp: z.string(),
+        }))
+            .optional(),
+        notFoundIds: z.array(z.string()).optional(),
         success: z.boolean(),
     },
 };
 export const deleteFootprintsMetadata = {
     title: "Delete Footprints",
-    description: "Permanently delete one or more footprint records",
+    description: "Permanently delete one or more footprint records. WARNING: Irreversible operation. Uses two-step confirmation: first call previews records, second call with confirmDelete: true performs deletion.",
 };
 export function createDeleteFootprintsHandler(db) {
     return wrapToolHandler("delete-footprints", "Verify the footprint IDs exist.", async (params) => {
-        if (!params.ids || params.ids.length === 0) {
-            throw new Error("At least one footprint ID is required");
+        if (!params.evidenceIds || params.evidenceIds.length === 0) {
+            throw new Error("At least one evidence ID is required");
         }
-        const deletedCount = db.deleteMany(params.ids);
+        if (params.evidenceIds.length > 100) {
+            throw new Error(`Too many IDs (${params.evidenceIds.length}). Maximum 100 per delete operation.`);
+        }
+        // Preview mode: show what would be deleted without actually deleting
+        if (!params.confirmDelete) {
+            const previewed = params.evidenceIds
+                .map((id) => db.findById(id))
+                .filter((e) => e !== null)
+                .map((e) => ({
+                id: e.id,
+                conversationId: e.conversationId,
+                timestamp: e.timestamp,
+            }));
+            const resultText = previewed.length > 0
+                ? `⚠️ Preview: ${previewed.length} record(s) would be deleted:\n${previewed.map((p) => `  - ${p.id} (${p.conversationId})`).join("\n")}\n\nTo confirm, call again with confirmDelete: true`
+                : `⚠️ No records found with the provided IDs`;
+            return createToolResponse(resultText, {
+                deletedCount: 0,
+                previewed,
+                success: false,
+            });
+        }
+        // Check which IDs exist before deletion (Set for O(1) lookup)
+        const existingIds = params.evidenceIds.filter((id) => db.findById(id));
+        const existingSet = new Set(existingIds);
+        const notFoundIds = params.evidenceIds.filter((id) => !existingSet.has(id));
+        // Actual deletion
+        const deletedCount = db.deleteMany(existingIds);
         const success = deletedCount > 0;
-        const resultText = success
+        let resultText = success
             ? `🗑️ Successfully deleted ${deletedCount} footprint record${deletedCount > 1 ? "s" : ""}`
             : `⚠️ No footprint records found with the provided IDs`;
-        return createToolResponse(resultText, { deletedCount, success });
+        if (notFoundIds.length > 0) {
+            resultText += `\n⚠️ IDs not found: ${notFoundIds.join(", ")}`;
+        }
+        return createToolResponse(resultText, {
+            deletedCount,
+            notFoundIds,
+            success,
+        });
     });
 }
 //# sourceMappingURL=delete-footprints.js.map

package/dist/src/tools/delete-footprints.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-footprints.js","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE;QACX,GAAG,EAAE,CAAC;aACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,kCAAkC,CAAC;KAChD;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,kDAAkD;CAChE,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAAC,EAAoB;IAChE,OAAO,eAAe,CACpB,mBAAmB,EACnB,iCAAiC,EACjC,KAAK,EAAE,MAAyB,EAAE,EAAE;QAClC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,CAAC;QAEjC,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,4BAA4B,YAAY,oBAAoB,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3F,CAAC,CAAC,qDAAqD,CAAC;QAE1D,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"delete-footprints.js","sourceRoot":"","sources":["../../../src/tools/delete-footprints.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/export-footprints.d.ts

@@ -2,13 +2,19 @@ import * as z from "zod";
 import type { EvidenceDatabase } from "../lib/storage/index.js";
 export declare const exportFootprintsSchema: {
     inputSchema: {
-        ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        evidenceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         includeGitInfo: z.ZodOptional<z.ZodBoolean>;
+        outputMode: z.ZodDefault<z.ZodEnum<{
+            base64: "base64";
+            file: "file";
+            both: "both";
+        }>>;
     };
     outputSchema: {
-        filename: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        base64Data: z.ZodOptional<z.ZodString>;
         checksum: z.ZodString;
-        footprintCount: z.ZodNumber;
+        evidenceCount: z.ZodNumber;
         success: z.ZodBoolean;
     };
 };
@@ -22,12 +28,14 @@ export declare const exportFootprintsMetadata: {
     };
 };
 export declare function createExportFootprintsHandler(db: EvidenceDatabase): (params: {
-    ids?: string[];
+    evidenceIds?: string[];
     includeGitInfo?: boolean;
+    outputMode?: "file" | "base64" | "both";
 }) => Promise<import("../lib/tool-response.js").ToolResponse<{
-    filename: string;
     checksum: string;
-    footprintCount: number;
+    evidenceCount: number;
     success: boolean;
+    base64Data?: string | undefined;
+    filename?: string | undefined;
 }>>;
 //# sourceMappingURL=export-footprints.d.ts.map

package/dist/src/tools/export-footprints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAclC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CAQpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;UAIvC,MAAM,EAAE;qBAAmB,OAAO;;;;;;IA4B5D"}
+{"version":3,"file":"export-footprints.d.ts","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CA0BlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CASpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;kBAK9C,MAAM,EAAE;qBACL,OAAO;iBACX,MAAM,GAAG,QAAQ,GAAG,MAAM;;;;;;;IAmE5C"}

package/dist/src/tools/export-footprints.js

@@ -1,24 +1,33 @@
+/* global Buffer, process */
 import * as z from "zod";
 import { wrapToolHandler } from "../lib/tool-wrapper.js";
 import { formatSuccessResponse } from "../lib/tool-response.js";
 export const exportFootprintsSchema = {
     inputSchema: {
-        ids: z
+        evidenceIds: z
             .array(z.string())
             .optional()
-            .describe("Specific IDs (empty = all)"),
-        includeGitInfo: z.boolean().optional().describe("Include Git timestamps"),
+            .describe("Specific evidence IDs to export. If omitted, exports all evidence."),
+        includeGitInfo: z
+            .boolean()
+            .optional()
+            .describe("Include Git commit hash and timestamp in export metadata"),
+        outputMode: z
+            .enum(["file", "base64", "both"])
+            .default("both")
+            .describe("Output mode: 'file' writes ZIP to disk, 'base64' returns ZIP as base64 string (for Claude Desktop/MCP clients), 'both' does both (default, backward compatible)."),
     },
     outputSchema: {
-        filename: z.string(),
+        filename: z.string().optional(),
+        base64Data: z.string().optional(),
         checksum: z.string(),
-        footprintCount: z.number(),
+        evidenceCount: z.number(),
         success: z.boolean(),
     },
 };
 export const exportFootprintsMetadata = {
     title: "Export Footprints",
-    description: "Export footprints to encrypted ZIP archive",
+    description: "Export footprints to encrypted ZIP archive. Supports file output (write to disk), base64 output (for MCP clients like Claude Desktop), or both. Default is 'both' for backward compatibility.",
     _meta: {
         ui: {
             resourceUri: "ui://footprint/export.html",
@@ -26,23 +35,53 @@ export const exportFootprintsMetadata = {
     },
 };
 export function createExportFootprintsHandler(db) {
-    return wrapToolHandler("export-footprints", "Check ids exist and filesystem has write permissions.", async (params) => {
+    return wrapToolHandler("export-footprints", "Check evidenceIds exist and filesystem has write permissions.", async (params) => {
         const { exportEvidences } = await import("../lib/storage/index.js");
         const fs = await import("fs");
+        const outputMode = params.outputMode || "both";
         const result = await exportEvidences(db, {
-            ids: params.ids,
+            evidenceIds: params.evidenceIds,
             includeGitInfo: params.includeGitInfo ?? false,
         });
-        fs.writeFileSync(result.filename, result.zipData);
-        return formatSuccessResponse("Export completed successfully", {
-            "Footprint Count": result.footprintCount,
-            Filename: result.filename,
+        // Enforce size limit for base64 mode (base64 adds ~33% overhead)
+        const MAX_BASE64_SIZE = 75 * 1024 * 1024; // 75MB
+        if ((outputMode === "base64" || outputMode === "both") &&
+            result.zipData.length > MAX_BASE64_SIZE) {
+            throw new Error(`Export too large for base64 mode (${(result.zipData.length / (1024 * 1024)).toFixed(1)}MB). ` +
+                `Use outputMode="file" or export fewer records.`);
+        }
+        let filename;
+        let base64Data;
+        // Write to disk if file or both mode
+        if (outputMode === "file" || outputMode === "both") {
+            const os = await import("os");
+            const path = await import("path");
+            const outputDir = process.env.FOOTPRINT_DATA_DIR ||
+                process.env.FOOTPRINT_EXPORT_DIR ||
+                os.tmpdir();
+            const outputPath = path.join(outputDir, result.filename);
+            fs.writeFileSync(outputPath, result.zipData);
+            filename = outputPath;
+        }
+        // Generate base64 if base64 or both mode
+        if (outputMode === "base64" || outputMode === "both") {
+            base64Data = Buffer.from(result.zipData).toString("base64");
+        }
+        const details = {
+            "Footprint Count": result.evidenceCount,
             Checksum: result.checksum,
             "Git Info": params.includeGitInfo ? "Included" : "Excluded",
-        }, {
-            filename: result.filename,
+            "Output Mode": outputMode,
+        };
+        if (filename)
+            details.Filename = filename;
+        if (base64Data)
+            details["Base64 Size"] = `${Math.round(base64Data.length / 1024)}KB`;
+        return formatSuccessResponse("Export completed successfully", details, {
+            ...(filename && { filename }),
+            ...(base64Data && { base64Data }),
             checksum: result.checksum,
-            footprintCount: result.footprintCount,
+            evidenceCount: result.evidenceCount,
             success: true,
         });
     });

package/dist/src/tools/export-footprints.js.map

@@ -1 +1 @@
-{"version":3,"file":"export-footprints.js","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE;QACX,GAAG,EAAE,CAAC;aACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;QACzC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KAC1E;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,4CAA4C;IACzD,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,4BAA4B;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAAC,EAAoB;IAChE,OAAO,eAAe,CACpB,mBAAmB,EACnB,uDAAuD,EACvD,KAAK,EAAE,MAAoD,EAAE,EAAE;QAC7D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACpE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE;YACvC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;SAC/C,CAAC,CAAC;QAEH,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAElD,OAAO,qBAAqB,CAC1B,+BAA+B,EAC/B;YACE,iBAAiB,EAAE,MAAM,CAAC,cAAc;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;SAC5D,EACD;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,IAAI;SACd,CACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"export-footprints.js","sourceRoot":"","sources":["../../../src/tools/export-footprints.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/get-footprint.d.ts

@@ -14,13 +14,7 @@ export declare const getFootprintSchema: {
         gitInfo: z.ZodNullable<z.ZodObject<{
             commitHash: z.ZodString;
             timestamp: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            timestamp: string;
-            commitHash: string;
-        }, {
-            timestamp: string;
-            commitHash: string;
-        }>>;
+        }, z.core.$strip>>;
         tags: z.ZodNullable<z.ZodString>;
     };
 };

package/dist/src/tools/get-footprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAmB9B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAQhC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;QAKjB,MAAM;;;;;;;;;;;;;IAuC9B"}
+{"version":3,"file":"get-footprint.d.ts","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAShC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,gBAAgB,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC;QAKjB,MAAM;;;;;;;;;;;;;IA0C9B"}