Strip useless --no and --skip variants from project-config help #919

New issue

Open

opened 2026-10-03 12:41:36 +00:00 by jared · 0 comments

jared commented

2026-10-03 12:41:36 +00:00

Owner

Problem

The help output of os-sdlc project-config --help lists flags that have no use. Thor generates a --no-X and a --skip-X variant for each boolean method_option. The user wants useless or stale surface removed, after a check of the blast radius and of the reason each flag exists.

Observed

Observed on main on 2026-10-03.

os-sdlc project-config --help

  -h, [--help], [--no-help], [--skip-help]  # print this help
      [--show], [--no-show], [--skip-show]  # print the current configuration

Reproduce

os-sdlc project-config --help

Approach

Decide whether Thor can omit the --no-X and --skip-X variants for --help and --show. If it cannot, decide whether --help and --show must stop being boolean options. Check the blast radius first (os-sdlc:blast-radius) and find why each flag exists (ticket #860, ADR-0232).

Required work: none beyond the acceptance criteria.

Acceptance criteria

Given os-sdlc project-config --help, when printed, then the options list shows no --no-help, --skip-help, --no-show, or --skip-show, or the ticket records why Thor forces them.
Given project-config --help, -h, and --show, when run, then each behaves as before.

Origin

Trigger: review of closed ticket #860 with Jared, 2026-10-03.
Improvised this session: none.
Chain: useless help flags ← Thor boolean method_option ← DESIGN (plugins/os-sdlc/lib/os_sdlc/controller/project/onboarding.rb, #860).
Root candidate: none.
Where: plugins/os-sdlc/lib/os_sdlc/controller/project/onboarding.rb
Session: a0dbd5c4-ce77-4eaa-bb8a-9517044ae3ad (capture session; the review session ID was not available)
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/a0dbd5c4-ce77-4eaa-bb8a-9517044ae3ad.jsonl

## Problem The help output of `os-sdlc project-config --help` lists flags that have no use. Thor generates a `--no-X` and a `--skip-X` variant for each boolean `method_option`. The user wants useless or stale surface removed, after a check of the blast radius and of the reason each flag exists. ## Observed Observed on main on 2026-10-03. ``` os-sdlc project-config --help ``` ``` -h, [--help], [--no-help], [--skip-help] # print this help [--show], [--no-show], [--skip-show] # print the current configuration ``` ## Reproduce ``` os-sdlc project-config --help ``` ## Approach Decide whether Thor can omit the `--no-X` and `--skip-X` variants for `--help` and `--show`. If it cannot, decide whether `--help` and `--show` must stop being boolean options. Check the blast radius first (`os-sdlc:blast-radius`) and find why each flag exists (ticket #860, ADR-0232). Required work: none beyond the acceptance criteria. ## Acceptance criteria 1. Given `os-sdlc project-config --help`, when printed, then the options list shows no `--no-help`, `--skip-help`, `--no-show`, or `--skip-show`, or the ticket records why Thor forces them. 2. Given `project-config --help`, `-h`, and `--show`, when run, then each behaves as before. ## Origin - Trigger: review of closed ticket #860 with Jared, 2026-10-03. - Improvised this session: none. - Chain: useless help flags ← Thor boolean `method_option` ← DESIGN (plugins/os-sdlc/lib/os_sdlc/controller/project/onboarding.rb, #860). - Root candidate: none. - Where: plugins/os-sdlc/lib/os_sdlc/controller/project/onboarding.rb - Session: a0dbd5c4-ce77-4eaa-bb8a-9517044ae3ad (capture session; the review session ID was not available) - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/a0dbd5c4-ce77-4eaa-bb8a-9517044ae3ad.jsonl

jared added the

plugin/os-sdlc

filed-by/user

labels

2026-10-03 12:41:36 +00:00

jared added the

category/code-change

label

2026-10-10 13:31:50 +00:00