create-ampless 1.0.0-alpha.41 → 1.0.0-alpha.44

package/README.ja.md

@@ -15,7 +15,7 @@ npx create-ampless@alpha
 
 1. プロジェクト名
 2. サイト名（デフォルトの `<title>` および OGP `siteName` として使用）
-3. テーマ — v0.1 では `blog`
+3. テーマ — 同梱テーマから選択（例: `blog`）
 4. プラグイン — `seo`、`rss`、`webhook`
 
 出力は AWS Amplify Gen 2 バックエンド定義を含む Next.js 16（App Router）プロジェクトです。`/admin` に管理パネル、`/` にパブリックブログが設置され、選択したプラグインが `cms.config.ts` にあらかじめ設定されます。また運用メモ用の `RUNBOOK.md` も生成されます。

package/README.md

@@ -15,7 +15,7 @@ The wizard walks you through:
 
 1. Project name
 2. Site name (used as the default `<title>` and OGP `siteName`)
-3. Theme — `blog` for v0.1
+3. Theme — pick from the bundled themes (e.g. `blog`)
 4. Plugins — `seo`, `rss`, `webhook`
 
 Output is a Next.js 16 (App Router) project with the AWS Amplify Gen 2 backend definitions, an admin panel at `/admin`, public blog at `/`, the chosen plugins pre-wired in `cms.config.ts`, and a `RUNBOOK.md` for operations notes.

package/dist/index.js

@@ -1747,6 +1747,11 @@ var AMPLESS_MANAGED_APP_PATHS = [
   "app/login",
   "app/site"
 ];
+var AMPLESS_RETIRED_PATHS = [
+  // Retired alongside the in-deploy multi-site drop.
+  "lib/admin-site.ts",
+  "lib/admin-site-client.ts"
+];
 var AMPLESS_PACKAGES = /* @__PURE__ */ new Set([
   "ampless",
   "@ampless/admin",
@@ -1898,7 +1903,7 @@ async function pruneEmptyDirs(root) {
     await rm2(root, { recursive: true, force: true });
   }
 }
-async function findObsoleteAppFiles(destDir, sharedDir) {
+async function findObsoleteFiles(destDir, sharedDir) {
   const obsolete = [];
   for (const managedPath of AMPLESS_MANAGED_APP_PATHS) {
     const userPath = join3(destDir, managedPath);
@@ -1912,9 +1917,15 @@ async function findObsoleteAppFiles(destDir, sharedDir) {
       }
     }
   }
+  for (const retiredPath of AMPLESS_RETIRED_PATHS) {
+    const userFile = join3(destDir, retiredPath);
+    if (existsSync5(userFile)) {
+      obsolete.push(retiredPath);
+    }
+  }
   return obsolete;
 }
-async function removeObsoleteAppFiles(destDir, paths) {
+async function removeObsoleteFiles(destDir, paths) {
   for (const rel of paths) {
     const abs = join3(destDir, rel);
     if (existsSync5(abs)) {
@@ -1978,7 +1989,7 @@ async function runUpgradeIn(destDir, sharedDir, opts = {}) {
   const shippedThemes = themeSyncEnabled ? await listShippedThemes(templatesRoot) : [];
   const existingThemes = themeSyncEnabled ? await discoverInstalledThemes(destDir) : [];
   const preservedThemes = existingThemes.filter((t) => !shippedThemes.includes(t));
-  const obsoleteFiles = await findObsoleteAppFiles(destDir, sharedDir);
+  const obsoleteFiles = await findObsoleteFiles(destDir, sharedDir);
   log3.info(
     `replace: ${pc3.green(`${replaceNew.length} added`)} / ${pc3.yellow(`${replaceUpdate.length} updated`)}`
   );
@@ -2020,7 +2031,7 @@ async function runUpgradeIn(destDir, sharedDir, opts = {}) {
     await copyWithSubstitution(src, dst, vars);
   }
   const themeResult = themeSyncEnabled ? await syncThemes(destDir, templatesRoot) : { synced: [], preserved: [] };
-  await removeObsoleteAppFiles(destDir, obsoleteFiles);
+  await removeObsoleteFiles(destDir, obsoleteFiles);
   const templatePkgRaw = await readFile3(join3(sharedDir, "package.json"), "utf-8");
   const templatePkg = JSON.parse(templatePkgRaw);
   const indent = detectIndent(projectPkgRaw);

package/dist/templates/_shared/AGENTS.ja.md

@@ -93,7 +93,7 @@ UI / テーマを変更した場合、型チェックだけを根拠にタスク
 ## 既知の制約
 
 - **サンドボックスのデータは揮発性。** スキーマに影響する変更は API とテーブルの再構築を引き起こす可能性がある。サンドボックスのコンテンツは使い捨てとして扱うこと。本番データは永続する。
-- **1 Amplify デプロイ = 1 サイト。** 複数サイトを別ドメインで配信したい場合は、サイトごとに Amplify 環境を分けてデプロイする。スキーマの `siteId` カラムは常に `"default"` 固定（前方互換のため残してある）。
+- **1 Amplify デプロイ = 1 サイト。** 複数サイトを別ドメインで配信したい場合は、サイトごとに Amplify 環境を分けてデプロイする。
 - **AppSync 公開 API キーは `amplify_outputs.json` に含まれ、サイト訪問者から見える。** 低信頼の認証情報として扱うこと — このキーの権限は公開済み投稿の読み取りのみ。`api-key-renewer` Lambda が毎月自動ローテーションするため、手動ローテーションは不要。
 - **最初に登録したユーザーが管理者になる。** 以降のロール変更は Cognito コンソールで行う（RUNBOOK 参照）。
 

package/dist/templates/_shared/AGENTS.md

@@ -93,7 +93,7 @@ Do not report a task complete based solely on type checks if a UI/theme was modi
 ## Known constraints
 
 - **Sandbox data is ephemeral.** Schema-affecting changes can rebuild the API and tables; treat sandbox content as throw-away. Production data is durable.
-- **One Amplify deployment = one site.** To serve multiple sites on different domains, deploy separate Amplify environments. The schema's `siteId` column is always the literal `"default"` (retained for forward-compat).
+- **One Amplify deployment = one site.** To serve multiple sites on different domains, deploy separate Amplify environments.
 - **The AppSync public API key is shipped in `amplify_outputs.json` and visible to any site visitor.** Treat it as a low-trust credential — its only privilege is reading published posts. Auto-rotated monthly by the `api-key-renewer` Lambda; no manual rotation needed.
 - **The first registered user becomes admin.** Subsequent role changes go through the Cognito console (see RUNBOOK).
 

package/dist/templates/_shared/README.ja.md

@@ -10,9 +10,9 @@
 
 ## 必要なもの
 
-- **Node.js 20+** と **npm**
-- **AWS アカウント**と CLI 認証情報（`aws configure`）— sandbox / 本番ともに実 AWS リソースをデプロイします
-- 本番ホスティング（AWS Amplify Hosting）用の **GitHub アカウント**
+- **Node.js 20+** と **npm**。
+- **AWS アカウント.** [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) をインストールしてから `aws configure` で認証情報とデフォルトリージョンを設定します。sandbox / 本番ともに実 AWS リソースをデプロイします。
+- **GitHub アカウント** — AWS Amplify Hosting 経由の本番デプロイで必要。下記の [CLI デプロイフロー](#方法-1-cli-ワンショット推奨) を使う場合は [`gh` CLI](https://cli.github.com/) を `gh auth login` で認証する（または `repo` スコープ付きの `GITHUB_TOKEN` 環境変数を設定する）必要があります。コンソール経由の手動フローには `gh` は不要です。
 
 ## コマンド
 
@@ -122,6 +122,43 @@ export default defineConfig({
 
 同梱の [`amplify.yml`](./amplify.yml) が、connect したブランチへの push のたびに `npx ampx pipeline-deploy`（Amplify バックエンド） + `npm run build`（Next.js）を実行します。
 
+### 方法 1: CLI ワンショット（推奨）
+
+このプロジェクトディレクトリ内で:
+
+```bash
+npx create-ampless@latest --mount \
+  --github-owner <your-user-or-org> \
+  --aws-region <region> \
+  --create-iam-role           # 初回のみ。次回以降は `--iam-service-role <arn>` で使い回し
+```
+
+CLI が以下を一気に実行します:
+
+1. GitHub repo を作成（認証済みの `gh` CLI、`GITHUB_TOKEN` 環境変数、または `--github-token` フラグを利用）
+2. プロジェクトを repo に push
+3. Amplify Hosting アプリ + ブランチ作成、GitHub 連携登録、`amplify.yml` ビルド spec 配置
+4. 初回デプロイ起動
+
+便利な追加フラグ:
+
+- `--github-private` — private repo を作成（デフォルト: public）
+- `--domain <name>` `--subdomain <prefix>` — 同じ流れの中でカスタムドメインをバインド
+- `--skip-confirm` — 非対話モード（CI / 再実行向け）
+- `--aws-profile <name>` — 複数 AWS profile がある場合に明示
+
+全フラグは `npx create-ampless@latest --help` を参照。
+
+**このフロー固有の事前準備（[トップの必要なもの](#必要なもの) に加えて）:**
+
+| | 用途 | 準備方法 |
+|---|---|---|
+| `aws` CLI 認証済み | Amplify Hosting アプリ + サービスロールの provision | [インストール](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) して `aws configure` を実行（または `aws sso login`）。`aws sts get-caller-identity` で確認。 |
+| `gh` CLI 認証済み **または** `GITHUB_TOKEN` env | GitHub repo を作成して初回コミットを push | [`gh` をインストール](https://cli.github.com/) して `gh auth login` を実行、**または** `repo` スコープ付きの [personal access token](https://github.com/settings/tokens) を `GITHUB_TOKEN` として export。`--github-token <token>` を直接渡す場合は不要。 |
+| Amplify Hosting 用 IAM service role | Amplify が代理で backend リソースをデプロイするのに必要 | `--create-iam-role` を渡せば CLI が `AmplifyDeployBackend`（idempotent）を provision。または `--iam-service-role <arn>` で既存ロールを再利用。ロールは `amplify.amazonaws.com` を trust し、`AdministratorAccess-Amplify` を attach している必要があります。 |
+
+### 方法 2: コンソール（手動）
+
 1. **GitHub（または Amplify Hosting が対応する git ホスト）にこのプロジェクトを push**:
    ```bash
    git init && git add . && git commit -m "init"

package/dist/templates/_shared/README.md

@@ -10,9 +10,9 @@ If you use an AI coding agent (Claude Code, Cursor, Codex, etc.) on this project
 
 ## Requirements
 
-- **Node.js 20+** and **npm**
-- **AWS account** with CLI credentials (`aws configure`) — the sandbox + production both deploy real AWS resources
-- **GitHub account** for production hosting via AWS Amplify Hosting
+- **Node.js 20+** and **npm**.
+- **AWS account.** Install the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html), then `aws configure` to set credentials + default region. The sandbox + production both deploy real AWS resources.
+- **GitHub account** for production hosting via AWS Amplify Hosting. The CLI deploy flow ([below](#option-1-cli-one-shot-recommended)) also needs the [`gh` CLI](https://cli.github.com/) authenticated via `gh auth login` (or a `GITHUB_TOKEN` env var with `repo` scope). The manual console flow doesn't need `gh`.
 
 ## Commands
 
@@ -122,6 +122,43 @@ A redeploy is required for plugin changes (the plugin code ships in the Lambda b
 
 The shipped [`amplify.yml`](./amplify.yml) runs `npx ampx pipeline-deploy` (Amplify backend) + `npm run build` (Next.js) on every push to the branch you connect.
 
+### Option 1: CLI one-shot (recommended)
+
+From inside this project directory:
+
+```bash
+npx create-ampless@latest --mount \
+  --github-owner <your-user-or-org> \
+  --aws-region <region> \
+  --create-iam-role           # first time only; reuse `--iam-service-role <arn>` on later mounts
+```
+
+The CLI:
+
+1. Creates a GitHub repo (uses your authenticated `gh` CLI, the `GITHUB_TOKEN` env var, or the `--github-token` flag).
+2. Pushes this project to that repo.
+3. Provisions an Amplify Hosting app + branch, registers the GitHub connection, writes the `amplify.yml` build spec.
+4. Kicks off the first deploy.
+
+Useful extra flags:
+
+- `--github-private` — private repo (default: public)
+- `--domain <name>` `--subdomain <prefix>` — bind a custom domain in the same pass
+- `--skip-confirm` — non-interactive (good for CI / re-runs)
+- `--aws-profile <name>` — explicit AWS profile when you have multiple
+
+See `npx create-ampless@latest --help` for the full list.
+
+**Prerequisites for this flow (in addition to the [top-level Requirements](#requirements)):**
+
+| | Why | How |
+|---|---|---|
+| `aws` CLI authenticated | Provisions the Amplify Hosting app + service role | [Install](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and run `aws configure` (or `aws sso login`). Verify with `aws sts get-caller-identity`. |
+| `gh` CLI authenticated **or** `GITHUB_TOKEN` env | Creates the GitHub repo and pushes the initial commit | [Install `gh`](https://cli.github.com/) and `gh auth login`, **or** export a [personal access token](https://github.com/settings/tokens) with `repo` scope as `GITHUB_TOKEN`. Skip if you pass `--github-token <token>` directly. |
+| IAM service role for Amplify Hosting | Lets Amplify deploy backend resources on your behalf | Either pass `--create-iam-role` to have the CLI provision one named `AmplifyDeployBackend` (idempotent), or pass `--iam-service-role <arn>` to reuse an existing role. The role must trust `amplify.amazonaws.com` and have `AdministratorAccess-Amplify` attached. |
+
+### Option 2: Console (manual)
+
 1. **Push this project to GitHub** (or another git host Amplify Hosting supports):
    ```bash
    git init && git add . && git commit -m "init"

package/dist/templates/_shared/RUNBOOK.ja.md

@@ -24,7 +24,7 @@ ampless で構築したサイトで、ときどき必要になる運用作業の
 
 ### なぜ API キーなのか（Identity Pool ゲストロールではなく）？
 
-Amplify Gen 2 の `a.handler.custom` リゾルバーは `allow.guest()` や `allow.authenticated('identityPool')` をサポートしておらず、apiKey / userPool / lambda / group / owner のみが使用可能です。v0.1 では簡潔さを優先して API キーを選択しました。パブリック読み取りを Lambda 関数データソース（`a.handler.function`）に移行することは v0.2 の候補です。
+Amplify Gen 2 の `a.handler.custom` リゾルバーは `allow.guest()` や `allow.authenticated('identityPool')` をサポートしておらず、apiKey / userPool / lambda / group / owner のみが使用可能です。ampless では簡潔さを優先して API キーを選択しています。パブリック読み取りを Lambda 関数データソース（`a.handler.function`）に移行することは将来の選択肢です。
 
 ### 自動更新 — ローテーション手順は不要
 
@@ -87,11 +87,11 @@ aws cognito-idp admin-set-user-password \
 
 ### Post テーブルのバックアップからの復元
 
-DynamoDB のポイントインタイムリカバリ（PITR）は v0.1 の `defineData` では有効になっていません。AWS コンソール → DynamoDB → Tables → `<投稿テーブル名>` → Backups → Edit PITR から手動で有効化してください。有効化後は `aws dynamodb restore-table-to-point-in-time` で新しいテーブルに復元し、その後アイテムをライブテーブルに移行する作業が必要です。
+DynamoDB のポイントインタイムリカバリ（PITR）は `defineData` では有効になっていません。AWS コンソール → DynamoDB → Tables → `<投稿テーブル名>` → Backups → Edit PITR から手動で有効化してください。有効化後は `aws dynamodb restore-table-to-point-in-time` で新しいテーブルに復元し、その後アイテムをライブテーブルに移行する作業が必要です。
 
 ### 失敗したプラグインイベントの確認
 
-処理に失敗したプロセッサー呼び出しは、`amplify/backend.ts` で作成された共有イベント DLQ（`EventsDlq`）に送られます。SQS コンソールまたは `aws sqs receive-message --queue-url <dlq-url> --max-number-of-messages 10` でメッセージを確認してください。v0.1 には自動アラームがないため、定期的な手動確認を推奨します。あるいは `ApproximateNumberOfMessagesVisible` に CloudWatch アラームを設定してください。
+処理に失敗したプロセッサー呼び出しは、`amplify/backend.ts` で作成された共有イベント DLQ（`EventsDlq`）に送られます。SQS コンソールまたは `aws sqs receive-message --queue-url <dlq-url> --max-number-of-messages 10` でメッセージを確認してください。ampless にはデフォルトの自動アラームがないため、定期的な手動確認を推奨します。あるいは `ApproximateNumberOfMessagesVisible` に CloudWatch アラームを設定してください。
 
 ## カスタムドメイン
 

package/dist/templates/_shared/RUNBOOK.md

@@ -31,9 +31,9 @@ return rows where `status === 'published'`.
 
 Amplify Gen 2 `a.handler.custom` resolvers don't support `allow.guest()`
 or `allow.authenticated('identityPool')` — only apiKey / userPool /
-lambda / group / owner. v0.1 chose API key for simplicity; switching
-the public reads to a Lambda function data source (`a.handler.function`)
-is a v0.2 candidate.
+lambda / group / owner. ampless uses the API key for simplicity;
+moving the public reads to a Lambda function data source
+(`a.handler.function`) is a future option.
 
 ### Auto-renewal — no rotation runbook required
 
@@ -101,8 +101,8 @@ The `/login` page also has a self-service "Forgot password?" flow.
 
 ### Restore from a Post-table backup
 
-DynamoDB Point-in-Time Recovery is **not** enabled by `defineData` in
-v0.1; turn it on manually via AWS Console → DynamoDB → Tables →
+DynamoDB Point-in-Time Recovery is **not** enabled by `defineData`;
+turn it on manually via AWS Console → DynamoDB → Tables →
 `<your post table>` → Backups → Edit PITR. Once enabled, restoration
 takes the form `aws dynamodb restore-table-to-point-in-time` to a new
 table; you'll need to migrate items back to the live table afterwards.
@@ -112,8 +112,9 @@ table; you'll need to migrate items back to the live table afterwards.
 Failed processor invocations land in the shared events DLQ created in
 `amplify/backend.ts` (`EventsDlq`). View messages via the SQS console
 or `aws sqs receive-message --queue-url <dlq-url> --max-number-of-messages 10`.
-There's no automated alarm in v0.1 — periodic manual checks recommended,
-or wire up a CloudWatch alarm on `ApproximateNumberOfMessagesVisible`.
+ampless doesn't ship an automated alarm out of the box — periodic
+manual checks are recommended, or wire up a CloudWatch alarm on
+`ApproximateNumberOfMessagesVisible`.
 
 ## Custom domains
 

package/dist/templates/_shared/lib/kv-provider.ts

@@ -1,7 +1,8 @@
-// Back-compat shim. KvStore provider installation moved to
-// `@ampless/admin` (L2 extraction). The install runs automatically
-// inside the admin's <AdminProviders> bootstrap, so a side-effect
-// `import '@/lib/kv-provider'` is no longer required — kept as a
-// safe no-op for legacy callers.
+// Back-compat shim. KvStore provider installation lives in
+// `@ampless/admin` and runs automatically inside the admin's
+// <AdminProviders> bootstrap, so a side-effect
+// `import '@/lib/kv-provider'` is not required. Kept as a safe
+// no-op so existing user code that still imports this path keeps
+// working.
 
 export {}

package/dist/templates/_shared/lib/posts-provider.ts

@@ -1,7 +1,8 @@
-// Back-compat shim. Admin Posts provider installation moved to
-// `@ampless/admin` (L2 extraction). The install runs automatically
-// inside the admin's <AdminProviders> bootstrap, so a side-effect
-// `import '@/lib/posts-provider'` is no longer required — kept as a
-// safe no-op for legacy callers.
+// Back-compat shim. Admin Posts provider installation lives in
+// `@ampless/admin` and runs automatically inside the admin's
+// <AdminProviders> bootstrap, so a side-effect
+// `import '@/lib/posts-provider'` is not required. Kept as a safe
+// no-op so existing user code that still imports this path keeps
+// working.
 
 export {}

package/dist/templates/_shared/package.json

@@ -22,15 +22,15 @@
     "@tiptap/pm": "^3.23.4",
     "@tiptap/react": "^3.23.4",
     "@tiptap/starter-kit": "^3.23.4",
-    "@ampless/plugin-og-image": "^0.2.0-alpha.10",
-    "@ampless/plugin-rss": "^0.2.0-alpha.10",
-    "@ampless/plugin-seo": "^0.2.0-alpha.10",
-    "@ampless/plugin-webhook": "^0.2.0-alpha.10",
-    "@ampless/admin": "^1.0.0-alpha.27",
-    "@ampless/backend": "^1.0.0-alpha.20",
-    "@ampless/runtime": "^1.0.0-alpha.14",
+    "@ampless/plugin-og-image": "^0.2.0-alpha.11",
+    "@ampless/plugin-rss": "^0.2.0-alpha.11",
+    "@ampless/plugin-seo": "^0.2.0-alpha.11",
+    "@ampless/plugin-webhook": "^0.2.0-alpha.11",
+    "@ampless/admin": "^1.0.0-alpha.28",
+    "@ampless/backend": "^1.0.0-alpha.21",
+    "@ampless/runtime": "^1.0.0-alpha.15",
     "@digital-go-jp/tailwind-theme-plugin": "^0.3.4",
-    "ampless": "^1.0.0-alpha.10",
+    "ampless": "^1.0.0-alpha.11",
     "aws-amplify": "^6.10.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ampless",
-  "version": "1.0.0-alpha.41",
+  "version": "1.0.0-alpha.44",
   "description": "Create a new ampless project",
   "license": "MIT",
   "type": "module",