@vibe-agent-toolkit/cli 0.1.0 → 0.1.1

package/README.md

@@ -71,6 +71,69 @@ vat rag clear
 - 384-dimensional embeddings
 - No API key required
 
+### Doctor Command
+
+Diagnose vat setup and environment health.
+
+**Usage:**
+```bash
+# Check environment and configuration
+vat doctor
+
+# Show all checks (including passing ones)
+vat doctor --verbose
+```
+
+**What it checks:**
+- Node.js version (>=20 required)
+- Git installation and repository
+- Configuration file exists and is valid
+- VAT version (checks for updates)
+- CLI build status (in VAT source tree only)
+
+**Exit codes:**
+- `0` - All checks passed
+- `1` - One or more checks failed
+
+**Example output:**
+```
+🩺 vat doctor
+
+Running diagnostic checks...
+
+✅ Node.js version
+   v22.0.0 (meets requirement: >=20.0.0)
+
+✅ Git installed
+   git version 2.43.0
+
+✅ Git repository
+   Current directory is a git repository
+
+✅ Configuration file
+   Found: vibe-agent-toolkit.config.yaml
+
+✅ Configuration valid
+   Configuration is valid
+
+✅ vat version
+   Current: 0.1.0 — up to date
+
+📊 Results: 6/6 checks passed
+
+✨ All checks passed! Your vat setup looks healthy.
+```
+
+**Troubleshooting:**
+
+If checks fail, doctor provides specific suggestions:
+
+```
+❌ Node.js version
+   v18.0.0 is too old. Node.js 20+ required.
+   💡 Upgrade Node.js: https://nodejs.org/ or use nvm
+```
+
 ### Configuration
 
 Create `vibe-agent-toolkit.config.yaml` at project root:
@@ -111,10 +174,10 @@ vat --version  # Shows: 0.1.0-dev (/path/to/vibe-agent-toolkit)
 # Build
 bun run build
 
-# Test
-bun test
-bun test:integration
-bun test:system
+# Test (do NOT use 'bun test' directly)
+bun run test:unit
+bun run test:integration
+bun run test:system
 
 # Prepare binaries after build
 bun run prepare-cli-bin

package/dist/bin.js

@@ -5,6 +5,8 @@
  */
 import { Command } from 'commander';
 import { createAgentCommand, showAgentVerboseHelp } from './commands/agent/index.js';
+import { createAuditCommand } from './commands/audit.js';
+import { doctorCommand } from './commands/doctor.js';
 import { createRagCommand, showRagVerboseHelp } from './commands/rag/index.js';
 import { createResourcesCommand, showResourcesVerboseHelp } from './commands/resources/index.js';
 import { loadVerboseHelp } from './utils/help-loader.js';
@@ -23,7 +25,6 @@ program
     .description('Agent-friendly toolkit for building, testing, and deploying portable AI agents')
     .version(getVersionString(version, context), '-v, --version', 'Output version number')
     .option('--debug', 'Enable debug logging')
-    .option('--verbose', 'Show verbose help (markdown format)')
     .helpCommand(false) // Disable redundant 'help' command, use --help instead
     .showHelpAfterError()
     .configureOutput({
@@ -41,17 +42,16 @@ For command details: vat resources --help
 For comprehensive help: vat --help --verbose
 For agent guidance: docs/cli/CLAUDE.md
 `);
-// Handle --help --verbose at root level only
-// Don't handle --verbose if a subcommand was specified
+// Handle --help --verbose at root level before parsing
+// Manually check process.argv since --verbose is not a root-level option
+const hasHelp = process.argv.includes('--help') || process.argv.includes('-h');
+const hasVerbose = process.argv.includes('--verbose');
 const hasSubcommand = process.argv.slice(2).some(arg => !arg.startsWith('-'));
-program.on('option:verbose', () => {
-    const opts = program.opts();
-    // Only show root verbose help if no subcommand is present
-    if (opts['verbose'] && !hasSubcommand && program.args.length === 0) {
-        showVerboseHelp();
-        process.exit(0);
-    }
-});
+if (hasHelp && hasVerbose && !hasSubcommand) {
+    // Root level: vat --help --verbose
+    showVerboseHelp();
+    process.exit(0);
+}
 // Special handling for "resources --verbose" before parsing
 if (process.argv.includes('resources') && process.argv.includes('--verbose')) {
     const argv = process.argv.slice(2);
@@ -88,10 +88,13 @@ if (process.argv.includes('agent') && process.argv.includes('--verbose')) {
         process.exit(0);
     }
 }
-// Add command groups
+// Add command groups (audit is common, should be first)
+program.addCommand(createAuditCommand());
 program.addCommand(createResourcesCommand());
 program.addCommand(createRagCommand());
 program.addCommand(createAgentCommand());
+// Add standalone commands
+doctorCommand(program);
 // Handle unknown commands
 program.on('command:*', (operands) => {
     const logger = createLogger();

package/dist/bin.js.map

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

package/dist/commands/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,kBAAkB,IAAI,OAAO,CAsT5C;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,kBAAkB,IAAI,OAAO,CA8Q5C;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/agent/index.js

@@ -2,7 +2,6 @@
  * Agent command group
  */
 import { Command } from 'commander';
-import { auditCommand } from './audit.js';
 import { buildCommand } from './build.js';
 import { importCommand } from './import.js';
 import { installAgent } from './install.js';
@@ -138,42 +137,6 @@ Examples:
   $ vat agent validate agent-generator          # Validate by name
   $ vat agent validate ./my-agent               # Validate by path
   $ vat agent validate ./agent.yaml             # Validate specific file
-`);
-    agent
-        .command('audit [path]')
-        .description('Audit Claude Skills for quality and compatibility')
-        .option('-r, --recursive', 'Scan directories recursively for SKILL.md files')
-        .option('--debug', DEBUG_OPTION_DESC)
-        .action(auditCommand)
-        .addHelpText('after', `
-Description:
-  Audits Claude Skills (SKILL.md files) for quality, correctness, and
-  console compatibility. Validates frontmatter, links, naming conventions,
-  and warns about console-incompatible features. Outputs YAML report to
-  stdout, errors/warnings to stderr.
-
-  Path can be: directory, single SKILL.md file, or VAT agent directory
-  Default: current directory
-
-Validation Checks:
-  Errors (must fix):
-  - Missing or invalid frontmatter (name, description)
-  - Broken links to other files
-  - Reserved words in names (anthropic, claude)
-  - XML tags in frontmatter fields
-  - Windows-style backslashes in paths
-
-  Warnings (should fix):
-  - Skill exceeds recommended length (>5000 lines)
-  - References console-incompatible tools (Write, Edit, Bash)
-
-Exit Codes:
-  0 - Success  |  1 - Errors found  |  2 - System error
-
-Examples:
-  $ vat agent audit                          # Audit current directory
-  $ vat agent audit ./my-skill/SKILL.md      # Audit single skill
-  $ vat agent audit ./skills --recursive     # Audit all skills recursively
 `);
     agent
         .command('import <skillPath>')

package/dist/commands/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AACjD,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAC/D,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAC1C,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAC7C,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,aAAa,GAAG,4CAA4C,CAAC;AAEnE,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC,KAAK;SACF,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAAC;SACxC,WAAW,CAAC,KAAK,CAAC;SAClB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;CAaL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,WAAW,CAAC;SACnB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;CAYL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,iBAAiB,EAAE,uCAAuC,EAAE,OAAO,CAAC;SAC3E,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;SAC1F,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,YAAY,CAAC;SACpB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;CAqBL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,8BAA8B,CAAC;SACvC,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,UAAU,CAAC;SAClB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;CAmBL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,eAAe,CAAC;SACvB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;CAsBL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,iDAAiD,CAAC;SAC5E,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,YAAY,CAAC;SACpB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,qBAAqB,EAAE,kEAAkE,CAAC;SACjG,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC;SACtD,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,aAAa,CAAC;SACrB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;CAsBL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,YAAY,EAAE,iBAAiB,EAAE,aAAa,CAAC;SACtD,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;SAC9B,MAAM,CAAC,SAAS,EAAE,iCAAiC,CAAC;SACpD,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,eAAe,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,YAAY,CAAC;SACpB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;CAoBL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,YAAY,EAAE,iBAAiB,EAAE,aAAa,CAAC;SACtD,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,eAAe,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,cAAc,CAAC;SACtB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;CAeL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,YAAY,EAAE,sCAAsC,EAAE,KAAK,CAAC;SACnE,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,eAAe,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACpC,MAAM,CAAC,gBAAgB,CAAC;SACxB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;CAqBL,CACI,CAAC;IAEJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/audit/cache-detector.d.ts

@@ -0,0 +1,32 @@
+import type { ResourceMetadata } from '@vibe-agent-toolkit/resources';
+export interface CacheStalenessResult {
+    fresh: FreshEntry[];
+    stale: StaleEntry[];
+    cacheOnly: ResourceMetadata[];
+    installedOnly: ResourceMetadata[];
+}
+export interface FreshEntry {
+    installed: ResourceMetadata;
+    cached: ResourceMetadata;
+}
+export interface StaleEntry {
+    installed: ResourceMetadata;
+    cached: ResourceMetadata;
+}
+/**
+ * Detect cache staleness by comparing checksums between installed and cached resources.
+ *
+ * Compares resources by filename and checksum to determine:
+ * - Fresh: Cache and installed have matching checksums
+ * - Stale: Cache and installed have different checksums
+ * - Cache-only: File exists in cache but not in installed
+ * - Installed-only: File exists in installed but not in cache
+ *
+ * Uses O(1) Map lookups for efficient matching.
+ *
+ * @param installed - Resources from installed plugin locations
+ * @param cached - Resources from ~/.claude/plugins/cache/
+ * @returns Categorized comparison results
+ */
+export declare function detectCacheStaleness(installed: ResourceMetadata[], cached: ResourceMetadata[]): CacheStalenessResult;
+//# sourceMappingURL=cache-detector.d.ts.map

package/dist/commands/audit/cache-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-detector.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/cache-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,MAAM,EAAE,gBAAgB,EAAE,GACzB,oBAAoB,CAmDtB"}

package/dist/commands/audit/cache-detector.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+/**
+ * Extract filename from file path
+ */
+function getFileName(filePath) {
+    return path.basename(filePath);
+}
+/**
+ * Detect cache staleness by comparing checksums between installed and cached resources.
+ *
+ * Compares resources by filename and checksum to determine:
+ * - Fresh: Cache and installed have matching checksums
+ * - Stale: Cache and installed have different checksums
+ * - Cache-only: File exists in cache but not in installed
+ * - Installed-only: File exists in installed but not in cache
+ *
+ * Uses O(1) Map lookups for efficient matching.
+ *
+ * @param installed - Resources from installed plugin locations
+ * @param cached - Resources from ~/.claude/plugins/cache/
+ * @returns Categorized comparison results
+ */
+export function detectCacheStaleness(installed, cached) {
+    const fresh = [];
+    const stale = [];
+    const cacheOnly = [];
+    const installedOnly = [];
+    // Build index of installed resources by filename for O(1) lookup
+    const installedByName = new Map();
+    for (const resource of installed) {
+        const filename = getFileName(resource.filePath);
+        installedByName.set(filename, resource);
+    }
+    // Check each cached resource
+    const matchedInstalledNames = new Set();
+    for (const cachedResource of cached) {
+        const cachedFilename = getFileName(cachedResource.filePath);
+        const installedResource = installedByName.get(cachedFilename);
+        if (!installedResource) {
+            // Cache file has no corresponding installed file
+            cacheOnly.push(cachedResource);
+            continue;
+        }
+        matchedInstalledNames.add(cachedFilename);
+        if (cachedResource.checksum === installedResource.checksum) {
+            // Checksums match - cache is fresh
+            fresh.push({
+                installed: installedResource,
+                cached: cachedResource,
+            });
+        }
+        else {
+            // Checksums differ - cache is stale
+            stale.push({
+                installed: installedResource,
+                cached: cachedResource,
+            });
+        }
+    }
+    // Find installed resources with no cache entry
+    for (const [name, resource] of installedByName) {
+        if (!matchedInstalledNames.has(name)) {
+            installedOnly.push(resource);
+        }
+    }
+    return { fresh, stale, cacheOnly, installedOnly };
+}
+//# sourceMappingURL=cache-detector.js.map

package/dist/commands/audit/cache-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-detector.js","sourceRoot":"","sources":["../../../src/commands/audit/cache-detector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAqB7B;;GAEG;AACH,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA6B,EAC7B,MAA0B;IAE1B,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,MAAM,aAAa,GAAuB,EAAE,CAAC;IAE7C,iEAAiE;IACjE,MAAM,eAAe,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC5D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,6BAA6B;IAC7B,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhD,KAAK,MAAM,cAAc,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,iBAAiB,GAAG,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAE9D,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,iDAAiD;YACjD,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAE1C,IAAI,cAAc,CAAC,QAAQ,KAAK,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC3D,mCAAmC;YACnC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,iBAAiB;gBAC5B,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,iBAAiB;gBAC5B,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AACpD,CAAC"}

package/dist/commands/audit/hierarchical-output.d.ts

@@ -0,0 +1,41 @@
+import type { ValidationIssue, ValidationResult } from '@vibe-agent-toolkit/runtime-claude-skills';
+export interface HierarchicalOutput {
+    marketplaces: MarketplaceGroup[];
+    cachedPlugins: PluginGroup[];
+    standalonePlugins: PluginGroup[];
+    standaloneSkills: SkillEntry[];
+}
+export interface MarketplaceGroup {
+    name: string;
+    plugins: PluginGroup[];
+}
+export interface PluginGroup {
+    name: string;
+    skills: SkillEntry[];
+}
+export type CacheStatus = 'stale' | 'orphaned' | 'fresh';
+export interface SkillEntry {
+    name: string;
+    path: string;
+    status: 'success' | 'warning' | 'error';
+    issues: ValidationIssue[];
+    cacheStatus?: CacheStatus;
+}
+/**
+ * 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 declare function buildHierarchicalOutput(results: ValidationResult[], verbose?: boolean): HierarchicalOutput;
+//# sourceMappingURL=hierarchical-output.d.ts.map

package/dist/commands/audit/hierarchical-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical-output.d.ts","sourceRoot":"","sources":["../../../src/commands/audit/hierarchical-output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAGnG,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,UAAU,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AA+RD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,OAAe,GAAG,kBAAkB,CAiCjH"}

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