hakorune/docs/development/roadmap/phases/phase-11.5/FIRST-FIVE-APPS.md

# 🚀 First Five Apps - Nyashの実力を証明する最初の5本

## 🎯 概要
Phase 11.5完了を待たずに、**今すぐ作れる**実用アプリ5本で、Nyashの産業レベルの完成度を世に示します。
すべて「Everything is Box／PluginInvoke」で統一実装し、VM/JIT/AOT/WASMの全バックエンドで動作確認します。

## 📋 アプリケーション一覧

### 1. ny-echo（最小CLI）- 基本I/O検証
**目的**: I/O・StringBoxの道通し確認

```nyash
// apps/ny-echo/main.nyash
static box Main {
    main(args) {
        local console = new ConsoleBox()
        local options = parseArgs(args)
        
        loop(true) {
            local input = console.readLine()
            if input == null { break }
            
            local output = input
            if options.get("upper") {
                output = input.toUpperCase()
            } else if options.get("lower") {
                output = input.toLowerCase()
            }
            
            console.log(output)
        }
    }
}
```

**受入基準**:
- [ ] VM/JIT/AOT/GCオン・オフすべてでtrace_hash一致
- [ ] 100万行処理で性能劣化なし
- [ ] メモリリークなし（GCカウンター確認）

### 2. ny-jsonlint（Python連携デモ）- プラグイン統合
**目的**: PyRuntimeBox/PyObjectBox経由のPluginInvoke検証

```nyash
// apps/ny-jsonlint/main.nyash
static box Main {
    init { py, console }
    
    main(args) {
        me.py = new PyRuntimeBox()
        me.console = new ConsoleBox()
        
        local filename = args.get(1)
        if filename == null {
            me.console.error("Usage: ny-jsonlint <file.json>")
            return 1
        }
        
        local file = new FileBox()
        file.open(filename, "r")
        local content = file.read()
        file.close()
        
        local result = me.py.eval("
import json
try:
    json.loads(content)
    'OK'
except Exception as e:
    f'NG: {str(e)}'
", new MapBox().set("content", content))
        
        me.console.log(result)
        return result.startsWith("OK") ? 0 : 1
    }
}
```

**受入基準**:
- [ ] OS差なく実行（Windows/Linux/macOS）
- [ ] --sealedモードで完全再現可能
- [ ] 大規模JSON（10MB）でも安定動作

### 3. ny-array-bench（性能デモ）- ベンチマーク基準
**目的**: ArrayBox map/reduce、StatsBox導入、性能可視化

```nyash
// apps/ny-array-bench/main.nyash
static box Main {
    init { stats }
    
    main(args) {
        me.stats = new StatsBox()
        local sizes = [1000, 10000, 100000]
        
        loop(size in sizes) {
            me.benchArrayOps(size)
        }
        
        // 結果をJSON出力（CI集計用）
        local result = me.stats.toJSON()
        print(result)
    }
    
    benchArrayOps(size) {
        local array = new ArrayBox()
        
        // 1. 配列生成
        me.stats.startTimer("create_" + size)
        loop(i < size) {
            array.push(i)
        }
        me.stats.endTimer("create_" + size)
        
        // 2. map操作
        me.stats.startTimer("map_" + size)
        local doubled = array.map(|x| x * 2)
        me.stats.endTimer("map_" + size)
        
        // 3. reduce操作
        me.stats.startTimer("reduce_" + size)
        local sum = doubled.reduce(|a, b| a + b, 0)
        me.stats.endTimer("reduce_" + size)
        
        // VM基準の相対性能を記録
        me.stats.recordRelative("vm", 1.0)
        if IS_JIT { me.stats.recordRelative("jit", SPEEDUP) }
        if IS_AOT { me.stats.recordRelative("aot", SPEEDUP) }
    }
}
```

**受入基準**:
- [ ] VM=1.0x基準でJIT/AOTの倍率表示
- [ ] fallbacks=0（完全最適化）
- [ ] 結果JSON自動出力（CI集計可能）

### 4. ny-filegrep（実用ミニ）- ファイルI/O実用例
**目的**: BytesBox/FileBox（プラグイン）I/O、実用的なツール

```nyash
// apps/ny-filegrep/main.nyash
static box Main {
    init { pattern, recursive, results }
    
    main(args) {
        me.parseArgs(args)
        me.results = new ArrayBox()
        
        local path = args.getLast() || "."
        me.searchPath(path)
        
        // 結果表示
        loop(result in me.results) {
            print(result)
        }
        
        return me.results.length() > 0 ? 0 : 1
    }
    
    searchPath(path) {
        local file = new FileBox()
        
        if file.isDirectory(path) {
            if me.recursive {
                local entries = file.listDir(path)
                loop(entry in entries) {
                    me.searchPath(path + "/" + entry)
                }
            }
        } else {
            me.searchFile(path)
        }
    }
    
    searchFile(filepath) {
        local file = new FileBox()
        file.open(filepath, "r")
        
        local lineNum = 0
        loop(true) {
            local line = file.readLine()
            if line == null { break }
            
            lineNum = lineNum + 1
            if line.contains(me.pattern) {
                me.results.push(filepath + ":" + lineNum + ":" + line)
            }
        }
        
        file.close()
    }
}
```

**受入基準**:
- [ ] Windows/Linux/macOSで同一結果
- [ ] 大規模ディレクトリ（1万ファイル）対応
- [ ] メモリ効率的（ストリーム処理）

### 5. ny-http-hello（WASM/ネイティブ両対応）- Web実用例
**目的**: NetBox（プラグイン）とイベントループ、FutureBox活用

```nyash
// apps/ny-http-hello/main.nyash
static box Main {
    init { server, running }
    
    main(args) {
        local port = args.get(1) || "8080"
        me.server = new HttpServerBox()
        me.running = true
        
        // シグナルハンドラー設定
        registerSignal("SIGINT", || me.stop())
        
        // サーバー起動
        me.server.start(port.toInteger())
        print("Server listening on http://localhost:" + port)
        
        // リクエストループ
        loop(me.running) {
            nowait request = me.server.accept()
            me.handleRequest(wait request)
        }
        
        me.server.stop()
        return 0
    }
    
    handleRequest(request) {
        local response = new HttpResponseBox()
        
        if request.path() == "/" {
            response.setStatus(200)
            response.setHeader("Content-Type", "text/plain")
            response.write("Hello from Nyash!")
        } else {
            response.setStatus(404)
            response.write("Not Found")
        }
        
        request.respond(response)
    }
    
    stop() {
        print("Shutting down...")
        me.running = false
    }
}
```

**受入基準**:
- [ ] 100req/s程度のスモーク通過
- [ ] 停止シグナルでクリーンfini
- [ ] WASMビルドでも動作（制限付き）

## 🎯 実装優先順位

1. **ny-echo** - 最小実装、CI基盤確立
2. **ny-array-bench** - 性能基準確立
3. **ny-jsonlint** - プラグイン統合実証
4. **ny-filegrep** - 実用性実証
5. **ny-http-hello** - Web対応実証

## 📊 成功指標

### 全体指標
- [ ] 5アプリすべてがVM/JIT/AOTで動作
- [ ] CIでの自動テスト確立
- [ ] ドキュメント・サンプル完備

### 性能指標
- [ ] JIT: VMの5倍以上高速
- [ ] AOT: VMの10倍以上高速
- [ ] メモリ使用量: 同等機能のPython比50%以下

### 品質指標
- [ ] ゼロクラッシュ（1000回実行）
- [ ] メモリリークなし（長時間実行）
- [ ] プラットフォーム差異なし

## 🚀 配布戦略

### リリース形式
```
nyash-apps-v1.0/
├── bin/
│   ├── ny-echo[.exe]
│   ├── ny-jsonlint[.exe]
│   ├── ny-array-bench[.exe]
│   ├── ny-filegrep[.exe]
│   └── ny-http-hello[.exe]
├── examples/
│   └── *.nyash (ソースコード)
├── benchmarks/
│   └── results.json
└── README.md
```

### 展開先
- GitHub Releases
- Homebrew (macOS)
- Scoop (Windows)
- Docker Hub (コンテナ版)

これで「30日で作った言語」の実力を世界に示せます！🎉