@giovannijecha/jecode 0.1.5-rc.3 → 0.1.6-rc.0

package/README.md

@@ -43,14 +43,20 @@
 
 ## Install
 
-Jecode requires **Node.js 24 or newer** and npm. Release candidates are
-published on the **next** channel:
+Jecode requires **Node.js 24 or newer** and npm:
 
 ~~~console
-npm install --global @giovannijecha/jecode@next
+npm install --global @giovannijecha/jecode
 jecode --version
 ~~~
 
+To try prereleases instead, install the opt-in **next** channel with
+`npm install --global @giovannijecha/jecode@next`.
+
+Published npm packages are the supported installation artifacts. Git URL
+installs are intentionally unsupported: the source tree contains no generated
+runtime and defines no install-time build hook.
+
 Then open the project you want to work on and run Jecode:
 
 ~~~console
@@ -69,10 +75,10 @@ Ubuntu, and macOS.
 
 ### Update
 
-Install the current release candidate over the existing global command:
+Install the current stable release over the existing global command:
 
 ~~~console
-npm install --global @giovannijecha/jecode@next
+npm install --global @giovannijecha/jecode
 jecode --version
 ~~~
 
@@ -99,7 +105,7 @@ report 24 or newer.
 ~~~console
 git clone https://github.com/giovannijecha/jecode.git
 cd jecode
-npm ci
+npm ci --ignore-scripts
 npm run build:release
 npm link
 jecode
@@ -107,7 +113,8 @@ jecode
 
 Development runs TypeScript directly with **npm run start**. **dist/** is an
 ignored, generated tree used only by linked commands and release tarballs.
-**npm pack** and **npm publish** rebuild it from a clean target; installing the
+**npm run pack:release** rebuilds it from a clean target before packing; the
+trusted publish workflow performs the same explicit build. Installing the
 published package runs no compilation or installation scripts.
 
 ## First session
@@ -242,7 +249,7 @@ expectations.
 ## Development
 
 ~~~console
-npm ci
+npm ci --ignore-scripts
 npm run check
 ~~~
 

package/bin/jecode.js

@@ -7,5 +7,15 @@ if (major < 24) {
   );
   process.exitCode = 1;
 } else {
-  await import("../dist/main.js");
+  const runtime = new URL("../dist/main.js", import.meta.url);
+  try {
+    await import(runtime.href);
+  } catch (error) {
+    if (error?.code !== "ERR_MODULE_NOT_FOUND" || error.url !== runtime.href) throw error;
+    process.stderr.write(
+      "jecode's compiled runtime is missing; install @giovannijecha/jecode from npm " +
+      "or run npm run build:release in a source checkout\n",
+    );
+    process.exitCode = 1;
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giovannijecha/jecode",
-  "version": "0.1.5-rc.3",
+  "version": "0.1.6-rc.0",
   "description": "An owned coding agent with zero external runtime dependencies.",
   "license": "MIT",
   "repository": {
@@ -36,18 +36,19 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "prepack": "node dev/build-release.ts --quiet",
     "build:release": "node dev/build-release.ts",
+    "pack:release": "npm run build:release && npm pack --ignore-scripts",
     "start": "node src/main.ts",
     "tui:lab": "node dev/tui-lab.ts",
     "bench:transcript": "node dev/benchmark-transcript.ts",
     "typecheck": "tsc --noEmit",
     "test": "npm run build:release && node --test",
     "coverage": "npm run build:release && node --test --experimental-test-coverage --test-coverage-include=\"src/**/*.ts\" --test-coverage-lines=80 --test-coverage-branches=75 --test-coverage-functions=75",
+    "check:source-tree": "node dev/check-source-tree.ts",
     "check:release-tag": "node dev/check-release-tag.ts",
-    "check:package": "node dev/check-package.ts",
-    "check:install": "node dev/check-installed-cli.ts",
-    "check": "npm run typecheck && npm run coverage && npm run check:package && npm run check:install"
+    "check:package": "npm run build:release -- --quiet && node dev/check-package.ts",
+    "check:install": "npm run build:release -- --quiet && node dev/check-installed-cli.ts",
+    "check": "npm run check:source-tree && npm run typecheck && npm run coverage && npm run check:package && npm run check:install"
   },
   "dependencies": {},
   "devDependencies": {