@chadsly/knit 0.1.3

package/README.md

@@ -0,0 +1,34 @@
+# `@chadsly/knit`
+
+`@chadsly/knit` installs the host-specific Knit daemon from bundled release artifacts and exposes it through the `knit` command.
+
+Install:
+
+```bash
+npm install -g @chadsly/knit
+```
+
+Start Knit:
+
+```bash
+knit start
+```
+
+Other commands:
+
+- `knit path`
+- `knit version`
+
+What happens on install:
+
+- `postinstall` selects the archive for the current OS and CPU
+- verifies it against the bundled release manifest
+- extracts the native daemon into the package runtime directory
+
+Supported platforms:
+
+- macOS: `x64`, `arm64`
+- Linux: `x64`, `arm64`
+- Windows: `x64`
+
+When you run `knit start`, the native daemon prints the local UI URL. Knit’s browser extension and main review UI still live outside this npm wrapper; this package is only the daemon/runtime install path.

package/artifacts/checksums.txt

@@ -0,0 +1,10 @@
+6a45d89f7773bf9547385c1f45173039e32e60976526228285a4c0f326f61609  /home/runner/work/knit/knit/dist-ci/packages/installers/knit_0.1.3_darwin_amd64.install.command
+1e8141748f53201b7de63561c6ac6862e49bb1e2888fa7367b79151d4f1f9fcc  /home/runner/work/knit/knit/dist-ci/packages/installers/knit_0.1.3_darwin_arm64.install.command
+057470c0667c130a09a26322004905d211734df19440146e41e608b12a80a129  /home/runner/work/knit/knit/dist-ci/packages/installers/knit_0.1.3_linux_amd64.install.sh
+3429a3ff4bbd4fd218356ce3fb43ae5b12b3fd0215e8672a058c26c1f952616a  /home/runner/work/knit/knit/dist-ci/packages/installers/knit_0.1.3_linux_arm64.install.sh
+df3c3c6c7ed2e6c81ed529eb45e61052eafe52f17f7b7fc7a0bcd7662f362e2a  /home/runner/work/knit/knit/dist-ci/packages/installers/knit_0.1.3_windows_amd64.install.ps1
+3b557f02cfbf0d0830dc1af91d333c093ee83f00be27cd7b64f068eb62ff3ee1  /home/runner/work/knit/knit/dist-ci/packages/knit_0.1.3_darwin_amd64.tar.gz
+693de12510597391332fecf18d0579ae350d6e2d71bdae8d62eac26af46ec5a0  /home/runner/work/knit/knit/dist-ci/packages/knit_0.1.3_darwin_arm64.tar.gz
+edb1f751c9db3114d35d68eca130bb516c316b9e972da2951715bb2a1692073d  /home/runner/work/knit/knit/dist-ci/packages/knit_0.1.3_linux_amd64.tar.gz
+8bef9284f505ab76dfd11b7cd86f1b8c80869cce8de414d44f5aaec41722795b  /home/runner/work/knit/knit/dist-ci/packages/knit_0.1.3_linux_arm64.tar.gz
+2cbc44bd20e22e185538c5a8bb8c83b6065969f542ce9463302f8e365bd857f9  /home/runner/work/knit/knit/dist-ci/packages/knit_0.1.3_windows_amd64.zip

package/artifacts/release-manifest.json

@@ -0,0 +1,21 @@
+{
+  "version": "0.1.3",
+  "source_date_epoch": "0",
+  "checksums_file": "checksums.txt",
+  "signed_checksums": true,
+  "has_build_manifest": true,
+  "has_sbom": true,
+  "has_dependency_scan": true,
+  "artifacts": [
+    {"sha256":"6a45d89f7773bf9547385c1f45173039e32e60976526228285a4c0f326f61609","path":"installers/knit_0.1.3_darwin_amd64.install.command"},
+    {"sha256":"1e8141748f53201b7de63561c6ac6862e49bb1e2888fa7367b79151d4f1f9fcc","path":"installers/knit_0.1.3_darwin_arm64.install.command"},
+    {"sha256":"057470c0667c130a09a26322004905d211734df19440146e41e608b12a80a129","path":"installers/knit_0.1.3_linux_amd64.install.sh"},
+    {"sha256":"3429a3ff4bbd4fd218356ce3fb43ae5b12b3fd0215e8672a058c26c1f952616a","path":"installers/knit_0.1.3_linux_arm64.install.sh"},
+    {"sha256":"df3c3c6c7ed2e6c81ed529eb45e61052eafe52f17f7b7fc7a0bcd7662f362e2a","path":"installers/knit_0.1.3_windows_amd64.install.ps1"},
+    {"sha256":"3b557f02cfbf0d0830dc1af91d333c093ee83f00be27cd7b64f068eb62ff3ee1","path":"knit_0.1.3_darwin_amd64.tar.gz"},
+    {"sha256":"693de12510597391332fecf18d0579ae350d6e2d71bdae8d62eac26af46ec5a0","path":"knit_0.1.3_darwin_arm64.tar.gz"},
+    {"sha256":"edb1f751c9db3114d35d68eca130bb516c316b9e972da2951715bb2a1692073d","path":"knit_0.1.3_linux_amd64.tar.gz"},
+    {"sha256":"8bef9284f505ab76dfd11b7cd86f1b8c80869cce8de414d44f5aaec41722795b","path":"knit_0.1.3_linux_arm64.tar.gz"},
+    {"sha256":"2cbc44bd20e22e185538c5a8bb8c83b6065969f542ce9463302f8e365bd857f9","path":"knit_0.1.3_windows_amd64.zip"}
+  ]
+}

package/bin/knit-daemon.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+const { ensureInstalled, runtimeDirForPackage, daemonBinaryPath, packageRoot } = require("../lib/install");
+
+function usage() {
+  process.stdout.write("Usage: knit <start|path|version> [args...]\n");
+}
+
+function main() {
+  const command = process.argv[2] || "start";
+  if (command === "version") {
+    const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot(), "package.json"), "utf8"));
+    process.stdout.write(String(pkg.version || "") + "\n");
+    return;
+  }
+  if (command === "path") {
+    ensureInstalled();
+    process.stdout.write(daemonBinaryPath(runtimeDirForPackage()) + "\n");
+    return;
+  }
+  if (command !== "start") {
+    usage();
+    process.exitCode = 1;
+    return;
+  }
+  ensureInstalled();
+  const bin = daemonBinaryPath(runtimeDirForPackage());
+  const args = process.argv.slice(3);
+  const child = spawnSync(bin, args, { stdio: "inherit", env: process.env });
+  if (typeof child.status === "number") {
+    process.exitCode = child.status;
+  } else if (child.error) {
+    throw child.error;
+  }
+}
+
+main();

package/lib/install.js

@@ -0,0 +1,105 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const crypto = require("node:crypto");
+const { spawnSync } = require("node:child_process");
+
+function packageRoot() {
+  return path.resolve(__dirname, "..");
+}
+
+function runtimeDirForPackage() {
+  return path.join(packageRoot(), "artifacts", "runtime");
+}
+
+function hostTarget() {
+  const platform = process.platform;
+  const archMap = { x64: "amd64", arm64: "arm64" };
+  const arch = archMap[process.arch];
+  if (!arch) {
+    throw new Error(`Unsupported architecture: ${process.arch}`);
+  }
+  if (!["darwin", "linux", "win32"].includes(platform)) {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+  const os = platform === "win32" ? "windows" : platform;
+  return `${os}_${arch}`;
+}
+
+function packageManifest() {
+  const raw = fs.readFileSync(path.join(packageRoot(), "artifacts", "release-manifest.json"), "utf8");
+  return JSON.parse(raw);
+}
+
+function archivePathForTarget() {
+  const target = hostTarget();
+  const manifest = packageManifest();
+  const suffix = target.startsWith("windows_") ? ".zip" : ".tar.gz";
+  const archive = (manifest.artifacts || []).find((item) => String(item.path || "").includes(`_${target}${suffix}`));
+  if (!archive) {
+    throw new Error(`No packaged archive found for target ${target}`);
+  }
+  return {
+    target,
+    relPath: String(archive.path),
+    sha256: String(archive.sha256 || "")
+  };
+}
+
+function verifyArchive(absPath, expectedSHA256) {
+  const actual = crypto.createHash("sha256").update(fs.readFileSync(absPath)).digest("hex");
+  if (actual !== expectedSHA256) {
+    throw new Error(`Archive checksum mismatch for ${path.basename(absPath)}`);
+  }
+}
+
+function extractArchive(absArchive, outDir) {
+  fs.rmSync(outDir, { recursive: true, force: true });
+  fs.mkdirSync(outDir, { recursive: true });
+  if (absArchive.endsWith(".zip")) {
+    const ps = spawnSync("powershell", [
+      "-NoProfile",
+      "-Command",
+      `Expand-Archive -Force -Path '${absArchive.replace(/'/g, "''")}' -DestinationPath '${outDir.replace(/'/g, "''")}'`
+    ], { stdio: "pipe" });
+    if (ps.status !== 0) {
+      throw new Error(ps.stderr.toString() || "Expand-Archive failed");
+    }
+    return;
+  }
+  const tar = spawnSync("tar", ["-xzf", absArchive, "-C", outDir], { stdio: "pipe" });
+  if (tar.status !== 0) {
+    throw new Error(tar.stderr.toString() || "tar extraction failed");
+  }
+}
+
+function daemonBinaryPath(runtimeDir) {
+  return path.join(runtimeDir, process.platform === "win32" ? "daemon.exe" : "daemon");
+}
+
+function ensureInstalled(force = false) {
+  const runtimeDir = runtimeDirForPackage();
+  const daemonPath = daemonBinaryPath(runtimeDir);
+  if (!force && fs.existsSync(daemonPath)) {
+    return runtimeDir;
+  }
+  const archive = archivePathForTarget();
+  const absArchive = path.join(packageRoot(), "artifacts", archive.relPath);
+  verifyArchive(absArchive, archive.sha256);
+  extractArchive(absArchive, runtimeDir);
+  if (!fs.existsSync(daemonPath)) {
+    throw new Error(`Daemon binary missing after extraction: ${daemonPath}`);
+  }
+  return runtimeDir;
+}
+
+if (require.main === module) {
+  ensureInstalled();
+}
+
+module.exports = {
+  ensureInstalled,
+  runtimeDirForPackage,
+  daemonBinaryPath,
+  hostTarget,
+  packageRoot
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@chadsly/knit",
+  "version": "0.1.3",
+  "description": "Install and run the local Knit daemon from bundled release artifacts.",
+  "license": "MIT",
+  "private": false,
+  "homepage": "https://github.com/chadsly/knit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chadsly/knit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chadsly/knit/issues"
+  },
+  "keywords": [
+    "knit",
+    "daemon",
+    "desktop",
+    "agent",
+    "feedback",
+    "review"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "bin": {
+    "knit": "bin/knit-daemon.js"
+  },
+  "scripts": {
+    "postinstall": "node ./lib/install.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "artifacts/",
+    "README.md"
+  ]
+}