@enspirit/emb 0.0.1

package/README.md

@@ -0,0 +1,379 @@
+emb (Enspirit's Monorepo Builder)
+=================
+
+A CLI to help on Enspirit monorepos. This aims at replacing our aging [Makefile for monorepos](https://github.com/enspirit/makefile-for-monorepos/pulls)
+
+<!-- toc -->
+* [Usage](#usage)
+* [Commands](#commands)
+<!-- tocstop -->
+# Usage
+<!-- usage -->
+```sh-session
+$ npm install -g @enspirit/emb
+$ emb COMMAND
+running command...
+$ emb (--version)
+@enspirit/emb/0.0.1 darwin-x64 node-v22.12.0
+$ emb --help [COMMAND]
+USAGE
+  $ emb COMMAND
+...
+```
+<!-- usagestop -->
+# Commands
+<!-- commands -->
+* [`emb autocomplete [SHELL]`](#emb-autocomplete-shell)
+* [`emb help [COMMAND]`](#emb-help-command)
+* [`emb plugins`](#emb-plugins)
+* [`emb plugins add PLUGIN`](#emb-plugins-add-plugin)
+* [`emb plugins:inspect PLUGIN...`](#emb-pluginsinspect-plugin)
+* [`emb plugins install PLUGIN`](#emb-plugins-install-plugin)
+* [`emb plugins link PATH`](#emb-plugins-link-path)
+* [`emb plugins remove [PLUGIN]`](#emb-plugins-remove-plugin)
+* [`emb plugins reset`](#emb-plugins-reset)
+* [`emb plugins uninstall [PLUGIN]`](#emb-plugins-uninstall-plugin)
+* [`emb plugins unlink [PLUGIN]`](#emb-plugins-unlink-plugin)
+* [`emb plugins update`](#emb-plugins-update)
+
+## `emb autocomplete [SHELL]`
+
+Display autocomplete installation instructions.
+
+```
+USAGE
+  $ emb autocomplete [SHELL] [-r]
+
+ARGUMENTS
+  SHELL  (zsh|bash|powershell) Shell type
+
+FLAGS
+  -r, --refresh-cache  Refresh cache (ignores displaying instructions)
+
+DESCRIPTION
+  Display autocomplete installation instructions.
+
+EXAMPLES
+  $ emb autocomplete
+
+  $ emb autocomplete bash
+
+  $ emb autocomplete zsh
+
+  $ emb autocomplete powershell
+
+  $ emb autocomplete --refresh-cache
+```
+
+_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.34/src/commands/autocomplete/index.ts)_
+
+## `emb help [COMMAND]`
+
+Display help for emb.
+
+```
+USAGE
+  $ emb help [COMMAND...] [-n]
+
+ARGUMENTS
+  COMMAND...  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for emb.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.32/src/commands/help.ts)_
+
+## `emb plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ emb plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ emb plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/index.ts)_
+
+## `emb plugins add PLUGIN`
+
+Installs a plugin into emb.
+
+```
+USAGE
+  $ emb plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into emb.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the EMB_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the EMB_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ emb plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ emb plugins add myplugin
+
+  Install a plugin from a github url.
+
+    $ emb plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ emb plugins add someuser/someplugin
+```
+
+## `emb plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ emb plugins inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN...  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ emb plugins inspect myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/inspect.ts)_
+
+## `emb plugins install PLUGIN`
+
+Installs a plugin into emb.
+
+```
+USAGE
+  $ emb plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into emb.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the EMB_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the EMB_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ emb plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ emb plugins install myplugin
+
+  Install a plugin from a github url.
+
+    $ emb plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ emb plugins install someuser/someplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/install.ts)_
+
+## `emb plugins link PATH`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ emb plugins link PATH [-h] [--install] [-v]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help          Show CLI help.
+  -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ emb plugins link myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/link.ts)_
+
+## `emb plugins remove [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ emb plugins remove [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ emb plugins unlink
+  $ emb plugins remove
+
+EXAMPLES
+  $ emb plugins remove myplugin
+```
+
+## `emb plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ emb plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/reset.ts)_
+
+## `emb plugins uninstall [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ emb plugins uninstall [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ emb plugins unlink
+  $ emb plugins remove
+
+EXAMPLES
+  $ emb plugins uninstall myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/uninstall.ts)_
+
+## `emb plugins unlink [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ emb plugins unlink [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ emb plugins unlink
+  $ emb plugins remove
+
+EXAMPLES
+  $ emb plugins unlink myplugin
+```
+
+## `emb plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ emb plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.46/src/commands/plugins/update.ts)_
+<!-- commandsstop -->

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

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@enspirit/emb",
+  "type": "module",
+  "version": "0.0.1",
+  "keywords": ["monorepo", "docker", "taskrunner", "ci", "docker compose", "sentinel", "makefile"],
+  "author": "Louis Lambeau <louis.lambeau@enspirit.be>",
+  "license": "ISC",
+  "description": "A replacement for our Makefile-for-monorepos",
+  "bin": {
+    "emb": "./bin/run.js"
+  },
+  "scripts": {
+    "build": "rimraf dist && npm run build:types && npm run build:ts && npm run copy:proto",
+    "copy:proto": "cp -r src/docker/protobuf/*.proto dist/src/docker/protobuf/",
+    "build:ts": "tsc -b && tsc-alias",
+    "build:types": "json2ts src/config/schema.json > src/config/schema.ts",
+    "lint": "eslint",
+    "pack": "npm run pack:macos && npm run pack:deb",
+    "pack:macos": "oclif pack macos",
+    "pack:deb": "oclif pack deb",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "npm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "test": "npm run build:types && npm run test:unit",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:watch": "vitest",
+    "version": "oclif readme && git add README.md"
+  },
+  "dependencies": {
+    "@listr2/manager": "^3.0.1",
+    "@oclif/core": "^4.5.2",
+    "@oclif/plugin-autocomplete": "^3.2.34",
+    "@oclif/plugin-help": "^6.2.32",
+    "@oclif/plugin-not-found": "^3.2.63",
+    "@oclif/plugin-plugins": "^5.4.46",
+    "@oclif/table": "^0.4.12",
+    "ajv": "^8.17.1",
+    "docker-compose": "^1.2.0",
+    "dockerode": "^4.0.7",
+    "dotenv": "^17.2.1",
+    "execa": "^9.6.0",
+    "find-up": "^7.0.0",
+    "glob": "^11.0.3",
+    "graphlib": "^2.1.8",
+    "listr2": "^9.0.1",
+    "luxon": "^3.7.1",
+    "protobufjs": "^7.5.3",
+    "simple-git": "^3.28.0",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.32.0",
+    "@fastify/deepmerge": "^3.1.0",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/dockerode": "^3.3.42",
+    "@types/graphlib": "^2.1.12",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^24.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.39.0",
+    "@typescript-eslint/parser": "^8.39.0",
+    "eslint": "^9.32.0",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.3",
+    "json-schema-to-typescript": "^15.0.4",
+    "oclif": "^4",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "shx": "^0.4.0",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.20.3",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "./bin",
+    "./dist/src",
+    "./oclif.manifest.json"
+  ],
+  "main": "dist/src/index.js",
+  "oclif": {
+    "bin": "emb",
+    "dirname": "emb",
+    "commands": "./dist/src/cli/commands",
+    "hooks": {
+      "init": "./dist/src/cli/hooks/init"
+    },
+    "macos": {
+      "identifier": "dev.enspirit.emb"
+    },
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-autocomplete",
+      "@oclif/plugin-not-found",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "hello": {
+        "description": "Say hello to the world and others"
+      }
+    }
+  }
+}