v1.0.0 リリースに際して、モノレポを puruslang org に分割する際の移行手順・方針メモ。
otnc/purus
├── core/ → コンパイラ本体
├── examples/ → サンプルコード
├── pages/ → ドキュメントサイト
├── linter/
├── prettier-plugin/
└── extension/
| リポジトリ | 公開設定 | 状態 | 移行元 |
|---|---|---|---|
puruslang/.github |
Public | プロフィールあり | — |
puruslang/discussions |
Public | 空 | — |
puruslang/playground |
Public | 空 | — |
puruslang/purus |
Private | 空 | core/ + examples/ |
puruslang/docs |
Private | 空 | pages/ |
puruslang/linter |
Public | 空 | linter/ |
puruslang/vscode-extension |
Private | 空 | extension/ |
puruslang/prettier-plugin |
Private | 空 | prettier-plugin/ |
puruslang/assets |
Private | 空 | — |
全リポジトリ作成済み(空)。以下の作業で各リポジトリを充填していく。
otnc/purus は 0.x のアーカイブとして残す(アーカイブ済み)。
Web 上で Purus のバージョンを選択してコードを実行できる REPL/プレイグラウンド。
- バージョンセレクター(npm に公開済みの
purusバージョンを一覧表示・選択できる) - エディタ(シンタックスハイライト付き Purus コード入力)
- 実行結果の表示(コンパイル後 JS の出力 / 実行結果)
- ブラウザ完結(サーバーサイド実行不要)
- コンパイラ(
purus)のブラウザ向けビルドが必要- 現在の
purusは Node.js CLI のみ。ブラウザ向けに WebAssembly または browser-compatible bundle が必要 - MoonBit は WebAssembly ターゲットをサポートしているため、WASM ビルドが有力
- 現在の
- バージョン選択 → jsdelivr または npm CDN 経由でその版の WASM/JS を動的ロード
- コンパイラを WASM または browser bundle としてビルドできるか検証
- バージョン一覧の取得方法(npm registry API:
https://registry.npmjs.org/purus) - エディタ候補: CodeMirror 6(軽量)/ Monaco(VS Code 同等、重め)
- サイト: Vercel または GitHub Pages でホスト
- ドメイン:
play.purus.workなど
| URL | 内容 |
|---|---|
purus.work |
最新ドキュメント(puruslang/docs、Vercel) |
www.purus.work |
purus.work にリダイレクト(Vercel の www リダイレクト機能) |
old.purus.work |
0.x 時代のドキュメント(otnc/purus の pages/、GitHub Pages) |
v1.purus.work |
v1 のドキュメント(v2+ が出た時に退避、Vercel ブランチデプロイ) |
puruslang/docs のブランチ構成で管理する。Vercel の「Git ブランチ」設定でブランチごとにドメインを割り当てる。
puruslang/docs
├── main → purus.work(常に最新)
├── v1 → v1.purus.work(v2+ リリース後に凍結)
├── v2 → v2.purus.work(v3+ リリース後に凍結)
└── ...
バージョンアップ時のフロー:
mainをv1ブランチとして切り出し → Vercel でv1.purus.workに割り当てmainを v2 ドキュメントに更新 →purus.workが自動で v2 を指す- 以降同様に繰り返す
Vercel 設定:Settings → Git → Branch deploys でブランチ名とドメインを紐付け。
アイコン・SVG ロゴ・バナーなど複数リポジトリから参照するすべての画像リソースを一元管理する。 ディレクトリ構成は自由に決めてよい。
最低限含めるもの:
- アイコン(現在
extension/icons/にあるもの) - ロゴ(現在
otnc/purusのlogo.png、各 README で参照) - OGP バナー・SNS シェア用画像(現在
astro.config.mjsのog:imageで参照)
各リポジトリの README.md、docs からは GitHub raw URL 経由で参照:
https://raw.githubusercontent.com/puruslang/assets/main/<path>
すべてのリポジトリに以下を用意する(EN/JA):
| ファイル | 備考 |
|---|---|
README.md / README-ja.md |
プロジェクト概要・インストール・使い方(badge 含む) |
CHANGELOG.md / CHANGELOG-ja.md |
バージョン別変更履歴 |
CONTRIBUTING.md / CONTRIBUTING-ja.md |
コントリビュート手順 |
CODE_OF_CONDUCT.md / CODE_OF_CONDUCT-ja.md |
行動規範(Contributor Covenant 推奨) |
LICENSE |
Apache-2.0 ライセンス本文 |
.github/ISSUE_TEMPLATE/ |
バグ報告・機能要望テンプレート |
.github/PULL_REQUEST_TEMPLATE.md |
PR テンプレート |
.github/workflows/ |
CI/CD ワークフロー |
各 README の badge は新リポジトリ URL に合わせて更新する。
[](https://www.npmjs.com/package/purus)
[](https://github.com/puruslang/purus/blob/main/LICENSE)
[](https://github.com/puruslang/purus/actions)各リポジトリの badge テンプレート:
| badge | URL パターン |
|---|---|
| npm version | https://img.shields.io/npm/v/<package> |
| license | https://img.shields.io/github/license/puruslang/<repo> |
| CI status | https://github.com/puruslang/<repo>/actions/workflows/ci.yml/badge.svg |
| VS Code installs | https://img.shields.io/visual-studio-marketplace/i/puruslang.purus(extension のみ) |
各パッケージの repository・bugs・homepage フィールドを新リポジトリ URL に変更する。
{
"repository": {
"type": "git",
"url": "https://github.com/puruslang/<repo>"
},
"bugs": {
"url": "https://github.com/puruslang/<repo>/issues"
},
"homepage": "https://purus.work"
}moon.mod.json(コンパイラ):
{
"repository": "https://github.com/puruslang/purus"
}-
core/の内容を移行(git history ごとgit filter-repo推奨) -
examples/を同リポジトリ内に含める -
README.md/README-ja.mdを書き直し(badge をpuruslang/purus向けに更新) -
CHANGELOG.md/CHANGELOG-ja.mdを引き継ぎ -
CONTRIBUTING.md/CONTRIBUTING-ja.mdを作成 -
CODE_OF_CONDUCT.md/CODE_OF_CONDUCT-ja.mdを作成 -
LICENSE(Apache-2.0)を配置 -
package.json/moon.mod.jsonのrepository・bugs・homepageを更新 -
.github/整備(Issue テンプレート・PR テンプレート・Actions) - パッケージ名:
purus(npm) - GitHub Actions: テスト・ビルド・npm publish ワークフロー
-
pages/の内容を移行 -
astro.config.mjs内のリンクを更新socialの GitHub リンク:otnc/purus→puruslang/puruseditLink.baseUrl:https://github.com/otnc/purus/edit/main/pages/→https://github.com/puruslang/docs/edit/main/- サイドバー Resources の RFC リンク:
otnc/purus/blob/main/RFC.md→puruslang/purus/blob/main/RFC.md - サイドバー Resources の CHANGELOG リンク:
otnc/purus/blob/main/CHANGELOG.md→puruslang/purus/blob/main/CHANGELOG.md
- MDX ファイル内の
otnc/purus直リンクを一括置換(grep -r "otnc/purus" src/で洗い出し) - Vercel プロジェクトを
puruslang/docsに紐付け直し -
purus.workドメインを新プロジェクトに付け替え - Vercel でブランチごとのドメイン割り当てを設定
-
old.purus.workをotnc/purusの GitHub Pages に割り当て(カスタムドメイン設定)- GitHub Pages は
docs/フォルダから配信(現行のoutDir: '../docs'そのまま) - トップページ(EN/JA)にアーカイブ通知の Warning を表示(実装済み)
old.purus.workのカスタムドメインを GitHub Pages に割り当てれば完成
- GitHub Pages は
- アセット参照を
puruslang/assets(raw.githubusercontent.com)に変更 -
.github/整備(docs 用 Issue テンプレート・Actions)
-
linter/の内容を移行 -
README.md/README-ja.mdを書き直し(badge をpuruslang/linter向けに更新) -
CHANGELOG.md/CHANGELOG-ja.mdを新規作成(0.x → 1.0.0 で引き継ぎ) -
CONTRIBUTING.md/CONTRIBUTING-ja.mdを作成 -
CODE_OF_CONDUCT.md/CODE_OF_CONDUCT-ja.mdを作成 -
LICENSE(Apache-2.0)を配置 -
package.jsonのrepository・bugs・homepageを更新 -
.github/整備 - パッケージ名:
@puruslang/linter(npm)
-
extension/の内容を移行 - アイコンパスを
puruslang/assets(raw.githubusercontent.com)参照に変更 -
README.md/README-ja.mdを書き直し(badge をpuruslang/vscode-extension向けに更新) -
CHANGELOG.md/CHANGELOG-ja.mdを新規作成 -
CONTRIBUTING.md/CONTRIBUTING-ja.mdを作成 -
CODE_OF_CONDUCT.md/CODE_OF_CONDUCT-ja.mdを作成 -
LICENSE(Apache-2.0)を配置 -
package.jsonのrepository・bugs・homepageを更新、publisher をpuruslangに変更 -
.github/整備 - バージョン:
1.0.0
-
prettier-plugin/の内容を移行 -
README.md/README-ja.mdを書き直し(badge をpuruslang/prettier-plugin向けに更新) -
CHANGELOG.md/CHANGELOG-ja.mdを新規作成 -
CONTRIBUTING.md/CONTRIBUTING-ja.mdを作成 -
CODE_OF_CONDUCT.md/CODE_OF_CONDUCT-ja.mdを作成 -
LICENSE(Apache-2.0)を配置 -
package.jsonのrepository・bugs・homepageを更新 -
.github/整備 - パッケージ名:
@puruslang/prettier-plugin-purus(npm)
- 新規作成
-
otnc/purusの各種アイコン・SVG を移行 -
README.mdに参照方法(raw URL / jsDelivr)を記載
- リポジトリを
Archivedに設定(Settings → Archive this repository) -
README.md冒頭に移行先バナーを追加> ⚠️ このリポジトリは Purus v0.x のアーカイブです。 > 最新版は [puruslang/purus](https://github.com/puruslang/purus) を参照してください。
-
old.purus.workのドメインをこのリポジトリの Vercel デプロイに割り当て
v1.0.0 リリース時に Node.js の最低要件を v20 → v22 に引き上げる。以下のすべての箇所を更新すること。
| ファイル | 現在 | v1 |
|---|---|---|
core/package.json |
"node": ">=20" |
"node": ">=22" |
linter/package.json |
要確認・追加 | "node": ">=22" |
prettier-plugin/package.json |
要確認・追加 | "node": ">=22" |
extension/package.json |
要確認・追加 | "node": ">=22" |
以下すべての node-version: "20" → "22" に変更:
.github/workflows/ci.yml.github/workflows/release.yml.github/workflows/linter-release.yml.github/workflows/prettier-plugin-release.yml.github/workflows/extension-release.yml.github/workflows/docs.yml
| ファイル | 内容 |
|---|---|
CONTRIBUTING.md / CONTRIBUTING-ja.md |
>= 20 → >= 22 |
pages/.../getting-started/installation.mdx(EN/JA) |
Node.js v20 の記述を v22 に更新 |
CHANGELOG.md / CHANGELOG-ja.md |
v1.0.0 エントリに Node.js v22 必須を記載 |
Note:
RFC.mdには Node.js の最低バージョンの明示的な記載はないため更新不要。
v1.0.0 の要件が固まり次第、分割作業に入る。それまでは otnc/purus モノレポで開発を継続する。
すでに存在するため、v1 移行に合わせて内容を更新する。
現在の内容(確認済み):
<div align="center">
Write code without the Shift key. Beautiful, simple, and easy-to-use.
<a href="https://www.purus.work/">
<img src="https://www.purus.work/img/banner.png" width="600" alt="banner">
</a>
<a href="https://github.com/otoneko1102/purus">
<img src="./images/pin_purus.svg" width="600" alt="Readme Card">
</a>
</div>更新内容:
- バナー画像を
puruslang/assetsの raw URL に変更- 変更前:
https://www.purus.work/img/banner.png - 変更後:
https://raw.githubusercontent.com/puruslang/assets/main/banner/banner.png
- 変更前:
- リンク先を
otnc/purus→puruslang/purusに変更 - Purus について説明を追記(何ができる言語か・特徴)
- v0.x アーカイブへの案内を追記
otnc/purusがアーカイブであること- ドキュメントは
old.purus.work
- 各リポジトリへのリンク一覧を追記(purus・docs・linter・vscode-extension・prettier-plugin・playground)
-
images/pin_purus.svgのリンク・デザイン見直し(otoneko1102→puruslang)
- org デフォルトの Issue テンプレートを追加(各リポジトリで個別設定しない場合のフォールバック)
- org デフォルトの
CODE_OF_CONDUCT.mdを追加 - org デフォルトの
CONTRIBUTING.mdを追加 - org デフォルトの
SECURITY.mdを追加(脆弱性報告先)
現在 otnc/purus のリポジトリ Secrets として管理しているものを、puruslang org の Organization Secrets に昇格させる。
| Secret | 用途 | 移行先 |
|---|---|---|
VSCE_PAT |
VS Code Marketplace publish | puruslang org secret |
NPM_TOKEN |
npm publish(linter・prettier-plugin 等) | puruslang org secret |
| その他 CI 用トークン | Vercel deploy token など | puruslang org secret または各リポジトリ secret |
手順:
puruslangorg → Settings → Secrets and variables → Actions → New organization secret- Access を必要なリポジトリ(
All repositoriesまたは個別選択)に設定 - 各リポジトリの workflow で
secrets.VSCE_PAT等をそのまま参照できる(変更不要) - 移行完了後に
otnc/purusのリポジトリ secrets を削除
依存関係があるため、以下の順で進める。
puruslang/assets— 他のすべてが参照するため最初に充填puruslang/purus— コンパイラ本体(他ツールが依存)puruslang/linter/puruslang/prettier-plugin/puruslang/vscode-extension(並行可)puruslang/docs— 各ツールの情報が揃ってからpuruslang/.github— profile 更新・org デフォルトファイル- DNS 切り替え・Vercel 付け替え
- v1.0.0 npm publish・GitHub Release
全リポジトリとも history は削除してクリーンな状態から開始する。 ファイルの内容だけコピーして initial commit から始める。
全リポジトリとも、全移行が完了した後にユーザーと AI でチェックを行い、問題がなければ一斉に公開する。 v1.0.0 リリース日は未定。
publisher otoneko1102 のまま維持する(otoneko1102.purus)。移管は行わない。
DNS 設定は本人が行う。
- リポジトリの Discussions 機能を有効化
- カテゴリを作成(例: Announcements・General・Q&A・Ideas・Show and Tell)
- 各リポジトリの README に discussions へのリンクを追記
-
puruslang/.githubの org デフォルト discussions リンクを設定
リリース日未定。手順は全移行・レビュー完了後に詳細化する。おおよその流れ:
puruslang/assetsに全アセットを push・公開- 全リポジトリをチェックして問題なければ一斉 public に変更
- 各リポジトリで
git tag v1.0.0→ GitHub Release 作成 - npm publish(
purus@1.0.0・@puruslang/linter@1.0.0・@puruslang/prettier-plugin-purus@1.0.0) vsce publish(otoneko1102.purus@1.0.0)- DNS 切り替え(本人作業)
puruslang/.githubprofile README を更新- 告知(詳細未定)
core・linter・prettier-plugin・vscode-extension すべて v1.0.0 で揃える。
言語仕様の破壊的変更なし。変更点は以下のみ:
- Node.js 最低要件を v20 → v22 に引き上げ
v1 と同時でも後回しでもどちらでもよい。
puruslang/docs はあらかじめ Public にしておくことで team プラン不要で Vercel 連携できる。
本人が行う。