feat: migrate Apps CLI plugin to cli-plugins monorepo and add related documentation

- Moved the `@contentstack/apps-cli` plugin from the external plugin to the `cli-plugins` monorepo.
- Updated `AGENTS.md` to include Developer Hub apps in the purpose and added new sections for the Apps CLI plugin.
- Created `APPS-CLI-MIGRATION.md` to document the migration process and repository changes.
- Added new commands and configuration files for the Apps CLI plugin.
- Updated CI workflows to include testing and publishing for the Apps CLI plugin.

Author: harshitha-cstk

.cursor/rules/apps-cli.mdc

@@ -0,0 +1,34 @@
+---
+description: 'Contentstack Apps CLI plugin (Developer Hub app lifecycle)'
+globs:
+  [
+    'packages/contentstack-apps-cli/**/*.ts',
+    'packages/contentstack-apps-cli/test/**/*.ts',
+  ]
+alwaysApply: false
+---
+
+# Apps CLI plugin standards
+
+Canonical docs: [AGENTS.md](../../AGENTS.md) and skills:
+
+- [skills/contentstack-apps/SKILL.md](../../skills/contentstack-apps/SKILL.md) — manifests, GraphQL, HTTP
+- [skills/apps-cli-framework/SKILL.md](../../skills/apps-cli-framework/SKILL.md) — `BaseCommand`, `AppCLIBaseCommand`, flags
+- [skills/apps-cli-typescript/SKILL.md](../../skills/apps-cli-typescript/SKILL.md) — TS/ESLint
+
+## Command layout
+
+- Commands live under `packages/contentstack-apps-cli/src/commands/app/`
+- Topic: `app` (e.g. `csdx app:create`, `csdx app:deploy`)
+- Extend `AppCLIBaseCommand` for manifest workflows; otherwise `BaseCommand`
+
+## Testing
+
+- Mocha + Chai + sinon + nock; `@oclif/test` for command runs
+- Use `stubAuthentication` from `test/unit/helpers/auth-stub-helper.ts`
+- No real API credentials; `--forbid-only` in CI
+
+## Dependencies
+
+- `@contentstack/cli-command`, `@contentstack/cli-utilities` — version must match the cli-plugins branch (v1 vs v2 beta)
+- Chalk v5: loaded via init hook `src/hooks/init/load-chalk.ts`

.github/config/release.json

@@ -9,6 +9,7 @@
     "migration": false,
     "seed": false,
     "bootstrap": false,
-    "branches": false
+    "branches": false,
+    "apps-cli": false
   }
 }

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

@@ -142,3 +142,11 @@ jobs:
           token: ${{ secrets.NPM_TOKEN }}
           package: ./packages/contentstack-query-export/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

.github/workflows/unit-test.yml

@@ -66,3 +66,7 @@ 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:json

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, seed, audit, variants, Developer Hub apps, 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)
@@ -39,6 +39,16 @@ CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml) and other
 | Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Utilities, config, logging, errors |
 | 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 |
+| Contentstack Apps (Developer Hub) | [skills/contentstack-apps/SKILL.md](skills/contentstack-apps/SKILL.md) | Manifests, GraphQL, HTTP for `packages/contentstack-apps-cli` |
+| Apps CLI framework | [skills/apps-cli-framework/SKILL.md](skills/apps-cli-framework/SKILL.md) | `BaseCommand`, `AppCLIBaseCommand`, oclif flags for apps plugin |
+| Apps CLI TypeScript | [skills/apps-cli-typescript/SKILL.md](skills/apps-cli-typescript/SKILL.md) | TS/ESLint conventions for apps plugin |
+
+## 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.
 
 ## Using Cursor (optional)
 

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) and [skills/contentstack-apps/SKILL.md](./skills/contentstack-apps/SKILL.md) 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

MIGRATION.md

@@ -180,6 +180,14 @@ csdx cm:migrate-rte --help
 
 **Migration Action:** Refer to the detailed [Bulk Operations Migration Guide](./BULK-OPERATIONS-MIGRATION.md) for complete command mappings and examples.
 
+### 7. 📱 Apps CLI plugin repository move
+
+**What Changed:**
+- The Apps CLI plugin (`@contentstack/apps-cli`) source moved from the standalone [contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) repository into this **cli-plugins** monorepo at `packages/contentstack-apps-cli`
+- The npm package name and `csdx app:*` commands are unchanged
+
+**Migration Action:** For repository location, branching (1.x vs 2.x), and issue tracking, see the [Apps CLI Migration Guide](./APPS-CLI-MIGRATION.md).
+
 **Quick Example:**
 ```bash
 # Before (1.x.x)

README.md

@@ -15,6 +15,7 @@ CLI supports content management scripts through which you can perform the follow
 - Migrate HTML RTE to JSON RTE content
 - Change Master Locale
 - Use Bootstrap plugin
+- Manage Developer Hub apps (`app:*` via `@contentstack/apps-cli`)
 - Use Tsgen plugin
 
 

packages/contentstack-apps-cli/.eslintignore

@@ -0,0 +1 @@
+/dist

packages/contentstack-apps-cli/.eslintrc

@@ -0,0 +1,42 @@
+{
+  "env": {
+      "node": true
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+      "project": "tsconfig.json",
+      "sourceType": "module"
+  },
+  "plugins": [
+      "@typescript-eslint"
+  ],
+  "extends": [
+      "plugin:@typescript-eslint/recommended"
+  ],
+  "ignorePatterns": [
+      "lib/**/*",
+      "test/**/*"
+  ],
+  "rules": {
+      "@typescript-eslint/no-unused-vars": [
+          "error",
+          {
+              "args": "none"
+          }
+      ],
+      "@typescript-eslint/prefer-namespace-keyword": "error",
+      "quotes": "off",
+      "semi": "off",
+      "@typescript-eslint/no-redeclare": "off",
+      "eqeqeq": [
+          "error",
+          "smart"
+      ],
+      "id-match": "error",
+      "no-eval": "error",
+      "no-var": "error",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-require-imports": "off",
+      "prefer-const": "error"
+  }
+}