@afromero/kin3o 0.2.4 → 0.2.5

package/README.md

@@ -9,6 +9,8 @@
 [![CI](https://github.com/affromero/kin3o/actions/workflows/ci.yml/badge.svg)](https://github.com/affromero/kin3o/actions/workflows/ci.yml)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Socket](https://img.shields.io/badge/Socket-protected-blueviolet?logo=socket.dev)](https://socket.dev)
+[![min-release-age](https://img.shields.io/badge/min--release--age-7%20days-brightgreen)](https://docs.npmjs.com/cli/v10/using-npm/config#min-release-age)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/affromero/kin3o/pulls)
 
 AI-powered Lottie animation generator. Turns natural language prompts into valid, playable Lottie JSON and interactive dotLottie state machines using your existing Claude or Codex subscription.

package/dist/index.js

@@ -2,7 +2,7 @@
 import { existsSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { Command } from 'commander';
-import { PROVIDERS, detectAvailableProviders, getDefaultProvider } from './providers/registry.js';
+import { PROVIDERS, detectAvailableProviders, getDefaultProvider, diagnoseProvider } from './providers/registry.js';
 import { buildSystemPrompt, buildInteractiveSystemPrompt, buildRefinementUserPrompt, buildInteractiveRefinementUserPrompt, loadDesignTokens } from './prompts/index.js';
 import { validateLottie, autoFix } from './validator.js';
 import { validateStateMachine } from './state-machine-validator.js';
@@ -37,7 +37,7 @@ program
     if (!providerKey) {
         providerKey = await getDefaultProvider() ?? undefined;
         if (!providerKey) {
-            console.error('  ✗ No AI providers available. Install Claude Code, Codex, or set ANTHROPIC_API_KEY.');
+            console.error('  ✗ No AI providers available. Run `kin3o providers` for diagnostics.');
             process.exit(1);
         }
     }
@@ -204,7 +204,7 @@ program
     if (!providerKey) {
         providerKey = await getDefaultProvider() ?? undefined;
         if (!providerKey) {
-            console.error('  ✗ No AI providers available. Install Claude Code, Codex, or set ANTHROPIC_API_KEY.');
+            console.error('  ✗ No AI providers available. Run `kin3o providers` for diagnostics.');
             process.exit(1);
         }
     }
@@ -371,9 +371,22 @@ program
     const available = await detectAvailableProviders();
     console.log('\nAvailable AI Providers:\n');
     for (const [key, config] of Object.entries(PROVIDERS)) {
-        const status = available.includes(key) ? '✓' : '✗';
+        const isAvail = available.includes(key);
+        const status = isAvail ? '✓' : '✗';
         console.log(`  ${status} ${config.displayName} (${key})`);
         console.log(`    Models: ${config.models.join(', ')}`);
+        if (!isAvail) {
+            const diag = diagnoseProvider(key);
+            if (!diag.binaryFound) {
+                console.log(`    Problem: "${diag.binaryName}" not found on PATH`);
+                console.log(`    Fix: Install ${config.displayName} and ensure "${diag.binaryName}" is on your PATH`);
+            }
+            else if (!diag.authFound) {
+                const cmd = key === 'codex' ? 'codex auth' : 'claude';
+                console.log(`    Problem: CLI found but not authenticated`);
+                console.log(`    Fix: Run \`${cmd}\` to log in`);
+            }
+        }
     }
     console.log('');
 });

package/dist/providers/registry.d.ts

@@ -13,7 +13,15 @@ export interface ProviderConfig {
 }
 /** Get timeout with optional user override */
 export declare function getTimeoutMs(userOverride?: number): number;
+export interface ProviderDiagnosis {
+    binaryFound: boolean;
+    authFound: boolean;
+    binaryName: string;
+    authPaths: string[];
+}
 export declare const PROVIDERS: Record<string, ProviderConfig>;
+/** Diagnose why a provider is or isn't available */
+export declare function diagnoseProvider(key: string): ProviderDiagnosis;
 /** Detect which providers are available (binary + auth) */
 export declare function detectAvailableProviders(): Promise<string[]>;
 /** Get default provider (first available in priority order) */

package/dist/providers/registry.js

@@ -29,7 +29,8 @@ export const PROVIDERS = {
             if (!hasBinary('claude'))
                 return false;
             return existsSync(join(home, '.claude.json'))
-                || existsSync(join(home, '.claude', 'credentials.json'));
+                || existsSync(join(home, '.claude', 'credentials.json'))
+                || existsSync(join(home, '.claude', '.credentials.json'));
         },
         generate: generateWithClaude,
     },
@@ -45,6 +46,31 @@ export const PROVIDERS = {
         generate: generateWithCodex,
     },
 };
+const PROVIDER_BINARIES = {
+    'claude-code': 'claude',
+    codex: 'codex',
+};
+const PROVIDER_AUTH_PATHS = {
+    'claude-code': [
+        join(home, '.claude.json'),
+        join(home, '.claude', 'credentials.json'),
+        join(home, '.claude', '.credentials.json'),
+    ],
+    codex: [
+        join(home, '.codex', 'auth.json'),
+    ],
+};
+/** Diagnose why a provider is or isn't available */
+export function diagnoseProvider(key) {
+    const binaryName = PROVIDER_BINARIES[key] ?? key;
+    const authPaths = PROVIDER_AUTH_PATHS[key] ?? [];
+    return {
+        binaryFound: hasBinary(binaryName),
+        authFound: authPaths.some(p => existsSync(p)),
+        binaryName,
+        authPaths,
+    };
+}
 /** Detect which providers are available (binary + auth) */
 export async function detectAvailableProviders() {
     const available = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afromero/kin3o",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "AI-powered Lottie animation generator — text to motion from your terminal",
   "type": "module",
   "license": "MIT",