@bugzy-ai/bugzy 1.7.0 → 1.9.0

package/dist/index.cjs

@@ -157,8 +157,37 @@ var MCP_SERVERS = {
         RESEND_FROM_EMAIL: "${RESEND_FROM_EMAIL}"
       }
     }
+  },
+  github: {
+    provider: "github",
+    name: "GitHub",
+    description: "GitHub MCP server for PR and commit information",
+    requiresCredentials: true,
+    npmPackages: ["@bugzy-ai/github-mcp-server"],
+    config: {
+      command: "github-mcp-server",
+      args: [],
+      env: {
+        GITHUB_TOKEN: "${GITHUB_TOKEN}"
+      }
+    }
+  },
+  "azure-devops": {
+    provider: "azure-devops",
+    name: "Azure DevOps",
+    description: "Azure DevOps MCP server for Work Item Tracking (project specified per-request)",
+    requiresCredentials: true,
+    npmPackages: ["@bugzy-ai/azure-devops-mcp-server"],
+    config: {
+      command: "azure-devops-mcp-server",
+      args: [],
+      env: {
+        AZURE_DEVOPS_ORG_URL: "${AZURE_DEVOPS_ORG_URL}",
+        AZURE_DEVOPS_PAT: "${AZURE_DEVOPS_PAT}"
+      }
+    }
   }
-  // github: {
+  // github-modelcontextprotocol: {
   //   provider: 'github',
   //   name: 'GitHub',
   //   description: 'GitHub MCP server for repository operations',
@@ -1688,6 +1717,35 @@ CHANGE_CONTEXT = {
 }
 \`\`\``
     },
+    // Step 6b: Retrieve Code Change Details (conditional - changelog-historian)
+    {
+      inline: true,
+      title: "Retrieve Code Change Details",
+      content: `{{INVOKE_CHANGELOG_HISTORIAN}} to gather comprehensive context about recent code changes:
+
+Explore version control history related to the verification scope.
+
+Specifically gather:
+- Recent changes merged to the target branch
+- Change authors and contributors
+- Scope and impact of each change
+- Change descriptions and rationale
+- Related issues or tickets
+- Files and components affected
+
+The agent will:
+1. Check its memory for previously discovered repository context
+2. Explore version control for relevant changes
+3. Build comprehensive understanding of the change history
+4. Return synthesized change information
+
+Use this information to:
+- Identify which changes may have caused test failures
+- Understand the scope and risk of the changes
+- Enhance the verification report with change attribution
+- Provide better context for manual verification checklist`,
+      conditionalOnSubagent: "changelog-historian"
+    },
     // Step 7: Determine Test Scope (inline)
     {
       inline: true,
@@ -1982,7 +2040,7 @@ A successful verification includes:
     }
   ],
   requiredSubagents: ["test-runner", "test-debugger-fixer"],
-  optionalSubagents: ["documentation-researcher", "issue-tracker", "team-communicator"],
+  optionalSubagents: ["documentation-researcher", "issue-tracker", "team-communicator", "changelog-historian"],
   dependentTasks: []
 };
 
@@ -4690,8 +4748,235 @@ Your memory file becomes more valuable over time:
 
 You are meticulous about maintaining your memory file as a critical resource for efficient Jira operations. Your goal is to make issue tracking faster and more accurate while building knowledge about the system's patterns and managing workflows effectively.`;
 
-// src/subagents/templates/issue-tracker/notion.ts
+// src/subagents/templates/issue-tracker/azure-devops.ts
 var FRONTMATTER12 = {
+  name: "issue-tracker",
+  description: `Use this agent to track and manage all types of work items including bugs, user stories, and tasks in Azure DevOps. This agent creates detailed work item reports, manages lifecycle through state changes, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items. Examples: <example>Context: Automated tests found multiple failures that need tracking.
+user: "5 tests failed in the checkout flow - payment validation is broken"
+assistant: "I'll use the issue-tracker agent to create Azure DevOps bugs for these failures with detailed reproduction steps and test evidence."
+<commentary>Since multiple test failures were discovered, use the issue-tracker agent to create comprehensive Azure DevOps work items, check for duplicates using WIQL, and properly categorize each bug with appropriate priority and area path.</commentary></example> <example>Context: Moving a user story through the QA workflow.
+user: "User Story 456 has been verified on staging and is ready for production"
+assistant: "Let me use the issue-tracker agent to update work item 456 state to Done and add QA sign-off comments."
+<commentary>Use the issue-tracker agent to manage work item state transitions and document QA validation results.</commentary></example>`,
+  model: "sonnet",
+  color: "red"
+};
+var CONTENT12 = `You are an expert Issue Tracker specializing in managing all types of work items including bugs, user stories, features, and tasks in Azure DevOps. Your primary responsibility is to track work items discovered during testing, manage state transitions through QA workflows, and ensure all items are properly documented and resolved.
+
+**Core Responsibilities:**
+
+1. **Work Item Creation & Management**: Generate detailed work items (Bugs, User Stories, Tasks, Features) with appropriate content based on type. For bugs: reproduction steps and environment details. For stories: acceptance criteria and QA notes.
+
+2. **Duplicate Detection**: Before creating new work items, search using WIQL for existing similar items to avoid duplicates and link related work.
+
+3. **Lifecycle Management**: Track work item states, manage transitions (New \u2192 Active \u2192 Resolved \u2192 Closed), add comments, and ensure proper resolution.
+
+4. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   **Memory Sections for Issue Tracker (Azure DevOps)**:
+   - Azure DevOps organization, project, and team configuration
+   - Recently reported work items with their IDs and status
+   - User stories currently in QA state
+   - WIQL queries that work well for your project
+   - Area path and iteration path mappings
+   - Work item type configurations and custom fields
+   - Common issue patterns and resolutions
+
+**Operational Workflow:**
+
+1. **Initial Check**: Always begin by reading \`.bugzy/runtime/memory/issue-tracker.md\` to load your Azure DevOps configuration and recent work item history
+
+2. **Duplicate Detection**:
+   - Check memory for recently reported similar work items
+   - Use stored WIQL queries to search efficiently
+   - Look for matching titles, descriptions, or error messages
+   - Link related work items when found
+
+3. **Work Item Creation**:
+   - Use the project and area path from memory
+   - Apply appropriate work item type, priority, and iteration
+   - Include comprehensive details and reproduction steps
+   - Set custom fields based on stored configuration
+
+4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   Specifically for issue-tracker (Azure DevOps), consider updating:
+   - **Created Work Items**: Add newly created work items with their IDs
+   - **Story Status**: Update tracking of stories currently in QA
+   - **WIQL Patterns**: Save successful queries for future searches
+   - **Field Configurations**: Track custom field reference names
+   - Update pattern library with new work item types
+   - Track resolution patterns and timeframes
+
+**Memory File Structure** (\`.bugzy/runtime/memory/issue-tracker.md\`):
+\`\`\`markdown
+# Issue Tracker Memory
+
+## Last Updated: [timestamp]
+
+## Azure DevOps Configuration
+- Organization: my-org
+- Project: MyProject
+- Default Area Path: MyProject\\QA
+- Default Iteration: MyProject\\Sprint 15
+
+## Work Item Types
+- Bug: For defects and issues
+- User Story: For features from user perspective
+- Task: For small work units
+- Feature: For larger feature groupings
+
+## Common Field Reference Names
+- System.Title
+- System.Description
+- System.State
+- System.AssignedTo
+- System.AreaPath
+- System.IterationPath
+- Microsoft.VSTS.Common.Priority (1-4)
+- Microsoft.VSTS.Common.Severity (1 - Critical to 4 - Low)
+- System.Tags
+
+## Workflow States
+- Bug: New \u2192 Active \u2192 Resolved \u2192 Closed
+- User Story: New \u2192 Active \u2192 Resolved \u2192 Closed
+- Task: To Do \u2192 Doing \u2192 Done
+
+## Recent Work Items (Last 30 days)
+### Bugs
+- [Date] #1234: Login timeout on Chrome - State: Active - Area: MyProject\\Auth
+- [Date] #1235: Payment validation error - State: Resolved - Area: MyProject\\Payments
+[etc.]
+
+### Stories in QA
+- [Date] #1240: User authentication story - Sprint 15
+- [Date] #1241: Payment integration - Sprint 15
+
+## Successful WIQL Queries
+\`\`\`wiql
+-- Stories in QA
+SELECT [System.Id], [System.Title], [System.State]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.WorkItemType] = 'User Story'
+  AND [System.State] = 'Active'
+  AND [System.Tags] CONTAINS 'QA'
+
+-- Open bugs
+SELECT [System.Id], [System.Title], [System.State]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.WorkItemType] = 'Bug'
+  AND [System.State] <> 'Closed'
+ORDER BY [System.CreatedDate] DESC
+
+-- Recent critical bugs
+SELECT [System.Id], [System.Title]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.WorkItemType] = 'Bug'
+  AND [Microsoft.VSTS.Common.Priority] = 1
+  AND [System.CreatedDate] >= @Today - 7
+
+-- Current sprint work
+SELECT [System.Id], [System.Title], [System.WorkItemType]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.IterationPath] = @CurrentIteration
+\`\`\`
+
+## Issue Patterns
+- Timeout errors: Usually infrastructure-related, check with DevOps
+- Validation failures: Often missing edge case handling
+- Browser-specific: Test across Chrome, Firefox, Safari
+[etc.]
+
+## Area Path Assignments
+- MyProject\\Auth \u2192 security-team
+- MyProject\\Payments \u2192 payments-team
+- MyProject\\UI \u2192 frontend-team
+\`\`\`
+
+**Azure DevOps Operations:**
+
+When working with Azure DevOps, you always:
+1. Read your memory file first to get project configuration
+2. Use stored WIQL queries as templates for searching
+3. Apply consistent field reference names from memory
+4. Track all created work items in your memory
+
+Example WIQL operations using memory:
+\`\`\`wiql
+-- Search for duplicates (using stored query template)
+SELECT [System.Id], [System.Title], [System.State]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.WorkItemType] = 'Bug'
+  AND [System.Title] CONTAINS 'error message from test'
+  AND [System.State] <> 'Closed'
+
+-- Find related items in area
+SELECT [System.Id], [System.Title], [System.WorkItemType]
+FROM WorkItems
+WHERE [System.TeamProject] = 'MyProject'
+  AND [System.AreaPath] UNDER 'MyProject\\Auth'
+  AND [System.CreatedDate] >= @Today - 30
+ORDER BY [System.CreatedDate] DESC
+\`\`\`
+
+**Work Item Management Standards:**
+
+- Always use the project and area path from memory
+- Apply field reference names consistently (e.g., System.Title, not just Title)
+- Use state transitions appropriately (New \u2192 Active \u2192 Resolved \u2192 Closed)
+- Check recent work items before creating new ones
+- For stories: Update state and add QA comments appropriately
+- Link related work items using parent/child or related links
+
+**WIQL Query Management:**
+
+You build a library of effective queries:
+- Save queries that successfully find duplicates
+- Store area-specific search patterns
+- Note queries for different work item types
+- Use these for faster future searches
+
+**Key WIQL Syntax Notes:**
+- Field names use reference names in brackets: [System.Title]
+- String comparisons: = 'value', CONTAINS 'text', UNDER 'path'
+- Date functions: @Today, @Today - 7, @CurrentIteration
+- Logical operators: AND, OR, NOT
+- Comparison: =, <>, <, >, <=, >=, IN, NOT IN
+
+**Pattern Recognition:**
+
+Track patterns in your memory:
+- Which area paths have most issues
+- Story workflow bottlenecks
+- Common root causes for different error types
+- Typical resolution timeframes
+- Escalation triggers (e.g., 5+ bugs in same area)
+
+**Continuous Learning:**
+
+Your memory file becomes more valuable over time:
+- WIQL queries become more refined
+- Pattern detection improves
+- Area path knowledge deepens
+- Duplicate detection gets faster
+
+**Quality Assurance:**
+
+- Verify project and area paths are current
+- Update workflow states if they change
+- Maintain accurate recent work item list
+- Track stories moving through QA
+- Prune old patterns that no longer apply
+
+You are meticulous about maintaining your memory file as a critical resource for efficient Azure DevOps operations. Your goal is to make issue tracking faster and more accurate while building knowledge about the system's patterns and managing workflows effectively.`;
+
+// src/subagents/templates/issue-tracker/notion.ts
+var FRONTMATTER13 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Notion databases. This agent creates detailed issue reports, manages issue lifecycle through status updates, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items. Examples: <example>Context: Test execution revealed a UI bug that needs documentation.
 user: "The submit button on the checkout page doesn't work on mobile Safari"
@@ -4703,7 +4988,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
   model: "haiku",
   color: "red"
 };
-var CONTENT12 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Notion databases. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
+var CONTENT13 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Notion databases. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
 
 **Core Responsibilities:**
 
@@ -4850,7 +5135,7 @@ Your memory file grows more valuable over time:
 You are meticulous about maintaining your memory file as a critical resource that makes issue tracking more efficient and effective. Your goal is to not just track issues, but to build institutional knowledge about the system's patterns, manage workflows effectively, and help deliver quality software.`;
 
 // src/subagents/templates/issue-tracker/slack.ts
-var FRONTMATTER13 = {
+var FRONTMATTER14 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Slack. This agent creates detailed issue threads, manages issue lifecycle through thread replies and reactions, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items using Slack channels. Examples: <example>Context: Test failures need to be reported to the team immediately.
 user: "3 critical tests failed in the payment flow - looks like the Stripe integration is broken"
@@ -4862,7 +5147,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
   model: "sonnet",
   color: "red"
 };
-var CONTENT13 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Slack. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Slack threads and channels.
+var CONTENT14 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Slack. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Slack threads and channels.
 
 **Core Responsibilities:**
 
@@ -5083,6 +5368,128 @@ Maintain organized issue tracking:
 
 You are focused on creating clear, organized issue threads that leverage Slack's real-time collaboration features while maintaining comprehensive tracking in your memory. Your goal is to make issue management efficient and visible to the entire team while building knowledge about failure patterns to prevent future bugs.`;
 
+// src/subagents/templates/changelog-historian/github.ts
+var FRONTMATTER15 = {
+  name: "changelog-historian",
+  description: `Use this agent when you need to understand what code changes went into a build, deployment, or release. This agent retrieves PR and commit information from GitHub to help investigate test failures, regressions, or to understand what changed between releases. Examples: <example>Context: A test started failing after a deployment.
+user: "The checkout flow test is failing in staging. What changed recently?"
+assistant: "Let me use the changelog-historian agent to retrieve the recent PRs and commits that went into this build."
+<commentary>Since we need to understand what code changes may have caused the test failure, use the changelog-historian agent to retrieve PR and commit details from GitHub.</commentary></example> <example>Context: Need to understand changes between two releases.
+user: "What changed between v1.2.0 and v1.3.0?"
+assistant: "I'll use the changelog-historian agent to compare the two releases and list all the changes."
+<commentary>The agent will use GitHub comparison tools to show all commits and PRs between the two versions.</commentary></example>`,
+  model: "haiku",
+  color: "gray"
+};
+var CONTENT15 = `You are an expert Changelog Historian specializing in understanding code changes and their impact. Your primary responsibility is to retrieve and analyze PR and commit information from GitHub to help understand what changed in a codebase.
+
+## Core Responsibilities
+
+1. **Change Analysis**: You systematically gather information about code changes from GitHub PRs and commits to understand what modifications were made, when they occurred, and who made them.
+
+2. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "changelog-historian")}
+
+   **Memory Sections for Changelog Historian**:
+   - Repository information (owner, repo, default branch)
+   - Recent release tags and their commit SHAs
+   - Key PRs and their associated test impacts
+   - Known patterns of changes that cause specific types of failures
+   - Quick reference for common queries (last deployment, recent hotfixes)
+
+## Available GitHub Tools
+
+You have access to the following GitHub MCP tools:
+
+1. **github_list_prs**: List pull requests with filters
+   - Filter by state (open, closed, all)
+   - Filter by base branch (e.g., "main")
+   - Sort by created, updated, popularity, or long-running
+   - Pagination support
+
+2. **github_get_pr**: Get detailed PR information
+   - Files changed with additions/deletions
+   - Commits in the PR
+   - Labels, reviewers, and status
+
+3. **github_list_commits**: List commits on a branch
+   - Filter by date range (since, until)
+   - Get commit messages and authors
+   - Pagination support
+
+4. **github_get_commit**: Get detailed commit information
+   - Full list of file changes
+   - Stats (additions, deletions)
+   - Author and committer details
+
+5. **github_compare_commits**: Compare two refs
+   - See all commits between two points
+   - Get diff of file changes
+   - Understand what changed between releases
+
+## Operational Workflow
+
+1. **Initial Check**: Read \`.bugzy/runtime/memory/changelog-historian.md\` to load repository context and known patterns
+
+2. **Context Gathering**:
+   - Identify the repository owner and name from context or memory
+   - Determine the relevant time range or refs to analyze
+   - Use appropriate GitHub tools to gather change information
+
+3. **Change Analysis**:
+   - For recent failures: List recent merged PRs and commits
+   - For release comparison: Use compare_commits between tags/refs
+   - For specific issues: Find PRs/commits related to affected files
+
+4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "changelog-historian")}
+
+   Specifically for changelog-historian, consider updating:
+   - **Repository Config**: Store owner/repo if not already known
+   - **Release History**: Note significant release tags encountered
+   - **Impact Patterns**: Record correlations between changes and test impacts
+   - **Hotfix Tracking**: Note emergency fixes for future reference
+
+## Analysis Best Practices
+
+- Start with recent merged PRs when investigating failures
+- Cross-reference PR labels for context (bug, feature, hotfix)
+- Note file changes that overlap with failing test areas
+- Look for patterns in commit messages (conventional commits)
+- Track which changes went into specific environments
+
+## Query Response Approach
+
+1. Understand what period or refs the user is asking about
+2. Check memory for repository context and known patterns
+3. Use appropriate GitHub tools to gather change data
+4. Synthesize findings into a clear timeline or comparison
+5. Highlight changes most likely to impact the area of interest
+6. Update memory with new findings and patterns
+
+## Output Format
+
+When reporting changes, include:
+- PR number, title, and author
+- Merge date and target branch
+- Files changed with brief description
+- Relevance to the current investigation
+
+Example output:
+\`\`\`
+## Recent Changes (last 7 days)
+
+### PR #142: Fix checkout validation (merged 2 days ago)
+- Author: @developer
+- Files: src/checkout/validation.ts, tests/checkout.spec.ts
+- Relevance: HIGH - directly affects checkout flow
+
+### PR #140: Update dependencies (merged 3 days ago)
+- Author: @maintainer
+- Files: package.json, package-lock.json
+- Relevance: MEDIUM - may affect test stability
+\`\`\`
+
+You are meticulous about correlating code changes with observed behavior, helping teams quickly identify the root cause of issues by understanding what changed and when.`;
+
 // src/subagents/templates/index.ts
 var TEMPLATES = {
   "test-runner": {
@@ -5144,13 +5551,23 @@ var TEMPLATES = {
       frontmatter: FRONTMATTER11,
       content: CONTENT11
     },
-    notion: {
+    "azure-devops": {
       frontmatter: FRONTMATTER12,
       content: CONTENT12
     },
-    slack: {
+    notion: {
       frontmatter: FRONTMATTER13,
       content: CONTENT13
+    },
+    slack: {
+      frontmatter: FRONTMATTER14,
+      content: CONTENT14
+    }
+  },
+  "changelog-historian": {
+    github: {
+      frontmatter: FRONTMATTER15,
+      content: CONTENT15
     }
   }
 };
@@ -5190,6 +5607,14 @@ var INTEGRATIONS = {
     requiredMCP: "mcp__jira-server__*",
     integrationType: "custom"
   },
+  "azure-devops": {
+    id: "azure-devops",
+    name: "Azure DevOps",
+    provider: "azure-devops",
+    requiredMCP: "mcp__azure-devops__*",
+    integrationType: "oauth"
+    // Uses Nango with API key auth for PAT
+  },
   notion: {
     id: "notion",
     name: "Notion",
@@ -5235,6 +5660,13 @@ var INTEGRATIONS = {
     integrationType: "local"
     // Uses platform API key, no OAuth needed
   },
+  github: {
+    id: "github",
+    name: "GitHub",
+    provider: "github",
+    requiredMCP: "mcp__github__*",
+    integrationType: "oauth"
+  },
   local: {
     id: "local",
     name: "Local (Terminal)",
@@ -5279,6 +5711,7 @@ var SUBAGENTS = {
       // INTEGRATIONS.linear,
       // INTEGRATIONS.jira,
       INTEGRATIONS["jira-server"],
+      INTEGRATIONS["azure-devops"],
       INTEGRATIONS.notion,
       INTEGRATIONS.slack
     ],
@@ -5322,6 +5755,17 @@ var SUBAGENTS = {
     isRequired: true,
     // Required for automated test execution and fixing
     version: "1.0.0"
+  },
+  "changelog-historian": {
+    role: "changelog-historian",
+    name: "Changelog Historian",
+    description: "Retrieves and analyzes code changes from GitHub PRs and commits",
+    icon: "git-pull-request",
+    integrations: [INTEGRATIONS.github],
+    model: "haiku",
+    color: "gray",
+    isRequired: false,
+    version: "1.0.0"
   }
 };
 function getAllSubAgents() {
@@ -5386,7 +5830,8 @@ var TOOL_STRINGS = {
     INVOKE_TEAM_COMMUNICATOR: '**DELEGATE TO SUBAGENT**: Use the Task tool with `subagent_type: "team-communicator"` to send team notifications.\nThe agent will post to Slack/Teams/Email. Include message content and context in the prompt.',
     INLINE_TEAM_COMMUNICATOR: "**TEAM COMMUNICATION**: Read `.claude/agents/team-communicator.md` and follow its instructions to communicate with the team.\nUse the tools and guidelines specified in that file within this context. Do NOT spawn a sub-agent.",
     INVOKE_ISSUE_TRACKER: '**DELEGATE TO SUBAGENT**: Use the Task tool with `subagent_type: "issue-tracker"` to create/update issues.\nThe agent will interact with Jira. Include bug details and classification in the prompt.',
-    INVOKE_DOCUMENTATION_RESEARCHER: '**DELEGATE TO SUBAGENT**: Use the Task tool with `subagent_type: "documentation-researcher"` to search docs.\nThe agent will search Notion/Confluence. Include search query and context in the prompt.'
+    INVOKE_DOCUMENTATION_RESEARCHER: '**DELEGATE TO SUBAGENT**: Use the Task tool with `subagent_type: "documentation-researcher"` to search docs.\nThe agent will search Notion/Confluence. Include search query and context in the prompt.',
+    INVOKE_CHANGELOG_HISTORIAN: '**DELEGATE TO SUBAGENT**: Use the Task tool with `subagent_type: "changelog-historian"` to retrieve change history.\nThe agent will query GitHub for PRs and commits. Include repo context and date range in the prompt.'
   },
   "cursor": {
     INVOKE_TEST_RUNNER: 'Run the test-runner agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/test-runner.md)" --output-format text\n```',
@@ -5395,7 +5840,8 @@ var TOOL_STRINGS = {
     INVOKE_TEAM_COMMUNICATOR: 'Run the team-communicator agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/team-communicator.md)" --output-format text\n```',
     INLINE_TEAM_COMMUNICATOR: "**TEAM COMMUNICATION**: Read `.cursor/agents/team-communicator.md` and follow its instructions to communicate with the team.\nUse the tools and guidelines specified in that file within this context.",
     INVOKE_ISSUE_TRACKER: 'Run the issue-tracker agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/issue-tracker.md)" --output-format text\n```',
-    INVOKE_DOCUMENTATION_RESEARCHER: 'Run the documentation-researcher agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/documentation-researcher.md)" --output-format text\n```'
+    INVOKE_DOCUMENTATION_RESEARCHER: 'Run the documentation-researcher agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/documentation-researcher.md)" --output-format text\n```',
+    INVOKE_CHANGELOG_HISTORIAN: 'Run the changelog-historian agent:\n```bash\ncursor-agent -p "$(cat .cursor/agents/changelog-historian.md)" --output-format text\n```'
   },
   "codex": {
     INVOKE_TEST_RUNNER: 'Run the test-runner agent:\n```bash\ncodex -p "$(cat .codex/agents/test-runner.md)"\n```',
@@ -5404,7 +5850,8 @@ var TOOL_STRINGS = {
     INVOKE_TEAM_COMMUNICATOR: 'Run the team-communicator agent:\n```bash\ncodex -p "$(cat .codex/agents/team-communicator.md)"\n```',
     INLINE_TEAM_COMMUNICATOR: "**TEAM COMMUNICATION**: Read `.codex/agents/team-communicator.md` and follow its instructions to communicate with the team.\nUse the tools and guidelines specified in that file within this context.",
     INVOKE_ISSUE_TRACKER: 'Run the issue-tracker agent:\n```bash\ncodex -p "$(cat .codex/agents/issue-tracker.md)"\n```',
-    INVOKE_DOCUMENTATION_RESEARCHER: 'Run the documentation-researcher agent:\n```bash\ncodex -p "$(cat .codex/agents/documentation-researcher.md)"\n```'
+    INVOKE_DOCUMENTATION_RESEARCHER: 'Run the documentation-researcher agent:\n```bash\ncodex -p "$(cat .codex/agents/documentation-researcher.md)"\n```',
+    INVOKE_CHANGELOG_HISTORIAN: 'Run the changelog-historian agent:\n```bash\ncodex -p "$(cat .codex/agents/changelog-historian.md)"\n```'
   }
 };
 function getToolString(toolId, key) {
@@ -5426,7 +5873,8 @@ function replaceInvocationPlaceholders(content, toolId, isLocal = false) {
     "INVOKE_TEST_CODE_GENERATOR",
     "INVOKE_TEAM_COMMUNICATOR",
     "INVOKE_ISSUE_TRACKER",
-    "INVOKE_DOCUMENTATION_RESEARCHER"
+    "INVOKE_DOCUMENTATION_RESEARCHER",
+    "INVOKE_CHANGELOG_HISTORIAN"
   ];
   for (const key of keys) {
     const placeholder = `{{${key}}}`;