@vibe-agent-toolkit/cli 0.1.0 → 0.1.1

package/docs/index.md

@@ -79,6 +79,38 @@ vat resources scan docs/                  # Scan specific directory
 
 ---
 
+### `doctor`
+
+Diagnose vat setup and environment health
+
+**What it does:**
+
+- Checks Node.js version (>=20 required)
+- Checks Git installation and repository
+- Validates configuration file exists and is valid
+- Checks vat version and available updates
+- Verifies CLI build status (in VAT source tree)
+
+**When to use:** Before starting development, after updates, or debugging issues
+
+**Exit codes:**
+
+- `0` - All checks passed
+- `1` - One or more checks failed
+
+**Creates/modifies:** None (read-only diagnostics)
+
+**Examples:**
+
+```bash
+vat doctor                                # Run diagnostic checks
+vat doctor --verbose                      # Show all checks (including passing)
+```
+
+**More details:** `vat doctor --help` or see `packages/cli/docs/doctor.md`
+
+---
+
 ### `agent build`
 
 Build agent for deployment to target runtime

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Command-line interface for vibe-agent-toolkit",
   "type": "module",
   "bin": {
@@ -40,21 +40,24 @@
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@vibe-agent-toolkit/agent-config": "0.1.0",
-    "@vibe-agent-toolkit/discovery": "0.1.0",
-    "@vibe-agent-toolkit/rag": "0.1.0",
-    "@vibe-agent-toolkit/rag-lancedb": "0.1.0",
-    "@vibe-agent-toolkit/resources": "0.1.0",
-    "@vibe-agent-toolkit/runtime-claude-skills": "0.1.0",
-    "@vibe-agent-toolkit/utils": "0.1.0",
+    "@vibe-agent-toolkit/agent-config": "0.1.1",
+    "@vibe-agent-toolkit/discovery": "0.1.1",
+    "@vibe-agent-toolkit/rag": "0.1.1",
+    "@vibe-agent-toolkit/rag-lancedb": "0.1.1",
+    "@vibe-agent-toolkit/resources": "0.1.1",
+    "@vibe-agent-toolkit/runtime-claude-skills": "0.1.1",
+    "@vibe-agent-toolkit/utils": "0.1.1",
     "commander": "^12.1.0",
     "js-yaml": "^4.1.0",
+    "semver": "^7.7.3",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.5",
+    "@types/semver": "^7.7.1",
     "rimraf": "^6.0.1",
+    "tar": "^7.5.2",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"
   },

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

@@ -1,9 +0,0 @@
-/**
- * Agent audit command - audits Claude Skills for quality and compatibility
- */
-export interface AuditCommandOptions {
-    debug?: boolean;
-    recursive?: boolean;
-}
-export declare function auditCommand(targetPath: string | undefined, options: AuditCommandOptions): Promise<void>;
-//# sourceMappingURL=audit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/audit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/commands/agent/audit.js

@@ -1,139 +0,0 @@
-/**
- * Agent audit command - audits Claude Skills for quality and compatibility
- */
-import * as path from 'node:path';
-import { detectFormat } from '@vibe-agent-toolkit/discovery';
-import { validateSkill } from '@vibe-agent-toolkit/runtime-claude-skills';
-import { handleCommandError } from '../../utils/command-error.js';
-import { createLogger } from '../../utils/logger.js';
-import { writeYamlOutput } from '../../utils/output.js';
-export async function auditCommand(targetPath, options) {
-    const logger = createLogger(options.debug ? { debug: true } : {});
-    const startTime = Date.now();
-    try {
-        const scanPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        logger.debug(`Auditing Claude Skills at: ${scanPath}`);
-        // Get validation results
-        const results = await getValidationResults(scanPath, options.recursive ?? false, logger);
-        // Calculate and output summary
-        const summary = calculateSummary(results, startTime);
-        writeYamlOutput(summary);
-        // Log human-readable output and exit
-        handleAuditResults(results, summary, logger);
-    }
-    catch (error) {
-        handleCommandError(error, logger, startTime, 'AgentAudit');
-    }
-}
-async function getValidationResults(scanPath, recursive, logger) {
-    const format = detectFormat(scanPath);
-    if (format === 'claude-skill') {
-        logger.debug('Detected single Claude Skill');
-        const result = await validateSkill({ skillPath: scanPath });
-        return [result];
-    }
-    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];
-    }
-    logger.debug('Scanning directory for Claude Skills');
-    return scanDirectory(scanPath, recursive, logger);
-}
-function calculateSummary(results, startTime) {
-    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);
-    let status;
-    if (errorCount > 0) {
-        status = 'error';
-    }
-    else if (warningCount > 0) {
-        status = 'warning';
-    }
-    else {
-        status = 'success';
-    }
-    return {
-        status,
-        summary: {
-            filesScanned: results.length,
-            success: successCount,
-            warnings: warningCount,
-            errors: errorCount,
-        },
-        issues: {
-            errors: totalErrors,
-            warnings: totalWarnings,
-            info: totalInfo,
-        },
-        files: results,
-        duration: `${Date.now() - startTime}ms`,
-    };
-}
-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}`);
-        }
-    }
-}
-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() && entry.name === 'SKILL.md') {
-            logger.debug(`Validating: ${fullPath}`);
-            const result = await validateSkill({ skillPath: fullPath });
-            results.push(result);
-        }
-        else if (entry.isDirectory() && recursive) {
-            const subResults = await scanDirectory(fullPath, recursive, logger);
-            results.push(...subResults);
-        }
-    }
-    return results;
-}
-//# sourceMappingURL=audit.js.map

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

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