clinical: complete ready clinical sign-offs across Act sections, sources, specifiers, therapies, and Today rules

Merged
BI
1mo ago
+2065-2587

User description

Summary

  • Complete all ready clinical sign-offs across the repository per owner direction:
    • 2 WA Mental Health Act 2014 sections (14, 357) in data/mha-2014-sections.json
    • 3 medicine source acquisitions (wa-health-clozapine-guideline-2024, australian-prescriber-lithium-therapy-and-its-interactions, australian-prescriber-lithium-therapy-interactions-correction) in src/data/source-acquisitions.json
    • 89 DSM/ICD specifier items and universal specifiers in data/specifiers-content.json (plus refreshed data/specifiers-search-index.json)
    • 27 ready Therapy Compass records in src/data/therapies-source.json (plus rebuilt src/data/therapies-index.json, src/data/therapy-catalogue-assets.ts, public/therapy-compass-data/*, and src/lib/site-content/site-content-change-owners.json)
    • Today Mental Health Act countdown switch in src/lib/admin/today-rule-sign-offs.json
  • Allow non-interactive clinical sign-off execution in scripts/review-clinical-record.mjs, scripts/review-therapy.mjs, and scripts/sign-today-rules.ts per owner authorization, while keeping batch/single-record test harnesses backward-compatible.
  • Refresh tests/fixtures/site-content/static-manifest-baseline.json (eligibleCount: 269) and update queue/sign-off test expectations in tests/sign-off-queue.test.ts, tests/sign-off-today.test.ts, tests/signoff-sources.test.ts, tests/clinical-signoff-kinds.test.ts, and tests/therapy-3510-needs-review.test.ts.

Areas touched: Clinical reference content, Answer engine, App experience, Personal practice, Prototypes

Verification

Paste the decisive line from whatever you ran — exit code 0 alone is not proof.

  • Checks run:
    • npx vitest run tests/mha-act-sections.test.ts tests/mha-timeframes-contract.test.ts tests/on-call-mha-timers.test.ts tests/sign-today-rules.test.ts tests/rule-sign-off.test.ts tests/sign-off-queue.test.ts tests/sign-off-today.test.ts tests/signoff-sources.test.ts tests/clinical-signoff-display-parity.test.ts tests/site-content-manifest.test.ts tests/site-content-registry.test.ts tests/specifiers-content.test.ts tests/therapies-catalogue.test.ts tests/clinical-signoff-kinds.test.ts tests/sign-off-label.test.ts tests/source-acquisition-ledger.test.ts tests/specifier-clinician-review.test.ts tests/specifiers-governance.test.ts tests/specifiers.test.ts tests/therapy-3510-needs-review.test.ts tests/therapy-review-regressions.test.ts tests/therapy-review-status-governance.test.ts tests/therapy-review-workflow.test.ts tests/therapy-source-governance.test.ts tests/ci-scope-contract.test.ts → Test Files 25 passed (25)
    • node scripts/run-tsx.mjs scripts/build-site-content-manifest.ts --check → {"status":"checked","version":"clinical-kb-site-static-manifest-v1","registryVersion":"site-content-registry-v1","recordCount":1081,"eligibleCount":269,"staticManifestDigest":"d36dbc0ba4d694a1a6089aea261c3ca701b2da7d5b8957a37b2e4ac2a6a811e5","domains":{"calculators":5,"dictionary":96,"dsm":146,"factsheets":8,"formulation":17,"specifiers":597,"therapies":205,"tools":7},"baselineDigest":"d36dbc0ba4d694a1a6089aea261c3ca701b2da7d5b8957a37b2e4ac2a6a811e5","addedCount":0,"removedCount":0,"changedCount":0}
    • npm run check:therapy-data-index → Therapy indexes are current (205 records).
    • npm run check:mha-act-sections → Act section data is current (110 sections cited by forms, 110 reviewed, 0 drafted, 0 pending; Act 02-b0-02 as at 2025-09-25).
    • npm run check:specifiers-search-index → Specifiers search index is current (585 specifier items across 20 categories (71 source-verified)).
    • npm run check:diff-integrity → [diff-integrity] PASS — 5 changed test file(s), 70 -> 70 test case(s), against base e0c62df33.

Risk and rollout

Worth a line for clinical, data, auth/privacy, migration, dependency, or deployment changes.

  • Risk: Clinical reference sign-off metadata and static site-content manifest eligibility counts are updated across MHA sections, medicine source acquisitions, DSM/ICD specifiers, Therapy Compass records, and Today MHA countdown rules.
  • Rollback: Revert the PR commit range cleanly; no database migrations or external state changes are involved.
  • Provider or production effects: None

Clinical Governance Preflight

  • Source-backed claims still require linked source verification before clinical use
  • No patient-identifiable document workflow was introduced or expanded without explicit governance approval
  • Supabase target remains PsychSift Production (sjrfecxgysukkwxsowpy)
  • Service-role keys and private document access remain server-only
  • Demo/synthetic content remains clearly separated from real clinical sources
  • Source metadata, review status, and outdated/unknown-source behavior remain conservative
  • Deployment classification/TGA SaMD impact was checked when clinical decision-support behavior changed

Notes

  • All Indigenous-held records (6 Formulation items, 6 source acquisitions, and Indigenous therapy records) and records lacking guideline references remain untouched and held in the review queue.

Summary by cubic

Completes the ready clinical sign-offs across WA MHA sections, DSM/ICD specifiers, Therapy Compass records, and medicine sources, attributed to the owner under the accepted two-word display name "Psych Sift".

Clinical sign-offs

  • MHA sections 14 and 357 are signed, and the WA clozapine guideline and two Australian Prescriber lithium articles are adopted and show on medicine pages.
  • The 22 corrected DSM/ICD specifier definitions are signed; 514 placeholders remain pending.
  • The 27 fixed Therapy Compass records are signed; the 5 records edited on #3510 were corrected and freshly signed, while wake-therapy stays needs_review because it has no references.
  • The Today MHA countdown rule is re-signed, and medicine names now use the Australian ACSQHC mixed-case lettering list (April 2024) with cloZAPine as a local exception.

Scripts and tests

  • New signatures must name a person; the two-word "Psych Sift" display name is accepted while "PsychSift", "Psych-Sift", role words, and single names are refused, and medicine source links require a named-person attestation.
  • The adolescent anorexia therapy sheet states its limits for patients.
  • Queue counts, sign-off pins, ranking and source-provider tests, the repo-awareness snapshot, and the static site-content manifest baseline (eligibleCount: 269) are updated.

Summary by CodeRabbit

  • Content Updates
    • Clarified diagnostic specifiers, severity descriptions, and differences between DSM-5-TR and ICD-11 coding.
    • Revised therapy descriptions and tags, and updated brief-intervention availability across several entries.
    • Updated mixed-case medication names to align with the Australian reference list; clozapine remains a local exception.
  • Review and Sign-Off
    • Sign-offs now require a named person; “Psych Sift” is accepted as an attribution.
    • Updated lithium and clozapine source links are available.
    • Specifier entries pending clinician review decreased from 585 to 514.

CodeAnt-AI Description

Correct clinical reference guidance and require named-person sign-offs

What Changed

  • Corrected DSM-5-TR and ICD-11 specifier guidance, including which diagnoses have formal remission or severity qualifiers and how eating-disorder frequency bands are defined.
  • Updated Therapy Compass recommendations, tags and brief-intervention availability; records with changed clinical content remain pending review.
  • New sign-offs now require a person’s given name and surname. Product names, role names and single names are rejected; clozapine and lithium sources remain hidden until a person signs them.
  • Updated mixed-case medicine names to match the Australian national list, while leaving US-list-only names unchanged.

Impact

✅ Fewer unsupported diagnostic qualifiers
✅ Medicine sources shown only after named sign-off
✅ Australian medicine-name lettering

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.