Evidence Bundle

Evidence Bundle

Evidence Bundle은 완료를 주장하기 전에 남기는 최소 사실 묶음이다. Life Cockpit에서는 두 종류의 evidence가 있다.

1. handbook/product-contract evidence
2. future app/prototype evidence

지금 v0.5는 첫 번째를 다루고, 앱 구현 전 stack role decision evidence를 추가한다. 앱 구현이 시작되면 두 번째를 더 두껍게 만든다.

R1: Handbook Update

작은 handbook 업데이트는 아래로 충분하다.

Verification:
- npm run build
- git diff --check
- curl -fsS http://127.0.0.1:35003/ | rg '<expected text>'

Behavior:
- Added product/prototype contract page.
- Updated sidebar and version note.

Residual risk:
- Not deployed unless explicitly requested.

R2: Prototype Contract Update

prototype 계약, URL 정책, safety boundary가 바뀌면 더 두껍게 남긴다.

Task brief:
BDD scenario:
Affected pages:
Safety boundary:
URL policy impact:
Commands run:
Results:
Local preview read-back:
Deployment/read-back:
Residual risks:

R3: Future App Prototype

실제 앱 prototype이 생기면 아래 증거가 필요하다.

Evidence	Required
model/unit test	Task, Quest, Session, RouteLog lifecycle
browser/system read-back	state selection -> quest -> session -> route log
data sample	task 10개 seed, outcome 4종 중 최소 2종
safety check	medical claim, guilt score, hidden sensing 없음
URL check	/app/* noindex/private policy
build result	app build/test command

R4: Stack Decision Update

prototype implementation stack을 추가하거나 바꾸면 아래 증거가 필요하다.

Evidence	Required
Official docs checked	vendor official docs or official repository read this turn
Stack boundary	what the stack owns and what remains outside it
Risk review	accessibility, privacy, telemetry, data boundary, deploy boundary
Build/read-back	handbook build and local route read-back

For stack role decisions, evidence must include:

Phaser stable/version source
Official Phaser Vite TypeScript template source
Vite official setup/source
SvelteKit official project type/source if SvelteKit is considered
Rails official release/getting-started source if Rails is considered
Prototype boundary: Phaser scene only, domain model outside scene
Productization boundary: SvelteKit candidate vs Rails durable shell
Telemetry/logging decision: disable or remove template usage logging before sensitive local use

Local Preview Read-Back

Current handbook preview target:

http://127.0.0.1:35003/

Core read-back paths:

curl -fsS http://127.0.0.1:35003/book/03-prototype-contract/ | rg 'Prototype Contract'
curl -fsS http://127.0.0.1:35003/book/04-object-lifecycle/ | rg 'Object Lifecycle'
curl -fsS http://127.0.0.1:35003/book/05-implementation-stack/ | rg 'Phaser 4|SvelteKit|Rails 8'
curl -fsS http://127.0.0.1:35003/reference/url-policy/ | rg 'Life Cockpit URL Policy'
curl -fsS http://127.0.0.1:35003/delivery/evidence-bundle/ | rg 'Evidence Bundle'

Deploy Read-Back

Deployment is not automatic. If deployed, evidence must include:

Deploy command:
Deployment URL:
Production URL:
HTTP status:
Expected Access/noindex behavior:
Release note updated:

For a noindex public-readable handbook, read back both the content and the meta policy.

curl -s https://logan-life-cockpit-research.pages.dev/ | rg 'Life Cockpit Product Gate'
curl -s https://logan-life-cockpit-research.pages.dev/ | rg 'noindex, nofollow'

Failure Transparency

If verification fails, report it as failure.

무엇이 실패했는지:
어디에서 확인했는지:
영향 범위:
지금 안전한 다음 액션:

Do not call the work done until the failing evidence is either fixed or explicitly recorded as residual risk.