@pcircle/footprint 1.3.0 → 1.6.0

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

@@ -0,0 +1,136 @@
+import { Buffer } from "node:buffer";
+import * as z from "zod";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
+const outputModeEnum = z.enum(["file", "base64", "both"]);
+const sessionHostEnum = z.enum(["claude", "gemini", "codex"]);
+const sessionStatusEnum = z.enum([
+    "running",
+    "completed",
+    "failed",
+    "interrupted",
+]);
+const trendGroupByEnum = z.enum(["issue", "family"]);
+export const exportSessionsSchema = {
+    inputSchema: {
+        sessionIds: z
+            .array(z.string())
+            .optional()
+            .describe("Specific session IDs to export. If omitted, exports all recorded sessions."),
+        query: z
+            .string()
+            .optional()
+            .describe("Optional text filter across metadata, transcript, and derived history. Cannot be combined with sessionIds."),
+        issueKey: z
+            .string()
+            .optional()
+            .describe("Optional exact issue key filter. Cannot be combined with sessionIds."),
+        host: sessionHostEnum
+            .optional()
+            .describe("Optional host filter. Cannot be combined with sessionIds."),
+        status: sessionStatusEnum
+            .optional()
+            .describe("Optional status filter. Cannot be combined with sessionIds."),
+        groupBy: trendGroupByEnum
+            .optional()
+            .describe("Optional history summary grouping. Controls whether exported cross-session summaries are grouped by exact issue keys or broader failure families."),
+        outputMode: outputModeEnum
+            .default("both")
+            .describe("Output mode: 'file' writes ZIP to disk, 'base64' returns ZIP as base64 string, 'both' does both."),
+    },
+    outputSchema: {
+        filename: z.string().optional(),
+        base64Data: z.string().optional(),
+        checksum: z.string(),
+        sessionCount: z.number(),
+        historyGrouping: trendGroupByEnum,
+        filters: z
+            .object({
+            query: z.string().optional(),
+            issueKey: z.string().optional(),
+            host: sessionHostEnum.optional(),
+            status: sessionStatusEnum.optional(),
+            groupBy: trendGroupByEnum.optional(),
+        })
+            .optional(),
+        sessions: z.array(z.object({
+            id: z.string(),
+            host: sessionHostEnum,
+            label: z.string(),
+            status: sessionStatusEnum,
+            startedAt: z.string(),
+            endedAt: z.string().nullable(),
+        })),
+        success: z.boolean(),
+    },
+};
+export const exportSessionsMetadata = {
+    title: "Export Sessions",
+    description: "Export recorded CLI sessions to a ZIP archive with raw transcript, timeline, derived artifacts, narratives, decisions, and top-level history summaries.",
+    ...sessionDetailUiMetadata,
+};
+export function createExportSessionsHandler(db) {
+    return wrapToolHandler("export-sessions", "Check session IDs exist, do not mix sessionIds with query/issueKey/host/status filters, and use outputMode='file' if the archive is too large for base64 delivery.", async (params) => {
+        const { exportSessions } = await import("../lib/storage/index.js");
+        const fs = await import("fs");
+        const os = await import("os");
+        const path = await import("path");
+        const outputMode = params.outputMode || "both";
+        const result = await exportSessions(db, {
+            sessionIds: params.sessionIds,
+            query: params.query,
+            issueKey: params.issueKey,
+            host: params.host,
+            status: params.status,
+            groupBy: params.groupBy,
+        });
+        const maxBase64Size = 75 * 1024 * 1024;
+        if ((outputMode === "base64" || outputMode === "both") &&
+            result.zipData.length > maxBase64Size) {
+            throw new Error(`Export too large for base64 mode (${(result.zipData.length / (1024 * 1024)).toFixed(1)}MB). Use outputMode="file" or export fewer sessions.`);
+        }
+        let filename;
+        let base64Data;
+        if (outputMode === "file" || outputMode === "both") {
+            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;
+        }
+        if (outputMode === "base64" || outputMode === "both") {
+            base64Data = Buffer.from(result.zipData).toString("base64");
+        }
+        const details = {
+            Sessions: result.sessionCount,
+            Checksum: result.checksum,
+            "Output Mode": outputMode,
+        };
+        if (filename) {
+            details.Filename = filename;
+        }
+        if (base64Data) {
+            details["Base64 Size"] = `${Math.round(base64Data.length / 1024)}KB`;
+        }
+        if (result.filters) {
+            details.Query = result.filters.query ?? "all";
+            details.Issue = result.filters.issueKey ?? "all";
+            details.Host = result.filters.host ?? "all";
+            details.Status = result.filters.status ?? "all";
+        }
+        details["History Grouping"] = result.historyGrouping;
+        return formatSuccessResponse("Session export completed successfully", details, {
+            ...(filename && { filename }),
+            ...(base64Data && { base64Data }),
+            checksum: result.checksum,
+            sessionCount: result.sessionCount,
+            historyGrouping: result.historyGrouping,
+            ...(result.filters ? { filters: result.filters } : {}),
+            sessions: result.sessions,
+            success: true,
+        });
+    });
+}
+//# sourceMappingURL=export-sessions.js.map

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

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

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

@@ -0,0 +1,208 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getContextSchema: {
+    inputSchema: {
+        id: z.ZodString;
+    };
+    outputSchema: {
+        context: z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            workspaceKey: z.ZodString;
+            latestSessionId: z.ZodString;
+            latestSessionLabel: z.ZodString;
+            latestStartedAt: z.ZodString;
+            latestEndedAt: z.ZodNullable<z.ZodString>;
+            sessionCount: z.ZodNumber;
+            hosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            confidence: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            confidenceScore: z.ZodNumber;
+            signals: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        currentTruth: z.ZodObject<{
+            summary: z.ZodString;
+            latestSessionId: z.ZodString;
+            latestSessionLabel: z.ZodString;
+            latestSummaryNarrative: z.ZodNullable<z.ZodString>;
+            latestHandoff: z.ZodNullable<z.ZodString>;
+            activeBlockers: z.ZodArray<z.ZodString>;
+            openQuestions: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        activeDecisions: z.ZodArray<z.ZodObject<{
+            decisionId: z.ZodString;
+            topic: z.ZodString;
+            sessionId: z.ZodString;
+            sessionLabel: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            rationale: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                proposed: "proposed";
+                accepted: "accepted";
+                rejected: "rejected";
+                open: "open";
+            }>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        supersededDecisions: z.ZodArray<z.ZodObject<{
+            decisionId: z.ZodString;
+            topic: z.ZodString;
+            sessionId: z.ZodString;
+            sessionLabel: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            rationale: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                proposed: "proposed";
+                accepted: "accepted";
+                rejected: "rejected";
+                open: "open";
+            }>;
+            createdAt: z.ZodString;
+            supersededByDecisionId: z.ZodNullable<z.ZodString>;
+            supersededByTitle: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        changeLog: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "decision-updated": "decision-updated";
+                "context-refreshed": "context-refreshed";
+            }>;
+            summary: z.ZodString;
+            sessionId: z.ZodNullable<z.ZodString>;
+            sessionLabel: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        sessions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            host: z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>;
+            startedAt: z.ZodString;
+            endedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        trends: z.ZodArray<z.ZodObject<{
+            groupBy: z.ZodEnum<{
+                issue: "issue";
+                family: "family";
+            }>;
+            issueKey: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodNullable<z.ZodString>;
+            relatedIssueKeys: z.ZodArray<z.ZodString>;
+            blockerCategory: z.ZodString;
+            blockerState: z.ZodEnum<{
+                active: "active";
+                resolved: "resolved";
+            }>;
+            remediationState: z.ZodEnum<{
+                unresolved: "unresolved";
+                recovered: "recovered";
+                regressed: "regressed";
+                stable: "stable";
+            }>;
+            remediationSummary: z.ZodString;
+            latestOutcome: z.ZodString;
+            latestFailureAt: z.ZodNullable<z.ZodString>;
+            latestSuccessAt: z.ZodNullable<z.ZodString>;
+            lastSeenAt: z.ZodString;
+            attemptCount: z.ZodNumber;
+            sessionCount: z.ZodNumber;
+            failedAttempts: z.ZodNumber;
+            succeededAttempts: z.ZodNumber;
+            otherAttempts: z.ZodNumber;
+            hosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            sessions: z.ZodArray<z.ZodObject<{
+                sessionId: z.ZodString;
+                label: z.ZodString;
+                host: z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>;
+                status: z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>;
+                startedAt: z.ZodString;
+                lastAttemptAt: z.ZodString;
+                attempts: z.ZodNumber;
+                latestOutcome: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        handoff: z.ZodObject<{
+            summary: z.ZodObject<{
+                groupBy: z.ZodEnum<{
+                    issue: "issue";
+                    family: "family";
+                }>;
+                headline: z.ZodString;
+                matchingSessions: z.ZodNumber;
+                matchingHosts: z.ZodArray<z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>>;
+                statuses: z.ZodArray<z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>>;
+                totalTrends: z.ZodNumber;
+                blockingTrends: z.ZodNumber;
+                recoveredTrends: z.ZodNumber;
+                regressedTrends: z.ZodNumber;
+                unresolvedQuestions: z.ZodNumber;
+                latestSessionId: z.ZodNullable<z.ZodString>;
+                latestSessionLabel: z.ZodNullable<z.ZodString>;
+                latestStartedAt: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            followUps: z.ZodArray<z.ZodString>;
+            blockers: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        markdown: z.ZodString;
+    };
+};
+export declare const getContextMetadata: {
+    title: string;
+    description: string;
+};
+export declare function createGetContextHandler(db: EvidenceDatabase): (params: {
+    id: string;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/context-memory.js").ContextReport>>;
+//# sourceMappingURL=get-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK5B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;CAI9B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,gBAAgB;QAInC,MAAM;gHAc9B"}

package/dist/src/tools/get-context.js

@@ -0,0 +1,27 @@
+import * as z from "zod";
+import { getContextReport } from "../lib/context-memory.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { contextReportSchema } from "./context-schemas.js";
+export const getContextSchema = {
+    inputSchema: {
+        id: z.string().min(1, "Context ID is required"),
+    },
+    outputSchema: contextReportSchema.shape,
+};
+export const getContextMetadata = {
+    title: "Get Context",
+    description: "Return the current truth, blockers, open questions, decisions, and recent session trail for a canonical context.",
+};
+export function createGetContextHandler(db) {
+    return wrapToolHandler("get-context", "Fetch a canonical context briefing by ID.", async (params) => {
+        const report = getContextReport(db, params.id.trim());
+        return formatSuccessResponse("Context retrieved successfully", {
+            Context: report.context.label,
+            Sessions: report.context.sessionCount,
+            ActiveDecisions: report.activeDecisions.length,
+            ActiveBlockers: report.currentTruth.activeBlockers.length,
+        }, report);
+    });
+}
+//# sourceMappingURL=get-context.js.map

package/dist/src/tools/get-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.js","sourceRoot":"","sources":["../../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;KAChD;IACD,YAAY,EAAE,mBAAmB,CAAC,KAAK;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,kHAAkH;CACrH,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,EAAoB;IAC1D,OAAO,eAAe,CACpB,aAAa,EACb,2CAA2C,EAC3C,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,qBAAqB,CAC1B,gCAAgC,EAChC;YACE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;YAC7B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;YAC9C,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,MAAM;SAC1D,EACD,MAAM,CACP,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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"}

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

@@ -4,7 +4,9 @@ import { formatSuccessResponse } from "../lib/tool-response.js";
 import { decrypt } from "../lib/crypto/index.js";
 export const getFootprintSchema = {
     inputSchema: {
-        id: z.string().describe("Footprint ID"),
+        id: z
+            .string()
+            .describe("UUID of the footprint to retrieve. Use list-footprints or search-footprints to find IDs."),
     },
     outputSchema: {
         id: z.string(),
@@ -24,7 +26,7 @@ export const getFootprintSchema = {
 };
 export const getFootprintMetadata = {
     title: "Get Footprint",
-    description: "Retrieve and decrypt specific footprint by ID",
+    description: "Retrieve and decrypt a specific footprint by ID. Returns full conversation content (decrypted), metadata, and Git timestamp info. Requires the correct encryption password (set via FOOTPRINT_PASSPHRASE env var).",
     _meta: {
         ui: {
             resourceUri: "ui://footprint/detail.html",
@@ -50,7 +52,9 @@ export function createGetFootprintHandler(db, getDerivedKey) {
             Timestamp: evidence.timestamp,
             Provider: evidence.llmProvider,
             "Message Count": evidence.messageCount,
-            "Content Preview": `${decrypted.substring(0, 100)}...`,
+            "Content Preview": decrypted.length > 100
+                ? `${decrypted.substring(0, 100)}...`
+                : decrypted,
         }, {
             id: evidence.id,
             timestamp: evidence.timestamp,

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

@@ -1 +1 @@
-{"version":3,"file":"get-footprint.js","sourceRoot":"","sources":["../../../src/tools/get-footprint.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;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;KACxC;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC;aACP,MAAM,CAAC;YACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC;aACD,QAAQ,EAAE;QACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,+CAA+C;IAC5D,KAAK,EAAE;QACL,EAAE,EAAE;YACF,WAAW,EAAE,4BAA4B;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,EAAoB,EACpB,aAAwC;IAExC,OAAO,eAAe,CACpB,eAAe,EACf,wDAAwD,EACxD,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE1E,MAAM,OAAO,GACX,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,YAAY;YAC7C,CAAC,CAAC;gBACE,UAAU,EAAE,QAAQ,CAAC,aAAa;gBAClC,SAAS,EAAE,QAAQ,CAAC,YAAY;aACjC;YACH,CAAC,CAAC,IAAI,CAAC;QAEX,OAAO,qBAAqB,CAC1B,iCAAiC,EACjC;YACE,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,WAAW;YAC9B,eAAe,EAAE,QAAQ,CAAC,YAAY;YACtC,iBAAiB,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;SACvD,EACD;YACE,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,SAAS;YAClB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-footprint.js","sourceRoot":"","sources":["../../../src/tools/get-footprint.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/get-history-handoff.d.ts

@@ -0,0 +1,109 @@
+import * as z from "zod";
+import type { EvidenceDatabase, SessionHost, SessionStatus } from "../lib/storage/index.js";
+export declare const getHistoryHandoffSchema: {
+    inputSchema: {
+        query: z.ZodOptional<z.ZodString>;
+        issueKey: z.ZodOptional<z.ZodString>;
+        host: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            gemini: "gemini";
+            codex: "codex";
+        }>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+            interrupted: "interrupted";
+        }>>;
+        groupBy: z.ZodOptional<z.ZodEnum<{
+            issue: "issue";
+            family: "family";
+        }>>;
+    };
+    outputSchema: {
+        filters: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            issueKey: z.ZodOptional<z.ZodString>;
+            host: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            status: z.ZodOptional<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            groupBy: z.ZodOptional<z.ZodEnum<{
+                issue: "issue";
+                family: "family";
+            }>>;
+        }, z.core.$strip>;
+        summary: z.ZodObject<{
+            groupBy: z.ZodEnum<{
+                issue: "issue";
+                family: "family";
+            }>;
+            headline: z.ZodString;
+            matchingSessions: z.ZodNumber;
+            matchingHosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            totalTrends: z.ZodNumber;
+            blockingTrends: z.ZodNumber;
+            recoveredTrends: z.ZodNumber;
+            regressedTrends: z.ZodNumber;
+            unresolvedQuestions: z.ZodNumber;
+            latestSessionId: z.ZodNullable<z.ZodString>;
+            latestSessionLabel: z.ZodNullable<z.ZodString>;
+            latestStartedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        blockers: z.ZodArray<z.ZodString>;
+        recoveries: z.ZodArray<z.ZodString>;
+        followUps: z.ZodArray<z.ZodString>;
+        recentSessions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            host: z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>;
+            status: z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>;
+            startedAt: z.ZodString;
+            endedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        markdown: z.ZodString;
+    };
+};
+export declare const getHistoryHandoffMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-dashboard.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetHistoryHandoffHandler(db: EvidenceDatabase): (params: {
+    query?: string;
+    issueKey?: string;
+    host?: SessionHost;
+    status?: SessionStatus;
+    groupBy?: "issue" | "family";
+}) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/history-handoff.js").HistoryHandoffReport>>;
+//# sourceMappingURL=get-history-handoff.d.ts.map

package/dist/src/tools/get-history-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-history-handoff.d.ts","sourceRoot":"","sources":["../../../src/tools/get-history-handoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACd,MAAM,yBAAyB,CAAC;AAYjC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDnC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;CAKrC,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,gBAAgB;YAKrD,MAAM;eACH,MAAM;WACV,WAAW;aACT,aAAa;cACZ,OAAO,GAAG,QAAQ;wHAqBjC"}

package/dist/src/tools/get-history-handoff.js

@@ -0,0 +1,85 @@
+import * as z from "zod";
+import { buildHistoryHandoffReport } from "../lib/history-handoff.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDashboardUiMetadata } from "./session-ui-metadata.js";
+const sessionHostEnum = z.enum(["claude", "gemini", "codex"]);
+const sessionStatusEnum = z.enum([
+    "running",
+    "completed",
+    "failed",
+    "interrupted",
+]);
+const trendGroupByEnum = z.enum(["issue", "family"]);
+export const getHistoryHandoffSchema = {
+    inputSchema: {
+        query: z
+            .string()
+            .optional()
+            .describe("Optional text filter across metadata, transcript, and derived history"),
+        issueKey: z.string().optional().describe("Optional exact issue key filter"),
+        host: sessionHostEnum.optional().describe("Optional host filter"),
+        status: sessionStatusEnum.optional().describe("Optional status filter"),
+        groupBy: trendGroupByEnum
+            .optional()
+            .describe("Aggregate blockers and trend counts by exact issue keys or broader failure families"),
+    },
+    outputSchema: {
+        filters: z.object({
+            query: z.string().optional(),
+            issueKey: z.string().optional(),
+            host: sessionHostEnum.optional(),
+            status: sessionStatusEnum.optional(),
+            groupBy: trendGroupByEnum.optional(),
+        }),
+        summary: z.object({
+            groupBy: trendGroupByEnum,
+            headline: z.string(),
+            matchingSessions: z.number(),
+            matchingHosts: z.array(sessionHostEnum),
+            statuses: z.array(sessionStatusEnum),
+            totalTrends: z.number(),
+            blockingTrends: z.number(),
+            recoveredTrends: z.number(),
+            regressedTrends: z.number(),
+            unresolvedQuestions: z.number(),
+            latestSessionId: z.string().nullable(),
+            latestSessionLabel: z.string().nullable(),
+            latestStartedAt: z.string().nullable(),
+        }),
+        blockers: z.array(z.string()),
+        recoveries: z.array(z.string()),
+        followUps: z.array(z.string()),
+        recentSessions: z.array(z.object({
+            id: z.string(),
+            label: z.string(),
+            host: sessionHostEnum,
+            status: sessionStatusEnum,
+            startedAt: z.string(),
+            endedAt: z.string().nullable(),
+        })),
+        markdown: z.string(),
+    },
+};
+export const getHistoryHandoffMetadata = {
+    title: "Get History Handoff",
+    description: "Summarize the current history scope as a handoff-oriented status report with blockers, follow-ups, recent sessions, and optional broader failure-family grouping.",
+    ...sessionDashboardUiMetadata,
+};
+export function createGetHistoryHandoffHandler(db) {
+    return wrapToolHandler("get-history-handoff", "Use optional query, issueKey, host, status, and groupBy filters to summarize the current history scope.", async (params) => {
+        const report = buildHistoryHandoffReport(db, params);
+        return formatSuccessResponse("History handoff retrieved successfully", {
+            Query: params.query?.trim() || "all",
+            Issue: params.issueKey?.trim() || "all",
+            Host: params.host ?? "all",
+            Status: params.status ?? "all",
+            GroupBy: params.groupBy ?? "issue",
+            Sessions: report.summary.matchingSessions,
+            Trends: report.summary.totalTrends,
+            Blockers: report.summary.blockingTrends,
+            Questions: report.summary.unresolvedQuestions,
+        }, report);
+    });
+}
+//# sourceMappingURL=get-history-handoff.js.map

package/dist/src/tools/get-history-handoff.js.map

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