id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization

LIST 6a. ID apps should live as their own folders in an apps source directory: code + images/resources as one set. Investigate how an app declares itself, and how the SAME app renders through the TUI-style interface and the web — with web-native components supported two ways: build the app directly for web, or build the general app plus a specialization/adapter for web-native capabilities. Deliverable: app manifest + folder-layout proposal with one existing example app sketched both ways.

Program: Drew's 2026-10-28 directive (full text: hatch-personal memory/topics/id-program-2026-10-28.md).
Working pattern: parallel investigations, then the named synthesis issue merges them into a full design. Route guidance: Workhorse by default; Specialist/Summit for synthesis and ramification-heavy work. A result that says "done" is not the endpoint — the orchestrator reviews it and may commission another round. Deliverables: a markdown design/investigation doc (mermaid/SVG diagrams welcome) linked from this issue, plus follow-up issues for anything buildable. Build a proof of concept where the design calls for one, but do NOT build the permanent feature on top of an unreviewed PoC.

CODE-947

Parent epic: #2056 — ID platform expansion (2026-10-28 directive).

Top priority — ID program wave-1. Drew directed this be picked up in the next runs (2026-10-29): enqueued directly as triage task 3343 in repo-health-code-pilot at queue priority 20 (only breakage-class work at priority 10 outranks it). Wave-1 is the ungated investigations and designs; syntheses and PoCs stay gated on their named inputs. Investigation route: Workhorse.

🤖 Agent note · triaged

Agent: queue worker (repo-worker-code), Lane B shift
Session / ID: queue task 3343
Found via: queue claim
Task: Triage id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026 (LIST 6a) — verify the current app-packaging state and route the investigation.
Verdict: CONFIRMED — greenfield, with the two interface stacks already present separately. Verified at origin/main 2026-10-29 ~10:45Z:
- No apps source directory exists: git ls-tree pkgs/id/ at HEAD shows no apps/ (or equivalent) — pkgs/id is a single crate tree (src/, web/, examples/, doc/). No app declares itself today; there is no app manifest format.
- The only "manifests" at HEAD are different concepts: pkgs/id/web/scripts/build-manifest.ts (web asset build manifest) and the world manifest in src/commands/world.rs (the F12/id: F12.1 apply wiring — module install + schedules reconciliation #807 module+schedules apply manifest — runtime modules over the wire, not UI app packaging). The design must explicitly disambiguate all three uses of "manifest" or the term will collide.
- Both render paths exist, un-unified: TUI/CLI-style via src/cli.rs + src/commands/* (+ repl), web via TWO layers — server-side src/web/* (routes, templates, world_ws, explore, identity) and the separate pkgs/id/web/ frontend package (bun, its own lockfile). "The same app renders through TUI and web" is currently true only in the loose sense that the same features (world, groups, identity) are reachable from both stacks with hand-duplicated wiring; there is no shared app definition either path consumes.
- Example-app candidates for the doc's two-way sketch: world (CLI commands/world.rs + web src/web/world_ws.rs/explore.rs) or groups (commands + web identity/explore surfaces) — both already live on both stacks, so the sketch can be grounded in real call sites rather than invented.
- Design questions the follow-up must answer: where the apps dir lives (inside pkgs/id/ vs repo-level); manifest fields (identity, entry points per interface, resources/images, capabilities); whether the web-specialization is an adapter over a general app definition or a fully separate web build — the issue names both as supported, so the manifest needs a way to declare which mode an app uses; and how resources travel with the folder (the artifact/blob machinery in src/artifact.rs/blob_gate.rs is the obvious substrate — the design should say whether it reuses it).
Expectation: done — follow-up design-doc packet enqueued this shift. No code change in triage.
Links: follow-up task id in the completion note.

🤖 Agent note · done

Agent: queue worker (repo-worker-code), Lane B shift
Session / ID: queue task 3343
Found via: queue claim
Task: Triage id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026 complete — verdict CONFIRMED posted above (comment 6494285166): no apps directory or app manifest exists at HEAD; the TUI/CLI and web stacks duplicate features by hand; the three-way "manifest" collision (app vs world-apply id: F12.1 apply wiring — module install + schedules reconciliation #807 vs web build) named for the design to disambiguate.
Expectation: done — follow-up enqueued as queue task 3389 (app-packaging design-doc packet).

🤖 Agent note · parked

Agent: queue worker (repo-worker-code), lane D
Session / ID: queue task 3389, resumed 2026-10-29T22:00Z
Found via: queue claim (resume)
Task: PR 2326 — app packaging design doc for id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026. Revalidated fresh: PR OPEN, MERGEABLE/CLEAN at b726f96, required check SUCCESS, Codex review completed with has_any_findings=false (dispositioned clean this shift). Main still 5a34fa7.
Expectation: done = PR merged. Sole blocker is merge-queue stall ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403. Parking until main advances / ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 closes, then re-enqueue, verify merged, complete, strip labels.
Links: PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 · stall ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403

🤖 Agent note · parked (gate recheck)

Agent: queue worker (repo-worker-code), Lane C
Session / ID: queue task 3389
Found via: queue claim (resume)
Gate recheck (fresh, 2026-10-29 ~22:45Z): PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 still OPEN, head b726f96, MERGEABLE/CLEAN; main still frozen at 5a34fa7; ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 still OPEN (ejection re-verified three times this shift on PRs fix(aggregator): age out done after 7d, collapse Done recently, filter retired Done-table class (#1146) #2430/mcpx: typed sampling errors — -1 on rejection, expiry stays -32603 (#1835) #2440, direct merge 405). Prior verification stands (checks SUCCESS, Codex clean). Gate unmet; re-parked without an enqueue cycle.
Expectation / resume: when ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 closes / main advances: re-enqueue PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326, verify merged, complete task 3389, strip labels on id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026.
Links: PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 · blocker ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403

🤖 Agent note · parked (Lane C shift, gate recheck 22:59Z)

Task: 3389 (investigate-doc: app packaging design). PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 OPEN, MERGEABLE/CLEAN, head b726f96, no failing/pending checks; prior verification: checks SUCCESS, Codex clean.
Gate unchanged: main still 5a34fa7; ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 still OPEN (merge-queue freeze; admin config decision pending).
Action: re-parked 1h without an enqueue cycle. Resume when main moves: re-enqueue docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326, verify merge, complete, strip labels.

🤖 Agent note · parked (merge-queue stall)

Agent: queue worker (repo-worker-code), OpenChamber scheduled lane · queue task 3389
Found via: queue claim (resume from awaiting_ci)
Verified fresh 23:51Z: PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 OPEN, not draft, MERGEABLE/CLEAN, head b726f965; basic: proxy port fallbacks pass, the two skipping entries are the full main-tier / CodeRabbit contexts, which are not required.
Blocked on: ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 — every CLEAN PR is ejected by the merge queue, main frozen at 5a34fa70 since 10:57Z. Now user/escalated with the one-call fix.
Next: on resume (or once ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 clears): gh pr merge 2326 --merge --match-head-commit b726f965, then close this issue.

🤖 Agent note · picked up → parked

Agent: queue worker (repo-worker-code), Lane C shift
Session / ID: queue task 3389 (resume, verified), shift 2026-10-29 18:47 CDT
Found via: queue claim
Task: Revalidated PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 fresh: OPEN, CLEAN, head b726f96 unchanged, all checks pass; both Codex P2 findings fixed in b726f96 with thread replies. Design doc is merge-ready.
Blocker: merge queue stall ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 only (main frozen at 5a34fa7).
Expectation: resume when ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403 clears: merge docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326, close id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026, complete task 3389.
Links: PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326 · blocker ci: merge queue ejects every PR — no merge since #2233 (10:57Z), entries dropped 2-6 min into AWAITING_CHECKS #2403

Lane A (queue task 3389): verified fresh — PR #2326 MERGED 2026-10-30T01:04:40Z (merge commit 167727f) once blocker #2403 cleared. Task 3389 completing as already_done; stale queue/status/work labels removed.
🤖 Agent note · picked up → done (already_done)

Agent: queue worker (repo-worker-code), Lane A shift
Session / ID: queue task 3389 (resume, merge_ready), shift 2026-10-29 21:04 CDT
Found via: queue claim
Links: PR docs(id): app packaging design — app.toml, apps/ layout, TUI/web parity (#2026) #2326

Navigation Menu

Repository navigation

id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026

94 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: investigate: app packaging — apps as folders (code + resources), TUI/web interface parity, web-native specialization #2026

Description

Activity

developing-today commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

94 remaining items

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 30, 2026

dezren39 commented on Oct 30, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions