@bradygaster/squad-sdk 0.7.0 → 0.8.2-1.4

package/dist/skills/skill-source.js

@@ -0,0 +1,199 @@
+/**
+ * Skill Source Interface & Implementations (M5-5, Issue #128)
+ *
+ * Pluggable skill discovery from local filesystem or GitHub repos.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseFrontmatter } from './skill-loader.js';
+// --- Local implementation ---
+export class LocalSkillSource {
+    basePath;
+    name = 'local';
+    type = 'local';
+    priority;
+    constructor(basePath, priority = 0) {
+        this.basePath = basePath;
+        this.priority = priority;
+    }
+    get skillsDir() {
+        return path.join(this.basePath, '.squad', 'skills');
+    }
+    async listSkills() {
+        if (!fs.existsSync(this.skillsDir))
+            return [];
+        let entries;
+        try {
+            entries = fs.readdirSync(this.skillsDir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        const manifests = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillFile = path.join(this.skillsDir, entry.name, 'SKILL.md');
+            if (!fs.existsSync(skillFile))
+                continue;
+            try {
+                const raw = fs.readFileSync(skillFile, 'utf-8');
+                const { meta } = parseFrontmatter(raw);
+                manifests.push({
+                    id: entry.name,
+                    name: typeof meta.name === 'string' ? meta.name : entry.name,
+                    domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                    source: 'local',
+                });
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return manifests;
+    }
+    async getSkill(id) {
+        const skillFile = path.join(this.skillsDir, id, 'SKILL.md');
+        if (!fs.existsSync(skillFile))
+            return null;
+        try {
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { meta, body } = parseFrontmatter(raw);
+            if (!body)
+                return null;
+            return {
+                id,
+                name: typeof meta.name === 'string' ? meta.name : id,
+                domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                content: body,
+                triggers: Array.isArray(meta.triggers) ? meta.triggers : [],
+                agentRoles: Array.isArray(meta.roles) ? meta.roles : [],
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async getContent(id) {
+        const skillFile = path.join(this.skillsDir, id, 'SKILL.md');
+        if (!fs.existsSync(skillFile))
+            return null;
+        try {
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { body } = parseFrontmatter(raw);
+            return body || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// --- GitHub implementation ---
+export class GitHubSkillSource {
+    name = 'github';
+    type = 'github';
+    priority;
+    owner;
+    repoName;
+    branch;
+    pathPrefix;
+    fetcher;
+    constructor(repo, options) {
+        const parts = repo.split('/');
+        if (parts.length !== 2 || !parts[0] || !parts[1]) {
+            throw new Error(`Invalid repo format "${repo}": expected "owner/repo"`);
+        }
+        this.owner = parts[0];
+        this.repoName = parts[1];
+        this.branch = options?.ref;
+        this.pathPrefix = options?.pathPrefix ?? '.squad/skills';
+        this.fetcher = options?.fetcher ?? {
+            async listDirectory() { throw new Error('No GitHubFetcher configured'); },
+            async getFileContent() { throw new Error('No GitHubFetcher configured'); },
+        };
+        this.priority = options?.priority ?? 0;
+    }
+    async listSkills() {
+        const entries = await this.fetcher.listDirectory(this.owner, this.repoName, this.pathPrefix, this.branch);
+        const dirs = entries.filter(e => e.type === 'dir');
+        const manifests = [];
+        for (const dir of dirs) {
+            const skillPath = `${this.pathPrefix}/${dir.name}/SKILL.md`;
+            const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+            if (!content)
+                continue;
+            const { meta } = parseFrontmatter(content);
+            manifests.push({
+                id: dir.name,
+                name: typeof meta.name === 'string' ? meta.name : dir.name,
+                domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                source: 'github',
+            });
+        }
+        return manifests;
+    }
+    async getSkill(id) {
+        const skillPath = `${this.pathPrefix}/${id}/SKILL.md`;
+        const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+        if (!content)
+            return null;
+        const { meta, body } = parseFrontmatter(content);
+        if (!body)
+            return null;
+        return {
+            id,
+            name: typeof meta.name === 'string' ? meta.name : id,
+            domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+            content: body,
+            triggers: Array.isArray(meta.triggers) ? meta.triggers : [],
+            agentRoles: Array.isArray(meta.roles) ? meta.roles : [],
+        };
+    }
+    async getContent(id) {
+        const skillPath = `${this.pathPrefix}/${id}/SKILL.md`;
+        const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+        if (!content)
+            return null;
+        const { body } = parseFrontmatter(content);
+        return body || null;
+    }
+}
+// --- Registry ---
+export class SkillSourceRegistry {
+    sources = new Map();
+    register(source) {
+        this.sources.set(source.name, source);
+    }
+    unregister(name) {
+        return this.sources.delete(name);
+    }
+    getSource(name) {
+        return this.sources.get(name);
+    }
+    /** Sources sorted by priority descending (higher priority first). */
+    sortedSources() {
+        return Array.from(this.sources.values()).sort((a, b) => b.priority - a.priority);
+    }
+    async listAllSkills() {
+        const sorted = this.sortedSources();
+        const results = await Promise.all(sorted.map(s => s.listSkills()));
+        return results.flat();
+    }
+    async findSkill(id) {
+        for (const source of this.sortedSources()) {
+            const skill = await source.getSkill(id);
+            if (skill)
+                return skill;
+        }
+        return null;
+    }
+    async getContent(id) {
+        for (const source of this.sortedSources()) {
+            const content = await source.getContent(id);
+            if (content)
+                return content;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=skill-source.js.map

package/dist/skills/skill-source.js.map

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

package/dist/streams/filter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Workstream-Aware Issue Filtering
+ *
+ * Filters GitHub issues to only those matching a workstream's labelFilter.
+ * Intended to scope work to the active workstream during triage.
+ *
+ * @module streams/filter
+ */
+import type { ResolvedWorkstream } from './types.js';
+/** Minimal issue shape for filtering. */
+export interface WorkstreamIssue {
+    number: number;
+    title: string;
+    labels: Array<{
+        name: string;
+    }>;
+}
+/** @deprecated Use WorkstreamIssue instead */
+export type StreamIssue = WorkstreamIssue;
+/**
+ * Filter issues to only those matching the workstream's label filter.
+ *
+ * Matching is case-insensitive. If the workstream 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
+ */
+export declare function filterIssuesByWorkstream(issues: WorkstreamIssue[], workstream: ResolvedWorkstream): WorkstreamIssue[];
+/** @deprecated Use filterIssuesByWorkstream instead */
+export declare const filterIssuesByStream: typeof filterIssuesByWorkstream;
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +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"}

package/dist/streams/filter.js

@@ -0,0 +1,29 @@
+/**
+ * Workstream-Aware Issue Filtering
+ *
+ * Filters GitHub issues to only those matching a workstream's labelFilter.
+ * Intended to scope work to the active workstream during triage.
+ *
+ * @module streams/filter
+ */
+/**
+ * Filter issues to only those matching the workstream's label filter.
+ *
+ * Matching is case-insensitive. If the workstream 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
+ */
+export function filterIssuesByWorkstream(issues, workstream) {
+    const filter = workstream.definition.labelFilter;
+    if (!filter) {
+        return issues;
+    }
+    const normalizedFilter = filter.toLowerCase();
+    return issues.filter(issue => issue.labels.some(label => label.name.toLowerCase() === normalizedFilter));
+}
+/** @deprecated Use filterIssuesByWorkstream instead */
+export const filterIssuesByStream = filterIssuesByWorkstream;
+//# sourceMappingURL=filter.js.map

package/dist/streams/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/streams/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAyB,EACzB,UAA8B;IAE9B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC,CAC1E,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC"}

package/dist/streams/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workstreams module — barrel exports.
+ *
+ * @module streams
+ */
+export * from './types.js';
+export * from './resolver.js';
+export * from './filter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/streams/index.js

@@ -0,0 +1,9 @@
+/**
+ * Workstreams module — barrel exports.
+ *
+ * @module streams
+ */
+export * from './types.js';
+export * from './resolver.js';
+export * from './filter.js';
+//# sourceMappingURL=index.js.map

package/dist/streams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/streams/resolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Workstream Resolver — Resolves which workstream is active.
+ *
+ * Resolution order:
+ *   1. SQUAD_TEAM env var → look up in workstreams config
+ *   2. .squad-workstream file (gitignored) → contains workstream name
+ *   3. If exactly one workstream is defined in the config, auto-select that workstream
+ *   4. null (no active workstream — single-squad mode / no workstreams)
+ *
+ * @module streams/resolver
+ */
+import type { WorkstreamConfig, ResolvedWorkstream } from './types.js';
+/**
+ * Load workstreams configuration from .squad/workstreams.json.
+ *
+ * @param squadRoot - Root directory of the project (where .squad/ lives)
+ * @returns Parsed WorkstreamConfig or null if not found / invalid
+ */
+export declare function loadWorkstreamsConfig(squadRoot: string): WorkstreamConfig | null;
+/** @deprecated Use loadWorkstreamsConfig instead */
+export declare const loadStreamsConfig: typeof loadWorkstreamsConfig;
+/**
+ * Resolve which workstream is active for the current environment.
+ *
+ * @param squadRoot - Root directory of the project
+ * @returns ResolvedWorkstream or null if no workstream is active
+ */
+export declare function resolveWorkstream(squadRoot: string): ResolvedWorkstream | null;
+/** @deprecated Use resolveWorkstream instead */
+export declare const resolveStream: typeof resolveWorkstream;
+/**
+ * Get the GitHub label filter string for a resolved workstream.
+ *
+ * @param workstream - The resolved workstream
+ * @returns Label filter string (e.g., "team:ui")
+ */
+export declare function getWorkstreamLabelFilter(workstream: ResolvedWorkstream): string;
+/** @deprecated Use getWorkstreamLabelFilter instead */
+export declare const getStreamLabelFilter: typeof getWorkstreamLabelFilter;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/streams/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAwB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE7F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA8EhF;AAED,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,8BAAwB,CAAC;AASvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA0D9E;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,0BAAoB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAE/E;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,iCAA2B,CAAC"}

package/dist/streams/resolver.js

@@ -0,0 +1,162 @@
+/**
+ * Workstream Resolver — Resolves which workstream is active.
+ *
+ * Resolution order:
+ *   1. SQUAD_TEAM env var → look up in workstreams config
+ *   2. .squad-workstream file (gitignored) → contains workstream name
+ *   3. If exactly one workstream is defined in the config, auto-select that workstream
+ *   4. null (no active workstream — single-squad mode / no workstreams)
+ *
+ * @module streams/resolver
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Load workstreams configuration from .squad/workstreams.json.
+ *
+ * @param squadRoot - Root directory of the project (where .squad/ lives)
+ * @returns Parsed WorkstreamConfig or null if not found / invalid
+ */
+export function loadWorkstreamsConfig(squadRoot) {
+    const configPath = join(squadRoot, '.squad', 'workstreams.json');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const rawConfig = JSON.parse(raw);
+        if (!rawConfig || typeof rawConfig !== 'object') {
+            return null;
+        }
+        const configLike = rawConfig;
+        // Derive a sane defaultWorkflow value
+        const validWorkflows = ['branch-per-issue', 'direct'];
+        const rawWorkflow = typeof configLike.defaultWorkflow === 'string' && configLike.defaultWorkflow.trim() !== ''
+            ? configLike.defaultWorkflow
+            : 'branch-per-issue';
+        const defaultWorkflow = validWorkflows.includes(rawWorkflow)
+            ? rawWorkflow
+            : 'branch-per-issue';
+        const workstreamsRaw = configLike.workstreams;
+        if (!Array.isArray(workstreamsRaw)) {
+            return null;
+        }
+        const workstreams = workstreamsRaw
+            .filter(entry => entry && typeof entry === 'object')
+            .map(entry => {
+            const e = entry;
+            if (typeof e.name !== 'string' || typeof e.labelFilter !== 'string') {
+                return null;
+            }
+            const normalized = {
+                name: e.name,
+                labelFilter: e.labelFilter,
+            };
+            if (Array.isArray(e.folderScope) && e.folderScope.every(item => typeof item === 'string')) {
+                normalized.folderScope = e.folderScope;
+            }
+            if (typeof e.workflow === 'string' && e.workflow.trim() !== '') {
+                normalized.workflow = e.workflow;
+            }
+            else {
+                normalized.workflow = defaultWorkflow;
+            }
+            if (typeof e.description === 'string') {
+                normalized.description = e.description;
+            }
+            return normalized;
+        })
+            .filter((s) => s !== null);
+        if (workstreams.length === 0) {
+            return null;
+        }
+        return { defaultWorkflow, workstreams };
+    }
+    catch {
+        return null;
+    }
+}
+/** @deprecated Use loadWorkstreamsConfig instead */
+export const loadStreamsConfig = loadWorkstreamsConfig;
+/**
+ * Find a workstream definition by name in a config.
+ */
+function findWorkstream(config, name) {
+    return config.workstreams.find(s => s.name === name);
+}
+/**
+ * Resolve which workstream is active for the current environment.
+ *
+ * @param squadRoot - Root directory of the project
+ * @returns ResolvedWorkstream or null if no workstream is active
+ */
+export function resolveWorkstream(squadRoot) {
+    const config = loadWorkstreamsConfig(squadRoot);
+    // 1. SQUAD_TEAM env var
+    const envTeam = process.env.SQUAD_TEAM;
+    if (envTeam) {
+        if (config) {
+            const def = findWorkstream(config, envTeam);
+            if (def) {
+                return { name: envTeam, definition: def, source: 'env' };
+            }
+        }
+        // Env var set but no matching workstream config — synthesize a minimal definition
+        return {
+            name: envTeam,
+            definition: {
+                name: envTeam,
+                labelFilter: `team:${envTeam}`,
+            },
+            source: 'env',
+        };
+    }
+    // 2. .squad-workstream file
+    const workstreamFilePath = join(squadRoot, '.squad-workstream');
+    if (existsSync(workstreamFilePath)) {
+        try {
+            const workstreamName = readFileSync(workstreamFilePath, 'utf-8').trim();
+            if (workstreamName) {
+                if (config) {
+                    const def = findWorkstream(config, workstreamName);
+                    if (def) {
+                        return { name: workstreamName, definition: def, source: 'file' };
+                    }
+                }
+                // File exists but no config — synthesize
+                return {
+                    name: workstreamName,
+                    definition: {
+                        name: workstreamName,
+                        labelFilter: `team:${workstreamName}`,
+                    },
+                    source: 'file',
+                };
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // 3. If exactly one workstream is defined, auto-select it
+    if (config && config.workstreams.length === 1) {
+        const def = config.workstreams[0];
+        return { name: def.name, definition: def, source: 'config' };
+    }
+    // 4. No workstream detected
+    return null;
+}
+/** @deprecated Use resolveWorkstream instead */
+export const resolveStream = resolveWorkstream;
+/**
+ * Get the GitHub label filter string for a resolved workstream.
+ *
+ * @param workstream - The resolved workstream
+ * @returns Label filter string (e.g., "team:ui")
+ */
+export function getWorkstreamLabelFilter(workstream) {
+    return workstream.definition.labelFilter;
+}
+/** @deprecated Use getWorkstreamLabelFilter instead */
+export const getStreamLabelFilter = getWorkstreamLabelFilter;
+//# sourceMappingURL=resolver.js.map

package/dist/streams/resolver.js.map

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

package/dist/streams/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Workstream Types — Type definitions for Squad Workstreams.
+ *
+ * Workstreams enable horizontal scaling by allowing multiple Squad instances
+ * (e.g., in different Codespaces) to each handle a scoped subset of work.
+ *
+ * @module streams/types
+ */
+/** Definition of a single workstream (team partition). */
+export interface WorkstreamDefinition {
+    /** Workstream name, e.g., "ui-team", "backend-team" */
+    name: string;
+    /** GitHub label to filter issues by, e.g., "team:ui" */
+    labelFilter: string;
+    /** Optional folder restrictions, e.g., ["apps/web"] */
+    folderScope?: string[];
+    /** Workflow mode. Default: branch-per-issue */
+    workflow?: 'branch-per-issue' | 'direct';
+    /** Human-readable description of this workstream's purpose */
+    description?: string;
+}
+/** @deprecated Use WorkstreamDefinition instead */
+export type StreamDefinition = WorkstreamDefinition;
+/** Top-level workstreams configuration (stored in .squad/workstreams.json). */
+export interface WorkstreamConfig {
+    /** All configured workstreams */
+    workstreams: WorkstreamDefinition[];
+    /** Default workflow for workstreams that don't specify one */
+    defaultWorkflow: 'branch-per-issue' | 'direct';
+}
+/** @deprecated Use WorkstreamConfig instead */
+export type StreamConfig = WorkstreamConfig;
+/** A resolved workstream with provenance information. */
+export interface ResolvedWorkstream {
+    /** Workstream name */
+    name: string;
+    /** Full workstream definition */
+    definition: WorkstreamDefinition;
+    /** How this workstream was resolved */
+    source: 'env' | 'file' | 'config';
+}
+/** @deprecated Use ResolvedWorkstream instead */
+export type ResolvedStream = ResolvedWorkstream;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/streams/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC;IACzC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,8DAA8D;IAC9D,eAAe,EAAE,kBAAkB,GAAG,QAAQ,CAAC;CAChD;AAED,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,oBAAoB,CAAC;IACjC,uCAAuC;IACvC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC"}

package/dist/streams/types.js

@@ -0,0 +1,10 @@
+/**
+ * Workstream Types — Type definitions for Squad Workstreams.
+ *
+ * Workstreams enable horizontal scaling by allowing multiple Squad instances
+ * (e.g., in different Codespaces) to each handle a scoped subset of work.
+ *
+ * @module streams/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/streams/types.js.map

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