gencode-ai 0.4.1 → 0.5.0

package/dist/base/discovery/path-resolver.js

@@ -0,0 +1,92 @@
+/**
+ * Path Resolver - Unified path resolution for resource discovery
+ *
+ * Provides consistent path resolution across all resource types (Commands, Skills,
+ * Subagents, MCP) with configurable levels and namespaces.
+ *
+ * Priority rules:
+ * - Level: user < project < local < managed (ascending priority)
+ * - Namespace: claude < gen (gen has higher priority within same level)
+ */
+import * as path from 'path';
+import * as os from 'os';
+import { GEN_DIR, CLAUDE_DIR, getManagedPaths, pathExists, findProjectRoot, } from '../utils/path-utils.js';
+// Re-export for backward compatibility
+export { GEN_DIR, CLAUDE_DIR, findProjectRoot };
+/**
+ * Get resource directories for discovery
+ *
+ * Returns directories in priority order (lowest first) for proper fallback:
+ * - Lower priority directories are processed first
+ * - Higher priority resources override lower priority ones
+ *
+ * @param projectRoot Project root directory
+ * @param subdirectory Subdirectory name (e.g., "commands", "skills") or empty string for root
+ * @param levels Which levels to include (default: ['user', 'project'])
+ * @returns Array of resource directories in priority order
+ */
+export async function getResourceDirectories(projectRoot, subdirectory, levels = ['user', 'project']) {
+    const home = os.homedir();
+    const managedPaths = getManagedPaths();
+    const directories = [];
+    // Level priority map
+    const levelPriority = {
+        user: 10,
+        project: 30,
+        local: 40,
+        managed: 100,
+    };
+    // Process each requested level
+    for (const level of levels) {
+        const baseDirs = [];
+        // Determine base directories for this level
+        switch (level) {
+            case 'user':
+                baseDirs.push({ dir: path.join(home, CLAUDE_DIR), namespace: 'claude' }, { dir: path.join(home, GEN_DIR), namespace: 'gen' });
+                break;
+            case 'project':
+                baseDirs.push({ dir: path.join(projectRoot, CLAUDE_DIR), namespace: 'claude' }, { dir: path.join(projectRoot, GEN_DIR), namespace: 'gen' });
+                break;
+            case 'local':
+                // Local level uses .local suffix directories for override purposes
+                // These are git-ignored local-only configurations
+                baseDirs.push({ dir: path.join(projectRoot, `${CLAUDE_DIR}.local`), namespace: 'claude' }, { dir: path.join(projectRoot, `${GEN_DIR}.local`), namespace: 'gen' });
+                break;
+            case 'managed':
+                baseDirs.push({ dir: managedPaths.claude, namespace: 'claude' }, { dir: managedPaths.gen, namespace: 'gen' });
+                break;
+        }
+        // Add subdirectory and create ResourceDirectory entries
+        for (const { dir, namespace } of baseDirs) {
+            const fullPath = subdirectory ? path.join(dir, subdirectory) : dir;
+            const exists = await pathExists(fullPath);
+            directories.push({
+                path: fullPath,
+                level,
+                namespace,
+                exists,
+            });
+        }
+    }
+    // Sort by level priority (ascending), then by namespace (claude < gen)
+    directories.sort((a, b) => {
+        const priorityDiff = levelPriority[a.level] - levelPriority[b.level];
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        // Within same level, claude < gen
+        if (a.namespace === 'claude' && b.namespace === 'gen')
+            return -1;
+        if (a.namespace === 'gen' && b.namespace === 'claude')
+            return 1;
+        return 0;
+    });
+    return directories;
+}
+/**
+ * Get only existing resource directories
+ */
+export async function getExistingResourceDirectories(projectRoot, subdirectory, levels = ['user', 'project']) {
+    const all = await getResourceDirectories(projectRoot, subdirectory, levels);
+    return all.filter((dir) => dir.exists === true);
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/base/discovery/path-resolver.js.map

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

package/dist/base/discovery/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Unified Resource Discovery System - Core Types
+ *
+ * This module provides the foundational types for a unified resource discovery
+ * system that eliminates code duplication across Commands, Skills, Subagents, and MCP.
+ *
+ * All resources follow the same merge strategy:
+ * - Load from all levels and namespaces
+ * - Priority: user < project < local < managed
+ * - Within each level: claude < gen
+ * - Higher priority resources override lower priority ones (by name)
+ */
+/**
+ * Resource level - hierarchical configuration levels
+ */
+export type ResourceLevel = 'user' | 'project' | 'local' | 'managed';
+/**
+ * Resource namespace - identifies the config system (.gen or .claude)
+ */
+export type ResourceNamespace = 'gen' | 'claude';
+/**
+ * Source metadata for discovered resources
+ *
+ * Tracks where a resource was loaded from, following the priority:
+ * .gen > .claude and project > user
+ */
+export interface ResourceSource {
+    /** User or project level */
+    level: ResourceLevel;
+    /** Gen or Claude namespace */
+    namespace: ResourceNamespace;
+    /** Absolute path to the resource file */
+    path: string;
+}
+/**
+ * Base interface for all discoverable resources
+ *
+ * Any resource type (Command, Skill, Subagent) must extend this interface
+ * to be compatible with the unified discovery system.
+ */
+export interface DiscoverableResource {
+    /** Unique resource name */
+    name: string;
+    /** Source metadata */
+    source: ResourceSource;
+}
+/**
+ * File pattern matching strategy
+ */
+export type FilePattern = {
+    /** Flat structure - files directly in directory (e.g., commands/*.md) */
+    type: 'flat';
+    /** File extension including dot (e.g., '.md') */
+    extension: string;
+} | {
+    /** Nested structure - files in subdirectories (e.g., skills/star/SKILL.md) */
+    type: 'nested';
+    /** Exact filename to match (e.g., 'SKILL.md') */
+    filename: string;
+} | {
+    /** Multiple extensions - supports various file types (e.g., agents/star.{json,md}) */
+    type: 'multiple';
+    /** Array of extensions including dots (e.g., ['.json', '.md']) */
+    extensions: string[];
+} | {
+    /** Single file - a specific file at the root (e.g., .mcp.json) */
+    type: 'single';
+    /** Exact filename (e.g., '.mcp.json') */
+    filename: string;
+} | {
+    /** Recursive structure - files in directory and all subdirectories (e.g., commands/**\/*.md) */
+    type: 'recursive';
+    /** File extension including dot (e.g., '.md') */
+    extension: string;
+};
+/**
+ * Resource parser interface
+ *
+ * Each resource type must implement this interface to handle
+ * file parsing and validation.
+ */
+export interface ResourceParser<T extends DiscoverableResource> {
+    /**
+     * Parse a resource file
+     *
+     * @param filePath Absolute path to the resource file
+     * @param level Resource level (user or project)
+     * @param namespace Resource namespace (gen or claude)
+     * @returns Parsed resource or null if parsing fails
+     */
+    parse(filePath: string, level: ResourceLevel, namespace: ResourceNamespace): Promise<T | null>;
+    /**
+     * Validate a resource name
+     *
+     * @param name Resource name to validate
+     * @returns true if the name is valid
+     */
+    isValidName(name: string): boolean;
+}
+/**
+ * Discovery configuration
+ *
+ * Configures the unified discovery system for a specific resource type.
+ */
+export interface DiscoveryConfig<T extends DiscoverableResource> {
+    /** Resource type name for logging (e.g., "Command", "Skill", "MCP Server") */
+    resourceType: string;
+    /** Subdirectory name within .gen/.claude (e.g., "commands", "skills"), or empty for root */
+    subdirectory: string;
+    /** File pattern matching strategy */
+    filePattern: FilePattern;
+    /** Parser implementation for this resource type */
+    parser: ResourceParser<T>;
+    /** Which levels to include (default: ['user', 'project']) */
+    levels?: ResourceLevel[];
+}
+/**
+ * Resource directory metadata
+ *
+ * Used internally by the discovery system to track search paths.
+ */
+export interface ResourceDirectory {
+    /** Absolute path to the directory */
+    path: string;
+    /** Resource level */
+    level: ResourceLevel;
+    /** Resource namespace */
+    namespace: ResourceNamespace;
+    /** Whether the directory exists */
+    exists?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/base/discovery/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/base/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,aAAa,CAAC;IAErB,8BAA8B;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAE7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IACE,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,8EAA8E;IAC9E,IAAI,EAAE,QAAQ,CAAC;IACf,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,sFAAsF;IACtF,IAAI,EAAE,UAAU,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,GACD;IACE,kEAAkE;IAClE,IAAI,EAAE,QAAQ,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,gGAAgG;IAChG,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,oBAAoB;IAC5D;;;;;;;OAOG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAErB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,oBAAoB;IAC7D,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IAErB,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,WAAW,EAAE,WAAW,CAAC;IAEzB,mDAAmD;IACnD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAE1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,KAAK,EAAE,aAAa,CAAC;IAErB,yBAAyB;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/base/discovery/types.js

@@ -0,0 +1,14 @@
+/**
+ * Unified Resource Discovery System - Core Types
+ *
+ * This module provides the foundational types for a unified resource discovery
+ * system that eliminates code duplication across Commands, Skills, Subagents, and MCP.
+ *
+ * All resources follow the same merge strategy:
+ * - Load from all levels and namespaces
+ * - Priority: user < project < local < managed
+ * - Within each level: claude < gen
+ * - Higher priority resources override lower priority ones (by name)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/base/discovery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/base/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/base/utils/config-validator.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Configuration Validator
+ *
+ * Provides Zod schemas for validating various configuration files:
+ * - SKILL.md frontmatter
+ * - Command markdown frontmatter
+ * - Custom agent JSON/MD files
+ * - Hooks configuration
+ */
+import { z } from 'zod';
+/**
+ * SKILL.md frontmatter schema
+ */
+export declare const SkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    'allowed-tools': z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;
+/**
+ * Command markdown frontmatter schema
+ */
+export declare const CommandFrontmatterSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    'allowed-tools': z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    'argument-hint': z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    includes: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export type CommandFrontmatter = z.infer<typeof CommandFrontmatterSchema>;
+/**
+ * Custom agent schema (JSON format)
+ */
+export declare const CustomAgentSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    allowedTools: z.ZodArray<z.ZodString>;
+    defaultModel: z.ZodDefault<z.ZodString>;
+    maxTurns: z.ZodDefault<z.ZodNumber>;
+    permissionMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        strict: "strict";
+        permissive: "permissive";
+    }>>>;
+    systemPrompt: z.ZodString;
+}, z.core.$strip>;
+export type CustomAgent = z.infer<typeof CustomAgentSchema>;
+/**
+ * Hook configuration schema
+ */
+export declare const HookSchema: z.ZodObject<{
+    event: z.ZodEnum<{
+        ToolCall: "ToolCall";
+        AgentStart: "AgentStart";
+        AgentEnd: "AgentEnd";
+        UserPromptSubmit: "UserPromptSubmit";
+        Notification: "Notification";
+        Stop: "Stop";
+    }>;
+    matcher: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodOptional<z.ZodString>;
+        pattern: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    command: z.ZodString;
+    blocking: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, z.core.$strip>;
+export type Hook = z.infer<typeof HookSchema>;
+/**
+ * Hooks configuration schema
+ */
+export declare const HooksConfigSchema: z.ZodObject<{
+    hooks: z.ZodArray<z.ZodObject<{
+        event: z.ZodEnum<{
+            ToolCall: "ToolCall";
+            AgentStart: "AgentStart";
+            AgentEnd: "AgentEnd";
+            UserPromptSubmit: "UserPromptSubmit";
+            Notification: "Notification";
+            Stop: "Stop";
+        }>;
+        matcher: z.ZodOptional<z.ZodObject<{
+            tool: z.ZodOptional<z.ZodString>;
+            pattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        command: z.ZodString;
+        blocking: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HooksConfig = z.infer<typeof HooksConfigSchema>;
+/**
+ * Validation result
+ */
+export interface ValidationResult<T> {
+    valid: boolean;
+    data?: T;
+    errors?: string[];
+}
+/**
+ * Validate configuration data against a Zod schema
+ *
+ * @param schema - Zod schema to validate against
+ * @param data - Data to validate
+ * @param context - Context for error messages (e.g., file path)
+ * @returns Validation result with parsed data or errors
+ */
+export declare function validateConfig<T>(schema: z.ZodSchema<T>, data: unknown, context: string): ValidationResult<T>;
+/**
+ * Validate skill frontmatter
+ */
+export declare function validateSkillFrontmatter(data: unknown, filePath: string): ValidationResult<SkillFrontmatter>;
+/**
+ * Validate command frontmatter
+ */
+export declare function validateCommandFrontmatter(data: unknown, filePath: string): ValidationResult<CommandFrontmatter>;
+/**
+ * Validate custom agent configuration
+ */
+export declare function validateCustomAgent(data: unknown, filePath: string): ValidationResult<CustomAgent>;
+/**
+ * Validate hooks configuration
+ */
+export declare function validateHooksConfig(data: unknown, filePath: string): ValidationResult<HooksConfig>;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/base/utils/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../src/base/utils/config-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAUjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;iBAiBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAU5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;iBAkBrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,gBAAgB,CAAC,CAAC,CAAC,CAwBrB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,gBAAgB,CAAC,CAEpC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,kBAAkB,CAAC,CAEtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,WAAW,CAAC,CAE/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,WAAW,CAAC,CAE/B"}

package/dist/base/utils/config-validator.js

@@ -0,0 +1,143 @@
+/**
+ * Configuration Validator
+ *
+ * Provides Zod schemas for validating various configuration files:
+ * - SKILL.md frontmatter
+ * - Command markdown frontmatter
+ * - Custom agent JSON/MD files
+ * - Hooks configuration
+ */
+import { z } from 'zod';
+import { logger } from './logger.js';
+/**
+ * SKILL.md frontmatter schema
+ */
+export const SkillFrontmatterSchema = z.object({
+    name: z.string().min(1, 'Skill name is required'),
+    description: z.string().min(1, 'Skill description is required'),
+    'allowed-tools': z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe('Tools allowed for this skill (string or array)'),
+    version: z.string().optional(),
+    author: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+});
+/**
+ * Command markdown frontmatter schema
+ */
+export const CommandFrontmatterSchema = z.object({
+    name: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Command name (optional, defaults to filename)'),
+    description: z.string().min(1, 'Command description is required'),
+    'allowed-tools': z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe('Tools allowed for this command'),
+    'argument-hint': z.string().optional().describe('Hint for command arguments'),
+    model: z.string().optional().describe('Preferred model for this command'),
+    includes: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe('Files to include inline (relative paths)'),
+});
+/**
+ * Custom agent schema (JSON format)
+ */
+export const CustomAgentSchema = z.object({
+    name: z.string().min(1, 'Agent name is required'),
+    description: z.string().min(1, 'Agent description is required'),
+    allowedTools: z
+        .array(z.string())
+        .min(1, 'At least one allowed tool is required'),
+    defaultModel: z.string().default('claude-sonnet-4'),
+    maxTurns: z.number().positive().default(20),
+    permissionMode: z.enum(['strict', 'permissive']).default('strict').optional(),
+    systemPrompt: z.string().min(1, 'System prompt is required'),
+});
+/**
+ * Hook configuration schema
+ */
+export const HookSchema = z.object({
+    event: z.enum([
+        'ToolCall',
+        'AgentStart',
+        'AgentEnd',
+        'UserPromptSubmit',
+        'Notification',
+        'Stop',
+    ]),
+    matcher: z
+        .object({
+        tool: z.string().optional(),
+        pattern: z.string().optional(),
+    })
+        .optional(),
+    command: z.string().min(1, 'Hook command is required'),
+    blocking: z.boolean().default(false).optional(),
+    timeout: z.number().positive().default(5000).optional(),
+});
+/**
+ * Hooks configuration schema
+ */
+export const HooksConfigSchema = z.object({
+    hooks: z.array(HookSchema),
+});
+/**
+ * Validate configuration data against a Zod schema
+ *
+ * @param schema - Zod schema to validate against
+ * @param data - Data to validate
+ * @param context - Context for error messages (e.g., file path)
+ * @returns Validation result with parsed data or errors
+ */
+export function validateConfig(schema, data, context) {
+    try {
+        const validated = schema.parse(data);
+        return { valid: true, data: validated };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.issues.map((e) => {
+                const path = e.path.join('.');
+                return path ? `${path}: ${e.message}` : e.message;
+            });
+            logger.error('Validator', `Invalid configuration in ${context}`, { errors });
+            return { valid: false, errors };
+        }
+        // Unknown error
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error('Validator', `Validation failed for ${context}`, {
+            error: errorMsg,
+        });
+        return { valid: false, errors: [errorMsg] };
+    }
+}
+/**
+ * Validate skill frontmatter
+ */
+export function validateSkillFrontmatter(data, filePath) {
+    return validateConfig(SkillFrontmatterSchema, data, filePath);
+}
+/**
+ * Validate command frontmatter
+ */
+export function validateCommandFrontmatter(data, filePath) {
+    return validateConfig(CommandFrontmatterSchema, data, filePath);
+}
+/**
+ * Validate custom agent configuration
+ */
+export function validateCustomAgent(data, filePath) {
+    return validateConfig(CustomAgentSchema, data, filePath);
+}
+/**
+ * Validate hooks configuration
+ */
+export function validateHooksConfig(data, filePath) {
+    return validateConfig(HooksConfigSchema, data, filePath);
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/base/utils/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../../src/base/utils/config-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;IACjE,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IAC7E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;CAC7D,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;QACZ,UAAU;QACV,YAAY;QACZ,UAAU;QACV,kBAAkB;QAClB,cAAc;QACd,MAAM;KACP,CAAC;IACF,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;CAC3B,CAAC,CAAC;AAaH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,IAAa,EACb,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAa,EAAE,EAAE;gBAChD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpD,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,4BAA4B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAE7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QAED,gBAAgB;QAChB,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,yBAAyB,OAAO,EAAE,EAAE;YAC5D,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAa,EACb,QAAgB;IAEhB,OAAO,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAa,EACb,QAAgB;IAEhB,OAAO,cAAc,CAAC,wBAAwB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,QAAgB;IAEhB,OAAO,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,QAAgB;IAEhB,OAAO,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC"}

package/dist/base/utils/debug.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Debug configuration module
+ * Controls debug output for various GenCode components
+ *
+ * Debug Levels:
+ * - GEN_DEBUG=0 or unset: No debug output (default)
+ * - GEN_DEBUG=1: Standard debug output (component loading, key operations)
+ * - GEN_DEBUG=2: Verbose debug output (detailed execution, parameters, results)
+ */
+export type DebugLevel = 0 | 1 | 2;
+export interface DebugConfig {
+    level: DebugLevel;
+    enabled: boolean;
+    verbose: boolean;
+    components: {
+        skills: DebugLevel;
+        commands: DebugLevel;
+        subagents: DebugLevel;
+        hooks: DebugLevel;
+        mcp: DebugLevel;
+        tools: DebugLevel;
+        discovery: DebugLevel;
+    };
+}
+/**
+ * Get debug configuration based on environment variables
+ *
+ * - GEN_DEBUG=0 or unset: No debug output (default)
+ * - GEN_DEBUG=1: Standard debug output (loading, key operations)
+ * - GEN_DEBUG=2: Verbose debug output (detailed execution, parameters)
+ * - GEN_DEBUG_<COMPONENT>=1|2: Component-specific debug level
+ */
+export declare function getDebugConfig(): DebugConfig;
+/**
+ * Check if debug is enabled for a specific component (level >= 1)
+ */
+export declare function isDebugEnabled(component: keyof DebugConfig['components']): boolean;
+/**
+ * Check if verbose debug is enabled for a specific component (level >= 2)
+ */
+export declare function isVerboseDebugEnabled(component: keyof DebugConfig['components']): boolean;
+/**
+ * Get debug level for a specific component
+ */
+export declare function getDebugLevel(component: keyof DebugConfig['components']): DebugLevel;
+/**
+ * Reset cached config (useful for testing)
+ */
+export declare function resetDebugConfig(): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/base/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/base/utils/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE;QACV,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,EAAE,UAAU,CAAC;QACrB,SAAS,EAAE,UAAU,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC;QAClB,GAAG,EAAE,UAAU,CAAC;QAChB,KAAK,EAAE,UAAU,CAAC;QAClB,SAAS,EAAE,UAAU,CAAC;KACvB,CAAC;CACH;AAeD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAuB5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,OAAO,CAGlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,OAAO,CAGzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,UAAU,CAGpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}