@pcircle/footprint 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +225 -123
  3. package/SKILL.md +72 -28
  4. package/bin/footprint.js +16 -0
  5. package/dist/src/adapters/claude.d.ts +2 -0
  6. package/dist/src/adapters/claude.d.ts.map +1 -0
  7. package/dist/src/adapters/claude.js +7 -0
  8. package/dist/src/adapters/claude.js.map +1 -0
  9. package/dist/src/adapters/codex.d.ts +2 -0
  10. package/dist/src/adapters/codex.d.ts.map +1 -0
  11. package/dist/src/adapters/codex.js +7 -0
  12. package/dist/src/adapters/codex.js.map +1 -0
  13. package/dist/src/adapters/gemini.d.ts +2 -0
  14. package/dist/src/adapters/gemini.d.ts.map +1 -0
  15. package/dist/src/adapters/gemini.js +7 -0
  16. package/dist/src/adapters/gemini.js.map +1 -0
  17. package/dist/src/adapters/index.d.ts +5 -0
  18. package/dist/src/adapters/index.d.ts.map +1 -0
  19. package/dist/src/adapters/index.js +12 -0
  20. package/dist/src/adapters/index.js.map +1 -0
  21. package/dist/src/adapters/structured-prefix.d.ts +10 -0
  22. package/dist/src/adapters/structured-prefix.d.ts.map +1 -0
  23. package/dist/src/adapters/structured-prefix.js +59 -0
  24. package/dist/src/adapters/structured-prefix.js.map +1 -0
  25. package/dist/src/adapters/types.d.ts +32 -0
  26. package/dist/src/adapters/types.d.ts.map +1 -0
  27. package/dist/src/adapters/types.js +2 -0
  28. package/dist/src/adapters/types.js.map +1 -0
  29. package/dist/src/cli/context-flow.d.ts +92 -0
  30. package/dist/src/cli/context-flow.d.ts.map +1 -0
  31. package/dist/src/cli/context-flow.js +724 -0
  32. package/dist/src/cli/context-flow.js.map +1 -0
  33. package/dist/src/cli/history-display.d.ts +27 -0
  34. package/dist/src/cli/history-display.d.ts.map +1 -0
  35. package/dist/src/cli/history-display.js +167 -0
  36. package/dist/src/cli/history-display.js.map +1 -0
  37. package/dist/src/cli/index.js +924 -0
  38. package/dist/src/cli/index.js.map +1 -1
  39. package/dist/src/cli/launch-spec.d.ts +31 -0
  40. package/dist/src/cli/launch-spec.d.ts.map +1 -0
  41. package/dist/src/cli/launch-spec.js +182 -0
  42. package/dist/src/cli/launch-spec.js.map +1 -0
  43. package/dist/src/cli/live-demo.d.ts +34 -0
  44. package/dist/src/cli/live-demo.d.ts.map +1 -0
  45. package/dist/src/cli/live-demo.js +254 -0
  46. package/dist/src/cli/live-demo.js.map +1 -0
  47. package/dist/src/cli/pty-transcript.d.ts +34 -0
  48. package/dist/src/cli/pty-transcript.d.ts.map +1 -0
  49. package/dist/src/cli/pty-transcript.js +174 -0
  50. package/dist/src/cli/pty-transcript.js.map +1 -0
  51. package/dist/src/cli/session-display.d.ts +74 -0
  52. package/dist/src/cli/session-display.d.ts.map +1 -0
  53. package/dist/src/cli/session-display.js +922 -0
  54. package/dist/src/cli/session-display.js.map +1 -0
  55. package/dist/src/cli/session-execution.d.ts +55 -0
  56. package/dist/src/cli/session-execution.d.ts.map +1 -0
  57. package/dist/src/cli/session-execution.js +817 -0
  58. package/dist/src/cli/session-execution.js.map +1 -0
  59. package/dist/src/cli/session-runtime.d.ts +5 -0
  60. package/dist/src/cli/session-runtime.d.ts.map +1 -0
  61. package/dist/src/cli/session-runtime.js +11 -0
  62. package/dist/src/cli/session-runtime.js.map +1 -0
  63. package/dist/src/cli/setup.d.ts.map +1 -1
  64. package/dist/src/cli/setup.js +2 -0
  65. package/dist/src/cli/setup.js.map +1 -1
  66. package/dist/src/index.d.ts +4 -0
  67. package/dist/src/index.d.ts.map +1 -1
  68. package/dist/src/index.js +148 -7
  69. package/dist/src/index.js.map +1 -1
  70. package/dist/src/ingestion/deterministic.d.ts +3 -0
  71. package/dist/src/ingestion/deterministic.d.ts.map +1 -0
  72. package/dist/src/ingestion/deterministic.js +862 -0
  73. package/dist/src/ingestion/deterministic.js.map +1 -0
  74. package/dist/src/ingestion/index.d.ts +5 -0
  75. package/dist/src/ingestion/index.d.ts.map +1 -0
  76. package/dist/src/ingestion/index.js +27 -0
  77. package/dist/src/ingestion/index.js.map +1 -0
  78. package/dist/src/ingestion/semantic.d.ts +6 -0
  79. package/dist/src/ingestion/semantic.d.ts.map +1 -0
  80. package/dist/src/ingestion/semantic.js +627 -0
  81. package/dist/src/ingestion/semantic.js.map +1 -0
  82. package/dist/src/ingestion/types.d.ts +10 -0
  83. package/dist/src/ingestion/types.d.ts.map +1 -0
  84. package/dist/src/ingestion/types.js +2 -0
  85. package/dist/src/ingestion/types.js.map +1 -0
  86. package/dist/src/lib/context-memory.d.ts +140 -0
  87. package/dist/src/lib/context-memory.d.ts.map +1 -0
  88. package/dist/src/lib/context-memory.js +974 -0
  89. package/dist/src/lib/context-memory.js.map +1 -0
  90. package/dist/src/lib/history-handoff.d.ts +43 -0
  91. package/dist/src/lib/history-handoff.d.ts.map +1 -0
  92. package/dist/src/lib/history-handoff.js +179 -0
  93. package/dist/src/lib/history-handoff.js.map +1 -0
  94. package/dist/src/lib/observability.d.ts +3 -0
  95. package/dist/src/lib/observability.d.ts.map +1 -0
  96. package/dist/src/lib/observability.js +63 -0
  97. package/dist/src/lib/observability.js.map +1 -0
  98. package/dist/src/lib/session-artifacts.d.ts +51 -0
  99. package/dist/src/lib/session-artifacts.d.ts.map +1 -0
  100. package/dist/src/lib/session-artifacts.js +132 -0
  101. package/dist/src/lib/session-artifacts.js.map +1 -0
  102. package/dist/src/lib/session-filters.d.ts +11 -0
  103. package/dist/src/lib/session-filters.d.ts.map +1 -0
  104. package/dist/src/lib/session-filters.js +16 -0
  105. package/dist/src/lib/session-filters.js.map +1 -0
  106. package/dist/src/lib/session-history.d.ts +50 -0
  107. package/dist/src/lib/session-history.d.ts.map +1 -0
  108. package/dist/src/lib/session-history.js +73 -0
  109. package/dist/src/lib/session-history.js.map +1 -0
  110. package/dist/src/lib/session-trends.d.ts +129 -0
  111. package/dist/src/lib/session-trends.d.ts.map +1 -0
  112. package/dist/src/lib/session-trends.js +361 -0
  113. package/dist/src/lib/session-trends.js.map +1 -0
  114. package/dist/src/lib/storage/database.d.ts +212 -1
  115. package/dist/src/lib/storage/database.d.ts.map +1 -1
  116. package/dist/src/lib/storage/database.js +1694 -114
  117. package/dist/src/lib/storage/database.js.map +1 -1
  118. package/dist/src/lib/storage/export-sessions.d.ts +33 -0
  119. package/dist/src/lib/storage/export-sessions.d.ts.map +1 -0
  120. package/dist/src/lib/storage/export-sessions.js +525 -0
  121. package/dist/src/lib/storage/export-sessions.js.map +1 -0
  122. package/dist/src/lib/storage/index.d.ts +7 -6
  123. package/dist/src/lib/storage/index.d.ts.map +1 -1
  124. package/dist/src/lib/storage/index.js +6 -5
  125. package/dist/src/lib/storage/index.js.map +1 -1
  126. package/dist/src/lib/storage/schema.d.ts +6 -1
  127. package/dist/src/lib/storage/schema.d.ts.map +1 -1
  128. package/dist/src/lib/storage/schema.js +337 -2
  129. package/dist/src/lib/storage/schema.js.map +1 -1
  130. package/dist/src/lib/storage/types.d.ts +122 -0
  131. package/dist/src/lib/storage/types.d.ts.map +1 -1
  132. package/dist/src/prompts/skill-prompt.d.ts.map +1 -1
  133. package/dist/src/prompts/skill-prompt.js +13 -0
  134. package/dist/src/prompts/skill-prompt.js.map +1 -1
  135. package/dist/src/tools/confirm-context-link.d.ts +62 -0
  136. package/dist/src/tools/confirm-context-link.d.ts.map +1 -0
  137. package/dist/src/tools/confirm-context-link.js +36 -0
  138. package/dist/src/tools/confirm-context-link.js.map +1 -0
  139. package/dist/src/tools/context-schemas.d.ts +694 -0
  140. package/dist/src/tools/context-schemas.d.ts.map +1 -0
  141. package/dist/src/tools/context-schemas.js +171 -0
  142. package/dist/src/tools/context-schemas.js.map +1 -0
  143. package/dist/src/tools/export-sessions.d.ts +111 -0
  144. package/dist/src/tools/export-sessions.d.ts.map +1 -0
  145. package/dist/src/tools/export-sessions.js +136 -0
  146. package/dist/src/tools/export-sessions.js.map +1 -0
  147. package/dist/src/tools/get-context.d.ts +208 -0
  148. package/dist/src/tools/get-context.d.ts.map +1 -0
  149. package/dist/src/tools/get-context.js +27 -0
  150. package/dist/src/tools/get-context.js.map +1 -0
  151. package/dist/src/tools/get-history-handoff.d.ts +109 -0
  152. package/dist/src/tools/get-history-handoff.d.ts.map +1 -0
  153. package/dist/src/tools/get-history-handoff.js +85 -0
  154. package/dist/src/tools/get-history-handoff.js.map +1 -0
  155. package/dist/src/tools/get-history-trends.d.ts +155 -0
  156. package/dist/src/tools/get-history-trends.d.ts.map +1 -0
  157. package/dist/src/tools/get-history-trends.js +123 -0
  158. package/dist/src/tools/get-history-trends.js.map +1 -0
  159. package/dist/src/tools/get-session-artifacts.d.ts +151 -0
  160. package/dist/src/tools/get-session-artifacts.d.ts.map +1 -0
  161. package/dist/src/tools/get-session-artifacts.js +184 -0
  162. package/dist/src/tools/get-session-artifacts.js.map +1 -0
  163. package/dist/src/tools/get-session-decisions.d.ts +69 -0
  164. package/dist/src/tools/get-session-decisions.d.ts.map +1 -0
  165. package/dist/src/tools/get-session-decisions.js +99 -0
  166. package/dist/src/tools/get-session-decisions.js.map +1 -0
  167. package/dist/src/tools/get-session-messages.d.ts +55 -0
  168. package/dist/src/tools/get-session-messages.d.ts.map +1 -0
  169. package/dist/src/tools/get-session-messages.js +89 -0
  170. package/dist/src/tools/get-session-messages.js.map +1 -0
  171. package/dist/src/tools/get-session-narrative.d.ts +72 -0
  172. package/dist/src/tools/get-session-narrative.d.ts.map +1 -0
  173. package/dist/src/tools/get-session-narrative.js +106 -0
  174. package/dist/src/tools/get-session-narrative.js.map +1 -0
  175. package/dist/src/tools/get-session-timeline.d.ts +55 -0
  176. package/dist/src/tools/get-session-timeline.d.ts.map +1 -0
  177. package/dist/src/tools/get-session-timeline.js +93 -0
  178. package/dist/src/tools/get-session-timeline.js.map +1 -0
  179. package/dist/src/tools/get-session-trends.d.ts +108 -0
  180. package/dist/src/tools/get-session-trends.d.ts.map +1 -0
  181. package/dist/src/tools/get-session-trends.js +130 -0
  182. package/dist/src/tools/get-session-trends.js.map +1 -0
  183. package/dist/src/tools/get-session.d.ts +251 -0
  184. package/dist/src/tools/get-session.d.ts.map +1 -0
  185. package/dist/src/tools/get-session.js +290 -0
  186. package/dist/src/tools/get-session.js.map +1 -0
  187. package/dist/src/tools/index.d.ts +22 -0
  188. package/dist/src/tools/index.d.ts.map +1 -1
  189. package/dist/src/tools/index.js +22 -0
  190. package/dist/src/tools/index.js.map +1 -1
  191. package/dist/src/tools/list-contexts.d.ts +50 -0
  192. package/dist/src/tools/list-contexts.d.ts.map +1 -0
  193. package/dist/src/tools/list-contexts.js +28 -0
  194. package/dist/src/tools/list-contexts.js.map +1 -0
  195. package/dist/src/tools/list-sessions.d.ts +86 -0
  196. package/dist/src/tools/list-sessions.d.ts.map +1 -0
  197. package/dist/src/tools/list-sessions.js +97 -0
  198. package/dist/src/tools/list-sessions.js.map +1 -0
  199. package/dist/src/tools/merge-contexts.d.ts +58 -0
  200. package/dist/src/tools/merge-contexts.d.ts.map +1 -0
  201. package/dist/src/tools/merge-contexts.js +27 -0
  202. package/dist/src/tools/merge-contexts.js.map +1 -0
  203. package/dist/src/tools/move-session-context.d.ts +62 -0
  204. package/dist/src/tools/move-session-context.d.ts.map +1 -0
  205. package/dist/src/tools/move-session-context.js +33 -0
  206. package/dist/src/tools/move-session-context.js.map +1 -0
  207. package/dist/src/tools/reingest-session.d.ts +31 -0
  208. package/dist/src/tools/reingest-session.d.ts.map +1 -0
  209. package/dist/src/tools/reingest-session.js +43 -0
  210. package/dist/src/tools/reingest-session.js.map +1 -0
  211. package/dist/src/tools/reject-context-link.d.ts +58 -0
  212. package/dist/src/tools/reject-context-link.d.ts.map +1 -0
  213. package/dist/src/tools/reject-context-link.js +26 -0
  214. package/dist/src/tools/reject-context-link.js.map +1 -0
  215. package/dist/src/tools/resolve-context.d.ts +287 -0
  216. package/dist/src/tools/resolve-context.d.ts.map +1 -0
  217. package/dist/src/tools/resolve-context.js +35 -0
  218. package/dist/src/tools/resolve-context.js.map +1 -0
  219. package/dist/src/tools/search-history.d.ts +86 -0
  220. package/dist/src/tools/search-history.d.ts.map +1 -0
  221. package/dist/src/tools/search-history.js +103 -0
  222. package/dist/src/tools/search-history.js.map +1 -0
  223. package/dist/src/tools/session-ui-metadata.d.ts +15 -0
  224. package/dist/src/tools/session-ui-metadata.d.ts.map +1 -0
  225. package/dist/src/tools/session-ui-metadata.js +15 -0
  226. package/dist/src/tools/session-ui-metadata.js.map +1 -0
  227. package/dist/src/tools/set-active-context.d.ts +58 -0
  228. package/dist/src/tools/set-active-context.d.ts.map +1 -0
  229. package/dist/src/tools/set-active-context.js +26 -0
  230. package/dist/src/tools/set-active-context.js.map +1 -0
  231. package/dist/src/tools/split-context.d.ts +62 -0
  232. package/dist/src/tools/split-context.d.ts.map +1 -0
  233. package/dist/src/tools/split-context.js +36 -0
  234. package/dist/src/tools/split-context.js.map +1 -0
  235. package/dist/src/tools/verify-footprint.js +1 -1
  236. package/dist/src/tools/verify-footprint.js.map +1 -1
  237. package/dist/src/types.d.ts +2 -0
  238. package/dist/src/types.d.ts.map +1 -1
  239. package/dist/src/ui/register.d.ts +6 -1
  240. package/dist/src/ui/register.d.ts.map +1 -1
  241. package/dist/src/ui/register.js +60 -16
  242. package/dist/src/ui/register.js.map +1 -1
  243. package/dist/ui/dashboard.html +236 -865
  244. package/dist/ui/detail.html +107 -248
  245. package/dist/ui/export.html +115 -298
  246. package/dist/ui/session-dashboard-live.html +264 -0
  247. package/dist/ui/session-dashboard.html +329 -0
  248. package/dist/ui/session-detail-live.html +336 -0
  249. package/dist/ui/session-detail.html +355 -0
  250. package/package.json +49 -9
@@ -0,0 +1,171 @@
1
+ import * as z from "zod";
2
+ export const sessionHostEnum = z.enum(["claude", "gemini", "codex"]);
3
+ export const sessionStatusEnum = z.enum([
4
+ "running",
5
+ "completed",
6
+ "failed",
7
+ "interrupted",
8
+ ]);
9
+ export const contextConfidenceEnum = z.enum(["high", "medium", "low"]);
10
+ export const contextSessionSummarySchema = z.object({
11
+ id: z.string(),
12
+ label: z.string(),
13
+ host: sessionHostEnum,
14
+ status: sessionStatusEnum,
15
+ startedAt: z.string(),
16
+ endedAt: z.string().nullable(),
17
+ });
18
+ export const contextListItemSchema = z.object({
19
+ id: z.string(),
20
+ label: z.string(),
21
+ workspaceKey: z.string(),
22
+ latestSessionId: z.string(),
23
+ latestSessionLabel: z.string(),
24
+ latestStartedAt: z.string(),
25
+ latestEndedAt: z.string().nullable(),
26
+ sessionCount: z.number(),
27
+ hosts: z.array(sessionHostEnum),
28
+ statuses: z.array(sessionStatusEnum),
29
+ confidence: contextConfidenceEnum,
30
+ confidenceScore: z.number(),
31
+ signals: z.array(z.string()),
32
+ });
33
+ export const contextDecisionSchema = z.object({
34
+ decisionId: z.string(),
35
+ topic: z.string(),
36
+ sessionId: z.string(),
37
+ sessionLabel: z.string(),
38
+ title: z.string(),
39
+ summary: z.string(),
40
+ rationale: z.string().nullable(),
41
+ status: z.enum(["proposed", "accepted", "rejected", "open"]),
42
+ createdAt: z.string(),
43
+ });
44
+ export const supersededContextDecisionSchema = contextDecisionSchema.extend({
45
+ supersededByDecisionId: z.string().nullable(),
46
+ supersededByTitle: z.string().nullable(),
47
+ });
48
+ export const contextChangeSchema = z.object({
49
+ kind: z.enum(["decision-updated", "context-refreshed"]),
50
+ summary: z.string(),
51
+ sessionId: z.string().nullable(),
52
+ sessionLabel: z.string().nullable(),
53
+ createdAt: z.string().nullable(),
54
+ });
55
+ export const contextCurrentTruthSchema = z.object({
56
+ summary: z.string(),
57
+ latestSessionId: z.string(),
58
+ latestSessionLabel: z.string(),
59
+ latestSummaryNarrative: z.string().nullable(),
60
+ latestHandoff: z.string().nullable(),
61
+ activeBlockers: z.array(z.string()),
62
+ openQuestions: z.array(z.string()),
63
+ });
64
+ export const contextTrendSchema = z.object({
65
+ groupBy: z.enum(["issue", "family"]),
66
+ issueKey: z.string(),
67
+ label: z.string(),
68
+ kind: z.string().nullable(),
69
+ relatedIssueKeys: z.array(z.string()),
70
+ blockerCategory: z.string(),
71
+ blockerState: z.enum(["active", "resolved"]),
72
+ remediationState: z.enum(["unresolved", "recovered", "regressed", "stable"]),
73
+ remediationSummary: z.string(),
74
+ latestOutcome: z.string(),
75
+ latestFailureAt: z.string().nullable(),
76
+ latestSuccessAt: z.string().nullable(),
77
+ lastSeenAt: z.string(),
78
+ attemptCount: z.number(),
79
+ sessionCount: z.number(),
80
+ failedAttempts: z.number(),
81
+ succeededAttempts: z.number(),
82
+ otherAttempts: z.number(),
83
+ hosts: z.array(sessionHostEnum),
84
+ statuses: z.array(sessionStatusEnum),
85
+ sessions: z.array(z.object({
86
+ sessionId: z.string(),
87
+ label: z.string(),
88
+ host: sessionHostEnum,
89
+ status: sessionStatusEnum,
90
+ startedAt: z.string(),
91
+ lastAttemptAt: z.string(),
92
+ attempts: z.number(),
93
+ latestOutcome: z.string(),
94
+ })),
95
+ });
96
+ export const contextReportSchema = z.object({
97
+ context: contextListItemSchema,
98
+ currentTruth: contextCurrentTruthSchema,
99
+ activeDecisions: z.array(contextDecisionSchema),
100
+ supersededDecisions: z.array(supersededContextDecisionSchema),
101
+ changeLog: z.array(contextChangeSchema),
102
+ sessions: z.array(contextSessionSummarySchema),
103
+ trends: z.array(contextTrendSchema),
104
+ handoff: z.object({
105
+ summary: z.object({
106
+ groupBy: z.enum(["issue", "family"]),
107
+ headline: z.string(),
108
+ matchingSessions: z.number(),
109
+ matchingHosts: z.array(sessionHostEnum),
110
+ statuses: z.array(sessionStatusEnum),
111
+ totalTrends: z.number(),
112
+ blockingTrends: z.number(),
113
+ recoveredTrends: z.number(),
114
+ regressedTrends: z.number(),
115
+ unresolvedQuestions: z.number(),
116
+ latestSessionId: z.string().nullable(),
117
+ latestSessionLabel: z.string().nullable(),
118
+ latestStartedAt: z.string().nullable(),
119
+ }),
120
+ followUps: z.array(z.string()),
121
+ blockers: z.array(z.string()),
122
+ }),
123
+ markdown: z.string(),
124
+ });
125
+ export const contextCandidateSchema = z.object({
126
+ kind: z.enum(["existing-context", "new-context"]),
127
+ contextId: z.string().nullable(),
128
+ label: z.string(),
129
+ workspaceKey: z.string(),
130
+ confidence: contextConfidenceEnum,
131
+ confidenceScore: z.number(),
132
+ reasons: z.array(z.string()),
133
+ sessionIds: z.array(z.string()),
134
+ latestSessionId: z.string().nullable(),
135
+ latestSessionLabel: z.string().nullable(),
136
+ preferred: z.boolean(),
137
+ confirmationRequired: z.boolean(),
138
+ });
139
+ export const contextResolutionSchema = z.object({
140
+ mode: z.enum(["linked", "preferred", "suggested", "none"]),
141
+ sessionId: z.string().nullable(),
142
+ cwd: z.string().nullable(),
143
+ confirmationRequired: z.boolean(),
144
+ recommendedAction: z.enum([
145
+ "use-linked",
146
+ "use-preferred",
147
+ "confirm-existing",
148
+ "create-new-context",
149
+ "choose-candidate",
150
+ "none",
151
+ ]),
152
+ linkedContextId: z.string().nullable(),
153
+ currentContext: contextListItemSchema.nullable(),
154
+ briefing: contextReportSchema.nullable(),
155
+ candidates: z.array(contextCandidateSchema),
156
+ });
157
+ export const contextMutationSchema = z.object({
158
+ action: z.enum([
159
+ "confirmed",
160
+ "rejected",
161
+ "moved",
162
+ "merged",
163
+ "split",
164
+ "preferred",
165
+ ]),
166
+ context: contextListItemSchema.nullable(),
167
+ affectedSessionIds: z.array(z.string()),
168
+ contextId: z.string().nullable(),
169
+ mergedFromContextId: z.string().nullable(),
170
+ });
171
+ //# sourceMappingURL=context-schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-schemas.js","sourceRoot":"","sources":["../../../src/tools/context-schemas.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,111 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const exportSessionsSchema: {
4
+ inputSchema: {
5
+ sessionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
6
+ query: z.ZodOptional<z.ZodString>;
7
+ issueKey: z.ZodOptional<z.ZodString>;
8
+ host: z.ZodOptional<z.ZodEnum<{
9
+ claude: "claude";
10
+ gemini: "gemini";
11
+ codex: "codex";
12
+ }>>;
13
+ status: z.ZodOptional<z.ZodEnum<{
14
+ running: "running";
15
+ completed: "completed";
16
+ failed: "failed";
17
+ interrupted: "interrupted";
18
+ }>>;
19
+ groupBy: z.ZodOptional<z.ZodEnum<{
20
+ issue: "issue";
21
+ family: "family";
22
+ }>>;
23
+ outputMode: z.ZodDefault<z.ZodEnum<{
24
+ base64: "base64";
25
+ file: "file";
26
+ both: "both";
27
+ }>>;
28
+ };
29
+ outputSchema: {
30
+ filename: z.ZodOptional<z.ZodString>;
31
+ base64Data: z.ZodOptional<z.ZodString>;
32
+ checksum: z.ZodString;
33
+ sessionCount: z.ZodNumber;
34
+ historyGrouping: z.ZodEnum<{
35
+ issue: "issue";
36
+ family: "family";
37
+ }>;
38
+ filters: z.ZodOptional<z.ZodObject<{
39
+ query: z.ZodOptional<z.ZodString>;
40
+ issueKey: z.ZodOptional<z.ZodString>;
41
+ host: z.ZodOptional<z.ZodEnum<{
42
+ claude: "claude";
43
+ gemini: "gemini";
44
+ codex: "codex";
45
+ }>>;
46
+ status: z.ZodOptional<z.ZodEnum<{
47
+ running: "running";
48
+ completed: "completed";
49
+ failed: "failed";
50
+ interrupted: "interrupted";
51
+ }>>;
52
+ groupBy: z.ZodOptional<z.ZodEnum<{
53
+ issue: "issue";
54
+ family: "family";
55
+ }>>;
56
+ }, z.core.$strip>>;
57
+ sessions: z.ZodArray<z.ZodObject<{
58
+ id: z.ZodString;
59
+ host: z.ZodEnum<{
60
+ claude: "claude";
61
+ gemini: "gemini";
62
+ codex: "codex";
63
+ }>;
64
+ label: z.ZodString;
65
+ status: z.ZodEnum<{
66
+ running: "running";
67
+ completed: "completed";
68
+ failed: "failed";
69
+ interrupted: "interrupted";
70
+ }>;
71
+ startedAt: z.ZodString;
72
+ endedAt: z.ZodNullable<z.ZodString>;
73
+ }, z.core.$strip>>;
74
+ success: z.ZodBoolean;
75
+ };
76
+ };
77
+ export declare const exportSessionsMetadata: {
78
+ _meta: {
79
+ readonly ui: {
80
+ readonly resourceUri: "ui://footprint/session-detail.html";
81
+ };
82
+ };
83
+ title: string;
84
+ description: string;
85
+ };
86
+ export declare function createExportSessionsHandler(db: EvidenceDatabase): (params: {
87
+ sessionIds?: string[];
88
+ query?: string;
89
+ issueKey?: string;
90
+ host?: "claude" | "gemini" | "codex";
91
+ status?: "running" | "completed" | "failed" | "interrupted";
92
+ groupBy?: "issue" | "family";
93
+ outputMode?: "file" | "base64" | "both";
94
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<{
95
+ sessions: {
96
+ id: string;
97
+ host: import("../lib/storage/types.js").SessionRecord["host"];
98
+ label: string;
99
+ status: import("../lib/storage/types.js").SessionRecord["status"];
100
+ startedAt: string;
101
+ endedAt: string | null;
102
+ }[];
103
+ success: boolean;
104
+ filters?: import("../lib/storage/export-sessions.js").SessionExportFilters | undefined;
105
+ checksum: string;
106
+ sessionCount: number;
107
+ historyGrouping: import("../lib/session-trends.js").HistoryTrendGroupBy;
108
+ base64Data?: string | undefined;
109
+ filename?: string | undefined;
110
+ }>>;
111
+ //# sourceMappingURL=export-sessions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-sessions.d.ts","sourceRoot":"","sources":["../../../src/tools/export-sessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAahE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEhC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;CAKlC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,gBAAgB;iBAK7C,MAAM,EAAE;YACb,MAAM;eACH,MAAM;WACV,QAAQ,GAAG,QAAQ,GAAG,OAAO;aAC3B,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa;cACjD,OAAO,GAAG,QAAQ;iBACf,MAAM,GAAG,QAAQ,GAAG,MAAM;;;;;;;;;;;;;;;;;IAqF5C"}
@@ -0,0 +1,136 @@
1
+ import { Buffer } from "node:buffer";
2
+ import * as z from "zod";
3
+ import { formatSuccessResponse } from "../lib/tool-response.js";
4
+ import { wrapToolHandler } from "../lib/tool-wrapper.js";
5
+ import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
6
+ const outputModeEnum = z.enum(["file", "base64", "both"]);
7
+ const sessionHostEnum = z.enum(["claude", "gemini", "codex"]);
8
+ const sessionStatusEnum = z.enum([
9
+ "running",
10
+ "completed",
11
+ "failed",
12
+ "interrupted",
13
+ ]);
14
+ const trendGroupByEnum = z.enum(["issue", "family"]);
15
+ export const exportSessionsSchema = {
16
+ inputSchema: {
17
+ sessionIds: z
18
+ .array(z.string())
19
+ .optional()
20
+ .describe("Specific session IDs to export. If omitted, exports all recorded sessions."),
21
+ query: z
22
+ .string()
23
+ .optional()
24
+ .describe("Optional text filter across metadata, transcript, and derived history. Cannot be combined with sessionIds."),
25
+ issueKey: z
26
+ .string()
27
+ .optional()
28
+ .describe("Optional exact issue key filter. Cannot be combined with sessionIds."),
29
+ host: sessionHostEnum
30
+ .optional()
31
+ .describe("Optional host filter. Cannot be combined with sessionIds."),
32
+ status: sessionStatusEnum
33
+ .optional()
34
+ .describe("Optional status filter. Cannot be combined with sessionIds."),
35
+ groupBy: trendGroupByEnum
36
+ .optional()
37
+ .describe("Optional history summary grouping. Controls whether exported cross-session summaries are grouped by exact issue keys or broader failure families."),
38
+ outputMode: outputModeEnum
39
+ .default("both")
40
+ .describe("Output mode: 'file' writes ZIP to disk, 'base64' returns ZIP as base64 string, 'both' does both."),
41
+ },
42
+ outputSchema: {
43
+ filename: z.string().optional(),
44
+ base64Data: z.string().optional(),
45
+ checksum: z.string(),
46
+ sessionCount: z.number(),
47
+ historyGrouping: trendGroupByEnum,
48
+ filters: z
49
+ .object({
50
+ query: z.string().optional(),
51
+ issueKey: z.string().optional(),
52
+ host: sessionHostEnum.optional(),
53
+ status: sessionStatusEnum.optional(),
54
+ groupBy: trendGroupByEnum.optional(),
55
+ })
56
+ .optional(),
57
+ sessions: z.array(z.object({
58
+ id: z.string(),
59
+ host: sessionHostEnum,
60
+ label: z.string(),
61
+ status: sessionStatusEnum,
62
+ startedAt: z.string(),
63
+ endedAt: z.string().nullable(),
64
+ })),
65
+ success: z.boolean(),
66
+ },
67
+ };
68
+ export const exportSessionsMetadata = {
69
+ title: "Export Sessions",
70
+ description: "Export recorded CLI sessions to a ZIP archive with raw transcript, timeline, derived artifacts, narratives, decisions, and top-level history summaries.",
71
+ ...sessionDetailUiMetadata,
72
+ };
73
+ export function createExportSessionsHandler(db) {
74
+ 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) => {
75
+ const { exportSessions } = await import("../lib/storage/index.js");
76
+ const fs = await import("fs");
77
+ const os = await import("os");
78
+ const path = await import("path");
79
+ const outputMode = params.outputMode || "both";
80
+ const result = await exportSessions(db, {
81
+ sessionIds: params.sessionIds,
82
+ query: params.query,
83
+ issueKey: params.issueKey,
84
+ host: params.host,
85
+ status: params.status,
86
+ groupBy: params.groupBy,
87
+ });
88
+ const maxBase64Size = 75 * 1024 * 1024;
89
+ if ((outputMode === "base64" || outputMode === "both") &&
90
+ result.zipData.length > maxBase64Size) {
91
+ throw new Error(`Export too large for base64 mode (${(result.zipData.length / (1024 * 1024)).toFixed(1)}MB). Use outputMode="file" or export fewer sessions.`);
92
+ }
93
+ let filename;
94
+ let base64Data;
95
+ if (outputMode === "file" || outputMode === "both") {
96
+ const outputDir = process.env.FOOTPRINT_DATA_DIR ||
97
+ process.env.FOOTPRINT_EXPORT_DIR ||
98
+ os.tmpdir();
99
+ const outputPath = path.join(outputDir, result.filename);
100
+ fs.writeFileSync(outputPath, result.zipData);
101
+ filename = outputPath;
102
+ }
103
+ if (outputMode === "base64" || outputMode === "both") {
104
+ base64Data = Buffer.from(result.zipData).toString("base64");
105
+ }
106
+ const details = {
107
+ Sessions: result.sessionCount,
108
+ Checksum: result.checksum,
109
+ "Output Mode": outputMode,
110
+ };
111
+ if (filename) {
112
+ details.Filename = filename;
113
+ }
114
+ if (base64Data) {
115
+ details["Base64 Size"] = `${Math.round(base64Data.length / 1024)}KB`;
116
+ }
117
+ if (result.filters) {
118
+ details.Query = result.filters.query ?? "all";
119
+ details.Issue = result.filters.issueKey ?? "all";
120
+ details.Host = result.filters.host ?? "all";
121
+ details.Status = result.filters.status ?? "all";
122
+ }
123
+ details["History Grouping"] = result.historyGrouping;
124
+ return formatSuccessResponse("Session export completed successfully", details, {
125
+ ...(filename && { filename }),
126
+ ...(base64Data && { base64Data }),
127
+ checksum: result.checksum,
128
+ sessionCount: result.sessionCount,
129
+ historyGrouping: result.historyGrouping,
130
+ ...(result.filters ? { filters: result.filters } : {}),
131
+ sessions: result.sessions,
132
+ success: true,
133
+ });
134
+ });
135
+ }
136
+ //# sourceMappingURL=export-sessions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-sessions.js","sourceRoot":"","sources":["../../../src/tools/export-sessions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,208 @@
1
+ import * as z from "zod";
2
+ import type { EvidenceDatabase } from "../lib/storage/index.js";
3
+ export declare const getContextSchema: {
4
+ inputSchema: {
5
+ id: z.ZodString;
6
+ };
7
+ outputSchema: {
8
+ context: z.ZodObject<{
9
+ id: z.ZodString;
10
+ label: z.ZodString;
11
+ workspaceKey: z.ZodString;
12
+ latestSessionId: z.ZodString;
13
+ latestSessionLabel: z.ZodString;
14
+ latestStartedAt: z.ZodString;
15
+ latestEndedAt: z.ZodNullable<z.ZodString>;
16
+ sessionCount: z.ZodNumber;
17
+ hosts: z.ZodArray<z.ZodEnum<{
18
+ claude: "claude";
19
+ gemini: "gemini";
20
+ codex: "codex";
21
+ }>>;
22
+ statuses: z.ZodArray<z.ZodEnum<{
23
+ running: "running";
24
+ completed: "completed";
25
+ failed: "failed";
26
+ interrupted: "interrupted";
27
+ }>>;
28
+ confidence: z.ZodEnum<{
29
+ high: "high";
30
+ medium: "medium";
31
+ low: "low";
32
+ }>;
33
+ confidenceScore: z.ZodNumber;
34
+ signals: z.ZodArray<z.ZodString>;
35
+ }, z.core.$strip>;
36
+ currentTruth: z.ZodObject<{
37
+ summary: z.ZodString;
38
+ latestSessionId: z.ZodString;
39
+ latestSessionLabel: z.ZodString;
40
+ latestSummaryNarrative: z.ZodNullable<z.ZodString>;
41
+ latestHandoff: z.ZodNullable<z.ZodString>;
42
+ activeBlockers: z.ZodArray<z.ZodString>;
43
+ openQuestions: z.ZodArray<z.ZodString>;
44
+ }, z.core.$strip>;
45
+ activeDecisions: z.ZodArray<z.ZodObject<{
46
+ decisionId: z.ZodString;
47
+ topic: z.ZodString;
48
+ sessionId: z.ZodString;
49
+ sessionLabel: z.ZodString;
50
+ title: z.ZodString;
51
+ summary: z.ZodString;
52
+ rationale: z.ZodNullable<z.ZodString>;
53
+ status: z.ZodEnum<{
54
+ proposed: "proposed";
55
+ accepted: "accepted";
56
+ rejected: "rejected";
57
+ open: "open";
58
+ }>;
59
+ createdAt: z.ZodString;
60
+ }, z.core.$strip>>;
61
+ supersededDecisions: z.ZodArray<z.ZodObject<{
62
+ decisionId: z.ZodString;
63
+ topic: z.ZodString;
64
+ sessionId: z.ZodString;
65
+ sessionLabel: z.ZodString;
66
+ title: z.ZodString;
67
+ summary: z.ZodString;
68
+ rationale: z.ZodNullable<z.ZodString>;
69
+ status: z.ZodEnum<{
70
+ proposed: "proposed";
71
+ accepted: "accepted";
72
+ rejected: "rejected";
73
+ open: "open";
74
+ }>;
75
+ createdAt: z.ZodString;
76
+ supersededByDecisionId: z.ZodNullable<z.ZodString>;
77
+ supersededByTitle: z.ZodNullable<z.ZodString>;
78
+ }, z.core.$strip>>;
79
+ changeLog: z.ZodArray<z.ZodObject<{
80
+ kind: z.ZodEnum<{
81
+ "decision-updated": "decision-updated";
82
+ "context-refreshed": "context-refreshed";
83
+ }>;
84
+ summary: z.ZodString;
85
+ sessionId: z.ZodNullable<z.ZodString>;
86
+ sessionLabel: z.ZodNullable<z.ZodString>;
87
+ createdAt: z.ZodNullable<z.ZodString>;
88
+ }, z.core.$strip>>;
89
+ sessions: z.ZodArray<z.ZodObject<{
90
+ id: z.ZodString;
91
+ label: z.ZodString;
92
+ host: z.ZodEnum<{
93
+ claude: "claude";
94
+ gemini: "gemini";
95
+ codex: "codex";
96
+ }>;
97
+ status: z.ZodEnum<{
98
+ running: "running";
99
+ completed: "completed";
100
+ failed: "failed";
101
+ interrupted: "interrupted";
102
+ }>;
103
+ startedAt: z.ZodString;
104
+ endedAt: z.ZodNullable<z.ZodString>;
105
+ }, z.core.$strip>>;
106
+ trends: z.ZodArray<z.ZodObject<{
107
+ groupBy: z.ZodEnum<{
108
+ issue: "issue";
109
+ family: "family";
110
+ }>;
111
+ issueKey: z.ZodString;
112
+ label: z.ZodString;
113
+ kind: z.ZodNullable<z.ZodString>;
114
+ relatedIssueKeys: z.ZodArray<z.ZodString>;
115
+ blockerCategory: z.ZodString;
116
+ blockerState: z.ZodEnum<{
117
+ active: "active";
118
+ resolved: "resolved";
119
+ }>;
120
+ remediationState: z.ZodEnum<{
121
+ unresolved: "unresolved";
122
+ recovered: "recovered";
123
+ regressed: "regressed";
124
+ stable: "stable";
125
+ }>;
126
+ remediationSummary: z.ZodString;
127
+ latestOutcome: z.ZodString;
128
+ latestFailureAt: z.ZodNullable<z.ZodString>;
129
+ latestSuccessAt: z.ZodNullable<z.ZodString>;
130
+ lastSeenAt: z.ZodString;
131
+ attemptCount: z.ZodNumber;
132
+ sessionCount: z.ZodNumber;
133
+ failedAttempts: z.ZodNumber;
134
+ succeededAttempts: z.ZodNumber;
135
+ otherAttempts: z.ZodNumber;
136
+ hosts: z.ZodArray<z.ZodEnum<{
137
+ claude: "claude";
138
+ gemini: "gemini";
139
+ codex: "codex";
140
+ }>>;
141
+ statuses: z.ZodArray<z.ZodEnum<{
142
+ running: "running";
143
+ completed: "completed";
144
+ failed: "failed";
145
+ interrupted: "interrupted";
146
+ }>>;
147
+ sessions: z.ZodArray<z.ZodObject<{
148
+ sessionId: z.ZodString;
149
+ label: z.ZodString;
150
+ host: z.ZodEnum<{
151
+ claude: "claude";
152
+ gemini: "gemini";
153
+ codex: "codex";
154
+ }>;
155
+ status: z.ZodEnum<{
156
+ running: "running";
157
+ completed: "completed";
158
+ failed: "failed";
159
+ interrupted: "interrupted";
160
+ }>;
161
+ startedAt: z.ZodString;
162
+ lastAttemptAt: z.ZodString;
163
+ attempts: z.ZodNumber;
164
+ latestOutcome: z.ZodString;
165
+ }, z.core.$strip>>;
166
+ }, z.core.$strip>>;
167
+ handoff: z.ZodObject<{
168
+ summary: z.ZodObject<{
169
+ groupBy: z.ZodEnum<{
170
+ issue: "issue";
171
+ family: "family";
172
+ }>;
173
+ headline: z.ZodString;
174
+ matchingSessions: z.ZodNumber;
175
+ matchingHosts: z.ZodArray<z.ZodEnum<{
176
+ claude: "claude";
177
+ gemini: "gemini";
178
+ codex: "codex";
179
+ }>>;
180
+ statuses: z.ZodArray<z.ZodEnum<{
181
+ running: "running";
182
+ completed: "completed";
183
+ failed: "failed";
184
+ interrupted: "interrupted";
185
+ }>>;
186
+ totalTrends: z.ZodNumber;
187
+ blockingTrends: z.ZodNumber;
188
+ recoveredTrends: z.ZodNumber;
189
+ regressedTrends: z.ZodNumber;
190
+ unresolvedQuestions: z.ZodNumber;
191
+ latestSessionId: z.ZodNullable<z.ZodString>;
192
+ latestSessionLabel: z.ZodNullable<z.ZodString>;
193
+ latestStartedAt: z.ZodNullable<z.ZodString>;
194
+ }, z.core.$strip>;
195
+ followUps: z.ZodArray<z.ZodString>;
196
+ blockers: z.ZodArray<z.ZodString>;
197
+ }, z.core.$strip>;
198
+ markdown: z.ZodString;
199
+ };
200
+ };
201
+ export declare const getContextMetadata: {
202
+ title: string;
203
+ description: string;
204
+ };
205
+ export declare function createGetContextHandler(db: EvidenceDatabase): (params: {
206
+ id: string;
207
+ }) => Promise<import("../lib/tool-response.js").ToolResponse<import("../lib/context-memory.js").ContextReport>>;
208
+ //# sourceMappingURL=get-context.d.ts.map
@@ -0,0 +1 @@
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"}