@jpoindexter/agent-smith 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -38,7 +38,7 @@ npx @jpoindexter/agent-smith
38
38
  ✓ Found 5 components with CVA variants
39
39
  ✓ Found 37 color tokens
40
40
  ✓ Found 14 custom hooks
41
- ✓ Found 46 API routes
41
+ ✓ Found 46 API routes (8 with schemas)
42
42
  ✓ Found 87 environment variables
43
43
  ✓ Detected Next.js (App Router)
44
44
  ✓ Detected shadcn/ui (26 Radix packages)
@@ -109,6 +109,42 @@ agentsmith --xml
109
109
  agentsmith --tree
110
110
  ```
111
111
 
112
+ ## What's New in v1.1.0
113
+
114
+ ### 🎯 API Schema Extraction
115
+ Now detects **Zod validation schemas** and **TypeScript types** from your API routes:
116
+
117
+ ```markdown
118
+ - `POST` `/api/contact`
119
+ - **Request**: contactSchema {
120
+ name: string (max: 100, min: 1, "Name is required")
121
+ email: string (email: Invalid email address)
122
+ subject: "sales" | "support" | "billing" | ...
123
+ }
124
+ ```
125
+
126
+ AI agents can now see your API contracts instead of guessing field names!
127
+
128
+ ### 🧠 Cognitive Complexity Analysis
129
+ Analyzes your codebase complexity and recommends AI model effort levels:
130
+
131
+ ```markdown
132
+ **Complexity by Area:**
133
+ - 🔴 Database: Maximum effort (most capable model)
134
+ - 🟡 API Routes: Standard effort (balanced model)
135
+ - 🟢 Utilities: Minimal effort (fast, low-cost model)
136
+ ```
137
+
138
+ ### 🚀 Performance Improvements
139
+ - **Global schema caching**: O(n²) → O(n) for shared schemas
140
+ - **20-40% faster** on large codebases
141
+
142
+ ### 🌐 GraphQL Support
143
+ Extracts GraphQL schema definitions from `.graphql` and `.gql` files.
144
+
145
+ ### 🤖 Provider-Agnostic AI Recommendations
146
+ Works with **any AI provider** (Claude, GPT, Gemini) - no hardcoded model names.
147
+
112
148
  ## New in v1.0.0
113
149
 
114
150
  ```bash
@@ -195,11 +231,14 @@ Create `agentsmith.config.json` in your project root:
195
231
  | **Tokens** | CSS variables and Tailwind config |
196
232
  | **Hooks** | Custom hooks with client-only detection |
197
233
  | **API Routes** | Next.js routes with methods and auth status |
234
+ | **API Schemas** | Zod validation schemas and TypeScript types for request/response |
235
+ | **GraphQL** | GraphQL schema definitions from .graphql/.gql files |
198
236
  | **Database** | Prisma and Drizzle models with fields and relations |
199
237
  | **Environment** | Required/optional env vars from .env.example |
200
238
  | **Patterns** | react-hook-form, Zod, Zustand, tRPC, testing libs |
201
239
  | **Utilities** | cn(), mode/design-system detection |
202
240
  | **Framework** | Next.js, Remix, Vite with version and router type |
241
+ | **Complexity** | Cognitive complexity analysis for AI model recommendations |
203
242
  | **Statistics** | Total files, lines, size, largest files |
204
243
  | **Existing docs** | CLAUDE.md, .ai/ folder, .cursorrules |
205
244
  | **File Tree** | Project structure visualization |
@@ -221,11 +260,13 @@ The generated AGENTS.md includes:
221
260
  - **Unused Components** - Potentially dead code warnings
222
261
  - **Preferred Imports** - Barrel imports for cleaner code
223
262
  - **Custom Hooks** - With client-only markers
224
- - **API Routes** - Grouped by path with methods and auth
263
+ - **API Routes** - Grouped by path with methods, auth, and request/response schemas
264
+ - **GraphQL Schemas** - Type definitions from .graphql/.gql files
225
265
  - **Database Models** - Fields and relations
226
266
  - **Environment Variables** - Required vs optional
227
267
  - **Code Patterns** - Detected patterns with examples
228
268
  - **Design Tokens** - Color tokens with usage guidance
269
+ - **AI Recommendations** - Model effort levels based on codebase complexity
229
270
  - **Commands** - npm scripts
230
271
  - **Security** - Vulnerabilities and outdated packages (with --security)
231
272