agents-md-gen 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 0.4.1
+
+- Ship `CHANGELOG.md` inside the published package.
+- First release published via npm's OIDC trusted publishing from GitHub
+  Actions instead of a manually-generated token.
+
+## 0.4.0
+
+- Detect monorepos (Turborepo, Nx, Lerna, npm/yarn/pnpm workspaces) and
+  list their sub-packages by name.
+
+## 0.3.0
+
+- Add `--check`: exits 1 if the output file is missing or out of date,
+  without writing anything. Meant for CI.
+- Fix: the tool's own output file (`AGENTS.md`/`CLAUDE.md`) could appear
+  inconsistently in its own "Structure" section depending on whether it
+  already existed when the repo was scanned, which would have made
+  `--check` report false positives forever after the first run. Both
+  files are now excluded from the structure listing.
+
+## 0.2.0
+
+- Detect Java/Kotlin projects (Maven, Gradle, including wrapper scripts).
+
+## 0.1.1
+
+- Broaden npm keywords for discoverability.
+- Add a real example output to the README.
+
+## 0.1.0
+
+- Initial release. Detects Node.js/TypeScript, Python, Rust, Go, and Ruby
+  projects and generates `AGENTS.md`/`CLAUDE.md` from what it finds:
+  package manager, framework, test runner, build/test/lint commands,
+  top-level structure, CI, and license.

package/README.md

@@ -21,6 +21,8 @@ on immediately.
 - **Go** — go.mod, golangci-lint
 - **Ruby** — Bundler, RSpec
 - **Java/Kotlin** — Maven, Gradle (with wrapper detection)
+- **Monorepos** — Turborepo, Nx, Lerna, npm/yarn/pnpm workspaces, listing
+  each detected sub-package
 - CI (GitHub Actions), license, and top-level project structure
 
 ## GitHub Action

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-md-gen",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure",
   "license": "MIT",
   "bin": {
@@ -9,7 +9,8 @@
   "main": "src/index.js",
   "files": [
     "bin",
-    "src"
+    "src",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18.3.0"
@@ -29,6 +30,9 @@
     "java",
     "maven",
     "gradle",
+    "monorepo",
+    "turborepo",
+    "nx",
     "cli",
     "codegen",
     "developer-tools"

package/src/detect.js

@@ -272,6 +272,50 @@ function detectLicense(root) {
   return null;
 }
 
+function detectMonorepo(root) {
+  const pkg = readJson(root, 'package.json');
+  const patterns = [];
+
+  if (pkg && Array.isArray(pkg.workspaces)) {
+    patterns.push(...pkg.workspaces);
+  } else if (pkg && pkg.workspaces && Array.isArray(pkg.workspaces.packages)) {
+    patterns.push(...pkg.workspaces.packages);
+  }
+
+  const pnpmWorkspace = readText(root, 'pnpm-workspace.yaml');
+  if (pnpmWorkspace) {
+    for (const m of pnpmWorkspace.matchAll(/^\s*-\s*['"]?([^'"\n]+)['"]?\s*$/gm)) {
+      patterns.push(m[1].trim());
+    }
+  }
+
+  const tool = exists(root, 'turbo.json') ? 'Turborepo'
+    : exists(root, 'nx.json') ? 'Nx'
+    : exists(root, 'lerna.json') ? 'Lerna'
+    : patterns.length ? 'workspaces'
+    : null;
+
+  if (!tool) return null;
+
+  const packages = new Set();
+  for (const pattern of patterns) {
+    const dirPath = path.join(root, pattern.replace(/\/\*+$/, ''));
+    let entries;
+    try {
+      entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const subPkg = readJson(dirPath, e.name, 'package.json');
+      if (subPkg) packages.add(subPkg.name || e.name);
+    }
+  }
+
+  return { tool, packages: [...packages].sort() };
+}
+
 function detectProject(root) {
   const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby, detectJava];
   const stacks = detectors.map((fn) => fn(root)).filter(Boolean);
@@ -279,6 +323,7 @@ function detectProject(root) {
   return {
     root,
     stacks,
+    monorepo: detectMonorepo(root),
     structure: listStructure(root),
     ci: detectCI(root),
     license: detectLicense(root),

package/src/render.js

@@ -51,6 +51,16 @@ function renderStack(stack) {
   return parts.join('\n');
 }
 
+function renderMonorepo(monorepo) {
+  if (!monorepo) return null;
+  const lines = [`This is a monorepo (${monorepo.tool}).`];
+  if (monorepo.packages.length) {
+    lines.push('', 'Packages:', '');
+    lines.push(...monorepo.packages.map((p) => `- \`${p}\``));
+  }
+  return ['## Monorepo', '', ...lines].join('\n');
+}
+
 function renderStructure(structure) {
   if (!structure.length) return null;
   const lines = structure.map((entry) => {
@@ -87,6 +97,9 @@ function renderAgentsMd(project) {
     }
   }
 
+  const monorepo = renderMonorepo(project.monorepo);
+  if (monorepo) sections.push('', monorepo);
+
   const structure = renderStructure(project.structure);
   if (structure) sections.push('', structure);