Skip to content

dsh-drill v0.8.2 — the drill kit

Choose a tag to compare

@EnRaiha EnRaiha released this 25 Sep 07:57
· 12 commits to master since this release

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.2

Restart the runtime afterwards: host-side plugin rows are composed at boot.

Two reviews, every defect fixed with a regression test

  • Gate integrity — a review/pr record that named no commit could close a required gate; a hand-written test record could be a "proof" by pointing at any readable file.
  • Proofs that could vanish — a test killed by a signal reported a null exit and recorded nothing; the canonical red proof now records 128 + 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_snapshots is 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.mjs

docs/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.