Enh/dx 7524 migrate apps cli v1

.cursor/rules/README.md

@@ -37,7 +37,7 @@ Context-aware rules that load automatically based on the files you're editing, o
 
 ### Monorepo Structure
 
-This is a **CLI plugins** monorepo with 12 plugin packages under `packages/`:
+This is a **CLI plugins** monorepo with plugin packages under `packages/`, including:
 - `contentstack-audit` - Stack audit and fix operations
 - `contentstack-bootstrap` - Seed/bootstrap stacks with content
 - `contentstack-branches` - Git-based branch management for stacks
@@ -50,6 +50,7 @@ This is a **CLI plugins** monorepo with 12 plugin packages under `packages/`:
 - `contentstack-migration` - Content migration workflows
 - `contentstack-seed` - Seed stacks with generated data
 - `contentstack-variants` - Manage content variants
+- `contentstack-apps-cli` - Developer Hub apps (`app:*` commands; npm `@contentstack/apps-cli`)
 
 All plugins depend on:
 - `@contentstack/cli-command` - Base Command class

.github/config/release.json

@@ -1,6 +1,8 @@
 {
   "releaseAll": true,
   "plugins": {
+    "variants": false,
+    "query-export": false,
     "utilities": false,
     "command": false,
     "config": false,
@@ -17,6 +19,7 @@
     "dev-dependencies": false,
     "launch": false,
     "branches": false,
+    "apps-cli": false,
     "core": false
   }
 }

.github/workflows/unit-test.yml

@@ -65,3 +65,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

.talismanrc

@@ -1,4 +1,4 @@
 fileignoreconfig:
   - filename: pnpm-lock.yaml
-    checksum: 97c02af1c210f0a8d5486ec114746856c96209132b973199cfed33de8461965c
+    checksum: 89acb731dc98c886694fa4d267c11c188000b8ecbe5ee6e4809e5bc6ec33a2f3
 version: '1.0'

APPS-CLI-MIGRATION.md

@@ -0,0 +1,45 @@
+# Apps CLI migration: standalone repo → cli-plugins monorepo
+
+## Summary
+
+The **@contentstack/apps-cli** plugin has moved from [contentstack/contentstack-apps-cli](https://github.com/contentstack/contentstack-apps-cli) into [contentstack/cli-plugins](https://github.com/contentstack/cli-plugins) at **`packages/contentstack-apps-cli`**.
+
+The **npm package name is unchanged**: `@contentstack/apps-cli`.
+
+## Repository and issues
+
+| Before | After |
+| --- | --- |
+| `github.com/contentstack/contentstack-apps-cli` | `github.com/contentstack/cli-plugins` → `packages/contentstack-apps-cli` |
+| Issues on standalone repo | [cli-plugins issues](https://github.com/contentstack/cli-plugins/issues) |
+
+## Version lines (1.x vs 2.x)
+
+| CLI line | cli-plugins branch | Apps plugin |
+| --- | --- | --- |
+| **1.x** | `v1-dev` / `v1-beta` | Version **1.7.x**; `@contentstack/cli-command` ~1.8.2, `@contentstack/cli-utilities` ~1.18.x; chalk v4 |
+| **2.x beta** | `v2-dev` / `v2-beta` | Version **2.0.0-beta.x**; 2.x beta core packages; chalk v5 |
+
+Develop and release each line on its branch.
+
+## Install (unchanged)
+
+```bash
+csdx plugins:install @contentstack/apps-cli
+```
+
+## Local development (cli-dev-workspace)
+
+```bash
+cd cli-dev-workspace
+pnpm install
+pnpm --filter @contentstack/apps-cli run build
+pnpm -C cli/packages/contentstack run build
+```
+
+Core CLI must list `@contentstack/apps-cli` as `workspace:*` and register it in `oclif.plugins` — see [cli](https://github.com/contentstack/cli) `packages/contentstack/package.json`.
+
+## Contributor docs
+
+- [AGENTS.md](./AGENTS.md)
+- [skills/contentstack-apps/SKILL.md](./skills/contentstack-apps/SKILL.md)

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"
+  }
+}

packages/contentstack-apps-cli/.gitignore

@@ -0,0 +1,21 @@
+*-debug.log
+*-error.log
+/.nyc_output
+/dist
+/lib
+/package-lock.json
+/tmp
+/yarn.lock
+node_modules
+oclif.manifest.json
+.env
+*.log
+tsconfig.tsbuildinfo
+dependabot.yml
+.vscode
+*.todo
+/bkp
+.editorconfig
+oclif.manifest.json
+*.env
+.vscode/

packages/contentstack-apps-cli/.mocharc.json

@@ -0,0 +1,12 @@
+{
+  "require": [
+    "test/helpers/init.js",
+    "ts-node/register"
+  ],
+  "watch-extensions": [
+    "ts"
+  ],
+  "recursive": true,
+  "reporter": "spec",
+  "timeout": 60000
+}

packages/contentstack-apps-cli/.snyk

@@ -0,0 +1,10 @@
+# Snyk (https://snyk.io) policy file, patches or ignores known vulnerabilities.
+version: v1.25.1
+# ignores vulnerabilities until expiry date; change duration by modifying expiry date
+ignore:
+  SNYK-JS-TMP-11501554:
+    - '*':
+        reason: 'https://contentstack.atlassian.net/browse/IS-5312'
+        expires: 2025-11-06T14:18:34.2257Z
+        created: 2025-08-08T14:18:34.2256Z
+patch: {}

packages/contentstack-apps-cli/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contentstack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.