@egentica/codemap 0.1.5

package/dist/core/HelpRegistry.d.ts

@@ -0,0 +1,116 @@
+/**
+ * HelpRegistry - Universal help topic registry for CodeMap
+ *
+ * Manages help documentation for both core features and plugins.
+ * Plugins can register their own help topics to extend the help system.
+ *
+ * @example
+ * // Core registration during initialization
+ * registry.registerTopic({
+ *   id: 'getting-started',
+ *   title: 'Getting Started with CodeMap',
+ *   source: 'core',
+ *   filePath: '/path/to/docs/help/getting-started.md'
+ * });
+ *
+ * @example
+ * // Plugin registration
+ * registry.registerTopic({
+ *   id: 'timewarp',
+ *   title: 'TimeWarp Plugin Guide',
+ *   source: 'timewarp-plugin',
+ *   content: '# TimeWarp Plugin\n\n...'
+ * });
+ */
+export interface HelpTopic {
+    /** Unique topic identifier (kebab-case) */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** Source: 'core' or plugin name */
+    source: string;
+    /** Path to markdown file (mutually exclusive with content) */
+    filePath?: string;
+    /** Inline markdown content (mutually exclusive with filePath) */
+    content?: string;
+    /** Optional tags for categorization */
+    tags?: string[];
+    /** Optional short description */
+    description?: string;
+}
+export interface HelpTopicMetadata {
+    id: string;
+    title: string;
+    source: string;
+    tags?: string[];
+    description?: string;
+}
+export declare class HelpRegistry {
+    private topics;
+    /**
+     * Register a help topic
+     *
+     * @param topic - Help topic configuration
+     * @throws Error if topic ID already exists
+     * @throws Error if neither filePath nor content is provided
+     * @throws Error if both filePath and content are provided
+     */
+    registerTopic(topic: HelpTopic): void;
+    /**
+     * Register multiple topics at once
+     */
+    registerTopics(topics: HelpTopic[]): void;
+    /**
+     * Get a topic by ID
+     *
+     * @returns Topic if found, undefined otherwise
+     */
+    getTopic(id: string): HelpTopic | undefined;
+    /**
+     * Check if a topic exists
+     */
+    hasTopic(id: string): boolean;
+    /**
+     * Get all registered topic IDs
+     */
+    getAllTopicIds(): string[];
+    /**
+     * Get all topics (full data)
+     */
+    getAllTopics(): HelpTopic[];
+    /**
+     * Get topic metadata (without content/filePath)
+     */
+    getTopicMetadata(id: string): HelpTopicMetadata | undefined;
+    /**
+     * Get all topic metadata
+     */
+    getAllTopicMetadata(): HelpTopicMetadata[];
+    /**
+     * Get topics by source (core or plugin name)
+     */
+    getTopicsBySource(source: string): HelpTopic[];
+    /**
+     * Get topics by tag
+     */
+    getTopicsByTag(tag: string): HelpTopic[];
+    /**
+     * Unregister a topic (useful for testing or hot-reload)
+     *
+     * @returns true if topic was found and removed, false otherwise
+     */
+    unregisterTopic(id: string): boolean;
+    /**
+     * Clear all topics (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get total number of registered topics
+     */
+    get count(): number;
+    /**
+     * Get count by source
+     */
+    getCountBySource(source: string): number;
+}
+//# sourceMappingURL=HelpRegistry.d.ts.map

package/dist/core/HelpRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpRegistry.d.ts","sourceRoot":"","sources":["../../src/core/HelpRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IAEX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqC;IAEnD;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAsBrC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAMzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,YAAY,IAAI,SAAS,EAAE;IAI3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAa3D;;OAEG;IACH,mBAAmB,IAAI,iBAAiB,EAAE;IAU1C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAM9C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;IAMxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGzC"}

package/dist/core/HelpRegistry.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * HelpRegistry - Universal help topic registry for CodeMap
+ *
+ * Manages help documentation for both core features and plugins.
+ * Plugins can register their own help topics to extend the help system.
+ *
+ * @example
+ * // Core registration during initialization
+ * registry.registerTopic({
+ *   id: 'getting-started',
+ *   title: 'Getting Started with CodeMap',
+ *   source: 'core',
+ *   filePath: '/path/to/docs/help/getting-started.md'
+ * });
+ *
+ * @example
+ * // Plugin registration
+ * registry.registerTopic({
+ *   id: 'timewarp',
+ *   title: 'TimeWarp Plugin Guide',
+ *   source: 'timewarp-plugin',
+ *   content: '# TimeWarp Plugin\n\n...'
+ * });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelpRegistry = void 0;
+class HelpRegistry {
+    topics = new Map();
+    /**
+     * Register a help topic
+     *
+     * @param topic - Help topic configuration
+     * @throws Error if topic ID already exists
+     * @throws Error if neither filePath nor content is provided
+     * @throws Error if both filePath and content are provided
+     */
+    registerTopic(topic) {
+        // Validation
+        if (this.topics.has(topic.id)) {
+            throw new Error(`Help topic "${topic.id}" is already registered by source: ${this.topics.get(topic.id).source}`);
+        }
+        if (!topic.filePath && !topic.content) {
+            throw new Error(`Help topic "${topic.id}" must provide either filePath or content`);
+        }
+        if (topic.filePath && topic.content) {
+            throw new Error(`Help topic "${topic.id}" cannot provide both filePath and content`);
+        }
+        // Validate topic ID format (kebab-case)
+        if (!/^[a-z0-9-]+$/.test(topic.id)) {
+            throw new Error(`Help topic ID "${topic.id}" must be kebab-case (lowercase letters, numbers, hyphens only)`);
+        }
+        this.topics.set(topic.id, topic);
+    }
+    /**
+     * Register multiple topics at once
+     */
+    registerTopics(topics) {
+        for (const topic of topics) {
+            this.registerTopic(topic);
+        }
+    }
+    /**
+     * Get a topic by ID
+     *
+     * @returns Topic if found, undefined otherwise
+     */
+    getTopic(id) {
+        return this.topics.get(id);
+    }
+    /**
+     * Check if a topic exists
+     */
+    hasTopic(id) {
+        return this.topics.has(id);
+    }
+    /**
+     * Get all registered topic IDs
+     */
+    getAllTopicIds() {
+        return Array.from(this.topics.keys()).sort();
+    }
+    /**
+     * Get all topics (full data)
+     */
+    getAllTopics() {
+        return Array.from(this.topics.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Get topic metadata (without content/filePath)
+     */
+    getTopicMetadata(id) {
+        const topic = this.topics.get(id);
+        if (!topic)
+            return undefined;
+        return {
+            id: topic.id,
+            title: topic.title,
+            source: topic.source,
+            tags: topic.tags,
+            description: topic.description
+        };
+    }
+    /**
+     * Get all topic metadata
+     */
+    getAllTopicMetadata() {
+        return this.getAllTopics().map(topic => ({
+            id: topic.id,
+            title: topic.title,
+            source: topic.source,
+            tags: topic.tags,
+            description: topic.description
+        }));
+    }
+    /**
+     * Get topics by source (core or plugin name)
+     */
+    getTopicsBySource(source) {
+        return Array.from(this.topics.values())
+            .filter(topic => topic.source === source)
+            .sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Get topics by tag
+     */
+    getTopicsByTag(tag) {
+        return Array.from(this.topics.values())
+            .filter(topic => topic.tags?.includes(tag))
+            .sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Unregister a topic (useful for testing or hot-reload)
+     *
+     * @returns true if topic was found and removed, false otherwise
+     */
+    unregisterTopic(id) {
+        return this.topics.delete(id);
+    }
+    /**
+     * Clear all topics (useful for testing)
+     */
+    clear() {
+        this.topics.clear();
+    }
+    /**
+     * Get total number of registered topics
+     */
+    get count() {
+        return this.topics.size;
+    }
+    /**
+     * Get count by source
+     */
+    getCountBySource(source) {
+        return this.getTopicsBySource(source).length;
+    }
+}
+exports.HelpRegistry = HelpRegistry;
+//# sourceMappingURL=HelpRegistry.js.map

package/dist/core/HelpRegistry.js.map

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

package/dist/core/HintRegistry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * HintRegistry - Contextual hints system
+ *
+ * Provides helpful hints based on search results and context.
+ * Hints are appended to search responses to guide users.
+ */
+export interface HintCondition {
+    /** Unique ID for this hint */
+    id: string;
+    /** Check if hint should be shown */
+    check: (context: HintContext) => boolean;
+    /** Message to display */
+    message: string;
+    /** Priority (higher = shown first) */
+    priority: number;
+}
+export interface HintContext {
+    /** Search results */
+    results: any[];
+    /** Total matches found */
+    totalMatches: number;
+    /** Search query */
+    query: string;
+    /** Search mode */
+    mode?: string;
+    /** Any additional context */
+    [key: string]: any;
+}
+export declare class HintRegistry {
+    private hints;
+    /**
+     * Register a hint condition.
+     */
+    register(hint: HintCondition): void;
+    /**
+     * Unregister a hint.
+     */
+    unregister(id: string): void;
+    /**
+     * Get all applicable hints for the given context.
+     * Returns hints sorted by priority (highest first).
+     */
+    getHints(context: HintContext): string[];
+    /**
+     * Register default hints for common scenarios.
+     */
+    registerDefaults(): void;
+}
+//# sourceMappingURL=HintRegistry.d.ts.map

package/dist/core/HintRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HintRegistry.d.ts","sourceRoot":"","sources":["../../src/core/HintRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;IAEzC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC;IAEf,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAyC;IAEtD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAInC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE;IAexC;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAyCzB"}

package/dist/core/HintRegistry.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * HintRegistry - Contextual hints system
+ *
+ * Provides helpful hints based on search results and context.
+ * Hints are appended to search responses to guide users.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HintRegistry = void 0;
+class HintRegistry {
+    hints = new Map();
+    /**
+     * Register a hint condition.
+     */
+    register(hint) {
+        this.hints.set(hint.id, hint);
+    }
+    /**
+     * Unregister a hint.
+     */
+    unregister(id) {
+        this.hints.delete(id);
+    }
+    /**
+     * Get all applicable hints for the given context.
+     * Returns hints sorted by priority (highest first).
+     */
+    getHints(context) {
+        const applicableHints = [];
+        for (const hint of this.hints.values()) {
+            if (hint.check(context)) {
+                applicableHints.push(hint);
+            }
+        }
+        // Sort by priority (descending)
+        applicableHints.sort((a, b) => b.priority - a.priority);
+        return applicableHints.map(h => h.message);
+    }
+    /**
+     * Register default hints for common scenarios.
+     */
+    registerDefaults() {
+        // Hint: No results - check orientation
+        this.register({
+            id: 'no-results-orientation',
+            priority: 100,
+            message: '💡 No results found. Have you oriented your session to the project directory using `codemap_orient(rootPath: "...")`? This is the leading cause of no results.',
+            check: (ctx) => ctx.totalMatches === 0
+        });
+        // Hint: No results - try other commands
+        this.register({
+            id: 'no-results-alternatives',
+            priority: 90,
+            message: '💡 Try alternative search methods: `codemap_search_in_files(query: "...")` searches within file contents, or use regex with `useRegex: true` for pattern matching.',
+            check: (ctx) => ctx.totalMatches === 0
+        });
+        // Hint: Direct symbol reading
+        this.register({
+            id: 'symbol-direct-reading',
+            priority: 85,
+            message: '💡 Tip: You can read functions and constants directly by referencing symbols with `codemap_read_file(path: "file.ts$symbolName")` - no need to read the entire file!',
+            check: (ctx) => ctx.results.length > 0 && ctx.results.some(r => r.matchedSymbols && r.matchedSymbols.length > 0)
+        });
+        // Hint: Very few results - broaden search
+        this.register({
+            id: 'few-results-broaden',
+            priority: 50,
+            message: '💡 Only a few results found. Try broadening your search with wildcards (*) or switching to hybrid mode.',
+            check: (ctx) => ctx.totalMatches > 0 && ctx.totalMatches < 3
+        });
+        // Hint: Many results - narrow search
+        this.register({
+            id: 'many-results-narrow',
+            priority: 40,
+            message: '💡 Many results found. Consider narrowing your search with more specific keywords or using filters like `symbolKinds` or `pathPrefix`.',
+            check: (ctx) => ctx.totalMatches > 50
+        });
+    }
+}
+exports.HintRegistry = HintRegistry;
+//# sourceMappingURL=HintRegistry.js.map

package/dist/core/HintRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HintRegistry.js","sourceRoot":"","sources":["../../src/core/HintRegistry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiCH,MAAa,YAAY;IACf,KAAK,GAA+B,IAAI,GAAG,EAAE,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,IAAmB;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,OAAoB;QAC3B,MAAM,eAAe,GAAoB,EAAE,CAAC;QAE5C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAExD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,uCAAuC;QACvC,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,wBAAwB;YAC5B,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,gKAAgK;YACzK,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC;SACvC,CAAC,CAAC;QAEH,wCAAwC;QACxC,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,yBAAyB;YAC7B,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,oKAAoK;YAC7K,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC;SACvC,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,uBAAuB;YAC3B,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,sKAAsK;YAC/K,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;SACjH,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,qBAAqB;YACzB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,yGAAyG;YAClH,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC;SAC7D,CAAC,CAAC;QAEH,qCAAqC;QACrC,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,qBAAqB;YACzB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,wIAAwI;YACjJ,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AAhFD,oCAgFC"}

package/dist/core/LabelStore.d.ts

@@ -0,0 +1,88 @@
+/**
+ * LabelStore - Persistent storage for code labels
+ *
+ * Manages loading and saving labels and assignments to `.codemap/labels.json`.
+ * Handles file I/O, validation, and persistence for the labeling system.
+ *
+ * Labels allow organizing files, directories, and symbols with emoji-tagged metadata.
+ * All data persists through reboots via the labels.json file.
+ */
+import type { FileSystemProvider } from '../types/contracts/FileSystemProvider';
+import type { Label, LabelTargetType, CreateLabelResult, EditLabelResult, AssignLabelResult, UnassignLabelResult, MigrateLabelResult, DeleteLabelResult, LabelListResult, LabelDetailResult, LabelSearchResult } from '../types/label';
+import type { BackupManager } from './BackupManager';
+export declare class LabelStore {
+    private rootPath;
+    private provider;
+    private labelsPath;
+    private data;
+    private backupManager;
+    constructor(rootPath: string, provider: FileSystemProvider, backupManager?: BackupManager);
+    /**
+     * Load labels from disk.
+     * Creates file with empty data if it doesn't exist.
+     */
+    load(): Promise<void>;
+    /**
+     * Save labels to disk (with backup).
+     */
+    private save;
+    /**
+     * Create a new label.
+     */
+    create(emoji: string, name: string, description: string, bgColor?: string, fgColor?: string): Promise<CreateLabelResult>;
+    /**
+     * Edit an existing label.
+     */
+    edit(id: string, updates: {
+        emoji?: string;
+        name?: string;
+        description?: string;
+        bgColor?: string;
+        fgColor?: string;
+    }): Promise<EditLabelResult>;
+    /**
+     * Assign label(s) to target(s).
+     * Supports wildcards and batch operations.
+     */
+    assign(labelIds: string | string[], targets: string | string[], targetType?: LabelTargetType, recursive?: boolean): Promise<AssignLabelResult>;
+    /**
+     * Generate unique label ID from name.
+     * Format: lbl_slugified_name_timestamp
+     */
+    private generateLabelId;
+    /**
+     * Detect target type from path format.
+     */
+    private detectTargetType;
+    /**
+     * Expand wildcard patterns into concrete targets.
+     * For now, returns targets as-is (wildcard expansion requires file system scan).
+     */
+    private expandTargets;
+    /**
+     * Unassign label(s) from target(s).
+     * Supports wildcards and batch operations.
+     */
+    unassign(labelIds: string | string[] | undefined, targets: string | string[]): Promise<UnassignLabelResult>;
+    /**
+     * Migrate assignments from one label to another.
+     */
+    migrate(fromLabelId: string, toLabelId: string, targetPattern?: string | string[]): Promise<MigrateLabelResult>;
+    /**
+     * Delete a label.
+     */
+    delete(id: string, force?: boolean): Promise<DeleteLabelResult>;
+    /**
+     * List all labels with pagination.
+     */
+    list(id?: string, page?: number, pageSize?: number, _includeAssignments?: boolean): Promise<LabelListResult | LabelDetailResult>;
+    /**
+     * Search for labeled entities.
+     */
+    search(labelIds?: string | string[], targetPattern?: string, targetType?: LabelTargetType, page?: number, pageSize?: number): Promise<LabelSearchResult>;
+    /**
+     * Get labels for a specific target.
+     */
+    getLabelsForTarget(target: string): Promise<Label[]>;
+}
+//# sourceMappingURL=LabelStore.d.ts.map

package/dist/core/LabelStore.d.ts.map

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