@c-time/frelio-cli 1.3.13 → 1.4.0

package/dist/core/file-generators.js

@@ -0,0 +1,93 @@
+/**
+ * core/file-generators — 個別ファイルの再生成
+ *
+ * config.json 変更後に特定のファイルだけ再生成する場合に使う。
+ * 既存ファイルを上書きする（冪等）。
+ */
+import path from 'node:path';
+import { ok, fail } from './types.js';
+import { generateConfigJson, generateWranglerToml, generateRedirects, generateRoutesJson, generateStorageFunction, writeFile, } from '../lib/templates.js';
+// ---------------------------------------------------------------------------
+// Individual file generators
+// ---------------------------------------------------------------------------
+export function generateAndWriteConfigJson(projectDir, config) {
+    try {
+        const filePath = path.join(projectDir, 'admin', 'config.json');
+        writeFile(filePath, generateConfigJson(config));
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`config.json 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function generateAndWriteWranglerToml(projectDir, config) {
+    try {
+        const filePath = path.join(projectDir, 'wrangler.toml');
+        writeFile(filePath, generateWranglerToml(config));
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`wrangler.toml 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function generateAndWriteRedirects(projectDir) {
+    try {
+        const filePath = path.join(projectDir, '_redirects');
+        writeFile(filePath, generateRedirects());
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`_redirects 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function generateAndWriteRoutesJson(projectDir) {
+    try {
+        const filePath = path.join(projectDir, '_routes.json');
+        writeFile(filePath, generateRoutesJson());
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`_routes.json 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function generateAndWritePublicRoutesJson(projectDir) {
+    try {
+        const filePath = path.join(projectDir, 'public', '_routes.json');
+        const content = JSON.stringify({ version: 1, include: ['/storage/*'], exclude: [] }, null, 2);
+        writeFile(filePath, content);
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`public/_routes.json 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+export function generateAndWriteStorageFunction(projectDir) {
+    try {
+        const filePath = path.join(projectDir, 'functions', 'storage', '[[path]].ts');
+        writeFile(filePath, generateStorageFunction());
+        return ok({ path: filePath });
+    }
+    catch (e) {
+        return fail(`storage function 生成失敗: ${e.message}`, 'EXEC_FAILED');
+    }
+}
+// ---------------------------------------------------------------------------
+// Regenerate all config-derived files at once
+// ---------------------------------------------------------------------------
+export function regenerateAllConfigFiles(projectDir, config) {
+    const paths = [];
+    const generators = [
+        () => generateAndWriteConfigJson(projectDir, config),
+        () => generateAndWriteWranglerToml(projectDir, config),
+        () => generateAndWriteRedirects(projectDir),
+        () => generateAndWriteRoutesJson(projectDir),
+        () => generateAndWritePublicRoutesJson(projectDir),
+    ];
+    for (const gen of generators) {
+        const result = gen();
+        if (!result.success)
+            return result;
+        paths.push(result.data.path);
+    }
+    return ok({ paths });
+}

package/dist/core/git-operations.d.ts

@@ -0,0 +1,15 @@
+/**
+ * core/git-operations — Git コミット・ブランチ・プッシュ操作
+ */
+import { type OperationResult } from './types.js';
+export declare function initialCommitAndBranches(projectDir: string, contentRepo: string): OperationResult<{
+    branches: string[];
+    defaultBranch: string;
+}>;
+export declare function createBranch(projectDir: string, branchName: string, baseBranch: string): OperationResult<{
+    alreadyExisted: boolean;
+}>;
+export declare function isGitRepo(projectDir: string): boolean;
+export declare function checkWorkflowBranchCoverage(projectDir: string, branchName: string): OperationResult<{
+    covered: boolean;
+}>;

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,23 @@
+/**
+ * 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 { createContentDirectories, createStructureFiles, createProjectFiles, createDemoContent, createFullContentStructure, } from './content-structure.js';
+export { generateAndWriteConfigJson, generateAndWriteWranglerToml, generateAndWriteRedirects, generateAndWriteRoutesJson, generateAndWritePublicRoutesJson, generateAndWriteStorageFunction, regenerateAllConfigFiles, } from './file-generators.js';
+export { generateWorkflow, generateWorkflows } from './workflows.js';
+export type { WorkflowName } from './workflows.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 { createContentDirectories, createStructureFiles, createProjectFiles, createDemoContent, createFullContentStructure, } from './content-structure.js';
+// File generators
+export { generateAndWriteConfigJson, generateAndWriteWranglerToml, generateAndWriteRedirects, generateAndWriteRoutesJson, generateAndWritePublicRoutesJson, generateAndWriteStorageFunction, regenerateAllConfigFiles, } from './file-generators.js';
+// Workflows
+export { generateWorkflow, generateWorkflows } from './workflows.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/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');
+    }
+}