@x-code-cli/core 0.2.9 → 0.3.0

package/dist/plugins/integration.js

@@ -0,0 +1,233 @@
+// @x-code-cli/core — Plugin contributions → existing loaders integration
+//
+// Takes the output of [[loader]].loadAllPlugins and converts it into the
+// shapes that the pre-existing skill / sub-agent / MCP loaders consume,
+// so a CLI startup call sequence looks like:
+//
+//   const pluginLoad = await loadAllPlugins({ cwd })
+//   const integration = await buildPluginIntegration(pluginLoad)
+//   const skillRegistry  = await createSkillRegistry({  extraDirs: integration.skillsDirs })
+//   const agentRegistry  = await createSubAgentRegistry({ extraDirs: integration.agentsDirs })
+//   const mcpRegistry    = await loadMcpFromDisk({ ..., extraServers: integration.mcpServers })
+//
+// Three concerns this module owns and the others don't:
+//
+//   1. Resolving plugin `mcpServers` from the manifest (a path or an
+//      inline object) into a typed `Record<string, McpServerConfig>`.
+//      The path form is a JSON file shaped `{ mcpServers: {...} }`
+//      (same as ~/.x-code/config.json). The inline form is the raw
+//      record itself.
+//
+//   2. Detecting name collisions across plugins. We deduplicate by
+//      server name — first plugin in iteration order wins, the second's
+//      entry is dropped with a warning. A future improvement: namespace
+//      server names with the plugin id.
+//
+//   3. Logging plugin contributions we don't (yet) support: `commands`
+//      (we lack a file-based slash command loader) and `hooks` (Task 9
+//      will add the hook subsystem; until then, declared hooks are
+//      noted but not executed).
+//
+// Plugin order is deterministic — driven by the iteration order of
+// `loadAllPlugins`'s `contributions` Map, which itself reflects the
+// order of installed_plugins.json + project-local discovery. Stable
+// across boots when the same plugins are installed.
+import fs from 'node:fs/promises';
+import { HookBus } from '../hooks/bus.js';
+import { HookConfigParseError, parseHookConfig } from '../hooks/config-schema.js';
+import { HookRegistry, buildHookRegistry } from '../hooks/registry.js';
+import { parseServersBlock } from '../mcp/config-schema.js';
+import { isStdioConfig } from '../mcp/types.js';
+import { debugLog } from '../utils.js';
+import { loadAllPlugins } from './loader.js';
+import { getPluginUserConfigEnv } from './user-config.js';
+export async function buildPluginIntegration(load) {
+    // Hook registry is built last so we can collect the per-plugin configs
+    // along the way (we don't know all plugins' rootDirs in advance — they
+    // come from LoadedPlugin).
+    const hookInputs = [];
+    const out = {
+        skillsDirs: [],
+        agentsDirs: [],
+        commandsDirs: [],
+        mcpServers: {},
+        hookRegistry: new HookRegistry(),
+        hookBus: new HookBus(new HookRegistry()),
+        pluginHooks: [],
+        mcpCollisions: [],
+        mcpErrors: [],
+        hookErrors: [],
+    };
+    const mcpOwners = new Map();
+    for (const plugin of load.registry.list()) {
+        const contrib = load.contributions.get(plugin.id);
+        if (!contrib)
+            continue;
+        if (contrib.skillsDir)
+            out.skillsDirs.push({ dir: contrib.skillsDir, pluginId: plugin.id });
+        if (contrib.agentsDir)
+            out.agentsDirs.push({ dir: contrib.agentsDir, pluginId: plugin.id });
+        if (contrib.commandsDir) {
+            out.commandsDirs.push({ dir: contrib.commandsDir, pluginId: plugin.id, pluginRoot: plugin.rootDir });
+        }
+        if (contrib.hooks) {
+            const config = await resolvePluginHooks(plugin, contrib.hooks, out);
+            if (config) {
+                hookInputs.push({ pluginId: plugin.id, pluginDir: plugin.rootDir, config });
+                out.pluginHooks.push({ pluginId: plugin.id, events: Object.keys(config) });
+            }
+        }
+        if (contrib.mcpServers) {
+            const servers = await resolvePluginMcpServers(plugin, contrib.mcpServers, out);
+            for (const [name, cfg] of Object.entries(servers)) {
+                const prevOwner = mcpOwners.get(name);
+                if (prevOwner !== undefined) {
+                    out.mcpCollisions.push({ name, droppedFrom: plugin.id, keptFrom: prevOwner });
+                    continue;
+                }
+                out.mcpServers[name] = cfg;
+                mcpOwners.set(name, plugin.id);
+            }
+        }
+    }
+    out.hookRegistry = buildHookRegistry(hookInputs);
+    out.hookBus = new HookBus(out.hookRegistry);
+    return out;
+}
+async function resolvePluginHooks(plugin, contrib, out) {
+    let raw;
+    if (contrib.kind === 'inline') {
+        raw = contrib.data;
+    }
+    else {
+        try {
+            const text = await fs.readFile(contrib.path, 'utf-8');
+            raw = JSON.parse(text);
+        }
+        catch (err) {
+            out.hookErrors.push({
+                pluginId: plugin.id,
+                message: `failed to read hooks file ${contrib.path}: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return null;
+        }
+    }
+    try {
+        return parseHookConfig(raw, plugin.id);
+    }
+    catch (err) {
+        out.hookErrors.push({
+            pluginId: plugin.id,
+            message: err instanceof HookConfigParseError ? err.message : String(err),
+        });
+        return null;
+    }
+}
+/** Extract the `name → cfg` block from the contents of a `.mcp.json`
+ *  file. Two shapes are accepted:
+ *
+ *    - Wrapped:  `{ "mcpServers": { "name": cfg, ... } }`
+ *    - Flat:     `{ "name": cfg, ... }`  (no wrapper key)
+ *
+ *  Claude Code's official plugins (e.g. linear@anthropic-marketplace)
+ *  ship the flat form; the wrapped form matches our own config.json
+ *  layout. The detection rule is: if the parsed object has a
+ *  `mcpServers` key at all, treat it as wrapped (and pass through the
+ *  value as-is so the schema parser produces a clean error on
+ *  misshape). Otherwise treat the whole object as the flat block. */
+export function extractMcpServersBlock(parsed) {
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return {};
+    const obj = parsed;
+    if ('mcpServers' in obj)
+        return obj.mcpServers;
+    return obj;
+}
+async function resolvePluginMcpServers(plugin, contrib, out) {
+    let rawBlock;
+    if (contrib.kind === 'inline') {
+        rawBlock = contrib.data;
+    }
+    else {
+        try {
+            const raw = await fs.readFile(contrib.path, 'utf-8');
+            const parsed = JSON.parse(raw);
+            rawBlock = extractMcpServersBlock(parsed);
+        }
+        catch (err) {
+            out.mcpErrors.push({
+                pluginId: plugin.id,
+                message: `failed to read mcpServers file ${contrib.path}: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return {};
+        }
+    }
+    const { servers, errors } = parseServersBlock(rawBlock);
+    for (const e of errors) {
+        out.mcpErrors.push({ pluginId: plugin.id, message: `mcpServers.${e.name}: ${e.message}` });
+    }
+    // Merge the owning plugin's userConfig values into each server's env
+    // map. Authors who want an API key from a userConfig field declared
+    // in the manifest just reference it as a normal env var inside the
+    // mcpServers entry (or skip the explicit reference and rely on the
+    // child process's inherited env). Pre-existing server env entries win
+    // so an author can override a userConfig value per-server if needed.
+    try {
+        const pluginEnv = await getPluginUserConfigEnv(plugin.id);
+        if (Object.keys(pluginEnv).length > 0) {
+            for (const name of Object.keys(servers)) {
+                const cfg = servers[name];
+                // Only stdio servers spawn a child process and accept env vars —
+                // HTTP servers are remote endpoints, env merging is meaningless.
+                if (isStdioConfig(cfg)) {
+                    servers[name] = { ...cfg, env: { ...pluginEnv, ...(cfg.env ?? {}) } };
+                }
+            }
+        }
+    }
+    catch (err) {
+        out.mcpErrors.push({ pluginId: plugin.id, message: `userConfig env merge: ${String(err)}` });
+    }
+    return servers;
+}
+/** Convenience: log non-fatal integration diagnostics to debug.log so
+ *  `/plugin doctor` and ad-hoc support can find them. CLI startup calls
+ *  this after `buildPluginIntegration` returns. */
+export function debugLogIntegrationDiagnostics(integration) {
+    for (const c of integration.commandsDirs) {
+        debugLog('plugins.commands-loaded', `${c.pluginId} commands dir: ${c.dir}`);
+    }
+    for (const h of integration.pluginHooks) {
+        debugLog('plugins.hooks-registered', `${h.pluginId} hooks: [${h.events.join(', ')}]`);
+    }
+    for (const e of integration.hookErrors) {
+        debugLog('plugins.hook-error', `${e.pluginId}: ${e.message}`);
+    }
+    for (const c of integration.mcpCollisions) {
+        debugLog('plugins.mcp-collision', `mcpServer "${c.name}" from ${c.droppedFrom} dropped (kept ${c.keptFrom})`);
+    }
+    for (const e of integration.mcpErrors) {
+        debugLog('plugins.mcp-error', `${e.pluginId}: ${e.message}`);
+    }
+}
+/** Re-scan plugins from disk and return just the merged plugin-contributed
+ *  mcpServers block. Used by `/mcp refresh` to include plugin servers in
+ *  the merged map (so they aren't silently dropped on standalone MCP
+ *  refresh) and by `/plugin refresh` indirectly via buildPluginIntegration.
+ *
+ *  Returns `{}` (not undefined) so callers can spread it unconditionally.
+ *  Scan failures degrade to `{}` + debug log — callers shouldn't have an
+ *  MCP-only refresh fail because of a plugin-system hiccup. */
+export async function getPluginMcpServersFromDisk(cwd) {
+    try {
+        const load = await loadAllPlugins({ cwd });
+        const integration = await buildPluginIntegration(load);
+        return integration.mcpServers;
+    }
+    catch (err) {
+        debugLog('plugins.mcp-scan-failed', `getPluginMcpServersFromDisk: ${String(err)}`);
+        return {};
+    }
+}
+export { loadAllPlugins };
+//# sourceMappingURL=integration.js.map

package/dist/plugins/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../../src/plugins/integration.ts"],"names":[],"mappings":"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"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,69 @@
+import { PluginRegistry } from './registry.js';
+import type { InlineHookConfig, InlineMcpServers, LoadedPlugin } from './types.js';
+export interface LoadOptions {
+    /** Current working directory. Used to find project-local plugins. */
+    cwd: string;
+    /** Skip plugin loading entirely. Wired to the `--no-plugins` startup
+     *  flag. Returns an empty registry. */
+    disabled?: boolean;
+}
+export interface LoadResult {
+    registry: PluginRegistry;
+    /** Per-plugin resolved contribution paths. Workflow B (skill / agent /
+     *  mcp loader integration) reads from here to merge in plugin-provided
+     *  content. Keyed by plugin id. */
+    contributions: Map<string, ResolvedContributions>;
+}
+/** A plugin's manifest contributions, with relative paths resolved
+ *  against `rootDir`. The `path` / `inline` discriminator on `mcpServers`
+ *  and `hooks` reflects the manifest's union — authors can either point
+ *  at a file or inline the config. */
+export interface ResolvedContributions {
+    /** Absolute path to the plugin's skills directory, if any. Each
+     *  subdir under here is expected to follow the existing
+     *  `<name>/SKILL.md` layout (so the skill loader can scan it
+     *  without changes). */
+    skillsDir?: string;
+    /** Absolute path to the plugin's sub-agent .md files dir. */
+    agentsDir?: string;
+    /** Absolute path to the plugin's slash-command .md files dir. */
+    commandsDir?: string;
+    /** mcpServers contribution — either a path to a JSON file shaped like
+     *  `{ mcpServers: { ... } }` or the inline record (matches the
+     *  ~/.x-code/config.json `mcpServers` shape). */
+    mcpServers?: {
+        kind: 'path';
+        path: string;
+    } | {
+        kind: 'inline';
+        data: InlineMcpServers;
+    };
+    /** hooks contribution — path to hooks.json or inline object. Schema
+     *  validation lives in packages/core/src/hooks (workflow C). */
+    hooks?: {
+        kind: 'path';
+        path: string;
+    } | {
+        kind: 'inline';
+        data: InlineHookConfig;
+    };
+}
+export declare function loadAllPlugins(opts: LoadOptions): Promise<LoadResult>;
+/** Resolve a plugin's manifest contribution fields into absolute paths
+ *  (or inline objects). Exported because individual callers occasionally
+ *  need to recompute this (e.g. `/plugin info` for a single plugin).
+ *
+ *  **Two discovery passes per contribution kind:**
+ *
+ *  1. **Manifest-declared** — if the manifest names a path (e.g.
+ *     `"skills": "./my-skills"`), use that.
+ *  2. **Convention-based fallback** — if not declared, probe the
+ *     conventional directory (`skills/`, `agents/`, `commands/`) and
+ *     the conventional file (`hooks/hooks.json`, `.mcp.json`,
+ *     `mcp.json`). This is how real Claude Code plugins work — their
+ *     manifests typically only carry `name`/`version`/`description` and
+ *     drop the contributions next to it.
+ *
+ *  Async because the convention probe has to stat directories. */
+export declare function resolveContributions(plugin: LoadedPlugin): Promise<ResolvedContributions>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EAKb,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX;2CACuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB;;uCAEmC;IACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;CAClD;AAED;;;sCAGsC;AACtC,MAAM,WAAW,qBAAqB;IACpC;;;4BAGwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;qDAEiD;IACjD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAA;IACxF;oEACgE;IAChE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAA;CACpF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsD3E;AA4ED;;;;;;;;;;;;;;;kEAekE;AAClE,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0D/F"}

package/dist/plugins/loader.js

@@ -0,0 +1,243 @@
+// @x-code-cli/core — Plugin startup loader
+//
+// One-shot orchestration called from the CLI entry. Two passes:
+//
+//   Pass 1 — user-scope installs from installed_plugins.json. Each
+//            record points at a versioned cache dir; we load whichever
+//            version the record names. Orphan records (record present but
+//            cache dir missing) surface as PluginLoadError.
+//
+//   Pass 2 — project-local plugins under <cwd>/.x-code/plugins/<name>/.
+//            These aren't tracked in installed_plugins.json — they're
+//            committed to the repo as in-tree plugins. Marketplace name
+//            is always "local" for these.
+//
+// `installed_plugins.json` is the source of truth for user-scope installs.
+// Orphan cache dirs (no record) are silently ignored — they'll be cleaned
+// up next time the user runs `/plugin uninstall`.
+//
+// One broken plugin (bad JSON, missing manifest, schema violation) never
+// aborts the boot — errors collect into a `PluginLoadError[]` for
+// `/plugin doctor` to surface.
+//
+// The returned `PluginRegistry` is meant to be frozen for the session
+// (same byte-stability constraint as MCP / skills — see CLAUDE.md). The
+// CLI calls `loadAllPlugins()` once at startup and stashes the result on
+// `AgentOptions`. `/plugin refresh` swaps the in-memory state via
+// `registry.reload(...)` and invalidates `systemPromptCache`.
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { EnableState } from './enable-state.js';
+import { listInstalledPlugins } from './installer.js';
+import { ManifestParseError, discoverManifest, parseManifest } from './manifest.js';
+import { pluginCacheDir, projectPluginsDir } from './paths.js';
+import { PluginRegistry } from './registry.js';
+export async function loadAllPlugins(opts) {
+    if (opts.disabled) {
+        return { registry: new PluginRegistry([], []), contributions: new Map() };
+    }
+    const enableState = await EnableState.load(opts.cwd);
+    const plugins = [];
+    const errors = [];
+    const contributions = new Map();
+    // ── Pass 1: user-scope installs ────────────────────────────────────────
+    const installed = await listInstalledPlugins();
+    for (const record of installed) {
+        const rootDir = pluginCacheDir(record.marketplace, record.name, record.version);
+        await loadOnePlugin({
+            rootDir,
+            fallbackId: record.id,
+            marketplace: record.marketplace,
+            scope: record.installScope,
+            source: record.source,
+            enableState,
+            plugins,
+            errors,
+            contributions,
+        });
+    }
+    // ── Pass 2: project-local plugins ──────────────────────────────────────
+    const projectRoot = projectPluginsDir(opts.cwd);
+    let projectEntries = [];
+    try {
+        projectEntries = await fs.readdir(projectRoot, { withFileTypes: true });
+    }
+    catch {
+        /* no project plugins dir — common case */
+    }
+    for (const entry of projectEntries) {
+        if (!entry.isDirectory())
+            continue;
+        const pluginRoot = path.join(projectRoot, entry.name);
+        await loadOnePlugin({
+            rootDir: pluginRoot,
+            // Provisional id from dirname; overridden by manifest.name when we
+            // parse it.
+            fallbackId: `${entry.name}@local`,
+            marketplace: 'local',
+            scope: 'project',
+            source: undefined,
+            enableState,
+            plugins,
+            errors,
+            contributions,
+        });
+    }
+    return { registry: new PluginRegistry(plugins, errors), contributions };
+}
+async function loadOnePlugin(args) {
+    try {
+        const discovery = await discoverManifest(args.rootDir);
+        if (!discovery) {
+            args.errors.push({
+                id: args.fallbackId,
+                path: args.rootDir,
+                message: 'no plugin manifest found (looked for .x-code-plugin/plugin.json, .claude-plugin/plugin.json, plugin.json)',
+            });
+            return;
+        }
+        if (discovery.format === 'gemini') {
+            args.errors.push({
+                id: args.fallbackId,
+                path: args.rootDir,
+                message: 'Gemini extensions are not supported (gemini-extension.json detected); see docs/plugins.md',
+            });
+            return;
+        }
+        let manifest;
+        try {
+            manifest = await parseManifest(discovery.manifestPath);
+        }
+        catch (err) {
+            args.errors.push({
+                id: args.fallbackId,
+                path: args.rootDir,
+                message: err instanceof ManifestParseError ? err.message : String(err),
+            });
+            return;
+        }
+        // Canonical id always comes from the manifest, never from the cache
+        // dir name. For installed plugins this matches the recorded id; for
+        // project-local plugins it may differ from the dirname and the
+        // manifest wins.
+        const id = `${manifest.name}@${args.marketplace}`;
+        const enableResolution = args.enableState.resolve(id);
+        const plugin = {
+            id,
+            manifest,
+            rootDir: args.rootDir,
+            manifestPath: discovery.manifestPath,
+            manifestFormat: discovery.format,
+            source: args.source,
+            marketplace: args.marketplace,
+            scope: args.scope,
+            enabled: enableResolution.enabled,
+        };
+        args.plugins.push(plugin);
+        args.contributions.set(id, await resolveContributions(plugin));
+    }
+    catch (err) {
+        args.errors.push({
+            id: args.fallbackId,
+            path: args.rootDir,
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/** Resolve a plugin's manifest contribution fields into absolute paths
+ *  (or inline objects). Exported because individual callers occasionally
+ *  need to recompute this (e.g. `/plugin info` for a single plugin).
+ *
+ *  **Two discovery passes per contribution kind:**
+ *
+ *  1. **Manifest-declared** — if the manifest names a path (e.g.
+ *     `"skills": "./my-skills"`), use that.
+ *  2. **Convention-based fallback** — if not declared, probe the
+ *     conventional directory (`skills/`, `agents/`, `commands/`) and
+ *     the conventional file (`hooks/hooks.json`, `.mcp.json`,
+ *     `mcp.json`). This is how real Claude Code plugins work — their
+ *     manifests typically only carry `name`/`version`/`description` and
+ *     drop the contributions next to it.
+ *
+ *  Async because the convention probe has to stat directories. */
+export async function resolveContributions(plugin) {
+    const m = plugin.manifest;
+    const root = plugin.rootDir;
+    const result = {};
+    // skills / agents / commands — directory contributions
+    if (m.skills) {
+        result.skillsDir = path.resolve(root, m.skills);
+    }
+    else if (await isDir(path.join(root, 'skills'))) {
+        result.skillsDir = path.join(root, 'skills');
+    }
+    if (m.agents) {
+        result.agentsDir = path.resolve(root, m.agents);
+    }
+    else if (await isDir(path.join(root, 'agents'))) {
+        result.agentsDir = path.join(root, 'agents');
+    }
+    if (m.commands) {
+        result.commandsDir = path.resolve(root, m.commands);
+    }
+    else if (await isDir(path.join(root, 'commands'))) {
+        result.commandsDir = path.join(root, 'commands');
+    }
+    // mcpServers — either declared (path / inline) or auto-discovered
+    // from a conventional file
+    if (m.mcpServers !== undefined) {
+        if (typeof m.mcpServers === 'string') {
+            result.mcpServers = { kind: 'path', path: path.resolve(root, m.mcpServers) };
+        }
+        else {
+            result.mcpServers = { kind: 'inline', data: m.mcpServers };
+        }
+    }
+    else {
+        // Claude Code convention: `.mcp.json` at plugin root. We also
+        // accept `mcp.json` (without dot) as a pragmatic fallback —
+        // some authors use the visible form.
+        for (const conv of ['.mcp.json', 'mcp.json']) {
+            const p = path.join(root, conv);
+            if (await isFile(p)) {
+                result.mcpServers = { kind: 'path', path: p };
+                break;
+            }
+        }
+    }
+    // hooks — same pattern, conventional file `hooks/hooks.json`
+    if (m.hooks !== undefined) {
+        if (typeof m.hooks === 'string') {
+            result.hooks = { kind: 'path', path: path.resolve(root, m.hooks) };
+        }
+        else {
+            result.hooks = { kind: 'inline', data: m.hooks };
+        }
+    }
+    else {
+        const conv = path.join(root, 'hooks', 'hooks.json');
+        if (await isFile(conv)) {
+            result.hooks = { kind: 'path', path: conv };
+        }
+    }
+    return result;
+}
+async function isDir(p) {
+    try {
+        const s = await fs.stat(p);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function isFile(p) {
+    try {
+        const s = await fs.stat(p);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"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"}

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,23 @@
+import type { ManifestFormat, PluginManifest } from './types.js';
+export interface ManifestDiscovery {
+    /** Absolute path to the manifest file. */
+    manifestPath: string;
+    format: ManifestFormat;
+}
+/** Probe a plugin root for a manifest. Returns the highest-priority
+ *  match. Returns `{ format: 'gemini', ... }` when ONLY a Gemini manifest
+ *  exists — the installer uses this to produce a friendly "we don't
+ *  support Gemini extensions" error rather than a confusing
+ *  "no manifest found". */
+export declare function discoverManifest(rootDir: string): Promise<ManifestDiscovery | null>;
+export declare class ManifestParseError extends Error {
+    readonly manifestPath: string;
+    constructor(message: string, manifestPath: string);
+}
+/** Parse + validate a manifest JSON file. Fills in `schemaVersion: "1"`
+ *  when absent (the implicit default — most existing Claude Code plugins
+ *  don't set this field). Throws `ManifestParseError` with a path-tagged
+ *  message on failure so the loader can collect it as a doctor entry
+ *  without aborting the whole boot. */
+export declare function parseManifest(manifestPath: string): Promise<PluginManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugins/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAiEhE,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;;2BAI2B;AAC3B,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAYzF;AAID,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,YAAY,EAAE,MAAM;gBADpC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM;CAKvC;AAED;;;;uCAIuC;AACvC,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoCjF"}