@easysociable/cli 0.1.8 → 0.1.9

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

@@ -1,33 +0,0 @@
-# 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/stories.md

@@ -1,15 +0,0 @@
-# Stories — profile `default`
-
-**Role:** Narrative inventory the draft may cite.  
-**Not:** Identity table facts (`./voice.md` Experience).
-
-0–1 stories is enough for a first session (`profile: partial`). Skip if the user has none they will make public.
-
-## Stories
-
-### S1 — (title)
-
-- **Situation:** (fill)
-- **Choice:** (fill)
-- **Lesson:** (fill)
-- **Public:** yes | no

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

@@ -1,38 +0,0 @@
-# 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 |
-
-## Experience
-
-Facts copy may cite (year, role, thing done). Write `not claiming` when unknown.
-
-- (fill)
-
-## Values
-
-Claims this profile will always make / will never make. Repeatable topics go in `pillars.md`, not here.
-
-- (fill)
-
-## Persona
-
-- (fill)
-- Direct. Concrete nouns. Address the reader as **you**.
-- Do not invent bio facts not listed in Identity.
-
-## Do not say
-
-- (fill)
-- Fake social proof
-- Empty hype (“game-changer”, “unlock your potential”)

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

@@ -1,20 +0,0 @@
-# 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

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

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

@@ -1,12 +0,0 @@
-# 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/recommendations/README.md

@@ -1,21 +0,0 @@
-# recommendations/
-
-First-class **third-party product and tool library**. This is separate from
-`products/`: entries here are products the profile may review, compare, or
-recommend, not products EasySociable owns or sells.
-
-```text
-Profile + Needs + review evidence
-  → Topic
-  → optional recommendation_ids
-  → Run
-```
-
-## Rules
-
-- Do not treat a recommendation as an owned Product or as a product CTA.
-- Do not copy vendor marketing claims into `quote` or evidence.
-- Record the research date and source URLs. Prices and features can change.
-- Record affiliate, sponsorship, or other commercial relationships when known.
-- A recommendation needs a review basis: observed workflow, named source,
-  comparison, or user-provided evidence. An empty entry is not a review.

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

@@ -1,21 +0,0 @@
-# Recommendations index
-
-Third-party tools and products available for review or comparison. No starter
-entries are provided.
-
-| id | name | status | category | profiles | pillars | last_researched | relationship | file |
-|----|------|--------|----------|----------|---------|-----------------|--------------|------|
-| -- | ---- | ------ | -------- | -------- | ------- | --------------- | ------------ | ---- |
-
-## Status values
-
-| status | Meaning |
-|--------|---------|
-| `candidate` | Captured for possible research; not publishable |
-| `researched` | Evidence and limits recorded |
-| `active` | Available for Topics and reviews |
-| `retired` | No longer maintained or relevant |
-
-`profiles` is a comma-separated many-to-many association. Use `*` only when
-the subject is intentionally shared across all profiles. `pillars` records
-where the subject is relevant; it does not make the subject an owned product.

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

@@ -1,44 +0,0 @@
----
-id: R-YYYYMMDD-XX
-name:
-status: candidate
-category:
-profiles: default
-pillars:
-last_researched: YYYY-MM-DD
-relationship: none | affiliate | sponsor | client | other
-source_urls:
----
-
-# Recommendation subject
-
-## What it is
-
-## Best for
-
-## Not for
-
-## Problem addressed
-
-## Observed workflow
-
-## Strengths
-
-## Limitations
-
-## Alternatives
-
-## Pricing snapshot
-
-Include currency, plan, limits and date. Do not assume the price is current.
-
-## Evidence
-
-Named sources, tests, screenshots, or user reports. Empty is not publishable.
-
-## Disclosure
-
-State affiliate, sponsorship, ownership, or other commercial relationship.
-
-## Review notes
-

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

@@ -1,22 +0,0 @@
-# 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

@@ -1,41 +0,0 @@
-# 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

@@ -1,76 +0,0 @@
----
-status: BRIEF_WAIT
-gate_score: 0
-gate_pass: false
----
-
-# Brief
-
-## Thesis
-
-One sentence a stranger can understand without any product context.
-
-(fill)
-
-## For whom → what changes
-
-**Reader:** (who specifically has this problem)
-
-**They currently believe:** (the false belief or stuck assumption)
-
-**After reading:** (what they should believe, do, or stop doing)
-
-## Evidence
-
-**What we have:** (named sources — Need ids, product facts, mechanisms, cases)
-
-**Evidence type:** data | example | case | mechanism | expert | observation
-
-**Quality:** weak | moderate | strong
-
-**What we cannot prove:** (be honest — no invented outcomes)
-
-## Platform and expression
-
-- **Platform:** x | linkedin | ig | tiktok
-- **Form:** short post | thread | carousel | …
-- **Hook:** (first line or opening move)
-- **Structure:** (the argument flow in one line, e.g. hook → false belief → mechanism → action)
-
-## Boundaries
-
-- **Must include:** (non-negotiable claims or framing)
-- **Must avoid:** (hard bans for this draft; merge `profiles/<id>/boundaries.md` + voice Do not say)
-
----
-
-## Appendix (machine / handoff — not the reading surface)
-
-### Inherited from Topic
-
-- context:
-- audience:
-- conflict:
-- insight:
-- outcome:
-- evidence:
-
-### Selection
-
-- swipe: id | none — why
-- atoms: hook:… | cta:… | none — why
-- claim: id | none — why
-
-### 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

@@ -1,11 +0,0 @@
----
-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

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

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

@@ -1,15 +0,0 @@
----
-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

@@ -1,27 +0,0 @@
----
-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

@@ -1,55 +0,0 @@
----
-# 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.
-# Write the Arc line before pages. Do not default Cover → Point → Steps → Recap → CTA.
----
-status: unused
-id:
-platform: linkedin
-deck_hint:
-page_count: 0
----
-
-# Pack
-
-## Meta
-
-- **run_id:**
-- **pillar:**
-- **swipe_id:**
-- **claim_id:**
-- **language:** en
-
-## Arc
-
-<!-- One line: the argument that needs page turns. Required before Pages. -->
-<!-- Recipes: cost-mechanism | listicle | mistakes | claim-proof | compare | (named) -->
-
-- **one_liner:**
-- **recipe:**
-
-## Pages
-
-<!-- Each page: role is a layout retrieval tag, not sequence position. -->
-<!-- First page is not automatically cover. Text only — no private AST. -->
-
-### page 1
-
-- **role:**
-- **slots:**
-  - text_0:
-
-### page 2
-
-- **role:**
-- **slots:**
-  - text_0:
-
-<!-- …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

@@ -1,31 +0,0 @@
----
-# 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
-
-## Boundaries (must_avoid — from boundaries.md + voice Do not say)
-
-## Expression likes / dislikes
-
-## Story inventory (cite or none)

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

@@ -1,19 +0,0 @@
----
-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

@@ -1,27 +0,0 @@
-# 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

@@ -1,36 +0,0 @@
----
-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 (argument structure only — no full copy)
-
-<!-- Not Cover → Point → Steps → Recap → CTA. Those are catalog family names. -->
-
-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

@@ -1,21 +0,0 @@
-# topics/
-
-Topic system: **what to produce next**, after an explicit need, offer, review subject, or profile thesis has been judged as an opportunity.
-
-| Path | Role |
-|------|------|
-| `_index.md` | Queue registry (one row per topic + `item` link + source engagement) |
-| `items/T-*.md` | One file per opportunity: decision summary + readable judgment, then Score/Trace/Constraints appendix |
-| `scoring.md` | Opportunity dimensions and dual gate |
-| `_template-item.md` | Template for new items |
-
-Flow:
-
-```text
-explicit input → editorial judgment
-  → `_index` + `items/T-…` (opportunity 5-dim)
-  → ready only if opp≥7.5 and audience≥6
-  → user opens run → `status=promoted`
-```
-
-The item file is a **decision card**. A content owner who skips YAML and the appendix must still answer: what problem we address, who it serves, what we will say, why now, what should change, and whether to open a run. Five-dim scores stay in the appendix as a gate, not as the reading surface.

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

@@ -1,51 +0,0 @@
-# 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 | lane | generation_mode | one_liner | item | source_type | src_url | src_handle | src_likes | src_replies | src_bookmarks | engagement_at | capture_id | need_ids | product_ids | product_fit | recommendation_ids | 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` |
-| `lane` | Publishing lane: teach, build, review, compare, offer, or profile-defined |
-| `generation_mode` | How the Topic was formed; see `topics/_template-item.md` |
-| `source_type` | `inbox` \| `user` \| `need` \| `product` \| `recommendation` |
-| `src_*` | **Source post** engagement snapshot — not your publish metrics |
-| `capture_id` | Set only if linked to inbox `C-…`. **Never** put `N-` here; needs live on the item as `need_ids` |
-| `need_ids` | Audience evidence cited by the Topic; demand evidence, not product proof |
-| `product_ids` | Optional product facts cited by the Topic |
-| `product_fit` | `direct` \| `adjacent` \| `none`; editorial relevance only |
-| `recommendation_ids` | Optional third-party subjects used for review or comparison |
-| `run` | One or more `RUN-…` ids after open (comma-separated if multi-platform siblings) |
-
-## Rules
-
-- Max **5** new **`produce`** topics per promotion session
-- Topics require an explicit user, need, product, recommendation, or profile input.
-- Scout first; never `ready` on high `src_*` or opp_score alone (need audience ≥ 6 too)
-- Scoring: `topics/scoring.md` (opportunity dimensions)
-- Product fit is optional and never replaces Need evidence or opportunity scoring.
-- `记一下` + URL: **inbox first**, not topics, unless user also asks to score as topic
-- On 开一单: append all new run ids to `run`