Repository navigation
dsh-drill v0.8.2 — the drill kit
The drill is a bug fix run as a pipeline with gates: localize from the failure signal, map the blast radius, enumerate the edge cases, prove red (fails on base) then green (passes with the fix), pass hygiene, pass a fresh-context read-only Review 2, then produce the PR — with every claim backed by an artifact in a ledger. "Done" is not a sentence; it is a gate evaluation.
This is the first release of the kit. dsh-drill v0.8.2 — 16 tools, 103 tests, 0 failures, loads on DSH 0.1.6-alpha.2.
What is in the kit
| Path | What |
|---|---|
index.js, lib/, test/, skills/, roles/, cordis.patch.yml |
the DSH plugin: 16 tools, the eight gate predicates, the append-only ledger, the failure-signal parser, the c2g resolver |
core/c2g_tools.py, core/pr_craft.py |
the two stdlib-only cores the plugin and both frontends share |
frontends/kilo/, frontends/hermes/ |
thin wrappers that expose those cores in those runtimes (core path overridable: C2G_CORE, PR_CRAFT_CORE) |
docs/ |
the specification, both reviews, the historical spec, and a generated source bundle for reviewers |
tools/build-source-bundle.mjs |
regenerates the bundle from the source revision — byte-stable |
Install
dsh plugin --profile <profile> add github:EnRaiha/dsh-drill-kit#v0.8.2Restart the runtime afterwards: host-side plugin rows are composed at boot.
Two reviews, every defect fixed with a regression test
- Gate integrity — a
review/prrecord that named no commit could close a required gate; a hand-writtentestrecord could be a "proof" by pointing at any readable file. - Proofs that could vanish — a test killed by a signal reported a
nullexit and recorded nothing; the canonical red proof now records128 + signo. - Rule 8 ("a miss is a note, not evidence") — closed on the text-search, backtrace and merged-store paths, and on the c2g scope read:
active_snapshotsis keyed by(tier, completeness), so the query now picks one deterministic, complete snapshot and labels a partial answer. - Honest labels — a fallback diff no longer prints a base it never compared; a crashed lint is no longer a clean PR body.
Everything the reviews could not settle is listed as unverified in the docs rather than assumed.
Verify
node --test test/*.test.js # 103 tests
node tools/build-source-bundle.mjsdocs/DRILL-PLUGIN-SOURCE-BUNDLE-*.md carries every tracked file with per-file sha256, so the release can be audited without cloning.
Upstream
The graph layer is not this repository's work: NodeDB-Lab/code2graph (Rust extractor + c2g CLI) by farhan-syah, the NodeDB founder, with CLI fixes by EnRaiha. See docs/README.md for the full credits.