Skip to content

[codex] docs: tighten support boundary truth parity#183

Merged
Halildeu merged 3 commits intomainfrom
codex/wp1-docs-truth-patch
Apr 21, 2026
Merged

[codex] docs: tighten support boundary truth parity#183
Halildeu merged 3 commits intomainfrom
codex/wp1-docs-truth-patch

Conversation

@Halildeu
Copy link
Copy Markdown
Owner

Özet

Bu PR, WP-1 truth patch kapsamında ao-kernel'in destek sınırını dokümanlarda mevcut runtime gerçeğine hizalar.

Ana değişiklikler:

  • README ve PUBLIC-BETA, repo'yu blanket bir "production coding automation platform" gibi sunmak yerine dar destekli yüzeyi açıkça ayırıyor.
  • Adapter, benchmark ve operator runbook dokümanları artık shipped demo ile operator/evaluation surface ayrımını açık yazıyor.
  • Eski çok-adımlı demo referansları canlı destek yüzeyi gibi görünmeyecek şekilde PUBLIC-BETA ve roadmap/spec ayrımına taşındı.
  • examples/demo_review.py için önemli kullanım kontratı netleştirildi: komut, ao-kernel kurulu bir Python environment'ında çalıştırılmalı.

Neden

Repo ağacında çok sayıda contract/reference artifact bulunuyor. Bu durum operator veya son kullanıcı için iki yanlış izlenim üretiyordu:

  • ağaçta görünen her manifest/extension/example production-ready destekli yüzeymiş gibi algılanabiliyordu
  • benchmark/runbook/spec dokümanları ile canlı shipped demo yüzeyi birbirine karışıyordu

Bu drift, özellikle "ne gerçekten destekleniyor" ve "hangi komut son kullanıcı için güvenilir" sorularında yanlış güven üretiyordu.

Kullanıcı etkisi

Bu PR runtime davranışını değiştirmez. Etki tamamen doğruluk ve beklenti yönetimi üzerinedir:

  • son kullanıcı daha dar ama doğru bir destek sınırı görür
  • operator, benchmark ve real-adapter dokümanlarını default ürün yüzeyi ile karıştırmaz
  • inventory/contract layer ile shipped support matrix daha net ayrılır

Doğrulama

Çalıştırılan kontroller:

  • python3 -m pytest tests/test_cli_entrypoints.py tests/test_evidence_cli.py tests/test_executor_policy_rollout_v311_p2.py -q
  • python3 scripts/packaging_smoke.py

Önemli doğrulama notu:

  • checkout içinden doğrudan python3 examples/demo_review.py --cleanup çalıştırıldığında, global shell environment bu makinede ao-kernel==3.13.1 gösterdiği için alt subprocess python -m ao_kernel init adımında drift sinyali verdi
  • packaging smoke içindeki clean wheel install doğrulamasında ise ao-kernel 4.0.0b1 entrypointleri ve examples/demo_review.py --cleanup başarılı şekilde geçti
  • bu nedenle PR, desteklenen kullanım yolunu açıkça "kurulu environment" olarak belgeledi

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 21, 2026

📊 Benchmark Scorecard

Scenario Status Duration Cost (USD) Review Score
governed_bugfix ✅ pass 44ms (▲7.3%) $0.0000 —
governed_review ✅ pass 44ms (▲4.8%) $0.0000 — 0.85 (−)

Baseline: 701614a62c15d08ea952bf7f2859b6c46c25756d · HEAD: a6cabbd0405fc52beb3050ceb43228e0605bf8f7 · PR: #183 · No regressions.

@Halildeu Halildeu marked this pull request as ready for review April 21, 2026 17:29
@Halildeu Halildeu merged commit 78dd453 into main Apr 21, 2026
10 checks passed
@Halildeu Halildeu deleted the codex/wp1-docs-truth-patch branch April 21, 2026 17:31
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