@critical-path/mcp 0.18.1 → 0.20.0

package/dist/tools/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../src/tools/outputs.ts"],"names":[],"mappings":"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"}

package/dist/tools/outputs.js

@@ -0,0 +1,190 @@
+import { z } from 'zod';
+/**
+ * Output schemas for the MCP tools. They describe the top-level shape of each result so agents
+ * know which fields they can read and pass to the next tool. Every object is `passthrough()`:
+ * the schema documents the important fields without rejecting the others the engine returns.
+ */
+const obj = (shape) => z.object(shape).passthrough();
+/** Optional fields may be absent or null depending on the backend. */
+const opt = (schema) => schema.nullable().optional();
+const anyObject = z.object({}).passthrough();
+export const ProjectOutput = obj({
+    id: z.string().describe('Project id; pass as projectId to other tools'),
+    name: z.string(),
+    key: opt(z.string()).describe('Short prefix, e.g. "PROJ"'),
+    description: opt(z.string())
+}).describe('A project');
+export const TaskOutput = obj({
+    id: z.string().describe('Task id; pass as id or taskId to other tools'),
+    projectId: z.string(),
+    title: z.string(),
+    status: z.string().describe('Workflow status key'),
+    priority: z.string().describe('urgent, high, medium, low or none'),
+    assigneeId: opt(z.string()),
+    dueDate: opt(z.string()),
+    deadline: opt(z.string()).describe('Latest acceptable finish, enforced by critical path analysis'),
+    isMilestone: opt(z.boolean()).describe('A zero-duration checkpoint'),
+    estimatedHours: opt(z.number()),
+    loggedHours: opt(z.number()),
+    isBlocked: opt(z.boolean())
+}).describe('A task');
+const DependencyLinkOutput = obj({
+    dependencyId: z.string().describe('Id of the dependency record'),
+    taskId: z.string().describe('The other task'),
+    title: z.string(),
+    status: z.string(),
+    type: z.string().describe("'blocking' (the waiting task cannot start until the other finishes) or 'relates_to' (informational)")
+});
+export const TaskWithDependenciesOutput = TaskOutput.extend({
+    dependencies: opt(obj({
+        dependsOn: z.array(DependencyLinkOutput).describe('Tasks this task waits for (upstream)'),
+        dependents: z.array(DependencyLinkOutput).describe('Tasks waiting for this task (downstream)')
+    })).describe('Present when includeDependencies is true')
+}).describe('A task');
+export const DependencyOutput = obj({
+    id: z.string(),
+    taskId: z.string().describe('The task that waits'),
+    dependsOnTaskId: z.string().describe('The task it waits for'),
+    type: z.string().describe('blocking or relates_to')
+}).describe('A dependency between two tasks');
+export const DeliverableOutput = obj({
+    id: z.string(),
+    projectId: z.string(),
+    title: z.string(),
+    dueDate: opt(z.string())
+}).describe('A deliverable');
+export const CommentOutput = obj({
+    id: z.string(),
+    taskId: z.string(),
+    content: z.string(),
+    authorId: opt(z.string())
+}).describe('A task comment');
+const OverallocationOutput = obj({
+    assigneeId: opt(z.string()),
+    teamId: opt(z.string()),
+    capacity: z.number().describe('1 for a person, headcount for a team pool'),
+    allocation: z.number().describe('Total booked in the period, e.g. 1.5 for 150%'),
+    start: z.string(),
+    end: z.string(),
+    taskIds: z.array(z.string())
+});
+const TaskScheduleOutput = obj({
+    taskId: z.string(),
+    isCritical: z.boolean().describe('True when any delay to this task delays the project end'),
+    totalSlack: z.number().describe('Slack in hours; 0 means critical, negative means a deadline is missed by that much'),
+    slackWorkingHours: opt(z.number()).describe('Slack in working hours on the task calendar'),
+    earlyStartDate: opt(z.string()),
+    earlyFinishDate: opt(z.string()),
+    lateStartDate: opt(z.string()),
+    lateFinishDate: opt(z.string()),
+    levelingDelayHours: opt(z.number()).describe('With levelling: hours spent waiting for the assignee'),
+    waitingOn: opt(z.string()).describe('With levelling: the task this one waited for'),
+    isMilestone: opt(z.boolean()).describe('True for a milestone'),
+    deadlineDate: opt(z.string()).describe("The task's deadline as an instant"),
+    deadlineVarianceHours: opt(z.number()).describe('Working hours from forecast finish to deadline; negative means it will be missed')
+});
+export const CriticalPathOutput = obj({
+    projectId: z.string(),
+    projectStartDate: opt(z.string()),
+    projectEndDate: opt(z.string()).describe('Forecast finish date'),
+    totalDurationHours: z.number(),
+    criticalTaskIds: z.array(z.string()).describe('Tasks with zero or negative slack, in schedule order'),
+    missedDeadlineTaskIds: opt(z.array(z.string())).describe('Tasks forecast to finish after their deadline'),
+    tasks: z.array(TaskScheduleOutput),
+    leveled: opt(z.boolean()),
+    unleveledProjectEndDate: opt(z.string()).describe('With levelling: the end date before levelling'),
+    overallocations: opt(z.array(OverallocationOutput)).describe('Assignee mode: periods where someone is booked above capacity')
+});
+export const PortfolioCriticalPathOutput = obj({
+    projects: z.array(CriticalPathOutput).describe('One analysis per project'),
+    projectEndDate: opt(z.string()).describe('The latest project end'),
+    leveled: opt(z.boolean()),
+    overallocations: z.array(OverallocationOutput)
+});
+const PhaseOutput = obj({
+    id: z.string(),
+    type: z.string().describe('container, iteration, deliverable or phase'),
+    name: z.string(),
+    health: z.string().describe('on_track, at_risk, blocked, overdue or completed'),
+    progressPercentage: z.number().describe('0-100'),
+    isCritical: z.boolean(),
+    blockedTasks: z.number(),
+    taskIds: z.array(z.string())
+});
+export const TimelineLadderOutput = obj({
+    projectId: z.string(),
+    level: z.string(),
+    macro: opt(obj({
+        health: z.string().describe('on_track, at_risk, blocked, overdue or completed'),
+        overallProgressPercentage: z.number().describe('0-100'),
+        projectedFinishDate: opt(z.string()),
+        totalTasks: z.number(),
+        completedTasks: z.number(),
+        blockedTasks: z.number(),
+        phases: z.array(PhaseOutput)
+    })).describe('Phase-level summary'),
+    standard: opt(anyObject).describe('Task timeline: { tasks, criticalPathTaskIds, dependencies, totalDurationHours }'),
+    concrete: opt(z.record(anyObject)).describe('Work evidence (time entries, attachments) by task id')
+});
+export const TaskLadderOutput = obj({
+    taskId: z.string(),
+    macroPhase: opt(PhaseOutput).describe('The phase this task belongs to'),
+    standard: anyObject.describe('The task with cpm (isCritical, slackWorkingHours, dates), blockingTaskIds and dependentTaskIds'),
+    concrete: anyObject.describe('Evidence of work on the task'),
+    metrics: opt(anyObject).describe('Same as get_task_metrics')
+});
+export const TaskProgressHistoryOutput = obj({
+    taskId: z.string(),
+    points: z.array(obj({ timestamp: z.string(), progress: z.number().describe('0-100'), status: z.string() })),
+    curveProfile: z.string().describe('linear, s_curve, early_surge, late_rush, stalled or insufficient_data')
+});
+export const TaskMetricsOutput = obj({
+    taskId: z.string(),
+    progress: obj({
+        progressPercentage: z.number().describe('0-100'),
+        source: z.string().describe('Where the figure comes from: explicit, todos, time_effort, schedule_elapsed or blended')
+    }),
+    realityDelta: obj({
+        estimatedHours: z.number(),
+        loggedHours: z.number(),
+        varianceHours: z.number().describe('logged minus estimated'),
+        isOverdue: z.boolean(),
+        isOverEstimate: z.boolean(),
+        scheduleVarianceWorkingDays: opt(z.number()).describe('Working days late (positive) or early (negative)')
+    }),
+    evm: obj({
+        plannedValue: z.number(),
+        earnedValue: z.number(),
+        actualCost: z.number(),
+        costPerformanceIndex: z.number().describe('CPI = EV / AC; below 1 is over budget'),
+        schedulePerformanceIndex: z.number().describe('SPI = EV / PV; below 1 is behind schedule')
+    }),
+    inferredActuals: anyObject.describe('Actual start/end dates and active working time'),
+    progressHistory: TaskProgressHistoryOutput
+});
+export const WorkloadDistributionOutput = obj({
+    startDate: z.string(),
+    endDate: z.string(),
+    interval: z.string(),
+    groupBy: z.string(),
+    metric: z.string(),
+    seriesKeys: z.array(z.string()).describe('Ids of the people, teams, etc. in the series'),
+    seriesLabels: z.record(z.string()).describe('Display name for each series key'),
+    buckets: z.array(obj({
+        date: z.string().describe('Start of the bucket (YYYY-MM-DD)'),
+        totalHours: z.number(),
+        values: z.record(z.number()).describe('Hours per series key'),
+        capacity: opt(z.record(z.number())).describe('Capacity hours per series key'),
+        utilizationRatio: opt(z.number()).describe('totalHours / totalCapacity; above 1 is overloaded')
+    })),
+    totalHours: z.number(),
+    totalCapacity: opt(z.number()),
+    averageUtilization: opt(z.number())
+});
+export const SkillOutput = obj({
+    skills: opt(z.array(obj({ name: z.string(), description: z.string() }))).describe('Present when no name was given'),
+    name: opt(z.string()),
+    description: opt(z.string()),
+    content: opt(z.string()).describe('The playbook (markdown); follow its steps')
+});
+//# sourceMappingURL=outputs.js.map

package/dist/tools/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../../src/tools/outputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,MAAM,GAAG,GAAG,CAA0B,KAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACjF,sEAAsE;AACtE,MAAM,GAAG,GAAG,CAAyB,MAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AAChF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC1D,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAEzB,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAClG,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAC5B,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAEtB,MAAM,oBAAoB,GAAG,GAAG,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qGAAqG,CAAC;CACjI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1D,YAAY,EAAE,GAAG,CACf,GAAG,CAAC;QACF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACzF,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KAC/F,CAAC,CACH,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACvD,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAEtB,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CACpD,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACzB,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAE7B,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAE9B,MAAM,oBAAoB,GAAG,GAAG,CAAC;IAC/B,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAChF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,GAAG,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAC3F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IACrH,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC1F,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACpG,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACnF,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC9D,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC3E,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kFAAkF,CAAC;CACpI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACrG,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACzG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAClC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACzB,uBAAuB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAClG,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CAC9H,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC1E,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACzB,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,GAAG,CAAC;IACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC/E,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,GAAG,CACR,GAAG,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC/E,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvD,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;KAC7B,CAAC,CACH,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,iFAAiF,CAAC;IACpH,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CACpG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACvE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,gGAAgG,CAAC;IAC9H,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC5D,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3G,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;CAC3G,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,GAAG,CAAC;QACZ,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;KACtH,CAAC;IACF,YAAY,EAAE,GAAG,CAAC;QAChB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;QACtB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;QAC3B,2BAA2B,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;KAC1G,CAAC;IACF,GAAG,EAAE,GAAG,CAAC;QACP,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAClF,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KAC3F,CAAC;IACF,eAAe,EAAE,SAAS,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACrF,eAAe,EAAE,yBAAyB;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/E,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,GAAG,CAAC;QACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC7D,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC7E,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KAChG,CAAC,CACH;IACD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACnH,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC/E,CAAC,CAAC"}

package/dist/web/index.d.ts

@@ -1,12 +1,18 @@
 import type { CriticalPathClient } from '@critical-path/client';
+import { type ToolsetName } from '../tools/definitions.js';
+export { TOOLSETS, type ToolsetName } from '../tools/definitions.js';
+export { SKILLS, getSkill, type Skill } from '../skills/index.js';
 export interface WebMcpToolRegistration {
     name: string;
     title?: string;
     description: string;
     inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
     annotations?: {
         readOnlyHint?: boolean;
         destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
     };
     execute: (input: any) => Promise<any>;
 }
@@ -21,7 +27,12 @@ export interface ModelContextInterface {
 export interface RegisterWebMcpOptions {
     client: CriticalPathClient;
     projectId?: string;
+    /** Exact tool names to expose. Combined with `toolsets`; unknown names throw. */
     tools?: string[];
+    /** Tool groups to expose (`core`, `collaboration`, `scheduling`, `analytics`, `guidance`). Default: all. */
+    toolsets?: ToolsetName[];
+    /** Expose only tools that change nothing. */
+    readOnly?: boolean;
     signal?: AbortSignal;
     document?: any;
     navigator?: any;
@@ -31,6 +42,11 @@ export interface RegisterWebMcpOptions {
 export interface WebMcpRegistryHandle {
     unregister: () => void;
     getRegisteredTools: () => WebMcpToolRegistration[];
+    /**
+     * Orientation for the agent: data model, id flow, which tool to use and the available skills.
+     * WebMCP has no standard channel for it, so add it to your copilot's system prompt.
+     */
+    instructions: string;
 }
 /**
  * Polyfill/shim a minimal ModelContextInterface onto the document/window if not natively present.

package/dist/web/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzG,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,GAAG,sBAAsB,EAAE,CAAC;IAC9E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,sBAAsB,EAAE,CAAC;CACpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,GAAuD,GAAG,qBAAqB,GAAG,IAAI,CAkCjI;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CA0FxF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAA6C,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtG,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzG,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,GAAG,sBAAsB,EAAE,CAAC;IAC9E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,sBAAsB,EAAE,CAAC;IACnD;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,GAAuD,GAAG,qBAAqB,GAAG,IAAI,CAkCjI;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAwFxF"}

package/dist/web/index.js

@@ -1,4 +1,7 @@
-import { ALL_TOOLS, parseToolArgs } from '../tools/definitions.js';
+import { selectTools, runTool } from '../tools/definitions.js';
+import { buildAgentInstructions } from '../tools/instructions.js';
+export { TOOLSETS } from '../tools/definitions.js';
+export { SKILLS, getSkill } from '../skills/index.js';
 /**
  * Polyfill/shim a minimal ModelContextInterface onto the document/window if not natively present.
  */
@@ -52,15 +55,14 @@ export function registerWebMcpTools(options) {
     else if (doc) {
         modelContext = ensureModelContextShim(doc) ?? undefined;
     }
-    const selectedTools = options.tools
-        ? ALL_TOOLS.filter((t) => options.tools.includes(t.name))
-        : ALL_TOOLS;
+    const selectedTools = selectTools({ tools: options.tools, toolsets: options.toolsets, readOnly: options.readOnly });
+    const instructions = buildAgentInstructions(selectedTools, { projectId: options.projectId });
     const registeredTools = [];
     const abortController = new AbortController();
     // Combine caller signal with our internal abort controller. An already-aborted signal
     // registers nothing (the component unmounted before registration).
     if (options.signal?.aborted) {
-        return { unregister: () => { }, getRegisteredTools: () => [] };
+        return { unregister: () => { }, getRegisteredTools: () => [], instructions };
     }
     if (options.signal) {
         options.signal.addEventListener('abort', () => abortController.abort(), { once: true });
@@ -71,14 +73,11 @@ export function registerWebMcpTools(options) {
             title: toolDef.title,
             description: toolDef.description,
             inputSchema: toolDef.inputSchema,
-            // Standard MCP annotations (as the stdio server sends them), not the internal flags
-            annotations: {
-                readOnlyHint: toolDef.annotations?.readOnlyHint ?? false,
-                destructiveHint: toolDef.annotations?.requiresConfirmation ?? false
-            },
+            outputSchema: toolDef.outputSchema,
+            annotations: { ...toolDef.annotations },
             execute: async (input) => {
                 const ambientContext = options.projectId ? { projectId: options.projectId } : undefined;
-                const result = await toolDef.execute(parseToolArgs(toolDef, input), options.client, ambientContext);
+                const result = await runTool(toolDef, input, options.client, ambientContext);
                 options.onToolExecuted?.(toolDef.name, input, result);
                 return result;
             }
@@ -97,6 +96,7 @@ export function registerWebMcpTools(options) {
     if (win) {
         win.__CRITICAL_PATH_WEBMCP__ = {
             projectId: options.projectId,
+            instructions,
             tools: registeredTools,
             execute: async (name, input) => {
                 const tool = registeredTools.find((t) => t.name === name);
@@ -119,7 +119,8 @@ export function registerWebMcpTools(options) {
     };
     return {
         unregister,
-        getRegisteredTools: () => registeredTools
+        getRegisteredTools: () => registeredTools,
+        instructions
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@critical-path/mcp",
-  "version": "0.18.1",
-  "description": "Standard Model Context Protocol (MCP) server and client-side WebMCP support for Critical Path",
+  "version": "0.20.0",
+  "description": "Model Context Protocol (MCP) server, client-side WebMCP tools and agent skills for Critical Path",
   "author": "Jack James",
   "license": "MIT",
   "repository": {
@@ -29,17 +29,19 @@
     "./web": {
       "types": "./dist/web/index.d.ts",
       "import": "./dist/web/index.js"
-    }
+    },
+    "./skills/*": "./skills/*"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.1",
     "zod": "^3.24.0",
     "zod-to-json-schema": "^3.25.2",
-    "@critical-path/client": "0.25.1",
-    "@critical-path/core": "0.51.1"
+    "@critical-path/client": "0.25.2",
+    "@critical-path/core": "0.52.0"
   },
   "devDependencies": {
-    "@types/node": "^24.0.0",
+    "@anthropic-ai/sdk": "^0.137.0",
+    "@types/node": "^26.6.5",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   },
@@ -48,12 +50,15 @@
   },
   "files": [
     "dist",
+    "skills",
     "CHANGELOG.md",
     "!dist/**/*.test.*"
   ],
   "scripts": {
-    "build": "tsc --build",
+    "build": "node scripts/generate-skills.mjs && tsc --build",
     "test": "vitest run",
-    "clean": "rm -rf dist *.tsbuildinfo"
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "generate:skills": "node scripts/generate-skills.mjs",
+    "eval:tools": "node evals/tool-selection.mjs"
   }
 }

package/skills/analyze-schedule/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: analyze-schedule
+description: Find what drives a project's end date, how much each task can slip and where people are double-booked, then recommend fixes. Use for "when will we finish?", "what is critical?" or deadline-risk questions.
+---
+
+# Analyze the schedule
+
+## 1. Run the schedule
+
+1. Get the `projectId` (`list_projects`).
+2. Call `calculate_critical_path` with `calendars: "assignee"` and `levelResources: true`, so each person works on one task at a time on their own calendar. If the user wants the ideal schedule with unlimited people, call it with no options instead.
+3. If the question spans projects that share people, call `calculate_portfolio_critical_path` with their `projectIds` (and `projectOrder` if the user ranked them) instead.
+4. For in-flight projects, pass `effort: "remaining"` so finished hours are not scheduled again.
+
+## 2. Read the result
+
+- `projectEndDate` is the forecast finish. With levelling, compare it with `unleveledProjectEndDate`: the gap is time lost waiting for busy people.
+- `criticalTaskIds` are the tasks with zero or negative slack. Any delay to one of them moves the end date or misses a deadline.
+- `missedDeadlineTaskIds` lists tasks forecast to finish after their `deadline`. Their `deadlineVarianceHours` says by how much (negative working hours), and the negative `totalSlack` on the tasks before them shows which work drives the miss. Entries with `isMilestone: true` are checkpoints such as releases or sign-offs.
+- Each entry in `tasks` has `slackWorkingHours`: how many working hours the task can slip without moving the end. Under about 8 hours is near-critical.
+- `levelingDelayHours` and `waitingOn` show a task that waited for its assignee to finish another task.
+- `overallocations` lists periods where a person (`assigneeId`) or team (`teamId`) is booked above `capacity`; `allocation` 1.5 means 150%.
+
+Look up titles for the task ids you mention with `get_task` or `list_tasks`; report titles, not ids. To see why a critical task cannot start earlier, call `get_task` with `includeDependencies: true`: `dependencies.dependsOn` lists what it waits for and `dependencies.dependents` what waits for it.
+
+## 3. Recommend
+
+Rank fixes by how much they pull the end date in:
+
+1. **Unblock critical tasks.** A critical task with `isBlocked: true` delays everything; say what it waits for.
+2. **Move work off the bottleneck person.** If critical tasks wait on one assignee (`waitingOn`), suggest reassigning a non-critical task of theirs.
+3. **Remove false dependencies.** A critical task waiting on work it does not really need (`dependencies.dependsOn`) can start earlier once the link is removed.
+4. **Split long critical tasks** so parts can run in parallel.
+5. **Cut or defer** tasks feeding late deliverables, if dates are fixed.
+
+Show the recommendation to the user. Change tasks (`update_task`) or dependencies (`add_dependency`, `remove_dependency`) only when they ask, then run the schedule again to show the effect.
+
+## Report format
+
+- Forecast finish date, and against any deadline the user gave. If the user gives a date that is not yet on a task, offer to record it as a `deadline` (on a milestone task with `isMilestone: true` if it is a checkpoint) so later runs track it.
+- Each milestone: forecast date against its deadline.
+- Critical path: task titles in order, with assignee.
+- Top risks: near-critical tasks, blocked critical tasks, over-allocations.
+- Recommended actions, each with its expected effect.

package/skills/investigate-task/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: investigate-task
+description: Work out why a specific task is late, stalled or over budget and what it puts at risk. Use when the user asks about one task's status, delay or overrun.
+---
+
+# Investigate a task
+
+## 1. Identify the task
+
+If the user named the task rather than giving its id, find it with `list_tasks` (filter by project, assignee or status) and confirm which one they mean if several match.
+
+## 2. Gather evidence
+
+1. `get_task` with `includeDependencies: true`: status, assignee, estimate, logged hours, due date, `isBlocked` and `blockedReason`, plus the tasks it waits for (`dependencies.dependsOn`, with their status) and the tasks waiting on it (`dependencies.dependents`).
+2. `get_task_metrics`: progress and variance.
+3. `get_task_ladder`: its phase (`macroPhase`) and that phase's health, and its schedule in `standard.cpm` (`isCritical`, `slackWorkingHours`).
+4. `list_comments`: what people said about it, especially recent blockers or decisions.
+
+## 3. Diagnose
+
+Check these in order and stop at the ones that explain the problem:
+
+| Signal | Meaning |
+| --- | --- |
+| `isBlocked` true, an unfinished task in `dependencies.dependsOn`, or comments mention waiting | Blocked. Name what it waits for and its status; investigate that task the same way if it is late too. |
+| `progressHistory.curveProfile` is `stalled` | No progress recently. Check whether the assignee moved to other work. |
+| `realityDelta.isOverEstimate` true or `evm.costPerformanceIndex` below 0.9 | Taking more effort than estimated. The estimate was too low or scope grew. |
+| `evm.schedulePerformanceIndex` below 0.9 or `realityDelta.isOverdue` | Behind schedule. Give `scheduleVarianceWorkingDays`. |
+| No `estimatedHours` | Metrics cannot be trusted; say so and suggest adding an estimate. |
+| `curveProfile` is `late_rush` | Most progress lands near the deadline; the remaining work may be underestimated. |
+
+## 4. Assess the impact
+
+- If the task is critical (`standard.cpm.isCritical`), every day it slips moves the project end. Say so plainly.
+- List the tasks waiting on it (`dependencies.dependents`, by title); they slip with it.
+- Otherwise, report how much slack it has left before it becomes critical.
+- Name the phase or deliverable it endangers.
+
+## 5. Answer
+
+Lead with a one-sentence diagnosis, then the evidence (with numbers), the impact, and one to three concrete next steps (unblock, re-estimate, reassign, split). Change the task with `update_task` or record the finding with `add_comment` only if the user asks.

package/skills/plan-capacity/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: plan-capacity
+description: Check who is overloaded or idle over a time window and rebalance assignments. Use for capacity planning, workload balancing or "can we take on more work?" questions.
+---
+
+# Plan capacity
+
+## 1. Measure the load
+
+1. Decide the window and grain with the user, defaulting to the next 8 weeks by `interval: "week"`.
+2. Call `get_workload_distribution` with `groupBy: "assignee"`, `metric: "remaining"`, `startDate` and `endDate` (YYYY-MM-DD). Pass `projectId` for one project, or omit it for the whole workspace (people usually work across projects). Use `groupBy: "team"` for team-level questions.
+3. If people do not work 40-hour weeks, pass `defaultWeeklyCapacityHours`.
+
+## 2. Read it
+
+- `seriesKeys` are the people (or teams); `seriesLabels` maps each to a display name.
+- In each bucket, `values[key]` is booked hours and `capacity[key]` is available hours. Load = values / capacity.
+- `utilizationRatio` above 1 is overloaded for the bucket as a whole; check each person too, since one overloaded person hides inside a team average.
+- Treat above 1.0 as overloaded, 0.8-1.0 as full, below 0.5 as spare capacity.
+- Work with no assignee (or team) appears under the key `unassigned`; it is demand nobody has picked up.
+
+## 3. Find what to move
+
+1. For each overloaded person and week, call `list_tasks` with their `assigneeId` to see the tasks behind it.
+2. Call `calculate_critical_path` (with `calendars: "assignee"`) for the affected project to learn which of those tasks are critical. Move non-critical tasks first; they have slack.
+3. Match each task with a person who has spare capacity in that window.
+
+## 4. Propose
+
+Give a table: task, from, to, hours moved, effect on both people's load. Note the remaining overload if it cannot be fully resolved, and the options (push dates, add people, cut scope).
+
+Apply reassignments with `update_task` (`assigneeId`) only after the user approves, and record each one with `add_comment`.

package/skills/plan-project/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: plan-project
+description: Turn a goal, brief or feature list into a Critical Path project with deliverables, estimated and prioritized tasks, and the dependencies between them. Use when the user asks to plan, scope or break down work.
+---
+
+# Plan a project
+
+Turn a goal into deliverables (dated outcomes), tasks (estimated units of work) and dependencies (which task waits for which) the scheduler can use.
+
+## 1. Find or create the project
+
+1. Call `list_projects`. If a project already matches the goal, use it and read it with `get_project` to learn its workflow status keys and custom fields.
+2. Only if none fits, and the user wants a new one, call `create_project` with a `name` and a short `key`.
+3. Call `list_tasks` with the `projectId` and `list_deliverables` to see what already exists. Do not recreate it.
+
+## 2. Draft the plan before writing anything
+
+Break the goal down in your reply first and show it to the user:
+
+- **Deliverables**: 2-6 outcomes someone could accept or reject, each with a due date if the user gave one.
+- **Milestones** for dated checkpoints (a release, a sign-off, a review): a task with `isMilestone: true`, a `deadline` if the date is fixed, and dependencies on the tasks that must finish first. The schedule then reports whether each date will be met.
+- **Tasks** under each deliverable. Each task:
+  - starts with a verb and is small enough for one person (about 2-24 hours);
+  - has `estimatedHours` (effort, not elapsed time);
+  - has a `priority`: `urgent` only for work that blocks others now, `high` for the critical outcome, `medium` by default, `low` for nice-to-haves;
+  - lists the tasks it must wait for (its dependencies). Only add a dependency when the work truly cannot start earlier; every extra one lengthens the schedule.
+- Note anything you assumed (team size, dates, scope) as a question.
+
+Ask the user to confirm or adjust before creating anything. A plan is cheap to change in chat and tedious to change once created.
+
+## 3. Create it
+
+1. Create tasks with `create_task` (`projectId`, `title`, `description` with acceptance criteria, `estimatedHours`, `priority`, `assigneeId` if known). Leave `status` out so tasks start in the workflow's default status.
+2. Create each deliverable with `create_deliverable`, passing the ids of its tasks in `taskIds`.
+3. Add each dependency from your plan with `add_dependency`: `taskId` is the task that waits, `dependsOnTaskId` the task that must finish first. Use the ids `create_task` returned. If one is refused as circular, your plan has a loop: fix the order with the user instead of retrying.
+4. If the project already had tasks, check what they wait for with `get_task` and `includeDependencies: true` before linking new work to them.
+
+## 4. Check the result
+
+1. Call `calculate_critical_path` for the project and report the forecast `projectEndDate` and the `criticalTaskIds` (by title). If every task is critical or the end date looks too early, a dependency is probably missing or reversed.
+2. If the end date misses a deliverable's due date, or `missedDeadlineTaskIds` is not empty, say so and suggest what to cut, split or reassign. The `analyze-schedule` skill covers this in depth.
+
+## Guardrails
+
+- Never invent user ids for `assigneeId`. Leave tasks unassigned unless the user named the person and you have their id.
+- Keep the plan to what the user asked for; propose extra work as suggestions, not tasks.

package/skills/report-status/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: report-status
+description: Write a project status report covering progress, phase health, forecast finish, risks and blockers, backed by the schedule and metrics. Use when the user asks how a project is going or wants a status update.
+---
+
+# Report project status
+
+## 1. Collect the facts
+
+1. Get the `projectId` (`list_projects`).
+2. Call `get_timeline_ladder` with `level: "macro"`. It gives overall `health`, `overallProgressPercentage`, `projectedFinishDate`, task counts and `phases`, each with its own `health`, `progressPercentage` and `isCritical`.
+3. Call `calculate_critical_path` (with `effort: "remaining"`) for the forecast `projectEndDate` and the `criticalTaskIds`.
+4. Call `list_tasks` for blocked and urgent work: once with `priority: "urgent"` and scan the results (and the project's tasks) for `isBlocked: true`.
+5. For each phase that is `at_risk`, `blocked` or `overdue`, pick its most important open tasks (critical ones first) and call `get_task_metrics` on up to 5 of them.
+6. Call `list_deliverables` and compare each due date with the forecast.
+
+## 2. Interpret
+
+- Phase `health`: `on_track`, `at_risk`, `blocked`, `overdue` or `completed`.
+- Task `evm`: `schedulePerformanceIndex` (SPI) below 0.9 means behind schedule; `costPerformanceIndex` (CPI) below 0.9 means more hours than the progress justifies.
+- `realityDelta.isOverdue` and `scheduleVarianceWorkingDays` give lateness in working days.
+- `progressHistory.curveProfile`: `stalled` needs attention now; `late_rush` suggests hidden risk near the due date.
+
+## 3. Write the report
+
+Keep it short and lead with the answer.
+
+```
+**Status: <On track | At risk | Off track>**, <progress>% done, forecast finish <date> (<deadline comparison>).
+
+**Phases**
+- <phase>: <health>, <progress>%  <one-line reason if not on track>
+
+**Risks and blockers**
+- <task title> (<assignee>): <what is wrong, with the number>, <what would fix it>
+
+**Deliverables**
+- <title>: due <date>, forecast <on time | late by N days>
+
+**Next steps**
+- <owner>: <action>
+```
+
+Use task titles, not ids. Name a number for every claim (dates, percentages, hours). If data is missing (no estimates, no logged hours), say so: metrics without estimates are not meaningful.
+
+Only post the report with `add_comment` if the user asks.