@c-time/frelio-cli 1.4.0 → 1.4.1

package/dist/core/workflows.js

@@ -66,7 +66,9 @@ jobs:
           command: pages deploy dist --project-name=${config.adminPagesProjectName}
 `;
         case 'build-staging':
-            return `name: Build Staging
+            return `# staging ブランチ（デフォルト + カスタム）への push で発火し、SSG を実行する。
+# カスタム staging（staging-*）は artifact アップロードなし（プレビュー専用）。
+name: Build Staging
 on:
   push:
     branches: [staging, 'staging-*']
@@ -83,6 +85,8 @@ jobs:
         with:
           node-version: 20
           cache: 'npm'
+
+      # 前回のビルド状態を復元（差分ビルド用）
       - name: Restore SSG cache
         uses: actions/cache@v4
         with:
@@ -92,9 +96,22 @@ jobs:
           key: ssg-cache-\${{ github.ref_name }}-\${{ github.sha }}
           restore-keys: |
             ssg-cache-\${{ github.ref_name }}-
+
       - run: npm ci
-      - name: SSG Build
-        run: echo "TODO: Add SSG build steps"
+
+      # Phase 1: JSON 中間データ生成
+      - name: Generate JSON data
+        run: npx frelio-data-json-generator
+
+      # Phase 2: HTML 生成
+      - name: Generate HTML
+        run: npx frelio-gentl
+
+      # Phase 3: アセットビルド（静的アセットコピー + Vite）
+      - name: Build assets
+        run: npm run build
+
+      # デフォルト staging のみ: artifact をアップロード（本番デプロイ用）
       - name: Upload artifact
         if: github.ref == 'refs/heads/staging'
         uses: actions/upload-artifact@v4
@@ -102,6 +119,8 @@ jobs:
           name: staging-build
           path: public/
           retention-days: 14
+
+      # Cloudflare Pages にブランチプレビューとしてデプロイ
       - name: Deploy preview
         uses: cloudflare/wrangler-action@v3
         with:
@@ -110,7 +129,10 @@ jobs:
           command: pages deploy public --project-name=${config.pagesProjectName} --branch=\${{ github.ref_name }}
 `;
         case 'promote-production':
-            return `name: Promote to Production
+            return `# staging → main マージ（push to main）で発火。
+# 最新の staging artifact をダウンロードし、Pages 本番にデプロイする。
+# artifact 欠損時はフォールバックとしてフル SSG ビルドを実行する。
+name: Promote to Production
 on:
   push:
     branches: [main]
@@ -126,28 +148,101 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+
+      # 最新の成功した Build Staging ワークフロー run を検索
+      - name: Find latest staging build run
+        id: find-run
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const runs = await github.rest.actions.listWorkflowRuns({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              workflow_id: 'build-staging.yml',
+              branch: 'staging',
+              status: 'success',
+              per_page: 1,
+            });
+            if (runs.data.workflow_runs.length > 0) {
+              core.setOutput('run-id', runs.data.workflow_runs[0].id);
+            } else {
+              core.setOutput('run-id', '');
+            }
+
+      # cross-workflow artifact ダウンロード
       - name: Download staging artifact
+        id: download-artifact
+        if: steps.find-run.outputs.run-id != ''
+        continue-on-error: true
         uses: actions/download-artifact@v4
         with:
           name: staging-build
           path: public/
+          github-token: \${{ secrets.GITHUB_TOKEN }}
+          run-id: \${{ steps.find-run.outputs.run-id }}
+
+      # artifact 取得結果を判定
+      - name: Check if artifact was downloaded
+        id: check-artifact
+        run: |
+          if [ -d "public" ] && [ "\$(ls -A public 2>/dev/null)" ]; then
+            echo "has_artifact=true" >> "\$GITHUB_OUTPUT"
+          else
+            echo "::warning::Staging artifact not found or expired. Running full SSG build."
+            echo "has_artifact=false" >> "\$GITHUB_OUTPUT"
+          fi
+
+      # --- フォールバックビルド（artifact 欠損時のみ） ---
+      - name: Setup Node.js (fallback)
+        if: steps.check-artifact.outputs.has_artifact == 'false'
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies (fallback)
+        if: steps.check-artifact.outputs.has_artifact == 'false'
+        run: npm ci
+
+      - name: Full SSG build (fallback)
+        if: steps.check-artifact.outputs.has_artifact == 'false'
+        run: |
+          npx frelio-data-json-generator --full-rebuild
+          npx frelio-gentl
+          npm run build
+
+      # Cloudflare Pages 本番にデプロイ
       - name: Deploy to production
         uses: cloudflare/wrangler-action@v3
         with:
           apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
           accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           command: pages deploy public --project-name=${config.pagesProjectName} --branch=main
+
+      # デプロイタグ作成
       - name: Create deploy tag
         run: |
-          VERSION=\$(cat version.json | node -e "process.stdin.on('data',d=>console.log(JSON.parse(d).version))")
-          EXISTING=\$(git tag -l "d\${VERSION}.*" | wc -l)
-          NEXT=\$((EXISTING + 1))
-          TAG="d\${VERSION}.\${NEXT}"
-          git tag "\$TAG"
+          VERSION=\$(jq -r '.version' version.json 2>/dev/null || echo "0.0.0")
+          PREFIX="d\${VERSION}."
+
+          LATEST=\$(git tag -l "\${PREFIX}*" | sed "s/^\${PREFIX}//" | sort -n | tail -1)
+          NEXT=\$(( \${LATEST:-0} + 1 ))
+
+          TAG="\${PREFIX}\${NEXT}"
+          echo "Creating tag: \$TAG"
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "\$TAG" -m "Production deploy \$TAG"
           git push origin "\$TAG"
+
+          echo "::notice::Tagged as \$TAG"
 `;
         case 'direct-deploy':
-            return `name: Direct Deploy
+            return `# CMS の「直接デプロイ」ボタンから workflow_dispatch で発火。
+# develop → staging マージ → SSG ビルド → artifact → staging プレビュー →
+# staging → main マージ → 本番デプロイ → デプロイタグ付与
+name: Direct Deploy
 on:
   workflow_dispatch:
 
@@ -155,26 +250,96 @@ permissions:
   contents: write
 
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Merge develop to staging
+
+      - name: Configure git
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      # Step 1: develop → staging マージ
+      - name: Merge develop into staging
+        run: |
           git checkout staging
           git merge origin/develop --no-edit
           git push origin staging
-      - name: Wait for staging build
-        run: echo "Staging build will be triggered by the push above. Monitor build-staging.yml."
-      - name: Fast-forward main
+
+      # Step 2: SSG ビルド
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      # 前回の staging ビルド状態を復元（差分ビルド用）
+      - name: Restore SSG cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            frelio-data/site/data/data-json
+            public
+          key: ssg-cache-staging-\${{ github.sha }}
+          restore-keys: |
+            ssg-cache-staging-
+
+      - run: npm ci
+
+      - name: Generate JSON data
+        run: npx frelio-data-json-generator
+
+      - name: Generate HTML
+        run: npx frelio-gentl
+
+      - name: Build assets
+        run: npm run build
+
+      # Step 3: artifact アップロード
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: staging-build
+          path: public/
+          retention-days: 14
+
+      # Step 4: Cloudflare Pages プレビューデプロイ（staging ブランチ）
+      - name: Deploy staging preview
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy public --project-name=${config.pagesProjectName} --branch=staging
+
+      # Step 5: staging → main マージ
+      - name: Fast-forward main to staging
         run: |
           git checkout main
-          git merge staging --ff-only
+          git merge --ff-only staging
           git push origin main
+
+      # Step 6: Cloudflare Pages 本番デプロイ
+      - name: Deploy to production
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy public --project-name=${config.pagesProjectName} --branch=main
+
+      # Step 7: デプロイタグ作成
+      - name: Create deploy tag
+        run: |
+          VERSION=\$(jq -r '.version' version.json 2>/dev/null || echo "0.0.0")
+          PREFIX="d\${VERSION}."
+          LATEST=\$(git tag -l "\${PREFIX}*" | sed "s/^\${PREFIX}//" | sort -n | tail -1)
+          NEXT=\$(( \${LATEST:-0} + 1 ))
+          TAG="\${PREFIX}\${NEXT}"
+
+          git tag -a "\$TAG" -m "Direct deploy \$TAG"
+          git push origin "\$TAG"
+          echo "::notice::Tagged as \$TAG"
 `;
     }
 }

package/dist/lib/github-release.d.ts

@@ -0,0 +1,15 @@
+/**
+ * GitHub Release からの tarball ダウンロード
+ */
+type ReleaseAsset = {
+    name: string;
+    browser_download_url: string;
+};
+type Release = {
+    tag_name: string;
+    assets: ReleaseAsset[];
+};
+export declare function getLatestRelease(): Promise<Release>;
+export declare function getRelease(version: string): Promise<Release>;
+export declare function downloadTarball(release: Release, destDir: string): Promise<string>;
+export {};

package/dist/lib/github-release.js

@@ -0,0 +1,41 @@
+/**
+ * GitHub Release からの tarball ダウンロード
+ */
+import { createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import path from 'node:path';
+const REPO = 'ctime-projects/frelio';
+export async function getLatestRelease() {
+    const res = await fetch(`https://api.github.com/repos/${REPO}/releases/latest`, {
+        headers: { Accept: 'application/vnd.github.v3+json' },
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch latest release: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+export async function getRelease(version) {
+    const tag = version.startsWith('v') ? version : `v${version}`;
+    const res = await fetch(`https://api.github.com/repos/${REPO}/releases/tags/${tag}`, {
+        headers: { Accept: 'application/vnd.github.v3+json' },
+    });
+    if (!res.ok) {
+        throw new Error(`Release ${tag} not found: ${res.status}`);
+    }
+    return res.json();
+}
+export async function downloadTarball(release, destDir) {
+    const asset = release.assets.find((a) => a.name.endsWith('.tar.gz'));
+    if (!asset) {
+        throw new Error('No tarball found in release assets');
+    }
+    const destPath = path.join(destDir, asset.name);
+    const res = await fetch(asset.browser_download_url);
+    if (!res.ok || !res.body) {
+        throw new Error(`Failed to download: ${res.status}`);
+    }
+    const readable = Readable.fromWeb(res.body);
+    await pipeline(readable, createWriteStream(destPath));
+    return destPath;
+}

package/dist/lib/initial-content.js

@@ -111,8 +111,8 @@ export function generateInitialContent(projectDir) {
                 details: [
                     {
                         type: 'detail',
-                        outputPath: 'news/{$this.slug}/index.json',
-                        templatePath: 'news/_detail/index.html',
+                        outputPath: 'news/{$this.slug}.json',
+                        templatePath: 'news/detail.html',
                     },
                 ],
                 lists: [
@@ -206,8 +206,8 @@ function generateTemplates(projectDir) {
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Frelio Demo</title>
-  <link rel="stylesheet" href="/home/styles/index.css">
-  <script type="module" src="/home/scripts/index.js"></script>
+  <link rel="stylesheet" href="/styles/index.css">
+  <script type="module" src="/scripts/index.js"></script>
 </head>
 <body>
   <template data-gen-scope="" data-gen-include="_parts/header.htm"></template>
@@ -274,8 +274,8 @@ function generateTemplates(projectDir) {
 </body>
 </html>
 `);
-    // about.html
-    writeFile(t('about.html'), `<!DOCTYPE html>
+    // about/index.html
+    writeFile(t('about/index.html'), `<!DOCTYPE html>
 <html lang="ja">
 <head>
   <template data-gen-scope="" data-gen-include="_parts/head.htm"></template>
@@ -344,8 +344,8 @@ function generateTemplates(projectDir) {
 </body>
 </html>
 `);
-    // contact.html
-    writeFile(t('contact.html'), `<!DOCTYPE html>
+    // contact/index.html
+    writeFile(t('contact/index.html'), `<!DOCTYPE html>
 <html lang="ja">
 <head>
   <template data-gen-scope="" data-gen-include="_parts/head.htm"></template>
@@ -472,16 +472,16 @@ function generateTemplates(projectDir) {
 </body>
 </html>
 `);
-    // news/_detail/index.html
-    writeFile(t('news/_detail/index.html'), `<!DOCTYPE html>
+    // news/detail.html
+    writeFile(t('news/detail.html'), `<!DOCTYPE html>
 <html lang="ja">
 <head>
   <template data-gen-scope="" data-gen-include="_parts/head.htm"></template>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>記事タイトル | Frelio Demo</title>
-  <link rel="stylesheet" href="/news/detail/styles/index.css">
-  <script type="module" src="/news/detail/scripts/index.js"></script>
+  <link rel="stylesheet" href="/news/styles/index.css">
+  <script type="module" src="/news/scripts/index.js"></script>
 </head>
 <body>
   <template data-gen-scope="" data-gen-include="_parts/header.htm"></template>
@@ -535,10 +535,21 @@ function generateTemplates(projectDir) {
 </body>
 </html>
 `);
+    // .gitkeep for images directories
+    const gitkeepDirs = [
+        'common/images',
+        'images',
+        'about/images',
+        'contact/images',
+        'news/images',
+    ];
+    for (const dir of gitkeepDirs) {
+        writeFile(t(`${dir}/.gitkeep`), '');
+    }
 }
 // ========== SCSS ==========
 function generateScss(projectDir) {
-    const s = (...p) => path.join(projectDir, 'frelio-data/site/templates/assets/scss', ...p);
+    const s = (...p) => path.join(projectDir, 'frelio-data/site/templates/common/styles', ...p);
     // Foundation
     writeFile(s('foundation/_variables.scss'), `// Colors
 $color-primary: #0070f3;
@@ -1195,7 +1206,7 @@ button {
 }
 // ========== TypeScript ==========
 function generateTypeScript(projectDir) {
-    const ts = (...p) => path.join(projectDir, 'frelio-data/site/templates/assets/ts', ...p);
+    const ts = (...p) => path.join(projectDir, 'frelio-data/site/templates/common/scripts', ...p);
     writeFile(ts('features/mobile-nav.ts'), `export function initMobileNav(): void {
   const toggle = document.querySelector<HTMLButtonElement>('.c-nav__toggle')
   const list = document.querySelector<HTMLUListElement>('.c-nav__list')
@@ -1238,9 +1249,9 @@ function generateTypeScript(projectDir) {
 }
 // ========== Entry Points ==========
 function generateEntries(projectDir) {
-    const e = (...p) => path.join(projectDir, 'frelio-data/site/templates/assets/entries', ...p);
+    const t = (...p) => path.join(projectDir, 'frelio-data/site/templates', ...p);
     // common
-    writeFile(e('common/styles/index.scss'), `// Foundation
+    writeFile(t('common/styles/index.scss'), `// Foundation
 @use 'foundation/variables' as *;
 @use 'foundation/mixins' as *;
 @use 'foundation/reset';
@@ -1260,55 +1271,48 @@ function generateEntries(projectDir) {
 // Element
 @use 'element/e-heading';
 `);
-    writeFile(e('common/scripts/index.ts'), `import '../styles/index.scss'
-import { initMobileNav } from '@features/mobile-nav'
-import { initSmoothScroll } from '@features/smooth-scroll'
+    writeFile(t('common/scripts/index.ts'), `import '../styles/index.scss'
+import { initMobileNav } from './features/mobile-nav'
+import { initSmoothScroll } from './features/smooth-scroll'
 
 document.addEventListener('DOMContentLoaded', () => {
   initMobileNav()
   initSmoothScroll()
 })
 `);
-    // home
-    writeFile(e('home/styles/index.scss'), `@use 'foundation/variables' as *;
+    // home (root level — / maps to templates root)
+    writeFile(t('styles/index.scss'), `@use 'foundation/variables' as *;
 @use 'foundation/mixins' as *;
 
 @use 'project/p-hero';
 @use 'project/p-news-list';
 `);
-    writeFile(e('home/scripts/index.ts'), `import '../styles/index.scss'
+    writeFile(t('scripts/index.ts'), `import '../styles/index.scss'
 `);
     // about
-    writeFile(e('about/styles/index.scss'), `@use 'foundation/variables' as *;
+    writeFile(t('about/styles/index.scss'), `@use 'foundation/variables' as *;
 @use 'foundation/mixins' as *;
 
 @use 'project/p-about';
 `);
-    writeFile(e('about/scripts/index.ts'), `import '../styles/index.scss'
+    writeFile(t('about/scripts/index.ts'), `import '../styles/index.scss'
 `);
     // contact
-    writeFile(e('contact/styles/index.scss'), `@use 'foundation/variables' as *;
+    writeFile(t('contact/styles/index.scss'), `@use 'foundation/variables' as *;
 @use 'foundation/mixins' as *;
 
 @use 'project/p-contact';
 `);
-    writeFile(e('contact/scripts/index.ts'), `import '../styles/index.scss'
+    writeFile(t('contact/scripts/index.ts'), `import '../styles/index.scss'
 `);
-    // news
-    writeFile(e('news/styles/index.scss'), `@use 'foundation/variables' as *;
+    // news (list + detail share the same scripts/styles)
+    writeFile(t('news/styles/index.scss'), `@use 'foundation/variables' as *;
 @use 'foundation/mixins' as *;
 
 @use 'project/p-news-list';
-`);
-    writeFile(e('news/scripts/index.ts'), `import '../styles/index.scss'
-`);
-    // news/detail
-    writeFile(e('news/detail/styles/index.scss'), `@use 'foundation/variables' as *;
-@use 'foundation/mixins' as *;
-
 @use 'project/p-article';
 `);
-    writeFile(e('news/detail/scripts/index.ts'), `import '../styles/index.scss'
+    writeFile(t('news/scripts/index.ts'), `import '../styles/index.scss'
 `);
 }
 // ========== Build Scripts ==========
@@ -2071,13 +2075,13 @@ Frelio（ヘッドレス CMS）で構築されたサイトリポジトリ。
 ## プロジェクト構成
 
 - \`frelio-data/\` — CMS データ（コンテンツタイプ、コンテンツ、テンプレート、レシピ）
-  - \`site/templates/assets/scss/\` — 共有 SCSS パーシャル（FLOCSS 亜種）
-  - \`site/templates/assets/ts/\` — 共有 TypeScript（features/）
-  - \`site/templates/assets/entries/\` — ページ別エントリーポイント
-- \`public/\` — SSG 出力（HTML + ビルド済みアセット）
+  - \`site/templates/\` — テンプレート（配置 = 出力先 URL 構造）
+  - \`site/templates/common/styles/\` — 共有 SCSS パーシャル（FLOCSS 亜種）
+  - \`site/templates/common/scripts/\` — 共有 TypeScript（features/）
+  - \`site/data/data-json/\` — SSG 中間データ（git 追跡対象）
+- \`public/\` — SSG 出力（HTML + ビルド済みアセット、git 管理外）
 - \`functions/storage/\` — R2 ファイル配信（/storage/*）
 - \`scripts/\` — ビルドスクリプト（tsx）
-- \`public/images/\` — 静的ファイル（画像等、git 追跡対象）
 
 CMS 管理画面関連（\`admin/\`, \`functions/api/\`, \`workers/\`, \`wrangler.toml\`, \`_redirects\`）は
 \`npx @frelio/cli update\` で追加・更新される。
@@ -2086,7 +2090,7 @@ CMS 管理画面関連（\`admin/\`, \`functions/api/\`, \`workers/\`, \`wrangle
 
 \`\`\`bash
 npm run dev                # Vite dev server（テンプレートプレビュー + コンテンツ監視）
-npm run build              # SCSS/TS ビルド（ページ別エントリー）
+npm run build              # 静的アセットコピー + SCSS/TS ビルド（ページ別エントリー）
 npm run generate           # data-json 生成（差分ビルド）
 npm run generate:full      # data-json 生成（フルリビルド）
 npm run generate:html      # HTML 生成（data-json → public/）
@@ -2108,23 +2112,50 @@ npx @frelio/cli add-staging  # カスタムステージング追加
 5. sitemap.xml 生成           (npm run generate:sitemap)
 \`\`\`
 
-## ページ別エントリーポイント
+## テンプレート構造（= URL 構造）
 
-アセットはページ単位でコード分割される。各ページに \`styles/index.scss\` と \`scripts/index.ts\` がある。
+テンプレートの配置がそのまま出力先の URL パスになる。各ページに \`styles/index.scss\` と \`scripts/index.ts\` がある。
 
 \`\`\`
-assets/entries/
-├── common/    — 全ページ共通（foundation, layout, component, element + JS初期化）
-├── home/      — トップページ（p-hero, p-news-list）
-├── about/     — 会社概要（p-about）
-├── contact/   — お問い合わせ（p-contact）
-├── news/      — お知らせ一覧（p-news-list）
-└── news/detail/ — 記事詳細（p-article）
+frelio-data/site/templates/
+├── _parts/              — 共通パーツ（head.htm, header.htm, footer.htm）
+├── common/              — 全ページ共通
+│   ├── scripts/         — JS 初期化 + features/
+│   ├── styles/          — SCSS パーシャル（FLOCSS: foundation/, layout/, component/, element/, project/）
+│   └── images/          — favicon, logo 等
+├── index.html           — / （ホーム）
+├── scripts/index.ts     — ホーム用 JS
+├── styles/index.scss    — ホーム用 CSS（p-hero, p-news-list）
+├── images/              — ホーム画像
+├── about/               — /about/
+│   ├── index.html
+│   ├── scripts/index.ts
+│   ├── styles/index.scss（p-about）
+│   └── images/
+├── contact/             — /contact/
+│   ├── index.html
+│   ├── scripts/index.ts
+│   ├── styles/index.scss（p-contact）
+│   └── images/
+└── news/                — /news/
+    ├── index.html       — 一覧テンプレート
+    ├── detail.html      — 詳細テンプレート（レシピで news/{slug}.html に展開）
+    ├── scripts/index.ts — 一覧・詳細で共有
+    ├── styles/index.scss（p-news-list, p-article）
+    └── images/
 \`\`\`
 
 - \`_parts/head.htm\` で common の CSS/JS を読み込み
 - 各ページテンプレートでページ固有の CSS/JS を読み込み
 
+### スラッグ展開
+
+テンプレートファイル名と出力パスの対応はレシピ（\`build-data-recipe.json\`）で制御する。
+gentl の規約ではなく、レシピの書き方次第。
+
+- **ファイルベース**: \`news/detail.html\` → \`news/{slug}.html\`（現在の設定）
+- **ディレクトリベース**: \`news/_detail/index.html\` → \`news/{slug}/index.html\`（別方式、必要に応じて変更可）
+
 ## CSS 記法ルール（FLOCSS 亜種・厳格）
 
 - **プレフィックス**: \`l-\`（layout）、\`c-\`（component）、\`p-\`（project）、\`e-\`（element）のみ
@@ -2145,16 +2176,17 @@ assets/entries/
 
 ## TypeScript ルール
 
-- 共通の初期化ロジックは \`entries/common/scripts/index.ts\` に集約
-- 各機能は \`assets/ts/features/\` にファイル分離
-- ページ固有の JS が必要な場合は \`entries/{page}/scripts/index.ts\` に追加
+- 共通の初期化ロジックは \`common/scripts/index.ts\` に集約
+- 各機能は \`common/scripts/features/\` にファイル分離
+- ページ固有の JS が必要な場合は \`{page}/scripts/index.ts\` に追加
 
 ## テンプレート規約
 
 - テンプレートエンジン: gentl（\`data-gen-*\` 属性ベース）
 - テンプレートは valid HTML（そのままブラウザで開ける）
 - 共通パーツ: \`_parts/*.htm\`（head, header, footer）
-- ページテンプレート: \`*.html\`
+- ページテンプレート: \`{page}/index.html\`（ホームは \`index.html\`）
+- 詳細テンプレート: \`{page}/detail.html\`（レシピでスラッグ展開）
 
 ## Cloudflare Pages 構成
 

package/dist/lib/template-renderer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * テンプレート変数置換
+ *
+ * {{variable}} 形式のプレースホルダーを値に置換する。
+ * GitHub Actions の ${{ expression }} とは衝突しない。
+ */
+import type { ProjectConfig } from './templates.js';
+export type TemplateVariables = Record<string, string>;
+/**
+ * テンプレート文字列内の {{variable}} を置換する
+ */
+export declare function renderTemplate(content: string, vars: TemplateVariables): string;
+/**
+ * ProjectConfig からテンプレート変数マップを生成する
+ */
+export declare function projectConfigToVars(config: ProjectConfig): TemplateVariables;

package/dist/lib/template-renderer.js

@@ -0,0 +1,32 @@
+/**
+ * テンプレート変数置換
+ *
+ * {{variable}} 形式のプレースホルダーを値に置換する。
+ * GitHub Actions の ${{ expression }} とは衝突しない。
+ */
+/**
+ * テンプレート文字列内の {{variable}} を置換する
+ */
+export function renderTemplate(content, vars) {
+    return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return key in vars ? vars[key] : match;
+    });
+}
+/**
+ * ProjectConfig からテンプレート変数マップを生成する
+ */
+export function projectConfigToVars(config) {
+    return {
+        contentRepo: config.contentRepo,
+        githubClientId: config.githubClientId,
+        siteTitle: config.siteTitle,
+        productionUrl: config.productionUrl,
+        previewUrl: config.previewUrl,
+        fileUploadUrl: '/api/storage',
+        pagesProjectName: config.pagesProjectName,
+        adminPagesProjectName: config.adminPagesProjectName,
+        r2BucketName: config.r2BucketName,
+        r2PublicUrl: config.r2PublicUrl,
+        ownerUsername: config.ownerUsername,
+    };
+}