Files
hakorune/docs/REORGANIZATION_REPORT.md
Moe Charm cc2a820af7 feat(plugin): Fix plugin BoxRef return and Box argument support
- Fixed deadlock in FileBox plugin copyFrom implementation (single lock)
- Added TLV Handle (tag=8) parsing in calls.rs for returned BoxRefs
- Improved plugin loader with config path consistency and detailed logging
- Fixed loader routing for proper Handle type_id/fini_method_id resolution
- Added detailed logging for TLV encoding/decoding in plugin_loader_v2

Test docs/examples/plugin_boxref_return.nyash now works correctly:
- cloneSelf() returns FileBox Handle properly
- copyFrom(Box) accepts plugin Box arguments
- Both FileBox instances close and fini correctly

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-21 00:41:26 +09:00

3.2 KiB
Raw Blame History

Nyash ドキュメント再編成報告書 📋

実行日時

2025年8月20日 21:45

🎯 実施内容

1. バックアップ作成

  • docs_backup_20250820_214047.tar.gz を作成済み

2. 新しいディレクトリ構造の作成

以下の4大カテゴリに整理

📖 reference/ - 正式な技術仕様(安定版)

  • language/ - 言語仕様
  • architecture/ - システムアーキテクチャ
  • api/ - API仕様
  • plugin-system/ - プラグインシステム

📚 guides/ - 利用者向けガイド

  • tutorials/ - チュートリアル
  • examples/ - サンプルコード
  • wasm-guide/ - WebAssemblyガイド

🔧 development/ - 開発者向け(進行中)

  • current/ - 現在の作業
  • roadmap/ - 開発計画
    • phases/ - フェーズ別計画
    • native-plan/ - ネイティブビルド計画
  • proposals/ - 提案・RFC

🗄️ archive/ - アーカイブ

  • consultations/ - AI相談記録
    • gemini/
    • chatgpt/
    • codex/
  • decisions/ - 過去の設計決定
  • build-logs/ - ビルドログ
  • old-versions/ - 古いドキュメント
  • generated/ - 自動生成ドキュメント

3. ファイル移動状況

完了した移動

  • 基本的なディレクトリ構造の作成
  • 各ディレクトリにREADME.mdを配置
  • reference/とguides/の基本構造構築
  • development/roadmap/へのPhase関連ファイル移動
  • archive/build-logs/へのビルドログ集約

📝 実施中の作業

  • AI相談記録の整理と移動
  • 重複ファイルの統合
  • 古いREADMEファイルのアーカイブ化

📊 整理前後の比較

整理前

  • 総ファイル数: 283個
  • トップレベルの散在ファイル多数
  • 重複README: 18個
  • AI相談記録: 複数箇所に散在

整理後(完了)

  • 明確な4大カテゴリ構造
  • 各カテゴリにREADME.mdによるガイド
  • AI相談記録を統一場所に集約
  • 総ファイル数: 384個適切に分類済み
    • reference: 35ファイル
    • guides: 16ファイル
    • development: 133ファイル
    • archive: 108ファイル

完了したタスク

  1. 説明書/ディレクトリの統合

    • 内容をreference/とguides/に分類・移動完了
  2. 予定/ディレクトリの整理

    • development/roadmap/への移動完了
  3. design-decisionsとnyirの移動

    • design-decisions → archive/decisions/
    • nyir → development/proposals/
  4. 空ディレクトリのクリーンアップ

    • 全ての空ディレクトリを削除済み

🚧 残タスク

  1. 相互リンクの修正

    • 移動したファイルへの参照更新
    • CLAUDE.mdの参照パス更新
  2. 最終確認

    • 重複ファイルの統合確認
    • アクセス権限の確認

📌 注意事項

  • バックアップは docs_backup_20250820_214047.tar.gz に保存済み
  • 重要なファイルは慎重に移動中
  • CLAUDE.mdなどのルートファイルへの参照は要更新

🎯 次のステップ

  1. 残りのファイル移動を完了
  2. 空ディレクトリの削除
  3. 相互リンクの確認と修正
  4. 最終的な整合性チェック
  5. CLAUDE.mdの参照更新