@prodara/compiler 0.1.0

package/README.md

@@ -0,0 +1,204 @@
+# @prodara/compiler
+
+The core compilation engine, workflow orchestrator, and programmatic API for the Prodara spec-first language.
+
+## Installation
+
+```bash
+npm install @prodara/compiler
+```
+
+## Overview
+
+The compiler takes `.prd` specification files through a 15-phase pipeline:
+
+1. **Discovery** → **Lexing** → **Parsing** → **Binding** → **Type Checking** → **Semantic Validation**
+2. **Graph Building** → **Graph Validation** → **Constitution Resolution**
+3. **Diffing** → **Impact Propagation** → **Planning**
+4. **Incremental Spec** → **Workflow Engine** → **Review/Fix Loop** → **Verification**
+
+## Programmatic API
+
+```typescript
+import { compile, buildGraph, serializeGraph, formatDiagnosticsJson } from '@prodara/compiler';
+
+const result = compile('./my-project');
+
+if (result.diagnostics.hasErrors) {
+  console.error(formatDiagnosticsJson(result.diagnostics));
+} else {
+  console.log(serializeGraph(result.graph!));
+}
+```
+
+See the [root README](../../README.md) for the full API reference.
+
+## Customization
+
+### Custom Reviewers
+
+Drop `.md` files in `.prodara/reviewers/` to create custom reviewer agents. The filename becomes the reviewer name (e.g., `performance.md` → `performance` reviewer).
+
+```typescript
+import { discoverCustomReviewers, loadReviewerPrompt } from '@prodara/compiler';
+
+// Discover all custom reviewers in .prodara/reviewers/
+const customs = await discoverCustomReviewers('/path/to/project');
+
+// Load a specific reviewer prompt
+const prompt = await loadReviewerPrompt(
+  { promptPath: '.prodara/reviewers/performance.md' },
+  '/path/to/project',
+);
+```
+
+Alternatively, set `reviewers.{name}.promptPath` in `prodara.config.json` to point to any `.md` file.
+
+### Constitution
+
+A project-level constitution provides global instructions injected into all AI prompts:
+
+```typescript
+import { loadConstitution } from '@prodara/compiler';
+
+// Loads from config.constitution.path or .prodara/constitution.md
+const text = await loadConstitution(resolvedConfig, '/path/to/project');
+```
+
+Configure in `prodara.config.json`:
+
+```json
+{
+  "constitution": {
+    "path": ".prodara/constitution.md"
+  }
+}
+```
+
+### Template Overrides
+
+Override any built-in template with a local `.md` file:
+
+```json
+{
+  "templateOverrides": {
+    "phase:implement": ".prodara/templates/implement.md"
+  }
+}
+```
+
+### Per-Artifact Rules
+
+Define rules that are injected into phase templates for specific artifact types:
+
+```json
+{
+  "artifactRules": {
+    "proposal": ["Must include acceptance criteria", "Max 200 words"],
+    "design": ["Include sequence diagrams"]
+  }
+}
+```
+
+### Pre-Review Loop
+
+Run reviewers *before* implementation to catch spec-level issues early. Disabled by default:
+
+```json
+{
+  "preReview": {
+    "enabled": true,
+    "maxIterations": 2,
+    "fixSeverity": ["critical", "error"]
+  }
+}
+```
+
+Skip at runtime with the `noPreReview` pipeline option. The `postReview` key is accepted as a backward-compatible alias for `reviewFix`.
+```
+
+### Exploration, Help & Party Mode
+
+Three interactive templates for AI agent collaboration:
+
+- **Explore** (`/prodara:explore <topic>`) — Read-only investigation of a topic within the product graph. Analyzes modules, entities, and relationships without modifying files.
+- **Help** (`/prodara:help`) — Contextual guidance based on project state. Detects .prd files, build artifacts, and provides recommendations.
+- **Party** (`/prodara:party <topic>`) — Multi-perspective discussion from configured reviewer agents. Each perspective provides analysis, followed by a synthesis.
+
+### Design Documents & Onboarding
+
+- **Design** (`/prodara:design <change>`) — Generates a per-change design document with technical approach, affected modules, predicted file changes, risk assessment, and architecture decisions.
+- **Onboard** (`/prodara:onboard`) — Interactive onboarding guide that detects project state (empty, basic, complete) and provides step-by-step guidance tailored to your current setup.
+
+## Slash Commands
+
+`prodara init --ai <agent>` generates slash command files for 26 supported AI agents. Commands are organized into four categories:
+
+| Category | Commands |
+|---|---|
+| **Workflow** | `build`, `validate`, `constitution`, `specify`, `plan`, `implement`, `clarify`, `review`, `propose`, `explore`, `party` |
+| **Spec-edit** | `add-module`, `add-entity`, `add-workflow`, `add-screen`, `add-policy`, `rename`, `move` |
+| **Query** | `explain`, `why`, `graph`, `diff`, `drift`, `analyze`, `checklist` |
+| **Management** | `help`, `onboard`, `extensions`, `presets` |
+
+29 commands are generated per agent, each adapted to the agent's file format (`.md`, `.prompt.md`, `.mdc`, etc.).
+
+### Extension Marketplace
+
+Search, install, and remove extensions and presets via npm:
+
+```typescript
+import { searchMarketplace, npmInstall, npmRemove } from '@prodara/compiler';
+
+// Search for extensions or presets
+const extensions = searchMarketplace('auth', 'extension');
+const presets    = searchMarketplace('saas', 'preset');
+
+// Install/remove
+npmInstall('prodara-extension-auth', process.cwd());
+npmRemove('prodara-extension-auth', process.cwd());
+```
+
+Convention: extensions are named `prodara-extension-{name}`, presets `prodara-preset-{name}`.
+
+### Custom Workflows
+
+Define named workflow schemas in `.prodara.yaml`:
+
+```yaml
+workflows:
+  default:
+    phases: [specify, clarify, plan, implement, review, verify]
+  fast:
+    phases: [plan, implement, verify]
+    reviewBefore: [security]
+  strict:
+    phases: [specify, clarify, plan, implement, review, verify]
+    reviewBefore: [architecture, security]
+    reviewAfter: [quality, testQuality]
+```
+
+Each workflow defines its phase sequence and optional `reviewBefore`/`reviewAfter` gates. The `default` workflow is used when none is specified.
+
+## CLI
+
+When installed as a project dependency, provides a local `prodara` binary:
+
+```bash
+npx prodara build
+npx prodara validate --format json
+npx prodara graph --output build/graph.json
+npx prodara test
+```
+
+## Testing
+
+```bash
+npm test              # 985 tests
+npm run test:coverage # Enforces 100% coverage
+npm run typecheck     # Zero errors
+```
+
+## License
+
+MIT

package/dist/agent/agent.d.ts

@@ -0,0 +1,10 @@
+import type { AgentDriver, AgentRequest, AgentResponse, AgentPlatform, PromptFileOutput } from './types.js';
+export declare class PromptFileDriver implements AgentDriver {
+    readonly platform: AgentPlatform;
+    private readonly root;
+    constructor(platform: AgentPlatform, root: string);
+    execute(request: AgentRequest): Promise<AgentResponse>;
+    generatePromptFile(request: AgentRequest): PromptFileOutput;
+}
+export declare function createDriver(platform: AgentPlatform, root: string): AgentDriver;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EAEb,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAsBpB,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM;IAK3C,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB5D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB;CAU5D;AA+DD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAM/E"}

package/dist/agent/agent.js

@@ -0,0 +1,122 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Agent Driver
+// ---------------------------------------------------------------------------
+// Platform-agnostic agent orchestration. Supports prompt-file drivers (IDE)
+// and direct API drivers (headless/CI).
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Prompt File Driver — writes prompt files for IDE-based agents
+// ---------------------------------------------------------------------------
+const PLATFORM_PATHS = {
+    copilot: '.github/prompts',
+    claude: '.claude/commands',
+    cursor: '.cursor/rules',
+    opencode: '.opencode/agent',
+    codex: '.codex',
+};
+const PLATFORM_EXTENSIONS = {
+    copilot: '.prompt.md',
+    claude: '.md',
+    cursor: '.mdc',
+    opencode: '.md',
+    codex: '.md',
+};
+export class PromptFileDriver {
+    platform;
+    root;
+    constructor(platform, root) {
+        this.platform = platform;
+        this.root = root;
+    }
+    async execute(request) {
+        const start = Date.now();
+        const output = this.generatePromptFile(request);
+        // Write the prompt file
+        const dir = dirname(output.path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(output.path, output.content, 'utf-8');
+        const metadata = {
+            platform: this.platform,
+            duration_ms: Date.now() - start,
+            tokens_used: null,
+            model: null,
+        };
+        return {
+            content: output.content,
+            status: 'success',
+            metadata,
+        };
+    }
+    generatePromptFile(request) {
+        /* v8 ignore next 2 -- all known platforms are in the maps; fallback is defensive */
+        const dirName = PLATFORM_PATHS[this.platform] ?? '.prodara/prompts';
+        const ext = PLATFORM_EXTENSIONS[this.platform] ?? '.md';
+        const fileName = `prodara-${request.capability}${ext}`;
+        const path = join(this.root, dirName, fileName);
+        const content = formatPromptForPlatform(this.platform, request);
+        return { path, content };
+    }
+}
+// ---------------------------------------------------------------------------
+// Prompt formatting
+// ---------------------------------------------------------------------------
+function formatPromptForPlatform(platform, request) {
+    const sections = [];
+    // Platform-specific frontmatter
+    if (platform === 'copilot') {
+        sections.push('---');
+        sections.push(`mode: ${request.capability}`);
+        sections.push('tools: []');
+        sections.push('---');
+        sections.push('');
+    }
+    else if (platform === 'cursor') {
+        sections.push('---');
+        sections.push(`description: Prodara ${request.capability} phase`);
+        sections.push('globs: ["**/*.prd"]');
+        sections.push('---');
+        sections.push('');
+    }
+    // Main prompt
+    sections.push(request.prompt);
+    // Context sections
+    if (request.context.constitution) {
+        sections.push('');
+        sections.push('## Constitution');
+        sections.push('');
+        sections.push(request.context.constitution);
+    }
+    if (request.context.graphSlice) {
+        sections.push('');
+        sections.push('## Graph Context');
+        sections.push('');
+        sections.push(request.context.graphSlice);
+    }
+    if (request.context.governance) {
+        sections.push('');
+        sections.push('## Governance Rules');
+        sections.push('');
+        sections.push(request.context.governance);
+    }
+    for (const [key, value] of Object.entries(request.context.additionalContext)) {
+        sections.push('');
+        sections.push(`## ${key}`);
+        sections.push('');
+        sections.push(value);
+    }
+    return sections.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Driver factory
+// ---------------------------------------------------------------------------
+export function createDriver(platform, root) {
+    if (platform === 'api') {
+        // API driver placeholder — will be implemented in C4
+        throw new Error('API driver not yet implemented. Use --headless with a configured API key.');
+    }
+    return new PromptFileDriver(platform, root);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAC9E,4EAA4E;AAC5E,wCAAwC;AAExC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAW1C,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,iBAAiB;IAC3B,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,mBAAmB,GAA2B;IAClD,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,MAAM,OAAO,gBAAgB;IAClB,QAAQ,CAAgB;IAChB,IAAI,CAAS;IAE9B,YAAY,QAAuB,EAAE,IAAY;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAqB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAEhD,wBAAwB;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAkB;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC/B,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,SAAS;YACjB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,OAAqB;QACtC,oFAAoF;QACpF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,kBAAkB,CAAC;QACpE,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;QACxD,MAAM,QAAQ,GAAG,WAAW,OAAO,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEhE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,SAAS,uBAAuB,CAAC,QAAuB,EAAE,OAAqB;IAC7E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,gCAAgC;IAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,UAAU,QAAQ,CAAC,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAED,cAAc;IACd,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,mBAAmB;IACnB,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,UAAU,YAAY,CAAC,QAAuB,EAAE,IAAY;IAChE,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,qDAAqD;QACrD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/agent/api-client.d.ts

@@ -0,0 +1,29 @@
+import type { AgentDriver, AgentRequest, AgentResponse, AgentPlatform } from './types.js';
+import type { ApiProvider } from '../config/config.js';
+export interface ApiClientConfig {
+    readonly provider: ApiProvider;
+    readonly apiKey: string;
+    readonly model: string;
+    readonly baseUrl?: string;
+    readonly maxRetries?: number;
+    readonly timeoutMs?: number;
+}
+export interface ChatMessage {
+    readonly role: 'system' | 'user' | 'assistant';
+    readonly content: string;
+}
+interface ChatCompletionResult {
+    readonly content: string;
+    readonly model: string;
+    readonly tokens_used: number;
+}
+export declare function chatCompletion(config: ApiClientConfig, messages: readonly ChatMessage[]): Promise<ChatCompletionResult>;
+export declare class ApiDriver implements AgentDriver {
+    readonly platform: AgentPlatform;
+    private readonly config;
+    constructor(config: ApiClientConfig);
+    execute(request: AgentRequest): Promise<AgentResponse>;
+}
+export declare function createApiDriver(config: ApiClientConfig): ApiDriver;
+export {};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/agent/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/agent/api-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAyDD,wBAAsB,cAAc,CAClC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAwD/B;AAMD,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,eAAe;IAI7B,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA+C7D;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAElE"}

package/dist/agent/api-client.js

@@ -0,0 +1,167 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Headless API Client
+// ---------------------------------------------------------------------------
+// Minimal HTTP client for OpenAI and Anthropic chat completion APIs.
+// Uses Node.js built-in fetch (no external dependencies).
+// Supports retry with exponential backoff.
+// ---------------------------------------------------------------------------
+// Provider endpoints
+// ---------------------------------------------------------------------------
+const DEFAULT_URLS = {
+    openai: 'https://api.openai.com/v1/chat/completions',
+    anthropic: 'https://api.anthropic.com/v1/messages',
+};
+const DEFAULT_MODELS = {
+    openai: 'gpt-4o',
+    anthropic: 'claude-sonnet-4-20250514',
+};
+// ---------------------------------------------------------------------------
+// Internal: build request body per provider
+// ---------------------------------------------------------------------------
+function buildOpenAIBody(messages, model) {
+    return JSON.stringify({ model, messages, temperature: 0 });
+}
+function buildAnthropicBody(messages, model) {
+    const system = messages.find((m) => m.role === 'system')?.content ?? '';
+    const userMessages = messages
+        .filter((m) => m.role !== 'system')
+        .map((m) => ({ role: m.role, content: m.content }));
+    return JSON.stringify({ model, system, messages: userMessages, max_tokens: 4096 });
+}
+// ---------------------------------------------------------------------------
+// Internal: parse response per provider
+// ---------------------------------------------------------------------------
+function parseOpenAIResponse(data) {
+    const choices = data['choices'];
+    const content = choices?.[0]?.message?.content ?? '';
+    const usage = data['usage'];
+    const model = typeof data['model'] === 'string' ? data['model'] : '';
+    return { content, model, tokens_used: usage?.total_tokens ?? 0 };
+}
+function parseAnthropicResponse(data) {
+    const contentArr = data['content'];
+    const content = contentArr?.find((c) => c.type === 'text')?.text ?? '';
+    const usage = data['usage'];
+    const tokens = (usage?.input_tokens ?? 0) + (usage?.output_tokens ?? 0);
+    const model = typeof data['model'] === 'string' ? data['model'] : '';
+    return { content, model, tokens_used: tokens };
+}
+// ---------------------------------------------------------------------------
+// Core: send chat completion request with retry
+// ---------------------------------------------------------------------------
+export async function chatCompletion(config, messages) {
+    const url = config.baseUrl ?? DEFAULT_URLS[config.provider];
+    const model = config.model || DEFAULT_MODELS[config.provider];
+    const maxRetries = config.maxRetries ?? 3;
+    const timeoutMs = config.timeoutMs ?? 60_000;
+    const body = config.provider === 'openai'
+        ? buildOpenAIBody(messages, model)
+        : buildAnthropicBody(messages, model);
+    const headers = { 'Content-Type': 'application/json' };
+    if (config.provider === 'openai') {
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+    }
+    else {
+        headers['x-api-key'] = config.apiKey;
+        headers['anthropic-version'] = '2023-06-01';
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        if (attempt > 0) {
+            const delay = Math.min(1000 * Math.pow(2, attempt - 1), 8000);
+            await sleep(delay);
+        }
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`API ${response.status}: ${text.slice(0, 200)}`);
+            }
+            const data = (await response.json());
+            return config.provider === 'openai'
+                ? parseOpenAIResponse(data)
+                : parseAnthropicResponse(data);
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt === maxRetries - 1)
+                break;
+        }
+    }
+    throw lastError ?? /* v8 ignore next */ new Error('API request failed');
+}
+// ---------------------------------------------------------------------------
+// ApiDriver — implements AgentDriver for headless/CI use
+// ---------------------------------------------------------------------------
+export class ApiDriver {
+    platform = 'api';
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(request) {
+        const start = Date.now();
+        const messages = [];
+        // System message: constitution + governance
+        const systemParts = [];
+        if (request.context.constitution) {
+            systemParts.push(`# Constitution\n\n${request.context.constitution}`);
+        }
+        if (request.context.governance) {
+            systemParts.push(`# Governance\n\n${request.context.governance}`);
+        }
+        if (systemParts.length > 0) {
+            messages.push({ role: 'system', content: systemParts.join('\n\n') });
+        }
+        // User message: prompt + graph context
+        const userParts = [request.prompt];
+        if (request.context.graphSlice) {
+            userParts.push(`\n\n# Graph Context\n\n${request.context.graphSlice}`);
+        }
+        for (const [key, value] of Object.entries(request.context.additionalContext)) {
+            userParts.push(`\n\n# ${key}\n\n${value}`);
+        }
+        messages.push({ role: 'user', content: userParts.join('') });
+        try {
+            const result = await chatCompletion(this.config, messages);
+            const metadata = {
+                platform: 'api',
+                duration_ms: Date.now() - start,
+                tokens_used: result.tokens_used,
+                model: result.model,
+            };
+            return { content: result.content, status: 'success', metadata };
+        }
+        catch (err) {
+            const metadata = {
+                platform: 'api',
+                duration_ms: Date.now() - start,
+                tokens_used: null,
+                model: null,
+            };
+            const message = err instanceof Error ? err.message : /* v8 ignore next */ String(err);
+            return { content: message, status: 'error', metadata };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createApiDriver(config) {
+    return new ApiDriver(config);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=api-client.js.map

package/dist/agent/api-client.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,5 @@
+export { PromptFileDriver, createDriver } from './agent.js';
+export { ApiDriver, createApiDriver, chatCompletion } from './api-client.js';
+export type { ApiClientConfig, ChatMessage } from './api-client.js';
+export type { AgentDriver, AgentRequest, AgentResponse, AgentPlatform, AgentCapability, AgentStatus, AgentContext, AgentMetadata, PromptFileOutput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,3 @@
+export { PromptFileDriver, createDriver } from './agent.js';
+export { ApiDriver, createApiDriver, chatCompletion } from './api-client.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/agent/party.d.ts

@@ -0,0 +1,48 @@
+import type { ProductGraph } from '../graph/graph-types.js';
+import type { IncrementalSpec } from '../incremental/types.js';
+import type { ReviewerAgent } from '../reviewers/reviewer.js';
+import type { ReviewFinding } from '../reviewers/types.js';
+import type { GraphSlice } from '../generator/contracts.js';
+export type PartyRole = 'architect' | 'security' | 'developer' | 'qa' | 'ux';
+export interface PartyAgent {
+    readonly role: PartyRole;
+    readonly reviewer: ReviewerAgent;
+}
+export interface PartyConfig {
+    readonly agents: readonly PartyAgent[];
+    readonly coordinationMode: 'sequential' | 'parallel';
+    readonly maxRounds: number;
+}
+export interface PartyRound {
+    readonly roundNumber: number;
+    readonly agentResults: readonly PartyAgentResult[];
+    readonly consensusReached: boolean;
+}
+export interface PartyAgentResult {
+    readonly role: PartyRole;
+    readonly findings: readonly ReviewFinding[];
+}
+export interface PartyResult {
+    readonly rounds: readonly PartyRound[];
+    readonly finalConsensus: boolean;
+    readonly totalFindings: number;
+}
+/**
+ * Get the graph slices relevant to a party role.
+ */
+export declare function getSlicesForRole(graph: ProductGraph, role: PartyRole): readonly GraphSlice[];
+/**
+ * Run a party-mode review session.
+ *
+ * Each round:
+ * 1. Each agent reviews the full graph (agents are reviewers with role context)
+ * 2. Findings are collected
+ * 3. Consensus is checked — no new critical/error findings → done
+ * 4. If max rounds reached → stop
+ */
+export declare function runParty(graph: ProductGraph, spec: IncrementalSpec, config: PartyConfig): PartyResult;
+/**
+ * Format party results for human output.
+ */
+export declare function formatPartyHuman(result: PartyResult): string;
+//# sourceMappingURL=party.d.ts.map

package/dist/agent/party.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"party.d.ts","sourceRoot":"","sources":["../../src/agent/party.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAO3E,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAcD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,UAAU,EAAE,CAE5F;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,WAAW,GAClB,WAAW,CA6Bb;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsB5D"}