acuity-mcp-server 1.0.0

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

@@ -0,0 +1,134 @@
+/**
+ * MCP Tool: list_issues
+ * Lists all issues 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: status, priority, severity, project_id
+ */
+import type { HasuraClient } from '../clients/hasura-client.js';
+export type IssueStatus = 'open' | 'closed' | 'resolved';
+export type IssuePriority = 'very_low' | 'low' | 'medium' | 'high' | 'critical';
+export interface ListIssuesInput {
+    project_id?: number;
+    status?: IssueStatus | IssueStatus[];
+    priority?: IssuePriority | IssuePriority[];
+    severity?: number | number[];
+    order_by?: 'priority' | 'severity' | 'created_at' | 'updated_at' | 'resolution_date';
+    limit?: number;
+    offset?: number;
+}
+export interface IssueListItem {
+    id: number;
+    issue_id: number;
+    name: string;
+    description: string | null;
+    notes: string | null;
+    hyperlinks: string | null;
+    status: IssueStatus;
+    priority: IssuePriority;
+    severity: number;
+    areas_of_impact: string | null;
+    action_plan: string | null;
+    resolution: string | null;
+    resolution_date: string | null;
+    created_at: string;
+    updated_at: string;
+    project: {
+        id: number;
+        name: string;
+    } | null;
+    owner: {
+        id: number;
+        name: string;
+    } | null;
+}
+export interface ListIssuesResult {
+    issues: IssueListItem[];
+    total_count: number;
+    has_more: boolean;
+    offset: number;
+}
+/**
+ * List issues handler
+ */
+export declare function listIssues(input: ListIssuesInput, hasuraClient: HasuraClient): Promise<ListIssuesResult>;
+export declare const listIssuesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            status: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            priority: {
+                oneOf: ({
+                    type: string;
+                    enum: string[];
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    enum?: undefined;
+                })[];
+                description: string;
+            };
+            severity: {
+                oneOf: ({
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                    minimum?: undefined;
+                    maximum?: undefined;
+                })[];
+                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-issues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-issues.d.ts","sourceRoot":"","sources":["../../src/tools/list-issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IAGjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAG/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAGnB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiID;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAkH3B;AAMD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyF1B,CAAC"}

package/dist/tools/list-issues.js

@@ -0,0 +1,285 @@
+/**
+ * MCP Tool: list_issues
+ * Lists all issues 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: status, priority, severity, project_id
+ */
+// ============================================================================
+// Enum Mappings
+// ============================================================================
+/**
+ * Enum mappings: string → DB integer
+ * Verified against Rails model issue.rb
+ */
+const STATUS_TO_DB = {
+    open: 0,
+    closed: 1,
+    resolved: 2
+};
+const PRIORITY_TO_DB = {
+    very_low: 0,
+    low: 1,
+    medium: 2,
+    high: 3,
+    critical: 4
+};
+/**
+ * Reverse mappings: DB integer → string
+ */
+const DB_TO_STATUS = {
+    0: 'open',
+    1: 'closed',
+    2: 'resolved'
+};
+const DB_TO_PRIORITY = {
+    0: 'very_low',
+    1: 'low',
+    2: 'medium',
+    3: 'high',
+    4: 'critical'
+};
+// ============================================================================
+// 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 issue to formatted output with resolved enums
+ */
+function transformIssue(raw) {
+    return {
+        id: raw.id,
+        issue_id: raw.issue_id,
+        name: raw.name,
+        description: raw.description,
+        notes: raw.notes,
+        hyperlinks: raw.hyperlinks,
+        // Convert enums from integers to strings
+        status: fromDbValue(raw.status, DB_TO_STATUS) ?? 'open',
+        priority: fromDbValue(raw.priority, DB_TO_PRIORITY) ?? 'low',
+        severity: raw.severity ?? 1,
+        areas_of_impact: raw.areas_of_impact,
+        action_plan: raw.action_plan,
+        resolution: raw.resolution,
+        resolution_date: raw.resolution_date,
+        created_at: raw.created_at,
+        updated_at: raw.updated_at,
+        // Relationships - transform company_project_resource to owner
+        project: raw.project,
+        owner: raw.company_project_resource
+    };
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+/**
+ * List issues handler
+ */
+export async function listIssues(input, hasuraClient) {
+    const { project_id, status, priority, severity, order_by = 'created_at', limit = 20, offset = 0 } = input;
+    // Build where conditions
+    const whereConditions = {};
+    // Project filter
+    if (project_id !== undefined) {
+        whereConditions.project_id = { _eq: project_id };
+    }
+    // Status filter
+    const statusValues = toDbValues(status, STATUS_TO_DB);
+    if (statusValues && statusValues.length > 0) {
+        whereConditions.status = statusValues.length === 1
+            ? { _eq: statusValues[0] }
+            : { _in: statusValues };
+    }
+    // Priority filter
+    const priorityValues = toDbValues(priority, PRIORITY_TO_DB);
+    if (priorityValues && priorityValues.length > 0) {
+        whereConditions.priority = priorityValues.length === 1
+            ? { _eq: priorityValues[0] }
+            : { _in: priorityValues };
+    }
+    // Severity filter (integer, not enum)
+    if (severity !== undefined) {
+        const severityArr = Array.isArray(severity) ? severity : [severity];
+        if (severityArr.length === 1) {
+            whereConditions.severity = { _eq: severityArr[0] };
+        }
+        else if (severityArr.length > 1) {
+            whereConditions.severity = { _in: severityArr };
+        }
+    }
+    // Build order_by clause
+    let orderByClause = '{ created_at: desc }';
+    switch (order_by) {
+        case 'priority':
+            orderByClause = '{ priority: desc }';
+            break;
+        case 'severity':
+            orderByClause = '{ severity: desc_nulls_last }';
+            break;
+        case 'updated_at':
+            orderByClause = '{ updated_at: desc }';
+            break;
+        case 'resolution_date':
+            orderByClause = '{ resolution_date: desc_nulls_last }';
+            break;
+        // 'created_at' is default
+    }
+    // Build GraphQL query with relationships
+    const whereClause = JSON.stringify(whereConditions).replace(/"([^"]+)":/g, '$1:');
+    const query = `
+    query ListIssues($limit: Int!, $offset: Int!) {
+      issues(
+        where: ${whereClause},
+        order_by: ${orderByClause},
+        limit: $limit,
+        offset: $offset
+      ) {
+        id
+        issue_id
+        name
+        description
+        notes
+        hyperlinks
+        status
+        priority
+        severity
+        areas_of_impact
+        action_plan
+        resolution
+        resolution_date
+        created_at
+        updated_at
+
+        # Relationships - Hasura resolves automatically
+        project { id name }
+        company_project_resource { id name }
+      }
+
+      issues_aggregate(where: ${whereClause}) {
+        aggregate {
+          count
+        }
+      }
+    }
+  `;
+    const result = await hasuraClient.query(query, { limit, offset });
+    const totalCount = result.issues_aggregate.aggregate.count;
+    const transformedIssues = result.issues.map(transformIssue);
+    return {
+        issues: transformedIssues,
+        total_count: totalCount,
+        has_more: offset + result.issues.length < totalCount,
+        offset
+    };
+}
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const listIssuesTool = {
+    name: 'list_issues',
+    description: `
+List issues the user has access to with optional filtering.
+
+Returns issue information including:
+- Identifiers: id, issue_id (human-readable within company)
+- Content: name, description, notes, hyperlinks
+- Status & Classification: status, priority, severity (1-5 integer)
+- Action content: areas_of_impact, action_plan, resolution
+- Dates: created_at, updated_at, resolution_date
+- Relationships with NAMES: project, owner (the person responsible)
+
+FILTER VALUES:
+
+status: "open", "closed", "resolved"
+  - open = active issue being addressed
+  - closed = issue no longer relevant (not fixed)
+  - resolved = issue has been fixed/solved
+
+priority: "very_low", "low", "medium", "high", "critical"
+  - Indicates importance/urgency of addressing the issue
+
+severity: 1, 2, 3, 4, 5 (integer)
+  - 1 = minimal impact
+  - 5 = severe impact
+  - Note: This is an integer, not an enum like risks
+
+SORTING:
+- "created_at" (default) - newest first
+- "updated_at" - recently updated first
+- "priority" - highest priority first
+- "severity" - highest severity first
+- "resolution_date" - recently resolved first
+
+EXAMPLES:
+- "Show all open issues" → status: "open"
+- "High priority issues" → priority: ["high", "critical"]
+- "Issues for project 123" → project_id: 123
+- "Severe issues (severity 4-5)" → severity: [4, 5]
+- "Top 10 highest priority issues" → order_by: "priority", limit: 10
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'number',
+                description: 'Filter by project ID'
+            },
+            status: {
+                oneOf: [
+                    { type: 'string', enum: ['open', 'closed', 'resolved'] },
+                    { type: 'array', items: { type: 'string', enum: ['open', 'closed', 'resolved'] } }
+                ],
+                description: 'Filter by issue status. Can be single value or array.'
+            },
+            priority: {
+                oneOf: [
+                    { type: 'string', enum: ['very_low', 'low', 'medium', 'high', 'critical'] },
+                    { type: 'array', items: { type: 'string', enum: ['very_low', 'low', 'medium', 'high', 'critical'] } }
+                ],
+                description: 'Filter by priority level'
+            },
+            severity: {
+                oneOf: [
+                    { type: 'number', minimum: 1, maximum: 5 },
+                    { type: 'array', items: { type: 'number', minimum: 1, maximum: 5 } }
+                ],
+                description: 'Filter by severity (1-5 integer). Can be single value or array.'
+            },
+            order_by: {
+                type: 'string',
+                enum: ['priority', 'severity', 'created_at', 'updated_at', 'resolution_date'],
+                description: 'Sort order',
+                default: 'created_at'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum issues to return (default: 20, max: 100)',
+                default: 20
+            },
+            offset: {
+                type: 'number',
+                description: 'Skip this many issues for pagination (default: 0)',
+                default: 0
+            }
+        }
+    }
+};
+//# sourceMappingURL=list-issues.js.map

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

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

package/dist/tools/list-lessons-learned.d.ts

@@ -0,0 +1,79 @@
+/**
+ * MCP Tool: list_lessons_learned
+ * Lists all lessons learned the user has access to with optional filtering
+ *
+ * Features:
+ * - Hasura relationships: returns resolved names instead of IDs
+ * - Filter by project_id or project_phase_id
+ */
+import type { HasuraClient } from '../clients/hasura-client.js';
+export interface ListLessonsLearnedInput {
+    project_id?: number;
+    project_phase_id?: number;
+    order_by?: 'created_at' | 'updated_at';
+    limit?: number;
+    offset?: number;
+}
+export interface LessonLearnedListItem {
+    id: number;
+    lesson_id: number;
+    description: string | null;
+    lesson_learned: string | null;
+    impact: string | null;
+    recommendation: string | null;
+    identified_by: string | null;
+    created_at: string;
+    updated_at: string;
+    project: {
+        id: number;
+        name: string;
+    } | null;
+    lifecycle: {
+        id: number;
+        name: string;
+    } | null;
+}
+export interface ListLessonsLearnedResult {
+    lessons_learned: LessonLearnedListItem[];
+    total_count: number;
+    has_more: boolean;
+    offset: number;
+}
+/**
+ * List lessons learned handler
+ */
+export declare function listLessonsLearned(input: ListLessonsLearnedInput, hasuraClient: HasuraClient): Promise<ListLessonsLearnedResult>;
+export declare const listLessonsLearnedTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            project_phase_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-lessons-learned.d.ts.map

package/dist/tools/list-lessons-learned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-lessons-learned.d.ts","sourceRoot":"","sources":["../../src/tools/list-lessons-learned.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAGnB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAuDD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAwEnC;AAMD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDlC,CAAC"}

package/dist/tools/list-lessons-learned.js

@@ -0,0 +1,155 @@
+/**
+ * MCP Tool: list_lessons_learned
+ * Lists all lessons learned the user has access to with optional filtering
+ *
+ * Features:
+ * - Hasura relationships: returns resolved names instead of IDs
+ * - Filter by project_id or project_phase_id
+ */
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Transform raw DB lesson to formatted output
+ */
+function transformLesson(raw) {
+    return {
+        id: raw.id,
+        lesson_id: raw.lesson_id,
+        description: raw.description,
+        lesson_learned: raw.lesson_learned,
+        impact: raw.impact,
+        recommendation: raw.recommendation,
+        identified_by: raw.identified_by,
+        created_at: raw.created_at,
+        updated_at: raw.updated_at,
+        // Relationships - already resolved by Hasura
+        project: raw.project,
+        lifecycle: raw.lifecycle
+    };
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+/**
+ * List lessons learned handler
+ */
+export async function listLessonsLearned(input, hasuraClient) {
+    const { project_id, project_phase_id, order_by = 'created_at', limit = 20, offset = 0 } = input;
+    // Build where conditions
+    const whereConditions = {};
+    // Project filter
+    if (project_id !== undefined) {
+        whereConditions.project_id = { _eq: project_id };
+    }
+    // Project phase (lifecycle) filter
+    if (project_phase_id !== undefined) {
+        whereConditions.project_phase_id = { _eq: project_phase_id };
+    }
+    // Build order_by clause
+    const orderByClause = order_by === 'updated_at'
+        ? '{ updated_at: desc }'
+        : '{ created_at: desc }';
+    // Build GraphQL query with relationships
+    const whereClause = JSON.stringify(whereConditions).replace(/"([^"]+)":/g, '$1:');
+    const query = `
+    query ListLessonsLearned($limit: Int!, $offset: Int!) {
+      project_learned_lessons(
+        where: ${whereClause},
+        order_by: ${orderByClause},
+        limit: $limit,
+        offset: $offset
+      ) {
+        id
+        lesson_id
+        description
+        lesson_learned
+        impact
+        recommendation
+        identified_by
+        created_at
+        updated_at
+
+        # Relationships - Hasura resolves automatically
+        project { id name }
+        lifecycle { id name }
+      }
+
+      project_learned_lessons_aggregate(where: ${whereClause}) {
+        aggregate {
+          count
+        }
+      }
+    }
+  `;
+    const result = await hasuraClient.query(query, { limit, offset });
+    const totalCount = result.project_learned_lessons_aggregate.aggregate.count;
+    const transformedLessons = result.project_learned_lessons.map(transformLesson);
+    return {
+        lessons_learned: transformedLessons,
+        total_count: totalCount,
+        has_more: offset + result.project_learned_lessons.length < totalCount,
+        offset
+    };
+}
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const listLessonsLearnedTool = {
+    name: 'list_lessons_learned',
+    description: `
+List lessons learned the user has access to with optional filtering.
+
+Returns lessons learned information including:
+- Identifiers: id, lesson_id (human-readable within company)
+- Content: description, lesson_learned (main content), impact, recommendation
+- Who identified: identified_by (text field with person's name)
+- Dates: created_at, updated_at
+- Relationships with NAMES: project, lifecycle (project phase when lesson was learned)
+
+CONTENT FIELDS:
+- description: Brief summary of the situation
+- lesson_learned: The main lesson/insight gained
+- impact: What impact this had on the project
+- recommendation: Suggested actions for future projects
+
+SORTING:
+- "created_at" (default) - newest first
+- "updated_at" - recently updated first
+
+EXAMPLES:
+- "Show all lessons learned" → (no filters)
+- "Lessons for project 123" → project_id: 123
+- "Lessons from Planning phase" → project_phase_id: 1 (need lifecycle ID)
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'number',
+                description: 'Filter by project ID'
+            },
+            project_phase_id: {
+                type: 'number',
+                description: 'Filter by project phase/lifecycle ID'
+            },
+            order_by: {
+                type: 'string',
+                enum: ['created_at', 'updated_at'],
+                description: 'Sort order',
+                default: 'created_at'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum lessons to return (default: 20, max: 100)',
+                default: 20
+            },
+            offset: {
+                type: 'number',
+                description: 'Skip this many lessons for pagination (default: 0)',
+                default: 0
+            }
+        }
+    }
+};
+//# sourceMappingURL=list-lessons-learned.js.map

package/dist/tools/list-lessons-learned.js.map

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