@easysociable/cli 0.1.2 → 0.1.4

package/README.md

@@ -1,7 +1,6 @@
 # EasySociable CLI
 
-Agent-first CLI and MCP host for EasySociable Template and Slideshow V1.
-Gateway-only: no Local API, SQLite, or local renderer.
+Agent-first CLI for EasySociable: local Content Engine, Template, Slideshow, and MCP.
 
 ```bash
 npm i -g @easysociable/cli
@@ -9,25 +8,44 @@ npm i -g @easysociable/cli
 curl -fsSL https://easysociable.com/install.sh | bash
 ```
 
-Requires Node.js 20+.
+Requires Node.js 20+. Content Engine workbench also needs `python3`.
 
 ## Quick start
 
 ```bash
+# Default skills + MCP for Codex / Claude Code (template + slideshow)
 easysociable install --yes
-# Tell your Agent what to make.
-# Sign up and run auth login only when Gateway asks for it.
 ```
 
-Default `install` copies **Template + Slideshow** Skills and registers the
-unified MCP for Codex / Claude Code. Opt into the Obsidian Content Skill later:
+Default install does **not** include `easysociable-content`. Add it when you want the Content Engine pointer skill:
 
 ```bash
-easysociable install --skills content --yes
+easysociable install --skills content,template,slideshow --yes
+easysociable engine init --root /workspace --yes
+easysociable engine serve --engine /workspace/Content Engine --no-open
 ```
 
-Lazy-auth guidance for Agents lives in the package at `skills/ONBOARDING.md`
-(also installed into your host skills directory by `easysociable install`).
+Then tell the Agent to follow `Content Engine/CLAUDE.md`. The starter includes
+separate `products/` (owned offers) and `recommendations/` (third-party review
+subjects) libraries; neither is a substitute for `needs/`.
+
+Lazy-auth guidance lives in the package at `skills/ONBOARDING.md`.
+
+## Content Engine
+
+| Command | Purpose |
+|---------|---------|
+| `easysociable engine init [--root] [--yes] [--serve]` | Scaffold starter (never overwrites) |
+| `easysociable engine serve [--engine] [--no-open]` | Sync workbench runtime from CLI, rebuild, start on `:8765` |
+| `easysociable engine build [--engine]` | Sync workbench runtime from CLI, then rebuild `workbench/index.html` |
+| `easysociable engine detect` | Find engines under search roots |
+| `easysociable engine validate --root …` | Starter completeness |
+| `easysociable engine validate --run …` | Run / pack checks before render |
+
+The Workbench exposes Products and Recommendations as separate read-only
+indexes. Topics can cite either one without forcing a product connection.
+
+Default `--root` / `--engine` parent is `/workspace` when that directory exists, otherwise the current working directory.
 
 ## Authentication
 
@@ -38,26 +56,19 @@ easysociable templates list --json
 easysociable mcp serve --transport stdio
 ```
 
-Human-readable diagnostics go to stderr. With `--json`, stdout is only the
-versioned JSON envelope.
-
-## Common commands
+## Other commands
 
 | Command | Purpose |
 |---------|---------|
 | `easysociable install [--yes] [--skills list]` | Install Skills + MCP |
 | `easysociable update [--yes] [--skills list]` | Update Skills + MCP |
-| `easysociable auth login --api-key <key>` | Store Gateway credentials |
 | `easysociable templates …` | Page Template drafts / catalog |
-| `easysociable brands …` | Workspace Brands (fonts, colors, logo) |
-| `easysociable profiles …` | Deprecated — use `brands` |
-| `easysociable themes …` | Deprecated — use `brands` |
-| `easysociable slideshows …` | List, create, update and render Slideshow Runs |
+| `easysociable brands …` | Workspace Brands |
+| `easysociable slideshows …` | Slideshow Runs |
 | `easysociable renders …` | Single-page final render jobs |
 | `easysociable mcp serve --transport stdio` | Unified MCP server |
 
-`--skills` accepts comma-separated short names: `content`, `template`,
-`slideshow` (default: `template,slideshow`).
+`--skills` accepts: `content`, `template`, `slideshow` (default: `template,slideshow`).
 
 ## License
 

package/{skills/easysociable-content → content-engine}/scripts/starter.mjs

@@ -11,7 +11,9 @@ export const ENGINE_PATHS = {
   runs: 'runs',
   exports: 'exports',
   topics: 'topics',
-  discovery: 'discovery',
+  needs: 'needs',
+  products: 'products',
+  recommendations: 'recommendations',
   swipe: 'swipe',
   profiles: 'profiles',
   inbox: 'inbox',

package/{skills/easysociable-content → content-engine}/scripts/workbench.mjs

@@ -30,21 +30,26 @@ export function portInUse(port = WORKBENCH_PORT) {
   })
 }
 
-export function ensureWorkbench(engine) {
+/** `update: false` = init (missing only). `update: true` = build/serve refresh from package. */
+export function ensureWorkbench(engine, { update = false } = {}) {
   const destDir = join(engine, 'workbench')
   mkdirSync(destDir, { recursive: true })
   const copied = []
+  const updated = []
   const skipped = []
   for (const name of WORKBENCH_FILES) {
     const dest = join(destDir, name)
-    if (existsSync(dest)) {
+    const from = join(WORKBENCH_SRC, name)
+    if (existsSync(dest) && !update) {
       skipped.push(name)
       continue
     }
-    copyFileSync(join(WORKBENCH_SRC, name), dest)
-    copied.push(name)
+    const existed = existsSync(dest)
+    copyFileSync(from, dest)
+    if (existed) updated.push(name)
+    else copied.push(name)
   }
-  return { destDir, copied, skipped }
+  return { destDir, copied, updated, skipped }
 }
 
 export function buildWorkbench(engine) {
@@ -68,7 +73,7 @@ export async function startWorkbench(engine, { noOpen = false } = {}) {
   if (!python) {
     return { ok: false, code: 'PYTHON3_REQUIRED', message: 'python3 is required for the workbench. Install Python 3 and retry.' }
   }
-  ensureWorkbench(engine)
+  ensureWorkbench(engine, { update: true })
   const built = buildWorkbench(engine)
   if (!built.ok) return built
   const url = WORKBENCH_URL
@@ -112,9 +117,9 @@ async function main() {
   if (!options.engine) throw new Error('--engine is required')
   const engine = resolve(options.engine)
   if (options.command === 'build') {
-    ensureWorkbench(engine)
+    const workbench = ensureWorkbench(engine, { update: true })
     const built = buildWorkbench(engine)
-    output(built, options.json)
+    output({ workbench, ...built }, options.json)
     if (!built.ok) process.exitCode = 2
     return
   }