@aiagentflow/cli 0.1.0

package/dist/core/config/schema.d.ts.map

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

package/dist/core/config/schema.js

@@ -0,0 +1,102 @@
+/**
+ * Zod schemas defining the complete configuration shape.
+ *
+ * This is the authoritative definition of what a valid config looks like.
+ * All TypeScript types are inferred from these schemas via z.infer<>.
+ *
+ * Dependency direction: schema.ts → zod, agents/types.ts
+ * Used by: manager.ts, init.ts, types.ts
+ */
+import { z } from 'zod';
+/**
+ * Schema for a single agent role's configuration.
+ */
+export const agentRoleConfigSchema = z.object({
+    /** Which provider to use for this agent role. */
+    provider: z.enum(['anthropic', 'ollama']),
+    /** The model identifier to use. */
+    model: z.string().min(1),
+    /** Sampling temperature (0.0 = deterministic, higher = more creative). */
+    temperature: z.number().min(0).max(2).default(0.7),
+    /** Maximum tokens the model can generate in a response. */
+    maxTokens: z.number().int().min(1).max(200000).default(4096),
+});
+/**
+ * Schema for all agent configurations, keyed by role.
+ */
+export const agentConfigSchema = z.object({
+    architect: agentRoleConfigSchema,
+    coder: agentRoleConfigSchema,
+    reviewer: agentRoleConfigSchema,
+    tester: agentRoleConfigSchema,
+    fixer: agentRoleConfigSchema,
+    judge: agentRoleConfigSchema,
+});
+/**
+ * Schema for Anthropic provider settings.
+ */
+export const anthropicProviderSchema = z.object({
+    apiKey: z.string().min(1, 'Anthropic API key is required'),
+    baseUrl: z.string().url().default('https://api.anthropic.com'),
+    apiVersion: z.string().default('2023-06-01'),
+});
+/**
+ * Schema for Ollama provider settings.
+ */
+export const ollamaProviderSchema = z.object({
+    baseUrl: z.string().url().default('http://localhost:11434'),
+});
+/**
+ * Schema for provider configuration (all providers).
+ */
+export const providerConfigSchema = z.object({
+    anthropic: anthropicProviderSchema.optional(),
+    ollama: ollamaProviderSchema.optional(),
+});
+/**
+ * Schema for project-level settings.
+ */
+export const projectConfigSchema = z.object({
+    /** Primary programming language. */
+    language: z.string().default('typescript'),
+    /** Framework in use (e.g., "next.js", "express", "none"). */
+    framework: z.string().default('none'),
+    /** Test runner / framework (e.g., "vitest", "jest", "pytest"). */
+    testFramework: z.string().default('vitest'),
+    /** Glob patterns for source files. */
+    sourceGlobs: z.array(z.string()).default(['src/**/*.ts']),
+    /** Glob patterns for test files. */
+    testGlobs: z.array(z.string()).default(['tests/**/*.test.ts']),
+});
+/**
+ * Schema for workflow execution settings.
+ */
+export const workflowConfigSchema = z.object({
+    /** Maximum number of fix iterations before stopping. */
+    maxIterations: z.number().int().min(1).max(20).default(5),
+    /** Whether to require human approval between stages. */
+    humanApproval: z.boolean().default(true),
+    /** Whether to auto-create a Git branch for each task. */
+    autoCreateBranch: z.boolean().default(true),
+    /** Branch name prefix for auto-created branches. */
+    branchPrefix: z.string().default('aiagentflow/'),
+    /** Whether to auto-run tests after code generation. */
+    autoRunTests: z.boolean().default(true),
+});
+/**
+ * The complete application configuration schema.
+ * This is the single source of truth for config structure.
+ */
+export const appConfigSchema = z.object({
+    /** Schema version for future migrations. */
+    version: z.literal(1).default(1),
+    /** LLM provider connection settings. */
+    providers: providerConfigSchema,
+    /** Per-agent model and parameter assignments. */
+    agents: agentConfigSchema,
+    /** Project-level settings. */
+    project: projectConfigSchema,
+    /** Workflow execution settings. */
+    workflow: workflowConfigSchema,
+});
+//# sourceMappingURL=schema.js.map

package/dist/core/config/schema.js.map

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

package/dist/core/config/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TypeScript types inferred from Zod schemas.
+ *
+ * NEVER define config types manually — they are always derived
+ * from the Zod schemas to guarantee runtime and compile-time agreement.
+ *
+ * Dependency direction: types.ts → schema.ts
+ * Used by: every module that touches config
+ */
+import { z } from 'zod';
+import { agentConfigSchema, agentRoleConfigSchema, appConfigSchema, providerConfigSchema, projectConfigSchema, workflowConfigSchema } from './schema.js';
+/** Complete application configuration. */
+export type AppConfig = z.infer<typeof appConfigSchema>;
+/** LLM provider connection settings. */
+export type ProviderConfig = z.infer<typeof providerConfigSchema>;
+/** Project-level settings (language, framework, test runner). */
+export type ProjectConfig = z.infer<typeof projectConfigSchema>;
+/** Workflow execution settings. */
+export type WorkflowConfig = z.infer<typeof workflowConfigSchema>;
+/** Per-agent model and parameter assignments. */
+export type AgentConfig = z.infer<typeof agentConfigSchema>;
+/** Configuration for a single agent role. */
+export type AgentRoleConfig = z.infer<typeof agentRoleConfigSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/core/config/types.js

@@ -0,0 +1,11 @@
+/**
+ * TypeScript types inferred from Zod schemas.
+ *
+ * NEVER define config types manually — they are always derived
+ * from the Zod schemas to guarantee runtime and compile-time agreement.
+ *
+ * Dependency direction: types.ts → schema.ts
+ * Used by: every module that touches config
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/config/types.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Core error hierarchy for the AI Workflow Orchestrator.
+ *
+ * All errors extend AppError and carry a machine-readable code
+ * plus optional structured context for debugging.
+ *
+ * Dependency direction: errors.ts → nothing (leaf module)
+ * Used by: every layer in the application
+ */
+/** Base application error with structured metadata. */
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/** Raised when configuration is missing, invalid, or cannot be loaded/saved. */
+export declare class ConfigError extends AppError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Raised when an LLM provider call fails or cannot be reached. */
+export declare class ProviderError extends AppError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Raised when a Git operation fails. */
+export declare class GitError extends AppError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Raised when a workflow state transition is invalid. */
+export declare class WorkflowError extends AppError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Raised when user input fails validation. */
+export declare class ValidationError extends AppError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uDAAuD;AACvD,qBAAa,QAAS,SAAQ,KAAK;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAW/E;AAED,gFAAgF;AAChF,qBAAa,WAAY,SAAQ,QAAQ;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIjE;AAED,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIjE;AAED,yCAAyC;AACzC,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIjE;AAED,0DAA0D;AAC1D,qBAAa,aAAc,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIjE;AAED,+CAA+C;AAC/C,qBAAa,eAAgB,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIjE"}

package/dist/core/errors.js

@@ -0,0 +1,60 @@
+/**
+ * Core error hierarchy for the AI Workflow Orchestrator.
+ *
+ * All errors extend AppError and carry a machine-readable code
+ * plus optional structured context for debugging.
+ *
+ * Dependency direction: errors.ts → nothing (leaf module)
+ * Used by: every layer in the application
+ */
+/** Base application error with structured metadata. */
+export class AppError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.name = 'AppError';
+        this.code = code;
+        this.context = context;
+        // Maintains proper stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/** Raised when configuration is missing, invalid, or cannot be loaded/saved. */
+export class ConfigError extends AppError {
+    constructor(message, context) {
+        super(message, 'CONFIG_ERROR', context);
+        this.name = 'ConfigError';
+    }
+}
+/** Raised when an LLM provider call fails or cannot be reached. */
+export class ProviderError extends AppError {
+    constructor(message, context) {
+        super(message, 'PROVIDER_ERROR', context);
+        this.name = 'ProviderError';
+    }
+}
+/** Raised when a Git operation fails. */
+export class GitError extends AppError {
+    constructor(message, context) {
+        super(message, 'GIT_ERROR', context);
+        this.name = 'GitError';
+    }
+}
+/** Raised when a workflow state transition is invalid. */
+export class WorkflowError extends AppError {
+    constructor(message, context) {
+        super(message, 'WORKFLOW_ERROR', context);
+        this.name = 'WorkflowError';
+    }
+}
+/** Raised when user input fails validation. */
+export class ValidationError extends AppError {
+    constructor(message, context) {
+        super(message, 'VALIDATION_ERROR', context);
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uDAAuD;AACvD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACf,IAAI,CAAS;IACb,OAAO,CAA2B;IAElD,YAAY,OAAe,EAAE,IAAY,EAAE,OAAiC;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,qCAAqC;QACrC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;CACJ;AAED,gFAAgF;AAChF,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACrC,YAAY,OAAe,EAAE,OAAiC;QAC1D,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,mEAAmE;AACnE,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACvC,YAAY,OAAe,EAAE,OAAiC;QAC1D,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;CACJ;AAED,yCAAyC;AACzC,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAClC,YAAY,OAAe,EAAE,OAAiC;QAC1D,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IAC3B,CAAC;CACJ;AAED,0DAA0D;AAC1D,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACvC,YAAY,OAAe,EAAE,OAAiC;QAC1D,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;CACJ;AAED,+CAA+C;AAC/C,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IACzC,YAAY,OAAe,EAAE,OAAiC;QAC1D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ"}

package/dist/core/workflow/approval.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Human approval — interactive prompts for stage gates.
+ *
+ * When `humanApproval` is enabled in config, the workflow pauses
+ * between stages and asks the user to approve, edit, or abort.
+ *
+ * Dependency direction: approval.ts → prompts, chalk, utils
+ * Used by: workflow runner
+ */
+import type { WorkflowContext } from './engine.js';
+export type ApprovalDecision = 'approve' | 'edit' | 'retry' | 'abort';
+/**
+ * Ask the user to approve the current stage output.
+ *
+ * Shows a summary of what happened and gives options to proceed.
+ */
+export declare function requestApproval(ctx: WorkflowContext, agentRole: string, output: string): Promise<ApprovalDecision>;
+/**
+ * Check if approval is needed based on config and current state.
+ */
+export declare function needsApproval(humanApproval: boolean, state: string): boolean;
+//# sourceMappingURL=approval.d.ts.map

package/dist/core/workflow/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtE;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM5E"}

package/dist/core/workflow/approval.js

@@ -0,0 +1,54 @@
+/**
+ * Human approval — interactive prompts for stage gates.
+ *
+ * When `humanApproval` is enabled in config, the workflow pauses
+ * between stages and asks the user to approve, edit, or abort.
+ *
+ * Dependency direction: approval.ts → prompts, chalk, utils
+ * Used by: workflow runner
+ */
+import prompts from 'prompts';
+import chalk from 'chalk';
+/**
+ * Ask the user to approve the current stage output.
+ *
+ * Shows a summary of what happened and gives options to proceed.
+ */
+export async function requestApproval(ctx, agentRole, output) {
+    console.log();
+    console.log(chalk.bold.cyan(`── ${agentRole.toUpperCase()} Output ──`));
+    console.log();
+    // Show a truncated preview of the output
+    const preview = output.length > 500
+        ? output.slice(0, 500) + chalk.gray('\n... (truncated)')
+        : output;
+    console.log(preview);
+    console.log();
+    console.log(chalk.gray(`State: ${ctx.state} | Iteration: ${ctx.iteration}/${ctx.maxIterations}`));
+    console.log();
+    const { decision } = await prompts({
+        type: 'select',
+        name: 'decision',
+        message: 'How would you like to proceed?',
+        choices: [
+            { title: chalk.green('✔ Approve') + ' — continue to next stage', value: 'approve' },
+            { title: chalk.yellow('↻ Retry') + ' — re-run this agent', value: 'retry' },
+            { title: chalk.red('✘ Abort') + ' — stop the workflow', value: 'abort' },
+        ],
+        initial: 0,
+    });
+    if (!decision)
+        return 'abort';
+    return decision;
+}
+/**
+ * Check if approval is needed based on config and current state.
+ */
+export function needsApproval(humanApproval, state) {
+    if (!humanApproval)
+        return false;
+    // Skip approval for terminal states
+    const skipStates = ['complete', 'failed', 'idle'];
+    return !skipStates.includes(state);
+}
+//# sourceMappingURL=approval.js.map

package/dist/core/workflow/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/core/workflow/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,GAAoB,EACpB,SAAiB,EACjB,MAAc;IAEd,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,yCAAyC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG;QAC/B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACxD,CAAC,CAAC,MAAM,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAErB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,iBAAiB,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAAC;QAC/B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,gCAAgC;QACzC,OAAO,EAAE;YACL,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,2BAA2B,EAAE,KAAK,EAAE,SAAS,EAAE;YACnF,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE;YAC3E,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE;SAC3E;QACD,OAAO,EAAE,CAAC;KACb,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE9B,OAAO,QAA4B,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,aAAsB,EAAE,KAAa;IAC/D,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAEjC,oCAAoC;IACpC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/workflow/engine.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Workflow engine — core state machine that orchestrates the agent pipeline.
+ *
+ * Manages the lifecycle of a development task through stages:
+ * Spec → Plan → Code → Review → Test → Fix → QA → Complete
+ *
+ * Dependency direction: engine.ts → core/errors, agents/types, providers/types, utils
+ * Used by: cli/commands/run.ts
+ */
+import type { AgentRole } from '../../agents/types.js';
+export declare const WorkflowState: {
+    readonly Idle: "idle";
+    readonly SpecCreated: "spec_created";
+    readonly PlanApproved: "plan_approved";
+    readonly CodeGenerated: "code_generated";
+    readonly ReviewDone: "review_done";
+    readonly ReviewRejected: "review_rejected";
+    readonly TestsWritten: "tests_written";
+    readonly TestsPassed: "tests_passed";
+    readonly TestsFailed: "tests_failed";
+    readonly FixApplied: "fix_applied";
+    readonly QAApproved: "qa_approved";
+    readonly Complete: "complete";
+    readonly Failed: "failed";
+};
+export type WorkflowStateValue = (typeof WorkflowState)[keyof typeof WorkflowState];
+export type WorkflowEvent = {
+    type: 'SPEC_READY';
+    payload: {
+        spec: string;
+    };
+} | {
+    type: 'PLAN_APPROVED';
+    payload: {
+        plan: string;
+    };
+} | {
+    type: 'CODE_GENERATED';
+    payload: {
+        files: string[];
+    };
+} | {
+    type: 'REVIEW_DONE';
+    payload: {
+        approved: boolean;
+        feedback: string;
+    };
+} | {
+    type: 'TESTS_WRITTEN';
+    payload: {
+        testFiles: string[];
+    };
+} | {
+    type: 'TESTS_PASSED';
+} | {
+    type: 'TESTS_FAILED';
+    payload: {
+        failures: string;
+    };
+} | {
+    type: 'FIX_APPLIED';
+    payload: {
+        files: string[];
+    };
+} | {
+    type: 'QA_APPROVED';
+} | {
+    type: 'QA_REJECTED';
+    payload: {
+        reason: string;
+    };
+} | {
+    type: 'ABORT';
+    payload?: {
+        reason: string;
+    };
+};
+/** All accumulated data during a workflow run. */
+export interface WorkflowContext {
+    /** The original task description. */
+    task: string;
+    /** Current state of the workflow. */
+    state: WorkflowStateValue;
+    /** Number of fix iterations completed. */
+    iteration: number;
+    /** Maximum allowed fix iterations. */
+    maxIterations: number;
+    /** Spec generated by the architect agent. */
+    spec?: string;
+    /** Plan generated by the architect agent. */
+    plan?: string;
+    /** Files created or modified by the coder agent. */
+    generatedFiles: string[];
+    /** Review feedback from the reviewer agent. */
+    reviewFeedback?: string;
+    /** Test files generated by the tester agent. */
+    testFiles: string[];
+    /** Test failure details. */
+    testFailures?: string;
+    /** History of all state transitions. */
+    history: Array<{
+        from: WorkflowStateValue;
+        to: WorkflowStateValue;
+        event: string;
+        timestamp: number;
+    }>;
+}
+/** Maps workflow states to which agent runs at that stage. */
+export declare const STATE_AGENT_MAP: Partial<Record<WorkflowStateValue, AgentRole>>;
+/**
+ * Create a new workflow context for a task.
+ */
+export declare function createWorkflowContext(task: string, maxIterations?: number): WorkflowContext;
+/**
+ * Transition the workflow to a new state.
+ *
+ * @throws {WorkflowError} if the transition is invalid or max iterations exceeded.
+ */
+export declare function transition(context: WorkflowContext, event: WorkflowEvent): WorkflowContext;
+/**
+ * Check if the workflow is in a terminal state.
+ */
+export declare function isTerminal(context: WorkflowContext): boolean;
+/**
+ * Get the next agent that should run based on current state.
+ */
+export declare function getNextAgent(context: WorkflowContext): AgentRole | null;
+//# sourceMappingURL=engine.d.ts.map

package/dist/core/workflow/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAchB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAIpF,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAItD,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,EAAE,EAAE,kBAAkB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1G;AAqBD,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAS1E,CAAC;AAIF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,eAAe,CAU9F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,aAAa,GACrB,eAAe,CAiEjB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAEvE"}

package/dist/core/workflow/engine.js

@@ -0,0 +1,159 @@
+/**
+ * Workflow engine — core state machine that orchestrates the agent pipeline.
+ *
+ * Manages the lifecycle of a development task through stages:
+ * Spec → Plan → Code → Review → Test → Fix → QA → Complete
+ *
+ * Dependency direction: engine.ts → core/errors, agents/types, providers/types, utils
+ * Used by: cli/commands/run.ts
+ */
+import { WorkflowError } from '../errors.js';
+import { logger } from '../../utils/logger.js';
+// ── Workflow State ──
+export const WorkflowState = {
+    Idle: 'idle',
+    SpecCreated: 'spec_created',
+    PlanApproved: 'plan_approved',
+    CodeGenerated: 'code_generated',
+    ReviewDone: 'review_done',
+    ReviewRejected: 'review_rejected',
+    TestsWritten: 'tests_written',
+    TestsPassed: 'tests_passed',
+    TestsFailed: 'tests_failed',
+    FixApplied: 'fix_applied',
+    QAApproved: 'qa_approved',
+    Complete: 'complete',
+    Failed: 'failed',
+};
+// ── Valid Transitions ──
+/** Defines which state transitions are valid. */
+const VALID_TRANSITIONS = {
+    idle: ['spec_created', 'failed'],
+    spec_created: ['plan_approved', 'failed'],
+    plan_approved: ['code_generated', 'failed'],
+    code_generated: ['review_done', 'review_rejected', 'failed'],
+    review_done: ['tests_written', 'failed'],
+    review_rejected: ['fix_applied', 'failed'], // fixer runs → fix_applied → code_generated
+    tests_written: ['tests_passed', 'tests_failed', 'failed'],
+    tests_passed: ['qa_approved', 'failed'],
+    tests_failed: ['fix_applied', 'failed'],
+    fix_applied: ['code_generated', 'failed'], // loops back to reviewer via code_generated
+    qa_approved: ['complete'],
+    complete: [],
+    failed: [],
+};
+/** Maps workflow states to which agent runs at that stage. */
+export const STATE_AGENT_MAP = {
+    idle: 'architect',
+    spec_created: 'architect',
+    plan_approved: 'coder',
+    code_generated: 'reviewer',
+    review_done: 'tester',
+    review_rejected: 'fixer',
+    tests_failed: 'fixer',
+    tests_passed: 'judge',
+};
+// ── Workflow Engine ──
+/**
+ * Create a new workflow context for a task.
+ */
+export function createWorkflowContext(task, maxIterations = 5) {
+    return {
+        task,
+        state: WorkflowState.Idle,
+        iteration: 0,
+        maxIterations,
+        generatedFiles: [],
+        testFiles: [],
+        history: [],
+    };
+}
+/**
+ * Transition the workflow to a new state.
+ *
+ * @throws {WorkflowError} if the transition is invalid or max iterations exceeded.
+ */
+export function transition(context, event) {
+    const currentState = context.state;
+    const nextState = resolveNextState(currentState, event);
+    // Validate the transition
+    const validNextStates = VALID_TRANSITIONS[currentState];
+    if (!validNextStates?.includes(nextState)) {
+        throw new WorkflowError(`Invalid transition: ${currentState} → ${nextState} (event: ${event.type})`, { currentState, nextState, event: event.type });
+    }
+    // Check iteration limit on fix loops
+    const isFixLoop = nextState === 'review_rejected' || (nextState === 'fix_applied' && currentState === 'tests_failed');
+    const newIteration = isFixLoop ? context.iteration + 1 : context.iteration;
+    if (newIteration >= context.maxIterations) {
+        throw new WorkflowError(`Max iterations (${context.maxIterations}) exceeded. Stopping workflow.`, { iteration: newIteration, maxIterations: context.maxIterations });
+    }
+    logger.debug(`Workflow: ${currentState} → ${nextState} (${event.type})`);
+    // Build updated context
+    const updated = {
+        ...context,
+        state: nextState,
+        iteration: newIteration,
+        history: [
+            ...context.history,
+            { from: currentState, to: nextState, event: event.type, timestamp: Date.now() },
+        ],
+    };
+    // Apply event-specific data
+    switch (event.type) {
+        case 'SPEC_READY':
+            updated.spec = event.payload.spec;
+            break;
+        case 'PLAN_APPROVED':
+            updated.plan = event.payload.plan;
+            break;
+        case 'CODE_GENERATED':
+            updated.generatedFiles = [...updated.generatedFiles, ...event.payload.files];
+            break;
+        case 'REVIEW_DONE':
+            updated.reviewFeedback = event.payload.feedback;
+            break;
+        case 'TESTS_WRITTEN':
+            updated.testFiles = [...updated.testFiles, ...event.payload.testFiles];
+            break;
+        case 'TESTS_FAILED':
+            updated.testFailures = event.payload.failures;
+            break;
+        case 'FIX_APPLIED':
+            updated.generatedFiles = [...updated.generatedFiles, ...event.payload.files];
+            break;
+        default:
+            break;
+    }
+    return updated;
+}
+/**
+ * Check if the workflow is in a terminal state.
+ */
+export function isTerminal(context) {
+    return context.state === 'complete' || context.state === 'failed';
+}
+/**
+ * Get the next agent that should run based on current state.
+ */
+export function getNextAgent(context) {
+    return STATE_AGENT_MAP[context.state] ?? null;
+}
+// ── Private ──
+function resolveNextState(current, event) {
+    switch (event.type) {
+        case 'SPEC_READY': return WorkflowState.SpecCreated;
+        case 'PLAN_APPROVED': return WorkflowState.PlanApproved;
+        case 'CODE_GENERATED': return WorkflowState.CodeGenerated;
+        case 'REVIEW_DONE':
+            return event.payload.approved ? WorkflowState.ReviewDone : WorkflowState.ReviewRejected;
+        case 'TESTS_WRITTEN': return WorkflowState.TestsWritten;
+        case 'TESTS_PASSED': return WorkflowState.TestsPassed;
+        case 'TESTS_FAILED': return WorkflowState.TestsFailed;
+        case 'FIX_APPLIED': return WorkflowState.FixApplied;
+        case 'QA_APPROVED': return WorkflowState.QAApproved;
+        case 'QA_REJECTED': return WorkflowState.CodeGenerated;
+        case 'ABORT': return WorkflowState.Failed;
+        default: return WorkflowState.Failed;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/workflow/engine.js.map

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