snow-flow 8.36.3 ā†’ 8.36.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/cli/enterprise-docs-generator.js +45 -8
  2. package/dist/cli/enterprise-docs-generator.js.map +1 -1
  3. package/package.json +1 -1
package/dist/cli/enterprise-docs-generator.js CHANGED
@@ -125,12 +125,15 @@ if (!canStart) {
125
125
 
126
126
  **1.3 Claim the Story**
127
127
  \`\`\`javascript
128
+ // Get current user's accountId
129
+ const currentUser = await jira_get_current_user();
130
+
128
131
  // Assign + transition + comment in ONE call
129
132
  await jira_transition_issue({
130
133
  issueKey: "PROJ-123",
131
134
  transitionIdOrName: "In Progress",
132
135
  fields: {
133
- assignee: { name: "currentUser" },
136
+ assignee: { accountId: currentUser.accountId },
134
137
  comment: \`šŸš€ Starting development
135
138
 
136
139
  Pre-flight: āœ… Passed
@@ -312,11 +315,14 @@ await jira_add_comment({
312
315
 
313
316
  **3.2 Transition to In Review**
314
317
  \`\`\`javascript
318
+ // Optionally assign to tech lead/reviewer (get their accountId first if needed)
319
+ // const reviewer = await jira_search_users({ query: "tech.lead@company.com" });
320
+
315
321
  await jira_transition_issue({
316
322
  issueKey: "PROJ-123",
317
323
  transitionIdOrName: "In Review",
318
324
  fields: {
319
- assignee: { name: "techlead" },
325
+ // assignee: { accountId: reviewer[0].accountId }, // Optional: assign to specific reviewer
320
326
  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!\`
321
327
  }
322
328
  });
@@ -381,9 +387,11 @@ await jira_add_comment({
381
387
  - Performance: 150ms avg (target: <200ms) āœ…
382
388
 
383
389
  ## šŸ“š Documentation
384
- - Confluence: [Architecture & API Docs](link)
390
+ - Confluence: [Architecture & API Docs](\${confluenceUrl})
385
391
  - Story description: Updated with technical details
386
392
 
393
+ **Note:** Use confluence_create_page response: \`https://your-domain.atlassian.net/wiki\${doc._links.webui}\`
394
+
387
395
  ## šŸš€ Deployment
388
396
  āœ… Update Set locked and ready
389
397
  āœ… All tests passing
@@ -455,7 +463,9 @@ await jira_add_comment({
455
463
  const isUrgent = bug.fields.priority.name === "Highest";
456
464
 
457
465
  if (isUrgent) {
458
- await jira_update_issue({ issueKey: bug.key, assignee: "currentUser" });
466
+ // Assign to current user
467
+ const currentUser = await jira_get_current_user();
468
+ await jira_update_issue({ issueKey: bug.key, fields: { assignee: { accountId: currentUser.accountId } } });
459
469
  await jira_transition_issue({ issueKey: bug.key, transitionIdOrName: "In Progress" });
460
470
 
461
471
  const hotfix = await snow_update_set_manage({
@@ -522,8 +532,10 @@ await jira_add_comment({
522
532
  |------|---------|----------------|
523
533
  | **jira_search_issues** | Find stories with JQL | jql, maxResults, expand |
524
534
  | **jira_get_issue** | Get story details | issueKey, expand |
535
+ | **jira_get_current_user** | Get current user's accountId | - |
536
+ | **jira_search_users** | Find users by email/name | query |
525
537
  | **jira_create_issue** | Create stories/bugs/subtasks | project, summary, issueType |
526
- | **jira_update_issue** | Update fields | issueKey, assignee, customFields, labels |
538
+ | **jira_update_issue** | Update fields | issueKey, fields (assignee, etc) |
527
539
  | **jira_transition_issue** | Move through workflow | issueKey, transitionIdOrName, fields |
528
540
  | **jira_add_comment** | Add development updates | issueKey, comment |
529
541
  | **jira_add_worklog** | Log time spent | issueKey, timeSpent, comment |
@@ -659,6 +671,25 @@ function generateConfluenceInstructions() {
659
671
 
660
672
  You **CREATE AND MAINTAIN** living documentation for every feature you build.
661
673
 
674
+ ### āš ļø IMPORTANT: Confluence URL Construction
675
+
676
+ Confluence API returns **relative URLs** in \`_links.webui\`. You MUST construct the full URL:
677
+
678
+ \`\`\`javascript
679
+ const page = await confluence_create_page({ ... });
680
+
681
+ // āœ… CORRECT: Construct full URL
682
+ const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${page._links.webui}\`;
683
+
684
+ // āŒ WRONG: Using _links.webui directly will give 404
685
+ const brokenUrl = page._links.webui; // This is just "/spaces/DEV/pages/123"
686
+ \`\`\`
687
+
688
+ **URL Format Examples:**
689
+ - Correct: \`https://snow-flow.atlassian.net/wiki/spaces/SE/pages/7471106\`
690
+ - Wrong: \`https:snow-flow.atlassian.net/spaces/SE/pages/7471106\` (missing //)
691
+ - Wrong: \`/spaces/SE/pages/7471106\` (missing base URL)
692
+
662
693
  ### CREATE DOCUMENTATION AFTER DEVELOPMENT
663
694
 
664
695
  \`\`\`javascript
@@ -700,10 +731,13 @@ engine.process(current);
700
731
  parentPageId: "123456"
701
732
  });
702
733
 
703
- // Link back to Jira/Azure DevOps
734
+ // Construct full Confluence URL for sharing
735
+ const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${page._links.webui}\`;
736
+
737
+ // Link back to Jira/Azure DevOps with full URL
704
738
  await jira_add_comment({
705
739
  issueKey: "PROJ-123",
706
- comment: \`šŸ“š Documentation: \${page.url}\\n\\nIncludes: Architecture, Components, Testing, Deployment\`
740
+ comment: \`šŸ“š Documentation: \${confluenceUrl}\\n\\nIncludes: Architecture, Components, Testing, Deployment\`
707
741
  });
708
742
  \`\`\`
709
743
 
@@ -800,8 +834,11 @@ const updateSet = await snow_update_set_manage({ action: "create", name: "Featur
800
834
  // Document
801
835
  const doc = await confluence_create_page({ spaceKey: "DEV", title: story.fields.summary, content: "..." });
802
836
 
837
+ // Construct full Confluence URL (format: https://your-domain.atlassian.net/wiki + _links.webui)
838
+ const confluenceUrl = \`https://your-domain.atlassian.net/wiki\${doc._links.webui}\`;
839
+
803
840
  // Complete
804
- await jira_add_comment({ issueKey: "PROJ-123", comment: \`āœ… Complete\\nUpdate Set: \${updateSet.url}\\nDocs: \${doc.url}\` });
841
+ await jira_add_comment({ issueKey: "PROJ-123", comment: \`āœ… Complete\\nUpdate Set: \${updateSet.url}\\nDocs: \${confluenceUrl}\` });
805
842
  await jira_transition_issue({ issueKey: "PROJ-123", transitionIdOrName: "Done" });
806
843
  \`\`\`
807
844
 
package/dist/cli/enterprise-docs-generator.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"enterprise-docs-generator.js","sourceRoot":"","sources":["../../src/cli/enterprise-docs-generator.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"enterprise-docs-generator.js","sourceRoot":"","sources":["../../src/cli/enterprise-docs-generator.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "snow-flow",
3
- "version": "8.36.3",
3
+ "version": "8.36.4",
4
4
  "description": "ServiceNow development with SnowCode - 75+ LLM providers (Claude, GPT, Gemini, Llama, Mistral, DeepSeek, Groq, Ollama) ā€¢ 395 Optimized Tools ā€¢ 2 MCP Servers ā€¢ Multi-agent orchestration ā€¢ Use ANY AI coding assistant (ML tools moved to Enterprise)",
5
5
  "main": "dist/index.js",
6
6
  "type": "commonjs",