specweave 1.0.235 → 1.0.239

package/dist/plugins/specweave-github/lib/github-pull-sync.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GitHub Pull Sync — GitHub Issues → Spec
+ *
+ * Fetches GitHub issue state and compares with spec acceptance criteria
+ * to detect changes, conflicts, and apply updates.
+ *
+ * @module github-pull-sync
+ */
+import type { GitHubUserStoryLink } from '../../../src/core/types/sync-profile.js';
+export interface PullSyncOptions {
+    owner: string;
+    repo: string;
+    token?: string;
+    dryRun?: boolean;
+}
+export interface PullSyncChange {
+    userStoryId: string;
+    field: string;
+    specValue: string;
+    githubValue: string;
+    applied: boolean;
+}
+export interface PullSyncConflict {
+    userStoryId: string;
+    field: string;
+    specValue: string;
+    githubValue: string;
+}
+export interface PullSyncResult {
+    changes: PullSyncChange[];
+    conflicts: PullSyncConflict[];
+    errors: Array<{
+        userStoryId: string;
+        error: string;
+    }>;
+}
+/**
+ * Pull sync from GitHub — fetch issue state and compare with spec ACs.
+ *
+ * For each linked user story:
+ * 1. Fetch issue via `gh issue view`
+ * 2. Parse body to extract AC checkbox states
+ * 3. Compare with spec AC states
+ * 4. Report changes and conflicts
+ */
+export declare function pullSyncFromGitHub(userStoryLinks: Record<string, GitHubUserStoryLink>, specAcceptanceCriteria: Record<string, Array<{
+    id: string;
+    completed: boolean;
+}>>, options: PullSyncOptions): Promise<PullSyncResult>;
+export interface MultiRepoPullSyncOptions extends PullSyncOptions {
+}
+export interface MultiRepoDisagreement {
+    userStoryId: string;
+    field: string;
+    repoStates: Record<string, boolean>;
+}
+export interface MultiRepoPullSyncResult {
+    changes: PullSyncChange[];
+    conflicts: PullSyncConflict[];
+    disagreements: MultiRepoDisagreement[];
+    errors: Array<{
+        userStoryId?: string;
+        repo?: string;
+        error: string;
+    }>;
+}
+interface RepoConfig {
+    owner: string;
+    repo: string;
+    relevantStories: string[];
+}
+interface MultiRepoUserStoryLinks {
+    [usId: string]: Record<string, {
+        issueNumber: number;
+    }>;
+}
+/**
+ * Pull sync from multiple repos with all-repos-must-agree consensus.
+ *
+ * For shared user stories (appearing in 2+ repos):
+ * - AC is marked done ONLY if ALL repos agree it is done
+ * - Disagreements are recorded separately
+ *
+ * For repo-specific user stories (1 repo):
+ * - Standard single-repo logic applies
+ *
+ * Repo errors are non-blocking: erroring repos are excluded from consensus.
+ */
+export declare function pullSyncMultiRepo(repos: RepoConfig[], userStoryLinks: MultiRepoUserStoryLinks, specAcceptanceCriteria: Record<string, Array<{
+    id: string;
+    completed: boolean;
+}>>, options: MultiRepoPullSyncOptions): Promise<MultiRepoPullSyncResult>;
+export {};
+//# sourceMappingURL=github-pull-sync.d.ts.map

package/dist/plugins/specweave-github/lib/github-pull-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pull-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-pull-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,EACjF,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CA+BzB;AA+FD,MAAM,WAAW,wBAAyB,SAAQ,eAAe;CAAG;AAEpE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,UAAU,uBAAuB;IAC/B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,EAAE,uBAAuB,EACvC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,EACjF,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAwHlC"}

package/dist/plugins/specweave-github/lib/github-pull-sync.js

@@ -0,0 +1,232 @@
+/**
+ * GitHub Pull Sync — GitHub Issues → Spec
+ *
+ * Fetches GitHub issue state and compares with spec acceptance criteria
+ * to detect changes, conflicts, and apply updates.
+ *
+ * @module github-pull-sync
+ */
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { parseIssueBody } from './github-issue-body-parser.js';
+/**
+ * Pull sync from GitHub — fetch issue state and compare with spec ACs.
+ *
+ * For each linked user story:
+ * 1. Fetch issue via `gh issue view`
+ * 2. Parse body to extract AC checkbox states
+ * 3. Compare with spec AC states
+ * 4. Report changes and conflicts
+ */
+export async function pullSyncFromGitHub(userStoryLinks, specAcceptanceCriteria, options) {
+    const result = { changes: [], conflicts: [], errors: [] };
+    const entries = Object.entries(userStoryLinks);
+    if (entries.length === 0) {
+        return result;
+    }
+    const env = getEnv(options.token);
+    const repoSlug = `${options.owner}/${options.repo}`;
+    for (const [usId, link] of entries) {
+        try {
+            const issueData = await fetchIssue(link.issueNumber, repoSlug, env);
+            const parsed = parseIssueBody(issueData.body || '');
+            const specACs = specAcceptanceCriteria[usId] || [];
+            // Compare AC checkbox states
+            compareACStates(usId, specACs, parsed.acceptanceCriteria, options.dryRun ?? false, result);
+            // Compare issue state (open/closed)
+            compareIssueState(usId, issueData.state, specACs, result, options.dryRun ?? false);
+        }
+        catch (err) {
+            result.errors.push({
+                userStoryId: usId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return result;
+}
+function compareACStates(usId, specACs, githubACs, dryRun, result) {
+    for (const specAC of specACs) {
+        const ghAC = githubACs[specAC.id];
+        if (!ghAC)
+            continue;
+        const specValue = String(specAC.completed);
+        const githubValue = String(ghAC.checked);
+        if (specValue !== githubValue) {
+            // Both changed from a baseline? That's a conflict.
+            // Simple heuristic: if spec says true and GitHub says false, it's a conflict
+            // (someone completed on spec side, but GitHub unchecked it)
+            if (specAC.completed && !ghAC.checked) {
+                result.conflicts.push({
+                    userStoryId: usId,
+                    field: specAC.id,
+                    specValue,
+                    githubValue,
+                });
+            }
+            else {
+                // GitHub is ahead — record as a change
+                result.changes.push({
+                    userStoryId: usId,
+                    field: specAC.id,
+                    specValue,
+                    githubValue,
+                    applied: !dryRun,
+                });
+            }
+        }
+    }
+}
+function compareIssueState(usId, githubState, specACs, result, dryRun) {
+    // Normalize GitHub state
+    const normalizedState = githubState.toLowerCase() === 'closed' ? 'closed' : 'open';
+    // Check if spec is effectively "complete" (all ACs done) or "open"
+    const allDone = specACs.length > 0 && specACs.every(ac => ac.completed);
+    const specState = allDone ? 'closed' : 'open';
+    if (specState !== normalizedState) {
+        result.changes.push({
+            userStoryId: usId,
+            field: 'status',
+            specValue: specState,
+            githubValue: normalizedState,
+            applied: !dryRun,
+        });
+    }
+}
+async function fetchIssue(issueNumber, repoSlug, env) {
+    const res = await execFileNoThrow('gh', [
+        'issue', 'view', String(issueNumber),
+        '--repo', repoSlug,
+        '--json', 'title,body,state,labels',
+    ], { env });
+    if (!res.success) {
+        throw new Error(res.stderr || 'Failed to fetch issue');
+    }
+    return JSON.parse(res.stdout);
+}
+function getEnv(token) {
+    if (token) {
+        return { ...process.env, GH_TOKEN: token };
+    }
+    return process.env;
+}
+/**
+ * Pull sync from multiple repos with all-repos-must-agree consensus.
+ *
+ * For shared user stories (appearing in 2+ repos):
+ * - AC is marked done ONLY if ALL repos agree it is done
+ * - Disagreements are recorded separately
+ *
+ * For repo-specific user stories (1 repo):
+ * - Standard single-repo logic applies
+ *
+ * Repo errors are non-blocking: erroring repos are excluded from consensus.
+ */
+export async function pullSyncMultiRepo(repos, userStoryLinks, specAcceptanceCriteria, options) {
+    const result = {
+        changes: [],
+        conflicts: [],
+        disagreements: [],
+        errors: [],
+    };
+    if (repos.length === 0) {
+        return result;
+    }
+    const env = getEnv(options.token);
+    // Step 1: Fetch per-repo AC states
+    // Map: usId → acId → repoSlug → checked
+    const perRepoACStates = {};
+    const failedRepos = new Set();
+    for (const repo of repos) {
+        const repoSlug = `${repo.owner}/${repo.repo}`;
+        for (const usId of repo.relevantStories) {
+            const links = userStoryLinks[usId];
+            if (!links || !links[repoSlug])
+                continue;
+            const issueNumber = links[repoSlug].issueNumber;
+            try {
+                const issueData = await fetchIssue(issueNumber, repoSlug, env);
+                const parsed = parseIssueBody(issueData.body || '');
+                // Record AC states for this repo
+                if (!perRepoACStates[usId]) {
+                    perRepoACStates[usId] = {};
+                }
+                const specACs = specAcceptanceCriteria[usId] || [];
+                for (const specAC of specACs) {
+                    const ghAC = parsed.acceptanceCriteria[specAC.id];
+                    if (!ghAC)
+                        continue;
+                    if (!perRepoACStates[usId][specAC.id]) {
+                        perRepoACStates[usId][specAC.id] = {};
+                    }
+                    perRepoACStates[usId][specAC.id][repoSlug] = ghAC.checked;
+                }
+            }
+            catch (err) {
+                failedRepos.add(repoSlug);
+                result.errors.push({
+                    userStoryId: usId,
+                    repo: repoSlug,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    // Step 2: Build consensus per AC
+    for (const [usId, acMap] of Object.entries(perRepoACStates)) {
+        const specACs = specAcceptanceCriteria[usId] || [];
+        // Determine how many repos this US should appear in (excluding failed)
+        const usLinks = userStoryLinks[usId] || {};
+        const expectedRepos = Object.keys(usLinks).filter(r => !failedRepos.has(r));
+        for (const specAC of specACs) {
+            const repoStates = acMap[specAC.id];
+            if (!repoStates)
+                continue;
+            // Filter out failed repos
+            const validStates = Object.entries(repoStates).filter(([repo]) => !failedRepos.has(repo));
+            if (validStates.length === 0)
+                continue;
+            const allChecked = validStates.every(([, checked]) => checked);
+            const allUnchecked = validStates.every(([, checked]) => !checked);
+            const isShared = expectedRepos.length > 1;
+            if (isShared) {
+                // All-repos-must-agree consensus
+                if (allChecked && !specAC.completed) {
+                    result.changes.push({
+                        userStoryId: usId,
+                        field: specAC.id,
+                        specValue: String(specAC.completed),
+                        githubValue: 'true',
+                        applied: true,
+                    });
+                }
+                else if (!allChecked && !allUnchecked && !specAC.completed) {
+                    // Disagreement
+                    const stateMap = {};
+                    for (const [repo, checked] of validStates) {
+                        stateMap[repo] = checked;
+                    }
+                    result.disagreements.push({
+                        userStoryId: usId,
+                        field: specAC.id,
+                        repoStates: stateMap,
+                    });
+                }
+            }
+            else {
+                // Single-repo: use directly
+                const [, checked] = validStates[0];
+                if (checked && !specAC.completed) {
+                    result.changes.push({
+                        userStoryId: usId,
+                        field: specAC.id,
+                        specValue: String(specAC.completed),
+                        githubValue: 'true',
+                        applied: true,
+                    });
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=github-pull-sync.js.map

package/dist/plugins/specweave-github/lib/github-pull-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pull-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-pull-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-push-sync.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GitHub Push Sync — User Stories → GitHub Issues
+ *
+ * Creates or updates GitHub issues from SpecWeave user stories.
+ * Uses `gh` CLI for all operations (no direct HTTP).
+ *
+ * @module github-push-sync
+ */
+export interface UserStoryForSync {
+    id: string;
+    title: string;
+    description: string;
+    priority: string;
+    status: string;
+    acceptanceCriteria: Array<{
+        id: string;
+        description: string;
+        completed: boolean;
+    }>;
+    specId?: string;
+}
+export interface PushSyncOptions {
+    owner: string;
+    repo: string;
+    token?: string;
+    dryRun?: boolean;
+}
+export interface PushSyncResult {
+    created: Array<{
+        userStoryId: string;
+        issueNumber: number;
+        issueUrl: string;
+        issueNodeId: string;
+    }>;
+    updated: Array<{
+        userStoryId: string;
+        issueNumber: number;
+        issueUrl: string;
+    }>;
+    errors: Array<{
+        userStoryId: string;
+        error: string;
+    }>;
+}
+/**
+ * Push sync user stories to GitHub issues.
+ * For each US: search by [US-XXX] prefix, create if new, update if existing.
+ */
+export declare function pushSyncUserStories(userStories: UserStoryForSync[], options: PushSyncOptions): Promise<PushSyncResult>;
+//# sourceMappingURL=github-push-sync.d.ts.map

package/dist/plugins/specweave-github/lib/github-push-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-push-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-push-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpG,OAAO,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAoDzB"}

package/dist/plugins/specweave-github/lib/github-push-sync.js

@@ -0,0 +1,114 @@
+/**
+ * GitHub Push Sync — User Stories → GitHub Issues
+ *
+ * Creates or updates GitHub issues from SpecWeave user stories.
+ * Uses `gh` CLI for all operations (no direct HTTP).
+ *
+ * @module github-push-sync
+ */
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { generateIssueBody } from './github-issue-body-generator.js';
+/**
+ * Push sync user stories to GitHub issues.
+ * For each US: search by [US-XXX] prefix, create if new, update if existing.
+ */
+export async function pushSyncUserStories(userStories, options) {
+    const result = { created: [], updated: [], errors: [] };
+    if (options.dryRun) {
+        return result;
+    }
+    const env = getEnv(options.token);
+    const repoSlug = `${options.owner}/${options.repo}`;
+    for (const us of userStories) {
+        try {
+            const existing = await searchIssueByPrefix(us.id, repoSlug, env);
+            const body = generateIssueBody({
+                id: us.id,
+                title: us.title,
+                description: us.description,
+                priority: us.priority,
+                acceptanceCriteria: us.acceptanceCriteria,
+                specId: us.specId,
+            });
+            const title = `[${us.id}] ${us.title}`;
+            if (existing) {
+                // Update existing issue
+                const updated = await updateIssue(existing.number, title, body, repoSlug, env);
+                result.updated.push({
+                    userStoryId: us.id,
+                    issueNumber: updated.number,
+                    issueUrl: updated.url,
+                });
+            }
+            else {
+                // Create new issue
+                const created = await createIssue(title, body, us, repoSlug, env);
+                result.created.push({
+                    userStoryId: us.id,
+                    issueNumber: created.number,
+                    issueUrl: created.url,
+                    issueNodeId: created.node_id,
+                });
+            }
+        }
+        catch (err) {
+            result.errors.push({
+                userStoryId: us.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return result;
+}
+async function searchIssueByPrefix(usId, repoSlug, env) {
+    const res = await execFileNoThrow('gh', [
+        'issue', 'list',
+        '--repo', repoSlug,
+        '--search', `[${usId}] in:title`,
+        '--json', 'number,title,node_id',
+        '--limit', '1',
+    ], { env });
+    if (!res.success) {
+        throw new Error(`Search failed: ${res.stderr}`);
+    }
+    const issues = JSON.parse(res.stdout);
+    return issues.length > 0 ? issues[0] : null;
+}
+async function createIssue(title, body, us, repoSlug, env) {
+    const args = [
+        'issue', 'create',
+        '--repo', repoSlug,
+        '--title', title,
+        '--body', body,
+        '--label', 'user-story',
+        '--label', `spec:${us.specId || 'unknown'}`,
+        '--label', `priority:${us.priority}`,
+        '--json', 'number,url,node_id',
+    ];
+    const res = await execFileNoThrow('gh', args, { env });
+    if (!res.success) {
+        throw new Error(`Create failed: ${res.stderr}`);
+    }
+    return JSON.parse(res.stdout);
+}
+async function updateIssue(issueNumber, title, body, repoSlug, env) {
+    const args = [
+        'issue', 'edit', String(issueNumber),
+        '--repo', repoSlug,
+        '--title', title,
+        '--body', body,
+        '--json', 'number,url',
+    ];
+    const res = await execFileNoThrow('gh', args, { env });
+    if (!res.success) {
+        throw new Error(`Update failed: ${res.stderr}`);
+    }
+    return JSON.parse(res.stdout);
+}
+function getEnv(token) {
+    if (token) {
+        return { ...process.env, GH_TOKEN: token };
+    }
+    return process.env;
+}
+//# sourceMappingURL=github-push-sync.js.map

package/dist/plugins/specweave-github/lib/github-push-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-push-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-push-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-rate-limiter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * GitHub Rate Limiter
+ *
+ * Shared token-bucket rate limiter for multi-repo GitHub sync.
+ * Queries `gh api rate_limit`, tracks cumulative usage, and gates
+ * sync operations when approaching API limits.
+ *
+ * @module github-rate-limiter
+ */
+export interface RateLimitStatus {
+    /** Remaining requests in current window */
+    remaining: number;
+    /** Total limit per window */
+    limit: number;
+    /** When the rate limit resets */
+    resetAt: Date;
+    /** Percentage of limit used (0-100) */
+    percentUsed: number;
+}
+interface CanProceedResult {
+    allowed: boolean;
+    waitMs?: number;
+    reason?: string;
+}
+export declare class GitHubRateLimiter {
+    private token?;
+    private totalUsed;
+    private knownLimit;
+    constructor(token?: string);
+    /**
+     * Query current GitHub API rate limit via `gh api rate_limit`.
+     */
+    checkRateLimit(): Promise<RateLimitStatus>;
+    /**
+     * Estimate how many API calls a sync operation will require.
+     */
+    estimateApiCalls(specCount: number, userStoryCount: number): number;
+    /**
+     * Check whether a sync operation can proceed given the current rate limit.
+     */
+    canProceed(estimatedCalls: number): Promise<CanProceedResult>;
+    /**
+     * Record API calls made during a sync operation.
+     */
+    recordUsage(calls: number): void;
+    /**
+     * Get the percentage of the known limit used by this limiter instance.
+     */
+    getUsagePercent(): number;
+    private getEnv;
+}
+export {};
+//# sourceMappingURL=github-rate-limiter.d.ts.map

package/dist/plugins/specweave-github/lib/github-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-rate-limiter.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAEX,KAAK,CAAC,EAAE,MAAM;IAI1B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC;IAkChD;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAOnE;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBnE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB,OAAO,CAAC,MAAM;CAMf"}