claude-brain 0.15.2 → 0.17.0

package/src/vault/frontmatter.ts

@@ -1,264 +1,264 @@
-/**
- * Frontmatter Utilities
- * Utilities for parsing and validating YAML frontmatter in markdown files
- */
-
-import type { Frontmatter, ProjectStatus, ProgressStatus } from './types'
-
-export interface ValidationResult {
-  valid: boolean
-  missing: string[]
-  invalid: string[]
-}
-
-export class FrontmatterUtils {
-  /**
-   * Validate required frontmatter fields
-   */
-  static validateFrontmatter(
-    frontmatter: Frontmatter,
-    requiredFields: string[]
-  ): ValidationResult {
-    const missing = requiredFields.filter(
-      field => !(field in frontmatter) || frontmatter[field] === undefined
-    )
-    return {
-      valid: missing.length === 0,
-      missing,
-      invalid: []
-    }
-  }
-
-  /**
-   * Validate frontmatter against expected types
-   */
-  static validateTypes(
-    frontmatter: Frontmatter,
-    schema: Record<string, 'string' | 'number' | 'boolean' | 'array' | 'date'>
-  ): ValidationResult {
-    const invalid: string[] = []
-
-    for (const [field, expectedType] of Object.entries(schema)) {
-      const value = frontmatter[field]
-      if (value === undefined) continue
-
-      let isValid = true
-      switch (expectedType) {
-        case 'string':
-          isValid = typeof value === 'string'
-          break
-        case 'number':
-          isValid = typeof value === 'number'
-          break
-        case 'boolean':
-          isValid = typeof value === 'boolean'
-          break
-        case 'array':
-          isValid = Array.isArray(value)
-          break
-        case 'date':
-          isValid = typeof value === 'string' && !isNaN(Date.parse(value))
-          break
-      }
-
-      if (!isValid) {
-        invalid.push(`${field}: expected ${expectedType}`)
-      }
-    }
-
-    return {
-      valid: invalid.length === 0,
-      missing: [],
-      invalid
-    }
-  }
-
-  /**
-   * Extract project name from frontmatter
-   */
-  static getProject(frontmatter: Frontmatter): string | undefined {
-    return frontmatter.project
-  }
-
-  /**
-   * Extract status from frontmatter
-   */
-  static getStatus(frontmatter: Frontmatter): string | undefined {
-    return frontmatter.status
-  }
-
-  /**
-   * Check if status is a valid project status
-   */
-  static isValidProjectStatus(status: string): status is ProjectStatus {
-    return ['active', 'planning', 'archived'].includes(status)
-  }
-
-  /**
-   * Check if status is a valid progress status
-   */
-  static isValidProgressStatus(status: string): status is ProgressStatus {
-    return ['in-progress', 'blocked', 'completed'].includes(status)
-  }
-
-  /**
-   * Extract tags from frontmatter
-   */
-  static getTags(frontmatter: Frontmatter): string[] {
-    const tags = frontmatter.tags
-    if (Array.isArray(tags)) {
-      return tags.filter(tag => typeof tag === 'string')
-    }
-    return []
-  }
-
-  /**
-   * Extract tech stack from frontmatter
-   */
-  static getTechStack(frontmatter: Frontmatter): string[] {
-    const techStack = frontmatter.tech_stack
-    if (Array.isArray(techStack)) {
-      return techStack.filter(tech => typeof tech === 'string')
-    }
-    return []
-  }
-
-  /**
-   * Extract languages from frontmatter
-   */
-  static getLanguages(frontmatter: Frontmatter): string[] {
-    const languages = frontmatter.languages
-    if (Array.isArray(languages)) {
-      return languages.filter(lang => typeof lang === 'string')
-    }
-    return []
-  }
-
-  /**
-   * Extract frameworks from frontmatter
-   */
-  static getFrameworks(frontmatter: Frontmatter): string[] {
-    const frameworks = frontmatter.frameworks
-    if (Array.isArray(frameworks)) {
-      return frameworks.filter(fw => typeof fw === 'string')
-    }
-    return []
-  }
-
-  /**
-   * Extract date from frontmatter
-   */
-  static getDate(
-    frontmatter: Frontmatter,
-    field: string = 'updated'
-  ): Date | undefined {
-    const dateStr = frontmatter[field]
-    if (typeof dateStr === 'string') {
-      const date = new Date(dateStr)
-      return isNaN(date.getTime()) ? undefined : date
-    }
-    return undefined
-  }
-
-  /**
-   * Get the document type from frontmatter
-   */
-  static getType(frontmatter: Frontmatter): string | undefined {
-    return frontmatter.type
-  }
-
-  /**
-   * Check if frontmatter indicates a specific document type
-   */
-  static isType(frontmatter: Frontmatter, type: string): boolean {
-    return frontmatter.type === type
-  }
-
-  /**
-   * Get completion percentage from progress frontmatter
-   */
-  static getCompletionPercentage(frontmatter: Frontmatter): number {
-    const percentage = frontmatter.completion_percentage
-    if (typeof percentage === 'number' && percentage >= 0 && percentage <= 100) {
-      return percentage
-    }
-    return 0
-  }
-
-  /**
-   * Get current phase from progress frontmatter
-   */
-  static getCurrentPhase(frontmatter: Frontmatter): string | undefined {
-    return frontmatter.current_phase
-  }
-
-  /**
-   * Get decision count from decisions frontmatter
-   */
-  static getDecisionCount(frontmatter: Frontmatter): number {
-    const count = frontmatter.decision_count
-    return typeof count === 'number' && count >= 0 ? count : 0
-  }
-
-  /**
-   * Create default frontmatter for a document type
-   */
-  static createDefaultFrontmatter(
-    type: string,
-    projectName: string
-  ): Frontmatter {
-    const today = new Date().toISOString().split('T')[0]
-    const base: Frontmatter = {
-      type,
-      project: projectName,
-      created: today,
-      updated: today
-    }
-
-    switch (type) {
-      case 'project-context':
-        return {
-          ...base,
-          status: 'planning',
-          tech_stack: [],
-          tags: []
-        }
-      case 'decision-log':
-        return {
-          ...base,
-          decision_count: 0,
-          last_updated: today
-        }
-      case 'progress-tracker':
-        return {
-          ...base,
-          status: 'in-progress',
-          current_phase: 'setup',
-          completion_percentage: 0,
-          last_updated: today
-        }
-      case 'coding-standards':
-        return {
-          ...base,
-          languages: [],
-          frameworks: [],
-          last_updated: today
-        }
-      default:
-        return base
-    }
-  }
-
-  /**
-   * Merge frontmatter with updates, preserving existing fields
-   */
-  static mergeFrontmatter(
-    existing: Frontmatter,
-    updates: Partial<Frontmatter>
-  ): Frontmatter {
-    const merged = { ...existing, ...updates }
-    // Always update the 'updated' timestamp
-    merged.updated = new Date().toISOString().split('T')[0]
-    return merged
-  }
-}
+/**
+ * Frontmatter Utilities
+ * Utilities for parsing and validating YAML frontmatter in markdown files
+ */
+
+import type { Frontmatter, ProjectStatus, ProgressStatus } from './types'
+
+export interface ValidationResult {
+  valid: boolean
+  missing: string[]
+  invalid: string[]
+}
+
+export class FrontmatterUtils {
+  /**
+   * Validate required frontmatter fields
+   */
+  static validateFrontmatter(
+    frontmatter: Frontmatter,
+    requiredFields: string[]
+  ): ValidationResult {
+    const missing = requiredFields.filter(
+      field => !(field in frontmatter) || frontmatter[field] === undefined
+    )
+    return {
+      valid: missing.length === 0,
+      missing,
+      invalid: []
+    }
+  }
+
+  /**
+   * Validate frontmatter against expected types
+   */
+  static validateTypes(
+    frontmatter: Frontmatter,
+    schema: Record<string, 'string' | 'number' | 'boolean' | 'array' | 'date'>
+  ): ValidationResult {
+    const invalid: string[] = []
+
+    for (const [field, expectedType] of Object.entries(schema)) {
+      const value = frontmatter[field]
+      if (value === undefined) continue
+
+      let isValid = true
+      switch (expectedType) {
+        case 'string':
+          isValid = typeof value === 'string'
+          break
+        case 'number':
+          isValid = typeof value === 'number'
+          break
+        case 'boolean':
+          isValid = typeof value === 'boolean'
+          break
+        case 'array':
+          isValid = Array.isArray(value)
+          break
+        case 'date':
+          isValid = typeof value === 'string' && !isNaN(Date.parse(value))
+          break
+      }
+
+      if (!isValid) {
+        invalid.push(`${field}: expected ${expectedType}`)
+      }
+    }
+
+    return {
+      valid: invalid.length === 0,
+      missing: [],
+      invalid
+    }
+  }
+
+  /**
+   * Extract project name from frontmatter
+   */
+  static getProject(frontmatter: Frontmatter): string | undefined {
+    return frontmatter.project
+  }
+
+  /**
+   * Extract status from frontmatter
+   */
+  static getStatus(frontmatter: Frontmatter): string | undefined {
+    return frontmatter.status
+  }
+
+  /**
+   * Check if status is a valid project status
+   */
+  static isValidProjectStatus(status: string): status is ProjectStatus {
+    return ['active', 'planning', 'archived'].includes(status)
+  }
+
+  /**
+   * Check if status is a valid progress status
+   */
+  static isValidProgressStatus(status: string): status is ProgressStatus {
+    return ['in-progress', 'blocked', 'completed'].includes(status)
+  }
+
+  /**
+   * Extract tags from frontmatter
+   */
+  static getTags(frontmatter: Frontmatter): string[] {
+    const tags = frontmatter.tags
+    if (Array.isArray(tags)) {
+      return tags.filter(tag => typeof tag === 'string')
+    }
+    return []
+  }
+
+  /**
+   * Extract tech stack from frontmatter
+   */
+  static getTechStack(frontmatter: Frontmatter): string[] {
+    const techStack = frontmatter.tech_stack
+    if (Array.isArray(techStack)) {
+      return techStack.filter(tech => typeof tech === 'string')
+    }
+    return []
+  }
+
+  /**
+   * Extract languages from frontmatter
+   */
+  static getLanguages(frontmatter: Frontmatter): string[] {
+    const languages = frontmatter.languages
+    if (Array.isArray(languages)) {
+      return languages.filter(lang => typeof lang === 'string')
+    }
+    return []
+  }
+
+  /**
+   * Extract frameworks from frontmatter
+   */
+  static getFrameworks(frontmatter: Frontmatter): string[] {
+    const frameworks = frontmatter.frameworks
+    if (Array.isArray(frameworks)) {
+      return frameworks.filter(fw => typeof fw === 'string')
+    }
+    return []
+  }
+
+  /**
+   * Extract date from frontmatter
+   */
+  static getDate(
+    frontmatter: Frontmatter,
+    field: string = 'updated'
+  ): Date | undefined {
+    const dateStr = frontmatter[field]
+    if (typeof dateStr === 'string') {
+      const date = new Date(dateStr)
+      return isNaN(date.getTime()) ? undefined : date
+    }
+    return undefined
+  }
+
+  /**
+   * Get the document type from frontmatter
+   */
+  static getType(frontmatter: Frontmatter): string | undefined {
+    return frontmatter.type
+  }
+
+  /**
+   * Check if frontmatter indicates a specific document type
+   */
+  static isType(frontmatter: Frontmatter, type: string): boolean {
+    return frontmatter.type === type
+  }
+
+  /**
+   * Get completion percentage from progress frontmatter
+   */
+  static getCompletionPercentage(frontmatter: Frontmatter): number {
+    const percentage = frontmatter.completion_percentage
+    if (typeof percentage === 'number' && percentage >= 0 && percentage <= 100) {
+      return percentage
+    }
+    return 0
+  }
+
+  /**
+   * Get current phase from progress frontmatter
+   */
+  static getCurrentPhase(frontmatter: Frontmatter): string | undefined {
+    return frontmatter.current_phase
+  }
+
+  /**
+   * Get decision count from decisions frontmatter
+   */
+  static getDecisionCount(frontmatter: Frontmatter): number {
+    const count = frontmatter.decision_count
+    return typeof count === 'number' && count >= 0 ? count : 0
+  }
+
+  /**
+   * Create default frontmatter for a document type
+   */
+  static createDefaultFrontmatter(
+    type: string,
+    projectName: string
+  ): Frontmatter {
+    const today = new Date().toISOString().split('T')[0]
+    const base: Frontmatter = {
+      type,
+      project: projectName,
+      created: today,
+      updated: today
+    }
+
+    switch (type) {
+      case 'project-context':
+        return {
+          ...base,
+          status: 'planning',
+          tech_stack: [],
+          tags: []
+        }
+      case 'decision-log':
+        return {
+          ...base,
+          decision_count: 0,
+          last_updated: today
+        }
+      case 'progress-tracker':
+        return {
+          ...base,
+          status: 'in-progress',
+          current_phase: 'setup',
+          completion_percentage: 0,
+          last_updated: today
+        }
+      case 'coding-standards':
+        return {
+          ...base,
+          languages: [],
+          frameworks: [],
+          last_updated: today
+        }
+      default:
+        return base
+    }
+  }
+
+  /**
+   * Merge frontmatter with updates, preserving existing fields
+   */
+  static mergeFrontmatter(
+    existing: Frontmatter,
+    updates: Partial<Frontmatter>
+  ): Frontmatter {
+    const merged = { ...existing, ...updates }
+    // Always update the 'updated' timestamp
+    merged.updated = new Date().toISOString().split('T')[0]
+    return merged
+  }
+}