@hiiretail/gcp-infra-generators 1.10.0 → 1.12.0

package/dist/generators/common-resources/firebase/README.md

@@ -0,0 +1,70 @@
+# Firebase Generator
+
+This generator scaffolds Firebase infrastructure configuration for use with Terragrunt and the [terraform-google-firebase](https://github.com/GoogleCloudPlatform/terraform-google-firebase) module (v0.2.3).
+
+## Generated Files
+
+Located at `infra/{env}/firebase/`:
+
+1. **firebase.yaml** - Platform configuration
+2. **terragrunt.hcl** - Firebase multi-platform app registration
+
+## File Architecture
+
+```text
+infra/
+  prod/firebase/
+    firebase.yaml
+    terragrunt.hcl
+  staging/firebase/
+    firebase.yaml
+    terragrunt.hcl
+```
+
+## firebase.yaml Format
+
+```yaml
+apps:
+  android:
+    package_name: "com.example.app"
+  ios:
+    bundle_id: "com.example.app"
+```
+
+- **android.package_name**: Android application ID in reverse-domain format
+- **ios.bundle_id**: iOS bundle identifier in reverse-domain format
+
+Either platform section can be removed to stop managing that platform. At least one must remain.
+
+## Apps Module Outputs (FCM Config Files)
+
+After `terragrunt apply`, the platform SDK config files are available as Terraform outputs:
+
+| Output           | Platform | File                                        |
+| ---------------- | -------- | ------------------------------------------- |
+| `android_config` | Android  | `google-services.json` (base64-encoded)     |
+| `apple_config`   | iOS      | `GoogleService-Info.plist` (base64-encoded) |
+
+Decode and save the files from `infra/{env}/firebase/`:
+
+```bash
+# Android
+terragrunt output -raw android_config | base64 --decode > google-services.json
+
+# iOS
+terragrunt output -raw apple_config | base64 --decode > GoogleService-Info.plist
+```
+
+## Terragrunt Configuration
+
+The `terragrunt.hcl` reads from the `firebase.yaml` in the same directory:
+
+```hcl
+locals {
+  config = yamldecode(file("${get_terragrunt_dir()}/firebase.yaml"))
+}
+```
+
+```bash
+terragrunt apply --terragrunt-working-dir infra/prod/firebase
+```

package/dist/generators/common-resources/firebase/generator.json

@@ -0,0 +1,4 @@
+{
+  "name": "Firebase",
+  "description": "Configure Firebase apps, authentication, and Firestore rules"
+}

package/dist/generators/common-resources/firebase/index.js

@@ -0,0 +1,102 @@
+const path = require('path');
+const chalk = require('chalk');
+const BaseGenerator = require('../../../src/BaseGenerator');
+const { required } = require('../../../src/validators');
+
+module.exports = class extends BaseGenerator {
+  prompting() {
+    const prompts = [
+      {
+        type: 'input',
+        name: 'appDisplayName',
+        message: 'App display name (shared across all platforms):',
+        validate: required,
+      },
+      {
+        type: 'checkbox',
+        name: 'platforms',
+        message: 'Which platforms do you want to register Firebase apps for?',
+        choices: [
+          { name: 'Android', value: 'android', checked: true },
+          { name: 'iOS', value: 'ios', checked: true },
+        ],
+        validate: (selected) =>
+          selected.length > 0 || 'Select at least one platform.',
+      },
+      {
+        when: (response) => response.platforms.includes('android'),
+        type: 'input',
+        name: 'androidPackageName',
+        message:
+          'Android package name - letters, digits, underscores, and dots only, no hyphens (e.g. com.example_app.checkout):',
+        validate: required,
+      },
+      {
+        when: (response) => response.platforms.includes('ios'),
+        type: 'input',
+        name: 'iosBundleId',
+        message:
+          'iOS bundle ID - letters, digits, hyphens, and dots only, no underscores (e.g. com.example-app.checkout):',
+        validate: required,
+      },
+    ];
+
+    return this.prompt(prompts).then((props) => {
+      this.answers = props;
+    });
+  }
+
+  writing() {
+    const {
+      appDisplayName,
+      platforms = [],
+      androidPackageName,
+      iosBundleId,
+    } = this.answers;
+
+    const yamlContext = {
+      appDisplayName,
+      platforms,
+      androidPackageName,
+      iosBundleId,
+    };
+
+    ['prod', 'staging'].forEach((env) => {
+      const firebaseDest = path.join('infra', env, 'firebase');
+
+      this.fs.copyTpl(
+        this.templatePath('firebase', 'firebase.yaml'),
+        this.destinationPath(firebaseDest, 'firebase.yaml'),
+        yamlContext,
+      );
+
+      this.fs.copy(
+        this.templatePath('firebase', 'terragrunt.hcl'),
+        this.destinationPath(firebaseDest, 'terragrunt.hcl'),
+      );
+    });
+  }
+
+  end() {
+    const header = chalk.green(
+      'Your Firebase configuration has been created. Review the generated files:',
+    );
+    let message = header;
+    let i = 1;
+
+    message += `\n${chalk.green(`${i++}.`)} ${chalk.cyan(path.join('firebase', 'firebase.yaml'))} - Shared Firebase configuration`;
+    message += `\n${chalk.green(`${i++}.`)} ${chalk.cyan(path.join('firebase', 'terragrunt.hcl'))} - Firebase apps module`;
+
+    message += chalk.yellow(
+      '\n\nAfter applying, retrieve the FCM config files from infra/{env}/firebase/:',
+    );
+    message += chalk.cyan(
+      '\n  terragrunt output -raw android_config | base64 --decode > google-services.json',
+    );
+    message += chalk.cyan(
+      '\n  terragrunt output -raw apple_config | base64 --decode > GoogleService-Info.plist',
+    );
+
+    this.log(`\n${message}\n`);
+  }
+};

package/dist/generators/common-resources/firebase/templates/firebase/apps/terragrunt.hcl

@@ -0,0 +1,38 @@
+# Terragrunt configuration for Firebase multi-platform application
+# https://github.com/GoogleCloudPlatform/terraform-google-firebase
+
+terraform {
+  source = "git::https://github.com/extenda/terraform-google-firebase//modules/firebase_multi_platform_application/apps?ref=feat/Add-wrapper-apps-around-multi-application-module"
+}
+
+include {
+  path = find_in_parent_folders("terragrunt_root.hcl")
+}
+
+generate "firebase_providers" {
+  path      = "firebase_providers.tf"
+  if_exists = "overwrite_terragrunt"
+  contents  = <<EOF
+provider "google" {
+  project               = var.project_id
+  billing_project       = var.project_id
+  user_project_override = true
+}
+
+provider "google-beta" {
+  project               = var.project_id
+  billing_project       = var.project_id
+  user_project_override = true
+}
+EOF
+}
+
+locals {
+  project_vars = read_terragrunt_config(find_in_parent_folders("project.hcl"))
+  config       = yamldecode(file("${get_terragrunt_dir()}/../firebase.yaml"))
+}
+
+inputs = {
+  project_id = local.project_vars.locals.project_id
+  apps       = local.config.apps
+}

package/dist/generators/common-resources/firebase/templates/firebase/firebase.yaml

@@ -0,0 +1,17 @@
+# Firebase configuration
+#
+# Naming conventions per platform:
+#   android.package_name  — Java package notation: letters, digits, underscores, and dots only.
+#                           No hyphens. Example: com.example_app.checkout
+#   ios.bundle_id         — Reverse DNS notation: letters, digits, hyphens, and dots only.
+#                           No underscores. Example: com.example-app.checkout
+apps:
+  - display_name: "<%- appDisplayName %>"
+<% if (platforms.includes('android')) { -%>
+    android:
+      package_name: <%- androidPackageName %>
+<% } -%>
+<% if (platforms.includes('ios')) { -%>
+    ios:
+      bundle_id: <%- iosBundleId %>
+<% } -%>

package/dist/generators/common-resources/firebase/templates/firebase/terragrunt.hcl

@@ -0,0 +1,38 @@
+# Terragrunt configuration for Firebase multi-platform application
+# https://github.com/GoogleCloudPlatform/terraform-google-firebase
+
+terraform {
+  source = "git::https://github.com/extenda/terraform-google-firebase//modules/firebase_multi_platform_application/apps?ref=v1.0.0"
+}
+
+include {
+  path = find_in_parent_folders("terragrunt_root.hcl")
+}
+
+generate "firebase_providers" {
+  path      = "firebase_providers.tf"
+  if_exists = "overwrite_terragrunt"
+  contents  = <<EOF
+provider "google" {
+  project               = var.project_id
+  billing_project       = var.project_id
+  user_project_override = true
+}
+
+provider "google-beta" {
+  project               = var.project_id
+  billing_project       = var.project_id
+  user_project_override = true
+}
+EOF
+}
+
+locals {
+  project_vars = read_terragrunt_config(find_in_parent_folders("project.hcl"))
+  config       = yamldecode(file("${get_terragrunt_dir()}/firebase.yaml"))
+}
+
+inputs = {
+  project_id = local.project_vars.locals.project_id
+  apps       = local.config.apps
+}

package/dist/generators/init/claude-code/generator.json

@@ -0,0 +1,4 @@
+{
+  "name": "Claude Code orchestration",
+  "description": "Set up the Claude Code Orchestrator Agent system for this repository. Generates CLAUDE.md, AGENTS.md, and .agent/Core.md derived from tf-infra-gcp and the clan common repo."
+}

package/dist/generators/init/claude-code/index.js

@@ -0,0 +1,110 @@
+const BaseGenerator = require('../../../src/BaseGenerator');
+const path = require('path');
+const fs = require('fs');
+
+const MARKETPLACE_KEY = 'hiiretail-toolkit@hiiretail-ai-marketplace';
+
+function getToolkitEntry() {
+  const installedPluginsPath = path.join(
+    process.env.HOME,
+    '.claude',
+    'plugins',
+    'installed_plugins.json',
+  );
+
+  if (!fs.existsSync(installedPluginsPath)) return null;
+
+  try {
+    const installed = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf8'));
+    return installed?.plugins?.[MARKETPLACE_KEY]?.[0] || null;
+  } catch {
+    return null;
+  }
+}
+
+function readBootstrapFile(installPath, filename) {
+  const filePath = path.join(installPath, 'bootstrap', filename);
+  if (!fs.existsSync(filePath)) {
+    throw new Error(
+      `Bootstrap file not found: ${filePath}\nTry reinstalling: /plugin install hiiretail-toolkit@hiiretail-ai-marketplace`,
+    );
+  }
+  return fs.readFileSync(filePath, 'utf8');
+}
+
+module.exports = class extends BaseGenerator {
+  initializing() {
+    this.toolkit = getToolkitEntry();
+
+    if (!this.toolkit) {
+      this.log('\n✗ hiiretail-toolkit is not installed in Claude Code.');
+      this.log('\n  Install it by opening Claude Code and running:');
+      this.log('    /plugin marketplace add extenda/hiiretail-ai-marketplace');
+      this.log(
+        '    /plugin install hiiretail-toolkit@hiiretail-ai-marketplace',
+      );
+      this.log('\n  Then re-run: gcp-infra init claude-code\n');
+      process.exit(1);
+    }
+  }
+
+  writing() {
+    const { installPath, version } = this.toolkit;
+    const hookPath = installPath.replace(process.env.HOME, '~') + '/hooks';
+
+    try {
+      // CLAUDE.md + AGENTS.md — sourced from toolkit bootstrap/, single source of truth
+      const claudeContent = `<!-- hiiretail-toolkit: ${version} -->\n${readBootstrapFile(installPath, 'CLAUDE.md')}`;
+      this.fs.write(this.destinationPath('CLAUDE.md'), claudeContent);
+      this.fs.write(this.destinationPath('AGENTS.md'), claudeContent);
+
+      // settings.json — sourced from toolkit bootstrap/, hook path substituted at init time
+      const settingsContent = readBootstrapFile(
+        installPath,
+        'settings-template.json',
+      ).replaceAll('{{HOOK_PATH}}', hookPath);
+      this.fs.write(
+        this.destinationPath('.claude/settings.json'),
+        settingsContent,
+      );
+    } catch (err) {
+      this.log(`\n✗ ${err.message}\n`);
+      process.exit(1);
+    }
+
+    // Pre-create .agent/ with empty placeholders so the skill overwrites rather than
+    // creates — overwriting does not trigger Claude Code's .claude/ protection.
+    const agentDir = this.destinationPath('.agent');
+    if (!fs.existsSync(agentDir)) {
+      fs.mkdirSync(agentDir, { recursive: true });
+    }
+    for (const file of ['Core.md', 'infrastructure.md', 'conventions.md']) {
+      const filePath = path.join(agentDir, file);
+      if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, '');
+      }
+    }
+  }
+
+  end() {
+    const { version } = this.toolkit;
+    this.log(
+      `\n✓ Claude Code orchestration files created (hiiretail-toolkit ${version}):`,
+    );
+    this.log('  CLAUDE.md                   (sourced from toolkit bootstrap/)');
+    this.log('  AGENTS.md                   (identical copy)');
+    this.log('  .claude/settings.json       (sourced from toolkit bootstrap/)');
+    this.log(
+      '  .agent/Core.md                 (placeholder — populated by /orchestrator-setup)',
+    );
+    this.log(
+      '  .agent/infrastructure.md       (placeholder — populated by /orchestrator-setup)',
+    );
+    this.log(
+      '  .agent/conventions.md          (placeholder — fill in coding standards)',
+    );
+    this.log(
+      '\nOpen Claude Code and run /orchestrator-setup to populate .agent/ from your clan infrastructure.',
+    );
+  }
+};

package/dist/node_modules/.package-lock.json

@@ -11528,7 +11528,7 @@
     },
     "packages/generators": {
       "name": "@hiiretail/gcp-infra-generators",
-      "version": "1.10.0",
+      "version": "1.12.0",
       "license": "MIT",
       "dependencies": {
         "@google-cloud/storage": "^7.18.0",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiiretail/gcp-infra-generators",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "Infrastructure as code generator for GCP.",
   "scripts": {
     "build": "node esbuild.js && npm run build:deps",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiiretail/gcp-infra-generators",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "Infrastructure as code generator for GCP.",
   "scripts": {
     "build": "node esbuild.js && npm run build:deps",