ampless 1.0.0-beta.56 → 1.0.0-beta.58

package/dist/index.d.ts

@@ -337,6 +337,20 @@ type ScriptStrategy = 'afterInteractive' | 'lazyOnload';
  * per-post context lands in Phase 4 (`plugin-per-post-rfp.md`).
  */
 interface PluginPublicRenderContext {
+    /**
+     * The site's `name` / `url` / `description` block. When the caller
+     * wires `@ampless/runtime`'s `createPluginHead(cmsConfig, pluginSettings,
+     * siteSettings)` with its third argument (as `createAmpless` does), this
+     * is the **effective** site settings — the S3-cached admin
+     * `settings.public` override merged over the `cms.config.ts` defaults,
+     * the same value the `/<slug>.md` route's canonical line uses — not
+     * merely a static passthrough of `cms.config.ts`. It falls back to the
+     * `cms.config.ts` block on a site-settings fetch failure, or entirely
+     * when the caller omits `siteSettings` (the two-argument
+     * `createPluginHead` call, kept for backward compatibility). The type
+     * shape (`{ name, url, description? }`) does not change either way —
+     * only which value populates it.
+     */
     site: Config['site'];
     /**
      * Resolve a public setting value for the active plugin instance.
@@ -1638,6 +1652,14 @@ interface HistoryConfig {
 interface AiConfig {
     /** Serve the per-post markdown projection at `/<slug>.md`. Default: true. */
     markdownRoutes?: boolean;
+    /** Serve a site-wide AI index at `/llms.txt`. `false` disables the
+     *  route; an object caps how many recent posts are listed (the
+     *  underlying published index returns full bodies, so large limits
+     *  are comparatively expensive for now).
+     *  Default: enabled with `{ limit: 100 }` (clamped to 1..1000). */
+    llmsTxt?: boolean | {
+        limit?: number;
+    };
 }
 type Role = 'reader' | 'editor' | 'admin';
 interface AuthContext {

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

@@ -351,6 +351,8 @@ SSR がデッドラインなしでブロックします。ネットワーク呼
 
 `ctx.setting()` は Phase 2 で追加された admin 管理値アクセッサ — §8 参照。
 
+**`ctx.site` は `cms.config.ts` の静的な値そのままではなく、実効 site 設定です。** ホストアプリが `@ampless/runtime` の `createPluginHead(cmsConfig, pluginSettings, siteSettings)` を第 3 引数つきで配線している場合（`createAmpless` は標準でこう配線しており、サイト側のコード変更は不要）、`ctx.site` は admin の `settings.public` override を `cms.config.ts` のデフォルトにマージした値 — `/<slug>.md` ルートの canonical 行が使うのと同じ実効値 — を反映します。site settings の取得に失敗した場合は `cms.config.ts` の値にフォールバックします。型の形（`{ name, url, description? }`）は変わらず、値の意味だけが変わります。`ctx.site.url` から絶対 URL を組み立てるプラグイン（例: `@ampless/plugin-ai-actions` の外部 AI リンク）は、再デプロイなしで admin が編集した site URL の変更を自動的に反映します。
+
 ---
 
 ## 6. Descriptor リファレンス
@@ -1693,6 +1695,8 @@ it('admin が空文字保存した場合は空配列', () => {
 - [`packages/plugin-webhook`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-webhook) — trusted hook + 外向き HTTP + `secretSettings` (admin 管理の signing secret、Phase 6a)
 - [`packages/plugin-og-image`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-og-image) — `ogImage` ルートレンダラ
 - [`packages/plugin-schema-jsonld`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-schema-jsonld) — `publicBodyForPost` + `schema` capability、投稿単位 Article JSON-LD。（Phase 4）
+- [`packages/plugin-reading-time`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-reading-time) — `publicHtmlForPost`、語数推定を本文の前後に `<p>` バッジとして描画。（Phase 6d）
+- [`packages/plugin-ai-actions`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-ai-actions) — `publicHtmlForPost`、`ctx.site.url`（実効 site 設定）と投稿の `/<slug>.md` URL から「Markdown で表示」+ opt-in の「Claude で開く」/「ChatGPT で開く」リンクを組み立てる。（AI-readable publishing ロードマップ Phase B）
 
 ---
 

package/docs/plugin-author-guide.md

@@ -434,6 +434,19 @@ The `ctx` object carries:
 `ctx.setting()` is the Phase 2 admin-managed values accessor — see
 §8.
 
+**`ctx.site` is the effective site settings, not a static passthrough of
+`cms.config.ts`.** When the host app wires `@ampless/runtime`'s
+`createPluginHead(cmsConfig, pluginSettings, siteSettings)` with its third
+argument (as `createAmpless` does — this is the standard wiring, no site
+code changes needed), `ctx.site` reflects admin `settings.public`
+overrides merged over the `cms.config.ts` defaults — the same effective
+value the `/<slug>.md` route's canonical line uses. It falls back to the
+`cms.config.ts` block on a site-settings fetch failure. The shape
+(`{ name, url, description? }`) is unchanged; only which value populates
+it. Plugins that build absolute URLs from `ctx.site.url` (e.g.
+`@ampless/plugin-ai-actions`'s external AI links) automatically track
+admin-edited site URL changes without a redeploy.
+
 ---
 
 ## 6. Descriptor reference
@@ -2308,6 +2321,8 @@ Worked examples to crib from:
 - [`packages/plugin-webhook`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-webhook) — trusted hook with outbound HTTP + `secretSettings` (admin-managed signing secret, Phase 6a).
 - [`packages/plugin-og-image`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-og-image) — `ogImage` route renderer.
 - [`packages/plugin-schema-jsonld`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-schema-jsonld) — `publicBodyForPost` + `schema` capability; per-post Article JSON-LD. (Phase 4)
+- [`packages/plugin-reading-time`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-reading-time) — `publicHtmlForPost`; word-count estimate rendered as a `<p>` badge before/after the post body. (Phase 6d)
+- [`packages/plugin-ai-actions`](https://github.com/heavymoons/ampless/tree/main/packages/plugin-ai-actions) — `publicHtmlForPost`; "View as Markdown" + opt-in "Open in Claude" / "Open in ChatGPT" links built from `ctx.site.url` (effective site settings) and the post's `/<slug>.md` URL. (AI-readable publishing roadmap, Phase B)
 
 ---
 

package/package.json

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