Skip to content

chore: regenerate all skill CHANGELOGs with path-filtered history#140

Merged
trieloff merged 1 commit into
mainfrom
chore/clean-up-changelogs
May 21, 2026
Merged

chore: regenerate all skill CHANGELOGs with path-filtered history#140
trieloff merged 1 commit into
mainfrom
chore/clean-up-changelogs

Conversation

@trieloff

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #139, which fixed the root cause for future releases.

  • All 25 skill CHANGELOG.md files previously contained commits from the entire repo (e.g. scrape-webpage v2.0.0 listed 30+ commits from stardust, migration, aem-workflow, etc.)
  • This regenerates every changelog from scratch using git log -- <skill-dir> so each file only shows commits that actually touched that skill
  • Adds scripts/regenerate-changelogs.cjs in case a manual re-run is ever needed (uses only Node.js built-ins, no npm ci required)

Note on empty release sections: some versions (e.g. a 1.0.0 with no body) were triggered by docs/refactor commits which bump the version per our releaseRules config but are intentionally omitted from the CHANGELOG body by the angular preset. This matches what the fixed tooling will produce going forward.

Test plan

  • Spot-check a few CHANGELOG.md files to confirm they only reference commits that touched that skill's directory
  • Confirm no skill that had real feat/fix commits is missing them from its changelog
  • Verify scripts/regenerate-changelogs.cjs runs cleanly: node scripts/regenerate-changelogs.cjs

🤖 Generated with Claude Code

All existing CHANGELOG.md files contained commits from the entire repo
since the skill's last tag, making release notes meaningless. This
regenerates each one from scratch using git log filtered to the skill's
own directory, following up on #139 which fixed the root cause for
future releases.

Empty release sections (e.g. 1.0.0) indicate versions bumped solely by
docs/refactor commits, which is correct — the angular preset omits those
types from the CHANGELOG body.

Also adds scripts/regenerate-changelogs.cjs in case a manual re-run is
ever needed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@trieloff trieloff requested a review from asthabh23 as a code owner May 20, 2026 22:53
Copilot AI review requested due to automatic review settings May 20, 2026 22:53
@trieloff trieloff requested a review from shsteimer as a code owner May 20, 2026 22:53
@github-actions

Copy link
Copy Markdown

Tessl Skill Lint

⚠️ edge-delivery-services — 2 warning(s)
⚠ .tileignore is deprecated. Rename it to .tesslignore; the legacy filename will be removed in a future release.
⚠ Skill 'code-review': SKILL.md is approximately 10315 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.

Context Cost

Skills
  - analyze-and-plan: 120 front-loaded, 1.6k-4.4k on-demand tokens
  - create-site: 79 front-loaded, 2.7k on-demand tokens
  - authoring-analysis: 52 front-loaded, 3.2k on-demand tokens
  - block-collection-and-party: 71 front-loaded, 4.8k on-demand tokens
  - block-inventory: 60 front-loaded, 2.2k on-demand tokens
  - building-blocks: 75 front-loaded, 2.3k-6.7k on-demand tokens
  - code-review: 60 front-loaded, 10.3k-13.1k on-demand tokens
  - content-driven-development: 74 front-loaded, 3.7k-8.6k on-demand tokens
  - content-modeling: 61 front-loaded, 2.4k-9.1k on-demand tokens
  - da-auth: 94 front-loaded, 1.2k on-demand tokens
  - docs-search: 75 front-loaded, 1.8k on-demand tokens
  - find-test-content: 52 front-loaded, 1.7k on-demand tokens
  - generate-import-html: 49 front-loaded, 2.3k-11k on-demand tokens
  - identify-page-structure: 59 front-loaded, 1.6k on-demand tokens
  - page-decomposition: 58 front-loaded, 2.1k on-demand tokens
  - page-import: 75 front-loaded, 1.8k on-demand tokens
  - preview-import: 46 front-loaded, 1.2k-4.9k on-demand tokens
  - scrape-webpage: 54 front-loaded, 1.3k-3.9k on-demand tokens
  - testing-blocks: 86 front-loaded, 2.5k-8.2k on-demand tokens
  - ue-component-model: 186 front-loaded, 2.4k-11.1k on-demand tokens

Total: 1.5k front-loaded, 53k-104.1k on-demand tokens

✔ Tile adobe/aem-edge-delivery-services@0.1.0 is valid
⚠️ stardust — 6 warning(s)
⚠ Found 34 orphaned file(s) not linked from manifest entrypoints:
- skills/direct/reference/direction-format.md
- skills/direct/reference/palette-picker.md
- skills/direct/reference/palettes/README.md
- skills/extract/reference/brand-review-template.md
- skills/extract/reference/brand-surface.md
- skills/extract/reference/current-state-schema.md
- skills/extract/reference/ia-extraction.md
- skills/extract/reference/playwright-recipe.md
- skills/migrate/reference/asset-bundling.md
- skills/migrate/reference/content-preservation.md
- skills/migrate/reference/metadata-and-jsonld.md
- skills/migrate/reference/migration-procedure.md
- skills/migrate/reference/template-and-module-rendering.md
- skills/prepare-migration/SKILL.md
- skills/prototype/fixtures/composition-delta-good.md
- skills/prototype/fixtures/composition-delta-trivial.md
- skills/prototype/reference/anti-template-bank.md
- skills/prototype/reference/approval-fold-back.md
- skills/prototype/reference/canon-extraction.md
- skills/prototype/reference/fidelity-refined-pass.md
- skills/prototype/reference/mobile-nav-collapse.md
- skills/prototype/reference/page-shape-brief.md
- skills/prototype/reference/proposed-file-shell.md
- skills/prototype/reference/publish-sample.md
- skills/stardust/reference/artifact-map.md
- skills/stardust/reference/data-attributes.md
- skills/stardust/reference/divergence-toolkit.md
- skills/stardust/reference/impeccable-command-map.md
- skills/stardust/reference/intent-dimensions.md
- skills/stardust/reference/intent-examples.md
- skills/stardust/reference/intent-reasoning.md
- skills/stardust/reference/migrate-output-format.md
- skills/stardust/reference/state-machine.md
- skills/stardust/reference/token-contract.md
⚠ Found 6 skill file(s) outside spec directories (references/, assets/, scripts/):
- skills/direct/reference/palettes/library.json
- skills/prototype/fixtures/mobile-nav-broken-example.html
- skills/prototype/fixtures/mobile-nav-collapse-example.html
- skills/prototype/fixtures/mobile-nav-audit.mjs
- skills/migrate/fixtures/pagemap-audit.mjs
- skills/migrate/fixtures/file-protocol-audit.mjs
⚠ Skill 'extract': SKILL.md is approximately 7994 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'direct': SKILL.md is approximately 15590 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'prototype': SKILL.md is approximately 13260 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'migrate': SKILL.md is approximately 5385 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.

Context Cost

Skills
  - stardust: 33 front-loaded, 1.5k on-demand tokens
  - extract: 45 front-loaded, 8k on-demand tokens
  - direct: 96 front-loaded, 15.6k on-demand tokens
  - prototype: 90 front-loaded, 13.3k on-demand tokens
  - migrate: 65 front-loaded, 5.4k on-demand tokens

Total: 329 front-loaded, 43.7k on-demand tokens

✔ Tile adobe/stardust@0.7.1 is valid

✅ All 2 tile(s) lint passed with 8 warning(s) total.

Updated by tessl-lint for commit ab099f2.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Regenerates all per-skill CHANGELOG.md files so each changelog only includes commits that touched that specific skill directory (path-filtered history), and adds a one-off script to reproduce the regeneration if needed.

Changes:

  • Added scripts/regenerate-changelogs.cjs to rebuild all skill changelogs using git log -- <skill-dir>.
  • Rewrote all affected skill CHANGELOG.md files to remove unrelated repo-wide commits and retain only path-relevant entries.
  • Normalized/trimmed many release sections that are now empty after filtering (matching the release-notes generation behavior described in the PR).

Reviewed changes

Copilot reviewed 26 out of 26 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
scripts/regenerate-changelogs.cjs Adds a manual script to regenerate all skill changelogs using path-filtered git history.
plugins/aem/project-management/skills/admin/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/project-management/skills/auth/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/project-management/skills/authoring/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/project-management/skills/development/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/project-management/skills/handover/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/project-management/skills/whitepaper/CHANGELOG.md Removes unrelated commits; leaves only path-relevant content for this skill.
plugins/aem/edge-delivery-services/skills/analyze-and-plan/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/authoring-analysis/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/block-collection-and-party/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/block-inventory/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/building-blocks/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/code-review/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/content-driven-development/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/content-modeling/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/create-site/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/da-auth/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/docs-search/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/find-test-content/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/generate-import-html/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/identify-page-structure/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/page-decomposition/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/page-import/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/preview-import/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/scrape-webpage/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.
plugins/aem/edge-delivery-services/skills/testing-blocks/CHANGELOG.md Removes unrelated commits; retains only commits affecting this skill’s directory.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +94 to +99
"find",
["plugins", "-name", "CHANGELOG.md"],
{ cwd: ROOT, encoding: "utf8" }
)
.trim()
.split("\n")
? `# [${version}](${REPO_URL}/compare/${prev}...${tag}) (${date})\n\n`
: `# ${version} (${date})\n\n`;

if (breaking.length) {
@trieloff trieloff merged commit bca6437 into main May 21, 2026
10 checks passed
@trieloff trieloff deleted the chore/clean-up-changelogs branch May 21, 2026 16:00
trieloff added a commit that referenced this pull request May 21, 2026
…doff CHANGELOG (#144)

PR #139 wrapped commit-analyzer with path filtering but tried to fix
release-notes-generator with gitRawCommitsOpts: { path: '.' } -- a
no-op because the plugin reads context.commits from semantic-release,
never gitRawCommitsOpts. Result: every skill release body and CHANGELOG
included commits from the entire repo (see slicc-handoff-v1.0.0).

- Add scripts/path-filtered-notes-generator.cjs mirroring the analyzer
  wrapper -- filters context.commits via git log -- . before delegating
  to the real plugin.
- Wire it into release.config.cjs in place of the bare plugin entry;
  drop the dead gitRawCommitsOpts config.
- Regenerate plugins/aem/edge-delivery-services/skills/slicc-handoff/
  CHANGELOG.md (skipped by PR #140 because the tag did not exist yet).
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.1.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.1.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 2.0.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants