feat: CLI v0.4.0 — marketplace lifecycle, app management, Homebrew

[DuncanAForbes]

Summary

• Marketplace submission lifecycle: bagdock validate, bagdock submission list/status/withdraw
• App management: bagdock open, bagdock inspect, bagdock link, bagdock env pull
• Ecosystem: Homebrew tap (bagdock/homebrew-cli), skills repo (bagdock/bagdock-skills) with Cursor, Claude Code, Codex, Conductor plugins
• Updated README, CHANGELOG, SKILL.md, evals.json with all new commands
• Version bump to 0.4.0

Test plan

• npx tsc --noEmit passes
• vitest run passes (13 tests)
• New commands register correctly (bagdock --help)
• bagdock validate runs locally against a bagdock.json
• brew install bagdock/cli/bagdock installs after 0.4.0 publish
• npx skills add bagdock/bagdock-skills installs skills

Summary by CodeRabbit

• New Features

  • Released CLI version 0.4.0 with eight new commands: validate, submission list/status/withdraw, open, inspect, link, and env pull.
  • Added Homebrew installation support alongside existing installation methods.
  • Introduced a dedicated skills repository with plugin integrations.

• Documentation

  • Expanded README with command usage examples and updated agent skills references.
  • Added reference documentation for app management and marketplace submission workflows.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 1df3306e-fc0e-4c5d-aa2d-98aac0f6d0c4

📥 Commits

Reviewing files that changed from the base of the PR and between c4aa143 and dc48318.

📒 Files selected for processing (14)

• CHANGELOG.md
• README.md
• bin/bagdock.ts
• package.json
• skill-evals/bagdock-cli/evals.json
• skills/bagdock-cli/SKILL.md
• skills/bagdock-cli/references/app-management.md
• skills/bagdock-cli/references/marketplace.md
• src/env-cmd.ts
• src/inspect.ts
• src/link.ts
• src/open.ts
• src/submission.ts
• src/validate.ts

---

Walkthrough

This PR upgrades the Bagdock CLI from version 0.3.0 to 0.4.0, introducing eight new commands for marketplace submission lifecycle management, app management, local validation, and environment variable synchronisation. Implementation spans six new modules plus CLI entrypoint wiring and comprehensive documentation updates.

Changes

Cohort / File(s)	Summary
Version & Release Updates CHANGELOG.md, package.json, bin/bagdock.ts	Bumped version to 0.4.0 with changelog entry documenting new commands and Homebrew installation. Updated CLI version string.
Documentation Expansion README.md, skills/bagdock-cli/SKILL.md	Added Homebrew installation instructions; expanded agent skills list; documented eight new CLI commands with usage examples, flags, and outputs.
Marketplace Submission References skills/bagdock-cli/references/marketplace.md	New reference document defining submission lifecycle (validate, submit, list, status, withdraw), validation checks, exit codes, and API endpoints.
App Management References skills/bagdock-cli/references/app-management.md	New reference document describing link, open, and inspect commands including slug resolution order, .bagdock/link.json structure, and JSON output modes.
Marketplace Submission Implementation src/submission.ts	Implemented submissionList(), submissionStatus(), and submissionWithdraw() functions with API integration, error handling, and dual output modes (JSON and human-readable tabular/field display).
App Management Implementation src/link.ts, src/open.ts, src/inspect.ts	Added app linking (interactive slug selection, persistence to .bagdock/link.json), dashboard opening with browser launch, and deployment inspection with formatted detail output.
Validation & Environment Tools src/validate.ts, src/env-cmd.ts	Implemented local pre-submission validation checks (bagdock.json parsing, field requirements, type/entry point/bundle size validation) and remote environment variable retrieval with local .env file creation.
CLI Entrypoint Wiring bin/bagdock.ts	Added command definitions for validate, submission (with list/status/withdraw subcommands), open, inspect, link, and env pull, with dynamic imports and proper routing.
Evaluation & Testing skill-evals/bagdock-cli/evals.json	Extended evaluation suite with nine new test cases covering all new commands, version bump to 0.4.0.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related PRs

• chore: bump to 0.2.0 for npm publish #2: Provides foundational CLI infrastructure (bin/bagdock.ts patterns, auth helpers, structured output utilities) that this PR extends with new command implementations and API integrations.

Poem

🐰 Eight new commands hopped into place,
From validate checks to links we trace,
The CLI grows with each new command,
Submissions, apps, and env at hand,
Version bumped, the CHANGELOG complete—
A feature-rich release, oh so sweet! 🥕

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch develop

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}