Skip to content

docs: itd-82 (abcd drain — ledger triage) + drain #2 run plan - #46

Merged
REPPL merged 1 commit into
mainfrom
docs/itd-82-drain-triage
Jul 12, 2026
Merged

docs: itd-82 (abcd drain — ledger triage) + drain #2 run plan#46
REPPL merged 1 commit into
mainfrom
docs/itd-82-drain-triage

Conversation

@REPPL

@REPPL REPPL commented Jul 12, 2026

Copy link
Copy Markdown
Owner

Settles the abcd drain design (maintainer signed off) and lands the second drain run plan.

itd-82 — abcd drain (ledger triage)

abcd drain is the sorting hat in front of abcd's existing engines: it triages the open issue ledger and routes each ready issue to a surface that already knows how to handle it.

  • fixable / self-contained → autonomous fix path (itd-29 / run protocol backlog: ledger): detector-first, make preflight-gated, one PR per issue, never self-merged.
  • design-STOP / feature-shapedcapture promote (itd-46) → intent draft, seeded from the issue body with the four-field back-link. Reuses the existing promote verb rather than minting a new one (one-canonical-primitive). No autonomous design/adoption decision.
  • ops / blocked / decided → skip with a logged reason.

Key design decisions recorded in the intent:

  • Fail-safe classifier — low-confidence classification routes to the human side, never to an autonomous fix.
  • Two human gates by design — merging PRs, and designing promoted intents.
  • Cut A (fix-path first) — ships the classifier + fix + skip paths against the working run engine; the promote route flags "needs promotion" until capture promote (itd-46) lands, degrading loudly, never silently.
  • builds_on: [itd-4, itd-29, itd-46]; a sota-researcher pass on the 2025–26 autonomous-triage landscape is recorded as the pre-build gate.

Lands in drafts/; the lifecycle continues with abcd intent plan itd-82 → spec → build.

Drain #2 run plan

2026-07-12-abcd-cli-drain-2.md — the hand-authored precursor to what abcd drain will automate: a scope-fenced batch of the two known-fixable follow-ups from drain #1:

  • iss-76cli.Run leaks absolute paths via *PathError into the --json error envelope for verbs beyond docs-lint (the systemic version of the iss-29 fix).
  • iss-79memory/ingest.go storeOriginal, the fifth inline temp+rename left by the iss-32 consolidation.

Design-STOP (iss-28/35/77), ops (iss-78), and the un-triaged older cluster (iss-33/34/37–49) are in explicit skips.

Record-only change: make record-lint green, all relative links resolve. No code, no dependency.

Assisted-by: Claude:claude-opus-4-8

itd-82 settles the abcd drain design: one verb triages the open ledger
and routes each ready issue to an existing engine — fixable to the
autonomous run (itd-29), design-STOP to capture promote (itd-46) as an
intent draft, ops/blocked to skip-with-reason. Fail-safe classifier
(low confidence -> human side). Cut A ships classifier + fix + skip
paths against the working run engine; the promote route flags until
itd-46 lands. Reuses promote rather than minting a verb
(one-canonical-primitive). Maintainer-signed-off design.

The drain #2 run plan is the hand-authored precursor: a scope-fenced
batch of the two known-fixable follow-ups from drain #1 (iss-76 json
error abspath leak, iss-79 storeOriginal inline atomic write), with the
design-STOP/ops issues and the un-triaged older cluster in explicit
skips.

Assisted-by: Claude:claude-opus-4-8
@REPPL
REPPL merged commit c5ba73a into main Jul 12, 2026
12 checks passed
@REPPL
REPPL deleted the docs/itd-82-drain-triage branch July 12, 2026 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant