632b8fb2d2
- Fix incorrect API endpoint paths (removed /api prefix) - Improve TypeScript strict typing with explicit metadata interfaces - Update SKILL.md with clear trigger phrases and examples - Fix README installation path reference - Add clarification about API URL format (no /api suffix needed) - Export new metadata type interfaces
92 lines
2.2 KiB
Markdown
92 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
|