Implements FED-010: Agent Spawn via Federation feature that enables spawning and managing Claude agents on remote federated Mosaic Stack instances via COMMAND message type. Features: - Federation agent command types (spawn, status, kill) - FederationAgentService for handling agent operations - Integration with orchestrator's agent spawner/lifecycle services - API endpoints for spawning, querying status, and killing agents - Full command routing through federation COMMAND infrastructure - Comprehensive test coverage (12/12 tests passing) Architecture: - Hub → Spoke: Spawn agents on remote instances - Command flow: FederationController → FederationAgentService → CommandService → Remote Orchestrator - Response handling: Remote orchestrator returns agent status/results - Security: Connection validation, signature verification Files created: - apps/api/src/federation/types/federation-agent.types.ts - apps/api/src/federation/federation-agent.service.ts - apps/api/src/federation/federation-agent.service.spec.ts Files modified: - apps/api/src/federation/command.service.ts (agent command routing) - apps/api/src/federation/federation.controller.ts (agent endpoints) - apps/api/src/federation/federation.module.ts (service registration) - apps/orchestrator/src/api/agents/agents.controller.ts (status endpoint) - apps/orchestrator/src/api/agents/agents.module.ts (lifecycle integration) Testing: - 12/12 tests passing for FederationAgentService - All command service tests passing - TypeScript compilation successful - Linting passed Refs #93 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
95 lines
2.2 KiB
Markdown
95 lines
2.2 KiB
Markdown
# Mosaic Stack Gantt Plugin
|
|
|
|
Clawdbot skill for querying and analyzing project timelines, task dependencies, and schedules from Mosaic Stack's Gantt/Project API.
|
|
|
|
## Features
|
|
|
|
- Query project timelines and task lists
|
|
- Check task dependencies and blocking relationships
|
|
- Get project status overviews with statistics
|
|
- Identify critical path items in projects
|
|
- PDA-friendly language (supportive, non-judgmental)
|
|
|
|
## Installation
|
|
|
|
1. **Copy skill to Clawdbot plugins directory:**
|
|
|
|
```bash
|
|
cp -r ~/src/mosaic-stack-worktrees/feature-26-gantt-skill/packages/skills/gantt ~/.claude/plugins/mosaic-plugin-gantt
|
|
```
|
|
|
|
2. **Set up environment variables:**
|
|
|
|
Add to your `.env` or shell profile:
|
|
|
|
```bash
|
|
export MOSAIC_API_URL="http://localhost:3000"
|
|
export MOSAIC_WORKSPACE_ID="your-workspace-uuid"
|
|
export MOSAIC_API_TOKEN="your-api-token"
|
|
```
|
|
|
|
3. **Verify installation:**
|
|
```bash
|
|
~/.claude/plugins/mosaic-plugin-gantt/gantt-api.sh projects
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Via Clawdbot
|
|
|
|
Once installed, you can ask Clawdbot:
|
|
|
|
- "Show me the timeline for Project Alpha"
|
|
- "What blocks task 'Implement Auth'?"
|
|
- "What's the critical path for Q1 release?"
|
|
- "Show all high-priority tasks due this week"
|
|
- "Give me a status overview of Project Beta"
|
|
|
|
### Via Command Line
|
|
|
|
The `gantt-api.sh` helper script can be used directly:
|
|
|
|
```bash
|
|
# List all projects
|
|
./gantt-api.sh projects
|
|
|
|
# Get project details with tasks
|
|
./gantt-api.sh project <project-id>
|
|
|
|
# Get tasks for a project
|
|
./gantt-api.sh tasks <project-id>
|
|
|
|
# Get task details
|
|
./gantt-api.sh task <task-id>
|
|
|
|
# Get dependency chain for a task
|
|
./gantt-api.sh dependencies <task-id>
|
|
|
|
# Calculate critical path for a project
|
|
./gantt-api.sh critical-path <project-id>
|
|
|
|
# Find tasks by status
|
|
./gantt-api.sh status IN_PROGRESS
|
|
./gantt-api.sh status COMPLETED <project-id>
|
|
```
|
|
|
|
## API Reference
|
|
|
|
### Endpoints
|
|
|
|
- `GET /projects` - List projects (paginated)
|
|
- `GET /projects/:id` - Get project with tasks
|
|
- `GET /tasks` - List tasks with filters
|
|
- Query params: `projectId`, `status`, `priority`, `assigneeId`, `page`, `limit`
|
|
|
|
### Authentication
|
|
|
|
All requests require headers:
|
|
|
|
- `X-Workspace-Id`: Workspace UUID
|
|
- `Authorization`: Bearer {token}
|
|
|
|
## License
|
|
|
|
MIT
|