antikit 1.10.0 → 1.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antikit",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "description": "CLI tool to manage AI agent skills from Anti Gravity skills repository",
   "type": "module",
   "main": "src/index.js",

package/src/commands/list.js

@@ -47,10 +47,22 @@ export async function listRemoteSkills(options) {
     const infoSpinner = ora('Fetching skill info...').start();
     const skillsWithInfo = await Promise.all(
       skills.map(async skill => {
-        // Pass basePath to fetch correct SKILL.md location
-        const info = await fetchSkillInfo(skill.name, skill.owner, skill.repo, skill.basePath);
-        const description = info ? info.description : null;
-        const remoteVersion = info ? info.version : '0.0.0';
+        let description = skill.description;
+        let remoteVersion = skill.version || '0.0.0';
+
+        // Only fetch info if not already fetched (REST fallback)
+        if (description === undefined || description === null) {
+          // Pass basePath and branch to fetch correct SKILL.md location optimized
+          const info = await fetchSkillInfo(
+            skill.name,
+            skill.owner,
+            skill.repo,
+            skill.basePath,
+            skill.branch
+          );
+          description = info ? info.description : null;
+          remoteVersion = info ? info.version : '0.0.0';
+        }
 
         const installed = skillExists(skill.name);
         let updateAvailable = false;

package/src/utils/github.js

@@ -14,14 +14,119 @@ function getHeaders() {
   return headers;
 }
 
+/**
+ * Fetch skills using GraphQL (Optimized: 1 request per source)
+ */
+async function fetchSkillsViaGraphQL(source, token) {
+  const query = `
+    query ($owner: String!, $repo: String!, $expression: String!) {
+      repository(owner: $owner, name: $repo) {
+        object(expression: $expression) {
+          ... on Tree {
+            entries {
+              name
+              type
+              object {
+                ... on Tree {
+                  file: entries(name: "SKILL.md") {
+                    object {
+                      ... on Blob {
+                        text
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+    `;
+
+  const branch = source.branch || 'main'; // This logic might need verifying branch exists, but usually main/master
+  // Correct expression for path. If path is provided, it's "branch:path", else just "branch:"
+  const expression = source.path ? `${branch}:${source.path}` : `${branch}:`;
+
+  try {
+    const response = await fetch('https://api.github.com/graphql', {
+      method: 'POST',
+      headers: {
+        Authorization: `token ${token}`,
+        'User-Agent': 'antikit-cli'
+      },
+      body: JSON.stringify({
+        query,
+        variables: {
+          owner: source.owner,
+          repo: source.repo,
+          expression
+        }
+      })
+    });
+
+    const { data, errors } = await response.json();
+
+    if (errors || !data || !data.repository || !data.repository.object) {
+      return null; // Fallback to REST
+    }
+
+    const entries = data.repository.object.entries || [];
+
+    return entries
+      .filter(item => item.type === 'tree' && !item.name.startsWith('.'))
+      .map(item => {
+        let description = null;
+        let version = '0.0.0';
+
+        // Attempt to parse SKILL.md content if it exists
+        const skillFile = item.object.file && item.object.file[0];
+        if (skillFile && skillFile.object && skillFile.object.text) {
+          const content = skillFile.object.text;
+          const match = content.match(/^---\n([\s\S]*?)\n---/);
+          if (match) {
+            const frontmatter = match[1];
+            const descMatch = frontmatter.match(/description:\s*(.+)/);
+            const verMatch = frontmatter.match(/version:\s*(.+)/);
+            if (descMatch) description = descMatch[1].trim();
+            if (verMatch) version = verMatch[1].trim();
+          }
+        }
+
+        return {
+          name: item.name,
+          url: `https://github.com/${source.owner}/${source.repo}/tree/${branch}/${source.path ? source.path + '/' : ''}${item.name}`,
+          path: source.path ? `${source.path}/${item.name}` : item.name,
+          source: source.name,
+          owner: source.owner,
+          repo: source.repo,
+          basePath: source.path,
+          description, // Pre-fetched!
+          version // Pre-fetched!
+        };
+      });
+  } catch (e) {
+    return null; // Fallback
+  }
+}
+
 /**
  * Fetch list of skills from a specific source
  */
 async function fetchSkillsFromSource(source) {
+  // Try GraphQL first if token exists (Much faster)
+  const token = getToken() || process.env.ANTIKIT_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
+  if (token) {
+    const gqlResult = await fetchSkillsViaGraphQL(source, token);
+    if (gqlResult) return gqlResult;
+  }
+
+  // Fallback to REST API
   let url = `${GITHUB_API}/repos/${source.owner}/${source.repo}/contents`;
   if (source.path) {
     url += `/${source.path}`;
   }
+  // ... rest of function
 
   const response = await fetch(url, {
     headers: getHeaders()
@@ -61,6 +166,7 @@ async function fetchSkillsFromSource(source) {
       source: source.name,
       owner: source.owner,
       repo: source.repo,
+      branch: source.branch || 'main',
       basePath: source.path // Keep track of base path
     }));
 
@@ -90,7 +196,7 @@ export async function fetchRemoteSkills(sourceName = null) {
 /**
  * Fetch SKILL.md content for a specific skill
  */
-export async function fetchSkillInfo(skillName, owner, repo, path = null) {
+export async function fetchSkillInfo(skillName, owner, repo, path = null, branch = null) {
   // If owner/repo not provided, search in all sources
   if (!owner || !repo) {
     const skills = await fetchRemoteSkills();
@@ -99,24 +205,46 @@ export async function fetchSkillInfo(skillName, owner, repo, path = null) {
     owner = skill.owner;
     repo = skill.repo;
     path = skill.basePath;
+    branch = skill.branch;
   }
 
-  let url = `${GITHUB_API}/repos/${owner}/${repo}/contents`;
-  if (path) {
-    url += `/${path}`;
-  }
-  url += `/${skillName}/SKILL.md`;
+  let content = null;
 
-  const response = await fetch(url, {
-    headers: getHeaders()
-  });
+  // Optimized: Use Raw URL if branch is known (avoids API rate limit)
+  if (branch) {
+    let rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}`;
+    if (path) rawUrl += `/${path}`;
+    rawUrl += `/${skillName}/SKILL.md`;
 
-  if (!response.ok) {
-    return null;
+    try {
+      const res = await fetch(rawUrl);
+      if (res.ok) {
+        content = await res.text();
+      }
+    } catch (e) {
+      // Ignore fetch error, fallback to API
+    }
   }
 
-  const data = await response.json();
-  const content = Buffer.from(data.content, 'base64').toString('utf-8');
+  // Fallback: Use API (Counts against rate limit, but works if branch is wrong/private repo needs Auth)
+  if (!content) {
+    let url = `${GITHUB_API}/repos/${owner}/${repo}/contents`;
+    if (path) {
+      url += `/${path}`;
+    }
+    url += `/${skillName}/SKILL.md`;
+
+    const response = await fetch(url, {
+      headers: getHeaders()
+    });
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const data = await response.json();
+    content = Buffer.from(data.content, 'base64').toString('utf-8');
+  }
 
   // Extract info from YAML frontmatter
   const match = content.match(/^---\n([\s\S]*?)\n---/);