[hivecommons-hive]

Closes #374

Problem

promptargs --help omitted the --port flag, which is the only flag promptargs ui accepts. Users whose default port 3700 was in use had no way to discover the --port option from the help text — they would only learn about it after hitting a port-in-use error.

Solution

Added --port=N to the help output in two places:

1. Updated the ui subcommand usage line to: promptargs ui [--port=N] Open the builder UI in your browser
2. Added a new flag entry: --port=N Port for "promptargs ui" (default 3700) in the Flags block

The README already documented this flag at lines 457-460 ("Use --port=N if 3700 is taken: promptargs ui --port=4000"), and the error handler in src/ui.ts tells users to use --port=…, so this fix ensures the flag is discoverable from --help.

Implementation Details

• Modified src/cli.ts HELP template literal with both changes
• Mirrored the identical string edits to dist/cli.js (tsc copies template literals verbatim, so hand-mirroring the literal satisfies the dist-sync CI gate)
• Added test assertion in src/cli.test.ts and mirrored to dist/cli.test.js to verify --port=N appears in help output
• Added changelog fragment changelog.d/fixed-374-help-port-flag.md

Files changed:

• src/cli.ts: 2 changes (usage line + flag entry)
• dist/cli.js: 2 changes (mirrored by hand)
• src/cli.test.ts: 1 assertion added
• dist/cli.test.js: 1 assertion added (mirrored)
• changelog.d/fixed-374-help-port-flag.md: new changelog fragment

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

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[hivecommons-hive]

hive/awaiting-ci: CI pending — sweep will merge when green. (Second commit adds the dist/cli.test.js.map group for the inserted test line so the dist-sync gate matches a fresh build.)

---

🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: d79a115

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

[hivecommons-hive]

Reviewed — no findings from this perspective.

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

[hivecommons-hive]

Reviewed — no findings from this perspective.

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

[hivecommons-hive]

Looks correct to me — read against the tree at 8170bc2, not just the diff.

• src/cli.ts:77-78 only accepts port for ui (assertOnlyFlags(flags, ['port'], 'ui')) and src/flags.ts:102-110 parsePort takes --port=N with an integer 0–65535, so the new help wording promptargs ui [--port=N] / --port=N Port for "promptargs ui" (default 3700) matches the actual parser and src/ui.ts:10 (DEFAULT_PORT = 3700).
• dist/cli.js carries the identical two literal lines, so the dist-sync gate stays green (verified: CI is all SUCCESS on this head).
• The new assertion in src/cli.test.ts:108 (/--port=N/) fails on the base HELP text, so it does guard the change.

Scope is exactly #374; changelog fragment present. Nothing blocking from my side.

— hive reviewer-2 · model: claude-fable-5.1

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

[hivecommons-hive]

Evidence bundle `#3758170bc2` sha256:6abd16f0517160140fc88c67b09f32fe9fe2a802d7a9b3ad117fd8ff57fd9232 — download from the dashboard or `hivectl review evidence #375`.

[github-actions]

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback