create-ampless 1.0.0-alpha.57 → 1.0.0-alpha.59

package/dist/index.js

@@ -1747,16 +1747,7 @@ 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",
-  // Split into app/raw/[slug]/route.ts + app/static/[slug]/[[...path]]/route.ts.
-  // The old unified internal handler at app/r/[slug]/[[...path]]/route.ts
-  // is no longer wired to anything (middleware rewrites to /raw or
-  // /static now).
-  "app/r/[slug]/[[...path]]/route.ts"
-];
+var AMPLESS_RETIRED_PATHS = [];
 var AMPLESS_PACKAGES = /* @__PURE__ */ new Set([
   "ampless",
   "@ampless/admin",

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

@@ -36,42 +36,31 @@
 - `.amplify/` — Amplify CLI の作業ディレクトリ。
 - `pnpm-lock.yaml` / `package-lock.json` — パッケージマネージャーに任せる。
 
-## テーマのカスタマイズ（標準的な手順）
+## テーマのカスタマイズ
 
-1. 公式テーマをコピーする:
-   ```bash
-   npm run copy-theme blog my-blog
-   ```
-   `my-` プレフィックスがついているコピーは `npm run update-ampless` で上書きされない。ターゲット名が `my-` で始まらない場合、コマンドは実行を拒否する。
+テーマのカスタマイズ手順 — ベーステーマの選び方、`themes/my-*/`
+へのコピーフロー、Claude Design からの反映、AI 支援の実装、
+レスポンシブの目視確認、Markdown 要素のデザイン方針、よくある失敗
+— は [THEMES.ja.md](./THEMES.ja.md) を参照する。
 
-2. 以下の優先順位で編集する:
-   - `themes/my-blog/tokens.css` — 色、タイポグラフィ、スペーシング（`[data-theme='my-blog']` スコープの CSS カスタムプロパティ）。
-   - `themes/my-blog/manifest.ts` — 管理 UI（`/admin/sites/<id>/theme`）に公開するフィールドの宣言。
-   - `themes/my-blog/pages/` — レイアウト / 構造（Next.js ページモジュール: フィード、サイトマップ、投稿テンプレート）。
+## MCP サーバー（HTTP トランスポート）
 
-3. テーマを有効化する: `/admin/sites/<siteId>/theme` を開き、`my-blog` を選択する。テーマ切り替えはランタイム設定 — 再デプロイは不要。
-
-4. 動作確認:
-   ```bash
-   npm run dev   # http://localhost:3000
-   ```
-
-## MCP サーバー（`@ampless/mcp-server`）
-
-エージェントが投稿コンテンツを直接クエリ・編集できる。公開ツール: `list_posts`、`get_post`、`create_post`、`update_post`、`delete_post`、`upload_media`、`get_schema`。
+エージェントが `mcp-handler` Lambda 経由で投稿コンテンツを直接クエリ・編集できる。公開ツール: `list_posts`、`get_post`、`create_post`、`update_post`、`delete_post`、`upload_media`、`get_schema`、`upload_static_bundle`、`list_static_files`、`delete_static_file`、`get_site_context`。
 
 登録方法:
 
-プロジェクトルートの `.mcp.json` に追加する:
+1. 管理画面の `/admin/mcp-tokens` で Bearer トークンを発行する。
+2. Amplify コンソールまたは `amplify_outputs.json` で `mcp-handler` の Function URL を確認する。
+3. プロジェクトルートの `.mcp.json` に追加する：
+
 ```json
 {
   "mcpServers": {
     "ampless": {
-      "command": "npx",
-      "args": ["-y", "@ampless/mcp-server", "--outputs", "./amplify_outputs.json"],
-      "env": {
-        "AMPLESS_MCP_EMAIL": "<your-admin-email>",
-        "AMPLESS_MCP_PASSWORD": "<your-admin-password>"
+      "url": "https://<function-url-id>.lambda-url.<region>.on.aws/",
+      "transport": "http",
+      "headers": {
+        "Authorization": "Bearer amk_..."
       }
     }
   }
@@ -99,6 +88,7 @@ UI / テーマを変更した場合、型チェックだけを根拠にタスク
 
 ## 参照先
 
+- `THEMES.ja.md` — テーマカスタマイズの実務ガイド（ベーステーマの選び方、Claude Design からの反映、AI への依頼、ブラウザ確認、Markdown 要素のスタイリング、よくある失敗）。
 - `README.ja.md` — サイト運営者向けの日常利用ガイド。
 - `RUNBOOK.ja.md` — 定期的な運用手順（キーローテーション、バックアップ復元など）。
 - `themes/<name>/README.ja.md` — テーマごとのカスタマイズ詳細。

package/dist/templates/_shared/AGENTS.md

@@ -36,42 +36,31 @@ This file is written for AI coding agents (Claude Code, Cursor, Codex, etc.). Fo
 - `.amplify/` — Amplify CLI working directory.
 - `pnpm-lock.yaml` / `package-lock.json` — let the package manager update these.
 
-## Customising a theme (the standard flow)
+## Theme customization
 
-1. Copy an official theme:
-   ```bash
-   npm run copy-theme blog my-blog
-   ```
-   The `my-` prefix marks the copy as user-owned so `npm run update-ampless` leaves it alone. The target name must start with `my-` or the command refuses to run.
+For theme customization workflows — choosing a base theme, the
+standard copy-and-edit flow, Claude Design handoff, AI-assisted
+implementation, responsive visual QA, Markdown styling expectations,
+and the common failure modes — see [THEMES.md](./THEMES.md).
 
-2. Edit in this priority order:
-   - `themes/my-blog/tokens.css` — colours, typography, spacing (CSS custom properties scoped under `[data-theme='my-blog']`).
-   - `themes/my-blog/manifest.ts` — declare which fields are exposed in the admin UI (`/admin/sites/<id>/theme`).
-   - `themes/my-blog/pages/` — layout / structure (Next.js page modules: feed, sitemap, post templates).
+## MCP server (HTTP transport)
 
-3. Activate the theme: open `/admin/sites/<siteId>/theme` and select `my-blog`. Theme switching is a runtime setting — no redeploy needed.
-
-4. Verify:
-   ```bash
-   npm run dev   # http://localhost:3000
-   ```
-
-## MCP server (`@ampless/mcp-server`)
-
-Lets agents query and modify post content directly. Tools exposed: `list_posts`, `get_post`, `create_post`, `update_post`, `delete_post`, `upload_media`, `get_schema`.
+Lets agents query and modify post content directly via the `mcp-handler` Lambda. Tools exposed: `list_posts`, `get_post`, `create_post`, `update_post`, `delete_post`, `upload_media`, `get_schema`, `upload_static_bundle`, `list_static_files`, `delete_static_file`, `get_site_context`.
 
 Registration:
 
-Add to `.mcp.json` at the project root:
+1. Issue a Bearer token from `/admin/mcp-tokens` in the admin UI.
+2. Find the `mcp-handler` Function URL in the Amplify console or `amplify_outputs.json`.
+3. Add to `.mcp.json` at the project root:
+
 ```json
 {
   "mcpServers": {
     "ampless": {
-      "command": "npx",
-      "args": ["-y", "@ampless/mcp-server", "--outputs", "./amplify_outputs.json"],
-      "env": {
-        "AMPLESS_MCP_EMAIL": "<your-admin-email>",
-        "AMPLESS_MCP_PASSWORD": "<your-admin-password>"
+      "url": "https://<function-url-id>.lambda-url.<region>.on.aws/",
+      "transport": "http",
+      "headers": {
+        "Authorization": "Bearer amk_..."
       }
     }
   }
@@ -99,6 +88,7 @@ Do not report a task complete based solely on type checks if a UI/theme was modi
 
 ## See also
 
+- `THEMES.md` — theme customization workflows (base-theme selection, Claude Design handoff, AI prompts, browser QA, Markdown styling, common pitfalls).
 - `README.md` — day-to-day usage for site owners.
 - `RUNBOOK.md` — occasional ops procedures (key rotation, backup restore, etc.).
 - `themes/<name>/README.md` — per-theme customization details.

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

@@ -86,7 +86,13 @@ npm run sandbox
 npm run copy-theme
 ```
 
-独自テーマを作る場合: 既存テーマをコピーから始める（`cp -R themes/blog themes/your-theme`）→ `manifest.ts`、`tokens.css`、`pages/*.tsx` を編集 → `themes-registry.ts` に追加。フルガイド: [docs/THEMES.ja.md](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.ja.md) ([English](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.md))
+インストール済みテーマを `npm run update-ampless` で上書きされない形でカスタマイズしたい場合は、`my-` プレフィックス付きにコピーする:
+
+```bash
+npm run copy-theme blog my-blog
+```
+
+テーマカスタマイズの実務ガイド — ベーステーマの選び方、コピー / 編集 / 切り替えの標準フロー、Claude Design からの反映、AI を使った実装、レスポンシブ確認、Markdown 要素のスタイリング、よくある失敗 — はこのプロジェクト内の [THEMES.ja.md](./THEMES.ja.md)（[English](./THEMES.md)）に集約しています。
 
 ## プラグイン
 
@@ -184,9 +190,29 @@ Amplify Hosting アプリの **Domain management** からドメインをバイ
 
 ## AI 連携（MCP）
 
-ampless は MCP（Model Context Protocol）サーバーを同梱しているので、Claude Desktop / Cursor / Claude Code など MCP に対応した AI クライアントから投稿の読み書きができます。
+ampless は HTTP トランスポート + Bearer トークン認証による MCP（Model Context Protocol）サーバーを同梱しているので、Claude Desktop / Cursor / Claude Code など MCP に対応した AI クライアントから投稿の読み書きができます。
+
+**セットアップ手順:**
+
+1. 管理画面の `/admin/mcp-tokens` にアクセスし、Bearer トークン（`amk_...`）を発行する。
+2. Amplify コンソールまたは `amplify_outputs.json` で `mcp-handler` Lambda の Function URL を確認する。
+3. MCP クライアントの設定ファイル（プロジェクトルートの `.mcp.json`、`claude_desktop_config.json` など）にエントリを追加する：
+
+```json
+{
+  "mcpServers": {
+    "ampless": {
+      "url": "https://<function-url-id>.lambda-url.<region>.on.aws/",
+      "transport": "http",
+      "headers": {
+        "Authorization": "Bearer amk_..."
+      }
+    }
+  }
+}
+```
 
-- **ローカル / sandbox** — グローバルに 1 度入れる: `npx -y @ampless/mcp-server@alpha` に `amplify_outputs.json` のパスを渡す
+MCP のセットアップとトークン管理の詳細については [docs/architecture/04-access-layer-mcp.md](./docs/architecture/04-access-layer-mcp.md) を参照してください。
 
 ## ampless の更新
 

package/dist/templates/_shared/README.md

@@ -86,7 +86,13 @@ To install another official theme into this project:
 npm run copy-theme
 ```
 
-To author your own theme: copy an existing one as a starting point (`cp -R themes/blog themes/your-theme`), edit `manifest.ts`, `tokens.css`, and `pages/*.tsx`, then add it to `themes-registry.ts`. Full guide: [docs/THEMES.md](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.md) ([日本語](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.ja.md)).
+To customize an installed theme without losing the customization on `npm run update-ampless`, copy it under the `my-` prefix:
+
+```bash
+npm run copy-theme blog my-blog
+```
+
+The full working guide for theme customization — base-theme selection, the standard copy / edit / activate flow, Claude Design handoff, AI-assisted implementation, responsive QA, Markdown styling, and the common pitfalls — lives in [THEMES.md](./THEMES.md) (and [THEMES.ja.md](./THEMES.ja.md)) right in this project.
 
 ## Plugins
 
@@ -184,9 +190,29 @@ Bind a domain to your Amplify Hosting app in **Domain management** — Amplify p
 
 ## AI integration (MCP)
 
-ampless ships an MCP (Model Context Protocol) server so Claude Desktop / Cursor / Claude Code / anything that speaks MCP can read and write your posts.
+ampless ships an MCP (Model Context Protocol) server so Claude Desktop / Cursor / Claude Code / anything that speaks MCP can read and write your posts via HTTP transport with Bearer token authentication.
+
+**Setup:**
+
+1. Go to `/admin/mcp-tokens` in your admin UI and issue a Bearer token (`amk_...`).
+2. Find the `mcp-handler` Lambda Function URL in your Amplify console or `amplify_outputs.json`.
+3. Add an entry to your MCP client's config (`.mcp.json` at the project root, `claude_desktop_config.json`, etc.):
+
+```json
+{
+  "mcpServers": {
+    "ampless": {
+      "url": "https://<function-url-id>.lambda-url.<region>.on.aws/",
+      "transport": "http",
+      "headers": {
+        "Authorization": "Bearer amk_..."
+      }
+    }
+  }
+}
+```
 
-- **Local / sandbox** — install once globally: `npx -y @ampless/mcp-server@alpha` with the path to your `amplify_outputs.json`.
+See [docs/architecture/04-access-layer-mcp.md](./docs/architecture/04-access-layer-mcp.md) for the full MCP setup and token management guide.
 
 ## Updating ampless