Codify/CodeLookup integration + @mieweb/ui upstream contributions (Doug directive 3)

[Taleef7]

What

Doug (2026-07-19 call): "your system should be using that Codify" — MIE's terminology database (terms → codes), surfaced as the Healthcare/CodeLookup component in the @mieweb/ui Storybook (stories: all-domains / conditions-only / meds-only / labs-only). Also: consider submitting WorkWell-built components upstream to @mieweb/ui.

Findings (2026-07-20)

• CodeLookup is NOT exported by installed @mieweb/ui@0.6.1 — no healthcare subpath; 33 component dirs, none clinical. Storybook at ui.mieweb.org has the full Healthcare set (CodeLookup, HealthSurveillance, ConditionEditor, MedicationList, OrderEditor, ProblemList, AllergyList, Assessment, PresentingProblems).
• npm carries dev prereleases (0.6.1-dev.167 latest) — probe them for the export; fallback = vendor per the ADR-007 datavis precedent, or ask MIE to publish (mirrors the standing @mieweb/datavis publish ask to Doug).

Plan

1. Probe dev prereleases for a CodeLookup export (timeboxed).
2. If available: wire into Studio ValueSetsTab (frontend/features/studio/components/ValueSetsTab.tsx) behind a UI flag; admin terminology-mappings form as follow-up; a backend /api/terminology/search proxy is future work.
3. If not: docs/mieweb-ui-migration/CODELOOKUP_STATUS.md + upstream publish ask → Thursday talking point.
4. Upstream-contribution candidates to propose: ChartDataTable (a11y chart tables), ComplianceChip/DeliveryChip chip-tier, RosterMobileCards, NitroGrid SSR-safe seam, OshaReferenceCombobox.

Wave: `docs/superpowers/plans/2026-07-20-doug-wave.md" (PR-7).

[Taleef7]

Probe result (2026-07-20): CodeLookup IS published — but only in dev prereleases. Scratch-install of @mieweb/ui@0.6.1-dev.167 exports CodeLookup/CodeLookupProvider/CodifyResult (+ HealthSurveillance, ProblemList). API: client-side search over hosted Codify shard indexes (indexUrl → {locale}/manifest.json), domains condition|med|lab|procedure|vaccine|occupational|quality, an employer programs.json protocol sidecar, onSelect(CodifyResult). The occupational+quality domains and protocol sidecar are squarely WorkWell-relevant.

Decision for the 2026-07-23 demo wave: document + ask, don't integrate — wiring it means bumping the whole frontend to a -dev.* prerelease days before the demo, and we don't know MIE's canonical Codify indexUrl yet. Full status + ready-to-build integration design (ValueSetsTab + admin terminology mappings): docs/mieweb-ui-migration/CODELOOKUP_STATUS.md.

Concrete Thursday asks for Doug/MIE: (1) cut a stable @mieweb/ui release including the Healthcare components (same shape as the standing @mieweb/datavis publish ask); (2) the canonical Codify indexUrl + whether an EH programs.json sidecar exists.

[Taleef7]

IMPLEMENTED (2026-07-20, PR #315). Reversing the same-day defer — two discoveries made it safe: (1) MIE's Codify shard index is publicly served with open CORS at https://ui.mieweb.org/codify (manifest verified; 770k entries); (2) upstream's src/components/CodeLookup/index.ts documents that the npm build intentionally omits the component (tsup can't bundle the module worker) — consumer-side bundling is the designed path, which is exactly the ADR-007 vendoring playbook. So frontend/vendor/codelookup/ + CodifyCodeSearch put a live "Find a code (Codify)" search in Studio → Value Sets (zero new deps; lucide + stable @mieweb/ui cover everything). Browser-verified: "breast cancer screening" → "Breast cancer screening (mammography) — eCQM CMS125" in ~39 ms → form prefill. Remaining asks for MIE stand (npm release ⇒ delete the vendor dir; bless the index host; EH programs.json?); follow-ups tracked here: admin terminology-mappings integration, domain tuning, upstream contributions.

[Taleef7]

WorkWell side delivered + merged (PR #315 in the 2026-07-20 wave): CodeLookup vendored from mieweb/ui source (frontend/vendor/codelookup/, pinned @ 4aa24e3, marked WORKWELL EDITs) is live in Studio → Value Sets, searching MIE's hosted ui.mieweb.org/codify index; a pick now prefills AND seeds the created value set with the code (POST /api/value-sets accepts validated codes[]). Index host overridable via NEXT_PUBLIC_CODIFY_INDEX_URL (Dockerfile + deploy build-arg).

Remaining scope this issue now tracks (the Thursday asks):

1. Upstream: publish a stable @mieweb/ui release that ships the Healthcare components → delete frontend/vendor/codelookup/ and flip imports.
2. Bless ui.mieweb.org/codify as a stable index host (or name the blessed one); is there an EH programs.json protocol sidecar?
3. Offer WorkWell components upstream: ChartDataTable (a11y), the chip tier, RosterMobileCards, the NitroGrid SSR seam, OshaReferenceCombobox.