specweave 1.0.506 → 1.0.508

package/dist/plugins/specweave/lib/integrations/github/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/lib/integrations/github/github-pull-sync.js.map

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

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

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

@@ -0,0 +1,127 @@
+/**
+ * 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';
+import { SyncError } from '../../../../../src/core/errors/sync-error.js';
+/**
+ * Extract HTTP status code from gh CLI stderr output.
+ * gh CLI typically outputs "HTTP 401: Bad credentials" or similar.
+ */
+function parseHttpStatus(stderr) {
+    const match = stderr.match(/HTTP\s+(\d{3})/);
+    return match ? parseInt(match[1], 10) : 0;
+}
+/**
+ * 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,
+        '--state', 'all',
+        '--search', `[${usId}] in:title`,
+        '--json', 'number,title,node_id',
+        '--limit', '1',
+    ], { env });
+    if (!res.success) {
+        const status = parseHttpStatus(res.stderr);
+        throw new SyncError('github', status, res.stderr, `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) {
+        const status = parseHttpStatus(res.stderr);
+        throw new SyncError('github', status, res.stderr, `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) {
+        const status = parseHttpStatus(res.stderr);
+        throw new SyncError('github', status, res.stderr, `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/lib/integrations/github/github-push-sync.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-rate-limiter.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/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"}

package/dist/plugins/specweave/lib/integrations/github/github-rate-limiter.js

@@ -0,0 +1,109 @@
+/**
+ * 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
+ */
+import { execFileNoThrow } from '../../../../../src/utils/execFileNoThrow.js';
+/** Calls per user story: search + create/update + labels */
+const CALLS_PER_USER_STORY = 3;
+/** Overhead per spec: milestone check, project check */
+const CALLS_PER_SPEC_OVERHEAD = 2;
+export class GitHubRateLimiter {
+    constructor(token) {
+        this.totalUsed = 0;
+        this.knownLimit = 0;
+        this.token = token;
+    }
+    /**
+     * Query current GitHub API rate limit via `gh api rate_limit`.
+     */
+    async checkRateLimit() {
+        const env = this.getEnv();
+        const result = await execFileNoThrow('gh', ['api', 'rate_limit'], { env });
+        if (!result.success) {
+            throw new Error(`gh CLI failed: ${result.stderr || result.error?.message || 'unknown error'}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        }
+        catch {
+            throw new Error(`Failed to parse rate limit response: ${result.stdout.slice(0, 100)}`);
+        }
+        const core = parsed?.resources?.core;
+        if (!core || core.remaining === undefined || core.limit === undefined || core.reset === undefined) {
+            throw new Error('Rate limit response missing expected fields (resources.core)');
+        }
+        this.knownLimit = core.limit;
+        const percentUsed = core.limit > 0
+            ? ((core.limit - core.remaining) / core.limit) * 100
+            : 0;
+        return {
+            remaining: core.remaining,
+            limit: core.limit,
+            resetAt: new Date(core.reset * 1000),
+            percentUsed,
+        };
+    }
+    /**
+     * Estimate how many API calls a sync operation will require.
+     */
+    estimateApiCalls(specCount, userStoryCount) {
+        if (specCount === 0 && userStoryCount === 0) {
+            return 0;
+        }
+        return (specCount * CALLS_PER_SPEC_OVERHEAD) + (userStoryCount * CALLS_PER_USER_STORY);
+    }
+    /**
+     * Check whether a sync operation can proceed given the current rate limit.
+     */
+    async canProceed(estimatedCalls) {
+        const status = await this.checkRateLimit();
+        if (estimatedCalls > status.remaining) {
+            const waitMs = Math.max(0, status.resetAt.getTime() - Date.now());
+            return {
+                allowed: false,
+                waitMs,
+                reason: `Rate limit: need ${estimatedCalls} calls but only ${status.remaining}/${status.limit} remaining. Resets in ${Math.ceil(waitMs / 1000)}s`,
+            };
+        }
+        if (status.percentUsed > 90) {
+            const waitMs = Math.max(0, status.resetAt.getTime() - Date.now());
+            return {
+                allowed: false,
+                waitMs,
+                reason: `Rate limit at ${status.percentUsed.toFixed(0)}% — too high to proceed safely`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record API calls made during a sync operation.
+     */
+    recordUsage(calls) {
+        if (calls < 0) {
+            throw new Error('Cannot record negative usage');
+        }
+        this.totalUsed += calls;
+    }
+    /**
+     * Get the percentage of the known limit used by this limiter instance.
+     */
+    getUsagePercent() {
+        if (this.knownLimit === 0)
+            return 0;
+        const pct = (this.totalUsed / this.knownLimit) * 100;
+        return Math.min(pct, 100);
+    }
+    getEnv() {
+        if (this.token) {
+            return { ...process.env, GH_TOKEN: this.token };
+        }
+        return process.env;
+    }
+}
+//# sourceMappingURL=github-rate-limiter.js.map

package/dist/plugins/specweave/lib/integrations/github/github-rate-limiter.js.map

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

package/dist/plugins/specweave/lib/integrations/github/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/specs/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/dist/plugins/specweave/lib/integrations/github/github-spec-commit-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-commit-sync.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/github-spec-commit-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,SAAS,EACT,aAAa,EAEd,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAIL,SAAS,EACV,MAAM,mDAAmD,CAAC;AAW3D,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"}