stack/packages/skills/gantt/SKILL.md

---
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`