pasta-check

name	pasta-check
description	pasta_check CLIツールのリファレンス。ゴーストリリースビルド（release サブコマンド）、将来的なテスト・検証コマンドを含む。USE FOR: pasta_check, pasta check, ghost release, ゴーストリリース, NAR作成, release.bat, release.ps1, pasta_check release, .nar, リリースビルド, ゴースト配布, updates.txt, build ghost, deploy ghost, publish ghost, リリース手順, pasta_check test, ゴースト検証. DO NOT USE FOR: pasta DSL文法（pasta-ghost-authoringを使用）, Lua API（pasta-lua-codingを使用）, crates.ioパブリッシュ（release-workflow specを参照）.
argument-hint	サブコマンド名（release等）やゴースト名、オプションを指定

pasta_check — ゴーストリリースツール

pasta_check はゴーストの配布パッケージ（.nar）を作成する CLI ツール。 ゴースト名やパスに依存しない汎用ツールであり、任意のゴーストに対して使える。

インストール

crates.io から cargo install でインストールする。

cargo install pasta_check

インストール後は pasta_check コマンドとして使える（~/.cargo/bin にパスが通っている前提）。

pasta_check CLI

基本構文

pasta_check <command> [options]
pasta_check --help
pasta_check --version

release サブコマンド

ゴースト開発フォルダーからリリースパッケージを作成する。

pasta_check release --target <path> --release <path> --nar <path> [--copy <path>]...

オプション	必須	説明
--target <path>	✅	ゴースト開発フォルダー（ghost/master 等を含むルート）
--release <path>	✅	リリース出力先フォルダー（毎回クリーンされる）
--nar <path>	✅	出力 NAR ファイルパス
--copy <path>		上書きコピー元フォルダー（複数指定可、後勝ち）

release の実行フロー（5ステップ）

[1/5] Preparing release folder   ← --release を削除して新規作成
[2/5] Copying target files       ← --target → --release に再帰コピー
[3/5] Applying overlay copies    ← --copy（指定があれば）上書きコピー
[4/5] Generating update files    ← updates.txt を自動生成
[5/5] Creating NAR archive       ← --release を ZIP 圧縮して --nar に出力

使用例

# 最小構成
pasta_check release `
  --target path/to/ghost `
  --release release/my-ghost `
  --nar release/my-ghost.nar

# オーバーレイ付き（ビルド成果物を上書き）
pasta_check release `
  --target path/to/ghost `
  --release release/my-ghost `
  --nar release/my-ghost.nar `
  --copy path/to/build-output `
  --copy path/to/extra-files

リリースワークフロー

ゴーストのフルリリースは 2 フェーズ構成。

[Setup Phase]                      [Release Phase]
  1. SHIORI DLL ビルド               4. pasta_check release
  2. ゴースト固有の成果物生成         5. バージョン確認
  3. DLL/スクリプトを開発フォルダーへ  6. リリース案内表示

• Setup Phase はゴースト固有の手順（release.ps1 等で実装）
• Release Phase は pasta_check が汎用的に処理

ディレクトリ構成例

以下はサンプルゴースト (hello-pasta) の例。実際のパスはゴーストごとに異なる。

workspace/
├── release.bat                          # ラッパースクリプト（任意）
├── release/
│   ├── {ghost-name}/                    # --release 出力先
│   │   ├── ghost/master/                # ゴースト本体
│   │   ├── shell/master/                # シェル（画像等）
│   │   ├── install.txt
│   │   └── updates.txt                  # 自動生成
│   └── {ghost-name}.nar                 # --nar 出力
└── crates/pasta_sample_ghost/
    ├── release.ps1                      # Setup + Release を統合したスクリプト
    └── ghosts/{ghost-name}/             # --target ゴースト開発フォルダー

技術仕様

SSP 仕様および NAR フォーマットの詳細:

• updates.txt の仕様 — SSP ネットワーク更新ファイル仕様
• NAR の仕様 — NAR (ZIP) パッケージ仕様

リリース後の手順

NAR 作成後は GitHub Release で配布:

gh release create v{VERSION} "release/{ghost-name}.nar" `
  --title "{ghost-name} v{VERSION}" `
  --notes-file release-notes.md

リリースノートのテンプレートは各ゴーストの RELEASE.md を参照。

トラブルシューティング

問題	原因	対処
pasta_shiori build failed	32bit ターゲット未インストール	rustup target add i686-pc-windows-msvc
pasta.dll not found	DLL ビルドをスキップしたが未ビルド	DLL ビルドを先に実行
pasta_check release failed	パス不正 or ディスク容量	エラーメッセージの詳細を確認
updates.txt が Shift_JIS でない	pasta_check のバグ	updates.txt 仕様と照合