@cleocode/caamp 2026.10.8 → 2026.10.9

package/dist/index.d.ts

@@ -1,9 +1,13 @@
 import { InstructionDeliveryFinding, CaampInjectionAction, GlobalInstructionStalenessReport, GlobalInstructionSyncResult, InstructionDelivery } from '@cleocode/contracts/caamp-markers';
 import { PackageArtifactBudgets, PackageArtifactRequirement, PackageArtifactFile, PackageFilesEntry, PackageArtifactInventory, PackageArtifactPolicy, PackageArtifactValidation } from '@cleocode/contracts/package-artifact';
 import { WorktreeHandle } from '@cleocode/cant';
+export { FileLockOptions, JsonConfigParseError, assertNotTornRead, updateJsonConfigFile, withFileLock } from './atomic.js';
+export { CANONICAL_HOOK_EVENTS, CanonicalEventDefinition, CanonicalHookEvent, CrossProviderMatrix, HOOK_CATEGORIES, HookCategory, HookHandlerType, HookMapping, HookSupportResult, HookSystemType, NormalizedHookEvent, ProviderHookProfile, ProviderHookSummary, buildHookMatrix, getAllCanonicalEvents, getCanonicalEvent, getCanonicalEventsByCategory, getCommonEvents, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getMappedProviderIds, getProviderHookProfile, getProviderOnlyEvents, getProviderSummary, getProvidersForEvent, getSupportedEvents, getUnsupportedEvents, resolveNativeEvent, supportsHook, toCanonical, toNative, toNativeBatch, translateToAll } from './hooks.js';
 import { PlatformPaths, SystemInfo } from '@cleocode/paths';
 export { PlatformPaths, SystemInfo } from '@cleocode/paths';
 import { SkillGateScanResult, SkillGatePolicyDecision, SkillGateFederationResult, SkillGateFederationInput } from '@cleocode/contracts';
+import '@cleocode/contracts/project-hook-delivery.js';
+import '@cleocode/contracts/tools/atomic';
 
 /**
  * Priority tier identifier stored in registry.json.
@@ -3147,179 +3151,6 @@ declare function writeConfig(filePath: string, format: ConfigFormat, key: string
  */
 declare function removeConfig(filePath: string, format: ConfigFormat, key: string, serverName: string): Promise<boolean>;
 
-/**
- * Atomic file writes and cross-process file locking.
- *
- * CAAMP mutates files that are shared by *every* project on the machine — most
- * critically `~/.agents/AGENTS.md`, which every `cleo init`, `cleo upgrade` and
- * `cleo doctor` run rewrites regardless of which project it was invoked from.
- * A plain `writeFile` on such a path is `open(O_TRUNC)` followed by one or more
- * `write(2)` calls: two processes interleaving there can leave a caller reading
- * a half-written file, and a reader racing a writer can observe a truncated
- * one.
- *
- * Two primitives remove that class of failure:
- *
- * - `writeFileAtomic` — the canonical tmp-then-rename primitive from
- *   `@cleocode/core/tools/fs.js`. `rename(2)` within a filesystem is atomic, so
- *   a concurrent reader sees either the whole old file or the whole new one,
- *   never a mixture. It is re-exported here for callers already importing this
- *   module; the definition lives in core, per the tools-vs-skills boundary.
- * - {@link withFileLock} — serialise a whole read-modify-write cycle across
- *   processes via an `O_EXCL` guard file, so two writers cannot both read the
- *   pre-state and then clobber each other's result. Generalised from the
- *   bespoke copy that lived inline in `lock-utils.ts` (now a caller).
- *
- * @task T12051
- */
-/**
- * Options controlling {@link withFileLock}.
- *
- * @public
- */
-interface FileLockOptions {
-    /**
-     * Number of acquisition attempts before throwing.
-     *
-     * @defaultValue 400
-     */
-    retries?: number;
-    /**
-     * Delay between attempts, in milliseconds.
-     *
-     * @defaultValue 25
-     */
-    delayMs?: number;
-    /**
-     * Age at which an existing guard file is treated as abandoned and removed.
-     *
-     * @defaultValue 30000
-     */
-    staleMs?: number;
-}
-/**
- * Run `fn` while holding an exclusive cross-process lock on `targetPath`.
- *
- * The lock is a `<targetPath>.lock` guard file created with `O_EXCL`, which is
- * atomic on POSIX and on Windows. A guard left behind by a crashed process is
- * reclaimed once it exceeds `staleMs`.
- *
- * The guard is always released, including when `fn` throws.
- *
- * @param targetPath - Path being protected (the guard is a sibling of it)
- * @param fn - Work to perform while holding the lock
- * @param options - Retry, delay and staleness tuning
- * @returns Whatever `fn` returns
- * @throws Error if the lock cannot be acquired within `retries` attempts
- *
- * @example
- * ```typescript
- * const action = await withFileLock(agentsMd, async () => {
- *   const before = await readFile(agentsMd, "utf-8");
- *   await writeFileAtomic(agentsMd, transform(before));
- *   return "updated";
- * });
- * ```
- *
- * @public
- */
-declare function withFileLock<T>(targetPath: string, fn: () => Promise<T>, options?: FileLockOptions): Promise<T>;
-/**
- * Throw if a read looks like it landed inside another process's
- * truncate-then-write window.
- *
- * `writeFileAtomic` makes *our* writes indivisible, but callers outside this
- * package still rewrite instruction files with a plain `writeFile`, which is
- * `open(O_TRUNC)` followed by `write(2)`. A read landing between those two
- * returns an empty string for a file that is not empty on disk. Reconciling
- * from that observation would replace every byte of the user's content with a
- * lone CAAMP block.
- *
- * Failing closed is the right trade: the caller retries or reports, and the
- * file is left exactly as it was.
- *
- * @param filePath - Path that was read, for the error message
- * @param content - What the read returned
- * @param sizeOnDisk - `stat().size` for the same path
- * @throws Error when `content` is empty but `sizeOnDisk` is greater than zero
- *
- * @example
- * ```typescript
- * const text = await readFile(p, "utf-8");
- * if (text.length === 0) assertNotTornRead(p, text, (await stat(p)).size);
- * ```
- *
- * @public
- */
-declare function assertNotTornRead(filePath: string, content: string, sizeOnDisk: number): void;
-/**
- * A JSON config file could not be parsed, so it was left untouched.
- *
- * @remarks
- * Thrown by {@link updateJsonConfigFile} instead of treating the file as empty.
- * The pre-T12385 provider adapters caught the parse error and started from
- * `{}`, so a torn read of `~/.claude/settings.json` (Claude Code rewriting it
- * at the same moment) replaced the user's permissions, env, model and hooks
- * with CLEO's entries alone.
- *
- * @example
- * ```typescript
- * try {
- *   await updateJsonConfigFile(path, (config) => false);
- * } catch (err) {
- *   if (err instanceof JsonConfigParseError) console.error(err.filePath);
- * }
- * ```
- *
- * @public
- */
-declare class JsonConfigParseError extends Error {
-    /** Path of the file that failed to parse. */
-    readonly filePath: string;
-    /**
-     * @param filePath - Path of the file that failed to parse
-     * @param reason - Parser message
-     */
-    constructor(filePath: string, reason: string);
-}
-/**
- * Read-modify-write a JSON object file under the cross-process lock, writing
- * atomically, and never replacing an unparseable file.
- *
- * @remarks
- * Composes the two existing primitives — {@link withFileLock} and core's
- * `writeFileAtomic` — for provider config files such as
- * `~/.claude/settings.json` that the provider itself also rewrites (T12385):
- *
- * - The whole read → mutate → write cycle holds the `<file>.lock` guard, so
- *   two CLEO writers cannot both read the pre-state and clobber each other.
- * - The write is tmp-then-rename, so a concurrent reader (including the
- *   provider) sees the whole old file or the whole new one.
- * - A missing file starts from `{}`. A file that exists but is empty on read
- *   while non-empty on disk, is not valid JSON, or is not a JSON object throws
- *   ({@link assertNotTornRead} / {@link JsonConfigParseError}) and the file is
- *   left byte-identical.
- *
- * @param filePath - JSON file to update
- * @param mutate - Edits the parsed object in place; returns `true` when it
- *   changed something that must be written
- * @returns Whether the file was written
- * @throws {@link JsonConfigParseError} when the existing file cannot be parsed
- *   as a JSON object; the file is not modified
- *
- * @example
- * ```typescript
- * const wrote = await updateJsonConfigFile(settingsPath, (settings) => {
- *   if (settings.enabled === true) return false;
- *   settings.enabled = true;
- *   return true;
- * });
- * ```
- *
- * @public
- */
-declare function updateJsonConfigFile(filePath: string, mutate: (config: Record<string, unknown>) => boolean): Promise<boolean>;
-
 /**
  * Skill installer - canonical + symlink model
  *
@@ -4132,748 +3963,6 @@ declare function getAllHarnesses(): Harness[];
  */
 declare function resolveDefaultTargetProviders(options?: ResolveDefaultTargetProvidersOptions): Provider[];
 
-/**
- * All hook event categories (8 total).
- * @public
- */
-declare const HOOK_CATEGORIES: readonly ["agent", "context", "memory", "pipeline", "prompt", "session", "task", "tool"];
-/** Union type of valid hook category strings. */
-type HookCategory = (typeof HOOK_CATEGORIES)[number];
-/**
- * All canonical hook events (31 total: 16 provider, 15 domain).
- *
- * This replaces the previously hardcoded tuple in types.ts.
- * Single source of truth: providers/hook-mappings.json
- * @public
- */
-declare const CANONICAL_HOOK_EVENTS: readonly ["ConfigChange", "Notification", "PermissionRequest", "PostCompact", "PostModel", "PostToolUse", "PostToolUseFailure", "PreCompact", "PreModel", "PreToolUse", "PromptSubmit", "ResponseComplete", "SessionEnd", "SessionStart", "SubagentStart", "SubagentStop", "ApprovalExpired", "ApprovalGranted", "ApprovalRequested", "MemoryDecisionStored", "MemoryLearningStored", "MemoryObserved", "MemoryPatternStored", "PipelineManifestAppended", "PipelineStageCompleted", "SessionEnded", "SessionStarted", "TaskBlocked", "TaskCompleted", "TaskCreated", "TaskStarted"];
-/** Union type of all canonical hook event names. */
-type CanonicalHookEvent = (typeof CANONICAL_HOOK_EVENTS)[number];
-
-/**
- * CAAMP Hooks Normalizer - Type Definitions
- *
- * Defines the canonical CAAMP hook event taxonomy and provider mapping types.
- * CAAMP provides a unified hook interface across all providers — consumers
- * use canonical event names, and the normalizer translates to/from
- * provider-native names.
- */
-
-/**
- * Definition of a canonical hook event including its category and behavior.
- *
- * @remarks
- * Each canonical event has a category for grouping, a human-readable description,
- * and a `canBlock` flag indicating whether a hook handler can prevent the
- * associated action from proceeding.
- *
- * @public
- */
-interface CanonicalEventDefinition {
-    /** The lifecycle category this event belongs to (e.g. `"session"`, `"tool"`). */
-    category: HookCategory;
-    /** Human-readable description of when this event fires. */
-    description: string;
-    /** Whether a hook handler can block or cancel the associated action. */
-    canBlock: boolean;
-}
-/**
- * The type of hook system a provider uses.
- *
- * @remarks
- * - `"config"` — hooks defined in a configuration file (e.g. Claude Code `.claude/settings.json`)
- * - `"plugin"` — hooks implemented via a plugin/extension system
- * - `"none"` — provider does not support hooks
- *
- * @public
- */
-type HookSystemType = 'config' | 'plugin' | 'none';
-/**
- * The mechanism a provider uses to execute hook handlers.
- *
- * @remarks
- * - `"command"` — shell command execution
- * - `"http"` — HTTP webhook callback
- * - `"prompt"` — LLM prompt injection
- * - `"agent"` — sub-agent delegation
- * - `"plugin"` — native plugin API call
- *
- * @public
- */
-type HookHandlerType = 'command' | 'http' | 'prompt' | 'agent' | 'plugin';
-/**
- * Mapping of a single canonical event to a provider's native representation.
- *
- * @remarks
- * Each entry in a provider's hook profile maps one canonical event to the
- * provider's native event name. If `supported` is `false`, the provider
- * does not fire this event. Optional `notes` capture caveats or limitations.
- *
- * @public
- */
-interface HookMapping {
-    /** The provider-native event name, or `null` if the event has no native equivalent. */
-    nativeName: string | null;
-    /** Whether this canonical event is supported by the provider. */
-    supported: boolean;
-    /**
-     * Optional notes about support limitations or behavioral differences.
-     *
-     * @defaultValue `undefined`
-     */
-    notes?: string;
-}
-/**
- * Complete hook profile for a single provider.
- *
- * @remarks
- * Describes the provider's hook system type, configuration location, supported
- * handler types, and the full mapping of canonical events to native names.
- * This is the primary data structure loaded from `providers/hook-mappings.json`.
- *
- * @public
- */
-interface ProviderHookProfile {
-    /** The type of hook system the provider uses (`"config"`, `"plugin"`, or `"none"`). */
-    hookSystem: HookSystemType;
-    /** Filesystem path template to the provider's hook configuration file, or `null`. */
-    hookConfigPath: string | null;
-    /** The configuration format used for hooks (e.g. `"json"`, `"yaml"`), or `null`. */
-    hookFormat: string | null;
-    /** The handler execution mechanisms this provider supports. */
-    handlerTypes: HookHandlerType[];
-    /** Whether the provider's hook system is considered experimental or unstable. */
-    experimental: boolean;
-    /** Mapping of every canonical event to this provider's native representation. */
-    mappings: Record<CanonicalHookEvent, HookMapping>;
-    /** Native event names that exist only in this provider with no canonical equivalent. */
-    providerOnlyEvents: string[];
-}
-/**
- * A fully resolved hook event with both canonical and native names.
- *
- * @remarks
- * Returned by batch translation functions. Contains all the context needed
- * to register or invoke a hook handler: the canonical name for CAAMP logic,
- * the native name for provider-specific calls, and metadata about category
- * and blocking behavior.
- *
- * @public
- */
-interface NormalizedHookEvent {
-    /** The CAAMP canonical event name. */
-    canonical: CanonicalHookEvent;
-    /** The provider-native event name. */
-    native: string;
-    /** The provider this event was resolved for. */
-    providerId: string;
-    /** The lifecycle category of this event. */
-    category: HookCategory;
-    /** Whether a handler for this event can block the associated action. */
-    canBlock: boolean;
-}
-/**
- * Result of querying whether a provider supports a specific canonical event.
- *
- * @remarks
- * Returned by `getHookSupport()`. Includes the native name translation
- * and any notes about support limitations. When `supported` is `false`,
- * `native` will be `null`.
- *
- * @public
- */
-interface HookSupportResult {
-    /** The canonical event that was queried. */
-    canonical: CanonicalHookEvent;
-    /** Whether the provider supports this event. */
-    supported: boolean;
-    /** The provider-native event name, or `null` if unsupported. */
-    native: string | null;
-    /**
-     * Optional notes about support caveats.
-     *
-     * @defaultValue `undefined`
-     */
-    notes?: string;
-}
-/**
- * Aggregated hook support summary for a single provider.
- *
- * @remarks
- * Provides a high-level view of a provider's hook capabilities including
- * counts, coverage percentage, and lists of supported/unsupported events.
- * Useful for CLI display and provider comparison features.
- *
- * @public
- */
-interface ProviderHookSummary {
-    /** The provider identifier. */
-    providerId: string;
-    /** The type of hook system the provider uses. */
-    hookSystem: HookSystemType;
-    /** Whether the provider's hook system is experimental. */
-    experimental: boolean;
-    /** Number of canonical events this provider supports. */
-    supportedCount: number;
-    /** Total number of canonical events in the taxonomy. */
-    totalCanonical: number;
-    /** List of canonical events this provider supports. */
-    supported: CanonicalHookEvent[];
-    /** List of canonical events this provider does not support. */
-    unsupported: CanonicalHookEvent[];
-    /** Native events unique to this provider with no canonical mapping. */
-    providerOnly: string[];
-    /** Percentage of canonical events supported (0-100). */
-    coverage: number;
-}
-/**
- * Cross-provider hook support matrix comparing multiple providers.
- *
- * @remarks
- * Built by `buildHookMatrix()`. Provides a two-dimensional view of which
- * canonical events are supported by which providers, with native name
- * translations. Used to render comparison tables in the CLI.
- *
- * @public
- */
-interface CrossProviderMatrix {
-    /** The canonical events included in this matrix (rows). */
-    events: CanonicalHookEvent[];
-    /** The provider IDs included in this matrix (columns). */
-    providers: string[];
-    /** Nested record mapping each canonical event to each provider's hook mapping. */
-    matrix: Record<CanonicalHookEvent, Record<string, HookMapping>>;
-}
-
-/**
- * CAAMP Hooks Normalizer
- *
- * Translates between CAAMP canonical hook events and provider-native
- * event names. Provides query functions for hook support, cross-provider
- * comparison, and event normalization.
- *
- * This module follows the same pattern as `src/core/mcp/transforms.ts` —
- * a translation layer that lets consumers use one canonical interface
- * while CAAMP handles provider-specific differences.
- */
-
-/**
- * Get the canonical event definition (category, description, canBlock).
- *
- * @remarks
- * Looks up the definition from the hook mappings data file. The returned
- * object contains the event's category, human-readable description, and
- * whether handlers can block the associated action.
- *
- * @param event - The canonical event name to look up.
- * @returns The event definition containing category, description, and canBlock flag.
- *
- * @example
- * ```typescript
- * import { getCanonicalEvent } from "./normalizer.js";
- *
- * const def = getCanonicalEvent("PreToolUse");
- * console.log(def.category);  // "tool"
- * console.log(def.canBlock);  // true
- * ```
- *
- * @public
- */
-declare function getCanonicalEvent(event: CanonicalHookEvent): CanonicalEventDefinition;
-/**
- * Get all canonical event definitions.
- *
- * @remarks
- * Returns the complete map of canonical event names to their definitions.
- * Useful for iterating over the full taxonomy or building UI displays
- * of all available events.
- *
- * @returns A record mapping every canonical event name to its definition.
- *
- * @example
- * ```typescript
- * import { getAllCanonicalEvents } from "./normalizer.js";
- *
- * const events = getAllCanonicalEvents();
- * for (const [name, def] of Object.entries(events)) {
- *   console.log(`${name}: ${def.description}`);
- * }
- * ```
- *
- * @public
- */
-declare function getAllCanonicalEvents(): Record<CanonicalHookEvent, CanonicalEventDefinition>;
-/**
- * Get canonical events filtered by category.
- *
- * @remarks
- * Filters the canonical event list to only those belonging to the specified
- * category. Useful for displaying events grouped by lifecycle phase
- * (e.g. all `"tool"` events or all `"session"` events).
- *
- * @param category - The hook category to filter by (e.g. `"session"`, `"tool"`).
- * @returns Array of canonical event names that belong to the specified category.
- *
- * @example
- * ```typescript
- * import { getCanonicalEventsByCategory } from "./normalizer.js";
- *
- * const toolEvents = getCanonicalEventsByCategory("tool");
- * // ["PreToolUse", "PostToolUse", "PostToolUseFailure"]
- * ```
- *
- * @public
- */
-declare function getCanonicalEventsByCategory(category: HookCategory): CanonicalHookEvent[];
-/**
- * Get the full hook profile for a provider.
- *
- * @remarks
- * Returns the complete hook configuration for a provider including its
- * hook system type, config path, handler types, and all event mappings.
- * Returns `undefined` if the provider has no hook mappings defined.
- *
- * @param providerId - The provider identifier (e.g. `"claude-code"`, `"gemini-cli"`).
- * @returns The provider's hook profile, or `undefined` if not found.
- *
- * @example
- * ```typescript
- * import { getProviderHookProfile } from "./normalizer.js";
- *
- * const profile = getProviderHookProfile("claude-code");
- * if (profile) {
- *   console.log(profile.hookSystem); // "config"
- *   console.log(profile.experimental); // false
- * }
- * ```
- *
- * @public
- */
-declare function getProviderHookProfile(providerId: string): ProviderHookProfile | undefined;
-/**
- * Get all provider IDs that have hook mappings.
- *
- * @remarks
- * Returns the list of provider identifiers present in the hook mappings
- * data file. This reflects all providers for which CAAMP has hook
- * translation data, regardless of whether they support any events.
- *
- * @returns Array of provider ID strings.
- *
- * @example
- * ```typescript
- * import { getMappedProviderIds } from "./normalizer.js";
- *
- * const ids = getMappedProviderIds();
- * // ["claude-code", "gemini-cli", "cursor", "kimi", ...]
- * ```
- *
- * @public
- */
-declare function getMappedProviderIds(): string[];
-/**
- * Translate a CAAMP canonical event name to the provider's native name.
- *
- * @remarks
- * This is the primary forward-translation function. Given a canonical
- * event and a provider ID, it returns the provider-specific event name
- * that should be used when configuring hooks for that provider.
- * Returns `null` if the provider is unknown or does not support the event.
- *
- * @param canonical - The CAAMP canonical event name to translate.
- * @param providerId - The target provider identifier.
- * @returns The native event name, or `null` if unsupported.
- *
- * @example
- * ```typescript
- * import { toNative } from "./normalizer.js";
- *
- * toNative("PreToolUse", "claude-code");   // "PreToolUse"
- * toNative("PreToolUse", "gemini-cli");    // "BeforeTool"
- * toNative("PreToolUse", "cursor");        // "preToolUse"
- * toNative("PreToolUse", "kimi");          // null
- * ```
- *
- * @public
- */
-declare function toNative(canonical: CanonicalHookEvent, providerId: string): string | null;
-/**
- * Translate a provider-native event name to the CAAMP canonical name.
- *
- * @remarks
- * This is the reverse-translation function. Scans all event mappings
- * for the given provider to find a canonical match for the native name.
- * Returns `null` if no mapping is found or the provider is unknown.
- *
- * @param nativeName - The provider-native event name to look up.
- * @param providerId - The provider identifier to search within.
- * @returns The canonical event name, or `null` if no mapping exists.
- *
- * @example
- * ```typescript
- * import { toCanonical } from "./normalizer.js";
- *
- * toCanonical("BeforeTool", "gemini-cli");     // "PreToolUse"
- * toCanonical("stop", "cursor");               // "ResponseComplete"
- * toCanonical("UserPromptSubmit", "claude-code"); // "PromptSubmit"
- * ```
- *
- * @public
- */
-declare function toCanonical(nativeName: string, providerId: string): CanonicalHookEvent | null;
-/**
- * Batch-translate multiple canonical events to native names for a provider.
- *
- * @remarks
- * Translates an array of canonical events in a single call, returning
- * only the events that the provider actually supports. Each result
- * includes category and blocking metadata. Unsupported events are
- * silently excluded from the output.
- *
- * @param canonicals - Array of canonical event names to translate.
- * @param providerId - The target provider identifier.
- * @returns Array of normalized events (only supported ones included).
- *
- * @example
- * ```typescript
- * import { toNativeBatch } from "./normalizer.js";
- *
- * const events = toNativeBatch(
- *   ["PreToolUse", "PostToolUse", "ConfigChange"],
- *   "claude-code",
- * );
- * // Returns NormalizedHookEvent[] for supported events only
- * ```
- *
- * @public
- */
-declare function toNativeBatch(canonicals: CanonicalHookEvent[], providerId: string): NormalizedHookEvent[];
-/**
- * Check if a provider supports a specific canonical hook event.
- *
- * @remarks
- * A quick boolean check that avoids returning the full mapping details.
- * Returns `false` if the provider is unknown or the event is not supported.
- *
- * @param canonical - The canonical event name to check.
- * @param providerId - The provider identifier to check against.
- * @returns `true` if the provider supports this canonical event, `false` otherwise.
- *
- * @example
- * ```typescript
- * import { supportsHook } from "./normalizer.js";
- *
- * supportsHook("PreToolUse", "claude-code"); // true
- * supportsHook("PreToolUse", "kimi");        // false
- * ```
- *
- * @public
- */
-declare function supportsHook(canonical: CanonicalHookEvent, providerId: string): boolean;
-/**
- * Get full hook support details for a canonical event on a provider.
- *
- * @remarks
- * Returns a structured result with the native name translation and any
- * notes about support limitations. Unlike `supportsHook()`, this always
- * returns a result object even when the provider is unknown (with
- * `supported: false`).
- *
- * @param canonical - The canonical event name to query.
- * @param providerId - The provider identifier to query against.
- * @returns Support result including native name and optional notes.
- *
- * @example
- * ```typescript
- * import { getHookSupport } from "./normalizer.js";
- *
- * const result = getHookSupport("PreToolUse", "claude-code");
- * console.log(result.supported); // true
- * console.log(result.native);    // "PreToolUse"
- * ```
- *
- * @public
- */
-declare function getHookSupport(canonical: CanonicalHookEvent, providerId: string): HookSupportResult;
-/**
- * Get all supported canonical events for a provider.
- *
- * @remarks
- * Filters the full canonical event list to only those that the provider
- * supports. Returns an empty array if the provider is unknown.
- *
- * @param providerId - The provider identifier to query.
- * @returns Array of canonical event names the provider supports.
- *
- * @example
- * ```typescript
- * import { getSupportedEvents } from "./normalizer.js";
- *
- * const events = getSupportedEvents("claude-code");
- * // ["SessionStart", "SessionEnd", "PreToolUse", ...]
- * ```
- *
- * @public
- */
-declare function getSupportedEvents(providerId: string): CanonicalHookEvent[];
-/**
- * Get all unsupported canonical events for a provider.
- *
- * @remarks
- * Returns the complement of `getSupportedEvents()`. If the provider is
- * unknown, all canonical events are returned since none are supported.
- *
- * @param providerId - The provider identifier to query.
- * @returns Array of canonical event names the provider does not support.
- *
- * @example
- * ```typescript
- * import { getUnsupportedEvents } from "./normalizer.js";
- *
- * const missing = getUnsupportedEvents("kimi");
- * // Returns all canonical events (kimi has no hook support)
- * ```
- *
- * @public
- */
-declare function getUnsupportedEvents(providerId: string): CanonicalHookEvent[];
-/**
- * Get providers that support a specific canonical event.
- *
- * @remarks
- * Scans all provider mappings and returns the IDs of those that support
- * the given canonical event. Useful for determining which providers can
- * be targeted when configuring a specific hook.
- *
- * @param canonical - The canonical event name to search for.
- * @returns Array of provider IDs that support this event.
- *
- * @example
- * ```typescript
- * import { getProvidersForEvent } from "./normalizer.js";
- *
- * const providers = getProvidersForEvent("PreToolUse");
- * // ["claude-code", "gemini-cli", "cursor"]
- * ```
- *
- * @public
- */
-declare function getProvidersForEvent(canonical: CanonicalHookEvent): string[];
-/**
- * Get canonical events common to all specified providers.
- *
- * @remarks
- * Computes the intersection of supported events across multiple providers.
- * Returns only events that every listed provider supports. Useful for
- * determining which hooks can be configured uniformly across a set of
- * target providers.
- *
- * @param providerIds - Array of provider IDs to intersect.
- * @returns Array of canonical events supported by all specified providers.
- *
- * @example
- * ```typescript
- * import { getCommonEvents } from "./normalizer.js";
- *
- * const common = getCommonEvents(["claude-code", "gemini-cli"]);
- * // Returns only events both providers support
- * ```
- *
- * @public
- */
-declare function getCommonEvents(providerIds: string[]): CanonicalHookEvent[];
-/**
- * Get a summary of hook support for a provider.
- *
- * @remarks
- * Builds an aggregated view of a provider's hook capabilities including
- * counts, coverage percentage, and categorized event lists. Returns
- * `undefined` if the provider has no hook mappings. Used by the CLI
- * `hooks show` command for provider overviews.
- *
- * @param providerId - The provider identifier to summarize.
- * @returns The hook support summary, or `undefined` if the provider is not found.
- *
- * @example
- * ```typescript
- * import { getProviderSummary } from "./normalizer.js";
- *
- * const summary = getProviderSummary("claude-code");
- * if (summary) {
- *   console.log(`${summary.coverage}% coverage`);
- *   console.log(`${summary.supportedCount}/${summary.totalCanonical} events`);
- * }
- * ```
- *
- * @public
- */
-declare function getProviderSummary(providerId: string): ProviderHookSummary | undefined;
-/**
- * Build a cross-provider hook support matrix.
- *
- * @remarks
- * Constructs a two-dimensional matrix showing which canonical events are
- * supported by which providers, with native name translations. When no
- * provider IDs are specified, all mapped providers are included. Used by
- * the CLI `hooks matrix` command for comparison tables.
- *
- * @param providerIds - Optional array of provider IDs to include. Defaults to all mapped providers.
- * @returns The cross-provider matrix with events, providers, and mapping data.
- *
- * @example
- * ```typescript
- * import { buildHookMatrix } from "./normalizer.js";
- *
- * const matrix = buildHookMatrix(["claude-code", "gemini-cli"]);
- * for (const event of matrix.events) {
- *   for (const provider of matrix.providers) {
- *     console.log(`${event} @ ${provider}: ${matrix.matrix[event][provider].supported}`);
- *   }
- * }
- * ```
- *
- * @public
- */
-declare function buildHookMatrix(providerIds?: string[]): CrossProviderMatrix;
-/**
- * Get the hook system type for a provider.
- *
- * @remarks
- * Returns the provider's hook system type: `"config"` for file-based hooks,
- * `"plugin"` for extension-based hooks, or `"none"` if the provider does
- * not support hooks. Returns `"none"` for unknown providers.
- *
- * @param providerId - The provider identifier to query.
- * @returns The hook system type (`"config"`, `"plugin"`, or `"none"`).
- *
- * @example
- * ```typescript
- * import { getHookSystemType } from "./normalizer.js";
- *
- * getHookSystemType("claude-code"); // "config"
- * getHookSystemType("unknown");     // "none"
- * ```
- *
- * @public
- */
-declare function getHookSystemType(providerId: string): HookSystemType;
-/**
- * Get the resolved hook config path for a provider.
- *
- * @remarks
- * Resolves the provider's hook configuration file path by expanding
- * registry template variables (e.g. `~` to the home directory). Returns
- * `null` if the provider has no hook config path defined or is unknown.
- *
- * @param providerId - The provider identifier to query.
- * @returns The resolved filesystem path, or `null` if not available.
- *
- * @example
- * ```typescript
- * import { getHookConfigPath } from "./normalizer.js";
- *
- * const path = getHookConfigPath("claude-code");
- * // "/home/user/.claude/settings.json" (resolved from template)
- * ```
- *
- * @public
- */
-declare function getHookConfigPath(providerId: string): string | null;
-/**
- * Get provider-only events (native events with no canonical mapping).
- *
- * @remarks
- * Some providers define hook events that have no equivalent in the CAAMP
- * canonical taxonomy. This function returns those provider-specific event
- * names. Returns an empty array for unknown providers.
- *
- * @param providerId - The provider identifier to query.
- * @returns Array of native event names unique to this provider.
- *
- * @example
- * ```typescript
- * import { getProviderOnlyEvents } from "./normalizer.js";
- *
- * const extras = getProviderOnlyEvents("claude-code");
- * // Returns any events specific to Claude Code with no canonical equivalent
- * ```
- *
- * @public
- */
-declare function getProviderOnlyEvents(providerId: string): string[];
-/**
- * Translate a canonical event to native names across multiple providers.
- *
- * @remarks
- * Performs a fan-out translation of a single canonical event to all
- * specified providers simultaneously. The result record only includes
- * providers that actually support the event — unsupported providers
- * are silently excluded.
- *
- * @param canonical - The canonical event name to translate.
- * @param providerIds - Array of provider IDs to translate for.
- * @returns Record mapping provider IDs to their native event names (supported only).
- *
- * @example
- * ```typescript
- * import { translateToAll } from "./normalizer.js";
- *
- * const result = translateToAll("PreToolUse", ["claude-code", "gemini-cli", "kimi"]);
- * // { "claude-code": "PreToolUse", "gemini-cli": "BeforeTool" }
- * // (kimi excluded — unsupported)
- * ```
- *
- * @public
- */
-declare function translateToAll(canonical: CanonicalHookEvent, providerIds: string[]): Record<string, string>;
-/**
- * Find the best canonical match for a native event name across all providers.
- *
- * @remarks
- * Scans every provider's mappings to find canonical events that match the
- * given native name. Useful when you have a native name but do not know
- * which provider it belongs to. Multiple results are possible if different
- * providers use the same native name for different canonical events.
- *
- * @param nativeName - The provider-native event name to resolve.
- * @returns Array of matches, each containing the provider ID and canonical event name.
- *
- * @example
- * ```typescript
- * import { resolveNativeEvent } from "./normalizer.js";
- *
- * const matches = resolveNativeEvent("BeforeTool");
- * // [{ providerId: "gemini-cli", canonical: "PreToolUse" }]
- * ```
- *
- * @public
- */
-declare function resolveNativeEvent(nativeName: string): Array<{
-    providerId: string;
-    canonical: CanonicalHookEvent;
-}>;
-/**
- * Get the version of the hook mappings data.
- *
- * @remarks
- * Returns the semver version string from the hook mappings JSON file.
- * This can be used to check compatibility or display the data version
- * in diagnostic output.
- *
- * @returns The semver version string of the loaded hook mappings data.
- *
- * @example
- * ```typescript
- * import { getHookMappingsVersion } from "./normalizer.js";
- *
- * const version = getHookMappingsVersion();
- * console.log(`Hook mappings v${version}`);
- * ```
- *
- * @public
- */
-declare function getHookMappingsVersion(): string;
-
 /**
  * Global provider instruction delivery — the ONE regenerator and its cheap
  * staleness check.
@@ -9946,4 +9035,4 @@ declare function parseSource(input: string): ParsedSource;
  */
 declare function isMarketplaceScoped(input: string): boolean;
 
-export { type AskToolStatus, type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type BlockInsertPosition, CANONICAL_HOOK_EVENTS, CLEO_ARTIFACT_BUDGETS, CLEO_ARTIFACT_REQUIREMENTS, type CaampBlock, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DedupeResult, type DetectionCacheOptions, type DetectionResult, EXCLUSIVITY_MODE_ENV_VAR, EmbeddedDeliveryDowngradeError, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type EnsureProviderRuleFileOptions, type EnsureProviderRuleFileResult, type ExclusivityMode, type FileLockOptions, type GatedSkillInstallOptions, type GatedSkillInstallResult, type GlobalInstructionOptions, type GlobalOptions, HITL_REQUEST_FALLBACK, HOOK_CATEGORIES, type Harness, type HarnessScope, type HitlRequestFallback, HomeInstructionFileError, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstallSkillOptions, type InstructionUpdateSummary, JsonConfigParseError, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizeResult, type NormalizedHookEvent, type NormalizedRecommendationCriteria, PROVIDER_ASK_TOOLS, type ParsedSource, PiHarness, PiRequiredError, type Provider, type ProviderAskTool, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type ReconcileResult, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type RepairResult, type ResolveDefaultTargetProvidersOptions, type ResolvedProviderAskTool, type ResolvedSkillSource, type SkillBatchOperation, type SkillEntry, type SkillGateModules, SkillInstallError, type SkillInstallErrorCode, type SkillInstallErrorDetails, type SkillInstallGateOptions, type SkillInstallGateReport, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillRowData, type SkillRowSourceType, type SkillSourceProgress, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type SyncGlobalInstructionsOptions, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetPlatformPathsCache, assertCleoShippedBuildShape, assertNotTornRead, blockPattern, buildBlock, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, catalogEntryFromManifest, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkGlobalInstructionStaleness, checkInjection, checkSkillIntegrity, checkSkillUpdate, classifyPackageFilesEntry, clearRegisteredLibrary, dedupeFile, dedupeFiles, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, ensureProviderRuleFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllHarnesses, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderAskTool, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderInstructionReferences, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedSkills, getUnsupportedEvents, groupByInstructFile, inferSkillSourceType, inject, injectAll, installBatchWithRollback, installMcpServer, installResolvedSkill, installSkill, installSkillFromSource, instructionFileCascade, isCaampOwnedSkill, isEmbeddedDelivery, isExclusivityMode, isHomeProject, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, mergeBlockBodies, normalizeMarkers, normalizeRecommendationCriteria, parseBlocks, parseCaampBlocks, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, reconcile, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, repairContent, repairInstructionFiles, replaceDirectoryFromSource, resetDetectionCache, resetExclusivityModeOverride, resetRegistry, resolveAlias, resolveDefaultTargetProviders, resolveGlobalInstructionPath, resolveInstructionDelivery, resolveMcpConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, resolveSkillSource, runSkillInstallGate, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, stageSkillCopy, supportsHook, swapIntoPlace, syncGlobalInstructions, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, updateJsonConfigFile, validateInstructionIntegrity, validatePackageArtifact, validateRecommendationCriteria, validateSkill, withFileLock, writeAgentFileToAllProviders, writeConfig };
+export { type AskToolStatus, type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type BlockInsertPosition, CLEO_ARTIFACT_BUDGETS, CLEO_ARTIFACT_REQUIREMENTS, type CaampBlock, type CaampLockFile, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DedupeResult, type DetectionCacheOptions, type DetectionResult, EXCLUSIVITY_MODE_ENV_VAR, EmbeddedDeliveryDowngradeError, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type EnsureProviderRuleFileOptions, type EnsureProviderRuleFileResult, type ExclusivityMode, type GatedSkillInstallOptions, type GatedSkillInstallResult, type GlobalInstructionOptions, type GlobalOptions, HITL_REQUEST_FALLBACK, type Harness, type HarnessScope, type HitlRequestFallback, HomeInstructionFileError, type HookEvent, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstallSkillOptions, type InstructionUpdateSummary, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizeResult, type NormalizedRecommendationCriteria, PROVIDER_ASK_TOOLS, type ParsedSource, PiHarness, PiRequiredError, type Provider, type ProviderAskTool, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type ReconcileResult, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type RepairResult, type ResolveDefaultTargetProvidersOptions, type ResolvedProviderAskTool, type ResolvedSkillSource, type SkillBatchOperation, type SkillEntry, type SkillGateModules, SkillInstallError, type SkillInstallErrorCode, type SkillInstallErrorDetails, type SkillInstallGateOptions, type SkillInstallGateReport, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillRowData, type SkillRowSourceType, type SkillSourceProgress, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type SyncGlobalInstructionsOptions, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetPlatformPathsCache, assertCleoShippedBuildShape, blockPattern, buildBlock, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, catalogEntryFromManifest, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkGlobalInstructionStaleness, checkInjection, checkSkillIntegrity, checkSkillUpdate, classifyPackageFilesEntry, clearRegisteredLibrary, dedupeFile, dedupeFiles, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, ensureProviderRuleFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllHarnesses, getAllProviders, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getInstalledProviders, getInstructionFiles, getLockFilePath, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderAskTool, getProviderCapabilities, getProviderCount, getProviderInstructionReferences, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getRegistryVersion, getSpawnCapableProviders, getSystemInfo, getTrackedSkills, groupByInstructFile, inferSkillSourceType, inject, injectAll, installBatchWithRollback, installMcpServer, installResolvedSkill, installSkill, installSkillFromSource, instructionFileCascade, isCaampOwnedSkill, isEmbeddedDelivery, isExclusivityMode, isHomeProject, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, mergeBlockBodies, normalizeMarkers, normalizeRecommendationCriteria, parseBlocks, parseCaampBlocks, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, reconcile, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, repairContent, repairInstructionFiles, replaceDirectoryFromSource, resetDetectionCache, resetExclusivityModeOverride, resetRegistry, resolveAlias, resolveDefaultTargetProviders, resolveGlobalInstructionPath, resolveInstructionDelivery, resolveMcpConfigPath, resolveProviderSkillsDirs, resolveRegistryTemplatePath, resolveSkillSource, runSkillInstallGate, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, stageSkillCopy, swapIntoPlace, syncGlobalInstructions, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateInstructionIntegrity, validatePackageArtifact, validateRecommendationCriteria, validateSkill, writeAgentFileToAllProviders, writeConfig };