octocode-cli 1.2.5 → 1.2.7

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 (303) hide show
  1. package/LICENSE +21 -63
  2. package/README.md +86 -109
  3. package/out/octocode-cli.js +7027 -7014
  4. package/package.json +8 -6
  5. package/skills/README.md +97 -120
  6. package/skills/octocode-code-engineer/.claude/settings.local.json +18 -0
  7. package/skills/octocode-code-engineer/.octocode/rfc/RFC-code-engineer-weakness-fixes.md +255 -0
  8. package/skills/octocode-code-engineer/.plan/VALIDATED_PLAN.md +223 -0
  9. package/skills/octocode-code-engineer/README.md +178 -0
  10. package/skills/octocode-code-engineer/SKILL.md +418 -0
  11. package/skills/octocode-code-engineer/coverage/architecture.ts.html +7828 -0
  12. package/skills/octocode-code-engineer/coverage/ast-helpers.ts.html +211 -0
  13. package/skills/octocode-code-engineer/coverage/ast-search.ts.html +1795 -0
  14. package/skills/octocode-code-engineer/coverage/base.css +224 -0
  15. package/skills/octocode-code-engineer/coverage/block-navigation.js +87 -0
  16. package/skills/octocode-code-engineer/coverage/cache.ts.html +376 -0
  17. package/skills/octocode-code-engineer/coverage/cli.ts.html +982 -0
  18. package/skills/octocode-code-engineer/coverage/clover.xml +3217 -0
  19. package/skills/octocode-code-engineer/coverage/collect-effects.ts.html +664 -0
  20. package/skills/octocode-code-engineer/coverage/collect-input-sources.ts.html +577 -0
  21. package/skills/octocode-code-engineer/coverage/collect-performance.ts.html +331 -0
  22. package/skills/octocode-code-engineer/coverage/collect-prototype-pollution.ts.html +421 -0
  23. package/skills/octocode-code-engineer/coverage/collect-security.ts.html +604 -0
  24. package/skills/octocode-code-engineer/coverage/collect-test-profile.ts.html +589 -0
  25. package/skills/octocode-code-engineer/coverage/coverage-final.json +30 -0
  26. package/skills/octocode-code-engineer/coverage/dependencies.ts.html +997 -0
  27. package/skills/octocode-code-engineer/coverage/dependency-summary.ts.html +688 -0
  28. package/skills/octocode-code-engineer/coverage/discovery.ts.html +322 -0
  29. package/skills/octocode-code-engineer/coverage/favicon.png +0 -0
  30. package/skills/octocode-code-engineer/coverage/graph-analytics.ts.html +1510 -0
  31. package/skills/octocode-code-engineer/coverage/index.html +536 -0
  32. package/skills/octocode-code-engineer/coverage/index.ts.html +826 -0
  33. package/skills/octocode-code-engineer/coverage/metrics.ts.html +553 -0
  34. package/skills/octocode-code-engineer/coverage/pipeline.ts.html +2044 -0
  35. package/skills/octocode-code-engineer/coverage/prettify.css +1 -0
  36. package/skills/octocode-code-engineer/coverage/prettify.js +2 -0
  37. package/skills/octocode-code-engineer/coverage/report-analysis.ts.html +1570 -0
  38. package/skills/octocode-code-engineer/coverage/report-writer.ts.html +1102 -0
  39. package/skills/octocode-code-engineer/coverage/security-detectors.ts.html +1747 -0
  40. package/skills/octocode-code-engineer/coverage/semantic-detectors.ts.html +2152 -0
  41. package/skills/octocode-code-engineer/coverage/semantic.ts.html +1897 -0
  42. package/skills/octocode-code-engineer/coverage/sort-arrow-sprite.png +0 -0
  43. package/skills/octocode-code-engineer/coverage/sorter.js +210 -0
  44. package/skills/octocode-code-engineer/coverage/summary-md.ts.html +1222 -0
  45. package/skills/octocode-code-engineer/coverage/test-quality-detectors.ts.html +1039 -0
  46. package/skills/octocode-code-engineer/coverage/tree-sitter-analyzer.ts.html +955 -0
  47. package/skills/octocode-code-engineer/coverage/ts-analyzer.ts.html +1213 -0
  48. package/skills/octocode-code-engineer/coverage/types.ts.html +2473 -0
  49. package/skills/octocode-code-engineer/coverage/utils.ts.html +820 -0
  50. package/skills/octocode-code-engineer/eslint.config.mjs +54 -0
  51. package/skills/octocode-code-engineer/minify-scripts.mjs +32 -0
  52. package/skills/octocode-code-engineer/package.json +54 -0
  53. package/skills/octocode-code-engineer/references/agent-ast-reading-rfc.md +95 -0
  54. package/skills/octocode-code-engineer/references/architecture-techniques.md +121 -0
  55. package/skills/octocode-code-engineer/references/ast-search.md +210 -0
  56. package/skills/octocode-code-engineer/references/ast-tree-search.md +151 -0
  57. package/skills/octocode-code-engineer/references/cli-reference.md +167 -0
  58. package/skills/octocode-code-engineer/references/concepts.md +107 -0
  59. package/skills/octocode-code-engineer/references/finding-categories.md +128 -0
  60. package/skills/octocode-code-engineer/references/improvement-roadmap.md +304 -0
  61. package/skills/octocode-code-engineer/references/output-files.md +144 -0
  62. package/skills/octocode-code-engineer/references/playbooks.md +204 -0
  63. package/skills/octocode-code-engineer/references/present-results.md +136 -0
  64. package/skills/octocode-code-engineer/references/tool-workflows.md +566 -0
  65. package/skills/octocode-code-engineer/references/validate-investigate.md +225 -0
  66. package/skills/octocode-code-engineer/scripts/analysis/dependencies.js +1 -0
  67. package/skills/octocode-code-engineer/scripts/analysis/dependency-summary.js +1 -0
  68. package/skills/octocode-code-engineer/scripts/analysis/discovery.js +1 -0
  69. package/skills/octocode-code-engineer/scripts/analysis/graph-analytics.js +1 -0
  70. package/skills/octocode-code-engineer/scripts/analysis/semantic.js +1 -0
  71. package/skills/octocode-code-engineer/scripts/ast/helpers.js +1 -0
  72. package/skills/octocode-code-engineer/scripts/ast/metrics.js +1 -0
  73. package/skills/octocode-code-engineer/scripts/ast/search.js +2 -0
  74. package/skills/octocode-code-engineer/scripts/ast/tree-search.js +2 -0
  75. package/skills/octocode-code-engineer/scripts/ast/tree-sitter.js +1 -0
  76. package/skills/octocode-code-engineer/scripts/ast/ts-analyzer.js +1 -0
  77. package/skills/octocode-code-engineer/scripts/collectors/chains.js +1 -0
  78. package/skills/octocode-code-engineer/scripts/collectors/effects.js +1 -0
  79. package/skills/octocode-code-engineer/scripts/collectors/input-sources.js +1 -0
  80. package/skills/octocode-code-engineer/scripts/collectors/performance.js +1 -0
  81. package/skills/octocode-code-engineer/scripts/collectors/prototype-pollution.js +1 -0
  82. package/skills/octocode-code-engineer/scripts/collectors/security.js +1 -0
  83. package/skills/octocode-code-engineer/scripts/collectors/test-profile.js +1 -0
  84. package/skills/octocode-code-engineer/scripts/common/is-direct-run.js +1 -0
  85. package/skills/octocode-code-engineer/scripts/common/utils.js +1 -0
  86. package/skills/octocode-code-engineer/scripts/detectors/code-quality.js +1 -0
  87. package/skills/octocode-code-engineer/scripts/detectors/cohesion.js +1 -0
  88. package/skills/octocode-code-engineer/scripts/detectors/coupling.js +1 -0
  89. package/skills/octocode-code-engineer/scripts/detectors/cycle.js +1 -0
  90. package/skills/octocode-code-engineer/scripts/detectors/dead-code.js +1 -0
  91. package/skills/octocode-code-engineer/scripts/detectors/import-style.js +1 -0
  92. package/skills/octocode-code-engineer/scripts/detectors/index.js +1 -0
  93. package/skills/octocode-code-engineer/scripts/detectors/security.js +1 -0
  94. package/skills/octocode-code-engineer/scripts/detectors/semantic.js +1 -0
  95. package/skills/octocode-code-engineer/scripts/detectors/shared.js +1 -0
  96. package/skills/octocode-code-engineer/scripts/detectors/test-quality.js +1 -0
  97. package/skills/octocode-code-engineer/scripts/index.js +1 -0
  98. package/skills/octocode-code-engineer/scripts/pipeline/cache.js +1 -0
  99. package/skills/octocode-code-engineer/scripts/pipeline/cli.js +1 -0
  100. package/skills/octocode-code-engineer/scripts/pipeline/main.js +2 -0
  101. package/skills/octocode-code-engineer/scripts/reporting/analysis.js +1 -0
  102. package/skills/octocode-code-engineer/scripts/reporting/summary-md.js +1 -0
  103. package/skills/octocode-code-engineer/scripts/reporting/writer.js +1 -0
  104. package/skills/octocode-code-engineer/scripts/types/constants.js +1 -0
  105. package/skills/octocode-code-engineer/scripts/types/index.js +1 -0
  106. package/skills/octocode-code-engineer/scripts/types/interfaces.js +1 -0
  107. package/skills/octocode-code-engineer/src/analysis/dependencies.test.ts +545 -0
  108. package/skills/octocode-code-engineer/src/analysis/dependencies.ts +406 -0
  109. package/skills/octocode-code-engineer/src/analysis/dependency-summary.test.ts +566 -0
  110. package/skills/octocode-code-engineer/src/analysis/dependency-summary.ts +257 -0
  111. package/skills/octocode-code-engineer/src/analysis/discovery.test.ts +420 -0
  112. package/skills/octocode-code-engineer/src/analysis/discovery.ts +87 -0
  113. package/skills/octocode-code-engineer/src/analysis/graph-analytics.test.ts +449 -0
  114. package/skills/octocode-code-engineer/src/analysis/graph-analytics.ts +534 -0
  115. package/skills/octocode-code-engineer/src/analysis/semantic.test.ts +1533 -0
  116. package/skills/octocode-code-engineer/src/analysis/semantic.ts +830 -0
  117. package/skills/octocode-code-engineer/src/ast/helpers.test.ts +185 -0
  118. package/skills/octocode-code-engineer/src/ast/helpers.ts +62 -0
  119. package/skills/octocode-code-engineer/src/ast/metrics.test.ts +304 -0
  120. package/skills/octocode-code-engineer/src/ast/metrics.ts +204 -0
  121. package/skills/octocode-code-engineer/src/ast/search.test.ts +647 -0
  122. package/skills/octocode-code-engineer/src/ast/search.ts +648 -0
  123. package/skills/octocode-code-engineer/src/ast/tree-search.test.ts +199 -0
  124. package/skills/octocode-code-engineer/src/ast/tree-search.ts +392 -0
  125. package/skills/octocode-code-engineer/src/ast/tree-sitter.test.ts +407 -0
  126. package/skills/octocode-code-engineer/src/ast/tree-sitter.ts +402 -0
  127. package/skills/octocode-code-engineer/src/ast/ts-analyzer.test.ts +1864 -0
  128. package/skills/octocode-code-engineer/src/ast/ts-analyzer.ts +509 -0
  129. package/skills/octocode-code-engineer/src/collectors/chains.ts +74 -0
  130. package/skills/octocode-code-engineer/src/collectors/effects.test.ts +490 -0
  131. package/skills/octocode-code-engineer/src/collectors/effects.ts +332 -0
  132. package/skills/octocode-code-engineer/src/collectors/input-sources.test.ts +144 -0
  133. package/skills/octocode-code-engineer/src/collectors/input-sources.ts +196 -0
  134. package/skills/octocode-code-engineer/src/collectors/performance.test.ts +82 -0
  135. package/skills/octocode-code-engineer/src/collectors/performance.ts +141 -0
  136. package/skills/octocode-code-engineer/src/collectors/prototype-pollution.test.ts +55 -0
  137. package/skills/octocode-code-engineer/src/collectors/prototype-pollution.ts +162 -0
  138. package/skills/octocode-code-engineer/src/collectors/security.test.ts +124 -0
  139. package/skills/octocode-code-engineer/src/collectors/security.ts +309 -0
  140. package/skills/octocode-code-engineer/src/collectors/test-profile.test.ts +97 -0
  141. package/skills/octocode-code-engineer/src/collectors/test-profile.ts +269 -0
  142. package/skills/octocode-code-engineer/src/common/is-direct-run.test.ts +32 -0
  143. package/skills/octocode-code-engineer/src/common/is-direct-run.ts +13 -0
  144. package/skills/octocode-code-engineer/src/common/utils.test.ts +463 -0
  145. package/skills/octocode-code-engineer/src/common/utils.ts +304 -0
  146. package/skills/octocode-code-engineer/src/detectors/code-quality.ts +966 -0
  147. package/skills/octocode-code-engineer/src/detectors/cohesion.ts +539 -0
  148. package/skills/octocode-code-engineer/src/detectors/coupling.ts +323 -0
  149. package/skills/octocode-code-engineer/src/detectors/cycle.ts +349 -0
  150. package/skills/octocode-code-engineer/src/detectors/dead-code.ts +320 -0
  151. package/skills/octocode-code-engineer/src/detectors/import-style.ts +376 -0
  152. package/skills/octocode-code-engineer/src/detectors/index.test.ts +3061 -0
  153. package/skills/octocode-code-engineer/src/detectors/index.ts +88 -0
  154. package/skills/octocode-code-engineer/src/detectors/security.test.ts +882 -0
  155. package/skills/octocode-code-engineer/src/detectors/security.ts +821 -0
  156. package/skills/octocode-code-engineer/src/detectors/semantic.ts +758 -0
  157. package/skills/octocode-code-engineer/src/detectors/shared.ts +49 -0
  158. package/skills/octocode-code-engineer/src/detectors/test-quality.test.ts +388 -0
  159. package/skills/octocode-code-engineer/src/detectors/test-quality.ts +367 -0
  160. package/skills/octocode-code-engineer/src/index.test.ts +4425 -0
  161. package/skills/octocode-code-engineer/src/index.ts +403 -0
  162. package/skills/octocode-code-engineer/src/pipeline/cache.test.ts +199 -0
  163. package/skills/octocode-code-engineer/src/pipeline/cache.ts +130 -0
  164. package/skills/octocode-code-engineer/src/pipeline/cli.test.ts +493 -0
  165. package/skills/octocode-code-engineer/src/pipeline/cli.ts +344 -0
  166. package/skills/octocode-code-engineer/src/pipeline/main.test.ts +174 -0
  167. package/skills/octocode-code-engineer/src/pipeline/main.ts +1074 -0
  168. package/skills/octocode-code-engineer/src/pipeline.test.ts +84 -0
  169. package/skills/octocode-code-engineer/src/reporting/analysis.test.ts +782 -0
  170. package/skills/octocode-code-engineer/src/reporting/analysis.ts +688 -0
  171. package/skills/octocode-code-engineer/src/reporting/output-contract.test.ts +463 -0
  172. package/skills/octocode-code-engineer/src/reporting/summary-md.test.ts +421 -0
  173. package/skills/octocode-code-engineer/src/reporting/summary-md.ts +714 -0
  174. package/skills/octocode-code-engineer/src/reporting/writer.ts +430 -0
  175. package/skills/octocode-code-engineer/src/sanity.test.ts +47 -0
  176. package/skills/octocode-code-engineer/src/types/constants.ts +248 -0
  177. package/skills/octocode-code-engineer/src/types/index.ts +80 -0
  178. package/skills/octocode-code-engineer/src/types/interfaces.ts +682 -0
  179. package/skills/octocode-code-engineer/tsconfig.json +17 -0
  180. package/skills/octocode-code-engineer/vitest.config.ts +8 -0
  181. package/skills/octocode-documentation-writer/README.md +113 -0
  182. package/skills/octocode-documentation-writer/SKILL.md +886 -0
  183. package/skills/octocode-documentation-writer/references/agent-discovery-analysis.md +453 -0
  184. package/skills/octocode-documentation-writer/references/agent-documentation-writer.md +255 -0
  185. package/skills/octocode-documentation-writer/references/agent-engineer-questions.md +247 -0
  186. package/skills/octocode-documentation-writer/references/agent-orchestrator.md +370 -0
  187. package/skills/octocode-documentation-writer/references/agent-qa-validator.md +227 -0
  188. package/skills/octocode-documentation-writer/references/agent-researcher.md +250 -0
  189. package/skills/octocode-documentation-writer/schemas/analysis-schema.json +886 -0
  190. package/skills/octocode-documentation-writer/schemas/discovery-tasks.json +96 -0
  191. package/skills/octocode-documentation-writer/schemas/documentation-structure.json +373 -0
  192. package/skills/octocode-documentation-writer/schemas/partial-discovery-schema.json +102 -0
  193. package/skills/octocode-documentation-writer/schemas/partial-research-schema.json +98 -0
  194. package/skills/octocode-documentation-writer/schemas/qa-results-schema.json +113 -0
  195. package/skills/octocode-documentation-writer/schemas/questions-schema.json +228 -0
  196. package/skills/octocode-documentation-writer/schemas/research-schema.json +104 -0
  197. package/skills/octocode-documentation-writer/schemas/state-schema.json +222 -0
  198. package/skills/octocode-documentation-writer/schemas/work-assignments-schema.json +74 -0
  199. package/skills/octocode-plan/SKILL.md +122 -116
  200. package/skills/octocode-prompt-optimizer/SKILL.md +617 -0
  201. package/skills/octocode-pull-request-reviewer/README.md +249 -0
  202. package/skills/octocode-pull-request-reviewer/SKILL.md +479 -0
  203. package/skills/octocode-pull-request-reviewer/references/dependency-check.md +74 -0
  204. package/skills/octocode-pull-request-reviewer/references/domain-reviewers.md +24 -0
  205. package/skills/octocode-pull-request-reviewer/references/execution-lifecycle.md +441 -0
  206. package/skills/octocode-pull-request-reviewer/references/flow-analysis-protocol.md +64 -0
  207. package/skills/octocode-pull-request-reviewer/references/output-template.md +174 -0
  208. package/skills/octocode-pull-request-reviewer/references/parallel-agent-protocol.md +182 -0
  209. package/skills/octocode-pull-request-reviewer/references/review-guidelines.md +26 -0
  210. package/skills/octocode-pull-request-reviewer/references/verification-checklist.md +40 -0
  211. package/skills/octocode-research/.claude/settings.local.json +46 -0
  212. package/skills/octocode-research/.octocode/plan/code-review-fixes/plan.md +312 -0
  213. package/skills/octocode-research/.octocode/plan/code-review-fixes/research.md +212 -0
  214. package/skills/octocode-research/.octocode/plans/NODE_SERVER_START_PLAN.md +755 -0
  215. package/skills/octocode-research/.octocode/research/code-review/research.md +371 -0
  216. package/skills/octocode-research/.octocode/review/IMPROVEMENTS.md +391 -0
  217. package/skills/octocode-research/.octocode/review/REVIEW_PLAN.md +289 -0
  218. package/skills/octocode-research/.octocode/review/REVIEW_REPORT.md +356 -0
  219. package/skills/octocode-research/AGENTS.md +349 -0
  220. package/skills/octocode-research/README.md +494 -0
  221. package/skills/octocode-research/SKILL.md +652 -274
  222. package/skills/octocode-research/docs/API_REFERENCE.md +562 -0
  223. package/skills/octocode-research/docs/ARCHITECTURE.md +554 -0
  224. package/skills/octocode-research/docs/FLOWS.md +577 -0
  225. package/skills/octocode-research/docs/OVERVIEW.md +564 -0
  226. package/skills/octocode-research/docs/SERVER_FLOWS.md +631 -0
  227. package/skills/octocode-research/ecosystem.config.cjs +88 -0
  228. package/skills/octocode-research/eslint.config.mjs +27 -0
  229. package/skills/octocode-research/package.json +84 -0
  230. package/skills/octocode-research/references/GUARDRAILS.md +40 -0
  231. package/skills/octocode-research/references/PARALLEL_AGENT_PROTOCOL.md +178 -0
  232. package/skills/octocode-research/references/roast-prompt.md +149 -0
  233. package/skills/octocode-research/scripts/server-init.d.ts +2 -0
  234. package/skills/octocode-research/scripts/server-init.js +2 -0
  235. package/skills/octocode-research/scripts/server.d.ts +8 -0
  236. package/skills/octocode-research/scripts/server.js +445 -0
  237. package/skills/octocode-research/src/__tests__/integration/circuitBreaker.test.ts +205 -0
  238. package/skills/octocode-research/src/__tests__/integration/routes.test.ts +374 -0
  239. package/skills/octocode-research/src/__tests__/unit/circuitBreaker.test.ts +245 -0
  240. package/skills/octocode-research/src/__tests__/unit/errorHandler.test.ts +183 -0
  241. package/skills/octocode-research/src/__tests__/unit/httpPreprocess.test.ts +157 -0
  242. package/skills/octocode-research/src/__tests__/unit/logger.test.ts +143 -0
  243. package/skills/octocode-research/src/__tests__/unit/queryParser.test.ts +130 -0
  244. package/skills/octocode-research/src/__tests__/unit/responseBuilder.test.ts +469 -0
  245. package/skills/octocode-research/src/__tests__/unit/retry.test.ts +205 -0
  246. package/skills/octocode-research/src/index.ts +186 -0
  247. package/skills/octocode-research/src/mcpCache.ts +49 -0
  248. package/skills/octocode-research/src/middleware/errorHandler.ts +65 -0
  249. package/skills/octocode-research/src/middleware/logger.ts +61 -0
  250. package/skills/octocode-research/src/middleware/queryParser.ts +115 -0
  251. package/skills/octocode-research/src/middleware/readiness.ts +17 -0
  252. package/skills/octocode-research/src/routes/github.ts +197 -0
  253. package/skills/octocode-research/src/routes/local.ts +175 -0
  254. package/skills/octocode-research/src/routes/lsp.ts +177 -0
  255. package/skills/octocode-research/src/routes/package.ts +127 -0
  256. package/skills/octocode-research/src/routes/prompts.ts +138 -0
  257. package/skills/octocode-research/src/routes/tools.ts +677 -0
  258. package/skills/octocode-research/src/server-init.ts +363 -0
  259. package/skills/octocode-research/src/server.ts +285 -0
  260. package/skills/octocode-research/src/types/errorGuards.ts +151 -0
  261. package/skills/octocode-research/src/types/express.d.ts +76 -0
  262. package/skills/octocode-research/src/types/guards.ts +98 -0
  263. package/skills/octocode-research/src/types/mcp.ts +119 -0
  264. package/skills/octocode-research/src/types/responses.ts +199 -0
  265. package/skills/octocode-research/src/types/toolTypes.ts +33 -0
  266. package/skills/octocode-research/src/utils/asyncTimeout.ts +116 -0
  267. package/skills/octocode-research/src/utils/circuitBreaker.ts +492 -0
  268. package/skills/octocode-research/src/utils/colors.ts +53 -0
  269. package/skills/octocode-research/src/utils/errorQueue.ts +71 -0
  270. package/skills/octocode-research/src/utils/logEmoji.ts +103 -0
  271. package/skills/octocode-research/src/utils/logger.ts +413 -0
  272. package/skills/octocode-research/src/utils/resilience.ts +169 -0
  273. package/skills/octocode-research/src/utils/responseBuilder.ts +495 -0
  274. package/skills/octocode-research/src/utils/responseFactory.ts +100 -0
  275. package/skills/octocode-research/src/utils/responseParser.ts +272 -0
  276. package/skills/octocode-research/src/utils/retry.ts +280 -0
  277. package/skills/octocode-research/src/utils/routeFactory.ts +117 -0
  278. package/skills/octocode-research/src/utils/url.ts +20 -0
  279. package/skills/octocode-research/src/validation/httpPreprocess.ts +155 -0
  280. package/skills/octocode-research/src/validation/index.ts +2 -0
  281. package/skills/octocode-research/src/validation/schemas.ts +578 -0
  282. package/skills/octocode-research/src/validation/toolCallSchema.ts +132 -0
  283. package/skills/octocode-research/tsconfig.json +21 -0
  284. package/skills/octocode-research/tsdown.config.ts +42 -0
  285. package/skills/octocode-research/vitest.config.ts +20 -0
  286. package/skills/octocode-researcher/SKILL.md +461 -0
  287. package/skills/octocode-researcher/references/fallbacks.md +120 -0
  288. package/skills/{octocode-local-search → octocode-researcher}/references/tool-reference.md +132 -49
  289. package/skills/{octocode-local-search → octocode-researcher}/references/workflow-patterns.md +204 -4
  290. package/skills/octocode-rfc-generator/SKILL.md +223 -0
  291. package/skills/octocode-rfc-generator/references/rfc-template.md +193 -0
  292. package/skills/octocode-roast/SKILL.md +63 -21
  293. package/skills/octocode-implement/SKILL.md +0 -293
  294. package/skills/octocode-implement/references/execution-phases.md +0 -317
  295. package/skills/octocode-implement/references/tool-reference.md +0 -403
  296. package/skills/octocode-implement/references/workflow-patterns.md +0 -385
  297. package/skills/octocode-local-search/SKILL.md +0 -449
  298. package/skills/octocode-pr-review/SKILL.md +0 -391
  299. package/skills/octocode-pr-review/references/domain-reviewers.md +0 -105
  300. package/skills/octocode-pr-review/references/execution-lifecycle.md +0 -116
  301. package/skills/octocode-pr-review/references/research-flows.md +0 -75
  302. package/skills/octocode-research/references/tool-reference.md +0 -304
  303. package/skills/octocode-research/references/workflow-patterns.md +0 -325
@@ -0,0 +1,882 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import {
4
+ detectCommandInjectionRisk,
5
+ detectEvalUsage,
6
+ detectHardcodedSecrets,
7
+ detectInputPassthroughRisk,
8
+ detectPathTraversalRisk,
9
+ detectPrototypePollutionRisk,
10
+ detectSqlInjectionRisk,
11
+ detectUnsafeHtml,
12
+ detectUnsafeRegex,
13
+ detectUnvalidatedInputSink,
14
+ } from './security.js';
15
+
16
+ import type { FileEntry, InputSourceInfo } from '../types/index.js';
17
+
18
+ function makeFileEntry(override: Partial<FileEntry> = {}): FileEntry {
19
+ return {
20
+ file: override.file ?? 'src/app.ts',
21
+ package: override.package ?? 'my-pkg',
22
+ parseEngine: override.parseEngine ?? 'typescript',
23
+ nodeCount: override.nodeCount ?? 100,
24
+ kindCounts: override.kindCounts ?? {},
25
+ functions: override.functions ?? [],
26
+ flows: override.flows ?? [],
27
+ dependencyProfile: override.dependencyProfile ?? {
28
+ internalDependencies: [],
29
+ externalDependencies: [],
30
+ unresolvedDependencies: [],
31
+ declaredExports: [],
32
+ importedSymbols: [],
33
+ reExports: [],
34
+ },
35
+ ...override,
36
+ };
37
+ }
38
+
39
+ function makeInputSource(
40
+ override: Partial<InputSourceInfo> = {}
41
+ ): InputSourceInfo {
42
+ return {
43
+ functionName: override.functionName ?? 'handleRequest',
44
+ lineStart: override.lineStart ?? 10,
45
+ lineEnd: override.lineEnd ?? 30,
46
+ sourceParams: override.sourceParams ?? ['userInput'],
47
+ hasSinkInBody: override.hasSinkInBody ?? false,
48
+ sinkKinds: override.sinkKinds ?? [],
49
+ hasValidation: override.hasValidation ?? false,
50
+ callsWithInputArgs: override.callsWithInputArgs ?? [],
51
+ paramConfidence: override.paramConfidence ?? 'high',
52
+ ...override,
53
+ };
54
+ }
55
+
56
+ describe('detectHardcodedSecrets', () => {
57
+ it('detects a hardcoded secret with literal context', () => {
58
+ const files = [
59
+ makeFileEntry({
60
+ suspiciousStrings: [
61
+ {
62
+ lineStart: 5,
63
+ lineEnd: 5,
64
+ kind: 'hardcoded-secret',
65
+ context: 'literal',
66
+ snippet: 'AKIAIOSFODNN7EXAMPLE',
67
+ },
68
+ ],
69
+ }),
70
+ ];
71
+ const findings = detectHardcodedSecrets(files);
72
+ expect(findings).toHaveLength(1);
73
+ expect(findings[0].category).toBe('hardcoded-secret');
74
+ expect(findings[0].severity).toBe('high');
75
+ expect(findings[0].title).toContain('Potential hardcoded secret');
76
+ });
77
+
78
+ it('detects a secret-assignment context', () => {
79
+ const files = [
80
+ makeFileEntry({
81
+ suspiciousStrings: [
82
+ {
83
+ lineStart: 10,
84
+ lineEnd: 10,
85
+ kind: 'hardcoded-secret',
86
+ context: 'literal',
87
+ snippet: 'password=supersecret123',
88
+ },
89
+ ],
90
+ }),
91
+ ];
92
+ const findings = detectHardcodedSecrets(files);
93
+ expect(findings).toHaveLength(1);
94
+ expect(findings[0].title).toContain('password=supersecret');
95
+ });
96
+
97
+ it('skips error-message context', () => {
98
+ const files = [
99
+ makeFileEntry({
100
+ suspiciousStrings: [
101
+ {
102
+ lineStart: 5,
103
+ lineEnd: 5,
104
+ kind: 'hardcoded-secret',
105
+ context: 'error-message',
106
+ snippet: 'invalid token provided for auth',
107
+ },
108
+ ],
109
+ }),
110
+ ];
111
+ const findings = detectHardcodedSecrets(files);
112
+ expect(findings).toHaveLength(0);
113
+ });
114
+
115
+ it('skips regex-definition context', () => {
116
+ const files = [
117
+ makeFileEntry({
118
+ suspiciousStrings: [
119
+ {
120
+ lineStart: 5,
121
+ lineEnd: 5,
122
+ kind: 'hardcoded-secret',
123
+ context: 'regex-definition',
124
+ snippet: '/password|secret/i',
125
+ },
126
+ ],
127
+ }),
128
+ ];
129
+ const findings = detectHardcodedSecrets(files);
130
+ expect(findings).toHaveLength(0);
131
+ });
132
+
133
+ it('skips test files', () => {
134
+ const files = [
135
+ makeFileEntry({
136
+ file: 'src/utils.test.ts',
137
+ suspiciousStrings: [
138
+ {
139
+ lineStart: 5,
140
+ lineEnd: 5,
141
+ kind: 'hardcoded-secret',
142
+ context: 'literal',
143
+ snippet: 'testSecret123',
144
+ },
145
+ ],
146
+ }),
147
+ ];
148
+ const findings = detectHardcodedSecrets(files);
149
+ expect(findings).toHaveLength(0);
150
+ });
151
+
152
+ it('returns 0 findings for empty suspiciousStrings', () => {
153
+ const files = [makeFileEntry({ suspiciousStrings: [] })];
154
+ const findings = detectHardcodedSecrets(files);
155
+ expect(findings).toHaveLength(0);
156
+ });
157
+
158
+ it('truncates snippet in title to 20 chars', () => {
159
+ const files = [
160
+ makeFileEntry({
161
+ suspiciousStrings: [
162
+ {
163
+ lineStart: 1,
164
+ lineEnd: 1,
165
+ kind: 'hardcoded-secret',
166
+ context: 'literal',
167
+ snippet: 'abcdefghijklmnopqrstuvwxyz1234567890',
168
+ },
169
+ ],
170
+ }),
171
+ ];
172
+ const findings = detectHardcodedSecrets(files);
173
+ expect(findings).toHaveLength(1);
174
+ expect(findings[0].title).toContain('abcdefghijklmnopqrst');
175
+ expect(findings[0].title).toContain('…');
176
+ });
177
+ });
178
+
179
+ describe('detectEvalUsage', () => {
180
+ it('detects eval usage', () => {
181
+ const files = [
182
+ makeFileEntry({
183
+ evalUsages: [{ file: 'src/app.ts', lineStart: 15, lineEnd: 15 }],
184
+ }),
185
+ ];
186
+ const findings = detectEvalUsage(files);
187
+ expect(findings).toHaveLength(1);
188
+ expect(findings[0].category).toBe('eval-usage');
189
+ expect(findings[0].severity).toBe('critical');
190
+ });
191
+
192
+ it('skips test files', () => {
193
+ const files = [
194
+ makeFileEntry({
195
+ file: 'src/__tests__/eval.ts',
196
+ evalUsages: [
197
+ { file: 'src/__tests__/eval.ts', lineStart: 1, lineEnd: 1 },
198
+ ],
199
+ }),
200
+ ];
201
+ const findings = detectEvalUsage(files);
202
+ expect(findings).toHaveLength(0);
203
+ });
204
+
205
+ it('returns 0 findings for empty evalUsages', () => {
206
+ const files = [makeFileEntry({ evalUsages: [] })];
207
+ const findings = detectEvalUsage(files);
208
+ expect(findings).toHaveLength(0);
209
+ });
210
+ });
211
+
212
+ describe('detectUnsafeHtml', () => {
213
+ it('detects unsafe HTML assignments', () => {
214
+ const files = [
215
+ makeFileEntry({
216
+ unsafeHtmlAssignments: [
217
+ { file: 'src/app.ts', lineStart: 20, lineEnd: 20 },
218
+ ],
219
+ }),
220
+ ];
221
+ const findings = detectUnsafeHtml(files);
222
+ expect(findings).toHaveLength(1);
223
+ expect(findings[0].category).toBe('unsafe-html');
224
+ expect(findings[0].severity).toBe('high');
225
+ });
226
+
227
+ it('skips test files', () => {
228
+ const files = [
229
+ makeFileEntry({
230
+ file: 'tests/render.spec.ts',
231
+ unsafeHtmlAssignments: [
232
+ { file: 'tests/render.spec.ts', lineStart: 5, lineEnd: 5 },
233
+ ],
234
+ }),
235
+ ];
236
+ const findings = detectUnsafeHtml(files);
237
+ expect(findings).toHaveLength(0);
238
+ });
239
+
240
+ it('returns 0 findings for empty unsafeHtmlAssignments', () => {
241
+ const files = [makeFileEntry({ unsafeHtmlAssignments: [] })];
242
+ const findings = detectUnsafeHtml(files);
243
+ expect(findings).toHaveLength(0);
244
+ });
245
+ });
246
+
247
+ describe('detectSqlInjectionRisk', () => {
248
+ it('detects sql-injection kind suspicious string', () => {
249
+ const files = [
250
+ makeFileEntry({
251
+ suspiciousStrings: [
252
+ {
253
+ lineStart: 30,
254
+ lineEnd: 30,
255
+ kind: 'sql-injection',
256
+ snippet: 'SELECT * FROM users WHERE id=${userId}',
257
+ },
258
+ ],
259
+ }),
260
+ ];
261
+ const findings = detectSqlInjectionRisk(files);
262
+ expect(findings).toHaveLength(1);
263
+ expect(findings[0].category).toBe('sql-injection-risk');
264
+ expect(findings[0].severity).toBe('high');
265
+ });
266
+
267
+ it('skips test files', () => {
268
+ const files = [
269
+ makeFileEntry({
270
+ file: 'src/db.test.ts',
271
+ suspiciousStrings: [
272
+ {
273
+ lineStart: 5,
274
+ lineEnd: 5,
275
+ kind: 'sql-injection',
276
+ },
277
+ ],
278
+ }),
279
+ ];
280
+ const findings = detectSqlInjectionRisk(files);
281
+ expect(findings).toHaveLength(0);
282
+ });
283
+
284
+ it('does not pick up hardcoded-secret kind', () => {
285
+ const files = [
286
+ makeFileEntry({
287
+ suspiciousStrings: [
288
+ {
289
+ lineStart: 5,
290
+ lineEnd: 5,
291
+ kind: 'hardcoded-secret',
292
+ context: 'literal',
293
+ snippet: 'not-a-sql-injection',
294
+ },
295
+ ],
296
+ }),
297
+ ];
298
+ const findings = detectSqlInjectionRisk(files);
299
+ expect(findings).toHaveLength(0);
300
+ });
301
+ });
302
+
303
+ describe('detectUnsafeRegex', () => {
304
+ it('detects nested quantifier pattern (a+)+', () => {
305
+ const files = [
306
+ makeFileEntry({
307
+ regexLiterals: [
308
+ {
309
+ lineStart: 10,
310
+ lineEnd: 10,
311
+ pattern: '(a+)+',
312
+ },
313
+ ],
314
+ }),
315
+ ];
316
+ const findings = detectUnsafeRegex(files);
317
+ expect(findings).toHaveLength(1);
318
+ expect(findings[0].category).toBe('unsafe-regex');
319
+ expect(findings[0].severity).toBe('medium');
320
+ });
321
+
322
+ it('detects another nested quantifier pattern (a?){', () => {
323
+ const files = [
324
+ makeFileEntry({
325
+ regexLiterals: [
326
+ {
327
+ lineStart: 12,
328
+ lineEnd: 12,
329
+ pattern: '(a?){10}',
330
+ },
331
+ ],
332
+ }),
333
+ ];
334
+ const findings = detectUnsafeRegex(files);
335
+ expect(findings).toHaveLength(1);
336
+ });
337
+
338
+ it('does not flag safe regex', () => {
339
+ const files = [
340
+ makeFileEntry({
341
+ regexLiterals: [
342
+ {
343
+ lineStart: 5,
344
+ lineEnd: 5,
345
+ pattern: '^[a-z]+$',
346
+ },
347
+ ],
348
+ }),
349
+ ];
350
+ const findings = detectUnsafeRegex(files);
351
+ expect(findings).toHaveLength(0);
352
+ });
353
+
354
+ it('skips test files', () => {
355
+ const files = [
356
+ makeFileEntry({
357
+ file: 'src/regex.test.ts',
358
+ regexLiterals: [
359
+ {
360
+ lineStart: 5,
361
+ lineEnd: 5,
362
+ pattern: '(a+)+',
363
+ },
364
+ ],
365
+ }),
366
+ ];
367
+ const findings = detectUnsafeRegex(files);
368
+ expect(findings).toHaveLength(0);
369
+ });
370
+ });
371
+
372
+ describe('detectPrototypePollutionRisk', () => {
373
+ it('detects unguarded computed-property-write as high severity', () => {
374
+ const files = [
375
+ makeFileEntry({
376
+ prototypePollutionSites: [
377
+ {
378
+ kind: 'computed-property-write',
379
+ detail: 'obj[key] = value',
380
+ lineStart: 20,
381
+ lineEnd: 20,
382
+ guarded: false,
383
+ },
384
+ ],
385
+ }),
386
+ ];
387
+ const findings = detectPrototypePollutionRisk(files);
388
+ expect(findings).toHaveLength(1);
389
+ expect(findings[0].severity).toBe('high');
390
+ expect(findings[0].category).toBe('prototype-pollution-risk');
391
+ });
392
+
393
+ it('detects object-assign site as medium severity', () => {
394
+ const files = [
395
+ makeFileEntry({
396
+ prototypePollutionSites: [
397
+ {
398
+ kind: 'object-assign',
399
+ detail: 'Object.assign(target, source)',
400
+ lineStart: 25,
401
+ lineEnd: 25,
402
+ guarded: false,
403
+ },
404
+ ],
405
+ }),
406
+ ];
407
+ const findings = detectPrototypePollutionRisk(files);
408
+ expect(findings).toHaveLength(1);
409
+ expect(findings[0].severity).toBe('medium');
410
+ });
411
+
412
+ it('downgrades guarded computed-property-write to low severity', () => {
413
+ const files = [
414
+ makeFileEntry({
415
+ prototypePollutionSites: [
416
+ {
417
+ kind: 'computed-property-write',
418
+ detail: 'obj[key] = value',
419
+ lineStart: 20,
420
+ lineEnd: 20,
421
+ guarded: true,
422
+ },
423
+ ],
424
+ }),
425
+ ];
426
+ const findings = detectPrototypePollutionRisk(files);
427
+ expect(findings).toHaveLength(1);
428
+ expect(findings[0].severity).toBe('low');
429
+ expect(findings[0].title).toContain('(guarded)');
430
+ });
431
+
432
+ it('skips test files', () => {
433
+ const files = [
434
+ makeFileEntry({
435
+ file: 'tests/merge.test.ts',
436
+ prototypePollutionSites: [
437
+ {
438
+ kind: 'computed-property-write',
439
+ detail: 'obj[key] = value',
440
+ lineStart: 5,
441
+ lineEnd: 5,
442
+ guarded: false,
443
+ },
444
+ ],
445
+ }),
446
+ ];
447
+ const findings = detectPrototypePollutionRisk(files);
448
+ expect(findings).toHaveLength(0);
449
+ });
450
+
451
+ it('returns 0 findings for empty prototypePollutionSites', () => {
452
+ const files = [makeFileEntry({ prototypePollutionSites: [] })];
453
+ const findings = detectPrototypePollutionRisk(files);
454
+ expect(findings).toHaveLength(0);
455
+ });
456
+ });
457
+
458
+ describe('detectUnvalidatedInputSink', () => {
459
+ it('detects high severity when hasSinkInBody=true, hasValidation=false, paramConfidence=high', () => {
460
+ const files = [
461
+ makeFileEntry({
462
+ inputSources: [
463
+ makeInputSource({
464
+ hasSinkInBody: true,
465
+ hasValidation: false,
466
+ paramConfidence: 'high',
467
+ sinkKinds: ['eval'],
468
+ callsWithInputArgs: [{ callee: 'eval', lineStart: 15 }],
469
+ }),
470
+ ],
471
+ }),
472
+ ];
473
+ const findings = detectUnvalidatedInputSink(files);
474
+ expect(findings).toHaveLength(1);
475
+ expect(findings[0].severity).toBe('high');
476
+ expect(findings[0].category).toBe('unvalidated-input-sink');
477
+ });
478
+
479
+ it('detects medium severity when paramConfidence=low', () => {
480
+ const files = [
481
+ makeFileEntry({
482
+ inputSources: [
483
+ makeInputSource({
484
+ hasSinkInBody: true,
485
+ hasValidation: false,
486
+ paramConfidence: 'low',
487
+ sinkKinds: ['eval'],
488
+ callsWithInputArgs: [{ callee: 'eval', lineStart: 15 }],
489
+ }),
490
+ ],
491
+ }),
492
+ ];
493
+ const findings = detectUnvalidatedInputSink(files);
494
+ expect(findings).toHaveLength(1);
495
+ expect(findings[0].severity).toBe('medium');
496
+ });
497
+
498
+ it('skips when hasSinkInBody=false', () => {
499
+ const files = [
500
+ makeFileEntry({
501
+ inputSources: [
502
+ makeInputSource({
503
+ hasSinkInBody: false,
504
+ hasValidation: false,
505
+ paramConfidence: 'high',
506
+ }),
507
+ ],
508
+ }),
509
+ ];
510
+ const findings = detectUnvalidatedInputSink(files);
511
+ expect(findings).toHaveLength(0);
512
+ });
513
+
514
+ it('skips when hasValidation=true', () => {
515
+ const files = [
516
+ makeFileEntry({
517
+ inputSources: [
518
+ makeInputSource({
519
+ hasSinkInBody: true,
520
+ hasValidation: true,
521
+ paramConfidence: 'high',
522
+ sinkKinds: ['eval'],
523
+ }),
524
+ ],
525
+ }),
526
+ ];
527
+ const findings = detectUnvalidatedInputSink(files);
528
+ expect(findings).toHaveLength(0);
529
+ });
530
+
531
+ it('skips test files', () => {
532
+ const files = [
533
+ makeFileEntry({
534
+ file: 'src/handler.test.ts',
535
+ inputSources: [
536
+ makeInputSource({
537
+ hasSinkInBody: true,
538
+ hasValidation: false,
539
+ paramConfidence: 'high',
540
+ sinkKinds: ['eval'],
541
+ }),
542
+ ],
543
+ }),
544
+ ];
545
+ const findings = detectUnvalidatedInputSink(files);
546
+ expect(findings).toHaveLength(0);
547
+ });
548
+
549
+ it('returns 0 findings for empty inputSources', () => {
550
+ const files = [makeFileEntry({ inputSources: [] })];
551
+ const findings = detectUnvalidatedInputSink(files);
552
+ expect(findings).toHaveLength(0);
553
+ });
554
+ });
555
+
556
+ describe('detectInputPassthroughRisk', () => {
557
+ it('detects medium severity when paramConfidence=high, callsWithInputArgs non-empty, no sink, no validation', () => {
558
+ const files = [
559
+ makeFileEntry({
560
+ inputSources: [
561
+ makeInputSource({
562
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
563
+ hasValidation: false,
564
+ hasSinkInBody: false,
565
+ paramConfidence: 'high',
566
+ }),
567
+ ],
568
+ }),
569
+ ];
570
+ const findings = detectInputPassthroughRisk(files);
571
+ expect(findings).toHaveLength(1);
572
+ expect(findings[0].severity).toBe('medium');
573
+ expect(findings[0].category).toBe('input-passthrough-risk');
574
+ });
575
+
576
+ it('detects low severity when paramConfidence=medium', () => {
577
+ const files = [
578
+ makeFileEntry({
579
+ inputSources: [
580
+ makeInputSource({
581
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
582
+ hasValidation: false,
583
+ hasSinkInBody: false,
584
+ paramConfidence: 'medium',
585
+ }),
586
+ ],
587
+ }),
588
+ ];
589
+ const findings = detectInputPassthroughRisk(files);
590
+ expect(findings).toHaveLength(1);
591
+ expect(findings[0].severity).toBe('low');
592
+ });
593
+
594
+ it('skips when paramConfidence=low', () => {
595
+ const files = [
596
+ makeFileEntry({
597
+ inputSources: [
598
+ makeInputSource({
599
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
600
+ hasValidation: false,
601
+ hasSinkInBody: false,
602
+ paramConfidence: 'low',
603
+ }),
604
+ ],
605
+ }),
606
+ ];
607
+ const findings = detectInputPassthroughRisk(files);
608
+ expect(findings).toHaveLength(0);
609
+ });
610
+
611
+ it('skips when hasSinkInBody=true', () => {
612
+ const files = [
613
+ makeFileEntry({
614
+ inputSources: [
615
+ makeInputSource({
616
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
617
+ hasValidation: false,
618
+ hasSinkInBody: true,
619
+ paramConfidence: 'high',
620
+ }),
621
+ ],
622
+ }),
623
+ ];
624
+ const findings = detectInputPassthroughRisk(files);
625
+ expect(findings).toHaveLength(0);
626
+ });
627
+
628
+ it('skips when hasValidation=true', () => {
629
+ const files = [
630
+ makeFileEntry({
631
+ inputSources: [
632
+ makeInputSource({
633
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
634
+ hasValidation: true,
635
+ hasSinkInBody: false,
636
+ paramConfidence: 'high',
637
+ }),
638
+ ],
639
+ }),
640
+ ];
641
+ const findings = detectInputPassthroughRisk(files);
642
+ expect(findings).toHaveLength(0);
643
+ });
644
+
645
+ it('skips test files', () => {
646
+ const files = [
647
+ makeFileEntry({
648
+ file: 'src/api.spec.ts',
649
+ inputSources: [
650
+ makeInputSource({
651
+ callsWithInputArgs: [{ callee: 'processData', lineStart: 20 }],
652
+ hasValidation: false,
653
+ hasSinkInBody: false,
654
+ paramConfidence: 'high',
655
+ }),
656
+ ],
657
+ }),
658
+ ];
659
+ const findings = detectInputPassthroughRisk(files);
660
+ expect(findings).toHaveLength(0);
661
+ });
662
+ });
663
+
664
+ describe('detectPathTraversalRisk', () => {
665
+ it('detects high severity when fs-read sink, paramConfidence=high, no validation', () => {
666
+ const files = [
667
+ makeFileEntry({
668
+ inputSources: [
669
+ makeInputSource({
670
+ sinkKinds: ['fs-read'],
671
+ paramConfidence: 'high',
672
+ hasValidation: false,
673
+ hasSinkInBody: true,
674
+ callsWithInputArgs: [{ callee: 'fs.readFile', lineStart: 15 }],
675
+ }),
676
+ ],
677
+ }),
678
+ ];
679
+ const findings = detectPathTraversalRisk(files);
680
+ expect(findings).toHaveLength(1);
681
+ expect(findings[0].severity).toBe('high');
682
+ expect(findings[0].category).toBe('path-traversal-risk');
683
+ });
684
+
685
+ it('detects medium severity when hasValidation=true', () => {
686
+ const files = [
687
+ makeFileEntry({
688
+ inputSources: [
689
+ makeInputSource({
690
+ sinkKinds: ['fs-read'],
691
+ paramConfidence: 'high',
692
+ hasValidation: true,
693
+ hasSinkInBody: true,
694
+ callsWithInputArgs: [{ callee: 'fs.readFile', lineStart: 15 }],
695
+ }),
696
+ ],
697
+ }),
698
+ ];
699
+ const findings = detectPathTraversalRisk(files);
700
+ expect(findings).toHaveLength(1);
701
+ expect(findings[0].severity).toBe('medium');
702
+ });
703
+
704
+ it('skips when paramConfidence=low', () => {
705
+ const files = [
706
+ makeFileEntry({
707
+ inputSources: [
708
+ makeInputSource({
709
+ sinkKinds: ['fs-read'],
710
+ paramConfidence: 'low',
711
+ hasValidation: false,
712
+ hasSinkInBody: true,
713
+ }),
714
+ ],
715
+ }),
716
+ ];
717
+ const findings = detectPathTraversalRisk(files);
718
+ expect(findings).toHaveLength(0);
719
+ });
720
+
721
+ it('skips when no fs-read or path-resolve sinks', () => {
722
+ const files = [
723
+ makeFileEntry({
724
+ inputSources: [
725
+ makeInputSource({
726
+ sinkKinds: ['eval'],
727
+ paramConfidence: 'high',
728
+ hasValidation: false,
729
+ hasSinkInBody: true,
730
+ }),
731
+ ],
732
+ }),
733
+ ];
734
+ const findings = detectPathTraversalRisk(files);
735
+ expect(findings).toHaveLength(0);
736
+ });
737
+
738
+ it('skips test files', () => {
739
+ const files = [
740
+ makeFileEntry({
741
+ file: 'src/file.test.ts',
742
+ inputSources: [
743
+ makeInputSource({
744
+ sinkKinds: ['fs-read'],
745
+ paramConfidence: 'high',
746
+ hasValidation: false,
747
+ hasSinkInBody: true,
748
+ }),
749
+ ],
750
+ }),
751
+ ];
752
+ const findings = detectPathTraversalRisk(files);
753
+ expect(findings).toHaveLength(0);
754
+ });
755
+ });
756
+
757
+ describe('detectCommandInjectionRisk', () => {
758
+ it('detects critical severity for exec callees with paramConfidence=high', () => {
759
+ const files = [
760
+ makeFileEntry({
761
+ inputSources: [
762
+ makeInputSource({
763
+ sinkKinds: ['exec'],
764
+ paramConfidence: 'high',
765
+ hasValidation: false,
766
+ hasSinkInBody: true,
767
+ callsWithInputArgs: [
768
+ { callee: 'child_process.exec', lineStart: 15 },
769
+ ],
770
+ }),
771
+ ],
772
+ }),
773
+ ];
774
+ const findings = detectCommandInjectionRisk(files);
775
+ expect(findings).toHaveLength(1);
776
+ expect(findings[0].severity).toBe('critical');
777
+ expect(findings[0].category).toBe('command-injection-risk');
778
+ expect(findings[0].title).toContain('exec');
779
+ });
780
+
781
+ it('detects high severity for spawn callees (no exec)', () => {
782
+ const files = [
783
+ makeFileEntry({
784
+ inputSources: [
785
+ makeInputSource({
786
+ sinkKinds: ['exec'],
787
+ paramConfidence: 'high',
788
+ hasValidation: false,
789
+ hasSinkInBody: true,
790
+ callsWithInputArgs: [
791
+ { callee: 'child_process.spawn', lineStart: 15 },
792
+ ],
793
+ }),
794
+ ],
795
+ }),
796
+ ];
797
+ const findings = detectCommandInjectionRisk(files);
798
+ expect(findings).toHaveLength(1);
799
+ expect(findings[0].severity).toBe('high');
800
+ expect(findings[0].title).toContain('spawn');
801
+ });
802
+
803
+ it('skips when paramConfidence=low', () => {
804
+ const files = [
805
+ makeFileEntry({
806
+ inputSources: [
807
+ makeInputSource({
808
+ sinkKinds: ['exec'],
809
+ paramConfidence: 'low',
810
+ hasValidation: false,
811
+ hasSinkInBody: true,
812
+ callsWithInputArgs: [
813
+ { callee: 'child_process.exec', lineStart: 15 },
814
+ ],
815
+ }),
816
+ ],
817
+ }),
818
+ ];
819
+ const findings = detectCommandInjectionRisk(files);
820
+ expect(findings).toHaveLength(0);
821
+ });
822
+
823
+ it('skips when no exec sinks', () => {
824
+ const files = [
825
+ makeFileEntry({
826
+ inputSources: [
827
+ makeInputSource({
828
+ sinkKinds: ['eval'],
829
+ paramConfidence: 'high',
830
+ hasValidation: false,
831
+ hasSinkInBody: true,
832
+ callsWithInputArgs: [{ callee: 'eval', lineStart: 15 }],
833
+ }),
834
+ ],
835
+ }),
836
+ ];
837
+ const findings = detectCommandInjectionRisk(files);
838
+ expect(findings).toHaveLength(0);
839
+ });
840
+
841
+ it('only emits exec finding when both exec and spawn callees exist', () => {
842
+ const files = [
843
+ makeFileEntry({
844
+ inputSources: [
845
+ makeInputSource({
846
+ sinkKinds: ['exec'],
847
+ paramConfidence: 'high',
848
+ hasValidation: false,
849
+ hasSinkInBody: true,
850
+ callsWithInputArgs: [
851
+ { callee: 'child_process.exec', lineStart: 15 },
852
+ { callee: 'child_process.spawn', lineStart: 20 },
853
+ ],
854
+ }),
855
+ ],
856
+ }),
857
+ ];
858
+ const findings = detectCommandInjectionRisk(files);
859
+ expect(findings).toHaveLength(1);
860
+ expect(findings[0].title).toContain('exec');
861
+ expect(findings[0].title).not.toContain('spawn');
862
+ });
863
+
864
+ it('skips test files', () => {
865
+ const files = [
866
+ makeFileEntry({
867
+ file: 'src/exec.test.ts',
868
+ inputSources: [
869
+ makeInputSource({
870
+ sinkKinds: ['exec'],
871
+ paramConfidence: 'high',
872
+ hasValidation: false,
873
+ hasSinkInBody: true,
874
+ callsWithInputArgs: [{ callee: 'exec', lineStart: 5 }],
875
+ }),
876
+ ],
877
+ }),
878
+ ];
879
+ const findings = detectCommandInjectionRisk(files);
880
+ expect(findings).toHaveLength(0);
881
+ });
882
+ });