@renseiai/agentfactory 0.8.8 → 0.8.9

package/dist/src/governor/governor.test.js

@@ -512,3 +512,158 @@ describe('WorkflowGovernor.scanOnce — PRIORITY override sorting', () => {
         expect(dispatchWork.mock.calls[2][0]).toEqual(expect.objectContaining({ id: 'c' }));
     });
 });
+// ---------------------------------------------------------------------------
+// Parallel group dispatch
+// ---------------------------------------------------------------------------
+describe('WorkflowGovernor.scanOnce — parallel group dispatch', () => {
+    function makeWorkflowWithParallelism() {
+        return {
+            apiVersion: 'v1.1',
+            kind: 'WorkflowDefinition',
+            metadata: { name: 'test-parallel' },
+            phases: [
+                { name: 'development', template: 'development' },
+                { name: 'qa', template: 'qa' },
+            ],
+            transitions: [
+                { from: 'Backlog', to: 'development' },
+                { from: 'Finished', to: 'qa' },
+            ],
+            parallelism: [
+                {
+                    name: 'dev-parallel',
+                    phases: ['development'],
+                    strategy: 'fan-out',
+                },
+            ],
+        };
+    }
+    it('handles trigger-parallel-group by dispatching sub-issues', async () => {
+        const parentIssue = makeIssue({
+            id: 'parent-1',
+            identifier: 'SUP-100',
+            status: 'Backlog',
+        });
+        const subIssues = [
+            makeIssue({ id: 'sub-1', identifier: 'SUP-101', status: 'Backlog', parentId: 'parent-1' }),
+            makeIssue({ id: 'sub-2', identifier: 'SUP-102', status: 'Backlog', parentId: 'parent-1' }),
+        ];
+        const dispatchWork = vi.fn().mockResolvedValue(undefined);
+        const getSubIssues = vi.fn().mockResolvedValue(subIssues);
+        const deps = makeMockDeps({
+            listIssues: vi.fn().mockResolvedValue([parentIssue]),
+            isParentIssue: vi.fn().mockResolvedValue(true),
+            dispatchWork,
+            getSubIssues,
+        });
+        const governor = new WorkflowGovernor(makeConfig({
+            workflow: { workflow: makeWorkflowWithParallelism(), useBuiltinDefault: false },
+        }), deps);
+        const results = await governor.scanOnce();
+        expect(results[0].actionsDispatched).toBe(1);
+        expect(getSubIssues).toHaveBeenCalledWith('parent-1');
+        // dispatchWork is called for each sub-issue via the ParallelismExecutor,
+        // plus once more to advance the parent to the next phase (trigger-qa)
+        expect(dispatchWork).toHaveBeenCalledTimes(3);
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'sub-1' }), 'trigger-development');
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'sub-2' }), 'trigger-development');
+        // Parent advanced to QA after parallel group completion
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'parent-1' }), 'trigger-qa');
+    });
+    it('handles missing getSubIssues gracefully', async () => {
+        const parentIssue = makeIssue({
+            id: 'parent-1',
+            identifier: 'SUP-100',
+            status: 'Backlog',
+        });
+        const dispatchWork = vi.fn().mockResolvedValue(undefined);
+        const deps = makeMockDeps({
+            listIssues: vi.fn().mockResolvedValue([parentIssue]),
+            isParentIssue: vi.fn().mockResolvedValue(true),
+            dispatchWork,
+            // getSubIssues intentionally not provided
+        });
+        const governor = new WorkflowGovernor(makeConfig({
+            workflow: { workflow: makeWorkflowWithParallelism(), useBuiltinDefault: false },
+        }), deps);
+        const results = await governor.scanOnce();
+        // The action is counted as dispatched (the parallel group handler ran),
+        // but dispatchWork is NOT called for sub-issues since getSubIssues is missing
+        expect(results[0].actionsDispatched).toBe(1);
+        expect(dispatchWork).not.toHaveBeenCalled();
+    });
+    it('fan-in group completing advances parent to next phase', async () => {
+        const fanInWorkflow = {
+            apiVersion: 'v1.1',
+            kind: 'WorkflowDefinition',
+            metadata: { name: 'test-fan-in' },
+            phases: [
+                { name: 'development', template: 'development' },
+                { name: 'qa', template: 'qa' },
+            ],
+            transitions: [
+                { from: 'Backlog', to: 'development' },
+                { from: 'Finished', to: 'qa' },
+            ],
+            parallelism: [
+                {
+                    name: 'dev-fan-in',
+                    phases: ['development'],
+                    strategy: 'fan-in',
+                    waitForAll: true,
+                },
+            ],
+        };
+        const parentIssue = makeIssue({
+            id: 'parent-1',
+            identifier: 'SUP-200',
+            status: 'Backlog',
+        });
+        const subIssues = [
+            makeIssue({ id: 'sub-1', identifier: 'SUP-201', status: 'Backlog', parentId: 'parent-1' }),
+            makeIssue({ id: 'sub-2', identifier: 'SUP-202', status: 'Backlog', parentId: 'parent-1' }),
+            makeIssue({ id: 'sub-3', identifier: 'SUP-203', status: 'Backlog', parentId: 'parent-1' }),
+        ];
+        const dispatchWork = vi.fn().mockResolvedValue(undefined);
+        const getSubIssues = vi.fn().mockResolvedValue(subIssues);
+        const deps = makeMockDeps({
+            listIssues: vi.fn().mockResolvedValue([parentIssue]),
+            isParentIssue: vi.fn().mockResolvedValue(true),
+            dispatchWork,
+            getSubIssues,
+        });
+        const governor = new WorkflowGovernor(makeConfig({
+            workflow: { workflow: fanInWorkflow, useBuiltinDefault: false },
+        }), deps);
+        const results = await governor.scanOnce();
+        expect(results[0].actionsDispatched).toBe(1);
+        // All 3 sub-issues dispatched + 1 parent advancement to QA
+        expect(dispatchWork).toHaveBeenCalledTimes(4);
+        // Sub-issues dispatched for development
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'sub-1' }), 'trigger-development');
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'sub-2' }), 'trigger-development');
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'sub-3' }), 'trigger-development');
+        // Parent advanced to QA after all fan-in tasks completed
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'parent-1' }), 'trigger-qa');
+    });
+    it('non-parent issues with parallelism groups dispatch normally', async () => {
+        const issue = makeIssue({
+            id: 'issue-1',
+            identifier: 'SUP-100',
+            status: 'Backlog',
+        });
+        const dispatchWork = vi.fn().mockResolvedValue(undefined);
+        const deps = makeMockDeps({
+            listIssues: vi.fn().mockResolvedValue([issue]),
+            isParentIssue: vi.fn().mockResolvedValue(false),
+            dispatchWork,
+        });
+        const governor = new WorkflowGovernor(makeConfig({
+            workflow: { workflow: makeWorkflowWithParallelism(), useBuiltinDefault: false },
+        }), deps);
+        const results = await governor.scanOnce();
+        expect(results[0].actionsDispatched).toBe(1);
+        // Normal dispatch, not parallel
+        expect(dispatchWork).toHaveBeenCalledWith(expect.objectContaining({ id: 'issue-1' }), 'trigger-development');
+    });
+});

package/dist/src/index.d.ts

@@ -9,4 +9,5 @@ export * from './config/index.js';
 export * from './manifest/index.js';
 export * from './tools/index.js';
 export * from './workflow/index.js';
+export * from './routing/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA"}

package/dist/src/index.js

@@ -9,3 +9,4 @@ export * from './config/index.js';
 export * from './manifest/index.js';
 export * from './tools/index.js';
 export * from './workflow/index.js';
+export * from './routing/index.js';

package/dist/src/orchestrator/issue-tracker-client.d.ts

@@ -20,6 +20,8 @@ export interface IssueTrackerIssue {
     labels: string[];
     teamName?: string;
     projectName?: string;
+    /** Parent issue ID, if this issue is a sub-issue. Used to filter child issues from backlog scans. */
+    parentId?: string;
 }
 /**
  * Configuration for creating an issue tracker session.
@@ -70,6 +72,8 @@ export interface IssueTrackerClient {
     getIssue(idOrIdentifier: string): Promise<IssueTrackerIssue>;
     /** Check whether an issue has sub-issues (is a parent) */
     isParentIssue(issueId: string): Promise<boolean>;
+    /** Check whether an issue is a sub-issue (has a parent) */
+    isChildIssue(issueId: string): Promise<boolean>;
     /** Create a comment on an issue */
     createComment(issueId: string, body: string): Promise<{
         id: string;

package/dist/src/orchestrator/issue-tracker-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-tracker-client.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/issue-tracker-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"issue-tracker-client.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/issue-tracker-client.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAA;AAa5E,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAElB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,YAAY,CAAA;AAmBnB;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CA6B1E;AA2vBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,aAAa,GACtB,MAAM,CAGR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,aAAa,CAerI;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAOtB;IACD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IACjF,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8C;IAC5E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+D;IAEhG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAEhE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0C;IAE3E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAE9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0C;IAE3E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IAEzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IAEzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAE1D,OAAO,CAAC,eAAe,CAAC,CAAU;IAElC,OAAO,CAAC,UAAU,CAAC,CAAkB;IAErC,OAAO,CAAC,YAAY,CAAC,CAAwB;IAE7C,OAAO,CAAC,WAAW,CAAC,CAAU;IAE9B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAE1B,OAAO,CAAC,cAAc,CAAC,CAAQ;IAE/B,OAAO,CAAC,YAAY,CAAC,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAQ;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAE3C,OAAO,CAAC,iBAAiB,CAAC,CAAqD;IAE/E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;gBAEpB,MAAM,GAAE,kBAAuB,EAAE,MAAM,GAAE,kBAAuB;IAoJ5E;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;;;;;OAOG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjF;;OAEG;IACG,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsEpE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA0BtB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,6BAA6B;IAkIrC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;OAMG;IACH,cAAc,CACZ,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,aAAa,GACtB;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE;IAkKvD;;;;OAIG;IACH,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IA6BhD;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA4DhE;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgE3B;;OAEG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAItE;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY;IAiSpD;;OAEG;YACW,kBAAkB;IAybhC;;OAEG;YACW,gBAAgB;IAwS9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;YACW,wBAAwB;IAiDtC;;;OAGG;YACW,qBAAqB;IA+DnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA+DxC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACtB,mBAAmB,EAAE,MAAM,EAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC;IAyJxB;;;OAGG;IACH,oBAAoB,IAAI,OAAO,yBAAyB,EAAE,iBAAiB,GAAG,SAAS;IAIvF;;OAEG;IACH,eAAe,IAAI,YAAY,EAAE;IAMjC;;;;;OAKG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,eAAe,UAAQ,EACvB,UAAU,GAAE,cAAc,GAAG,SAA0B,GACtD,OAAO,CAAC,eAAe,CAAC;IA4D3B;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAS9F;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAM9D;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAgBzC;;;;;;;;OAQG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,MAAM,EAC1B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAmI/B;;;;;;;;;;OAUG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC;IAqD/B;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,YAAY,CAAC;IAyPvF;;OAEG;IACH,OAAO,IAAI,IAAI;IAkBf;;;;;;;;;OASG;IACG,UAAU,CAAC,2BAA2B,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA8DhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,iBAAiB,CAEnB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/orchestrator/orchestrator.js

@@ -1062,6 +1062,11 @@ export class AgentOrchestrator {
         for (const issue of allIssues) {
             if (results.length >= maxIssues)
                 break;
+            // Skip sub-issues — coordinators manage their lifecycle, not the backlog scanner
+            if (issue.parentId) {
+                console.log(`[orchestrator] Skipping sub-issue ${issue.identifier} — managed by parent coordinator`);
+                continue;
+            }
             // Filter by allowedProjects from .agentfactory/config.yaml
             if (this.allowedProjects && this.allowedProjects.length > 0) {
                 if (!issue.projectName || !this.allowedProjects.includes(issue.projectName)) {
@@ -2968,6 +2973,25 @@ ORCHESTRATOR_INSTALL=1 exec pnpm add "$@"
             throw new Error(`Issue ${identifier} is in terminal status '${currentStatus}' — skipping ${workType ?? 'auto'} work. ` +
                 `The issue was likely accepted/canceled after being queued.`);
         }
+        // Guard: skip sub-issues that should be managed by a coordinator, not spawned independently.
+        // Only applies when no explicit work type is provided (i.e., orchestrator auto-pickup).
+        // Coordinators spawning sub-agents always pass an explicit work type, so they bypass this check.
+        if (!workType) {
+            try {
+                const isChild = await this.client.isChildIssue(issueId);
+                if (isChild) {
+                    throw new Error(`Issue ${identifier} is a sub-issue managed by a parent coordinator — skipping independent pickup. ` +
+                        `Sub-issues should only be processed by their parent's coordination agent.`);
+                }
+            }
+            catch (err) {
+                // Re-throw our own guard error; swallow API errors so we don't block on transient failures
+                if (err instanceof Error && err.message.includes('managed by a parent coordinator')) {
+                    throw err;
+                }
+                console.warn(`Failed to check child status for ${identifier}:`, err);
+            }
+        }
         // Defense in depth: re-validate git remote before spawning (guards against long-running instances)
         if (this.config.repository) {
             validateGitRemote(this.config.repository, this.gitRoot);

package/dist/src/orchestrator/parse-work-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-work-result.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/parse-work-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAuGjD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,GACtB,eAAe,CAyCjB"}
+{"version":3,"file":"parse-work-result.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/parse-work-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA6GjD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,GACtB,eAAe,CAyCjB"}

package/dist/src/orchestrator/parse-work-result.js

@@ -91,6 +91,12 @@ const COORDINATION_FAIL_PATTERNS = [
     // Explicit result labels
     /\bCoordination\s+(?:Result|Status|Verdict):\s*\*{0,2}Fail(?:ed)?\*{0,2}/i,
     /\bCoordination\s+Failed/i,
+    // Early-exit detection — agent reported progress instead of completing coordination
+    /\bI'll wait\b.*\bcomplete\b/i,
+    /\bagents?\s+(?:are|is)\s+(?:actively\s+)?(?:working|running|in\s+progress)\b/i,
+    /\bwork\s+is\s+in\s+progress\b/i,
+    /\bwait(?:ing)?\s+for\s+(?:them|sub-?\s*agents?|sub-?\s*issues?)\s+to\s+(?:complete|finish)\b/i,
+    /\bbefore\s+proceeding\s+to\s+(?:Layer|Wave|Phase)\s+\d/i,
 ];
 /**
  * Parse the agent's result message to determine whether the work passed or failed.

package/dist/src/orchestrator/parse-work-result.test.js

@@ -192,6 +192,25 @@ describe('parseWorkResult', () => {
         it('checks fail patterns before pass patterns', () => {
             expect(parseWorkResult('All 8/8 sub-issues completed.\n### Must Fix Before Merge\n1. Bad code', 'coordination')).toBe('failed');
         });
+        // Early-exit detection — agent reported progress instead of completing
+        it('detects "I\'ll wait for them to complete" as early-exit fail', () => {
+            expect(parseWorkResult("Both agents are progressing well. I'll wait for them to complete before proceeding.", 'coordination')).toBe('failed');
+        });
+        it('detects "agents are actively working" as early-exit fail', () => {
+            expect(parseWorkResult('SUP-1552 agent has read the existing patterns. Agents are actively working on their sub-issues.', 'coordination')).toBe('failed');
+        });
+        it('detects "waiting for sub-agents to finish" as early-exit fail', () => {
+            expect(parseWorkResult('Spawned 2 agents. Waiting for sub-agents to finish their work.', 'coordination')).toBe('failed');
+        });
+        it('detects "before proceeding to Layer 2" as early-exit fail', () => {
+            expect(parseWorkResult('Wave 1 agents spawned. Will check results before proceeding to Layer 2.', 'coordination')).toBe('failed');
+        });
+        it('detects "work is in progress" as early-exit fail', () => {
+            expect(parseWorkResult('Work is in progress on 3 sub-issues. Status will be updated.', 'coordination')).toBe('failed');
+        });
+        it('early-exit patterns also apply to inflight-coordination', () => {
+            expect(parseWorkResult("Agents are actively running. I'll wait for them to complete.", 'inflight-coordination')).toBe('failed');
+        });
     });
     // QA coordination with real agent output formats
     describe('QA coordination real-world patterns', () => {

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

@@ -4,7 +4,7 @@
  * Creates provider instances based on name.
  * Supports provider selection via env vars, config, labels, and mentions.
  *
- * Resolution order (highest → lowest):
+ * Sync resolution order (highest → lowest):
  * 1. Issue label override (provider:codex)
  * 2. Mention context override ("use codex", "@codex")
  * 3. Config providers.byWorkType
@@ -14,6 +14,18 @@
  * 7. Config providers.default
  * 8. Env var AGENT_PROVIDER
  * 9. Hardcoded 'claude'
+ *
+ * Async resolution order (with MAB routing):
+ * 1. Issue label override (provider:codex)          — explicit human override
+ * 2. Mention context override ("use codex")         — explicit human override
+ * 3. Config providers.byWorkType                    — static config
+ * 4. Config providers.byProject                     — static config
+ * 5. MAB-based intelligent routing                  — learned routing (feature-flagged)
+ * 6. Env var AGENT_PROVIDER_{WORKTYPE}              — static fallback
+ * 7. Env var AGENT_PROVIDER_{PROJECT}               — static fallback
+ * 8. Config providers.default                       — static fallback
+ * 9. Env var AGENT_PROVIDER                         — static fallback
+ * 10. Hardcoded 'claude'                            — ultimate fallback
  */
 export type { AgentProviderName, AgentProvider, AgentSpawnConfig, AgentHandle, AgentEvent } from './types.js';
 export type { AgentInitEvent, AgentSystemEvent, AgentAssistantTextEvent, AgentToolUseEvent, AgentToolResultEvent, AgentToolProgressEvent, AgentResultEvent, AgentErrorEvent, AgentCostData, } from './types.js';
@@ -23,6 +35,8 @@ export { AmpProvider, createAmpProvider } from './amp-provider.js';
 export { SpringAiProvider, createSpringAiProvider } from './spring-ai-provider.js';
 export { A2aProvider, createA2aProvider } from './a2a-provider.js';
 import type { AgentProvider, AgentProviderName } from './types.js';
+import type { PosteriorStore } from '../routing/posterior-store.js';
+import type { RoutingConfig } from '../routing/types.js';
 /** Provider configuration from .agentfactory/config.yaml */
 export interface ProvidersConfig {
     /** Default provider for all agents */
@@ -50,6 +64,20 @@ export interface ProviderResolutionResult {
     name: AgentProviderName;
     source: string;
 }
+/** Context for MAB-based routing in async provider resolution */
+export interface RoutingContext {
+    /** Posterior store instance (from server) for reading MAB posteriors */
+    posteriorStore?: PosteriorStore;
+    /** Routing configuration (from repo config) */
+    routingConfig?: RoutingConfig;
+    /** Providers to consider for MAB selection (defaults to all valid providers) */
+    availableProviders?: AgentProviderName[];
+}
+/** Extended resolution context for async provider resolution with MAB routing */
+export interface AsyncProviderResolutionContext extends ProviderResolutionContext {
+    /** Optional routing context for MAB-based intelligent routing */
+    routingContext?: RoutingContext;
+}
 export declare const PROVIDER_ALIASES: Record<string, AgentProviderName>;
 /**
  * Create a provider instance by name.
@@ -96,5 +124,40 @@ export declare function resolveProviderWithSource(context?: ProviderResolutionCo
  * @returns The resolved provider name
  */
 export declare function resolveProviderName(options?: ProviderResolutionContext): AgentProviderName;
+/**
+ * Async version of resolveProviderWithSource() that includes MAB-based
+ * intelligent routing as tier 5 in the cascade.
+ *
+ * Resolution order (highest → lowest):
+ * 1. Issue label override (provider:codex)          — explicit human override
+ * 2. Mention context override ("use codex")         — explicit human override
+ * 3. Config providers.byWorkType                    — static config
+ * 4. Config providers.byProject                     — static config
+ * 5. MAB-based intelligent routing                  — learned routing (feature-flagged)
+ * 6. Env var AGENT_PROVIDER_{WORKTYPE}              — static fallback
+ * 7. Env var AGENT_PROVIDER_{PROJECT}               — static fallback
+ * 8. Config providers.default                       — static fallback
+ * 9. Env var AGENT_PROVIDER                         — static fallback
+ * 10. Hardcoded 'claude'                            — ultimate fallback
+ *
+ * MAB routing (tier 5) only activates when:
+ * - routingContext.posteriorStore is provided
+ * - routingContext.routingConfig?.enabled is true
+ * - context.workType is defined
+ *
+ * If selectProvider() throws or returns low confidence, falls through silently.
+ *
+ * @param context - Full resolution context including optional routing context
+ * @returns The resolved provider name and its source
+ */
+export declare function resolveProviderWithSourceAsync(context?: AsyncProviderResolutionContext): Promise<ProviderResolutionResult>;
+/**
+ * Async version of resolveProviderName() that includes MAB-based
+ * intelligent routing.
+ *
+ * @param options - Resolution context including optional routing context
+ * @returns The resolved provider name
+ */
+export declare function resolveProviderNameAsync(options?: AsyncProviderResolutionContext): Promise<AgentProviderName>;
 export declare function isValidProviderName(name: string): name is AgentProviderName;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC7G,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAWlE,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC9C,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC9C;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAMD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAK9D,CAAA;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAkBrE;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA6BjF;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,wBAAwB,CAgEvG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,iBAAiB,CAE1F;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,iBAAiB,CAE3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"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"}

package/dist/src/providers/index.js

@@ -4,7 +4,7 @@
  * Creates provider instances based on name.
  * Supports provider selection via env vars, config, labels, and mentions.
  *
- * Resolution order (highest → lowest):
+ * Sync resolution order (highest → lowest):
  * 1. Issue label override (provider:codex)
  * 2. Mention context override ("use codex", "@codex")
  * 3. Config providers.byWorkType
@@ -14,6 +14,18 @@
  * 7. Config providers.default
  * 8. Env var AGENT_PROVIDER
  * 9. Hardcoded 'claude'
+ *
+ * Async resolution order (with MAB routing):
+ * 1. Issue label override (provider:codex)          — explicit human override
+ * 2. Mention context override ("use codex")         — explicit human override
+ * 3. Config providers.byWorkType                    — static config
+ * 4. Config providers.byProject                     — static config
+ * 5. MAB-based intelligent routing                  — learned routing (feature-flagged)
+ * 6. Env var AGENT_PROVIDER_{WORKTYPE}              — static fallback
+ * 7. Env var AGENT_PROVIDER_{PROJECT}               — static fallback
+ * 8. Config providers.default                       — static fallback
+ * 9. Env var AGENT_PROVIDER                         — static fallback
+ * 10. Hardcoded 'claude'                            — ultimate fallback
  */
 export { ClaudeProvider, createClaudeProvider } from './claude-provider.js';
 export { CodexProvider, createCodexProvider } from './codex-provider.js';
@@ -25,6 +37,7 @@ import { CodexProvider } from './codex-provider.js';
 import { AmpProvider } from './amp-provider.js';
 import { SpringAiProvider } from './spring-ai-provider.js';
 import { A2aProvider } from './a2a-provider.js';
+import { logger } from '../logger.js';
 // ---------------------------------------------------------------------------
 // Aliases — friendly names that map to real provider names
 // ---------------------------------------------------------------------------
@@ -200,6 +213,124 @@ export function resolveProviderName(options) {
     return resolveProviderWithSource(options).name;
 }
 // ---------------------------------------------------------------------------
+// Async provider resolution (with MAB routing)
+// ---------------------------------------------------------------------------
+/**
+ * Async version of resolveProviderWithSource() that includes MAB-based
+ * intelligent routing as tier 5 in the cascade.
+ *
+ * Resolution order (highest → lowest):
+ * 1. Issue label override (provider:codex)          — explicit human override
+ * 2. Mention context override ("use codex")         — explicit human override
+ * 3. Config providers.byWorkType                    — static config
+ * 4. Config providers.byProject                     — static config
+ * 5. MAB-based intelligent routing                  — learned routing (feature-flagged)
+ * 6. Env var AGENT_PROVIDER_{WORKTYPE}              — static fallback
+ * 7. Env var AGENT_PROVIDER_{PROJECT}               — static fallback
+ * 8. Config providers.default                       — static fallback
+ * 9. Env var AGENT_PROVIDER                         — static fallback
+ * 10. Hardcoded 'claude'                            — ultimate fallback
+ *
+ * MAB routing (tier 5) only activates when:
+ * - routingContext.posteriorStore is provided
+ * - routingContext.routingConfig?.enabled is true
+ * - context.workType is defined
+ *
+ * If selectProvider() throws or returns low confidence, falls through silently.
+ *
+ * @param context - Full resolution context including optional routing context
+ * @returns The resolved provider name and its source
+ */
+export async function resolveProviderWithSourceAsync(context) {
+    // 1. Issue label override
+    if (context?.labels?.length) {
+        const fromLabel = extractProviderFromLabels(context.labels);
+        if (fromLabel) {
+            return { name: fromLabel, source: `label provider:${fromLabel}` };
+        }
+    }
+    // 2. Mention context override
+    if (context?.mentionContext) {
+        const fromMention = extractProviderFromMention(context.mentionContext);
+        if (fromMention) {
+            return { name: fromMention, source: `mention "${context.mentionContext.substring(0, 30)}"` };
+        }
+    }
+    // 3. Config byWorkType
+    if (context?.workType && context?.configProviders?.byWorkType) {
+        const configWorkType = context.configProviders.byWorkType[context.workType];
+        if (configWorkType && isValidProviderName(configWorkType)) {
+            return { name: configWorkType, source: `config providers.byWorkType.${context.workType}` };
+        }
+    }
+    // 4. Config byProject
+    if (context?.project && context?.configProviders?.byProject) {
+        const configProject = context.configProviders.byProject[context.project];
+        if (configProject && isValidProviderName(configProject)) {
+            return { name: configProject, source: `config providers.byProject.${context.project}` };
+        }
+    }
+    // 5. MAB-based intelligent routing (feature-flagged)
+    if (context?.routingContext?.posteriorStore &&
+        context?.routingContext?.routingConfig?.enabled &&
+        context?.workType) {
+        try {
+            const { selectProvider } = await import('../routing/routing-engine.js');
+            const availableProviders = context.routingContext.availableProviders ?? VALID_PROVIDER_NAMES;
+            const decision = await selectProvider(context.routingContext.posteriorStore, context.workType, availableProviders, context.routingContext.routingConfig);
+            // Only use MAB decision if confidence exceeds a meaningful threshold
+            // and it's not purely exploratory due to uncertainty
+            if (decision.confidence > 0 && decision.explorationReason !== 'uncertainty') {
+                return { name: decision.selectedProvider, source: 'mab-routing' };
+            }
+            // Low confidence or uncertainty-driven exploration — fall through to static fallbacks
+        }
+        catch (err) {
+            logger.warn('MAB routing failed, falling through to static fallbacks', {
+                error: err instanceof Error ? err.message : String(err),
+                workType: context.workType,
+            });
+        }
+    }
+    // 6. Env var AGENT_PROVIDER_{WORKTYPE}
+    if (context?.workType) {
+        const workTypeKey = `AGENT_PROVIDER_${context.workType.toUpperCase().replace(/-/g, '_')}`;
+        const workTypeProvider = process.env[workTypeKey];
+        if (workTypeProvider && isValidProviderName(workTypeProvider)) {
+            return { name: workTypeProvider, source: `env ${workTypeKey}` };
+        }
+    }
+    // 7. Env var AGENT_PROVIDER_{PROJECT}
+    if (context?.project) {
+        const projectKey = `AGENT_PROVIDER_${context.project.toUpperCase()}`;
+        const projectProvider = process.env[projectKey];
+        if (projectProvider && isValidProviderName(projectProvider)) {
+            return { name: projectProvider, source: `env ${projectKey}` };
+        }
+    }
+    // 8. Config providers.default
+    if (context?.configProviders?.default && isValidProviderName(context.configProviders.default)) {
+        return { name: context.configProviders.default, source: 'config providers.default' };
+    }
+    // 9. Env var AGENT_PROVIDER
+    const globalProvider = process.env.AGENT_PROVIDER;
+    if (globalProvider && isValidProviderName(globalProvider)) {
+        return { name: globalProvider, source: 'env AGENT_PROVIDER' };
+    }
+    // 10. Hardcoded fallback
+    return { name: 'claude', source: 'default' };
+}
+/**
+ * Async version of resolveProviderName() that includes MAB-based
+ * intelligent routing.
+ *
+ * @param options - Resolution context including optional routing context
+ * @returns The resolved provider name
+ */
+export async function resolveProviderNameAsync(options) {
+    return (await resolveProviderWithSourceAsync(options)).name;
+}
+// ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
 const VALID_PROVIDER_NAMES = ['claude', 'codex', 'amp', 'spring-ai', 'a2a'];