Merge pull request #56 from Ardenexal/claude/generate-extension-classes-SLUWW

feat: add fhir:generate-ig command for IG extension and profile class generation

Author: Ardenexal

.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+      "symfony-ai-mate": {
+          "command": "php",
+          "args": [
+              "vendor/symfony/ai-mate/bin/mate.php",
+              "serve"
+          ]
+      }
+
+  }
+}

AGENTS.md

@@ -178,3 +178,10 @@ Before submitting changes, confirm:
 - **FHIRBundle Guide**: `/docs/component-guides/fhir-bundle.md` - Symfony integration
 - **CodeGeneration Guide**: `/docs/component-guides/code-generation.md` - Standalone generation
 - **Serialization Guide**: `/docs/component-guides/serialization.md` - JSON serialization
+
+<!-- BEGIN AI_MATE_INSTRUCTIONS -->
+AI Mate Summary:
+- Role: MCP-powered, project-aware coding guidance and tools.
+- Required action: Read and follow `mate/AGENT_INSTRUCTIONS.md` before taking any action in this project, and prefer MCP tools over raw CLI commands whenever possible.
+- Installed extensions: matesofmate/phpstan-extension, matesofmate/phpunit-extension, symfony/ai-mate, symfony/ai-symfony-mate-extension.
+<!-- END AI_MATE_INSTRUCTIONS -->

CLAUDE.md

@@ -170,3 +170,10 @@ $context = FHIRSerializationContext::forJson()
 - Use conventional commits: `feat:`, `fix:`, `chore:`, `test:`
 - No AI mentions in commits or PRs
 - Sign commits with GPG when possible
+
+<!-- BEGIN AI_MATE_INSTRUCTIONS -->
+AI Mate Summary:
+- Role: MCP-powered, project-aware coding guidance and tools.
+- Required action: Read and follow `mate/AGENT_INSTRUCTIONS.md` before taking any action in this project, and prefer MCP tools over raw CLI commands whenever possible.
+- Installed extensions: matesofmate/phpstan-extension, matesofmate/phpunit-extension, symfony/ai-mate, symfony/ai-symfony-mate-extension.
+<!-- END AI_MATE_INSTRUCTIONS -->

README.md

@@ -51,6 +51,9 @@ If you've installed `ardenexal/fhir-bundle` in your Symfony application:
 # Generate FHIR models
 php bin/console fhir:generate --package=hl7.fhir.r4.core -vvv
 
+# Generate typed classes for an Implementation Guide
+php bin/console fhir:generate-ig --package=hl7.fhir.us.core
+
 # Evaluate FHIRPath expressions
 php bin/console fhir:path:evaluate "5 + 3"
 
@@ -146,7 +149,8 @@ When you install `ardenexal/fhir-bundle` in your Symfony application, you get th
 
 | Command | Description |
 |---------|-------------|
-| `fhir:generate` | Generate PHP model classes from FHIR packages |
+| `fhir:generate` | Generate PHP model classes from FHIR packages (R4, R4B, R5) |
+| `fhir:generate-ig` | Generate typed extension and profile classes for FHIR IGs |
 | `fhir:path:evaluate` | Evaluate a FHIRPath expression against FHIR data |
 | `fhir:path:validate` | Validate FHIRPath expression syntax |
 

bin/codex

@@ -0,0 +1,19 @@
+#!/usr/bin/env sh
+
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname "$0")" && pwd)
+PROJECT_DIR=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
+
+if ! command -v codex >/dev/null 2>&1; then
+    echo "Codex CLI is not installed or not available in PATH." >&2
+    echo "Install Codex and try again." >&2
+    exit 1
+fi
+
+cd "$PROJECT_DIR"
+
+exec codex \
+    -c "mcp_servers.symfony_ai_mate_local.command='./vendor/bin/mate'" \
+    -c "mcp_servers.symfony_ai_mate_local.args=['serve','--force-keep-alive']" \
+    "$@"

bin/codex.bat

@@ -0,0 +1,19 @@
+@echo off
+setlocal
+
+set "SCRIPT_DIR=%~dp0"
+for %%I in ("%SCRIPT_DIR%..") do set "PROJECT_DIR=%%~fI"
+
+where codex >nul 2>nul
+if errorlevel 1 (
+    echo Codex CLI is not installed or not available in PATH. 1>&2
+    echo Install Codex and try again. 1>&2
+    exit /b 1
+)
+
+pushd "%PROJECT_DIR%" >nul
+codex -c "mcp_servers.symfony_ai_mate_local.command='./vendor/bin/mate'" -c "mcp_servers.symfony_ai_mate_local.args=['serve','--force-keep-alive']" %*
+set "CODE=%ERRORLEVEL%"
+popd >nul
+
+exit /b %CODE%

composer.json

@@ -27,6 +27,8 @@
         "amphp/http-client": "^5.3.4",
         "brick/date-time": "^0.9.0",
         "composer/semver": "^3.4.4",
+        "matesofmate/composer-extension": "^0.2.0",
+        "matesofmate/phpstan-extension": "^0.2.0",
         "nette/php-generator": "^4.2.1",
         "psr/cache": "^3.0",
         "psr/http-client": "^1.0",
@@ -49,20 +51,25 @@
     "require-dev": {
         "fhir/fhir-test-cases": "1.7.49",
         "giorgiosironi/eris": "^1.0",
+        "helgesverre/toon": "^3.1",
         "laravel/pint": "^1.27.1",
+        "matesofmate/phpunit-extension": "^0.2.0",
         "phpbench/phpbench": "^1.4",
         "phpstan/phpstan": "^2.1.39",
         "phpstan/phpstan-symfony": "^2.0.14",
         "phpunit/phpunit": "^11.0|^12.5.14",
         "roave/security-advisories": "dev-latest",
+        "symfony/ai-mate": "^0.7.0",
+        "symfony/ai-symfony-mate-extension": "^0.7.0",
         "symfony/browser-kit": "^6.4|^7.4.4",
         "symfony/css-selector": "^6.4|^7.4",
         "symfony/dom-crawler": "^6.4|^7.4.4",
         "symfony/phpunit-bridge": "^6.4|^7.4.3"
     },
     "config": {
         "allow-plugins": {
-            "php-http/discovery": true
+            "php-http/discovery": true,
+            "symfony/ai-mate-composer-plugin": true
         },
         "bump-after-update": true,
         "sort-packages": true
@@ -83,7 +90,8 @@
             "Ardenexal\\FHIRTools\\Bundle\\FHIRBundle\\Tests\\": "src/Bundle/FHIRBundle/tests/",
             "Ardenexal\\FHIRTools\\Component\\FHIRPath\\Tests\\": "src/Component/FHIRPath/tests/",
             "Ardenexal\\FHIRTools\\Component\\Serialization\\Tests\\": "src/Component/Serialization/tests/",
-            "Ardenexal\\FHIRTools\\Benchmarks\\": "bench/"
+            "Ardenexal\\FHIRTools\\Benchmarks\\": "bench/",
+            "App\\Mate\\": "mate/src/"
         }
     },
     "replace": {
@@ -109,7 +117,7 @@
         "phpstan-ai:fhir-path": "php scripts/ai-phpstan-runner.php src/Component/FHIRPath/",
         "lint": "php ./vendor/bin/pint -v --parallel --max-processes=4",
         "lint:bundle": "php ./vendor/bin/pint src/Bundle/ -v --parallel --max-processes=4",
-        "lint:models": "php ./vendor/bin/pint src/Component/Models -v --parallel --max-processes=4",
+        "lint:models": "php ./vendor/bin/pint src/Component/Models -v",
         "lint:codegen": "php ./vendor/bin/pint src/Component/CodeGeneration/ -v --parallel --max-processes=4",
         "lint:serialization": "php ./vendor/bin/pint src/Component/Serialization/ -v --parallel --max-processes=4",
         "lint:fhir-path": "php ./vendor/bin/pint src/Component/FHIRPath/ -v --parallel --max-processes=4",
@@ -164,22 +172,25 @@
             "@quality:serialization",
             "@quality:fhir-path"
         ],
+        "generate-ig-au-base": "php ./demo/bin/console fhir:generate-ig --package=hl7.fhir.au.base -vvv",
+        "generate-ig-au-core": "php ./demo/bin/console fhir:generate-ig --package=hl7.fhir.au.base --package=hl7.fhir.au.core -vvv",
+        "generate-ig-us-core": "php ./demo/bin/console fhir:generate-ig --package=hl7.fhir.us.core -vvv",
         "generate-models": "php ./demo/bin/console fhir:generate -vvv",
         "generate-models-all": [
             "echo 'Generating FHIR R4 models...'",
-            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core --package=hl7.fhir.r4b.core --package=hl7.fhir.r5.core -vvv",
+            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core --package=hl7.fhir.uv.extensions.r4 --package=hl7.fhir.r4b.core --package=hl7.fhir.uv.extensions.r4b --package=hl7.fhir.r5.core --package=hl7.fhir.uv.extensions.r5 -vvv",
             "echo 'All FHIR models generated successfully!'"
         ],
         "generate-models-r4": [
-            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core -vvv",
+            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core --package=hl7.fhir.uv.extensions.r4 -vvv",
             "@lint:models"
         ],
         "generate-models-r4b": [
-            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4b.core -vvv",
+            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4b.core --package=hl7.fhir.uv.extensions.r4b -vvv",
             "@lint:models"
         ],
         "generate-models-r5": [
-            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r5.core -vvv",
+            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r5.core --package=hl7.fhir.uv.extensions.r5 -vvv",
             "@lint:models"
         ],
         "fix-newlines": "powershell -ExecutionPolicy Bypass -File scripts/fix-newlines.ps1",
@@ -192,5 +203,16 @@
         "bench:fhirpath": "php ./vendor/bin/phpbench run bench/FHIRPath/ --report=aggregate",
         "bench:baseline": "php ./vendor/bin/phpbench run bench/ --report=aggregate --store --tag=baseline",
         "bench:regression": "php ./vendor/bin/phpbench run bench/ --report=compare --ref=baseline --assert=\"mode(variant.time.avg) < mode(baseline.time.avg) * 1.50\""
+    },
+    "extra": {
+        "ai-mate": {
+            "extension": false,
+            "scan-dirs": [
+                "mate/src"
+            ],
+            "includes": [
+                "mate/config.php"
+            ]
+        }
     }
 }

demo/.gitignore

@@ -2,6 +2,9 @@
 # Override root .gitignore — the demo app's lock file should be tracked
 !composer.lock
 
+# Generated FHIR IG classes (run `composer generate-ig-*` to regenerate)
+/src/FHIRIG/
+
 ###> symfony/framework-bundle ###
 /.env.local
 /.env.local.php

demo/composer.json

@@ -46,6 +46,7 @@
     },
     "autoload": {
         "psr-4": {
+            "App\\FHIR\\IG\\": "src/FHIRIG/",
             "App\\": "src/",
             "Ardenexal\\FHIRTools\\Bundle\\FHIRBundle\\": "../src/Bundle/FHIRBundle/src/",
             "Ardenexal\\FHIRTools\\Component\\CodeGeneration\\": "../src/Component/CodeGeneration/src/",

demo/config/packages/fhir.yaml

@@ -3,3 +3,12 @@ fhir:
     validation:
         enabled: true
         strict_mode: false
+
+    # Implementation Guide generation — run: php bin/console fhir:generate-ig --package=hl7.fhir.au.base
+    # Or use the root composer scripts: composer generate-ig-au-base, generate-ig-au-core, generate-ig-us-core
+    # After generation, clear the Symfony cache: php bin/console cache:clear
+    ig:
+        namespace: 'App\FHIR\IG'                       # must match PSR-4 autoload in composer.json
+        output_directory: '%kernel.project_dir%/src/FHIRIG'
+        offline: false                                  # set true to skip network downloads
+        packages: []                                    # specify in dependency order via CLI --package args