specweave 0.12.6 → 0.13.0

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

@@ -0,0 +1,268 @@
+/**
+ * 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 = [];
+    // 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; // 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 = 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],
+    };
+}
+/**
+ * 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);
+}
+/**
+ * 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`;
+    // 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');
+    }
+    // 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');
+    }
+    // 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);
+    // 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,
+    }));
+}
+//# sourceMappingURL=github-hierarchical-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-hierarchical-sync.js","sourceRoot":"","sources":["github-hierarchical-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAA2B;IAE3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mBAAmB;IACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAEnC,0EAA0E;QAC1E,6EAA6E;QAC7E,IAAI,SAAS,CAAC,gBAAgB,IAAI,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxE,OAAO,CAAC,IAAI,CACV,qEAAqE,CACtE,CAAC;YACF,OAAO,CAAC,IAAI,CACV,8BAA8B,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEvB,wDAAwD;IACxD,6DAA6D;IAC7D,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IACvC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,OAAY;IACtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,iBAAiB;IACjB,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,YAAY;IACZ,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,mDAAmD;QACnD,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS;aACpC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC;aACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,SAAiB;IAC1D,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,CAAC,iBAAiB;IACjC,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,SAA4B,CAAC,CAAC;IAE1E,OAAO,GAAG,KAAK,YAAY,KAAK,KAAK,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,SAA0B;IAIpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAE5B,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,IAAI;YACP,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACjC,MAAM;QACR,KAAK,IAAI;YACP,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,IAAI;YACP,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,IAAI;YACP,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,IAAI;YACP,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,IAAI;YACP,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,KAAK;YACR,OAAO;gBACL,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACvC,CAAC;IACN,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAoB,EACpB,YAAoB,IAAI;IAExB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAsB,CAAC;IAE9C,2CAA2C;IAC3C,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,wCAAwC;IACxC,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,sCAAsC;IACtC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC3D,OAAO,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAAoB,EACpB,SAAiB;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,KAAK,GAAG,QAAQ,KAAK,IAAI,IAAI,WAAW,CAAC;IAE7C,iBAAiB;IACjB,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;IAE5D,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAAoB,EACpB,SAAiB;IAEjB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAEvC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,iCAAiC;IACjC,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAEzD,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;IAE5D,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,mBAAmB,CAChC,MAAoB,EACpB,SAAiB;IAEjB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAErC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,kCAAkC;IAClC,MAAM,SAAS,GAAG,MAAM,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAEjE,iBAAiB;IACjB,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;IAE9D,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE;QACzC,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,yDAAyD;QACzD,SAAS;QACT,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEzC,kCAAkC;IAClC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;QACjC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;QACnD,SAAS,EAAE,KAAK,CAAC,SAAS;YACxB,CAAC,CAAC;gBACE,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;gBAC9B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK;gBAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;gBACxC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK;aAC7B;YACH,CAAC,CAAC,SAAS;QACb,UAAU,EAAE,KAAK,CAAC,UAAU;YAC1B,CAAC,CAAC;gBACE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK;gBACnC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI;gBAC3B,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;aACtC;YACH,CAAC,CAAC,SAAS;KACd,CAAC,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,61 @@
+/**
+ * GitHub Issue Updater for Living Docs Sync
+ *
+ * Handles updating GitHub issues with living documentation links and content.
+ * Used by post-task-completion hook to keep GitHub issues in sync with SpecWeave docs.
+ *
+ * @module github-issue-updater
+ */
+export interface LivingDocsSection {
+    specs: string[];
+    architecture: string[];
+    diagrams: string[];
+}
+export interface IncrementMetadata {
+    id: string;
+    status: string;
+    type: string;
+    github?: {
+        issue: number;
+        url: string;
+        synced?: string;
+    };
+}
+/**
+ * Update GitHub issue with living docs section
+ */
+export declare function updateIssueLivingDocs(issueNumber: number, livingDocs: LivingDocsSection, owner: string, repo: string): Promise<void>;
+/**
+ * Post comment about ADR/HLD/diagram creation
+ */
+export declare function postArchitectureComment(issueNumber: number, docPath: string, owner: string, repo: string): Promise<void>;
+/**
+ * Post scope change comment
+ */
+export declare function postScopeChangeComment(issueNumber: number, changes: {
+    added?: string[];
+    removed?: string[];
+    modified?: string[];
+    reason?: string;
+    impact?: string;
+}, owner: string, repo: string): Promise<void>;
+/**
+ * Post status change comment (pause/resume/abandon)
+ */
+export declare function postStatusChangeComment(issueNumber: number, status: 'paused' | 'resumed' | 'abandoned', reason: string, owner: string, repo: string): Promise<void>;
+/**
+ * Collect living docs for an increment
+ */
+export declare function collectLivingDocs(incrementId: string): Promise<LivingDocsSection>;
+/**
+ * Load increment metadata
+ */
+export declare function loadIncrementMetadata(incrementId: string): Promise<IncrementMetadata | null>;
+/**
+ * Detect repository owner and name from git remote
+ */
+export declare function detectRepo(): Promise<{
+    owner: string;
+    repo: string;
+} | null>;
+//# sourceMappingURL=github-issue-updater.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-updater.d.ts","sourceRoot":"","sources":["github-issue-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,EAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqDvF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAalG;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBlF"}

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

@@ -0,0 +1,327 @@
+/**
+ * GitHub Issue Updater for Living Docs Sync
+ *
+ * Handles updating GitHub issues with living documentation links and content.
+ * Used by post-task-completion hook to keep GitHub issues in sync with SpecWeave docs.
+ *
+ * @module github-issue-updater
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+/**
+ * Update GitHub issue with living docs section
+ */
+export async function updateIssueLivingDocs(issueNumber, livingDocs, owner, repo) {
+    console.log(`📝 Updating GitHub issue #${issueNumber} with living docs...`);
+    // 1. Get current issue body
+    const currentBody = await getIssueBody(issueNumber, owner, repo);
+    // 2. Build living docs section
+    const livingDocsSection = buildLivingDocsSection(livingDocs, owner, repo);
+    // 3. Update or append living docs section
+    const updatedBody = updateBodyWithLivingDocs(currentBody, livingDocsSection);
+    // 4. Update issue
+    await updateIssueBody(issueNumber, updatedBody, owner, repo);
+    console.log(`✅ Living docs section updated in issue #${issueNumber}`);
+}
+/**
+ * Post comment about ADR/HLD/diagram creation
+ */
+export async function postArchitectureComment(issueNumber, docPath, owner, repo) {
+    const docType = getDocType(docPath);
+    const docName = path.basename(docPath, '.md');
+    const docUrl = `https://github.com/${owner}/${repo}/blob/develop/${docPath}`;
+    const comment = `
+🏗️ **${docType} Created**
+
+**Document**: [${docName}](${docUrl})
+
+**Path**: \`${docPath}\`
+
+---
+🤖 Auto-updated by SpecWeave
+`.trim();
+    await postComment(issueNumber, comment, owner, repo);
+    console.log(`✅ Posted ${docType} comment to issue #${issueNumber}`);
+}
+/**
+ * Post scope change comment
+ */
+export async function postScopeChangeComment(issueNumber, changes, owner, repo) {
+    const parts = ['**Scope Change Detected**', ''];
+    if (changes.added && changes.added.length > 0) {
+        parts.push('**Added**:');
+        changes.added.forEach(item => parts.push(`- ✅ ${item}`));
+        parts.push('');
+    }
+    if (changes.removed && changes.removed.length > 0) {
+        parts.push('**Removed**:');
+        changes.removed.forEach(item => parts.push(`- ❌ ${item}`));
+        parts.push('');
+    }
+    if (changes.modified && changes.modified.length > 0) {
+        parts.push('**Modified**:');
+        changes.modified.forEach(item => parts.push(`- 🔄 ${item}`));
+        parts.push('');
+    }
+    if (changes.reason) {
+        parts.push(`**Reason**: ${changes.reason}`);
+        parts.push('');
+    }
+    if (changes.impact) {
+        parts.push(`**Impact**: ${changes.impact}`);
+        parts.push('');
+    }
+    parts.push('---');
+    parts.push('🤖 Auto-updated by SpecWeave');
+    await postComment(issueNumber, parts.join('\n'), owner, repo);
+    console.log(`✅ Posted scope change comment to issue #${issueNumber}`);
+}
+/**
+ * Post status change comment (pause/resume/abandon)
+ */
+export async function postStatusChangeComment(issueNumber, status, reason, owner, repo) {
+    const emoji = {
+        paused: '⏸️',
+        resumed: '▶️',
+        abandoned: '🗑️'
+    }[status];
+    const title = {
+        paused: 'Increment Paused',
+        resumed: 'Increment Resumed',
+        abandoned: 'Increment Abandoned'
+    }[status];
+    const comment = `
+${emoji} **${title}**
+
+**Reason**: ${reason}
+
+**Timestamp**: ${new Date().toISOString()}
+
+---
+🤖 Auto-updated by SpecWeave
+`.trim();
+    await postComment(issueNumber, comment, owner, repo);
+    console.log(`✅ Posted ${status} comment to issue #${issueNumber}`);
+}
+/**
+ * Collect living docs for an increment
+ */
+export async function collectLivingDocs(incrementId) {
+    const livingDocs = {
+        specs: [],
+        architecture: [],
+        diagrams: []
+    };
+    // 1. Find specs
+    const specsDir = path.join(process.cwd(), '.specweave/docs/internal/specs');
+    if (await fs.pathExists(specsDir)) {
+        const specFiles = await fs.readdir(specsDir);
+        for (const file of specFiles) {
+            if (file.endsWith('.md') && !file.startsWith('README')) {
+                livingDocs.specs.push(path.join('.specweave/docs/internal/specs', file));
+            }
+        }
+    }
+    // 2. Find architecture docs (ADRs, HLDs)
+    const archDir = path.join(process.cwd(), '.specweave/docs/internal/architecture');
+    if (await fs.pathExists(archDir)) {
+        // ADRs
+        const adrDir = path.join(archDir, 'adr');
+        if (await fs.pathExists(adrDir)) {
+            const adrFiles = await fs.readdir(adrDir);
+            for (const file of adrFiles) {
+                if (file.endsWith('.md')) {
+                    livingDocs.architecture.push(path.join('.specweave/docs/internal/architecture/adr', file));
+                }
+            }
+        }
+        // HLDs
+        const hldFiles = await fs.readdir(archDir);
+        for (const file of hldFiles) {
+            if (file.startsWith('hld-') && file.endsWith('.md')) {
+                livingDocs.architecture.push(path.join('.specweave/docs/internal/architecture', file));
+            }
+        }
+    }
+    // 3. Find diagrams
+    const diagramsDir = path.join(process.cwd(), '.specweave/docs/internal/architecture/diagrams');
+    if (await fs.pathExists(diagramsDir)) {
+        const diagramFiles = await fs.readdir(diagramsDir);
+        for (const file of diagramFiles) {
+            if (file.endsWith('.mmd') || file.endsWith('.svg')) {
+                livingDocs.diagrams.push(path.join('.specweave/docs/internal/architecture/diagrams', file));
+            }
+        }
+    }
+    return livingDocs;
+}
+/**
+ * Load increment metadata
+ */
+export async function loadIncrementMetadata(incrementId) {
+    const metadataPath = path.join(process.cwd(), '.specweave/increments', incrementId, 'metadata.json');
+    if (!await fs.pathExists(metadataPath)) {
+        return null;
+    }
+    return await fs.readJson(metadataPath);
+}
+/**
+ * Detect repository owner and name from git remote
+ */
+export async function detectRepo() {
+    try {
+        const result = await execFileNoThrow('git', ['remote', 'get-url', 'origin']);
+        if (result.status !== 0) {
+            return null;
+        }
+        const remote = result.stdout.trim();
+        const match = remote.match(/github\.com[:/](.+)\/(.+?)(?:\.git)?$/);
+        if (!match) {
+            return null;
+        }
+        return {
+            owner: match[1],
+            repo: match[2]
+        };
+    }
+    catch (error) {
+        return null;
+    }
+}
+// =============================================================================
+// PRIVATE HELPERS
+// =============================================================================
+/**
+ * Get current issue body
+ */
+async function getIssueBody(issueNumber, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'view',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--json',
+        'body',
+        '-q',
+        '.body'
+    ]);
+    if (result.status !== 0) {
+        throw new Error(`Failed to get issue body: ${result.stderr}`);
+    }
+    return result.stdout.trim();
+}
+/**
+ * Update issue body
+ */
+async function updateIssueBody(issueNumber, body, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'edit',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--body',
+        body
+    ]);
+    if (result.status !== 0) {
+        throw new Error(`Failed to update issue body: ${result.stderr}`);
+    }
+}
+/**
+ * Post comment to issue
+ */
+async function postComment(issueNumber, comment, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'comment',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--body',
+        comment
+    ]);
+    if (result.status !== 0) {
+        throw new Error(`Failed to post comment: ${result.stderr}`);
+    }
+}
+/**
+ * Build living docs section for issue body
+ */
+function buildLivingDocsSection(livingDocs, owner, repo) {
+    const parts = ['## 📚 Living Documentation', ''];
+    // Specs
+    if (livingDocs.specs.length > 0) {
+        parts.push('**Specifications**:');
+        livingDocs.specs.forEach(spec => {
+            const name = path.basename(spec, '.md');
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${spec}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    // Architecture
+    if (livingDocs.architecture.length > 0) {
+        parts.push('**Architecture**:');
+        livingDocs.architecture.forEach(doc => {
+            const name = path.basename(doc, '.md');
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${doc}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    // Diagrams
+    if (livingDocs.diagrams.length > 0) {
+        parts.push('**Diagrams**:');
+        livingDocs.diagrams.forEach(diagram => {
+            const name = path.basename(diagram);
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${diagram}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    parts.push('---');
+    return parts.join('\n');
+}
+/**
+ * Update body with living docs section
+ */
+function updateBodyWithLivingDocs(currentBody, livingDocsSection) {
+    // Check if living docs section already exists
+    const marker = '## 📚 Living Documentation';
+    if (currentBody.includes(marker)) {
+        // Replace existing section
+        const beforeMarker = currentBody.substring(0, currentBody.indexOf(marker));
+        const afterMarker = currentBody.substring(currentBody.indexOf(marker));
+        // Find end of section (next ## header or end of body)
+        const nextSection = afterMarker.indexOf('\n## ', 1);
+        const replacement = nextSection > 0
+            ? afterMarker.substring(0, nextSection)
+            : afterMarker;
+        return beforeMarker + livingDocsSection + (nextSection > 0 ? afterMarker.substring(nextSection) : '');
+    }
+    else {
+        // Append at end
+        return currentBody + '\n\n' + livingDocsSection;
+    }
+}
+/**
+ * Determine document type from path
+ */
+function getDocType(docPath) {
+    if (docPath.includes('/adr/')) {
+        return 'Architecture Decision Record (ADR)';
+    }
+    if (docPath.includes('/diagrams/')) {
+        return 'Architecture Diagram';
+    }
+    if (docPath.startsWith('hld-')) {
+        return 'High-Level Design (HLD)';
+    }
+    if (docPath.includes('/specs/')) {
+        return 'Specification';
+    }
+    return 'Documentation';
+}
+//# sourceMappingURL=github-issue-updater.js.map