現状（v0.4.0）#

手段状態用途
npx @sorane/cli利用可能サイトビルド・検証（検索は @sorane/search を追加）
git clone + npm ci利用可能sorane 本体の開発
GitHub Release タグv0.4.xバージョン固定
Docker イメージ未対応—

npm パッケージ: @sorane/cli, @sorane/core, @sorane/okf, @sorane/search, @sorane/font

使い方#

npm install @sorane/cli
npx sorane validate --cwd ./my-site --json
npx sorane build --cwd ./my-site --clean
# 検索まで使う場合:
npm install @sorane/search
npx sorane index --cwd ./my-site --force

本番 CI でビルドの再現性が必要なときだけ @sorane/[email protected] で pin します（任意）。

パッケージ一覧: https://www.npmjs.com/org/sorane

v0.4.0 の主な変更#

  • preset: — blog / okf-site / gov でサイト規模に応じた既定値
  • build.outputs — 機械可読成果物の個別 on/off
  • 軽量既定（breaking） — 図表 off、アーカイブ/tag off、lite outputs。既存本番サイトは preset: okf-site を推奨
  • オプショナル npm — @sorane/search / @sorane/font / mermaid を必要時インストール（CLI が案内・--yes 対応）
  • @sorane/cli-lite 廃止（単一 CLI に統合）

v0.3.0 の主な変更#

  • OKF 0.3 テンプレート一式（dataset / reference / glossary / glossary-term / faq）、DCAT カタログ、i18n Phase 2
  • okf.default_profile / okf.unknown_type サイト設定
  • examples/open-data/ デモ拡充

v0.2.8 の主な変更#

  • 公的サイト向け Findability pack（組織 JSON-LD、品質ゲート、i18n / hreflang、緊急バナー、改訂履歴、Cloudflare ホスティング hooks）
  • validate category revision、frontmatter YAML パース修正
  • ssg.sorane.dev 機能 ページ

v0.2.7 の主な変更#

  • sorane-okf/0.3 プロファイル（dataset, reference, glossary, faq）
  • catalog.jsonld の dataset[] / hasPart[] 分離（breaking）
  • examples/open-data/、dataset ランディング CSS、migrate --bump-profile 0.3

v0.2 の主な変更#

  • sorane-okf/0.2 プロファイルと AI コンテンツ開示
  • 静的画像の IPTC XMP / C2PA
  • BlogPosting JSON-LD associatedMedia
  • sorane watch、静的 404.html、OG メタ、a11y 改善
  • validate --json によるエージェント向け検証レポート

詳細はリポジトリの CHANGELOG.md を参照してください。

配布の形#

公式サイト — sorane リポジトリ内の website/ を dogfooding:

masanork/sorane
├── packages/*
└── website/

コンテンツ分離 — サイト repo から npm で sorane を呼び出す:

- run: npx @sorane/[email protected] build --cwd . --clean

サプライチェーン#

詳細は サプライチェーン を参照してください。

v* タグで GitHub Release に次を添付します。

  • npm pack tarball（@sorane/* ×5）
  • source tarball、sbom.json、cbom.json
  • SLSA Build-L3 provenance（.intoto.jsonl）

検証手順はリポジトリの docs/release-verification.md を参照してください。

ロードマップ#

  • プロダクトサイト ssg.sorane.dev
  • CHANGELOG.md と SemVer タグ
  • npm 配布（@sorane/cli ほか）
  • SLSA L3 + SBOM/CBOM（タグリリース workflow）
  • CI から npm publish --provenance
  • optional dependencies の整理（v0.4.0）
  • GitHub Releases に Bunsen フォント資産
  • Homebrew formula / Docker image