terminal-quest 1.0.2 → 1.1.2

package/README.md

@@ -26,12 +26,24 @@ npm install -g terminal-quest
 terminal-quest
 ```
 
+### 動作環境
+
+- **macOS** / **Linux** / **Windows（WSL）**
+- Node.js v18 以上
+- 外部依存なし（Docker不要、GUI不要、ネットワーク不要）
+
+純粋なnpmパッケージとして動作する**TUIアプリ**です。Ink（React for CLI）で構築されており、ターミナルさえあればどこでも動きます。
+
 ## 特徴
 
-- **安全** - すべてのコマンドは仮想ファイルシステム上で動作。実際のファイルには一切触れません
+- **安全な仮想環境** - すべてのコマンドはインメモリの仮想ファイルシステム上で動作。実際のファイルには一切触れません
 - **ストーリー駆動** - 物語を進めながら自然にコマンドを習得
-- **3つのコース** - レベルに合わせて選べるコース
-- **段階的ヒント** - 困ったら3段階のヒントで学習をサポート
+- **3つのコース** - 小学生向け・はじめて・エンジニアの3コースで、レベルに合わせた学習体験
+- **結果ベースの判定** - コマンドの文字列ではなく実行結果で目標達成を判定。`grep foo file` でも `cat file | grep foo` でも正解になります
+- **到達目標** - 各ミッションに「何ができるようになるか」を明示
+- **段階的ヒント** - 困ったら3段階（方向性→コマンド候補→ほぼ答え）のヒントで学習をサポート
+- **間違いフィードバック** - タイプミスには類似コマンドを提案、間違ったコマンドにはミッション固有のガイダンスを表示
+- **ふりかえり問題** - ミッション完了後に4択クイズで理解度チェック
 - **Tab補完** - コマンド名やファイルパスをTabキーで補完
 - **達成バッジ** - 学習の進捗に応じてバッジを獲得
 
@@ -88,6 +100,27 @@ objectives  現在の目標を確認
 man <cmd>   コマンドのマニュアル
 ```
 
+## アーキテクチャ
+
+```
+src/
+├── engine/          コアエンジン（UI非依存）
+│   ├── VirtualFS        インメモリ仮想ファイルシステム
+│   ├── CommandHandler    23コマンド実装（パイプ・リダイレクト対応）
+│   ├── MissionEngine     結果ベースの目標判定
+│   ├── HintEngine        3段階ヒント管理
+│   ├── CommandFeedback   タイプミス検出・ミッション固有フィードバック
+│   └── TabCompletion     コマンド名・パス補完
+├── data/stories/    ストーリーデータ（コース別、全9ストーリー）
+├── screens/         7画面コンポーネント（Ink/React）
+├── components/      再利用UIコンポーネント
+└── state/           ゲーム状態管理（~/.terminal-quest/progress.json に永続化）
+```
+
+- **仮想FS上で完結** — 実際のファイルシステムやシェルは一切使用しません
+- **結果ベースの判定** — ObjectiveCheck がコマンドの出力・FS状態を検査し、解法の自由度を確保
+- **コース別UX** — kids コースはひらがな中心のガイダンスとエラーメッセージ、engineer コースは実務寄りの表現
+
 ## 開発
 
 ```bash
@@ -95,10 +128,16 @@ git clone https://github.com/nasuda/terminal-quest.git
 cd terminal-quest
 npm install
 npm run dev       # 開発実行
-npm test          # テスト実行
+npm test          # テスト実行（183件）
 npm run build     # ビルド
 ```
 
+### 技術スタック
+
+- TypeScript (ESM) + [Ink 5](https://github.com/vadimdemedes/ink) (React for CLI)
+- Vitest（テスト）
+- npm配布（`bin/terminal-quest.js` → `dist/index.js` 直接import、tsx不要）
+
 ## ライセンス
 
 MIT

package/dist/App.js

@@ -21,7 +21,7 @@ export function App() {
             case 'terminal':
                 return (_jsx(TerminalScreen, { storyId: screen.storyId, missionIndex: screen.missionIndex, onNavigate: navigateTo, onMissionComplete: completeMission, onStoryComplete: completeStory, onCommandExecuted: incrementCommands }));
             case 'missionComplete':
-                return (_jsx(MissionCompleteScreen, { storyId: screen.storyId, missionIndex: screen.missionIndex, onNavigate: navigateTo }));
+                return (_jsx(MissionCompleteScreen, { storyId: screen.storyId, missionIndex: screen.missionIndex, commandCount: screen.commandCount, onNavigate: navigateTo }));
             case 'progress':
                 return _jsx(ProgressScreen, { progress: progress, onNavigate: navigateTo });
             case 'settings':

package/dist/data/stories/00-beginner-pc.js

@@ -449,6 +449,13 @@ export const story00 = {
             id: 'mission-00-01',
             title: 'ここはどこ？',
             description: '新しいパソコンを開いたら、まずは今いる場所を確認して、どんなファイルがあるか見てみよう。',
+            goal: 'pwd と ls を使って、今いる場所とファイル構成を把握できるようになる',
+            review: {
+                question: '今いるフォルダの場所を表示するコマンドはどれですか？',
+                choices: ['ls', 'cd', 'pwd', 'cat'],
+                correctIndex: 2,
+                explanation: 'pwd (Print Working Directory) は、今いるフォルダのパスを画面に表示するコマンドです。',
+            },
             narrative: 'やったー！新しいパソコンが届いた！さっそくターミナルを開いてみたけど、真っ黒な画面が出てきた。ここはどこだろう？まずは自分がどこにいるのか確認して、周りに何があるのか見てみよう。',
             initialCwd: '/home/watashi',
             initialFS: mission1FS,
@@ -481,6 +488,13 @@ export const story00 = {
             id: 'mission-00-02',
             title: 'フォルダの中を見て回ろう',
             description: 'フォルダを移動して、中にあるファイルを読んでみよう。',
+            goal: 'cd でフォルダを移動し、cat でファイルの中身を読めるようになる',
+            review: {
+                question: 'フォルダを移動するコマンドはどれですか？',
+                choices: ['ls', 'cd', 'cat', 'pwd'],
+                correctIndex: 1,
+                explanation: 'cd (Change Directory) は、別のフォルダに移動するコマンドです。',
+            },
             narrative: 'パソコンの中には「写真」「音楽」「レシピ」などのフォルダがあるみたい。フォルダの中に移動して、どんなファイルがあるか見てみよう！',
             initialCwd: '/home/watashi',
             initialFS: mission2FS,
@@ -523,6 +537,13 @@ export const story00 = {
             id: 'mission-00-03',
             title: '写真アルバムを作ろう',
             description: '写真を整理するために、新しいフォルダやファイルを作ってみよう。',
+            goal: 'mkdir でフォルダを作り、touch で空のファイルを作れるようになる',
+            review: {
+                question: '新しいフォルダを作るコマンドはどれですか？',
+                choices: ['touch', 'mkdir', 'cp', 'mv'],
+                correctIndex: 1,
+                explanation: 'mkdir (Make Directory) は、新しいフォルダ（ディレクトリ）を作成するコマンドです。',
+            },
             narrative: '写真フォルダの中がごちゃごちゃしてきた。「旅行」や「ペット」のフォルダを作って、写真を整理しよう！',
             initialCwd: '/home/watashi/写真',
             initialFS: mission3FS,
@@ -565,6 +586,13 @@ export const story00 = {
             id: 'mission-00-04',
             title: 'ファイルを整理しよう',
             description: '間違った場所にあるファイルをコピーしたり、移動したりして整理しよう。',
+            goal: 'cp でファイルをコピーし、mv や rm で整理できるようになる',
+            review: {
+                question: 'ファイルをコピーするコマンドはどれですか？',
+                choices: ['mv', 'cp', 'rm', 'cat'],
+                correctIndex: 1,
+                explanation: 'cp (Copy) は、ファイルやフォルダをコピーするコマンドです。mv は移動、rm は削除です。',
+            },
             narrative: 'あれ？「大事なメモ.txt」がホームフォルダに置きっぱなしだ。これは「メモ」フォルダに入れるべきだよね。ファイルをコピーしたり移動したりして、きちんと整理しよう。',
             initialCwd: '/home/watashi',
             initialFS: mission4FS,
@@ -597,6 +625,13 @@ export const story00 = {
             id: 'mission-00-05',
             title: 'いらないファイルを片付けよう',
             description: '不要な一時ファイルを探し出して、削除しよう。',
+            goal: 'find でファイルを検索し、rm で不要ファイルを削除できるようになる',
+            review: {
+                question: 'ファイルを名前で検索するコマンドはどれですか？',
+                choices: ['grep', 'find', 'ls', 'cat'],
+                correctIndex: 1,
+                explanation: 'find は、ファイルやフォルダを名前やタイプで検索するコマンドです。grep はファイルの中身を検索します。',
+            },
             narrative: 'パソコンの中に「.tmp」という拡張子の一時ファイルがたまっている。これは不要なファイルなので、探し出して片付けよう！',
             initialCwd: '/home/watashi',
             initialFS: mission5FS,
@@ -649,6 +684,13 @@ export const story00 = {
             id: 'mission-00-06',
             title: '日記を書こう',
             description: '新しい日記を書いて、過去の日記から特定の言葉を探してみよう。',
+            goal: 'echo でファイルに書き込み、grep で特定の言葉を検索できるようになる',
+            review: {
+                question: 'ファイルの中から特定の文字列を検索するコマンドはどれですか？',
+                choices: ['find', 'cat', 'grep', 'echo'],
+                correctIndex: 2,
+                explanation: 'grep は、ファイルの中身から指定した文字列を含む行を検索するコマンドです。find はファイル名で検索します。',
+            },
             narrative: '日記フォルダに過去の日記がある。今日の日記を書いて、それから過去の日記から気になる言葉を探してみよう！',
             initialCwd: '/home/watashi/日記',
             initialFS: mission6FS,
@@ -681,6 +723,13 @@ export const story00 = {
             id: 'mission-00-07',
             title: '長いレポートを確認しよう',
             description: '長いレポートの最初と最後だけを見たり、行数を数えたりしてみよう。',
+            goal: 'head と tail でファイルの一部を確認し、wc で行数を数えられるようになる',
+            review: {
+                question: 'ファイルの最後の数行だけを表示するコマンドはどれですか？',
+                choices: ['head', 'tail', 'cat', 'wc'],
+                correctIndex: 1,
+                explanation: 'tail はファイルの末尾（最後の部分）を表示するコマンドです。head は最初の部分を表示します。',
+            },
             narrative: '旅行のレポートが長くて全部読むのは大変。最初の部分と最後の部分だけ確認して、全体の行数も数えてみよう。',
             initialCwd: '/home/watashi',
             initialFS: mission7FS,
@@ -725,6 +774,13 @@ export const story00 = {
             id: 'mission-00-08',
             title: '連絡先を整理しよう',
             description: '連絡先データを並べ替えたり、重複を取り除いたりしてみよう。',
+            goal: 'sort、uniq、cut を使ってデータを加工・整理できるようになる',
+            review: {
+                question: '重複した行を取り除くために sort と組み合わせて使うコマンドはどれですか？',
+                choices: ['grep', 'cut', 'uniq', 'wc'],
+                correctIndex: 2,
+                explanation: 'uniq は、隣接する重複行を取り除くコマンドです。sort で並べ替えてから使うのがポイントです。',
+            },
             narrative: '連絡先のファイルがぐちゃぐちゃで、同じ人が何回も登録されている。きれいに並べ替えて、重複を取り除こう！',
             initialCwd: '/home/watashi',
             initialFS: mission8FS,
@@ -770,6 +826,13 @@ export const story00 = {
             id: 'mission-00-09',
             title: '共有ファイルの設定',
             description: 'ファイルの権限を設定して、スクリプトを実行できるようにしよう。',
+            goal: 'chmod で権限を変更し、パイプでコマンドを連携できるようになる',
+            review: {
+                question: 'ファイルに実行権限を追加するコマンドはどれですか？',
+                choices: ['chown +x', 'chmod +x', 'cp +x', 'mv +x'],
+                correctIndex: 1,
+                explanation: 'chmod (Change Mode) はファイルの権限を変更するコマンドです。+x で実行権限を追加します。',
+            },
             narrative: '共有フォルダにある集計スクリプトを実行したいけど、実行する権限がない。権限を設定して使えるようにしよう！',
             initialCwd: '/home/watashi',
             initialFS: mission9FS,
@@ -802,6 +865,13 @@ export const story00 = {
             id: 'mission-00-10',
             title: '変更履歴を管理しよう',
             description: 'git を使ってレポートの変更履歴を確認してみよう。',
+            goal: 'git status と git log で変更の状態と履歴を確認できるようになる',
+            review: {
+                question: 'ファイルの変更状態を確認する git コマンドはどれですか？',
+                choices: ['git log', 'git status', 'git diff', 'git add'],
+                correctIndex: 1,
+                explanation: 'git status は、どのファイルが変更されたか、ステージされているかなどの現在の状態を表示します。',
+            },
             narrative: 'レポートフォルダでは git を使って変更履歴を管理している。どんな変更が行われたか確認してみよう！',
             initialCwd: '/home/watashi/レポート',
             initialFS: mission10FS,

package/dist/data/stories/01-first-server.js

@@ -196,6 +196,13 @@ export const story01 = {
             id: 'mission-01-01',
             title: '現在地を確認しよう',
             description: '基本中の基本、現在のディレクトリを確認し、ファイルの一覧を表示してみよう。',
+            goal: 'pwd と ls を使って、今いる場所とファイル構成を把握できるようになる',
+            review: {
+                question: '現在のディレクトリを表示するコマンドはどれですか？',
+                choices: ['ls', 'cd', 'pwd', 'cat'],
+                correctIndex: 2,
+                explanation: 'pwd (Print Working Directory) は現在いるディレクトリのパスを表示するコマンドです。',
+            },
             narrative: '先輩からの引き継ぎメモには「まずは現在いるディレクトリを確認」と書いてある。ターミナルを開いたら、まず自分がどこにいるのか把握しよう。',
             initialCwd: '/home/admin',
             newCommands: ['pwd', 'ls'],
@@ -210,6 +217,11 @@ export const story01 = {
                         { level: 2, text: '"Print Working Directory" の略で、3文字のコマンドです。' },
                         { level: 3, text: '「pwd」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'ls', message: 'ls はディレクトリの中身を一覧表示するコマンドです。現在の場所を確認するには、別のコマンドを使います。' },
+                        { pattern: 'cd', message: 'cd はディレクトリを移動するコマンドです。現在の場所を確認するには、別のコマンドを使います。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。現在の場所を確認するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-01-01-02',
@@ -220,6 +232,11 @@ export const story01 = {
                         { level: 2, text: '"List" の略で、2文字のコマンドです。' },
                         { level: 3, text: '「ls」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'pwd', message: 'pwd は現在のディレクトリを表示するコマンドです。ファイル一覧を表示するには、別のコマンドを使います。' },
+                        { pattern: 'cd', message: 'cd はディレクトリを移動するコマンドです。ファイル一覧を表示するには、別のコマンドを使います。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ファイル一覧を表示するには、別のコマンドを使います。' },
+                    ],
                 },
             ],
         },
@@ -227,6 +244,13 @@ export const story01 = {
             id: 'mission-01-02',
             title: '設定ファイルを探せ',
             description: 'サーバーの設定ファイルを見つけて内容を確認しよう。',
+            goal: 'cd でディレクトリを移動し、cat でファイル内容を確認できるようになる',
+            review: {
+                question: 'ディレクトリを移動するコマンドはどれですか？',
+                choices: ['ls', 'cd', 'cat', 'pwd'],
+                correctIndex: 1,
+                explanation: 'cd (Change Directory) はディレクトリを移動するコマンドです。',
+            },
             narrative: 'サーバーの設定ファイルを確認する必要がある。設定ファイルは /etc に保管されている。ディレクトリを移動して、設定内容を確認しよう。',
             initialCwd: '/home/admin',
             newCommands: ['cd', 'cat'],
@@ -241,6 +265,11 @@ export const story01 = {
                         { level: 2, text: '"Change Directory" の略のコマンドに、移動先のパスを指定します。' },
                         { level: 3, text: '「cd /etc」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'pwd', message: 'pwd は現在の場所を表示するコマンドです。ディレクトリを移動するには、別のコマンドを使います。' },
+                        { pattern: 'ls', message: 'ls はファイル一覧を表示するコマンドです。ディレクトリを移動するには、別のコマンドを使います。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ディレクトリを移動するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-01-02-02',
@@ -251,6 +280,11 @@ export const story01 = {
                         { level: 2, text: '2文字のコマンドで、ディレクトリの中身を表示できます。' },
                         { level: 3, text: '「ls」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'pwd', message: 'pwd は現在の場所を表示するコマンドです。ファイル一覧を確認するには、別のコマンドを使います。' },
+                        { pattern: 'cd', message: 'cd はディレクトリ移動のコマンドです。今いる場所の中身を見るには、別のコマンドを使います。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ディレクトリの中身一覧を見るには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-01-02-03',
@@ -261,6 +295,11 @@ export const story01 = {
                         { level: 2, text: '猫の鳴き声に似た3文字のコマンドです。パスを指定しましょう。' },
                         { level: 3, text: '「cat app/config.json」と入力してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'pwd', message: 'pwd は現在の場所を表示するコマンドです。ファイルの内容を読むには、別のコマンドを使います。' },
+                        { pattern: 'ls', message: 'ls はファイル一覧を表示するコマンドです。ファイルの中身を読むには、別のコマンドを使います。' },
+                        { pattern: 'cd', message: 'cd はディレクトリ移動のコマンドです。ファイルの内容を読むには、別のコマンドを使います。' },
+                    ],
                 },
             ],
         },
@@ -268,6 +307,13 @@ export const story01 = {
             id: 'mission-01-03',
             title: 'ログからエラーを探せ',
             description: 'ログファイルからエラーメッセージを見つけ出そう。',
+            goal: 'grep を使ってログから特定のパターンを抽出できるようになる',
+            review: {
+                question: 'ファイルの内容を表示するコマンドはどれですか？',
+                choices: ['ls', 'pwd', 'cat', 'cd'],
+                correctIndex: 2,
+                explanation: 'cat はファイルの内容を表示するコマンドです。concatenate（連結）が語源です。',
+            },
             narrative: 'ユーザーから「エラーが出てる」と報告が。ログファイルを調べて、何が起きているか確認しよう。',
             initialCwd: '/home/admin',
             newCommands: ['grep'],
@@ -285,6 +331,10 @@ export const story01 = {
                         { level: 2, text: 'ログファイルは /var/log/app.log にあります。' },
                         { level: 3, text: '「cat /var/log/app.log」と入力してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'grep', message: 'grep は検索コマンドです。まずは cat でログ全体を確認しましょう。' },
+                        { pattern: 'ls', message: 'ls はファイル一覧を表示するコマンドです。ファイルの内容を読むには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-01-03-02',
@@ -298,6 +348,10 @@ export const story01 = {
                         { level: 2, text: 'grep コマンドに検索パターンとファイル名を指定します。' },
                         { level: 3, text: '「grep ERROR /var/log/app.log」と入力してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cat', message: 'cat はファイル全体を表示します。特定の文字列を含む行だけを抽出するには、検索コマンドを使いましょう。' },
+                        { pattern: 'find', message: 'find はファイル名を検索するコマンドです。ファイルの中身を検索するには、別のコマンドを使います。' },
+                    ],
                 },
             ],
         },
@@ -305,6 +359,13 @@ export const story01 = {
             id: 'mission-01-04',
             title: '設定ファイルのバックアップ',
             description: '設定を変更する前に、安全のためバックアップを取ろう。',
+            goal: 'cp でファイルのバックアップを作成する習慣を身につける',
+            review: {
+                question: '特定の文字列を含む行を検索するコマンドはどれですか？',
+                choices: ['cat', 'find', 'grep', 'ls'],
+                correctIndex: 2,
+                explanation: 'grep はファイル内のテキストをパターンで検索するコマンドです。',
+            },
             narrative: '設定を変更する前に、バックアップを取る習慣をつけよう。何かあったときに元に戻せるように、コピーを作成する。',
             initialCwd: '/etc/app',
             newCommands: ['cp'],
@@ -324,6 +385,11 @@ export const story01 = {
                         { level: 2, text: 'cp コマンドで「元ファイル」「コピー先」を指定します。.bak 拡張子をつけるのが慣例です。' },
                         { level: 3, text: '「cp config.json config.json.bak」と入力してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'mv', message: 'mv はファイルを移動するコマンドです。バックアップを作るには、元のファイルを残したままコピーするコマンドを使いましょう。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ファイルをコピーするには、別のコマンドを使います。' },
+                        { pattern: 'echo', message: 'echo はテキストを出力するコマンドです。ファイルをそのままコピーするには、別のコマンドを使います。' },
+                    ],
                 },
             ],
         },
@@ -331,6 +397,13 @@ export const story01 = {
             id: 'mission-01-05',
             title: '設定を修正せよ',
             description: 'デバッグモードを有効にして、問題を調査しやすくしよう。',
+            goal: 'echo とリダイレクト（>）を使ってファイルを書き換えられるようになる',
+            review: {
+                question: 'ファイルをコピーするコマンドはどれですか？',
+                choices: ['mv', 'cp', 'rm', 'cat'],
+                correctIndex: 1,
+                explanation: 'cp (copy) はファイルやディレクトリをコピーするコマンドです。',
+            },
             narrative: 'デバッグモードが無効になっている。config.json の debug を true に変更しよう。echo とリダイレクトを使ってファイルを書き換える。',
             initialCwd: '/etc/app',
             newCommands: ['echo'],
@@ -354,6 +427,10 @@ export const story01 = {
                             text: '「echo \'{"port": 3000, "debug": true}\' > config.json」と入力してください。',
                         },
                     ],
+                    feedbacks: [
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ファイルに書き込むには、別のコマンドとリダイレクト（>）を使います。' },
+                        { pattern: 'cp', message: 'cp はファイルをコピーするコマンドです。ファイルの内容を書き換えるには、echo とリダイレクト（>）を使いましょう。' },
+                    ],
                 },
             ],
         },

package/dist/data/stories/02-messy-project.js

@@ -267,6 +267,7 @@ export const story02 = {
             id: 'mission-02-01',
             title: 'ディレクトリを作ろう',
             description: 'mkdir コマンドでディレクトリを作成して、プロジェクト構造を整理しよう。',
+            goal: 'mkdir でプロジェクトのディレクトリ構造を設計・作成できるようになる',
             narrative: 'プロジェクトにはソースコード、ドキュメント、テストが混在している。まずはディレクトリを整理しよう。',
             initialCwd: '/home/dev/project',
             newCommands: ['mkdir'],
@@ -281,6 +282,10 @@ export const story02 = {
                         { level: 2, text: '"Make Directory" の略で、mkdir コマンドを使います。' },
                         { level: 3, text: '「mkdir src」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'touch', message: 'touch は空のファイルを作成するコマンドです。ディレクトリを作成するには、別のコマンドを使います。' },
+                        { pattern: 'cd', message: 'cd はディレクトリを移動するコマンドです。新しいディレクトリを作成するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-02-01-02',
@@ -308,6 +313,7 @@ export const story02 = {
             id: 'mission-02-02',
             title: 'ファイルを移動せよ',
             description: 'mv コマンドでファイルを適切なディレクトリに移動しよう。',
+            goal: 'mv でファイルを適切な場所に移動・整理できるようになる',
             narrative: 'ディレクトリができた。次はファイルを適切な場所に移動しよう。',
             initialCwd: '/home/dev/project',
             newCommands: ['mv'],
@@ -325,6 +331,10 @@ export const story02 = {
                         { level: 2, text: '"Move" の略で、mv コマンドを使います。mv 元 先 の形式です。' },
                         { level: 3, text: '「mv app.js src/」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cp', message: 'cp はファイルをコピーするコマンドです。元のファイルを残さず移動するには、別のコマンドを使います。' },
+                        { pattern: 'rm', message: 'rm はファイルを削除するコマンドです。ファイルを別の場所に移動するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-02-02-02',
@@ -352,6 +362,7 @@ export const story02 = {
             id: 'mission-02-03',
             title: '不要なファイルを削除',
             description: '.tmp ファイルや .bak ファイルを見つけて削除しよう。',
+            goal: 'find で不要ファイルを検索し、rm で安全に削除できるようになる',
             narrative: 'プロジェクト内に .tmp ファイルや .bak ファイルが大量にある。不要ファイルを見つけて削除しよう。',
             initialCwd: '/home/dev/project',
             newCommands: ['rm', 'find'],
@@ -369,6 +380,10 @@ export const story02 = {
                         { level: 2, text: 'find コマンドで名前パターンを指定して検索できます。' },
                         { level: 3, text: '「find . -name "*.tmp"」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'ls', message: 'ls は現在のディレクトリの中身を表示するコマンドです。サブディレクトリも含めてファイルを検索するには、別のコマンドを使います。' },
+                        { pattern: 'grep', message: 'grep はファイルの中身を検索するコマンドです。ファイル名で検索するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-02-03-02',
@@ -379,6 +394,10 @@ export const story02 = {
                         { level: 2, text: '"Remove" の略で、rm コマンドを使います。' },
                         { level: 3, text: '「rm cache.tmp」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'mv', message: 'mv はファイルを移動するコマンドです。ファイルを削除するには、別のコマンドを使います。' },
+                        { pattern: 'find', message: 'find はファイルを検索するコマンドです。すでに見つけたファイルを削除するには、別のコマンドを使います。' },
+                    ],
                 },
                 {
                     id: 'obj-02-03-03',
@@ -396,6 +415,7 @@ export const story02 = {
             id: 'mission-02-04',
             title: '新しいファイルを作成',
             description: '新しいファイルを作成して、プロジェクトの状態を確認しよう。',
+            goal: 'touch でファイルを作成し、wc でコードの行数を確認できるようになる',
             narrative: 'プロジェクト構造が整った。新しいファイルを作成して、プロジェクトの状態を確認しよう。',
             initialCwd: '/home/dev/project',
             newCommands: ['touch', 'wc'],
@@ -410,6 +430,10 @@ export const story02 = {
                         { level: 2, text: 'touch コマンドでファイルを作成できます。' },
                         { level: 3, text: '「touch CHANGELOG.md」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'mkdir', message: 'mkdir はディレクトリを作成するコマンドです。空のファイルを作成するには、別のコマンドを使います。' },
+                        { pattern: 'echo', message: 'echo はテキストを出力するコマンドです。空のファイルを作成するだけなら、もっと簡単なコマンドがあります。' },
+                    ],
                 },
                 {
                     id: 'obj-02-04-02',

package/dist/data/stories/03-log-detective.js

@@ -167,6 +167,7 @@ export const story03 = {
             id: 'mission-03-01',
             title: 'ログファイルの調査',
             description: 'head と tail コマンドでログファイルの最初と最後を確認しよう。',
+            goal: 'head と tail で大きなログファイルの概要を素早く把握できるようになる',
             narrative: '大量のログがある。まずはファイルの最初と最後を確認しよう。',
             initialCwd: '/var/log',
             newCommands: ['head', 'tail'],
@@ -201,6 +202,7 @@ export const story03 = {
             id: 'mission-03-02',
             title: 'エラーの分析',
             description: 'grep と wc コマンドで 500 エラーの件数を数えよう。',
+            goal: 'grep でエラーを抽出し、パイプで wc -l に渡して件数を数えられるようになる',
             narrative: '500エラーが出ている。何件あるか数えよう。',
             initialCwd: '/var/log',
             initialFS: mission2FS,
@@ -234,6 +236,7 @@ export const story03 = {
             id: 'mission-03-03',
             title: 'アクセスパターンの分析',
             description: 'sort と uniq コマンドでIPアドレスのアクセス頻度を調べよう。',
+            goal: 'sort | uniq -c でデータの出現頻度を集計できるようになる',
             narrative: 'どのIPアドレスからアクセスが多いか調べよう。',
             initialCwd: '/var/log',
             newCommands: ['sort', 'uniq'],
@@ -265,6 +268,7 @@ export const story03 = {
             id: 'mission-03-04',
             title: 'レポート作成',
             description: 'grep とリダイレクトを使って、調査結果をファイルに保存しよう。',
+            goal: 'コマンドの出力をリダイレクト（>）でファイルに保存できるようになる',
             narrative: '調査結果をレポートファイルにまとめよう。',
             initialCwd: '/var/log',
             initialFS: mission4FS,

package/dist/data/stories/04-deploy-day.js

@@ -223,6 +223,7 @@ export const story04 = {
             id: 'mission-04-01',
             title: 'デプロイ先の準備',
             description: 'mkdir -p と cp -r でデプロイ先を準備しよう。',
+            goal: 'mkdir -p と cp -r で本番環境のディレクトリ構成を構築できるようになる',
             narrative: 'デプロイ先のディレクトリを作成して、ソースをコピーしよう。',
             initialCwd: '/home/deploy',
             initialFS: mission1FS,
@@ -253,6 +254,7 @@ export const story04 = {
             id: 'mission-04-02',
             title: '権限の設定',
             description: 'chmod コマンドでファイルの実行権限を設定しよう。',
+            goal: 'chmod でスクリプトに実行権限を付与できるようになる',
             narrative: 'デプロイしたファイルの実行権限を設定しよう。',
             initialCwd: '/var/www/app',
             newCommands: ['chmod'],
@@ -274,6 +276,7 @@ export const story04 = {
             id: 'mission-04-03',
             title: 'バックアップ作成',
             description: '古いバックアップを削除して、新しいバックアップを作ろう。',
+            goal: 'rm -rf で古いディレクトリを削除し、cp -r で新しいバックアップを作れるようになる',
             narrative: '古いバックアップを削除して、新しいバックアップを作ろう。',
             initialCwd: '/var/www',
             initialFS: mission3FS,
@@ -304,6 +307,7 @@ export const story04 = {
             id: 'mission-04-04',
             title: '最終確認',
             description: 'デプロイが完了したか最終確認しよう。',
+            goal: 'find と cat でデプロイ結果を検証できるようになる',
             narrative: 'デプロイが完了した。最終確認をしよう。',
             initialCwd: '/var/www/app',
             initialFS: mission4FS,

package/dist/data/stories/05-git-incident.js

@@ -379,6 +379,7 @@ export const story05 = {
             id: 'mission-05-01',
             title: '状況確認',
             description: 'git status と git log で現在のリポジトリの状態を把握しよう。',
+            goal: 'git status と git log でリポジトリの状態と履歴を把握できるようになる',
             narrative: '先輩が「リポジトリがおかしい」と焦っている。まずは状況を確認しよう。',
             initialCwd: '/home/dev/repo',
             newCommands: ['git'],
@@ -416,6 +417,7 @@ export const story05 = {
             id: 'mission-05-02',
             title: '変更の退避',
             description: 'git stash で作業中の変更を一旦退避しよう。',
+            goal: 'git stash で作業中の変更を安全に退避できるようになる',
             narrative: '作業中の変更を一旦退避して、安全な状態に戻そう。',
             initialCwd: '/home/dev/repo',
             initialFS: mission2FS,
@@ -439,6 +441,7 @@ export const story05 = {
             id: 'mission-05-03',
             title: 'ブランチ操作',
             description: 'git branch と git checkout でブランチを操作しよう。',
+            goal: 'git branch でブランチ確認、git checkout -b で新しいブランチを作れるようになる',
             narrative: '修正用のブランチを作って切り替えよう。',
             initialCwd: '/home/dev/repo',
             initialFS: mission3FS,
@@ -475,6 +478,7 @@ export const story05 = {
             id: 'mission-05-04',
             title: '変更の確認',
             description: 'git diff で変更内容を確認して問題箇所を特定しよう。',
+            goal: 'git diff でコードの変更差分を確認し問題を特定できるようになる',
             narrative: '変更内容を確認して、問題の箇所を特定しよう。',
             initialCwd: '/home/dev/repo',
             initialFS: mission4FS,
@@ -498,6 +502,7 @@ export const story05 = {
             id: 'mission-05-05',
             title: 'マージ',
             description: '修正をメインブランチに統合しよう。',
+            goal: 'git checkout と git merge でブランチを統合できるようになる',
             narrative: '修正が完了した。メインブランチに統合しよう。',
             initialCwd: '/home/dev/repo',
             initialFS: mission5FS,

package/dist/data/stories/06-pipe-master.js

@@ -224,6 +224,7 @@ export const story06 = {
             id: 'mission-06-01',
             title: 'パイプ入門',
             description: 'パイプ（|）を使ってコマンドの出力を次のコマンドに渡そう。',
+            goal: 'パイプ（|）でコマンドの出力を別のコマンドに渡せるようになる',
             narrative: 'パイプ(|)を使うと、コマンドの出力を次のコマンドの入力にできる。',
             initialCwd: '/home/data',
             initialFS: mission1FS,
@@ -257,6 +258,7 @@ export const story06 = {
             id: 'mission-06-02',
             title: 'データ加工',
             description: 'sort と uniq、grep と wc をパイプで組み合わせてデータを分析しよう。',
+            goal: 'パイプで複数コマンドを連携させてデータ集計・分析ができるようになる',
             narrative: 'データの集計と分析にパイプを活用しよう。',
             initialCwd: '/home/data',
             initialFS: mission2FS,
@@ -290,6 +292,7 @@ export const story06 = {
             id: 'mission-06-03',
             title: 'フィールド抽出',
             description: 'cut コマンドでCSVから特定のフィールドを抽出しよう。',
+            goal: 'cut でCSVの特定列を抽出し、sort でフィールド指定ソートができるようになる',
             narrative: 'CSVデータから特定のフィールドを抽出して分析しよう。',
             initialCwd: '/home/data',
             newCommands: ['cut'],
@@ -324,6 +327,7 @@ export const story06 = {
             id: 'mission-06-04',
             title: '総合演習',
             description: '複数のコマンドをパイプで繋いで、データを抽出してファイルに保存しよう。',
+            goal: '6段パイプで抽出・加工・集計・ソートを一括実行できるようになる',
             narrative: '最終課題。複数のコマンドをパイプで繋いで、データから必要な情報を抽出し、ファイルに保存しよう。',
             initialCwd: '/home/data',
             initialFS: mission4FS,