Merge pull request #219 from contentstack/feat/externl-migrate-plugin

Introduced a new plugin - contentstack/cli-external-migrate

Author: netrajpatel

.github/workflows/release-production-plugins.yml

@@ -191,6 +191,14 @@ jobs:
           package: ./packages/contentstack-cli-tsgen/package.json
           tag: latest
 
+      # External Migrate
+      - name: Publishing external-migrate (Production)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-external-migrate/package.json
+          tag: latest
+
       - name: Create Production Release
         id: create_release
         env:

.talismanrc

@@ -1,6 +1,4 @@
 fileignoreconfig:
-  - filename: packages/contentstack-import/src/import/modules/webhooks.ts
-    checksum: 8c9527f966fe24debfb36d96a280ac3b2dd6494a58128380c69d7475e595436d
-  - filename: packages/contentstack-import/test/unit/import/modules/webhooks.test.ts
-    checksum: 3924a3e38211b8554f25365fe3100cb83361d03370fdaa77e5c7f9e74abafcee
+  - filename: pnpm-lock.yaml
+    checksum: 07642e8dd04d580185a459e5b088d8a1bb4e91be4e04f4842bf4fe4775205bf6
 version: '1.0'

packages/contentstack-apps-cli/src/util/common-utils.ts

@@ -120,7 +120,7 @@ function fetchAppInstallations(
   flags: FlagInput,
   orgUid: string,
   options: MarketPlaceOptions
-) {
+): Promise<any> {
   const { marketplaceSdk } = options;
   const app: any = flags["app-uid"];
   return marketplaceSdk
@@ -218,7 +218,7 @@ function uninstallApp(
   orgUid: string,
   options: MarketPlaceOptions,
   installationUid: string
-) {
+): Promise<any> {
   const { marketplaceSdk } = options;
   // const app: any = flags["app-uid"];
   return marketplaceSdk

packages/contentstack-audit/README.md

@@ -19,7 +19,7 @@ $ npm install -g @contentstack/cli-audit
 $ csdx COMMAND
 running command...
 $ csdx (--version|-v)
-@contentstack/cli-audit/1.19.3 darwin-arm64 node-v24.14.0
+@contentstack/cli-audit/1.19.4 darwin-arm64 node-v24.14.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

packages/contentstack-branches/README.md

@@ -37,7 +37,7 @@ $ npm install -g @contentstack/cli-cm-branches
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-cm-branches/1.8.1 darwin-arm64 node-v24.14.0
+@contentstack/cli-cm-branches/1.8.2 darwin-arm64 node-v24.14.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

packages/contentstack-bulk-publish/README.md

@@ -18,7 +18,7 @@ $ npm install -g @contentstack/cli-cm-bulk-publish
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-cm-bulk-publish/1.11.3 darwin-arm64 node-v24.14.0
+@contentstack/cli-cm-bulk-publish/1.12.0 darwin-arm64 node-v24.14.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

packages/contentstack-export/README.md

@@ -48,7 +48,7 @@ $ npm install -g @contentstack/cli-cm-export
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-cm-export/1.25.0 darwin-arm64 node-v24.14.0
+@contentstack/cli-cm-export/1.25.1 darwin-arm64 node-v24.14.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

packages/contentstack-external-migrate/.eslintrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint'],
+  extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended'],
+  rules: {
+    'unicorn/prefer-module': 'off',
+    'unicorn/no-abusive-eslint-disable': 'off',
+    '@typescript-eslint/no-use-before-define': 'off',
+    'node/no-missing-import': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-require-imports': 'off',
+    'no-useless-escape': 'off',
+  },
+};

packages/contentstack-external-migrate/.gitignore

@@ -0,0 +1,27 @@
+node_modules/
+/lib/
+oclif.manifest.json
+*.log
+.DS_Store
+coverage/
+
+# Local migration outputs (may contain customer content)
+migration-workspace/
+contentstack-import/
+audit-reports/
+audit-fix/
+audit-verify/
+export.json
+contentfulMigrationData/
+_backup_*/
+migration-manifest.json
+
+# Import/audit session logs (local artifacts, may contain customer content)
+logs/
+session.json
+
+# Internal scratch docs — never commit (PR drafts / status notes)
+pr.md
+achieve.md
+out/
+.vscode/

packages/contentstack-external-migrate/AGENTS.md

@@ -0,0 +1,43 @@
+# Agent guide — Contentstack Migrate plugin
+
+Use this file when automating work in `cli-plugin-migrate/`.
+
+## What this repo is
+
+- **Package:** `@contentstack/cli-plugin-migrate`
+- **Commands:** `csdx migrate:export|convert|audit|import|status`
+- **Scope:** Contentful → Contentstack migration (expert CLI, no bundled AI)
+
+## User-facing docs (read first)
+
+| Doc | Use when |
+|-----|----------|
+| [README.md](./README.md) | Install, commands, troubleshooting |
+| [docs/getting-started.md](./docs/getting-started.md) | Onboarding colleagues |
+| [docs/expert-workflow.md](./docs/expert-workflow.md) | End-to-end pipeline |
+| [docs/limitations-and-scope.md](./docs/limitations-and-scope.md) | What is / isn't supported |
+
+## Maintainer docs
+
+| Doc | Use when |
+|-----|----------|
+| [docs/architecture.md](./docs/architecture.md) | Package layout, adapters |
+| [docs/implementation-principles.md](./docs/implementation-principles.md) | Port vs PRD flags, spawn rules |
+| [docs/phases/](./docs/phases/) | Per-command implementation specs |
+
+## Rules for changes
+
+1. **Do not** add `--stack` to `migrate:convert` — import stays on `migrate:import`.
+2. **Audit/import** → shell out via `src/lib/csdx-spawn.ts`, do not reimplement CMA.
+3. **Export** → `src/lib/contentful-cli-spawn.ts` (global `contentful` or `npx -y contentful-cli`).
+4. **Never log** management tokens or full stack API keys.
+5. **Manifest** updates on successful command completion — see `src/lib/manifest.ts`.
+6. Match flag names in [README.md](./README.md) and phase docs, not the old reference Commander CLI.
+
+## Verify
+
+```bash
+npm run build && npm test
+```
+
+Reference port source (optional, parent monorepo): `../references/import-contentful-cli-main/`.