spur-board 0.6.0 → 0.7.0

package/dist/cli.mjs

@@ -1,10 +1,10 @@
-import { B as SLACK_BOT_SCOPES, R as configSchema, s as OPERATIONS, z as requiredSecretKeys } from "./src-Cy74ZQfR.mjs";
-import { a as renderCliError, i as errorExitCode, n as requestTokenEnrollment, o as escapeTerminalControls, r as CliError, t as requestOperation } from "./client-Dw9ZovyI.mjs";
-import { i as resolveDaemonAddress, n as loadClientConfig, r as loadEnrollmentConfig, t as configFile } from "./config-CeDZQlvy.mjs";
+import { B as SLACK_BOT_SCOPES, R as configSchema, s as OPERATIONS, z as requiredSecretKeys } from "./src-BFgTh55w.mjs";
+import { a as renderCliError, i as errorExitCode, n as requestTokenEnrollment, o as escapeTerminalControls, r as CliError, t as requestOperation } from "./client-Ln76BdDz.mjs";
+import { i as resolveDaemonAddress, n as loadClientConfig, r as loadEnrollmentConfig, t as configFile } from "./config-B_6fA4Au.mjs";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { chmodSync, closeSync, constants, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, hostname, userInfo } from "node:os";
-import { dirname, isAbsolute, join, resolve } from "node:path";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { Command, CommanderError } from "@commander-js/extra-typings";
 import { z } from "zod";
 import YAML from "yaml";
@@ -401,8 +401,6 @@ function renderUserUnit(paths) {
 	return [
 		"[Unit]",
 		"Description=spur-board daemon",
-		"After=network-online.target",
-		"Wants=network-online.target",
 		"",
 		"[Service]",
 		"Type=simple",
@@ -613,14 +611,48 @@ async function targetDirectory(path) {
 		throw error;
 	}
 }
-async function checkTarget(home, agent, destination) {
-	const parent = join(home, agent, "skills");
-	await targetDirectory(join(home, agent));
-	await targetDirectory(parent);
-	return targetDirectory(destination);
+async function resolvedParent(path) {
+	let entry;
+	try {
+		entry = await lstat(path);
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+			const ancestor = await resolvedParent(dirname(path));
+			const parent = join(ancestor.parent, basename(path));
+			return {
+				parent,
+				missing: [...ancestor.missing, parent]
+			};
+		}
+		throw error;
+	}
+	if (!entry.isDirectory() && !entry.isSymbolicLink()) throw new Error(`Skill install parent must be a directory: ${path}`);
+	const canonical = await realpath(path);
+	if (!(await stat(canonical)).isDirectory()) throw new Error(`Skill install parent must be a directory: ${path}`);
+	return {
+		parent: canonical,
+		missing: []
+	};
 }
-async function withInstallLock(home, action) {
-	const fd = openSync(join(home, ".spur-board-skills-install.lock"), constants.O_CREAT | constants.O_RDWR | constants.O_NOFOLLOW, 384);
+async function createMissingParents(paths) {
+	for (const path of paths) {
+		try {
+			await mkdir(path, { mode: 448 });
+		} catch (error) {
+			if (!(error instanceof Error && "code" in error && error.code === "EEXIST")) throw error;
+		}
+		const entry = await lstat(path);
+		if (!entry.isDirectory() || entry.isSymbolicLink() || await realpath(path) !== path) throw new Error(`Skill install parent must be a directory, not a new symlink: ${path}`);
+	}
+}
+async function withInstallLock(home, env, action) {
+	const configured = env["XDG_STATE_HOME"];
+	const stateDir = join(configured && isAbsolute(configured) ? configured : join(home, ".local", "state"), "spur-board");
+	await mkdir(stateDir, {
+		recursive: true,
+		mode: 448
+	});
+	const fd = openSync(join(stateDir, "skills-install.lock"), constants.O_CREAT | constants.O_RDWR | constants.O_NOFOLLOW, 384);
 	try {
 		await new Promise((resolveLock, reject) => {
 			const child = spawn("flock", [
@@ -702,88 +734,96 @@ async function recoverSkill(parent, destination, name) {
 		await rm(owner);
 	}
 }
-async function installIntoHome(home, packageRoot, version, options) {
-	for (const agent of agents) for (const skill of skills) await checkTarget(home, agent, join(home, agent, "skills", skill.name));
+async function installIntoHome(home, packageRoot, version, options, env) {
+	const targets = await Promise.all(agents.map(async (agent) => {
+		const configured = agent === ".codex" ? env["CODEX_HOME"] : void 0;
+		return {
+			agent,
+			...await resolvedParent(join(configured ? resolve(configured) : join(home, agent), "skills"))
+		};
+	}));
+	for (const { parent } of targets) for (const skill of skills) await targetDirectory(join(parent, skill.name));
 	const installedAt = (options.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	for (const { parent, missing } of targets) {
+		await createMissingParents(missing);
+		if (await realpath(parent) !== parent) throw new Error(`Skill install parent changed after preflight: ${parent}`);
+	}
 	const results = [];
-	for (const agent of agents) {
-		const parent = join(home, agent, "skills");
-		for (const skill of skills) {
-			const destination = join(parent, skill.name);
-			await recoverSkill(parent, destination, skill.name);
-			const changed = !await currentVersion(destination, version);
-			if (changed) {
-				await mkdir(parent, { recursive: true });
-				await checkTarget(home, agent, destination);
-				const stageId = randomUUID();
-				const staged = join(parent, `.${skill.name}-stage-${stageId}`);
-				const owner = `${staged}.owner`;
-				await writeFile(owner, `spur-board stage ${stageId}\n`, {
-					flag: "wx",
-					mode: 384
-				});
-				let stagedCreated = false;
-				try {
-					await mkdir(staged, { mode: 448 });
-					stagedCreated = true;
-					const source = join(packageRoot, "skills", skill.source);
-					if (options.copySkill) await options.copySkill(source, staged);
-					else await cp(source, staged, { recursive: true });
-					const stamp = {
-						version,
-						installedAt
-					};
-					await writeFile(join(staged, stampName), `${JSON.stringify(stamp, null, 2)}\n`);
-					if (await checkTarget(home, agent, destination)) {
-						const backupId = randomUUID();
-						const backup = join(parent, `.${skill.name}-backup-${backupId}`);
-						const backupOwner = `${backup}.owner`;
-						const original = await lstat(destination, { bigint: true });
-						await writeFile(backupOwner, `spur-board backup ${backupId} ${`${String(original.dev)}:${String(original.ino)}`}\n`, {
-							flag: "wx",
-							mode: 384
-						});
-						let backupContainsSkill = false;
+	for (const { agent, parent } of targets) for (const skill of skills) {
+		const destination = join(parent, skill.name);
+		await recoverSkill(parent, destination, skill.name);
+		const changed = !await currentVersion(destination, version);
+		if (changed) {
+			await targetDirectory(destination);
+			const stageId = randomUUID();
+			const staged = join(parent, `.${skill.name}-stage-${stageId}`);
+			const owner = `${staged}.owner`;
+			await writeFile(owner, `spur-board stage ${stageId}\n`, {
+				flag: "wx",
+				mode: 384
+			});
+			let stagedCreated = false;
+			try {
+				await mkdir(staged, { mode: 448 });
+				stagedCreated = true;
+				const source = join(packageRoot, "skills", skill.source);
+				if (options.copySkill) await options.copySkill(source, staged);
+				else await cp(source, staged, { recursive: true });
+				const stamp = {
+					version,
+					installedAt
+				};
+				await writeFile(join(staged, stampName), `${JSON.stringify(stamp, null, 2)}\n`);
+				if (await targetDirectory(destination)) {
+					const backupId = randomUUID();
+					const backup = join(parent, `.${skill.name}-backup-${backupId}`);
+					const backupOwner = `${backup}.owner`;
+					const original = await lstat(destination, { bigint: true });
+					await writeFile(backupOwner, `spur-board backup ${backupId} ${`${String(original.dev)}:${String(original.ino)}`}\n`, {
+						flag: "wx",
+						mode: 384
+					});
+					let backupContainsSkill = false;
+					try {
+						if (await targetDirectory(backup)) throw new Error(`Skill backup path already exists: ${backup}`);
+						await rename(destination, backup);
+						backupContainsSkill = true;
 						try {
-							if (await targetDirectory(backup)) throw new Error(`Skill backup path already exists: ${backup}`);
-							await rename(destination, backup);
-							backupContainsSkill = true;
-							try {
-								await rename(staged, destination);
-							} catch (error) {
-								await rename(backup, destination);
-								backupContainsSkill = false;
-								throw error;
-							}
-							await rm(backup, { recursive: true });
+							await rename(staged, destination);
+						} catch (error) {
+							await rename(backup, destination);
 							backupContainsSkill = false;
-						} finally {
-							if (!backupContainsSkill) await rm(backupOwner);
+							throw error;
 						}
-					} else await rename(staged, destination);
-				} finally {
-					if (stagedCreated) await rm(staged, {
-						recursive: true,
-						force: true
-					});
-					await rm(owner);
-				}
+						await rm(backup, { recursive: true });
+						backupContainsSkill = false;
+					} finally {
+						if (!backupContainsSkill) await rm(backupOwner);
+					}
+				} else await rename(staged, destination);
+			} finally {
+				if (stagedCreated) await rm(staged, {
+					recursive: true,
+					force: true
+				});
+				await rm(owner);
 			}
-			results.push({
-				agent: agent === ".claude" ? "claude" : "codex",
-				skill: skill.name,
-				changed
-			});
 		}
+		results.push({
+			agent: agent === ".claude" ? "claude" : "codex",
+			skill: skill.name,
+			changed
+		});
 	}
 	return results;
 }
 async function installSkills(options = {}) {
 	const packageRoot = resolve(options.packageRoot ?? fileURLToPath(new URL("../", import.meta.url)));
 	const home = await realpath(resolve(options.home ?? homedir()));
+	const env = options.env ?? process.env;
 	const version = await packageVersion(packageRoot);
 	await Promise.all(skills.map((skill) => requireSource(join(packageRoot, "skills", skill.source))));
-	return withInstallLock(home, () => installIntoHome(home, packageRoot, version, options));
+	return withInstallLock(home, env, () => installIntoHome(home, packageRoot, version, options, env));
 }
 //#endregion
 //#region src/cli.ts
@@ -968,7 +1008,10 @@ function registerSetupCommands(program, options, io, env) {
 		if (checks.some((check) => check.blocking)) throw new CommanderError(1, "board.error", "Doctor found blocking failures.");
 	});
 	commandFor(program, "skills install").description("Install bundled skills for Claude Code and Codex.").action(async () => {
-		print(await runSetup(() => installSkills(options.setup)));
+		print(await runSetup(() => installSkills({
+			...options.setup,
+			env
+		})));
 	});
 	commandFor(program, "service install").description("Install and start the systemd user service.").action(async () => {
 		print(await runSetup(() => installService(serviceOptions)));

package/dist/{client-Dw9ZovyI.mjs → client-Ln76BdDz.mjs}

@@ -1,4 +1,4 @@
-import { M as errorContextSchema, N as errorEnvelopeSchema, P as successEnvelopeSchema, j as ERRORS, l as renderJsonError } from "./src-Cy74ZQfR.mjs";
+import { M as errorContextSchema, N as errorEnvelopeSchema, P as successEnvelopeSchema, j as ERRORS, l as renderJsonError } from "./src-BFgTh55w.mjs";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { request } from "node:http";

package/dist/client.mjs

@@ -1,2 +1,2 @@
-import { n as requestTokenEnrollment, t as requestOperation } from "./client-Dw9ZovyI.mjs";
+import { n as requestTokenEnrollment, t as requestOperation } from "./client-Ln76BdDz.mjs";
 export { requestOperation, requestTokenEnrollment };

package/dist/{config-CeDZQlvy.mjs → config-B_6fA4Au.mjs}

@@ -1,5 +1,5 @@
-import { R as configSchema } from "./src-Cy74ZQfR.mjs";
-import { r as CliError } from "./client-Dw9ZovyI.mjs";
+import { R as configSchema } from "./src-BFgTh55w.mjs";
+import { r as CliError } from "./client-Ln76BdDz.mjs";
 import { closeSync, constants, fstatSync, lstatSync, openSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/daemon.mjs

@@ -1,4 +1,4 @@
-import { A as taskKeySchema, B as SLACK_BOT_SCOPES, C as sessionFactsSchema, D as errorCodeOf, E as encodeActorId, L as DEFAULT_SLACK_COMMAND, O as parseActorId, P as successEnvelopeSchema, R as configSchema, S as prRefSchema, T as actorIdSchema, _ as EVENT_KINDS, a as buildCatalogSnapshot, b as SESSION_STATUSES, c as renderHttpProblem, d as SPACE_IDS, f as conversationRefSchema, g as userIdSchema, h as messageRefSchema, i as sourceCursorSchema, j as ERRORS, k as parseRef$1, m as interactionRefSchema, n as batchSchema, o as roleCanUseOperation, p as inboundEventSchema, r as entityRefSchema, s as OPERATIONS, t as AdapterError, v as eventPayloadSchemas, w as ticketFactsSchema, x as prFactsSchema, y as SESSION_HEALTH_STATES, z as requiredSecretKeys } from "./src-Cy74ZQfR.mjs";
+import { A as taskKeySchema, B as SLACK_BOT_SCOPES, C as sessionFactsSchema, D as errorCodeOf, E as encodeActorId, L as DEFAULT_SLACK_COMMAND, O as parseActorId, P as successEnvelopeSchema, R as configSchema, S as prRefSchema, T as actorIdSchema, _ as EVENT_KINDS, a as buildCatalogSnapshot, b as SESSION_STATUSES, c as renderHttpProblem, d as SPACE_IDS, f as conversationRefSchema, g as userIdSchema, h as messageRefSchema, i as sourceCursorSchema, j as ERRORS, k as parseRef$1, m as interactionRefSchema, n as batchSchema, o as roleCanUseOperation, p as inboundEventSchema, r as entityRefSchema, s as OPERATIONS, t as AdapterError, v as eventPayloadSchemas, w as ticketFactsSchema, x as prFactsSchema, y as SESSION_HEALTH_STATES, z as requiredSecretKeys } from "./src-BFgTh55w.mjs";
 import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { closeSync, existsSync, fstatSync, ftruncateSync, mkdirSync, openSync, readFileSync, readdirSync, writeSync } from "node:fs";

package/dist/mcp.mjs

@@ -1,6 +1,6 @@
-import { j as ERRORS, s as OPERATIONS, u as renderMcpError } from "./src-Cy74ZQfR.mjs";
-import { r as CliError, t as requestOperation } from "./client-Dw9ZovyI.mjs";
-import { n as loadClientConfig } from "./config-CeDZQlvy.mjs";
+import { j as ERRORS, s as OPERATIONS, u as renderMcpError } from "./src-BFgTh55w.mjs";
+import { r as CliError, t as requestOperation } from "./client-Ln76BdDz.mjs";
+import { n as loadClientConfig } from "./config-B_6fA4Au.mjs";
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { z } from "zod";

package/dist/{src-Cy74ZQfR.mjs → src-BFgTh55w.mjs}

@@ -528,7 +528,7 @@ const ERRORS = {
 		status: null,
 		exit: EXIT_CODES.notApplied,
 		message: "The daemon is not running or cannot be reached; nothing was applied.",
-		hint: "Ask in your own session; the operator can run `board service start`. Retry the same command with its existing idempotency key if it has one once the daemon is available.",
+		hint: "Ask in your own session; the operator can check `board service status`, then run `board service restart`, or `board service install` if the service was never installed. Retry the same command with its existing idempotency key if it has one once the daemon is available.",
 		recovery: retry("Ask in your own session, then retry the same command with its existing idempotency key if it has one.", "After the daemon is available; wait briefly between retries.")
 	}),
 	config: spec("config", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spur-board",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "engines": {
     "node": "^24.12.0 || ^26.0.0"