nadesiko3 3.7.21 → 3.7.23

package/core/test/plugin_system_debug_test.mjs

@@ -0,0 +1,138 @@
+/* eslint-disable no-undef */
+/**
+ * plugin_system_debug.mts のテスト (#2351)
+ *
+ * plugin_system.mts から分割した「特殊命令」「デバッグ支援」「プラグイン管理」の
+ * 命令が、分割後も plugin_system の一部として正しく動作することを確認する。
+ */
+import { describe, it } from 'node:test'
+import assert from 'assert'
+import { NakoCompiler } from '../src/nako3.mjs'
+import PluginSystem from '../src/plugin_system.mjs'
+import PluginSystemDebug from '../src/plugin_system_debug.mjs'
+
+describe('plugin_system_debug_test', async () => {
+  const cmp = async (/** @type {string} */ code, /** @type {string} */ res) => {
+    const nako = new NakoCompiler()
+    nako.getLogger().debug('code=' + code)
+    const g = await nako.runAsync(code, 'main.nako3')
+    assert.strictEqual(g.log, res)
+  }
+
+  // --- 分割ファイルの構造 ---
+  it('分割ファイルはメタ情報や初期化を持たない', async () => {
+    assert.strictEqual(PluginSystemDebug.meta, undefined)
+    assert.strictEqual(PluginSystemDebug['初期化'], undefined)
+    assert.strictEqual(PluginSystemDebug['!クリア'], undefined)
+  })
+  it('分割ファイルの命令が plugin_system にマージされている', async () => {
+    for (const key of Object.keys(PluginSystemDebug)) {
+      assert.strictEqual(PluginSystem[key], PluginSystemDebug[key], `『${key}』がマージされていません`)
+    }
+  })
+  it('分割してもプラグインは plugin_system のまま', async () => {
+    assert.strictEqual(PluginSystem.meta.value.pluginName, 'plugin_system')
+    await cmp('プラグイン一覧取得して「:」で配列結合して表示', 'plugin_system:plugin_math:plugin_promise:plugin_test:plugin_csv:plugin_toml')
+  })
+
+  // --- 特殊命令 ---
+  it('特殊命令 - JS実行', async () => {
+    await cmp('「3*7」をJS実行して表示', '21')
+  })
+  it('特殊命令 - JS関数実行', async () => {
+    await cmp('「Math.max」を[3,9,5]でJS関数実行して表示', '9')
+  })
+  it('特殊命令 - JSメソッド実行', async () => {
+    await cmp('「[1,2,3]」の「join」を[「-」]でJSメソッド実行して表示', '1-2-3')
+  })
+  it('特殊命令 - JSオブジェクト取得', async () => {
+    await cmp('A=5;「A」のJSオブジェクト取得して表示', '5')
+  })
+  it('特殊命令 - 実行', async () => {
+    await cmp('F=関数()\n「呼ばれた」を表示\nここまで\nFを実行', '呼ばれた')
+    await cmp('●テスト関数とは\n「OK」を表示\nここまで\n「テスト関数」を実行', 'OK')
+    // 関数でも文字列(関数名)でもない値はそのまま返る (#938)
+    await cmp('123を実行して表示', '123')
+  })
+  it('特殊命令 - 実行時間計測', async () => {
+    await cmp('F=関数()\nそれは1\nここまで\nFの実行時間計測;もし、(それ>=0)ならば「OK」を表示', 'OK')
+  })
+  it('特殊命令 - AWAIT実行', async () => {
+    const nako = new NakoCompiler()
+    const code = 'F=「a=>a*2」をJS実行\nFを[21]でAWAIT実行して表示'
+    const g = await nako.runAsync(code, 'main.nako3')
+    assert.strictEqual(g.log, '42')
+  })
+  it('特殊命令 - AWAIT実行（配列以外の引数）', async () => {
+    const nako = new NakoCompiler()
+    const code = 'F=「a=>a*2」をJS実行\nFを21でAWAIT実行して表示'
+    const g = await nako.runAsync(code, 'main.nako3')
+    assert.strictEqual(g.log, '42')
+  })
+  it('特殊命令 - ナデシコ', async () => {
+    await cmp('『「なでしこ」を表示』をナデシコ', 'なでしこ')
+  })
+
+  // --- デバッグ支援 ---
+  it('デバッグ支援 - デバッグ表示', async () => {
+    const nako = new NakoCompiler()
+    const g = await nako.runAsync('「メッセージ」をデバッグ表示', 'main.nako3')
+    // 「ファイル名(行番号): メッセージ」の形式で出力される
+    assert.ok(g.log.indexOf('メッセージ') >= 0, `想定外の出力: ${g.log}`)
+    assert.ok(g.log.indexOf('main.nako3') >= 0, `想定外の出力: ${g.log}`)
+  })
+  it('デバッグ支援 - ハテナ関数設定と実行', async () => {
+    await cmp('「表示」をハテナ関数設定; ?? 2*5', '10')
+    await cmp('["JSON_E","表示"]をハテナ関数設定; ?? [1,2]', '[1,2]')
+  })
+  it('デバッグ支援 - エラー発生', async () => {
+    const nako = new NakoCompiler()
+    try {
+      await nako.runAsync('「わざとエラー」のエラー発生', 'main.nako3')
+    } catch (err) {
+      assert.ok(String(err.message).indexOf('わざとエラー') >= 0)
+      return
+    }
+    assert.fail('エラーが発生しませんでした')
+  })
+  it('デバッグ支援 - システム関数一覧取得', async () => {
+    await cmp('A=システム関数一覧取得;I=Aから「表示」を配列検索;もし、(I>=0)ならば「OK」を表示', 'OK')
+    // 分割ファイル側の命令も一覧に含まれる
+    await cmp('A=システム関数一覧取得;I=Aから「デバッグ表示」を配列検索;もし、(I>=0)ならば「OK」を表示', 'OK')
+  })
+  it('デバッグ支援 - システム関数存在', async () => {
+    await cmp('もし、「デバッグ表示」のシステム関数存在ならば「OK」を表示', 'OK')
+    await cmp('もし、「存在しない命令XYZ」のシステム関数存在でなければ「OK」を表示', 'OK')
+  })
+  it('デバッグ支援 - グローバル関数一覧取得', async () => {
+    // ユーザー定義関数は「モジュール名__関数名」の形式で登録される
+    await cmp(
+      '●ホゲとは\n' +
+      'それは1\n' +
+      'ここまで\n' +
+      'A=グローバル関数一覧取得\n' +
+      'I=Aから「main__ホゲ」を配列検索\n' +
+      'もし、(I>=0)ならば「OK」を表示',
+      'OK')
+  })
+  it('デバッグ支援 - モジュール一覧取得', async () => {
+    await cmp('A=モジュール一覧取得;もし、(Aの配列要素数)>=0ならば「OK」を表示', 'OK')
+  })
+  it('デバッグ支援 - 助詞一覧取得と予約語一覧取得', async () => {
+    await cmp('A=助詞一覧取得;もし、(Aの配列要素数)>0ならば「OK」を表示', 'OK')
+    await cmp('A=予約語一覧取得;もし、(Aの配列要素数)>0ならば「OK」を表示', 'OK')
+  })
+
+  // --- プラグイン管理 ---
+  it('プラグイン管理 - プラグイン名', async () => {
+    await cmp('プラグイン名を表示', 'メイン')
+  })
+  it('プラグイン管理 - プラグイン名設定', async () => {
+    await cmp('「テストプラグイン」にプラグイン名設定;プラグイン名を表示', 'テストプラグイン')
+  })
+  it('プラグイン管理 - 名前空間設定と名前空間ポップ', async () => {
+    await cmp('「サブ空間」に名前空間設定;名前空間を表示;名前空間ポップ', 'サブ空間')
+    // ポップすると設定前の名前空間に戻る
+    await cmp('元=名前空間;「サブ空間」に名前空間設定;名前空間ポップ;もし、(名前空間=元)ならば「OK」を表示', 'OK')
+  })
+})

package/core/test/plugin_system_split_test.mjs

@@ -0,0 +1,179 @@
+/* eslint-disable no-undef */
+/**
+ * plugin_system.mts の分割ファイルのテスト (#2351)
+ *
+ * 肥大化した plugin_system.mts を役割ごとに以下へ分割した。
+ *   - plugin_system_math.mts     : 四則演算・論理演算・ビット演算
+ *   - plugin_system_string.mts   : 文字列処理・置換/トリム・文字変換・指定形式・文字種類
+ *   - plugin_system_array.mts    : 配列操作・二次元配列処理
+ *   - plugin_system_datetime.mts : 日時処理(簡易)
+ *   - plugin_system_url.mts      : URLエンコード・パラメータ・BASE64・パス操作
+ *   - plugin_system_types.mts    : 型変換
+ *   - plugin_system_json.mts     : JSON
+ *   - plugin_system_regexp.mts   : 正規表現
+ *   - plugin_system_dict.mts     : 辞書型変数の操作・ハッシュ
+ *   - plugin_system_stdio.mts    : 標準出力
+ *   - plugin_system_timer.mts    : タイマー処理
+ * いずれも単独のプラグインではなく、plugin_system.mts に実行時マージされる。
+ * 個々の命令の詳細な動作テストは plugin_system_test.mjs で従来通りカバーされているため、
+ * ここでは「分割ファイルが正しくマージされているか」と代表的な命令の疎通確認を行う。
+ */
+import { describe, it } from 'node:test'
+import assert from 'assert'
+import { NakoCompiler } from '../src/nako3.mjs'
+import PluginSystem from '../src/plugin_system.mjs'
+import PluginSystemMath from '../src/plugin_system_math.mjs'
+import PluginSystemString from '../src/plugin_system_string.mjs'
+import PluginSystemArray from '../src/plugin_system_array.mjs'
+import PluginSystemDatetime from '../src/plugin_system_datetime.mjs'
+import PluginSystemUrl from '../src/plugin_system_url.mjs'
+import PluginSystemTypes from '../src/plugin_system_types.mjs'
+import PluginSystemJson from '../src/plugin_system_json.mjs'
+import PluginSystemRegexp from '../src/plugin_system_regexp.mjs'
+import PluginSystemDict from '../src/plugin_system_dict.mjs'
+import PluginSystemStdio from '../src/plugin_system_stdio.mjs'
+import PluginSystemTimer from '../src/plugin_system_timer.mjs'
+
+describe('plugin_system_split_test', async () => {
+  const cmp = async (/** @type {string} */ code, /** @type {string} */ res) => {
+    const nako = new NakoCompiler()
+    nako.getLogger().debug('code=' + code)
+    const g = await nako.runAsync(code, 'main.nako3')
+    assert.strictEqual(g.log, res)
+  }
+
+  const parts = {
+    math: PluginSystemMath,
+    string: PluginSystemString,
+    array: PluginSystemArray,
+    datetime: PluginSystemDatetime,
+    url: PluginSystemUrl,
+    types: PluginSystemTypes,
+    json: PluginSystemJson,
+    regexp: PluginSystemRegexp,
+    dict: PluginSystemDict,
+    stdio: PluginSystemStdio,
+    timer: PluginSystemTimer
+  }
+
+  it('分割ファイルはメタ情報や初期化を持たない', async () => {
+    for (const [name, part] of Object.entries(parts)) {
+      assert.strictEqual(part.meta, undefined, `${name}にmetaがあります`)
+      assert.strictEqual(part['初期化'], undefined, `${name}に初期化があります`)
+      assert.strictEqual(part['!クリア'], undefined, `${name}に!クリアがあります`)
+    }
+  })
+
+  it('分割ファイルの命令が plugin_system にマージされている', async () => {
+    for (const [name, part] of Object.entries(parts)) {
+      for (const key of Object.keys(part)) {
+        assert.strictEqual(PluginSystem[key], part[key], `${name}の『${key}』がマージされていません`)
+      }
+    }
+  })
+
+  it('分割してもプラグインは plugin_system のまま', async () => {
+    assert.strictEqual(PluginSystem.meta.value.pluginName, 'plugin_system')
+    await cmp('プラグイン一覧取得して「:」で配列結合して表示', 'plugin_system:plugin_math:plugin_promise:plugin_test:plugin_csv:plugin_toml')
+  })
+
+  // --- plugin_system_math.mts の疎通確認 ---
+  it('四則演算', async () => {
+    await cmp('3に4を掛けて表示', '12')
+  })
+  it('論理演算', async () => {
+    await cmp('もし、(1と1の論理AND)ならば「OK」を表示', 'OK')
+  })
+  it('ビット演算', async () => {
+    await cmp('5と3のANDを表示', '1')
+  })
+
+  // --- plugin_system_string.mts の疎通確認 ---
+  it('文字列処理', async () => {
+    await cmp('「なでしこ」の文字数を表示', '4')
+  })
+  it('置換・トリム', async () => {
+    await cmp('「  殿  」のトリムを表示', '殿')
+  })
+  it('文字変換', async () => {
+    await cmp('「abc」の大文字変換を表示', 'ABC')
+  })
+  it('指定形式', async () => {
+    await cmp('123を5でゼロ埋して表示', '00123')
+  })
+  it('文字種類', async () => {
+    await cmp('もし、「あ」のかなか判定ならば「OK」を表示', 'OK')
+  })
+
+  // --- plugin_system_array.mts の疎通確認 ---
+  it('配列操作', async () => {
+    await cmp('[1,2,3]を「-」で配列結合して表示', '1-2-3')
+  })
+  it('二次元配列処理', async () => {
+    const g = await new NakoCompiler().runAsync('A=[[3,1],[1,2]];Aの0を表ソート;Aを JSON変換して表示', 'main.nako3')
+    assert.strictEqual(g.log, '[[1,2],[3,1]]')
+  })
+
+  // --- plugin_system_datetime.mts の疎通確認 ---
+  it('日時処理(簡易)', async () => {
+    await cmp('「2024/01/01」の曜日を表示', '月')
+  })
+
+  // --- plugin_system_url.mts の疎通確認 ---
+  it('URLエンコード・デコード', async () => {
+    await cmp('「あ」をURLエンコードしてURLデコードして表示', 'あ')
+  })
+  it('BASE64', async () => {
+    await cmp('「なでしこ」をBASE64エンコードしてBASE64デコードして表示', 'なでしこ')
+  })
+  it('パス操作', async () => {
+    await cmp('「/a/b/c.txt」のファイル名抽出を表示', 'c.txt')
+    await cmp('「/a/b/c.txt」の拡張子抽出を表示', '.txt')
+  })
+
+  // --- plugin_system_types.mts の疎通確認 ---
+  it('型変換', async () => {
+    await cmp('「3.14」を文字列変換して表示', '3.14')
+    await cmp('「3.14」を整数変換して表示', '3')
+    await cmp('TYPEOF(123)を表示', 'number')
+    await cmp('3と4の5でRGBを表示', '#030405')
+  })
+
+  // --- plugin_system_json.mts の疎通確認 ---
+  it('JSON', async () => {
+    await cmp('[1,2,3]をJSON変換して表示', '[1,2,3]')
+    await cmp('「[1,2,3]」をJSON取得してJSON変換して表示', '[1,2,3]')
+  })
+
+  // --- plugin_system_regexp.mts の疎通確認 ---
+  it('正規表現', async () => {
+    await cmp('「abc123」を『/([a-z]+)(\\d+)/』で正規表現マッチして表示', 'abc123')
+    await cmp('「abc123」を『/([a-z]+)(\\d+)/』で正規表現マッチ;抽出文字列を「,」で配列結合して表示', 'abc,123')
+  })
+
+  // --- plugin_system_dict.mts の疎通確認 ---
+  it('辞書型変数の操作', async () => {
+    await cmp('A={"a":1,"b":2};Aの辞書キー列挙を「,」で配列結合して表示', 'a,b')
+  })
+  it('ハッシュ', async () => {
+    await cmp('A={"a":1,"b":2};Aのハッシュキー列挙を「,」で配列結合して表示', 'a,b')
+  })
+
+  // --- plugin_system_stdio.mts の疎通確認 ---
+  it('標準出力', async () => {
+    await cmp('「あ」と継続表示;「い」を表示', 'あい')
+    await cmp('「a」と「b」と「c」を連続表示', 'abc')
+  })
+
+  // --- plugin_system_timer.mts の疎通確認 ---
+  it('タイマー処理', async () => {
+    // 秒後で発行したタイマーIDが取得でき、タイマー停止できること
+    await cmp(
+      'F=関数()\n' +
+      'ここまで\n' +
+      'Fを0.01秒後\n' +
+      'もし、(対象>0)ならば「OK」を表示\n' +
+      '対象のタイマー停止',
+      'OK')
+  })
+})

package/core/test/plugin_system_test.mjs

@@ -477,6 +477,8 @@ describe('plugin_system_test', async () => {
   it('URLパラメータ解析', async () => {
     await cmp('「http://hoge.com/」のURLパラメータ解析してJSONエンコードして表示', '{}')
     await cmp('「https://nadesi.com/?a=3&b=5」のURLパラメータ解析;それ["a"]を表示;それ["b"]を表示。', '3\n5')
+    await cmp('「https://nadesi.com/?a=3=3&b=5」のURLパラメータ解析;それ["a"]を表示;それ["b"]を表示。', '3=3\n5')
+    await cmp('「https://nadesi.com/?a&b=5」のURLパラメータ解析;それ["a"]を表示;それ["b"]を表示。', '\n5')
   })
   it('助詞省略形のコマンド', async () => {
     await cmp('3が1以上。もし、そうなら「OK」と表示。', 'OK')
@@ -776,6 +778,10 @@ describe('plugin_system_test', async () => {
     await cmp('S=「💧🔥🍵」;Sの2から1文字削除して表示', '💧🍵')
     await cmp('S=「1💧3🔥5🍵」;Sの3から2文字削除して表示', '1💧5🍵')
   })
+  it('数字の文字数が0になる不具合 #2342', async () => {
+    await cmp('30の文字数を表示', '2')
+    await cmp('12345の文字数を表示', '5')
+  })
   it('左トリム', async () => {
     await cmp('S=「 \t💧🔥🍵」;Sを左トリムして表示', '💧🔥🍵')
     await cmp('S=「 ABC 」;Sを左トリムして「|」を追加して表示', 'ABC |')

package/core/tsconfig.json

@@ -25,7 +25,6 @@
     /* Modules */
     "module": "ESNext",                                  /* Specify what module code is generated. */
     // "rootDir": "./",                                  /* Specify the root folder within your source files. */
-    "moduleResolution": "node",                          /* Specify how TypeScript looks up a file from a given module specifier. */
     "ignoreDeprecations": "6.0",                         /* TypeScript 6.0 の非推奨警告を抑制する */
     // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
     "paths": {

package/demo/browsers.html

@@ -13,7 +13,7 @@
   <li>Chrome (145/144/143/142/139/133/131/125/112/109以上)</li>
   <li>Safari (26.3/26.2以上)</li>
   <li>Opera (125/124以上)</li>
-  <li>Node.js (25.1.0/24.11.0/22.21.0/20.19.0以上)</li>
+  <li>Node.js (25.1.0/24.11.0/22.21.0以上)</li>
 </ul>
 
 <h2>モバイル</h2>

package/doc/SETUP.md

@@ -31,7 +31,7 @@ npm install -g windows-build-tools
 
 ## 【共通】
 
-コマンドラインから以下を実行して、nadesiko3のリポジトリをcloneし、必要なライブラリをインストール。ただし、Node.jsのバージョンv10以上が必要。もし、Ubuntuで古いNode.jsをインストールした場合などは最新安定版のNode.jsを利用してください。
+コマンドラインから以下を実行して、nadesiko3のリポジトリをcloneし、必要なライブラリをインストール。ただし、Node.jsのバージョンv22以上が必要。もし、Ubuntuで古いNode.jsをインストールした場合などは最新安定版のNode.jsを利用してください。
 
 なお、gitでリポジトリを取得する際、サブモジュールを利用するので、--recursiveを指定するのを忘れないようにしましょう。
 

package/doc/ai-code-generation.md

@@ -0,0 +1,136 @@
+# 生成AIになでしこ3のプログラムを作ってもらう
+
+生成AIに目的を伝えると、なでしこ3のプログラムを作成してもらえます。ただし、生成AIがなでしこ3の命令名や助詞を推測すると、存在しない命令や正しくない文法を使うことがあります。
+
+このチュートリアルでは、リポジトリ内の文法資料と命令一覧をAIに参照させ、生成したプログラムを実行して確かめる方法を紹介します。
+
+## 準備
+
+GitHubからなでしこ3を取得し、依存パッケージをインストールします。
+
+```sh
+git clone https://github.com/kujirahand/nadesiko3.git
+cd nadesiko3
+npm install
+```
+
+CodexやClaude Codeなど、リポジトリ内のファイルを読み書きしてコマンドを実行できるAIエージェントで、このディレクトリを開きます。
+
+## 最初のプログラムを作る
+
+まず、AIエージェントに次のように依頼します。
+
+```text
+1から10までの合計を表示する、なでしこ3のプログラムを作ってください。
+Node.js版のcnako3で動くようにして、sample.nako3へ保存してください。
+作成後に実行し、正しく動くことを確認してください。
+```
+
+AIは、このリポジトリの`AGENTS.md`に記載された手順に従い、文法と命令を確認してからコードを生成します。生成されるプログラムは、例えば次のようになります。
+
+<!-- ai-code-generation-example:start -->
+```nako3
+答=0
+Iで1から10まで繰り返す:
+  答=答+I
+「合計は{答}です」と表示
+```
+<!-- ai-code-generation-example:end -->
+
+次のコマンドで実行できます。
+
+```sh
+node src/cnako3.mjs sample.nako3
+```
+
+実行結果は次の通りです。
+
+```text
+合計は55です
+```
+
+## AIが参照する資料
+
+AIには、次の2つのファイルを正本として使わせます。
+
+- `doc/syntax-nako3.md`: 変数、条件分岐、繰り返し、関数定義などの文法
+- `doc/command_list.json`: 命令名、引数と助詞、説明、実行環境などの命令情報
+
+`doc/command_list.json`の各項目で、特に重要なフィールドは次の通りです。
+
+- `name`: 命令名
+- `args`: 引数と助詞。例えば`Sを/Sと`なら、「を」または「と」で引数を渡せる
+- `target`: 対応する実行環境。`cnako`はNode.js版、`wnako`はブラウザ版
+- `group`: `基本プラグイン`または`拡張プラグイン`
+- `description`: 命令の説明
+- `url`: 命令を定義しているソースコード
+
+命令一覧は大きなファイルです。AIにはファイル全体を回答へ貼り付けさせず、目的や命令名に合わせて必要な項目だけを検索させてください。
+
+## より正確に作ってもらうためのプロンプト
+
+実用的なプログラムでは、目的だけでなく、実行環境、入力、出力、制約、確認方法も伝えます。
+
+```text
+なでしこ3で、CSVファイルを読み込み、2列目の数値の合計を表示する
+プログラムを作ってください。
+
+条件:
+- Node.js版のcnako3で動かす
+- doc/syntax-nako3.mdの文法に従う
+- 使用する命令はdoc/command_list.jsonで確認する
+- targetにcnakoを含む命令だけを使う
+- 命令のargsに記載された助詞を守る
+- 拡張プラグインが必要なら、コードを作る前に説明する
+- sample.nako3へ保存する
+- node src/cnako3.mjs sample.nako3で実行確認する
+- エラーになった場合は、原因を調べて修正し、再実行する
+```
+
+ブラウザ版のプログラムが必要な場合は、`Node.js版のcnako3`を`ブラウザ版のwnako3`に置き換えます。その場合、`target`に`wnako`を含む命令を使うように指定してください。
+
+## 既存のプログラムを修正してもらう
+
+エラーが発生するプログラムを直してもらう場合は、対象ファイルと実行方法を伝えます。
+
+```text
+sample.nako3を実行するとエラーになります。
+doc/syntax-nako3.mdとdoc/command_list.jsonを確認して修正してください。
+修正後、node src/cnako3.mjs sample.nako3を実行し、結果を確認してください。
+```
+
+実行環境を持たないチャット型AIを使う場合は、エラーメッセージを省略せずに貼り付けて、修正を依頼してください。
+
+## よくある失敗
+
+### 存在しない命令を使う
+
+AIが、意味から命令名を推測してしまうことがあります。`doc/command_list.json`を検索し、実在する命令だけを使うように依頼してください。
+
+### 助詞が合っていない
+
+なでしこ3では、命令へ引数を渡す助詞が決まっています。命令一覧の`args`を確認してください。
+
+### 実行環境が違う
+
+DOM操作などはブラウザ専用、ファイル操作などはNode.js専用の場合があります。命令一覧の`target`に、目的の実行環境が含まれるか確認してください。
+
+### 拡張プラグインの命令をそのまま使う
+
+`group`が`拡張プラグイン`の命令は、別パッケージのインストールや取り込みが必要になることがあります。AIに導入方法も確認させてください。
+
+### 命令名を変数名に使う
+
+命令名と同じ名前を変数へ使うと、代入時に文法エラーになることがあります。エラーが出た場合は、命令一覧を検索して変数名と命令名が衝突していないか確認してください。
+
+## 最後に確認すること
+
+AIがプログラムを生成したら、次を確認します。
+
+1. 希望した`cnako`または`wnako`向けになっているか。
+2. 使用した命令が`doc/command_list.json`に存在するか。
+3. 命令の助詞が`args`と一致しているか。
+4. 必要な入力例と期待する出力が示されているか。
+5. 実際に実行し、エラーなく期待した結果が得られるか。
+
+生成AIの回答をそのまま完成品とせず、「資料を確認する」「実行する」「エラーを直す」という手順を繰り返すと、正確ななでしこ3プログラムを作りやすくなります。

package/doc/browsers.md

@@ -9,7 +9,7 @@
 - Chrome (145/144/143/142/139/133/131/125/112/109以上)
 - Safari (26.3/26.2以上)
 - Opera (125/124以上)
-- Node.js (25.1.0/24.11.0/22.21.0/20.19.0以上)
+- Node.js (25.1.0/24.11.0/22.21.0以上)
 
 ## モバイル