kino-cli 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# kino-cli
 
-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.
+kino learns a codebase and its tools, then works as one of the team's developers by running processes
+(ticket to PR, review loops, and more). It includes **kino-code**, a coding agent that runs on any model.
+
+```bash
+npx kino-cli            # open the kino shell in this folder
+npx kino-cli init       # set kino up for this repository
+npx kino-cli code -p "fix the off-by-one in pagination and add a test"
+npm i -g kino-cli       # then just: kino
+```
+
+This package carries kino compiled for macOS, Linux and Windows and runs it with [uv](https://docs.astral.sh/uv),
+which fetches Python 3.12 and kino's dependencies on the first run and caches them. If uv is missing it is installed
+for you (set `KINO_NO_UV_INSTALL=1` to refuse, or `KINO_UV=/path/to/uv` to pick one). Node 18+.

package/bin/kino.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// kino is a compiled Python extension; this launcher runs the wheel for this platform, shipped inside this package, with uv
+// (https://docs.astral.sh/uv), which fetches a suitable Python and kino's dependencies once and caches them.
+// If uv is missing it is installed with its official script, unless KINO_NO_UV_INSTALL=1.
+"use strict";
+
+const { spawn, spawnSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const isWindows = process.platform === "win32";
+const exe = isWindows ? "uv.exe" : "uv";
+
+// The compiled wheel for this platform (kino ships compiled, one wheel per OS and CPU).
+const TAGS = {
+  "darwin-arm64": "macosx_11_0_arm64",
+  "darwin-x64": "macosx_11_0_x86_64",
+  "linux-x64": "linux_x86_64",
+  "linux-arm64": "linux_aarch64",
+  "win32-x64": "win_amd64",
+};
+
+function wheelPath() {
+  const platform = `${process.platform}-${process.arch}`;
+  const tag = TAGS[platform];
+  const dist = path.join(__dirname, "..", "dist");
+  const wheel = tag && fs.existsSync(dist) && fs.readdirSync(dist).find((f) => f.endsWith(`-${tag}.whl`));
+  if (!wheel) {
+    console.error(`kino-cli: no build for ${platform} in this package`);
+    process.exit(1);
+  }
+  return path.join(dist, wheel);
+}
+
+function works(uv) {
+  try {
+    return spawnSync(uv, ["--version"], { stdio: "ignore" }).status === 0;
+  } catch {
+    return false;
+  }
+}
+
+function findUv() {
+  const home = os.homedir();
+  const candidates = [
+    process.env.KINO_UV,
+    "uv",
+    path.join(home, ".local", "bin", exe),
+    path.join(home, ".cargo", "bin", exe),
+    process.env.XDG_BIN_HOME && path.join(process.env.XDG_BIN_HOME, exe),
+  ].filter(Boolean);
+  return candidates.find(works);
+}
+
+function installUv() {
+  if (process.env.KINO_NO_UV_INSTALL === "1") {
+    console.error("kino-cli needs uv: install it from https://docs.astral.sh/uv/getting-started/installation/");
+    process.exit(1);
+  }
+  console.error("kino-cli: installing uv (https://docs.astral.sh/uv), which runs kino's Python…");
+  const result = isWindows
+    ? spawnSync("powershell", ["-ExecutionPolicy", "ByPass", "-c", "irm https://astral.sh/uv/install.ps1 | iex"], {
+        stdio: ["ignore", "inherit", "inherit"],
+      })
+    : spawnSync("sh", ["-c", "curl -LsSf https://astral.sh/uv/install.sh | sh"], {
+        stdio: ["ignore", "inherit", "inherit"],
+      });
+  if (result.status !== 0) {
+    console.error("kino-cli: installing uv failed; install it by hand: https://docs.astral.sh/uv/");
+    process.exit(1);
+  }
+  const uv = findUv();
+  if (!uv) {
+    console.error("kino-cli: uv was installed but is not on PATH yet; open a new terminal and run kino again");
+    process.exit(1);
+  }
+  return uv;
+}
+
+const uv = findUv() || installUv();
+const args = ["tool", "run", "--quiet", "--python", "3.12", "--from", wheelPath(), "kino", ...process.argv.slice(2)];
+const child = spawn(uv, args, { stdio: "inherit" });
+// The terminal sends Ctrl-C to kino directly (same process group); the launcher just waits for it.
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    if (signal !== "SIGINT") child.kill(signal);
+  });
+}
+child.on("error", (err) => {
+  console.error(`kino-cli: could not run uv: ${err.message}`);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 1);
+});

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "kino-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "kino: an agent that learns your codebase and tools, then works as one of the team's developers. Includes kino-code, a coding agent on any model.",
+  "bin": {
+    "kino": "bin/kino.js"
+  },
+  "files": [
+    "bin/",
+    "dist/*.whl",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DogukanGun/kino.git"
+  },
+  "keywords": [
+    "agent",
+    "coding-agent",
+    "cli",
+    "bpmn",
+    "claude",
+    "openai"
+  ],
+  "license": "UNLICENSED",
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}