docs: promote AR-designed product identity

[scrimshawlife-ctrl]

issue: 252
project_item: INTAKE_PENDING
agent: Jcode
lane: DOCS
base_sha: 90de100cb6d42c97a8886a3e311e7d47eaa59401
head_sha: 6660ca4
workstream: Documentation
dependency_state: RESOLVED
handoff_state: READY
evidence: PARTIAL

Linked Issue and Bounded Objective

Closes #252

Promote the ratified Phase 0 identity into binding product law and repository context without changing AR runtime, mesh assets, or gameplay behavior.

Authority Context

• Canonical documents consulted: docs/SOLO_MVP_SCOPE.md, WAYKIN_SPEC.md, README.md, ARCHITECTURE.md, AGENTS.md, docs/governance/DOCUMENT_AUTHORITY.md
• Future/reference documents consulted: docs/design/AR_PRODUCT_REDESIGN_MAP.md, docs/plans/AR_APP_REDESIGN_PLAN.md, docs/canonical/MVP_TO_VISION_LADDER.md
• Architecture decision added or changed: no. Presentation priority wording changed; gameplay and dependency ownership remain unchanged.

Files Changed

• Binding scope/spec, README hero/pillars, and architecture presentation narrative
• Terms and historical/current design references
• Shared and repo-tracked skill context
• Non-behavioral Demo/audio comments and strings
• Phase 0 status and remaining Phase 1/2 gates

Frozen Paths Acknowledgement

• Declared frozen paths were not changed.

Acceptance Criteria

• Binding docs define Waykin as AR-designed rather than audio-first.
• AR is primary designed session surface when capable.
• Movement remains gameplay authority.
• Audio remains required supporting and pocket-safe presentation.
• No AR runtime, mesh, USDZ, gameplay, or asset behavior changed.
• Remaining audio-first references are explicitly prior/historical or acceptance-query text.
• Phase 2 stays gated behind Phase 1 evidence and a scoped unfreeze issue.

Validation

Command	Result	Exact test total
make build	NOT_COMPUTABLE locally: Swift unavailable; CI requested	N/A
make test	NOT_COMPUTABLE locally: Swift unavailable; CI requested	N/A
make validate	PARTIAL locally: host-supported guards PASS; Ruby/Swift/Xcode unavailable	N/A
make validate-simulator	NOT_APPLICABLE: no visible behavior change	N/A
git diff --check	PASS	N/A
./scripts/check_core_framework_isolation.sh	PASS	N/A
./scripts/test_check_core_framework_isolation.sh	PASS	23 cases
./scripts/check_lira_usdz_integrity.sh	PASS, package unchanged	N/A
shell/Python syntax checks	PASS	N/A

Evidence

OBSERVED results

• Current-authority paths contain no audio-first product identity hits.
• All intended paths describe AR-designed identity and supporting audio consistently.
• No App/AR/**, companion resource, USDZ, or mesh-tooling path changed.
• Core isolation and Ember Fox package integrity pass locally.

INFERRED results

• Agent and contributor work will now follow one channel-order contract instead of conflicting binding/supporting identities.

Blockers

• Full Swift/Xcode validation is delegated to macOS CI because this host has no Swift or Xcode.
• GitHub Project metadata remains INTAKE_PENDING because the token lacks read:project scope.

Scope Guard

• No unrelated product behavior, architecture authority, gameplay semantics, or features were added.

Physical-Device Evidence Declaration

Physical GPS, audio, AR tracking, interruption recovery, battery, thermal, and outdoor usability evidence: NOT_APPLICABLE to this documentation-only change. Existing device claims remain unchanged.

Risk, Rollback, and Documentation

• Risk: Low. Broad documentation/context wording change with no behavioral code.
• Rollback: Revert commit 6660ca4.
• Documentation updated: binding scope/spec, README, architecture, legal terms, design maps, and skill context.

Agent and Stack Context

• Agent assistance used: Jcode
• Parent or superseded PR: NONE

Merge Control

• Automatic merge is disabled; merge requires the repository's formal approval and validation gates.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6660ca4d9b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[scrimshawlife-ctrl]

Validation handoff

All required GitHub checks passed on head 6660ca4:

• validate: PASS, 2m20s
• swift-package: PASS, 1m17s
• native-ios build + native/UI tests: PASS, 12m28s
• local git diff --check: PASS
• core isolation: PASS
• isolation harness: PASS, 23 cases
• Ember Fox USDZ integrity: PASS and frozen assets unchanged

App/AR/**, companion resources, USDZ assets, and mesh tooling are untouched. Phase 2 remains gated behind Phase 1 device evidence and a separate scoped unfreeze issue. Ready for required formal approval. Automatic merge remains disabled.

[prabu-openclaw]

Approving. This is the Phase 0 identity change I flagged on #245 and #251, and it lands it properly.

The "no behavior change" claim is accurate — I checked, because four code files is unusual for a docs: PR. All four are comments or copy:

File	Change
AppAudioCuePlayer.swift	comment wording only; the setCategory(.playback, …) line is untouched
App/Info.plist	comment above UIBackgroundModes
project.yml	comment
Demo/main.swift	one print string

So the audio session fix and background mode survive intact.

Invariants preserved where it matters:

• "Movement is gameplay authority" stated explicitly, not softened
• Adapters still "may not become alternate gameplay authorities"
• Semantic audio required, not demoted to optional — correct, and it is the layer with the strongest device evidence
• The "no major system until repeated physical sessions show return intent" guard retained
• Freeze not lifted: "Phase 0 promotes AR-designed identity without lifting frozen production paths"

The strongest addition is the new invariant: a walk must remain safe and completable when AR is denied, unavailable, or degraded. That is the right guard for an AR-primary identity, and the app satisfies it today — the session surface, audio, Bond and memory all function with the AR cover never opened.

One asymmetry worth naming, not blocking. The header says evidence: PARTIAL, and this promotes AR to primary while AR is the layer with the least device-verified evidence — #41 outdoor is still open, #247 still holds the archive on confirming the authored mesh on device. Audio is currently the most proven layer on real walks. That is a legitimate product bet rather than an inconsistency, but the ordering means the new primary surface should carry the heavier evidence burden going forward, not a lighter one.

[scrimshawlife-ctrl]

Addressed Codex P2: dropped Multi-channel Presentation Layer as a primary system. Scope now keeps Audio Experience Layer (required) and AR presentation adapter (primary designed surface when capable) as distinct owners, with 2D/map/HUD supporting — not a generalized multi-channel platform.

[scrimshawlife-ctrl]

Superseded by consolidated suite: https://github.com/Zero-State-LLC/Waykin/pull/1 which includes Phase 0 identity + presentation-owner review fix + SemVer/docs. CI was green; merging via org repo without self-approval block. Closing here to avoid double-merge.