Introduce Launchpad Controller

[claytercek]

Phase 1: Central Controller Architecture

Phase 1 of #215

Summary

Introduces a central controller architecture that orchestrates subsystems (content and monitor) through commands and events, providing the foundation for future persistent mode operations.

🎯 What's Changed

New Controller Package (@bluecadet/launchpad-controller)

• LaunchpadController - Central orchestrator class
• EventBus - Type-safe event system with declaration merging
• StateStore - Aggregates state from all subsystems
• CommandDispatcher - Routes commands to appropriate subsystems

Enhanced Subsystem Integration

• Added controller interfaces to @bluecadet/launchpad-utils
• Updated content and monitor packages to implement optional interfaces
• Introduced type-safe event definitions with declaration merging

CLI Integration

• Updated launchpad content and launchpad monitor commands to use controller
• Added task mode for ephemeral controller operations
• Controller now required dependency (no fallback logic)

🔧 Key Features

Type-Safe Events

// Subsystems define their own events via declaration merging
declare module '@bluecadet/launchpad-controller' {
  interface LaunchpadEvents {
    'content:fetch:start': { timestamp: Date };
    'content:fetch:done': { sources: string[]; totalFiles: number };
  }
}

Duck-Typed Interfaces

interface Subsystem<TCommand, TState> = Partial<
  EventBusAware &
  CommandExecutor<TCommand> &
  StateProvider<TState> &
  Disconnectable
>;

Task Mode Architecture

1. Create controller instance
2. Register subsystem(s)
3. Start controller
4. Execute command(s)
5. Stop controller

💥 Breaking Changes

None! This is a fully backward-compatible enhancement.

[changeset-bot]

🦋 Changeset detected

Latest commit: 02adddf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
@bluecadet/launchpad-controller	Minor
@bluecadet/launchpad-cli	Minor
@bluecadet/launchpad	Patch
@bluecadet/launchpad-content	Patch
@bluecadet/launchpad-monitor	Patch
@bluecadet/launchpad-utils	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[claytercek]

This doesn't include any documentation updates because there are no end-user API changes... that said it's probably worth documenting this architecture and the design decisions somewhere in the repo that isn't just code comments...

[claytercek]

Still need to actually emit events in content/monitor 🤦

I declared the event types, but didn't actually integrate them anywhere

[claytercek]

Also worth noting: keeping the major version as 0, as the controller API could change significantly in the next 2 phases.