@maka/maka-cli 5.56.0 → 5.58.0

package/README.md

@@ -10,10 +10,37 @@ NodeJS backed applications deployed to on-prem and cloud-based infrastructures.
 If you like Maka-CLI, consider supporting me at [Patreon](https://www.patreon.com/user/membership?u=110174702)! ☕️
 
 ## Installation
+
+### With Node.js
 ```
   npm i -g @maka/maka-cli
 ```
 
+### Without Node.js — standalone executable
+
+Self-contained builds that need no Node.js installed. Extract, and the binary
+inside is called `maka`. These links always resolve to the most recent
+release, so they never need updating.
+
+| Platform | Download |
+| --- | --- |
+| macOS (Apple Silicon) | [maka-macos-arm64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-macos-arm64.tar.gz) |
+| macOS (Intel) | [maka-macos-x64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-macos-x64.tar.gz) |
+| Linux (x64) | [maka-linux-x64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-linux-x64.tar.gz) |
+| Linux (arm64) | [maka-linux-arm64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-linux-arm64.tar.gz) |
+| Windows (x64) | [maka-win-x64.zip](https://github.com/maka-io/maka-cli/releases/latest/download/maka-win-x64.zip) |
+
+```
+  tar -xzf maka-macos-arm64.tar.gz     # macOS / Linux
+  chmod +x maka
+  ./maka --help
+```
+
+The first Meteor command (`maka build`, `run` or `create`) downloads the
+Meteor toolchain and a Node runtime for it into `~/.meteor/.maka/runtime/`;
+that happens once. Every other command works immediately with nothing to
+download.
+
 ## Getting Started
 ```
   maka create KickTiresApp

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.56.0",
+  "version": "5.58.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 2.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 2.x applications using React.",
@@ -25,12 +25,13 @@
     "maka": "./typescript/src/maka.js",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
     "develop": "npm run build && concurrently \"tsc -w\" \"wait-on -d 10 ./src/exec.js && chmod +x ./src/exec.js\"",
-    "build": "rm -rf ./bundle && tsc && npm run prep && node scripts/check-command-registry.mjs",
+    "build": "node scripts/check-deps.mjs && rm -rf ./bundle && tsc && npm run prep && node scripts/check-command-registry.mjs",
+    "check:deps": "node scripts/check-deps.mjs",
     "prep": " cp -R ./src/templates ./bundle/typescript/src/ && cp ./README.md ./bundle/typescript/src/ && cp ./package.json ./bundle/typescript/ && cp ./src/commands/game/sideQuest/scenes/*.json ./bundle/typescript/src/commands/game/sideQuest/scenes/ && chmod +x ./bundle/typescript/src/exec.js",
-    "//": "## es-build, and package are still experimental",
-    "es-build": "esbuild ./bundle/typescript/src/maka.js --bundle --platform=node --outfile=bundle/maka.cjs",
-    "package": "pkg ./bundle/maka.cjs -d --bundle --out-path=\"bundle/compiled\" --compress GZip",
-    "distribute": "mkdir -p compiled/macos compiled/linux compiled/win && mv bundle/compiled/maka-linux compiled/linux/maka && mv bundle/compiled/maka-macos compiled/macos/maka && mv bundle/compiled/maka-win.exe compiled/win/maka.exe",
+    "build:bundle": "node scripts/build-bundle.mjs",
+    "test:parity": "node scripts/check-bundle-parity.mjs",
+    "package": "npm run build:bundle && node scripts/package.mjs",
+    "distribute": "node scripts/distribute.mjs",
     "prepare": "husky install"
   },
   "author": "Maka <maka@maka-cli.com>",
@@ -89,6 +90,7 @@
     "@types/node": "^22.8.5",
     "@types/uuid": "^10.0.0",
     "@types/ws": "^8.18.1",
+    "@yao-pkg/pkg": "^6.22.0",
     "concurrently": "^10.0.5",
     "esbuild": "^0.28.2",
     "eslint": "^9.13.0",

package/bundle/typescript/src/README.md

@@ -10,10 +10,37 @@ NodeJS backed applications deployed to on-prem and cloud-based infrastructures.
 If you like Maka-CLI, consider supporting me at [Patreon](https://www.patreon.com/user/membership?u=110174702)! ☕️
 
 ## Installation
+
+### With Node.js
 ```
   npm i -g @maka/maka-cli
 ```
 
+### Without Node.js — standalone executable
+
+Self-contained builds that need no Node.js installed. Extract, and the binary
+inside is called `maka`. These links always resolve to the most recent
+release, so they never need updating.
+
+| Platform | Download |
+| --- | --- |
+| macOS (Apple Silicon) | [maka-macos-arm64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-macos-arm64.tar.gz) |
+| macOS (Intel) | [maka-macos-x64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-macos-x64.tar.gz) |
+| Linux (x64) | [maka-linux-x64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-linux-x64.tar.gz) |
+| Linux (arm64) | [maka-linux-arm64.tar.gz](https://github.com/maka-io/maka-cli/releases/latest/download/maka-linux-arm64.tar.gz) |
+| Windows (x64) | [maka-win-x64.zip](https://github.com/maka-io/maka-cli/releases/latest/download/maka-win-x64.zip) |
+
+```
+  tar -xzf maka-macos-arm64.tar.gz     # macOS / Linux
+  chmod +x maka
+  ./maka --help
+```
+
+The first Meteor command (`maka build`, `run` or `create`) downloads the
+Meteor toolchain and a Node runtime for it into `~/.meteor/.maka/runtime/`;
+that happens once. Every other command works immediately with nothing to
+download.
+
 ## Getting Started
 ```
   maka create KickTiresApp

package/bundle/typescript/src/commands/game/sideQuest/commands/note.js

@@ -53,7 +53,15 @@ export class NoteCommand extends Command {
         try {
             mkdirSync(dirname(path), { recursive: true });
             const stamp = new Date().toISOString();
-            const where = this.actor?.currentLocation?.name ?? 'nowhere';
+            // MID-SHARED-RUN the local actor is still standing in the hub --
+            // the run itself is a server-side engine, and this command is
+            // deliberately routed home (see Game.LOCAL_ONLY_VERBS) so the note
+            // lands on the machine that typed it. Stamping the hub room onto a
+            // note written out on a job would be a plausible-looking lie, so
+            // say plainly where it came from instead.
+            const where = this.game?.remoteSession
+                ? 'shared run'
+                : (this.actor?.currentLocation?.name ?? 'nowhere');
             appendFileSync(path, `- [${stamp}] (${where}) ${text}\n`, 'utf8');
         }
         catch (err) {

package/bundle/typescript/src/commands/game/sideQuest/commands/note.js.map

@@ -1 +1 @@
-{"version":3,"file":"note.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/note.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"note.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/note.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/game.d.ts

@@ -74,6 +74,10 @@ export default class Game {
      * together. undefined for harnesses and headless clients, which run
      * with no log path at all -- callers must have a fallback.
      */
+    /** Verbs that must run on the player's OWN machine even mid-shared-run:
+     *  they write local files or read local state, and mean nothing to the
+     *  table. See the guard in handleInput. */
+    private static readonly LOCAL_ONLY_VERBS;
     get sessionDir(): string | undefined;
     /** The active job's name (seed name) -- notoriety incidents cite it. */
     get currentJobName(): string | undefined;

package/bundle/typescript/src/commands/game/sideQuest/game.js

@@ -193,6 +193,10 @@ export default class Game {
      * together. undefined for harnesses and headless clients, which run
      * with no log path at all -- callers must have a fallback.
      */
+    /** Verbs that must run on the player's OWN machine even mid-shared-run:
+     *  they write local files or read local state, and mean nothing to the
+     *  table. See the guard in handleInput. */
+    static LOCAL_ONLY_VERBS = new Set(['note']);
     get sessionDir() {
         return this._logFilePath ? dirname(this._logFilePath) : undefined;
     }
@@ -3692,7 +3696,22 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // the whole ui.ts pipeline (echo, menu routing, status refresh)
         // keeps working because the delegate honors handleInput's contract.
         if (this.remoteSession) {
-            return this.remoteSession.command(input);
+            // NOT EVERYTHING BELONGS TO THE TABLE (playtest 2026-08-26: eight
+            // notes typed during a shared run printed "Noted." and vanished).
+            // A shared run executes every command in the headless engine on
+            // the server, so `note` ran THERE -- homedir() resolved to the
+            // server's home and the player's own bug reports were appended to
+            // maka-cli.com's disk, where they can never see them. The hints
+            // toggle hid the path that would have given it away.
+            //
+            // These verbs touch no fiction and no shared state: they are the
+            // player's own margin scribbles about the game. They have no
+            // business crossing the wire, and the table has no business
+            // hearing them. Run them on the machine that typed them.
+            const verb = input.trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+            if (!Game.LOCAL_ONLY_VERBS.has(verb)) {
+                return this.remoteSession.command(input);
+            }
         }
         return (await this.handleInputAs(this.player.name, input)).text;
     }