@netnodeag/kraftwerk 0.37.0 → 0.37.1

package/dist/cli/projects.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import chalk from "chalk";
+import { absolutePath } from "../config.js";
 import Table from "cli-table3";
 import { discoverWorkspaces, forgetProject, startProject, stopProject, tildify, } from "../inspector/instances.js";
 /**
@@ -43,7 +44,7 @@ const status = (e) => {
 /** Match a ref against known workspaces; `needRoot` excludes rootless live instances (start/forget need a root). */
 async function resolveRef(ref, needRoot = true) {
     const all = (await discoverWorkspaces()).filter((e) => e.root || !needRoot);
-    const abs = path.resolve(ref);
+    const abs = absolutePath(ref);
     const port = /^\d+$/.test(ref) ? `http://localhost:${ref}` : `http://${ref.replace(/^https?:\/\//, "")}`;
     const hits = all.filter((e) => e.root === abs ||
         e.root === ref ||

package/dist/cli/ui.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn, spawnSync } from "node:child_process";
 import chalk from "chalk";
-import { resolveProject } from "../config.js";
+import { absolutePath, resolveProject } from "../config.js";
 import { selfCommand } from "../inspector/self-command.js";
 import { RESTART_EXIT_CODE, startInspector } from "../inspector/server.js";
 /**
@@ -52,7 +52,7 @@ export async function runUi(cwd, opts) {
         return superviseUi(opts);
     const staticDir = ensureBuilt();
     const project = await resolveProject(cwd);
-    const outputDir = opts.output ? path.resolve(cwd, opts.output) : project.outputDir;
+    const outputDir = opts.output ? absolutePath(opts.output, cwd) : project.outputDir;
     // Port precedence: --port flag > kraftwerk.yml `port` > 1981.
     const port = opts.port ? Number(opts.port) : (project.config.port ?? 1981);
     await startInspector({ outputDir, staticDir, port, projectRoot: project.root });

package/dist/config.d.ts

@@ -120,6 +120,14 @@ export interface Project {
     outputDir: string;
 }
 /** True when the path exists and is a directory. */
+/**
+ * A user-supplied path as an absolute one: a leading `~` is the home
+ * directory (shells expand it, JSON bodies and quoted args do not), then
+ * path.resolve. Every path that gets stored or compared — registry roots,
+ * `--output`, project refs — goes through here so nothing ever persists
+ * `~/…` or `<cwd>/~/…`.
+ */
+export declare function absolutePath(p: string, from?: string): string;
 export declare const isDir: (p: string) => Promise<boolean>;
 /**
  * Resolve the project for a cwd: walk up until a kraftwerk.yml or a

package/dist/config.js

@@ -1,4 +1,5 @@
 import { readFile, stat } from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 import { parse } from "yaml";
 /**
@@ -63,6 +64,18 @@ export function gitignoreHas(text, entry) {
 }
 const exists = async (p) => !!(await stat(p).catch(() => null));
 /** True when the path exists and is a directory. */
+/**
+ * A user-supplied path as an absolute one: a leading `~` is the home
+ * directory (shells expand it, JSON bodies and quoted args do not), then
+ * path.resolve. Every path that gets stored or compared — registry roots,
+ * `--output`, project refs — goes through here so nothing ever persists
+ * `~/…` or `<cwd>/~/…`.
+ */
+export function absolutePath(p, from = process.cwd()) {
+    if (p === "~" || p.startsWith("~/") || p.startsWith("~\\"))
+        p = path.join(os.homedir(), p.slice(1));
+    return path.resolve(from, p);
+}
 export const isDir = async (p) => (await stat(p).catch(() => null))?.isDirectory() ?? false;
 async function findConfigFile(dir) {
     for (const name of CONFIG_FILENAMES) {

package/dist/inspector/instances.js

@@ -3,7 +3,7 @@ import { createHash } from "node:crypto";
 import fsSync, { promises as fs } from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { isDir, resolveProject } from "../config.js";
+import { absolutePath, isDir, resolveProject } from "../config.js";
 import { selfCommand } from "./self-command.js";
 /**
  * Two registries under ~/.kraftwerk, two lifecycles:
@@ -31,7 +31,7 @@ const LOGS_DIR = path.join(HOME, "logs");
 const selfFile = () => path.join(INSTANCES_DIR, `${process.pid}.json`);
 let selfPort = null;
 let selfRoot = null;
-const projectKey = (root) => createHash("sha1").update(path.resolve(root)).digest("hex").slice(0, 16);
+const projectKey = (root) => createHash("sha1").update(absolutePath(root)).digest("hex").slice(0, 16);
 const projectFile = (root) => path.join(PROJECTS_DIR, `${projectKey(root)}.json`);
 /** ~/… for display. */
 export const tildify = (p) => {
@@ -42,7 +42,7 @@ export const tildify = (p) => {
 /** Write this instance's registry file (call once the server listens). */
 export async function registerInstance(port, root) {
     selfPort = port;
-    selfRoot = path.resolve(root);
+    selfRoot = absolutePath(root);
     try {
         await fs.mkdir(INSTANCES_DIR, { recursive: true });
         const rec = { pid: process.pid, port, startedAt: new Date().toISOString(), root: selfRoot };
@@ -151,7 +151,7 @@ async function readProject(file) {
 }
 /** Upsert the project record for a root (call on every inspector start). */
 export async function registerProject(root) {
-    const abs = path.resolve(root);
+    const abs = absolutePath(root);
     const now = new Date().toISOString();
     try {
         await fs.mkdir(PROJECTS_DIR, { recursive: true });
@@ -395,7 +395,7 @@ export async function listWorkspacesDetailed() {
  * straight to it.
  */
 export async function startProject(root) {
-    const abs = path.resolve(root);
+    const abs = absolutePath(root);
     const { name, port, exists } = await describeRoot(abs);
     if (!exists)
         return { ok: false, error: `not a project directory (missing or moved): ${abs}` };
@@ -464,12 +464,12 @@ export async function startProject(root) {
  * that registered no root. Waits up to ~5s for the port to go quiet.
  */
 export async function stopProject(target) {
-    if (target.root && path.resolve(target.root) === selfRoot) {
+    if (target.root && absolutePath(target.root) === selfRoot) {
         return { ok: false, error: "that is this workspace — stop it from its own terminal or pid" };
     }
     cache = wsCache = null;
     const live = await discoverInstances();
-    const inst = live.find((i) => (target.root && i.root === path.resolve(target.root)) || (target.url && i.url === target.url));
+    const inst = live.find((i) => (target.root && i.root === absolutePath(target.root)) || (target.url && i.url === target.url));
     if (!inst)
         return { ok: false, error: "not running" };
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netnodeag/kraftwerk",
-  "version": "0.37.0",
+  "version": "0.37.1",
   "description": "Open-source agentic workspace for teams — where people and AI agents get work done together: agents (Claude Code, Codex, Pi), skills, shared knowledge, repeatable workflows, and deterministic verification",
   "keywords": [
     "agents",