Skip to content

fix(cli): add externalize/internalize to top-level squad --help (#1050)#1232

Open
primetimetank21 wants to merge 1 commit into
bradygaster:devfrom
primetimetank21:squad/1050-help-externalize-internalize
Open

fix(cli): add externalize/internalize to top-level squad --help (#1050)#1232
primetimetank21 wants to merge 1 commit into
bradygaster:devfrom
primetimetank21:squad/1050-help-externalize-internalize

Conversation

@primetimetank21

Copy link
Copy Markdown

What

Adds the externalize and internalize commands to the top-level squad --help command listing so they are discoverable, and adds a regression test that guards the listing.

Why

Closes #1050. Both commands already exist and have per-command help (squad externalize --help, squad internalize --help), but they were missing from the top-level squad --help command list. Users browsing squad --help had no way to discover them.

How

  • Added two entries to the top-level help block in packages/squad-cli/src/cli-entry.ts, placed alphabetically between link and build to match the surrounding ordering.
  • Descriptions are copied verbatim from the source of truth in packages/squad-cli/src/cli/core/command-help.ts, and the column alignment matches the existing long-command-name precedent (e.g. scrub-emails, copilot-bridge).
  • Extended the existing "lists every major command" assertion in test/human-journeys.test.ts rather than adding a new test, keeping the diff minimal.
  • Negative-checked the test: reverting the fix makes it fail, restoring makes it pass.

⚠️ Quick Check

  • If SDK/CLI source files changed: completed the applicable Changeset step below (.changeset/help-externalize-internalize.md, patch to @bradygaster/squad-cli)

PR Readiness Checklist

Branch & Commit

  • Branch created from dev (not main)
  • Branch is up to date with dev (ahead 1, behind 0 at time of push)
  • Verified diff contains only intended changes (git diff --cached --stat: 3 files, +8/-1)
  • PR is not in draft mode (intentionally opened as draft per CONTRIBUTING handoff flow; will mark ready once CI is green)
  • Commit history is clean (squashed to a single commit)

Build & Test

  • npm run build passes
  • npm run lint passes (type check clean)
  • Targeted help/command-listing tests pass (test/human-journeys.test.ts, command-help tests)
  • npm test full suite — letting CI be the arbiter. Locally on a fresh Windows clone the full suite has pre-existing environmental failures (worker-RPC timeouts, npm pack/install integration smoke tests, storage-provider FS-contract tests) that are present on untouched dev as well; a baseline run of clean dev failed more than this branch, confirming this change introduces zero new failures.

Changeset

  • Changeset added (.changeset/help-externalize-internalize.md, patch to @bradygaster/squad-cli)

Docs

  • N/A — no new feature/module; this surfaces existing commands in help output.

Exports

  • N/A — no new modules or exports.

Breaking Changes

None.

Waivers

None.


Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

The top-level `squad --help` command list omitted the externalize and
internalize commands, leaving them undiscoverable. Add both entries
(descriptions sourced verbatim from command-help.ts) plus a regression
test guarding the top-level command list.

Closes bradygaster#1050

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit 1a65815

PR Scope: 📦🔧 Mixed (product + infrastructure)

⚠️ 1 item(s) to address before review

Status Check Details
Single commit 1 commit — clean history
Not in draft Ready for review
Branch up to date Up to date with dev
Copilot review No Copilot review yet — it may still be processing
Changeset present Changeset file found
Scope clean No .squad/ or docs/proposals/ files
No merge conflicts No merge conflicts
Copilot threads resolved No Copilot review threads
CI passing All checks passing

Files Changed (3 files, +8 −1)

File +/−
.changeset/help-externalize-internalize.md +5 −0
packages/squad-cli/src/cli-entry.ts +2 −0
test/human-journeys.test.ts +1 −1

Total: +8 −1


This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

🟡 Impact Analysis — PR #1232

Risk tier: 🟡 MEDIUM

📊 Summary

Metric Count
Files changed 3
Files added 1
Files modified 2
Files deleted 0
Modules touched 3

🎯 Risk Factors

  • 3 files changed (≤5 → LOW)
  • 3 modules touched (2-4 → MEDIUM)

📦 Modules Affected

root (1 file)
  • .changeset/help-externalize-internalize.md
squad-cli (1 file)
  • packages/squad-cli/src/cli-entry.ts
tests (1 file)
  • test/human-journeys.test.ts

This report is generated automatically for every PR. See #733 for details.

@primetimetank21 primetimetank21 marked this pull request as ready for review June 9, 2026 06:48
Copilot AI review requested due to automatic review settings June 9, 2026 06:48

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

Note

Copilot was unable to run its full agentic suite in this review.

Updates the CLI help output and related tests so the new externalize and internalize commands are visible in squad --help.

Changes:

  • Add externalize and internalize to the top-level squad --help command list.
  • Update the cross-journey test to expect these commands in help output.
  • Add a changeset to publish the help-text update as a patch.

Reviewed changes

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

File Description
test/human-journeys.test.ts Extends the help-discoverability test to include externalize/internalize.
packages/squad-cli/src/cli-entry.ts Prints externalize/internalize in the --help command list.
.changeset/help-externalize-internalize.md Declares a patch release for the help output update.

Comment thread packages/squad-cli/src/cli-entry.ts
@primetimetank21 primetimetank21 requested a review from Copilot June 9, 2026 14:04

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

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

Comment thread packages/squad-cli/src/cli-entry.ts
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.

Bug: squad externalize and squad internalize missing from squad --help output

2 participants