hakorune/docs/development/roadmap/phases/phase-12.7

Phase 12.7 - 文法改革 + AI統合最適化

🚀 究極の挑戦: 文法革新 × 極限圧縮 = 90%コード削減！

📋 統合概要

Phase 12.7は3つの革命的な改革の段階的実装です：

Phase 12.7-A: 基礎文法改革（✅ 実装済み）

• 予約語15個への削減（peek, birth, continue統一）
• peek構文による分岐革命
• continue文の追加
• ?演算子（Result伝播）
• Lambda式（fn文法）
• フィールド型アノテーション（field: TypeBox）

Phase 12.7-B: ChatGPT5糖衣構文（✅ 基本完了／拡張はゲート計画）

• 基本（P0・実装済み、ゲート可）
  • パイプライン演算子（|>）
  • セーフアクセス（?.）とデフォルト値（??）
• 拡張（P1・段階適用、設計/ドキュメント整備済み）
  • デストラクチャリング（{x,y}, [a,b,...]）
  • 増分代入（+=, -=, *=, /=）
  • 範囲演算子（a .. b → Range(a,b)）
  • 高階関数演算子（/: map, \: filter, // reduce）
  • ラベル付き引数（key: value）

🎯 重要な設計方針：

• 使いたい人が使いたい糖衣構文を選択可能
• すべての糖衣構文は元のNyashコードに可逆変換可能
• 明示性と超圧縮の両立 - 用途に応じて使い分け

Phase 12.7-C: ANCP圧縮記法（📅 計画中）

• ANCP v1.0（48%削減）
• 極限糖衣構文（75%削減）
• 融合記法（90%削減）
• 可逆フォーマッター完備
• 参考: ancp-specs/ANCP-Reversible-Mapping-v1.md（12.7‑B subset の可逆化）
• nyfmt PoC: docs/tools/nyfmt/NYFMT_POC_ROADMAP.md / tools/nyfmt_smoke.sh

🎯 なぜPhase 12.7なのか？

タイミングの完璧さ

• Phase 12: TypeBox統合ABI完了（安定した基盤）
• Phase 12.5: MIR15最適化（コンパクトな中間表現）
• Phase 12.7: ANCP（AIとの架け橋）← ここ！
• Phase 13: ブラウザー革命（別の大きな挑戦）
• Phase 15: セルフホスティング（ANCPで書かれた超小型コンパイラ！）

戦略的価値

1. 即効性: 実装が比較的簡単で、すぐに効果が出る
2. 相乗効果: Phase 15のセルフホスティングと組み合わせて究極の圧縮
3. AI協働: Claude/ChatGPT/Gemini/Codexとの開発効率が劇的に向上

🌟 革命的インパクト

Phase 12.7-A: 実装済み機能（2025-09-04）

# Peek式 - パターンマッチング風分岐
local result = peek status {
    "success" => 200,
    "error" => 500,
    "pending" => 102,
    else => 404
}

# Continue文 - ループ制御
loop(i < 100) {
    if i % 2 == 0 {
        continue  # 偶数スキップ
    }
    process(i)
}

# ?演算子 - Result伝播
local config = readFile("app.json")?  # エラーなら早期return
local version = parseJSON(config)?.get("version")?

# Lambda式
local double = fn(x) { x * 2 }
array.map(fn(x) { x * x })

Phase 12.7-B: ChatGPT5糖衣構文（実装済みの例／拡張の草案）

# パイプライン演算子（|>）
local result = data
    |> normalize()
    |> transform()
    |> validate()?
    |> finalize()

# セーフアクセス（?.）とデフォルト値（??）
local name = user?.profile?.name ?? "Guest"

# デストラクチャリング
let {x, y} = point
let [first, second, ...rest] = array

# 増分代入
count += 1
total *= 1.1

# 高階関数演算子（記号による簡潔表現）
evens = nums \: {$_%2==0}     # filter: 偶数のみ
squares = nums /: {$_*$_}      # map: 二乗
sum = nums // {$1+$2}          # reduce: 合計

# ラベル付き引数
Http.request(
    url: "/api/data",
    method: "POST",
    headers: {"Content-Type": "application/json"},
    body: payload
)

Phase 12.7-C: ANCP記法（計画中）

// 通常のNyash（約100文字）
box NyashCompiler {
    compile(source) {
        local ast = me.parse(source)
        local mir = me.lower(ast)
        return me.codegen(mir)
    }
}

// ChatGPT5糖衣構文適用（約60文字） - 40%削減！
box NyashCompiler {
    compile(source) {
        return source |> me.parse |> me.lower |> me.codegen
    }
}

// ANCP記法（約30文字） - 70%削減！
$NyashCompiler{compile(s){r s|>m.parse|>m.lower|>m.codegen}}

// 夢の組み合わせ：
// Phase 15: 80k行 → 20k行（75%削減）
// + 糖衣構文: 20k行 → 12k行（40%削減）
// + ANCP: 12k行 → 6k行相当（50%削減）
// = 最終的に92.5%削減！世界一小さい実用コンパイラ！

AIコンテキスト革命

• GPT-4 (128k tokens): 通常2万行 → ANCP で4万行扱える！
• Claude (200k tokens): 通常4万行 → ANCP で8万行扱える！
• Nyash全体のソースコード がAIのコンテキストに収まる！

🎯 最重要ドキュメント

📚 実装者必読

• 🚀 ANCP実装計画（統合版） ← ⭐ START HERE! ⭐
• 📋 ANCP Token仕様書 v1 - ChatGPT5作成の最新仕様
• 🔧 実装チェックリスト

📐 ANCP仕様書

• 🔥 究極のAIコーディングガイド - 5層圧縮体系
• ⚡ 極限糖衣構文提案
• 🔄 糖衣構文フォーマッター
• 🔬 圧縮技術参考ライブラリ

📝 文法仕様書

• 📝 文法改革最終決定
• 📐 文法技術仕様書

🤖 AIアドバイザーフィードバック

• 📋 統合フィードバック - 全AIアドバイザーの知見
  • ChatGPT5実装アドバイス
  • Claude/Codex技術分析
  • Gemini革命的評価
  • 即座実装ガイド

📁 アーカイブ（検討過程）

• 🗃️ 過去の議論・検討資料

📊 主要成果物

Phase 12.7-A: 基礎文法改革（✅ 完了）

• ✅ 予約語15個確定（peek, birth, continue追加）
• ✅ peek構文実装完了
• ✅ continue文実装完了
• ✅ ?演算子（Result伝播）実装完了
• ✅ Lambda式（fn構文）実装完了
• ✅ フィールド型アノテーション実装完了

Phase 12.7-B: ChatGPT5糖衣構文（✅ 基本完了／拡張はゲート計画）

• 📅 パイプライン演算子（|>）
• 📅 セーフアクセス（?.）とデフォルト値（??）
• 📅 デストラクチャリング（パターン束縛）
• 📅 増分代入演算子（+=, -=, *=, /=）
• 📅 範囲演算子（..）
• 📅 高階関数演算子（/:, :, //）
• 📅 ラベル付き引数

Phase 12.7-C: ANCP圧縮記法（📅 計画中）

• ✅ ANCP v1.0仕様完成（48%圧縮）
• ✅ 極限糖衣構文設計（75%圧縮）
• ✅ 融合記法考案（90%圧縮）
• ✅ 可逆フォーマッター仕様完成
• 📅 統合ツール実装
• 📅 VSCode拡張

🔧 技術的アプローチ

記号マッピング（最適化版）

【高頻度・基本】
box      → $   # Box定義（毎回出現）
new      → n   # インスタンス生成
me       → m   # 自己参照（超頻出）
local    → l   # ローカル変数
return   → r   # 戻り値

【構造系】
from     → @   # 継承/デリゲーション
init     → #   # フィールド初期化
birth    → b   # コンストラクタ
static   → S   # 静的定義

【制御系】
if       → ?   # 条件分岐
else     → :   # else節
loop     → L   # ループ
override → O   # オーバーライド

🔄 可逆変換保証

すべての糖衣構文は双方向変換可能：

# フォーマッターによる自由な変換
nyash format --style=explicit code.hako   # 明示的記法へ
nyash format --style=sugar code.hako      # 糖衣構文へ
nyash format --style=ancp code.hako       # 極限圧縮へ

同じコードの3つの表現：

# 明示的（学習・デバッグ用）
result = users.filter(function(u) { return u.active }).map(function(u) { return u.name })

# 糖衣構文（通常開発用）
result = users \: {$_.active} /: {$_.name}

# ANCP圧縮（AI協働用）
r=u\:_.a/:_.n

実装優先順位

Phase 12.7-B: ChatGPT5糖衣構文（実装中）

優先度1: 即効性の高い演算子（1週間）

// tokenizer.rs に追加
PIPE,           // |> パイプライン
SAFE_ACCESS,    // ?. セーフアクセス
NULL_COALESCE,  // ?? デフォルト値
PLUS_ASSIGN,    // += 増分代入
MINUS_ASSIGN,   // -= 減分代入
// etc...

優先度2: パイプラインとセーフアクセス（2週間）

// パイプライン: x |> f → f(x)
// セーフアクセス: x?.y → x != null ? x.y : null
// デフォルト値: x ?? y → x != null ? x : y

優先度3: デストラクチャリング（3週間）

// オブジェクト: let {x, y} = point
// 配列: let [a, b, ...rest] = array
// MIR変換: 複数のLoad命令に展開

Phase 12.7-C: ANCP圧縮記法（計画中）

Phase 1: 基本トランスコーダー（1週間）

pub struct AncpTranscoder {
    mappings: HashMap<&'static str, &'static str>,
    sugar_enabled: bool,  // 糖衣構文も含めて圧縮
}

Phase 2: スマート変換（2週間）

• コンテキスト認識（文字列内は変換しない）
• 空白・コメント保持
• エラー位置マッピング

Phase 3: ツール統合（2週間）

• VSCode拡張（ホバーで元のコード表示）
• CLIツール（--format=ancp オプション）
• スモークテスト自動ANCP化

🔗 関連ドキュメント

• ANCP技術仕様
• 実装計画
• AI統合ガイド
• 元のアイデア文書

📅 実施スケジュール

Phase 12.7-A（✅ 完了）

• ✅ peek式、continue文、?演算子、Lambda式
• ✅ フィールド型アノテーション
• ✅ birth統一、予約語15個確定

Phase 12.7-B（🔄 実装中）

Week 1-2: 基本演算子

• 基本（P0・実装済み、ゲート可）
  • パイプライン演算子（|>）
  • セーフアクセス（?.）とデフォルト値（??）
• 増分代入演算子（+=, -=等）

Week 3-4: 高度な構文

• デストラクチャリング（{}, []）
• 範囲演算子（..）
• 高階関数演算子（/:, :, //）

Week 5: 統合・最適化

• ラベル付き引数
• MIR変換最適化
• テストスイート完成

Phase 12.7-C（📅 計画中）

• Week 1: 基本トランスコーダー実装
• Week 2: パーサー統合・往復テスト
• Week 3: ツール実装（CLI/VSCode）
• Week 4: AI連携・最適化

🎨 糖衣構文の使い分けガイド

用途別推奨レベル

用途	推奨記法	理由
学習・チュートリアル	明示的	動作が明確
通常の開発	基本糖衣	バランスが良い
コードレビュー	明示的〜基本糖衣	可読性重視
AI協働開発	全糖衣〜ANCP	コンテキスト最大化
セルフホスティング	ANCP	極限圧縮必須

プロジェクト設定例

# nyash.toml
[syntax]
# none: 糖衣構文なし（明示的のみ）
# basic: 基本的な糖衣構文（+=, ?., ??）
# full: すべての糖衣構文（高階関数演算子含む）
# ancp: ANCP記法も許可
sugar_level = "full"

# 高階関数演算子の有効化
high_order_operators = true

# 可逆変換の検証（保存時に自動チェック）
verify_reversible = true

💡 期待される成果

定量的

• Phase 12.7-B（糖衣構文）: コード削減率 40-50%
• Phase 12.7-C（ANCP）: さらに50-60%削減
• 総合効果: 最大92.5%のコード削減
• AI開発効率: 3-5倍向上
• コンテキスト容量: 10倍に拡大

定性的（追加）

• 選択の自由: 開発者が好きな記法を選べる
• 可逆性保証: いつでも別の形式に変換可能
• 段階的導入: プロジェクトごとに糖衣レベルを調整

定性的

• 可読性向上: パイプライン演算子で処理フローが明確に
• 安全性向上: セーフアクセスでnullエラー激減
• 表現力向上: 高階関数演算子で関数型プログラミングが簡潔に
• AIとの親和性: より多くのコードをAIが一度に理解可能
• 学習曲線: 他言語経験者にとって馴染みやすい構文

🌟 夢の実現

Phase 15との究極コンボ

// 通常のセルフホスティングコンパイラ
box Compiler {
    compile(source) {
        local ast = me.parser.parse(source)
        local mir = me.lowerer.transform(ast)
        local code = me.backend.generate(mir)
        return code
    }
}

// ChatGPT5糖衣構文適用版
box Compiler {
    compile(source) {
        return source 
            |> me.parser.parse
            |> me.lowerer.transform
            |> me.backend.generate
    }
}

// ANCP記法（究極形態）
$Compiler{compile(s){r s|>m.parser.parse|>m.lowerer.transform|>m.backend.generate}}

これが「世界一美しい箱」の究極形態にゃ！

ChatGPT5糖衣構文によるコード例の変革

# Before: ネストした関数呼び出し（読みづらい）
result = finalize(validate(transform(normalize(data))))

# After: パイプライン（処理の流れが明確）
result = data |> normalize |> transform |> validate |> finalize

# Before: null安全でない（実行時エラーの危険）
name = user.profile.name

# After: セーフアクセス（null安全）
name = user?.profile?.name ?? "Guest"

# Before: 冗長な配列処理
evens = []
for x in numbers {
    if x % 2 == 0 {
        evens.push(x * x)
    }
}

# After: 高階関数演算子（簡潔で宣言的）
evens = numbers \: {$_%2==0} /: {$_*$_}

🚀 なぜ今すぐ始めるべきか

1. AI時代の必須技術: コンテキスト制限との戦い
2. 開発効率の即効薬: 今すぐ効果を実感
3. Nyashの差別化要因: 他言語にない強み

「コードも箱に入れて、小さく美しく」- ANCP Philosophy

---

Phase 12.7は、Nyashを真のAI時代のプログラミング言語にする重要な一歩です。