project-tiny-context-harness 0.7.2 → 0.7.4

package/dist/lib/long-task-final-v2.js

@@ -74,18 +74,28 @@ export async function runDeliveryFinalGate(workdirInput) {
         const blocked = globalBlocked ||
             Object.values(outcomeResults).includes("blocked_external") ||
             run.findings.some((finding) => finding.code === "blocked_external");
+        const targetBlocked = compiled.global.acceptance.external_confirmations.some((confirmation) => confirmation.blocks_target);
         const workflowStatus = failed
             ? "needs_work"
-            : blocked
+            : blocked || targetBlocked
                 ? "blocked_external"
                 : compiled.global.acceptance.external_confirmations.length
                     ? "machine_accepted_external_pending"
                     : "machine_accepted";
+        const targetState = workflowStatus === "machine_accepted" ||
+            workflowStatus === "machine_accepted_external_pending"
+            ? compiled.task.target_profile.required_state
+            : workflowStatus === "blocked_external"
+                ? "blocked_external"
+                : "not_accepted";
         return writeFinalReceipt(repository, active.workdir, {
             schema_version: "long-task-final-receipt-v2",
             authority_scope: "audit_only",
             reusable_for_acceptance: false,
             workflow_status: workflowStatus,
+            target_profile: compiled.task.target_profile,
+            target_state: targetState,
+            stage_results: projectStages(compiled, outcomeResults),
             compiled_identity: compiled.compiled_identity,
             contract_sha256: compiled.contract_sha256,
             snapshot_sha256: snapshot.manifest.snapshot_sha256,
@@ -107,6 +117,37 @@ export async function runDeliveryFinalGate(workdirInput) {
         await snapshot.dispose();
     }
 }
+function projectStages(compiled, outcomes) {
+    const result = {};
+    const remaining = new Set(compiled.stages.map((stage) => stage.key));
+    while (remaining.size) {
+        let advanced = false;
+        for (const stage of compiled.stages) {
+            if (!remaining.has(stage.key))
+                continue;
+            if (stage.depends_on.some((dependency) => remaining.has(dependency)))
+                continue;
+            const owned = compiled.outcomes
+                .filter((outcome) => outcome.stage === stage.key)
+                .map((outcome) => outcomes[outcome.key]);
+            result[stage.key] = owned.includes("failed")
+                ? "failed"
+                : owned.includes("blocked_external")
+                    ? "blocked_external"
+                    : stage.depends_on.some((dependency) => result[dependency] !== "passed")
+                        ? "blocked_dependency"
+                        : "passed";
+            remaining.delete(stage.key);
+            advanced = true;
+        }
+        if (!advanced) {
+            for (const stage of remaining)
+                result[stage] = "blocked_dependency";
+            break;
+        }
+    }
+    return result;
+}
 function projectOutcomes(outcomeKeys, checks, findings) {
     return Object.fromEntries(outcomeKeys.map((outcomeKey) => {
         const owned = checks.filter((check) => check.outcome_key === outcomeKey);

package/dist/lib/long-task-outcome-parser.js

@@ -1,11 +1,18 @@
 import { parseCheck } from "./long-task-check-shape.js";
 import { normalizeRepositoryFile } from "./long-task-paths.js";
 import { parseRequirements } from "./long-task-requirement-shape.js";
-import { array, key, literal, nullable, object, parseBindings, parseControls, parseCounterfactuals, parseKeyedStatements, parseObligations, parseOwner, parsePopulation, parseRollback, repositoryPatterns, string, strings, } from "./long-task-delivery-shape.js";
+import { array, boolean, key, literal, nullable, object, parseBindings, parseControls, parseCounterfactuals, parseKeyedStatements, parseObligations, parseOwner, parsePopulation, parseRollback, repositoryPatterns, string, strings, } from "./long-task-delivery-shape.js";
 import { parseStrictYaml } from "./strict-codec.js";
+import { assertNoSemanticDriftMigration, semanticDriftOutcomeMigrationFields, } from "./long-task-semantic-drift-migration.js";
 export function parseOutcome(value, label) {
-    const row = object(value, label, ["key", "title", "product", "technical", "acceptance"], ["depends_on"]);
-    const product = object(row.product, `${label}.product`, ["observable_result", "owner"], ["requirements", "owner_surfaces", "controls", "non_completing_outcomes"]);
+    assertNoSemanticDriftMigration(semanticDriftOutcomeMigrationFields(value, label));
+    const row = object(value, label, ["key", "title", "stage", "product", "technical", "acceptance"], ["depends_on"]);
+    const product = object(row.product, `${label}.product`, [
+        "observable_result",
+        "success_path_required",
+        "degradation_path_required",
+        "owner",
+    ], ["requirements", "owner_surfaces", "controls", "non_completing_outcomes"]);
     const technical = object(row.technical, `${label}.technical`, ["expected_change_paths"], [
         "obligations",
         "allowed_support_paths",
@@ -18,11 +25,14 @@ export function parseOutcome(value, label) {
     return {
         key: key(row.key, `${label}.key`),
         title: string(row.title, `${label}.title`),
+        stage: key(row.stage, `${label}.stage`),
         depends_on: Object.hasOwn(row, "depends_on")
             ? strings(row.depends_on, `${label}.depends_on`).map((item, index) => key(item, `${label}.depends_on[${index}]`))
             : [],
         product: {
             observable_result: string(product.observable_result, `${label}.product.observable_result`),
+            success_path_required: boolean(product.success_path_required, `${label}.product.success_path_required`),
+            degradation_path_required: boolean(product.degradation_path_required, `${label}.product.degradation_path_required`),
             owner: parseOwner(product.owner, `${label}.product.owner`),
             requirements: Object.hasOwn(product, "requirements")
                 ? parseRequirements(product.requirements, `${label}.product.requirements`)
@@ -78,6 +88,7 @@ export function parseOutcomeFragment(raw, relative) {
         "outcomes",
         "key",
         "title",
+        "stage",
         "depends_on",
         "product",
         "technical",

package/dist/lib/long-task-playwright-evidence.d.ts

@@ -1,6 +1,7 @@
-import type { CompiledCheckV2 } from "./long-task-delivery-types.js";
+import type { CompiledCheckV2, EvidenceCapabilityRecordV2 } from "./long-task-delivery-types.js";
 export interface PlaywrightEvidence {
     observations: Record<string, unknown>;
+    evidence_records: EvidenceCapabilityRecordV2[];
     error: string | null;
 }
 export declare function extractPlaywrightEvidence(check: CompiledCheckV2, report: Record<string, unknown>, exitCode: number): PlaywrightEvidence;

package/dist/lib/long-task-playwright-evidence.js

@@ -61,7 +61,33 @@ export function extractPlaywrightEvidence(check, report, exitCode) {
         }
     }
     observations["playwright.case_ids"] = cases.map((item) => item.id).sort();
-    return { observations, error: null };
+    const evidenceRecords = [];
+    for (const item of cases) {
+        const assertion = [
+            ...check.positive_assertions,
+            ...check.negative_assertions,
+        ].find((candidate) => candidate.key === item.id);
+        if (assertion?.evidence_capabilities.includes("interaction_trace") &&
+            item.executed)
+            evidenceRecords.push({
+                assertion_key: assertion.key,
+                capability: "interaction_trace",
+                target_ref: check.execution_target.target_ref,
+                given_keys: item.given_keys,
+                action_keys: item.action_keys,
+            });
+        if (assertion?.evidence_capabilities.includes("target_runtime") &&
+            item.executed)
+            evidenceRecords.push({
+                assertion_key: assertion.key,
+                capability: "target_runtime",
+                target_ref: check.execution_target.target_ref,
+                root_entrypoint: check.execution_target_definition.root_entrypoint,
+                session_id: `playwright:${item.id}:${item.project_ids.join(",")}`,
+                cold_start: check.execution_target.entrypoint === "root",
+            });
+    }
+    return { observations, evidence_records: evidenceRecords, error: null };
 }
 function collectCases(report, declaredIds) {
     const cases = [];
@@ -139,6 +165,10 @@ function playwrightCase(id, test) {
         status === "expected" &&
         resultStatuses.length > 0 &&
         resultStatuses.at(-1) === "passed";
+    const traces = results.map((result) => scenarioTrace(result));
+    const givenKeys = traces[0]?.given_keys ?? [];
+    const actionKeys = traces[0]?.action_keys ?? [];
+    const traceConsistent = traces.every((trace) => same(trace.given_keys, givenKeys) && same(trace.action_keys, actionKeys));
     return {
         id,
         project_id: projectId,
@@ -150,6 +180,8 @@ function playwrightCase(id, test) {
         timed_out: timedOut,
         interrupted,
         status,
+        given_keys: traceConsistent ? givenKeys : [],
+        action_keys: traceConsistent ? actionKeys : [],
     };
 }
 function declaredCaseIds(check) {
@@ -227,6 +259,14 @@ function aggregateCases(instances) {
             unexpected_instances: unexpectedInstances,
             timed_out_instances: timedOutInstances,
             interrupted_instances: interruptedInstances,
+            given_keys: rows.length &&
+                rows.every((row) => same(row.given_keys, rows[0].given_keys))
+                ? rows[0].given_keys
+                : [],
+            action_keys: rows.length &&
+                rows.every((row) => same(row.action_keys, rows[0].action_keys))
+                ? rows[0].action_keys
+                : [],
         };
     })
         .sort((left, right) => left.id.localeCompare(right.id));
@@ -239,6 +279,34 @@ function record(value) {
 function integer(value) {
     return Number.isInteger(value) && Number(value) >= 0 ? Number(value) : null;
 }
+function scenarioTrace(result) {
+    const givenKeys = [];
+    const actionKeys = [];
+    const visit = (value) => {
+        if (!Array.isArray(value))
+            return;
+        for (const item of value) {
+            const step = record(item);
+            if (!step)
+                continue;
+            if (typeof step.title === "string") {
+                const given = /^\[given:([a-z0-9][a-z0-9-]*)\]$/u.exec(step.title);
+                const action = /^\[action:([a-z0-9][a-z0-9-]*)\]$/u.exec(step.title);
+                if (given)
+                    givenKeys.push(given[1]);
+                if (action)
+                    actionKeys.push(action[1]);
+            }
+            visit(step.steps);
+        }
+    };
+    visit(result.steps);
+    return { given_keys: givenKeys, action_keys: actionKeys };
+}
+function same(left, right) {
+    return (left.length === right.length &&
+        left.every((value, index) => value === right[index]));
+}
 function invalid(error) {
-    return { observations: {}, error };
+    return { observations: {}, evidence_records: [], error };
 }

package/dist/lib/long-task-progress.js

@@ -76,6 +76,10 @@ export function checkIdentity(check) {
         artifact_globs: check.artifact_globs,
         positive_assertions: check.positive_assertions,
         negative_assertions: check.negative_assertions,
+        journey_roles: check.journey_roles,
+        execution_target: check.execution_target,
+        execution_target_definition: check.execution_target_definition,
+        scenario: check.scenario,
         environment_requirements: check.environment_requirements,
     }));
 }

package/dist/lib/long-task-root-shape.d.ts

@@ -1,4 +1,5 @@
 import type { DeliveryContractV2 } from "./long-task-delivery-types.js";
 export declare function parseTask(value: unknown): DeliveryContractV2["task"];
+export declare function parseStages(value: unknown): DeliveryContractV2["stages"];
 export declare function parseRisk(value: unknown): DeliveryContractV2["risk"];
 export declare function parseGlobal(value: unknown): DeliveryContractV2["global"];

package/dist/lib/long-task-root-shape.js

@@ -1,6 +1,6 @@
 import { parseGlobalCounterfactuals } from "./long-task-acceptance-shape.js";
 import { parseCheck } from "./long-task-check-shape.js";
-import { array, key, literal, object, parseKeyedPaths, parseKeyedStatements, repositoryFiles, string, strings, } from "./long-task-delivery-shape.js";
+import { array, boolean, key, literal, object, parseKeyedPaths, parseKeyedStatements, repositoryFiles, string, strings, } from "./long-task-delivery-shape.js";
 const RISK_FACTS = [
     "public_api_or_schema_change",
     "persistent_data_change",
@@ -14,11 +14,59 @@ const RISK_FACTS = [
     "weak_observability",
 ];
 export function parseTask(value) {
-    const row = object(value, "task", ["id", "title", "goal", "source_paths", "context_refs"], ["context_snapshot_mode"]);
+    const row = object(value, "task", [
+        "id",
+        "title",
+        "goal",
+        "target_profile",
+        "execution_targets",
+        "source_paths",
+        "context_refs",
+    ], ["context_snapshot_mode"]);
+    const targetProfile = object(row.target_profile, "task.target_profile", [
+        "key",
+        "description",
+        "required_state",
+        "required_target_refs",
+    ]);
     return {
         id: key(row.id, "task.id"),
         title: string(row.title, "task.title"),
         goal: string(row.goal, "task.goal"),
+        target_profile: {
+            key: key(targetProfile.key, "task.target_profile.key"),
+            description: string(targetProfile.description, "task.target_profile.description"),
+            required_state: literal(targetProfile.required_state, [
+                "implementation_complete",
+                "target_profile_usable",
+                "production_release_ready",
+            ], "task.target_profile.required_state"),
+            required_target_refs: strings(targetProfile.required_target_refs, "task.target_profile.required_target_refs").map((item, index) => key(item, `task.target_profile.required_target_refs[${index}]`)),
+        },
+        execution_targets: array(row.execution_targets, "task.execution_targets").map((item, index) => {
+            const label = `task.execution_targets[${index}]`;
+            const target = object(item, label, [
+                "key",
+                "description",
+                "role",
+                "runtime_family",
+                "root_entrypoint",
+            ]);
+            return {
+                key: key(target.key, `${label}.key`),
+                description: string(target.description, `${label}.description`),
+                role: literal(target.role, ["product", "support", "observer"], `${label}.role`),
+                runtime_family: literal(target.runtime_family, [
+                    "browser",
+                    "native",
+                    "desktop",
+                    "service",
+                    "process",
+                    "external",
+                ], `${label}.runtime_family`),
+                root_entrypoint: string(target.root_entrypoint, `${label}.root_entrypoint`),
+            };
+        }),
         source_paths: repositoryFiles(row.source_paths, "task.source_paths"),
         context_refs: repositoryFiles(row.context_refs, "task.context_refs"),
         context_snapshot_mode: Object.hasOwn(row, "context_snapshot_mode")
@@ -26,6 +74,23 @@ export function parseTask(value) {
             : "referenced",
     };
 }
+export function parseStages(value) {
+    return array(value, "stages").map((item, index) => {
+        const label = `stages[${index}]`;
+        const row = object(item, label, [
+            "key",
+            "title",
+            "depends_on",
+            "gate_outcome",
+        ]);
+        return {
+            key: key(row.key, `${label}.key`),
+            title: string(row.title, `${label}.title`),
+            depends_on: strings(row.depends_on, `${label}.depends_on`).map((entry, dependencyIndex) => key(entry, `${label}.depends_on[${dependencyIndex}]`)),
+            gate_outcome: key(row.gate_outcome, `${label}.gate_outcome`),
+        };
+    });
+}
 export function parseRisk(value) {
     const row = object(value, "risk", ["facts"], ["requested_level"]);
     const facts = object(row.facts, "risk.facts", [], [...RISK_FACTS]);
@@ -73,11 +138,27 @@ export function parseGlobal(value) {
             external_confirmations: Object.hasOwn(acceptance, "external_confirmations")
                 ? array(acceptance.external_confirmations, "global.acceptance.external_confirmations").map((item, index) => {
                     const label = `global.acceptance.external_confirmations[${index}]`;
-                    const entry = object(item, label, ["key", "description", "owner"]);
+                    const entry = object(item, label, [
+                        "key",
+                        "description",
+                        "owner",
+                        "kind",
+                        "impact_claims",
+                        "blocks_target",
+                    ]);
                     return {
                         key: key(entry.key, `${label}.key`),
                         description: string(entry.description, `${label}.description`),
                         owner: string(entry.owner, `${label}.owner`),
+                        kind: literal(entry.kind, [
+                            "functional_prerequisite",
+                            "field_validation",
+                            "production_release_gate",
+                            "commercial_activation",
+                            "expert_authority",
+                        ], `${label}.kind`),
+                        impact_claims: strings(entry.impact_claims, `${label}.impact_claims`),
+                        blocks_target: boolean(entry.blocks_target, `${label}.blocks_target`),
                     };
                 })
                 : [],

package/dist/lib/long-task-runner-environment.js

@@ -23,7 +23,7 @@ const BASE_ENVIRONMENT_KEYS = [
 ];
 export function runnerEnvironment(requirements) {
     const environment = {
-        TY_CONTEXT_CHECK_PROTOCOL: "long-task-check-result-v2",
+        TY_CONTEXT_CHECK_PROTOCOL: "long-task-check-result-v3",
     };
     for (const key of BASE_ENVIRONMENT_KEYS)
         copyEnvironmentValue(environment, key);

package/dist/lib/long-task-runner-freeze.d.ts

@@ -1,2 +1,2 @@
-import type { CompiledCheckV2, DeliveryCheckV2, WorkspaceManifestV2 } from "./long-task-delivery-types.js";
-export declare function freezeDeliveryCheck(check: DeliveryCheckV2, outcomeKey: string | null, repository: string, baseline: WorkspaceManifestV2): Promise<CompiledCheckV2>;
+import type { CompiledCheckV2, DeliveryCheckV2, ExecutionTargetV2, WorkspaceManifestV2 } from "./long-task-delivery-types.js";
+export declare function freezeDeliveryCheck(check: DeliveryCheckV2, outcomeKey: string | null, repository: string, baseline: WorkspaceManifestV2, executionTarget: ExecutionTargetV2, knownExecutionTargets: ExecutionTargetV2[]): Promise<CompiledCheckV2>;

package/dist/lib/long-task-runner-freeze.js

@@ -7,7 +7,7 @@ import { nearestRunnerFile, npmCliPath, npxCliPath, } from "./long-task-runner-f
 import { canonicalValueJson, sha256Hex } from "./strict-codec.js";
 import { repoRelative, resolveInsideRepository, } from "./long-task-workspace.js";
 import { evidenceAdapterForRunner } from "./long-task-evidence-adapter-policy.js";
-export async function freezeDeliveryCheck(check, outcomeKey, repository, baseline) {
+export async function freezeDeliveryCheck(check, outcomeKey, repository, baseline, executionTarget, knownExecutionTargets) {
     const prefix = outcomeKey ? `CHECK.${outcomeKey}` : "CHECK.GLOBAL";
     const expectedOutputs = check.expected_output_paths.map((pattern, index) => assertRepositoryPattern(repository, pattern, `${check.key}.expected_output_paths[${index}]`));
     for (const [index, pattern] of check.input_paths.entries()) {
@@ -30,6 +30,8 @@ export async function freezeDeliveryCheck(check, outcomeKey, repository, baselin
         evidence_adapter: evidenceAdapterForRunner(check.runner.type),
         runner: await freezeRunner(check, repository, cwd, target, verificationInputHashes),
         verification_input_hashes: verificationInputHashes,
+        execution_target_definition: executionTarget,
+        known_execution_targets: knownExecutionTargets,
     };
     return {
         ...compiled,

package/dist/lib/long-task-runtime-types.d.ts

@@ -1,6 +1,8 @@
 import type { DeliveryCheckV2, DeliveryContractV2, DeliveryOutcomeV2, DeliveryRunnerV2, ProofSurface } from "./long-task-contract-types.js";
+import type { EvidenceCapabilityV2, ExecutionTargetV2 } from "./long-task-semantic-contract-types.js";
 import type { AuthorityHashesV2, ContextAuthoritySnapshotV2, InitialTaskBaseV2, NextAuthorityMaterialsV2, VerifierIdentityV2 } from "./long-task-authority-types.js";
 import type { EvidenceAdapter } from "./long-task-evidence-adapter-types.js";
+import type { EvidenceCapabilityRecordV2 } from "./long-task-evidence-capability-types.js";
 import type { EffectiveRiskLevel, RiskFactName } from "./long-task-risk-types.js";
 import type { CompiledSourceItemV2 } from "./long-task-source-authority-types.js";
 import type { WorkspaceManifestV2 } from "./long-task-workspace-runtime-types.js";
@@ -21,6 +23,8 @@ export interface CompiledCheckV2 extends Omit<DeliveryCheckV2, "runner"> {
     evidence_adapter: EvidenceAdapter;
     verification_input_hashes: Record<string, string>;
     raw_execution_identity: string;
+    execution_target_definition: ExecutionTargetV2;
+    known_execution_targets: ExecutionTargetV2[];
 }
 export interface ProductClaimV2 {
     id: string;
@@ -88,6 +92,7 @@ export interface CompiledDeliveryContractV2 {
     task: DeliveryContractV2["task"];
     risk: DeliveryContractV2["risk"];
     source_claims: DeliveryContractV2["source_claims"];
+    stages: DeliveryContractV2["stages"];
     global: Omit<DeliveryContractV2["global"], "acceptance"> & {
         acceptance: {
             checks: CompiledCheckV2[];
@@ -123,6 +128,8 @@ export interface AssertionResultV2 {
     passed: boolean;
     claims: string[];
     observation: string;
+    evidence_capabilities: EvidenceCapabilityV2[];
+    evidence_complete: boolean;
     status: "passed" | "observation_missing" | "observation_type_mismatch" | "assertion_value_mismatch";
     expected?: unknown;
     actual?: unknown;
@@ -133,6 +140,7 @@ export interface RawCommandExecutionV2 {
     execution_status: "completed" | "blocked_external" | "infrastructure_error" | "invalid_evidence";
     exit_code: number;
     observations: Record<string, unknown>;
+    evidence_records: EvidenceCapabilityRecordV2[];
     stdout_sha256: string;
     stderr_sha256: string;
     attempts: number;
@@ -148,6 +156,7 @@ export interface CheckExecutionResultV2 {
     execution_identity: string;
     assertion_results: AssertionResultV2[];
     observations: Record<string, unknown>;
+    evidence_records: EvidenceCapabilityRecordV2[];
     artifact_hashes: Record<string, string>;
     claim_proofs: ClaimProofV2[];
     findings: LongTaskFindingV2[];
@@ -185,12 +194,16 @@ export interface TargetedVerificationResultV2 {
     completed_at: string;
 }
 export type OutcomeStatusV2 = "unverified" | "progress_passing" | "progress_failing" | "progress_stale" | "blocked_external";
+export type StageStatusV2 = "locked" | "ready" | "unverified" | "progress_passing" | "progress_failing" | "progress_stale" | "blocked_external";
 export interface FinalReceiptV2 {
     schema_version: "long-task-final-receipt-v2";
     receipt_sha256: string;
     authority_scope: "audit_only";
     reusable_for_acceptance: false;
     workflow_status: "machine_accepted" | "machine_accepted_external_pending" | "needs_work" | "blocked_external";
+    target_profile: DeliveryContractV2["task"]["target_profile"];
+    target_state: DeliveryContractV2["task"]["target_profile"]["required_state"] | "not_accepted" | "blocked_external";
+    stage_results: Record<string, "passed" | "failed" | "blocked_external" | "blocked_dependency">;
     compiled_identity: string;
     contract_sha256: string;
     snapshot_sha256: string;

package/dist/lib/long-task-semantic-contract-types.d.ts

@@ -0,0 +1,36 @@
+export interface KeyedStatementV2 {
+    key: string;
+    statement: string;
+}
+export type ExternalConfirmationKindV2 = "functional_prerequisite" | "field_validation" | "production_release_gate" | "commercial_activation" | "expert_authority";
+export type TargetCompletionStateV2 = "implementation_complete" | "target_profile_usable" | "production_release_ready";
+export type ExecutionTargetRuntimeFamilyV2 = "browser" | "native" | "desktop" | "service" | "process" | "external";
+export interface TargetProfileV2 {
+    key: string;
+    description: string;
+    required_state: TargetCompletionStateV2;
+    required_target_refs: string[];
+}
+export interface ExecutionTargetV2 {
+    key: string;
+    description: string;
+    role: "product" | "support" | "observer";
+    runtime_family: ExecutionTargetRuntimeFamilyV2;
+    root_entrypoint: string;
+}
+export interface DeliveryStageV2 {
+    key: string;
+    title: string;
+    depends_on: string[];
+    gate_outcome: string;
+}
+export type DeliveryJourneyRoleV2 = "success" | "degradation" | "recovery" | "stage_gate" | "conformance";
+export type EvidenceCapabilityV2 = "presence" | "interaction_trace" | "state_delta" | "cross_surface_consistency" | "durable_readback" | "boundary_invocation" | "external_side_effect" | "failure_injection" | "visual_render" | "target_runtime" | "input_variation";
+export interface CheckExecutionTargetV2 {
+    target_ref: string;
+    entrypoint: "root" | "internal";
+}
+export interface DeliveryScenarioV2 {
+    given: KeyedStatementV2[];
+    when: KeyedStatementV2[];
+}

package/dist/lib/long-task-semantic-contract-types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/long-task-semantic-drift-migration.d.ts

@@ -0,0 +1,3 @@
+export declare function semanticDriftMigrationFields(value: unknown): string[];
+export declare function semanticDriftOutcomeMigrationFields(value: unknown, label: string): string[];
+export declare function assertNoSemanticDriftMigration(fields: string[]): void;

package/dist/lib/long-task-semantic-drift-migration.js

@@ -0,0 +1,68 @@
+export function semanticDriftMigrationFields(value) {
+    const root = row(value);
+    if (!root || root.schema_version !== "long-task-delivery-v2")
+        return [];
+    const missing = [];
+    required(root, "$", ["stages"], missing);
+    const task = row(root.task);
+    if (task) {
+        required(task, "task", ["target_profile", "execution_targets"], missing);
+        const profile = row(task.target_profile);
+        if (profile)
+            required(profile, "task.target_profile", ["required_target_refs"], missing);
+    }
+    for (const [index, outcome] of rows(root.outcomes).entries())
+        collectOutcome(outcome, `outcomes[${index}]`, missing);
+    const global = row(root.global);
+    const globalAcceptance = row(global?.acceptance);
+    collectChecks(globalAcceptance?.checks, "global.acceptance.checks", missing);
+    for (const [index, confirmation] of rows(globalAcceptance?.external_confirmations).entries())
+        required(confirmation, `global.acceptance.external_confirmations[${index}]`, ["kind", "impact_claims", "blocks_target"], missing);
+    return [...new Set(missing)].sort();
+}
+export function semanticDriftOutcomeMigrationFields(value, label) {
+    const missing = [];
+    const outcome = row(value);
+    if (outcome)
+        collectOutcome(outcome, label, missing);
+    return [...new Set(missing)].sort();
+}
+export function assertNoSemanticDriftMigration(fields) {
+    if (!fields.length)
+        return;
+    const detail = fields.slice(0, 24).join(",");
+    const suffix = fields.length > 24 ? `,+${fields.length - 24}-more` : "";
+    throw new Error(`long_task_delivery_v2_semantic_drift_migration_required:${detail}${suffix}`);
+}
+function collectOutcome(outcome, label, missing) {
+    required(outcome, label, ["stage"], missing);
+    const product = row(outcome.product);
+    if (product)
+        required(product, `${label}.product`, ["success_path_required", "degradation_path_required"], missing);
+    const acceptance = row(outcome.acceptance);
+    collectChecks(acceptance?.checks, `${label}.acceptance.checks`, missing);
+}
+function collectChecks(value, label, missing) {
+    for (const [index, check] of rows(value).entries()) {
+        const checkLabel = `${label}[${index}]`;
+        required(check, checkLabel, ["journey_roles", "execution_target", "scenario"], missing);
+        for (const polarity of ["positive_assertions", "negative_assertions"])
+            for (const [assertionIndex, assertion] of rows(check[polarity]).entries())
+                required(assertion, `${checkLabel}.${polarity}[${assertionIndex}]`, ["evidence_capabilities"], missing);
+    }
+}
+function required(value, label, keys, missing) {
+    for (const key of keys)
+        if (!Object.hasOwn(value, key))
+            missing.push(`${label}.${key}`);
+}
+function rows(value) {
+    return Array.isArray(value)
+        ? value.map(row).filter((item) => item !== null)
+        : [];
+}
+function row(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}

package/dist/lib/long-task-shape-primitives.d.ts

@@ -3,6 +3,7 @@ export declare function object(value: unknown, label: string, required: string[]
 export declare function array(value: unknown, label: string): unknown[];
 export declare function string(value: unknown, label: string): string;
 export declare function text(value: unknown, label: string): string;
+export declare function boolean(value: unknown, label: string): boolean;
 export declare function strings(value: unknown, label: string): string[];
 export declare function repositoryFile(value: unknown, label: string): string;
 export declare function repositoryFiles(value: unknown, label: string): string[];
@@ -14,4 +15,6 @@ export declare function literal<T extends string>(value: unknown, allowed: reado
 export declare function key(value: unknown, label: string): string;
 export declare function nullable<T>(value: unknown, parser: (value: unknown) => T): T | null;
 export declare const PROOF_SURFACES: readonly ["ui_browser", "runtime_behavior", "api_contract", "data_state", "security_boundary", "population_coverage", "implementation_structure"];
+export declare const JOURNEY_ROLES: readonly ["success", "degradation", "recovery", "stage_gate", "conformance"];
+export declare const EVIDENCE_CAPABILITIES: readonly ["presence", "interaction_trace", "state_delta", "cross_surface_consistency", "durable_readback", "boundary_invocation", "external_side_effect", "failure_injection", "visual_render", "target_runtime", "input_variation"];
 export declare function fail(label: string, message: string): never;

package/dist/lib/long-task-shape-primitives.js

@@ -27,6 +27,11 @@ export function text(value, label) {
         fail(label, "must be a string");
     return value;
 }
+export function boolean(value, label) {
+    if (typeof value !== "boolean")
+        fail(label, "must be a boolean");
+    return value;
+}
 export function strings(value, label) {
     return array(value, label).map((item, index) => string(item, `${label}[${index}]`));
 }
@@ -76,6 +81,26 @@ export const PROOF_SURFACES = [
     "population_coverage",
     "implementation_structure",
 ];
+export const JOURNEY_ROLES = [
+    "success",
+    "degradation",
+    "recovery",
+    "stage_gate",
+    "conformance",
+];
+export const EVIDENCE_CAPABILITIES = [
+    "presence",
+    "interaction_trace",
+    "state_delta",
+    "cross_surface_consistency",
+    "durable_readback",
+    "boundary_invocation",
+    "external_side_effect",
+    "failure_injection",
+    "visual_render",
+    "target_runtime",
+    "input_variation",
+];
 export function fail(label, message) {
     throw new Error(`delivery_contract_invalid:${label}:${message}`);
 }

package/dist/lib/long-task-stage-policy.d.ts

@@ -0,0 +1,4 @@
+import type { DeliveryContractV2 } from "./long-task-delivery-types.js";
+type Reporter = (message: string) => void;
+export declare function validateDeliveryStages(contract: DeliveryContractV2, report?: Reporter): void;
+export {};