@kontourai/flow-agents 0.1.1

package/evals/static/test_workflow_skills.sh

@@ -0,0 +1,1207 @@
+#!/usr/bin/env bash
+# test_workflow_skills.sh — Contract checks for workflow-system skills
+set -uo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+errors=0
+
+pass() { echo "  ✓ $1"; }
+fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
+
+require_file() {
+  local path="$1"
+  local label="$2"
+  if [[ -f "$path" ]]; then pass "$label exists"; else fail "$label missing"; fi
+}
+
+require_text() {
+  local path="$1"
+  local pattern="$2"
+  local label="$3"
+  if rg -q -- "$pattern" "$path"; then pass "$label"; else fail "$label"; fi
+}
+
+reject_text() {
+  local path="$1"
+  local pattern="$2"
+  local label="$3"
+  if rg -q -- "$pattern" "$path"; then fail "$label"; else pass "$label"; fi
+}
+
+reject_text_many() {
+  local pattern="$1"
+  local label="$2"
+  shift 2
+  if rg -q -- "$pattern" "$@"; then fail "$label"; else pass "$label"; fi
+}
+
+require_status() {
+  local expected="$1"
+  local label="$2"
+  shift 2
+  local output status
+  set +e
+  output="$("$@" 2>&1)"
+  status=$?
+  if [[ "$status" -eq "$expected" ]]; then
+    pass "$label"
+  else
+    fail "$label (expected exit $expected, got $status: $output)"
+  fi
+}
+
+echo "=== Workflow Skill Contract Checks ==="
+
+IDEA="$ROOT/skills/idea-to-backlog/SKILL.md"
+BUILDER_SHAPE="$ROOT/skills/builder-shape/SKILL.md"
+PULL="$ROOT/skills/pull-work/SKILL.md"
+DESIGN_PROBE="$ROOT/skills/design-probe/SKILL.md"
+PICKUP_PROBE="$ROOT/skills/pickup-probe/SKILL.md"
+EVIDENCE="$ROOT/skills/evidence-gate/SKILL.md"
+RELEASE="$ROOT/skills/release-readiness/SKILL.md"
+LEARNING="$ROOT/skills/learning-review/SKILL.md"
+DELIVER="$ROOT/skills/deliver/SKILL.md"
+PLAN_WORK="$ROOT/skills/plan-work/SKILL.md"
+EXECUTE_PLAN="$ROOT/skills/execute-plan/SKILL.md"
+REVIEW_WORK="$ROOT/skills/review-work/SKILL.md"
+VERIFY_WORK="$ROOT/skills/verify-work/SKILL.md"
+MAP="$ROOT/docs/skills-map.md"
+ROOT_CONTEXT="$ROOT/CONTEXT.md"
+CONTEXT_MAP="$ROOT/docs/context-map.md"
+USAGE_GUIDE="$ROOT/docs/workflow-usage-guide.md"
+EVAL_STRATEGY="$ROOT/docs/workflow-eval-strategy.md"
+SHARED_CONTRACTS_DOC="$ROOT/docs/workflow-shared-contracts.md"
+ARTIFACT_LIFECYCLE_DOC="$ROOT/docs/workflow-artifact-lifecycle.md"
+OPERATING_LAYERS_DOC="$ROOT/docs/operating-layers.md"
+DEVELOPER_ARCHITECTURE_DOC="$ROOT/docs/developer-architecture.md"
+GITIGNORE="$ROOT/.gitignore"
+BUILDER_BUILD_FLOW="$ROOT/kits/builder/flows/build.flow.json"
+FLOW_AGENTS_FLOW_ADR="$ROOT/docs/adr/0001-flow-agents-consumes-flow.md"
+ARTIFACT_CONTRACT="$ROOT/context/contracts/artifact-contract.md"
+PLANNING_CONTRACT="$ROOT/context/contracts/planning-contract.md"
+EXECUTION_CONTRACT="$ROOT/context/contracts/execution-contract.md"
+SANDBOX_CONTRACT="$ROOT/context/contracts/sandbox-policy.md"
+GOVERNANCE_ADAPTER_CONTRACT="$ROOT/context/contracts/governance-adapter-contract.md"
+WORK_ITEM_CONTRACT="$ROOT/context/contracts/work-item-contract.md"
+BUILDER_KIT_STATE_CONTRACT="$ROOT/context/contracts/builder-kit-workflow-state-contract.md"
+BUILDER_KIT_HAPPY_PATH_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/happy-path.json"
+BUILDER_KIT_RESUME_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json"
+BUILDER_KIT_PRODUCT_CHAIN_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/product-build-chaining.json"
+BUILDER_KIT_DIRECT_PRIMITIVE_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/direct-primitive-stop.json"
+BUILDER_KIT_MISSING_PRESTEP_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/missing-prestep-recovery.json"
+BUILDER_KIT_STALE_CONTINUATION_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/stale-continuation-requires-new-probe.json"
+BUILDER_KIT_EMPTY_BOARD_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/empty-board-route-shape.json"
+BUILDER_KIT_BASELINE_FRESHNESS_HINT_FIXTURE="$ROOT/evals/fixtures/builder-kit-workflow-state/baseline-freshness-resolution-hint.json"
+PULL_WORK_PERSONAL_WIP_FIXTURE="$ROOT/evals/fixtures/pull-work-wip-shepherding/personal-wip-blocks.json"
+PULL_WORK_GLOBAL_WIP_FIXTURE="$ROOT/evals/fixtures/pull-work-wip-shepherding/global-wip-informs.json"
+BACKLOG_PROVIDER_SETTINGS="$ROOT/context/settings/backlog-provider-settings.json"
+BACKLOG_PROVIDER_SETTINGS_SCHEMA="$ROOT/schemas/backlog-provider-settings.schema.json"
+VERIFICATION_CONTRACT="$ROOT/context/contracts/verification-contract.md"
+REVIEW_CONTRACT="$ROOT/context/contracts/review-contract.md"
+DELIVERY_CONTRACT="$ROOT/context/contracts/delivery-contract.md"
+EFFECTIVE_BACKLOG_SETTINGS="$ROOT/src/cli/effective-backlog-settings.ts"
+PULL_WORK_PROVIDER="$ROOT/src/cli/pull-work-provider.ts"
+PULL_WORK_PROVIDER_INTEGRATION="$ROOT/evals/integration/test_pull_work_provider.sh"
+PACKAGE_MANIFEST="$ROOT/packaging/manifest.json"
+PACKS_MANIFEST="$ROOT/packaging/packs.json"
+TOOL_PLANNER="$ROOT/agents/tool-planner.json"
+TOOL_WORKER="$ROOT/agents/tool-worker.json"
+TOOL_CODE_REVIEWER="$ROOT/agents/tool-code-reviewer.json"
+TOOL_SECURITY_REVIEWER="$ROOT/agents/tool-security-reviewer.json"
+TOOL_DEPENDENCIES_UPDATER="$ROOT/agents/tool-dependencies-updater.json"
+TOOL_VERIFIER="$ROOT/agents/tool-verifier.json"
+DEV_PROMPTFOO="$ROOT/evals/cases/dev/promptfooconfig.yaml"
+GOAL_FIT_HOOK="$ROOT/scripts/hooks/stop-goal-fit.js"
+WORKFLOW_STEERING_HOOK="$ROOT/scripts/hooks/workflow-steering.js"
+CONTEXT_MAP_GENERATOR="$ROOT/src/tools/generate-context-map.ts"
+PACK_FILTER="$ROOT/src/tools/filter-installed-packs.ts"
+PROMOTE_DOC="$ROOT/src/cli/promote-workflow-artifact.ts"
+ARTIFACT_VALIDATOR="$ROOT/src/cli/validate-workflow-artifacts.ts"
+SIDECAR_WRITER="$ROOT/src/cli/workflow-sidecar.ts"
+RELEASE_SCHEMA="$ROOT/schemas/workflow-release.schema.json"
+LEARNING_SCHEMA="$ROOT/schemas/workflow-learning.schema.json"
+ARTIFACT_INTEGRATION="$ROOT/evals/integration/test_workflow_artifacts.sh"
+SIDECAR_WRITER_INTEGRATION="$ROOT/evals/integration/test_workflow_sidecar_writer.sh"
+WORKFLOW_STEERING_INTEGRATION="$ROOT/evals/integration/test_workflow_steering_hook.sh"
+HOOK_INFLUENCE_INTEGRATION="$ROOT/evals/integration/test_hook_influence_cases.sh"
+HOOK_INFLUENCE_CASES="$ROOT/evals/fixtures/hook-influence/cases.json"
+HOOK_INFLUENCE_VALIDATOR="$ROOT/src/cli/validate-hook-influence.ts"
+CONTEXT_MAP_INTEGRATION="$ROOT/evals/integration/test_context_map.sh"
+PAGES_WORKFLOW="$ROOT/.github/workflows/docs-pages.yml"
+CI_WORKFLOW="$ROOT/.github/workflows/ci.yml"
+CI_BASELINE="$ROOT/evals/ci/run-baseline.sh"
+PAGES_INDEX="$ROOT/docs/index.md"
+KIT_REPOSITORY_DOC="$ROOT/docs/flow-kit-repository-contract.md"
+KIT_REPOSITORY_INTEGRATION="$ROOT/evals/integration/test_flow_kit_repository.sh"
+SANDBOX_DOC="$ROOT/docs/sandbox-policy.md"
+VERITAS_DOC="$ROOT/docs/veritas-integration.md"
+PAGES_CONFIG="$ROOT/docs/_config.yml"
+PAGES_LAYOUT="$ROOT/docs/_layouts/default.html"
+PAGES_CSS="$ROOT/docs/assets/site.css"
+PAGES_JS="$ROOT/docs/assets/site.js"
+
+ACTIVE_GUIDANCE_SURFACES=()
+while IFS= read -r guidance_surface; do
+  ACTIVE_GUIDANCE_SURFACES+=("$guidance_surface")
+done < <(
+  {
+    find "$ROOT/skills" -type f -name '*.md'
+    find "$ROOT/context/contracts" -maxdepth 1 -type f -name '*.md'
+    find "$ROOT/agents" -maxdepth 1 -type f -name '*.json'
+    printf '%s\n' "$ROOT/packaging/manifest.json"
+    find "$ROOT/docs" -maxdepth 1 -type f \( -name 'workflow-*.md' -o -name 'skills-map.md' \)
+  } | sort -u
+)
+
+require_file "$IDEA" "idea-to-backlog skill"
+require_file "$BUILDER_SHAPE" "builder-shape skill"
+require_file "$PULL" "pull-work skill"
+require_file "$DESIGN_PROBE" "design-probe skill"
+require_file "$PICKUP_PROBE" "pickup-probe skill"
+require_file "$EVIDENCE" "evidence-gate skill"
+require_file "$RELEASE" "release-readiness skill"
+require_file "$LEARNING" "learning-review skill"
+require_file "$DELIVER" "deliver skill"
+require_file "$PLAN_WORK" "plan-work skill"
+require_file "$EXECUTE_PLAN" "execute-plan skill"
+require_file "$REVIEW_WORK" "review-work skill"
+require_file "$VERIFY_WORK" "verify-work skill"
+require_file "$MAP" "skills map"
+require_file "$ROOT_CONTEXT" "Flow Agents context glossary"
+require_file "$CONTEXT_MAP" "context map"
+require_file "$USAGE_GUIDE" "workflow usage guide"
+require_file "$EVAL_STRATEGY" "workflow eval strategy"
+require_file "$SHARED_CONTRACTS_DOC" "shared workflow contracts doc"
+require_file "$ARTIFACT_LIFECYCLE_DOC" "workflow artifact lifecycle doc"
+require_file "$OPERATING_LAYERS_DOC" "operating layers doc"
+require_file "$DEVELOPER_ARCHITECTURE_DOC" "developer architecture doc"
+require_file "$BUILDER_BUILD_FLOW" "Builder Kit build Flow Definition"
+require_file "$FLOW_AGENTS_FLOW_ADR" "Flow Agents Flow boundary ADR"
+require_file "$ARTIFACT_CONTRACT" "artifact contract"
+require_file "$PLANNING_CONTRACT" "planning contract"
+require_file "$EXECUTION_CONTRACT" "execution contract"
+require_file "$SANDBOX_CONTRACT" "sandbox policy contract"
+require_file "$GOVERNANCE_ADAPTER_CONTRACT" "governance adapter contract"
+require_file "$WORK_ITEM_CONTRACT" "work item contract"
+require_file "$BACKLOG_PROVIDER_SETTINGS" "backlog provider settings"
+require_file "$BACKLOG_PROVIDER_SETTINGS_SCHEMA" "backlog provider settings schema"
+require_file "$VERIFICATION_CONTRACT" "verification contract"
+require_file "$REVIEW_CONTRACT" "review contract"
+require_file "$DELIVERY_CONTRACT" "delivery contract"
+require_file "$PACKAGE_MANIFEST" "packaging manifest"
+require_file "$PACKS_MANIFEST" "pack manifest"
+require_file "$TOOL_PLANNER" "tool-planner agent"
+require_file "$TOOL_WORKER" "tool-worker agent"
+require_file "$TOOL_CODE_REVIEWER" "tool-code-reviewer agent"
+require_file "$TOOL_SECURITY_REVIEWER" "tool-security-reviewer agent"
+require_file "$TOOL_DEPENDENCIES_UPDATER" "tool-dependencies-updater agent"
+require_file "$TOOL_VERIFIER" "tool-verifier agent"
+require_file "$DEV_PROMPTFOO" "dev behavioral eval config"
+require_file "$GOAL_FIT_HOOK" "goal-fit stop hook"
+require_file "$WORKFLOW_STEERING_HOOK" "workflow steering hook"
+require_file "$CONTEXT_MAP_GENERATOR" "context map generator"
+require_file "$PACK_FILTER" "pack filter helper"
+require_file "$EFFECTIVE_BACKLOG_SETTINGS" "effective backlog settings helper"
+require_file "$PULL_WORK_PROVIDER" "pull-work provider normalizer"
+require_file "$PULL_WORK_PROVIDER_INTEGRATION" "pull-work provider integration test"
+require_file "$PROMOTE_DOC" "workflow artifact promotion helper"
+require_file "$ARTIFACT_VALIDATOR" "workflow artifact validator"
+require_file "$SIDECAR_WRITER" "workflow sidecar writer"
+require_file "$RELEASE_SCHEMA" "workflow release schema"
+require_file "$LEARNING_SCHEMA" "workflow learning schema"
+require_file "$ARTIFACT_INTEGRATION" "workflow artifact integration test"
+require_file "$SIDECAR_WRITER_INTEGRATION" "workflow sidecar writer integration test"
+require_file "$WORKFLOW_STEERING_INTEGRATION" "workflow steering integration test"
+require_file "$HOOK_INFLUENCE_INTEGRATION" "hook influence integration test"
+require_file "$HOOK_INFLUENCE_CASES" "hook influence behavioral cases"
+require_file "$HOOK_INFLUENCE_VALIDATOR" "hook influence case validator"
+require_file "$CONTEXT_MAP_INTEGRATION" "context map integration test"
+require_file "$PAGES_WORKFLOW" "GitHub Pages workflow"
+require_file "$PAGES_INDEX" "docs index page"
+require_file "$KIT_REPOSITORY_DOC" "Flow Kit repository contract doc"
+require_file "$KIT_REPOSITORY_INTEGRATION" "Flow Kit repository integration test"
+require_file "$SANDBOX_DOC" "sandbox policy doc"
+require_file "$VERITAS_DOC" "Veritas integration boundary doc"
+require_file "$PAGES_CONFIG" "docs Jekyll config"
+require_file "$PAGES_LAYOUT" "docs Jekyll layout"
+require_file "$PAGES_CSS" "docs shared CSS"
+require_file "$PAGES_JS" "docs shared JS"
+
+echo ""
+echo "--- shared contracts ---"
+require_text "$ARTIFACT_CONTRACT" 'Workflow Artifact Contract' "artifact contract has title"
+require_text "$ARTIFACT_CONTRACT" 'role: plan' "artifact contract defines plan frontmatter"
+require_text "$ARTIFACT_CONTRACT" 'verdict: PASS \| PARTIAL \| FAIL \| NOT_VERIFIED' "artifact contract defines review verdicts"
+require_text "$ARTIFACT_CONTRACT" 'Legacy bare strings are not part of the schema contract' "artifact contract rejects legacy string evidence refs"
+require_text "$ARTIFACT_CONTRACT" 'Acceptance Evidence' "artifact contract requires Acceptance Evidence table"
+require_text "$ARTIFACT_CONTRACT" 'blob/<commit-sha>' "artifact contract requires immutable GitHub blob permalink guidance"
+require_text "$PLANNING_CONTRACT" 'Definition Of Done' "planning contract defines Definition Of Done"
+require_text "$PLANNING_CONTRACT" 'Stop-short risks' "planning contract defines stop-short risks"
+require_text "$PLANNING_CONTRACT" 'Source Evidence / Permalinks' "planning contract requires source evidence permalink expectations"
+require_text "$EXECUTION_CONTRACT" 'Parallel Wave Rules' "execution contract defines parallel wave rules"
+require_text "$EXECUTION_CONTRACT" 'modified files are recorded' "execution contract requires modified files"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'current-state dashboard' "artifact lifecycle defines local current-state role"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Learning records are a routing surface' "artifact lifecycle defines learning routing semantics"
+require_text "$ARTIFACT_LIFECYCLE_DOC" '14-30 days' "artifact lifecycle documents local retention window"
+require_text "$USAGE_GUIDE" 'do not leave `state.status: verified`' "usage guide requires final acceptance to close verified state"
+require_text "$USAGE_GUIDE" 'followup_required' "usage guide documents learning follow-up closeout"
+require_text "$SANDBOX_CONTRACT" 'Sandbox Policy Contract' "sandbox policy contract has title"
+require_text "$SANDBOX_CONTRACT" 'local-read-only' "sandbox contract defines local read-only mode"
+require_text "$SANDBOX_CONTRACT" 'local-edit' "sandbox contract defines local edit mode"
+require_text "$SANDBOX_CONTRACT" 'worktree' "sandbox contract defines worktree mode"
+require_text "$SANDBOX_CONTRACT" 'container' "sandbox contract defines container mode"
+require_text "$SANDBOX_CONTRACT" 'cloud-sandbox' "sandbox contract defines cloud sandbox mode"
+require_text "$SANDBOX_CONTRACT" 'privileged-integration' "sandbox contract defines privileged integration mode"
+require_text "$SANDBOX_CONTRACT" 'Stop for approval' "sandbox contract defines approval stop rule"
+require_text "$GOVERNANCE_ADAPTER_CONTRACT" 'Governance Adapter Contract' "governance adapter contract has title"
+require_text "$GOVERNANCE_ADAPTER_CONTRACT" 'Veritas Boundary' "governance adapter contract defines Veritas boundary"
+require_text "$GOVERNANCE_ADAPTER_CONTRACT" 'standard_refs' "governance adapter contract maps to standard refs"
+require_text "$WORK_ITEM_CONTRACT" 'Work Item Contract' "work item contract has title"
+require_text "$WORK_ITEM_CONTRACT" '`id`' "work item contract defines id"
+require_text "$WORK_ITEM_CONTRACT" '`title`' "work item contract defines title"
+require_text "$WORK_ITEM_CONTRACT" '`body`' "work item contract defines body"
+require_text "$WORK_ITEM_CONTRACT" '`status`' "work item contract defines status"
+require_text "$WORK_ITEM_CONTRACT" 'labels.*tags' "work item contract defines labels/tags"
+require_text "$WORK_ITEM_CONTRACT" '`priority`' "work item contract defines priority"
+require_text "$WORK_ITEM_CONTRACT" '`size`' "work item contract defines size"
+require_text "$WORK_ITEM_CONTRACT" '`risk`' "work item contract defines risk"
+require_text "$WORK_ITEM_CONTRACT" '`blockers`' "work item contract defines blockers"
+require_text "$WORK_ITEM_CONTRACT" 'related_links' "work item contract defines related links"
+require_text "$WORK_ITEM_CONTRACT" 'source_provider' "work item contract defines source provider"
+require_text "$WORK_ITEM_CONTRACT" 'project_membership.*board_membership' "work item contract defines project/board membership"
+require_text "$WORK_ITEM_CONTRACT" 'pr_links' "work item contract defines PR links"
+require_text "$WORK_ITEM_CONTRACT" 'artifact_refs' "work item contract defines artifact refs"
+require_text "$WORK_ITEM_CONTRACT" '`issues`' "work item contract defines issues capability"
+require_text "$WORK_ITEM_CONTRACT" '`projects_boards`' "work item contract defines projects/boards capability"
+require_text "$WORK_ITEM_CONTRACT" '`status_fields`' "work item contract defines status fields capability"
+require_text "$WORK_ITEM_CONTRACT" '`custom_fields`' "work item contract defines custom fields capability"
+require_text "$WORK_ITEM_CONTRACT" '`dependencies`' "work item contract defines dependencies capability"
+require_text "$WORK_ITEM_CONTRACT" '`milestones`' "work item contract defines milestones capability"
+require_text "$WORK_ITEM_CONTRACT" '`assignees`' "work item contract defines assignees capability"
+require_text "$WORK_ITEM_CONTRACT" '`comments`' "work item contract defines comments capability"
+require_text "$WORK_ITEM_CONTRACT" 'GitHub Issues as `WorkItemProvider`' "work item contract maps GitHub Issues as WorkItemProvider"
+require_text "$WORK_ITEM_CONTRACT" 'GitHub Projects as `BoardProvider`' "work item contract maps GitHub Projects as BoardProvider"
+require_text "$WORK_ITEM_CONTRACT" 'planned_base_sha' "work item contract records planned base sha"
+require_text "$WORK_ITEM_CONTRACT" 'scope_drift' "work item contract defines scope drift"
+require_text "$WORK_ITEM_CONTRACT" 'contract_drift' "work item contract defines contract drift"
+require_text "$VERIFICATION_CONTRACT" 'Report-Only Rule' "verification contract is report-only"
+require_text "$VERIFICATION_CONTRACT" 'NOT_VERIFIED' "verification contract treats NOT_VERIFIED as first-class"
+require_text "$VERIFICATION_CONTRACT" 'A technically green build is not enough' "verification contract preserves usefulness gate"
+require_text "$DELIVERY_CONTRACT" 'Goal Fit Gate' "delivery contract defines Goal Fit Gate"
+require_text "$DELIVERY_CONTRACT" 'Final Acceptance' "delivery contract defines Final Acceptance"
+require_text "$DELIVERY_CONTRACT" 'Publish verified changes before release readiness' "delivery contract requires publish-change before release readiness"
+require_text "$DELIVERY_CONTRACT" 'verified diff committed and pushed' "final acceptance requires committed and pushed diff"
+require_text "$DELIVERY_CONTRACT" 'provider change record created or updated' "final acceptance requires provider change or explicit no-provider-change reason"
+require_text "$DELIVERY_CONTRACT" 'local `\.flow-agents/` runtime artifacts remain untracked' "final acceptance requires runtime artifacts stay untracked"
+require_text "$DELIVERY_CONTRACT" 'GitHub PRs are the first `ChangeProvider` adapter example' "delivery contract keeps GitHub PR as adapter example"
+require_text "$DELIVERY_CONTRACT" 'Delegation Gates' "delivery contract defines delegation gates"
+require_text "$DELIVERY_CONTRACT" 'Do not replace the delegate gate with a local summary' "delivery contract forbids local gate substitution"
+require_text "$DELIVERY_CONTRACT" 'name the exact delegate ids' "delivery contract requires auditable delegate names"
+require_text "$DELIVERY_CONTRACT" 'Codex, Kiro, Claude Code' "delivery contract is cross-distribution"
+require_text "$SHARED_CONTRACTS_DOC" 'context/contracts/' "shared contracts doc names contract directory"
+require_text "$SHARED_CONTRACTS_DOC" 'workflow-artifact-lifecycle.md' "shared contracts doc links artifact lifecycle"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Workflow Artifact Lifecycle' "artifact lifecycle doc has title"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Runtime state remains ignored' "artifact lifecycle doc keeps runtime artifacts local"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Durable closeout content' "artifact lifecycle doc requires closeout"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'durable planning, decisions, evidence pointers, and acceptance notes' "artifact lifecycle doc requires durable promotion"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Promote by ownership' "artifact lifecycle doc defines promotion targets"
+require_text "$ARTIFACT_CONTRACT" 'Do not commit local workflow runtime roots such as `\.flow-agents/<slug>/`' "artifact contract forbids committing runtime workspaces"
+require_text "$OPERATING_LAYERS_DOC" 'workflow-artifact-lifecycle.md' "operating layers links artifact lifecycle"
+require_text "$PAGES_INDEX" 'workflow-artifact-lifecycle.html' "docs index links artifact lifecycle"
+require_text "$PAGES_INDEX" 'developer-architecture.html' "docs index links developer architecture"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Flow Agents' "developer architecture names Flow Agents"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Flow' "developer architecture names Flow"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Surface' "developer architecture names Surface"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Veritas' "developer architecture names Veritas"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Builder Kit' "developer architecture names Builder Kit"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Current state' "developer architecture labels current-state claims"
+require_text "$DEVELOPER_ARCHITECTURE_DOC" 'Future direction' "developer architecture labels future-direction claims"
+if [[ "$(rg -c '^```mermaid$' "$DEVELOPER_ARCHITECTURE_DOC")" -ge 2 ]]; then
+  pass "developer architecture includes at least two Mermaid diagrams"
+else
+  fail "developer architecture includes at least two Mermaid diagrams"
+fi
+require_text "$GITIGNORE" '^\.flow-agents/\*' "gitignore ignores Flow Agents runtime artifacts"
+require_text "$GITIGNORE" '^\.surface/$' "gitignore treats Surface runtime root as local state"
+reject_text "$ROOT/scripts/README.md" 'transcript-to-oar.sh' "scripts README omits removed transcript helper"
+require_text "$ROOT_CONTEXT" '### Flow' "Flow Agents glossary defines Flow"
+require_text "$ROOT_CONTEXT" '### Workflow Enforcement' "Flow Agents glossary defines workflow enforcement"
+require_text "$ROOT_CONTEXT" '### Runtime Portability' "Flow Agents glossary defines runtime portability"
+require_text "$FLOW_AGENTS_FLOW_ADR" 'Flow Agents will consume Kontour Flow' "Flow Agents ADR consumes Flow"
+require_text "$FLOW_AGENTS_FLOW_ADR" 'Veritas remains an optional development governance evidence provider' "Flow Agents ADR keeps Veritas provider boundary"
+
+echo ""
+echo "--- contract wiring ---"
+require_text "$PLAN_WORK" 'context/contracts/planning-contract.md' "plan-work references planning contract"
+require_text "$PLAN_WORK" 'context/contracts/artifact-contract.md' "plan-work references artifact contract"
+require_text "$DELIVER" 'context/contracts/delivery-contract.md' "deliver references delivery contract"
+require_text "$DELIVER" 'context/contracts/verification-contract.md' "deliver references verification contract"
+require_text "$PULL" 'context/contracts/sandbox-policy.md' "pull-work references sandbox policy contract"
+require_text "$PULL" 'context/contracts/work-item-contract.md' "pull-work references work item contract"
+require_text "$PULL" 'WorkItemProvider' "pull-work uses work item provider role"
+require_text "$PULL" 'BoardProvider' "pull-work uses board provider role"
+require_text "$PULL" 'Do not implement provider settings, provider configuration, or configured-provider discovery' "pull-work avoids provider settings and discovery implementation"
+require_text "$PULL" 'npm run effective-backlog-settings' "pull-work checks effective backlog settings"
+require_text "$PULL" 'status: configured' "pull-work consumes configured provider settings"
+require_text "$PULL" 'status: ask_user' "pull-work asks for providers when settings are absent"
+require_text "$PULL" 'npm run pull-work-provider' "pull-work normalizes provider items"
+require_text "$PULL" 'related-only' "pull-work classifies related-only items"
+require_text "$PULL" 'flow validate-definition <path> --json' "pull-work delegates Flow Definition validation to Flow"
+require_text "$PULL" 'fetch the latest target ref' "pull-work requires latest target ref fetch before freshness checks"
+require_text "$PULL" 'compare the current target SHA to the work item.*planned_base_sha' "pull-work compares current target SHA to planned_base_sha"
+require_text "$PULL" 'commits-since' "pull-work records commits-since"
+require_text "$PULL" 'planned age' "pull-work records planned age"
+require_text "$PULL" 'changed-file intersections with `planning_scope_refs`' "pull-work records planning scope intersections"
+require_text "$PULL" 'Classify revision freshness as' "pull-work classifies revision freshness"
+require_text "$PULL" '`fresh`' "pull-work documents fresh classification"
+require_text "$PULL" '`drifted`' "pull-work documents drifted classification"
+require_text "$PULL" '`stale`' "pull-work documents stale classification"
+require_text "$PULL" '`stale`.*route back to `idea-to-backlog`' "pull-work routes stale freshness to idea-to-backlog"
+require_text "$PULL" 'Missing `planned_base_sha` is not fresh' "pull-work preserves missing planned_base_sha gap"
+require_text "$PULL" 'NOT_VERIFIED.*accepted-gap baseline' "pull-work records missing baseline as NOT_VERIFIED or accepted gap"
+require_text "$PLAN_WORK" 'revision_freshness' "plan-work consumes upstream revision freshness"
+require_text "$PLAN_WORK" 'current target ref/SHA' "plan-work requires latest target ref/SHA confirmation"
+require_text "$PLAN_WORK" 'accepted-gap baseline for missing historical `planned_base_sha`' "plan-work allows accepted-gap missing planned_base_sha baseline"
+require_text "$PLAN_WORK" 'Missing `planned_base_sha` is never fresh' "plan-work does not treat missing planned_base_sha as fresh"
+require_text "$PLAN_WORK" 'baseline freshness is missing or `NOT_VERIFIED`, record the gap and stop planning unless it has been explicitly accepted as a fallback baseline naming the current target ref/SHA plus provider history or equivalent' "plan-work blocks unresolved baseline freshness"
+require_text "$PLAN_WORK" '`stale`.*route.*`idea-to-backlog`' "plan-work routes stale provider-backed work back to idea-to-backlog"
+require_text "$PLAN_WORK" 'structured evidence ref object' "plan-work requires structured evidence refs"
+require_text "$PLAN_WORK" 'Acceptance Evidence' "plan-work requires Acceptance Evidence comments"
+require_text "$PLAN_WORK" 'each upstream AC id revalidated against drift' "plan-work requires AC revalidation against drift"
+require_text "$PLAN_WORK" 'stale assumptions' "plan-work requires stale assumption findings"
+require_text "$PLANNING_CONTRACT" 'Baseline and AC revalidation' "planning contract defines baseline and AC revalidation section"
+require_text "$PLANNING_CONTRACT" 'Current target.*latest target ref/SHA' "planning contract records latest target ref/SHA"
+require_text "$PLANNING_CONTRACT" 'revision_freshness' "planning contract records source freshness"
+require_text "$PLANNING_CONTRACT" 'missing historical `planned_base_sha`' "planning contract records accepted-gap missing planned_base_sha baseline"
+require_text "$PLANNING_CONTRACT" 'AC revalidation against drift' "planning contract requires AC revalidation against drift"
+require_text "$PLANNING_CONTRACT" 'Stale assumptions' "planning contract records stale assumptions"
+require_text "$PLANNING_CONTRACT" 'route stale shaped work back to idea-to-backlog' "planning contract records stale route-back behavior"
+require_text "$KIT_REPOSITORY_DOC" 'npm run validate:source -- --kit' "kit repository doc includes local validation command"
+require_text "$KIT_REPOSITORY_DOC" 'Flow Agents validates the repository shape' "kit repository doc states Flow Agents boundary"
+require_text "$KIT_REPOSITORY_DOC" 'Flow validates Flow Definition semantics' "kit repository doc states Flow boundary"
+require_text "$KIT_REPOSITORY_DOC" 'schema_version' "kit repository doc defines schema version"
+require_text "$KIT_REPOSITORY_DOC" 'flows' "kit repository doc defines declared Flow Definitions"
+require_text "$KIT_REPOSITORY_DOC" '[Aa]bsolute paths are rejected' "kit repository doc defines path safety"
+require_text "$KIT_REPOSITORY_DOC" 'does not install remote kits' "kit repository doc states remote install non-goal"
+require_text "$PAGES_INDEX" 'Quick Start' "docs index presents product quick start"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'valid-local-kit' "kit repository integration covers valid fixture"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-schema-version' "kit repository integration covers invalid schema version"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-missing-schema-version' "kit repository integration covers missing schema version"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-missing-id' "kit repository integration covers missing id"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-absolute-path' "kit repository integration covers absolute path"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-traversal' "kit repository integration covers path traversal"
+require_text "$KIT_REPOSITORY_INTEGRATION" 'invalid-duplicate-flow' "kit repository integration covers duplicate entries"
+require_text "$EFFECTIVE_BACKLOG_SETTINGS" 'WorkItemProvider' "effective backlog settings helper reports WorkItemProvider"
+require_text "$EFFECTIVE_BACKLOG_SETTINGS" 'BoardProvider' "effective backlog settings helper reports BoardProvider"
+require_text "$PULL_WORK_PROVIDER" 'source_provider' "pull-work provider preserves source provider refs"
+require_text "$PULL_WORK_PROVIDER" 'board_membership' "pull-work provider preserves board membership"
+require_text "$PULL_WORK_PROVIDER" 'blockers' "pull-work provider preserves blockers"
+require_text "$PULL_WORK_PROVIDER" 'pr_links' "pull-work provider preserves PR links"
+require_text "$PULL_WORK_PROVIDER" 'artifact_refs' "pull-work provider preserves artifact refs"
+require_text "$PULL_WORK_PROVIDER" 'related-only' "pull-work provider classifies related-only items"
+require_text "$PULL_WORK_PROVIDER" 'in_progress' "pull-work provider classifies in-progress items"
+require_text "$PULL_WORK_PROVIDER_INTEGRATION" '#22 ready when flow#2 is closed' "pull-work provider integration proves resolved dependency readiness"
+require_text "$PULL_WORK_PROVIDER_INTEGRATION" '#22 blocked when flow#2 state is unknown' "pull-work provider integration proves unresolved dependency blocking"
+require_text "$BACKLOG_PROVIDER_SETTINGS" '"owner": "kontourai"' "repo backlog settings use kontourai owner"
+require_text "$BACKLOG_PROVIDER_SETTINGS" '"name": "flow-agents"' "repo backlog settings use flow-agents repo"
+require_text "$BACKLOG_PROVIDER_SETTINGS" '"number": 1' "repo backlog settings use GitHub Project 1"
+require_text "$BACKLOG_PROVIDER_SETTINGS" '"prefer_finishing_active_work": true' "repo backlog settings include WIP policy"
+require_text "$PLAN_WORK" 'context/contracts/sandbox-policy.md' "plan-work references sandbox policy contract"
+require_text "$EXECUTION_CONTRACT" 'context/contracts/sandbox-policy.md' "execution contract references sandbox policy contract"
+require_text "$EVIDENCE" 'context/contracts/governance-adapter-contract.md' "evidence-gate references governance adapter contract"
+require_text "$VERIFICATION_CONTRACT" 'context/contracts/governance-adapter-contract.md' "verification contract references governance adapter contract"
+require_text "$SANDBOX_DOC" 'context/contracts/sandbox-policy.md' "sandbox doc links canonical contract"
+require_text "$VERITAS_DOC" 'Veritas owns repo-local standards, authority, and evidence-check semantics' "Veritas doc defines ownership boundary"
+require_text "$ROOT/docs/north-star.md" 'Flow owns generic process transparency' "north star defines Flow ownership"
+require_text "$VERITAS_DOC" 'standard_refs' "Veritas doc maps output to evidence refs"
+require_text "$VERIFY_WORK" 'context/contracts/verification-contract.md' "verify-work references verification contract"
+require_text "$VERIFY_WORK" 'context/contracts/artifact-contract.md' "verify-work references artifact contract"
+require_text "$TOOL_PLANNER" 'context/contracts/planning-contract.md' "tool-planner references planning contract"
+require_text "$TOOL_WORKER" 'context/contracts/execution-contract.md' "tool-worker references execution contract"
+require_text "$TOOL_VERIFIER" 'context/contracts/verification-contract.md' "tool-verifier references verification contract"
+require_text "$TOOL_PLANNER" 'docs/context-map.md' "tool-planner uses context map"
+require_text "$TOOL_WORKER" 'docs/context-map.md' "tool-worker uses context map"
+require_text "$TOOL_VERIFIER" 'docs/context-map.md' "tool-verifier uses context map"
+require_text "$TOOL_VERIFIER" 'Report only' "tool-verifier keeps report-only role"
+require_text "$DEV_PROMPTFOO" 'deep-context contract persistence' "dev evals include deep-context contract persistence case"
+require_text "$PACKAGE_MANIFEST" 'plan-work must delegate to tool-planner' "Codex kdev profile requires planner delegation"
+require_text "$PACKAGE_MANIFEST" 'verify-work to tool-verifier' "Codex kdev profile requires verifier delegation"
+require_text "$PACKAGE_MANIFEST" 'instead of replacing it with a local summary' "Codex kdev profile preserves blocked delegation gates"
+require_text "$PACKAGE_MANIFEST" 'name exact delegate ids' "Codex kdev profile requires auditable delegate names"
+
+echo ""
+echo "--- delivery goal fit ---"
+require_text "$PLAN_WORK" 'Definition Of Done' "plan-work requires Definition Of Done"
+require_text "$PLAN_WORK" 'Stop-short risks' "plan-work captures stop-short risks"
+require_text "$PLAN_WORK" 'Durable docs target' "plan-work captures durable docs target"
+require_text "$DELIVER" 'Goal Fit Gate' "deliver requires Goal Fit Gate"
+require_text "$DELIVER" 'Final Acceptance' "deliver requires Final Acceptance"
+require_text "$DELIVER" 'Required Preflight' "deliver defines pull/pickup preflight"
+require_text "$DELIVER" 'pull-work -> pickup-probe' "deliver routes missing pickup evidence through pull-work and pickup-probe"
+require_text "$DELIVER" 'continue automatically to execution' "deliver can proceed autonomously after planning"
+require_text "$DELIVER" '\.flow-agents/<slug>/archive' "deliver archives working artifacts"
+require_text "$DELIVER" 'Sidecar Writer Adoption' "deliver owns sidecar writer adoption"
+require_text "$DELIVER" 'record-critique|import-critique' "deliver records critique through sidecar writer"
+require_text "$VERIFY_WORK" 'Goal Fit' "verify-work reports Goal Fit"
+require_text "$VERIFY_WORK" 'A technically green build is not enough' "verify-work rejects task-only pass"
+require_text "$VERIFY_WORK" 'criteria\[\]\.evidence_refs.*structured evidence refs' "verify-work requires structured acceptance evidence refs"
+require_text "$VERIFY_WORK" 'checks\[\]\.artifact_refs.*structured evidence ref objects' "verify-work requires structured artifact refs"
+require_text "$VERIFY_WORK" 'prose-only behavior claims' "verify-work rejects prose-only behavior evidence"
+require_text "$PLAN_WORK" 'not optional ceremony' "plan-work treats sidecars as required when writer exists"
+require_text "$EXECUTE_PLAN" 'do not mark execution as cleanly complete' "execute-plan records sidecar write blockers"
+require_text "$VERIFY_WORK" 'Do not convert verifier output into `PASS` without structured evidence' "verify-work preserves structured evidence gate"
+require_text "$RELEASE" 'keep the release decision as `HOLD`' "release-readiness preserves blocked release sidecars"
+require_text "$RELEASE" 'record the sidecar-write or validation blocker as a `NOT_VERIFIED` evidence gap' "release-readiness records blocked writer as evidence gap"
+require_text "$LEARNING" 'keep the learning verdict at `FOLLOWUP_REQUIRED` or `BLOCKED`' "learning-review preserves blocked learning sidecars"
+require_text "$GOAL_FIT_HOOK" 'FLOW_AGENTS_GOAL_FIT_STRICT' "goal-fit hook supports strict mode"
+require_text "$GOAL_FIT_HOOK" 'Definition Of Done' "goal-fit hook checks Definition Of Done"
+require_text "$GOAL_FIT_HOOK" 'Goal Fit Gate' "goal-fit hook checks Goal Fit Gate"
+require_text "$GOAL_FIT_HOOK" 'sidecarGuidance' "goal-fit hook reads sidecars for stop guidance"
+require_text "$GOAL_FIT_HOOK" 'not_verified_gaps' "goal-fit hook reports not verified evidence gaps"
+require_text "$GOAL_FIT_HOOK" 'critique open' "goal-fit hook reports open critique findings"
+require_text "$WORKFLOW_STEERING_HOOK" 'state.json' "workflow steering hook reads state sidecars"
+require_text "$WORKFLOW_STEERING_HOOK" 'critique.json' "workflow steering hook reads critique sidecars"
+require_text "$WORKFLOW_STEERING_HOOK" 'docs/context-map.md' "workflow steering hook points to context map"
+require_text "$WORKFLOW_STEERING_HOOK" 'next_action' "workflow steering hook uses next action"
+require_text "$WORKFLOW_STEERING_HOOK" 'stateNeedsAmbientSteering' "workflow steering hook supports ambient state guidance"
+require_text "$CONTEXT_MAP_GENERATOR" 'check' "context map generator supports drift check"
+require_text "$PACK_FILTER" 'selected_packs' "pack filter records selected packs"
+require_text "$PACK_FILTER" 'known.*keep' "pack filter prunes only known Flow Agents entries"
+require_text "$PROMOTE_DOC" 'docs/delivery' "promotion helper writes long-lived delivery docs"
+require_text "$PROMOTE_DOC" 'archived_artifact' "promotion helper links archived artifact"
+require_text "$SIDECAR_WRITER" 'init-plan' "sidecar writer initializes planning sidecars"
+require_text "$SIDECAR_WRITER" 'ensure-session' "sidecar writer ensures current session artifacts"
+require_text "$SIDECAR_WRITER" 'advance-state' "sidecar writer advances workflow state"
+require_text "$SIDECAR_WRITER" 'record-evidence' "sidecar writer records evidence sidecars"
+require_text "$SIDECAR_WRITER" 'record-critique' "sidecar writer records critique sidecars"
+require_text "$SIDECAR_WRITER" 'import-critique' "sidecar writer imports critique artifacts"
+require_text "$SIDECAR_WRITER" 'record-release' "sidecar writer records release sidecars"
+require_text "$SIDECAR_WRITER" 'record-learning' "sidecar writer records learning sidecars"
+require_text "$SIDECAR_WRITER" 'dogfood-pass' "sidecar writer records dogfood passes"
+require_text "$SIDECAR_WRITER" 'release-decision' "dogfood pass can record release readiness"
+require_text "$SIDECAR_WRITER" 'lock' "sidecar writer serializes sidecar writes"
+require_text "$ARTIFACT_CONTRACT" 'workflow-release.schema.json' "artifact contract defines release sidecar"
+require_text "$ARTIFACT_CONTRACT" 'workflow-learning.schema.json' "artifact contract defines learning sidecar"
+require_text "$ARTIFACT_VALIDATOR" 'release.json' "artifact validator recognizes release sidecars"
+require_text "$ARTIFACT_VALIDATOR" 'learning.json' "artifact validator recognizes learning sidecars"
+require_text "$ARTIFACT_VALIDATOR" 'green build is not enough' "artifact validator rejects green-build-only delivery"
+require_text "$ARTIFACT_VALIDATOR" 'NOT_VERIFIED.*explicit acceptance' "artifact validator rejects hidden NOT_VERIFIED"
+require_text "$RELEASE_SCHEMA" 'post_deploy_checks' "release schema defines post deploy checks"
+require_text "$ROOT/schemas/workflow-evidence.schema.json" 'standard_refs' "evidence schema defines standard refs"
+require_text "$ROOT/schemas/workflow-evidence.schema.json" 'opentelemetry-log' "evidence schema supports OpenTelemetry logs"
+require_text "$ROOT/schemas/workflow-evidence.schema.json" 'sarif' "evidence schema supports SARIF"
+require_text "$ROOT/schemas/workflow-evidence.schema.json" 'veritas' "evidence schema supports Veritas refs"
+require_text "$SHARED_CONTRACTS_DOC" 'context/contracts/' "shared contracts doc names contract directory"
+require_text "$ARTIFACT_INTEGRATION" 'valid plan/review/delivery artifact chain and sidecars pass' "artifact integration covers positive E2E chain"
+require_text "$ARTIFACT_INTEGRATION" 'green-build-only artifact fails usefulness gate' "artifact integration covers usefulness negative case"
+require_text "$ARTIFACT_INTEGRATION" 'hidden NOT_VERIFIED artifact requires explicit decision' "artifact integration covers NOT_VERIFIED negative case"
+require_text "$ARTIFACT_INTEGRATION" 'missing Sandbox mode artifact fails with actionable message' "artifact integration covers missing sandbox mode"
+require_text "$ARTIFACT_INTEGRATION" 'invalid Sandbox mode artifact fails with actionable message' "artifact integration covers invalid sandbox mode"
+require_text "$ARTIFACT_INTEGRATION" 'evidence sidecar rejects unknown standard refs' "artifact integration covers evidence standard refs"
+require_text "$ARTIFACT_INTEGRATION" 'learning sidecar requires traceable source refs' "artifact integration covers learning sidecar schema"
+require_text "$ARTIFACT_INTEGRATION" 'learning sidecar requires at least one record' "artifact integration covers empty learning records"
+require_text "$ARTIFACT_INTEGRATION" 'learning sidecar keeps open routing out of learned status' "artifact integration covers learning routing status"
+require_text "$ARTIFACT_INTEGRATION" 'release sidecar blocks positive decisions with non-pass gates' "artifact integration covers release gate status"
+require_text "$ARTIFACT_INTEGRATION" 'release sidecar requires deploy rollback and post-deploy checks' "artifact integration covers deploy readiness status"
+require_text "$ARTIFACT_INTEGRATION" 'release sidecar requires matching gate for positive decisions' "artifact integration covers matching release gate"
+require_text "$ARTIFACT_INTEGRATION" 'release sidecar rejects failed deploy checks' "artifact integration covers failed deploy checks"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer advances workflow state' "sidecar writer integration covers phase transitions"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer ensures current session artifact' "sidecar writer integration covers session creation"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer selects existing session without overwrite' "sidecar writer integration covers session selection"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'derives missing sidecars from existing session Markdown' "sidecar writer integration covers existing session sidecar derivation"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer rejects invalid workflow states' "sidecar writer integration covers invalid state transitions"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer rejects invalid target phases' "sidecar writer integration covers invalid target phases"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer records release readiness' "sidecar writer integration covers release sidecars"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer records learning feedback' "sidecar writer integration covers learning sidecars"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass refuses clean completion without evidence' "sidecar writer integration covers dogfood pass evidence gate"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects existing dirty evidence before state and handoff writes' "sidecar writer integration covers existing dirty evidence fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects existing invalid evidence before state and handoff writes' "sidecar writer integration covers existing invalid evidence fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects failed clean-pass checks before partial evidence writes' "sidecar writer integration covers clean-pass failed check fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects not_verified clean-pass checks before partial evidence writes' "sidecar writer integration covers clean-pass not-verified fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects invalid evidence metadata before partial sidecar writes' "sidecar writer integration covers invalid evidence metadata fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects invalid learning before partial sidecar writes' "sidecar writer integration covers invalid learning fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects invalid learning shape before partial sidecar writes' "sidecar writer integration covers invalid learning shape fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects existing invalid learning before partial sidecar writes' "sidecar writer integration covers existing invalid learning fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects invalid critique metadata before partial sidecar writes' "sidecar writer integration covers invalid critique metadata fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects existing invalid critique before partial sidecar writes' "sidecar writer integration covers existing invalid critique fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass requires critique when configured' "sidecar writer integration covers dogfood pass critique gate"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects bad explicit artifact dirs' "sidecar writer integration covers dogfood artifact-dir validation"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects invalid critique JSON before partial evidence writes' "sidecar writer integration covers dogfood parse fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects failing required critique before partial evidence writes' "sidecar writer integration covers dogfood semantic fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass rejects existing dirty critique before partial evidence writes' "sidecar writer integration covers existing critique fail-closed behavior"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass records failed evidence and failing critique for routing' "sidecar writer integration covers honest failed dogfood records"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass preserves NOT_VERIFIED evidence' "sidecar writer integration covers dogfood pass not verified routing"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass release readiness requires clean critique' "sidecar writer integration covers release critique gate"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'dogfood-pass records release readiness after clean pass' "sidecar writer integration covers dogfood release readiness"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'sidecar writer serializes concurrent sidecar writes' "sidecar writer integration covers concurrent writes"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'does not leave lock files for invalid new artifact commands' "sidecar writer integration covers invalid lock cleanup"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'does not advance state after invalid release semantics' "sidecar writer integration guards release state ordering"
+require_text "$SIDECAR_WRITER_INTEGRATION" 'does not archive state after invalid learning semantics' "sidecar writer integration guards learning state ordering"
+require_text "$CONTEXT_MAP_INTEGRATION" 'context map is current' "context map integration covers drift"
+require_text "$CONTEXT_MAP_INTEGRATION" 'context map generation is deterministic' "context map integration covers deterministic generation"
+require_text "$WORKFLOW_STEERING_INTEGRATION" 'workflow steering hook neutralizes multiline critique findings' "workflow steering integration covers critique sanitization"
+require_text "$WORKFLOW_STEERING_INTEGRATION" 'workflow steering hook appends context-map recovery guidance' "workflow steering integration covers context-map guidance"
+require_text "$WORKFLOW_STEERING_INTEGRATION" 'workflow steering hook emits ambient state guidance at user prompt submit' "workflow steering integration covers ambient state guidance"
+require_text "$ROOT/evals/integration/test_goal_fit_hook.sh" 'goal-fit hook reports actionable sidecar guidance' "goal-fit integration covers specific sidecar guidance"
+require_text "$HOOK_INFLUENCE_CASES" 'agent_must_do' "hook influence cases define expected agent behavior"
+require_text "$HOOK_INFLUENCE_CASES" 'live-acceptance' "hook influence cases include live acceptance evidence"
+require_text "$HOOK_INFLUENCE_CASES" 'documented-runtime-gap' "hook influence cases capture runtime gaps honestly"
+require_text "$HOOK_INFLUENCE_INTEGRATION" 'hook influence behavioral cases validate' "hook influence integration validates behavioral cases"
+require_text "$HOOK_INFLUENCE_VALIDATOR" 'missing runtime coverage' "hook influence validator enforces runtime coverage"
+
+echo ""
+echo "--- builder-shape ---"
+require_text "$BUILDER_SHAPE" '^name: "builder-shape"$' "frontmatter name"
+require_text "$BUILDER_SHAPE" 'Builder Kit `shape` flow' "defines Builder Kit shape product surface"
+require_text "$BUILDER_SHAPE" 'skills/idea-to-backlog/SKILL.md' "delegates to idea-to-backlog"
+require_text "$BUILDER_SHAPE" 'kits/builder/flows/shape.flow.json' "links Builder Kit Flow Definition"
+require_text "$BUILDER_SHAPE" 'raw idea.*current conversation context|current conversation context.*raw idea' "accepts raw idea or conversation context"
+require_text "$BUILDER_SHAPE" 'Probe/alignment' "uses Probe alignment language"
+require_text "$BUILDER_SHAPE" 'Proactive suggestion' "builder-shape is suggested for feature/product planning"
+require_text "$BUILDER_SHAPE" 'design-probe.*idea-to-backlog|idea-to-backlog.*design-probe' "builder-shape chains design-probe and idea-to-backlog"
+require_text "$BUILDER_SHAPE" 'stop at the backlog gate by default|Stop at `next_gate: Backlog Gate`' "stops at backlog gate by default"
+require_text "$BUILDER_SHAPE" 'Issue sync is explicit-only' "requires explicit issue sync"
+require_text "$BUILDER_SHAPE" 'Direct `idea-to-backlog` usage remains valid' "preserves direct idea-to-backlog use"
+require_text "$BUILDER_SHAPE" 'source_ideas' "requires standard source ideas section"
+require_text "$BUILDER_SHAPE" 'idea_inventory' "requires standard idea inventory section"
+require_text "$BUILDER_SHAPE" 'slice_candidates' "requires standard slice candidates section"
+require_text "$BUILDER_SHAPE" 'dependency_map' "requires standard dependency map section"
+require_text "$BUILDER_SHAPE" 'shaped_work' "requires standard shaped work section"
+require_text "$BUILDER_SHAPE" 'risk_release_notes' "requires standard risk release notes section"
+require_text "$BUILDER_SHAPE" 'open_questions' "requires standard open questions section"
+require_text "$BUILDER_SHAPE" 'next_gate' "requires standard next gate section"
+
+echo ""
+echo "--- idea-to-backlog ---"
+require_text "$IDEA" '^name: "idea-to-backlog"$' "frontmatter name"
+require_text "$IDEA" 'Do not write production code' "forbids production implementation"
+require_text "$IDEA" 'Do not invoke downstream delivery skills' "keeps upstream separate from delivery"
+require_text "$IDEA" 'After the backlog gate, hand off to `pull-work` only if the user explicitly asks to continue' "allows explicit gated handoff"
+require_text "$IDEA" 'GitHub issues' "uses GitHub issues as executable backlog"
+require_text "$IDEA" 'thinnest meaningful slice' "requires thinnest meaningful slice"
+require_text "$IDEA" 'bundle justification' "requires bundle justification for grouped work"
+require_text "$IDEA" 'dependency map' "requires dependency mapping"
+require_text "$IDEA" 'Push back|push back' "pushes back on blended ideas"
+require_text "$IDEA" 'Backlog Gate' "defines backlog gate"
+require_text "$IDEA" 'flow-agents:work-item-metadata' "documents work-item metadata marker"
+require_text "$IDEA" 'planned_base_ref' "documents planned_base_ref"
+require_text "$IDEA" 'planned_base_sha' "documents planned_base_sha"
+require_text "$IDEA" 'planned_at' "documents planned_at"
+require_text "$IDEA" 'planning_artifact_ref' "documents planning_artifact_ref"
+require_text "$IDEA" 'planning_scope_refs' "documents planning_scope_refs"
+require_text "$IDEA" 'source_revisions' "documents repo-scoped source_revisions"
+require_text "$IDEA" 'structured .*blockers\[\]' "documents structured blockers array"
+require_text "$IDEA" 'Dependencies / Blockers' "preserves human-readable dependencies/blockers prose"
+require_text "$IDEA" 'provider-neutral structured metadata marker' "keeps marker guidance provider-neutral"
+require_text "$IDEA" 'outside the generic skill contract' "keeps native provider dependency APIs adapter-specific"
+require_text "$IDEA" 'Acceptance Evidence' "idea-to-backlog requires Acceptance Evidence issue expectation"
+require_text "$IDEA" 'immutable GitHub blob permalinks pinned to commit SHA' "idea-to-backlog expects immutable source permalinks"
+
+echo ""
+echo "--- pull-work ---"
+require_text "$PULL" '^name: "pull-work"$' "frontmatter name"
+require_text "$PULL" 'Do not implement code' "forbids implementation"
+require_text "$PULL" 'WIP' "enforces WIP awareness"
+require_text "$PULL" 'worktree' "records worktree isolation decision"
+require_text "$PULL" 'thinnest meaningful slice' "checks selected slice size"
+require_text "$PULL" 'bundle justification' "checks issue-group bundle justification"
+require_text "$PULL" 'plan-work' "hands off to plan-work"
+require_text "$PULL" 'Cross-Repo Ranking And Selection' "pull-work documents cross-repo ranking"
+require_text "$PULL" 'provider-neutral cross-repo ranking' "pull-work ranks across repos provider-neutrally"
+require_text "$PULL" '`selected_scope`' "pull-work output contract records selected scope"
+require_text "$PULL" '`priority_rationale`' "pull-work output contract records priority rationale"
+require_text "$PULL" '`dependencies`' "pull-work output contract records dependencies"
+require_text "$PULL" '`wip_conflict_notes`' "pull-work output contract records WIP/conflict notes"
+require_text "$PULL" '`alignment_questions`' "pull-work output contract records alignment questions"
+require_text "$PULL" 'selected_item_ids' "pull-work records selected item correlation ids"
+require_text "$PULL" 'shepherding_item_ids' "pull-work records shepherding item correlation ids"
+require_text "$PULL" 'backlog_gap=true' "pull-work records backlog gaps explicitly"
+require_text "$PULL" 'local backlog artifact' "pull-work supports local backlog artifact refs"
+require_text "$PULL" 'route to `idea-to-backlog`' "pull-work routes backlog gaps to idea-to-backlog"
+require_text "$PULL" 'Work Item Group selection requires explicit justification' "pull-work requires explicit Work Item Group justification"
+require_text "$PULL" 'Do not implement code' "pull-work keeps implementation out of pickup"
+require_text "$PULL" 'Hand selected work to `plan-work` only after the pickup gate is satisfied' "pull-work preserves plan-work gate"
+require_text "$PULL" 'enforce the full pull-work selection, WIP/shepherding, dependency, grouping, and worktree logic' "pull-work enforces selection logic before planning"
+require_text "$PULL" 'fresh pickup Probe record exists' "pull-work requires fresh pickup Probe before planning"
+require_text "$PULL" 'independent docs work' "pull-work examples cover independent docs work"
+require_text "$PULL" 'Resource Contract audit work' "pull-work examples cover Resource Contract audit work"
+require_text "$PULL" 'dogfood-alpha implementation work' "pull-work examples cover dogfood-alpha implementation work"
+require_text "$PULL" 'blocked cross-product dependency' "pull-work examples cover blocked cross-product dependency"
+require_text "$PULL" 'Direct `pull-work` remains a standalone primitive' "pull-work preserves direct primitive use"
+require_text "$PULL" 'Builder Kit `build` flow' "pull-work documents Builder Kit build-flow pickup Probe"
+require_text "$PULL" 'goal fit and scope' "pickup Probe checks goal fit and scope"
+require_text "$PULL" 'blockers and dependencies' "pickup Probe checks blockers and dependencies"
+require_text "$PULL" 'dependency freshness' "pickup Probe checks dependency freshness"
+require_text "$PULL" 'acceptance criteria quality' "pickup Probe checks acceptance criteria quality"
+require_text "$PULL" 'provider state' "pickup Probe checks provider state"
+require_text "$PULL" 'risk and stop-short risks' "pickup Probe checks risk and stop-short risks"
+require_text "$PULL" 'expected modified files and conflict risks' "pickup Probe records expected files and conflict risks"
+require_text "$PULL" 'accepted gap' "pickup Probe records accepted gaps"
+require_text "$PULL" 'Ask one alignment question at a time only when repo/provider context leaves a genuine decision gap' "pickup Probe limits alignment questions to genuine gaps"
+require_text "$PULL" 'route `decision_gap` back to `design-probe`' "pull-work routes decision gaps to pickup Probe"
+require_text "$PULL" 'my_active_work' "pull-work records my active work"
+require_text "$PULL" 'shepherding_candidates' "pull-work records shepherding candidates"
+require_text "$PULL" 'stale_worktrees' "pull-work records stale worktrees"
+require_text "$PULL" 'open_prs_by_me' "pull-work records PRs by me"
+require_text "$PULL" 'global_conflicts' "pull-work records global conflicts"
+require_text "$PULL" 'dependency_impacts' "pull-work records dependency impacts"
+require_text "$PULL" 'start_new_work_decision' "pull-work records start-new-work decision"
+require_text "$PULL" 'worktree_lifecycle' "pull-work records worktree lifecycle"
+require_text "$PULL" 'Personal WIP may block new work' "pull-work lets personal WIP block pickup"
+require_text "$PULL" "Other people's WIP blocks only when" "pull-work distinguishes global WIP blocking"
+require_text "$PULL" 'Publishing a branch must retain the worktree' "pull-work retains worktree through publish"
+require_text "$PULL" 'Final acceptance, release cleanup, or explicit abandonment owns worktree removal' "pull-work assigns cleanup to final acceptance"
+require_file "$PULL_WORK_PERSONAL_WIP_FIXTURE" "pull-work personal WIP fixture"
+require_file "$PULL_WORK_GLOBAL_WIP_FIXTURE" "pull-work global WIP fixture"
+require_text "$USAGE_GUIDE" 'Before selecting new work, `pull-work` must separate your WIP from global conflict context' "usage guide separates personal and global WIP"
+require_text "$USAGE_GUIDE" 'Your WIP can block starting new work' "usage guide documents personal WIP gate"
+require_text "$USAGE_GUIDE" "Other people's WIP should block only when" "usage guide documents global WIP policy"
+require_text "$USAGE_GUIDE" '`worktree_lifecycle`' "usage guide documents worktree lifecycle"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Pull Work WIP And Worktree Lifecycle' "state contract documents WIP lifecycle"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Personal WIP controls whether new work should start' "state contract defines personal WIP gate"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Global work informs safety and priority' "state contract defines global WIP context"
+if node - "$PULL_WORK_PERSONAL_WIP_FIXTURE" "$PULL_WORK_GLOBAL_WIP_FIXTURE" <<'NODE'; then
+const fs = require("node:fs");
+const requiredWip = ["my_active_work", "shepherding_candidates", "stale_worktrees", "open_prs_by_me", "global_conflicts", "dependency_impacts"];
+const requiredLifecycle = ["path", "branch", "retain_until", "cleanup_owner", "cleanup_command", "cleanup_blocked_by"];
+const personal = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const globalCase = JSON.parse(fs.readFileSync(process.argv[3], "utf8"));
+for (const [label, data] of [["personal", personal], ["global", globalCase]]) {
+  const wip = data.wip_assessment || {};
+  const missing = requiredWip.filter((field) => !(field in wip));
+  if (missing.length) throw new Error(`${label} fixture missing WIP fields: ${missing.join(", ")}`);
+  const lifecycle = data.worktree_lifecycle || {};
+  const missingLifecycle = requiredLifecycle.filter((field) => !(field in lifecycle));
+  if (missingLifecycle.length) throw new Error(`${label} fixture missing lifecycle fields: ${missingLifecycle.join(", ")}`);
+  const decision = data.start_new_work_decision || {};
+  if (!decision.decision || !decision.reason || !decision.next_action) throw new Error(`${label} fixture missing start_new_work_decision shape`);
+}
+if (personal.start_new_work_decision.decision !== "shepherd_existing") throw new Error("personal WIP fixture should shepherd existing work");
+if (globalCase.start_new_work_decision.decision !== "proceed") throw new Error("global WIP fixture should proceed with recorded risk");
+if (!globalCase.wip_assessment.global_conflicts?.length) throw new Error("global WIP fixture should include global conflicts");
+NODE
+  pass "pull-work WIP shepherding fixtures distinguish personal block from global context"
+else
+  fail "pull-work WIP shepherding fixtures distinguish personal block from global context"
+fi
+
+echo ""
+echo "--- design-probe / pickup-probe ---"
+require_file "$BUILDER_KIT_STATE_CONTRACT" "Builder Kit workflow state contract"
+require_file "$BUILDER_KIT_HAPPY_PATH_FIXTURE" "Builder Kit happy-path fixture"
+require_file "$BUILDER_KIT_RESUME_FIXTURE" "Builder Kit mid-work resume fixture"
+require_file "$BUILDER_KIT_PRODUCT_CHAIN_FIXTURE" "Builder Kit product-chaining fixture"
+require_file "$BUILDER_KIT_DIRECT_PRIMITIVE_FIXTURE" "Builder Kit direct primitive fixture"
+require_file "$BUILDER_KIT_MISSING_PRESTEP_FIXTURE" "Builder Kit missing pre-step fixture"
+require_file "$BUILDER_KIT_STALE_CONTINUATION_FIXTURE" "Builder Kit stale continuation fixture"
+require_file "$BUILDER_KIT_EMPTY_BOARD_FIXTURE" "Builder Kit empty board fixture"
+require_file "$BUILDER_KIT_BASELINE_FRESHNESS_HINT_FIXTURE" "Builder Kit baseline freshness resolution hint fixture"
+require_text "$DESIGN_PROBE" 'This skill is generic' "design-probe is generic"
+require_text "$DESIGN_PROBE" 'modeled after Matt Pocock.*grill-me' "design-probe models grill-me"
+require_text "$DESIGN_PROBE" 'Be relentless about ambiguity' "design-probe grills ambiguous branches"
+require_text "$DESIGN_PROBE" 'Ask exactly one alignment question at a time' "design-probe asks one question at a time"
+require_text "$DESIGN_PROBE" 'Include a recommended answer with every question' "design-probe includes recommended answer"
+require_text "$DESIGN_PROBE" 'Explore first' "design-probe explores local context before asking"
+require_text "$DESIGN_PROBE" 'accepted gap' "design-probe records accepted gaps"
+require_text "$PICKUP_PROBE" 'Selected work item' "pickup-probe requires selected work input"
+require_text "$PICKUP_PROBE" 'modeled after Matt Pocock.*grill-with-docs' "pickup-probe models grill-with-docs"
+require_text "$PICKUP_PROBE" 'Provider state' "pickup-probe requires provider state"
+require_text "$PICKUP_PROBE" 'WIP and conflict scan' "pickup-probe requires WIP/conflict scan"
+require_text "$PICKUP_PROBE" 'Existing acceptance criteria' "pickup-probe requires acceptance criteria"
+require_text "$PICKUP_PROBE" 'Source issue and artifact refs' "pickup-probe requires source refs"
+require_text "$PICKUP_PROBE" 'Planned-base drift context' "pickup-probe requires planned-base drift context"
+require_text "$PICKUP_PROBE" 'planned_base_ref' "pickup-probe records planned base ref"
+require_text "$PICKUP_PROBE" 'planned_base_sha' "pickup-probe records planned base sha"
+require_text "$PICKUP_PROBE" 'current target ref/SHA' "pickup-probe records current target ref and sha"
+require_text "$PICKUP_PROBE" 'diff summary from the planned/pulled work SHA to current HEAD' "pickup-probe researches diff to current head"
+require_text "$PICKUP_PROBE" 'Fetch latest for the target ref' "pickup-probe fetches latest before freshness checks"
+require_text "$PICKUP_PROBE" 'compare the current target SHA to `planned_base_sha`' "pickup-probe compares current target SHA to planned_base_sha"
+require_text "$PICKUP_PROBE" 'commits-since' "pickup-probe records commits-since"
+require_text "$PICKUP_PROBE" 'planned age' "pickup-probe records planned age"
+require_text "$PICKUP_PROBE" 'changed-file intersections with `planning_scope_refs`' "pickup-probe records planning scope intersections"
+require_text "$PICKUP_PROBE" 'Classify revision freshness as `fresh`, `drifted`, or `stale`' "pickup-probe classifies fresh drifted stale"
+require_text "$PICKUP_PROBE" '`drifted` prompts alignment and may proceed' "pickup-probe allows drifted with alignment"
+require_text "$PICKUP_PROBE" '`stale` routes back to `idea-to-backlog`' "pickup-probe routes stale freshness to idea-to-backlog"
+require_text "$PICKUP_PROBE" 'planned_base_sha.*missing.*NOT_VERIFIED' "pickup-probe marks missing planned_base_sha as NOT_VERIFIED"
+require_text "$PICKUP_PROBE" 'concrete fallback baseline' "pickup-probe records fallback baseline for missing planned_base_sha"
+require_text "$PICKUP_PROBE" 'resolution_hints.*Builder Kit Probe record' "pickup-probe records resolution hints in Builder Kit Probe record"
+require_text "$PICKUP_PROBE" 'gap_id: revision_freshness_not_verified' "pickup-probe names baseline freshness hint gap id"
+require_text "$PICKUP_PROBE" 'claim_id: planning.baseline.current' "pickup-probe names baseline freshness claim id"
+require_text "$PICKUP_PROBE" 'resolve_at.*pickup-probe' "pickup-probe routes baseline hint resolution back to pickup-probe"
+require_text "$PICKUP_PROBE" 'Probe status' "pickup-probe records Probe status"
+require_text "$PICKUP_PROBE" 'Planning readiness' "pickup-probe records planning readiness"
+require_text "$PICKUP_PROBE" 'Expected modified files' "pickup-probe records expected modified files"
+require_text "$PICKUP_PROBE" 'Conflict risks' "pickup-probe records conflict risks"
+require_text "$PICKUP_PROBE" 'Route reason and next action' "pickup-probe records route and next action"
+require_text "$PICKUP_PROBE" 'Research drift before asking questions' "pickup-probe researches drift before alignment questions"
+require_text "$PICKUP_PROBE" 'no_material_drift' "pickup-probe classifies no material drift"
+require_text "$PICKUP_PROBE" 'scope_drift' "pickup-probe classifies scope drift"
+require_text "$PICKUP_PROBE" 'dependency_drift' "pickup-probe classifies dependency drift"
+require_text "$PICKUP_PROBE" 'contract_drift' "pickup-probe classifies contract drift"
+require_text "$PICKUP_PROBE" 'conflict_risk' "pickup-probe classifies conflict risk"
+require_text "$PICKUP_PROBE" 'Planned-base drift research is recorded' "pickup-probe gates planning on drift research"
+require_text "$PICKUP_PROBE" 'planned-base drift summary and drift classification' "pickup-probe hands off drift summary to plan-work"
+require_text "$PICKUP_PROBE" 'Update `CONTEXT.md` inline only for glossary-style durable terminology decisions' "pickup-probe limits CONTEXT.md updates"
+require_text "$PICKUP_PROBE" 'Challenge glossary conflicts immediately' "pickup-probe challenges domain terminology"
+require_text "$PICKUP_PROBE" 'Create a lazy context file only when a resolved term or workflow concept has no existing home' "pickup-probe creates context lazily"
+require_text "$PICKUP_PROBE" 'ADRs sparingly, only when all three are true' "pickup-probe limits ADRs"
+require_text "$PICKUP_PROBE" 'hard to reverse, surprising without context, and the result of a real trade-off' "pickup-probe keeps ADR threshold"
+require_text "$BUILDER_SHAPE" 'Product-level auto-guidance' "builder-shape guides idea-to-backlog"
+require_text "$BUILDER_SHAPE" 'do not require them to type `idea-to-backlog`' "builder-shape hides primitive typing"
+require_text "$PULL" 'probe_status' "pull-work records machine-checkable probe status"
+require_text "$PULL" 'probe_artifact_ref' "pull-work records machine-checkable probe artifact"
+require_text "$PULL" 'stale broad continuation instruction' "pull-work blocks stale broad continuation"
+require_text "$PULL" 'no ready backlog item exists' "pull-work routes empty board to shape"
+require_text "$PLAN_WORK" 'stale broad continuation language' "plan-work rejects stale continuation planning"
+require_text "$PLAN_WORK" '`probe_status` is `passed` or `accepted_gap`' "plan-work requires passed or accepted-gap probe"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'current step' "state contract documents current step"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'next step' "state contract documents next step"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'route reason' "state contract documents route reason"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'selected work item refs' "state contract documents selected work refs"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'missing evidence' "state contract documents missing evidence"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'unresolved questions' "state contract documents unresolved questions"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'accepted gaps' "state contract documents accepted gaps"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'resume prompt' "state contract documents resume prompt"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'artifact references' "state contract documents artifact references"
+require_text "$BUILDER_KIT_STATE_CONTRACT" '`manual`' "state contract documents manual mode"
+require_text "$BUILDER_KIT_STATE_CONTRACT" '`guided`' "state contract documents guided mode"
+require_text "$BUILDER_KIT_STATE_CONTRACT" '`strict`' "state contract documents strict mode"
+require_text "$BUILDER_KIT_STATE_CONTRACT" '`autonomous-bounded`' "state contract documents autonomous-bounded mode"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'probe status' "state contract documents probe status"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'probe artifact ref' "state contract documents probe artifact ref"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'grouping decision' "state contract documents grouping decision"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'optional `resolution_hints`' "state contract documents optional Builder Kit resolution hints"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'canonical machine storage for `resolution_hints` is the Builder Kit Probe JSON record' "state contract keeps resolution hints in Builder Kit Probe storage"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'blocked_refs\[\]' "state contract defines deterministic blocked refs"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'acceptance_criterion.*AC2' "state contract includes deterministic AC2 blocked ref"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'workflow_gate.*plan-work\.readiness' "state contract includes deterministic plan-work readiness blocked ref"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'flow_step.*builder\.build\.plan' "state contract includes deterministic Builder Kit plan blocked ref"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'revision_freshness_not_verified' "state contract includes baseline freshness gap example"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'planning\.baseline\.current' "state contract includes Builder Kit baseline claim id"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'missing_planned_base_sha' "state contract includes missing planned base reason code"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'accepted_fallback_baseline\.current_target_plus_provider_history' "state contract includes explicit fallback baseline policy"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Builder Kit owns readiness guidance' "state contract preserves Builder Kit ownership boundary"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Generic Flow Agents sidecar schemas, including `schemas/workflow-evidence\.schema\.json`, are not extended by this Builder Kit field' "state contract preserves generic evidence schema boundary"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Veritas remains optional evidence' "state contract preserves optional Veritas boundary"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Direct primitive workflows remain valid without Builder Kit-specific `resolution_hints`' "state contract preserves direct primitive validity"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Product Flow Chaining And Primitive Stopping' "state contract documents product flow chaining"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Per-Item Pickup Probe Enforcement' "state contract documents per-item Probe enforcement"
+require_text "$BUILDER_KIT_STATE_CONTRACT" 'Issues #64, #51, and #62 are downstream consumers of this contract' "state contract anchors downstream issue drift checks"
+require_text "$USAGE_GUIDE" 'context/contracts/builder-kit-workflow-state-contract.md' "usage guide links Builder Kit state contract"
+require_text "$USAGE_GUIDE" '`manual`' "usage guide documents manual mode"
+require_text "$USAGE_GUIDE" '`guided`' "usage guide documents guided mode"
+require_text "$USAGE_GUIDE" '`strict`' "usage guide documents strict mode"
+require_text "$USAGE_GUIDE" '`autonomous-bounded`' "usage guide documents autonomous-bounded mode"
+require_text "$MAP" '`pickup-probe`' "skills map includes pickup-probe"
+if node - "$BUILDER_KIT_HAPPY_PATH_FIXTURE" "$BUILDER_KIT_RESUME_FIXTURE" "$BUILDER_KIT_PRODUCT_CHAIN_FIXTURE" "$BUILDER_KIT_DIRECT_PRIMITIVE_FIXTURE" "$BUILDER_KIT_MISSING_PRESTEP_FIXTURE" "$BUILDER_KIT_STALE_CONTINUATION_FIXTURE" "$BUILDER_KIT_EMPTY_BOARD_FIXTURE" "$BUILDER_KIT_BASELINE_FRESHNESS_HINT_FIXTURE" <<'NODE'; then
+const fs = require("node:fs");
+const requiredProbeFields = ["current_step", "next_step", "route_reason", "automation_mode", "recovery_mode", "selected_work_items", "missing_evidence", "unresolved_questions", "accepted_gaps", "resume_prompt", "artifact_refs", "flow_boundary", "probe_status", "probe_artifact_ref", "grouping_decision"];
+const allowedModes = new Set(["manual", "guided", "strict", "autonomous-bounded"]);
+const allowedProbeStatuses = new Set(["missing", "required", "in_progress", "passed", "accepted_gap", "blocked"]);
+const allowedGrouping = new Set(["single-item", "independent-items", "justified-bundle", "unsafe-group", "empty-board"]);
+const fixtures = process.argv.slice(2);
+const data = fixtures.map((file) => JSON.parse(fs.readFileSync(file, "utf8")));
+fixtures.forEach((file, index) => {
+  const state = data[index].state;
+  const probe = data[index].probe_record;
+  const missing = requiredProbeFields.filter((field) => !(field in probe));
+  if (missing.length) throw new Error(`${file} missing probe fields: ${missing.join(", ")}`);
+  if (!allowedModes.has(probe.automation_mode)) throw new Error(`${file} has invalid automation mode ${probe.automation_mode}`);
+  if (!allowedProbeStatuses.has(probe.probe_status)) throw new Error(`${file} has invalid probe status ${probe.probe_status}`);
+  const grouping = probe.grouping_decision;
+  if (!allowedGrouping.has(grouping.status)) throw new Error(`${file} has invalid grouping decision ${grouping.status}`);
+  if (["independent-items", "justified-bundle"].includes(grouping.status) && !grouping.justification) throw new Error(`${file} multi-item grouping lacks justification`);
+  if (!state.next_action?.target_artifact) throw new Error(`${file} missing state next_action target artifact`);
+  if (!probe.resume_prompt) throw new Error(`${file} missing resume prompt`);
+  if ("resolution_hints" in probe && !Array.isArray(probe.resolution_hints)) throw new Error(`${file} resolution_hints must be an array when present`);
+  for (const [hintIndex, hint] of (probe.resolution_hints || []).entries()) {
+    const missingHintFields = ["gap_id", "claim_id", "reason_code", "blocked_refs", "resolve_at", "required_evidence", "fallback_policy_id", "summary"].filter((field) => !(field in hint));
+    if (missingHintFields.length) throw new Error(`${file} resolution_hints[${hintIndex}] missing fields: ${missingHintFields.join(", ")}`);
+    if (!Array.isArray(hint.blocked_refs)) throw new Error(`${file} resolution_hints[${hintIndex}].blocked_refs must be an array`);
+    if (!Array.isArray(hint.required_evidence)) throw new Error(`${file} resolution_hints[${hintIndex}].required_evidence must be an array`);
+    if (!hint.resolve_at?.step) throw new Error(`${file} resolution_hints[${hintIndex}] missing resolve_at.step`);
+  }
+});
+const [happy, resume, productChain, direct, missing, stale, empty, baselineHint] = data;
+if (happy.probe_record.next_step !== "plan-work") throw new Error("happy path should route to plan-work");
+if (resume.probe_record.next_step !== "review-work") throw new Error("mid-work resume should route to review-work");
+if (productChain.probe_record.next_step !== "design-probe") throw new Error("product-level build should route pull-work to design-probe");
+if (direct.probe_record.automation_mode !== "manual") throw new Error("direct primitive fixture should stay in manual mode");
+if (missing.probe_record.route_reason !== "decision_gap -> design-probe") throw new Error("missing pre-step should route decision_gap to design-probe");
+if (stale.probe_record.next_step !== "pickup-probe") throw new Error("stale continuation should require fresh pickup-probe");
+if (empty.probe_record.next_step !== "builder-shape") throw new Error("empty board should route back to Builder Kit shape");
+const baselineProbe = baselineHint.probe_record;
+if (baselineProbe.probe_status !== "accepted_gap") throw new Error("baseline freshness fixture should be an accepted gap");
+const baselineResolutionHint = baselineProbe.resolution_hints?.find((hint) => hint.gap_id === "revision_freshness_not_verified");
+if (!baselineResolutionHint) throw new Error("baseline freshness fixture missing revision_freshness_not_verified resolution hint");
+if (baselineResolutionHint.claim_id !== "planning.baseline.current") throw new Error("baseline hint should identify planning.baseline.current claim");
+if (baselineResolutionHint.reason_code !== "missing_planned_base_sha") throw new Error("baseline hint should identify missing_planned_base_sha reason");
+const blockedRefs = new Set(baselineResolutionHint.blocked_refs.map((ref) => `${ref.kind}:${ref.id}`));
+for (const ref of ["acceptance_criterion:AC2", "workflow_gate:plan-work.readiness", "flow_step:builder.build.plan"]) {
+  if (!blockedRefs.has(ref)) throw new Error(`baseline hint missing blocked ref ${ref}`);
+}
+if (baselineResolutionHint.resolve_at.step !== "pickup-probe") throw new Error("baseline hint should resolve at pickup-probe");
+const evidenceById = new Map(baselineResolutionHint.required_evidence.map((evidence) => [evidence.id, evidence]));
+for (const evidenceId of ["current_target_ref_sha", "provider_history_source_artifact"]) {
+  if (!evidenceById.has(evidenceId)) throw new Error(`baseline hint missing required evidence id ${evidenceId}`);
+}
+const targetEvidence = evidenceById.get("current_target_ref_sha");
+if (targetEvidence.ref !== "main" || !targetEvidence.sha) throw new Error("baseline hint current target evidence should include ref and SHA");
+const providerEvidence = evidenceById.get("provider_history_source_artifact");
+if (providerEvidence.kind !== "provider_history" || !providerEvidence.source_artifact) throw new Error("baseline hint provider evidence should include provider history and source artifact");
+if (!baselineResolutionHint.fallback_policy_id || !baselineResolutionHint.fallback_policy) throw new Error("baseline hint should name a fallback policy");
+if (baselineResolutionHint.fallback_policy.status !== "accepted_gap") throw new Error("baseline fallback policy should preserve accepted gap status");
+if (!baselineResolutionHint.fallback_policy.requires_provider_history) throw new Error("baseline fallback policy should require provider history");
+if (!baselineResolutionHint.fallback_policy.baseline?.startsWith("main@")) throw new Error("baseline fallback policy should include explicit main baseline");
+const boundary = baselineProbe.flow_boundary || {};
+for (const field of ["builder_kit_owns", "flow_agents_owns", "flow_owns"]) {
+  if (!boundary[field]) throw new Error(`baseline freshness fixture missing flow boundary marker ${field}`);
+}
+NODE
+  pass "Builder Kit workflow state fixtures are structurally resumable"
+else
+  fail "Builder Kit workflow state fixtures are structurally resumable"
+fi
+
+echo ""
+echo "--- plan-work ---"
+require_text "$PLAN_WORK" 'Direct `plan-work` remains a standalone planning primitive' "plan-work preserves direct primitive use"
+require_text "$PLAN_WORK" 'When `plan-work` is invoked from the Builder Kit `build` flow' "plan-work conditionally consumes Builder Kit handoff"
+require_text "$PLAN_WORK" 'recorded pickup Probe decisions' "plan-work consumes recorded pickup Probe decisions"
+require_text "$PLAN_WORK" 'accepted gaps' "plan-work consumes accepted gaps"
+require_text "$PLAN_WORK" 'Only consume Builder Kit Probe `resolution_hints` in those Builder Kit build/deliver/pickup contexts' "plan-work keeps resolution hints Builder Kit scoped"
+require_text "$PLAN_WORK" 'Direct primitive `plan-work` remains valid without Builder Kit-specific `resolution_hints`' "plan-work preserves direct primitive without resolution hints"
+require_text "$PLAN_WORK" 'revision_freshness_not_verified' "plan-work consumes baseline freshness resolution hint"
+require_text "$PLAN_WORK" 'planning\.baseline\.current' "plan-work consumes Builder Kit baseline claim hint"
+require_text "$PLAN_WORK" 'explicit accepted fallback baseline' "plan-work requires explicit fallback for missing baseline hint"
+require_text "$PLAN_WORK" 'route `decision_gap` back to `design-probe`' "plan-work routes missing Builder Kit decisions back"
+
+echo ""
+echo "--- review-work ---"
+require_text "$REVIEW_WORK" '^name: "review-work"$' "frontmatter name"
+require_text "$REVIEW_WORK" 'tool-code-reviewer' "delegates to code reviewer"
+require_text "$REVIEW_WORK" 'tool-security-reviewer' "conditionally delegates to security reviewer"
+require_text "$REVIEW_WORK" 'tool-dependencies-updater' "delegates dependency review to dependencies updater"
+require_text "$REVIEW_WORK" 'package\.json' "dependency review triggers on package manifests"
+require_text "$REVIEW_WORK" 'requirements\.txt' "dependency review triggers on Python manifests"
+require_text "$REVIEW_WORK" 'pyproject\.toml' "dependency review triggers on pyproject manifests"
+require_text "$REVIEW_WORK" 'Cargo\.lock' "dependency review triggers on lockfiles"
+require_text "$REVIEW_WORK" 'package-lock\.json' "dependency review triggers on npm lockfiles"
+require_text "$REVIEW_WORK" 'lockfiles' "dependency review names lockfile triggers"
+require_text "$REVIEW_WORK" 'Terraform' "IaC review triggers on Terraform"
+require_text "$REVIEW_WORK" 'Kubernetes' "IaC review triggers on Kubernetes"
+require_text "$REVIEW_WORK" 'Dockerfiles' "IaC review triggers on Dockerfiles"
+require_text "$REVIEW_WORK" 'Helm' "IaC review triggers on Helm"
+require_text "$REVIEW_WORK" 'GitHub Actions' "IaC review triggers on GitHub Actions"
+require_text "$REVIEW_WORK" 'policy-as-code|policy as code' "IaC review triggers on policy as code"
+require_text "$REVIEW_WORK" 'Checkov' "IaC scanner guidance names Checkov"
+require_text "$REVIEW_WORK" 'tfsec' "IaC scanner guidance names tfsec"
+require_text "$REVIEW_WORK" 'Trivy' "IaC scanner guidance names Trivy"
+require_text "$REVIEW_WORK" 'Semgrep' "IaC scanner guidance names Semgrep"
+require_text "$REVIEW_WORK" 'do not hard-require one vendor|no single vendor is required' "IaC scanner guidance is vendor-neutral"
+require_text "$REVIEW_WORK" 'not_verified' "records missing review lanes as not_verified"
+require_text "$REVIEW_WORK" 'critique.json' "records critique sidecar"
+require_text "$REVIEW_WORK" 'Verification is not critique' "separates review from verification"
+require_text "$ARTIFACT_CONTRACT" '`state.phase` is the canonical lifecycle vocabulary' "artifact contract identifies canonical state.phase lifecycle vocabulary"
+require_text "$ARTIFACT_CONTRACT" '\| `state\.phase` \| `idea`, `backlog`, `pickup`, `planning`, `execution`, `verification`, `goal_fit`, `evidence`, `release`, `learning`, `done` \|' "artifact contract lists canonical state.phase values without review"
+reject_text "$ARTIFACT_CONTRACT" '\| `state\.phase` \|.*`review`' "artifact contract does not list review as a canonical state.phase"
+require_text "$ARTIFACT_CONTRACT" 'review-work is represented by the required critique artifact/sink' "artifact contract maps review-work to critique artifact/sink"
+require_text "$REVIEW_WORK" '--phase execution' "review-work handoff keeps sidecar phase in execution"
+require_text "$REVIEW_WORK" 'record-critique' "review-work supports direct critique recording"
+require_text "$REVIEW_WORK" 'import-critique' "review-work imports review artifacts into critique sink"
+require_text "$REVIEW_WORK" 'critique artifact/sink' "review-work records results through critique artifact/sink"
+require_text "$REVIEW_CONTRACT" 'Review and verification are separate gates' "review contract separates review and verification"
+require_text "$REVIEW_CONTRACT" 'Review is not a canonical `state.phase` value' "review contract rejects review as canonical state.phase"
+require_text "$REVIEW_CONTRACT" 'configured critique artifact/sink' "review contract requires configured critique artifact/sink"
+require_text "$REVIEW_CONTRACT" 'Code.*Triggers|Lane.*Triggers' "review contract documents lane triggers"
+require_text "$REVIEW_CONTRACT" 'Security.*Authentication|Security.*auth' "review contract documents security lane"
+require_text "$REVIEW_CONTRACT" 'Dependency.*Package manifests|Dependency.*dependency manifests' "review contract documents dependency lane"
+require_text "$REVIEW_CONTRACT" 'Architecture/standards' "review contract documents architecture/standards lane"
+require_text "$REVIEW_CONTRACT" 'IaC/policy' "review contract documents IaC/policy lane"
+require_text "$REVIEW_CONTRACT" 'package\.json' "review contract dependency lane includes package manifests"
+require_text "$REVIEW_CONTRACT" 'package-lock\.json' "review contract dependency lane includes npm lockfiles"
+require_text "$REVIEW_CONTRACT" 'lockfiles' "review contract dependency lane includes lockfiles"
+require_text "$REVIEW_CONTRACT" 'Checkov' "review contract scanner guidance names Checkov"
+require_text "$REVIEW_CONTRACT" 'tfsec' "review contract scanner guidance names tfsec"
+require_text "$REVIEW_CONTRACT" 'Trivy' "review contract scanner guidance names Trivy"
+require_text "$REVIEW_CONTRACT" 'Semgrep' "review contract scanner guidance names Semgrep"
+require_text "$REVIEW_CONTRACT" 'no single vendor is required|vendor-neutral' "review contract scanner guidance is vendor-neutral"
+require_text "$REVIEW_CONTRACT" 'not_verified' "review contract records unavailable lanes as not_verified"
+require_text "$TOOL_CODE_REVIEWER" 'architecture' "code reviewer covers architecture"
+require_text "$TOOL_CODE_REVIEWER" 'context/contracts/review-contract.md' "code reviewer references review contract"
+
+echo ""
+echo "--- evidence-gate ---"
+require_text "$EVIDENCE" '^name: "evidence-gate"$' "frontmatter name"
+require_text "$EVIDENCE" 'Do not fix code' "report-only gate"
+require_text "$EVIDENCE" 'NOT_VERIFIED' "treats NOT_VERIFIED as first-class"
+require_text "$EVIDENCE" 'Scope And Integrity Check' "checks scope and process integrity"
+require_text "$EVIDENCE" 'Tier 0' "defines evidence tiers"
+require_text "$EVIDENCE" 'passed-after-rerun|passed after rerun' "treats rerun green as degraded confidence"
+require_text "$EVIDENCE" 'Publish Change Gate' "evidence-gate defines publish-change gate"
+require_text "$EVIDENCE" 'Evidence Gate is not Release Readiness' "evidence-gate distinguishes release readiness"
+require_text "$EVIDENCE" 'commit the verified diff' "evidence-gate requires committing verified diff"
+require_text "$EVIDENCE" 'provider change record' "evidence-gate requires provider change publication"
+require_text "$EVIDENCE" 'no-provider-change reason' "evidence-gate allows explicit no-provider-change reason"
+require_text "$EVIDENCE" 'provider checks' "evidence-gate requires provider check evidence"
+require_text "$EVIDENCE" 'Command/Test Evidence' "evidence-gate maps ACs to command/test evidence"
+require_text "$EVIDENCE" 'Source Evidence / Permalinks' "evidence-gate maps ACs to source permalinks"
+require_text "$EVIDENCE" 'prose-only claims' "evidence-gate rejects prose-only behavior evidence"
+require_text "$EVIDENCE" 'GitHub PRs as the first `ChangeProvider` adapter example' "evidence-gate keeps GitHub PR as adapter example"
+
+echo ""
+echo "--- release-readiness ---"
+require_text "$RELEASE" '^name: "release-readiness"$' "frontmatter name"
+require_text "$RELEASE" 'Do not fix code' "report-only release gate"
+require_text "$RELEASE" 'committed, pushed, and represented by a provider change record' "release-readiness requires published provider change"
+require_text "$RELEASE" 'Release Readiness is not Evidence Gate' "release-readiness distinguishes evidence gate"
+require_text "$RELEASE" 'do not make a merge/release/deploy decision from local verification alone' "release-readiness rejects local-only evidence"
+require_text "$RELEASE" 'Missing provider checks also return `HOLD`' "release-readiness holds on missing provider checks by risk"
+require_text "$RELEASE" 'GitHub PRs remain the first `ChangeProvider` adapter example' "release-readiness keeps GitHub PR as adapter example"
+require_text "$RELEASE" 'Do not deploy unless the user explicitly asks' "prevents implicit deploys"
+require_text "$RELEASE" 'rollback_plan' "requires rollback plan"
+require_text "$RELEASE" 'observability_plan' "requires observability plan"
+require_text "$RELEASE" 'post_deploy_checks' "requires post-deploy checks"
+require_text "$RELEASE" 'final_acceptance_docs' "requires final acceptance docs"
+require_text "$RELEASE" 'Docs Gate' "requires docs gate"
+require_text "$RELEASE" 'MERGE' "defines MERGE decision"
+require_text "$RELEASE" 'RELEASE' "defines RELEASE decision"
+require_text "$RELEASE" 'DEPLOY' "defines DEPLOY decision"
+require_text "$RELEASE" 'HOLD' "defines HOLD decision"
+require_text "$RELEASE" 'ROLLBACK_REQUIRED' "defines ROLLBACK_REQUIRED decision"
+
+echo ""
+echo "--- learning-review ---"
+require_text "$LEARNING" '^name: "learning-review"$' "frontmatter name"
+require_text "$LEARNING" 'Do not implement fixes' "report-only learning review"
+require_text "$LEARNING" 'observed facts|facts' "separates facts from interpretation"
+require_text "$LEARNING" 'followups' "requires follow-up routing"
+require_text "$LEARNING" 'knowledge_updates' "requires durable knowledge update tracking"
+require_text "$LEARNING" 'docs_promotion' "requires docs promotion tracking"
+require_text "$LEARNING" 'Docs Gate' "requires learning docs gate"
+require_text "$LEARNING" 'intended behavior.*observed behavior|observed behavior.*intended behavior' "requires intended-vs-observed correction comparison"
+require_text "$LEARNING" 'correction\.needed: false' "defines clean no-correction records"
+require_text "$LEARNING" 'correction\.needed: true' "defines correction-needed mismatch records"
+require_text "$LEARNING" 'correction\.recurrence_key' "requires stable correction recurrence key"
+require_text "$LEARNING" 'correction\.type' "requires typed correction classification"
+require_text "$LEARNING" 'prevention route|no-change rationale|no_change_rationale' "requires correction prevention or no-change rationale"
+require_text "$LEARNING" 'do not invent|not an invented lesson' "prevents invented lessons for clean runs"
+require_text "$LEARNING" 'LEARNED' "defines LEARNED verdict"
+require_text "$LEARNING" 'FOLLOWUP_REQUIRED' "defines FOLLOWUP_REQUIRED verdict"
+require_text "$LEARNING" 'BLOCKED' "defines BLOCKED verdict"
+
+echo ""
+echo "--- map/session ---"
+require_text "$MAP" 'idea-to-backlog' "map includes idea-to-backlog"
+require_text "$MAP" 'builder-shape' "map includes builder-shape"
+require_text "$MAP" 'workflow-usage-guide.md' "map links usage guide"
+require_text "$MAP" 'Phase Composition' "map includes phase composition"
+require_text "$MAP" 'shape-work' "map names future shape-work primitive"
+require_text "$MAP" 'scope-and-integrity-check' "map names future integrity primitive"
+require_text "$USAGE_GUIDE" 'Use idea-to-backlog' "usage guide explains idea-to-backlog"
+require_text "$USAGE_GUIDE" 'Use Builder Kit shape' "usage guide explains Builder Kit shape"
+require_text "$USAGE_GUIDE" 'product-level entry point' "usage guide explains product-level entry points"
+require_text "$USAGE_GUIDE" 'without making you type the primitive name' "usage guide explains Builder Kit shape primitive hiding"
+require_text "$USAGE_GUIDE" 'kits/builder/flows/shape.flow.json' "usage guide links Builder Kit shape flow"
+require_text "$USAGE_GUIDE" 'Use pull-work' "usage guide explains pull-work"
+require_text "$USAGE_GUIDE" 'pull-work -> pickup Probe / design-probe -> plan-work' "usage guide shows pickup Probe before planning"
+require_text "$USAGE_GUIDE" 'build path is `pull-work -> design-probe -> plan`' "usage guide names Builder Kit build path"
+require_text "$USAGE_GUIDE" 'Builder Kit build is the product-level entry point' "usage guide explains Builder Kit build entry point"
+require_text "$USAGE_GUIDE" 'can allow queue inspection, but it cannot authorize planning a newly selected item after merge' "usage guide blocks stale continuation"
+require_text "$USAGE_GUIDE" 'If the board is empty' "usage guide routes empty board to shape"
+require_text "$USAGE_GUIDE" '`probe_status`' "usage guide records probe status"
+require_text "$USAGE_GUIDE" '`probe_artifact_ref`' "usage guide records probe artifact ref"
+require_text "$USAGE_GUIDE" 'Primitive recovery behavior' "usage guide explains primitive recovery"
+require_text "$USAGE_GUIDE" 'Per-item pickup Probe behavior' "usage guide explains per-item probe behavior"
+require_text "$USAGE_GUIDE" 'dependency freshness' "usage guide names pickup Probe dependency freshness"
+require_text "$USAGE_GUIDE" 'acceptance criteria quality' "usage guide names pickup Probe acceptance quality"
+require_text "$USAGE_GUIDE" 'accepted gaps' "usage guide records accepted gaps"
+require_text "$USAGE_GUIDE" 'expected modified files' "usage guide records expected modified files"
+require_text "$USAGE_GUIDE" 'Only ask an alignment question when repo/provider context still leaves a genuine decision gap' "usage guide limits alignment questions"
+require_text "$USAGE_GUIDE" 'planned_base_ref' "usage guide checks planned base ref during pickup"
+require_text "$USAGE_GUIDE" 'planned_base_sha' "usage guide checks planned base sha during pickup"
+require_text "$USAGE_GUIDE" 'contract_drift' "usage guide routes contract drift to alignment"
+require_text "$USAGE_GUIDE" 'Use review-work' "usage guide explains review-work"
+require_text "$USAGE_GUIDE" 'Use evidence-gate' "usage guide explains evidence-gate"
+require_text "$USAGE_GUIDE" 'Publish The Verified Change' "usage guide includes publish-change step"
+require_text "$USAGE_GUIDE" 'commit the verified diff' "usage guide requires committing verified diff"
+require_text "$USAGE_GUIDE" 'open or update the provider change record' "usage guide requires opening or updating provider change record"
+require_text "$USAGE_GUIDE" 'For GitHub, the `ChangeProvider` record is usually a pull request' "usage guide keeps GitHub PR as adapter example"
+require_text "$USAGE_GUIDE" 'Use release-readiness' "usage guide explains release-readiness"
+require_text "$USAGE_GUIDE" 'Use learning-review' "usage guide explains learning-review"
+require_text "$USAGE_GUIDE" 'correction\.needed: false' "usage guide documents clean no-correction learning closeout"
+require_text "$USAGE_GUIDE" 'correction\.needed: true' "usage guide documents correction-needed learning closeout"
+require_text "$USAGE_GUIDE" 'correction rate' "usage guide names future correction rate metric"
+require_text "$USAGE_GUIDE" 'resolved corrections' "usage guide names future resolved corrections metric"
+require_text "$USAGE_GUIDE" 'repeated recurrence keys' "usage guide names future repeated recurrence keys metric"
+require_text "$USAGE_GUIDE" 'stale unresolved corrections' "usage guide names future stale unresolved corrections metric"
+require_text "$USAGE_GUIDE" 'clean-run rate' "usage guide names future clean-run rate metric"
+require_text "$ARTIFACT_LIFECYCLE_DOC" 'Source/Sink storage' "artifact lifecycle keeps Source/Sink out of this correction slice"
+require_text "$EVAL_STRATEGY" 'correction-needed' "eval strategy covers correction/no-correction semantics"
+require_text "$USAGE_GUIDE" 'dogfood-pass' "usage guide explains dogfood-pass"
+require_text "$USAGE_GUIDE" 'Goal Fit' "usage guide explains goal fit"
+require_text "$USAGE_GUIDE" 'promote-workflow-artifact' "usage guide explains docs promotion helper"
+require_text "$USAGE_GUIDE" 'thinnest meaningful slice' "usage guide explains thin-slice guardrail"
+require_text "$USAGE_GUIDE" 'bundle justification' "usage guide explains bundle guardrail"
+require_text "$USAGE_GUIDE" 'route reason' "usage guide requires route reason in handoff"
+require_text "$USAGE_GUIDE" 'next action' "usage guide requires next action in handoff"
+require_text "$USAGE_GUIDE" 'missing_evidence' "usage guide documents missing evidence route-back"
+require_text "$USAGE_GUIDE" 'implementation_defect' "usage guide documents implementation defect route-back"
+require_text "$USAGE_GUIDE" 'plan_gap' "usage guide documents plan gap route-back"
+require_text "$USAGE_GUIDE" 'decision_gap' "usage guide documents decision gap route-back"
+require_text "$USAGE_GUIDE" 'pickup or planning alignment gaps, `decision_gap -> design-probe` means returning to the pickup Probe' "usage guide interprets decision gap route-back"
+require_text "$BUILDER_BUILD_FLOW" '"on_route_back"' "Builder build flow declares route-back mappings"
+require_text "$BUILDER_BUILD_FLOW" '"route_back_policy"' "Builder build flow declares route-back policy"
+require_text "$BUILDER_BUILD_FLOW" '"missing_evidence": "verify"' "Builder build flow routes missing evidence to verify"
+require_text "$BUILDER_BUILD_FLOW" '"implementation_defect": "execute"' "Builder build flow routes implementation defects to execute"
+require_text "$BUILDER_BUILD_FLOW" '"plan_gap": "plan"' "Builder build flow routes plan gaps to plan"
+require_text "$BUILDER_BUILD_FLOW" '"decision_gap": "design-probe"' "Builder build flow routes decision gaps to design-probe"
+require_text "$BUILDER_BUILD_FLOW" '"pull-work", "next": "design-probe"' "Builder build flow routes pull-work to design-probe"
+require_text "$BUILDER_BUILD_FLOW" '"design-probe", "next": "plan"' "Builder build flow routes design-probe to plan"
+require_text "$BUILDER_BUILD_FLOW" '"pickup-probe-readiness"' "Builder build flow requires pickup Probe readiness"
+require_text "$BUILDER_BUILD_FLOW" '"probe-decisions-or-accepted-gaps"' "Builder build flow requires decisions or accepted gaps"
+require_text "$BUILDER_BUILD_FLOW" 'dependency freshness' "Builder build flow gate checks dependency freshness"
+require_text "$BUILDER_BUILD_FLOW" 'acceptance criteria quality' "Builder build flow gate checks acceptance quality"
+require_text "$BUILDER_BUILD_FLOW" 'provider state' "Builder build flow gate checks provider state"
+require_text "$BUILDER_BUILD_FLOW" 'stop-short risks' "Builder build flow gate checks stop-short risks"
+require_text "$BUILDER_BUILD_FLOW" 'Planning is blocked until pickup Probe decisions are captured' "Builder build flow blocks planning until Probe evidence"
+require_text "$BUILDER_BUILD_FLOW" 'probe_status' "Builder build flow names probe status"
+require_text "$BUILDER_BUILD_FLOW" 'probe_artifact_ref' "Builder build flow names probe artifact ref"
+require_text "$BUILDER_BUILD_FLOW" 'Stale broad continuation language after a merge is not sufficient' "Builder build flow blocks stale broad continuation"
+if node - "$BUILDER_BUILD_FLOW" <<'NODE'; then
+const fs = require("node:fs");
+const flow = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const expectations = Object.values(flow.gates || {}).flatMap((gate) => gate.expects || []);
+if (!expectations.length) throw new Error("no Builder Kit gate expectations found");
+for (const expectation of expectations) {
+  if (expectation.kind !== "surface.claim") throw new Error(`${expectation.id || "<unknown>"} is not a surface.claim expectation`);
+  if (!expectation.claim?.type || !expectation.claim?.accepted_statuses) throw new Error(`${expectation.id || "<unknown>"} is missing claim type or accepted statuses`);
+}
+const flowText = JSON.stringify(flow).toLowerCase();
+for (const term of ["veritas", "trust_provider", "trust-provider", "provider_name", "provider_ref", "veritas_policy", "veritas_readiness"]) {
+  if (flowText.includes(term)) throw new Error(`provider-specific trust field leaked into Builder Kit build flow: ${term}`);
+}
+NODE
+  pass "Builder build flow keeps provider-neutral surface.claim expectations"
+else
+  fail "Builder build flow keeps provider-neutral surface.claim expectations"
+fi
+require_text "$MAP" 'pull-work' "map includes pull-work"
+require_text "$MAP" 'pickup Probe before planning' "map documents pickup Probe before planning"
+require_text "$MAP" 'review-work' "map includes review-work"
+require_text "$MAP" 'evidence-gate' "map includes evidence-gate"
+require_text "$MAP" 'release-readiness' "map includes release-readiness"
+require_text "$MAP" 'learning-review' "map includes learning-review"
+require_text "$MAP" 'Publish Change Gate' "map includes publish-change gate"
+require_text "$MAP" 'commit/branch/PR/CI links' "map captures PR and CI links before release"
+require_text "$CONTEXT_MAP" 'Repository Shape' "context map includes repo shape"
+require_text "$CONTEXT_MAP" 'Core Commands' "context map includes commands"
+require_text "$CONTEXT_MAP" 'Workflow Sidecars' "context map includes sidecars"
+require_text "$CONTEXT_MAP" 'packaging/packs.json' "context map includes pack manifest"
+require_text "$PACKS_MANIFEST" '"name": "core"' "pack manifest defines core pack"
+require_text "$PACKS_MANIFEST" '"default": true' "pack manifest defines default pack"
+require_text "$PACKS_MANIFEST" '"name": "development"' "pack manifest defines development pack"
+require_text "$PACKS_MANIFEST" '"eval-rebuild"' "pack manifest includes eval-rebuild"
+require_text "$PACKS_MANIFEST" '"explore"' "pack manifest includes explore"
+require_text "$ROOT/scripts/build-universal-bundles.js" 'FLOW_AGENTS_PACKS' "bundle installer supports pack filtering"
+require_text "$ROOT/evals/integration/test_bundle_install.sh" 'core-pack install keeps core agents' "bundle install test covers pack filtering"
+require_text "$CONTEXT_MAP" 'Context Loading Rules' "context map includes loading rules"
+require_text "$PAGES_INDEX" 'context-map.html' "docs index links context map"
+require_text "$PAGES_INDEX" 'veritas-integration.html' "docs index links Veritas boundary"
+require_text "$PAGES_LAYOUT" 'context-map.html' "docs layout links context map"
+require_text "$PAGES_LAYOUT" 'veritas-integration.html' "docs layout links Veritas boundary"
+require_text "$MAP" 'thinnest meaningful slice' "map captures thin-slice guardrail"
+require_text "$MAP" 'Phase Composition' "docs capture workflow phase composition"
+require_text "$IDEA" 'thinnest meaningful slice' "skills capture thin-slice guardrail"
+require_text "$PULL" 'worktree' "skills capture worktree isolation"
+require_text "$EVIDENCE" 'Evidence Tiers' "skills capture evidence tiers"
+require_text "$MAP" 'release-readiness' "docs capture release-readiness"
+require_text "$MAP" 'learning-review' "docs capture learning-review"
+require_text "$DELIVER" 'dogfood-pass' "deliver skill adopts dogfood-pass"
+require_text "$LEARNING" 'dogfood-pass' "learning-review skill adopts dogfood-pass"
+require_text "$EVAL_STRATEGY" 'Activation-only behavioral evals' "eval strategy distinguishes activation evals"
+require_text "$EVAL_STRATEGY" 'Artifact-quality evals' "eval strategy distinguishes artifact evals"
+require_text "$EVAL_STRATEGY" 'Hook-influence behavioral cases' "eval strategy documents hook influence cases"
+require_text "$EVAL_STRATEGY" 'controlled writes to `.flow-agents/<slug>/\*\.md`' "artifact evals allow controlled todo writes"
+require_text "$EVAL_STRATEGY" 'test_workflow_artifacts.sh' "eval strategy documents artifact E2E integration"
+require_text "$EVAL_STRATEGY" 'HOLD' "eval strategy uses release-readiness HOLD decision"
+require_text "$SHARED_CONTRACTS_DOC" 'Codex, Kiro, Claude Code' "shared contracts doc captures cross-distribution scope"
+require_text "$PAGES_WORKFLOW" 'actions/checkout@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "Pages workflow checks out with an immutable SHA pin and version comment"
+require_text "$PAGES_WORKFLOW" 'actions/configure-pages@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "Pages workflow configures Pages with an immutable SHA pin and version comment"
+require_text "$PAGES_WORKFLOW" 'actions/jekyll-build-pages@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "Pages workflow builds Jekyll docs with an immutable SHA pin and version comment"
+require_text "$PAGES_WORKFLOW" 'actions/upload-pages-artifact@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "Pages workflow uploads docs with an immutable SHA pin and version comment"
+require_text "$PAGES_WORKFLOW" 'actions/deploy-pages@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "Pages workflow deploys docs with an immutable SHA pin and version comment"
+require_file "$CI_WORKFLOW" "Flow Agents CI workflow"
+require_file "$CI_BASELINE" "Flow Agents CI baseline wrapper"
+require_text "$CI_WORKFLOW" 'pull_request:' "CI workflow runs on pull requests"
+require_text "$CI_WORKFLOW" 'workflow_dispatch:' "CI workflow supports manual runs"
+require_text "$CI_WORKFLOW" 'contents: read' "CI workflow uses read-only contents permission"
+require_text "$CI_WORKFLOW" 'bash evals/ci/run-baseline.sh' "CI workflow runs baseline wrapper"
+require_text "$CI_WORKFLOW" 'source-and-static:' "CI workflow has source and static job"
+require_text "$CI_WORKFLOW" 'workflow-contracts:' "CI workflow has workflow contracts job"
+require_text "$CI_WORKFLOW" 'runtime-and-kit:' "CI workflow has runtime and kit job"
+require_text "$CI_WORKFLOW" 'FLOW_AGENTS_CI_LANE: source-and-static' "CI source lane is explicit"
+require_text "$CI_WORKFLOW" 'FLOW_AGENTS_CI_LANE: workflow-contracts' "CI workflow lane is explicit"
+require_text "$CI_WORKFLOW" 'FLOW_AGENTS_CI_LANE: runtime-and-kit' "CI runtime lane is explicit"
+require_text "$CI_WORKFLOW" 'flow-agents-ci-source-and-static' "CI uploads source lane evidence"
+require_text "$CI_WORKFLOW" 'flow-agents-ci-workflow-contracts' "CI uploads workflow lane evidence"
+require_text "$CI_WORKFLOW" 'flow-agents-ci-runtime-and-kit' "CI uploads runtime lane evidence"
+require_text "$CI_WORKFLOW" 'actions/checkout@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "CI workflow checks out with an immutable SHA pin and version comment"
+require_text "$CI_WORKFLOW" 'actions/setup-node@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "CI workflow sets up Node with an immutable SHA pin and version comment"
+require_text "$CI_WORKFLOW" 'actions/upload-artifact@[0-9a-f]{40} # v[0-9]+\.[0-9]+\.[0-9]+' "CI workflow uploads evidence artifacts with an immutable SHA pin and version comment"
+require_text "$CI_BASELINE" 'LANE_SOURCE_AND_STATIC' "CI baseline defines source and static lane"
+require_text "$CI_BASELINE" 'LANE_WORKFLOW_CONTRACTS' "CI baseline defines workflow contracts lane"
+require_text "$CI_BASELINE" 'LANE_RUNTIME_AND_KIT' "CI baseline defines runtime and kit lane"
+require_text "$CI_BASELINE" 'find_active_check' "CI baseline scopes individual checks to the active lane"
+require_text "$CI_BASELINE" 'validate_active_lane \|\| exit 2' "CI baseline validates active lane before running commands"
+require_text "$CI_BASELINE" 'missing CI result row' "CI baseline fails closed on missing lane rows"
+require_text "$CI_BASELINE" 'test_publish_change_helper.sh' "CI baseline includes publish-change helper coverage"
+require_text "$CI_BASELINE" 'test_bundle_install.sh' "CI baseline includes bundle install coverage"
+require_text "$CI_BASELINE" 'LLM acceptance evals' "CI baseline records skipped LLM acceptance"
+reject_text "$CI_BASELINE" 'run\.sh llm' "CI baseline does not run LLM evals by default"
+
+CI_LANE_TEST_DIR="$(mktemp -d "${TMPDIR:-/tmp}/flow-agents-ci-lanes.XXXXXX")"
+require_status 2 "CI baseline rejects invalid lane during init" \
+  env FLOW_AGENTS_CI_LANE=not-a-lane FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/invalid-init" bash "$CI_BASELINE" --init
+require_status 2 "CI baseline rejects invalid lane during check" \
+  env FLOW_AGENTS_CI_LANE=not-a-lane FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/invalid-check" bash "$CI_BASELINE" --check content-boundary
+require_status 2 "CI baseline rejects invalid lane during finalize" \
+  env FLOW_AGENTS_CI_LANE=not-a-lane FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/invalid-finalize" bash "$CI_BASELINE" --finalize
+require_status 2 "CI baseline rejects invalid lane during full run" \
+  env FLOW_AGENTS_CI_LANE=not-a-lane FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/invalid-full" bash "$CI_BASELINE"
+require_status 2 "CI baseline rejects invalid explicit lane" \
+  env FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/invalid-explicit-lane" bash "$CI_BASELINE" --lane not-a-lane
+require_status 2 "CI baseline rejects checks outside the active lane" \
+  env FLOW_AGENTS_CI_LANE=source-and-static FLOW_AGENTS_CI_RESULTS_DIR="$CI_LANE_TEST_DIR/wrong-lane-check" bash "$CI_BASELINE" --check bundle-install-integration
+require_status 1 "CI baseline fails closed on missing expected lane rows" \
+  bash -c 'FLOW_AGENTS_CI_LANE=source-and-static FLOW_AGENTS_CI_RESULTS_DIR="$1" bash "$0" --init && FLOW_AGENTS_CI_LANE=source-and-static FLOW_AGENTS_CI_RESULTS_DIR="$1" bash "$0" --finalize' "$CI_BASELINE" "$CI_LANE_TEST_DIR/missing-rows"
+
+require_text "$PAGES_INDEX" 'mermaid' "docs index includes Mermaid graph"
+require_text "$PAGES_LAYOUT" 'assets/site.css' "docs layout uses shared CSS"
+require_text "$PAGES_LAYOUT" 'assets/site.js' "docs layout uses shared JS"
+require_text "$PAGES_LAYOUT" 'data-theme-toggle' "docs layout exposes theme toggle"
+require_text "$PAGES_CSS" 'data-theme="dark"' "docs CSS includes dark theme"
+require_text "$PAGES_CSS" 'prefers-reduced-motion' "docs CSS respects reduced motion"
+require_text "$PAGES_JS" 'localStorage' "docs JS persists theme"
+require_text "$PAGES_JS" 'mermaid' "docs JS renders Mermaid"
+
+echo ""
+echo "--- legacy terms ---"
+reject_text_many 'schedule-prompt|k''brain|\.kiro-agents' "no legacy naming in workflow artifacts" "$IDEA" "$PULL" "$EVIDENCE" "$RELEASE" "$LEARNING" "$DELIVER" "$PLAN_WORK" "$VERIFY_WORK" "$MAP" "$USAGE_GUIDE" "$EVAL_STRATEGY" "$SHARED_CONTRACTS_DOC"
+reject_text "$KIT_REPOSITORY_DOC" '\bpack(s|age|aged|aging)?\b' "kit repository contract avoids public pack vocabulary"
+reject_text_many 'remote install|git fetch|npm split|runtime adapter activation' "kit repository validation and fixtures avoid scoped-out implementation behavior" "$ROOT/scripts/validate-source-tree.js" "$ROOT/evals/integration/test_flow_kit_repository.sh" "$ROOT/evals/fixtures/flow-kit-repository"
+if [[ "${#ACTIVE_GUIDANCE_SURFACES[@]}" -gt 0 ]]; then
+  reject_text_many 'tool-reviewer' "retired tool-reviewer is absent from active guidance surfaces" "${ACTIVE_GUIDANCE_SURFACES[@]}"
+  reject_text_many '--phase[[:space:]]+review|phase:[[:space:]]*review|state\.phase:[[:space:]]*review' "active guidance surfaces do not instruct review as a sidecar phase" "${ACTIVE_GUIDANCE_SURFACES[@]}"
+else
+  fail "active guidance surfaces were not discovered"
+fi
+
+echo ""
+if [[ "$errors" -eq 0 ]]; then
+  echo "Workflow skill contracts passed."
+  exit 0
+fi
+
+echo "Workflow skill contracts failed: $errors issue(s)."
+exit 1