nadesiko3 3.7.21 → 3.7.23

package/test/node/search_command_test.mjs

@@ -0,0 +1,174 @@
+/* eslint-disable no-undef */
+// batch/search_command.nako3 (命令検索CLI)のテスト (#2385)
+// ラッパー batch/search_command.mjs を子プロセスとして実行して動作を確認する。
+import assert from 'assert'
+import path from 'path'
+import url from 'url'
+import { spawnSync } from 'child_process'
+
+const __filename = url.fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const rootDir = path.resolve(__dirname, '../../')
+const cliPath = path.join(rootDir, 'batch/search_command.mjs')
+
+/** 命令検索CLIを実行して {code, stdout} を返す */
+function runCLI (args) {
+  const r = spawnSync(process.execPath, [cliPath, ...args], {
+    cwd: rootDir,
+    encoding: 'utf-8',
+    // npm test は --test-timeout=15000 で実行されるので、それより短くして
+    // ハング時にテスト側のタイムアウトより先に原因が分かるようにする
+    timeout: 10000
+  })
+  if (r.error) { throw r.error }
+  if (r.signal) {
+    throw new Error(`検索CLIがシグナル${r.signal}で終了しました(タイムアウトの可能性)。\n出力=${r.stdout}${r.stderr}`)
+  }
+  return { code: r.status, stdout: r.stdout || '', stderr: r.stderr || '' }
+}
+
+describe('search_command(命令検索CLI)', () => {
+  it('検索語で部分一致検索ができる', () => {
+    const r = runCLI(['ファイル'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    assert.ok(r.stdout.indexOf('件見つかりました。') >= 0)
+    assert.ok(r.stdout.indexOf('ファイル') >= 0)
+  })
+
+  it('命令名が完全一致するものが先頭に表示される', () => {
+    const r = runCLI(['表示', '--limit', '5'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const lines = r.stdout.split('\n').filter((s) => s.indexOf('[関数] ') === 0)
+    assert.ok(lines.length > 0)
+    assert.ok(lines[0].indexOf('[関数] 表示 ') === 0, lines[0])
+  })
+
+  it('--targetで実行環境を絞り込める', () => {
+    const r = runCLI(['ファイル', '--target', 'cnako', '--json'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const list = JSON.parse(r.stdout)
+    assert.ok(list.length > 0)
+    for (const c of list) {
+      assert.ok(c.target.indexOf('cnako') >= 0, JSON.stringify(c))
+    }
+  })
+
+  it('--groupで基本/拡張プラグインを絞り込める(英語指定)', () => {
+    const r = runCLI(['表示', '--group', 'basic', '--json'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const list = JSON.parse(r.stdout)
+    assert.ok(list.length > 0)
+    for (const c of list) {
+      assert.strictEqual(c.group, '基本プラグイン')
+    }
+  })
+
+  it('--groupは日本語でも指定できる', () => {
+    // 拡張プラグインの命令は環境によって有無が変わるため、英語指定と日本語指定の
+    // 結果が一致することで、日本語の指定が使えることを確認する。
+    const r1 = runCLI(['表示', '--group', 'basic', '--json'])
+    const r2 = runCLI(['表示', '--group', '基本プラグイン', '--json'])
+    assert.strictEqual(r1.code, 0, r1.stdout + r1.stderr)
+    assert.strictEqual(r2.code, r1.code)
+    assert.deepStrictEqual(JSON.parse(r2.stdout), JSON.parse(r1.stdout))
+    const r3 = runCLI(['ファイル', '--group', '拡張プラグイン', '--json'])
+    assert.ok(r3.code === 0 || r3.code === 1, `exit=${r3.code}`)
+    for (const c of JSON.parse(r3.stdout)) {
+      assert.strictEqual(c.group, '拡張プラグイン')
+    }
+  })
+
+  it('--plugin と --type で絞り込める', () => {
+    const r = runCLI(['--plugin', 'plugin_node', '--type', '関数', '--limit', '0', '--json'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const list = JSON.parse(r.stdout)
+    assert.ok(list.length > 0)
+    for (const c of list) {
+      assert.ok(c.plugin.indexOf('plugin_node') >= 0, c.plugin)
+      assert.strictEqual(c.type, '関数')
+    }
+  })
+
+  it('--option=値 の形式でも指定できる', () => {
+    const r = runCLI(['ファイル', '--target=cnako', '--limit=3', '--json'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const list = JSON.parse(r.stdout)
+    assert.strictEqual(list.length, 3)
+  })
+
+  it('検索語を複数指定するとAND条件になる', () => {
+    const r1 = runCLI(['ファイル', '--json', '--limit', '0'])
+    const r2 = runCLI(['ファイル', 'コピー', '--json', '--limit', '0'])
+    assert.strictEqual(r1.code, 0)
+    assert.strictEqual(r2.code, 0)
+    const list1 = JSON.parse(r1.stdout)
+    const list2 = JSON.parse(r2.stdout)
+    assert.ok(list2.length > 0)
+    assert.ok(list2.length < list1.length)
+    for (const c of list2) {
+      const text = `${c.name} ${c.yomi} ${c.description}`
+      assert.ok(text.indexOf('コピー') >= 0, JSON.stringify(c))
+    }
+  })
+
+  it('一致なしのとき終了コード1になる', () => {
+    const r = runCLI(['ぜったいにない命令名XYZ'])
+    assert.strictEqual(r.code, 1)
+    assert.ok(r.stdout.indexOf('一致する命令は見つかりませんでした。') >= 0)
+  })
+
+  it('一致なしのJSON出力は空配列になる', () => {
+    const r = runCLI(['ぜったいにない命令名XYZ', '--json'])
+    assert.strictEqual(r.code, 1)
+    assert.deepStrictEqual(JSON.parse(r.stdout), [])
+  })
+
+  it('JSON出力は必要なキーだけを含む', () => {
+    const r = runCLI(['CSV変換', '--json'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const list = JSON.parse(r.stdout)
+    assert.ok(list.length > 0)
+    const keys = Object.keys(list[0]).sort()
+    assert.deepStrictEqual(keys, ['args', 'description', 'group', 'name', 'plugin', 'target', 'type', 'yomi'])
+    assert.strictEqual(list[0].name, 'CSV変換')
+  })
+
+  it('--limitで表示件数を制限できる', () => {
+    const r = runCLI(['ファイル', '--limit', '2'])
+    assert.strictEqual(r.code, 0, r.stdout + r.stderr)
+    const lines = r.stdout.split('\n').filter((s) => /^\[(関数|変数|定数)\] /.test(s))
+    assert.strictEqual(lines.length, 2)
+    assert.ok(r.stdout.indexOf('--limit 0') >= 0)
+  })
+
+  it('--helpで使い方を表示する', () => {
+    const r = runCLI(['--help'])
+    assert.strictEqual(r.code, 0)
+    assert.ok(r.stdout.indexOf('なでしこ3 命令検索CLI') >= 0)
+    assert.ok(r.stdout.indexOf('--target') >= 0)
+  })
+
+  it('引数がないときは使い方を表示して終了コード2になる', () => {
+    const r = runCLI([])
+    assert.strictEqual(r.code, 2)
+    assert.ok(r.stdout.indexOf('使い方:') >= 0)
+  })
+
+  it('不明なオプションは終了コード2になる', () => {
+    const r = runCLI(['ファイル', '--unknown'])
+    assert.strictEqual(r.code, 2)
+    assert.ok(r.stdout.indexOf('不明なオプション') >= 0)
+  })
+
+  it('オプションの値がないときは終了コード2になる', () => {
+    const r = runCLI(['ファイル', '--target'])
+    assert.strictEqual(r.code, 2)
+    assert.ok(r.stdout.indexOf('値の指定が必要です') >= 0)
+  })
+
+  it('不正な値を指定したときは終了コード2になる', () => {
+    const r = runCLI(['ファイル', '--target', 'xxx'])
+    assert.strictEqual(r.code, 2)
+    assert.ok(r.stdout.indexOf('--target') >= 0)
+  })
+})

package/tools/nako3edit/AGENTS.md

@@ -0,0 +1,23 @@
+# ゴール
+
+Node.js(JavaScript)で書かれたnako3edit用のサーバー`index.mjs`を、完全に、なでしこ3のプログラムとして書き直すことを目標とします。
+
+作成したプログラムは、`index.nako3`として、なでしこ3のプログラムとして実行できるようにします。
+
+## コンテキスト
+
+なでしこの文法は、`doc/syntax-nako3.md`にまとめられています。
+
+## デバッグについて
+
+```sh
+# プログラム index.nako3を実行する
+cnako3 index.nako3
+```
+
+プログラムの構造を理解するには、次のコマンドで、プログラムの構造(文法構造ツリー)を表示することができます。
+
+```sh
+# ASTを表示する
+cnako3 --ast index.nako3
+```

package/tools/nako3edit/index.nako3

@@ -0,0 +1,404 @@
+#!/usr/bin/env cnako3
+# nako3edit用の超簡易サーバ(なでしこ3だけで簡単HTTPサーバ)
+# もともと index.mjs (Node.js) で書かれていたものを、なでしこ3で書き直したものです。
+!「plugin_httpserver.mjs」を取り込む。
+
+# --- 定数 ---
+定数のルートパス＝母艦パスを絶対パス変換。
+定数のリリースパス＝「{母艦パス}/../../release」を絶対パス変換。
+定数のCNAKO3パス＝「{母艦パス}/../../src/cnako3.mjs」を絶対パス変換。
+定数のNODEパス＝コマンドライン[0]
+定数の既定ポート＝8888
+定数の環境変数一覧＝環境変数一覧取得。
+定数のアプリキー＝「k{(4294967295の乱数)のHEX}{(4294967295の乱数)のHEX}{(4294967295の乱数)のHEX}{(4294967295の乱数)のHEX}」
+定数のMIME一覧＝{
+    ".html": "text/html",
+    ".css": "text/css",
+    ".js": "text/javascript",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml"
+}
+
+# --- 小さな便利関数 ---
+
+# 文字列Sが文字列Pで始まるかどうかを調べる
+●(SがPで)先頭一致とは
+    ((Sで1からPを文字検索)＝1)を戻す。
+ここまで。
+
+# 環境変数KEYの値を返す。未設定なら既定値Dを返す。
+●(KEYとDの)環境変数参照とは
+    もし、(環境変数一覧のKEYが辞書キー存在)ならば
+        (環境変数一覧[KEY])を戻す。
+    ここまで。
+    Dを戻す。
+ここまで。
+
+# ユーザーが作成したなでしこファイルを保存するフォルダを返す
+●ユーザーフォルダ取得とは
+    もし、(OS取得＝「win32」)ならば
+        ホーム＝「USERPROFILE」と「.」の環境変数参照。
+    違えば
+        ホーム＝「HOME」と「.」の環境変数参照。
+    ここまで。
+    「{ホーム}/nadesiko3_user」を絶対パス変換して戻す。
+ここまで。
+
+# パスPATHからMIMEタイプを求めて返す
+●(PATHの)MIMEタイプ取得とは
+    拡張子＝「.txt」
+    部品＝PATHを「.」で区切る。
+    もし、((部品の要素数)>1)ならば
+        拡張子＝「.{(部品[(部品の要素数)-1])を小文字変換}」
+    ここまで。
+    もし、(MIME一覧の拡張子が辞書キー存在)ならば
+        (MIME一覧[拡張子])を戻す。
+    ここまで。
+    「text/plain」を戻す。
+ここまで。
+
+# ファイル名に利用できない記号を置き換える
+●(Sの)ファイル名サニタイズとは
+    S＝Sの『/['"`\\?\/<\>\*]/g』を「_」で正規表現置換。
+    S＝Sの『/_{2,}/g』を「」で正規表現置換。
+    Sを戻す。
+ここまで。
+
+# 共通のContent-Typeヘッダを付けて200を返す
+●(本文を種類で)正常返信とは
+    ヘッダ＝{"Content-Type": 種類}
+    200でヘッダを簡易HTTPサーバヘッダ出力。
+    本文を簡易HTTPサーバ出力。
+ここまで。
+
+# 共通のContent-Typeヘッダを付けて500を返す
+●(本文を種類で)サーバエラー返信とは
+    ヘッダ＝{"Content-Type": 種類}
+    500でヘッダを簡易HTTPサーバヘッダ出力。
+    本文を簡易HTTPサーバ出力。
+ここまで。
+
+# アプリキーを確認する。正しければ真を返す。
+●(PARAMSの)アプリキー確認とは
+    もし、((PARAMSの「appkey」が辞書キー存在)＝偽)ならば、偽を戻す。
+    (PARAMS["appkey"]＝アプリキー)を戻す。
+ここまで。
+
+# --- 起動前の準備 ---
+
+# ポート番号を検証して、安全な値のみを利用する
+●サーバポート解決とは
+    生ポート＝「NAKO3EDIT_PORT」と「」の環境変数参照。
+    # 環境変数になければコマンドライン引数を見る(cnako3ではスクリプト名の次が引数)
+    もし、(生ポート＝「」)ならば
+        もし、((コマンドラインの要素数)>3)ならば
+            生ポート＝コマンドライン[3]
+        ここまで。
+    ここまで。
+    もし、(生ポート＝「」)ならば、既定ポートを戻す。
+    ポート番号＝生ポートを整数変換。
+    もし、((ポート番号を非数判定)または(ポート番号<0)または(ポート番号>65535))ならば
+        「[ERROR] 無効なポート番号です: {生ポート}」と表示。
+        「[ERROR] 環境変数 NAKO3EDIT_PORT またはコマンドライン引数には 0 から 65535 の整数を指定してください。」と表示。
+        終了。
+    ここまで。
+    ポート番号を戻す。
+ここまで。
+
+定数のサーバポート＝サーバポート解決。
+定数のユーザーパス＝ユーザーフォルダ取得。
+もし、((ユーザーパスがフォルダ存在)＝偽)ならば、ユーザーパスをフォルダ作成。
+
+# --- API ---
+
+# ユーザーフォルダのファイル一覧を返す
+●APIファイル一覧とは
+    ファイル一覧＝ユーザーパスのファイル列挙。
+    (ファイル一覧をJSONエンコード)を「application/json」で正常返信。
+ここまで。
+
+# ファイルを読み込む。存在しなければ新規ファイル用の初期値を返す。
+●(PARAMSの)API読込とは
+    ファイル名＝PARAMS["file"]のファイル名サニタイズ。
+    フルパス＝「{ユーザーパス}/{ファイル名}」
+    「load= {フルパス}」と表示。
+    本文＝「# 新規ファイル{改行}」&『「こんにちは」と表示。』
+    もし、(フルパスが存在)ならば、本文＝フルパスを読。
+    本文を「text/plain」で正常返信。
+ここまで。
+
+# ファイルを保存する
+●(PARAMSの)API保存とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        「[ERROR] キーが違います」を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    ファイル名＝PARAMS["file"]のファイル名サニタイズ。
+    本文＝PARAMS["body"]
+    フルパス＝「{ユーザーパス}/{ファイル名}」
+    保存成功＝真
+    エラー監視
+        本文をフルパスへ保存。
+    エラーならば
+        保存成功＝偽
+    ここまで。
+    もし、保存成功ならば
+        「[save] file= {フルパス}」と表示。
+        「body= {本文}」と表示。
+        「--------------------------------」と表示。
+        「ok」を「text/plain; charset=utf-8」で正常返信。
+    違えば
+        「[ERROR] 保存に失敗しました😭」を「text/plain; charset=utf-8」で正常返信。
+    ここまで。
+ここまで。
+
+# 指定したファイルをcnako3で実行して結果を返す
+●(ファイル名の)ファイル実行とは
+    フルパス＝「{ユーザーパス}/{ファイル名}」
+    コマンド＝「"{NODEパス}" "{CNAKO3パス}" "{フルパス}"」
+    「@run= {コマンド}」と表示。
+    実行成功＝真
+    エラー監視
+        実行結果＝コマンドを起動待機。
+    エラーならば
+        実行成功＝偽
+        実行結果＝エラーメッセージ
+    ここまで。
+    もし、(実行成功＝偽)ならば
+        「[ERROR]実行に失敗しました。{実行結果}」を戻す。
+    ここまで。
+    「[run] file= {ファイル名}」と表示。
+    「--------------------------------」と表示。
+    実行結果を表示。
+    「--------------------------------」と表示。
+    実行結果を戻す。
+ここまで。
+
+# 保存してからファイルを実行する
+●(PARAMSの)API実行とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        「[ERROR] キーが違います」を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    ファイル名＝PARAMS["file"]のファイル名サニタイズ。
+    本文＝PARAMS["body"]
+    フルパス＝「{ユーザーパス}/{ファイル名}」
+    保存成功＝真
+    エラー監視
+        本文をフルパスへ保存。
+    エラーならば
+        保存成功＝偽
+    ここまで。
+    もし、(保存成功＝偽)ならば
+        「[ERROR] 実行に失敗しました。」を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    実行結果＝ファイル名のファイル実行。
+    実行結果を「text/plain; charset=utf-8」で正常返信。
+ここまで。
+
+# 保存済みのファイルを直接実行する
+●(PARAMSの)API直接実行とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        「[ERROR] キーが違います」を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    ファイル名＝PARAMS["file"]のファイル名サニタイズ。
+    実行結果＝ファイル名のファイル実行。
+    実行結果を「text/plain; charset=utf-8」で正常返信。
+ここまで。
+
+# ファイルを削除する
+●(PARAMSの)API削除とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        『"[ERROR] キーが違います"』を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    ファイル名＝PARAMS["file"]のファイル名サニタイズ。
+    フルパス＝「{ユーザーパス}/{ファイル名}」
+    もし、((フルパスが存在)＝偽)ならば
+        『"[ERROR] ファイルが見つかりません。"』を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    削除成功＝真
+    エラー監視
+        フルパスをファイル削除。
+    エラーならば
+        削除成功＝偽
+        削除エラー＝エラーメッセージ
+    ここまで。
+    もし、削除成功ならば
+        『"ok"』を「text/plain; charset=utf-8」で正常返信。
+    違えば
+        「error:{削除エラー}」を「text/plain; charset=utf-8」で正常返信。
+    ここまで。
+ここまで。
+
+# 未使用のファイル名を返す
+●API新規ファイル名取得とは
+    ファイル名＝「newfile.nako3」
+    番号で1から9999まで繰り返す
+        ファイル名＝「file{番号}.nako3」
+        フルパス＝「{ユーザーパス}/{ファイル名}」
+        もし、((フルパスが存在)＝偽)ならば、抜ける。
+    ここまで。
+    「"{ファイル名}"」を「text/plain; charset=utf-8」で正常返信。
+ここまで。
+
+# npmから利用可能なプラグイン一覧を取得する
+●(PARAMSの)APIプラグイン取得とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        『"[ERROR] キーが違います"』を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    取得成功＝真
+    エラー監視
+        結果＝『npm search "nadesiko3\-" --json』を起動待機。
+    エラーならば
+        取得成功＝偽
+    ここまで。
+    もし、取得成功ならば
+        結果を「text/plain; charset=utf-8」で正常返信。
+    違えば
+        『"[ERROR] プラグインの取得に失敗しました。"』を「text/plain; charset=utf-8」で正常返信。
+    ここまで。
+ここまで。
+
+# npmプラグインを追加する
+●(PARAMSの)APIプラグイン追加とは
+    もし、((PARAMSのアプリキー確認)＝偽)ならば
+        『"[ERROR] キーが違います"』を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    もし、((PARAMSの「name」が辞書キー存在)＝偽)または(PARAMS["name"]＝「」)ならば
+        『"[ERROR] プラグイン名が指定されていません。"』を「text/plain; charset=utf-8」で正常返信。
+        戻る。
+    ここまで。
+    追加成功＝真
+    エラー監視
+        名前＝PARAMS["name"]
+        コマンド＝「npm install "{名前}"」
+        結果＝コマンドを起動待機。
+    エラーならば
+        追加成功＝偽
+    ここまで。
+    もし、追加成功ならば
+        「実行しました:{結果}」を「text/plain; charset=utf-8」で正常返信。
+    違えば
+        『"[ERROR] プラグインの取得に失敗しました。"』を「text/plain; charset=utf-8」で正常返信。
+    ここまで。
+ここまで。
+
+# --- 静的ファイル ---
+
+# 404エラーを返す
+●(URIとFPATHで)エラー404返信とは
+    「[ERROR] 404 {URI}」と表示。
+    「| file= {FPATH}」と表示。
+    ヘッダ＝{"Content-Type": "text/html; charset=utf-8"}
+    404でヘッダを簡易HTTPサーバヘッダ出力。
+    「<html><meta charset="utf-8"><body><h1>404 残念(ToT) ファイルがありません。</h1></body></html>」を簡易HTTPサーバ出力。
+ここまで。
+
+# URIを元にして返信すべきファイルのパスを求める
+●(URIの)ファイルパス取得とは
+    安全URI＝URIの「..」を「」に置換。
+    もし、(安全URIが「/release/」で先頭一致)ならば
+        相対URI＝安全URIの『/^\/release/』を「」で正規表現置換。
+        FPATH＝「{リリースパス}/{相対URI}」
+    違えば
+        FPATH＝「{ルートパス}/{安全URI}」
+    ここまで。
+    FPATH＝FPATHの「//」を「/」に置換。
+    もし、(FPATHがフォルダ存在)ならば
+        FPATH＝「{FPATH}/index.html」の「//」を「/」に置換。
+    ここまで。
+    FPATHを戻す。
+ここまで。
+
+# 静的ファイルを返す
+●(URIの)静的ファイル返信とは
+    FPATH＝URIのファイルパス取得。
+    もし、((FPATHが存在)＝偽)ならば
+        URIとFPATHでエラー404返信。
+        戻る。
+    ここまで。
+    読込成功＝真
+    エラー監視
+        データ＝FPATHをバイナリ読。
+    エラーならば
+        読込成功＝偽
+    ここまで。
+    もし、(読込成功＝偽)ならば
+        「Failed to read file.」を「text/plain」でサーバエラー返信。
+        戻る。
+    ここまで。
+    データを(FPATHのMIMEタイプ取得)で正常返信。
+ここまで。
+
+# リクエストされたURIを処理して返信する
+●リクエスト処理とは
+    URI＝GETデータ["?URL"]
+    PARAMS＝GETデータ
+    「[ようこそ] {URIをJSONエンコード}」と表示。
+    もし、(URI＝「/」)ならば
+        移動先＝「/html/files.html?appkey={アプリキー}」
+        ヘッダ＝{"Location": 移動先}
+        302でヘッダを簡易HTTPサーバヘッダ出力。
+        「<a href="/html/files.html">HTML</a>」を簡易HTTPサーバ出力。
+        戻る。
+    ここまで。
+    もし、(URI＝「/files」)ならば
+        APIファイル一覧。
+        戻る。
+    ここまで。
+    もし、(URI＝「/load」)ならば
+        PARAMSのAPI読込。
+        戻る。
+    ここまで。
+    もし、(URI＝「/save」)ならば
+        PARAMSのAPI保存。
+        戻る。
+    ここまで。
+    もし、(URI＝「/run」)ならば
+        PARAMSのAPI実行。
+        戻る。
+    ここまで。
+    もし、(URI＝「/run_direct」)ならば
+        PARAMSのAPI直接実行。
+        戻る。
+    ここまで。
+    もし、(URI＝「/get_new_filename」)ならば
+        API新規ファイル名取得。
+        戻る。
+    ここまで。
+    もし、(URI＝「/deletefile」)ならば
+        PARAMSのAPI削除。
+        戻る。
+    ここまで。
+    もし、(URI＝「/get_plugins」)ならば
+        PARAMSのAPIプラグイン取得。
+        戻る。
+    ここまで。
+    もし、(URI＝「/add_plugins」)ならば
+        PARAMSのAPIプラグイン追加。
+        戻る。
+    ここまで。
+    URIの静的ファイル返信。
+ここまで。
+
+# --- ここからメイン処理 ---
+定数のサーバホスト＝「NAKO3EDIT_HOST」と「localhost」の環境変数参照。
+定数の自動起動＝「NAKO3EDIT_OPEN」と「1」の環境変数参照。
+
+サーバポートで簡易HTTPサーバ起動時には
+    サーバURL＝「http://{サーバホスト}:{サーバポート}」
+    「### 超簡易Webサーバが起動しました」と表示。
+    「[URL] {サーバURL}」と表示。
+    もし、(自動起動≠「0」)ならば、サーバURLをブラウザ起動。
+ここまで。
+
+「/」で簡易HTTPサーバ受信した時には
+    リクエスト処理。
+ここまで。

package/tools/nako3server/AGENTS.md

@@ -0,0 +1,23 @@
+# ゴール
+
+Node.js(JavaScript)で書かれたサーバー`index.mjs`を、完全に、なでしこ3のプログラムとして書き直すことを目標とします。
+
+作成したプログラムは、`index.nako3`として、なでしこ3のプログラムとして実行できるようにします。
+
+## コンテキスト
+
+なでしこの文法は、`doc/syntax-nako3.md`にまとめられています。
+
+## デバッグについて
+
+```sh
+# プログラム index.nako3を実行する
+cnako3 index.nako3
+```
+
+プログラムの構造を理解するには、次のコマンドで、プログラムの構造(文法構造ツリー)を表示することができます。
+
+```sh
+# ASTを表示する
+cnako3 --ast index.nako3
+```