core/HANDOFF-gpt55-2026-06-20.md

HANDOFF — GPT-5.5 — 2026-06-20

Agent and Session

• Agent: gpt55
• Date: 2026-06-20
• Reasoning effort used: high
• Grok Build mode used: Headless
• Session entry point: implement the first PR from the semantic-substrate problem-solving master plan: close proportional-decrease contracts and make readiness obligation-sound without touching serving or derivation organs

---

Smoke Suite + Bootstrap Status

Read before editing:
- GPT55.md
- AGENTS.md
- docs/runtime_contracts.md
- HANDOFF-gpt55-2026-06-20.md (prior planning handoff, now superseded by this file)
- ADR-0223 audit/session pack and targeted ProblemFrame files/tests

core test --suite smoke -q
zsh: command not found: core

uv run python -m core.cli test --suite smoke -q
108 passed in 121.54s (0:02:01)

core-bootstrap skill was not available in this session; bootstrap was completed manually.

---

Modules Touched

File	Change type	Summary
generate/problem_frame.py	modified	extended BoundQuestionTarget with typed operator/state/direction validation so delta-decrease targets are structurally representable
generate/problem_frame_builder.py	modified	added narrow decrease_to_fraction binding, copular half-partition strengthening, canonical entity grounding, and richer bound target detection
generate/problem_frame_contracts.py	modified	added assess_fraction_decrease; tightened percent_partition to require forward aggregate topology, original whole provenance, and explicit blocker codes
scripts/gsm8k_problem_frame_adequacy.py	modified	surfaced blocker sets and blocker-combination aggregates by organ
scripts/gsm8k_substrate_morphology.py	modified	surfaced per-organ blockers and kept non-runnable decrease cases on a substrate contract-gap recommendation instead of a serving-organ recommendation
tests/test_problem_frame_builder.py	modified	added proportional-decrease binding/span tests
tests/test_problem_frame_contracts.py	replaced	added positive/negative obligation tests for fraction decrease and percent partition
tests/test_problem_frame_skeleton.py	modified	added BoundQuestionTarget validation coverage
tests/test_gsm8k_problem_frame_adequacy.py	modified	added blocker-by-organ/blocker-combination adequacy coverage
tests/test_gsm8k_morphology_missing_kernel_labels.py	modified	added morphology contract-gap recommendation coverage

---

Invariants Verified (Versor Coherence Guardian + Core)

Invariant	Check performed	Result	Notes
`		F * reverse(F) - 1
versor_apply / cga_inner exactness	Manual sweep of touched files/imports	Preserved	No recall/ranking/operator-path changes
Normalization boundaries respected	Pre-edit sweep + patch review	Preserved	No normalization added outside approved construction/IR boundary
No approximate recall (ANN/HNSW/cosine)	Import/call-site sweep on touched path	Preserved	Diagnostic path remains exact/deterministic
Claim status transitions via review gates only	Scope review	Preserved	Teaching/review/proposal paths untouched
Safety/identity pack immutability	Scope review	Preserved	No pack, manifest, policy, identity, or recall edits
INV-21 / INV-24 / INV-29 (Vault & epistemic)	Scope review + serving parity	Preserved	No memory mutation or serving-path widening
Wrong-zero serving	Direct runner build_report() checks	Preserved	Train 30/20/0, holdout 5/495/0, wrong_ids == []
Readiness truthfulness	Targeted adequacy reruns	Improved	Train runnable 1 -> 2; holdout runnable 1 -> 0; 0393 now blocked

---

Subagent / Arena Reconciliation (if applicable)

• Number of subagents spawned: 0
• Each subagent independently verified versor closure? (Yes/No): N/A
• How were results reconciled before merge? N/A

---

Tests Run

# exit 0
uv run python -m pytest -q \
  tests/test_problem_frame_builder.py \
  tests/test_problem_frame_contracts.py \
  tests/test_gsm8k_problem_frame_adequacy.py \
  tests/test_gsm8k_morphology_missing_kernel_labels.py \
  tests/test_kernel_no_new_legacy_derivation_surfaces.py

# exit 0
uv run python -m pytest -q \
  tests/test_problem_frame_builder.py \
  tests/test_problem_frame_contracts.py \
  tests/test_problem_frame_skeleton.py \
  tests/test_gsm8k_problem_frame_adequacy.py \
  tests/test_gsm8k_morphology_missing_kernel_labels.py \
  tests/test_kernel_no_new_legacy_derivation_surfaces.py

# exit 0
uv run python -m core.cli test --suite smoke -q

# exit 0
uv run python -m scripts.gsm8k_problem_frame_adequacy \
  --cases evals/gsm8k_math/train_sample/v1/cases.jsonl

# exit 0
uv run python -m scripts.gsm8k_problem_frame_adequacy \
  --cases evals/gsm8k_math/holdout_dev/v1/cases.jsonl

# exit 0
uv run python - <<'PY'
from evals.gsm8k_math.train_sample.v1.runner import _CASES_PATH, _load_cases, build_report
r = build_report(_load_cases(_CASES_PATH))
print(r["counts"])
print([x["case_id"] for x in r["per_case"] if x["verdict"] == "wrong"])
PY

# exit 0
uv run python - <<'PY'
from evals.gsm8k_math.holdout_dev.v1.runner import build_report
r = build_report()
print(r["counts"])
print([x["case_id"] for x in r["per_case"] if x["verdict"] == "wrong"])
PY

# exit 0
git diff --check
git status --short
git diff --name-only origin/main...

Key outcomes:

• train adequacy contract_runnable_count == 2
• runnable train cases are gsm8k-train-sample-v1-0005 and gsm8k-train-sample-v1-0046
• holdout adequacy contract_runnable_count == 0
• gsm8k-holdout-dev-v1-0393 now blocks with inverse/original-whole topology reasons
• serving unchanged: train {'correct': 30, 'wrong': 0, 'refused': 20}, holdout {'correct': 5, 'wrong': 0, 'refused': 495}

---

Open Tasks / Next Session Entry Point

1. Inspect whether any non-0046 percent-partition candidates are now worth a narrower contract split instead of accumulating blocker lists on one forward organ.
2. Decide whether the next substrate PR should introduce explicit typed gap records (PF-* codes as first-class data) or keep using stable blocker strings until the construction catalog lands.
3. If a future PR starts typed adapter work, consume fraction_decrease only from ProblemFrame facts and do not reparse raw text inside any adapter or derivation organ.

---

Known Hazards / Do Not Touch

• Do not edit generate/derivation/* or generate/math_candidate_graph.py to “finish” this slice. This PR is diagnostic-only and already proved serving parity.
• The new builder logic is intentionally narrow. Do not generalize decrease_to_fraction into decrease by, percent change, or affine fraction comparison without a separate contract/confuser pack.
• percent_partition is now deliberately stricter. A runnable-count drop elsewhere is acceptable if it removes false readiness; do not loosen obligations to make the number larger.
• HANDOFF-gpt55-2026-06-20.md was replaced; do not rely on the earlier planning-only contents.

---

Architectural Decisions Made This Session

• BoundQuestionTarget now carries typed operator/state/direction, with validation that blocks illegal delta/final combinations at construction time.
• decrease_to_fraction is represented as a span-grounded BoundRelation in ProblemFrame, not as a derivation-organ shortcut.
• Readiness is keyed to exact grounded IDs from the frame. Repeated entity mentions are canonicalized at relation construction so contracts can match by identity rather than lowercase text equality.
• percent_partition requires a forward aggregate target and an original whole bound before subgroup events. Final-state/inverse prompts are blocked rather than treated as forward partition.
• Adequacy and morphology reports now expose blocker combinations by organ, making false readiness auditable without touching serving.

---

What Must Not Be Forgotten

The substantive result of this session is not just “0005 runnable.” It is that runnable now means obligation-closed from ProblemFrame evidence alone: 0005 closes through decrease_to_fraction, 0046 closes only under explicit complementary-subgroup topology, and 0393 is blocked because its target is inverse/original-whole rather than a forward aggregate.

Prompt Library Reference: See docs/core-rd-base-prompts.md (especially sections #7 Standing Loop Axiom Check, #8 PR Merge-Readiness Audit, and #9 Grok Build Implementation Session). Use them as standing prefixes.

---

Skills Used This Session

• core-bootstrap: not available
• versor-coherence-guardian: not available
• pre-edit-sweep: manual import/call-site sweep completed
• claim-proposal-guardian: not needed
• Other: none

---

PR #841 Addendum — feat(kernel): route proportional-decrease through proposal-first seam

Agent and Session

• Agent: gpt55
• Date: 2026-06-20
• Reasoning effort used: high
• Grok Build mode used: Headless
• Session entry point: Migrate only proportional_change.decrease_to_fraction from assessment-backed proposal synthesis to the ADR-0223/0224 proposal-first construction seam without changing serving or derivation.
• Branch: feat/kernel-proportional-decrease-proposal-first
• Base: origin/main at 168c9f26ac3deb8037d4eb7bca77c33dc9d5ff62

Smoke Suite + Bootstrap Status

uv run python -m core.cli test --suite smoke -q
108 passed in 123.41s (baseline)
108 passed in 123.05s (post-edit)

The GPT55.md startup checklist was completed manually. The Codex worktree was clean and HEAD == origin/main before edits. /Users/kaizenpro/Projects/core was not modified, stashed, reset, cleaned, or reconciled.

Modules Touched

File	Change type	Summary
generate/construction_affordances.py	modified	Added a pre-assessment catalog proposal factory; proposals now carry immutable role obligations and enforce diagnostic-only / serving-disallowed posture. Retained the assessment-backed adapter only for unmigrated catalog paths.
generate/problem_frame.py	modified	Let ProblemFrameBuilder accumulate proposals before relation binding.
generate/problem_frame_builder.py	modified	Produces the proportional-decrease proposal from the exact existing surface chunk before mention/relation binding and assessment; preserves assessment-backed traces for other families.
generate/problem_frame_contracts.py	modified	Routes fraction-decrease assessment from proposal metadata read-only while leaving assess_fraction_decrease obligations unchanged.
tests/test_construction_affordances.py	modified	Covers the pre-assessment factory, catalog role obligations, and serving posture.
tests/test_proportional_decrease_proposal.py	modified	Proves proposal-before-assessment order, exact span grounding, proposal-driven dispatch, unchanged contract refusal, and confuser blocking.
HANDOFF-gpt55-2026-06-20.md	modified	Added this PR #841 continuity record.

Invariants Verified

• Field closure: Preserved by construction. No algebra, field, propagation, normalization, vault, or runtime field-state code changed.
• Exact recall: Preserved. No recall path, cosine, ANN, HNSW, or stochastic retrieval was added.
• Proposal/binding/contract separation: The proposal begins as status="proposed"; only ContractAssessment determines runnable/refused state from bound relations and question-target evidence.
• Catalog and serving gates: Proposal role obligations and posture come from the existing catalog; diagnostic_only=True and serving_allowed=False are enforced on the proposal type.
• Controlled migration: Only proportional decrease is proposal-first. Percent partition retains its existing assessment-backed trace; no foundational family gained implementation authorization.
• No universal IR / no live-CGA claim: The patch reuses ConstructionProposal, ProblemFrame, BoundRelation, and ContractAssessment; it adds no new carrier and makes no substrate-retrieval claim.
• Serving parity: Train remained 30 correct / 20 refused / 0 wrong; holdout remained 5 correct / 495 refused / 0 wrong; both wrong-id lists were empty.
• Diagnostic parity: Train remained 2 runnable contracts (0005, 0046); holdout remained 0 runnable contracts.

Subagent / Arena Reconciliation

• Number of subagents spawned: 0
• Each subagent independently verified versor closure: N/A
• Reconciliation: N/A

Tests Run

# exit 0 — 55 passed
uv run python -m pytest -q \
  tests/test_construction_affordances.py \
  tests/test_foundational_families.py \
  tests/test_problem_frame_builder.py \
  tests/test_problem_frame_contracts.py \
  tests/test_proportional_decrease_proposal.py \
  tests/test_kernel_no_new_legacy_derivation_surfaces.py

# exit 0 — 108 passed
uv run python -m core.cli test --suite smoke -q

# exit 0 — serving parity
# train: {'correct': 30, 'wrong': 0, 'refused': 20}; wrong_ids: []
# holdout: {'correct': 5, 'wrong': 0, 'refused': 495}; wrong_ids: []

# exit 0 — diagnostic parity
# train contract_runnable_count: 2; ids: 0005, 0046
# holdout contract_runnable_count: 0

# exit 0
uv run python -m compileall -q \
  generate/construction_affordances.py \
  generate/problem_frame.py \
  generate/problem_frame_builder.py \
  generate/problem_frame_contracts.py

# exit 0
git diff --check

Open Tasks / Next Session Entry Point

1. Review the six implementation/test files and publish PR #841 with the brief's required body sections.
2. Keep percent partition assessment-backed until a separately authorized proposal-first migration.

Known Hazards / Do Not Touch

• Do not map ConstructionProposal.status to fraction assessment output again; that recreates the assessment-first inversion.
• Do not generalize the reused decrease to <fraction> of recognizer into generic state change, acquisition, or transaction behavior.
• Do not connect foundational-family registry metadata to runtime authorization or serving.
• Do not edit derivation, candidate graph, eval cases, reports, packs, policy, identity, recall, field, or algebra for this slice.

Architectural Decision

The proposal is the construction hypothesis, not a cached verdict. It carries the catalog's obligations and exact motivating chunk. BoundRelation grounds those obligations, and the existing ContractAssessment remains the corrective/conjugate stage that closes or refuses the hypothesis. Other families are deliberately left on the legacy assessment-backed adapter to keep this migration singular.

What Must Not Be Forgotten

PR #841 proves the ordering surface chunk → proposed construction → span-grounded relation → ContractAssessment for proportional decrease only. A positive proposal is not serving authorization, is not a runnable verdict, and is not evidence that general CGA/substrate retrieval is live.

Skills Used

• core-bootstrap: unavailable; checklist completed manually
• versor-coherence-guardian: unavailable; closure preserved by scope and smoke validation
• pre-edit-sweep: completed manually across imports, callers, tests, evals, calibration, and scripts
• claim-proposal-guardian: unavailable; proposal posture and assessment separation verified directly
• Other: none

---

PR #836 Addendum — feat(kernel): introduce construction-affordance catalog skeleton

Agent and Session

• Agent: Antigravity (Gemini 3.5 Flash)
• Date: 2026-06-20
• Task: Implement feat(kernel): introduce construction-affordance catalog skeleton (PR #836)
• Branch: feat/kernel-construction-affordance-catalog

Modules Touched / Created

File	Change type	Summary
generate/construction_affordances.py	NEW	Frozen, typed structures (RoleObligation, ConstructionHazard, ConstructionSignature, ConstructionFamily, ConstructionContract, ConstructionProposal) and initial catalog registry with two diagnostic families (proportional_change.decrease_to_fraction and partition.percent_partition).
generate/problem_frame_contracts.py	modified	Added _CONTRACT_REGISTRY mapping candidate organs to ConstructionContract; updated module docstring and refactored assess_contracts() to reference registry metadata.
generate/problem_frame_builder.py	modified	Added detailed docstring to _bound_question_target describing the priority cascade.
tests/test_problem_frame_contracts.py	modified	Added 7 new test cases verifying scale boundary rejection (0, 1, >1), multi-base rejection, state entity continuity, unit continuity, and percent-partition blocker specificity.
tests/test_construction_affordances.py	NEW	Added 5 tests verifying catalog constraints (serving_allowed=False, diagnostic_only=True), deterministic order, accessor lookups, and make_proposal() status mapping.
docs/analysis/pr836-lookback-2026-06-20.md	NEW	Lookback documenting design choices (diagnostic-only registry, separation of registry and dispatch, priority cascade, test gaps closed).

Invariants Verified

• Versor condition: No geometric algebra files were touched; versor invariants remain fully satisfied.
• Serving parity: Verified by running evaluation scripts:
  • Train: 30 correct / 20 refused / 0 wrong (wrong_ids: [])
  • Holdout: 5 correct / 495 refused / 0 wrong (wrong_ids: [])
• Adequacy:
  • Train runnable: 2 (v1-0005 and v1-0046)
  • Holdout runnable: 0

Tests Run

• Targeted suite: tests/test_problem_frame_builder.py, tests/test_problem_frame_contracts.py, tests/test_construction_affordances.py, tests/test_gsm8k_problem_frame_adequacy.py, tests/test_gsm8k_morphology_missing_kernel_labels.py -> 46 passed in 0.48s.
• Smoke suite: core.cli test --suite smoke -q -> 108 passed in 129.00s.

---

PR #837 Addendum — feat(kernel): route proportional-decrease through construction proposals

Agent and Session

• Agent: Antigravity (Gemini 3.5 Flash)
• Date: 2026-06-20
• Task: Implement feat(kernel): route proportional-decrease through construction proposals (PR #837)
• Branch: feat/kernel-decrease-construction-proposal-trace

Modules Touched / Created

File	Change type	Summary
generate/problem_frame.py	modified	Added proposals field (tuple[ConstructionProposal, ...]) to the ProblemFrame dataclass, importing ConstructionProposal under TYPE_CHECKING.
generate/problem_frame_builder.py	modified	Updated build_problem_frame to perform a two-pass assembly: running contract assessments on the initial frame, mapping them to proposals using make_proposal, and returning the frame with proposals attached.
generate/problem_frame_contracts.py	modified	Added `get_contract_family_id(candidate_organ: str) -> str
tests/test_proportional_decrease_proposal.py	NEW	Added 6 new test cases verifying proposal trace existence, evidence spans, catalog backing, diagnostic-only constraints, blocked final-value behavior, and confuser exclusion.
docs/analysis/pr837-lookback-2026-06-20.md	NEW	Lookback documenting PR #837 design rationale, implementation details, and verification results.

Invariants Verified

• Versor condition: No geometric algebra files were touched; versor invariants remain fully satisfied.
• Serving parity:
  • Train: 30 correct / 20 refused / 0 wrong (wrong_ids: [])
  • Holdout: 5 correct / 495 refused / 0 wrong (wrong_ids: [])
• Adequacy:
  • Train runnable: 2 (v1-0005 and v1-0046)
  • Holdout runnable: 0

Tests Run

• Targeted suite: tests/test_proportional_decrease_proposal.py, tests/test_construction_affordances.py, tests/test_problem_frame_builder.py, tests/test_problem_frame_contracts.py, tests/test_gsm8k_problem_frame_adequacy.py, tests/test_gsm8k_morphology_missing_kernel_labels.py, tests/test_kernel_no_new_legacy_derivation_surfaces.py -> 54 passed in 0.66s.
• Smoke suite: core.cli test --suite smoke -q -> Running in background.

---

PR #839 Addendum — docs(substrate): add foundational family specification appendices

Agent and Session

• Agent: Antigravity (Gemini 3.5 Flash)
• Date: 2026-06-20
• Task: Create the foundational family specification appendix structure required by ADR-0224
• Branch: docs/foundational-family-spec-appendices

Modules Touched / Created

File	Change type	Summary
docs/specs/foundational-families/README.md	NEW	README file explaining post-ADR-0224 gating rules, extension of ADR-0223's closeness/bindings/contracts rule, and diagnostic role of benchmarks.
docs/specs/foundational-families/TEMPLATE.md	NEW	Mandatory template section structure for foundational family specifications.
docs/specs/foundational-families/quantity-entity-binding.md	NEW	Constitutional specification for the quantity-entity binding family, featuring cross-domain use cases, required/optional roles, hazards, and refusal conditions.
docs/specs/foundational-families/state-change.md	NEW	Constitutional specification for the state-change family, featuring cross-domain use cases, required/optional roles, hazards, and refusal conditions.
docs/analysis/pr839-lookback-2026-06-20.md	NEW	Lookback documenting design choices, verification details, and alignment with ADR-0224.
HANDOFF-gpt55-2026-06-20.md	modified	Updated with this PR #839 addendum.

Invariants Verified

• Versor condition: No geometric algebra files were touched; versor invariants remain fully satisfied.
• Docs-Only Scope: Verified that all changes are purely documentation additions or comments, with no runtime code or test suite modifications.

---

PR #840 Addendum — feat(kernel): add foundational family registry schema

Agent and Session

• Agent: gpt55
• Date: 2026-06-20
• Reasoning effort used: medium
• Grok Build mode used: Headless
• Session entry point: Implement the typed, read-only foundational-family registry schema for the two #839 specifications without adding recognition, assessment, routing, solving, or serving behavior.
• Branch: feat/kernel-foundational-family-registry-schema
• Base: origin/main at 5cd377b1b8169826ea2406a93136b7615c616286

Smoke Suite + Bootstrap Status

uv run python -m core.cli test --suite smoke -q
108 passed in 123.94s (baseline)
108 passed in 131.98s (post-edit)

core-bootstrap was not available as a skill; the GPT55.md checklist was completed manually. The acknowledged dirty/diverged /Users/kaizenpro/Projects/core main worktree was not modified, stashed, reset, cleaned, or reconciled.

Modules Touched

File	Change type	Summary
generate/foundational_families.py	new	Frozen specification/evidence records, two manually mirrored unauthorized family specs, immutable indices, and public accessors.
tests/test_foundational_families.py	new	Public-API invariant tests for exact registry membership/order, uniqueness, immutability, required fields, cross-domain evidence, authorization gates, and absence of file/Markdown loading.
HANDOFF-gpt55-2026-06-20.md	modified	Added this PR #840 continuity record.

Invariants Verified

• Field closure: Preserved by construction. No algebra, field, propagation, vault, normalization, or runtime field-state path was imported or modified.
• Exact recall: Preserved. No CGA lookup, cosine, ANN, HNSW, or memory path was added.
• Serving and implementation gates: Both families explicitly carry serving_allowed=False and implementation_authorized=False; tests enforce both gates.
• No behavior slice: The module is unreferenced by runtime code and provides descriptive immutable metadata only. No parser, recognizer, adapter, ContractAssessment, routing, derivation, eval, report, or serving behavior was added.
• No live-substrate claim: Module and current-state text explicitly state that general substrate/CGA retrieval is not live for these families.
• No universal IR: The schema mirrors only ADR-0224/#839 specification fields and contains only the two authorized registry entries.
• Determinism: Registry iteration is an explicit immutable tuple; family IDs and primary relation types are unique and tested.

Subagent / Arena Reconciliation

• Number of subagents spawned: 0
• Each subagent independently verified versor closure: N/A
• Reconciliation: N/A

Tests Run

# exit 0 — 13 passed
uv run python -m pytest -q \
  tests/test_foundational_families.py \
  tests/test_construction_affordances.py

# exit 0 — 108 passed
uv run python -m core.cli test --suite smoke -q

# exit 0
python3 -m compileall -q \
  generate/foundational_families.py \
  tests/test_foundational_families.py

# exit 0
git diff --check

Open Tasks / Next Session Entry Point

1. Review and publish PR #840 with the required body sections from the implementation brief.
2. Do not connect this registry to ProblemFrame, ContractAssessment, proposal routing, recognition, adapters, or serving without a separately authorized behavior PR.

Known Hazards / Do Not Touch

• The two #839 specifications are gating artifacts, not implementation authorization.
• Do not parse docs/specs/foundational-families/*.md at runtime.
• Do not add acquisition, transaction, another family, or a universal family IR in this slice.
• The acknowledged local-only state under /Users/kaizenpro/Projects/core remains outside this PR and must not be altered.

Architectural Decision

The foundational registry remains separate from ConstructionFamily. The latter describes live diagnostic construction proposals; this schema mirrors constitutional family gates. Combining them would falsely couple specification completeness to executable assessment machinery and blur current versus target state.

What Must Not Be Forgotten

PR #840 makes the family-spec gate structurally inspectable; it authorizes nothing. Both entries remain non-serving and non-implementable until a separate evidence-backed PR is approved.

Skills Used

• core-bootstrap: unavailable; checklist completed manually
• versor-coherence-guardian: unavailable; closure preserved by scope and smoke validation
• pre-edit-sweep: completed manually across imports/call sites in generate/, tests/, evals/, and calibration/
• claim-proposal-guardian: not needed; no claim or proposal mutation path touched
• Other: none