@c-time/frelio-cli 1.3.13 → 1.4.1

package/dist/core/git-operations.js

@@ -0,0 +1,78 @@
+/**
+ * core/git-operations — Git コミット・ブランチ・プッシュ操作
+ */
+import fs from 'node:fs';
+import { ok, fail } from './types.js';
+import { exec } from '../lib/shell.js';
+// ---------------------------------------------------------------------------
+// Initial commit + branch creation
+// ---------------------------------------------------------------------------
+export function initialCommitAndBranches(projectDir, contentRepo) {
+    try {
+        exec('git add -A', { cwd: projectDir, silent: true });
+        exec('git commit -m "Initial Frelio CMS setup"', { cwd: projectDir, silent: true });
+        // develop, admin, staging ブランチ作成
+        const branches = ['develop', 'admin', 'staging'];
+        for (const branch of branches) {
+            exec(`git branch ${branch}`, { cwd: projectDir, silent: true });
+        }
+        // プッシュ
+        exec('git push -u origin main', { cwd: projectDir, silent: true });
+        for (const branch of branches) {
+            exec(`git push -u origin ${branch}`, { cwd: projectDir, silent: true });
+        }
+        // デフォルトブランチを develop に変更
+        exec(`gh repo edit ${contentRepo} --default-branch develop`, { silent: true });
+        return ok({ branches: ['main', ...branches], defaultBranch: 'develop' });
+    }
+    catch (e) {
+        return fail(`Git 操作失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+// ---------------------------------------------------------------------------
+// Single branch creation
+// ---------------------------------------------------------------------------
+export function createBranch(projectDir, branchName, baseBranch) {
+    try {
+        exec('git fetch origin', { cwd: projectDir, silent: true });
+        // リモートに既にあるか確認
+        try {
+            exec(`git rev-parse --verify origin/${branchName}`, { cwd: projectDir, silent: true });
+            return ok({ alreadyExisted: true }, true);
+        }
+        catch {
+            // 存在しない → 作成
+        }
+        exec(`git branch ${branchName} ${baseBranch}`, { cwd: projectDir, silent: true });
+        exec(`git push -u origin ${branchName}`, { cwd: projectDir, silent: true });
+        return ok({ alreadyExisted: false });
+    }
+    catch (e) {
+        return fail(`ブランチ作成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+// ---------------------------------------------------------------------------
+// Check
+// ---------------------------------------------------------------------------
+export function isGitRepo(projectDir) {
+    try {
+        exec('git rev-parse --is-inside-work-tree', { cwd: projectDir, silent: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Workflow branch check
+// ---------------------------------------------------------------------------
+export function checkWorkflowBranchCoverage(projectDir, branchName) {
+    try {
+        const workflow = fs.readFileSync(`${projectDir}/.github/workflows/build-staging.yml`, 'utf-8');
+        const covered = workflow.includes('staging-*') || workflow.includes(branchName);
+        return ok({ covered });
+    }
+    catch {
+        return fail('build-staging.yml が見つかりません。', 'NOT_FOUND');
+    }
+}

package/dist/core/github.d.ts

@@ -0,0 +1,16 @@
+/**
+ * core/github — GitHub リポジトリ操作
+ *
+ * 各操作は冪等。「既に存在」は成功バリアントとして返す。
+ */
+import { type OperationResult } from './types.js';
+export declare function createRepo(contentRepo: string): OperationResult<{
+    alreadyExisted: boolean;
+}>;
+export declare function cloneRepo(contentRepo: string, projectDir: string): OperationResult<{
+    path: string;
+    alreadyExisted: boolean;
+}>;
+export declare function getAuthenticatedUser(): OperationResult<{
+    username: string;
+}>;

package/dist/core/github.js

@@ -0,0 +1,43 @@
+/**
+ * core/github — GitHub リポジトリ操作
+ *
+ * 各操作は冪等。「既に存在」は成功バリアントとして返す。
+ */
+import fs from 'node:fs';
+import { ok, fail } from './types.js';
+import { exec } from '../lib/shell.js';
+export function createRepo(contentRepo) {
+    try {
+        exec(`gh repo create ${contentRepo} --private --confirm`, { silent: true });
+        return ok({ alreadyExisted: false });
+    }
+    catch (error) {
+        const msg = error.message;
+        if (msg.includes('already exists')) {
+            return ok({ alreadyExisted: true }, true);
+        }
+        return fail(`リポジトリ作成失敗: ${msg}`, 'EXEC_FAILED');
+    }
+}
+export function cloneRepo(contentRepo, projectDir) {
+    try {
+        const repoName = contentRepo.split('/')[1];
+        exec(`gh repo clone ${contentRepo} ${repoName}`, { silent: true });
+        return ok({ path: projectDir, alreadyExisted: false });
+    }
+    catch (error) {
+        if (fs.existsSync(projectDir)) {
+            return ok({ path: projectDir, alreadyExisted: true }, true);
+        }
+        return fail(`クローン失敗: ${error.message}`, 'EXEC_FAILED');
+    }
+}
+export function getAuthenticatedUser() {
+    try {
+        const username = exec('gh api user -q .login', { silent: true });
+        return ok({ username });
+    }
+    catch (e) {
+        return fail(`ユーザー情報取得失敗: ${e.message}`, 'AUTH_REQUIRED');
+    }
+}

package/dist/core/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * core/ — AI エージェント向け関数群の一括エクスポート
+ *
+ * AI エージェントはこのモジュールから全関数にアクセスできる。
+ * 各関数は OperationResult<T> を返し、prompts/process.exit/console.log を含まない。
+ */
+export type { OperationResult, OperationSuccess, OperationFailure, ErrorCode, ProjectConfig, ProjectStatus, BuildConfigParams, } from './types.js';
+export { ok, okVoid, fail } from './types.js';
+export { inspectProject, isGitRepo, hasContentStructure, hasAdminBundle, hasValidConfig, listBranches, getRemoteUrl, } from './status.js';
+export { readConfig, writeConfig, updateConfig, validateConfig, buildConfig, } from './config.js';
+export type { EditableConfigFields, ConfigValidationError } from './config.js';
+export { checkGit, checkGhCli, checkWrangler, checkPrerequisitesFor, } from './prerequisites.js';
+export type { PrerequisiteTarget } from './prerequisites.js';
+export { createRepo, cloneRepo, getAuthenticatedUser } from './github.js';
+export { createR2Bucket, createPagesProject, setPagesSecret, setupCloudflareResources, } from './cloudflare.js';
+export type { CloudflareSetupResult } from './cloudflare.js';
+export { createFullContentStructure } from './content-structure.js';
+export { scaffoldFromTemplate } from './template-scaffold.js';
+export { generateAndWriteConfigJson, generateAndWriteWranglerToml, generateAndWriteRedirects, generateAndWriteRoutesJson, generateAndWritePublicRoutesJson, generateAndWriteStorageFunction, regenerateAllConfigFiles, } from './file-generators.js';
+export { generateTerraformFiles } from './terraform.js';
+export { installBundle, updateBundle, getBundleVersion } from './bundle.js';
+export { initialCommitAndBranches, createBranch, checkWorkflowBranchCoverage, } from './git-operations.js';

package/dist/core/index.js

@@ -0,0 +1,30 @@
+/**
+ * core/ — AI エージェント向け関数群の一括エクスポート
+ *
+ * AI エージェントはこのモジュールから全関数にアクセスできる。
+ * 各関数は OperationResult<T> を返し、prompts/process.exit/console.log を含まない。
+ */
+export { ok, okVoid, fail } from './types.js';
+// Status — AI の最初のエントリーポイント
+export { inspectProject, isGitRepo, hasContentStructure, hasAdminBundle, hasValidConfig, listBranches, getRemoteUrl, } from './status.js';
+// Note: isGitRepo is also available from git-operations.ts but status.ts is the canonical export
+// Config — config.json CRUD
+export { readConfig, writeConfig, updateConfig, validateConfig, buildConfig, } from './config.js';
+// Prerequisites — ツール別チェック
+export { checkGit, checkGhCli, checkWrangler, checkPrerequisitesFor, } from './prerequisites.js';
+// GitHub
+export { createRepo, cloneRepo, getAuthenticatedUser } from './github.js';
+// Cloudflare
+export { createR2Bucket, createPagesProject, setPagesSecret, setupCloudflareResources, } from './cloudflare.js';
+// Content structure
+export { createFullContentStructure } from './content-structure.js';
+// Template scaffold
+export { scaffoldFromTemplate } from './template-scaffold.js';
+// File generators
+export { generateAndWriteConfigJson, generateAndWriteWranglerToml, generateAndWriteRedirects, generateAndWriteRoutesJson, generateAndWritePublicRoutesJson, generateAndWriteStorageFunction, regenerateAllConfigFiles, } from './file-generators.js';
+// Terraform
+export { generateTerraformFiles } from './terraform.js';
+// Bundle
+export { installBundle, updateBundle, getBundleVersion } from './bundle.js';
+// Git operations
+export { initialCommitAndBranches, createBranch, checkWorkflowBranchCoverage, } from './git-operations.js';

package/dist/core/prerequisites.d.ts

@@ -0,0 +1,22 @@
+/**
+ * core/prerequisites — ツール別の前提チェック
+ *
+ * 各ツールを個別にチェックし、構造化された結果を返す。
+ */
+import { type OperationResult } from './types.js';
+export declare function checkGit(): OperationResult<{
+    version: string;
+}>;
+export declare function checkGhCli(): OperationResult<{
+    version: string;
+    authenticated: boolean;
+    username: string;
+}>;
+export declare function checkWrangler(): OperationResult<{
+    version: string;
+    authenticated: boolean;
+}>;
+export type PrerequisiteTarget = 'git' | 'github' | 'cloudflare';
+export declare function checkPrerequisitesFor(targets: PrerequisiteTarget[]): OperationResult<{
+    results: Record<string, OperationResult<Record<string, unknown>>>;
+}>;

package/dist/core/prerequisites.js

@@ -0,0 +1,107 @@
+/**
+ * core/prerequisites — ツール別の前提チェック
+ *
+ * 各ツールを個別にチェックし、構造化された結果を返す。
+ */
+import { ok, fail } from './types.js';
+import { exec, commandExists } from '../lib/shell.js';
+// ---------------------------------------------------------------------------
+// Individual tool checks
+// ---------------------------------------------------------------------------
+export function checkGit() {
+    if (!commandExists('git')) {
+        return fail('git が見つかりません。', 'COMMAND_MISSING');
+    }
+    try {
+        const version = exec('git --version', { silent: true });
+        return ok({ version });
+    }
+    catch (e) {
+        return fail(`git バージョン取得失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function checkGhCli() {
+    if (!commandExists('gh')) {
+        return fail('gh CLI が見つかりません。https://cli.github.com/ からインストールしてください。', 'COMMAND_MISSING');
+    }
+    let version;
+    try {
+        version = exec('gh --version', { silent: true }).split('\n')[0];
+    }
+    catch (e) {
+        return fail(`gh バージョン取得失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+    let authenticated = false;
+    let username = '';
+    try {
+        exec('gh auth status', { silent: true });
+        authenticated = true;
+        try {
+            username = exec('gh api user -q .login', { silent: true });
+        }
+        catch {
+            // username 取得失敗は致命的でない
+        }
+    }
+    catch {
+        // 未認証
+    }
+    if (!authenticated) {
+        return fail('gh にログインしていません。`gh auth login` を実行してください。', 'AUTH_REQUIRED');
+    }
+    return ok({ version, authenticated, username });
+}
+export function checkWrangler() {
+    if (!commandExists('wrangler')) {
+        return fail('wrangler CLI が見つかりません。`npm i -g wrangler` でインストールしてください。', 'COMMAND_MISSING');
+    }
+    let version;
+    try {
+        version = exec('wrangler --version', { silent: true });
+    }
+    catch (e) {
+        return fail(`wrangler バージョン取得失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+    let authenticated = false;
+    try {
+        exec('wrangler whoami', { silent: true });
+        authenticated = true;
+    }
+    catch {
+        // 未認証
+    }
+    if (!authenticated) {
+        return fail('wrangler にログインしていません。`wrangler login` を実行してください。', 'AUTH_REQUIRED');
+    }
+    return ok({ version, authenticated });
+}
+export function checkPrerequisitesFor(targets) {
+    const results = {};
+    let allOk = true;
+    if (targets.includes('git')) {
+        const r = checkGit();
+        results.git = r;
+        if (!r.success)
+            allOk = false;
+    }
+    if (targets.includes('github')) {
+        const r = checkGhCli();
+        results.github = r;
+        if (!r.success)
+            allOk = false;
+    }
+    if (targets.includes('cloudflare')) {
+        const r = checkWrangler();
+        results.cloudflare = r;
+        if (!r.success)
+            allOk = false;
+    }
+    if (!allOk) {
+        const errors = Object.entries(results)
+            .filter(([, r]) => !r.success)
+            .map(([name, r]) => `${name}: ${r.error}`)
+            .join('; ');
+        return fail(errors, 'COMMAND_MISSING');
+    }
+    return ok({ results });
+}

package/dist/core/status.d.ts

@@ -0,0 +1,18 @@
+/**
+ * core/status — プロジェクト状態の検査
+ *
+ * AI エージェントが最初に呼ぶ関数。
+ * プロジェクトの現在の状態を構造的に返す。
+ */
+import type { ProjectConfig, ProjectStatus, OperationResult } from './types.js';
+import type { ConfigValidationError } from './config.js';
+export declare function inspectProject(projectDir: string): ProjectStatus;
+export declare function isGitRepo(projectDir: string): boolean;
+export declare function hasContentStructure(projectDir: string): boolean;
+export declare function hasAdminBundle(projectDir: string): boolean;
+export declare function hasValidConfig(projectDir: string): OperationResult<{
+    config: ProjectConfig | null;
+    errors: ConfigValidationError[];
+}>;
+export declare function listBranches(projectDir: string): string[];
+export declare function getRemoteUrl(projectDir: string): string | null;

package/dist/core/status.js

@@ -0,0 +1,122 @@
+/**
+ * core/status — プロジェクト状態の検査
+ *
+ * AI エージェントが最初に呼ぶ関数。
+ * プロジェクトの現在の状態を構造的に返す。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { ok } from './types.js';
+import { exec, commandExists } from '../lib/shell.js';
+import { readConfig, validateConfig } from './config.js';
+// ---------------------------------------------------------------------------
+// Full inspection
+// ---------------------------------------------------------------------------
+export function inspectProject(projectDir) {
+    const config = readConfigSafe(projectDir);
+    const branches = listBranches(projectDir);
+    return {
+        projectDir,
+        hasGitRepo: isGitRepo(projectDir),
+        hasContentStructure: hasContentStructure(projectDir),
+        hasAdminBundle: hasAdminBundle(projectDir),
+        hasConfigJson: config !== null,
+        hasWranglerToml: fs.existsSync(path.join(projectDir, 'wrangler.toml')),
+        hasWorkflows: fs.existsSync(path.join(projectDir, '.github', 'workflows', 'build-staging.yml')),
+        hasTerraform: fs.existsSync(path.join(projectDir, 'terraform', 'main.tf')),
+        config,
+        branches,
+        remoteUrl: getRemoteUrl(projectDir),
+        missingPrerequisites: detectMissingPrerequisites(),
+        bundleVersion: getBundleVersionFromPackage(projectDir),
+    };
+}
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+export function isGitRepo(projectDir) {
+    try {
+        exec('git rev-parse --is-inside-work-tree', { cwd: projectDir, silent: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function hasContentStructure(projectDir) {
+    return (fs.existsSync(path.join(projectDir, 'frelio-data', 'site', 'content_types')) &&
+        fs.existsSync(path.join(projectDir, 'frelio-data', 'admin', 'structure')));
+}
+export function hasAdminBundle(projectDir) {
+    return (fs.existsSync(path.join(projectDir, 'admin', 'index.html')) ||
+        fs.existsSync(path.join(projectDir, 'admin')));
+}
+export function hasValidConfig(projectDir) {
+    const readResult = readConfig(projectDir);
+    if (!readResult.success)
+        return readResult;
+    const config = readResult.data.config;
+    if (!config) {
+        return ok({ config: null, errors: [{ field: 'config.json', message: 'ファイルが存在しません' }] });
+    }
+    const validateResult = validateConfig(config);
+    if (!validateResult.success)
+        return validateResult;
+    return ok({ config, errors: validateResult.data.errors });
+}
+export function listBranches(projectDir) {
+    if (!isGitRepo(projectDir))
+        return [];
+    try {
+        const output = exec('git branch -a --format="%(refname:short)"', {
+            cwd: projectDir,
+            silent: true,
+        });
+        return output
+            .split('\n')
+            .map((b) => b.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+export function getRemoteUrl(projectDir) {
+    if (!isGitRepo(projectDir))
+        return null;
+    try {
+        return exec('git remote get-url origin', { cwd: projectDir, silent: true });
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function readConfigSafe(projectDir) {
+    const result = readConfig(projectDir);
+    if (!result.success)
+        return null;
+    return result.data.config;
+}
+function detectMissingPrerequisites() {
+    const missing = [];
+    if (!commandExists('git'))
+        missing.push('git');
+    if (!commandExists('gh'))
+        missing.push('gh');
+    if (!commandExists('wrangler'))
+        missing.push('wrangler');
+    return missing;
+}
+function getBundleVersionFromPackage(projectDir) {
+    const versionPath = path.join(projectDir, 'version.json');
+    try {
+        const raw = fs.readFileSync(versionPath, 'utf-8');
+        return JSON.parse(raw).version ?? null;
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -0,0 +1,14 @@
+/**
+ * core/template-scaffold — テンプレートからのコンテンツリポジトリ生成
+ *
+ * GitHub から c-time/frelio-content-template の tarball をダウンロードし、
+ * .hbs ファイルは変数置換、それ以外はそのままコピーして出力先に展開する。
+ */
+import { type ProjectConfig, type OperationResult } from './types.js';
+/**
+ * テンプレートからコンテンツリポジトリを生成する。
+ * GitHub から c-time/frelio-content-template を取得して展開する。
+ */
+export declare function scaffoldFromTemplate(projectDir: string, config: ProjectConfig): Promise<OperationResult<{
+    files: string[];
+}>>;

package/dist/core/template-scaffold.js

@@ -0,0 +1,99 @@
+/**
+ * core/template-scaffold — テンプレートからのコンテンツリポジトリ生成
+ *
+ * GitHub から c-time/frelio-content-template の tarball をダウンロードし、
+ * .hbs ファイルは変数置換、それ以外はそのままコピーして出力先に展開する。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { pipeline } from 'node:stream/promises';
+import { extract } from 'tar';
+import { ok, fail } from './types.js';
+import { renderTemplate, projectConfigToVars } from '../lib/template-renderer.js';
+const TEMPLATE_REPO = 'c-time/frelio-content-template';
+const TEMPLATE_BRANCH = 'main';
+/**
+ * GitHub から tarball をダウンロードして一時ディレクトリに展開する
+ */
+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');
+    const response = await fetch(url, {
+        headers: { Accept: 'application/vnd.github+json' },
+        redirect: 'follow',
+    });
+    if (!response.ok || !response.body) {
+        throw new Error(`GitHub API responded with ${response.status}`);
+    }
+    const dest = fs.createWriteStream(tarPath);
+    await pipeline(response.body, dest);
+    const extractDir = path.join(tmpDir, 'extracted');
+    fs.mkdirSync(extractDir, { recursive: true });
+    await extract({ file: tarPath, cwd: extractDir });
+    // GitHub の tarball は owner-repo-sha/ というプレフィックスディレクトリに入る
+    const entries = fs.readdirSync(extractDir);
+    if (entries.length !== 1) {
+        throw new Error(`Unexpected tarball structure: ${entries.join(', ')}`);
+    }
+    return path.join(extractDir, entries[0]);
+}
+/**
+ * ディレクトリを再帰的に走査してファイル一覧を返す
+ */
+function walkDir(dir, base = dir) {
+    const files = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...walkDir(fullPath, base));
+        }
+        else {
+            files.push(path.relative(base, fullPath));
+        }
+    }
+    return files;
+}
+/** コピー対象外のファイル */
+const SKIP_FILES = new Set(['template.config.json', 'README.md']);
+/**
+ * テンプレートからコンテンツリポジトリを生成する。
+ * GitHub から c-time/frelio-content-template を取得して展開する。
+ */
+export async function scaffoldFromTemplate(projectDir, config) {
+    let templateDir;
+    try {
+        templateDir = await fetchTemplate();
+    }
+    catch (e) {
+        return fail(`テンプレートの取得に失敗しました: ${e.message}`, 'EXEC_FAILED');
+    }
+    try {
+        const vars = projectConfigToVars(config);
+        const templateFiles = walkDir(templateDir);
+        const outputFiles = [];
+        for (const relPath of templateFiles) {
+            if (SKIP_FILES.has(relPath))
+                continue;
+            const srcPath = path.join(templateDir, relPath);
+            const content = fs.readFileSync(srcPath, 'utf-8');
+            const isHbs = relPath.endsWith('.hbs');
+            const outputRelPath = isHbs ? relPath.slice(0, -4) : relPath;
+            const outputContent = isHbs ? renderTemplate(content, vars) : content;
+            const outputPath = path.join(projectDir, outputRelPath);
+            fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+            fs.writeFileSync(outputPath, outputContent, 'utf-8');
+            outputFiles.push(outputRelPath);
+        }
+        return ok({ files: outputFiles });
+    }
+    catch (e) {
+        return fail(`テンプレート展開失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+    finally {
+        // 一時ディレクトリを削除
+        const tmpDir = path.resolve(templateDir, '..', '..');
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+}

package/dist/core/terraform.d.ts

@@ -0,0 +1,7 @@
+/**
+ * core/terraform — Terraform ファイル生成
+ */
+import { type ProjectConfig, type OperationResult } from './types.js';
+export declare function generateTerraformFiles(projectDir: string, config: ProjectConfig): OperationResult<{
+    files: string[];
+}>;

package/dist/core/terraform.js

@@ -0,0 +1,47 @@
+/**
+ * core/terraform — Terraform ファイル生成
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { ok, fail } from './types.js';
+import { generateTerraformProviders, generateTerraformVariables, generateTerraformMain, generateTerraformOutputs, generateTerraformTfvarsExample, generateTerraformReadme, writeFile, } from '../lib/templates.js';
+export function generateTerraformFiles(projectDir, config) {
+    const terraformDir = path.join(projectDir, 'terraform');
+    const files = [];
+    try {
+        const writes = [
+            ['providers.tf', generateTerraformProviders()],
+            ['variables.tf', generateTerraformVariables(config)],
+            ['main.tf', generateTerraformMain(config)],
+            ['outputs.tf', generateTerraformOutputs()],
+            ['terraform.tfvars.example', generateTerraformTfvarsExample(config)],
+            ['README.md', generateTerraformReadme()],
+        ];
+        for (const [name, content] of writes) {
+            const filePath = path.join(terraformDir, name);
+            writeFile(filePath, content);
+            files.push(filePath);
+        }
+        // .gitignore に Terraform エントリ追加
+        appendTerraformGitignore(projectDir);
+        return ok({ files });
+    }
+    catch (e) {
+        return fail(`Terraform ファイル生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+function appendTerraformGitignore(projectDir) {
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+    const terraformIgnore = [
+        '',
+        '# Terraform',
+        'terraform/.terraform/',
+        'terraform/terraform.tfvars',
+        'terraform/*.tfstate',
+        'terraform/*.tfstate.backup',
+    ].join('\n');
+    if (!existing.includes('terraform/.terraform/')) {
+        fs.appendFileSync(gitignorePath, terraformIgnore + '\n', 'utf-8');
+    }
+}