@hashicorp/kits 0.1.0

package/dist/validation/validate-commands.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Command primitive validation script.
+ *
+ * Validates all command files in a kit repository against
+ * the canonical format specification:
+ * - YAML frontmatter required
+ * - `description` field required and non-empty
+ * - `argumentHint` field optional but must be string if present
+ * - Body content required and non-empty
+ *
+ * Exits with code 0 on success, 1 on validation failure.
+ */
+import { type ValidationSummary } from "./utils.js";
+/**
+ * Validate all command files in a kit repository.
+ *
+ * @param agentKitsPath - Path to kit repository
+ * @returns Validation summary with results for each file
+ */
+export declare function validateCommands(agentKitsPath: string): Promise<ValidationSummary>;
+/**
+ * Main entry point for CLI execution.
+ *
+ * @param args - Command line arguments
+ * @returns Exit code (0 = success, 1 = failure)
+ */
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-commands.d.ts.map

package/dist/validation/validate-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-commands.d.ts","sourceRoot":"","sources":["../../src/validation/validate-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAkEpB;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoE1D"}

package/dist/validation/validate-commands.js

@@ -0,0 +1,151 @@
+/**
+ * Command primitive validation script.
+ *
+ * Validates all command files in a kit repository against
+ * the canonical format specification:
+ * - YAML frontmatter required
+ * - `description` field required and non-empty
+ * - `argumentHint` field optional but must be string if present
+ * - Body content required and non-empty
+ *
+ * Exits with code 0 on success, 1 on validation failure.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "node:url";
+import { parseCommandFrontmatter, CommandParseError, } from "../adapters/command-parser.js";
+import pc from "picocolors";
+import { formatValidationSourceError, resolveValidationSource, } from "./source.js";
+import { findMarkdownFiles, summarizeResults, printValidationResults, } from "./utils.js";
+/**
+ * Find all command files in a kit repository.
+ *
+ * Searches for:
+ * - Shared primitives: primitives/commands/{name}/v{version}/{name}.md
+ * - Inline kit primitives: kits/{kit}/primitives/commands/{name}.md
+ *
+ * @param agentKitsPath - Path to kit repository
+ * @returns Array of absolute paths to command files
+ */
+async function findCommandFiles(agentKitsPath) {
+    const commandFiles = [];
+    // Find shared primitive commands
+    const sharedCommandsDir = path.join(agentKitsPath, "primitives/commands");
+    const sharedFiles = await findMarkdownFiles(sharedCommandsDir);
+    commandFiles.push(...sharedFiles);
+    // Find inline kit commands - iterate through kits directory
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (kitEntry.isDirectory()) {
+                const kitCommandsDir = path.join(kitsDir, kitEntry.name, "primitives/commands");
+                const kitFiles = await findMarkdownFiles(kitCommandsDir);
+                commandFiles.push(...kitFiles);
+            }
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return commandFiles;
+}
+/**
+ * Validate a single command file.
+ *
+ * @param filePath - Absolute path to command file
+ * @returns Validation result
+ */
+async function validateCommandFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        parseCommandFrontmatter(content);
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof CommandParseError
+            ? error.message
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+/**
+ * Validate all command files in a kit repository.
+ *
+ * @param agentKitsPath - Path to kit repository
+ * @returns Validation summary with results for each file
+ */
+export async function validateCommands(agentKitsPath) {
+    const commandFiles = await findCommandFiles(agentKitsPath);
+    const results = [];
+    for (const file of commandFiles) {
+        const result = await validateCommandFile(file);
+        results.push(result);
+    }
+    return summarizeResults(results);
+}
+/**
+ * Main entry point for CLI execution.
+ *
+ * @param args - Command line arguments
+ * @returns Exit code (0 = success, 1 = failure)
+ */
+export async function main(args) {
+    // Use provided source or fall back to local test-kits if present.
+    let source = args[0];
+    if (!source) {
+        const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+        const fallbackPath = path.resolve(scriptDir, "../../test-kits");
+        try {
+            const stat = await fs.stat(fallbackPath);
+            if (stat.isDirectory()) {
+                source = fallbackPath;
+            }
+        }
+        catch {
+            source = undefined;
+        }
+    }
+    // Resolve to absolute path
+    if (!source) {
+        console.error(pc.red("Error: no kit repository path provided"));
+        console.error(pc.dim("Usage: validate-commands <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    let fetchResult;
+    try {
+        fetchResult = await resolveValidationSource(source);
+    }
+    catch (error) {
+        const message = formatValidationSourceError(error);
+        console.error(pc.red(`Error: ${message}`));
+        console.error(pc.dim("Usage: validate-commands <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    const agentKitsPath = fetchResult.localPath;
+    console.log(pc.dim(`Validating commands in: ${agentKitsPath}`));
+    try {
+        const summary = await validateCommands(agentKitsPath);
+        printValidationResults("Command Primitive Validation", summary, agentKitsPath);
+        if (summary.failed > 0) {
+            console.error(pc.red(`Validation failed: ${summary.failed} command(s) have invalid format`));
+            return 1;
+        }
+        if (summary.total === 0) {
+            console.log(pc.yellow("Warning: No command files found"));
+            return 0;
+        }
+        console.log(pc.green("All command files are valid"));
+        return 0;
+    }
+    catch (error) {
+        console.error(pc.red(`Error during validation: ${error}`));
+        return 1;
+    }
+    finally {
+        await fetchResult.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate-commands.js.map

package/dist/validation/validate-commands.js.map

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

package/dist/validation/validate-hooks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Hook program primitive validation script.
+ *
+ * Validates all hook config.json files in a kit repository against
+ * the canonical hook program JSON schema and ensures the runtime
+ * entrypoint file exists alongside the config.
+ */
+import { type ValidationSummary } from "./utils.js";
+export declare function validateHooks(agentKitsPath: string, options?: {
+    schemaRoot?: string;
+}): Promise<ValidationSummary>;
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-hooks.d.ts.map

package/dist/validation/validate-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-hooks.d.ts","sourceRoot":"","sources":["../../src/validation/validate-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAsMpB,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE1D"}

package/dist/validation/validate-hooks.js

@@ -0,0 +1,272 @@
+/**
+ * Hook program primitive validation script.
+ *
+ * Validates all hook config.json files in a kit repository against
+ * the canonical hook program JSON schema and ensures the runtime
+ * entrypoint file exists alongside the config.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "node:url";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import draft7MetaSchema from "ajv/dist/refs/json-schema-draft-07.json" with { type: "json" };
+import pc from "picocolors";
+import { formatValidationSourceError, resolveValidationSource, } from "./source.js";
+import { findFilesByName, summarizeResults, printValidationResults, } from "./utils.js";
+async function findKitFiles(agentKitsPath) {
+    const files = [];
+    const rootKitPath = path.join(agentKitsPath, "kit.json");
+    try {
+        const stat = await fs.stat(rootKitPath);
+        if (stat.isFile()) {
+            files.push(rootKitPath);
+        }
+    }
+    catch {
+        // root kit.json doesn't exist - ignore
+    }
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (!kitEntry.isDirectory()) {
+                continue;
+            }
+            const kitPath = path.join(kitsDir, kitEntry.name, "kit.json");
+            try {
+                const stat = await fs.stat(kitPath);
+                if (stat.isFile()) {
+                    files.push(kitPath);
+                }
+            }
+            catch {
+                // kit.json missing - ignore
+            }
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return files;
+}
+async function findHookConfigFiles(agentKitsPath) {
+    const files = [];
+    const sharedHooksDir = path.join(agentKitsPath, "primitives/hooks");
+    files.push(...(await findFilesByName(sharedHooksDir, "config.json")));
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (!kitEntry.isDirectory()) {
+                continue;
+            }
+            const kitHooksDir = path.join(kitsDir, kitEntry.name, "primitives/hooks");
+            files.push(...(await findFilesByName(kitHooksDir, "config.json")));
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return files;
+}
+async function validateKitHookBindings(filePath, validateBinding) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const data = JSON.parse(content);
+        const primitives = data["primitives"];
+        const hooks = primitives?.["hooks"];
+        if (hooks === undefined) {
+            return { file: filePath, valid: true };
+        }
+        if (!Array.isArray(hooks)) {
+            return {
+                file: filePath,
+                valid: false,
+                error: "kit primitives.hooks must be an array when present",
+            };
+        }
+        const errors = [];
+        hooks.forEach((entry, index) => {
+            if (!entry || typeof entry !== "object") {
+                errors.push(`primitives.hooks[${index}] must be an object`);
+                return;
+            }
+            const binding = entry["binding"];
+            if (!binding || typeof binding !== "object") {
+                errors.push(`primitives.hooks[${index}].binding must be an object`);
+                return;
+            }
+            const valid = validateBinding(binding);
+            if (!valid) {
+                const bindingErrors = (validateBinding.errors ?? []);
+                const errorText = bindingErrors
+                    .map((err) => {
+                    const instancePath = err.instancePath ? `${err.instancePath} ` : "";
+                    return `${instancePath}${err.message ?? "schema validation error"}`;
+                })
+                    .join("; ");
+                errors.push(`primitives.hooks[${index}].binding: ${errorText}`);
+            }
+            const event = binding["event"];
+            if (event === "tool.before" || event === "tool.after") {
+                const matcher = binding["matcher"];
+                const matcherObj = matcher && typeof matcher === "object"
+                    ? matcher
+                    : undefined;
+                const hasMatcherField = matcherObj
+                    ? ["tool", "command_pattern", "file_pattern", "prompt_pattern"].some((key) => typeof matcherObj[key] === "string" && matcherObj[key]?.length)
+                    : false;
+                if (!hasMatcherField) {
+                    errors.push(`primitives.hooks[${index}].binding: matcher is required for ${event} events`);
+                }
+            }
+        });
+        if (errors.length > 0) {
+            return {
+                file: filePath,
+                valid: false,
+                error: `Hook binding validation failed: ${errors.join(" | ")}`,
+            };
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+async function validateHookFile(filePath, validateSchema) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const data = JSON.parse(content);
+        const valid = validateSchema(data);
+        if (!valid) {
+            const errors = (validateSchema.errors ?? []);
+            const errorText = errors
+                .map((err) => {
+                const instancePath = err.instancePath ? `${err.instancePath} ` : "";
+                return `${instancePath}${err.message ?? "schema validation error"}`;
+            })
+                .join("; ");
+            return {
+                file: filePath,
+                valid: false,
+                error: `Schema validation failed: ${errorText}`,
+            };
+        }
+        const runtime = data["runtime"];
+        const entrypoint = runtime?.["entrypoint"];
+        if (typeof entrypoint === "string" && entrypoint.length > 0) {
+            const entryPath = path.join(path.dirname(filePath), entrypoint);
+            try {
+                const stat = await fs.stat(entryPath);
+                if (!stat.isFile()) {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: `Hook entrypoint is not a file: ${entrypoint}`,
+                    };
+                }
+            }
+            catch {
+                return {
+                    file: filePath,
+                    valid: false,
+                    error: `Hook entrypoint not found: ${entrypoint}`,
+                };
+            }
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+export async function validateHooks(agentKitsPath, options = {}) {
+    const schemaRoot = options.schemaRoot ??
+        path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../schemas");
+    const programSchemaPath = path.join(schemaRoot, "hook-program.schema.json");
+    const programSchemaContent = await fs.readFile(programSchemaPath, "utf-8");
+    const programSchema = JSON.parse(programSchemaContent);
+    const bindingSchemaPath = path.join(schemaRoot, "hook-binding.schema.json");
+    const bindingSchemaContent = await fs.readFile(bindingSchemaPath, "utf-8");
+    const bindingSchema = JSON.parse(bindingSchemaContent);
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    const applyFormats = addFormats;
+    applyFormats(ajv);
+    // Hook schemas are draft-07, so register that meta schema (both http/https IDs).
+    ajv.addMetaSchema(draft7MetaSchema);
+    ajv.addMetaSchema({
+        ...draft7MetaSchema,
+        $id: "https://json-schema.org/draft-07/schema#",
+    });
+    const validateProgramSchema = ajv.compile(programSchema);
+    const validateBindingSchema = ajv.compile(bindingSchema);
+    const hookFiles = await findHookConfigFiles(agentKitsPath);
+    const results = [];
+    for (const file of hookFiles) {
+        results.push(await validateHookFile(file, validateProgramSchema));
+    }
+    const kitFiles = await findKitFiles(agentKitsPath);
+    for (const file of kitFiles) {
+        results.push(await validateKitHookBindings(file, validateBindingSchema));
+    }
+    return summarizeResults(results);
+}
+export async function main(args) {
+    let source = args[0];
+    if (!source) {
+        const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+        const fallbackPath = path.resolve(scriptDir, "../../test-kits");
+        try {
+            const stat = await fs.stat(fallbackPath);
+            if (stat.isDirectory()) {
+                source = fallbackPath;
+            }
+        }
+        catch {
+            source = undefined;
+        }
+    }
+    if (!source) {
+        console.error(pc.red("Error: no kit repository path provided"));
+        console.error(pc.dim("Usage: validate-hooks <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    let fetchResult;
+    try {
+        fetchResult = await resolveValidationSource(source);
+    }
+    catch (error) {
+        const message = formatValidationSourceError(error);
+        console.error(pc.red(`Error: ${message}`));
+        console.error(pc.dim("Usage: validate-hooks <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    const agentKitsPath = fetchResult.localPath;
+    console.log(pc.dim(`Validating hook programs in: ${agentKitsPath}`));
+    try {
+        const summary = await validateHooks(agentKitsPath);
+        printValidationResults("Hook Primitive Validation", summary, agentKitsPath);
+        if (summary.failed > 0) {
+            console.error(pc.red(`Validation failed: ${summary.failed} hook program(s) have invalid format`));
+            return 1;
+        }
+        if (summary.total === 0) {
+            console.log(pc.yellow("Warning: No hook config files found"));
+            return 0;
+        }
+        console.log(pc.green("All hook config files are valid"));
+        return 0;
+    }
+    catch (error) {
+        console.error(pc.red(`Error during validation: ${error}`));
+        return 1;
+    }
+    finally {
+        await fetchResult.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate-hooks.js.map

package/dist/validation/validate-hooks.js.map

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

package/dist/validation/validate-kits.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Kit manifest and registry validation script.
+ *
+ * Validates kit.json files and kits.json registries in a kit repository
+ * against their canonical JSON schemas.
+ */
+import type { ValidateFunction } from "ajv";
+import { type ValidationResult, type ValidationSummary } from "./utils.js";
+export declare function validateKitsRegistryFile(filePath: string, validateSchema: ValidateFunction): Promise<ValidationResult>;
+export declare function validateKitManifestFile(filePath: string, validateSchema: ValidateFunction): Promise<ValidationResult>;
+export declare function validateKits(agentKitsPath: string, options?: {
+    schemaRoot?: string;
+}): Promise<ValidationSummary>;
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-kits.d.ts.map

package/dist/validation/validate-kits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-kits.d.ts","sourceRoot":"","sources":["../../src/validation/validate-kits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAI9D,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAoDpB,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,gBAAgB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,gBAAgB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAoC5B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE1D"}