specweave 1.0.362 → 1.0.367

package/plugins/specweave-github/lib/enhanced-github-sync.js

@@ -0,0 +1,249 @@
+import { GitHubClientV2 } from "./github-client-v2.js";
+import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
+import { LabelDetector } from "../../../src/core/sync/label-detector.js";
+import path from "path";
+import fs from "fs/promises";
+async function syncSpecWithEnhancedContent(options) {
+  const { specPath, owner, repo, dryRun = false, verbose = false } = options;
+  try {
+    const baseSpec = await parseSpecContent(specPath);
+    if (!baseSpec) {
+      return {
+        success: false,
+        action: "error",
+        error: "Failed to parse spec content"
+      };
+    }
+    if (verbose) {
+      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
+    }
+    const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
+    const rootDir = await findSpecWeaveRoot(specPath);
+    const mapper = new SpecIncrementMapper(rootDir);
+    const mapping = await mapper.mapSpecToIncrements(specId);
+    if (verbose) {
+      console.log(`\u{1F517} Found ${mapping.increments.length} related increments`);
+      console.log(`\u{1F4CB} Mapped ${Object.keys(mapping.userStoryMappings).length} user stories to tasks`);
+    }
+    const defaultBranch = (owner && repo) ? await getDefaultBranch(owner, repo) : null;
+    const taskMapping = buildTaskMapping(mapping.increments, owner, repo, defaultBranch);
+    const architectureDocs = await findArchitectureDocs(rootDir, specId);
+    const sourceLinks = buildSourceLinks(mapping.increments[0]?.id, owner, repo, defaultBranch);
+    const enhancedSpec = {
+      ...baseSpec,
+      summary: baseSpec.description,
+      taskMapping,
+      architectureDocs,
+      sourceLinks
+    };
+    const builder = new EnhancedContentBuilder();
+    const originalBuildExternal = builder.buildExternalDescription.bind(builder);
+    const description = (() => {
+      const sections = [];
+      sections.push(builder.buildSummarySection(enhancedSpec));
+      if (enhancedSpec.userStories && enhancedSpec.userStories.length > 0) {
+        sections.push(builder.buildUserStoriesSection(enhancedSpec.userStories));
+      }
+      if (enhancedSpec.taskMapping) {
+        sections.push(builder.buildTasksSection(enhancedSpec.taskMapping, {
+          showCheckboxes: true,
+          showProgressBar: true,
+          showCompletionStatus: true,
+          provider: "github"
+        }));
+      }
+      if (enhancedSpec.architectureDocs && enhancedSpec.architectureDocs.length > 0) {
+        sections.push(builder.buildArchitectureSection(enhancedSpec.architectureDocs));
+      }
+      if (enhancedSpec.sourceLinks) {
+        sections.push(builder.buildSourceLinksSection(enhancedSpec.sourceLinks));
+      }
+      return sections.filter((s) => s.length > 0).join("\n\n---\n\n");
+    })();
+    if (verbose) {
+      console.log(`\u{1F4DD} Generated description: ${description.length} characters`);
+    }
+    if (dryRun) {
+      console.log("\u{1F50D} DRY RUN - Would create/update issue with:");
+      console.log(`   Title: ${baseSpec.title}`);
+      console.log(`   Description length: ${description.length}`);
+      console.log(`   Tasks linked: ${taskMapping?.tasks.length || 0}`);
+      return {
+        success: true,
+        action: "no-change",
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    }
+    if (!owner || !repo) {
+      return {
+        success: false,
+        action: "error",
+        error: "GitHub owner/repo not specified"
+      };
+    }
+    const client = GitHubClientV2.fromRepo(owner, repo);
+    const labelDetector = new LabelDetector(void 0, false);
+    const detection = labelDetector.detectType(
+      await fs.readFile(specPath, "utf-8"),
+      mapping.increments[0]?.id
+    );
+    const githubLabels = labelDetector.getGitHubLabels(detection.type);
+    const allLabels = ["spec", ...githubLabels];
+    if (verbose) {
+      console.log(`\u{1F3F7}\uFE0F  Detected type: ${detection.type} (${detection.confidence}% confidence)`);
+      console.log(`   Labels: ${allLabels.join(", ")}`);
+    }
+    const existingIssue = await findExistingIssue(client, baseSpec.identifier.compact);
+    let result;
+    if (existingIssue) {
+      await client.updateIssueBody(existingIssue.number, description);
+      await client.addLabels(existingIssue.number, allLabels);
+      result = {
+        success: true,
+        action: "updated",
+        issueNumber: existingIssue.number,
+        issueUrl: existingIssue.html_url,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    } else {
+      const issue = await client.createEpicIssue(
+        `[${baseSpec.project === "_features" ? baseSpec.identifier.display : baseSpec.identifier.compact}] ${baseSpec.title}`,
+        description,
+        void 0,
+        allLabels
+        // Apply labels at creation
+      );
+      result = {
+        success: true,
+        action: "created",
+        issueNumber: issue.number,
+        issueUrl: issue.html_url,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+      await mapper.updateSpecWithIncrementLinks(specId, mapping.increments[0]?.id);
+    }
+    if (verbose) {
+      console.log(`\u2705 ${result.action === "created" ? "Created" : "Updated"} issue #${result.issueNumber}`);
+      console.log(`   URL: ${result.issueUrl}`);
+      console.log(`   Tasks linked: ${result.tasksLinked}`);
+    }
+    return result;
+  } catch (error) {
+    return {
+      success: false,
+      action: "error",
+      error: error.message
+    };
+  }
+}
+async function findSpecWeaveRoot(specPath) {
+  let currentDir = path.dirname(specPath);
+  while (true) {
+    const specweaveDir = path.join(currentDir, ".specweave");
+    try {
+      await fs.access(specweaveDir);
+      return currentDir;
+    } catch {
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        throw new Error(".specweave directory not found");
+      }
+      currentDir = parentDir;
+    }
+  }
+}
+// Cache for default branch per repo per session
+const defaultBranchCache = new Map();
+
+async function getDefaultBranch(owner, repo) {
+  const cacheKey = `${owner}/${repo}`;
+  if (defaultBranchCache.has(cacheKey)) {
+    return defaultBranchCache.get(cacheKey);
+  }
+  try {
+    const { execFileSync } = await import("child_process");
+    const result = execFileSync("gh", [
+      "repo", "view", `${owner}/${repo}`,
+      "--json", "defaultBranchRef",
+      "--jq", ".defaultBranchRef.name"
+    ], { encoding: "utf-8", timeout: 10000 }).trim();
+    if (result) {
+      defaultBranchCache.set(cacheKey, result);
+      return result;
+    }
+  } catch {
+    // On failure, return null — callers omit branch segment
+  }
+  defaultBranchCache.set(cacheKey, null);
+  return null;
+}
+
+function buildTaskMapping(increments, owner, repo, defaultBranch) {
+  if (increments.length === 0) return void 0;
+  const firstIncrement = increments[0];
+  const tasks = firstIncrement.tasks.map((task) => ({
+    id: task.id,
+    title: task.title,
+    userStories: task.userStories,
+    githubIssue: task.githubIssue
+  }));
+  const branchSegment = defaultBranch ? `/blob/${defaultBranch}` : "";
+  return {
+    incrementId: firstIncrement.id,
+    tasks,
+    tasksUrl: `https://github.com/${owner}/${repo}${branchSegment}/.specweave/increments/${firstIncrement.id}/tasks.md`
+  };
+}
+async function findArchitectureDocs(rootDir, specId) {
+  const docs = [];
+  const archDir = path.join(rootDir, ".specweave/docs/internal/architecture");
+  try {
+    const adrDir = path.join(archDir, "adr");
+    try {
+      const adrs = await fs.readdir(adrDir);
+      const relatedAdrs = adrs.filter((file) => file.includes(specId.replace("spec-", "")));
+      for (const adr of relatedAdrs) {
+        docs.push({
+          type: "adr",
+          path: path.join(adrDir, adr),
+          title: adr.replace(".md", "").replace(/-/g, " ")
+        });
+      }
+    } catch {
+    }
+    const hlds = await fs.readdir(archDir);
+    const relatedHlds = hlds.filter((file) => file.includes("hld") && file.includes(specId.replace("spec-", "")));
+    for (const hld of relatedHlds) {
+      docs.push({
+        type: "hld",
+        path: path.join(archDir, hld),
+        title: hld.replace(".md", "").replace(/-/g, " ")
+      });
+    }
+  } catch {
+  }
+  return docs;
+}
+function buildSourceLinks(incrementId, owner, repo, defaultBranch) {
+  if (!incrementId) return void 0;
+  const branchSegment = defaultBranch ? `/blob/${defaultBranch}` : "";
+  const baseUrl = `https://github.com/${owner}/${repo}${branchSegment}/.specweave`;
+  return {
+    spec: `${baseUrl}/docs/internal/specs/default/spec-${incrementId.replace(/^\d+-/, "")}.md`,
+    plan: `${baseUrl}/increments/${incrementId}/plan.md`,
+    tasks: `${baseUrl}/increments/${incrementId}/tasks.md`
+  };
+}
+async function findExistingIssue(client, specId) {
+  try {
+    const issues = await client.listIssuesInTimeRange("ALL");
+    return issues.find((issue) => issue.title.includes(`[${specId}]`) && issue.labels?.some((l) => l.name === "spec")) || null;
+  } catch {
+    return null;
+  }
+}
+export {
+  syncSpecWithEnhancedContent
+};

package/plugins/specweave-jira/lib/enhanced-jira-sync.js

@@ -0,0 +1,150 @@
+import { EnhancedContentBuilder } from "../../../dist/src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../dist/src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../dist/src/core/spec-content-sync.js";
+import { readIssueKey } from "./metadata-paths.js";
+import * as path from "path";
+import * as fs from "fs/promises";
+async function syncSpecToJiraWithEnhancedContent(options) {
+  const { specPath, domain, project, dryRun = false, verbose = false } = options;
+  try {
+    const baseSpec = await parseSpecContent(specPath);
+    if (!baseSpec) {
+      return {
+        success: false,
+        action: "error",
+        error: "Failed to parse spec content"
+      };
+    }
+    if (verbose) {
+      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
+    }
+    const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
+    const rootDir = await findSpecWeaveRoot(specPath);
+    const mapper = new SpecIncrementMapper(rootDir);
+    const mapping = await mapper.mapSpecToIncrements(specId);
+    if (verbose) {
+      console.log(`\u{1F517} Found ${mapping.increments.length} related increments`);
+    }
+    const taskMapping = buildTaskMapping(mapping.increments);
+    const architectureDocs = await findArchitectureDocs(rootDir, specId);
+    const enhancedSpec = {
+      ...baseSpec,
+      summary: baseSpec.description,
+      taskMapping,
+      architectureDocs
+    };
+    const builder = new EnhancedContentBuilder();
+    const description = builder.buildExternalDescription(enhancedSpec);
+    if (verbose) {
+      console.log(`\u{1F4DD} Generated description: ${description.length} characters`);
+    }
+    if (dryRun) {
+      console.log("\u{1F50D} DRY RUN - Would create/update epic with:");
+      console.log(`   Summary: ${baseSpec.title}`);
+      console.log(`   Description length: ${description.length}`);
+      return {
+        success: true,
+        action: "no-change",
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    }
+    if (!dryRun && (!domain || !project)) {
+      return {
+        success: false,
+        action: "error",
+        error: "JIRA domain/project not specified (required for actual sync)"
+      };
+    }
+    const result = {
+      success: true,
+      action: dryRun ? "no-change" : "created",
+      // Assume create if not dry run
+      tasksLinked: taskMapping?.tasks.length || 0
+    };
+    if (domain && project && !dryRun) {
+      // Read real JIRA key from metadata if available
+      const rootDir = await findSpecWeaveRoot(specPath);
+      const metadataPath = path.join(rootDir, '.specweave', 'increments', specId, 'metadata.json');
+      let realKey = null;
+      try {
+        const meta = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+        realKey = readIssueKey(meta);
+      } catch { /* no metadata */ }
+
+      if (realKey) {
+        result.epicKey = realKey;
+        result.epicUrl = `https://${domain}/browse/${realKey}`;
+      } else {
+        // No real JIRA key — return null instead of placeholder
+        result.epicKey = null;
+        result.epicUrl = null;
+        if (verbose) {
+          console.log(`\u26A0\uFE0F  JIRA API integration not implemented in this file`);
+          console.log(`   Use jira-spec-sync.ts for actual JIRA synchronization`);
+        }
+      }
+    }
+    return result;
+  } catch (error) {
+    return {
+      success: false,
+      action: "error",
+      error: error.message
+    };
+  }
+}
+async function findSpecWeaveRoot(specPath) {
+  let currentDir = path.dirname(specPath);
+  while (true) {
+    const specweaveDir = path.join(currentDir, ".specweave");
+    try {
+      await fs.access(specweaveDir);
+      return currentDir;
+    } catch {
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        throw new Error(".specweave directory not found");
+      }
+      currentDir = parentDir;
+    }
+  }
+}
+function buildTaskMapping(increments) {
+  if (increments.length === 0) return void 0;
+  const firstIncrement = increments[0];
+  const tasks = firstIncrement.tasks.map((task) => ({
+    id: task.id,
+    title: task.title,
+    userStories: task.userStories
+  }));
+  return {
+    incrementId: firstIncrement.id,
+    tasks,
+    tasksUrl: `tasks.md`
+    // JIRA doesn't support external links in same way
+  };
+}
+async function findArchitectureDocs(rootDir, specId) {
+  const docs = [];
+  const archDir = path.join(rootDir, ".specweave/docs/internal/architecture");
+  try {
+    const adrDir = path.join(archDir, "adr");
+    try {
+      const adrs = await fs.readdir(adrDir);
+      const relatedAdrs = adrs.filter((file) => file.includes(specId.replace("spec-", "")));
+      for (const adr of relatedAdrs) {
+        docs.push({
+          type: "adr",
+          path: path.join(adrDir, adr),
+          title: adr.replace(".md", "").replace(/-/g, " ")
+        });
+      }
+    } catch {
+    }
+  } catch {
+  }
+  return docs;
+}
+export {
+  syncSpecToJiraWithEnhancedContent
+};