なんか大きな改修になりそうな話をされているのですが、求めているものとズレていきそうなので追記で。
「フォルダ一覧でnameを配列検索」
という行にエラーが出る場合で、
現在のエラーメッセージの問題点というのが
[文法エラー]main.nako3(3行目): 未解決の単語があります: [単語『フォルダ一覧』]
を見た時に
単語…？ 単語のなにを直そう？
という思考になることです。
[文法エラー]main.nako3(3行目): 未解決の単語があります: [単語『フォルダ一覧』助詞『で』]
のようにエラーメッセージに助詞を入れるだけで
単語か助詞を直せばいいのかな…？
と考えるので格段に直しやすくなります。
ひとまずこれだけでも効果は高いです。
～～
エラーメッセージ内に(3行目)とあるので構文解析側でもエラー行はわかっているはず。
その行に含まれる命令と引数がでればいいと思います。
Issuesにあった例の場合
「abc123」の「abc」が「***」に置換して表示。
↓現在のエラーメッセージ
[文法エラー]main.nako3(1行目): 未解決の単語があります: [文字列『abc』]
↓命令と引数がでるエラーメッセージ(案)
[文法エラー]main.nako3(1行目): 未解決の単語があります: [文字列『abc』助詞『が』]
以下の命令が原因の可能性もあります
・(SのAをBに|SでAからBへ)置換
・(Sを|Sと)表示
見た人は
文字列か助詞を直せばいいのかな……？ おっと置換には助詞『が』は使えないじゃないかー
という感じ。
厳密なエラー内容を知りたいんじゃなくて、直し方のヒントが欲しい
たとえばヒントが5つでて4つは関係なくてもそのうち1つが解決できるならOK