@studiometa/productive-mcp 0.8.4 → 0.9.0

package/skills/SKILL.md

@@ -17,19 +17,36 @@ productive(resource, action, [parameters...])
 
 ### Resources & Actions
 
-| Resource    | Actions                                   | Description             |
-| ----------- | ----------------------------------------- | ----------------------- |
-| `projects`  | `list`, `get`, `help`                     | Project management      |
-| `time`      | `list`, `get`, `create`, `update`, `help` | Time tracking           |
-| `tasks`     | `list`, `get`, `create`, `update`, `help` | Task management         |
-| `services`  | `list`, `get`, `help`                     | Budget line items       |
-| `people`    | `list`, `get`, `me`, `help`               | Team members            |
-| `companies` | `list`, `get`, `create`, `update`, `help` | Client companies        |
-| `comments`  | `list`, `get`, `create`, `update`, `help` | Comments on tasks/deals |
-| `timers`    | `list`, `get`, `start`, `stop`, `help`    | Active timers           |
-| `deals`     | `list`, `get`, `create`, `update`, `help` | Sales deals             |
-| `bookings`  | `list`, `get`, `create`, `update`, `help` | Resource scheduling     |
-| `reports`   | `get`, `help`                             | Generate reports        |
+| Resource      | Actions                                                                  | Description             |
+| ------------- | ------------------------------------------------------------------------ | ----------------------- |
+| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management      |
+| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking           |
+| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management         |
+| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items       |
+| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members            |
+| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies        |
+| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals |
+| `attachments` | `list`, `get`, `delete`, `help`                                          | File attachments        |
+| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers           |
+| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals             |
+| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling     |
+| `budgets`     | `list`, `get`, `help`                                                    | Budget tracking         |
+| `reports`     | `get`, `help`                                                            | Generate reports        |
+| Resource      | Actions                                                                  | Description             |
+| ------------- | ------------------------------------------------------------------------ | ----------------------- |
+| `projects`    | `list`, `get`, `resolve`, `help`                                         | Project management      |
+| `time`        | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Time tracking           |
+| `tasks`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Task management         |
+| `services`    | `list`, `get`, `resolve`, `help`                                         | Budget line items       |
+| `people`      | `list`, `get`, `me`, `resolve`, `help`                                   | Team members            |
+| `companies`   | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Client companies        |
+| `comments`    | `list`, `get`, `create`, `update`, `help`                                | Comments on tasks/deals |
+| `timers`      | `list`, `get`, `start`, `stop`, `help`                                   | Active timers           |
+| `deals`       | `list`, `get`, `create`, `update`, `resolve`, `help`                     | Sales deals             |
+| `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling     |
+| `pages`       | `list`, `get`, `create`, `update`, `delete`, `help`                      | Wiki/docs pages         |
+| `discussions` | `list`, `get`, `create`, `update`, `delete`, `resolve`, `reopen`, `help` | Discussions on pages    |
+| `reports`     | `get`, `help`                                                            | Generate reports        |
 
 ### Getting Help
 
@@ -59,6 +76,92 @@ Returns filters, fields, includes, and examples for that resource.
 | `query`    | string  | Text search (behavior varies by resource - may search related fields like project names) |
 | `no_hints` | boolean | Disable contextual hints in responses (default: false)                                   |
 
+## Smart ID Resolution
+
+Use human-friendly identifiers instead of numeric IDs. The server automatically resolves:
+
+- **Emails** → Person IDs: `user@example.com` → `500521`
+- **Project numbers** → Project IDs: `PRJ-123` or `P-123` → `777332`
+- **Deal numbers** → Deal IDs: `D-456` or `DEAL-456` → `888123`
+- **Names** → IDs: Company names, service names (with project context)
+
+### Auto-Resolution in Filters
+
+Filters automatically resolve human-friendly values:
+
+```json
+// Email resolved to person ID
+{
+  "resource": "tasks",
+  "action": "list",
+  "filter": { "assignee_id": "user@example.com" }
+}
+
+// Project number resolved
+{
+  "resource": "time",
+  "action": "list",
+  "filter": { "project_id": "PRJ-123" }
+}
+```
+
+Response includes `_resolved` metadata showing what was resolved:
+
+```json
+{
+  "data": [...],
+  "_resolved": {
+    "assignee_id": {
+      "input": "user@example.com",
+      "id": "500521",
+      "label": "John Doe"
+    }
+  }
+}
+```
+
+### Auto-Resolution in Get Actions
+
+Use human-friendly IDs directly in `get` actions:
+
+```json
+{ "resource": "projects", "action": "get", "id": "PRJ-123" }
+{ "resource": "people", "action": "get", "id": "user@example.com" }
+{ "resource": "deals", "action": "get", "id": "D-456" }
+```
+
+### Explicit Resolution with `resolve` Action
+
+Look up resources by human-friendly identifiers:
+
+```json
+// Resolve email to person
+{ "resource": "people", "action": "resolve", "query": "user@example.com" }
+
+// Resolve project number
+{ "resource": "projects", "action": "resolve", "query": "PRJ-123" }
+
+// Resolve with type hint (when pattern is ambiguous)
+{ "resource": "time", "action": "resolve", "query": "Development", "type": "service", "project_id": "777332" }
+```
+
+Response:
+
+```json
+{
+  "matches": [
+    {
+      "id": "500521",
+      "label": "John Doe",
+      "type": "person",
+      "exact": true
+    }
+  ],
+  "query": "user@example.com",
+  "detected_type": "person"
+}
+```
+
 ## Examples by Resource
 
 ### Projects
@@ -199,6 +302,22 @@ Returns filters, fields, includes, and examples for that resource.
 { "resource": "timers", "action": "stop", "id": "67890" }
 ```
 
+### Budgets
+
+```json
+// List all budgets
+{ "resource": "budgets", "action": "list" }
+
+// List budgets for a project
+{ "resource": "budgets", "action": "list", "filter": { "project_id": "12345" } }
+
+// Get budget details
+{ "resource": "budgets", "action": "get", "id": "67890" }
+
+// List billable budgets
+{ "resource": "budgets", "action": "list", "filter": { "billable": "true" } }
+```
+
 ### Reports
 
 ```json
@@ -221,6 +340,64 @@ Returns filters, fields, includes, and examples for that resource.
 }
 ```
 
+### Pages (Docs)
+
+```json
+// List pages for a project
+{ "resource": "pages", "action": "list", "filter": { "project_id": "12345" } }
+
+// Get page details
+{ "resource": "pages", "action": "get", "id": "67890" }
+
+// Create a page
+{
+  "resource": "pages",
+  "action": "create",
+  "title": "Getting Started",
+  "project_id": "12345"
+}
+
+// Create a sub-page
+{
+  "resource": "pages",
+  "action": "create",
+  "title": "Installation",
+  "project_id": "12345",
+  "parent_page_id": "67890"
+}
+
+// Delete a page
+{ "resource": "pages", "action": "delete", "id": "67890" }
+```
+
+### Discussions
+
+```json
+// List discussions on a page
+{
+  "resource": "discussions",
+  "action": "list",
+  "filter": { "page_id": "12345" }
+}
+
+// List active discussions
+{ "resource": "discussions", "action": "list", "status": "active" }
+
+// Create a discussion
+{
+  "resource": "discussions",
+  "action": "create",
+  "page_id": "12345",
+  "body": "This section needs review"
+}
+
+// Resolve a discussion
+{ "resource": "discussions", "action": "resolve", "id": "67890" }
+
+// Reopen a resolved discussion
+{ "resource": "discussions", "action": "reopen", "id": "67890" }
+```
+
 ## Filters Reference
 
 ### Time Entries
@@ -299,6 +476,25 @@ Returns filters, fields, includes, and examples for that resource.
 - `booking_type` - Type: `event` (absence) or `service` (budget)
 - `draft` - Tentative status: `true`/`false`
 
+### Budgets
+
+- `project_id` - Filter by project
+- `company_id` - Filter by company
+- `deal_id` - Filter by deal
+- `billable` - Filter by billable status: `true`/`false`
+- `budget_type` - Filter by budget type
+
+### Pages
+
+- `project_id` - Filter by project
+- `creator_id` - Filter by creator
+- `parent_page_id` - Filter by parent page (for sub-pages)
+
+### Discussions
+
+- `page_id` - Filter by page
+- `status` - Status: `1`=active, `2`=resolved (or "active", "resolved")
+
 ### Comments
 
 - `task_id` - Filter by task

package/Dockerfile

@@ -1,36 +0,0 @@
-# Productive MCP Server - HTTP Transport
-# 
-# Build from the repository root:
-#   docker build -t productive-mcp-server -f packages/productive-mcp/Dockerfile .
-#
-# Or from the package directory with published packages:
-#   docker build -t productive-mcp-server .
-
-FROM node:20-alpine
-
-WORKDIR /app
-
-# Install the package globally from npm
-RUN npm install -g @studiometa/productive-mcp
-
-# Set environment variables
-ENV NODE_ENV=production
-ENV PORT=3000
-ENV HOST=0.0.0.0
-
-# Create non-root user for security
-RUN addgroup -g 1001 -S nodejs && \
-    adduser -S nodejs -u 1001 -G nodejs
-
-# Expose port
-EXPOSE 3000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
-
-# Switch to non-root user
-USER nodejs
-
-# Run the HTTP server
-CMD ["productive-mcp-server"]

package/dist/handlers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}