lfg2025/archy
1
0
Fork 0
Code Issues 24 Pull Requests 1 Actions Packages Projects Releases 64 Wiki Activity
Files
921f450edf014d0d1f1b84774c1eef3ec9e7de6a
archy/.planning/STATE.md
T

14 KiB
Raw Blame History

gsd_state_version, milestone, milestone_name, current_phase, status, stopped_at, last_updated, last_activity, last_activity_desc, progress, current_phase_name
gsd_state_version milestone milestone_name current_phase status stopped_at last_updated last_activity last_activity_desc progress current_phase_name
1.0 v1.8.0 milestone 02 completed Completed 02-08-PLAN.md — Phase 02 (ui-performance) complete, 8/8 plans 2026-07-31T03:54:32.766Z 2026-07-30 Phase 02 marked complete
total_phases completed_phases total_plans completed_plans percent
9 1 25 13 11
ui-performance

Project State

Project Reference

See: .planning/PROJECT.md (updated 2026-07-29)

Core value: A third-party developer can publish an app via the signed/decentralized registry and a user can install it on their node — manifest-driven, rootless, secure, robust. Current focus: Phase 02 — ui-performance

Current Position

Phase: 02 — COMPLETE Plan: 8 of 8 Status: Phase 02 complete Last activity: 2026-07-30 — Phase 02 marked complete

Progress: [█████░░░░░] 52%

Performance Metrics

Velocity:

  • Total plans completed: 0
  • Average duration: —
  • Total execution time: —

By Phase:

Phase Plans Total Avg/Plan
- - - -
Per-Plan Metrics:
Plan Duration Tasks Files
Phase 02 P01 100min 3 tasks 5 files
Phase 02 P03 45min 3 tasks 5 files
Phase 02 P02 105min 3 tasks 11 files
Phase 02 P04 150min 3 tasks 12 files
Phase 02 P05 50min 2 tasks 8 files
Phase 02 P06 73min 2 tasks 7 files
Phase 02 P07 75min 3 tasks 5 files
Phase 02 P08 ~190min 3 tasks 4 files

Accumulated Context

Roadmap Evolution

  • Phase 1 added (2026-07-29): Federation & Mesh Hardening — user-directed top priority (node removal/sync issues, mesh attachment parity incl. demo); prior phases shifted down
  • Phase 2 added (2026-07-29): UI Performance — slow tab switches and secondary screens; prior phases shifted down
  • FED-05 added to Phase 1 (2026-07-29): inter-node Lightning channel-opening UX (share node URI, pick trusted/federated nodes by hostname, request channels with public nodes); UI tested on :8100 dev preview against archi-dev before deploy
  • FED-06 added to Phase 1 (2026-07-29): on-brand paid-tick animation — screensaver ring + EQ segments (reuse ScreensaverRing.vue compact) replacing the success burst in SendBitcoinModal.vue
  • Phase 9 added (2026-07-30): BotFights Platform Upgrade — native nostr signer login, unified AI bot-setup prompt replacing docs page, shared public match endpoint on VPS2 (all nodes see all fighters), registry/manifest update. Independent of Phases 1–8.

Decisions

Decisions are logged in PROJECT.md (10 locked ADRs in the <decisions> block + milestone decisions table). Recent decisions affecting current work:

  • Milestone version = 1.8.0-alpha (decided 2026-07-08)
  • Phase-3 Quadlet default-flip is gated on the second-node gate reporting clean (do fresh, never stage uncommitted)
  • Workstream D (DHT distribution) deferred to v2 — design-only backlog
  • Canonical manifest schema = core/container/src/manifest.rs (code wins over spec doc)
  • [Phase ?]: Marketplace is the 02-02 tracer tab (worst-measured main tab, 2033ms revisit) matching the user's own 'often app store' complaint
  • [Phase ?]: ContainerAppDetails.vue confirmed fully unreachable dead code (no importer, no route) — no serial-RPC-waterfall target exists in the measured D-09 surface set
  • [Phase ?]: archi-dev-box UI password was unknown/undiscoverable from this environment — paused at a checkpoint:human-action rather than guessing or falling back to a mock baseline silently
  • [Phase ?]: Purged the resource cache on logout via clearAll() + a generation guard, so no in-flight fetch from an ending session can repopulate memory or sessionStorage (T-02-02)
  • [Phase ?]: AppDetails/MarketplaceAppDetails/OpenWrtGateway converted to per-item (or single-key) keyed useCachedResource; CloudFolder.vue's existing store-level cache left as-is (cloud.ts TTL gate is a follow-up, out of this plan's file scope)
  • [Phase ?]: Wallet/send flow (SendBitcoinModal.vue) reported as an unplanned-item gap — named by findings as owned by 02-03 but not in files_modified; its cost is pure client-side remount, not a caching problem
  • [Phase ?]: PERF-03 reverted to Pending in REQUIREMENTS.md after an initial mark-complete was premature — its own text requires real-node-hardware verification, which is 02-08's job (also declares PERF-03); 02-03 delivers the code-level portion only
  • [Phase ?]: 02-02: DashboardRouterView final shape uses statically-named per-route KeepAlive wrapper components (dashboardViewWrappers.ts) with :include name-matching, restoring pre-restructure view-wrapper DOM/animations byte-for-byte after a checkpoint-caught regression
  • [Phase ?]: 02-02: HARD RULE for rest of Phase 02 — perf work must be visually invisible; verify against the real dev preview before considering a checkpoint satisfied
  • [Phase ?]: 02-02: app-catalog persist:true ttl 300000ms; bitcoin.prune-status persist:true ttl 30000ms — both explicit per T-02-01, no default relied on
  • [Phase ?]: 02-02: PERF-02 reverted to Pending/In-Progress in REQUIREMENTS.md after an automated mark-complete run — PERF-02 also spans 02-04..02-07 (extending KeepAlive caching to every remaining main tab); this plan proves the architecture on the tracer tab only
  • [Phase ?]: 02-04: KEEP_ALIVE_PATHS widened to every audited main tab (10 paths) derived from TAB_ORDER + /dashboard/discover; /dashboard/settings deliberately withheld — its child sections (SystemDangerZone reboot poll, several onMounted-only fetches) were never audited by this plan
  • [Phase ?]: 02-04: onActivated is a documented no-op outside a KeepAlive boundary — every arm function now runs from both onMounted and onActivated (fresh-mount guards on Home/Web5/Mesh/Server avoid doubling first-load RPC cost); caught by CloudPeersRefresh.test.ts
  • [Phase ?]: 02-04: useCachedResource.ts's onActivated no longer eagerly force-loads a never-fetched immediate:false resource, so tab-gated lazy data (Cloud.vue Paid Files/My Files) isn't force-loaded merely by its view entering the KeepAlive cache
  • [Phase ?]: 02-04: AIUI blank-screen-and-loading symptom reported at Task 3 checkpoint diagnosed as pre-existing (local mock-backend dev mode sets VITE_AIUI_URL=http://localhost:5173 unconditionally with no AIUI repo checked out) — not a regression, left for 02-07 (Chat/AIUI) to address
  • [Phase ?]: 02-05: mesh.refreshAll()/transport.fetchStatus() stay uncached at the store level (other callers need guaranteed-fresh reads); the useCachedResource wrapper around each lives in Mesh.vue instead, since Pinia's defineStore(id,setup) runs in a bare effectScope where onActivated() silently no-ops
  • [Phase ?]: 02-05: FLAGGED - RESEARCH.md's premise that Mesh.vue owns a D3 force simulation is incorrect for this codebase (verified via grep); only NetworkMap.vue/Federation.vue has one. Task 2's D3 truths are vacuously satisfied; only the real Leaflet map lifecycle (MeshMap.vue, added to scope) was implemented
  • [Phase ?]: 02-05: per-group TTL/persist table - mesh.refresh-all/federation-nodes/self-onion/self-did/contacts all persist:false (identity payload); transport-status persists (aggregate, non-identity); reachability groups get 10s TTL, identity groups 300s
  • [Phase ?]: 02-06: RESEARCH A3 settled — none of Server's seven load-group loaders consumes another's result; concurrent fan-out is correct as-is
  • [Phase ?]: 02-06: Five of Server's seven groups were already on useCachedResource from a pre-phase legacy commit (ea254f63) with only composable defaults (30s TTL, persist:true) — this plan's work was explicit TTL/persist/dedup, not initial conversion; only loadDiskStatus was a genuinely uncached plain fetch
  • [Phase ?]: 02-06: Home's wallet composite does NOT share a cache key with Web5.vue's web5.lnd-info — sharing would either corrupt Web5's typed entry.data or fail to close the sessionStorage gap since Web5.vue's own hook (out of scope) defaults persist:true
  • [Phase ?]: 02-06: homeStatus.refresh() wrapped by useCachedResource at Home.vue (the view), not inside the homeStatus Pinia store — defineStore(id,setup) runs in a bare effectScope where onActivated() silently no-ops, same finding as 02-05's Mesh.vue
  • [Phase ?]: 02-07: AIUI source located mid-plan at git.tx1138.com/lfg2025/AIUI (base branch development, not stale main); AIUI-side D-14 commit 900c0b9 initially local-only (anonymous push 403) then pushed/merged upstream onto development by the orchestrator using a user-supplied write token
  • [Phase ?]: 02-07: D-14a fixed via new ?chatExpanded param overriding chat.ts's chatCollapsed default (never persisted to localStorage); D-14b fixed via new ?mobileChat param re-asserting ChatPage.vue's mobileTab='chat' once on mount, guarding against module-singleton content-panel state surviving an internal AIUI remount
  • [Phase ?]: 02-07: PERF-02 marked Complete in REQUIREMENTS.md — 02-02 through 02-07 extended KeepAlive/useCachedResource to every main tab, each dev-preview-verified against archi-dev-box per D-11
  • [Phase ?]: 02-08: KEEP_ALIVE_MAX left at 6, now backed by an on-device memory reading (4 cycles, 11 tabs, JS heap fluctuating 10-21MB, no monotonic growth) rather than the FA-D estimate
  • [Phase ?]: 02-08: archy-x250-dev offline for the entire plan (checked 3x); archi-dev-box (D-11's named target) is the only dev-pair node this phase reached
  • [Phase ?]: 02-08: the harness's remount-probe field is confounded for main tabs once real KeepAlive keeps multiple instances alive simultaneously; corrected via an independent, reproduced-twice verification rather than editing the frozen 02-01 harness — revealed Server.vue genuinely does not survive a round-trip (open gap, not hidden)
  • [Phase ?]: 02-08: a user-reported Cloud first-visit navigation regression was treated as release-blocking, not known-open, per explicit direction — root-caused to content.browse-peer's unbounded, untimed-enough per-peer RPC fan-out starving Chromium's connection pool; fixed via a concurrency cap + shortened timeout, verified 5/5, user-approved on-node
  • [Phase ?]: 02-08: 4 other user-reported UX issues (Paid Files window.open, PiP not closing lightbox, missing loader on Paid Files item-open, PiP not surviving tab changes) classified as pre-existing (predate phase 2 via git history) and captured into UIFIX-04/05/06, not fixed

Pending Todos

  • [blocker/ui] Keep FIPS/Tor pills on cloud files and show them on mobile (.planning/todos/pending/2026-07-30-keep-fips-tor-pills-on-cloud-files-and-show-them-on-mobile.md)
  • [blocker/security] Fedimint gateway must not install with a pre-set password — tracked as FED-07 / Phase 1 gap plan (.planning/todos/pending/2026-07-30-fedimint-gateway-must-not-install-with-preset-password.md)
  • [blocker/ui] Connected-nodes list must scroll at row-matched height, not grow to fit (.planning/todos/pending/2026-07-30-connected-nodes-list-must-scroll-at-row-matched-height.md)
  • [blocker/ui] Onboarding tickbox hidden below fold on short screens — make it beautifully obvious (.planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md)
  • [major/ui] Paid Files pictures open in browser tab, not the app lightbox — UIFIX-04 (.planning/todos/pending/2026-07-30-peer-files-pictures-open-in-tab-not-lightbox.md)
  • [major/ui] PiP should close the lightbox with a fluid animation — UIFIX-05 (.planning/todos/pending/2026-07-30-pip-should-close-lightbox-with-fluid-animation.md)
  • [major/ui] Missing loader states on slow opens — UIFIX-06 (.planning/todos/pending/2026-07-30-missing-loader-states-on-slow-opens.md)

Blockers/Concerns

  • [Phase 1] Federation tombstone fix touches trust code — fix carefully, re-verify with tests/multinode/smoke.sh, don't patch blind
  • [Phase 3] Multinode gate on archy-x250-beta was launched 2026-07-01 (log on-node); verify outcome before re-running
  • [Phase 5] Fleet registry flip awaits explicit user authorization + timing call
  • [Phase 6] Strengthened ADR-009 validation may reject existing catalog apps — audit manifests before enforcement lands
  • [Global] Live OTA fleet: deploy to the dev pair before any OTA; gate re-runs required after orchestrator changes; some verification is user/hardware-gated (radios, on-device tests)
  • cloud.ts's navigate() needs a TTL gate to fully satisfy 'no new RPC within TTL' for CloudFolder.vue — currently always re-fetches on revisit (just doesn't block paint)
  • [Phase 2, carried forward] Server.vue does not survive a tab round-trip despite KEEP_ALIVE_PATHS registration — confirmed real gap, needs a future targeted fix
  • [Phase 2, carried forward] Timing regressions on Discover/Web5/Fleet/AppDetails/OpenWrtGateway (02-PERF-AFTER.json vs baseline) — a same-time-of-day re-run would help disambiguate real regression from node-load noise

Quick Tasks Completed

# Description Date Commit Directory
260729-fw7 improve mesh message hop graphic/animation: balanced desktop sizing, vertical mobile layout, archipelago branding 2026-07-29 ac09fc5d 260729-fw7-improve-mesh-message-hop-graphic-animati
260729-gjd demo: indee.tx1138.com in app iframe (:2101 whole-origin proxy), auto nostr signer sign-in, IndeeHub pre-installed on fresh session 2026-07-29 d00ca624 260729-gjd-demo-make-indee-tx1138-com-work-in-the-a
260729-hj1 peer-files media batch: Wavlake paid tracks + purchases + dedupe + real photos (demo); lightbox/player open routing + free-image lightbox fix (both builds) 2026-07-29 f52c5407 260729-hj1-peer-files-media-batch-wavlake-paid-trac
260729-je5 connected-nodes list fills card height (constant footer gap); companion app skips demo intro 2026-07-29 d54517cf 260729-je5-ui-fixes-connected-nodes-scrollable-list

Deferred Items

Category Item Status Deferred At
Distribution DIST-01 DHT/iroh backbone (workstream D) v2 2026-07-29
Fleet FLEET-01 Bitcoin multi-version fleet OTA (user-gated) v2 2026-07-29
Fleet FLEET-02 per-app deep health assertions (~34 apps) v2 2026-07-29
Fleet FLEET-03 LUKS2 data-partition encryption v2 2026-07-29

Session Continuity

Last session: 2026-07-31T03:54:32.747Z Stopped at: Completed 02-08-PLAN.md — Phase 02 (ui-performance) complete, 8/8 plans Resume file: None

Reference in New Issue View Git Blame Copy Permalink