add git local dir for development

Author: petercrocker

.env.example

@@ -25,6 +25,17 @@ export INFRAHUB_VERSION=1.5.1
 # Set to "true" to enable enterprise features, "false" for community edition
 export INFRAHUB_ENTERPRISE=false
 
+# Use local git repository instead of GitHub
+# Set to "true" to mount the current directory as the git repository in Infrahub
+# This is useful for local development and testing of generator/transform changes
+# When enabled:
+#   - Infrahub will use /upstream (the mounted current directory) as the repo
+#   - Bootstrap script loads objects/git-repo/local-dev.yml
+# When disabled (default):
+#   - Infrahub will clone from GitHub
+#   - Bootstrap script loads objects/git-repo/github.yml
+export INFRAHUB_GIT_LOCAL=false
+
 # =============================================================================
 # Service Catalog Configuration
 # =============================================================================

CLAUDE.md

@@ -45,8 +45,10 @@ uv run infrahubctl object load objects/bootstrap --branch main
 # Load security data
 uv run infrahubctl object load objects/security/ --branch main
 
-# Add demo repository
-uv run infrahubctl repository add DEMO https://github.com/opsmill/infrahub-bundle-dc.git --read-only --ref main
+# Add bundle-dc repository (loaded from objects/git-repo/*.yml based on INFRAHUB_GIT_LOCAL)
+# - objects/git-repo/github.yml for GitHub (default)
+# - objects/git-repo/local-dev.yml for local /upstream mount
+uv run infrahubctl object load objects/git-repo/github.yml --branch main
 
 # Load event actions (optional)
 uv run infrahubctl object load objects/events/ --branch main
@@ -344,7 +346,22 @@ INFRAHUB_ADDRESS="http://localhost:8000"
 INFRAHUB_API_TOKEN="06438eb2-8019-4776-878c-0941b1f1d1ec"
 ```
 
-Note: The token above is a demo token for local development only.
+Optional environment variables for development:
+
+```bash
+# Use local git repository instead of GitHub (for development/testing)
+INFRAHUB_GIT_LOCAL="true"  # Default: false
+```
+
+When `INFRAHUB_GIT_LOCAL=true`:
+
+- Infrahub will use the current directory mounted at `/upstream` as the git repository
+- Useful for testing generator, transform, and check changes without pushing to GitHub
+- The volume mount is configured in `docker-compose.override.yml`
+- Bootstrap script automatically loads `objects/git-repo/local-dev.yml` (pointing to `/upstream`)
+- When disabled (default), bootstrap loads `objects/git-repo/github.yml` (pointing to GitHub URL)
+
+Note: The API token above is a demo token for local development only.
 
 ## Bootstrap Process
 
@@ -366,8 +383,8 @@ uv run infrahubctl object load objects/bootstrap
 # 5. Load security data (optional)
 uv run infrahubctl object load objects/security/
 
-# 6. Add repository
-uv run infrahubctl repository add DEMO https://github.com/opsmill/infrahub-bundle-dc.git --read-only --ref main
+# 6. Add repository (loaded from objects/git-repo/*.yml based on INFRAHUB_GIT_LOCAL)
+uv run infrahubctl object load objects/git-repo/github.yml --branch main
 
 # 7. Load event actions (optional)
 uv run infrahubctl object load objects/events/
@@ -446,6 +463,9 @@ The project includes a Streamlit-based service catalog application:
   - `18_devices.yml` - Pre-configured devices (corp-firewall, cisco-switch-01, etc.)
   - `19_docs.yml` - Documentation links
 - `objects/dc/` - Data center demo scenario files (Arista, Cisco, Juniper, SONiC)
+- `objects/git-repo/` - Repository configuration objects
+  - `github.yml` - GitHub repository configuration (default)
+  - `local-dev.yml` - Local development repository configuration (when INFRAHUB_GIT_LOCAL=true)
 - `objects/security/` - Security-related demo data
 - `objects/cloud_security/` - Cloud security examples
 - `objects/events/` - Event action definitions

docker-compose.override.yml

@@ -9,6 +9,16 @@ services:
       - NEO4J_dbms_memory_heap_max__size=4g
       - NEO4J_dbms_memory_pagecache_size=2g
 
+  # Mount local repository for local development
+  # Used when INFRAHUB_GIT_LOCAL=true to work with local generator/transform changes
+  infrahub-git:
+    volumes:
+      - ./:/upstream
+
+  task-worker:
+    volumes:
+      - ./:/upstream
+
   streamlit-service-catalog:
     build:
       context: ./service_catalog

objects/git-repo/github.yml

@@ -0,0 +1,9 @@
+---
+apiVersion: infrahub.app/v1
+kind: Object
+spec:
+  kind: CoreRepository
+  data:
+    - name: bundle-dc
+      location: "https://github.com/opsmill/infrahub-bundle-dc.git"
+      default_branch: "main"

objects/git-repo/local-dev.yml

@@ -0,0 +1,9 @@
+---
+apiVersion: infrahub.app/v1
+kind: Object
+spec:
+  kind: CoreRepository
+  data:
+    - name: bundle-dc
+      location: "/upstream"
+      default_branch: "main"

scripts/bootstrap.py

@@ -8,7 +8,7 @@
 - Bootstrap data (locations, platforms, roles)
 - Security data
 - User accounts and roles (emma, otto)
-- Demo repository
+- Bundle-dc repository
 - Event actions
 
 Features:
@@ -25,6 +25,7 @@
 """
 
 import argparse
+import os
 import subprocess
 import sys
 import time
@@ -46,6 +47,7 @@
 console = Console()
 
 INFRAHUB_ADDRESS = "http://localhost:8000"
+INFRAHUB_GIT_LOCAL = os.getenv("INFRAHUB_GIT_LOCAL", "false").lower() == "true"
 
 
 def check_infrahub_ready(max_retries: int = 30, sleep_time: int = 2) -> bool:
@@ -157,14 +159,14 @@ def main(branch: str = "main") -> int:
     console.print()
     console.print(
         Panel(
-            f"[bold bright_blue]🚀 Infrahub Demo Bootstrap[/bold bright_blue]\n"
+            f"[bold bright_blue]🚀 Infrahub bundle-dc Bootstrap[/bold bright_blue]\n"
             f"[bright_cyan]Branch:[/bright_cyan] [bold yellow]{branch}[/bold yellow]\n\n"
             "[dim]This will load:[/dim]\n"
             "  [blue]•[/blue] Schemas\n"
             "  [magenta]•[/magenta] Menu definitions\n"
             "  [yellow]•[/yellow] Bootstrap data\n"
             "  [green]•[/green] Security data\n"
-            "  [bright_magenta]•[/bright_magenta] Demo repository",
+            "  [bright_magenta]•[/bright_magenta] bundle-dc repository",
             border_style="bright_blue",
             box=box.SIMPLE,
             title="[bold bright_blue]Bootstrap Process[/bold bright_blue]",
@@ -238,10 +240,19 @@ def main(branch: str = "main") -> int:
 
     # Add repository (may already exist)
     console.print(
-        "\n[bold bright_magenta on black][7/8][/bold bright_magenta on black] 📚 [bold white]Adding demo repository[/bold white]"
+        "\n[bold bright_magenta on black][7/8][/bold bright_magenta on black] 📚 [bold white]Adding bundle-dc repository[/bold white]"
     )
+
+    # Use local repository if INFRAHUB_GIT_LOCAL is enabled, otherwise use GitHub
+    if INFRAHUB_GIT_LOCAL:
+        repo_file = "objects/git-repo/local-dev.yml"
+        console.print("[dim]Using local repository: /upstream[/dim]")
+    else:
+        repo_file = "objects/git-repo/github.yml"
+        console.print("[dim]Using GitHub repository: https://github.com/opsmill/infrahub-bundle-dc.git[/dim]")
+
     result = subprocess.run(
-        "uv run infrahubctl repository add DEMO https://github.com/opsmill/infrahub-bundle-dc.git --ref main --read-only --ref main",
+        f"uv run infrahubctl object load {repo_file} --branch {branch}",
         shell=True,
         capture_output=True,
         text=True,