@jterrats/open-orchestra 1.0.8 → 1.0.10

package/dist/quality-contracts.js

@@ -0,0 +1,463 @@
+const GENERIC_CONTRACT = {
+    id: "generic-advisory",
+    appliesToRoles: ["*"],
+    capabilities: [],
+    requiredInputs: ["task goal", "acceptance criteria"],
+    requiredContextFiles: [],
+    requiredOutputs: [
+        requirement("handoff-notes", "Handoff notes", ["handoff", "summary"]),
+    ],
+    requiredEvidence: [],
+    blockingConditions: [],
+    allowedTransitions: ["*"],
+    validationMode: "advisory",
+    domainOverrides: [regulatedDomainOverride()],
+};
+export const QUALITY_CONTRACT_REGISTRY = [
+    {
+        id: "developer-delivery",
+        appliesToRoles: ["developer"],
+        capabilities: ["implementation", "code", "test", "qa-evidence"],
+        requiredInputs: ["task goal", "acceptance criteria", "architecture notes"],
+        requiredContextFiles: [
+            "AGENTS.md",
+            "rules/development-engineering.mdc",
+            "rules/testing-discipline.mdc",
+        ],
+        requiredOutputs: [
+            requirement("consumed-context", "Consumed context files", [
+                "consumed context files",
+                "context files",
+            ]),
+            requirement("changed-files", "Changed files", [
+                "changed files",
+                "changed components",
+                "touched files",
+                "modified files",
+            ]),
+            requirement("architectural-concerns", "Architectural concerns", [
+                "architectural concerns",
+                "inherited",
+                "self-imposed",
+            ]),
+            requirement("handoff-notes", "Handoff notes", ["handoff", "summary"]),
+        ],
+        requiredEvidence: [
+            requirement("unit-tests", "Unit test evidence", [
+                "unit test",
+                "node --test",
+                "npm test",
+                "mocha",
+            ]),
+            requirement("command-evidence", "Command evidence", [
+                "commands run",
+                "npm run",
+                "node ",
+                "build",
+                "lint",
+            ]),
+        ],
+        blockingConditions: [
+            "No consumed context acknowledgement",
+            "No unit test or command evidence",
+        ],
+        allowedTransitions: ["qa", "ux_review", "security_review", "done"],
+        returnToPhase: "developer",
+        validationMode: "block",
+        domainOverrides: [regulatedDomainOverride()],
+    },
+    {
+        id: "qa-verification",
+        appliesToRoles: ["qa", "sdet"],
+        capabilities: ["qa-evidence", "testing", "automation"],
+        requiredInputs: ["acceptance criteria", "developer handoff", "test plan"],
+        requiredContextFiles: [
+            "AGENTS.md",
+            "rules/testing-discipline.mdc",
+            "rules/delivery-quality-gates.mdc",
+        ],
+        requiredOutputs: [
+            requirement("consumed-context", "Consumed context files", [
+                "consumed context files",
+                "context files",
+            ]),
+            requirement("acceptance-mapping", "Acceptance criteria mapping", [
+                "acceptance criteria coverage",
+                "acceptance criteria mapping",
+                "ac1",
+                "ac-to-evidence",
+            ]),
+            requirement("actual-results", "Actual result evidence", [
+                "actual result",
+                "results",
+                "pass",
+                "fail",
+            ]),
+            requirement("edge-cases", "Edge cases", [
+                "edge case",
+                "boundary",
+                "negative case",
+            ]),
+            requirement("release-recommendation", "Release recommendation", [
+                "release recommendation",
+                "recommendation",
+                "go/no-go",
+                "go no-go",
+            ]),
+        ],
+        requiredEvidence: [
+            requirement("evidence-artifacts", "Evidence artifacts", [
+                "evidence",
+                "screenshot",
+                "trace",
+                "video",
+                "command",
+                "log",
+            ]),
+        ],
+        blockingConditions: [
+            "No acceptance criteria mapping",
+            "No actual result evidence",
+            "No release recommendation",
+        ],
+        allowedTransitions: ["release", "developer"],
+        returnToPhase: "developer",
+        validationMode: "block",
+        domainOverrides: [regulatedDomainOverride()],
+    },
+    {
+        id: "release-readiness",
+        appliesToRoles: ["release_manager"],
+        capabilities: ["release", "deployment", "rollback"],
+        requiredInputs: ["QA evidence", "accepted risks", "release notes"],
+        requiredContextFiles: [
+            "AGENTS.md",
+            "rules/delivery-quality-gates.mdc",
+            "rules/release-rollback.mdc",
+        ],
+        requiredOutputs: [
+            requirement("consumed-context", "Consumed context files", [
+                "consumed context files",
+                "context files",
+            ]),
+            requirement("qa-review", "QA evidence review", [
+                "qa evidence",
+                "test evidence",
+                "evidence review",
+            ]),
+            requirement("go-no-go", "Go/no-go", ["go/no-go", "go no-go", "no-go"]),
+            requirement("rollback-risk", "Rollback risk", [
+                "rollback",
+                "rollback risk",
+            ]),
+            requirement("docs-changelog", "Docs or changelog decision", [
+                "docs",
+                "documentation",
+                "changelog",
+                "release notes",
+            ]),
+            requirement("residual-risk", "Residual risk", [
+                "residual risk",
+                "accepted risk",
+                "remaining risk",
+            ]),
+        ],
+        requiredEvidence: [],
+        blockingConditions: ["No go/no-go", "No rollback risk review"],
+        allowedTransitions: ["done", "qa"],
+        returnToPhase: "qa",
+        validationMode: "block",
+        domainOverrides: [regulatedDomainOverride()],
+    },
+];
+export function resolveQualityContract(input) {
+    const roleId = roleIdFor(input.role);
+    const capabilities = capabilitiesFor(input.role);
+    const taskText = taskSearchText(input.task);
+    const roleContract = QUALITY_CONTRACT_REGISTRY.find((candidate) => candidate.appliesToRoles.includes(roleId));
+    const contract = roleContract ?? GENERIC_CONTRACT;
+    return applyQualityContractOverrides({
+        contract,
+        input,
+        roleId,
+        capabilities,
+        taskText,
+        isUnknownRole: !roleContract,
+    });
+}
+export function evaluateQualityContract(input) {
+    const contract = resolveQualityContract(input);
+    const haystack = normalize([
+        input.handoffContent,
+        input.output?.summary,
+        input.output?.notes,
+        input.output?.handoff,
+        ...(input.output?.findings ?? []),
+        ...(input.output?.decisions ?? []),
+        ...(input.output?.evidence ?? []),
+        input.handoff?.changed,
+        input.handoff?.behavior,
+        input.handoff?.tests,
+        input.handoff?.commands,
+        input.output?.architecturalConcerns
+            ? [
+                "architectural concerns",
+                ...input.output.architecturalConcerns.inherited,
+                ...input.output.architecturalConcerns.selfImposed,
+            ].join(" ")
+            : undefined,
+    ]
+        .filter(Boolean)
+        .join(" "));
+    const assessments = [
+        ...contract.requiredOutputs,
+        ...contract.requiredEvidence,
+    ].map((expected) => assessRequirement(expected, haystack));
+    const contextAssessment = assessContextAcknowledgement(input, contract);
+    if (contextAssessment)
+        assessments.unshift(contextAssessment);
+    const transitionAssessment = assessAllowedTransition(input, contract);
+    if (transitionAssessment)
+        assessments.unshift(transitionAssessment);
+    const blockingGaps = assessments.filter((assessment) => assessment.status === "gap" && shouldBlock(contract, assessment));
+    const warnGaps = assessments.filter((assessment) => assessment.status === "gap" && !shouldBlock(contract, assessment));
+    const status = blockingGaps.length > 0 || contract.validationMode === "human_approval"
+        ? "block"
+        : warnGaps.length > 0
+            ? "warn"
+            : "pass";
+    return {
+        contract,
+        status,
+        mode: contract.validationMode,
+        requiresHumanApproval: contract.validationMode === "human_approval",
+        transitionAllowed: transitionAssessment?.status !== "gap",
+        allowedTransitions: contract.allowedTransitions.slice(),
+        assessments,
+        missingRequirements: assessments
+            .filter((assessment) => assessment.status === "gap")
+            .map((assessment) => assessment.label),
+        ...(status === "block" && contract.returnToPhase
+            ? { returnToPhase: contract.returnToPhase }
+            : {}),
+    };
+}
+function assessAllowedTransition(input, contract) {
+    if (!input.nextPhase || contract.allowedTransitions.includes("*")) {
+        return undefined;
+    }
+    if (contract.allowedTransitions.includes(input.nextPhase)) {
+        return {
+            id: "allowed-transition",
+            label: "Allowed phase transition",
+            status: "covered",
+            severity: "block",
+            detail: `${input.phase ?? "phase"} can transition to ${input.nextPhase}.`,
+        };
+    }
+    return {
+        id: "allowed-transition",
+        label: "Allowed phase transition",
+        status: "gap",
+        severity: "block",
+        detail: `Gap: ${input.phase ?? "phase"} cannot transition to ${input.nextPhase}; allowed transitions are ${contract.allowedTransitions.join(", ")}.`,
+    };
+}
+function requirement(id, label, match, severity = "block") {
+    return { id, label, match, severity };
+}
+function regulatedDomainOverride() {
+    return {
+        signals: [
+            "regulated",
+            "medical",
+            "medicine",
+            "healthcare",
+            "hipaa",
+            "pii",
+            "payment",
+            "pci",
+            "finance",
+            "sox",
+        ],
+        validationMode: "human_approval",
+        requiresHumanApproval: true,
+    };
+}
+function roleIdFor(role) {
+    return typeof role === "string" ? role : role.id;
+}
+function capabilitiesFor(role) {
+    return typeof role === "string" ? [] : role.capabilities;
+}
+function taskSearchText(task) {
+    return normalize([
+        task?.title,
+        task?.goal,
+        task?.scope,
+        ...(task?.paths ?? []),
+        ...(task?.risks ?? []),
+    ]
+        .filter(Boolean)
+        .join(" "));
+}
+function applyQualityContractOverrides({ contract, input, roleId, capabilities, taskText, isUnknownRole, }) {
+    const configured = input.qualityContracts;
+    let resolved = cloneContract(contract);
+    resolved = applyDomainOverride(resolved, taskText);
+    resolved = applyConfiguredMode(resolved, configured?.validationMode);
+    if (isUnknownRole) {
+        resolved = applyConfiguredMode(resolved, configured?.unknownRoleMode);
+    }
+    for (const capability of capabilities) {
+        resolved = applyConfiguredOverride(resolved, configured?.capabilityOverrides?.[capability]);
+    }
+    resolved = applyConfiguredOverride(resolved, configured?.roleOverrides?.[roleId]);
+    if (input.phase) {
+        resolved = applyConfiguredOverride(resolved, configured?.phaseOverrides?.[input.phase]);
+    }
+    resolved = applyTransitionOverride(resolved, input, configured);
+    resolved = applyConfiguredDomainOverride(resolved, taskText, configured?.domainOverrides);
+    return applyQualityModeOverride(resolved, input.qualityMode);
+}
+function applyDomainOverride(contract, taskText) {
+    const override = contract.domainOverrides.find((candidate) => candidate.signals.some((signal) => taskText.includes(normalize(signal))));
+    if (!override)
+        return cloneContract(contract);
+    return {
+        ...cloneContract(contract),
+        validationMode: override.validationMode,
+    };
+}
+function applyConfiguredDomainOverride(contract, taskText, overrides) {
+    const override = overrides?.find((candidate) => candidate.signals.some((signal) => taskText.includes(normalize(signal))));
+    if (!override)
+        return contract;
+    return { ...contract, validationMode: override.validationMode };
+}
+function applyConfiguredMode(contract, mode) {
+    return mode
+        ? applyConfiguredOverride(contract, { validationMode: mode })
+        : contract;
+}
+function applyConfiguredOverride(contract, override) {
+    if (!override)
+        return contract;
+    return {
+        ...contract,
+        ...(override.validationMode
+            ? { validationMode: override.validationMode }
+            : {}),
+        ...(override.allowedTransitions
+            ? { allowedTransitions: override.allowedTransitions.slice() }
+            : {}),
+        ...(override.returnToPhase
+            ? { returnToPhase: override.returnToPhase }
+            : {}),
+    };
+}
+function applyTransitionOverride(contract, input, config) {
+    if (!input.phase || !input.nextPhase)
+        return contract;
+    const override = transitionOverrideFor(config, input.phase, input.nextPhase);
+    if (!override)
+        return contract;
+    const allowedTransitions = override.allowedTransitions ??
+        (override.allowed === true
+            ? uniqueStrings([...contract.allowedTransitions, input.nextPhase])
+            : override.allowed === false
+                ? contract.allowedTransitions.filter((phase) => phase !== input.nextPhase)
+                : undefined);
+    return applyConfiguredOverride(contract, {
+        ...override,
+        ...(allowedTransitions ? { allowedTransitions } : {}),
+    });
+}
+function transitionOverrideFor(config, phase, nextPhase) {
+    const overrides = config?.transitionOverrides;
+    if (!overrides)
+        return undefined;
+    return (overrides[`${phase}->${nextPhase}`] ??
+        overrides[`${phase}→${nextPhase}`] ??
+        overrides[phase]);
+}
+function applyQualityModeOverride(contract, mode) {
+    if (!mode)
+        return contract;
+    return { ...contract, validationMode: mode };
+}
+function assessRequirement(requirement, haystack) {
+    const covered = requirement.match.some((token) => haystack.includes(normalize(token)));
+    return {
+        id: requirement.id,
+        label: requirement.label,
+        status: covered ? "covered" : "gap",
+        severity: requirement.severity,
+        detail: covered
+            ? `${requirement.label} covered.`
+            : `Gap: ${requirement.label} missing.`,
+    };
+}
+function assessContextAcknowledgement(input, contract) {
+    if (contract.requiredContextFiles.length === 0)
+        return undefined;
+    if (input.contextAcknowledgement?.status === "pass") {
+        return {
+            id: "context-acknowledgement",
+            label: "Required context acknowledgement",
+            status: "covered",
+            severity: "block",
+            detail: "Required context acknowledgement passed.",
+        };
+    }
+    const haystack = normalize([input.handoffContent, input.output?.handoff].filter(Boolean).join(" "));
+    if (haystack.includes("consumed context files")) {
+        return {
+            id: "context-acknowledgement",
+            label: "Required context acknowledgement",
+            status: "covered",
+            severity: "block",
+            detail: "Consumed context files section was provided.",
+        };
+    }
+    return {
+        id: "context-acknowledgement",
+        label: "Required context acknowledgement",
+        status: "gap",
+        severity: "block",
+        detail: "Gap: required context acknowledgement missing.",
+    };
+}
+function shouldBlock(contract, assessment) {
+    return contract.validationMode === "block" ||
+        contract.validationMode === "human_approval"
+        ? assessment.severity === "block"
+        : false;
+}
+function cloneContract(contract) {
+    return {
+        ...contract,
+        appliesToRoles: contract.appliesToRoles.slice(),
+        capabilities: contract.capabilities.slice(),
+        requiredInputs: contract.requiredInputs.slice(),
+        requiredContextFiles: contract.requiredContextFiles.slice(),
+        requiredOutputs: contract.requiredOutputs.map((item) => ({ ...item })),
+        requiredEvidence: contract.requiredEvidence.map((item) => ({ ...item })),
+        blockingConditions: contract.blockingConditions.slice(),
+        allowedTransitions: contract.allowedTransitions.slice(),
+        domainOverrides: contract.domainOverrides.map((item) => ({
+            ...item,
+            signals: item.signals.slice(),
+        })),
+    };
+}
+function normalize(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+//# sourceMappingURL=quality-contracts.js.map

package/dist/quality-contracts.js.map

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

package/dist/refresh-generated.js

@@ -4,6 +4,7 @@ import { DEFAULT_PHASE_PLAYBOOKS, DEFAULT_PLAYBOOKS_DIR, } from "./phase-playboo
 import { resolveWorkspaceWritePath } from "./fs-utils.js";
 import { renderRuntimeBootstrap, upsertRuntimeBootstrapBlock, } from "./runtime-bootstrap.js";
 import { resolveRefreshRuntimeBootstrapTargets } from "./runtime-bootstrap-targets.js";
+import { backupExistingWorkspaceFiles } from "./workspace-init-artifacts.js";
 export async function refreshGeneratedFiles({ root = process.cwd(), check = false, dryRun = false, force = false, targets, } = {}) {
     const items = [
         ...(await refreshRuntimeBootstrapFiles({
@@ -15,8 +16,9 @@ export async function refreshGeneratedFiles({ root = process.cwd(), check = fals
         })),
         ...(await refreshPhasePlaybooks({ root, check, dryRun, force })),
     ];
+    const mode = refreshMode({ check, dryRun });
     return {
-        mode: check ? "check" : dryRun ? "dry-run" : "apply",
+        mode,
         force,
         driftStatus: driftStatus(items),
         items,
@@ -54,24 +56,25 @@ async function refreshRuntimeBootstrapFiles({ root, check, dryRun, force, target
         }
         if (result.changed && !check && !dryRun) {
             await ensureParent(filePath);
+            await backupExistingWorkspaceFiles({
+                root,
+                relativePaths: [candidate.path],
+            });
             await writeFile(filePath, result.content, "utf8");
         }
         const beforeStatus = runtimeBeforeStatus(existing, result);
+        const changed = result.changed;
         items.push({
             kind: "runtime-bootstrap",
             path: candidate.path,
             target: candidate.target,
             managedBlockId: `runtime-bootstrap:${candidate.target}`,
             beforeStatus,
-            afterStatus: afterStatus(result.changed, check, dryRun),
-            status: result.changed ? "changed" : "unchanged",
-            reason: result.missing
-                ? "managed block missing"
-                : result.changed
-                    ? "managed block refreshed"
-                    : "managed block current",
-            plannedWrite: result.changed && !check,
-            recommendedCommand: result.changed
+            afterStatus: afterStatus(changed, check, dryRun),
+            status: itemStatus(changed),
+            reason: runtimeRefreshReason(result),
+            plannedWrite: changed && !check,
+            recommendedCommand: changed
                 ? recommendedRefreshCommand({ force, target: candidate.target })
                 : "none",
         });
@@ -93,8 +96,17 @@ async function refreshPhasePlaybooks({ root, check, dryRun, force, }) {
         const desired = `${content}\n`;
         const missing = existing === "";
         const changed = missing || (force && existing !== desired);
+        const beforeStatus = phasePlaybookBeforeStatus({
+            missing,
+            existing,
+            desired,
+        });
         if (changed && !check && !dryRun) {
             await ensureParent(filePath);
+            await backupExistingWorkspaceFiles({
+                root,
+                relativePaths: [relativePath],
+            });
             await writeFile(filePath, desired, "utf8");
         }
         items.push({
@@ -102,30 +114,71 @@ async function refreshPhasePlaybooks({ root, check, dryRun, force, }) {
             path: relativePath,
             target: phase,
             managedBlockId: `phase-playbook:${phase}`,
-            beforeStatus: missing
-                ? "missing"
-                : existing === desired
-                    ? "current"
-                    : "custom",
+            beforeStatus,
             afterStatus: afterStatus(changed, check, dryRun),
-            status: changed ? "changed" : "unchanged",
-            reason: missing
-                ? "default playbook missing"
-                : changed
-                    ? "default playbook refreshed with --force"
-                    : force
-                        ? "default playbook current"
-                        : "existing playbook preserved",
+            status: itemStatus(changed),
+            reason: phasePlaybookRefreshReason({ missing, changed, force }),
             plannedWrite: changed && !check,
-            recommendedCommand: changed
-                ? recommendedRefreshCommand({ force })
-                : missing
-                    ? recommendedRefreshCommand({ force: false })
-                    : "none",
+            recommendedCommand: phasePlaybookRecommendedCommand({
+                missing,
+                changed,
+                force,
+            }),
         });
     }
     return items;
 }
+function refreshMode({ check, dryRun, }) {
+    if (check) {
+        return "check";
+    }
+    if (dryRun) {
+        return "dry-run";
+    }
+    return "apply";
+}
+function itemStatus(changed) {
+    return changed ? "changed" : "unchanged";
+}
+function runtimeRefreshReason(result) {
+    if (result.missing) {
+        return "managed block missing";
+    }
+    if (result.changed) {
+        return "managed block refreshed";
+    }
+    return "managed block current";
+}
+function phasePlaybookBeforeStatus({ missing, existing, desired, }) {
+    if (missing) {
+        return "missing";
+    }
+    if (existing === desired) {
+        return "current";
+    }
+    return "custom";
+}
+function phasePlaybookRefreshReason({ missing, changed, force, }) {
+    if (missing) {
+        return "default playbook missing";
+    }
+    if (changed) {
+        return "default playbook refreshed with --force";
+    }
+    if (force) {
+        return "default playbook current";
+    }
+    return "existing playbook preserved";
+}
+function phasePlaybookRecommendedCommand({ missing, changed, force, }) {
+    if (changed) {
+        return recommendedRefreshCommand({ force });
+    }
+    if (missing) {
+        return recommendedRefreshCommand({ force: false });
+    }
+    return "none";
+}
 function runtimeBeforeStatus(existing, result) {
     if (existing === "") {
         return "missing";