acuity-mcp-server 1.0.0

package/dist/tools/list-projects.d.ts

@@ -0,0 +1,200 @@
+/**
+ * MCP Tool: list_projects
+ * Lists all projects the user has access to with optional filtering
+ *
+ * Features:
+ * - Enum conversion: input strings → DB integers, DB integers → output strings
+ * - Hasura relationships: returns resolved names instead of IDs
+ * - Multiple filters: state, health_status, schedule_status, budget_status, etc.
+ */
+import type { HasuraClient } from '../clients/hasura-client.js';
+export type ProjectState = 'active' | 'hold' | 'completed' | 'cancelled' | 'pending';
+export type StoplightStatus = 'green' | 'yellow' | 'red' | 'gray';
+export type ProjectType = 'project' | 'proposal' | 'all';
+export interface ListProjectsInput {
+    project_type?: ProjectType;
+    state?: ProjectState | ProjectState[];
+    health_status?: StoplightStatus | StoplightStatus[];
+    schedule_status?: StoplightStatus | StoplightStatus[];
+    budget_status?: StoplightStatus | StoplightStatus[];
+    department_id?: number;
+    category_id?: number;
+    lifecycle_id?: number;
+    strategic_objective_id?: number;
+    portfolio_id?: number;
+    order_by?: 'rank' | 'updated_at' | 'name';
+    limit?: number;
+    offset?: number;
+}
+export interface ProjectListItem {
+    id: number;
+    name: string;
+    description: string | null;
+    project_type: 'project' | 'proposal';
+    state: ProjectState;
+    health_status: StoplightStatus | null;
+    schedule_status: StoplightStatus | null;
+    budget_status: StoplightStatus | null;
+    quality_status: StoplightStatus | null;
+    percent_complete: number;
+    start_date: string | null;
+    end_date: string | null;
+    value_priority_score: number | null;
+    risk_priority_score: number | null;
+    portfolio: {
+        id: number;
+        name: string;
+    } | null;
+    department: {
+        id: number;
+        name: string;
+    } | null;
+    category: {
+        id: number;
+        name: string;
+    } | null;
+    lifecycle: {
+        id: number;
+        name: string;
+    } | null;
+    strategic_objective: {
+        id: number;
+        name: string;
+    } | null;
+    project_manager: {
+        id: number;
+        name: string;
+    } | null;
+    open_risks_count: number;
+    closed_risks_count: number;
+    total_risks_count: number;
+    open_issues_count: number;
+    closed_issues_count: number;
+    total_issues_count: number;
+    open_benefits_count: number;
+    closed_benefits_count: number;
+    total_benefits_count: number;
+    total_lessons_count: number;
+}
+export interface ListProjectsResult {
+    projects: ProjectListItem[];
+    total_count: number;
+    has_more: boolean;
+    offset: number;
+}
+/**
+ * List projects handler
+ */
+export declare function listProjects(input: ListProjectsInput, hasuraClient: HasuraClient): Promise<ListProjectsResult>;
+export declare const listProjectsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_type: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            state: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            health_status: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            schedule_status: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            budget_status: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            department_id: {
+                type: string;
+                description: string;
+            };
+            category_id: {
+                type: string;
+                description: string;
+            };
+            lifecycle_id: {
+                type: string;
+                description: string;
+            };
+            strategic_objective_id: {
+                type: string;
+                description: string;
+            };
+            portfolio_id: {
+                type: string;
+                description: string;
+            };
+            order_by: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+//# sourceMappingURL=list-projects.d.ts.map

package/dist/tools/list-projects.d.ts.map

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

package/dist/tools/list-projects.js

@@ -0,0 +1,396 @@
+/**
+ * MCP Tool: list_projects
+ * Lists all projects the user has access to with optional filtering
+ *
+ * Features:
+ * - Enum conversion: input strings → DB integers, DB integers → output strings
+ * - Hasura relationships: returns resolved names instead of IDs
+ * - Multiple filters: state, health_status, schedule_status, budget_status, etc.
+ */
+// ============================================================================
+// Enum Mappings
+// ============================================================================
+/**
+ * Enum mappings: string → DB integer
+ * Verified against Rails models and frontend configs (see strategy-notes.md)
+ */
+const STATE_TO_DB = {
+    active: 0,
+    hold: 1,
+    completed: 2,
+    cancelled: 3,
+    pending: 4
+};
+const STOPLIGHT_TO_DB = {
+    green: 0,
+    yellow: 1,
+    red: 2,
+    gray: 3
+};
+// Special case: schedule_status and budget_status have different order!
+// yellow=0 (on schedule/budget), green=1 (ahead/under), red=2 (behind/over)
+const SCHEDULE_BUDGET_TO_DB = {
+    yellow: 0, // on schedule / on budget
+    green: 1, // ahead of schedule / under budget
+    red: 2, // behind schedule / over budget
+    gray: 3
+};
+/**
+ * Reverse mappings: DB integer → string
+ */
+const DB_TO_STATE = {
+    0: 'active',
+    1: 'hold',
+    2: 'completed',
+    3: 'cancelled',
+    4: 'pending'
+};
+const DB_TO_STOPLIGHT = {
+    0: 'green',
+    1: 'yellow',
+    2: 'red',
+    3: 'gray'
+};
+const DB_TO_SCHEDULE_BUDGET = {
+    0: 'yellow', // on schedule / on budget
+    1: 'green', // ahead / under
+    2: 'red', // behind / over
+    3: 'gray'
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Convert enum values to DB integers for WHERE clause
+ */
+function toDbValues(values, mapping) {
+    if (values === undefined)
+        return undefined;
+    const arr = Array.isArray(values) ? values : [values];
+    return arr.map(v => mapping[v]).filter(n => n !== undefined);
+}
+/**
+ * Convert a single DB integer to string
+ */
+function fromDbValue(value, mapping) {
+    if (value === null || value === undefined)
+        return null;
+    return mapping[value] ?? null;
+}
+/**
+ * Transform raw DB project to formatted output with resolved enums
+ */
+function transformProject(raw) {
+    return {
+        id: raw.id,
+        name: raw.name,
+        description: raw.description,
+        project_type: raw.project_type,
+        // Convert enums from integers to strings
+        state: fromDbValue(raw.state, DB_TO_STATE) ?? 'active',
+        health_status: fromDbValue(raw.health_status, DB_TO_STOPLIGHT),
+        schedule_status: fromDbValue(raw.schedule_status, DB_TO_SCHEDULE_BUDGET),
+        budget_status: fromDbValue(raw.budget_status, DB_TO_SCHEDULE_BUDGET),
+        quality_status: fromDbValue(raw.quality_status, DB_TO_STOPLIGHT),
+        percent_complete: raw.percent_complete ?? 0,
+        start_date: raw.start_date,
+        end_date: raw.end_date,
+        value_priority_score: raw.value_priority_score,
+        risk_priority_score: raw.risk_priority_score,
+        // Relationships are already resolved by Hasura
+        portfolio: raw.portfolio,
+        department: raw.department,
+        category: raw.category,
+        lifecycle: raw.lifecycle,
+        strategic_objective: raw.strategic_objective,
+        project_manager: raw.project_manager,
+        // Counts (default to 0)
+        open_risks_count: raw.open_risks_count ?? 0,
+        closed_risks_count: raw.closed_risks_count ?? 0,
+        total_risks_count: raw.total_risks_count ?? 0,
+        open_issues_count: raw.open_issues_count ?? 0,
+        closed_issues_count: raw.closed_issues_count ?? 0,
+        total_issues_count: raw.total_issues_count ?? 0,
+        open_benefits_count: raw.open_benefits_count ?? 0,
+        closed_benefits_count: raw.closed_benefits_count ?? 0,
+        total_benefits_count: raw.total_benefits_count ?? 0,
+        total_lessons_count: raw.total_lessons_count ?? 0
+    };
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+/**
+ * List projects handler
+ */
+export async function listProjects(input, hasuraClient) {
+    const { project_type = 'project', state, health_status, schedule_status, budget_status, department_id, category_id, lifecycle_id, strategic_objective_id, portfolio_id, order_by = 'updated_at', limit = 15, offset = 0 } = input;
+    // Build where conditions
+    const whereConditions = {};
+    // Filter by project_type (default: 'project', use 'all' to see both)
+    if (project_type !== 'all') {
+        whereConditions.project_type = { _eq: project_type };
+    }
+    // When sorting by rank, ONLY show active projects
+    // This matches frontend behavior where rank only applies to active projects
+    if (order_by === 'rank') {
+        whereConditions.state = { _eq: STATE_TO_DB.active };
+    }
+    else {
+        // Convert state filter
+        const stateValues = toDbValues(state, STATE_TO_DB);
+        if (stateValues && stateValues.length > 0) {
+            whereConditions.state = stateValues.length === 1
+                ? { _eq: stateValues[0] }
+                : { _in: stateValues };
+        }
+    }
+    // Convert stoplight filters
+    const healthValues = toDbValues(health_status, STOPLIGHT_TO_DB);
+    if (healthValues && healthValues.length > 0) {
+        whereConditions.health_status = healthValues.length === 1
+            ? { _eq: healthValues[0] }
+            : { _in: healthValues };
+    }
+    const scheduleValues = toDbValues(schedule_status, SCHEDULE_BUDGET_TO_DB);
+    if (scheduleValues && scheduleValues.length > 0) {
+        whereConditions.schedule_status = scheduleValues.length === 1
+            ? { _eq: scheduleValues[0] }
+            : { _in: scheduleValues };
+    }
+    const budgetValues = toDbValues(budget_status, SCHEDULE_BUDGET_TO_DB);
+    if (budgetValues && budgetValues.length > 0) {
+        whereConditions.budget_status = budgetValues.length === 1
+            ? { _eq: budgetValues[0] }
+            : { _in: budgetValues };
+    }
+    // ID filters
+    if (portfolio_id !== undefined) {
+        whereConditions.portfolio_id = { _eq: portfolio_id };
+    }
+    if (department_id !== undefined) {
+        whereConditions.department_id = { _eq: department_id };
+    }
+    if (category_id !== undefined) {
+        whereConditions.category_id = { _eq: category_id };
+    }
+    if (lifecycle_id !== undefined) {
+        whereConditions.lifecycle_id = { _eq: lifecycle_id };
+    }
+    if (strategic_objective_id !== undefined) {
+        whereConditions.strategic_objective_id = { _eq: strategic_objective_id };
+    }
+    // Build order_by clause
+    let orderByClause = '{ updated_at: desc }';
+    if (order_by === 'rank') {
+        // Sort by value_priority_score DESC, risk_priority_score ASC, id ASC
+        // This replicates frontend logic in prepareRankForProjects
+        orderByClause = '[{ value_priority_score: desc_nulls_last }, { risk_priority_score: asc_nulls_last }, { id: asc }]';
+    }
+    else if (order_by === 'name') {
+        orderByClause = '{ name: asc }';
+    }
+    // Build GraphQL query with relationships
+    const whereClause = JSON.stringify(whereConditions).replace(/"([^"]+)":/g, '$1:');
+    const query = `
+    query ListProjects($limit: Int!, $offset: Int!) {
+      projects(
+        where: ${whereClause},
+        order_by: ${orderByClause},
+        limit: $limit,
+        offset: $offset
+      ) {
+        id
+        name
+        description
+        project_type
+        state
+        health_status
+        schedule_status
+        budget_status
+        quality_status
+        percent_complete
+        start_date
+        end_date
+        value_priority_score
+        risk_priority_score
+
+        # Relationships - Hasura resolves automatically
+        portfolio { id name }
+        department { id name }
+        category { id name }
+        lifecycle { id name }
+        strategic_objective { id name }
+        project_manager { id name }
+
+        # Counts (cached on project)
+        open_risks_count
+        closed_risks_count
+        total_risks_count
+        open_issues_count
+        closed_issues_count
+        total_issues_count
+        open_benefits_count
+        closed_benefits_count
+        total_benefits_count
+        total_lessons_count
+      }
+
+      projects_aggregate(where: ${whereClause}) {
+        aggregate {
+          count
+        }
+      }
+    }
+  `;
+    const result = await hasuraClient.query(query, { limit, offset });
+    const totalCount = result.projects_aggregate.aggregate.count;
+    const transformedProjects = result.projects.map(transformProject);
+    return {
+        projects: transformedProjects,
+        total_count: totalCount,
+        has_more: offset + result.projects.length < totalCount,
+        offset
+    };
+}
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const listProjectsTool = {
+    name: 'list_projects',
+    description: `
+List projects OR proposals the user has access to with optional filtering.
+
+IMPORTANT: This tool handles BOTH projects and proposals. They are stored in the same table with different project_type values:
+- project_type: "project" (default) - Active/approved projects being executed
+- project_type: "proposal" - Project proposals awaiting approval
+- project_type: "all" - Both projects and proposals
+
+Returns summaries including:
+- Basic info (id, name, description, project_type, state)
+- Health indicators (health_status, schedule_status, budget_status, quality_status)
+- Progress (percent_complete) and dates (start_date, end_date)
+- Scoring (value_priority_score, risk_priority_score)
+- Relationships with NAMES resolved: portfolio, department, category, lifecycle, strategic_objective, project_manager
+- Counts: open_risks_count, closed_risks_count, total_risks_count, open_issues_count, closed_issues_count, total_issues_count, total_lessons_count
+
+PROJECT TYPE (default: "project"):
+- "project" - Only active/approved projects
+- "proposal" - Only proposals awaiting approval
+- "all" - Both projects and proposals
+
+FILTER VALUES:
+
+state: "active", "hold", "completed", "cancelled", "pending"
+  - Can pass single value or array: state: "active" OR state: ["active", "hold"]
+
+health_status / quality_status: "green", "yellow", "red", "gray"
+  - green = healthy/good
+  - yellow = caution/warning
+  - red = critical/problem
+  - gray = unknown/not set
+
+schedule_status: "yellow", "green", "red", "gray"
+  - yellow = on schedule
+  - green = ahead of schedule
+  - red = behind schedule
+
+budget_status: "yellow", "green", "red", "gray"
+  - yellow = on budget
+  - green = under budget
+  - red = over budget
+
+SORTING:
+- "updated_at" (default) - most recently updated first
+- "name" - alphabetical
+- "rank" - sorts by VALUE score (highest value_priority_score first, then lowest risk_priority_score, then id).
+  Only shows ACTIVE projects. Use for: "top ranked", "highest value", "best projects", "top 10 projects".
+  NOTE: The "rank" field in database is NOT used. Ranking is calculated from value_priority_score and risk_priority_score.
+
+EXAMPLES:
+- "Show all active projects" → state: "active"
+- "List all proposals" → project_type: "proposal"
+- "Show pending proposals" → project_type: "proposal", state: "pending"
+- "Projects at risk" → health_status: ["yellow", "red"]
+- "Behind schedule projects" → schedule_status: "red"
+- "Projects in Engineering department" → department_id: 5
+- "Top 10 ranked projects" → order_by: "rank", limit: 10
+- "All items (projects + proposals)" → project_type: "all"
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_type: {
+                type: 'string',
+                enum: ['project', 'proposal', 'all'],
+                description: 'Type of items to list. "project" = active projects (default), "proposal" = proposals awaiting approval, "all" = both',
+                default: 'project'
+            },
+            state: {
+                oneOf: [
+                    { type: 'string', enum: ['active', 'hold', 'completed', 'cancelled', 'pending'] },
+                    { type: 'array', items: { type: 'string', enum: ['active', 'hold', 'completed', 'cancelled', 'pending'] } }
+                ],
+                description: 'Filter by project state. Can be single value or array.'
+            },
+            health_status: {
+                oneOf: [
+                    { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] },
+                    { type: 'array', items: { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] } }
+                ],
+                description: 'Filter by health status (green=good, yellow=caution, red=critical)'
+            },
+            schedule_status: {
+                oneOf: [
+                    { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] },
+                    { type: 'array', items: { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] } }
+                ],
+                description: 'Filter by schedule status (yellow=on schedule, green=ahead, red=behind)'
+            },
+            budget_status: {
+                oneOf: [
+                    { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] },
+                    { type: 'array', items: { type: 'string', enum: ['green', 'yellow', 'red', 'gray'] } }
+                ],
+                description: 'Filter by budget status (yellow=on budget, green=under, red=over)'
+            },
+            department_id: {
+                type: 'number',
+                description: 'Filter by department ID'
+            },
+            category_id: {
+                type: 'number',
+                description: 'Filter by category ID'
+            },
+            lifecycle_id: {
+                type: 'number',
+                description: 'Filter by lifecycle ID'
+            },
+            strategic_objective_id: {
+                type: 'number',
+                description: 'Filter by strategic objective ID'
+            },
+            portfolio_id: {
+                type: 'number',
+                description: 'Filter by portfolio ID'
+            },
+            order_by: {
+                type: 'string',
+                enum: ['rank', 'updated_at', 'name'],
+                description: 'Sort order. "rank" = by value_priority_score (only active projects). Use "rank" for "top projects", "best ranked", "highest value".',
+                default: 'updated_at'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum projects to return (default: 15, max: 100)',
+                default: 15
+            },
+            offset: {
+                type: 'number',
+                description: 'Skip this many projects for pagination (default: 0)',
+                default: 0
+            }
+        }
+    }
+};
+//# sourceMappingURL=list-projects.js.map

package/dist/tools/list-projects.js.map

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