terminal-quest 1.2.1 → 1.3.0

package/dist/App.js

@@ -26,6 +26,10 @@ export function App() {
                 return _jsx(ProgressScreen, { progress: progress, onNavigate: navigateTo });
             case 'settings':
                 return _jsx(SettingsScreen, { onNavigate: navigateTo, onReset: resetAll });
+            default: {
+                const _exhaustive = screen;
+                return _jsx(TitleScreen, { onNavigate: navigateTo });
+            }
         }
     };
     return _jsx(Box, { flexDirection: "column", children: renderScreen() });

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

@@ -578,7 +578,7 @@ export const story00 = {
                     checks: [{ type: 'file_exists', path: '/home/watashi/photos/travel/memories.txt' }],
                     hints: [
                         { level: 1, text: '空のファイルを作るコマンドがあります。' },
-                        { level: 2, text: 'touch コマンドでファイルを作れます。フォルダ名/ファイル名 のように書くと、フォルダの中にファイルを作れます。/ は「の中の」という意味です。' },
+                        { level: 2, text: 'touch コマンドでファイルを作れます。フォルダ名/ファイル名 のように書くと、フォルダの中にファイルを作れます。/ は「の中の」という意味です。たとえば travel/memories.txt は「travel フォルダの中の memories.txt」ということです。' },
                         { level: 3, text: '「touch travel/memories.txt」と入力してみましょう。memories は思い出のことです。' },
                     ],
                     feedbacks: [
@@ -633,15 +633,15 @@ export const story00 = {
         {
             id: 'mission-00-05',
             title: 'いらないファイルを片付けよう',
-            description: '不要な一時ファイルを探し出して、削除しよう。',
-            goal: 'find でファイルを検索し、rm で不要ファイルを削除できるようになる',
+            description: 'もう使わない一時ファイル（.tmp）を探し出して、削除しよう。.tmp はパソコンが一時的に作ったファイルで、もう不要なものです。',
+            goal: 'find でファイルを名前で検索し、rm で不要ファイルを削除できるようになる',
             review: {
                 question: 'ファイルを名前で検索するコマンドはどれですか？',
                 choices: ['grep', 'find', 'ls', 'cat'],
                 correctIndex: 1,
                 explanation: 'find は、ファイルやフォルダを名前やタイプで検索するコマンドです。grep はファイルの中身を検索します。',
             },
-            narrative: 'パソコンの中に「.tmp」という拡張子の一時ファイルがたまっている。これは不要なファイルなので、探し出して片付けよう！',
+            narrative: 'パソコンの中に名前の最後が「.tmp」のファイルがたまっている。.tmp は「temporary（一時的）」の略で、パソコンが一時的に作ったいらないファイルだよ。ファイル名の「.」のあとの部分（.txt や .tmp など）はファイルの種類を表しているんだ。探し出して片付けよう！',
             initialCwd: '/home/watashi',
             initialFS: mission5FS,
             newCommands: ['rm', 'find'],
@@ -778,7 +778,7 @@ export const story00 = {
                     ],
                     hints: [
                         { level: 1, text: 'ファイルの行数や文字数を数えるコマンドがあります。' },
-                        { level: 2, text: '「Word Count」の略のコマンドで、-l オプションをつけると行数だけ表示できます。' },
+                        { level: 2, text: 'wc（Word Count の略）コマンドで数を数えられます。コマンドのあとに「-」から始まるオプション（追加の指示）をつけると動きが変わります。-l は「行数（Lines）だけ数えて」という追加の指示です。' },
                         { level: 3, text: '「wc -l report.txt」と入力してみましょう。-l は「行数だけを数える」という意味です。' },
                     ],
                 },
@@ -788,13 +788,13 @@ export const story00 = {
         {
             id: 'mission-00-08',
             title: '連絡先を整理しよう',
-            description: '連絡先データを並べ替えたり、重複を取り除いたりしてみよう。',
-            goal: 'sort、uniq、cut を使ってデータを加工・整理できるようになる',
+            description: '連絡先データを名前順に並べ替えたり、同じ人が2回登録されているのを取り除いたり、名前だけを取り出したりしてみよう。',
+            goal: 'sort で並べ替え、uniq で重複をまとめ、cut でほしい列だけを取り出せるようになる',
             review: {
                 question: '重複した行を取り除くために sort と組み合わせて使うコマンドはどれですか？',
                 choices: ['grep', 'cut', 'uniq', 'wc'],
                 correctIndex: 2,
-                explanation: 'uniq は、隣接する重複行を取り除くコマンドです。sort で並べ替えてから使うのがポイントです。',
+                explanation: 'uniq は、となり合った同じ行を1つにまとめるコマンドです。ただし、離れた場所にある同じ行には気づけません。だから先に sort で並べて、同じ行をとなりどうしにしてから uniq を使うのがコツです。',
             },
             narrative: '連絡先のファイル（contacts.csv）がぐちゃぐちゃで、同じ人が何回も登録されている。きれいに並べ替えて、重複を取り除こう！',
             initialCwd: '/home/watashi',
@@ -817,7 +817,7 @@ export const story00 = {
                     checks: [{ type: 'command_executed', command: 'uniq' }],
                     hints: [
                         { level: 1, text: '重複した行を取り除くコマンドがあります。' },
-                        { level: 2, text: 'uniq コマンドで重複行を取り除けます。ただし uniq は「隣り合った行」しかまとめないので、先に sort で並べてから使うのがコツです。' },
+                        { level: 2, text: 'uniq コマンドで同じ行を1つにまとめられます。ただし、uniq は「上の行と同じかどうか」しか見ないので、離れた場所にある同じ行には気づけません。だから先に sort で並べて、同じ行をとなりどうしにしてから使いましょう。' },
                         { level: 3, text: '「uniq contacts.csv」と入力してみましょう。' },
                     ],
                 },
@@ -829,8 +829,8 @@ export const story00 = {
                         { type: 'output_contains', pattern: '名前' },
                     ],
                     hints: [
-                        { level: 1, text: 'CSVの特定の列だけを切り出すコマンドがあります。' },
-                        { level: 2, text: 'cut コマンドで列を取り出せます。-d, は「カンマで区切る」、-f1 は「1列目を取り出す」という意味です。' },
+                        { level: 1, text: 'contacts.csv は「,」（カンマ）でデータが区切られています。この中から名前の部分だけを切り出すコマンドがあります。' },
+                        { level: 2, text: 'cut コマンドで列を取り出せます。-d, は「カンマで区切って」、-f1 は「1番目の列（名前）を取り出して」という追加の指示です。' },
                         { level: 3, text: '「cut -d, -f1 contacts.csv」と入力してみましょう。' },
                     ],
                 },
@@ -840,26 +840,26 @@ export const story00 = {
         {
             id: 'mission-00-09',
             title: '共有ファイルの設定',
-            description: 'ファイルの権限を設定して、スクリプトを実行できるようにしよう。',
-            goal: 'chmod で権限を変更し、パイプでコマンドを連携できるようになる',
+            description: 'ファイルには「読んでいい」「書き込んでいい」「動かしていい」の3つの許可があります。集計スクリプトに「動かしていい」の許可を追加しよう。',
+            goal: 'chmod でファイルの許可を変更し、プログラムを実行できるようになる',
             review: {
                 question: 'ファイルに実行権限を追加するコマンドはどれですか？',
                 choices: ['chown +x', 'chmod +x', 'cp +x', 'mv +x'],
                 correctIndex: 1,
-                explanation: 'chmod (Change Mode) はファイルの権限を変更するコマンドです。+x で実行権限を追加します。',
+                explanation: 'chmod (Change Mode) はファイルの許可を変更するコマンドです。+x の x は「execute（実行）」の頭文字で、「このファイルをプログラムとして動かしていいよ」という許可を追加します。',
             },
-            narrative: 'shared（共有）フォルダにある集計スクリプト（count.sh）を実行したいけど、実行する権限がない。権限を設定して使えるようにしよう！',
+            narrative: 'shared（共有）フォルダにある集計スクリプト（count.sh）を動かしたいけど、「動かしていい」の許可がまだ出ていない。パソコンではファイルごとに「読んでいい」「書き込んでいい」「動かしていい」の許可を設定できるんだ。chmod コマンドで「動かしていい」の許可を追加しよう！',
             initialCwd: '/home/watashi',
             initialFS: mission9FS,
             newCommands: ['chmod'],
             objectives: [
                 {
                     id: 'obj-00-09-01',
-                    description: '集計スクリプトに実行権限をつけよう（chmod コマンド）',
+                    description: '集計スクリプトに「動かしていい」の許可をつけよう（chmod コマンド）',
                     checks: [{ type: 'command_executed', command: 'chmod' }],
                     hints: [
-                        { level: 1, text: 'ファイルの権限（パーミッション）を変更するコマンドがあります。' },
-                        { level: 2, text: '「Change Mode」の略のコマンドで、+x をつけるとファイルを「実行してもいいよ」という許可を追加できます。プログラムを動かすときに必要です。' },
+                        { level: 1, text: 'ファイルの許可（できること）を変更するコマンドがあります。' },
+                        { level: 2, text: 'chmod（Change Mode の略）コマンドで、+x をつけると「このファイルを動かしていいよ」の許可を追加できます。x は「execute（実行）」の頭文字です。プログラム（.sh ファイルなど）を動かすときに必要です。' },
                         { level: 3, text: '「chmod +x shared/count.sh」と入力してみましょう。shared は共有フォルダ、count.sh は集計スクリプトです。' },
                     ],
                 },
@@ -879,15 +879,15 @@ export const story00 = {
         {
             id: 'mission-00-10',
             title: '変更履歴を管理しよう',
-            description: 'git を使ってレポートの変更履歴を確認してみよう。',
-            goal: 'git status と git log で変更の状態と履歴を確認できるようになる',
+            description: 'git（ギット）は「いつ・誰が・何を変えたか」を記録してくれるツールです。レポートの変更履歴を確認してみよう。',
+            goal: 'git status で今の状態を確認し、git log でこれまでの変更の記録（履歴）を見られるようになる',
             review: {
                 question: 'ファイルの変更状態を確認する git コマンドはどれですか？',
                 choices: ['git log', 'git status', 'git diff', 'git add'],
                 correctIndex: 1,
-                explanation: 'git status は、どのファイルが変更されたか、ステージされているかなどの現在の状態を表示します。',
+                explanation: 'git status は、「どのファイルが変更されたか」「まだ記録していない変更があるか」などの今の状態を表示します。',
             },
-            narrative: 'reports（レポート）フォルダでは git を使って変更履歴を管理している。どんな変更が行われたか確認してみよう！',
+            narrative: 'reports（レポート）フォルダでは git（ギット）を使って変更の記録を管理しているよ。git は「いつ・誰が・何を変えたか」をぜんぶ覚えてくれる便利なツールなんだ。どんな変更が行われたか確認してみよう！',
             initialCwd: '/home/watashi/reports',
             initialFS: mission10FS,
             newCommands: ['git'],

package/dist/data/stories/k1-treasure-hunt.js

@@ -841,15 +841,15 @@ export const storyK1 = {
         {
             id: 'mission-k1-08',
             title: '仲間リストを整理しよう',
-            description: 'party.csv（冒険者の名簿）をきれいに整理しよう！',
-            goal: 'sort、uniq、cut をつかってデータを整理できるようになる',
+            description: 'party.csv（冒険者の名簿）をきれいに整理しよう！このファイルはデータが「,」（コンマ）でくぎられているよ。',
+            goal: 'sort でならびかえ、uniq でおなじ行をまとめ、cut でほしい部分だけをとりだせるようになる',
             review: {
                 question: 'おなじ行をまとめてくれるコマンドはどれかな？',
                 choices: ['sort', 'uniq', 'cut', 'grep'],
                 correctIndex: 1,
-                explanation: 'uniq はとなりあうおなじ行をまとめるコマンドだよ。sort でならべてから uniq をつかうと、ぜんぶのおなじ行をまとめられるよ。',
+                explanation: 'uniq はとなりあうおなじ行を1つにまとめるコマンドだよ。でも、はなれた場所にあるおなじ行は気づけないんだ。だから先に sort でならべて、おなじ行をとなりどうしにしてから uniq をつかうのがコツだよ。',
             },
-            narrative: 'castle（古いお城）で party.csv（冒険者の名簿）を見つけた。でも同じ名前が何回も書いてある。きれいに整理して、どんな職業の仲間がいるか調べよう。',
+            narrative: 'castle（古いお城）で party.csv（冒険者の名簿）を見つけた。csv は「,」（コンマ）でデータをくぎって書くファイルだよ。でも同じ名前が何回も書いてある！きれいに整理して、どんな職業の仲間がいるか調べよう。',
             initialCwd: '/world/castle',
             initialFS: mission8FS,
             newCommands: ['sort', 'uniq', 'cut'],
@@ -891,7 +891,7 @@ export const storyK1 = {
                     ],
                     hints: [
                         { level: 1, text: 'とくていの部分だけきりだすコマンドがあるよ。' },
-                        { level: 2, text: '「cut」コマンドで「,」でくぎって2ばんめの部分をとりだせるよ。' },
+                        { level: 2, text: '「cut」コマンドで「,」（コンマ）でくぎって2ばんめの部分をとりだせるよ。-d, は「コンマでくぎる」、-f2 は「2ばんめをとりだす」という意味だよ。' },
                         {
                             level: 3,
                             text: '「cut -d, -f2 party.csv」とにゅうりょくしてね。party は冒険者名簿のことだよ。',
@@ -908,36 +908,36 @@ export const storyK1 = {
         {
             id: 'mission-k1-09',
             title: '封印を解こう',
-            description: 'ふういんされた seal.sh（呪文）をとけるようにして、魔法をつかおう！',
-            goal: 'chmod でけんげんをかえ、パイプで grep をつなげられるようになる',
+            description: 'seal.sh（封印の呪文）はプログラムだけど、いまは「動かしちゃダメ」になっている。chmod で「動かしてOK」にかえて、魔法の石から「光」をさがそう！',
+            goal: 'chmod でファイルを「動かしてもいいよ」にかえ、パイプ（|）で grep をつなげられるようになる',
             review: {
-                question: 'ファイルのけんげん（つかえるかどうか）をかえるコマンドはどれかな？',
+                question: 'ファイルを「動かしてもいいよ」にかえるコマンドはどれかな？',
                 choices: ['chown', 'chmod', 'mv', 'cp'],
                 correctIndex: 1,
-                explanation: 'chmod はファイルのけんげん（パーミッション）をかえるコマンドだよ。「change mode」のりゃくだよ。',
+                explanation: 'chmod はファイルの「できること」をかえるコマンドだよ。+x をつけると「プログラムとして動かしてOK」になるよ。「change mode」のりゃくだよ。',
             },
-            narrative: 'castle（古いお城）のおくで、ふういんされた seal.sh（封印の呪文）を見つけた！ふういんを解いて実行できるようにしよう。そして stone.txt（魔法の石）の中から「光の魔法」をさがしだそう。',
+            narrative: 'castle（古いお城）のおくで、seal.sh（封印の呪文）を見つけた！でも今は「動かしちゃダメ」のロックがかかっていて動かせない。chmod コマンドで「動かしてOK」にしてあげよう。それから stone.txt（魔法の石）にはたくさんの魔法が書いてあるよ。cat と grep をパイプ（|）でつなげて「光」の魔法だけをとりだそう！',
             initialCwd: '/world/castle',
             initialFS: mission9FS,
             newCommands: ['chmod'],
             objectives: [
                 {
                     id: 'obj-k1-09-01',
-                    description: 'seal.sh（封印の呪文）のふういんを解こう',
+                    description: 'chmod をつかって seal.sh を「動かしてOK」にしよう',
                     checks: [{ type: 'command_executed', command: 'chmod' }],
                     hints: [
-                        { level: 1, text: 'ファイルのけんげん（つかえるかどうか）をかえるコマンドがあるよ。' },
-                        { level: 2, text: '「chmod」コマンドで「+x」をつけると、実行できるようになるよ。' },
-                        { level: 3, text: '「chmod +x seal.sh」とにゅうりょくしてね。seal は封印の呪文のことだよ。' },
+                        { level: 1, text: 'ファイルを「動かしてもいいよ」にかえるコマンドがあるよ。' },
+                        { level: 2, text: '「chmod」コマンドで「+x」をつけると、プログラムとして動かせるようになるよ。x は「execute（じっこう）」の頭文字で、+x は「動かしてOK」という意味だよ。' },
+                        { level: 3, text: '「chmod +x seal.sh」とにゅうりょくしてね。seal は封印の呪文のことだよ。+x は「動かしてOK」のマークだよ。' },
                     ],
                     feedbacks: [
-                        { pattern: 'cat', message: 'cat はファイルの中身を読むコマンドだよ。ふういんを解く（けんげんをかえる）には、べつのコマンドをつかうよ。' },
-                        { pattern: 'rm', message: 'rm はファイルをけすコマンドだよ。ふういんを解くには、けんげんをかえるコマンドをつかおう。' },
+                        { pattern: 'cat', message: 'cat はファイルの中身を読むコマンドだよ。ファイルを「動かしてOK」にかえるには、べつのコマンドをつかうよ。' },
+                        { pattern: 'rm', message: 'rm はファイルをけすコマンドだよ。ファイルを「動かしてOK」にかえるには、べつのコマンドをつかおう。' },
                     ],
                 },
                 {
                     id: 'obj-k1-09-02',
-                    description: 'stone.txt（魔法の石）から「光」の魔法をさがそう',
+                    description: 'grep をつかって stone.txt から「光」の行だけとりだそう',
                     checks: [
                         { type: 'command_executed', command: 'grep' },
                         { type: 'output_contains', pattern: '光の魔法' },
@@ -957,15 +957,15 @@ export const storyK1 = {
         {
             id: 'mission-k1-10',
             title: '冒険の記録をつけよう',
-            description: 'gitをつかって、冒険のきろくをかくにんしよう！',
-            goal: 'git status と git log で変更のきろくをかくにんできるようになる',
+            description: 'git（ギット）は「いつ・なにを変えたか」をきろくするツールだよ。冒険のきろくをかくにんしよう！',
+            goal: 'git status でいまのじょうたいを見て、git log でこれまでのきろく（れきし）をかくにんできるようになる',
             review: {
                 question: 'いままでのきろく（ログ）を見るgitコマンドはどれかな？',
                 choices: ['git status', 'git log', 'git add', 'git diff'],
                 correctIndex: 1,
-                explanation: 'git log はいままでのへんこうのきろく（コミット）をひょうじするコマンドだよ。git status はいまのじょうたいをたしかめるコマンドだよ。',
+                explanation: 'git log はいままでの変更きろくをじゅんばんにひょうじするコマンドだよ。「いつ・だれが・なにをした」がわかるよ。git status はいまの状態をたしかめるコマンドだよ。',
             },
-            narrative: 'base（秘密基地）にもどってきた。冒険のきろくがgitでのこしてある。いままでの冒険をふりかえってみよう！',
+            narrative: 'base（秘密基地）にもどってきた。git（ギット）というべんりなツールで冒険のきろくがのこしてある。git は「いつ・なにを変えたか」をぜんぶおぼえてくれるツールだよ。いままでの冒険をふりかえってみよう！',
             initialCwd: '/world/base',
             initialFS: mission10FS,
             newCommands: ['git'],

package/dist/engine/CommandHandler.d.ts

@@ -7,11 +7,11 @@ export declare class CommandHandler {
     private executePipeline;
     private executeSingle;
     private extractRedirect;
-    private splitOnPipe;
+    splitOnPipe(input: string): string[];
     /**
      * Tokenize input string, handling single and double quotes.
      * Quoted strings preserve internal spaces. Quotes are removed from the result.
      */
-    private tokenize;
+    tokenize(input: string): string[];
 }
 //# sourceMappingURL=CommandHandler.d.ts.map

package/dist/engine/CommandHandler.js

@@ -54,7 +54,14 @@ export class CommandHandler {
         const finalArgs = stdin != null && stdin !== ''
             ? [...args, `__stdin__:${stdin}`]
             : args;
-        const result = commandFn(this.fs, finalArgs);
+        let result;
+        try {
+            result = commandFn(this.fs, finalArgs);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `${commandName}: ${msg}` };
+        }
         // Handle redirect
         if (redirect && !result.error) {
             try {

package/dist/engine/VirtualFS.js

@@ -210,6 +210,14 @@ export class VirtualFS {
         const srcNode = this.getNode(src);
         if (!srcNode)
             throw new Error(`No such file or directory: ${src}`);
+        const resolvedSrc = this.resolvePath(src);
+        const resolvedDest = this.resolvePath(dest);
+        if (resolvedDest === resolvedSrc) {
+            throw new Error(`'${src}' and '${dest}' are the same file`);
+        }
+        if (resolvedDest.startsWith(resolvedSrc + '/')) {
+            throw new Error(`Cannot move '${src}' to a subdirectory of itself`);
+        }
         const cloned = this.deepClone(srcNode);
         if (this.exists(dest) && this.isDirectory(dest)) {
             const srcParts = this.resolvePath(src).split('/').filter(Boolean);

package/dist/engine/commands/chmod.js

@@ -24,7 +24,8 @@ export function chmod(fs, args) {
         fs.setPermissions(filePath, newPerms);
     }
     catch (e) {
-        return { output: '', error: `chmod: ${e.message}` };
+        const msg = e instanceof Error ? e.message : String(e);
+        return { output: '', error: `chmod: ${msg}` };
     }
     return { output: '' };
 }

package/dist/engine/commands/cut.js

@@ -57,7 +57,8 @@ export function cut(fs, args) {
             content = fs.readFile(files[0]);
         }
         catch (e) {
-            return { output: '', error: `cut: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `cut: ${msg}` };
         }
     }
     else if (stdin !== undefined) {

package/dist/engine/commands/echo.js

@@ -1,4 +1,8 @@
 export function echo(_fs, args) {
+    const stdinIdx = args.findIndex(a => a.startsWith('__stdin__:'));
+    if (stdinIdx !== -1) {
+        args = [...args.slice(0, stdinIdx), ...args.slice(stdinIdx + 1)];
+    }
     return { output: args.join(' ') };
 }
 //# sourceMappingURL=echo.js.map

package/dist/engine/commands/git.js

@@ -181,7 +181,13 @@ function gitStash(fs, args) {
         if (!fs.exists(stashPath)) {
             return { output: '', error: 'No stash entries found.' };
         }
-        const entry = JSON.parse(fs.readFile(stashPath));
+        let entry;
+        try {
+            entry = JSON.parse(fs.readFile(stashPath));
+        }
+        catch {
+            return { output: '', error: 'error: corrupt stash entry' };
+        }
         // Restore state
         if (entry.status) {
             fs.writeFile('.git/status', entry.status);
@@ -207,8 +213,13 @@ function gitStash(fs, args) {
         for (let i = stashCount - 1; i >= 0; i--) {
             const stashPath = `.git/stash-stack/${i}`;
             if (fs.exists(stashPath)) {
-                const entry = JSON.parse(fs.readFile(stashPath));
-                lines.push(`stash@{${stashCount - 1 - i}}: WIP on ${entry.branch}`);
+                try {
+                    const entry = JSON.parse(fs.readFile(stashPath));
+                    lines.push(`stash@{${stashCount - 1 - i}}: WIP on ${entry.branch}`);
+                }
+                catch {
+                    lines.push(`stash@{${stashCount - 1 - i}}: (corrupt entry)`);
+                }
             }
         }
         return { output: lines.join('\n') };

package/dist/engine/commands/head.js

@@ -41,7 +41,8 @@ export function head(fs, args) {
             content = fs.readFile(files[0]);
         }
         catch (e) {
-            return { output: '', error: `head: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `head: ${msg}` };
         }
     }
     else if (stdin !== undefined) {

package/dist/engine/commands/index.js

@@ -6,8 +6,6 @@ import { grep } from './grep.js';
 import { cp } from './cp.js';
 import { echo } from './echo.js';
 import { help } from './help.js';
-import { hint } from './hint.js';
-import { clear } from './clear.js';
 import { git } from './git.js';
 import { mkdir } from './mkdir.js';
 import { mv } from './mv.js';
@@ -31,8 +29,6 @@ export const commandRegistry = {
     cp,
     echo,
     help,
-    hint,
-    clear,
     git,
     mkdir,
     mv,

package/dist/engine/commands/mkdir.js

@@ -23,7 +23,8 @@ export function mkdir(fs, args) {
             fs.mkdir(path, recursive);
         }
         catch (e) {
-            return { output: '', error: `mkdir: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `mkdir: ${msg}` };
         }
     }
     return { output: '' };

package/dist/engine/commands/mv.js

@@ -8,7 +8,8 @@ export function mv(fs, args) {
         fs.move(source, dest);
     }
     catch (e) {
-        return { output: '', error: `mv: ${e.message}` };
+        const msg = e instanceof Error ? e.message : String(e);
+        return { output: '', error: `mv: ${msg}` };
     }
     return { output: '' };
 }

package/dist/engine/commands/rm.js

@@ -40,7 +40,8 @@ export function rm(fs, args) {
         }
         catch (e) {
             if (!force) {
-                return { output: '', error: `rm: ${e.message}` };
+                const msg = e instanceof Error ? e.message : String(e);
+                return { output: '', error: `rm: ${msg}` };
             }
         }
     }

package/dist/engine/commands/sort.js

@@ -59,7 +59,8 @@ export function sort(fs, args) {
             content = fs.readFile(files[0]);
         }
         catch (e) {
-            return { output: '', error: `sort: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `sort: ${msg}` };
         }
     }
     else if (stdin !== undefined) {
@@ -83,8 +84,8 @@ export function sort(fs, args) {
         lines.sort((a, b) => {
             const ka = getKey(a);
             const kb = getKey(b);
-            const na = parseFloat(ka) || 0;
-            const nb = parseFloat(kb) || 0;
+            const na = isNaN(parseFloat(ka)) ? 0 : parseFloat(ka);
+            const nb = isNaN(parseFloat(kb)) ? 0 : parseFloat(kb);
             return na - nb;
         });
     }

package/dist/engine/commands/tail.js

@@ -41,7 +41,8 @@ export function tail(fs, args) {
             content = fs.readFile(files[0]);
         }
         catch (e) {
-            return { output: '', error: `tail: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `tail: ${msg}` };
         }
     }
     else if (stdin !== undefined) {

package/dist/engine/commands/touch.js

@@ -11,7 +11,8 @@ export function touch(fs, args) {
         fs.writeFile(filename, '');
     }
     catch (e) {
-        return { output: '', error: `touch: ${e.message}` };
+        const msg = e instanceof Error ? e.message : String(e);
+        return { output: '', error: `touch: ${msg}` };
     }
     return { output: '' };
 }

package/dist/engine/commands/uniq.js

@@ -27,7 +27,8 @@ export function uniq(fs, args) {
             content = fs.readFile(files[0]);
         }
         catch (e) {
-            return { output: '', error: `uniq: ${e.message}` };
+            const msg = e instanceof Error ? e.message : String(e);
+            return { output: '', error: `uniq: ${msg}` };
         }
     }
     else if (stdin !== undefined) {

package/dist/engine/commands/wc.js

@@ -44,7 +44,8 @@ export function wc(fs, args) {
                 content = fs.readFile(filename);
             }
             catch (e) {
-                return { output: '', error: `wc: ${e.message}` };
+                const msg = e instanceof Error ? e.message : String(e);
+                return { output: '', error: `wc: ${msg}` };
             }
             const lines = content === '' ? 0 : (content.match(/\n/g) || []).length;
             const words = content === '' ? 0 : content.split(/\s+/).filter(Boolean).length;

package/dist/screens/TerminalScreen.js

@@ -47,6 +47,7 @@ export function TerminalScreen({ storyId, missionIndex, onNavigate, onMissionCom
     const [currentHint, setCurrentHint] = useState(null);
     const [hintLevel, setHintLevel] = useState(0);
     const commandCountRef = useRef(0);
+    const missionCompleteTriggeredRef = useRef(false);
     const [cmdsHintShown, setCmdsHintShown] = useState(new Set());
     useInput((input, key) => {
         if (key.escape) {
@@ -95,6 +96,10 @@ export function TerminalScreen({ storyId, missionIndex, onNavigate, onMissionCom
             handleHintRequest();
             return;
         }
+        if (trimmed === 'clear') {
+            setOutputLines([]);
+            return;
+        }
         if (trimmed === 'objectives' || trimmed === 'obj') {
             mission.objectives.forEach((obj, i) => {
                 const done = completedObjectives.includes(obj.id);
@@ -141,10 +146,6 @@ export function TerminalScreen({ storyId, missionIndex, onNavigate, onMissionCom
             return;
         }
         const result = commandHandler.execute(trimmed);
-        if (result.output === 'CLEAR_SCREEN') {
-            setOutputLines([]);
-            return;
-        }
         if (result.error) {
             let errorText = result.error;
             if (course === 'kids' && errorText.endsWith(': command not found')) {
@@ -178,13 +179,15 @@ export function TerminalScreen({ storyId, missionIndex, onNavigate, onMissionCom
                 }
             }
         }
-        // Parse all commands in pipe chain for objective checking
-        const pipeSegments = trimmed.split('|').map(s => s.trim()).filter(s => s);
+        // Parse all commands in pipe chain for objective checking (quote-aware)
+        const pipeSegments = commandHandler.splitOnPipe(trimmed).map(s => s.trim()).filter(s => s);
         let allNewlyCompleted = [];
         for (const segment of pipeSegments) {
-            const parts = segment.split(/\s+/);
-            const cmd = parts[0];
-            const args = parts.slice(1);
+            const tokens = commandHandler.tokenize(segment);
+            if (tokens.length === 0)
+                continue;
+            const cmd = tokens[0];
+            const args = tokens.slice(1);
             const newlyCompleted = missionEngine.checkObjectives(cmd, args, result.output);
             allNewlyCompleted.push(...newlyCompleted);
         }
@@ -200,7 +203,8 @@ export function TerminalScreen({ storyId, missionIndex, onNavigate, onMissionCom
                 }
             }
             setCurrentHint(null);
-            if (missionEngine.isAllComplete()) {
+            if (missionEngine.isAllComplete() && !missionCompleteTriggeredRef.current) {
+                missionCompleteTriggeredRef.current = true;
                 const finalCount = commandCountRef.current;
                 setTimeout(() => {
                     onMissionComplete(storyId, mission.id, hintEngine.getTotalHintsUsed(), finalCount);

package/dist/state/ProgressStore.js

@@ -1,22 +1,42 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { initialProgress } from './GameState.js';
 const SAVE_DIR = join(homedir(), '.terminal-quest');
 const SAVE_FILE = join(SAVE_DIR, 'progress.json');
+let saveWarningShown = false;
+function migrateProgress(parsed) {
+    return {
+        completedStories: Array.isArray(parsed.completedStories) ? parsed.completedStories : [],
+        storyProgress: (parsed.storyProgress && typeof parsed.storyProgress === 'object') ? parsed.storyProgress : {},
+        totalCommandsExecuted: typeof parsed.totalCommandsExecuted === 'number' ? parsed.totalCommandsExecuted : 0,
+        totalHintsUsed: typeof parsed.totalHintsUsed === 'number' ? parsed.totalHintsUsed : 0,
+        achievements: Array.isArray(parsed.achievements) ? parsed.achievements : [],
+    };
+}
 export function loadProgress() {
     try {
         if (!existsSync(SAVE_FILE))
             return { ...initialProgress };
         const data = readFileSync(SAVE_FILE, 'utf-8');
         const parsed = JSON.parse(data);
-        // Migration: add achievements if missing
-        if (!parsed.achievements) {
-            parsed.achievements = [];
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('Invalid progress file format');
         }
-        return parsed;
+        return migrateProgress(parsed);
     }
-    catch {
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        process.stderr.write(`[terminal-quest] 進捗ファイルの読み込みに失敗しました: ${msg}\n` +
+            `新しい進捗データで開始します。\n`);
+        try {
+            if (existsSync(SAVE_FILE)) {
+                const backupPath = SAVE_FILE + '.backup.' + Date.now();
+                copyFileSync(SAVE_FILE, backupPath);
+                process.stderr.write(`[terminal-quest] バックアップを保存しました: ${backupPath}\n`);
+            }
+        }
+        catch { /* backup is best-effort */ }
         return { ...initialProgress };
     }
 }
@@ -26,9 +46,15 @@ export function saveProgress(progress) {
             mkdirSync(SAVE_DIR, { recursive: true });
         }
         writeFileSync(SAVE_FILE, JSON.stringify(progress, null, 2), 'utf-8');
+        saveWarningShown = false;
     }
-    catch {
-        // 保存失敗は無視（ゲーム継続可能）
+    catch (e) {
+        if (!saveWarningShown) {
+            const msg = e instanceof Error ? e.message : String(e);
+            process.stderr.write(`[terminal-quest] 進捗の保存に失敗しました: ${msg}\n` +
+                `進捗データが保持されない可能性があります。\n`);
+            saveWarningShown = true;
+        }
     }
 }
 export function resetProgress() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-quest",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "ストーリー駆動型ターミナルコマンド学習CLI - Learn terminal commands through interactive stories",
   "type": "module",
   "main": "dist/index.js",