@bradygaster/squad-sdk 0.8.22 → 0.8.24

package/dist/platform/azure-devops.js

@@ -0,0 +1,271 @@
+/**
+ * Azure DevOps platform adapter — wraps az CLI for work item/PR/branch operations.
+ *
+ * @module platform/azure-devops
+ */
+import { execFileSync, execSync } from 'node:child_process';
+const EXEC_OPTS = { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] };
+/** Check whether the az CLI with devops extension is available */
+function assertAzCliAvailable() {
+    try {
+        execSync('az devops -h', EXEC_OPTS);
+    }
+    catch {
+        throw new Error('Azure DevOps CLI not found. Install it with:\n' +
+            '  1. Install Azure CLI: https://aka.ms/install-az-cli\n' +
+            '  2. Add DevOps extension: az extension add --name azure-devops\n' +
+            '  3. Login: az login\n' +
+            '  4. Set defaults: az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT');
+    }
+}
+/** Escape a value for safe interpolation into a WIQL string (double single-quotes). */
+function escapeWiql(value) {
+    return value.replace(/'/g, "''");
+}
+/** Safely parse JSON output, including raw text in error messages */
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON from CLI output: ${err.message}\nRaw output: ${raw}`);
+    }
+}
+export class AzureDevOpsAdapter {
+    org;
+    project;
+    repo;
+    workItemConfig;
+    type = 'azure-devops';
+    constructor(org, project, repo, workItemConfig) {
+        this.org = org;
+        this.project = project;
+        this.repo = repo;
+        this.workItemConfig = workItemConfig;
+        assertAzCliAvailable();
+    }
+    get orgUrl() {
+        return `https://dev.azure.com/${this.org}`;
+    }
+    /** Org URL for work item operations (may differ from repo org). */
+    get wiOrgUrl() {
+        const wiOrg = this.workItemConfig?.org ?? this.org;
+        return `https://dev.azure.com/${wiOrg}`;
+    }
+    /** Project for work item operations (may differ from repo project). */
+    get wiProject() {
+        return this.workItemConfig?.project ?? this.project;
+    }
+    /** Common az CLI default args for repo operations */
+    get defaultArgs() {
+        return ['--org', this.orgUrl, '--project', this.project];
+    }
+    /** Common az CLI default args for work item operations */
+    get workItemArgs() {
+        return ['--org', this.wiOrgUrl, '--project', this.wiProject];
+    }
+    az(args) {
+        return execFileSync('az', args, EXEC_OPTS).trim();
+    }
+    async listWorkItems(options) {
+        const conditions = [];
+        if (options.state) {
+            conditions.push(`[System.State] = '${escapeWiql(options.state)}'`);
+        }
+        if (options.tags?.length) {
+            for (const tag of options.tags) {
+                conditions.push(`[System.Tags] Contains '${escapeWiql(tag)}'`);
+            }
+        }
+        conditions.push(`[System.TeamProject] = '${escapeWiql(this.wiProject)}'`);
+        const where = conditions.join(' AND ');
+        const top = options.limit ?? 50;
+        const wiql = `SELECT [System.Id] FROM WorkItems WHERE ${where} ORDER BY [System.CreatedDate] DESC`;
+        const output = this.az([
+            'boards', 'query', '--wiql', wiql, ...this.workItemArgs, '--output', 'json',
+        ]);
+        const items = parseJson(output);
+        // Fetch full details for each work item (limited by top)
+        const results = [];
+        for (const item of items.slice(0, top)) {
+            const wi = await this.getWorkItem(item.id);
+            results.push(wi);
+        }
+        return results;
+    }
+    async getWorkItem(id) {
+        const output = this.az([
+            'boards', 'work-item', 'show', '--id', String(id), ...this.workItemArgs, '--output', 'json',
+        ]);
+        const wi = parseJson(output);
+        const fields = wi.fields;
+        const tags = typeof fields['System.Tags'] === 'string'
+            ? fields['System.Tags'].split(';').map((t) => t.trim()).filter(Boolean)
+            : [];
+        const assignedTo = fields['System.AssignedTo'];
+        return {
+            id: wi.id,
+            title: fields['System.Title'] ?? '',
+            state: fields['System.State'] ?? '',
+            tags,
+            assignedTo: assignedTo?.displayName ?? assignedTo?.uniqueName,
+            url: wi._links?.html?.href ?? wi.url,
+        };
+    }
+    async createWorkItem(options) {
+        const wiType = options.type ?? this.workItemConfig?.defaultWorkItemType ?? 'User Story';
+        const fields = [
+            `System.Title=${options.title}`,
+        ];
+        if (options.description) {
+            fields.push(`System.Description=${options.description}`);
+        }
+        if (options.tags?.length) {
+            fields.push(`System.Tags=${options.tags.join('; ')}`);
+        }
+        if (options.assignedTo) {
+            fields.push(`System.AssignedTo=${options.assignedTo}`);
+        }
+        // Area path: explicit > config > omit (uses project default)
+        const areaPath = options.areaPath ?? this.workItemConfig?.areaPath;
+        if (areaPath) {
+            fields.push(`System.AreaPath=${areaPath}`);
+        }
+        // Iteration path: explicit > config > omit (uses project default)
+        const iterationPath = options.iterationPath ?? this.workItemConfig?.iterationPath;
+        if (iterationPath) {
+            fields.push(`System.IterationPath=${iterationPath}`);
+        }
+        const output = this.az([
+            'boards', 'work-item', 'create', '--type', wiType, '--fields', ...fields, ...this.workItemArgs, '--output', 'json',
+        ]);
+        const created = parseJson(output);
+        const createdFields = created.fields;
+        const tags = typeof createdFields['System.Tags'] === 'string'
+            ? createdFields['System.Tags'].split(';').map((t) => t.trim()).filter(Boolean)
+            : [];
+        return {
+            id: created.id,
+            title: createdFields['System.Title'] ?? '',
+            state: createdFields['System.State'] ?? '',
+            tags,
+            url: created._links?.html?.href ?? created.url,
+        };
+    }
+    async addTag(workItemId, tag) {
+        // Get current tags, append the new one
+        const wi = await this.getWorkItem(workItemId);
+        const currentTags = wi.tags.filter((t) => t !== tag);
+        currentTags.push(tag);
+        const tagsStr = currentTags.join('; ');
+        this.az([
+            'boards', 'work-item', 'update', '--id', String(workItemId),
+            '--fields', `System.Tags=${tagsStr}`, ...this.workItemArgs, '--output', 'json',
+        ]);
+    }
+    async removeTag(workItemId, tag) {
+        const wi = await this.getWorkItem(workItemId);
+        const updatedTags = wi.tags.filter((t) => t !== tag);
+        const tagsStr = updatedTags.join('; ');
+        this.az([
+            'boards', 'work-item', 'update', '--id', String(workItemId),
+            '--fields', `System.Tags=${tagsStr}`, ...this.workItemArgs, '--output', 'json',
+        ]);
+    }
+    async addComment(workItemId, comment) {
+        this.az([
+            'boards', 'work-item', 'update', '--id', String(workItemId),
+            '--discussion', comment, ...this.workItemArgs, '--output', 'json',
+        ]);
+    }
+    async listPullRequests(options) {
+        const args = [
+            'repos', 'pr', 'list',
+            '--repository', this.repo,
+            ...this.defaultArgs,
+            '--output', 'json',
+        ];
+        if (options.status)
+            args.push('--status', options.status);
+        if (options.limit)
+            args.push('--top', String(options.limit));
+        const output = this.az(args);
+        const prs = parseJson(output);
+        return prs.map((pr) => ({
+            id: pr.pullRequestId,
+            title: pr.title,
+            sourceBranch: stripRefsHeads(pr.sourceRefName),
+            targetBranch: stripRefsHeads(pr.targetRefName),
+            status: mapAdoPrStatus(pr.status, pr.isDraft),
+            reviewStatus: mapAdoReviewStatus(pr.reviewers),
+            author: pr.createdBy.displayName ?? pr.createdBy.uniqueName,
+            url: pr.repository?.webUrl
+                ? `${pr.repository.webUrl}/pullrequest/${pr.pullRequestId}`
+                : pr.url,
+        }));
+    }
+    async createPullRequest(options) {
+        const args = [
+            'repos', 'pr', 'create',
+            '--repository', this.repo,
+            '--source-branch', options.sourceBranch,
+            '--target-branch', options.targetBranch,
+            '--title', options.title,
+            ...this.defaultArgs,
+            '--output', 'json',
+        ];
+        if (options.description) {
+            args.push('--description', options.description);
+        }
+        const output = this.az(args);
+        const pr = parseJson(output);
+        return {
+            id: pr.pullRequestId,
+            title: pr.title,
+            sourceBranch: stripRefsHeads(pr.sourceRefName),
+            targetBranch: stripRefsHeads(pr.targetRefName),
+            status: mapAdoPrStatus(pr.status, pr.isDraft),
+            reviewStatus: mapAdoReviewStatus(pr.reviewers),
+            author: pr.createdBy.displayName ?? pr.createdBy.uniqueName,
+            url: pr.url,
+        };
+    }
+    async mergePullRequest(id) {
+        this.az([
+            'repos', 'pr', 'update', '--id', String(id),
+            '--status', 'completed', ...this.defaultArgs, '--output', 'json',
+        ]);
+    }
+    async createBranch(name, fromBranch) {
+        const base = fromBranch ?? 'main';
+        execFileSync('git', ['checkout', base], EXEC_OPTS);
+        execFileSync('git', ['pull'], EXEC_OPTS);
+        execFileSync('git', ['checkout', '-b', name], EXEC_OPTS);
+    }
+}
+function stripRefsHeads(ref) {
+    return ref.replace(/^refs\/heads\//, '');
+}
+function mapAdoPrStatus(status, isDraft) {
+    if (isDraft)
+        return 'draft';
+    switch (status.toLowerCase()) {
+        case 'active': return 'active';
+        case 'completed': return 'completed';
+        case 'abandoned': return 'abandoned';
+        default: return 'active';
+    }
+}
+function mapAdoReviewStatus(reviewers) {
+    if (!reviewers?.length)
+        return 'pending';
+    // ADO vote: 10 = approved, -10 = rejected, 5 = approved with suggestions, -5 = waiting, 0 = no vote
+    const hasReject = reviewers.some((r) => r.vote <= -5);
+    if (hasReject)
+        return 'changes-requested';
+    const hasApproval = reviewers.some((r) => r.vote >= 5);
+    if (hasApproval)
+        return 'approved';
+    return 'pending';
+}
+//# sourceMappingURL=azure-devops.js.map

package/dist/platform/azure-devops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-devops.js","sourceRoot":"","sources":["../../src/platform/azure-devops.ts"],"names":[],"mappings":"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"}

package/dist/platform/comms-ado-discussions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Azure DevOps Work Item Discussion communication adapter.
+ *
+ * Posts updates as work item comments and reads replies via `az boards`.
+ * Phone-capable via ADO mobile app.
+ *
+ * @module platform/comms-ado-discussions
+ */
+import type { CommunicationAdapter, CommunicationChannel, CommunicationReply } from './types.js';
+export declare class ADODiscussionCommunicationAdapter implements CommunicationAdapter {
+    private readonly org;
+    private readonly project;
+    readonly channel: CommunicationChannel;
+    constructor(org: string, project: string);
+    private get orgUrl();
+    postUpdate(options: {
+        title: string;
+        body: string;
+        category?: string;
+        author?: string;
+    }): Promise<{
+        id: string;
+        url?: string;
+    }>;
+    pollForReplies(options: {
+        threadId: string;
+        since: Date;
+    }): Promise<CommunicationReply[]>;
+    getNotificationUrl(threadId: string): string | undefined;
+}
+//# sourceMappingURL=comms-ado-discussions.d.ts.map

package/dist/platform/comms-ado-discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-ado-discussions.d.ts","sourceRoot":"","sources":["../../src/platform/comms-ado-discussions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAajG,qBAAa,iCAAkC,YAAW,oBAAoB;IAI1E,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAoB;gBAGvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM;IAGlC,OAAO,KAAK,MAAM,GAEjB;IAEK,UAAU,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BnC,cAAc,CAAC,OAAO,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,IAAI,CAAC;KACb,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqCjC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGzD"}

package/dist/platform/comms-ado-discussions.js

@@ -0,0 +1,82 @@
+/**
+ * Azure DevOps Work Item Discussion communication adapter.
+ *
+ * Posts updates as work item comments and reads replies via `az boards`.
+ * Phone-capable via ADO mobile app.
+ *
+ * @module platform/comms-ado-discussions
+ */
+import { execFileSync } from 'node:child_process';
+const EXEC_OPTS = { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] };
+/** Safely parse JSON output */
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON: ${err.message}\nRaw: ${raw}`);
+    }
+}
+export class ADODiscussionCommunicationAdapter {
+    org;
+    project;
+    channel = 'ado-work-items';
+    constructor(org, project) {
+        this.org = org;
+        this.project = project;
+    }
+    get orgUrl() {
+        return `https://dev.azure.com/${this.org}`;
+    }
+    async postUpdate(options) {
+        const prefix = options.author ? `**${options.author}:** ` : '';
+        const categoryTag = options.category ? ` [${options.category}]` : '';
+        const fullTitle = `[Squad${categoryTag}] ${options.title}`;
+        const comment = `${prefix}${options.body}`;
+        // Create a work item to serve as the discussion thread
+        const output = execFileSync('az', [
+            'boards', 'work-item', 'create',
+            '--type', 'Task',
+            '--title', fullTitle,
+            '--fields', `System.Tags=squad; squad:comms`,
+            '--discussion', comment,
+            '--org', this.orgUrl,
+            '--project', this.project,
+            '--output', 'json',
+        ], EXEC_OPTS);
+        const wi = parseJson(output);
+        return {
+            id: String(wi.id),
+            url: wi._links?.html?.href ?? wi.url,
+        };
+    }
+    async pollForReplies(options) {
+        // Read work item comments (discussion history)
+        const output = execFileSync('az', [
+            'boards', 'work-item', 'show',
+            '--id', options.threadId,
+            '--org', this.orgUrl,
+            '--project', this.project,
+            '--expand', 'all',
+            '--output', 'json',
+        ], EXEC_OPTS);
+        const wi = parseJson(output);
+        // ADO work item show doesn't include comments directly in basic output.
+        // The discussion is in the System.History field as HTML.
+        // For a production adapter, use the REST API for comments.
+        // This is a simplified implementation.
+        const history = wi.fields['System.History'];
+        if (!history)
+            return [];
+        return [{
+                author: 'ado-user',
+                body: history,
+                timestamp: new Date(),
+                id: `${options.threadId}-history`,
+            }];
+    }
+    getNotificationUrl(threadId) {
+        return `${this.orgUrl}/${this.project}/_workitems/edit/${threadId}`;
+    }
+}
+//# sourceMappingURL=comms-ado-discussions.js.map

package/dist/platform/comms-ado-discussions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-ado-discussions.js","sourceRoot":"","sources":["../../src/platform/comms-ado-discussions.ts"],"names":[],"mappings":"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"}

package/dist/platform/comms-file-log.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File-based communication adapter — zero-config fallback.
+ *
+ * Writes updates to `.squad/comms/` as markdown files.
+ * Always available, no external dependencies. Works on every platform.
+ * Replies are read from the same directory (humans edit files manually or via git).
+ *
+ * @module platform/comms-file-log
+ */
+import type { CommunicationAdapter, CommunicationChannel, CommunicationReply } from './types.js';
+export declare class FileLogCommunicationAdapter implements CommunicationAdapter {
+    private readonly squadRoot;
+    readonly channel: CommunicationChannel;
+    private readonly commsDir;
+    constructor(squadRoot: string);
+    postUpdate(options: {
+        title: string;
+        body: string;
+        category?: string;
+        author?: string;
+    }): Promise<{
+        id: string;
+        url?: string;
+    }>;
+    pollForReplies(options: {
+        threadId: string;
+        since: Date;
+    }): Promise<CommunicationReply[]>;
+    getNotificationUrl(_threadId: string): string | undefined;
+}
+//# sourceMappingURL=comms-file-log.d.ts.map

package/dist/platform/comms-file-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-file-log.d.ts","sourceRoot":"","sources":["../../src/platform/comms-file-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEjG,qBAAa,2BAA4B,YAAW,oBAAoB;IAI1D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEL,SAAS,EAAE,MAAM;IAOxC,UAAU,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA4BnC,cAAc,CAAC,OAAO,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,IAAI,CAAC;KACb,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqBjC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG1D"}

package/dist/platform/comms-file-log.js

@@ -0,0 +1,71 @@
+/**
+ * File-based communication adapter — zero-config fallback.
+ *
+ * Writes updates to `.squad/comms/` as markdown files.
+ * Always available, no external dependencies. Works on every platform.
+ * Replies are read from the same directory (humans edit files manually or via git).
+ *
+ * @module platform/comms-file-log
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class FileLogCommunicationAdapter {
+    squadRoot;
+    channel = 'file-log';
+    commsDir;
+    constructor(squadRoot) {
+        this.squadRoot = squadRoot;
+        this.commsDir = join(squadRoot, '.squad', 'comms');
+        if (!existsSync(this.commsDir)) {
+            mkdirSync(this.commsDir, { recursive: true });
+        }
+    }
+    async postUpdate(options) {
+        const timestamp = new Date().toISOString().replace(/:/g, '-').replace(/\.\d+Z$/, 'Z');
+        const slug = options.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 40);
+        const filename = `${timestamp}-${slug}.md`;
+        const filepath = join(this.commsDir, filename);
+        const content = [
+            `# ${options.title}`,
+            '',
+            `**Posted by:** ${options.author ?? 'Squad'}`,
+            `**Category:** ${options.category ?? 'update'}`,
+            `**Timestamp:** ${new Date().toISOString()}`,
+            '',
+            '---',
+            '',
+            options.body,
+            '',
+            '---',
+            '',
+            '<!-- Replies: add your response below this line -->',
+            '',
+        ].join('\n');
+        writeFileSync(filepath, content, 'utf-8');
+        return { id: filename.replace(/\.md$/, ''), url: undefined };
+    }
+    async pollForReplies(options) {
+        const filepath = join(this.commsDir, `${options.threadId}.md`);
+        if (!existsSync(filepath))
+            return [];
+        const content = readFileSync(filepath, 'utf-8');
+        const replyMarker = '<!-- Replies: add your response below this line -->';
+        const markerIdx = content.indexOf(replyMarker);
+        if (markerIdx === -1)
+            return [];
+        const repliesSection = content.slice(markerIdx + replyMarker.length).trim();
+        if (!repliesSection)
+            return [];
+        // Parse simple reply format: lines after the marker are replies
+        return [{
+                author: 'human',
+                body: repliesSection,
+                timestamp: new Date(),
+                id: `${options.threadId}-reply`,
+            }];
+    }
+    getNotificationUrl(_threadId) {
+        return undefined; // File-based has no web UI
+    }
+}
+//# sourceMappingURL=comms-file-log.js.map

package/dist/platform/comms-file-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-file-log.js","sourceRoot":"","sources":["../../src/platform/comms-file-log.ts"],"names":[],"mappings":"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"}

package/dist/platform/comms-github-discussions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GitHub Discussions communication adapter.
+ *
+ * Posts updates and reads replies via GitHub Discussions using `gh api`.
+ * Phone-capable (browser-based), not corp-only.
+ *
+ * @module platform/comms-github-discussions
+ */
+import type { CommunicationAdapter, CommunicationChannel, CommunicationReply } from './types.js';
+export declare class GitHubDiscussionsCommunicationAdapter implements CommunicationAdapter {
+    private readonly owner;
+    private readonly repo;
+    readonly channel: CommunicationChannel;
+    constructor(owner: string, repo: string);
+    postUpdate(options: {
+        title: string;
+        body: string;
+        category?: string;
+        author?: string;
+    }): Promise<{
+        id: string;
+        url?: string;
+    }>;
+    pollForReplies(options: {
+        threadId: string;
+        since: Date;
+    }): Promise<CommunicationReply[]>;
+    getNotificationUrl(threadId: string): string | undefined;
+}
+//# sourceMappingURL=comms-github-discussions.d.ts.map

package/dist/platform/comms-github-discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-github-discussions.d.ts","sourceRoot":"","sources":["../../src/platform/comms-github-discussions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAajG,qBAAa,qCAAsC,YAAW,oBAAoB;IAI9E,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAwB;gBAG3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM;IAGzB,UAAU,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkCnC,cAAc,CAAC,OAAO,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,IAAI,CAAC;KACb,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkBjC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGzD"}

package/dist/platform/comms-github-discussions.js

@@ -0,0 +1,68 @@
+/**
+ * GitHub Discussions communication adapter.
+ *
+ * Posts updates and reads replies via GitHub Discussions using `gh api`.
+ * Phone-capable (browser-based), not corp-only.
+ *
+ * @module platform/comms-github-discussions
+ */
+import { execFileSync } from 'node:child_process';
+const EXEC_OPTS = { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] };
+/** Safely parse JSON output */
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON: ${err.message}\nRaw: ${raw}`);
+    }
+}
+export class GitHubDiscussionsCommunicationAdapter {
+    owner;
+    repo;
+    channel = 'github-discussions';
+    constructor(owner, repo) {
+        this.owner = owner;
+        this.repo = repo;
+    }
+    async postUpdate(options) {
+        const category = options.category ?? 'General';
+        // Get category ID
+        const categoryQuery = `query { repository(owner: "${this.owner}", name: "${this.repo}") { discussionCategories(first: 25) { nodes { id name } } } }`;
+        const catOutput = execFileSync('gh', ['api', 'graphql', '-f', `query=${categoryQuery}`], EXEC_OPTS);
+        const catData = parseJson(catOutput);
+        const catNode = catData.data.repository.discussionCategories.nodes.find((n) => n.name.toLowerCase() === category.toLowerCase());
+        if (!catNode) {
+            throw new Error(`Discussion category "${category}" not found in ${this.owner}/${this.repo}. Available: ${catData.data.repository.discussionCategories.nodes.map((n) => n.name).join(', ')}`);
+        }
+        // Get repo ID
+        const repoQuery = `query { repository(owner: "${this.owner}", name: "${this.repo}") { id } }`;
+        const repoOutput = execFileSync('gh', ['api', 'graphql', '-f', `query=${repoQuery}`], EXEC_OPTS);
+        const repoData = parseJson(repoOutput);
+        // Create discussion
+        const prefix = options.author ? `*Posted by ${options.author}*\n\n` : '';
+        const mutation = `mutation { createDiscussion(input: { repositoryId: "${repoData.data.repository.id}", categoryId: "${catNode.id}", title: "${options.title.replace(/"/g, '\\"')}", body: "${(prefix + options.body).replace(/"/g, '\\"').replace(/\n/g, '\\n')}" }) { discussion { id number url } } }`;
+        const output = execFileSync('gh', ['api', 'graphql', '-f', `query=${mutation}`], EXEC_OPTS);
+        const result = parseJson(output);
+        const disc = result.data.createDiscussion.discussion;
+        return { id: String(disc.number), url: disc.url };
+    }
+    async pollForReplies(options) {
+        const query = `query { repository(owner: "${this.owner}", name: "${this.repo}") { discussion(number: ${options.threadId}) { comments(first: 50) { nodes { id body createdAt author { login } } } } } }`;
+        const output = execFileSync('gh', ['api', 'graphql', '-f', `query=${query}`], EXEC_OPTS);
+        const data = parseJson(output);
+        const comments = data.data.repository.discussion.comments.nodes;
+        return comments
+            .filter((c) => new Date(c.createdAt) > options.since)
+            .map((c) => ({
+            author: c.author.login,
+            body: c.body,
+            timestamp: new Date(c.createdAt),
+            id: c.id,
+        }));
+    }
+    getNotificationUrl(threadId) {
+        return `https://github.com/${this.owner}/${this.repo}/discussions/${threadId}`;
+    }
+}
+//# sourceMappingURL=comms-github-discussions.js.map

package/dist/platform/comms-github-discussions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms-github-discussions.js","sourceRoot":"","sources":["../../src/platform/comms-github-discussions.ts"],"names":[],"mappings":"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"}