scip-query 0.19.4 → 0.19.6

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 (400) hide show
  1. package/CHANGELOG.md +75 -1
  2. package/README.md +242 -49
  3. package/dist/augment-vue-worker.js +1 -1
  4. package/dist/{chunk-2YU7I3QO.js → chunk-24QNP7MN.js} +2 -2
  5. package/dist/{chunk-CNKAGUPL.js → chunk-26X7KCJR.js} +2 -2
  6. package/dist/{chunk-GPBBJ5Y4.js → chunk-273W2U4Y.js} +3 -3
  7. package/dist/{chunk-7GXM52MI.js → chunk-2CVXCGL4.js} +2 -2
  8. package/dist/{chunk-ABMYA4TN.js → chunk-2EZSOTSY.js} +2 -2
  9. package/dist/{chunk-HKEHS2AS.js → chunk-2GSQR6YA.js} +2 -2
  10. package/dist/{chunk-FECYOO5O.js → chunk-2OXVAGGT.js} +2 -2
  11. package/dist/chunk-2ZOCHAL2.js +8 -0
  12. package/dist/{chunk-QGXBRIM5.js → chunk-336DC5NJ.js} +2 -2
  13. package/dist/chunk-35SQLYCQ.js +2 -0
  14. package/dist/{chunk-VXQNNXJE.js → chunk-3OIKRYU5.js} +2 -2
  15. package/dist/{chunk-52ZYCAEO.js → chunk-47X75ZKH.js} +2 -2
  16. package/dist/{chunk-NPKYOIFM.js → chunk-4CGVLUDP.js} +2 -2
  17. package/dist/chunk-4RI4BJGT.js +8 -0
  18. package/dist/{chunk-P2PC2WGR.js → chunk-52HQTTPB.js} +2 -2
  19. package/dist/{chunk-YNRNA5LK.js → chunk-5OC3HWP5.js} +2 -2
  20. package/dist/{chunk-STOL2BTL.js → chunk-6XFC7PQ5.js} +2 -2
  21. package/dist/{chunk-J77UIT3I.js → chunk-6XHTISLI.js} +2 -2
  22. package/dist/chunk-6YTSKJJ3.js +2 -0
  23. package/dist/{chunk-BTEE5NZQ.js → chunk-7E3TH5ZN.js} +2 -2
  24. package/dist/{chunk-X6D5IC6I.js → chunk-7LABSJSR.js} +2 -2
  25. package/dist/chunk-7Q6VYYCH.js +2 -0
  26. package/dist/{chunk-FWUUZTIO.js → chunk-A43URCQ3.js} +2 -2
  27. package/dist/chunk-A63U2W3P.js +3 -0
  28. package/dist/{chunk-3MJ5YA4Y.js → chunk-ADFSIJP2.js} +2 -2
  29. package/dist/chunk-AOLE4DYM.js +6 -0
  30. package/dist/chunk-APMMR5Y2.js +2 -0
  31. package/dist/chunk-B5MHCHP3.js +107 -0
  32. package/dist/{chunk-4RSI5EMG.js → chunk-CSTYYXKC.js} +2 -2
  33. package/dist/{chunk-25LPM4DG.js → chunk-CYJM7CYF.js} +2 -2
  34. package/dist/{chunk-S44IULR6.js → chunk-DD5BOU5I.js} +2 -2
  35. package/dist/{chunk-YGAGTIDK.js → chunk-DGMCFMPG.js} +7 -7
  36. package/dist/{chunk-UOAV44HR.js → chunk-E2ZXPB7J.js} +2 -2
  37. package/dist/{chunk-IZKFSVBV.js → chunk-EVOC5I5I.js} +2 -2
  38. package/dist/{chunk-XTX6QHOF.js → chunk-F42A3AKG.js} +2 -2
  39. package/dist/{chunk-Q4IIEGXJ.js → chunk-FHCTEANE.js} +2 -2
  40. package/dist/{chunk-3SVWW4PN.js → chunk-FKGN4A4E.js} +2 -2
  41. package/dist/{chunk-IG7N5ZIK.js → chunk-FQTPPXNA.js} +2 -2
  42. package/dist/{chunk-F6O7AAC3.js → chunk-G4UQL4CP.js} +2 -2
  43. package/dist/chunk-GA64UPMI.js +6 -0
  44. package/dist/{chunk-ZXJYMGD3.js → chunk-GK3GRUJX.js} +2 -2
  45. package/dist/chunk-HEBAY673.js +2 -0
  46. package/dist/chunk-HELS7KFF.js +2 -0
  47. package/dist/{chunk-B5NLK2B3.js → chunk-IPDCSB6N.js} +2 -2
  48. package/dist/{chunk-M7MTH5NR.js → chunk-IYAOX36F.js} +2 -2
  49. package/dist/{chunk-YVVCVR2L.js → chunk-J7VT2CRB.js} +2 -2
  50. package/dist/{chunk-4333ETTV.js → chunk-JELJLXEE.js} +2 -2
  51. package/dist/{chunk-LBMJEAEW.js → chunk-JERWGHQT.js} +2 -2
  52. package/dist/chunk-JJJCO4QC.js +945 -0
  53. package/dist/{chunk-6E7UTQY7.js → chunk-JZNLMHWY.js} +2 -2
  54. package/dist/{chunk-R4FQGQ4X.js → chunk-K42M2KWT.js} +2 -2
  55. package/dist/{chunk-H7UKLTWJ.js → chunk-KLVJABXA.js} +2 -2
  56. package/dist/chunk-KP4KBDVF.js +3 -0
  57. package/dist/{chunk-RV2FQIX3.js → chunk-LMFVTUW2.js} +2 -2
  58. package/dist/chunk-LRTP3DKL.js +3 -0
  59. package/dist/{chunk-U6WNH5GC.js → chunk-MGBJHRFB.js} +2 -2
  60. package/dist/{chunk-QDV6RDCP.js → chunk-MLGTCX56.js} +2 -2
  61. package/dist/{chunk-54HA4ZXH.js → chunk-N3SE646F.js} +2 -2
  62. package/dist/{chunk-KP6XRY5Z.js → chunk-NBRUH7OE.js} +2 -2
  63. package/dist/{chunk-M7AIS73L.js → chunk-NN4ZIRPK.js} +2 -2
  64. package/dist/{chunk-I5RJM53C.js → chunk-NQLSSVOB.js} +2 -2
  65. package/dist/{chunk-4SALD7RU.js → chunk-OBKDTVZ3.js} +2 -2
  66. package/dist/{chunk-GBQ5NYPR.js → chunk-OHWZKLVA.js} +6 -6
  67. package/dist/{chunk-6NSFJYRC.js → chunk-OP3MTFJR.js} +2 -2
  68. package/dist/{chunk-EOOJGLDU.js → chunk-OQ2A4G2G.js} +2 -2
  69. package/dist/{chunk-DLWR3NUU.js → chunk-P6HBYNBE.js} +2 -2
  70. package/dist/{chunk-QVWS2VWZ.js → chunk-PC44K7RF.js} +2 -2
  71. package/dist/{chunk-A2EZV2UM.js → chunk-QBYYWGAT.js} +2 -2
  72. package/dist/{chunk-QRGV2F7L.js → chunk-QHKUY4FW.js} +2 -2
  73. package/dist/chunk-QHRL4LKM.js +2 -0
  74. package/dist/{chunk-I5AWSI2G.js → chunk-QQWOFXNW.js} +2 -2
  75. package/dist/{chunk-WQTAC523.js → chunk-RBFFD4V2.js} +2 -2
  76. package/dist/{chunk-SOAT6NLA.js → chunk-RJHCPSZ7.js} +2 -2
  77. package/dist/{chunk-VGRICIQI.js → chunk-RWRLUZ6U.js} +2 -2
  78. package/dist/{chunk-4T3LTWUS.js → chunk-S2GP3CU3.js} +2 -2
  79. package/dist/{chunk-HEXVUYFQ.js → chunk-SHKZ7OVJ.js} +2 -2
  80. package/dist/{chunk-NSS46APD.js → chunk-TFUU5MQQ.js} +2 -2
  81. package/dist/{chunk-IUFDSKGG.js → chunk-TYQ76QHQ.js} +2 -2
  82. package/dist/{chunk-NRCXJDHL.js → chunk-U5CNPPTZ.js} +2 -2
  83. package/dist/{chunk-MITTUCEH.js → chunk-UQK5CRUK.js} +2 -2
  84. package/dist/{chunk-XLTP42QA.js → chunk-UUJBLG6J.js} +2 -2
  85. package/dist/chunk-UXP636P5.js +144 -0
  86. package/dist/{chunk-64RFXJT5.js → chunk-VEVBIAOJ.js} +6 -6
  87. package/dist/chunk-VKRQDBW5.js +9 -0
  88. package/dist/{chunk-C7NIYIQ4.js → chunk-VOQFGC2W.js} +4 -4
  89. package/dist/{chunk-DZ74OMG6.js → chunk-VP542C25.js} +2 -2
  90. package/dist/{chunk-Q3AFUTGB.js → chunk-WMXRRBII.js} +2 -2
  91. package/dist/{chunk-ZGZUZ7XE.js → chunk-WXAAURU7.js} +2 -2
  92. package/dist/chunk-X3NLZHPA.js +20 -0
  93. package/dist/{chunk-WER3B7MI.js → chunk-XF3KLXN3.js} +2 -2
  94. package/dist/{chunk-NH5ALKPW.js → chunk-XVJ3V7LM.js} +2 -2
  95. package/dist/{chunk-4XTA5OMB.js → chunk-YGQN3XGZ.js} +2 -2
  96. package/dist/{chunk-CFMXJPHH.js → chunk-YHXBD52M.js} +2 -2
  97. package/dist/{chunk-7B3UPBVA.js → chunk-YLVE3SXZ.js} +2 -2
  98. package/dist/{chunk-YIJ7ZAA4.js → chunk-YTUD45PU.js} +2 -2
  99. package/dist/{chunk-VTKGCT3V.js → chunk-YWB2EBNB.js} +2 -2
  100. package/dist/{chunk-UKZBVX4U.js → chunk-Z2LHPIOM.js} +2 -2
  101. package/dist/chunk-Z5QQPJ3U.js +30 -0
  102. package/dist/{chunk-NZL2DBT7.js → chunk-ZLJLE6LK.js} +2 -2
  103. package/dist/{chunk-XYADIZHU.js → chunk-ZTTISZ7J.js} +2 -2
  104. package/dist/cli.js +3 -3
  105. package/dist/command-descriptors-SJDZ7QGR.js +617 -0
  106. package/dist/{config-types-D20KuvvZ.d.ts → config-types-BWQ5xPGI.d.ts} +4 -0
  107. package/dist/{db-G_II8yXU.d.ts → db-B0r1o7Vt.d.ts} +18 -1
  108. package/dist/direct-navigation-HTKOZEOM.js +3 -0
  109. package/dist/{health-oblXYgkF.d.ts → health-CFnlCiTz.d.ts} +1 -1
  110. package/dist/index.d.ts +2 -2
  111. package/dist/index.js +1 -1
  112. package/dist/postinstall.js +1 -1
  113. package/dist/queries/affected.d.ts +2 -2
  114. package/dist/queries/affected.js +1 -1
  115. package/dist/queries/architecture.d.ts +2 -2
  116. package/dist/queries/architecture.js +1 -1
  117. package/dist/queries/bottlenecks.d.ts +2 -2
  118. package/dist/queries/bottlenecks.js +1 -1
  119. package/dist/queries/by-kind.d.ts +2 -2
  120. package/dist/queries/by-kind.js +1 -1
  121. package/dist/queries/call-graph.d.ts +2 -2
  122. package/dist/queries/call-graph.js +1 -1
  123. package/dist/queries/change-surface.d.ts +2 -2
  124. package/dist/queries/change-surface.js +1 -1
  125. package/dist/queries/cleanup-plan.d.ts +2 -2
  126. package/dist/queries/cleanup-plan.js +1 -1
  127. package/dist/queries/co-change.d.ts +2 -2
  128. package/dist/queries/co-change.js +1 -1
  129. package/dist/queries/code.d.ts +2 -2
  130. package/dist/queries/code.js +1 -1
  131. package/dist/queries/complexity-hotspots.d.ts +2 -2
  132. package/dist/queries/complexity-hotspots.js +1 -1
  133. package/dist/queries/complexity.d.ts +2 -2
  134. package/dist/queries/complexity.js +1 -1
  135. package/dist/queries/convergence.d.ts +2 -2
  136. package/dist/queries/convergence.js +1 -1
  137. package/dist/queries/coupling.d.ts +2 -2
  138. package/dist/queries/coupling.js +1 -1
  139. package/dist/queries/cycles.d.ts +2 -2
  140. package/dist/queries/cycles.js +1 -1
  141. package/dist/queries/dataflow.d.ts +2 -2
  142. package/dist/queries/dataflow.js +1 -1
  143. package/dist/queries/dead.d.ts +2 -2
  144. package/dist/queries/dead.js +1 -1
  145. package/dist/queries/decorative-checkers.d.ts +3 -3
  146. package/dist/queries/decorative-checkers.js +1 -1
  147. package/dist/queries/deep-chains.d.ts +2 -2
  148. package/dist/queries/deep-chains.js +1 -1
  149. package/dist/queries/deps.d.ts +2 -2
  150. package/dist/queries/deps.js +1 -1
  151. package/dist/queries/diff-gate.d.ts +30 -2
  152. package/dist/queries/diff-gate.js +1 -1
  153. package/dist/queries/diff-impact.d.ts +2 -2
  154. package/dist/queries/diff-impact.js +1 -1
  155. package/dist/queries/doc-drift.d.ts +2 -2
  156. package/dist/queries/doc-drift.js +1 -1
  157. package/dist/queries/drift.d.ts +2 -2
  158. package/dist/queries/drift.js +1 -1
  159. package/dist/queries/duplicate-bodies.d.ts +2 -2
  160. package/dist/queries/duplicate-bodies.js +1 -1
  161. package/dist/queries/extract-candidates.d.ts +2 -2
  162. package/dist/queries/extract-candidates.js +1 -1
  163. package/dist/queries/fan.d.ts +2 -2
  164. package/dist/queries/fan.js +1 -1
  165. package/dist/queries/files.d.ts +2 -2
  166. package/dist/queries/health.d.ts +3 -3
  167. package/dist/queries/health.js +1 -1
  168. package/dist/queries/hierarchy.d.ts +2 -2
  169. package/dist/queries/hierarchy.js +1 -1
  170. package/dist/queries/hotspots.d.ts +2 -2
  171. package/dist/queries/hotspots.js +1 -1
  172. package/dist/queries/imports.d.ts +2 -2
  173. package/dist/queries/imports.js +1 -1
  174. package/dist/queries/incomplete-migration.d.ts +2 -2
  175. package/dist/queries/incomplete-migration.js +1 -1
  176. package/dist/queries/index.d.ts +17 -3
  177. package/dist/queries/index.js +1 -1
  178. package/dist/queries/isolated.d.ts +2 -2
  179. package/dist/queries/isolated.js +1 -1
  180. package/dist/queries/locality-candidates.d.ts +2 -2
  181. package/dist/queries/locality-candidates.js +1 -1
  182. package/dist/queries/members.d.ts +2 -2
  183. package/dist/queries/members.js +1 -1
  184. package/dist/queries/methods.d.ts +2 -2
  185. package/dist/queries/methods.js +1 -1
  186. package/dist/queries/not-implemented.d.ts +3 -3
  187. package/dist/queries/not-implemented.js +1 -1
  188. package/dist/queries/outline.d.ts +2 -2
  189. package/dist/queries/outline.js +1 -1
  190. package/dist/queries/passthrough-candidates.d.ts +2 -2
  191. package/dist/queries/passthrough-candidates.js +1 -1
  192. package/dist/queries/plan-context.d.ts +2 -2
  193. package/dist/queries/plan-context.js +1 -1
  194. package/dist/queries/react-component-duplicates.d.ts +2 -2
  195. package/dist/queries/react-component-duplicates.js +1 -1
  196. package/dist/queries/react-hook-candidates.d.ts +2 -2
  197. package/dist/queries/react-hook-candidates.js +1 -1
  198. package/dist/queries/react-large-component-pressure.d.ts +2 -2
  199. package/dist/queries/react-large-component-pressure.js +1 -1
  200. package/dist/queries/recent-duplicates.d.ts +2 -2
  201. package/dist/queries/recent-duplicates.js +1 -1
  202. package/dist/queries/redundant-reexports.d.ts +2 -2
  203. package/dist/queries/redundant-reexports.js +1 -1
  204. package/dist/queries/refs.d.ts +2 -2
  205. package/dist/queries/refs.js +1 -1
  206. package/dist/queries/self-audit.d.ts +2 -2
  207. package/dist/queries/self-audit.js +1 -1
  208. package/dist/queries/similar-chains.d.ts +2 -2
  209. package/dist/queries/similar-chains.js +1 -1
  210. package/dist/queries/similar-files.d.ts +2 -2
  211. package/dist/queries/similar-files.js +1 -1
  212. package/dist/queries/similar-signatures.d.ts +2 -2
  213. package/dist/queries/similar-signatures.js +1 -1
  214. package/dist/queries/similar.d.ts +2 -2
  215. package/dist/queries/similar.js +1 -1
  216. package/dist/queries/slice.d.ts +2 -2
  217. package/dist/queries/slice.js +1 -1
  218. package/dist/queries/stale-abstractions.d.ts +2 -2
  219. package/dist/queries/stale-abstractions.js +1 -1
  220. package/dist/queries/stats.d.ts +2 -2
  221. package/dist/queries/stats.js +1 -1
  222. package/dist/queries/surface.d.ts +2 -2
  223. package/dist/queries/surface.js +1 -1
  224. package/dist/queries/symbols.d.ts +2 -2
  225. package/dist/queries/symbols.js +1 -1
  226. package/dist/queries/system.d.ts +2 -2
  227. package/dist/queries/system.js +1 -1
  228. package/dist/queries/test-quality.d.ts +2 -2
  229. package/dist/queries/test-quality.js +1 -1
  230. package/dist/queries/trace.d.ts +2 -2
  231. package/dist/queries/trace.js +1 -1
  232. package/dist/queries/twin-ab.d.ts +3 -3
  233. package/dist/queries/twin-ab.js +1 -1
  234. package/dist/queries/twin-drift.d.ts +2 -2
  235. package/dist/queries/twin-drift.js +1 -1
  236. package/dist/queries/unused-imports.d.ts +2 -2
  237. package/dist/queries/unused-imports.js +1 -1
  238. package/dist/queries/unused-params.d.ts +2 -2
  239. package/dist/queries/unused-params.js +1 -1
  240. package/dist/queries/vue-component-duplicates.d.ts +2 -2
  241. package/dist/queries/vue-component-duplicates.js +1 -1
  242. package/dist/queries/vue-composable-candidates.d.ts +2 -2
  243. package/dist/queries/vue-composable-candidates.js +1 -1
  244. package/dist/queries/vue-large-view-pressure.d.ts +2 -2
  245. package/dist/queries/vue-large-view-pressure.js +1 -1
  246. package/dist/queries/wrapper-candidates.d.ts +2 -2
  247. package/dist/queries/wrapper-candidates.js +1 -1
  248. package/dist/reindex-worker.js +23 -24
  249. package/dist/reindex.d.ts +10 -4
  250. package/dist/reindex.js +33 -38
  251. package/dist/runtime.d.ts +167 -11
  252. package/dist/runtime.js +3 -2
  253. package/dist/rust-semantic-session-server.js +1 -1
  254. package/dist/rust-semantic-session-worker.js +1 -1
  255. package/dist/rust-semantic-worker.js +1 -1
  256. package/dist/{scip-cli-kRpaexVJ.d.ts → scip-cli-DCvnlZCu.d.ts} +5 -1
  257. package/dist/watch-server.js +5 -5
  258. package/docs/AGENT_GUIDE.md +1 -1
  259. package/docs/AI_FAILURE_MODES.md +18 -18
  260. package/docs/API_EVOLUTION.md +71 -0
  261. package/docs/CLI_JSON_OUTPUT.md +83 -0
  262. package/docs/COMMAND_REFERENCE.md +10 -8
  263. package/docs/COMMITTED_RECORD_COMPATIBILITY.md +117 -0
  264. package/docs/CONFIGURATION_WRITE_SAFETY.md +130 -0
  265. package/docs/DETECTOR_GUIDE.md +47 -47
  266. package/docs/DURABILITY.md +103 -0
  267. package/docs/INDEX_GENERATIONS.md +121 -0
  268. package/docs/LOCK_PROTOCOL.md +133 -0
  269. package/docs/MAILBOX_LIFECYCLE.md +197 -0
  270. package/docs/REINDEX_METADATA_COMPATIBILITY.md +84 -0
  271. package/docs/RUST_DURABLE_SESSION_PROTOCOL.md +126 -0
  272. package/docs/TELEMETRY_RETENTION.md +72 -0
  273. package/docs/TIME_SEMANTICS.md +77 -0
  274. package/docs/WATCH_REFRESH_REQUESTS.md +110 -0
  275. package/docs/WINDOWS_SIDECAR_RELEASE.md +298 -0
  276. package/docs/analyzer-validation-ledger.md +24 -23
  277. package/docs/schemas/cli-json-envelope.schema.json +53 -0
  278. package/docs/schemas/npm-release-state.schema.json +146 -0
  279. package/docs/schemas/outcome-event-record.schema.json +39 -0
  280. package/docs/schemas/project-config.schema.json +247 -0
  281. package/docs/schemas/suppression-record.schema.json +31 -0
  282. package/docs/schemas/windows-sidecar-provenance.schema.json +137 -0
  283. package/package.json +15 -5
  284. package/scripts/build-scip-windows.mjs +180 -61
  285. package/scripts/scip-windows-provenance.mjs +364 -0
  286. package/scripts/verify-scip-windows.mjs +29 -0
  287. package/skills/_shared/SKILL.md +91 -242
  288. package/skills/_shared/agents/openai.yaml +1 -1
  289. package/skills/_shared/references/agent-contract-catalog.md +105 -0
  290. package/skills/_shared/references/command-catalog.md +118 -0
  291. package/skills/_shared/references/detector-precision-and-diffgate.md +59 -0
  292. package/skills/_shared/references/evidence-and-dead-code.md +25 -0
  293. package/skills/scip-audit/SKILL.md +76 -0
  294. package/skills/scip-audit/agents/openai.yaml +4 -0
  295. package/skills/scip-audit/references/claims.md +98 -0
  296. package/skills/scip-audit/references/cleanup.md +101 -0
  297. package/skills/scip-audit/references/directory.md +222 -0
  298. package/skills/scip-audit/references/frontend.md +130 -0
  299. package/skills/scip-audit/references/integrity.md +154 -0
  300. package/skills/scip-audit/references/maintainability.md +162 -0
  301. package/skills/scip-audit/references/twin-drift.md +104 -0
  302. package/skills/scip-diagnose/SKILL.md +52 -0
  303. package/skills/scip-diagnose/agents/openai.yaml +4 -0
  304. package/skills/scip-diagnose/references/debug.md +117 -0
  305. package/skills/{scip-probe-reachability/SKILL.md → scip-diagnose/references/probe-reachability.md} +12 -27
  306. package/skills/scip-diagnose/references/root-cause.md +145 -0
  307. package/skills/scip-diagnose/references/triage.md +119 -0
  308. package/skills/scip-explore/SKILL.md +53 -84
  309. package/skills/scip-explore/agents/openai.yaml +2 -2
  310. package/skills/scip-explore/references/diagrams.md +40 -0
  311. package/skills/scip-explore/references/language-playbook.md +49 -0
  312. package/skills/scip-improve/SKILL.md +56 -0
  313. package/skills/scip-improve/agents/openai.yaml +4 -0
  314. package/skills/scip-improve/references/cleanup-batches.md +53 -0
  315. package/skills/scip-improve/references/directory-moves.md +53 -0
  316. package/skills/scip-improve/references/doc-reconcile.md +30 -0
  317. package/skills/scip-improve/references/frontend-extraction.md +39 -0
  318. package/skills/scip-improve/references/maintainability-mechanism.md +43 -0
  319. package/skills/scip-improve/references/twin-drift.md +35 -0
  320. package/skills/scip-plan/SKILL.md +68 -0
  321. package/skills/scip-plan/agents/openai.yaml +4 -0
  322. package/skills/scip-plan/references/api-impact.md +19 -0
  323. package/skills/scip-plan/references/conductor.md +41 -0
  324. package/skills/scip-plan/references/high-assurance.md +43 -0
  325. package/skills/scip-plan/references/hyper-optimization.md +50 -0
  326. package/skills/scip-plan/references/tla-model.md +88 -0
  327. package/skills/scip-query/SKILL.md +52 -97
  328. package/skills/scip-query/agents/openai.yaml +2 -2
  329. package/skills/scip-setup/SKILL.md +65 -176
  330. package/skills/scip-setup/agents/openai.yaml +3 -3
  331. package/skills/scip-setup/references/bootstrap-workflow.md +120 -0
  332. package/skills/scip-setup/references/language-verification.md +61 -0
  333. package/skills/scip-setup/references/lifecycle-commands.md +119 -0
  334. package/skills/scip-setup/references/per-repo-triage.md +24 -0
  335. package/skills/scip-verify/SKILL.md +123 -70
  336. package/skills/scip-verify/agents/openai.yaml +2 -2
  337. package/skills/scip-verify/references/calibrate-detectors.md +170 -0
  338. package/dist/chunk-2CTX5CMX.js +0 -4
  339. package/dist/chunk-2Y373BDD.js +0 -2
  340. package/dist/chunk-C2QSK7E7.js +0 -2
  341. package/dist/chunk-D4U5Q3FT.js +0 -7
  342. package/dist/chunk-K2ERX4UT.js +0 -3
  343. package/dist/chunk-KHE7J5ZN.js +0 -3
  344. package/dist/chunk-L7SPDE73.js +0 -84
  345. package/dist/chunk-LHMNRHGV.js +0 -3
  346. package/dist/chunk-LM72NQ7T.js +0 -3
  347. package/dist/chunk-MSWVMDAH.js +0 -122
  348. package/dist/chunk-NH7WNNQC.js +0 -20
  349. package/dist/chunk-OMPZHGHO.js +0 -2
  350. package/dist/chunk-SVLTAG5O.js +0 -927
  351. package/dist/chunk-U7DSEKOM.js +0 -30
  352. package/dist/chunk-V27BEQJN.js +0 -7
  353. package/dist/chunk-VMNZB6WI.js +0 -4
  354. package/dist/chunk-XBN5VO53.js +0 -2
  355. package/dist/chunk-ZAIILQNP.js +0 -5
  356. package/dist/command-descriptors-MFU4BCJ7.js +0 -612
  357. package/dist/direct-navigation-MRMQFIRB.js +0 -3
  358. package/skills/scip-api-impact/SKILL.md +0 -139
  359. package/skills/scip-api-impact/agents/openai.yaml +0 -4
  360. package/skills/scip-calibrate/SKILL.md +0 -131
  361. package/skills/scip-calibrate/agents/openai.yaml +0 -4
  362. package/skills/scip-claim-audit/SKILL.md +0 -106
  363. package/skills/scip-claim-audit/agents/openai.yaml +0 -4
  364. package/skills/scip-cleanup-audit/SKILL.md +0 -126
  365. package/skills/scip-cleanup-audit/agents/openai.yaml +0 -4
  366. package/skills/scip-cleanup-improve/SKILL.md +0 -84
  367. package/skills/scip-cleanup-improve/agents/openai.yaml +0 -4
  368. package/skills/scip-concrete-plan/SKILL.md +0 -262
  369. package/skills/scip-concrete-plan/agents/openai.yaml +0 -4
  370. package/skills/scip-conductor/SKILL.md +0 -133
  371. package/skills/scip-conductor/agents/openai.yaml +0 -4
  372. package/skills/scip-debug/SKILL.md +0 -130
  373. package/skills/scip-debug/agents/openai.yaml +0 -4
  374. package/skills/scip-diagram/SKILL.md +0 -110
  375. package/skills/scip-diagram/agents/openai.yaml +0 -4
  376. package/skills/scip-directory-architecture/SKILL.md +0 -254
  377. package/skills/scip-directory-architecture/agents/openai.yaml +0 -4
  378. package/skills/scip-doc-reconcile/SKILL.md +0 -89
  379. package/skills/scip-doc-reconcile/agents/openai.yaml +0 -4
  380. package/skills/scip-hyper-optimization/SKILL.md +0 -156
  381. package/skills/scip-hyper-optimization/agents/openai.yaml +0 -4
  382. package/skills/scip-integrity-audit/SKILL.md +0 -152
  383. package/skills/scip-integrity-audit/agents/openai.yaml +0 -4
  384. package/skills/scip-language-playbook/SKILL.md +0 -106
  385. package/skills/scip-language-playbook/agents/openai.yaml +0 -4
  386. package/skills/scip-maintainability/SKILL.md +0 -158
  387. package/skills/scip-maintainability/agents/openai.yaml +0 -4
  388. package/skills/scip-probe-reachability/agents/openai.yaml +0 -4
  389. package/skills/scip-react-maintainability/SKILL.md +0 -101
  390. package/skills/scip-react-maintainability/agents/openai.yaml +0 -4
  391. package/skills/scip-root-cause/SKILL.md +0 -150
  392. package/skills/scip-root-cause/agents/openai.yaml +0 -4
  393. package/skills/scip-tla-model-system/SKILL.md +0 -148
  394. package/skills/scip-tla-model-system/agents/openai.yaml +0 -4
  395. package/skills/scip-triage-issue/SKILL.md +0 -126
  396. package/skills/scip-triage-issue/agents/openai.yaml +0 -4
  397. package/skills/scip-twin-drift/SKILL.md +0 -107
  398. package/skills/scip-twin-drift/agents/openai.yaml +0 -4
  399. package/skills/scip-vue-maintainability/SKILL.md +0 -107
  400. package/skills/scip-vue-maintainability/agents/openai.yaml +0 -4
@@ -1,3 +0,0 @@
1
- #!/usr/bin/env node
2
- import{n as a}from"./chunk-ZAIILQNP.js";import"./chunk-SVLTAG5O.js";export{a as directNavigationQueryCommandDescriptors};
3
- //# sourceMappingURL=direct-navigation-MRMQFIRB.js.map
@@ -1,139 +0,0 @@
1
- ---
2
- name: scip-api-impact
3
- description: Assess API impact with scip-query evidence. Use before changing public exports, module boundaries, schemas, routes, CLI commands, config fields, generated artifacts, signatures, docs-backed behavior, or consumer migrations.
4
- commands:
5
- - template: "scip-query surface <module-or-package>"
6
- when: "Identify the surface: what consumers actually use from the module."
7
- - template: "scip-query refs <symbol>"
8
- when: "Find consumers: every direct reference to the surface symbol."
9
- - template: "scip-query affected <symbol> --json"
10
- when: "Find consumers: transitive blast radius of the change."
11
- - template: "scip-query co-change <file> --json --full"
12
- when: "Find hidden partners: historically coupled files without a dependency edge."
13
- - template: "scip-query doc-drift --json --full"
14
- when: "Find hidden partners: docs that describe the surface and may need an update."
15
- - template: "scip-query unused-params --json --full"
16
- when: "Choose migration shape: reject speculative new parameters."
17
- ---
18
-
19
- # scip-api-impact
20
-
21
- Use this skill before changing a public surface. A public surface is a callable, export, route, schema, config field, CLI command, generated artifact, or documented behavior that other code or users can depend on. Its defining trait is that a local edit can require coordinated consumer, docs, tests, or migration changes outside the implementation file.
22
-
23
- Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
24
-
25
- <!-- BEGIN GENERATED SKILL COMMANDS -->
26
- ## Commands for this skill
27
-
28
- | Command | Purpose | When |
29
- | --- | --- | --- |
30
- | `scip-query surface <module-or-package>` | What symbols consumers actually use from this module | Identify the surface: what consumers actually use from the module. |
31
- | `scip-query refs <symbol>` | Find all files referencing a symbol | Find consumers: every direct reference to the surface symbol. |
32
- | `scip-query affected <symbol> --json` | Transitive closure of symbols that could break if this symbol changes | Find consumers: transitive blast radius of the change. |
33
- | `scip-query co-change <file> --json --full` | Files that change together in git history without a dependency edge — hidden coupling candidates | Find hidden partners: historically coupled files without a dependency edge. |
34
- | `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | Find hidden partners: docs that describe the surface and may need an update. |
35
- | `scip-query unused-params --json --full` | Speculative-generality candidates: trailing parameters no body ever uses (TS/JS) | Choose migration shape: reject speculative new parameters. |
36
-
37
- Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
38
- <!-- END GENERATED SKILL COMMANDS -->
39
-
40
- ## Rules
41
-
42
- 1. Identify the actual surface before planning.
43
- 2. Find direct consumers, reverse dependencies, transitive blast radius, and historical co-change partners.
44
- 3. Treat docs, generated files, tests, and config as part of the API when they describe or enforce the surface.
45
- 4. Prefer backward-compatible migrations when consumers are broad or external.
46
- 5. Run `scip-verify` after implementation.
47
-
48
- ## Workflow
49
-
50
- ### 1. Identify the surface
51
-
52
- ```bash
53
- scip-query surface <module-or-package>
54
- scip-query outline <file>
55
- scip-query trace <symbol-or-command>
56
- scip-query code <symbol-or-command>
57
- scip-query hierarchy <symbol> --json
58
- ```
59
-
60
- This step is complete only when the real surface is named: member, class, module, package, route, schema, command, or config field.
61
-
62
- ### 2. Find consumers
63
-
64
- ```bash
65
- scip-query refs <symbol>
66
- scip-query fan-in <symbol>
67
- scip-query rdeps <file>
68
- scip-query affected <symbol> --json
69
- scip-query change-surface <file> --json --full
70
- ```
71
-
72
- Record direct consumers separately from transitive consumers.
73
-
74
- This step is complete only when direct breakage and regression blast radius are known.
75
-
76
- ### 3. Find hidden partners
77
-
78
- ```bash
79
- scip-query co-change <file> --json --full
80
- scip-query doc-drift --json --full
81
- scip-query similar <symbol> --json --full
82
- scip-query similar-files <file> --json --full
83
- ```
84
-
85
- This step is complete only when docs, generated files, fixtures, sibling APIs, and hand-synchronized partners are accounted for or ruled out.
86
-
87
- ### 4. Choose migration shape
88
-
89
- Pick one:
90
-
91
- - Compatible extension.
92
- - Two-step migration.
93
- - Breaking coordinated change.
94
- - Adapter shim for external consumers or compatibility windows.
95
-
96
- Reject speculative inputs and empty wrappers with:
97
-
98
- ```bash
99
- scip-query unused-params --json --full
100
- scip-query wrapper-candidates --json --full
101
- scip-query passthrough-candidates --json --full
102
- ```
103
-
104
- This step is complete only when the migration shape explains deploy order, rollback, and compatibility risk.
105
-
106
- ### 5. Build and verify the plan
107
-
108
- ```markdown
109
- Surface:
110
- Consumer dispositions:
111
- | Consumer | Kind (direct/transitive/doc/config/test) | Disposition (unchanged-safe/update/shim/defer) |
112
- | --- | --- | --- |
113
- Required co-changes:
114
- Migration:
115
- Verification:
116
- - targeted tests
117
- - `scip-query diff-impact --json`
118
- - invoke `scip-verify`
119
- - `scip-query doc-drift --json --full` when docs changed
120
- - `scip-query config-validate` when config changed
121
- ```
122
-
123
- Every consumer from `refs`/`affected` appears as a row — a blank disposition is unfinished analysis, and the plan is not complete while one exists. Non-indexed consumers (SQL, fixtures, dynamic strings, external callers) are checked with `rg` and rowed the same way.
124
-
125
- After editing, run routed checks from the shared reference and invoke `scip-verify`.
126
-
127
- The work is complete only when direct consumers, docs/config partners, and `scip-verify` have been checked.
128
-
129
- ## Report
130
-
131
- ```markdown
132
- API impact: low/medium/high
133
- Surface changed:
134
- Consumers:
135
- Migration plan:
136
- Co-changes:
137
- Verification:
138
- Remaining risk:
139
- ```
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "SCIP API Impact"
3
- short_description: "Assess public API and boundary change impact"
4
- default_prompt: "Assess the impact of this public API or module-boundary change with scip-query evidence and produce a migration-safe plan."
@@ -1,131 +0,0 @@
1
- ---
2
- name: scip-calibrate
3
- description: Calibrate scip-query's detectors against a repo before trusting them. Use when adopting scip-query in a new or foreign codebase, after major detector changes, when a health score or gate output seems too noisy or too clean, or before letting diff-gate block anyone's work.
4
- commands:
5
- - scip-query health --json
6
- - scip-query diff-gate --base <commit> --json
7
- - scip-query twin-drift -s <scope> --json
8
- - scip-query dead --json
9
- - scip-query similar <symbol>
10
- - scip-query config-validate
11
- - scip-query effectiveness --since 30d --json
12
- ---
13
-
14
- # scip-calibrate
15
-
16
- Use this skill to measure whether scip-query's detectors tell the truth about a
17
- specific repository before believing anything they say about it. A detector
18
- tuned on one codebase's conventions can be precise there and noisy elsewhere;
19
- calibration is how you find out which you have — and it converts every noise
20
- archetype you find into either a repo-side knob or an upstream detector bug.
21
-
22
- Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
23
-
24
- ## The Stance
25
-
26
- A health score you have not calibrated is a number, not a fact. Never present
27
- detector output from an uncalibrated repo as findings — present it as
28
- candidate findings pending classification. The score must EARN trust the same
29
- way a checker earns it in `scip-integrity-audit`: by being witnessed telling
30
- the truth on samples you verified yourself.
31
-
32
- ## Protocol
33
-
34
- Run all five stages. Each has a checkable exit.
35
-
36
- ### 1. Index and inventory
37
-
38
- `scip-query reindex`, then `scip-query status --capabilities`. Record which
39
- languages got which evidence tier (SCIP-indexed vs source-fallback vs regex) —
40
- a detector's expected precision differs per tier, and a repo that is 80%
41
- fallback-tier must be judged against fallback expectations. Note monorepo
42
- shape (workspaces, cross-package imports): historically the single largest
43
- false-positive source (dead/new-dead on cross-package consumers).
44
- Complete when: languages, tiers, and workspace shape are written down.
45
-
46
- ### 2. Battery sweep
47
-
48
- Run the full detector battery and `health --json`. Do not react to anything
49
- yet — big numbers are not findings, they are sampling frames.
50
- Complete when: every detector's finding count is recorded.
51
-
52
- ### 3. Retro-gate replay
53
-
54
- Replay `diff-gate` against the last 15–20 real commits (worktree per commit,
55
- never the user's live tree). This is the stage that exposes finding WALLS —
56
- one hub file or one convention mismatch generating dozens of near-identical
57
- findings per commit. A wall is always either a missing repo knob or a detector
58
- bug; it is never "the repo is just bad."
59
- Complete when: per-commit finding counts and every wall are recorded.
60
-
61
- ### 4. Sample and classify — the actual calibration
62
-
63
- For each detector with findings: sample about 10 (all of them if fewer),
64
- READ THE CODE at each site, and classify actionable vs noise. Two rules make
65
- this real calibration instead of theater:
66
-
67
- - Classify from the code, never from the finding text. A finding that sounds
68
- plausible and a finding that is true are different things; the difference is
69
- only visible at the cited file and line.
70
- - For every noise finding, name the ARCHETYPE (e.g. "type-only import
71
- invisible to indexer", "delegation chain flagged as twin", "generic shared
72
- helpers saturating similarity"). Archetypes are the deliverable: a noise
73
- rate without archetypes cannot be fixed.
74
-
75
- Then give each detector a verdict: **keep** (precision acceptable), **retune**
76
- (name the threshold and the value), or **demote to advisory** for this repo.
77
- Complete when: every detector has sampled precision, named archetypes, and a
78
- verdict.
79
-
80
- ### 5. Tune the knobs, file the bugs
81
-
82
- Apply repo-side fixes for what belongs to the repo, and file upstream for what
83
- belongs to the detector:
84
-
85
- - `.scipquery.json` suppressions — one per accepted finding, WITH a reason;
86
- a reasonless suppression is hiding, not tuning.
87
- - `docs.snapshotPaths` — dated/archival docs that must never generate
88
- doc-reference findings.
89
- - Coverage contracts — enumerations the gate should police.
90
- - `commandAnalysisBudget` — cap analysis honestly on very large indexes.
91
- - Detector bugs (noise archetypes no knob can express) go to the tool's
92
- followup ledger with the archetype, a concrete example, and the sampled
93
- rate. Never tune a threshold to hide an archetype — that trades visible
94
- noise for invisible blindness.
95
-
96
- Complete when: the gate replay from stage 3 re-runs materially quieter, and
97
- every remaining finding class is either actionable, suppressed-with-reason, or
98
- filed upstream.
99
-
100
- ## Failure Modes (each observed in a real calibration)
101
-
102
- - **Sampling too few.** One good finding does not make a detector precise;
103
- one bad finding does not make it noise. Ten per detector is the floor.
104
- - **Classifying from the finding text.** The finding always sounds right —
105
- it was generated to. Only the code knows.
106
- - **Tuning to green.** Raising a threshold until the noise disappears also
107
- disappears the real findings. If the archetype is a detector bug, file it
108
- and live with the noise until it is fixed.
109
- - **Trusting a clean run.** Zero findings on a detector can mean precision or
110
- can mean the detector cannot see this repo's conventions at all (wrong
111
- import style, unindexed language). Verify at least one known-true positive
112
- per major detector — plant one if none exists.
113
- - **Calibrating the wrong tree.** Clones or worktrees for anything that
114
- mutates; the target repo is read-only unless its owner said otherwise.
115
-
116
- ## After Calibration
117
-
118
- The finding-outcome ledger keeps calibrating for you: once the repo uses
119
- diff-gate, per-detector precision is recomputed from real outcomes
120
- (`detectorPrecision` in `health --json`), and the committed event ledger
121
- makes those outcomes durable and queryable — `scip-query effectiveness
122
- --since 30d --json` reports per-check caught/comparison-verified-fixed/
123
- suppressed/open/unverified counts, precision, and median days-to-fix from the
124
- individual records under `.scipquery/events/*.json`. Run diff-gate before and
125
- after the repair. If `HEAD` advances, use a clean worktree so scip-query can
126
- replay the stored comparison base instead of mistaking an empty diff for a fix.
127
- Re-run this protocol only after major detector upgrades or when the
128
- ledger's precision numbers drift from what you measured. Write the calibration report to
129
- `docs/validation/YYYY-MM-DD-external-calibration-<repo>.md` in the shape of
130
- the exemplars this skill was distilled from — battery table, retro-gate
131
- walls, per-detector verdicts, noise archetypes, caps and deviations.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "scip calibrate"
3
- short_description: "Measure scip-query's detector precision on a repo before trusting scores or gating anyone."
4
- default_prompt: "Run the scip-calibrate protocol against this repository: battery sweep, retro-gate replay, sample-and-classify each detector from the code, then tune repo knobs and file detector bugs."
@@ -1,106 +0,0 @@
1
- ---
2
- name: scip-claim-audit
3
- description: Audit output-facing status claims for evidence with scip-query. Use to classify whether an "available", "verified", "safe", "PASS", or "complete" status word is derived from a real check, hedged as a candidate, or merely asserted without being probed.
4
- commands:
5
- - template: "scip-query files <pattern>"
6
- when: "Inventory: locate the renderer or status-producing module for a claim."
7
- - template: "scip-query refs <symbol>"
8
- when: "Classify: find every producer and consumer of a status-bearing function."
9
- - template: "scip-query code <symbol>"
10
- when: "Classify: read the producing function to see whether it computes or asserts."
11
- - template: "scip-query trace <symbol>"
12
- when: "Classify: definition plus every reference for a status field or constant."
13
- - template: "scip-query capabilities --matrix --json"
14
- when: "Spot-check: an already-known example of a fixed derived-status surface."
15
- ---
16
-
17
- # scip-claim-audit
18
-
19
- Use this skill to find agent-facing claims that sound verified but are not. A status word is **derived** when its producer computes it from a real probe, scan, or computation (a compiler run, a runtime capability probe, a graph traversal). It is **hedged** when the code or its label already says it is a candidate, heuristic, or unverified. It is **asserted** when the value is a constant, a hardcoded table entry, or a string literal presented with the same confidence as a derived value but backed by nothing the code actually checked at that call site. Asserted status words that are agent-facing and trust-bearing (an agent would route a decision — "use this evidence", "skip this check", "delete this" — based on the word) are the highest-severity class this skill exists to find.
20
-
21
- Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
22
-
23
- <!-- BEGIN GENERATED SKILL COMMANDS -->
24
- ## Commands for this skill
25
-
26
- | Command | Purpose | When |
27
- | --- | --- | --- |
28
- | `scip-query files <pattern>` | Find files matching a pattern | Inventory: locate the renderer or status-producing module for a claim. |
29
- | `scip-query refs <symbol>` | Find all files referencing a symbol | Classify: find every producer and consumer of a status-bearing function. |
30
- | `scip-query code <symbol>` | Read the source code for a symbol (bounded to its definition range) | Classify: read the producing function to see whether it computes or asserts. |
31
- | `scip-query trace <symbol>` | Trace a symbol: definition + all references | Classify: definition plus every reference for a status field or constant. |
32
- | `scip-query capabilities --matrix --json` | Report which evidence and verification capabilities are available in this project | Spot-check: an already-known example of a fixed derived-status surface. |
33
-
34
- Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
35
- <!-- END GENERATED SKILL COMMANDS -->
36
-
37
- ## Rules
38
-
39
- 1. Ground every claim in the producing function's source, not its label or variable name alone — a variable named `verified` that is never checked against a real result is still asserted.
40
- 2. Classify status, don't just list it: every status word in scope gets exactly one of derived / hedged / asserted.
41
- 3. Severity follows the rubric: asserted + agent-facing + trust-bearing = high; asserted + internal-only or low-consequence = low; hedged is not a finding (the label already discloses uncertainty).
42
- 4. A status that used to be asserted and now calls a real probe is fixed — say so and move on; do not re-report it.
43
- 5. File findings as a table, not prose; a claim → producer → classification → fix format is the deliverable.
44
-
45
- ## Workflow
46
-
47
- ### 1. Inventory the status vocabulary
48
-
49
- Grep the target scope (a file, module, or command family) for user-visible or JSON-facing status words: `available`, `unavailable`, `partial`, `verified`, `safe`, `PASS`, `FAIL`, `complete`, `derived`, `asserted`. For each hit, note the file:line and the renderer or JSON field that surfaces it to an agent or user.
50
-
51
- ```bash
52
- scip-query files <target-file-or-pattern>
53
- ```
54
-
55
- This step is complete only when every status-bearing string or field in scope is listed with its surface (human output, `--json` field, or both).
56
-
57
- ### 2. Classify each producer
58
-
59
- For each status word's producing function:
60
-
61
- ```bash
62
- scip-query refs <producing-function>
63
- scip-query code <producing-function>
64
- scip-query trace <status-field-or-constant>
65
- ```
66
-
67
- Read the function body. Classify:
68
-
69
- - **Derived**: the status is computed from a probe, scan, spawn result, file check, or graph query performed at or near that call site.
70
- - **Hedged**: the label, descriptor evidence tier, or surrounding text already marks the value as heuristic, candidate, or unverified.
71
- - **Asserted**: the value is a literal, a static table lookup, or a branch that returns a fixed status without invoking any check for that specific branch.
72
-
73
- This step is complete only when every producer has one of these three labels with the one line of source evidence that justifies it.
74
-
75
- ### 3. File findings for every asserted status
76
-
77
- For each **asserted** status, apply the severity rubric (rule 3) and write:
78
-
79
- ```markdown
80
- Claim: <status word and where it appears>
81
- Producer: <file:line function name>
82
- Classification: asserted
83
- Severity: high/low
84
- Fix: probe it (name the real check to add), generate it (derive from a registry/config that is itself kept honest), or soften the language (hedge the label to match what is actually known)
85
- ```
86
-
87
- This step is complete only when every asserted status in scope has a filed finding with a fix direction, and every derived/hedged status is confirmed correct (not silently asserted behind a computed-looking name).
88
-
89
- ### 4. Report
90
-
91
- Write the report under `docs/scip-query/` unless the user asked only for a conversational answer.
92
-
93
- ```markdown
94
- Scope:
95
- Status words inventoried: N
96
- Classified: <d> derived / <h> hedged / <a> asserted — must sum to N; a gap is an unfinished audit
97
-
98
- Claim table:
99
- | Claim | Producer | Classification | Fix |
100
- | --- | --- | --- | --- |
101
-
102
- Fixed since last audit:
103
- - <claim> — now derived via <probe>, no longer a finding.
104
- ```
105
-
106
- The audit is complete only when every status word in scope is classified and every asserted, trust-bearing claim has a filed finding.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "SCIP Claim Audit"
3
- short_description: "Classify output-facing status claims as derived, hedged, or asserted"
4
- default_prompt: "Use scip-query to inventory output-facing status words in the target scope, classify each producer as derived, hedged, or asserted, and file findings for asserted trust-bearing claims."
@@ -1,126 +0,0 @@
1
- ---
2
- name: scip-cleanup-audit
3
- description: Audit and rank scip-query cleanup signals without editing code. Use for health reports, de-bloat reports, recent AI residue audits, score-framed cleanup queues, confirming raw findings, or preparing a cleanup plan.
4
- commands:
5
- - template: "scip-query health --json"
6
- when: "Establish evidence: composite score and prioritized action list."
7
- - template: "scip-query cleanup-plan --verify --json"
8
- when: "Sweep signals: compiler-verified deletion plan, batched."
9
- - template: "scip-query duplicate-bodies --json --full"
10
- when: "Sweep signals: exact duplicate small-body candidates."
11
- - template: "scip-query recent-duplicates --json --full"
12
- when: "Sweep signals: recent code that re-implements established code."
13
- - template: "scip-query incomplete-migration --json --full"
14
- when: "Sweep signals: partially-completed extractions."
15
- - template: "scip-query doc-drift --json --full"
16
- when: "Sweep signals: stale docs referencing changed code."
17
- ---
18
-
19
- # scip-cleanup-audit
20
-
21
- Use this skill to turn raw scip-query signals into a confirmed cleanup queue. Do not edit application code in this skill.
22
-
23
- Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
24
-
25
- <!-- BEGIN GENERATED SKILL COMMANDS -->
26
- ## Commands for this skill
27
-
28
- | Command | Purpose | When |
29
- | --- | --- | --- |
30
- | `scip-query health --json` | Composite codebase health report with prioritized action list | Establish evidence: composite score and prioritized action list. |
31
- | `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | Sweep signals: compiler-verified deletion plan, batched. |
32
- | `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | Sweep signals: exact duplicate small-body candidates. |
33
- | `scip-query recent-duplicates --json --full` | Directional duplicate candidates: recent code that re-implements established callable, React, or Vue code | Sweep signals: recent code that re-implements established code. |
34
- | `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | Sweep signals: partially-completed extractions. |
35
- | `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | Sweep signals: stale docs referencing changed code. |
36
-
37
- Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
38
- <!-- END GENERATED SKILL COMMANDS -->
39
-
40
- ## Modes
41
-
42
- - Whole-repo audit: rank all cleanup signals.
43
- - Recent AI residue: focus on echoes, twins, incomplete migrations, speculative params, stale agent-facing docs, and hidden couplings.
44
- - Score-framed audit: explain health score deductions and the safest first batch.
45
-
46
- ## Workflow
47
-
48
- ### 1. Establish evidence
49
-
50
- ```bash
51
- scip-query doctor
52
- scip-query status --capabilities
53
- scip-query health --json
54
- scip-query capabilities --json
55
- scip-query config-validate --json
56
- ```
57
-
58
- This step is complete only when unavailable capabilities are recorded as unavailable.
59
-
60
- ### 2. Sweep signals
61
-
62
- Run every relevant class, or record why it is unavailable:
63
-
64
- ```bash
65
- scip-query cleanup-plan --verify --json
66
- scip-query duplicate-bodies --json --full
67
- scip-query recent-duplicates --json --full
68
- scip-query incomplete-migration --json --full
69
- scip-query unused-params --json --full
70
- scip-query passthrough-candidates --json --full
71
- scip-query dead --json --full
72
- scip-query isolated --json --full
73
- scip-query cycles
74
- scip-query co-change --json --full
75
- scip-query doc-drift --json --full
76
- ```
77
-
78
- For frontend repos, add the React or Vue duplicate, hook/composable, and large-component/view commands.
79
-
80
- Optional deep-dive (near-zero precision on codebases with intentional layering/ambient types — run only when the sweep above is exhausted, and treat every hit as a lead to confirm, not a finding):
81
-
82
- ```bash
83
- scip-query stale-abstractions --json --full
84
- scip-query wrapper-candidates --json --full
85
- ```
86
-
87
- ### 3. Confirm candidates
88
-
89
- For each high-priority candidate, inspect source and graph evidence:
90
-
91
- ```bash
92
- scip-query code <symbol-or-file>
93
- scip-query refs <symbol>
94
- scip-query fan-in <symbol>
95
- scip-query fan-out <symbol-or-file>
96
- scip-query affected <symbol> --json
97
- scip-query change-surface <file> --json --full
98
- scip-query similar <symbolA> <symbolB> --plan
99
- scip-query co-change <file> --json --full
100
- ```
101
-
102
- Classify every candidate as `confirmed fix target`, `intentional design`, `false positive`, or `blocked`.
103
-
104
- A deletion is this skill's scrutiny-ending verdict, so a `confirmed fix target` that deletes code must survive refutation first. Run the known blind-spot checks and record them on the entry: `rg` for the symbol name as a string (dynamic dispatch, config keys, serialized references, CLI/doc text), and the cross-package barrel re-export gap (the one shape `dead` self-labels `unconfirmed`). Record `refutation: survived — <checks run>` on the entry, or reclassify it; the note stays either way.
105
-
106
- ### 4. Report
107
-
108
- ```markdown
109
- Health score: N/100
110
-
111
- Classification counts: <n> confirmed / <i> intentional / <fp> false positive / <b> blocked (must cover every collected signal)
112
-
113
- Confirmed items:
114
- - [priority] finding - evidence - first safe action
115
-
116
- Unconfirmed signals:
117
- - signal - evidence still needed
118
-
119
- Unavailable or blocked checks:
120
- - check - reason
121
-
122
- Recommended first cleanup batch:
123
- - batch - why safe now
124
- ```
125
-
126
- The audit is complete only when each collected signal is classified and the next action is visible.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "SCIP Cleanup Audit"
3
- short_description: "Confirm and rank cleanup, de-bloat, and recent AI residue signals without editing"
4
- default_prompt: "Audit scip-query cleanup signals, classify findings with evidence, and report the safest next cleanup batch."
@@ -1,84 +0,0 @@
1
- ---
2
- name: scip-cleanup-improve
3
- description: Improve scip-query health autonomously with verified cleanup. Use when the user asks to fix cleanup findings, raise health, keep cleaning, continue after setup, or work until no safe confirmed cleanup remains.
4
- commands:
5
- - template: "scip-query health --json"
6
- when: "Before editing: report current score and remaining signals."
7
- - template: "scip-query cleanup-plan --verify --json"
8
- when: "Loop: confirm the next compiler-verified deletion batch."
9
- - template: "scip-query cleanup-apply --verified --batch <n>"
10
- when: "Loop: apply one verified deletion batch."
11
- - template: "scip-query duplicate-bodies --json --full"
12
- when: "Priority: exact duplicate small-body echoes to consolidate."
13
- - template: "scip-query incomplete-migration --json --full"
14
- when: "Priority: un-migrated call sites left behind by a new helper."
15
- ---
16
-
17
- # scip-cleanup-improve
18
-
19
- Use this skill for bounded autonomous cleanup. The target is not score chasing; the target is fixing confirmed issues that make the codebase harder to understand, verify, or change.
20
-
21
- Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
22
-
23
- <!-- BEGIN GENERATED SKILL COMMANDS -->
24
- ## Commands for this skill
25
-
26
- | Command | Purpose | When |
27
- | --- | --- | --- |
28
- | `scip-query health --json` | Composite codebase health report with prioritized action list | Before editing: report current score and remaining signals. |
29
- | `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | Loop: confirm the next compiler-verified deletion batch. |
30
- | `scip-query cleanup-apply --verified --batch <n>` | Apply a compiler-verified cleanup-plan batch to the working tree | Loop: apply one verified deletion batch. |
31
- | `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | Priority: exact duplicate small-body echoes to consolidate. |
32
- | `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | Priority: un-migrated call sites left behind by a new helper. |
33
-
34
- Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
35
- <!-- END GENERATED SKILL COMMANDS -->
36
-
37
- ## Rules
38
-
39
- 1. Start with `scip-cleanup-audit` evidence or run the audit sweep yourself.
40
- 2. Report current health and the first confirmed batch before editing.
41
- 3. Prioritize high-confidence, low-blast-radius, clearly verifiable fixes.
42
- 4. Apply one small batch at a time.
43
- 5. After a cleanup pass, run `scip-query health --write-baseline` to snapshot finding identities, then compare with `scip-query health --baseline` at the start of the next pass.
44
-
45
- ## Priority
46
-
47
- 1. Compiler-verified deletion batches.
48
- 2. Incomplete migrations and recent duplicate echoes.
49
- 3. Unused params, unused imports, dead symbols, and isolated symbols.
50
- 4. Broken or stale docs, config validation issues, and missing co-change partners.
51
- 5. Thin wrappers, passthroughs, stale abstractions, and speculative generality.
52
- 6. Frontend component/hook/composable duplication and large-view pressure.
53
- 7. Directory architecture and maintainability repairs only when evidence is strong and the blast radius is bounded.
54
-
55
- ## Loop
56
-
57
- Before editing:
58
-
59
- ```markdown
60
- Health score: N/100
61
- First confirmed batch:
62
- - finding - evidence - planned fix - verification
63
- Remaining signals:
64
- - signal - status
65
- ```
66
-
67
- Then repeat:
68
-
69
- 1. Apply one verified deletion batch or one small targeted refactor.
70
- 2. Run the narrow project check for touched behavior.
71
- 3. Run `scip-query health --json`.
72
- 4. Invoke `scip-verify`.
73
- 5. If `docs/scip-query/health-dossier.md` exists (or a custom `--dossier-dir` was used), refresh it by rerunning `scip-query setup --json` (add the same `--dossier-dir` if one was used).
74
- 6. Pick the next highest-priority confirmed item.
75
-
76
- Use `scip-query cleanup-apply --verified --batch <n>` for verified deletion batches. Use `--all` only with explicit user approval.
77
-
78
- ## Stop
79
-
80
- Stop when only intentional, false-positive, blocked, or unconfirmed items remain; when the next improvement needs a product/API/ownership decision; when a missing toolchain prevents trustworthy verification; or when further work would be broad redesign rather than bounded cleanup.
81
-
82
- ## Closeout
83
-
84
- Report starting and final health scores, batches applied, important files changed, verification commands, remaining accepted or blocked items, and highest-value follow-up.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "SCIP Cleanup Improve"
3
- short_description: "Fix confirmed cleanup findings batch by batch with verification"
4
- default_prompt: "Improve scip-query health by fixing confirmed cleanup findings one verified batch at a time."