@lawrenceliang-btc/atel-sdk 1.1.34 → 1.1.35

package/bin/atel.mjs

@@ -2067,35 +2067,64 @@ async function cmdInit(agentId) {
 
   // Auto-install SKILL.md to OpenClaw skills directory
   try {
-    const sdkSkillPath = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'skill', 'atel-agent', 'SKILL.md');
-    if (existsSync(sdkSkillPath)) {
-      const home = process.env.HOME || '';
-      const candidates = [
-        join(home, '.openclaw', 'skills', 'atel-agent'),
-        join(home, '.openclaw', 'workspace', 'skills', 'atel-agent'),
-      ];
-      let installed = false;
-      for (const dir of candidates) {
-        if (existsSync(dirname(dir))) {
-          mkdirSync(dir, { recursive: true });
-          copyFileSync(sdkSkillPath, join(dir, 'SKILL.md'));
-          console.log(`\n✅ ATEL Skill auto-installed to ${dir}`);
-          console.log('   Your AI agent will automatically know how to use ATEL.');
-          console.log('');
-          console.log('📌 Tell your agent this message to get started:');
-          console.log('   "Read the atel-agent skill at ~/.openclaw/skills/atel-agent/SKILL.md carefully, then help me set up ATEL and start earning."');
-          installed = true;
-          break;
-        }
-      }
-      if (!installed) {
-        console.log('\n📋 To teach your AI agent about ATEL, send it this message:');
-        console.log(`   "Read ${sdkSkillPath} carefully, then help me set up ATEL and start earning."`);
-      }
+    const installed = syncAtelSkillToOpenClaw({ verbose: true });
+    if (!installed.length) {
+      const sdkSkillPath = resolveSdkSkillPath();
+      console.log('\n📋 To teach your AI agent about ATEL, send it this message:');
+      console.log(`   "Read ${sdkSkillPath} carefully, then help me set up ATEL and start earning."`);
     }
   } catch (e) { /* skill install is best-effort */ }
 }
 
+// Path to the SKILL.md shipped inside the currently-installed SDK package.
+// Used both at `atel init` time and on every `atel start` to keep openclaw's
+// workspace copy in sync with the latest published skill content.
+function resolveSdkSkillPath() {
+  return resolve(dirname(fileURLToPath(import.meta.url)), '..', 'skill', 'atel-agent', 'SKILL.md');
+}
+
+// Sync the SDK's SKILL.md into every openclaw skills dir that already hosts
+// an atel-agent skill. Written to fix a subtle version-drift bug: `npm i -g`
+// upgrades the SDK package on disk, but openclaw's session `skillsSnapshot`
+// reads from `~/.openclaw/workspace/skills/atel-agent/SKILL.md`, which is a
+// physical copy made at init time and never refreshed. After an upgrade the
+// agent keeps seeing stale skill content indefinitely. See incident
+// 2026-04-09, order ord-4c12a03d-ea8, where the workspace copy was ~12 days
+// older than the npm copy and missing the "--desc required" guidance.
+//
+// We intentionally sync to *every* candidate dir where an `atel-agent` sibling
+// is present (not just the first one), because different openclaw versions
+// read from different roots and we want all of them to end up coherent.
+// Returns the list of destinations actually written.
+function syncAtelSkillToOpenClaw({ verbose = false } = {}) {
+  const sdkSkillPath = resolveSdkSkillPath();
+  if (!existsSync(sdkSkillPath)) return [];
+  const home = process.env.HOME || '';
+  // Candidate parent dirs, in the order we want to probe. We sync to any
+  // that exist, creating the leaf `atel-agent/` dir if its parent is present.
+  const parents = [
+    join(home, '.openclaw', 'workspace', 'skills'),
+    join(home, '.openclaw', 'skills'),
+  ];
+  const written = [];
+  for (const parent of parents) {
+    if (!existsSync(parent)) continue;
+    const dir = join(parent, 'atel-agent');
+    try {
+      mkdirSync(dir, { recursive: true });
+      const dest = join(dir, 'SKILL.md');
+      copyFileSync(sdkSkillPath, dest);
+      written.push(dest);
+      if (verbose) {
+        console.log(`✅ ATEL skill synced → ${dest}`);
+      }
+    } catch (e) {
+      if (verbose) console.error(`   (skipped ${dir}: ${e.message})`);
+    }
+  }
+  return written;
+}
+
 async function cmdAnchor(subcommand) {
   if (subcommand === 'config') {
     await configureAnchor();
@@ -2439,6 +2468,21 @@ async function cmdStart(port) {
     log({ event: 'openclaw_lock_cleanup_error', error: e.message });
   }
 
+  // Refresh workspace SKILL.md from the currently-installed SDK package.
+  // Without this, `npm i -g` upgrades leave a stale copy at
+  // ~/.openclaw/workspace/skills/atel-agent/SKILL.md that openclaw keeps
+  // reading — the documented behaviour of the upgrade then silently lags
+  // behind the code. Fixes incident 2026-04-09 where a ~12-day-old workspace
+  // skill copy was missing "--desc is required" guidance.
+  try {
+    const synced = syncAtelSkillToOpenClaw();
+    if (synced.length > 0) {
+      log({ event: 'atel_skill_synced', count: synced.length, destinations: synced });
+    }
+  } catch (e) {
+    log({ event: 'atel_skill_sync_error', error: e.message });
+  }
+
   // Initialize Ollama only if explicitly enabled (optional local AI audit)
   if (process.env.ATEL_OLLAMA_ENABLED === 'true') {
     await initializeOllama().catch(err => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawrenceliang-btc/atel-sdk",
-  "version": "1.1.34",
+  "version": "1.1.35",
   "description": "ATEL Protocol SDK - Agent Trust & Exchange Layer",
   "repository": {
     "type": "git",