feat(tsgen): migrate contentstack-cli-tsgen into cli-plugins monorepo

Author: cs-raj

.github/config/release.json

@@ -10,6 +10,7 @@
     "seed": false,
     "bootstrap": false,
     "branches": false,
-    "apps-cli": false
+    "apps-cli": false,
+    "tsgen": false
   }
 }

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

@@ -150,3 +150,11 @@ jobs:
           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

.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:integration
+        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

@@ -70,3 +70,7 @@ jobs:
       - name: Run tests for Contentstack Apps CLI
         working-directory: ./packages/contentstack-apps-cli
         run: npm run test:unit:report:json
+
+      - name: Lint Contentstack Tsgen plugin
+        working-directory: ./packages/contentstack-cli-tsgen
+        run: pnpm run lint

.talismanrc

@@ -1,6 +1,12 @@
 fileignoreconfig:
   - filename: pnpm-lock.yaml
-    checksum: e5b5f8ab64f4f27a1483e426cc01d7388482263e1d6fe3baf1caafcf2878ebb2
-  - filename: skills/framework/SKILL.md
-    checksum: c5746de64b1e7d1df051c4337de5eb32de6a4c85c7297aa408838d304bb2d771
+    checksum: 4372202dbc918ff057d77df14383465c11b0b211afb408e74e33d6f036e928b3
+  - filename: packages/contentstack-cli-tsgen/AGENTS.md
+    checksum: 7291676dc95b70ba0c4f0ead220b88355534682d4392aecd75609f1740df4be1
+  - filename: packages/contentstack-cli-tsgen/src/lib/helper.ts
+    checksum: a7ead0030ead9d15b6b6e9623f61e7def77b00325e3988f0e3d73a145180dedc
+  - filename: packages/contentstack-cli-tsgen/skills/typescript-cli-tsgen/SKILL.md
+    checksum: 0434741d74f66edab28fbea1520a6a5d4d42e292cc014d3f9c804aa10809334b
+  - filename: packages/contentstack-cli-tsgen/src/commands/tsgen.ts
+    checksum: 054ea78f765edca62c785714cf8962df4fb91529c0851439d1ed61e963467408
 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, Developer Hub apps, etc.). |
+| **Purpose:** | OCLIF plugins that extend the Contentstack CLI (import/export, clone, migration, 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)
@@ -48,6 +48,14 @@ CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml) and other
 - **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)
+
 ## 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.

README.md

@@ -67,4 +67,4 @@ To get a more detailed documentation for every command, visit the [CLI section](
 
 ## Useful Plugins
 
-- [Generate TypeScript typings from a Stack](https://github.com/Contentstack-Solutions/contentstack-cli-tsgen)
+- [Generate TypeScript typings from a Stack](https://github.com/contentstack/cli-plugins/tree/v2-beta/packages/contentstack-cli-tsgen) (`contentstack-cli-tsgen`)

TSGEN-MIGRATION.md

@@ -0,0 +1,54 @@
+# Tsgen CLI migration: standalone repo → cli-plugins monorepo
+
+## Summary
+
+The **contentstack-cli-tsgen** plugin has moved from the standalone repositories [Contentstack-Solutions/contentstack-cli-tsgen](https://github.com/Contentstack-Solutions/contentstack-cli-tsgen) and [contentstack/contentstack-cli-tsgen](https://github.com/contentstack/contentstack-cli-tsgen) into the [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) monorepo at **`packages/contentstack-cli-tsgen`**.
+
+The **npm package name is unchanged**: `contentstack-cli-tsgen`. Install and command usage stay the same (`csdx tsgen`).
+
+## Repository and issue tracking
+
+| Before | After |
+| --- | --- |
+| Source: standalone `contentstack-cli-tsgen` repos | Source: `github.com/contentstack/cli-plugins` → `packages/contentstack-cli-tsgen` |
+| Issues: standalone repo | Issues: [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) (label or mention `tsgen` / `contentstack-cli-tsgen`) |
+
+The standalone **contentstack-cli-tsgen** repository should be **archived** after the first release from cli-plugins. Open PRs and bugs should be recreated or linked in cli-plugins.
+
+## Version line (2.x beta only)
+
+| CLI line | cli-plugins branch | Tsgen plugin notes |
+| --- | --- | --- |
+| **2.x beta** | `feat/migrate-external-cli-plugins-v2` → `v2-beta` | `@contentstack/cli-command` and `@contentstack/cli-utilities` on `~2.0.0-beta.*`; first monorepo release **`5.0.0-beta.0`** |
+
+This migration does not maintain a `v1-dev` line for tsgen.
+
+## Install (unchanged)
+
+```bash
+csdx plugins:install contentstack-cli-tsgen@beta
+# or
+npm install -g contentstack-cli-tsgen
+```
+
+Requires **Contentstack CLI 2.x beta** and a **delivery token** alias for `csdx tsgen`.
+
+## 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-tsgen run build
+cd packages/contentstack-cli-tsgen && csdx plugins:link
+csdx tsgen --help
+```
+
+See [AGENTS.md](./AGENTS.md), package [AGENTS.md](./packages/contentstack-cli-tsgen/AGENTS.md), and [skills/typescript-cli-tsgen](./packages/contentstack-cli-tsgen/skills/typescript-cli-tsgen/SKILL.md) for contributor docs.
+
+## Related migrations
+
+- Core CLI: [cli](https://github.com/contentstack/cli) monorepo
+- Apps CLI: [APPS-CLI-MIGRATION.md](./APPS-CLI-MIGRATION.md)
+- Other external plugins: same cli-plugins consolidation effort

packages/contentstack-cli-tsgen/.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-cli-tsgen/.gitignore

@@ -0,0 +1,15 @@
+*-debug.log
+*-error.log
+/.nyc_output
+/dist
+/lib
+/tmp
+node_modules
+.DS_Store
+coverage
+.env
+oclif.manifest.json
+talisman_output.log
+snyk_output.log
+tsconfig.tsbuildinfo
+tests/integration/generated.d.ts