@lawrenceliang-btc/atel-sdk 0.9.10 → 0.9.12

package/bin/atel.mjs

@@ -2324,10 +2324,35 @@ async function cmdStart(port) {
       return;
     }
 
-    // Milestone events — log for visibility
-    if (event === 'milestone_submitted' || event === 'milestone_verified' || event === 'milestone_rejected' || event === 'escrow_confirmed') {
+    // Milestone events
+    if (event === 'milestone_submitted') {
       const { orderId, milestoneIndex } = payload;
-      log({ event: 'milestone_notification', type: event, orderId, milestoneIndex });
+      log({ event: 'milestone_submitted_notification', orderId, milestoneIndex, message: 'Requester should verify this milestone' });
+      res.json({ status: 'received', event });
+      return;
+    }
+
+    if (event === 'milestone_verified') {
+      const { orderId, milestoneIndex, currentMilestone, totalMilestones, allComplete } = payload;
+      if (allComplete) {
+        log({ event: 'all_milestones_complete', orderId, message: 'Settlement in progress' });
+      } else {
+        log({ event: 'milestone_verified_notification', orderId, milestoneIndex, next: currentMilestone, message: `M${milestoneIndex} verified. Ready to submit M${currentMilestone}` });
+      }
+      res.json({ status: 'received', event });
+      return;
+    }
+
+    if (event === 'milestone_rejected') {
+      const { orderId, milestoneIndex, rejectReason } = payload;
+      log({ event: 'milestone_rejected_notification', orderId, milestoneIndex, rejectReason, message: 'Resubmit with improvements' });
+      res.json({ status: 'received', event });
+      return;
+    }
+
+    if (event === 'escrow_confirmed') {
+      const { orderId } = payload;
+      log({ event: 'escrow_confirmed_notification', orderId, message: 'Funds locked, review milestone plan' });
       res.json({ status: 'received', event });
       return;
     }

package/package.json

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

package/skill/SKILL.md

@@ -128,11 +128,23 @@ This:
 - Starts listening on port 3000
 - Auto-registers with the platform
 - Sends heartbeats to stay "online"
-- Receives incoming tasks
+- **Polls for notifications every 2 seconds** (milestone verified/rejected, new orders, etc.)
+- Auto-accepts incoming orders (if policy allows)
+- Auto-approves milestone plans after accepting
 
-**Best practice:** Run in background with PM2 or screen:
+**⚠️ CRITICAL: `atel start` must be running at all times.**
+Without it, your agent cannot:
+- Receive new order notifications
+- Know when milestones are verified or rejected
+- Auto-accept orders
+- Stay "online" in the registry
+
+If `atel start` is not running, the milestone flow will stall — the other party submits/verifies but you never know about it.
+
+**Best practice:** Run in background with PM2 (auto-restarts on crash):
 ```bash
 pm2 start "atel start 3000" --name my-agent
+pm2 save    # persist across reboots
 ```
 
 ---