Skip to content

Proposal: a clinical-medicine module track — EQUATOR reporting-standard gates, medical disclosure venues (incl. Chinese Medical Association policy), and a Chinese-literature citation resolver #593

Description

@ktao732084-arch

Hi — first, thank you for building ARS the way you did. We spent real time reading the code (not just the README): the fail-closed discipline and the three-way matched/unmatched/unresolvable verdicts in scripts/verification_gate/, the typed-hit validation and staleness advisories on the verification cache (#557), the gold/ vs heldout/ eval split, the grounded cross-model checks, and the compliance_agent framework running PRISMA-trAIce + RAISE at the 2.5/4.5 integrity gates. It is the most engineering-mature project of its kind we found, and it is motivated by the same evidence we care about (Zhao et al. arXiv:2605.07723 on hallucinated citations).

We're a small non-commercial effort building AI-assisted-research support for clinical medicine (our end users are hospital clinicians, mostly writing in Chinese). Rather than rebuild a pipeline that already exists and is better than what we'd make, we'd like to contribute a clinical/medical discipline module upstream — CONTRIBUTING.md's "discipline-specific modules are encouraged / domain-agnostic" line and the #259 domain-evidence-profiles direction are what prompted this. CC BY-NC 4.0 fits us fine (we're non-commercial too), and we intend to meet the engineering bar — tests, manifest registration, CHANGELOG discipline, README sync.

Split by your contribution tiers, smallest-reviewable-first

Directly PR-able (maintainer-review tier) — each arrives as its own small PR with its own issue

  1. Medical disclosure venues for venue_disclosure_policies.md — following the file's own "Adding a new venue (v2 and beyond)" procedure: entries for major medical venues (ICMJE-member journals such as NEJM / The Lancet / JAMA / BMJ, plus medical publishers), each hand-verified against the official policy page (Source URL + access date, never a third-party summary), alphabetical insertion, Scope-line / dispatch-doc / 5-language README sync. Plus a Chinese Medical Association Publishing House (中华医学会杂志社) canonical policy source in the shape of shared/policy_data/nature_policy.md (verbatim quotes preserved in Chinese with English paraphrase, provenance + snapshot discipline), consumed by a venue entry — their published GenAI rule (undisclosed AI use → rejection/retraction, with a submission ban in serious cases) is a real, citable venue policy relevant to a very large population of clinician-authors. We would not add a 5th policy anchor — we read the closed 4-anchor inventory, check_policy_anchor_table.py, and the Decision Doc §4.2 deferral; the CMA source would be venue-track only.

  2. EQUATOR clinical reporting-standard expansion of deep-research/references/equator_reporting_guidelines.md — extending the existing condensed-checklist style (paraphrased items + citation + official checklist URL, no verbatim table transcription, respecting checklist copyright — the licensing per standard is genuinely non-uniform and we've mapped it) for the primary-clinical study types the current file only maps by name: CARE (case reports), STARD (diagnostic accuracy), TRIPOD+AI (prediction models), plus a study-design → guideline routing decision sequence with an explicit "ambiguous → ask the scholar" fallback. Reference-file change only; no agent or schema edits.

  3. A Chinese-literature resolver client (standalone, gate-untouched)scripts/<source>_client.py mirroring the arxiv_client.py spec (typed Unavailable exception, time.monotonic throttling, title cross-check, exact-or-bust matching, no-retry-on-5xx), plus an API protocol reference doc and transport-fixture tests, following the design(literature): API-first retrieval with browser-controlled fallback #495/feat(citation-verification): API-first retrieval refresh — OpenAlex API-key auth, budget-aware 429, arXiv ToU backoff (#495) #496 community-contribution precedent. The underlying fact we'd like to put on your radar: Chinese DOIs are split across registration agencies (Crossref / ISTIC / CNKI — checkable via https://doi.org/ra/<prefix>), and api.crossref.org returns 404 for real ISTIC-registered DOIs (e.g. the 10.3760 Chinese Medical Association journals) that resolve fine through doi.org content negotiation. So "not found in Crossref" is not evidence a Chinese citation doesn't exist. The client resolves what is legally resolvable (doi.org content negotiation, Handle existence checks, PubMed coordinate queries — no CNKI/Wanfang scraping, they have no lawful open API) and everything else stays unresolvable, pending human check — never "fabricated" on a lookup miss, consistent with your precision-over-recall stance and the C-V6(a) ID-keyed narrowing.

Issue-first tier — proposed here, not yet built, awaiting your read

  1. EQUATOR compliance wiring (advisory-first). Extending compliance_agent's primary_research branch with an optional study_design input and an optional reporting-guideline subtree in the Schema 12 report — advisory / capped-at-warn in v1. We read the Holst-level argumentation bar that PRISMA-trAIce's Mandatory-block required; we are not asking for block semantics. We know this touches an agent definition and a hardened schema (additionalProperties: false, the user_override.scope pattern currently only admits PRISMA item ids) — design sketch available whenever you want it.

  2. Chinese-resolver gate integration. citation_verification_summary currently pins resolver_outcomes to exactly four resolvers, and the k=0..4 triangulation matrix / suffix lints would all move — we saw that adding arXiv was essentially a whole release (v3.11). Not proposing to touch any of that until the standalone client has proven itself and you think it's worth it.

What we deliberately keep OUT of tree, per your recorded boundaries

No real institution's or journal's format_profile content (#439 — venue entries stay disclosure-policy-only, no submission-formatting rules), no numeric "AIGC-detection thresholds" (we found no official journal-side ones; treating detector scores as compliance targets is exactly the wrong-target framing Issue #3 rejects), no predatory-journal blocklists baked into gates, and nothing that moves a decision from the scholar to the tool.

One open question (feel free to say "non-goal")

Given the copilot-not-pilot positioning — is an advisory "reporting-completeness readiness" summary (a per-standard gap list shown to the scholar, no verdict) in-scope for the compliance surface, or does that cross into judgment territory you'd rather leave out?

Questions for you

  • Does the tier split above match how you'd want it drawn? Any preference on sequencing?
  • Upstream vs sibling: if you'd rather keep clinical content as a sibling distribution (per CONTRIBUTING's sibling shape, upstream hash pinned), we'll happily do that instead — we'd still contribute the venue entries upstream, since the venue database is already discipline-plural.
  • For the CMA canonical policy source: venue-track-only with no dedup lint (manual discipline, as the file itself documents for non-anchor sources) — acceptable v1?

We'll start with the venue-database PR since it's the smallest reviewable unit. Thanks for considering it.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions