Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 12 additions & 11 deletions docs/collaboration/ACTIVE_WORK.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,16 @@

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; 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)

## Active

| 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) (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) |
Expand All @@ -23,9 +23,10 @@ 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 |
| 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 |
Expand All @@ -34,7 +35,7 @@ Last updated: 2026-07-29 (**FREEZE LANE** — re-baseline docs + laptop baseline
| 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)

Expand All @@ -55,8 +56,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` → 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.
Expand Down Expand Up @@ -99,8 +100,8 @@ 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)
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)
Expand Down
53 changes: 53 additions & 0 deletions docs/design/receipts/DEVICE_LANE_HANDOFF_POST_FREEZE.md
Original file line number Diff line number Diff line change
@@ -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
Loading