POST /api/scaffold — accept manifest, dispatch both jobs

[jordanpartridge]

What

Single entry point into the queue — but Foundry accepts manifests from multiple interfaces. All roads lead to the same ScaffoldPipeline.

Entry Points

Interface	How
REST API	POST /api/scaffold
MCP server	scaffold_app tool — Claude/Lexi calls directly
Bifrost subscriber	Listens on bifrost.foundry Redis channel, routes foundry.scaffold.requested events
Mattermost/Slack	/foundry billing-service slash command
CLI	php artisan foundry:scaffold manifest.json

Bifrost Integration

Foundry registers itself as a Bifrost subscriber on boot. Any service that emits a foundry.scaffold.requested event via Bifrost gets a microservice scaffolded automatically — no direct HTTP call required.

Core Flow (same regardless of entry point)

manifest in
  → validate via ManifestData DTO
  → dispatch RepoGeneratorJob
  → dispatch CodeGeneratorJob
  → return { job_id, status_url }

Acceptance Criteria

• POST /api/scaffold accepts manifest JSON
• MCP server exposes scaffold_app tool
• ListenCommand subscribes to bifrost.foundry on boot, routes foundry.scaffold.requested
• php artisan foundry:scaffold reads manifest from file or stdin
• All entry points converge on same ScaffoldPipeline service
• GET /api/scaffold/{id} returns current status
• 100% test coverage

[jordanpartridge]

Implemented in PR #6 on branch feature/scaffold-endpoint.

What was built:

• app/Enums/ScaffoldStatus.php — backed string enum with cases Queued/Running/Complete/Failed
• app/Models/ScaffoldRun.php — Eloquent model with UUID PK, manifest (array cast), status (enum cast), nullable output and completed_at
• database/migrations/2026_05_03_000001_create_scaffold_runs_table.php — scaffold_runs table
• app/Http/Controllers/ScaffoldController.php — store validates manifest with Laravel rules, creates ScaffoldRun, dispatches RepoGeneratorJob + CodeGeneratorJob, returns 201; show returns run status or 404
• app/Jobs/CodeGeneratorJob.php — stub implementing ShouldQueue, holds ScaffoldRun reference
• routes/api.php — POST /api/scaffold and GET /api/scaffold/{id} named routes

All gate checks pass: 100% coverage, Pint clean, composer audit clean.