claudex-setup 1.2.0 → 1.4.0

package/bin/cli.js

@@ -49,6 +49,12 @@ async function main() {
     dir: process.cwd()
   };
 
+  if (!require('fs').existsSync(options.dir)) {
+    console.error(`\n  Error: Directory not found: ${options.dir}`);
+    console.error('  Run claudex-setup from inside your project directory.\n');
+    process.exit(1);
+  }
+
   try {
     if (command === 'badge') {
       const { getBadgeMarkdown } = require('../src/badge');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudex-setup",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Audit and optimize any project for Claude Code. Powered by 1107 verified techniques.",
   "main": "src/index.js",
   "bin": {

package/src/audit.js

@@ -97,7 +97,18 @@ async function audit(options) {
   }
 
   if (options.json) {
-    console.log(JSON.stringify({ score, stacks, passed: passed.length, failed: failed.length, results }, null, 2));
+    const { version } = require('../package.json');
+    console.log(JSON.stringify({
+      version,
+      timestamp: new Date().toISOString(),
+      score,
+      stacks,
+      passed: passed.length,
+      failed: failed.length,
+      skipped: skipped.length,
+      checkCount: applicable.length,
+      results
+    }, null, 2));
     return { score, passed: passed.length, failed: failed.length, stacks, results };
   }
 

package/src/setup.js

@@ -29,8 +29,7 @@ function detectScripts(ctx) {
 // Helper: detect key dependencies and generate guidelines
 // ============================================================
 function detectDependencies(ctx) {
-  const pkg = ctx.jsonFile('package.json');
-  if (!pkg) return [];
+  const pkg = ctx.jsonFile('package.json') || {};
   const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
   const guidelines = [];
 
@@ -96,10 +95,47 @@ function detectDependencies(ctx) {
     guidelines.push('- Use Playwright for E2E tests. Keep tests in tests/ or e2e/');
   }
 
+  // tRPC
+  if (allDeps['@trpc/server'] || allDeps['@trpc/client']) {
+    guidelines.push('- Use tRPC for type-safe API calls. Define routers in server, use client hooks in components');
+  }
+
+  // Stripe
+  if (allDeps['stripe']) {
+    guidelines.push('- Use Stripe SDK for payments. Always verify webhooks with stripe.webhooks.constructEvent()');
+  }
+
+  // Resend
+  if (allDeps['resend']) {
+    guidelines.push('- Use Resend for transactional email. Define templates as React components');
+  }
+
+  // Express security
+  if (allDeps['helmet']) {
+    guidelines.push('- Helmet is configured — ensure all middleware is applied before routes');
+  }
+  if (allDeps['jsonwebtoken']) {
+    guidelines.push('- Use JWT for authentication. Always verify tokens with the correct secret/algorithm');
+  }
+  if (allDeps['bcrypt']) {
+    guidelines.push('- Use bcrypt for password hashing. Never store plaintext passwords');
+  }
+  if (allDeps['cors']) {
+    guidelines.push('- CORS is configured — restrict origins to known domains in production');
+  }
+
+  // Monorepo
+  if (allDeps['turbo'] || allDeps['turborepo']) {
+    guidelines.push('- Turborepo monorepo — use `turbo run` for all tasks. Respect package boundaries');
+  }
+  if (allDeps['nx']) {
+    guidelines.push('- Nx monorepo — use `nx affected` for incremental builds and tests');
+  }
+
   // Python
   const reqTxt = ctx.fileContent('requirements.txt') || '';
   if (reqTxt.includes('sqlalchemy')) {
-    guidelines.push('- Use SQLAlchemy for all database operations');
+    guidelines.push('- Use SQLAlchemy for database operations. Define models in models/');
   }
   if (reqTxt.includes('pydantic')) {
     guidelines.push('- Use Pydantic for data validation and serialization');
@@ -107,6 +143,59 @@ function detectDependencies(ctx) {
   if (reqTxt.includes('pytest')) {
     guidelines.push('- Use pytest for testing. Run with `python -m pytest`');
   }
+  if (reqTxt.includes('alembic')) {
+    guidelines.push('- Use Alembic for database migrations. Run `alembic upgrade head` after model changes');
+  }
+  if (reqTxt.includes('celery')) {
+    guidelines.push('- Use Celery for background tasks. Define tasks in tasks/ or services/');
+  }
+  if (reqTxt.includes('redis')) {
+    guidelines.push('- Redis is available for caching and task queues');
+  }
+  if (reqTxt.includes('langchain')) {
+    guidelines.push('- Use LangChain for chain/agent orchestration. Define chains in chains/ directory');
+  }
+  if (reqTxt.includes('openai')) {
+    guidelines.push('- OpenAI SDK available. Use structured outputs where possible');
+  }
+  if (reqTxt.includes('anthropic')) {
+    guidelines.push('- Anthropic SDK available. Prefer Claude for complex reasoning tasks');
+  }
+  if (reqTxt.includes('chromadb')) {
+    guidelines.push('- Use ChromaDB for local vector storage. Persist collections to disk');
+  }
+  if (reqTxt.includes('pinecone')) {
+    guidelines.push('- Use Pinecone for production vector search. Define index schemas upfront');
+  }
+  if (reqTxt.includes('mlflow')) {
+    guidelines.push('- Use MLflow for experiment tracking. Log all model parameters and metrics');
+  }
+  if (reqTxt.includes('wandb')) {
+    guidelines.push('- Use Weights & Biases for experiment tracking and visualization');
+  }
+  if (reqTxt.includes('transformers')) {
+    guidelines.push('- HuggingFace Transformers available. Use AutoModel/AutoTokenizer for loading');
+  }
+
+  // JS AI/ML/Cloud deps
+  if (allDeps['@anthropic-ai/sdk']) {
+    guidelines.push('- Anthropic SDK configured. Use Messages API with structured tool_use for agents');
+  }
+  if (allDeps['openai']) {
+    guidelines.push('- OpenAI SDK available. Use structured outputs and function calling');
+  }
+  if (allDeps['@modelcontextprotocol/sdk']) {
+    guidelines.push('- MCP SDK available. Build MCP servers with stdio transport');
+  }
+  if (allDeps['langchain'] || allDeps['@langchain/core']) {
+    guidelines.push('- LangChain available. Use LCEL for chain composition');
+  }
+  if (allDeps['@aws-sdk/client-s3'] || allDeps['@aws-sdk/client-dynamodb']) {
+    guidelines.push('- AWS SDK v3 configured. Use modular imports, not aws-sdk v2');
+  }
+  if (allDeps['@aws-cdk/aws-lambda'] || allDeps['aws-cdk-lib']) {
+    guidelines.push('- AWS CDK available. Define stacks in lib/, constructs as separate classes');
+  }
 
   return guidelines;
 }
@@ -342,18 +431,29 @@ function getFrameworkInstructions(stacks) {
 
   if (stackKeys.includes('rust')) {
     sections.push(`### Rust
-- Prefer Result<T, E> over unwrap/expect in library code
-- Use clippy warnings as errors
-- Derive common traits (Debug, Clone, PartialEq) where appropriate
-- Use modules to organize code; keep lib.rs/main.rs thin`);
+- Use Result<T, E> for error handling, avoid unwrap() in production code
+- Prefer &str over String for function parameters
+- Use clippy: \`cargo clippy -- -D warnings\`
+- Structure: src/lib.rs for library, src/main.rs for binary`);
   }
 
   if (stackKeys.includes('go')) {
     sections.push(`### Go
-- Follow standard project layout conventions
-- Handle all errors explicitly; no blank _ for errors
-- Use interfaces for testability and abstraction
-- Keep packages focused; avoid circular dependencies`);
+- Follow standard Go project layout (cmd/, internal/, pkg/)
+- Use interfaces for dependency injection and testability
+- Handle all errors explicitly — never ignore err returns
+- Use context.Context for cancellation and timeouts
+- Prefer table-driven tests
+- Run \`go vet\` and \`golangci-lint\` before committing`);
+  }
+
+  if (stackKeys.includes('terraform')) {
+    sections.push(`### Terraform
+- Use modules for reusable infrastructure components
+- Always run \`terraform plan\` before \`terraform apply\`
+- Store state remotely (S3 + DynamoDB, or Terraform Cloud)
+- Use variables.tf for all configurable values
+- Tag all resources consistently`);
   }
 
   const hasJS = stackKeys.some(k => ['react', 'vue', 'angular', 'nextjs', 'node', 'svelte'].includes(k));
@@ -507,6 +607,12 @@ Before completing any task, confirm:
 ${verificationSteps.join('\n')}
 </verification>
 
+## Context Management
+- Use /compact when context gets large (above 50% capacity)
+- Prefer focused sessions — one task per conversation
+- If a session gets too long, start fresh with /clear
+- Use subagents for research tasks to keep main context clean
+
 ## Workflow
 - Verify changes with tests before committing
 - Use descriptive commit messages (why, not what)
@@ -726,8 +832,10 @@ Fix the GitHub issue: $ARGUMENTS
     const rules = {};
     const hasTS = stacks.some(s => s.key === 'typescript');
     const hasPython = stacks.some(s => s.key === 'python');
+    const hasFrontend = stacks.some(s => ['react', 'vue', 'angular', 'svelte', 'nextjs'].includes(s.key));
+    const hasBackend = stacks.some(s => ['go', 'python', 'django', 'fastapi', 'rust', 'java'].includes(s.key));
 
-    if (hasTS || stacks.some(s => ['react', 'vue', 'angular', 'nextjs', 'node'].includes(s.key))) {
+    if (hasFrontend || (hasTS && !hasBackend)) {
       rules['frontend.md'] = `When editing JavaScript/TypeScript files (*.ts, *.tsx, *.js, *.jsx, *.vue):
 - Use functional components with hooks (React/Vue 3)
 - Add TypeScript interfaces for all props and function params
@@ -735,6 +843,16 @@ Fix the GitHub issue: $ARGUMENTS
 - Use named exports over default exports
 - Handle errors explicitly — no empty catch blocks
 - Keep component files under 200 lines; extract sub-components
+`;
+    }
+    if (hasBackend) {
+      rules['backend.md'] = `When editing backend code:
+- Handle all errors explicitly — never swallow exceptions silently
+- Validate all external input at API boundaries
+- Use dependency injection for testability
+- Keep route handlers thin — delegate to service/business logic layers
+- Log errors with sufficient context for debugging
+- Never hardcode secrets or credentials
 `;
     }
     if (hasPython) {

package/src/techniques.js

@@ -953,6 +953,8 @@ const STACKS = {
   java: { files: ['pom.xml'], content: {}, label: 'Java' },
   kotlin: { files: ['build.gradle.kts'], content: {}, label: 'Kotlin' },
   swift: { files: ['Package.swift'], content: {}, label: 'Swift' },
+  terraform: { files: ['main.tf', 'terraform'], content: {}, label: 'Terraform' },
+  kubernetes: { files: ['k8s', 'kubernetes', 'helm'], content: {}, label: 'Kubernetes' },
 };
 
 module.exports = { TECHNIQUES, STACKS };