cocheck 0.0.0-stage → 0.4.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 (305) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +104 -2
  3. package/THIRD_PARTY_NOTICES.md +279 -0
  4. package/bin/cocheck.mjs +8 -0
  5. package/dist/agent-transcripts.js +541 -0
  6. package/dist/attribution/basis.js +31 -0
  7. package/dist/attribution/evidence.js +311 -0
  8. package/dist/attribution/hooks/cocheck-preload.cjs +254 -0
  9. package/dist/attribution/hooks/sitecustomize.py +245 -0
  10. package/dist/attribution/names.js +163 -0
  11. package/dist/attribution/reconstruct.js +128 -0
  12. package/dist/attribution/tag.js +246 -0
  13. package/dist/attribution/write-scope-win.js +615 -0
  14. package/dist/attribution/write-scope.js +1668 -0
  15. package/dist/build-info.json +1 -0
  16. package/dist/cli-main.js +8 -0
  17. package/dist/cli.js +193 -0
  18. package/dist/codex-config.js +107 -0
  19. package/dist/connector/after-gap.js +56 -0
  20. package/dist/connector/after-snapshot.js +244 -0
  21. package/dist/connector/before-snapshot.js +168 -0
  22. package/dist/connector/builtins.js +93 -0
  23. package/dist/connector/changes-v1.js +276 -0
  24. package/dist/connector/claimed-state.js +40 -0
  25. package/dist/connector/claimed.js +86 -0
  26. package/dist/connector/conformance.js +458 -0
  27. package/dist/connector/diff-object.js +81 -0
  28. package/dist/connector/diff-samples.js +64 -0
  29. package/dist/connector/diff.js +273 -0
  30. package/dist/connector/doc-level.js +20 -0
  31. package/dist/connector/enabled-types.js +87 -0
  32. package/dist/connector/export-view.js +13 -0
  33. package/dist/connector/file-capture.js +265 -0
  34. package/dist/connector/frozen.js +213 -0
  35. package/dist/connector/installed-manifests.js +72 -0
  36. package/dist/connector/installed-match.js +161 -0
  37. package/dist/connector/local-process.js +119 -0
  38. package/dist/connector/nothing-changed-rule.js +23 -0
  39. package/dist/connector/old-rows.js +66 -0
  40. package/dist/connector/png-pixels.js +4 -0
  41. package/dist/connector/registry.js +78 -0
  42. package/dist/connector/requires.js +30 -0
  43. package/dist/connector/row-doc.js +54 -0
  44. package/dist/connector/run-argv.js +25 -0
  45. package/dist/connector/runner.js +325 -0
  46. package/dist/connector/schema.js +242 -0
  47. package/dist/connector/subject.js +8 -0
  48. package/dist/connector/subjects.js +113 -0
  49. package/dist/connector/validate.js +200 -0
  50. package/dist/connector-auth.js +101 -0
  51. package/dist/connector-create.js +55 -0
  52. package/dist/connector-doctor.js +167 -0
  53. package/dist/connector-test-cli.js +627 -0
  54. package/dist/connector-types-cli.js +43 -0
  55. package/dist/connectors/microsoft-excel/cocheck-connector.json +13 -0
  56. package/dist/connectors/microsoft-excel/connector.mjs +11 -0
  57. package/dist/connectors/microsoft-powerpoint/cocheck-connector.json +13 -0
  58. package/dist/connectors/microsoft-powerpoint/connector.mjs +11 -0
  59. package/dist/connectors/microsoft-word/cocheck-connector.json +13 -0
  60. package/dist/connectors/microsoft-word/connector.mjs +11 -0
  61. package/dist/copies.js +151 -0
  62. package/dist/copilot-helpers.js +246 -0
  63. package/dist/coverage.js +277 -0
  64. package/dist/credit-guard.js +330 -0
  65. package/dist/display.js +78 -0
  66. package/dist/file-lock.js +145 -0
  67. package/dist/fingerprint.js +25 -0
  68. package/dist/formats/files/align.js +84 -0
  69. package/dist/formats/files/csv.js +78 -0
  70. package/dist/formats/files/layer.js +274 -0
  71. package/dist/formats/files/scan.js +86 -0
  72. package/dist/formats/files/textlike.js +21 -0
  73. package/dist/formats/layer.js +48 -0
  74. package/dist/helpers/pdfpages +0 -0
  75. package/dist/home-page.js +173 -0
  76. package/dist/home-perms.js +59 -0
  77. package/dist/hook-adapter.js +3415 -0
  78. package/dist/hook-cli.js +505 -0
  79. package/dist/hook-journal.js +147 -0
  80. package/dist/hook.js +25 -0
  81. package/dist/hosts/claude.js +250 -0
  82. package/dist/hosts/codex-bin-macos.js +2 -0
  83. package/dist/hosts/codex-bin.js +35 -0
  84. package/dist/hosts/codex-trust-probe.js +52 -0
  85. package/dist/hosts/codex-trust.js +46 -0
  86. package/dist/hosts/codex.js +355 -0
  87. package/dist/hosts/copilot.js +236 -0
  88. package/dist/hosts/index.js +52 -0
  89. package/dist/hosts/session-titles.js +327 -0
  90. package/dist/hosts/shared.js +31 -0
  91. package/dist/hosts/types.js +26 -0
  92. package/dist/html.js +4 -0
  93. package/dist/install.js +676 -0
  94. package/dist/items.js +105 -0
  95. package/dist/ledger.js +2097 -0
  96. package/dist/narration.js +202 -0
  97. package/dist/normalize.js +82 -0
  98. package/dist/office/connector/apps.js +34 -0
  99. package/dist/office/connector/docx/layer.js +247 -0
  100. package/dist/office/connector/docx/reader.js +284 -0
  101. package/dist/office/connector/excel/align.js +284 -0
  102. package/dist/office/connector/excel/answer.js +352 -0
  103. package/dist/office/connector/excel/diff.js +1310 -0
  104. package/dist/office/connector/excel/errors.js +44 -0
  105. package/dist/office/connector/excel/look.js +121 -0
  106. package/dist/office/connector/excel/print-boxes.js +432 -0
  107. package/dist/office/connector/excel/print-grid-previous.js +206 -0
  108. package/dist/office/connector/excel/print-setup.js +168 -0
  109. package/dist/office/connector/excel/workbook.js +374 -0
  110. package/dist/office/connector/export-driver.js +9 -0
  111. package/dist/office/connector/helpers/cocheck-screen +0 -0
  112. package/dist/office/connector/issues.js +31 -0
  113. package/dist/office/connector/mac-guard.js +16 -0
  114. package/dist/office/connector/main.js +23 -0
  115. package/dist/office/connector/nothing-changed.js +18 -0
  116. package/dist/office/connector/office-job.js +416 -0
  117. package/dist/office/connector/office-macos.js +473 -0
  118. package/dist/office/connector/office-win-export.js +107 -0
  119. package/dist/office/connector/office-win-lifecycle.js +194 -0
  120. package/dist/office/connector/office-win.js +209 -0
  121. package/dist/office/connector/office-win.ps1 +451 -0
  122. package/dist/office/connector/open-watch.js +46 -0
  123. package/dist/office/connector/pictures.js +156 -0
  124. package/dist/office/connector/pptx/diff.js +589 -0
  125. package/dist/office/connector/pptx/frames.js +105 -0
  126. package/dist/office/connector/pptx/layer.js +148 -0
  127. package/dist/office/connector/pptx/links.js +59 -0
  128. package/dist/office/connector/pptx/reader.js +744 -0
  129. package/dist/office/connector/pptx/spans.js +70 -0
  130. package/dist/office/connector/pptx/tags.js +86 -0
  131. package/dist/office/connector/pptx/xml.js +96 -0
  132. package/dist/office/connector/pptx/zip.js +223 -0
  133. package/dist/office/connector/pptx-boxes.js +238 -0
  134. package/dist/office/connector/print-copy-cap.js +19 -0
  135. package/dist/office/connector/print-copy.js +13 -0
  136. package/dist/office/connector/program.js +291 -0
  137. package/dist/office/connector/reach.js +27 -0
  138. package/dist/office/connector/refusal.js +16 -0
  139. package/dist/office/connector/screen-macos.js +193 -0
  140. package/dist/office/connector/screen-windows.js +34 -0
  141. package/dist/office/connector/shared/chart-diff.js +376 -0
  142. package/dist/office/connector/shared/docprops-noise.js +13 -0
  143. package/dist/office/connector/shared/lock.js +107 -0
  144. package/dist/office/connector/shared/ooxml-names.js +347 -0
  145. package/dist/office/connector/shared/owner.js +57 -0
  146. package/dist/office/connector/shared/package-media.js +703 -0
  147. package/dist/office/connector/shared/preflight.js +226 -0
  148. package/dist/office/connector/shared/structure-check.js +623 -0
  149. package/dist/office/connector/word-boxes.js +364 -0
  150. package/dist/office/connector/word-print-copy.js +234 -0
  151. package/dist/office/connector/xlsx/diff.js +1038 -0
  152. package/dist/office/connector/xlsx/formula.js +410 -0
  153. package/dist/office/connector/xlsx/layer.js +621 -0
  154. package/dist/office/connector/xlsx/memo.js +39 -0
  155. package/dist/office/connector/xlsx/numbers.js +31 -0
  156. package/dist/office/connector/xlsx/numfmt.js +913 -0
  157. package/dist/office/connector/xlsx/parts.js +66 -0
  158. package/dist/office/connector/xlsx/reader.js +394 -0
  159. package/dist/office/connector/xlsx/types.js +20 -0
  160. package/dist/office/connector/xlsx/written.js +446 -0
  161. package/dist/open-pick.js +99 -0
  162. package/dist/patch-secrets.js +194 -0
  163. package/dist/paths.js +65 -0
  164. package/dist/platform/darwin.js +179 -0
  165. package/dist/platform/index.js +61 -0
  166. package/dist/platform/spawn.js +115 -0
  167. package/dist/platform/stub.js +21 -0
  168. package/dist/platform/task-folder.js +41 -0
  169. package/dist/platform/types.js +20 -0
  170. package/dist/platform/win32-docrender.js +7 -0
  171. package/dist/platform/win32.js +265 -0
  172. package/dist/preferences.js +49 -0
  173. package/dist/reason.js +103 -0
  174. package/dist/region-delivery.js +148 -0
  175. package/dist/registry.js +68 -0
  176. package/dist/reveal.js +45 -0
  177. package/dist/review-process.js +154 -0
  178. package/dist/review-refresh-process.js +17 -0
  179. package/dist/review-refresh.js +120 -0
  180. package/dist/review-server.js +2079 -0
  181. package/dist/review-view-server.js +106 -0
  182. package/dist/review.js +8 -0
  183. package/dist/seal.js +315 -0
  184. package/dist/secret-files.js +34 -0
  185. package/dist/secret-hashes.js +27 -0
  186. package/dist/secret-rules.generated.js +3519 -0
  187. package/dist/secret-scan.js +127 -0
  188. package/dist/session-context.js +18 -0
  189. package/dist/signoff.js +419 -0
  190. package/dist/skill.js +110 -0
  191. package/dist/states.js +192 -0
  192. package/dist/tasks.js +1001 -0
  193. package/dist/timeline/attribution.js +207 -0
  194. package/dist/timeline/broken.js +55 -0
  195. package/dist/timeline/describe.js +413 -0
  196. package/dist/timeline/generic.js +195 -0
  197. package/dist/timeline/load.js +464 -0
  198. package/dist/timeline/loading.js +49 -0
  199. package/dist/timeline/notes.js +208 -0
  200. package/dist/timeline/page.js +178 -0
  201. package/dist/timeline/picture.js +303 -0
  202. package/dist/timeline/rail/assets/cocheck-icon.svg +1 -0
  203. package/dist/timeline/rail/assets/files-view.js +198 -0
  204. package/dist/timeline/rail/assets/loaders/icon-intro.json +1 -0
  205. package/dist/timeline/rail/assets/loaders/loader-orbit.json +1 -0
  206. package/dist/timeline/rail/assets/loaders/loader-spin.json +1 -0
  207. package/dist/timeline/rail/assets/review.css +992 -0
  208. package/dist/timeline/rail/assets/review.js +3365 -0
  209. package/dist/timeline/rail/assets/view-table.js +683 -0
  210. package/dist/timeline/rail/failure-line.js +26 -0
  211. package/dist/timeline/rail/files-model.js +45 -0
  212. package/dist/timeline/rail/live.js +49 -0
  213. package/dist/timeline/rail/made-pictures.js +48 -0
  214. package/dist/timeline/rail/mcp-card.js +307 -0
  215. package/dist/timeline/rail/model.js +1317 -0
  216. package/dist/timeline/rail/page.js +167 -0
  217. package/dist/timeline/rail/passes.js +106 -0
  218. package/dist/timeline/rail/regions.js +26 -0
  219. package/dist/timeline/rail/send-back.js +154 -0
  220. package/dist/timeline/rail/stop-status.js +164 -0
  221. package/dist/timeline/read-signal.js +743 -0
  222. package/dist/timeline/render/claimed.js +13 -0
  223. package/dist/timeline/render/fallback.js +36 -0
  224. package/dist/timeline/render/pdf-helper.js +71 -0
  225. package/dist/timeline/render/pdf.js +410 -0
  226. package/dist/timeline/render/pixel-pages.js +168 -0
  227. package/dist/timeline/render/png-crop.js +281 -0
  228. package/dist/timeline/render/registry.js +7 -0
  229. package/dist/timeline/render/text.js +366 -0
  230. package/dist/timeline/render/types.js +1 -0
  231. package/dist/timeline/render/view-v1.js +148 -0
  232. package/dist/timeline/render/whole.js +6 -0
  233. package/dist/timeline/rollout-failures.js +40 -0
  234. package/dist/timeline/runs.js +836 -0
  235. package/dist/timeline/stored-image.js +34 -0
  236. package/dist/timeline/subject-display.js +44 -0
  237. package/dist/timeline/timeline.js +1114 -0
  238. package/dist/timeline/write-signal.js +403 -0
  239. package/dist/tool-label.js +201 -0
  240. package/dist/tracking.js +87 -0
  241. package/dist/vendor/pdfjs/LICENSE +177 -0
  242. package/dist/vendor/pdfjs/pdf.min.mjs +27 -0
  243. package/dist/vendor/pdfjs/pdf.worker.min.mjs +27 -0
  244. package/package.json +66 -4
  245. package/public-kit/GUIDE.md +189 -0
  246. package/public-kit/README.md +10 -0
  247. package/public-kit/conformance/README.md +13 -0
  248. package/public-kit/conformance/cases/C1.json +12 -0
  249. package/public-kit/conformance/cases/C10.json +15 -0
  250. package/public-kit/conformance/cases/C11.json +16 -0
  251. package/public-kit/conformance/cases/C12.json +18 -0
  252. package/public-kit/conformance/cases/C13.json +23 -0
  253. package/public-kit/conformance/cases/C14.json +16 -0
  254. package/public-kit/conformance/cases/C16.json +15 -0
  255. package/public-kit/conformance/cases/C17.json +25 -0
  256. package/public-kit/conformance/cases/C2.json +13 -0
  257. package/public-kit/conformance/cases/C3.json +44 -0
  258. package/public-kit/conformance/cases/C4.json +13 -0
  259. package/public-kit/conformance/cases/C5.json +16 -0
  260. package/public-kit/conformance/cases/C6.json +58 -0
  261. package/public-kit/conformance/generate-large.mjs +15 -0
  262. package/public-kit/examples/toy-export/cocheck-connector.json +10 -0
  263. package/public-kit/examples/toy-export/connector.mjs +28 -0
  264. package/public-kit/examples/toy-helpers/cocheck-connector.json +10 -0
  265. package/public-kit/examples/toy-helpers/connector.mjs +69 -0
  266. package/public-kit/examples/toy-level-1/cocheck-connector.json +10 -0
  267. package/public-kit/examples/toy-level-1/connector.mjs +61 -0
  268. package/public-kit/examples/toy-level-3/cocheck-connector.json +10 -0
  269. package/public-kit/examples/toy-level-3/connector.mjs +82 -0
  270. package/public-kit/examples/toy-tracker/cocheck-connector.json +14 -0
  271. package/public-kit/examples/toy-tracker/connector.mjs +46 -0
  272. package/public-kit/examples/toy-tracker/samples/history.json +10 -0
  273. package/public-kit/examples/toy-tracker/samples/samples.json +7 -0
  274. package/public-kit/examples/toy-vendor/cocheck-connector.json +15 -0
  275. package/public-kit/examples/toy-vendor/connector.mjs +62 -0
  276. package/public-kit/helpers/pdf-text-layout.d.mts +35 -0
  277. package/public-kit/helpers/pdf-text-layout.mjs +602 -0
  278. package/public-kit/helpers/pdf-text.d.mts +56 -0
  279. package/public-kit/helpers/pdf-text.mjs +375 -0
  280. package/public-kit/helpers/pdf.d.mts +61 -0
  281. package/public-kit/helpers/pdf.mjs +251 -0
  282. package/public-kit/helpers/png.d.mts +15 -0
  283. package/public-kit/helpers/png.mjs +88 -0
  284. package/public-kit/helpers/spec.d.mts +4 -0
  285. package/public-kit/helpers/spec.mjs +2 -0
  286. package/public-kit/scaffold/README.md +23 -0
  287. package/public-kit/scaffold/template/README.md +13 -0
  288. package/public-kit/scaffold/template/cocheck-connector.json +10 -0
  289. package/public-kit/scaffold/template/connector.mjs +50 -0
  290. package/public-kit/spec/README.md +408 -0
  291. package/public-kit/spec/v1.md +598 -0
  292. package/public-kit/toy-product/README.md +7 -0
  293. package/public-kit/toy-product/notes-store.mjs +30 -0
  294. package/public-kit/toy-product/states/create.after.json +16 -0
  295. package/public-kit/toy-product/states/create.before.json +12 -0
  296. package/public-kit/toy-product/states/delete.after.json +8 -0
  297. package/public-kit/toy-product/states/delete.before.json +12 -0
  298. package/public-kit/toy-product/states/edit.after.json +12 -0
  299. package/public-kit/toy-product/states/edit.before.json +12 -0
  300. package/public-kit/toy-product/states/malformed.after.json +1 -0
  301. package/public-kit/toy-product/states/malformed.before.json +12 -0
  302. package/public-kit/toy-product/states/no-change.after.json +12 -0
  303. package/public-kit/toy-product/states/no-change.before.json +12 -0
  304. package/scripts/hook-launch.mjs +58 -0
  305. package/scripts/hook-launch.sh +52 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 CoCheck contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,105 @@
1
- # Temporary Holding Version
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="docs/brand/cocheck-wordmark-dark.png">
4
+ <img src="docs/brand/cocheck-wordmark-light.png" alt="CoCheck" height="72">
5
+ </picture>
6
+ </p>
2
7
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
8
+ If you are an agent I recommend starting here: [AGENTS.md](AGENTS.md)
9
+
10
+ ---
11
+ Hi, thanks for checking this out. A few words before you read what Claude has built.
12
+ 1) This is my first open-source project. I made it to help people stay valuable in the era of AI, not for AI to replace them. My full thoughts here [cocheck.ai](https://cocheck.ai)
13
+ 2) As a result of 3), there will likely be mistakes in here. Would love to collaborate and receive guidance from people more knowledgeable.
14
+ 3) Ironically, it is entirely vibe-coded. I have not written a single line besides these that I'm typing right now. That was part of my experiment. I wanted to see how capable Claude was. I checked what I thought were the important bits.
15
+ 4) I really enjoyed building it, even so. Claude was a great builder but almost all of what I think the average person would consider to be the 'critical decisions' of the project were made by me (a human, in case that wasn't already obvious).
16
+ 5) Use at your own risk. Not that I cooked malware into this or anything, but like I said, I haven't looked at most of the code. So yeah...maybe don't take my word for what's safe and what isn't (although I've left comments where I think they'll be helpful). Ideally this product would help me make that process a lot easier.
17
+ 6) The goal is to expand this to accept anything (anything!!!) as a connector, that way all general workflows and traces can be audited. For now, it's just Microsoft Excel, Powerpoint, and Word. It's tricky and I don't have enough experience, so I think it's a great angle for an open source project, and for people with much more experience on specific integrations to build them. Let me know if you want to help.
18
+ 7) This is just the beginning as far as my ambition is concerned. I have bigger ideas (but first, we'll see if anyone even reads this...)
19
+ 8) I've only lightly tested this. Mostly on Mac with Claude Code, plus a little with Codex, Copilot CLI and Claude Code via the Claude desktop app on Mac, and Claude Code on Windows. It basically works but has not been extensively tested, so I expect lots of bugs.
20
+ 9) Disclaimer: this is not meant to copy any existing software. It is not based on any existing software. I have not seen any software that does this. If we have an issue, let me know. Happy to work it out. Otherwise, this is original work as far as I know ("original work" haha).
21
+
22
+ Ok, leaving things in Claude's hands now. Enjoy.
23
+
24
+
25
+
26
+ CoCheck keeps you in the driver's seat
27
+ ---
28
+
29
+ CoCheck shows what AI agents changed in your files, step by step, with a before-and-after review page that says which agent action made each change.
30
+
31
+ **This is a preview.** CoCheck works, and it has bugs. Please open an issue when something breaks or reads wrong. It has been tested most on a Mac with Claude Code; Windows, Codex and Copilot have had less testing.
32
+
33
+ CoCheck runs on a Mac, and on Windows with Claude Code; other platforms are planned. See [docs/install.md](docs/install.md) to install it.
34
+
35
+ ## What it does
36
+
37
+ CoCheck hooks into the coding agents you already use and records their work as they do it. It supports Claude Code, Codex and Copilot. The agent needs no special tools.
38
+
39
+ You start tracking per session, in plain words: tell the agent "start tracking". Every session starts untracked, and an untracked session records nothing. "Stop tracking" ends it, and what was recorded stays.
40
+
41
+ For a tracked session, CoCheck keeps the whole file at the start of the task and every state of each file that changed.
42
+
43
+ ## The review page
44
+
45
+ Say "show me the review", or run `cocheck open`. The page opens in your browser and shows:
46
+
47
+ - the before and after of each change, step by step, for every file the task touched;
48
+ - attribution: which agent call made each change, or that several overlapping calls share it, or that it was a hand edit;
49
+ - a pass or fail on each step, so you can send the failed ones back to the agent or sign off.
50
+
51
+ What the page shows for a file depends on its type. Text and code get a line diff, PDFs get pages with the changes boxed, and png, jpg, gif, webp and svg images are shown by your browser from the stored file, on every OS (two PNGs also get a pixel comparison). Excel, Word and PowerPoint files are read by three built-in connectors, on the same standard as any connector you build ([public-kit/GUIDE.md](public-kit/GUIDE.md) shows how to build one): they list what changed and, when the Office app is installed, show the app's own printed pages. CoCheck itself does not read or draw Office files. A file with no reader gets a fingerprint.
52
+
53
+ The page is local, and the record stays on your device in the data folder you choose at install.
54
+
55
+ ## In the works
56
+
57
+ None of these is available yet.
58
+
59
+ - Stronger attribution: tying each change to the exact process that wrote it, not only to the agent calls open at the time.
60
+ - Better Excel pictures: Excel's charts shown beside the cells they draw from.
61
+ - A standard for adding agent harnesses: a published format so anyone can connect a new agent harness to CoCheck, the way the connector standard does for apps.
62
+
63
+ ## Install and use
64
+
65
+ On a Mac:
66
+
67
+ ```
68
+ brew install cocheck-ai/tap/cocheck
69
+ cocheck install --home ~/CoCheckData
70
+ ```
71
+
72
+ On a Mac or Windows:
73
+
74
+ ```
75
+ npm install -g cocheck
76
+ cocheck install --home ~/CoCheckData
77
+ ```
78
+
79
+ `--home` must be an absolute path. On Windows, cmd and Windows PowerShell pass `~` through unexpanded, so use `cocheck install --home "$env:USERPROFILE\CoCheckData" --for claude` in PowerShell (see the Windows part of [docs/install.md](docs/install.md)).
80
+
81
+ Run `cocheck install` from the folder you want CoCheck to watch, or pass `--folder <dir>`. Then restart your agent, start a session, say "start tracking", do some work, and say "show me the review". [docs/install.md](docs/install.md) has the whole path, including other agents (`--for codex`, `--for copilot`, `--for all`), checking that CoCheck is recording, and uninstalling.
82
+
83
+ ## Platforms
84
+
85
+ CoCheck runs on a Mac, or on Windows with Claude Code (Node 22.18 or newer; see the Windows section of [docs/install.md](docs/install.md)). Codex and Copilot are documented for Mac only. The hook capture is written so other operating systems and other agents can follow. [platforms/README.md](platforms/README.md) holds the sourced record of what each agent platform lets CoCheck do (Claude Code, Codex, Copilot CLI, Copilot in VS Code, ChatGPT Work, Claude Cowork).
86
+
87
+ ## Docs
88
+
89
+ - [docs/install.md](docs/install.md): install, start and stop tracking, the review page, uninstall, troubleshooting.
90
+ - [public-kit/GUIDE.md](public-kit/GUIDE.md): build a connector for another file type or app.
91
+ - [docs/hooks.md](docs/hooks.md): how the hook adapter records and attributes changes.
92
+ - [docs/attribution-tag.md](docs/attribution-tag.md): how a change is tied to the call that made it.
93
+ - [docs/timeline.md](docs/timeline.md): how the review page's timeline is built.
94
+ - [docs/security.md](docs/security.md): how stored file copies are encrypted at rest.
95
+ - [docs/release.md](docs/release.md): how a build is released.
96
+ - [docs/release-notes.md](docs/release-notes.md): what changed in each build.
97
+
98
+ ## Working on CoCheck
99
+
100
+ ```
101
+ npm install
102
+ npm run typecheck
103
+ ```
104
+
105
+ Source is TypeScript that runs directly under Node 22.18 or newer. Tests run through `npm test`. On a Mac, building also needs the Xcode command-line tools (`xcode-select --install`), which provide `swiftc` for the native helpers. See [CONTRIBUTING.md](CONTRIBUTING.md). To report a security problem, see [SECURITY.md](SECURITY.md).
@@ -0,0 +1,279 @@
1
+ # Third-party notices
2
+
3
+ CoCheck ships the following third-party software with its build. Each entry names the licence, the copyright line and the file in the package or source that states them.
4
+
5
+ ## pdf.js
6
+
7
+ - What: Mozilla pdf.js, the legacy build files `pdf.min.mjs` and `pdf.worker.min.mjs` from the `pdfjs-dist` package (version pinned in `package.json`).
8
+ - Where: `dist/vendor/pdfjs/` (copied by `scripts/build.mjs`), with its licence text in `dist/vendor/pdfjs/LICENSE`.
9
+ - Used for: reading every PDF's page sizes, text lines, paragraph places and crops on every OS (`public-kit/helpers/pdf-text.mjs`, in a Node child process); text only, no rendering.
10
+ - Licence: Apache License 2.0. Copyright Mozilla Foundation and the pdf.js contributors. Source: https://github.com/mozilla/pdf.js. Licence text: `node_modules/pdfjs-dist/LICENSE` (copied to `dist/vendor/pdfjs/LICENSE`); copyright line read from the header of `legacy/build/pdf.min.mjs` and `pdf.worker.min.mjs`: "Copyright 2024 Mozilla Foundation".
11
+
12
+ ## Gitleaks rules
13
+
14
+ - What: the secret-detection rules of gitleaks (`vendor/gitleaks/gitleaks.toml`, version in `vendor/gitleaks/VERSION`, v8.30.1), embedded in `src/secret-rules.generated.ts` and compiled into `dist/`. The gitleaks program itself is not shipped.
15
+ - Used for: replacing text that looks like a secret with a withheld marker.
16
+ - Licence: MIT. Copyright (c) 2019 Zachary Rice. Source: https://github.com/gitleaks/gitleaks. Licence text and copyright line: `vendor/gitleaks/LICENSE`, reproduced below.
17
+
18
+ ```
19
+ MIT License
20
+
21
+ Copyright (c) 2019 Zachary Rice
22
+
23
+ Permission is hereby granted, free of charge, to any person obtaining a copy
24
+ of this software and associated documentation files (the "Software"), to deal
25
+ in the Software without restriction, including without limitation the rights
26
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
27
+ copies of the Software, and to permit persons to whom the Software is
28
+ furnished to do so, subject to the following conditions:
29
+
30
+ The above copyright notice and this permission notice shall be included in all
31
+ copies or substantial portions of the Software.
32
+
33
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
34
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
35
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
36
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
37
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
38
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
39
+ SOFTWARE.
40
+ ```
41
+
42
+ ## fast-xml-parser
43
+
44
+ - What: the `fast-xml-parser` package, version 5.11.1 at the time of writing (a runtime dependency in `package.json`, installed by `npm ci --omit=dev`).
45
+ - Used for: reading Office document XML.
46
+ - Licence: MIT. Copyright (c) 2017 Amit Kumar Gupta. Source: `node_modules/fast-xml-parser/LICENSE` and the `license` field of its `package.json`. Upstream: https://github.com/NaturalIntelligence/fast-xml-parser
47
+
48
+ ```
49
+ MIT License
50
+
51
+ Copyright (c) 2017 Amit Kumar Gupta
52
+
53
+ Permission is hereby granted, free of charge, to any person obtaining a copy
54
+ of this software and associated documentation files (the "Software"), to deal
55
+ in the Software without restriction, including without limitation the rights
56
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
57
+ copies of the Software, and to permit persons to whom the Software is
58
+ furnished to do so, subject to the following conditions:
59
+
60
+ The above copyright notice and this permission notice shall be included in all
61
+ copies or substantial portions of the Software.
62
+
63
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
64
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
65
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
66
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
67
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
68
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
69
+ SOFTWARE.
70
+ ```
71
+
72
+ ## fflate
73
+
74
+ - What: the `fflate` package, version 0.8.3 at the time of writing (a runtime dependency in `package.json`, installed by `npm ci --omit=dev`).
75
+ - Used for: reading and writing zip containers (Office files).
76
+ - Licence: MIT. Copyright (c) 2026 Arjun Barrett. Source: `node_modules/fflate/LICENSE` and the `license` field of its `package.json`. Upstream: https://github.com/101arrowz/fflate
77
+
78
+ ```
79
+ MIT License
80
+
81
+ Copyright (c) 2026 Arjun Barrett
82
+
83
+ Permission is hereby granted, free of charge, to any person obtaining a copy
84
+ of this software and associated documentation files (the "Software"), to deal
85
+ in the Software without restriction, including without limitation the rights
86
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
87
+ copies of the Software, and to permit persons to whom the Software is
88
+ furnished to do so, subject to the following conditions:
89
+
90
+ The above copyright notice and this permission notice shall be included in all
91
+ copies or substantial portions of the Software.
92
+
93
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
94
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
95
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
96
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
97
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
98
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
99
+ SOFTWARE.
100
+ ```
101
+
102
+ ## @nodable/entities
103
+
104
+ - What: the `@nodable/entities` package, version 3.0.0 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
105
+ - Licence: MIT. Author: Amit Gupta. This package ships no LICENSE file, so there is no copyright line to copy; the licence and author come from the `license` and `author` fields of `node_modules/@nodable/entities/package.json`. The standard MIT licence text applies.
106
+
107
+ ## anynum
108
+
109
+ - What: the `anynum` package, version 1.0.1 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
110
+ - Licence: MIT. Copyright (c) 2026 Natural Intelligence. Source: `node_modules/anynum/LICENSE` and the `license` field of its `package.json`.
111
+
112
+ ```
113
+ MIT License
114
+
115
+ Copyright (c) 2026 Natural Intelligence
116
+
117
+ Permission is hereby granted, free of charge, to any person obtaining a copy
118
+ of this software and associated documentation files (the "Software"), to deal
119
+ in the Software without restriction, including without limitation the rights
120
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
121
+ copies of the Software, and to permit persons to whom the Software is
122
+ furnished to do so, subject to the following conditions:
123
+
124
+ The above copyright notice and this permission notice shall be included in all
125
+ copies or substantial portions of the Software.
126
+
127
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
128
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
129
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
130
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
131
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
132
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
133
+ SOFTWARE.
134
+ ```
135
+
136
+ ## fast-xml-builder
137
+
138
+ - What: the `fast-xml-builder` package, version 1.3.1 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
139
+ - Licence: MIT. Copyright (c) 2026 Natural Intelligence. Source: `node_modules/fast-xml-builder/LICENSE` and the `license` field of its `package.json`.
140
+
141
+ ```
142
+ MIT License
143
+
144
+ Copyright (c) 2026 Natural Intelligence
145
+
146
+ Permission is hereby granted, free of charge, to any person obtaining a copy
147
+ of this software and associated documentation files (the "Software"), to deal
148
+ in the Software without restriction, including without limitation the rights
149
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
150
+ copies of the Software, and to permit persons to whom the Software is
151
+ furnished to do so, subject to the following conditions:
152
+
153
+ The above copyright notice and this permission notice shall be included in all
154
+ copies or substantial portions of the Software.
155
+
156
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
157
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
158
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
159
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
160
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
161
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
162
+ SOFTWARE.
163
+ ```
164
+
165
+ ## is-unsafe
166
+
167
+ - What: the `is-unsafe` package, version 2.0.2 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
168
+ - Licence: MIT. Copyright (c) 2026 Natural Intelligence. Source: `node_modules/is-unsafe/LICENSE` and the `license` field of its `package.json`.
169
+
170
+ ```
171
+ MIT License
172
+
173
+ Copyright (c) 2026 Natural Intelligence
174
+
175
+ Permission is hereby granted, free of charge, to any person obtaining a copy
176
+ of this software and associated documentation files (the "Software"), to deal
177
+ in the Software without restriction, including without limitation the rights
178
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
179
+ copies of the Software, and to permit persons to whom the Software is
180
+ furnished to do so, subject to the following conditions:
181
+
182
+ The above copyright notice and this permission notice shall be included in all
183
+ copies or substantial portions of the Software.
184
+
185
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
186
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
187
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
188
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
189
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
190
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
191
+ SOFTWARE.
192
+ ```
193
+
194
+ ## path-expression-matcher
195
+
196
+ - What: the `path-expression-matcher` package, version 1.6.2 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
197
+ - Licence: MIT. Copyright (c) 2024. Source: `node_modules/path-expression-matcher/LICENSE` and the `license` field of its `package.json`.
198
+
199
+ ```
200
+ MIT License
201
+
202
+ Copyright (c) 2024
203
+
204
+ Permission is hereby granted, free of charge, to any person obtaining a copy
205
+ of this software and associated documentation files (the "Software"), to deal
206
+ in the Software without restriction, including without limitation the rights
207
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
208
+ copies of the Software, and to permit persons to whom the Software is
209
+ furnished to do so, subject to the following conditions:
210
+
211
+ The above copyright notice and this permission notice shall be included in all
212
+ copies or substantial portions of the Software.
213
+
214
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
215
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
216
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
217
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
218
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
219
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
220
+ SOFTWARE.
221
+ ```
222
+
223
+ ## strnum
224
+
225
+ - What: the `strnum` package, version 2.4.2 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
226
+ - Licence: MIT. Copyright (c) 2021 Natural Intelligence. Source: `node_modules/strnum/LICENSE` and the `license` field of its `package.json`.
227
+
228
+ ```
229
+ MIT License
230
+
231
+ Copyright (c) 2021 Natural Intelligence
232
+
233
+ Permission is hereby granted, free of charge, to any person obtaining a copy
234
+ of this software and associated documentation files (the "Software"), to deal
235
+ in the Software without restriction, including without limitation the rights
236
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
237
+ copies of the Software, and to permit persons to whom the Software is
238
+ furnished to do so, subject to the following conditions:
239
+
240
+ The above copyright notice and this permission notice shall be included in all
241
+ copies or substantial portions of the Software.
242
+
243
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
244
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
245
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
246
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
247
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
248
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
249
+ SOFTWARE.
250
+ ```
251
+
252
+ ## xml-naming
253
+
254
+ - What: the `xml-naming` package, version 0.3.0 at the time of writing (installed by `npm ci --omit=dev` as a dependency of `fast-xml-parser`).
255
+ - Licence: MIT. Copyright (c) 2026 Natural Intelligence. Source: `node_modules/xml-naming/LICENSE` and the `license` field of its `package.json`.
256
+
257
+ ```
258
+ MIT License
259
+
260
+ Copyright (c) 2026 Natural Intelligence
261
+
262
+ Permission is hereby granted, free of charge, to any person obtaining a copy
263
+ of this software and associated documentation files (the "Software"), to deal
264
+ in the Software without restriction, including without limitation the rights
265
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
266
+ copies of the Software, and to permit persons to whom the Software is
267
+ furnished to do so, subject to the following conditions:
268
+
269
+ The above copyright notice and this permission notice shall be included in all
270
+ copies or substantial portions of the Software.
271
+
272
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
273
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
274
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
275
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
276
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
277
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
278
+ SOFTWARE.
279
+ ```
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+ // The `cocheck` bin. An installed package (and a built checkout) runs the built dist/cli-main.js; a source checkout that was never built
3
+ // runs src/cli-main.ts, which Node strips of types itself (it cannot inside node_modules, which is why the package ships dist/).
4
+ import { existsSync } from "node:fs";
5
+ import { pathToFileURL } from "node:url";
6
+
7
+ const built = new URL("../dist/cli-main.js", import.meta.url);
8
+ await import(existsSync(built) ? built.href : pathToFileURL(new URL("../src/cli-main.ts", import.meta.url).pathname).href);