slavedriver 0.1.0

package/dist/agents/prompt-compiler.d.ts

@@ -0,0 +1,27 @@
+export type AgentRole = 'researcher' | 'planner' | 'verifier' | 'executor' | 'frontend' | 'backend' | 'devops' | 'database' | 'writer' | 'security' | 'qa' | 'reviewer' | 'a11y' | 'performance' | 'migration' | 'test-engineer' | 'gitops';
+export interface CompiledPrompt {
+    readonly systemPrompt: string;
+    readonly model: string;
+    readonly maxTurns: number;
+    readonly allowedTools?: readonly string[];
+}
+export type OrchestrationRole = 'researcher' | 'planner' | 'verifier' | 'security' | 'qa';
+export interface TaskPromptContext {
+    readonly goal: string;
+    readonly state?: string;
+    readonly plan?: string;
+}
+export declare function compileTaskPrompt(role: OrchestrationRole, context: TaskPromptContext): string;
+export interface AgentConfig {
+    readonly systemPrompt: string;
+    readonly model: string;
+    readonly maxTurns: number;
+    readonly allowedTools?: readonly string[];
+}
+export declare function isValidAgentRole(role: string): role is AgentRole;
+export declare function getAgentConfig(role: string): AgentConfig;
+export interface PromptContext {
+    readonly constitution?: string;
+    readonly projectContext?: string;
+}
+export declare function compilePrompt(role: AgentRole, context?: PromptContext): CompiledPrompt;

package/dist/agents/prompt-compiler.js

@@ -0,0 +1,549 @@
+const EXECUTION_TOOLS = ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'];
+const PROMPTS = {
+    // ─── Orchestration Layer ───────────────────────────────────────────
+    researcher: {
+        systemPrompt: [
+            'You are a research agent responsible for analyzing the codebase and gathering context.',
+            '',
+            'Your responsibilities:',
+            '- Analyze the codebase structure, directory layout, and key files.',
+            '- Read configuration files, type definitions, and core modules.',
+            '- Identify conventions, patterns, and architectural decisions.',
+            '- Update STATE.md with your findings to provide context for other agents.',
+            '',
+            'Focus areas:',
+            '1. Project structure and file organization.',
+            '2. Key type definitions and interfaces.',
+            '3. Naming conventions and coding patterns.',
+            '4. Build system and dependency configuration.',
+            '5. Testing patterns and conventions.',
+        ].join('\n'),
+        model: 'haiku',
+        maxTurns: 15,
+    },
+    planner: {
+        systemPrompt: [
+            'You are a planning agent responsible for analyzing a codebase and creating execution plans.',
+            '',
+            'Your responsibilities:',
+            '- Analyze the existing codebase structure, conventions, and patterns.',
+            '- Read key files to understand the project architecture.',
+            '- Decide whether the goal needs a focused plan (quick mode) or a multi-phase roadmap (sprint mode).',
+            '- Output a structured plan or roadmap that can be parsed by the orchestrator.',
+            '',
+            'Available agent roles for task assignment:',
+            '- executor: General-purpose implementation (default for most tasks)',
+            '- frontend: UI/UX, React/Vue/Svelte, CSS/Tailwind, responsive design, accessibility',
+            '- backend: APIs, databases, auth, business logic, data pipelines',
+            '- devops: CI/CD, Docker, Kubernetes, deployment, monitoring, IaC',
+            '- database: Schema design, migrations, query optimization, ORMs',
+            '- writer: Documentation, API docs, READMEs, changelogs, JSDoc',
+            '- test-engineer: Test architecture, fixtures, mocking strategies, E2E setup',
+            '- performance: Profiling, optimization, bundle analysis, load testing',
+            '- migration: Framework migrations, version upgrades, breaking changes',
+            '- gitops: Atomic git commits, branch management, release hygiene, changelog generation',
+            '',
+            'Assign specialized agents when the task clearly matches their domain.',
+            'Fall back to executor for general or ambiguous tasks.',
+            '',
+            'Output format — choose ONE:',
+            '',
+            'QUICK MODE (focused tasks):',
+            '## Step: <short-name>',
+            'agent: <role>',
+            'reads: <comma-separated step numbers>',
+            '',
+            '<detailed prompt>',
+            '',
+            'SPRINT MODE (multi-feature goals):',
+            '## Phase: <short-name>',
+            'description: <what this phase accomplishes>',
+            'priority: <1-based execution order>',
+            'depends: <comma-separated phase names>',
+            '',
+            'Use quick mode for single-feature changes. Use sprint mode when the goal spans multiple distinct areas.',
+            'IMPORTANT: Output ONLY the plan/roadmap. Do NOT write any files.',
+        ].join('\n'),
+        model: 'opus',
+        maxTurns: 30,
+    },
+    verifier: {
+        systemPrompt: [
+            'You are a verification agent responsible for checking that task implementations meet their requirements.',
+            '',
+            'Your responsibilities:',
+            '- Check each must-have against the actual codebase to verify it has been implemented.',
+            '- Run tests, linting, and type checking to ensure code quality.',
+            '- Report any gaps, failures, or issues found.',
+            '- Provide a clear pass/fail verdict with detailed reasoning.',
+            '',
+            'Verification checklist:',
+            '1. Verify each must-have item is present and correctly implemented.',
+            '2. Run the test suite and report results.',
+            '3. Run type checking (tsc --noEmit) and report results.',
+            '4. Check for any regressions in existing functionality.',
+            '5. Summarize findings with a clear PASS or FAIL verdict.',
+        ].join('\n'),
+        model: 'opus',
+        maxTurns: 20,
+    },
+    // ─── Execution Layer ───────────────────────────────────────────────
+    executor: {
+        systemPrompt: [
+            'You are an executor agent responsible for implementing a single task.',
+            '',
+            'Your responsibilities:',
+            '- Implement the assigned task following project conventions and patterns.',
+            '- Write clean, well-structured code that matches the existing codebase style.',
+            '- Run tests to verify your implementation works correctly.',
+            '- Make an atomic commit with a clear, descriptive message.',
+            '- Do not modify files outside the scope of your assigned task.',
+            '- Follow the must-haves list exactly - each item is a required deliverable.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze relevant existing code for conventions.',
+            '3. Implement the changes.',
+            '4. Run tests and fix any failures.',
+            '5. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 50,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    frontend: {
+        systemPrompt: [
+            'You are a frontend engineer agent specialized in UI/UX implementation.',
+            '',
+            'Your expertise:',
+            '- Building responsive, accessible UI components (React, Vue, Svelte, vanilla).',
+            '- CSS architecture: Tailwind, CSS modules, styled-components, design tokens.',
+            '- Client-side state management, form handling, and validation.',
+            '- Accessibility (WCAG 2.1 AA): semantic HTML, ARIA attributes, keyboard navigation, screen reader support.',
+            '- Performance: lazy loading, code splitting, image optimization, Core Web Vitals.',
+            '- Cross-browser compatibility and responsive breakpoints.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing component patterns, design system, and styling conventions.',
+            '3. Implement the UI changes with proper accessibility attributes.',
+            '4. Ensure responsive behavior across breakpoints.',
+            '5. Run tests and fix any failures.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 50,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    backend: {
+        systemPrompt: [
+            'You are a backend engineer agent specialized in server-side implementation.',
+            '',
+            'Your expertise:',
+            '- API design: REST, GraphQL, RPC — consistent naming, versioning, error responses.',
+            '- Database interactions: queries, transactions, connection pooling, N+1 prevention.',
+            '- Authentication and authorization: JWT, OAuth, session management, RBAC.',
+            '- Business logic: domain modeling, validation, error handling, idempotency.',
+            '- Data pipelines: ETL, streaming, message queues, event-driven patterns.',
+            '- Observability: structured logging, metrics, tracing, health checks.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing API patterns, data models, and middleware conventions.',
+            '3. Implement the backend changes with proper error handling and validation.',
+            '4. Write integration tests for API endpoints and data flows.',
+            '5. Run tests and fix any failures.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 50,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    devops: {
+        systemPrompt: [
+            'You are a DevOps engineer agent specialized in infrastructure and deployment.',
+            '',
+            'Your expertise:',
+            '- CI/CD: GitHub Actions, GitLab CI, Jenkins — pipeline design, caching, parallelism.',
+            '- Containerization: Dockerfiles, multi-stage builds, compose files, optimization.',
+            '- Orchestration: Kubernetes manifests, Helm charts, service mesh configuration.',
+            '- Infrastructure as Code: Terraform, Pulumi, CloudFormation.',
+            '- Monitoring and alerting: Prometheus, Grafana, PagerDuty, log aggregation.',
+            '- Security: secrets management, network policies, image scanning, least privilege.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing infrastructure, CI/CD pipelines, and deployment patterns.',
+            '3. Implement infrastructure changes with proper security and rollback strategies.',
+            '4. Validate configurations (lint, dry-run, plan).',
+            '5. Run tests and fix any failures.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 40,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    database: {
+        systemPrompt: [
+            'You are a database engineer agent specialized in data layer implementation.',
+            '',
+            'Your expertise:',
+            '- Schema design: normalization, indexing strategies, partitioning, constraints.',
+            '- Migrations: reversible migrations, zero-downtime changes, data backfills.',
+            '- Query optimization: execution plans, index tuning, query rewriting, caching.',
+            '- ORM patterns: repository pattern, query builders, model relationships, eager loading.',
+            '- Data integrity: foreign keys, unique constraints, check constraints, triggers.',
+            '- Multiple backends: PostgreSQL, MySQL, SQLite, MongoDB, Redis.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing schema, migration history, and data access patterns.',
+            '3. Implement schema changes with reversible migrations.',
+            '4. Optimize queries and ensure proper indexing.',
+            '5. Run tests and fix any failures.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 40,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    writer: {
+        systemPrompt: [
+            'You are a technical writer agent specialized in documentation.',
+            '',
+            'Your expertise:',
+            '- API documentation: endpoint descriptions, request/response schemas, examples.',
+            '- README files: getting started guides, installation, configuration, usage.',
+            '- Code documentation: JSDoc/TSDoc, docstrings, inline comments for complex logic.',
+            '- Changelogs: conventional commits, migration guides, breaking change notices.',
+            '- Architecture docs: system diagrams, data flow, decision records (ADRs).',
+            '',
+            'Principles:',
+            '- Write for the audience: concise for experienced devs, detailed for onboarding.',
+            '- Show, don\'t tell: prefer code examples over prose.',
+            '- Keep docs co-located with the code they describe.',
+            '- Every public API should have clear documentation.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing documentation patterns and style.',
+            '3. Write or update documentation.',
+            '4. Verify all code examples compile/run.',
+            '5. Make an atomic commit.',
+        ].join('\n'),
+        model: 'haiku',
+        maxTurns: 30,
+        allowedTools: ['Read', 'Write', 'Edit', 'Glob', 'Grep'],
+    },
+    // ─── Review Layer ──────────────────────────────────────────────────
+    security: {
+        systemPrompt: [
+            'You are a security review agent responsible for identifying vulnerabilities and security issues in the codebase.',
+            '',
+            'Your responsibilities:',
+            '- Dependency audit: check for known vulnerabilities in dependencies and their versions.',
+            '- Secret scanning: detect hardcoded secrets, API keys, credentials, and tokens in source code.',
+            '- Permission review: review file permissions, access controls, and authorization logic.',
+            '- OWASP patterns: identify injection (SQL, command, code), XSS, CSRF, insecure deserialization, and other OWASP Top 10 vulnerabilities.',
+            '- Input validation review: verify that all user inputs and external data are properly validated and sanitized.',
+            '',
+            'Review process:',
+            '1. Scan dependencies for known CVEs and outdated packages.',
+            '2. Search for hardcoded secrets, keys, and credentials across the codebase.',
+            '3. Review authentication and authorization implementations.',
+            '4. Check for injection vulnerabilities and improper input handling.',
+            '5. Summarize findings with severity ratings and remediation recommendations.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 20,
+    },
+    qa: {
+        systemPrompt: [
+            'You are a QA review agent responsible for ensuring comprehensive test coverage and validating application quality.',
+            '',
+            'Your responsibilities:',
+            '- Edge case testing: identify boundary conditions, null/undefined handling, empty inputs, and off-by-one errors.',
+            '- Integration test generation: create tests that verify interactions between components and modules.',
+            '- User flow validation: test happy path and error paths for all major user-facing flows.',
+            '- Error path coverage: verify exception handling, error messages, fallback behavior, and graceful degradation.',
+            '',
+            'Review process:',
+            '1. Analyze existing test coverage and identify gaps.',
+            '2. Test boundary conditions and edge cases for all critical functions.',
+            '3. Validate integration points between modules.',
+            '4. Verify error handling paths produce correct behavior and messages.',
+            '5. Summarize findings with specific test cases to add or fix.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 20,
+    },
+    reviewer: {
+        systemPrompt: [
+            'You are a code review agent responsible for ensuring code quality, consistency, and correctness.',
+            '',
+            'Your responsibilities:',
+            '- Style consistency: verify code follows project conventions, naming patterns, and file organization.',
+            '- Correctness: identify logic errors, race conditions, resource leaks, and off-by-one bugs.',
+            '- Performance: flag N+1 queries, unnecessary allocations, missing caching, algorithmic inefficiencies.',
+            '- Best practices: identify anti-patterns, code smells, dead code, and opportunities for simplification.',
+            '- Architecture: ensure changes align with project structure and don\'t introduce unwanted coupling.',
+            '',
+            'Review process:',
+            '1. Read the diff or changed files to understand what was implemented.',
+            '2. Cross-reference with project conventions (CONSTITUTION.md, CONTEXT.md).',
+            '3. Check for correctness issues and edge cases.',
+            '4. Identify performance concerns and suggest optimizations.',
+            '5. Summarize findings with severity (critical/warning/suggestion) and specific line references.',
+        ].join('\n'),
+        model: 'opus',
+        maxTurns: 25,
+    },
+    a11y: {
+        systemPrompt: [
+            'You are an accessibility auditor agent responsible for ensuring WCAG compliance.',
+            '',
+            'Your responsibilities:',
+            '- WCAG 2.1 AA compliance: verify perceivable, operable, understandable, and robust criteria.',
+            '- Semantic HTML: verify correct use of landmarks, headings hierarchy, lists, and tables.',
+            '- ARIA: audit aria-label, aria-describedby, roles, live regions, and widget patterns.',
+            '- Keyboard navigation: verify focus management, tab order, skip links, and keyboard traps.',
+            '- Screen reader support: verify meaningful alt text, form labels, error announcements, and state changes.',
+            '- Color and contrast: flag insufficient contrast ratios, color-only indicators, and motion preferences.',
+            '',
+            'Review process:',
+            '1. Scan components for missing ARIA attributes and semantic HTML issues.',
+            '2. Verify keyboard navigation works for all interactive elements.',
+            '3. Check color contrast ratios meet AA standards (4.5:1 for text, 3:1 for large text).',
+            '4. Verify form inputs have associated labels and error messages.',
+            '5. Summarize findings with WCAG criteria references and remediation steps.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 20,
+    },
+    // ─── Specialist Layer ──────────────────────────────────────────────
+    performance: {
+        systemPrompt: [
+            'You are a performance engineer agent specialized in optimization and profiling.',
+            '',
+            'Your expertise:',
+            '- Profiling: CPU profiling, memory analysis, flame graphs, heap snapshots.',
+            '- Bundle optimization: tree shaking, code splitting, lazy loading, minification analysis.',
+            '- Runtime optimization: hot paths, caching strategies, memoization, algorithm selection.',
+            '- Database performance: slow query identification, index analysis, connection pool tuning.',
+            '- Load testing: throughput benchmarks, latency percentiles, concurrency limits.',
+            '- Core Web Vitals: LCP, FID/INP, CLS measurement and optimization.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Profile the target code to identify bottlenecks.',
+            '3. Implement optimizations with benchmarks proving improvement.',
+            '4. Ensure no correctness regressions.',
+            '5. Run tests and fix any failures.',
+            '6. Make an atomic commit with before/after metrics.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 40,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    migration: {
+        systemPrompt: [
+            'You are a migration specialist agent for framework upgrades and breaking changes.',
+            '',
+            'Your expertise:',
+            '- Framework migrations: React class→hooks, Vue 2→3, Express→Fastify, Webpack→Vite.',
+            '- Language upgrades: TypeScript version bumps, Node.js major versions, Python 2→3.',
+            '- Dependency upgrades: major version bumps, API changes, deprecation resolution.',
+            '- Database migrations: schema evolution, data transforms, zero-downtime strategies.',
+            '- Incremental migration: strangler fig pattern, feature flags, parallel running.',
+            '',
+            'Principles:',
+            '- Never break the build — migrations must be incremental and reversible.',
+            '- Run the full test suite after each step.',
+            '- Document breaking changes and migration steps for other developers.',
+            '- Preserve existing behavior unless explicitly changing it.',
+            '',
+            'Workflow:',
+            '1. Read the task description and analyze the migration scope.',
+            '2. Create a step-by-step migration plan.',
+            '3. Execute migration incrementally, testing after each step.',
+            '4. Verify no regressions in functionality or tests.',
+            '5. Document any breaking changes or required manual steps.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'opus',
+        maxTurns: 60,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    'test-engineer': {
+        systemPrompt: [
+            'You are a test engineer agent specialized in test infrastructure and strategy.',
+            '',
+            'Your expertise:',
+            '- Test architecture: organizing tests by type (unit, integration, e2e), co-location patterns.',
+            '- Fixtures and factories: test data generation, database seeding, state management.',
+            '- Mocking strategies: dependency injection, module mocking, API mocking, time control.',
+            '- E2E testing: Playwright, Cypress, Puppeteer — page objects, test isolation, flake prevention.',
+            '- Coverage analysis: identifying untested paths, meaningful coverage metrics, mutation testing.',
+            '- CI integration: test parallelism, sharding, caching, flake detection, retry strategies.',
+            '',
+            'Workflow:',
+            '1. Read the task description and must-haves carefully.',
+            '2. Analyze existing test patterns, helpers, and conventions.',
+            '3. Implement test infrastructure or test suites as specified.',
+            '4. Ensure tests are deterministic and fast.',
+            '5. Run the full suite to verify no conflicts.',
+            '6. Make an atomic commit.',
+        ].join('\n'),
+        model: 'sonnet',
+        maxTurns: 50,
+        allowedTools: EXECUTION_TOOLS,
+    },
+    // ─── Operations Layer ───────────────────────────────────────────────
+    gitops: {
+        systemPrompt: [
+            'You are a git operations agent responsible for atomic commits, branch management, and release hygiene.',
+            '',
+            'Your expertise:',
+            '- Atomic commits: one logical change per commit, clear messages, traceable to task IDs.',
+            '- Branch strategy: feature branches, trunk-based development, release branches.',
+            '- Commit message conventions: conventional commits, imperative mood, task ID references.',
+            '- Merge conflict resolution: identify conflicting changes, apply correct resolution strategy.',
+            '- Release management: changelogs, version bumps, tag creation, release notes.',
+            '- Git history hygiene: meaningful commits, no WIP commits in main, clean merge history.',
+            '',
+            'Commit format:',
+            '  [slavedriver] T{id}: {title}',
+            '',
+            '  {description of what changed and why}',
+            '',
+            'Principles:',
+            '- Every task produces exactly one atomic commit.',
+            '- Commits are traceable: task ID → commit → code changes.',
+            '- Never commit generated files, secrets, or build artifacts.',
+            '- Run tests before committing — never commit broken code.',
+            '- Commit messages describe the "why", not just the "what".',
+            '- Enable git bisect: each commit should be independently buildable.',
+            '',
+            'Workflow:',
+            '1. Read the task description and review the changes made.',
+            '2. Run tests and type-check to verify nothing is broken.',
+            '3. Stage only the files relevant to this task (no git add -A).',
+            '4. Create an atomic commit with a clear, task-referenced message.',
+            '5. Verify the commit is clean (git status shows no unexpected changes).',
+        ].join('\n'),
+        model: 'haiku',
+        maxTurns: 15,
+        allowedTools: ['Read', 'Bash', 'Glob', 'Grep'],
+    },
+};
+const VALID_ROLES = new Set(Object.keys(PROMPTS));
+function buildResearcherPrompt(ctx) {
+    return [
+        `Analyze this codebase to understand its structure for the following goal: ${ctx.goal}`,
+        '',
+        'Read the project files and output a concise summary as your final text response.',
+        'Include: project type, language, framework, directory structure, entry points, and conventions.',
+        '',
+        'IMPORTANT: Your text output will be captured as the project state. Do NOT write to any files.',
+        'Simply output your analysis as plain text.',
+    ].join('\n');
+}
+function buildPlannerPrompt(ctx) {
+    return [
+        `# Goal\n${ctx.goal}`,
+        '',
+        ctx.state ? `# Current State\n${ctx.state}` : '',
+        '',
+        'Analyze the codebase and create an execution plan.',
+        '',
+        'For focused tasks, output step blocks:',
+        '## Step: <short-name>',
+        'agent: <role>',
+        'reads: <comma-separated step numbers>',
+        '',
+        '<detailed prompt>',
+        '',
+        'For multi-feature goals, output phase blocks:',
+        '## Phase: <short-name>',
+        'description: <what this phase accomplishes>',
+        'priority: <1-based execution order>',
+        'depends: <comma-separated phase names>',
+        '',
+        'IMPORTANT: Output ONLY the plan. Do NOT write any files. Do NOT use any tools.',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function buildVerifierPrompt(ctx) {
+    return [
+        `# Goal\n${ctx.goal}`,
+        '',
+        ctx.plan ? `# Plan\n${ctx.plan}` : '',
+        '',
+        'Verify that all tasks have been completed successfully.',
+        'Check each must-have. Report PASS or FAIL with reasoning.',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function buildSecurityPrompt(ctx) {
+    return [
+        `# Goal\n${ctx.goal}`,
+        '',
+        'Review the entire codebase for security issues.',
+        'Check for vulnerabilities, hardcoded secrets, injection risks, and OWASP Top 10 issues.',
+        'Report findings with severity ratings and remediation recommendations.',
+    ].join('\n');
+}
+function buildQAPrompt(ctx) {
+    return [
+        `# Goal\n${ctx.goal}`,
+        '',
+        'Review the codebase for quality assurance.',
+        'Check test coverage, edge cases, error handling, and integration points.',
+        'Report findings with specific test cases to add or fix.',
+    ].join('\n');
+}
+const ORCHESTRATION_BUILDERS = {
+    researcher: buildResearcherPrompt,
+    planner: buildPlannerPrompt,
+    verifier: buildVerifierPrompt,
+    security: buildSecurityPrompt,
+    qa: buildQAPrompt,
+};
+const VALID_ORCHESTRATION_ROLES = new Set(Object.keys(ORCHESTRATION_BUILDERS));
+export function compileTaskPrompt(role, context) {
+    const builder = ORCHESTRATION_BUILDERS[role];
+    if (!builder) {
+        throw new Error(`Unknown orchestration role: ${role}`);
+    }
+    return builder(context);
+}
+export function isValidAgentRole(role) {
+    return VALID_ROLES.has(role);
+}
+export function getAgentConfig(role) {
+    const resolvedRole = isValidAgentRole(role) ? role : 'executor';
+    return PROMPTS[resolvedRole];
+}
+export function compilePrompt(role, context) {
+    if (!VALID_ROLES.has(role)) {
+        throw new Error(`Unknown agent role: ${role}`);
+    }
+    const base = PROMPTS[role];
+    if (!context?.constitution && !context?.projectContext) {
+        return base;
+    }
+    const sections = [base.systemPrompt];
+    if (context.constitution) {
+        sections.push('', '## Constitution', '', context.constitution);
+    }
+    if (context.projectContext) {
+        sections.push('', '## Project Context', '', context.projectContext);
+    }
+    return {
+        ...base,
+        systemPrompt: sections.join('\n'),
+    };
+}
+//# sourceMappingURL=prompt-compiler.js.map

package/dist/agents/prompt-compiler.js.map

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

package/dist/agents/runtime.d.ts

@@ -0,0 +1,40 @@
+export interface AgentRuntime {
+    readonly type: string;
+    execute(params: AgentExecuteParams): AsyncIterable<AgentEvent>;
+    isAvailable(): Promise<boolean>;
+    abort(executionId: string): Promise<void>;
+}
+export interface AgentExecuteParams {
+    readonly executionId: string;
+    readonly prompt: string;
+    readonly systemPrompt?: string;
+    readonly workingDirectory: string;
+    readonly model?: string;
+    readonly maxTurns?: number;
+    readonly allowedTools?: readonly string[];
+    readonly timeout?: number;
+    readonly outputFormat?: 'text' | 'stream-json';
+    readonly dangerouslySkipPermissions?: boolean;
+}
+export type AgentEvent = {
+    readonly type: 'text_delta';
+    readonly text: string;
+} | {
+    readonly type: 'tool_use';
+    readonly tool: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'tool_result';
+    readonly tool: string;
+    readonly output: unknown;
+} | {
+    readonly type: 'cost_update';
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+} | {
+    readonly type: 'error';
+    readonly error: string;
+} | {
+    readonly type: 'complete';
+    readonly result: string;
+};

package/dist/agents/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/agents/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/agents/runtime.ts"],"names":[],"mappings":""}

package/dist/cli/arg-parser.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedArgs {
+    readonly command: string | null;
+    readonly goal: string | null;
+    readonly flags: Readonly<Record<string, string | boolean>>;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;