@vibe-agent-toolkit/cli 0.1.0-rc.7

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger utility for CLI - writes only to stderr
+ * stdout is reserved for structured YAML/JSON output
+ */
+export interface Logger {
+    info: (message: string) => void;
+    error: (message: string) => void;
+    debug: (message: string) => void;
+}
+export interface LoggerOptions {
+    debug?: boolean;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAgBhE"}

package/dist/utils/logger.js

@@ -0,0 +1,21 @@
+/**
+ * Logger utility for CLI - writes only to stderr
+ * stdout is reserved for structured YAML/JSON output
+ */
+export function createLogger(options = {}) {
+    const debug = options.debug ?? false;
+    return {
+        info: (message) => {
+            process.stderr.write(`${message}\n`);
+        },
+        error: (message) => {
+            process.stderr.write(`${message}\n`);
+        },
+        debug: (message) => {
+            if (debug) {
+                process.stderr.write(`[DEBUG] ${message}\n`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;YACzB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Output utilities for structured data
+ * YAML output on stdout, logs on stderr
+ */
+/**
+ * Write YAML output to stdout with document markers
+ * @param data - Data to serialize as YAML
+ */
+export declare function writeYamlOutput(data: unknown): void;
+/**
+ * Flush stdout before writing to stderr
+ * Prevents output corruption when streams are merged
+ */
+export declare function flushStdout(): Promise<void>;
+/**
+ * Write test-format error to stderr
+ * Format: file:line:column: message
+ */
+export declare function writeTestFormatError(file: string, line: number, column: number, message: string): void;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAQnD;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAQjD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CAEN"}

package/dist/utils/output.js

@@ -0,0 +1,40 @@
+/**
+ * Output utilities for structured data
+ * YAML output on stdout, logs on stderr
+ */
+import * as yaml from 'js-yaml';
+/**
+ * Write YAML output to stdout with document markers
+ * @param data - Data to serialize as YAML
+ */
+export function writeYamlOutput(data) {
+    process.stdout.write('---\n');
+    process.stdout.write(yaml.dump(data, {
+        indent: 2,
+        lineWidth: 120,
+        noRefs: true,
+    }));
+    process.stdout.write('---\n');
+}
+/**
+ * Flush stdout before writing to stderr
+ * Prevents output corruption when streams are merged
+ */
+export async function flushStdout() {
+    return new Promise((resolve) => {
+        if (process.stdout.writableNeedDrain) {
+            process.stdout.once('drain', resolve);
+        }
+        else {
+            resolve();
+        }
+    });
+}
+/**
+ * Write test-format error to stderr
+ * Format: file:line:column: message
+ */
+export function writeTestFormatError(file, line, column, message) {
+    process.stderr.write(`${file}:${line}:${column}: ${message}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACnC,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,IAAI;KACb,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,OAAe;IAEf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/utils/project-root.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Project root detection utility
+ * Walks up directory tree to find .git or vibe-agent-toolkit.config.yaml
+ */
+/**
+ * Find project root by walking up directory tree
+ * @param startDir - Directory to start search from
+ * @returns Project root path or null if not found
+ */
+export declare function findProjectRoot(startDir: string): string | null;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/utils/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B/D"}

package/dist/utils/project-root.js

@@ -0,0 +1,35 @@
+/**
+ * Project root detection utility
+ * Walks up directory tree to find .git or vibe-agent-toolkit.config.yaml
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Find project root by walking up directory tree
+ * @param startDir - Directory to start search from
+ * @returns Project root path or null if not found
+ */
+export function findProjectRoot(startDir) {
+    let current = path.resolve(startDir);
+    const root = path.parse(current).root;
+    while (current !== root) {
+        // Check for .git directory
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- path walking is intentional
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return current;
+        }
+        // Check for config file
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- path walking is intentional
+        if (fs.existsSync(path.join(current, 'vibe-agent-toolkit.config.yaml'))) {
+            return current;
+        }
+        // Move up one directory
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break; // Reached root
+        }
+        current = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=project-root.js.map

package/dist/utils/project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAEtC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,2BAA2B;QAC3B,kGAAkG;QAClG,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,wBAAwB;QACxB,kGAAkG;QAClG,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC,EAAE,CAAC;YACxE,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,CAAC,eAAe;QACxB,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/resource-loader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Utilities for loading and crawling resources
+ */
+import { ResourceRegistry } from '@vibe-agent-toolkit/resources';
+import type { ProjectConfig } from '../schemas/config.js';
+import type { Logger } from './logger.js';
+export interface ResourceLoadResult {
+    scanPath: string;
+    projectRoot: string | null;
+    config: ProjectConfig | undefined;
+    registry: ResourceRegistry;
+}
+/**
+ * Load resources from a path with config support
+ *
+ * Common pattern for CLI commands that need to:
+ * 1. Determine scan path
+ * 2. Find project root and load config
+ * 3. Create registry and crawl
+ *
+ * Behavior:
+ * - When path argument provided: use as baseDir, ignore config patterns (use defaults)
+ * - When no path argument: use project root/cwd as baseDir, apply config patterns
+ *
+ * @param pathArg - Path argument from CLI (optional)
+ * @param logger - Logger instance
+ * @returns Resource load result with registry and metadata
+ */
+export declare function loadResourcesWithConfig(pathArg: string | undefined, logger: Logger): Promise<ResourceLoadResult>;
+//# sourceMappingURL=resource-loader.d.ts.map

package/dist/utils/resource-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader.d.ts","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CA8C7B"}

package/dist/utils/resource-loader.js

@@ -0,0 +1,63 @@
+/**
+ * Utilities for loading and crawling resources
+ */
+import { ResourceRegistry } from '@vibe-agent-toolkit/resources';
+import { loadConfig } from './config-loader.js';
+import { findProjectRoot } from './project-root.js';
+/**
+ * Load resources from a path with config support
+ *
+ * Common pattern for CLI commands that need to:
+ * 1. Determine scan path
+ * 2. Find project root and load config
+ * 3. Create registry and crawl
+ *
+ * Behavior:
+ * - When path argument provided: use as baseDir, ignore config patterns (use defaults)
+ * - When no path argument: use project root/cwd as baseDir, apply config patterns
+ *
+ * @param pathArg - Path argument from CLI (optional)
+ * @param logger - Logger instance
+ * @returns Resource load result with registry and metadata
+ */
+export async function loadResourcesWithConfig(pathArg, logger) {
+    // Find project root and load config
+    const projectRoot = findProjectRoot(process.cwd());
+    const config = projectRoot ? loadConfig(projectRoot) : undefined;
+    if (config) {
+        logger.debug(`Loaded config from ${projectRoot ?? 'unknown'}`);
+    }
+    // Create registry and crawl
+    const registry = new ResourceRegistry();
+    let crawlOptions;
+    if (pathArg) {
+        // Path argument provided: crawl from that directory with default patterns
+        // Ignore config patterns because they're relative to project root
+        logger.debug(`Path argument provided: ${pathArg}`);
+        logger.debug('Using default patterns (ignoring config)');
+        crawlOptions = {
+            baseDir: pathArg,
+            // Use defaults from ResourceRegistry.crawl (will use **/*.md)
+        };
+    }
+    else {
+        // No path argument: crawl from project root (or cwd) with config patterns
+        const scanPath = projectRoot ?? process.cwd();
+        logger.debug(`No path argument, using: ${scanPath}`);
+        crawlOptions = {
+            baseDir: scanPath,
+            // Apply include patterns from config (if specified)
+            ...(config?.resources?.include ? { include: config.resources.include } : {}),
+            // Apply exclude patterns from config (if specified)
+            ...(config?.resources?.exclude ? { exclude: config.resources.exclude } : {}),
+        };
+    }
+    await registry.crawl(crawlOptions);
+    return {
+        scanPath: pathArg ?? (projectRoot ?? process.cwd()),
+        projectRoot,
+        config,
+        registry,
+    };
+}
+//# sourceMappingURL=resource-loader.js.map

package/dist/utils/resource-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader.js","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA2B,EAC3B,MAAc;IAEd,oCAAoC;IACpC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,sBAAsB,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAExC,IAAI,YAAY,CAAC;IAEjB,IAAI,OAAO,EAAE,CAAC;QACZ,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAEzD,YAAY,GAAG;YACb,OAAO,EAAE,OAAO;YAChB,8DAA8D;SAC/D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QAErD,YAAY,GAAG;YACb,OAAO,EAAE,QAAQ;YACjB,oDAAoD;YACpD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,oDAAoD;YACpD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEnC,OAAO;QACL,QAAQ,EAAE,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,WAAW;QACX,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/utils/scope-locations.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scope locations and validation for agent installation
+ */
+/**
+ * Map of runtime to scope locations
+ */
+export declare const SCOPE_LOCATIONS: Record<string, Record<string, string>>;
+/**
+ * Map of runtime to valid scopes
+ */
+export declare const VALID_SCOPES: Record<string, string[]>;
+/**
+ * Validate scope for a given runtime and return the target location
+ * @throws Error if scope is invalid or not implemented
+ */
+export declare function validateAndGetScopeLocation(runtime: string, scope: string): string;
+//# sourceMappingURL=scope-locations.d.ts.map

package/dist/utils/scope-locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-locations.d.ts","sourceRoot":"","sources":["../../src/utils/scope-locations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAEjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAkBR"}

package/dist/utils/scope-locations.js

@@ -0,0 +1,40 @@
+/**
+ * Scope locations and validation for agent installation
+ */
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * Map of runtime to scope locations
+ */
+export const SCOPE_LOCATIONS = {
+    'claude-skill': {
+        user: path.join(os.homedir(), '.claude', 'skills'),
+        project: path.join(process.cwd(), '.claude', 'skills'),
+    },
+};
+/**
+ * Map of runtime to valid scopes
+ */
+export const VALID_SCOPES = {
+    'claude-skill': ['user', 'project'],
+};
+/**
+ * Validate scope for a given runtime and return the target location
+ * @throws Error if scope is invalid or not implemented
+ */
+export function validateAndGetScopeLocation(runtime, scope) {
+    // Validate scope for runtime
+    const validScopes = VALID_SCOPES[runtime];
+    if (!validScopes?.includes(scope)) {
+        const available = validScopes?.join(', ') ?? 'none';
+        throw new Error(`Invalid scope '${scope}' for runtime '${runtime}'.\n` +
+            `Valid scopes: ${available}`);
+    }
+    // Get scope location
+    const targetLocation = SCOPE_LOCATIONS[runtime]?.[scope];
+    if (!targetLocation) {
+        throw new Error(`Scope '${scope}' not implemented for runtime '${runtime}'`);
+    }
+    return targetLocation;
+}
+//# sourceMappingURL=scope-locations.js.map

package/dist/utils/scope-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-locations.js","sourceRoot":"","sources":["../../src/utils/scope-locations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,cAAc,EAAE;QACd,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC;QAClD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC;KACvD;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,cAAc,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,KAAa;IAEb,6BAA6B;IAC7B,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,kBAAkB,OAAO,MAAM;YACpD,iBAAiB,SAAS,EAAE,CAC/B,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,kCAAkC,OAAO,GAAG,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/utils/validate-help-files.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build-time validator for help documentation files
+ *
+ * Ensures all required markdown help files exist before build completes.
+ * This provides "fail fast" behavior - missing help files cause build failure
+ * rather than runtime errors when users request verbose help.
+ */
+/**
+ * Validate that all required help files exist
+ *
+ * @throws {Error} If any required help file is missing
+ */
+export declare function validateHelpFiles(): void;
+//# sourceMappingURL=validate-help-files.d.ts.map

package/dist/utils/validate-help-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-help-files.d.ts","sourceRoot":"","sources":["../../src/utils/validate-help-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAuBxC"}

package/dist/utils/validate-help-files.js

@@ -0,0 +1,61 @@
+/**
+ * Build-time validator for help documentation files
+ *
+ * Ensures all required markdown help files exist before build completes.
+ * This provides "fail fast" behavior - missing help files cause build failure
+ * rather than runtime errors when users request verbose help.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Required help documentation files
+ * Each entry maps to a file in packages/cli/docs/
+ */
+const REQUIRED_HELP_FILES = [
+    'index.md', // Root-level verbose help (vat --help --verbose)
+    'resources.md', // Resources command verbose help (vat resources --help --verbose)
+    'rag.md', // RAG command verbose help (vat rag --help --verbose)
+    'agent.md', // Agent command verbose help (vat agent --help --verbose)
+];
+/**
+ * Validate that all required help files exist
+ *
+ * @throws {Error} If any required help file is missing
+ */
+export function validateHelpFiles() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = join(__dirname, '../..');
+    const docsDir = join(packageRoot, 'docs');
+    const missingFiles = [];
+    for (const filename of REQUIRED_HELP_FILES) {
+        const helpPath = join(docsDir, filename);
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is constructed from known safe components
+        if (!existsSync(helpPath)) {
+            missingFiles.push(filename);
+        }
+    }
+    if (missingFiles.length > 0) {
+        const fileList = missingFiles.map(f => `  - docs/${f}`).join('\n');
+        throw new Error(`Missing required help documentation files:\n${fileList}\n\n` +
+            `These files must exist for verbose help (--help --verbose) to work.\n` +
+            `Create them before building the CLI package.`);
+    }
+}
+/**
+ * Run validation if this file is executed directly
+ * (via tsx or node during build process)
+ */
+if (import.meta.url === `file://${process.argv[1]}`) {
+    try {
+        validateHelpFiles();
+        console.log('✓ All required help documentation files exist');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('✗ Help file validation failed:');
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate-help-files.js.map

package/dist/utils/validate-help-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-help-files.js","sourceRoot":"","sources":["../../src/utils/validate-help-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,mBAAmB,GAAG;IAC1B,UAAU,EAAO,iDAAiD;IAClE,cAAc,EAAG,kEAAkE;IACnF,QAAQ,EAAS,sDAAsD;IACvE,UAAU,EAAO,0DAA0D;CACnE,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,qHAAqH;QACrH,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,+CAA+C,QAAQ,MAAM;YAC7D,uEAAuE;YACvE,8CAA8C,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,CAAC;QACH,iBAAiB,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Version information and context detection
+ */
+export declare const version: string;
+export interface VersionContext {
+    type: 'dev' | 'local' | 'global';
+    path?: string;
+}
+/**
+ * Format version string with optional context
+ */
+export declare function getVersionString(ver: string, context: VersionContext | null): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,GAAG,IAAI,GAC7B,MAAM,CAaR"}

package/dist/version.js

@@ -0,0 +1,27 @@
+/**
+ * Version information and context detection
+ */
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Read version from package.json at build time
+const packageJson = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
+export const version = packageJson.version;
+/**
+ * Format version string with optional context
+ */
+export function getVersionString(ver, context) {
+    if (!context) {
+        return ver;
+    }
+    switch (context.type) {
+        case 'dev':
+            return `${ver}-dev (${context.path ?? 'unknown'})`;
+        case 'local':
+            return `${ver} (local: ${context.path ?? 'unknown'})`;
+        case 'global':
+            return ver;
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC7D,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAOnD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,OAA8B;IAE9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,GAAG,GAAG,SAAS,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACrD,KAAK,OAAO;YACV,OAAO,GAAG,GAAG,YAAY,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC"}

package/docs/agent.md

@@ -0,0 +1,100 @@
+# Agent Commands
+
+Manage and execute AI agents defined in agent.yaml manifests.
+
+## Overview
+
+VAT agents are defined using Kubernetes-style YAML manifests that specify:
+- Agent metadata (name, version, description)
+- LLM configuration (provider, model, parameters)
+- Tools (RAG, functions, APIs)
+- Prompts (system, user templates)
+- Resources (documentation, templates, examples)
+
+## Commands
+
+### `vat agent validate <path>`
+
+Validate agent manifest and check prerequisites.
+
+**Usage**:
+```bash
+vat agent validate ./my-agent
+vat agent validate ./my-agent/agent.yaml
+vat agent validate packages/vat-development-agents/agents/agent-generator
+```
+
+**Validation checks**:
+- Manifest schema validation (apiVersion, kind, metadata, spec)
+- LLM provider and model configuration
+- Tool configurations (RAG databases, function files)
+- Resource file existence (prompts, docs, templates)
+- Prompt references ($ref paths)
+
+**Output**: YAML to stdout with validation results
+**Exit codes**: 0 = valid, 1 = validation errors, 2 = system error
+
+---
+
+## Manifest Format
+
+VAT uses Kubernetes-style manifests for agent configuration:
+
+```yaml
+apiVersion: vat.dev/v1
+kind: Agent
+
+metadata:
+  name: "agent-name"
+  version: "0.1.0"
+  description: "Agent description"
+
+spec:
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4.5
+    temperature: 0.7
+
+  prompts:
+    system:
+      $ref: ./prompts/system.md
+
+  tools:
+    - name: tool_name
+      type: library
+      description: Tool description
+
+  resources:
+    resource_id:
+      path: ./path/to/file
+      type: template
+```
+
+See `@vibe-agent-toolkit/agent-schema` for complete schema reference.
+
+## Examples
+
+### Example 1: Validate agent-generator
+
+```bash
+cd packages/vat-development-agents
+vat agent validate agents/agent-generator
+```
+
+### Example 2: Validate with custom path
+
+```bash
+vat agent validate ./my-custom-agent/agent.yaml
+```
+
+## Environment Variables
+
+- `ANTHROPIC_API_KEY` - API key for Anthropic (Claude)
+- `OPENAI_API_KEY` - API key for OpenAI
+- `GOOGLE_API_KEY` - API key for Google (Gemini)
+
+## See Also
+
+- [@vibe-agent-toolkit/agent-schema](../../agent-schema/README.md) - Schema reference
+- [agent-generator](../../vat-development-agents/agents/agent-generator/README.md) - Example agent
+- [RAG Commands](./rag.md) - Indexing documentation for RAG tools

package/docs/index.md

@@ -0,0 +1,65 @@
+# vat - Vibe Agent Toolkit CLI
+
+## Overview
+
+The `vat` command-line tool provides markdown resource validation and scanning
+for AI agent projects.
+
+## Usage
+
+```bash
+vat [options] <command>
+```
+
+## Global Options
+
+- `--version` - Show version number
+- `--help` - Show help for any command
+- `--help --verbose` - Show comprehensive help (this output)
+- `--debug` - Enable debug logging
+
+## Commands
+
+### resources
+Markdown resource scanning and validation
+
+- `vat resources scan [path]` - Discover markdown files and report statistics
+- `vat resources validate [path]` - Validate internal links and anchors
+- `vat resources --help --verbose` - Show detailed command help
+
+## Exit Codes
+
+- `0` - Success
+- `1` - Validation errors (broken links, missing anchors)
+- `2` - System errors (invalid config, directory not found)
+
+## Examples
+
+```bash
+# Validate markdown in docs directory
+vat resources validate docs/
+
+# Scan for markdown files
+vat resources scan .
+
+# Use in CI with exit code checking
+vat resources validate docs/ && echo "Docs valid"
+```
+
+## Configuration
+
+Place `vibe-agent-toolkit.config.yaml` at project root:
+
+```yaml
+version: 1
+resources:
+  include:
+    - "docs/**/*.md"
+  exclude:
+    - "node_modules/**"
+```
+
+## More Information
+
+- Documentation: https://github.com/jdutton/vibe-agent-toolkit
+- Issues: https://github.com/jdutton/vibe-agent-toolkit/issues