skill-tree 0.1.7 → 0.2.0

package/dist/index.d.mts

@@ -30,8 +30,6 @@ interface Skill {
     derivedFrom?: string[];
     /** Skills forked from this one (source → child tracking) */
     forks?: string[];
-    /** Performance metrics */
-    metrics: SkillMetrics;
     /** Upstream tracking for skills imported with 'link' mode */
     upstream?: SkillUpstream;
     source?: SkillSource$1;
@@ -76,20 +74,6 @@ interface ExpandTriggerConfig {
     };
 }
 type SkillStatus = 'draft' | 'active' | 'deprecated' | 'experimental';
-interface SkillMetrics {
-    /** Number of times this skill was used */
-    usageCount: number;
-    /** Success rate (0-1) */
-    successRate: number;
-    /** When was this skill last used */
-    lastUsed?: Date;
-    /** User feedback scores */
-    feedbackScores: number[];
-    /** Average execution time in ms */
-    avgExecutionTime?: number;
-    /** Average confidence from matching */
-    averageConfidence?: number;
-}
 interface SkillSource$1 {
     /** Where the skill came from */
     type: 'extracted' | 'manual' | 'imported' | 'composed';
@@ -264,7 +248,6 @@ interface SkillFilter {
     status?: SkillStatus[];
     tags?: string[];
     author?: string;
-    minSuccessRate?: number;
     createdAfter?: Date;
     createdBefore?: Date;
     /** Filter by scope */
@@ -1087,9 +1070,23 @@ type SkillState = 'available' | 'expanded' | 'pending';
  * Flexible criteria for selecting skills into a loadout
  */
 interface LoadoutCriteria {
-    /** Always include these skill IDs */
+    /**
+     * Always include these skill IDs in the result, regardless of other
+     * filters (status, tags, author, relationships, etc.). Missing skills
+     * are fetched from storage on demand. The list is treated as a SET +
+     * order hint — included skills come first in the order they appear
+     * here, then the rest of the filtered set.
+     *
+     * `exclude` wins over `include`: IDs listed in both are excluded.
+     *
+     * For "restrict to exactly these N skills" semantics, combine
+     * `include: [...]` with `maxSkills: include.length`.
+     */
     include?: string[];
-    /** Never include these skill IDs */
+    /**
+     * Drop these skill IDs from the result. Wins over `include` —
+     * an ID in both lists is excluded.
+     */
     exclude?: string[];
     /** Match any of these tags */
     tags?: string[];
@@ -1097,8 +1094,6 @@ interface LoadoutCriteria {
     tagsAll?: string[];
     /** Filter by status (default: ['active']) */
     status?: SkillStatus[];
-    /** Quality threshold (0-1) */
-    minSuccessRate?: number;
     /** Filter by author */
     author?: string;
     /** Semantic match to task description */
@@ -1127,8 +1122,14 @@ interface LoadoutCriteria {
     maxSkills?: number;
     /** Context budget (estimated tokens) */
     maxTokens?: number;
-    /** How to order results for selection */
-    priorityOrder?: 'relevance' | 'usage' | 'successRate' | 'recent';
+    /**
+     * How to order results for selection. Currently only `'relevance'` is
+     * recognized; it's a no-op until skill-tree gains semantic ranking. Live
+     * usage-based ranking (formerly `'usage'` / `'successRate'` / `'recent'`)
+     * is now the caller's responsibility — pre-rank and pass IDs via
+     * `include: [...]`. See README "Metrics ownership" for the rationale.
+     */
+    priorityOrder?: 'relevance';
     /** How to apply to current state */
     mode?: 'replace' | 'merge' | 'subtract';
 }
@@ -1386,10 +1387,6 @@ declare class SkillGraphServer {
      * Collapse a skill (hide full content)
      */
     collapseSkill(skillId: string): boolean;
-    /**
-     * Record skill usage (for LRU tracking and auto-expansion)
-     */
-    recordUsage(skillId: string): void;
     /**
      * Agent requests to add skills
      * If requireApproval is true, adds to pending; otherwise directly adds
@@ -1524,21 +1521,14 @@ type SkillBankToServingEvent = {
     skillId: string;
 };
 /**
- * Events that flow from Serving Layer to SkillBank
+ * Events that flow from Serving Layer to SkillBank.
+ *
+ * `skill:used`, `skill:feedback`, and `skill:requested` were removed when
+ * skill-tree dropped its `SkillMetrics` model — usage tracking is now
+ * external (e.g., cognitive-core's `playbook.evolution.*`). See
+ * docs/SKILL_TREE_METRICS_DEPRECATION.md.
  */
 type ServingToSkillBankEvent = {
-    type: 'skill:used';
-    skillId: string;
-    success: boolean;
-} | {
-    type: 'skill:feedback';
-    skillId: string;
-    score: number;
-    comment?: string;
-} | {
-    type: 'skill:requested';
-    skillId: string;
-} | {
     type: 'loadout:changed';
     state: LoadoutState;
 };
@@ -2494,7 +2484,13 @@ declare class SkillBank {
      */
     private mapToServingEvent;
     /**
-     * Handle events from serving layer
+     * Handle events from serving layer.
+     *
+     * The `loadout:changed` event is currently the only one we react to.
+     * Earlier versions also handled `skill:used` / `skill:feedback` to mutate
+     * `Skill.metrics`, but skill-tree no longer tracks per-skill usage —
+     * cognitive-core owns that signal via `playbook.evolution.*`. See
+     * docs/SKILL_TREE_METRICS_DEPRECATION.md.
      */
     private handleServingEvent;
     /**
@@ -2532,8 +2528,6 @@ interface SkillBankStats {
     totalSkills: number;
     byStatus: Record<Skill['status'], number>;
     byTag: Record<string, number>;
-    avgSuccessRate: number;
-    totalUsage: number;
     byScope?: {
         personal: number;
         team: number;
@@ -2795,8 +2789,6 @@ interface SkillSelector {
     tags?: string[];
     /** Include skills matching this status */
     status?: ('active' | 'experimental')[];
-    /** Minimum success rate to include */
-    minSuccessRate?: number;
     /** Maximum number of skills to include */
     limit?: number;
 }
@@ -3112,7 +3104,24 @@ declare class LoadoutCompiler {
     private config;
     constructor(storage: StorageAdapter, config?: LoadoutCompilerConfig);
     /**
-     * Main entry point - compile skills from criteria
+     * Main entry point - compile skills from criteria.
+     *
+     * Filter pipeline order:
+     *   1. status (initial query)
+     *   2. exclude (drop matching IDs)
+     *   3. tags / tagsAll
+     *   4. author
+     *   5. semantic (currently no-op)
+     *   6. relationships (rootSkills traversal)
+     *   7. **include** — presence guarantee: ensures every ID in the
+     *      include list is in the result regardless of the filters above,
+     *      fetching missing ones from storage as needed. `exclude` still
+     *      wins (excluded IDs are removed from the include list before
+     *      this step).
+     *   8. limits (maxSkills, maxTokens)
+     *
+     * For "restrict to exactly these skills" semantics, combine
+     * `include: [...]` with `maxSkills: include.length`.
      */
     compile(criteria: LoadoutCriteria): Promise<Skill[]>;
     /**
@@ -3128,7 +3137,9 @@ declare class LoadoutCompiler {
      */
     mergeLoadouts(current: Skill[], additions: Skill[], mode?: 'replace' | 'merge' | 'subtract'): Skill[];
     /**
-     * Apply explicit include/exclude filters
+     * Apply explicit exclude filter. Include is handled separately at the
+     * compile level (see `ensureIncludedPresent`) so it can guarantee
+     * presence regardless of the other filters in this method or below.
      */
     applyExplicitFilters(skills: Skill[], criteria: LoadoutCriteria): Skill[];
     /**
@@ -3150,6 +3161,20 @@ declare class LoadoutCompiler {
      * Apply relationship-based filters (root skills, dependencies)
      */
     applyRelationshipFilters(skills: Skill[], criteria: LoadoutCriteria): Promise<Skill[]>;
+    /**
+     * Ensure every ID in `criteria.include` is present in the result,
+     * regardless of which earlier filter would have dropped it. Missing
+     * skills are fetched directly from storage.
+     *
+     * `criteria.exclude` still wins: an ID listed in both `include` and
+     * `exclude` is treated as excluded (consistent with openteams' "deny
+     * wins" inheritance rule on permissions).
+     *
+     * Included skills are placed at the front of the result, preserving
+     * the order of `criteria.include`. Other skills retain their relative
+     * order behind them.
+     */
+    ensureIncludedPresent(current: Skill[], criteria: LoadoutCriteria): Promise<Skill[]>;
     /**
      * Apply limits and sorting
      */
@@ -3888,6 +3913,6 @@ declare class IndexerService {
  *
  * @packageDocumentation
  */
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.2.0";
 
-export { type AgentConfig, AgentsGenerator, type AgentsGeneratorConfig, AgentsParser, AgentsSync, type BaseHookContext, type BumpType, CachedStorageAdapter, type CachedStorageConfig, CatalogRenderer, type CatalogRendererConfig, type ConflictConfig, type ConflictResolution$1 as ConflictResolution, ConflictStore, type ConflictStrategy, DEFAULT_AGENTS_CONFIG, type DiscoveredSkill, type EvictionStrategy, type ExpandTrigger, type ExpandTriggerConfig, type FederatedRemoteConfig, type FederationEvent, type FederationEventHandler, FederationManager, type FederationManagerOptions, type FetchResult, type ForkOptions, GitSyncAdapter, type GitSyncAdapterOptions, type SyncResult$1 as GitSyncResult, type GraphServerConfig, type HookContext, type HookEvent, type HookExecutionResult, type HookHandler, type HookPriority, HookRegistry, type HookResult, type ImportMode, type ImportOptions, type ImportResult, type IndexResult, IndexerService, type IndexerServiceConfig, type SkillSource as IndexerSkillSource, type IndexerStats, LineageTracker, type LineageTree, LoadoutCompiler, type LoadoutCompilerConfig, type LoadoutCriteria, type LoadoutSource, type LoadoutState, type LoadoutView, type MaterializationConfig, Materializer, MemoryStorageAdapter, type MergeConfig, type MergeConflict, type MergePreview, type MergeResult, type MergeStrategy, type MergeSuggestion, type MigrationOptions, type MigrationProgressItem, type MigrationResult, type NewVersionOptions, type ParsedAgentSkill, type ParsedAgentsFile, type ParsedVersion, type ProjectContext, ProjectDetector, type PullOptions, type PullUpstreamOptions, type PullUpstreamResult, type PushOptions, type RegisterHookOptions, type RegisteredHook, type RelationshipResult, type RemoteConfig, RemoteManager, type RemoteState, RemoteStore, type RollbackOptions, type ScrapeResult, type ServingEvent, type ServingEventHandler, type ShareOptions, type ShareResult, type Skill, type SkillAccessControl, SkillBank, type SkillBankConfig, type SkillBankStats, type SkillChange, type SkillConflict, type SkillCrudHookContext, type SkillDiffChanges, type SkillFilter, type SkillFork, type SkillFormat, SkillGraphServer, type SkillLineage, type SkillMergeResult, SkillMerger, type SkillMetrics, type SkillNamespace, type SkillScope, type SkillSelector, type SkillServingMetadata, type SkillSource$1 as SkillSource, type SkillState, type SkillStatus, type SkillSummary, type SkillSyncState, type SkillTreeEvent, type SkillTreeEventHandler, type SkillUpstream, type SkillVersion, type SkillVisibility, type StorageAdapter, type StorageConfig, type StorageHookContext, type SyncBehaviorConfig, type SyncConfig, type ConflictResolution as SyncConflictResolution, type SyncError, SyncManager, type SyncManagerOptions, type SyncOptions, type SyncResult, type SyncState, type SyncStatus, type TaxonomyNode, type UpstreamUpdate, VERSION, type VersionChanges, type VersionDiff, ViewRenderer, type ViewRendererConfig, builtInProfiles, bumpVersion, codeReviewProfile, combineHandlers, compareVersions, conditionalHook, createAgentsGenerator, createAgentsParser, createAgentsSync, createBackupHook, createConflictStore, createDefaultSyncConfig, createFederationManager, createGitSyncAdapter, createLoggingHook, createSaveValidationHook, createSkillBank, createSkillMerger, createSyncManager, debuggingProfile, devopsProfile, discoverSkills, documentationProfile, formatVersion, generateAgentsMd, getBuiltInProfile, getLatestVersion, hasSkilltreeDir, hookRegistry, implementationProfile, importFromAgentsMd, inferBumpType, isValidVersion, listBuiltInProfiles, migrateStorage, parseVersion, refactoringProfile, satisfiesRange, securityProfile, sortVersions, testingProfile, writeAgentsMd };
+export { type AgentConfig, AgentsGenerator, type AgentsGeneratorConfig, AgentsParser, AgentsSync, type BaseHookContext, type BumpType, CachedStorageAdapter, type CachedStorageConfig, CatalogRenderer, type CatalogRendererConfig, type ConflictConfig, type ConflictResolution$1 as ConflictResolution, ConflictStore, type ConflictStrategy, DEFAULT_AGENTS_CONFIG, type DiscoveredSkill, type EvictionStrategy, type ExpandTrigger, type ExpandTriggerConfig, type FederatedRemoteConfig, type FederationEvent, type FederationEventHandler, FederationManager, type FederationManagerOptions, type FetchResult, type ForkOptions, GitSyncAdapter, type GitSyncAdapterOptions, type SyncResult$1 as GitSyncResult, type GraphServerConfig, type HookContext, type HookEvent, type HookExecutionResult, type HookHandler, type HookPriority, HookRegistry, type HookResult, type ImportMode, type ImportOptions, type ImportResult, type IndexResult, IndexerService, type IndexerServiceConfig, type SkillSource as IndexerSkillSource, type IndexerStats, LineageTracker, type LineageTree, LoadoutCompiler, type LoadoutCompilerConfig, type LoadoutCriteria, type LoadoutSource, type LoadoutState, type LoadoutView, type MaterializationConfig, Materializer, MemoryStorageAdapter, type MergeConfig, type MergeConflict, type MergePreview, type MergeResult, type MergeStrategy, type MergeSuggestion, type MigrationOptions, type MigrationProgressItem, type MigrationResult, type NewVersionOptions, type ParsedAgentSkill, type ParsedAgentsFile, type ParsedVersion, type ProjectContext, ProjectDetector, type PullOptions, type PullUpstreamOptions, type PullUpstreamResult, type PushOptions, type RegisterHookOptions, type RegisteredHook, type RelationshipResult, type RemoteConfig, RemoteManager, type RemoteState, RemoteStore, type RollbackOptions, type ScrapeResult, type ServingEvent, type ServingEventHandler, type ShareOptions, type ShareResult, type Skill, type SkillAccessControl, SkillBank, type SkillBankConfig, type SkillBankStats, type SkillChange, type SkillConflict, type SkillCrudHookContext, type SkillDiffChanges, type SkillFilter, type SkillFork, type SkillFormat, SkillGraphServer, type SkillLineage, type SkillMergeResult, SkillMerger, type SkillNamespace, type SkillScope, type SkillSelector, type SkillServingMetadata, type SkillSource$1 as SkillSource, type SkillState, type SkillStatus, type SkillSummary, type SkillSyncState, type SkillTreeEvent, type SkillTreeEventHandler, type SkillUpstream, type SkillVersion, type SkillVisibility, type StorageAdapter, type StorageConfig, type StorageHookContext, type SyncBehaviorConfig, type SyncConfig, type ConflictResolution as SyncConflictResolution, type SyncError, SyncManager, type SyncManagerOptions, type SyncOptions, type SyncResult, type SyncState, type SyncStatus, type TaxonomyNode, type UpstreamUpdate, VERSION, type VersionChanges, type VersionDiff, ViewRenderer, type ViewRendererConfig, builtInProfiles, bumpVersion, codeReviewProfile, combineHandlers, compareVersions, conditionalHook, createAgentsGenerator, createAgentsParser, createAgentsSync, createBackupHook, createConflictStore, createDefaultSyncConfig, createFederationManager, createGitSyncAdapter, createLoggingHook, createSaveValidationHook, createSkillBank, createSkillMerger, createSyncManager, debuggingProfile, devopsProfile, discoverSkills, documentationProfile, formatVersion, generateAgentsMd, getBuiltInProfile, getLatestVersion, hasSkilltreeDir, hookRegistry, implementationProfile, importFromAgentsMd, inferBumpType, isValidVersion, listBuiltInProfiles, migrateStorage, parseVersion, refactoringProfile, satisfiesRange, securityProfile, sortVersions, testingProfile, writeAgentsMd };

package/dist/index.d.ts

@@ -30,8 +30,6 @@ interface Skill {
     derivedFrom?: string[];
     /** Skills forked from this one (source → child tracking) */
     forks?: string[];
-    /** Performance metrics */
-    metrics: SkillMetrics;
     /** Upstream tracking for skills imported with 'link' mode */
     upstream?: SkillUpstream;
     source?: SkillSource$1;
@@ -76,20 +74,6 @@ interface ExpandTriggerConfig {
     };
 }
 type SkillStatus = 'draft' | 'active' | 'deprecated' | 'experimental';
-interface SkillMetrics {
-    /** Number of times this skill was used */
-    usageCount: number;
-    /** Success rate (0-1) */
-    successRate: number;
-    /** When was this skill last used */
-    lastUsed?: Date;
-    /** User feedback scores */
-    feedbackScores: number[];
-    /** Average execution time in ms */
-    avgExecutionTime?: number;
-    /** Average confidence from matching */
-    averageConfidence?: number;
-}
 interface SkillSource$1 {
     /** Where the skill came from */
     type: 'extracted' | 'manual' | 'imported' | 'composed';
@@ -264,7 +248,6 @@ interface SkillFilter {
     status?: SkillStatus[];
     tags?: string[];
     author?: string;
-    minSuccessRate?: number;
     createdAfter?: Date;
     createdBefore?: Date;
     /** Filter by scope */
@@ -1087,9 +1070,23 @@ type SkillState = 'available' | 'expanded' | 'pending';
  * Flexible criteria for selecting skills into a loadout
  */
 interface LoadoutCriteria {
-    /** Always include these skill IDs */
+    /**
+     * Always include these skill IDs in the result, regardless of other
+     * filters (status, tags, author, relationships, etc.). Missing skills
+     * are fetched from storage on demand. The list is treated as a SET +
+     * order hint — included skills come first in the order they appear
+     * here, then the rest of the filtered set.
+     *
+     * `exclude` wins over `include`: IDs listed in both are excluded.
+     *
+     * For "restrict to exactly these N skills" semantics, combine
+     * `include: [...]` with `maxSkills: include.length`.
+     */
     include?: string[];
-    /** Never include these skill IDs */
+    /**
+     * Drop these skill IDs from the result. Wins over `include` —
+     * an ID in both lists is excluded.
+     */
     exclude?: string[];
     /** Match any of these tags */
     tags?: string[];
@@ -1097,8 +1094,6 @@ interface LoadoutCriteria {
     tagsAll?: string[];
     /** Filter by status (default: ['active']) */
     status?: SkillStatus[];
-    /** Quality threshold (0-1) */
-    minSuccessRate?: number;
     /** Filter by author */
     author?: string;
     /** Semantic match to task description */
@@ -1127,8 +1122,14 @@ interface LoadoutCriteria {
     maxSkills?: number;
     /** Context budget (estimated tokens) */
     maxTokens?: number;
-    /** How to order results for selection */
-    priorityOrder?: 'relevance' | 'usage' | 'successRate' | 'recent';
+    /**
+     * How to order results for selection. Currently only `'relevance'` is
+     * recognized; it's a no-op until skill-tree gains semantic ranking. Live
+     * usage-based ranking (formerly `'usage'` / `'successRate'` / `'recent'`)
+     * is now the caller's responsibility — pre-rank and pass IDs via
+     * `include: [...]`. See README "Metrics ownership" for the rationale.
+     */
+    priorityOrder?: 'relevance';
     /** How to apply to current state */
     mode?: 'replace' | 'merge' | 'subtract';
 }
@@ -1386,10 +1387,6 @@ declare class SkillGraphServer {
      * Collapse a skill (hide full content)
      */
     collapseSkill(skillId: string): boolean;
-    /**
-     * Record skill usage (for LRU tracking and auto-expansion)
-     */
-    recordUsage(skillId: string): void;
     /**
      * Agent requests to add skills
      * If requireApproval is true, adds to pending; otherwise directly adds
@@ -1524,21 +1521,14 @@ type SkillBankToServingEvent = {
     skillId: string;
 };
 /**
- * Events that flow from Serving Layer to SkillBank
+ * Events that flow from Serving Layer to SkillBank.
+ *
+ * `skill:used`, `skill:feedback`, and `skill:requested` were removed when
+ * skill-tree dropped its `SkillMetrics` model — usage tracking is now
+ * external (e.g., cognitive-core's `playbook.evolution.*`). See
+ * docs/SKILL_TREE_METRICS_DEPRECATION.md.
  */
 type ServingToSkillBankEvent = {
-    type: 'skill:used';
-    skillId: string;
-    success: boolean;
-} | {
-    type: 'skill:feedback';
-    skillId: string;
-    score: number;
-    comment?: string;
-} | {
-    type: 'skill:requested';
-    skillId: string;
-} | {
     type: 'loadout:changed';
     state: LoadoutState;
 };
@@ -2494,7 +2484,13 @@ declare class SkillBank {
      */
     private mapToServingEvent;
     /**
-     * Handle events from serving layer
+     * Handle events from serving layer.
+     *
+     * The `loadout:changed` event is currently the only one we react to.
+     * Earlier versions also handled `skill:used` / `skill:feedback` to mutate
+     * `Skill.metrics`, but skill-tree no longer tracks per-skill usage —
+     * cognitive-core owns that signal via `playbook.evolution.*`. See
+     * docs/SKILL_TREE_METRICS_DEPRECATION.md.
      */
     private handleServingEvent;
     /**
@@ -2532,8 +2528,6 @@ interface SkillBankStats {
     totalSkills: number;
     byStatus: Record<Skill['status'], number>;
     byTag: Record<string, number>;
-    avgSuccessRate: number;
-    totalUsage: number;
     byScope?: {
         personal: number;
         team: number;
@@ -2795,8 +2789,6 @@ interface SkillSelector {
     tags?: string[];
     /** Include skills matching this status */
     status?: ('active' | 'experimental')[];
-    /** Minimum success rate to include */
-    minSuccessRate?: number;
     /** Maximum number of skills to include */
     limit?: number;
 }
@@ -3112,7 +3104,24 @@ declare class LoadoutCompiler {
     private config;
     constructor(storage: StorageAdapter, config?: LoadoutCompilerConfig);
     /**
-     * Main entry point - compile skills from criteria
+     * Main entry point - compile skills from criteria.
+     *
+     * Filter pipeline order:
+     *   1. status (initial query)
+     *   2. exclude (drop matching IDs)
+     *   3. tags / tagsAll
+     *   4. author
+     *   5. semantic (currently no-op)
+     *   6. relationships (rootSkills traversal)
+     *   7. **include** — presence guarantee: ensures every ID in the
+     *      include list is in the result regardless of the filters above,
+     *      fetching missing ones from storage as needed. `exclude` still
+     *      wins (excluded IDs are removed from the include list before
+     *      this step).
+     *   8. limits (maxSkills, maxTokens)
+     *
+     * For "restrict to exactly these skills" semantics, combine
+     * `include: [...]` with `maxSkills: include.length`.
      */
     compile(criteria: LoadoutCriteria): Promise<Skill[]>;
     /**
@@ -3128,7 +3137,9 @@ declare class LoadoutCompiler {
      */
     mergeLoadouts(current: Skill[], additions: Skill[], mode?: 'replace' | 'merge' | 'subtract'): Skill[];
     /**
-     * Apply explicit include/exclude filters
+     * Apply explicit exclude filter. Include is handled separately at the
+     * compile level (see `ensureIncludedPresent`) so it can guarantee
+     * presence regardless of the other filters in this method or below.
      */
     applyExplicitFilters(skills: Skill[], criteria: LoadoutCriteria): Skill[];
     /**
@@ -3150,6 +3161,20 @@ declare class LoadoutCompiler {
      * Apply relationship-based filters (root skills, dependencies)
      */
     applyRelationshipFilters(skills: Skill[], criteria: LoadoutCriteria): Promise<Skill[]>;
+    /**
+     * Ensure every ID in `criteria.include` is present in the result,
+     * regardless of which earlier filter would have dropped it. Missing
+     * skills are fetched directly from storage.
+     *
+     * `criteria.exclude` still wins: an ID listed in both `include` and
+     * `exclude` is treated as excluded (consistent with openteams' "deny
+     * wins" inheritance rule on permissions).
+     *
+     * Included skills are placed at the front of the result, preserving
+     * the order of `criteria.include`. Other skills retain their relative
+     * order behind them.
+     */
+    ensureIncludedPresent(current: Skill[], criteria: LoadoutCriteria): Promise<Skill[]>;
     /**
      * Apply limits and sorting
      */
@@ -3888,6 +3913,6 @@ declare class IndexerService {
  *
  * @packageDocumentation
  */
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.2.0";
 
-export { type AgentConfig, AgentsGenerator, type AgentsGeneratorConfig, AgentsParser, AgentsSync, type BaseHookContext, type BumpType, CachedStorageAdapter, type CachedStorageConfig, CatalogRenderer, type CatalogRendererConfig, type ConflictConfig, type ConflictResolution$1 as ConflictResolution, ConflictStore, type ConflictStrategy, DEFAULT_AGENTS_CONFIG, type DiscoveredSkill, type EvictionStrategy, type ExpandTrigger, type ExpandTriggerConfig, type FederatedRemoteConfig, type FederationEvent, type FederationEventHandler, FederationManager, type FederationManagerOptions, type FetchResult, type ForkOptions, GitSyncAdapter, type GitSyncAdapterOptions, type SyncResult$1 as GitSyncResult, type GraphServerConfig, type HookContext, type HookEvent, type HookExecutionResult, type HookHandler, type HookPriority, HookRegistry, type HookResult, type ImportMode, type ImportOptions, type ImportResult, type IndexResult, IndexerService, type IndexerServiceConfig, type SkillSource as IndexerSkillSource, type IndexerStats, LineageTracker, type LineageTree, LoadoutCompiler, type LoadoutCompilerConfig, type LoadoutCriteria, type LoadoutSource, type LoadoutState, type LoadoutView, type MaterializationConfig, Materializer, MemoryStorageAdapter, type MergeConfig, type MergeConflict, type MergePreview, type MergeResult, type MergeStrategy, type MergeSuggestion, type MigrationOptions, type MigrationProgressItem, type MigrationResult, type NewVersionOptions, type ParsedAgentSkill, type ParsedAgentsFile, type ParsedVersion, type ProjectContext, ProjectDetector, type PullOptions, type PullUpstreamOptions, type PullUpstreamResult, type PushOptions, type RegisterHookOptions, type RegisteredHook, type RelationshipResult, type RemoteConfig, RemoteManager, type RemoteState, RemoteStore, type RollbackOptions, type ScrapeResult, type ServingEvent, type ServingEventHandler, type ShareOptions, type ShareResult, type Skill, type SkillAccessControl, SkillBank, type SkillBankConfig, type SkillBankStats, type SkillChange, type SkillConflict, type SkillCrudHookContext, type SkillDiffChanges, type SkillFilter, type SkillFork, type SkillFormat, SkillGraphServer, type SkillLineage, type SkillMergeResult, SkillMerger, type SkillMetrics, type SkillNamespace, type SkillScope, type SkillSelector, type SkillServingMetadata, type SkillSource$1 as SkillSource, type SkillState, type SkillStatus, type SkillSummary, type SkillSyncState, type SkillTreeEvent, type SkillTreeEventHandler, type SkillUpstream, type SkillVersion, type SkillVisibility, type StorageAdapter, type StorageConfig, type StorageHookContext, type SyncBehaviorConfig, type SyncConfig, type ConflictResolution as SyncConflictResolution, type SyncError, SyncManager, type SyncManagerOptions, type SyncOptions, type SyncResult, type SyncState, type SyncStatus, type TaxonomyNode, type UpstreamUpdate, VERSION, type VersionChanges, type VersionDiff, ViewRenderer, type ViewRendererConfig, builtInProfiles, bumpVersion, codeReviewProfile, combineHandlers, compareVersions, conditionalHook, createAgentsGenerator, createAgentsParser, createAgentsSync, createBackupHook, createConflictStore, createDefaultSyncConfig, createFederationManager, createGitSyncAdapter, createLoggingHook, createSaveValidationHook, createSkillBank, createSkillMerger, createSyncManager, debuggingProfile, devopsProfile, discoverSkills, documentationProfile, formatVersion, generateAgentsMd, getBuiltInProfile, getLatestVersion, hasSkilltreeDir, hookRegistry, implementationProfile, importFromAgentsMd, inferBumpType, isValidVersion, listBuiltInProfiles, migrateStorage, parseVersion, refactoringProfile, satisfiesRange, securityProfile, sortVersions, testingProfile, writeAgentsMd };
+export { type AgentConfig, AgentsGenerator, type AgentsGeneratorConfig, AgentsParser, AgentsSync, type BaseHookContext, type BumpType, CachedStorageAdapter, type CachedStorageConfig, CatalogRenderer, type CatalogRendererConfig, type ConflictConfig, type ConflictResolution$1 as ConflictResolution, ConflictStore, type ConflictStrategy, DEFAULT_AGENTS_CONFIG, type DiscoveredSkill, type EvictionStrategy, type ExpandTrigger, type ExpandTriggerConfig, type FederatedRemoteConfig, type FederationEvent, type FederationEventHandler, FederationManager, type FederationManagerOptions, type FetchResult, type ForkOptions, GitSyncAdapter, type GitSyncAdapterOptions, type SyncResult$1 as GitSyncResult, type GraphServerConfig, type HookContext, type HookEvent, type HookExecutionResult, type HookHandler, type HookPriority, HookRegistry, type HookResult, type ImportMode, type ImportOptions, type ImportResult, type IndexResult, IndexerService, type IndexerServiceConfig, type SkillSource as IndexerSkillSource, type IndexerStats, LineageTracker, type LineageTree, LoadoutCompiler, type LoadoutCompilerConfig, type LoadoutCriteria, type LoadoutSource, type LoadoutState, type LoadoutView, type MaterializationConfig, Materializer, MemoryStorageAdapter, type MergeConfig, type MergeConflict, type MergePreview, type MergeResult, type MergeStrategy, type MergeSuggestion, type MigrationOptions, type MigrationProgressItem, type MigrationResult, type NewVersionOptions, type ParsedAgentSkill, type ParsedAgentsFile, type ParsedVersion, type ProjectContext, ProjectDetector, type PullOptions, type PullUpstreamOptions, type PullUpstreamResult, type PushOptions, type RegisterHookOptions, type RegisteredHook, type RelationshipResult, type RemoteConfig, RemoteManager, type RemoteState, RemoteStore, type RollbackOptions, type ScrapeResult, type ServingEvent, type ServingEventHandler, type ShareOptions, type ShareResult, type Skill, type SkillAccessControl, SkillBank, type SkillBankConfig, type SkillBankStats, type SkillChange, type SkillConflict, type SkillCrudHookContext, type SkillDiffChanges, type SkillFilter, type SkillFork, type SkillFormat, SkillGraphServer, type SkillLineage, type SkillMergeResult, SkillMerger, type SkillNamespace, type SkillScope, type SkillSelector, type SkillServingMetadata, type SkillSource$1 as SkillSource, type SkillState, type SkillStatus, type SkillSummary, type SkillSyncState, type SkillTreeEvent, type SkillTreeEventHandler, type SkillUpstream, type SkillVersion, type SkillVisibility, type StorageAdapter, type StorageConfig, type StorageHookContext, type SyncBehaviorConfig, type SyncConfig, type ConflictResolution as SyncConflictResolution, type SyncError, SyncManager, type SyncManagerOptions, type SyncOptions, type SyncResult, type SyncState, type SyncStatus, type TaxonomyNode, type UpstreamUpdate, VERSION, type VersionChanges, type VersionDiff, ViewRenderer, type ViewRendererConfig, builtInProfiles, bumpVersion, codeReviewProfile, combineHandlers, compareVersions, conditionalHook, createAgentsGenerator, createAgentsParser, createAgentsSync, createBackupHook, createConflictStore, createDefaultSyncConfig, createFederationManager, createGitSyncAdapter, createLoggingHook, createSaveValidationHook, createSkillBank, createSkillMerger, createSyncManager, debuggingProfile, devopsProfile, discoverSkills, documentationProfile, formatVersion, generateAgentsMd, getBuiltInProfile, getLatestVersion, hasSkilltreeDir, hookRegistry, implementationProfile, importFromAgentsMd, inferBumpType, isValidVersion, listBuiltInProfiles, migrateStorage, parseVersion, refactoringProfile, satisfiesRange, securityProfile, sortVersions, testingProfile, writeAgentsMd };