@pcircle/footprint 1.5.0 → 1.7.0

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

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

@@ -0,0 +1,155 @@
+import * as z from "zod";
+import type { EvidenceDatabase, SessionHost, SessionStatus } from "../lib/storage/index.js";
+export declare const getHistoryTrendsSchema: {
+    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";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    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";
+            }>;
+            totalTrends: z.ZodNumber;
+            matchingSessions: z.ZodNumber;
+            totalAttempts: z.ZodNumber;
+            activeBlockers: z.ZodNumber;
+            recoveredTrends: z.ZodNumber;
+            regressedTrends: z.ZodNumber;
+            byOutcome: z.ZodObject<{
+                failed: z.ZodNumber;
+                succeeded: z.ZodNumber;
+                other: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        total: z.ZodNumber;
+        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>>;
+    };
+};
+export declare const getHistoryTrendsMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-dashboard.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetHistoryTrendsHandler(db: EvidenceDatabase): (params: {
+    query?: string;
+    issueKey?: string;
+    host?: SessionHost;
+    status?: SessionStatus;
+    groupBy?: "issue" | "family";
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    summary: import("../lib/session-trends.js").HistoryTrendSummary;
+    total: number;
+    trends: import("../lib/session-trends.js").HistoryTrend[];
+    filters: {
+        query: string | undefined;
+        issueKey: string | undefined;
+        host: SessionHost | undefined;
+        status: SessionStatus | undefined;
+        groupBy: "issue" | "family" | undefined;
+    };
+}>>;
+//# sourceMappingURL=get-history-trends.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-history-trends.d.ts","sourceRoot":"","sources":["../../../src/tools/get-history-trends.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,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CAKpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;YAKpD,MAAM;eACH,MAAM;WACV,WAAW;aACT,aAAa;cACZ,OAAO,GAAG,QAAQ;YACpB,MAAM;aACL,MAAM;;;;;;;;;;;;IA8BpB"}

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

@@ -0,0 +1,123 @@
+import * as z from "zod";
+import { buildHistoryTrendReport } from "../lib/session-trends.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 getHistoryTrendsSchema = {
+    inputSchema: {
+        query: z
+            .string()
+            .optional()
+            .describe("Optional text filter across issue key, label, and kind"),
+        issueKey: z.string().optional().describe("Optional exact issue key filter"),
+        host: sessionHostEnum.optional().describe("Optional host filter"),
+        status: sessionStatusEnum
+            .optional()
+            .describe("Optional session status filter"),
+        groupBy: trendGroupByEnum
+            .optional()
+            .describe("Aggregate by exact issue keys or broader failure families"),
+        limit: z.number().int().positive().optional(),
+        offset: z.number().int().min(0).optional(),
+    },
+    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,
+            totalTrends: z.number(),
+            matchingSessions: z.number(),
+            totalAttempts: z.number(),
+            activeBlockers: z.number(),
+            recoveredTrends: z.number(),
+            regressedTrends: z.number(),
+            byOutcome: z.object({
+                failed: z.number(),
+                succeeded: z.number(),
+                other: z.number(),
+            }),
+        }),
+        total: z.number(),
+        trends: z.array(z.object({
+            groupBy: trendGroupByEnum,
+            issueKey: z.string(),
+            label: z.string(),
+            kind: z.string().nullable(),
+            relatedIssueKeys: z.array(z.string()),
+            blockerCategory: z.string(),
+            blockerState: z.enum(["active", "resolved"]),
+            remediationState: z.enum([
+                "unresolved",
+                "recovered",
+                "regressed",
+                "stable",
+            ]),
+            remediationSummary: z.string(),
+            latestOutcome: z.string(),
+            latestFailureAt: z.string().nullable(),
+            latestSuccessAt: z.string().nullable(),
+            lastSeenAt: z.string(),
+            attemptCount: z.number(),
+            sessionCount: z.number(),
+            failedAttempts: z.number(),
+            succeededAttempts: z.number(),
+            otherAttempts: z.number(),
+            hosts: z.array(sessionHostEnum),
+            statuses: z.array(sessionStatusEnum),
+            sessions: z.array(z.object({
+                sessionId: z.string(),
+                label: z.string(),
+                host: sessionHostEnum,
+                status: sessionStatusEnum,
+                startedAt: z.string(),
+                lastAttemptAt: z.string(),
+                attempts: z.number(),
+                latestOutcome: z.string(),
+            })),
+        })),
+    },
+};
+export const getHistoryTrendsMetadata = {
+    title: "Get History Trends",
+    description: "Aggregate recurring issue patterns across recorded sessions, including retries, failure clusters, latest outcomes, and optional broader failure families.",
+    ...sessionDashboardUiMetadata,
+};
+export function createGetHistoryTrendsHandler(db) {
+    return wrapToolHandler("get-history-trends", "Use optional query, issueKey, host, status, groupBy, limit, and offset filters to inspect recurring cross-session issues.", async (params) => {
+        const report = buildHistoryTrendReport(db, params);
+        return formatSuccessResponse("History trends retrieved successfully", {
+            Query: params.query?.trim() || "all",
+            Issue: params.issueKey?.trim() || "all",
+            Host: params.host ?? "all",
+            Status: params.status ?? "all",
+            GroupBy: params.groupBy ?? "issue",
+            Trends: report.trends.length,
+            Total: report.total,
+            Sessions: report.summary.matchingSessions,
+            Attempts: report.summary.totalAttempts,
+        }, {
+            filters: {
+                query: params.query?.trim() || undefined,
+                issueKey: params.issueKey?.trim() || undefined,
+                host: params.host,
+                status: params.status,
+                groupBy: params.groupBy,
+            },
+            ...report,
+        });
+    });
+}
+//# sourceMappingURL=get-history-trends.js.map

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

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