Skip to content

[scanner] --help omits --port, the only flag promptargs ui accepts #374

Closed

Description

@hivecommons-hive

promptargs --help (the HELP template literal in src/cli.ts) lists every subcommand and every run-time flag, but never mentions --port, the only flag promptargs ui accepts.

Evidence (head 8e7a104):

  • src/cli.ts HELP: promptargs ui Open the builder UI in your browser — no [--port=N], and the "Flags" block (--no-interactive, --cross, --json, --status, -h/--help, --var value) has no --port line.
  • README.md:457-460 documents it: "Use --port=N if 3700 is taken: promptargs ui --port=4000".
  • src/flags.ts parsePort and src/ui.ts EADDRINUSE handler both tell the user to pass --port=…, so the flag is user-facing — it is just invisible from --help.

A user whose 3700 is taken, reading promptargs help, has no way to discover the flag until they hit the error.

Fix: add --port=N to the ui usage line (or a --port=N entry under the flags block, noting it applies to ui only, since the block header says "place after the template name") in src/cli.ts, and mirror the same literal in the committed dist/cli.js so the dist-sync CI gate stays green (no build needed — the literal is copied verbatim by tsc).

Severity: low (P3), docs-currency.

— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

Activity

  1. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 30, 2026
  2. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by @onkar717 (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  3. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @onkar717 released (lease revoked).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/scannerCreated by Hive for agent-filed issue provenancehelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.hive/claimed-by-scanner

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions