@vibe-agent-toolkit/cli 0.1.0-rc.9 → 0.1.1

package/dist/commands/audit/hierarchical-output.js

@@ -0,0 +1,267 @@
+import * as os from 'node:os';
+import { toForwardSlash } from '@vibe-agent-toolkit/utils';
+/**
+ * Replace home directory with ~ for cleaner paths
+ * Normalizes paths for cross-platform comparison (handles Windows backslashes)
+ */
+function replaceHomeDir(filePath) {
+    const homeDir = os.homedir();
+    // Normalize both paths to forward slashes for comparison
+    const normalizedFilePath = toForwardSlash(filePath);
+    const normalizedHomeDir = toForwardSlash(homeDir);
+    if (normalizedFilePath.startsWith(normalizedHomeDir)) {
+        // Replace using original paths to preserve platform separators in output
+        return filePath.replace(homeDir, '~');
+    }
+    return filePath;
+}
+/**
+ * Parse path structure to extract marketplace, plugin, and skill names
+ *
+ * Expected patterns:
+ * - Marketplace plugin skill: .../marketplaces/{marketplace}/{plugin}/skills/{skill}/SKILL.md
+ * - Standalone plugin skill: .../plugins/{plugin}/skills/{skill}/SKILL.md (no marketplaces/)
+ * - Standalone skill: .../plugins/{skill}/SKILL.md (no skills/)
+ */
+function parsePathStructure(filePath) {
+    // Normalize to forward slashes for cross-platform parsing
+    const normalizedPath = toForwardSlash(filePath);
+    const parts = normalizedPath.split('/');
+    // Detect if this is a cached resource
+    const isCached = parts.includes('cache');
+    // Find key indices
+    const marketplacesIdx = parts.indexOf('marketplaces');
+    const pluginsIdx = parts.indexOf('plugins');
+    const skillsIdx = parts.indexOf('skills');
+    // Marketplace plugin skill: .../marketplaces/{marketplace}/{plugin}/skills/{skill}/SKILL.md
+    if (marketplacesIdx >= 0 && skillsIdx >= 0) {
+        const marketplace = parts[marketplacesIdx + 1];
+        const plugin = parts[marketplacesIdx + 2];
+        const skill = parts[skillsIdx + 1];
+        if (marketplace !== undefined && plugin !== undefined && skill !== undefined) {
+            return { marketplace, plugin, skill, isCached };
+        }
+    }
+    // Standalone plugin skill: .../plugins/{plugin}/skills/{skill}/SKILL.md
+    if (pluginsIdx >= 0 && skillsIdx >= 0) {
+        const plugin = parts[skillsIdx - 1]; // Plugin name is before /skills/
+        const skill = parts[skillsIdx + 1];
+        if (plugin !== undefined && skill !== undefined) {
+            return { plugin, skill, isCached };
+        }
+    }
+    // Standalone skill: .../plugins/{skill}/SKILL.md
+    if (pluginsIdx >= 0) {
+        const skill = parts[pluginsIdx + 1];
+        if (skill !== undefined) {
+            return { skill, isCached };
+        }
+    }
+    // Fallback: use directory name before SKILL.md
+    const skill = parts.at(-2) ?? 'unknown';
+    return { skill, isCached };
+}
+/**
+ * Add skill entry to marketplace map
+ */
+function addToMarketplaceMap(marketplacesMap, marketplace, plugin, entry) {
+    if (!marketplacesMap.has(marketplace)) {
+        marketplacesMap.set(marketplace, new Map());
+    }
+    const pluginsMap = marketplacesMap.get(marketplace);
+    if (pluginsMap === undefined) {
+        return;
+    }
+    if (!pluginsMap.has(plugin)) {
+        pluginsMap.set(plugin, []);
+    }
+    pluginsMap.get(plugin)?.push(entry);
+}
+/**
+ * Add skill entry to cached plugin map
+ */
+function addToCachedPluginMap(cachedPluginsMap, plugin, entry) {
+    if (!cachedPluginsMap.has(plugin)) {
+        cachedPluginsMap.set(plugin, []);
+    }
+    cachedPluginsMap.get(plugin)?.push(entry);
+}
+/**
+ * Add skill entry to standalone plugin map
+ */
+function addToStandalonePluginMap(standalonePluginsMap, plugin, entry) {
+    if (!standalonePluginsMap.has(plugin)) {
+        standalonePluginsMap.set(plugin, []);
+    }
+    standalonePluginsMap.get(plugin)?.push(entry);
+}
+/**
+ * Filter out duplicate cache results that match their source
+ *
+ * Suppresses cache entries when:
+ * - A matching source (marketplace/plugin) exists
+ * - Same validation status (success/warning/error)
+ * - Same issues (count and content)
+ *
+ * Keeps cache entries when:
+ * - No matching source found (orphaned cache)
+ * - Different validation status or issues (stale/different)
+ *
+ * @returns Filtered results and cache status map
+ */
+function filterCacheDuplicates(results) {
+    const sourceBySkillName = new Map();
+    const cacheResults = [];
+    const nonCacheResults = [];
+    const cacheStatusMap = new Map();
+    // First pass: categorize results and build source index
+    for (const result of results) {
+        const { skill, isCached } = parsePathStructure(result.path);
+        if (isCached) {
+            cacheResults.push(result);
+        }
+        else {
+            nonCacheResults.push(result);
+            // Index source results by skill name for matching
+            sourceBySkillName.set(skill, result);
+        }
+    }
+    // Second pass: filter cache results and track status
+    const filteredCache = [];
+    for (const cacheResult of cacheResults) {
+        const { skill } = parsePathStructure(cacheResult.path);
+        const sourceResult = sourceBySkillName.get(skill);
+        if (!sourceResult) {
+            // Orphaned cache - no matching source, keep it
+            filteredCache.push(cacheResult);
+            cacheStatusMap.set(cacheResult.path, 'orphaned');
+            continue;
+        }
+        // Check if cache and source have identical validation results
+        const statusMatches = cacheResult.status === sourceResult.status;
+        const issuesMatch = cacheResult.issues.length === sourceResult.issues.length &&
+            cacheResult.issues.every((issue, idx) => issue.code === sourceResult.issues[idx]?.code &&
+                issue.severity === sourceResult.issues[idx]?.severity);
+        if (!statusMatches || !issuesMatch) {
+            // Different validation results - keep both (stale or different)
+            filteredCache.push(cacheResult);
+            cacheStatusMap.set(cacheResult.path, 'stale');
+        }
+        else {
+            // Fresh cache - matches source, will be suppressed
+            cacheStatusMap.set(cacheResult.path, 'fresh');
+        }
+        // If they match exactly, suppress the cache copy (don't add to filteredCache)
+    }
+    return {
+        filtered: [...nonCacheResults, ...filteredCache],
+        cacheStatusMap,
+    };
+}
+/**
+ * Create skill entry from validation result
+ */
+function createSkillEntry(result, cacheStatusMap) {
+    const { skill, isCached } = parsePathStructure(result.path);
+    const entry = {
+        name: skill,
+        path: replaceHomeDir(result.path),
+        status: result.status,
+        issues: result.issues,
+    };
+    // Add cache status if this is a cached resource
+    if (isCached) {
+        const cacheStatus = cacheStatusMap.get(result.path);
+        if (cacheStatus !== undefined) {
+            entry.cacheStatus = cacheStatus;
+        }
+    }
+    return entry;
+}
+/**
+ * Categorize entry into appropriate map
+ */
+function categorizeEntry(entry, marketplace, plugin, isCached, maps) {
+    if (marketplace !== undefined && plugin !== undefined) {
+        addToMarketplaceMap(maps.marketplacesMap, marketplace, plugin, entry);
+    }
+    else if (plugin === undefined) {
+        maps.standaloneSkills.push(entry);
+    }
+    else if (isCached) {
+        addToCachedPluginMap(maps.cachedPluginsMap, plugin, entry);
+    }
+    else {
+        addToStandalonePluginMap(maps.standalonePluginsMap, plugin, entry);
+    }
+}
+/**
+ * Convert marketplace map to array structure
+ */
+function convertMarketplacesMapToArray(marketplacesMap) {
+    const marketplaces = [];
+    for (const [marketplaceName, pluginsMap] of marketplacesMap) {
+        const plugins = [];
+        for (const [pluginName, skills] of pluginsMap) {
+            plugins.push({ name: pluginName, skills });
+        }
+        marketplaces.push({ name: marketplaceName, plugins });
+    }
+    return marketplaces;
+}
+/**
+ * Convert plugin map to array structure
+ */
+function convertPluginMapToArray(pluginMap) {
+    const plugins = [];
+    for (const [pluginName, skills] of pluginMap) {
+        plugins.push({ name: pluginName, skills });
+    }
+    return plugins;
+}
+/**
+ * Build hierarchical output structure from validation results.
+ *
+ * Groups skills by:
+ * 1. Marketplace -> Plugin -> Skills (for marketplace-installed plugins)
+ * 2. Standalone Plugins -> Skills (for non-marketplace plugins)
+ * 3. Standalone Skills (for skills without plugins)
+ *
+ * By default, only includes skills with issues (terse principle).
+ * With verbose=true, includes all scanned skills regardless of status.
+ * Replaces home directory with ~ for cleaner display.
+ *
+ * @param results - Validation results from audit command
+ * @param verbose - If true, include all results; if false, only show results with issues
+ * @returns Hierarchical structure for display
+ */
+export function buildHierarchicalOutput(results, verbose = false) {
+    // Filter out cache duplicates that match their source
+    const { filtered: filteredResults, cacheStatusMap } = filterCacheDuplicates(results);
+    const marketplacesMap = new Map();
+    const cachedPluginsMap = new Map();
+    const standalonePluginsMap = new Map();
+    const standaloneSkills = [];
+    const maps = {
+        marketplacesMap,
+        cachedPluginsMap,
+        standalonePluginsMap,
+        standaloneSkills,
+    };
+    for (const result of filteredResults) {
+        // Only include results with issues (terse principle), unless verbose mode
+        if (!verbose && result.status === 'success') {
+            continue;
+        }
+        const { marketplace, plugin, isCached } = parsePathStructure(result.path);
+        const entry = createSkillEntry(result, cacheStatusMap);
+        categorizeEntry(entry, marketplace, plugin, isCached, maps);
+    }
+    return {
+        marketplaces: convertMarketplacesMapToArray(marketplacesMap),
+        cachedPlugins: convertPluginMapToArray(cachedPluginsMap),
+        standalonePlugins: convertPluginMapToArray(standalonePluginsMap),
+        standaloneSkills,
+    };
+}
+//# sourceMappingURL=hierarchical-output.js.map

package/dist/commands/audit/hierarchical-output.js.map

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

package/dist/commands/audit.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Audit command - audits plugins, marketplaces, registries, and Claude Skills
+ * Top-level command: vat audit [path]
+ */
+import { Command } from 'commander';
+export interface AuditCommandOptions {
+    debug?: boolean;
+    recursive?: boolean;
+    user?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Create audit command
+ * Top-level command: vat audit [path]
+ */
+export declare function createAuditCommand(): Command;
+export declare function auditCommand(targetPath: string | undefined, options: AuditCommandOptions): Promise<void>;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAyD5C;AAWD,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/commands/audit.js

@@ -0,0 +1,386 @@
+/**
+ * Audit command - audits plugins, marketplaces, registries, and Claude Skills
+ * Top-level command: vat audit [path]
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { detectFormat } from '@vibe-agent-toolkit/discovery';
+import { detectResourceFormat, validate, validateSkill, } from '@vibe-agent-toolkit/runtime-claude-skills';
+import { Command } from 'commander';
+import { handleCommandError } from '../utils/command-error.js';
+import { createLogger } from '../utils/logger.js';
+import { writeYamlOutput } from '../utils/output.js';
+import { buildHierarchicalOutput } from './audit/hierarchical-output.js';
+/**
+ * Create audit command
+ * Top-level command: vat audit [path]
+ */
+export function createAuditCommand() {
+    const audit = new Command('audit');
+    audit
+        .description('Audit Claude plugins, marketplaces, registries, and skills')
+        .argument('[path]', 'Path to audit (default: current directory)')
+        .option('-r, --recursive', 'Scan directories recursively for all resource types')
+        .option('--user', 'Audit user-level Claude plugins installation (~/.claude/plugins)')
+        .option('--verbose', 'Show all scanned resources, including those without issues')
+        .option('--debug', 'Enable debug logging')
+        .action(auditCommand)
+        .addHelpText('after', `
+Description:
+  Audits Claude plugins, marketplaces, registries, and Claude Skills for
+  quality, correctness, and compatibility. Automatically detects resource
+  type and validates accordingly. Outputs YAML report to stdout,
+  errors/warnings to stderr.
+
+  Supported resource types:
+  - Plugin directories (.claude-plugin/plugin.json)
+  - Marketplace directories (.claude-plugin/marketplace.json)
+  - Registry files (installed_plugins.json, known_marketplaces.json)
+  - Claude Skills (SKILL.md files)
+  - VAT agents (agent.yaml + SKILL.md)
+
+  Path can be: resource directory, registry file, SKILL.md file, or scan directory
+  Default: current directory
+  Use --user to audit user-level installation (~/.claude/plugins) automatically
+
+Validation Checks:
+  Errors (must fix):
+  - Missing or invalid manifests/frontmatter
+  - Schema validation failures
+  - Broken links to other files (Skills only)
+  - Reserved words in names (Skills only)
+  - XML tags in frontmatter fields (Skills only)
+  - Windows-style backslashes in paths (Skills only)
+
+  Warnings (should fix):
+  - Skill exceeds recommended length (>5000 lines)
+  - References console-incompatible tools (Skills only)
+
+Exit Codes:
+  0 - Success  |  1 - Errors found  |  2 - System error
+
+Examples:
+  $ vat audit --user                   # Audit user-level plugins installation
+  $ vat audit                          # Audit current directory
+  $ vat audit ./my-plugin              # Audit plugin directory
+  $ vat audit installed_plugins.json   # Audit registry file
+  $ vat audit ./resources --recursive  # Audit all resources recursively
+`);
+    return audit;
+}
+/**
+ * Get the user-level Claude plugins directory
+ * Cross-platform: ~/.claude/plugins on macOS/Linux, %USERPROFILE%\.claude\plugins on Windows
+ */
+function getUserPluginsDir() {
+    const homeDir = os.homedir();
+    return path.join(homeDir, '.claude', 'plugins');
+}
+export async function auditCommand(targetPath, options) {
+    const logger = createLogger(options.debug ? { debug: true } : {});
+    const startTime = Date.now();
+    try {
+        let scanPath;
+        let recursive = options.recursive ?? false;
+        // Handle --user flag
+        if (options.user) {
+            const userPluginsDir = getUserPluginsDir();
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- safe: path constructed from os.homedir()
+            if (!fs.existsSync(userPluginsDir)) {
+                logger.error(`User plugins directory not found: ${userPluginsDir}`);
+                logger.error('Claude plugins have not been installed yet.');
+                process.exit(2);
+            }
+            scanPath = userPluginsDir;
+            recursive = true; // Always recursive for user-level audit
+            logger.debug(`Auditing user-level plugins at: ${scanPath}`);
+        }
+        else {
+            scanPath = targetPath ? path.resolve(targetPath) : process.cwd();
+            logger.debug(`Auditing resources at: ${scanPath}`);
+        }
+        // Get validation results
+        const results = await getValidationResults(scanPath, recursive, logger);
+        // Use hierarchical output for --user flag, flat output otherwise
+        if (options.user) {
+            // Filter to only include claude-skill type for hierarchical output
+            const skillResults = results.filter((r) => r.type === 'claude-skill');
+            const hierarchical = buildHierarchicalOutput(skillResults, options.verbose ?? false);
+            const summary = calculateHierarchicalSummary(results, hierarchical, startTime);
+            writeYamlOutput(summary);
+            logHierarchicalSummary(results, hierarchical, logger);
+        }
+        else {
+            // Standard flat output
+            const summary = calculateSummary(results, startTime);
+            writeYamlOutput(summary);
+            handleAuditResults(results, summary, logger);
+        }
+    }
+    catch (error) {
+        handleCommandError(error, logger, startTime, 'AgentAudit');
+    }
+}
+async function getValidationResults(scanPath, recursive, logger) {
+    const format = detectFormat(scanPath);
+    // Special handling for direct SKILL.md file
+    if (format === 'claude-skill') {
+        logger.debug('Detected single Claude Skill');
+        const result = await validateSkill({ skillPath: scanPath });
+        return [result];
+    }
+    // Special handling for VAT agent: validate its SKILL.md
+    if (format === 'vat-agent') {
+        const skillPath = path.join(scanPath, 'SKILL.md');
+        logger.debug('Detected VAT agent, validating SKILL.md');
+        const result = await validateSkill({ skillPath, isVATGenerated: true });
+        return [result];
+    }
+    // For plugin/marketplace directories or registry files, use unified validator
+    const resourceFormat = await detectResourceFormat(scanPath);
+    if (resourceFormat.type !== 'unknown') {
+        logger.debug(`Detected ${resourceFormat.type} at: ${scanPath}`);
+        const result = await validate(scanPath);
+        return [result];
+    }
+    // If unknown format, check if it's a directory we can scan
+    const fs = await import('node:fs/promises');
+    try {
+        const stat = await fs.stat(scanPath);
+        if (stat.isDirectory()) {
+            logger.debug('Scanning directory for resources');
+            return scanDirectory(scanPath, recursive, logger);
+        }
+    }
+    catch {
+        // Path doesn't exist or not accessible, let validate() handle it
+    }
+    // Unknown resource type - use unified validator which will return appropriate error
+    logger.debug(`Unknown resource type at: ${scanPath}`);
+    const result = await validate(scanPath);
+    return [result];
+}
+function calculateSummary(results, startTime) {
+    const base = buildBaseSummary(results, startTime);
+    return {
+        ...base,
+        files: results,
+    };
+}
+function handleAuditResults(results, summary, logger) {
+    const { errors: errorCount, warnings: warningCount, success: successCount } = summary.summary;
+    if (errorCount > 0) {
+        logErrors(results, errorCount, logger);
+        process.exit(1);
+    }
+    if (warningCount > 0) {
+        logWarnings(results, warningCount, logger);
+    }
+    else {
+        logger.info(`Audit successful: ${successCount} file(s) passed`);
+    }
+    process.exit(0);
+}
+function logErrors(results, errorCount, logger) {
+    logger.error(`Audit failed: ${errorCount} file(s) with errors`);
+    const errorResults = results.filter((r) => r.status === 'error');
+    for (const result of errorResults) {
+        logger.error(`\n${result.path}:`);
+        const errorIssues = result.issues.filter((i) => i.severity === 'error');
+        logIssues(errorIssues, logger.error.bind(logger));
+    }
+}
+function logWarnings(results, warningCount, logger) {
+    logger.info(`Audit passed with warnings: ${warningCount} file(s)`);
+    const warningResults = results.filter((r) => r.status === 'warning');
+    for (const result of warningResults) {
+        logger.info(`\n${result.path}:`);
+        const warningIssues = result.issues.filter((i) => i.severity === 'warning');
+        logIssues(warningIssues, logger.info.bind(logger));
+    }
+}
+function logIssues(issues, logFn) {
+    for (const issue of issues) {
+        logFn(`  [${issue.code}] ${issue.message}`);
+        if (issue.location) {
+            logFn(`    at: ${issue.location}`);
+        }
+        if (issue.fix) {
+            logFn(`    fix: ${issue.fix}`);
+        }
+    }
+}
+/**
+ * Handle file entry during directory scan
+ */
+async function handleFileEntry(entry, fullPath, logger) {
+    // Check for registry files
+    if (entry.name === 'installed_plugins.json' || entry.name === 'known_marketplaces.json') {
+        logger.debug(`Validating registry: ${fullPath}`);
+        return validate(fullPath);
+    }
+    // Check for SKILL.md
+    if (entry.name === 'SKILL.md') {
+        logger.debug(`Validating Claude Skill: ${fullPath}`);
+        return validateSkill({ skillPath: fullPath });
+    }
+    return null;
+}
+/**
+ * Handle directory entry during directory scan
+ */
+async function handleDirectoryEntry(fullPath, recursive, logger) {
+    const fs = await import('node:fs/promises');
+    const results = [];
+    // Check if directory contains a plugin or marketplace
+    const claudePluginDir = path.join(fullPath, '.claude-plugin');
+    const hasClaudePlugin = await fs.access(claudePluginDir).then(() => true).catch(() => false);
+    if (hasClaudePlugin) {
+        logger.debug(`Validating resource directory: ${fullPath}`);
+        const result = await validate(fullPath);
+        results.push(result);
+    }
+    // Recurse into subdirectories (both plugin/marketplace dirs and regular dirs)
+    if (recursive) {
+        const subResults = await scanDirectory(fullPath, recursive, logger);
+        results.push(...subResults);
+    }
+    return results;
+}
+async function scanDirectory(dirPath, recursive, logger) {
+    const fs = await import('node:fs/promises');
+    const results = [];
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isFile()) {
+            const result = await handleFileEntry(entry, fullPath, logger);
+            if (result !== null) {
+                results.push(result);
+            }
+        }
+        else if (entry.isDirectory()) {
+            const dirResults = await handleDirectoryEntry(fullPath, recursive, logger);
+            results.push(...dirResults);
+        }
+    }
+    return results;
+}
+/**
+ * Calculate overall status from validation results
+ */
+function calculateOverallStatus(results) {
+    const errorCount = results.filter((r) => r.status === 'error').length;
+    const warningCount = results.filter((r) => r.status === 'warning').length;
+    if (errorCount > 0) {
+        return 'error';
+    }
+    if (warningCount > 0) {
+        return 'warning';
+    }
+    return 'success';
+}
+/**
+ * Count all skills in hierarchical output
+ */
+function countAllSkills(hierarchical) {
+    let total = 0;
+    // Count marketplace skills
+    for (const marketplace of hierarchical.marketplaces) {
+        for (const plugin of marketplace.plugins) {
+            total += plugin.skills.length;
+        }
+    }
+    // Count cached plugin skills
+    for (const plugin of hierarchical.cachedPlugins) {
+        total += plugin.skills.length;
+    }
+    // Count standalone plugin skills
+    for (const plugin of hierarchical.standalonePlugins) {
+        total += plugin.skills.length;
+    }
+    // Count standalone skills
+    total += hierarchical.standaloneSkills.length;
+    return total;
+}
+/**
+ * Calculate issue counts from validation results
+ */
+function calculateIssueCounts(results) {
+    const successCount = results.filter((r) => r.status === 'success').length;
+    const warningCount = results.filter((r) => r.status === 'warning').length;
+    const errorCount = results.filter((r) => r.status === 'error').length;
+    const totalErrors = results.reduce((sum, r) => sum + r.issues.filter(i => i.severity === 'error').length, 0);
+    const totalWarnings = results.reduce((sum, r) => sum + r.issues.filter(i => i.severity === 'warning').length, 0);
+    const totalInfo = results.reduce((sum, r) => sum + r.issues.filter(i => i.severity === 'info').length, 0);
+    return {
+        successCount,
+        warningCount,
+        errorCount,
+        totalErrors,
+        totalWarnings,
+        totalInfo,
+    };
+}
+/**
+ * Build base summary structure (used by both flat and hierarchical)
+ */
+function buildBaseSummary(results, startTime) {
+    const counts = calculateIssueCounts(results);
+    const status = calculateOverallStatus(results);
+    return {
+        status,
+        summary: {
+            filesScanned: results.length,
+            success: counts.successCount,
+            warnings: counts.warningCount,
+            errors: counts.errorCount,
+        },
+        issues: {
+            errors: counts.totalErrors,
+            warnings: counts.totalWarnings,
+            info: counts.totalInfo,
+        },
+        duration: `${Date.now() - startTime}ms`,
+    };
+}
+/**
+ * Calculate summary for hierarchical output
+ */
+function calculateHierarchicalSummary(results, hierarchical, startTime) {
+    const base = buildBaseSummary(results, startTime);
+    return {
+        ...base,
+        summary: {
+            ...base.summary,
+            marketplaces: hierarchical.marketplaces.length,
+            cachedPlugins: hierarchical.cachedPlugins.length,
+            standalonePlugins: hierarchical.standalonePlugins.length,
+            standaloneSkills: hierarchical.standaloneSkills.length,
+        },
+        hierarchical,
+    };
+}
+/**
+ * Log hierarchical summary to stderr
+ */
+function logHierarchicalSummary(results, hierarchical, logger) {
+    const status = calculateOverallStatus(results);
+    const skillsWithIssues = countAllSkills(hierarchical);
+    const totalSkills = results.length;
+    if (status === 'error') {
+        const errorCount = results.filter((r) => r.status === 'error').length;
+        logger.error(`Audit failed: ${errorCount} skill(s) with errors (${totalSkills} scanned, ${skillsWithIssues} with issues)`);
+        process.exit(1);
+    }
+    if (status === 'warning') {
+        const warningCount = results.filter((r) => r.status === 'warning').length;
+        logger.info(`Audit passed with warnings: ${warningCount} skill(s) (${totalSkills} scanned, ${skillsWithIssues} with issues)`);
+    }
+    else {
+        logger.info(`Audit successful: ${totalSkills} skill(s) passed`);
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=audit.js.map