現状（v0.1.0）#

手段状態用途
git clone + npm ci利用可能開発・本番ビルド（公式サイト CI と同じ）
GitHub Release タグ計画中バージョン固定・フォント資産配布
npm publish未対応npx sorane での手軽な利用
Docker イメージ未対応CI / 再現性の高いビルド

配布の形#

公式サイト（本番例） — 単一リポジトリ:

masanork/sorane
├── packages/*   … CLI・ビルドエンジン
└── website/     … プロダクトサイト（sorane.dev）

大規模サイト — コンテンツとツールを分離する場合、CI で sorane の ref を pin します。

- uses: actions/checkout@v4
  with:
    repository: masanork/sorane
    ref: v0.1.0        # タグで固定
    path: sorane

ロードマップ#

Phase 1 — ドキュメントとタグ付けリリース#

  • プロダクトサイト sorane.dev（ssg.sorane.dev はミラー、sorane.pages.dev はフォールバック）
  • CHANGELOG.md と SemVer タグ（v0.1.0 …）
  • GitHub Releases にソース tarball + Bunsen フォント資産

Phase 2 — npm 配布#

ネイティブ依存（better-sqlite3, onnxruntime-node）があるため、単純 publish には以下が必要です。

  • TypeScript → JavaScript ビルド、または Node 23+ の TS 直実行を前提としたドキュメント
  • optional dependencies の整理
  • @sorane/cli として公開、npx @sorane/cli build を目標

Phase 3 — エコシステム#

  • Astro テーマ層（sorane 出力の上に載せる）
  • Homebrew formula / Docker image
  • sorane.dev（プロダクトサイト）
  • ssg.sorane.dev（ミラー）