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
144 lines
3.9 KiB
Markdown
144 lines
3.9 KiB
Markdown
---
|
|
name: mosaic-plugin-gantt
|
|
description: Query and analyze project timelines, task dependencies, and schedules from Mosaic Stack's Gantt/Project API
|
|
license: MIT
|
|
---
|
|
|
|
This skill enables querying project timelines, task dependencies, critical path analysis, and project status from Mosaic Stack's API.
|
|
|
|
## Overview
|
|
|
|
The Mosaic Stack provides project management capabilities with support for:
|
|
- Project timelines with start/end dates
|
|
- Task dependencies and scheduling
|
|
- Task status tracking (NOT_STARTED, IN_PROGRESS, PAUSED, COMPLETED, ARCHIVED)
|
|
- Priority levels (LOW, MEDIUM, HIGH, URGENT)
|
|
- Project status (PLANNING, ACTIVE, ON_HOLD, COMPLETED, ARCHIVED)
|
|
|
|
## API Endpoints
|
|
|
|
**Base URL**: Configured via `MOSAIC_API_URL` environment variable (default: `http://localhost:3000`)
|
|
|
|
### Projects
|
|
- `GET /projects` - List all projects with pagination
|
|
- `GET /projects/:id` - Get project details with tasks
|
|
|
|
### Tasks
|
|
- `GET /tasks` - List all tasks with optional filters
|
|
- Query params: `projectId`, `status`, `priority`, `assigneeId`, `page`, `limit`
|
|
|
|
## Authentication
|
|
|
|
Requests require authentication headers:
|
|
- `X-Workspace-Id`: Workspace UUID (from `MOSAIC_WORKSPACE_ID` env var)
|
|
- `Authorization`: Bearer token (from `MOSAIC_API_TOKEN` env var)
|
|
|
|
## Trigger Phrases & Examples
|
|
|
|
**Query project timeline:**
|
|
- "Show me the timeline for [project name]"
|
|
- "What's the status of [project]?"
|
|
- "Give me an overview of Project Alpha"
|
|
|
|
**Check task dependencies:**
|
|
- "What blocks task [task name]?"
|
|
- "What are the dependencies for [task]?"
|
|
- "Show me what's blocking [task]"
|
|
|
|
**Project status overview:**
|
|
- "Project status for [project]"
|
|
- "How is [project] doing?"
|
|
- "Summary of [project]"
|
|
|
|
**Identify critical path:**
|
|
- "Find the critical path for [project]"
|
|
- "What's the critical path?"
|
|
- "Show me blockers for [project]"
|
|
- "Which tasks can't be delayed in [project]?"
|
|
|
|
**Find upcoming deadlines:**
|
|
- "What tasks are due soon in [project]?"
|
|
- "Show me tasks approaching deadline"
|
|
- "What's due this week?"
|
|
|
|
## Data Models
|
|
|
|
### Project
|
|
```typescript
|
|
{
|
|
id: string;
|
|
name: string;
|
|
description?: string;
|
|
status: 'PLANNING' | 'ACTIVE' | 'ON_HOLD' | 'COMPLETED' | 'ARCHIVED';
|
|
startDate?: Date;
|
|
endDate?: Date;
|
|
color?: string;
|
|
tasks?: Task[];
|
|
_count: { tasks: number; events: number };
|
|
}
|
|
```
|
|
|
|
### Task
|
|
```typescript
|
|
{
|
|
id: string;
|
|
title: string;
|
|
description?: string;
|
|
status: 'NOT_STARTED' | 'IN_PROGRESS' | 'PAUSED' | 'COMPLETED' | 'ARCHIVED';
|
|
priority: 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT';
|
|
dueDate?: Date;
|
|
completedAt?: Date;
|
|
projectId?: string;
|
|
assigneeId?: string;
|
|
metadata: {
|
|
startDate?: Date;
|
|
dependencies?: string[]; // Array of task IDs
|
|
[key: string]: any;
|
|
};
|
|
}
|
|
```
|
|
|
|
## Helper Scripts
|
|
|
|
Use `gantt-api.sh` for API queries:
|
|
|
|
```bash
|
|
# List all projects
|
|
./gantt-api.sh projects
|
|
|
|
# Get project by ID
|
|
./gantt-api.sh project <project-id>
|
|
|
|
# Get tasks for a project
|
|
./gantt-api.sh tasks <project-id>
|
|
|
|
# Find critical path
|
|
./gantt-api.sh critical-path <project-id>
|
|
|
|
# Get dependency chain for a task
|
|
./gantt-api.sh dependencies <task-id>
|
|
```
|
|
|
|
## PDA-Friendly Language
|
|
|
|
When presenting information, use supportive, non-judgmental language:
|
|
- **"Target passed"** instead of "OVERDUE" or "LATE"
|
|
- **"Approaching target"** for near-deadline tasks
|
|
- **"Paused"** not "BLOCKED" or "STUCK"
|
|
- Focus on what's accomplished and what's next, not what's behind
|
|
|
|
## Implementation Notes
|
|
|
|
1. **Environment Setup**: Ensure `.env` has required variables:
|
|
- `MOSAIC_API_URL` - API base URL (e.g., `http://localhost:3000`, no `/api` suffix)
|
|
- `MOSAIC_WORKSPACE_ID` - Workspace UUID
|
|
- `MOSAIC_API_TOKEN` - Authentication token
|
|
|
|
2. **Error Handling**: API returns 401 for auth errors, 404 for not found
|
|
|
|
3. **Pagination**: Projects and tasks are paginated (default 50 items/page)
|
|
|
|
4. **Dependencies**: Task dependencies are stored in `metadata.dependencies` as array of task IDs
|
|
|
|
5. **Date Handling**: Start dates may be in `metadata.startDate` or fall back to `createdAt`
|