ic-mops 2.3.0 → 2.3.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Next
 
+## 2.3.2
+- Fix `mops check`, `mops build`, and `mops check-stable` failing to find canister entrypoints when run from a subdirectory
+
+## 2.3.1
+- Fix `mops build` and `mops check-candid` failing with "Wasm bindings have not been set" when installed via `npm i -g ic-mops`
+
 ## 2.3.0
 - Add `mops check-stable` command for stable variable compatibility checking
 - `mops check` now falls back to canister entrypoints from `mops.toml` when no files are specified

package/RELEASE.md

@@ -2,20 +2,9 @@
 
 ## Prerequisites
 
-### macOS: GNU tar
-
-```bash
-brew install gnu-tar
-```
-
-Add to `~/.zshrc` or `~/.bashrc`:
-```bash
-export PATH="$HOMEBREW_PREFIX/opt/gnu-tar/libexec/gnubin:$PATH"
-```
-
 ### Docker
 
-Docker (or OrbStack) must be installed and running. The CLI build happens inside a Docker container (`zenvoich/mops-builder:1.1.0`) for reproducibility.
+Docker (or OrbStack) must be installed and running. The on-chain release step builds the CLI inside a Docker container (`zenvoich/mops-builder:1.1.0`) for reproducibility.
 
 ### dfx
 
@@ -23,13 +12,7 @@ Docker (or OrbStack) must be installed and running. The CLI build happens inside
 
 ## Release Steps
 
-### 1. Install dependencies
-
-```bash
-cd cli && bun install
-```
-
-### 2. Update changelog
+### 1. Update changelog
 
 Move items from the `## Next` section in `CHANGELOG.md` into a new version heading:
 
@@ -41,28 +24,19 @@ Move items from the `## Next` section in `CHANGELOG.md` into a new version headi
 - Change 2
 ```
 
-The heading must contain the exact version string — `release-cli.ts` parses it to extract release notes.
-
-### 3. Create a release branch and PR
-
-Direct pushes to `main` are not allowed. Create a branch and PR:
-
-```bash
-git checkout -b <username>/release-X.Y.Z
-```
-
-### 4. Bump version
+The heading must contain the exact version string — the release workflow parses it to extract release notes for the GitHub Release.
 
-Use `--no-git-tag-version` since the version bump will be committed as part of the PR (not directly on `main`):
+### 2. Bump version
 
 ```bash
 cd cli
 npm version minor --no-git-tag-version  # or: patch / major
 ```
 
-### 5. Commit, push, and open PR
+### 3. Create a release branch and PR
 
 ```bash
+git checkout -b <username>/release-X.Y.Z
 git add cli/CHANGELOG.md cli/package.json cli/package-lock.json
 git commit -m "release: CLI vX.Y.Z"
 git push -u origin <username>/release-X.Y.Z
@@ -71,41 +45,26 @@ gh pr create --title "release: CLI vX.Y.Z" --body "..."
 
 Wait for CI to pass, then merge the PR.
 
-### 6. Check reproducibility of the build
-
-After the PR is merged to `main`, check the SHA256 hash from the latest [build-hash workflow](https://github.com/caffeinelabs/mops/actions/workflows/build-hash.yml) run.
+### 4. Tag and push
 
-**Important**: The CI hash is written to the GitHub Actions **Step Summary** — it is only visible on the **Summary tab** of the workflow run page. It does **not** appear in the downloadable logs (`gh run view --log` will not find it). You must open the run URL in a browser to see it.
+After the PR is merged to `main`:
 
-Build the same version locally:
 ```bash
-cd cli
-MOPS_VERSION=0.0.0 ./build.sh
+git checkout main && git pull
+git tag cli-vX.Y.Z
+git push origin cli-vX.Y.Z
 ```
 
-`build.sh` does the following:
-1. Reads `COMMIT_HASH` (defaults to `git rev-parse HEAD`) and `MOPS_VERSION`
-2. Runs `docker build` using `cli/Dockerfile` with those as build args
-3. The Dockerfile clones the repo at that commit, runs `bun install`, sets the version, and runs `npm run build`
-4. Prints the SHA256 hash of `cli.tgz`
-5. Copies `cli.tgz` out of the container into `cli/bundle/cli.tgz`
+This triggers the [`release.yml`](../.github/workflows/release.yml) workflow which automatically:
+1. Validates the tag is on `main` and version matches `package.json`
+2. Builds the CLI tarball in Docker (reproducible build)
+3. Computes and reports the SHA256 hash (visible in the workflow Step Summary)
+4. Publishes to npm via OIDC trusted publishing
+5. Creates a GitHub Release with the tarball attached and changelog as release notes
 
-Compare the locally printed hash with the one from the CI Step Summary. If they don't match, do not proceed.
-
-**Notes on the local build output:**
-- The "Verification failed" message at the end is **expected** — it happens because no `SHASUM` env var is passed for comparison. The important output is the `Actual shasum: <hash>` line.
-
-### 7. Publish to npm
-
-After the PR is merged and the build hash is verified:
-
-```bash
-git checkout main && git pull
-cd cli
-npm publish
-```
+Monitor the workflow run at [Actions → Release CLI](https://github.com/caffeinelabs/mops/actions/workflows/release.yml).
 
-### 8. Prepare on-chain release
+### 5. Prepare on-chain release
 
 Run from the **repo root** (not `cli/`), with Docker running:
 
@@ -122,7 +81,7 @@ This runs `cli/release-cli.ts`, which:
 6. Updates `cli-releases/tags/latest` to the new version
 7. Updates `cli-releases/releases.json` with metadata (timestamp, size, hash, commit hash, download URL, release notes)
 
-### 9. Deploy the canister
+### 6. Deploy the canister
 
 ```bash
 dfx deploy --network ic --no-wallet cli --identity mops
@@ -130,7 +89,7 @@ dfx deploy --network ic --no-wallet cli --identity mops
 
 This deploys the `cli-releases` canister (serving `cli.mops.one`) to the Internet Computer mainnet.
 
-### 10. Deploy the docs canister
+### 7. Deploy the docs canister
 
 ```bash
 dfx deploy --network ic --no-wallet docs --identity mops
@@ -138,9 +97,9 @@ dfx deploy --network ic --no-wallet docs --identity mops
 
 This builds the Docusaurus site (`docs/`) and deploys the `docs` assets canister (serving `docs.mops.one`). Docs are not auto-deployed, so this step ensures any documentation changes from the release are published.
 
-### 11. Commit and push release artifacts
+### 8. Commit and push release artifacts
 
-Step 8 generates files in `cli-releases/` that must be committed and pushed:
+Step 5 generates files in `cli-releases/` that must be committed and pushed:
 
 ```bash
 git add cli-releases/
@@ -159,7 +118,7 @@ Merge this PR after approval.
 
 ## Verify build
 
-Anyone can verify a released version by rebuilding from source:
+Anyone can verify a released version by rebuilding from source. The SHA256 hash and verification instructions are included in each [GitHub Release](https://github.com/caffeinelabs/mops/releases).
 
 ```bash
 cd cli

package/commands/build.ts

@@ -7,7 +7,7 @@ import { cliError } from "../error.js";
 import { isCandidCompatible } from "../helpers/is-candid-compatible.js";
 import { resolveCanisterConfigs } from "../helpers/resolve-canisters.js";
 import { CustomSection, getWasmBindings } from "../wasm.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
 
@@ -67,6 +67,7 @@ export async function build(
     if (!motokoPath) {
       cliError(`No main file is specified for canister ${canisterName}`);
     }
+    motokoPath = resolveConfigPath(motokoPath);
     const wasmPath = join(outputDir, `${canisterName}.wasm`);
     let args = [
       "-c",
@@ -129,13 +130,15 @@ export async function build(
       }
 
       const generatedDidPath = join(outputDir, `${canisterName}.did`);
-      if (canister.candid) {
-        const originalCandidPath = canister.candid;
+      const resolvedCandidPath = canister.candid
+        ? resolveConfigPath(canister.candid)
+        : null;
 
+      if (resolvedCandidPath) {
         try {
           const compatible = await isCandidCompatible(
             generatedDidPath,
-            originalCandidPath,
+            resolvedCandidPath,
           );
 
           if (!compatible) {
@@ -160,7 +163,7 @@ export async function build(
 
       options.verbose &&
         console.log(chalk.gray(`Adding metadata to ${wasmPath}`));
-      const candidPath = canister.candid ?? generatedDidPath;
+      const candidPath = resolvedCandidPath ?? generatedDidPath;
       const candidText = await readFile(candidPath, "utf-8");
       const customSections: CustomSection[] = [
         { name: `${candidVisibility} candid:service`, data: candidText },

package/commands/check-stable.ts

@@ -4,7 +4,7 @@ import { rename, rm } from "node:fs/promises";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { resolveSingleCanister } from "../helpers/resolve-canisters.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
@@ -33,7 +33,7 @@ export async function checkStable(
 
   await runStableCheck({
     oldFile,
-    canisterMain: canister.main,
+    canisterMain: resolveConfigPath(canister.main),
     canisterName: name,
     mocPath,
     globalMocArgs,

package/commands/check.ts

@@ -1,9 +1,9 @@
-import { relative } from "node:path";
+import path from "node:path";
 import { existsSync } from "node:fs";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { autofixMotoko } from "../helpers/autofix-motoko.js";
 import { getMocSemVer } from "../helpers/get-moc-version.js";
 import {
@@ -36,7 +36,7 @@ export async function check(
   const config = readConfig();
 
   if (fileList.length === 0) {
-    fileList = resolveCanisterEntrypoints(config);
+    fileList = resolveCanisterEntrypoints(config).map(resolveConfigPath);
   }
 
   if (fileList.length === 0) {
@@ -86,7 +86,7 @@ export async function check(
       for (const [file, codes] of fixResult.fixedFiles) {
         const unique = [...new Set(codes)].sort();
         const n = codes.length;
-        const rel = relative(process.cwd(), file);
+        const rel = path.relative(process.cwd(), file);
         console.log(
           chalk.green(
             `Fixed ${rel} (${n} ${n === 1 ? "fix" : "fixes"}: ${unique.join(", ")})`,
@@ -144,12 +144,13 @@ export async function check(
       cliError(`No main file specified for canister '${name}' in mops.toml`);
     }
 
-    if (!existsSync(stableConfig.path)) {
+    const stablePath = resolveConfigPath(stableConfig.path);
+    if (!existsSync(stablePath)) {
       if (stableConfig.skipIfMissing) {
         continue;
       }
       cliError(
-        `Deployed file not found: ${stableConfig.path} (canister '${name}')\n` +
+        `Deployed file not found: ${stablePath} (canister '${name}')\n` +
           "Set skipIfMissing = true in [canisters." +
           name +
           ".check-stable] to skip this check when the file is missing.",
@@ -157,8 +158,8 @@ export async function check(
     }
 
     await runStableCheck({
-      oldFile: stableConfig.path,
-      canisterMain: canister.main,
+      oldFile: stablePath,
+      canisterMain: resolveConfigPath(canister.main),
       canisterName: name,
       mocPath,
       globalMocArgs,

package/dist/bin/mops.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-import "../cli.js";
+import "../environments/nodejs/cli.js";

package/dist/commands/build.js

@@ -7,7 +7,7 @@ import { cliError } from "../error.js";
 import { isCandidCompatible } from "../helpers/is-candid-compatible.js";
 import { resolveCanisterConfigs } from "../helpers/resolve-canisters.js";
 import { getWasmBindings } from "../wasm.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
 export const DEFAULT_BUILD_OUTPUT_DIR = ".mops/.build";
@@ -45,6 +45,7 @@ export async function build(canisterNames, options) {
         if (!motokoPath) {
             cliError(`No main file is specified for canister ${canisterName}`);
         }
+        motokoPath = resolveConfigPath(motokoPath);
         const wasmPath = join(outputDir, `${canisterName}.wasm`);
         let args = [
             "-c",
@@ -98,10 +99,12 @@ export async function build(canisterNames, options) {
                 console.log(result.stdout);
             }
             const generatedDidPath = join(outputDir, `${canisterName}.did`);
-            if (canister.candid) {
-                const originalCandidPath = canister.candid;
+            const resolvedCandidPath = canister.candid
+                ? resolveConfigPath(canister.candid)
+                : null;
+            if (resolvedCandidPath) {
                 try {
-                    const compatible = await isCandidCompatible(generatedDidPath, originalCandidPath);
+                    const compatible = await isCandidCompatible(generatedDidPath, resolvedCandidPath);
                     if (!compatible) {
                         cliError(`Candid compatibility check failed for canister ${canisterName}`);
                     }
@@ -115,7 +118,7 @@ export async function build(canisterNames, options) {
             }
             options.verbose &&
                 console.log(chalk.gray(`Adding metadata to ${wasmPath}`));
-            const candidPath = canister.candid ?? generatedDidPath;
+            const candidPath = resolvedCandidPath ?? generatedDidPath;
             const candidText = await readFile(candidPath, "utf-8");
             const customSections = [
                 { name: `${candidVisibility} candid:service`, data: candidText },

package/dist/commands/check-stable.js

@@ -4,7 +4,7 @@ import { rename, rm } from "node:fs/promises";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { resolveSingleCanister } from "../helpers/resolve-canisters.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
@@ -19,7 +19,7 @@ export async function checkStable(oldFile, canisterName, options = {}) {
     const globalMocArgs = getGlobalMocArgs(config);
     await runStableCheck({
         oldFile,
-        canisterMain: canister.main,
+        canisterMain: resolveConfigPath(canister.main),
         canisterName: name,
         mocPath,
         globalMocArgs,

package/dist/commands/check.js

@@ -1,9 +1,9 @@
-import { relative } from "node:path";
+import path from "node:path";
 import { existsSync } from "node:fs";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
-import { getGlobalMocArgs, readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig, resolveConfigPath } from "../mops.js";
 import { autofixMotoko } from "../helpers/autofix-motoko.js";
 import { getMocSemVer } from "../helpers/get-moc-version.js";
 import { resolveCanisterConfigs, resolveCanisterEntrypoints, } from "../helpers/resolve-canisters.js";
@@ -19,7 +19,7 @@ export async function check(files, options = {}) {
     let fileList = Array.isArray(files) ? files : files ? [files] : [];
     const config = readConfig();
     if (fileList.length === 0) {
-        fileList = resolveCanisterEntrypoints(config);
+        fileList = resolveCanisterEntrypoints(config).map(resolveConfigPath);
     }
     if (fileList.length === 0) {
         cliError("No Motoko files specified and no canisters defined in mops.toml.\n" +
@@ -55,7 +55,7 @@ export async function check(files, options = {}) {
             for (const [file, codes] of fixResult.fixedFiles) {
                 const unique = [...new Set(codes)].sort();
                 const n = codes.length;
-                const rel = relative(process.cwd(), file);
+                const rel = path.relative(process.cwd(), file);
                 console.log(chalk.green(`Fixed ${rel} (${n} ${n === 1 ? "fix" : "fixes"}: ${unique.join(", ")})`));
             }
             const fileCount = fixResult.fixedFiles.size;
@@ -96,18 +96,19 @@ export async function check(files, options = {}) {
         if (!canister.main) {
             cliError(`No main file specified for canister '${name}' in mops.toml`);
         }
-        if (!existsSync(stableConfig.path)) {
+        const stablePath = resolveConfigPath(stableConfig.path);
+        if (!existsSync(stablePath)) {
             if (stableConfig.skipIfMissing) {
                 continue;
             }
-            cliError(`Deployed file not found: ${stableConfig.path} (canister '${name}')\n` +
+            cliError(`Deployed file not found: ${stablePath} (canister '${name}')\n` +
                 "Set skipIfMissing = true in [canisters." +
                 name +
                 ".check-stable] to skip this check when the file is missing.");
         }
         await runStableCheck({
-            oldFile: stableConfig.path,
-            canisterMain: canister.main,
+            oldFile: stablePath,
+            canisterMain: resolveConfigPath(canister.main),
             canisterName: name,
             mocPath,
             globalMocArgs,

package/dist/fix-dist.js

@@ -7,3 +7,8 @@ delete json.scripts;
 json.bin.mops = "bin/mops.js";
 json.bin["ic-mops"] = "bin/mops.js";
 writeFileSync("dist/package.json", JSON.stringify(json, null, 2));
+// Route the npm entry point through the Node.js environment wrapper
+// so setWasmBindings() is called before the CLI runs.
+// The source bin/mops.js imports ../cli.js (needed for the single-file bundle),
+// but dist/ has the full directory structure with environments/nodejs/cli.js.
+writeFileSync("dist/bin/mops.js", '#!/usr/bin/env node\n\nimport "../environments/nodejs/cli.js";\n');

package/dist/mops.d.ts

@@ -11,6 +11,11 @@ export declare function setNetwork(network: string): void;
 export declare let getIdentity: () => Promise<Identity | undefined>;
 export declare function getClosestConfigFile(dir?: string): string;
 export declare function getRootDir(): string;
+/**
+ * Resolve a path from mops.toml config (relative to project root)
+ * into a path relative to the current working directory.
+ */
+export declare function resolveConfigPath(configPath: string): string;
 export declare function checkConfigFile(exit?: boolean): boolean;
 export declare function progressBar(step: number, total: number): string;
 export declare function parseGithubURL(href: string): {

package/dist/mops.js

@@ -87,6 +87,13 @@ export function getRootDir() {
     }
     return path.dirname(configFile);
 }
+/**
+ * Resolve a path from mops.toml config (relative to project root)
+ * into a path relative to the current working directory.
+ */
+export function resolveConfigPath(configPath) {
+    return path.relative(process.cwd(), path.resolve(getRootDir(), configPath));
+}
 export function checkConfigFile(exit = false) {
     let configFile = getClosestConfigFile();
     if (!configFile) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ic-mops",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "type": "module",
   "bin": {
     "mops": "bin/mops.js",

package/dist/tests/build.test.js

@@ -1,6 +1,9 @@
 import { describe, expect, test } from "@jest/globals";
+import { execa } from "execa";
+import { existsSync } from "node:fs";
 import path from "path";
 import { cliSnapshot } from "./helpers";
+const distBin = path.resolve(import.meta.dirname, "../dist/bin/mops.js");
 describe("build", () => {
     test("ok", async () => {
         const cwd = path.join(import.meta.dirname, "build/success");
@@ -15,4 +18,19 @@ describe("build", () => {
         expect((await cliSnapshot(["build", "bar"], { cwd }, 1)).stderr).toMatch("Candid compatibility check failed for canister bar");
         expect((await cliSnapshot(["build", "foo", "bar"], { cwd }, 1)).stderr).toMatch("Candid compatibility check failed for canister bar");
     });
+    // Regression: bin/mops.js must route through environments/nodejs/cli.js
+    // so that setWasmBindings() is called before any command runs.
+    // The dev entry point (npm run mops) uses tsx and always worked;
+    // this test exercises the compiled dist binary (same path as npm i -g ic-mops).
+    const hasDistBin = existsSync(distBin);
+    (hasDistBin ? test : test.skip)("wasm bindings initialized via dist entry point", async () => {
+        const cwd = path.join(import.meta.dirname, "build/success");
+        const result = await execa("node", [distBin, "build", "foo"], {
+            cwd,
+            stdio: "pipe",
+            reject: false,
+        });
+        expect(result.stderr).not.toContain("Wasm bindings have not been set");
+        expect(result.exitCode).toBe(0);
+    });
 });

package/dist/tests/check.test.js

@@ -38,6 +38,13 @@ describe("check", () => {
         const cwd = path.join(import.meta.dirname, "check/canisters");
         await cliSnapshot(["check"], { cwd }, 0);
     });
+    test("canister entrypoint resolved relative to config root when run from subdirectory", async () => {
+        const fixtureRoot = path.join(import.meta.dirname, "check/canisters-subdir");
+        const subdir = path.join(fixtureRoot, "src/backend");
+        const result = await cli(["check"], { cwd: subdir });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toMatch(/✓/);
+    });
     test("[moc] args applied when using canister fallback", async () => {
         const cwd = path.join(import.meta.dirname, "check/canisters-moc-args");
         const result = await cli(["check"], { cwd });

package/dist/wasm/pkg/nodejs/wasm_bg.wasm.d.ts

@@ -1,8 +1,8 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
 export const add_custom_sections: (a: number, b: number, c: any) => [number, number, number, number];
+export const is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/dist/wasm/pkg/web/wasm.d.ts

@@ -9,8 +9,8 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
   readonly memory: WebAssembly.Memory;
-  readonly is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
   readonly add_custom_sections: (a: number, b: number, c: any) => [number, number, number, number];
+  readonly is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_malloc: (a: number, b: number) => number;
   readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_exn_store: (a: number) => void;

package/dist/wasm/pkg/web/wasm_bg.wasm.d.ts

@@ -1,8 +1,8 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
 export const add_custom_sections: (a: number, b: number, c: any) => [number, number, number, number];
+export const is_candid_compatible: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/fix-dist.ts

@@ -10,3 +10,12 @@ json.bin.mops = "bin/mops.js";
 json.bin["ic-mops"] = "bin/mops.js";
 
 writeFileSync("dist/package.json", JSON.stringify(json, null, 2));
+
+// Route the npm entry point through the Node.js environment wrapper
+// so setWasmBindings() is called before the CLI runs.
+// The source bin/mops.js imports ../cli.js (needed for the single-file bundle),
+// but dist/ has the full directory structure with environments/nodejs/cli.js.
+writeFileSync(
+  "dist/bin/mops.js",
+  '#!/usr/bin/env node\n\nimport "../environments/nodejs/cli.js";\n',
+);

package/mops.ts

@@ -100,6 +100,14 @@ export function getRootDir() {
   return path.dirname(configFile);
 }
 
+/**
+ * Resolve a path from mops.toml config (relative to project root)
+ * into a path relative to the current working directory.
+ */
+export function resolveConfigPath(configPath: string): string {
+  return path.relative(process.cwd(), path.resolve(getRootDir(), configPath));
+}
+
 export function checkConfigFile(exit = false) {
   let configFile = getClosestConfigFile();
   if (!configFile) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ic-mops",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "type": "module",
   "bin": {
     "mops": "dist/bin/mops.js",

package/tests/build.test.ts

@@ -1,7 +1,11 @@
 import { describe, expect, test } from "@jest/globals";
+import { execa } from "execa";
+import { existsSync } from "node:fs";
 import path from "path";
 import { cliSnapshot } from "./helpers";
 
+const distBin = path.resolve(import.meta.dirname, "../dist/bin/mops.js");
+
 describe("build", () => {
   test("ok", async () => {
     const cwd = path.join(import.meta.dirname, "build/success");
@@ -21,4 +25,24 @@ describe("build", () => {
       (await cliSnapshot(["build", "foo", "bar"], { cwd }, 1)).stderr,
     ).toMatch("Candid compatibility check failed for canister bar");
   });
+
+  // Regression: bin/mops.js must route through environments/nodejs/cli.js
+  // so that setWasmBindings() is called before any command runs.
+  // The dev entry point (npm run mops) uses tsx and always worked;
+  // this test exercises the compiled dist binary (same path as npm i -g ic-mops).
+  const hasDistBin = existsSync(distBin);
+  (hasDistBin ? test : test.skip)(
+    "wasm bindings initialized via dist entry point",
+    async () => {
+      const cwd = path.join(import.meta.dirname, "build/success");
+      const result = await execa("node", [distBin, "build", "foo"], {
+        cwd,
+        stdio: "pipe",
+        reject: false,
+      });
+
+      expect(result.stderr).not.toContain("Wasm bindings have not been set");
+      expect(result.exitCode).toBe(0);
+    },
+  );
 });

package/tests/check/canisters-subdir/mops.toml

@@ -0,0 +1,8 @@
+[toolchain]
+moc = "1.3.0"
+
+[moc]
+args = ["--default-persistent-actors"]
+
+[canisters.backend]
+main = "src/backend/main.mo"

package/tests/check/canisters-subdir/src/backend/main.mo

@@ -0,0 +1,5 @@
+actor {
+  public func hello() : async Text {
+    "Hello, World!";
+  };
+};