@serviceme/devtools-core 2.0.5 → 2.0.6

package/dist/toolbox-BV7vLGXZ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolbox-BV7vLGXZ.js","names":["path","fsp","delay","getToolboxJsonPath"],"sources":["../src/toolbox/sort.ts","../src/toolbox/types.ts","../src/toolbox/ToolboxStore.ts","../src/toolbox/ToolboxCore.ts"],"sourcesContent":["/**\n * toolbox sort + dedup — pure helpers, no I/O.\n *\n * The Extension's `ToolBoxService` keeps a stable `order` index and\n * surfaces \"recently used\" via the `lastUsedAt` ISO timestamp. These\n * helpers codify that algorithm so the CLI and Extension agree on the\n * \"最近使用置顶\" UX.\n *\n * Refs:\n * - 4.功能规划.md §2.3 — `sort.ts 排序与去重纯函数`\n */\n\nimport type { ExternalTool } from \"@serviceme/devtools-protocol\";\n\n/**\n * Parsed timestamp from `lastUsedAt`. Returns 0 when the field is\n * missing or unparseable (so the entry falls below entries with a\n * real timestamp).\n */\nfunction lastUsedTimestamp(tool: ExternalTool): number {\n\tif (!tool.lastUsedAt) return 0;\n\tconst ms = Date.parse(tool.lastUsedAt);\n\treturn Number.isFinite(ms) ? ms : 0;\n}\n\n/**\n * Sort by \"recently used\" — entries with newer `lastUsedAt` float to\n * the top, entries with no `lastUsedAt` sort to the bottom (preserving\n * their relative `order` index when both are absent).\n *\n * Ties (same `lastUsedAt` or both missing) are broken by `order`, then\n * by `id` for determinism.\n */\nexport function sortByRecentFirst(tools: readonly ExternalTool[]): ExternalTool[] {\n\treturn [...tools].sort((a, b) => {\n\t\tconst tsA = lastUsedTimestamp(a);\n\t\tconst tsB = lastUsedTimestamp(b);\n\t\tif (tsA !== tsB) return tsB - tsA;\n\t\tconst orderA = a.order ?? Number.MAX_SAFE_INTEGER;\n\t\tconst orderB = b.order ?? Number.MAX_SAFE_INTEGER;\n\t\tif (orderA !== orderB) return orderA - orderB;\n\t\treturn a.id.localeCompare(b.id);\n\t});\n}\n\n/**\n * Sort by user-defined `order` field. Entries without `order` are\n * appended in their input order (stable sort via `id` tiebreaker).\n */\nexport function sortByUserOrder(tools: readonly ExternalTool[]): ExternalTool[] {\n\treturn [...tools].sort((a, b) => {\n\t\tconst orderA = a.order ?? Number.MAX_SAFE_INTEGER;\n\t\tconst orderB = b.order ?? Number.MAX_SAFE_INTEGER;\n\t\tif (orderA !== orderB) return orderA - orderB;\n\t\treturn a.id.localeCompare(b.id);\n\t});\n}\n\n/**\n * Deduplicate by `id`. The first occurrence wins; later ones are\n * discarded. Used when merging built-in + user seeds so duplicates\n * from the on-disk file don't shadow the built-in defaults.\n */\nexport function dedupeById(tools: readonly ExternalTool[]): ExternalTool[] {\n\tconst seen = new Set<string>();\n\tconst out: ExternalTool[] = [];\n\tfor (const tool of tools) {\n\t\tif (seen.has(tool.id)) continue;\n\t\tseen.add(tool.id);\n\t\tout.push(tool);\n\t}\n\treturn out;\n}\n\n/**\n * Merge built-in defaults with user-stored tools. Defaults keep\n * `isDefault: true` and their `order`; user tools are appended with\n * their stored metadata. Output is sorted by user order.\n */\nexport function mergeWithDefaults(\n\tdefaults: readonly ExternalTool[],\n\tuserTools: readonly ExternalTool[]\n): ExternalTool[] {\n\tconst defaultIds = new Set(defaults.map((d) => d.id));\n\tconst uniqueUserTools = userTools.filter((t) => !defaultIds.has(t.id));\n\treturn sortByUserOrder([...defaults, ...uniqueUserTools]);\n}\n\n/**\n * Re-number `order` for a list of tool ids. Used by\n * `toolbox.update` when the user drags-and-drops entries in the UI.\n */\nexport function reindexOrder(\n\ttools: ExternalTool[],\n\tnewOrderIds: readonly string[]\n): ExternalTool[] {\n\tconst orderMap = new Map<string, number>();\n\tfor (const [index, id] of newOrderIds.entries()) {\n\t\torderMap.set(id, index);\n\t}\n\tfor (const tool of tools) {\n\t\tconst next = orderMap.get(tool.id);\n\t\tif (next !== undefined) tool.order = next;\n\t}\n\treturn tools;\n}\n\n/**\n * Stamp `lastUsedAt` on the targeted tool (clones the array). Returns\n * a new array; the input is left untouched.\n */\nexport function touchLastUsedAt(\n\ttools: readonly ExternalTool[],\n\tid: string,\n\twhen: Date = new Date()\n): ExternalTool[] {\n\treturn tools.map((tool) => (tool.id === id ? { ...tool, lastUsedAt: when.toISOString() } : tool));\n}\n","/**\n * toolbox types — internal-only data shapes.\n *\n * The public data model lives in `@serviceme/devtools-protocol/toolbox`\n * (`ExternalTool`, `ToolboxScope`, `ToolboxList`). The types below are\n * the persisted on-disk shape and the patch helpers, scoped to the\n * toolbox domain only.\n *\n * Refs:\n * - 4.功能规划.md §2.3 — `toolbox/types.ts`\n */\n\nimport type { ExternalTool, ToolboxScope } from \"@serviceme/devtools-protocol\";\n\n/** Schema version of the on-disk toolbox JSON files. Bumped on breaking changes. */\nexport const TOOLBOX_JSON_SCHEMA_VERSION = 1;\n\nexport interface PersistedToolbox {\n\tversion: number;\n\ttools: ExternalTool[];\n}\n\n/** Patch payload accepted by `ToolboxCore.update` (mirrors `ExternalToolPatch`). */\nexport type ToolboxPatch = Partial<Omit<ExternalTool, \"id\" | \"isDefault\">>;\n\n/**\n * Built-in (default) tool seeds. Mirrors the Extension's\n * `apps/extension/src/config/external-tools.ts`. The Core stores these\n * verbatim and never mutates them — the Extension's `ToolBoxService`\n * runs the same merge on top of the Core's view.\n */\nexport interface DefaultToolSeed {\n\tid: string;\n\tname: string;\n\tdescription: string;\n\ticon: string;\n\turl: string;\n}\n\n/** Built-in tools rendered when the JSON file is missing or empty. */\nexport const BUILTIN_DEFAULT_TOOLS: readonly DefaultToolSeed[] = [\n\t{\n\t\tid: \"builtin-docs\",\n\t\tname: \"SERVICEME Docs\",\n\t\tdescription: \"Official documentation portal\",\n\t\ticon: \"book\",\n\t\turl: \"https://docs.medalsoft.com/serviceme\",\n\t},\n\t{\n\t\tid: \"builtin-issues\",\n\t\tname: \"Issue Tracker\",\n\t\tdescription: \"Report bugs and feature requests\",\n\t\ticon: \"bug\",\n\t\turl: \"https://github.com/medalsoftchina/ms-devtools-vscode/issues\",\n\t},\n\t{\n\t\tid: \"builtin-changelog\",\n\t\tname: \"Changelog\",\n\t\tdescription: \"Release notes for every published version\",\n\t\ticon: \"history\",\n\t\turl: \"https://github.com/medalsoftchina/ms-devtools-vscode/releases\",\n\t},\n];\n\n/** Resolved toolbox shape returned by `ToolboxStore.read()`. */\nexport interface ResolvedToolbox {\n\tscope: ToolboxScope;\n\ttools: ExternalTool[];\n}\n","/**\n * ToolboxStore — JSON persistence for the toolbox entries.\n *\n * Two scopes:\n *   - `user`      → `~/.serviceme/toolbox.json`\n *   - `workspace` → `<cwd>/.github/.serviceme-toolbox.json`\n *\n * Both files share the `PersistedToolbox` shape and the same atomic\n * write pattern (tmp + rename + fsync) as `IdentityStore`. Concurrent\n * writers are serialized via a mkdir-based file lock (Phase 6+ may\n * upgrade to `proper-lockfile`).\n *\n * Refs:\n * - 4.功能规划.md §2.3 — `ToolboxStore.ts JSON 持久化(user + workspace scope)`\n * - `3.功能拆分.md` §3 — toolbox wire shape\n */\n\nimport * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { setTimeout as delay } from \"node:timers/promises\";\n\nimport type { ExternalTool, ToolboxScope } from \"@serviceme/devtools-protocol\";\n\nimport { getToolboxJsonPath } from \"../paths/userHome\";\n\nimport { mergeWithDefaults, sortByUserOrder } from \"./sort\";\nimport {\n\tBUILTIN_DEFAULT_TOOLS,\n\ttype DefaultToolSeed,\n\ttype PersistedToolbox,\n\ttype ResolvedToolbox,\n\tTOOLBOX_JSON_SCHEMA_VERSION,\n} from \"./types\";\n\nconst FILE_MODE = 0o600;\nconst LOCK_DIR_MODE = 0o700;\nconst DEFAULT_LOCK_TIMEOUT_MS = 5000;\nconst DEFAULT_LOCK_RETRY_MS = 25;\n// `mkdir` (lock acquisition) and writing the pid file are two separate\n// syscalls, so there's a brief window where the lock dir exists but the\n// pid file doesn't yet. A grace period keeps a concurrent acquirer from\n// mistaking that window for an abandoned lock (see `isStaleLock`).\nconst LOCK_STALE_GRACE_MS = 200;\nconst TMP_SUFFIX = \".tmp\";\nexport const WORKSPACE_TOOLBOX_RELATIVE_PATH = path.join(\".github\", \".serviceme-toolbox.json\");\nconst LEGACY_WORKSPACE_TOOLBOX_FILENAME = \".ms-devtools-toolbox.json\";\n\n/**\n * One-time migration: the workspace-scope toolbox file used to be named\n * `.ms-devtools-toolbox.json`. If the new `.serviceme-toolbox.json` doesn't\n * exist yet but the legacy file does (in the same directory), rename it\n * forward so existing toolbox entries aren't silently lost.\n */\nasync function migrateLegacyWorkspaceToolboxFile(filePath: string | null): Promise<void> {\n\tif (!filePath) return;\n\tconst legacyPath = path.join(path.dirname(filePath), LEGACY_WORKSPACE_TOOLBOX_FILENAME);\n\tif (legacyPath === filePath) return;\n\ttry {\n\t\tawait fsp.access(filePath);\n\t\treturn;\n\t} catch {\n\t\t// new file missing — check the legacy path below\n\t}\n\ttry {\n\t\tawait fsp.rename(legacyPath, filePath);\n\t} catch {\n\t\t// legacy file doesn't exist either — nothing to migrate\n\t}\n}\n\nexport interface ToolboxFileBackend {\n\tread(filePath: string): Promise<PersistedToolbox | null>;\n\twrite(filePath: string, payload: PersistedToolbox): Promise<void>;\n\texists(filePath: string): Promise<boolean>;\n\t/** Maximum number of `.corrupted.*.bak` snapshots to keep per toolbox file (default: 5). */\n\tmaxBackupCount?: number;\n}\n\nexport interface ToolboxStoreOptions {\n\t/** Override the user-scope file path (default: `getToolboxJsonPath()`). */\n\tuserFilePath?: string;\n\t/** Override the workspace-scope file path resolver (default: cwd-relative). */\n\tresolveWorkspacePath?: () => string | null;\n\t/** Injectable built-in tool seeds (default: `BUILTIN_DEFAULT_TOOLS`). */\n\tdefaultTools?: readonly DefaultToolSeed[];\n\thooks?: ToolboxStoreHooks;\n\tbackend?: ToolboxFileBackend;\n\tlockTimeoutMs?: number;\n\tlockRetryMs?: number;\n}\n\nexport interface ToolboxStoreHooks {\n\tbeforeWrite?: (scope: ToolboxScope, payload: PersistedToolbox) => void | Promise<void>;\n\tafterWrite?: (scope: ToolboxScope, payload: PersistedToolbox) => void | Promise<void>;\n}\n\nexport class FsToolboxFileBackend implements ToolboxFileBackend {\n\tmaxBackupCount: number = 5;\n\n\tasync exists(filePath: string): Promise<boolean> {\n\t\ttry {\n\t\t\tawait fsp.access(filePath);\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync read(filePath: string): Promise<PersistedToolbox | null> {\n\t\tlet buf: string;\n\t\ttry {\n\t\t\tbuf = await fsp.readFile(filePath, \"utf8\");\n\t\t} catch (err) {\n\t\t\tif (isNodeError(err) && err.code === \"ENOENT\") return null;\n\t\t\tthrow err;\n\t\t}\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(buf) as unknown;\n\t\t\treturn coercePersistedToolbox(parsed);\n\t\t} catch {\n\t\t\t// File exists but is unparseable JSON or fails schema validation\n\t\t\t// (e.g. hand-edited, written by an older/incompatible schema, or\n\t\t\t// truncated by a crash). Quarantine it as a timestamped `.bak`\n\t\t\t// sibling and fall back to an empty toolbox (defaults still\n\t\t\t// merge in via `ToolboxStore.read()`) rather than crashing the\n\t\t\t// whole \"get external tools\" request.\n\t\t\tawait this.backupCorruptedFile(filePath);\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate async backupCorruptedFile(filePath: string): Promise<void> {\n\t\ttry {\n\t\t\tconst backupPath = `${filePath}.corrupted.${Date.now()}.bak`;\n\t\t\tawait fsp.copyFile(filePath, backupPath);\n\t\t\tawait this.purgeExcessBackups(filePath);\n\t\t} catch {\n\t\t\t// Best-effort backup — never let backup failure mask the real recovery.\n\t\t}\n\t}\n\n\tprivate async purgeExcessBackups(filePath: string): Promise<void> {\n\t\tconst dir = path.dirname(filePath);\n\t\tconst base = path.basename(filePath);\n\t\tlet entries: string[];\n\t\ttry {\n\t\t\tentries = await fsp.readdir(dir);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tconst backups = entries\n\t\t\t.filter((n) => n.startsWith(base) && n.endsWith(\".bak\"))\n\t\t\t.map((n) => ({ name: n, filePath: path.join(dir, n) }))\n\t\t\t.sort((a, b) => {\n\t\t\t\t// Sort oldest-first so we drop the earliest ones first.\n\t\t\t\treturn a.name.localeCompare(b.name);\n\t\t\t});\n\t\tconst excess = backups.length - this.maxBackupCount;\n\t\tif (excess <= 0) return;\n\t\tawait Promise.all(\n\t\t\tbackups.slice(0, excess).map((b) => fsp.rm(b.filePath).catch(() => undefined))\n\t\t);\n\t}\n\n\tasync write(filePath: string, payload: PersistedToolbox): Promise<void> {\n\t\tawait fsp.mkdir(path.dirname(filePath), { recursive: true });\n\t\tconst tmpPath = `${filePath}${TMP_SUFFIX}`;\n\t\tconst bytes = Buffer.from(JSON.stringify(payload, null, \"\\t\"), \"utf8\");\n\t\tawait fsp.rm(tmpPath, { force: true });\n\t\tconst handle = await fsp.open(tmpPath, \"w\", FILE_MODE);\n\t\ttry {\n\t\t\tawait handle.writeFile(bytes);\n\t\t\tawait handle.sync();\n\t\t} finally {\n\t\t\tawait handle.close();\n\t\t}\n\t\tawait fsp.rename(tmpPath, filePath);\n\t\tawait fsp.chmod(filePath, FILE_MODE).catch(() => undefined);\n\t}\n}\n\nfunction coercePersistedToolbox(parsed: unknown): PersistedToolbox {\n\tif (typeof parsed !== \"object\" || parsed === null) {\n\t\tthrow new Error(\"toolbox.json: top-level must be an object\");\n\t}\n\tconst obj = parsed as Record<string, unknown>;\n\tconst version = obj.version;\n\tif (version !== TOOLBOX_JSON_SCHEMA_VERSION) {\n\t\tthrow new Error(`toolbox.json: unsupported schema version ${String(version)}`);\n\t}\n\tif (!Array.isArray(obj.tools)) {\n\t\tthrow new Error(\"toolbox.json: 'tools' must be an array\");\n\t}\n\treturn { version, tools: obj.tools as ExternalTool[] };\n}\n\nfunction isNodeError(value: unknown): value is NodeJS.ErrnoException {\n\treturn value instanceof Error && typeof (value as { code?: unknown }).code === \"string\";\n}\n\nfunction isProcessAlive(pid: number): boolean {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nclass ToolboxFileLock {\n\tprivate readonly dirPath: string;\n\tprivate readonly pidFilePath: string;\n\tprivate readonly timeoutMs: number;\n\tprivate readonly retryMs: number;\n\tprivate acquired = false;\n\n\tconstructor(filePath: string, timeoutMs: number, retryMs: number) {\n\t\tthis.dirPath = `${filePath}.lock`;\n\t\tthis.pidFilePath = path.join(this.dirPath, \"pid\");\n\t\tthis.timeoutMs = timeoutMs;\n\t\tthis.retryMs = retryMs;\n\t}\n\n\tasync acquire(): Promise<void> {\n\t\tconst start = Date.now();\n\t\twhile (true) {\n\t\t\ttry {\n\t\t\t\tawait fsp.mkdir(this.dirPath, { mode: LOCK_DIR_MODE });\n\t\t\t\tawait fsp.writeFile(this.pidFilePath, String(process.pid), \"utf8\").catch(() => undefined);\n\t\t\t\tthis.acquired = true;\n\t\t\t\treturn;\n\t\t\t} catch (err) {\n\t\t\t\tif (!isNodeError(err) || err.code !== \"EEXIST\") throw err;\n\t\t\t\tconst stale = await this.isStaleLock();\n\t\t\t\tif (stale) {\n\t\t\t\t\tawait fsp.rm(this.dirPath, { recursive: true, force: true });\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (Date.now() - start >= this.timeoutMs) {\n\t\t\t\t\tthrow new Error(`ToolboxStore lock acquisition timed out for ${this.dirPath}`);\n\t\t\t\t}\n\t\t\t\tawait delay(this.retryMs);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async isStaleLock(): Promise<boolean> {\n\t\tlet pidStr: string;\n\t\ttry {\n\t\t\tpidStr = await fsp.readFile(this.pidFilePath, \"utf8\");\n\t\t} catch {\n\t\t\t// The pid file may not exist yet because another acquirer just\n\t\t\t// created the lock dir and hasn't finished writing its pid file\n\t\t\t// (mkdir + writeFile is not atomic). Give it a short grace window\n\t\t\t// before concluding the owner crashed between mkdir and writeFile.\n\t\t\ttry {\n\t\t\t\tconst stat = await fsp.stat(this.dirPath);\n\t\t\t\treturn Date.now() - stat.mtimeMs > LOCK_STALE_GRACE_MS;\n\t\t\t} catch {\n\t\t\t\t// Lock dir disappeared concurrently (e.g. released mid-check) —\n\t\t\t\t// not stale, just gone; the caller's next mkdir will succeed.\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\tconst pid = Number.parseInt(pidStr.trim(), 10);\n\t\tif (!Number.isFinite(pid) || pid <= 0) return true;\n\t\treturn !isProcessAlive(pid);\n\t}\n\n\tasync release(): Promise<void> {\n\t\tif (!this.acquired) return;\n\t\tthis.acquired = false;\n\t\tawait fsp.rm(this.dirPath, { recursive: true, force: true });\n\t}\n}\n\nfunction defaultWorkspacePath(): string | null {\n\t// The store caller (ToolboxCore) supplies a cwd, but tests want a\n\t// stable default. Return null when the env var says \"no workspace\".\n\tif (process.env.SERVICEME_NO_WORKSPACE_TOOLBOX === \"1\") return null;\n\treturn path.join(process.cwd(), WORKSPACE_TOOLBOX_RELATIVE_PATH);\n}\n\nexport class ToolboxStore {\n\tprivate readonly userFilePath: string;\n\tprivate readonly resolveWorkspacePath: () => string | null;\n\tprivate readonly defaults: readonly DefaultToolSeed[];\n\tprivate readonly hooks: ToolboxStoreHooks;\n\tprivate readonly backend: ToolboxFileBackend;\n\tprivate readonly lockTimeoutMs: number;\n\tprivate readonly lockRetryMs: number;\n\n\tconstructor(opts: ToolboxStoreOptions = {}) {\n\t\tthis.userFilePath = opts.userFilePath ?? getToolboxJsonPath();\n\t\tthis.resolveWorkspacePath = opts.resolveWorkspacePath ?? defaultWorkspacePath;\n\t\tthis.defaults = opts.defaultTools ?? BUILTIN_DEFAULT_TOOLS;\n\t\tthis.hooks = opts.hooks ?? {};\n\t\tthis.backend = opts.backend ?? new FsToolboxFileBackend();\n\t\tthis.lockTimeoutMs = opts.lockTimeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS;\n\t\tthis.lockRetryMs = opts.lockRetryMs ?? DEFAULT_LOCK_RETRY_MS;\n\t}\n\n\t/** Read a scope; returns the resolved toolbox (with defaults merged when empty). */\n\tasync read(scope: ToolboxScope): Promise<ResolvedToolbox> {\n\t\tconst filePath = this.filePathFor(scope);\n\t\tif (scope === \"workspace\") {\n\t\t\tawait migrateLegacyWorkspaceToolboxFile(filePath);\n\t\t}\n\t\tconst stored = filePath ? await this.backend.read(filePath) : null;\n\t\tconst storedTools = stored?.tools ?? [];\n\t\tconst defaults = this.defaults.map((seed, index) => toDefaultTool(seed, index));\n\t\tconst merged = mergeWithDefaults(defaults, storedTools);\n\t\tconst userOnly = storedTools.filter((t) => !this.defaults.some((d) => d.id === t.id));\n\t\tvoid userOnly;\n\t\treturn { scope, tools: merged };\n\t}\n\n\t/**\n\t * Atomic write under a file lock. Replaces the entire `tools` array\n\t * with the provided snapshot.\n\t */\n\tasync write(scope: ToolboxScope, tools: readonly ExternalTool[]): Promise<void> {\n\t\tconst filePath = this.filePathFor(scope);\n\t\tif (!filePath) {\n\t\t\tthrow new Error(`Cannot write toolbox scope '${scope}': file path is unavailable`);\n\t\t}\n\t\tif (scope === \"workspace\") {\n\t\t\tawait migrateLegacyWorkspaceToolboxFile(filePath);\n\t\t}\n\t\tconst payload: PersistedToolbox = {\n\t\t\tversion: TOOLBOX_JSON_SCHEMA_VERSION,\n\t\t\ttools: sortByUserOrder([...tools]),\n\t\t};\n\t\tawait this.hooks.beforeWrite?.(scope, payload);\n\t\tconst lock = new ToolboxFileLock(filePath, this.lockTimeoutMs, this.lockRetryMs);\n\t\tawait lock.acquire();\n\t\ttry {\n\t\t\tawait this.backend.write(filePath, payload);\n\t\t} finally {\n\t\t\tawait lock.release();\n\t\t}\n\t\tawait this.hooks.afterWrite?.(scope, payload);\n\t}\n\n\t/**\n\t * Read-modify-write under the file lock. The mutator receives the\n\t * current user-only list (defaults not included) and returns the\n\t * replacement list. Throwing inside the mutator aborts the write.\n\t */\n\tasync mutate(\n\t\tscope: ToolboxScope,\n\t\tmutator: (current: ExternalTool[]) => Promise<ExternalTool[]>\n\t): Promise<ExternalTool[]> {\n\t\tconst filePath = this.filePathFor(scope);\n\t\tif (!filePath) {\n\t\t\tthrow new Error(`Cannot mutate toolbox scope '${scope}': file path is unavailable`);\n\t\t}\n\t\tif (scope === \"workspace\") {\n\t\t\tawait migrateLegacyWorkspaceToolboxFile(filePath);\n\t\t}\n\t\tconst lock = new ToolboxFileLock(filePath, this.lockTimeoutMs, this.lockRetryMs);\n\t\tawait lock.acquire();\n\t\ttry {\n\t\t\tconst stored = await this.backend.read(filePath);\n\t\t\tconst storedTools = stored?.tools ?? [];\n\t\t\tconst defaultIds = new Set(this.defaults.map((d) => d.id));\n\t\t\tconst userTools = storedTools.filter((t) => !defaultIds.has(t.id));\n\t\t\tconst next = await mutator(userTools);\n\t\t\tconst payload: PersistedToolbox = {\n\t\t\t\tversion: TOOLBOX_JSON_SCHEMA_VERSION,\n\t\t\t\ttools: sortByUserOrder([...next]),\n\t\t\t};\n\t\t\tawait this.hooks.beforeWrite?.(scope, payload);\n\t\t\tawait this.backend.write(filePath, payload);\n\t\t\tawait this.hooks.afterWrite?.(scope, payload);\n\t\t\treturn next;\n\t\t} finally {\n\t\t\tawait lock.release();\n\t\t}\n\t}\n\n\t/** Wipe a scope entirely (used by `toolbox.remove --all` extensions). */\n\tasync clear(scope: ToolboxScope): Promise<void> {\n\t\tconst filePath = this.filePathFor(scope);\n\t\tif (!filePath) return;\n\t\tawait fsp.rm(filePath, { force: true });\n\t}\n\n\t/** Test seam — resolve the user-scope file path. */\n\tgetUserFilePath(): string {\n\t\treturn this.userFilePath;\n\t}\n\n\t/** Test seam — resolve the workspace-scope file path (or null when disabled). */\n\tgetWorkspaceFilePath(): string | null {\n\t\treturn this.resolveWorkspacePath();\n\t}\n\n\tprivate filePathFor(scope: ToolboxScope): string | null {\n\t\treturn scope === \"user\" ? this.userFilePath : this.resolveWorkspacePath();\n\t}\n}\n\nfunction toDefaultTool(seed: DefaultToolSeed, order: number): ExternalTool {\n\treturn {\n\t\tid: seed.id,\n\t\tname: seed.name,\n\t\tdescription: seed.description,\n\t\ticon: seed.icon,\n\t\turl: seed.url,\n\t\tisDefault: true,\n\t\torder,\n\t\tscope: \"user\",\n\t};\n}\n","/**\n * ToolboxCore — Main entry for the toolbox domain.\n *\n * Orchestrates the user + workspace scopes via `ToolboxStore`, applies\n * the \"最近使用置顶\" sort, and exposes a small surface that mirrors\n * the Phase 5.1 bridge methods:\n *\n *   - `list(scope?)`     → `toolbox.list`\n *   - `add(tool, scope)` → `toolbox.add`\n *   - `remove(id, scope?)` → `toolbox.remove`\n *   - `update(id, patch, scope?)` → `toolbox.update`\n *\n * Default tools (built-in seeds) are never user-deletable. `remove()`\n * is a no-op for default tools and surfaces a structured error so\n * callers can map it to `TOOLBOX_DEFAULT_IMMUTABLE` (Phase 5.3 error\n * code).\n *\n * Refs:\n * - 4.功能规划.md §2.3 — `ToolboxCore.ts 主入口`\n * - `3.功能拆分.md` §3 — wire shape\n */\n\nimport type { ExternalTool, ToolboxList, ToolboxScope } from \"@serviceme/devtools-protocol\";\n\nimport { sortByRecentFirst, sortByUserOrder, touchLastUsedAt } from \"./sort\";\nimport { ToolboxStore } from \"./ToolboxStore\";\nimport { BUILTIN_DEFAULT_TOOLS, type DefaultToolSeed, type ToolboxPatch } from \"./types\";\n\n/** Sentinel — caller tried to remove a built-in (immutable) tool. */\nexport class DefaultToolImmutableError extends Error {\n\tconstructor(public readonly toolId: string) {\n\t\tsuper(`Cannot remove default toolbox entry: ${toolId}`);\n\t\tthis.name = \"DefaultToolImmutableError\";\n\t}\n}\n\nexport interface ToolboxCoreOptions {\n\tstore?: ToolboxStore;\n\tdefaultTools?: readonly DefaultToolSeed[];\n\t/** Sort applied to the merged list returned by `list()`. Default: `sortByUserOrder`. */\n\tlistSort?: (tools: readonly ExternalTool[]) => ExternalTool[];\n}\n\nexport class ToolboxCore {\n\tprivate readonly store: ToolboxStore;\n\tprivate readonly defaults: readonly DefaultToolSeed[];\n\tprivate readonly listSort: (tools: readonly ExternalTool[]) => ExternalTool[];\n\n\tconstructor(opts: ToolboxCoreOptions = {}) {\n\t\tthis.store = opts.store ?? new ToolboxStore();\n\t\tthis.defaults = opts.defaultTools ?? BUILTIN_DEFAULT_TOOLS;\n\t\tthis.listSort = opts.listSort ?? sortByUserOrder;\n\t}\n\n\t/** List all tools in a scope. Built-in defaults are merged in. */\n\tasync list(scope: ToolboxScope = \"user\"): Promise<ToolboxList> {\n\t\tconst resolved = await this.store.read(scope);\n\t\treturn {\n\t\t\tscope,\n\t\t\ttools: this.listSort(resolved.tools),\n\t\t};\n\t}\n\n\t/**\n\t * Append a new tool to the requested scope. Default tools are\n\t * rejected (they are seeds, not user entries).\n\t */\n\tasync add(tool: ExternalTool, scope: ToolboxScope = \"user\"): Promise<ToolboxList> {\n\t\tif (this.isDefaultId(tool.id)) {\n\t\t\tthrow new DefaultToolImmutableError(tool.id);\n\t\t}\n\t\tconst next = await this.store.mutate(scope, async (current) => {\n\t\t\tconst filtered = current.filter((t) => t.id !== tool.id);\n\t\t\treturn [\n\t\t\t\t...filtered,\n\t\t\t\t{\n\t\t\t\t\t...tool,\n\t\t\t\t\tscope,\n\t\t\t\t\tisDefault: false,\n\t\t\t\t\torder: tool.order ?? filtered.length,\n\t\t\t\t},\n\t\t\t];\n\t\t});\n\t\treturn { scope, tools: next };\n\t}\n\n\t/**\n\t * Remove a tool by id. Returns `success: false` when the id is a\n\t * built-in default (idempotent, never throws on missing entries).\n\t */\n\tasync remove(\n\t\tid: string,\n\t\tscope: ToolboxScope = \"user\"\n\t): Promise<{ scope: ToolboxScope; toolId: string; success: boolean }> {\n\t\tif (this.isDefaultId(id)) {\n\t\t\tthrow new DefaultToolImmutableError(id);\n\t\t}\n\t\tconst removed = await this.store.mutate(scope, async (current) =>\n\t\t\tcurrent.filter((t) => t.id !== id)\n\t\t);\n\t\treturn { scope, toolId: id, success: !removed.some((t) => t.id === id) };\n\t}\n\n\t/**\n\t * Patch a tool by id. Default tools can only have their `order`\n\t * updated; other patches are silently ignored for default entries\n\t * (callers can compare before/after to detect the ignore).\n\t */\n\tasync update(\n\t\tid: string,\n\t\tpatch: ToolboxPatch,\n\t\tscope: ToolboxScope = \"user\"\n\t): Promise<ToolboxList> {\n\t\tconst isDefault = this.isDefaultId(id);\n\t\tconst next = await this.store.mutate(scope, async (current) => {\n\t\t\tif (isDefault) {\n\t\t\t\t// Default tools are not stored on disk — silently ignore\n\t\t\t\t// non-order patches. The order field is also not persisted\n\t\t\t\t// (default order is set in memory at merge time), so the\n\t\t\t\t// caller can compare before/after to detect the ignore.\n\t\t\t\treturn current;\n\t\t\t}\n\t\t\treturn current.map((tool) =>\n\t\t\t\ttool.id === id ? { ...tool, ...patch, scope, isDefault: false } : tool\n\t\t\t);\n\t\t});\n\t\treturn { scope, tools: next };\n\t}\n\n\t/**\n\t * Stamp `lastUsedAt` on the targeted tool. This is the \"recently\n\t * used\" hook the Extension's webview uses when a user clicks a\n\t * toolbox entry.\n\t */\n\tasync recordUsage(\n\t\tid: string,\n\t\tscope: ToolboxScope = \"user\",\n\t\twhen: Date = new Date()\n\t): Promise<ExternalTool | null> {\n\t\tif (this.isDefaultId(id)) {\n\t\t\t// Defaults live in memory only — return a synthetic record so\n\t\t\t// callers can render the click without persisting anything.\n\t\t\tconst seed = this.defaults.find((d) => d.id === id);\n\t\t\tif (!seed) return null;\n\t\t\treturn { ...seed, scope, isDefault: true, order: 0, lastUsedAt: when.toISOString() };\n\t\t}\n\t\tlet updated: ExternalTool | null = null;\n\t\tawait this.store.mutate(scope, async (current) => {\n\t\t\tconst next = touchLastUsedAt(current, id, when);\n\t\t\tupdated = next.find((t) => t.id === id) ?? null;\n\t\t\treturn next;\n\t\t});\n\t\treturn updated;\n\t}\n\n\t/**\n\t * Combined view: user + workspace scopes merged, sorted by recent\n\t * usage. Workspace tools overlay user tools (workspace entries win\n\t * on `id` collision).\n\t */\n\tasync listMerged(): Promise<ToolboxList> {\n\t\tconst [user, workspace] = await Promise.all([\n\t\t\tthis.store.read(\"user\"),\n\t\t\tthis.store.read(\"workspace\"),\n\t\t]);\n\t\tconst seen = new Set<string>();\n\t\tconst merged: ExternalTool[] = [];\n\t\tfor (const tool of workspace.tools) {\n\t\t\tseen.add(tool.id);\n\t\t\tmerged.push({ ...tool, scope: \"workspace\" });\n\t\t}\n\t\tfor (const tool of user.tools) {\n\t\t\tif (seen.has(tool.id)) continue;\n\t\t\tmerged.push({ ...tool, scope: \"user\" });\n\t\t}\n\t\treturn { scope: \"user\", tools: sortByRecentFirst(merged) };\n\t}\n\n\t/** Expose the underlying store (CLI / Bridge use it for path-level access). */\n\tgetStore(): ToolboxStore {\n\t\treturn this.store;\n\t}\n\n\tprivate isDefaultId(id: string): boolean {\n\t\treturn this.defaults.some((d) => d.id === id);\n\t}\n}\n"],"mappings":"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"}

package/dist/userHome-CLlsXCvW.js

@@ -1,518 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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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"}