pi-profile-switch 0.9.2 → 0.11.0

package/README.md

@@ -97,27 +97,19 @@ How fields resolve:
 
 The files in [`examples/`](examples/) mirror the two profiles above: `ask.json` is the seeded starter, `example.json` the full-field demo.
 
-### Migrating from earlier versions
-
-If you used an earlier version that stored all profiles in a single `profiles.json` (`schemaVersion: 1`), migrate manually by creating a file for each profile under the `profiles/` directory:
-
-1. Create directory `~/.pi-profile-switch/profiles/` (or `<project>/.pi/profiles/`).
-2. For each key `<name>` in your old `profiles.json`'s `profiles` object, save its value directly as `<name>.json`.
-3. Drop the outer `schemaVersion` and `profiles` envelope.
-
 ## Commands
 
-In the TUI, the `/profile` command family manages everything in-session:
+The `/profile` command family manages everything in-session:
 
 | Command | What it does |
 | --- | --- |
-| `/profile` | Interactive profile picker |
-| `/profile list` / `/profile status` | Show profiles / active profile details |
+| `/profile` | Interactive profile picker; without interactive UI it prints the profile list instead |
 | `/profile use <name>` / `/profile reload` | Switch / reload without restarting (rollback on failure) |
-| `/profile create\|edit\|delete\|duplicate` | Guided profile CRUD (TUI only) |
-| `/profile customize` / `/profile reset` | Narrow the active profile for this session only |
+| `/profile status` | Active profile details: resolved resources and paths, stored overlay, MCP server tri-state |
+| `/profile overlay disable\|enable skill\|extension\|mcp\|tool <name-or-glob>` | Narrow / un-narrow the active profile for this session only; `disable` entries accept names or globs |
+| `/profile overlay clear` | Discard the overlay and reactivate the profile exactly as declared |
 
-All commands work in non-interactive modes (`--mode rpc|print|json`); CRUD wizards are TUI-only.
+All forms work in every mode, including non-interactive ones (`--mode rpc|print|json`); the bare selector degrades to the profile list where no interactive UI exists. The overlay is a runtime-only narrowing: it is never written to a catalog file and never survives a restart. Tools follow the same disable/enable model as the other resource kinds: a tool `disable` entry narrows the profile's resolved tool references — or the runtime's full available tool set when the profile declares no `tools`.
 
 ## Docs
 

package/README.zh-CN.md

@@ -97,27 +97,19 @@ pi-profile-switch 会向全局 `profiles/` 目录播种一个初始 **`ask`** pr
 
 [`examples/`](examples/) 中的两个文件与上面一一对应：`ask.json` 是播种的初始 profile，`example.json` 是全字段演示。
 
-### 从旧版本迁移
-
-如果你之前使用了把全部 profile 存在单个 `profiles.json`（含 `schemaVersion: 1`）的旧版本，请手动把每个 profile 拆分到 `profiles/` 目录：
-
-1. 创建 `~/.pi-profile-switch/profiles/`（或 `<项目>/.pi/profiles/`）目录。
-2. 将旧 `profiles.json` 中 `profiles` 下的每个 `<name>` 键值提取为独立的 `<name>.json` 文件。
-3. 去除外层的 `schemaVersion` 与 `profiles` 信封，文件顶层即为裸 profile 定义。
-
 ## 命令
 
-在 TUI 中，`/profile` 命令族完成所有会话内操作：
+`/profile` 命令族完成所有会话内操作：
 
 | 命令 | 作用 |
 | --- | --- |
-| `/profile` | 交互式选择 profile |
-| `/profile list` / `/profile status` | 列出 profile / 查看活动 profile 详情 |
+| `/profile` | 交互式选择 profile；无交互界面时打印 profile 列表 |
 | `/profile use <name>` / `/profile reload` | 会话内切换 / 重载（失败自动回滚） |
-| `/profile create\|edit\|delete\|duplicate` | 向导式 profile 增删改（仅 TUI） |
-| `/profile customize` / `/profile reset` | 仅本次会话收窄活动 profile |
+| `/profile status` | 查看活动 profile 详情：解析后的资源与路径、已存 overlay、MCP server 三态 |
+| `/profile overlay disable\|enable skill\|extension\|mcp\|tool <name-or-glob>` | 仅本次会话收窄 / 恢复活动 profile；`disable` 接受名称或 glob |
+| `/profile overlay clear` | 丢弃 overlay，完全按定义重新激活 profile |
 
-非交互模式（`--mode rpc|print|json`）下命令同样生效；CRUD 向导仅 TUI 可用。
+所有命令在非交互模式（`--mode rpc|print|json`）下同样生效；裸 `/profile` 在无交互界面时降级为 profile 列表。overlay 是会话级收窄：绝不写入 catalog 文件，也不会跨重启保留。tool 与其他资源类别使用相同的 disable/enable 模型：tool `disable` 条目收窄 profile 解析出的工具引用；profile 未声明 `tools` 时，则收窄运行时的全部可用工具集。
 
 ## 文档
 

package/extensions/pi-profile/index.ts

@@ -1,29 +1,20 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
+import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 
+import { isRecord } from "../../src/json-file.ts";
 import { readTrustInputs } from "../../src/launcher/initial-profile.ts";
 import { discoverAdapterServerNames } from "../../src/mcp-config.ts";
 import { RuntimeStateStore } from "../../src/runtime-state-store.ts";
+import { runStartupNotifications, type NoticeSurface } from "../../src/startup-notifier.ts";
 import { applyLaunchPlan, readLaunchPlanFile } from "../../src/switching/apply-plan.ts";
-import { CUSTOMIZE_USAGE, customizeOverlay, parseCustomizeArgs, resetOverlay } from "../../src/switching/customize.ts";
+import { OVERLAY_USAGE, applyOverlayMutation, clearOverlay, parseOverlayArgs } from "../../src/switching/overlay.ts";
 import { formatProfileList, listProfiles } from "../../src/switching/list-profiles.ts";
-import {
-	createProfile,
-	deleteProfile,
-	duplicateProfile,
-	editProfile,
-	readCatalogScope,
-} from "../../src/switching/profile-crud.ts";
-import type { ProfileDefinition } from "../../src/profile-catalog.ts";
-import {
-	runProfileCreateWizard,
-	runProfileDuplicateWizard,
-	runProfileEditWizard,
-} from "../../src/switching/profile-wizard.ts";
 import { buildStatusReport, formatStatusMarkdown } from "../../src/switching/status.ts";
 import { switchProfile, type SwitchDeps } from "../../src/switching/switch-profile.ts";
-import { getGlobalStateDir } from "../../src/workspace.ts";
+import { getGlobalStateDir, getProfileSwitchDir } from "../../src/workspace.ts";
 
 /**
  * pi-profile extension entry.
@@ -37,23 +28,73 @@ import { getGlobalStateDir } from "../../src/workspace.ts";
  *   via `before_agent_start`.
  * - `/profile use <name>` / `/profile reload`: in-session switching without
  *   restarting the Pi process (src/switching/switch-profile.ts).
- * - `/profile customize` / `/profile reset`: runtime overlay (ticket 06).
- * - `/profile` (selector), `/profile list`, `/profile status`:
- *   observability surface (ticket 07). Status combines the active launch
- *   plan, the stored overlay, fresh MCP discovery, and Pi's actual command
- *   registrations (the winner evidence for same-name conflicts).
- * - `/profile create|edit|delete|duplicate`: catalog CRUD wizards (ticket 09).
- *   CRUD is TUI-only (ticket 11): gated on `ctx.mode === "tui"` with a
- *   mode-aware refusal. Mutations apply via the standard reload path;
- *   mutation success is notified BEFORE the reload — the command context
- *   is stale afterwards.
- * - list/status ship structured `details` payloads (`{kind, profiles}` /
- *   `{kind, report}`) for RPC consumers (ticket 11).
+ * - `/profile overlay ...`: runtime overlay (ticket 06; renamed with the
+ *   command word — disable/enable/tools/clear).
+ * - `/profile` (selector; degrades to the list without dialog-capable UI)
+ *   and `/profile status`: observability surface (ticket 07). Status
+ *   combines the active launch plan, the stored overlay, fresh MCP
+ *   discovery, and Pi's actual command registrations (the winner evidence
+ *   for same-name conflicts).
+ * - The degraded list and status ship structured `details` payloads
+ *   (`{kind, profiles}` / `{kind, report}`) for RPC consumers (ticket 11).
  *
  * Pi re-executes this module on reload, so post-reload state is established
  * exclusively through `session_start` — nothing stale survives.
  */
 
+/** The bundled package's own metadata: the notifier compares the RUNNING
+ *  package version (never Pi's version or a repository checkout). */
+const OWN_PACKAGE_JSON = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
+
+async function readOwnVersion(): Promise<string | undefined> {
+	try {
+		const raw: unknown = JSON.parse(await readFile(OWN_PACKAGE_JSON, "utf8"));
+		if (isRecord(raw) && typeof raw.version === "string") return raw.version;
+	} catch {
+		// Unresolvable package metadata: startup notices are skipped quietly.
+	}
+	return undefined;
+}
+
+/** Notice presentation surface: the TUI notification channel when available,
+ *  stderr in every other mode (never stdout, never the agent's prompts). */
+function createNoticeSurface(ctx: unknown): NoticeSurface {
+	const context = ctx as {
+		hasUI?: boolean;
+		mode?: string;
+		ui?: { notify?: (message: string, level: "info" | "warning" | "error") => void };
+	};
+	if (context.hasUI === true && context.mode === "tui" && typeof context.ui?.notify === "function") {
+		return { display: (message, level) => context.ui!.notify!(message, level) };
+	}
+	return {
+		display: (message) => {
+			process.stderr.write(`${message}\n`);
+		},
+	};
+}
+
+/** Startup notices run once per Pi process on the initial session_start,
+ *  without awaiting remote IO, in an isolated failure domain: a notifier
+ *  problem can never block profile activation, change Pi's exit code, or
+ *  reach the activation/switch error path. Pi re-executes this module on
+ *  reload, and reload/new/resume/fork never pass reason "startup", so no
+ *  second check is possible within one process. */
+async function startStartupNotices(surface: NoticeSurface): Promise<void> {
+	try {
+		const version = await readOwnVersion();
+		if (version === undefined) return;
+		await runStartupNotifications({
+			installedVersion: version,
+			workspaceDir: getProfileSwitchDir(),
+			offline: process.env.PI_OFFLINE === "1",
+			surface,
+		});
+	} catch {
+		// Best-effort by contract: swallow everything the notifier missed.
+	}
+}
+
 function setProfileStatus(ui: unknown, profile: string | undefined): void {
 	if (profile && typeof (ui as { setStatus?: (k: string, v: string) => void })?.setStatus === "function") {
 		(ui as { setStatus: (k: string, v: string) => void }).setStatus("profile", `profile: ${profile}`);
@@ -67,6 +108,10 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 	let pendingSummary: string | undefined;
 
 	pi.on("session_start", async (event, ctx) => {
+		// Capture the notice surface synchronously: pi may replace the session
+		// right after this handler (one-shot modes), after which a captured
+		// ctx throws on access. The surface freezes the channel now.
+		const noticeSurface = createNoticeSurface(ctx);
 		const plan = await readLaunchPlanFile(runtimeDir);
 		setProfileStatus(ctx.ui, plan?.profile);
 		const result = await applyLaunchPlan({
@@ -80,6 +125,9 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 			},
 		});
 		pendingSummary = result.summary;
+		if (event.reason === "startup") {
+			void startStartupNotices(noticeSurface);
+		}
 	});
 
 	pi.on("before_agent_start", async (event) => {
@@ -92,7 +140,7 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 	});
 
 	pi.registerCommand("profile", {
-		description: "pi-profile: /profile [use|reload|customize|reset|list|status|create|edit|delete|duplicate]",
+		description: "pi-profile: /profile [use|reload|status|overlay]",
 		handler: async (args, ctx) => {
 			const [subcommandRaw, ...rest] = args.trim().split(/\s+/).filter(Boolean);
 			const subcommand = subcommandRaw ?? ""; // bare /profile → selector
@@ -107,35 +155,15 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 					// stale context after reload — see above
 				}
 			};
-			const usage = `usage: /profile [use <name> | reload | ${CUSTOMIZE_USAGE} | reset | list | status | create | edit <name> | delete <name> | duplicate]`;
+			const usage = `usage: /profile [use <name> | reload | status | ${OVERLAY_USAGE}]`;
 			if (subcommand === "use" && rest.length === 0) {
 				notify("usage: /profile use <name>", "error");
 				return;
 			}
-			if (
-				subcommand !== "" &&
-				![
-					"use",
-					"reload",
-					"customize",
-					"reset",
-					"list",
-					"status",
-					"create",
-					"edit",
-					"delete",
-					"duplicate",
-				].includes(
-					subcommand,
-				)
-			) {
+			if (subcommand !== "" && !["use", "reload", "status", "overlay"].includes(subcommand)) {
 				notify(usage, "error");
 				return;
 			}
-			if (["edit", "delete"].includes(subcommand) && rest[0] === undefined) {
-				notify(`usage: /profile ${subcommand} <name>`, "error");
-				return;
-			}
 			try {
 				const plan = await readLaunchPlanFile(runtimeDir);
 				if (plan?.agentDir === undefined) {
@@ -148,6 +176,7 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 					runtimeDir,
 					realAgentDir: plan.agentDir,
 					cwd: ctx.cwd,
+					getAllTools: () => pi.getAllTools(),
 					waitForIdle: () => ctx.waitForIdle(),
 					reload: () => ctx.reload(),
 					// A real reload invalidates this context (Pi re-executes
@@ -172,148 +201,22 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 					notify(`profile reloaded: ${result.profile}`, "info");
 					return;
 				}
-				if (subcommand === "customize") {
-					const result = await customizeOverlay(deps, parseCustomizeArgs(rest.join(" ")));
-					for (const warning of result.warnings) notify(warning, "warning");
-					notify(`overlay updated: ${result.profile}`, "info");
-					return;
-				}
-				if (subcommand === "reset") {
-					const result = await resetOverlay(deps);
-					for (const warning of result.warnings) notify(warning, "warning");
-					notify(`overlay cleared: ${result.profile}`, "info");
-					return;
-				}
-				// Profile catalog CRUD (ticket 09): TUI-only wizards; mutations
-				// land in the chosen scope file. Editing the active profile
-				// reloads immediately; deleting the active profile requires a
-				// replacement chosen up front, then switches to it.
-				if (["create", "edit", "delete", "duplicate"].includes(subcommand)) {
-					if (ctx.mode !== "tui") {
-						notify(`/profile ${subcommand} requires TUI mode (current mode: ${ctx.mode})`, "error");
+				if (subcommand === "overlay") {
+					const command = parseOverlayArgs(rest.join(" "));
+					if (command.kind === "clear") {
+						const result = await clearOverlay(deps);
+						for (const warning of result.warnings) notify(warning, "warning");
+						notify(`overlay cleared: ${result.profile}`, "info");
 						return;
 					}
-					const scopeInput = { realAgentDir: plan.agentDir, cwd: ctx.cwd };
-					if (subcommand === "create") {
-						const { projectTrusted: canWriteProject } = await readTrustInputs({
-							agentDir: plan.agentDir,
-							cwd: ctx.cwd,
-						});
-						const wizard = await runProfileCreateWizard(ctx.ui, { projectTrusted: canWriteProject });
-						if (wizard === undefined) return;
-						await createProfile(scopeInput, wizard.scope, wizard.name, wizard.definition);
-						notify(`created profile "${wizard.name}" (${wizard.scope}) — activate with /profile use ${wizard.name}`, "info");
-						return;
-					}
-					if (subcommand === "duplicate") {
-						const entries = await listProfiles(scopeInput);
-						// Read each scope once (trust-gated — never reads an
-						// untrusted project's catalog).
-						const byScope = {
-							global: await readCatalogScope(scopeInput, "global"),
-							project: await readCatalogScope(scopeInput, "project"),
-						};
-						const candidates: Array<{ name: string; source: "global" | "project"; definition: ProfileDefinition }> = [];
-						for (const entry of entries) {
-							if (entry.source === "builtin") continue;
-							const definition = byScope[entry.source].get(entry.name);
-							if (definition !== undefined) {
-								candidates.push({ name: entry.name, source: entry.source, definition });
-							}
-						}
-						const wizard = await runProfileDuplicateWizard(ctx.ui, { candidates });
-						if (wizard === undefined) return;
-						await duplicateProfile(scopeInput, wizard.scope, wizard.sourceName, wizard.newName);
-						notify(
-							`duplicated "${wizard.sourceName}" → "${wizard.newName}" (${wizard.scope}) — the full definition was copied`,
-							"info",
-						);
-						return;
-					}
-					const name = rest[0] as string;
-					if (subcommand === "edit") {
-						// Edit the WINNING definition in its source scope.
-						const entries = await listProfiles(scopeInput);
-						const existing = entries.find((entry) => entry.name === name);
-						if (existing === undefined || existing.source === "builtin") {
-							notify(`profile "${name}" not found in a writable catalog`, "error");
-							return;
-						}
-						const definition = (await readCatalogScope(scopeInput, existing.source)).get(name);
-						if (definition === undefined) {
-							notify(`profile "${name}" not found in the ${existing.source} catalog`, "error");
-							return;
-						}
-						const wizard = await runProfileEditWizard(ctx.ui, {
-							existing: { name, source: existing.source, definition },
-						});
-						if (wizard === undefined) return;
-						await editProfile(scopeInput, wizard.scope, wizard.name, wizard.definition);
-						if (name === plan.profile) {
-							notify(`saved profile "${name}"; reloading`, "info");
-							await switchProfile(plan.profile, deps, { reloadCurrent: true });
-						} else {
-							notify(`saved profile "${name}" (inactive — runtime untouched)`, "info");
-						}
-						return;
-					}
-					// delete
-					const entries = await listProfiles(scopeInput);
-					const existing = entries.find((entry) => entry.name === name);
-					if (existing === undefined || existing.source === "builtin") {
-						notify(`profile "${name}" not found in a writable catalog`, "error");
-						return;
-					}
-					// Both scopes hold the name: choose which record to delete.
-					let scope = existing.source as "global" | "project";
-					const projectCatalog = await readCatalogScope(scopeInput, "project");
-					const globalCatalog = await readCatalogScope(scopeInput, "global");
-					if (projectCatalog.has(name) && globalCatalog.has(name)) {
-						const chosen = await ctx.ui.select(`delete "${name}" from which catalog?`, ["global", "project"]);
-						if (chosen === undefined) return;
-						scope = chosen as "global" | "project";
-					}
-					// If the OTHER scope keeps the name alive, deletion reveals
-					// it and the session can stay on the revealed same-name
-					// definition (symmetric: project→global and global→project).
-					const survivesElsewhere =
-						(scope === "project" && globalCatalog.has(name)) || (scope === "global" && projectCatalog.has(name));
-					let replacement: string | undefined;
-					if (name === plan.profile && !survivesElsewhere) {
-						const survivors = entries.filter((entry) => entry.name !== name);
-						const chosen = await ctx.ui.select(
-							`"${name}" is active — switch to which profile?`,
-							survivors.map((entry) => `${entry.name} [${entry.source}]`),
-						);
-						if (chosen === undefined) return;
-						replacement = chosen.split(" [")[0];
-					}
-					await deleteProfile(scopeInput, scope, name, { activeProfile: plan.profile, replacement });
-					if (name === plan.profile) {
-						if (replacement !== undefined) {
-							notify(`deleted "${name}" (${scope}); switching to ${replacement}`, "info");
-							await switchProfile(replacement, deps, { clearOverlay: true });
-						} else {
-							notify(`deleted the ${scope} record of "${name}"; reloading the revealed definition`, "info");
-							await switchProfile(plan.profile, deps, { reloadCurrent: true });
-						}
-					} else {
-						notify(`deleted profile "${name}" (${scope})`, "info");
-					}
+					const result = await applyOverlayMutation(deps, command.mutate);
+					for (const warning of result.warnings) notify(warning, "warning");
+					notify(`overlay updated: ${result.profile}`, "info");
 					return;
 				}
 				// Observability surface (ticket 07): bare /profile opens the
-				// selector; list/status render via a displayed custom message.
+				// selector; status renders via a displayed custom message.
 				const entries = await listProfiles({ realAgentDir: plan.agentDir, cwd: ctx.cwd });
-				if (subcommand === "list") {
-					pi.sendMessage({
-						customType: "pi-profile",
-						content: formatProfileList(entries, plan.profile),
-						display: true,
-						details: { kind: "list", profiles: entries },
-					});
-					return;
-				}
 				if (subcommand === "status") {
 					const { projectTrusted } = await readTrustInputs({ agentDir: plan.agentDir, cwd: ctx.cwd });
 					const stateDir = plan.source === "project" ? path.join(ctx.cwd, ".pi") : getGlobalStateDir(plan.agentDir);
@@ -338,13 +241,17 @@ export default function piProfileExtension(pi: ExtensionAPI): void {
 					});
 					return;
 				}
-				// Bare /profile: the interactive selector. Without dialog-capable
-				// UI (print mode), fall back to the list.
-				if (!ctx.hasUI) {
+				// Bare /profile: the interactive selector. Degradation boundary
+				// (delta "Observability surface"): outside TUI mode the selector
+				// does not run — the bare invocation degrades to the trust-gated
+				// list, carrying the structured payload the removed `list`
+				// subcommand emitted.
+				if (!ctx.hasUI || ctx.mode !== "tui") {
 					pi.sendMessage({
 						customType: "pi-profile",
 						content: formatProfileList(entries, plan.profile),
 						display: true,
+						details: { kind: "list", profiles: entries },
 					});
 					return;
 				}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-profile-switch",
-  "version": "0.9.2",
+  "version": "0.11.0",
   "description": "Named profiles for Pi: reference skills, extensions, MCP servers, and tools per workflow, switched without restarting. Install: npm install -g pi-profile-switch (not pi install).",
   "type": "module",
   "keywords": [

package/src/launcher/initial-profile.ts

@@ -94,7 +94,7 @@ export async function readTrustInputs(context: LauncherContext): Promise<{
 export async function resolveInitialProfile(
 	name: string | undefined,
 	context: LauncherContext,
-	options?: { overlay?: RuntimeOverlay },
+	options?: { overlay?: RuntimeOverlay; liveToolNames?: string[] },
 ): Promise<InitialProfile> {
 	const { projectTrusted } = await readTrustInputs(context);
 	const projectDir = projectTrusted ? context.cwd : undefined;
@@ -133,7 +133,7 @@ export async function resolveInitialProfile(
 			((overlay.disabledSkills?.length ?? 0) > 0 ||
 				(overlay.disabledExtensions?.length ?? 0) > 0 ||
 				(overlay.disabledMcps?.length ?? 0) > 0 ||
-				overlay.tools !== undefined);
+				(overlay.disabledTools?.length ?? 0) > 0);
 		if (!narrowed) {
 			return { plan: defaultPlan(), projectTrusted, warnings };
 		}
@@ -153,6 +153,7 @@ export async function resolveInitialProfile(
 			skills: discovery.skills,
 			extensions: discovery.extensions,
 			overlay,
+			liveToolNames: options?.liveToolNames,
 		});
 		warnings.push(...discovery.extensions.warnings(), ...unmatchedWarnings(plan));
 		return { plan, discovery, projectDir, projectTrusted, warnings };
@@ -168,6 +169,7 @@ export async function resolveInitialProfile(
 			? await discoverAdapterServerNames(context.agentDir, projectDir)
 			: undefined,
 		overlay: options?.overlay,
+		liveToolNames: options?.liveToolNames,
 	});
 	warnings.push(...discovery.extensions.warnings(), ...unmatchedWarnings(plan));
 	if (plan.mcps !== undefined && !plan.extensions.some(isAdapterExtension)) {

package/src/profile-catalog.ts

@@ -89,8 +89,8 @@ function readOptionalString(value: unknown, field: string, profileName: string,
 	return value;
 }
 
-/** Parses one raw profile definition; exported for the write-side store
- *  (profile-catalog-store.ts) so anything written is loadable. */
+/** Parses one raw profile definition; the single read-time validator so
+ *  catalog files and any external writer stay loadable. */
 export function parseProfileDefinition(name: string, raw: unknown, filePath?: string): ProfileDefinition {
 	if (!isRecord(raw)) {
 		const prefix = filePath ? `${filePath}: ` : "";