specweave 0.29.0 → 0.29.1

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

@@ -1,220 +0,0 @@
-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 taskMapping = buildTaskMapping(mapping.increments, owner, repo);
-    const architectureDocs = await findArchitectureDocs(rootDir, specId);
-    const sourceLinks = buildSourceLinks(mapping.increments[0]?.id, owner, repo);
-    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;
-    }
-  }
-}
-function buildTaskMapping(increments, owner, repo) {
-  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
-  }));
-  return {
-    incrementId: firstIncrement.id,
-    tasks,
-    tasksUrl: `https://github.com/${owner}/${repo}/blob/develop/.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) {
-  if (!incrementId) return void 0;
-  const baseUrl = `https://github.com/${owner}/${repo}/blob/develop/.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-github/lib/enhanced-github-sync.ts

@@ -1,322 +0,0 @@
-/**
- * Enhanced GitHub Spec Content Sync
- *
- * Uses EnhancedContentBuilder and SpecIncrementMapper for rich external descriptions.
- * NEW (v0.21.0): Supports task checkboxes and automatic labeling.
- */
-
-import { GitHubClientV2 } from './github-client-v2.js';
-import { EnhancedContentBuilder, EnhancedSpecContent } from '../../../src/core/sync/enhanced-content-builder.js';
-import { SpecIncrementMapper, TaskInfo } from '../../../src/core/sync/spec-increment-mapper.js';
-import { parseSpecContent, SpecContent } 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';
-
-export interface EnhancedGitHubSyncOptions {
-  specPath: string;
-  owner?: string;
-  repo?: string;
-  dryRun?: boolean;
-  verbose?: boolean;
-}
-
-export interface EnhancedSyncResult {
-  success: boolean;
-  action: 'created' | 'updated' | 'no-change' | 'error';
-  issueNumber?: number;
-  issueUrl?: string;
-  error?: string;
-  tasksLinked?: number;
-}
-
-/**
- * Enhanced sync with rich content including task mappings
- */
-export async function syncSpecWithEnhancedContent(
-  options: EnhancedGitHubSyncOptions
-): Promise<EnhancedSyncResult> {
-  const { specPath, owner, repo, dryRun = false, verbose = false } = options;
-
-  try {
-    // 1. Parse spec content
-    const baseSpec = await parseSpecContent(specPath);
-    if (!baseSpec) {
-      return {
-        success: false,
-        action: 'error',
-        error: 'Failed to parse spec content',
-      };
-    }
-
-    if (verbose) {
-      console.log(`📄 Parsed spec: ${baseSpec.identifier.compact}`);
-    }
-
-    // 2. Build enhanced spec with task mappings
-    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(`🔗 Found ${mapping.increments.length} related increments`);
-      console.log(`📋 Mapped ${Object.keys(mapping.userStoryMappings).length} user stories to tasks`);
-    }
-
-    // 3. Build task mapping for EnhancedSpecContent
-    const taskMapping = buildTaskMapping(mapping.increments, owner!, repo!);
-
-    // 4. Build architecture docs references
-    const architectureDocs = await findArchitectureDocs(rootDir, specId);
-
-    // 5. Build source links
-    const sourceLinks = buildSourceLinks(mapping.increments[0]?.id, owner!, repo!);
-
-    // 6. Create enhanced spec content
-    const enhancedSpec: EnhancedSpecContent = {
-      ...baseSpec,
-      summary: baseSpec.description,
-      taskMapping,
-      architectureDocs,
-      sourceLinks
-    };
-
-    // 7. Build external description with task checkboxes
-    const builder = new EnhancedContentBuilder();
-
-    // NEW: Override buildTasksSection call to include checkboxes
-    const originalBuildExternal = builder.buildExternalDescription.bind(builder);
-    const description = (() => {
-      const sections: string[] = [];
-
-      // Summary
-      sections.push(builder.buildSummarySection(enhancedSpec));
-
-      // User stories
-      if (enhancedSpec.userStories && enhancedSpec.userStories.length > 0) {
-        sections.push(builder.buildUserStoriesSection(enhancedSpec.userStories));
-      }
-
-      // Tasks with checkboxes (NEW!)
-      if (enhancedSpec.taskMapping) {
-        sections.push(builder.buildTasksSection(enhancedSpec.taskMapping, {
-          showCheckboxes: true,
-          showProgressBar: true,
-          showCompletionStatus: true,
-          provider: 'github'
-        }));
-      }
-
-      // Architecture
-      if (enhancedSpec.architectureDocs && enhancedSpec.architectureDocs.length > 0) {
-        sections.push(builder.buildArchitectureSection(enhancedSpec.architectureDocs));
-      }
-
-      // Source links
-      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(`📝 Generated description: ${description.length} characters`);
-    }
-
-    if (dryRun) {
-      console.log('🔍 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
-      };
-    }
-
-    // 8. Create or update GitHub issue
-    if (!owner || !repo) {
-      return {
-        success: false,
-        action: 'error',
-        error: 'GitHub owner/repo not specified',
-      };
-    }
-
-    const client = GitHubClientV2.fromRepo(owner, repo);
-
-    // NEW: Detect increment type and apply labels
-    const labelDetector = new LabelDetector(undefined, false);  // Use GitHub format
-    const detection = labelDetector.detectType(
-      await fs.readFile(specPath, 'utf-8'),
-      mapping.increments[0]?.id
-    );
-    const githubLabels = labelDetector.getGitHubLabels(detection.type);
-    const allLabels = ['spec', ...githubLabels];  // Include both 'spec' and type labels
-
-    if (verbose) {
-      console.log(`🏷️  Detected type: ${detection.type} (${detection.confidence}% confidence)`);
-      console.log(`   Labels: ${allLabels.join(', ')}`);
-    }
-
-    // Check if issue already exists
-    const existingIssue = await findExistingIssue(client, baseSpec.identifier.compact);
-
-    let result: EnhancedSyncResult;
-
-    if (existingIssue) {
-      // Update existing issue (body + labels)
-      await client.updateIssueBody(existingIssue.number, description);
-
-      // Update labels if autoApplyLabels is enabled
-      // TODO: Read from config, for now always apply
-      await client.addLabels(existingIssue.number, allLabels);
-
-      result = {
-        success: true,
-        action: 'updated',
-        issueNumber: existingIssue.number,
-        issueUrl: existingIssue.html_url,
-        tasksLinked: taskMapping?.tasks.length || 0
-      };
-    } else {
-      // Create new issue with labels
-      const issue = await client.createEpicIssue(
-        `[${baseSpec.project === '_features' ? baseSpec.identifier.display : baseSpec.identifier.compact}] ${baseSpec.title}`,
-        description,
-        undefined,
-        allLabels  // Apply labels at creation
-      );
-
-      result = {
-        success: true,
-        action: 'created',
-        issueNumber: issue.number,
-        issueUrl: issue.html_url,
-        tasksLinked: taskMapping?.tasks.length || 0
-      };
-
-      // Update spec with GitHub link
-      await mapper.updateSpecWithIncrementLinks(specId, mapping.increments[0]?.id);
-    }
-
-    if (verbose) {
-      console.log(`✅ ${result.action === 'created' ? 'Created' : 'Updated'} issue #${result.issueNumber}`);
-      console.log(`   URL: ${result.issueUrl}`);
-      console.log(`   Tasks linked: ${result.tasksLinked}`);
-    }
-
-    return result;
-  } catch (error: any) {
-    return {
-      success: false,
-      action: 'error',
-      error: error.message
-    };
-  }
-}
-
-// Helper functions
-
-async function findSpecWeaveRoot(specPath: string): Promise<string> {
-  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: any[],
-  owner: string,
-  repo: string
-): any {
-  if (increments.length === 0) return undefined;
-
-  const firstIncrement = increments[0];
-  const tasks = firstIncrement.tasks.map((task: TaskInfo) => ({
-    id: task.id,
-    title: task.title,
-    userStories: task.userStories,
-    githubIssue: task.githubIssue
-  }));
-
-  return {
-    incrementId: firstIncrement.id,
-    tasks,
-    tasksUrl: `https://github.com/${owner}/${repo}/blob/develop/.specweave/increments/${firstIncrement.id}/tasks.md`
-  };
-}
-
-async function findArchitectureDocs(
-  rootDir: string,
-  specId: string
-): Promise<any[]> {
-  const docs: any[] = [];
-  const archDir = path.join(rootDir, '.specweave/docs/internal/architecture');
-
-  try {
-    // Check for ADRs
-    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 {}
-
-    // Check for HLD
-    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: string | undefined, owner: string, repo: string): any {
-  if (!incrementId) return undefined;
-
-  const baseUrl = `https://github.com/${owner}/${repo}/blob/develop/.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: GitHubClientV2, specId: string): Promise<any | null> {
-  try {
-    const issues = await client.listIssuesInTimeRange('ALL');
-    return issues.find((issue: any) => issue.title.includes(`[${specId}]`) && issue.labels?.some((l: any) => l.name === 'spec')) || null;
-  } catch {
-    return null;
-  }
-}

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

@@ -1,134 +0,0 @@
-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 * 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) {
-      result.epicKey = `SPEC-001`;
-      result.epicUrl = `https://${domain}/browse/SPEC-001`;
-      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
-};