38 lines
2.4 KiB
Markdown
38 lines
2.4 KiB
Markdown
# Mixed CLI read interface
|
|
|
|
Implements the selected `harness/analysis-mixed-cli-contract-20260925.md` contract
|
|
in the integration owner's root records. Local implementation checkpoint; no
|
|
runtime claim is made by this note.
|
|
|
|
`oa_cli::check_mixed(&Path) -> Report` loads `MixedSourceSnapshot`, checks its
|
|
borrowed original bundle only when discovery diagnostics are empty, and copies
|
|
only returned diagnostics into the existing format-1 report. It never constructs
|
|
`Prepared`, compiles ordinary source, stabilizes identities, migrates or saves.
|
|
The closed `Dispatch` enum separates `CheckMixed` from `Editable { operation,
|
|
write }`; `Operation` and `prepare` retain their existing ordinary semantics.
|
|
|
|
Reports preserve input locations and explicit object IDs. Successful warnings
|
|
are retained. Source errors use `invalid`/1, loader missing/path/journal diagnostic
|
|
refusals use `invalid`/3, and direct `SourceFileError` retains the existing
|
|
`rejected`/3 mapping. Fixed fields are empty changes/notes, false written, zero
|
|
identity stabilization, and null migration. Human output names a mixed source8
|
|
check, with no edit-candidate summary. `--write`, unknown/repeated options and
|
|
wrong arity cannot enter either loader or preparation through mixed dispatch.
|
|
|
|
Six external `mixed_cli` tests execute the real Cargo-provided binary. The rich
|
|
OA/SA fixtures reuse previously authored ordinary/typed literals and independently
|
|
constructed public model values, with an explicit SA System, reordered call
|
|
labels, escaped include paths, decoy include comments, Unicode and LF/CRLF.
|
|
Their complete returned models and four ordered leaf warnings are checked before
|
|
complete CLI report comparison. The four warnings represent two leaf declarations
|
|
(allocation then coverage); they do not replace the earlier one-leaf oracle.
|
|
Other cases cover all four missing-UUID classes, schema refusal, cross-file
|
|
semantic failure, missing/cyclic/escaping includes, invalid UTF-8, pending journal,
|
|
reserved root, human output and option refusal. Each subprocess compares complete
|
|
file bytes and directory inventory before/after, including unrelated files.
|
|
Platform-specific OS missing-file text is obtained from an independent filesystem
|
|
metadata error; no parser, formatter or CLI output generates expected reports.
|
|
|
|
The parent owns compilation/runtime acceptance. This source note does not imply
|
|
Linux coverage, full mixed editing, GUI adoption or an atomic disk snapshot.
|