@fruition/fcp-mcp-server 1.1.0 → 1.2.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

@@ -13,7 +13,7 @@ import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSche
 // 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 {

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.2.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",