# Changelog

All notable changes to Sopify are documented in this file.

Format: Summary → Changed → Plan Packages. File-level details live in `git log`.

## [Unreleased]

## [2026-05-21.101226] - 2026-05-21

### Summary

- Updated 1 active plan package(s); Changes across: Docs, Runtime, Skills, Tests, Changed.

### Changed

- **Docs**: Refined public documentation (2 files)
- **Runtime**: Updated runtime internals (21 files)
- **Skills**: Synced prompt-layer skills (4 files)
- **Tests**: Updated automated coverage (1 files)
- **Changed**: Updated project files (1 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-21.100824] - 2026-05-21

### Summary

- Updated 1 active plan package(s); Changes across: Runtime, Tests, Changed.

### Changed

- **Runtime**: Updated runtime internals (21 files)
- **Tests**: Updated automated coverage (1 files)
- **Changed**: Updated project files (1 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-20.221259] - 2026-05-20

### Summary

- Updated 1 active plan package(s); Changes across: Scripts, Tests, Changed.

### Changed

- **Scripts**: Adjusted maintenance scripts (2 files)
- **Tests**: Updated automated coverage (3 files)
- **Changed**: Updated project files (2 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-20.215230] - 2026-05-20

### Summary

- Updated 1 active plan package(s); Changes across: Docs, Runtime, Scripts, Skills, Tests, Changed.

### Changed

- **Docs**: Refined public documentation (2 files)
- **Runtime**: Updated runtime internals (4 files)
- **Scripts**: Adjusted maintenance scripts (2 files)
- **Skills**: Synced prompt-layer skills (4 files)
- **Tests**: Updated automated coverage (2 files)
- **Changed**: Updated project files (10 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-20.214859] - 2026-05-20

### Summary

- Updated 1 active plan package(s); Changes across: Runtime, Scripts, Tests, Changed.

### Changed

- **Runtime**: Updated runtime internals (4 files)
- **Scripts**: Adjusted maintenance scripts (2 files)
- **Tests**: Updated automated coverage (2 files)
- **Changed**: Updated project files (10 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-20.191545] - 2026-05-20

### Summary

- Updated 1 active plan package(s); Changes across: Runtime, Scripts, Tests, Changed.

### Changed

- **Runtime**: Updated runtime internals (7 files)
- **Scripts**: Adjusted maintenance scripts (2 files)
- **Tests**: Updated automated coverage (4 files)
- **Changed**: Updated project files (10 files)

### Plan Packages

- `20260520_p6_canonical_writer_cutover` (active)

## [2026-05-20.143728] - 2026-05-20

### Summary

- Archived 1 plan package(s); Changes across: Docs, Runtime, Skills, Tests.

### Changed

- **Docs**: Refined public documentation (2 files)
- **Runtime**: Updated runtime internals (1 files)
- **Skills**: Synced prompt-layer skills (4 files)
- **Tests**: Updated automated coverage (4 files)

### Plan Packages

- `20260520_p5_contract_surface_shrinkage` (archived)

## [2026-05-20.143147] - 2026-05-20

### Summary

- Archived 1 plan package(s); Changes across: Docs, Runtime, Skills.

### Changed

- **Docs**: Refined public documentation (2 files)
- **Runtime**: Updated runtime internals (1 files)
- **Skills**: Synced prompt-layer skills (4 files)

### Plan Packages

- `20260520_p5_contract_surface_shrinkage` (archived)

## [2026-05-20.142600] - 2026-05-20

### Summary

- Archived 1 plan package(s); Changes across: Runtime.

### Changed

- **Runtime**: Updated runtime internals (1 files)

### Plan Packages

- `20260520_p5_contract_surface_shrinkage` (archived)

## [2026-05-19.183358] - 2026-05-19

### Summary

- Updated 1 active plan package(s); Changes across: Docs, Scripts, Skills, Changed.

### Changed

- **Docs**: Refined public documentation (4 files)
- **Scripts**: Adjusted maintenance scripts (1 files)
- **Skills**: Synced prompt-layer skills (4 files)
- **Changed**: Updated project files (12 files)

## [2026-05-19.180220] - 2026-05-19

### Summary

- Changes across: Docs, Changed.

### Changed

- **Docs**: Refined public documentation (1 files)
- **Changed**: Updated project files (1 files)

## [2026-05-19.174031] - 2026-05-19

### Summary

- Updated 1 active plan package(s); Changes across: Docs, Scripts, Changed.

### Changed

- **Docs**: Refined public documentation (4 files)
- **Scripts**: Adjusted maintenance scripts (1 files)
- **Changed**: Updated project files (12 files)

## [2026-05-13.111757] - 2026-05-13

### Summary

- Changes across: Runtime, Tests, Changed.

### Changed

- **Runtime**: Updated runtime internals (2 files)
- **Tests**: Updated automated coverage (3 files)
- **Changed**: Updated project files (1 files)

## [2026-05-11.202509] - 2026-05-11

### Summary

- P4c Host Consumption Governance delivered: host-facing prompt/runtime surfaces now consume canonical protocol facts instead of exposing route taxonomy, blueprint concepts, or internal helper details.
- Changes across: Docs, Runtime, Scripts, Skills, Tests.

### Changed

- **Docs**: Added protocol §8 as the host-consumption authority and refreshed blueprint/history bookkeeping.
- **Runtime**: Converged output, gate status fallback, Next hints, and status/doctor text around handoff/protocol facts.
- **Scripts**: Added enhancement declaration validation for host capability metadata.
- **Skills**: Reduced Codex/Claude prompt assets to protocol references and user-facing workflow semantics.
- **Tests**: Added rendering/status/doctor coverage for de-taxonomy and host-facing labels.

### Plan Packages

- `20260510_p4c_host_consumption_governance` (archived)

## [2026-05-09.175537] - 2026-05-09

### Summary

- Archived 1 plan package(s); Changes across: Docs, Runtime, Skills.

### Changed

- **Docs**: Refined public documentation (2 files)
- **Runtime**: Updated runtime internals (2 files)
- **Skills**: Synced prompt-layer skills (4 files)

### Plan Packages

- `20260509_p4b_runtime_surface_consolidation` (archived)

## [2026-05-09.170825] - 2026-05-09

### Summary

- Archived 1 plan package(s); Changes across: Runtime.

### Changed

- **Runtime**: Updated runtime internals (2 files)

### Plan Packages

- `20260509_p4b_runtime_surface_consolidation` (archived)

## [2026-05-09.152019] - 2026-05-09

### Summary

- Updated 1 active plan package(s); Changes across: Scripts, Changed.

### Changed

- **Scripts**: Adjusted maintenance scripts (1 files)
- **Changed**: Updated project files (1 files)

### Plan Packages

- `20260509_p4b_runtime_surface_consolidation` (active)

## [2026-05-08.191000] - 2026-05-08

### Summary

- Archived 1 plan package(s); Changes across: Skills, Tests.

### Changed

- **Skills**: Synced prompt-layer skills (12 files)
- **Tests**: Updated automated coverage (1 files)

### Plan Packages

- `20260508_p3b_perimeter_cleanup` (archived)

## [2026-05-07.220011] - 2026-05-07

### Summary

P3a Contract-Aligned Surface Cleanup delivered in full. Execution routing convergence, cancel_scope fix, knowledge_sync audit trail, dead path cleanup (-88 LOC), blueprint milestone compression + P4b split-out.

### Changed

- **Execution routing convergence**: authorized ActionProposal → deterministic route derive (`_derive_route_from_authorized_proposal`); Router.classify demoted to bare-text legacy fallback
- **cancel_scope fix**: cancel_flow inlined in derive path, fixing default-to-global-cleanup bug when artifacts list is empty
- **knowledge_sync audit trail**: `knowledge_sync_result` threaded through full archive pipeline (success / blocked / archive_target_conflict)
- **Dead code removal**: removed 6 unreferenced private functions + 1 orphan constant (-88 LOC)
- **Test coverage**: +17 routing convergence tests, +2 archive knowledge_sync tests, classify exclusion + checkpoint split coverage filled
- **Blueprint restructure**: P0–P3a compressed to one-line summaries; runtime weight reduction split out as P4b (runtime_surface_consolidation)

### Plan Packages

- `20260507_p3a_contract_aligned_surface_cleanup` (archived)

---

## Historical Entries (compressed)

The 102 auto-generated entries below (2026-01-15 to 2026-05-07) have been compressed into phase summaries. Full file-level detail is preserved in `git log`.

### P3a Development Iterations (2026-05-03 – 2026-05-07)

25 releases. Contract-aligned surface cleanup development:

- Execution routing → ActionProposal-based derive pipeline
- cancel_scope hardening and fail-close contract enforcement
- knowledge_sync audit trail through archive lifecycle
- Deterministic guard, signal priority, failure recovery tables
- Fail-close contract fixture + eval entries
- Plan: `20260507_p3a_contract_aligned_surface_cleanup`

### P2 Local Action Contracts (2026-05-01 – 2026-05-02)

8 releases. Action intent and proposal authorization:

- ActionIntent model + gate integration
- Action proposal / rejection / authorization flow
- Direct-edit runtime guard with entry_guard_reason_code
- Plan: `20260506_p2_local_action_contracts`

### P1.5 Authorization & Plan Materialization (2026-04-27 – 2026-04-29)

6 releases. Checkpoint-gated plan writes and rejection surface:

- Plan materialization auth (checkpoint-gated plan writes)
- Reject surface (proposal_rejected route + host action)
- Advance slices (multi-slice plan orchestration)
- Plans: `20260506_p15_authorization_contract_spec`, `20260506_p15_reject_surface`, `20260505_p15_plan_materialization_auth`, `20260505_p15_advance_slices`

### P1 Runtime System Build-Out (2026-03-19 – 2026-04-14)

42 releases. Core runtime construction:

- Engine, router, gate, handoff, output pipeline
- Checkpoint system (clarification + decision)
- Develop callback + quality loop
- Skill resolver + builtin catalog + runtime skill execution
- KB bootstrap + blueprint scaffold
- Plan registry + plan scaffold + archive lifecycle
- State store (session-scoped review isolation)
- Bundle manifest + install/payload bootstrap
- Convention smoke test (`20260501_convention_smoke`)
- Prompt-layer skills (Codex/Claude CN/EN)

### Foundation (2026-02-13)

- Skill sync scripts (`sync-skills.sh`, `check-skills-sync.sh`)
- Sub-skill `workflow-learning` for replay/review (sunset in P3b)
- User preference layer (`preferences.md`, `feedback.jsonl`)
- Config: `workflow.learning.auto_capture` (sunset in P3b)
- Title color behavior, branding semantics clarification

### Initial Release (2026-01-15)

- Initial version (ruleset and skill structure).
