@jterrats/open-orchestra 1.0.14 → 1.0.16

package/dist/provider-agent-wrapper.js

@@ -0,0 +1,264 @@
+import { randomUUID } from "node:crypto";
+export async function executeProviderBackedAgent(request, deps) {
+    const requestId = `provider-agent-${randomUUID()}`;
+    const providerIds = [request.routing.provider, ...request.routing.fallbacks];
+    const failedProviders = [];
+    for (const [index, providerId] of providerIds.entries()) {
+        const entryResult = registryEntryForProvider(providerId, deps);
+        if (entryResult.outcome === "blocked") {
+            return blockedResult(request, requestId, providerId, entryResult.safeMessage);
+        }
+        const policyBlock = providerPolicyBlock(request, entryResult.entry, index);
+        if (policyBlock) {
+            return blockedResult(request, requestId, providerId, policyBlock);
+        }
+        const budget = await deps.checkBudget(providerId);
+        if (!budget.passed) {
+            return blockedResult(request, requestId, providerId, budget.safeMessage ?? "provider execution blocked by budget envelope");
+        }
+        const provider = deps.createProvider(providerId);
+        const capabilityBlock = providerCapabilityBlock(request, entryResult.entry);
+        if (capabilityBlock) {
+            return blockedResult(request, requestId, providerId, capabilityBlock);
+        }
+        let attempts = 0;
+        const maxAttempts = Math.max(1, request.retries + 1);
+        while (attempts < maxAttempts) {
+            attempts += 1;
+            try {
+                const response = await deps.complete(provider, request);
+                return completedResult({
+                    request,
+                    requestId,
+                    response,
+                    fallbackUsed: index > 0,
+                    failedProviders,
+                });
+            }
+            catch (error) {
+                if (isSchedulerBlock(error)) {
+                    return blockedResult(request, requestId, providerId, sanitizeProviderError(error));
+                }
+                const failure = providerFailureFromError(providerId, error, attempts);
+                if (failure.code === "timeout") {
+                    return failedResult(request, requestId, providerId, [failure]);
+                }
+                if (failure.retryable && attempts < maxAttempts)
+                    continue;
+                failedProviders.push(failure);
+                break;
+            }
+        }
+    }
+    return failedResult(request, requestId, request.routing.provider, failedProviders);
+}
+function registryEntryForProvider(providerId, deps) {
+    try {
+        return { outcome: "resolved", entry: deps.registryEntry(providerId) };
+    }
+    catch {
+        return {
+            outcome: "blocked",
+            safeMessage: `unknown provider: ${providerId}`,
+        };
+    }
+}
+function providerPolicyBlock(request, entry, attemptIndex) {
+    const policy = request.policy.providerPolicy;
+    if (policy?.blockedProviders?.includes(entry.id)) {
+        return `provider is blocked by policy: ${entry.id}`;
+    }
+    if (policy?.allowedProviders &&
+        policy.allowedProviders.length > 0 &&
+        !policy.allowedProviders.includes(entry.id)) {
+        return `provider is not allowed by policy: ${entry.id}`;
+    }
+    if (attemptIndex > 0 && !policy?.allowVendorFallbackWithoutApproval) {
+        return `provider fallback approval required: ${entry.id}`;
+    }
+    if (requiresDirectProviderApi(entry.dataClass) &&
+        !request.policy.directProviderApiAllowed) {
+        return "provider-backed phase execution requires runtimePolicy.delegation.allowDirectProviderApi=true";
+    }
+    if (entry.dataClass === "external" &&
+        request.policy.tenantDataPolicy === "local-only") {
+        return `tenant data policy blocks external provider: ${entry.id}`;
+    }
+    return undefined;
+}
+function requiresDirectProviderApi(dataClass) {
+    return dataClass !== "test";
+}
+function providerCapabilityBlock(request, entry) {
+    for (const capability of request.requiredCapabilities) {
+        if (!providerHasCapability(entry, capability)) {
+            return `provider ${entry.id} does not support required capability: ${capability}`;
+        }
+    }
+    if (entry.capabilities.maxContextTokens > 0 &&
+        request.budget.maxTokens > entry.capabilities.maxContextTokens) {
+        return `provider ${entry.id} context budget is too small for requested tokens`;
+    }
+    return undefined;
+}
+function providerHasCapability(entry, capability) {
+    if (capability === "streaming")
+        return entry.capabilities.streaming;
+    if (capability === "tools")
+        return entry.capabilities.tools;
+    if (capability === "vision")
+        return entry.capabilities.vision;
+    if (capability === "jsonMode")
+        return entry.capabilities.jsonMode;
+    return false;
+}
+function completedResult({ request, requestId, response, fallbackUsed, failedProviders, }) {
+    const costSource = response.provider === "fake" ? "free" : "unavailable";
+    const costUnavailableRationale = costSource === "unavailable"
+        ? "Provider usage was recorded, but pricing estimation is not configured for this runtime."
+        : undefined;
+    return {
+        outcome: "completed",
+        provider: response.provider,
+        model: response.model,
+        requestId,
+        responseId: response.id,
+        content: response.content,
+        usage: {
+            inputTokens: response.usage.inputTokens,
+            outputTokens: response.usage.outputTokens,
+            usageSource: "provider",
+        },
+        cost: {
+            estimatedCostUsd: 0,
+            costSource,
+            ...(costUnavailableRationale ? { costUnavailableRationale } : {}),
+        },
+        fallback: {
+            used: fallbackUsed,
+            failedProviders,
+            finalProvider: response.provider,
+            finalModel: response.model,
+        },
+        provenance: {
+            task: request.taskId,
+            ...(request.runId ? { runId: request.runId } : {}),
+            phase: request.phase,
+            actor: request.actor,
+            role: request.role,
+            provider: response.provider,
+            model: response.model,
+            promptId: request.promptId,
+            requestId,
+            responseId: response.id,
+            inputTokens: response.usage.inputTokens,
+            outputTokens: response.usage.outputTokens,
+            estimatedCostUsd: 0,
+            usageSource: "provider",
+            costSource,
+            ...(costUnavailableRationale ? { costUnavailableRationale } : {}),
+            fallbackUsed,
+            failedProviders,
+            finalProvider: response.provider,
+            finalModel: response.model,
+            directProviderApiAllowed: request.policy.directProviderApiAllowed,
+            finishReason: response.finishReason,
+        },
+    };
+}
+function blockedResult(request, requestId, providerId, safeMessage) {
+    return {
+        outcome: "blocked",
+        provider: providerId,
+        model: request.routing.model,
+        requestId,
+        usage: unavailableUsage("blocked before provider execution"),
+        cost: unavailableCost("blocked before provider execution"),
+        fallback: {
+            used: false,
+            failedProviders: [],
+            finalProvider: providerId,
+            finalModel: request.routing.model,
+        },
+        safeMessage,
+    };
+}
+function failedResult(request, requestId, providerId, failedProviders) {
+    return {
+        outcome: "failed",
+        provider: providerId,
+        model: request.routing.model,
+        requestId,
+        usage: unavailableUsage("provider execution failed"),
+        cost: unavailableCost("provider execution failed"),
+        fallback: {
+            used: failedProviders.length > 1,
+            failedProviders,
+            finalProvider: providerId,
+            finalModel: request.routing.model,
+        },
+        safeMessage: providerFailureSummary(failedProviders),
+    };
+}
+function unavailableUsage(rationale) {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        usageSource: "unavailable",
+        usageUnavailableRationale: rationale,
+    };
+}
+function unavailableCost(rationale) {
+    return {
+        estimatedCostUsd: 0,
+        costSource: "unavailable",
+        costUnavailableRationale: rationale,
+    };
+}
+function providerFailureFromError(providerId, error, attempts) {
+    const code = providerFailureCode(error);
+    return {
+        provider: providerId,
+        code,
+        reason: sanitizeProviderError(error),
+        retryable: code === "provider_error",
+        attempts,
+    };
+}
+function providerFailureCode(error) {
+    const message = errorMessage(error).toLowerCase();
+    if (/timeout|timed out|aborted/.test(message))
+        return "timeout";
+    if (/permission|denied|forbidden|unauthorized/.test(message)) {
+        return "permission_denied";
+    }
+    if (/policy|not allowed|blocked/.test(message))
+        return "policy_blocked";
+    return "provider_error";
+}
+function sanitizeProviderError(error) {
+    return errorMessage(error)
+        .replace(/Bearer\s+\S+/gi, "Bearer [REDACTED]")
+        .replace(/\b(authorization|x-goog-api-key|x-api-key|api[-_]?key|apiKey)\s*[:=]\s*[^&\s,;]+/gi, "$1=[REDACTED]")
+        .replace(/\bAIza[0-9A-Za-z_-]{20,}\b/g, "[REDACTED_API_KEY]")
+        .replace(/\b(sk|ghp|github_pat)_[A-Za-z0-9_-]{12,}\b/g, "[REDACTED_TOKEN]");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isSchedulerBlock(error) {
+    const message = errorMessage(error).toLowerCase();
+    return (message.includes("backpressure") ||
+        message.includes("circuit is open") ||
+        message.includes("queue is full"));
+}
+function providerFailureSummary(failures) {
+    if (failures.length === 0)
+        return "provider execution failed";
+    const providers = failures.map((failure) => failure.provider).join(", ");
+    const details = failures
+        .map((failure) => `${failure.provider}: ${failure.reason}`)
+        .join("; ");
+    return `all providers failed: ${providers}${details ? ` (${details})` : ""}`;
+}
+//# sourceMappingURL=provider-agent-wrapper.js.map

package/dist/provider-agent-wrapper.js.map

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

package/dist/qa-commands.d.ts

@@ -1,2 +1,3 @@
 import type { CliIo, CliOptions } from "./types.js";
 export declare function qaCoverageCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function qaEvidenceCheckCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/qa-commands.js

@@ -1,4 +1,6 @@
 import { requireArg } from "./args.js";
+import { removeUndefined, stringOption } from "./command-utils.js";
+import { evaluateAutomationEvidence } from "./qa-evidence-validation.js";
 import { generateQaAutomationCoverage } from "./qa-coverage.js";
 export async function qaCoverageCommand(options, io) {
     const report = await generateQaAutomationCoverage(requireArg(options, "task"));
@@ -15,4 +17,28 @@ export async function qaCoverageCommand(options, io) {
         }
     }
 }
+export async function qaEvidenceCheckCommand(options, io) {
+    const report = evaluateAutomationEvidence(removeUndefined({
+        task: stringOption(options.task) ?? "QA-EVIDENCE-CHECK",
+        role: stringOption(options.role) ?? "qa",
+        type: stringOption(options.type) ?? "command",
+        summary: stringOption(options.summary) ?? "QA evidence validation",
+        path: options.path,
+        command: options.command,
+        exitCode: options["exit-code"],
+        surface: requireArg(options, "surface"),
+        assertions: options.assertions,
+        externalValidation: options["external-validation"],
+        deferredOwner: options["deferred-owner"],
+        deferredRationale: options["deferred-rationale"],
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log(`QA evidence check for ${report.surface}: ${report.observableOutcome ? "pass" : "fail"}`);
+    for (const gap of report.gaps) {
+        io.log(`- ${gap}`);
+    }
+}
 //# sourceMappingURL=qa-commands.js.map

package/dist/qa-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"qa-commands.js","sourceRoot":"","sources":["../src/qa-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAGhE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAC/C,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAC5B,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC9D,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"qa-commands.js","sourceRoot":"","sources":["../src/qa-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAIhE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAC/C,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAC5B,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC9D,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,0BAA0B,CACvC,eAAe,CAAgB;QAC7B,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,mBAAmB;QACvD,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI;QACxC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS;QAC7C,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,wBAAwB;QAClE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC;QAC9B,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC;QACvC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,kBAAkB,EAAE,OAAO,CAAC,qBAAqB,CAAC;QAClD,aAAa,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACxC,iBAAiB,EAAE,OAAO,CAAC,oBAAoB,CAAC;KACjD,CAAC,CACH,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,yBAAyB,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CACzF,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/qa-evidence-surface-rules.d.ts

@@ -0,0 +1,5 @@
+import type { AutomationSurface } from "./qa-evidence-validation.js";
+import type { EvidenceInput } from "./types.js";
+export declare function evidenceInputGaps(surface: AutomationSurface, input: EvidenceInput): string[];
+export declare function evidenceAssertionGaps(surface: AutomationSurface, assertions: string | undefined): string[];
+export declare function integrationExternalGaps(surface: AutomationSurface, externalValidation: string | undefined, deferredOwner: string | undefined, deferredRationale: string | undefined, assertions?: string): string[];

package/dist/qa-evidence-surface-rules.js

@@ -0,0 +1,238 @@
+export function evidenceInputGaps(surface, input) {
+    const gaps = [];
+    if (surface === "cli" || surface === "shell") {
+        if (!stringValue(input.command)) {
+            gaps.push(`${surface} evidence must include command`);
+        }
+        if (!stringValue(input.exitCode)) {
+            gaps.push(`${surface} evidence must include exit code`);
+        }
+    }
+    if (surface === "web" && !stringValue(input.path)) {
+        gaps.push("web evidence must reference screenshot, video, trace, or report artifact path");
+    }
+    if (surface === "generated-artifact" && !stringValue(input.path)) {
+        gaps.push("generated artifact evidence must reference the rendered output path");
+    }
+    return gaps;
+}
+export function evidenceAssertionGaps(surface, assertions) {
+    if (surface === "web")
+        return webAssertionGaps(assertions);
+    if (surface === "api")
+        return apiAssertionGaps(assertions);
+    if (surface === "cli")
+        return cliAssertionGaps(assertions);
+    if (surface === "shell")
+        return shellAssertionGaps(assertions);
+    if (surface === "integration")
+        return integrationAssertionGaps(assertions);
+    if (surface === "generated-artifact") {
+        return generatedArtifactAssertionGaps(assertions);
+    }
+    if (surface === "workflow")
+        return workflowAssertionGaps(assertions);
+    if (surface === "mobile")
+        return mobileAssertionGaps(assertions);
+    if (surface === "desktop")
+        return desktopAssertionGaps(assertions);
+    return dataAssertionGaps(assertions);
+}
+export function integrationExternalGaps(surface, externalValidation, deferredOwner, deferredRationale, assertions) {
+    if (surface !== "integration" && surface !== "api")
+        return [];
+    if (externalValidation)
+        return [];
+    if (deferredOwner && deferredRationale)
+        return [];
+    if (assertions &&
+        /\b(receiver|sandbox|mock|contract|webhook|event log|external validation|side effect|persisted)\b/i.test(assertions)) {
+        return [];
+    }
+    return [
+        `${surface} automation must validate sandbox/mock/contract/webhook/event/log or defer with owner and rationale`,
+    ];
+}
+function webAssertionGaps(assertions) {
+    const gaps = assertionChecklistGaps(assertions, [
+        [
+            "web automation must assert visible user-facing state",
+            [/\bvisible\b/, /\buser[- ]?facing\b/, /\bui\b/, /\bscreen\b/],
+        ],
+        [
+            "web automation must include viewport metadata",
+            [/\bviewport\b/, /\bbreakpoint\b/],
+        ],
+        [
+            "web automation must assert selector or visual state",
+            [/\bselector\b/, /\bvisual\b/, /\bscreenshot\b/, /\bpixel\b/],
+        ],
+    ]);
+    if (assertions &&
+        /\b(bug|defect|regression|visual mismatch|overlap)\b/i.test(assertions) &&
+        !/\b(highlight|annotation|annotated|bounding box)\b/i.test(assertions)) {
+        gaps.push("web bug evidence must include highlight or annotation artifact");
+    }
+    return gaps;
+}
+function apiAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        ["api automation must assert request contract", [/\brequest\b/]],
+        ["api automation must assert response contract", [/\bresponse\b/]],
+        [
+            "api automation must assert contract or schema",
+            [/\bcontract\b/, /\bschema\b/],
+        ],
+        [
+            "api automation must assert external side effect or persisted state",
+            [/\bside effect\b/, /\bpersisted\b/, /\bevent\b/, /\bwebhook\b/],
+        ],
+    ]);
+}
+function cliAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "cli automation must assert exit code",
+            [/\bexit code\b/, /\bexit[- ]?code\b/],
+        ],
+        ["cli automation must assert stdout", [/\bstdout\b/]],
+        ["cli automation must assert stderr", [/\bstderr\b/]],
+        [
+            "cli automation must assert artifact references",
+            [/\bartifact(s)?\b/, /\bfile(s)?\b/, /\bevent(s)?\b/],
+        ],
+        [
+            "cli automation must assert final state",
+            [/\bfinal state\b/, /\bresulting state\b/],
+        ],
+    ]);
+}
+function shellAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "shell automation must assert exit status",
+            [/\bexit\b/, /\bstatus\b/, /\bsuccess/],
+        ],
+        [
+            "shell automation must assert observable output or effect",
+            [/\boutput\b/, /\boutcome\b/, /\beffect\b/, /\bresult\b/],
+        ],
+    ]);
+}
+function integrationAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "integration automation must assert request payload",
+            [/\brequest\b/, /\bpayload\b/],
+        ],
+        [
+            "integration automation must assert response or acknowledgement",
+            [/\bresponse\b/, /\back\b/],
+        ],
+        [
+            "integration automation must assert contract",
+            [/\bcontract\b/, /\bschema\b/],
+        ],
+        [
+            "integration automation must assert external side effect",
+            [/\bside effect\b/, /\boutbound\b/],
+        ],
+    ]);
+}
+function generatedArtifactAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "generated artifact automation must assert source files",
+            [/\bsource file(s)?\b/],
+        ],
+        [
+            "generated artifact automation must assert rendered outputs",
+            [/\brender(ed)? output\b/],
+        ],
+        [
+            "generated artifact automation must assert visual bounds",
+            [/\bvisual bounds\b/, /\bbounds\b/],
+        ],
+        [
+            "generated artifact automation must assert text fit",
+            [/\btext fit\b/, /\boverflow\b/],
+        ],
+        [
+            "generated artifact automation must assert connector sanity",
+            [/\bconnector\b/, /\bendpoints?\b/],
+        ],
+        [
+            "generated artifact automation must assert known limitations",
+            [/\bknown limitation(s)?\b/],
+        ],
+    ]);
+}
+function workflowAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "workflow automation must assert phase transitions",
+            [/\bphase transition(s)?\b/, /\btransition/],
+        ],
+        ["workflow automation must assert handoff artifacts", [/\bhandoff\b/]],
+        [
+            "workflow automation must assert parent actions",
+            [/\bparent action(s)?\b/],
+        ],
+        [
+            "workflow automation must assert lifecycle events",
+            [/\blifecycle event(s)?\b/, /\bevent(s)?\b/],
+        ],
+        [
+            "workflow automation must assert terminal task state",
+            [/\bterminal task state\b/, /\bfinal state\b/],
+        ],
+    ]);
+}
+function mobileAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "mobile automation must assert visible device state",
+            [/\bvisible\b/, /\bdevice\b/],
+        ],
+        [
+            "mobile automation must assert responsive or platform-specific behavior",
+            [/\bresponsive\b/, /\bplatform\b/, /\bios\b/, /\bandroid\b/],
+        ],
+    ]);
+}
+function desktopAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "desktop automation must assert visible app state",
+            [/\bvisible\b/, /\bapp state\b/],
+        ],
+        [
+            "desktop automation must assert local files or events",
+            [/\blocal\b/, /\bfile(s)?\b/, /\bevent(s)?\b/],
+        ],
+    ]);
+}
+function dataAssertionGaps(assertions) {
+    return assertionChecklistGaps(assertions, [
+        [
+            "data automation must assert persisted data or query results",
+            [/\bpersisted\b/, /\bquery\b/, /\bdata\b/],
+        ],
+        [
+            "data automation must assert lineage, metric, or quality checks",
+            [/\blineage\b/, /\bmetric\b/, /\bquality\b/],
+        ],
+    ]);
+}
+function assertionChecklistGaps(assertions, checks) {
+    if (!assertions)
+        return checks.map(([message]) => message);
+    const normalized = assertions.toLowerCase();
+    return checks
+        .filter(([, patterns]) => !patterns.some((pattern) => pattern.test(normalized)))
+        .map(([message]) => message);
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+//# sourceMappingURL=qa-evidence-surface-rules.js.map

package/dist/qa-evidence-surface-rules.js.map

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

package/dist/qa-evidence-validation.d.ts

@@ -0,0 +1,23 @@
+import type { EvidenceInput } from "./types.js";
+export type AutomationSurface = "web" | "api" | "cli" | "shell" | "integration" | "generated-artifact" | "workflow" | "mobile" | "desktop" | "data";
+export interface AutomationEvidenceInput {
+    surface?: AutomationSurface;
+    assertions?: string;
+    externalValidation?: string;
+    deferredOwner?: string;
+    deferredRationale?: string;
+}
+export interface AutomationEvidenceQuality {
+    automated: boolean;
+    surface?: AutomationSurface;
+    assertions?: string;
+    externalValidation?: string;
+    deferredOwner?: string;
+    deferredRationale?: string;
+    observableOutcome: boolean;
+    deferredExternalValidation: boolean;
+    gaps: string[];
+}
+export declare function evaluateAutomationEvidence(input: EvidenceInput): AutomationEvidenceQuality;
+export declare function assertAutomationEvidenceQuality(input: EvidenceInput): void;
+export declare function automationEvidenceLines(quality: AutomationEvidenceQuality): string[];