@muverse/cli 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# @muverse/cli
+
+Command-line interface for `@muverse/core`.
+
+Build
+
+```bash
+npm run -w packages/cli build
+```
+
+Run
+
+```bash
+# after build
+node dist/index.js version --dry-run
+```
+
+Publish to npm
+
+```bash
+npm publish --workspace packages/cli --access public
+```

package/bin/run.js

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

package/dist/commands/version.d.ts

@@ -0,0 +1,25 @@
+import { Command } from "@oclif/core";
+export default class Version extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        repositoryRoot: import("@oclif/core/interfaces").Arg<string, {
+            exists?: boolean;
+        }>;
+    };
+    static flags: {
+        "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        adapter: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "push-tags": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "prerelease-mode": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "prerelease-id": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "bump-unchanged": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "add-build-metadata": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "timestamp-versions": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "append-snapshot": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "push-changes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "generate-changelog": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAInD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,QAAQ,WAKtB;IAEF,MAAM,CAAC,IAAI;;;;MAKT;IAEF,OAAgB,KAAK;;;;;;;;;;;;MAiDnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B3B"}

package/dist/commands/version.js

@@ -0,0 +1,90 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { VerseRunner, initLogger } from "@muverse/core";
+import { OclifLogger } from "../logger.js";
+export default class Version extends Command {
+    static description = "Calculate and apply semantic version changes";
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --adapter gradle",
+        "<%= config.bin %> <%= command.id %> --dry-run",
+        "<%= config.bin %> <%= command.id %> --prerelease-mode --prerelease-id alpha",
+    ];
+    static args = {
+        repositoryRoot: Args.directory({
+            required: true,
+            description: "Path to the repository root",
+        }),
+    };
+    static flags = {
+        "dry-run": Flags.boolean({
+            description: "Run without writing or pushing changes",
+            default: false,
+        }),
+        adapter: Flags.string({
+            description: "Language adapter (e.g., gradle). Auto-detected if not provided",
+            required: false,
+        }),
+        "push-tags": Flags.boolean({
+            description: "Push tags to origin",
+            default: true,
+        }),
+        "prerelease-mode": Flags.boolean({
+            description: "Generate pre-release versions instead of final versions",
+            default: false,
+        }),
+        "prerelease-id": Flags.string({
+            description: "Pre-release identifier (e.g., alpha, beta, rc)",
+            default: "alpha",
+        }),
+        "bump-unchanged": Flags.boolean({
+            description: "In prerelease mode, bump modules even when no changes are detected",
+            default: false,
+        }),
+        "add-build-metadata": Flags.boolean({
+            description: "Add build metadata with short SHA to all versions",
+            default: false,
+        }),
+        "timestamp-versions": Flags.boolean({
+            description: "Use timestamp-based prerelease identifiers (requires prerelease-mode)",
+            default: false,
+        }),
+        "append-snapshot": Flags.boolean({
+            description: "Add -SNAPSHOT suffix to all versions if supported by adapter",
+            default: false,
+        }),
+        "push-changes": Flags.boolean({
+            description: "Commit and push version changes and changelogs to remote",
+            default: true,
+        }),
+        "generate-changelog": Flags.boolean({
+            description: "Generate or update changelog files for changed modules",
+            default: true,
+        }),
+    };
+    async run() {
+        const { flags, args } = await this.parse(Version);
+        initLogger(new OclifLogger(this));
+        try {
+            const options = {
+                repoRoot: args.repositoryRoot,
+                adapter: flags.adapter,
+                dryRun: flags["dry-run"],
+                pushTags: flags["push-tags"],
+                prereleaseMode: flags["prerelease-mode"],
+                prereleaseId: flags["prerelease-id"],
+                bumpUnchanged: flags["bump-unchanged"],
+                addBuildMetadata: flags["add-build-metadata"],
+                timestampVersions: flags["timestamp-versions"],
+                appendSnapshot: flags["append-snapshot"],
+                pushChanges: flags["push-changes"],
+                generateChangelog: flags["generate-changelog"],
+            };
+            const runner = new VerseRunner(options);
+            await runner.run();
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.error(`❌ Command failed: ${errorMessage}`);
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { run } from '@oclif/core';
+run().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+import type { Logger } from '@muverse/core';
+export declare class OclifLogger implements Logger {
+    private readonly cmd;
+    constructor(cmd: Command);
+    info(message: string): void;
+    warning(message: string | Error): void;
+    error(message: string | Error, context?: Record<string, unknown>): void;
+    debug(message: string): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C,qBAAa,WAAY,YAAW,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAGtC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAGvE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG/B"}

package/dist/logger.js

@@ -0,0 +1,20 @@
+import Debug from 'debug';
+const debug = Debug('muverse');
+export class OclifLogger {
+    cmd;
+    constructor(cmd) {
+        this.cmd = cmd;
+    }
+    info(message) {
+        this.cmd.log(message);
+    }
+    warning(message) {
+        this.cmd.warn(message);
+    }
+    error(message, context) {
+        this.cmd.error(message, context);
+    }
+    debug(message) {
+        debug(message);
+    }
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@muverse/cli",
+  "version": "0.1.0",
+  "description": "μVERSE CLI - Command-line interface for μVERSE semantic versioning engine",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "muverse": "./bin/run.js"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json --outDir dist",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "muverse",
+    "cli",
+    "semantic-versioning",
+    "conventional-commits",
+    "version-engine",
+    "monorepo"
+  ],
+  "author": "tvcsantos",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tvcsantos/muverse.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tvcsantos/muverse/issues"
+  },
+  "homepage": "https://github.com/tvcsantos/muverse#readme",
+  "files": [
+    "dist"
+  ],
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@oclif/core": "^4.8.0",
+    "@muverse/core": "^0.1.0",
+    "oclif": "^4.14.0"
+  },
+  "devDependencies": {
+    "@oclif/dev-cli": "^1.26.10",
+    "@types/debug": "^4.1.12",
+    "@types/node": "^20.19.23",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "oclif": {
+    "bin": "muverse",
+    "commands": "./dist/commands",
+    "dirname": "muverse",
+    "topicSeparator": " ",
+    "plugins": []
+  }
+}