@picassohq/cli 0.0.0-stage → 1.0.1

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 (230) hide show
  1. package/agents/browser_agent.yaml +53 -0
  2. package/agents/code_reviewer.yaml +49 -0
  3. package/agents/codebase_investigator.yaml +70 -0
  4. package/agents/design_auditor.yaml +50 -0
  5. package/agents/devex_auditor.yaml +50 -0
  6. package/agents/doc_writer.yaml +54 -0
  7. package/agents/engineering_architect.yaml +51 -0
  8. package/agents/generalist.yaml +55 -0
  9. package/agents/migration_planner.yaml +51 -0
  10. package/agents/product_reviewer.yaml +48 -0
  11. package/agents/qa_operator.yaml +52 -0
  12. package/agents/release_engineer.yaml +50 -0
  13. package/agents/security_auditor.yaml +62 -0
  14. package/agents/test_writer.yaml +52 -0
  15. package/assets/first-light-lockup.png +0 -0
  16. package/assets/first-light-tagline.png +0 -0
  17. package/assets/house/README.md +26 -0
  18. package/assets/house/auraone-banner.png +0 -0
  19. package/assets/house/auraone-logo.png +0 -0
  20. package/assets/house/kiro-prism-banner.png +0 -0
  21. package/assets/house/kiro-prism-logo.png +0 -0
  22. package/assets/house/picasso-banner.png +0 -0
  23. package/assets/house/picasso-logo.png +0 -0
  24. package/assets/wordmark-app.png +0 -0
  25. package/assets/wordmark-tight.png +0 -0
  26. package/assets/wordmark.png +0 -0
  27. package/design/styles.css +1042 -0
  28. package/dist/build-info.json +37 -0
  29. package/dist/index.js +3028 -0
  30. package/goals/cli-hardening.yaml +40 -0
  31. package/goals/repo-maintenance.yaml +40 -0
  32. package/package.json +49 -4
  33. package/runtime/dsh/picasso-ecosystem.community.amendments.yml +24 -0
  34. package/runtime/dsh/picasso-ecosystem.community.json +185 -0
  35. package/runtime/dsh/picasso-ecosystem.community.patch.yml +40 -0
  36. package/runtime/dsh/picasso-ecosystem.cordis.patch.yml +143 -0
  37. package/runtime/dsh/picasso-isolation.patch.yml +25 -0
  38. package/runtime/dsh/picasso-providers.patch.yml +373 -0
  39. package/runtime/dsh/picasso-runtime.cordis.yml +738 -0
  40. package/runtime/dsh/picasso-sdk.patch.yml +204 -0
  41. package/runtime/engine-manifest.json +214 -0
  42. package/runtime/package.json +6 -0
  43. package/runtime/packages/picasso-cache-probe/cordis.patch.yml +5 -0
  44. package/runtime/packages/picasso-cache-probe/index.js +477 -0
  45. package/runtime/packages/picasso-cache-probe/package.json +38 -0
  46. package/runtime/packages/picasso-commands/cordis.patch.yml +4 -0
  47. package/runtime/packages/picasso-commands/fresh-review.js +573 -0
  48. package/runtime/packages/picasso-commands/index.js +497 -0
  49. package/runtime/packages/picasso-commands/package.json +28 -0
  50. package/runtime/packages/picasso-instructions/conflicts.js +115 -0
  51. package/runtime/packages/picasso-instructions/formats.js +145 -0
  52. package/runtime/packages/picasso-instructions/frontmatter.js +175 -0
  53. package/runtime/packages/picasso-instructions/glob.js +114 -0
  54. package/runtime/packages/picasso-instructions/globals.js +90 -0
  55. package/runtime/packages/picasso-instructions/imports.js +123 -0
  56. package/runtime/packages/picasso-instructions/index.js +326 -0
  57. package/runtime/packages/picasso-instructions/modes.js +64 -0
  58. package/runtime/packages/picasso-instructions/package.json +30 -0
  59. package/runtime/packages/picasso-instructions/parse.js +134 -0
  60. package/runtime/packages/picasso-instructions/report.js +161 -0
  61. package/runtime/packages/picasso-instructions/resolve.js +939 -0
  62. package/runtime/packages/picasso-instructions/scan.js +181 -0
  63. package/runtime/packages/picasso-instructions/settings.js +150 -0
  64. package/runtime/packages/picasso-instructions/skills.js +345 -0
  65. package/runtime/packages/picasso-lean-context/cordis.patch.yml +13 -0
  66. package/runtime/packages/picasso-lean-context/index.js +6049 -0
  67. package/runtime/packages/picasso-lean-context/package.json +26 -0
  68. package/runtime/packages/picasso-lean-context/timeline.js +417 -0
  69. package/runtime/packages/picasso-librarian/classify.js +146 -0
  70. package/runtime/packages/picasso-librarian/cordis.patch.yml +10 -0
  71. package/runtime/packages/picasso-librarian/index.js +878 -0
  72. package/runtime/packages/picasso-librarian/notes.js +159 -0
  73. package/runtime/packages/picasso-librarian/package.json +34 -0
  74. package/runtime/packages/picasso-librarian/state.js +478 -0
  75. package/runtime/packages/picasso-memory/index.js +1184 -0
  76. package/runtime/packages/picasso-memory/package.json +21 -0
  77. package/runtime/packages/picasso-model-router/connections.js +895 -0
  78. package/runtime/packages/picasso-model-router/cordis.patch.yml +17 -0
  79. package/runtime/packages/picasso-model-router/index.js +1081 -0
  80. package/runtime/packages/picasso-model-router/package.json +30 -0
  81. package/runtime/packages/picasso-options/cordis.patch.yml +4 -0
  82. package/runtime/packages/picasso-options/index.js +263 -0
  83. package/runtime/packages/picasso-options/package.json +28 -0
  84. package/runtime/packages/picasso-progress-reports/cordis.patch.yml +10 -0
  85. package/runtime/packages/picasso-progress-reports/index.js +267 -0
  86. package/runtime/packages/picasso-progress-reports/package.json +30 -0
  87. package/runtime/packages/picasso-progress-reports/report.js +235 -0
  88. package/runtime/packages/picasso-sdk-server/aside.js +128 -0
  89. package/runtime/packages/picasso-sdk-server/connections.js +38 -0
  90. package/runtime/packages/picasso-sdk-server/context-timeline.js +27 -0
  91. package/runtime/packages/picasso-sdk-server/egress-gate.js +520 -0
  92. package/runtime/packages/picasso-sdk-server/failure-policy.js +246 -0
  93. package/runtime/packages/picasso-sdk-server/file-input.js +169 -0
  94. package/runtime/packages/picasso-sdk-server/goal.js +131 -0
  95. package/runtime/packages/picasso-sdk-server/ignore-file.js +458 -0
  96. package/runtime/packages/picasso-sdk-server/ignore-plugin.js +12 -0
  97. package/runtime/packages/picasso-sdk-server/ignore-sandbox.js +122 -0
  98. package/runtime/packages/picasso-sdk-server/ignore-snapshot.js +131 -0
  99. package/runtime/packages/picasso-sdk-server/image-input.js +44 -0
  100. package/runtime/packages/picasso-sdk-server/index.js +886 -0
  101. package/runtime/packages/picasso-sdk-server/instructions.js +34 -0
  102. package/runtime/packages/picasso-sdk-server/jobs.js +113 -0
  103. package/runtime/packages/picasso-sdk-server/mcp-gate.js +51 -0
  104. package/runtime/packages/picasso-sdk-server/model-selection.js +162 -0
  105. package/runtime/packages/picasso-sdk-server/package.json +50 -0
  106. package/runtime/packages/picasso-sdk-server/picasso-records.js +50 -0
  107. package/runtime/packages/picasso-sdk-server/provider-reload.js +84 -0
  108. package/runtime/packages/picasso-sdk-server/queue.js +322 -0
  109. package/runtime/packages/picasso-sdk-server/requester.js +43 -0
  110. package/runtime/packages/picasso-sdk-server/rewind.js +108 -0
  111. package/runtime/packages/picasso-sdk-server/schedule.js +187 -0
  112. package/runtime/packages/picasso-sdk-server/session-grants.js +35 -0
  113. package/runtime/packages/picasso-sdk-server/session-state.js +118 -0
  114. package/runtime/packages/picasso-sdk-server/shell-paths.js +869 -0
  115. package/runtime/packages/picasso-sdk-server/stream-deltas.js +211 -0
  116. package/runtime/packages/picasso-sdk-server/team-tasks.js +451 -0
  117. package/runtime/packages/picasso-sdk-server/tool-output.js +128 -0
  118. package/runtime/packages/picasso-sdk-server/tools-list.js +51 -0
  119. package/runtime/packages/picasso-sdk-server/wave2-hooks.js +612 -0
  120. package/runtime/packages/picasso-sdk-server/workspace-archive.js +170 -0
  121. package/runtime/packages/picasso-sdk-server/workspace-restore.js +180 -0
  122. package/runtime/packages/picasso-web-search/backends.js +350 -0
  123. package/runtime/packages/picasso-web-search/config.js +121 -0
  124. package/runtime/packages/picasso-web-search/cordis.patch.yml +7 -0
  125. package/runtime/packages/picasso-web-search/failure.js +111 -0
  126. package/runtime/packages/picasso-web-search/format.js +35 -0
  127. package/runtime/packages/picasso-web-search/index.js +66 -0
  128. package/runtime/packages/picasso-web-search/package.json +38 -0
  129. package/runtime/packages/picasso-web-search/router.js +155 -0
  130. package/runtime/packages/picasso-x-reader/circle.js +324 -0
  131. package/runtime/packages/picasso-x-reader/command.js +169 -0
  132. package/runtime/packages/picasso-x-reader/cordis.patch.yml +8 -0
  133. package/runtime/packages/picasso-x-reader/index.js +170 -0
  134. package/runtime/packages/picasso-x-reader/package.json +39 -0
  135. package/runtime/packages/picasso-x-reader/read.js +370 -0
  136. package/runtime/packages/picasso-x-reader/rewrite.js +38 -0
  137. package/runtime/packages/picasso-x-reader/settings.js +131 -0
  138. package/runtime/packages/picasso-x-reader/urls.js +154 -0
  139. package/runtime/packages/picasso-x-reader/xmd.js +512 -0
  140. package/runtime/plugins/picasso-auth-bridge/index.js +380 -0
  141. package/runtime/plugins/picasso-auth-bridge/package.json +28 -0
  142. package/runtime/plugins/picasso-auto-approve/index.js +1003 -0
  143. package/runtime/plugins/picasso-auto-approve/package.json +28 -0
  144. package/runtime/plugins/picasso-browser/index.js +424 -0
  145. package/runtime/plugins/picasso-browser/package.json +28 -0
  146. package/runtime/plugins/picasso-checkpoints/evidence.js +210 -0
  147. package/runtime/plugins/picasso-checkpoints/index.js +885 -0
  148. package/runtime/plugins/picasso-checkpoints/package.json +29 -0
  149. package/runtime/plugins/picasso-commands/fresh-review.js +573 -0
  150. package/runtime/plugins/picasso-commands/index.js +497 -0
  151. package/runtime/plugins/picasso-commands/package.json +28 -0
  152. package/runtime/plugins/picasso-instructions/conflicts.js +115 -0
  153. package/runtime/plugins/picasso-instructions/formats.js +145 -0
  154. package/runtime/plugins/picasso-instructions/frontmatter.js +175 -0
  155. package/runtime/plugins/picasso-instructions/glob.js +114 -0
  156. package/runtime/plugins/picasso-instructions/globals.js +90 -0
  157. package/runtime/plugins/picasso-instructions/imports.js +123 -0
  158. package/runtime/plugins/picasso-instructions/index.js +326 -0
  159. package/runtime/plugins/picasso-instructions/modes.js +64 -0
  160. package/runtime/plugins/picasso-instructions/package.json +30 -0
  161. package/runtime/plugins/picasso-instructions/parse.js +134 -0
  162. package/runtime/plugins/picasso-instructions/report.js +161 -0
  163. package/runtime/plugins/picasso-instructions/resolve.js +939 -0
  164. package/runtime/plugins/picasso-instructions/scan.js +181 -0
  165. package/runtime/plugins/picasso-instructions/settings.js +150 -0
  166. package/runtime/plugins/picasso-instructions/skills.js +345 -0
  167. package/runtime/plugins/picasso-lean-context/index.js +6049 -0
  168. package/runtime/plugins/picasso-lean-context/package.json +26 -0
  169. package/runtime/plugins/picasso-lean-context/timeline.js +417 -0
  170. package/runtime/plugins/picasso-librarian/classify.js +146 -0
  171. package/runtime/plugins/picasso-librarian/index.js +878 -0
  172. package/runtime/plugins/picasso-librarian/notes.js +159 -0
  173. package/runtime/plugins/picasso-librarian/package.json +34 -0
  174. package/runtime/plugins/picasso-librarian/state.js +478 -0
  175. package/runtime/plugins/picasso-lifecycle-hooks/index.js +186 -0
  176. package/runtime/plugins/picasso-lifecycle-hooks/package.json +25 -0
  177. package/runtime/plugins/picasso-mail/inbox.js +207 -0
  178. package/runtime/plugins/picasso-mail/index.js +293 -0
  179. package/runtime/plugins/picasso-mail/package.json +22 -0
  180. package/runtime/plugins/picasso-memory/index.js +1184 -0
  181. package/runtime/plugins/picasso-memory/package.json +21 -0
  182. package/runtime/plugins/picasso-model-router/connections.js +895 -0
  183. package/runtime/plugins/picasso-model-router/index.js +1081 -0
  184. package/runtime/plugins/picasso-model-router/package.json +30 -0
  185. package/runtime/plugins/picasso-options/index.js +263 -0
  186. package/runtime/plugins/picasso-options/package.json +28 -0
  187. package/runtime/plugins/picasso-progress-reports/index.js +267 -0
  188. package/runtime/plugins/picasso-progress-reports/package.json +30 -0
  189. package/runtime/plugins/picasso-progress-reports/report.js +235 -0
  190. package/runtime/plugins/picasso-provider-models/index.js +436 -0
  191. package/runtime/plugins/picasso-provider-models/package.json +28 -0
  192. package/runtime/plugins/picasso-repo-index/index.js +1850 -0
  193. package/runtime/plugins/picasso-repo-index/package.json +28 -0
  194. package/runtime/plugins/picasso-schedule-pause/index.js +344 -0
  195. package/runtime/plugins/picasso-schedule-pause/package.json +28 -0
  196. package/runtime/plugins/picasso-session-lifecycle/index.js +796 -0
  197. package/runtime/plugins/picasso-session-lifecycle/package.json +28 -0
  198. package/runtime/plugins/picasso-trackers/index.js +895 -0
  199. package/runtime/plugins/picasso-trackers/package.json +28 -0
  200. package/runtime/plugins/picasso-web-search/backends.js +350 -0
  201. package/runtime/plugins/picasso-web-search/config.js +121 -0
  202. package/runtime/plugins/picasso-web-search/failure.js +111 -0
  203. package/runtime/plugins/picasso-web-search/format.js +35 -0
  204. package/runtime/plugins/picasso-web-search/index.js +66 -0
  205. package/runtime/plugins/picasso-web-search/package.json +38 -0
  206. package/runtime/plugins/picasso-web-search/router.js +155 -0
  207. package/runtime/plugins/picasso-x-reader/circle.js +324 -0
  208. package/runtime/plugins/picasso-x-reader/command.js +169 -0
  209. package/runtime/plugins/picasso-x-reader/index.js +170 -0
  210. package/runtime/plugins/picasso-x-reader/package.json +39 -0
  211. package/runtime/plugins/picasso-x-reader/read.js +370 -0
  212. package/runtime/plugins/picasso-x-reader/rewrite.js +38 -0
  213. package/runtime/plugins/picasso-x-reader/settings.js +131 -0
  214. package/runtime/plugins/picasso-x-reader/urls.js +154 -0
  215. package/runtime/plugins/picasso-x-reader/xmd.js +512 -0
  216. package/runtime/relay/attachment-text.mjs +737 -0
  217. package/runtime/relay/companion/companion.css +126 -0
  218. package/runtime/relay/companion/companion.js +648 -0
  219. package/runtime/relay/companion/icon.svg +5 -0
  220. package/runtime/relay/companion/index.html +25 -0
  221. package/runtime/relay/companion/manifest.json +13 -0
  222. package/runtime/relay/companion/sw.js +41 -0
  223. package/runtime/relay/main.mjs +37252 -0
  224. package/runtime/relay/model-listing.mjs +614 -0
  225. package/runtime/relay/versions-routes.mjs +1198 -0
  226. package/runtime/verify-plugins.mjs +205 -0
  227. package/runtime-lock/package-lock.json +10779 -0
  228. package/runtime-lock/package.json +7 -0
  229. package/scripts/install-runtime.mjs +400 -0
  230. package/README.md +0 -3
@@ -0,0 +1,210 @@
1
+ // Read-only checkpoint evidence (ATD-P007).
2
+ //
3
+ // `collectEvidence` reports what the recorder already stored for a turn range: the private baseline/end snapshot
4
+ // references, changed paths, coverage mode, diff stats and — through the existing read-only `preview` — the current
5
+ // disk state. It never snapshots, restores, writes undo records or touches the user's work tree or index: git is
6
+ // only asked for `cat-file -e` and `diff-tree --numstat` against the plugin's private object store (the repo's
7
+ // objects as read-only alternates), and file captures are only stat'ed.
8
+ //
9
+ // Snapshot ids are private tree OIDs (git / non-git full) or content-addressed capture ids (files-only); they are
10
+ // never repository commits and are labelled `isRepositoryCommit: false`. Paths are project-relative; paths outside
11
+ // the project are withheld and counted. Research privacy filtering of paths/diffs before anything leaves the local
12
+ // process is the caller's job (the cache-harness research privacy policy).
13
+ import { existsSync } from 'node:fs';
14
+ import { stat } from 'node:fs/promises';
15
+ import { basename, isAbsolute, join, relative, sep } from 'node:path';
16
+
17
+ export const EVIDENCE_SCHEMA = 'picasso.checkpoint-evidence.v1';
18
+
19
+ /** Coverage per recorded entry kind. `files-only` is always partial: shell edits never reach the intent hooks. */
20
+ function coverageOf(entry, builtinExcludes) {
21
+ if (entry.kind === 'git') {
22
+ return { mode: 'git', partial: false, gaps: ['gitignored-paths-not-captured', 'submodule-contents-not-captured'], ignoredPolicy: { source: 'repository-gitignore' } };
23
+ }
24
+ if (entry.kind === 'full') {
25
+ return { mode: 'non-git-full', partial: false, gaps: ['gitignored-and-builtin-excluded-paths-not-captured'], ignoredPolicy: { source: 'workspace-gitignore+builtin-excludes', builtinExcludes: [...builtinExcludes] } };
26
+ }
27
+ const gaps = ['shell-edits-not-captured', 'only-intent-declared-paths-captured'];
28
+ if (entry.fellBackFrom === 'full') gaps.push('fell-back-from-full');
29
+ return { mode: 'files-only', partial: true, gaps, ignoredPolicy: { source: 'none' } };
30
+ }
31
+
32
+ /** Project-relative form of a recorded path; undefined when it lies outside the project root. */
33
+ function projectPath(path, projectRoot) {
34
+ if (!isAbsolute(path)) return path;
35
+ if (typeof projectRoot !== 'string') return undefined;
36
+ const rel = relative(projectRoot, path);
37
+ if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) return undefined;
38
+ return rel.split(sep).join('/');
39
+ }
40
+
41
+ function parseNumstat(stdout) {
42
+ const fields = stdout.split('\0');
43
+ const files = [];
44
+ for (let i = 0; i < fields.length; i += 1) {
45
+ const head = fields[i];
46
+ if (head === '') continue;
47
+ const match = /^(-|\d+)\t(-|\d+)\t(.*)$/s.exec(head);
48
+ if (!match) continue;
49
+ const binary = match[1] === '-' && match[2] === '-';
50
+ const stats = binary ? { binary: true } : { binary: false, added: Number(match[1]), deleted: Number(match[2]) };
51
+ if (match[3] === '') {
52
+ files.push({ path: fields[i + 2], oldPath: fields[i + 1], ...stats });
53
+ i += 2;
54
+ } else {
55
+ files.push({ path: match[3], ...stats });
56
+ }
57
+ }
58
+ return files;
59
+ }
60
+
61
+ /** Is a private snapshot tree still present? Reads only; `workspace-unavailable` when git cannot even be pointed at it. */
62
+ async function treeAvailability(service, entry, oid, gitRun, signal) {
63
+ if (typeof oid !== 'string' || oid === '') return { available: false, reason: 'not-recorded' };
64
+ if (typeof entry.repo !== 'string' || !existsSync(join(service.objectsRoot, entry.repo))) return { available: false, reason: 'pruned' };
65
+ let ws;
66
+ try {
67
+ ws = await service.gitWs(entry, signal);
68
+ } catch {
69
+ return { available: false, reason: 'workspace-unavailable' };
70
+ }
71
+ const result = await gitRun(service.subprocess, await service.gitBin(), ['cat-file', '-e', `${oid}^{tree}`], { cwd: ws.root, env: ws.env, signal }).catch(() => ({ exitCode: -1 }));
72
+ return result.exitCode === 0 ? { available: true, ws } : { available: false, reason: 'pruned' };
73
+ }
74
+
75
+ async function captureAvailable(capture) {
76
+ if (capture === undefined) return { available: false, reason: 'not-recorded' };
77
+ if (capture.absent === true) return { available: true, absent: true };
78
+ if (typeof capture.file !== 'string') return { available: false, reason: 'not-recorded' };
79
+ const size = await stat(capture.file).then((s) => s.size, () => undefined);
80
+ return size === undefined ? { available: false, reason: 'pruned' } : { available: true, id: basename(capture.file), bytes: size };
81
+ }
82
+
83
+ function snapshotRef(kind, id, availability) {
84
+ return {
85
+ refKind: kind,
86
+ ...(id === undefined ? {} : { id }),
87
+ isRepositoryCommit: false,
88
+ available: availability.available,
89
+ ...(availability.available ? {} : { reason: availability.reason }),
90
+ };
91
+ }
92
+
93
+ async function gitTurnEvidence(service, n, entry, coverage, gitRun, signal, missingRefs) {
94
+ const baseline = await treeAvailability(service, entry, entry.S, gitRun, signal);
95
+ const end = await treeAvailability(service, entry, entry.E, gitRun, signal);
96
+ for (const [which, a] of [['baseline', baseline], ['end', end]]) if (!a.available) missingRefs.push({ turn: n, which, reason: a.reason });
97
+ const changed = (entry.changed ?? []).map((c) => ({ path: c.path, status: c.status, ...(c.oldPath ? { oldPath: c.oldPath } : {}) }));
98
+ let diff = { available: false, reason: 'snapshot-missing' };
99
+ if (baseline.available && end.available) {
100
+ const out = entry.S === entry.E ? { exitCode: 0, stdout: '' }
101
+ : await gitRun(service.subprocess, await service.gitBin(), ['diff-tree', '-r', '-M', '-z', '--numstat', entry.S, entry.E], { cwd: baseline.ws.root, env: baseline.ws.env, signal });
102
+ diff = out.exitCode === 0 ? { available: true, files: parseNumstat(out.stdout) } : { available: false, reason: 'diff-failed' };
103
+ }
104
+ return {
105
+ turn: n,
106
+ coverage,
107
+ ...(typeof entry.repo === 'string' ? { workspaceKey: entry.repo } : {}),
108
+ baseline: snapshotRef('private-snapshot-tree', entry.S, baseline),
109
+ end: snapshotRef('private-snapshot-tree', entry.E, end),
110
+ changed,
111
+ diff,
112
+ pathsOutsideProject: 0,
113
+ };
114
+ }
115
+
116
+ async function filesTurnEvidence(n, entry, coverage, missingRefs) {
117
+ const changed = [];
118
+ const files = [];
119
+ let outside = 0;
120
+ let baselineOk = true;
121
+ let endOk = true;
122
+ for (const c of entry.changed ?? []) {
123
+ const path = projectPath(c.path, entry.cwd);
124
+ if (path === undefined) { outside += 1; continue; }
125
+ changed.push({ path, status: c.status });
126
+ const pair = entry.captures?.[c.path];
127
+ const before = await captureAvailable(pair?.before);
128
+ const after = await captureAvailable(pair?.after);
129
+ if (!before.available) { baselineOk = false; missingRefs.push({ turn: n, which: 'baseline', path, reason: before.reason }); }
130
+ if (!after.available) { endOk = false; missingRefs.push({ turn: n, which: 'end', path, reason: after.reason }); }
131
+ files.push({
132
+ path,
133
+ before: before.available ? (before.absent ? { absent: true } : { captureId: before.id, bytes: before.bytes }) : { available: false, reason: before.reason },
134
+ after: after.available ? (after.absent ? { absent: true } : { captureId: after.id, bytes: after.bytes }) : { available: false, reason: after.reason },
135
+ });
136
+ }
137
+ const set = (ok) => (ok ? { available: true } : { available: false, reason: 'pruned' });
138
+ return {
139
+ turn: n,
140
+ coverage,
141
+ baseline: snapshotRef('private-file-captures', undefined, set(baselineOk)),
142
+ end: snapshotRef('private-file-captures', undefined, set(endOk)),
143
+ changed,
144
+ diff: { available: baselineOk && endOk, ...(baselineOk && endOk ? {} : { reason: 'snapshot-missing' }), files },
145
+ pathsOutsideProject: outside,
146
+ };
147
+ }
148
+
149
+ /**
150
+ * Evidence for turns `fromTurn..throughTurn` (default: every later recorded turn) of `sessionId`.
151
+ * `status`: `missing` (no checkpoint for fromTurn), `partial` (files-only coverage, pruned refs, unrecorded turns
152
+ * or withheld paths) or `complete`.
153
+ */
154
+ export async function collectEvidence(service, sessionId, fromTurn, options, helpers) {
155
+ const { gitRun, builtinExcludes } = helpers;
156
+ const signal = options?.signal;
157
+ const meta = await service.readMeta(sessionId);
158
+ const recorded = Object.keys(meta.turns).map(Number).filter(Number.isInteger).sort((a, b) => a - b);
159
+ const last = recorded.length === 0 ? fromTurn : recorded[recorded.length - 1];
160
+ const throughTurn = Number.isInteger(options?.throughTurn) ? options.throughTurn : last;
161
+ const base = { schema: EVIDENCE_SCHEMA, sessionId, fromTurn, throughTurn, readOnly: true, privacyFiltered: false };
162
+ if (meta.turns[String(fromTurn)] === undefined) {
163
+ return { ...base, status: 'missing', reason: 'no-checkpoint', turns: [], changedPaths: [], missingRefs: [{ turn: fromTurn, which: 'baseline', reason: 'not-recorded' }], unrecordedTurns: [], coverage: { modes: [], partial: true, gaps: [] }, currentDisk: { available: false, reason: 'no-checkpoint' } };
164
+ }
165
+ const turns = [];
166
+ const missingRefs = [];
167
+ const unrecordedTurns = [];
168
+ for (let n = fromTurn; n <= throughTurn; n += 1) {
169
+ const entry = meta.turns[String(n)];
170
+ if (entry === undefined) {
171
+ if (recorded.some((k) => k > n)) unrecordedTurns.push(n);
172
+ continue;
173
+ }
174
+ const coverage = coverageOf(entry, builtinExcludes);
175
+ turns.push(entry.kind === 'git' || entry.kind === 'full'
176
+ ? await gitTurnEvidence(service, n, entry, coverage, gitRun, signal, missingRefs)
177
+ : await filesTurnEvidence(n, entry, coverage, missingRefs));
178
+ }
179
+ const changedPaths = [...new Set(turns.flatMap((t) => t.changed.map((c) => c.path)))].sort();
180
+ const modes = [...new Set(turns.map((t) => t.coverage.mode))];
181
+ const gaps = [...new Set(turns.flatMap((t) => t.coverage.gaps))];
182
+ const partialCoverage = turns.some((t) => t.coverage.partial);
183
+ const withheld = turns.reduce((sum, t) => sum + t.pathsOutsideProject, 0);
184
+
185
+ // Current disk state relative to the baseline, through the existing read-only preview. Only trusted when every
186
+ // reference it reads is still present; a pruned snapshot would otherwise misreport every path as added.
187
+ let currentDisk = { available: false, reason: 'snapshot-missing' };
188
+ if (missingRefs.length === 0) {
189
+ const startEntry = meta.turns[String(fromTurn)];
190
+ const preview = await service.preview(sessionId, fromTurn);
191
+ const rel = (p) => projectPath(p, startEntry.cwd);
192
+ currentDisk = {
193
+ available: true,
194
+ files: preview.files.map((f) => ({ ...f, path: rel(f.path) })).filter((f) => f.path !== undefined),
195
+ edited: preview.edited.map(rel).filter((p) => p !== undefined),
196
+ };
197
+ }
198
+ const status = missingRefs.length > 0 || unrecordedTurns.length > 0 || partialCoverage || withheld > 0 ? 'partial' : 'complete';
199
+ return {
200
+ ...base,
201
+ status,
202
+ turns,
203
+ changedPaths,
204
+ missingRefs,
205
+ unrecordedTurns,
206
+ pathsOutsideProject: withheld,
207
+ coverage: { modes, partial: partialCoverage, gaps },
208
+ currentDisk,
209
+ };
210
+ }