specweave 1.0.235 → 1.0.239

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

@@ -0,0 +1,50 @@
+/**
+ * GitHub Field Sync — Status and Priority field sync for Projects V2
+ *
+ * Syncs Status and Priority custom fields on Projects V2 items
+ * using configurable field mappings.
+ *
+ * @module github-field-sync
+ */
+import type { GitHubGraphQLClient } from './github-graphql-client.js';
+export interface FieldSyncConfig {
+    projectId: string;
+    statusFieldMapping?: Record<string, string>;
+    priorityFieldMapping?: Record<string, string>;
+}
+export interface FieldSyncItem {
+    itemId: string;
+    status?: string;
+    priority?: string;
+}
+export interface FieldSyncResult {
+    updated: Array<{
+        itemId: string;
+        field: string;
+        value: string;
+    }>;
+    warnings: Array<{
+        itemId: string;
+        field: string;
+        message: string;
+    }>;
+}
+export declare class GitHubFieldSync {
+    private client;
+    private config;
+    private statusField?;
+    private priorityField?;
+    private fieldsLoaded;
+    constructor(client: GitHubGraphQLClient, config: FieldSyncConfig);
+    /**
+     * Load project fields and cache field IDs and option IDs.
+     */
+    loadFields(): Promise<void>;
+    /**
+     * Sync fields for one or more items.
+     * Auto-calls loadFields if not called yet.
+     */
+    syncItemFields(items: FieldSyncItem[]): Promise<FieldSyncResult>;
+    private syncField;
+}
+//# sourceMappingURL=github-field-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-field-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-field-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAqBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,eAAe;IAKhE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;YAwBxD,SAAS;CAkDxB"}

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

@@ -0,0 +1,107 @@
+/**
+ * GitHub Field Sync — Status and Priority field sync for Projects V2
+ *
+ * Syncs Status and Priority custom fields on Projects V2 items
+ * using configurable field mappings.
+ *
+ * @module github-field-sync
+ */
+const DEFAULT_STATUS_MAPPING = {
+    'planned': 'Todo',
+    'in-progress': 'In Progress',
+    'completed': 'Done',
+};
+const DEFAULT_PRIORITY_MAPPING = {
+    'P1': 'Urgent',
+    'P2': 'High',
+    'P3': 'Medium',
+    'P4': 'Low',
+};
+export class GitHubFieldSync {
+    constructor(client, config) {
+        this.fieldsLoaded = false;
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Load project fields and cache field IDs and option IDs.
+     */
+    async loadFields() {
+        if (this.fieldsLoaded)
+            return;
+        const fields = await this.client.getProjectFields(this.config.projectId);
+        for (const field of fields) {
+            if (field.name === 'Status' && field.options) {
+                this.statusField = {
+                    id: field.id,
+                    name: field.name,
+                    options: new Map(field.options.map(o => [o.name, o.id])),
+                };
+            }
+            else if (field.name === 'Priority' && field.options) {
+                this.priorityField = {
+                    id: field.id,
+                    name: field.name,
+                    options: new Map(field.options.map(o => [o.name, o.id])),
+                };
+            }
+        }
+        this.fieldsLoaded = true;
+    }
+    /**
+     * Sync fields for one or more items.
+     * Auto-calls loadFields if not called yet.
+     */
+    async syncItemFields(items) {
+        if (!this.fieldsLoaded) {
+            await this.loadFields();
+        }
+        const result = { updated: [], warnings: [] };
+        for (const item of items) {
+            // Sync Status field
+            if (item.status !== undefined) {
+                await this.syncField(item, 'Status', item.status, this.statusField, this.config.statusFieldMapping ?? DEFAULT_STATUS_MAPPING, result);
+            }
+            // Sync Priority field
+            if (item.priority !== undefined) {
+                await this.syncField(item, 'Priority', item.priority, this.priorityField, this.config.priorityFieldMapping ?? DEFAULT_PRIORITY_MAPPING, result);
+            }
+        }
+        return result;
+    }
+    async syncField(item, fieldName, value, cachedField, mapping, result) {
+        if (!cachedField) {
+            result.warnings.push({
+                itemId: item.itemId,
+                field: fieldName,
+                message: `${fieldName} field not found on project`,
+            });
+            return;
+        }
+        const mappedValue = mapping[value];
+        if (!mappedValue) {
+            result.warnings.push({
+                itemId: item.itemId,
+                field: fieldName,
+                message: `No mapping found for ${fieldName} value "${value}"`,
+            });
+            return;
+        }
+        const optionId = cachedField.options.get(mappedValue);
+        if (!optionId) {
+            result.warnings.push({
+                itemId: item.itemId,
+                field: fieldName,
+                message: `Option "${mappedValue}" not found on ${fieldName} field`,
+            });
+            return;
+        }
+        await this.client.updateItemFieldValue(this.config.projectId, item.itemId, cachedField.id, { singleSelectOptionId: optionId });
+        result.updated.push({
+            itemId: item.itemId,
+            field: fieldName,
+            value: mappedValue,
+        });
+    }
+}
+//# sourceMappingURL=github-field-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-field-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-field-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,MAAM,sBAAsB,GAA2B;IACrD,SAAS,EAAE,MAAM;IACjB,aAAa,EAAE,aAAa;IAC5B,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,wBAAwB,GAA2B;IACvD,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,OAAO,eAAe;IAO1B,YAAY,MAA2B,EAAE,MAAuB;QAFxD,iBAAY,GAAG,KAAK,CAAC;QAG3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAE9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7C,IAAI,CAAC,WAAW,GAAG;oBACjB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;iBACzD,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,aAAa,GAAG;oBACnB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;iBACzD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,KAAsB;QACzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,MAAM,GAAoB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,oBAAoB;YACpB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAChE,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;YAED,sBAAsB;YACtB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EACtE,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,IAAmB,EACnB,SAAiB,EACjB,KAAa,EACb,WAAoC,EACpC,OAA+B,EAC/B,MAAuB;QAEvB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,GAAG,SAAS,6BAA6B;aACnD,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,wBAAwB,SAAS,WAAW,KAAK,GAAG;aAC9D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,WAAW,WAAW,kBAAkB,SAAS,QAAQ;aACnE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CACpC,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,IAAI,CAAC,MAAM,EACX,WAAW,CAAC,EAAE,EACd,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/plugins/specweave-github/lib/github-graphql-client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * GitHub GraphQL Client for Projects V2
+ *
+ * Wraps `gh api graphql` CLI calls for GitHub Projects V2 operations.
+ * All calls use child_process.execFile for security (no shell interpolation).
+ *
+ * @module github-graphql-client
+ */
+interface ProjectField {
+    id: string;
+    name: string;
+    options?: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+export declare class GitHubGraphQLClient {
+    private token?;
+    constructor(token?: string);
+    /**
+     * Resolve an owner login (user or org) to a node ID.
+     * Tries user first, falls back to organization.
+     */
+    getOwnerNodeId(login: string): Promise<string>;
+    /**
+     * Create a new GitHub Projects V2 board.
+     */
+    createProjectV2(ownerId: string, title: string): Promise<{
+        id: string;
+        number: number;
+    }>;
+    /**
+     * Add an issue (by node ID) to a Projects V2 board.
+     * Returns the project item ID. Idempotent.
+     */
+    addProjectV2Item(projectId: string, contentId: string): Promise<string>;
+    /**
+     * Update a field value on a Projects V2 item.
+     */
+    updateItemFieldValue(projectId: string, itemId: string, fieldId: string, value: {
+        singleSelectOptionId: string;
+    }): Promise<void>;
+    /**
+     * Get field definitions for a Projects V2 board.
+     */
+    getProjectFields(projectId: string): Promise<ProjectField[]>;
+    /**
+     * Execute a GraphQL query via `gh api graphql`.
+     */
+    private executeGraphQL;
+}
+export {};
+//# sourceMappingURL=github-graphql-client.d.ts.map

package/dist/plugins/specweave-github/lib/github-graphql-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-graphql-client.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-graphql-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAOD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,KAAK,CAAC,EAAE,MAAM;IAI1B;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBpD;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAY9F;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY7E;;OAEG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkClE;;OAEG;IACH,OAAO,CAAC,cAAc;CAiCvB"}

package/dist/plugins/specweave-github/lib/github-graphql-client.js

@@ -0,0 +1,138 @@
+/**
+ * GitHub GraphQL Client for Projects V2
+ *
+ * Wraps `gh api graphql` CLI calls for GitHub Projects V2 operations.
+ * All calls use child_process.execFile for security (no shell interpolation).
+ *
+ * @module github-graphql-client
+ */
+import { execFile } from 'child_process';
+export class GitHubGraphQLClient {
+    constructor(token) {
+        this.token = token;
+    }
+    /**
+     * Resolve an owner login (user or org) to a node ID.
+     * Tries user first, falls back to organization.
+     */
+    async getOwnerNodeId(login) {
+        // Try user query first
+        const userQuery = `query { user(login: "${login}") { id } }`;
+        const userResult = await this.executeGraphQL(userQuery);
+        if (userResult.data?.user && userResult.data.user.id) {
+            return userResult.data.user.id;
+        }
+        // Fallback to organization
+        const orgQuery = `query { organization(login: "${login}") { id } }`;
+        const orgResult = await this.executeGraphQL(orgQuery);
+        if (orgResult.data?.organization && orgResult.data.organization.id) {
+            return orgResult.data.organization.id;
+        }
+        throw new Error(`Could not resolve to a User or Organization with the login of '${login}'.`);
+    }
+    /**
+     * Create a new GitHub Projects V2 board.
+     */
+    async createProjectV2(ownerId, title) {
+        const query = `mutation {
+      createProjectV2(input: { ownerId: "${ownerId}", title: "${title}" }) {
+        projectV2 { id number }
+      }
+    }`;
+        const result = await this.executeGraphQL(query);
+        const project = result.data?.createProjectV2?.projectV2;
+        return { id: project.id, number: project.number };
+    }
+    /**
+     * Add an issue (by node ID) to a Projects V2 board.
+     * Returns the project item ID. Idempotent.
+     */
+    async addProjectV2Item(projectId, contentId) {
+        const query = `mutation {
+      addProjectV2ItemById(input: { projectId: "${projectId}", contentId: "${contentId}" }) {
+        item { id }
+      }
+    }`;
+        const result = await this.executeGraphQL(query);
+        const item = result.data?.addProjectV2ItemById?.item;
+        return item.id;
+    }
+    /**
+     * Update a field value on a Projects V2 item.
+     */
+    async updateItemFieldValue(projectId, itemId, fieldId, value) {
+        const query = `mutation {
+      updateProjectV2ItemFieldValue(input: {
+        projectId: "${projectId}",
+        itemId: "${itemId}",
+        fieldId: "${fieldId}",
+        value: { singleSelectOptionId: "${value.singleSelectOptionId}" }
+      }) {
+        projectV2Item { id }
+      }
+    }`;
+        await this.executeGraphQL(query);
+    }
+    /**
+     * Get field definitions for a Projects V2 board.
+     */
+    async getProjectFields(projectId) {
+        const query = `query {
+      node(id: "${projectId}") {
+        ... on ProjectV2 {
+          fields(first: 50) {
+            nodes {
+              ... on ProjectV2Field { id name dataType }
+              ... on ProjectV2SingleSelectField {
+                id name dataType
+                options { id name }
+              }
+            }
+          }
+        }
+      }
+    }`;
+        const result = await this.executeGraphQL(query);
+        const fields = result.data?.node?.fields?.nodes || [];
+        return fields.map((f) => {
+            const field = { id: f.id, name: f.name };
+            if (f.options && f.options.length > 0) {
+                field.options = f.options;
+            }
+            return field;
+        });
+    }
+    /**
+     * Execute a GraphQL query via `gh api graphql`.
+     */
+    executeGraphQL(query) {
+        return new Promise((resolve, reject) => {
+            const args = ['api', 'graphql', '-f', `query=${query}`];
+            const opts = {};
+            if (this.token) {
+                opts.env = { ...process.env, GH_TOKEN: this.token };
+            }
+            execFile('gh', args, opts, (err, stdout, stderr) => {
+                if (err) {
+                    reject(new Error(stderr || err.message));
+                    return;
+                }
+                let parsed;
+                try {
+                    parsed = JSON.parse(stdout);
+                }
+                catch {
+                    reject(new Error(`Failed to parse GraphQL response: ${stdout.slice(0, 200)}`));
+                    return;
+                }
+                if (parsed.errors && parsed.errors.length > 0) {
+                    const messages = parsed.errors.map((e) => e.message).join('; ');
+                    reject(new Error(`GraphQL error: ${messages}`));
+                    return;
+                }
+                resolve(parsed);
+            });
+        });
+    }
+}
+//# sourceMappingURL=github-graphql-client.js.map

package/dist/plugins/specweave-github/lib/github-graphql-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-graphql-client.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-graphql-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAazC,MAAM,OAAO,mBAAmB;IAG9B,YAAY,KAAc;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,uBAAuB;QACvB,MAAM,SAAS,GAAG,wBAAwB,KAAK,aAAa,CAAC;QAC7D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,IAAK,UAAU,CAAC,IAAI,CAAC,IAAwB,CAAC,EAAE,EAAE,CAAC;YAC1E,OAAQ,UAAU,CAAC,IAAI,CAAC,IAAuB,CAAC,EAAE,CAAC;QACrD,CAAC;QAED,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,gCAAgC,KAAK,aAAa,CAAC;QACpE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEtD,IAAI,SAAS,CAAC,IAAI,EAAE,YAAY,IAAK,SAAS,CAAC,IAAI,CAAC,YAAgC,CAAC,EAAE,EAAE,CAAC;YACxF,OAAQ,SAAS,CAAC,IAAI,CAAC,YAA+B,CAAC,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,kEAAkE,KAAK,IAAI,CAAC,CAAC;IAC/F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAa;QAClD,MAAM,KAAK,GAAG;2CACyB,OAAO,cAAc,KAAK;;;MAG/D,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,GAAI,MAAM,CAAC,IAAI,EAAE,eAAiE,EAAE,SAAS,CAAC;QAC3G,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;QACzD,MAAM,KAAK,GAAG;kDACgC,SAAS,kBAAkB,SAAS;;;MAGhF,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,GAAI,MAAM,CAAC,IAAI,EAAE,oBAAiD,EAAE,IAAI,CAAC;QACnF,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,MAAc,EACd,OAAe,EACf,KAAuC;QAEvC,MAAM,KAAK,GAAG;;sBAEI,SAAS;mBACZ,MAAM;oBACL,OAAO;0CACe,KAAK,CAAC,oBAAoB;;;;MAI9D,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,MAAM,KAAK,GAAG;kBACA,SAAS;;;;;;;;;;;;;MAarB,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,MAAM,GAAI,MAAM,CAAC,IAAI,EAAE,IAKtB,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAE7B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,MAAM,KAAK,GAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;YAC5B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAa;QAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,GAAgC,EAAE,CAAC;YAE7C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACtD,CAAC;YAED,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;oBACzC,OAAO;gBACT,CAAC;gBAED,IAAI,MAAuB,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC/E,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChE,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC,CAAC;oBAChD,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/plugins/specweave-github/lib/github-issue-body-generator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * GitHub Issue Body Generator
+ *
+ * Generates GitHub issue body markdown from a User Story.
+ * Used by the spec-to-issue push sync to create rich issue content
+ * with AC checkboxes, priority badges, and sync markers.
+ *
+ * @module github-issue-body-generator
+ */
+export interface UserStoryInput {
+    /** User story ID, e.g., "US-001" */
+    id: string;
+    /** User story title */
+    title: string;
+    /** User story description */
+    description: string;
+    /** Priority, e.g., "P1" */
+    priority: string;
+    /** Acceptance criteria */
+    acceptanceCriteria: Array<{
+        id: string;
+        description: string;
+        completed: boolean;
+    }>;
+    /** Spec ID, e.g., "spec-001" */
+    specId?: string;
+    /** Local file path to the spec */
+    specPath?: string;
+}
+/**
+ * Generate a GitHub issue body from a User Story input.
+ *
+ * Output format:
+ * - Description section
+ * - AC checkboxes between specweave markers
+ * - Priority badge
+ * - Sync footer marker
+ */
+export declare function generateIssueBody(userStory: UserStoryInput): string;
+//# sourceMappingURL=github-issue-body-generator.d.ts.map

package/dist/plugins/specweave-github/lib/github-issue-body-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-body-generator.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-body-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,kBAAkB,EAAE,KAAK,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAmCnE"}

package/dist/plugins/specweave-github/lib/github-issue-body-generator.js

@@ -0,0 +1,50 @@
+/**
+ * GitHub Issue Body Generator
+ *
+ * Generates GitHub issue body markdown from a User Story.
+ * Used by the spec-to-issue push sync to create rich issue content
+ * with AC checkboxes, priority badges, and sync markers.
+ *
+ * @module github-issue-body-generator
+ */
+/**
+ * Generate a GitHub issue body from a User Story input.
+ *
+ * Output format:
+ * - Description section
+ * - AC checkboxes between specweave markers
+ * - Priority badge
+ * - Sync footer marker
+ */
+export function generateIssueBody(userStory) {
+    const lines = [];
+    // Description
+    lines.push('## Description');
+    lines.push('');
+    lines.push(userStory.description);
+    lines.push('');
+    // Priority badge
+    lines.push(`**Priority**: ${userStory.priority}`);
+    lines.push('');
+    // Acceptance Criteria with markers
+    if (userStory.acceptanceCriteria.length > 0) {
+        lines.push('## Acceptance Criteria');
+        lines.push('');
+        lines.push('<!-- specweave:ac-start -->');
+        for (const ac of userStory.acceptanceCriteria) {
+            const checkbox = ac.completed ? '[x]' : '[ ]';
+            lines.push(`- ${checkbox} **${ac.id}**: ${ac.description}`);
+        }
+        lines.push('<!-- specweave:ac-end -->');
+        lines.push('');
+    }
+    // Sync footer marker
+    const syncParts = [];
+    if (userStory.specId) {
+        syncParts.push(`spec=${userStory.specId}`);
+    }
+    syncParts.push(`us=${userStory.id}`);
+    lines.push(`<!-- specweave:sync ${syncParts.join(' ')} -->`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=github-issue-body-generator.js.map

package/dist/plugins/specweave-github/lib/github-issue-body-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-body-generator.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-body-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAyB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,iBAAiB;IACjB,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mCAAmC;IACnC,IAAI,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,kBAAkB,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,uBAAuB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/plugins/specweave-github/lib/github-issue-body-parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GitHub Issue Body Parser
+ *
+ * Parses AC checkbox state and sync metadata from a GitHub issue body.
+ * Used by the pull sync to detect changes made on GitHub.
+ *
+ * @module github-issue-body-parser
+ */
+export interface ParsedIssueBody {
+    /** AC ID → checked state and description */
+    acceptanceCriteria: Record<string, {
+        checked: boolean;
+        description: string;
+    }>;
+    /** Sync marker metadata (if present) */
+    syncMarker?: {
+        specId: string;
+        userStoryId: string;
+    };
+}
+/**
+ * Parse a GitHub issue body to extract AC checkbox states and sync metadata.
+ *
+ * Strategy:
+ * 1. Try to find ACs within "## Acceptance Criteria" section
+ * 2. Fallback: scan entire body for AC-pattern checkboxes
+ * 3. Parse sync footer marker if present
+ */
+export declare function parseIssueBody(body: string): ParsedIssueBody;
+//# sourceMappingURL=github-issue-body-parser.d.ts.map

package/dist/plugins/specweave-github/lib/github-issue-body-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-body-parser.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-body-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,wCAAwC;IACxC,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAQD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA6D5D"}

package/dist/plugins/specweave-github/lib/github-issue-body-parser.js

@@ -0,0 +1,75 @@
+/**
+ * GitHub Issue Body Parser
+ *
+ * Parses AC checkbox state and sync metadata from a GitHub issue body.
+ * Used by the pull sync to detect changes made on GitHub.
+ *
+ * @module github-issue-body-parser
+ */
+// Regex to match AC checkboxes: - [x] **AC-US1-01**: Description
+const AC_CHECKBOX_RE = /^-\s+\[([ xX])\]\s+\*\*(?<acId>AC-[A-Z0-9]+-\d+)\*\*:\s*(?<desc>.+)$/;
+// Regex to match sync footer marker
+const SYNC_MARKER_RE = /<!--\s*specweave:sync\s+(?:spec=(?<specId>[^\s]+)\s+)?us=(?<usId>[^\s]+)\s*-->/;
+/**
+ * Parse a GitHub issue body to extract AC checkbox states and sync metadata.
+ *
+ * Strategy:
+ * 1. Try to find ACs within "## Acceptance Criteria" section
+ * 2. Fallback: scan entire body for AC-pattern checkboxes
+ * 3. Parse sync footer marker if present
+ */
+export function parseIssueBody(body) {
+    const result = {
+        acceptanceCriteria: {},
+    };
+    if (!body || !body.trim()) {
+        return result;
+    }
+    const lines = body.split('\n');
+    // Try to find the "## Acceptance Criteria" section
+    let inAcSection = false;
+    let foundAcSection = false;
+    for (const line of lines) {
+        // Detect section boundaries
+        if (/^##\s+Acceptance Criteria/i.test(line)) {
+            inAcSection = true;
+            foundAcSection = true;
+            continue;
+        }
+        if (inAcSection && /^##\s+/.test(line)) {
+            inAcSection = false;
+            continue;
+        }
+        if (inAcSection) {
+            const match = line.match(AC_CHECKBOX_RE);
+            if (match?.groups) {
+                result.acceptanceCriteria[match.groups.acId] = {
+                    checked: match[1] !== ' ',
+                    description: match.groups.desc.trim(),
+                };
+            }
+        }
+    }
+    // Fallback: if no AC section found, scan the entire body
+    if (!foundAcSection) {
+        for (const line of lines) {
+            const match = line.match(AC_CHECKBOX_RE);
+            if (match?.groups) {
+                result.acceptanceCriteria[match.groups.acId] = {
+                    checked: match[1] !== ' ',
+                    description: match.groups.desc.trim(),
+                };
+            }
+        }
+    }
+    // Parse sync footer marker
+    const syncMatch = body.match(SYNC_MARKER_RE);
+    if (syncMatch?.groups?.usId) {
+        result.syncMarker = {
+            specId: syncMatch.groups.specId || '',
+            userStoryId: syncMatch.groups.usId,
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=github-issue-body-parser.js.map

package/dist/plugins/specweave-github/lib/github-issue-body-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-body-parser.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-body-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,iEAAiE;AACjE,MAAM,cAAc,GAAG,sEAAsE,CAAC;AAE9F,oCAAoC;AACpC,MAAM,cAAc,GAAG,gFAAgF,CAAC;AAExG;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAoB;QAC9B,kBAAkB,EAAE,EAAE;KACvB,CAAC;IAEF,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,mDAAmD;IACnD,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,4BAA4B;QAC5B,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,WAAW,GAAG,IAAI,CAAC;YACnB,cAAc,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,WAAW,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,WAAW,GAAG,KAAK,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;gBAClB,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;oBAC7C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;oBACzB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;iBACtC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;gBAClB,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;oBAC7C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;oBACzB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;iBACtC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,UAAU,GAAG;YAClB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE;YACrC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI;SACnC,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}