@serviceme/devtools-core 2.0.2 → 2.0.4

package/dist/userHome-CLlsXCvW.js

@@ -0,0 +1,518 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.js");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+let node_os = require("node:os");
+node_os = require_rolldown_runtime.__toESM(node_os);
+//#region src/paths/userHome.ts
+/**
+* SERVICEME user home directory helpers.
+*
+* All paths resolve under {@link getServicemeHome}, which is either the
+* `SERVICEME_HOME` environment variable (when set and non-empty) or
+* `$HOME/.serviceme` on POSIX / `%USERPROFILE%\.serviceme` on Windows.
+*
+* Tests inject `homeDir` and `servicemeHomeEnv` overrides via
+* {@link setUserHomeOverrides} / {@link resetUserHomeOverrides} so they can
+* exercise the path logic without touching the real user environment.
+*/
+/** Layout constants — kept in one place so other modules can reuse them. */
+const SERVICEME_DIR_NAME = ".serviceme";
+const REPOS_SUBDIR = "repos";
+const CACHE_SUBDIR = "cache";
+const DRAFTS_SUBDIR = "drafts";
+const SKILL_DRAFTS_SUBDIR = "skills";
+const AGENT_DRAFTS_SUBDIR = "agents";
+const REPOS_CONFIG_FILENAME = "repos.json";
+const WORKSPACES_SUBDIR = "workspaces";
+const WORKSPACE_CONTENT_STATE_FILENAME = "copilot-content-state.json";
+/**
+* Repo id regex — used to validate any `repoId` argument before it is joined
+* into a filesystem path. Keeps path traversal attempts out and gives us a
+* predictable on-disk shape.
+*/
+const SAFE_REPO_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
+/** Environment variable that overrides the user-home root directory. */
+const SERVICEME_HOME_ENV = "SERVICEME_HOME";
+let activeOverrides = {};
+function setUserHomeOverrides(overrides) {
+	activeOverrides = { ...overrides };
+}
+function resetUserHomeOverrides() {
+	activeOverrides = {};
+}
+function resolveHomeDir() {
+	const injected = activeOverrides.homeDir;
+	if (injected !== void 0) return injected;
+	return node_os.homedir();
+}
+function resolveServicemeHomeEnv() {
+	const injected = activeOverrides.servicemeHomeEnv;
+	if (injected !== void 0) return injected.length > 0 ? injected : void 0;
+	const envValue = process.env[SERVICEME_HOME_ENV];
+	return envValue && envValue.length > 0 ? envValue : void 0;
+}
+function resolvePlatform() {
+	return activeOverrides.platform ?? process.platform;
+}
+function assertSafeRepoId(repoId) {
+	if (typeof repoId !== "string" || repoId.length === 0 || !SAFE_REPO_ID_PATTERN.test(repoId)) throw new Error(`Invalid repo id: ${JSON.stringify(repoId)}. Must match ${SAFE_REPO_ID_PATTERN} (alphanumeric start, then alphanumerics / underscores / hyphens, ≤ 64 chars).`);
+	return repoId;
+}
+/**
+* The raw OS home directory (`os.homedir()`), honoring test overrides
+* ({@link setUserHomeOverrides}). Exported for callers that need a
+* home-relative path *outside* of `~/.serviceme` — e.g. the
+* `~/.agents/{skills,agents}` convention used by `SkillLinker` for
+* user-scope links.
+*/
+function getHomeDir() {
+	return resolveHomeDir();
+}
+/**
+* Root directory for all SERVICEME user-level state. Resolves to
+* `${SERVICEME_HOME}` when that env var is set, otherwise `${HOME}/.serviceme`
+* (POSIX) or `%USERPROFILE%\.serviceme` (Windows via `os.homedir`).
+*/
+function getServicemeHome() {
+	const override = resolveServicemeHomeEnv();
+	if (override !== void 0) return node_path.resolve(override);
+	return node_path.join(resolveHomeDir(), SERVICEME_DIR_NAME);
+}
+/** `$HOME/.serviceme/repos` (or `${SERVICEME_HOME}/repos`). */
+function getReposDir() {
+	return node_path.join(getServicemeHome(), REPOS_SUBDIR);
+}
+/** `$HOME/.serviceme/repos/<repoId>` — validates `repoId` first. */
+function getRepoDir(repoId) {
+	return node_path.join(getReposDir(), assertSafeRepoId(repoId));
+}
+/** `$HOME/.serviceme/cache` — generic per-user cache. */
+function getCacheDir() {
+	return node_path.join(getServicemeHome(), CACHE_SUBDIR);
+}
+/** `$HOME/.serviceme/cache/<repoId>` — per-repo sync state lives here. */
+function getRepoCacheDir(repoId) {
+	return node_path.join(getCacheDir(), assertSafeRepoId(repoId));
+}
+/** `$HOME/.serviceme/drafts` — local edits not yet pushed upstream. */
+function getDraftsDir() {
+	return node_path.join(getServicemeHome(), DRAFTS_SUBDIR);
+}
+/** `$HOME/.serviceme/drafts/skills` — local skill drafts. */
+function getSkillDraftsDir() {
+	return node_path.join(getDraftsDir(), SKILL_DRAFTS_SUBDIR);
+}
+/** `$HOME/.serviceme/drafts/agents` — local agent drafts. */
+function getAgentDraftsDir() {
+	return node_path.join(getDraftsDir(), AGENT_DRAFTS_SUBDIR);
+}
+/**
+* `$HOME/.serviceme/repos.json` — the single config entry point for repo
+* metadata. Always under the resolved home root (i.e. follows
+* `SERVICEME_HOME` overrides too).
+*/
+function getReposConfigPath() {
+	return node_path.join(getServicemeHome(), REPOS_CONFIG_FILENAME);
+}
+/** `~/.serviceme/workspaces` — machine-local per-workspace state root. */
+function getWorkspacesDir() {
+	return node_path.join(getServicemeHome(), WORKSPACES_SUBDIR);
+}
+/**
+* Convenience helper for callers that need to switch behaviour on platform
+* (e.g. `SkillLinker` chooses symlink vs junction). Exported mostly so tests
+* can pin the value without touching `process.platform` directly.
+*/
+function getHomePlatform() {
+	return resolvePlatform();
+}
+/** Layout constants for scheduled-tasks files. Kept here so other modules
+* can reuse them and the names stay in sync with the design doc. */
+const SCHEDULED_TASKS_CONFIG_FILENAME = "scheduled-tasks.json";
+const SCHEDULED_TASKS_LOG_FILENAME = "scheduled-tasks-log.json";
+const SCHEDULER_PID_FILENAME = "scheduler.pid";
+const SCHEDULER_LOCK_FILENAME = "scheduler.lock";
+const SCHEDULER_LOG_FILENAME = "scheduler.log";
+const MIGRATION_FAILURES_FILENAME = "migration-failures.json";
+const KNOWN_WORKSPACES_FILENAME = "known-workspaces.json";
+/** `~/.serviceme/scheduled-tasks.json` — the global v2 task list. */
+function getScheduledTasksConfigPath() {
+	return node_path.join(getServicemeHome(), SCHEDULED_TASKS_CONFIG_FILENAME);
+}
+/** `~/.serviceme/scheduled-tasks-log.json` — the global execution log (200 LRU). */
+function getScheduledTasksLogPath() {
+	return node_path.join(getServicemeHome(), SCHEDULED_TASKS_LOG_FILENAME);
+}
+/** `~/.serviceme/scheduler.pid` — global daemon PID file. */
+function getSchedulerPidPath() {
+	return node_path.join(getServicemeHome(), SCHEDULER_PID_FILENAME);
+}
+/** `~/.serviceme/scheduler.lock` — global daemon startup flock. */
+function getSchedulerLockPath() {
+	return node_path.join(getServicemeHome(), SCHEDULER_LOCK_FILENAME);
+}
+/** `~/.serviceme/scheduler.log` — global daemon log (daemon lifecycle, not task execution). */
+function getSchedulerLogPath() {
+	return node_path.join(getServicemeHome(), SCHEDULER_LOG_FILENAME);
+}
+/** `~/.serviceme/migration-failures.json` — diagnostics for failed v1→v2 imports. */
+function getMigrationFailuresPath() {
+	return node_path.join(getServicemeHome(), MIGRATION_FAILURES_FILENAME);
+}
+/** `~/.serviceme/known-workspaces.json` — workspace list the extension has seen. */
+function getKnownWorkspacesPath() {
+	return node_path.join(getServicemeHome(), KNOWN_WORKSPACES_FILENAME);
+}
+/**
+* `~/.serviceme/server-proxy.json` — r7 BYOM Server Proxy toggle
+* self-state. Written by the extension's `ProxyConfigService`, readable
+* by the CLI / Server so they can decide whether to route traffic
+* through the corporate proxy without booting VS Code.
+*
+* Lives under user-level `~/.serviceme/` (not under a workspace) because
+* the toggle is a *user preference* — the same human enabling it on
+* machine A should be able to rely on it on machine B after sync, not
+* have it disappear when they switch repos.
+*/
+function getServerProxyGlobalPath() {
+	return node_path.join(getServicemeHome(), SERVER_PROXY_GLOBAL_FILENAME);
+}
+/** Layout constants for the Phase 5 client-side state files. The server
+* already has the corresponding routes (`/api/v1/auth/...`,
+* `/api/v1/device/...`, etc.) — the client just needs the on-disk
+* file paths + a first-run bootstrap so the auth/device/toolbox
+* services can open + read them without a per-call existence check. */
+const CREDENTIALS_CONFIG_FILENAME = "credentials.json";
+const DEVICE_JSON_FILENAME = "device.json";
+const TOOLBOX_JSON_FILENAME = "toolbox.json";
+const MACHINE_ID_FILENAME = "machine-id";
+const PROFILES_JSON_FILENAME = "profiles.json";
+/** `~/.serviceme/credentials.json` — better-auth session tokens + refresh state (client-side cache). */
+function getCredentialsConfigPath() {
+	return node_path.join(getServicemeHome(), CREDENTIALS_CONFIG_FILENAME);
+}
+/** `~/.serviceme/device.json` — device enrollment payload (id, public key fingerprint, claimed-by). */
+function getDeviceJsonPath() {
+	return node_path.join(getServicemeHome(), DEVICE_JSON_FILENAME);
+}
+/** `~/.serviceme/toolbox.json` — local toolbox state (installed tool refs, per-user prefs). */
+function getToolboxJsonPath() {
+	return node_path.join(getServicemeHome(), TOOLBOX_JSON_FILENAME);
+}
+/** `~/.serviceme/machine-id` — opaque stable per-install id (uuid v4 string, no JSON wrapper). */
+function getMachineIdPath() {
+	return node_path.join(getServicemeHome(), MACHINE_ID_FILENAME);
+}
+/** `~/.serviceme/profiles.json` — cached projection of server-side profile rows; refresh on demand. */
+function getProfilesJsonPath() {
+	return node_path.join(getServicemeHome(), PROFILES_JSON_FILENAME);
+}
+//#endregion
+Object.defineProperty(exports, "AGENT_DRAFTS_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return AGENT_DRAFTS_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "CACHE_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return CACHE_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "CREDENTIALS_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return CREDENTIALS_CONFIG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "DEVICE_JSON_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return DEVICE_JSON_FILENAME;
+	}
+});
+Object.defineProperty(exports, "DRAFTS_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return DRAFTS_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "KNOWN_WORKSPACES_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return KNOWN_WORKSPACES_FILENAME;
+	}
+});
+Object.defineProperty(exports, "MACHINE_ID_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return MACHINE_ID_FILENAME;
+	}
+});
+Object.defineProperty(exports, "MIGRATION_FAILURES_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return MIGRATION_FAILURES_FILENAME;
+	}
+});
+Object.defineProperty(exports, "PROFILES_JSON_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return PROFILES_JSON_FILENAME;
+	}
+});
+Object.defineProperty(exports, "REPOS_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return REPOS_CONFIG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "REPOS_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return REPOS_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "SAFE_REPO_ID_PATTERN", {
+	enumerable: true,
+	get: function() {
+		return SAFE_REPO_ID_PATTERN;
+	}
+});
+Object.defineProperty(exports, "SCHEDULED_TASKS_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return SCHEDULED_TASKS_CONFIG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "SCHEDULED_TASKS_LOG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return SCHEDULED_TASKS_LOG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "SCHEDULER_LOCK_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return SCHEDULER_LOCK_FILENAME;
+	}
+});
+Object.defineProperty(exports, "SCHEDULER_LOG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return SCHEDULER_LOG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "SCHEDULER_PID_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return SCHEDULER_PID_FILENAME;
+	}
+});
+Object.defineProperty(exports, "SERVICEME_DIR_NAME", {
+	enumerable: true,
+	get: function() {
+		return SERVICEME_DIR_NAME;
+	}
+});
+Object.defineProperty(exports, "SERVICEME_HOME_ENV", {
+	enumerable: true,
+	get: function() {
+		return SERVICEME_HOME_ENV;
+	}
+});
+Object.defineProperty(exports, "SKILL_DRAFTS_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return SKILL_DRAFTS_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "TOOLBOX_JSON_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return TOOLBOX_JSON_FILENAME;
+	}
+});
+Object.defineProperty(exports, "WORKSPACES_SUBDIR", {
+	enumerable: true,
+	get: function() {
+		return WORKSPACES_SUBDIR;
+	}
+});
+Object.defineProperty(exports, "WORKSPACE_CONTENT_STATE_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return WORKSPACE_CONTENT_STATE_FILENAME;
+	}
+});
+Object.defineProperty(exports, "assertSafeRepoId", {
+	enumerable: true,
+	get: function() {
+		return assertSafeRepoId;
+	}
+});
+Object.defineProperty(exports, "getAgentDraftsDir", {
+	enumerable: true,
+	get: function() {
+		return getAgentDraftsDir;
+	}
+});
+Object.defineProperty(exports, "getCacheDir", {
+	enumerable: true,
+	get: function() {
+		return getCacheDir;
+	}
+});
+Object.defineProperty(exports, "getCredentialsConfigPath", {
+	enumerable: true,
+	get: function() {
+		return getCredentialsConfigPath;
+	}
+});
+Object.defineProperty(exports, "getDeviceJsonPath", {
+	enumerable: true,
+	get: function() {
+		return getDeviceJsonPath;
+	}
+});
+Object.defineProperty(exports, "getDraftsDir", {
+	enumerable: true,
+	get: function() {
+		return getDraftsDir;
+	}
+});
+Object.defineProperty(exports, "getHomeDir", {
+	enumerable: true,
+	get: function() {
+		return getHomeDir;
+	}
+});
+Object.defineProperty(exports, "getHomePlatform", {
+	enumerable: true,
+	get: function() {
+		return getHomePlatform;
+	}
+});
+Object.defineProperty(exports, "getKnownWorkspacesPath", {
+	enumerable: true,
+	get: function() {
+		return getKnownWorkspacesPath;
+	}
+});
+Object.defineProperty(exports, "getMachineIdPath", {
+	enumerable: true,
+	get: function() {
+		return getMachineIdPath;
+	}
+});
+Object.defineProperty(exports, "getMigrationFailuresPath", {
+	enumerable: true,
+	get: function() {
+		return getMigrationFailuresPath;
+	}
+});
+Object.defineProperty(exports, "getProfilesJsonPath", {
+	enumerable: true,
+	get: function() {
+		return getProfilesJsonPath;
+	}
+});
+Object.defineProperty(exports, "getRepoCacheDir", {
+	enumerable: true,
+	get: function() {
+		return getRepoCacheDir;
+	}
+});
+Object.defineProperty(exports, "getRepoDir", {
+	enumerable: true,
+	get: function() {
+		return getRepoDir;
+	}
+});
+Object.defineProperty(exports, "getReposConfigPath", {
+	enumerable: true,
+	get: function() {
+		return getReposConfigPath;
+	}
+});
+Object.defineProperty(exports, "getReposDir", {
+	enumerable: true,
+	get: function() {
+		return getReposDir;
+	}
+});
+Object.defineProperty(exports, "getScheduledTasksConfigPath", {
+	enumerable: true,
+	get: function() {
+		return getScheduledTasksConfigPath;
+	}
+});
+Object.defineProperty(exports, "getScheduledTasksLogPath", {
+	enumerable: true,
+	get: function() {
+		return getScheduledTasksLogPath;
+	}
+});
+Object.defineProperty(exports, "getSchedulerLockPath", {
+	enumerable: true,
+	get: function() {
+		return getSchedulerLockPath;
+	}
+});
+Object.defineProperty(exports, "getSchedulerLogPath", {
+	enumerable: true,
+	get: function() {
+		return getSchedulerLogPath;
+	}
+});
+Object.defineProperty(exports, "getSchedulerPidPath", {
+	enumerable: true,
+	get: function() {
+		return getSchedulerPidPath;
+	}
+});
+Object.defineProperty(exports, "getServerProxyGlobalPath", {
+	enumerable: true,
+	get: function() {
+		return getServerProxyGlobalPath;
+	}
+});
+Object.defineProperty(exports, "getServicemeHome", {
+	enumerable: true,
+	get: function() {
+		return getServicemeHome;
+	}
+});
+Object.defineProperty(exports, "getSkillDraftsDir", {
+	enumerable: true,
+	get: function() {
+		return getSkillDraftsDir;
+	}
+});
+Object.defineProperty(exports, "getToolboxJsonPath", {
+	enumerable: true,
+	get: function() {
+		return getToolboxJsonPath;
+	}
+});
+Object.defineProperty(exports, "getWorkspacesDir", {
+	enumerable: true,
+	get: function() {
+		return getWorkspacesDir;
+	}
+});
+Object.defineProperty(exports, "resetUserHomeOverrides", {
+	enumerable: true,
+	get: function() {
+		return resetUserHomeOverrides;
+	}
+});
+Object.defineProperty(exports, "setUserHomeOverrides", {
+	enumerable: true,
+	get: function() {
+		return setUserHomeOverrides;
+	}
+});
+
+//# sourceMappingURL=userHome-CLlsXCvW.js.map

package/dist/userHome-CLlsXCvW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userHome-CLlsXCvW.js","names":["os","path"],"sources":["../src/paths/userHome.ts"],"sourcesContent":["import * as os from \"node:os\";\nimport * as path from \"node:path\";\n\n/**\n * SERVICEME user home directory helpers.\n *\n * All paths resolve under {@link getServicemeHome}, which is either the\n * `SERVICEME_HOME` environment variable (when set and non-empty) or\n * `$HOME/.serviceme` on POSIX / `%USERPROFILE%\\.serviceme` on Windows.\n *\n * Tests inject `homeDir` and `servicemeHomeEnv` overrides via\n * {@link setUserHomeOverrides} / {@link resetUserHomeOverrides} so they can\n * exercise the path logic without touching the real user environment.\n */\n\n/** Layout constants — kept in one place so other modules can reuse them. */\nexport const SERVICEME_DIR_NAME = \".serviceme\";\nexport const REPOS_SUBDIR = \"repos\";\nexport const CACHE_SUBDIR = \"cache\";\nexport const DRAFTS_SUBDIR = \"drafts\";\nexport const SKILL_DRAFTS_SUBDIR = \"skills\";\nexport const AGENT_DRAFTS_SUBDIR = \"agents\";\nexport const REPOS_CONFIG_FILENAME = \"repos.json\";\nexport const WORKSPACES_SUBDIR = \"workspaces\";\nexport const WORKSPACE_CONTENT_STATE_FILENAME = \"copilot-content-state.json\";\n\n/**\n * Repo id regex — used to validate any `repoId` argument before it is joined\n * into a filesystem path. Keeps path traversal attempts out and gives us a\n * predictable on-disk shape.\n */\nexport const SAFE_REPO_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;\n\n/** Environment variable that overrides the user-home root directory. */\nexport const SERVICEME_HOME_ENV = \"SERVICEME_HOME\";\n\n/**\n * Test seam: lets unit tests inject deterministic values for `os.homedir()`\n * and the `SERVICEME_HOME` env override without actually mutating\n * `process.env` (which would leak into other tests).\n */\ninterface UserHomeOverrides {\n\thomeDir?: string | undefined;\n\tservicemeHomeEnv?: string | undefined;\n\tplatform?: NodeJS.Platform | undefined;\n}\n\nlet activeOverrides: UserHomeOverrides = {};\n\nexport function setUserHomeOverrides(overrides: UserHomeOverrides): void {\n\tactiveOverrides = { ...overrides };\n}\n\nexport function resetUserHomeOverrides(): void {\n\tactiveOverrides = {};\n}\n\nfunction resolveHomeDir(): string {\n\tconst injected = activeOverrides.homeDir;\n\tif (injected !== undefined) {\n\t\treturn injected;\n\t}\n\treturn os.homedir();\n}\n\nfunction resolveServicemeHomeEnv(): string | undefined {\n\tconst injected = activeOverrides.servicemeHomeEnv;\n\tif (injected !== undefined) {\n\t\t// Treat empty string as \"not set\" — `process.env` always returns a string\n\t\t// but tests may deliberately pass \"\" to opt out.\n\t\treturn injected.length > 0 ? injected : undefined;\n\t}\n\tconst envValue = process.env[SERVICEME_HOME_ENV];\n\treturn envValue && envValue.length > 0 ? envValue : undefined;\n}\n\nfunction resolvePlatform(): NodeJS.Platform {\n\treturn activeOverrides.platform ?? process.platform;\n}\n\nexport function assertSafeRepoId(repoId: string): string {\n\tif (typeof repoId !== \"string\" || repoId.length === 0 || !SAFE_REPO_ID_PATTERN.test(repoId)) {\n\t\tthrow new Error(\n\t\t\t`Invalid repo id: ${JSON.stringify(repoId)}. ` +\n\t\t\t\t`Must match ${SAFE_REPO_ID_PATTERN} (alphanumeric start, then ` +\n\t\t\t\t`alphanumerics / underscores / hyphens, ≤ 64 chars).`\n\t\t);\n\t}\n\treturn repoId;\n}\n\n/**\n * The raw OS home directory (`os.homedir()`), honoring test overrides\n * ({@link setUserHomeOverrides}). Exported for callers that need a\n * home-relative path *outside* of `~/.serviceme` — e.g. the\n * `~/.agents/{skills,agents}` convention used by `SkillLinker` for\n * user-scope links.\n */\nexport function getHomeDir(): string {\n\treturn resolveHomeDir();\n}\n\n/**\n * Root directory for all SERVICEME user-level state. Resolves to\n * `${SERVICEME_HOME}` when that env var is set, otherwise `${HOME}/.serviceme`\n * (POSIX) or `%USERPROFILE%\\.serviceme` (Windows via `os.homedir`).\n */\nexport function getServicemeHome(): string {\n\tconst override = resolveServicemeHomeEnv();\n\tif (override !== undefined) {\n\t\treturn path.resolve(override);\n\t}\n\treturn path.join(resolveHomeDir(), SERVICEME_DIR_NAME);\n}\n\n/** `$HOME/.serviceme/repos` (or `${SERVICEME_HOME}/repos`). */\nexport function getReposDir(): string {\n\treturn path.join(getServicemeHome(), REPOS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/repos/<repoId>` — validates `repoId` first. */\nexport function getRepoDir(repoId: string): string {\n\treturn path.join(getReposDir(), assertSafeRepoId(repoId));\n}\n\n/** `$HOME/.serviceme/cache` — generic per-user cache. */\nexport function getCacheDir(): string {\n\treturn path.join(getServicemeHome(), CACHE_SUBDIR);\n}\n\n/** `$HOME/.serviceme/cache/<repoId>` — per-repo sync state lives here. */\nexport function getRepoCacheDir(repoId: string): string {\n\treturn path.join(getCacheDir(), assertSafeRepoId(repoId));\n}\n\n/** `$HOME/.serviceme/drafts` — local edits not yet pushed upstream. */\nexport function getDraftsDir(): string {\n\treturn path.join(getServicemeHome(), DRAFTS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/drafts/skills` — local skill drafts. */\nexport function getSkillDraftsDir(): string {\n\treturn path.join(getDraftsDir(), SKILL_DRAFTS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/drafts/agents` — local agent drafts. */\nexport function getAgentDraftsDir(): string {\n\treturn path.join(getDraftsDir(), AGENT_DRAFTS_SUBDIR);\n}\n\n/**\n * `$HOME/.serviceme/repos.json` — the single config entry point for repo\n * metadata. Always under the resolved home root (i.e. follows\n * `SERVICEME_HOME` overrides too).\n */\nexport function getReposConfigPath(): string {\n\treturn path.join(getServicemeHome(), REPOS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/workspaces` — machine-local per-workspace state root. */\nexport function getWorkspacesDir(): string {\n\treturn path.join(getServicemeHome(), WORKSPACES_SUBDIR);\n}\n\n/**\n * Convenience helper for callers that need to switch behaviour on platform\n * (e.g. `SkillLinker` chooses symlink vs junction). Exported mostly so tests\n * can pin the value without touching `process.platform` directly.\n */\nexport function getHomePlatform(): NodeJS.Platform {\n\treturn resolvePlatform();\n}\n\n// ─── Scheduled Tasks paths (added by M1.5.3) ───────────────────────────────\n\n/** Layout constants for scheduled-tasks files. Kept here so other modules\n * can reuse them and the names stay in sync with the design doc. */\nexport const SCHEDULED_TASKS_CONFIG_FILENAME = \"scheduled-tasks.json\";\nexport const SCHEDULED_TASKS_LOG_FILENAME = \"scheduled-tasks-log.json\";\nexport const SCHEDULER_PID_FILENAME = \"scheduler.pid\";\nexport const SCHEDULER_LOCK_FILENAME = \"scheduler.lock\";\nexport const SCHEDULER_LOG_FILENAME = \"scheduler.log\";\nexport const MIGRATION_FAILURES_FILENAME = \"migration-failures.json\";\nexport const KNOWN_WORKSPACES_FILENAME = \"known-workspaces.json\";\n\n/** `~/.serviceme/scheduled-tasks.json` — the global v2 task list. */\nexport function getScheduledTasksConfigPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULED_TASKS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/scheduled-tasks-log.json` — the global execution log (200 LRU). */\nexport function getScheduledTasksLogPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULED_TASKS_LOG_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.pid` — global daemon PID file. */\nexport function getSchedulerPidPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_PID_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.lock` — global daemon startup flock. */\nexport function getSchedulerLockPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_LOCK_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.log` — global daemon log (daemon lifecycle, not task execution). */\nexport function getSchedulerLogPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_LOG_FILENAME);\n}\n\n/** `~/.serviceme/migration-failures.json` — diagnostics for failed v1→v2 imports. */\nexport function getMigrationFailuresPath(): string {\n\treturn path.join(getServicemeHome(), MIGRATION_FAILURES_FILENAME);\n}\n\n/** `~/.serviceme/known-workspaces.json` — workspace list the extension has seen. */\nexport function getKnownWorkspacesPath(): string {\n\treturn path.join(getServicemeHome(), KNOWN_WORKSPACES_FILENAME);\n}\n\n// ─── r7 BYOM Server Proxy (rev.20) ─────────────────────────────────────────\n\n/**\n * `~/.serviceme/server-proxy.json` — r7 BYOM Server Proxy toggle\n * self-state. Written by the extension's `ProxyConfigService`, readable\n * by the CLI / Server so they can decide whether to route traffic\n * through the corporate proxy without booting VS Code.\n *\n * Lives under user-level `~/.serviceme/` (not under a workspace) because\n * the toggle is a *user preference* — the same human enabling it on\n * machine A should be able to rely on it on machine B after sync, not\n * have it disappear when they switch repos.\n */\nexport function getServerProxyGlobalPath(): string {\n\treturn path.join(getServicemeHome(), SERVER_PROXY_GLOBAL_FILENAME);\n}\n\n// ─── Phase 5 (auth + device + toolbox) placeholders (Spec §11.12) ────────\n\n/** Layout constants for the Phase 5 client-side state files. The server\n * already has the corresponding routes (`/api/v1/auth/...`,\n * `/api/v1/device/...`, etc.) — the client just needs the on-disk\n * file paths + a first-run bootstrap so the auth/device/toolbox\n * services can open + read them without a per-call existence check. */\nexport const CREDENTIALS_CONFIG_FILENAME = \"credentials.json\";\nexport const DEVICE_JSON_FILENAME = \"device.json\";\nexport const TOOLBOX_JSON_FILENAME = \"toolbox.json\";\nexport const MACHINE_ID_FILENAME = \"machine-id\";\nexport const PROFILES_JSON_FILENAME = \"profiles.json\";\n\n/** `~/.serviceme/credentials.json` — better-auth session tokens + refresh state (client-side cache). */\nexport function getCredentialsConfigPath(): string {\n\treturn path.join(getServicemeHome(), CREDENTIALS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/device.json` — device enrollment payload (id, public key fingerprint, claimed-by). */\nexport function getDeviceJsonPath(): string {\n\treturn path.join(getServicemeHome(), DEVICE_JSON_FILENAME);\n}\n\n/** `~/.serviceme/toolbox.json` — local toolbox state (installed tool refs, per-user prefs). */\nexport function getToolboxJsonPath(): string {\n\treturn path.join(getServicemeHome(), TOOLBOX_JSON_FILENAME);\n}\n\n/** `~/.serviceme/machine-id` — opaque stable per-install id (uuid v4 string, no JSON wrapper). */\nexport function getMachineIdPath(): string {\n\treturn path.join(getServicemeHome(), MACHINE_ID_FILENAME);\n}\n\n/** `~/.serviceme/profiles.json` — cached projection of server-side profile rows; refresh on demand. */\nexport function getProfilesJsonPath(): string {\n\treturn path.join(getServicemeHome(), PROFILES_JSON_FILENAME);\n}\n"],"mappings":"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"}

package/dist/{userHome-CcnAQPG1.mjs → userHome-DOMLiHy7.mjs}

@@ -22,8 +22,6 @@ const AGENT_DRAFTS_SUBDIR = "agents";
 const REPOS_CONFIG_FILENAME = "repos.json";
 const WORKSPACES_SUBDIR = "workspaces";
 const WORKSPACE_CONTENT_STATE_FILENAME = "copilot-content-state.json";
-/** rev.20 — r7 BYOM Server Proxy toggle self-state (read by ext + CLI + server). */
-const SERVER_PROXY_GLOBAL_FILENAME = "server-proxy.json";
 /**
 * Repo id regex — used to validate any `repoId` argument before it is joined
 * into a filesystem path. Keeps path traversal attempts out and gives us a
@@ -207,6 +205,6 @@ function getProfilesJsonPath() {
 	return path.join(getServicemeHome(), PROFILES_JSON_FILENAME);
 }
 //#endregion
-export { getDraftsDir as A, getReposDir as B, WORKSPACES_SUBDIR as C, getCacheDir as D, getAgentDraftsDir as E, getMigrationFailuresPath as F, getSchedulerPidPath as G, getScheduledTasksLogPath as H, getProfilesJsonPath as I, getSkillDraftsDir as J, getServerProxyGlobalPath as K, getRepoCacheDir as L, getHomePlatform as M, getKnownWorkspacesPath as N, getCredentialsConfigPath as O, getMachineIdPath as P, setUserHomeOverrides as Q, getRepoDir as R, TOOLBOX_JSON_FILENAME as S, assertSafeRepoId as T, getSchedulerLockPath as U, getScheduledTasksConfigPath as V, getSchedulerLogPath as W, getWorkspacesDir as X, getToolboxJsonPath as Y, resetUserHomeOverrides as Z, SCHEDULER_PID_FILENAME as _, DRAFTS_SUBDIR as a, SERVICEME_HOME_ENV as b, MIGRATION_FAILURES_FILENAME as c, REPOS_SUBDIR as d, SAFE_REPO_ID_PATTERN as f, SCHEDULER_LOG_FILENAME as g, SCHEDULER_LOCK_FILENAME as h, DEVICE_JSON_FILENAME as i, getHomeDir as j, getDeviceJsonPath as k, PROFILES_JSON_FILENAME as l, SCHEDULED_TASKS_LOG_FILENAME as m, CACHE_SUBDIR as n, KNOWN_WORKSPACES_FILENAME as o, SCHEDULED_TASKS_CONFIG_FILENAME as p, getServicemeHome as q, CREDENTIALS_CONFIG_FILENAME as r, MACHINE_ID_FILENAME as s, AGENT_DRAFTS_SUBDIR as t, REPOS_CONFIG_FILENAME as u, SERVER_PROXY_GLOBAL_FILENAME as v, WORKSPACE_CONTENT_STATE_FILENAME as w, SKILL_DRAFTS_SUBDIR as x, SERVICEME_DIR_NAME as y, getReposConfigPath as z };
+export { getHomeDir as A, getScheduledTasksConfigPath as B, WORKSPACE_CONTENT_STATE_FILENAME as C, getCredentialsConfigPath as D, getCacheDir as E, getProfilesJsonPath as F, getServerProxyGlobalPath as G, getSchedulerLockPath as H, getRepoCacheDir as I, getToolboxJsonPath as J, getServicemeHome as K, getRepoDir as L, getKnownWorkspacesPath as M, getMachineIdPath as N, getDeviceJsonPath as O, getMigrationFailuresPath as P, getReposConfigPath as R, WORKSPACES_SUBDIR as S, getAgentDraftsDir as T, getSchedulerLogPath as U, getScheduledTasksLogPath as V, getSchedulerPidPath as W, resetUserHomeOverrides as X, getWorkspacesDir as Y, setUserHomeOverrides as Z, SCHEDULER_PID_FILENAME as _, DRAFTS_SUBDIR as a, SKILL_DRAFTS_SUBDIR as b, MIGRATION_FAILURES_FILENAME as c, REPOS_SUBDIR as d, SAFE_REPO_ID_PATTERN as f, SCHEDULER_LOG_FILENAME as g, SCHEDULER_LOCK_FILENAME as h, DEVICE_JSON_FILENAME as i, getHomePlatform as j, getDraftsDir as k, PROFILES_JSON_FILENAME as l, SCHEDULED_TASKS_LOG_FILENAME as m, CACHE_SUBDIR as n, KNOWN_WORKSPACES_FILENAME as o, SCHEDULED_TASKS_CONFIG_FILENAME as p, getSkillDraftsDir as q, CREDENTIALS_CONFIG_FILENAME as r, MACHINE_ID_FILENAME as s, AGENT_DRAFTS_SUBDIR as t, REPOS_CONFIG_FILENAME as u, SERVICEME_DIR_NAME as v, assertSafeRepoId as w, TOOLBOX_JSON_FILENAME as x, SERVICEME_HOME_ENV as y, getReposDir as z };
 
-//# sourceMappingURL=userHome-CcnAQPG1.mjs.map
+//# sourceMappingURL=userHome-DOMLiHy7.mjs.map

package/dist/userHome-DOMLiHy7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"userHome-DOMLiHy7.mjs","names":[],"sources":["../src/paths/userHome.ts"],"sourcesContent":["import * as os from \"node:os\";\nimport * as path from \"node:path\";\n\n/**\n * SERVICEME user home directory helpers.\n *\n * All paths resolve under {@link getServicemeHome}, which is either the\n * `SERVICEME_HOME` environment variable (when set and non-empty) or\n * `$HOME/.serviceme` on POSIX / `%USERPROFILE%\\.serviceme` on Windows.\n *\n * Tests inject `homeDir` and `servicemeHomeEnv` overrides via\n * {@link setUserHomeOverrides} / {@link resetUserHomeOverrides} so they can\n * exercise the path logic without touching the real user environment.\n */\n\n/** Layout constants — kept in one place so other modules can reuse them. */\nexport const SERVICEME_DIR_NAME = \".serviceme\";\nexport const REPOS_SUBDIR = \"repos\";\nexport const CACHE_SUBDIR = \"cache\";\nexport const DRAFTS_SUBDIR = \"drafts\";\nexport const SKILL_DRAFTS_SUBDIR = \"skills\";\nexport const AGENT_DRAFTS_SUBDIR = \"agents\";\nexport const REPOS_CONFIG_FILENAME = \"repos.json\";\nexport const WORKSPACES_SUBDIR = \"workspaces\";\nexport const WORKSPACE_CONTENT_STATE_FILENAME = \"copilot-content-state.json\";\n\n/**\n * Repo id regex — used to validate any `repoId` argument before it is joined\n * into a filesystem path. Keeps path traversal attempts out and gives us a\n * predictable on-disk shape.\n */\nexport const SAFE_REPO_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;\n\n/** Environment variable that overrides the user-home root directory. */\nexport const SERVICEME_HOME_ENV = \"SERVICEME_HOME\";\n\n/**\n * Test seam: lets unit tests inject deterministic values for `os.homedir()`\n * and the `SERVICEME_HOME` env override without actually mutating\n * `process.env` (which would leak into other tests).\n */\ninterface UserHomeOverrides {\n\thomeDir?: string | undefined;\n\tservicemeHomeEnv?: string | undefined;\n\tplatform?: NodeJS.Platform | undefined;\n}\n\nlet activeOverrides: UserHomeOverrides = {};\n\nexport function setUserHomeOverrides(overrides: UserHomeOverrides): void {\n\tactiveOverrides = { ...overrides };\n}\n\nexport function resetUserHomeOverrides(): void {\n\tactiveOverrides = {};\n}\n\nfunction resolveHomeDir(): string {\n\tconst injected = activeOverrides.homeDir;\n\tif (injected !== undefined) {\n\t\treturn injected;\n\t}\n\treturn os.homedir();\n}\n\nfunction resolveServicemeHomeEnv(): string | undefined {\n\tconst injected = activeOverrides.servicemeHomeEnv;\n\tif (injected !== undefined) {\n\t\t// Treat empty string as \"not set\" — `process.env` always returns a string\n\t\t// but tests may deliberately pass \"\" to opt out.\n\t\treturn injected.length > 0 ? injected : undefined;\n\t}\n\tconst envValue = process.env[SERVICEME_HOME_ENV];\n\treturn envValue && envValue.length > 0 ? envValue : undefined;\n}\n\nfunction resolvePlatform(): NodeJS.Platform {\n\treturn activeOverrides.platform ?? process.platform;\n}\n\nexport function assertSafeRepoId(repoId: string): string {\n\tif (typeof repoId !== \"string\" || repoId.length === 0 || !SAFE_REPO_ID_PATTERN.test(repoId)) {\n\t\tthrow new Error(\n\t\t\t`Invalid repo id: ${JSON.stringify(repoId)}. ` +\n\t\t\t\t`Must match ${SAFE_REPO_ID_PATTERN} (alphanumeric start, then ` +\n\t\t\t\t`alphanumerics / underscores / hyphens, ≤ 64 chars).`\n\t\t);\n\t}\n\treturn repoId;\n}\n\n/**\n * The raw OS home directory (`os.homedir()`), honoring test overrides\n * ({@link setUserHomeOverrides}). Exported for callers that need a\n * home-relative path *outside* of `~/.serviceme` — e.g. the\n * `~/.agents/{skills,agents}` convention used by `SkillLinker` for\n * user-scope links.\n */\nexport function getHomeDir(): string {\n\treturn resolveHomeDir();\n}\n\n/**\n * Root directory for all SERVICEME user-level state. Resolves to\n * `${SERVICEME_HOME}` when that env var is set, otherwise `${HOME}/.serviceme`\n * (POSIX) or `%USERPROFILE%\\.serviceme` (Windows via `os.homedir`).\n */\nexport function getServicemeHome(): string {\n\tconst override = resolveServicemeHomeEnv();\n\tif (override !== undefined) {\n\t\treturn path.resolve(override);\n\t}\n\treturn path.join(resolveHomeDir(), SERVICEME_DIR_NAME);\n}\n\n/** `$HOME/.serviceme/repos` (or `${SERVICEME_HOME}/repos`). */\nexport function getReposDir(): string {\n\treturn path.join(getServicemeHome(), REPOS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/repos/<repoId>` — validates `repoId` first. */\nexport function getRepoDir(repoId: string): string {\n\treturn path.join(getReposDir(), assertSafeRepoId(repoId));\n}\n\n/** `$HOME/.serviceme/cache` — generic per-user cache. */\nexport function getCacheDir(): string {\n\treturn path.join(getServicemeHome(), CACHE_SUBDIR);\n}\n\n/** `$HOME/.serviceme/cache/<repoId>` — per-repo sync state lives here. */\nexport function getRepoCacheDir(repoId: string): string {\n\treturn path.join(getCacheDir(), assertSafeRepoId(repoId));\n}\n\n/** `$HOME/.serviceme/drafts` — local edits not yet pushed upstream. */\nexport function getDraftsDir(): string {\n\treturn path.join(getServicemeHome(), DRAFTS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/drafts/skills` — local skill drafts. */\nexport function getSkillDraftsDir(): string {\n\treturn path.join(getDraftsDir(), SKILL_DRAFTS_SUBDIR);\n}\n\n/** `$HOME/.serviceme/drafts/agents` — local agent drafts. */\nexport function getAgentDraftsDir(): string {\n\treturn path.join(getDraftsDir(), AGENT_DRAFTS_SUBDIR);\n}\n\n/**\n * `$HOME/.serviceme/repos.json` — the single config entry point for repo\n * metadata. Always under the resolved home root (i.e. follows\n * `SERVICEME_HOME` overrides too).\n */\nexport function getReposConfigPath(): string {\n\treturn path.join(getServicemeHome(), REPOS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/workspaces` — machine-local per-workspace state root. */\nexport function getWorkspacesDir(): string {\n\treturn path.join(getServicemeHome(), WORKSPACES_SUBDIR);\n}\n\n/**\n * Convenience helper for callers that need to switch behaviour on platform\n * (e.g. `SkillLinker` chooses symlink vs junction). Exported mostly so tests\n * can pin the value without touching `process.platform` directly.\n */\nexport function getHomePlatform(): NodeJS.Platform {\n\treturn resolvePlatform();\n}\n\n// ─── Scheduled Tasks paths (added by M1.5.3) ───────────────────────────────\n\n/** Layout constants for scheduled-tasks files. Kept here so other modules\n * can reuse them and the names stay in sync with the design doc. */\nexport const SCHEDULED_TASKS_CONFIG_FILENAME = \"scheduled-tasks.json\";\nexport const SCHEDULED_TASKS_LOG_FILENAME = \"scheduled-tasks-log.json\";\nexport const SCHEDULER_PID_FILENAME = \"scheduler.pid\";\nexport const SCHEDULER_LOCK_FILENAME = \"scheduler.lock\";\nexport const SCHEDULER_LOG_FILENAME = \"scheduler.log\";\nexport const MIGRATION_FAILURES_FILENAME = \"migration-failures.json\";\nexport const KNOWN_WORKSPACES_FILENAME = \"known-workspaces.json\";\n\n/** `~/.serviceme/scheduled-tasks.json` — the global v2 task list. */\nexport function getScheduledTasksConfigPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULED_TASKS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/scheduled-tasks-log.json` — the global execution log (200 LRU). */\nexport function getScheduledTasksLogPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULED_TASKS_LOG_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.pid` — global daemon PID file. */\nexport function getSchedulerPidPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_PID_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.lock` — global daemon startup flock. */\nexport function getSchedulerLockPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_LOCK_FILENAME);\n}\n\n/** `~/.serviceme/scheduler.log` — global daemon log (daemon lifecycle, not task execution). */\nexport function getSchedulerLogPath(): string {\n\treturn path.join(getServicemeHome(), SCHEDULER_LOG_FILENAME);\n}\n\n/** `~/.serviceme/migration-failures.json` — diagnostics for failed v1→v2 imports. */\nexport function getMigrationFailuresPath(): string {\n\treturn path.join(getServicemeHome(), MIGRATION_FAILURES_FILENAME);\n}\n\n/** `~/.serviceme/known-workspaces.json` — workspace list the extension has seen. */\nexport function getKnownWorkspacesPath(): string {\n\treturn path.join(getServicemeHome(), KNOWN_WORKSPACES_FILENAME);\n}\n\n// ─── r7 BYOM Server Proxy (rev.20) ─────────────────────────────────────────\n\n/**\n * `~/.serviceme/server-proxy.json` — r7 BYOM Server Proxy toggle\n * self-state. Written by the extension's `ProxyConfigService`, readable\n * by the CLI / Server so they can decide whether to route traffic\n * through the corporate proxy without booting VS Code.\n *\n * Lives under user-level `~/.serviceme/` (not under a workspace) because\n * the toggle is a *user preference* — the same human enabling it on\n * machine A should be able to rely on it on machine B after sync, not\n * have it disappear when they switch repos.\n */\nexport function getServerProxyGlobalPath(): string {\n\treturn path.join(getServicemeHome(), SERVER_PROXY_GLOBAL_FILENAME);\n}\n\n// ─── Phase 5 (auth + device + toolbox) placeholders (Spec §11.12) ────────\n\n/** Layout constants for the Phase 5 client-side state files. The server\n * already has the corresponding routes (`/api/v1/auth/...`,\n * `/api/v1/device/...`, etc.) — the client just needs the on-disk\n * file paths + a first-run bootstrap so the auth/device/toolbox\n * services can open + read them without a per-call existence check. */\nexport const CREDENTIALS_CONFIG_FILENAME = \"credentials.json\";\nexport const DEVICE_JSON_FILENAME = \"device.json\";\nexport const TOOLBOX_JSON_FILENAME = \"toolbox.json\";\nexport const MACHINE_ID_FILENAME = \"machine-id\";\nexport const PROFILES_JSON_FILENAME = \"profiles.json\";\n\n/** `~/.serviceme/credentials.json` — better-auth session tokens + refresh state (client-side cache). */\nexport function getCredentialsConfigPath(): string {\n\treturn path.join(getServicemeHome(), CREDENTIALS_CONFIG_FILENAME);\n}\n\n/** `~/.serviceme/device.json` — device enrollment payload (id, public key fingerprint, claimed-by). */\nexport function getDeviceJsonPath(): string {\n\treturn path.join(getServicemeHome(), DEVICE_JSON_FILENAME);\n}\n\n/** `~/.serviceme/toolbox.json` — local toolbox state (installed tool refs, per-user prefs). */\nexport function getToolboxJsonPath(): string {\n\treturn path.join(getServicemeHome(), TOOLBOX_JSON_FILENAME);\n}\n\n/** `~/.serviceme/machine-id` — opaque stable per-install id (uuid v4 string, no JSON wrapper). */\nexport function getMachineIdPath(): string {\n\treturn path.join(getServicemeHome(), MACHINE_ID_FILENAME);\n}\n\n/** `~/.serviceme/profiles.json` — cached projection of server-side profile rows; refresh on demand. */\nexport function getProfilesJsonPath(): string {\n\treturn path.join(getServicemeHome(), PROFILES_JSON_FILENAME);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serviceme/devtools-core",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Reusable Node.js core capabilities powering the SERVICEME CLI and integrations.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -81,7 +81,7 @@
     "json5": "^2.2.3",
     "yauzl": "^3.2.0",
     "zod": "^4.5.4",
-    "@serviceme/devtools-protocol": "2.0.2"
+    "@serviceme/devtools-protocol": "2.0.4"
   },
   "devDependencies": {
     "@types/node": "^24",