@x-code-cli/core 0.2.10 → 0.3.0

package/dist/commands/registry.d.ts

@@ -0,0 +1,44 @@
+import { type LoadCommandsOptions } from './loader.js';
+import type { CommandDefinition } from './types.js';
+/** Diff returned by reload — drives the /plugin refresh message. */
+export interface CommandReloadSummary {
+    added: string[];
+    removed: string[];
+    changed: string[];
+    unchanged: string[];
+}
+export declare class CommandRegistry {
+    private byName;
+    constructor(commands?: ReadonlyArray<CommandDefinition>);
+    get(name: string): CommandDefinition | undefined;
+    list(): CommandDefinition[];
+    names(): string[];
+    /** Replace the in-memory command set with a fresh load. Used by
+     *  /plugin refresh — keeps registry identity stable so captured
+     *  `options.commandRegistry` references stay valid. */
+    reload(commands: ReadonlyArray<CommandDefinition>): CommandReloadSummary;
+}
+export declare function createCommandRegistry(opts?: LoadCommandsOptions): Promise<CommandRegistry>;
+/** Re-scan plugin command dirs and rebuild the registry in place.
+ *  Caller is responsible for passing the latest plugin-derived extraDirs. */
+export declare function reloadCommandRegistry(registry: CommandRegistry, opts?: LoadCommandsOptions): Promise<CommandReloadSummary>;
+/** Apply Claude Code-style placeholder substitutions to a command
+ *  body before sending it as a model prompt. Recognised placeholders
+ *  match real Claude Code plugin command files (verified against
+ *  `anthropics/claude-code/plugins/<plugin>/commands/<cmd>.md`):
+ *
+ *    $ARGUMENTS  /  ${ARGUMENTS}    — text the user typed after the
+ *                                     command name (`/code-review 123`
+ *                                     → `123`). Empty string when no
+ *                                     argument was given.
+ *    ${CLAUDE_PLUGIN_ROOT}          — absolute path to the owning
+ *                                     plugin's installed dir (versioned;
+ *                                     wiped on reinstall).
+ *    ${CLAUDE_PLUGIN_DATA}          — persistent per-plugin data dir
+ *                                     (`~/.x-code/plugins/data/<id>/`)
+ *                                     that survives reinstalls and
+ *                                     upgrades. Auto-created on first
+ *                                     substitution. Left verbatim when
+ *                                     the command has no plugin context. */
+export declare function expandCommandBody(cmd: CommandDefinition, args: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,mBAAmB,EAAsB,MAAM,aAAa,CAAA;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgC;gBAElC,QAAQ,GAAE,aAAa,CAAC,iBAAiB,CAAM;IAO3D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,IAAI,IAAI,iBAAiB,EAAE;IAI3B,KAAK,IAAI,MAAM,EAAE;IAIjB;;2DAEuD;IACvD,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,oBAAoB;CAkBzE;AAED,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CAGpG;AAED;6EAC6E;AAC7E,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,eAAe,EACzB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED;;;;;;;;;;;;;;;;;4EAiB4E;AAC5E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB9E"}

package/dist/commands/registry.js

@@ -0,0 +1,102 @@
+// @x-code-cli/core — Slash command registry
+//
+// Built once at CLI startup from plugin-contributed command files.
+// Lookups happen from the App.tsx default slash-dispatcher when a typed
+// `/<name>` doesn't match any built-in command or skill. Same
+// startup-frozen / byte-stability model as SkillRegistry.
+import fs from 'node:fs';
+import { pluginDataDir } from '../plugins/paths.js';
+import { loadPluginCommands } from './loader.js';
+export class CommandRegistry {
+    byName;
+    constructor(commands = []) {
+        this.byName = new Map();
+        // Last-write wins on name collision (consistent with how
+        // SkillRegistry merges user → plugin → project).
+        for (const c of commands)
+            this.byName.set(c.name, c);
+    }
+    get(name) {
+        return this.byName.get(name);
+    }
+    list() {
+        return [...this.byName.values()];
+    }
+    names() {
+        return [...this.byName.keys()];
+    }
+    /** Replace the in-memory command set with a fresh load. Used by
+     *  /plugin refresh — keeps registry identity stable so captured
+     *  `options.commandRegistry` references stay valid. */
+    reload(commands) {
+        const previous = this.byName;
+        const next = new Map();
+        for (const c of commands)
+            next.set(c.name, c);
+        const summary = { added: [], removed: [], changed: [], unchanged: [] };
+        for (const [name, cmd] of next) {
+            const prev = previous.get(name);
+            if (!prev)
+                summary.added.push(name);
+            else if (prev.body !== cmd.body || prev.pluginId !== cmd.pluginId || prev.pluginRoot !== cmd.pluginRoot)
+                summary.changed.push(name);
+            else
+                summary.unchanged.push(name);
+        }
+        for (const name of previous.keys()) {
+            if (!next.has(name))
+                summary.removed.push(name);
+        }
+        this.byName = next;
+        return summary;
+    }
+}
+export async function createCommandRegistry(opts = {}) {
+    const commands = await loadPluginCommands(opts);
+    return new CommandRegistry(commands);
+}
+/** Re-scan plugin command dirs and rebuild the registry in place.
+ *  Caller is responsible for passing the latest plugin-derived extraDirs. */
+export async function reloadCommandRegistry(registry, opts = {}) {
+    const commands = await loadPluginCommands(opts);
+    return registry.reload(commands);
+}
+/** Apply Claude Code-style placeholder substitutions to a command
+ *  body before sending it as a model prompt. Recognised placeholders
+ *  match real Claude Code plugin command files (verified against
+ *  `anthropics/claude-code/plugins/<plugin>/commands/<cmd>.md`):
+ *
+ *    $ARGUMENTS  /  ${ARGUMENTS}    — text the user typed after the
+ *                                     command name (`/code-review 123`
+ *                                     → `123`). Empty string when no
+ *                                     argument was given.
+ *    ${CLAUDE_PLUGIN_ROOT}          — absolute path to the owning
+ *                                     plugin's installed dir (versioned;
+ *                                     wiped on reinstall).
+ *    ${CLAUDE_PLUGIN_DATA}          — persistent per-plugin data dir
+ *                                     (`~/.x-code/plugins/data/<id>/`)
+ *                                     that survives reinstalls and
+ *                                     upgrades. Auto-created on first
+ *                                     substitution. Left verbatim when
+ *                                     the command has no plugin context. */
+export function expandCommandBody(cmd, args) {
+    const root = cmd.pluginRoot ?? '';
+    let dataDir = '';
+    if (cmd.pluginId && cmd.body.includes('${CLAUDE_PLUGIN_DATA}')) {
+        dataDir = pluginDataDir(cmd.pluginId);
+        try {
+            fs.mkdirSync(dataDir, { recursive: true });
+        }
+        catch {
+            // mkdir failure leaves dataDir set to the path string anyway —
+            // the user's shell script will surface a sensible error if it
+            // actually tries to write there.
+        }
+    }
+    return cmd.body
+        .replaceAll('${CLAUDE_PLUGIN_ROOT}', root)
+        .replaceAll('${CLAUDE_PLUGIN_DATA}', dataDir)
+        .replaceAll('${ARGUMENTS}', args)
+        .replaceAll('$ARGUMENTS', args);
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

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

package/dist/commands/types.d.ts

@@ -0,0 +1,23 @@
+export interface CommandDefinition {
+    /** Command invocation name without the leading slash. Derived from
+     *  the filename (`code-review.md` → `code-review`). */
+    name: string;
+    /** Short one-line summary from the frontmatter `description` field —
+     *  used by `/help` and `/plugin info` to label the command. */
+    description?: string;
+    /** The prompt template (everything after the frontmatter), trimmed. */
+    body: string;
+    /** Where this command came from. `'plugin'` is the only kind today
+     *  since we don't (yet) scan `~/.x-code/commands/` for user-authored
+     *  ones. Reserved for symmetry with SkillDefinition. */
+    source: 'plugin';
+    /** When source === 'plugin', the owning plugin's id
+     *  (`name@marketplace`). Used by `/plugin info` and to set
+     *  `${CLAUDE_PLUGIN_ROOT}` correctly. */
+    pluginId?: string;
+    /** Absolute path to the plugin's root dir. Substituted in for
+     *  `${CLAUDE_PLUGIN_ROOT}` in the body — so command bodies that
+     *  reference bundled scripts can resolve them correctly. */
+    pluginRoot?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,iBAAiB;IAChC;2DACuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ;mEAC+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ;;4DAEwD;IACxD,MAAM,EAAE,QAAQ,CAAA;IAChB;;6CAEyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;gEAE4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/commands/types.js

@@ -0,0 +1,26 @@
+// @x-code-cli/core — File-based slash command types
+//
+// A "command" is a markdown file shipped by a plugin (or, in future,
+// authored directly under ~/.x-code/commands/) that turns into a slash
+// command at startup. Real Claude Code plugins ship them as
+// `commands/<name>.md` next to their plugin.json — `code-review.md`
+// inside `code-review` plugin's `commands/` registers as `/code-review`.
+//
+// File format (matches Claude Code spec verified against
+// anthropics/claude-code real plugin contents):
+//
+//     ---
+//     description: Code review a pull request
+//     allowed-tools: Bash(gh pr view:*), …      # ignored by us today
+//     ---
+//
+//     <body — a prompt template the model executes>
+//
+//     Substitutions applied to the body before sending to the model:
+//       $ARGUMENTS                — text typed after the command name
+//       ${ARGUMENTS}              — same, brace form
+//       ${CLAUDE_PLUGIN_ROOT}     — absolute path to the plugin root
+//                                   (so command bodies can reference
+//                                   bundled scripts via shell)
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,4DAA4D;AAC5D,oEAAoE;AACpE,yEAAyE;AACzE,EAAE;AACF,yDAAyD;AACzD,gDAAgD;AAChD,EAAE;AACF,UAAU;AACV,8CAA8C;AAC9C,sEAAsE;AACtE,UAAU;AACV,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,qDAAqD;AACrD,qEAAqE;AACrE,qEAAqE;AACrE,+DAA+D"}

package/dist/config/index.d.ts

@@ -22,7 +22,16 @@ export interface UserConfig {
      *  because core doesn't depend on the CLI's theme list. Unknown
      *  values fall back to the default ('dark') silently. */
     theme?: string;
+    /** MCP server declarations. Loose-typed here because the schema is
+     *  validated in `mcp/config-schema.ts` — we don't want to drag a Zod
+     *  type into the config module's surface. Loader uses
+     *  `parseServersBlock` to validate before constructing clients. */
+    mcpServers?: Record<string, unknown>;
 }
+/** Path to the user config file. Exposed so other modules that want to
+ *  read the same JSON (e.g. the MCP loader for the `mcpServers` field)
+ *  honour the X_CODE_HOME override automatically. */
+export declare function getUserConfigPath(): string;
 /** Read the user config. Returns empty object on any failure (missing file,
  *  parse error, wrong shape) so callers don't have to null-check. */
 export declare function loadUserConfig(): UserConfig;

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAuCA,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAMhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW5D;AAgBD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;6DAIyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAYD;qEACqE;AACrE,wBAAgB,cAAc,IAAI,UAAU,CAW3C;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAQhE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB;;;;;;;;;;;;;EAejC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAuCA,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAMhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW5D;AAgBD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;6DAIyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;uEAGmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED;;qDAEqD;AACrD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAMD;qEACqE;AACrE,wBAAgB,cAAc,IAAI,UAAU,CAW3C;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAWhE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB;;;;;;;;;;;;;EAejC"}

package/dist/config/index.js

@@ -16,7 +16,7 @@
 import fsSync from 'node:fs';
 import path from 'node:path';
 import { MODEL_ALIASES, PROVIDER_DETECTION_ORDER } from '../types/index.js';
-import { GLOBAL_XCODE_DIR } from '../utils.js';
+import { userXcodeDir } from '../utils.js';
 /** Provider → environment variable mapping */
 const ENV_MAP = {
     anthropic: 'ANTHROPIC_API_KEY',
@@ -66,15 +66,14 @@ export function resolveModelId(input) {
     }
     return null;
 }
+/** Path to the user config file. Exposed so other modules that want to
+ *  read the same JSON (e.g. the MCP loader for the `mcpServers` field)
+ *  honour the X_CODE_HOME override automatically. */
+export function getUserConfigPath() {
+    return userConfigPath();
+}
 function userConfigPath() {
-    // `X_CODE_HOME` overrides the config directory — used by tests to point
-    // at a scratch tmpdir so the real user's config doesn't leak into
-    // assertions, and available to end users who want to sandbox the CLI's
-    // state. Falls through to `~/.x-code` otherwise.
-    const override = process.env.X_CODE_HOME;
-    if (override)
-        return path.join(override, 'config.json');
-    return path.join(GLOBAL_XCODE_DIR, 'config.json');
+    return path.join(userXcodeDir(), 'config.json');
 }
 /** Read the user config. Returns empty object on any failure (missing file,
  *  parse error, wrong shape) so callers don't have to null-check. */
@@ -95,7 +94,10 @@ export function loadUserConfig() {
 export function saveUserConfig(update) {
     const merged = { ...loadUserConfig(), ...update };
     try {
-        fsSync.mkdirSync(GLOBAL_XCODE_DIR, { recursive: true });
+        // mkdir the SAME root userConfigPath() points at — otherwise an
+        // X_CODE_HOME override creates `~/.x-code/` but writes to the override
+        // and the write silently fails on a missing parent.
+        fsSync.mkdirSync(userXcodeDir(), { recursive: true });
         fsSync.writeFileSync(userConfigPath(), JSON.stringify(merged, null, 2) + '\n', 'utf-8');
     }
     catch {

package/dist/config/index.js.map

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

package/dist/hooks/bus.d.ts

@@ -0,0 +1,54 @@
+import { type ExecuteHookOptions } from './executor.js';
+import { type HookRegistry } from './registry.js';
+import type { HookDecision, HookEvent } from './types.js';
+export interface EmitOptions extends ExecuteHookOptions {
+    /** Force parallel execution. Default is serial for decision events
+     *  and parallel for fire-and-forget. Caller almost never overrides. */
+    parallel?: boolean;
+}
+export declare class HookBus {
+    private registry;
+    constructor(registry: HookRegistry);
+    has(event: HookEvent['name']): boolean;
+    /** Replace the internal registry. Used by /plugin refresh after a
+     *  rescan to pick up newly-installed / removed plugin hooks. */
+    replaceRegistry(registry: HookRegistry): void;
+    /** Emit an event. Returns the per-hook decisions in run order — empty
+     *  when no hooks matched. Callers typically only inspect the result
+     *  for the three DecisionEvents; for the others they just await
+     *  completion for side effects. */
+    emit(event: HookEvent, opts?: EmitOptions): Promise<HookDecision[]>;
+}
+/** A bus with no registered hooks. The CLI passes this when plugins
+ *  are disabled (`--no-plugins`) so the agent loop's emit-sites don't
+ *  need null-checks. */
+export declare function emptyHookBus(): HookBus;
+/** Collapse a list of PreToolUse decisions into a single effective
+ *  outcome. Order matters: deny short-circuits earlier in `emit`, so
+ *  if we see a `deny` here it's the final word. Modifications stack —
+ *  the last `modify` with `args` wins (later plugins refine earlier
+ *  plugins). */
+export interface PreToolEffect {
+    decision: 'allow' | 'deny';
+    reason?: string;
+    /** Modified args, or undefined to use the original. */
+    args?: unknown;
+    /** Extra context to inject (rare for PreToolUse; supported for symmetry). */
+    context?: string;
+}
+export declare function aggregatePreToolUse(decisions: ReadonlyArray<HookDecision>): PreToolEffect;
+export interface PostToolEffect {
+    /** Replacement output, or undefined to keep original. */
+    output?: string;
+    context?: string;
+}
+export declare function aggregatePostToolUse(decisions: ReadonlyArray<HookDecision>): PostToolEffect;
+export interface UserPromptEffect {
+    decision: 'allow' | 'deny';
+    reason?: string;
+    /** Concatenated context from every hook, ready to prepend to the user
+     *  message. Empty string when no hook injected anything. */
+    context: string;
+}
+export declare function aggregateUserPromptSubmit(decisions: ReadonlyArray<HookDecision>): UserPromptEffect;
+//# sourceMappingURL=bus.d.ts.map

package/dist/hooks/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/hooks/bus.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAA;AAEzE,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD;2EACuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,OAAO;IAMN,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAE1C,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO;IAItC;oEACgE;IAChE,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI7C;;;uCAGmC;IAC7B,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA6C9E;AAED;;wBAEwB;AACxB,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAiBD;;;;gBAIgB;AAChB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,aAAa,CAazF;AAED,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,cAAc,CAY3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;gEAC4D;IAC5D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAUlG"}

package/dist/hooks/bus.js

@@ -0,0 +1,165 @@
+// @x-code-cli/core — Hook event bus
+//
+// Thin orchestration layer over [[HookRegistry]]. The agent loop,
+// tool-execution, compression, and sub-agent runner call `bus.emit(event)`
+// at ten lifecycle points; the bus filters hooks by matcher (PreToolUse /
+// PostToolUse only), runs them, and returns the aggregated decisions.
+//
+// Serial vs parallel:
+//
+//   Decision events (UserPromptSubmit / PreToolUse / PostToolUse) run
+//   serially. A `deny` short-circuits the remaining hooks — the agent
+//   stops at the first stop. Order is registration order, so plugin
+//   authors get deterministic behaviour.
+//
+//   Fire-and-forget events (SessionStart / PreCompact / PostCompact /
+//   SubagentStart / SubagentStop / TurnComplete / SessionEnd) run in
+//   parallel — they have no decisions and no ordering concerns.
+//
+// The bus catches per-hook errors and degrades to `allow` so one
+// broken hook never blocks the loop. The executor already does the
+// "non-zero exit / timeout → allow" handling — this layer adds the
+// matcher-regex error guard.
+import { debugLog } from '../utils.js';
+import { executeHook } from './executor.js';
+import { emptyHookRegistry } from './registry.js';
+export class HookBus {
+    registry;
+    // Mutable so /plugin refresh can swap in a fresh registry without
+    // forcing callers to re-capture the bus reference. New incoming
+    // event emissions then see the new hooks; any in-flight executeHook
+    // calls finish against the old registry (deliberate — finishing the
+    // hook is cheaper than coordinating shutdown).
+    constructor(registry) {
+        this.registry = registry;
+    }
+    has(event) {
+        return this.registry.has(event);
+    }
+    /** Replace the internal registry. Used by /plugin refresh after a
+     *  rescan to pick up newly-installed / removed plugin hooks. */
+    replaceRegistry(registry) {
+        this.registry = registry;
+    }
+    /** Emit an event. Returns the per-hook decisions in run order — empty
+     *  when no hooks matched. Callers typically only inspect the result
+     *  for the three DecisionEvents; for the others they just await
+     *  completion for side effects. */
+    async emit(event, opts = {}) {
+        const hooks = this.registry.get(event.name);
+        if (hooks.length === 0)
+            return [];
+        const applicable = hooks.filter((h) => matches(h, event));
+        if (applicable.length === 0)
+            return [];
+        const isDecisionEvent = event.name === 'UserPromptSubmit' || event.name === 'PreToolUse' || event.name === 'PostToolUse';
+        const parallel = opts.parallel ?? !isDecisionEvent;
+        if (parallel) {
+            // For fire-and-forget events we still await the results so the
+            // caller's await-for-completion semantics work; we just don't
+            // serialise execution. Individual hook failures don't fail the
+            // batch (executor returns `allow` on failure).
+            const settled = await Promise.allSettled(applicable.map((h) => executeHook(h, event, opts)));
+            const out = [];
+            for (const r of settled) {
+                if (r.status === 'fulfilled')
+                    out.push(r.value);
+                else {
+                    if (opts.signal?.aborted)
+                        throw r.reason;
+                    debugLog('hooks.bus-error', `${event.name}: ${String(r.reason)}`);
+                    out.push({ decision: 'allow' });
+                }
+            }
+            return out;
+        }
+        // Serial: first `deny` halts the rest. modify decisions stack on
+        // the next hook's input via the caller (we just collect them).
+        const decisions = [];
+        for (const h of applicable) {
+            try {
+                const d = await executeHook(h, event, opts);
+                decisions.push(d);
+                if (d.decision === 'deny')
+                    break;
+            }
+            catch (err) {
+                if (opts.signal?.aborted)
+                    throw err;
+                debugLog('hooks.bus-error', `${h.pluginId} ${event.name}: ${String(err)}`);
+                decisions.push({ decision: 'allow' });
+            }
+        }
+        return decisions;
+    }
+}
+/** A bus with no registered hooks. The CLI passes this when plugins
+ *  are disabled (`--no-plugins`) so the agent loop's emit-sites don't
+ *  need null-checks. */
+export function emptyHookBus() {
+    return new HookBus(emptyHookRegistry());
+}
+function matches(hook, event) {
+    if (event.name !== 'PreToolUse' && event.name !== 'PostToolUse')
+        return true;
+    if (!hook.entry.matcher)
+        return true;
+    try {
+        return new RegExp(hook.entry.matcher).test(event.tool.name);
+    }
+    catch (err) {
+        // Bad regex shouldn't silently disable the hook — degrade to
+        // "matches every tool" but log so support can spot the bad pattern.
+        debugLog('hooks.matcher-invalid', `${hook.pluginId}: ${String(err)}`);
+        return true;
+    }
+}
+export function aggregatePreToolUse(decisions) {
+    let args;
+    let context;
+    for (const d of decisions) {
+        if (d.decision === 'deny')
+            return { decision: 'deny', reason: d.reason };
+        if (d.decision === 'modify') {
+            if (d.args !== undefined)
+                args = d.args;
+            if (d.context)
+                context = d.context;
+        }
+        else if (d.decision === 'allow' && d.context) {
+            context = d.context;
+        }
+    }
+    return { decision: 'allow', args, context };
+}
+export function aggregatePostToolUse(decisions) {
+    let output;
+    let context;
+    for (const d of decisions) {
+        if (d.decision === 'modify') {
+            if (typeof d.output === 'string')
+                output = d.output;
+            if (d.context)
+                context = d.context;
+        }
+        else if (d.decision === 'allow' && d.context) {
+            context = d.context;
+        }
+    }
+    return { output, context };
+}
+export function aggregateUserPromptSubmit(decisions) {
+    const contexts = [];
+    for (const d of decisions) {
+        if (d.decision === 'deny')
+            return { decision: 'deny', reason: d.reason, context: '' };
+        // `context` is present on both 'allow' and 'modify' branches; the
+        // narrowing above eliminates 'deny', so this is safe.
+        if (d.decision === 'allow' && d.context)
+            contexts.push(d.context);
+        else if (d.decision === 'modify' && d.context)
+            contexts.push(d.context);
+    }
+    return { decision: 'allow', context: contexts.join('\n\n') };
+}
+//# sourceMappingURL=bus.js.map

package/dist/hooks/bus.js.map

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