@jterrats/open-orchestra 1.0.3 → 1.0.5

package/dist/workflow-phase-planner.js

@@ -1,19 +1,10 @@
-import { AUTONOMOUS_PHASE_SEQUENCE } from "./autonomous-workflow-constants.js";
+import { AUTONOMOUS_PHASE_SEQUENCE, OPTIONAL_WORKFLOW_PHASES, workflowPhaseById, workflowPhaseForRole, } from "./workflow-phases.js";
 import { detectProjectProfile } from "./project-detection.js";
+import { assessTaskSplit } from "./task-split-assessment.js";
+import { taskSearchText } from "./task-text.js";
 import { getWorkflowConfig } from "./workflow-services.js";
 import { loadWorkspace } from "./workspace.js";
-export const OPTIONAL_RECOMMENDED_PHASES = [
-    {
-        phase: "ux_review",
-        role: "ux_ui_designer",
-        summary: "UX, accessibility, responsive behavior, and user-flow validation",
-    },
-    {
-        phase: "docs_review",
-        role: "technical_writer",
-        summary: "Documentation, public-site copy, changelog, and help-content review",
-    },
-];
+export const OPTIONAL_RECOMMENDED_PHASES = OPTIONAL_WORKFLOW_PHASES;
 export async function recommendWorkflowPhasePlan(taskId, root = process.cwd()) {
     const workspace = await loadWorkspace(root);
     const task = workspace.tasks.find((candidate) => candidate.id === taskId);
@@ -26,6 +17,7 @@ export async function recommendWorkflowPhasePlan(taskId, root = process.cwd()) {
     const configuredSequence = config.workflow?.phaseSequence ?? [];
     const manualOverride = configuredSequence.length > 0;
     const recommendations = recommendedPhases(task, profile.signals.map((s) => s.id));
+    const splitAssessment = assessTaskSplit(task);
     const baseSequence = AUTONOMOUS_PHASE_SEQUENCE;
     const taskPhaseSequence = task.workflow?.phaseSequence ?? [];
     const taskOverride = taskPhaseSequence.length > 0;
@@ -41,7 +33,9 @@ export async function recommendWorkflowPhasePlan(taskId, root = process.cwd()) {
         baseSequence,
         recommendedSequence,
         recommendations,
+        splitAssessment,
         rationale: [
+            ...splitAssessmentRationale(splitAssessment),
             ...((task.workflow?.requiredRoles ?? []).length > 0
                 ? [
                     `Task declares required roles: ${task.workflow.requiredRoles.join(", ")}; matching phases are included when available.`,
@@ -67,18 +61,48 @@ export async function recommendWorkflowPhasePlan(taskId, root = process.cwd()) {
         ],
     };
 }
+function splitAssessmentRationale(assessment) {
+    if (!assessment.shouldSplit) {
+        return [
+            "Task split assessment: no functional or technical oversize signals exceeded advisory thresholds.",
+        ];
+    }
+    const lines = [
+        "Task split assessment: split recommended before implementation.",
+    ];
+    if (assessment.functional.shouldSplit) {
+        lines.push(`PO/BA functional scope review: ${assessment.functional.findings.join(" ")}`);
+    }
+    if (assessment.technical.shouldSplit) {
+        lines.push(`Architect technical complexity review: ${assessment.technical.findings.join(" ")}`);
+    }
+    return lines;
+}
 function recommendedPhases(task, signalIds) {
     const text = taskText(task);
     const signals = new Set(signalIds);
     const recommendations = [];
-    if (signals.has("frontend") &&
-        /\b(ui|ux|frontend|responsive|mobile|accessibility|browser|site|web)\b/i.test(text)) {
+    if (signals.has("frontend") && hasUserFacingUxSignal(task, text)) {
+        recommendations.push({
+            phase: "ux_design",
+            role: "ux_ui_designer",
+            summary: "UX design input, user-flow specification, responsive states, and accessibility criteria before architecture",
+            reason: "Frontend project signal plus task scope indicates UX, accessibility, or browser behavior risk that should inform architecture before implementation design.",
+            insertAfter: "po",
+        });
+        recommendations.push({
+            phase: "po_validation",
+            role: "product_owner",
+            summary: "Product and BA validation of UX artifacts before architecture commits to implementation design",
+            reason: "UX artifacts can change flow, layout, copy, states, or scope; Product/BA should validate them before architecture.",
+            insertAfter: "ux_design",
+        });
         recommendations.push({
             phase: "ux_review",
             role: "ux_ui_designer",
             summary: "UX, accessibility, responsive behavior, and user-flow validation",
-            reason: "Frontend project signal plus task scope indicates UX, accessibility, or browser behavior risk.",
-            insertAfter: "developer",
+            reason: "Frontend project signal plus task scope indicates UX, accessibility, or browser behavior risk that needs post-implementation validation.",
+            insertAfter: "qa",
         });
     }
     if (/\b(docs?|documentation|readme|changelog|runbook|public site|site copy|help content)\b/i.test(text) ||
@@ -116,15 +140,19 @@ function applyRecommendations(baseSequence, recommendations) {
 function applyRequiredRoles(sequence, requiredRoles) {
     if (requiredRoles.length === 0)
         return sequence;
-    const phaseByRole = new Map([...AUTONOMOUS_PHASE_SEQUENCE, ...OPTIONAL_RECOMMENDED_PHASES].map((phase) => [phase.role, phase]));
     let next = [...sequence];
     for (const role of requiredRoles) {
         if (next.some((phase) => phase.role === role))
             continue;
-        const phase = phaseByRole.get(role);
+        const defaultPhase = workflowPhaseForRole(role);
+        const phase = defaultPhase ? workflowPhaseById(defaultPhase) : undefined;
         if (!phase)
             continue;
-        const insertAfter = phase.phase === "docs_review" ? "qa" : "developer";
+        const insertAfter = phase.phase === "docs_review"
+            ? "qa"
+            : phase.phase === "ux_design"
+                ? "po"
+                : "developer";
         next = applyRecommendations(next, [
             {
                 phase: phase.phase,
@@ -137,13 +165,12 @@ function applyRequiredRoles(sequence, requiredRoles) {
     }
     return next;
 }
+function hasUserFacingUxSignal(task, text) {
+    return (/\b(ui|ux|frontend|responsive|mobile|accessibility|browser|site|web|navigation|layout|form|forms|table|tables|dashboard|filter|filters|pagination|copy|tooltip|tooltips|loading|empty|error|success|recovery|visual)\b/i.test(text) ||
+        (task.paths ?? []).some((item) => /(^|\/)(site|web-console)\/src\/|\.jsx$|\.css$/i.test(item)));
+}
 function sequenceFromIds(ids) {
-    const definitions = [
-        ...AUTONOMOUS_PHASE_SEQUENCE,
-        ...OPTIONAL_RECOMMENDED_PHASES,
-    ];
-    const byId = new Map(definitions.map((phase) => [phase.phase, phase]));
-    return ids.map((id) => byId.get(id) ?? {
+    return ids.map((id) => workflowPhaseById(id) ?? {
         phase: id,
         role: "custom",
         summary: "Custom configured workflow phase",
@@ -159,17 +186,9 @@ function dedupeRecommendations(recommendations) {
     });
 }
 function taskText(task) {
-    return [
-        task.title,
-        task.goal,
-        task.scope,
-        task.testStrategy,
-        ...(task.acceptanceCriteria ?? []),
-        ...(task.assumptions ?? []),
-        ...(task.risks ?? []),
-        ...(task.paths ?? []),
-    ]
-        .filter(Boolean)
-        .join(" ");
+    return taskSearchText(task, {
+        includeTestStrategy: true,
+        includeAssumptions: true,
+    });
 }
 //# sourceMappingURL=workflow-phase-planner.js.map

package/dist/workflow-phase-planner.js.map

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

package/dist/workflow-phases.d.ts

@@ -0,0 +1,15 @@
+export interface WorkflowPhaseDefinition {
+    phase: string;
+    role: string;
+    summary: string;
+}
+export declare const AUTONOMOUS_PHASE_SEQUENCE: WorkflowPhaseDefinition[];
+export declare const OPTIONAL_WORKFLOW_PHASES: WorkflowPhaseDefinition[];
+export declare const WORKFLOW_PHASES: WorkflowPhaseDefinition[];
+export type AutonomousPhaseDefinition = (typeof AUTONOMOUS_PHASE_SEQUENCE)[number];
+export declare function workflowPhaseById(phase: string): WorkflowPhaseDefinition | undefined;
+export declare function isWorkflowPhase(phase: string): boolean;
+export declare function workflowPhaseIds(): string[];
+export declare function roleForWorkflowPhase(phase: string): string;
+export declare function workflowPhaseForRole(role: string): string | undefined;
+export declare function workflowPhasesByRole(role: string): WorkflowPhaseDefinition[];

package/dist/workflow-phases.js

@@ -0,0 +1,86 @@
+export const AUTONOMOUS_PHASE_SEQUENCE = [
+    {
+        phase: "pm",
+        role: "product_manager",
+        summary: "Product framing, prioritization, and success metrics",
+    },
+    {
+        phase: "po",
+        role: "product_owner",
+        summary: "Backlog refinement, story sizing, and acceptance criteria",
+    },
+    {
+        phase: "architect",
+        role: "architect",
+        summary: "Technical tasking, design decisions, and size estimation",
+    },
+    {
+        phase: "developer",
+        role: "developer",
+        summary: "Implementation against acceptance criteria",
+    },
+    {
+        phase: "qa",
+        role: "qa",
+        summary: "Verification against acceptance criteria and edge cases",
+    },
+    {
+        phase: "release",
+        role: "release_manager",
+        summary: "Release candidate validation and PR creation",
+    },
+];
+export const OPTIONAL_WORKFLOW_PHASES = [
+    {
+        phase: "ux_design",
+        role: "ux_ui_designer",
+        summary: "UX design input, user-flow specification, responsive states, and accessibility criteria before architecture",
+    },
+    {
+        phase: "po_validation",
+        role: "product_owner",
+        summary: "Product and BA validation of UX artifacts before architecture commits to implementation design",
+    },
+    {
+        phase: "ux_review",
+        role: "ux_ui_designer",
+        summary: "UX, accessibility, responsive behavior, and user-flow validation",
+    },
+    {
+        phase: "docs_review",
+        role: "technical_writer",
+        summary: "Documentation, public-site copy, changelog, and help-content review",
+    },
+    {
+        phase: "architecture_challenge",
+        role: "reviewer_critic",
+        summary: "Architecture challenge for over-engineered, convention-breaking, or under-specified design",
+    },
+];
+export const WORKFLOW_PHASES = [
+    ...AUTONOMOUS_PHASE_SEQUENCE,
+    ...OPTIONAL_WORKFLOW_PHASES,
+];
+const PHASE_BY_ID = new Map(WORKFLOW_PHASES.map((definition) => [definition.phase, definition]));
+const DEFAULT_PHASE_BY_ROLE = new Map(WORKFLOW_PHASES.map((definition) => [definition.role, definition.phase]));
+DEFAULT_PHASE_BY_ROLE.set("product_owner", "po");
+DEFAULT_PHASE_BY_ROLE.set("ux_ui_designer", "ux_review");
+export function workflowPhaseById(phase) {
+    return PHASE_BY_ID.get(phase);
+}
+export function isWorkflowPhase(phase) {
+    return PHASE_BY_ID.has(phase);
+}
+export function workflowPhaseIds() {
+    return WORKFLOW_PHASES.map((definition) => definition.phase);
+}
+export function roleForWorkflowPhase(phase) {
+    return workflowPhaseById(phase)?.role ?? phase;
+}
+export function workflowPhaseForRole(role) {
+    return DEFAULT_PHASE_BY_ROLE.get(role);
+}
+export function workflowPhasesByRole(role) {
+    return WORKFLOW_PHASES.filter((definition) => definition.role === role);
+}
+//# sourceMappingURL=workflow-phases.js.map

package/dist/workflow-phases.js.map

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

package/dist/workflow-run-commands.js

@@ -4,12 +4,18 @@ import { numberOption, parseCsv, removeUndefined, stringOption, } from "./comman
 import { AUTONOMOUS_PHASE_SEQUENCE, PHASE_GATES, autonomousRunsPath, cancelRun, checkArchitectSizing, closePhase, createAutonomousRun, initPhase, listActiveAutonomousRuns, listAutonomousRuns, markRunDone, markRunFailed, persistRun, readAutonomousRun, resumePhaseFromClarification, resumePhaseIndex, suspendPhaseForClarification, } from "./autonomous-workflow.js";
 import { answerClarification, listClarifications, listClarificationsByTask, openClarification, resolveClarificationRole, } from "./clarification.js";
 import { executePhaseWithLlm } from "./phase-executor.js";
+import { planWorkflowPhaseExecutor } from "./runtime-execution.js";
 import { addEvidence, applyProviderRuntimeProfile, approveWorkflowGate, generatePullRequestSummary, getWorkflowConfig, providerFailuresFromError, listTasks, } from "./workflow-services.js";
 import { recommendWorkflowPhasePlan } from "./workflow-phase-planner.js";
 import { OPTIONAL_RECOMMENDED_PHASES } from "./workflow-phase-planner.js";
 import { buildPrBody, createPullRequest } from "./github.js";
 const GATE_MODES = ["none", "phase", "all"];
 const WORKFLOW_RUN_MODES = ["new", "redo", "sign-off"];
+const WORKFLOW_PHASE_EXECUTION_MODES = [
+    "auto",
+    "subagents",
+    "single-agent",
+];
 export async function workflowRunCommand(options, io) {
     await runWorkflowRun(options, io, process.cwd());
 }
@@ -17,6 +23,7 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
     const taskId = requireArg(options, "task");
     const gates = (stringOption(options.gates) ?? "phase");
     const mode = (stringOption(options.mode) ?? "new");
+    const requestedPhaseExecutionMode = stringOption(options["phase-execution"]);
     const maxIterations = numberOption(options["max-iterations"], 5);
     const timeoutMinutes = numberOption(options["timeout-minutes"], 0);
     const file = autonomousRunsPath(cwd);
@@ -37,6 +44,7 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
     }
     const config = await getWorkflowConfig(cwd);
     const phaseTimeoutMinutes = config.workflow?.phaseTimeoutMinutes ?? 0;
+    const phaseExecutionMode = resolvePhaseExecutionMode(requestedPhaseExecutionMode, config.workflow?.phaseExecutionMode);
     if (!GATE_MODES.includes(gates)) {
         throw new Error(`--gates must be one of: ${GATE_MODES.join(", ")}`);
     }
@@ -50,7 +58,7 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
         throw new Error("workflow.phaseTimeoutMinutes must be 0 or greater");
     }
     if (options["dry-run"]) {
-        return workflowDryRun(cwd, options, io, taskId, gates, maxIterations, phaseSelection);
+        return workflowDryRun(cwd, options, io, taskId, gates, maxIterations, phaseSelection, phaseExecutionMode);
     }
     let run;
     let startIndex;
@@ -61,6 +69,7 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
         }
         run = existing;
         run = { ...run, mode };
+        run = { ...run, phaseExecutionMode };
         if (run.status === "canceled" || run.status === "failed") {
             throw new Error(`workflow run ${run.id} is ${run.status} and cannot be resumed`);
         }
@@ -92,12 +101,14 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
             mode,
             phaseSequence: phaseSelection.sequence.map((phase) => phase.phase),
             phaseDefinitions: phaseSelection.sequence,
+            phaseExecutionMode,
             skippedPhases: uniquePhases([
                 ...phaseSelection.skipped,
                 ...phaseSelection.sequence.slice(0, startIndex),
             ]),
         });
         io.log(`Started autonomous workflow ${run.id} for task ${taskId} [gates=${gates} mode=${mode}]`);
+        io.log(`Phase execution: ${phaseExecutionMode}`);
         if (fromPhase) {
             io.log(`Starting from phase ${fromPhase}`);
         }
@@ -106,6 +117,7 @@ export async function runWorkflowRun(options, io, cwd = process.cwd()) {
         runTimeoutMinutes: timeoutMinutes,
         phaseTimeoutMinutes,
         jsonOutput: Boolean(options.json),
+        phaseExecutionMode,
     });
     const result = { run, file, cwd };
     if (options.json) {
@@ -380,6 +392,13 @@ function validateWorkflowPhaseSequence(sequence) {
         throw new Error("workflow phase sequence must place developer before qa");
     }
 }
+function resolvePhaseExecutionMode(requested, configured) {
+    const mode = requested ?? configured ?? "auto";
+    if (!WORKFLOW_PHASE_EXECUTION_MODES.includes(mode)) {
+        throw new Error(`--phase-execution must be one of: ${WORKFLOW_PHASE_EXECUTION_MODES.join(", ")}`);
+    }
+    return mode;
+}
 function phaseIndexForId(phaseId, sequence, source) {
     const index = sequence.findIndex((phase) => phase.phase === phaseId);
     if (index === -1) {
@@ -511,6 +530,46 @@ async function updatePhaseProviderProgress(root, run, phase, progress) {
     await persistRun(root, updated);
     return updated;
 }
+async function updatePhaseExecutorProvenance(root, run, phase, executor) {
+    const updated = {
+        ...run,
+        updatedAt: new Date().toISOString(),
+        phases: run.phases.map((candidate) => candidate.phase === phase ? { ...candidate, executor } : candidate),
+    };
+    await persistRun(root, updated);
+    return updated;
+}
+async function pauseForQueuedPhaseExecutor(root, run, phase, input) {
+    const updatedAt = new Date().toISOString();
+    const updated = {
+        ...run,
+        status: "paused",
+        updatedAt,
+        phases: run.phases.map((candidate) => candidate.phase === phase
+            ? {
+                ...candidate,
+                status: "blocked",
+                notes: input.reason,
+                completedAt: updatedAt,
+            }
+            : candidate),
+    };
+    await persistRun(root, updated);
+    await appendEvent(root, {
+        type: "WORKFLOW_PHASE_QUEUED",
+        taskId: run.taskId,
+        actor: "parent",
+        summary: `Workflow phase queued: ${phase}`,
+        artifacts: input.artifact ? [input.artifact] : [],
+        metadata: {
+            runId: run.id,
+            phase,
+            reason: input.reason,
+            resumeCommand: `orchestra workflow run --task ${run.taskId} --resume ${run.id}`,
+        },
+    });
+    return updated;
+}
 async function executePhases(cwd, run, startIndex, io, sequence, timeoutOptions) {
     let current = run;
     let qaFailNotes;
@@ -545,6 +604,31 @@ async function executePhases(cwd, run, startIndex, io, sequence, timeoutOptions)
             return current;
         }
         const routing = await providerRoutingForPhase(cwd, def.role);
+        const executor = await planWorkflowPhaseExecutor({
+            taskId: current.taskId,
+            runId: current.id,
+            phase: def.phase,
+            role: def.role,
+            mode: timeoutOptions.phaseExecutionMode,
+            root: cwd,
+        });
+        current = await updatePhaseExecutorProvenance(cwd, current, def.phase, executor);
+        if (!timeoutOptions.jsonOutput) {
+            const label = executor.executor === "runtime-native-subagent"
+                ? `${executor.runtime} subagent`
+                : executor.executor === "queued-runtime-subagent"
+                    ? `${executor.runtime} subagent queued${executor.fallbackReason ? ` (${executor.fallbackReason})` : ""}`
+                    : `parent-agent fallback${executor.fallbackReason ? ` (${executor.fallbackReason})` : ""}`;
+            io.log(`  ↳ executor ${label}`);
+        }
+        if (executor.executor === "queued-runtime-subagent") {
+            current = await pauseForQueuedPhaseExecutor(cwd, current, def.phase, {
+                reason: executor.fallbackReason ?? "runtime delegation queued",
+                ...(executor.artifact ? { artifact: executor.artifact } : {}),
+            });
+            io.log(`  ⏳ phase queued — resume when delegation capacity is available: orchestra workflow run --task ${current.taskId} --resume ${current.id}`);
+            return current;
+        }
         const providerStartedAt = new Date().toISOString();
         const progress = startPhaseProgress({
             io,
@@ -704,10 +788,11 @@ async function executePhases(cwd, run, startIndex, io, sequence, timeoutOptions)
     current = await markRunDone(cwd, current);
     return current;
 }
-async function workflowDryRun(cwd, options, io, taskId, gates, maxIterations, phaseSelection) {
+async function workflowDryRun(cwd, options, io, taskId, gates, maxIterations, phaseSelection, phaseExecutionMode) {
     const phasePlan = await recommendWorkflowPhasePlan(taskId, cwd);
     io.log(`Dry run — no records will be created`);
     io.log(`Task: ${taskId}  gates: ${gates}  max-iterations: ${maxIterations}`);
+    io.log(`Phase execution: ${phaseExecutionMode}`);
     io.log(``);
     for (let i = 0; i < phaseSelection.sequence.length; i++) {
         const def = phaseSelection.sequence[i];
@@ -730,6 +815,7 @@ async function workflowDryRun(cwd, options, io, taskId, gates, maxIterations, ph
             taskId,
             gates,
             maxIterations,
+            phaseExecutionMode,
             phases: phaseSelection.sequence,
             skipped: phaseSelection.skipped,
             phasePlan,