feat(cli): extract CLI functionality into standalone package

[willgriffin]

Summary

Extracted CLI functionality from @happyvertical/smrt-core into a new standalone @happyvertical/smrt-cli package with automatic manifest discovery and new introspection commands.

This achieves clean separation between framework code (core) and developer tooling (CLI), reduces core dependencies, and provides better discoverability through the new smrt introspect command.

Changes

New CLI Package (packages/cli/)

• Created standalone @happyvertical/smrt-cli package
• Moved CLIGenerator and all command implementations from core
• Added tar dependency to CLI (removed from core)
• Configured TypeScript project references
• Built with Vite for optimal tree-shaking

New Features

Manifest Discovery System:

• Automatically discovers SMRT object manifests from project root and node_modules
• Searches: dist/manifest.json, dist/static-manifest.js, src/manifest/, etc.
• Loads both .js and .json manifest formats

smrt introspect Command:

• Analyze project and discover SMRT objects
• Shows discovered manifests with source (project vs package)
• Displays object counts and paths
• --verbose flag for detailed field information
• Aliases: inspect, info

smrt test Command:

• Guides users to set up test manifest generation
• Points to existing script-based approach (packages/profiles/scripts)
• Optional test execution with vitest

Core Package Cleanup

• Removed CLI binary (dist/generators/cli.js)
• Removed entire src/cli/ directory with command implementations
• Removed src/generators/cli.ts and cli.spec.ts
• Removed tar dependency from package.json
• Removed CLI exports from generators/index.ts
• Clean separation between framework and tooling

Documentation

• Created comprehensive CLI_EXTRACTION_SUMMARY.md
• Updated root README.md to list CLI package
• Updated packages/cli/README.md with usage examples and manifest discovery details

Testing

Build Status:

• ✅ @happyvertical/smrt-cli builds without errors
• ✅ @happyvertical/smrt-core builds without errors
• ✅ All imports resolve correctly
• ✅ Type declarations generated

Runtime Testing:

• ✅ Tested in profiles package
• ✅ Introspect command successfully discovers manifests
• ✅ Discovered 7 SMRT objects from profiles package
• ✅ Both normal and verbose modes work correctly

Discovery Path Fix:

• Added dist/manifest.json and dist/static-manifest.js to search paths
• Previously only searched src/manifest/ and root, missing build artifacts
• Now correctly discovers manifests in all SMRT packages

Benefits

1. Clean Separation: CLI is now independent from core framework
2. Reduced Core Dependencies: tar removed from core
3. Better Discoverability: smrt introspect solves the discovery problem from Issue Implement 'smrt test' CLI command for test manifest generation #135
4. Independent Versioning: CLI can evolve separately from core
5. Focused Packages: Each package has a clear, single responsibility

Breaking Changes

⚠️ Breaking: Projects depending on smrt binary from @happyvertical/smrt-core must now install @happyvertical/smrt-cli.

Migration:

{
  "devDependencies": {
    "@happyvertical/smrt-cli": "^0.6.0"
  }
}

Then use:

npx smrt introspect  # NEW - auto-discover manifests
npx smrt test        # Guidance for test manifest generation

Related Issues

Related to #135 (partially addresses the discovery problem with smrt introspect)

Checklist

• Code builds successfully
• Tests pass
• Code formatted with Biome
• TypeScript compiles
• Documentation updated
• Conventional commit message
• Tested in real package (profiles)

[willgriffin]

Update: Implemented Full smrt test Command

Based on feedback, smrt test now actually generates test manifests instead of just providing guidance.

What Changed

Before: Command provided guidance and pointed to script-based approach
After: Command performs full manifest generation and test execution

Implementation

The command now:

1. Scans test files using ASTScanner (src//*.test.ts, src//*.spec.ts)
2. Generates manifest using ManifestGenerator
3. Writes outputs:
   • src/manifest/test-manifest.json (JSON format)
   • src/manifest/test-manifest-stub.ts (TypeScript stub)
4. Runs tests with vitest (unless --manifest-only flag is used)

Usage

# Generate manifest and run tests
smrt test

# Generate manifest only (skip test execution)
smrt test --manifest-only

# Custom output directory
smrt test --output dist/manifests

Package Size Impact

The CLI bundle increased from ~30KB to ~6.2MB due to including the TypeScript AST scanner. This is necessary for parsing TypeScript test files to extract SMRT object definitions.

All tests and builds pass successfully. Documentation has been updated to reflect the actual functionality.