@howlil/ez-agents 3.1.0 → 3.4.2

package/commands/ez/auth.md

@@ -0,0 +1,87 @@
+---
+name: ez:auth
+description: Manage API credentials securely (save, list, delete)
+argument-hint: "<save|list|delete|test> [provider] [secret]"
+agent: ez-helper
+allowed-tools:
+  - Read
+  - Bash
+---
+<objective>
+Manage API credentials securely using system keychain or fallback file storage
+
+**Subcommands:**
+- `ez:auth save <provider> <secret>` — Save credential for provider
+- `ez:auth list` — List all stored providers
+- `ez:auth delete <provider>` — Delete credential for provider
+- `ez:auth test` — Test credential system and show keychain status
+
+**Providers:** anthropic, moonshot, alibaba, qwen, openai
+</objective>
+
+<execution_context>
+@~/.claude/ez-agents/workflows/ez-helper.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/STATE.md
+
+# Credential storage module:
+@ez-agents/bin/lib/auth.cjs
+
+# EZ tools CLI:
+@ez-agents/bin/ez-tools.cjs
+</context>
+
+<process>
+## Subcommand Routing
+
+1. **Parse arguments** — First arg is subcommand (save/list/delete/test), remaining are parameters
+2. **Route to handler** — Call appropriate auth function from ez-tools.cjs
+3. **Output result** — Show success/failure with user-friendly messages
+
+## Handlers
+
+### save <provider> <secret>
+1. Validate provider name against known providers
+2. Call saveCredential(provider, secret)
+3. Output: "✓ Credential saved for {provider}" or error message
+
+### list
+1. Call listProviders()
+2. Check isKeychainAvailable()
+3. Output table:
+   ```
+   Provider       Storage
+   ─────────────────────────
+   anthropic      Keychain ✓
+   qwen           File (fallback)
+   ```
+4. If using file storage, show warning: "⚠ Using file storage — consider installing keytar for better security"
+
+### delete <provider>
+1. Validate provider exists
+2. Confirm deletion (ask user or require --force)
+3. Call deleteCredential(provider)
+4. Output: "✓ Credential deleted for {provider}"
+
+### test
+1. Check isKeychainAvailable()
+2. Output:
+   ```
+   Credential System Test
+   
+   Keychain (keytar): {Available | Unavailable}
+   Storage mode: {System keychain | Fallback file}
+   
+   Stored providers: {count}
+   ```
+3. If keytar unavailable, show install hint: "npm install keytar"
+
+## Error Handling
+
+- **Invalid provider:** "Unknown provider '{name}'. Valid: anthropic, moonshot, alibaba, qwen, openai"
+- **Credential not found:** "No credential found for {provider}. Use 'save' to add one."
+- **Keychain error:** "Failed to access keychain: {error}. Using fallback storage."
+</process>

package/commands/ez/join-discord.md

@@ -1,18 +1,18 @@
----
-name: ez:join-discord
-description: Join the EZ Agents Discord community
----
-
-<objective>
-Display the Discord invite link for the EZ Agents community server.
-</objective>
-
-<output>
-# Join the EZ Agents Discord
-
-Connect with other EZ Agents users, get help, share what you're building, and stay updated.
-
-**Invite link:** https://discord.gg/gsd
-
-Click the link or paste it into your browser to join.
-</output>
+---
+name: ez:join-discord
+description: Join the EZ Agents Discord community
+---
+
+<objective>
+Display the Discord invite link for the EZ Agents community server.
+</objective>
+
+<output>
+# Join the EZ Agents Discord
+
+Connect with other EZ Agents users, get help, share what you're building, and stay updated.
+
+**Invite link:** https://discord.gg/ez-agents
+
+Click the link or paste it into your browser to join.
+</output>

package/ez-agents/bin/ez-tools.cjs

@@ -139,6 +139,8 @@ const milestone = require('./lib/milestone.cjs');
 const commands = require('./lib/commands.cjs');
 const init = require('./lib/init.cjs');
 const frontmatter = require('./lib/frontmatter.cjs');
+const HealthCheck = require('./lib/health-check.cjs');
+const auth = require('./lib/auth.cjs');
 
 // ─── CLI Router ───────────────────────────────────────────────────────────────
 
@@ -172,7 +174,7 @@ async function main() {
   const command = args[0];
 
   if (!command) {
-    error('Usage: ez-tools <command> [args] [--raw] [--cwd <path>]\nCommands: state, resolve-model, find-phase, commit, verify-summary, verify, frontmatter, template, generate-slug, current-timestamp, list-todos, verify-path-exists, config-ensure-section, init');
+    error('Usage: ez-tools <command> [args] [--raw] [--cwd <path>]\nCommands: state, resolve-model, find-phase, commit, verify-summary, verify, frontmatter, template, generate-slug, current-timestamp, list-todos, verify-path-exists, config-ensure-section, init, health');
   }
 
   switch (command) {
@@ -247,6 +249,122 @@ async function main() {
       break;
     }
 
+    case 'health': {
+      const health = new HealthCheck();
+      const result = health.runAll();
+      console.log(JSON.stringify(result, null, 2));
+      break;
+    }
+
+    case 'auth': {
+      const subcommand = args[1];
+      if (!subcommand) {
+        error('Usage: ez-tools auth <save|list|delete|test> [provider] [secret]\nSubcommands: save, list, delete, test');
+      }
+
+      switch (subcommand) {
+        case 'save': {
+          const provider = args[2];
+          const secret = args[3];
+          if (!provider || !secret) {
+            error('Usage: ez-tools auth save <provider> <secret>');
+          }
+          const success = await auth.saveCredential(provider, secret);
+          if (success) {
+            console.log(`✓ Credential saved for ${provider}`);
+          } else {
+            console.error('Failed to save credential');
+            process.exit(1);
+          }
+          break;
+        }
+
+        case 'list': {
+          const providers = await auth.listProviders();
+          const usingKeychain = auth.isKeychainAvailable();
+          
+          console.log('');
+          console.log('Provider       Storage');
+          console.log('─────────────────────────');
+          if (providers.length === 0) {
+            console.log('No credentials stored');
+          } else {
+            for (const p of providers) {
+              const storage = usingKeychain ? 'Keychain ✓' : 'File (fallback)';
+              console.log(`${p.padEnd(14)} ${storage}`);
+            }
+          }
+          if (!usingKeychain) {
+            console.log('');
+            console.log('⚠ Using file storage — consider installing keytar for better security');
+          }
+          break;
+        }
+
+        case 'delete': {
+          const provider = args[2];
+          const force = args.includes('--force');
+          if (!provider) {
+            error('Usage: ez-tools auth delete <provider> [--force]');
+          }
+          
+          if (!force) {
+            const readline = require('readline');
+            const rl = readline.createInterface({
+              input: process.stdin,
+              output: process.stdout
+            });
+            
+            const answer = await new Promise(resolve => {
+              rl.question(`Delete credential for ${provider}? [y/N] `, resolve);
+              rl.close();
+            });
+            
+            if (answer.toLowerCase() !== 'y') {
+              console.log('Delete cancelled');
+              break;
+            }
+          }
+          
+          const success = await auth.deleteCredential(provider);
+          if (success) {
+            console.log(`✓ Credential deleted for ${provider}`);
+          } else {
+            console.error(`No credential found for ${provider}`);
+            process.exit(1);
+          }
+          break;
+        }
+
+        case 'test': {
+          const usingKeychain = auth.isKeychainAvailable();
+          const providers = await auth.listProviders();
+          
+          console.log('');
+          console.log('Credential System Test');
+          console.log('══════════════════════');
+          console.log(`Keychain (keytar): ${usingKeychain ? 'Available ✓' : 'Unavailable'}`);
+          console.log(`Storage mode: ${usingKeychain ? 'System keychain' : 'Fallback file'}`);
+          console.log('');
+          console.log(`Stored providers: ${providers.length}`);
+          if (providers.length > 0) {
+            console.log(`  ${providers.join(', ')}`);
+          }
+          if (!usingKeychain) {
+            console.log('');
+            console.log('Tip: Install keytar for better security:');
+            console.log('  npm install keytar');
+          }
+          break;
+        }
+
+        default: {
+          error('Unknown auth subcommand: ' + subcommand + '\nValid: save, list, delete, test');
+        }
+      }
+      break;
+    }
+
     case 'resolve-model': {
       commands.cmdResolveModel(cwd, args[1], raw);
       break;
@@ -526,7 +644,7 @@ async function main() {
           init.cmdInitPlanPhase(cwd, args[2], raw);
           break;
         case 'new-project':
-          init.cmdInitNewProject(cwd, raw);
+          await init.cmdInitNewProject(cwd, raw);
           break;
         case 'new-milestone':
           init.cmdInitNewMilestone(cwd, raw);