Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Freeze lexvm-pack/1 with a compatibility promise and a golden-transcript conformance suite

オープン
#59 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
typescript
領域
backend, testing

調査の方向性

Start by reading docs/spec/content-pack.md sections 10 and 16 and Appendix A, then inspect packages/engine/test/ and the existing ADR at docs/adr/0004-yaml-source-json-runtime-zod-schema.md. The issue calls for a new conformance corpus and runner, CI coverage checks, spec/runtime review, a freeze ADR, and compatibility text in the spec and README. Done means the listed acceptance criteria are met, including coverage for every required case and diagnostic codes.

索引モデルが issue の本文から書いたものです。

説明

area: engine priority: high type: feature

Context

v1.0 promises that packs keep working. Some runtime behaviour was decided during implementation and only later written into the spec; without a mechanical check, spec and runtime drift. A conformance suite also allows other engine implementations.

Scope

  • conformance/: small packs, each with command logs and expected results (output blocks and spans as JSON, the final stateKey, view snapshots). At least one case per condition, effect, core verb default, event type, dialogue rule and rejection reason, and for the turn order of spec section 10.
  • A runner in the engine tests and as a script other implementations can use; a CI job.
  • Review the spec against the runtime; every case references the spec section it covers.
  • Compatibility promise in spec section 16 and the README: packs valid under lexvm-pack/1 at v1.0, and lexvm-save/1 saves, keep working in every 1.x engine; only additive changes; a deprecation policy. Diagnostic codes from the code registry (#38) are covered by the same promise.
  • An ADR for the freeze.

Acceptance criteria

  • The suite covers every condition, effect, core verb default and event; CI checks the coverage list.
  • Discrepancies between spec and runtime found by the review are fixed.
  • The freeze ADR is accepted and the spec status changes from "normative for LexVM 0.x" to frozen.
  • The compatibility promise, including diagnostic codes, is in spec section 16 and the README.

References

  • docs/spec/content-pack.md (sections 10 and 16, Appendix A)
  • packages/engine/test/
  • CHANGELOG.md
  • docs/adr/0004-yaml-source-json-runtime-zod-schema.md
主要言語
TypeScript
スター
0
フォーク
0
平均マージ
28分
マージ済み PR(30日)
2

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

nullthrone/lexvm のほかの issue

nullthrone/lexvm の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。