SiteForge — Angular 19+ Scaffolding Engine & Angular CLI MCP Harness

SiteForge (The Autonomous Angular Web Factory) builds modern, schema-driven Angular web applications deployed to Vercel.

This repository contains the deliverables for [SF-03] Angular 19+ Scaffolding Engine & Angular CLI MCP Harness:

1. Modern Angular Architecture & Starter Workspace (starter-workspace/):

   • Standalone components only (no NgModules).
   • Signals for reactive state (signal, computed, effect, input, output, model).
   • Zoneless change detection (provideZonelessChangeDetection()).
   • Modern @if and @for (item of items; track item.id) control flow.
   • Modular Layout Primitives (Header, Hero, ContentGrid, Card, Sidebar, Footer).
   • Flagship Reference Showcase: PlantCare Academy (Home Plants Care E-Learning Portal).
   • Compiles with zero warnings and passes all unit tests.

2. Autonomous Scaffolding Engine (scaffolding-engine/):

   • Programmatic TypeScript engine and CLI (siteforge-scaffold).
   • Design Token Compiler: compiles root Design.md aesthetic presets (warm-organic / Greenhouse Lab, neo-brutalist / Signal Block, clean-editorial / Gallery Press, modern-saas-dark / Forge Night, corporate-enterprise / Ledger, pulse-magazine / Pulse Wire) into CSS Custom Properties (:root[data-theme="..."]).
   • Full scaffolding support across all 6 archetypes:
     • learning_platform
     • blog
     • newsletter
     • ecommerce
     • social_media
     • landing_page
   • Complete Vitest test suite covering token compilation and project generation.

3. Angular CLI Model Context Protocol (MCP) Harness (mcp-harness/):

   • Integrates the official Angular CLI MCP server (npx -y @angular/cli mcp).
   • Typed client AngularMcpClient implementing JSON-RPC 2.0 communication over stdio.
   • Live capabilities:
     • search_documentation: Live queries against official angular.dev docs.
     • get_best_practices: Retrieval of official Angular coding standards and rules.
     • list_projects: Workspace discovery and configuration introspection.
     • onpush_zoneless_migration: Zoneless migration planning.
     • run_target: Programmatic target execution (build, test, lint).
   • CLI diagnostic runner (bin/runner.js) and live integration test suite.

---

Workspace Structure

.
├── starter-workspace/       # Modern Angular Starter Workspace & Flagship Showcase
│   ├── src/
│   │   ├── app/
│   │   │   ├── core/        # ThemeService, PayloadService, models
│   │   │   ├── layout/      # Header, Hero, ContentGrid, Card, Sidebar, Footer
│   │   │   └── showcase/    # PlantCare Academy showcase view
│   │   └── styles/          # design-tokens.css (all Design.md presets)
│   └── dist/                # Production build artifacts
│
├── scaffolding-engine/      # Scaffolding Engine & Design Token Compiler
│   ├── src/