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.
- package/CHANGELOG.md +75 -1
- package/README.md +242 -49
- package/dist/augment-vue-worker.js +1 -1
- package/dist/{chunk-2YU7I3QO.js → chunk-24QNP7MN.js} +2 -2
- package/dist/{chunk-CNKAGUPL.js → chunk-26X7KCJR.js} +2 -2
- package/dist/{chunk-GPBBJ5Y4.js → chunk-273W2U4Y.js} +3 -3
- package/dist/{chunk-7GXM52MI.js → chunk-2CVXCGL4.js} +2 -2
- package/dist/{chunk-ABMYA4TN.js → chunk-2EZSOTSY.js} +2 -2
- package/dist/{chunk-HKEHS2AS.js → chunk-2GSQR6YA.js} +2 -2
- package/dist/{chunk-FECYOO5O.js → chunk-2OXVAGGT.js} +2 -2
- package/dist/chunk-2ZOCHAL2.js +8 -0
- package/dist/{chunk-QGXBRIM5.js → chunk-336DC5NJ.js} +2 -2
- package/dist/chunk-35SQLYCQ.js +2 -0
- package/dist/{chunk-VXQNNXJE.js → chunk-3OIKRYU5.js} +2 -2
- package/dist/{chunk-52ZYCAEO.js → chunk-47X75ZKH.js} +2 -2
- package/dist/{chunk-NPKYOIFM.js → chunk-4CGVLUDP.js} +2 -2
- package/dist/chunk-4RI4BJGT.js +8 -0
- package/dist/{chunk-P2PC2WGR.js → chunk-52HQTTPB.js} +2 -2
- package/dist/{chunk-YNRNA5LK.js → chunk-5OC3HWP5.js} +2 -2
- package/dist/{chunk-STOL2BTL.js → chunk-6XFC7PQ5.js} +2 -2
- package/dist/{chunk-J77UIT3I.js → chunk-6XHTISLI.js} +2 -2
- package/dist/chunk-6YTSKJJ3.js +2 -0
- package/dist/{chunk-BTEE5NZQ.js → chunk-7E3TH5ZN.js} +2 -2
- package/dist/{chunk-X6D5IC6I.js → chunk-7LABSJSR.js} +2 -2
- package/dist/chunk-7Q6VYYCH.js +2 -0
- package/dist/{chunk-FWUUZTIO.js → chunk-A43URCQ3.js} +2 -2
- package/dist/chunk-A63U2W3P.js +3 -0
- package/dist/{chunk-3MJ5YA4Y.js → chunk-ADFSIJP2.js} +2 -2
- package/dist/chunk-AOLE4DYM.js +6 -0
- package/dist/chunk-APMMR5Y2.js +2 -0
- package/dist/chunk-B5MHCHP3.js +107 -0
- package/dist/{chunk-4RSI5EMG.js → chunk-CSTYYXKC.js} +2 -2
- package/dist/{chunk-25LPM4DG.js → chunk-CYJM7CYF.js} +2 -2
- package/dist/{chunk-S44IULR6.js → chunk-DD5BOU5I.js} +2 -2
- package/dist/{chunk-YGAGTIDK.js → chunk-DGMCFMPG.js} +7 -7
- package/dist/{chunk-UOAV44HR.js → chunk-E2ZXPB7J.js} +2 -2
- package/dist/{chunk-IZKFSVBV.js → chunk-EVOC5I5I.js} +2 -2
- package/dist/{chunk-XTX6QHOF.js → chunk-F42A3AKG.js} +2 -2
- package/dist/{chunk-Q4IIEGXJ.js → chunk-FHCTEANE.js} +2 -2
- package/dist/{chunk-3SVWW4PN.js → chunk-FKGN4A4E.js} +2 -2
- package/dist/{chunk-IG7N5ZIK.js → chunk-FQTPPXNA.js} +2 -2
- package/dist/{chunk-F6O7AAC3.js → chunk-G4UQL4CP.js} +2 -2
- package/dist/chunk-GA64UPMI.js +6 -0
- package/dist/{chunk-ZXJYMGD3.js → chunk-GK3GRUJX.js} +2 -2
- package/dist/chunk-HEBAY673.js +2 -0
- package/dist/chunk-HELS7KFF.js +2 -0
- package/dist/{chunk-B5NLK2B3.js → chunk-IPDCSB6N.js} +2 -2
- package/dist/{chunk-M7MTH5NR.js → chunk-IYAOX36F.js} +2 -2
- package/dist/{chunk-YVVCVR2L.js → chunk-J7VT2CRB.js} +2 -2
- package/dist/{chunk-4333ETTV.js → chunk-JELJLXEE.js} +2 -2
- package/dist/{chunk-LBMJEAEW.js → chunk-JERWGHQT.js} +2 -2
- package/dist/chunk-JJJCO4QC.js +945 -0
- package/dist/{chunk-6E7UTQY7.js → chunk-JZNLMHWY.js} +2 -2
- package/dist/{chunk-R4FQGQ4X.js → chunk-K42M2KWT.js} +2 -2
- package/dist/{chunk-H7UKLTWJ.js → chunk-KLVJABXA.js} +2 -2
- package/dist/chunk-KP4KBDVF.js +3 -0
- package/dist/{chunk-RV2FQIX3.js → chunk-LMFVTUW2.js} +2 -2
- package/dist/chunk-LRTP3DKL.js +3 -0
- package/dist/{chunk-U6WNH5GC.js → chunk-MGBJHRFB.js} +2 -2
- package/dist/{chunk-QDV6RDCP.js → chunk-MLGTCX56.js} +2 -2
- package/dist/{chunk-54HA4ZXH.js → chunk-N3SE646F.js} +2 -2
- package/dist/{chunk-KP6XRY5Z.js → chunk-NBRUH7OE.js} +2 -2
- package/dist/{chunk-M7AIS73L.js → chunk-NN4ZIRPK.js} +2 -2
- package/dist/{chunk-I5RJM53C.js → chunk-NQLSSVOB.js} +2 -2
- package/dist/{chunk-4SALD7RU.js → chunk-OBKDTVZ3.js} +2 -2
- package/dist/{chunk-GBQ5NYPR.js → chunk-OHWZKLVA.js} +6 -6
- package/dist/{chunk-6NSFJYRC.js → chunk-OP3MTFJR.js} +2 -2
- package/dist/{chunk-EOOJGLDU.js → chunk-OQ2A4G2G.js} +2 -2
- package/dist/{chunk-DLWR3NUU.js → chunk-P6HBYNBE.js} +2 -2
- package/dist/{chunk-QVWS2VWZ.js → chunk-PC44K7RF.js} +2 -2
- package/dist/{chunk-A2EZV2UM.js → chunk-QBYYWGAT.js} +2 -2
- package/dist/{chunk-QRGV2F7L.js → chunk-QHKUY4FW.js} +2 -2
- package/dist/chunk-QHRL4LKM.js +2 -0
- package/dist/{chunk-I5AWSI2G.js → chunk-QQWOFXNW.js} +2 -2
- package/dist/{chunk-WQTAC523.js → chunk-RBFFD4V2.js} +2 -2
- package/dist/{chunk-SOAT6NLA.js → chunk-RJHCPSZ7.js} +2 -2
- package/dist/{chunk-VGRICIQI.js → chunk-RWRLUZ6U.js} +2 -2
- package/dist/{chunk-4T3LTWUS.js → chunk-S2GP3CU3.js} +2 -2
- package/dist/{chunk-HEXVUYFQ.js → chunk-SHKZ7OVJ.js} +2 -2
- package/dist/{chunk-NSS46APD.js → chunk-TFUU5MQQ.js} +2 -2
- package/dist/{chunk-IUFDSKGG.js → chunk-TYQ76QHQ.js} +2 -2
- package/dist/{chunk-NRCXJDHL.js → chunk-U5CNPPTZ.js} +2 -2
- package/dist/{chunk-MITTUCEH.js → chunk-UQK5CRUK.js} +2 -2
- package/dist/{chunk-XLTP42QA.js → chunk-UUJBLG6J.js} +2 -2
- package/dist/chunk-UXP636P5.js +144 -0
- package/dist/{chunk-64RFXJT5.js → chunk-VEVBIAOJ.js} +6 -6
- package/dist/chunk-VKRQDBW5.js +9 -0
- package/dist/{chunk-C7NIYIQ4.js → chunk-VOQFGC2W.js} +4 -4
- package/dist/{chunk-DZ74OMG6.js → chunk-VP542C25.js} +2 -2
- package/dist/{chunk-Q3AFUTGB.js → chunk-WMXRRBII.js} +2 -2
- package/dist/{chunk-ZGZUZ7XE.js → chunk-WXAAURU7.js} +2 -2
- package/dist/chunk-X3NLZHPA.js +20 -0
- package/dist/{chunk-WER3B7MI.js → chunk-XF3KLXN3.js} +2 -2
- package/dist/{chunk-NH5ALKPW.js → chunk-XVJ3V7LM.js} +2 -2
- package/dist/{chunk-4XTA5OMB.js → chunk-YGQN3XGZ.js} +2 -2
- package/dist/{chunk-CFMXJPHH.js → chunk-YHXBD52M.js} +2 -2
- package/dist/{chunk-7B3UPBVA.js → chunk-YLVE3SXZ.js} +2 -2
- package/dist/{chunk-YIJ7ZAA4.js → chunk-YTUD45PU.js} +2 -2
- package/dist/{chunk-VTKGCT3V.js → chunk-YWB2EBNB.js} +2 -2
- package/dist/{chunk-UKZBVX4U.js → chunk-Z2LHPIOM.js} +2 -2
- package/dist/chunk-Z5QQPJ3U.js +30 -0
- package/dist/{chunk-NZL2DBT7.js → chunk-ZLJLE6LK.js} +2 -2
- package/dist/{chunk-XYADIZHU.js → chunk-ZTTISZ7J.js} +2 -2
- package/dist/cli.js +3 -3
- package/dist/command-descriptors-SJDZ7QGR.js +617 -0
- package/dist/{config-types-D20KuvvZ.d.ts → config-types-BWQ5xPGI.d.ts} +4 -0
- package/dist/{db-G_II8yXU.d.ts → db-B0r1o7Vt.d.ts} +18 -1
- package/dist/direct-navigation-HTKOZEOM.js +3 -0
- package/dist/{health-oblXYgkF.d.ts → health-CFnlCiTz.d.ts} +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1 -1
- package/dist/postinstall.js +1 -1
- package/dist/queries/affected.d.ts +2 -2
- package/dist/queries/affected.js +1 -1
- package/dist/queries/architecture.d.ts +2 -2
- package/dist/queries/architecture.js +1 -1
- package/dist/queries/bottlenecks.d.ts +2 -2
- package/dist/queries/bottlenecks.js +1 -1
- package/dist/queries/by-kind.d.ts +2 -2
- package/dist/queries/by-kind.js +1 -1
- package/dist/queries/call-graph.d.ts +2 -2
- package/dist/queries/call-graph.js +1 -1
- package/dist/queries/change-surface.d.ts +2 -2
- package/dist/queries/change-surface.js +1 -1
- package/dist/queries/cleanup-plan.d.ts +2 -2
- package/dist/queries/cleanup-plan.js +1 -1
- package/dist/queries/co-change.d.ts +2 -2
- package/dist/queries/co-change.js +1 -1
- package/dist/queries/code.d.ts +2 -2
- package/dist/queries/code.js +1 -1
- package/dist/queries/complexity-hotspots.d.ts +2 -2
- package/dist/queries/complexity-hotspots.js +1 -1
- package/dist/queries/complexity.d.ts +2 -2
- package/dist/queries/complexity.js +1 -1
- package/dist/queries/convergence.d.ts +2 -2
- package/dist/queries/convergence.js +1 -1
- package/dist/queries/coupling.d.ts +2 -2
- package/dist/queries/coupling.js +1 -1
- package/dist/queries/cycles.d.ts +2 -2
- package/dist/queries/cycles.js +1 -1
- package/dist/queries/dataflow.d.ts +2 -2
- package/dist/queries/dataflow.js +1 -1
- package/dist/queries/dead.d.ts +2 -2
- package/dist/queries/dead.js +1 -1
- package/dist/queries/decorative-checkers.d.ts +3 -3
- package/dist/queries/decorative-checkers.js +1 -1
- package/dist/queries/deep-chains.d.ts +2 -2
- package/dist/queries/deep-chains.js +1 -1
- package/dist/queries/deps.d.ts +2 -2
- package/dist/queries/deps.js +1 -1
- package/dist/queries/diff-gate.d.ts +30 -2
- package/dist/queries/diff-gate.js +1 -1
- package/dist/queries/diff-impact.d.ts +2 -2
- package/dist/queries/diff-impact.js +1 -1
- package/dist/queries/doc-drift.d.ts +2 -2
- package/dist/queries/doc-drift.js +1 -1
- package/dist/queries/drift.d.ts +2 -2
- package/dist/queries/drift.js +1 -1
- package/dist/queries/duplicate-bodies.d.ts +2 -2
- package/dist/queries/duplicate-bodies.js +1 -1
- package/dist/queries/extract-candidates.d.ts +2 -2
- package/dist/queries/extract-candidates.js +1 -1
- package/dist/queries/fan.d.ts +2 -2
- package/dist/queries/fan.js +1 -1
- package/dist/queries/files.d.ts +2 -2
- package/dist/queries/health.d.ts +3 -3
- package/dist/queries/health.js +1 -1
- package/dist/queries/hierarchy.d.ts +2 -2
- package/dist/queries/hierarchy.js +1 -1
- package/dist/queries/hotspots.d.ts +2 -2
- package/dist/queries/hotspots.js +1 -1
- package/dist/queries/imports.d.ts +2 -2
- package/dist/queries/imports.js +1 -1
- package/dist/queries/incomplete-migration.d.ts +2 -2
- package/dist/queries/incomplete-migration.js +1 -1
- package/dist/queries/index.d.ts +17 -3
- package/dist/queries/index.js +1 -1
- package/dist/queries/isolated.d.ts +2 -2
- package/dist/queries/isolated.js +1 -1
- package/dist/queries/locality-candidates.d.ts +2 -2
- package/dist/queries/locality-candidates.js +1 -1
- package/dist/queries/members.d.ts +2 -2
- package/dist/queries/members.js +1 -1
- package/dist/queries/methods.d.ts +2 -2
- package/dist/queries/methods.js +1 -1
- package/dist/queries/not-implemented.d.ts +3 -3
- package/dist/queries/not-implemented.js +1 -1
- package/dist/queries/outline.d.ts +2 -2
- package/dist/queries/outline.js +1 -1
- package/dist/queries/passthrough-candidates.d.ts +2 -2
- package/dist/queries/passthrough-candidates.js +1 -1
- package/dist/queries/plan-context.d.ts +2 -2
- package/dist/queries/plan-context.js +1 -1
- package/dist/queries/react-component-duplicates.d.ts +2 -2
- package/dist/queries/react-component-duplicates.js +1 -1
- package/dist/queries/react-hook-candidates.d.ts +2 -2
- package/dist/queries/react-hook-candidates.js +1 -1
- package/dist/queries/react-large-component-pressure.d.ts +2 -2
- package/dist/queries/react-large-component-pressure.js +1 -1
- package/dist/queries/recent-duplicates.d.ts +2 -2
- package/dist/queries/recent-duplicates.js +1 -1
- package/dist/queries/redundant-reexports.d.ts +2 -2
- package/dist/queries/redundant-reexports.js +1 -1
- package/dist/queries/refs.d.ts +2 -2
- package/dist/queries/refs.js +1 -1
- package/dist/queries/self-audit.d.ts +2 -2
- package/dist/queries/self-audit.js +1 -1
- package/dist/queries/similar-chains.d.ts +2 -2
- package/dist/queries/similar-chains.js +1 -1
- package/dist/queries/similar-files.d.ts +2 -2
- package/dist/queries/similar-files.js +1 -1
- package/dist/queries/similar-signatures.d.ts +2 -2
- package/dist/queries/similar-signatures.js +1 -1
- package/dist/queries/similar.d.ts +2 -2
- package/dist/queries/similar.js +1 -1
- package/dist/queries/slice.d.ts +2 -2
- package/dist/queries/slice.js +1 -1
- package/dist/queries/stale-abstractions.d.ts +2 -2
- package/dist/queries/stale-abstractions.js +1 -1
- package/dist/queries/stats.d.ts +2 -2
- package/dist/queries/stats.js +1 -1
- package/dist/queries/surface.d.ts +2 -2
- package/dist/queries/surface.js +1 -1
- package/dist/queries/symbols.d.ts +2 -2
- package/dist/queries/symbols.js +1 -1
- package/dist/queries/system.d.ts +2 -2
- package/dist/queries/system.js +1 -1
- package/dist/queries/test-quality.d.ts +2 -2
- package/dist/queries/test-quality.js +1 -1
- package/dist/queries/trace.d.ts +2 -2
- package/dist/queries/trace.js +1 -1
- package/dist/queries/twin-ab.d.ts +3 -3
- package/dist/queries/twin-ab.js +1 -1
- package/dist/queries/twin-drift.d.ts +2 -2
- package/dist/queries/twin-drift.js +1 -1
- package/dist/queries/unused-imports.d.ts +2 -2
- package/dist/queries/unused-imports.js +1 -1
- package/dist/queries/unused-params.d.ts +2 -2
- package/dist/queries/unused-params.js +1 -1
- package/dist/queries/vue-component-duplicates.d.ts +2 -2
- package/dist/queries/vue-component-duplicates.js +1 -1
- package/dist/queries/vue-composable-candidates.d.ts +2 -2
- package/dist/queries/vue-composable-candidates.js +1 -1
- package/dist/queries/vue-large-view-pressure.d.ts +2 -2
- package/dist/queries/vue-large-view-pressure.js +1 -1
- package/dist/queries/wrapper-candidates.d.ts +2 -2
- package/dist/queries/wrapper-candidates.js +1 -1
- package/dist/reindex-worker.js +23 -24
- package/dist/reindex.d.ts +10 -4
- package/dist/reindex.js +33 -38
- package/dist/runtime.d.ts +167 -11
- package/dist/runtime.js +3 -2
- package/dist/rust-semantic-session-server.js +1 -1
- package/dist/rust-semantic-session-worker.js +1 -1
- package/dist/rust-semantic-worker.js +1 -1
- package/dist/{scip-cli-kRpaexVJ.d.ts → scip-cli-DCvnlZCu.d.ts} +5 -1
- package/dist/watch-server.js +5 -5
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/AI_FAILURE_MODES.md +18 -18
- package/docs/API_EVOLUTION.md +71 -0
- package/docs/CLI_JSON_OUTPUT.md +83 -0
- package/docs/COMMAND_REFERENCE.md +10 -8
- package/docs/COMMITTED_RECORD_COMPATIBILITY.md +117 -0
- package/docs/CONFIGURATION_WRITE_SAFETY.md +130 -0
- package/docs/DETECTOR_GUIDE.md +47 -47
- package/docs/DURABILITY.md +103 -0
- package/docs/INDEX_GENERATIONS.md +121 -0
- package/docs/LOCK_PROTOCOL.md +133 -0
- package/docs/MAILBOX_LIFECYCLE.md +197 -0
- package/docs/REINDEX_METADATA_COMPATIBILITY.md +84 -0
- package/docs/RUST_DURABLE_SESSION_PROTOCOL.md +126 -0
- package/docs/TELEMETRY_RETENTION.md +72 -0
- package/docs/TIME_SEMANTICS.md +77 -0
- package/docs/WATCH_REFRESH_REQUESTS.md +110 -0
- package/docs/WINDOWS_SIDECAR_RELEASE.md +298 -0
- package/docs/analyzer-validation-ledger.md +24 -23
- package/docs/schemas/cli-json-envelope.schema.json +53 -0
- package/docs/schemas/npm-release-state.schema.json +146 -0
- package/docs/schemas/outcome-event-record.schema.json +39 -0
- package/docs/schemas/project-config.schema.json +247 -0
- package/docs/schemas/suppression-record.schema.json +31 -0
- package/docs/schemas/windows-sidecar-provenance.schema.json +137 -0
- package/package.json +15 -5
- package/scripts/build-scip-windows.mjs +180 -61
- package/scripts/scip-windows-provenance.mjs +364 -0
- package/scripts/verify-scip-windows.mjs +29 -0
- package/skills/_shared/SKILL.md +91 -242
- package/skills/_shared/agents/openai.yaml +1 -1
- package/skills/_shared/references/agent-contract-catalog.md +105 -0
- package/skills/_shared/references/command-catalog.md +118 -0
- package/skills/_shared/references/detector-precision-and-diffgate.md +59 -0
- package/skills/_shared/references/evidence-and-dead-code.md +25 -0
- package/skills/scip-audit/SKILL.md +76 -0
- package/skills/scip-audit/agents/openai.yaml +4 -0
- package/skills/scip-audit/references/claims.md +98 -0
- package/skills/scip-audit/references/cleanup.md +101 -0
- package/skills/scip-audit/references/directory.md +222 -0
- package/skills/scip-audit/references/frontend.md +130 -0
- package/skills/scip-audit/references/integrity.md +154 -0
- package/skills/scip-audit/references/maintainability.md +162 -0
- package/skills/scip-audit/references/twin-drift.md +104 -0
- package/skills/scip-diagnose/SKILL.md +52 -0
- package/skills/scip-diagnose/agents/openai.yaml +4 -0
- package/skills/scip-diagnose/references/debug.md +117 -0
- package/skills/{scip-probe-reachability/SKILL.md → scip-diagnose/references/probe-reachability.md} +12 -27
- package/skills/scip-diagnose/references/root-cause.md +145 -0
- package/skills/scip-diagnose/references/triage.md +119 -0
- package/skills/scip-explore/SKILL.md +53 -84
- package/skills/scip-explore/agents/openai.yaml +2 -2
- package/skills/scip-explore/references/diagrams.md +40 -0
- package/skills/scip-explore/references/language-playbook.md +49 -0
- package/skills/scip-improve/SKILL.md +56 -0
- package/skills/scip-improve/agents/openai.yaml +4 -0
- package/skills/scip-improve/references/cleanup-batches.md +53 -0
- package/skills/scip-improve/references/directory-moves.md +53 -0
- package/skills/scip-improve/references/doc-reconcile.md +30 -0
- package/skills/scip-improve/references/frontend-extraction.md +39 -0
- package/skills/scip-improve/references/maintainability-mechanism.md +43 -0
- package/skills/scip-improve/references/twin-drift.md +35 -0
- package/skills/scip-plan/SKILL.md +68 -0
- package/skills/scip-plan/agents/openai.yaml +4 -0
- package/skills/scip-plan/references/api-impact.md +19 -0
- package/skills/scip-plan/references/conductor.md +41 -0
- package/skills/scip-plan/references/high-assurance.md +43 -0
- package/skills/scip-plan/references/hyper-optimization.md +50 -0
- package/skills/scip-plan/references/tla-model.md +88 -0
- package/skills/scip-query/SKILL.md +52 -97
- package/skills/scip-query/agents/openai.yaml +2 -2
- package/skills/scip-setup/SKILL.md +65 -176
- package/skills/scip-setup/agents/openai.yaml +3 -3
- package/skills/scip-setup/references/bootstrap-workflow.md +120 -0
- package/skills/scip-setup/references/language-verification.md +61 -0
- package/skills/scip-setup/references/lifecycle-commands.md +119 -0
- package/skills/scip-setup/references/per-repo-triage.md +24 -0
- package/skills/scip-verify/SKILL.md +123 -70
- package/skills/scip-verify/agents/openai.yaml +2 -2
- package/skills/scip-verify/references/calibrate-detectors.md +170 -0
- package/dist/chunk-2CTX5CMX.js +0 -4
- package/dist/chunk-2Y373BDD.js +0 -2
- package/dist/chunk-C2QSK7E7.js +0 -2
- package/dist/chunk-D4U5Q3FT.js +0 -7
- package/dist/chunk-K2ERX4UT.js +0 -3
- package/dist/chunk-KHE7J5ZN.js +0 -3
- package/dist/chunk-L7SPDE73.js +0 -84
- package/dist/chunk-LHMNRHGV.js +0 -3
- package/dist/chunk-LM72NQ7T.js +0 -3
- package/dist/chunk-MSWVMDAH.js +0 -122
- package/dist/chunk-NH7WNNQC.js +0 -20
- package/dist/chunk-OMPZHGHO.js +0 -2
- package/dist/chunk-SVLTAG5O.js +0 -927
- package/dist/chunk-U7DSEKOM.js +0 -30
- package/dist/chunk-V27BEQJN.js +0 -7
- package/dist/chunk-VMNZB6WI.js +0 -4
- package/dist/chunk-XBN5VO53.js +0 -2
- package/dist/chunk-ZAIILQNP.js +0 -5
- package/dist/command-descriptors-MFU4BCJ7.js +0 -612
- package/dist/direct-navigation-MRMQFIRB.js +0 -3
- package/skills/scip-api-impact/SKILL.md +0 -139
- package/skills/scip-api-impact/agents/openai.yaml +0 -4
- package/skills/scip-calibrate/SKILL.md +0 -131
- package/skills/scip-calibrate/agents/openai.yaml +0 -4
- package/skills/scip-claim-audit/SKILL.md +0 -106
- package/skills/scip-claim-audit/agents/openai.yaml +0 -4
- package/skills/scip-cleanup-audit/SKILL.md +0 -126
- package/skills/scip-cleanup-audit/agents/openai.yaml +0 -4
- package/skills/scip-cleanup-improve/SKILL.md +0 -84
- package/skills/scip-cleanup-improve/agents/openai.yaml +0 -4
- package/skills/scip-concrete-plan/SKILL.md +0 -262
- package/skills/scip-concrete-plan/agents/openai.yaml +0 -4
- package/skills/scip-conductor/SKILL.md +0 -133
- package/skills/scip-conductor/agents/openai.yaml +0 -4
- package/skills/scip-debug/SKILL.md +0 -130
- package/skills/scip-debug/agents/openai.yaml +0 -4
- package/skills/scip-diagram/SKILL.md +0 -110
- package/skills/scip-diagram/agents/openai.yaml +0 -4
- package/skills/scip-directory-architecture/SKILL.md +0 -254
- package/skills/scip-directory-architecture/agents/openai.yaml +0 -4
- package/skills/scip-doc-reconcile/SKILL.md +0 -89
- package/skills/scip-doc-reconcile/agents/openai.yaml +0 -4
- package/skills/scip-hyper-optimization/SKILL.md +0 -156
- package/skills/scip-hyper-optimization/agents/openai.yaml +0 -4
- package/skills/scip-integrity-audit/SKILL.md +0 -152
- package/skills/scip-integrity-audit/agents/openai.yaml +0 -4
- package/skills/scip-language-playbook/SKILL.md +0 -106
- package/skills/scip-language-playbook/agents/openai.yaml +0 -4
- package/skills/scip-maintainability/SKILL.md +0 -158
- package/skills/scip-maintainability/agents/openai.yaml +0 -4
- package/skills/scip-probe-reachability/agents/openai.yaml +0 -4
- package/skills/scip-react-maintainability/SKILL.md +0 -101
- package/skills/scip-react-maintainability/agents/openai.yaml +0 -4
- package/skills/scip-root-cause/SKILL.md +0 -150
- package/skills/scip-root-cause/agents/openai.yaml +0 -4
- package/skills/scip-tla-model-system/SKILL.md +0 -148
- package/skills/scip-tla-model-system/agents/openai.yaml +0 -4
- package/skills/scip-triage-issue/SKILL.md +0 -126
- package/skills/scip-triage-issue/agents/openai.yaml +0 -4
- package/skills/scip-twin-drift/SKILL.md +0 -107
- package/skills/scip-twin-drift/agents/openai.yaml +0 -4
- package/skills/scip-vue-maintainability/SKILL.md +0 -107
- package/skills/scip-vue-maintainability/agents/openai.yaml +0 -4
|
@@ -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,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.
|