CRC wave 5: split Backlog::CliCommandHelpers #1025

New issue

Closed

opened 2026-10-16 18:24:36 +00:00 by jared · 2 comments

jared commented

2026-10-16 18:24:36 +00:00

Owner

Problem

plugins/os-backlog/lib/backlog/cli_command_helpers.rb (Backlog::CliCommandHelpers) has the job sentence "This object owns the wiring from each os-backlog command to its service call and the validation of that command's options.", which needs "and". Extract it into separate files.

Reproduce

n/a: structure-only refactor, no behavior change.

Approach

Required work:
- split plugins/os-backlog/lib/backlog/cli_command_helpers.rb (Backlog::CliCommandHelpers)
- public methods: initialize
- test: no test file
- Part names are chosen at extraction; the ledger and rulings do not name them.
- Before you finish, grep the repository for the old file path, not only the constant.
Governing rulings:
- R1: The CLI cluster is the entry layer, not a caller concept (Q1)

Acceptance criteria

Every named ledger row is applied, or logged in deviations.md, or reported blocked.
ruby plugins/os-backlog/tests/all.rb 0 failures.
ruby -e 'require "./plugins/os-backlog/lib/backlog"; Backlog.loader.eager_load' silent.

Owner sketch

Each part owns one job; the old file is removed.

Non-goals

No behavior change.
No new tests.
No deletion of code that has callers.

Origin

Session: 6bf383dd-a0e8-4c9b-9e75-286ee89969c3
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-crc-os-adr-2026-10-04/6bf383dd-a0e8-4c9b-9e75-286ee89969c3.jsonl
Where: plugins/os-backlog/lib/backlog/cli_command_helpers.rb
CRC refactor run: docs/crc/os-backlog.
Ledger: docs/crc/os-backlog/ledger.tsv
Rulings: docs/crc/os-backlog/rulings.md
Wave: 5.

## Problem `plugins/os-backlog/lib/backlog/cli_command_helpers.rb` (`Backlog::CliCommandHelpers`) has the job sentence "This object owns the wiring from each os-backlog command to its service call and the validation of that command's options.", which needs "and". Extract it into separate files. ## Reproduce n/a: structure-only refactor, no behavior change. ## Approach 1. Required work: - split `plugins/os-backlog/lib/backlog/cli_command_helpers.rb` (`Backlog::CliCommandHelpers`) - public methods: initialize - test: no test file - Part names are chosen at extraction; the ledger and rulings do not name them. - Before you finish, grep the repository for the old file path, not only the constant. 2. Governing rulings: - R1: The CLI cluster is the entry layer, not a caller concept (Q1) ## Acceptance criteria - Every named ledger row is applied, or logged in deviations.md, or reported blocked. - `ruby plugins/os-backlog/tests/all.rb` 0 failures. - `ruby -e 'require "./plugins/os-backlog/lib/backlog"; Backlog.loader.eager_load'` silent. ## Owner sketch Each part owns one job; the old file is removed. ## Non-goals - No behavior change. - No new tests. - No deletion of code that has callers. ## Origin - Session: 6bf383dd-a0e8-4c9b-9e75-286ee89969c3 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-crc-os-adr-2026-10-04/6bf383dd-a0e8-4c9b-9e75-286ee89969c3.jsonl - Where: plugins/os-backlog/lib/backlog/cli_command_helpers.rb - CRC refactor run: docs/crc/os-backlog. - Ledger: docs/crc/os-backlog/ledger.tsv - Rulings: docs/crc/os-backlog/rulings.md - Wave: 5.

jared added the

plugin/os-backlog

filed-by/agent

category/code-change

labels

2026-10-16 18:24:36 +00:00

jared commented

2026-10-16 18:47:24 +00:00

Author

Owner

29313d5e; rows applied 1/1; rows deviated 0; rows blocked 0

29313d5e; rows applied 1/1; rows deviated 0; rows blocked 0

jared commented

2026-10-16 19:26:00 +00:00

Author

Owner

Resolution

Done: Split CliCommandHelpers: CliCommandWiring keeps the wiring; option checks extracted (now CliOptions after #1036).

Evidence: 29313d5e; re-run waves 0-2 45b7cb13; branch crc-os-backlog-2026-10-16 (not merged); os-backlog suite 307 runs, 0 failures; eager load silent; inward lint none

Follow-ups: #1040 (one owner for the valid tracker of a directory, skeptic CREATE)

## Resolution **Done:** Split CliCommandHelpers: CliCommandWiring keeps the wiring; option checks extracted (now CliOptions after #1036). **Evidence:** 29313d5e; re-run waves 0-2 45b7cb13; branch crc-os-backlog-2026-10-16 (not merged); os-backlog suite 307 runs, 0 failures; eager load silent; inward lint none **Follow-ups:** #1040 (one owner for the valid tracker of a directory, skeptic CREATE)

jared closed this issue

2026-10-16 19:26:00 +00:00

jared referenced this issue from a commit

2026-10-17 00:13:42 +00:00

refactor(os-backlog): extract CliOptionValidator from CliCommandHelpers, rename it CliCommandWiring (#1025)

jared referenced this issue from a commit

2026-10-17 00:13:42 +00:00

docs(crc): #1025 #1026 ledger SHAs, wave 0-2 re-run for #1025 parts