feat(cli): add BeforeCode CLI MVP

[BAKUGOS1]

Summary

Adds a polished BeforeCode CLI MVP that can generate, add, check, score, and prepare AI handoff files inside any project.

Included

• Node.js zero-dependency CLI package setup
• beforecode binary entrypoint
• Refactored command structure under src/commands/
• Core generator/checker/scorer/config/handoff modules under src/core/
• Project type maps for small, portfolio, saas, crm, ecommerce, mobile, ai-agent, and opensource
• Template registry under src/data/
• Safe-by-default file writing with --force
• --dry-run preview mode
• .beforecoderc.json generation and config loading
• beforecode handoff for AGENTS.md and docs/ai-handoff.md
• Node built-in test suite
• CLI test workflow
• CLI PRD, TRD, usage guide, and roadmap

Commands

node ./bin/beforecode.js help
node ./bin/beforecode.js list
node ./bin/beforecode.js init --type saas --docs tmp-docs
node ./bin/beforecode.js check --type saas --docs tmp-docs
node ./bin/beforecode.js score --type saas --docs tmp-docs
node ./bin/beforecode.js handoff --name Demo --docs tmp-docs

Local validation

Validated locally with:

npm test

Covered:

• help output
• list output
• init generation
• dry-run behavior
• add template
• check/score output
• AI handoff generation

Merge plan

Keep this PR as draft until GitHub Actions pass. Then squash merge into main as one clean feature commit.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8b6d2c01dd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".