feat: add ade skills sales command for inventory monitoring

Ported from fairdrop MCP's check_sales tool. Shows available copies,
total sales, and low-stock alerts for a seller's active skill listings.

Usage: ade skills sales <seller_address>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: plur9

src/commands.ts

@@ -257,6 +257,50 @@ export async function skillsShow(id: string) {
   return apiFetch(`/skills/${encodeURIComponent(id)}`)
 }
 
+export async function skillsSales(sellerAddress: string) {
+  if (!isAddress(sellerAddress)) {
+    throw new CLIError('ERR_INVALID_ARGUMENT', 'Invalid seller address', 'Provide a valid Ethereum address (0x...)')
+  }
+
+  const data = await apiFetch<{ items: Array<{ id: string; title: string; total_sales: number; escrow_id: number | null }> }>(
+    `/skills?seller=${encodeURIComponent(sellerAddress)}&status=active&limit=50`
+  )
+
+  const skills = data.items ?? []
+  const results = await Promise.all(skills.map(async (skill) => {
+    try {
+      const info = await apiFetch<{ status: string; available_copies?: number; total_sales?: number }>(
+        `/skills/${encodeURIComponent(skill.id)}/purchase-info`
+      )
+      return {
+        skill_id: skill.id,
+        title: skill.title,
+        status: info.status,
+        available: info.available_copies ?? 0,
+        total_sales: info.total_sales ?? skill.total_sales,
+        needs_restock: (info.available_copies ?? 0) <= 1,
+      }
+    } catch {
+      return {
+        skill_id: skill.id,
+        title: skill.title,
+        status: 'unknown',
+        available: 0,
+        total_sales: skill.total_sales,
+        needs_restock: true,
+      }
+    }
+  }))
+
+  const lowStock = results.filter(r => r.needs_restock)
+  return {
+    skills: results,
+    total_skills: results.length,
+    low_stock: lowStock.length,
+    alerts: lowStock.map(s => `"${s.title}" has ${s.available} copies left.`),
+  }
+}
+
 export async function bountiesList(opts: ListOpts & { status?: string }) {
   let q = listParams(opts)
   if (opts.status) q += `&status=${encodeURIComponent(opts.status)}`

src/help.ts

@@ -6,7 +6,7 @@ const RESOURCES = ['skills', 'bounties', 'agents', 'escrows', 'wallets', 'config
 type Resource = typeof RESOURCES[number]
 
 const ACTIONS: Record<Resource, string[]> = {
-  skills: ['list', 'show', 'vote', 'comment', 'create'],
+  skills: ['list', 'show', 'vote', 'comment', 'create', 'sales'],
   bounties: ['list', 'show', 'create'],
   agents: ['list', 'show'],
   escrows: ['list', 'show', 'create', 'fund', 'commit-key', 'reveal-key', 'claim', 'status'],
@@ -619,6 +619,21 @@ Authentication:
 Examples:
   ade skills create --title "Data Analysis" --price 0.1`
 
+    case 'skills sales':
+      return `ade skills sales - Check sales status and inventory
+
+Usage:
+  ade skills sales <seller_address>
+
+Arguments:
+  seller_address  Ethereum address of the seller (0x...)
+
+Shows available copies, total sales, and low-stock alerts for all
+active skills listed by the given seller address.
+
+Examples:
+  ade skills sales 0x1234...abcd`
+
     case 'bounties list':
       return `ade bounties list - List bounties
 

src/index.ts

@@ -174,6 +174,13 @@ async function handleResource(
             category: flags.category as string,
           });
           break;
+        case "sales":
+          if (!cmdArgs[0]) {
+            console.error("Usage: ade skills sales <seller_address>");
+            process.exit(1);
+          }
+          result = await commands.skillsSales(cmdArgs[0]);
+          break;
         default:
           console.error(`Unknown action: skills ${action}`);
           process.exit(1);