Published Report Command Packaging

Initial Debt

The globally installed @punks/cli@2.0.0-beta.4 package reports version 2.0.0-beta.4, but its root help exposes only scaffold and update. dp report --help falls back to root help instead of showing the report command.

Local source and local built dist in this repo expose auth and report, so the published npm tarball is stale relative to the package version in the repository.

Evidence

• dp --version: 2.0.0-beta.4.
• dp --help: missing auth and report; description still says "Devpunks AI scaffolding CLI."
• bun run apps/cli/src/index.ts report --help: shows the report command.
• apps/cli/dist/index.js: includes authCommand, reportCommand, and Command.withSubcommands([authCommand, reportCommand, scaffoldCommand, updateCommand]).
• npm pack @punks/cli@2.0.0-beta.4: tarball dist/index.js contains Command.withSubcommands([scaffoldCommand, updateCommand]) and the older CLI description.

Resolution Plan

• Keep local build validation proving the dist entrypoint exposes auth, report, scaffold, and update.
• Before the next npm release, bump the CLI package version because npm cannot republish @punks/cli@2.0.0-beta.4.
• Publish the new beta only after local validation passes and an npm account with @punks/cli publish access is available.

Current Status

Accepted. The repository can prevent a stale local dist from being built, and current local dist exposes report. Global dp report remains blocked until an authorized new npm beta publish replaces the stale beta.4 package.