@easysociable/cli 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easysociable/cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Agent-first CLI for EasySociable: Content Engine, Template, Slideshow, and MCP",
   "type": "module",
   "license": "MIT",
@@ -16,12 +16,26 @@
   },
   "keywords": [
     "easysociable",
-    "cli",
     "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "cursor",
+    "carousel",
+    "social-carousel",
+    "slideshow",
+    "slideshow-generator",
     "social-media",
+    "tiktok",
+    "linkedin",
+    "instagram",
+    "threads",
+    "xiaohongshu",
     "templates",
-    "slideshow",
-    "agent"
+    "agent",
+    "content-engine",
+    "cli"
   ],
   "engines": {
     "node": ">=20.0.0"
@@ -49,8 +63,8 @@
     "tsup": "^8.0.2",
     "typescript": "^5.8.3",
     "vitest": "^1.3.1",
-    "@easysociable/mcp-server": "0.0.0",
     "@easysociable/tsconfig": "0.0.0",
+    "@easysociable/mcp-server": "0.0.0",
     "@easysociable/template-gateway-client": "0.0.0",
     "@easysociable/vitest-config": "0.0.0"
   },

package/skills/easysociable-content/SKILL.md

@@ -1,21 +1,20 @@
 ---
 name: easysociable-content
 description: >
-  Operate the EasySociable Content Engine (profile, needs, products, recommendations, topics, runs, workbench).
+  Operate the EasySociable Content Engine: Knowledge (Karpathy LLM Wiki), hook-led
+  Topics, formula-led Runs, profile, brand, media, workbench.
   Triggers: 采访我, 完善人设, interview me, who am I as a creator, 建立 profile
   — follow workflows/INTERVIEW.md (engine CLAUDE.md § Interview wins if present).
-  Triggers: 记需求, 扫需求选题, 扫关键词, 路由 Hit, capture audience quotes, user needs, 调研需求, 需求落库
-  — follow workflows/NEEDS.md + engine CLAUDE.md § Keywords / § Hits / § Needs.
-  Triggers: 更新产品, 产品库, product facts, product pricing, product offer
-  — follow the engine CLAUDE.md § Products and edit `products/`.
-  Triggers: 推荐产品, 评测工具, compare tools, review an AI product
-  — edit `recommendations/`; do not treat third-party subjects as owned Products.
-  Triggers: 做成选题, 开一单, 出图
-  — follow engine CLAUDE.md (§ Topics / § Open a run / § PagePack: Page Contracts → Media → Template Selection before templates).
+  Triggers: 记一下, 存资料, ingest, 问知识库, what do we know about, lint 知识库, 整理知识
+  — follow engine CLAUDE.md § Knowledge (Ingest / Query / Lint).
+  Triggers: 列出 hooks, 选 hook, 用 H-… 生成选题, 做成选题
+  — follow engine CLAUDE.md § Topics (Hook → Formula → Knowledge).
+  Triggers: 开一单, 用 T-… 开一单, 出图
+  — follow engine CLAUDE.md § Open a run (content straight from the Topic's Formula).
   If no engine exists, copy/clone the Content Engine core (see Create below;
   `easysociable engine init` is optional offline scaffold). Then follow
   Content Engine/CLAUDE.md. Render handoff: easysociable-template (1 page) or
-  easysociable-slideshow (2+). Never publish or post.
+  easysociable-slideshow (2+, Formula handoff). Never publish or post.
 ---
 
 # EasySociable Content
@@ -24,62 +23,33 @@ Entry card for agents. **Do not invent a parallel workflow.** Instance SoT is th
 
 ## Product boundary
 
-- Teach a **Content Engine** (signal → decision → draft → review → reusable learning).
-- **EasySociable** is the **visual production layer** inside that engine — not the content brain, not the whole system.
-- For `easysociable-builder` needs research, prefer **L1 system / L2 judgment-review** pains (sustainable publishing) over **L3 visual-tool** friction, unless the user asks for L3.
+- Teach a **Content Engine**: knowledge you own → a hook-led decision → formula-led content → feedback that updates knowledge.
+- **EasySociable** supplies the **Hooks / Formulas catalog** and the **visual production layer** (Studio). It is not the content brain.
 
-## Pipeline (do not collapse stages)
+## Three loops (do not collapse)
 
 ```text
-Profile / Audience
-  → Needs (verbatim audience quotes)
-  → optional Product (owned offer facts) or Recommendation (third-party review subject)
-  → Pillar (what this profile discusses) + Lane (how it publishes)
-  → Topic (decision summary + readable judgment + Score appendix)
-  → Run → Pack → Publish / feedback
+Knowledge   raw/ (immutable) → knowledge/pages (agent-maintained wiki) → index.md + log.md
+Topics      Hook (H-…) → one of its Formulas (F-…) → angle from knowledge pages → T-…
+Runs        Topic's Formula beats → content.md + content-pack.v1 → Studio → feedback
 ```
 
 | Stage | Owns | Does not |
 |-------|------|----------|
-| Needs `N-` | Verbatim reader/operator quotes | Watchlist hooks, Agent rewrites |
-| Products `P-` | Owned offer facts, pricing, boundaries | Audience demand or third-party reviews |
-| Recommendations `R-` | Third-party subject, evidence, limits, disclosure | Owned product claims |
-| Pillars / lanes | Durable subject / publishing mode | A replacement for Needs or evidence |
-| Topic `T-` | Human judgment card + opp gate | Being auto-created from heat |
-| Workbench | Read-only observatory | Source of truth (markdown indexes are) |
+| `raw/` | Verbatim sources + URL | Ever get edited after save |
+| `knowledge/pages` | `source` / `concept` / `entity` / `synthesis` pages with `[[links]]` | Viral-post teardowns; facts no raw source supports |
+| Topic `T-` | `hook_id` + `formula_id` + `knowledge_ids` + Beat plan | Exist without a hook and a formula |
+| Run | One platform; one page per formula beat | Re-pick hook/formula; idea → brief → packet → draft → editor → rubric chain |
+| Workbench | Read-only observatory (Knowledge graph, Topics, Runs) | Source of truth (markdown is) |
 
 ## Hard rules
 
-1. **No invented quotes** — Needs quote cell = verbatim only. Gloss is separate (`layer=L1|L2|L3` allowed in gloss).
-2. **Heat ≠ topic** — External source metrics never make `ready`.
-3. **Never invent `N-` from a product, vendor claim, or headline.** Match captured needs only.
-4. **Topic decision card first** — start with Verdict / Why this status / Who it’s for / Core judgment / Next step, then explain the problem, current belief, angle, timing, expected belief change, evidence gap, and recommended form. **Language:** readable judgment + `one_liner` = profile `voice.md` Language (else pillars / `engine.json` locale); verbatim Needs stay untranslated. Keep scores and IDs in the appendix. Chat output is the readable decision card, not a score walkthrough.
-5. **`N-` never in `capture_id`** — needs go in `need_ids` only.
-6. **Rebuild workbench** after markdown writes in the engine vault.
-7. **Keep ownership explicit** — `products/` is for offers we own or provide;
-   `recommendations/` is for third-party tools and products. A Topic may cite
-   `product_ids`, `recommendation_ids`, both, or neither.
-8. **Ask for Topic `generation_mode` before any `produce` write** — present the
-   six modes; recommend `demand` when Need-led; do not silently assume.
-   Product/recommendation inputs do not prove audience demand.
-9. **Scan stages Hits, not Needs/Topics** — default keyword scan is
-   `track=listen` only → `hits/` (`triage`); route to `needs/` or library
-   only after confirm. `search` = SEO, `ask` = GEO questions — not default
-   social scan. Hits are never Topic inputs.
-10. **Generate keywords from evidence** — propose listen/search/ask candidates
-    from Needs/audience in chat; write `keywords.md` only after confirm;
-    set `seed_from`. Google volume never gates listen.
-
-Topic modes (ask before `produce`; recommend `demand` when Need-led):
-
-```text
-demand             = Needs + Profile
-demand_to_offer    = Needs + Product + Profile
-demand_to_review   = Needs + Recommendation + Profile
-review             = Recommendation + evidence + Profile
-offer_education    = Product + mechanism + Profile
-profile_thesis     = Profile + Pillar
-```
+1. **No invented facts or quotes** — slot text and Beat plans come from knowledge pages only; gaps go in **Do not claim**.
+2. **No hook → no topic.** Never invent `H-` / `F-` ids; read them from `easysociable hooks list` / `formulas get`.
+3. **Knowledge is compiled, not re-derived** — ingest updates every touched page, records contradictions instead of overwriting, regenerates `knowledge/index.md`, appends `knowledge/log.md`.
+4. **Runs follow the Formula** — same beat count, order and roles; `layoutFamilyId = look.slides[n] ?? look.layouts[role]`.
+5. **Rebuild workbench** after markdown writes in the engine vault (`python3 workbench/build.py`); after knowledge writes also `python3 scripts/lint-knowledge.py --engine .`.
+6. Hook link for the user: `https://easysociable.com/hooks/<hook_id>`.
 
 ## Create / serve / build
 
@@ -102,56 +72,39 @@ repo into `<parent>/Content Engine` (never overwrites an existing engine).
 ```bash
 easysociable engine serve --engine <parent>/Content Engine --no-open
 easysociable engine build --engine <parent>/Content Engine
-# --sync-workbench refreshes workbench files from the public core checkout
 ```
 
-On a dedicated agent computer (e.g. Grok Bot), prefer `/workspace` + clone or
-`engine init`. Mixed→split vault: see `scripts/migrate-split-vault.py` in the
-public repo.
-
-`python3` is required for the workbench. Observatory: `http://127.0.0.1:8765/workbench/` — top tabs include **需求库 / Needs**. If `serve.py` is already up, do not start a second server; rebuild only.
-
-Engine methodology updates: `git pull` on the core (or `--sync-workbench`), not
-CLI republishes.
+`python3` is required for the workbench. Observatory: `http://127.0.0.1:8765/workbench/` — tabs **Knowledge** (graph) / Topics / Runs. If `serve.py` is already up, do not start a second server; rebuild only.
 
 ## Operate
 
 1. Resolve account → profile (engine `CLAUDE.md`).
 2. Route by intent (table below). Prefer engine `CLAUDE.md` sections; use `workflows/*` when that file is newer or the § is missing.
-3. Always return the structured chat card the section defines.
+3. Always return a short result card in chat.
 4. Rebuild workbench after writes.
 
 | Intent | Action |
 |--------|--------|
 | 采访我 / interview me / 完善人设 / 建立 profile | **workflows/INTERVIEW.md** (not a render) |
-| 记需求 / 用户原话 / capture audience quotes / 调研需求 / 需求落库 | **workflows/NEEDS.md** (not a render) |
-| 加关键词 / 生成 listen\|search\|ask 词 / 扫关键词 / 路由 Hit | Engine **§ Keywords** + **§ Hits** — three-track recipes; scan listen→Hits |
-| 更新产品 / 产品库 / product facts | Engine **§ Products** — update owned offer facts and dated pricing |
-| 推荐产品 / 评测工具 / compare or review | `recommendations/` — collect evidence and disclosure before Topic |
-| 扫需求选题 | **NEEDS.md** then Topics from `needs/` `status=captured` — **ask `generation_mode` first** |
-| 做成选题 / 生成 topic | engine **§ Topics** — explicit input; **ask `generation_mode` before write** |
-| 开一单 / 用 T-… 开一单 | engine **§ Open a run** (ask platform; multi → N runs) |
-| 1 page / `media_mode=single_visual` | **easysociable-template** (after hard gate) |
-| 2+ pages / `media_mode=multi_page_pack` (any platform, incl. X + `pack_hook`) | **easysociable-slideshow** (after hard gate + **ADR-0036 identity chain**: Studio login → API key → `easysociable auth login` → create) |
-| X / xiaohongshu text-only | No render skill — ship copy from the Run |
+| 记一下 / 存资料 / ingest + link or file | Engine **§ Knowledge · Ingest** |
+| 问知识库 / what do we know about X | Engine **§ Knowledge · Query** (offer to file back as `synthesis`) |
+| lint 知识库 / 整理知识 | Engine **§ Knowledge · Lint** |
+| 列出 hooks / 选 hook / 用 H-… 生成选题 | Engine **§ Topics** |
+| 开一单 / 用 T-… 开一单 | Hard gate → engine **§ Open a run** (ask platform; multi → N runs) |
+| 1 page | **easysociable-template** with `Formula: <id>` (after hard gate) |
+| 2+ pages (any platform) | **easysociable-slideshow** *Formula handoff* (after hard gate + **ADR-0036 identity chain**: Studio login → API key → `easysociable auth login` → create) |
+| X / xiaohongshu text-only | No render skill — ship copy from `content.md` |
 
 ## Render hard gate
 
-**Before any template/slideshow call:** Identity in `profiles/<active>/voice.md` — Role / What I build / Point of view — no `(fill)` and non-empty; `boundaries.md` exists with Not covering and Never claim both non-empty. If `needs/` exists, `needs/_index.md` ≥ **3** `N-` rows; if `needs/` is absent, skip that count. Public handle MAY stay `(fill)`.
+**Before any template/slideshow call:** Identity in `profiles/<active>/voice.md` — Role / What I build / Point of view — no `(fill)` and non-empty; `boundaries.md` exists with Not covering and Never claim both non-empty. Public handle MAY stay `(fill)`.
 
 On fail: **stay in this skill**. List missing files. Do not call template or slideshow. User must say **强制继续** / **force continue** to proceed.
 
 ```bash
-easysociable engine validate --run <run-dir> --require-pack --require-knowledge
+easysociable engine validate --root <engine> --require-knowledge
 ```
 
-Slideshow packs need an **Arc** line, then **Page Contracts** (no `templateId`), then Media, then Template Selection. Do not default Cover → Point → Steps → Recap → CTA. Page 1 is cover/hook class; later pages are not. Handoff: **easysociable-slideshow** (`references/ARC.md`). Validate with `python3 scripts/validate-pack.py`.
-
-## Research (Needs)
-
-- Prefer host research tools. On **X**: built-in `x_*` first; fall back to agent-reach / `twitter` only if insufficient.
-- Store **commenter** words when scraping threads. Do not invent `N-` when a platform tool is missing—stop and ask for paste.
-
 ## Out of scope
 
 No social posting, Content MCP, Local API, or SQLite content library.

package/skills/easysociable-content/workflows/INTERVIEW.md

@@ -2,7 +2,7 @@
 
 Not a fourth skill. If the engine `CLAUDE.md` already has **§ Interview**, follow that section. Otherwise follow this file.
 
-Do **not** ingest needs / quotes here. Do **not** scan the watchlist. Do **not** create a slideshow or call template/slideshow.
+Do **not** ingest sources into Knowledge here. Do **not** create a slideshow or call template/slideshow.
 
 ## Triggers
 
@@ -59,9 +59,9 @@ Do **not** ingest needs / quotes here. Do **not** scan the watchlist. Do **not**
 
 | Level | Condition | Behavior |
 |-------|-----------|----------|
-| **Hard gate** (refuse slideshow handoff / `create_run`) | Identity **only** Role / What I build / Point of view have no `(fill)` and are non-empty (Public handle and Not claiming MAY stay `(fill)` / starter copy) **and** `boundaries.md` exists with Not covering **and** Never claim both non-empty. If `needs/` exists, also `needs/_index.md` ≥ 3 `N-` rows; if `needs/` is absent, skip that count. | Refuse 出图 / PagePack handoff / `slideshows create`. List missing files. User must say **强制继续** / **force continue** to proceed. |
-| **First-session goal** | Hard gate **and** Persona has at least one personalized line **and** needs **target 5** (under 5 still passes the hard gate) **and** `stories.md` may be 0–1 | Open card `profile: partial`. May 扫需求选题. Still no graphics unless forced. |
-| **Complete seven dimensions** | Identity + Experience (≥2) + Values (≥3) + Persona/Do not say + `stories.md` ≥1 + `boundaries.md` + `expression.md` likes/dislikes ≥3 each + needs ≥5 | Open card `profile: complete`. Remaining gaps are draft reminders only — **not** a hard-stop on graphics. |
+| **Hard gate** (refuse slideshow handoff / `create_run`) | Identity **only** Role / What I build / Point of view have no `(fill)` and are non-empty (Public handle and Not claiming MAY stay `(fill)` / starter copy) **and** `boundaries.md` exists with Not covering **and** Never claim both non-empty. | Refuse 出图 / run handoff / `slideshows create`. List missing files. User must say **强制继续** / **force continue** to proceed. |
+| **First-session goal** | Hard gate **and** Persona has at least one personalized line **and** `stories.md` may be 0–1 | Open card `profile: partial`. May pick a hook and write Topics. Still no graphics unless forced. |
+| **Complete seven dimensions** | Identity + Experience (≥2) + Values (≥3) + Persona/Do not say + `stories.md` ≥1 + `boundaries.md` + `expression.md` likes/dislikes ≥3 each | Open card `profile: complete`. Remaining gaps are draft reminders only — **not** a hard-stop on graphics. |
 
 Experience / Values / expression are **not** the hard gate. Missing `stories.md` / `expression.md` = partial. Missing `boundaries.md` file = hard-gate fail.
 

package/skills/easysociable-content/workflows/NEEDS.md

@@ -1,99 +0,0 @@
-# Needs (audience quotes)
-
-Not a fourth skill. If the engine `CLAUDE.md` already has **§ Needs**, follow that section **unless this file is newer** — then this file wins for Needs-only rules.
-
-Do **not** invent quotes. Do **not** scan the watchlist to mint needs. Do **not** create a slideshow.
-
-## Triggers
-
-- 记需求 / 用户原话 / 评论导出
-- 扫需求选题
-- 扫关键词 / 用关键词扫需求 / 扫 K-xx（research only — see **Keyword scan** below）
-- capture audience quotes / user needs
-- 调研需求 / 需求落库 / 重新调研并落库
-
-## Research axis (easysociable-builder default)
-
-Product teaches **Content Engines**; EasySociable is the **visual layer**. When researching or screening needs for this profile:
-
-| Layer | Means | Default |
-|-------|--------|---------|
-| **L1** | System / sustainability — what to say, what to publish next, memory, pipeline, consistency | **Prefer** |
-| **L2** | Judgment / review / approval — AI polished but empty; bottleneck moved to human check | **Prefer** |
-| **L3** | Visual / tool friction — Canva, Figma, “looks AI”, brand kit paste | Keep only if user asks; else do not promote as primary |
-
-Put `layer=L1|L2|L3` in **`## Our gloss` only** — never in the index `quote` cell.
-
-**Reject:** course/toolkit CTAs, product demos dressed as pains, watchlist viral titles as quotes, Agent-paraphrased “quotes”, wrong-ICP “idk what to post” with no system angle.
-
-## Rules
-
-- Quote cell = **verbatim**. Gloss goes in `## Our gloss`, never in the index `quote` column.
-- Status is only `captured` | `promoted` | `retired`. **Never** `clustered`. Merge is not a new status.
-- Synonym merge: propose, wait for user yes, then keep the surviving `N-` as `captured`, `frequency += 1`, append a sighting. Retire a mistaken duplicate and note it on the surviving sighting. No hosted clustering.
-- Do not mark `promoted` without a `T-` whose `need_ids` contain this `N-`. `topic_ids` non-empty ≡ `promoted`.
-- Never write `N-` into topic `capture_id`.
-- Hard gate (graphics): once `needs/` exists, `needs/_index.md` needs ≥ **3** `N-` rows. First-session **target** is **5** (under 5 still passes the hard gate). Do not invent quotes to hit the number.
-- Quotes may include DMs / students. Keep local. Redact PII if used as published copy.
-- After Needs writes: rebuild workbench (`python3 workbench/build.py` or `easysociable engine build`).
-
-## Delete vs retire
-
-- `retired` = soft discard while the user may still want the row visible.
-- If the user says **删除 / 删掉 retired / 可以直接删了**: **delete** the entry file(s) and remove the index row(s). Do not leave ghost `retired` rows. Rebuild workbench.
-- Do not delete `captured` or `promoted` without an explicit ask.
-
-## Keyword generate (from Needs)
-
-When user asks to generate keywords from needs: follow engine **§ Keywords · Generate**.  
-Prefer `track=listen` seeds from verbatim Needs; propose in chat; write only on confirm with `seed_from=need:N-…`.  
-Optional: derive `search` (SEO) or `ask` (GEO question) pairs — not for default social scan.
-
-## Keyword / handle scan → Hits → route
-
-Load `profiles/<id>/keywords.md` (and/or `handles.md`).  
-Default scan: up to **5** rows with **`track=listen` + `status=active`** (or named `K-xx` / `@handle`). Prefer L1/L2 `pain`/`question`.
-
-Meaningful hits → write `hits/` (`H-…`, `status=triage`, `keyword_id`, heat when known) + chat cards.  
-**Needs / library only after route confirm** (engine **§ Hits**). Author posts are not Needs; comments may be. Structure/foil → library via Capture + ingest approval.
-
-On **X**: `x_*` first. Other platforms only with a working host backend; else ask for paste. Hits are never Topic inputs. Do not default-scan `search`/`ask` rows into Hits.
-
-## Ingest paths
-
-1. Pasted quote — 「记需求：……」 / “capture audience quotes: …”
-2. Comment / DM export or screenshot — extract quotes; one `N-` each; confirm with the user when unsure.
-3. URL / thread — fetch with host research tools; store the **commenter's** words, not the author's hook. On **X**: `x_*` first, then agent-reach if needed.
-4. After a consult — 「刚才那通咨询记需求」.
-5. Keyword / research pass — screen for L1/L2; **confirm** then write `N-` for verbatim hits; update `_index.md` research note briefly.
-
-Forbidden: Agent-rewritten sentences as quote; watchlist/keyword viral titles as need; FAQ templates with no original quote; silent batch write from a scan.
-
-## Write
-
-1. New `needs/entries/N-YYYYMMDD-XX.md` from `needs/_template.md`
-2. New row at the top of `needs/_index.md`
-3. Rebuild workbench
-4. Chat card:
-
-```text
-✅ Need N-YYYYMMDD-XX
-【Quote】 …
-【Source】 comment | dm | consult | faq | student | other
-【Layer】 L1 | L2 | L3
-【Frequency】 1
-【Stored】 needs/_index + needs/entries/N-….md
-【Merge】 new | merged into N-… (frequency now k, status still captured)
-```
-
-## 扫需求选题
-
-Input set: `needs/_index.md` rows with `status=captured` (`topic_ids` empty). Max **5** `produce`. Prefer L1/L2 glosses for this profile unless the user asks otherwise.
-
-Then **§ Topics**: Input gate Need ID `N-…`; `source_type=need`; `need_ids` lists the `N-` (never in `capture_id`); default `scout_label=demand`. **Before any `produce` write, ask the user to choose `generation_mode`** (six modes; recommend `demand` when Need-led). Still run hard filters and that mode’s required-input gate.
-
-When `produce` creates a `T-` from an `N-`: update `needs/_index.md` + the entry to `status=promoted` and `topic_ids` containing that `T-`. Discard / library: leave `captured` or `retired` — do not mark `promoted` without a T-.
-
-Audience exception (first activation): `source_type=need` **and** `need_ids` non-empty → matching at least one need gloss counts as one strong audience check; do **not** require a full ICP from `audience.md` / `pillars.md`. `ready` still needs `opp_score ≥ 7.5` **and** `audience ≥ 6`.
-
-Prefer scanning needs before inbox. Inbox is structure / competitor context.