obsidian-accomplishments-mcp 0.1.9 → 0.1.11

package/dist/services/v2/archive-manager.js

@@ -0,0 +1,281 @@
+/**
+ * V2 Archive Manager
+ *
+ * Handles archive and restore operations for entities.
+ * Archives are organized by entity type in a flat structure: archive/{type}/
+ * Supports reading from legacy quarter-based structure for backwards compatibility.
+ */
+// =============================================================================
+// Archive Manager Class
+// =============================================================================
+/**
+ * Manages entity archival and restoration.
+ */
+export class ArchiveManager {
+    basePath;
+    // Callbacks for external dependencies
+    getEntity = () => undefined;
+    getChildren = () => [];
+    moveFile = async () => { };
+    getEntityPath = () => undefined;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    setEntityCallback(fn) {
+        this.getEntity = fn;
+    }
+    setChildrenCallback(fn) {
+        this.getChildren = fn;
+    }
+    setMoveFileCallback(fn) {
+        this.moveFile = fn;
+    }
+    setEntityPathCallback(fn) {
+        this.getEntityPath = fn;
+    }
+    // ---------------------------------------------------------------------------
+    // Archive Operations
+    // ---------------------------------------------------------------------------
+    /** Archive a milestone and all its children */
+    async archiveMilestone(milestoneId) {
+        const milestone = this.getEntity(milestoneId);
+        if (!milestone || milestone.type !== 'milestone') {
+            throw new Error(`Milestone not found: ${milestoneId}`);
+        }
+        if (milestone.status !== 'Completed') {
+            throw new Error(`Cannot archive incomplete milestone: ${milestoneId}`);
+        }
+        const archived = [];
+        const timestamp = new Date().toISOString();
+        // Archive stories and their tasks (each to their type-specific archive folder)
+        const stories = this.getChildren(milestoneId, 'story');
+        for (const story of stories) {
+            const tasks = this.getChildren(story.id, 'task');
+            for (const task of tasks) {
+                await this.archiveEntity(task.id);
+                archived.push(task.id);
+            }
+            await this.archiveEntity(story.id);
+            archived.push(story.id);
+        }
+        // Archive related decisions and documents
+        const decisions = this.getChildren(milestoneId, 'decision');
+        for (const decision of decisions) {
+            await this.archiveEntity(decision.id);
+            archived.push(decision.id);
+        }
+        const documents = this.getChildren(milestoneId, 'document');
+        for (const doc of documents) {
+            await this.archiveEntity(doc.id);
+            archived.push(doc.id);
+        }
+        // Archive the milestone itself
+        await this.archiveEntity(milestoneId);
+        archived.push(milestoneId);
+        // Return the milestone archive path as the primary path
+        const archivePath = this.getArchivePathForType('milestone');
+        return {
+            archived_entities: archived,
+            archive_path: archivePath,
+            timestamp,
+        };
+    }
+    /** Archive a single entity to the flat archive structure: archive/{type}/ */
+    async archiveEntity(entityId, archivePath) {
+        const entity = this.getEntity(entityId);
+        if (!entity) {
+            throw new Error(`Entity not found: ${entityId}`);
+        }
+        const originalPath = this.getEntityPath(entityId);
+        if (!originalPath) {
+            throw new Error(`Entity path not found: ${entityId}`);
+        }
+        // Use flat archive structure: archive/{type}/
+        const targetPath = archivePath || this.getArchivePathForType(entity.type);
+        const newPath = `${targetPath}/${this.getFilename(entity)}`;
+        await this.moveFile(originalPath, newPath);
+        return {
+            entity_id: entityId,
+            entity_type: entity.type,
+            archived_at: new Date().toISOString(),
+            archive_path: newPath,
+            original_path: originalPath,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Restore Operations
+    // ---------------------------------------------------------------------------
+    /** Restore an entity from archive */
+    async restoreFromArchive(entityId, archivePath) {
+        const entity = this.getEntity(entityId);
+        if (!entity) {
+            throw new Error(`Entity not found in archive: ${entityId}`);
+        }
+        const restored = [];
+        const timestamp = new Date().toISOString();
+        // Determine restore path based on entity type
+        const restorePath = this.getRestorePath(entity);
+        // If milestone, restore all children first
+        if (entity.type === 'milestone') {
+            const stories = this.getChildren(entityId, 'story');
+            for (const story of stories) {
+                const tasks = this.getChildren(story.id, 'task');
+                for (const task of tasks) {
+                    await this.restoreEntity(task.id, archivePath);
+                    restored.push(task.id);
+                }
+                await this.restoreEntity(story.id, archivePath);
+                restored.push(story.id);
+            }
+        }
+        // Restore the entity itself
+        await this.restoreEntity(entityId, archivePath);
+        restored.push(entityId);
+        return {
+            restored_entities: restored,
+            restore_path: restorePath,
+            timestamp,
+        };
+    }
+    /** Restore a single entity */
+    async restoreEntity(entityId, archivePath) {
+        const entity = this.getEntity(entityId);
+        if (!entity) {
+            throw new Error(`Entity not found: ${entityId}`);
+        }
+        const currentPath = `${archivePath}/${this.getFilename(entity)}`;
+        const restorePath = this.getRestorePath(entity);
+        const newPath = `${restorePath}/${this.getFilename(entity)}`;
+        await this.moveFile(currentPath, newPath);
+    }
+    // ---------------------------------------------------------------------------
+    // Helper Methods
+    // ---------------------------------------------------------------------------
+    /**
+     * Get archive path for entity type using flat structure: archive/{type}/
+     * This is the new archive structure aligned with the Canvas Project Manager Plugin.
+     */
+    getArchivePathForType(type) {
+        return `${this.basePath}/archive/${type}`;
+    }
+    /**
+     * @deprecated Use getArchivePathForType instead.
+     * Get current quarter string (e.g., "2024-Q1") - kept for backwards compatibility
+     */
+    getQuarter(date) {
+        const year = date.getFullYear();
+        const quarter = Math.ceil((date.getMonth() + 1) / 3);
+        return `${year}-Q${quarter}`;
+    }
+    /**
+     * @deprecated Use getArchivePathForType instead.
+     * Get archive path for a quarter and optional milestone - kept for backwards compatibility
+     */
+    getLegacyArchivePath(quarter, milestoneId) {
+        const base = `${this.basePath}/archive/${quarter}`;
+        return milestoneId ? `${base}/${milestoneId}` : base;
+    }
+    /** Get restore path for an entity */
+    getRestorePath(entity) {
+        switch (entity.type) {
+            case 'milestone':
+                return `${this.basePath}/milestones`;
+            case 'story':
+                return `${this.basePath}/stories`;
+            case 'task':
+                return `${this.basePath}/tasks`;
+            case 'decision':
+                return `${this.basePath}/decisions`;
+            case 'document':
+                return `${this.basePath}/documents`;
+            case 'feature':
+                return `${this.basePath}/features`;
+        }
+    }
+    /**
+     * Try to find an entity in the archive, checking both new flat structure
+     * and legacy quarter-based structure for backwards compatibility.
+     */
+    findInArchive(entityId, entityType) {
+        // First check new flat structure: archive/{type}/
+        const flatPath = `${this.getArchivePathForType(entityType)}`;
+        // If not found, check legacy quarter-based structure
+        // This would require file system scanning which is handled by the caller
+        // Return the flat path as the primary location
+        return flatPath;
+    }
+    /** Get filename for an entity */
+    getFilename(entity) {
+        const sanitizedTitle = entity.title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '');
+        return `${entity.id}-${sanitizedTitle}.md`;
+    }
+    /** Check if an entity is eligible for archival */
+    canArchive(entity) {
+        switch (entity.type) {
+            case 'milestone':
+                if (entity.status !== 'Completed') {
+                    return { eligible: false, reason: 'Milestone must be completed' };
+                }
+                break;
+            case 'story':
+                if (entity.status !== 'Completed') {
+                    return { eligible: false, reason: 'Story must be completed' };
+                }
+                break;
+            case 'task':
+                if (entity.status !== 'Completed') {
+                    return { eligible: false, reason: 'Task must be completed' };
+                }
+                break;
+            case 'decision':
+                if (entity.status !== 'Decided' && entity.status !== 'Superseded') {
+                    return { eligible: false, reason: 'Decision must be decided or superseded' };
+                }
+                break;
+            case 'document':
+                if (entity.status !== 'Approved' && entity.status !== 'Superseded') {
+                    return { eligible: false, reason: 'Document must be approved or superseded' };
+                }
+                break;
+        }
+        return { eligible: true };
+    }
+    /**
+     * @deprecated Use getArchivedEntitiesByType instead.
+     * List archived entities for a quarter (legacy structure)
+     */
+    getArchivedEntities(_quarter) {
+        // This would be implemented with actual file system scanning
+        // For now, return empty array as placeholder
+        return [];
+    }
+    /**
+     * List archived entities by type from the flat archive structure.
+     * This is the preferred method for the new archive structure.
+     */
+    getArchivedEntitiesByType(_type) {
+        // This would be implemented with actual file system scanning
+        // For now, return empty array as placeholder
+        return [];
+    }
+    /**
+     * Get all possible archive paths for an entity (both new and legacy structures).
+     * Useful for finding entities that may have been archived with either structure.
+     */
+    getPossibleArchivePaths(entityId, entityType) {
+        const paths = [];
+        // New flat structure: archive/{type}/
+        paths.push(this.getArchivePathForType(entityType));
+        // Legacy quarter-based structure: archive/{quarter}/ and archive/{quarter}/{milestone}/
+        // Would need to scan for existing quarters
+        // For now, just return the flat path
+        return paths;
+    }
+}
+//# sourceMappingURL=archive-manager.js.map

package/dist/services/v2/archive-manager.js.map

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

package/dist/services/v2/canvas-manager.d.ts

@@ -0,0 +1,155 @@
+/**
+ * V2 Canvas Manager
+ *
+ * Centralized service for managing Obsidian canvas files.
+ * Handles node and edge operations with atomic batch updates.
+ *
+ * Key features:
+ * - Atomic file writes (temp file + rename) to prevent corruption
+ * - Obsidian reload trigger to sync UI after file changes
+ */
+import type { EntityId, CanvasNode, CanvasPath, VaultPath } from '../../models/v2-types.js';
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface NodeDimensions {
+    width: number;
+    height: number;
+}
+export type CanvasOperation = {
+    type: 'add_node';
+    filePath: string;
+    position?: Position;
+    dimensions?: NodeDimensions;
+} | {
+    type: 'remove_node';
+    filePath: string;
+} | {
+    type: 'update_node_path';
+    oldPath: string;
+    newPath: string;
+} | {
+    type: 'add_edge';
+    fromFilePath: string;
+    toFilePath: string;
+} | {
+    type: 'remove_edge';
+    fromFilePath: string;
+    toFilePath: string;
+};
+export interface BatchResult {
+    success: boolean;
+    nodesAdded: number;
+    nodesRemoved: number;
+    nodesUpdated: number;
+    edgesAdded: number;
+    edgesRemoved: number;
+    errors: string[];
+}
+export interface LayoutConfig {
+    /** Horizontal spacing between dependency stages */
+    stageSpacing: number;
+    /** Vertical spacing between items in same lane */
+    itemSpacing: number;
+    /** Padding around lanes */
+    lanePadding: number;
+    /** Starting X position */
+    startX: number;
+    /** Starting Y position */
+    startY: number;
+}
+export interface WorkstreamLane {
+    name: string;
+    yStart: number;
+}
+export interface LayoutResult {
+    success: boolean;
+    nodesRepositioned: number;
+    errors: string[];
+}
+export declare class CanvasManager {
+    private vaultPath;
+    private defaultCanvas;
+    private entityPathResolver;
+    constructor(vaultPath: string, defaultCanvas: string, entityPathResolver: (entityId: EntityId) => Promise<VaultPath | null>);
+    private readCanvas;
+    private writeCanvas;
+    private findNodeByFile;
+    private generateNodeId;
+    private generateEdgeId;
+    /**
+     * Add a node to canvas for an entity file.
+     * Returns the node ID if successful.
+     */
+    addNode(filePath: VaultPath, canvasPath?: CanvasPath, position?: Position, dimensions?: NodeDimensions): Promise<string | null>;
+    /**
+     * Remove a node from canvas by file path.
+     * Also removes any edges connected to the node.
+     */
+    removeNode(filePath: VaultPath, canvasPath?: CanvasPath): Promise<boolean>;
+    /**
+     * Update a node's file path (used when files are moved/renamed).
+     */
+    updateNodePath(oldPath: VaultPath, newPath: VaultPath, canvasPath?: CanvasPath): Promise<boolean>;
+    /**
+     * Add an edge between two nodes (for dependencies).
+     * Returns the edge ID if successful.
+     */
+    addEdge(fromFilePath: VaultPath, toFilePath: VaultPath, canvasPath?: CanvasPath): Promise<string | null>;
+    /**
+     * Remove an edge between two nodes.
+     */
+    removeEdge(fromFilePath: VaultPath, toFilePath: VaultPath, canvasPath?: CanvasPath): Promise<boolean>;
+    /**
+     * Apply multiple operations atomically (single read/write).
+     */
+    batchUpdate(operations: CanvasOperation[], canvasPath?: CanvasPath): Promise<BatchResult>;
+    /**
+     * Get a node by entity file path.
+     */
+    getNodeByFilePath(filePath: VaultPath, canvasPath?: CanvasPath): Promise<CanvasNode | null>;
+    /**
+     * Get all file nodes from canvas.
+     */
+    getAllFileNodes(canvasPath?: CanvasPath): Promise<CanvasNode[]>;
+    /**
+     * Check if canvas file exists.
+     */
+    canvasExists(canvasPath?: CanvasPath): Promise<boolean>;
+    /**
+     * Auto-layout canvas nodes using dependency-driven horizontal flow with workstream lanes.
+     *
+     * Strategy:
+     * - X position = topological order (distance from root nodes based on edges)
+     * - Y position = workstream lane
+     *
+     * @param entityMetadataResolver - Function to get entity metadata (workstream, type) from file path
+     * @param canvasPath - Optional canvas path (uses default if not specified)
+     * @param config - Optional layout configuration
+     */
+    autoLayout(entityMetadataResolver: (filePath: string) => Promise<{
+        workstream?: string;
+        entityType?: string;
+    } | null>, canvasPath?: CanvasPath, config?: Partial<LayoutConfig>): Promise<LayoutResult>;
+    /**
+     * Calculate the topological depth of each node based on edges.
+     * Nodes with no incoming edges have depth 0.
+     * Depth = max(depth of all predecessors) + 1
+     */
+    private calculateNodeDepths;
+    /**
+     * Calculate Y positions for workstream lanes.
+     */
+    private calculateWorkstreamLanes;
+    /**
+     * Get the maximum number of nodes in any single column (depth level).
+     */
+    private getMaxNodesInColumn;
+    private calculateNextPosition;
+    /**
+     * Get dimensions for a specific entity type.
+     */
+    getDimensionsForType(entityType: string): NodeDimensions;
+}
+//# sourceMappingURL=canvas-manager.d.ts.map

package/dist/services/v2/canvas-manager.d.ts.map

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