arkroute 0.0.1

package/bin/arkroute.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+
+export function platformPackageName(platform = process.platform, arch = process.arch) {
+  const key = `${platform}-${arch}`;
+  switch (key) {
+    case "darwin-arm64":
+      return "@arkroute/darwin-arm64";
+    case "darwin-x64":
+      return "@arkroute/darwin-x64";
+    case "linux-arm64":
+      return "@arkroute/linux-arm64";
+    case "linux-x64":
+      return "@arkroute/linux-x64";
+    case "win32-x64":
+      return "@arkroute/win32-x64";
+    default:
+      throw new Error(`unsupported platform ${key}`);
+  }
+}
+
+export function binaryName(platform = process.platform) {
+  return platform === "win32" ? "arkroute.exe" : "arkroute";
+}
+
+export function resolveBinary(platform = process.platform, arch = process.arch) {
+  const packageName = platformPackageName(platform, arch);
+  const packageJSON = require.resolve(`${packageName}/package.json`);
+  return path.join(path.dirname(packageJSON), "bin", binaryName(platform));
+}
+
+const __filename = fileURLToPath(import.meta.url);
+if (__filename === path.resolve(process.argv[1])) {
+  let binary;
+  try {
+    binary = resolveBinary();
+  } catch (error) {
+    console.error(`Arkroute binary for ${process.platform}-${process.arch} is not installed.`);
+    console.error("Try reinstalling with optional dependencies enabled:");
+    console.error("  npm install -g arkroute");
+    process.exit(1);
+  }
+  const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 0);
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "arkroute",
+  "version": "0.0.1",
+  "description": "Local AI model router for Claude Code and compatible provider gateways",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bloodstalk1/arkroute"
+  },
+  "type": "module",
+  "bin": {
+    "arkroute": "./bin/arkroute.js"
+  },
+  "optionalDependencies": {
+    "@arkroute/darwin-arm64": "0.0.1",
+    "@arkroute/darwin-x64": "0.0.1",
+    "@arkroute/linux-arm64": "0.0.1",
+    "@arkroute/linux-x64": "0.0.1",
+    "@arkroute/win32-x64": "0.0.1"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/test/launcher.test.js

@@ -0,0 +1,43 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { platformPackageName, binaryName, resolveBinary } from "../bin/arkroute.js";
+
+test("platformPackageName resolves supported packages", () => {
+  assert.equal(platformPackageName("darwin", "arm64"), "@arkroute/darwin-arm64");
+  assert.equal(platformPackageName("linux", "x64"), "@arkroute/linux-x64");
+  assert.equal(platformPackageName("win32", "x64"), "@arkroute/win32-x64");
+});
+
+test("platformPackageName rejects unsupported targets", () => {
+  assert.throws(() => platformPackageName("freebsd", "x64"), /unsupported platform/);
+});
+
+test("binaryName appends exe on windows", () => {
+  assert.equal(binaryName("win32"), "arkroute.exe");
+  assert.equal(binaryName("linux"), "arkroute");
+});
+
+test("exports are intact after entrypoint refactor", () => {
+  assert.equal(typeof platformPackageName, "function");
+  assert.equal(typeof binaryName, "function");
+  assert.equal(typeof resolveBinary, "function");
+});
+
+test("platformPackageName handles all supported platforms including win32", () => {
+  // Ensures the win32 platform (which uses backslash paths with spaces)
+  // is still a supported target after the portability fix
+  const winPkg = platformPackageName("win32", "x64");
+  assert.equal(winPkg, "@arkroute/win32-x64");
+  assert.equal(binaryName("win32"), "arkroute.exe");
+
+  // Verify all platforms round-trip correctly
+  const platforms = [
+    ["darwin", "arm64"], ["darwin", "x64"],
+    ["linux", "arm64"], ["linux", "x64"],
+    ["win32", "x64"],
+  ];
+  for (const [plat, arch] of platforms) {
+    const name = platformPackageName(plat, arch);
+    assert.match(name, /^@arkroute\//, `expected scoped package for ${plat}-${arch}`);
+  }
+});

package/test/package-metadata.test.js

@@ -0,0 +1,51 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import test from "node:test";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const npmDir = join(__dirname, "..", "..");
+const repoRoot = join(npmDir, "..");
+const repositoryUrl = "https://github.com/bloodstalk1/arkroute";
+
+const publishedPackageJsonPaths = [
+  join(npmDir, "arkroute", "package.json"),
+  join(npmDir, "platform", "darwin-arm64", "package.json"),
+  join(npmDir, "platform", "darwin-x64", "package.json"),
+  join(npmDir, "platform", "linux-arm64", "package.json"),
+  join(npmDir, "platform", "linux-x64", "package.json"),
+  join(npmDir, "platform", "win32-x64", "package.json"),
+];
+
+test("published npm packages declare the provenance repository", () => {
+  for (const packageJsonPath of publishedPackageJsonPaths) {
+    const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+
+    assert.deepEqual(
+      pkg.repository,
+      { type: "git", url: repositoryUrl },
+      `${pkg.name} must match the GitHub Actions provenance repository`,
+    );
+  }
+});
+
+test("publish workflow uses explicit relative local package paths", () => {
+  const workflow = readFileSync(join(repoRoot, ".github", "workflows", "publish.yml"), "utf8");
+
+  assert.doesNotMatch(
+    workflow,
+    /\bnpm publish npm\//,
+    "npm publish treats npm/... as a package spec on GitHub Actions; use ./npm/...",
+  );
+});
+
+test("publish workflow skips package versions that already exist", () => {
+  const workflow = readFileSync(join(repoRoot, ".github", "workflows", "publish.yml"), "utf8");
+
+  assert.match(
+    workflow,
+    /npm view "\$package@\$\{\s*VERSION\s*\}"/,
+    "workflow must check npm before publishing so reruns do not fail on already-published versions",
+  );
+});