@c-time/frelio-cli 1.4.9 → 1.4.11

package/dist/core/template-refresh.js

@@ -0,0 +1,148 @@
+/**
+ * core/template-refresh — 既存プロジェクトのテンプレ再生成（#86）
+ *
+ * frelio doctor（#85）が「古い」と指摘した workflow / functions / wrangler を、
+ * 最新テンプレートで再生成する（Pull の受け皿）。
+ *
+ * - ワークフロー（.github/）は GitHub のテンプレートリポジトリから取得して .hbs を描画する。
+ *   （init と同じ取得経路。`fetchTemplate` を共有）
+ * - wrangler.toml / functions/storage / _redirects / _routes.json は config から決定的に生成する
+ *   （lib/templates.ts の生成関数を共有。set-domain と同一の正本）
+ *
+ * ユーザー改変を保護するため、既存ファイルと差分がある場合は競合モードに従う
+ * （既定 backup: <file>.frelio-bak に退避してから上書き）。
+ *
+ * frelio-data/・public/・admin/config.json・functions/api/・workers/file-upload/src は触らない。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { ok, fail } from './types.js';
+import { fetchTemplate, cleanupTemplate } from './template-scaffold.js';
+import { renderTemplate, projectConfigToVars } from '../lib/template-renderer.js';
+import { generateWranglerToml, generateWorkerWranglerToml, generateRedirects, generateRoutesJson, generatePublicRoutesJson, generateStorageFunction, generateGateMiddleware, } from '../lib/templates.js';
+const DEFAULT_TARGETS = ['workflows', 'wrangler', 'functions', 'routing'];
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+/** .github/ 配下を再帰的に走査して相対パス一覧を返す */
+function walkGithub(dir, base) {
+    const out = [];
+    if (!fs.existsSync(dir))
+        return out;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...walkGithub(full, base));
+        }
+        else {
+            out.push(path.relative(base, full));
+        }
+    }
+    return out;
+}
+/** GitHub テンプレートの .github/ 配下から workflow/dependabot などの生成計画を作る */
+function planWorkflows(templateDir, config) {
+    const vars = projectConfigToVars(config);
+    const githubDir = path.join(templateDir, '.github');
+    const files = walkGithub(githubDir, templateDir);
+    const planned = [];
+    for (const relPath of files) {
+        const raw = fs.readFileSync(path.join(templateDir, relPath), 'utf-8');
+        const isHbs = relPath.endsWith('.hbs');
+        const outRel = isHbs ? relPath.slice(0, -4) : relPath;
+        const content = isHbs ? renderTemplate(raw, vars) : raw;
+        planned.push({ relPath: toPosix(outRel), content });
+    }
+    return planned;
+}
+/** config から決定的に生成するファイル群の計画を作る */
+function planGenerated(config, targets) {
+    const planned = [];
+    if (targets.includes('wrangler')) {
+        planned.push({ relPath: 'wrangler.toml', content: generateWranglerToml(config) });
+        planned.push({
+            relPath: 'workers/file-upload/wrangler.toml',
+            content: generateWorkerWranglerToml(config),
+        });
+    }
+    if (targets.includes('functions')) {
+        planned.push({
+            relPath: 'functions/storage/[[path]].ts',
+            content: generateStorageFunction(),
+        });
+        // 本番ゲート middleware（Issue #93）
+        planned.push({
+            relPath: 'functions/_middleware.ts',
+            content: generateGateMiddleware(),
+        });
+    }
+    if (targets.includes('routing')) {
+        planned.push({ relPath: '_redirects', content: generateRedirects() });
+        planned.push({ relPath: '_routes.json', content: generateRoutesJson() });
+        // コンテンツ配信側 _routes.json（include /* で全リクエストをゲート経由に / Issue #93）
+        planned.push({ relPath: 'public/_routes.json', content: generatePublicRoutesJson() });
+    }
+    return planned;
+}
+/** 1ファイルを競合モードに従って適用する */
+function applyFile(projectDir, file, mode, result) {
+    const dest = path.join(projectDir, file.relPath);
+    const exists = fs.existsSync(dest);
+    if (exists) {
+        const current = fs.readFileSync(dest, 'utf-8');
+        if (current === file.content) {
+            result.unchanged.push(file.relPath);
+            return;
+        }
+        // 差分あり
+        if (mode === 'skip') {
+            result.skipped.push(file.relPath);
+            return;
+        }
+        if (mode === 'backup') {
+            fs.writeFileSync(`${dest}.frelio-bak`, current, 'utf-8');
+            result.backedUp.push(file.relPath);
+        }
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, file.content, 'utf-8');
+    result.written.push(file.relPath);
+}
+/**
+ * テンプレートを再生成して既存プロジェクトに適用する。
+ */
+export async function refreshTemplates(projectDir, config, opts = {}) {
+    const targets = opts.targets ?? DEFAULT_TARGETS;
+    const mode = opts.mode ?? 'backup';
+    const result = { written: [], unchanged: [], skipped: [], backedUp: [] };
+    const needsTemplate = targets.includes('workflows');
+    let templateDir = opts.templateDir ?? null;
+    let ownTemplate = false;
+    try {
+        if (needsTemplate && !templateDir) {
+            try {
+                templateDir = await fetchTemplate();
+                ownTemplate = true;
+            }
+            catch (e) {
+                return fail(`テンプレートの取得に失敗しました: ${e.message}`, 'EXEC_FAILED');
+            }
+        }
+        const planned = [];
+        if (targets.includes('workflows') && templateDir) {
+            planned.push(...planWorkflows(templateDir, config));
+        }
+        planned.push(...planGenerated(config, targets));
+        for (const file of planned) {
+            applyFile(projectDir, file, mode, result);
+        }
+        return ok(result);
+    }
+    catch (e) {
+        return fail(`テンプレート再生成に失敗しました: ${e.message}`, 'EXEC_FAILED');
+    }
+    finally {
+        if (ownTemplate && templateDir)
+            cleanupTemplate(templateDir);
+    }
+}

package/dist/core/template-scaffold.d.ts

@@ -5,6 +5,17 @@
  * .hbs ファイルは変数置換、それ以外はそのままコピーして出力先に展開する。
  */
 import { type ProjectConfig, type OperationResult } from './types.js';
+/**
+ * GitHub から tarball をダウンロードして一時ディレクトリに展開する。
+ * 展開済みテンプレートのルートディレクトリ（owner-repo-sha/）の絶対パスを返す。
+ * 呼び出し側は使用後に `cleanupTemplate(dir)` で一時ディレクトリを削除する。
+ */
+export declare function fetchTemplate(): Promise<string>;
+/**
+ * fetchTemplate が作成した一時ディレクトリを削除する。
+ * 引数は fetchTemplate の戻り値（展開ルート）。
+ */
+export declare function cleanupTemplate(templateDir: string): void;
 /**
  * テンプレートからコンテンツリポジトリを生成する。
  * GitHub から c-time/frelio-content-template を取得して展開する。

package/dist/core/template-scaffold.js

@@ -14,9 +14,11 @@ import { renderTemplate, projectConfigToVars } from '../lib/template-renderer.js
 const TEMPLATE_REPO = 'c-time/frelio-content-template';
 const TEMPLATE_BRANCH = 'main';
 /**
- * GitHub から tarball をダウンロードして一時ディレクトリに展開する
+ * GitHub から tarball をダウンロードして一時ディレクトリに展開する。
+ * 展開済みテンプレートのルートディレクトリ（owner-repo-sha/）の絶対パスを返す。
+ * 呼び出し側は使用後に `cleanupTemplate(dir)` で一時ディレクトリを削除する。
  */
-async function fetchTemplate() {
+export async function fetchTemplate() {
     const url = `https://api.github.com/repos/${TEMPLATE_REPO}/tarball/${TEMPLATE_BRANCH}`;
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'frelio-template-'));
     const tarPath = path.join(tmpDir, 'template.tar.gz');
@@ -39,6 +41,14 @@ async function fetchTemplate() {
     }
     return path.join(extractDir, entries[0]);
 }
+/**
+ * fetchTemplate が作成した一時ディレクトリを削除する。
+ * 引数は fetchTemplate の戻り値（展開ルート）。
+ */
+export function cleanupTemplate(templateDir) {
+    const tmpDir = path.resolve(templateDir, '..', '..');
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+}
 /**
  * ディレクトリを再帰的に走査してファイル一覧を返す
  */

package/dist/core/types.d.ts

@@ -46,4 +46,6 @@ export type BuildConfigParams = {
     r2PublicUrl?: string;
     ownerUsername?: string;
     cloudflareAccountId?: string;
+    /** 保存タイムゾーン（ISO 8601 オフセット表記、例 "+09:00"）。issue #92 */
+    saveTimezone?: string;
 };

package/dist/core/version-check.d.ts

@@ -0,0 +1,31 @@
+/**
+ * core/version-check — CLI 起動時バージョンチェック（#87）
+ *
+ * 到達できない匿名ユーザーにも「古い・期限付き対応が要る」を実行経路で届ける。
+ * - npm の最新版を確認し、古ければナッジ表示（stderr）
+ * - 頻度制御（キャッシュ・TTL）／オフライン耐性（タイムアウト・失敗は無言）／opt-out
+ */
+/** キャッシュファイルのパス（~/.cache/frelio/update-check.json、失敗時は tmpdir） */
+export declare function defaultCachePath(): string;
+/**
+ * セムバー比較。a が b より新しければ正、古ければ負、同じなら 0。
+ * プレリリースタグは無視して数値部のみ比較する。
+ */
+export declare function compareSemver(a: string, b: string): number;
+export type VersionCheckOptions = {
+    cachePath?: string;
+    /** テスト用に現在時刻を注入 */
+    now?: number;
+    /** テスト用に取得関数を差し替え */
+    fetchLatest?: (pkg: string, signal?: AbortSignal) => Promise<string>;
+};
+/**
+ * 最新版を確認し、現在版より新しければナッジ文字列を返す。
+ * チェック不要・最新・失敗時は null。副作用はキャッシュ更新のみ（表示しない）。
+ */
+export declare function checkForUpdate(currentVersion: string, opts?: VersionCheckOptions): Promise<string | null>;
+/**
+ * 起動時に最新版チェックを行い、必要ならナッジを stderr に表示する。
+ * 失敗しても呼び出し元の動作には影響しない。
+ */
+export declare function maybeNotifyUpdate(currentVersion: string, opts?: VersionCheckOptions): Promise<void>;

package/dist/core/version-check.js

@@ -0,0 +1,114 @@
+/**
+ * core/version-check — CLI 起動時バージョンチェック（#87）
+ *
+ * 到達できない匿名ユーザーにも「古い・期限付き対応が要る」を実行経路で届ける。
+ * - npm の最新版を確認し、古ければナッジ表示（stderr）
+ * - 頻度制御（キャッシュ・TTL）／オフライン耐性（タイムアウト・失敗は無言）／opt-out
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getLatestNpmVersion } from '../lib/npm-registry.js';
+const PACKAGE_NAME = '@c-time/frelio-cli';
+const ENV_OPT_OUT = 'FRELIO_NO_UPDATE_CHECK';
+const TTL_MS = 24 * 60 * 60 * 1000; // 1日
+const FETCH_TIMEOUT_MS = 2000;
+/** キャッシュファイルのパス（~/.cache/frelio/update-check.json、失敗時は tmpdir） */
+export function defaultCachePath() {
+    const base = process.env.XDG_CACHE_HOME ||
+        (process.platform === 'win32' && process.env.LOCALAPPDATA) ||
+        path.join(os.homedir(), '.cache');
+    return path.join(base, 'frelio', 'update-check.json');
+}
+function readCache(cachePath) {
+    try {
+        return JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cachePath, data) {
+    try {
+        fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+        fs.writeFileSync(cachePath, JSON.stringify(data), 'utf-8');
+    }
+    catch {
+        // キャッシュ書き込み失敗は致命的でない
+    }
+}
+/**
+ * セムバー比較。a が b より新しければ正、古ければ負、同じなら 0。
+ * プレリリースタグは無視して数値部のみ比較する。
+ */
+export function compareSemver(a, b) {
+    const norm = (v) => v
+        .replace(/^v/, '')
+        .split('-')[0]
+        .split('.')
+        .map((n) => parseInt(n, 10) || 0);
+    const pa = norm(a);
+    const pb = norm(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d > 0 ? 1 : -1;
+    }
+    return 0;
+}
+/**
+ * 最新版を確認し、現在版より新しければナッジ文字列を返す。
+ * チェック不要・最新・失敗時は null。副作用はキャッシュ更新のみ（表示しない）。
+ */
+export async function checkForUpdate(currentVersion, opts = {}) {
+    // opt-out（明示無効化 or CI）
+    if (process.env[ENV_OPT_OUT] || process.env.CI)
+        return null;
+    const now = opts.now ?? Date.now();
+    const cachePath = opts.cachePath ?? defaultCachePath();
+    const cache = readCache(cachePath);
+    let latest = null;
+    if (cache && now - cache.lastCheck < TTL_MS) {
+        // TTL 内: ネットワークは叩かずキャッシュの値で判定
+        latest = cache.latest;
+    }
+    else {
+        const fetchLatest = opts.fetchLatest ?? getLatestNpmVersion;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+            try {
+                latest = await fetchLatest(PACKAGE_NAME, controller.signal);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            writeCache(cachePath, { lastCheck: now, latest });
+        }
+        catch {
+            // オフライン等は無言で諦める
+            return null;
+        }
+    }
+    if (latest && compareSemver(latest, currentVersion) > 0) {
+        return (`新しい ${PACKAGE_NAME} が公開されています: ${currentVersion} → ${latest}\n` +
+            `  更新: npm i -g ${PACKAGE_NAME}@latest  /  実行のみ: npx ${PACKAGE_NAME}@latest <command>\n` +
+            `  （このチェックは ${ENV_OPT_OUT}=1 で無効化できます）`);
+    }
+    return null;
+}
+/**
+ * 起動時に最新版チェックを行い、必要ならナッジを stderr に表示する。
+ * 失敗しても呼び出し元の動作には影響しない。
+ */
+export async function maybeNotifyUpdate(currentVersion, opts = {}) {
+    try {
+        const message = await checkForUpdate(currentVersion, opts);
+        if (message) {
+            console.error(`\n⚠ ${message}\n`);
+        }
+    }
+    catch {
+        // 何があっても本処理を妨げない
+    }
+}

package/dist/index.js

@@ -1,14 +1,23 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { initCommand } from './commands/init.js';
 import { updateCommand } from './commands/update.js';
 import { addStagingCommand } from './commands/add-staging.js';
 import { setDomainCommand } from './commands/set-domain.js';
+import { setModeCommand } from './commands/set-mode.js';
+import { doctorCommand } from './commands/doctor.js';
+import { fleetCommand } from './commands/fleet.js';
+import { maybeNotifyUpdate } from './core/version-check.js';
+// バージョンは package.json から読む（ハードコードしない）
+const pkg = JSON.parse(readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf-8'));
 const program = new Command();
 program
     .name('frelio')
     .description('Frelio CMS setup and management CLI')
-    .version('0.1.0');
+    .version(pkg.version);
 program
     .command('init')
     .description('Initialize a new Frelio CMS project (creates repo, deploys admin, sets up R2)')
@@ -29,9 +38,17 @@ program
     .action(initCommand);
 program
     .command('update')
-    .description('Update CMS admin bundle to the latest version')
+    .description('Update CMS admin bundle and regenerate templates (workflows / functions / wrangler)')
     .option('--version <version>', 'Specific version to install (default: latest)')
+    .option('--bundle-only', 'Update only the CMS admin bundle (skip template regeneration)')
+    .option('--templates-only', 'Regenerate only templates (skip CMS admin bundle)')
+    .option('--force', 'Overwrite changed files without creating .frelio-bak backups')
     .action(updateCommand);
+program
+    .command('doctor')
+    .description('生成物を診断し、期限付き廃止や未適用のテンプレ更新を検出する')
+    .option('--ci', '対応が必要な指摘があれば非ゼロの終了コードで終了する')
+    .action(doctorCommand);
 program
     .command('add-staging')
     .description('Add a staging environment (creates a staging-* branch; deployed via GitHub Actions wrangler --branch)')
@@ -46,4 +63,25 @@ program
     .option('--r2-public-url <url>', 'New R2 public URL')
     .option('--regen-staging-hash', 'Regenerate the staging subdomain hash instead of preserving it')
     .action(setDomainCommand);
-program.parse();
+program
+    .command('fleet')
+    .description('Scan managed content repos and report bundle versions + pending migrations (operator / #89)')
+    .option('--org <org>', 'GitHub org/user to enumerate (filters to frelio repos via version.json)')
+    .option('--repos <repos>', 'Comma-separated owner/repo list')
+    .option('--repo-list <file>', 'File with one owner/repo per line (# comments allowed)')
+    .option('--json', 'Output as JSON')
+    .option('--ci', 'Exit non-zero if any actionable (critical/warning) migration is pending')
+    .action(fleetCommand);
+program
+    .command('set-mode <mode>')
+    .description('Set the production gate mode (live | prelaunch | maintenance | closed) and regenerate config + edge middleware (#93)')
+    .action(setModeCommand);
+async function main() {
+    await program.parseAsync();
+    // コマンド完了後に最新版チェック（best-effort、本処理には影響しない）
+    await maybeNotifyUpdate(pkg.version);
+}
+main().catch((e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+});

package/dist/lib/npm-registry.d.ts

@@ -5,6 +5,18 @@ export type Release = {
     tag_name: string;
     tarballUrl: string;
 };
+/**
+ * 任意の npm パッケージの最新バージョン（dist-tags.latest）を取得する。
+ * 起動時バージョンチェック（#87）など、tarball を要しない用途に使う。
+ * `signal` でタイムアウト/中断を渡せる。
+ */
+export declare function getLatestNpmVersion(packageName: string, signal?: AbortSignal): Promise<string>;
+/**
+ * 任意 npm パッケージの直近 1 か月のダウンロード数を取得する（#89）。
+ * 匿名層の粗い母数把握に使う。失敗（オフライン等）は null。
+ * `fetchImpl` はテスト用に差し替え可能。
+ */
+export declare function getMonthlyDownloads(packageName: string, fetchImpl?: typeof fetch): Promise<number | null>;
 export declare function getLatestRelease(): Promise<Release>;
 export declare function getRelease(version: string): Promise<Release>;
 export declare function downloadTarball(release: Release, destDir: string): Promise<string>;

package/dist/lib/npm-registry.js

@@ -7,6 +7,36 @@ import { Readable } from 'node:stream';
 import path from 'node:path';
 const PACKAGE_NAME = '@c-time/frelio-cms';
 const REGISTRY = 'https://registry.npmjs.org';
+/**
+ * 任意の npm パッケージの最新バージョン（dist-tags.latest）を取得する。
+ * 起動時バージョンチェック（#87）など、tarball を要しない用途に使う。
+ * `signal` でタイムアウト/中断を渡せる。
+ */
+export async function getLatestNpmVersion(packageName, signal) {
+    const res = await fetch(`${REGISTRY}/${packageName}/latest`, { signal });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch latest version of ${packageName}: ${res.status}`);
+    }
+    const info = (await res.json());
+    return info.version;
+}
+/**
+ * 任意 npm パッケージの直近 1 か月のダウンロード数を取得する（#89）。
+ * 匿名層の粗い母数把握に使う。失敗（オフライン等）は null。
+ * `fetchImpl` はテスト用に差し替え可能。
+ */
+export async function getMonthlyDownloads(packageName, fetchImpl = fetch) {
+    try {
+        const res = await fetchImpl(`https://api.npmjs.org/downloads/point/last-month/${packageName}`);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.downloads === 'number' ? data.downloads : null;
+    }
+    catch {
+        return null;
+    }
+}
 export async function getLatestRelease() {
     const res = await fetch(`${REGISTRY}/${PACKAGE_NAME}/latest`);
     if (!res.ok) {

package/dist/lib/template-renderer.js

@@ -4,7 +4,7 @@
  * {{variable}} 形式のプレースホルダーを値に置換する。
  * GitHub Actions の ${{ expression }} とは衝突しない。
  */
-import { buildAllowedOrigins } from './templates.js';
+import { buildAllowedOrigins, resolveSiteMode, deriveCanonicalHost, deriveContentPagesDev, } from './templates.js';
 /**
  * テンプレート文字列内の {{variable}} を置換する
  */
@@ -31,5 +31,10 @@ export function projectConfigToVars(config) {
         ownerUsername: config.ownerUsername,
         allowedOrigins: buildAllowedOrigins(config),
         cloudflareAccountId: config.cloudflareAccountId ?? '',
+        saveTimezone: config.saveTimezone || '+09:00',
+        // 本番ゲート（Issue #93）
+        siteMode: resolveSiteMode(config),
+        canonicalHost: deriveCanonicalHost(config),
+        contentPagesDev: deriveContentPagesDev(config),
     };
 }

package/dist/lib/templates.d.ts

@@ -14,7 +14,23 @@ export type ProjectConfig = {
     ownerUsername: string;
     stagingDomain: string;
     cloudflareAccountId: string;
+    /** 保存タイムゾーン（ISO 8601 オフセット表記、例 "+09:00"）。issue #92 */
+    saveTimezone: string;
+    /**
+     * 本番ゲートのサイト公開状態（Issue #93）。未指定は 'live'（通常配信）。
+     * コンテンツ配信の functions/_middleware.ts がエッジで参照する。
+     */
+    siteMode?: SiteMode;
 };
+/** 本番ゲートのサイト公開状態（Issue #93） */
+export declare const SITE_MODES: readonly ["live", "prelaunch", "maintenance", "closed"];
+export type SiteMode = (typeof SITE_MODES)[number];
+/** config.siteMode を正規化する（未知値・未指定は 'live'） */
+export declare function resolveSiteMode(config: ProjectConfig): SiteMode;
+/** productionUrl から正規化先ホスト（独自ドメイン）を導出する。無効/空なら空文字。 */
+export declare function deriveCanonicalHost(config: ProjectConfig): string;
+/** コンテンツ配信 Pages の本番 pages.dev ホストを導出する（例: mysite.pages.dev）。 */
+export declare function deriveContentPagesDev(config: ProjectConfig): string;
 /**
  * ランダムな8文字のハッシュを生成（URL推測を困難にする）
  */
@@ -62,6 +78,26 @@ export declare function generateWranglerToml(config: ProjectConfig): string;
 export declare function generateWorkerWranglerToml(config: ProjectConfig): string;
 export declare function generateRedirects(): string;
 export declare function generateRoutesJson(): string;
+/**
+ * コンテンツ配信側（public/）の _routes.json を生成する。
+ *
+ * 本番ゲート（Issue #93）の functions/_middleware.ts に全リクエストを通すため
+ * include を `/*` にする。これにより静的ページもエッジ middleware を経由する
+ * （live モードでは即 next() で素通り）。
+ */
+export declare function generatePublicRoutesJson(): string;
+/**
+ * 本番ゲート middleware（Issue #93）を生成する。
+ *
+ * 注意: この functions/ は管理画面 Pages にも配られる共有資産のため、
+ * ホスト判定で「コンテンツのホスト」のみを対象にし、admin / staging /
+ * localhost / 不明ホストは素通り（next）して CMS を保護する。
+ *
+ * テンプレート実ファイル
+ * （templates/content-repo/functions/_middleware.ts）と同一文字列を返す。
+ * 乖離は sync テストで検出する。
+ */
+export declare function generateGateMiddleware(): string;
 export declare function generateStorageFunction(): string;
 export declare function generateTerraformProviders(): string;
 export declare function generateTerraformVariables(config: ProjectConfig): string;