pasta_check

ゴースト（「伺か」デスクトップマスコット）の配布パッケージ（.nar）と SSP ネットワーク更新ファイル（updates.txt）を作成する CLI ツールです。

ゴースト名やパスに依存しない汎用ツールであり、任意のゴーストに対して使えます。

インストール

cargo install pasta_check

使い方

基本構文

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

release サブコマンド

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

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

実行フロー（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

仕様メモ

updates.txt（SSP ネットワーク更新・Version 3 形式）

• 1 行目: charset,UTF-8
• 以降: file,<path>\x01<md5>\x01size=<bytes>\x01date=<YYYY-MM-DDTHH:MM:SS>\x01 （CRLF 区切り）
• エントリはパスの辞書順でソートされる（決定的出力）
• ghost/master/ が存在する場合は同内容の updates.txt をそこにもコピーする
• 一覧から除外: ディレクトリ profile/・var/、ファイル updates2.dau・updates.txt・developer_options.txt

NAR（ZIP）封入規則

• profile/ ディレクトリは封入しない（ユーザーデータ・フレームワーク自己展開先の保護）
• シンボリックリンクはコピー・封入ともにスキップする
• ZIP エントリ名の .. コンポーネントは常時実行時検査で拒否する（パストラバーサル防御）

ソース構成

pasta_check/
├── Cargo.toml
├── src/
│   ├── main.rs          # CLI 引数解析（lexopt）・ディスパッチ
│   ├── release.rs       # release サブコマンド（5ステップパイプライン）
│   ├── copy.rs          # 再帰コピー・release フォルダー初期化
│   ├── update_files.rs  # updates.txt 生成（MD5・ISO 8601 日時）
│   └── nar.rs           # NAR（ZIP）アーカイブ作成
└── tests/
    └── cli_test.rs      # バイナリ経由の CLI 統合テスト（終了コード・入出力契約）

依存クレート

ライセンス

MIT OR Apache-2.0