@fruition/fcp-mcp-server 1.1.0 → 1.3.0

package/README.md

@@ -1,6 +1,6 @@
 # FCP MCP Server
 
-MCP (Model Context Protocol) server that gives Claude Code direct access to the FCP Launch Coordination System.
+MCP (Model Context Protocol) server that gives Claude Code direct access to the FCP Launch Coordination System. Also includes automatic time tracking integration with Unroo.
 
 ## Features
 
@@ -149,3 +149,76 @@ To get an API token for the MCP server:
 ### Tools not appearing
 - Restart Claude Code after updating settings
 - Check Claude Code logs for MCP server errors
+
+---
+
+## Time Tracking with Unroo
+
+This package also includes `unroo-heartbeat`, a script that automatically tracks your Claude Code development time in Unroo.
+
+### Quick Setup
+
+After installing the package globally (`npm install -g @fruition/fcp-mcp-server`), configure time tracking:
+
+#### 1. Set your Unroo API key
+
+Add to `~/.bashrc` or `~/.zshrc`:
+
+```bash
+export UNROO_API_KEY="mcp_XXXXXX_your_key_here"
+```
+
+Get your API key from Unroo: Settings → API Keys → Create with "Time Tracking" enabled.
+
+#### 2. Configure Claude Code hooks
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "unroo-heartbeat"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "unroo-heartbeat session_end"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+#### 3. Restart Claude Code
+
+Time tracking is now active. Sessions are automatically mapped to the correct Unroo project based on:
+1. `.unroo` file in project root (if present)
+2. Saved repo→project mappings (learned from previous sessions)
+3. Smart matching by repo name to Jira project key
+
+### Project Configuration (Optional)
+
+For repos that don't auto-match, create a `.unroo` file:
+
+```bash
+echo "project_slug=YOUR_JIRA_KEY" > .unroo
+```
+
+The system learns from this and saves the mapping permanently, so you only need to do this once per repo.
+
+### Viewing Time
+
+Log in to [Unroo](https://chat.frugpt.com) and check My Day or Timesheet to see your tracked sessions.

package/bin/unroo-heartbeat.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+# ============================================================================
+# UNROO CLAUDE CODE HEARTBEAT SCRIPT
+# ============================================================================
+# Sends heartbeat signals to UnRoo time tracker API
+# Called by Claude Code hooks on tool use events
+#
+# Usage:
+#   unroo-heartbeat.sh [event_type]
+#
+# Event types:
+#   tool_end (default) - After tool completes
+#   session_end - When Claude Code session ends
+#   heartbeat - Periodic heartbeat from watcher
+#
+# Environment variables:
+#   UNROO_API_KEY - Required: Your UnRoo API key with time tracking enabled
+#   UNROO_API_ENDPOINT - Optional: API base URL (default: https://chat.frugpt.com)
+#   TOOL_NAME - Optional: Name of the tool that was used
+#   TOOL_DESCRIPTION - Optional: Description of what the tool did
+#
+# Project Configuration:
+#   Create a .unroo file in your project root with:
+#     project_slug=YOUR_PROJECT_SLUG
+#   This maps time to the correct Unroo project (optional - auto-matching works for most repos).
+#
+# Installation:
+#   npm install -g @fruition/fcp-mcp-server
+#   Then set UNROO_API_KEY in your shell profile and configure Claude Code hooks.
+# ============================================================================
+
+# Configuration
+EVENT_TYPE="${1:-tool_end}"
+API_ENDPOINT="${UNROO_API_ENDPOINT:-https://chat.frugpt.com}"
+API_URL="${API_ENDPOINT}/api/unroo/claude-tracker/heartbeat"
+
+# Check for API key
+if [ -z "$UNROO_API_KEY" ]; then
+  # Silently exit if no API key - don't block Claude Code
+  exit 0
+fi
+
+# Get git remote URL (if in a git repo)
+GIT_REMOTE=""
+if git rev-parse --git-dir > /dev/null 2>&1; then
+  GIT_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
+fi
+
+# Get repo name from current directory
+REPO_NAME=$(basename "$(pwd)")
+
+# Check for project-specific config (.unroo file)
+PROJECT_SLUG=""
+if [ -f ".unroo" ]; then
+  PROJECT_SLUG=$(grep -E "^project_slug=" .unroo 2>/dev/null | cut -d= -f2)
+fi
+
+# Get machine ID (for multi-machine tracking)
+MACHINE_ID=""
+if [ -f /etc/machine-id ]; then
+  MACHINE_ID=$(cat /etc/machine-id | head -c 8)
+elif command -v hostid &> /dev/null; then
+  MACHINE_ID=$(hostid)
+fi
+
+# Build JSON payload
+JSON_PAYLOAD=$(cat <<EOF
+{
+  "api_key": "${UNROO_API_KEY}",
+  "event_type": "${EVENT_TYPE}",
+  "source": "claude-code",
+  "git_remote_url": "${GIT_REMOTE}",
+  "repo_name": "${REPO_NAME}",
+  "machine_id": "${MACHINE_ID}",
+  "tool_name": "${TOOL_NAME:-}",
+  "tool_description": "${TOOL_DESCRIPTION:-}",
+  "project_slug": "${PROJECT_SLUG:-}"
+}
+EOF
+)
+
+# Send heartbeat in background to not block Claude Code
+# Redirect all output to /dev/null to avoid any terminal output
+curl -s -X POST "$API_URL" \
+  -H "Content-Type: application/json" \
+  -d "$JSON_PAYLOAD" \
+  > /dev/null 2>&1 &
+
+# Exit immediately - don't wait for curl
+exit 0

package/dist/index.js

@@ -10,10 +10,33 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Get version from package.json
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJsonPath = join(__dirname, '..', 'package.json');
+let MCP_SERVER_VERSION = '1.0.0'; // fallback
+try {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    MCP_SERVER_VERSION = packageJson.version;
+}
+catch {
+    // Try one level up (for dist folder)
+    try {
+        const altPath = join(__dirname, '..', '..', 'package.json');
+        const packageJson = JSON.parse(readFileSync(altPath, 'utf-8'));
+        MCP_SERVER_VERSION = packageJson.version;
+    }
+    catch {
+        console.error('[MCP Server] Warning: Could not read package.json version');
+    }
+}
 // Configuration
 const FCP_API_URL = process.env.FCP_API_URL || 'https://fcp.fru.io';
 const FCP_API_TOKEN = process.env.FCP_API_TOKEN || '';
-const UNROO_API_URL = process.env.UNROO_API_URL || 'https://frugpt.fruition.net';
+const UNROO_API_URL = process.env.UNROO_API_URL || 'https://chat.frugpt.com';
 const UNROO_API_KEY = process.env.UNROO_API_KEY || '';
 // API Client
 class FCPClient {
@@ -283,7 +306,7 @@ class SessionTracker {
 // Create server
 const server = new Server({
     name: 'fcp-mcp-server',
-    version: '1.0.0',
+    version: MCP_SERVER_VERSION,
 }, {
     capabilities: {
         tools: {},
@@ -990,11 +1013,60 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     }
     throw new Error(`Unknown resource: ${uri}`);
 });
+// Version comparison helper
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+        const p1 = parts1[i] || 0;
+        const p2 = parts2[i] || 0;
+        if (p1 > p2)
+            return 1;
+        if (p1 < p2)
+            return -1;
+    }
+    return 0;
+}
+// Check for updates on startup
+async function checkForUpdates() {
+    if (!FCP_API_URL)
+        return;
+    try {
+        const response = await fetch(`${FCP_API_URL}/api/mcp/version`, {
+            headers: FCP_API_TOKEN ? { 'X-API-Key': FCP_API_TOKEN } : {},
+        });
+        if (!response.ok) {
+            // Silently ignore - version endpoint may not exist on older FCP versions
+            return;
+        }
+        const data = await response.json();
+        const latestVersion = data.version;
+        const minVersion = data.minVersion;
+        if (compareVersions(MCP_SERVER_VERSION, minVersion) < 0) {
+            console.error(`\n⚠️  [MCP Server] INCOMPATIBLE VERSION`);
+            console.error(`   Your version: ${MCP_SERVER_VERSION}`);
+            console.error(`   Minimum required: ${minVersion}`);
+            console.error(`   Please update: ${data.updateUrl}\n`);
+        }
+        else if (compareVersions(MCP_SERVER_VERSION, latestVersion) < 0) {
+            console.error(`\n📦 [MCP Server] Update available: ${MCP_SERVER_VERSION} → ${latestVersion}`);
+            console.error(`   Update: ${data.updateUrl}\n`);
+        }
+        else {
+            console.error(`[MCP Server] Version ${MCP_SERVER_VERSION} (up to date)`);
+        }
+    }
+    catch {
+        // Silently ignore network errors - don't block startup
+    }
+}
 // Start server
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('FCP MCP Server running on stdio');
+    console.error(`FCP MCP Server v${MCP_SERVER_VERSION} running on stdio`);
+    // Check for updates (non-blocking)
+    checkForUpdates();
     // Handle graceful shutdown
     const shutdown = async () => {
         console.error('Shutting down MCP server...');

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@fruition/fcp-mcp-server",
-  "version": "1.1.0",
-  "description": "MCP Server for FCP Launch Coordination System - enables Claude Code to interact with FCP launches",
+  "version": "1.3.0",
+  "description": "MCP Server for FCP Launch Coordination System - enables Claude Code to interact with FCP launches and track development time",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "fcp-mcp-server": "./dist/index.js"
+    "fcp-mcp-server": "./dist/index.js",
+    "unroo-heartbeat": "./bin/unroo-heartbeat.sh"
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "scripts": {
     "build": "tsc",