@giovannijecha/jecode 0.0.0-stage → 0.1.1

package/LICENSE

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

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# Jecode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Jecode is a terminal coding agent. It runs as a native Rust executable and lets
+you work with an AI model on files and commands in your project.
+
+![Jecode 0.1.0 startup screen in Windows Terminal](https://raw.githubusercontent.com/giovannijecha/jecode/main/docs/images/jecode-startup.png)
+
+Install Jecode with Node.js 22 or later and npm:
+
+```sh
+npm install -g @giovannijecha/jecode
+jecode --version
+```
+
+The npm package supports Windows x64, Linux x64 with glibc 2.39 or newer, and
+macOS on Apple silicon (verified on macOS 15). Earlier macOS versions remain
+unverified. It includes the platform executables; it does not build code or fetch
+a binary when you first run it. Node.js starts the npm command. A standalone
+build of Jecode does not need Node.js.
+
+Update the npm installation with:
+
+```sh
+npm update -g @giovannijecha/jecode
+```
+
+Remove it with:
+
+```sh
+npm uninstall -g @giovannijecha/jecode
+```
+
+Removing the package keeps your settings, accounts, conversations, and
+checkpoints in `~/.jecode/` or your `JECODE_HOME` directory. If you previously
+installed Jecode from source, check which `jecode` command appears first on
+`PATH`; npm does not remove that separate installation.
+
+See the [installation guide](https://github.com/giovannijecha/jecode/blob/main/docs/usage/INSTALLATION.md)
+for source installation and troubleshooting, and the [command-line guide](https://github.com/giovannijecha/jecode/blob/main/docs/usage/CLI.md)
+for usage.

package/bin/jecode.cjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('node:child_process');
+const { existsSync } = require('node:fs');
+const { constants } = require('node:os');
+const path = require('node:path');
+const { targetFor } = require('./targets.cjs');
+
+function signalExitCode(signal) {
+  const number = constants.signals[signal];
+  return Number.isInteger(number) ? 128 + number : 1;
+}
+
+function glibcMeetsMinimum(version, minimum) {
+  if (!/^\d+\.\d+$/.test(version)) return false;
+  const [major, minor] = version.split('.').map(Number);
+  const [requiredMajor, requiredMinor] = minimum.split('.').map(Number);
+  return major > requiredMajor || (major === requiredMajor && minor >= requiredMinor);
+}
+
+function launch({
+  runtime = process,
+  packageRoot = path.resolve(__dirname, '..'),
+  spawnChild = spawn,
+  binaryExists = existsSync,
+} = {}) {
+  const target = targetFor(runtime.platform, runtime.arch);
+  if (!target) {
+    runtime.stderr.write(
+      `jecode: unsupported platform ${runtime.platform}-${runtime.arch}. ` +
+      'Supported: win32-x64, linux-x64, darwin-arm64.\n',
+    );
+    runtime.exitCode = 1;
+    return null;
+  }
+
+  if (runtime.platform === 'linux') {
+    let glibc;
+    try {
+      glibc = runtime.report?.getReport()?.header?.glibcVersionRuntime;
+    } catch {
+      // An unreadable diagnostic report cannot establish libc compatibility.
+    }
+    if (typeof glibc !== 'string' || !glibcMeetsMinimum(glibc, target.glibcMinimum)) {
+      const detail = glibc ? `glibc ${glibc} is too old or unrecognized` : 'unsupported Linux libc';
+      runtime.stderr.write(
+        `jecode: ${detail}; requires glibc ${target.glibcMinimum} or newer.\n`,
+      );
+      runtime.exitCode = 1;
+      return null;
+    }
+  }
+
+  const executable = path.join(packageRoot, 'native', target.key, target.binary);
+  if (!binaryExists(executable)) {
+    runtime.stderr.write(
+      `jecode: missing native executable for ${target.key}. ` +
+      'Reinstall the npm package and check its contents.\n',
+    );
+    runtime.exitCode = 1;
+    return null;
+  }
+
+  let child;
+  try {
+    child = spawnChild(executable, runtime.argv.slice(2), {
+      stdio: 'inherit',
+      shell: false,
+    });
+  } catch (error) {
+    runtime.stderr.write(`jecode: could not start ${target.key}: ${error.message}\n`);
+    runtime.exitCode = 1;
+    return null;
+  }
+
+  let spawnError = false;
+  const onInterrupt = () => {
+    // The terminal sends Ctrl+C to the foreground group. The child already
+    // receives it; forwarding here could interrupt it twice or kill it on Windows.
+  };
+  const onTerminate = () => child.kill('SIGTERM');
+  const onHangup = () => child.kill('SIGHUP');
+  runtime.on('SIGINT', onInterrupt);
+  runtime.on('SIGTERM', onTerminate);
+  if (runtime.platform !== 'win32') runtime.on('SIGHUP', onHangup);
+
+  child.on('error', (error) => {
+    spawnError = true;
+    runtime.stderr.write(`jecode: could not start ${target.key}: ${error.message}\n`);
+    runtime.exitCode = 1;
+  });
+  child.on('close', (code, signal) => {
+    runtime.removeListener('SIGINT', onInterrupt);
+    runtime.removeListener('SIGTERM', onTerminate);
+    if (runtime.platform !== 'win32') runtime.removeListener('SIGHUP', onHangup);
+    if (!spawnError) runtime.exitCode = signal ? signalExitCode(signal) : (code ?? 1);
+  });
+  return child;
+}
+
+if (require.main === module) launch();
+
+module.exports = { launch, signalExitCode };

package/bin/targets.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+const targets = Object.freeze({
+  'win32-x64': Object.freeze({
+    platform: 'win32',
+    arch: 'x64',
+    binary: 'jecode.exe',
+    identity: 'windows-x86_64',
+  }),
+  'linux-x64': Object.freeze({
+    platform: 'linux',
+    arch: 'x64',
+    binary: 'jecode',
+    identity: 'linux-x86_64',
+    glibcMinimum: '2.39',
+  }),
+  'darwin-arm64': Object.freeze({
+    platform: 'darwin',
+    arch: 'arm64',
+    binary: 'jecode',
+    identity: 'macos-aarch64',
+  }),
+});
+
+function targetFor(platform, arch) {
+  const key = `${platform}-${arch}`;
+  return Object.hasOwn(targets, key) ? { key, ...targets[key] } : null;
+}
+
+module.exports = { targets, targetFor };

package/native/manifest.json

@@ -0,0 +1,48 @@
+{
+  "format": 1,
+  "version": "0.1.1",
+  "revision": "88eed41a3fd300abeb055c4c3003a2527a5cb6ae",
+  "artifacts": [
+    {
+      "format": 1,
+      "version": "0.1.1",
+      "revision": "88eed41a3fd300abeb055c4c3003a2527a5cb6ae",
+      "sourceClean": true,
+      "target": "win32-x64",
+      "binary": "jecode.exe",
+      "bytes": 10546176,
+      "sha256": "0f9eae436df40ea070bb9c19772a19f8aa1105af7f213d4f80c691f957aecccc"
+    },
+    {
+      "format": 1,
+      "version": "0.1.1",
+      "revision": "88eed41a3fd300abeb055c4c3003a2527a5cb6ae",
+      "sourceClean": true,
+      "target": "linux-x64",
+      "binary": "jecode",
+      "bytes": 13698608,
+      "sha256": "53c04df261466e1dfba4189fc7f162a0e66f23334843a819434f9a461ff78e74",
+      "glibcMinimum": "2.39",
+      "abiCheckedFiles": [
+        "jecode",
+        "jecode-clipboard_linux",
+        "jecode-http",
+        "jecode-openai_crypto",
+        "jecode-process_unix",
+        "jecode-pty_unix",
+        "jecode-shell",
+        "jecode-terminal_unix"
+      ]
+    },
+    {
+      "format": 1,
+      "version": "0.1.1",
+      "revision": "88eed41a3fd300abeb055c4c3003a2527a5cb6ae",
+      "sourceClean": true,
+      "target": "darwin-arm64",
+      "binary": "jecode",
+      "bytes": 8342640,
+      "sha256": "39a7269f3d75aaf995f64400b1ed4905adf628d221d4fb8a271e0a298009bc6e"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@giovannijecha/jecode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "A terminal coding agent in Rust",
+  "license": "MIT",
+  "author": "Giovanni Jecha",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/giovannijecha/jecode.git"
+  },
+  "homepage": "https://github.com/giovannijecha/jecode#readme",
+  "bugs": {
+    "url": "https://github.com/giovannijecha/jecode/issues"
+  },
+  "bin": {
+    "jecode": "bin/jecode.cjs"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "os": [
+    "win32",
+    "linux",
+    "darwin"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "native/"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}