Skip to content

feat(infra): hex を作る Lambda に構文木(Studuino IR)の検査と C++ の書き出しを足す #2210

Open

Description

@smalruby3-editor-bot

なにをするか

hex を作る Lambda に、構文木(Studuino IR)の検査と C++ への書き出しを足す(🧱 infra)。ブラウザが送った構文木を JSON スキーマで厳密に検査し、op ごとの表で C++ に書き出してコンパイルし、hex を返す。

#2162 を待たずに進めてよい(M8 = A)。#2209(Lambda の土台)のあと。スキーマと書き出しの表は #2208 の docs が正(docs より先に進めるときは、#2163 の本文の API の要約と設計ページの構文木の案から始め、docs と合わせる)。

守ること(infra-first)

  • 後方互換な変更だけ。PR は develop 宛て、本文は Refs #2210。
  • cdk deploy は AI がしない(stg は deploy-stg ラベル)。

決まったこと(#2163 の本文が正)

  • M1 = B・S8 = A: 構文木 → C++ は Lambda で。知らない op・知らないポート・知らない部品は 400 で拒否。ユーザーの文字列は C++ に入らない(変数・関数の名前は IR の ID v0 p0 などだけを使う)。
  • S6 = A: 型は数値(double)と真偽(bool)だけ。
  • S1 = B: 第 1 弾の op は、制御(待つ・〜回・ずっと・もし・もし〜でなければ・〜まで待つ・〜まで繰り返す)、演算(四則・余り・四捨五入・乱数・比べる・かつ/または/ではない)、変数(数値の set / change)、タイマー・タイマーのリセット、部品(DC モーターの速さ・向き・止める、サーボ 1 つ・まとめて、LED、ブザー、各センサー、ボタン)。リスト・関数は第 2 弾。
  • S12 = C: 構文木 128KB・ノード 10,000 個・深さ 100 を超えたら拒否(数字は変えられるように)。拒否の理由は計測のログに出す。
  • C++ の形: Studuino board;、setup() でポートの初期化と補正値、本体は loop() を隠した逐次実行(「旗が押されたとき」1 つ)。ポートの定数は種類ごとに番号が重なる(PORT_D9 = PORT_M1 = PORT_A0 = 0)ので、ポート名 → 定数名の表で書き出す。タッチ・ボタンは 0 が「押した」なので真偽にするとき反転する。タイマーは millis() で作る。
  • 生成した C++ をレスポンスに含めるか(GPL のソースの入手方法のため。epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163 の S7 の注意 1)は、アーテック社の回答(chore(studuino-mode): 【人間の作業】Studuino ライブラリのライセンスと使い方をアーテック社に確認する #2211)を見て決める。含められるように作っておく。

テスト

  • スキーマ検査と書き出しは純粋関数にして単体テスト(op ごとの表のテスト、拒否のテスト、注入を試す入力のテスト)。その infra プロジェクトの jest。関係するファイルだけ。
  • stg で、いくつかの構文木から hex が返ることを確かめる(実機での確かめは GUI の書きこみの sub-issue で)。

DoD

  • 第 1 弾の op がすべて C++ に書き出せ、コンパイルできる。知らない op などは 400。
  • docs(docs/studuino-mode/)のスキーマ・表と実装が一致している。

親 EPIC: #2163 。

Metadata

Metadata

Assignees

No one assigned

    Labels

    🧱 infrainfra だけの Issue(後方互換のみ・develop へ先行マージ。prod デプロイ後に workflow が閉じる)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions