@humanbased/crosscheck 1.2.0 → 1.3.0-beta.81

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 (314) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +182 -375
  3. package/README.zh.md +1 -1
  4. package/assets/icon-256.png +0 -0
  5. package/assets/linear-comment.svg +18 -0
  6. package/assets/linear-onboard.svg +30 -0
  7. package/assets/linear-status.svg +23 -0
  8. package/assets/linear-test.svg +34 -0
  9. package/assets/skills/code-review/.crosscheck-skill.json +9 -0
  10. package/assets/skills/code-review/LICENSE +21 -0
  11. package/assets/skills/code-review/SKILL.md +89 -0
  12. package/assets/skills/code-review/agents/openai.yaml +3 -0
  13. package/assets/skills/code-review-skill/.crosscheck-skill.json +9 -0
  14. package/assets/skills/code-review-skill/LICENSE +21 -0
  15. package/assets/skills/code-review-skill/SKILL.md +231 -0
  16. package/assets/skills/code-review-skill/assets/pr-review-template.md +137 -0
  17. package/assets/skills/code-review-skill/assets/review-checklist.md +123 -0
  18. package/assets/skills/code-review-skill/reference/angular.md +768 -0
  19. package/assets/skills/code-review-skill/reference/architecture-review-guide.md +472 -0
  20. package/assets/skills/code-review-skill/reference/c.md +890 -0
  21. package/assets/skills/code-review-skill/reference/code-quality-universal.md +488 -0
  22. package/assets/skills/code-review-skill/reference/code-review-best-practices.md +136 -0
  23. package/assets/skills/code-review-skill/reference/common-bugs-checklist.md +286 -0
  24. package/assets/skills/code-review-skill/reference/cpp.md +893 -0
  25. package/assets/skills/code-review-skill/reference/cross-cutting/async-concurrency-patterns.md +515 -0
  26. package/assets/skills/code-review-skill/reference/cross-cutting/error-handling-principles.md +492 -0
  27. package/assets/skills/code-review-skill/reference/cross-cutting/n-plus-one-queries.md +309 -0
  28. package/assets/skills/code-review-skill/reference/cross-cutting/sql-injection-prevention.md +308 -0
  29. package/assets/skills/code-review-skill/reference/cross-cutting/xss-prevention.md +264 -0
  30. package/assets/skills/code-review-skill/reference/csharp.md +525 -0
  31. package/assets/skills/code-review-skill/reference/css-less-sass.md +661 -0
  32. package/assets/skills/code-review-skill/reference/django.md +985 -0
  33. package/assets/skills/code-review-skill/reference/fastapi.md +580 -0
  34. package/assets/skills/code-review-skill/reference/go.md +993 -0
  35. package/assets/skills/code-review-skill/reference/java.md +409 -0
  36. package/assets/skills/code-review-skill/reference/java8.md +586 -0
  37. package/assets/skills/code-review-skill/reference/kotlin.md +1018 -0
  38. package/assets/skills/code-review-skill/reference/nestjs.md +593 -0
  39. package/assets/skills/code-review-skill/reference/performance-review-guide.md +816 -0
  40. package/assets/skills/code-review-skill/reference/php.md +684 -0
  41. package/assets/skills/code-review-skill/reference/python.md +1073 -0
  42. package/assets/skills/code-review-skill/reference/qt.md +757 -0
  43. package/assets/skills/code-review-skill/reference/react.md +871 -0
  44. package/assets/skills/code-review-skill/reference/ruby.md +964 -0
  45. package/assets/skills/code-review-skill/reference/rust.md +846 -0
  46. package/assets/skills/code-review-skill/reference/security-review-guide.md +494 -0
  47. package/assets/skills/code-review-skill/reference/svelte.md +1064 -0
  48. package/assets/skills/code-review-skill/reference/swift.md +936 -0
  49. package/assets/skills/code-review-skill/reference/typescript.md +1016 -0
  50. package/assets/skills/code-review-skill/reference/vue.md +924 -0
  51. package/assets/skills/code-review-skill/reference/zig.md +440 -0
  52. package/assets/skills/code-review-skill/scripts/pr-analyzer.py +435 -0
  53. package/assets/skills/code-review-skill/scripts/test_pr_analyzer.py +380 -0
  54. package/assets/skills/codebase-design/.crosscheck-skill.json +9 -0
  55. package/assets/skills/codebase-design/DEEPENING.md +37 -0
  56. package/assets/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  57. package/assets/skills/codebase-design/LICENSE +21 -0
  58. package/assets/skills/codebase-design/SKILL.md +114 -0
  59. package/assets/skills/codebase-design/agents/openai.yaml +3 -0
  60. package/assets/skills/diagnosing-bugs/.crosscheck-skill.json +9 -0
  61. package/assets/skills/diagnosing-bugs/LICENSE +21 -0
  62. package/assets/skills/diagnosing-bugs/SKILL.md +134 -0
  63. package/assets/skills/diagnosing-bugs/agents/openai.yaml +3 -0
  64. package/assets/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
  65. package/crosscheck.config.example.yml +101 -9
  66. package/dist/__tests__/board.test.js +11 -0
  67. package/dist/__tests__/board.test.js.map +1 -1
  68. package/dist/__tests__/can-write-verdict.test.d.ts +2 -0
  69. package/dist/__tests__/can-write-verdict.test.d.ts.map +1 -0
  70. package/dist/__tests__/can-write-verdict.test.js +31 -0
  71. package/dist/__tests__/can-write-verdict.test.js.map +1 -0
  72. package/dist/__tests__/codex.test.js +14 -27
  73. package/dist/__tests__/codex.test.js.map +1 -1
  74. package/dist/__tests__/comment-bodies.test.js +49 -1
  75. package/dist/__tests__/comment-bodies.test.js.map +1 -1
  76. package/dist/__tests__/conflict-resolve.test.js +44 -1
  77. package/dist/__tests__/conflict-resolve.test.js.map +1 -1
  78. package/dist/__tests__/fix.test.js +33 -0
  79. package/dist/__tests__/fix.test.js.map +1 -1
  80. package/dist/__tests__/linear-branding.test.d.ts +2 -0
  81. package/dist/__tests__/linear-branding.test.d.ts.map +1 -0
  82. package/dist/__tests__/linear-branding.test.js +156 -0
  83. package/dist/__tests__/linear-branding.test.js.map +1 -0
  84. package/dist/__tests__/linear-client.test.d.ts +2 -0
  85. package/dist/__tests__/linear-client.test.d.ts.map +1 -0
  86. package/dist/__tests__/linear-client.test.js +120 -0
  87. package/dist/__tests__/linear-client.test.js.map +1 -0
  88. package/dist/__tests__/linear-comment.test.d.ts +2 -0
  89. package/dist/__tests__/linear-comment.test.d.ts.map +1 -0
  90. package/dist/__tests__/linear-comment.test.js +151 -0
  91. package/dist/__tests__/linear-comment.test.js.map +1 -0
  92. package/dist/__tests__/linear-identity.test.d.ts +2 -0
  93. package/dist/__tests__/linear-identity.test.d.ts.map +1 -0
  94. package/dist/__tests__/linear-identity.test.js +253 -0
  95. package/dist/__tests__/linear-identity.test.js.map +1 -0
  96. package/dist/__tests__/linear-notify.test.d.ts +2 -0
  97. package/dist/__tests__/linear-notify.test.d.ts.map +1 -0
  98. package/dist/__tests__/linear-notify.test.js +144 -0
  99. package/dist/__tests__/linear-notify.test.js.map +1 -0
  100. package/dist/__tests__/linear-ref.test.d.ts +2 -0
  101. package/dist/__tests__/linear-ref.test.d.ts.map +1 -0
  102. package/dist/__tests__/linear-ref.test.js +261 -0
  103. package/dist/__tests__/linear-ref.test.js.map +1 -0
  104. package/dist/__tests__/linear-test-ref.test.d.ts +2 -0
  105. package/dist/__tests__/linear-test-ref.test.d.ts.map +1 -0
  106. package/dist/__tests__/linear-test-ref.test.js +81 -0
  107. package/dist/__tests__/linear-test-ref.test.js.map +1 -0
  108. package/dist/__tests__/linear-verify.test.d.ts +2 -0
  109. package/dist/__tests__/linear-verify.test.d.ts.map +1 -0
  110. package/dist/__tests__/linear-verify.test.js +132 -0
  111. package/dist/__tests__/linear-verify.test.js.map +1 -0
  112. package/dist/__tests__/linear-worker.test.d.ts +2 -0
  113. package/dist/__tests__/linear-worker.test.d.ts.map +1 -0
  114. package/dist/__tests__/linear-worker.test.js +83 -0
  115. package/dist/__tests__/linear-worker.test.js.map +1 -0
  116. package/dist/__tests__/linear-write-possible.test.d.ts +2 -0
  117. package/dist/__tests__/linear-write-possible.test.d.ts.map +1 -0
  118. package/dist/__tests__/linear-write-possible.test.js +30 -0
  119. package/dist/__tests__/linear-write-possible.test.js.map +1 -0
  120. package/dist/__tests__/onboard-preservation.test.js +59 -3
  121. package/dist/__tests__/onboard-preservation.test.js.map +1 -1
  122. package/dist/__tests__/optimize.test.js +2 -0
  123. package/dist/__tests__/optimize.test.js.map +1 -1
  124. package/dist/__tests__/repo-picker.test.js +7 -1
  125. package/dist/__tests__/repo-picker.test.js.map +1 -1
  126. package/dist/__tests__/repository-guidance.test.d.ts +2 -0
  127. package/dist/__tests__/repository-guidance.test.d.ts.map +1 -0
  128. package/dist/__tests__/repository-guidance.test.js +107 -0
  129. package/dist/__tests__/repository-guidance.test.js.map +1 -0
  130. package/dist/__tests__/review-comment-body.test.js +35 -0
  131. package/dist/__tests__/review-comment-body.test.js.map +1 -1
  132. package/dist/__tests__/review-models.test.js +19 -3
  133. package/dist/__tests__/review-models.test.js.map +1 -1
  134. package/dist/__tests__/review-strategy.test.d.ts +2 -0
  135. package/dist/__tests__/review-strategy.test.d.ts.map +1 -0
  136. package/dist/__tests__/review-strategy.test.js +397 -0
  137. package/dist/__tests__/review-strategy.test.js.map +1 -0
  138. package/dist/__tests__/runner.test.js +29 -1
  139. package/dist/__tests__/runner.test.js.map +1 -1
  140. package/dist/__tests__/skill-attribution.test.d.ts +2 -0
  141. package/dist/__tests__/skill-attribution.test.d.ts.map +1 -0
  142. package/dist/__tests__/skill-attribution.test.js +53 -0
  143. package/dist/__tests__/skill-attribution.test.js.map +1 -0
  144. package/dist/__tests__/skill-broker.test.d.ts +2 -0
  145. package/dist/__tests__/skill-broker.test.d.ts.map +1 -0
  146. package/dist/__tests__/skill-broker.test.js +144 -0
  147. package/dist/__tests__/skill-broker.test.js.map +1 -0
  148. package/dist/__tests__/skill-catalog.test.d.ts +2 -0
  149. package/dist/__tests__/skill-catalog.test.d.ts.map +1 -0
  150. package/dist/__tests__/skill-catalog.test.js +40 -0
  151. package/dist/__tests__/skill-catalog.test.js.map +1 -0
  152. package/dist/__tests__/skill-installer.test.d.ts +2 -0
  153. package/dist/__tests__/skill-installer.test.d.ts.map +1 -0
  154. package/dist/__tests__/skill-installer.test.js +96 -0
  155. package/dist/__tests__/skill-installer.test.js.map +1 -0
  156. package/dist/__tests__/skills-config.test.d.ts +2 -0
  157. package/dist/__tests__/skills-config.test.d.ts.map +1 -0
  158. package/dist/__tests__/skills-config.test.js +12 -0
  159. package/dist/__tests__/skills-config.test.js.map +1 -0
  160. package/dist/cli.js +29 -0
  161. package/dist/cli.js.map +1 -1
  162. package/dist/commands/linear-test.d.ts +18 -0
  163. package/dist/commands/linear-test.d.ts.map +1 -0
  164. package/dist/commands/linear-test.js +130 -0
  165. package/dist/commands/linear-test.js.map +1 -0
  166. package/dist/commands/onboard.d.ts +36 -3
  167. package/dist/commands/onboard.d.ts.map +1 -1
  168. package/dist/commands/onboard.js +233 -42
  169. package/dist/commands/onboard.js.map +1 -1
  170. package/dist/commands/review.d.ts.map +1 -1
  171. package/dist/commands/review.js +65 -6
  172. package/dist/commands/review.js.map +1 -1
  173. package/dist/commands/run.d.ts.map +1 -1
  174. package/dist/commands/run.js +45 -7
  175. package/dist/commands/run.js.map +1 -1
  176. package/dist/commands/skill.d.ts +2 -0
  177. package/dist/commands/skill.d.ts.map +1 -0
  178. package/dist/commands/skill.js +16 -0
  179. package/dist/commands/skill.js.map +1 -0
  180. package/dist/commands/status.d.ts.map +1 -1
  181. package/dist/commands/status.js +53 -1
  182. package/dist/commands/status.js.map +1 -1
  183. package/dist/commands/watch.d.ts.map +1 -1
  184. package/dist/commands/watch.js +90 -12
  185. package/dist/commands/watch.js.map +1 -1
  186. package/dist/config/loader.d.ts +3 -1
  187. package/dist/config/loader.d.ts.map +1 -1
  188. package/dist/config/loader.js +13 -0
  189. package/dist/config/loader.js.map +1 -1
  190. package/dist/config/review-model-tiers.json +3 -3
  191. package/dist/config/review-strategy.json +204 -0
  192. package/dist/config/schema.d.ts +261 -15
  193. package/dist/config/schema.d.ts.map +1 -1
  194. package/dist/config/schema.js +90 -8
  195. package/dist/config/schema.js.map +1 -1
  196. package/dist/github/client.d.ts +21 -1
  197. package/dist/github/client.d.ts.map +1 -1
  198. package/dist/github/client.js +46 -7
  199. package/dist/github/client.js.map +1 -1
  200. package/dist/github/webhook.d.ts +4 -0
  201. package/dist/github/webhook.d.ts.map +1 -1
  202. package/dist/github/webhook.js.map +1 -1
  203. package/dist/issues/ticket-ref.d.ts.map +1 -1
  204. package/dist/issues/ticket-ref.js +6 -5
  205. package/dist/issues/ticket-ref.js.map +1 -1
  206. package/dist/lib/annotation.d.ts +7 -0
  207. package/dist/lib/annotation.d.ts.map +1 -1
  208. package/dist/lib/annotation.js +11 -1
  209. package/dist/lib/annotation.js.map +1 -1
  210. package/dist/lib/board.d.ts +3 -0
  211. package/dist/lib/board.d.ts.map +1 -1
  212. package/dist/lib/board.js +4 -2
  213. package/dist/lib/board.js.map +1 -1
  214. package/dist/lib/clone.d.ts +1 -0
  215. package/dist/lib/clone.d.ts.map +1 -1
  216. package/dist/lib/clone.js +32 -10
  217. package/dist/lib/clone.js.map +1 -1
  218. package/dist/lib/comment-bodies.d.ts +37 -0
  219. package/dist/lib/comment-bodies.d.ts.map +1 -1
  220. package/dist/lib/comment-bodies.js +47 -9
  221. package/dist/lib/comment-bodies.js.map +1 -1
  222. package/dist/lib/repo-picker.d.ts +3 -0
  223. package/dist/lib/repo-picker.d.ts.map +1 -1
  224. package/dist/lib/repo-picker.js +45 -9
  225. package/dist/lib/repo-picker.js.map +1 -1
  226. package/dist/lib/repository-guidance.d.ts +2 -0
  227. package/dist/lib/repository-guidance.d.ts.map +1 -0
  228. package/dist/lib/repository-guidance.js +55 -0
  229. package/dist/lib/repository-guidance.js.map +1 -0
  230. package/dist/lib/review-models.d.ts +15 -2
  231. package/dist/lib/review-models.d.ts.map +1 -1
  232. package/dist/lib/review-models.js +26 -6
  233. package/dist/lib/review-models.js.map +1 -1
  234. package/dist/lib/review-strategy.d.ts +92 -0
  235. package/dist/lib/review-strategy.d.ts.map +1 -0
  236. package/dist/lib/review-strategy.js +282 -0
  237. package/dist/lib/review-strategy.js.map +1 -0
  238. package/dist/lib/runner.d.ts +92 -0
  239. package/dist/lib/runner.d.ts.map +1 -1
  240. package/dist/lib/runner.js +470 -54
  241. package/dist/lib/runner.js.map +1 -1
  242. package/dist/lib/workflow.d.ts +9 -0
  243. package/dist/lib/workflow.d.ts.map +1 -1
  244. package/dist/lib/workflow.js +20 -0
  245. package/dist/lib/workflow.js.map +1 -1
  246. package/dist/linear/client.d.ts +18 -0
  247. package/dist/linear/client.d.ts.map +1 -0
  248. package/dist/linear/client.js +67 -0
  249. package/dist/linear/client.js.map +1 -0
  250. package/dist/linear/comment.d.ts +20 -0
  251. package/dist/linear/comment.d.ts.map +1 -0
  252. package/dist/linear/comment.js +57 -0
  253. package/dist/linear/comment.js.map +1 -0
  254. package/dist/linear/identity.d.ts +59 -0
  255. package/dist/linear/identity.d.ts.map +1 -0
  256. package/dist/linear/identity.js +187 -0
  257. package/dist/linear/identity.js.map +1 -0
  258. package/dist/linear/notify.d.ts +35 -0
  259. package/dist/linear/notify.d.ts.map +1 -0
  260. package/dist/linear/notify.js +76 -0
  261. package/dist/linear/notify.js.map +1 -0
  262. package/dist/linear/ref.d.ts +13 -0
  263. package/dist/linear/ref.d.ts.map +1 -0
  264. package/dist/linear/ref.js +90 -0
  265. package/dist/linear/ref.js.map +1 -0
  266. package/dist/linear/verify.d.ts +26 -0
  267. package/dist/linear/verify.d.ts.map +1 -0
  268. package/dist/linear/verify.js +67 -0
  269. package/dist/linear/verify.js.map +1 -0
  270. package/dist/reviewers/claude.d.ts +4 -1
  271. package/dist/reviewers/claude.d.ts.map +1 -1
  272. package/dist/reviewers/claude.js +39 -7
  273. package/dist/reviewers/claude.js.map +1 -1
  274. package/dist/reviewers/codex.d.ts +3 -1
  275. package/dist/reviewers/codex.d.ts.map +1 -1
  276. package/dist/reviewers/codex.js +76 -70
  277. package/dist/reviewers/codex.js.map +1 -1
  278. package/dist/reviewers/conflict-resolve.d.ts +3 -1
  279. package/dist/reviewers/conflict-resolve.d.ts.map +1 -1
  280. package/dist/reviewers/conflict-resolve.js +21 -6
  281. package/dist/reviewers/conflict-resolve.js.map +1 -1
  282. package/dist/reviewers/fix.d.ts +5 -2
  283. package/dist/reviewers/fix.d.ts.map +1 -1
  284. package/dist/reviewers/fix.js +26 -10
  285. package/dist/reviewers/fix.js.map +1 -1
  286. package/dist/skills/attribution.d.ts +4 -0
  287. package/dist/skills/attribution.d.ts.map +1 -0
  288. package/dist/skills/attribution.js +14 -0
  289. package/dist/skills/attribution.js.map +1 -0
  290. package/dist/skills/broker-server.d.ts +2 -0
  291. package/dist/skills/broker-server.d.ts.map +1 -0
  292. package/dist/skills/broker-server.js +17 -0
  293. package/dist/skills/broker-server.js.map +1 -0
  294. package/dist/skills/broker.d.ts +42 -0
  295. package/dist/skills/broker.d.ts.map +1 -0
  296. package/dist/skills/broker.js +285 -0
  297. package/dist/skills/broker.js.map +1 -0
  298. package/dist/skills/catalog.d.ts +28 -0
  299. package/dist/skills/catalog.d.ts.map +1 -0
  300. package/dist/skills/catalog.js +104 -0
  301. package/dist/skills/catalog.js.map +1 -0
  302. package/dist/skills/installer.d.ts +10 -0
  303. package/dist/skills/installer.d.ts.map +1 -0
  304. package/dist/skills/installer.js +138 -0
  305. package/dist/skills/installer.js.map +1 -0
  306. package/dist/skills/integrity.d.ts +4 -0
  307. package/dist/skills/integrity.d.ts.map +1 -0
  308. package/dist/skills/integrity.js +36 -0
  309. package/dist/skills/integrity.js.map +1 -0
  310. package/docs/dynamic-thoroughness.md +738 -0
  311. package/docs/linear-identity-contract.md +139 -0
  312. package/docs/linear-identity.md +293 -0
  313. package/get-started.md +207 -11
  314. package/package.json +4 -3
@@ -0,0 +1,104 @@
1
+ import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
2
+ import { join } from 'path';
3
+ import { fileURLToPath } from 'url';
4
+ import { homedir } from 'os';
5
+ import yaml from 'js-yaml';
6
+ import { computeSkillIntegrity } from './integrity.js';
7
+ export const RECOMMENDED_SKILL_NAMES = ['code-review-skill', 'codebase-design', 'diagnosing-bugs'];
8
+ export const BUNDLED_SKILL_RECOMMENDATIONS = {
9
+ 'code-review': 'Best for evidence-rich repositories with documented standards and a clear issue or PRD; checks Standards and Spec separately.',
10
+ 'code-review-skill': 'Best general default for broad language, correctness, security, performance, and architecture coverage.',
11
+ 'codebase-design': 'Best for architecture-heavy changes: deep modules, small interfaces, clean seams, and testability.',
12
+ 'diagnosing-bugs': 'Best for hard bugs and regressions: requires a reproducible signal, ranked hypotheses, and regression evidence.',
13
+ };
14
+ const COMPETING_SKILLS = {
15
+ 'code-review': ['code-review-skill'],
16
+ 'code-review-skill': ['code-review'],
17
+ };
18
+ export function findCompetingSkill(skillName, selectedNames) {
19
+ return COMPETING_SKILLS[skillName]?.find(name => selectedNames.includes(name));
20
+ }
21
+ const BUNDLED_SKILLS_DIR = fileURLToPath(new URL('../../assets/skills/', import.meta.url));
22
+ export const INSTALLED_SKILLS_DIR = join(homedir(), '.crosscheck', 'skills');
23
+ export function readSkillFrontmatter(skillPath) {
24
+ const content = readFileSync(join(skillPath, 'SKILL.md'), 'utf8');
25
+ const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
26
+ if (!match)
27
+ return {};
28
+ const parsed = yaml.load(match[1]);
29
+ return typeof parsed === 'object' && parsed !== null ? parsed : {};
30
+ }
31
+ export function isValidSkillAuthor(value) {
32
+ return typeof value === 'string' && /^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,37}[a-zA-Z0-9])?$/.test(value);
33
+ }
34
+ export function isValidSkillLicense(value) {
35
+ return typeof value === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9.+() -]{0,99}$/.test(value);
36
+ }
37
+ function isSkillReceipt(value) {
38
+ if (typeof value !== 'object' || value === null)
39
+ return false;
40
+ const receipt = value;
41
+ return receipt.schemaVersion === 1
42
+ && typeof receipt.name === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(receipt.name)
43
+ && isValidSkillAuthor(receipt.author)
44
+ && isValidSkillLicense(receipt.license)
45
+ && typeof receipt.source === 'string' && receipt.source.length > 0
46
+ && typeof receipt.revision === 'string' && receipt.revision.length > 0
47
+ && typeof receipt.integrity === 'string' && /^sha256:[0-9a-f]{64}$/.test(receipt.integrity);
48
+ }
49
+ function loadSkills(rootDir, skipInvalid) {
50
+ if (!existsSync(rootDir))
51
+ return [];
52
+ return readdirSync(rootDir, { withFileTypes: true })
53
+ .filter(entry => entry.isDirectory() && !entry.name.startsWith('.'))
54
+ .flatMap(entry => {
55
+ const path = join(rootDir, entry.name);
56
+ try {
57
+ const receiptPath = join(path, '.crosscheck-skill.json');
58
+ if (statSync(receiptPath).size > 64 * 1024)
59
+ throw new Error(`Invalid skill receipt: ${entry.name}`);
60
+ const integrity = computeSkillIntegrity(path);
61
+ const receipt = JSON.parse(readFileSync(receiptPath, 'utf8'));
62
+ const frontmatter = readSkillFrontmatter(path);
63
+ if (!isSkillReceipt(receipt) || receipt.name !== entry.name || frontmatter.name !== receipt.name
64
+ || typeof frontmatter.description !== 'string' || !frontmatter.description.trim()
65
+ || integrity !== receipt.integrity) {
66
+ throw new Error(`Invalid skill package: ${entry.name}`);
67
+ }
68
+ return [{
69
+ name: receipt.name,
70
+ description: frontmatter.description.trim(),
71
+ author: receipt.author,
72
+ license: receipt.license,
73
+ source: receipt.source,
74
+ revision: receipt.revision,
75
+ integrity: receipt.integrity,
76
+ path,
77
+ }];
78
+ }
79
+ catch (err) {
80
+ if (skipInvalid)
81
+ return [];
82
+ throw err;
83
+ }
84
+ })
85
+ .sort((a, b) => a.name.localeCompare(b.name));
86
+ }
87
+ export function loadBundledSkills(rootDir = BUNDLED_SKILLS_DIR) {
88
+ return loadSkills(rootDir, false);
89
+ }
90
+ export function loadInstalledSkills(rootDir = INSTALLED_SKILLS_DIR) {
91
+ return loadSkills(rootDir, true);
92
+ }
93
+ export function loadSkillCatalog(installedRoot = INSTALLED_SKILLS_DIR) {
94
+ const skills = new Map(loadBundledSkills().map(skill => [skill.name, skill]));
95
+ for (const skill of loadInstalledSkills(installedRoot)) {
96
+ if (!skills.has(skill.name))
97
+ skills.set(skill.name, skill);
98
+ }
99
+ return [...skills.values()].sort((a, b) => a.name.localeCompare(b.name));
100
+ }
101
+ export function formatSkillIdentity(skill) {
102
+ return `${skill.name} (by @${skill.author}, ${skill.license})`;
103
+ }
104
+ //# sourceMappingURL=catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/skills/catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type SkillIdentity } from './catalog.js';
2
+ export { computeSkillIntegrity } from './integrity.js';
3
+ export interface InstallSkillOptions {
4
+ installDir?: string;
5
+ }
6
+ export declare class SkillInstallError extends Error {
7
+ }
8
+ export declare function redactSkillSource(source: string): string;
9
+ export declare function installSkill(source: string, opts?: InstallSkillOptions): Promise<SkillIdentity>;
10
+ //# sourceMappingURL=installer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+H,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAG9K,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYxD;AAuCD,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgEzG"}
@@ -0,0 +1,138 @@
1
+ import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'fs';
2
+ import { basename, join, resolve } from 'path';
3
+ import { tmpdir } from 'os';
4
+ import { execa } from 'execa';
5
+ import { INSTALLED_SKILLS_DIR, isValidSkillAuthor, isValidSkillLicense, loadBundledSkills, loadInstalledSkills, readSkillFrontmatter } from './catalog.js';
6
+ import { computeSkillIntegrity } from './integrity.js';
7
+ export { computeSkillIntegrity } from './integrity.js';
8
+ export class SkillInstallError extends Error {
9
+ }
10
+ export function redactSkillSource(source) {
11
+ if (existsSync(source))
12
+ return resolve(source);
13
+ try {
14
+ const url = new URL(source);
15
+ url.username = '';
16
+ url.password = '';
17
+ url.search = '';
18
+ url.hash = '';
19
+ return url.toString();
20
+ }
21
+ catch {
22
+ return source;
23
+ }
24
+ }
25
+ function detectLicense(rootDir, declared) {
26
+ if (typeof declared === 'string' && declared.trim())
27
+ return declared.trim();
28
+ const licenseName = ['LICENSE', 'LICENSE.md', 'COPYING'].find(name => existsSync(join(rootDir, name)));
29
+ if (!licenseName)
30
+ return 'UNKNOWN';
31
+ const license = readFileSync(join(rootDir, licenseName), 'utf8');
32
+ if (/MIT License/i.test(license))
33
+ return 'MIT';
34
+ if (/Apache License[\s\S]*Version 2\.0/i.test(license))
35
+ return 'Apache-2.0';
36
+ if (/BSD 3-Clause/i.test(license))
37
+ return 'BSD-3-Clause';
38
+ if (/ISC License/i.test(license))
39
+ return 'ISC';
40
+ return 'UNKNOWN';
41
+ }
42
+ function detectAuthor(source, declared) {
43
+ if (typeof declared === 'string' && declared.trim())
44
+ return declared.trim().replace(/^@/, '');
45
+ return /github\.com[/:]([^/]+)/i.exec(source)?.[1] ?? 'local';
46
+ }
47
+ async function checkoutSource(source) {
48
+ if (existsSync(source)) {
49
+ const path = resolve(source);
50
+ if (lstatSync(path).isSymbolicLink())
51
+ throw new SkillInstallError('Skill source cannot be a symbolic link');
52
+ if (!statSync(path).isDirectory())
53
+ throw new SkillInstallError(`Skill source is not a directory: ${source}`);
54
+ return { path, revision: 'local' };
55
+ }
56
+ const cleanup = mkdtempSync(join(tmpdir(), 'crosscheck-skill-clone-'));
57
+ const path = join(cleanup, 'source');
58
+ try {
59
+ await execa('git', ['clone', '--depth', '1', source, path]);
60
+ const revision = (await execa('git', ['-C', path, 'rev-parse', 'HEAD'])).stdout.trim();
61
+ return { path, revision, cleanup };
62
+ }
63
+ catch (err) {
64
+ rmSync(cleanup, { recursive: true, force: true });
65
+ throw new SkillInstallError(`Could not clone skill source: ${err instanceof Error ? err.message : String(err)}`);
66
+ }
67
+ }
68
+ export async function installSkill(source, opts = {}) {
69
+ const installDir = resolve(opts.installDir ?? INSTALLED_SKILLS_DIR);
70
+ const checkout = await checkoutSource(source);
71
+ try {
72
+ if (!existsSync(join(checkout.path, 'SKILL.md'))) {
73
+ throw new SkillInstallError('Skill package must contain SKILL.md');
74
+ }
75
+ try {
76
+ computeSkillIntegrity(checkout.path);
77
+ }
78
+ catch (err) {
79
+ throw new SkillInstallError(err instanceof Error ? err.message : String(err));
80
+ }
81
+ let frontmatter;
82
+ try {
83
+ frontmatter = readSkillFrontmatter(checkout.path);
84
+ }
85
+ catch (err) {
86
+ throw new SkillInstallError(`Invalid SKILL.md frontmatter: ${err instanceof Error ? err.message : String(err)}`);
87
+ }
88
+ const name = typeof frontmatter.name === 'string' ? frontmatter.name : '';
89
+ if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) {
90
+ throw new SkillInstallError(`Invalid skill name: ${name || '(missing)'}`);
91
+ }
92
+ if (typeof frontmatter.description !== 'string' || !frontmatter.description.trim()) {
93
+ throw new SkillInstallError('Skill frontmatter must include a description');
94
+ }
95
+ if (loadBundledSkills().some(skill => skill.name === name)) {
96
+ throw new SkillInstallError(`Skill ${name} is already bundled with Crosscheck`);
97
+ }
98
+ mkdirSync(installDir, { recursive: true });
99
+ const target = join(installDir, name);
100
+ if (existsSync(target)) {
101
+ throw new SkillInstallError(`Skill ${name} is already installed`);
102
+ }
103
+ const pendingTarget = join(installDir, `.install-${name}-${process.pid}`);
104
+ try {
105
+ cpSync(checkout.path, pendingTarget, {
106
+ recursive: true,
107
+ filter: path => basename(path) !== '.git' && basename(path) !== '.crosscheck-skill.json',
108
+ });
109
+ const author = detectAuthor(source, frontmatter.author);
110
+ const license = detectLicense(checkout.path, frontmatter.license);
111
+ if (!isValidSkillAuthor(author))
112
+ throw new SkillInstallError(`Invalid skill author: ${author}`);
113
+ if (!isValidSkillLicense(license))
114
+ throw new SkillInstallError(`Invalid skill license: ${license}`);
115
+ const receipt = {
116
+ schemaVersion: 1,
117
+ name,
118
+ author,
119
+ license,
120
+ source: redactSkillSource(source),
121
+ revision: checkout.revision,
122
+ integrity: computeSkillIntegrity(pendingTarget),
123
+ };
124
+ writeFileSync(join(pendingTarget, '.crosscheck-skill.json'), `${JSON.stringify(receipt, null, 2)}\n`);
125
+ renameSync(pendingTarget, target);
126
+ return loadInstalledSkills(installDir).find(skill => skill.name === name);
127
+ }
128
+ catch (err) {
129
+ rmSync(pendingTarget, { recursive: true, force: true });
130
+ throw err;
131
+ }
132
+ }
133
+ finally {
134
+ if (checkout.cleanup)
135
+ rmSync(checkout.cleanup, { recursive: true, force: true });
136
+ }
137
+ }
138
+ //# sourceMappingURL=installer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare const MAX_SKILL_PACKAGE_FILES = 1000;
2
+ export declare const MAX_SKILL_PACKAGE_BYTES: number;
3
+ export declare function computeSkillIntegrity(rootDir: string): string;
4
+ //# sourceMappingURL=integrity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../src/skills/integrity.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAC5C,eAAO,MAAM,uBAAuB,QAAmB,CAAA;AAevD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc7D"}
@@ -0,0 +1,36 @@
1
+ import { createHash } from 'crypto';
2
+ import { lstatSync, readFileSync, readdirSync, statSync } from 'fs';
3
+ import { join, relative, sep } from 'path';
4
+ export const MAX_SKILL_PACKAGE_FILES = 1_000;
5
+ export const MAX_SKILL_PACKAGE_BYTES = 10 * 1024 * 1024;
6
+ function packageFiles(rootDir, currentDir, files) {
7
+ for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
8
+ if (entry.name === '.git' || entry.name === '.crosscheck-skill.json')
9
+ continue;
10
+ const path = join(currentDir, entry.name);
11
+ if (lstatSync(path).isSymbolicLink())
12
+ throw new Error('Skill packages cannot contain symbolic links');
13
+ if (entry.isDirectory())
14
+ packageFiles(rootDir, path, files);
15
+ else if (entry.isFile()) {
16
+ files.push(path);
17
+ if (files.length > MAX_SKILL_PACKAGE_FILES)
18
+ throw new Error(`Skill packages cannot contain more than ${MAX_SKILL_PACKAGE_FILES} files`);
19
+ }
20
+ }
21
+ }
22
+ export function computeSkillIntegrity(rootDir) {
23
+ const files = [];
24
+ packageFiles(rootDir, rootDir, files);
25
+ files.sort((a, b) => relative(rootDir, a).localeCompare(relative(rootDir, b)));
26
+ const totalBytes = files.reduce((sum, path) => sum + statSync(path).size, 0);
27
+ if (totalBytes > MAX_SKILL_PACKAGE_BYTES)
28
+ throw new Error('Skill packages cannot exceed 10 MiB');
29
+ const hash = createHash('sha256');
30
+ for (const path of files) {
31
+ hash.update(relative(rootDir, path).split(sep).join('/')).update('\0');
32
+ hash.update(readFileSync(path)).update('\0');
33
+ }
34
+ return `sha256:${hash.digest('hex')}`;
35
+ }
36
+ //# sourceMappingURL=integrity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integrity.js","sourceRoot":"","sources":["../../src/skills/integrity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;AACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvD,SAAS,YAAY,CAAC,OAAe,EAAE,UAAkB,EAAE,KAAe;IACxE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB;YAAE,SAAQ;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACrG,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;aACtD,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChB,IAAI,KAAK,CAAC,MAAM,GAAG,uBAAuB;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,uBAAuB,QAAQ,CAAC,CAAA;QACzI,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACrC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAE9E,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5E,IAAI,UAAU,GAAG,uBAAuB;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IAEhG,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AACvC,CAAC"}