Skip to content

docs: replay method citations on current review workflow - #1011

Merged
seonghobae merged 8 commits into
mainfrom
docs/method-citations-current-review-948
Aug 24, 2026
Merged

seonghobae merged 8 commits into
mainfrom
docs/method-citations-current-review-948

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Supersedes #948 and keeps this lane documentation-only; no estimator, formula, API, or psychometric arithmetic changes.

Current exact head

5472319a71fd20df19d9f8d27321e301d69fc854 against protected main@04d0bc21a2a20693bcf16108cd76d394fe844d23.

Reviewed corrections

  • Preserves the already-correct BRATT tie-free-data rejection and Angoff (1972) APA annual-meeting presentation record from the successor lineage.
  • Corrects the Uto final journal citation to 2023 for Behavior Research Methods volume 55, pages 3910–3928 (the publisher records online publication in 2022 and the final issue in 2023).
  • Aligns ADR-0016 with the shipped delta_plot missingness contract: the observed-score kernel may drop NaN cells per item/group; only a missing-data likelihood DIF model remains separate; an item-group with no observed cells still errors.
  • The two new CodeRabbit threads for those records are addressed and resolved.

The predecessor OpenCode CHANGES_REQUESTED on #948 belongs to older central coverage evidence and is not transferred as source approval. Fresh exact-head CI/security/review evidence for 5472319... is regenerating; auto-merge is enabled but protection/independent approval remains authoritative.


Open in Devin Review

cursoragent and others added 3 commits August 16, 2026 16:53
Add method pages and ADRs 0015-0016 for the shipped observed-score
delta-plot DIF screen and Hunter MM Bradley-Terry ranking estimators.
Expand ADR-0001/0005/0006/0007 with verified DOIs and AERA/APA/NCME 2014.
Keep MH/logistic/SIBTEST citations and do not treat those methods, or
NIST/OWASP, as the delta-plot basis.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
Keep main's ADR-0015 (multi-item IRT fit boundary). Move the Angoff
delta-plot and Bradley-Terry decisions to ADR-0016 and ADR-0017 so both
decision records remain indexed.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
bratt_mm rejects tie-free data rather than redirecting; delta-plot
drops NaN per item/group instead of requiring a complete matrix;
Angoff 1972 is an APA meeting presentation.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a0a63f22-cef0-4e1f-bdae-b29392d9c0c2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This documentation-only change records implemented MLSIRM/MLS2PLM, Angoff delta-plot DIF, and Bradley–Terry MM/BRATT methods. It adds ADRs, research citations, usage documentation, package indexes, maturity records, and traceability updates.

Changes

Implemented method documentation

Layer / File(s) Summary
Research scope and standards basis
README.md, docs/adr/0001-domain-neutral-measurement-boundary.md, docs/adr/0005-automated-scoring-raters.md, docs/adr/0006-relation-safe-model-selection.md, docs/adr/0007-multilevel-multiple-membership-temporal.md, docs/papers/*, docs/traceability/research-basis.md
The documentation defines measurement scope and expands research and standards citations.
Angoff delta-plot DIF method
docs/adr/0016-angoff-delta-plot-dif.md, docs/delta_plot_dif.md, docs/rubric_dif_pilot_handoff.md
The ADR and method guide document the delta-plot screen, validation, purification, interpretation limits, implementation boundaries, and sources.
Bradley–Terry MM and BRATT methods
docs/adr/0017-bradley-terry-mm.md, docs/bradley_terry_mm.md, docs/doctoring/lsr_ranking_input_bounds.md
The documentation defines both estimators, input and convergence behavior, examples, distinctions from other ranking methods, and interpretation limits.
Documentation indexes and traceability
docs/README.md, docs/adr/README.md, docs/changelog.d/*, docs/documentation_coverage.md, docs/standards_watch.md, docs/traceability/*
Indexes, maturity records, standards policy, changelog entries, and traceability matrices link the methods to their ADRs, sources, and implementation evidence.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk: 🟡 Moderate · up to fa5af

The documentation currently misstates how supported missing values are handled, which could lead users to reject valid inputs; this wording should be corrected before merging. A separate minor citation-year correction is also needed.

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the documentation citation updates and review-workflow replay covered by the pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/method-citations-current-review-948

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

coderabbitai[bot]

This comment was marked as resolved.

@seonghobae
seonghobae enabled auto-merge (squash) August 19, 2026 02:35
@opencode-agent
opencode-agent Bot disabled auto-merge August 19, 2026 02:51
@seonghobae
seonghobae enabled auto-merge (squash) August 19, 2026 03:12

Copy link
Copy Markdown
Contributor Author

@opencode-agent @cwl-noema-review Please independently review exact current head 5472319a71fd20df19d9f8d27321e301d69fc854 against live main. Repository CI, Security Scan, CodeQL, and Semgrep are terminal-success; both CodeRabbit threads are resolved/outdated. Verify the corrected Uto 2023 final citation, Angoff/delta-plot missingness contract, and the documentation-only ownership boundary without transferring #948 predecessor evidence.

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

OpenCode cannot approve yet because required coverage evidence did not pass.

Review outcome

1. HIGH .github/workflows/opencode-review.yml:1 - Coverage evidence did not prove required test/docstring evidence

  • Problem: The required coverage-evidence job result was failure, so OpenCode cannot establish approval sufficiency for this head.

  • Root cause: Automated approval is only valid when the same-head coverage-evidence job proves supported repository test suites passed and configured docstring gates passed or were advisory, or reports not applicable because no supported source files or package manifests exist. Missing, failed, skipped, unavailable, or unsupported-tooling test evidence is a blocker.

  • Fix: Install or configure the repository test/docstring evidence tooling when source files or package manifests exist, rerun the current-head coverage-evidence job, and approve only after it reports success with required evidence or explicit no-source not-applicable evidence.

  • Regression test: Keep the approval branch checking needs.coverage-evidence.result == success before posting APPROVE, and publish REQUEST_CHANGES when coverage-evidence blocker states such as cancelled, skipped, failed, unsupported-tooling, or below-100 evidence are present.

  • Result: REQUEST_CHANGES

  • Reason: coverage-evidence result was failure, so required test/docstring evidence was not proven for current head 5472319a71fd20df19d9f8d27321e301d69fc854.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

  • Workflow run: 32213335032

  • Workflow attempt: 1

Coverage evidence

Coverage evidence job did not run or did not publish coverage evidence.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file: README.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file: README.md"]
  R1 --> V1["required checks"]
  Evidence --> S2["Docs (19 files)"]
  S2 --> I2["operator or user guidance"]
  I2 --> R2["Review risk: Docs (19 files)"]
  R2 --> V2["docs review"]
Loading

@opencode-agent

opencode-agent Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

OpenCode Review Overview

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854
  • Workflow run: 32217712201
  • Workflow attempt: 1
  • Gate result: REQUEST_CHANGES (approval step)

Pull request overview

OpenCode cannot approve yet because required coverage evidence did not pass.

Review outcome

1. HIGH .github/workflows/opencode-review.yml:1 - Coverage evidence did not prove required test/docstring evidence

  • Problem: The required coverage-evidence job result was failure, so OpenCode cannot establish approval sufficiency for this head.

  • Root cause: Automated approval is only valid when the same-head coverage-evidence job proves supported repository test suites passed and configured docstring gates passed or were advisory, or reports not applicable because no supported source files or package manifests exist. Missing, failed, skipped, unavailable, or unsupported-tooling test evidence is a blocker.

  • Fix: Install or configure the repository test/docstring evidence tooling when source files or package manifests exist, rerun the current-head coverage-evidence job, and approve only after it reports success with required evidence or explicit no-source not-applicable evidence.

  • Regression test: Keep the approval branch checking needs.coverage-evidence.result == success before posting APPROVE, and publish REQUEST_CHANGES when coverage-evidence blocker states such as cancelled, skipped, failed, unsupported-tooling, or below-100 evidence are present.

  • Result: REQUEST_CHANGES

  • Reason: coverage-evidence result was failure, so required test/docstring evidence was not proven for current head 5472319a71fd20df19d9f8d27321e301d69fc854.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

  • Workflow run: 32217712201

  • Workflow attempt: 1

Coverage evidence

Coverage evidence job did not run or did not publish coverage evidence.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file: README.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file: README.md"]
  R1 --> V1["required checks"]
  Evidence --> S2["Docs (19 files)"]
  S2 --> I2["operator or user guidance"]
  I2 --> R2["Review risk: Docs (19 files)"]
  R2 --> V2["docs review"]
Loading

@opencode-agent
opencode-agent Bot disabled auto-merge August 19, 2026 05:52

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

OpenCode cannot approve yet because required coverage evidence did not pass.

Review outcome

1. HIGH .github/workflows/opencode-review.yml:1 - Coverage evidence did not prove required test/docstring evidence

  • Problem: The required coverage-evidence job result was failure, so OpenCode cannot establish approval sufficiency for this head.

  • Root cause: Automated approval is only valid when the same-head coverage-evidence job proves supported repository test suites passed and configured docstring gates passed or were advisory, or reports not applicable because no supported source files or package manifests exist. Missing, failed, skipped, unavailable, or unsupported-tooling test evidence is a blocker.

  • Fix: Install or configure the repository test/docstring evidence tooling when source files or package manifests exist, rerun the current-head coverage-evidence job, and approve only after it reports success with required evidence or explicit no-source not-applicable evidence.

  • Regression test: Keep the approval branch checking needs.coverage-evidence.result == success before posting APPROVE, and publish REQUEST_CHANGES when coverage-evidence blocker states such as cancelled, skipped, failed, unsupported-tooling, or below-100 evidence are present.

  • Result: REQUEST_CHANGES

  • Reason: coverage-evidence result was failure, so required test/docstring evidence was not proven for current head 5472319a71fd20df19d9f8d27321e301d69fc854.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

  • Workflow run: 32217712201

  • Workflow attempt: 1

Coverage evidence

Coverage evidence job did not run or did not publish coverage evidence.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file: README.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file: README.md"]
  R1 --> V1["required checks"]
  Evidence --> S2["Docs (19 files)"]
  S2 --> I2["operator or user guidance"]
  I2 --> R2["Review risk: Docs (19 files)"]
  R2 --> V2["docs review"]
Loading

Copy link
Copy Markdown
Contributor Author

@opencode-agent review
@cwl-noema-review review

Fresh re-review request: ContextualWisdomLab/.github#1136 has merged, fixing the central coverage-evidence bug (_install_trusted_uv() target-triple validation) that caused the prior REQUEST_CHANGES verdict on this PR. Please re-review exact current head 5472319a71fd20df19d9f8d27321e301d69fc854 — the underlying infrastructure blocker is now resolved on .github main. Do not transfer evidence from any prior head.


Generated by Claude Code

Copy link
Copy Markdown
Contributor Author

@opencode-agent Please re-review the unchanged current exact head 5472319a71fd20df19d9f8d27321e301d69fc854. The two existing REQUEST_CHANGES reviews were caused by central coverage-evidence failing before PR execution because trusted uv 0.12.1 was incorrectly compared against a bare version string. That first causal boundary has now been fixed on current ContextualWisdomLab/.github protected main by #1136 (9e9f59f3ac1e96a960c021b131d768c238f4c21a), which validates the real uv 0.12.1 (x86_64-unknown-linux-gnu) output. Reacquire coverage and review evidence from the current central workflow; do not transfer predecessor evidence.

Copy link
Copy Markdown
Contributor Author

@opencode-agent Please re-review unchanged exact head 5472319a71fd20df19d9f8d27321e301d69fc854 against live main@04d0bc21a2a20693bcf16108cd76d394fe844d23. Repository CI, Security Scan, CodeQL, and Semgrep are terminal-success on this SHA, and both CodeRabbit source-truth findings are resolved/outdated on the current head. The remaining formal CHANGES_REQUESTED comes from central coverage runs before .github main advanced to 9e9f59f3ac1e96a960c021b131d768c238f4c21a (fix(ci): verify trusted uv target-triple output (#1136), 2026-08-19T09:24:32Z), which directly repairs the trusted-uv materialization boundary. Please regenerate same-head coverage/formal review evidence under the current central contract.

Copy link
Copy Markdown
Contributor Author

@opencode-agent review
@cwl-noema-review review

Re-dispatch unchanged exact head 5472319a71fd20df19d9f8d27321e301d69fc854 under central .github@bbedc1a51ec1a2421f129955c629b3cd0507a4ec. Repository CI, Security Scan, CodeQL, and Semgrep are terminal-success, and both CodeRabbit source-truth threads are resolved/outdated. Central main now contains both #1136's trusted-uv target-triple correction and #1140's OIDC permission repair for hourly review callers. Reacquire same-head coverage/formal review evidence; do not transfer older dispatch results.

@seonghobae seonghobae closed this Aug 19, 2026
@seonghobae seonghobae reopened this Aug 19, 2026
@seonghobae seonghobae closed this Aug 19, 2026
@seonghobae seonghobae reopened this Aug 19, 2026
@seonghobae

Copy link
Copy Markdown
Contributor Author

@opencode-agent review
@cwl-noema-review review

Please re-review exact current head 5472319a71fd20df19d9f8d27321e301d69fc854 against protected main@04d0bc21a2a20693bcf16108cd76d394fe844d23. Documentation/architecture and DIF contract tests pass locally (64 passed). Current source/security checks are terminal; coverage/OpenCode/GPU entries are cancelled at the known pre-#1021 infrastructure boundary. Verify Uto final-issue APA citation, delta-plot NaN/no-observed-cell contract, Bradley–Terry/BRATT scope, and documentation-only ownership without transferring predecessor evidence.

@seonghobae
seonghobae enabled auto-merge (squash) August 20, 2026 04:20
@opencode-agent
opencode-agent Bot disabled auto-merge August 20, 2026 04:47
@seonghobae
seonghobae enabled auto-merge (squash) August 20, 2026 04:55
@opencode-agent
opencode-agent Bot disabled auto-merge August 20, 2026 06:24
@seonghobae

Copy link
Copy Markdown
Contributor Author

Current-head review for 5472319: required checks are terminal-success on this exact head. Existing formal review state predates the current evidence or was tied to an earlier coverage-evidence attempt; no source failure is shown. Please reacquire approval against this exact head. @opencode-agent review @cwl-noema-review review

@seonghobae
seonghobae enabled auto-merge (squash) August 20, 2026 07:27
@opencode-agent
opencode-agent Bot disabled auto-merge August 20, 2026 22:12
@seonghobae
seonghobae enabled auto-merge (squash) August 20, 2026 22:44
@opencode-agent
opencode-agent Bot disabled auto-merge August 20, 2026 22:47

Copy link
Copy Markdown
Contributor Author

@opencode-agent Please perform a review-only formal review of exact current PR head 5472319a71fd20df19d9f8d27321e301d69fc854. Re-check changed-file scope, current-head findings, unresolved threads, mergeability, and every required Check. Do not reuse a stale review, mutate the branch, self-approve, or merge.

@seonghobae

Copy link
Copy Markdown
Contributor Author

Current-head review for 5472319: the two CodeRabbit findings are already resolved in the current diff. The Uto citation is 2023 in docs/adr/0007-multilevel-multiple-membership-temporal.md, and ADR-0016 explicitly documents NaN dropping per item and group, the separate missing-data likelihood path, and the empty item-group error. No additional source edit is justified. Current hosted checks are successful; normal squash auto-merge is now armed and remains subject to the independent formal review gate.

@seonghobae
seonghobae enabled auto-merge (squash) August 21, 2026 00:40
@opencode-agent
opencode-agent Bot disabled auto-merge August 21, 2026 00:48
@seonghobae
seonghobae enabled auto-merge (squash) August 21, 2026 04:46
@seonghobae

Copy link
Copy Markdown
Contributor Author

Verified the two actionable findings against exact current head 5472319: Uto is already cited as 2023 in ADR-0007, and ADR-0016 already documents per-item/per-group NaN dropping, the separate missing-data likelihood path, and the empty item-group error. No further source edit is justified. Please re-review this unchanged current head under the repaired central coverage contract; protected auto-merge remains gate-controlled. @opencode-agent review @cwl-noema-review review

@opencode-agent
opencode-agent Bot disabled auto-merge August 21, 2026 08:27
@opencode-agent

Copy link
Copy Markdown
Contributor

Scheduled review-feedback autofix for this PR head.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

@seonghobae
seonghobae enabled auto-merge (squash) August 21, 2026 10:18
@opencode-agent

Copy link
Copy Markdown
Contributor

Scheduled review-feedback autofix for this PR head.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

@opencode-agent
opencode-agent Bot disabled auto-merge August 21, 2026 11:57
@opencode-agent

Copy link
Copy Markdown
Contributor

Scheduled review-feedback autofix for this PR head.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

@opencode-agent

Copy link
Copy Markdown
Contributor

Scheduled review-feedback autofix for this PR head.

  • Head SHA: 5472319a71fd20df19d9f8d27321e301d69fc854

@opencode-agent opencode-agent Bot added area: ci-cd CI, GitHub Actions, checks, release, or supply chain priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: docs Documentation, ADR, PRD, or technical writing labels Aug 22, 2026
@seonghobae
seonghobae enabled auto-merge (squash) August 24, 2026 01:07
@opencode-agent
opencode-agent Bot disabled auto-merge August 24, 2026 02:19
@seonghobae
seonghobae enabled auto-merge (squash) August 24, 2026 13:18
devin-ai-integration[bot]

This comment was marked as resolved.

@seonghobae
seonghobae merged commit 7006815 into main Aug 24, 2026
38 checks passed
@seonghobae
seonghobae deleted the docs/method-citations-current-review-948 branch August 24, 2026 22:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: ci-cd CI, GitHub Actions, checks, release, or supply chain priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: docs Documentation, ADR, PRD, or technical writing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants