@unbrained/pm-cli 2026.5.24 → 2026.5.28

package/dist/cli/commands/extension/managed-state.js

@@ -0,0 +1,172 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f7dc1712-641e-52f3-bbd9-7f20eafddd5f")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { EXIT_CODE } from "../../../core/shared/constants.js";
+import { PmCliError } from "../../../core/shared/errors.js";
+import { nowIso } from "../../../core/shared/time.js";
+import { normalizeExtensionNameForMatch, normalizeStringList } from "./shared.js";
+const MANAGED_EXTENSION_STATE_FILENAME = ".managed-extensions.json";
+const MANAGED_EXTENSION_STATE_VERSION = 1;
+export function resolveManagedExtensionStatePath(extensionsRoot) {
+    return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);
+}
+export function createEmptyManagedExtensionState() {
+    return {
+        version: MANAGED_EXTENSION_STATE_VERSION,
+        updated_at: nowIso(),
+        entries: [],
+    };
+}
+export function sortManagedEntries(entries) {
+    return [...entries].sort((left, right) => {
+        const byScope = left.scope.localeCompare(right.scope);
+        if (byScope !== 0) {
+            return byScope;
+        }
+        const byName = left.name.localeCompare(right.name);
+        if (byName !== 0) {
+            return byName;
+        }
+        return left.directory.localeCompare(right.directory);
+    });
+}
+export function managedExtensionSourcesEquivalent(left, right) {
+    if (left.kind !== right.kind || left.input !== right.input || left.location !== right.location) {
+        return false;
+    }
+    if (left.kind === "npm" && right.kind === "npm") {
+        return left.package === right.package && left.version === right.version;
+    }
+    if (left.kind === "github" && right.kind === "github") {
+        return left.repository === right.repository && left.ref === right.ref && left.subpath === right.subpath && left.commit === right.commit;
+    }
+    if (left.kind === "builtin" && right.kind === "builtin") {
+        return left.name === right.name;
+    }
+    return true;
+}
+export function normalizeManagedState(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const candidate = raw;
+    if (candidate.version !== MANAGED_EXTENSION_STATE_VERSION || !Array.isArray(candidate.entries)) {
+        return null;
+    }
+    const entries = [];
+    for (const rawEntry of candidate.entries) {
+        if (typeof rawEntry !== "object" || rawEntry === null) {
+            continue;
+        }
+        const entry = rawEntry;
+        if (typeof entry.name !== "string" ||
+            entry.name.trim().length === 0 ||
+            typeof entry.directory !== "string" ||
+            entry.directory.trim().length === 0 ||
+            (entry.scope !== "project" && entry.scope !== "global") ||
+            typeof entry.manifest_version !== "string" ||
+            typeof entry.manifest_entry !== "string" ||
+            !Array.isArray(entry.capabilities) ||
+            entry.capabilities.some((value) => typeof value !== "string") ||
+            typeof entry.installed_at !== "string" ||
+            typeof entry.updated_at !== "string" ||
+            typeof entry.source !== "object" ||
+            entry.source === null) {
+            continue;
+        }
+        const source = entry.source;
+        if ((source.kind !== "local" && source.kind !== "github" && source.kind !== "npm" && source.kind !== "builtin") ||
+            typeof source.input !== "string" ||
+            typeof source.location !== "string") {
+            continue;
+        }
+        entries.push({
+            name: entry.name.trim(),
+            directory: entry.directory.trim(),
+            scope: entry.scope,
+            manifest_version: entry.manifest_version,
+            manifest_entry: entry.manifest_entry,
+            capabilities: normalizeStringList(entry.capabilities),
+            installed_at: entry.installed_at,
+            updated_at: entry.updated_at,
+            source: {
+                kind: source.kind,
+                input: source.input,
+                location: source.location,
+                name: typeof source.name === "string" ? source.name : undefined,
+                package: typeof source.package === "string" ? source.package : undefined,
+                version: typeof source.version === "string" ? source.version : undefined,
+                repository: typeof source.repository === "string" ? source.repository : undefined,
+                owner: typeof source.owner === "string" ? source.owner : undefined,
+                repo: typeof source.repo === "string" ? source.repo : undefined,
+                ref: typeof source.ref === "string" ? source.ref : undefined,
+                subpath: typeof source.subpath === "string" ? source.subpath : undefined,
+                commit: typeof source.commit === "string" ? source.commit : undefined,
+            },
+            last_update_check_at: typeof entry.last_update_check_at === "string" ? entry.last_update_check_at : undefined,
+            last_update_remote_commit: typeof entry.last_update_remote_commit === "string" ? entry.last_update_remote_commit : undefined,
+            update_available: typeof entry.update_available === "boolean" || entry.update_available === null
+                ? entry.update_available
+                : undefined,
+            update_error: typeof entry.update_error === "string" ? entry.update_error : undefined,
+        });
+    }
+    return {
+        version: MANAGED_EXTENSION_STATE_VERSION,
+        updated_at: typeof candidate.updated_at === "string" ? candidate.updated_at : nowIso(),
+        entries: sortManagedEntries(entries),
+    };
+}
+export async function readManagedExtensionState(extensionsRoot) {
+    const statePath = resolveManagedExtensionStatePath(extensionsRoot);
+    const fallback = createEmptyManagedExtensionState();
+    try {
+        const raw = await fs.readFile(statePath, "utf8");
+        const parsed = JSON.parse(raw);
+        const normalized = normalizeManagedState(parsed);
+        if (!normalized) {
+            throw new PmCliError(`Managed extension state file "${statePath}" has an invalid schema. Repair or remove it before mutating extension state.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        return {
+            path: statePath,
+            state: normalized,
+            warnings: [],
+        };
+    }
+    catch (error) {
+        if (error instanceof PmCliError) {
+            throw error;
+        }
+        if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+            return {
+                path: statePath,
+                state: fallback,
+                warnings: [],
+            };
+        }
+        throw new PmCliError(`Managed extension state file "${statePath}" could not be read. Repair or remove it before mutating extension state.`, EXIT_CODE.GENERIC_FAILURE);
+    }
+}
+export async function writeManagedExtensionState(extensionsRoot, state) {
+    const statePath = resolveManagedExtensionStatePath(extensionsRoot);
+    const normalized = {
+        version: MANAGED_EXTENSION_STATE_VERSION,
+        updated_at: nowIso(),
+        entries: sortManagedEntries(state.entries),
+    };
+    await fs.mkdir(extensionsRoot, { recursive: true });
+    await fs.writeFile(statePath, `${JSON.stringify(normalized, null, 2)}\n`, "utf8");
+}
+export function upsertManagedEntry(state, entry) {
+    const updatedEntries = state.entries.filter((candidate) => normalizeExtensionNameForMatch(candidate.name) !== normalizeExtensionNameForMatch(entry.name) &&
+        normalizeExtensionNameForMatch(candidate.directory) !== normalizeExtensionNameForMatch(entry.directory));
+    updatedEntries.push(entry);
+    return {
+        ...state,
+        updated_at: nowIso(),
+        entries: sortManagedEntries(updatedEntries),
+    };
+}
+//# sourceMappingURL=managed-state.js.map
+//# debugId=f7dc1712-641e-52f3-bbd9-7f20eafddd5f

package/dist/cli/commands/extension/managed-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-state.js","sources":["cli/commands/extension/managed-state.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { nowIso } from \"../../../core/shared/time.js\";\nimport { normalizeExtensionNameForMatch, normalizeStringList } from \"./shared.js\";\nimport type { ExtensionScope } from \"../extension.js\";\n\nconst MANAGED_EXTENSION_STATE_FILENAME = \".managed-extensions.json\";\nconst MANAGED_EXTENSION_STATE_VERSION = 1;\n\nexport interface ManagedExtensionSource {\n  kind: \"local\" | \"github\" | \"npm\" | \"builtin\";\n  input: string;\n  location: string;\n  name?: string;\n  package?: string;\n  version?: string;\n  repository?: string;\n  owner?: string;\n  repo?: string;\n  ref?: string;\n  subpath?: string;\n  commit?: string;\n}\n\nexport interface ManagedExtensionRecord {\n  name: string;\n  directory: string;\n  scope: ExtensionScope;\n  manifest_version: string;\n  manifest_entry: string;\n  capabilities: string[];\n  installed_at: string;\n  updated_at: string;\n  source: ManagedExtensionSource;\n  last_update_check_at?: string;\n  last_update_remote_commit?: string;\n  update_available?: boolean | null;\n  update_error?: string;\n}\n\nexport interface ManagedExtensionState {\n  version: number;\n  updated_at: string;\n  entries: ManagedExtensionRecord[];\n}\n\nexport interface ManagedExtensionStateReadResult {\n  path: string;\n  state: ManagedExtensionState;\n  warnings: string[];\n}\n\nexport function resolveManagedExtensionStatePath(extensionsRoot: string): string {\n  return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);\n}\n\nexport function createEmptyManagedExtensionState(): ManagedExtensionState {\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: [],\n  };\n}\n\nexport function sortManagedEntries(entries: ManagedExtensionRecord[]): ManagedExtensionRecord[] {\n  return [...entries].sort((left, right) => {\n    const byScope = left.scope.localeCompare(right.scope);\n    if (byScope !== 0) {\n      return byScope;\n    }\n    const byName = left.name.localeCompare(right.name);\n    if (byName !== 0) {\n      return byName;\n    }\n    return left.directory.localeCompare(right.directory);\n  });\n}\n\nexport function managedExtensionSourcesEquivalent(left: ManagedExtensionSource, right: ManagedExtensionSource): boolean {\n  if (left.kind !== right.kind || left.input !== right.input || left.location !== right.location) {\n    return false;\n  }\n  if (left.kind === \"npm\" && right.kind === \"npm\") {\n    return left.package === right.package && left.version === right.version;\n  }\n  if (left.kind === \"github\" && right.kind === \"github\") {\n    return left.repository === right.repository && left.ref === right.ref && left.subpath === right.subpath && left.commit === right.commit;\n  }\n  if (left.kind === \"builtin\" && right.kind === \"builtin\") {\n    return left.name === right.name;\n  }\n  return true;\n}\n\nexport function normalizeManagedState(raw: unknown): ManagedExtensionState | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (candidate.version !== MANAGED_EXTENSION_STATE_VERSION || !Array.isArray(candidate.entries)) {\n    return null;\n  }\n\n  const entries: ManagedExtensionRecord[] = [];\n  for (const rawEntry of candidate.entries) {\n    if (typeof rawEntry !== \"object\" || rawEntry === null) {\n      continue;\n    }\n    const entry = rawEntry as Record<string, unknown>;\n    if (\n      typeof entry.name !== \"string\" ||\n      entry.name.trim().length === 0 ||\n      typeof entry.directory !== \"string\" ||\n      entry.directory.trim().length === 0 ||\n      (entry.scope !== \"project\" && entry.scope !== \"global\") ||\n      typeof entry.manifest_version !== \"string\" ||\n      typeof entry.manifest_entry !== \"string\" ||\n      !Array.isArray(entry.capabilities) ||\n      entry.capabilities.some((value) => typeof value !== \"string\") ||\n      typeof entry.installed_at !== \"string\" ||\n      typeof entry.updated_at !== \"string\" ||\n      typeof entry.source !== \"object\" ||\n      entry.source === null\n    ) {\n      continue;\n    }\n    const source = entry.source as Record<string, unknown>;\n    if (\n      (source.kind !== \"local\" && source.kind !== \"github\" && source.kind !== \"npm\" && source.kind !== \"builtin\") ||\n      typeof source.input !== \"string\" ||\n      typeof source.location !== \"string\"\n    ) {\n      continue;\n    }\n    entries.push({\n      name: entry.name.trim(),\n      directory: entry.directory.trim(),\n      scope: entry.scope,\n      manifest_version: entry.manifest_version,\n      manifest_entry: entry.manifest_entry,\n      capabilities: normalizeStringList(entry.capabilities as string[]),\n      installed_at: entry.installed_at,\n      updated_at: entry.updated_at,\n      source: {\n        kind: source.kind,\n        input: source.input,\n        location: source.location,\n        name: typeof source.name === \"string\" ? source.name : undefined,\n        package: typeof source.package === \"string\" ? source.package : undefined,\n        version: typeof source.version === \"string\" ? source.version : undefined,\n        repository: typeof source.repository === \"string\" ? source.repository : undefined,\n        owner: typeof source.owner === \"string\" ? source.owner : undefined,\n        repo: typeof source.repo === \"string\" ? source.repo : undefined,\n        ref: typeof source.ref === \"string\" ? source.ref : undefined,\n        subpath: typeof source.subpath === \"string\" ? source.subpath : undefined,\n        commit: typeof source.commit === \"string\" ? source.commit : undefined,\n      },\n      last_update_check_at: typeof entry.last_update_check_at === \"string\" ? entry.last_update_check_at : undefined,\n      last_update_remote_commit:\n        typeof entry.last_update_remote_commit === \"string\" ? entry.last_update_remote_commit : undefined,\n      update_available:\n        typeof entry.update_available === \"boolean\" || entry.update_available === null\n          ? entry.update_available\n          : undefined,\n      update_error: typeof entry.update_error === \"string\" ? entry.update_error : undefined,\n    });\n  }\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: typeof candidate.updated_at === \"string\" ? candidate.updated_at : nowIso(),\n    entries: sortManagedEntries(entries),\n  };\n}\n\nexport async function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const fallback = createEmptyManagedExtensionState();\n  try {\n    const raw = await fs.readFile(statePath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const normalized = normalizeManagedState(parsed);\n    if (!normalized) {\n      throw new PmCliError(\n        `Managed extension state file \"${statePath}\" has an invalid schema. Repair or remove it before mutating extension state.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return {\n      path: statePath,\n      state: normalized,\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === \"ENOENT\") {\n      return {\n        path: statePath,\n        state: fallback,\n        warnings: [],\n      };\n    }\n    throw new PmCliError(\n      `Managed extension state file \"${statePath}\" could not be read. Repair or remove it before mutating extension state.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nexport async function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const normalized: ManagedExtensionState = {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(state.entries),\n  };\n  await fs.mkdir(extensionsRoot, { recursive: true });\n  await fs.writeFile(statePath, `${JSON.stringify(normalized, null, 2)}\\n`, \"utf8\");\n}\n\n\nexport function upsertManagedEntry(state: ManagedExtensionState, entry: ManagedExtensionRecord): ManagedExtensionState {\n  const updatedEntries = state.entries.filter(\n    (candidate) =>\n      normalizeExtensionNameForMatch(candidate.name) !== normalizeExtensionNameForMatch(entry.name) &&\n      normalizeExtensionNameForMatch(candidate.directory) !== normalizeExtensionNameForMatch(entry.directory),\n  );\n  updatedEntries.push(entry);\n  return {\n    ...state,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(updatedEntries),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"f7dc1712-641e-52f3-bbd9-7f20eafddd5f"}

package/dist/cli/commands/extension/scaffold.d.ts

@@ -0,0 +1,14 @@
+interface ExtensionScaffoldFileResult {
+    path: string;
+    status: "created" | "unchanged";
+}
+interface ExtensionScaffoldResult {
+    extension_name: string;
+    command_name: string;
+    target_path: string;
+    created_directory: boolean;
+    files: ExtensionScaffoldFileResult[];
+}
+export declare function buildStarterExtensionScaffoldFiles(extensionName: string, commandName: string, vocabulary: "extension" | "package"): Record<string, string>;
+export declare function scaffoldExtensionProject(target: string, vocabulary?: "extension" | "package"): Promise<ExtensionScaffoldResult>;
+export {};

package/dist/cli/commands/extension/scaffold.js

@@ -0,0 +1,202 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6ba6d57e-c873-51ad-b55d-3f35c6f9ef55")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathExists } from "../../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../../core/shared/constants.js";
+import { PmCliError } from "../../../core/shared/errors.js";
+import { normalizeManagedDirectoryName } from "./shared.js";
+export function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary) {
+    const packageName = `pm-${extensionName}`;
+    const manifest = `${JSON.stringify({
+        name: extensionName,
+        version: "0.1.0",
+        entry: "./index.js",
+        capabilities: ["commands"],
+    }, null, 2)}\n`;
+    // pm-fl0c B-1 (2026-05-28): emit the documented `defineExtension({...})`
+    // shape so the generated module gets full TypeScript narrowing on the
+    // `activate(api)` signature (matches docs/EXTENSIONS.md, docs/SDK.md and
+    // docs/examples/starter-extension/index.js). Codex P2 follow-up
+    // (PR #78 review): a bare `import "@unbrained/pm-cli/sdk"` cannot resolve
+    // in extension-only mode — there is no package.json with a dep on
+    // @unbrained/pm-cli, so the loader's `import(<file-url>)` would raise
+    // ERR_MODULE_NOT_FOUND. We therefore emit the typed shape ONLY in package
+    // mode (peerDependencies make the import resolvable from the package's
+    // own node_modules) and keep the import-free shape in extension-only
+    // mode, decorated with a JSDoc @param hint so editors that follow JSDoc
+    // still narrow the `api` parameter.
+    const entrypoint = vocabulary === "package"
+        ? [
+            'import { defineExtension } from "@unbrained/pm-cli/sdk";',
+            "",
+            "export default defineExtension({",
+            "  activate(api) {",
+            "    api.registerCommand({",
+            `      name: ${JSON.stringify(commandName)},`,
+            '      description: "Starter scaffold command. Replace with your own behavior.",',
+            "      run: async (context) => ({",
+            "        ok: true,",
+            `        source: ${JSON.stringify(extensionName)},`,
+            "        command: context.command,",
+            '        message: "Starter extension scaffold is active.",',
+            "      }),",
+            "    });",
+            "  },",
+            "});",
+            "",
+        ].join("\n")
+        : [
+            '/** @param {import("@unbrained/pm-cli/sdk").ExtensionApi} api */',
+            "export function activate(api) {",
+            "  api.registerCommand({",
+            `    name: ${JSON.stringify(commandName)},`,
+            '    description: "Starter scaffold command. Replace with your own behavior.",',
+            "    run: async (context) => ({",
+            "      ok: true,",
+            `      source: ${JSON.stringify(extensionName)},`,
+            "      command: context.command,",
+            '      message: "Starter extension scaffold is active.",',
+            "    }),",
+            "  });",
+            "}",
+            "",
+            "export default {",
+            "  activate,",
+            "};",
+            "",
+        ].join("\n");
+    if (vocabulary === "package") {
+        const packageJson = `${JSON.stringify({
+            name: packageName,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            keywords: ["pm-package"],
+            peerDependencies: {
+                "@unbrained/pm-cli": "*",
+            },
+            pm: {
+                aliases: [extensionName],
+                extensions: [`extensions/${extensionName}`],
+                docs: ["README.md"],
+                examples: ["README.md"],
+                catalog: {
+                    display_name: extensionName,
+                    category: "workflow",
+                    summary: "Starter pm package scaffold.",
+                    tags: ["starter"],
+                },
+            },
+        }, null, 2)}\n`;
+        const packageReadme = [
+            `# ${packageName}`,
+            "",
+            "Generated by `pm package init`.",
+            "",
+            "## Included Files",
+            "- `package.json`: package metadata and `pm` resource manifest.",
+            `- \`extensions/${extensionName}/manifest.json\`: extension metadata and capabilities.`,
+            `- \`extensions/${extensionName}/index.js\`: starter command registration using the \`commands\` capability.`,
+            "",
+            "## Quick Start",
+            "```bash",
+            "pm install --project <package-path>",
+            `pm ${commandName}`,
+            "pm package doctor --project --detail summary",
+            "```",
+            "",
+            "## Notes",
+            "- Keep package metadata in `package.json` and runtime behavior under `extensions/`.",
+            "- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.",
+            "- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",
+            "",
+        ].join("\n");
+        return {
+            "package.json": packageJson,
+            [`extensions/${extensionName}/manifest.json`]: manifest,
+            [`extensions/${extensionName}/index.js`]: entrypoint,
+            "README.md": packageReadme,
+        };
+    }
+    const readme = [
+        `# ${extensionName}`,
+        "",
+        "Generated by `pm extension init`.",
+        "",
+        "## Included Files",
+        "- `manifest.json`: extension metadata and capabilities.",
+        "- `index.js`: starter command registration using the `commands` capability.",
+        "",
+        "## Quick Start",
+        "```bash",
+        "pm extension --install --project <scaffold-path>",
+        `pm ${commandName}`,
+        "pm extension --doctor --project --detail summary",
+        "```",
+        "",
+        "## Notes",
+        "- This scaffold uses ESM exports so it works in package scopes with `type: module`.",
+        "- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.",
+        "",
+    ].join("\n");
+    return {
+        "manifest.json": manifest,
+        "index.js": entrypoint,
+        "README.md": readme,
+    };
+}
+export async function scaffoldExtensionProject(target, vocabulary = "extension") {
+    const normalizedTarget = target.trim();
+    const targetPath = path.resolve(process.cwd(), normalizedTarget);
+    const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));
+    const commandName = `${extensionName} ping`;
+    const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary);
+    let createdDirectory = false;
+    if (await pathExists(targetPath)) {
+        const existingTargetStats = await fs.stat(targetPath);
+        if (!existingTargetStats.isDirectory()) {
+            throw new PmCliError(`Scaffold target "${targetPath}" exists and is not a directory.`, EXIT_CODE.CONFLICT);
+        }
+    }
+    else {
+        await fs.mkdir(targetPath, { recursive: true });
+        createdDirectory = true;
+    }
+    for (const [relativePath, content] of Object.entries(scaffoldFiles)) {
+        const absolutePath = path.join(targetPath, relativePath);
+        if (!(await pathExists(absolutePath))) {
+            continue;
+        }
+        const existingContent = await fs.readFile(absolutePath, "utf8");
+        if (existingContent !== content) {
+            throw new PmCliError(`Scaffold file "${relativePath}" already exists with different content in "${targetPath}". Choose a new target path or remove conflicting files.`, EXIT_CODE.CONFLICT);
+        }
+    }
+    const files = [];
+    for (const [relativePath, content] of Object.entries(scaffoldFiles)) {
+        const absolutePath = path.join(targetPath, relativePath);
+        if (await pathExists(absolutePath)) {
+            files.push({
+                path: relativePath,
+                status: "unchanged",
+            });
+            continue;
+        }
+        await fs.mkdir(path.dirname(absolutePath), { recursive: true });
+        await fs.writeFile(absolutePath, content, "utf8");
+        files.push({
+            path: relativePath,
+            status: "created",
+        });
+    }
+    return {
+        extension_name: extensionName,
+        command_name: commandName,
+        target_path: targetPath,
+        created_directory: createdDirectory,
+        files,
+    };
+}
+//# sourceMappingURL=scaffold.js.map
+//# debugId=6ba6d57e-c873-51ad-b55d-3f35c6f9ef55

package/dist/cli/commands/extension/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sources":["cli/commands/extension/scaffold.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { normalizeManagedDirectoryName } from \"./shared.js\";\n\ninterface ExtensionScaffoldFileResult {\n  path: string;\n  status: \"created\" | \"unchanged\";\n}\n\ninterface ExtensionScaffoldResult {\n  extension_name: string;\n  command_name: string;\n  target_path: string;\n  created_directory: boolean;\n  files: ExtensionScaffoldFileResult[];\n}\n\n\nexport function buildStarterExtensionScaffoldFiles(\n  extensionName: string,\n  commandName: string,\n  vocabulary: \"extension\" | \"package\",\n): Record<string, string> {\n  const packageName = `pm-${extensionName}`;\n  const manifest = `${JSON.stringify(\n    {\n      name: extensionName,\n      version: \"0.1.0\",\n      entry: \"./index.js\",\n      capabilities: [\"commands\"],\n    },\n    null,\n    2,\n  )}\\n`;\n  // pm-fl0c B-1 (2026-05-28): emit the documented `defineExtension({...})`\n  // shape so the generated module gets full TypeScript narrowing on the\n  // `activate(api)` signature (matches docs/EXTENSIONS.md, docs/SDK.md and\n  // docs/examples/starter-extension/index.js). Codex P2 follow-up\n  // (PR #78 review): a bare `import \"@unbrained/pm-cli/sdk\"` cannot resolve\n  // in extension-only mode — there is no package.json with a dep on\n  // @unbrained/pm-cli, so the loader's `import(<file-url>)` would raise\n  // ERR_MODULE_NOT_FOUND. We therefore emit the typed shape ONLY in package\n  // mode (peerDependencies make the import resolvable from the package's\n  // own node_modules) and keep the import-free shape in extension-only\n  // mode, decorated with a JSDoc @param hint so editors that follow JSDoc\n  // still narrow the `api` parameter.\n  const entrypoint =\n    vocabulary === \"package\"\n      ? [\n          'import { defineExtension } from \"@unbrained/pm-cli/sdk\";',\n          \"\",\n          \"export default defineExtension({\",\n          \"  activate(api) {\",\n          \"    api.registerCommand({\",\n          `      name: ${JSON.stringify(commandName)},`,\n          '      description: \"Starter scaffold command. Replace with your own behavior.\",',\n          \"      run: async (context) => ({\",\n          \"        ok: true,\",\n          `        source: ${JSON.stringify(extensionName)},`,\n          \"        command: context.command,\",\n          '        message: \"Starter extension scaffold is active.\",',\n          \"      }),\",\n          \"    });\",\n          \"  },\",\n          \"});\",\n          \"\",\n        ].join(\"\\n\")\n      : [\n          '/** @param {import(\"@unbrained/pm-cli/sdk\").ExtensionApi} api */',\n          \"export function activate(api) {\",\n          \"  api.registerCommand({\",\n          `    name: ${JSON.stringify(commandName)},`,\n          '    description: \"Starter scaffold command. Replace with your own behavior.\",',\n          \"    run: async (context) => ({\",\n          \"      ok: true,\",\n          `      source: ${JSON.stringify(extensionName)},`,\n          \"      command: context.command,\",\n          '      message: \"Starter extension scaffold is active.\",',\n          \"    }),\",\n          \"  });\",\n          \"}\",\n          \"\",\n          \"export default {\",\n          \"  activate,\",\n          \"};\",\n          \"\",\n        ].join(\"\\n\");\n  if (vocabulary === \"package\") {\n    const packageJson = `${JSON.stringify(\n      {\n        name: packageName,\n        version: \"0.1.0\",\n        private: true,\n        type: \"module\",\n        keywords: [\"pm-package\"],\n        peerDependencies: {\n          \"@unbrained/pm-cli\": \"*\",\n        },\n        pm: {\n          aliases: [extensionName],\n          extensions: [`extensions/${extensionName}`],\n          docs: [\"README.md\"],\n          examples: [\"README.md\"],\n          catalog: {\n            display_name: extensionName,\n            category: \"workflow\",\n            summary: \"Starter pm package scaffold.\",\n            tags: [\"starter\"],\n          },\n        },\n      },\n      null,\n      2,\n    )}\\n`;\n    const packageReadme = [\n      `# ${packageName}`,\n      \"\",\n      \"Generated by `pm package init`.\",\n      \"\",\n      \"## Included Files\",\n      \"- `package.json`: package metadata and `pm` resource manifest.\",\n      `- \\`extensions/${extensionName}/manifest.json\\`: extension metadata and capabilities.`,\n      `- \\`extensions/${extensionName}/index.js\\`: starter command registration using the \\`commands\\` capability.`,\n      \"\",\n      \"## Quick Start\",\n      \"```bash\",\n      \"pm install --project <package-path>\",\n      `pm ${commandName}`,\n      \"pm package doctor --project --detail summary\",\n      \"```\",\n      \"\",\n      \"## Notes\",\n      \"- Keep package metadata in `package.json` and runtime behavior under `extensions/`.\",\n      \"- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.\",\n      \"- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.\",\n      \"\",\n    ].join(\"\\n\");\n    return {\n      \"package.json\": packageJson,\n      [`extensions/${extensionName}/manifest.json`]: manifest,\n      [`extensions/${extensionName}/index.js`]: entrypoint,\n      \"README.md\": packageReadme,\n    };\n  }\n  const readme = [\n    `# ${extensionName}`,\n    \"\",\n    \"Generated by `pm extension init`.\",\n    \"\",\n    \"## Included Files\",\n    \"- `manifest.json`: extension metadata and capabilities.\",\n    \"- `index.js`: starter command registration using the `commands` capability.\",\n    \"\",\n    \"## Quick Start\",\n    \"```bash\",\n    \"pm extension --install --project <scaffold-path>\",\n    `pm ${commandName}`,\n    \"pm extension --doctor --project --detail summary\",\n    \"```\",\n    \"\",\n    \"## Notes\",\n    \"- This scaffold uses ESM exports so it works in package scopes with `type: module`.\",\n    \"- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.\",\n    \"\",\n  ].join(\"\\n\");\n  return {\n    \"manifest.json\": manifest,\n    \"index.js\": entrypoint,\n    \"README.md\": readme,\n  };\n}\n\nexport async function scaffoldExtensionProject(\n  target: string,\n  vocabulary: \"extension\" | \"package\" = \"extension\",\n): Promise<ExtensionScaffoldResult> {\n  const normalizedTarget = target.trim();\n  const targetPath = path.resolve(process.cwd(), normalizedTarget);\n  const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));\n  const commandName = `${extensionName} ping`;\n  const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary);\n\n  let createdDirectory = false;\n  if (await pathExists(targetPath)) {\n    const existingTargetStats = await fs.stat(targetPath);\n    if (!existingTargetStats.isDirectory()) {\n      throw new PmCliError(\n        `Scaffold target \"${targetPath}\" exists and is not a directory.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  } else {\n    await fs.mkdir(targetPath, { recursive: true });\n    createdDirectory = true;\n  }\n\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (!(await pathExists(absolutePath))) {\n      continue;\n    }\n    const existingContent = await fs.readFile(absolutePath, \"utf8\");\n    if (existingContent !== content) {\n      throw new PmCliError(\n        `Scaffold file \"${relativePath}\" already exists with different content in \"${targetPath}\". Choose a new target path or remove conflicting files.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  }\n\n  const files: ExtensionScaffoldFileResult[] = [];\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (await pathExists(absolutePath)) {\n      files.push({\n        path: relativePath,\n        status: \"unchanged\",\n      });\n      continue;\n    }\n    await fs.mkdir(path.dirname(absolutePath), { recursive: true });\n    await fs.writeFile(absolutePath, content, \"utf8\");\n    files.push({\n      path: relativePath,\n      status: \"created\",\n    });\n  }\n\n  return {\n    extension_name: extensionName,\n    command_name: commandName,\n    target_path: targetPath,\n    created_directory: createdDirectory,\n    files,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"6ba6d57e-c873-51ad-b55d-3f35c6f9ef55"}

package/dist/cli/commands/extension/shared.d.ts

@@ -0,0 +1,14 @@
+import type { ExtensionManifest } from "../../../core/extensions/loader.js";
+export declare const DEFAULT_EXTENSION_PRIORITY = 100;
+export interface ValidatedExtensionDirectory {
+    directory: string;
+    manifest_path: string;
+    entry_path: string;
+    manifest: ExtensionManifest;
+}
+export declare function normalizeStringList(values: readonly string[]): string[];
+export declare function normalizeExtensionNameForMatch(value: string): string;
+export declare function normalizeManagedDirectoryName(name: string): string;
+export declare function parseExtensionManifest(raw: unknown): ExtensionManifest | null;
+export declare function isCanonicalPathWithinDirectory(directory: string, targetPath: string): Promise<boolean>;
+export declare function validateExtensionDirectory(directory: string): Promise<ValidatedExtensionDirectory>;

package/dist/cli/commands/extension/shared.js

@@ -0,0 +1,106 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cb831def-7a8a-55f8-85e2-7749a5591bfe")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathExists } from "../../../core/fs/fs-utils.js";
+import { isPathWithinDirectory } from "../../../core/fs/path-utils.js";
+import { EXIT_CODE } from "../../../core/shared/constants.js";
+import { PmCliError } from "../../../core/shared/errors.js";
+export const DEFAULT_EXTENSION_PRIORITY = 100;
+export function normalizeStringList(values) {
+    return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
+}
+export function normalizeExtensionNameForMatch(value) {
+    return value.trim().toLowerCase();
+}
+export function normalizeManagedDirectoryName(name) {
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (normalized.length === 0) {
+        throw new PmCliError("Extension manifest name must resolve to a non-empty directory name.", EXIT_CODE.USAGE);
+    }
+    if (normalized === "." || normalized === "..") {
+        // Manifest-controlled input must resolve to a dedicated child directory, never
+        // the extensions root itself or its parent (path-traversal guard).
+        throw new PmCliError("Extension manifest name must not resolve to \".\" or \"..\".", EXIT_CODE.USAGE);
+    }
+    return normalized;
+}
+export function parseExtensionManifest(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const candidate = raw;
+    if (typeof candidate.name !== "string" || candidate.name.trim().length === 0) {
+        return null;
+    }
+    if (typeof candidate.version !== "string" || candidate.version.trim().length === 0) {
+        return null;
+    }
+    if (typeof candidate.entry !== "string" || candidate.entry.trim().length === 0) {
+        return null;
+    }
+    let priority = DEFAULT_EXTENSION_PRIORITY;
+    if (candidate.priority !== undefined && candidate.priority !== null) {
+        if (typeof candidate.priority !== "number" || !Number.isInteger(candidate.priority)) {
+            return null;
+        }
+        priority = candidate.priority;
+    }
+    let capabilities = [];
+    if (candidate.capabilities !== undefined && candidate.capabilities !== null) {
+        if (!Array.isArray(candidate.capabilities) || candidate.capabilities.some((value) => typeof value !== "string")) {
+            return null;
+        }
+        capabilities = normalizeStringList(candidate.capabilities.map((value) => String(value).toLowerCase()));
+    }
+    return {
+        name: candidate.name.trim(),
+        version: candidate.version.trim(),
+        entry: candidate.entry.trim(),
+        priority,
+        capabilities,
+    };
+}
+export async function isCanonicalPathWithinDirectory(directory, targetPath) {
+    const [resolvedDirectory, resolvedTargetPath] = await Promise.all([fs.realpath(directory), fs.realpath(targetPath)]);
+    return isPathWithinDirectory(resolvedDirectory, resolvedTargetPath);
+}
+export async function validateExtensionDirectory(directory) {
+    const manifestPath = path.join(directory, "manifest.json");
+    if (!(await pathExists(manifestPath))) {
+        throw new PmCliError(`Extension manifest is missing at "${manifestPath}".`, EXIT_CODE.USAGE);
+    }
+    let parsedManifest;
+    try {
+        parsedManifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new PmCliError(`Failed to parse extension manifest at "${manifestPath}": ${error instanceof Error ? error.message : String(error)}`, EXIT_CODE.USAGE);
+    }
+    const manifest = parseExtensionManifest(parsedManifest);
+    if (!manifest) {
+        throw new PmCliError(`Extension manifest at "${manifestPath}" is invalid.`, EXIT_CODE.USAGE);
+    }
+    const entryPath = path.resolve(directory, manifest.entry);
+    if (!isPathWithinDirectory(directory, entryPath)) {
+        throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory "${directory}".`, EXIT_CODE.USAGE);
+    }
+    if (!(await pathExists(entryPath))) {
+        throw new PmCliError(`Extension entry file is missing at "${entryPath}".`, EXIT_CODE.USAGE);
+    }
+    if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {
+        throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory after symlink resolution.`, EXIT_CODE.USAGE);
+    }
+    return {
+        directory,
+        manifest_path: manifestPath,
+        entry_path: entryPath,
+        manifest,
+    };
+}
+//# sourceMappingURL=shared.js.map
+//# debugId=cb831def-7a8a-55f8-85e2-7749a5591bfe

package/dist/cli/commands/extension/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sources":["cli/commands/extension/shared.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport type { ExtensionManifest } from \"../../../core/extensions/loader.js\";\n\nexport const DEFAULT_EXTENSION_PRIORITY = 100;\n\nexport interface ValidatedExtensionDirectory {\n  directory: string;\n  manifest_path: string;\n  entry_path: string;\n  manifest: ExtensionManifest;\n}\n\nexport function normalizeStringList(values: readonly string[]): string[] {\n  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n    left.localeCompare(right),\n  );\n}\n\nexport function normalizeExtensionNameForMatch(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nexport function normalizeManagedDirectoryName(name: string): string {\n  const normalized = name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\"Extension manifest name must resolve to a non-empty directory name.\", EXIT_CODE.USAGE);\n  }\n  if (normalized === \".\" || normalized === \"..\") {\n    // Manifest-controlled input must resolve to a dedicated child directory, never\n    // the extensions root itself or its parent (path-traversal guard).\n    throw new PmCliError(\"Extension manifest name must not resolve to \\\".\\\" or \\\"..\\\".\", EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\nexport function parseExtensionManifest(raw: unknown): ExtensionManifest | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (typeof candidate.name !== \"string\" || candidate.name.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.version !== \"string\" || candidate.version.trim().length === 0) {\n    return null;\n  }\n  if (typeof candidate.entry !== \"string\" || candidate.entry.trim().length === 0) {\n    return null;\n  }\n\n  let priority = DEFAULT_EXTENSION_PRIORITY;\n  if (candidate.priority !== undefined && candidate.priority !== null) {\n    if (typeof candidate.priority !== \"number\" || !Number.isInteger(candidate.priority)) {\n      return null;\n    }\n    priority = candidate.priority;\n  }\n\n  let capabilities: string[] = [];\n  if (candidate.capabilities !== undefined && candidate.capabilities !== null) {\n    if (!Array.isArray(candidate.capabilities) || candidate.capabilities.some((value) => typeof value !== \"string\")) {\n      return null;\n    }\n    capabilities = normalizeStringList(candidate.capabilities.map((value) => String(value).toLowerCase()));\n  }\n\n  return {\n    name: candidate.name.trim(),\n    version: candidate.version.trim(),\n    entry: candidate.entry.trim(),\n    priority,\n    capabilities,\n  };\n}\n\nexport async function isCanonicalPathWithinDirectory(directory: string, targetPath: string): Promise<boolean> {\n  const [resolvedDirectory, resolvedTargetPath] = await Promise.all([fs.realpath(directory), fs.realpath(targetPath)]);\n  return isPathWithinDirectory(resolvedDirectory, resolvedTargetPath);\n}\n\nexport async function validateExtensionDirectory(directory: string): Promise<ValidatedExtensionDirectory> {\n  const manifestPath = path.join(directory, \"manifest.json\");\n  if (!(await pathExists(manifestPath))) {\n    throw new PmCliError(`Extension manifest is missing at \"${manifestPath}\".`, EXIT_CODE.USAGE);\n  }\n\n  let parsedManifest: unknown;\n  try {\n    parsedManifest = JSON.parse(await fs.readFile(manifestPath, \"utf8\")) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse extension manifest at \"${manifestPath}\": ${error instanceof Error ? error.message : String(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const manifest = parseExtensionManifest(parsedManifest);\n  if (!manifest) {\n    throw new PmCliError(`Extension manifest at \"${manifestPath}\" is invalid.`, EXIT_CODE.USAGE);\n  }\n\n  const entryPath = path.resolve(directory, manifest.entry);\n  if (!isPathWithinDirectory(directory, entryPath)) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory \"${directory}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await pathExists(entryPath))) {\n    throw new PmCliError(`Extension entry file is missing at \"${entryPath}\".`, EXIT_CODE.USAGE);\n  }\n  if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory after symlink resolution.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    directory,\n    manifest_path: manifestPath,\n    entry_path: entryPath,\n    manifest,\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAS9C,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAChH,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAa;IAC1D,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,MAAM,UAAU,GAAG,IAAI;SACpB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,qEAAqE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/G,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC9C,+EAA+E;QAC/E,mEAAmE;QACnE,MAAM,IAAI,UAAU,CAAC,8DAA8D,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,GAA8B,CAAC;IACjD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,GAAG,0BAA0B,CAAC;IAC1C,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpE,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS,IAAI,SAAS,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;YAChH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,YAAY,GAAG,mBAAmB,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACzG,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;QACjC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE;QAC7B,QAAQ;QACR,YAAY;KACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,SAAiB,EAAE,UAAkB;IACxF,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACrH,OAAO,qBAAqB,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,SAAiB;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,UAAU,CAAC,qCAAqC,YAAY,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,cAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAY,CAAC;IAClF,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,0CAA0C,YAAY,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACpH,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAAC,0BAA0B,YAAY,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,oBAAoB,QAAQ,CAAC,KAAK,2CAA2C,SAAS,IAAI,EAC1F,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,uCAAuC,SAAS,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,8BAA8B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,UAAU,CAClB,oBAAoB,QAAQ,CAAC,KAAK,kEAAkE,EACpG,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS;QACT,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,SAAS;QACrB,QAAQ;KACT,CAAC;AACJ,CAAC","debugId":"cb831def-7a8a-55f8-85e2-7749a5591bfe"}