Merge pull request #170 from contentstack/feat/migrate-external-cli-plugins-v2

Feat/migrate external cli plugins v2

Author: cs-raj

.cursor/rules/dev-workflow.md

@@ -9,7 +9,8 @@ alwaysApply: true
 ## Monorepo Structure
 
 ### Package Organization
-- **11 plugin packages** under `packages/`
+- **12+ plugin packages** under `packages/`
+- `contentstack-cli-cm-regex-validate` - Regex validation for Content Type/Global Field fields (`cm:stacks:validate-regex`; npm `@contentstack/cli-cm-regex-validate`; Jest tests)
 - **pnpm workspaces** with `workspaces: ["packages/*"]`
 - **Shared dependencies**: `@contentstack/cli-command`, `@contentstack/cli-utilities`
 - **Build artifacts**: `lib/` directory (compiled from `src/`)

.github/config/release.json

@@ -9,6 +9,12 @@
     "migration": false,
     "seed": false,
     "bootstrap": false,
-    "branches": false
+    "branches": false,
+    "apps-cli": false,
+    "tsgen": false,
+    "content-type": false,
+    "regex-validate": false,
+    "migrate-rte": false,
+    "bulk-operations": false
   }
 }

.github/workflows/release-v2-beta-plugins.yml

@@ -142,3 +142,53 @@ jobs:
           token: ${{ secrets.NPM_TOKEN }}
           package: ./packages/contentstack-query-export/package.json
           tag: beta
+
+      # Content Type
+      - name: Publishing content-type (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-content-type/package.json
+          tag: beta
+
+      # Apps CLI
+      - name: Publishing apps-cli (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-apps-cli/package.json
+          tag: beta
+
+      # Tsgen
+      - name: Publishing tsgen (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-cli-tsgen/package.json
+          tag: beta
+      # Regex Validate
+      - name: Publishing regex-validate (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-cli-cm-regex-validate/package.json
+          access: public
+          tag: beta
+
+      # Migrate RTE
+      - name: Publishing migrate-rte (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-migrate-rte/package.json
+          access: public
+          tag: beta
+
+      # Bulk Operations
+      - name: Publishing bulk-operations (Beta)
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          package: ./packages/contentstack-bulk-operations/package.json
+          access: public
+          tag: beta

.github/workflows/tsgen-integration-test.yml

@@ -0,0 +1,52 @@
+name: Tsgen Integration Tests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  tsgen-integration:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.28.0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build tsgen plugin
+        run: pnpm --filter contentstack-cli-tsgen run build
+
+      - name: Install Contentstack CLI (v2 beta)
+        run: npm i -g @contentstack/cli@beta
+
+      - name: Configure CLI region
+        run: csdx config:set:region ${{ secrets.REGION }}
+
+      - name: Add delivery token
+        run: csdx auth:tokens:add -a ${{ secrets.TOKEN_ALIAS }} --delivery -k ${{ secrets.APIKEY }} --token ${{ secrets.DELIVERYKEY }} -e ${{ secrets.ENVIRONMENT }}
+
+      - name: Link tsgen plugin
+        working-directory: ./packages/contentstack-cli-tsgen
+        run: csdx plugins:link
+
+      - name: Run integration tests
+        run: pnpm --filter contentstack-cli-tsgen run test
+        env:
+          TOKEN_ALIAS: ${{ secrets.TOKEN_ALIAS }}
+
+      - name: Unlink tsgen plugin
+        working-directory: ./packages/contentstack-cli-tsgen
+        run: csdx plugins:unlink
+        if: always()

.github/workflows/unit-test.yml

@@ -66,3 +66,23 @@ jobs:
       - name: Run tests for Contentstack Query Export
         working-directory: ./packages/contentstack-query-export
         run: npm run test:unit
+
+      - name: Run tests for Contentstack Apps CLI
+        working-directory: ./packages/contentstack-apps-cli
+        run: npm run test:unit:report
+
+      - name: Run tests for Contentstack Content Type plugin
+        working-directory: ./packages/contentstack-content-type
+        run: npm run test:unit
+        
+      - name: Run tests for Contentstack Regex Validate plugin
+        working-directory: ./packages/contentstack-cli-cm-regex-validate
+        run: npm run test:unit
+        
+      - name: Run tests for Contentstack Migrate RTE
+        working-directory: ./packages/contentstack-migrate-rte
+        run: npm test
+
+      - name: Run tests for Contentstack Bulk Operations
+        working-directory: ./packages/contentstack-bulk-operations
+        run: npm test

.talismanrc

@@ -1,4 +1,8 @@
 fileignoreconfig:
-  - filename: pnpm-lock.yaml
-    checksum: 71b97a29a577e59d746967b4717acd013d624fd1cbf7d796647c9ef6d7652165
+- filename: packages/contentstack-bulk-operations/src/services/am-asset-service.ts
+  checksum: 5f6c0ecba74e27399a7079ca15e65e77ef692697093c9fb1d57213728c4fe985
+- filename: packages/contentstack-bulk-operations/src/utils/asset-uids-from-file.ts
+  checksum: 580932f192dd3fdd8bb2c55b7a7a78f1694f646ef5c5041f86c75668778f7ecb
+- filename: packages/contentstack-bulk-operations/test/unit/utils/asset-uids-from-file.test.ts
+  checksum: 8123f7a675a0275795b59b15d0f2d5f8f1e57ccbecf3f97249a0dc5a037b9203
 version: '1.0'

AGENTS.md

@@ -7,7 +7,7 @@
 | Field | Detail |
 | --- | --- |
 | **Name:** | Contentstack CLI plugins (pnpm monorepo; root package name `csdx`) |
-| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, seed, audit, variants, etc.). |
+| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, migrate RTE, bulk operations, seed, audit, variants, Developer Hub apps, TypeScript codegen, etc.). |
 | **Out of scope (if any):** | The **core** CLI aggregation lives in the separate `cli` monorepo; this repo ships plugin packages only. |
 
 ## Tech stack (at a glance)
@@ -35,11 +35,60 @@ CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml) and other
 | Skill | Path | What it covers |
 | --- | --- | --- |
 | Development workflow | [skills/dev-workflow/SKILL.md](skills/dev-workflow/SKILL.md) | pnpm commands, CI, TDD expectations, PR checklist |
-| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Plugin commands, OCLIF, Contentstack APIs |
-| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors |
+| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Plugin commands, OCLIF, Contentstack APIs (incl. `app:*` / `@contentstack/apps-cli`) |
+| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors (incl. Developer Hub SDK, manifests, GraphQL) |
 | Testing | [skills/testing/SKILL.md](skills/testing/SKILL.md) | Mocha/Chai, coverage, mocks |
 | Code review | [skills/code-review/SKILL.md](skills/code-review/SKILL.md) | PR review for this monorepo |
 
+## Apps CLI plugin (`@contentstack/apps-cli`)
+
+- **Package path:** [packages/contentstack-apps-cli](packages/contentstack-apps-cli)
+- **npm name:** `@contentstack/apps-cli` (unchanged for consumers)
+- **Migrated from:** [contentstack/contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) — see [APPS-CLI-MIGRATION.md](APPS-CLI-MIGRATION.md)
+- **v1 / v2:** Maintain on `v1-dev` (1.x CLI deps) and `v2-dev` / `v2-beta` (2.x beta deps) branches; align `@contentstack/cli-command` and `@contentstack/cli-utilities` versions with the target CLI line.
+- **Docs:** OCLIF / `app:*` commands → [contentstack-cli](skills/contentstack-cli/SKILL.md#apps-cli-commands-app); SDK, manifests, GraphQL, HTTP → [framework](skills/framework/SKILL.md#apps-cli-plugin-contentstackapps-cli)
+
+## Tsgen plugin (`contentstack-cli-tsgen`)
+
+- **Package path:** [packages/contentstack-cli-tsgen](packages/contentstack-cli-tsgen)
+- **npm name:** `contentstack-cli-tsgen` (unchanged for consumers)
+- **Migrated from:** standalone `contentstack-cli-tsgen` repos — see [TSGEN-MIGRATION.md](TSGEN-MIGRATION.md)
+- **v2 beta only:** `5.0.0-beta.0`+ on `feat/migrate-external-cli-plugins-v2` / `v2-beta`; requires CLI 2.x beta.
+- **Docs:** `csdx tsgen` → [typescript-cli-tsgen](packages/contentstack-cli-tsgen/skills/typescript-cli-tsgen/SKILL.md); tests → [package testing skill](packages/contentstack-cli-tsgen/skills/testing/SKILL.md)
+
+## Content Type plugin (`contentstack-cli-content-type`)
+
+- **Package path:** [packages/contentstack-content-type](packages/contentstack-content-type)
+- **npm name:** `contentstack-cli-content-type`
+- **Migrated from:** [contentstack/contentstack-cli-content-type](https://github.com/contentstack/contentstack-cli-content-type) — see [CONTENT-TYPE-MIGRATION.md](CONTENT-TYPE-MIGRATION.md)
+- **v1 / v2:** Maintain on `v1-dev` / `main` (1.x CLI deps) and `v2-beta` (2.x beta deps) branches; align `@contentstack/cli-command` and `@contentstack/cli-utilities` versions with the target CLI line.
+- **Tests:** Jest + ts-jest (unlike most other packages which use Mocha + Chai)
+- **Docs:** 6 commands under `content-type:*` → [packages/contentstack-content-type/AGENTS.md](packages/contentstack-content-type/AGENTS.md)
+
+## Regex Validate plugin (`@contentstack/cli-cm-regex-validate`)
+
+- **Package path:** [packages/contentstack-cli-cm-regex-validate](packages/contentstack-cli-cm-regex-validate)
+- **npm name:** `@contentstack/cli-cm-regex-validate`
+- **Migrated from:** [contentstack/cli-cm-regex-validate](https://github.com/contentstack/cli-cm-regex-validate) — see [REGEX-VALIDATE-MIGRATION.md](REGEX-VALIDATE-MIGRATION.md)
+- **v1 / v2:** Maintain on `v1-dev` / `main` (v1 CLI deps) and `v2-beta` (`~2.0.0-beta.7` / `~2.0.0-beta.8`, version `2.0.0-beta.0`); align with target CLI line.
+- **Tests:** Jest + ts-jest (unlike most other packages which use Mocha + Chai)
+- **Command:** Single command `cm:stacks:validate-regex` (short name `RGXVLD`)
+- **Docs:** [packages/contentstack-cli-cm-regex-validate/AGENTS.md](packages/contentstack-cli-cm-regex-validate/AGENTS.md)
+
+## Migrate RTE plugin (`@contentstack/cli-cm-migrate-rte`)
+
+- **Package path:** [packages/contentstack-migrate-rte](packages/contentstack-migrate-rte)
+- **npm name:** `@contentstack/cli-cm-migrate-rte` (unchanged)
+- **Migrated from:** [contentstack/cli-cm-migrate-rte](https://github.com/contentstack/cli-cm-migrate-rte) — see [MIGRATE-RTE-MIGRATION.md](MIGRATE-RTE-MIGRATION.md)
+- **Command:** `csdx cm:entries:migrate-html-rte` — JS sources in `src/`; `pnpm --filter @contentstack/cli-cm-migrate-rte run build` (`oclif manifest`) and `test` (see [dev-workflow](skills/dev-workflow/SKILL.md))
+
+## Bulk operations plugin (`@contentstack/cli-bulk-operations`)
+
+- **Package path:** [packages/contentstack-bulk-operations](packages/contentstack-bulk-operations)
+- **npm name:** `@contentstack/cli-bulk-operations` (unchanged)
+- **Migrated from:** [contentstack/cli-bulk-operations](https://github.com/contentstack/cli-bulk-operations) — see [BULK-OPERATIONS-MIGRATION.md](BULK-OPERATIONS-MIGRATION.md) (commands + repository)
+- **Commands:** `csdx cm:stacks:bulk-entries`, `csdx cm:stacks:bulk-assets`, `csdx cm:stacks:bulk-taxonomies` — see [dev-workflow](skills/dev-workflow/SKILL.md)
+
 ## Using Cursor (optional)
 
 If you use **Cursor**, [.cursor/rules/README.md](.cursor/rules/README.md) only points to **`AGENTS.md`**—same docs as everyone else.

APPS-CLI-MIGRATION.md

@@ -0,0 +1,51 @@
+# Apps CLI migration: standalone repo → cli-plugins monorepo
+
+## Summary
+
+The **@contentstack/apps-cli** plugin (`contentstack-apps-cli`) has moved from the standalone repository [contentstack/contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) into the [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) monorepo at **`packages/contentstack-apps-cli`**.
+
+The **npm package name is unchanged**: `@contentstack/apps-cli`. Install and command usage stay the same.
+
+## Repository and issue tracking
+
+| Before | After |
+| --- | --- |
+| Source: `github.com/contentstack/contentstack-apps-cli` | Source: `github.com/contentstack/cli-plugins` → `packages/contentstack-apps-cli` |
+| Issues: contentstack-apps-cli repo | Issues: [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) (label or mention `apps-cli` / `@contentstack/apps-cli`) |
+
+The standalone **contentstack-apps-cli** repository is **archived** after the first release from cli-plugins. Open PRs and bugs should be recreated or linked in cli-plugins.
+
+## Version lines (1.x vs 2.x)
+
+| CLI line | cli-plugins branch | Apps plugin notes |
+| --- | --- | --- |
+| **1.x** | `v1-dev` / `v1-beta` | `@contentstack/cli-command` and `@contentstack/cli-utilities` on 1.x-compatible ranges |
+| **2.x beta** | `v2-dev` / `v2-beta` | Align with 2.x beta core packages (same pattern as export, import, bootstrap) |
+
+Develop and release each line on its branch; do not mix 1.x and 2.x dependency pins in the same branch.
+
+## Install (unchanged)
+
+```bash
+csdx plugins:install @contentstack/apps-cli
+# or
+npm install -g @contentstack/apps-cli
+```
+
+## Local development
+
+Clone [cli-dev-workspace](https://github.com/contentstack/cli-dev-workspace) (or cli-plugins only), then:
+
+```bash
+cd cli-plugins
+pnpm install
+pnpm --filter @contentstack/apps-cli run build
+pnpm --filter @contentstack/apps-cli test
+```
+
+See [AGENTS.md](./AGENTS.md), [skills/contentstack-cli/SKILL.md](./skills/contentstack-cli/SKILL.md#apps-cli-commands-app), and [skills/framework/SKILL.md](./skills/framework/SKILL.md#apps-cli-plugin-contentstackapps-cli) for contributor docs.
+
+## Related migrations
+
+- Core CLI: [cli](https://github.com/contentstack/cli) monorepo
+- Other external plugins (bulk operations, migrate-rte): same cli-plugins consolidation effort

BULK-OPERATIONS-MIGRATION.md

@@ -1,6 +1,16 @@
 # 🔄 Migration Guide: From Bulk Publish to Bulk Operations Commands
 
 > **Migrating from @contentstack/cli-cm-bulk-publish (v1.x) to New Unified Commands @contentstack/cli-bulk-operations (v1.x)**
+
+## Repository
+
+| Before | After |
+| --- | --- |
+| [contentstack/cli-bulk-operations](https://github.com/contentstack/cli-bulk-operations) | [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) → `packages/contentstack-bulk-operations` |
+| Issues on standalone repo | [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) |
+
+npm package name unchanged: **`@contentstack/cli-bulk-operations`**. Local dev: `pnpm --filter @contentstack/cli-bulk-operations run build` / `test` from cli-plugins (or cli-dev-workspace).
+
 ---
 
 ## What Changed?

CONTENT-TYPE-MIGRATION.md

@@ -0,0 +1,76 @@
+# Content Type plugin migration: standalone repo → cli-plugins monorepo
+
+## Summary
+
+The **contentstack-cli-content-type** plugin has moved from the standalone repository [contentstack/contentstack-cli-content-type](https://github.com/contentstack/contentstack-cli-content-type) into the [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) monorepo at **`packages/contentstack-content-type`**.
+
+The **npm package name is unchanged**: `contentstack-cli-content-type`. Install and command usage stay the same.
+
+First release from the monorepo: **2.0.0-beta.0** (previously 1.4.6 from the standalone repo).
+
+## Repository and issue tracking
+
+| Before | After |
+| --- | --- |
+| Source: `github.com/contentstack/contentstack-cli-content-type` | Source: `github.com/contentstack/cli-plugins` → `packages/contentstack-content-type` |
+| Issues: contentstack-cli-content-type repo | Issues: [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) (label or mention `content-type` / `contentstack-cli-content-type`) |
+
+The standalone **contentstack-cli-content-type** repository should be **archived** after the first release from cli-plugins. Open PRs and bugs should be recreated or linked in cli-plugins.
+
+## Version lines (1.x vs 2.x)
+
+| CLI line | cli-plugins branch | Plugin notes |
+| --- | --- | --- |
+| **1.x** | `v1-dev` / `main` | `@contentstack/cli-command ~1.8.2`, `@contentstack/cli-utilities ~1.18.3`; npm tag `latest` |
+| **2.x beta** | `v2-dev` / `v2-beta` | Align with 2.x beta core packages; npm tag `beta` |
+
+Develop and release each line on its branch; do not mix 1.x and 2.x dependency pins in the same branch.
+
+## Install (unchanged)
+
+```bash
+csdx plugins:install contentstack-cli-content-type
+```
+
+## Commands (unchanged)
+
+All 6 commands are identical to the standalone version:
+
+| Command | Description |
+| --- | --- |
+| `csdx content-type:list` | List all Content Types in a Stack |
+| `csdx content-type:details` | Display Content Type fields, types, references, and paths |
+| `csdx content-type:audit` | Display recent changes (audit log) for a Content Type |
+| `csdx content-type:compare` | Compare two versions of a Content Type in the same Stack |
+| `csdx content-type:compare-remote` | Compare the same Content Type across two Stacks |
+| `csdx content-type:diagram` | Generate a visual diagram (SVG or DOT) of the Stack content model |
+
+## Local development
+
+Clone [cli-dev-workspace](https://github.com/contentstack/cli-dev-workspace) (or cli-plugins only), then:
+
+```bash
+cd cli-plugins
+pnpm install
+pnpm --filter contentstack-cli-content-type run build
+pnpm --filter contentstack-cli-content-type test
+```
+
+To link the plugin locally into your `csdx` installation:
+
+```bash
+cd packages/contentstack-content-type
+csdx plugins:link
+```
+
+See [packages/contentstack-content-type/AGENTS.md](./packages/contentstack-content-type/AGENTS.md) and the [skills/](./packages/contentstack-content-type/skills/) directory for contributor docs.
+
+## Test framework note
+
+This package uses **Jest + ts-jest** (unlike most other packages in this monorepo which use Mocha + Chai). Tests live under `packages/contentstack-content-type/tests/` and run via `pnpm test` or `pnpm run test:unit`.
+
+## Related migrations
+
+- Apps CLI: [APPS-CLI-MIGRATION.md](./APPS-CLI-MIGRATION.md)
+- Tsgen plugin: [TSGEN-MIGRATION.md](./TSGEN-MIGRATION.md)
+- Core CLI: [cli](https://github.com/contentstack/cli) monorepo