Skip to content

fix(cli): Add help recipe for the detect command#61

Merged
thecodedrift merged 1 commit into
mainfrom
fix/detect-help-topic
Jul 12, 2026
Merged

fix(cli): Add help recipe for the detect command#61
thecodedrift merged 1 commit into
mainfrom
fix/detect-help-topic

Conversation

@thecodedrift

Copy link
Copy Markdown
Member

taskless help detect errored with "Unknown command: detect" (exit 1), even though detect shows up in the taskless help topic index.

The index is auto-generated from the registered subcommands, but the topic body is served from packages/cli/src/help/<topic>.txt. detect had no backing file, so it advertised itself in the index yet failed when asked for. Every other registered command (init, update, info, check, auth, onboard, rule) already had a matching help file — detect was the lone gap. Reported by the marketing team.

Adds detect.txt, matching the house style of the sibling read-only/offline command info.txt. It documents the real --json output shape (linters, languages, ruleStyles, verified against live output including the exact evidence format) and cross-links to the route/existing authoring flow that consumes detect's signals.

detect.txt is plain text embedded via import.meta.glob, so there is no type/lint surface. Verified taskless help detect now renders and exits 0, all 8 registered commands have help coverage, and the full CLI suite passes (363 tests, including the help-extensions topic tests).

🤖 Generated with Claude Code

`detect` is a registered subcommand, so it appeared in the `taskless help`
topic index — but `taskless help detect` had no backing `detect.txt` and fell
through to "Unknown command", exiting 1. Every other registered command already
had a matching help file; `detect` was the lone gap.

Add `detect.txt` documenting the `--json` output shape (linters, languages,
ruleStyles) and cross-linking to the route/existing authoring flow that consumes
those signals.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@thecodedrift thecodedrift marked this pull request as ready for review July 12, 2026 06:27
Copilot AI review requested due to automatic review settings July 12, 2026 06:27
@thecodedrift thecodedrift merged commit 53b2d30 into main Jul 12, 2026
8 checks passed
@thecodedrift thecodedrift deleted the fix/detect-help-topic branch July 12, 2026 06:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes a gap in the CLI help system by adding a missing help topic file for the registered detect subcommand, so taskless help detect no longer falls through to “Unknown command”.

Changes:

  • Added packages/cli/src/help/detect.txt help recipe documenting detect --json and how it feeds routing/authoring flows.
  • Added a changeset to release the help topic addition as a patch for @taskless/cli.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
packages/cli/src/help/detect.txt New help topic for detect, including JSON shape, routing guidance, and error code table.
.changeset/detect-help-topic.md Patch changeset announcing the new detect help recipe.

"evidence": ["eslint.config.js", "dependency eslint (package.json)"]
}
],
"languages": ["typescript", "javascript"],
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.

2 participants