obsidian-accomplishments-mcp 0.1.10 → 0.1.12

package/dist/services/v2/entity-serializer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * V2 Entity Serializer
+ *
+ * Serializes Entity objects to markdown files with YAML frontmatter.
+ */
+import { Entity } from '../../models/v2-types.js';
+export interface SerializeOptions {
+    /** Include content/body section */
+    includeContent?: boolean;
+    /** Pretty print YAML (default: true) */
+    prettyPrint?: boolean;
+    /** Fields to exclude from frontmatter */
+    excludeFields?: string[];
+}
+/**
+ * Serializes Entity objects to markdown with YAML frontmatter.
+ */
+export declare class EntitySerializer {
+    /** Serialize an Entity to markdown string */
+    serialize(entity: Entity, options?: SerializeOptions): string;
+    /** Convert entity to frontmatter object */
+    private entityToFrontmatter;
+    /** Get base frontmatter fields common to all entities */
+    private getBaseFrontmatter;
+    /** Get milestone-specific frontmatter */
+    private getMilestoneFrontmatter;
+    /** Get story-specific frontmatter */
+    private getStoryFrontmatter;
+    /** Get task-specific frontmatter */
+    private getTaskFrontmatter;
+    /** Get decision-specific frontmatter */
+    private getDecisionFrontmatter;
+    /** Get document-specific frontmatter */
+    private getDocumentFrontmatter;
+    /** Get feature-specific frontmatter */
+    private getFeatureFrontmatter;
+    /** Get content/body from entity */
+    private getEntityContent;
+    /** Build milestone content with objective and related queries */
+    private buildMilestoneContent;
+    /** Build story content with outcome and notes */
+    private buildStoryContent;
+    /** Build task content with description and notes */
+    private buildTaskContent;
+    /** Build decision content with context, decision, and rationale */
+    private buildDecisionContent;
+    /** Build document content */
+    private buildDocumentContent;
+    /** Build feature content */
+    private buildFeatureContent;
+    /** Build related section with Dataview queries for milestone/story/task */
+    private buildRelatedSection;
+    /** Build related section for decisions */
+    private buildDecisionRelatedSection;
+    /** Build related section for documents */
+    private buildDocumentRelatedSection;
+    /** Build related section for features */
+    private buildFeatureRelatedSection;
+    /** Convert object to YAML string */
+    private toYaml;
+    /** Convert a value to YAML representation */
+    private valueToYaml;
+    /** Convert array of objects to YAML */
+    private arrayOfObjectsToYaml;
+    /** Convert object to YAML */
+    private objectToYaml;
+    /** Check if string needs quoting */
+    private needsQuoting;
+    /** Escape string for YAML */
+    private escapeString;
+    /** Serialize inline tasks for frontmatter */
+    private serializeInlineTasks;
+    /** Remove undefined/null values from object */
+    private cleanObject;
+    /**
+     * Strip dataview blocks and their section headers from content.
+     * This prevents duplication when re-serializing entities.
+     *
+     * Removes:
+     * - Dataview code blocks (```dataview ... ```)
+     * - Section headers that precede dataview blocks (## 🔗 Implemented By, etc.)
+     */
+    private stripDataviewBlocks;
+}
+/**
+ * Generate CSS classes for visual differentiation on canvas.
+ *
+ * CSS classes control:
+ * - Border thickness: entity type (milestone=4px, story=2px, task=1px)
+ * - Border color: workstream type
+ * - Visual state: status indicators
+ */
+export declare function generateCssClasses(entity: Entity): string[];
+//# sourceMappingURL=entity-serializer.d.ts.map

package/dist/services/v2/entity-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-serializer.d.ts","sourceRoot":"","sources":["../../../src/services/v2/entity-serializer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EAQP,MAAM,0BAA0B,CAAC;AAMlC,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAK3B,6CAA6C;IAC7C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;IAoBjE,2CAA2C;IAC3C,OAAO,CAAC,mBAAmB;IAoC3B,yDAAyD;IACzD,OAAO,CAAC,kBAAkB;IAe1B,yCAAyC;IACzC,OAAO,CAAC,uBAAuB;IAgB/B,qCAAqC;IACrC,OAAO,CAAC,mBAAmB;IAgB3B,oCAAoC;IACpC,OAAO,CAAC,kBAAkB;IAe1B,wCAAwC;IACxC,OAAO,CAAC,sBAAsB;IAe9B,wCAAwC;IACxC,OAAO,CAAC,sBAAsB;IAkB9B,uCAAuC;IACvC,OAAO,CAAC,qBAAqB;IAkB7B,mCAAmC;IACnC,OAAO,CAAC,gBAAgB;IAiBxB,iEAAiE;IACjE,OAAO,CAAC,qBAAqB;IAa7B,iDAAiD;IACjD,OAAO,CAAC,iBAAiB;IAiBzB,oDAAoD;IACpD,OAAO,CAAC,gBAAgB;IAqBxB,mEAAmE;IACnE,OAAO,CAAC,oBAAoB;IAqB5B,6BAA6B;IAC7B,OAAO,CAAC,oBAAoB;IAiB5B,4BAA4B;IAC5B,OAAO,CAAC,mBAAmB;IAiB3B,2EAA2E;IAC3E,OAAO,CAAC,mBAAmB;IAwC3B,0CAA0C;IAC1C,OAAO,CAAC,2BAA2B;IAmBnC,0CAA0C;IAC1C,OAAO,CAAC,2BAA2B;IAoBnC,yCAAyC;IACzC,OAAO,CAAC,0BAA0B;IAiClC,oCAAoC;IACpC,OAAO,CAAC,MAAM;IAad,6CAA6C;IAC7C,OAAO,CAAC,WAAW;IAqCnB,uCAAuC;IACvC,OAAO,CAAC,oBAAoB;IAoB5B,6BAA6B;IAC7B,OAAO,CAAC,YAAY;IAYpB,oCAAoC;IACpC,OAAO,CAAC,YAAY;IAUpB,6BAA6B;IAC7B,OAAO,CAAC,YAAY;IAYpB,6CAA6C;IAC7C,OAAO,CAAC,oBAAoB;IAW5B,+CAA+C;IAC/C,OAAO,CAAC,WAAW;IAYnB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;CAqB5B;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB3D"}

package/dist/services/v2/entity-serializer.js

@@ -0,0 +1,583 @@
+/**
+ * V2 Entity Serializer
+ *
+ * Serializes Entity objects to markdown files with YAML frontmatter.
+ */
+// =============================================================================
+// Entity Serializer Class
+// =============================================================================
+/**
+ * Serializes Entity objects to markdown with YAML frontmatter.
+ */
+export class EntitySerializer {
+    // ---------------------------------------------------------------------------
+    // Main Serialize Method
+    // ---------------------------------------------------------------------------
+    /** Serialize an Entity to markdown string */
+    serialize(entity, options = {}) {
+        const { includeContent = true, excludeFields = [] } = options;
+        // Get frontmatter data based on entity type
+        const frontmatter = this.entityToFrontmatter(entity, excludeFields);
+        // Build YAML frontmatter
+        const yaml = this.toYaml(frontmatter);
+        // Get content/body
+        const content = includeContent ? this.getEntityContent(entity) : '';
+        // Combine frontmatter and content
+        return `---\n${yaml}---\n${content ? `\n${content}` : ''}`;
+    }
+    // ---------------------------------------------------------------------------
+    // Entity to Frontmatter Conversion
+    // ---------------------------------------------------------------------------
+    /** Convert entity to frontmatter object */
+    entityToFrontmatter(entity, excludeFields) {
+        const base = this.getBaseFrontmatter(entity);
+        let specific;
+        switch (entity.type) {
+            case 'milestone':
+                specific = this.getMilestoneFrontmatter(entity);
+                break;
+            case 'story':
+                specific = this.getStoryFrontmatter(entity);
+                break;
+            case 'task':
+                specific = this.getTaskFrontmatter(entity);
+                break;
+            case 'decision':
+                specific = this.getDecisionFrontmatter(entity);
+                break;
+            case 'document':
+                specific = this.getDocumentFrontmatter(entity);
+                break;
+            case 'feature':
+                specific = this.getFeatureFrontmatter(entity);
+                break;
+        }
+        const combined = { ...base, ...specific };
+        // Remove excluded fields
+        for (const field of excludeFields) {
+            delete combined[field];
+        }
+        // Remove undefined/null values
+        return this.cleanObject(combined);
+    }
+    /** Get base frontmatter fields common to all entities */
+    getBaseFrontmatter(entity) {
+        return {
+            id: entity.id,
+            type: entity.type,
+            title: entity.title,
+            workstream: entity.workstream,
+            status: entity.status,
+            archived: entity.archived || undefined,
+            canvas_source: entity.canvas_source || undefined,
+            cssclasses: entity.cssclasses?.length ? entity.cssclasses : undefined,
+            created_at: entity.created_at,
+            updated_at: entity.updated_at,
+        };
+    }
+    /** Get milestone-specific frontmatter */
+    getMilestoneFrontmatter(entity) {
+        return {
+            target_date: entity.target_date,
+            owner: entity.owner,
+            priority: entity.priority,
+            // Hierarchy
+            children: entity.children?.length ? entity.children : undefined,
+            // Dependencies
+            depends_on: entity.depends_on?.length ? entity.depends_on : undefined,
+            blocks: entity.blocks?.length ? entity.blocks : undefined,
+            // Implementation
+            implements: entity.implements?.length ? entity.implements : undefined,
+            success_criteria: entity.success_criteria?.length ? entity.success_criteria : undefined,
+        };
+    }
+    /** Get story-specific frontmatter */
+    getStoryFrontmatter(entity) {
+        return {
+            priority: entity.priority,
+            // Hierarchy
+            parent: entity.parent,
+            children: entity.children?.length ? entity.children : undefined,
+            // Dependencies
+            depends_on: entity.depends_on?.length ? entity.depends_on : undefined,
+            blocks: entity.blocks?.length ? entity.blocks : undefined,
+            // Implementation
+            implements: entity.implements?.length ? entity.implements : undefined,
+            acceptance_criteria: entity.acceptance_criteria?.length ? entity.acceptance_criteria : undefined,
+            tasks: entity.tasks?.length ? this.serializeInlineTasks(entity.tasks) : undefined,
+        };
+    }
+    /** Get task-specific frontmatter */
+    getTaskFrontmatter(entity) {
+        return {
+            // Hierarchy
+            parent: entity.parent,
+            // Dependencies
+            depends_on: entity.depends_on?.length ? entity.depends_on : undefined,
+            blocks: entity.blocks?.length ? entity.blocks : undefined,
+            // Task-specific
+            goal: entity.goal,
+            estimate_hrs: entity.estimate_hrs,
+            actual_hrs: entity.actual_hrs,
+            assignee: entity.assignee,
+        };
+    }
+    /** Get decision-specific frontmatter */
+    getDecisionFrontmatter(entity) {
+        return {
+            decided_by: entity.decided_by,
+            decided_on: entity.decided_on,
+            // Dependencies
+            depends_on: entity.depends_on?.length ? entity.depends_on : undefined,
+            // Entities affected by this decision (renamed from blocks)
+            affects: entity.affects?.length ? entity.affects : undefined,
+            // Supersession
+            supersedes: entity.supersedes,
+            superseded_by: entity.superseded_by,
+            alternatives: entity.alternatives?.length ? entity.alternatives : undefined,
+        };
+    }
+    /** Get document-specific frontmatter */
+    getDocumentFrontmatter(entity) {
+        return {
+            doc_type: entity.doc_type,
+            version: entity.version,
+            owner: entity.owner,
+            // Dependencies
+            depends_on: entity.depends_on?.length ? entity.depends_on : undefined,
+            blocks: entity.blocks?.length ? entity.blocks : undefined,
+            // Implementation
+            implemented_by: entity.implemented_by?.length ? entity.implemented_by : undefined,
+            // Feature relationships
+            documents: entity.documents?.length ? entity.documents : undefined,
+            // Versioning
+            previous_version: entity.previous_version,
+            next_version: entity.next_version,
+        };
+    }
+    /** Get feature-specific frontmatter */
+    getFeatureFrontmatter(entity) {
+        return {
+            user_story: entity.user_story,
+            tier: entity.tier,
+            phase: entity.phase,
+            // Relationships (auto-synced)
+            implemented_by: entity.implemented_by?.length ? entity.implemented_by : undefined,
+            documented_by: entity.documented_by?.length ? entity.documented_by : undefined,
+            decided_by: entity.decided_by?.length ? entity.decided_by : undefined,
+            // Test references
+            test_refs: entity.test_refs?.length ? entity.test_refs : undefined,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Content Extraction
+    // ---------------------------------------------------------------------------
+    /** Get content/body from entity */
+    getEntityContent(entity) {
+        switch (entity.type) {
+            case 'milestone':
+                return this.buildMilestoneContent(entity);
+            case 'story':
+                return this.buildStoryContent(entity);
+            case 'task':
+                return this.buildTaskContent(entity);
+            case 'decision':
+                return this.buildDecisionContent(entity);
+            case 'document':
+                return this.buildDocumentContent(entity);
+            case 'feature':
+                return this.buildFeatureContent(entity);
+        }
+    }
+    /** Build milestone content with objective and related queries */
+    buildMilestoneContent(entity) {
+        const sections = [];
+        if (entity.objective) {
+            sections.push(entity.objective);
+        }
+        // Add Dataview queries for related items
+        sections.push(this.buildRelatedSection(entity.id, 'milestone'));
+        return sections.join('\n\n');
+    }
+    /** Build story content with outcome and notes */
+    buildStoryContent(entity) {
+        const sections = [];
+        if (entity.outcome) {
+            sections.push(`## Outcome\n\n${entity.outcome}`);
+        }
+        if (entity.notes) {
+            sections.push(`## Notes\n\n${entity.notes}`);
+        }
+        // Add Dataview queries for related items
+        sections.push(this.buildRelatedSection(entity.id, 'story'));
+        return sections.join('\n\n');
+    }
+    /** Build task content with description and notes */
+    buildTaskContent(entity) {
+        const sections = [];
+        if (entity.description) {
+            sections.push(`## Description\n\n${entity.description}`);
+        }
+        if (entity.technical_notes) {
+            sections.push(`## Technical Notes\n\n${entity.technical_notes}`);
+        }
+        if (entity.notes) {
+            sections.push(`## Notes\n\n${entity.notes}`);
+        }
+        // Add Dataview queries for related items
+        sections.push(this.buildRelatedSection(entity.id, 'task'));
+        return sections.join('\n\n');
+    }
+    /** Build decision content with context, decision, and rationale */
+    buildDecisionContent(entity) {
+        const sections = [];
+        if (entity.context) {
+            sections.push(`## Context\n\n${entity.context}`);
+        }
+        if (entity.decision) {
+            sections.push(`## Decision\n\n${entity.decision}`);
+        }
+        if (entity.rationale) {
+            sections.push(`## Rationale\n\n${entity.rationale}`);
+        }
+        // Add Dataview query for entities this decision enables
+        sections.push(this.buildDecisionRelatedSection(entity.id));
+        return sections.join('\n\n');
+    }
+    /** Build document content */
+    buildDocumentContent(entity) {
+        const sections = [];
+        if (entity.content) {
+            // Strip existing dataview blocks to prevent duplication
+            const cleanContent = this.stripDataviewBlocks(entity.content);
+            if (cleanContent) {
+                sections.push(cleanContent);
+            }
+        }
+        // Add Dataview query for entities implementing this document
+        sections.push(this.buildDocumentRelatedSection(entity.id));
+        return sections.join('\n\n');
+    }
+    /** Build feature content */
+    buildFeatureContent(entity) {
+        const sections = [];
+        if (entity.content) {
+            // Strip existing dataview blocks to prevent duplication
+            const cleanContent = this.stripDataviewBlocks(entity.content);
+            if (cleanContent) {
+                sections.push(cleanContent);
+            }
+        }
+        // Add Dataview queries for related items
+        sections.push(this.buildFeatureRelatedSection(entity.id));
+        return sections.join('\n\n');
+    }
+    /** Build related section with Dataview queries for milestone/story/task */
+    buildRelatedSection(entityId, entityType) {
+        const sections = [];
+        // Documents this entity implements (milestone, story only)
+        if (entityType === 'milestone' || entityType === 'story') {
+            sections.push(`## 📄 Documents
+
+\`\`\`dataview
+TABLE title as "Document", document_type as "Type", version as "Version"
+FROM "documents"
+WHERE contains(this.implements, id)
+SORT title ASC
+\`\`\``);
+        }
+        // Decisions that enable this entity
+        sections.push(`## 🎯 Decisions
+
+\`\`\`dataview
+TABLE title as "Decision", status as "Status", decided_at as "Date"
+FROM "decisions"
+WHERE contains(enables, "${entityId}")
+SORT decided_at DESC
+\`\`\``);
+        // For tasks: also show decisions this task depends on
+        if (entityType === 'task') {
+            sections.push(`### Blocking Decisions
+
+\`\`\`dataview
+TABLE title as "Decision", status as "Status"
+FROM "decisions"
+WHERE contains(this.depends_on, id)
+SORT title ASC
+\`\`\``);
+        }
+        return sections.join('\n\n');
+    }
+    /** Build related section for decisions */
+    buildDecisionRelatedSection(decisionId) {
+        return `## 🔗 Enabled Entities
+
+\`\`\`dataview
+TABLE title as "Entity", type as "Type", status as "Status"
+WHERE contains(file.frontmatter.depends_on, "${decisionId}") OR contains(file.frontmatter.enabled_by, "${decisionId}")
+SORT type ASC, title ASC
+\`\`\`
+
+## 📄 Affected Documents
+
+\`\`\`dataview
+TABLE title as "Document", version as "Version"
+FROM "documents"
+WHERE contains(this.affects_documents, id)
+SORT title ASC
+\`\`\``;
+    }
+    /** Build related section for documents */
+    buildDocumentRelatedSection(documentId) {
+        return `## 🔗 Implemented By
+
+\`\`\`dataview
+TABLE title as "Entity", type as "Type", status as "Status"
+FROM ""
+WHERE contains(implements, "${documentId}")
+SORT type ASC, title ASC
+\`\`\`
+
+## 🎯 Related Decisions
+
+\`\`\`dataview
+TABLE title as "Decision", status as "Status", decided_at as "Date"
+FROM "decisions"
+WHERE contains(affects_documents, "${documentId}")
+SORT decided_at DESC
+\`\`\``;
+    }
+    /** Build related section for features */
+    buildFeatureRelatedSection(featureId) {
+        return `## 🔗 Implemented By
+
+\`\`\`dataview
+TABLE title as "Entity", type as "Type", status as "Status"
+FROM ""
+WHERE contains(implements, "${featureId}")
+SORT type ASC, title ASC
+\`\`\`
+
+## 📄 Documentation
+
+\`\`\`dataview
+TABLE title as "Document", doc_type as "Type", status as "Status"
+FROM "documents"
+WHERE contains(documents, "${featureId}")
+SORT title ASC
+\`\`\`
+
+## 🎯 Related Decisions
+
+\`\`\`dataview
+TABLE title as "Decision", status as "Status", decided_on as "Date"
+FROM "decisions"
+WHERE contains(affects, "${featureId}")
+SORT decided_on DESC
+\`\`\``;
+    }
+    // ---------------------------------------------------------------------------
+    // YAML Serialization
+    // ---------------------------------------------------------------------------
+    /** Convert object to YAML string */
+    toYaml(obj) {
+        const lines = [];
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === undefined || value === null)
+                continue;
+            const yamlValue = this.valueToYaml(value, 0);
+            lines.push(`${key}: ${yamlValue}`);
+        }
+        return lines.join('\n') + '\n';
+    }
+    /** Convert a value to YAML representation */
+    valueToYaml(value, indent) {
+        if (value === null || value === undefined) {
+            return 'null';
+        }
+        if (typeof value === 'string') {
+            // Check if string needs quoting
+            if (this.needsQuoting(value)) {
+                return `"${this.escapeString(value)}"`;
+            }
+            return value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return '[]';
+            // Check if array contains objects
+            if (typeof value[0] === 'object' && value[0] !== null) {
+                return this.arrayOfObjectsToYaml(value, indent);
+            }
+            // Simple array - inline format
+            const items = value.map(v => this.valueToYaml(v, indent));
+            return `[${items.join(', ')}]`;
+        }
+        if (typeof value === 'object') {
+            return this.objectToYaml(value, indent + 2);
+        }
+        return String(value);
+    }
+    /** Convert array of objects to YAML */
+    arrayOfObjectsToYaml(arr, indent) {
+        const lines = [''];
+        const pad = ' '.repeat(indent + 2);
+        for (const item of arr) {
+            const entries = Object.entries(item);
+            if (entries.length === 0)
+                continue;
+            const [firstKey, firstValue] = entries[0];
+            lines.push(`${pad}- ${firstKey}: ${this.valueToYaml(firstValue, indent + 4)}`);
+            for (let i = 1; i < entries.length; i++) {
+                const [key, val] = entries[i];
+                lines.push(`${pad}  ${key}: ${this.valueToYaml(val, indent + 4)}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /** Convert object to YAML */
+    objectToYaml(obj, indent) {
+        const lines = [''];
+        const pad = ' '.repeat(indent);
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === undefined || value === null)
+                continue;
+            lines.push(`${pad}${key}: ${this.valueToYaml(value, indent)}`);
+        }
+        return lines.join('\n');
+    }
+    /** Check if string needs quoting */
+    needsQuoting(str) {
+        // Quote if contains special characters or looks like other types
+        if (/^[\d.]+$/.test(str))
+            return true; // Looks like number
+        if (/^(true|false|null|yes|no|on|off)$/i.test(str))
+            return true;
+        if (/[:#\[\]{}|>&*!?,]/.test(str))
+            return true;
+        if (str.includes('\n'))
+            return true;
+        if (str.startsWith(' ') || str.endsWith(' '))
+            return true;
+        return false;
+    }
+    /** Escape string for YAML */
+    escapeString(str) {
+        return str
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\t/g, '\\t');
+    }
+    // ---------------------------------------------------------------------------
+    // Helper Methods
+    // ---------------------------------------------------------------------------
+    /** Serialize inline tasks for frontmatter */
+    serializeInlineTasks(tasks) {
+        return tasks.map(task => ({
+            number: task.number,
+            name: task.name,
+            goal: task.goal,
+            status: task.status,
+            estimate_hrs: task.estimate_hrs,
+            description: task.description,
+        }));
+    }
+    /** Remove undefined/null values from object */
+    cleanObject(obj) {
+        const cleaned = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (value !== undefined && value !== null) {
+                cleaned[key] = value;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Strip dataview blocks and their section headers from content.
+     * This prevents duplication when re-serializing entities.
+     *
+     * Removes:
+     * - Dataview code blocks (```dataview ... ```)
+     * - Section headers that precede dataview blocks (## 🔗 Implemented By, etc.)
+     */
+    stripDataviewBlocks(content) {
+        // Pattern to match section headers followed by dataview blocks
+        // Matches: ## Header\n\n```dataview...```
+        const sectionWithDataviewPattern = /^##\s+[^\n]+\n+```dataview[\s\S]*?```\n*/gm;
+        // Pattern to match standalone dataview blocks
+        const standaloneDataviewPattern = /```dataview[\s\S]*?```\n*/g;
+        let cleaned = content;
+        // First remove section headers with their dataview blocks
+        cleaned = cleaned.replace(sectionWithDataviewPattern, '');
+        // Then remove any remaining standalone dataview blocks
+        cleaned = cleaned.replace(standaloneDataviewPattern, '');
+        // Clean up excessive newlines
+        cleaned = cleaned.replace(/\n{3,}/g, '\n\n');
+        return cleaned.trim();
+    }
+}
+// =============================================================================
+// CSS Classes Generator
+// =============================================================================
+/**
+ * Generate CSS classes for visual differentiation on canvas.
+ *
+ * CSS classes control:
+ * - Border thickness: entity type (milestone=4px, story=2px, task=1px)
+ * - Border color: workstream type
+ * - Visual state: status indicators
+ */
+export function generateCssClasses(entity) {
+    const classes = [];
+    // Type class - controls border thickness and node size
+    classes.push(`canvas-${entity.type}`);
+    // Workstream class - controls border color
+    const workstream = getWorkstreamFromEntity(entity);
+    if (workstream) {
+        classes.push(`canvas-workstream-${normalizeForCss(workstream)}`);
+    }
+    // Status class - controls visual state (opacity, badges, etc.)
+    if (entity.status) {
+        classes.push(`canvas-status-${normalizeForCss(entity.status)}`);
+    }
+    // Priority class (optional, for milestones and stories)
+    const priority = getPriorityFromEntity(entity);
+    if (priority) {
+        classes.push(`canvas-priority-${normalizeForCss(priority)}`);
+    }
+    return classes;
+}
+/**
+ * Get workstream from entity for CSS class generation.
+ */
+function getWorkstreamFromEntity(entity) {
+    return entity.workstream || null;
+}
+/**
+ * Get priority from entity if applicable.
+ */
+function getPriorityFromEntity(entity) {
+    switch (entity.type) {
+        case 'milestone':
+            return entity.priority;
+        case 'story':
+            return entity.priority;
+        default:
+            return null;
+    }
+}
+/**
+ * Normalize a string for use in CSS class names.
+ * Converts to lowercase and replaces spaces with hyphens.
+ */
+function normalizeForCss(value) {
+    return value
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '');
+}
+//# sourceMappingURL=entity-serializer.js.map