@safetnsr/vet 0.2.0 → 0.2.1

package/dist/checks/models.d.ts

@@ -1,2 +1,2 @@
 import type { CheckResult } from '../types.js';
-export declare function checkModels(cwd: string, ignore: string[]): CheckResult;
+export declare function checkModels(cwd: string, ignore: string[]): Promise<CheckResult>;

package/dist/checks/models.js

@@ -1,8 +1,44 @@
 import { join } from 'node:path';
 import { readFile, walkFiles } from '../util.js';
-// Model sunset/deprecation registry — kept inline for zero deps
+// Try to use @safetnsr/model-graveyard if installed (248 models, alias matching, YAML registry)
+async function tryModelGraveyard(cwd) {
+    try {
+        const mod = await import(/* webpackIgnore: true */ '@safetnsr/model-graveyard');
+        if (typeof mod.scan !== 'function')
+            return null;
+        const report = await mod.scan(cwd);
+        const issues = [];
+        for (const match of report.matches) {
+            if (!match.model)
+                continue;
+            if (match.model.status === 'deprecated' || match.model.status === 'eol') {
+                issues.push({
+                    severity: 'error',
+                    message: `${match.model.status} model "${match.raw}" in ${match.file}:${match.line}${match.model.successor ? ` — use "${match.model.successor}"` : ''}`,
+                    file: match.file,
+                    line: match.line,
+                    fixable: !!match.model.successor,
+                    fixHint: match.model.successor ? `replace "${match.raw}" with "${match.model.successor}"` : undefined,
+                });
+            }
+        }
+        const score = Math.max(0, 10 - issues.length * 2);
+        return {
+            name: 'models',
+            score: Math.min(10, score),
+            maxScore: 10,
+            issues,
+            summary: issues.length === 0
+                ? `${report.filesScanned} files scanned (via model-graveyard) — all current`
+                : `${issues.length} deprecated model${issues.length > 1 ? 's' : ''} (via model-graveyard)`,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// Built-in fallback: inline registry, basic string matching
 const SUNSET_MODELS = {
-    // OpenAI
     'gpt-3.5-turbo': { replacement: 'gpt-4o-mini', sunset: '2025-06' },
     'gpt-4-turbo': { replacement: 'gpt-4o', sunset: '2025-04' },
     'gpt-4-turbo-preview': { replacement: 'gpt-4o', sunset: '2025-04' },
@@ -12,7 +48,6 @@ const SUNSET_MODELS = {
     'text-davinci-003': { replacement: 'gpt-4o-mini', sunset: '2024-01' },
     'code-davinci-002': { replacement: 'gpt-4o', sunset: '2024-01' },
     'text-embedding-ada-002': { replacement: 'text-embedding-3-small', sunset: '2025-04' },
-    // Anthropic
     'claude-instant-1': { replacement: 'claude-sonnet-4-5', sunset: '2024-08' },
     'claude-2': { replacement: 'claude-sonnet-4-5', sunset: '2024-08' },
     'claude-2.0': { replacement: 'claude-sonnet-4-5', sunset: '2024-08' },
@@ -20,43 +55,36 @@ const SUNSET_MODELS = {
     'claude-3-haiku-20240307': { replacement: 'claude-haiku-3-5', sunset: '2025-06' },
     'claude-3-sonnet-20240229': { replacement: 'claude-sonnet-4-5', sunset: '2025-03' },
     'claude-3-opus-20240229': { replacement: 'claude-opus-4-0', sunset: '2025-09' },
-    // Google
     'gemini-pro': { replacement: 'gemini-2.0-flash', sunset: '2025-02' },
     'gemini-1.0-pro': { replacement: 'gemini-2.0-flash', sunset: '2025-02' },
     'gemini-1.5-pro': { replacement: 'gemini-2.5-pro', sunset: '2025-09' },
     'gemini-1.5-flash': { replacement: 'gemini-2.0-flash', sunset: '2025-09' },
     'text-bison': { replacement: 'gemini-2.0-flash', sunset: '2024-04' },
     'chat-bison': { replacement: 'gemini-2.0-flash', sunset: '2024-04' },
-    // Cohere
-    'command': { replacement: 'command-r-plus', sunset: '2025-03' },
     'command-light': { replacement: 'command-r', sunset: '2025-03' },
     'command-nightly': { replacement: 'command-r-plus', sunset: '2025-03' },
 };
 const SCAN_EXTS = ['.ts', '.js', '.tsx', '.jsx', '.py', '.rs', '.go', '.java', '.rb', '.php',
     '.yaml', '.yml', '.json', '.toml', '.env', '.env.example', '.env.local', '.cfg', '.ini', '.conf'];
-// Files that contain model registries should not trigger false positives
 const SELF_IGNORE = ['models.ts', 'models.js', 'model-graveyard', 'model-registry', 'sunset'];
-// Short model names that need context to avoid false positives (e.g. npm "command" field)
 const CONTEXT_REQUIRED = new Set(['command', 'command-light', 'command-nightly']);
 function hasModelContext(content, model) {
-    // Require the model name to appear in a string-like context: quotes, assignment, or near "model"/"engine"
     const escaped = model.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     const contextPatterns = [
-        new RegExp(`['"\`]${escaped}['"\`]`), // quoted
-        new RegExp(`model[_\\s]*[:=].*${escaped}`, 'i'), // model assignment
-        new RegExp(`engine[_\\s]*[:=].*${escaped}`, 'i'), // engine assignment
-        new RegExp(`${escaped}.*(?:api|llm|chat|completion)`, 'i'), // near API terms
+        new RegExp(`['"\`]${escaped}['"\`]`),
+        new RegExp(`model[_\\s]*[:=].*${escaped}`, 'i'),
+        new RegExp(`engine[_\\s]*[:=].*${escaped}`, 'i'),
+        new RegExp(`${escaped}.*(?:api|llm|chat|completion)`, 'i'),
     ];
     return contextPatterns.some(p => p.test(content));
 }
-export function checkModels(cwd, ignore) {
+function builtinModels(cwd, ignore) {
     const issues = [];
     const files = walkFiles(cwd, ignore);
     const found = new Map();
     for (const f of files) {
         if (!SCAN_EXTS.some(ext => f.endsWith(ext)))
             continue;
-        // Skip files that are model registries themselves
         if (SELF_IGNORE.some(s => f.toLowerCase().includes(s)))
             continue;
         const content = readFile(join(cwd, f));
@@ -65,7 +93,6 @@ export function checkModels(cwd, ignore) {
         for (const [model, info] of Object.entries(SUNSET_MODELS)) {
             if (!content.includes(model))
                 continue;
-            // For short/ambiguous names, require contextual evidence
             if (CONTEXT_REQUIRED.has(model) && !hasModelContext(content, model))
                 continue;
             const existing = found.get(model) || [];
@@ -93,3 +120,9 @@ export function checkModels(cwd, ignore) {
         summary: issues.length === 0 ? 'all model references current' : `${issues.length} deprecated model${issues.length > 1 ? 's' : ''} found`,
     };
 }
+export async function checkModels(cwd, ignore) {
+    const rich = await tryModelGraveyard(cwd);
+    if (rich)
+        return rich;
+    return builtinModels(cwd, ignore);
+}

package/dist/checks/ready.d.ts

@@ -1,2 +1,2 @@
 import type { CheckResult } from '../types.js';
-export declare function checkReady(cwd: string, ignore: string[]): CheckResult;
+export declare function checkReady(cwd: string, ignore: string[]): Promise<CheckResult>;

package/dist/checks/ready.js

@@ -1,28 +1,64 @@
 import { join } from 'node:path';
 import { readFile, walkFiles } from '../util.js';
-// Codebase AI-readiness: structure, complexity, documentation
-export function checkReady(cwd, ignore) {
+// Try to use @safetnsr/ai-ready if installed (richer per-file analysis)
+async function tryAiReady(cwd) {
+    try {
+        const mod = await import(/* webpackIgnore: true */ '@safetnsr/ai-ready');
+        if (typeof mod.main !== 'function')
+            return null;
+        const result = mod.main(['--json', cwd]);
+        if (!result || result.exitCode !== 0)
+            return null;
+        const data = JSON.parse(result.output);
+        const issues = [];
+        // Convert ai-ready's per-file results to vet issues
+        if (data.files) {
+            const lowScoreFiles = data.files.filter((f) => f.score < 5);
+            for (const f of lowScoreFiles.slice(0, 5)) {
+                issues.push({
+                    severity: 'warning',
+                    message: `${f.file}: readiness ${f.score}/10 — ${f.reasons?.join(', ') || 'low score'}`,
+                    file: f.file,
+                    fixable: false,
+                });
+            }
+            if (lowScoreFiles.length > 5) {
+                issues.push({ severity: 'info', message: `...and ${lowScoreFiles.length - 5} more low-readiness files`, fixable: false });
+            }
+        }
+        // Map ai-ready score to vet format
+        const score = typeof data.score === 'number' ? data.score : 5;
+        return {
+            name: 'ready',
+            score: Math.round(Math.min(10, score) * 10) / 10,
+            maxScore: 10,
+            issues,
+            summary: `${data.files?.length || 0} files analyzed (via ai-ready) — ${issues.length} issues`,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// Built-in fallback: simpler project-level checks
+function builtinReady(cwd, ignore) {
     const issues = [];
     const files = walkFiles(cwd, ignore);
-    // 1. README exists — critical for AI context
     const hasReadme = files.some(f => /^readme\.(md|txt|rst)$/i.test(f));
     if (!hasReadme) {
         issues.push({ severity: 'error', message: 'no README — AI agents have no project context', fixable: true, fixHint: 'create a README.md' });
     }
-    // 2. Project manifest
     const manifests = ['package.json', 'pyproject.toml', 'Cargo.toml', 'go.mod', 'pom.xml', 'build.gradle', 'Gemfile', 'composer.json'];
     const hasManifest = manifests.some(m => files.includes(m));
     if (!hasManifest) {
         issues.push({ severity: 'error', message: 'no package manifest — agents can\'t resolve dependencies', fixable: false });
     }
-    // 3. Test coverage
     const codeExts = ['.ts', '.js', '.tsx', '.jsx', '.py', '.rs', '.go', '.java', '.rb', '.php', '.cs', '.swift', '.kt'];
     const testFiles = files.filter(f => /\.(test|spec)\.(ts|js|tsx|jsx|py)$/.test(f) || f.includes('__tests__/') || f.startsWith('tests/') || f.startsWith('test/'));
     const codeFiles = files.filter(f => codeExts.some(ext => f.endsWith(ext)));
     if (codeFiles.length > 5 && testFiles.length === 0) {
         issues.push({ severity: 'error', message: 'no tests — AI agents produce better code when tests exist to validate against', fixable: false });
     }
-    // 4. Overly large files (>500 lines)
     let largeFileCount = 0;
     for (const f of files) {
         if (!codeExts.some(ext => f.endsWith(ext)))
@@ -38,19 +74,16 @@ export function checkReady(cwd, ignore) {
     if (largeFileCount > 3) {
         issues.push({ severity: 'warning', message: `...and ${largeFileCount - 3} more large files`, fixable: false });
     }
-    // 5. .env without .env.example
     const hasEnv = files.some(f => f === '.env' || f === '.env.local');
     const hasEnvExample = files.some(f => f === '.env.example' || f === '.env.template');
     if (hasEnv && !hasEnvExample) {
         issues.push({ severity: 'warning', message: '.env exists but no .env.example — AI agents can\'t see env structure', fixable: false });
     }
-    // 6. No types in JS-heavy project
     const tsFiles = files.filter(f => f.endsWith('.ts') || f.endsWith('.tsx'));
     const jsFiles = files.filter(f => f.endsWith('.js') || f.endsWith('.jsx'));
     if (jsFiles.length > 10 && tsFiles.length === 0 && files.includes('package.json')) {
         issues.push({ severity: 'info', message: `${jsFiles.length} JS files, no TypeScript — typed code gives agents better context`, fixable: false });
     }
-    // Recalibrated scoring: errors = -3, warnings = -1.5, info = -0.3
     const errors = issues.filter(i => i.severity === 'error').length;
     const warnings = issues.filter(i => i.severity === 'warning').length;
     const infos = issues.filter(i => i.severity === 'info').length;
@@ -63,3 +96,9 @@ export function checkReady(cwd, ignore) {
         summary: issues.length === 0 ? 'codebase is well-structured for AI' : `${issues.length} readiness issues`,
     };
 }
+export async function checkReady(cwd, ignore) {
+    const rich = await tryAiReady(cwd);
+    if (rich)
+        return rich;
+    return builtinReady(cwd, ignore);
+}

package/dist/cli.js

@@ -103,16 +103,17 @@ if (isFix) {
     console.log(`\n  ${totalFixed > 0 ? c.green : c.dim}fixed ${totalFixed} issue${totalFixed !== 1 ? 's' : ''}${c.reset}\n`);
     process.exit(0);
 }
-function runChecks() {
+async function runChecks() {
     const allChecks = ['ready', 'diff', 'models', 'links', 'config', 'history'];
     const enabledChecks = config.checks || allChecks;
     const results = [];
+    // ready and models are async (try rich subpackages first, fallback to built-in)
     if (enabledChecks.includes('ready'))
-        results.push(checkReady(cwd, ignore));
+        results.push(await checkReady(cwd, ignore));
     if (enabledChecks.includes('diff'))
         results.push(checkDiff(cwd, { since }));
     if (enabledChecks.includes('models'))
-        results.push(checkModels(cwd, ignore));
+        results.push(await checkModels(cwd, ignore));
     if (enabledChecks.includes('links'))
         results.push(checkLinks(cwd, ignore));
     if (enabledChecks.includes('config'))
@@ -124,7 +125,7 @@ function runChecks() {
 // --watch mode
 if (isWatch) {
     console.clear();
-    let result = runChecks();
+    let result = await runChecks();
     console.log(reportPretty(result));
     console.log(`  ${c.dim}watching for changes... (ctrl+c to stop)${c.reset}\n`);
     let debounce = null;
@@ -137,9 +138,9 @@ if (isWatch) {
                 return;
             if (debounce)
                 clearTimeout(debounce);
-            debounce = setTimeout(() => {
+            debounce = setTimeout(async () => {
                 console.clear();
-                result = runChecks();
+                result = await runChecks();
                 console.log(reportPretty(result));
                 console.log(`  ${c.dim}watching for changes... (ctrl+c to stop)${c.reset}\n`);
             }, 500);
@@ -156,7 +157,7 @@ if (isWatch) {
 }
 else {
     // Normal run
-    const result = runChecks();
+    const result = await runChecks();
     if (isJSON) {
         console.log(reportJSON(result));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@safetnsr/vet",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "vet your AI-generated code — one command, six checks, zero config",
   "type": "module",
   "bin": {
@@ -38,5 +38,8 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@safetnsr/model-graveyard": "^0.2.0"
   }
 }