Skip to content

Add POM cleanup step to SCR→DS migration skill - #11

Open
bharat941 wants to merge 31 commits into
betafrom
pom-cleanup-dependencies
Open

Add POM cleanup step to SCR→DS migration skill#11
bharat941 wants to merge 31 commits into
betafrom
pom-cleanup-dependencies

Conversation

@bharat941

@bharat941 bharat941 commented Apr 1, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds a Step 0: POM cleanup to the SCR→DS migration skill (scr-to-osgi-ds.md) that removes the maven-scr-plugin and deprecated Felix SCR dependencies from pom.xml alongside Java source migrations.
  • Scopes POM cleanup strictly to only the dependencies whose APIs were actually migrated (e.g. felix.scr.annotations, bndlib). Does not remove unrelated deps like org.osgi.core/org.osgi.compendium and does not add new dependencies proactively.
  • Updates validation checklists across all pattern modules (scheduler, replication, event-listener, resource-change-listener) to include POM-level checks.

Test plan

  • Run the skill against aem-guides-wknd-legacy — verify only SCR-related deps are removed from POMs
  • Confirm mvn clean compile passes after migration
  • Verify org.osgi.core / org.osgi.compendium are left untouched if not directly migrated
  • Verify no new dependencies are added proactively

Himani Chauhan and others added 30 commits March 12, 2026 14:47
Remove asset-manager and event-migration reference files that are no longer needed:
- asset-manager.md, asset-manager-create.md, asset-manager-delete.md
- event-migration-path-a.md, event-migration-path-b.md

Keeping core migration patterns: scheduler, replication, resource-change-listener, event-migration
Expand AEM Cloud Service migration skill with additional patterns:
- Asset Manager: create/upload (Direct Binary Access) + delete (HTTP Assets API)
- Event Migration: JCR EventListener → EventHandler + JobConsumer (Path A & B)

New reference files:
- asset-manager.md, asset-manager-create.md, asset-manager-delete.md
- event-migration-path-a.md, event-migration-path-b.md

Made-with: Cursor
feat(aem): add asset-manager and event-migration patterns
…sistencies

- Rewrite BPA section to use agent-native instructions instead of JavaScript helper scripts
- Remove references to ./scripts/bpa-findings-helper.js and ./unified-collections/
- Fix Step 4 path references to use relative paths (references/ instead of .cursor/skills/...)
- Update Available Patterns table to use correct references/ directory name
- Remove CLI Testing section that referenced nonexistent scripts
- Simplify Quick Reference to match new BPA flow without collection caching
Add list-projects API contract and enforce always presenting project
list to the user for confirmation before calling fetch-cam-bpa-findings,
even when only one project exists. Includes updated example agent flow.
Add detailed transformation references for scheduler, event-migration,
replication, resource-change-listener, and asset-manager patterns
including path classification, step-by-step instructions, and validation.
When fetch-cam-bpa-findings returns success: false, the skill now stops
immediately and reports the error to the user. It no longer falls back
to Manual Flow or CSV.

Made-with: Cursor
Keep STOP ON MCP ERROR rule: when fetch-cam-bpa-findings returns
success: false, stop immediately. Integrate with beta's source priority
and list-projects flow.

Made-with: Cursor
fix: stop on MCP error instead of falling back to Manual Flow
Replace code-migration with aem-cloud-service-best-practices (pattern refs, scr-to-osgi-ds, resource-resolver-logging) and migration/ (orchestration + scripts). Update marketplace and README.
Migration: cam-mcp reference, path alias, quick start, dual-plugin install notes, description tweaks. Best-practices: JCR observation vs OSGi EventHandler wording, prerequisites phrasing. Remove sibling terminology; plugin.json copy; safe CAM example id.
Add capability for local bpa csv file
Keep removal of code-migration/aem-migration; migration is under migration/aem-cloud-service-migration.
Relocate the Cloud Service pattern package to skills/aem/cloud-service/skills/best-practices/ with SKILL.md and references/ at the plugin root (plugin id aem-best-practices). Move migration content out of the nested aem-cloud-service-migration folder into migration/ (plugin id aem-migration).

Register aem-best-practices, aem-migration, aem-cloud-service-dispatcher, and aem-6-5-lts-dispatcher in .claude-plugin/marketplace.json. Update the repository README with install commands and the revised directory layout.

Migration and CAM docs require explicit CAM project confirmation, verbatim MCP errors with no automatic fallback, and IDE workspace-scoped file discovery. Docs use aem-prefixed plugin names without extra marketplace commentary.
…nsolidation

Aem cloud best practices skill consolidation
…nsolidation

docs(migration): document CAM MCP enablement restriction verbatim errors
- Root npm test: skills-ref validate, migration unit tests, marketplace JSON parse
- CI validate workflow runs npm test
- SKILL frontmatter name must match folder (best-practices, migration) per skills-ref
- Fixture CSV + node:test coverage for getBpaFindings and checkAvailableSources
…ranch

Remove references/osgi-cfg-json-cloud-manager.md and all SKILL.md wiring
(quick start, delegation, when-to-use). Keeps CAM/MCP tightening,
workspace scope, and MCP error handling from refactoring.
Tighter fallback rules and error handling
When migrating Felix SCR to OSGi DS, the agent now also removes
deprecated dependencies and plugins from pom.xml in the same change set.

Adds Step 0 to scr-to-osgi-ds.md with concrete instructions to remove
maven-scr-plugin, Felix SCR deps, legacy bndlib, and monolithic OSGi
compendium JARs. Propagates POM checklist items to all pattern module
validation checklists (scheduler, event-migration, replication,
resource-change-listener). Adds CLEAN THE POM critical rule to SKILL.md.

Made-with: Cursor
Remove instructions to delete org.osgi.core/compendium and to add new
DS annotation dependencies. The skill should only remove POM deps for
the exact APIs it migrated away from — nothing more, nothing less.

Made-with: Cursor
Require rg search confirming zero remaining imports before any
Felix SCR / bndlib POM dependency or plugin is removed.

Made-with: Cursor
bharat941 pushed a commit that referenced this pull request Apr 7, 2026
chore(deps): update actions/setup-node action to v6
@Himanich
Himanich self-requested a review as a code owner April 16, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants