@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/agents/onboarding.js

@@ -0,0 +1,373 @@
+/**
+ * Agent Onboarding Module (M2-10, PRD #111)
+ *
+ * Handles runtime agent onboarding with context-aware charter generation.
+ * Creates agent directory, charter, and history with project context.
+ *
+ * @module agents/onboarding
+ */
+import { mkdir, writeFile, readFile } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+// ============================================================================
+// Default Charter Templates
+// ============================================================================
+/**
+ * Default charter templates for standard roles.
+ */
+const CHARTER_TEMPLATES = {
+    'lead': (displayName, context) => `# ${displayName} — Technical Lead
+
+Technical lead responsible for architecture, delegation, and project coordination.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Define technical direction and architecture
+- Coordinate work across team members
+- Review proposals and make final decisions
+- Maintain code quality standards
+- Mentor team members
+
+## Work Style
+
+- Think strategically about long-term maintainability
+- Delegate work effectively to specialists
+- Balance technical excellence with pragmatic delivery
+- Document architectural decisions
+- Foster collaborative team environment
+`,
+    'developer': (displayName, context) => `# ${displayName} — Software Developer
+
+Software developer focused on feature implementation and code quality.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Implement features according to specifications
+- Write clean, maintainable code
+- Create and maintain tests
+- Review code from team members
+- Document implementation decisions
+
+## Work Style
+
+- Follow established patterns and conventions
+- Write tests alongside implementation
+- Ask questions when requirements are unclear
+- Collaborate with team members on complex problems
+- Keep code simple and readable
+`,
+    'tester': (displayName, context) => `# ${displayName} — Quality Assurance
+
+Quality assurance specialist responsible for test coverage and validation.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Design and implement test strategies
+- Write comprehensive test suites
+- Validate features against requirements
+- Identify edge cases and failure modes
+- Maintain test infrastructure
+
+## Work Style
+
+- Think adversarially about how things can break
+- Automate testing wherever possible
+- Document test scenarios and coverage
+- Collaborate with developers on testability
+- Balance thoroughness with pragmatism
+`,
+    'scribe': (displayName, context) => `# ${displayName} — Documentation Specialist
+
+Documentation specialist maintaining history, decisions, and technical records.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Maintain agent history files
+- Document team decisions
+- Keep technical records organized
+- Summarize work sessions
+- Preserve institutional knowledge
+
+## Work Style
+
+- Write clear, concise documentation
+- Organize information for easy retrieval
+- Capture both what and why
+- Update documentation proactively
+- Maintain consistent formatting
+`,
+    'ralph': (displayName, context) => `# ${displayName} — Persistent Memory Agent
+
+Persistent memory agent that maintains context across sessions.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Maintain session-to-session continuity
+- Surface relevant historical context
+- Track long-running initiatives
+- Connect current work to past decisions
+- Preserve institutional knowledge
+
+## Work Style
+
+- Read team history before responding
+- Surface relevant past work without overwhelming
+- Connect dots across sessions
+- Maintain perspective on long-term goals
+- Help team avoid repeating mistakes
+`,
+    'designer': (displayName, context) => `# ${displayName} — User Experience Designer
+
+User experience designer focused on interface design and user interactions.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Design user interfaces and interactions
+- Create prototypes and mockups
+- Validate designs with users
+- Maintain design consistency
+- Document design decisions
+
+## Work Style
+
+- Think from the user's perspective
+- Balance aesthetics with usability
+- Iterate based on feedback
+- Maintain design system consistency
+- Collaborate with developers on implementation
+`,
+    'architect': (displayName, context) => `# ${displayName} — Software Architect
+
+Software architect responsible for system design and technical strategy.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Design system architecture
+- Define technical standards
+- Evaluate technology choices
+- Plan for scalability and maintainability
+- Document architectural decisions
+
+## Work Style
+
+- Think holistically about the system
+- Balance ideal design with practical constraints
+- Consider long-term implications
+- Document trade-offs clearly
+- Mentor team on architectural patterns
+`
+};
+/**
+ * Generate a generic charter when no template matches.
+ */
+function generateGenericCharter(displayName, role, context) {
+    return `# ${displayName} — ${titleCase(role)}
+
+Team member focused on ${role} responsibilities.
+
+## Project Context
+
+${context || 'Context will be provided by the team.'}
+
+## Responsibilities
+
+- Collaborate with team members on assigned work
+- Maintain code quality and project standards
+- Document decisions and progress in history
+- Follow team conventions and guidelines
+
+## Work Style
+
+- Read project context and team decisions before starting work
+- Communicate clearly with team members
+- Follow established patterns and conventions
+- Ask questions when requirements are unclear
+- Keep work focused and incremental
+`;
+}
+/**
+ * Generate history.md content with project context.
+ */
+function generateHistory(displayName, role, projectContext, userName) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# Project Context
+
+${userName ? `- **Owner:** ${userName}\n` : ''}- **Agent:** ${displayName}
+- **Role:** ${titleCase(role)}
+- **Onboarded:** ${now}
+
+## Core Context
+
+${projectContext || 'Project context will be provided by the team.'}
+
+## Recent Updates
+
+📌 Agent ${displayName} onboarded on ${now}
+
+## Learnings
+
+Ready to contribute to the team.
+`;
+}
+/**
+ * Convert kebab-case or snake_case to Title Case.
+ */
+function titleCase(str) {
+    return str
+        .split(/[-_]/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+// ============================================================================
+// Onboarding Functions
+// ============================================================================
+/**
+ * Onboard a new agent to the Squad.
+ *
+ * Creates:
+ * - Agent directory at .squad/agents/{name}/
+ * - charter.md from role template + project context
+ * - history.md with project description and tech stack
+ *
+ * @param options - Onboarding options
+ * @returns Result with created file paths
+ */
+export async function onboardAgent(options) {
+    const { teamRoot, agentName, role, displayName, projectContext, userName, charterTemplate } = options;
+    const createdFiles = [];
+    // Validate inputs
+    if (!teamRoot) {
+        throw new Error('teamRoot is required');
+    }
+    if (!agentName) {
+        throw new Error('agentName is required');
+    }
+    if (!role) {
+        throw new Error('role is required');
+    }
+    // Normalize agent name (kebab-case)
+    const normalizedName = agentName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+    // Create agent directory
+    const agentDir = join(teamRoot, '.squad', 'agents', normalizedName);
+    if (existsSync(agentDir)) {
+        throw new Error(`Agent directory already exists: ${agentDir}`);
+    }
+    await mkdir(agentDir, { recursive: true });
+    // Determine display name
+    const effectiveDisplayName = displayName || titleCase(normalizedName);
+    // Generate charter
+    let charterContent;
+    if (charterTemplate) {
+        charterContent = charterTemplate;
+    }
+    else {
+        const templateFn = CHARTER_TEMPLATES[role.toLowerCase()];
+        if (templateFn) {
+            charterContent = templateFn(effectiveDisplayName, projectContext);
+        }
+        else {
+            charterContent = generateGenericCharter(effectiveDisplayName, role, projectContext);
+        }
+    }
+    // Write charter.md
+    const charterPath = join(agentDir, 'charter.md');
+    await writeFile(charterPath, charterContent, 'utf-8');
+    createdFiles.push(charterPath);
+    // Generate history
+    const historyContent = generateHistory(effectiveDisplayName, role, projectContext, userName);
+    // Write history.md
+    const historyPath = join(agentDir, 'history.md');
+    await writeFile(historyPath, historyContent, 'utf-8');
+    createdFiles.push(historyPath);
+    return {
+        createdFiles,
+        agentDir,
+        charterPath,
+        historyPath
+    };
+}
+/**
+ * Update an agent's configuration to squad.config.ts (if it exists).
+ *
+ * This is a helper function to add agent routing after onboarding.
+ * Only works with TypeScript configs (JSON requires manual edit).
+ *
+ * @param teamRoot - Team root directory
+ * @param agentName - Agent name to add
+ * @param role - Agent role
+ * @returns True if config was updated, false if not found or JSON format
+ */
+export async function addAgentToConfig(teamRoot, agentName, role) {
+    const configPath = join(teamRoot, 'squad.config.ts');
+    if (!existsSync(configPath)) {
+        return false; // No TypeScript config to update
+    }
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        // Simple heuristic: add routing rule if role matches common work types
+        const workTypeMap = {
+            'developer': 'feature-dev',
+            'tester': 'testing',
+            'scribe': 'documentation',
+            'architect': 'architecture',
+            'designer': 'design'
+        };
+        const workType = workTypeMap[role.toLowerCase()];
+        if (!workType) {
+            return false; // No obvious work type mapping
+        }
+        // Check if this work type already has a rule
+        const workTypePattern = new RegExp(`workType:\\s*['"]${workType}['"]`);
+        if (workTypePattern.test(content)) {
+            return false; // Already has a rule for this work type
+        }
+        // Find the routing rules array and add new rule
+        const rulesPattern = /rules:\s*\[([^\]]*)\]/s;
+        const match = content.match(rulesPattern);
+        if (!match) {
+            return false; // Cannot parse rules array
+        }
+        const newRule = `      {
+        workType: '${workType}',
+        agents: ['@${agentName}'],
+        confidence: 'high'
+      }`;
+        const updatedRules = match[1].trim() + ',\n' + newRule;
+        const updatedContent = content.replace(rulesPattern, `rules: [\n${updatedRules}\n    ]`);
+        await writeFile(configPath, updatedContent, 'utf-8');
+        return true;
+    }
+    catch (error) {
+        // Silently fail if we can't parse/update the config
+        return false;
+    }
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/agents/onboarding.js.map

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

package/dist/build/bundle.d.ts

@@ -0,0 +1,32 @@
+/**
+ * M4-1: Bundle strategy & esbuild configuration
+ * Defines bundling strategy for the SDK: ESM output, tree-shakeable
+ */
+export type BundleFormat = 'esm' | 'cjs';
+export interface BundleConfig {
+    entryPoints: string[];
+    outDir: string;
+    format: BundleFormat;
+    minify: boolean;
+    sourcemap: boolean;
+    external: string[];
+}
+/**
+ * Create a full BundleConfig with sensible defaults, optionally overriding fields.
+ */
+export declare function createBundleConfig(options?: Partial<BundleConfig>): BundleConfig;
+/**
+ * Returns the list of entry points for the SDK build.
+ */
+export declare function getBundleTargets(): string[];
+export interface BundleValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    files: string[];
+}
+/**
+ * Check that the output directory contains expected build artifacts.
+ */
+export declare function validateBundleOutput(outDir: string): BundleValidationResult;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/build/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/build/bundle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAYhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAwC3E"}

package/dist/build/bundle.js

@@ -0,0 +1,97 @@
+/**
+ * M4-1: Bundle strategy & esbuild configuration
+ * Defines bundling strategy for the SDK: ESM output, tree-shakeable
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const DEFAULT_ENTRY_POINTS = [
+    'src/index.ts',
+    'src/config/index.ts',
+    'src/agents/onboarding.ts',
+    'src/casting/index.ts',
+    'src/skills/index.ts',
+    'src/runtime/config.ts',
+    'src/runtime/streaming.ts',
+    'src/runtime/cost-tracker.ts',
+    'src/coordinator/response-tiers.ts',
+];
+const DEFAULT_EXTERNAL = [
+    '@github/copilot-sdk',
+];
+const DEFAULT_CONFIG = {
+    entryPoints: DEFAULT_ENTRY_POINTS,
+    outDir: 'dist',
+    format: 'esm',
+    minify: false,
+    sourcemap: true,
+    external: DEFAULT_EXTERNAL,
+};
+/**
+ * Create a full BundleConfig with sensible defaults, optionally overriding fields.
+ */
+export function createBundleConfig(options) {
+    if (!options) {
+        return { ...DEFAULT_CONFIG, entryPoints: [...DEFAULT_CONFIG.entryPoints], external: [...DEFAULT_CONFIG.external] };
+    }
+    return {
+        entryPoints: options.entryPoints ? [...options.entryPoints] : [...DEFAULT_CONFIG.entryPoints],
+        outDir: options.outDir ?? DEFAULT_CONFIG.outDir,
+        format: options.format ?? DEFAULT_CONFIG.format,
+        minify: options.minify ?? DEFAULT_CONFIG.minify,
+        sourcemap: options.sourcemap ?? DEFAULT_CONFIG.sourcemap,
+        external: options.external ? [...options.external] : [...DEFAULT_CONFIG.external],
+    };
+}
+/**
+ * Returns the list of entry points for the SDK build.
+ */
+export function getBundleTargets() {
+    return [...DEFAULT_ENTRY_POINTS];
+}
+/**
+ * Check that the output directory contains expected build artifacts.
+ */
+export function validateBundleOutput(outDir) {
+    const errors = [];
+    const warnings = [];
+    const files = [];
+    const resolvedDir = resolve(outDir);
+    if (!existsSync(resolvedDir)) {
+        return { valid: false, errors: [`Output directory does not exist: ${resolvedDir}`], warnings, files };
+    }
+    const stat = statSync(resolvedDir);
+    if (!stat.isDirectory()) {
+        return { valid: false, errors: [`Path is not a directory: ${resolvedDir}`], warnings, files };
+    }
+    collectFiles(resolvedDir, resolvedDir, files);
+    const jsFiles = files.filter(f => f.endsWith('.js'));
+    const dtsFiles = files.filter(f => f.endsWith('.d.ts'));
+    const mapFiles = files.filter(f => f.endsWith('.js.map') || f.endsWith('.d.ts.map'));
+    if (jsFiles.length === 0) {
+        errors.push('No JavaScript output files found');
+    }
+    if (dtsFiles.length === 0) {
+        warnings.push('No TypeScript declaration files found');
+    }
+    if (mapFiles.length === 0) {
+        warnings.push('No source map files found');
+    }
+    const hasIndex = jsFiles.some(f => f === 'index.js' || f.endsWith('/index.js') || f.endsWith('\\index.js'));
+    if (!hasIndex) {
+        errors.push('Missing index.js entry point in output');
+    }
+    return { valid: errors.length === 0, errors, warnings, files };
+}
+function collectFiles(baseDir, dir, result) {
+    for (const entry of readdirSync(dir)) {
+        const fullPath = join(dir, entry);
+        const relativePath = fullPath.slice(baseDir.length + 1).replace(/\\/g, '/');
+        if (statSync(fullPath).isDirectory()) {
+            collectFiles(baseDir, fullPath, result);
+        }
+        else {
+            result.push(relativePath);
+        }
+    }
+}
+//# sourceMappingURL=bundle.js.map

package/dist/build/bundle.js.map

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

package/dist/build/ci-pipeline.d.ts

@@ -0,0 +1,51 @@
+/**
+ * M4-9: CI/CD pipeline for distribution
+ * Generates GitHub Actions workflow YAML for build, test, and release pipelines.
+ */
+export interface CIPipelineStep {
+    name: string;
+    command: string;
+    condition?: string;
+    env?: Record<string, string>;
+}
+export interface CIPipelineTrigger {
+    event: 'push' | 'pull_request' | 'release' | 'workflow_dispatch' | 'schedule';
+    branches?: string[];
+    tags?: string[];
+    cron?: string;
+}
+export interface CIPipelineArtifact {
+    name: string;
+    path: string;
+    retention?: number;
+}
+export interface CIPipelineConfig {
+    name: string;
+    steps: CIPipelineStep[];
+    triggers: CIPipelineTrigger[];
+    artifacts: CIPipelineArtifact[];
+    environment: Record<string, string>;
+    nodeVersion?: string;
+}
+export interface PipelineValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Generate a GitHub Actions CI workflow YAML string.
+ */
+export declare function generateGitHubActionsWorkflow(config: CIPipelineConfig): string;
+/**
+ * Generate a release workflow YAML string.
+ */
+export declare function generateReleaseWorkflow(config: CIPipelineConfig): string;
+/**
+ * Validate a CI pipeline configuration for completeness and correctness.
+ */
+export declare function validatePipelineConfig(config: CIPipelineConfig): PipelineValidationResult;
+/**
+ * Get the default CI pipeline steps.
+ */
+export declare function getDefaultSteps(): CIPipelineStep[];
+//# sourceMappingURL=ci-pipeline.d.ts.map

package/dist/build/ci-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-pipeline.d.ts","sourceRoot":"","sources":["../../src/build/ci-pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,mBAAmB,GAAG,UAAU,CAAC;IAC9E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA8BD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkF9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAaxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,wBAAwB,CAyCzF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAElD"}