@renseiai/agentfactory 0.8.8 → 0.8.10

package/README.md

@@ -17,7 +17,7 @@ import { createOrchestrator } from '@renseiai/agentfactory'
 
 const orchestrator = createOrchestrator({
   maxConcurrent: 3,
-  worktreePath: '.worktrees',
+  // Default: '../{repoName}.wt/' (sibling directory)
 })
 
 // Process a single issue
@@ -67,7 +67,7 @@ const orchestrator = createOrchestrator({
   provider: myProvider,            // Agent provider instance
   maxConcurrent: 3,                // Max concurrent agents
   project: 'MyProject',           // Filter by project
-  worktreePath: '.worktrees',     // Git worktree base path
+  // worktreePath defaults to '../{repoName}.wt/' (sibling directory)
   inactivityTimeoutMs: 300_000,   // 5 min idle timeout
   maxSessionTimeoutMs: 7_200_000, // 2 hour hard cap
   workTypeTimeouts: {

package/dist/src/config/index.d.ts

@@ -1,3 +1,3 @@
-export { loadRepositoryConfig, RepositoryConfigSchema, ProjectConfigSchema, ProvidersConfigSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig } from './repository-config.js';
+export { loadRepositoryConfig, RepositoryConfigSchema, ProjectConfigSchema, ProvidersConfigSchema, RoutingConfigSectionSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig, getRoutingConfig } from './repository-config.js';
 export type { RepositoryConfig, ProjectConfig } from './repository-config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AACpN,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAClQ,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/src/config/index.js

@@ -1 +1 @@
-export { loadRepositoryConfig, RepositoryConfigSchema, ProjectConfigSchema, ProvidersConfigSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig } from './repository-config.js';
+export { loadRepositoryConfig, RepositoryConfigSchema, ProjectConfigSchema, ProvidersConfigSchema, RoutingConfigSectionSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig, getRoutingConfig } from './repository-config.js';

package/dist/src/config/repository-config.d.ts

@@ -8,6 +8,7 @@
  */
 import { z } from 'zod';
 import type { ProvidersConfig } from '../providers/index.js';
+import type { RoutingConfig } from '../routing/types.js';
 /** Per-project configuration (object form of projectPaths values) */
 export declare const ProjectConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -47,6 +48,15 @@ export declare const ProvidersConfigSchema: z.ZodObject<{
         a2a: "a2a";
     }>>>;
 }, z.core.$strip>;
+/** Routing configuration for MAB-based provider selection */
+export declare const RoutingConfigSectionSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    explorationRate: z.ZodDefault<z.ZodNumber>;
+    windowSize: z.ZodDefault<z.ZodNumber>;
+    discountFactor: z.ZodDefault<z.ZodNumber>;
+    minObservationsForExploit: z.ZodDefault<z.ZodNumber>;
+    changeDetectionThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
 export declare const RepositoryConfigSchema: z.ZodObject<{
     apiVersion: z.ZodString;
     kind: z.ZodLiteral<"RepositoryConfig">;
@@ -100,6 +110,14 @@ export declare const RepositoryConfigSchema: z.ZodObject<{
             a2a: "a2a";
         }>>>;
     }, z.core.$strip>>;
+    routing: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        explorationRate: z.ZodDefault<z.ZodNumber>;
+        windowSize: z.ZodDefault<z.ZodNumber>;
+        discountFactor: z.ZodDefault<z.ZodNumber>;
+        minObservationsForExploit: z.ZodDefault<z.ZodNumber>;
+        changeDetectionThreshold: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
     mergeQueue: z.ZodOptional<z.ZodObject<{
         provider: z.ZodDefault<z.ZodEnum<{
             "github-native": "github-native";
@@ -110,6 +128,9 @@ export declare const RepositoryConfigSchema: z.ZodObject<{
         autoMerge: z.ZodDefault<z.ZodBoolean>;
         requiredChecks: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    worktree: z.ZodOptional<z.ZodObject<{
+        directory: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
     mergeDriver: z.ZodOptional<z.ZodEnum<{
         default: "default";
         mergiraf: "mergiraf";
@@ -138,6 +159,11 @@ export declare function getProjectPath(config: RepositoryConfig, projectName: st
  * Convenience helper for passing to ProviderResolutionContext.configProviders.
  */
 export declare function getProvidersConfig(config: RepositoryConfig): ProvidersConfig | undefined;
+/**
+ * Returns the routing config from a RepositoryConfig, if present.
+ * Convenience helper for passing to async provider resolution.
+ */
+export declare function getRoutingConfig(config: RepositoryConfig): RoutingConfig | undefined;
 /**
  * Load and validate .agentfactory/config.yaml from the given git root.
  *

package/dist/src/config/repository-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository-config.d.ts","sourceRoot":"","sources":["../../../src/config/repository-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAM5D,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAW9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAW/D,uCAAuC;AACvC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAOhC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuElC,CAAA;AAMD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,SAAS,CAK1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAepG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAExF;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQ7E"}
+{"version":3,"file":"repository-config.d.ts","sourceRoot":"","sources":["../../../src/config/repository-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAMxD,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAW9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAW/D,uCAAuC;AACvC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAOhC,CAAA;AAEF,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;iBAarC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyFlC,CAAA;AAMD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,SAAS,CAK1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAepG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAExF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAEpF;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQ7E"}

package/dist/src/config/repository-config.js

@@ -42,6 +42,21 @@ export const ProvidersConfigSchema = z.object({
     /** Provider overrides by project name (e.g., { Social: 'codex' }) */
     byProject: z.record(z.string(), AgentProviderNameSchema).optional(),
 });
+/** Routing configuration for MAB-based provider selection */
+export const RoutingConfigSectionSchema = z.object({
+    /** Enable MAB-based intelligent routing (default: false) */
+    enabled: z.boolean().default(false),
+    /** Exploration rate for Thompson Sampling (0-1, default: 0.1) */
+    explorationRate: z.number().min(0).max(1).default(0.1),
+    /** Observation window size (default: 100) */
+    windowSize: z.number().int().positive().default(100),
+    /** Discount factor for older observations (default: 0.99) */
+    discountFactor: z.number().min(0).max(1).default(0.99),
+    /** Minimum observations before exploiting (default: 5) */
+    minObservationsForExploit: z.number().int().min(0).default(5),
+    /** Change detection threshold (default: 0.2) */
+    changeDetectionThreshold: z.number().min(0).default(0.2),
+});
 export const RepositoryConfigSchema = z.object({
     apiVersion: z.string(),
     kind: z.literal('RepositoryConfig'),
@@ -90,6 +105,11 @@ export const RepositoryConfigSchema = z.object({
      * Allows routing agents to different providers by work type or project.
      */
     providers: ProvidersConfigSchema.optional(),
+    /**
+     * Routing configuration for MAB-based intelligent provider selection.
+     * When enabled, Thompson Sampling is used to learn optimal provider routing.
+     */
+    routing: RoutingConfigSectionSchema.optional(),
     /**
      * Merge queue configuration.
      * Controls which merge queue provider agents use for automated merging.
@@ -104,6 +124,19 @@ export const RepositoryConfigSchema = z.object({
         /** Required CI checks that must pass before merge (provider-specific) */
         requiredChecks: z.array(z.string()).optional(),
     }).optional(),
+    /**
+     * Worktree configuration.
+     * Controls where git worktrees are created and how paths are resolved.
+     */
+    worktree: z.object({
+        /**
+         * Base directory template for git worktrees.
+         * Supports template variables: {repoName} (repo directory basename), {branch} (worktree branch name).
+         * Default: '../{repoName}.wt' (sibling directory, outside repo to avoid VSCode file watcher crashes).
+         * Legacy: '.worktrees' (inside repo, causes VSCode crashes with many worktrees).
+         */
+        directory: z.string().default('../{repoName}.wt'),
+    }).optional(),
     /**
      * Git merge driver to use in agent worktrees.
      * 'mergiraf' enables syntax-aware merging for supported file types.
@@ -165,6 +198,13 @@ export function getProjectPath(config, projectName) {
 export function getProvidersConfig(config) {
     return config.providers;
 }
+/**
+ * Returns the routing config from a RepositoryConfig, if present.
+ * Convenience helper for passing to async provider resolution.
+ */
+export function getRoutingConfig(config) {
+    return config.routing;
+}
 // ---------------------------------------------------------------------------
 // Loader
 // ---------------------------------------------------------------------------

package/dist/src/config/repository-config.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { existsSync, readFileSync } from 'fs';
-import { loadRepositoryConfig, RepositoryConfigSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig, ProvidersConfigSchema } from './repository-config.js';
+import { loadRepositoryConfig, RepositoryConfigSchema, getEffectiveAllowedProjects, getProjectConfig, getProjectPath, getProvidersConfig, getRoutingConfig, ProvidersConfigSchema, RoutingConfigSectionSchema } from './repository-config.js';
 vi.mock('fs', () => ({
     existsSync: vi.fn(),
     readFileSync: vi.fn(),
@@ -548,3 +548,142 @@ describe('getProvidersConfig', () => {
         expect(getProvidersConfig(config)).toBeUndefined();
     });
 });
+describe('RoutingConfigSectionSchema', () => {
+    it('validates a complete routing config', () => {
+        const result = RoutingConfigSectionSchema.parse({
+            enabled: true,
+            explorationRate: 0.2,
+            windowSize: 200,
+            discountFactor: 0.95,
+            minObservationsForExploit: 10,
+            changeDetectionThreshold: 0.3,
+        });
+        expect(result.enabled).toBe(true);
+        expect(result.explorationRate).toBe(0.2);
+        expect(result.windowSize).toBe(200);
+        expect(result.discountFactor).toBe(0.95);
+        expect(result.minObservationsForExploit).toBe(10);
+        expect(result.changeDetectionThreshold).toBe(0.3);
+    });
+    it('applies defaults when only enabled is provided', () => {
+        const result = RoutingConfigSectionSchema.parse({ enabled: true });
+        expect(result.enabled).toBe(true);
+        expect(result.explorationRate).toBe(0.1);
+        expect(result.windowSize).toBe(100);
+        expect(result.discountFactor).toBe(0.99);
+        expect(result.minObservationsForExploit).toBe(5);
+        expect(result.changeDetectionThreshold).toBe(0.2);
+    });
+    it('applies defaults for an empty object (enabled defaults to false)', () => {
+        const result = RoutingConfigSectionSchema.parse({});
+        expect(result.enabled).toBe(false);
+        expect(result.explorationRate).toBe(0.1);
+    });
+    it('rejects explorationRate outside 0-1 range', () => {
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, explorationRate: 1.5 })).toThrow();
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, explorationRate: -0.1 })).toThrow();
+    });
+    it('rejects non-positive windowSize', () => {
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, windowSize: 0 })).toThrow();
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, windowSize: -1 })).toThrow();
+    });
+    it('rejects discountFactor outside 0-1 range', () => {
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, discountFactor: 1.1 })).toThrow();
+    });
+    it('rejects negative minObservationsForExploit', () => {
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, minObservationsForExploit: -1 })).toThrow();
+    });
+    it('rejects negative changeDetectionThreshold', () => {
+        expect(() => RoutingConfigSectionSchema.parse({ enabled: true, changeDetectionThreshold: -0.1 })).toThrow();
+    });
+});
+describe('RepositoryConfigSchema with routing', () => {
+    it('validates config with routing field', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            routing: {
+                enabled: true,
+                explorationRate: 0.05,
+            },
+        });
+        expect(result.routing).toBeDefined();
+        expect(result.routing.enabled).toBe(true);
+        expect(result.routing.explorationRate).toBe(0.05);
+        // Defaults should be applied
+        expect(result.routing.windowSize).toBe(100);
+    });
+    it('validates config without routing field', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+        expect(result.routing).toBeUndefined();
+    });
+    it('validates config with both providers and routing', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            providers: { default: 'codex' },
+            routing: { enabled: true },
+        });
+        expect(result.providers).toEqual({ default: 'codex' });
+        expect(result.routing.enabled).toBe(true);
+    });
+});
+describe('loadRepositoryConfig with routing', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('parses config with routing section', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+routing:
+  enabled: true
+  explorationRate: 0.05
+  windowSize: 50
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result?.routing).toBeDefined();
+        expect(result?.routing?.enabled).toBe(true);
+        expect(result?.routing?.explorationRate).toBe(0.05);
+        expect(result?.routing?.windowSize).toBe(50);
+        // Defaults applied for unspecified fields
+        expect(result?.routing?.discountFactor).toBe(0.99);
+        expect(result?.routing?.minObservationsForExploit).toBe(5);
+        expect(result?.routing?.changeDetectionThreshold).toBe(0.2);
+    });
+    it('parses config with routing disabled (default)', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+routing:
+  enabled: false
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result?.routing?.enabled).toBe(false);
+    });
+});
+describe('getRoutingConfig', () => {
+    it('returns routing config when present', () => {
+        const config = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            routing: { enabled: true },
+        });
+        const routing = getRoutingConfig(config);
+        expect(routing).toBeDefined();
+        expect(routing.enabled).toBe(true);
+    });
+    it('returns undefined when routing not set', () => {
+        const config = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+        expect(getRoutingConfig(config)).toBeUndefined();
+    });
+});

package/dist/src/governor/decision-engine.d.ts

@@ -9,6 +9,7 @@
  */
 import type { GovernorAction, GovernorConfig, GovernorIssue } from './governor-types.js';
 import type { WorkflowRegistry } from '../workflow/workflow-registry.js';
+import type { GateEvaluationResult } from '../workflow/gates/gate-evaluator.js';
 /**
  * All external state the Governor gathers before asking the decision engine
  * what to do. Callers are responsible for populating this context; the
@@ -32,6 +33,8 @@ export interface DecisionContext {
      * switch statement. Falls back to the switch statement when absent.
      */
     workflowRegistry?: WorkflowRegistry;
+    /** Gate evaluation result from the gate system (Phase 4) */
+    gateEvaluation?: GateEvaluationResult;
 }
 /** Max agent sessions before the circuit breaker trips and the issue is held */
 export declare const MAX_SESSION_ATTEMPTS = 3;

package/dist/src/governor/decision-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decision-engine.d.ts","sourceRoot":"","sources":["../../../src/governor/decision-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAMxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAOxE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAA;IACpB,MAAM,EAAE,cAAc,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,wBAAwB,EAAE,OAAO,CAAA;IACjC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAMrC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACf;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,cAAc,CAsGjE"}
+{"version":3,"file":"decision-engine.d.ts","sourceRoot":"","sources":["../../../src/governor/decision-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAMxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAM/E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAA;IACpB,MAAM,EAAE,cAAc,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,wBAAwB,EAAE,OAAO,CAAA;IACjC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAMrC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACf;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,cAAc,CAkHjE"}

package/dist/src/governor/decision-engine.js

@@ -47,6 +47,17 @@ export function decideAction(ctx) {
     if (ctx.isHeld) {
         return { action: 'none', reason: `Issue ${issue.identifier} is held (HOLD override active)` };
     }
+    // --- Gate check (Phase 4) ---
+    // When the governor has evaluated gates for the current phase and any are
+    // unsatisfied, block the transition. The governor populates gateEvaluation
+    // via the gate evaluator before calling decideAction().
+    if (ctx.gateEvaluation && !ctx.gateEvaluation.allSatisfied) {
+        const activeNames = ctx.gateEvaluation.activeGates.map(g => g.gateName).join(', ');
+        return {
+            action: 'none',
+            reason: `Issue ${issue.identifier} has unsatisfied gates: ${activeNames}`,
+        };
+    }
     // --- Circuit breaker ---
     // Prevent issues from cycling through agents indefinitely.
     // If an issue has had too many sessions without reaching a terminal status,

package/dist/src/governor/decision-engine.test.js

@@ -627,3 +627,36 @@ describe('decideAction — escalation strategy effects', () => {
         expect(decideAction(ctx).action).toBe('trigger-acceptance');
     });
 });
+// ---------------------------------------------------------------------------
+// Gate check
+// ---------------------------------------------------------------------------
+describe('decideAction — gate check', () => {
+    it('returns none when gates are unsatisfied', () => {
+        const ctx = makeContext({
+            gateEvaluation: {
+                allSatisfied: false,
+                activeGates: [{ issueId: 'issue-1', gateName: 'human-review', gateType: 'signal', status: 'active', activatedAt: Date.now() }],
+                newlySatisfied: [],
+                timeoutResolutions: [],
+                reason: 'Unsatisfied gates: human-review',
+            },
+        });
+        const result = decideAction(ctx);
+        expect(result.action).toBe('none');
+        expect(result.reason).toContain('unsatisfied gates');
+    });
+    it('proceeds when all gates are satisfied', () => {
+        const ctx = makeContext({
+            issue: makeIssue({ status: 'Backlog' }),
+            gateEvaluation: {
+                allSatisfied: true,
+                activeGates: [],
+                newlySatisfied: [],
+                timeoutResolutions: [],
+                reason: 'All gates satisfied',
+            },
+        });
+        const result = decideAction(ctx);
+        expect(result.action).toBe('trigger-development');
+    });
+});

package/dist/src/governor/governor-types.d.ts

@@ -20,7 +20,7 @@ import type { TopOfFunnelConfig } from './top-of-funnel.js';
  * - escalate-human: Create a human escalation touchpoint
  * - none: No action needed
  */
-export type GovernorAction = 'trigger-research' | 'trigger-backlog-creation' | 'trigger-development' | 'trigger-qa' | 'trigger-acceptance' | 'trigger-refinement' | 'decompose' | 'escalate-human' | 'none';
+export type GovernorAction = 'trigger-research' | 'trigger-backlog-creation' | 'trigger-development' | 'trigger-qa' | 'trigger-acceptance' | 'trigger-refinement' | 'trigger-parallel-group' | 'decompose' | 'escalate-human' | 'none';
 /**
  * Configuration for the Workflow Governor scan loop.
  */

package/dist/src/governor/governor-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governor-types.d.ts","sourceRoot":"","sources":["../../../src/governor/governor-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAM3D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,qBAAqB,GACrB,YAAY,GACZ,oBAAoB,GACpB,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,MAAM,CAAA;AAMV;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAA;IACtB,0DAA0D;IAC1D,uBAAuB,EAAE,MAAM,CAAA;IAC/B,uDAAuD;IACvD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,+DAA+D;IAC/D,yBAAyB,EAAE,OAAO,CAAA;IAClC,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAA;IACrB,4DAA4D;IAC5D,oBAAoB,EAAE,OAAO,CAAA;IAC7B,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAUrC,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}
+{"version":3,"file":"governor-types.d.ts","sourceRoot":"","sources":["../../../src/governor/governor-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAM3D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,qBAAqB,GACrB,YAAY,GACZ,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,WAAW,GACX,gBAAgB,GAChB,MAAM,CAAA;AAMV;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAA;IACtB,0DAA0D;IAC1D,uBAAuB,EAAE,MAAM,CAAA;IAC/B,uDAAuD;IACvD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,+DAA+D;IAC/D,yBAAyB,EAAE,OAAO,CAAA;IAClC,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAA;IACrB,4DAA4D;IAC5D,oBAAoB,EAAE,OAAO,CAAA;IAC7B,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAUrC,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/src/governor/governor.d.ts

@@ -11,6 +11,7 @@
 import type { GovernorAction, GovernorConfig, GovernorIssue, ScanResult } from './governor-types.js';
 import type { OverridePriority } from './override-parser.js';
 import { type WorkflowRegistryConfig } from '../workflow/workflow-registry.js';
+import { ParallelismExecutor } from '../workflow/parallelism-executor.js';
 /**
  * Abstract dependencies that the Governor needs to interact with
  * external systems. Callers inject these at construction time.
@@ -41,6 +42,8 @@ export interface GovernorDependencies {
     getCompletedSessionCount: (issueId: string) => Promise<number>;
     /** Dispatch work for an issue with a specific action */
     dispatchWork: (issue: GovernorIssue, action: GovernorAction) => Promise<void>;
+    /** Get sub-issues for a parent issue (for parallel dispatch) */
+    getSubIssues?: (parentId: string) => Promise<GovernorIssue[]>;
 }
 /**
  * The Workflow Governor scans projects on a configurable interval,
@@ -55,12 +58,13 @@ export declare class WorkflowGovernor {
     private readonly deps;
     private readonly callbacks;
     private readonly workflowRegistry;
+    private readonly parallelismExecutor;
     private intervalHandle;
     private running;
     private scanning;
     constructor(config: Partial<GovernorConfig> & {
         workflow?: WorkflowRegistryConfig;
-    }, deps: GovernorDependencies, callbacks?: WorkflowGovernorCallbacks);
+    }, deps: GovernorDependencies, callbacks?: WorkflowGovernorCallbacks, parallelismExecutor?: ParallelismExecutor);
     /**
      * Start the scan loop. Runs `scanOnce()` immediately, then repeats
      * on the configured interval.
@@ -100,5 +104,17 @@ export declare class WorkflowGovernor {
      * Gather context for a single issue and run it through the decision engine.
      */
     private evaluateIssue;
+    /**
+     * Handle dispatching work for a parallel group.
+     *
+     * Fetches sub-issues for the parent, finds the applicable parallelism group,
+     * and executes the group using the ParallelismExecutor.
+     */
+    private handleParallelGroupDispatch;
+    /**
+     * Handle post-parallel-group completion: if all tasks succeeded,
+     * evaluate transitions to advance the parent issue to the next phase.
+     */
+    private handleParallelGroupCompletion;
 }
 //# sourceMappingURL=governor.d.ts.map

package/dist/src/governor/governor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../../src/governor/governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACX,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAsChG;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IACzD,oDAAoD;IACpD,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,qDAAqD;IACrD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,mDAAmD;IACnD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7C,mEAAmE;IACnE,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC1E,wDAAwD;IACxD,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACrE,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,0EAA0E;IAC1E,0BAA0B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,wEAAwE;IACxE,wBAAwB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,wDAAwD;IACxD,YAAY,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9E;AAMD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;gBAGtB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,sBAAsB,CAAA;KAAE,EACvE,IAAI,EAAE,oBAAoB,EAC1B,SAAS,CAAC,EAAE,yBAAyB;IAavC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAuBb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAgBZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAQpB;;;;;;;;;;OAUG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IA4BvC;;;;;;;OAOG;YACW,WAAW;IA2GzB;;OAEG;YACW,aAAa;CAsC5B"}
+{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../../src/governor/governor.ts"],"names":[],"mappings":"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"}

package/dist/src/governor/governor.js

@@ -11,6 +11,9 @@
 import { DEFAULT_GOVERNOR_CONFIG } from './governor-types.js';
 import { decideAction } from './decision-engine.js';
 import { WorkflowRegistry } from '../workflow/workflow-registry.js';
+import { ParallelismExecutor } from '../workflow/parallelism-executor.js';
+import { FanOutStrategy, FanInStrategy, RaceStrategy } from '../workflow/strategies/index.js';
+import { evaluateTransitions } from '../workflow/transition-engine.js';
 // ---------------------------------------------------------------------------
 // Logging
 // ---------------------------------------------------------------------------
@@ -41,15 +44,26 @@ export class WorkflowGovernor {
     deps;
     callbacks;
     workflowRegistry;
+    parallelismExecutor;
     intervalHandle = null;
     running = false;
     scanning = false;
-    constructor(config, deps, callbacks) {
+    constructor(config, deps, callbacks, parallelismExecutor) {
         const { workflow: workflowConfig, ...governorConfig } = config;
         this.config = { ...DEFAULT_GOVERNOR_CONFIG, ...governorConfig };
         this.deps = deps;
         this.callbacks = callbacks ?? {};
         this.workflowRegistry = WorkflowRegistry.create(workflowConfig);
+        // Use the provided executor or create a default one with all strategies registered
+        if (parallelismExecutor) {
+            this.parallelismExecutor = parallelismExecutor;
+        }
+        else {
+            this.parallelismExecutor = new ParallelismExecutor();
+            this.parallelismExecutor.registerStrategy('fan-out', new FanOutStrategy());
+            this.parallelismExecutor.registerStrategy('fan-in', new FanInStrategy());
+            this.parallelismExecutor.registerStrategy('race', new RaceStrategy());
+        }
     }
     // -------------------------------------------------------------------------
     // Lifecycle
@@ -207,6 +221,18 @@ export class WorkflowGovernor {
                 break;
             }
             try {
+                // Handle parallel group dispatch separately
+                if (item.action === 'trigger-parallel-group') {
+                    await this.handleParallelGroupDispatch(item.issue);
+                    result.actionsDispatched++;
+                    log.info('Dispatched parallel group action', {
+                        issueIdentifier: item.issue.identifier,
+                        action: item.action,
+                        reason: item.reason,
+                        priority: item.priority ?? 'none',
+                    });
+                    continue;
+                }
                 await this.deps.dispatchWork(item.issue, item.action);
                 result.actionsDispatched++;
                 log.info('Dispatched action', {
@@ -264,4 +290,89 @@ export class WorkflowGovernor {
         };
         return decideAction(ctx);
     }
+    /**
+     * Handle dispatching work for a parallel group.
+     *
+     * Fetches sub-issues for the parent, finds the applicable parallelism group,
+     * and executes the group using the ParallelismExecutor.
+     */
+    async handleParallelGroupDispatch(issue) {
+        if (!this.deps.getSubIssues) {
+            log.warn('getSubIssues dependency not provided, falling back to normal dispatch');
+            return;
+        }
+        const workflow = this.workflowRegistry.getWorkflow();
+        if (!workflow?.parallelism)
+            return;
+        const subIssues = await this.deps.getSubIssues(issue.id);
+        // Find the applicable parallelism group.
+        // Use the first group whose phases include a phase that can be
+        // resolved from the current workflow transitions.
+        const group = workflow.parallelism.find(g => g.phases.length > 0);
+        if (!group)
+            return;
+        const tasks = subIssues.map(sub => ({
+            id: sub.id,
+            issueId: sub.identifier,
+            phaseName: group.phases[0],
+        }));
+        const result = await this.parallelismExecutor.execute(group, tasks, async (task) => {
+            await this.deps.dispatchWork(subIssues.find(s => s.id === task.id), `trigger-${task.phaseName}`);
+            return {
+                id: task.id,
+                issueId: task.issueId,
+                success: true,
+            };
+        });
+        log.info('Parallel group dispatched', {
+            group: group.name,
+            strategy: group.strategy,
+            completed: result.completed.length,
+            failed: result.failed.length,
+            cancelled: result.cancelled.length,
+        });
+        // Propagate result to advance parent issue if group completed successfully
+        await this.handleParallelGroupCompletion(issue, result, group);
+    }
+    /**
+     * Handle post-parallel-group completion: if all tasks succeeded,
+     * evaluate transitions to advance the parent issue to the next phase.
+     */
+    async handleParallelGroupCompletion(parentIssue, result, group) {
+        // Only advance if the group completed with no failures
+        const allSucceeded = result.failed.length === 0 && result.completed.length > 0
+            && result.completed.every(t => t.success);
+        if (!allSucceeded) {
+            log.info('Parallel group has failures, not advancing parent', {
+                group: group.name,
+                failedCount: result.failed.length,
+            });
+            return;
+        }
+        // Evaluate the next transition for the parent issue.
+        // After a parallel development group completes, the parent
+        // should transition based on its next status mapping.
+        const nextPhaseResult = evaluateTransitions({
+            issue: { ...parentIssue, status: 'Finished' },
+            registry: this.workflowRegistry,
+            isParentIssue: true,
+        });
+        if (nextPhaseResult.action !== 'none') {
+            log.info('Advancing parent after parallel group completion', {
+                issueIdentifier: parentIssue.identifier,
+                nextAction: nextPhaseResult.action,
+                reason: nextPhaseResult.reason,
+            });
+            try {
+                await this.deps.dispatchWork(parentIssue, nextPhaseResult.action);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                log.error('Failed to advance parent after parallel group', {
+                    issueIdentifier: parentIssue.identifier,
+                    error: errorMsg,
+                });
+            }
+        }
+    }
 }