feat: enhance logging and linting functionality with detailed reports

src/types/generation.types.ts

@@ -11,6 +11,23 @@ export interface GeneratedCount {
   specs: number;
 }
 
+/**
+ * Result returned by the lint/format step.
+ */
+export interface LintResult {
+  prettier: { ran: boolean; filesFormatted: number };
+  eslint: { ran: boolean; filesFixed: number };
+}
+
+/**
+ * Per-tag summary included in the generation report.
+ */
+export interface TagDetail {
+  name: string;
+  description: string;
+  endpoints: number;
+}
+
 /**
  * Final generation report persisted as `generation-report.json`.
  */
@@ -18,7 +35,9 @@ export interface GenerationReport {
   timestamp: string;
   tags: number;
   endpoints: number;
+  tagDetails: TagDetail[];
   outputDirectory: string;
+  linting: LintResult;
   structure: {
     dtos: number;
     repositories: number;