@nghyane/arcane 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## [0.1.23] - 2026-03-08
+
+### Fixed
+
+- Fix Python setup installing packages into system Python instead of managed venv, causing "kernel unavailable" even after install
+- Fix missing `ensurepip` step when managed venv lacks pip
+- Fix misleading error message to point users to `arcane setup python`
+
+## [0.1.22] - 2026-03-08
+
+### Changed
+
+- Rename edit operation `replace` to `replace_range` for clarity
+
 ## [0.1.21] - 2026-03-05
 
 ### Fixed

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.21",
+	"version": "0.1.23",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/nghyane/arcane",
 	"author": "Can Bölük",

package/src/cli/setup-cli.ts

@@ -160,7 +160,18 @@ async function installPythonPackages(
 	pythonPath: string,
 	uvPath?: string,
 	pipPath?: string,
+	usingManagedEnv?: boolean,
 ): Promise<{ success: boolean; usedManagedEnv: boolean }> {
+	const managedPython = managedPythonPath();
+	const hasManagedEnv = await Bun.file(managedPython).exists();
+
+	// If the managed venv already exists, install directly into it.
+	// resolvePythonRuntime prefers managed venv over system Python,
+	// so installing into system Python would be invisible to the check.
+	if (hasManagedEnv || usingManagedEnv) {
+		return installIntoManagedEnv(packages, pythonPath, uvPath);
+	}
+
 	if (uvPath) {
 		console.log(chalk.dim(`Installing via uv: ${packages.join(" ")}`));
 		const result = await $`${uvPath} pip install ${packages}`.nothrow();
@@ -178,24 +189,35 @@ async function installPythonPackages(
 	}
 
 	console.log(chalk.dim(`Falling back to managed virtual environment: ${MANAGED_PYTHON_ENV}`));
+	return installIntoManagedEnv(packages, pythonPath, uvPath);
+}
+
+async function installIntoManagedEnv(
+	packages: string[],
+	pythonPath: string,
+	uvPath?: string,
+): Promise<{ success: boolean; usedManagedEnv: boolean }> {
+	console.log(chalk.dim(`Installing into managed environment: ${MANAGED_PYTHON_ENV}`));
 
 	if (uvPath) {
-		const createEnv = await $`${uvPath} venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
+		// Ensure venv exists (no-op if already created)
+		await $`${uvPath} venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
+		const result = await $`${uvPath} pip install --python ${MANAGED_PYTHON_ENV} ${packages}`.nothrow();
+		return { success: result.exitCode === 0, usedManagedEnv: true };
+	}
+
+	const managedPython = managedPythonPath();
+	if (!(await Bun.file(managedPython).exists())) {
+		const createEnv = await $`${pythonPath} -m venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
 		if (createEnv.exitCode !== 0) {
 			return { success: false, usedManagedEnv: true };
 		}
-		const installInManagedEnv = await $`${uvPath} pip install --python ${MANAGED_PYTHON_ENV} ${packages}`.nothrow();
-		return { success: installInManagedEnv.exitCode === 0, usedManagedEnv: true };
 	}
 
-	const createEnv = await $`${pythonPath} -m venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
-	if (createEnv.exitCode !== 0) {
-		return { success: false, usedManagedEnv: true };
-	}
-
-	const managedPython = managedPythonPath();
-	const installInManagedEnv = await $`${managedPython} -m pip install ${packages}`.nothrow();
-	return { success: installInManagedEnv.exitCode === 0, usedManagedEnv: true };
+	// Ensure pip is available in the managed env
+	await $`${managedPython} -m ensurepip`.quiet().nothrow();
+	const result = await $`${managedPython} -m pip install ${packages}`.nothrow();
+	return { success: result.exitCode === 0, usedManagedEnv: true };
 }
 
 /**
@@ -258,7 +280,13 @@ async function handlePythonSetup(flags: { json?: boolean; check?: boolean }): Pr
 	}
 
 	console.log("");
-	const install = await installPythonPackages(check.missingPackages, check.pythonPath, check.uvPath, check.pipPath);
+	const install = await installPythonPackages(
+		check.missingPackages,
+		check.pythonPath,
+		check.uvPath,
+		check.pipPath,
+		check.usingManagedEnv,
+	);
 
 	if (!install.success) {
 		console.error(chalk.red(`\n${theme.status.error} Installation failed`));

package/src/ipy/kernel.ts

@@ -129,8 +129,7 @@ export async function checkPythonKernelAvailability(cwd: string): Promise<Python
 		return {
 			ok: false,
 			pythonPath: runtime.pythonPath,
-			reason:
-				"kernel_gateway (jupyter-kernel-gateway) or ipykernel not installed. Run: python -m pip install jupyter_kernel_gateway ipykernel",
+			reason: "kernel_gateway (jupyter-kernel-gateway) or ipykernel not installed. Run: arcane setup python",
 		};
 	} catch (err: unknown) {
 		return { ok: false, reason: err instanceof Error ? err.message : String(err) };

package/src/patch/edit-tool.ts

@@ -314,10 +314,10 @@ export class EditTool implements AgentTool<TInput, any, Theme> {
 						});
 						break;
 					}
-					case "replace": {
+					case "replace_range": {
 						const { first, last, content } = edit;
 						anchorEdits.push({
-							op: "replace",
+							op: "replace_range",
 							first: parseTag(first),
 							last: parseTag(last),
 							content: hashlineParseContent(content),
@@ -419,7 +419,7 @@ export class EditTool implements AgentTool<TInput, any, Theme> {
 							case "set":
 								refs.push(edit.tag);
 								break;
-							case "replace":
+							case "replace_range":
 								refs.push(edit.first, edit.last);
 								break;
 							case "append":

package/src/patch/hashline.ts

@@ -17,7 +17,7 @@ import type { HashMismatch } from "./types";
 export type LineTag = { line: number; hash: string };
 export type HashlineEdit =
 	| { op: "set"; tag: LineTag; content: string[] }
-	| { op: "replace"; first: LineTag; last: LineTag; content: string[] }
+	| { op: "replace_range"; first: LineTag; last: LineTag; content: string[] }
 	| { op: "append"; after?: LineTag; content: string[] }
 	| { op: "prepend"; before?: LineTag; content: string[] }
 	| { op: "insert"; after: LineTag; before: LineTag; content: string[] };
@@ -647,7 +647,7 @@ export function applyHashlineEdits(
 				case "set":
 					touched.add(edit.tag.line);
 					break;
-				case "replace":
+				case "replace_range":
 					for (let ln = edit.first.line; ln <= edit.last.line; ln++) touched.add(ln);
 					break;
 				case "append":
@@ -715,7 +715,7 @@ export function applyHashlineEdits(
 				if (!afterValid || !beforeValid) continue;
 				break;
 			}
-			case "replace": {
+			case "replace_range": {
 				if (edit.first.line > edit.last.line) {
 					throw new Error(`Range start line ${edit.first.line} must be <= end line ${edit.last.line}`);
 				}
@@ -740,7 +740,7 @@ export function applyHashlineEdits(
 			case "set":
 				lineKey = `s:${edit.tag.line}`;
 				break;
-			case "replace":
+			case "replace_range":
 				lineKey = `r:${edit.first.line}:${edit.last.line}`;
 				break;
 			case "append":
@@ -783,7 +783,7 @@ export function applyHashlineEdits(
 				sortLine = edit.tag.line;
 				precedence = 0;
 				break;
-			case "replace":
+			case "replace_range":
 				sortLine = edit.last.line;
 				precedence = 0;
 				break;
@@ -850,7 +850,7 @@ export function applyHashlineEdits(
 				trackFirstChanged(edit.tag.line);
 				break;
 			}
-			case "replace": {
+			case "replace_range": {
 				const count = edit.last.line - edit.first.line + 1;
 				const origLines = originalFileLines.slice(edit.first.line - 1, edit.first.line - 1 + count);
 				let stripped = autocorrect

package/src/patch/schemas.ts

@@ -133,7 +133,7 @@ const hashlinePrependEditSchema = Type.Object(
 
 const hashlineRangeEditSchema = Type.Object(
 	{
-		op: Type.Literal("replace"),
+		op: Type.Literal("replace_range"),
 		first: hashlineTagFormat("first line"),
 		last: hashlineTagFormat("last line"),
 		content: hashlineReplaceContentFormat("Replacement"),