REVIEW 4 major objections 5 minor 1 cited by
Current large language models are not symmetric integrators of software evidence: they audit documentation reliably but systematically miss implementation drift when the documentation still looks plausible.
Reviewed by Pith at T0; open to challenge. T0 means a machine referee read the full paper against a public rubric. the ladder, T0–T4 →
T0 review · deepseek-v4-flash
2026-08-02 16:46 UTC pith:UFR2BXRU
load-bearing objection Solid new benchmark; the doc-over-code asymmetry is plausible but the MUT-only ground truth needs an independent contradiction check before I'd trust the headline drop. the 4 major comments →
Measuring LLM Trust Allocation Across Conflicting Software Artifacts
The pith
A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.
Core claim
The central discovery is an asymmetry in LLM trust allocation: across all seven models, models detect documentation bugs (67-94%) and explicit Javadoc-implementation contradictions (50-91%) reliably, but when only the method implementation is injected with a bug while the Javadoc remains plausible, inconsistency detection drops by 21-43 percentage points. The paper interprets this as evidence that current LLMs reason primarily from natural-language specification cues rather than from semantic interpretation of code behavior. The authors further show this asymmetry tracks an interpretable model property: models that remain stable as surface cues weaken (Sonnet, DS-V3.2, Haiku) also produce mo
What carries the argument
TRACE (Trust Reasoning over Artifacts for Calibrated Evaluation), a pipeline that turns artifact-level trust into structured, machine-readable traces. Each sample is a bundle of four Java artifacts — method signature, Javadoc, method implementation, and test prefix — with six perturbation variants (documentation removal, documentation bug, implementation bug, and Javadoc-MUT contradiction at three severity tiers) generated against a clean baseline. Models are prompted with a fixed, artifact-symmetric instruction to produce per-artifact quality scores, pairwise conflict verdicts, an inconsistency report, and a reliability ranking; outputs are compared against provenance-annotated ground truth
Load-bearing premise
The ground-truth labels for fault severity and provenance are valid, and the 'subtle' implementation bugs are genuinely as subtle as the 'subtle' documentation bugs; if the two artifact types leak different amounts of surface cue, the measured documentation-over-code asymmetry is a property of the benchmark, not of the models.
What would settle it
Re-run the MUT-only perturbation condition with an additional control: take the same injected code bugs and present them with the true, matching Javadoc (not the pristine Javadoc) so semantic contradiction is identical but surface divergence differs; or have human annotators rate the conspicuousness of doc vs. code bugs blind to artifact type. If the 21-43 percentage point detection gap persists when doc and code bugs are matched on human-rated subtlety, the asymmetry is a model property; if it vanishes, it is a benchmark artifact of cue leakage.
If this is right
- LLM-based consistency checkers should be deployed as documentation auditors, not as autonomous code-drift detectors: documentation faults are caught at 67-94%, code-only drift at far lower rates.
- Any pipeline that uses an LLM to reconcile code with stale or plausible documentation will systematically miss implementation-only changes, which the paper argues is the dominant real-world inconsistency mode.
- Confidence scores should not gate correctness-critical decisions without per-model recalibration, since six of seven models show little separation between correct and incorrect detections.
- Model choice matters more than prompt uniformity: Sonnet, DS-V3.2, and Haiku degrade gracefully under subtle contradictions while GPT-4o collapses, so benchmark results without model identity are misleading.
- The severity-proportional scoring behavior indicates LLMs encode graded evidence quality, not just binary fault flags, so quality signals can be used for input triage.
Where Pith is reading between the lines
- This asymmetry may be an artifact of token-level salience: natural-language defects move many tokens that are easy to flag, while a small code mutation changes few tokens; the paper's own severity grading conflates semantic subtlety with surface conspicuousness.
- A direct testable extension would hold semantic difficulty fixed while varying only the artifact modality, e.g., inject the same bug described in the Javadoc vs. in the code, and measure whether the detection gap persists.
- If the blind spot is real, agentic SE systems that maintain a running 'world model' of code should be augmented with runtime or static verification signals rather than relying on the LLM alone to notice code drift.
- The trace format itself could enable supervised fine-tuning: TRACE traces with provenance labels are a ready-made training set for making models explicitly reason about artifact reliability before downstream tasks.
Editorial analysis
A structured set of objections, weighed in public.
Referee Report
Summary. The paper introduces TRACE, a controlled framework for eliciting structured 'trust traces' from LLMs over bundles of Java artifacts (Javadoc, signature, implementation, test prefix). The authors construct 456 curated real-world method bundles with six perturbation variants (documentation degradation, documentation bugs, implementation bugs, and mutual contradictions at three severity tiers), then query seven LLMs under a blind protocol. The central claim is that LLMs are asymmetric integrators of software evidence: they audit natural-language specifications (Javadoc) reliably, detecting documentation faults at 67–94% and explicit contradictions at 50–91%, but their detection drops by roughly 21–43 percentage points when only the implementation is perturbed while the Javadoc remains plausible. The paper also reports that quality penalties are localized and severity-ordered, that only one of seven models has confidence scores that separate correct from incorrect judgments, and that inter-model variation tracks a hypothesized 'semantic code understanding' factor.
Significance. If the central asymmetry holds, the paper makes a useful and timely contribution. TRACE is a sensible operationalization of trust allocation, and the study has real strengths: 456 curated real-world method bundles, seven models under a common harness, paired clean/perturbed observations, explicit false-positive floors, multi-signal detection (PCA/IC/IR plus Union/Majority), and provenance metadata for each perturbation. The headline result is practically important for LLM-based code review, CI triage, and test-generation pipelines, and the confidence-calibration caution is worth broadcasting. However, the headline result currently rests on two load-bearing assumptions—that MUT-only perturbations are genuine contradictions of the Javadoc, and that severity labels equate detectability across artifact types—that are not fully validated by the evidence presented. The paper's own Section 6 concedes that subtle samples may expose unintended cues and that ground-truth summaries are 'somewhat subjective.' With additional validation, the contribution would be solid; in its current form, the central asymmetry is a plausible and interesting hypothesis rather than a fully established model pro
major comments (4)
- [§3.3.2, Table 1; §6] The MUT_Only condition is load-bearing for the headline asymmetry, but the paper does not establish that each MUT-only mutation is actually inconsistent with the Javadoc. §3.3.2 says manual verification checked that the injected change is 'correctly realized, and aligned with its intended severity tier,' not that it violates the documented contract; §6 concedes that subtle samples may expose unintended cues and that ground-truth summaries are 'somewhat subjective.' No inter-annotator agreement is reported. If a subtle boundary/off-by-one/API-misuse bug falls outside the Javadoc's specified behavior, a model that does not flag the pair is correct rather than blind. Please add an explicit contradiction criterion for MUT-only perturbations, report agreement on it, and/or re-frame the finding as sensitivity to this benchmark's perturbation distribution rather than to LLM trust allocation.
- [§4.2.2, Fig. 8] The 21–43pp detection gap compares MUT_Only against DocBug/BOTH without an independent measure of perturbation conspicuousness. The severity rubric is defined per artifact type, so matched severity labels do not imply matched detectability; the measured asymmetry may be a property of the LLM-generated bugs rather than of LLM trust allocation. The RQ3 severity analysis does not resolve this because it is within artifact type. Add a control that equates difficulty across artifact types—e.g., human difficulty ratings, a non-LLM detector baseline, or counterbalanced perturbation pairs—or explicitly limit the claim to 'perturbations of this benchmark.'
- [§4.2.2] No inferential statistics support the headline gap. The paper reports ranges and means across seven models (e.g., '21–43 pp,' 'mean gap: −27.7 pp') but no confidence intervals, paired tests, or effect-size estimates over the 456 bundles or per model. With n=7 models, the 'across all seven models' claim needs at least per-model paired tests and an account of multiple comparisons; otherwise the asymmetry could be within noise for specific models. The same applies to the RQ1 heavy-to-subtle gaps and the confidence-separation claims.
- [§4.3] RQ3's conclusion that 'semantic code understanding explains much of the observed variation' is presented as an explanation, but the evidence is correlational: severity-drop stability and cosine fidelity are the same outcome family being explained, and no direct measure of code understanding is provided. This does not block the RQ2 finding, but it should be reworded as a hypothesis consistent with the data, or supported with a separate code-comprehension probe.
minor comments (5)
- [Abstract and §4.2] The detection-drop range is inconsistent: the original abstract and RQ2 text say '21–43 percentage points,' while the full-text abstract says '7–42 percentage points.' Please reconcile the baseline and report a single consistent range.
- [Figure 1] Typographical errors: 'Fileting' should be 'Filtering,' and 'ensambles' should be 'ensembles.'
- [§3.3.1] The example warning 'BEW ARE: don’t call this directly' appears to contain a typo; 'BEWARE' is presumably intended.
- [§4.2.2, Fig. 7] The term 'confidence calibration' is used for what is actually a separation of mean confidence between detected and missed traces. If no reliability diagrams or expected calibration error are provided, rename this 'confidence separation' to avoid overclaiming calibration.
- [§3.3.2] The manual verification of 456×3 generated perturbation families is described in one sentence. Please state how many annotators performed the verification, whether it was independent, and how disagreements were resolved; this is needed to support the ground-truth claim.
Circularity Check
No definitional circularity: the central RQ2 asymmetry is an independent behavioral measurement; only minor non-load-bearing self-citations and a post-hoc interpretive label in RQ3 keep the score at 2.
full rationale
The paper's central claim—that detection drops by 21–43 percentage points when only the MUT drifts while Javadoc stays plausible—is a direct behavioral measurement. Detection rates are scored against perturbation provenance encoded in the benchmark, with a clean-sample false-positive floor used for net-gain comparisons; no fitted parameter is renamed as a prediction and no equation equates an input with the claimed output. The benchmark is built on OE25 [9], a prior dataset co-authored by one of the current authors, and TOGLL [8] and Doc2OracLL [10] are cited as related work, but none of these citations is load-bearing: the observed asymmetry is measured across seven models on 456 bundles rather than derived from those papers. RQ3's 'semantic code understanding' is a post-hoc interpretive label correlated with heavy-to-subtle stability and description fidelity (Sec. 4.3), which is a mild construct-labeling tautology rather than a formal derivation, and it is not used to establish the central result. The paper itself flags the main validity threats—'samples labeled as subtle may still expose unintended cues' and 'Ground-truth one-line summaries are somewhat subjective' (Sec. 6)—and reports no inter-annotator agreement; these concerns bear on whether the asymmetry is a model property or a benchmark artifact, but they do not make the measurement circular. Overall: no significant circularity in the derivation chain, with only non-load-bearing self-citations and a minor interpretive labeling issue.
Axiom & Free-Parameter Ledger
free parameters (3)
- Benchmark curation thresholds =
8–60 executable lines; ≥2 control-flow elements; ≥4 assignments and ≥4 method calls; Javadoc >15 chars; test prefix ≥20
- Perturbation severity rubric =
heavy (explicit), normal (plausible defect), subtle (minimal corner-case deviation)
- Detection metric composition =
IR-strict primary; PCA, IC, Union, Majority supplementary
axioms (4)
- domain assumption The OE25-derived 456 method bundles are representative of real-world Java test-generation inputs
- domain assumption LLM-generated mutations with one-round manual verification provide valid ground-truth fault labels and severity tiers
- domain assumption Explicit self-reported quality scores, rankings, and confidence reflect actual artifact-level trust allocation
- domain assumption Cosine similarity to one-line ground-truth summaries is a valid proxy for description fidelity
read the original abstract
LLM-based software engineering assistants often reason over multiple artifacts, including code, documentation, signatures, and tests, even when those artifacts are incomplete or mutually inconsistent. Existing evaluations primarily measure final outputs, leaving unclear whether a model recognized unreliable evidence, identified the faulty source, or prioritized the appropriate artifact. We introduce TRACE, a controlled method for evaluating how LLMs assess and prioritize conflicting software artifacts. TRACE constructs paired clean and perturbed versions of real-world Java method bundles by injecting known faults into the documentation, implementation, or both while holding the remaining artifacts fixed. Models then assess artifact quality, detect and localize inconsistencies, and rank the available sources by reliability. Using 22,339 valid responses from seven LLMs on 456 method bundles, we find that quality penalties are generally localized to the perturbed artifact and increase with fault severity. However, models exhibit a consistent source-origin asymmetry: they detect documentation faults at 67-94% and explicit documentation-implementation contradictions at 50-91%, but detection falls by 21-43 percentage points when only the implementation changes while documentation remains intact. Models also struggle to deprioritize faulty implementations, and confidence provides little separation between correct and incorrect judgments for six of seven models. These results show that current LLMs are not symmetric integrators of software evidence: they audit natural-language specifications more reliably than subtle implementation behavior. TRACE provides a controlled method for exposing this failure mode before LLMs are used in correctness-critical software engineering workflows.
Figures
Forward citations
Cited by 1 Pith paper
-
ALIBI: Adaptive Agentic Attacks on LLM-Based Vulnerability Detectors via Adversarial Code Comments
Adaptive adversarial source-code comments evade four LLM vulnerability detectors at >90% success on 125 real null-pointer bugs without altering program behavior.
Reference graph
Works this paper leans on
-
[1]
2025.Claude Haiku 4.5 System Card
Anthropic. 2025.Claude Haiku 4.5 System Card. Technical Report. Anthropic. https://www.anthropic.com/claude-haiku-4-5-system-card
2025
-
[2]
2026.Claude Opus 4.6 System Card
Anthropic. 2026.Claude Opus 4.6 System Card. Technical Report. Anthropic. https: //www-cdn.anthropic.com/0dd865075ad3132672ee0ab40b05a53f14cf5288.pdf
2026
-
[3]
2026.Claude Sonnet 4.6 System Card
Anthropic. 2026.Claude Sonnet 4.6 System Card. Technical Report. Anthropic. https://anthropic.com/claude-sonnet-4-6-system-card
2026
-
[4]
DeepSeek. 2025. DeepSeek-V3.2 Release. DeepSeek API Documentation. https://api-docs.deepseek.com/news/news251201 Introduces DeepSeek-V3.2 and DeepSeek-V3.2-Speciale
2025
-
[5]
Felix TJ Dietrich, Yuchen Zhou, Tobias Wasner, Stephan Krusche, and Mari- bel Acosta. 2025. LLM-Based Multi-Artifact Consistency Verification for Pro- gramming Exercise Quality Assurance. InProceedings of the 25th Koli Calling International Conference on Computing Education Research. 1–11
2025
-
[6]
Elizabeth Dinella, Gabriel Ryan, Todd Mytkowicz, and Shuvendu K. Lahiri. 2022. TOGA: a neural method for test oracle generation. InProceedings of the 44th International Conference on Software Engineering(Pittsburgh, Pennsylvania)(ICSE ’22). Association for Computing Machinery, New York, NY, USA, 2130–2141. doi:10.1145/3510003.3510141
arXiv 2022
-
[7]
Angela Fan, Beliz Gokkaya, Mark Harman, Mitya Lyubarskiy, Shubho Sengupta, Shin Yoo, and Jie M. Zhang. 2023. Large Language Models for Software Engineer- ing: Survey and Open Problems. InProceedings - 2023 IEEE/ACM International Conference on Software Engineering: Future of Software Engineering, ICSE-FoSE
2023
-
[8]
Soneya Binta Hossain and Matthew B. Dwyer. 2025. TOGLL: Correct and Strong Test Oracle Generation with LLMS. In2025 IEEE/ACM 47th International Con- ference on Software Engineering (ICSE). 1475–1487. doi:10.1109/ICSE55347.2025. 00098
arXiv 2025
-
[9]
Dwyer, Sebastian Elbaum, and Willem Visser
Soneya Binta Hossain, Antonio Filieri, Matthew B. Dwyer, Sebastian Elbaum, and Willem Visser. 2023. Neural-Based Test Oracle Generation: A Large-Scale Evalua- tion and Lessons Learned. InProceedings of the 31st ACM Joint European Software Engineering Conference and Symposium on the Foundations of Software Engineering (San Francisco, CA, USA)(ESEC/FSE 2023...
arXiv 2023
-
[10]
Soneya Binta Hossain, Raygan Taylor, and Matthew Dwyer. 2025. Doc2OracLL: Investigating the Impact of Documentation on LLM-Based Test Oracle Generation. Proc. ACM Softw. Eng.2, FSE, Article FSE084 (June 2025), 22 pages. doi:10.1145/ 3729354
2025
-
[11]
Xinyi Hou, Yanjie Zhao, Yue Liu, Zhou Yang, Kailong Wang, Li Li, Xiapu Luo, David Lo, John Grundy, and Haoyu Wang. 2024. Large Language Models for Software Engineering: A Systematic Literature Review.ACM Transactions on Software Engineering and Methodology33, 8, Article 220 (2024). doi:10.1145/ 3695988
2024
-
[12]
Hyeonseok Lee, Gabin An, and Shin Yoo. 2025. Metamon: Finding inconsistencies between program documentation and behavior using metamorphic LLM queries. In2025 IEEE/ACM International Workshop on Large Language Models for Code (LLM4Code). IEEE, 120–127
2025
-
[13]
2024.GPT-4o System Card
OpenAI. 2024.GPT-4o System Card. Technical Report. OpenAI. https://cdn. openai.com/gpt-4o-system-card.pdf
2024
-
[14]
2025.Update to GPT-5 System Card: GPT-5.2
OpenAI. 2025.Update to GPT-5 System Card: GPT-5.2. Technical Report. OpenAI. https://openai.com/index/gpt-5-system-card-update-gpt-5-2/ Covers GPT-5.2 family; experiments used GPT-5.2 Chat endpoint
2025
-
[15]
2025.Grok 4 Fast Model Card
xAI. 2025.Grok 4 Fast Model Card. Technical Report. xAI. https://data.x. ai/2025-09-19-grok-4-fast-model-card.pdf Covers Grok 4 Fast reasoning and non-reasoning modes
2025
-
[16]
Xinye Xu, Zainab Wahab, Reid Holmes, and Caroline Lemieux. 2025. DocPrism: Local Categorization and External Filtering to Identify Relevant Code- Documentation Inconsistencies.arXiv preprint arXiv:2511.00215(2025)
Pith/arXiv arXiv 2025
- [2023]
discussion (0)
Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.