skills-atlas-cli 0.8.8 → 0.8.9

package/bin/skills.js

@@ -73,6 +73,9 @@ async function main() {
     process.exitCode = 1;
     return;
   }
+  // Opportunistic, non-blocking background catalog refresh so new skills appear over
+  // time without a manual `update`. Skipped for `update` itself; fully fail-silent.
+  if (sub !== 'update') { try { require('../src/data').maybeBackgroundRefresh(); } catch { /* ignore */ } }
   await cmd(rest);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills-atlas-cli",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "Search, install and learn AI agent skills from the terminal — powered by the Skills Atlas catalog.",
   "bin": {
     "skills-atlas": "bin/skills.js",

package/src/commands/update.js

@@ -6,7 +6,10 @@ const { refreshData, refreshSources } = require('../data');
 module.exports = async function update(argv) {
   const { values } = parse(argv, ['json']);
   if (values.help) {
-    console.log('usage: skills-atlas update\n\nRefresh the local catalog cache from the public data feed.');
+    console.log('usage: skills-atlas update\n\n' +
+      'Refresh the local catalog cache from the public data feed.\n' +
+      'The catalog also auto-refreshes in the background (~daily) so new skills appear\n' +
+      'on their own; set SKILLS_ATLAS_NO_REFRESH=1 (or SKILLS_ATLAS_OFFLINE=1) to disable.');
     return;
   }
 

package/src/data.js

@@ -93,6 +93,37 @@ function maybeStaleNudge(fromCache) {
   process.stderr.write("tip: run 'skills-atlas update' to refresh the catalog\n");
 }
 
+const REFRESH_AFTER_MS = 24 * 3600000; // auto-refresh once the cache is a day old
+const refreshStampFile = () => path.join(cacheDir(), 'autorefresh.json');
+
+// Pure decision: should we kick off a background refresh now? (cache stale/absent,
+// not throttled, not opted out). Injectable for tests.
+function shouldAutoRefresh({ meta, stamp, env, now }) {
+  if (env.SKILLS_ATLAS_NO_REFRESH || env.SKILLS_ATLAS_OFFLINE || env.SKILLS_ATLAS_BG_REFRESH) return false;
+  const t = meta && meta.fetchedAt ? Date.parse(meta.fetchedAt) : NaN;
+  const ageMs = Number.isFinite(t) ? now - t : Infinity;       // absent/bad meta → treat as stale
+  if (ageMs < REFRESH_AFTER_MS) return false;
+  const st = stamp && stamp.at ? Date.parse(stamp.at) : NaN;
+  if (Number.isFinite(st) && (now - st) < REFRESH_AFTER_MS) return false; // already tried today
+  return true;
+}
+
+// Fire-and-forget: if the catalog is old (or absent) and we haven't tried today,
+// spawn a DETACHED background `update` so new skills appear next time. Never blocks,
+// never errors out. Opt out with SKILLS_ATLAS_NO_REFRESH / SKILLS_ATLAS_OFFLINE.
+function maybeBackgroundRefresh() {
+  try {
+    if (!shouldAutoRefresh({ meta: tryReadJSON(metaFile()), stamp: tryReadJSON(refreshStampFile()), env: process.env, now: Date.now() })) return;
+    ensureDir(cacheDir());
+    fs.writeFileSync(refreshStampFile(), JSON.stringify({ at: new Date().toISOString() })); // stamp first → no double-spawn
+    const { spawn } = require('child_process');
+    const child = spawn(process.execPath, [path.join(__dirname, '..', 'bin', 'skills.js'), 'update'], {
+      detached: true, stdio: 'ignore', env: { ...process.env, SKILLS_ATLAS_BG_REFRESH: '1' },
+    });
+    child.unref();
+  } catch { /* fully fail-silent — never affect the foreground command */ }
+}
+
 function loadData({ quiet = false } = {}) {
   const cached = tryReadJSON(cacheFile());
   let base, info;
@@ -205,4 +236,4 @@ async function refreshSources() {
   return out;
 }
 
-module.exports = { loadData, refreshData, fetchSource, refreshSources, counts, isValid, cacheDir, PUBLIC_URL };
+module.exports = { loadData, refreshData, fetchSource, refreshSources, counts, isValid, shouldAutoRefresh, maybeBackgroundRefresh, cacheDir, PUBLIC_URL };