specweave 0.16.5 → 0.16.11

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

@@ -1,185 +1,268 @@
-import {
-  isSimpleStrategy,
-  isFilteredStrategy,
-  isCustomStrategy
-} from "../../../src/core/types/sync-profile.js";
-import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
-async function buildHierarchicalSearchQuery(containers) {
-  const parts = [];
-  for (const container of containers) {
-    parts.push(`repo:${container.id}`);
-    if (container.subOrganizations && container.subOrganizations.length > 0) {
-      console.warn(
-        `\u26A0\uFE0F  GitHub search doesn't support project board filtering directly.`
-      );
-      console.warn(
-        `   Boards will be ignored: ${container.subOrganizations.join(", ")}`
-      );
-    }
-  }
-  parts.push("is:issue");
-  const filters = containers[0]?.filters;
-  if (filters) {
-    const filterClauses = buildFilterClauses(filters);
-    parts.push(...filterClauses);
-  }
-  return parts.join(" ");
+/**
+ * GitHub Hierarchical Sync Implementation
+ *
+ * Supports three sync strategies:
+ * 1. Simple: One repository, all issues (backward compatible)
+ * 2. Filtered: Multiple repositories + project boards + filters
+ * 3. Custom: Raw GitHub search query
+ */
+import { isSimpleStrategy, isFilteredStrategy, isCustomStrategy, } from '../../../src/core/types/sync-profile.js';
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+/**
+ * Build hierarchical GitHub search query from containers
+ *
+ * Example output:
+ * repo:owner/repo-a repo:owner/repo-b is:issue label:feature milestone:"v2.0" created:2024-01-01..2024-12-31
+ *
+ * @param containers Array of containers (repos) with filters
+ * @returns GitHub search query string
+ */
+export async function buildHierarchicalSearchQuery(containers) {
+    const parts = [];
+    // Add repo clauses
+    for (const container of containers) {
+        parts.push(`repo:${container.id}`);
+        // Note: GitHub search doesn't support filtering by project board directly
+        // Project boards would need to be handled via GraphQL API or issue filtering
+        if (container.subOrganizations && container.subOrganizations.length > 0) {
+            console.warn(`⚠️  GitHub search doesn't support project board filtering directly.`);
+            console.warn(`   Boards will be ignored: ${container.subOrganizations.join(', ')}`);
+        }
+    }
+    // Add is:issue filter
+    parts.push('is:issue');
+    // Add filters from first container (apply to all repos)
+    // Note: GitHub search applies filters globally, not per-repo
+    const filters = containers[0]?.filters;
+    if (filters) {
+        const filterClauses = buildFilterClauses(filters);
+        parts.push(...filterClauses);
+    }
+    return parts.join(' ');
 }
+/**
+ * Build filter clauses from container filters
+ *
+ * @param filters Container filters
+ * @returns Array of GitHub search filter clauses
+ */
 function buildFilterClauses(filters) {
-  const clauses = [];
-  if (filters.includeLabels && filters.includeLabels.length > 0) {
-    for (const label of filters.includeLabels) {
-      clauses.push(`label:"${label}"`);
-    }
-  }
-  if (filters.excludeLabels && filters.excludeLabels.length > 0) {
-    for (const label of filters.excludeLabels) {
-      clauses.push(`-label:"${label}"`);
-    }
-  }
-  if (filters.assignees && filters.assignees.length > 0) {
-    const assigneeQuery = filters.assignees.map((a) => `assignee:"${a}"`).join(" ");
-    clauses.push(assigneeQuery);
-  }
-  if (filters.statusCategories && filters.statusCategories.length > 0) {
-    const statuses = filters.statusCategories.map((s) => s.toLowerCase());
-    if (statuses.includes("open") || statuses.includes("to do") || statuses.includes("in progress")) {
-      clauses.push("is:open");
-    } else if (statuses.includes("closed") || statuses.includes("done")) {
-      clauses.push("is:closed");
-    }
-  }
-  if (filters.milestones && filters.milestones.length > 0) {
-    for (const milestone of filters.milestones) {
-      clauses.push(`milestone:"${milestone}"`);
-    }
-  }
-  return clauses;
+    const clauses = [];
+    // Include labels
+    if (filters.includeLabels && filters.includeLabels.length > 0) {
+        for (const label of filters.includeLabels) {
+            clauses.push(`label:"${label}"`);
+        }
+    }
+    // Exclude labels (GitHub uses -label:)
+    if (filters.excludeLabels && filters.excludeLabels.length > 0) {
+        for (const label of filters.excludeLabels) {
+            clauses.push(`-label:"${label}"`);
+        }
+    }
+    // Assignees
+    if (filters.assignees && filters.assignees.length > 0) {
+        // GitHub supports multiple assignees with OR logic
+        const assigneeQuery = filters.assignees
+            .map((a) => `assignee:"${a}"`)
+            .join(' ');
+        clauses.push(assigneeQuery);
+    }
+    // Status (GitHub uses is:open, is:closed)
+    if (filters.statusCategories && filters.statusCategories.length > 0) {
+        const statuses = filters.statusCategories.map((s) => s.toLowerCase());
+        if (statuses.includes('open') || statuses.includes('to do') || statuses.includes('in progress')) {
+            clauses.push('is:open');
+        }
+        else if (statuses.includes('closed') || statuses.includes('done')) {
+            clauses.push('is:closed');
+        }
+    }
+    // Milestones (GitHub-specific)
+    if (filters.milestones && filters.milestones.length > 0) {
+        for (const milestone of filters.milestones) {
+            clauses.push(`milestone:"${milestone}"`);
+        }
+    }
+    return clauses;
 }
+/**
+ * Add time range filter to GitHub search query
+ *
+ * @param query Base search query
+ * @param timeRange Time range preset (1W, 1M, 3M, 6M, ALL)
+ * @returns Search query with time range filter
+ */
 function addTimeRangeFilter(query, timeRange) {
-  if (timeRange === "ALL") {
-    return query;
-  }
-  const { since, until } = calculateTimeRange(timeRange);
-  return `${query} created:${since}..${until}`;
+    if (timeRange === 'ALL') {
+        return query; // No time filter
+    }
+    const { since, until } = calculateTimeRange(timeRange);
+    return `${query} created:${since}..${until}`;
 }
+/**
+ * Calculate date range from time range preset
+ */
 function calculateTimeRange(timeRange) {
-  const now = /* @__PURE__ */ new Date();
-  const since = new Date(now);
-  switch (timeRange) {
-    case "1W":
-      since.setDate(now.getDate() - 7);
-      break;
-    case "2W":
-      since.setDate(now.getDate() - 14);
-      break;
-    case "1M":
-      since.setMonth(now.getMonth() - 1);
-      break;
-    case "3M":
-      since.setMonth(now.getMonth() - 3);
-      break;
-    case "6M":
-      since.setMonth(now.getMonth() - 6);
-      break;
-    case "1Y":
-      since.setFullYear(now.getFullYear() - 1);
-      break;
-    case "ALL":
-      return {
-        since: "1970-01-01",
-        until: now.toISOString().split("T")[0]
-      };
-  }
-  return {
-    since: since.toISOString().split("T")[0],
-    until: now.toISOString().split("T")[0]
-  };
+    const now = new Date();
+    const since = new Date(now);
+    switch (timeRange) {
+        case '1W':
+            since.setDate(now.getDate() - 7);
+            break;
+        case '2W':
+            since.setDate(now.getDate() - 14);
+            break;
+        case '1M':
+            since.setMonth(now.getMonth() - 1);
+            break;
+        case '3M':
+            since.setMonth(now.getMonth() - 3);
+            break;
+        case '6M':
+            since.setMonth(now.getMonth() - 6);
+            break;
+        case '1Y':
+            since.setFullYear(now.getFullYear() - 1);
+            break;
+        case 'ALL':
+            return {
+                since: '1970-01-01',
+                until: now.toISOString().split('T')[0],
+            };
+    }
+    return {
+        since: since.toISOString().split('T')[0],
+        until: now.toISOString().split('T')[0],
+    };
 }
-async function fetchIssuesHierarchical(profile, timeRange = "1M") {
-  const config = profile.config;
-  if (isSimpleStrategy(profile)) {
+/**
+ * Fetch issues hierarchically based on sync strategy
+ *
+ * @param profile Sync profile with strategy
+ * @param timeRange Time range preset
+ * @returns Array of GitHub issues
+ */
+export async function fetchIssuesHierarchical(profile, timeRange = '1M') {
+    const config = profile.config;
+    // Strategy 1: SIMPLE (backward compatible)
+    if (isSimpleStrategy(profile)) {
+        return fetchIssuesSimple(config, timeRange);
+    }
+    // Strategy 2: CUSTOM (raw search query)
+    if (isCustomStrategy(profile)) {
+        return fetchIssuesCustom(config, timeRange);
+    }
+    // Strategy 3: FILTERED (hierarchical)
+    if (isFilteredStrategy(profile)) {
+        return fetchIssuesFiltered(config, timeRange);
+    }
+    // Default to simple if strategy not recognized
+    console.warn('⚠️  Unknown strategy, defaulting to simple');
     return fetchIssuesSimple(config, timeRange);
-  }
-  if (isCustomStrategy(profile)) {
-    return fetchIssuesCustom(config, timeRange);
-  }
-  if (isFilteredStrategy(profile)) {
-    return fetchIssuesFiltered(config, timeRange);
-  }
-  console.warn("\u26A0\uFE0F  Unknown strategy, defaulting to simple");
-  return fetchIssuesSimple(config, timeRange);
 }
+/**
+ * Fetch issues using SIMPLE strategy (one repo, all issues)
+ *
+ * @param config GitHub configuration
+ * @param timeRange Time range preset
+ * @returns Array of GitHub issues
+ */
 async function fetchIssuesSimple(config, timeRange) {
-  const owner = config.owner;
-  const repo = config.repo;
-  if (!owner || !repo) {
-    throw new Error("Simple strategy requires owner and repo in config");
-  }
-  let query = `repo:${owner}/${repo} is:issue`;
-  query = addTimeRangeFilter(query, timeRange);
-  console.log("\u{1F50D} Fetching issues (SIMPLE strategy):", query);
-  return executeSearch(query);
+    const owner = config.owner;
+    const repo = config.repo;
+    if (!owner || !repo) {
+        throw new Error('Simple strategy requires owner and repo in config');
+    }
+    let query = `repo:${owner}/${repo} is:issue`;
+    // Add time range
+    query = addTimeRangeFilter(query, timeRange);
+    console.log('🔍 Fetching issues (SIMPLE strategy):', query);
+    return executeSearch(query);
 }
+/**
+ * Fetch issues using CUSTOM strategy (raw search query)
+ *
+ * @param config GitHub configuration
+ * @param timeRange Time range preset
+ * @returns Array of GitHub issues
+ */
 async function fetchIssuesCustom(config, timeRange) {
-  const customQuery = config.customQuery;
-  if (!customQuery) {
-    throw new Error("Custom strategy requires customQuery in config");
-  }
-  const query = addTimeRangeFilter(customQuery, timeRange);
-  console.log("\u{1F50D} Fetching issues (CUSTOM strategy):", query);
-  return executeSearch(query);
+    const customQuery = config.customQuery;
+    if (!customQuery) {
+        throw new Error('Custom strategy requires customQuery in config');
+    }
+    // Add time range to custom query
+    const query = addTimeRangeFilter(customQuery, timeRange);
+    console.log('🔍 Fetching issues (CUSTOM strategy):', query);
+    return executeSearch(query);
 }
+/**
+ * Fetch issues using FILTERED strategy (multiple repos + filters)
+ *
+ * @param config GitHub configuration
+ * @param timeRange Time range preset
+ * @returns Array of GitHub issues
+ */
 async function fetchIssuesFiltered(config, timeRange) {
-  const containers = config.containers;
-  if (!containers || containers.length === 0) {
-    throw new Error("Filtered strategy requires containers array in config");
-  }
-  const baseQuery = await buildHierarchicalSearchQuery(containers);
-  const query = addTimeRangeFilter(baseQuery, timeRange);
-  console.log("\u{1F50D} Fetching issues (FILTERED strategy):", query);
-  return executeSearch(query);
+    const containers = config.containers;
+    if (!containers || containers.length === 0) {
+        throw new Error('Filtered strategy requires containers array in config');
+    }
+    // Build hierarchical search query
+    const baseQuery = await buildHierarchicalSearchQuery(containers);
+    // Add time range
+    const query = addTimeRangeFilter(baseQuery, timeRange);
+    console.log('🔍 Fetching issues (FILTERED strategy):', query);
+    return executeSearch(query);
 }
+/**
+ * Execute GitHub search and return issues
+ *
+ * @param query GitHub search query
+ * @returns Array of GitHub issues
+ */
 async function executeSearch(query) {
-  const result = await execFileNoThrow("gh", [
-    "search",
-    "issues",
-    query,
-    "--json",
-    "number,title,body,state,url,labels,milestone,repository",
-    "--limit",
-    "1000"
-    // Max results
-  ]);
-  if (result.status !== 0) {
-    throw new Error(`Failed to search issues: ${result.stderr || result.stdout}`);
-  }
-  if (!result.stdout.trim()) {
-    return [];
-  }
-  const issues = JSON.parse(result.stdout);
-  return issues.map((issue) => ({
-    number: issue.number,
-    title: issue.title,
-    body: issue.body || "",
-    state: issue.state,
-    html_url: issue.url,
-    url: issue.url,
-    labels: issue.labels?.map((l) => l.name) || [],
-    milestone: issue.milestone ? {
-      number: issue.milestone.number,
-      title: issue.milestone.title,
-      description: issue.milestone.description,
-      state: issue.milestone.state
-    } : void 0,
-    repository: issue.repository ? {
-      owner: issue.repository.owner.login,
-      name: issue.repository.name,
-      full_name: issue.repository.full_name
-    } : void 0
-  }));
+    const result = await execFileNoThrow('gh', [
+        'search',
+        'issues',
+        query,
+        '--json',
+        'number,title,body,state,url,labels,milestone,repository',
+        '--limit',
+        '1000', // Max results
+    ]);
+    if (result.status !== 0) {
+        throw new Error(`Failed to search issues: ${result.stderr || result.stdout}`);
+    }
+    if (!result.stdout.trim()) {
+        return [];
+    }
+    const issues = JSON.parse(result.stdout);
+    // Transform to GitHubIssue format
+    return issues.map((issue) => ({
+        number: issue.number,
+        title: issue.title,
+        body: issue.body || '',
+        state: issue.state,
+        html_url: issue.url,
+        url: issue.url,
+        labels: issue.labels?.map((l) => l.name) || [],
+        milestone: issue.milestone
+            ? {
+                number: issue.milestone.number,
+                title: issue.milestone.title,
+                description: issue.milestone.description,
+                state: issue.milestone.state,
+            }
+            : undefined,
+        repository: issue.repository
+            ? {
+                owner: issue.repository.owner.login,
+                name: issue.repository.name,
+                full_name: issue.repository.full_name,
+            }
+            : undefined,
+    }));
 }
-export {
-  buildHierarchicalSearchQuery,
-  fetchIssuesHierarchical
-};
+//# sourceMappingURL=github-hierarchical-sync.js.map

package/plugins/specweave-github/lib/github-issue-updater.js

@@ -139,7 +139,7 @@ async function loadIncrementMetadata(incrementId) {
 async function detectRepo() {
   try {
     const result = await execFileNoThrow("git", ["remote", "get-url", "origin"]);
-    if (result.status !== 0) {
+    if (result.exitCode !== 0) {
       return null;
     }
     const remote = result.stdout.trim();
@@ -167,7 +167,7 @@ async function getIssueBody(issueNumber, owner, repo) {
     "-q",
     ".body"
   ]);
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to get issue body: ${result.stderr}`);
   }
   return result.stdout.trim();
@@ -182,7 +182,7 @@ async function updateIssueBody(issueNumber, body, owner, repo) {
     "--body",
     body
   ]);
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to update issue body: ${result.stderr}`);
   }
 }
@@ -196,7 +196,7 @@ async function postComment(issueNumber, comment, owner, repo) {
     "--body",
     comment
   ]);
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to post comment: ${result.stderr}`);
   }
 }

package/plugins/specweave-github/lib/github-issue-updater.ts

@@ -254,7 +254,7 @@ export async function detectRepo(): Promise<{ owner: string; repo: string } | nu
   try {
     const result = await execFileNoThrow('git', ['remote', 'get-url', 'origin']);
 
-    if (result.status !== 0) {
+    if (result.exitCode !== 0) {
       return null;
     }
 
@@ -298,7 +298,7 @@ async function getIssueBody(
     '.body'
   ]);
 
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to get issue body: ${result.stderr}`);
   }
 
@@ -324,7 +324,7 @@ async function updateIssueBody(
     body
   ]);
 
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to update issue body: ${result.stderr}`);
   }
 }
@@ -348,7 +348,7 @@ async function postComment(
     comment
   ]);
 
-  if (result.status !== 0) {
+  if (result.exitCode !== 0) {
     throw new Error(`Failed to post comment: ${result.stderr}`);
   }
 }

package/plugins/specweave-github/lib/github-spec-commit-sync.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub Spec Commit Sync
+ *
+ * Posts commit/PR comments to GitHub issues linked to living docs specs.
+ * This enables traceability from spec user stories to actual code changes.
+ */
+import { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
+import { UserStory } from '../../../src/core/spec-task-mapper.js';
+export interface SyncOptions {
+    incrementPath: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    commentsPosted: number;
+    errors: string[];
+    commits: GitCommit[];
+    userStories: UserStory[];
+}
+/**
+ * Sync commits for completed user stories to GitHub issue
+ */
+export declare function syncSpecCommitsToGitHub(options: SyncOptions): Promise<SyncResult>;
+/**
+ * Post batch commit update to GitHub issue (for multiple commits)
+ */
+export declare function postCommitBatchUpdate(incrementPath: string, commits: GitCommit[], issueNumber: number, repo: GitRepository, dryRun?: boolean): Promise<boolean>;
+/**
+ * Check if spec commit sync is enabled in config
+ */
+export declare function isSpecCommitSyncEnabled(projectRoot: string): Promise<boolean>;
+/**
+ * Get GitHub issue number from spec metadata
+ */
+export declare function getGitHubIssueForSpec(specPath: string): Promise<number | null>;
+//# sourceMappingURL=github-spec-commit-sync.d.ts.map

package/plugins/specweave-github/lib/github-spec-commit-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-commit-sync.d.ts","sourceRoot":"","sources":["github-spec-commit-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,SAAS,EACT,aAAa,EAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,SAAS,EACV,MAAM,uCAAuC,CAAC;AAW/C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmKrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}