@easysociable/cli 0.1.1 → 0.1.3

package/content-engine/starter/profiles/default/audience.md

@@ -0,0 +1,38 @@
+# Audience — profile `default`
+
+**Role:** Who this profile writes for.  
+**Not:** Platform craft (`platforms/*.md`).
+
+## Cross-platform core
+
+### Primary readers
+
+1. (fill)
+
+### Not for
+
+- (fill)
+
+### Jobs to be done
+
+1. (fill)
+
+## Per-platform emphasis
+
+Fill the section for **this run’s platform** before drafting. Sibling platforms get their own run.
+
+### x
+
+- (fill)
+
+### linkedin
+
+- (fill)
+
+### ig
+
+- (fill)
+
+### tiktok
+
+- (fill)

package/content-engine/starter/profiles/default/pillars.md

@@ -0,0 +1,33 @@
+# Content pillars — profile `default`
+
+Agent: map every draft topic to at least one pillar (or user overrides for one post).
+
+## Status
+
+`active`
+
+## Pillars
+
+### P1 — (name this pillar)
+
+**Job:** (one sentence)
+
+Talk about:
+
+- (fill)
+
+### P2 — (name this pillar)
+
+**Job:** (one sentence)
+
+Talk about:
+
+- (fill)
+
+### P3 — (name this pillar)
+
+**Job:** (one sentence)
+
+Talk about:
+
+- (fill)

package/content-engine/starter/profiles/default/voice.md

@@ -0,0 +1,24 @@
+# Voice — profile `default`
+
+**Role:** Who this profile is + how copy should sound.  
+**Not:** Topics (`./pillars.md`), platform craft (`../../platforms/*.md`), or readers (`./audience.md`).
+
+## Identity (who is speaking)
+
+| Field | Value |
+|-------|--------|
+| **Public handle** | (fill) |
+| **Role** | (fill) |
+| **What I build** | (fill) |
+| **Point of view** | (fill) |
+| **Not claiming** | Invented metrics, customers, quotes, or team size |
+
+## Persona
+
+- Direct. Concrete nouns. Address the reader as **you**.
+- Do not invent bio facts not listed in Identity.
+
+## Do not say
+
+- Fake social proof
+- Empty hype (“game-changer”, “unlock your potential”)

package/content-engine/starter/published/_index.md

@@ -0,0 +1,20 @@
+# Published index
+
+**Role:** One row per **shipped post** (one platform URL).  
+**Also:** use history for swipe / atom (join on `swipe` / `atoms`). Claim **proposition** evidence still lives in the claim file’s Evidence table.
+
+Same **topic** may appear across **multiple runs / multiple published rows**. One **run** → usually **one** published row.
+
+## How to use
+
+- On ship: add a row; update that run’s `runs/_index` → `published`.
+- Then bump `n`/`win`/`loss` on cited index rows (`CLAUDE.md` § Catalog evidence).
+- Swipe/atom: this table **is** the ledger. Claim: also append the claim file Evidence row (`vs claim`).
+- `result`: `win` | `flat` | `loss` | `unknown`.
+
+## Catalog
+
+| date | platform | url | run | pillar | swipe | atoms | claim | result | notes |
+|------|----------|-----|-----|--------|-------|-------|-------|--------|-------|
+
+<!-- Agent: prefer newest on top -->

package/content-engine/starter/raw/README.md

@@ -0,0 +1,4 @@
+# raw/
+
+Authoritative sources. Registry: **`_index.md`**.  
+Bodies: `YYYY-MM-DD-short-slug.md`.

package/content-engine/starter/raw/_index.md

@@ -0,0 +1,12 @@
+# Raw index
+
+Authoritative source materials. Bodies are files in this folder; this table is the registry.
+
+| id | date | capture_id | file | type | source_url | one_liner |
+|----|------|------------|------|------|------------|-----------|
+
+## Agent rules
+
+- Create a raw **file** + this row when capture has URL, multi-step structure, media, or user marks important
+- `capture_id` must match `inbox/_index` id
+- Do not use raw as finished posts

package/content-engine/starter/runs/README.md

@@ -0,0 +1,22 @@
+# runs/
+
+One folder per **platform run** (“一单”). Same Topic, native rewrite for another network → **another folder**, same `topic_id`.
+
+| Path | Role |
+|------|------|
+| `_index.md` | Job queue registry (Approach B scan) |
+| `_template/` | Files copied into each new run |
+| `YYYY-MM-DD-short-slug[-platform]/` | One platform draft |
+
+**Agent** creates/updates files and `_index`; user works in chat only.
+
+See vault root `CLAUDE.md` § Open a run.
+
+## Multi-platform
+
+- Multi-select on 开一单 → **N runs**, not N sections in one draft.  
+- `idea.md`: `primary_platform` = `platforms` = this run only.  
+- Before brief/draft: **read** `platforms/<platform>.md` (see `platforms/README.md`).  
+- `draft.md`: this platform’s copy only, following that craft file.  
+- Pack: `pack.md` (or `pack-<platform>.md`); exports → `exports/<slug>/`.  
+- Each ship → one `published/_index` row for that `run_id`.  

package/content-engine/starter/runs/_index.md

@@ -0,0 +1,41 @@
+# Runs index (production jobs)
+
+One row = one **platform run** (one folder). Same Topic on multiple platforms = **multiple rows** sharing `topic_id` — **not** one folder with many platform variants.
+
+Newest on top. Agent updates on open / status change / export / kill.
+
+| run_id | path | date | status | account | profile | primary_platform | platforms | topic_id | pillar | one_liner | pack | export | notes |
+| ------ | ---- | ---- | ------ | ------- | ------- | ---------------- | --------- | -------- | ------ | --------- | ---- | ------ | ----- |
+
+## Status values
+
+| status       | Meaning                                          |
+| ------------ | ------------------------------------------------ |
+| `open`       | Folder created; brief not done                   |
+| `brief`      | Brief wait / in progress                         |
+| `draft`      | Drafting / editing                               |
+| `scored`     | Rubric done; ship or hold                        |
+| `ready`      | SHIP — copy ready to post (and/or pack ready)    |
+| `published`  | This platform shipped (or user declared done)    |
+| `hold`       | Rubric hold / blocked                            |
+| `killed`     | Abandoned                                        |
+| `superseded` | Replaced by another run                          |
+| `partial`    | **Legacy** — do not use for new runs             |
+
+## Columns
+
+| Column | Meaning |
+|--------|---------|
+| `path` | Wikilink to run folder |
+| `primary_platform` | **This** run’s platform (craft + publish target) |
+| `platforms` | Must equal `primary_platform` (single value; index compat) |
+| `pack` | `no` \| `yes` (image pack written for this run) |
+| `export` | `no` \| `yes` (files under `exports/<slug>/`) |
+| `topic_id` | `T-…` or none (siblings share the same id) |
+
+## Rules
+
+- On **开一单**: **ask platform(s)** if unset; **one folder + one row per platform**; `status=open`.
+- On status change: update this table (source of truth for queue scan).
+- On ship: row in **`published/_index`** + here → `published`.
+- Do not store draft body or image binaries here.

package/content-engine/starter/runs/_template/brief.md

@@ -0,0 +1,66 @@
+---
+status: BRIEF_WAIT
+gate_score: 0
+gate_pass: false
+---
+
+# Brief
+
+## Inherited (from Topic T-xxx — do not re-derive; sharpen only)
+
+- **context:**
+- **audience:**
+- **conflict:**
+- **insight:**
+
+## Claim
+
+- **core_thesis:**
+- **supporting_claims:**
+  1.
+  2.
+  3.
+
+## Evidence
+
+- **sources:**
+- **type:** data | example | case | mechanism | expert | observation
+- **quality:** weak | moderate | strong
+
+## Communication
+
+- **angle:**
+- **format:**
+- **hook:**
+- **structure:**
+
+## Outcome
+
+- **belief:**
+- **action:**
+- **emotion:**
+
+## Constraints
+
+- **must_include:**
+- **must_avoid:**
+
+## Selection (required; none allowed)
+
+- **swipe:** id | none — why:
+- **atoms:** hook:… | cta:… | proof:… | none — why:
+- **claim:** id | none — why:
+
+## Brief quality gate
+
+| # | Gate | Score 1–5 | Note |
+|---|------|-----------|------|
+| 1 | Thesis clarity | | |
+| 2 | Evidence strength | | |
+| 3 | Angle originality | | |
+| 4 | Structure coherence | | |
+| 5 | Outcome specificity | | |
+| 6 | Tension preservation | | |
+
+**Total:** /30
+**Gate:** PASS (≥24) | REVISE (20–23) | STOP (<20)

package/content-engine/starter/runs/_template/draft.md

@@ -0,0 +1,11 @@
+---
+status: DRAFTED
+---
+
+# Draft
+
+Copy for **this run’s platform only**. Re-read `platforms/<platform>.md` before writing. Do not paste sibling-run copy unchanged.
+
+## Post 1
+
+## Post 2 (optional)

package/content-engine/starter/runs/_template/editor.md

@@ -0,0 +1,18 @@
+---
+status: EDIT_WAIT
+verdict: REVISE | APPROVE
+---
+
+# Editor report
+
+## Must fix
+
+1.
+
+## Optional
+
+1.
+
+## Verdict
+
+REVISE | APPROVE

package/content-engine/starter/runs/_template/feedback.md

@@ -0,0 +1,15 @@
+---
+status: empty
+---
+
+# Feedback (after publish)
+
+This run is one platform. One URL → one `published/_index` row.
+
+## This platform
+
+- **url:**
+- **result:** win | flat | loss | unknown
+- **metrics:** (user-provided only)
+- **vs claim:** support | contradict | unclear | n/a
+- **notes:**

package/content-engine/starter/runs/_template/idea.md

@@ -0,0 +1,27 @@
+---
+run_id: RUN-YYYYMMDD-slug
+status: RUN_OPEN
+created: YYYY-MM-DD
+---
+
+# Idea
+
+- **one_liner:**
+- **account:** your-handle
+- **profile:** default
+- **pillar:** P1 | P2 | P3
+- **primary_platform:** x
+- **platforms:** x
+  <!-- must equal primary_platform (one platform per run) -->
+- **topic_id:** none | T-…
+- **capture_ids:** none | C-…
+- **swipe_id:** none | S1
+- **atoms:** none | hook:A-… cta:A-…
+- **claim_id:** none | C-…
+- **hypothesis:** none | (optional one-off test; prefer claim_id when in catalog)
+
+## Platform (this run)
+
+| platform | copy | images (pack) | publish status |
+|----------|------|---------------|----------------|
+| x | yes | no | pending |

package/content-engine/starter/runs/_template/pack.md

@@ -0,0 +1,47 @@
+---
+# PagePack — this run is already one platform (image decks only; not pure x text)
+# Prefer filename: pack.md (or pack-<platform>.md)
+# Create when: user wants carousel/slideshow AND rubric SHIP for this run.
+---
+status: unused
+id:
+platform: linkedin
+deck_hint:
+page_count: 0
+---
+
+# Pack
+
+## Meta
+
+- **run_id:**
+- **pillar:**
+- **swipe_id:**
+- **claim_id:**
+- **language:** en
+
+## Pages
+
+<!-- Each page: role + slots. Text only — no private AST. -->
+
+### page 1
+
+- **role:** cover
+- **slots:**
+  - title:
+  - subtitle:
+
+### page 2
+
+- **role:** body
+- **slots:**
+  - heading:
+  - body:
+
+<!-- …repeat through page_count… -->
+
+## Render
+
+- **job_id:**
+- **export_path:** exports/<run-slug>/<platform>/
+- **status:** not_requested | queued | done | failed

package/content-engine/starter/runs/_template/packet.md

@@ -0,0 +1,25 @@
+---
+# Writer context packet — keep short (~400–900 tokens of substance)
+# Filled by Agent from pillars slice + platforms rules + one swipe + this brief only
+---
+
+# Packet
+
+## Profile / account
+
+- account:
+- profile:
+
+## Pillar slice
+
+## Voice (resolved)
+
+## Audience (profile audience — core + this platform)
+
+## Craft notes (from platforms/<platform>.md — required; summarize rules used)
+
+## Swipe beats (if any)
+
+## Brief essentials
+
+## Hard bans

package/content-engine/starter/runs/_template/rubric.md

@@ -0,0 +1,19 @@
+---
+status: SCORED
+total: 0
+ship: false
+---
+
+# Rubric (max 12, ship if ≥ 8)
+
+| # | Criterion | Score 0–2 | Note |
+|---|-----------|-----------|------|
+| 1 | Stop-scroll hook | | |
+| 2 | Concrete (not empty wisdom) | | |
+| 3 | Save / act potential | | |
+| 4 | Platform-native (this run) | | |
+| 5 | Non-slop | | |
+| 6 | Fits pillar | | |
+
+**Total:** /12  
+**Gate:** SHIP (≥8) | HOLD (<8)

package/content-engine/starter/swipe/_index.md

@@ -0,0 +1,27 @@
+# Swipe index (structure catalog)
+
+**Role:** Full-post beat order. Global library; scope with **`profiles`** + **`platforms`** columns.
+
+**Selection:** read this table first → filter platform + profile → drop `dead` → prefer `working` then higher `win/n` → open 0–1 body. **`none` allowed** (declare why).
+
+## Status (hit-rate, our posts — not “is this true”)
+
+| status | Meaning |
+|--------|---------|
+| `trial` | In catalog; not enough of **our** published uses |
+| `working` | Our reuse is helping; prefer in selection |
+| `dead` | Never auto-select |
+
+`n` / `win` / `loss` = our `published.result` cache. `flat` and `unknown` bump `n` only.  
+**No Evidence table in swipe files.** Use history = `published/_index` (column `swipe`).
+
+## Ingest
+
+See `CLAUDE.md` § Library ingest. No silent seed from runs. Unpublished runs never enter.
+
+## Catalog
+
+| id | file | platforms | profiles | form | beats_or_pages | status | n | win | loss | one_liner | source |
+|----|------|-----------|----------|------|----------------|--------|---|-----|------|-----------|--------|
+
+`profiles: *` = available to all profiles.

package/content-engine/starter/swipe/_template.md

@@ -0,0 +1,34 @@
+---
+id: S-NEW
+platforms: [x]
+profiles: ["*"]             # profile ids or "*"
+form: short_post          # short_post | thread | carousel | slideshow
+beats_or_pages: 0
+status: trial             # trial | working | dead
+tags: []
+---
+
+# Title
+
+## When to use
+
+- …
+
+## When to avoid
+
+- …
+
+## Beats / pages (structure only — no full copy)
+
+1. …
+2. …
+
+## Constraints
+
+- …
+
+## Source
+
+- capture / raw links if any
+
+<!-- Use history: published/_index column swipe. Do not add ## Evidence here. -->

package/content-engine/starter/topics/README.md

@@ -0,0 +1,25 @@
+# topics/
+
+Topic system: **what to produce next**, after an external signal has been understood and converted into an owned opportunity.
+
+| Path | Role |
+|------|------|
+| `_index.md` | Queue registry (one row per topic + `item` link + source engagement) |
+| `items/T-*.md` | One file per opportunity (context, audience, conflict, insight, evidence) |
+| `WATCHLIST.md` | Watchlist router (per-profile scheme B) |
+| `watchlists/<profile_id>.md` | Profile-scoped radar |
+| `watchlists/_shared.md` | Shared radar for all profiles |
+| `scoring.md` | Opportunity dimensions and dual gate |
+| `_template-item.md` | Template for new items |
+
+Flow:
+
+```text
+watchlist → Discovery (Source Digest)
+  → user explicitly promotes
+  → `_index` + `items/T-…` (opportunity 5-dim)
+  → ready only if opp≥7.5 and audience≥6
+  → user opens run → `status=promoted`
+```
+
+Cap **5 produce** per promotion session. Watchlist scan itself creates Discovery records, not Topics.

package/content-engine/starter/topics/WATCHLIST.md

@@ -0,0 +1,65 @@
+# Watchlist (router)
+
+**Scheme B:** one radar table **per profile**, not one global table.
+
+No X Private List required. Agent updates files under `topics/watchlists/`; user works in chat only.
+
+## File map
+
+| Path | Role |
+|------|------|
+| `topics/WATCHLIST.md` | **This file** — routing, columns, scan rules |
+| `topics/watchlists/_shared.md` | Shared rows (`*`) — merge into every scan |
+| `topics/watchlists/<profile_id>.md` | Profile-scoped radar (must match `profiles/_index` id) |
+| `topics/watchlists/README.md` | Short folder note |
+
+### Profiles with a watchlist file today
+
+| profile_id | file |
+|------------|------|
+| default | `watchlists/default.md` |
+
+New profile → create `watchlists/<id>.md` (copy empty table header from `_shared.md` or an existing file).
+
+## Columns (in each table file)
+
+| Column | Meaning |
+|--------|---------|
+| `#` | Id within that file (`#1…` profile-local; `#S-01…` in `_shared`) |
+| **`platform`** | Network of this handle + where Agent scans: `x` \| `tiktok` \| `linkedin` \| `ig` \| `youtube` \| `xhs` \| `threads` \| … |
+| `handle` | Platform-native id without `@` |
+| `niche_tag` | Topic/product tag — not a substitute for `platform` |
+| `why_on_list` | One line |
+| `weight` | 0.5–1.5 |
+| `status` | active / paused / removed |
+
+**No `profiles` column in the table** — the **filename** is the profile scope.  
+Shared across profiles → put the row in `_shared.md` (same as `*`).  
+Same handle needed by two profiles only (not all) → **copy the row into both files** (or later a small group file; avoid until needed).
+
+## Resolve profile for scan / add (required)
+
+1. User names **profile_id** → use it.  
+2. User names **account** handle → resolve via `accounts/_index.md` → `profile_id`.  
+3. User names **neither** → **do not default**. List active profiles from `profiles/_index.md` and **ask which profile** (or account).  
+4. Load rows = **`watchlists/_shared.md` (active)** ∪ **`watchlists/<profile_id>.md` (active)**.  
+5. Filter **`platform`**: user-specified, else default **`x`**; `全部平台` = no platform filter.  
+6. Create **Discovery** records first; do not create Topics during the scan. Cap **5** new **`produce`** topics only when the user later promotes. Sort watchlist rows by weight (≥1.3 first).  
+7. Wrong network for a row → never (e.g. no X tools on `platform=tiktok`).
+
+## Maintenance
+
+| User says | Agent does |
+|-----------|------------|
+| 把 @foo 加进 watchlist | Resolve/ask **profile** + **platform**; append row to that profile file (or `_shared` if user says 全 profile / shared) |
+| 去掉 #n / @foo | Edit the correct file; if ambiguous, ask |
+| 新 profile 建雷达 | Create `watchlists/<id>.md` |
+
+## Scan rules (also CLAUDE § Discovery)
+
+- Create one Discovery per meaningful signal; discard noise before analysis.
+- Watchlist scan creates **Discovery** records first; it does not create Topics directly.
+- Write a Source Digest + source limits only. Do not add our audience, product, ownership, or candidate Topics.
+- Keep source engagement as context on the Discovery file; copy `src_*` to `topics/_index.md` only after promotion.
+- Report `unread / read / saved / promoted / rejected` counts after the batch.
+

package/content-engine/starter/topics/_index.md

@@ -0,0 +1,44 @@
+# Topics index (production queue)
+
+One row = one topic. Full scorecard in **`item`** file.  
+Same topic on multiple platforms = **one topic row**; open **N runs** sharing `topic_id`.  
+Statuses live here and in the item—**not** folder names.
+
+Newest on top.
+
+| id | date | opp | aud | status | purpose | scout | platform | pillar | one_liner | item | source_type | src_url | src_handle | src_likes | src_replies | src_bookmarks | engagement_at | capture_id | run |
+| -- | ---- | --- | --- | ------ | ------- | ----- | -------- | ------ | --------- | ---- | ----------- | ------- | ---------- | --------- | ----------- | ------------- | ------------- | ---------- | --- |
+
+## Status values
+
+| status | Meaning |
+|--------|---------|
+| `draft` | Created, not fully scored |
+| `scored` | Has scores; not yet triaged |
+| `ready` | opp ≥ 7.5 **and** aud ≥ 6 (dual gate) |
+| `backlog` | opp/aud mid — re-angle, research, or wait |
+| `parked` | opp < 6 or aud < 5 or hard-filter fail |
+| `library` | Scout purpose library (structure later; not produce-ready) |
+| `promoted` | Opened as a run (`run` column set) |
+| `killed` | User rejected |
+
+## Columns (key)
+
+| Column | Meaning |
+|--------|---------|
+| `opp` | Opportunity score (weighted 5-dim: context/audience/conflict/insight/evidence) |
+| `aud` | Audience dimension score (hard floor ≥ 6 for ready) |
+| `item` | Wikilink to `topics/items/T-….md` |
+| `source_type` | `watchlist` \| `inbox` \| `user` \| `discovery` |
+| `src_*` | **Source post** engagement snapshot — not your publish metrics |
+| `capture_id` | Set only if linked to inbox `C-…` |
+| `run` | One or more `RUN-…` ids after open (comma-separated if multi-platform siblings) |
+
+## Rules
+
+- Max **5** new **`produce`** topics per promotion session
+- Watchlist scan creates **Discovery** first; Topic only after explicit promotion
+- Scout first; never `ready` on high `src_*` or opp_score alone (need audience ≥ 6 too)
+- Scoring: `topics/scoring.md` (opportunity dimensions)
+- `记一下` + URL: **inbox first**, not topics, unless user also asks to score as topic
+- On 开一单: append all new run ids to `run`