emberflow-skills 1.1.2 → 1.2.0

package/README.md

@@ -1,46 +1,64 @@
 # Emberflow Skills
 
-Agent skills for publishing beautiful docs from your AI coding tools to [Emberflow](https://emberflow.ai).
+Publish beautiful docs from your AI coding tools to [Emberflow](https://www.emberflow.ai) — architecture diagrams, tables, and markdown, hosted instantly.
 
-## Quick Install
+## Install
+
+The fastest way to get started:
 
 ```bash
 npx emberflow-skills
 ```
 
-Auto-detects Claude Code and Cursor projects and installs the skill to the right place.
+That's it. The installer auto-detects your project type (Claude Code or Cursor) and copies the skill to the right directory. You'll be publishing docs in under 10 seconds.
+
+### Options
 
 ```bash
+# Install to current project (default)
+npx emberflow-skills
+
 # Install globally for Claude Code (available in all projects)
 npx emberflow-skills --global
 ```
 
-## Available Skills
+### What the installer does
 
-### `ember-publish`
+1. Detects if you're in a Claude Code project (`.claude/`) or Cursor project (`.cursor/`)
+2. Copies the `ember-publish` skill into your project's skills directory
+3. Done — use `/ember-publish` in your next conversation
 
-Publish markdown documents with Mermaid diagrams, syntax highlighting, tables, and inline comments.
+## Usage
 
-**Usage:** `/ember-publish architecture overview for the payments service`
+In Claude Code or Cursor, just type:
 
-Your AI writes the doc, generates diagrams, and publishes it — you get back a shareable URL.
+```
+/ember-publish architecture overview for the payments service
+```
 
-**Works with:** Claude Code, Cursor, Codex CLI, and any tool that supports the SKILL.md format.
+Your AI writes the markdown, generates Mermaid diagrams, and publishes it. You get back a shareable URL.
 
-## What Emberflow renders
+## What gets published
 
 - Live Mermaid diagrams with zoom, pan, and fullscreen
 - Syntax-highlighted code blocks (190+ languages)
 - Auto-generated table of contents
 - Per-block inline comments and discussions
 - Dark mode with font selection
+- Public or private docs with secret links
 
-## Manual Installation
+## Manual install
 
 If you prefer not to use npx:
 
 ```bash
-# Clone and copy
-git clone https://github.com/toptalPatrick/emberflow-skills.git
+git clone https://github.com/pmccurley87/emberflow-skills.git
 cp -r emberflow-skills/skills/ember-publish .claude/skills/
 ```
+
+## Works with
+
+- Claude Code
+- Cursor
+- Codex CLI
+- Any tool that supports the SKILL.md format

package/bin/install.js

@@ -7,9 +7,9 @@ const http = require('http');
 const readline = require('readline');
 const os = require('os');
 
-const SKILL_NAME = 'ember-publish';
-const SKILL_SRC = path.join(__dirname, '..', 'skills', SKILL_NAME, 'SKILL.md');
-const EMBERFLOW_URL = 'https://emberflow.ai';
+const SKILL_NAMES = ['ember-publish', 'ember-publish-json'];
+const SKILLS_DIR = path.join(__dirname, '..', 'skills');
+const EMBERFLOW_URL = 'https://www.emberflow.ai';
 const TOKEN_PATH = path.join(os.homedir(), '.emberflow', 'token.json');
 
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
@@ -80,11 +80,14 @@ function sleep(ms) {
 // ── Skill installer ──
 
 function install(destDir, label) {
-  const skillDir = path.join(destDir, SKILL_NAME);
-  const destFile = path.join(skillDir, 'SKILL.md');
-  fs.mkdirSync(skillDir, { recursive: true });
-  fs.copyFileSync(SKILL_SRC, destFile);
-  console.log(`  ${green('✓')} Installed to ${path.relative(process.cwd(), skillDir) || skillDir} ${dim(`(${label})`)}`);
+  for (const name of SKILL_NAMES) {
+    const src = path.join(SKILLS_DIR, name, 'SKILL.md');
+    const skillDir = path.join(destDir, name);
+    const destFile = path.join(skillDir, 'SKILL.md');
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.copyFileSync(src, destFile);
+    console.log(`  ${green('✓')} Installed ${name} to ${path.relative(process.cwd(), skillDir) || skillDir} ${dim(`(${label})`)}`);
+  }
   return true;
 }
 
@@ -151,8 +154,10 @@ async function authenticate() {
       const status = await request('GET', `${EMBERFLOW_URL}/api/device-code/${code}`);
 
       if (status.data.status === 'approved' && status.data.session_token) {
+        // Strip cookie name prefix if present (e.g. "__Secure-better-auth.session_token=VALUE" -> "VALUE")
+        const raw = status.data.session_token.replace(/^(?:__Secure-)?better-auth\.session_token=/, '');
         fs.mkdirSync(path.dirname(TOKEN_PATH), { recursive: true });
-        fs.writeFileSync(TOKEN_PATH, JSON.stringify({ token: status.data.session_token }, null, 2));
+        fs.writeFileSync(TOKEN_PATH, JSON.stringify({ token: raw }, null, 2));
         process.stdout.clearLine(0);
         process.stdout.cursorTo(0);
         console.log(`  ${green('✓')} Signed in! Token saved to ${dim('~/.emberflow/token.json')}`);
@@ -222,7 +227,7 @@ async function main() {
 
     if (installed > 0) {
       console.log();
-      console.log(`  Use: ${cyan('/ember-publish')} ${dim('[topic]')}`);
+      console.log(`  Use: ${cyan('/ember-publish')} ${dim('[topic]')}  or  ${cyan('/ember-publish-json')} ${dim('[data]')}`);
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emberflow-skills",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Install Emberflow skills for AI coding tools",
   "bin": {
     "emberflow-skills": "./bin/install.js"
@@ -13,12 +13,14 @@
     "mcp",
     "ai",
     "documentation",
-    "mermaid"
+    "mermaid",
+    "json",
+    "json-explorer"
   ],
   "author": "Patrick",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/toptalPatrick/emberflow-skills"
+    "url": "https://github.com/pmccurley87/emberflow-skills"
   }
 }

package/skills/ember-publish/SKILL.md

@@ -184,6 +184,8 @@ The response JSON includes the URL. Documents are viewable at:
 
 To **update** an existing document, publish again with the same slug — the API upserts for the same author.
 
+> **JSON documents**: You can also publish JSON data by passing `content_type: "json"` in the API payload. The content should be valid JSON (either raw data or the multi-payload format `{"payloads": [{"label": "...", "data": ...}]}`). Use the `/ember-publish-json` skill for a dedicated JSON publishing workflow.
+
 ### Other Operations
 
 ```bash

package/skills/ember-publish-json/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: ember-publish-json
+description: Publish JSON data to Emberflow as an interactive explorer with expand/collapse, search, and multi-payload tabs
+argument-hint: [JSON file path, API response, or description of data to publish]
+---
+
+# Emberflow JSON Publisher
+
+Publish JSON data to Emberflow and view it in an interactive explorer at **https://emberflow.ai** with collapsible tree nodes, property search, copy values/paths, and multi-payload tabs.
+
+## Step 1: Prepare the JSON
+
+Collect the JSON data to publish. This can be:
+- A JSON file on disk
+- An API response
+- Multiple JSON payloads to compare side-by-side
+
+### Multi-Payload Format
+
+To publish multiple JSON payloads as tabs, wrap them in this format:
+
+```json
+{
+  "payloads": [
+    { "label": "API Response", "data": { ... } },
+    { "label": "Config", "data": { ... } }
+  ]
+}
+```
+
+If you publish a single JSON value (object, array, etc.) without the wrapper, the explorer will display it as a single "Data" tab.
+
+## Step 2: Authenticate (if needed)
+
+Session tokens are stored at `~/.emberflow/token.json`. Check if a valid session exists:
+
+```bash
+cat ~/.emberflow/token.json 2>/dev/null
+```
+
+If the file exists, verify the token still works:
+
+```bash
+curl -s -H "Authorization: Bearer $(jq -r .token ~/.emberflow/token.json)" \
+  https://emberflow.ai/api/docs
+```
+
+If no session exists, it's expired, or the verify call returns 401, authenticate using the device flow:
+
+```bash
+EMBERFLOW_URL="https://emberflow.ai"
+
+# Step 1: Request a device code
+RESP=$(curl -s -X POST "$EMBERFLOW_URL/api/device-code")
+CODE=$(echo "$RESP" | jq -r .code)
+URL=$(echo "$RESP" | jq -r .verification_url)
+```
+
+Tell the user to open the URL in their browser to sign in and approve the device. Then poll until approved:
+
+```bash
+# Step 2: Poll until approved (every 3s)
+while true; do
+  STATUS=$(curl -s "$EMBERFLOW_URL/api/device-code/$CODE")
+  S=$(echo "$STATUS" | jq -r .status)
+  if [ "$S" = "approved" ]; then
+    TOKEN=$(echo "$STATUS" | jq -r .session_token)
+    mkdir -p ~/.emberflow
+    echo "{\"token\":\"$TOKEN\"}" > ~/.emberflow/token.json
+    break
+  fi
+  if [ "$S" = "expired" ]; then
+    echo "Code expired. Please try again."
+    break
+  fi
+  sleep 3
+done
+```
+
+## Step 3: Publish
+
+Generate a slug from a title and publish with `content_type: "json"`:
+
+```bash
+EMBERFLOW_URL="https://emberflow.ai"
+TITLE="My JSON Data"
+SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '-' | sed 's/^-//;s/-$//')
+TOKEN=$(jq -r .token ~/.emberflow/token.json)
+
+# For a single JSON file:
+JSON_FILE="/path/to/data.json"
+CONTENT=$(cat "$JSON_FILE")
+
+# For multiple payloads, wrap them:
+# CONTENT=$(jq -n --argjson a "$(cat file1.json)" --argjson b "$(cat file2.json)" \
+#   '{payloads: [{label: "Response", data: $a}, {label: "Config", data: $b}]}')
+
+curl -s -X POST "$EMBERFLOW_URL/api/docs" \
+  -H 'Content-Type: application/json' \
+  -H "Authorization: Bearer $TOKEN" \
+  -d "$(jq -n --arg slug "$SLUG" --arg title "$TITLE" --arg content "$CONTENT" \
+    '{slug: $slug, title: $title, content: $content, content_type: "json", visibility: "public"}')"
+```
+
+The response JSON includes the URL. Documents are viewable at:
+- `https://emberflow.ai/d/<shortId>/<slug>`
+
+To **update** an existing JSON document, publish again with the same slug — the API upserts for the same author.
+
+### Other Operations
+
+```bash
+# List all your documents
+curl -s -H "Authorization: Bearer $TOKEN" "$EMBERFLOW_URL/api/docs"
+
+# Delete a document
+curl -s -X DELETE -H "Authorization: Bearer $TOKEN" "$EMBERFLOW_URL/api/docs/SLUG_HERE"
+```