From 3631a4c5d860f8fc9aed639e8f6bdc0dba47859d Mon Sep 17 00:00:00 2001 From: Daniel Meyer Date: Wed, 29 Jul 2026 13:18:15 -0700 Subject: [PATCH 1/4] docs: mark freeze #249 merged on main tip d8c0620 Point ACTIVE_WORK at post-merge main HEAD and promote indoor Ember Fox smoke as the next human lane. --- docs/collaboration/ACTIVE_WORK.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/collaboration/ACTIVE_WORK.md b/docs/collaboration/ACTIVE_WORK.md index 97ac73b..072957e 100644 --- a/docs/collaboration/ACTIVE_WORK.md +++ b/docs/collaboration/ACTIVE_WORK.md @@ -2,7 +2,7 @@ This file is a repository-readable coordination surface for humans and coding agents. GitHub issues and pull requests remain the authoritative records. -Last updated: 2026-07-29 (**FREEZE LANE** — re-baseline docs + laptop baseline on lineage `7df3a16`; no redesign until freeze merges) +Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device indoor next; no redesign until device honesty) > **Coordination contract:** [Issue #47](https://github.com/scrimshawlife-ctrl/Waykin/issues/47) · **Live workflow:** [Project #1](https://github.com/users/scrimshawlife-ctrl/projects/1) · [Coordination protocol](GITHUB_PROJECT_COORDINATION.md) @@ -10,8 +10,8 @@ Last updated: 2026-07-29 (**FREEZE LANE** — re-baseline docs + laptop baseline | Work | Owner | Status | Dependency | |---|---|---|---| -| **Freeze: docs re-baseline + laptop receipt** | Docs / eng | **PR open** — [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) (`docs/current-main-rebaseline`); receipt + Prabu mesh ref; merge before build-on-top | [CONTINUATION_PLAN.md](../design/CONTINUATION_PLAN.md) · [PR #249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) | -| Indoor Ember Fox smoke | Human device | **Scaffold ready** — fill [INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md) after #249 merge; visual gold = Prabu IMG_2534 | [INDOOR_AR_HYBRID_SMOKE.md](../design/INDOOR_AR_HYBRID_SMOKE.md) · [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) | +| **Freeze: docs re-baseline + laptop receipt** | Docs / eng | **Merged** — [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) → main `d8c0620` | [CONTINUATION_PLAN.md](../design/CONTINUATION_PLAN.md) · [POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md](../design/receipts/POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md) | +| Indoor Ember Fox smoke | Human device | **Next** — install main `d8c0620`; fill [INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md); visual gold = Prabu IMG_2534 | [INDOOR_AR_HYBRID_SMOKE.md](../design/INDOOR_AR_HYBRID_SMOKE.md) · [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) | | Prabu device mesh reference | Prabu (historical OBSERVED) | **Authored fox on device** (not procedural spheres); strip `animated_usdz` + `anim=PLAYING` — **SHA not on photo** | [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) · evidence PNG | | Issue #41 — outdoor / physical validation | Human device | **Parked** — scaffold [OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md); walk after indoor preferred | [DEFERRED_RECOMMENDATIONS.md](../design/DEFERRED_RECOMMENDATIONS.md) | | Issue #247 — TF archive hold | Product / dist | **Softened, not closed** — Prabu photo shows authored mesh on *some* build; still need OBSERVED on **exact freeze/archive SHA** before TF | [#247](https://github.com/scrimshawlife-ctrl/Waykin/issues/247) | @@ -23,9 +23,11 @@ Last updated: 2026-07-29 (**FREEZE LANE** — re-baseline docs + laptop baseline | Field | Value | |---|---| -| Code lineage (app/mesh binary) | `7df3a169ede507ce54469330318f66c4603f8c3d` (`7df3a16`) — Ember Fox #246 + pressure #248 | -| Freeze docs PR | [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) — docs-only on top of code lineage; **after merge**, `main` tip moves to the freeze merge commit | -| Install / device / #247 SHA rule | Always `git pull` then record **`git rev-parse HEAD`** of the install build. Do **not** treat `7df3a16` as the post-freeze archive tip once #249 lands — use the **current `main` tip** at install time | +| `main` tip (full) | `d8c062013fea4e0e0fc7fe661b050f12135d9163` | +| `main` tip (short) | `d8c0620` | +| Code lineage (app/mesh binary) | Unchanged from `7df3a16` (Ember Fox #246 + pressure #248); freeze #249 is docs/evidence only | +| Freeze docs | [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) **merged** | +| Install / device / #247 SHA rule | Install **`d8c0620`** (or later main HEAD after `git pull`); record exact `git rev-parse HEAD` on the device build | | Current companion | Packaged **Ember Fox** USDZ (`MESHY_EMBER_FOX_WALK_V1`) | | Mesh integration authority | [PR #246](https://github.com/scrimshawlife-ctrl/Waykin/pull/246) (`b17864e`) | | Mesh runtime | Versioned asynchronous template loading; procedural fallback; live authored replacement; scene-owned anchors explicitly removed | @@ -55,8 +57,8 @@ Last updated: 2026-07-29 (**FREEZE LANE** — re-baseline docs + laptop baseline ## Operator order (human) -1. **Merge freeze docs #249**, then `git checkout main && git pull --ff-only` and record **exact HEAD**. -2. **Connect iPhone** → install Debug of **that HEAD** (not a remembered parent short SHA) → indoor Ember Fox smoke (fallback → authored replace, single anchor, skeleton walk; match Prabu visual ref) → `evidence_class: OBSERVED` (note indoor). +1. `git checkout main && git pull --ff-only` → tip should be **`d8c0620`** (or later). +2. **Connect iPhone** → install Debug of **that HEAD** → indoor Ember Fox smoke (I1–I14; match Prabu visual ref) → `evidence_class: OBSERVED` (note indoor). 3. Confirm #247 can close only with **device** evidence on the **exact install SHA** that the authored mesh replaced the procedural fallback. 4. **Archive Release** only after #247 hold lifts and validate PASS on archive SHA; re-check marketing/build if prior candidate was already uploaded. 5. **Daylight outdoor #41** on the same install SHA when free; COH only with OBSERVED device rows. Mesh/runtime rows and world-event rows stay separate. From 0019a32a5b9f064436ac48e55f20dc2ae22eb025 Mon Sep 17 00:00:00 2001 From: Daniel Meyer Date: Wed, 29 Jul 2026 13:18:26 -0700 Subject: [PATCH 2/4] docs: pin merge hygiene line to post-#249 main tip --- docs/collaboration/ACTIVE_WORK.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/collaboration/ACTIVE_WORK.md b/docs/collaboration/ACTIVE_WORK.md index 072957e..fa3e438 100644 --- a/docs/collaboration/ACTIVE_WORK.md +++ b/docs/collaboration/ACTIVE_WORK.md @@ -101,7 +101,7 @@ See [DEFERRED_RECOMMENDATIONS.md](../design/DEFERRED_RECOMMENDATIONS.md). ## Merge hygiene ```text -Code lineage: 7df3a16 · freeze docs: #249 · companion: Ember Fox (MESHY_EMBER_FOX_WALK_V1) +Main tip: d8c0620 (freeze #249) · companion: Ember Fox (MESHY_EMBER_FOX_WALK_V1) · code lineage 7df3a16 After #249 merges: install/record current main HEAD (not a remembered parent short SHA) Ruleset: 1 write-access approving review + resolved conversations required Do not re-import or replace the Ember Fox mesh without an explicit asset issue From 242ccf0afcb31bfb7ff142c6c17f5cefc0e69a54 Mon Sep 17 00:00:00 2001 From: Daniel Meyer Date: Wed, 29 Jul 2026 14:23:54 -0700 Subject: [PATCH 3/4] docs: stop pinning live main tip to freeze merge SHA Codex review: d8c0620 is #249 merge/base lineage; install SHA must come from post-pull HEAD so the ledger stays accurate after later merges. --- docs/collaboration/ACTIVE_WORK.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/collaboration/ACTIVE_WORK.md b/docs/collaboration/ACTIVE_WORK.md index fa3e438..5844a3a 100644 --- a/docs/collaboration/ACTIVE_WORK.md +++ b/docs/collaboration/ACTIVE_WORK.md @@ -2,7 +2,7 @@ This file is a repository-readable coordination surface for humans and coding agents. GitHub issues and pull requests remain the authoritative records. -Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device indoor next; no redesign until device honesty) +Last updated: 2026-07-29 (**FREEZE MERGED** — #249; device indoor next; no redesign until device honesty) > **Coordination contract:** [Issue #47](https://github.com/scrimshawlife-ctrl/Waykin/issues/47) · **Live workflow:** [Project #1](https://github.com/users/scrimshawlife-ctrl/projects/1) · [Coordination protocol](GITHUB_PROJECT_COORDINATION.md) @@ -10,8 +10,8 @@ Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device i | Work | Owner | Status | Dependency | |---|---|---|---| -| **Freeze: docs re-baseline + laptop receipt** | Docs / eng | **Merged** — [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) → main `d8c0620` | [CONTINUATION_PLAN.md](../design/CONTINUATION_PLAN.md) · [POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md](../design/receipts/POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md) | -| Indoor Ember Fox smoke | Human device | **Next** — install main `d8c0620`; fill [INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md); visual gold = Prabu IMG_2534 | [INDOOR_AR_HYBRID_SMOKE.md](../design/INDOOR_AR_HYBRID_SMOKE.md) · [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) | +| **Freeze: docs re-baseline + laptop receipt** | Docs / eng | **Merged** — [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) (merge SHA `d8c0620`) | [CONTINUATION_PLAN.md](../design/CONTINUATION_PLAN.md) · [POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md](../design/receipts/POST_EMBER_FOX_BASELINE_20260729T190249Z_1378307.md) | +| Indoor Ember Fox smoke | Human device | **Next** — `git pull` + install **current main HEAD**; fill tip-bound indoor receipt; visual gold = Prabu IMG_2534 | [INDOOR_AR_HYBRID_SMOKE.md](../design/INDOOR_AR_HYBRID_SMOKE.md) · [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) · scaffold [INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md) | | Prabu device mesh reference | Prabu (historical OBSERVED) | **Authored fox on device** (not procedural spheres); strip `animated_usdz` + `anim=PLAYING` — **SHA not on photo** | [DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md](../design/receipts/DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md) · evidence PNG | | Issue #41 — outdoor / physical validation | Human device | **Parked** — scaffold [OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md](../design/receipts/OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md); walk after indoor preferred | [DEFERRED_RECOMMENDATIONS.md](../design/DEFERRED_RECOMMENDATIONS.md) | | Issue #247 — TF archive hold | Product / dist | **Softened, not closed** — Prabu photo shows authored mesh on *some* build; still need OBSERVED on **exact freeze/archive SHA** before TF | [#247](https://github.com/scrimshawlife-ctrl/Waykin/issues/247) | @@ -23,11 +23,10 @@ Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device i | Field | Value | |---|---| -| `main` tip (full) | `d8c062013fea4e0e0fc7fe661b050f12135d9163` | -| `main` tip (short) | `d8c0620` | -| Code lineage (app/mesh binary) | Unchanged from `7df3a16` (Ember Fox #246 + pressure #248); freeze #249 is docs/evidence only | -| Freeze docs | [#249](https://github.com/scrimshawlife-ctrl/Waykin/pull/249) **merged** | -| Install / device / #247 SHA rule | Install **`d8c0620`** (or later main HEAD after `git pull`); record exact `git rev-parse HEAD` on the device build | +| Live `main` tip | **Do not pin a fixed short SHA here after every docs merge.** Run `git checkout main && git pull --ff-only && git rev-parse HEAD` and record that full SHA on the install/receipt | +| Freeze merge (#249) | `d8c062013fea4e0e0fc7fe661b050f12135d9163` (`d8c0620`) — docs/evidence freeze; **base lineage**, not forever the live tip after later merges | +| Code lineage (app/mesh binary) | Unchanged from `7df3a169ede507ce54469330318f66c4603f8c3d` (`7df3a16`) — Ember Fox #246 + pressure #248 | +| Install / device / #247 SHA rule | Install **current main HEAD after pull**; record exact `git rev-parse HEAD` on the device build. Minimum freeze base: ≥ `d8c0620` | | Current companion | Packaged **Ember Fox** USDZ (`MESHY_EMBER_FOX_WALK_V1`) | | Mesh integration authority | [PR #246](https://github.com/scrimshawlife-ctrl/Waykin/pull/246) (`b17864e`) | | Mesh runtime | Versioned asynchronous template loading; procedural fallback; live authored replacement; scene-owned anchors explicitly removed | @@ -36,7 +35,7 @@ Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device i | Marketing / build (in tree) | **0.9.0 (2)** — **revalidate** before retaining as RC; #247 holds archive | | Last pre-mesh Phase A receipt | `3cc8ac2` / tip `d7954ac` era — **historical**; re-run validate on current tip | | Open implementation issues | [#41](https://github.com/scrimshawlife-ctrl/Waykin/issues/41), [#247](https://github.com/scrimshawlife-ctrl/Waykin/issues/247) (re-query at execution; do not assume “#41 only”) | -| Open PRs (non-mesh) | #245 (docs redesign, supporting), #244 (license) — treat as separate lanes | +| Open PRs (non-mesh) | #245 (docs redesign, supporting), #244 (license), board sync — treat as separate lanes | ## Recently completed (main) @@ -57,8 +56,8 @@ Last updated: 2026-07-29 (**FREEZE MERGED** — #249 on main `d8c0620`; device i ## Operator order (human) -1. `git checkout main && git pull --ff-only` → tip should be **`d8c0620`** (or later). -2. **Connect iPhone** → install Debug of **that HEAD** → indoor Ember Fox smoke (I1–I14; match Prabu visual ref) → `evidence_class: OBSERVED` (note indoor). +1. `git checkout main && git pull --ff-only` → record **`git rev-parse HEAD`** (must be ≥ freeze merge `d8c0620`). +2. **Connect iPhone** → install Debug of **that HEAD** → indoor Ember Fox smoke (I1–I14; match Prabu visual ref) → `evidence_class: OBSERVED` (note indoor). Prefer regenerating the PENDING receipt with `scripts/indoor_ar_smoke_prep.sh` so the scaffold pins the install SHA. 3. Confirm #247 can close only with **device** evidence on the **exact install SHA** that the authored mesh replaced the procedural fallback. 4. **Archive Release** only after #247 hold lifts and validate PASS on archive SHA; re-check marketing/build if prior candidate was already uploaded. 5. **Daylight outdoor #41** on the same install SHA when free; COH only with OBSERVED device rows. Mesh/runtime rows and world-event rows stay separate. @@ -101,8 +100,8 @@ See [DEFERRED_RECOMMENDATIONS.md](../design/DEFERRED_RECOMMENDATIONS.md). ## Merge hygiene ```text -Main tip: d8c0620 (freeze #249) · companion: Ember Fox (MESHY_EMBER_FOX_WALK_V1) · code lineage 7df3a16 -After #249 merges: install/record current main HEAD (not a remembered parent short SHA) +Freeze merge (#249): d8c0620 · companion: Ember Fox (MESHY_EMBER_FOX_WALK_V1) · code lineage 7df3a16 +Live install tip: git pull + git rev-parse HEAD (never a remembered short alone) Ruleset: 1 write-access approving review + resolved conversations required Do not re-import or replace the Ember Fox mesh without an explicit asset issue Do not merge closed PRs #242 or #243 (superseded by #246) From ce302b30869635b6fb7a6d1ec0628dea75145d5c Mon Sep 17 00:00:00 2001 From: Daniel Meyer Date: Wed, 29 Jul 2026 14:24:26 -0700 Subject: [PATCH 4/4] docs: post-freeze device lane handoff for indoor smoke --- .../DEVICE_LANE_HANDOFF_POST_FREEZE.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/design/receipts/DEVICE_LANE_HANDOFF_POST_FREEZE.md diff --git a/docs/design/receipts/DEVICE_LANE_HANDOFF_POST_FREEZE.md b/docs/design/receipts/DEVICE_LANE_HANDOFF_POST_FREEZE.md new file mode 100644 index 0000000..6d5e573 --- /dev/null +++ b/docs/design/receipts/DEVICE_LANE_HANDOFF_POST_FREEZE.md @@ -0,0 +1,53 @@ +# Device lane handoff (post freeze #249) + +```yaml +document_id: WAYKIN-DEVICE-LANE-HANDOFF +date: 2026-07-29 +freeze_merge: d8c062013fea4e0e0fc7fe661b050f12135d9163 +code_lineage: 7df3a169ede507ce54469330318f66c4603f8c3d +status: HUMAN_DEVICE_NEXT +``` + +## Agent readiness (OBSERVED laptop) + +| Item | Status | +| ---- | ------ | +| Freeze docs #249 on main | Merged | +| Laptop baseline receipt | PASS (package + validate + simulator) | +| Indoor protocol v2 (Ember Fox) | On main | +| Indoor scaffold | `INDOOR_AR_HYBRID_SMOKE_20260729T191500Z_7df3a16_PENDING.md` (regen with prep script on install tip) | +| Outdoor scaffold | `OUTDOOR_QA_RECEIPT_20260729T191500Z_7df3a16_PENDING.md` | +| Prabu visual gold standard | `DEVICE_MESH_REFERENCE_PRABU_IMG_2534.md` | +| Physical device (this machine) | **NOT_COMPUTABLE** — iPhone listed offline/unavailable | + +## Human install steps + +```bash +cd /path/to/Waykin +git checkout main && git pull --ff-only +SHA=$(git rev-parse HEAD) +echo "install_sha=$SHA" # must be ≥ d8c0620 +make check-lira-usdz +make validate # optional if already green on tip +# Prefer regenerating tip-bound receipt: +bash scripts/indoor_ar_smoke_prep.sh +# Install Debug to phone (Xcode / xcodebuild -destination id=…) +``` + +## Indoor smoke (must fill) + +1. Protocol: `docs/design/INDOOR_AR_HYBRID_SMOKE.md` (I1–I14) +2. Visual: match Prabu fox still — not procedural spheres +3. Receipt: tip-bound PENDING → fill with `evidence_class: OBSERVED` (note indoor) +4. Share field-test JSON schema ≥ 5 + +## After indoor + +- Close or re-scope **#247** only with tip-bound OBSERVED authored mesh +- Outdoor **#41** daylight on same install SHA +- No AR redesign PRs until product-law Phase 0 after device honesty + +## Explicit non-claims + +- This handoff is not outdoor PASS +- This handoff is not TF archive approval