From 3b2002a49cff67e31d87de2db3420726899d3d99 Mon Sep 17 00:00:00 2001
From: lmgyuan <milleryuan0107@gmail.com>
Date: Sat, 10 Aug 2024 14:40:58 -0700
Subject: [PATCH 1/5] add postinstall.js and a deprecation markdown

---
 apps/generator/docs/deprecate-cli.sj-ag.md | 85 ++++++++++++++++++++++
 apps/generator/package.json                |  3 +-
 apps/generator/scripts/postinstall.js      | 29 ++++++++
 3 files changed, 116 insertions(+), 1 deletion(-)
 create mode 100644 apps/generator/docs/deprecate-cli.sj-ag.md
 create mode 100644 apps/generator/scripts/postinstall.js

diff --git a/apps/generator/docs/deprecate-cli.sj-ag.md b/apps/generator/docs/deprecate-cli.sj-ag.md
new file mode 100644
index 000000000..77fac6b6e
--- /dev/null
+++ b/apps/generator/docs/deprecate-cli.sj-ag.md
@@ -0,0 +1,85 @@
+---
+title: "Deprecate Cli.js"
+weight: 170
+---
+
+# Migration Guide from “ag/asyncapi-generator” to AsyncAPI CLI
+
+## Overview
+With the introduction of the AsyncAPI CLI, the use of `Cli.js` for documentation generation in the AsyncAPI generator repository is being deprecated. This guide provides detailed instructions on how to transition from `ag` to the new AsyncAPI CLI.
+
+## Why Migrate?
+- **Enhanced Features:** The AsyncAPI CLI offers advanced features and improvements.
+- **Consistency:** Ensures consistent command usage across different environments.
+- **Support and Maintenance:** Future updates and support will focus on the AsyncAPI CLI.
+
+## Deprecated `ag/asyncapi-generator` Options and Their AsyncAPI CLI Equivalents
+Here is a list of `ag/asyncapi-generator` options and their equivalents in the AsyncAPI CLI:
+
+- **-d, --disable-hook [hooks...]**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --disable-hook <hookType>=<hookName>`
+
+- **--debug**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --debug`
+
+- **-i, --install**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --install`
+
+- **-n, --no-overwrite <glob>**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --no-overwrite <glob>`
+
+- **-o, --output <outputDir>**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --output <outputDir>`
+
+- **-p, --param <name=value>**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --param <name=value>`
+
+- **--force-write**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --force-write`
+
+- **--watch-template**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --watch`
+
+- **--map-base-url <url:folder>**
+  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --map-base-url <url:folder>`
+
+## Migration Steps
+
+### 1. Install AsyncAPI CLI
+First, ensure you have the AsyncAPI CLI installed:
+```
+npm install -g @asyncapi/cli
+```
+
+### 2. Update Your Commands
+Replace the deprecated Cli.js commands with their AsyncAPI CLI equivalents. Below are examples of how to update your commands:
+**Example Migration**:
+**Before Migration (Using Cli.js)**:
+```
+ag ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
+```
+
+**After Migration (Using AsyncAPI CLI)**:
+```
+asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --param param1=value1 --debug --install --disable-hook hookType=hookName
+```
+
+### 3. Verify and Test
+Run the updated commands to ensure they work as expected. Verify the output and ensure that all files are generated correctly.
+
+### 4. Enable Watch Mode (Optional)
+If you were using the `--watch-template` option, you can now use the watch mode in the AsyncAPI CLI:
+```
+asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --watch
+```
+
+## Additional Resources
+**CLI Documentation**: [AsyncAPI CLI Documentation](https://www.asyncapi.com/docs/tools/cli)
+**Installation**: [AsyncAPI CLI Installation](https://www.asyncapi.com/docs/tools/cli/installation)
+**Usage**: [AsyncAPI CLI Usage](https://www.asyncapi.com/docs/tools/cli/usage)
+**Support**: For any issues or questions, please create an issue in our [CLI repository](https://github.com/asyncapi/cli).
+
+## Conclusion
+By following this migration guide, you can smoothly transition from Cli.js to the AsyncAPI CLI, taking advantage of its enhanced features and improved performance. If you have any questions or need further assistance, feel free to contact us.
+
+Happy coding!
diff --git a/apps/generator/package.json b/apps/generator/package.json
index b83e72ffd..12e27c354 100644
--- a/apps/generator/package.json
+++ b/apps/generator/package.json
@@ -25,7 +25,8 @@
     "lint:tpl:validator": "eslint --fix --config ../../.eslintrc ../../.github/templates-list-validator",
     "generate:readme:toc": "markdown-toc -i README.md",
     "generate:assets": "npm run docs && npm run generate:readme:toc",
-    "bump:version": "npm --no-git-tag-version --allow-same-version version $VERSION"
+    "bump:version": "npm --no-git-tag-version --allow-same-version version $VERSION",
+    "postinstall": "node ./scripts/postinstall.js"
   },
   "preferGlobal": true,
   "bugs": {
diff --git a/apps/generator/scripts/postinstall.js b/apps/generator/scripts/postinstall.js
new file mode 100644
index 000000000..5272ccbdb
--- /dev/null
+++ b/apps/generator/scripts/postinstall.js
@@ -0,0 +1,29 @@
+console.log(`
+*************************************
+*                                   *
+*  DEPRECATION NOTICE               *
+*                                   *
+*************************************
+
+The use of 'Cli.js' for documentation generation is deprecated and will be removed in future releases.
+
+Please migrate to the new AsyncAPI CLI using the following guide:
+
+1. Install AsyncAPI CLI:
+   $ npm install -g @asyncapi/cli
+
+2. Update your commands:
+   Replace the deprecated 'Cli.js' commands with their AsyncAPI CLI equivalents.
+
+Example Migration:
+
+Before Migration (Using 'Cli.js'):
+$ node Cli.js ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
+
+After Migration (Using AsyncAPI CLI):
+$ asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --param param1=value1 --debug --install --disable-hook hookType=hookName
+
+For more details, please visit: [Migration Guide URL]
+
+Thank you for your understanding and cooperation.
+`);

From d5402c8fed7d4c74af8225dc7984fd4ff7d7202e Mon Sep 17 00:00:00 2001
From: lmgyuan <milleryuan0107@gmail.com>
Date: Sat, 10 Aug 2024 14:45:27 -0700
Subject: [PATCH 2/5] update homepage ReadMe

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 74d2c5056..df1b2d008 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,9 @@ This is a Monorepo managed using [Turborepo](https://turbo.build/) and contains
 
 > warning: This package doesn't support AsyncAPI 1.x anymore. We recommend to upgrade to the latest AsyncAPI version using the [AsyncAPI converter](https://github.com/asyncapi/converter-js) (You can refer to [installation guide](/apps/generator//docs//installation-guide.md)). If you need to convert documents on the fly, you may use the [Node.js](https://github.com/asyncapi/converter-js) or [Go](https://github.com/asyncapi/converter-go) converters.
 
+> **Deprecation Notice**: The use of `cli.js` for documentation generation is deprecated and will be removed in future releases. We strongly encourage migrating to the new AsyncAPI CLI. The migration process is straightforward, and you can find the necessary steps in our [migration guide](/apps/generator/docs/deprecate-cli.sj-ag.md). Please ensure that your projects are updated accordingly to avoid any disruptions.
+
+
 <!-- toc is generated with GitHub Actions do not remove toc markers -->
 
 <!-- toc -->

From ef5e6b4ee0fabc0b0b54506458dae6b77f1664ce Mon Sep 17 00:00:00 2001
From: lmgyuan <milleryuan0107@gmail.com>
Date: Sat, 10 Aug 2024 14:50:34 -0700
Subject: [PATCH 3/5] Create start_clijs_deprecation.md

---
 .changeset/start_clijs_deprecation.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/start_clijs_deprecation.md

diff --git a/.changeset/start_clijs_deprecation.md b/.changeset/start_clijs_deprecation.md
new file mode 100644
index 000000000..c0b6b0df4
--- /dev/null
+++ b/.changeset/start_clijs_deprecation.md
@@ -0,0 +1,5 @@
+---
+"@asyncapi/generator": minor
+---
+
+Start deprecating `cli.js` in the generator repository.

From e063238094e937760d122ddbd3ed441cea27c50e Mon Sep 17 00:00:00 2001
From: lmgyuan <milleryuan0107@gmail.com>
Date: Mon, 16 Sep 2024 14:52:07 -0400
Subject: [PATCH 4/5] update PR

- delete unnecessary warning
- add more context to the changeset documentation.
- modify deprecate-cli.js-ag.md
- -o and -p instead of --output and --param
- delete enable watch mode part in the deprecation readMe
- delete replace cli.js in postinstall.js with ag
- add a link to the deprecation guide in the postinstall.js
- add an installation url in the postinstall.js
---
 .changeset/start_clijs_deprecation.md         |  4 ++-
 README.md                                     |  6 ++--
 ...te-cli.sj-ag.md => deprecate-cli.js-ag.md} | 36 ++++++++-----------
 apps/generator/scripts/postinstall.js         | 14 +++++---
 4 files changed, 29 insertions(+), 31 deletions(-)
 rename apps/generator/docs/{deprecate-cli.sj-ag.md => deprecate-cli.js-ag.md} (58%)

diff --git a/.changeset/start_clijs_deprecation.md b/.changeset/start_clijs_deprecation.md
index c0b6b0df4..bb89b341c 100644
--- a/.changeset/start_clijs_deprecation.md
+++ b/.changeset/start_clijs_deprecation.md
@@ -2,4 +2,6 @@
 "@asyncapi/generator": minor
 ---
 
-Start deprecating `cli.js` in the generator repository.
+Start deprecating `ag` in the generator repository. The purpose of deprecating the `ag` option for documentation generation is to move people's
+attention to use the `AsyncAPI CLI` in order to maintain a single entry point for all the AsyncAPI tools. 
+Otherwise, the maintainers need to manually update the `ag` option in the generator repository every time a new version of the `AsyncAPI CLI` is released.
diff --git a/README.md b/README.md
index df1b2d008..24a1714d7 100644
--- a/README.md
+++ b/README.md
@@ -9,10 +9,8 @@ This is a Monorepo managed using [Turborepo](https://turbo.build/) and contains
 
 ![npm](https://img.shields.io/npm/v/@asyncapi/generator?style=for-the-badge) ![npm](https://img.shields.io/npm/dt/@asyncapi/generator?style=for-the-badge)
 
-> warning: This package doesn't support AsyncAPI 1.x anymore. We recommend to upgrade to the latest AsyncAPI version using the [AsyncAPI converter](https://github.com/asyncapi/converter-js) (You can refer to [installation guide](/apps/generator//docs//installation-guide.md)). If you need to convert documents on the fly, you may use the [Node.js](https://github.com/asyncapi/converter-js) or [Go](https://github.com/asyncapi/converter-go) converters.
-
-> **Deprecation Notice**: The use of `cli.js` for documentation generation is deprecated and will be removed in future releases. We strongly encourage migrating to the new AsyncAPI CLI. The migration process is straightforward, and you can find the necessary steps in our [migration guide](/apps/generator/docs/deprecate-cli.sj-ag.md). Please ensure that your projects are updated accordingly to avoid any disruptions.
-
+[!IMPORTANT]
+Deprecation Notice: The use of ag for documentation generation is deprecated and will be removed in future releases. We strongly encourage migrating to the new AsyncAPI CLI.
 
 <!-- toc is generated with GitHub Actions do not remove toc markers -->
 
diff --git a/apps/generator/docs/deprecate-cli.sj-ag.md b/apps/generator/docs/deprecate-cli.js-ag.md
similarity index 58%
rename from apps/generator/docs/deprecate-cli.sj-ag.md
rename to apps/generator/docs/deprecate-cli.js-ag.md
index 77fac6b6e..9a7244291 100644
--- a/apps/generator/docs/deprecate-cli.sj-ag.md
+++ b/apps/generator/docs/deprecate-cli.js-ag.md
@@ -1,12 +1,12 @@
 ---
-title: "Deprecate Cli.js"
+title: "Deprecate ag"
 weight: 170
 ---
 
 # Migration Guide from “ag/asyncapi-generator” to AsyncAPI CLI
 
 ## Overview
-With the introduction of the AsyncAPI CLI, the use of `Cli.js` for documentation generation in the AsyncAPI generator repository is being deprecated. This guide provides detailed instructions on how to transition from `ag` to the new AsyncAPI CLI.
+With the introduction of the AsyncAPI CLI, the use of `ag` for documentation generation in the AsyncAPI generator repository is being deprecated. This guide provides detailed instructions on how to transition from `ag` to the new AsyncAPI CLI.
 
 ## Why Migrate?
 - **Enhanced Features:** The AsyncAPI CLI offers advanced features and improvements.
@@ -17,31 +17,31 @@ With the introduction of the AsyncAPI CLI, the use of `Cli.js` for documentation
 Here is a list of `ag/asyncapi-generator` options and their equivalents in the AsyncAPI CLI:
 
 - **-d, --disable-hook [hooks...]**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --disable-hook <hookType>=<hookName>`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --disable-hook <hookType>=<hookName>`
 
 - **--debug**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --debug`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --debug`
 
 - **-i, --install**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --install`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --install`
 
 - **-n, --no-overwrite <glob>**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --no-overwrite <glob>`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --no-overwrite <glob>`
 
 - **-o, --output <outputDir>**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --output <outputDir>`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --output <outputDir>`
 
 - **-p, --param <name=value>**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --param <name=value>`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --param <name=value>`
 
 - **--force-write**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --force-write`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --force-write`
 
 - **--watch-template**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --watch`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --watch`
 
 - **--map-base-url <url:folder>**
-  - **AsyncAPI CLI Equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --map-base-url <url:folder>`
+  - **AsyncAPI CLI equivalent:** `asyncapi generate fromTemplate <ASYNCAPI> <TEMPLATE> --map-base-url <url:folder>`
 
 ## Migration Steps
 
@@ -52,27 +52,21 @@ npm install -g @asyncapi/cli
 ```
 
 ### 2. Update Your Commands
-Replace the deprecated Cli.js commands with their AsyncAPI CLI equivalents. Below are examples of how to update your commands:
+Replace the deprecated ag commands with their AsyncAPI CLI equivalents. Below are examples of how to update your commands:
 **Example Migration**:
-**Before Migration (Using Cli.js)**:
+**Before Migration (Using ag)**:
 ```
 ag ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
 ```
 
 **After Migration (Using AsyncAPI CLI)**:
 ```
-asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --param param1=value1 --debug --install --disable-hook hookType=hookName
+asyncapi generate fromTemplate ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
 ```
 
 ### 3. Verify and Test
 Run the updated commands to ensure they work as expected. Verify the output and ensure that all files are generated correctly.
 
-### 4. Enable Watch Mode (Optional)
-If you were using the `--watch-template` option, you can now use the watch mode in the AsyncAPI CLI:
-```
-asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --watch
-```
-
 ## Additional Resources
 **CLI Documentation**: [AsyncAPI CLI Documentation](https://www.asyncapi.com/docs/tools/cli)
 **Installation**: [AsyncAPI CLI Installation](https://www.asyncapi.com/docs/tools/cli/installation)
@@ -80,6 +74,6 @@ asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --wa
 **Support**: For any issues or questions, please create an issue in our [CLI repository](https://github.com/asyncapi/cli).
 
 ## Conclusion
-By following this migration guide, you can smoothly transition from Cli.js to the AsyncAPI CLI, taking advantage of its enhanced features and improved performance. If you have any questions or need further assistance, feel free to contact us.
+By following this migration guide, you can smoothly transition from ag to the AsyncAPI CLI, taking advantage of its enhanced features and improved performance. If you have any questions or need further assistance, feel free to contact us.
 
 Happy coding!
diff --git a/apps/generator/scripts/postinstall.js b/apps/generator/scripts/postinstall.js
index 5272ccbdb..948f6074c 100644
--- a/apps/generator/scripts/postinstall.js
+++ b/apps/generator/scripts/postinstall.js
@@ -1,3 +1,6 @@
+const migrationGuideUrl = '../docs/deprecate-cli.js-ag.md'
+const installationGuideUrl = 'https://github.com/asyncapi/website/blob/master/assets/docs/fragments/cli-installation.md'
+
 console.log(`
 *************************************
 *                                   *
@@ -5,25 +8,26 @@ console.log(`
 *                                   *
 *************************************
 
-The use of 'Cli.js' for documentation generation is deprecated and will be removed in future releases.
+The use of 'ag' for documentation generation is deprecated and will be removed in future releases.
 
 Please migrate to the new AsyncAPI CLI using the following guide:
 
 1. Install AsyncAPI CLI:
    $ npm install -g @asyncapi/cli
+   For other installation methods, visit ${installationGuideUrl}
 
 2. Update your commands:
-   Replace the deprecated 'Cli.js' commands with their AsyncAPI CLI equivalents.
+   Replace the deprecated 'ag' commands with their AsyncAPI CLI equivalents.
 
 Example Migration:
 
-Before Migration (Using 'Cli.js'):
-$ node Cli.js ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
+Before Migration (Using 'ag'):
+$ ag ./asyncapi.yaml ./template -o ./output -p param1=value1 --debug --install --disable-hook hookType=hookName
 
 After Migration (Using AsyncAPI CLI):
 $ asyncapi generate fromTemplate ./asyncapi.yaml ./template --output ./output --param param1=value1 --debug --install --disable-hook hookType=hookName
 
-For more details, please visit: [Migration Guide URL]
+For more details, please visit: ${migrationGuideUrl}
 
 Thank you for your understanding and cooperation.
 `);

From 6ab60dbe0e247c86ba81b3063e30e23b059a6dfa Mon Sep 17 00:00:00 2001
From: lmgyuan <milleryuan0107@gmail.com>
Date: Mon, 16 Sep 2024 14:55:51 -0400
Subject: [PATCH 5/5] Update postinstall.js

added missing ;
---
 apps/generator/scripts/postinstall.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/generator/scripts/postinstall.js b/apps/generator/scripts/postinstall.js
index 948f6074c..4ef7122d1 100644
--- a/apps/generator/scripts/postinstall.js
+++ b/apps/generator/scripts/postinstall.js
@@ -1,5 +1,5 @@
-const migrationGuideUrl = '../docs/deprecate-cli.js-ag.md'
-const installationGuideUrl = 'https://github.com/asyncapi/website/blob/master/assets/docs/fragments/cli-installation.md'
+const migrationGuideUrl = '../docs/deprecate-cli.js-ag.md';
+const installationGuideUrl = 'https://github.com/asyncapi/website/blob/master/assets/docs/fragments/cli-installation.md';
 
 console.log(`
 *************************************