@freelancercom/phabricator-mcp 2.0.10 → 2.0.11

package/dist/tools/audit.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export function registerAuditTools(server, client) {
     // Query audits
-    server.tool('phabricator_audit_query', 'Search commit audit requests. Find commits needing audit, or audits by a specific user. Uses the audit.query endpoint (no modern replacement available).', {
+    server.tool('phabricator_audit_query', 'Search commit audit requests using the legacy audit.query endpoint. For most use cases, prefer phabricator_commit_search with the auditors attachment. This frozen endpoint provides audit-specific status filtering not available in the modern API.', {
         auditorPHIDs: z.array(z.string()).optional().describe('Auditor user/project PHIDs'),
         commitPHIDs: z.array(z.string()).optional().describe('Commit PHIDs to check audit status for'),
         status: z.string().optional().describe('Audit status filter: "audit-status-any" (default), "audit-status-open", "audit-status-concern", "audit-status-accepted", "audit-status-partial"'),

package/dist/tools/conpherence.js

@@ -34,12 +34,16 @@ export function registerConpherenceTools(server, client) {
     // Create a new thread
     server.tool('phabricator_conpherence_create', 'Create a new Conpherence chat room/thread', {
         title: z.string().describe('Thread title'),
+        topic: z.string().optional().describe('Room topic/description'),
         message: z.string().optional().describe('Initial message (supports Remarkup)'),
         participantPHIDs: z.array(z.string()).optional().describe('Participant user PHIDs to add'),
     }, async (params) => {
         const transactions = [
             { type: 'name', value: params.title },
         ];
+        if (params.topic !== undefined) {
+            transactions.push({ type: 'topic', value: params.topic });
+        }
         if (params.message !== undefined) {
             transactions.push({ type: 'comment', value: params.message });
         }
@@ -51,7 +55,7 @@ export function registerConpherenceTools(server, client) {
     });
     // Edit an existing thread
     server.tool('phabricator_conpherence_edit', 'Edit a Conpherence chat room/thread. Rename it or manage participants.', {
-        objectIdentifier: z.string().describe('Room ID or PHID'),
+        objectIdentifier: z.string().describe('Room monogram (e.g., "Z123"), numeric ID, or PHID'),
         title: z.string().optional().describe('New room title'),
         topic: z.string().optional().describe('Room topic/description'),
         addParticipantPHIDs: z.array(z.string()).optional().describe('Participant PHIDs to add'),
@@ -85,7 +89,7 @@ export function registerConpherenceTools(server, client) {
     });
     // Send a message
     server.tool('phabricator_conpherence_send', 'Send a message to a Conpherence chat room/thread', {
-        objectIdentifier: z.string().describe('Room ID or PHID'),
+        objectIdentifier: z.string().describe('Room monogram (e.g., "Z123"), numeric ID, or PHID'),
         message: z.string().describe('Message text (supports Remarkup)'),
     }, async (params) => {
         const result = await client.call('conpherence.edit', {

package/dist/tools/diffusion.js

@@ -63,9 +63,10 @@ export function registerDiffusionTools(server, client) {
     });
     // Browse repository file tree
     server.tool('phabricator_repository_browse', 'Browse a repository directory tree at a given path and commit/branch', {
-        path: z.string().describe('Path to browse (e.g., "/", "/src/")'),
+        path: z.string().optional().describe('Path to browse (default: "/")'),
         repository: z.string().optional().describe('Repository callsign, short name, or PHID'),
         commit: z.string().optional().describe('Commit hash or branch name (default: HEAD)'),
+        branch: z.string().optional().describe('Branch name'),
         needValidityOnly: z.boolean().optional().describe('Only check path validity without loading the full tree'),
         limit: z.coerce.number().optional().describe('Maximum entries to return'),
         offset: z.coerce.number().optional().describe('Result offset for pagination'),
@@ -77,12 +78,18 @@ export function registerDiffusionTools(server, client) {
     server.tool('phabricator_repository_file_content', 'Read file contents from a Diffusion repository at a given path and commit/branch. Returns the file content as a base64-encoded blob. If the file is too large, returns tooHuge: true with no content.', {
         path: z.string().describe('File path in the repository (e.g., "src/index.ts")'),
         repository: z.string().optional().describe('Repository callsign, short name, or PHID'),
-        commit: z.string().optional().describe('Commit hash or branch name (default: HEAD)'),
+        commit: z.string().describe('Commit hash or branch name'),
+        branch: z.string().optional().describe('Branch name'),
+        timeout: z.coerce.number().optional().describe('Query timeout in seconds'),
+        byteLimit: z.coerce.number().optional().describe('Maximum file size in bytes to return'),
     }, async (params) => {
         const result = await client.call('diffusion.filecontentquery', {
             path: params.path,
             repository: params.repository,
             commit: params.commit,
+            branch: params.branch,
+            timeout: params.timeout,
+            byteLimit: params.byteLimit,
         });
         if (result.tooHuge || result.tooSlow) {
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
@@ -96,6 +103,7 @@ export function registerDiffusionTools(server, client) {
     // List branches
     server.tool('phabricator_branch_search', 'List branches in a Diffusion repository', {
         repository: z.string().describe('Repository callsign, short name, or PHID'),
+        branch: z.string().optional().describe('Branch name'),
         contains: z.string().optional().describe('Only branches containing this commit'),
         patterns: z.array(z.string()).optional().describe('Filter branches by glob patterns'),
         closed: z.boolean().optional().describe('Filter by open/closed status (Mercurial only)'),
@@ -108,6 +116,7 @@ export function registerDiffusionTools(server, client) {
     // List tags
     server.tool('phabricator_tag_search', 'List tags in a Diffusion repository', {
         repository: z.string().describe('Repository callsign, short name, or PHID'),
+        branch: z.string().optional().describe('Branch name'),
         names: z.array(z.string()).optional().describe('Filter to specific tag names'),
         commit: z.string().optional().describe('Show tags reachable from this commit'),
         needMessages: z.boolean().optional().describe('Include tag messages in results'),
@@ -118,17 +127,22 @@ export function registerDiffusionTools(server, client) {
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
     // File commit history
-    server.tool('phabricator_repository_file_history', 'Get commit history for a file path in a Diffusion repository', {
-        path: z.string().describe('File path in the repository'),
+    server.tool('phabricator_repository_file_history', 'Get commit history for a file or directory path in a Diffusion repository', {
+        path: z.string().describe('File or directory path in the repository'),
         repository: z.string().optional().describe('Repository callsign, short name, or PHID'),
-        commit: z.string().optional().describe('Commit hash or branch to start from (default: HEAD)'),
+        commit: z.string().describe('Commit hash or branch to start from'),
+        branch: z.string().optional().describe('Branch name'),
         against: z.string().optional().describe('Compare against another commit'),
         needDirectChanges: z.boolean().optional().describe('Include direct change info per path entry'),
         needChildChanges: z.boolean().optional().describe('Include child change info per path entry'),
-        limit: z.coerce.number().max(100).optional().describe('Maximum results (max 100)'),
-        offset: z.coerce.number().optional().describe('Result offset for pagination'),
+        limit: z.coerce.number().max(100).optional().describe('Maximum results (default: 100)'),
+        offset: z.coerce.number().optional().describe('Result offset for pagination (default: 0)'),
     }, async (params) => {
-        const result = await client.call('diffusion.historyquery', params);
+        const result = await client.call('diffusion.historyquery', {
+            ...params,
+            offset: params.offset ?? 0,
+            limit: params.limit ?? 100,
+        });
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
     // Search file contents in repository
@@ -137,6 +151,7 @@ export function registerDiffusionTools(server, client) {
         repository: z.string().describe('Repository callsign, short name, or PHID'),
         query: z.string().describe('Search query / pattern'),
         commit: z.string().optional().describe('Commit hash or branch (default: HEAD)'),
+        branch: z.string().optional().describe('Branch name'),
         limit: z.coerce.number().max(100).optional().describe('Maximum results (max 100)'),
         offset: z.coerce.number().optional().describe('Result offset for pagination'),
     }, async (params) => {
@@ -145,6 +160,7 @@ export function registerDiffusionTools(server, client) {
             repository: params.repository,
             grep: params.query,
             commit: params.commit,
+            branch: params.branch,
             limit: params.limit,
             offset: params.offset,
         });

package/dist/tools/harbormaster.js

@@ -79,9 +79,9 @@ export function registerHarbormasterTools(server, client) {
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
     // Send build command
-    server.tool('phabricator_build_command', 'Report build status to Harbormaster. Used by external build systems to notify Phabricator of build results. Provide the build target PHID (use phabricator_build_target_search to find it).', {
-        buildTargetPHID: z.string().describe('Build target PHID to send the message to. Use phabricator_build_target_search to find this.'),
-        type: z.enum(['pass', 'fail', 'work']).describe('Message type: "pass" (build succeeded), "fail" (build failed), "work" (build is still running)'),
+    server.tool('phabricator_build_command', 'Send a command to Harbormaster. For build targets: report status (pass/fail/work) with optional unit/lint results. For builds/buildables: send control commands (pause/resume/abort/restart).', {
+        receiver: z.string().describe('PHID of build target, build, or buildable to send the message to'),
+        type: z.enum(['pass', 'fail', 'work', 'pause', 'resume', 'abort', 'restart']).describe('Message type: "pass"/"fail"/"work" for build targets; "pause"/"resume"/"abort"/"restart" for builds/buildables'),
         unit: jsonCoerce(z.array(z.object({
             name: z.string().describe('Test name'),
             result: z.string().describe('Result: "pass", "fail", "skip", "broken", "unsound"'),
@@ -103,7 +103,7 @@ export function registerHarbormasterTools(server, client) {
         }))).optional().describe('Lint results to report'),
     }, async (params) => {
         const apiParams = {
-            buildTargetPHID: params.buildTargetPHID,
+            receiver: params.receiver,
             type: params.type,
         };
         if (params.unit !== undefined) {

package/dist/tools/phame.js

@@ -139,6 +139,7 @@ export function registerPhameTools(server, client) {
         blogPHID: z.string().optional().describe('Move post to a different blog (PHID)'),
         addSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to add'),
         removeSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to remove'),
+        comment: z.string().optional().describe('Add a comment alongside the edit (supports Remarkup)'),
     }, async (params) => {
         const transactions = [];
         if (params.title !== undefined) {
@@ -162,6 +163,9 @@ export function registerPhameTools(server, client) {
         if (params.removeSubscriberPHIDs !== undefined) {
             transactions.push({ type: 'subscribers.remove', value: params.removeSubscriberPHIDs });
         }
+        if (params.comment !== undefined) {
+            transactions.push({ type: 'comment', value: params.comment });
+        }
         if (transactions.length === 0) {
             return { content: [{ type: 'text', text: 'No changes specified' }] };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freelancercom/phabricator-mcp",
-  "version": "2.0.10",
+  "version": "2.0.11",
   "description": "MCP server for Phabricator Conduit API - manage tasks, code reviews, repositories, and more",
   "type": "module",
   "main": "dist/index.js",