@jterrats/open-orchestra 1.0.8 → 1.0.10

package/dist/qa-e2e-artifacts.js

@@ -0,0 +1,225 @@
+import { chmod } from "node:fs/promises";
+import path from "node:path";
+import { ensureDir, resolveWorkflowPath } from "./fs-utils.js";
+import { readPackageScriptNames } from "./package-info.js";
+import { markdownListOrNone, playwrightScenarioMarkdown, } from "./workflow-markdown.js";
+import { assessAcceptanceCriteriaQuality } from "./acceptance-criteria-quality.js";
+import { appendEvent, writeArtifact } from "./workspace.js";
+import { getTaskContext } from "./workflow-services.js";
+import { generatePlaywrightTestPlan } from "./workflow-summary-service.js";
+export async function generateQaE2eArtifactsIfApplicable({ root, run, phase, output, }) {
+    if (phase.phase !== "qa") {
+        return;
+    }
+    const context = await getTaskContext(run.taskId, root);
+    if (!needsExecutableE2eArtifacts(context)) {
+        await recordSkippedQaE2e({
+            root,
+            run,
+            phase,
+            output,
+            reason: "Task scope does not reference browser, CLI, shell, workflow, runtime, UI, site, or E2E validation.",
+        });
+        return;
+    }
+    const selection = await e2eSelectionForTask(root, context.task);
+    if (selection.style === "skipped") {
+        await recordSkippedQaE2e({
+            root,
+            run,
+            phase,
+            output,
+            reason: selection.reason,
+        });
+        return;
+    }
+    const directory = path.join("runs", run.taskId, phase.phase);
+    await ensureDir(resolveWorkflowPath(root, directory));
+    const plan = await generatePlaywrightTestPlan(run.taskId, root);
+    const acceptanceQuality = assessAcceptanceCriteriaQuality(context.task);
+    const planArtifact = await writeArtifact(root, directory, `${run.id}-${phase.phase}-e2e-plan.md`, renderGeneratedE2ePlan(plan, selection, acceptanceQuality));
+    const runnerArtifact = await writeArtifact(root, directory, `${run.id}-${phase.phase}-e2e.sh`, renderGeneratedE2eRunner(selection.commands));
+    await chmod(path.join(root, runnerArtifact), 0o755);
+    output.evidence.push(`Generated ${selection.style} E2E plan: ${planArtifact}`, `Generated executable E2E runner: ${runnerArtifact}`);
+    await appendEvent(root, {
+        type: "EVIDENCE_ADDED",
+        taskId: run.taskId,
+        actor: phase.role,
+        summary: "QA generated executable E2E artifacts",
+        artifacts: [planArtifact, runnerArtifact],
+        metadata: {
+            runId: run.id,
+            phase: phase.phase,
+            style: selection.style,
+            commands: selection.commands,
+            reason: selection.reason,
+        },
+    });
+}
+async function recordSkippedQaE2e({ root, run, phase, output, reason, }) {
+    output.evidence.push(`E2E generation skipped: ${reason}`);
+    await appendEvent(root, {
+        type: "EVIDENCE_ADDED",
+        taskId: run.taskId,
+        actor: phase.role,
+        summary: "QA skipped E2E artifact generation",
+        artifacts: [],
+        metadata: {
+            runId: run.id,
+            phase: phase.phase,
+            style: "skipped",
+            reason,
+        },
+    });
+}
+function needsExecutableE2eArtifacts(context) {
+    return /\b(e2e|end-to-end|playwright|browser|web|ui|site|cli|workflow|handoff|gate|phase|runtime|automata|transition|resume)\b/.test(taskText(context.task));
+}
+async function e2eSelectionForTask(root, task) {
+    const scripts = await readPackageScriptNames(root);
+    const text = taskText(task);
+    const commands = [];
+    const styles = new Set();
+    const workflowRisk = /\b(workflow|handoff|gate|phase|runtime|automata|transition|resume|failback|queue|subagent)\b/.test(text);
+    if (workflowRisk) {
+        for (const script of ["test:e2e:runtime", "test:e2e:init", "test:cli"]) {
+            if (scripts.has(script)) {
+                commands.push(`npm run ${script}`);
+            }
+        }
+        if (commands.length === 0) {
+            commands.push("node --test test/autonomous-workflow-cli.test.js");
+        }
+        styles.add("workflow");
+    }
+    if (scripts.has("test:e2e:init") &&
+        /\b(cli|init|onboarding)\b/.test(text) &&
+        !commands.includes("npm run test:e2e:init")) {
+        commands.push("npm run test:e2e:init");
+        styles.add("cli");
+    }
+    if (scripts.has("test:cli") &&
+        /\b(cli|command|terminal)\b/.test(text) &&
+        !commands.includes("npm run test:cli")) {
+        commands.push("npm run test:cli");
+        styles.add("cli");
+    }
+    if (scripts.has("test:e2e") &&
+        /\b(playwright|browser|web|ui|site)\b/.test(text)) {
+        commands.push("npm run test:e2e");
+        styles.add("browser");
+    }
+    if (scripts.has("test:shell") &&
+        /\b(shell|sh|bash|script|deployment|deploy)\b/.test(text)) {
+        commands.push("npm run test:shell");
+        styles.add("shell");
+    }
+    if (scripts.has("test:smoke") &&
+        /\b(shell|sh|bash|script|deployment|deploy|smoke)\b/.test(text)) {
+        commands.push("npm run test:smoke");
+        styles.add("shell");
+    }
+    const uniqueCommands = [...new Set(commands)];
+    if (uniqueCommands.length === 0) {
+        return {
+            style: "skipped",
+            commands: [],
+            reason: "Task appears to need E2E validation, but no matching E2E, CLI, shell, smoke, or workflow test command was found.",
+        };
+    }
+    return {
+        style: styles.size === 1 ? [...styles][0] : "mixed",
+        commands: uniqueCommands,
+        reason: workflowRisk
+            ? "Matched workflow risk signals; QA must exercise isolated /tmp workflow fixtures, transitions, blocked states, return loops, resume, and generated artifacts."
+            : "Matched QA E2E scripts from task scope and package scripts.",
+    };
+}
+function renderGeneratedE2ePlan(plan, selection, acceptanceQuality) {
+    return [
+        `# Generated E2E Plan: ${plan.taskId}`,
+        "",
+        `- Title: ${plan.title}`,
+        `- Target user: ${plan.targetUser}`,
+        `- Style: ${selection.style}`,
+        `- Reason: ${selection.reason}`,
+        `- Executable runner: ./${plan.taskId}-qa-e2e.sh`,
+        "",
+        "## Commands",
+        ...selection.commands.map((command) => `- ${command}`),
+        "",
+        "## Scenarios",
+        ...scenarioMarkdown(plan, selection, acceptanceQuality),
+        ...acceptanceCriteriaIssueMarkdown(acceptanceQuality),
+        "## QA Standard Checks",
+        ...qaStandardChecks(selection),
+        "",
+        "## Fixtures",
+        ...markdownListOrNone(plan.fixtures),
+        "",
+        "## Notes",
+        ...markdownListOrNone(plan.notes),
+        "",
+    ].join("\n");
+}
+function scenarioMarkdown(plan, selection, acceptanceQuality) {
+    const scenarios = plan.scenarios.filter((scenario) => acceptanceQuality.valid.includes(scenario.source));
+    if (selection.style === "workflow") {
+        return workflowScenarioMarkdown({ ...plan, scenarios });
+    }
+    return playwrightScenarioMarkdown(scenarios);
+}
+function workflowScenarioMarkdown(plan) {
+    return plan.scenarios.flatMap((scenario, index) => [
+        `### Scenario ${index + 1}: ${scenario.source}`,
+        `- Source: ${scenario.source}`,
+        "- Fixture: isolated temporary Orchestra project under `/tmp` with task-specific acceptance criteria, paths, roles, workflow run state, expected handoffs, and generated artifacts.",
+        "- Assertions: verify command exit code, workflow run state, phase transitions, blocked/return/resume behavior when applicable, handoff contents, evidence artifacts, stdout/stderr, and final release readiness state.",
+        "- Evidence: command transcript, generated handoff files, workflow run JSONL records, evidence records, and defect report when expected behavior is not proven.",
+        "",
+    ]);
+}
+function qaStandardChecks(selection) {
+    const checks = [
+        "- Build an AC-to-evidence matrix that maps every acceptance criterion to command/artifact, expected result, actual result, and pass/fail/deferred status.",
+        "- Use isolated deterministic fixtures; use the configured test environment when provided, otherwise default local disposable project fixtures to `/tmp`.",
+        "- Assert resulting product state, not only that a command or browser action executed.",
+        "- Block release when evidence is missing, too generic, or not tied to acceptance criteria.",
+    ];
+    if (selection.style === "workflow" || selection.style === "mixed") {
+        checks.push("- For workflow/state-machine behavior, cover allowed transition, blocked transition, return loop, resume, and final handoff/release artifact content.");
+    }
+    if (selection.style === "browser" || selection.style === "mixed") {
+        checks.push("- For browser/UI behavior, capture responsive evidence and annotate visual defects with screenshots, traces, or video.");
+    }
+    return checks;
+}
+function acceptanceCriteriaIssueMarkdown(quality) {
+    if (quality.issues.length === 0)
+        return [];
+    return [
+        "## Acceptance Criteria Quality Issues",
+        ...quality.issues.map((issue) => `- AC${issue.index + 1}: "${issue.criterion}" is not executable evidence (${issue.reason}). QA must block release until PO/BA rewrites it as an observable outcome.`),
+        "",
+    ];
+}
+function renderGeneratedE2eRunner(commands) {
+    return [
+        "#!/usr/bin/env sh",
+        "set -eu",
+        "",
+        ...commands.flatMap((command) => [`echo "+ ${command}"`, command, ""]),
+    ].join("\n");
+}
+function taskText(task) {
+    return [
+        task.title,
+        task.goal,
+        ...(task.acceptanceCriteria ?? []),
+        ...(task.risks ?? []),
+        ...(task.paths ?? []),
+    ]
+        .join(" ")
+        .toLowerCase();
+}
+//# sourceMappingURL=qa-e2e-artifacts.js.map

package/dist/qa-e2e-artifacts.js.map

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

package/dist/quality-contracts.d.ts

@@ -0,0 +1,83 @@
+import type { HandoffInput, PhaseStructuredOutput, Role, Task } from "./types.js";
+export type QualityContractValidationMode = "advisory" | "warn" | "block" | "human_approval";
+export interface QualityContractRequirement {
+    id: string;
+    label: string;
+    match: string[];
+    severity: "warn" | "block";
+}
+export interface QualityContractDomainOverride {
+    signals: string[];
+    validationMode: QualityContractValidationMode;
+    requiresHumanApproval?: boolean;
+}
+export interface QualityContractOverride {
+    validationMode?: QualityContractValidationMode;
+    allowedTransitions?: string[];
+    returnToPhase?: string;
+}
+export interface QualityContractTransitionOverride extends QualityContractOverride {
+    allowed?: boolean;
+}
+export interface QualityContractPolicyConfig {
+    validationMode?: QualityContractValidationMode;
+    unknownRoleMode?: QualityContractValidationMode;
+    roleOverrides?: Record<string, QualityContractOverride>;
+    phaseOverrides?: Record<string, QualityContractOverride>;
+    capabilityOverrides?: Record<string, QualityContractOverride>;
+    transitionOverrides?: Record<string, QualityContractTransitionOverride>;
+    domainOverrides?: QualityContractDomainOverride[];
+}
+export interface QualityContract {
+    id: string;
+    appliesToRoles: string[];
+    capabilities: string[];
+    requiredInputs: string[];
+    requiredContextFiles: string[];
+    requiredOutputs: QualityContractRequirement[];
+    requiredEvidence: QualityContractRequirement[];
+    blockingConditions: string[];
+    allowedTransitions: string[];
+    returnToPhase?: string;
+    validationMode: QualityContractValidationMode;
+    domainOverrides: QualityContractDomainOverride[];
+}
+export interface QualityContractResolutionInput {
+    role: Role | string;
+    phase?: string;
+    nextPhase?: string;
+    task?: Task;
+    qualityMode?: QualityContractValidationMode;
+    qualityContracts?: QualityContractPolicyConfig;
+}
+export interface QualityContractEvaluationInput extends QualityContractResolutionInput {
+    nextPhase?: string;
+    output?: PhaseStructuredOutput;
+    handoff?: Pick<HandoffInput, "changed" | "behavior" | "tests" | "commands">;
+    handoffContent?: string;
+    contextAcknowledgement?: {
+        status?: "pass" | "missing" | "not_checked" | string;
+        missingRequired?: string[];
+    };
+}
+export interface QualityContractRequirementAssessment {
+    id: string;
+    label: string;
+    status: "covered" | "gap";
+    severity: "warn" | "block";
+    detail: string;
+}
+export interface QualityContractEvaluation {
+    contract: QualityContract;
+    status: "pass" | "warn" | "block";
+    mode: QualityContractValidationMode;
+    requiresHumanApproval: boolean;
+    transitionAllowed: boolean;
+    allowedTransitions: string[];
+    returnToPhase?: string;
+    assessments: QualityContractRequirementAssessment[];
+    missingRequirements: string[];
+}
+export declare const QUALITY_CONTRACT_REGISTRY: QualityContract[];
+export declare function resolveQualityContract(input: QualityContractResolutionInput): QualityContract;
+export declare function evaluateQualityContract(input: QualityContractEvaluationInput): QualityContractEvaluation;