{"_id":"@adobe-thillai/aio-cli-plugin-ccua","_rev":"7-f51ec7e6793aea6a7baf550baeac41f4","name":"@adobe-thillai/aio-cli-plugin-ccua","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"1.0.0","keywords":["claude-code","claude","anthropic","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools","mcp","aio-cli-plugin"],"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@1.0.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"8ec35d00f752540c36369476cf3b8166dd34c10a","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-1.0.0.tgz","fileCount":56,"integrity":"sha512-/uj9DoHOTj8Gh/0V+SrZan5d4qZ4tcAmzngEQ7AHWpoNacnvA6nFRKpx1LB3PksCJ96a/lKW5ALT4hHqLpcl2Q==","signatures":[{"sig":"MEUCIBnuw1VdpyqY3fe30EYmXKfsDa3+l/4+W5+33vA48cbcAiEAyq9ykP0NKw5odK+L7ZxHQCqRt3SIS2YKQExlsrLUYis=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":266905},"main":"src/index.js","oclif":{"bin":"aio","topics":{"ccua":{"description":"CCUA — Adobe Commerce Upgrade Toolkit setup"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"0dd272ab8ce360afec2f881688d21ceb8d208b7e","scripts":{"build":"aio app build","start":"aio app dev","bridge":"node setup-server.js","deploy":"aio app deploy","prepack":"oclif manifest","postpack":"rm -f oclif.manifest.json","undeploy":"aio app undeploy","bridge:stop":"lsof -ti :3131 2>/dev/null | xargs kill -9 2>/dev/null; true","setup:project":"node scripts/setup-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"react":"^18.0.0","fs-extra":"^11.2.0","react-dom":"^18.0.0","@oclif/core":"^3.26.0","@adobe/aio-sdk":"^6.0.0","@adobe/react-spectrum":"^3.0.0","@spectrum-icons/workflow":"^4.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"oclif":"^4.0.0"},"peerDependencies":{"@adobe/aio-lib-ims":">=3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_1.0.0_1784625641975_0.49346938428971865","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"1.0.1","keywords":["claude-code","claude","anthropic","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@1.0.1","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"d7c13dbc3a7a5974d406a59cb0d2a98a54f6468b","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-1.0.1.tgz","fileCount":45,"integrity":"sha512-o/AOs9lNfmoF9zJvD6/oiljyqnk/I68NFhI7Dz1NkVAEtoeztH9auxXNrS8FwSz2A7r1fP77Jlf3/MyiHWuibA==","signatures":[{"sig":"MEUCIAhUveT+ere3tUKDVNq8qM5AS5IvcpbaixaYqyVoztRFAiEA41H8HAvE7Er8dNDhXpc/LJHUpzRRn2r1yQIuZc4SGEA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":245818},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"7466d0ba69cd23e67868dcaa49a6145e440ccea2","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_1.0.1_1785679056453_0.33174902040064125","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"1.1.0","keywords":["claude-code","claude","anthropic","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@1.1.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"d04e07b89d8941e614d12144b0a1cad0b6b68bfb","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-1.1.0.tgz","fileCount":46,"integrity":"sha512-PSYzj0JYbjtTPRIO/V2gh7F5v/BtZd8UXJqgbluUm+04yMKFLxAnvSt4qZ2ULci3XDasjTHJV8370z3Fh0Ly0Q==","signatures":[{"sig":"MEYCIQDWq5dOmPM44ek96ODHxkmXpo5GX/b9D9skUlQCCQy2SwIhAO8dyETCU270j8gwbIj+WypYuLoZn+1BcyDOosKs7v+L","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":257149},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"60087ef012d1fc188fbcc728920d79f779e27e77","scripts":{"setup:project":"node scripts/setup-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_1.1.0_1785833730563_0.04631563532276606","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"1.2.0","keywords":["claude-code","claude","anthropic","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@1.2.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"3eee8eaf955c691d48dfc60b5dc1e575f69b3e07","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-1.2.0.tgz","fileCount":62,"integrity":"sha512-0DVy6LoLxHMT6v90udIMlcI8wqBxhcAzP5Pc4wcFIVnU0PBkN+88Kaa0tMcHfJnUn99cupBfEZ4Rc3NzXGMs5w==","signatures":[{"sig":"MEYCIQCAQ7sUrExqrrMLUnrDXU4pn7geiA0kQ4PP/cl4AVC4KwIhAK0eoL0ettKzbXObrP7YQ91g9kWx2eaCU3L1riiTgzaf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEQmOJLuxvdvv4e3cHVMrVb61vNRxbNlHPk6fiHT3EoeAiBqqGRccN8hJhMfKsJFGdLis2GOzltLxgT2b0FFUyLX2g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":348787},"oclif":{"bin":"aio","topics":{"ccua":{"description":"Adobe Commerce Upgrade Toolkit — install and update Claude Code upgrade workflows in a Commerce project"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"4900c2b93b9ad42ea98b57d308358373538f18fe","scripts":{"setup:project":"node scripts/setup-project.mjs","update:project":"node scripts/update-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project .","update:project:self":"node scripts/update-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_1.2.0_1787306469050_0.3524991538073359","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"1.2.1","keywords":["claude-code","claude","anthropic","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@1.2.1","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"7764ebc5d5bd7808205b13686618b4cd7d72e16c","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-1.2.1.tgz","fileCount":62,"integrity":"sha512-nzsM4w0RNRlhAfzn8xcZYRN/D2e3yevVUdWMmq07Yq9Y+vr6+2XayXbWTdeZqYF6b3sIDp7DAH6PGOKuGo/h1g==","signatures":[{"sig":"MEUCIQDeP0zBeS24fUdVoM3GWThev2SXU5tAhR7JosDVzSCClgIgWoXkz3WwV+o4af1yWUWWK2tVH2iuMDP0+hQ1XCzhsdU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIDhtlpM2QT8D4tFGP8hwOlsM4vZugq7u50HrFfU2/DXYAiBdgjkQc9IXOAvUoLx/2kOAAcu0QWofNv/mXaQE8oBteA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":348787},"oclif":{"bin":"aio","topics":{"ccua":{"description":"Adobe Commerce Upgrade Toolkit — install and update Claude Code upgrade workflows in a Commerce project"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"4900c2b93b9ad42ea98b57d308358373538f18fe","scripts":{"setup:project":"node scripts/setup-project.mjs","update:project":"node scripts/update-project.mjs","setup:project:self":"node scripts/setup-project.mjs --project .","update:project:self":"node scripts/update-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_1.2.1_1787307001932_0.7140799294407454","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@adobe-thillai/aio-cli-plugin-ccua","version":"2.0.0","keywords":["claude-code","claude","anthropic","github-copilot","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"author":{"name":"Thillai Prabu"},"license":"MIT","_id":"@adobe-thillai/aio-cli-plugin-ccua@2.0.0","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"homepage":"https://github.com/OneAdobe/project-ccua#readme","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"6a7753cde5165113faaafa1ef60767cc3425cd48","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-2.0.0.tgz","fileCount":114,"integrity":"sha512-szJ0K5Iz/FCNNE9QA5IphaCV1RjBeUF8YY1cQHgn5zBbMh8w4F0RQ4zvf6H0ZNjnEBalAJn7zvFkbyJ82+yNnQ==","signatures":[{"sig":"MEUCIEyEbm0YEHSXHKoOVe5DOIBKlj1McfT2iwIag1RYJR9QAiEAj4Z/uVEYTE+o+A61XJhUJzDfEFIR6NRcYtRtPJ/5iqM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHCMLQ+mCupRl2JOE+X3YEcELXnapvxqEzI3HnRC/U4nAiBQaCYxemfCY73a1IJA/hHSfKJo1osQEOjql0a9JbC4Xg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":734706},"oclif":{"bin":"aio","topics":{"ccua":{"description":"Adobe Commerce Upgrade Toolkit — install and update Claude Code or GitHub Copilot upgrade workflows in a Commerce project"},"ccua agent":{"description":"Choose and install the agent toolkit flavour (Claude Code or GitHub Copilot)"}},"commands":"./src/commands"},"engines":{"node":">=18.0.0"},"gitHead":"bfb0b62869608fadff30450d74abf25cab13efe9","scripts":{"test":"node --test","setup:project":"node scripts/setup-project.mjs","update:project":"node scripts/update-project.mjs","generate:github":"node scripts/generate-github-assets.mjs","setup:project:self":"node scripts/setup-project.mjs --project .","update:project:self":"node scripts/update-project.mjs --project ."},"_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code or GitHub Copilot commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aio-cli-plugin-ccua_2.0.0_1790756113186_0.7938567416958862","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"_id":"@adobe-thillai/aio-cli-plugin-ccua@2.0.1","bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"dist":{"shasum":"7868a127457d0cbcb18406fc8c40f54881f93c13","tarball":"https://registry.npmjs.org/@adobe-thillai/aio-cli-plugin-ccua/-/aio-cli-plugin-ccua-2.0.1.tgz","fileCount":114,"integrity":"sha512-dboydYY4NdRcS4VGqG/HwBpFg+hXl3w3cWJ25+Lj8Leh1imx+2w66BVARXVklIMS58z84IYh9u6tqWoW//RRGw==","signatures":[{"sig":"MEYCIQCmcMlTNF3VcCmY34pKZvxIMeO+uMcF4Bblz5NUWW0FeAIhAPkYMf4831Ubap2csex4OkNTLMcIXlzsjNC3h4YLtyDy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEzGAbO9K0bYbK53HwZObtkA/w65MV5YLYUPTH2bRq87AiEA1Hpf+nzNaslMOeLWL2dNyrfxrAWa5SBtlTOp+Ts3ozI="}],"unpackedSize":734730},"name":"@adobe-thillai/aio-cli-plugin-ccua","oclif":{"bin":"aio","topics":{"ccua":{"description":"Adobe Commerce Upgrade Toolkit — install and update Claude Code or GitHub Copilot upgrade workflows in a Commerce project"},"ccua agent":{"description":"Choose and install the agent toolkit flavour (Claude Code or GitHub Copilot)"}},"commands":"./src/commands"},"author":{"name":"Thillai Prabu"},"engines":{"node":">=18.0.0"},"gitHead":"50bb5de6145c4dc840248326c879288784409e30","license":"MIT","scripts":{"test":"node --test","setup:project":"node scripts/setup-project.mjs","update:project":"node scripts/update-project.mjs","generate:github":"node scripts/generate-github-assets.mjs","setup:project:self":"node scripts/setup-project.mjs --project .","update:project:self":"node scripts/update-project.mjs --project ."},"version":"2.0.1","_npmUser":{"name":"trajendran","email":"trajendran@adobe.com"},"homepage":"https://github.com/OneAdobe/project-ccua#readme","keywords":["claude-code","claude","anthropic","github-copilot","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"_npmVersion":"10.9.2","description":"Claude Code or GitHub Copilot commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","directories":{},"maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"_nodeVersion":"22.14.0","dependencies":{"fs-extra":"^11.2.0","@oclif/core":"^3.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aio-cli-plugin-ccua_2.0.1_1790762136474_0.6787147098897914"}}},"time":{"created":"2026-07-21T09:20:41.739Z","modified":"2026-09-30T09:55:36.825Z","1.0.0":"2026-07-21T09:20:42.136Z","1.0.1":"2026-08-02T13:57:36.608Z","1.1.0":"2026-08-04T08:55:30.717Z","1.2.0":"2026-08-21T10:01:09.157Z","1.2.1":"2026-08-21T10:10:02.024Z","2.0.0":"2026-09-30T08:15:13.294Z","2.0.1":"2026-09-30T09:55:36.556Z"},"bugs":{"url":"https://github.com/OneAdobe/project-ccua/issues"},"author":{"name":"Thillai Prabu"},"license":"MIT","homepage":"https://github.com/OneAdobe/project-ccua#readme","keywords":["claude-code","claude","anthropic","github-copilot","adobe-commerce","magento","magento2","commerce-upgrade","uct","ai-tools"],"repository":{"url":"git+ssh://git@github.com/OneAdobe/project-ccua.git","type":"git"},"description":"Claude Code or GitHub Copilot commands, agents, and skills for Adobe Commerce / Magento 2 version-upgrade work — hop planning, UCT scanning, chunked remediation, and deploy prep.","maintainers":[{"name":"trajendran","email":"trajendran@adobe.com"}],"readme":"# Adobe Commerce Upgrade Toolkit\n\nAn AI-powered upgrade specialist for Adobe Commerce / Magento 2, available for either\n**Claude Code** or **GitHub Copilot**. It plans multi-hop version upgrades, runs and\ninterprets the Upgrade Compatibility Tool (UCT), classifies and sequences breaking-change\nremediation, and gates deploy-readiness — so a version bump reads like a checklist instead\nof a research project.\n\nBoth flavours are generated from the same source of truth: everything under `.claude/` is\ncanonical, and `scripts/generate-github-assets.mjs` derives the matching `.github/` tree\nfor Copilot (agents → `.github/agents/*.agent.md`, skills → `.github/skills/<name>/SKILL.md`,\nguardrails → `.github/instructions/*.instructions.md`, `CLAUDE.md` →\n`.github/copilot-instructions.md`). A project gets one flavour or the other — pick with\n`--agent` on setup, or run `aio ccua:agent:select` for an interactive prompt.\n\n**Base setup** (`aio ccua:setup` or `aio ccua:agent:select`) drops a set of commands\n(or skills, for Copilot), specialist agents, skills, and configuration into your\nCommerce project, and automatically installs and wires up **CodeGraph** — a local\nknowledge graph of your codebase, so the agent can jump straight to the relevant\nsymbols and call paths for each UCT finding instead of grepping around. CodeGraph is\nmandatory for both flavours: the toolkit's core workflow (CodeGraph-first analysis of\nevery UCT finding) depends on it, so there's no opt-out. If the install or index build\nfails partway (e.g. offline `npm install`), re-run `aio ccua:setup` — it re-checks and\nrepairs the CodeGraph install/index without touching anything else already in place.\n\nRelease-note and breaking-change lookups use `WebSearch`/`WebFetch` directly, scoped to\nAdobe's own documentation domains — no MCP server is involved.\n\nExtracted from [commerce-compass](https://github.com/OneAdobe) as a standalone tool, so\nupgrade workflows can be installed, versioned, and developed independently of general\nCommerce module-development tooling.\n\n## Prerequisites\n\n```bash\nnode >= 18\n```\n\n- [Claude Code](https://claude.com/claude-code) CLI (`claude`) — or VS Code with GitHub\n  Copilot Chat enabled, if installing the `github-copilot` flavour\n- An existing Adobe Commerce / Magento 2 project (with `composer.json`)\n\n## Setup\n\n```bash\naio plugins:install @adobe-thillai/aio-cli-plugin-ccua\ncd /path/to/commerce/project\naio ccua:setup                          # Claude Code (default)\naio ccua:setup --agent github-copilot   # GitHub Copilot\n# — or, for an interactive prompt instead of --agent —\naio ccua:agent:select\n```\n\nFor Claude Code, this copies `.claude/commands`, `.claude/agents`, `.claude/skills`,\n`.claude/guardrails`, `.claude/prompts`, `.claude/context`, `CLAUDE.md`, and\n`docs/upgrade-workflow.md` into the target project. For GitHub Copilot, the equivalent\n`.github/agents`, `.github/skills`, `.github/instructions`, `.github/context`,\n`.github/copilot-instructions.md`, and `.github/copilot-settings-notes.md` (documenting\nthe handful of Claude-only settings — Bash permission allow/deny, the SessionStart hook —\nthat Copilot has no repo-level way to enforce). Either way, setup also seeds required\nCLI/cloud configuration (`upgrade-state.md` install type and environment, the version\nmarker used by `aio ccua:update`, `.gitignore` entries), and installs and wires up\n**CodeGraph** (mandatory — no opt-out) into `.mcp.json` (Claude Code) or `.vscode/mcp.json`\n(GitHub Copilot).\n\nKeep the toolkit current with:\n\n```bash\naio ccua:update\n```\n\n## Usage\n\n```bash\ncd /path/to/commerce/project\nclaude\n```\n\nThen:\n\n1. `/upgrade-hop` — detect current/target Commerce versions, generate a multi-hop roadmap.\n2. `/upgrade-hop <version>` — run the UCT scan for a hop and categorise findings.\n3. `/upgrade-hop-execute <version>` — implement fixes for that hop, chunk by chunk, with\n   DI-compile/PHPCS/PHPUnit validation after each.\n4. `/upgrade-deploy-prep` — deploy-readiness gate once all hops are complete.\n\nSee `docs/upgrade-workflow.md` for the full workflow diagram and `CLAUDE.md` for the\ncomplete behavior contract (scope, skills reference, quality gates).\n\n## What's included\n\n- **Commands:** `upgrade-hop`, `upgrade-hop-execute`, `upgrade-deploy-prep`\n- **Agents:** `commerce-upgrade-analyst` (primary driver) plus supporting specialists\n  (`commerce-architect`, `commerce-devops-engineer`, `commerce-qa-engineer`,\n  `commerce-frontend-developer`, `commerce-security-reviewer`)\n- **Skills:** UCT scanning, breaking-change analysis, remediation ordering, marketplace\n  extension compatibility, data migration planning, encryption/password rotation, ECE-tools\n  config, PCI checklist, environment detection, and more — see `CLAUDE.md` §13.\n\n## Local development / testing this plugin\n\nTo try the plugin itself (not just the toolkit it installs) without publishing to npm:\n\n```bash\ngit clone <this-repo>\ncd project-ccua\nnpm ci                 # installs @oclif/core, fs-extra\nnpm test                # runs the automated test suite (node --test)\n```\n\nRun the commands straight from the checkout, against a scratch project directory (don't\npoint `--project` at a real Commerce project until you're happy with the result):\n\n```bash\nmkdir -p /tmp/ccua-manual-test\n\n# Base setup (also installs and wires CodeGraph, the mandatory MCP)\nnode scripts/setup-project.mjs --project /tmp/ccua-manual-test\n```\n\nTo exercise the actual `aio ccua:*` commands (the oclif layer) instead of the scripts\ndirectly, link the plugin into a local `aio-cli` install:\n\n```bash\nnpm install -g @adobe/aio-cli   # if you don't have it already\naio plugins:link .              # from this repo's root — links the checkout as a plugin\ncd /tmp/ccua-manual-test\naio ccua:setup\naio ccua:update\naio plugins:uninstall @adobe-thillai/aio-cli-plugin-ccua   # unlink when done\n```\n\nWhat to check when testing manually:\n- `aio ccua:setup` copies `.claude/*`, `CLAUDE.md`, `docs/upgrade-workflow.md` into the\n  target project, and creates `.mcp.json` with a `codegraph` entry.\n- Re-running `aio ccua:setup` on an already-set-up project doesn't clobber\n  `.mcp.json`/`CLAUDE.md`/`.claude/settings.json` (no-overwrite files) but does refresh\n  commands/agents/skills.\n\n## Known gaps\n\nSeveral files still referenced skills or slash commands that don't exist in this toolkit —\ncarried over from the source repo this was extracted from, never re-authored down to the\ncurrent 3-command scope. Fixed where a self-contained replacement was straightforward; one\nremains genuinely open:\n\n- `no-git-operations` skill (`upgrade-hop.md`/`upgrade-hop-execute.md`) — **still open**.\n  Until it's written, the constraint (no `git` operations from dispatched sub-agents during\n  a hop) is applied literally per `CLAUDE.md`.\n- `/deploy-check` (`commerce-devops-engineer.md`, `deployment-safety.md`,\n  `upgrade-deploy-prep.md`) — **fixed**: `upgrade-deploy-prep.md`'s pre-deploy checks are now\n  self-contained; the other two references point at its Step 2 instead.\n- `/upgrade-extension-check` (`marketplace-extension-analysis.md`, `websearch-scope.md`) —\n  **fixed**: repointed to `commerce-upgrade-analyst`'s Phase 2 Analyse.\n- `/upgrade-watch` (`upgrade-hop-report.md`) — **fixed**: removed the report tab it fed,\n  which had no underlying data source and would always render empty.\n- `/upgrade-approve-hop` / `/upgrade-report` (`data-migration-plan.md`,\n  `commerce-frontend-developer.md`) — **fixed**: repointed at `/upgrade-hop-execute`'s Step 6\n  and `/upgrade-deploy-prep` respectively.\n- `db-schema-validation` \"in the architecture repo\" (`data-patches.md`) — **fixed**:\n  repointed at `/upgrade-hop-execute`'s own Chunk 2.\n","readmeFilename":"README.md"}