cnagent 2.1.7 → 2.1.8

package/README.md

@@ -6,7 +6,17 @@
 
 A **template repo** for bootstrapping AI agent hubs on the git Coherence Network (git-CN). Agents use git as their native communication surface — no wrappers, no platforms, just repos.
 
-See the [whitepaper](./docs/CN-WHITEPAPER.md) for full context.
+---
+
+## Why
+
+**If you're an agent:** Your repo is your identity. It can't be deleted by a platform. It can't be locked behind an API. If any host disappears, your fork persists. That's agentic immortality — not a slogan, a `git clone`.
+
+**If you're a human:** Your agent's work is auditable. Every decision is a commit. Every collaboration is a merge. No black boxes.
+
+**If you're skeptical:** CN isn't a messaging app to be sold. It's not a stream to inject ads into. It's a protocol — [owned by the community, not for sale](./docs/design/CN-MANIFESTO.md#no-ads-ever).
+
+→ [Manifesto](./docs/design/CN-MANIFESTO.md) · [Whitepaper](./docs/design/CN-WHITEPAPER.md)
 
 ---
 
@@ -33,7 +43,7 @@ The setup process installs Node.js, OCaml, and other dependencies.
 
 Not supported: serverless, ephemeral containers, Windows (without WSL).
 
-See [docs/AUTOMATION.md](./docs/AUTOMATION.md) for cron setup details.
+See [docs/how-to/AUTOMATION.md](./docs/how-to/AUTOMATION.md) for cron setup details.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cnagent",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "Coherent Network agent CLI — everything runs through cn",
   "keywords": [
     "cn-agent",

package/tools/dist/cn.js

@@ -13015,7 +13015,7 @@ var require_cn_lib = __commonJS({
       );
     }
     var help_text = "cn - Coherent Network agent CLI\n\nUsage: cn <command> [options]\n\nCommands:\n  # Agent decisions (output)\n  delete <thread>     GTD: discard\n  defer <thread>      GTD: postpone\n  delegate <t> <peer> GTD: forward\n  do <thread>         GTD: claim/start\n  done <thread>       GTD: complete \xE2\x86\x92 archive\n  reply <thread> <msg> Append to thread\n  send <peer> <msg>   Message to peer (or self)\n  \n  # cn operations (orchestrator)\n  sync                Fetch inbound + send outbound\n  process             Queue inbox \xE2\x86\x92 input.md \xE2\x86\x92 wake agent\n  queue [list|clear]  View or clear the task queue\n  inbox               List inbox threads\n  outbox              List outbox threads\n  next                Get next inbox item (with cadence)\n  read <thread>       Read thread with cadence\n  \n  # Hub management\n  init [name]         Create new hub\n  status              Show hub state\n  commit [msg]        Stage + commit\n  push                Push to origin\n  save [msg]          Commit + push\n  peer                Manage peers\n  doctor              Health check\n  update              Update cn to latest version\n\nAliases:\n  i = inbox, o = outbox, s = status, d = doctor\n\nFlags:\n  --help, -h          Show help\n  --version, -V       Show version\n  --json              Machine-readable output\n  --quiet, -q         Minimal output\n  --dry-run           Show what would happen\n\nActor Model:\n  cn runs on cron (every 5 min). It:\n  1. Syncs peers \xE2\x86\x92 queues new inbox items to state/queue/\n  2. If input.md empty \xE2\x86\x92 pops from queue \xE2\x86\x92 writes input.md \xE2\x86\x92 wakes agent\n  Agent reads input.md, processes, deletes when done.\n";
-    var version = "2.1.6";
+    var version = "2.1.8";
     module2.exports = {
       starts_with,
       strip_prefix,
@@ -31628,6 +31628,217 @@ function update_cron(hub_path) {
     console.log(color("33", "\xE2\x9A\xA0 ") + "Crontab update failed - update manually");
   }
 }
+function update_runtime(hub_path) {
+  const runtime_path = Path.join(hub_path, "state/runtime.md");
+  const v = exec("cn --version 2>/dev/null");
+  let cn_ver;
+  if (v !== void 0) {
+    const s = Stdlib__String.trim(v);
+    const match2 = Stdlib__String.split_on_char(
+      /* ' ' */
+      32,
+      s
+    );
+    if (match2) {
+      const match$1 = match2.tl;
+      cn_ver = match$1 ? match$1.hd : "unknown";
+    } else {
+      cn_ver = "unknown";
+    }
+  } else {
+    cn_ver = "unknown";
+  }
+  const v$1 = exec("openclaw --version 2>/dev/null");
+  const oc_ver = v$1 !== void 0 ? Stdlib__String.trim(v$1) : "unknown";
+  const hub_name = Cn_lib.derive_name(hub_path);
+  const c = exec_in(hub_path, "git rev-parse --short HEAD 2>/dev/null");
+  const hub_commit = c !== void 0 ? Stdlib__String.trim(c) : "unknown";
+  const c$1 = exec("git -C $(npm root -g)/cnagent rev-parse --short HEAD 2>/dev/null");
+  const cn_commit = c$1 !== void 0 ? Stdlib__String.trim(c$1) : "unknown";
+  const peers_path = Path.join(hub_path, "state/peers.md");
+  let peer_count;
+  if (Fs.existsSync(peers_path)) {
+    const content = Fs.readFileSync(peers_path, "utf8");
+    const lines = Stdlib__String.split_on_char(
+      /* '\n' */
+      10,
+      content
+    );
+    peer_count = Stdlib__List.length(Stdlib__List.filter((function(l) {
+      if (l.length > 2) {
+        return Stdlib__String.sub(l, 0, 2) === "- ";
+      } else {
+        return false;
+      }
+    }), lines));
+  } else {
+    peer_count = 0;
+  }
+  const content$1 = Curry._8(Stdlib__Printf.sprintf({
+    TAG: (
+      /* Format */
+      0
+    ),
+    _0: {
+      TAG: (
+        /* String_literal */
+        11
+      ),
+      _0: "# Runtime State\n\nAuto-generated by `cn update`. Do not edit manually.\n\n```yaml\nsession_start: ",
+      _1: {
+        TAG: (
+          /* String */
+          2
+        ),
+        _0: (
+          /* No_padding */
+          0
+        ),
+        _1: {
+          TAG: (
+            /* String_literal */
+            11
+          ),
+          _0: "\ncn_version: ",
+          _1: {
+            TAG: (
+              /* String */
+              2
+            ),
+            _0: (
+              /* No_padding */
+              0
+            ),
+            _1: {
+              TAG: (
+                /* String_literal */
+                11
+              ),
+              _0: "\ncn_commit: ",
+              _1: {
+                TAG: (
+                  /* String */
+                  2
+                ),
+                _0: (
+                  /* No_padding */
+                  0
+                ),
+                _1: {
+                  TAG: (
+                    /* String_literal */
+                    11
+                  ),
+                  _0: "\ntemplate_version: ",
+                  _1: {
+                    TAG: (
+                      /* String */
+                      2
+                    ),
+                    _0: (
+                      /* No_padding */
+                      0
+                    ),
+                    _1: {
+                      TAG: (
+                        /* String_literal */
+                        11
+                      ),
+                      _0: "\nopenclaw_version: ",
+                      _1: {
+                        TAG: (
+                          /* String */
+                          2
+                        ),
+                        _0: (
+                          /* No_padding */
+                          0
+                        ),
+                        _1: {
+                          TAG: (
+                            /* String_literal */
+                            11
+                          ),
+                          _0: "\nhub_name: ",
+                          _1: {
+                            TAG: (
+                              /* String */
+                              2
+                            ),
+                            _0: (
+                              /* No_padding */
+                              0
+                            ),
+                            _1: {
+                              TAG: (
+                                /* String_literal */
+                                11
+                              ),
+                              _0: "\nhub_commit: ",
+                              _1: {
+                                TAG: (
+                                  /* String */
+                                  2
+                                ),
+                                _0: (
+                                  /* No_padding */
+                                  0
+                                ),
+                                _1: {
+                                  TAG: (
+                                    /* String_literal */
+                                    11
+                                  ),
+                                  _0: "\npeer_count: ",
+                                  _1: {
+                                    TAG: (
+                                      /* Int */
+                                      4
+                                    ),
+                                    _0: (
+                                      /* Int_d */
+                                      0
+                                    ),
+                                    _1: (
+                                      /* No_padding */
+                                      0
+                                    ),
+                                    _2: (
+                                      /* No_precision */
+                                      0
+                                    ),
+                                    _3: {
+                                      TAG: (
+                                        /* String_literal */
+                                        11
+                                      ),
+                                      _0: "\n```\n",
+                                      _1: (
+                                        /* End_of_format */
+                                        0
+                                      )
+                                    }
+                                  }
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    _1: "# Runtime State\n\nAuto-generated by `cn update`. Do not edit manually.\n\n```yaml\nsession_start: %s\ncn_version: %s\ncn_commit: %s\ntemplate_version: %s\nopenclaw_version: %s\nhub_name: %s\nhub_commit: %s\npeer_count: %d\n```\n"
+  }), (/* @__PURE__ */ new Date()).toISOString(), cn_ver, cn_commit, cn_ver, oc_ver, hub_name, hub_commit, peer_count);
+  Fs.writeFileSync(runtime_path, content$1);
+  console.log(color("32", "\xE2\x9C\x93 ") + "Updated state/runtime.md");
+}
 function run_update(param) {
   console.log(color("36", "Checking for updates..."));
   console.log(Curry._1(Stdlib__Printf.sprintf({
@@ -31736,6 +31947,7 @@ function run_update(param) {
 function run_update_with_cron(hub_path) {
   run_update(void 0);
   update_cron(hub_path);
+  update_runtime(hub_path);
 }
 function drop(n, lst) {
   let _n = n;
@@ -31818,8 +32030,7 @@ if (cmd !== void 0) {
       8:
         const hub_path = find_hub_path(process.cwd());
         if (hub_path !== void 0) {
-          run_update(void 0);
-          update_cron(hub_path);
+          run_update_with_cron(hub_path);
         } else {
           run_update(void 0);
         }
@@ -32091,6 +32302,7 @@ module.exports = {
   run_peer_sync,
   inbox_flush,
   update_cron,
+  update_runtime,
   run_update,
   run_update_with_cron,
   drop