umbaudit 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lee Mills
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# Umbraco LTS Upgrade Audit CLI
+
+A CLI tool to audit Umbraco 13 LTS projects and estimate upgrade effort to Umbraco 17 LTS.
+
+## Features
+
+- 🔍 Scans Umbraco 13 projects for upgrade-breaking changes
+- 📊 Generates detailed hour estimates based on 10 detection rules
+- 🎨 Beautiful console output
+- ⚡ Fast scanning with NuGet API integration
+- 📝 Configurable rules and output formats
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### Basic Audit
+
+```bash
+node dist/cli/index.js /path/to/umbraco-project
+```
+
+### With Options
+
+```bash
+# Verbose mode (show detailed findings)
+node dist/cli/index.js /path/to/project --verbose
+
+# Debug mode (show trace logs)
+node dist/cli/index.js /path/to/project --debug
+
+# JSON output
+node dist/cli/index.js /path/to/project --output json
+
+# HTML output (coming soon)
+node dist/cli/index.js /path/to/project --output html
+```
+
+## Detection Rules
+
+The tool applies 10 rules to detect upgrade-relevant changes:
+
+| Rule | Detection | Base Hours |
+|------|-----------|------------|
+| **NuGet Package Updates** | Checks package versions against NuGet API | 0.5h for minor/patch, 1.0h for major version bumps |
+| **Obsolete Controller Classes** | Detects 3 controller classes that no longer exist (`UmbracoApiController`, `UmbracoAuthorizedApiController`, `UmbracoAuthorizedJsonController`) | 1.0h per file |
+| **Tiptap Import Changes** | Finds Tiptap imports (`@umbraco-cms/backoffice/external/tiptap`) needing updates | 0.5h per file |
+| **Removed Packages** | Detects 3 packages removed in v17 (`Umbraco.Cloud.Cms.PublicAccess`, `Umbraco.Cloud.Identity.Cms`, `Umbraco.Cms.Web.BackOffice`) | 0.5h per package |
+| **Program.cs Changes** | Finds `UseInstallerEndpoints()` calls that have been removed | 0.5h fixed |
+| **ViewImports Smidge Removal** | Detects Smidge TagHelper references in `_ViewImports.cshtml` | 0.5h fixed |
+| **Angular Detection** | Counts AngularJS files in `App_Plugins` requiring migration to Lit/Web Components | 40h base (5 days) + 4h per 10 files |
+| **Published Snapshot Interfaces** | Detects `IPublishedSnapshotAccessor` and `IPublishedSnapshot` usage | 0.5h fixed for generated files, 0.5h per regular file |
+| **Outdated Property Editors** | Detects obsolete property editors in `*.uda` files (`Umbraco.MediaPicker`, `Nested Content`, `Stacked Content`) | 1.0h per occurrence |
+| **License File Structure Changes** | Detects legacy license files (`umbracoDeploy.lic`, `umbracoForms.lic`) needing update for new licensing structure | 0.5h total |
+
+## Sample Output
+
+```
+    ██╗   ██╗███╗   ███╗██████╗ ██████╗  █████╗  ██████╗ ██████╗ 
+    ██║   ██║████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔═══██╗
+    ██║   ██║██╔████╔██║██████╔╝██████╔╝███████║██║     ██║   ██║
+    ██║   ██║██║╚██╔╝██║██╔══██╗██╔══██╗██╔══██║██║     ██║   ██║
+    ╚██████╔╝██║ ╚═╝ ██║██████╔╝██║  ██║██║  ██║╚██████╗╚██████╔╝
+     ╚═════╝ ╚═╝     ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+                    LTS Upgrade Audit Tool v0.1.0
+
+┌──────────────────────────────────────────────────┬────────────┬────────────┐
+│ Rule                                             │ Matches    │ Hours      │
+├──────────────────────────────────────────────────┼────────────┼────────────┤
+│ NuGet Package Updates                            │ 12         │ 6.0        │
+│   └─ Umbraco.* packages                          │ 5          │ 2.5        │
+│   └─ Other packages                              │ 7          │ 3.5        │
+├──────────────────────────────────────────────────┼────────────┼────────────┤
+│ Obsolete Controller Classes                      │ 2          │ 2.0        │
+├──────────────────────────────────────────────────┼────────────┼────────────┤
+│ Tiptap Import Changes                            │ 2          │ 1.0        │
+├──────────────────────────────────────────────────┼────────────┼────────────┤
+│ Program.cs Changes                               │ 1          │ 0.5        │
+├──────────────────────────────────────────────────┼────────────┼────────────┤
+│ Angular Files Detected                           │ 8          │ 40.0       │
+├──────────────────────────────────────────────────┴────────────┴────────────┤
+│              TOTAL ESTIMATE:  51.0 hours  (~6.4 days @ 8h/day)             │
+└────────────────────────────────────────────────────────────────────────────┘
+
+#H5YR! 🙌 Thanks for using the Umbraco Upgrade Audit Tool!
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm test
+```
+
+### Lint & Format
+
+```bash
+npm run lint
+npm run format
+```
+
+## Architecture
+
+- **TypeScript 5.x** with strict mode
+- **Node.js 22 LTS** runtime
+- **Commander** for CLI framework
+- **Zod** for schema validation
+- **fast-glob** for file scanning
+- **fast-xml-parser** for .csproj parsing
+- **chalk** for terminal colors
+- **cli-table3** for table rendering
+
+## Project Structure
+
+```
+src/
+├── cli/              # CLI commands and output formatters
+├── rules/            # 10 audit rules
+├── scanners/         # File scanning and parsing utilities
+├── models/           # TypeScript interfaces
+└── utils/            # Shared utilities (logger, hours calc)
+```
+
+## Roadmap
+
+- [x] **v0.1.0** - Basic console output with 10 rules (MVP)
+- [ ] **v0.2.0** - JSON and HTML output formats
+- [ ] **v0.3.0** - YAML configuration support
+- [ ] **v1.0.0** - Detailed findings with code snippets
+
+## License
+
+MIT
+
+## Contributing
+
+Built with ❤️ for the Umbraco community. H5YR! 🙌

package/biome.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.14/schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+  "files": { "includes": ["**", "!!**/dist"] },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "useEditorconfig": true,
+    "includes": [
+      "**",
+      "!**/node_modules/",
+      "!**/dist/",
+      "!**/coverage/",
+      "!**/*.min.js",
+      "!**/package-lock.json",
+      "!**/yarn.lock",
+      "!**/pnpm-lock.yaml"
+    ]
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    },
+    "includes": ["**", "!node_modules/", "!dist/", "!coverage/", "!*.config.js"]
+  },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "single",
+      "quoteProperties": "asNeeded",
+      "quoteStyle": "single"
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.ts", "!tests/**/*.ts"],
+      "javascript": { "globals": [] },
+      "linter": {
+        "rules": {
+          "correctness": { "noUnusedVariables": "error" },
+          "suspicious": { "noConsole": "off", "noExplicitAny": "warn" }
+        }
+      }
+    },
+    {
+      "includes": ["tests/**/*.ts"],
+      "javascript": { "globals": [] },
+      "linter": {
+        "rules": {
+          "correctness": { "noUnusedVariables": "error" },
+          "suspicious": { "noConsole": "off", "noExplicitAny": "warn" }
+        }
+      }
+    }
+  ],
+  "assist": {
+    "enabled": true,
+    "actions": { "source": { "organizeImports": "on" } }
+  }
+}

package/dist/cli/commands/audit.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Audit command options
+ */
+export interface AuditCommandOptions {
+    output: 'console' | 'json' | 'html';
+    verbose: boolean;
+    debug: boolean;
+    noColor: boolean;
+}
+/**
+ * Execute the audit command
+ *
+ * @param projectPath - Path to project directory, .sln, or .csproj
+ * @param options - Command options
+ */
+export declare function executeAuditCommand(projectPath: string, options: AuditCommandOptions): Promise<void>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/cli/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/audit.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG1G"}

package/dist/cli/commands/audit.js

@@ -0,0 +1,179 @@
+import { stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { executeAllRules, getAllRules, registerRule } from '../../rules/index.js';
+// Import all rules
+import { rule01NuGetPackages } from '../../rules/rule-01-nuget-packages.js';
+import { rule02ObsoleteControllers } from '../../rules/rule-02-obsolete-controller-classes.js';
+import { rule03TiptapImport } from '../../rules/rule-03-tiptap-import.js';
+import { rule04RemovedPackages } from '../../rules/rule-04-removed-packages.js';
+import { rule05ProgramCs } from '../../rules/rule-05-program-cs.js';
+import { rule06ViewImports } from '../../rules/rule-06-view-imports.js';
+import { rule07AngularDetection } from '../../rules/rule-07-angular-detection.js';
+import { rule08PublishedSnapshotInterfaces } from '../../rules/rule-08-published-snapshot-interfaces.js';
+import { rule09UdaPropertyEditors } from '../../rules/rule-09-uda-property-editors.js';
+import { rule10LicenseFiles } from '../../rules/rule-10-license-files.js';
+import { extractUmbracoVersion, parseProjectFile } from '../../scanners/csproj-parser.js';
+import { findProjectFiles } from '../../scanners/file-scanner.js';
+import { hoursToDays } from '../../utils/hours.js';
+import { debug, error, info, setDebugMode, warn } from '../../utils/logger.js';
+import { formatConsoleOutput } from '../output/formatters/console.js';
+import { formatHtmlOutput } from '../output/formatters/html.js';
+import { formatJsonOutput } from '../output/formatters/json.js';
+/**
+ * Execute the audit command
+ *
+ * @param projectPath - Path to project directory, .sln, or .csproj
+ * @param options - Command options
+ */
+export async function executeAuditCommand(projectPath, options) {
+    const startTime = Date.now();
+    // Enable debug mode if requested
+    if (options.debug) {
+        setDebugMode(true);
+        debug('Debug mode enabled');
+    }
+    // Resolve absolute path
+    const absolutePath = resolve(projectPath);
+    debug(`Resolved path: ${absolutePath}`);
+    // Validate path exists
+    try {
+        await stat(absolutePath);
+    }
+    catch {
+        error(`Path not found: ${projectPath}`);
+        process.exit(1);
+    }
+    // Register all rules
+    registerRule(rule01NuGetPackages);
+    registerRule(rule02ObsoleteControllers);
+    registerRule(rule03TiptapImport);
+    registerRule(rule04RemovedPackages);
+    registerRule(rule05ProgramCs);
+    registerRule(rule06ViewImports);
+    registerRule(rule07AngularDetection);
+    registerRule(rule08PublishedSnapshotInterfaces);
+    registerRule(rule09UdaPropertyEditors);
+    registerRule(rule10LicenseFiles);
+    debug(`Registered ${getAllRules().length} rules`);
+    // Find project files
+    const projectFiles = await findProjectFiles(absolutePath);
+    if (projectFiles.length === 0) {
+        error('No .csproj files found. Are you sure this is an Umbraco project?');
+        process.exit(1);
+    }
+    info(`Found ${projectFiles.length} project file(s)`);
+    // Detect Umbraco version from first project file that contains Umbraco.Cms
+    let umbracoVersion = null;
+    let umbracoProjectFile = null;
+    for (const projectFile of projectFiles) {
+        const packages = await parseProjectFile(projectFile);
+        // Check if this project file contains Umbraco.Cms
+        if (packages.some((pkg) => pkg.name === 'Umbraco.Cms')) {
+            umbracoVersion = extractUmbracoVersion(packages);
+            umbracoProjectFile = projectFile;
+            debug(`Found Umbraco.Cms in: ${projectFile}`);
+            break;
+        }
+    }
+    if (umbracoVersion && umbracoProjectFile) {
+        info(`Detected Umbraco version: ${umbracoVersion}`);
+        // Check if version is 13.x but not 13.13.0
+        if (umbracoVersion.startsWith('13.') && umbracoVersion !== '13.13.0') {
+            warn('Before upgrading to v17, you must first upgrade to Umbraco 13.13.0 (the final LTS release of v13).');
+            warn('Please upgrade to 13.13.0 first, then proceed with the v17 upgrade.');
+        }
+    }
+    else {
+        error('Could not detect Umbraco version. No project file contains Umbraco.Cms package reference.');
+        process.exit(1);
+    }
+    // Create rule execution context
+    const context = {
+        projectPath: absolutePath,
+        projectFiles,
+        allFiles: [], // Will be populated by individual rules
+        debug: options.debug,
+    };
+    // Execute all rules
+    info('\nRunning audit rules...\n');
+    const findings = await executeAllRules(context);
+    const scanDuration = Date.now() - startTime;
+    // Build report
+    const report = buildReport(absolutePath, umbracoVersion, projectFiles, findings, scanDuration);
+    // Output report
+    if (options.output === 'console') {
+        console.log(formatConsoleOutput(report, options.verbose));
+    }
+    else if (options.output === 'json') {
+        console.log(formatJsonOutput(report));
+    }
+    else if (options.output === 'html') {
+        console.log(formatHtmlOutput(report));
+    }
+    process.exit(0);
+}
+/**
+ * Build audit report from findings
+ */
+function buildReport(rootPath, umbracoVersion, projectFiles, findings, scanDurationMs) {
+    const project = {
+        rootPath,
+        umbracoVersion,
+        projectFiles,
+        filesScanned: 0, // TODO: track actual file count
+        scanDurationMs,
+    };
+    // Calculate summary
+    const totalHours = findings.reduce((sum, f) => sum + f.hours, 0);
+    const totalDays = hoursToDays(totalHours);
+    // Group by rule
+    const ruleResults = [];
+    const allRules = getAllRules();
+    for (const rule of allRules) {
+        const ruleFindings = findings.filter((f) => f.ruleId === rule.id);
+        const totalHours = ruleFindings.reduce((sum, f) => sum + f.hours, 0);
+        ruleResults.push({
+            ruleId: rule.id,
+            ruleName: rule.name,
+            category: rule.category,
+            findingsCount: ruleFindings.length,
+            totalHours,
+            enabled: rule.enabled,
+        });
+    }
+    // Group by category
+    const categories = new Map();
+    for (const finding of findings) {
+        const rule = allRules.find((r) => r.id === finding.ruleId);
+        if (!rule)
+            continue;
+        const category = rule.category;
+        if (!categories.has(category)) {
+            categories.set(category, {
+                category,
+                findings: 0,
+                hours: 0,
+            });
+        }
+        const cat = categories.get(category);
+        cat.findings += 1;
+        cat.hours += finding.hours;
+    }
+    const summary = {
+        totalHours,
+        totalDays,
+        rulesTriggered: ruleResults.filter((r) => r.findingsCount > 0).length,
+        totalFindings: findings.length,
+        byCategory: Array.from(categories.values()),
+    };
+    return {
+        project,
+        timestamp: new Date(),
+        toolVersion: '0.1.0',
+        findings,
+        summary,
+        ruleResults,
+        diagnostics: [],
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/cli/commands/audit.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { executeAuditCommand } from './commands/audit.js';
+/**
+ * CLI entry point
+ *
+ * Implements Commander-based CLI with audit command and options
+ */
+const program = new Command();
+program
+    .name('umbaudit')
+    .description('CLI tool to audit and estimate upgrade effort for Umbraco 13 LTS to Umbraco 17 LTS')
+    .version('0.1.0');
+program
+    .command('audit')
+    .description('Audit an Umbraco project and generate upgrade estimate')
+    .argument('<path>', 'Path to Umbraco project directory, .sln, or .csproj')
+    .option('-o, --output <format>', 'Output format: console, json, html', 'console')
+    .option('-v, --verbose', 'Show detailed findings with code context', false)
+    .option('--debug', 'Enable debug logging', false)
+    .option('--no-color', 'Disable colored output', false)
+    .action(async (path, options) => {
+    await executeAuditCommand(path, options);
+});
+// Make audit the default command
+program
+    .argument('[path]', 'Path to Umbraco project directory, .sln, or .csproj')
+    .option('-o, --output <format>', 'Output format: console, json, html', 'console')
+    .option('-v, --verbose', 'Show detailed findings with code context', false)
+    .option('--debug', 'Enable debug logging', false)
+    .option('--no-color', 'Disable colored output', false)
+    .action(async (path, options) => {
+    if (path) {
+        await executeAuditCommand(path, options);
+    }
+    else {
+        program.help();
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;GAIG;AAEH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,oFAAoF,CAAC;KACjG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wDAAwD,CAAC;KACrE,QAAQ,CAAC,QAAQ,EAAE,qDAAqD,CAAC;KACzE,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,SAAS,CAAC;KAChF,MAAM,CAAC,eAAe,EAAE,0CAA0C,EAAE,KAAK,CAAC;KAC1E,MAAM,CAAC,SAAS,EAAE,sBAAsB,EAAE,KAAK,CAAC;KAChD,MAAM,CAAC,YAAY,EAAE,wBAAwB,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA4B,EAAE,EAAE;IAC3D,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,iCAAiC;AACjC,OAAO;KACJ,QAAQ,CAAC,QAAQ,EAAE,qDAAqD,CAAC;KACzE,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,SAAS,CAAC;KAChF,MAAM,CAAC,eAAe,EAAE,0CAA0C,EAAE,KAAK,CAAC;KAC1E,MAAM,CAAC,SAAS,EAAE,sBAAsB,EAAE,KAAK,CAAC;KAChD,MAAM,CAAC,YAAY,EAAE,wBAAwB,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,OAA4B,EAAE,EAAE;IACvE,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/output/ascii-logo.d.ts

@@ -0,0 +1,3 @@
+export declare function getUmbracoLogo(version: string): string;
+export declare function getH5YRFooter(): string;
+//# sourceMappingURL=ascii-logo.d.ts.map

package/dist/cli/output/ascii-logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-logo.d.ts","sourceRoot":"","sources":["../../../src/cli/output/ascii-logo.ts"],"names":[],"mappings":"AAUA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/cli/output/ascii-logo.js

@@ -0,0 +1,23 @@
+import chalk from 'chalk';
+/**
+ * Umbraco ASCII logo in brand color
+ *
+ * Brand Color: #3544B1 (Umbraco Blue)
+ */
+const UMBRACO_BLUE = '#3544B1';
+export function getUmbracoLogo(version) {
+    const logo = `
+        ██╗   ██╗███╗   ███╗██████╗ ██████╗  █████╗  ██████╗ ██████╗ 
+        ██║   ██║████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔═══██╗
+        ██║   ██║██╔████╔██║██████╔╝██████╔╝███████║██║     ██║   ██║
+        ██║   ██║██║╚██╔╝██║██╔══██╗██╔══██╗██╔══██║██║     ██║   ██║
+        ╚██████╔╝██║ ╚═╝ ██║██████╔╝██║  ██║██║  ██║╚██████╗╚██████╔╝
+         ╚═════╝ ╚═╝     ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+                    LTS Upgrade Audit Tool v${version}
+`;
+    return chalk.hex(UMBRACO_BLUE)(logo);
+}
+export function getH5YRFooter() {
+    return '\n#H5YR! 🙌 Thanks for using the Umbraco Upgrade Audit Tool!';
+}
+//# sourceMappingURL=ascii-logo.js.map

package/dist/cli/output/ascii-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-logo.js","sourceRoot":"","sources":["../../../src/cli/output/ascii-logo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;GAIG;AAEH,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,GAAG;;;;;;;8CAO+B,OAAO;CACpD,CAAC;IAEA,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,8DAA8D,CAAC;AACxE,CAAC"}

package/dist/cli/output/formatters/console.d.ts

@@ -0,0 +1,11 @@
+import type { AuditReport } from '../../../models/report.js';
+/**
+ * Console formatter with logo, table, and totals
+ *
+ * Output format:
+ * 1. Umbraco ASCII logo in brand blue
+ * 2. Results table
+ * 3. H5YR footer message
+ */
+export declare function formatConsoleOutput(report: AuditReport, verbose: boolean): string;
+//# sourceMappingURL=console.d.ts.map

package/dist/cli/output/formatters/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/cli/output/formatters/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D;;;;;;;GAOG;AAEH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CA2CjF"}

package/dist/cli/output/formatters/console.js

@@ -0,0 +1,46 @@
+import { getH5YRFooter, getUmbracoLogo } from '../ascii-logo.js';
+import { renderResultsTable } from '../table-renderer.js';
+/**
+ * Console formatter with logo, table, and totals
+ *
+ * Output format:
+ * 1. Umbraco ASCII logo in brand blue
+ * 2. Results table
+ * 3. H5YR footer message
+ */
+export function formatConsoleOutput(report, verbose) {
+    const output = [];
+    // 1. Logo
+    output.push(getUmbracoLogo(report.toolVersion));
+    output.push('\n');
+    // 2. Table
+    output.push(renderResultsTable(report));
+    output.push('\n');
+    // 3. Verbose findings (if enabled)
+    if (verbose && report.findings.length > 0) {
+        output.push('Detailed Findings:\n');
+        output.push('─'.repeat(80));
+        output.push('\n\n');
+        for (const finding of report.findings) {
+            output.push(`[${finding.ruleId}] ${finding.filePath}:${finding.lineNumber}\n`);
+            output.push(`  ${finding.lineContent}\n`);
+            if (finding.codeSnippet) {
+                output.push('\n  Code context:\n');
+                finding.codeSnippet.before.forEach((line, idx) => {
+                    output.push(`    ${finding.codeSnippet.startLine + idx} | ${line}\n`);
+                });
+                output.push(`  → ${finding.lineNumber} | ${finding.codeSnippet.line}\n`);
+                finding.codeSnippet.after.forEach((line, idx) => {
+                    output.push(`    ${finding.lineNumber + idx + 1} | ${line}\n`);
+                });
+            }
+            output.push('\n');
+        }
+        output.push('─'.repeat(80));
+        output.push('\n\n');
+    }
+    // 4. Footer
+    output.push(getH5YRFooter());
+    return output.join('');
+}
+//# sourceMappingURL=console.js.map

package/dist/cli/output/formatters/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../src/cli/output/formatters/console.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;GAOG;AAEH,MAAM,UAAU,mBAAmB,CAAC,MAAmB,EAAE,OAAgB;IACvE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,UAAU;IACV,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElB,WAAW;IACX,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElB,mCAAmC;IACnC,IAAI,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;YAE1C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;gBACnC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;oBAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,WAAY,CAAC,SAAS,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC;gBACzE,CAAC,CAAC,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC;gBACzE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;oBAC9C,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,UAAU,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;gBACjE,CAAC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,YAAY;IACZ,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/dist/cli/output/formatters/html.d.ts

@@ -0,0 +1,3 @@
+import type { AuditReport } from '../../../models/report.js';
+export declare function formatHtmlOutput(report: AuditReport): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/cli/output/formatters/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/cli/output/formatters/html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAW7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuN5D"}