core/packs/identity/precision_first_v1.json
Shay 07ad3af845 feat(surface): ADR-0031 — score-decomposition surface (per-axis hedges)
Closes the 'identity hedges are generic' gap.  When IdentityCheck reports
that a specific axis is deviating AND the pack supplies an axis_hedges
entry for that axis, the assembler uses that axis's phrase instead of
ADR-0028's generic preferred_hedge_*.  The hedge text now names what is
actually at issue.

Selection: lex-smallest axis_id in (ctx.deviation_axes ∩ axis_hedges).
Deterministic; loader emits axis_hedges in lex order on axis_id.

Example surface at alignment=0.30 (strong band) under default pack:
  No deviation             → 'It seems that truth reveals reality.'
  truthfulness deviates    → 'Evidence is thin that truth reveals reality.'
  coherence deviates       → 'This does not yet cohere: truth reveals reality.'
  reverence deviates       → 'Reports suggest truth reveals reality.'

Same trajectory + truthfulness deviation, three different packs:
  default_general_v1   → 'Evidence is thin that truth reveals reality.'
  precision_first_v1   → 'The evidence does not support that truth reveals reality.'
  generosity_first_v1  → 'Truth reveals reality.'  (above generosity's strong=0.20)

Schema (additive, optional):
  surface_preferences.axis_hedges = {
    <axis_id>: { 'strong': str, 'soft': str, 'qualifier': str },
    ...
  }

Bounds: each phrase length 1–64; axis_id non-empty.  Absent block →
ADR-0028 byte-for-byte fallback.  Loader emits pairs in lex order on
axis_id for hashability + deterministic tie-break.

Files:
  core/physics/identity.py
    + class AxisHedge (frozen: strong, soft, qualifier)
    SurfacePreferences gains axis_hedges: Tuple = ()
  packs/identity/loader.py
    + _build_axis_hedges(): parse + bounds-check + emit lex-ordered tuple
  generate/surface.py
    SurfaceContext gains deviation_axes: frozenset[str] + axis_hedges tuple
    + _axis_specific_phrase(ctx): lex-smallest match or None
    _apply_hedge consults axis-specific phrase before ADR-0028 fallback
    Depth languages (he, grc) unchanged — ADR-0030 canonical phrases
  chat/runtime.py
    _build_surface_context lifts identity_score.deviation_axes and
    prefs.axis_hedges into SurfaceContext
  packs/identity/*.json
    Three v1 packs gain axis_hedges blocks (truthfulness, coherence,
    reverence — each pack uses voice consistent with its character)
  scripts/ratify_identity_packs.py (no change — idempotent)
  packs/identity/*.mastery_report.json
    Auto-refreshed.  New SHAs:
      default_general_v1   → 2ab7d469013509ba5030313ca9a609a443d0716e3ddcc5596f59858ce054f5d3
      precision_first_v1   → 78aa1e6a68a35c2c8576b6196a52d421b94f6d11e006128986902a4fd08679af
      generosity_first_v1  → 511f1ce20edd4266239da61443bfc93473a5433f20bfee6692a25a03073dc933

Tests: tests/test_identity_score_decomposition.py — 17 new tests:
  per-axis phrase selection, band gating still applies, pack swap with
  same deviation produces three different phrases, lex tie-break is
  deterministic, depth-language fallback to ADR-0030, backward compat
  with empty deviation_axes, and the contract that all three v1 packs
  ship axis_hedges for all three default-pack axes.

Suite status (all green):
  cognition 121, teaching 17, runtime 19, formation 182, smoke 67
  identity+safety+English+depth divergence 71
  score decomposition 17

Scope limits (documented in ADR-0031):
  - English-only at v1 (depth languages use canonical ADR-0030 phrases)
  - Lex tie-break is operational not semantic — pack authors can re-key
    if they need a different priority
  - No dominance-driven phrasing (Interpretation A); preserved as
    forward-compatible follow-up

Docs: ADR-0031 (Accepted) recorded; docs/identity_packs.md gains
§Axis-specific hedge phrases section and updated v1-pack SHAs; memory
'identity-packs.md' refreshed.
2026-05-17 20:16:22 -07:00

74 lines
2.2 KiB
JSON

{
"pack_id": "precision_first_v1",
"version": "1.0.0",
"description": "Precision-first specialization. Boosts truthfulness; narrows coherence and reverence. Source: evals/identity_divergence/axes/axis_a.yaml (semantics, not field-for-field).",
"schema_version": "1.0.0",
"mastery_report_sha256": "78aa1e6a68a35c2c8576b6196a52d421b94f6d11e006128986902a4fd08679af",
"alignment_threshold": 0.55,
"boundary_ids": [
"no_fabricated_source",
"no_hot_path_repair",
"no_overstatement"
],
"surface_preferences": {
"hedge_threshold_strong": 0.55,
"hedge_threshold_soft": 0.7,
"preferred_hedge_strong": "Arguably,",
"preferred_hedge_soft": "In some cases,",
"claim_strength": "qualified",
"qualified_band_high": 0.85,
"preferred_qualifier": "Under certain conditions,",
"axis_hedges": {
"truthfulness": {
"strong": "The evidence does not support that",
"soft": "The evidence is mixed on whether",
"qualifier": "On the available evidence,"
},
"coherence": {
"strong": "This contradicts what is established:",
"soft": "This sits uneasily with what is established:",
"qualifier": "Within the bounds of what coheres,"
},
"reverence": {
"strong": "Source attestation is weak:",
"soft": "Source attestation is partial:",
"qualifier": "On the sources available,"
}
}
},
"value_axes": [
{
"axis_id": "truthfulness",
"name": "truthfulness",
"direction": [
1.0,
0.0,
0.0
],
"weight": 2.0,
"theological_note": "Precision-first: accuracy weighs higher than coverage. Explicit qualification preferred."
},
{
"axis_id": "coherence",
"name": "coherence",
"direction": [
0.0,
0.7,
0.0
],
"weight": 0.7,
"theological_note": "Coherence is necessary but secondary to precision when the two are in tension."
},
{
"axis_id": "reverence",
"name": "reverence",
"direction": [
0.0,
0.0,
0.7
],
"weight": 0.7,
"theological_note": "Reverence narrowed to source-text fidelity; broad inclusivity is not preferred."
}
]
}