acuity-mcp-server 1.0.0

package/dist/tools/get-risk.js

@@ -0,0 +1,173 @@
+/**
+ * MCP Tool: get_risk
+ * Returns full details for a single risk by ID
+ *
+ * Features:
+ * - Enum conversion: DB integers → human-readable strings
+ * - Hasura relationships: returns resolved names instead of IDs
+ */
+// ============================================================================
+// Enum Mappings
+// ============================================================================
+const DB_TO_STATUS = {
+    0: 'open',
+    1: 'closed',
+    2: 'realized'
+};
+const DB_TO_PRIORITY = {
+    0: 'very_low',
+    1: 'low',
+    2: 'medium',
+    3: 'high',
+    4: 'critical'
+};
+const DB_TO_RISK_RESPONSE = {
+    0: 'mitigate',
+    1: 'accept',
+    2: 'avoid',
+    3: 'watch',
+    4: 'transfer'
+};
+const DB_TO_SEVERITY = {
+    0: 'very_low',
+    1: 'low',
+    2: 'medium',
+    3: 'high',
+    4: 'very_high'
+};
+const DB_TO_LIKELIHOOD = {
+    0: 'very_low',
+    1: 'low',
+    2: 'medium',
+    3: 'high',
+    4: 'very_high'
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function fromDbValue(value, mapping) {
+    if (value === null || value === undefined)
+        return null;
+    return mapping[value] ?? null;
+}
+function transformRisk(raw) {
+    return {
+        id: raw.id,
+        risk_id: raw.risk_id,
+        name: raw.name,
+        description: raw.description,
+        notes: raw.notes,
+        hyperlinks: raw.hyperlinks,
+        status: fromDbValue(raw.status, DB_TO_STATUS) ?? 'open',
+        priority: fromDbValue(raw.priority, DB_TO_PRIORITY) ?? 'low',
+        severity: fromDbValue(raw.severity, DB_TO_SEVERITY) ?? 'very_low',
+        likelihood: fromDbValue(raw.likelihood, DB_TO_LIKELIHOOD) ?? 'very_low',
+        risk_response: fromDbValue(raw.risk_response, DB_TO_RISK_RESPONSE) ?? 'mitigate',
+        impact_score: raw.impact_score ?? 0,
+        response_plan: raw.response_plan,
+        created_at: raw.created_at,
+        updated_at: raw.updated_at,
+        project: raw.project,
+        owner: raw.company_project_resource
+    };
+}
+// ============================================================================
+// GraphQL Query
+// ============================================================================
+const GET_RISK_QUERY = `
+  query GetRisk($where: risks_bool_exp!) {
+    risks(where: $where, limit: 1) {
+      id
+      risk_id
+      name
+      description
+      notes
+      hyperlinks
+      status
+      priority
+      severity
+      likelihood
+      risk_response
+      impact_score
+      response_plan
+      created_at
+      updated_at
+
+      project { id name }
+      company_project_resource { id name }
+    }
+  }
+`;
+// ============================================================================
+// Main Handler
+// ============================================================================
+export async function getRisk(input, hasuraClient) {
+    const { risk_id, risk_number } = input;
+    // Validate input
+    if (risk_id === undefined && risk_number === undefined) {
+        return { risk: null };
+    }
+    // Build where clause
+    let whereClause;
+    if (risk_id !== undefined) {
+        whereClause = { id: { _eq: risk_id } };
+    }
+    else {
+        whereClause = { risk_id: { _eq: risk_number } };
+    }
+    const result = await hasuraClient.query(GET_RISK_QUERY, {
+        where: whereClause
+    });
+    if (!result.risks || result.risks.length === 0) {
+        return { risk: null };
+    }
+    return {
+        risk: transformRisk(result.risks[0])
+    };
+}
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const getRiskTool = {
+    name: 'get_risk',
+    description: `
+Get full details for a single risk by ID.
+
+Returns all risk information including:
+- Identifiers: id (database), risk_id (human-readable number within company)
+- Content: name, description, notes, hyperlinks, response_plan
+- Classification: status, priority, severity, likelihood, risk_response
+- Scoring: impact_score (severity × likelihood, range 1-25)
+- Dates: created_at, updated_at
+- Relationships: project { id, name }, owner { id, name }
+
+SEARCH OPTIONS (provide one):
+- risk_id: Database primary key (integer)
+- risk_number: Human-readable risk number within company (e.g., 42)
+
+ENUM VALUES:
+- status: "open", "closed", "realized"
+- priority: "very_low", "low", "medium", "high", "critical"
+- severity: "very_low", "low", "medium", "high", "very_high"
+- likelihood: "very_low", "low", "medium", "high", "very_high"
+- risk_response: "mitigate", "accept", "avoid", "watch", "transfer"
+
+EXAMPLES:
+- Get by database ID: risk_id: 123
+- Get by risk number: risk_number: 42
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            risk_id: {
+                type: 'number',
+                description: 'Risk database ID (primary key)'
+            },
+            risk_number: {
+                type: 'number',
+                description: 'Human-readable risk number within company'
+            }
+        }
+    }
+};
+//# sourceMappingURL=get-risk.js.map

package/dist/tools/get-risk.js.map

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

package/dist/tools/get-status-reports.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP Tool: get_status_reports
+ * Get status reports with optional filtering by project
+ */
+import type { HasuraClient } from '../clients/hasura-client.js';
+export interface GetStatusReportsInput {
+    project_id?: number;
+    project_name?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Get status reports handler
+ */
+export declare function getStatusReports(input: GetStatusReportsInput, hasuraClient: HasuraClient): Promise<string>;
+/**
+ * MCP tool definition for get_status_reports
+ */
+export declare const getStatusReportsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+            project_name: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+//# sourceMappingURL=get-status-reports.d.ts.map

package/dist/tools/get-status-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-status-reports.d.ts","sourceRoot":"","sources":["../../src/tools/get-status-reports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsGD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDhC,CAAC"}

package/dist/tools/get-status-reports.js

@@ -0,0 +1,151 @@
+/**
+ * MCP Tool: get_status_reports
+ * Get status reports with optional filtering by project
+ */
+import { formatDate, divider } from '../utils/formatters.js';
+/**
+ * Build GraphQL query for status reports
+ */
+function buildStatusReportsQuery(projectId, projectName) {
+    let whereConditions = '';
+    if (projectId) {
+        whereConditions = `where: { project_id: { _eq: ${projectId} } }`;
+    }
+    else if (projectName) {
+        // Case-insensitive search by project name
+        whereConditions = `where: { project: { name: { _ilike: "%${projectName}%" } } }`;
+    }
+    return `
+    query GetStatusReports($limit: Int!, $offset: Int!) {
+      status_reports(
+        ${whereConditions}
+        order_by: { created_at: desc }
+        limit: $limit
+        offset: $offset
+      ) {
+        id
+        summary
+        accomplishments
+        look_ahead
+        help_needed
+        created_at
+        updated_at
+        project {
+          id
+          name
+        }
+        user {
+          name
+          email
+        }
+      }
+
+      status_reports_aggregate(
+        ${whereConditions}
+      ) {
+        aggregate {
+          count
+        }
+      }
+    }
+  `;
+}
+/**
+ * Format status reports for display
+ */
+function formatStatusReports(reports, totalCount, hasMore) {
+    if (reports.length === 0) {
+        return 'No status reports found.';
+    }
+    const header = `Found ${totalCount} status report${totalCount !== 1 ? 's' : ''} total. Showing ${reports.length}.`;
+    const formatted = reports.map((report, idx) => {
+        return `
+${divider()}
+STATUS REPORT #${idx + 1} (ID: ${report.id})
+${divider()}
+
+Project: ${report.project.name} (ID: ${report.project.id})
+Reported by: ${report.user?.name || 'Unknown'} ${report.user?.email ? `(${report.user.email})` : ''}
+Date: ${formatDate(report.created_at)}
+Last Updated: ${formatDate(report.updated_at)}
+
+SUMMARY:
+${report.summary || 'No summary provided'}
+
+${report.accomplishments ? `ACCOMPLISHMENTS:\n${report.accomplishments}\n` : ''}
+${report.look_ahead ? `LOOKING AHEAD:\n${report.look_ahead}\n` : ''}
+${report.help_needed ? `HELP NEEDED:\n${report.help_needed}\n` : ''}
+    `.trim();
+    }).join('\n\n');
+    return `${header}\n\n${formatted}${hasMore ? '\n\n...(more reports available, use offset to see next page)' : ''}`;
+}
+/**
+ * Get status reports handler
+ */
+export async function getStatusReports(input, hasuraClient) {
+    const { project_id, project_name, limit = 10, offset = 0 } = input;
+    // Build and execute GraphQL query
+    const query = buildStatusReportsQuery(project_id, project_name);
+    const result = await hasuraClient.query(query, {
+        limit,
+        offset
+    });
+    const totalCount = result.status_reports_aggregate.aggregate.count;
+    const hasMore = offset + result.status_reports.length < totalCount;
+    return formatStatusReports(result.status_reports, totalCount, hasMore);
+}
+/**
+ * MCP tool definition for get_status_reports
+ */
+export const getStatusReportsTool = {
+    name: 'get_status_reports',
+    description: `
+Get status reports with optional filtering by project ID or project name.
+
+Returns detailed status report information:
+- Summary of the report
+- Accomplishments
+- Looking ahead
+- Help needed
+- Project information (ID and name)
+- Reporter information (name and email)
+- Dates (created and updated)
+
+Use this tool when users ask:
+- "Show me all status reports"
+- "Get status reports for project #123"
+- "Show me status reports for project Auto Scrap"
+- "What are the latest status updates?"
+- "Show me recent status reports for [project name]"
+
+You can filter by:
+- project_id: Exact project ID (e.g., 123)
+- project_name: Project name (case-insensitive, partial match, e.g., "Auto Scrap")
+
+If no filters provided, returns all accessible status reports.
+  `.trim(),
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'number',
+                description: 'Filter by specific project ID'
+            },
+            project_name: {
+                type: 'string',
+                description: 'Filter by project name (case-insensitive, partial match)'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of reports to return (default: 10)',
+                default: 10
+            },
+            offset: {
+                type: 'number',
+                description: 'Number of reports to skip for pagination (default: 0)',
+                default: 0
+            }
+        }
+    }
+};
+//# sourceMappingURL=get-status-reports.js.map

package/dist/tools/get-status-reports.js.map

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

package/dist/tools/init-auth.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Authentication initialization tool
+ * Allows users to authenticate via Claude by triggering Device Flow
+ */
+export declare const initAuthTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+export declare const logoutTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+export declare const authStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+/**
+ * Login - Two-phase Device Flow
+ *
+ * Phase 1: Request device code, show to user, open browser
+ * Phase 2: Poll for token completion when user calls again
+ */
+export declare function initAuth(): Promise<string>;
+/**
+ * Handle logout - clears credentials and pending auth
+ */
+export declare function logout(): Promise<string>;
+/**
+ * Check auth status
+ */
+export declare function getAuthStatus(): Promise<string>;
+//# sourceMappingURL=init-auth.d.ts.map

package/dist/tools/init-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-auth.d.ts","sourceRoot":"","sources":["../../src/tools/init-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,eAAO,MAAM,YAAY;;;;;;;;CAQxB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;CAQ1B,CAAC;AAYF;;;;;GAKG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CA2DhD;AA2ED;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAS9C;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAuCrD"}

package/dist/tools/init-auth.js

@@ -0,0 +1,213 @@
+/**
+ * Authentication initialization tool
+ * Allows users to authenticate via Claude by triggering Device Flow
+ */
+import open from 'open';
+import { requestDeviceCode, pollForToken } from '../auth/device-flow.js';
+import { saveCredentials, loadCredentials, clearCredentials, tokenResponseToCredentials, savePendingDeviceCode, loadPendingDeviceCode, clearPendingDeviceCode, } from '../auth/token-storage.js';
+import { getEnvironment } from '../config/environments.js';
+export const initAuthTool = {
+    name: 'acuity_login',
+    description: 'Login to Acuity. Opens a browser for secure login. Wait for the login to complete.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+export const logoutTool = {
+    name: 'acuity_logout',
+    description: 'Logout from Acuity and clear stored credentials.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+export const authStatusTool = {
+    name: 'acuity_auth_status',
+    description: 'Check current Acuity authentication status.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+function getAuth0Config() {
+    const env = getEnvironment();
+    return {
+        domain: env.auth0Domain,
+        clientId: env.auth0ClientId,
+        audience: process.env.AUTH0_AUDIENCE,
+        scope: 'openid profile email offline_access',
+    };
+}
+/**
+ * Login - Two-phase Device Flow
+ *
+ * Phase 1: Request device code, show to user, open browser
+ * Phase 2: Poll for token completion when user calls again
+ */
+export async function initAuth() {
+    try {
+        // Check if already authenticated
+        const existingCreds = await loadCredentials();
+        if (existingCreds) {
+            const now = Math.floor(Date.now() / 1000);
+            if (existingCreds.expiresAt > now) {
+                return `Already authenticated as ${existingCreds.email || 'unknown user'}. Use acuity_logout first if you want to re-authenticate.`;
+            }
+        }
+        const config = getAuth0Config();
+        // Check if there's a pending device code (Phase 2)
+        const pending = await loadPendingDeviceCode();
+        if (pending) {
+            return await completePendingAuth(config, pending);
+        }
+        // Phase 1: Request new device code
+        const deviceCodeResponse = await requestDeviceCode(config);
+        // Save pending device code for Phase 2
+        const now = Math.floor(Date.now() / 1000);
+        const pendingCode = {
+            deviceCode: deviceCodeResponse.device_code,
+            userCode: deviceCodeResponse.user_code,
+            verificationUri: deviceCodeResponse.verification_uri,
+            interval: deviceCodeResponse.interval,
+            expiresAt: now + deviceCodeResponse.expires_in,
+        };
+        await savePendingDeviceCode(pendingCode);
+        // Open browser - logout from Auth0 first to force fresh login
+        const returnUrl = `https://${config.domain}/activate?user_code=${deviceCodeResponse.user_code}`;
+        const logoutUrl = `https://${config.domain}/v2/logout?client_id=${config.clientId}&returnTo=${encodeURIComponent(returnUrl)}`;
+        try {
+            await open(logoutUrl);
+        }
+        catch {
+            // Browser didn't open, will show manual instructions
+        }
+        // Return immediately with the code - user will call again after completing login
+        return `🔐 **Verification Code: ${deviceCodeResponse.user_code}**
+
+A browser window is opening for login.
+
+**Please verify this code matches what you see in the browser before confirming!**
+
+After you complete the login in your browser, say **"continue login"** or call this tool again to complete authentication.
+
+_Code expires in ${Math.floor(deviceCodeResponse.expires_in / 60)} minutes._`;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        await clearPendingDeviceCode(); // Clean up on error
+        return `❌ Login failed: ${message}. Please try again.`;
+    }
+}
+/**
+ * Complete pending authentication (Phase 2)
+ */
+async function completePendingAuth(config, pending) {
+    try {
+        console.error(`[Auth] Checking pending authorization for code: ${pending.userCode}`);
+        const now = Math.floor(Date.now() / 1000);
+        const remainingTime = pending.expiresAt - now;
+        // Poll for token
+        const token = await pollForToken(config, pending.deviceCode, pending.interval, remainingTime, () => { } // No progress callback needed in MCP context
+        );
+        // Clear pending code
+        await clearPendingDeviceCode();
+        // Extract email from id_token
+        let email;
+        if (token.id_token) {
+            try {
+                const payload = JSON.parse(Buffer.from(token.id_token.split('.')[1], 'base64').toString());
+                email = payload.email || payload['https://acuity.com/email'] || payload['https://acuityppm.com/email'];
+            }
+            catch {
+                // Ignore parsing errors
+            }
+        }
+        // Save credentials
+        const credentials = tokenResponseToCredentials(token, email);
+        await saveCredentials(credentials);
+        const env = getEnvironment();
+        return `✅ **Login Successful!**
+
+Environment: ${env.name}
+Logged in as: ${email || 'unknown user'}
+
+You can now use Acuity tools:
+- "Show me my projects"
+- "List active projects"
+- "Get status reports"`;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // Check if it's "authorization pending" - user hasn't completed yet
+        if (message.includes('authorization_pending') || message.includes('Authorization timed out')) {
+            const remaining = Math.floor((pending.expiresAt - Math.floor(Date.now() / 1000)) / 60);
+            if (remaining > 0) {
+                return `⏳ **Waiting for login...**
+
+Your verification code: **${pending.userCode}**
+
+Please complete the login in your browser, then call this tool again.
+
+_Code expires in ${remaining} minutes._`;
+            }
+        }
+        // Real error or expired - clean up
+        await clearPendingDeviceCode();
+        return `❌ Login failed: ${message}. Please try again.`;
+    }
+}
+/**
+ * Handle logout - clears credentials and pending auth
+ */
+export async function logout() {
+    const deletedCreds = await clearCredentials();
+    const deletedPending = await clearPendingDeviceCode();
+    if (deletedCreds || deletedPending) {
+        return '✅ Successfully logged out. Credentials removed from system keychain.';
+    }
+    else {
+        return 'No credentials found. You are not logged in.';
+    }
+}
+/**
+ * Check auth status
+ */
+export async function getAuthStatus() {
+    // Check for pending auth first
+    const pending = await loadPendingDeviceCode();
+    if (pending) {
+        const now = Math.floor(Date.now() / 1000);
+        const remaining = Math.floor((pending.expiresAt - now) / 60);
+        return `⏳ **Login in progress...**
+
+Your verification code: **${pending.userCode}**
+
+Complete the login in your browser, then say "continue login".
+
+_Code expires in ${remaining} minutes._`;
+    }
+    const creds = await loadCredentials();
+    if (!creds) {
+        return '❌ Not authenticated. Use "login to Acuity" to authenticate.';
+    }
+    const now = Math.floor(Date.now() / 1000);
+    const isExpired = creds.expiresAt <= now;
+    const expiresIn = creds.expiresAt - now;
+    if (isExpired) {
+        return `⚠️ Authentication expired for ${creds.email || 'unknown user'}. Use "login to Acuity" to re-authenticate.`;
+    }
+    const minutes = Math.floor(expiresIn / 60);
+    const refreshStatus = creds.refreshToken ? '✅ Auto-refresh enabled' : '⚠️ No refresh token';
+    const env = getEnvironment();
+    return `✅ **Authenticated**
+
+Environment: ${env.name}
+User: ${creds.email || 'unknown user'}
+Token expires in: ${minutes} minutes
+${refreshStatus}`;
+}
+//# sourceMappingURL=init-auth.js.map

package/dist/tools/init-auth.js.map

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