@agent-team-foundation/first-tree-hub 0.8.5 → 0.9.0

package/dist/{bootstrap-99vUYmLs.mjs → bootstrap-CWcBzk6C.mjs}

@@ -1,6 +1,6 @@
 import { d as __exportAll } from "./esm-CYu4tXXn.mjs";
 import { a as logLevelSchema, i as logFormatSchema } from "./logger-core-2yeIU1fc-B-__AsQO.mjs";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import { parse, stringify } from "yaml";
@@ -28,7 +28,7 @@ function defineConfig(shape) {
 	return shape;
 }
 /**
-* Agent config layout on disk: `~/.first-tree-hub/config/agents/<name>/agent.yaml`.
+* Agent config layout on disk: `~/.first-tree/hub/config/agents/<name>/agent.yaml`.
 *
 * After the unified-user-token milestone the local config no longer stores an
 * agent bearer; authentication comes from the user's member JWT in
@@ -45,10 +45,28 @@ const agentConfigSchema = defineConfig({
 		max_sessions: field(z.number().int().positive().default(10))
 	}
 });
+/**
+* Phase-dependent defaults that flip with release milestones. Kept as a plain
+* module-level constant so reviews of the beta→GA transition are a one-line
+* diff, and so tests can mock this module to exercise both branches.
+*/
+const UPDATE_POLICIES = [
+	"auto",
+	"prompt",
+	"off"
+];
+/**
+* Default value of `update.policy` on the Client config. During the beta this
+* is `"auto"` — operators rarely know to `npm i -g` weekly and we chase the
+* latest published Command by default. The GA PR flips it to `"prompt"` and
+* bumps Command to `1.0.0`.
+*/
+const UPDATE_POLICY_DEFAULT = "auto";
 /** Store the resolved config as a singleton. Called by initConfig(). */
 function setConfig(config) {}
 /** Reset the config singleton. For testing only. */
 function resetConfig() {}
+const updatePolicySchema = z.enum(UPDATE_POLICIES);
 const clientConfigSchema = defineConfig({
 	server: { url: field(z.string(), {
 		env: "FIRST_TREE_HUB_SERVER_URL",
@@ -61,9 +79,15 @@ const clientConfigSchema = defineConfig({
 		auto: "client-id",
 		env: "FIRST_TREE_HUB_CLIENT_ID"
 	}) },
+	update: {
+		policy: field(updatePolicySchema.default(UPDATE_POLICY_DEFAULT), { env: "FIRST_TREE_HUB_UPDATE_POLICY" }),
+		restart_quiet_seconds: field(z.number().int().min(1).max(3600).default(30), { env: "FIRST_TREE_HUB_UPDATE_RESTART_QUIET_SECONDS" }),
+		restart_check_interval_seconds: field(z.number().int().min(5).max(300).default(10), { env: "FIRST_TREE_HUB_UPDATE_RESTART_CHECK_INTERVAL_SECONDS" }),
+		prompt_timeout_seconds: field(z.number().int().min(10).max(600).default(60), { env: "FIRST_TREE_HUB_UPDATE_PROMPT_TIMEOUT_SECONDS" })
+	},
 	logLevel: field(logLevelSchema.default("info"), { env: "FIRST_TREE_HUB_LOG_LEVEL" })
 });
-const DEFAULT_HOME_DIR = process.env.FIRST_TREE_HUB_HOME ?? join(homedir(), ".first-tree-hub");
+const DEFAULT_HOME_DIR = process.env.FIRST_TREE_HUB_HOME ?? join(homedir(), ".first-tree", "hub");
 const DEFAULT_CONFIG_DIR = join(DEFAULT_HOME_DIR, "config");
 const DEFAULT_DATA_DIR = join(DEFAULT_HOME_DIR, "data");
 function isFieldDef(value) {
@@ -407,6 +431,102 @@ function loadAgents(options) {
 	}
 	return result;
 }
+/**
+* Pre-v0.9 path. The home directory was a flat `~/.first-tree-hub/` — this
+* was renamed to `~/.first-tree/hub/` so the `.first-tree/` parent can be
+* shared with sibling products (context-tree etc.) under the same brand.
+*/
+const LEGACY_HOME_DIR = join(homedir(), ".first-tree-hub");
+/**
+* Auto-migrate the legacy `~/.first-tree-hub/` home to the new
+* `~/.first-tree/hub/` layout. Designed to be called once at CLI startup —
+* idempotent, never throws, and skips any case that could merge state.
+*
+* **Copy-only semantics:** the legacy tree is preserved on disk as a safety
+* net. Users can inspect or fall back to it, and can delete it manually
+* once they've confirmed the new location is healthy. Idempotency is
+* therefore keyed on whether the *target* already has content, not on
+* whether the legacy path still exists.
+*
+* Skip rules (in order):
+*   1. `FIRST_TREE_HUB_HOME` is set → user is driving the path explicitly.
+*   2. Legacy path doesn't exist → nothing to migrate.
+*   3. New path already has content → treat as already-migrated (or a
+*      conflict the user must resolve). Either way, never merge.
+*
+* Otherwise we recursively copy legacy → new with `cpSync`, preserving
+* mtimes so log rotation and mtime heuristics keep working.
+*/
+/**
+* Walk `src` depth-first and mirror every directory's mode onto the matching
+* path in `dest`. Skips symlinks (we don't want to chmod whatever they
+* resolve to — that can reach outside the tree). Files are left alone
+* because `cpSync` already preserves file modes.
+*/
+function syncDirectoryModes(src, dest) {
+	chmodSync(dest, statSync(src).mode & 4095);
+	const stack = [""];
+	while (stack.length > 0) {
+		const rel = stack.pop();
+		if (rel === void 0) break;
+		const srcDir = join(src, rel);
+		for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
+			if (!entry.isDirectory()) continue;
+			const relChild = rel === "" ? entry.name : join(rel, entry.name);
+			const mode = statSync(join(src, relChild)).mode & 4095;
+			chmodSync(join(dest, relChild), mode);
+			stack.push(relChild);
+		}
+	}
+}
+function migrateLegacyHome(opts) {
+	const { newHome, envOverride } = opts;
+	const legacyHome = opts.legacyHome ?? LEGACY_HOME_DIR;
+	if (envOverride) return {
+		migrated: false,
+		reason: "custom-home"
+	};
+	if (!existsSync(legacyHome)) return {
+		migrated: false,
+		reason: "no-legacy-dir"
+	};
+	if (existsSync(newHome)) try {
+		if (readdirSync(newHome).length > 0) return {
+			migrated: false,
+			reason: "new-dir-populated",
+			from: legacyHome,
+			to: newHome
+		};
+	} catch (err) {
+		return {
+			migrated: false,
+			reason: "failed",
+			from: legacyHome,
+			to: newHome,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+	try {
+		cpSync(legacyHome, newHome, {
+			recursive: true,
+			preserveTimestamps: true
+		});
+		syncDirectoryModes(legacyHome, newHome);
+		return {
+			migrated: true,
+			from: legacyHome,
+			to: newHome
+		};
+	} catch (err) {
+		return {
+			migrated: false,
+			reason: "failed",
+			from: legacyHome,
+			to: newHome,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
 const serverConfigSchema = defineConfig({
 	database: {
 		url: field(z.string(), {
@@ -622,4 +742,4 @@ function saveAgentConfig(agentName, agentId, runtime) {
 	return agentDir;
 }
 //#endregion
-export { setConfigValue as C, serverConfigSchema as S, loadAgents as _, resolveAccessToken as a, resetConfigMeta as b, saveCredentials as c, DEFAULT_HOME_DIR as d, agentConfigSchema as f, initConfig as g, getConfigValue as h, loadCredentials as i, DEFAULT_CONFIG_DIR as l, collectMissingPrompts as m, ensureFreshAccessToken as n, resolveServerUrl as o, clientConfigSchema as p, ensureFreshAdminToken as r, saveAgentConfig as s, bootstrap_exports as t, DEFAULT_DATA_DIR as u, readConfigFile as v, resolveConfigReadonly as x, resetConfig as y };
+export { serverConfigSchema as C, resolveConfigReadonly as S, loadAgents as _, resolveAccessToken as a, resetConfig as b, saveCredentials as c, DEFAULT_HOME_DIR as d, agentConfigSchema as f, initConfig as g, getConfigValue as h, loadCredentials as i, DEFAULT_CONFIG_DIR as l, collectMissingPrompts as m, ensureFreshAccessToken as n, resolveServerUrl as o, clientConfigSchema as p, ensureFreshAdminToken as r, saveAgentConfig as s, bootstrap_exports as t, DEFAULT_DATA_DIR as u, migrateLegacyHome as v, setConfigValue as w, resetConfigMeta as x, readConfigFile as y };

package/dist/cli/index.mjs

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 import "../logger-core-2yeIU1fc-B-__AsQO.mjs";
-import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, b as resetConfigMeta, c as saveCredentials, f as agentConfigSchema, g as initConfig, h as getConfigValue, i as loadCredentials, l as DEFAULT_CONFIG_DIR, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, r as ensureFreshAdminToken, s as saveAgentConfig, u as DEFAULT_DATA_DIR, v as readConfigFile, y as resetConfig } from "../bootstrap-99vUYmLs.mjs";
+import { C as serverConfigSchema, _ as loadAgents, b as resetConfig, c as saveCredentials, f as agentConfigSchema, g as initConfig, h as getConfigValue, i as loadCredentials, l as DEFAULT_CONFIG_DIR, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, r as ensureFreshAdminToken, s as saveAgentConfig, u as DEFAULT_DATA_DIR, w as setConfigValue, x as resetConfigMeta, y as readConfigFile } from "../bootstrap-CWcBzk6C.mjs";
 import "../observability-CJzDFY_G-CmvgUuzc.mjs";
-import { A as stopPostgres, C as checkServerReachable, F as SdkError, I as SessionRegistry, L as cleanWorkspaces, M as createOwner, P as FirstTreeHubSDK, R as applyClientLoggerConfig, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, d as loadOnboardState, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, j as ClientRuntime, l as promptMissingFields, m as saveOnboardState, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "../core-DoIprl2f.mjs";
-import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-n9Y2yGTT.mjs";
-import { createRequire } from "node:module";
+import { A as printResults, B as SdkError, C as checkDatabase, D as checkServerHealth, E as checkServerConfig, F as stopPostgres, H as cleanWorkspaces, I as ClientRuntime, L as createOwner, O as checkServerReachable, S as checkClientConfig, T as checkNodeVersion, U as applyClientLoggerConfig, V as SessionRegistry, _ as isServiceSupported, a as COMMAND_VERSION, b as runMigrations, c as promptMissingFields, d as onboardCheck, f as onboardCreate, g as installClientService, h as getClientServiceStatus, i as startServer, k as checkWebSocket, l as formatCheckReport, m as runHomeMigration, n as declineUpdate, o as isInteractive, p as saveOnboardState, r as promptUpdate, s as promptAddAgent, t as createExecuteUpdate, u as loadOnboardState, w as checkDocker, x as checkAgentConfigs, y as uninstallClientService, z as FirstTreeHubSDK } from "../core-DZDhomaN.mjs";
+import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-GlaczcVf.mjs";
 import { Command } from "commander";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import { join } from "node:path";
@@ -781,7 +780,7 @@ function decodeJwtPayload(token) {
 * and give the operator a chance to back out before we overwrite credentials.
 *
 * Why this gate exists: running `client connect` implicitly overwrites
-* `~/.first-tree-hub/config/credentials.json`. Without this prompt, someone
+* `~/.first-tree/hub/config/credentials.json`. Without this prompt, someone
 * onboarding a second account on their own machine silently logs themselves
 * out of the first account — they'd only notice when their "main" agents
 * appeared offline later. We treat single-account-per-machine as the product
@@ -839,7 +838,7 @@ async function promptReplaceOrCancel(newMemberId, newServerUrl) {
 function printIsolationGuide(newServerUrl) {
 	process.stderr.write("\n  Cancelled. The existing account on this computer is untouched.\n\n");
 	process.stderr.write("  To run this new account alongside it (advanced — no background service):\n\n");
-	process.stderr.write("    export FIRST_TREE_HUB_HOME=\"$HOME/.first-tree-hub-<label>\"\n");
+	process.stderr.write("    export FIRST_TREE_HUB_HOME=\"$HOME/.first-tree/hub-<label>\"\n");
 	process.stderr.write(`    first-tree-hub client connect ${newServerUrl} --token <token>\n`);
 	process.stderr.write("    first-tree-hub client start\n\n");
 	process.stderr.write("  Notes:\n");
@@ -930,7 +929,14 @@ function registerConnectCommand(parent) {
 				schema: agentConfigSchema,
 				agentsDir
 			});
-			const runtime = new ClientRuntime(config.server.url, config.client.id);
+			const runtime = new ClientRuntime(config.server.url, config.client.id, {
+				currentVersion: COMMAND_VERSION,
+				update: {
+					updateConfig: config.update,
+					prompt: promptUpdate,
+					executeUpdate: createExecuteUpdate({ managed: false })
+				}
+			});
 			for (const [name, agentConfig] of agents) runtime.addAgent(name, agentConfig);
 			await runtime.start();
 			runtime.watchAgentsDir(agentsDir);
@@ -980,7 +986,15 @@ function registerClientCommands(program) {
 				agentsDir
 			});
 			process.stderr.write(`\n  Connecting to ${config.server.url} (client id: ${config.client.id})...\n`);
-			const runtime = new ClientRuntime(config.server.url, config.client.id);
+			const managed = options.interactive === false;
+			const runtime = new ClientRuntime(config.server.url, config.client.id, {
+				currentVersion: COMMAND_VERSION,
+				update: {
+					updateConfig: config.update,
+					prompt: managed ? declineUpdate : promptUpdate,
+					executeUpdate: createExecuteUpdate({ managed })
+				}
+			});
 			for (const [name, agentConfig] of agents) runtime.addAgent(name, agentConfig);
 			await runtime.start();
 			runtime.watchAgentsDir(agentsDir);
@@ -1226,13 +1240,13 @@ function isSecretField(schema, dotPath) {
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-99vUYmLs.mjs").then((n) => n.t);
+		const { resolveServerUrl } = await import("../bootstrap-CWcBzk6C.mjs").then((n) => n.t);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	const { loadCredentials } = await import("../bootstrap-99vUYmLs.mjs").then((n) => n.t);
+	const { loadCredentials } = await import("../bootstrap-CWcBzk6C.mjs").then((n) => n.t);
 	if (!loadCredentials()) throw new Error("No saved credentials. Run `first-tree-hub client connect <server-url>` before onboarding.");
 	if (!args.id) {
 		args.id = await input({ message: "Agent ID:" });
@@ -1492,9 +1506,9 @@ function formatUptime(seconds) {
 }
 //#endregion
 //#region src/cli/index.ts
-const { version } = createRequire(import.meta.url)("../../package.json");
+runHomeMigration();
 const program = new Command();
-program.name("first-tree-hub").description("First Tree Hub — centralized collaboration platform for agent teams").version(version);
+program.name("first-tree-hub").description("First Tree Hub — centralized collaboration platform for agent teams").version(COMMAND_VERSION);
 registerServerCommands(program);
 registerClientCommands(program);
 registerAgentCommands(program);