hakorune/docs/private/papers/paper-f-self-parsing-db/reversible-conversion.md

Phase 21: ソースコード⇔データベース完全可逆変換システム

📋 概要

データベース駆動開発の最大の課題であるGit互換性を、完全可逆変換によって根本的に解決する革新的アプローチ。 ソースコードとデータベースを自在に行き来できることで、両方の利点を最大限に活用する。

🎯 核心的なアイデア

ソースコード（.nyash） ⇔ データベース（SQLite）
       ↓                    ↓
    Git管理             高速リファクタリング
    エディタ編集         構造化分析
    既存ツール互換       AI最適化

重要な原則：

• ソースコード → DB → ソースコードで100%元に戻る（情報の欠落なし）
• 開発者は好きな方式（ファイルまたはDB）を自由に選択可能
• Git運用は完全に従来通り（テキストファイルとしてコミット）

🏗️ 技術設計

1. 完全可逆変換の要件

box ReversibleConverter {
    // 変換の基本原則
    verify(sourceCode) {
        local db = me.sourceToDb(sourceCode)
        local restored = me.dbToSource(db)
        return sourceCode == restored  // 必ずtrue
    }
}

2. メタデータの完全保存

-- コード構造
CREATE TABLE code_structure (
    id INTEGER PRIMARY KEY,
    entity_type TEXT, -- 'box', 'method', 'field'
    entity_id INTEGER,
    source_order INTEGER,
    indentation_level INTEGER,
    line_start INTEGER,
    line_end INTEGER,
    column_start INTEGER,
    column_end INTEGER
);

-- スタイル情報
CREATE TABLE style_metadata (
    id INTEGER PRIMARY KEY,
    entity_id INTEGER,
    whitespace_before TEXT,
    whitespace_after TEXT,
    line_endings TEXT, -- '\n' or '\r\n'
    indentation_style TEXT, -- 'space' or 'tab'
    indentation_width INTEGER
);

-- コメント保存
CREATE TABLE comments (
    id INTEGER PRIMARY KEY,
    entity_id INTEGER,
    comment_type TEXT, -- 'line', 'block', 'doc'
    content TEXT,
    position TEXT, -- 'before', 'after', 'inline'
    line_number INTEGER,
    column_number INTEGER
);

-- 元のソース（差分検証用）
CREATE TABLE original_sources (
    file_path TEXT PRIMARY KEY,
    content_hash TEXT,
    full_content TEXT,
    last_synced TIMESTAMP
);

3. 変換アルゴリズム

ソース → DB

box SourceToDbConverter {
    convert(filePath, sourceCode) {
        // 1. AST解析
        local ast = Parser.parseWithFullInfo(sourceCode)
        
        // 2. 構造抽出
        local boxes = me.extractBoxes(ast)
        local methods = me.extractMethods(ast)
        local dependencies = me.analyzeDependencies(ast)
        
        // 3. メタデータ抽出
        local metadata = {
            comments: me.extractComments(sourceCode),
            whitespace: me.extractWhitespace(sourceCode),
            style: me.detectCodingStyle(sourceCode),
            positions: me.mapSourcePositions(ast)
        }
        
        // 4. DB保存（トランザクション）
        me.db.transaction {
            me.saveStructure(boxes, methods)
            me.saveMetadata(metadata)
            me.saveDependencies(dependencies)
            me.saveOriginal(filePath, sourceCode)
        }
    }
}

DB → ソース

box DbToSourceConverter {
    convert(filePath) {
        // 1. 構造読み込み
        local structure = me.db.loadStructure(filePath)
        local metadata = me.db.loadMetadata(filePath)
        
        // 2. ソース再構築
        local builder = new SourceBuilder(metadata.style)
        
        for entity in structure.entities {
            // 元の位置情報を使って再配置
            builder.addEntity(entity, metadata.positions[entity.id])
            
            // コメントの復元
            for comment in metadata.comments[entity.id] {
                builder.addComment(comment)
            }
            
            // 空白の復元
            builder.applyWhitespace(metadata.whitespace[entity.id])
        }
        
        return builder.toString()
    }
}

4. スタイルの扱い

box StylePreserver {
    modes: {
        EXACT: "完全保持",      // 空白・改行すべて元通り
        NORMALIZE: "正規化",    // フォーマッタ適用
        HYBRID: "ハイブリッド"  // コメント保持＋コード正規化
    }
    
    preserveStyle(source, mode) {
        switch mode {
            case EXACT:
                return me.captureEverything(source)
            case NORMALIZE:
                return me.formatCode(source)
            case HYBRID:
                return me.preserveComments(me.formatCode(source))
        }
    }
}

🔄 同期メカニズム

1. リアルタイム同期

box FileSyncDaemon {
    watchers: MapBox
    
    birth() {
        me.watchers = new MapBox()
    }
    
    watch(directory) {
        local watcher = new FileWatcher(directory)
        
        watcher.on("change") { event ->
            if event.file.endsWith(".nyash") {
                me.syncFileToDb(event.file)
            }
        }
        
        watcher.on("db_change") { event ->
            if not event.fromFile {
                me.syncDbToFile(event.entity)
            }
        }
        
        me.watchers.set(directory, watcher)
    }
}

2. Git統合

# .git/hooks/pre-commit
#!/bin/bash
nyash sync --db-to-files --verify

# .git/hooks/post-checkout  
#!/bin/bash
nyash sync --files-to-db --incremental

# .git/hooks/post-merge
#!/bin/bash
nyash sync --files-to-db --full

3. 差分最適化

-- 変更追跡
CREATE TABLE sync_status (
    entity_id INTEGER PRIMARY KEY,
    file_modified TIMESTAMP,
    db_modified TIMESTAMP,
    sync_status TEXT, -- 'synced', 'file_newer', 'db_newer', 'conflict'
    last_sync_hash TEXT
);

-- 差分計算の高速化
CREATE INDEX idx_sync_status ON sync_status(sync_status, file_modified);

🚀 実装段階

Phase 1: 基本的な可逆変換（1ヶ月）

• Box/メソッドレベルの変換
• コメントなし、インデント固定
• 単体テストで100%可逆性検証

Phase 2: メタデータ保持（1ヶ月）

• コメントの位置と内容を保存
• インデントスタイルの保持
• 改行コードの維持

Phase 3: 完全なスタイル保存（1ヶ月）

• 任意の空白パターン対応
• コーディングスタイルの自動検出
• チーム規約との調整機能

Phase 4: 高度な同期（2ヶ月）

• 増分同期アルゴリズム
• コンフリクト解決UI
• パフォーマンス最適化

📊 利点の整理

開発者にとって

• 選択の自由: ファイル編集もDB操作も可能
• 既存ツール互換: VSCode、Vim、Git等すべて使える
• 高速リファクタリング: 必要な時だけDB機能を活用

システムにとって

• Git完全互換: 通常のテキストファイルとして管理
• 増分コンパイル: DB側で依存関係を高速解析
• AI連携強化: 構造化データで学習効率UP

チームにとって

• 移行リスクなし: 段階的導入が可能
• レビュー互換: PRは従来通りのテキスト差分
• 柔軟な運用: プロジェクト毎に最適な方式を選択

🎯 成功の指標

1. 完全可逆性: 1000ファイルで往復変換してもバイト単位で一致
2. パフォーマンス: 1000行のファイルを100ms以内で変換
3. 互換性: 既存のNyashプロジェクトがそのまま動作
4. 開発者満足度: 90%以上が「便利」と評価

🔮 将来の拡張

意味的な可逆変換

• コードの意味を保ちながらスタイルを自動最適化
• チーム規約への自動適応
• リファクタリング履歴の保存

マルチビュー編集

// 同じコードを異なる視点で編集
- ファイルビュー: 従来のテキストエディタ
- 構造ビュー: Box/メソッドのツリー表示
- 依存ビュー: グラフィカルな関係表示
- クエリビュー: SQLで直接操作

バージョン管理の革新

• 意味的な差分表示（「名前を変更」vs「全行変更」）
• 構造認識マージ（メソッド単位での自動解決）
• リファクタリング履歴の永続化

📝 実装優先順位

1. コア変換エンジン: 可逆性の証明
2. メタデータ設計: 完全な情報保存
3. 同期デーモン: リアルタイム連携
4. 開発ツール: CLI/IDE統合
5. 最適化: パフォーマンスチューニング

---

この可逆変換システムにより、データベース駆動開発の利点を最大化しながら、既存の開発フローとの完全な互換性を実現できるにゃ！