Skip to content

flip cross-call diffing to default-on; add --no-diff opt-outs#76

Merged
inth3shadows merged 1 commit into
mainfrom
diff-default-on
Jul 13, 2026
Merged

flip cross-call diffing to default-on; add --no-diff opt-outs#76
inth3shadows merged 1 commit into
mainfrom
diff-default-on

Conversation

@inth3shadows

Copy link
Copy Markdown
Owner

Why

The validation program that kept --diff opt-in is complete: pair fluency (4-model panel, 100%), the nested-record surface (#72: structure diff 100% vs full-terse 94%), and the drift soak (#75: mechanical zero-drift at depth 300 with an independent client-side reconstructor; behavioral depth-1..5 PASS on real corpus chains — overall worst gap −2% ±1, depth-5 gap −1% ±2). The default should match the measured reality; the opt-in stance was a validation gate, not a design preference.

What

  • Policy.diff defaults True; load_policy matches. An explicit policy-file "diff": false is still honored.
  • proxy: tri-state CLI--diff forces on (only meaningful against an opting-out policy file), new --no-diff forces off, neither keeps the policy value. Mutually exclusive (exit 2). multiproxy's diff_override becomes Optional[bool] (None = leave each peer's policy alone), so both flags stay proxy-wide including peers with their own policy_path.
  • install-mcp: tri-state diff — a plain wrap writes no diff flag (the entry inherits the proxy default); --diff/--no-diff bake an explicit override into the entry; --diff-keyframe-interval no longer requires --diff (and is dropped with --no-diff, where it would be dead weight). Flags still always reflect the latest install invocation.
  • Docs: README tier/Status; TECHNICAL's diff bullet rewritten (opt-in rationale is now history; the unobservable context-compaction residual keeps --no-diff as the escape hatch); USAGE proxy/install-mcp/text-diff sections, incl. the stash hand-edit gotcha found during the install-mcp: opt-in --diff wiring; docs: diff fluency is now validated #74 rollout.

Verification

  • 471 tests pass, ruff clean. The two off-by-default pins became on-by-default + "diff": false opt-out pins (JSON and CDC-text paths); install-mcp tri-state covered (None drops flags, False bakes --no-diff).
  • Live smoke (runecho downstream): a flagless proxy diffs the repeat structure call (117,587 → 205 chars); --no-diff sends the full form both times.

The validation program that kept --diff opt-in is complete — pair fluency
(4-model panel 100%), nested-record coverage (#72), and the drift soak (#75:
mechanical zero-drift at depth 300, behavioral depth-1..5 PASS on real corpus
chains). The default now matches the measured reality.

- Policy.diff defaults True; load_policy's doc.get("diff") default flips to
  match. An explicit policy-file "diff": false is still honored.
- proxy: tri-state CLI — --diff forces on (only useful against an opting-out
  policy file), new --no-diff forces off, neither keeps the policy value.
  Mutually exclusive, exit 2. multiproxy diff_override becomes Optional[bool]
  (None = leave each peer's policy alone) so --no-diff is proxy-wide too.
- install-mcp: diff param is tri-state — plain wraps write NO diff flag and
  inherit the proxy default; --diff/--no-diff bake an explicit override into
  the entry; keyframe-interval no longer requires --diff (but is dropped with
  --no-diff, where it would be dead weight).
- Tests: the two off-by-default pins become on-by-default + policy-false
  opt-out pins; install-mcp tri-state covered (None drops flags, False bakes
  --no-diff). 471 pass, ruff clean.
- Docs: README tier/Status, TECHNICAL diff bullet (opt-in rationale rewritten
  as history + the compaction residual keeps --no-diff as escape hatch),
  USAGE proxy/install-mcp/text-diff sections; also documents the stash
  hand-edit gotcha found during the #74 rollout.

Live smoke: flagless proxy diffs the repeat structure call (117,587 -> 205
chars); --no-diff sends the full form both times.
@inth3shadows inth3shadows merged commit cf4a422 into main Jul 13, 2026
5 checks passed
@inth3shadows inth3shadows deleted the diff-default-on branch July 13, 2026 23:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant