terminal-quest 1.1.2 → 1.2.0

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

@@ -67,7 +67,7 @@ const salesCsvLines = [
     '営業,175000',
     '人事,135000',
     '開発,240000',
-].join('\n');
+].join('\n') + '\n';
 const mission2FS = {
     type: 'directory',
     children: {
@@ -231,12 +231,15 @@ export const story06 = {
             objectives: [
                 {
                     id: 'obj-06-01-01',
-                    description: 'ファイル一覧の先頭5件を表示する',
-                    checks: [{ type: 'output_contains', pattern: 'file05' }],
+                    description: 'ログの先頭5行だけを表示する',
+                    checks: [
+                        { type: 'command_executed', command: 'head' },
+                        { type: 'output_contains', pattern: '08:00:01' },
+                    ],
                     hints: [
                         { level: 1, text: 'コマンドの出力を別のコマンドに渡す記号があります。' },
-                        { level: 2, text: 'ls の出力をパイプ（|）で head に渡します。head -n 5 で先頭5行を取得できます。' },
-                        { level: 3, text: '「ls | head -n 5」と入力してEnterを押してください。' },
+                        { level: 2, text: 'cat でログを表示し、パイプ（|）で head に渡します。head -n 5 で先頭5行だけ取得できます。' },
+                        { level: 3, text: '「cat logs/access.log | head -n 5」と入力してEnterを押してください。' },
                     ],
                 },
                 {
@@ -251,8 +254,22 @@ export const story06 = {
                         { level: 2, text: 'cat と grep をパイプで繋ぎます。直接 grep にファイルを指定してもOKです。' },
                         { level: 3, text: '「cat logs/access.log | grep ERROR」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'grep error', message: '大文字と小文字は区別されます。ERROR を検索するには大文字で「grep ERROR」と入力しましょう。' },
+                    ],
                 },
             ],
+            review: {
+                question: 'パイプ（|）の役割は何ですか？',
+                choices: [
+                    'ファイルを削除する',
+                    '左のコマンドの出力を右のコマンドの入力に渡す',
+                    'ファイルに保存する',
+                    'コマンドを同時に実行する',
+                ],
+                correctIndex: 1,
+                explanation: 'パイプ（|）は左のコマンドの出力を、右のコマンドの入力として渡します。これにより複数のコマンドをつなげて、複雑なデータ処理ができます。',
+            },
         },
         {
             id: 'mission-06-02',
@@ -265,21 +282,28 @@ export const story06 = {
             objectives: [
                 {
                     id: 'obj-06-02-01',
-                    description: '部門の種類を確認する',
+                    description: 'cut と sort | uniq でユニークな部門名をすべて表示する',
                     checks: [
-                        { type: 'command_executed', command: 'sort' },
+                        { type: 'command_executed', command: 'cut' },
                         { type: 'output_contains', pattern: '\u55B6\u696D' },
                     ],
                     hints: [
                         { level: 1, text: 'CSVの特定の列を抽出して、重複を除去しましょう。' },
-                        { level: 2, text: 'cut -d, -f1 で部門列を抽出し、sort | uniq でユニークな値を取得できます。' },
+                        { level: 2, text: 'cut コマンドで列を指定します。-d, は「カンマ区切り」、-f1 は「1列目」の意味です。その結果を sort | uniq に渡しましょう。' },
                         { level: 3, text: '「cut -d, -f1 sales.csv | sort | uniq」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cut -f1', message: '-d オプションで区切り文字を指定し忘れていませんか？CSVなので -d, が必要です。' },
+                        { pattern: 'sort.*uniq.*sales', message: 'まず cut で部門列を抽出してから、sort | uniq に渡しましょう。' },
+                    ],
                 },
                 {
                     id: 'obj-06-02-02',
-                    description: 'データの件数を数える（20件）',
-                    checks: [{ type: 'output_contains', pattern: '20' }],
+                    description: 'wc -l で sales.csv の行数を数える',
+                    checks: [
+                        { type: 'command_executed', command: 'wc' },
+                        { type: 'output_contains', pattern: '20' },
+                    ],
                     hints: [
                         { level: 1, text: '行数を数えるコマンドを使いましょう。' },
                         { level: 2, text: 'wc -l コマンドでファイルの行数を数えられます。' },
@@ -287,6 +311,17 @@ export const story06 = {
                     ],
                 },
             ],
+            review: {
+                question: 'sort | uniq の順番が重要な理由は何ですか？',
+                choices: [
+                    'uniq の方が処理が遅いから',
+                    'uniq は隣り合う重複行しか除去しないので、先に sort で並べる必要がある',
+                    'sort が uniq の結果を上書きするから',
+                    '特に理由はない。逆順でも同じ結果になる',
+                ],
+                correctIndex: 1,
+                explanation: 'uniq は「隣り合った行」が同じ場合だけ重複を除去します。そのため、先に sort でデータを並べ替えて同じ値を隣り合わせにしてから、uniq で重複除去するのが正しい手順です。',
+            },
         },
         {
             id: 'mission-06-03',
@@ -313,15 +348,29 @@ export const story06 = {
                 },
                 {
                     id: 'obj-06-03-02',
-                    description: 'データを年齢でソートする',
+                    description: 'sort -t, -k3 -n で年齢（3列目）の数値順にソートする',
                     checks: [{ type: 'command_executed', command: 'sort' }],
                     hints: [
                         { level: 1, text: '数値でソートするオプションがあります。' },
-                        { level: 2, text: 'sort に -t（区切り文字）-k（フィールド）-n（数値ソート）を指定します。' },
+                        { level: 2, text: 'sort -t, は「カンマ区切り」、-k3 は「3番目の列でソート」、-n は「数値として並べる」の意味です。年齢は3列目にあります。' },
                         { level: 3, text: '「sort -t, -k3 -n employees.csv」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: '^sort employees', message: 'オプションなしの sort は1列目で文字順にソートします。年齢（3列目）で数値ソートするには -t, -k3 -n が必要です。' },
+                    ],
                 },
             ],
+            review: {
+                question: 'cut -d, -f2 の -d と -f はそれぞれ何を指定しますか？',
+                choices: [
+                    '-d はディレクトリ、-f はファイル',
+                    '-d は区切り文字（delimiter）、-f はフィールド番号',
+                    '-d は削除、-f はフィルター',
+                    '-d はデータ型、-f はフォーマット',
+                ],
+                correctIndex: 1,
+                explanation: '-d は区切り文字（delimiter）を指定します。-d, ならカンマ区切りです。-f はフィールド番号で、-f2 なら2番目の列を取り出します。CSVデータの加工に欠かせないコマンドです。',
+            },
         },
         {
             id: 'mission-06-04',
@@ -347,7 +396,7 @@ export const story06 = {
                 },
                 {
                     id: 'obj-06-04-02',
-                    description: 'report.log からサービス別ERROR件数を集計する（4段パイプ）',
+                    description: 'ERROR行からサービス名を抽出し、サービス別エラー件数を集計する（4段パイプ）',
                     checks: [
                         { type: 'command_executed', command: 'uniq' },
                         { type: 'output_contains', pattern: 'web' },
@@ -368,11 +417,22 @@ export const story06 = {
                     ],
                     hints: [
                         { level: 1, text: '前の集計結果をさらにソートして上位だけ取り出しましょう。' },
-                        { level: 2, text: '前の4段パイプの結果に | sort -rn | head -n 3 を追加すると上位3件が取れます。' },
+                        { level: 2, text: '件数の多い順に並べるには sort -rn（数値の逆順ソート）を使います。上位だけ取るには head を使いましょう。' },
                         { level: 3, text: '「grep ERROR report.log | cut -d" " -f2 | sort | uniq -c | sort -rn | head -n 3」と入力してEnterを押してください。' },
                     ],
                 },
             ],
+            review: {
+                question: '「grep ERROR report.log | cut -d" " -f2 | sort | uniq -c」のパイプの流れとして正しいのはどれ？',
+                choices: [
+                    'ファイル作成 → 検索 → 並べ替え → カウント',
+                    'ERROR行を抽出 → サービス名を取り出し → 並べ替え → 重複をカウント',
+                    '並べ替え → 抽出 → カウント → 表示',
+                    'カウント → 並べ替え → 抽出 → 表示',
+                ],
+                correctIndex: 1,
+                explanation: 'パイプは左から右へ順番に処理されます。まず grep でERROR行だけを抽出し、cut でサービス名の列を取り出し、sort で並べ替えてから、uniq -c で重複をカウントします。',
+            },
         },
     ],
     unlockRequires: ['story-03'],

package/dist/data/stories/07-dangerous-commands.js

@@ -258,14 +258,14 @@ export const story07 = {
                 },
                 {
                     id: 'obj-07-01-02',
-                    description: 'cat \u3067\u91CD\u8981\u30D5\u30A1\u30A4\u30EB\u306E\u4E2D\u8EAB\u3092\u78BA\u8A8D\u3059\u308B',
+                    description: 'cat data/important.csv で重要データの内容を確認する',
                     checks: [
                         { type: 'command_executed', command: 'cat' },
-                        { type: 'output_contains', pattern: 'important' },
+                        { type: 'output_contains', pattern: 'Tanaka' },
                     ],
                     hints: [
                         { level: 1, text: '\u30D5\u30A1\u30A4\u30EB\u306E\u4E2D\u8EAB\u3092\u8868\u793A\u3059\u308B\u30B3\u30DE\u30F3\u30C9\u3067\u3001\u91CD\u8981\u306A\u30C7\u30FC\u30BF\u3092\u78BA\u8A8D\u3057\u307E\u3057\u3087\u3046\u3002' },
-                        { level: 2, text: 'cat \u30B3\u30DE\u30F3\u30C9\u3067 data \u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u5185\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u898B\u3066\u307F\u307E\u3057\u3087\u3046\u3002' },
+                        { level: 2, text: 'cat コマンドで data/important.csv を見てみましょう。重要なデータが含まれています。' },
                         { level: 3, text: '\u300Ccat data/important.csv\u300D\u3068\u5165\u529B\u3057\u3066Enter\u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002' },
                     ],
                 },
@@ -278,8 +278,23 @@ export const story07 = {
                         { level: 2, text: 'rm \u30B3\u30DE\u30F3\u30C9\u3067\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3067\u304D\u307E\u3059\u3002\u524A\u9664\u5BFE\u8C61\u3092\u9593\u9055\u3048\u306A\u3044\u3088\u3046\u306B\uFF01' },
                         { level: 3, text: '\u300Crm data/backup.csv\u300D\u3068\u5165\u529B\u3057\u3066Enter\u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002' },
                     ],
+                    feedbacks: [
+                        { pattern: 'rm data/important', message: 'important.csv は重要なデータです！削除するのは backup.csv の方です。' },
+                        { pattern: '^rm backup', message: 'backup.csv は data/ フォルダの中にあります。パスを指定して rm data/backup.csv としましょう。' },
+                    ],
                 },
             ],
+            review: {
+                question: 'ファイルを削除する前にまずやるべきことは何ですか？',
+                choices: [
+                    'すぐに rm で削除する',
+                    'ls と cat で中身を確認して、削除対象を間違えないようにする',
+                    'ディレクトリごと rm -rf で削除する',
+                    '別のサーバーにコピーする',
+                ],
+                correctIndex: 1,
+                explanation: '削除する前に ls でファイル一覧を確認し、cat で中身を見て「本当に消して大丈夫か」を確認する習慣が大切です。一度削除したファイルは元に戻せません。',
+            },
         },
         {
             id: 'mission-07-02',
@@ -305,7 +320,7 @@ export const story07 = {
                 },
                 {
                     id: 'obj-07-02-02',
-                    description: '\u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB\u3092\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3059\u308B',
+                    description: 'cp で server.conf を backups/ にバックアップする',
                     checks: [{ type: 'file_exists', path: '/home/project/backups/server.conf' }],
                     hints: [
                         { level: 1, text: '\u30D5\u30A1\u30A4\u30EB\u3092\u30B3\u30D4\u30FC\u3059\u308B\u30B3\u30DE\u30F3\u30C9\u3092\u4F7F\u3044\u307E\u3057\u3087\u3046\u3002' },
@@ -315,15 +330,26 @@ export const story07 = {
                 },
                 {
                     id: 'obj-07-02-03',
-                    description: '\u5B89\u5168\u306B\u5143\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3059\u308B',
+                    description: '不要な app.log を rm で安全に削除する',
                     checks: [{ type: 'file_not_exists', path: '/home/project/app.log' }],
                     hints: [
-                        { level: 1, text: '\u4E0D\u8981\u306B\u306A\u3063\u305F\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3057\u307E\u3057\u3087\u3046\u3002' },
+                        { level: 1, text: 'バックアップが取れたので、不要なログファイルを安全に削除しましょう。' },
                         { level: 2, text: 'rm \u30B3\u30DE\u30F3\u30C9\u3067\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3067\u304D\u307E\u3059\u3002\u30ED\u30B0\u30D5\u30A1\u30A4\u30EB\u306F\u4E0D\u8981\u3067\u3059\u306D\u3002' },
                         { level: 3, text: '\u300Crm app.log\u300D\u3068\u5165\u529B\u3057\u3066Enter\u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002' },
                     ],
                 },
             ],
+            review: {
+                question: 'ファイル削除の安全な手順として正しいのはどれ？',
+                choices: [
+                    'rm で削除 → 必要だったら復元する',
+                    'ls で確認 → バックアップを作成（cp） → 不要ファイルを削除（rm）',
+                    'バックアップなしで即削除する',
+                    'ファイル名を変更してから削除する',
+                ],
+                correctIndex: 1,
+                explanation: '安全な手順は「確認 → バックアップ → 削除」です。ls で内容を確認し、cp で重要なファイルをバックアップしてから、不要なファイルだけを rm で削除しましょう。',
+            },
         },
         {
             id: 'mission-07-03',
@@ -346,18 +372,26 @@ export const story07 = {
                 },
                 {
                     id: 'obj-07-03-02',
-                    description: '\u6B63\u3057\u3044\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3060\u3051\u3092 rm -rf \u3067\u524A\u9664\u3059\u308B',
+                    description: 'rm -rf で old-build だけを削除する（src と dist は残す）',
                     checks: [{ type: 'file_not_exists', path: '/home/project/old-build' }],
                     hints: [
                         { level: 1, text: '\u53E4\u3044\u30D3\u30EB\u30C9\u7D50\u679C\u3060\u3051\u3092\u524A\u9664\u3057\u307E\u3057\u3087\u3046\u3002\u30BD\u30FC\u30B9\u30B3\u30FC\u30C9\u3092\u524A\u9664\u3057\u306A\u3044\u3088\u3046\u6CE8\u610F\uFF01' },
                         { level: 2, text: 'rm -rf \u3067\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3054\u3068\u524A\u9664\u3067\u304D\u307E\u3059\u3002old-build \u3092\u524A\u9664\u3057\u307E\u3057\u3087\u3046\u3002' },
                         { level: 3, text: '\u300Crm -rf old-build\u300D\u3068\u5165\u529B\u3057\u3066Enter\u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002' },
                     ],
+                    feedbacks: [
+                        { pattern: 'rm -rf src', message: 'src はソースコードが入った大切なディレクトリです！削除するのは old-build の方です。' },
+                        { pattern: 'rm -rf dist', message: 'dist は現在のビルド結果です。削除するのは old-build の方です。' },
+                        { pattern: '^rm old-build$', message: 'ディレクトリを中身ごと削除するには -rf オプションが必要です。rm -rf old-build としましょう。' },
+                    ],
                 },
                 {
                     id: 'obj-07-03-03',
                     description: 'src \u304C\u6B8B\u3063\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B',
-                    checks: [{ type: 'output_contains', pattern: 'main.ts' }],
+                    checks: [
+                        { type: 'command_executed', command: 'ls' },
+                        { type: 'output_contains', pattern: 'main.ts' },
+                    ],
                     hints: [
                         { level: 1, text: '\u30BD\u30FC\u30B9\u30B3\u30FC\u30C9\u304C\u7121\u4E8B\u306B\u6B8B\u3063\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3057\u307E\u3057\u3087\u3046\u3002' },
                         { level: 2, text: 'ls \u30B3\u30DE\u30F3\u30C9\u3067 src \u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u306E\u4E2D\u8EAB\u3092\u78BA\u8A8D\u3057\u307E\u3057\u3087\u3046\u3002' },
@@ -365,6 +399,17 @@ export const story07 = {
                     ],
                 },
             ],
+            review: {
+                question: 'rm -rf を実行する前に最も重要なことは何ですか？',
+                choices: [
+                    '何も考えずに即実行する',
+                    'ls で削除対象の中身を確認し、正しいディレクトリだけを指定する',
+                    '-rf ではなく -r だけを使う',
+                    'ファイルを先に全部移動する',
+                ],
+                correctIndex: 1,
+                explanation: 'rm -rf は確認なしでディレクトリを丸ごと削除する強力なコマンドです。必ず ls で中身を確認し、ソースコードなど重要なファイルを間違えて消さないよう、削除対象を正確に指定しましょう。',
+            },
         },
         {
             id: 'mission-07-04',
@@ -390,18 +435,29 @@ export const story07 = {
                 },
                 {
                     id: 'obj-07-04-02',
-                    description: '\u53E4\u3044\u30ED\u30B0\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3059\u308B',
-                    checks: [{ type: 'file_not_exists', path: '/home/project/logs/app-2024-01.log' }],
+                    description: 'find で見つけた app-2024-*.log を rm で削除する',
+                    checks: [
+                        { type: 'file_not_exists', path: '/home/project/logs/app-2024-01.log' },
+                        { type: 'file_not_exists', path: '/home/project/logs/app-2024-02.log' },
+                        { type: 'file_not_exists', path: '/home/project/logs/app-2024-03.log' },
+                    ],
                     hints: [
                         { level: 1, text: 'find \u3067\u898B\u3064\u3051\u305F\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3057\u307E\u3057\u3087\u3046\u3002' },
-                        { level: 2, text: 'rm \u30B3\u30DE\u30F3\u30C9\u3067\u53E4\u3044\u6708\u6B21\u30ED\u30B0\u3092\u524A\u9664\u3057\u307E\u3057\u3087\u3046\u3002' },
+                        { level: 2, text: '前の find で表示されたファイル名を rm コマンドに指定して削除しましょう。' },
                         { level: 3, text: '\u300Crm app-2024-01.log app-2024-02.log app-2024-03.log\u300D\u3068\u5165\u529B\u3057\u3066Enter\u3092\u62BC\u3057\u3066\u304F\u3060\u3055\u3044\u3002' },
                     ],
+                    feedbacks: [
+                        { pattern: 'rm error.log', message: 'error.log は残すべきファイルです！削除するのは app-2024-*.log だけです。' },
+                        { pattern: 'rm access.log', message: 'access.log は残すべきファイルです！削除するのは app-2024-*.log だけです。' },
+                    ],
                 },
                 {
                     id: 'obj-07-04-03',
                     description: 'error.log \u3092\u6B8B\u3057\u3066\u3044\u308B\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B',
-                    checks: [{ type: 'output_contains', pattern: 'error.log' }],
+                    checks: [
+                        { type: 'command_executed', command: 'ls' },
+                        { type: 'output_contains', pattern: 'error.log' },
+                    ],
                     hints: [
                         { level: 1, text: '\u6B8B\u3059\u3079\u304D\u30D5\u30A1\u30A4\u30EB\u304C\u7121\u4E8B\u306B\u6B8B\u3063\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3057\u307E\u3057\u3087\u3046\u3002' },
                         { level: 2, text: 'ls \u30B3\u30DE\u30F3\u30C9\u3067\u73FE\u5728\u306E\u30D5\u30A1\u30A4\u30EB\u4E00\u89A7\u3092\u8868\u793A\u3057\u307E\u3057\u3087\u3046\u3002' },
@@ -409,6 +465,17 @@ export const story07 = {
                     ],
                 },
             ],
+            review: {
+                question: '大量のファイルを安全に削除するワークフローとして正しいのは？',
+                choices: [
+                    'rm * で全部削除してから必要なものを復元する',
+                    'find で削除対象を一覧表示して確認 → rm で対象だけを削除',
+                    '手当たり次第に削除する',
+                    'ディレクトリごと rm -rf で削除する',
+                ],
+                correctIndex: 1,
+                explanation: 'まず find で削除対象を検索・確認してから、rm で対象ファイルだけを削除するのが安全なワークフローです。「確認してから実行」が鉄則です。',
+            },
         },
     ],
 };