@cleocode/caamp 1.8.0 → 1.9.0

package/dist/hooks-LV6VU7QJ.js

@@ -0,0 +1,56 @@
+import {
+  CANONICAL_HOOK_EVENTS,
+  HOOK_CATEGORIES,
+  buildHookMatrix,
+  getAllCanonicalEvents,
+  getCanonicalEvent,
+  getCanonicalEventsByCategory,
+  getCommonEvents,
+  getHookConfigPath,
+  getHookMappingsVersion,
+  getHookSupport,
+  getHookSystemType,
+  getMappedProviderIds,
+  getProviderHookProfile,
+  getProviderOnlyEvents,
+  getProviderSummary,
+  getProvidersForEvent,
+  getSupportedEvents,
+  getUnsupportedEvents,
+  resetHookMappings,
+  resolveNativeEvent,
+  supportsHook,
+  toCanonical,
+  toNative,
+  toNativeBatch,
+  translateToAll
+} from "./chunk-ER3FIOTM.js";
+import "./chunk-TRIXT4T7.js";
+export {
+  CANONICAL_HOOK_EVENTS,
+  HOOK_CATEGORIES,
+  buildHookMatrix,
+  getAllCanonicalEvents,
+  getCanonicalEvent,
+  getCanonicalEventsByCategory,
+  getCommonEvents,
+  getHookConfigPath,
+  getHookMappingsVersion,
+  getHookSupport,
+  getHookSystemType,
+  getMappedProviderIds,
+  getProviderHookProfile,
+  getProviderOnlyEvents,
+  getProviderSummary,
+  getProvidersForEvent,
+  getSupportedEvents,
+  getUnsupportedEvents,
+  resetHookMappings,
+  resolveNativeEvent,
+  supportsHook,
+  toCanonical,
+  toNative,
+  toNativeBatch,
+  translateToAll
+};
+//# sourceMappingURL=hooks-LV6VU7QJ.js.map

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 type SkillsPrecedence = "vendor-only" | "agents-canonical" | "agents-first" | "agents-supported" | "vendor-global-agents-project";
-type HookEvent = "onSessionStart" | "onSessionEnd" | "onToolStart" | "onToolComplete" | "onFileChange" | "onError" | "onPromptSubmit" | "onResponseComplete";
+/**
+ * @deprecated Use `CanonicalHookEvent` from `../hooks/types.js` for the
+ * normalized CAAMP taxonomy. This type remains for backward compatibility
+ * with registry.json's `capabilities.hooks.supported` string arrays.
+ */
+type HookEvent = string;
 type SpawnMechanism = "native" | "mcp" | "cli" | "api";
 
 /**
@@ -1446,7 +1451,7 @@ interface InstructionUpdateSummary {
     updatedFiles: number;
     actions: Array<{
         file: string;
-        action: "created" | "added" | "updated" | "intact";
+        action: "created" | "added" | "consolidated" | "updated" | "intact";
         providers: string[];
         configFormats: ConfigFormat[];
     }>;
@@ -1490,8 +1495,8 @@ interface DualScopeConfigureResult {
         project: InstallResult[];
     };
     instructions: {
-        global?: Map<string, "created" | "added" | "updated" | "intact">;
-        project?: Map<string, "created" | "added" | "updated" | "intact">;
+        global?: Map<string, "created" | "added" | "consolidated" | "updated" | "intact">;
+        project?: Map<string, "created" | "added" | "consolidated" | "updated" | "intact">;
     };
 }
 /**
@@ -2811,6 +2816,7 @@ declare function checkInjection(filePath: string, expectedContent?: string): Pro
  * Behavior depends on the file state:
  * - File does not exist: creates the file with the injection block → `"created"`
  * - File exists without markers: prepends the injection block → `"added"`
+ * - File exists with multiple markers (duplicates): consolidates into single block → `"consolidated"`
  * - File exists with markers, content differs: replaces the block → `"updated"`
  * - File exists with markers, content matches: no-op → `"intact"`
  *
@@ -2819,7 +2825,7 @@ declare function checkInjection(filePath: string, expectedContent?: string): Pro
  *
  * @param filePath - Absolute path to the instruction file
  * @param content - Content to inject between CAAMP markers
- * @returns Action taken: `"created"`, `"added"`, `"updated"`, or `"intact"`
+ * @returns Action taken: `"created"`, `"added"`, `"consolidated"`, `"updated"`, or `"intact"`
  *
  * @example
  * ```typescript
@@ -2827,7 +2833,7 @@ declare function checkInjection(filePath: string, expectedContent?: string): Pro
  * console.log(`File ${action}`); // "created" on first call, "intact" on subsequent
  * ```
  */
-declare function inject(filePath: string, content: string): Promise<"created" | "added" | "updated" | "intact">;
+declare function inject(filePath: string, content: string): Promise<"created" | "added" | "consolidated" | "updated" | "intact">;
 /**
  * Remove the CAAMP injection block from an instruction file.
  *
@@ -2870,7 +2876,7 @@ declare function checkAllInjections(providers: Provider[], projectDir: string, s
  * @param projectDir - Absolute path to the project directory
  * @param scope - Whether to target project or global instruction files
  * @param content - Content to inject between CAAMP markers
- * @returns Map of file path to action taken (`"created"`, `"added"`, `"updated"`, or `"intact"`)
+ * @returns Map of file path to action taken (`"created"`, `"added"`, `"consolidated"`, `"updated"`, or `"intact"`)
  *
  * @example
  * ```typescript
@@ -2880,7 +2886,7 @@ declare function checkAllInjections(providers: Provider[], projectDir: string, s
  * }
  * ```
  */
-declare function injectAll(providers: Provider[], projectDir: string, scope: "project" | "global", content: string): Promise<Map<string, "created" | "added" | "updated" | "intact">>;
+declare function injectAll(providers: Provider[], projectDir: string, scope: "project" | "global", content: string): Promise<Map<string, "created" | "added" | "consolidated" | "updated" | "intact">>;
 /**
  * Options for ensuring a provider instruction file.
  */
@@ -2901,7 +2907,7 @@ interface EnsureProviderInstructionFileResult {
     /** Instruction file name from the provider registry. */
     instructFile: string;
     /** Action taken. */
-    action: "created" | "added" | "updated" | "intact";
+    action: "created" | "added" | "consolidated" | "updated" | "intact";
     /** Provider ID. */
     providerId: string;
 }
@@ -2929,7 +2935,7 @@ interface EnsureProviderInstructionFileResult {
  *   references: ["@AGENTS.md"],
  * });
  * // result.filePath → "/project/CLAUDE.md"
- * // result.action → "created" | "added" | "updated" | "intact"
+   * // result.action → "created" | "added" | "consolidated" | "updated" | "intact"
  *
  * // Global scope:
  * const globalResult = await ensureProviderInstructionFile("claude-code", homedir(), {
@@ -3166,6 +3172,206 @@ declare function writeConfig(filePath: string, format: ConfigFormat, key: string
  */
 declare function removeConfig(filePath: string, format: ConfigFormat, key: string, serverName: string): Promise<boolean>;
 
+/**
+ * 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.
+ */
+declare const HOOK_CATEGORIES: readonly ["session", "prompt", "tool", "agent", "context"];
+type HookCategory = (typeof HOOK_CATEGORIES)[number];
+declare const CANONICAL_HOOK_EVENTS: readonly ["SessionStart", "SessionEnd", "PromptSubmit", "ResponseComplete", "PreToolUse", "PostToolUse", "PostToolUseFailure", "PermissionRequest", "SubagentStart", "SubagentStop", "PreModel", "PostModel", "PreCompact", "PostCompact", "Notification", "ConfigChange"];
+type CanonicalHookEvent = (typeof CANONICAL_HOOK_EVENTS)[number];
+interface CanonicalEventDefinition {
+    category: HookCategory;
+    description: string;
+    canBlock: boolean;
+}
+type HookSystemType = "config" | "plugin" | "none";
+type HookHandlerType = "command" | "http" | "prompt" | "agent" | "plugin";
+interface HookMapping {
+    nativeName: string | null;
+    supported: boolean;
+    notes?: string;
+}
+interface ProviderHookProfile {
+    hookSystem: HookSystemType;
+    hookConfigPath: string | null;
+    hookFormat: string | null;
+    handlerTypes: HookHandlerType[];
+    experimental: boolean;
+    mappings: Record<CanonicalHookEvent, HookMapping>;
+    providerOnlyEvents: string[];
+}
+interface NormalizedHookEvent {
+    canonical: CanonicalHookEvent;
+    native: string;
+    providerId: string;
+    category: HookCategory;
+    canBlock: boolean;
+}
+interface HookSupportResult {
+    canonical: CanonicalHookEvent;
+    supported: boolean;
+    native: string | null;
+    notes?: string;
+}
+interface ProviderHookSummary {
+    providerId: string;
+    hookSystem: HookSystemType;
+    experimental: boolean;
+    supportedCount: number;
+    totalCanonical: number;
+    supported: CanonicalHookEvent[];
+    unsupported: CanonicalHookEvent[];
+    providerOnly: string[];
+    coverage: number;
+}
+interface CrossProviderMatrix {
+    events: CanonicalHookEvent[];
+    providers: string[];
+    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).
+ */
+declare function getCanonicalEvent(event: CanonicalHookEvent): CanonicalEventDefinition;
+/**
+ * Get all canonical event definitions.
+ */
+declare function getAllCanonicalEvents(): Record<CanonicalHookEvent, CanonicalEventDefinition>;
+/**
+ * Get canonical events filtered by category.
+ */
+declare function getCanonicalEventsByCategory(category: HookCategory): CanonicalHookEvent[];
+/**
+ * Get the full hook profile for a provider.
+ */
+declare function getProviderHookProfile(providerId: string): ProviderHookProfile | undefined;
+/**
+ * Get all provider IDs that have hook mappings.
+ */
+declare function getMappedProviderIds(): string[];
+/**
+ * Translate a CAAMP canonical event name to the provider's native name.
+ *
+ * @returns The native event name, or `null` if unsupported
+ *
+ * @example
+ * ```typescript
+ * toNative("PreToolUse", "claude-code");   // "PreToolUse"
+ * toNative("PreToolUse", "gemini-cli");    // "BeforeTool"
+ * toNative("PreToolUse", "cursor");        // "preToolUse"
+ * toNative("PreToolUse", "kimi");          // null
+ * ```
+ */
+declare function toNative(canonical: CanonicalHookEvent, providerId: string): string | null;
+/**
+ * Translate a provider-native event name to the CAAMP canonical name.
+ *
+ * @returns The canonical event name, or `null` if no mapping exists
+ *
+ * @example
+ * ```typescript
+ * toCanonical("BeforeTool", "gemini-cli");     // "PreToolUse"
+ * toCanonical("stop", "cursor");               // "ResponseComplete"
+ * toCanonical("UserPromptSubmit", "claude-code"); // "PromptSubmit"
+ * ```
+ */
+declare function toCanonical(nativeName: string, providerId: string): CanonicalHookEvent | null;
+/**
+ * Batch-translate multiple canonical events to native names for a provider.
+ *
+ * @returns Array of normalized events (only supported ones included)
+ */
+declare function toNativeBatch(canonicals: CanonicalHookEvent[], providerId: string): NormalizedHookEvent[];
+/**
+ * Check if a provider supports a specific canonical hook event.
+ */
+declare function supportsHook(canonical: CanonicalHookEvent, providerId: string): boolean;
+/**
+ * Get full hook support details for a canonical event on a provider.
+ */
+declare function getHookSupport(canonical: CanonicalHookEvent, providerId: string): HookSupportResult;
+/**
+ * Get all supported canonical events for a provider.
+ */
+declare function getSupportedEvents(providerId: string): CanonicalHookEvent[];
+/**
+ * Get all unsupported canonical events for a provider.
+ */
+declare function getUnsupportedEvents(providerId: string): CanonicalHookEvent[];
+/**
+ * Get providers that support a specific canonical event.
+ */
+declare function getProvidersForEvent(canonical: CanonicalHookEvent): string[];
+/**
+ * Get canonical events common to all specified providers.
+ */
+declare function getCommonEvents(providerIds: string[]): CanonicalHookEvent[];
+/**
+ * Get a summary of hook support for a provider.
+ */
+declare function getProviderSummary(providerId: string): ProviderHookSummary | undefined;
+/**
+ * Build a cross-provider hook support matrix.
+ *
+ * Shows which canonical events are supported by which providers,
+ * with native name translations.
+ */
+declare function buildHookMatrix(providerIds?: string[]): CrossProviderMatrix;
+/**
+ * Get the hook system type for a provider.
+ */
+declare function getHookSystemType(providerId: string): HookSystemType;
+/**
+ * Get the resolved hook config path for a provider.
+ */
+declare function getHookConfigPath(providerId: string): string | null;
+/**
+ * Get provider-only events (native events with no canonical mapping).
+ */
+declare function getProviderOnlyEvents(providerId: string): string[];
+/**
+ * Translate a canonical event to native names across multiple providers.
+ * Returns only providers that support the event.
+ *
+ * @example
+ * ```typescript
+ * const result = translateToAll("PreToolUse", ["claude-code", "gemini-cli", "kimi"]);
+ * // { "claude-code": "PreToolUse", "gemini-cli": "BeforeTool" }
+ * // (kimi excluded — unsupported)
+ * ```
+ */
+declare function translateToAll(canonical: CanonicalHookEvent, providerIds: string[]): Record<string, string>;
+/**
+ * Find the best canonical match for a native event name across all providers.
+ * Useful when you have a native name but don't know which provider it's from.
+ */
+declare function resolveNativeEvent(nativeName: string): Array<{
+    providerId: string;
+    canonical: CanonicalHookEvent;
+}>;
+/**
+ * Get the version of the hook mappings data.
+ */
+declare function getHookMappingsVersion(): string;
+
 /**
  * Simple logger with verbose/quiet mode support.
  *
@@ -3225,4 +3431,4 @@ declare function isVerbose(): boolean;
  */
 declare function isQuiet(): boolean;
 
-export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type CaampLockFile, type CleoChannel, type CleoProfileBuildResult, type ConfigFormat, type ConflictPolicy, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, type DetectionCacheOptions, type DetectionResult, type DualScopeConfigureOptions, type DualScopeConfigureResult, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type GlobalOptions, type HookEvent, type InferredLockData, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallResult, type InstructionUpdateSummary, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpBatchOperation, type McpConflict, type McpConflictCode, type McpPlanApplyResult, type McpServerConfig, type McpServerEntry, type NormalizedRecommendationCriteria, type ParsedSource, type PlatformPaths, type Provider, type ProviderCapabilities, type ProviderHooksCapability, 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 ReconcileOptions, type ReconcileResult, type SkillBatchOperation, type SkillEntry, 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 SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SystemInfo, type TransportType, type ValidationIssue, type ValidationResult, _resetPlatformPathsCache, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, extractVersionTag, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getCommonHookEvents, getEffectiveSkillsPaths, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getPlatformPaths, getProjectAgentsDir, getProvider, getProviderCapabilities, getProviderCount, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getRegistryVersion, getSpawnCapableProviders, getSystemInfo, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inferCleoLockData, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCaampOwnedSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, readLockFile, recommendSkills, reconcileCleoLock, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveProviderSkillsDirs, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, shouldOverrideSkill, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeConfig };
+export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, CANONICAL_HOOK_EVENTS, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CleoChannel, type CleoProfileBuildResult, type ConfigFormat, type ConflictPolicy, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, type DetectionCacheOptions, type DetectionResult, type DualScopeConfigureOptions, type DualScopeConfigureResult, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type GlobalOptions, HOOK_CATEGORIES, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InferredLockData, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallResult, type InstructionUpdateSummary, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpBatchOperation, type McpConflict, type McpConflictCode, type McpPlanApplyResult, type McpServerConfig, type McpServerEntry, type NormalizedHookEvent, type NormalizedRecommendationCriteria, type ParsedSource, type PlatformPaths, type Provider, type ProviderCapabilities, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, 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 ReconcileOptions, type ReconcileResult, type SkillBatchOperation, type SkillEntry, 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 SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SystemInfo, type TransportType, type ValidationIssue, type ValidationResult, _resetPlatformPathsCache, applyMcpInstallWithPolicy, buildCleoProfile, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, extractVersionTag, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCanonicalSkillsDir, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getProjectAgentsDir, getProvider, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedMcpServers, getTrackedSkills, getTransform, getUnsupportedEvents, groupByInstructFile, inferCleoLockData, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCaampOwnedSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, readLockFile, recommendSkills, reconcileCleoLock, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, shouldOverrideSkill, supportsHook, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeConfig };

package/dist/index.js

@@ -78,9 +78,8 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-YWO4I7LI.js";
+} from "./chunk-OLJZ23W3.js";
 import {
-  _resetPlatformPathsCache,
   buildInjectionContent,
   buildSkillsMap,
   checkAllInjections,
@@ -89,23 +88,10 @@ import {
   ensureProviderInstructionFile,
   generateInjectionContent,
   generateSkillsSection,
-  getAgentsConfigPath,
-  getAgentsHome,
-  getAgentsInstructFile,
-  getAgentsLinksDir,
-  getAgentsMcpDir,
-  getAgentsMcpServersPath,
-  getAgentsSpecDir,
-  getAgentsWikiDir,
   getAllProviders,
-  getCanonicalSkillsDir,
   getCommonHookEvents,
   getEffectiveSkillsPaths,
   getInstructionFiles,
-  getLockFilePath,
-  getPlatformLocations,
-  getPlatformPaths,
-  getProjectAgentsDir,
   getProvider,
   getProviderCapabilities,
   getProviderCount,
@@ -117,7 +103,6 @@ import {
   getProvidersByStatus,
   getRegistryVersion,
   getSpawnCapableProviders,
-  getSystemInfo,
   groupByInstructFile,
   inject,
   injectAll,
@@ -125,10 +110,53 @@ import {
   providerSupports,
   providerSupportsById,
   removeInjection,
-  resolveAlias,
+  resolveAlias
+} from "./chunk-MFWBR2NY.js";
+import {
+  CANONICAL_HOOK_EVENTS,
+  HOOK_CATEGORIES,
+  buildHookMatrix,
+  getAllCanonicalEvents,
+  getCanonicalEvent,
+  getCanonicalEventsByCategory,
+  getCommonEvents,
+  getHookConfigPath,
+  getHookMappingsVersion,
+  getHookSupport,
+  getHookSystemType,
+  getMappedProviderIds,
+  getProviderHookProfile,
+  getProviderOnlyEvents,
+  getProviderSummary,
+  getProvidersForEvent,
+  getSupportedEvents,
+  getUnsupportedEvents,
+  resolveNativeEvent,
+  supportsHook,
+  toCanonical,
+  toNative,
+  toNativeBatch,
+  translateToAll
+} from "./chunk-ER3FIOTM.js";
+import {
+  _resetPlatformPathsCache,
+  getAgentsConfigPath,
+  getAgentsHome,
+  getAgentsInstructFile,
+  getAgentsLinksDir,
+  getAgentsMcpDir,
+  getAgentsMcpServersPath,
+  getAgentsSpecDir,
+  getAgentsWikiDir,
+  getCanonicalSkillsDir,
+  getLockFilePath,
+  getPlatformLocations,
+  getPlatformPaths,
+  getProjectAgentsDir,
+  getSystemInfo,
   resolveProviderSkillsDirs,
   resolveRegistryTemplatePath
-} from "./chunk-ZVRDBY6L.js";
+} from "./chunk-TRIXT4T7.js";
 
 // src/core/skills/integrity.ts
 import { existsSync, lstatSync, readlinkSync } from "fs";
@@ -246,7 +274,7 @@ function shouldOverrideSkill(skillName, incomingSource, existingEntry) {
   return true;
 }
 async function validateInstructionIntegrity(providers, projectDir, scope, expectedContent) {
-  const { checkAllInjections: checkAllInjections2 } = await import("./injector-XGI7NNZA.js");
+  const { checkAllInjections: checkAllInjections2 } = await import("./injector-P2OL6RK3.js");
   const results = await checkAllInjections2(providers, projectDir, scope, expectedContent);
   const issues = [];
   for (const result of results) {
@@ -273,11 +301,14 @@ async function validateInstructionIntegrity(providers, projectDir, scope, expect
   return issues;
 }
 export {
+  CANONICAL_HOOK_EVENTS,
+  HOOK_CATEGORIES,
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
   _resetPlatformPathsCache,
   applyMcpInstallWithPolicy,
   buildCleoProfile,
+  buildHookMatrix,
   buildInjectionContent,
   buildLibraryFromFiles,
   buildServerConfig,
@@ -314,14 +345,23 @@ export {
   getAgentsMcpServersPath,
   getAgentsSpecDir,
   getAgentsWikiDir,
+  getAllCanonicalEvents,
   getAllProviders,
+  getCanonicalEvent,
+  getCanonicalEventsByCategory,
   getCanonicalSkillsDir,
+  getCommonEvents,
   getCommonHookEvents,
   getEffectiveSkillsPaths,
+  getHookConfigPath,
+  getHookMappingsVersion,
+  getHookSupport,
+  getHookSystemType,
   getInstalledProviders,
   getInstructionFiles,
   getLastSelectedAgents,
   getLockFilePath,
+  getMappedProviderIds,
   getNestedValue,
   getPlatformLocations,
   getPlatformPaths,
@@ -329,18 +369,24 @@ export {
   getProvider,
   getProviderCapabilities,
   getProviderCount,
+  getProviderHookProfile,
+  getProviderOnlyEvents,
+  getProviderSummary,
   getProvidersByHookEvent,
   getProvidersByInstructFile,
   getProvidersByPriority,
   getProvidersBySkillsPrecedence,
   getProvidersBySpawnCapability,
   getProvidersByStatus,
+  getProvidersForEvent,
   getRegistryVersion,
   getSpawnCapableProviders,
+  getSupportedEvents,
   getSystemInfo,
   getTrackedMcpServers,
   getTrackedSkills,
   getTransform,
+  getUnsupportedEvents,
   groupByInstructFile,
   inferCleoLockData,
   inject,
@@ -387,6 +433,7 @@ export {
   resolveChannelFromServerName,
   resolveCleoServerName,
   resolveConfigPath,
+  resolveNativeEvent,
   resolveProviderSkillsDirs,
   resolveRegistryTemplatePath,
   saveLastSelectedAgents,
@@ -398,8 +445,13 @@ export {
   setQuiet,
   setVerbose,
   shouldOverrideSkill,
+  supportsHook,
+  toCanonical,
+  toNative,
+  toNativeBatch,
   toSarif,
   tokenizeCriteriaValue,
+  translateToAll,
   updateInstructionsSingleOperation,
   validateInstructionIntegrity,
   validateRecommendationCriteria,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/skills/integrity.ts"],"sourcesContent":["/**\n * Skill integrity checking\n *\n * Validates that installed skills have intact symlinks, correct canonical paths,\n * and enforces ct-* prefix priority for CAAMP-shipped skills.\n */\n\nimport { existsSync, lstatSync, readlinkSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { LockEntry, Provider } from \"../../types.js\";\nimport { getCanonicalSkillsDir, resolveProviderSkillsDirs } from \"../paths/standard.js\";\nimport { readLockFile, updateLockFile } from \"../lock-utils.js\";\n\n/** CAAMP-reserved skill prefix. Skills with this prefix are owned by CAAMP. */\nconst CAAMP_SKILL_PREFIX = \"ct-\";\n\n/**\n * Status of a single skill's integrity check.\n */\nexport type SkillIntegrityStatus =\n  | \"intact\"\n  | \"broken-symlink\"\n  | \"missing-canonical\"\n  | \"missing-link\"\n  | \"not-tracked\"\n  | \"tampered\";\n\n/**\n * Result of checking a single skill's integrity.\n */\nexport interface SkillIntegrityResult {\n  /** Skill name. */\n  name: string;\n  /** Overall integrity status. */\n  status: SkillIntegrityStatus;\n  /** Whether the canonical directory exists. */\n  canonicalExists: boolean;\n  /** Expected canonical path from lock file. */\n  canonicalPath: string | null;\n  /** Provider link statuses — which agents have valid symlinks. */\n  linkStatuses: Array<{\n    providerId: string;\n    linkPath: string;\n    exists: boolean;\n    isSymlink: boolean;\n    pointsToCanonical: boolean;\n  }>;\n  /** Whether this is a CAAMP-reserved (ct-*) skill. */\n  isCaampOwned: boolean;\n  /** Human-readable issue description, if any. */\n  issue?: string;\n}\n\n/**\n * Check whether a skill name is reserved by CAAMP (ct-* prefix).\n *\n * @param skillName - Skill name to check\n * @returns `true` if the skill name starts with `ct-`\n */\nexport function isCaampOwnedSkill(skillName: string): boolean {\n  return skillName.startsWith(CAAMP_SKILL_PREFIX);\n}\n\n/**\n * Check the integrity of a single installed skill.\n *\n * Validates:\n * - Canonical directory exists on disk\n * - Lock file entry matches actual state\n * - Symlinks from provider skill directories point to the canonical path\n *\n * @param skillName - Name of the skill to check\n * @param providers - Providers to check symlinks for\n * @param scope - Whether to check global or project links\n * @param projectDir - Project directory (for project scope)\n * @returns Integrity check result\n */\nexport async function checkSkillIntegrity(\n  skillName: string,\n  providers: Provider[],\n  scope: \"global\" | \"project\" = \"global\",\n  projectDir?: string,\n): Promise<SkillIntegrityResult> {\n  const lock = await readLockFile();\n  const entry = lock.skills[skillName];\n  const isCaampOwned = isCaampOwnedSkill(skillName);\n\n  // Not tracked in lock file\n  if (!entry) {\n    const canonicalPath = join(getCanonicalSkillsDir(), skillName);\n    return {\n      name: skillName,\n      status: \"not-tracked\",\n      canonicalExists: existsSync(canonicalPath),\n      canonicalPath: null,\n      linkStatuses: [],\n      isCaampOwned,\n      issue: \"Skill is not tracked in the CAAMP lock file\",\n    };\n  }\n\n  const canonicalPath = entry.canonicalPath;\n  const canonicalExists = existsSync(canonicalPath);\n\n  // Check symlinks for each provider\n  const linkStatuses: SkillIntegrityResult[\"linkStatuses\"] = [];\n\n  for (const provider of providers) {\n    const targetDirs = resolveProviderSkillsDirs(provider, scope, projectDir);\n    for (const skillsDir of targetDirs) {\n      if (!skillsDir) continue;\n\n      const linkPath = join(skillsDir, skillName);\n      const exists = existsSync(linkPath);\n      let isSymlink = false;\n      let pointsToCanonical = false;\n\n      if (exists) {\n        try {\n          const stat = lstatSync(linkPath);\n          isSymlink = stat.isSymbolicLink();\n          if (isSymlink) {\n            const target = resolve(readlinkSync(linkPath));\n            pointsToCanonical = target === resolve(canonicalPath);\n          }\n        } catch {\n          // Can't stat — treat as broken\n        }\n      }\n\n      linkStatuses.push({\n        providerId: provider.id,\n        linkPath,\n        exists,\n        isSymlink,\n        pointsToCanonical,\n      });\n    }\n  }\n\n  // Determine overall status\n  if (!canonicalExists) {\n    return {\n      name: skillName,\n      status: \"missing-canonical\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `Canonical directory missing: ${canonicalPath}`,\n    };\n  }\n\n  const brokenLinks = linkStatuses.filter((l) => !l.exists);\n  const tamperedLinks = linkStatuses.filter((l) => l.exists && !l.pointsToCanonical);\n\n  if (tamperedLinks.length > 0) {\n    return {\n      name: skillName,\n      status: \"tampered\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `${tamperedLinks.length} link(s) do not point to canonical path`,\n    };\n  }\n\n  if (brokenLinks.length > 0) {\n    return {\n      name: skillName,\n      status: \"broken-symlink\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `${brokenLinks.length} symlink(s) missing`,\n    };\n  }\n\n  return {\n    name: skillName,\n    status: \"intact\",\n    canonicalExists,\n    canonicalPath,\n    linkStatuses,\n    isCaampOwned,\n  };\n}\n\n/**\n * Check integrity of all tracked skills.\n *\n * @param providers - Providers to check symlinks for\n * @param scope - Whether to check global or project links\n * @param projectDir - Project directory (for project scope)\n * @returns Map of skill name to integrity result\n */\nexport async function checkAllSkillIntegrity(\n  providers: Provider[],\n  scope: \"global\" | \"project\" = \"global\",\n  projectDir?: string,\n): Promise<Map<string, SkillIntegrityResult>> {\n  const lock = await readLockFile();\n  const results = new Map<string, SkillIntegrityResult>();\n\n  for (const skillName of Object.keys(lock.skills)) {\n    const result = await checkSkillIntegrity(skillName, providers, scope, projectDir);\n    results.set(skillName, result);\n  }\n\n  return results;\n}\n\n/**\n * Resolve a skill name conflict where a user-installed skill collides\n * with a CAAMP-owned (ct-*) skill.\n *\n * CAAMP-owned skills always win. Returns `true` if the incoming skill\n * should take precedence over the existing installation.\n *\n * @param skillName - Skill name to check\n * @param incomingSource - Source of the incoming skill installation\n * @param existingEntry - Existing lock entry, if any\n * @returns `true` if the incoming installation should proceed\n */\nexport function shouldOverrideSkill(\n  skillName: string,\n  incomingSource: string,\n  existingEntry: LockEntry | undefined,\n): boolean {\n  // No existing entry — always allow\n  if (!existingEntry) return true;\n\n  // For ct-* skills, CAAMP package source always wins\n  if (isCaampOwnedSkill(skillName)) {\n    // If incoming is from CAAMP package (library source), it always wins\n    if (existingEntry.sourceType === \"library\") return true;\n    // If existing is from CAAMP but incoming is user, CAAMP wins (block user)\n    return true;\n  }\n\n  // Non-ct-* skills: user always wins\n  return true;\n}\n\n/**\n * Validate instruction file injection status across all providers.\n *\n * Checks that CAAMP blocks exist and are current in all relevant\n * instruction files.\n *\n * @param providers - Providers to check\n * @param projectDir - Project directory\n * @param scope - Whether to check global or project files\n * @param expectedContent - Expected CAAMP block content\n * @returns Array of file paths with issues\n */\nexport async function validateInstructionIntegrity(\n  providers: Provider[],\n  projectDir: string,\n  scope: \"project\" | \"global\",\n  expectedContent?: string,\n): Promise<Array<{ file: string; providerId: string; issue: string }>> {\n  const { checkAllInjections } = await import(\"../instructions/injector.js\");\n  const results = await checkAllInjections(providers, projectDir, scope, expectedContent);\n  const issues: Array<{ file: string; providerId: string; issue: string }> = [];\n\n  for (const result of results) {\n    if (result.status === \"missing\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"Instruction file does not exist\",\n      });\n    } else if (result.status === \"none\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"No CAAMP injection block found\",\n      });\n    } else if (result.status === \"outdated\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"CAAMP injection block is outdated\",\n      });\n    }\n  }\n\n  return issues;\n}\n"],"mappings":"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","names":["canonicalPath","checkAllInjections"]}
+{"version":3,"sources":["../src/core/skills/integrity.ts"],"sourcesContent":["/**\n * Skill integrity checking\n *\n * Validates that installed skills have intact symlinks, correct canonical paths,\n * and enforces ct-* prefix priority for CAAMP-shipped skills.\n */\n\nimport { existsSync, lstatSync, readlinkSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { LockEntry, Provider } from \"../../types.js\";\nimport { getCanonicalSkillsDir, resolveProviderSkillsDirs } from \"../paths/standard.js\";\nimport { readLockFile, updateLockFile } from \"../lock-utils.js\";\n\n/** CAAMP-reserved skill prefix. Skills with this prefix are owned by CAAMP. */\nconst CAAMP_SKILL_PREFIX = \"ct-\";\n\n/**\n * Status of a single skill's integrity check.\n */\nexport type SkillIntegrityStatus =\n  | \"intact\"\n  | \"broken-symlink\"\n  | \"missing-canonical\"\n  | \"missing-link\"\n  | \"not-tracked\"\n  | \"tampered\";\n\n/**\n * Result of checking a single skill's integrity.\n */\nexport interface SkillIntegrityResult {\n  /** Skill name. */\n  name: string;\n  /** Overall integrity status. */\n  status: SkillIntegrityStatus;\n  /** Whether the canonical directory exists. */\n  canonicalExists: boolean;\n  /** Expected canonical path from lock file. */\n  canonicalPath: string | null;\n  /** Provider link statuses — which agents have valid symlinks. */\n  linkStatuses: Array<{\n    providerId: string;\n    linkPath: string;\n    exists: boolean;\n    isSymlink: boolean;\n    pointsToCanonical: boolean;\n  }>;\n  /** Whether this is a CAAMP-reserved (ct-*) skill. */\n  isCaampOwned: boolean;\n  /** Human-readable issue description, if any. */\n  issue?: string;\n}\n\n/**\n * Check whether a skill name is reserved by CAAMP (ct-* prefix).\n *\n * @param skillName - Skill name to check\n * @returns `true` if the skill name starts with `ct-`\n */\nexport function isCaampOwnedSkill(skillName: string): boolean {\n  return skillName.startsWith(CAAMP_SKILL_PREFIX);\n}\n\n/**\n * Check the integrity of a single installed skill.\n *\n * Validates:\n * - Canonical directory exists on disk\n * - Lock file entry matches actual state\n * - Symlinks from provider skill directories point to the canonical path\n *\n * @param skillName - Name of the skill to check\n * @param providers - Providers to check symlinks for\n * @param scope - Whether to check global or project links\n * @param projectDir - Project directory (for project scope)\n * @returns Integrity check result\n */\nexport async function checkSkillIntegrity(\n  skillName: string,\n  providers: Provider[],\n  scope: \"global\" | \"project\" = \"global\",\n  projectDir?: string,\n): Promise<SkillIntegrityResult> {\n  const lock = await readLockFile();\n  const entry = lock.skills[skillName];\n  const isCaampOwned = isCaampOwnedSkill(skillName);\n\n  // Not tracked in lock file\n  if (!entry) {\n    const canonicalPath = join(getCanonicalSkillsDir(), skillName);\n    return {\n      name: skillName,\n      status: \"not-tracked\",\n      canonicalExists: existsSync(canonicalPath),\n      canonicalPath: null,\n      linkStatuses: [],\n      isCaampOwned,\n      issue: \"Skill is not tracked in the CAAMP lock file\",\n    };\n  }\n\n  const canonicalPath = entry.canonicalPath;\n  const canonicalExists = existsSync(canonicalPath);\n\n  // Check symlinks for each provider\n  const linkStatuses: SkillIntegrityResult[\"linkStatuses\"] = [];\n\n  for (const provider of providers) {\n    const targetDirs = resolveProviderSkillsDirs(provider, scope, projectDir);\n    for (const skillsDir of targetDirs) {\n      if (!skillsDir) continue;\n\n      const linkPath = join(skillsDir, skillName);\n      const exists = existsSync(linkPath);\n      let isSymlink = false;\n      let pointsToCanonical = false;\n\n      if (exists) {\n        try {\n          const stat = lstatSync(linkPath);\n          isSymlink = stat.isSymbolicLink();\n          if (isSymlink) {\n            const target = resolve(readlinkSync(linkPath));\n            pointsToCanonical = target === resolve(canonicalPath);\n          }\n        } catch {\n          // Can't stat — treat as broken\n        }\n      }\n\n      linkStatuses.push({\n        providerId: provider.id,\n        linkPath,\n        exists,\n        isSymlink,\n        pointsToCanonical,\n      });\n    }\n  }\n\n  // Determine overall status\n  if (!canonicalExists) {\n    return {\n      name: skillName,\n      status: \"missing-canonical\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `Canonical directory missing: ${canonicalPath}`,\n    };\n  }\n\n  const brokenLinks = linkStatuses.filter((l) => !l.exists);\n  const tamperedLinks = linkStatuses.filter((l) => l.exists && !l.pointsToCanonical);\n\n  if (tamperedLinks.length > 0) {\n    return {\n      name: skillName,\n      status: \"tampered\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `${tamperedLinks.length} link(s) do not point to canonical path`,\n    };\n  }\n\n  if (brokenLinks.length > 0) {\n    return {\n      name: skillName,\n      status: \"broken-symlink\",\n      canonicalExists,\n      canonicalPath,\n      linkStatuses,\n      isCaampOwned,\n      issue: `${brokenLinks.length} symlink(s) missing`,\n    };\n  }\n\n  return {\n    name: skillName,\n    status: \"intact\",\n    canonicalExists,\n    canonicalPath,\n    linkStatuses,\n    isCaampOwned,\n  };\n}\n\n/**\n * Check integrity of all tracked skills.\n *\n * @param providers - Providers to check symlinks for\n * @param scope - Whether to check global or project links\n * @param projectDir - Project directory (for project scope)\n * @returns Map of skill name to integrity result\n */\nexport async function checkAllSkillIntegrity(\n  providers: Provider[],\n  scope: \"global\" | \"project\" = \"global\",\n  projectDir?: string,\n): Promise<Map<string, SkillIntegrityResult>> {\n  const lock = await readLockFile();\n  const results = new Map<string, SkillIntegrityResult>();\n\n  for (const skillName of Object.keys(lock.skills)) {\n    const result = await checkSkillIntegrity(skillName, providers, scope, projectDir);\n    results.set(skillName, result);\n  }\n\n  return results;\n}\n\n/**\n * Resolve a skill name conflict where a user-installed skill collides\n * with a CAAMP-owned (ct-*) skill.\n *\n * CAAMP-owned skills always win. Returns `true` if the incoming skill\n * should take precedence over the existing installation.\n *\n * @param skillName - Skill name to check\n * @param incomingSource - Source of the incoming skill installation\n * @param existingEntry - Existing lock entry, if any\n * @returns `true` if the incoming installation should proceed\n */\nexport function shouldOverrideSkill(\n  skillName: string,\n  incomingSource: string,\n  existingEntry: LockEntry | undefined,\n): boolean {\n  // No existing entry — always allow\n  if (!existingEntry) return true;\n\n  // For ct-* skills, CAAMP package source always wins\n  if (isCaampOwnedSkill(skillName)) {\n    // If incoming is from CAAMP package (library source), it always wins\n    if (existingEntry.sourceType === \"library\") return true;\n    // If existing is from CAAMP but incoming is user, CAAMP wins (block user)\n    return true;\n  }\n\n  // Non-ct-* skills: user always wins\n  return true;\n}\n\n/**\n * Validate instruction file injection status across all providers.\n *\n * Checks that CAAMP blocks exist and are current in all relevant\n * instruction files.\n *\n * @param providers - Providers to check\n * @param projectDir - Project directory\n * @param scope - Whether to check global or project files\n * @param expectedContent - Expected CAAMP block content\n * @returns Array of file paths with issues\n */\nexport async function validateInstructionIntegrity(\n  providers: Provider[],\n  projectDir: string,\n  scope: \"project\" | \"global\",\n  expectedContent?: string,\n): Promise<Array<{ file: string; providerId: string; issue: string }>> {\n  const { checkAllInjections } = await import(\"../instructions/injector.js\");\n  const results = await checkAllInjections(providers, projectDir, scope, expectedContent);\n  const issues: Array<{ file: string; providerId: string; issue: string }> = [];\n\n  for (const result of results) {\n    if (result.status === \"missing\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"Instruction file does not exist\",\n      });\n    } else if (result.status === \"none\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"No CAAMP injection block found\",\n      });\n    } else if (result.status === \"outdated\") {\n      issues.push({\n        file: result.file,\n        providerId: result.provider,\n        issue: \"CAAMP injection block is outdated\",\n      });\n    }\n  }\n\n  return issues;\n}\n"],"mappings":"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","names":["canonicalPath","checkAllInjections"]}

package/dist/{injector-XGI7NNZA.js → injector-P2OL6RK3.js}

@@ -6,7 +6,8 @@ import {
   inject,
   injectAll,
   removeInjection
-} from "./chunk-ZVRDBY6L.js";
+} from "./chunk-MFWBR2NY.js";
+import "./chunk-TRIXT4T7.js";
 export {
   checkAllInjections,
   checkInjection,
@@ -16,4 +17,4 @@ export {
   injectAll,
   removeInjection
 };
-//# sourceMappingURL=injector-XGI7NNZA.js.map
+//# sourceMappingURL=injector-P2OL6RK3.js.map

package/dist/injector-P2OL6RK3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}