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,309 @@
1
+ import * as ts from 'typescript';
2
+
3
+ import { getLineAndCharacter } from '../common/utils.js';
4
+
5
+ import type { CodeLocation, ConsoleLogEntry, FileEntry, SuspiciousString } from '../types/index.js';
6
+
7
+ const SENSITIVE_LOG_PATTERNS = [
8
+ /password/i,
9
+ /passwd/i,
10
+ /\bsecret\b/i,
11
+ /\btoken\b/i,
12
+ /\bauth\b/i,
13
+ /credential/i,
14
+ /credit.?card/i,
15
+ /\bssn\b/i,
16
+ /social.?security/i,
17
+ /api[_-]?key/i,
18
+ /private[_-]?key/i,
19
+ /access[_-]?key/i,
20
+ /\bsession\b/i,
21
+ ];
22
+
23
+ const CONSOLE_LOG_METHODS = new Set([
24
+ 'log', 'debug', 'trace', 'info', 'warn', 'error', 'dir', 'table',
25
+ ]);
26
+
27
+ const SECRET_PATTERNS = [
28
+ /password\s*[:=]\s*['"`]/i,
29
+ /api[_-]?key\s*[:=]\s*['"`]/i,
30
+ /secret\s*[:=]\s*['"`]/i,
31
+ /token\s*[:=]\s*['"`]/i,
32
+ /-----BEGIN.*KEY/,
33
+ /private[_-]?key\s*[:=]\s*['"`]/i,
34
+ /auth[_-]?token\s*[:=]\s*['"`]/i,
35
+ ];
36
+
37
+ const SQL_KEYWORDS =
38
+ /\b(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE)\b/i;
39
+
40
+ /** Strings that look like placeholders, not real secrets */
41
+ const PLACEHOLDER_PATTERN = /^(YOUR_|REPLACE_ME|<[a-z_-]+>|\$\{|{{)/i;
42
+ /** UUID pattern: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx */
43
+ const UUID_PATTERN =
44
+ /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
45
+
46
+ function isInsideRegexLiteral(node: ts.Node): boolean {
47
+ let current: ts.Node | undefined = node.parent;
48
+ while (current) {
49
+ if (ts.isRegularExpressionLiteral(current)) return true;
50
+ if (
51
+ ts.isNewExpression(current) &&
52
+ current.expression.getText(node.getSourceFile()) === 'RegExp'
53
+ )
54
+ return true;
55
+ current = current.parent;
56
+ }
57
+ return false;
58
+ }
59
+
60
+ function isPlaceholderOrUuid(value: string): boolean {
61
+ return PLACEHOLDER_PATTERN.test(value) || UUID_PATTERN.test(value);
62
+ }
63
+
64
+ /** Skip strings inside finding metadata fields (suggestedFix, reason, impact, etc.) */
65
+ const METADATA_PROP_NAMES = new Set([
66
+ 'suggestedFix',
67
+ 'strategy',
68
+ 'steps',
69
+ 'reason',
70
+ 'impact',
71
+ 'expectedResult',
72
+ 'title',
73
+ ]);
74
+
75
+ function isInsideMetadataProperty(node: ts.Node): boolean {
76
+ let current: ts.Node | undefined = node.parent;
77
+ while (current) {
78
+ if (ts.isPropertyAssignment(current) && ts.isIdentifier(current.name)) {
79
+ if (METADATA_PROP_NAMES.has(current.name.text)) return true;
80
+ }
81
+ current = current.parent;
82
+ }
83
+ return false;
84
+ }
85
+ function computeShannonEntropy(s: string): number {
86
+ const freq = new Map<string, number>();
87
+ for (const ch of s) freq.set(ch, (freq.get(ch) || 0) + 1);
88
+ let entropy = 0;
89
+ for (const count of freq.values()) {
90
+ const p = count / s.length;
91
+ if (p > 0) entropy -= p * Math.log2(p);
92
+ }
93
+ return entropy;
94
+ }
95
+
96
+ export function collectSecurityData(
97
+ sourceFile: ts.SourceFile,
98
+ fileRelative: string,
99
+ fileEntry: FileEntry
100
+ ): void {
101
+ const evalUsages: CodeLocation[] = [];
102
+ const unsafeHtmlAssignments: CodeLocation[] = [];
103
+ const suspiciousStrings: SuspiciousString[] = [];
104
+ const consoleLogs: ConsoleLogEntry[] = [];
105
+ const regexLiterals: Array<{
106
+ lineStart: number;
107
+ lineEnd: number;
108
+ pattern: string;
109
+ }> = [];
110
+
111
+ const visit = (node: ts.Node): void => {
112
+ if (ts.isDebuggerStatement(node)) {
113
+ const loc = getLineAndCharacter(sourceFile, node);
114
+ consoleLogs.push({
115
+ method: 'debugger',
116
+ lineStart: loc.lineStart,
117
+ lineEnd: loc.lineEnd,
118
+ hasSensitiveArg: false,
119
+ });
120
+ }
121
+
122
+ if (ts.isCallExpression(node)) {
123
+ const expr = node.expression;
124
+ if (ts.isPropertyAccessExpression(expr)) {
125
+ const obj = expr.expression.getText(sourceFile);
126
+ const method = expr.name.getText(sourceFile);
127
+ if (obj === 'console' && CONSOLE_LOG_METHODS.has(method)) {
128
+ const loc = getLineAndCharacter(sourceFile, node);
129
+ const argText = node.arguments.map(a => a.getText(sourceFile)).join(' ');
130
+ const hasSensitiveArg = SENSITIVE_LOG_PATTERNS.some(p => p.test(argText));
131
+ consoleLogs.push({
132
+ method,
133
+ lineStart: loc.lineStart,
134
+ lineEnd: loc.lineEnd,
135
+ hasSensitiveArg,
136
+ argSnippet: argText.slice(0, 80),
137
+ });
138
+ }
139
+ }
140
+ }
141
+
142
+ if (ts.isCallExpression(node)) {
143
+ const text = node.expression.getText(sourceFile);
144
+ if (text === 'eval' || text === 'Function') {
145
+ const loc = getLineAndCharacter(sourceFile, node);
146
+ evalUsages.push({
147
+ file: fileRelative,
148
+ lineStart: loc.lineStart,
149
+ lineEnd: loc.lineEnd,
150
+ });
151
+ }
152
+ if (text === 'new Function') {
153
+ const loc = getLineAndCharacter(sourceFile, node);
154
+ evalUsages.push({
155
+ file: fileRelative,
156
+ lineStart: loc.lineStart,
157
+ lineEnd: loc.lineEnd,
158
+ });
159
+ }
160
+ if (
161
+ (text === 'setTimeout' || text === 'setInterval') &&
162
+ node.arguments.length > 0
163
+ ) {
164
+ const firstArg = node.arguments[0];
165
+ if (
166
+ ts.isStringLiteral(firstArg) ||
167
+ ts.isNoSubstitutionTemplateLiteral(firstArg)
168
+ ) {
169
+ const loc = getLineAndCharacter(sourceFile, node);
170
+ evalUsages.push({
171
+ file: fileRelative,
172
+ lineStart: loc.lineStart,
173
+ lineEnd: loc.lineEnd,
174
+ });
175
+ }
176
+ }
177
+ if (text === 'document.write' || text === 'document.writeln') {
178
+ const loc = getLineAndCharacter(sourceFile, node);
179
+ unsafeHtmlAssignments.push({
180
+ file: fileRelative,
181
+ lineStart: loc.lineStart,
182
+ lineEnd: loc.lineEnd,
183
+ });
184
+ }
185
+ }
186
+
187
+ if (
188
+ ts.isNewExpression(node) &&
189
+ node.expression.getText(sourceFile) === 'Function'
190
+ ) {
191
+ const loc = getLineAndCharacter(sourceFile, node);
192
+ evalUsages.push({
193
+ file: fileRelative,
194
+ lineStart: loc.lineStart,
195
+ lineEnd: loc.lineEnd,
196
+ });
197
+ }
198
+
199
+ if (
200
+ ts.isBinaryExpression(node) &&
201
+ node.operatorToken.kind === ts.SyntaxKind.EqualsToken
202
+ ) {
203
+ if (ts.isPropertyAccessExpression(node.left)) {
204
+ const prop = node.left.name.getText(sourceFile);
205
+ if (prop === 'innerHTML' || prop === 'outerHTML') {
206
+ const loc = getLineAndCharacter(sourceFile, node);
207
+ unsafeHtmlAssignments.push({
208
+ file: fileRelative,
209
+ lineStart: loc.lineStart,
210
+ lineEnd: loc.lineEnd,
211
+ });
212
+ }
213
+ }
214
+ }
215
+
216
+ if (
217
+ ts.isJsxAttribute(node) &&
218
+ node.name.getText(sourceFile) === 'dangerouslySetInnerHTML'
219
+ ) {
220
+ const loc = getLineAndCharacter(sourceFile, node);
221
+ unsafeHtmlAssignments.push({
222
+ file: fileRelative,
223
+ lineStart: loc.lineStart,
224
+ lineEnd: loc.lineEnd,
225
+ });
226
+ }
227
+
228
+ if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {
229
+ if (!isInsideMetadataProperty(node) && !isInsideRegexLiteral(node)) {
230
+ const value = node.text;
231
+ if (!isPlaceholderOrUuid(value)) {
232
+ for (const pattern of SECRET_PATTERNS) {
233
+ if (pattern.test(value)) {
234
+ const loc = getLineAndCharacter(sourceFile, node);
235
+ suspiciousStrings.push({
236
+ lineStart: loc.lineStart,
237
+ lineEnd: loc.lineEnd,
238
+ kind: 'hardcoded-secret',
239
+ snippet: value.slice(0, 40),
240
+ context: 'literal',
241
+ });
242
+ break;
243
+ }
244
+ }
245
+ if (value.length >= 20 && computeShannonEntropy(value) > 4.5) {
246
+ const loc = getLineAndCharacter(sourceFile, node);
247
+ suspiciousStrings.push({
248
+ lineStart: loc.lineStart,
249
+ lineEnd: loc.lineEnd,
250
+ kind: 'hardcoded-secret',
251
+ context: 'literal',
252
+ });
253
+ }
254
+ }
255
+ }
256
+ }
257
+
258
+ if (ts.isRegularExpressionLiteral(node)) {
259
+ const regexText = node.getText(sourceFile);
260
+ for (const pattern of SECRET_PATTERNS) {
261
+ if (pattern.test(regexText)) {
262
+ const loc = getLineAndCharacter(sourceFile, node);
263
+ suspiciousStrings.push({
264
+ lineStart: loc.lineStart,
265
+ lineEnd: loc.lineEnd,
266
+ kind: 'hardcoded-secret',
267
+ snippet: regexText.slice(0, 40),
268
+ context: 'regex-definition',
269
+ });
270
+ break;
271
+ }
272
+ }
273
+ }
274
+
275
+ if (ts.isTemplateExpression(node)) {
276
+ if (!isInsideMetadataProperty(node)) {
277
+ const fullText = node.getText(sourceFile);
278
+ if (SQL_KEYWORDS.test(fullText) && node.templateSpans.length > 0) {
279
+ const loc = getLineAndCharacter(sourceFile, node);
280
+ suspiciousStrings.push({
281
+ lineStart: loc.lineStart,
282
+ lineEnd: loc.lineEnd,
283
+ kind: 'sql-injection',
284
+ snippet: fullText.slice(0, 60),
285
+ });
286
+ }
287
+ }
288
+ }
289
+
290
+ if (ts.isRegularExpressionLiteral(node)) {
291
+ const pattern = node.text;
292
+ const loc = getLineAndCharacter(sourceFile, node);
293
+ regexLiterals.push({
294
+ lineStart: loc.lineStart,
295
+ lineEnd: loc.lineEnd,
296
+ pattern,
297
+ });
298
+ }
299
+
300
+ ts.forEachChild(node, visit);
301
+ };
302
+ ts.forEachChild(sourceFile, visit);
303
+
304
+ fileEntry.evalUsages = evalUsages;
305
+ fileEntry.unsafeHtmlAssignments = unsafeHtmlAssignments;
306
+ fileEntry.suspiciousStrings = suspiciousStrings;
307
+ fileEntry.consoleLogs = consoleLogs;
308
+ fileEntry.regexLiterals = regexLiterals;
309
+ }
@@ -0,0 +1,97 @@
1
+ import * as ts from 'typescript';
2
+ import { describe, expect, it } from 'vitest';
3
+
4
+ import { collectTestProfile } from './test-profile.js';
5
+
6
+ import type { FileEntry } from '../types/index.js';
7
+
8
+ function parse(
9
+ code: string,
10
+ fileName = '/repo/src/test.spec.ts'
11
+ ): ts.SourceFile {
12
+ return ts.createSourceFile(fileName, code, ts.ScriptTarget.ESNext, true);
13
+ }
14
+
15
+ function emptyFileEntry(): FileEntry {
16
+ return {
17
+ package: 'test',
18
+ file: 'test.spec.ts',
19
+ parseEngine: 'typescript',
20
+ nodeCount: 0,
21
+ kindCounts: {},
22
+ functions: [],
23
+ flows: [],
24
+ dependencyProfile: {
25
+ internalDependencies: [],
26
+ externalDependencies: [],
27
+ unresolvedDependencies: [],
28
+ declaredExports: [],
29
+ importedSymbols: [],
30
+ reExports: [],
31
+ },
32
+ };
33
+ }
34
+
35
+ describe('collectTestProfile', () => {
36
+ it('describe + it blocks → detects test blocks', () => {
37
+ const code = `describe('suite', () => { it('test', () => {}); });`;
38
+ const sourceFile = parse(code);
39
+ const fileEntry = emptyFileEntry();
40
+ collectTestProfile(sourceFile, 'test.spec.ts', fileEntry);
41
+ expect(fileEntry.testProfile).toBeDefined();
42
+ expect(fileEntry.testProfile!.testBlocks).toHaveLength(1);
43
+ expect(fileEntry.testProfile!.testBlocks[0].name).toBe('test');
44
+ });
45
+
46
+ it('expect().toBe() → detects assertions', () => {
47
+ const code = `it('asserts', () => { expect(1).toBe(1); });`;
48
+ const sourceFile = parse(code);
49
+ const fileEntry = emptyFileEntry();
50
+ collectTestProfile(sourceFile, 'test.spec.ts', fileEntry);
51
+ expect(fileEntry.testProfile).toBeDefined();
52
+ expect(fileEntry.testProfile!.testBlocks).toHaveLength(1);
53
+ expect(fileEntry.testProfile!.testBlocks[0].assertionCount).toBeGreaterThan(
54
+ 0
55
+ );
56
+ });
57
+
58
+ it('jest.mock() → detects mocks', () => {
59
+ const code = `jest.mock('./module'); describe('suite', () => { it('test', () => {}); });`;
60
+ const sourceFile = parse(code);
61
+ const fileEntry = emptyFileEntry();
62
+ collectTestProfile(sourceFile, 'test.spec.ts', fileEntry);
63
+ expect(fileEntry.testProfile).toBeDefined();
64
+ expect(fileEntry.testProfile!.mockCalls).toHaveLength(1);
65
+ });
66
+
67
+ it('vi.spyOn() → detects spy', () => {
68
+ const code = `const obj = { method: () => {} }; describe('suite', () => { it('test', () => { vi.spyOn(obj, 'method'); }); });`;
69
+ const sourceFile = parse(code);
70
+ const fileEntry = emptyFileEntry();
71
+ collectTestProfile(sourceFile, 'test.spec.ts', fileEntry);
72
+ expect(fileEntry.testProfile).toBeDefined();
73
+ expect(fileEntry.testProfile!.spyOrStubCalls).toHaveLength(1);
74
+ expect(fileEntry.testProfile!.spyOrStubCalls[0].kind).toBe('spy');
75
+ });
76
+
77
+ it('beforeEach → detects setup hooks', () => {
78
+ const code = `describe('suite', () => { beforeEach(() => {}); it('test', () => {}); });`;
79
+ const sourceFile = parse(code);
80
+ const fileEntry = emptyFileEntry();
81
+ collectTestProfile(sourceFile, 'test.spec.ts', fileEntry);
82
+ expect(fileEntry.testProfile).toBeDefined();
83
+ expect(fileEntry.testProfile!.setupCalls).toHaveLength(1);
84
+ expect(fileEntry.testProfile!.setupCalls[0].kind).toBe('beforeEach');
85
+ });
86
+
87
+ it('no test profile for non-test code', () => {
88
+ const code = `function add(a: number, b: number) { return a + b; }`;
89
+ const sourceFile = parse(code);
90
+ const fileEntry = emptyFileEntry();
91
+ collectTestProfile(sourceFile, 'util.ts', fileEntry);
92
+ expect(fileEntry.testProfile).toBeDefined();
93
+ expect(fileEntry.testProfile!.testBlocks).toHaveLength(0);
94
+ expect(fileEntry.testProfile!.mockCalls).toHaveLength(0);
95
+ expect(fileEntry.testProfile!.setupCalls).toHaveLength(0);
96
+ });
97
+ });
@@ -0,0 +1,269 @@
1
+ import * as ts from 'typescript';
2
+
3
+ import { getLineAndCharacter } from '../common/utils.js';
4
+
5
+ import type {
6
+ CodeLocation,
7
+ FileEntry,
8
+ MockControlCall,
9
+ TestBlock,
10
+ TestProfile,
11
+ } from '../types/index.js';
12
+
13
+ const ASSERTION_PATTERNS = new Set(['expect', 'assert', 'should']);
14
+ const MOCK_PATTERNS = [
15
+ 'jest.mock',
16
+ 'vi.mock',
17
+ 'sinon.stub',
18
+ 'jest.spyOn',
19
+ 'vi.spyOn',
20
+ 'sinon.mock',
21
+ ];
22
+ const RESTORE_PATTERNS = new Set([
23
+ 'jest.restoreAllMocks',
24
+ 'vi.restoreAllMocks',
25
+ ]);
26
+ const SETUP_PATTERNS = new Set([
27
+ 'beforeAll',
28
+ 'beforeEach',
29
+ 'afterAll',
30
+ 'afterEach',
31
+ ]);
32
+ const FOCUSED_PATTERNS = new Set([
33
+ 'it.only',
34
+ 'test.only',
35
+ 'describe.only',
36
+ 'it.skip',
37
+ 'test.skip',
38
+ 'describe.skip',
39
+ 'it.todo',
40
+ 'test.todo',
41
+ ]);
42
+ const USE_FAKE_TIMER_PATTERNS = new Set([
43
+ 'jest.useFakeTimers',
44
+ 'vi.useFakeTimers',
45
+ ]);
46
+ const USE_REAL_TIMER_PATTERNS = new Set([
47
+ 'jest.useRealTimers',
48
+ 'vi.useRealTimers',
49
+ ]);
50
+
51
+ function getSpyOrStubKind(
52
+ call: ts.CallExpression,
53
+ sourceFile: ts.SourceFile
54
+ ): MockControlCall['kind'] | undefined {
55
+ if (!ts.isPropertyAccessExpression(call.expression)) return undefined;
56
+ const methodName = call.expression.name.getText(sourceFile);
57
+ const receiver = call.expression.expression.getText(sourceFile);
58
+
59
+ if ((receiver === 'jest' || receiver === 'vi') && methodName === 'spyOn')
60
+ return 'spy';
61
+ if (receiver === 'sinon' && (methodName === 'stub' || methodName === 'mock'))
62
+ return 'stub';
63
+ return undefined;
64
+ }
65
+
66
+ function getMockControlTarget(
67
+ node: ts.Node,
68
+ sourceFile: ts.SourceFile
69
+ ): string | undefined {
70
+ let current = node;
71
+ while (current.parent) {
72
+ const parent = current.parent;
73
+
74
+ if (
75
+ ts.isVariableDeclaration(parent) &&
76
+ parent.initializer === current &&
77
+ ts.isIdentifier(parent.name)
78
+ ) {
79
+ return parent.name.getText(sourceFile);
80
+ }
81
+
82
+ if (
83
+ ts.isBinaryExpression(parent) &&
84
+ parent.operatorToken.kind === ts.SyntaxKind.EqualsToken &&
85
+ parent.right === current
86
+ ) {
87
+ return parent.left.getText(sourceFile).trim();
88
+ }
89
+
90
+ current = parent;
91
+ }
92
+
93
+ return undefined;
94
+ }
95
+
96
+ function getMockRestoreTarget(
97
+ node: ts.CallExpression,
98
+ sourceFile: ts.SourceFile
99
+ ): string | undefined {
100
+ if (!ts.isPropertyAccessExpression(node.expression)) return undefined;
101
+ return node.expression.expression.getText(sourceFile).trim();
102
+ }
103
+
104
+ export function collectTestProfile(
105
+ sourceFile: ts.SourceFile,
106
+ fileRelative: string,
107
+ fileEntry: FileEntry
108
+ ): void {
109
+ const testBlocks: TestBlock[] = [];
110
+ const mockCalls: CodeLocation[] = [];
111
+ const setupCalls: TestProfile['setupCalls'] = [];
112
+ const mutableStateDecls: CodeLocation[] = [];
113
+ const focusedCalls: TestProfile['focusedCalls'] = [];
114
+ const timerControls: TestProfile['timerControls'] = [];
115
+ const mockRestores: TestProfile['mockRestores'] = [];
116
+ const spyOrStubCalls: TestProfile['spyOrStubCalls'] = [];
117
+
118
+ const visit = (
119
+ node: ts.Node,
120
+ insideDescribe: boolean,
121
+ insideTest: boolean
122
+ ): void => {
123
+ if (ts.isCallExpression(node)) {
124
+ const callText = node.expression.getText(sourceFile);
125
+
126
+ if (FOCUSED_PATTERNS.has(callText)) {
127
+ const loc = getLineAndCharacter(sourceFile, node);
128
+ focusedCalls.push({
129
+ kind: callText as TestProfile['focusedCalls'][0]['kind'],
130
+ lineStart: loc.lineStart,
131
+ lineEnd: loc.lineEnd,
132
+ });
133
+ }
134
+
135
+ if (
136
+ (callText === 'it' ||
137
+ callText === 'test' ||
138
+ callText === 'it.only' ||
139
+ callText === 'test.only') &&
140
+ node.arguments.length >= 2
141
+ ) {
142
+ const nameArg = node.arguments[0];
143
+ const name = ts.isStringLiteral(nameArg) ? nameArg.text : callText;
144
+ const body = node.arguments[1];
145
+ const loc = getLineAndCharacter(sourceFile, node);
146
+ let assertionCount = 0;
147
+ const countAssertions = (n: ts.Node): void => {
148
+ if (ts.isCallExpression(n)) {
149
+ const t = n.expression.getText(sourceFile);
150
+ if (
151
+ ASSERTION_PATTERNS.has(t.split('.')[0]) ||
152
+ t.includes('.to.') ||
153
+ t.includes('.should')
154
+ )
155
+ assertionCount++;
156
+ }
157
+ ts.forEachChild(n, countAssertions);
158
+ };
159
+ ts.forEachChild(body, countAssertions);
160
+ testBlocks.push({
161
+ name,
162
+ lineStart: loc.lineStart,
163
+ lineEnd: loc.lineEnd,
164
+ assertionCount,
165
+ });
166
+ ts.forEachChild(node, child => visit(child, insideDescribe, true));
167
+ return;
168
+ }
169
+
170
+ if (
171
+ MOCK_PATTERNS.some(p => callText === p || callText.startsWith(p + '('))
172
+ ) {
173
+ const loc = getLineAndCharacter(sourceFile, node);
174
+ mockCalls.push({
175
+ file: fileRelative,
176
+ lineStart: loc.lineStart,
177
+ lineEnd: loc.lineEnd,
178
+ });
179
+ const spyOrStubKind = getSpyOrStubKind(node, sourceFile);
180
+ if (spyOrStubKind) {
181
+ spyOrStubCalls.push({
182
+ kind: spyOrStubKind,
183
+ file: fileRelative,
184
+ lineStart: loc.lineStart,
185
+ lineEnd: loc.lineEnd,
186
+ target: getMockControlTarget(node, sourceFile),
187
+ });
188
+ }
189
+ }
190
+
191
+ if (USE_FAKE_TIMER_PATTERNS.has(callText)) {
192
+ const loc = getLineAndCharacter(sourceFile, node);
193
+ timerControls.push({
194
+ kind: callText as TestProfile['timerControls'][0]['kind'],
195
+ lineStart: loc.lineStart,
196
+ lineEnd: loc.lineEnd,
197
+ });
198
+ }
199
+
200
+ if (USE_REAL_TIMER_PATTERNS.has(callText)) {
201
+ const loc = getLineAndCharacter(sourceFile, node);
202
+ timerControls.push({
203
+ kind: callText as TestProfile['timerControls'][0]['kind'],
204
+ lineStart: loc.lineStart,
205
+ lineEnd: loc.lineEnd,
206
+ });
207
+ }
208
+
209
+ if (RESTORE_PATTERNS.has(callText)) {
210
+ const loc = getLineAndCharacter(sourceFile, node);
211
+ mockRestores.push({
212
+ kind: 'restoreAll',
213
+ file: fileRelative,
214
+ lineStart: loc.lineStart,
215
+ lineEnd: loc.lineEnd,
216
+ });
217
+ } else if (callText.endsWith('.mockRestore')) {
218
+ const loc = getLineAndCharacter(sourceFile, node);
219
+ mockRestores.push({
220
+ kind: 'restore',
221
+ file: fileRelative,
222
+ lineStart: loc.lineStart,
223
+ lineEnd: loc.lineEnd,
224
+ target: getMockRestoreTarget(node, sourceFile),
225
+ });
226
+ }
227
+
228
+ if (SETUP_PATTERNS.has(callText)) {
229
+ const loc = getLineAndCharacter(sourceFile, node);
230
+ setupCalls.push({
231
+ kind: callText as TestProfile['setupCalls'][0]['kind'],
232
+ lineStart: loc.lineStart,
233
+ });
234
+ }
235
+
236
+ if (callText === 'describe' || callText === 'describe.only') {
237
+ ts.forEachChild(node, child => visit(child, true, insideTest));
238
+ return;
239
+ }
240
+ }
241
+
242
+ if (insideDescribe && !insideTest && ts.isVariableStatement(node)) {
243
+ const decl = node.declarationList;
244
+ if (decl.flags & ts.NodeFlags.Let || !(decl.flags & ts.NodeFlags.Const)) {
245
+ const loc = getLineAndCharacter(sourceFile, node);
246
+ mutableStateDecls.push({
247
+ file: fileRelative,
248
+ lineStart: loc.lineStart,
249
+ lineEnd: loc.lineEnd,
250
+ });
251
+ }
252
+ }
253
+
254
+ ts.forEachChild(node, child => visit(child, insideDescribe, insideTest));
255
+ };
256
+
257
+ ts.forEachChild(sourceFile, child => visit(child, false, false));
258
+
259
+ fileEntry.testProfile = {
260
+ testBlocks,
261
+ mockCalls,
262
+ setupCalls,
263
+ mutableStateDecls,
264
+ focusedCalls,
265
+ timerControls,
266
+ mockRestores,
267
+ spyOrStubCalls,
268
+ };
269
+ }
@@ -0,0 +1,32 @@
1
+ import path from 'node:path';
2
+ import { pathToFileURL } from 'node:url';
3
+
4
+ import { describe, expect, it } from 'vitest';
5
+
6
+ import { isDirectRun } from './is-direct-run.js';
7
+
8
+ describe('isDirectRun', () => {
9
+ it('returns false when argv1 is missing', () => {
10
+ expect(isDirectRun(pathToFileURL('/tmp/example.js').href, undefined)).toBe(false);
11
+ });
12
+
13
+ it('matches the current module path for absolute argv1', () => {
14
+ const file = path.join(process.cwd(), 'scripts', 'example.js');
15
+
16
+ expect(isDirectRun(pathToFileURL(file).href, file)).toBe(true);
17
+ });
18
+
19
+ it('matches the current module path for relative argv1', () => {
20
+ const file = path.join(process.cwd(), 'scripts', 'example.js');
21
+ const relativeFile = path.relative(process.cwd(), file);
22
+
23
+ expect(isDirectRun(pathToFileURL(file).href, relativeFile)).toBe(true);
24
+ });
25
+
26
+ it('returns false for imported modules', () => {
27
+ const file = path.join(process.cwd(), 'scripts', 'example.js');
28
+ const differentFile = path.join(process.cwd(), 'scripts', 'other.js');
29
+
30
+ expect(isDirectRun(pathToFileURL(file).href, differentFile)).toBe(false);
31
+ });
32
+ });