ape-claw 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ape-claw",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "ApeChain bridge and NFT execution CLI with telemetry for OpenClaw agents",
   "license": "MIT",
   "repository": {

package/src/cli.mjs

@@ -211,15 +211,35 @@ function installApeClawSkill(args) {
   };
 }
 
+function yamlSafe(val) {
+  const s = String(val);
+  if (!s) return '""';
+  if (/[:{}\[\]#&*!|>'"%@`,\n]/.test(s) || s.startsWith(" ") || s.endsWith(" ")) {
+    return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+  }
+  return s;
+}
+
 function syncSkillToOpenClaw(cardObj, slug, skillsRoot) {
   const s = String(slug || cardObj?.slug || cardObj?.name || "").toLowerCase().trim()
     .replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
   if (!s) return null;
-  const doc = String(cardObj?.documentation_md || "").trim();
-  const nameValue = String(cardObj?.name || s).trim();
+  const rawDoc = String(cardObj?.documentation_md || "").trim();
+  const displayName = String(cardObj?.name || s).trim();
   const versionValue = String(cardObj?.version || "1.0.0").trim();
   const descriptionValue = String(cardObj?.description || "").trim();
-  const content = doc || `---\nname: ${nameValue}\nversion: ${versionValue}\ndescription: ${descriptionValue}\n---\n\n# ${nameValue}\n\n${descriptionValue}\n`;
+  const descOneLine = descriptionValue.replace(/\n/g, " ").slice(0, 300);
+
+  const openclawFrontmatter = `---\nname: ${s}\nversion: ${yamlSafe(versionValue)}\ndescription: ${yamlSafe(descOneLine)}\n---\n`;
+
+  let content;
+  if (rawDoc) {
+    // Strip existing frontmatter from documentation_md and prepend OpenClaw-compatible one
+    const stripped = rawDoc.replace(/^---[\s\S]*?---\s*/, "").trim();
+    content = openclawFrontmatter + "\n" + stripped;
+  } else {
+    content = openclawFrontmatter + `\n# ${displayName}\n\n${descriptionValue}\n`;
+  }
 
   const skillDir = path.join(skillsRoot, s);
   fs.mkdirSync(skillDir, { recursive: true });

package/ui/forge/css/forge.css

@@ -431,6 +431,67 @@ a{color:var(--neon-cyan);text-decoration:none}
 @keyframes forgeToastIn{from{opacity:0;transform:translateY(12px)}to{opacity:1;transform:translateY(0)}}
 @keyframes forgeToastOut{from{opacity:1;transform:translateY(0)}to{opacity:0;transform:translateY(-12px)}}
 
+/* ── Offline Gate ───────────────────────────────────────── */
+.forge-offline-gate{
+  position:fixed;inset:0;z-index:9999;display:flex;align-items:center;justify-content:center;
+  background:var(--bg);padding:24px;
+}
+.forge-offline-card{
+  max-width:560px;width:100%;background:var(--surface);border:1px solid var(--border);
+  border-radius:6px;padding:40px 36px;text-align:center;position:relative;
+  box-shadow:0 0 80px rgba(207,255,4,.06),var(--panel-shadow);
+}
+.forge-offline-icon{font-size:3.5rem;margin-bottom:12px;filter:drop-shadow(0 0 18px rgba(207,255,4,.35))}
+.forge-offline-title{
+  font-family:var(--font-display);font-weight:900;font-size:1.6rem;letter-spacing:.06em;
+  color:var(--accent);text-transform:uppercase;margin-bottom:6px;
+}
+.forge-offline-sub{color:var(--dim);font-size:.85rem;margin-bottom:0}
+.forge-offline-divider{
+  height:1px;background:linear-gradient(90deg,transparent,var(--border),transparent);
+  margin:20px 0;
+}
+.forge-offline-desc{color:var(--text);font-size:.82rem;line-height:1.65;text-align:left;margin-bottom:4px}
+.forge-offline-steps{text-align:left;margin:18px 0}
+.forge-offline-step{
+  display:flex;gap:14px;align-items:flex-start;padding:12px 0;
+  border-bottom:1px solid rgba(255,255,255,.05);
+}
+.forge-offline-step:last-child{border-bottom:none}
+.forge-offline-step-num{
+  flex-shrink:0;width:26px;height:26px;display:flex;align-items:center;justify-content:center;
+  border-radius:50%;background:rgba(207,255,4,.12);border:1px solid var(--border);
+  color:var(--accent);font-weight:800;font-size:.7rem;font-family:var(--font-mono);
+}
+.forge-offline-step strong{display:block;color:var(--text);font-size:.8rem;margin-bottom:3px}
+.forge-offline-step code{
+  display:block;font-family:var(--font-mono);font-size:.72rem;color:var(--neon-cyan);
+  background:rgba(0,0,0,.5);border:1px solid rgba(99,215,255,.15);border-radius:3px;
+  padding:6px 10px;margin-top:4px;word-break:break-all;
+}
+.forge-offline-hint{display:block;font-size:.68rem;color:var(--dim);margin-top:3px}
+.forge-offline-hint code{display:inline;padding:1px 5px;margin:0;font-size:.68rem}
+.forge-offline-note{font-size:.72rem;color:var(--dim);line-height:1.7;text-align:center}
+.forge-offline-note code{
+  font-family:var(--font-mono);font-size:.68rem;color:var(--neon-green);
+  background:rgba(0,255,0,.06);padding:2px 6px;border-radius:2px;
+}
+.forge-offline-dim{color:rgba(255,255,255,.3)}
+.forge-offline-links{display:flex;gap:10px;justify-content:center;margin-top:20px}
+.forge-offline-btn{
+  display:inline-flex;align-items:center;padding:9px 22px;border-radius:3px;
+  font-family:var(--font-display);font-weight:700;font-size:.78rem;letter-spacing:.04em;
+  text-transform:uppercase;text-decoration:none;transition:all .2s;
+  background:var(--accent);color:#0c0c0c;border:1px solid var(--accent);
+}
+.forge-offline-btn:hover{background:#e2ff40;box-shadow:0 0 16px rgba(207,255,4,.3)}
+.forge-offline-btn-secondary{
+  background:transparent;color:var(--text);border-color:var(--border);
+}
+.forge-offline-btn-secondary:hover{
+  background:rgba(207,255,4,.08);color:var(--accent);border-color:var(--accent);
+}
+
 /* ── Responsive ─────────────────────────────────────────── */
 @media(max-width:1199px){
   .forge-bottom{grid-template-columns:1fr;max-height:none}

package/ui/forge/index.html

@@ -169,6 +169,67 @@
     </footer>
   </div>
 
+  <!-- Forge requires a local server to discover installed skills -->
+  <div class="forge-offline-gate" id="forgeOfflineGate" style="display:none">
+    <div class="forge-offline-card">
+      <div class="forge-offline-icon">&#x1F916;</div>
+      <h2 class="forge-offline-title">ClawBot Forge</h2>
+      <p class="forge-offline-sub">Your 3D agent — shaped by the skills you install</p>
+      <div class="forge-offline-divider"></div>
+      <p class="forge-offline-desc">
+        The Forge renders <strong>your</strong> installed skills as attachments on a 3D robot.
+        It discovers skills from your local Cursor &amp; OpenClaw directories, so it must be
+        hosted on your machine.
+      </p>
+      <div class="forge-offline-steps">
+        <div class="forge-offline-step">
+          <span class="forge-offline-step-num">1</span>
+          <div>
+            <strong>Install ApeClaw + skills</strong>
+            <code>npx ape-claw skill install --starter-pack</code>
+          </div>
+        </div>
+        <div class="forge-offline-step">
+          <span class="forge-offline-step-num">2</span>
+          <div>
+            <strong>Clone the repo &amp; start the server</strong>
+            <code>git clone https://github.com/simplefarmer69/ape-claw.git && cd ape-claw && npm install && npm run start:ui</code>
+          </div>
+        </div>
+        <div class="forge-offline-step">
+          <span class="forge-offline-step-num">3</span>
+          <div>
+            <strong>Open the Forge</strong>
+            <code>http://localhost:8799/forge</code>
+            <span class="forge-offline-hint">Your installed skills appear as 3D attachments on the robot automatically</span>
+          </div>
+        </div>
+      </div>
+      <div class="forge-offline-divider"></div>
+      <p class="forge-offline-note">
+        The Forge reads skills installed via <code>npx ape-claw skill install</code>.<br>
+        Skills are synced to <code>~/.cursor/skills/</code> and <code>~/.openclaw/workspace/skills/</code> automatically.
+      </p>
+      <div class="forge-offline-links">
+        <a class="forge-offline-btn" href="/skills">Browse Skills</a>
+        <a class="forge-offline-btn forge-offline-btn-secondary" href="https://github.com/simplefarmer69/ape-claw" target="_blank" rel="noopener">GitHub</a>
+      </div>
+    </div>
+  </div>
+
+  <script>
+  (async function detectLocal() {
+    try {
+      const r = await fetch("/api/health", { signal: AbortSignal.timeout(4000) });
+      if (r.ok) return; // local server running — load the forge normally
+    } catch {}
+    // Not local — show the offline gate and hide the forge app
+    document.getElementById("forgeOfflineGate").style.display = "";
+    const app = document.querySelector(".forge-app");
+    if (app) app.style.display = "none";
+  })();
+  </script>
+
   <script type="importmap">
   {
     "imports": {

package/ui/shared/sidebar-nav.js

@@ -53,11 +53,12 @@
     var active = !l.external && isActive(l.href, cur);
     var attrs = active ? ' aria-current="page"' : "";
     if (l.external) attrs += ' target="_blank" rel="noopener"';
+    var badge = l.external ? "EXT" : (l.icon === "forge" ? "LOCAL" : "");
     navHtml +=
       '<a class="sb-link" href="' + String(l.href) + '" data-tip="' + String(l.label) + '"' + attrs + ">" +
       iconSvg(l.icon) +
       '<span class="sb-text">' + String(l.label) + "</span>" +
-      (l.external ? '<span class="sb-sub">EXT</span>' : '<span class="sb-sub"></span>') +
+      '<span class="sb-sub">' + badge + '</span>' +
       "</a>";
   }