2026-06-13.221525

Summary

Public surface refresh + W0 version model hardening.

README: New hero tagline (EN: "Resumable AI coding — ask first, plans stay with the repo" / CN: "可恢复的 AI 编程 — 先问再写，方案跟着项目走"), "how it works" body paragraph, host compatibility badges, for-the-badge shield style.

Illustrations: 3 bilingual scene images (ask / cross-host / decision), 2 product-form release SVGs, architecture SVG regenerated.

Installer (W0): Fail-loud version handling — 3 silent 0.0.0-dev fallbacks replaced with InstallError; 4-state inspection classifier with status/doctor rendering; bootstrap workspace stale-pin diagnostics.

Protocol check: Continuation semantics fix for handoff pointer handling.

Host Support

• Codex / Claude / Qoder: PROTOCOL_VERIFIED
• Copilot: BASELINE_SUPPORTED (verification planned for W1a)

Scope

This is a public surface refresh + W0 version model hardening release. W1a four-host verification, W2 Copilot uplift, and W4 tooling decision remain on the P9 branch for subsequent releases.

2026-06-10.191940

P8: Protocol Kernel & Runtime Retirement

Summary

P8 retires the Sopify runtime and establishes the protocol kernel as the sole truth source.

• Runtime deleted: 46 files / ~15.6K LOC removed; protocol kernel (sopify_writer + sopify_contracts + protocol.md) is now the sole truth source
• Canonical root: .sopify-skills → .sopify (~481 replacements); plan.directory configurable root removed
• State model: 6 files + sessions/ → 2 files (active_plan.json + current_handoff.json), both gitignored
• Host support: Qoder added as PROTOCOL_VERIFIED host; DEEP_VERIFIED → PROTOCOL_VERIFIED for Codex/Claude
• Product positioning: "开发过程协议层" — 4-layer model (用户层/产品层/能力层/架构层)
• Authorization: EAR/gate_receipt retired; audit chain → receipts/*.json + history/receipt.md
• Blueprint: Full narrative sync (design.md, protocol.md, ADR-013/017, tasks.md)
• Docs: README pair + architecture SVG + how-sopify-works fully aligned to post-P8

Install

curl -fsSL https://github.com/evidentloop/sopify/releases/latest/download/install.sh | bash -s -- --target codex:en-US

Or download install.sh / install.ps1 from this release.

Net Impact

• LOC: ~27,500 net reduction
• Commits: 30 (Phase 0 → W3.6 → Finalize)
• Tests: 181 passed, 26 subtests passed

2026-05-31.142150 — Pre-launch Consolidation

Highlights

• README rewrite (PR #50): Complete English + Chinese README pair rewrite for pre-launch
• Diagram migration (PR #51): JPG → SVG/PNG, image compression (6.6MB → 437KB), CI fixes
• Golden snapshot auto-fix (PR #53): Extracted standalone regeneration script + pre-commit auto-stage
• Output contract upgrade (PR #54): Density gradient, symbol discipline, desensitization self-check

Install

curl -fsSL https://github.com/evidentloop/sopify/releases/latest/download/install.sh | bash -s -- --target codex

See README for all hosts and options.

2026-05-28.044700

Highlights

• Stale stub diagnostics (PR #49): enriched error messages when workspace stub version mismatches installed bundle
• reason_code cleanup (PR #49): removed internal reason_code field from user-facing develop output templates; added human-readable 说明/Note column
• Output contract enforcement (PR #48): added output-contract.md as authoritative output format reference for all skill stages

Changes

• installer/bootstrap_workspace.py: _stale_stub_diagnostic() helper
• installer/inspection.py: enriched _workspace_bundle_recommendation
• runtime/gate_output.py: neutral hint for bundle missing scenarios
• 6 develop output templates (ZH+EN): removed reason_code, added Note column
• output-contract.md + develop-rules.md (ZH+EN): clarified reason_code is internal-only
• 2 new unit tests for stale stub diagnostic
• Blueprint tasks: added renderer scope audit backlog

2026-05-27.220559

What's Changed

Skill Writing Quality Convergence

• Shared Writing DNA: 6 foundational rules (ZH+EN) at sopify/references/shared-writing-dna.md
• Output Template v2: Verification summary tables with reason_code, review evidence, and root_cause (optional)
• Status Symbol Constraint: `✓
• Philosophy Lines: One-line core principle added to analyze/design/develop SKILL.md
• human_action_required: 5th root_cause value for actions AI cannot perform
• Render Pipeline Fix: render_single_file() now inlines top-level references/ directory
• ASCII Logo: install.sh now displays the Sopify banner on install

Host Bundle Unification Closeout

• runtime_bundle → sopify_bundle rename
• Copilot workspace-scope installer converged into unified registry
• Golden snapshot protection (8 test cases, all hosts × all languages)

Release Assets

• install.sh — Unix/macOS installer (with ASCII logo)
• install.ps1 — Windows PowerShell installer

Plan Packages Archived

• 20260526_pre_launch_host_and_bundle_unification
• 20260527_skill_writing_quality

Full Changelog: 2026-05-26.134110...2026-05-27.220559

2026-05-26.134110 — Runtime Slimming Closeout

Runtime Slimming 完整收口

核心变更

• Runtime 精简：删除已退役模块（decision_bridge, develop_callback, failure_recovery, skill_registry, context_v1_scope 等），engine.py 聚焦核心编排
• 架构拆分：编排逻辑提取为 _orchestration.py；plan_scaffold.py 拆分为 runtime/plan/ 包
• 测试重建：新增 orchestration / plan_intent / plan_lookup 直接测试
• Smoke 稳态化：清理 legacy 断言，Python smokes 加入 CI
• CI 简化：移除 PR body metadata check，简化贡献流程
• 归档：runtime_slimming plan 完整归档至 history/

Commits

• #44 runtime slimming closeout — smoke stabilization + docs + L3 archive
• #43 rename → _orchestration.py + docstring polish (4.12)
• #42 add kernel turn direct tests (4.11)
• #41 split plan_scaffold.py into runtime/plan/ package (4.10b)
• #40 fix smoke stub assertion
• #39 remove workspace stub assertion from runtime smoke
• #38 runtime bundle rewrite + handoff semantic fix + test cleanup (4.13-B)

2026-05-22.062718 — Braille Spinner + Clean Erase

What's New

• Braille spinner (⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏) for download/unpack phases in install.sh
• Clean erase on success: all spinner lines removed via ANSI cursor-up + clear, leaving only logo + result
• isatty-gated: falls back to plain log output when piped
• Previous release changes: unified install.sh --target copilot entrypoint, logo display, multi-host workspace_kind preservation

Assets

File	Purpose
install.sh	Universal installer (Linux / macOS)
install.ps1	Universal installer (Windows)
bootstrap.sh	Compatibility alias → install.sh --target copilot

2026-05-22.034140 — Payload-Only Onboarding + Canonical Writer + Contract Shrinkage

Summary

P4d → P5 → P6 → P7 milestone release. Major additions: external-repo one-click onboarding, canonical writer architecture, contract surface governance.

Highlights

• P7 Payload-Only Onboarding Mainline

  • sopify_init.py: standalone workspace initializer with ANSI Shadow logo
  • bootstrap.sh: one-line bootstrap for external repos
  • docs/getting-started.md: unified onboarding guide
  • Copilot instruction distribution (managed block + owned file)
  • README Setup Paths routing table; Copilot Adapter in architecture SVG

• P6 Canonical Writer Cutover

  • sopify_contracts module extracted (runtime models decoupled)
  • StateStore extracted into canonical_writer
  • Non-runtime state imports migrated

• P5 Contract Surface Shrinkage

  • 58 sub-surface adjudications (10 cross-tier / 1 candidate-kernel / 46 deep-only / 1 deleted)
  • Shadow Writer gap analysis conclusion B
  • Runtime retirement roadmap committed to blueprint
  • Dead code removal (8 LOC)

• P4d Copilot CLI Pilot

  • First non-deep host verified (payload_capable + CONTINUATION)
  • Repo-local pilot, pure prompt asset consumption

Quality

• 740 tests passed, 1 pre-existing failure (payload bundle version mismatch)
• 12 new smoke tests for sopify_init
• 3 rounds of cross-review on P7

Archive Consistency

• Fixed 4 stale lifecycle_state: active in history/
• Eliminated plan/ ↔ history/ dual-residency
• New convention: plan/ originals deleted after archive

Assets

• install.sh — stable channel installer (Unix)
• install.ps1 — stable channel installer (Windows)
• bootstrap.sh — stable channel one-line bootstrap

2026-05-13.111757

Summary

• YAML block scalar support + installer bundle smoke isolation
• README architecture diagram (simplified, centered SVG)
• Blueprint First-Use Adoption Proof criteria expansion

Changed

• Runtime: Add block scalar parsing (|, |-, >, >-) to built-in YAML parser; external skill front-matter parse errors degrade gracefully (fail-closed for builtin, tolerant for user)
• Installer: Isolate bundle smoke HOME to prevent user-level skills from interfering with validation
• Docs: Add simplified architecture SVG to README (EN + CN); expand Adoption Proof deliverables; add Release pipeline + test health baseline to process items
• Tests: Block scalar, skill registry tolerance, installer isolation coverage (+75 lines)

2026-05-11.202509

Summary

P4c Host Consumption Governance release.

This release converges Sopify host-facing consumption surfaces so Codex/Claude prompts, runtime output, status, and doctor views consume canonical
protocol and handoff facts instead of exposing internal route taxonomy, helper wiring, or blueprint implementation details.

Highlights

• Added protocol.md §8 as the authoritative host-consumption contract.
• Reduced Codex/Claude prompt assets to stable protocol references and user-facing workflow semantics.
• Converged runtime output around handoff/protocol facts:
  • loaded files render as Context
  • route fields are no longer exposed in user-facing output
  • gate status fallback is stable
  • status symbols and Next hints map through handoff semantics
• Improved status/doctor output:
  • raw taxonomy codes are replaced with human-facing labels
  • checkpoint/state-conflict wording is clearer
• Added host enhancement declarations for:
  • continuation
  • interaction
  • audit
• Added validation script:
  • scripts/check-enhancement-declaration.py
• Expanded automated coverage for output rendering, installer status, and doctor contracts.

Plan / Blueprint References

• Archived plan:
  • .sopify-skills/history/2026-05/20260510_p4c_host_consumption_governance/
• Blueprint updates:
  • .sopify-skills/blueprint/protocol.md
  • .sopify-skills/blueprint/design.md
  • .sopify-skills/blueprint/tasks.md
  • .sopify-skills/history/index.md

Verification

Release preflight passed locally with Python 3.14:

PATH=/opt/homebrew/opt/python@3.14/bin:$PATH bash scripts/release-preflight.sh

Results:

- hard gate: 686 passed
- implementation-mirror tests: 31 passed
- install/payload bootstrap smoke: passed
- prompt runtime gate smoke: passed
- bundle runtime smoke: passed
- skill eval gate: passed

## Assets

Upload the rendered stable release assets, not the repository root installer files:

- install.sh
- install.ps1