feat: pin Traverse-published starter agents for embedded smoke

[enricopiovesan]

Summary

• Replace App-Refs hand-built WASI smoke stand-ins with digest-pinned Traverse-published traverse-starter example agents (validate / process / summarize)
• Prepare path verifies digests + provenance (digests.json), overlays pins onto $TRAVERSE_REPO and the synced web bundle
• Add scripts/ci/pin_traverse_starter_smoke_agents.sh to refresh pins from a Traverse checkout; document agent provenance in playbook / getting-started / quality standards

Governing Spec

• App-References UI-only boundary (constitution) — no business field computation in UI/host TypeScript
• Traverse agent artifact execution (516-agent-artifact-execution / #795/#809) — consume published stdout agents

Project Item

• Ticket ID: consume-product-wasm-agents
• Issue: Consume Traverse product WASM agents (replace App-Refs smoke fixtures) #226
• Project 2 item: PVTI_lADOEbiBt84BbzAzzgzhrVQ

Definition of Done

• Smoke prepare path pins Traverse-published agents (not App-Refs hand-built WASI stand-ins)
• embedded_smoke.sh still requires runtime-owned validate/process/summarize fields
• No business field computation added in UI/host TypeScript
• Docs describe agent provenance (playbook / getting-started / fixture README + digests.json)
• Digests match Traverse origin/main @ b00a5c4fb8f93503932afd52eadda5e2fe8d04d0

Validation

bash scripts/ci/repository_checks.sh
export TRAVERSE_REPO=/path/to/Traverse
bash scripts/ci/prepare_embedded_smoke_bundle.sh
export EMBEDDED_SMOKE_EXPECT=linux
bash scripts/ci/embedded_smoke.sh
# local: PASS pass=8 skip=4 fail=0 — web title="Review Traverse starter app registration"
npm run test:coverage --workspace=apps/traverse-starter/web-react
# 20 passed; traverseOutput.ts + embeddedHost.ts 100% lines

Platform checklist

• Runtime mode — Embedded smoke path only (no sidecar)
• SDK test doubles — unchanged; no faked business fields
• CI commands — repository_checks + prepare + embedded_smoke + coverage
• Docs — playbook / getting-started / quality-standards / production-reference-plan / AGENTS.md
• No private Traverse internals imported

Made with Cursor