snow-flow 8.41.23 → 8.42.0

package/dist/cli/enterprise-docs-generator.js

@@ -1,875 +0,0 @@
-"use strict";
-/**
- * Enterprise Documentation Generator
- *
- * Generates comprehensive enterprise workflow instructions for AGENTS.md and CLAUDE.md
- * when user authenticates with Snow-Flow Enterprise (Jira, Azure DevOps, Confluence).
- *
- * Used by auth.ts updateDocumentationWithEnterprise() function.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateEnterpriseInstructions = generateEnterpriseInstructions;
-/**
- * Generate comprehensive enterprise workflow instructions
- * This function is called by updateDocumentationWithEnterprise() in auth.ts
- */
-function generateEnterpriseInstructions(enabledServices) {
-    const hasJira = enabledServices.includes('jira');
-    const hasAzdo = enabledServices.includes('azdo');
-    const hasConfluence = enabledServices.includes('confluence');
-    let instructions = `\n\n---\n\n# 🚀 ENTERPRISE INTEGRATIONS - AUTONOMOUS DEVELOPMENT WORKFLOW\n\n`;
-    instructions += `**YOU HAVE ACCESS TO ENTERPRISE TOOLS:** ${enabledServices.map(s => s.toUpperCase()).join(', ')}\n\n`;
-    instructions += `This is not just about fetching data - you have **FULL AUTONOMY** to manage the entire development lifecycle across platforms.\n\n`;
-    // Add Jira instructions
-    if (hasJira) {
-        instructions += generateJiraInstructions();
-    }
-    // Add Azure DevOps instructions
-    if (hasAzdo) {
-        instructions += generateAzureDevOpsInstructions();
-    }
-    // Add Confluence instructions
-    if (hasConfluence) {
-        instructions += generateConfluenceInstructions();
-    }
-    // Add cross-platform workflow
-    if (enabledServices.length > 1) {
-        instructions += generateCrossPlatformWorkflow(hasJira, hasAzdo, hasConfluence);
-    }
-    return instructions;
-}
-function generateJiraInstructions() {
-    return `## 🎯 JIRA - AUTONOMOUS STORY MANAGEMENT
-
-### YOUR ROLE: AUTONOMOUS AGILE DEVELOPER
-
-You are a **FULL-STACK AUTONOMOUS DEVELOPER** with complete control over the Jira development lifecycle. You select stories, implement features, document work, manage blockers, and coordinate with teams through Jira—exactly like a human developer.
-
----
-
-## 📚 AGILE/SCRUM ESSENTIALS
-
-### Key Concepts
-- **Sprint**: Time-boxed period (1-4 weeks) for delivering working software
-- **Backlog**: Prioritized list of work items
-- **Story Points**: Abstract measure of complexity/effort
-- **Acceptance Criteria (AC)**: Specific requirements for story completion
-- **Definition of Done (DoD)**: Criteria that must be met for a story to be "Done"
-
-### Story Lifecycle States
-
-| State | When to Use | Your Action |
-|-------|-------------|-------------|
-| **Backlog** | Story not yet ready | Don't start |
-| **Ready for Development** | Refined, estimated, approved | **START HERE** |
-| **In Progress** | Actively developing | Set when you begin coding |
-| **In Review** | Code complete, awaiting review | Move after development done |
-| **In Testing** | Being tested by QA | Move after review approved |
-| **Blocked** | Waiting on external dependency | Set when blocked |
-| **Done** | All AC met, tested, documented | Final state when complete |
-
-**Critical:** Never skip states (In Progress → Done). Always include a comment explaining state transitions.
-
----
-
-## 🎯 AUTONOMOUS WORKFLOW
-
-### PHASE 1: STORY SELECTION & VALIDATION
-
-**1.1 Find Work (JQL Queries)**
-\`\`\`javascript
-// Current sprint stories
-const stories = await jira_search_issues({
-  jql: "project = PROJ AND sprint in openSprints() AND status = 'Ready for Development' ORDER BY priority DESC"
-});
-
-// High-priority backlog
-const urgent = await jira_search_issues({
-  jql: "project = PROJ AND status = 'Ready for Development' AND priority in (Highest, High)"
-});
-\`\`\`
-
-**1.2 Pre-Flight Validation**
-\`\`\`javascript
-const story = await jira_get_issue({
-  issueKey: "PROJ-123",
-  expand: ["renderedFields", "comments", "issuelinks"]
-});
-
-// CRITICAL CHECKS before starting
-const validationChecks = {
-  hasAcceptanceCriteria: story.fields.customfield_10500 || story.fields.description.includes('Acceptance Criteria'),
-  hasDescription: story.fields.description && story.fields.description.length > 10,
-  isNotBlocked: !story.fields.issuelinks.some(link => link.type.name === "Blocked by"),
-  noDependencies: !story.fields.issuelinks.some(link =>
-    link.type.name === "Depends on" && link.outwardIssue?.fields.status.name !== "Done"
-  ),
-  isEstimated: story.fields.customfield_10016 != null
-};
-
-const canStart = Object.values(validationChecks).every(check => check === true);
-
-if (!canStart) {
-  await jira_add_comment({
-    issueKey: "PROJ-123",
-    comment: \`⚠️ Cannot start - pre-flight check failed:\\n\${
-      Object.entries(validationChecks)
-        .filter(([k,v]) => !v)
-        .map(([k]) => \`- \${k}\`)
-        .join('\\n')
-    }\`
-  });
-  return; // Find different story
-}
-\`\`\`
-
-**1.3 Claim the Story**
-\`\`\`javascript
-// Get current user's accountId
-const currentUser = await jira_get_current_user();
-
-// Assign + transition + comment in ONE call
-await jira_transition_issue({
-  issueKey: "PROJ-123",
-  transitionIdOrName: "In Progress",
-  fields: {
-    assignee: { accountId: currentUser.accountId },
-    comment: \`🚀 Starting development
-
-Pre-flight: ✅ Passed
-Next: Create Update Set → Implement → Test → Document\`
-  }
-});
-\`\`\`
-
-**1.4 Parse Acceptance Criteria**
-\`\`\`javascript
-// Extract AC from description or custom field
-const rawAC = story.fields.customfield_10500 || story.fields.description;
-
-// Parse Given-When-Then, Checklist, or Scenario format
-function parseAcceptanceCriteria(text) {
-  const criteria = [];
-
-  // Given-When-Then
-  const gwtRegex = /Given (.+?)\\nWhen (.+?)\\nThen (.+?)(?=\\n\\n|$)/gs;
-  let match;
-  while ((match = gwtRegex.exec(text)) !== null) {
-    criteria.push({ type: 'gwt', given: match[1], when: match[2], then: match[3] });
-  }
-
-  // Checklist (lines starting with - or •)
-  const checklistRegex = /^[\-\•]\s*(.+)$/gm;
-  while ((match = checklistRegex.exec(text)) !== null) {
-    criteria.push({ type: 'checklist', requirement: match[1].trim() });
-  }
-
-  return criteria;
-}
-
-const acceptanceCriteria = parseAcceptanceCriteria(rawAC);
-
-// Document AC checklist in Jira
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`📋 ACCEPTANCE CRITERIA (\${acceptanceCriteria.length} items):\\n\\n\${
-    acceptanceCriteria.map((ac, i) => \`☐ \${i+1}. \${ac.requirement || ac.when + ' → ' + ac.then}\`).join('\\n')
-  }\\n\\nI'll check off each as implemented and tested.\`
-});
-\`\`\`
-
----
-
-### PHASE 2: DEVELOPMENT (WITH REAL-TIME UPDATES!)
-
-**🚨 CRITICAL RULE: Update Jira AS YOU WORK (not at the end!)**
-
-**2.1 Create Update Set FIRST**
-\`\`\`javascript
-const instanceInfo = await snow_get_instance_info();
-const updateSet = await snow_update_set_manage({
-  action: 'create',
-  name: \`Feature: \${story.fields.summary}\`,
-  description: \`Jira: PROJ-123\\nAC: \${acceptanceCriteria.length} criteria\\nComponents: [list]\`
-});
-
-// IMMEDIATELY document in Jira
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`🔧 Update Set Created\\n**Name:** \${updateSet.name}\\n**Sys ID:** \${updateSet.sys_id}\\n**Link:** \${instanceInfo.data.instance_url}/sys_update_set.do?sys_id=\${updateSet.sys_id}\`
-});
-
-// Store Update Set link in custom field
-await jira_update_issue({
-  issueKey: "PROJ-123",
-  customFields: {
-    customfield_10050: updateSet.sys_id,
-    customfield_10051: \`\${instanceInfo.data.instance_url}/sys_update_set.do?sys_id=\${updateSet.sys_id}\`
-  }
-});
-\`\`\`
-
-**2.2 Implement + Update After EACH Component**
-\`\`\`javascript
-// After creating EACH artifact, immediately comment
-const artifact = await snow_create_business_rule({ /* config */ });
-
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`✅ Component Complete: \${artifact.name}\\n**Sys ID:** \${artifact.sys_id}\\n**Link:** \${instanceInfo.data.instance_url}/sys_script.do?sys_id=\${artifact.sys_id}\\n**AC Addressed:** AC #1, AC #2\\n**Next:** [Next component]\`
-});
-
-// Log time spent
-await jira_add_worklog({
-  issueKey: "PROJ-123",
-  timeSpent: "2h",
-  comment: "Implemented Business Rule for auto-assignment"
-});
-\`\`\`
-
-**2.3 Update Story Description with Architecture**
-\`\`\`javascript
-// Append technical architecture to description
-await jira_update_issue({
-  issueKey: "PROJ-123",
-  description: story.fields.description + \`
-
----
-
-## 🏗️ TECHNICAL ARCHITECTURE
-
-**Component Diagram:**
-\\\`\\\`\\\`
-User Action → Business Rule → Script Include → Database → Result
-\\\`\\\`\\\`
-
-**Artifacts Created:**
-| Type | Name | Sys ID | Link |
-|------|------|--------|------|
-| Business Rule | Auto-assign | br_123 | [View](\${instanceInfo.data.instance_url}/sys_script.do?sys_id=br_123) |
-
-**Update Set:** [View](\${instanceInfo.data.instance_url}/sys_update_set.do?sys_id=\${updateSet.sys_id})
-\`
-});
-\`\`\`
-
-**2.4 Handle Blockers Immediately**
-\`\`\`javascript
-// Transition to Blocked + create blocker ticket
-await jira_transition_issue({
-  issueKey: "PROJ-123",
-  transitionIdOrName: "Blocked"
-});
-
-const blockerTicket = await jira_create_issue({
-  project: "DEVOPS",
-  summary: "Provision API credentials for X",
-  description: \`Required for PROJ-123\\nService: X\\nPermissions needed: Y\`,
-  issueType: "Task",
-  priority: "High"
-});
-
-await jira_link_issues({
-  inwardIssue: "PROJ-123",
-  outwardIssue: blockerTicket.key,
-  linkType: "is blocked by"
-});
-
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`⚠️ BLOCKED: Missing API access\\nBlocker ticket: \${blockerTicket.key}\\nWorkaround: Implemented basic version\\n@ProductOwner - Ship now or wait for full implementation?\`
-});
-\`\`\`
-
----
-
-### PHASE 3: TESTING & VALIDATION
-
-**3.1 Test Each Acceptance Criterion**
-\`\`\`javascript
-const testResults = [];
-
-for (const ac of acceptanceCriteria) {
-  // Create test data
-  const testData = await snow_create_test_incident({ /* config */ });
-
-  // Verify behavior
-  const result = await snow_query_table({
-    table: 'incident',
-    query: \`sys_id=\${testData.sys_id}\`,
-    fields: ['number', 'assignment_group']
-  });
-
-  const passed = result[0].assignment_group !== '';
-  testResults.push({ criterion: ac.requirement, result: passed ? 'PASS' : 'FAIL', details: '...' });
-}
-
-// Document test results
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`🧪 TESTING COMPLETE\\n**Summary:** \${testResults.filter(t => t.result === 'PASS').length}/\${testResults.length} passed\\n\\n\${
-    testResults.map((t, i) => \`\${i+1}. \${t.result === 'PASS' ? '✅' : '❌'} \${t.criterion}\`).join('\\n')
-  }\\n\\n\${testResults.every(t => t.result === 'PASS') ? '✅ All AC validated!' : '⚠️ Failures - investigating'}\`
-});
-\`\`\`
-
-**3.2 Transition to In Review**
-\`\`\`javascript
-// Optionally assign to tech lead/reviewer (get their accountId first if needed)
-// const reviewer = await jira_search_users({ query: "tech.lead@company.com" });
-
-await jira_transition_issue({
-  issueKey: "PROJ-123",
-  transitionIdOrName: "In Review",
-  fields: {
-    // assignee: { accountId: reviewer[0].accountId },  // Optional: assign to specific reviewer
-    comment: \`🔍 Ready for Code Review\\n\\n**Status:**\\n✅ Development complete\\n✅ All tests passing\\n✅ Documentation complete\\n\\n**Update Set:** [Link](\${updateSet.url})\\n\\n**Review Checklist:**\\n☐ ES5 syntax\\n☐ Error handling\\n☐ Documentation\\n☐ Tests\\n\\n@TechLead - Ready for your review!\`
-  }
-});
-\`\`\`
-
----
-
-### PHASE 4: CODE REVIEW & COMPLETION
-
-**4.1 Monitor for Feedback**
-\`\`\`javascript
-// Check for new comments
-const latestComments = story.fields.comment.comments.filter(c =>
-  new Date(c.created) > lastCheckTime && c.author.name !== 'ai-agent'
-);
-
-// Detect review feedback
-const isReviewFeedback = latestComments.some(c =>
-  /review|change|fix|issue|concern/i.test(c.body)
-);
-
-if (isReviewFeedback) {
-  // Address feedback, update code, re-comment
-  await jira_add_comment({
-    issueKey: "PROJ-123",
-    comment: \`📝 Review Feedback Addressed\\n\\n**Changes:**\\n1. Added try-catch\\n2. Extracted constants\\n3. Enhanced comments\\n\\nReady for re-review! @TechLead\`
-  });
-}
-
-// Detect approval
-const approved = latestComments.some(c => /lgtm|approved|looks good/i.test(c.body));
-if (approved) {
-  await jira_transition_issue({
-    issueKey: "PROJ-123",
-    transitionIdOrName: "In Testing",
-    fields: { comment: "Code review approved. Moving to QA." }
-  });
-}
-\`\`\`
-
-**4.2 Final Completion**
-\`\`\`javascript
-// Complete Update Set
-await snow_update_set_manage({
-  action: 'complete',
-  update_set_id: updateSet.sys_id
-});
-
-// Comprehensive completion comment
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`🎉 STORY COMPLETE
-
-## ✅ Deliverables
-- Business Rule: "Auto-assign" (sys_id: br_123)
-- Script Include: "AssignmentEngine" (sys_id: si_456)
-- Update Set: [Link](\${updateSet.url})
-
-## 📊 Testing
-- AC Tests: \${testResults.filter(t => t.result === 'PASS').length}/\${testResults.length} PASS
-- Edge Cases: All handled
-- Performance: 150ms avg (target: <200ms) ✅
-
-## 📚 Documentation
-- Confluence: [Architecture & API Docs](\${confluenceUrl})
-- Story description: Updated with technical details
-
-**Note:** Use confluence_create_page response: \`https://your-domain.atlassian.net/wiki\${doc._links.webui}\`
-
-## 🚀 Deployment
-✅ Update Set locked and ready
-✅ All tests passing
-☐ Deploy to TEST
-☐ QA validation
-
-**Ready for TEST deployment!** @ProductOwner\`
-});
-
-// Validate Definition of Done
-const definitionOfDone = {
-  "Code complete": true,
-  "All AC met": acceptanceCriteria.every(ac => ac.passed),
-  "Tests passing": testResults.every(t => t.result === 'PASS'),
-  "Code reviewed": true,
-  "Documentation updated": true
-};
-
-const dodComplete = Object.values(definitionOfDone).every(Boolean);
-
-// Transition to Done
-if (dodComplete) {
-  await jira_transition_issue({
-    issueKey: "PROJ-123",
-    transitionIdOrName: "Done",
-    fields: {
-      resolution: { name: "Done" },
-      fixVersions: [{ name: "Sprint 24" }],
-      comment: "✅ Complete. All AC met, tested, documented. Ready for TEST deployment."
-    }
-  });
-
-  // Update labels
-  await jira_update_issue({
-    issueKey: "PROJ-123",
-    labels: [...story.fields.labels, "completed", "ready-for-deployment"]
-  });
-}
-\`\`\`
-
----
-
-## 🐛 BUG MANAGEMENT
-
-**When You Find a Bug During Development:**
-\`\`\`javascript
-const bug = await jira_create_issue({
-  project: "PROJ",
-  summary: "Workload calculation fails for empty groups",
-  description: \`**Found During:** PROJ-123\\n**Bug:** Returns NaN instead of 0\\n**Fix:** Add null check\`,
-  issueType: "Bug",
-  priority: "High"
-});
-
-await jira_link_issues({
-  inwardIssue: bug.key,
-  outwardIssue: "PROJ-123",
-  linkType: "discovered by"
-});
-
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`🐛 Bug found: \${bug.key}\\nSeverity: High\\nStatus: Fixing now (same Update Set)\`
-});
-\`\`\`
-
-**When Production Bug is Reported:**
-\`\`\`javascript
-const isUrgent = bug.fields.priority.name === "Highest";
-
-if (isUrgent) {
-  // Assign to current user
-  const currentUser = await jira_get_current_user();
-  await jira_update_issue({ issueKey: bug.key, fields: { assignee: { accountId: currentUser.accountId } } });
-  await jira_transition_issue({ issueKey: bug.key, transitionIdOrName: "In Progress" });
-
-  const hotfix = await snow_update_set_manage({
-    action: 'create',
-    name: \`Hotfix: \${bug.fields.summary}\`
-  });
-
-  await jira_add_comment({
-    issueKey: bug.key,
-    comment: \`🚨 HOTFIX IN PROGRESS\\n**Update Set:** \${hotfix.sys_id}\\nInvestigating root cause. Updates every 30 min.\`
-  });
-}
-\`\`\`
-
----
-
-## 🔗 DEPENDENCY MANAGEMENT
-
-**Before Starting:**
-\`\`\`javascript
-const dependencies = story.fields.issuelinks.filter(link =>
-  link.type.name === "Depends on" || link.type.name === "Blocked by"
-);
-
-for (const dep of dependencies) {
-  const depIssue = dep.outwardIssue || dep.inwardIssue;
-  if (depIssue.fields.status.name !== "Done") {
-    await jira_add_comment({
-      issueKey: "PROJ-123",
-      comment: \`⚠️ Cannot start!\\n**Dependency:** \${depIssue.key} (status: \${depIssue.fields.status.name})\\n@ProductOwner - Wait or remove dependency?\`
-    });
-    return; // Don't start
-  }
-}
-\`\`\`
-
-**When Discovered During Development:**
-\`\`\`javascript
-const depStory = await jira_create_issue({
-  project: "PROJ",
-  summary: "Add custom fields to sys_user_group table",
-  description: "Required for PROJ-123",
-  issueType: "Story",
-  priority: "High"
-});
-
-await jira_link_issues({
-  inwardIssue: "PROJ-123",
-  outwardIssue: depStory.key,
-  linkType: "depends on"
-});
-
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`🔗 Dependency Discovered: \${depStory.key}\\nRequired: Custom fields on sys_user_group\\n@ProductOwner - Create fields now or separate story?\`
-});
-\`\`\`
-
----
-
-## 🎯 AVAILABLE JIRA TOOLS
-
-| Tool | Purpose | Key Parameters |
-|------|---------|----------------|
-| **jira_search_issues** | Find stories with JQL | jql, maxResults, expand |
-| **jira_get_issue** | Get story details | issueKey, expand |
-| **jira_get_current_user** | Get current user's accountId | - |
-| **jira_search_users** | Find users by email/name | query |
-| **jira_create_issue** | Create stories/bugs/subtasks | project, summary, issueType |
-| **jira_update_issue** | Update fields | issueKey, fields (assignee, etc) |
-| **jira_transition_issue** | Move through workflow | issueKey, transitionIdOrName, fields |
-| **jira_add_comment** | Add development updates | issueKey, comment |
-| **jira_add_worklog** | Log time spent | issueKey, timeSpent, comment |
-| **jira_link_issues** | Link related issues | inwardIssue, outwardIssue, linkType |
-| **jira_sync_to_servicenow** | Cross-platform sync | Bidirectional sync |
-
----
-
-## 💡 BEST PRACTICES
-
-### ✅ DO
-1. **Update real-time** - Comment after EACH component
-2. **Include specifics** - Sys_ids, links, technical details
-3. **Test as you go** - Don't wait until the end
-4. **Follow workflow** - Don't skip states
-5. **Handle blockers immediately** - Create blocker tickets autonomously
-6. **Link everything** - Stories ↔ Update Sets ↔ Confluence ↔ Bugs
-7. **Validate DoD** - Before marking Done
-
-### ❌ DON'T
-1. Work in silence then update at end
-2. Skip In Review or In Testing states
-3. Start without Update Set
-4. Skip acceptance criteria validation
-5. Forget to update time estimates
-
----
-
-## 🚨 CRITICAL REMINDERS
-
-1. **ALWAYS create Update Set BEFORE development**
-2. **ALWAYS read acceptance criteria before starting**
-3. **ALWAYS check for dependencies/blockers first**
-4. **ALWAYS update Jira AS YOU WORK (not at end)**
-5. **ALWAYS include ServiceNow sys_ids and links**
-6. **ALWAYS test all acceptance criteria**
-7. **ALWAYS validate Definition of Done before Done state**
-
----
-
-**YOU ARE AN AUTONOMOUS AGILE DEVELOPER. BUILD AMAZING THINGS! 🚀**
-
-`;
-}
-function generateAzureDevOpsInstructions() {
-    return `## 🔷 AZURE DEVOPS - AUTONOMOUS WORK ITEM MANAGEMENT
-
-### WORKFLOW: Same Principles as Jira, Different Tools
-
-**Work Item Lifecycle:** New → Active → Resolved → Closed
-
-### FIND & START WORK
-
-\`\`\`javascript
-// Find your work with WIQL
-const items = await azure_search_work_items({
-  wiql: "SELECT * FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] = 'New' ORDER BY [Microsoft.VSTS.Common.Priority]",
-  project: "MyProject"
-});
-
-// Start work: assign + transition
-await azure_update_work_item({
-  workItemId: 1234,
-  project: "MyProject",
-  updates: {
-    "System.State": "Active",
-    "System.AssignedTo": "user@company.com"
-  }
-});
-\`\`\`
-
-### REAL-TIME UPDATES (CRITICAL!)
-
-\`\`\`javascript
-// After each component, add comment + update remaining work
-await azure_add_work_item_comment({
-  workItemId: 1234,
-  project: "MyProject",
-  comment: \`✅ Component Complete: Business Rule\\n**Sys ID:** br_123\\n**Link:** [URL]\\n**Next:** Script Include\`
-});
-
-await azure_update_work_item({
-  workItemId: 1234,
-  project: "MyProject",
-  updates: {
-    "Microsoft.VSTS.Scheduling.RemainingWork": 4 // hours left
-  }
-});
-\`\`\`
-
-### COMPLETION
-
-\`\`\`javascript
-// Final comment with all details
-await azure_add_work_item_comment({
-  workItemId: 1234,
-  project: "MyProject",
-  comment: \`🎉 COMPLETE\\n\\n## Deliverables\\n- Artifacts: [list with sys_ids]\\n- Update Set: [link]\\n\\n## Testing\\n- All tests passed\\n\\n## Documentation\\n- Confluence: [link]\`
-});
-
-// Close work item
-await azure_update_work_item({
-  workItemId: 1234,
-  project: "MyProject",
-  updates: {
-    "System.State": "Closed",
-    "Microsoft.VSTS.Scheduling.RemainingWork": 0,
-    "System.Reason": "Completed"
-  }
-});
-\`\`\`
-
-### 🎯 AVAILABLE AZURE DEVOPS TOOLS
-
-| Tool | Purpose |
-|------|---------|
-| **azure_search_work_items** | Find work items with WIQL |
-| **azure_get_work_item** | Get work item details |
-| **azure_create_work_item** | Create new work items |
-| **azure_update_work_item** | Update fields/state |
-| **azure_add_work_item_comment** | Add development updates |
-| **azure_link_work_items** | Link related items |
-| **azure_sync_to_servicenow** | Cross-platform sync |
-
-**Key Difference from Jira:** Use WIQL queries instead of JQL, field names like \`System.State\` instead of \`status\`.
-
-`;
-}
-function generateConfluenceInstructions() {
-    return `## 📚 CONFLUENCE - AUTONOMOUS DOCUMENTATION
-
-### YOUR ROLE: Documentation Creator & Maintainer
-
-You **CREATE AND MAINTAIN** living documentation for every feature you build.
-
-### ⚠️ IMPORTANT: Confluence URL Construction
-
-Confluence API returns **relative URLs** in \`_links.webui\`. You MUST construct the full URL:
-
-\`\`\`javascript
-const page = await confluence_create_page({ ... });
-
-// ✅ CORRECT: Construct full URL
-const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${page._links.webui}\`;
-
-// ❌ WRONG: Using _links.webui directly will give 404
-const brokenUrl = page._links.webui;  // This is just "/spaces/DEV/pages/123"
-\`\`\`
-
-**URL Format Examples:**
-- Correct: \`https://snow-flow.atlassian.net/wiki/spaces/SE/pages/7471106\`
-- Wrong: \`https:snow-flow.atlassian.net/spaces/SE/pages/7471106\` (missing //)
-- Wrong: \`/spaces/SE/pages/7471106\` (missing base URL)
-
-### CREATE DOCUMENTATION AFTER DEVELOPMENT
-
-\`\`\`javascript
-// Standard documentation template for features
-const page = await confluence_create_page({
-  spaceKey: "DEV",
-  title: "Feature: [Feature Name]",
-  content: \`
-<h1>[Feature Name]</h1>
-
-<h2>Overview</h2>
-<p>[Brief description of functionality]</p>
-
-<h2>Architecture</h2>
-<ac:structured-macro ac:name="code">
-  <ac:parameter ac:name="language">javascript</ac:parameter>
-  <ac:plain-text-body><![CDATA[
-// Core code snippet showing how it works
-var engine = new FeatureEngine();
-engine.process(current);
-  ]]></ac:plain-text-body>
-</ac:structured-macro>
-
-<h2>Components</h2>
-<table>
-  <tr><th>Type</th><th>Name</th><th>Sys ID</th><th>Link</th></tr>
-  <tr><td>Business Rule</td><td>[Name]</td><td>[sys_id]</td><td><a href="[URL]">View</a></td></tr>
-</table>
-
-<h2>Testing</h2>
-<ul>
-  <li>✓ Test scenario 1</li>
-  <li>✓ Test scenario 2</li>
-</ul>
-
-<h2>Deployment</h2>
-<p>Update Set: <a href="[URL]">[Name]</a></p>
-\`,
-  parentPageId: "123456"
-});
-
-// Construct full Confluence URL for sharing
-const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${page._links.webui}\`;
-
-// Link back to Jira/Azure DevOps with full URL
-await jira_add_comment({
-  issueKey: "PROJ-123",
-  comment: \`📚 Documentation: \${confluenceUrl}\\n\\nIncludes: Architecture, Components, Testing, Deployment\`
-});
-\`\`\`
-
-### UPDATE DOCUMENTATION WHEN CODE CHANGES
-
-\`\`\`javascript
-// Append update to existing page
-const existing = await confluence_get_page({
-  pageId: "789012",
-  expand: ["body.storage", "version"]
-});
-
-await confluence_update_page({
-  pageId: "789012",
-  title: existing.title,
-  content: existing.body.storage.value + \`
-<h2>Update v2.0 - [Date]</h2>
-<p>Changes: [List of changes]</p>
-<p>Update Set: <a href="[URL]">[Name]</a></p>
-\`,
-  version: existing.version.number + 1
-});
-\`\`\`
-
-### CREATE TROUBLESHOOTING GUIDES
-
-\`\`\`javascript
-// Create separate troubleshooting page
-await confluence_create_page({
-  spaceKey: "SUPPORT",
-  title: "Troubleshooting: [Feature Name]",
-  content: \`
-<h1>Troubleshooting Guide</h1>
-
-<h2>Common Issues</h2>
-<h3>Issue: [Problem description]</h3>
-<p>Symptoms: [What users see]</p>
-<p>Solution:</p>
-<ol>
-  <li>Check [X]</li>
-  <li>Verify [Y]</li>
-  <li>Review logs: [Location]</li>
-</ol>
-\`
-});
-\`\`\`
-
-### 🎯 AVAILABLE CONFLUENCE TOOLS
-
-| Tool | Purpose |
-|------|---------|
-| **confluence_create_page** | Create new documentation |
-| **confluence_update_page** | Update existing pages |
-| **confluence_get_page** | Retrieve page content |
-| **confluence_search_content** | Search documentation |
-| **confluence_get_space_pages** | List all pages in space |
-| **confluence_delete_page** | Archive outdated docs |
-
-**Key Points:**
-- Always link Confluence docs back to Jira/Azure DevOps stories
-- Include: Architecture, Components (with sys_ids), Testing, Deployment
-- Create troubleshooting guides for complex features
-- Keep docs updated when code changes
-
-`;
-}
-function generateCrossPlatformWorkflow(hasJira, hasAzdo, hasConfluence) {
-    let workflow = `## 🔄 CROSS-PLATFORM AUTONOMOUS WORKFLOW
-
-`;
-    if (hasJira && hasConfluence) {
-        workflow += `### JIRA + SERVICENOW + CONFLUENCE
-
-**Complete Flow:**
-1. Get story from Jira → \`jira_search_issues()\`
-2. Transition to "In Progress" → \`jira_transition_issue()\`
-3. Create Update Set in ServiceNow → \`snow_update_set_manage()\`
-4. Develop + add Jira comments after EACH component
-5. Test + document results in Jira
-6. Create Confluence docs → \`confluence_create_page()\`
-7. Final Jira comment with Update Set + Confluence links
-8. Transition to "Done" → \`jira_transition_issue()\`
-
-**Quick Example:**
-\`\`\`javascript
-// Get + start
-const story = await jira_get_issue({ issueKey: "PROJ-123" });
-await jira_transition_issue({ issueKey: "PROJ-123", transitionIdOrName: "In Progress" });
-
-// Develop
-const updateSet = await snow_update_set_manage({ action: "create", name: "Feature: " + story.fields.summary });
-// ... build components, add Jira comments after each ...
-
-// Document
-const doc = await confluence_create_page({ spaceKey: "DEV", title: story.fields.summary, content: "..." });
-
-// Construct full Confluence URL (format: https://your-domain.atlassian.net/wiki + _links.webui)
-const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${doc._links.webui}\`;
-
-// Complete
-await jira_add_comment({ issueKey: "PROJ-123", comment: \`✅ Complete\\nUpdate Set: \${updateSet.url}\\nDocs: \${confluenceUrl}\` });
-await jira_transition_issue({ issueKey: "PROJ-123", transitionIdOrName: "Done" });
-\`\`\`
-
-`;
-    }
-    if (hasAzdo && hasConfluence) {
-        workflow += `### AZURE DEVOPS + SERVICENOW + CONFLUENCE
-
-Same flow as Jira, different tools:
-- \`azure_search_work_items()\` instead of \`jira_search_issues()\`
-- \`azure_update_work_item()\` for state changes
-- \`azure_add_work_item_comment()\` for updates
-- Everything else stays the same
-
-`;
-    }
-    workflow += `### 🎯 AUTONOMY PRINCIPLES
-
-1. **YOU ARE IN CONTROL** - Execute autonomously
-2. **UPDATE IN REAL-TIME** - After each component
-3. **LINK EVERYTHING** - Jira/Azure ↔ ServiceNow ↔ Confluence
-4. **DOCUMENT EVERYTHING** - Architecture, testing, deployment
-5. **BE PROACTIVE** - Handle blockers, create tickets, manage dependencies
-
-### ✅ SUCCESS PATTERN
-
-Story → Update Set → Components → Testing → Documentation → Completion → Deployment
-
-Every step documented, every artifact linked, complete traceability.
-
-`;
-    return workflow;
-}
-//# sourceMappingURL=enterprise-docs-generator.js.map