ampless 1.0.0-alpha.50 → 1.0.0-beta.51

package/README.ja.md

@@ -5,7 +5,7 @@
 
 AWS Amplify 向け CMS コアライブラリ。
 
-> **プレリリース / アルファ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。全文ドキュメントは [ルート README](https://github.com/heavymoons/ampless#readme) を参照してください。
+> **プレリリース / ベータ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。全文ドキュメントは [ルート README](https://github.com/heavymoons/ampless#readme) を参照してください。
 
 ## 概要
 
@@ -22,7 +22,7 @@ AWS Amplify 向け CMS コアライブラリ。
 ## インストール
 
 ```bash
-npm install ampless@alpha
+npm install ampless@beta
 ```
 
 ## 使い方

package/README.md

@@ -5,7 +5,7 @@
 
 CMS core library for AWS Amplify.
 
-> **Pre-release / alpha.** Breaking changes possible in any minor version until v1.0. See the [root README](https://github.com/heavymoons/ampless#readme) for full docs.
+> **Pre-release / beta.** Breaking changes possible in any minor version until v1.0. See the [root README](https://github.com/heavymoons/ampless#readme) for full docs.
 
 ## Overview
 
@@ -22,7 +22,7 @@ You usually don't depend on `ampless` directly — it's pulled in transitively b
 ## Installation
 
 ```bash
-npm install ampless@alpha
+npm install ampless@beta
 ```
 
 ## Usage

package/dist/index.d.ts

@@ -298,11 +298,10 @@ type TrustLevel = 'untrusted' | 'trusted' | 'privileged';
  *     `PluginSecret` DynamoDB model. Requires `trust_level: 'trusted'`.
  *     Trusted hooks access secrets via `ctx.secret<T>(key)`.
  *
- * Reserved capabilities are accepted by the type so that plugins can
- * declare future intent, but the runtime does nothing with them yet —
- * each has its own RFP under `docs/tmp/`. Declaring a reserved
- * capability today is harmless, but the runtime won't expose any new
- * surface for it until the matching phase ships.
+   * Reserved capabilities are accepted by the type so that plugins can
+   * declare future intent, but the runtime does nothing with them yet.
+   * Declaring a reserved capability today is harmless, but the runtime
+   * won't expose any new surface for it until the matching phase ships.
  */
 type PluginCapability = 'publicHead' | 'publicBody' | 'metadata' | 'eventHooks' | 'adminSettings' | 'writePublicAsset' | 'schema' | 'publicHtmlForPost' | 'secretSettings' | 'contentFields' | 'publicPostScript' | 'adminPage' | 'serverRoute' | 'network' | 'scheduler' | 'storageWrite' | 'privilegedSystem' | 'cspReady';
 /**
@@ -1163,7 +1162,7 @@ interface AmplessPlugin {
      *
      * For external `npm publish` plugins, `packageName` MUST match the
      * package's actual `name` and the package's `exports` MUST expose
-     * `./package.json`. The scaffold tool (`npx create-ampless plugin`)
+     * `./package.json`. The scaffold tool (`npx create-ampless@beta plugin`)
      * handles both automatically.
      */
     packageName?: string;

package/docs/plugin-author-guide.ja.md

@@ -59,7 +59,7 @@ ampless プラグインは 3 つのいずれかの場所に書きます — コ
 
 3 つの形式はすべて同じ `definePlugin({...})` ファクトリを呼び出し、同じサーフェスを使います。違いはパッケージング・配布方法、および静的 `package.json#amplessPlugin` マニフェストが有効にするインストール時バリデーションのオプトインです（§3 参照）。
 
-§14 には一行のスキャフォールドコマンド (`npx create-ampless plugin <name>`) があり、後者 2 つのどちらにも即使えるボイラープレートを生成します。
+§14 には一行のスキャフォールドコマンド (`npx create-ampless@beta plugin <name>`) があり、後者 2 つのどちらにも即使えるボイラープレートを生成します。
 
 ampless プラグインは `AmplessPlugin` オブジェクトを返す TypeScript モジュールです。以下のうち 1 つ以上のサーフェスにフックします:
 
@@ -101,10 +101,10 @@ ampless プラグインは `AmplessPlugin` オブジェクトを返す TypeScrip
 
 ```bash
 # サイトローカル (現在の ampless サイトに plugins/<name>/index.ts を生成)
-npx create-ampless@latest plugin my-thing
+npx create-ampless@beta plugin my-thing
 
 # スタンドアロン npm パッケージ (`npm publish` 向けの ./<name>/ を生成)
-npx create-ampless@latest plugin @myscope/ampless-plugin-my-thing --standalone
+npx create-ampless@beta plugin @myscope/ampless-plugin-my-thing --standalone
 ```
 
 全体の手順は §14 を参照してください。このセクションの残りでは生成されるファイルの意味を説明します — 手書きしたい場合はここを読めば把握できます。
@@ -813,7 +813,7 @@ export const editorExtension = AmplessYoutubeNode   // tiptap Node または Ext
 
 ### プラグインユーザー（サイトエンジニア）向け
 
-1. `npm i @ampless/plugin-youtube@alpha` — plugin を dependency として追加する。
+1. `npm i @ampless/plugin-youtube@beta` — plugin を dependency として追加する。
 2. `cms.config.ts` に登録してサーバーサイド renderer を有効化する。
 3. `npm run update-ampless` — インストール済み plugin の manifest から `_editor-bootstrap.tsx` を自動再生成する。
 
@@ -1251,7 +1251,7 @@ Secret settings を使うと、trusted プラグインが認証情報 (Webhook
   | 脅威 | 状態 |
   |---|---|
   | PluginSecret テーブルを閲覧する AWS Console オペレータ | ✓ 対策済み — ciphertext のみ、DDB に鍵なし |
-  | ソースリポジトリ / デプロイアーティファクトへのアクセス | ⚠ 対策なし — 鍵は `amplify/secrets/encryption-key.ts` に存在。リポジトリを private にし、アーティファクトアクセスを制限すること |
+  | ソースリポジトリ / デプロイアーティファクトへのアクセス | ⚠ 対策なし — 鍵は `amplify/secrets/encryption-key.ts` に存在。public repo では `npx create-ampless@beta setup-encryption-key --gitignore` などで鍵を version control から外し、デプロイアーティファクトアクセスを制限すること |
   | 同一 Lambda 内の悪意ある trusted plugin | ✗ 対策なし — `process.env.PLUGIN_SECRET_ENCRYPTION_KEY` はプラグインコードから読める。真の分離 = per-plugin Lambda（privileged tier, ロードマップ） |
   | S3 mirror 漏洩 | ✓ 対策済み — PluginSecret テーブルは mirror されない |
 
@@ -1274,7 +1274,7 @@ Secret settings を使うと、trusted プラグインが認証情報 (Webhook
 2. `capabilities` に `'secretSettings'` を含める（`capabilities` が定義されているとき省略すると console.warn）。
 3. **鍵の初回セットアップ** — プロジェクトルートで実行:
    ```sh
-   npx create-ampless setup-encryption-key
+   npx create-ampless@beta setup-encryption-key
    ```
    32 バイトのランダムな鍵を生成し、`amplify/secrets/encryption-key.ts` に書き込む。AWS 認証情報不要 — ローカルファイル操作のみ。
 
@@ -1629,7 +1629,7 @@ it('admin が空文字保存した場合は空配列', () => {
 - **パッケージ名**: `@your-scope/plugin-foo`。`@ampless/plugin-*` スコープは本モノレポから ship する公式プラグイン用に予約
 - **エントリ**: ESM のみ、default export (factory) + 設定インターフェイス (ユーザの `cms.config.ts` から型付きで引数を渡せるように) を export
 - **`apiVersion`**: 現状は `1` を declare してください — 唯一の有効値で、literal type が他の値を compile-time に reject します。`apiVersion` はプラグイン契約の **breaking-change marker** であって semver 風のチャンネルではありません。additive な追加 (optional field、reserved capability など) は `apiVersion: 1` 内に収まり、bump は不要です。詳細は architecture doc の [apiVersion bump policy](https://github.com/heavymoons/ampless/blob/main/docs/architecture/08-plugin-architecture.md#apiversion-bump-policy) を参照
-- **Dist-tag**: ampless 自体が alpha のうちは `@alpha`。`@latest` は ampless v1.0 まで予約
+- **Dist-tag**: ampless 自体が beta のうちは `@beta`。`@latest` は ampless v1.0 まで予約
 
 参考実装:
 
@@ -1670,7 +1670,7 @@ it('admin が空文字保存した場合は空配列', () => {
 ```bash
 # サイトローカル: 現在の ampless サイトのルートで実行
 # plugins/<name>/index.ts を生成する
-npx create-ampless@latest plugin my-thing \
+npx create-ampless@beta plugin my-thing \
   --trust-level untrusted \
   --capabilities publicHead,adminSettings
 
@@ -1678,7 +1678,7 @@ npx create-ampless@latest plugin my-thing \
 # package.json / tsconfig.json / tsup.config.ts / README + .ja /
 # CHANGELOG / .gitignore / src/index.ts + src/index.test.ts を含む
 # 新しいパッケージディレクトリを置きたい場所で実行する
-npx create-ampless@latest plugin @myscope/ampless-plugin-thing \
+npx create-ampless@beta plugin @myscope/ampless-plugin-thing \
   --standalone \
   --trust-level untrusted \
   --capabilities publicHead,adminSettings \
@@ -1687,7 +1687,7 @@ npx create-ampless@latest plugin @myscope/ampless-plugin-thing \
 
 スタンドアロンスキャフォールドには Phase 5 のクロスチェックに必要なものがすべて含まれます: `package.json#amplessPlugin`、`./package.json` サブパスエクスポート、`packageName` ファクトリフィールド、`ampless-plugin` 検索キーワード、そして `pnpm install && pnpm test && pnpm build` が生成直後にクリーンに通る最小の vitest サンプル。
 
-どちらのモードも、フラグなしの位置引数呼び出し (`npx create-ampless@latest plugin`) で @clack のプロンプト UI を使ったインタラクティブモードに切り替えられます。
+どちらのモードも、フラグなしの位置引数呼び出し (`npx create-ampless@beta plugin`) で @clack のプロンプト UI を使ったインタラクティブモードに切り替えられます。
 
 ### スタンドアロンプラグインの公開
 
@@ -1696,12 +1696,12 @@ cd ampless-plugin-thing
 pnpm install
 pnpm test
 pnpm build
-pnpm publish --access public --tag alpha
+pnpm publish --access public --tag beta
 ```
 
-スコープ付き名前 (`@scope/...`) には `--access public` が必須です。`--tag alpha` は現在の ampless プレリリースサイクルに合わせています — 安定 major に達したら外してください。
+スコープ付き名前 (`@scope/...`) には `--access public` が必須です。`--tag beta` は現在の ampless プレリリースサイクルに合わせています — 安定 major に達したら外してください。
 
-`npm publish` が返った直後に `npm install <pkg>@alpha` で 404 が出ることがあります（CDN とレジストリレプリカの伝播遅延）。その場合は 1〜2 分待ってリトライしてください — `npm view <pkg>@alpha version` がレジストリで見えていることは必要条件ですが十分条件ではありません。
+`npm publish` が返った直後に `npm install <pkg>@beta` で 404 が出ることがあります（CDN とレジストリレプリカの伝播遅延）。その場合は 1〜2 分待ってリトライしてください — `npm view <pkg>@beta version` がレジストリで見えていることは必要条件ですが十分条件ではありません。
 
 ### パッケージの命名
 
@@ -1744,4 +1744,4 @@ export default defineConfig({
 - ファーストパーティプラグインの bug → `heavymoons/ampless` にプラグインの package 名つきで issue
 - プラグインランタイム / admin form の bug → 同じレポ、ラベル `area:plugins`
 
-ampless レポは現在 alpha 期間中は非公開です。beta に進む (npm `beta` dist-tag、リポジトリ公開) と上記のリンクが GitHub URL に解決されます。現状でも同じ docs が package tarball 内の `node_modules/ampless/docs/` に同梱されているので、GitHub にアクセスせずローカルで読めます。
+上記の GitHub URL は public beta repo で解決されます。同じ docs は package tarball 内の `node_modules/ampless/docs/` にも同梱されているので、この repo を checkout しなくてもローカルで読めます。

package/docs/plugin-author-guide.md

@@ -77,7 +77,7 @@ same surfaces. The differences are packaging, distribution, and the
 opt-in install-time validation that the static `package.json#amplessPlugin`
 manifest enables (see §3 below).
 
-§14 below has a one-command scaffold (`npx create-ampless plugin <name>`)
+§14 below has a one-command scaffold (`npx create-ampless@beta plugin <name>`)
 that produces ready-to-use boilerplate for either of the latter two.
 
 An ampless plugin is a TypeScript module that returns an
@@ -123,10 +123,10 @@ The fastest way to create a plugin is to scaffold one:
 
 ```bash
 # Site-local (writes plugins/<name>/index.ts in the current ampless site)
-npx create-ampless@latest plugin my-thing
+npx create-ampless@beta plugin my-thing
 
 # Standalone npm package (writes ./<name>/ ready for `npm publish`)
-npx create-ampless@latest plugin @myscope/ampless-plugin-my-thing --standalone
+npx create-ampless@beta plugin @myscope/ampless-plugin-my-thing --standalone
 ```
 
 §14 covers the full flow. The rest of this section explains what the
@@ -1065,7 +1065,7 @@ and the plugin is skipped):
 
 ### For plugin users (site engineers)
 
-1. `npm i @ampless/plugin-youtube@alpha` — add the plugin as a dependency.
+1. `npm i @ampless/plugin-youtube@beta` — add the plugin as a dependency.
 2. Register it in `cms.config.ts` for the server-side renderer.
 3. `npm run update-ampless` — regenerates `_editor-bootstrap.tsx`
    automatically from the installed plugin manifests.
@@ -1702,7 +1702,7 @@ etc. — but completely wrong for a webhook signing secret.
   | Threat | Status |
   |---|---|
   | AWS Console operator browsing PluginSecret table | ✓ defeated — ciphertext only, no key in DDB |
-  | Source repo / deploy artifact access | ⚠ NOT defeated — key is in `amplify/secrets/encryption-key.ts`. Private repo + restricted artifact access expected. |
+  | Source repo / deploy artifact access | ⚠ NOT defeated — key is in `amplify/secrets/encryption-key.ts`. For public repos, keep the key out of source control (for example with `npx create-ampless@beta setup-encryption-key --gitignore`) and restrict deploy artifact access. |
   | Malicious trusted plugin in same Lambda | ✗ NOT defeated — `process.env.PLUGIN_SECRET_ENCRYPTION_KEY` reachable from plugin code. True isolation = per-plugin Lambda (privileged tier, roadmap). |
   | S3 mirror leak | ✓ defeated — PluginSecret table never mirrored. |
 
@@ -1735,7 +1735,7 @@ To use `settings.secret`, you also need:
 2. `'secretSettings'` in `capabilities` (omitting it when `capabilities` is defined produces a console warning).
 3. **One-time key setup** — run from your project root:
    ```sh
-   npx create-ampless setup-encryption-key
+   npx create-ampless@beta setup-encryption-key
    ```
    This generates a cryptographically random 32-byte key and writes
    it to `amplify/secrets/encryption-key.ts`. No AWS credentials
@@ -2239,7 +2239,7 @@ a normal npm package:
   `apiVersion: 1` and do NOT require a bump. See the [apiVersion
   bump policy](https://github.com/heavymoons/ampless/blob/main/docs/architecture/08-plugin-architecture.md#apiversion-bump-policy)
   in the architecture doc for the full criteria.
-- **Dist-tag**: `@alpha` while ampless itself is in alpha. The
+- **Dist-tag**: `@beta` while ampless itself is in beta. The
   `@latest` tag stays reserved until ampless v1.0.
 
 Worked examples to crib from:
@@ -2306,7 +2306,7 @@ CLI ships a `plugin <name>` subcommand:
 ```bash
 # Site-local: scaffolds plugins/<name>/index.ts inside the current
 # ampless site. Run from the site repo root.
-npx create-ampless@latest plugin my-thing \
+npx create-ampless@beta plugin my-thing \
   --trust-level untrusted \
   --capabilities publicHead,adminSettings
 
@@ -2314,7 +2314,7 @@ npx create-ampless@latest plugin my-thing \
 # tsconfig.json, tsup.config.ts, README + .ja, CHANGELOG, .gitignore,
 # and src/index.ts + src/index.test.ts. Run from wherever you want
 # the new package directory to land.
-npx create-ampless@latest plugin @myscope/ampless-plugin-thing \
+npx create-ampless@beta plugin @myscope/ampless-plugin-thing \
   --standalone \
   --trust-level untrusted \
   --capabilities publicHead,adminSettings \
@@ -2328,7 +2328,7 @@ keyword, and a minimal vitest sample so `pnpm install && pnpm test &&
 pnpm build` runs clean on the freshly generated directory.
 
 Both modes also accept a positional flag-less invocation (`npx
-create-ampless@latest plugin`) that walks you through the same
+create-ampless@beta plugin`) that walks you through the same
 questions interactively via the @clack prompt UI.
 
 ### Publishing a standalone plugin
@@ -2338,17 +2338,17 @@ cd ampless-plugin-thing
 pnpm install
 pnpm test
 pnpm build
-pnpm publish --access public --tag alpha
+pnpm publish --access public --tag beta
 ```
 
 `--access public` is mandatory for scoped names (`@scope/...`).
-`--tag alpha` matches the current ampless pre-release cadence — drop
+`--tag beta` matches the current ampless pre-release cadence — drop
 it once the package reaches a stable major.
 
 There's a publish-to-install lag of "seconds to minutes" before
-`npm install <pkg>@alpha` picks up a fresh publish (CDN + registry
+`npm install <pkg>@beta` picks up a fresh publish (CDN + registry
 replica propagation). If `npm install` 404s right after `npm publish`
-returns, wait 1-2 minutes and retry — `npm view <pkg>@alpha version`
+returns, wait 1-2 minutes and retry — `npm view <pkg>@beta version`
 visible in the registry is necessary but sometimes not sufficient.
 
 ### Naming the package
@@ -2399,8 +2399,7 @@ PROTECTED), so the scaffolded code is safe across ampless upgrades.
 - Bugs in the plugin runtime / admin form → same repo, label
   `area:plugins`.
 
-The ampless repo is currently private during the alpha stage; the
-GitHub URLs above start resolving once beta ships (npm `beta`
-dist-tag, repo flips public). Today the same docs also live in the
-package tarball directly under `node_modules/ampless/docs/`, so
-you can read them locally without browsing GitHub.
+The GitHub URLs above resolve in the public beta repo. The same docs
+also live in the package tarball directly under
+`node_modules/ampless/docs/`, so plugin authors can read them locally
+without checking out this repo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-alpha.50",
+  "version": "1.0.0-beta.51",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",