@cleocode/caamp 1.3.1 → 1.5.0

package/dist/index.d.ts

@@ -1972,6 +1972,7 @@ declare function resolveChannelFromServerName(serverName: string): CleoChannel |
 declare function buildCleoProfile(options: CleoProfileBuildOptions): CleoProfileBuildResult;
 declare function checkCommandReachability(command: string): CommandReachability;
 declare function parseEnvAssignments(values: string[]): Record<string, string>;
+declare function extractVersionTag(packageSpec?: string): string | undefined;
 declare function isCleoSource(source: string): boolean;
 
 /**
@@ -2127,7 +2128,7 @@ declare function readLockFile(): Promise<CaampLockFile>;
  * await recordMcpInstall("filesystem", "@mcp/server-fs", "package", ["claude-code"], true);
  * ```
  */
-declare function recordMcpInstall(serverName: string, source: string, sourceType: SourceType, agents: string[], isGlobal: boolean): Promise<void>;
+declare function recordMcpInstall(serverName: string, source: string, sourceType: SourceType, agents: string[], isGlobal: boolean, version?: string): Promise<void>;
 /**
  * Remove an MCP server entry from the lock file.
  *
@@ -2180,6 +2181,59 @@ declare function saveLastSelectedAgents(agents: string[]): Promise<void>;
  */
 declare function getLastSelectedAgents(): Promise<string[] | undefined>;
 
+/**
+ * CLEO MCP lock reconciliation
+ *
+ * Infers lock metadata from live config entries and backfills
+ * missing lock entries for CLEO servers installed before lock tracking.
+ */
+
+interface InferredLockData {
+    source: string;
+    sourceType: SourceType;
+    version: string | undefined;
+}
+/**
+ * Infer lock metadata from a live MCP config entry.
+ *
+ * Determines source, sourceType, and version by inspecting the command and args
+ * of an existing CLEO MCP server config entry.
+ */
+declare function inferCleoLockData(config: Record<string, unknown>, channel: CleoChannel): InferredLockData;
+interface ReconcileOptions {
+    providerIds?: string[];
+    all?: boolean;
+    global?: boolean;
+    project?: boolean;
+    prune?: boolean;
+    dryRun?: boolean;
+}
+interface ReconcileResult {
+    backfilled: Array<{
+        serverName: string;
+        channel: CleoChannel;
+        scope: "project" | "global";
+        agents: string[];
+        source: string;
+        sourceType: SourceType;
+        version: string | undefined;
+    }>;
+    pruned: string[];
+    alreadyTracked: number;
+    errors: Array<{
+        message: string;
+    }>;
+}
+/**
+ * Reconcile CLEO lock entries against live config.
+ *
+ * 1. Scans all providers × scopes for CLEO server entries
+ * 2. Identifies entries not tracked in the lock file
+ * 3. Backfills missing entries via recordMcpInstall
+ * 4. Optionally prunes orphaned lock entries (in lock but not in any config)
+ */
+declare function reconcileCleoLock(options?: ReconcileOptions): Promise<ReconcileResult>;
+
 /**
  * Skills lock file management
  *
@@ -2713,4 +2767,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 GlobalOptions, 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 Provider, type ProviderPriority, 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 SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SourceType, type TransportType, type ValidationIssue, type ValidationResult, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, catalog, checkAllInjections, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getProjectAgentsDir, getProvider, getProviderCount, getProvidersByInstructFile, getProvidersByPriority, getProvidersByStatus, getRegistryVersion, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, rankSkills, readConfig, readLockFile, recommendSkills, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateRecommendationCriteria, validateSkill, writeConfig };
+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 GlobalOptions, 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 Provider, type ProviderPriority, 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 SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SourceType, type TransportType, type ValidationIssue, type ValidationResult, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, catalog, checkAllInjections, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, extractVersionTag, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getProjectAgentsDir, getProvider, getProviderCount, getProvidersByInstructFile, getProvidersByPriority, getProvidersByStatus, getRegistryVersion, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inferCleoLockData, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, rankSkills, readConfig, readLockFile, recommendSkills, reconcileCleoLock, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateRecommendationCriteria, validateSkill, writeConfig };

package/dist/index.js

@@ -22,6 +22,7 @@ import {
   discoverSkill,
   discoverSkills,
   ensureDir,
+  extractVersionTag,
   formatSkillRecommendations,
   generateInjectionContent,
   generateSkillsSection,
@@ -52,6 +53,7 @@ import {
   getTrackedSkills,
   getTransform,
   groupByInstructFile,
+  inferCleoLockData,
   inject,
   injectAll,
   installBatchWithRollback,
@@ -77,6 +79,7 @@ import {
   readConfig,
   readLockFile,
   recommendSkills,
+  reconcileCleoLock,
   recordMcpInstall,
   recordSkillInstall,
   registerSkillLibrary,
@@ -107,7 +110,7 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-DT22SZ7X.js";
+} from "./chunk-G7UPJOYG.js";
 export {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
@@ -132,6 +135,7 @@ export {
   discoverSkill,
   discoverSkills,
   ensureDir,
+  extractVersionTag,
   formatSkillRecommendations,
   generateInjectionContent,
   generateSkillsSection,
@@ -162,6 +166,7 @@ export {
   getTrackedSkills,
   getTransform,
   groupByInstructFile,
+  inferCleoLockData,
   inject,
   injectAll,
   installBatchWithRollback,
@@ -187,6 +192,7 @@ export {
   readConfig,
   readLockFile,
   recommendSkills,
+  reconcileCleoLock,
   recordMcpInstall,
   recordSkillInstall,
   registerSkillLibrary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/caamp",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "Central AI Agent Managed Packages - unified provider registry and package manager for AI coding agents",
   "type": "module",
   "bin": {