specweave 1.0.506 → 1.0.508

package/plugins/specweave/lib/integrations/jira/jira-ac-checkbox-sync.js

@@ -0,0 +1,300 @@
+import { promises as fs, existsSync } from "fs";
+import path from "path";
+import yaml from "yaml";
+import axios from "axios";
+import { consoleLogger } from "../../vendor/utils/logger.js";
+import { deriveFeatureId } from "../../vendor/utils/feature-id-derivation.js";
+import { getApiBaseUrl } from "./jira-deployment-detector.js";
+import { GitHubACCheckboxSync } from "../github/github-ac-checkbox-sync.js";
+class JiraACCheckboxSync {
+  constructor(options) {
+    this.projectRoot = options.projectRoot;
+    this.incrementId = options.incrementId;
+    this.logger = options.logger ?? consoleLogger;
+  }
+  async syncACCheckboxesToJira(config) {
+    const result = { success: true, updated: 0, issues: [] };
+    try {
+      const jiraConfig = this.resolveJiraConfig(config);
+      if (!jiraConfig) {
+        this.logger.log("\u2139\uFE0F  JIRA sync not configured \u2014 skipping AC checkbox sync");
+        return result;
+      }
+      const client = this.buildClient(jiraConfig);
+      const specPath = path.join(
+        this.projectRoot,
+        ".specweave/increments",
+        this.incrementId,
+        "spec.md"
+      );
+      if (!existsSync(specPath)) {
+        this.logger.log("\u26A0\uFE0F  spec.md not found");
+        return result;
+      }
+      const specContent = await fs.readFile(specPath, "utf-8");
+      const acStatus = GitHubACCheckboxSync.parseACStatusFromSpec(specContent);
+      if (acStatus.size === 0) {
+        this.logger.log("\u2139\uFE0F  No ACs found in spec.md");
+        return result;
+      }
+      this.logger.log(`
+\u{1F4CA} Syncing AC checkboxes to JIRA (${acStatus.size} ACs found)...`);
+      const userStories = await this.loadUserStoriesForIncrement();
+      if (userStories.length === 0) {
+        this.logger.log("\u2139\uFE0F  No user stories found for increment");
+        return result;
+      }
+      for (const usFile of userStories) {
+        const jiraInfo = usFile.external_tools?.jira;
+        const storyKey = jiraInfo?.key;
+        if (!storyKey) {
+          this.logger.log(`   \u23ED\uFE0F  ${usFile.id} \u2014 no JIRA story key linked`);
+          continue;
+        }
+        const acPrefix = GitHubACCheckboxSync.buildACPrefix(usFile.id);
+        const usAcStatus = /* @__PURE__ */ new Map();
+        for (const [acId, completed] of acStatus) {
+          if (acId.startsWith(acPrefix)) {
+            usAcStatus.set(acId, completed);
+          }
+        }
+        if (usAcStatus.size === 0) {
+          this.logger.log(`   \u23ED\uFE0F  ${usFile.id} \u2014 no matching ACs`);
+          continue;
+        }
+        try {
+          const updated = await this.updateStoryCheckboxes(
+            client,
+            jiraConfig.domain,
+            storyKey,
+            usAcStatus
+          );
+          if (updated > 0) {
+            result.updated += updated;
+            result.issues.push(storyKey);
+            this.logger.log(`   \u2705 ${usFile.id} ${storyKey} \u2014 updated ${updated} checkbox(es)`);
+          } else {
+            this.logger.log(`   \u23ED\uFE0F  ${usFile.id} ${storyKey} \u2014 no changes needed`);
+          }
+        } catch (err) {
+          this.logger.log(`   \u26A0\uFE0F  ${usFile.id} ${storyKey} \u2014 update failed: ${err}`);
+          result.success = false;
+        }
+      }
+      this.logger.log(`
+\u{1F4CA} JIRA AC Sync: updated ${result.updated} checkbox(es) in ${result.issues.length} story/stories`);
+      return result;
+    } catch (error) {
+      this.logger.error("\u274C JIRA AC checkbox sync failed:", error);
+      result.success = false;
+      return result;
+    }
+  }
+  /**
+   * Fetch the current ADF description from JIRA, walk taskItem nodes,
+   * update state based on acStatus map, then PUT back.
+   */
+  async updateStoryCheckboxes(client, domain, storyKey, acStatus) {
+    const resp = await client.get(
+      `/issue/${storyKey}?fields=description`,
+      { headers: { Accept: "application/json" } }
+    );
+    const description = resp.data?.fields?.description;
+    if (!description || typeof description !== "object") {
+      return 0;
+    }
+    let updated = 0;
+    this.walkAdf(description, (node) => {
+      if (node.type !== "taskItem") return;
+      const text = this.extractText(node);
+      for (const [acId, completed] of acStatus) {
+        if (text.includes(acId)) {
+          const newState = completed ? "DONE" : "TODO";
+          if (node.attrs?.state !== newState) {
+            node.attrs = { ...node.attrs, state: newState };
+            updated++;
+          }
+          break;
+        }
+      }
+    });
+    if (updated > 0) {
+      await client.put(`/issue/${storyKey}`, {
+        fields: { description }
+      });
+      const completedCount = [...acStatus.values()].filter(Boolean).length;
+      const totalCount = acStatus.size;
+      const percentage = Math.round(completedCount / totalCount * 100);
+      const acLines = [...acStatus.entries()].map(([id, done]) => `${done ? "\u2705" : "\u2B1C"} ${id}`).join("\n");
+      const commentAdf = {
+        version: 1,
+        type: "doc",
+        content: [
+          {
+            type: "heading",
+            attrs: { level: 3 },
+            content: [{ type: "text", text: "\u{1F4CA} AC Progress Update" }]
+          },
+          {
+            type: "paragraph",
+            content: [
+              { type: "text", text: "Acceptance Criteria", marks: [{ type: "strong" }] },
+              { type: "text", text: `: ${completedCount}/${totalCount} (${percentage}%)` }
+            ]
+          },
+          {
+            type: "codeBlock",
+            attrs: { language: "text" },
+            content: [{ type: "text", text: acLines }]
+          },
+          {
+            type: "paragraph",
+            content: [{ type: "text", text: "\u{1F916} Auto-updated by SpecWeave AC Completion Gate" }]
+          }
+        ]
+      };
+      try {
+        await client.post(`/issue/${storyKey}/comment`, {
+          body: commentAdf
+        });
+      } catch {
+      }
+    }
+    return updated;
+  }
+  /** Recursively walk ADF nodes calling visitor for each */
+  walkAdf(node, visitor) {
+    visitor(node);
+    if (Array.isArray(node.content)) {
+      for (const child of node.content) {
+        this.walkAdf(child, visitor);
+      }
+    }
+  }
+  /** Extract plain text from an ADF node (concat all text leaves) */
+  extractText(node) {
+    if (node.type === "text") return node.text ?? "";
+    if (!Array.isArray(node.content)) return "";
+    return node.content.map((c) => this.extractText(c)).join("");
+  }
+  buildClient(jiraConfig) {
+    const token = Buffer.from(`${jiraConfig.email}:${jiraConfig.apiToken}`).toString("base64");
+    return axios.create({
+      baseURL: getApiBaseUrl(jiraConfig.domain),
+      headers: {
+        Authorization: `Basic ${token}`,
+        "Content-Type": "application/json"
+      }
+    });
+  }
+  resolveJiraConfig(config) {
+    const profiles = config.sync?.profiles;
+    if (profiles) {
+      for (const profile of Object.values(profiles)) {
+        if (profile?.provider === "jira" && profile?.domain) {
+          const email2 = profile.email || process.env.JIRA_EMAIL || "";
+          const apiToken2 = profile.apiToken || profile.token || process.env.JIRA_API_TOKEN || "";
+          if (email2 && apiToken2) {
+            return { domain: profile.domain, email: email2, apiToken: apiToken2 };
+          }
+        }
+      }
+    }
+    const jira = config.sync?.jira;
+    if (jira?.domain) {
+      const email2 = jira.email || process.env.JIRA_EMAIL || "";
+      const apiToken2 = jira.apiToken || jira.token || process.env.JIRA_API_TOKEN || "";
+      if (email2 && apiToken2) {
+        return { domain: jira.domain, email: email2, apiToken: apiToken2 };
+      }
+    }
+    const email = process.env.JIRA_EMAIL || "";
+    const apiToken = process.env.JIRA_API_TOKEN || "";
+    const baseUrl = process.env.JIRA_BASE_URL || "";
+    if (email && apiToken && baseUrl) {
+      const domain = baseUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+      return { domain, email, apiToken };
+    }
+    return null;
+  }
+  /**
+   * Load user stories from living docs for the increment.
+   * Reuses the same logic as GitHubACCheckboxSync.
+   */
+  async loadUserStoriesForIncrement() {
+    const specFile = path.join(
+      this.projectRoot,
+      ".specweave/increments",
+      this.incrementId,
+      "spec.md"
+    );
+    if (!existsSync(specFile)) return [];
+    const content = await fs.readFile(specFile, "utf-8");
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) return [];
+    const frontmatter = yaml.parse(frontmatterMatch[1]);
+    let featureId = frontmatter.feature_id || frontmatter.epic || frontmatter.feature;
+    if (!featureId) {
+      const metadataFile = path.join(
+        this.projectRoot,
+        ".specweave/increments",
+        this.incrementId,
+        "metadata.json"
+      );
+      if (existsSync(metadataFile)) {
+        try {
+          const metadata = JSON.parse(await fs.readFile(metadataFile, "utf-8"));
+          featureId = metadata.feature_id || metadata.epic_id;
+        } catch {
+        }
+      }
+    }
+    if (!featureId) {
+      try {
+        featureId = deriveFeatureId(this.incrementId);
+      } catch {
+        return [];
+      }
+    }
+    const specsRoot = path.join(this.projectRoot, ".specweave/docs/internal/specs");
+    const usFiles = [];
+    const projectDirs = [];
+    if (existsSync(specsRoot)) {
+      try {
+        for (const proj of await fs.readdir(specsRoot)) {
+          const p = path.join(specsRoot, proj, featureId);
+          if (existsSync(p)) projectDirs.push(p);
+        }
+      } catch {
+      }
+    }
+    for (const featurePath of projectDirs) {
+      const files = await fs.readdir(featurePath);
+      for (const file of files) {
+        if (!file.startsWith("us-") || !file.endsWith(".md")) continue;
+        const fileContent = await fs.readFile(path.join(featurePath, file), "utf-8");
+        const match = fileContent.match(/^---\n([\s\S]*?)\n---/);
+        if (match) {
+          const fm = yaml.parse(match[1]);
+          const externalTools = { ...fm.external || {}, ...fm.external_tools || {} };
+          usFiles.push({
+            id: fm.id,
+            title: fm.title,
+            format_preservation: fm.format_preservation,
+            external_title: fm.external_title,
+            external_source: fm.external_source,
+            external_id: fm.external_id,
+            external_url: fm.external_url,
+            imported_at: fm.imported_at,
+            origin: fm.origin,
+            external_tools: externalTools
+          });
+        }
+      }
+    }
+    return usFiles;
+  }
+}
+export {
+  JiraACCheckboxSync
+};

package/plugins/specweave/lib/integrations/jira/jira-ac-checkbox-sync.ts

@@ -0,0 +1,380 @@
+/**
+ * JIRA AC Checkbox Sync
+ *
+ * Mirrors github-ac-checkbox-sync.ts — updates native JIRA taskItem checkbox
+ * states when ACs are marked complete in spec.md.
+ *
+ * Strategy: fetch current ADF description from JIRA → walk taskItem nodes →
+ * update state (TODO/DONE) based on current spec.md AC status → PUT back.
+ * This preserves any manual edits made directly in JIRA.
+ *
+ * No comments are posted — only the description checkboxes are updated.
+ */
+
+import { promises as fs, existsSync } from 'fs';
+import path from 'path';
+import yaml from 'yaml';
+import axios, { AxiosInstance } from 'axios';
+import { Logger, consoleLogger } from '../../vendor/utils/logger.js';
+import { deriveFeatureId } from '../../vendor/utils/feature-id-derivation.js';
+import { detectDeploymentType, getApiBaseUrl } from './jira-deployment-detector.js';
+import type { SpecWeaveConfig } from '../../../../../src/core/config/types.js';
+import type { LivingDocsUSFile } from '../../../../../src/types/living-docs-us-file.js';
+import { GitHubACCheckboxSync } from '../github/github-ac-checkbox-sync.js';
+
+export interface JiraACCheckboxSyncResult {
+  success: boolean;
+  updated: number;
+  issues: string[];
+}
+
+export class JiraACCheckboxSync {
+  private projectRoot: string;
+  private incrementId: string;
+  private logger: Logger;
+
+  constructor(options: {
+    projectRoot: string;
+    incrementId: string;
+    logger?: Logger;
+  }) {
+    this.projectRoot = options.projectRoot;
+    this.incrementId = options.incrementId;
+    this.logger = options.logger ?? consoleLogger;
+  }
+
+  async syncACCheckboxesToJira(config: SpecWeaveConfig): Promise<JiraACCheckboxSyncResult> {
+    const result: JiraACCheckboxSyncResult = { success: true, updated: 0, issues: [] };
+
+    try {
+      // Resolve JIRA credentials from config or environment
+      const jiraConfig = this.resolveJiraConfig(config);
+      if (!jiraConfig) {
+        this.logger.log('ℹ️  JIRA sync not configured — skipping AC checkbox sync');
+        return result;
+      }
+
+      const client = this.buildClient(jiraConfig);
+
+      // Load spec.md AC status
+      const specPath = path.join(
+        this.projectRoot,
+        '.specweave/increments',
+        this.incrementId,
+        'spec.md'
+      );
+
+      if (!existsSync(specPath)) {
+        this.logger.log('⚠️  spec.md not found');
+        return result;
+      }
+
+      const specContent = await fs.readFile(specPath, 'utf-8');
+      const acStatus = GitHubACCheckboxSync.parseACStatusFromSpec(specContent);
+
+      if (acStatus.size === 0) {
+        this.logger.log('ℹ️  No ACs found in spec.md');
+        return result;
+      }
+
+      this.logger.log(`\n📊 Syncing AC checkboxes to JIRA (${acStatus.size} ACs found)...`);
+
+      // Load user stories with JIRA keys
+      const userStories = await this.loadUserStoriesForIncrement();
+      if (userStories.length === 0) {
+        this.logger.log('ℹ️  No user stories found for increment');
+        return result;
+      }
+
+      for (const usFile of userStories) {
+        const jiraInfo = usFile.external_tools?.jira as Record<string, any> | undefined;
+        const storyKey = jiraInfo?.key;
+
+        if (!storyKey) {
+          this.logger.log(`   ⏭️  ${usFile.id} — no JIRA story key linked`);
+          continue;
+        }
+
+        // Filter ACs belonging to this user story
+        const acPrefix = GitHubACCheckboxSync.buildACPrefix(usFile.id);
+        const usAcStatus = new Map<string, boolean>();
+        for (const [acId, completed] of acStatus) {
+          if (acId.startsWith(acPrefix)) {
+            usAcStatus.set(acId, completed);
+          }
+        }
+
+        if (usAcStatus.size === 0) {
+          this.logger.log(`   ⏭️  ${usFile.id} — no matching ACs`);
+          continue;
+        }
+
+        try {
+          const updated = await this.updateStoryCheckboxes(
+            client,
+            jiraConfig.domain,
+            storyKey,
+            usAcStatus
+          );
+
+          if (updated > 0) {
+            result.updated += updated;
+            result.issues.push(storyKey);
+            this.logger.log(`   ✅ ${usFile.id} ${storyKey} — updated ${updated} checkbox(es)`);
+          } else {
+            this.logger.log(`   ⏭️  ${usFile.id} ${storyKey} — no changes needed`);
+          }
+        } catch (err) {
+          this.logger.log(`   ⚠️  ${usFile.id} ${storyKey} — update failed: ${err}`);
+          result.success = false;
+        }
+      }
+
+      this.logger.log(`\n📊 JIRA AC Sync: updated ${result.updated} checkbox(es) in ${result.issues.length} story/stories`);
+      return result;
+
+    } catch (error) {
+      this.logger.error('❌ JIRA AC checkbox sync failed:', error);
+      result.success = false;
+      return result;
+    }
+  }
+
+  /**
+   * Fetch the current ADF description from JIRA, walk taskItem nodes,
+   * update state based on acStatus map, then PUT back.
+   */
+  private async updateStoryCheckboxes(
+    client: AxiosInstance,
+    domain: string,
+    storyKey: string,
+    acStatus: Map<string, boolean>
+  ): Promise<number> {
+    const resp = await client.get(
+      `/issue/${storyKey}?fields=description`,
+      { headers: { Accept: 'application/json' } }
+    );
+
+    const description = resp.data?.fields?.description;
+    if (!description || typeof description !== 'object') {
+      return 0;
+    }
+
+    let updated = 0;
+    this.walkAdf(description, (node: any) => {
+      if (node.type !== 'taskItem') return;
+      const text = this.extractText(node);
+      for (const [acId, completed] of acStatus) {
+        if (text.includes(acId)) {
+          const newState = completed ? 'DONE' : 'TODO';
+          if (node.attrs?.state !== newState) {
+            node.attrs = { ...node.attrs, state: newState };
+            updated++;
+          }
+          break;
+        }
+      }
+    });
+
+    if (updated > 0) {
+      await client.put(`/issue/${storyKey}`, {
+        fields: { description }
+      });
+
+      // Post progress comment (consistent with GitHub and ADO)
+      const completedCount = [...acStatus.values()].filter(Boolean).length;
+      const totalCount = acStatus.size;
+      const percentage = Math.round((completedCount / totalCount) * 100);
+
+      const acLines = [...acStatus.entries()]
+        .map(([id, done]) => `${done ? '✅' : '⬜'} ${id}`)
+        .join('\n');
+
+      const commentAdf = {
+        version: 1,
+        type: 'doc',
+        content: [
+          {
+            type: 'heading',
+            attrs: { level: 3 },
+            content: [{ type: 'text', text: '📊 AC Progress Update' }],
+          },
+          {
+            type: 'paragraph',
+            content: [
+              { type: 'text', text: 'Acceptance Criteria', marks: [{ type: 'strong' }] },
+              { type: 'text', text: `: ${completedCount}/${totalCount} (${percentage}%)` },
+            ],
+          },
+          {
+            type: 'codeBlock',
+            attrs: { language: 'text' },
+            content: [{ type: 'text', text: acLines }],
+          },
+          {
+            type: 'paragraph',
+            content: [{ type: 'text', text: '🤖 Auto-updated by SpecWeave AC Completion Gate' }],
+          },
+        ],
+      };
+
+      try {
+        await client.post(`/issue/${storyKey}/comment`, {
+          body: commentAdf,
+        });
+      } catch { /* Non-blocking: comment is nice-to-have */ }
+    }
+
+    return updated;
+  }
+
+  /** Recursively walk ADF nodes calling visitor for each */
+  private walkAdf(node: any, visitor: (node: any) => void): void {
+    visitor(node);
+    if (Array.isArray(node.content)) {
+      for (const child of node.content) {
+        this.walkAdf(child, visitor);
+      }
+    }
+  }
+
+  /** Extract plain text from an ADF node (concat all text leaves) */
+  private extractText(node: any): string {
+    if (node.type === 'text') return node.text ?? '';
+    if (!Array.isArray(node.content)) return '';
+    return node.content.map((c: any) => this.extractText(c)).join('');
+  }
+
+  private buildClient(jiraConfig: { domain: string; email: string; apiToken: string }): AxiosInstance {
+    const token = Buffer.from(`${jiraConfig.email}:${jiraConfig.apiToken}`).toString('base64');
+    return axios.create({
+      baseURL: getApiBaseUrl(jiraConfig.domain),
+      headers: {
+        Authorization: `Basic ${token}`,
+        'Content-Type': 'application/json',
+      },
+    });
+  }
+
+  private resolveJiraConfig(
+    config: SpecWeaveConfig
+  ): { domain: string; email: string; apiToken: string } | null {
+    // Try sync.profiles with provider=jira
+    const profiles = (config.sync as any)?.profiles;
+    if (profiles) {
+      for (const profile of Object.values(profiles) as any[]) {
+        if (profile?.provider === 'jira' && profile?.domain) {
+          const email = profile.email || process.env.JIRA_EMAIL || '';
+          const apiToken = profile.apiToken || profile.token || process.env.JIRA_API_TOKEN || '';
+          if (email && apiToken) {
+            return { domain: profile.domain, email, apiToken };
+          }
+        }
+      }
+    }
+
+    // Try sync.jira
+    const jira = (config.sync as any)?.jira;
+    if (jira?.domain) {
+      const email = jira.email || process.env.JIRA_EMAIL || '';
+      const apiToken = jira.apiToken || jira.token || process.env.JIRA_API_TOKEN || '';
+      if (email && apiToken) {
+        return { domain: jira.domain, email, apiToken };
+      }
+    }
+
+    // Fallback: env vars only (derive domain from JIRA_BASE_URL)
+    const email = process.env.JIRA_EMAIL || '';
+    const apiToken = process.env.JIRA_API_TOKEN || '';
+    const baseUrl = process.env.JIRA_BASE_URL || '';
+    if (email && apiToken && baseUrl) {
+      const domain = baseUrl.replace(/^https?:\/\//, '').replace(/\/$/, '');
+      return { domain, email, apiToken };
+    }
+
+    return null;
+  }
+
+  /**
+   * Load user stories from living docs for the increment.
+   * Reuses the same logic as GitHubACCheckboxSync.
+   */
+  private async loadUserStoriesForIncrement(): Promise<LivingDocsUSFile[]> {
+    const specFile = path.join(
+      this.projectRoot,
+      '.specweave/increments',
+      this.incrementId,
+      'spec.md'
+    );
+
+    if (!existsSync(specFile)) return [];
+
+    const content = await fs.readFile(specFile, 'utf-8');
+
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) return [];
+
+    const frontmatter = yaml.parse(frontmatterMatch[1]);
+    let featureId = frontmatter.feature_id || frontmatter.epic || frontmatter.feature;
+
+    if (!featureId) {
+      const metadataFile = path.join(
+        this.projectRoot,
+        '.specweave/increments',
+        this.incrementId,
+        'metadata.json'
+      );
+      if (existsSync(metadataFile)) {
+        try {
+          const metadata = JSON.parse(await fs.readFile(metadataFile, 'utf-8'));
+          featureId = metadata.feature_id || metadata.epic_id;
+        } catch { /* ignore */ }
+      }
+    }
+
+    if (!featureId) {
+      try { featureId = deriveFeatureId(this.incrementId); } catch { return []; }
+    }
+
+    const specsRoot = path.join(this.projectRoot, '.specweave/docs/internal/specs');
+    const usFiles: LivingDocsUSFile[] = [];
+
+    // Search all project directories for the feature
+    const projectDirs: string[] = [];
+    if (existsSync(specsRoot)) {
+      try {
+        for (const proj of await fs.readdir(specsRoot)) {
+          const p = path.join(specsRoot, proj, featureId);
+          if (existsSync(p)) projectDirs.push(p);
+        }
+      } catch { /* ignore */ }
+    }
+
+    for (const featurePath of projectDirs) {
+      const files = await fs.readdir(featurePath);
+      for (const file of files) {
+        if (!file.startsWith('us-') || !file.endsWith('.md')) continue;
+        const fileContent = await fs.readFile(path.join(featurePath, file), 'utf-8');
+        const match = fileContent.match(/^---\n([\s\S]*?)\n---/);
+        if (match) {
+          const fm = yaml.parse(match[1]);
+          const externalTools = { ...(fm.external || {}), ...(fm.external_tools || {}) };
+          usFiles.push({
+            id: fm.id,
+            title: fm.title,
+            format_preservation: fm.format_preservation,
+            external_title: fm.external_title,
+            external_source: fm.external_source,
+            external_id: fm.external_id,
+            external_url: fm.external_url,
+            imported_at: fm.imported_at,
+            origin: fm.origin,
+            external_tools: externalTools,
+          });
+        }
+      }
+    }
+
+    return usFiles;
+  }
+}