@serviceme/devtools-core 2.0.5 → 2.0.7

package/dist/{submit-6zQPPrOJ.mjs → submit-Cg7wSa3x.mjs}

@@ -1,4 +1,4 @@
-import { L as getRepoDir } from "./userHome-DOMLiHy7.mjs";
+import { R as getRepoDir } from "./userHome-CcnAQPG1.mjs";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 //#region src/submit/types.ts
@@ -81,4 +81,4 @@ var SubmitClient = class {
 //#endregion
 export { SubmitError as n, SubmitClient as t };
 
-//# sourceMappingURL=submit-6zQPPrOJ.mjs.map
+//# sourceMappingURL=submit-Cg7wSa3x.mjs.map

package/dist/{submit-6zQPPrOJ.mjs.map → submit-Cg7wSa3x.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"submit-6zQPPrOJ.mjs","names":[],"sources":["../src/submit/types.ts","../src/submit/index.ts"],"sourcesContent":["/**\n * Skill & Agent v2 — SubmitClient Types (M4)\n *\n * Mirrors the server's POST /api/v1/skills/validate contract (M2\n * SubmitApi). Defined here as a separate types file so the test\n * fixtures + the client can both import without circular deps.\n */\n\n/** Reasons the server may deny a submission. */\nexport type DenyReason =\n\t| \"repo_not_writable\"\n\t| \"file_too_large\"\n\t| \"path_traversal\"\n\t| \"invalid_frontmatter\"\n\t| \"name_conflict\"\n\t/** Local-client-side errors that don't come from the server. */\n\t| \"network_error\"\n\t| \"write_error\"\n\t| \"commit_error\"\n\t| \"push_error\"\n\t| \"unknown\";\n\n/** Request payload. Identical to the server's SubmitValidationRequest. */\nexport interface SubmitValidationRequest {\n\trepoId: string;\n\tskillName: string;\n\tfiles: Array<{ path: string; content: string }>;\n}\n\n/** Response payload. Identical to the server's SubmitValidationResponse. */\nexport interface SubmitValidationResponse {\n\tallow: boolean;\n\treason?: DenyReason;\n\tdetail?: string;\n}\n\n/** Sentinel error thrown by SubmitClient.submit() / validate(). */\nexport class SubmitError extends Error {\n\treadonly reason: DenyReason;\n\treadonly detail: string;\n\treadonly status?: number;\n\n\tconstructor(reason: DenyReason, detail: string, options?: { status?: number }) {\n\t\tsuper(`submit failed (${reason}): ${detail}`);\n\t\tthis.name = \"SubmitError\";\n\t\tthis.reason = reason;\n\t\tthis.detail = detail;\n\t\tthis.status = options?.status;\n\t}\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { GitClient } from \"../git-client\";\nimport { getRepoDir } from \"../paths/userHome\";\nimport type { SkillFile } from \"../skill-store/types\";\nimport type { SubmitValidationRequest, SubmitValidationResponse } from \"./types\";\nimport { SubmitError } from \"./types\";\n\n// Re-export so consumers (bridge handlers, CLI commands) can detect\n// SubmitError via `instanceof` without reaching into the internal\n// `./types` module.\nexport { SubmitError } from \"./types\";\n\n/**\n * Skill & Agent v2 — SubmitClient (M4)\n *\n * SubmitClient orchestrates the \"validate then push\" flow described\n * in docs/architecture/skill-agent-v2-repo.md §5.7:\n *\n *   1. **validate** — POST the candidate files to the server's\n *      `/api/v1/skills/validate` endpoint (5 deny reasons: repo_not_\n *      writable, file_too_large, path_traversal, invalid_frontmatter,\n *      name_conflict).\n *   2. **write** — materialize the files into the local repo clone at\n *      `~/.serviceme/repos/<repoId>/skills/<name>/` (or `agents/`).\n *   3. **commit** — `git add . && git commit -m \"feat(skills): add <name>\"`.\n *   4. **push** — `git push origin <branch>` via the server proxy.\n *\n * The client is intentionally thin: it does NOT do its own validation\n * (the server is the gate), and it does NOT cache anything across\n * calls. The single source of truth for \"is this submission allowed?\"\n * is the server's validate endpoint.\n *\n * @see docs/architecture/skill-agent-v2-repo.md §5.7 SubmitClient\n */\n\nexport interface SubmitOptions {\n\t/** Override the server's validate URL. Defaults to `http://localhost:3000/api/v1`. */\n\tserverBaseUrl?: string;\n\t/** Override the branch to push. Defaults to the repo's `branch` field. */\n\tbranch?: string;\n\t/** Skip the actual push (for tests + dry-runs). When true, step 4 returns a synthetic PushResult. */\n\tskipPush?: boolean;\n}\n\nexport interface SubmitResult {\n\trepoId: string;\n\tskillName: string;\n\tcommitSha: string;\n\tpushedRef?: string;\n\tpushedSha?: string;\n}\n\nexport interface SubmitClientOptions {\n\tgitClient: GitClient;\n\t/** Lookup the default branch for a repo (config-driven). */\n\tgetRepoBranch?: (repoId: string) => string | undefined;\n\t/** HTTP fetch impl (defaults to the global `fetch`). */\n\tfetcher?: typeof fetch;\n\t/** Default server base URL when no override is supplied. */\n\tdefaultServerBaseUrl?: string;\n}\n\nexport class SubmitClient {\n\tprivate readonly git: GitClient;\n\tprivate readonly getRepoBranch: (repoId: string) => string | undefined;\n\tprivate readonly fetcher: typeof fetch;\n\tprivate readonly defaultServerBaseUrl: string;\n\n\tconstructor(opts: SubmitClientOptions) {\n\t\tthis.git = opts.gitClient;\n\t\tthis.getRepoBranch = opts.getRepoBranch ?? (() => undefined);\n\t\tthis.fetcher = opts.fetcher ?? (globalThis.fetch as typeof fetch);\n\t\tthis.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? \"http://localhost:3000\";\n\t}\n\n\t/**\n\t * Validate-only path. Useful for the UI's \"Save Draft\" flow which\n\t * wants to surface validation errors without committing or pushing.\n\t */\n\tasync validate(req: SubmitValidationRequest): Promise<SubmitValidationResponse> {\n\t\tconst url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;\n\t\tconst res = await this.fetcher(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(req),\n\t\t});\n\t\tif (!res.ok) {\n\t\t\tthrow new SubmitError(\"network_error\", `validate request failed: HTTP ${res.status}`);\n\t\t}\n\t\treturn (await res.json()) as SubmitValidationResponse;\n\t}\n\n\t/**\n\t * Full submit pipeline. Throws `SubmitError` on:\n\t *   - validate deny (reason echoed)\n\t *   - network failure (network_error)\n\t *   - local write failure\n\t *   - commit/push failure\n\t */\n\tasync submit(\n\t\trepoId: string,\n\t\tskillName: string,\n\t\tfiles: SkillFile[],\n\t\topts: SubmitOptions = {}\n\t): Promise<SubmitResult> {\n\t\t// (1) Validate\n\t\tconst v = await this.validate({ repoId, skillName, files });\n\t\tif (!v.allow) {\n\t\t\tthrow new SubmitError(v.reason ?? \"unknown\", v.detail ?? \"validation denied\");\n\t\t}\n\n\t\t// (2) Write files into the local repo clone\n\t\tconst localRepoPath = getRepoDir(repoId);\n\t\tconst targetDir = path.join(localRepoPath, \"skills\", skillName);\n\t\tawait fs.mkdir(targetDir, { recursive: true });\n\t\tfor (const f of files) {\n\t\t\tconst full = path.join(targetDir, f.path);\n\t\t\tawait fs.mkdir(path.dirname(full), { recursive: true });\n\t\t\tconst tmp = `${full}.${process.pid}.${Date.now()}.tmp`;\n\t\t\tawait fs.writeFile(tmp, f.content, \"utf8\");\n\t\t\tawait fs.rename(tmp, full);\n\t\t}\n\n\t\t// (3) Commit (convention: `feat(skills): add <name>`)\n\t\tconst commitMessage = `feat(skills): add ${skillName}`;\n\t\tconst { commitSha } = await this.git.commit(localRepoPath, commitMessage);\n\n\t\t// (4) Push\n\t\tlet pushedRef: string | undefined;\n\t\tlet pushedSha: string | undefined;\n\t\tif (!opts.skipPush) {\n\t\t\tconst branch = opts.branch ?? this.getRepoBranch(repoId) ?? \"main\";\n\t\t\tconst pushResult = await this.git.push(repoId, localRepoPath, branch);\n\t\t\tpushedRef = pushResult.ref;\n\t\t\tpushedSha = pushResult.commitSha;\n\t\t}\n\n\t\treturn {\n\t\t\trepoId,\n\t\t\tskillName,\n\t\t\tcommitSha,\n\t\t\tpushedRef,\n\t\t\tpushedSha,\n\t\t};\n\t}\n}\n"],"mappings":";;;;;AAqCA,IAAa,cAAb,cAAiC,MAAM;CAKtC,YAAY,QAAoB,QAAgB,SAA+B;EAC9E,MAAM,kBAAkB,OAAO,KAAK,QAAQ;EAC5C,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,SAAS;EACd,KAAK,SAAS,SAAS;CACxB;AACD;;;ACcA,IAAa,eAAb,MAA0B;CAMzB,YAAY,MAA2B;EACtC,KAAK,MAAM,KAAK;EAChB,KAAK,gBAAgB,KAAK,wBAAwB,KAAA;EAClD,KAAK,UAAU,KAAK,WAAY,WAAW;EAC3C,KAAK,uBAAuB,KAAK,wBAAwB;CAC1D;;;;;CAMA,MAAM,SAAS,KAAiE;EAC/E,MAAM,MAAM,GAAG,KAAK,qBAAqB;EACzC,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK;GACnC,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,GAAG;EACzB,CAAC;EACD,IAAI,CAAC,IAAI,IACR,MAAM,IAAI,YAAY,iBAAiB,iCAAiC,IAAI,QAAQ;EAErF,OAAQ,MAAM,IAAI,KAAK;CACxB;;;;;;;;CASA,MAAM,OACL,QACA,WACA,OACA,OAAsB,CAAC,GACC;EAExB,MAAM,IAAI,MAAM,KAAK,SAAS;GAAE;GAAQ;GAAW;EAAM,CAAC;EAC1D,IAAI,CAAC,EAAE,OACN,MAAM,IAAI,YAAY,EAAE,UAAU,WAAW,EAAE,UAAU,mBAAmB;EAI7E,MAAM,gBAAgB,WAAW,MAAM;EACvC,MAAM,YAAY,KAAK,KAAK,eAAe,UAAU,SAAS;EAC9D,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,KAAK,MAAM,KAAK,OAAO;GACtB,MAAM,OAAO,KAAK,KAAK,WAAW,EAAE,IAAI;GACxC,MAAM,GAAG,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GACtD,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;GACjD,MAAM,GAAG,UAAU,KAAK,EAAE,SAAS,MAAM;GACzC,MAAM,GAAG,OAAO,KAAK,IAAI;EAC1B;EAGA,MAAM,gBAAgB,qBAAqB;EAC3C,MAAM,EAAE,cAAc,MAAM,KAAK,IAAI,OAAO,eAAe,aAAa;EAGxE,IAAI;EACJ,IAAI;EACJ,IAAI,CAAC,KAAK,UAAU;GACnB,MAAM,SAAS,KAAK,UAAU,KAAK,cAAc,MAAM,KAAK;GAC5D,MAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,eAAe,MAAM;GACpE,YAAY,WAAW;GACvB,YAAY,WAAW;EACxB;EAEA,OAAO;GACN;GACA;GACA;GACA;GACA;EACD;CACD;AACD"}
+{"version":3,"file":"submit-Cg7wSa3x.mjs","names":[],"sources":["../src/submit/types.ts","../src/submit/index.ts"],"sourcesContent":["/**\n * Skill & Agent v2 — SubmitClient Types (M4)\n *\n * Mirrors the server's POST /api/v1/skills/validate contract (M2\n * SubmitApi). Defined here as a separate types file so the test\n * fixtures + the client can both import without circular deps.\n */\n\n/** Reasons the server may deny a submission. */\nexport type DenyReason =\n\t| \"repo_not_writable\"\n\t| \"file_too_large\"\n\t| \"path_traversal\"\n\t| \"invalid_frontmatter\"\n\t| \"name_conflict\"\n\t/** Local-client-side errors that don't come from the server. */\n\t| \"network_error\"\n\t| \"write_error\"\n\t| \"commit_error\"\n\t| \"push_error\"\n\t| \"unknown\";\n\n/** Request payload. Identical to the server's SubmitValidationRequest. */\nexport interface SubmitValidationRequest {\n\trepoId: string;\n\tskillName: string;\n\tfiles: Array<{ path: string; content: string }>;\n}\n\n/** Response payload. Identical to the server's SubmitValidationResponse. */\nexport interface SubmitValidationResponse {\n\tallow: boolean;\n\treason?: DenyReason;\n\tdetail?: string;\n}\n\n/** Sentinel error thrown by SubmitClient.submit() / validate(). */\nexport class SubmitError extends Error {\n\treadonly reason: DenyReason;\n\treadonly detail: string;\n\treadonly status?: number;\n\n\tconstructor(reason: DenyReason, detail: string, options?: { status?: number }) {\n\t\tsuper(`submit failed (${reason}): ${detail}`);\n\t\tthis.name = \"SubmitError\";\n\t\tthis.reason = reason;\n\t\tthis.detail = detail;\n\t\tthis.status = options?.status;\n\t}\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { GitClient } from \"../git-client\";\nimport { getRepoDir } from \"../paths/userHome\";\nimport type { SkillFile } from \"../skill-store/types\";\nimport type { SubmitValidationRequest, SubmitValidationResponse } from \"./types\";\nimport { SubmitError } from \"./types\";\n\n// Re-export so consumers (bridge handlers, CLI commands) can detect\n// SubmitError via `instanceof` without reaching into the internal\n// `./types` module.\nexport { SubmitError } from \"./types\";\n\n/**\n * Skill & Agent v2 — SubmitClient (M4)\n *\n * SubmitClient orchestrates the \"validate then push\" flow described\n * in docs/architecture/skill-agent-v2-repo.md §5.7:\n *\n *   1. **validate** — POST the candidate files to the server's\n *      `/api/v1/skills/validate` endpoint (5 deny reasons: repo_not_\n *      writable, file_too_large, path_traversal, invalid_frontmatter,\n *      name_conflict).\n *   2. **write** — materialize the files into the local repo clone at\n *      `~/.serviceme/repos/<repoId>/skills/<name>/` (or `agents/`).\n *   3. **commit** — `git add . && git commit -m \"feat(skills): add <name>\"`.\n *   4. **push** — `git push origin <branch>` via the server proxy.\n *\n * The client is intentionally thin: it does NOT do its own validation\n * (the server is the gate), and it does NOT cache anything across\n * calls. The single source of truth for \"is this submission allowed?\"\n * is the server's validate endpoint.\n *\n * @see docs/architecture/skill-agent-v2-repo.md §5.7 SubmitClient\n */\n\nexport interface SubmitOptions {\n\t/** Override the server's validate URL. Defaults to `http://localhost:3000/api/v1`. */\n\tserverBaseUrl?: string;\n\t/** Override the branch to push. Defaults to the repo's `branch` field. */\n\tbranch?: string;\n\t/** Skip the actual push (for tests + dry-runs). When true, step 4 returns a synthetic PushResult. */\n\tskipPush?: boolean;\n}\n\nexport interface SubmitResult {\n\trepoId: string;\n\tskillName: string;\n\tcommitSha: string;\n\tpushedRef?: string;\n\tpushedSha?: string;\n}\n\nexport interface SubmitClientOptions {\n\tgitClient: GitClient;\n\t/** Lookup the default branch for a repo (config-driven). */\n\tgetRepoBranch?: (repoId: string) => string | undefined;\n\t/** HTTP fetch impl (defaults to the global `fetch`). */\n\tfetcher?: typeof fetch;\n\t/** Default server base URL when no override is supplied. */\n\tdefaultServerBaseUrl?: string;\n}\n\nexport class SubmitClient {\n\tprivate readonly git: GitClient;\n\tprivate readonly getRepoBranch: (repoId: string) => string | undefined;\n\tprivate readonly fetcher: typeof fetch;\n\tprivate readonly defaultServerBaseUrl: string;\n\n\tconstructor(opts: SubmitClientOptions) {\n\t\tthis.git = opts.gitClient;\n\t\tthis.getRepoBranch = opts.getRepoBranch ?? (() => undefined);\n\t\tthis.fetcher = opts.fetcher ?? (globalThis.fetch as typeof fetch);\n\t\tthis.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? \"http://localhost:3000\";\n\t}\n\n\t/**\n\t * Validate-only path. Useful for the UI's \"Save Draft\" flow which\n\t * wants to surface validation errors without committing or pushing.\n\t */\n\tasync validate(req: SubmitValidationRequest): Promise<SubmitValidationResponse> {\n\t\tconst url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;\n\t\tconst res = await this.fetcher(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(req),\n\t\t});\n\t\tif (!res.ok) {\n\t\t\tthrow new SubmitError(\"network_error\", `validate request failed: HTTP ${res.status}`);\n\t\t}\n\t\treturn (await res.json()) as SubmitValidationResponse;\n\t}\n\n\t/**\n\t * Full submit pipeline. Throws `SubmitError` on:\n\t *   - validate deny (reason echoed)\n\t *   - network failure (network_error)\n\t *   - local write failure\n\t *   - commit/push failure\n\t */\n\tasync submit(\n\t\trepoId: string,\n\t\tskillName: string,\n\t\tfiles: SkillFile[],\n\t\topts: SubmitOptions = {}\n\t): Promise<SubmitResult> {\n\t\t// (1) Validate\n\t\tconst v = await this.validate({ repoId, skillName, files });\n\t\tif (!v.allow) {\n\t\t\tthrow new SubmitError(v.reason ?? \"unknown\", v.detail ?? \"validation denied\");\n\t\t}\n\n\t\t// (2) Write files into the local repo clone\n\t\tconst localRepoPath = getRepoDir(repoId);\n\t\tconst targetDir = path.join(localRepoPath, \"skills\", skillName);\n\t\tawait fs.mkdir(targetDir, { recursive: true });\n\t\tfor (const f of files) {\n\t\t\tconst full = path.join(targetDir, f.path);\n\t\t\tawait fs.mkdir(path.dirname(full), { recursive: true });\n\t\t\tconst tmp = `${full}.${process.pid}.${Date.now()}.tmp`;\n\t\t\tawait fs.writeFile(tmp, f.content, \"utf8\");\n\t\t\tawait fs.rename(tmp, full);\n\t\t}\n\n\t\t// (3) Commit (convention: `feat(skills): add <name>`)\n\t\tconst commitMessage = `feat(skills): add ${skillName}`;\n\t\tconst { commitSha } = await this.git.commit(localRepoPath, commitMessage);\n\n\t\t// (4) Push\n\t\tlet pushedRef: string | undefined;\n\t\tlet pushedSha: string | undefined;\n\t\tif (!opts.skipPush) {\n\t\t\tconst branch = opts.branch ?? this.getRepoBranch(repoId) ?? \"main\";\n\t\t\tconst pushResult = await this.git.push(repoId, localRepoPath, branch);\n\t\t\tpushedRef = pushResult.ref;\n\t\t\tpushedSha = pushResult.commitSha;\n\t\t}\n\n\t\treturn {\n\t\t\trepoId,\n\t\t\tskillName,\n\t\t\tcommitSha,\n\t\t\tpushedRef,\n\t\t\tpushedSha,\n\t\t};\n\t}\n}\n"],"mappings":";;;;;AAqCA,IAAa,cAAb,cAAiC,MAAM;CAKtC,YAAY,QAAoB,QAAgB,SAA+B;EAC9E,MAAM,kBAAkB,OAAO,KAAK,QAAQ;EAC5C,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,SAAS;EACd,KAAK,SAAS,SAAS;CACxB;AACD;;;ACcA,IAAa,eAAb,MAA0B;CAMzB,YAAY,MAA2B;EACtC,KAAK,MAAM,KAAK;EAChB,KAAK,gBAAgB,KAAK,wBAAwB,KAAA;EAClD,KAAK,UAAU,KAAK,WAAY,WAAW;EAC3C,KAAK,uBAAuB,KAAK,wBAAwB;CAC1D;;;;;CAMA,MAAM,SAAS,KAAiE;EAC/E,MAAM,MAAM,GAAG,KAAK,qBAAqB;EACzC,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK;GACnC,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,GAAG;EACzB,CAAC;EACD,IAAI,CAAC,IAAI,IACR,MAAM,IAAI,YAAY,iBAAiB,iCAAiC,IAAI,QAAQ;EAErF,OAAQ,MAAM,IAAI,KAAK;CACxB;;;;;;;;CASA,MAAM,OACL,QACA,WACA,OACA,OAAsB,CAAC,GACC;EAExB,MAAM,IAAI,MAAM,KAAK,SAAS;GAAE;GAAQ;GAAW;EAAM,CAAC;EAC1D,IAAI,CAAC,EAAE,OACN,MAAM,IAAI,YAAY,EAAE,UAAU,WAAW,EAAE,UAAU,mBAAmB;EAI7E,MAAM,gBAAgB,WAAW,MAAM;EACvC,MAAM,YAAY,KAAK,KAAK,eAAe,UAAU,SAAS;EAC9D,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,KAAK,MAAM,KAAK,OAAO;GACtB,MAAM,OAAO,KAAK,KAAK,WAAW,EAAE,IAAI;GACxC,MAAM,GAAG,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GACtD,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;GACjD,MAAM,GAAG,UAAU,KAAK,EAAE,SAAS,MAAM;GACzC,MAAM,GAAG,OAAO,KAAK,IAAI;EAC1B;EAGA,MAAM,gBAAgB,qBAAqB;EAC3C,MAAM,EAAE,cAAc,MAAM,KAAK,IAAI,OAAO,eAAe,aAAa;EAGxE,IAAI;EACJ,IAAI;EACJ,IAAI,CAAC,KAAK,UAAU;GACnB,MAAM,SAAS,KAAK,UAAU,KAAK,cAAc,MAAM,KAAK;GAC5D,MAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,eAAe,MAAM;GACpE,YAAY,WAAW;GACvB,YAAY,WAAW;EACxB;EAEA,OAAO;GACN;GACA;GACA;GACA;GACA;EACD;CACD;AACD"}

package/dist/{toolbox-UG4dA2TI.mjs → toolbox-CbfxpNg-.mjs}

@@ -1,4 +1,4 @@
-import { J as getToolboxJsonPath } from "./userHome-DOMLiHy7.mjs";
+import { Y as getToolboxJsonPath } from "./userHome-CcnAQPG1.mjs";
 import * as fsp from "node:fs/promises";
 import * as path from "node:path";
 import { setTimeout } from "node:timers/promises";
@@ -537,4 +537,4 @@ var ToolboxCore = class {
 //#endregion
 export { WORKSPACE_TOOLBOX_RELATIVE_PATH as a, mergeWithDefaults as c, sortByUserOrder as d, touchLastUsedAt as f, ToolboxStore as i, reindexOrder as l, ToolboxCore as n, BUILTIN_DEFAULT_TOOLS as o, FsToolboxFileBackend as r, TOOLBOX_JSON_SCHEMA_VERSION as s, DefaultToolImmutableError as t, sortByRecentFirst as u };
 
-//# sourceMappingURL=toolbox-UG4dA2TI.mjs.map
+//# sourceMappingURL=toolbox-CbfxpNg-.mjs.map

package/dist/{toolbox-UG4dA2TI.mjs.map → toolbox-CbfxpNg-.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"toolbox-UG4dA2TI.mjs","names":["delay"],"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":";;;;;;;;;;AAmBA,SAAS,kBAAkB,MAA4B;CACtD,IAAI,CAAC,KAAK,YAAY,OAAO;CAC7B,MAAM,KAAK,KAAK,MAAM,KAAK,UAAU;CACrC,OAAO,OAAO,SAAS,EAAE,IAAI,KAAK;AACnC;;;;;;;;;AAUA,SAAgB,kBAAkB,OAAgD;CACjF,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM;EAChC,MAAM,MAAM,kBAAkB,CAAC;EAC/B,MAAM,MAAM,kBAAkB,CAAC;EAC/B,IAAI,QAAQ,KAAK,OAAO,MAAM;EAC9B,MAAM,SAAS,EAAE,SAAS,OAAO;EACjC,MAAM,SAAS,EAAE,SAAS,OAAO;EACjC,IAAI,WAAW,QAAQ,OAAO,SAAS;EACvC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;CAC/B,CAAC;AACF;;;;;AAMA,SAAgB,gBAAgB,OAAgD;CAC/E,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM;EAChC,MAAM,SAAS,EAAE,SAAS,OAAO;EACjC,MAAM,SAAS,EAAE,SAAS,OAAO;EACjC,IAAI,WAAW,QAAQ,OAAO,SAAS;EACvC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;CAC/B,CAAC;AACF;;;;;;AAuBA,SAAgB,kBACf,UACA,WACiB;CACjB,MAAM,aAAa,IAAI,IAAI,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;CACpD,MAAM,kBAAkB,UAAU,QAAQ,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;CACrE,OAAO,gBAAgB,CAAC,GAAG,UAAU,GAAG,eAAe,CAAC;AACzD;;;;;AAMA,SAAgB,aACf,OACA,aACiB;CACjB,MAAM,2BAAW,IAAI,IAAoB;CACzC,KAAK,MAAM,CAAC,OAAO,OAAO,YAAY,QAAQ,GAC7C,SAAS,IAAI,IAAI,KAAK;CAEvB,KAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,OAAO,SAAS,IAAI,KAAK,EAAE;EACjC,IAAI,SAAS,KAAA,GAAW,KAAK,QAAQ;CACtC;CACA,OAAO;AACR;;;;;AAMA,SAAgB,gBACf,OACA,IACA,uBAAa,IAAI,KAAK,GACL;CACjB,OAAO,MAAM,KAAK,SAAU,KAAK,OAAO,KAAK;EAAE,GAAG;EAAM,YAAY,KAAK,YAAY;CAAE,IAAI,IAAK;AACjG;;;;ACtGA,MAAa,8BAA8B;;AAyB3C,MAAa,wBAAoD;CAChE;EACC,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,KAAK;CACN;CACA;EACC,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,KAAK;CACN;CACA;EACC,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,KAAK;CACN;AACD;;;;;;;;;;;;;;;;;;;AC5BA,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAK9B,MAAM,sBAAsB;AAC5B,MAAM,aAAa;AACnB,MAAa,kCAAkC,KAAK,KAAK,WAAW,yBAAyB;AAC7F,MAAM,oCAAoC;;;;;;;AAQ1C,eAAe,kCAAkC,UAAwC;CACxF,IAAI,CAAC,UAAU;CACf,MAAM,aAAa,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,iCAAiC;CACtF,IAAI,eAAe,UAAU;CAC7B,IAAI;EACH,MAAM,IAAI,OAAO,QAAQ;EACzB;CACD,QAAQ,CAER;CACA,IAAI;EACH,MAAM,IAAI,OAAO,YAAY,QAAQ;CACtC,QAAQ,CAER;AACD;AA4BA,IAAa,uBAAb,MAAgE;;EACtC,KAAA,iBAAA;;CAEzB,MAAM,OAAO,UAAoC;EAChD,IAAI;GACH,MAAM,IAAI,OAAO,QAAQ;GACzB,OAAO;EACR,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,KAAK,UAAoD;EAC9D,IAAI;EACJ,IAAI;GACH,MAAM,MAAM,IAAI,SAAS,UAAU,MAAM;EAC1C,SAAS,KAAK;GACb,IAAI,YAAY,GAAG,KAAK,IAAI,SAAS,UAAU,OAAO;GACtD,MAAM;EACP;EACA,IAAI;GAEH,OAAO,uBADQ,KAAK,MAAM,GACS,CAAC;EACrC,QAAQ;GAOP,MAAM,KAAK,oBAAoB,QAAQ;GACvC,OAAO;EACR;CACD;CAEA,MAAc,oBAAoB,UAAiC;EAClE,IAAI;GACH,MAAM,aAAa,GAAG,SAAS,aAAa,KAAK,IAAI,EAAE;GACvD,MAAM,IAAI,SAAS,UAAU,UAAU;GACvC,MAAM,KAAK,mBAAmB,QAAQ;EACvC,QAAQ,CAER;CACD;CAEA,MAAc,mBAAmB,UAAiC;EACjE,MAAM,MAAM,KAAK,QAAQ,QAAQ;EACjC,MAAM,OAAO,KAAK,SAAS,QAAQ;EACnC,IAAI;EACJ,IAAI;GACH,UAAU,MAAM,IAAI,QAAQ,GAAG;EAChC,QAAQ;GACP;EACD;EACA,MAAM,UAAU,QACd,QAAQ,MAAM,EAAE,WAAW,IAAI,KAAK,EAAE,SAAS,MAAM,CAAC,CAAC,CACvD,KAAK,OAAO;GAAE,MAAM;GAAG,UAAU,KAAK,KAAK,KAAK,CAAC;EAAE,EAAE,CAAC,CACtD,MAAM,GAAG,MAAM;GAEf,OAAO,EAAE,KAAK,cAAc,EAAE,IAAI;EACnC,CAAC;EACF,MAAM,SAAS,QAAQ,SAAS,KAAK;EACrC,IAAI,UAAU,GAAG;EACjB,MAAM,QAAQ,IACb,QAAQ,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,MAAM,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC,YAAY,KAAA,CAAS,CAAC,CAC9E;CACD;CAEA,MAAM,MAAM,UAAkB,SAA0C;EACvE,MAAM,IAAI,MAAM,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;EAC3D,MAAM,UAAU,GAAG,WAAW;EAC9B,MAAM,QAAQ,OAAO,KAAK,KAAK,UAAU,SAAS,MAAM,GAAI,GAAG,MAAM;EACrE,MAAM,IAAI,GAAG,SAAS,EAAE,OAAO,KAAK,CAAC;EACrC,MAAM,SAAS,MAAM,IAAI,KAAK,SAAS,KAAK,SAAS;EACrD,IAAI;GACH,MAAM,OAAO,UAAU,KAAK;GAC5B,MAAM,OAAO,KAAK;EACnB,UAAU;GACT,MAAM,OAAO,MAAM;EACpB;EACA,MAAM,IAAI,OAAO,SAAS,QAAQ;EAClC,MAAM,IAAI,MAAM,UAAU,SAAS,CAAC,CAAC,YAAY,KAAA,CAAS;CAC3D;AACD;AAEA,SAAS,uBAAuB,QAAmC;CAClE,IAAI,OAAO,WAAW,YAAY,WAAW,MAC5C,MAAM,IAAI,MAAM,2CAA2C;CAE5D,MAAM,MAAM;CACZ,MAAM,UAAU,IAAI;CACpB,IAAI,YAAA,GACH,MAAM,IAAI,MAAM,4CAA4C,OAAO,OAAO,GAAG;CAE9E,IAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,GAC3B,MAAM,IAAI,MAAM,wCAAwC;CAEzD,OAAO;EAAE;EAAS,OAAO,IAAI;CAAwB;AACtD;AAEA,SAAS,YAAY,OAAgD;CACpE,OAAO,iBAAiB,SAAS,OAAQ,MAA6B,SAAS;AAChF;AAEA,SAAS,eAAe,KAAsB;CAC7C,IAAI;EACH,QAAQ,KAAK,KAAK,CAAC;EACnB,OAAO;CACR,QAAQ;EACP,OAAO;CACR;AACD;AAEA,IAAM,kBAAN,MAAsB;CAOrB,YAAY,UAAkB,WAAmB,SAAiB;EAF/C,KAAA,WAAA;EAGlB,KAAK,UAAU,GAAG,SAAS;EAC3B,KAAK,cAAc,KAAK,KAAK,KAAK,SAAS,KAAK;EAChD,KAAK,YAAY;EACjB,KAAK,UAAU;CAChB;CAEA,MAAM,UAAyB;EAC9B,MAAM,QAAQ,KAAK,IAAI;EACvB,OAAO,MACN,IAAI;GACH,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;GACrD,MAAM,IAAI,UAAU,KAAK,aAAa,OAAO,QAAQ,GAAG,GAAG,MAAM,CAAC,CAAC,YAAY,KAAA,CAAS;GACxF,KAAK,WAAW;GAChB;EACD,SAAS,KAAK;GACb,IAAI,CAAC,YAAY,GAAG,KAAK,IAAI,SAAS,UAAU,MAAM;GAEtD,IAAI,MADgB,KAAK,YAAY,GAC1B;IACV,MAAM,IAAI,GAAG,KAAK,SAAS;KAAE,WAAW;KAAM,OAAO;IAAK,CAAC;IAC3D;GACD;GACA,IAAI,KAAK,IAAI,IAAI,SAAS,KAAK,WAC9B,MAAM,IAAI,MAAM,+CAA+C,KAAK,SAAS;GAE9E,MAAMA,WAAM,KAAK,OAAO;EACzB;CAEF;CAEA,MAAc,cAAgC;EAC7C,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,IAAI,SAAS,KAAK,aAAa,MAAM;EACrD,QAAQ;GAKP,IAAI;IACH,MAAM,OAAO,MAAM,IAAI,KAAK,KAAK,OAAO;IACxC,OAAO,KAAK,IAAI,IAAI,KAAK,UAAU;GACpC,QAAQ;IAGP,OAAO;GACR;EACD;EACA,MAAM,MAAM,OAAO,SAAS,OAAO,KAAK,GAAG,EAAE;EAC7C,IAAI,CAAC,OAAO,SAAS,GAAG,KAAK,OAAO,GAAG,OAAO;EAC9C,OAAO,CAAC,eAAe,GAAG;CAC3B;CAEA,MAAM,UAAyB;EAC9B,IAAI,CAAC,KAAK,UAAU;EACpB,KAAK,WAAW;EAChB,MAAM,IAAI,GAAG,KAAK,SAAS;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CAC5D;AACD;AAEA,SAAS,uBAAsC;CAG9C,IAAI,QAAQ,IAAI,mCAAmC,KAAK,OAAO;CAC/D,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,+BAA+B;AAChE;AAEA,IAAa,eAAb,MAA0B;CASzB,YAAY,OAA4B,CAAC,GAAG;EAC3C,KAAK,eAAe,KAAK,gBAAgB,mBAAmB;EAC5D,KAAK,uBAAuB,KAAK,wBAAwB;EACzD,KAAK,WAAW,KAAK,gBAAgB;EACrC,KAAK,QAAQ,KAAK,SAAS,CAAC;EAC5B,KAAK,UAAU,KAAK,WAAW,IAAI,qBAAqB;EACxD,KAAK,gBAAgB,KAAK,iBAAiB;EAC3C,KAAK,cAAc,KAAK,eAAe;CACxC;;CAGA,MAAM,KAAK,OAA+C;EACzD,MAAM,WAAW,KAAK,YAAY,KAAK;EACvC,IAAI,UAAU,aACb,MAAM,kCAAkC,QAAQ;EAGjD,MAAM,eADS,WAAW,MAAM,KAAK,QAAQ,KAAK,QAAQ,IAAI,KAAA,EAClC,SAAS,CAAC;EAEtC,MAAM,SAAS,kBADE,KAAK,SAAS,KAAK,MAAM,UAAU,cAAc,MAAM,KAAK,CAC5C,GAAU,WAAW;EACrC,YAAY,QAAQ,MAAM,CAAC,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;EAEpF,OAAO;GAAE;GAAO,OAAO;EAAO;CAC/B;;;;;CAMA,MAAM,MAAM,OAAqB,OAA+C;EAC/E,MAAM,WAAW,KAAK,YAAY,KAAK;EACvC,IAAI,CAAC,UACJ,MAAM,IAAI,MAAM,+BAA+B,MAAM,4BAA4B;EAElF,IAAI,UAAU,aACb,MAAM,kCAAkC,QAAQ;EAEjD,MAAM,UAA4B;GACjC,SAAA;GACA,OAAO,gBAAgB,CAAC,GAAG,KAAK,CAAC;EAClC;EACA,MAAM,KAAK,MAAM,cAAc,OAAO,OAAO;EAC7C,MAAM,OAAO,IAAI,gBAAgB,UAAU,KAAK,eAAe,KAAK,WAAW;EAC/E,MAAM,KAAK,QAAQ;EACnB,IAAI;GACH,MAAM,KAAK,QAAQ,MAAM,UAAU,OAAO;EAC3C,UAAU;GACT,MAAM,KAAK,QAAQ;EACpB;EACA,MAAM,KAAK,MAAM,aAAa,OAAO,OAAO;CAC7C;;;;;;CAOA,MAAM,OACL,OACA,SAC0B;EAC1B,MAAM,WAAW,KAAK,YAAY,KAAK;EACvC,IAAI,CAAC,UACJ,MAAM,IAAI,MAAM,gCAAgC,MAAM,4BAA4B;EAEnF,IAAI,UAAU,aACb,MAAM,kCAAkC,QAAQ;EAEjD,MAAM,OAAO,IAAI,gBAAgB,UAAU,KAAK,eAAe,KAAK,WAAW;EAC/E,MAAM,KAAK,QAAQ;EACnB,IAAI;GAEH,MAAM,eAAc,MADC,KAAK,QAAQ,KAAK,QAAQ,EAAA,EACnB,SAAS,CAAC;GACtC,MAAM,aAAa,IAAI,IAAI,KAAK,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;GAEzD,MAAM,OAAO,MAAM,QADD,YAAY,QAAQ,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAC7B,CAAC;GACpC,MAAM,UAA4B;IACjC,SAAA;IACA,OAAO,gBAAgB,CAAC,GAAG,IAAI,CAAC;GACjC;GACA,MAAM,KAAK,MAAM,cAAc,OAAO,OAAO;GAC7C,MAAM,KAAK,QAAQ,MAAM,UAAU,OAAO;GAC1C,MAAM,KAAK,MAAM,aAAa,OAAO,OAAO;GAC5C,OAAO;EACR,UAAU;GACT,MAAM,KAAK,QAAQ;EACpB;CACD;;CAGA,MAAM,MAAM,OAAoC;EAC/C,MAAM,WAAW,KAAK,YAAY,KAAK;EACvC,IAAI,CAAC,UAAU;EACf,MAAM,IAAI,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;CACvC;;CAGA,kBAA0B;EACzB,OAAO,KAAK;CACb;;CAGA,uBAAsC;EACrC,OAAO,KAAK,qBAAqB;CAClC;CAEA,YAAoB,OAAoC;EACvD,OAAO,UAAU,SAAS,KAAK,eAAe,KAAK,qBAAqB;CACzE;AACD;AAEA,SAAS,cAAc,MAAuB,OAA6B;CAC1E,OAAO;EACN,IAAI,KAAK;EACT,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,MAAM,KAAK;EACX,KAAK,KAAK;EACV,WAAW;EACX;EACA,OAAO;CACR;AACD;;;;ACjYA,IAAa,4BAAb,cAA+C,MAAM;CACpD,YAAY,QAAgC;EAC3C,MAAM,wCAAwC,QAAQ;EAD3B,KAAA,SAAA;EAE3B,KAAK,OAAO;CACb;AACD;AASA,IAAa,cAAb,MAAyB;CAKxB,YAAY,OAA2B,CAAC,GAAG;EAC1C,KAAK,QAAQ,KAAK,SAAS,IAAI,aAAa;EAC5C,KAAK,WAAW,KAAK,gBAAgB;EACrC,KAAK,WAAW,KAAK,YAAY;CAClC;;CAGA,MAAM,KAAK,QAAsB,QAA8B;EAC9D,MAAM,WAAW,MAAM,KAAK,MAAM,KAAK,KAAK;EAC5C,OAAO;GACN;GACA,OAAO,KAAK,SAAS,SAAS,KAAK;EACpC;CACD;;;;;CAMA,MAAM,IAAI,MAAoB,QAAsB,QAA8B;EACjF,IAAI,KAAK,YAAY,KAAK,EAAE,GAC3B,MAAM,IAAI,0BAA0B,KAAK,EAAE;EAc5C,OAAO;GAAE;GAAO,OAAO,MAZJ,KAAK,MAAM,OAAO,OAAO,OAAO,YAAY;IAC9D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,OAAO,KAAK,EAAE;IACvD,OAAO,CACN,GAAG,UACH;KACC,GAAG;KACH;KACA,WAAW;KACX,OAAO,KAAK,SAAS,SAAS;IAC/B,CACD;GACD,CAAC;EAC2B;CAC7B;;;;;CAMA,MAAM,OACL,IACA,QAAsB,QAC+C;EACrE,IAAI,KAAK,YAAY,EAAE,GACtB,MAAM,IAAI,0BAA0B,EAAE;EAKvC,OAAO;GAAE;GAAO,QAAQ;GAAI,SAAS,EAAC,MAHhB,KAAK,MAAM,OAAO,OAAO,OAAO,YACrD,QAAQ,QAAQ,MAAM,EAAE,OAAO,EAAE,CAClC,EAAA,CAC8C,MAAM,MAAM,EAAE,OAAO,EAAE;EAAE;CACxE;;;;;;CAOA,MAAM,OACL,IACA,OACA,QAAsB,QACC;EACvB,MAAM,YAAY,KAAK,YAAY,EAAE;EAarC,OAAO;GAAE;GAAO,OAAO,MAZJ,KAAK,MAAM,OAAO,OAAO,OAAO,YAAY;IAC9D,IAAI,WAKH,OAAO;IAER,OAAO,QAAQ,KAAK,SACnB,KAAK,OAAO,KAAK;KAAE,GAAG;KAAM,GAAG;KAAO;KAAO,WAAW;IAAM,IAAI,IACnE;GACD,CAAC;EAC2B;CAC7B;;;;;;CAOA,MAAM,YACL,IACA,QAAsB,QACtB,uBAAa,IAAI,KAAK,GACS;EAC/B,IAAI,KAAK,YAAY,EAAE,GAAG;GAGzB,MAAM,OAAO,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE;GAClD,IAAI,CAAC,MAAM,OAAO;GAClB,OAAO;IAAE,GAAG;IAAM;IAAO,WAAW;IAAM,OAAO;IAAG,YAAY,KAAK,YAAY;GAAE;EACpF;EACA,IAAI,UAA+B;EACnC,MAAM,KAAK,MAAM,OAAO,OAAO,OAAO,YAAY;GACjD,MAAM,OAAO,gBAAgB,SAAS,IAAI,IAAI;GAC9C,UAAU,KAAK,MAAM,MAAM,EAAE,OAAO,EAAE,KAAK;GAC3C,OAAO;EACR,CAAC;EACD,OAAO;CACR;;;;;;CAOA,MAAM,aAAmC;EACxC,MAAM,CAAC,MAAM,aAAa,MAAM,QAAQ,IAAI,CAC3C,KAAK,MAAM,KAAK,MAAM,GACtB,KAAK,MAAM,KAAK,WAAW,CAC5B,CAAC;EACD,MAAM,uBAAO,IAAI,IAAY;EAC7B,MAAM,SAAyB,CAAC;EAChC,KAAK,MAAM,QAAQ,UAAU,OAAO;GACnC,KAAK,IAAI,KAAK,EAAE;GAChB,OAAO,KAAK;IAAE,GAAG;IAAM,OAAO;GAAY,CAAC;EAC5C;EACA,KAAK,MAAM,QAAQ,KAAK,OAAO;GAC9B,IAAI,KAAK,IAAI,KAAK,EAAE,GAAG;GACvB,OAAO,KAAK;IAAE,GAAG;IAAM,OAAO;GAAO,CAAC;EACvC;EACA,OAAO;GAAE,OAAO;GAAQ,OAAO,kBAAkB,MAAM;EAAE;CAC1D;;CAGA,WAAyB;EACxB,OAAO,KAAK;CACb;CAEA,YAAoB,IAAqB;EACxC,OAAO,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE;CAC7C;AACD"}
+{"version":3,"file":"toolbox-CbfxpNg-.mjs","names":["delay"],"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-DOMLiHy7.mjs → userHome-CcnAQPG1.mjs}

@@ -22,6 +22,8 @@ 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
@@ -205,6 +207,6 @@ function getProfilesJsonPath() {
 	return path.join(getServicemeHome(), PROFILES_JSON_FILENAME);
 }
 //#endregion
-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 };
+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 };
 
-//# sourceMappingURL=userHome-DOMLiHy7.mjs.map
+//# sourceMappingURL=userHome-CcnAQPG1.mjs.map

package/dist/userHome-CcnAQPG1.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"userHome-CcnAQPG1.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/** rev.20 — r7 BYOM Server Proxy toggle self-state (read by ext + CLI + server). */\nexport const SERVER_PROXY_GLOBAL_FILENAME = \"server-proxy.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":";;;;;;;;;;;;;;;AAgBA,MAAa,qBAAqB;AAClC,MAAa,eAAe;AAC5B,MAAa,eAAe;AAC5B,MAAa,gBAAgB;AAC7B,MAAa,sBAAsB;AACnC,MAAa,sBAAsB;AACnC,MAAa,wBAAwB;AACrC,MAAa,oBAAoB;AACjC,MAAa,mCAAmC;;AAGhD,MAAa,+BAA+B;;;;;;AAO5C,MAAa,uBAAuB;;AAGpC,MAAa,qBAAqB;AAalC,IAAI,kBAAqC,CAAC;AAE1C,SAAgB,qBAAqB,WAAoC;CACxE,kBAAkB,EAAE,GAAG,UAAU;AAClC;AAEA,SAAgB,yBAA+B;CAC9C,kBAAkB,CAAC;AACpB;AAEA,SAAS,iBAAyB;CACjC,MAAM,WAAW,gBAAgB;CACjC,IAAI,aAAa,KAAA,GAChB,OAAO;CAER,OAAO,GAAG,QAAQ;AACnB;AAEA,SAAS,0BAA8C;CACtD,MAAM,WAAW,gBAAgB;CACjC,IAAI,aAAa,KAAA,GAGhB,OAAO,SAAS,SAAS,IAAI,WAAW,KAAA;CAEzC,MAAM,WAAW,QAAQ,IAAI;CAC7B,OAAO,YAAY,SAAS,SAAS,IAAI,WAAW,KAAA;AACrD;AAEA,SAAS,kBAAmC;CAC3C,OAAO,gBAAgB,YAAY,QAAQ;AAC5C;AAEA,SAAgB,iBAAiB,QAAwB;CACxD,IAAI,OAAO,WAAW,YAAY,OAAO,WAAW,KAAK,CAAC,qBAAqB,KAAK,MAAM,GACzF,MAAM,IAAI,MACT,oBAAoB,KAAK,UAAU,MAAM,EAAE,eAC5B,qBAAqB,+EAErC;CAED,OAAO;AACR;;;;;;;;AASA,SAAgB,aAAqB;CACpC,OAAO,eAAe;AACvB;;;;;;AAOA,SAAgB,mBAA2B;CAC1C,MAAM,WAAW,wBAAwB;CACzC,IAAI,aAAa,KAAA,GAChB,OAAO,KAAK,QAAQ,QAAQ;CAE7B,OAAO,KAAK,KAAK,eAAe,GAAG,kBAAkB;AACtD;;AAGA,SAAgB,cAAsB;CACrC,OAAO,KAAK,KAAK,iBAAiB,GAAG,YAAY;AAClD;;AAGA,SAAgB,WAAW,QAAwB;CAClD,OAAO,KAAK,KAAK,YAAY,GAAG,iBAAiB,MAAM,CAAC;AACzD;;AAGA,SAAgB,cAAsB;CACrC,OAAO,KAAK,KAAK,iBAAiB,GAAG,YAAY;AAClD;;AAGA,SAAgB,gBAAgB,QAAwB;CACvD,OAAO,KAAK,KAAK,YAAY,GAAG,iBAAiB,MAAM,CAAC;AACzD;;AAGA,SAAgB,eAAuB;CACtC,OAAO,KAAK,KAAK,iBAAiB,GAAG,aAAa;AACnD;;AAGA,SAAgB,oBAA4B;CAC3C,OAAO,KAAK,KAAK,aAAa,GAAG,mBAAmB;AACrD;;AAGA,SAAgB,oBAA4B;CAC3C,OAAO,KAAK,KAAK,aAAa,GAAG,mBAAmB;AACrD;;;;;;AAOA,SAAgB,qBAA6B;CAC5C,OAAO,KAAK,KAAK,iBAAiB,GAAG,qBAAqB;AAC3D;;AAGA,SAAgB,mBAA2B;CAC1C,OAAO,KAAK,KAAK,iBAAiB,GAAG,iBAAiB;AACvD;;;;;;AAOA,SAAgB,kBAAmC;CAClD,OAAO,gBAAgB;AACxB;;;AAMA,MAAa,kCAAkC;AAC/C,MAAa,+BAA+B;AAC5C,MAAa,yBAAyB;AACtC,MAAa,0BAA0B;AACvC,MAAa,yBAAyB;AACtC,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;;AAGzC,SAAgB,8BAAsC;CACrD,OAAO,KAAK,KAAK,iBAAiB,GAAG,+BAA+B;AACrE;;AAGA,SAAgB,2BAAmC;CAClD,OAAO,KAAK,KAAK,iBAAiB,GAAG,4BAA4B;AAClE;;AAGA,SAAgB,sBAA8B;CAC7C,OAAO,KAAK,KAAK,iBAAiB,GAAG,sBAAsB;AAC5D;;AAGA,SAAgB,uBAA+B;CAC9C,OAAO,KAAK,KAAK,iBAAiB,GAAG,uBAAuB;AAC7D;;AAGA,SAAgB,sBAA8B;CAC7C,OAAO,KAAK,KAAK,iBAAiB,GAAG,sBAAsB;AAC5D;;AAGA,SAAgB,2BAAmC;CAClD,OAAO,KAAK,KAAK,iBAAiB,GAAG,2BAA2B;AACjE;;AAGA,SAAgB,yBAAiC;CAChD,OAAO,KAAK,KAAK,iBAAiB,GAAG,yBAAyB;AAC/D;;;;;;;;;;;;AAeA,SAAgB,2BAAmC;CAClD,OAAO,KAAK,KAAK,iBAAiB,GAAG,4BAA4B;AAClE;;;;;;AASA,MAAa,8BAA8B;AAC3C,MAAa,uBAAuB;AACpC,MAAa,wBAAwB;AACrC,MAAa,sBAAsB;AACnC,MAAa,yBAAyB;;AAGtC,SAAgB,2BAAmC;CAClD,OAAO,KAAK,KAAK,iBAAiB,GAAG,2BAA2B;AACjE;;AAGA,SAAgB,oBAA4B;CAC3C,OAAO,KAAK,KAAK,iBAAiB,GAAG,oBAAoB;AAC1D;;AAGA,SAAgB,qBAA6B;CAC5C,OAAO,KAAK,KAAK,iBAAiB,GAAG,qBAAqB;AAC3D;;AAGA,SAAgB,mBAA2B;CAC1C,OAAO,KAAK,KAAK,iBAAiB,GAAG,mBAAmB;AACzD;;AAGA,SAAgB,sBAA8B;CAC7C,OAAO,KAAK,KAAK,iBAAiB,GAAG,sBAAsB;AAC5D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serviceme/devtools-core",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "Reusable Node.js core capabilities powering the SERVICEME CLI and integrations.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -77,11 +77,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@serviceme/devtools-protocol": "2.0.7",
     "comment-json": "^5.0.0",
     "json5": "^2.2.3",
     "yauzl": "^3.2.0",
-    "zod": "^4.5.4",
-    "@serviceme/devtools-protocol": "2.0.5"
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "@types/node": "^24",