@claudetools/tools 0.6.0 → 0.7.1

package/dist/handlers/codedna-handlers.d.ts

@@ -1,5 +1,26 @@
+export interface CodeDNAPattern {
+    pattern_id: string;
+    name: string;
+    category: 'components' | 'hooks' | 'forms' | 'state' | 'validation' | 'styling' | 'anti-patterns';
+    description: string;
+    conditions: string[];
+    anti_conditions: string[];
+    code_signals: string[];
+    package_signals: string[];
+    related_patterns: string[];
+    migrates_from: string[];
+    is_recommended: boolean;
+    is_anti_pattern: boolean;
+    version: string;
+    r2_key?: string;
+}
 /**
  * Handle codedna_generate_api tool call
+ *
+ * Pattern-aware generation:
+ * - If package_json is provided, patterns are detected automatically
+ * - If patterns is provided in options, those are used directly
+ * - Generated code will use template variants matching detected patterns
  */
 export declare function handleGenerateApi(args: any): Promise<{
     error: string;
@@ -8,6 +29,7 @@ export declare function handleGenerateApi(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
@@ -17,12 +39,14 @@ export declare function handleGenerateApi(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
     success: boolean;
     files: Record<string, string>;
     metadata: import("../codedna/types.js").GenerationMetadata;
+    patternsApplied: string[] | undefined;
     tokenSavings: {
         traditional: number;
         codedna: number;
@@ -41,10 +65,16 @@ export declare function handleGenerateApi(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
 }>;
 /**
  * Handle codedna_generate_frontend tool call
+ *
+ * Pattern-aware generation:
+ * - If package_json is provided, patterns are detected automatically
+ * - Detects React Hook Form, Zod, TanStack Query, etc.
+ * - Uses template variants matching detected patterns
  */
 export declare function handleGenerateFrontend(args: any): Promise<{
     error: string;
@@ -53,6 +83,7 @@ export declare function handleGenerateFrontend(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
@@ -62,12 +93,14 @@ export declare function handleGenerateFrontend(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
     success: boolean;
     files: Record<string, string>;
     metadata: import("../codedna/types.js").GenerationMetadata;
+    patternsApplied: string[] | undefined;
     tokenSavings: {
         traditional: number;
         codedna: number;
@@ -86,10 +119,15 @@ export declare function handleGenerateFrontend(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
 }>;
 /**
  * Handle codedna_generate_component tool call
+ *
+ * Pattern-aware generation:
+ * - If package_json is provided, patterns are detected automatically
+ * - Uses matching patterns for form libraries, validation, etc.
  */
 export declare function handleGenerateComponent(args: any): Promise<{
     error: string;
@@ -98,6 +136,7 @@ export declare function handleGenerateComponent(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
@@ -107,12 +146,14 @@ export declare function handleGenerateComponent(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
     message?: undefined;
 } | {
     success: boolean;
     files: Record<string, string>;
     metadata: import("../codedna/types.js").GenerationMetadata;
+    patternsApplied: string[] | undefined;
     tokenSavings: {
         traditional: number;
         codedna: number;
@@ -131,24 +172,36 @@ export declare function handleGenerateComponent(args: any): Promise<{
     success?: undefined;
     files?: undefined;
     metadata?: undefined;
+    patternsApplied?: undefined;
     tokenSavings?: undefined;
 }>;
 /**
  * Handle codedna_list_generators tool call
+ * @param args.domain Optional domain filter: 'api' | 'frontend' | 'component'
  */
-export declare function handleListGenerators(): Promise<{
-    generators: import("../codedna/types.js").GeneratorMetadata[];
+export declare function handleListGenerators(args?: {
+    domain?: 'api' | 'frontend' | 'component';
+}): Promise<{
     summary: {
+        byFramework: Record<string, number>;
+        byDomain: Record<string, number> | undefined;
+        availableUiLibraries: string[];
+        filteredByDomain?: "api" | "frontend" | "component" | undefined;
         total: number;
-        byFramework: any;
     };
+    usage: {
+        api: string;
+        frontend: string;
+        component: string;
+        note: string;
+    };
+    byDomain?: Record<string, import("../codedna/types.js").GeneratorMetadata[]> | undefined;
+    generators: import("../codedna/types.js").GeneratorMetadata[];
     error?: undefined;
     message?: undefined;
 } | {
     error: string;
     message: string;
-    generators?: undefined;
-    summary?: undefined;
 }>;
 /**
  * Handle codedna_validate_spec tool call
@@ -160,7 +213,7 @@ export declare function handleValidateSpec(args: any): Promise<{
         fields: {
             name: string;
             type: import("../codedna/parser.js").FieldType;
-            constraints: ("default" | "length" | "email" | "min" | "max" | "url" | "required" | "pattern" | "nullable" | "unique" | "hashed" | "index" | "immutable")[];
+            constraints: ("default" | "length" | "email" | "min" | "max" | "url" | "required" | "pattern" | "nullable" | "unique" | "hashed" | "index" | "immutable" | "textarea" | "switch" | "radio")[];
         }[];
     };
     summary: {
@@ -176,3 +229,163 @@ export declare function handleValidateSpec(args: any): Promise<{
     entity?: undefined;
     summary?: undefined;
 }>;
+/**
+ * Handle codedna_list_patterns tool call
+ * Lists patterns from the library, optionally filtered by category
+ */
+export declare function handleListPatterns(args?: {
+    category?: CodeDNAPattern['category'];
+    recommended_only?: boolean;
+    include_anti_patterns?: boolean;
+}): Promise<{
+    patterns: CodeDNAPattern[];
+    byCategory: Record<string, CodeDNAPattern[]>;
+    summary: {
+        total: number;
+        recommended: number;
+        antiPatterns: number;
+        categories: string[];
+    };
+    usage: {
+        getDetails: string;
+        detect: string;
+        init: string;
+    };
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    patterns?: undefined;
+    byCategory?: undefined;
+    summary?: undefined;
+    usage?: undefined;
+}>;
+/**
+ * Handle codedna_get_pattern tool call
+ * Gets detailed pattern information including full markdown documentation
+ */
+export declare function handleGetPattern(args: {
+    pattern_id: string;
+}): Promise<{
+    error: string;
+    pattern?: undefined;
+    sections?: undefined;
+    detection?: undefined;
+    content?: undefined;
+    message?: undefined;
+} | {
+    pattern: CodeDNAPattern & {
+        content?: string;
+    };
+    sections: {
+        description: string;
+        whenToUse: string[];
+        whenNotToUse: string[];
+        relatedPatterns: string[];
+        migratesFrom: string[];
+    };
+    detection: {
+        codeSignals: string[];
+        packageSignals: string[];
+    };
+    content: string | undefined;
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    pattern?: undefined;
+    sections?: undefined;
+    detection?: undefined;
+    content?: undefined;
+}>;
+/**
+ * Handle codedna_detect_patterns tool call
+ * Detects patterns in a project based on code and package.json signals
+ */
+export declare function handleDetectPatterns(args: {
+    project_path?: string;
+    package_json?: Record<string, unknown>;
+    code_samples?: string[];
+}): Promise<{
+    detected: {
+        pattern: CodeDNAPattern;
+        confidence: number;
+        signals: string[];
+    }[];
+    warnings: {
+        message: string;
+        patterns: {
+            pattern: CodeDNAPattern;
+            confidence: number;
+            signals: string[];
+        }[];
+    } | undefined;
+    summary: {
+        totalDetected: number;
+        goodPatterns: number;
+        antiPatterns: number;
+        highConfidence: number;
+    };
+    recommendations: {
+        pattern_id: string;
+        name: string;
+        description: string;
+        reason: string;
+    }[];
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    detected?: undefined;
+    warnings?: undefined;
+    summary?: undefined;
+    recommendations?: undefined;
+}>;
+/**
+ * Handle codedna_init_project tool call
+ * Initializes a new project with recommended patterns
+ */
+export declare function handleInitProject(args: {
+    project_id: string;
+    patterns?: string[];
+    auto_detect?: boolean;
+    project_type?: 'new' | 'existing';
+}): Promise<{
+    error: string;
+    success?: undefined;
+    project_id?: undefined;
+    project_type?: undefined;
+    patterns?: undefined;
+    summary?: undefined;
+    nextSteps?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    project_id: string;
+    project_type: "new" | "existing";
+    patterns: {
+        pattern_id: string;
+        name: string;
+        category: "hooks" | "components" | "forms" | "state" | "validation" | "styling" | "anti-patterns";
+        description: string;
+    }[];
+    summary: {
+        totalPatterns: number;
+        byCategory: Record<string, number>;
+    };
+    nextSteps: string[];
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    success?: undefined;
+    project_id?: undefined;
+    project_type?: undefined;
+    patterns?: undefined;
+    summary?: undefined;
+    nextSteps?: undefined;
+}>;