@bradygaster/squad-sdk 0.8.23 → 0.8.25

package/dist/platform/index.js

@@ -0,0 +1,61 @@
+/**
+ * Platform module — factory + barrel exports.
+ *
+ * @module platform
+ */
+export { detectPlatform, detectPlatformFromUrl, detectWorkItemSource, parseGitHubRemote, parseAzureDevOpsRemote, getRemoteUrl } from './detect.js';
+export { GitHubAdapter } from './github.js';
+export { AzureDevOpsAdapter } from './azure-devops.js';
+export { PlannerAdapter, mapPlannerTaskToWorkItem } from './planner.js';
+export { getRalphScanCommands } from './ralph-commands.js';
+export { FileLogCommunicationAdapter } from './comms-file-log.js';
+export { GitHubDiscussionsCommunicationAdapter } from './comms-github-discussions.js';
+export { ADODiscussionCommunicationAdapter } from './comms-ado-discussions.js';
+export { createCommunicationAdapter } from './comms.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectPlatform, getRemoteUrl, parseGitHubRemote, parseAzureDevOpsRemote } from './detect.js';
+import { GitHubAdapter } from './github.js';
+import { AzureDevOpsAdapter } from './azure-devops.js';
+/**
+ * Read ADO work item config from .squad/config.json if present.
+ */
+function readAdoConfig(repoRoot) {
+    const configPath = join(repoRoot, '.squad', 'config.json');
+    if (!existsSync(configPath))
+        return undefined;
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.ado && typeof parsed.ado === 'object') {
+            return parsed.ado;
+        }
+    }
+    catch { /* ignore parse errors */ }
+    return undefined;
+}
+/**
+ * Create a platform adapter by auto-detecting the platform from the repo's git remote.
+ * Throws if required remote info cannot be parsed.
+ */
+export function createPlatformAdapter(repoRoot) {
+    const platform = detectPlatform(repoRoot);
+    const remoteUrl = getRemoteUrl(repoRoot);
+    if (!remoteUrl) {
+        throw new Error('No git remote "origin" found. Cannot create platform adapter.');
+    }
+    if (platform === 'azure-devops') {
+        const info = parseAzureDevOpsRemote(remoteUrl);
+        if (!info) {
+            throw new Error(`Could not parse Azure DevOps remote URL: ${remoteUrl}`);
+        }
+        const adoConfig = readAdoConfig(repoRoot);
+        return new AzureDevOpsAdapter(info.org, info.project, info.repo, adoConfig);
+    }
+    const info = parseGitHubRemote(remoteUrl);
+    if (!info) {
+        throw new Error(`Could not parse GitHub remote URL: ${remoteUrl}`);
+    }
+    return new GitHubAdapter(info.owner, info.repo);
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnJ,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,IAAI,MAAM,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACjD,OAAO,MAAM,CAAC,GAAwB,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,4CAA4C,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/platform/planner.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Microsoft Planner adapter — uses Graph API via az CLI token for task management.
+ * Planner buckets map to squad assignments (squad:untriaged, squad:riker, etc.)
+ *
+ * @module platform/planner
+ */
+import type { PlatformType, WorkItem } from './types.js';
+/** Planner task shape from Graph API */
+interface PlannerTask {
+    id: string;
+    title: string;
+    percentComplete: number;
+    bucketId: string;
+    assignments: Record<string, unknown>;
+}
+/** Planner bucket shape from Graph API */
+interface PlannerBucket {
+    id: string;
+    name: string;
+}
+/**
+ * Map a Planner task + bucket name to a normalized WorkItem.
+ * The original Planner task ID is stored in the url field so it can be recovered.
+ */
+export declare function mapPlannerTaskToWorkItem(task: PlannerTask, bucketName: string): WorkItem;
+/**
+ * Planner adapter — partial PlatformAdapter for work-item operations only.
+ * Planner has no concept of PRs or branches, so those methods are not implemented.
+ * Use alongside a repo adapter (GitHub/ADO) in a hybrid config.
+ */
+export declare class PlannerAdapter {
+    private readonly planId;
+    readonly type: PlatformType;
+    private bucketCache;
+    constructor(planId: string);
+    private graphFetch;
+    /** Fetch and cache buckets for this plan */
+    getBuckets(): Promise<PlannerBucket[]>;
+    /** Resolve a bucket name to its ID */
+    getBucketId(bucketName: string): Promise<string | undefined>;
+    /** Resolve a bucket ID to its name */
+    getBucketName(bucketId: string): Promise<string>;
+    listWorkItems(options: {
+        tags?: string[];
+        state?: string;
+        limit?: number;
+    }): Promise<WorkItem[]>;
+    createWorkItem(options: {
+        title: string;
+        description?: string;
+        tags?: string[];
+    }): Promise<WorkItem>;
+    addTag(taskId: string, bucketName: string): Promise<void>;
+    addComment(taskId: string, comment: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=planner.d.ts.map

package/dist/platform/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/platform/planner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIzD,wCAAwC;AACxC,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,0CAA0C;AAC1C,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,QAAQ,CAQV;AAcD;;;;GAIG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAa;IACxC,OAAO,CAAC,WAAW,CAAgC;gBAEtB,MAAM,EAAE,MAAM;IAE3C,OAAO,CAAC,UAAU;IAuBlB,4CAA4C;IACtC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAS5C,sCAAsC;IAChC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKlE,sCAAsC;IAChC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKhD,aAAa,CAAC,OAAO,EAAE;QAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkCjB,cAAc,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyCpG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWjE"}

package/dist/platform/planner.js

@@ -0,0 +1,185 @@
+/**
+ * Microsoft Planner adapter — uses Graph API via az CLI token for task management.
+ * Planner buckets map to squad assignments (squad:untriaged, squad:riker, etc.)
+ *
+ * @module platform/planner
+ */
+import { execFileSync } from 'node:child_process';
+const EXEC_OPTS = { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] };
+/**
+ * Get a Microsoft Graph access token via the az CLI.
+ * Requires: `az login` completed beforehand.
+ */
+function getGraphToken() {
+    try {
+        const output = execFileSync('az', ['account', 'get-access-token', '--resource-type', 'ms-graph', '--query', 'accessToken', '-o', 'tsv'], EXEC_OPTS).trim();
+        return output;
+    }
+    catch {
+        throw new Error('Could not obtain Microsoft Graph token. Ensure you are logged in:\n' +
+            '  az login\n' +
+            '  az account get-access-token --resource-type ms-graph');
+    }
+}
+/** 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}`);
+    }
+}
+/**
+ * Map a Planner task + bucket name to a normalized WorkItem.
+ * The original Planner task ID is stored in the url field so it can be recovered.
+ */
+export function mapPlannerTaskToWorkItem(task, bucketName) {
+    return {
+        id: hashTaskId(task.id),
+        title: task.title,
+        state: task.percentComplete === 100 ? 'done' : 'active',
+        tags: [bucketName],
+        url: `https://tasks.office.com/task/${task.id}`,
+    };
+}
+/**
+ * Convert a Planner string ID to a stable numeric hash.
+ * WorkItem.id is a number, but Planner IDs are strings.
+ */
+function hashTaskId(id) {
+    let hash = 0;
+    for (let i = 0; i < id.length; i++) {
+        hash = ((hash << 5) - hash + id.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash);
+}
+/**
+ * Planner adapter — partial PlatformAdapter for work-item operations only.
+ * Planner has no concept of PRs or branches, so those methods are not implemented.
+ * Use alongside a repo adapter (GitHub/ADO) in a hybrid config.
+ */
+export class PlannerAdapter {
+    planId;
+    type = 'planner';
+    bucketCache = null;
+    constructor(planId) {
+        this.planId = planId;
+    }
+    graphFetch(path, method = 'GET', body) {
+        const token = getGraphToken();
+        const url = `https://graph.microsoft.com/v1.0${path}`;
+        const curlArgs = [
+            '-s',
+            '-X', method,
+            '-H', 'Content-Type: application/json',
+            '--config', '-',
+        ];
+        if (body) {
+            curlArgs.push('-d', body);
+        }
+        curlArgs.push(url);
+        // Pass the Authorization header via stdin so the token is not visible in process args.
+        const config = `header "Authorization: Bearer ${token}"`;
+        return execFileSync('curl', curlArgs, {
+            encoding: 'utf-8',
+            input: config,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    /** Fetch and cache buckets for this plan */
+    async getBuckets() {
+        if (this.bucketCache)
+            return this.bucketCache;
+        const output = this.graphFetch(`/planner/plans/${this.planId}/buckets`);
+        const data = parseJson(output);
+        this.bucketCache = data.value;
+        return this.bucketCache;
+    }
+    /** Resolve a bucket name to its ID */
+    async getBucketId(bucketName) {
+        const buckets = await this.getBuckets();
+        return buckets.find((b) => b.name === bucketName)?.id;
+    }
+    /** Resolve a bucket ID to its name */
+    async getBucketName(bucketId) {
+        const buckets = await this.getBuckets();
+        return buckets.find((b) => b.id === bucketId)?.name ?? 'unknown';
+    }
+    async listWorkItems(options) {
+        const output = this.graphFetch(`/planner/plans/${this.planId}/tasks`);
+        const data = parseJson(output);
+        const buckets = await this.getBuckets();
+        const bucketMap = new Map(buckets.map((b) => [b.id, b.name]));
+        let tasks = data.value;
+        // Filter by bucket name (tag)
+        if (options.tags?.length) {
+            const targetBucketIds = new Set();
+            for (const tag of options.tags) {
+                const bucket = buckets.find((b) => b.name === tag);
+                if (bucket)
+                    targetBucketIds.add(bucket.id);
+            }
+            tasks = tasks.filter((t) => targetBucketIds.has(t.bucketId));
+        }
+        // Filter by state
+        if (options.state === 'done') {
+            tasks = tasks.filter((t) => t.percentComplete === 100);
+        }
+        else if (options.state === 'active') {
+            tasks = tasks.filter((t) => t.percentComplete < 100);
+        }
+        if (options.limit) {
+            tasks = tasks.slice(0, options.limit);
+        }
+        return tasks.map((task) => mapPlannerTaskToWorkItem(task, bucketMap.get(task.bucketId) ?? 'unknown'));
+    }
+    async createWorkItem(options) {
+        // Resolve target bucket from tags (first squad: tag), default to untriaged
+        let bucketId;
+        let bucketName = 'squad:untriaged';
+        if (options.tags?.length) {
+            for (const tag of options.tags) {
+                const bid = await this.getBucketId(tag);
+                if (bid) {
+                    bucketId = bid;
+                    bucketName = tag;
+                    break;
+                }
+            }
+        }
+        if (!bucketId) {
+            bucketId = await this.getBucketId('squad:untriaged');
+        }
+        const taskBody = {
+            planId: this.planId,
+            title: options.title,
+        };
+        if (bucketId) {
+            taskBody.bucketId = bucketId;
+        }
+        const output = this.graphFetch('/planner/tasks', 'POST', JSON.stringify(taskBody));
+        const task = parseJson(output);
+        // Add description if provided
+        if (options.description) {
+            this.graphFetch(`/planner/tasks/${task.id}/details`, 'PATCH', JSON.stringify({ description: options.description, previewType: 'description' }));
+        }
+        return mapPlannerTaskToWorkItem(task, bucketName);
+    }
+    async addTag(taskId, bucketName) {
+        const bucketId = await this.getBucketId(bucketName);
+        if (!bucketId) {
+            throw new Error(`Bucket "${bucketName}" not found in plan ${this.planId}`);
+        }
+        // Moving a task to a different bucket = reassigning
+        this.graphFetch(`/planner/tasks/${taskId}`, 'PATCH', JSON.stringify({ bucketId }));
+    }
+    async addComment(taskId, comment) {
+        // Planner task comments go through the group conversation thread
+        this.graphFetch(`/planner/tasks/${taskId}/details`, 'PATCH', JSON.stringify({
+            description: comment,
+            previewType: 'description',
+        }));
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/platform/planner.js.map

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

package/dist/platform/ralph-commands.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Platform-specific Ralph commands for triage and work management.
+ *
+ * @module platform/ralph-commands
+ */
+import type { PlatformType } from './types.js';
+export interface RalphCommands {
+    listUntriaged: string;
+    listAssigned: string;
+    listOpenPRs: string;
+    listDraftPRs: string;
+    createBranch: string;
+    createPR: string;
+    mergePR: string;
+    createWorkItem: string;
+}
+/**
+ * Get Ralph scan/triage commands for a given platform.
+ * GitHub → gh CLI commands
+ * Azure DevOps → az CLI commands
+ */
+export declare function getRalphScanCommands(platform: PlatformType): RalphCommands;
+/** Ralph commands for Planner via Graph API (az CLI token) */
+export declare function getPlannerRalphCommands(): RalphCommands;
+//# sourceMappingURL=ralph-commands.d.ts.map

package/dist/platform/ralph-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-commands.d.ts","sourceRoot":"","sources":["../../src/platform/ralph-commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,CAW1E;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,IAAI,aAAa,CAmBvD"}

package/dist/platform/ralph-commands.js

@@ -0,0 +1,60 @@
+/**
+ * Platform-specific Ralph commands for triage and work management.
+ *
+ * @module platform/ralph-commands
+ */
+/**
+ * Get Ralph scan/triage commands for a given platform.
+ * GitHub → gh CLI commands
+ * Azure DevOps → az CLI commands
+ */
+export function getRalphScanCommands(platform) {
+    switch (platform) {
+        case 'github':
+            return getGitHubRalphCommands();
+        case 'azure-devops':
+            return getAzureDevOpsRalphCommands();
+        case 'planner':
+            return getPlannerRalphCommands();
+        default:
+            return getGitHubRalphCommands();
+    }
+}
+/** Ralph commands for Planner via Graph API (az CLI token) */
+export function getPlannerRalphCommands() {
+    return {
+        listUntriaged: `curl -s -H "Authorization: Bearer $(az account get-access-token --resource-type ms-graph --query accessToken -o tsv)" "https://graph.microsoft.com/v1.0/planner/plans/{planId}/tasks?$filter=bucketId eq '{untriagedBucketId}'"`,
+        listAssigned: `curl -s -H "Authorization: Bearer $(az account get-access-token --resource-type ms-graph --query accessToken -o tsv)" "https://graph.microsoft.com/v1.0/planner/plans/{planId}/tasks?$filter=bucketId eq '{memberBucketId}'"`,
+        listOpenPRs: 'echo "Planner does not manage PRs — use the repo adapter (GitHub or Azure DevOps)"',
+        listDraftPRs: 'echo "Planner does not manage PRs — use the repo adapter (GitHub or Azure DevOps)"',
+        createBranch: 'git checkout main && git pull && git checkout -b {branchName}',
+        createPR: 'echo "Planner does not manage PRs — use the repo adapter (GitHub or Azure DevOps)"',
+        mergePR: 'echo "Planner does not manage PRs — use the repo adapter (GitHub or Azure DevOps)"',
+        createWorkItem: `curl -s -X POST -H "Authorization: Bearer $(az account get-access-token --resource-type ms-graph --query accessToken -o tsv)" -H "Content-Type: application/json" -d '{"planId":"{planId}","title":"{title}","bucketId":"{bucketId}"}' "https://graph.microsoft.com/v1.0/planner/tasks"`,
+    };
+}
+function getGitHubRalphCommands() {
+    return {
+        listUntriaged: 'gh issue list --label "squad:untriaged" --json number,title,labels,assignees --limit 20',
+        listAssigned: 'gh issue list --label "squad:{member}" --state open --json number,title,labels,assignees --limit 20',
+        listOpenPRs: 'gh pr list --state open --json number,title,headRefName,baseRefName,state,isDraft,reviewDecision,author --limit 20',
+        listDraftPRs: 'gh pr list --state open --draft --json number,title,headRefName,baseRefName,state,isDraft,reviewDecision,author --limit 20',
+        createBranch: 'git checkout main && git pull && git checkout -b {branchName}',
+        createPR: 'gh pr create --title "{title}" --body "{description}" --head {sourceBranch} --base {targetBranch}',
+        mergePR: 'gh pr merge {id} --merge',
+        createWorkItem: 'gh issue create --title "{title}" --body "{description}" --label "{tags}"',
+    };
+}
+function getAzureDevOpsRalphCommands() {
+    return {
+        listUntriaged: `az boards query --wiql "SELECT [System.Id],[System.Title],[System.State],[System.Tags] FROM WorkItems WHERE [System.Tags] Contains 'squad:untriaged' ORDER BY [System.CreatedDate] DESC" --output table`,
+        listAssigned: `az boards query --wiql "SELECT [System.Id],[System.Title],[System.State],[System.Tags] FROM WorkItems WHERE [System.Tags] Contains 'squad:{member}' AND [System.State] <> 'Closed' ORDER BY [System.CreatedDate] DESC" --output table`,
+        listOpenPRs: 'az repos pr list --status active --output table',
+        listDraftPRs: 'az repos pr list --status active --query "[?isDraft==`true`]" --output table',
+        createBranch: 'git checkout main && git pull && git checkout -b {branchName}',
+        createPR: 'az repos pr create --title "{title}" --description "{description}" --source-branch {sourceBranch} --target-branch {targetBranch}',
+        mergePR: 'az repos pr update --id {id} --status completed',
+        createWorkItem: 'az boards work-item create --type "{workItemType}" --title "{title}" --description "{description}" --fields "System.Tags={tags}"',
+    };
+}
+//# sourceMappingURL=ralph-commands.js.map

package/dist/platform/ralph-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-commands.js","sourceRoot":"","sources":["../../src/platform/ralph-commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,sBAAsB,EAAE,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,2BAA2B,EAAE,CAAC;QACvC,KAAK,SAAS;YACZ,OAAO,uBAAuB,EAAE,CAAC;QACnC;YACE,OAAO,sBAAsB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,aAAa,EACX,iOAAiO;QACnO,YAAY,EACV,8NAA8N;QAChO,WAAW,EACT,oFAAoF;QACtF,YAAY,EACV,oFAAoF;QACtF,YAAY,EACV,+DAA+D;QACjE,QAAQ,EACN,oFAAoF;QACtF,OAAO,EACL,oFAAoF;QACtF,cAAc,EACZ,yRAAyR;KAC5R,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,aAAa,EACX,yFAAyF;QAC3F,YAAY,EACV,qGAAqG;QACvG,WAAW,EACT,oHAAoH;QACtH,YAAY,EACV,4HAA4H;QAC9H,YAAY,EACV,+DAA+D;QACjE,QAAQ,EACN,mGAAmG;QACrG,OAAO,EACL,0BAA0B;QAC5B,cAAc,EACZ,2EAA2E;KAC9E,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B;IAClC,OAAO;QACL,aAAa,EACX,yMAAyM;QAC3M,YAAY,EACV,uOAAuO;QACzO,WAAW,EACT,iDAAiD;QACnD,YAAY,EACV,8EAA8E;QAChF,YAAY,EACV,+DAA+D;QACjE,QAAQ,EACN,kIAAkI;QACpI,OAAO,EACL,iDAAiD;QACnD,cAAc,EACZ,kIAAkI;KACrI,CAAC;AACJ,CAAC"}

package/dist/platform/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Platform-agnostic interfaces for multi-platform support.
+ * Allows Squad to work with GitHub and Azure DevOps interchangeably.
+ *
+ * @module platform/types
+ */
+export type PlatformType = 'github' | 'azure-devops' | 'planner';
+/** Where work items are tracked — may differ from where code lives */
+export type WorkItemSource = 'github' | 'azure-devops' | 'planner';
+/** Hybrid config: repo on one platform, work items on another */
+export interface HybridPlatformConfig {
+    repo: PlatformType;
+    workItems: WorkItemSource;
+}
+/** Normalized work item — maps to GitHub Issues or ADO Work Items */
+export interface WorkItem {
+    id: number;
+    title: string;
+    state: string;
+    tags: string[];
+    assignedTo?: string;
+    url: string;
+}
+/** Normalized pull request — maps to GitHub PRs or ADO PRs */
+export interface PullRequest {
+    id: number;
+    title: string;
+    sourceBranch: string;
+    targetBranch: string;
+    status: 'active' | 'completed' | 'abandoned' | 'draft';
+    reviewStatus?: 'approved' | 'changes-requested' | 'pending';
+    author: string;
+    url: string;
+}
+/** Platform adapter interface — implemented by GitHub and ADO adapters */
+export interface PlatformAdapter {
+    readonly type: PlatformType;
+    listWorkItems(options: {
+        tags?: string[];
+        state?: string;
+        limit?: number;
+    }): Promise<WorkItem[]>;
+    getWorkItem(id: number): Promise<WorkItem>;
+    createWorkItem(options: {
+        title: string;
+        description?: string;
+        tags?: string[];
+        assignedTo?: string;
+        type?: string;
+    }): Promise<WorkItem>;
+    addTag(workItemId: number, tag: string): Promise<void>;
+    removeTag(workItemId: number, tag: string): Promise<void>;
+    addComment(workItemId: number, comment: string): Promise<void>;
+    listPullRequests(options: {
+        status?: string;
+        limit?: number;
+    }): Promise<PullRequest[]>;
+    createPullRequest(options: {
+        title: string;
+        sourceBranch: string;
+        targetBranch: string;
+        description?: string;
+    }): Promise<PullRequest>;
+    mergePullRequest(id: number): Promise<void>;
+    createBranch(name: string, fromBranch?: string): Promise<void>;
+}
+/** Where communication happens — which channel/service */
+export type CommunicationChannel = 'github-discussions' | 'ado-work-items' | 'teams-webhook' | 'file-log';
+/** A reply from a human on a communication channel */
+export interface CommunicationReply {
+    author: string;
+    body: string;
+    timestamp: Date;
+    /** Platform-specific identifier for the reply */
+    id: string;
+}
+/** Configuration for a communication channel */
+export interface CommunicationConfig {
+    channel: CommunicationChannel;
+    /** Post session summaries after agent work */
+    postAfterSession?: boolean;
+    /** Post decisions that need human review */
+    postDecisions?: boolean;
+    /** Post escalations when agents are blocked */
+    postEscalations?: boolean;
+}
+/**
+ * Communication adapter interface — pluggable agent-human communication.
+ *
+ * Abstracts the communication channel so Squad can post updates and read
+ * replies from GitHub Discussions, ADO Work Item discussions, Teams, or
+ * plain log files — depending on what the user has configured.
+ */
+export interface CommunicationAdapter {
+    readonly channel: CommunicationChannel;
+    /**
+     * Post an update to the communication channel.
+     * Used by Scribe (session summaries), Ralph (board status), and agents (escalations).
+     */
+    postUpdate(options: {
+        title: string;
+        body: string;
+        category?: string;
+        /** Agent or role posting the update */
+        author?: string;
+    }): Promise<{
+        id: string;
+        url?: string;
+    }>;
+    /**
+     * Poll for replies since a given timestamp.
+     * Returns new replies from humans on the channel.
+     */
+    pollForReplies(options: {
+        /** Thread/discussion ID to check for replies */
+        threadId: string;
+        since: Date;
+    }): Promise<CommunicationReply[]>;
+    /**
+     * Get a URL that humans can open on any device (phone, browser, desktop).
+     * Returns undefined if the channel has no web UI (e.g., file-log).
+     */
+    getNotificationUrl(threadId: string): string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/types.d.ts.map

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

package/dist/platform/types.js

@@ -0,0 +1,8 @@
+/**
+ * Platform-agnostic interfaces for multi-platform support.
+ * Allows Squad to work with GitHub and Azure DevOps interchangeably.
+ *
+ * @module platform/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/platform/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/streams/filter.d.ts

@@ -1,33 +1,37 @@
 /**
- * Workstream-Aware Issue Filtering
+ * SubSquad-Aware Issue Filtering
  *
- * Filters GitHub issues to only those matching a workstream's labelFilter.
- * Intended to scope work to the active workstream during triage.
+ * Filters GitHub issues to only those matching a SubSquad's labelFilter.
+ * Intended to scope work to the active SubSquad during triage.
  *
  * @module streams/filter
  */
-import type { ResolvedWorkstream } from './types.js';
+import type { ResolvedSubSquad } from './types.js';
 /** Minimal issue shape for filtering. */
-export interface WorkstreamIssue {
+export interface SubSquadIssue {
     number: number;
     title: string;
     labels: Array<{
         name: string;
     }>;
 }
-/** @deprecated Use WorkstreamIssue instead */
-export type StreamIssue = WorkstreamIssue;
+/** @deprecated Use SubSquadIssue instead */
+export type WorkstreamIssue = SubSquadIssue;
+/** @deprecated Use SubSquadIssue instead */
+export type StreamIssue = SubSquadIssue;
 /**
- * Filter issues to only those matching the workstream's label filter.
+ * Filter issues to only those matching the SubSquad's label filter.
  *
- * Matching is case-insensitive. If the workstream has no labelFilter,
+ * Matching is case-insensitive. If the SubSquad has no labelFilter,
  * all issues are returned (passthrough).
  *
  * @param issues - Array of issues to filter
- * @param workstream - The resolved workstream to filter by
- * @returns Filtered array of issues matching the workstream's label
+ * @param subsquad - The resolved SubSquad to filter by
+ * @returns Filtered array of issues matching the SubSquad's label
  */
-export declare function filterIssuesByWorkstream(issues: WorkstreamIssue[], workstream: ResolvedWorkstream): WorkstreamIssue[];
-/** @deprecated Use filterIssuesByWorkstream instead */
-export declare const filterIssuesByStream: typeof filterIssuesByWorkstream;
+export declare function filterIssuesBySubSquad(issues: SubSquadIssue[], subsquad: ResolvedSubSquad): SubSquadIssue[];
+/** @deprecated Use filterIssuesBySubSquad instead */
+export declare const filterIssuesByWorkstream: typeof filterIssuesBySubSquad;
+/** @deprecated Use filterIssuesBySubSquad instead */
+export declare const filterIssuesByStream: typeof filterIssuesBySubSquad;
 //# sourceMappingURL=filter.d.ts.map

package/dist/streams/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/streams/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EAAE,EACzB,UAAU,EAAE,kBAAkB,GAC7B,eAAe,EAAE,CAUnB;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,iCAA2B,CAAC"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/streams/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AAExC;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,EAAE,gBAAgB,GACzB,aAAa,EAAE,CAUjB;AAED,qDAAqD;AACrD,eAAO,MAAM,wBAAwB,+BAAyB,CAAC;AAE/D,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,+BAAyB,CAAC"}