fix: update changelog script import path in release workflow

refactor: remove redundant release content structure validation from tests

chore: update biome configuration to include all scripts

chore: add new changelog script and remove deprecated action.yml

test: add parse-modules-test script for local testing of parseTerraformModules function

feat: implement changelog generation with GitHub API integration

delete: remove unused development script for parsing modules

Author: virgofx

.devcontainer/devcontainer.json

@@ -51,6 +51,7 @@
     "GITHUB_TOKEN": "${localEnv:GITHUB_TOKEN}"
   },
   "features": {
+    "ghcr.io/devcontainers/features/github-cli:1": {},
     "ghcr.io/devcontainers-community/npm-features/prettier": {}
   }
 }

.github/workflows/lint.yml

@@ -42,7 +42,7 @@ jobs:
 
       - name: Lint Codebase
         id: super-linter
-        uses: super-linter/super-linter@12150456a73e248bdc94d0794898f94e23127c88 # v7.4.0
+        uses: super-linter/super-linter@5119dcd8011e92182ce8219d9e9efc82f16fddb6 # v8.0.0
         env:
           DEFAULT_BRANCH: main
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release-start.yml

@@ -66,7 +66,7 @@ jobs:
         with:
           result-encoding: json
           script: |
-            const { generateChangelog } = await import('${{ github.workspace }}/.github/scripts/changelog.js');
+            const { generateChangelog } = await import('${{ github.workspace }}/scripts/changelog.js');
 
             try {
               const changelog = await generateChangelog("${{ env.VERSION }}");

README.md

@@ -207,14 +207,12 @@ configuring the following optional input parameters as needed.
 
 - **`module-path-ignore`**: Completely ignores specified module paths. Any module whose path matches any pattern in this
   list will not be processed at all by the action. This is useful for:
-
   - Excluding example modules (e.g., `**/examples/**`)
   - Skipping test modules (e.g., `**/test/**`)
   - Ignoring documentation-focused modules (e.g., `**/docs/**`)
   - Excluding entire directories or paths that contain Terraform files but shouldn't be versioned as modules
 
   **Important pattern matching notes:**
-
   - Patterns are relative to the workspace directory (no leading slash)
   - A pattern like `dir/**` will match files and directories INSIDE `dir` but NOT the `dir` directory itself
   - To match both a directory and its contents, you need both patterns: `dir,dir/**`
@@ -230,15 +228,13 @@ configuring the following optional input parameters as needed.
   a new module release.
 
   **Key details:**
-
   - Patterns are relative to each **module directory**, not the workspace root
   - Uses `matchBase: true` for pattern matching, so `*.md` will match any Markdown file in any subdirectory
   - Applied only after a module is identified but before determining if it needs a version change
   - Default patterns: `.gitignore, *.md, *.tftest.hcl, tests/**`
   - Use this for files that should be part of the module but don't affect its functionality
 
   **Common use cases:**
-
   - Documentation files (`*.md`, `docs/**`)
   - Test files (`tests/**`, `*.tftest.hcl`)
   - Examples (`examples/**`)
@@ -256,15 +252,13 @@ configuring the following optional input parameters as needed.
   are _excluded_ from the asset. This helps reduce the asset size by omitting test files, examples, documentation, etc.
 
   **Key details:**
-
   - Patterns are relative to each **module directory**, not the workspace root
   - Uses `matchBase: true` for pattern matching (same as `module-change-exclude-patterns`)
   - Applied during the bundle/archive creation phase for GitHub releases
   - Default patterns: `.gitignore, *.md, *.tftest.hcl, tests/**`
   - These patterns do NOT affect versioning decisions - only the contents of release assets
 
   **Common use cases:**
-
   - Test directories and files (`tests/**`, `*.tftest.hcl`)
   - Documentation that's not needed for module functionality (`*.md`)
   - Development-specific files (`.gitignore`, `CHANGELOG.md`)

__tests__/releases.test.ts

@@ -96,26 +96,12 @@ describe('releases', () => {
       expect(versions).toEqual(sortedVersions);
     });
 
-    it('should validate release content structure', () => {
-      for (const release of releases) {
-        // Basic structure checks
-        expect(release).toHaveProperty('id');
-        expect(release).toHaveProperty('title');
-        expect(release).toHaveProperty('body');
-
-        // Title format check (should at least contain v1.1.1)
-        expect(release.title).toMatch(/v\d+\.\d+\.\d+/);
-
-        // Body content checks
-        expect(typeof release.body).toBe('string');
-        expect(release.body.length).toBeGreaterThan(0);
-      }
-    });
-
     it('should verify specific release contents', () => {
-      // Find v1.3.0 release
+      // Find v1.3.0 release (This is specific for this repo - which is fine as we are just testing release object parsing)
       const v130Release = releases.find((r) => r.title === 'v1.3.0');
       expect(v130Release).toBeDefined();
+      expect(v130Release?.tagName).toBe('v1.3.0');
+      expect(v130Release?.title).toBe('v1.3.0');
       expect(v130Release?.id).toBe(182147836);
       expect(v130Release?.body).toContain('Enhanced Wiki Generation');
       expect(v130Release?.body).toContain('Asset & Exclude Pattern Filtering');

action.yml

@@ -127,7 +127,7 @@ inputs:
       Character used to separate directory path components in Git tags. This separator is used to convert 
       module directory paths into tag names (e.g., 'modules/aws/s3-bucket' becomes 'modules-aws-s3-bucket-v1.0.0' 
       when using '-'). Must be a single character from: /, -, _, or .
-      
+
       Examples with different separators:
       - "/" (default): modules/aws/s3-bucket/v1.0.0
       - "-": modules-aws-s3-bucket-v1.0.0  

biome.json

@@ -9,7 +9,16 @@
     "enabled": false
   },
   "files": {
-    "includes": ["*.md", "*.ts", "__mocks__/**/*.ts", "__tests__/**/*.ts", "src/**/*.ts", "scripts/**/*.ts"]
+    "includes": [
+      "*.md",
+      "*.ts",
+      "*.json",
+      "__mocks__/**/*.ts",
+      "__tests__/**/*.ts",
+      ".devcontainer/*.json",
+      "src/**/*.ts",
+      "scripts/**/*"
+    ]
   },
   "formatter": {
     "enabled": true,

package.json

@@ -13,7 +13,13 @@
   "bugs": {
     "url": "https://github.com/techpivot/terraform-module-releaser/issues"
   },
-  "keywords": ["terraform", "module", "releaser", "github-action", "monorepo"],
+  "keywords": [
+    "terraform",
+    "module",
+    "releaser",
+    "github-action",
+    "monorepo"
+  ],
   "license": "MIT",
   "exports": {
     ".": "./dist/index.js"
@@ -36,16 +42,18 @@
     "bundle": "npm run check:fix && npm run package",
     "check": "biome check ./src",
     "check:fix": "biome check --write --unsafe .",
+    "prettier": "npx prettier -w *.md",
     "dev:parse-modules": "tsx scripts/dev-parse-modules.ts",
     "textlint": "textlint -c .github/linters/.textlintrc **/*.md",
     "textlint:fix": "textlint -c .github/linters/.textlintrc --fix **/*.md",
     "typecheck": "tsc --noEmit",
     "package": "ncc build src/index.ts --source-map -o dist",
     "test": "vitest run --coverage",
     "test:watch": "vitest",
+    "test:parse-modules": "tsx scripts/parse-modules-test.ts",
+    "changelog": "node scripts/changelog.js 10.0.0",
     "coverage": "make-coverage-badge --output-path ./assets/coverage-badge.svg",
-    "terraform-docs-version": "gh api repos/terraform-docs/terraform-docs/releases/latest --jq '.tag_name'",
-    "changelog:test": "node .github/scripts/changelog.js 10.0.0"
+    "terraform-docs-version": "gh api repos/terraform-docs/terraform-docs/releases/latest --jq '.tag_name'"
   },
   "dependencies": {
     "@actions/core": "^1.11.1",

scripts/action.yml

@@ -8,8 +8,8 @@
  * USAGE:
  * ------
  * 1. Set up environment variables (see below)
- * 2. Run via npm script: `npm run changelog:test -- "1.2.3"`
- * 3. Or import and use: `import { generateChangelog } from './.github/scripts/changelog.js'`
+ * 2. Run via npm script: `npm run changelog -- "1.2.3"`
+ * 3. Or import and use: `import { generateChangelog } from './scripts/changelog.js'`
  *
  * TESTING LOCALLY:
  * ----------------
@@ -21,10 +21,10 @@
  * export GITHUB_TOKEN="your_github_token_here"
  *
  * # Run the test script
- * npm run changelog:test -- "1.2.3"
+ * npm run changelog"
  *
- * # Or test with different versions
- * npm run changelog:test -- "2.0.0"
+ * # Or test with different next version (Only used for display purposes)
+ * npm run changelog -- "2.0.0"
  *
  * Required Environment Variables:
  * ------------------------------
@@ -62,7 +62,7 @@ import https from 'node:https';
 import OpenAI from 'openai';
 
 const ENDPOINT = 'https://models.github.ai/inference';
-const MODEL = 'openai/gpt-4.1';
+const MODEL = 'openai/gpt-4.1'; // gpt-5 has max request size of 4000 tokens on free
 const PROMPT = `
 You're the head of developer relations at a SaaS company. Write a concise, professional, and engaging changelog that prioritizes user-impacting changes and tells a story about the release.
 
@@ -542,19 +542,16 @@ export { generateChangelog };
 
 /**
  * CLI interface for testing the changelog generator locally.
- *
- * Usage: node .github/scripts/changelog.js [version]
- * Example: node .github/scripts/changelog.js "1.2.3"
  */
 async function main() {
   // Check if this script is being run directly (not imported)
   if (import.meta.url === `file://${process.argv[1]}`) {
     const version = process.argv[2];
 
     if (!version) {
-      console.error('❌ Error: Version argument is required');
-      console.error('Usage: node .github/scripts/changelog.js [version]');
-      console.error('Example: node .github/scripts/changelog.js "1.2.3"');
+      console.error('❌ Error: Next version argument is required');
+      console.error('Usage: node scripts/changelog.js [next-version]');
+      console.error('Example: node scripts/changelog.js "1.2.3"');
       process.exit(1);
     }