@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/generators/docs-init.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-init.js","sources":["../../src/generators/docs-init.ts"],"sourcesContent":["/**\n * Docs Directory Initializer\n *\n * Creates the initial docs directory structure following the weave-nn\n * methodology with proper PRIMITIVES.md taxonomy.\n */\n\nimport { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';\nimport { join, basename } from 'path';\nimport fg from 'fast-glob';\nimport Handlebars from 'handlebars';\nimport type {\n  DocsInitOptions,\n  DocsInitResult,\n  NodeType,\n} from '../core/types.js';\n\n/**\n * Default docs structure based on PRIMITIVES.md taxonomy\n */\nconst DEFAULT_STRUCTURE = {\n  directories: [\n    // Core concepts\n    'concepts',\n    'concepts/architecture',\n    'concepts/patterns',\n\n    // Components\n    'components',\n    'components/ui',\n    'components/utilities',\n\n    // Services\n    'services',\n    'services/api',\n    'services/workers',\n\n    // Features\n    'features',\n    'features/core',\n    'features/advanced',\n\n    // Integrations\n    'integrations',\n    'integrations/databases',\n    'integrations/auth-providers',\n    'integrations/storage',\n    'integrations/monitoring',\n\n    // Standards\n    'standards',\n    'standards/coding-standards',\n    'standards/programming-languages',\n    'standards/build-tools',\n\n    // Guides\n    'guides',\n    'guides/getting-started',\n    'guides/testing',\n    'guides/deployment',\n\n    // References\n    'references',\n    'references/api',\n    'references/cli',\n\n    // Meta\n    '_templates',\n    '_attachments',\n  ],\n  files: {\n    'README.md': 'readme',\n    'PRIMITIVES.md': 'primitives',\n    'MOC.md': 'moc',\n    '_templates/concept.md': 'template-concept',\n    '_templates/technical.md': 'template-technical',\n    '_templates/feature.md': 'template-feature',\n    '_templates/service.md': 'template-service',\n    '_templates/guide.md': 'template-guide',\n  },\n};\n\n/**\n * Template content for docs files\n */\nconst TEMPLATES: Record<string, string> = {\n  readme: `# {{projectName}} Documentation\n\nWelcome to the {{projectName}} knowledge base.\n\n## Quick Navigation\n\n- [[MOC|Map of Content]] - Overview of all documentation\n- [[PRIMITIVES|Primitives]] - Core building blocks and technologies\n\n## Structure\n\nThis documentation follows the Weave-NN knowledge graph methodology:\n\n\\`\\`\\`\ndocs/\n├── concepts/       # Abstract concepts and ideas\n├── components/     # Reusable components and utilities\n├── services/       # Backend services and APIs\n├── features/       # Product features and capabilities\n├── integrations/   # External integrations\n├── standards/      # Coding standards and conventions\n├── guides/         # How-to guides and tutorials\n└── references/     # API and CLI references\n\\`\\`\\`\n\n## Getting Started\n\n1. Browse the [[MOC|Map of Content]] for an overview\n2. Check [[PRIMITIVES]] for technology decisions\n3. Read [[guides/getting-started/index|Getting Started Guide]]\n\n---\n*Generated by @weave-nn/knowledge-graph-agent*\n`,\n\n  primitives: `# Primitives\n\nCore building blocks and technology decisions for {{projectName}}.\n\n## Overview\n\nPrimitives are the foundational technologies that power this project. Each primitive represents a key technology choice with its rationale and usage patterns.\n\n## Categories\n\n### Languages\n{{#each languages}}\n- [[standards/programming-languages/{{this}}|{{this}}]]\n{{/each}}\n\n### Frameworks\n{{#each frameworks}}\n- [[{{category}}/{{slug}}|{{name}}]]\n{{/each}}\n\n### Key Dependencies\n{{#each dependencies}}\n- [[{{category}}/{{slug}}|{{name}}]] - {{description}}\n{{/each}}\n\n## Technology Decisions\n\n| Category | Choice | Rationale |\n|----------|--------|-----------|\n| Runtime | Node.js | Modern JavaScript runtime |\n| Language | TypeScript | Type safety and DX |\n| Package Manager | npm/bun | Fast, reliable |\n\n---\n*Generated by @weave-nn/knowledge-graph-agent*\n`,\n\n  moc: `# Map of Content\n\nCentral navigation hub for {{projectName}} documentation.\n\n## Core Concepts\n{{#each concepts}}\n- [[concepts/{{this}}]]\n{{/each}}\n{{#unless concepts}}\n- *No concepts documented yet*\n{{/unless}}\n\n## Components\n{{#each components}}\n- [[components/{{this}}]]\n{{/each}}\n{{#unless components}}\n- *No components documented yet*\n{{/unless}}\n\n## Services\n{{#each services}}\n- [[services/{{this}}]]\n{{/each}}\n{{#unless services}}\n- *No services documented yet*\n{{/unless}}\n\n## Features\n{{#each features}}\n- [[features/{{this}}]]\n{{/each}}\n{{#unless features}}\n- *No features documented yet*\n{{/unless}}\n\n## Guides\n- [[guides/getting-started/index|Getting Started]]\n- [[guides/testing/index|Testing Guide]]\n- [[guides/deployment/index|Deployment Guide]]\n\n## References\n- [[references/api/index|API Reference]]\n- [[references/cli/index|CLI Reference]]\n\n---\n*Last updated: {{date}}*\n`,\n\n  'template-concept': `---\ntitle: {{title}}\ntype: concept\nstatus: draft\ntags: [concept]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this concept.\n\n## Key Ideas\n\n- Point 1\n- Point 2\n- Point 3\n\n## Related Concepts\n\n- [[related-concept-1]]\n- [[related-concept-2]]\n\n## References\n\n- External reference 1\n- External reference 2\n`,\n\n  'template-technical': `---\ntitle: {{title}}\ntype: technical\nstatus: draft\ntags: [technical]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this technical component.\n\n## Implementation\n\n\\`\\`\\`typescript\n// Code example\n\\`\\`\\`\n\n## Usage\n\nHow to use this component.\n\n## Configuration\n\nAvailable configuration options.\n\n## Related\n\n- [[related-technical-1]]\n`,\n\n  'template-feature': `---\ntitle: {{title}}\ntype: feature\nstatus: draft\ntags: [feature]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this feature.\n\n## User Story\n\nAs a [user type], I want [goal] so that [benefit].\n\n## Acceptance Criteria\n\n- [ ] Criterion 1\n- [ ] Criterion 2\n- [ ] Criterion 3\n\n## Technical Implementation\n\nHow this feature is implemented.\n\n## Related Features\n\n- [[related-feature-1]]\n`,\n\n  'template-service': `---\ntitle: {{title}}\ntype: service\nstatus: draft\ntags: [service, api]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this service.\n\n## Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/... | Description |\n| POST | /api/... | Description |\n\n## Configuration\n\nEnvironment variables and configuration options.\n\n## Dependencies\n\n- [[dependency-1]]\n- [[dependency-2]]\n\n## Deployment\n\nDeployment instructions.\n`,\n\n  'template-guide': `---\ntitle: {{title}}\ntype: guide\nstatus: draft\ntags: [guide, tutorial]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Prerequisites\n\n- Prerequisite 1\n- Prerequisite 2\n\n## Steps\n\n### Step 1: Title\n\nInstructions for step 1.\n\n### Step 2: Title\n\nInstructions for step 2.\n\n### Step 3: Title\n\nInstructions for step 3.\n\n## Troubleshooting\n\nCommon issues and solutions.\n\n## Next Steps\n\n- [[next-guide-1]]\n- [[next-guide-2]]\n`,\n};\n\n/**\n * Framework detection result\n */\ninterface FrameworkInfo {\n  name: string;\n  slug: string;\n  category: string;\n  version?: string;\n}\n\n/**\n * Initialize docs directory\n */\nexport async function initDocs(options: DocsInitOptions): Promise<DocsInitResult> {\n  const result: DocsInitResult = {\n    success: true,\n    docsPath: '',\n    filesCreated: [],\n    errors: [],\n  };\n\n  try {\n    const { projectRoot, docsPath = 'docs', includeExamples = true, detectFramework = true } = options;\n    const fullDocsPath = join(projectRoot, docsPath);\n    result.docsPath = fullDocsPath;\n\n    // Detect project information\n    const projectName = await detectProjectName(projectRoot);\n    const frameworks = detectFramework ? await detectFrameworks(projectRoot) : [];\n    const languages = detectFramework ? await detectLanguages(projectRoot) : [];\n    const dependencies = detectFramework ? await detectDependencies(projectRoot) : [];\n\n    // Create template context\n    const context = {\n      projectName,\n      date: new Date().toISOString().split('T')[0],\n      frameworks,\n      languages,\n      dependencies,\n      concepts: [],\n      components: [],\n      services: [],\n      features: [],\n    };\n\n    // Create directories\n    for (const dir of DEFAULT_STRUCTURE.directories) {\n      const dirPath = join(fullDocsPath, dir);\n      if (!existsSync(dirPath)) {\n        mkdirSync(dirPath, { recursive: true });\n        result.filesCreated.push(dirPath);\n      }\n    }\n\n    // Create files from templates\n    for (const [filePath, templateName] of Object.entries(DEFAULT_STRUCTURE.files)) {\n      const fullPath = join(fullDocsPath, filePath);\n\n      // Skip if file exists\n      if (existsSync(fullPath)) {\n        continue;\n      }\n\n      // Get template and compile\n      const template = TEMPLATES[templateName];\n      if (!template) {\n        result.errors.push(`Template not found: ${templateName}`);\n        continue;\n      }\n\n      try {\n        const compiled = Handlebars.compile(template);\n        const content = compiled(context);\n        writeFileSync(fullPath, content, 'utf-8');\n        result.filesCreated.push(fullPath);\n      } catch (error) {\n        result.errors.push(`Failed to create ${filePath}: ${error}`);\n      }\n    }\n\n    // Create example files if requested\n    if (includeExamples) {\n      await createExampleFiles(fullDocsPath, context, result);\n    }\n\n    // Create .obsidian folder for vault detection\n    const obsidianPath = join(fullDocsPath, '.obsidian');\n    if (!existsSync(obsidianPath)) {\n      mkdirSync(obsidianPath, { recursive: true });\n\n      // Create minimal app.json for Obsidian\n      const appJson = {\n        \"legacyEditor\": false,\n        \"livePreview\": true,\n      };\n      writeFileSync(join(obsidianPath, 'app.json'), JSON.stringify(appJson, null, 2));\n      result.filesCreated.push(obsidianPath);\n    }\n\n    result.success = result.errors.length === 0;\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Init failed: ${error}`);\n  }\n\n  return result;\n}\n\n/**\n * Detect project name from package.json or directory\n */\nasync function detectProjectName(projectRoot: string): Promise<string> {\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      if (pkg.name) {\n        // Remove scope if present\n        return pkg.name.replace(/^@[^/]+\\//, '');\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  // Fall back to directory name\n  return basename(projectRoot);\n}\n\n/**\n * Detect frameworks from project files\n */\nasync function detectFrameworks(projectRoot: string): Promise<FrameworkInfo[]> {\n  const frameworks: FrameworkInfo[] = [];\n\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n\n      // Framework detection patterns\n      const patterns: Array<{ name: string; packages: string[]; category: string }> = [\n        { name: 'React', packages: ['react'], category: 'components/ui' },\n        { name: 'Next.js', packages: ['next'], category: 'services/api' },\n        { name: 'Vue', packages: ['vue'], category: 'components/ui' },\n        { name: 'Express', packages: ['express'], category: 'services/api' },\n        { name: 'Fastify', packages: ['fastify'], category: 'services/api' },\n        { name: 'Prisma', packages: ['@prisma/client', 'prisma'], category: 'integrations/databases' },\n        { name: 'TypeORM', packages: ['typeorm'], category: 'integrations/databases' },\n        { name: 'Jest', packages: ['jest'], category: 'guides/testing' },\n        { name: 'Vitest', packages: ['vitest'], category: 'guides/testing' },\n        { name: 'Vite', packages: ['vite'], category: 'standards/build-tools' },\n        { name: 'Webpack', packages: ['webpack'], category: 'standards/build-tools' },\n      ];\n\n      for (const pattern of patterns) {\n        for (const pkg of pattern.packages) {\n          if (deps[pkg]) {\n            frameworks.push({\n              name: pattern.name,\n              slug: pattern.name.toLowerCase().replace(/[^a-z0-9]+/g, '-'),\n              category: pattern.category,\n              version: deps[pkg],\n            });\n            break;\n          }\n        }\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return frameworks;\n}\n\n/**\n * Detect programming languages used\n */\nasync function detectLanguages(projectRoot: string): Promise<string[]> {\n  const languages: Set<string> = new Set();\n\n  try {\n    // Check for TypeScript\n    if (existsSync(join(projectRoot, 'tsconfig.json'))) {\n      languages.add('typescript');\n    }\n\n    // Check for package.json (JavaScript/Node.js)\n    if (existsSync(join(projectRoot, 'package.json'))) {\n      languages.add('javascript');\n    }\n\n    // Check for Python\n    if (existsSync(join(projectRoot, 'requirements.txt')) ||\n        existsSync(join(projectRoot, 'pyproject.toml'))) {\n      languages.add('python');\n    }\n\n    // Check for Rust\n    if (existsSync(join(projectRoot, 'Cargo.toml'))) {\n      languages.add('rust');\n    }\n\n    // Check for Go\n    if (existsSync(join(projectRoot, 'go.mod'))) {\n      languages.add('go');\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return Array.from(languages);\n}\n\n/**\n * Detect major dependencies\n */\nasync function detectDependencies(projectRoot: string): Promise<Array<{ name: string; slug: string; category: string; description: string }>> {\n  const deps: Array<{ name: string; slug: string; category: string; description: string }> = [];\n\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      const allDeps = { ...pkg.dependencies };\n\n      // Top dependencies to document\n      const topDeps = Object.keys(allDeps).slice(0, 10);\n\n      for (const dep of topDeps) {\n        deps.push({\n          name: dep,\n          slug: dep.replace(/^@/, '').replace(/[^a-z0-9]+/g, '-'),\n          category: 'components/utilities',\n          description: `Version ${allDeps[dep]}`,\n        });\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return deps;\n}\n\n/**\n * Create example documentation files\n */\nasync function createExampleFiles(\n  docsPath: string,\n  context: Record<string, unknown>,\n  result: DocsInitResult\n): Promise<void> {\n  const examples = [\n    {\n      path: 'guides/getting-started/index.md',\n      content: `---\ntitle: Getting Started\ntype: guide\nstatus: active\ntags: [guide, getting-started]\ncreated: ${context.date}\nupdated: ${context.date}\n---\n\n# Getting Started with ${context.projectName}\n\nWelcome! This guide will help you get up and running.\n\n## Prerequisites\n\n- Node.js 20+\n- npm or bun\n\n## Installation\n\n\\`\\`\\`bash\nnpm install\n\\`\\`\\`\n\n## Quick Start\n\n1. Clone the repository\n2. Install dependencies\n3. Run the development server\n\n## Next Steps\n\n- Explore the [[MOC|Map of Content]]\n- Review [[PRIMITIVES|Technology Primitives]]\n`,\n    },\n    {\n      path: 'concepts/architecture/index.md',\n      content: `---\ntitle: Architecture Overview\ntype: concept\nstatus: active\ntags: [architecture, concept]\ncreated: ${context.date}\nupdated: ${context.date}\n---\n\n# Architecture Overview\n\nHigh-level architecture of ${context.projectName}.\n\n## System Diagram\n\n\\`\\`\\`\n┌──────────────┐     ┌──────────────┐\n│   Frontend   │────▶│   Backend    │\n└──────────────┘     └──────────────┘\n                            │\n                     ┌──────▼──────┐\n                     │   Database  │\n                     └─────────────┘\n\\`\\`\\`\n\n## Key Components\n\n- **Frontend**: User interface\n- **Backend**: API and business logic\n- **Database**: Data persistence\n\n## Design Principles\n\n1. Separation of concerns\n2. Single responsibility\n3. Dependency injection\n`,\n    },\n  ];\n\n  for (const example of examples) {\n    const fullPath = join(docsPath, example.path);\n    if (!existsSync(fullPath)) {\n      const dir = join(fullPath, '..');\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      writeFileSync(fullPath, example.content, 'utf-8');\n      result.filesCreated.push(fullPath);\n    }\n  }\n}\n\n/**\n * Check if docs directory exists\n */\nexport function docsExist(projectRoot: string, docsPath = 'docs'): boolean {\n  return existsSync(join(projectRoot, docsPath));\n}\n\n/**\n * Get docs path for a project\n */\nexport function getDocsPath(projectRoot: string): string | null {\n  const possiblePaths = ['docs', 'documentation', 'doc', 'wiki'];\n\n  for (const path of possiblePaths) {\n    const fullPath = join(projectRoot, path);\n    if (existsSync(fullPath)) {\n      return fullPath;\n    }\n  }\n\n  return null;\n}\n"],"names":["pkg"],"mappings":"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"}
+{"version":3,"file":"docs-init.js","sources":["../../src/generators/docs-init.ts"],"sourcesContent":["/**\n * Docs Directory Initializer\n *\n * Creates the initial docs directory structure following the weave-nn\n * methodology with proper PRIMITIVES.md taxonomy.\n *\n * SECURITY NOTES (Handlebars Templates):\n * - All templates use double-braces {{}} which HTML-escapes output\n * - Triple-braces {{{raw}}} are NOT used, preventing injection attacks\n * - Template variables come from internal sources (project analysis), not direct user input\n * - See: https://handlebarsjs.com/guide/#html-escaping\n */\n\nimport { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';\nimport { join, basename } from 'path';\nimport fg from 'fast-glob';\nimport Handlebars from 'handlebars';\nimport type {\n  DocsInitOptions,\n  DocsInitResult,\n  NodeType,\n} from '../core/types.js';\n\n/**\n * Default docs structure based on PRIMITIVES.md taxonomy\n */\nconst DEFAULT_STRUCTURE = {\n  directories: [\n    // Core concepts\n    'concepts',\n    'concepts/architecture',\n    'concepts/patterns',\n\n    // Components\n    'components',\n    'components/ui',\n    'components/utilities',\n\n    // Services\n    'services',\n    'services/api',\n    'services/workers',\n\n    // Features\n    'features',\n    'features/core',\n    'features/advanced',\n\n    // Integrations\n    'integrations',\n    'integrations/databases',\n    'integrations/auth-providers',\n    'integrations/storage',\n    'integrations/monitoring',\n\n    // Standards\n    'standards',\n    'standards/coding-standards',\n    'standards/programming-languages',\n    'standards/build-tools',\n\n    // Guides\n    'guides',\n    'guides/getting-started',\n    'guides/testing',\n    'guides/deployment',\n\n    // References\n    'references',\n    'references/api',\n    'references/cli',\n\n    // Meta\n    '_templates',\n    '_attachments',\n  ],\n  files: {\n    'README.md': 'readme',\n    'PRIMITIVES.md': 'primitives',\n    'MOC.md': 'moc',\n    '_templates/concept.md': 'template-concept',\n    '_templates/technical.md': 'template-technical',\n    '_templates/feature.md': 'template-feature',\n    '_templates/service.md': 'template-service',\n    '_templates/guide.md': 'template-guide',\n  },\n};\n\n/**\n * Template content for docs files\n */\nconst TEMPLATES: Record<string, string> = {\n  readme: `# {{projectName}} Documentation\n\nWelcome to the {{projectName}} knowledge base.\n\n## Quick Navigation\n\n- [[MOC|Map of Content]] - Overview of all documentation\n- [[PRIMITIVES|Primitives]] - Core building blocks and technologies\n\n## Structure\n\nThis documentation follows the Weave-NN knowledge graph methodology:\n\n\\`\\`\\`\ndocs/\n├── concepts/       # Abstract concepts and ideas\n├── components/     # Reusable components and utilities\n├── services/       # Backend services and APIs\n├── features/       # Product features and capabilities\n├── integrations/   # External integrations\n├── standards/      # Coding standards and conventions\n├── guides/         # How-to guides and tutorials\n└── references/     # API and CLI references\n\\`\\`\\`\n\n## Getting Started\n\n1. Browse the [[MOC|Map of Content]] for an overview\n2. Check [[PRIMITIVES]] for technology decisions\n3. Read [[guides/getting-started/index|Getting Started Guide]]\n\n---\n*Generated by @weave-nn/knowledge-graph-agent*\n`,\n\n  primitives: `# Primitives\n\nCore building blocks and technology decisions for {{projectName}}.\n\n## Overview\n\nPrimitives are the foundational technologies that power this project. Each primitive represents a key technology choice with its rationale and usage patterns.\n\n## Categories\n\n### Languages\n{{#each languages}}\n- [[standards/programming-languages/{{this}}|{{this}}]]\n{{/each}}\n\n### Frameworks\n{{#each frameworks}}\n- [[{{category}}/{{slug}}|{{name}}]]\n{{/each}}\n\n### Key Dependencies\n{{#each dependencies}}\n- [[{{category}}/{{slug}}|{{name}}]] - {{description}}\n{{/each}}\n\n## Technology Decisions\n\n| Category | Choice | Rationale |\n|----------|--------|-----------|\n| Runtime | Node.js | Modern JavaScript runtime |\n| Language | TypeScript | Type safety and DX |\n| Package Manager | npm/bun | Fast, reliable |\n\n---\n*Generated by @weave-nn/knowledge-graph-agent*\n`,\n\n  moc: `# Map of Content\n\nCentral navigation hub for {{projectName}} documentation.\n\n## Core Concepts\n{{#each concepts}}\n- [[concepts/{{this}}]]\n{{/each}}\n{{#unless concepts}}\n- *No concepts documented yet*\n{{/unless}}\n\n## Components\n{{#each components}}\n- [[components/{{this}}]]\n{{/each}}\n{{#unless components}}\n- *No components documented yet*\n{{/unless}}\n\n## Services\n{{#each services}}\n- [[services/{{this}}]]\n{{/each}}\n{{#unless services}}\n- *No services documented yet*\n{{/unless}}\n\n## Features\n{{#each features}}\n- [[features/{{this}}]]\n{{/each}}\n{{#unless features}}\n- *No features documented yet*\n{{/unless}}\n\n## Guides\n- [[guides/getting-started/index|Getting Started]]\n- [[guides/testing/index|Testing Guide]]\n- [[guides/deployment/index|Deployment Guide]]\n\n## References\n- [[references/api/index|API Reference]]\n- [[references/cli/index|CLI Reference]]\n\n---\n*Last updated: {{date}}*\n`,\n\n  'template-concept': `---\ntitle: {{title}}\ntype: concept\nstatus: draft\ntags: [concept]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this concept.\n\n## Key Ideas\n\n- Point 1\n- Point 2\n- Point 3\n\n## Related Concepts\n\n- [[related-concept-1]]\n- [[related-concept-2]]\n\n## References\n\n- External reference 1\n- External reference 2\n`,\n\n  'template-technical': `---\ntitle: {{title}}\ntype: technical\nstatus: draft\ntags: [technical]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this technical component.\n\n## Implementation\n\n\\`\\`\\`typescript\n// Code example\n\\`\\`\\`\n\n## Usage\n\nHow to use this component.\n\n## Configuration\n\nAvailable configuration options.\n\n## Related\n\n- [[related-technical-1]]\n`,\n\n  'template-feature': `---\ntitle: {{title}}\ntype: feature\nstatus: draft\ntags: [feature]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this feature.\n\n## User Story\n\nAs a [user type], I want [goal] so that [benefit].\n\n## Acceptance Criteria\n\n- [ ] Criterion 1\n- [ ] Criterion 2\n- [ ] Criterion 3\n\n## Technical Implementation\n\nHow this feature is implemented.\n\n## Related Features\n\n- [[related-feature-1]]\n`,\n\n  'template-service': `---\ntitle: {{title}}\ntype: service\nstatus: draft\ntags: [service, api]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Overview\n\nBrief description of this service.\n\n## Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/... | Description |\n| POST | /api/... | Description |\n\n## Configuration\n\nEnvironment variables and configuration options.\n\n## Dependencies\n\n- [[dependency-1]]\n- [[dependency-2]]\n\n## Deployment\n\nDeployment instructions.\n`,\n\n  'template-guide': `---\ntitle: {{title}}\ntype: guide\nstatus: draft\ntags: [guide, tutorial]\ncreated: {{date}}\nupdated: {{date}}\n---\n\n# {{title}}\n\n## Prerequisites\n\n- Prerequisite 1\n- Prerequisite 2\n\n## Steps\n\n### Step 1: Title\n\nInstructions for step 1.\n\n### Step 2: Title\n\nInstructions for step 2.\n\n### Step 3: Title\n\nInstructions for step 3.\n\n## Troubleshooting\n\nCommon issues and solutions.\n\n## Next Steps\n\n- [[next-guide-1]]\n- [[next-guide-2]]\n`,\n};\n\n/**\n * Framework detection result\n */\ninterface FrameworkInfo {\n  name: string;\n  slug: string;\n  category: string;\n  version?: string;\n}\n\n/**\n * Initialize docs directory\n */\nexport async function initDocs(options: DocsInitOptions): Promise<DocsInitResult> {\n  const result: DocsInitResult = {\n    success: true,\n    docsPath: '',\n    filesCreated: [],\n    errors: [],\n  };\n\n  try {\n    const { projectRoot, docsPath = 'docs', includeExamples = true, detectFramework = true } = options;\n    const fullDocsPath = join(projectRoot, docsPath);\n    result.docsPath = fullDocsPath;\n\n    // Detect project information\n    const projectName = await detectProjectName(projectRoot);\n    const frameworks = detectFramework ? await detectFrameworks(projectRoot) : [];\n    const languages = detectFramework ? await detectLanguages(projectRoot) : [];\n    const dependencies = detectFramework ? await detectDependencies(projectRoot) : [];\n\n    // Create template context\n    const context = {\n      projectName,\n      date: new Date().toISOString().split('T')[0],\n      frameworks,\n      languages,\n      dependencies,\n      concepts: [],\n      components: [],\n      services: [],\n      features: [],\n    };\n\n    // Create directories\n    for (const dir of DEFAULT_STRUCTURE.directories) {\n      const dirPath = join(fullDocsPath, dir);\n      if (!existsSync(dirPath)) {\n        mkdirSync(dirPath, { recursive: true });\n        result.filesCreated.push(dirPath);\n      }\n    }\n\n    // Create files from templates\n    for (const [filePath, templateName] of Object.entries(DEFAULT_STRUCTURE.files)) {\n      const fullPath = join(fullDocsPath, filePath);\n\n      // Skip if file exists\n      if (existsSync(fullPath)) {\n        continue;\n      }\n\n      // Get template and compile\n      const template = TEMPLATES[templateName];\n      if (!template) {\n        result.errors.push(`Template not found: ${templateName}`);\n        continue;\n      }\n\n      try {\n        const compiled = Handlebars.compile(template);\n        const content = compiled(context);\n        writeFileSync(fullPath, content, 'utf-8');\n        result.filesCreated.push(fullPath);\n      } catch (error) {\n        result.errors.push(`Failed to create ${filePath}: ${error}`);\n      }\n    }\n\n    // Create example files if requested\n    if (includeExamples) {\n      await createExampleFiles(fullDocsPath, context, result);\n    }\n\n    // Create .obsidian folder for vault detection\n    const obsidianPath = join(fullDocsPath, '.obsidian');\n    if (!existsSync(obsidianPath)) {\n      mkdirSync(obsidianPath, { recursive: true });\n\n      // Create minimal app.json for Obsidian\n      const appJson = {\n        \"legacyEditor\": false,\n        \"livePreview\": true,\n      };\n      writeFileSync(join(obsidianPath, 'app.json'), JSON.stringify(appJson, null, 2));\n      result.filesCreated.push(obsidianPath);\n    }\n\n    result.success = result.errors.length === 0;\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Init failed: ${error}`);\n  }\n\n  return result;\n}\n\n/**\n * Detect project name from package.json or directory\n */\nasync function detectProjectName(projectRoot: string): Promise<string> {\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      if (pkg.name) {\n        // Remove scope if present\n        return pkg.name.replace(/^@[^/]+\\//, '');\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  // Fall back to directory name\n  return basename(projectRoot);\n}\n\n/**\n * Detect frameworks from project files\n */\nasync function detectFrameworks(projectRoot: string): Promise<FrameworkInfo[]> {\n  const frameworks: FrameworkInfo[] = [];\n\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n\n      // Framework detection patterns\n      const patterns: Array<{ name: string; packages: string[]; category: string }> = [\n        { name: 'React', packages: ['react'], category: 'components/ui' },\n        { name: 'Next.js', packages: ['next'], category: 'services/api' },\n        { name: 'Vue', packages: ['vue'], category: 'components/ui' },\n        { name: 'Express', packages: ['express'], category: 'services/api' },\n        { name: 'Fastify', packages: ['fastify'], category: 'services/api' },\n        { name: 'Prisma', packages: ['@prisma/client', 'prisma'], category: 'integrations/databases' },\n        { name: 'TypeORM', packages: ['typeorm'], category: 'integrations/databases' },\n        { name: 'Jest', packages: ['jest'], category: 'guides/testing' },\n        { name: 'Vitest', packages: ['vitest'], category: 'guides/testing' },\n        { name: 'Vite', packages: ['vite'], category: 'standards/build-tools' },\n        { name: 'Webpack', packages: ['webpack'], category: 'standards/build-tools' },\n      ];\n\n      for (const pattern of patterns) {\n        for (const pkg of pattern.packages) {\n          if (deps[pkg]) {\n            frameworks.push({\n              name: pattern.name,\n              slug: pattern.name.toLowerCase().replace(/[^a-z0-9]+/g, '-'),\n              category: pattern.category,\n              version: deps[pkg],\n            });\n            break;\n          }\n        }\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return frameworks;\n}\n\n/**\n * Detect programming languages used\n */\nasync function detectLanguages(projectRoot: string): Promise<string[]> {\n  const languages: Set<string> = new Set();\n\n  try {\n    // Check for TypeScript\n    if (existsSync(join(projectRoot, 'tsconfig.json'))) {\n      languages.add('typescript');\n    }\n\n    // Check for package.json (JavaScript/Node.js)\n    if (existsSync(join(projectRoot, 'package.json'))) {\n      languages.add('javascript');\n    }\n\n    // Check for Python\n    if (existsSync(join(projectRoot, 'requirements.txt')) ||\n        existsSync(join(projectRoot, 'pyproject.toml'))) {\n      languages.add('python');\n    }\n\n    // Check for Rust\n    if (existsSync(join(projectRoot, 'Cargo.toml'))) {\n      languages.add('rust');\n    }\n\n    // Check for Go\n    if (existsSync(join(projectRoot, 'go.mod'))) {\n      languages.add('go');\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return Array.from(languages);\n}\n\n/**\n * Detect major dependencies\n */\nasync function detectDependencies(projectRoot: string): Promise<Array<{ name: string; slug: string; category: string; description: string }>> {\n  const deps: Array<{ name: string; slug: string; category: string; description: string }> = [];\n\n  try {\n    const pkgPath = join(projectRoot, 'package.json');\n    if (existsSync(pkgPath)) {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      const allDeps = { ...pkg.dependencies };\n\n      // Top dependencies to document\n      const topDeps = Object.keys(allDeps).slice(0, 10);\n\n      for (const dep of topDeps) {\n        deps.push({\n          name: dep,\n          slug: dep.replace(/^@/, '').replace(/[^a-z0-9]+/g, '-'),\n          category: 'components/utilities',\n          description: `Version ${allDeps[dep]}`,\n        });\n      }\n    }\n  } catch {\n    // Ignore errors\n  }\n\n  return deps;\n}\n\n/**\n * Create example documentation files\n */\nasync function createExampleFiles(\n  docsPath: string,\n  context: Record<string, unknown>,\n  result: DocsInitResult\n): Promise<void> {\n  const examples = [\n    {\n      path: 'guides/getting-started/index.md',\n      content: `---\ntitle: Getting Started\ntype: guide\nstatus: active\ntags: [guide, getting-started]\ncreated: ${context.date}\nupdated: ${context.date}\n---\n\n# Getting Started with ${context.projectName}\n\nWelcome! This guide will help you get up and running.\n\n## Prerequisites\n\n- Node.js 20+\n- npm or bun\n\n## Installation\n\n\\`\\`\\`bash\nnpm install\n\\`\\`\\`\n\n## Quick Start\n\n1. Clone the repository\n2. Install dependencies\n3. Run the development server\n\n## Next Steps\n\n- Explore the [[MOC|Map of Content]]\n- Review [[PRIMITIVES|Technology Primitives]]\n`,\n    },\n    {\n      path: 'concepts/architecture/index.md',\n      content: `---\ntitle: Architecture Overview\ntype: concept\nstatus: active\ntags: [architecture, concept]\ncreated: ${context.date}\nupdated: ${context.date}\n---\n\n# Architecture Overview\n\nHigh-level architecture of ${context.projectName}.\n\n## System Diagram\n\n\\`\\`\\`\n┌──────────────┐     ┌──────────────┐\n│   Frontend   │────▶│   Backend    │\n└──────────────┘     └──────────────┘\n                            │\n                     ┌──────▼──────┐\n                     │   Database  │\n                     └─────────────┘\n\\`\\`\\`\n\n## Key Components\n\n- **Frontend**: User interface\n- **Backend**: API and business logic\n- **Database**: Data persistence\n\n## Design Principles\n\n1. Separation of concerns\n2. Single responsibility\n3. Dependency injection\n`,\n    },\n  ];\n\n  for (const example of examples) {\n    const fullPath = join(docsPath, example.path);\n    if (!existsSync(fullPath)) {\n      const dir = join(fullPath, '..');\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      writeFileSync(fullPath, example.content, 'utf-8');\n      result.filesCreated.push(fullPath);\n    }\n  }\n}\n\n/**\n * Check if docs directory exists\n */\nexport function docsExist(projectRoot: string, docsPath = 'docs'): boolean {\n  return existsSync(join(projectRoot, docsPath));\n}\n\n/**\n * Get docs path for a project\n */\nexport function getDocsPath(projectRoot: string): string | null {\n  const possiblePaths = ['docs', 'documentation', 'doc', 'wiki'];\n\n  for (const path of possiblePaths) {\n    const fullPath = join(projectRoot, path);\n    if (existsSync(fullPath)) {\n      return fullPath;\n    }\n  }\n\n  return null;\n}\n"],"names":["pkg"],"mappings":"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"}

package/dist/health/checks.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Built-in Health Checks
+ *
+ * Provides pre-built health checks for common components.
+ *
+ * @module health/checks
+ */
+import type { ComponentHealth, HealthCheck } from './types.js';
+/**
+ * Create a health check for database file existence and size
+ *
+ * @param dbPath - Path to the database file
+ * @returns Health check for database
+ *
+ * @example
+ * ```typescript
+ * const check = createDatabaseCheck('/path/to/graph.db');
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createDatabaseCheck(dbPath: string): HealthCheck;
+/**
+ * Cache interface for health check
+ */
+interface CacheWithStats {
+    getStats: () => {
+        totalEntries: number;
+        hitRate: number;
+        hitCount?: number;
+        missCount?: number;
+        sizeBytes?: number;
+    };
+}
+/**
+ * Create a health check for cache status
+ *
+ * @param cache - Cache instance with getStats method
+ * @returns Health check for cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new ShadowCache({ projectRoot: '/project' });
+ * const check = createCacheCheck(cache);
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createCacheCheck(cache: CacheWithStats | null | undefined): HealthCheck;
+/**
+ * Create a health check for memory usage
+ *
+ * @param thresholdPercent - Heap usage percentage threshold (default: 90)
+ * @param warningThreshold - Heap usage percentage for degraded status (default: 75)
+ * @returns Health check for memory
+ *
+ * @example
+ * ```typescript
+ * const check = createMemoryCheck(85, 70);
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createMemoryCheck(thresholdPercent?: number, warningThreshold?: number): HealthCheck;
+/**
+ * Create a health check for disk/path accessibility
+ *
+ * @param path - Path to check
+ * @param name - Optional name for the check (default: 'disk')
+ * @returns Health check for disk
+ *
+ * @example
+ * ```typescript
+ * const check = createDiskCheck('/data/storage', 'data-storage');
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createDiskCheck(path: string, name?: string): HealthCheck;
+/**
+ * Create a health check for event loop lag
+ *
+ * @param warningMs - Lag threshold for degraded status (default: 100ms)
+ * @param criticalMs - Lag threshold for unhealthy status (default: 500ms)
+ * @returns Health check for event loop
+ *
+ * @example
+ * ```typescript
+ * const check = createEventLoopCheck(50, 200);
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createEventLoopCheck(warningMs?: number, criticalMs?: number): HealthCheck;
+/**
+ * Create a health check for external service connectivity
+ *
+ * @param serviceName - Name of the service
+ * @param checkFn - Async function that returns true if service is healthy
+ * @param timeoutMs - Timeout for the check (default: 5000ms)
+ * @returns Health check for external service
+ *
+ * @example
+ * ```typescript
+ * const check = createServiceCheck('redis', async () => {
+ *   await redis.ping();
+ *   return true;
+ * });
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createServiceCheck(serviceName: string, checkFn: () => Promise<boolean>, timeoutMs?: number): HealthCheck;
+/**
+ * Create a custom health check with a provided check function
+ *
+ * @param name - Check name
+ * @param checkFn - Async function that returns ComponentHealth
+ * @param options - Additional options
+ * @returns Health check
+ *
+ * @example
+ * ```typescript
+ * const check = createCustomCheck('my-check', async () => {
+ *   const result = await myService.check();
+ *   return {
+ *     name: 'my-check',
+ *     status: result.ok ? 'healthy' : 'unhealthy',
+ *     message: result.message,
+ *     lastCheck: new Date(),
+ *   };
+ * }, { critical: true, interval: 15000 });
+ * monitor.registerCheck(check);
+ * ```
+ */
+export declare function createCustomCheck(name: string, checkFn: () => Promise<ComponentHealth>, options?: {
+    critical?: boolean;
+    interval?: number;
+}): HealthCheck;
+export {};
+//# sourceMappingURL=checks.d.ts.map

package/dist/health/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/health/checks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA0C/D;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CA8CtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,SAAK,EACrB,gBAAgB,SAAK,GACpB,WAAW,CAsCb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,WAAW,CA0CxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,SAAM,EAAE,UAAU,SAAM,GAAG,WAAW,CAqCnF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,SAAS,SAAO,GACf,WAAW,CAmDb;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,EACvC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,WAAW,CAOb"}

package/dist/health/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Health Monitoring Module
+ *
+ * Provides system health monitoring, diagnostics, and alerting.
+ */
+/**
+ * Health status values
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+/**
+ * Component health information
+ */
+export interface ComponentHealth {
+    /** Component name */
+    name: string;
+    /** Health status */
+    status: HealthStatus;
+    /** Optional message */
+    message?: string;
+    /** Last check time */
+    lastCheck: Date;
+    /** Response time in milliseconds */
+    responseTime?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * System-wide health information
+ */
+export interface SystemHealth {
+    /** Overall status */
+    status: HealthStatus;
+    /** Component health details */
+    components: ComponentHealth[];
+    /** Check timestamp */
+    timestamp: Date;
+    /** System uptime in milliseconds */
+    uptime: number;
+}
+/**
+ * Memory metrics
+ */
+export interface MemoryMetrics {
+    /** Heap used in bytes */
+    heapUsed: number;
+    /** Heap total in bytes */
+    heapTotal: number;
+    /** RSS in bytes */
+    rss: number;
+    /** External memory in bytes */
+    external: number;
+    /** Array buffers in bytes */
+    arrayBuffers: number;
+}
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    /** CPU usage percentage */
+    cpuUsage?: number;
+    /** Memory metrics */
+    memory: MemoryMetrics;
+    /** Event loop lag in milliseconds */
+    eventLoopLag?: number;
+    /** Active handles count */
+    activeHandles?: number;
+    /** Active requests count */
+    activeRequests?: number;
+}
+/**
+ * Health check function
+ */
+export interface HealthCheck {
+    /** Check name */
+    name: string;
+    /** Check function */
+    check: () => Promise<ComponentHealth>;
+    /** Check interval in milliseconds */
+    interval?: number;
+    /** Critical component flag */
+    critical?: boolean;
+}
+/**
+ * Health monitor configuration
+ */
+export interface HealthMonitorConfig {
+    /** Check interval in milliseconds */
+    interval?: number;
+    /** Timeout for individual checks */
+    timeout?: number;
+    /** Enable automatic checks */
+    autoStart?: boolean;
+}
+/**
+ * Health Monitor for tracking system health
+ */
+export declare class HealthMonitor {
+    private checks;
+    private results;
+    private startTime;
+    private intervalId?;
+    private config;
+    constructor(config?: HealthMonitorConfig);
+    register(check: HealthCheck): void;
+    unregister(name: string): void;
+    check(): Promise<SystemHealth>;
+    getLastStatus(): SystemHealth;
+    getPerformanceMetrics(): PerformanceMetrics;
+    start(): void;
+    stop(): void;
+    private timeout;
+    private calculateOverallStatus;
+}
+export declare function createHealthMonitor(config?: HealthMonitorConfig): HealthMonitor;
+export declare function createDatabaseCheck(dbPath: string): HealthCheck;
+export declare function createCacheCheck(): HealthCheck;
+export declare function createMemoryCheck(thresholdMB?: number): HealthCheck;
+export declare function createDiskCheck(path: string): HealthCheck;
+//# sourceMappingURL=index.d.ts.map

package/dist/health/index.d.ts.map

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

package/dist/health/index.js

@@ -0,0 +1,191 @@
+class HealthMonitor {
+  checks = /* @__PURE__ */ new Map();
+  results = /* @__PURE__ */ new Map();
+  startTime = /* @__PURE__ */ new Date();
+  intervalId;
+  config;
+  constructor(config = {}) {
+    this.config = {
+      interval: config.interval || 6e4,
+      timeout: config.timeout || 5e3,
+      autoStart: config.autoStart ?? false
+    };
+    if (this.config.autoStart) {
+      this.start();
+    }
+  }
+  register(check) {
+    this.checks.set(check.name, check);
+  }
+  unregister(name) {
+    this.checks.delete(name);
+    this.results.delete(name);
+  }
+  async check() {
+    const components = [];
+    for (const [name, check] of this.checks) {
+      try {
+        const result = await Promise.race([
+          check.check(),
+          this.timeout(check.name)
+        ]);
+        this.results.set(name, result);
+        components.push(result);
+      } catch (error) {
+        const errorResult = {
+          name,
+          status: "unhealthy",
+          message: error instanceof Error ? error.message : String(error),
+          lastCheck: /* @__PURE__ */ new Date()
+        };
+        this.results.set(name, errorResult);
+        components.push(errorResult);
+      }
+    }
+    const status = this.calculateOverallStatus(components);
+    return {
+      status,
+      components,
+      timestamp: /* @__PURE__ */ new Date(),
+      uptime: Date.now() - this.startTime.getTime()
+    };
+  }
+  getLastStatus() {
+    const components = Array.from(this.results.values());
+    return {
+      status: this.calculateOverallStatus(components),
+      components,
+      timestamp: /* @__PURE__ */ new Date(),
+      uptime: Date.now() - this.startTime.getTime()
+    };
+  }
+  getPerformanceMetrics() {
+    const memoryUsage = process.memoryUsage();
+    return {
+      memory: {
+        heapUsed: memoryUsage.heapUsed,
+        heapTotal: memoryUsage.heapTotal,
+        rss: memoryUsage.rss,
+        external: memoryUsage.external,
+        arrayBuffers: memoryUsage.arrayBuffers
+      }
+    };
+  }
+  start() {
+    if (this.intervalId) return;
+    this.intervalId = setInterval(() => {
+      this.check().catch(() => {
+      });
+    }, this.config.interval);
+  }
+  stop() {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+      this.intervalId = void 0;
+    }
+  }
+  timeout(name) {
+    return new Promise((_, reject) => {
+      setTimeout(() => {
+        reject(new Error(`Health check timeout: ${name}`));
+      }, this.config.timeout);
+    });
+  }
+  calculateOverallStatus(components) {
+    if (components.length === 0) return "unknown";
+    const hasUnhealthy = components.some((c) => c.status === "unhealthy");
+    const hasDegraded = components.some((c) => c.status === "degraded");
+    if (hasUnhealthy) return "unhealthy";
+    if (hasDegraded) return "degraded";
+    return "healthy";
+  }
+}
+function createHealthMonitor(config) {
+  return new HealthMonitor(config);
+}
+function createDatabaseCheck(dbPath) {
+  return {
+    name: "database",
+    critical: true,
+    check: async () => {
+      const startTime = Date.now();
+      const { existsSync } = await import("fs");
+      const exists = existsSync(dbPath);
+      return {
+        name: "database",
+        status: exists ? "healthy" : "unhealthy",
+        message: exists ? "Database accessible" : "Database file not found",
+        lastCheck: /* @__PURE__ */ new Date(),
+        responseTime: Date.now() - startTime
+      };
+    }
+  };
+}
+function createCacheCheck() {
+  return {
+    name: "cache",
+    check: async () => {
+      return {
+        name: "cache",
+        status: "healthy",
+        message: "Cache operational",
+        lastCheck: /* @__PURE__ */ new Date()
+      };
+    }
+  };
+}
+function createMemoryCheck(thresholdMB = 500) {
+  return {
+    name: "memory",
+    check: async () => {
+      const { heapUsed } = process.memoryUsage();
+      const usedMB = heapUsed / (1024 * 1024);
+      let status = "healthy";
+      if (usedMB > thresholdMB * 0.9) {
+        status = "unhealthy";
+      } else if (usedMB > thresholdMB * 0.7) {
+        status = "degraded";
+      }
+      return {
+        name: "memory",
+        status,
+        message: `Heap usage: ${usedMB.toFixed(2)}MB`,
+        lastCheck: /* @__PURE__ */ new Date(),
+        metadata: { heapUsedMB: usedMB, thresholdMB }
+      };
+    }
+  };
+}
+function createDiskCheck(path) {
+  return {
+    name: "disk",
+    check: async () => {
+      const { accessSync, constants } = await import("fs");
+      try {
+        accessSync(path, constants.R_OK | constants.W_OK);
+        return {
+          name: "disk",
+          status: "healthy",
+          message: "Disk accessible",
+          lastCheck: /* @__PURE__ */ new Date()
+        };
+      } catch {
+        return {
+          name: "disk",
+          status: "unhealthy",
+          message: "Disk not accessible",
+          lastCheck: /* @__PURE__ */ new Date()
+        };
+      }
+    }
+  };
+}
+export {
+  HealthMonitor,
+  createCacheCheck,
+  createDatabaseCheck,
+  createDiskCheck,
+  createHealthMonitor,
+  createMemoryCheck
+};
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/health/index.ts"],"sourcesContent":["/**\n * Health Monitoring Module\n *\n * Provides system health monitoring, diagnostics, and alerting.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Health status values\n */\nexport type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';\n\n/**\n * Component health information\n */\nexport interface ComponentHealth {\n  /** Component name */\n  name: string;\n  /** Health status */\n  status: HealthStatus;\n  /** Optional message */\n  message?: string;\n  /** Last check time */\n  lastCheck: Date;\n  /** Response time in milliseconds */\n  responseTime?: number;\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * System-wide health information\n */\nexport interface SystemHealth {\n  /** Overall status */\n  status: HealthStatus;\n  /** Component health details */\n  components: ComponentHealth[];\n  /** Check timestamp */\n  timestamp: Date;\n  /** System uptime in milliseconds */\n  uptime: number;\n}\n\n/**\n * Memory metrics\n */\nexport interface MemoryMetrics {\n  /** Heap used in bytes */\n  heapUsed: number;\n  /** Heap total in bytes */\n  heapTotal: number;\n  /** RSS in bytes */\n  rss: number;\n  /** External memory in bytes */\n  external: number;\n  /** Array buffers in bytes */\n  arrayBuffers: number;\n}\n\n/**\n * Performance metrics\n */\nexport interface PerformanceMetrics {\n  /** CPU usage percentage */\n  cpuUsage?: number;\n  /** Memory metrics */\n  memory: MemoryMetrics;\n  /** Event loop lag in milliseconds */\n  eventLoopLag?: number;\n  /** Active handles count */\n  activeHandles?: number;\n  /** Active requests count */\n  activeRequests?: number;\n}\n\n/**\n * Health check function\n */\nexport interface HealthCheck {\n  /** Check name */\n  name: string;\n  /** Check function */\n  check: () => Promise<ComponentHealth>;\n  /** Check interval in milliseconds */\n  interval?: number;\n  /** Critical component flag */\n  critical?: boolean;\n}\n\n/**\n * Health monitor configuration\n */\nexport interface HealthMonitorConfig {\n  /** Check interval in milliseconds */\n  interval?: number;\n  /** Timeout for individual checks */\n  timeout?: number;\n  /** Enable automatic checks */\n  autoStart?: boolean;\n}\n\n// ============================================================================\n// Health Monitor\n// ============================================================================\n\n/**\n * Health Monitor for tracking system health\n */\nexport class HealthMonitor {\n  private checks: Map<string, HealthCheck> = new Map();\n  private results: Map<string, ComponentHealth> = new Map();\n  private startTime: Date = new Date();\n  private intervalId?: ReturnType<typeof setInterval>;\n  private config: HealthMonitorConfig;\n\n  constructor(config: HealthMonitorConfig = {}) {\n    this.config = {\n      interval: config.interval || 60000,\n      timeout: config.timeout || 5000,\n      autoStart: config.autoStart ?? false,\n    };\n\n    if (this.config.autoStart) {\n      this.start();\n    }\n  }\n\n  register(check: HealthCheck): void {\n    this.checks.set(check.name, check);\n  }\n\n  unregister(name: string): void {\n    this.checks.delete(name);\n    this.results.delete(name);\n  }\n\n  async check(): Promise<SystemHealth> {\n    const components: ComponentHealth[] = [];\n\n    for (const [name, check] of this.checks) {\n      try {\n        const result = await Promise.race([\n          check.check(),\n          this.timeout(check.name),\n        ]);\n        this.results.set(name, result);\n        components.push(result);\n      } catch (error) {\n        const errorResult: ComponentHealth = {\n          name,\n          status: 'unhealthy',\n          message: error instanceof Error ? error.message : String(error),\n          lastCheck: new Date(),\n        };\n        this.results.set(name, errorResult);\n        components.push(errorResult);\n      }\n    }\n\n    const status = this.calculateOverallStatus(components);\n\n    return {\n      status,\n      components,\n      timestamp: new Date(),\n      uptime: Date.now() - this.startTime.getTime(),\n    };\n  }\n\n  getLastStatus(): SystemHealth {\n    const components = Array.from(this.results.values());\n    return {\n      status: this.calculateOverallStatus(components),\n      components,\n      timestamp: new Date(),\n      uptime: Date.now() - this.startTime.getTime(),\n    };\n  }\n\n  getPerformanceMetrics(): PerformanceMetrics {\n    const memoryUsage = process.memoryUsage();\n    return {\n      memory: {\n        heapUsed: memoryUsage.heapUsed,\n        heapTotal: memoryUsage.heapTotal,\n        rss: memoryUsage.rss,\n        external: memoryUsage.external,\n        arrayBuffers: memoryUsage.arrayBuffers,\n      },\n    };\n  }\n\n  start(): void {\n    if (this.intervalId) return;\n    this.intervalId = setInterval(() => {\n      this.check().catch(() => {});\n    }, this.config.interval);\n  }\n\n  stop(): void {\n    if (this.intervalId) {\n      clearInterval(this.intervalId);\n      this.intervalId = undefined;\n    }\n  }\n\n  private timeout(name: string): Promise<ComponentHealth> {\n    return new Promise((_, reject) => {\n      setTimeout(() => {\n        reject(new Error(`Health check timeout: ${name}`));\n      }, this.config.timeout);\n    });\n  }\n\n  private calculateOverallStatus(components: ComponentHealth[]): HealthStatus {\n    if (components.length === 0) return 'unknown';\n    const hasUnhealthy = components.some((c) => c.status === 'unhealthy');\n    const hasDegraded = components.some((c) => c.status === 'degraded');\n    if (hasUnhealthy) return 'unhealthy';\n    if (hasDegraded) return 'degraded';\n    return 'healthy';\n  }\n}\n\nexport function createHealthMonitor(config?: HealthMonitorConfig): HealthMonitor {\n  return new HealthMonitor(config);\n}\n\n// ============================================================================\n// Built-in Health Checks\n// ============================================================================\n\nexport function createDatabaseCheck(dbPath: string): HealthCheck {\n  return {\n    name: 'database',\n    critical: true,\n    check: async (): Promise<ComponentHealth> => {\n      const startTime = Date.now();\n      const { existsSync } = await import('fs');\n      const exists = existsSync(dbPath);\n      return {\n        name: 'database',\n        status: exists ? 'healthy' : 'unhealthy',\n        message: exists ? 'Database accessible' : 'Database file not found',\n        lastCheck: new Date(),\n        responseTime: Date.now() - startTime,\n      };\n    },\n  };\n}\n\nexport function createCacheCheck(): HealthCheck {\n  return {\n    name: 'cache',\n    check: async (): Promise<ComponentHealth> => {\n      return {\n        name: 'cache',\n        status: 'healthy',\n        message: 'Cache operational',\n        lastCheck: new Date(),\n      };\n    },\n  };\n}\n\nexport function createMemoryCheck(thresholdMB: number = 500): HealthCheck {\n  return {\n    name: 'memory',\n    check: async (): Promise<ComponentHealth> => {\n      const { heapUsed } = process.memoryUsage();\n      const usedMB = heapUsed / (1024 * 1024);\n      let status: HealthStatus = 'healthy';\n      if (usedMB > thresholdMB * 0.9) {\n        status = 'unhealthy';\n      } else if (usedMB > thresholdMB * 0.7) {\n        status = 'degraded';\n      }\n      return {\n        name: 'memory',\n        status,\n        message: `Heap usage: ${usedMB.toFixed(2)}MB`,\n        lastCheck: new Date(),\n        metadata: { heapUsedMB: usedMB, thresholdMB },\n      };\n    },\n  };\n}\n\nexport function createDiskCheck(path: string): HealthCheck {\n  return {\n    name: 'disk',\n    check: async (): Promise<ComponentHealth> => {\n      const { accessSync, constants } = await import('fs');\n      try {\n        accessSync(path, constants.R_OK | constants.W_OK);\n        return {\n          name: 'disk',\n          status: 'healthy',\n          message: 'Disk accessible',\n          lastCheck: new Date(),\n        };\n      } catch {\n        return {\n          name: 'disk',\n          status: 'unhealthy',\n          message: 'Disk not accessible',\n          lastCheck: new Date(),\n        };\n      }\n    },\n  };\n}\n"],"names":[],"mappings":"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"}