epic: docs — march to 0.0.1-stable (coverage & accuracy)

[rickylabs]

Docs march to 0.0.1-stable — coverage & accuracy umbrella

Tracking issue for the remaining documentation work to reach a stable-quality docs set for 0.0.1. The first slice — storefront tutorial D-01…D-05 conformance plus fresh-ui/web-layer accuracy reconciliation to the alpha.18 feature sweep (#206–#231) — ships in the linked PR. This issue enumerates everything that pass deliberately deferred, so the rest can land as focused PRs after the next release cut.

Every item below is grounded in the deep-dive audit run for the first PR. Items are grouped by the follow-up PR that should own them.

✅ Resolved in the first PR (for reference)

• Storefront D-01 Aspire dashboard http→https; fileTree adds database/+tests/.
• Storefront D-02 real feat(cli): scaffold CRUD surface DX upgrade (C1–C10) [#153 CODE] #208 CRUD surface (createCrudContract + @database/zod + context.db), typed errors.NOT_FOUND, router health-nesting.
• Storefront D-03 mod.ts registration + CartContractV1 casing + @my-shop/contracts/versions/v1 subpath — and ch2 products.contract.ts exports realigned to PascalCase (ProductsContract/ProductsContractV1) so ch2↔ch3 imports agree.
• Storefront D-04 public netscript plugin install saga|trigger --name … --samples.
• fresh-ui/web-layer recon: DataTable→DataGrid, Icon+DataGrid root exports, Dropzone/prompt-input mentions, managed <Form> class/attrs, useIslandMutation onMutate/onSettled.

---

A. Storefront tutorial — Run-2 grounding (after release cut, Refs #153)

• Full manual Run-2 walk against the published scaffold (the 🔬 Tutorial DX Eval (alpha.17, ARMED): lock criteria + track 4 tutorial runs + derived backlog #153 second run).
• Verify 01-scaffold.md dry-run block (netscript init my-shop --dry-run) + apiTable options against real netscript init --help — the CLI init/scaffold command source was not in the audit's ground-truth set, so flags were left unchanged (nothing contradicted them).
• Verify the @my-shop/contracts/versions/v1 mod.ts re-export barrel pattern (and the ch2-registers-products-before-ch3-adds-cart flow) against a real scaffolded contracts workspace — currently best-grounded inference, no generated mod.ts was available to diff.
• Verify literal port numbers (18888, 4318, 3001, 8091–8093) against live scaffold.runtime e2e output.
• Consider adding a feat(aspire): enable browser-logs devtools integration by default + streams HTTP/2 caveat (#218) #231 browser-logs row to 06-deploy.md's dashboard-surfaces table (if it belongs in the tutorial vs. only the how-to guides).

B. Sibling tutorial + how-to sweep (same defect classes, other files)

• workspace/01-scaffold.md: Aspire dashboard http://localhost:18888→https in the "bring up orchestration" step + checklist (same defect class as storefront D-01).
• how-to/customize-fresh-ui.md: netscript ui:add data-table→data-grid, and refresh prompt-input/dropzone copy with the new drag+paste+multi-file / auto-grow behavior.

C. fresh-ui / web-layer reference depth (feature-sweep coverage)

• Full DataGrid usage/API reference page — columns, cell variants, row typing (fresh-ui: promote a generic templated DataGrid (successor to un-templated DataTable) #209/feat(fresh-ui): promote generic templated DataGrid (successor to DataTable) (#209) #225). Currently only named.
• Full Dropzone reference — drag/paste/multi-file API surface + props (dropzone: promote drag + clipboard-paste + multi-file ingest behavior #214/feat(fresh-ui): Dropzone drag + clipboard-paste + multi-file ingest (#214) #229).
• Full worked useIslandMutation onMutate optimistic-update + rollback code sample (query islands: useIslandMutation missing onMutate/onSettled (no true optimistic rollback) #210/feat(fresh): add onMutate/onSettled to useIslandMutation for optimistic rollback (#210) #227) — currently prose-only.

D. Aspire / telemetry docs (coverage gaps, not contradictions)

• capabilities/telemetry.md: note generated AppHosts wire Aspire.Hosting.Browsers / withBrowserLogs by default so browser console logs flow into the dashboard (devtools: enable Aspire browser-logs integration by default (capture island/browser console in the dashboard) #218/feat(aspire): enable browser-logs devtools integration by default + streams HTTP/2 caveat (#218) #231).
• capabilities/telemetry.md + reference/aspire/index.md: document aspire start --isolated and its randomized dashboard/OTLP/resource-service ports for parallel-safe runs (aspire: --isolated should randomize profile-pinned dashboard/OTLP/resource-service ports for parallel isolated apphosts #215/fix(aspire): randomize dashboard/OTLP/resource-service ports under --isolated (#215) #222).

E. Streams docs (scoping decision needed)

• No reference/streams/ page exists in the current docs tree — decide whether to create it, then add the HTTP/1.1 ~6-connection-per-origin browser caveat for SSE/streams (devtools: enable Aspire browser-logs integration by default (capture island/browser console in the dashboard) #218/feat(aspire): enable browser-logs devtools integration by default + streams HTTP/2 caveat (#218) #231).

F. Workers docs verification

• Re-verify capabilities/background-jobs.md "Where jobs come from" discovery mechanics (scan order, Service-vs-registry precedence) against real @netscript/plugin-workers / @netscript/service source (workers: service->plugin-API discovery + workers-api not loading user jobs (Aspire wiring gaps) #217/fix(workers): wire Service→plugin-API discovery + load user jobs in workers-api (#217) #220) — that source was not in the audit ground-truth set.

---

Generated from the first-slice deep-dive audit. First PR is docs-only and Refs #153 (does not close it — Run-2 remains).