wolfpack-mcp 1.0.30 → 1.0.31

package/dist/client.js

@@ -5,47 +5,47 @@ const MAX_ITEMS_THRESHOLD = 200;
 const PAGE_SIZE = 50;
 export class WolfpackClient {
     api;
-    teamId = null;
+    projectId = null;
     constructor() {
         this.api = new ApiClient();
     }
     /**
-     * Fetch and cache the team ID from the team slug.
-     * Uses the MCP team endpoint to get team info.
+     * Fetch and cache the project ID from a project slug.
+     * Uses the MCP team endpoint to resolve slug to ID.
      */
-    async resolveTeamSlug(teamSlug) {
+    async resolveProjectSlug(projectSlug) {
         try {
-            const team = await this.api.get(`/team/${teamSlug}`);
-            this.teamId = team.id;
-            return team.id;
+            const project = await this.api.get(`/team/${projectSlug}`);
+            this.projectId = project.id;
+            return project.id;
         }
         catch (error) {
-            throw new Error(`Failed to resolve team slug "${teamSlug}": ${error instanceof Error ? error.message : String(error)}`);
+            throw new Error(`Failed to resolve project slug "${projectSlug}": ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    getTeamId() {
-        return this.teamId;
+    getProjectId() {
+        return this.projectId;
     }
-    setTeamId(teamId) {
-        this.teamId = teamId;
+    setProjectId(projectId) {
+        this.projectId = projectId;
     }
     /**
-     * Resolve a team slug from a team ID or the cached team ID.
+     * Resolve a project slug from a project ID or the cached project ID.
      */
-    async resolveSlug(teamId) {
-        const id = teamId || this.teamId;
+    async resolveSlug(projectId) {
+        const id = projectId || this.projectId;
         if (!id)
-            throw new Error('No team selected. Use list_teams first.');
-        const teams = await this.listTeams();
-        const team = teams.find((t) => t.id === id);
-        if (!team)
-            throw new Error(`Team with ID ${id} not found`);
-        return team.slug;
+            throw new Error('No project selected. Use list_projects first.');
+        const projects = await this.listProjects();
+        const project = projects.find((t) => t.id === id);
+        if (!project)
+            throw new Error(`Project with ID ${id} not found`);
+        return project.slug;
     }
     /**
-     * List all teams the authenticated user is a member of.
+     * List all projects the authenticated user is a member of.
      */
-    async listTeams() {
+    async listProjects() {
         const response = await this.api.get('/teams');
         return response.teams;
     }

package/dist/config.js

@@ -1,7 +1,7 @@
 export const config = {
     apiUrl: process.env.WOLFPACK_API_URL || 'https://wolfpacks.work/api/mcp',
     apiKey: process.env.WOLFPACK_API_KEY,
-    teamSlug: process.env.WOLFPACK_TEAM_SLUG,
+    projectSlug: process.env.WOLFPACK_PROJECT_SLUG || process.env.WOLFPACK_TEAM_SLUG,
 };
 // Validate configuration on startup
 export function validateConfig() {
@@ -17,10 +17,10 @@ export function validateConfig() {
         process.exit(1);
     }
     console.error(`MCP Server connecting to: ${config.apiUrl}`);
-    if (config.teamSlug) {
-        console.error(`Team configured: ${config.teamSlug}`);
+    if (config.projectSlug) {
+        console.error(`Project configured: ${config.projectSlug}`);
     }
     else {
-        console.error('No team configured - will auto-detect or use list_teams tool');
+        console.error('No project configured - will auto-detect or use list_projects tool');
     }
 }

package/dist/index.js

@@ -46,7 +46,7 @@ async function checkForUpdates() {
 // Work Item schemas
 // Use z.coerce.string() to handle any type coercion issues from MCP args
 const ListWorkItemsSchema = z.object({
-    team_id: z.number().optional().describe('Team ID to filter work items'),
+    project_id: z.number().optional().describe('Project ID to filter work items'),
     status: z.coerce
         .string()
         .optional()
@@ -85,7 +85,7 @@ const ListWorkItemsSchema = z.object({
 });
 const GetWorkItemSchema = z.object({
     work_item_id: z.string().describe('The ID (UUID) or refId (number) of the work item'),
-    team_id: z.number().optional().describe('Team ID (required when looking up by refId)'),
+    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
 });
 const UpdateWorkProgressSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
@@ -111,7 +111,7 @@ const PullWorkItemSchema = z.object({
 });
 // Radar Item (Initiative/Roadmap) schemas
 const ListRadarItemsSchema = z.object({
-    team_id: z.number().optional().describe('Team ID to filter radar items'),
+    project_id: z.number().optional().describe('Project ID to filter radar items'),
     stage: z
         .enum(['pending', 'now', 'next', 'later', 'completed'])
         .optional()
@@ -122,11 +122,11 @@ const ListRadarItemsSchema = z.object({
 });
 const GetRadarItemSchema = z.object({
     item_id: z.string().describe('The ID (UUID) or refId (number) of the radar item'),
-    team_id: z.number().optional().describe('Team ID (required when looking up by refId)'),
+    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
 });
 // Issue schemas
 const ListIssuesSchema = z.object({
-    team_id: z.number().optional().describe('Team ID to filter issues'),
+    project_id: z.number().optional().describe('Project ID to filter issues'),
     status: z
         .enum(['open', 'in-progress', 'resolved', 'closed'])
         .optional()
@@ -159,7 +159,7 @@ const ListIssuesSchema = z.object({
 });
 const GetIssueSchema = z.object({
     issue_id: z.string().describe('The ID (UUID) or refId (number) of the issue'),
-    team_id: z.number().optional().describe('Team ID (required when looking up by refId)'),
+    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
 });
 // Create schemas
 const CreateWorkItemSchema = z.object({
@@ -223,7 +223,14 @@ const GetWikiPageSchema = z.object({
     page_id: z.string().describe('The page UUID or slug'),
 });
 const CreateWikiPageSchema = z.object({
-    slug: z.string().describe('URL slug for the page (without team prefix)'),
+    slug: z
+        .string()
+        .describe('URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.')
+        .transform((slug) => {
+        // Strip accidental team/wiki prefix (e.g., "myteam/wiki/foo" → "foo")
+        const wikiPrefix = /^[^/]+\/wiki\//;
+        return slug.replace(wikiPrefix, '');
+    }),
     title: z.string().describe('Page title'),
     content: z
         .string()
@@ -253,7 +260,7 @@ const ListJournalEntriesSchema = z.object({
 });
 const GetJournalEntrySchema = z.object({
     entry_id: z.string().describe('The entry UUID or refId'),
-    team_id: z.number().optional().describe('Team ID (required when looking up by refId)'),
+    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
 });
 const CreateJournalEntrySchema = z.object({
     title: z.string().describe('Entry title'),
@@ -295,10 +302,10 @@ const UploadImageSchema = z.object({
         .string()
         .describe('Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
         'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.'),
-    team_id: z
+    project_id: z
         .number()
         .optional()
-        .describe('Team ID (required for multi-team users, use list_teams to get IDs)'),
+        .describe('Project ID (required for multi-project users, use list_projects to get IDs)'),
 });
 const DownloadImageSchema = z.object({
     image_url: z
@@ -336,18 +343,17 @@ class WolfpackMCPServer {
     setupHandlers() {
         this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
             tools: [
-                // Team tools
+                // Project tools
                 {
-                    name: 'list_teams',
-                    description: 'List all teams (projects) you have access to. ' +
-                        'TERMINOLOGY: In this software, "team" and "project" are synonymous and interchangeable. All tool names and parameters use "team" (e.g., team_id), but the concepts are identical. ' +
+                    name: 'list_projects',
+                    description: 'List all projects you have access to. Projects can be "personal" (single user) or "team" (multi-member). ' +
                         'IMPORTANT - PROJECT FOCUS RULES: ' +
-                        '1) Call this FIRST to identify which team/project you are working in. ' +
-                        '2) Once you identify a team, STAY WITHIN that team for all operations unless the user explicitly asks to switch. ' +
-                        '3) NEVER perform bulk actions across multiple teams - always work in one team at a time. ' +
-                        '4) If the user mentions a specific team or project, use that for all subsequent operations. ' +
-                        '5) If unclear which team to use, ASK the user before proceeding. ' +
-                        'Returns team IDs, slugs, and names. Single-team users have their team auto-selected; multi-team users must specify team_id in other tool calls.',
+                        '1) Call this FIRST to identify which project you are working in. ' +
+                        '2) Once you identify a project, STAY WITHIN that project for all operations unless the user explicitly asks to switch. ' +
+                        '3) NEVER perform bulk actions across multiple projects - always work in one project at a time. ' +
+                        '4) If the user mentions a specific project, use that for all subsequent operations. ' +
+                        '5) If unclear which project to use, ASK the user before proceeding. ' +
+                        'Returns project IDs, slugs, names, and types. Single-project users have their project auto-selected; multi-project users must specify project_id in other tool calls.',
                     inputSchema: {
                         type: 'object',
                         properties: {},
@@ -368,9 +374,9 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required for multi-team users, use list_teams to get IDs)',
+                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
                             },
                             status: {
                                 type: 'string',
@@ -434,9 +440,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the work item',
                             },
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required when looking up by refId)',
+                                description: 'Project ID (required when looking up by refId)',
                             },
                         },
                         required: ['work_item_id'],
@@ -488,7 +494,8 @@ class WolfpackMCPServer {
                 {
                     name: 'update_work_item_assignee',
                     description: 'Change the assignee (leading user) on a work item. ' +
-                        'Use this to assign work to yourself or another team member, or to unassign by passing null.',
+                        'Use this to assign work to yourself or another project member, or to unassign by passing null. ' +
+                        'Not applicable for personal projects (single user).',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -510,7 +517,8 @@ class WolfpackMCPServer {
                         'REQUIRED: Use this when starting work on a "pending" (backlog) item. ' +
                         'This claims the item (assigns to you) and sets status to "new". ' +
                         'After pulling, move to "doing" to indicate active work, then "review" when done. ' +
-                        'If no assignee is specified, assigns to the API key owner.',
+                        'If no assignee is specified, assigns to the API key owner. ' +
+                        'In personal projects, items are always assigned to the owner.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -533,7 +541,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            team_id: { type: 'number', description: 'Team ID (use list_teams to get IDs)' },
+                            project_id: {
+                                type: 'number',
+                                description: 'Project ID (use list_projects to get IDs)',
+                            },
                             stage: {
                                 type: 'string',
                                 enum: ['pending', 'now', 'next', 'later', 'completed'],
@@ -559,9 +570,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the radar item',
                             },
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required when looking up by refId)',
+                                description: 'Project ID (required when looking up by refId)',
                             },
                         },
                         required: ['item_id'],
@@ -578,9 +589,9 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required for multi-team users, use list_teams to get IDs)',
+                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
                             },
                             status: {
                                 type: 'string',
@@ -637,9 +648,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the issue',
                             },
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required when looking up by refId)',
+                                description: 'Project ID (required when looking up by refId)',
                             },
                         },
                         required: ['issue_id'],
@@ -648,7 +659,7 @@ class WolfpackMCPServer {
                 // Create/Update tools
                 {
                     name: 'create_work_item',
-                    description: 'Create a new work item in your current team (auto-selected for single-team users, or use list_teams first for multi-team). Requires mcp:work_items:create permission.',
+                    description: 'Create a new work item in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:work_items:create permission.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -683,7 +694,7 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'create_issue',
-                    description: 'Create a new issue in your current team (auto-selected for single-team users, or use list_teams first for multi-team). Requires mcp:issues:create permission.',
+                    description: 'Create a new issue in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:issues:create permission.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -783,7 +794,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            slug: { type: 'string', description: 'URL slug for the page (without team prefix)' },
+                            slug: {
+                                type: 'string',
+                                description: 'URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.',
+                            },
                             title: { type: 'string', description: 'Page title' },
                             content: {
                                 type: 'string',
@@ -841,9 +855,9 @@ class WolfpackMCPServer {
                         type: 'object',
                         properties: {
                             entry_id: { type: 'string', description: 'The entry UUID or refId' },
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required when looking up by refId)',
+                                description: 'Project ID (required when looking up by refId)',
                             },
                         },
                         required: ['entry_id'],
@@ -912,7 +926,8 @@ class WolfpackMCPServer {
                         'USE COMMENTS FOR: 1) Blocking reasons when moving to "blocked" (what failed, what was tried, what is needed). ' +
                         '2) Completion summaries when moving to "review" (what was done, files changed, testing notes). ' +
                         '3) Important observations or decisions that should be visible in the activity history. ' +
-                        'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time.',
+                        'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time. ' +
+                        'Comments are typically not used in personal projects.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -955,9 +970,9 @@ class WolfpackMCPServer {
                                 description: 'Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
                                     'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.',
                             },
-                            team_id: {
+                            project_id: {
                                 type: 'number',
-                                description: 'Team ID (required for multi-team users, use list_teams to get IDs)',
+                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
                             },
                         },
                         required: ['file_path'],
@@ -986,20 +1001,20 @@ class WolfpackMCPServer {
             const { name, arguments: args } = request.params;
             try {
                 switch (name) {
-                    // Team handlers
-                    case 'list_teams': {
-                        const teams = await this.client.listTeams();
-                        const currentTeamId = this.client.getTeamId();
+                    // Project handlers
+                    case 'list_projects': {
+                        const teams = await this.client.listProjects();
+                        const currentTeamId = this.client.getProjectId();
                         return {
                             content: [
                                 {
                                     type: 'text',
                                     text: JSON.stringify({
-                                        teams,
-                                        currentTeamId,
+                                        projects: teams,
+                                        currentProjectId: currentTeamId,
                                         hint: teams.length === 1
-                                            ? 'Only one team available - it will be used automatically.'
-                                            : 'Multiple teams available. Use team_id parameter in other tools to specify which team to use.',
+                                            ? 'Only one project available - it will be used automatically.'
+                                            : 'Multiple projects available. Use project_id parameter in other tools to specify which project to use.',
                                     }, null, 2),
                                 },
                             ],
@@ -1009,7 +1024,7 @@ class WolfpackMCPServer {
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
                         const result = await this.client.listWorkItems({
-                            teamId: parsed.team_id || this.client.getTeamId() || undefined,
+                            teamId: parsed.project_id || this.client.getProjectId() || undefined,
                             status: parsed.status,
                             assignedToId: parsed.assigned_to_id,
                             search: parsed.search,
@@ -1035,7 +1050,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_work_item': {
                         const parsed = GetWorkItemSchema.parse(args);
-                        const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.team_id || this.client.getTeamId() || undefined);
+                        const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.project_id || this.client.getProjectId() || undefined);
                         if (workItem) {
                             let text = JSON.stringify(workItem, null, 2);
                             // Add hint if no plan detected in description
@@ -1131,7 +1146,7 @@ class WolfpackMCPServer {
                     case 'list_radar_items': {
                         const parsed = ListRadarItemsSchema.parse(args);
                         const result = await this.client.listRadarItems({
-                            teamId: parsed.team_id,
+                            teamId: parsed.project_id,
                             stage: parsed.stage,
                             search: parsed.search,
                             limit: parsed.limit,
@@ -1147,7 +1162,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_radar_item': {
                         const parsed = GetRadarItemSchema.parse(args);
-                        const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.team_id);
+                        const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.project_id);
                         if (radarItem) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(radarItem, null, 2) }],
@@ -1161,7 +1176,7 @@ class WolfpackMCPServer {
                     case 'list_issues': {
                         const parsed = ListIssuesSchema.parse(args);
                         const result = await this.client.listIssues({
-                            teamId: parsed.team_id,
+                            teamId: parsed.project_id,
                             status: parsed.status,
                             severity: parsed.severity,
                             type: parsed.type,
@@ -1184,7 +1199,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_issue': {
                         const parsed = GetIssueSchema.parse(args);
-                        const issue = await this.client.getIssue(parsed.issue_id, parsed.team_id);
+                        const issue = await this.client.getIssue(parsed.issue_id, parsed.project_id);
                         if (issue) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(issue, null, 2) }],
@@ -1339,7 +1354,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_journal_entry': {
                         const parsed = GetJournalEntrySchema.parse(args);
-                        const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.team_id);
+                        const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.project_id);
                         if (entry) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(entry, null, 2) }],
@@ -1425,7 +1440,7 @@ class WolfpackMCPServer {
                     }
                     case 'upload_image': {
                         const parsed = UploadImageSchema.parse(args);
-                        const teamSlug = await this.client.resolveSlug(parsed.team_id || this.client.getTeamId() || undefined);
+                        const teamSlug = await this.client.resolveSlug(parsed.project_id || this.client.getProjectId() || undefined);
                         const filePath = resolve(parsed.file_path);
                         // Validate file extension
                         const ext = extname(filePath).toLowerCase();
@@ -1521,37 +1536,37 @@ class WolfpackMCPServer {
     async start() {
         // Start version check early (non-blocking)
         const updateCheckPromise = checkForUpdates();
-        // Resolve team on startup
-        if (config.teamSlug) {
-            // Explicit team slug configured - use it
+        // Resolve project on startup
+        if (config.projectSlug) {
+            // Explicit project slug configured - use it
             try {
-                const teamId = await this.client.resolveTeamSlug(config.teamSlug);
-                console.error(`Resolved team "${config.teamSlug}" to ID: ${teamId}`);
+                const teamId = await this.client.resolveProjectSlug(config.projectSlug);
+                console.error(`Resolved project "${config.projectSlug}" to ID: ${teamId}`);
             }
             catch (error) {
-                console.error(`Failed to resolve team slug: ${error instanceof Error ? error.message : String(error)}`);
+                console.error(`Failed to resolve project slug: ${error instanceof Error ? error.message : String(error)}`);
                 process.exit(1);
             }
         }
         else {
-            // No team slug configured - try to auto-detect
+            // No project slug configured - try to auto-detect
             try {
-                const teams = await this.client.listTeams();
+                const teams = await this.client.listProjects();
                 if (teams.length === 1) {
-                    // Auto-select the only team
-                    this.client.setTeamId(teams[0].id);
-                    console.error(`Auto-selected team: ${teams[0].name} (${teams[0].slug})`);
+                    // Auto-select the only project
+                    this.client.setProjectId(teams[0].id);
+                    console.error(`Auto-selected project: ${teams[0].name} (${teams[0].slug})`);
                 }
                 else if (teams.length === 0) {
-                    console.error('Warning: No teams found for this API key');
+                    console.error('Warning: No projects found for this API key');
                 }
                 else {
-                    console.error(`Multiple teams available (${teams.length}). Use list_teams tool to see them, then specify team_id in tool calls.`);
+                    console.error(`Multiple projects available (${teams.length}). Use list_projects tool to see them, then specify project_id in tool calls.`);
                 }
             }
             catch (error) {
-                console.error(`Warning: Could not fetch teams: ${error instanceof Error ? error.message : String(error)}`);
-                // Don't exit - let the user use list_teams tool manually
+                console.error(`Warning: Could not fetch projects: ${error instanceof Error ? error.message : String(error)}`);
+                // Don't exit - let the user use list_projects tool manually
             }
         }
         const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",