feat: Introduce task management interfaces and validation framework

- Added ITaskFixer interface for automatic task validation fixes.
- Introduced ITaskHydrationUseCase and ITaskRenderUseCase for task hydration and rendering operations.
- Created ITaskRepository and ITaskStore interfaces for task data management.
- Implemented ITaskValidator interface for task validation against business rules.
- Added IUIdSupersedeUseCase and IUidRepository interfaces for UID management.
- Defined IValidationResult and IValidationResultBuilder for structured validation results.
- Introduced OutputFormat, TaskPriority, TaskProviderType, and TaskStatus enums for task categorization.
- Created command options types for various task-related commands.
- Established a new validation framework using AJV for JSON schema validation.
- Refactored validation context and factory to utilize new types and validation logic.
- Removed legacy hydrate and renderer utilities in favor of a more modular approach.

Author: Coderrob

src/__tests__/task-fixer.test.ts

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 
-import { getLogger } from '../utils/logger';
-
-import { CommandFactory } from './command.factory';
+import { getLogger } from '../core/system/logger';
+import { CommandFactory } from '../commands/shared/command.factory';
 
 /**
  * Main CLI entry point for the Documentation-Driven Development toolkit.
@@ -17,19 +16,19 @@ import { CommandFactory } from './command.factory';
 const program = new Command();
 program.name('dddctl').description('Documentation-Driven Development CLI').version('1.0.0');
 
+// Create logger for command configuration
+const logger = getLogger();
+
 // Configure all commands through the factory
-CommandFactory.configureProgram(program);
+CommandFactory.configureProgram(program, logger);
 
 // Error handling following clean architecture principles
 try {
-  const logger = getLogger();
   logger.debug('CLI start', { argv: process.argv.slice(2) });
 
   // Parse command line arguments and execute the appropriate command
   program.parse(process.argv);
 } catch (error) {
-  const logger = getLogger();
-
   // Log domain errors with appropriate level
   if (error instanceof Error && 'code' in error) {
     logger.error('Domain error occurred', {

src/__tests__/validator.test.ts

@@ -1,8 +1,7 @@
 import { Command } from 'commander';
 
-import { ILogger } from '../interfaces/ILogger';
-import { getLogger } from '../utils/logger';
-import { container, SERVICE_KEYS } from '../utils/container';
+import { container, SERVICE_KEYS } from '../../core/system/container';
+import { ILogger } from '../../types/ILogger';
 
 /**
  * Command for auditing references.
@@ -13,23 +12,22 @@ export class RefAuditCommand {
   /**
    * Executes the ref audit command.
    */
-  execute(): Promise<void> {
+  async execute(): Promise<void> {
     this.logger.info('Executing ref audit command');
     const svc = container.resolve(SERVICE_KEYS.REFERENCE_AUDIT) as unknown as {
       execute(): Promise<unknown>;
     };
-    return svc.execute().then(() => {
-      console.log('Ref audit command executed');
-      this.logger.info('Reference audit completed');
-    });
+    await svc.execute();
+    console.log('Ref audit command executed');
+    this.logger.info('Reference audit completed');
   }
 
-  static configure(parent: Command): void {
+  static configure(parent: Command, logger: ILogger): void {
     parent
       .command('audit')
       .description('Audit references across repo & tasks')
       .action(async () => {
-        const cmd = new RefAuditCommand(getLogger());
+        const cmd = new RefAuditCommand(logger);
         await cmd.execute();
       });
   }