@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent CLI\n *\n * Main CLI setup and command registration.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { createInitCommand } from './commands/init.js';\nimport { createGraphCommand } from './commands/graph.js';\nimport { createDocsCommand } from './commands/docs.js';\nimport { createClaudeCommand } from './commands/claude.js';\nimport { createSyncCommand } from './commands/sync.js';\nimport { createStatsCommand } from './commands/stats.js';\nimport { createSearchCommand } from './commands/search.js';\nimport { createConvertCommand, createFrontmatterCommand } from './commands/convert.js';\nimport { createAnalyzeCommand } from './commands/analyze.js';\n\n/**\n * CLI version\n */\nconst VERSION = '0.2.0';\n\n/**\n * Create and configure the CLI program\n */\nexport function createCLI(): Command {\n  const program = new Command();\n\n  program\n    .name('kg')\n    .description('Knowledge Graph Agent - Generate and manage knowledge graphs for Claude Code')\n    .version(VERSION, '-v, --version', 'Display version number');\n\n  // Configure help\n  program.configureHelp({\n    sortSubcommands: true,\n    sortOptions: true,\n  });\n\n  // Add commands\n  program.addCommand(createInitCommand());\n  program.addCommand(createGraphCommand());\n  program.addCommand(createDocsCommand());\n  program.addCommand(createClaudeCommand());\n  program.addCommand(createSyncCommand());\n  program.addCommand(createStatsCommand());\n  program.addCommand(createSearchCommand());\n  program.addCommand(createConvertCommand());\n  program.addCommand(createFrontmatterCommand());\n  program.addCommand(createAnalyzeCommand());\n\n  // Default action (show help)\n  program.action(() => {\n    console.log(chalk.cyan.bold('\\n  Knowledge Graph Agent\\n'));\n    console.log(chalk.gray('  Generate and manage knowledge graphs for Claude Code\\n'));\n\n    console.log(chalk.white('  Quick Start:'));\n    console.log(chalk.gray('    $ kg init                  # Initialize knowledge graph'));\n    console.log(chalk.gray('    $ kg docs init             # Initialize docs directory'));\n    console.log(chalk.gray('    $ kg graph                 # Generate knowledge graph'));\n    console.log(chalk.gray('    $ kg claude update         # Update CLAUDE.md'));\n    console.log(chalk.gray('    $ kg sync                  # Sync with claude-flow\\n'));\n\n    console.log(chalk.white('  Migration & Analysis:'));\n    console.log(chalk.gray('    $ kg analyze               # Analyze & migrate to knowledge graph'));\n    console.log(chalk.gray('    $ kg analyze deep          # Deep analysis with claude-flow'));\n    console.log(chalk.gray('    $ kg analyze report        # Generate analysis report'));\n    console.log(chalk.gray('    $ kg convert docs          # Convert docs/ → docs-nn/'));\n    console.log(chalk.gray('    $ kg frontmatter add       # Add frontmatter to files'));\n    console.log(chalk.gray('    $ kg frontmatter validate  # Validate frontmatter\\n'));\n\n    console.log(chalk.white('  Commands:'));\n    program.commands.forEach(cmd => {\n      console.log(chalk.cyan(`    ${cmd.name().padEnd(20)}`), chalk.gray(cmd.description() || ''));\n    });\n\n    console.log('\\n  Run', chalk.cyan('kg <command> --help'), 'for more information\\n');\n  });\n\n  return program;\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAqBA,MAAM,UAAU;AAKT,SAAS,YAAqB;AACnC,QAAM,UAAU,IAAI,QAAA;AAEpB,UACG,KAAK,IAAI,EACT,YAAY,8EAA8E,EAC1F,QAAQ,SAAS,iBAAiB,wBAAwB;AAG7D,UAAQ,cAAc;AAAA,IACpB,iBAAiB;AAAA,IACjB,aAAa;AAAA,EAAA,CACd;AAGD,UAAQ,WAAW,mBAAmB;AACtC,UAAQ,WAAW,oBAAoB;AACvC,UAAQ,WAAW,mBAAmB;AACtC,UAAQ,WAAW,qBAAqB;AACxC,UAAQ,WAAW,mBAAmB;AACtC,UAAQ,WAAW,oBAAoB;AACvC,UAAQ,WAAW,qBAAqB;AACxC,UAAQ,WAAW,sBAAsB;AACzC,UAAQ,WAAW,0BAA0B;AAC7C,UAAQ,WAAW,sBAAsB;AAGzC,UAAQ,OAAO,MAAM;AACnB,YAAQ,IAAI,MAAM,KAAK,KAAK,6BAA6B,CAAC;AAC1D,YAAQ,IAAI,MAAM,KAAK,0DAA0D,CAAC;AAElF,YAAQ,IAAI,MAAM,MAAM,gBAAgB,CAAC;AACzC,YAAQ,IAAI,MAAM,KAAK,6DAA6D,CAAC;AACrF,YAAQ,IAAI,MAAM,KAAK,4DAA4D,CAAC;AACpF,YAAQ,IAAI,MAAM,KAAK,2DAA2D,CAAC;AACnF,YAAQ,IAAI,MAAM,KAAK,mDAAmD,CAAC;AAC3E,YAAQ,IAAI,MAAM,KAAK,0DAA0D,CAAC;AAElF,YAAQ,IAAI,MAAM,MAAM,yBAAyB,CAAC;AAClD,YAAQ,IAAI,MAAM,KAAK,uEAAuE,CAAC;AAC/F,YAAQ,IAAI,MAAM,KAAK,iEAAiE,CAAC;AACzF,YAAQ,IAAI,MAAM,KAAK,2DAA2D,CAAC;AACnF,YAAQ,IAAI,MAAM,KAAK,2DAA2D,CAAC;AACnF,YAAQ,IAAI,MAAM,KAAK,2DAA2D,CAAC;AACnF,YAAQ,IAAI,MAAM,KAAK,yDAAyD,CAAC;AAEjF,YAAQ,IAAI,MAAM,MAAM,aAAa,CAAC;AACtC,YAAQ,SAAS,QAAQ,CAAA,QAAO;AAC9B,cAAQ,IAAI,MAAM,KAAK,OAAO,IAAI,OAAO,OAAO,EAAE,CAAC,EAAE,GAAG,MAAM,KAAK,IAAI,YAAA,KAAiB,EAAE,CAAC;AAAA,IAC7F,CAAC;AAED,YAAQ,IAAI,WAAW,MAAM,KAAK,qBAAqB,GAAG,wBAAwB;AAAA,EACpF,CAAC;AAED,SAAO;AACT;"}
+{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent CLI\n *\n * Main CLI setup and command registration.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { createInitCommand } from './commands/init.js';\nimport { createGraphCommand } from './commands/graph.js';\nimport { createDocsCommand } from './commands/docs.js';\nimport { createClaudeCommand } from './commands/claude.js';\nimport { createSyncCommand } from './commands/sync.js';\nimport { createStatsCommand } from './commands/stats.js';\nimport { createSearchCommand } from './commands/search.js';\nimport { createConvertCommand, createFrontmatterCommand } from './commands/convert.js';\nimport { createAnalyzeCommand } from './commands/analyze.js';\nimport { createSOPCommands } from './commands/sop.js';\nimport { createInitPrimitivesCommand, createAnalyzeCodebaseCommand } from './commands/init-primitives.js';\nimport { createCultivateCommand } from './commands/cultivate.js';\nimport { createCommitCommand } from './commands/commit.js';\nimport { createConfigCommand } from './commands/config.js';\nimport { createDiagnosticsCommand } from './commands/diagnostics.js';\nimport { createWorkflowCommand } from './commands/workflow.js';\nimport { createAuditCommand } from './commands/audit.js';\nimport { createVectorCommand } from './commands/vector.js';\n\n/**\n * CLI version\n */\nconst VERSION = '0.3.0';\n\n/**\n * Create and configure the CLI program\n */\nexport function createCLI(): Command {\n  const program = new Command();\n\n  program\n    .name('kg')\n    .description('Knowledge Graph Agent - Generate and manage knowledge graphs for Claude Code')\n    .version(VERSION, '-v, --version', 'Display version number');\n\n  // Configure help\n  program.configureHelp({\n    sortSubcommands: true,\n    sortOptions: true,\n  });\n\n  // Add commands\n  program.addCommand(createInitCommand());\n  program.addCommand(createGraphCommand());\n  program.addCommand(createDocsCommand());\n  program.addCommand(createClaudeCommand());\n  program.addCommand(createSyncCommand());\n  program.addCommand(createStatsCommand());\n  program.addCommand(createSearchCommand());\n  program.addCommand(createConvertCommand());\n  program.addCommand(createFrontmatterCommand());\n  program.addCommand(createAnalyzeCommand());\n  program.addCommand(createSOPCommands());\n  program.addCommand(createInitPrimitivesCommand());\n  program.addCommand(createAnalyzeCodebaseCommand());\n  program.addCommand(createCultivateCommand());\n  program.addCommand(createCommitCommand());\n  program.addCommand(createConfigCommand());\n  program.addCommand(createDiagnosticsCommand());\n  program.addCommand(createWorkflowCommand());\n  program.addCommand(createAuditCommand());\n  program.addCommand(createVectorCommand());\n\n  // Default action (show help)\n  program.action(() => {\n    console.log(chalk.cyan.bold('\\n  Knowledge Graph Agent\\n'));\n    console.log(chalk.gray('  Generate and manage knowledge graphs for Claude Code\\n'));\n\n    console.log(chalk.white('  Quick Start:'));\n    console.log(chalk.gray('    $ kg init                  # Initialize knowledge graph'));\n    console.log(chalk.gray('    $ kg docs init             # Initialize docs directory'));\n    console.log(chalk.gray('    $ kg graph                 # Generate knowledge graph'));\n    console.log(chalk.gray('    $ kg claude update         # Update CLAUDE.md'));\n    console.log(chalk.gray('    $ kg sync                  # Sync with claude-flow\\n'));\n\n    console.log(chalk.white('  Migration & Analysis:'));\n    console.log(chalk.gray('    $ kg analyze               # Analyze & migrate to knowledge graph'));\n    console.log(chalk.gray('    $ kg analyze deep          # Deep analysis with claude-flow'));\n    console.log(chalk.gray('    $ kg analyze report        # Generate analysis report'));\n    console.log(chalk.gray('    $ kg convert docs          # Convert docs/ → docs-nn/'));\n    console.log(chalk.gray('    $ kg frontmatter add       # Add frontmatter to files'));\n    console.log(chalk.gray('    $ kg frontmatter validate  # Validate frontmatter\\n'));\n\n    console.log(chalk.white('  AI-SDLC SOP Compliance:'));\n    console.log(chalk.gray('    $ kg sop init              # Initialize SOP standards layer'));\n    console.log(chalk.gray('    $ kg sop check             # Check compliance against SOPs'));\n    console.log(chalk.gray('    $ kg sop gaps              # Analyze compliance gaps'));\n    console.log(chalk.gray('    $ kg sop report            # Generate compliance report'));\n    console.log(chalk.gray('    $ kg sop list              # List available SOPs\\n'));\n\n    console.log(chalk.white('  Cultivation & Primitives:'));\n    console.log(chalk.gray('    $ kg init-primitives       # Bootstrap primitives from codebase'));\n    console.log(chalk.gray('    $ kg analyze-codebase      # Analyze dependencies & services'));\n    console.log(chalk.gray('    $ kg init-primitives --dry-run  # Preview without writing\\n'));\n\n    console.log(chalk.white('  Git Integration:'));\n    console.log(chalk.gray('    $ kg commit                # Show status and suggested message'));\n    console.log(chalk.gray('    $ kg commit -a             # Auto-commit with generated message'));\n    console.log(chalk.gray('    $ kg commit -i             # Interactive commit mode'));\n    console.log(chalk.gray('    $ kg commit -m \"message\"   # Commit with custom message'));\n    console.log(chalk.gray('    $ kg commit status         # Show git status with analysis'));\n    console.log(chalk.gray('    $ kg commit log            # Show recent commits'));\n    console.log(chalk.gray('    $ kg commit diff           # Show diff of changes\\n'));\n\n    console.log(chalk.white('  Diagnostics & Health:'));\n    console.log(chalk.gray('    $ kg diag run              # Run full diagnostics'));\n    console.log(chalk.gray('    $ kg diag run --fix        # Attempt to fix issues'));\n    console.log(chalk.gray('    $ kg diag health           # Check system health'));\n    console.log(chalk.gray('    $ kg diag repair           # Repair database issues'));\n    console.log(chalk.gray('    $ kg diag backup           # Create database backup'));\n    console.log(chalk.gray('    $ kg diag backup --list    # List existing backups'));\n    console.log(chalk.gray('    $ kg diag info             # Show system information\\n'));\n\n    console.log(chalk.white('  Workflow Management:'));\n    console.log(chalk.gray('    $ kg workflow start <type> # Start a workflow'));\n    console.log(chalk.gray('    $ kg workflow status [id]  # Check workflow status'));\n    console.log(chalk.gray('    $ kg workflow list         # List active workflows'));\n    console.log(chalk.gray('    $ kg workflow stop <id>    # Stop a workflow'));\n    console.log(chalk.gray('    $ kg workflow history      # Show workflow history\\n'));\n\n    console.log(chalk.white('  Vector Operations:'));\n    console.log(chalk.gray('    $ kg vector search <query> # Semantic search'));\n    console.log(chalk.gray('    $ kg vector stats          # Vector store statistics'));\n    console.log(chalk.gray('    $ kg vector rebuild        # Rebuild vector index'));\n    console.log(chalk.gray('    $ kg vector traj list      # List trajectories'));\n    console.log(chalk.gray('    $ kg vector traj show <id> # Show trajectory details'));\n    console.log(chalk.gray('    $ kg vector traj patterns  # Show detected patterns\\n'));\n\n    console.log(chalk.white('  Audit & Exochain:'));\n    console.log(chalk.gray('    $ kg audit query           # Query the audit log'));\n    console.log(chalk.gray('    $ kg audit checkpoint      # Create a checkpoint'));\n    console.log(chalk.gray('    $ kg audit verify          # Verify chain integrity'));\n    console.log(chalk.gray('    $ kg audit sync status     # Check sync status'));\n    console.log(chalk.gray('    $ kg audit sync peers      # List sync peers'));\n    console.log(chalk.gray('    $ kg audit export          # Export audit log\\n'));\n\n    console.log(chalk.white('  Commands:'));\n    program.commands.forEach(cmd => {\n      console.log(chalk.cyan(`    ${cmd.name().padEnd(20)}`), chalk.gray(cmd.description() || ''));\n    });\n\n    console.log('\\n  Run', chalk.cyan('kg <command> --help'), 'for more information\\n');\n  });\n\n  return program;\n}\n"],"names":[],"mappings":"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"}

package/dist/config/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Configuration Module
+ *
+ * Provides configuration management with validation, migrations, and defaults.
+ */
+/**
+ * Database configuration
+ */
+export interface DatabaseConfig {
+    /** Path to database file */
+    path: string;
+    /** Enable WAL mode */
+    walMode?: boolean;
+    /** Busy timeout in milliseconds */
+    busyTimeout?: number;
+    /** Cache size in pages */
+    cacheSize?: number;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** Maximum cache size in bytes */
+    maxSize?: number;
+    /** Default TTL in milliseconds */
+    defaultTtl?: number;
+    /** Eviction policy */
+    evictionPolicy?: 'lru' | 'lfu' | 'fifo';
+}
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+    /** Maximum concurrent agents */
+    maxConcurrent?: number;
+    /** Default timeout in milliseconds */
+    defaultTimeout?: number;
+    /** Enable agent logging */
+    enableLogging?: boolean;
+}
+/**
+ * Services configuration
+ */
+export interface ServicesConfig {
+    /** Enable file watcher */
+    fileWatcher?: boolean;
+    /** File watcher paths */
+    watchPaths?: string[];
+    /** Health check interval in milliseconds */
+    healthCheckInterval?: number;
+}
+/**
+ * Logging configuration
+ */
+export interface LoggingConfig {
+    /** Log level */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /** Log format */
+    format?: 'json' | 'text';
+    /** Log file path */
+    filePath?: string;
+    /** Enable console logging */
+    console?: boolean;
+}
+/**
+ * Full knowledge graph configuration
+ */
+export interface KGConfiguration {
+    /** Database settings */
+    database: DatabaseConfig;
+    /** Cache settings */
+    cache?: CacheConfig;
+    /** Agent settings */
+    agents?: AgentConfig;
+    /** Services settings */
+    services?: ServicesConfig;
+    /** Logging settings */
+    logging?: LoggingConfig;
+    /** Project root path */
+    projectRoot?: string;
+    /** Docs path relative to project root */
+    docsPath?: string;
+}
+/**
+ * Configuration migration
+ */
+export interface ConfigMigration {
+    /** Migration version */
+    version: number;
+    /** Migration description */
+    description: string;
+    /** Migration function */
+    migrate: (config: Partial<KGConfiguration>) => KGConfiguration;
+}
+/**
+ * Get default configuration
+ */
+export declare function getDefaultConfig(): KGConfiguration;
+/**
+ * Configuration Manager for loading, saving, and managing configuration
+ */
+export declare class ConfigManager {
+    private config;
+    private configPath;
+    private migrations;
+    constructor(configPath?: string);
+    /**
+     * Load configuration from file
+     */
+    load(): Promise<KGConfiguration>;
+    /**
+     * Save configuration to file
+     */
+    save(): Promise<void>;
+    /**
+     * Get current configuration
+     */
+    get(): KGConfiguration;
+    /**
+     * Update configuration
+     */
+    update(updates: Partial<KGConfiguration>): KGConfiguration;
+    /**
+     * Reset to defaults
+     */
+    reset(): KGConfiguration;
+    /**
+     * Validate configuration
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Register a migration
+     */
+    registerMigration(migration: ConfigMigration): void;
+    /**
+     * Apply migrations
+     */
+    applyMigrations(fromVersion: number): KGConfiguration;
+    /**
+     * Merge configurations
+     */
+    private merge;
+}
+/**
+ * Create a new ConfigManager instance
+ */
+export declare function createConfigManager(configPath?: string): ConfigManager;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,uBAAuB;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,eAAe,CAAC;CAChE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CA+BlD;AAMD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAyB;gBAE/B,UAAU,CAAC,EAAE,MAAM;IAK/B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IActC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,GAAG,IAAI,eAAe;IAItB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe;IAK1D;;OAEG;IACH,KAAK,IAAI,eAAe;IAKxB;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAahD;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAKnD;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IASrD;;OAEG;IACH,OAAO,CAAC,KAAK;CAcd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAEtE"}

package/dist/config/index.js

@@ -0,0 +1,141 @@
+function getDefaultConfig() {
+  return {
+    database: {
+      path: ".kg/knowledge.db",
+      walMode: true,
+      busyTimeout: 5e3,
+      cacheSize: 2e3
+    },
+    cache: {
+      enabled: true,
+      maxSize: 100 * 1024 * 1024,
+      // 100MB
+      defaultTtl: 36e5,
+      // 1 hour
+      evictionPolicy: "lru"
+    },
+    agents: {
+      maxConcurrent: 5,
+      defaultTimeout: 3e4,
+      enableLogging: true
+    },
+    services: {
+      fileWatcher: true,
+      watchPaths: ["docs", "src"],
+      healthCheckInterval: 6e4
+    },
+    logging: {
+      level: "info",
+      format: "text",
+      console: true
+    },
+    docsPath: "docs"
+  };
+}
+class ConfigManager {
+  config;
+  configPath;
+  migrations = [];
+  constructor(configPath) {
+    this.configPath = configPath || ".kg/config.json";
+    this.config = getDefaultConfig();
+  }
+  /**
+   * Load configuration from file
+   */
+  async load() {
+    try {
+      const { readFileSync, existsSync } = await import("fs");
+      if (existsSync(this.configPath)) {
+        const content = readFileSync(this.configPath, "utf-8");
+        const loaded = JSON.parse(content);
+        this.config = this.merge(getDefaultConfig(), loaded);
+      }
+    } catch {
+    }
+    return this.config;
+  }
+  /**
+   * Save configuration to file
+   */
+  async save() {
+    const { writeFileSync, mkdirSync } = await import("fs");
+    const { dirname } = await import("path");
+    mkdirSync(dirname(this.configPath), { recursive: true });
+    writeFileSync(this.configPath, JSON.stringify(this.config, null, 2));
+  }
+  /**
+   * Get current configuration
+   */
+  get() {
+    return { ...this.config };
+  }
+  /**
+   * Update configuration
+   */
+  update(updates) {
+    this.config = this.merge(this.config, updates);
+    return this.config;
+  }
+  /**
+   * Reset to defaults
+   */
+  reset() {
+    this.config = getDefaultConfig();
+    return this.config;
+  }
+  /**
+   * Validate configuration
+   */
+  validate() {
+    const errors = [];
+    if (!this.config.database?.path) {
+      errors.push("Database path is required");
+    }
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+  /**
+   * Register a migration
+   */
+  registerMigration(migration) {
+    this.migrations.push(migration);
+    this.migrations.sort((a, b) => a.version - b.version);
+  }
+  /**
+   * Apply migrations
+   */
+  applyMigrations(fromVersion) {
+    for (const migration of this.migrations) {
+      if (migration.version > fromVersion) {
+        this.config = migration.migrate(this.config);
+      }
+    }
+    return this.config;
+  }
+  /**
+   * Merge configurations
+   */
+  merge(base, updates) {
+    return {
+      ...base,
+      ...updates,
+      database: { ...base.database, ...updates.database },
+      cache: updates.cache ? { ...base.cache, ...updates.cache } : base.cache,
+      agents: updates.agents ? { ...base.agents, ...updates.agents } : base.agents,
+      services: updates.services ? { ...base.services, ...updates.services } : base.services,
+      logging: updates.logging ? { ...base.logging, ...updates.logging } : base.logging
+    };
+  }
+}
+function createConfigManager(configPath) {
+  return new ConfigManager(configPath);
+}
+export {
+  ConfigManager,
+  createConfigManager,
+  getDefaultConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/config/index.ts"],"sourcesContent":["/**\n * Configuration Module\n *\n * Provides configuration management with validation, migrations, and defaults.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Database configuration\n */\nexport interface DatabaseConfig {\n  /** Path to database file */\n  path: string;\n  /** Enable WAL mode */\n  walMode?: boolean;\n  /** Busy timeout in milliseconds */\n  busyTimeout?: number;\n  /** Cache size in pages */\n  cacheSize?: number;\n}\n\n/**\n * Cache configuration\n */\nexport interface CacheConfig {\n  /** Enable caching */\n  enabled: boolean;\n  /** Maximum cache size in bytes */\n  maxSize?: number;\n  /** Default TTL in milliseconds */\n  defaultTtl?: number;\n  /** Eviction policy */\n  evictionPolicy?: 'lru' | 'lfu' | 'fifo';\n}\n\n/**\n * Agent configuration\n */\nexport interface AgentConfig {\n  /** Maximum concurrent agents */\n  maxConcurrent?: number;\n  /** Default timeout in milliseconds */\n  defaultTimeout?: number;\n  /** Enable agent logging */\n  enableLogging?: boolean;\n}\n\n/**\n * Services configuration\n */\nexport interface ServicesConfig {\n  /** Enable file watcher */\n  fileWatcher?: boolean;\n  /** File watcher paths */\n  watchPaths?: string[];\n  /** Health check interval in milliseconds */\n  healthCheckInterval?: number;\n}\n\n/**\n * Logging configuration\n */\nexport interface LoggingConfig {\n  /** Log level */\n  level: 'debug' | 'info' | 'warn' | 'error';\n  /** Log format */\n  format?: 'json' | 'text';\n  /** Log file path */\n  filePath?: string;\n  /** Enable console logging */\n  console?: boolean;\n}\n\n/**\n * Full knowledge graph configuration\n */\nexport interface KGConfiguration {\n  /** Database settings */\n  database: DatabaseConfig;\n  /** Cache settings */\n  cache?: CacheConfig;\n  /** Agent settings */\n  agents?: AgentConfig;\n  /** Services settings */\n  services?: ServicesConfig;\n  /** Logging settings */\n  logging?: LoggingConfig;\n  /** Project root path */\n  projectRoot?: string;\n  /** Docs path relative to project root */\n  docsPath?: string;\n}\n\n/**\n * Configuration migration\n */\nexport interface ConfigMigration {\n  /** Migration version */\n  version: number;\n  /** Migration description */\n  description: string;\n  /** Migration function */\n  migrate: (config: Partial<KGConfiguration>) => KGConfiguration;\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\n/**\n * Get default configuration\n */\nexport function getDefaultConfig(): KGConfiguration {\n  return {\n    database: {\n      path: '.kg/knowledge.db',\n      walMode: true,\n      busyTimeout: 5000,\n      cacheSize: 2000,\n    },\n    cache: {\n      enabled: true,\n      maxSize: 100 * 1024 * 1024, // 100MB\n      defaultTtl: 3600000, // 1 hour\n      evictionPolicy: 'lru',\n    },\n    agents: {\n      maxConcurrent: 5,\n      defaultTimeout: 30000,\n      enableLogging: true,\n    },\n    services: {\n      fileWatcher: true,\n      watchPaths: ['docs', 'src'],\n      healthCheckInterval: 60000,\n    },\n    logging: {\n      level: 'info',\n      format: 'text',\n      console: true,\n    },\n    docsPath: 'docs',\n  };\n}\n\n// ============================================================================\n// Configuration Manager\n// ============================================================================\n\n/**\n * Configuration Manager for loading, saving, and managing configuration\n */\nexport class ConfigManager {\n  private config: KGConfiguration;\n  private configPath: string;\n  private migrations: ConfigMigration[] = [];\n\n  constructor(configPath?: string) {\n    this.configPath = configPath || '.kg/config.json';\n    this.config = getDefaultConfig();\n  }\n\n  /**\n   * Load configuration from file\n   */\n  async load(): Promise<KGConfiguration> {\n    try {\n      const { readFileSync, existsSync } = await import('fs');\n      if (existsSync(this.configPath)) {\n        const content = readFileSync(this.configPath, 'utf-8');\n        const loaded = JSON.parse(content) as Partial<KGConfiguration>;\n        this.config = this.merge(getDefaultConfig(), loaded);\n      }\n    } catch {\n      // Use defaults on error\n    }\n    return this.config;\n  }\n\n  /**\n   * Save configuration to file\n   */\n  async save(): Promise<void> {\n    const { writeFileSync, mkdirSync } = await import('fs');\n    const { dirname } = await import('path');\n\n    mkdirSync(dirname(this.configPath), { recursive: true });\n    writeFileSync(this.configPath, JSON.stringify(this.config, null, 2));\n  }\n\n  /**\n   * Get current configuration\n   */\n  get(): KGConfiguration {\n    return { ...this.config };\n  }\n\n  /**\n   * Update configuration\n   */\n  update(updates: Partial<KGConfiguration>): KGConfiguration {\n    this.config = this.merge(this.config, updates);\n    return this.config;\n  }\n\n  /**\n   * Reset to defaults\n   */\n  reset(): KGConfiguration {\n    this.config = getDefaultConfig();\n    return this.config;\n  }\n\n  /**\n   * Validate configuration\n   */\n  validate(): { valid: boolean; errors: string[] } {\n    const errors: string[] = [];\n\n    if (!this.config.database?.path) {\n      errors.push('Database path is required');\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n\n  /**\n   * Register a migration\n   */\n  registerMigration(migration: ConfigMigration): void {\n    this.migrations.push(migration);\n    this.migrations.sort((a, b) => a.version - b.version);\n  }\n\n  /**\n   * Apply migrations\n   */\n  applyMigrations(fromVersion: number): KGConfiguration {\n    for (const migration of this.migrations) {\n      if (migration.version > fromVersion) {\n        this.config = migration.migrate(this.config);\n      }\n    }\n    return this.config;\n  }\n\n  /**\n   * Merge configurations\n   */\n  private merge(\n    base: KGConfiguration,\n    updates: Partial<KGConfiguration>\n  ): KGConfiguration {\n    return {\n      ...base,\n      ...updates,\n      database: { ...base.database, ...updates.database },\n      cache: updates.cache ? { ...base.cache, ...updates.cache } : base.cache,\n      agents: updates.agents ? { ...base.agents, ...updates.agents } : base.agents,\n      services: updates.services ? { ...base.services, ...updates.services } : base.services,\n      logging: updates.logging ? { ...base.logging, ...updates.logging } : base.logging,\n    };\n  }\n}\n\n/**\n * Create a new ConfigManager instance\n */\nexport function createConfigManager(configPath?: string): ConfigManager {\n  return new ConfigManager(configPath);\n}\n"],"names":[],"mappings":"AAmHO,SAAS,mBAAoC;AAClD,SAAO;AAAA,IACL,UAAU;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,WAAW;AAAA,IAAA;AAAA,IAEb,OAAO;AAAA,MACL,SAAS;AAAA,MACT,SAAS,MAAM,OAAO;AAAA;AAAA,MACtB,YAAY;AAAA;AAAA,MACZ,gBAAgB;AAAA,IAAA;AAAA,IAElB,QAAQ;AAAA,MACN,eAAe;AAAA,MACf,gBAAgB;AAAA,MAChB,eAAe;AAAA,IAAA;AAAA,IAEjB,UAAU;AAAA,MACR,aAAa;AAAA,MACb,YAAY,CAAC,QAAQ,KAAK;AAAA,MAC1B,qBAAqB;AAAA,IAAA;AAAA,IAEvB,SAAS;AAAA,MACP,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,SAAS;AAAA,IAAA;AAAA,IAEX,UAAU;AAAA,EAAA;AAEd;AASO,MAAM,cAAc;AAAA,EACjB;AAAA,EACA;AAAA,EACA,aAAgC,CAAA;AAAA,EAExC,YAAY,YAAqB;AAC/B,SAAK,aAAa,cAAc;AAChC,SAAK,SAAS,iBAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAiC;AACrC,QAAI;AACF,YAAM,EAAE,cAAc,eAAe,MAAM,OAAO,IAAI;AACtD,UAAI,WAAW,KAAK,UAAU,GAAG;AAC/B,cAAM,UAAU,aAAa,KAAK,YAAY,OAAO;AACrD,cAAM,SAAS,KAAK,MAAM,OAAO;AACjC,aAAK,SAAS,KAAK,MAAM,iBAAA,GAAoB,MAAM;AAAA,MACrD;AAAA,IACF,QAAQ;AAAA,IAER;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAsB;AAC1B,UAAM,EAAE,eAAe,cAAc,MAAM,OAAO,IAAI;AACtD,UAAM,EAAE,QAAA,IAAY,MAAM,OAAO,MAAM;AAEvC,cAAU,QAAQ,KAAK,UAAU,GAAG,EAAE,WAAW,MAAM;AACvD,kBAAc,KAAK,YAAY,KAAK,UAAU,KAAK,QAAQ,MAAM,CAAC,CAAC;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAuB;AACrB,WAAO,EAAE,GAAG,KAAK,OAAA;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAoD;AACzD,SAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,OAAO;AAC7C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,QAAyB;AACvB,SAAK,SAAS,iBAAA;AACd,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,WAAiD;AAC/C,UAAM,SAAmB,CAAA;AAEzB,QAAI,CAAC,KAAK,OAAO,UAAU,MAAM;AAC/B,aAAO,KAAK,2BAA2B;AAAA,IACzC;AAEA,WAAO;AAAA,MACL,OAAO,OAAO,WAAW;AAAA,MACzB;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAkB,WAAkC;AAClD,SAAK,WAAW,KAAK,SAAS;AAC9B,SAAK,WAAW,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,aAAsC;AACpD,eAAW,aAAa,KAAK,YAAY;AACvC,UAAI,UAAU,UAAU,aAAa;AACnC,aAAK,SAAS,UAAU,QAAQ,KAAK,MAAM;AAAA,MAC7C;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKQ,MACN,MACA,SACiB;AACjB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,GAAG;AAAA,MACH,UAAU,EAAE,GAAG,KAAK,UAAU,GAAG,QAAQ,SAAA;AAAA,MACzC,OAAO,QAAQ,QAAQ,EAAE,GAAG,KAAK,OAAO,GAAG,QAAQ,UAAU,KAAK;AAAA,MAClE,QAAQ,QAAQ,SAAS,EAAE,GAAG,KAAK,QAAQ,GAAG,QAAQ,WAAW,KAAK;AAAA,MACtE,UAAU,QAAQ,WAAW,EAAE,GAAG,KAAK,UAAU,GAAG,QAAQ,aAAa,KAAK;AAAA,MAC9E,SAAS,QAAQ,UAAU,EAAE,GAAG,KAAK,SAAS,GAAG,QAAQ,QAAA,IAAY,KAAK;AAAA,IAAA;AAAA,EAE9E;AACF;AAKO,SAAS,oBAAoB,YAAoC;AACtE,SAAO,IAAI,cAAc,UAAU;AACrC;"}

package/dist/config/manager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Configuration Manager
+ *
+ * Manages Knowledge Graph configuration with migration support,
+ * persistence, and validation.
+ *
+ * @module config/manager
+ */
+import type { KGConfiguration, ConfigMigration } from './types.js';
+/**
+ * Configuration Manager class
+ *
+ * Handles loading, saving, and migrating configuration files.
+ */
+export declare class ConfigManager {
+    private config;
+    private configPath;
+    private migrations;
+    /**
+     * Create a new ConfigManager instance
+     *
+     * @param projectRoot - Root directory of the project
+     * @param configPath - Optional custom config file path
+     */
+    constructor(projectRoot: string, configPath?: string);
+    /**
+     * Load configuration from file
+     *
+     * @returns Loaded configuration merged with defaults
+     */
+    private load;
+    /**
+     * Merge loaded configuration with defaults
+     *
+     * @param loaded - Partially loaded configuration
+     * @returns Complete configuration with defaults filled in
+     */
+    private mergeWithDefaults;
+    /**
+     * Save configuration to file
+     */
+    save(): void;
+    /**
+     * Get a configuration value by key
+     *
+     * @param key - Configuration key
+     * @returns Configuration value for the key
+     */
+    get<K extends keyof KGConfiguration>(key: K): KGConfiguration[K];
+    /**
+     * Set a configuration value
+     *
+     * @param key - Configuration key
+     * @param value - Value to set
+     */
+    set<K extends keyof KGConfiguration>(key: K, value: KGConfiguration[K]): void;
+    /**
+     * Update multiple configuration values
+     *
+     * @param updates - Partial configuration to merge
+     */
+    update(updates: Partial<KGConfiguration>): void;
+    /**
+     * Get the complete configuration
+     *
+     * @returns Complete configuration object (copy)
+     */
+    getAll(): KGConfiguration;
+    /**
+     * Register a configuration migration
+     *
+     * @param migration - Migration definition
+     */
+    registerMigration(migration: ConfigMigration): void;
+    /**
+     * Run migrations to target version
+     *
+     * @param targetVersion - Target version to migrate to (defaults to latest)
+     */
+    migrate(targetVersion?: string): void;
+    /**
+     * Compare two version strings
+     *
+     * @param a - First version
+     * @param b - Second version
+     * @returns Negative if a < b, 0 if equal, positive if a > b
+     */
+    private compareVersions;
+    /**
+     * Get the version before a given version
+     *
+     * @param version - Current version
+     * @returns Previous version string
+     */
+    private getPreviousVersion;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): void;
+    /**
+     * Get the configuration file path
+     *
+     * @returns Path to the configuration file
+     */
+    getConfigPath(): string;
+    /**
+     * Check if configuration file exists
+     *
+     * @returns True if config file exists
+     */
+    exists(): boolean;
+    /**
+     * Validate the current configuration
+     *
+     * @returns Validation result with any errors
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * Create a new ConfigManager instance
+ *
+ * @param projectRoot - Root directory of the project
+ * @param configPath - Optional custom config file path
+ * @returns ConfigManager instance
+ */
+export declare function createConfigManager(projectRoot: string, configPath?: string): ConfigManager;
+/**
+ * Get a copy of the default configuration
+ *
+ * @returns Default configuration object
+ */
+export declare function getDefaultConfig(): KGConfiguration;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAMhB,MAAM,YAAY,CAAC;AAyCpB;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAyB;IAE3C;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAOpD;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAmBZ;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,IAAI,IAAI,IAAI;IAiBZ;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAIhE;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAK7E;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAK/C;;;;OAIG;IACH,MAAM,IAAI,eAAe;IAIzB;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAOnD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IA2DrC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;OAIG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CA2DjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}

package/dist/config/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Configuration Types
+ *
+ * Type definitions for Knowledge Graph configuration system.
+ *
+ * @module config/types
+ */
+/**
+ * Main configuration interface for the Knowledge Graph system
+ */
+export interface KGConfiguration {
+    /** Configuration version for migration support */
+    version: string;
+    /** Root directory of the project */
+    projectRoot: string;
+    /** Path to documentation directory (relative to projectRoot) */
+    docsPath: string;
+    /** Database configuration */
+    database: DatabaseConfig;
+    /** Cache configuration */
+    cache: CacheConfig;
+    /** Agent configuration */
+    agents: AgentConfig;
+    /** Services configuration */
+    services: ServicesConfig;
+    /** Logging configuration */
+    logging: LoggingConfig;
+}
+/**
+ * Database configuration settings
+ */
+export interface DatabaseConfig {
+    /** Path to database file (relative to projectRoot) */
+    path: string;
+    /** Enable automatic backups */
+    autoBackup: boolean;
+    /** Backup interval in milliseconds (default: 24 hours) */
+    backupInterval: number;
+    /** Maximum number of backup files to retain */
+    maxBackups: number;
+}
+/**
+ * Cache configuration settings
+ */
+export interface CacheConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** Maximum number of items in cache */
+    maxSize: number;
+    /** Time-to-live in milliseconds */
+    ttl: number;
+    /** Cache eviction policy */
+    evictionPolicy: 'lru' | 'lfu' | 'fifo';
+}
+/**
+ * Agent configuration settings
+ */
+export interface AgentConfig {
+    /** Maximum concurrent agent executions */
+    maxConcurrent: number;
+    /** Default timeout for agent operations in milliseconds */
+    defaultTimeout: number;
+    /** Number of retry attempts for failed operations */
+    retryAttempts: number;
+    /** Enable Claude Flow integration */
+    claudeFlowEnabled: boolean;
+}
+/**
+ * Services configuration settings
+ */
+export interface ServicesConfig {
+    /** Enable file system watcher service */
+    watcherEnabled: boolean;
+    /** Enable task scheduler service */
+    schedulerEnabled: boolean;
+    /** Enable sync service */
+    syncEnabled: boolean;
+    /** Health check interval in milliseconds */
+    healthCheckInterval: number;
+}
+/**
+ * Logging configuration settings
+ */
+export interface LoggingConfig {
+    /** Minimum log level */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /** Log output format */
+    format: 'json' | 'text';
+    /** Optional path for log file output */
+    outputPath?: string;
+}
+/**
+ * Configuration migration definition
+ */
+export interface ConfigMigration {
+    /** Target version for this migration */
+    version: string;
+    /** Upgrade function */
+    up: (config: Partial<KGConfiguration>) => Partial<KGConfiguration>;
+    /** Downgrade function */
+    down: (config: Partial<KGConfiguration>) => Partial<KGConfiguration>;
+}
+/**
+ * Configuration validation result
+ */
+export interface ConfigValidationResult {
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** Validation errors if any */
+    errors: ConfigValidationError[];
+    /** Validation warnings if any */
+    warnings: ConfigValidationError[];
+}
+/**
+ * Configuration validation error
+ */
+export interface ConfigValidationError {
+    /** Path to the invalid field */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Expected value or type */
+    expected?: string;
+    /** Actual value received */
+    actual?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,0BAA0B;IAC1B,KAAK,EAAE,WAAW,CAAC;IAEnB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,4BAA4B;IAC5B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IAEpB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IAEZ,4BAA4B;IAC5B,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;IAExB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAC;IAErB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE3C,wBAAwB;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnE,yBAAyB;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAEhC,iCAAiC;IACjC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}