feat(tbd-cli): Add git-based versioning and test install scripts

[jlevy]

Summary

• Add shared scripts/git-version.mjs for git-based version detection at build time
• Implement env var approach (TBD_DEV_VERSION) for dev mode version passing
• Add src/cli/lib/version.ts CLI module with clean fallback chain (no git dependency at runtime)
• Add test:install and test:uninstall scripts for testing packaged CLI installation
• Update research doc with improved versioning pattern as reference for future projects

Changes

New Files

• packages/tbd-cli/scripts/git-version.mjs - Single source of truth for git version logic
• packages/tbd-cli/scripts/git-version.d.mts - TypeScript declarations
• packages/tbd-cli/src/cli/lib/version.ts - CLI version resolution module

Modified Files

• package.json - Added tbd dev script with env var, test:install, test:uninstall
• packages/tbd-cli/package.json - Added test:install, test:uninstall scripts
• packages/tbd-cli/tsdown.config.ts - Simplified to import from shared script
• docs/development.md - Added "Testing the packaged installation" section
• docs/general/research/current/research-modern-typescript-monorepo-patterns.md - Updated versioning pattern documentation

CLI Files Updated

• src/cli/cli.ts, src/cli/commands/init.ts, src/cli/commands/import.ts, src/cli/commands/status.ts - Import VERSION from new module

Version Format

State	Format	Example
On tag	X.Y.Z	1.2.3
After tag	X.Y.Z-dev.N.hash	1.2.4-dev.12.a1b2c3d
Dirty	X.Y.Z-dev.N.hash-dirty	1.2.4-dev.12.a1b2c3d-dirty
No tags	X.Y.Z-dev.N.hash	0.1.0-dev.42.a1b2c3d

Manual Validation

# Test dev mode version
pnpm tbd --version
# Should show: 0.1.0-dev.N.hash format

# Test built version
pnpm build
pnpm tbd:bin --version
# Should show same git-based version

# Test packaged installation
pnpm test:install
tbd --version
pnpm test:uninstall

🤖 Generated with Claude Code

[github-actions]

Coverage Report for packages/tbd-cli

Status	Category	Percentage	Covered / Total
🔵	Lines	12.4%	659 / 5311
🔵	Statements	12.4%	659 / 5311
🔵	Functions	37.83%	42 / 111
🔵	Branches	79.27%	153 / 193

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
packages/tbd-cli/src/cli/cli.ts	0%	0%	0%	0%	1-152
packages/tbd-cli/src/cli/commands/import.ts	0%	0%	0%	0%	1-717
packages/tbd-cli/src/cli/commands/init.ts	0%	0%	0%	0%	1-122
packages/tbd-cli/src/cli/commands/status.ts	0%	0%	0%	0%	1-384
packages/tbd-cli/src/cli/lib/version.ts	0%	0%	0%	0%	1-40

Generated in workflow #85 for commit 55afcc2 by the Vitest Coverage Report Action