@mailmodo/cli 0.0.1-beta.pr3.5

package/README.md

@@ -0,0 +1,125 @@
+# mailmodo-cli
+
+Email lifecycle automation for the AI-native builder generation.
+
+## Prerequisites
+
+- **Node.js** v24.14.1
+
+## Setup
+
+```sh
+git clone https://github.com/Mailmodo/mailmodo-cli.git
+cd mailmodo-cli
+npm install
+```
+
+## Development
+
+### Run in dev mode (without building)
+
+```sh
+node ./bin/run.js <command>
+```
+
+Example:
+
+```sh
+node ./bin/run.js signup
+```
+
+### Build the project
+
+```sh
+npm run build
+```
+
+### Run after build
+
+```sh
+./bin/run.js <command>
+```
+
+### Link globally for local testing
+
+This registers the `mailmodo` binary on your system so you can use it from anywhere:
+
+```sh
+npm link
+```
+
+Then run commands directly:
+
+```sh
+mailmodo signup
+```
+
+To unlink:
+
+```sh
+npm unlink -g @mailmodo/cli
+```
+
+## Commands
+
+### `mailmodo signup`
+
+Sign up for Mailmodo. Prompts for an email address interactively.
+
+```sh
+mailmodo signup
+```
+
+### `mailmodo help [COMMAND]`
+
+Display help for any command.
+
+```sh
+mailmodo help
+mailmodo help signup
+```
+
+## Scripts
+
+| Script          | Description                          |
+| --------------- | ------------------------------------ |
+| `npm run build` | Clean `dist/` and compile TypeScript |
+| `npm run lint`  | Run ESLint                           |
+| `npm test`      | Run tests with Mocha                 |
+
+## CI/CD & Release Automation
+
+### Beta releases (on PR)
+
+Every time a pull request targeting `main` is opened or updated, a **beta version** is automatically published to npm. A comment is posted on the PR with install instructions:
+
+```sh
+npm install -g @mailmodo/cli@beta
+```
+
+This lets anyone on the team test the PR changes without checking out the branch locally.
+
+> **Note:** npm publishing requires the `NPM_AUTH_TOKEN_WRITE` secret to be configured in the repo settings. Until then, the publish step will be skipped but all other steps (build, version bump, release) still work.
+
+### Automatic versioning (on merge)
+
+When a PR is merged into `main`, the version in `package.json` is bumped automatically, a GitHub Release is created, and the new version is published to npm.
+
+The bump type is determined by a tag in the **PR title**:
+
+| PR title contains | Bump type | Example           |
+| ----------------- | --------- | ----------------- |
+| `[major]`         | major     | `1.2.3` → `2.0.0` |
+| `[minor]`         | minor     | `1.2.3` → `1.3.0` |
+| `[patch]`         | patch     | `1.2.3` → `1.2.4` |
+| _(nothing)_       | patch     | `1.2.3` → `1.2.4` |
+
+**Examples of PR titles:**
+
+- `[minor] Add email validation` → minor bump
+- `[major] Rewrite auth flow` → major bump
+- `Fix typo in help text` → patch bump (default)
+
+## License
+
+MIT

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/oclif.manifest.json

@@ -0,0 +1,4 @@
+{
+  "commands": {},
+  "version": "0.0.1-beta.pr3.5"
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@mailmodo/cli",
+  "description": "Email lifecycle automation for the AI-native builder generation.",
+  "version": "0.0.1-beta.pr3.5",
+  "author": "provishalk",
+  "bin": {
+    "mailmodo": "bin/run.js"
+  },
+  "bugs": "https://github.com/Mailmodo/mailmodo-cli/issues",
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.2",
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^11",
+    "oclif": "^4",
+    "shx": "^0.3.3",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
+  ],
+  "homepage": "https://github.com/Mailmodo/mailmodo-cli",
+  "keywords": [
+    "oclif"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
+  "oclif": {
+    "bin": "mailmodo",
+    "dirname": "mailmodo-cli",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "hello": {
+        "description": "Say hello to the world and others"
+      }
+    }
+  },
+  "repository": "Mailmodo/mailmodo-cli",
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "npm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
+  },
+  "types": "dist/index.d.ts"
+}