umbaudit 0.1.0

package/dist/scanners/code-searcher.js

@@ -0,0 +1,76 @@
+import { readFile } from 'node:fs/promises';
+import { debug } from '../utils/logger.js';
+/**
+ * Search for a pattern in a file
+ *
+ * @param filePath - File to search
+ * @param pattern - Regex pattern or string to find
+ * @param caseSensitive - Whether search is case-sensitive
+ * @returns Array of matches
+ */
+export async function searchInFile(filePath, pattern, caseSensitive = true) {
+    debug(`Searching in file: ${filePath}`);
+    debug(`Pattern: ${pattern}`);
+    const content = await readFile(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const matches = [];
+    const regex = typeof pattern === 'string' ? new RegExp(pattern, caseSensitive ? 'g' : 'gi') : pattern;
+    lines.forEach((line, index) => {
+        if (regex.test(line)) {
+            matches.push({
+                lineNumber: index + 1, // Convert to 1-based
+                lineContent: line.trim(),
+                filePath,
+            });
+            // Reset regex lastIndex for global regexes
+            regex.lastIndex = 0;
+        }
+    });
+    debug(`Found ${matches.length} matches in ${filePath}`);
+    return matches;
+}
+/**
+ * Extract code snippet with surrounding context
+ *
+ * @param filePath - File to extract from
+ * @param lineNumber - Center line (1-based)
+ * @param contextLines - Number of lines before/after
+ * @returns Code snippet with context
+ */
+export async function extractCodeSnippet(filePath, lineNumber, contextLines = 3) {
+    const content = await readFile(filePath, 'utf-8');
+    const lines = content.split('\n');
+    // Convert to 0-based index
+    const index = lineNumber - 1;
+    // Calculate bounds
+    const startIndex = Math.max(0, index - contextLines);
+    const endIndex = Math.min(lines.length - 1, index + contextLines);
+    const before = lines.slice(startIndex, index);
+    const line = lines[index] || '';
+    const after = lines.slice(index + 1, endIndex + 1);
+    return {
+        before,
+        line,
+        after,
+        startLine: startIndex + 1, // Convert back to 1-based
+    };
+}
+/**
+ * Search for multiple patterns in a file (OR logic)
+ *
+ * @param filePath - File to search
+ * @param patterns - Array of patterns
+ * @param caseSensitive - Whether search is case-sensitive
+ * @returns Array of matches
+ */
+export async function searchMultiplePatterns(filePath, patterns, caseSensitive = true) {
+    const allMatches = [];
+    for (const pattern of patterns) {
+        const matches = await searchInFile(filePath, pattern, caseSensitive);
+        allMatches.push(...matches);
+    }
+    // Remove duplicates based on line number
+    const uniqueMatches = Array.from(new Map(allMatches.map((m) => [m.lineNumber, m])).values());
+    return uniqueMatches.sort((a, b) => a.lineNumber - b.lineNumber);
+}
+//# sourceMappingURL=code-searcher.js.map

package/dist/scanners/code-searcher.js.map

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

package/dist/scanners/csproj-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * .csproj XML parsing utilities
+ *
+ * Why: NuGet package references are in XML format.
+ * fast-xml-parser handles .NET XML quirks reliably.
+ */
+/**
+ * Package reference from .csproj
+ */
+export interface PackageReference {
+    name: string;
+    version: string;
+}
+/**
+ * Parse .csproj file and extract package references
+ *
+ * @param csprojPath - Absolute path to .csproj file
+ * @returns Array of package references
+ */
+export declare function parseProjectFile(csprojPath: string): Promise<PackageReference[]>;
+/**
+ * Check if a package name matches Umbraco packages
+ *
+ * @param packageName - Package name to check
+ * @returns True if it's an Umbraco package
+ */
+export declare function isUmbracoPackage(packageName: string): boolean;
+/**
+ * Extract Umbraco version from package references
+ *
+ * @param packages - List of package references
+ * @returns Umbraco version string or null
+ */
+export declare function extractUmbracoVersion(packages: PackageReference[]): string | null;
+//# sourceMappingURL=csproj-parser.d.ts.map

package/dist/scanners/csproj-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csproj-parser.d.ts","sourceRoot":"","sources":["../../src/scanners/csproj-parser.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2CtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,CAUjF"}

package/dist/scanners/csproj-parser.js

@@ -0,0 +1,71 @@
+import { readFile } from 'node:fs/promises';
+import { XMLParser } from 'fast-xml-parser';
+import { debug } from '../utils/logger.js';
+/**
+ * Parse .csproj file and extract package references
+ *
+ * @param csprojPath - Absolute path to .csproj file
+ * @returns Array of package references
+ */
+export async function parseProjectFile(csprojPath) {
+    debug(`Parsing .csproj file: ${csprojPath}`);
+    const content = await readFile(csprojPath, 'utf-8');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+    });
+    const parsed = parser.parse(content);
+    const packages = [];
+    // Navigate the XML structure to find PackageReference elements
+    const project = parsed.Project;
+    if (!project) {
+        debug('No Project element found in .csproj');
+        return packages;
+    }
+    // ItemGroup can be a single object or an array
+    const itemGroups = Array.isArray(project.ItemGroup) ? project.ItemGroup : [project.ItemGroup];
+    for (const itemGroup of itemGroups) {
+        if (!itemGroup)
+            continue;
+        // PackageReference can be a single object or an array
+        const packageRefs = itemGroup.PackageReference;
+        if (!packageRefs)
+            continue;
+        const refs = Array.isArray(packageRefs) ? packageRefs : [packageRefs];
+        for (const ref of refs) {
+            const name = ref['@_Include'];
+            const version = ref['@_Version'];
+            if (name && version) {
+                packages.push({ name, version });
+            }
+        }
+    }
+    debug(`Found ${packages.length} package references`);
+    return packages;
+}
+/**
+ * Check if a package name matches Umbraco packages
+ *
+ * @param packageName - Package name to check
+ * @returns True if it's an Umbraco package
+ */
+export function isUmbracoPackage(packageName) {
+    return packageName.startsWith('Umbraco.');
+}
+/**
+ * Extract Umbraco version from package references
+ *
+ * @param packages - List of package references
+ * @returns Umbraco version string or null
+ */
+export function extractUmbracoVersion(packages) {
+    // Look for Umbraco.Cms package
+    const umbracoCms = packages.find((p) => p.name === 'Umbraco.Cms');
+    if (umbracoCms) {
+        return umbracoCms.version;
+    }
+    // Fallback to any Umbraco.* package
+    const umbracoPackage = packages.find((p) => isUmbracoPackage(p.name));
+    return umbracoPackage?.version || null;
+}
+//# sourceMappingURL=csproj-parser.js.map

package/dist/scanners/csproj-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csproj-parser.js","sourceRoot":"","sources":["../../src/scanners/csproj-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAiB3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,+DAA+D;IAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9F,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,sDAAsD;QACtD,MAAM,WAAW,GAAG,SAAS,CAAC,gBAAgB,CAAC;QAC/C,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAEtE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;YAEjC,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,QAAQ,CAAC,MAAM,qBAAqB,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IAClE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,OAAO,cAAc,EAAE,OAAO,IAAI,IAAI,CAAC;AACzC,CAAC"}

package/dist/scanners/file-scanner.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Recursively discover files matching patterns
+ *
+ * Why: Constitution principle IV (Performance) requires efficient scanning.
+ * fast-glob is optimized for large directory trees.
+ */
+/**
+ * Scan for files matching glob patterns
+ *
+ * @param patterns - Glob patterns to match
+ * @param cwd - Current working directory (project root)
+ * @param ignore - Patterns to ignore
+ * @returns Array of absolute file paths
+ */
+export declare function scanFiles(patterns: string | string[], cwd: string, ignore?: string[]): Promise<string[]>;
+/**
+ * Find all .csproj files in a directory tree
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .csproj file paths
+ */
+export declare function findProjectFiles(projectPath: string): Promise<string[]>;
+/**
+ * Find all C# source files
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .cs file paths
+ */
+export declare function findCSharpFiles(projectPath: string): Promise<string[]>;
+/**
+ * Find all JavaScript/TypeScript files in App_Plugins
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .js/.ts file paths
+ */
+export declare function findAppPluginFiles(projectPath: string): Promise<string[]>;
+/**
+ * Find all Razor view files
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .cshtml file paths
+ */
+export declare function findRazorFiles(projectPath: string): Promise<string[]>;
+//# sourceMappingURL=file-scanner.d.ts.map

package/dist/scanners/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/file-scanner.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,EAAqD,GAClE,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE7E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5E;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E"}

package/dist/scanners/file-scanner.js

@@ -0,0 +1,66 @@
+import fg from 'fast-glob';
+import { debug } from '../utils/logger.js';
+/**
+ * Recursively discover files matching patterns
+ *
+ * Why: Constitution principle IV (Performance) requires efficient scanning.
+ * fast-glob is optimized for large directory trees.
+ */
+/**
+ * Scan for files matching glob patterns
+ *
+ * @param patterns - Glob patterns to match
+ * @param cwd - Current working directory (project root)
+ * @param ignore - Patterns to ignore
+ * @returns Array of absolute file paths
+ */
+export async function scanFiles(patterns, cwd, ignore = ['**/node_modules/**', '**/bin/**', '**/obj/**']) {
+    debug(`Scanning files with patterns: ${JSON.stringify(patterns)}`);
+    debug(`CWD: ${cwd}`);
+    debug(`Ignore: ${JSON.stringify(ignore)}`);
+    const files = await fg(patterns, {
+        cwd,
+        absolute: true,
+        ignore,
+        onlyFiles: true,
+    });
+    debug(`Found ${files.length} files`);
+    return files;
+}
+/**
+ * Find all .csproj files in a directory tree
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .csproj file paths
+ */
+export async function findProjectFiles(projectPath) {
+    return scanFiles('**/*.csproj', projectPath);
+}
+/**
+ * Find all C# source files
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .cs file paths
+ */
+export async function findCSharpFiles(projectPath) {
+    return scanFiles('**/*.cs', projectPath);
+}
+/**
+ * Find all JavaScript/TypeScript files in App_Plugins
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .js/.ts file paths
+ */
+export async function findAppPluginFiles(projectPath) {
+    return scanFiles('**/App_Plugins/**/*.{js,ts,html}', projectPath);
+}
+/**
+ * Find all Razor view files
+ *
+ * @param projectPath - Root path to scan
+ * @returns Array of .cshtml file paths
+ */
+export async function findRazorFiles(projectPath) {
+    return scanFiles('**/*.cshtml', projectPath);
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/scanners/file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../../src/scanners/file-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAA2B,EAC3B,GAAW,EACX,SAAmB,CAAC,oBAAoB,EAAE,WAAW,EAAE,WAAW,CAAC;IAEnE,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnE,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IACrB,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,GAAG;QACH,QAAQ,EAAE,IAAI;QACd,MAAM;QACN,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,OAAO,SAAS,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB;IACvD,OAAO,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,OAAO,SAAS,CAAC,kCAAkC,EAAE,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,OAAO,SAAS,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC"}

package/dist/scanners/nuget-client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * NuGet API client for package version lookup
+ */
+/**
+ * Package metadata from NuGet API
+ */
+export interface NuGetPackageMetadata {
+    packageName: string;
+    latestVersion: string | null;
+    isCompatible: boolean | null;
+    error?: string;
+}
+export declare function clearPackageCache(): void;
+export declare function queryNuGetPackage(packageName: string): Promise<NuGetPackageMetadata | null>;
+/**
+ * Batch helper
+ */
+export declare function batchQueryPackages(packageNames: string[]): Promise<Map<string, NuGetPackageMetadata | null>>;
+//# sourceMappingURL=nuget-client.d.ts.map

package/dist/scanners/nuget-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuget-client.d.ts","sourceRoot":"","sources":["../../src/scanners/nuget-client.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAuDjG;AA+KD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC,CAAC,CAUlH"}

package/dist/scanners/nuget-client.js

@@ -0,0 +1,208 @@
+import { debug, warn } from '../utils/logger.js';
+const packageCache = new Map();
+export function clearPackageCache() {
+    packageCache.clear();
+}
+export async function queryNuGetPackage(packageName) {
+    if (packageCache.has(packageName)) {
+        debug(`Cache hit for package: ${packageName}`);
+        return packageCache.get(packageName);
+    }
+    debug(`Querying NuGet API for package: ${packageName}`);
+    try {
+        const latestEntry = await fetchLatestStableEntry(packageName);
+        if (!latestEntry) {
+            const metadata = {
+                packageName,
+                latestVersion: null,
+                isCompatible: null,
+                error: 'No stable versions found',
+            };
+            packageCache.set(packageName, metadata);
+            warn(`No stable package metadata found for: ${packageName}`);
+            return metadata;
+        }
+        const { version: latestVersion, dependencyGroups } = latestEntry;
+        let targetFrameworks = dependencyGroups?.map((g) => g.targetFramework).filter((f) => !!f) ?? [];
+        if (targetFrameworks.length === 0) {
+            debug(`Falling back to nuspec for ${packageName}@${latestVersion}`);
+            targetFrameworks = await fetchFrameworksFromNuspec(packageName, latestVersion);
+        }
+        const isCompatible = targetFrameworks.length === 0 ? null : isSupportedFramework(targetFrameworks);
+        const metadata = {
+            packageName,
+            latestVersion,
+            isCompatible,
+        };
+        packageCache.set(packageName, metadata);
+        debug(`Retrieved package metadata: ${JSON.stringify(metadata)}`);
+        return metadata;
+    }
+    catch (error) {
+        debug(`Failed to query NuGet API for ${packageName}: ${error}`);
+        warn(`Failed to retrieve package metadata for: ${packageName}`);
+        const metadata = {
+            packageName,
+            latestVersion: null,
+            isCompatible: null,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        packageCache.set(packageName, metadata);
+        return metadata;
+    }
+}
+/* -------------------------------------------------------------------------- */
+/*                                Core logic                                  */
+/* -------------------------------------------------------------------------- */
+/**
+ * Fetch the latest stable catalog entry (SemVer2, prerelease excluded).
+ * This supports both:
+ *  • index with inline items
+ *  • index pointing to page URLs
+ */
+async function fetchLatestStableEntry(packageName) {
+    const indexUrl = `https://api.nuget.org/v3/registration5-gz-semver2/${packageName.toLowerCase()}/index.json`;
+    const indexResponse = await fetch(indexUrl);
+    if (indexResponse.status === 404)
+        return null;
+    if (!indexResponse.ok) {
+        throw new Error(`NuGet API error: ${indexResponse.status}`);
+    }
+    const index = (await indexResponse.json());
+    // Try to extract entries from inline items first
+    if (Array.isArray(index.items) && index.items.length > 0) {
+        const inlineEntries = extractEntriesFromInlineItems(index.items);
+        const stableInline = findLatestStable(inlineEntries);
+        if (stableInline)
+            return stableInline;
+    }
+    // Fallback: fetch pages from @id (for non-inline formats)
+    const pages = Array.isArray(index.items) ? index.items : [];
+    for (let p = pages.length - 1; p >= 0; p--) {
+        const pageUrl = pages[p]['@id'];
+        if (!pageUrl)
+            continue;
+        const pageResponse = await fetch(pageUrl);
+        if (!pageResponse.ok)
+            continue;
+        const page = (await pageResponse.json());
+        if (Array.isArray(page.items)) {
+            const entries = extractEntriesFromInlineItems(page.items);
+            const stable = findLatestStable(entries);
+            if (stable)
+                return stable;
+        }
+    }
+    return null;
+}
+/**
+ * Helper to flatten "items" blocks (index or page) into {version, dependencyGroups}
+ * Handles both inline format (Serilog) and page format (Umbraco.Cloud.Cms.PublicAccess)
+ */
+function extractEntriesFromInlineItems(items) {
+    const result = [];
+    for (const item of items) {
+        // Check if this item has nested items array (inline format like Serilog)
+        if (Array.isArray(item.items)) {
+            for (const subItem of item.items) {
+                const catalogEntry = subItem.catalogEntry;
+                if (catalogEntry && typeof catalogEntry.version === 'string') {
+                    result.push({
+                        version: catalogEntry.version,
+                        dependencyGroups: catalogEntry.dependencyGroups,
+                    });
+                }
+            }
+        }
+        // Also check if the item itself has catalogEntry (some formats)
+        else if (item.catalogEntry && typeof item.catalogEntry.version === 'string') {
+            result.push({
+                version: item.catalogEntry.version,
+                dependencyGroups: item.catalogEntry.dependencyGroups,
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Parse a semantic version string into comparable parts
+ */
+function parseSemanticVersion(version) {
+    const parts = version.split('.').map((p) => {
+        const num = parseInt(p, 10);
+        return Number.isNaN(num) ? 0 : num;
+    });
+    // Ensure we have at least [major, minor, patch]
+    while (parts.length < 3)
+        parts.push(0);
+    return parts;
+}
+/**
+ * Compare two semantic versions: returns -1 if a < b, 0 if equal, 1 if a > b
+ */
+function compareSemanticVersions(a, b) {
+    const aParts = parseSemanticVersion(a);
+    const bParts = parseSemanticVersion(b);
+    const maxLength = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < maxLength; i++) {
+        const aVal = aParts[i] ?? 0;
+        const bVal = bParts[i] ?? 0;
+        if (aVal < bVal)
+            return -1;
+        if (aVal > bVal)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Pick highest stable (semver) from a flat array
+ */
+function findLatestStable(entries) {
+    // Filter stable versions and sort by proper semantic version comparison
+    const sorted = entries
+        .filter((e) => isStableVersion(e.version))
+        .sort((a, b) => compareSemanticVersions(b.version, a.version)); // descending order
+    return sorted.length > 0 ? sorted[0] : null;
+}
+/**
+ * Extract frameworks from .nuspec (source of truth fallback)
+ */
+async function fetchFrameworksFromNuspec(packageName, version) {
+    const id = packageName.toLowerCase();
+    const url = `https://api.nuget.org/v3-flatcontainer/${id}/${version}/${id}.nuspec`;
+    const response = await fetch(url);
+    if (!response.ok)
+        return [];
+    const xml = await response.text();
+    return Array.from(xml.matchAll(/<group\s+targetFramework="([^"]+)"/gi)).map((match) => match[1]);
+}
+/**
+ * Compatibility rule
+ */
+function isSupportedFramework(targetFrameworks) {
+    return targetFrameworks.some((tf) => tf.includes('net10.0') ||
+        tf.includes('net9.0') ||
+        tf.includes('net8.0') ||
+        tf.includes('netstandard2.0') ||
+        tf.includes('.NETStandard2.0'));
+}
+/**
+ * Stable SemVer check
+ */
+function isStableVersion(version) {
+    // Any '-' means prerelease in SemVer
+    return !version.includes('-');
+}
+/**
+ * Batch helper
+ */
+export async function batchQueryPackages(packageNames) {
+    debug(`Batch querying ${packageNames.length} packages`);
+    const results = new Map();
+    await Promise.all(packageNames.map(async (name) => {
+        const metadata = await queryNuGetPackage(name);
+        results.set(name, metadata);
+    }));
+    return results;
+}
+//# sourceMappingURL=nuget-client.js.map

package/dist/scanners/nuget-client.js.map

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

package/dist/utils/hours.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hour calculation utilities
+ *
+ * Why: Implements linear scaling per clarification decision.
+ * Hours scale as: total = baseHours × instanceCount
+ */
+/**
+ * Calculate total hours using linear scaling
+ *
+ * @param baseHours - Base hours per instance
+ * @param instanceCount - Number of instances found
+ * @returns Total hours (rounded to 0.5h granularity)
+ */
+export declare function calculateHours(baseHours: number, instanceCount: number): number;
+/**
+ * Round hours to 0.5h granularity (30 minutes minimum)
+ *
+ * @param hours - Raw hour value
+ * @returns Hours rounded to nearest 0.5
+ */
+export declare function roundToHalfHour(hours: number): number;
+/**
+ * Convert hours to days (8 hours = 1 day)
+ *
+ * @param hours - Hours to convert
+ * @returns Days (rounded to 1 decimal place)
+ */
+export declare function hoursToDays(hours: number): number;
+//# sourceMappingURL=hours.d.ts.map

package/dist/utils/hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hours.d.ts","sourceRoot":"","sources":["../../src/utils/hours.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/hours.js

@@ -0,0 +1,36 @@
+/**
+ * Hour calculation utilities
+ *
+ * Why: Implements linear scaling per clarification decision.
+ * Hours scale as: total = baseHours × instanceCount
+ */
+/**
+ * Calculate total hours using linear scaling
+ *
+ * @param baseHours - Base hours per instance
+ * @param instanceCount - Number of instances found
+ * @returns Total hours (rounded to 0.5h granularity)
+ */
+export function calculateHours(baseHours, instanceCount) {
+    const total = baseHours * instanceCount;
+    return roundToHalfHour(total);
+}
+/**
+ * Round hours to 0.5h granularity (30 minutes minimum)
+ *
+ * @param hours - Raw hour value
+ * @returns Hours rounded to nearest 0.5
+ */
+export function roundToHalfHour(hours) {
+    return Math.round(hours * 2) / 2;
+}
+/**
+ * Convert hours to days (8 hours = 1 day)
+ *
+ * @param hours - Hours to convert
+ * @returns Days (rounded to 1 decimal place)
+ */
+export function hoursToDays(hours) {
+    return Math.round((hours / 8) * 10) / 10;
+}
+//# sourceMappingURL=hours.js.map

package/dist/utils/hours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hours.js","sourceRoot":"","sources":["../../src/utils/hours.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,aAAqB;IACrE,MAAM,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC;IACxC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC3C,CAAC"}