Skip to content

docs: reconcile living docs to MIE-only deployment and post-Sprint-7 state#59

Merged
Taleef7 merged 3 commits into
mainfrom
docs/sync-2026-06-08
Jun 8, 2026
Merged

docs: reconcile living docs to MIE-only deployment and post-Sprint-7 state#59
Taleef7 merged 3 commits into
mainfrom
docs/sync-2026-06-08

Conversation

@Taleef7
Copy link
Copy Markdown
Owner

@Taleef7 Taleef7 commented Jun 8, 2026

Summary

Documentation-only PR that brings the living docs into agreement with the current codebase and the single live MIE TWH deployment, removing facts that had drifted since the 2026-05-21 focus snapshot.

Stack facts corrected

  • Frontend Next.js 14+Next.js 16 + React 19 (frontend/package.json)
  • AI Spring AI (Anthropic)Spring AI (OpenAI starter), models gpt-5.4-nano / gpt-4o-mini (build.gradle.kts, application.yml)
  • Measure catalog stated as 60 total / 49 CMS eCQM (was 58/47)
  • SendGrid env var corrected to WORKWELL_EMAIL_SENDGRID_API_KEY

Deployment reconciled to MIE-only

  • DEPLOY.md rewritten: MIE Create-a-Container is the sole current stack; all Fly.io/Vercel provisioning, rollback, and troubleshooting moved into a clearly-labeled historical appendix (env-var names preserved)
  • DEPLOY_OS_MIEWEB.md gets a historical/superseded banner that neutralizes its now-invalid Fly/Vercel rollback path
  • README "Production surfaces", .env.example (incl. the stale CORS origin), and the demo/MCP guide hostnames updated to twh.os.mieweb.org / twh-api.os.mieweb.org

Status refreshed

  • Sprint 7 closed + Sprint 8 scoped-run parity, the CI test-sharding speedup, and the MIE v1 deploy migration reflected across CLAUDE.md, AGENTS.md, README, the sprint index, and CHANGELOG

Best-practice cleanups (the two review caveats)

  • DEMO_RUNBOOK refactored from hardcoded (ephemeral) UUIDs to an auth + capture procedure, verified against the live API response shapes (login returns {token}; list endpoints return bare arrays)
  • DEPLOY_OS_MIEWEB framed as the historical migration playbook rather than a current guide

Intentionally left as historical

docs/archive/**, docs/new instructions/**, docs/superpowers/**, per-sprint specs, LIVE_APP_QA_REPORT.md, and POST_MERGE_STATUS.md (dated, already annotated).

Notes

🤖 Generated with Claude Code

Taleef and others added 2 commits June 3, 2026 22:46
Add JOURNAL entries for the two post-Sprint-8 efforts:
- MIE Container Manager deploy fix (v1 API migration: /api/v1 base, {data}
  envelope, array-shaped create services) — PRs #55/#56, deploy green.
- CI test suite 44min -> 11m30s via fixing per-test full-population reruns
  (@BeforeAll once-per-class) plus 8-way test sharding — PR #57, all 239 pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…state

Bring CLAUDE.md, AGENTS.md, README, DEPLOY, the sprint index, CHANGELOG, .env.example, JOURNAL, and the demo/MCP guides into agreement with the current codebase and the single live MIE TWH deployment.

- Stack facts: Next.js 16 + React 19; Spring AI OpenAI starter (gpt-5.4-nano / gpt-4o-mini); measure catalog 60 total / 49 CMS eCQM; SendGrid env var name corrected.
- Deployment: MIE Create-a-Container documented as the sole live stack; the decommissioned Vercel + Fly.io stack moved to a labeled historical appendix in DEPLOY.md and bannered in DEPLOY_OS_MIEWEB.md; README surfaces, .env.example CORS origin, and guide hostnames updated.
- Status: Sprint 7 closed + Sprint 8 scoped-run parity, CI test-sharding speedup, and the MIE v1 deploy migration reflected across CLAUDE.md, README, sprint index, and CHANGELOG.
- DEMO_RUNBOOK refactored from hardcoded (ephemeral) UUIDs to an auth + capture procedure verified against the live API response shapes.

No code changes; documentation only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
workwell-measure-studio Ready Ready Preview, Comment Jun 8, 2026 1:53pm

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c824b467e8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/DEMO_RUNBOOK.md Outdated
@Taleef7 Taleef7 self-assigned this Jun 8, 2026
Address Codex review on #59: the capture commands used query params the
backend silently ignores. /api/runs has no measureId filter (status,
scopeType, triggerType, site, from, to, limit only) and /api/cases filters
by measureId, not measureName — so a demo where the first row was not the
Audiogram scenario captured unrelated IDs and broke the deterministic
get_run_summary / explain_outcome evidence trail.

- runs: post-filter the returned JSON by measureName (Audiogram) instead of
  passing an unsupported measureId param.
- cases: filter by the supported measureId (reusing $MEASURE_ID from step 2)
  instead of the unsupported measureName.
- mirror both fixes in the pre-flight smoke check.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Taleef7 Taleef7 merged commit 8075fd2 into main Jun 8, 2026
20 checks passed
@Taleef7 Taleef7 deleted the docs/sync-2026-06-08 branch June 8, 2026 14:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant