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
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ gh project item-list 2 --owner traverse-framework --format json --limit 300 \
| `phase2-sidecar-nightly` | Future | Defer — low demo value |
| `embed-trace-explorer` | Blocked | Wait Traverse trace API |
| `registry-ref-starter-process` | Blocked | Wait Traverse dual-mode component manifests (spec 054 FR-007; `contract_path` still required on main) |
| `consume-product-wasm-agents` | Blocked | Wait Traverse product agents (#785) |
| `consume-product-wasm-agents` | Blocked | Wait Project 1 `real-wasm-agent-execute` |

Full gap table + wave notes: [`docs/production-reference-plan.md`](docs/production-reference-plan.md).

Expand Down
6 changes: 3 additions & 3 deletions docs/production-packaging.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,9 +112,9 @@ Governing Traverse specs:
|---|---|---|
| Component manifests under `manifests/` | **Local-path** (`contract_path` + `wasm_binary_path` + `wasm_digest`) | Selected components may use `registry_ref` instead |
| Sync / packaging | [`runtime-bundle-sync.md`](runtime-bundle-sync.md) copies local example trees | Still sync app manifests; capability artifacts come from registry sync + digest-verified cache |
| Implementation ticket | Project 2 `registry-ref-starter-process` remains **Blocked** until registry seed + Traverse gates clear | Flip Ready only when upstream publish/sync works |
| Implementation ticket | Project 2 `registry-ref-starter-process` remains **Blocked** until Traverse dual-mode component manifests land (`dual-mode-component-registry-ref`) | Flip Ready only when `registry_ref`-only component manifests validate/register |

**Do not switch any checked-in manifest to `registry_ref` in this ticket or any PR that only lands this doc.** Premature switches break Phase 3 embedded smoke until registry seed-publish and `traverse-cli registry sync` are available.
**Do not switch any checked-in manifest to `registry_ref` in this ticket or any PR that only lands this doc.** Premature switches break Phase 3 embedded smoke until Traverse accepts `registry_ref` xor `contract_path` on component manifests (spec 054 FR-007).

## Intended component shape

Expand Down Expand Up @@ -177,7 +177,7 @@ First intended cutover: **`traverse-starter.process` only** (`registry-ref-start
## Agent / playbook rules

- Packaging and production playbooks may **describe** this contract; they must not instruct agents to rewrite manifests to `registry_ref` yet.
- Project 2 `registry-ref-starter-process` owns the code/manifest switch and remains Blocked until Traverse registry seed + sync CLI gates are met.
- Project 2 `registry-ref-starter-process` owns the code/manifest switch and remains Blocked until Traverse Project 1 `dual-mode-component-registry-ref` is Done.
- UI remains a rendering layer — registry adoption does not move business field computation into App-References.

## Related
Expand Down
36 changes: 17 additions & 19 deletions docs/production-reference-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,31 +54,29 @@ Live status is always on [Project 2](https://github.com/orgs/traverse-framework/

| Demo gap | Ticket ID | Board | Why it matters | Start plan |
|---|---|---|---|---|
| meeting-notes multi-OS embed | `meeting-notes-multi-os` | **In Progress** (Cursor) | Web + Linux GTK + CLI embed | Finish PR; Apple/Windows later waves |
| Trace Explorer embed | `embed-trace-explorer` | **Blocked** | Still HTTP; needs Traverse embedded trace API | Do not start — flip Ready when upstream API exists |
| meeting-notes multi-OS embed | `meeting-notes-multi-os` | **Done** | Web + Linux GTK + CLI embed | Shipped |
| Trace Explorer embed | `embed-trace-explorer` | **Blocked** | Still HTTP; needs Traverse embedded trace API | Do not start — flip Ready when upstream API exists |
| Delete sidecar client code | `remove-sidecar-paths` | **Done** | Dead HTTP paths removed from starter/doc-approval | Shipped |
| Nightly Apple/Windows + Android/GTK | `native-ci-android-gtk-required` | **In Progress** (Cursor) | GTK + Android compile fixes; jobs required on nightly | Finish PR |
| Product WASM agents (Traverse) | `consume-product-wasm-agents` | **Blocked** | Smoke uses App-Refs fixtures; Traverse agents still stubs | Wait Traverse (e.g. #785); then swap fixtures |
| `registry_ref` adoption | `registry-ref-starter-process` | **Blocked** | Registry seed + sync Done; Traverse still requires `contract_path` on component manifests (spec 054 FR-007 not wired) | Wait Traverse dual-mode component load |
| Phase 2 sidecar nightly | `phase2-sidecar-nightly` | **Future** (defer) | Legacy path; low demo value | After Wave 1; optional |
| meeting-notes multi-OS embed | `meeting-notes-multi-os` | **Done** (#208) | Web + Linux GTK + CLI embed | Shipped |
| Trace Explorer embed | `embed-trace-explorer` | **Blocked** | Still HTTP; needs Traverse embedded trace API | Flip Ready when Project 1 `embedded-trace-api` is Done |
| Delete sidecar client code | `remove-sidecar-paths` | **Done** (#206) | Dead HTTP paths removed from starter/doc-approval | Shipped |
| Nightly Apple/Windows + Android/GTK | `native-ci-android-gtk-required` | **Done** (#209); nightly green via `fix-nightly-native-required` | Required nightly jobs | Shipped |
| Product WASM agents (Traverse) | `consume-product-wasm-agents` | **Blocked** | Smoke uses App-Refs fixtures; Traverse agents still stubs | Flip Ready when Project 1 `real-wasm-agent-execute` is Done |
| `registry_ref` adoption | `registry-ref-starter-process` | **Blocked** | Registry seed + sync Done; Traverse still requires `contract_path` on component manifests (spec 054 FR-007 not wired) | Flip Ready when Project 1 `dual-mode-component-registry-ref` is Done |
| Phase 2 sidecar nightly | `phase2-sidecar-nightly` | **Future** (defer) | Legacy path; low demo value | Optional; low priority |

### Wave 1 — start now (Ready, parallel OK)
### Wave 1 — Done

1. **`remove-sidecar-paths`** — cleanup primary shells
2. **`meeting-notes-multi-os`** — showcase embed
3. **`native-ci-android-gtk-required`** — CI bar
1. **`remove-sidecar-paths`** — shipped (#206)
2. **`meeting-notes-multi-os`** — shipped (#208)
3. **`native-ci-android-gtk-required`** — shipped (#209); required nightly green

One Project 2 ticket per agent (`AGENTS.md`). Claim only `Ready` + Agent Unassigned.
No Ready App-Refs work until Wave 2 upstream gates clear (`AGENTS.md`).

### Wave 2 — after upstream unblocks

Flip Status → Ready when Depends on clears, then claim:

- `embed-trace-explorer`
- `registry-ref-starter-process`
- `consume-product-wasm-agents`
- `embed-trace-explorer` (wait: Project 1 `embedded-trace-api`)
- `registry-ref-starter-process` (wait: Project 1 `dual-mode-component-registry-ref`)
- `consume-product-wasm-agents` (wait: Project 1 `real-wasm-agent-execute`)

## Architecture boundary (unchanged)

Expand All @@ -90,10 +88,10 @@ Flip Status → Ready when Depends on clears, then claim:
## Exit criteria for Phase 4 kit

1. `bash scripts/ci/embedded_smoke.sh` exists and is wired to CI with the skip/fail contract above — **met**
2. Tiered native CI documented in `docs/quality-standards.md` and implemented for the Linux PR gate — **met** (Android/GTK still advisory → `native-ci-android-gtk-required`)
2. Tiered native CI documented in `docs/quality-standards.md` — **met** (Linux PR gate + required nightly macOS/Windows/Android/GTK)
3. Digest sync + packaging playbook published — **met**
4. Getting-started / README are embedded-first; sidecar appendix-only — **met**
5. Agent DoD + add-platform recipe published — **met**
6. Wave 1 Ready tickets above — execute in start order (#1 → #3)
6. Wave 1 tickets (#1 → #3) — **met**

When open tickets complete, update Project 2 Status → Done — do not invent a separate status field outside Project 2.
Loading