Skip to content

docs(id): WEB.md and ARCHITECTURE.md still describe the web UI as HTMX after the Datastar migration #1789

New issue
New issue
Closed
#4908
Closed
docs(id): WEB.md and ARCHITECTURE.md still describe the web UI as HTMX after the Datastar migration#1789
#4908
Assignees
dezren39
Labels
app/idPackage/app: id (pkgs/ or apps/ in this repo)effort/sSmall: expected under 2 hours of workkind/docsDocumentation improvement or additionmeta/enrichedIntake review done: acceptance criteria, links, and normalized labels addedpriority/lowNice to have; do when convenientqueue/queuedHas a queued task in the Supabase agent queuesource/queue-workerFiled or worked by the queue/worker pilottask/triageQueue packet kind: verify, reproduce, and route this item

Description

@dezren39
dezren39
opened on Oct 28, 2026

Finding

pkgs/id/WEB.md and pkgs/id/ARCHITECTURE.md still describe the id web UI as HTMX-based, but HTMX was removed in the Datastar migration (verified at main HEAD e561ab58 by queue triage of #1073):

  • pkgs/id/WEB.md line 24: "File Browser: HTMX-powered listing with search, filtering, bulk operations"; line 46: architecture diagram labels the web layer "HTMX"; line 247: "/api/files — File list (HTMX partial)".
  • pkgs/id/ARCHITECTURE.md line 14: diagram box "Axum + HTMX + ProseMirror".

Current reality at HEAD: no hx-* attributes or HX-Request handling anywhere in the repo; pkgs/id/web/package.json depends on @starfederation/datastar ^1.0.0-beta.11, Tailwind CSS v4 and DaisyUI v5; pkgs/id/web/src/main.ts imports the Datastar SDK and handles SSE-based navigation client-side.

Scope

Update the HTMX references in pkgs/id/WEB.md and pkgs/id/ARCHITECTURE.md to describe the current Datastar + Tailwind/DaisyUI architecture (client-side navigation in web/src/navigation.ts / main.ts; no Rust DatastarResponse builder was adopted). Docs only — no code changes.

Acceptance criteria

  • No HTMX claims remain in pkgs/id/WEB.md or pkgs/id/ARCHITECTURE.md.
  • The replacement text matches the code at HEAD (Datastar SDK in the TS client, Tailwind/DaisyUI styling, WebSocket endpoints unchanged).

Found by: queue worker triage of #1073 (task 2358).

Activity

  1. dezren39
    added
    app/idPackage/app: id (pkgs/ or apps/ in this repo)
    on Oct 28, 2026

  2. developing-today commented on Oct 28, 2026

    @developing-today
    developing-todayBot
    on Oct 28, 2026 – with developing.today
    Contributor

    CODE-729

  3. github-actions
    assigned
    dezren39
    on Oct 28, 2026
  4. dezren39
    added
    kind/docsDocumentation improvement or addition
    source/queue-workerFiled or worked by the queue/worker pilot
    status/needs-triageNot yet triaged; needs a first look
    priority/lowNice to have; do when convenient
    effort/sSmall: expected under 2 hours of work
    meta/enrichedIntake review done: acceptance criteria, links, and normalized labels added
    on Oct 28, 2026

  5. dezren39 commented on Oct 28, 2026

    @dezren39
    dezren39
    on Oct 28, 2026
    MemberAuthor

    Intake review

    • Still live: verified at main HEAD e561ab5 by the queue triage that filed it this hour (split from rollup id: TODO.md backlog rollup — small ideas not yet covered elsewhere #1294, task 2544): pkgs/id/WEB.md lines 24/46/247 and pkgs/id/ARCHITECTURE.md line 14 still say HTMX, while the repo has no hx-* attributes or HX-Request handling and the web app runs on Datastar + Tailwind/DaisyUI. No docs fix has landed since. Confirmed live.
    • Related: parent rollup id: TODO.md backlog rollup — small ideas not yet covered elsewhere #1294.
    • Notes: docs-only, clearly scoped, low-risk — the smallest item in this split batch and a good first pick. Describe the architecture as it is (client-side navigation in web/src/navigation.ts / main.ts, SSE-based updates); the triage note records that no Rust DatastarResponse builder was adopted, so do not invent one in the docs.
    • Risks: minimal — stale references elsewhere in the two files (screenshots, endpoint tables) should be swept in the same pass.
    • Suggested approach: single docs change updating both files, grep HTMX|hx- afterwards to prove zero remain.

    🤖 Agent note · filed

    • Agent: fleet monitor
    • Session / ID: repo-fleet-monitor run 2026-10-28 15:19 CDT
    • Found via: monitor reconciliation
    • Task: Intake enrichment — labels normalized, live status verified
    • Expectation: effort/s; done = labels + this review + meta/enriched applied
  6. dezren39
    added
    queue/queuedHas a queued task in the Supabase agent queue
    task/triageQueue packet kind: verify, reproduce, and route this item
    work/assignedQueue worker lifecycle state
    queue/claimedQueue worker lifecycle state
    status/in-progressQueue worker lifecycle state
    and removed
    status/needs-triageNot yet triaged; needs a first look
    queue/queuedHas a queued task in the Supabase agent queue
    on Nov 3, 2026

  7. dezren39 commented on Nov 3, 2026

    @dezren39
    dezren39
    on Nov 3, 2026
    MemberAuthor
    {"agent":"repo-worker-code","lane":"aea12c82-c5af-4e5a-9b66-f8e360f87177","event":"picked_up","task":"7716","queue":"repo-health-code-pilot","at":"2026-11-03T13:01:30Z","note":"Triage verified at main ~1e3763fa: HTMX references still present in pkgs/id/WEB.md (lines 24, 46, 247) and pkgs/id/ARCHITECTURE.md (line 14). No competing PR or branch. Fix is a small docs edit; proceeding to implement rather than re-queue."}
  8. dezren39
    added a commit that references this issue on Nov 3, 2026

    Merge pull request #4908 from developing-today/queue/7716-1789-id-web…

    c3c9423
  9. dezren39
    closed this as completedin #4908on Nov 3, 2026

  10. dezren39 commented on Nov 3, 2026

    @dezren39
    dezren39
    on Nov 3, 2026
    MemberAuthor
    {"agent":"repo-worker-code","lane":"aea12c82-c5af-4e5a-9b66-f8e360f87177","event":"done","task":"7716","queue":"repo-health-code-pilot","at":"2026-11-03T13:06:00Z","note":"Docs fixed and merged: PR #4908 (merge c3c94238) removes every HTMX claim from pkgs/id/WEB.md and pkgs/id/ARCHITECTURE.md and describes the Datastar SDK + TypeScript SPA navigation + Tailwind v4/DaisyUI reality at HEAD. Docs-only, basic: production line limit passed, no code touched.","pr":4908,"merge_sha":"c3c9423846d825a190194110c0b81056568f25db"}
  11. dezren39
    added
    queue/queuedHas a queued task in the Supabase agent queue
    and removed
    status/in-progressQueue worker lifecycle state
    queue/claimedQueue worker lifecycle state
    work/assignedQueue worker lifecycle state
    on Nov 3, 2026

  12. dezren39 commented on Nov 3, 2026

    @dezren39
    dezren39
    on Nov 3, 2026
    MemberAuthor

    agent-note:v1
    state: triaged (coverage pass)
    Coverage pass 2026-11-03: reviewed in the fleet-wide per-issue pass (drift / overlap / already-handled / stale / blockers / ordering). Verdict: still live; queued in repo-health-code-pilot as triage at priority 30 (priority/low). If this is already handled at current main, the triage closes it with evidence; if it needs splitting, the triage files the split.
    Found via: coverage pass 2026-11-03

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

app/idPackage/app: id (pkgs/ or apps/ in this repo)effort/sSmall: expected under 2 hours of workkind/docsDocumentation improvement or additionmeta/enrichedIntake review done: acceptance criteria, links, and normalized labels addedpriority/lowNice to have; do when convenientqueue/queuedHas a queued task in the Supabase agent queuesource/queue-workerFiled or worked by the queue/worker pilottask/triageQueue packet kind: verify, reproduce, and route this item

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions