@easysociable/cli 0.1.0 → 0.1.2

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

@@ -1,8 +1,17 @@
 # Local analysis notes
 
-Save source notes and evidence as Markdown under the selected Obsidian Run.
-Record missing context as a checklist in the Run; do not call a Content CLI,
-Local API or hosted analysis backend.
+Research before a topic or run exists. Capture still follows engine `CLAUDE.md` § Capture when the user is storing a source.
 
-Template and Slideshow Skills consume the resulting local Pack only after the
-Agent and user agree on the content.
+## Workflow
+
+1. Save sources under `raw/` + `raw/_index.md` when the capture has a URL / structure / media.
+2. Working notes: `inbox/entries/C-….md` + `inbox/_index.md`.
+3. Do not silent-write swipe/atoms/claims.
+4. Network tools are optional; never block on search.
+
+## Done when
+
+- Capture Card returned (if this was a capture)
+- Gaps listed as checklist items the user can answer
+
+Next: topics or 开一单 per `CLAUDE.md` — not a multi-platform draft in one folder.

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

@@ -1,19 +1,24 @@
 # Pack and export workflow
 
-The Content Skill writes a public `content-pack.v1` handoff. It does not choose
-private template internals and does not render images itself.
+The Content Skill records the run and verifies the local export. It does not render.
 
 ```text
-Obsidian Run
-  → platform Pack
-  → unified Template/Slideshow MCP or CLI
+one-platform run
+  → pack.md (slideshow, after SHIP)
+  → Slideshow/Template skill writes pack JSON / fill-slots
   → Studio preview
   → user confirmation
-  → final PNG render
-  → renders export
-  → locale exports/<slug>/<platform>/01.png + manifest.json
+  → PNG export
+  → {engine}/exports/<run-slug>/01.png + manifest.json
 ```
 
-For a single image, call the published Page Template flow. For multiple pages,
-call the Slideshow Run flow. Preview never consumes Render Page allowance;
-final rendering does.
+After export:
+
+```bash
+node scripts/validate-export.mjs \
+  --export <engine>/exports/<run-slug> \
+  --expected-pages <N> --json
+node scripts/validate-run.mjs --run <run-dir> --require-export --json
+```
+
+Set `runs/_index` `export=yes` only when the directory validates. Preview never consumes Render Page allowance; final rendering does.

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

@@ -0,0 +1,40 @@
+# Getting started
+
+After setup, the observatory is `http://127.0.0.1:8765/workbench/`. The user works in chat. The Agent writes markdown. Follow engine `CLAUDE.md`.
+
+## 1. Confirm the engine
+
+Read `Content Engine/engine.json` and `CLAUDE.md`. Replace starter `your-handle` / `profiles/default/` before the first serious draft.
+
+## 2. Optional local voice (skip allowed)
+
+Ask once whether to fill `profiles/default/voice.md`. This is **local copy persona** — not the hosted Brand Profile (`references/VOICE.md`). Setup must not call `easysociable profiles create`.
+
+## 3. One platform = one run (tracer)
+
+Walk one local loop before any hosted render:
+
+1. **Ask platform** if unset. One platform this time (e.g. `x` or `tiktok`).
+2. Copy `runs/_template/` → `runs/<YYYY-MM-DD-slug[-platform]>/`.
+3. Fill `idea.md` (platform + `swipe_id` / `atoms` / `claim_id`, `none` OK).
+4. Append a row on `runs/_index.md` (`status=open`).
+5. Read `platforms/<platform>.md`, then brief → packet → draft → editor → rubric.
+6. **x text:** stop at SHIP / READY_TO_POST. No Pack JSON.
+7. **Slideshow platform:** after SHIP write `pack.md`. Pack JSON waits for Slideshow handoff.
+
+Rebuild workbench after writes: `python3 workbench/build.py`.
+
+Watchlist scans write **Discovery** (`discovery/D-*.md`), not Topics. Promote a Discovery to a Topic only when the user names it.
+
+## 4. First render (when ready)
+
+- **Multi-page** → `easysociable-slideshow` writes `pack-<platform>.json`, then Studio → PNG.
+- **Single-page** → `easysociable-template`.
+
+PNGs land at `{engine}/exports/<run-slug>/`.
+
+## Done when
+
+- Workbench opens and shows the new run row.
+- User knows 开一单 asks platform(s) and splits N platforms into N folders.
+- User knows Pack JSON is a render handoff, not the default run file.

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

@@ -1,10 +1,5 @@
-# Obsidian-first workflow
+# Filesystem-first, then hosted MCP
 
-There is no Content MCP fallback in V1. Use local filesystem tools to set up or
-validate the existing Obsidian Vault, write the Run and platform Pack under
-`Content Engine/runs/<slug>/` or `内容引擎/成稿/<slug>/`, then use the unified EasySociable MCP for hosted
-Template/Slideshow operations. If the MCP is unavailable, use equivalent
-`easysociable` CLI commands.
+There is no Content MCP in V1. Use filesystem tools to write the engine, then the unified EasySociable MCP for hosted Template/Slideshow operations. If MCP is unavailable, use equivalent `easysociable` CLI commands.
 
-Never start a Local API, open SQLite or switch to the retired
-`easysociable-content` binary.
+Never start a Local API or open SQLite. Do not require Obsidian.

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

@@ -0,0 +1,18 @@
+# Out of scope (V1)
+
+This skill does not do:
+
+| Area | V1 boundary |
+|---|---|
+| Publication / social posting | User posts; Agent records URL + result |
+| UGC / SEO / PublicPiece | Deferred |
+| Hosted metrics backends | User-provided numbers in `feedback.md` only |
+| Device / iPhone automation | Not part of Content Skill |
+| Desktop app / browser extensions | Not part of Content Skill |
+| Content CLI / Content MCP / Local API | Use filesystem + workbench |
+| SQLite Content Engine | Not supported |
+| Obsidian install / vault detection | Not required |
+| Hosted Profile at setup | Create on first render via Slideshow/Template skill |
+| One run folder with many platform drafts | One platform = one run folder |
+
+If the user asks for any of the above, explain the boundary and offer the local Markdown alternative or hand off to the correct skill.

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

@@ -0,0 +1,42 @@
+# Pack authoring
+
+Vault-native pack is `pack.md` after rubric SHIP (slideshow platforms only).  
+`content-pack.v1` JSON is written by **easysociable-slideshow** at render handoff — not during draft.
+
+Full rules: engine `CLAUDE.md` § PagePack + render.
+
+## Vault pack
+
+1. This run is already one platform. Copy `_template/pack.md` → `pack.md` (or `pack-<platform>.md`).
+2. Public slots only. No private AST. No fake images.
+3. Show a Pack Card in chat.
+
+## Handoff JSON
+
+Slideshow selects a published Page Template per page, then writes:
+
+```json
+{
+  "schemaVersion": "content-pack.v1",
+  "platform": "tiktok",
+  "title": "From idea.md",
+  "pages": []
+}
+```
+
+Validate:
+
+```bash
+node scripts/validate-pack.mjs --file <run-dir>/pack-<platform>.json --platform <platform> --json
+node scripts/validate-run.mjs --run <run-dir> --require-pack --json
+```
+
+Pure X text: no pack. `x` / `xiaohongshu` image → Template skill, not a Content Pack.
+
+## Routing after SHIP
+
+| Condition | Hand off to |
+|---|---|
+| Single-page intent | `easysociable-template` |
+| Multi-page + slideshow platform | `easysociable-slideshow` |
+| `platform ∈ {x, xiaohongshu}` images | `easysociable-template` only |

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

@@ -0,0 +1,18 @@
+# Swipe capture
+
+Turn a reference post into a reusable **structure** under `swipe/`. Full rules: engine `CLAUDE.md` § Library ingest + § Swipe / atom library.
+
+## When
+
+User shares a URL / pattern **and** approves 入库 as swipe. Never silent-seed from a run.
+
+## Workflow
+
+1. Copy `swipe/_template.md` → `swipe/<slug>.md`. Default `status: trial`, n=win=loss=0.
+2. Add a row on `swipe/_index.md` (`profiles`, `platforms`, `form`, `one_liner`).
+3. **No Evidence table** in the swipe file. Use history = `published/_index`.
+4. Hit-status is `trial | working | dead` — not claim epistemology.
+
+If the user only said 记一下: **§ Capture** only, then library offer. Do not also open a run unless asked.
+
+Hand off to topics / 开一单 when the user wants production, not when capturing.

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

@@ -1,5 +1,29 @@
-# Topic and draft notes
+# Topic draft
 
-Never invent hosted IDs. V1 has no publication endpoint; call a draft complete
-only when the local Run and platform Pack have been written to the Obsidian
-Vault.
+Score **what to produce**. Full rules: engine `CLAUDE.md` § Topics + `topics/scoring.md`.
+
+Watchlist scans do **not** create Topics. They create Discovery records (`CLAUDE.md` § Discovery). Topic scoring starts only when the user names an explicit input (Discovery ID, Capture ID, URL, or idea).
+
+## Pipeline
+
+```text
+explicit input → hard filters → Scout → (produce only) opportunity 5-dim → dual-gate verdict
+```
+
+1. Hard filters (`topics/scoring.md`). Fail → skip or `parked`.
+2. **Scout gate** — set `purpose` (`discard` \| `library` \| `produce`) + `scout_label`.  
+   Default bias: **discard**. Cap **5 `produce`** per promotion session.
+3. If `produce`: fill context / audience / conflict / insight / evidence fields, then score those five dims → `opp_score`.  
+   `ready` = opp ≥ **7.5** **and** audience ≥ **6**.  
+   Conflict > 5 requires a written `current_belief` and `belief_gap`.
+4. If `library`: optional light item with `status: library`, or capture offer only — never `ready`.
+5. Write `topics/items/T-YYYYMMDD-XX.md` from `_template-item.md`; add row on `topics/_index.md` (`opp` `aud` `purpose` `scout` + `src_*` when external).
+6. Output **Opportunity Card** in chat.
+
+Suggested swipe/atoms/claim on the topic are **not** citations. Citations happen in `idea.md` when a run opens.
+
+## Topic → run
+
+On `用 T-xxx 开一单`: **ask platform(s)** if unset. Create **one run per platform**, same `topic_id`. Mark topic `promoted`. List all RUN ids on the topic `run` column. Inherit opportunity fields into `brief.md`.
+
+Do not put multiple platforms in one run folder.

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

@@ -1,10 +1,19 @@
-# Local working draft
+# Working draft
 
-V1 has no Working Draft CLI or Content MCP. Store the working draft as
-Markdown/JSON inside the locale run folder (`Content Engine/runs/<slug>/` or
-`内容引擎/成稿/<slug>/`), then
-write the platform Pack before handing off to the Template or Slideshow Skill.
+Write copy for **this run’s platform only**. Full gates: engine `CLAUDE.md` § Open a run.
 
-Never treat a local draft as a final render. The final checkpoint is the PNG
-and `manifest.json` written by the unified `easysociable` CLI after the user
-confirms the Studio preview.
+## Path
+
+```text
+Content Engine/runs/<YYYY-MM-DD-slug[-platform]>/
+```
+
+## Workflow
+
+1. Load `platforms/<platform>.md` (required; `instagram` → `ig.md`).
+2. Selection already in `idea.md` (`none` allowed with why).
+3. Brief OK → `packet.md` → `draft.md` (this platform) → `editor.md` → `rubric.md`.
+4. Align with `profiles/<id>/voice.md` + audience **core + this platform**.
+5. Do **not** write `pack-<platform>.json` here. Image decks: `pack.md` only after SHIP.
+
+Sibling runs for the same topic each re-read their own craft file. No paste-across.

package/skills/easysociable-slideshow/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: easysociable-slideshow
 description: >
-  Create and review temporary multi-page Slideshow Runs for EasySociable from a
-  local Obsidian Content Pack. Use the unified `easysociable` CLI or MCP, open
-  Studio for preview, and perform final PNG rendering only after confirmation.
-  There is no Slideshow Template product, UGC publishing, social posting or
-  separate Slideshow CLI/MCP in V1.
+  Create, list, update and review durable multi-page Slideshow Runs for
+  EasySociable from a local Obsidian Content Pack. Use the unified
+  `easysociable` CLI or MCP, open Studio for preview, and perform final PNG
+  rendering only after confirmation. Runs remain in the owner dashboard until
+  archive/trash. There is no Slideshow Template product, UGC publishing,
+  social posting or separate Slideshow CLI/MCP in V1.
 ---
 
 # EasySociable Slideshow Skill
@@ -27,8 +28,8 @@ It is not a reusable Carousel/Deck Template and it is not a public post.
    in Studio.
 6. Studio is preview-only. It has no final download, publish, unpublish, UGC,
    SEO/GEO or social-posting action.
-7. Agent revisions update the same unexpired Run. Studio activity extends the
-   seven-day TTL. Expired Runs are not recoverable through the public API.
+7. Before creating a new Run for an existing content intent, list/find prior Runs
+   by `contentSlug` and update the same Run when possible.
 8. Preview is free but rate/concurrency limited. Final rendering is PNG-only,
    uses one atomic reservation for all pages and charges only when every page
    succeeds.
@@ -38,15 +39,21 @@ It is not a reusable Carousel/Deck Template and it is not a public post.
 1. Validate the Pack and platform/page count.
 2. Resolve or create the user's Profile/Theme through the unified CLI/MCP.
 3. Select a compatible published Page Template for every page.
-4. Call:
+4. List existing Runs when the Pack has a stable content slug:
+
+   ```bash
+   easysociable slideshows list --content-slug my-post --json
+   ```
+
+5. Create or update:
 
    ```bash
    easysociable slideshows create --file ./pack.json --json
    ```
 
-5. Open the returned `studioUrl` and inspect every page.
-6. Save Studio edits and wait for the saved revision.
-7. After explicit confirmation, call:
+6. Open the returned `studioUrl` and inspect every page.
+7. Save Studio edits and wait for the saved revision.
+8. After explicit confirmation, call:
 
    ```bash
    easysociable slideshows render --id run_xxx --idempotency-key run_xxx-final-1 --json
@@ -60,7 +67,7 @@ It is not a reusable Carousel/Deck Template and it is not a public post.
 
 8. Verify checksums and the reconstruction `manifest.json` in the Obsidian
    Run export. The export is the local final deliverable; cloud artifacts expire
-   after 24 hours.
+   after 24 hours while the Run remains listed for the owner.
 
 ## Failure handling
 
@@ -68,7 +75,7 @@ It is not a reusable Carousel/Deck Template and it is not a public post.
   error to the Agent; do not substitute another template.
 - If any final page fails, there is no partial final set and no page charge.
 - Retry the same final request with the same idempotency key to reuse the Job.
-- If the Run is expired, create a new Run from the Pack.
+- If a Run was trashed, create a new Run from the Pack.
 
 ## Handoff boundary
 

package/skills/easysociable-slideshow/references/VAULT.md

@@ -1,18 +1,20 @@
 # Obsidian export
 
-The local Obsidian Run folder is the final delivery mirror:
+Final PNGs are written at the **engine root exports directory**:
 
 ```text
-Content Engine/            or  内容引擎/
-└── runs/<slug>/           or  成稿/<slug>/
-    └── exports/<slug>/<platform>/   or  导出/<slug>/<platform>/
-        ├── 01.png
-        ├── 02.png
-        └── manifest.json
+Content Engine/exports/<slug>/<platform>/     (en)
+内容引擎/导出/<slug>/<platform>/               (zh)
+    ├── 01.png
+    ├── 02.png
+    └── manifest.json
 ```
 
-Read `locale.json` in the engine root (`en` or `zh`) and use that tree. Pack JSON keys stay English.
+Semantic work and Packs stay under `runs/<slug>/` or `成稿/<slug>/`. Do not
+write PNGs inside the run folder.
 
-The CLI verifies checksums and atomically replaces this directory only after a
-complete atomic Hosted Render succeeds. No ZIP is created. The cloud artifact
-may expire after 24 hours; the local PNGs remain the user's files.
+Read `locale.json` in the engine root. Pack JSON keys stay English.
+
+The CLI verifies checksums and atomically replaces the export directory only
+after a complete atomic Hosted Render succeeds. No ZIP is created. Cloud
+artifacts may expire after 24 hours; local PNGs remain the user's files.

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

@@ -1,5 +0,0 @@
-# Deferred in V1
-
-Device automation, iPhone publishing, Desktop tasks and Local API workflows are
-not part of the V1 Content Skill. Do not invoke or document them as fallback
-paths. Keep this file as a migration marker only.

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

@@ -1,6 +0,0 @@
-# Deferred in V1
-
-Experiments, hypotheses, metrics and proposal activation are retained only as
-historical documentation. The V1 Content Skill does not expose these commands
-or a backend. Write any future notes as ordinary Markdown in the Obsidian
-Vault; do not create hosted experiment records.

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

@@ -1,5 +0,0 @@
-# Deferred in V1
-
-V1 does not provide publication, social posting, metrics, retrospectives or
-UGC/SEO projections. Keep the generated Pack and final PNG export in the local
-Obsidian Run; do not call a retired `easysociable-content` command.