agents-md-gen 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.5.0
+
+- Detect PHP/Composer projects (Laravel/Symfony framework detection,
+  PHPUnit, PHPCS).
+- Detect .NET/C# projects via `.csproj`/`.sln` (xUnit/NUnit/MSTest
+  detection).
+
 ## 0.4.2
 
 - Detect Docker (`Dockerfile`, `docker-compose.yml`/`compose.yml`) and

package/README.md

@@ -60,6 +60,8 @@ docker run --rm -v "$PWD":/workdir ghcr.io/peshino2012/agents-md-gen
 - **Go** — go.mod, golangci-lint
 - **Ruby** — Bundler, RSpec
 - **Java/Kotlin** — Maven, Gradle (with wrapper detection)
+- **PHP** — Composer, Laravel/Symfony detection, PHPUnit
+- **.NET/C#** — NuGet, xUnit/NUnit/MSTest detection
 - **Monorepos** — Turborepo, Nx, Lerna, npm/yarn/pnpm workspaces, listing
   each detected sub-package
 - CI (GitHub Actions), license, and top-level project structure

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-md-gen",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure",
   "license": "MIT",
   "funding": {
@@ -37,6 +37,11 @@
     "monorepo",
     "turborepo",
     "nx",
+    "php",
+    "composer",
+    "laravel",
+    "dotnet",
+    "csharp",
     "cli",
     "codegen",
     "developer-tools"

package/src/detect.js

@@ -229,6 +229,71 @@ function detectRuby(root) {
   };
 }
 
+function detectPhp(root) {
+  const composer = readJson(root, 'composer.json');
+  if (!composer) return null;
+
+  const deps = composer.require || {};
+  const devDeps = composer['require-dev'] || {};
+  const usesPhpunit = 'phpunit/phpunit' in devDeps || exists(root, 'phpunit.xml') || exists(root, 'phpunit.xml.dist');
+  const usesPhpcs = 'squizlabs/php_codesniffer' in devDeps || exists(root, 'phpcs.xml') || exists(root, 'phpcs.xml.dist');
+  const scripts = composer.scripts || {};
+
+  return {
+    ecosystem: 'PHP',
+    name: composer.name || null,
+    description: composer.description || null,
+    packageManager: 'composer',
+    frameworks: [
+      'laravel/framework' in deps ? 'Laravel' : null,
+      'symfony/framework-bundle' in deps ? 'Symfony' : null,
+    ].filter(Boolean),
+    testFramework: usesPhpunit ? 'PHPUnit' : null,
+    commands: {
+      install: 'composer install',
+      build: null,
+      test: scripts.test ? 'composer test' : (usesPhpunit ? 'vendor/bin/phpunit' : null),
+      lint: usesPhpcs ? 'vendor/bin/phpcs' : null,
+      dev: null,
+    },
+  };
+}
+
+function detectDotnet(root) {
+  let entries;
+  try {
+    entries = fs.readdirSync(root, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+  const files = entries.filter((e) => e.isFile()).map((e) => e.name);
+  const sln = files.find((f) => f.endsWith('.sln'));
+  const csproj = files.find((f) => f.endsWith('.csproj'));
+  if (!sln && !csproj) return null;
+
+  const projectText = csproj ? (readText(root, csproj) || '') : '';
+  const testFramework = /xunit/i.test(projectText) ? 'xUnit'
+    : /nunit/i.test(projectText) ? 'NUnit'
+    : /Microsoft\.NET\.Test\.Sdk/i.test(projectText) ? 'MSTest'
+    : null;
+
+  return {
+    ecosystem: '.NET',
+    name: sln ? sln.replace(/\.sln$/, '') : (csproj ? csproj.replace(/\.csproj$/, '') : null),
+    description: null,
+    packageManager: 'nuget',
+    frameworks: [],
+    testFramework,
+    commands: {
+      install: 'dotnet restore',
+      build: 'dotnet build',
+      test: testFramework ? 'dotnet test' : null,
+      lint: 'dotnet format',
+      dev: null,
+    },
+  };
+}
+
 // Excluded so re-running the generator doesn't see its own prior output as
 // part of the repo's structure - otherwise the file it just wrote would
 // never match a freshly rendered one, breaking `--check`.
@@ -325,7 +390,7 @@ function detectMonorepo(root) {
 }
 
 function detectProject(root) {
-  const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby, detectJava];
+  const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby, detectJava, detectPhp, detectDotnet];
   const stacks = detectors.map((fn) => fn(root)).filter(Boolean);
 
   return {