obsidian-accomplishments-mcp 0.1.10 → 0.1.11

package/dist/services/v2/path-resolver.js

@@ -0,0 +1,174 @@
+/**
+ * V2 Path Resolver
+ *
+ * Resolves entity paths, archive paths, and file naming conventions.
+ */
+import * as path from 'path';
+import { getEntityTypeFromId, } from '../../models/v2-types.js';
+// =============================================================================
+// Path Constants
+// =============================================================================
+/** Folder names for each entity type */
+const TYPE_FOLDERS = {
+    milestone: 'milestones',
+    story: 'stories',
+    task: 'tasks',
+    decision: 'decisions',
+    document: 'documents',
+    feature: 'features',
+};
+/** Archive folder structure */
+const ARCHIVE_FOLDER = 'archive';
+// =============================================================================
+// Path Resolver Class
+// =============================================================================
+/**
+ * Resolves file paths for entities in the vault.
+ */
+export class PathResolver {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ---------------------------------------------------------------------------
+    // Entity Paths
+    // ---------------------------------------------------------------------------
+    /** Get folder path for entity type */
+    getTypeFolderPath(type) {
+        return path.join(this.config.entitiesFolder, TYPE_FOLDERS[type]);
+    }
+    /** Get absolute folder path for entity type */
+    getAbsoluteTypeFolderPath(type) {
+        return path.join(this.config.vaultPath, this.getTypeFolderPath(type));
+    }
+    /** Generate file path for entity */
+    getEntityPath(id, title) {
+        const type = getEntityTypeFromId(id);
+        if (!type)
+            throw new Error(`Invalid entity ID: ${id}`);
+        const folder = this.getTypeFolderPath(type);
+        const filename = this.generateFilename(id, title);
+        return path.join(folder, filename);
+    }
+    /** Get absolute file path for entity */
+    getAbsoluteEntityPath(id, title) {
+        return path.join(this.config.vaultPath, this.getEntityPath(id, title));
+    }
+    /** Generate filename from title (ID is stored in frontmatter, not filename) */
+    generateFilename(_id, title) {
+        const sanitized = this.sanitizeTitle(title);
+        return `${sanitized}.md`;
+    }
+    /** Sanitize title for use in filename */
+    sanitizeTitle(title) {
+        return title
+            .replace(/[<>:"/\\|?*]/g, '') // Remove invalid chars
+            .replace(/\s+/g, '_') // Replace spaces with underscores
+            .replace(/_+/g, '_') // Collapse multiple underscores
+            .replace(/^_|_$/g, '') // Trim leading/trailing underscores
+            .substring(0, 100); // Limit length
+    }
+    // ---------------------------------------------------------------------------
+    // Archive Paths
+    // ---------------------------------------------------------------------------
+    /** Get archive folder path for a date */
+    getArchiveFolderPath(date = new Date()) {
+        const year = date.getFullYear();
+        const quarter = Math.ceil((date.getMonth() + 1) / 3);
+        return path.join(this.config.archiveFolder, `${year}-Q${quarter}`);
+    }
+    /** Get absolute archive folder path */
+    getAbsoluteArchiveFolderPath(date = new Date()) {
+        return path.join(this.config.vaultPath, this.getArchiveFolderPath(date));
+    }
+    /** Get archive path for entity */
+    getArchivePath(id, title, date = new Date()) {
+        const archiveFolder = this.getArchiveFolderPath(date);
+        const filename = this.generateFilename(id, title);
+        return path.join(archiveFolder, filename);
+    }
+    /** Get absolute archive path for entity */
+    getAbsoluteArchivePath(id, title, date = new Date()) {
+        return path.join(this.config.vaultPath, this.getArchivePath(id, title, date));
+    }
+    // ---------------------------------------------------------------------------
+    // Path Parsing
+    // ---------------------------------------------------------------------------
+    /**
+     * Extract entity ID from file path.
+     * NOTE: Since IDs are no longer in filenames, this returns null.
+     * Use entity-parser to get ID from frontmatter instead.
+     * @deprecated IDs are stored in frontmatter, not filenames
+     */
+    extractIdFromPath(_filePath) {
+        // IDs are no longer in filenames - they're in frontmatter
+        // This method is kept for backward compatibility but always returns null
+        return null;
+    }
+    /** Check if path is in archive */
+    isArchivePath(filePath) {
+        return filePath.startsWith(this.config.archiveFolder);
+    }
+    /** Check if path is an entity file (based on folder location) */
+    isEntityPath(filePath) {
+        if (!filePath.endsWith('.md'))
+            return false;
+        // Check if file is in one of the entity folders
+        const type = this.getTypeFromPath(filePath);
+        return type !== null;
+    }
+    /** Get entity type from path */
+    getTypeFromPath(filePath) {
+        for (const [type, folder] of Object.entries(TYPE_FOLDERS)) {
+            if (filePath.includes(`/${folder}/`) || filePath.startsWith(`${folder}/`)) {
+                return type;
+            }
+        }
+        return null;
+    }
+    // ---------------------------------------------------------------------------
+    // Canvas Paths
+    // ---------------------------------------------------------------------------
+    /** Get canvas folder path */
+    getCanvasFolderPath() {
+        return this.config.canvasFolder;
+    }
+    /** Get absolute canvas folder path */
+    getAbsoluteCanvasFolderPath() {
+        return path.join(this.config.vaultPath, this.config.canvasFolder);
+    }
+    /** Check if path is a canvas file */
+    isCanvasPath(filePath) {
+        return filePath.endsWith('.canvas');
+    }
+    // ---------------------------------------------------------------------------
+    // Folder Utilities
+    // ---------------------------------------------------------------------------
+    /** Get all entity folder paths */
+    getAllEntityFolders() {
+        return Object.values(TYPE_FOLDERS).map(folder => path.join(this.config.entitiesFolder, folder));
+    }
+    /** Get all absolute entity folder paths */
+    getAllAbsoluteEntityFolders() {
+        return this.getAllEntityFolders().map(folder => path.join(this.config.vaultPath, folder));
+    }
+    /** Get config */
+    /** Convert absolute path to vault-relative path */
+    toVaultPath(absolutePath) {
+        if (absolutePath.startsWith(this.config.vaultPath)) {
+            return absolutePath.slice(this.config.vaultPath.length + 1);
+        }
+        return absolutePath;
+    }
+    /** Convert vault-relative path to absolute path */
+    toAbsolutePath(vaultPath) {
+        if (path.isAbsolute(vaultPath))
+            return vaultPath;
+        return path.join(this.config.vaultPath, vaultPath);
+    }
+    /** Get config */
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/services/v2/path-resolver.js.map

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

package/dist/services/v2/progress-computer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * V2 Progress Computer
+ *
+ * Computes progress metrics for entities based on their children's status.
+ */
+import { Entity, EntityId, EntityType } from '../../models/v2-types.js';
+export interface ProgressMetrics {
+    total: number;
+    completed: number;
+    in_progress: number;
+    not_started: number;
+    blocked: number;
+    percentage: number;
+}
+export interface EntityProgress {
+    entity_id: EntityId;
+    entity_type: EntityType;
+    direct_progress: ProgressMetrics;
+    nested_progress?: ProgressMetrics;
+}
+/**
+ * Computes progress metrics for entities.
+ */
+export declare class ProgressComputer {
+    private getEntity;
+    private getChildren;
+    setEntityCallback(fn: (id: EntityId) => Entity | undefined): void;
+    setChildrenCallback(fn: (id: EntityId, type?: EntityType) => Entity[]): void;
+    /** Compute progress for any entity */
+    computeProgress(entityId: EntityId): EntityProgress | undefined;
+    /** Compute progress for a milestone (stories and nested tasks) */
+    computeMilestoneProgress(milestoneId: EntityId): EntityProgress;
+    /** Compute progress for a story (tasks) */
+    computeStoryProgress(storyId: EntityId): EntityProgress;
+    /** Compute metrics for a list of entities (stories) */
+    private computeMetrics;
+    /** Compute metrics for a list of tasks */
+    private computeTaskMetrics;
+    /** Return empty metrics */
+    private emptyMetrics;
+    /** Check if an entity is complete based on its type */
+    isComplete(entity: Entity): boolean;
+    /** Get completion percentage as a formatted string */
+    formatProgress(progress: ProgressMetrics): string;
+}
+//# sourceMappingURL=progress-computer.d.ts.map

package/dist/services/v2/progress-computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-computer.d.ts","sourceRoot":"","sources":["../../../src/services/v2/progress-computer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EAIX,MAAM,0BAA0B,CAAC;AAMlC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,QAAQ,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,SAAS,CAAyD;IAC1E,OAAO,CAAC,WAAW,CAA2D;IAM9E,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI;IAIjE,mBAAmB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,MAAM,EAAE,GAAG,IAAI;IAQ5E,sCAAsC;IACtC,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IAkB/D,kEAAkE;IAClE,wBAAwB,CAAC,WAAW,EAAE,QAAQ,GAAG,cAAc;IAiD/D,2CAA2C;IAC3C,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,cAAc;IAevD,uDAAuD;IACvD,OAAO,CAAC,cAAc;IAkCtB,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB;IAkC1B,2BAA2B;IAC3B,OAAO,CAAC,YAAY;IAepB,uDAAuD;IACvD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAenC,sDAAsD;IACtD,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;CAGlD"}

package/dist/services/v2/progress-computer.js

@@ -0,0 +1,200 @@
+/**
+ * V2 Progress Computer
+ *
+ * Computes progress metrics for entities based on their children's status.
+ */
+// =============================================================================
+// Progress Computer Class
+// =============================================================================
+/**
+ * Computes progress metrics for entities.
+ */
+export class ProgressComputer {
+    // Callbacks for external dependencies
+    getEntity = () => undefined;
+    getChildren = () => [];
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    setEntityCallback(fn) {
+        this.getEntity = fn;
+    }
+    setChildrenCallback(fn) {
+        this.getChildren = fn;
+    }
+    // ---------------------------------------------------------------------------
+    // Progress Computation
+    // ---------------------------------------------------------------------------
+    /** Compute progress for any entity */
+    computeProgress(entityId) {
+        const entity = this.getEntity(entityId);
+        if (!entity)
+            return undefined;
+        switch (entity.type) {
+            case 'milestone':
+                return this.computeMilestoneProgress(entityId);
+            case 'story':
+                return this.computeStoryProgress(entityId);
+            default:
+                return {
+                    entity_id: entityId,
+                    entity_type: entity.type,
+                    direct_progress: this.emptyMetrics(),
+                };
+        }
+    }
+    /** Compute progress for a milestone (stories and nested tasks) */
+    computeMilestoneProgress(milestoneId) {
+        const stories = this.getChildren(milestoneId, 'story');
+        const directProgress = this.computeMetrics(stories);
+        // Compute nested task progress across all stories
+        let totalTasks = 0;
+        let completedTasks = 0;
+        let inProgressTasks = 0;
+        let notStartedTasks = 0;
+        let blockedTasks = 0;
+        for (const story of stories) {
+            const tasks = this.getChildren(story.id, 'task');
+            totalTasks += tasks.length;
+            for (const task of tasks) {
+                switch (task.status) {
+                    case 'Completed':
+                        completedTasks++;
+                        break;
+                    case 'In Progress':
+                        inProgressTasks++;
+                        break;
+                    case 'Not Started':
+                        notStartedTasks++;
+                        break;
+                    case 'Blocked':
+                        blockedTasks++;
+                        break;
+                }
+            }
+        }
+        const nestedProgress = {
+            total: totalTasks,
+            completed: completedTasks,
+            in_progress: inProgressTasks,
+            not_started: notStartedTasks,
+            blocked: blockedTasks,
+            percentage: totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0,
+        };
+        return {
+            entity_id: milestoneId,
+            entity_type: 'milestone',
+            direct_progress: directProgress,
+            nested_progress: nestedProgress,
+        };
+    }
+    /** Compute progress for a story (tasks) */
+    computeStoryProgress(storyId) {
+        const tasks = this.getChildren(storyId, 'task');
+        const directProgress = this.computeTaskMetrics(tasks);
+        return {
+            entity_id: storyId,
+            entity_type: 'story',
+            direct_progress: directProgress,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Helper Methods
+    // ---------------------------------------------------------------------------
+    /** Compute metrics for a list of entities (stories) */
+    computeMetrics(entities) {
+        const metrics = {
+            total: entities.length,
+            completed: 0,
+            in_progress: 0,
+            not_started: 0,
+            blocked: 0,
+            percentage: 0,
+        };
+        for (const entity of entities) {
+            switch (entity.status) {
+                case 'Completed':
+                    metrics.completed++;
+                    break;
+                case 'In Progress':
+                    metrics.in_progress++;
+                    break;
+                case 'Not Started':
+                    metrics.not_started++;
+                    break;
+                case 'Blocked':
+                    metrics.blocked++;
+                    break;
+            }
+        }
+        metrics.percentage = metrics.total > 0
+            ? Math.round((metrics.completed / metrics.total) * 100)
+            : 0;
+        return metrics;
+    }
+    /** Compute metrics for a list of tasks */
+    computeTaskMetrics(tasks) {
+        const metrics = {
+            total: tasks.length,
+            completed: 0,
+            in_progress: 0,
+            not_started: 0,
+            blocked: 0,
+            percentage: 0,
+        };
+        for (const task of tasks) {
+            switch (task.status) {
+                case 'Completed':
+                    metrics.completed++;
+                    break;
+                case 'In Progress':
+                    metrics.in_progress++;
+                    break;
+                case 'Not Started':
+                    metrics.not_started++;
+                    break;
+                case 'Blocked':
+                    metrics.blocked++;
+                    break;
+            }
+        }
+        metrics.percentage = metrics.total > 0
+            ? Math.round((metrics.completed / metrics.total) * 100)
+            : 0;
+        return metrics;
+    }
+    /** Return empty metrics */
+    emptyMetrics() {
+        return {
+            total: 0,
+            completed: 0,
+            in_progress: 0,
+            not_started: 0,
+            blocked: 0,
+            percentage: 0,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Utility Methods
+    // ---------------------------------------------------------------------------
+    /** Check if an entity is complete based on its type */
+    isComplete(entity) {
+        switch (entity.type) {
+            case 'milestone':
+            case 'story':
+            case 'task':
+                return entity.status === 'Completed';
+            case 'decision':
+                return entity.status === 'Decided' || entity.status === 'Superseded';
+            case 'document':
+                return entity.status === 'Approved' || entity.status === 'Superseded';
+            case 'feature':
+                return entity.status === 'Complete';
+        }
+    }
+    /** Get completion percentage as a formatted string */
+    formatProgress(progress) {
+        return `${progress.completed}/${progress.total} (${progress.percentage}%)`;
+    }
+}
+//# sourceMappingURL=progress-computer.js.map

package/dist/services/v2/progress-computer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-computer.js","sourceRoot":"","sources":["../../../src/services/v2/progress-computer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+BH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B,sCAAsC;IAC9B,SAAS,GAAyC,GAAG,EAAE,CAAC,SAAS,CAAC;IAClE,WAAW,GAAkD,GAAG,EAAE,CAAC,EAAE,CAAC;IAE9E,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,iBAAiB,CAAC,EAAwC;QACxD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,mBAAmB,CAAC,EAAiD;QACnE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,uBAAuB;IACvB,8EAA8E;IAE9E,sCAAsC;IACtC,eAAe,CAAC,QAAkB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;YACjD,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC7C;gBACE,OAAO;oBACL,SAAS,EAAE,QAAQ;oBACnB,WAAW,EAAE,MAAM,CAAC,IAAI;oBACxB,eAAe,EAAE,IAAI,CAAC,YAAY,EAAE;iBACrC,CAAC;QACN,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,wBAAwB,CAAC,WAAqB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAEpD,kDAAkD;QAClD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACjD,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpB,KAAK,WAAW;wBACd,cAAc,EAAE,CAAC;wBACjB,MAAM;oBACR,KAAK,aAAa;wBAChB,eAAe,EAAE,CAAC;wBAClB,MAAM;oBACR,KAAK,aAAa;wBAChB,eAAe,EAAE,CAAC;wBAClB,MAAM;oBACR,KAAK,SAAS;wBACZ,YAAY,EAAE,CAAC;wBACf,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAoB;YACtC,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,cAAc;YACzB,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SACjF,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,WAAW;YACtB,WAAW,EAAE,WAAW;YACxB,eAAe,EAAE,cAAc;YAC/B,eAAe,EAAE,cAAc;SAChC,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,oBAAoB,CAAC,OAAiB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAEtD,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,OAAO;YACpB,eAAe,EAAE,cAAc;SAChC,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAE9E,uDAAuD;IAC/C,cAAc,CAAC,QAAkB;QACvC,MAAM,OAAO,GAAoB;YAC/B,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,KAAK,WAAW;oBACd,OAAO,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM;gBACR,KAAK,aAAa;oBAChB,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM;gBACR,KAAK,aAAa;oBAChB,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM;gBACR,KAAK,SAAS;oBACZ,OAAO,CAAC,OAAO,EAAE,CAAC;oBAClB,MAAM;YACV,CAAC;QACH,CAAC;QAED,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;YACvD,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0CAA0C;IAClC,kBAAkB,CAAC,KAAe;QACxC,MAAM,OAAO,GAAoB;YAC/B,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,WAAW;oBACd,OAAO,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM;gBACR,KAAK,aAAa;oBAChB,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM;gBACR,KAAK,aAAa;oBAChB,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM;gBACR,KAAK,SAAS;oBACZ,OAAO,CAAC,OAAO,EAAE,CAAC;oBAClB,MAAM;YACV,CAAC;QACH,CAAC;QAED,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;YACvD,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,2BAA2B;IACnB,YAAY;QAClB,OAAO;YACL,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E,uDAAuD;IACvD,UAAU,CAAC,MAAc;QACvB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,WAAW,CAAC;YACjB,KAAK,OAAO,CAAC;YACb,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;YACvC,KAAK,UAAU;gBACb,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC;YACvE,KAAK,UAAU;gBACb,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC;YACxE,KAAK,SAAS;gBACZ,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC;QACxC,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,cAAc,CAAC,QAAyB;QACtC,OAAO,GAAG,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,UAAU,IAAI,CAAC;IAC7E,CAAC;CACF"}

package/dist/services/v2/search-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * V2 Search Service
+ *
+ * Provides token-based inverted index for full-text search across entities.
+ */
+import { EntityId } from '../../models/v2-types.js';
+/** Search result with relevance score */
+export interface SearchResult {
+    id: EntityId;
+    score: number;
+    matches: {
+        field: string;
+        positions: number[];
+    }[];
+}
+/** Search options */
+export interface SearchOptions {
+    /** Fields to search (default: all) */
+    fields?: ('title' | 'content' | 'tags')[];
+    /** Maximum results to return */
+    limit?: number;
+    /** Minimum score threshold */
+    minScore?: number;
+    /** Filter by entity type */
+    types?: string[];
+    /** Include archived entities */
+    includeArchived?: boolean;
+}
+/**
+ * Token-based inverted index for full-text search.
+ */
+export declare class SearchIndex {
+    /** Inverted index: token -> Set of entity IDs */
+    private titleIndex;
+    private contentIndex;
+    /** Document frequency for TF-IDF scoring */
+    private documentCount;
+    private tokenDocFreq;
+    /** Entity metadata cache for filtering */
+    private entityMeta;
+    /** Add or update entity in search index */
+    index(id: EntityId, title: string, content: string, type: string, archived: boolean): void;
+    /** Remove entity from search index */
+    remove(id: EntityId): void;
+    /** Clear all indexes */
+    clear(): void;
+    /** Search for entities matching query */
+    search(query: string, options?: SearchOptions): SearchResult[];
+    /** Tokenize text into searchable tokens */
+    private tokenize;
+    /** Add entity to token index */
+    private addToIndex;
+    /** Increment document frequency for token */
+    private incrementDocFreq;
+    /** Decrement document frequency for token */
+    private decrementDocFreq;
+    /** Calculate IDF (Inverse Document Frequency) for token */
+    private calculateIDF;
+    /** Add match info to results */
+    private addMatch;
+    /** Get index statistics */
+    getStats(): {
+        documentCount: number;
+        titleTokens: number;
+        contentTokens: number;
+    };
+}
+//# sourceMappingURL=search-service.d.ts.map

package/dist/services/v2/search-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-service.d.ts","sourceRoot":"","sources":["../../../src/services/v2/search-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,0BAA0B,CAAC;AAMpE,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,EAAE,CAAC;CACL;AAED,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1C,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,qBAAa,WAAW;IACtB,iDAAiD;IACjD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,YAAY,CAAyC;IAE7D,4CAA4C;IAC5C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAkC;IAEtD,0CAA0C;IAC1C,OAAO,CAAC,UAAU,CAAiE;IAMnF,2CAA2C;IAC3C,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAuB1F,sCAAsC;IACtC,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAuB1B,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAYb,yCAAyC;IACzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE;IAwDlE,2CAA2C;IAC3C,OAAO,CAAC,QAAQ;IAUhB,gCAAgC;IAChC,OAAO,CAAC,UAAU;IAMlB,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB;IAIxB,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB;IASxB,2DAA2D;IAC3D,OAAO,CAAC,YAAY;IAMpB,gCAAgC;IAChC,OAAO,CAAC,QAAQ;IAkBhB,2BAA2B;IAC3B,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAOlF"}