@modcafe/milkbucket 1.0.0 → 1.0.3

package/.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Publish Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+  packages: write
+
+jobs:
+  publish-npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+          package-manager-cache: false
+
+      - name: Generate package-lock.json
+        run: npm install --package-lock-only
+
+      - name: Publish to npm
+        run: npm publish --access public
+
+  publish-github:
+    name: Publish to GitHub Packages
+    runs-on: ubuntu-latest
+    needs: publish-npm
+    if: ${{ always() }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://npm.pkg.github.com
+          package-manager-cache: false
+
+      - name: Generate package-lock.json
+        run: npm install --package-lock-only
+
+      - name: Publish to GitHub Packages
+        run: npm publish --registry=https://npm.pkg.github.com
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Modcafe
+
+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.

package/README.md

@@ -60,37 +60,15 @@ npm --version
 
 ---
 
-## 2. Clone Milkbucket
+## 2. Install Milkbucket
 
-Clone the repository and enter its directory:
+Install Milkbucket globally from npm:
 
 ```bash
-git clone https://github.com/Modcafe/milkbucket.git
-cd milkbucket
+npm install -g @modcafe/milkbucket
 ```
 
-Then link Milkbucket as a global CLI:
-
-```bash
-npm link
-```
-
-### If `npm link` fails
-
-If npm does not have permission to create the global link, configure a user-local npm directory:
-
-```bash
-mkdir -p ~/.npm-global
-npm config set prefix ~/.npm-global
-echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
-source ~/.zshrc
-```
-
-Then run:
-
-```bash
-npm link
-```
+Once installed, the `milkbucket` command is available globally.
 
 ---
 
@@ -148,7 +126,7 @@ milkbucket --version
 
 ---
 
-## `info` (comming soon)
+## `info` (coming soon)
 
 Displays information about the current project and environment.
 
@@ -158,7 +136,7 @@ milkbucket info
 
 ---
 
-## `project` (comming soon)
+## `project` (coming soon)
 
 Tools for inspecting and working with the current Minecraft project.
 
@@ -166,7 +144,7 @@ Tools for inspecting and working with the current Minecraft project.
 milkbucket project
 ```
 
-### `project detect` (comming soon)
+### `project detect` (coming soon)
 
 Detects the type and configuration of the current project.
 
@@ -174,7 +152,7 @@ Detects the type and configuration of the current project.
 milkbucket project detect
 ```
 
-### `project validate` (comming soon)
+### `project validate` (coming soon)
 
 Checks the current project for common configuration problems.
 
@@ -184,7 +162,7 @@ milkbucket project validate
 
 ---
 
-## `build` (comming soon)
+## `build` (coming soon)
 
 Builds the current Minecraft project.
 
@@ -194,7 +172,7 @@ milkbucket build
 
 ---
 
-## `deps` (comming soon)
+## `deps` (coming soon)
 
 Tools for inspecting project dependencies.
 
@@ -202,7 +180,7 @@ Tools for inspecting project dependencies.
 milkbucket deps
 ```
 
-### `deps list` (comming soon)
+### `deps list` (coming soon)
 
 Lists the dependencies of the current project.
 
@@ -210,7 +188,7 @@ Lists the dependencies of the current project.
 milkbucket deps list
 ```
 
-### `deps check` (comming soon)
+### `deps check` (coming soon)
 
 Checks whether the project's dependencies are valid.
 
@@ -220,7 +198,7 @@ milkbucket deps check
 
 ---
 
-## `logs` (comming soon)
+## `logs` (coming soon)
 
 Tools for working with Minecraft logs.
 
@@ -228,7 +206,7 @@ Tools for working with Minecraft logs.
 milkbucket logs
 ```
 
-### `logs latest` (comming soon)
+### `logs latest` (coming soon)
 
 Displays or analyzes the latest log.
 
@@ -238,7 +216,7 @@ milkbucket logs latest
 
 ---
 
-## `crash` (comming soon)
+## `crash` (coming soon)
 
 Analyzes the latest Minecraft crash report.
 
@@ -248,7 +226,7 @@ milkbucket crash
 
 ---
 
-## `team` (comming soon)
+## `team` (coming soon)
 
 Tools for Modcafe development teams.
 
@@ -256,7 +234,7 @@ Tools for Modcafe development teams.
 milkbucket team
 ```
 
-### `team doctor` (comming soon)
+### `team doctor` (coming soon)
 
 Checks the local development environment.
 
@@ -268,16 +246,23 @@ milkbucket team doctor
 
 # Updating
 
-To update your local Milkbucket installation, pull the latest changes from GitHub:
+Update Milkbucket directly through npm:
+
+```bash
+npm update -g @modcafe/milkbucket
+```
+
+To install the latest version regardless of the currently installed version:
 
 ```bash
-cd milkbucket
-git pull
-npm link
+npm install -g @modcafe/milkbucket@latest
 ```
 
-> [!TIP]
-> You only need to configure the npm prefix once. After that, updating Milkbucket only requires `git pull` and `npm link`.
+You can verify the installed version afterwards:
+
+```bash
+milkbucket --version
+```
 
 ---
 
@@ -296,7 +281,7 @@ milkbucket/
 │   ├── version.js
 │   └── ...
 └── lib/
-    ├── commandInfo.json
+    ├── commandInfo.js
     └── ...
 ```
 
@@ -306,4 +291,4 @@ New commands should be added to the `commands/` directory and registered in the
 
 # License
 
-Internal Modcafe tooling.
+Internal Modcafe tooling. MIT.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@modcafe/milkbucket",
-    "version": "1.0.0",
+    "version": "1.0.3",
     "description": "Internal CLI tool by Modcafe for developing, testing and debugging Minecraft mods and datapacks.",
     "type": "module",
     "bin": {

package/.github/workflows/npm-publish.yml

@@ -1,26 +0,0 @@
-name: Publish to npm
-
-on:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org
-
-      - name: Publish package
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}