@easysociable/cli 0.1.3 → 0.1.4

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

@@ -1,5 +1,36 @@
 # ContentPack v1
 
+Page `role` is a **weak retrieval tag** (layout-ish), not sequence position.
+`pageTemplateId` is the explicit published single-page template chosen by the
+Agent. `slots` are public values only. Do not add a `deck_template_id`,
+`bindingMap`, AST, ContentDocument, or product `arc` / `pageSequence`.
+
+The Gateway validates each `role` against the closed enum and that slots exist.
+It does not require Cover → Point → Steps → Recap → CTA.
+
+This skill **does** require page 1 to be cover/hook class (`supportedRoles`
+includes `cover` or `hook`) and forbids that class on later pages.
+
+## Example: cost → mechanism (TikTok)
+
+Opening beat is cost; page 1 is still a hook-class template.
+
+```json
+{
+  "schemaVersion": "content-pack.v1",
+  "platform": "tiktok",
+  "title": "Stop briefing a blank canvas",
+  "pages": [
+    { "role": "hook", "pageTemplateId": "tpl_hook_001", "slots": { "text_0": "You finish the copy. Then you start over.", "text_1": "The design file kept none of the argument." } },
+    { "role": "point", "pageTemplateId": "tpl_stack_001", "slots": { "text_0": "Roles, Brand, Layouts persist" } },
+    { "role": "steps", "pageTemplateId": "tpl_stair_001", "slots": { "text_0": "Use them in that order" } },
+    { "role": "cta", "pageTemplateId": "tpl_close_001", "slots": { "text_0": "Don't brief a blank canvas" } }
+  ]
+}
+```
+
+## Example: hook → value → cta
+
 ```json
 {
   "schemaVersion": "content-pack.v1",
@@ -13,12 +44,9 @@
 }
 ```
 
-Page `role` is semantic and `pageTemplateId` is the explicit published
-single-page template chosen by the Agent. `slots` are public values only. Do not
-add a `deck_template_id`, `bindingMap`, AST or ContentDocument.
-
-The Gateway validates that each selected template supports the page role and
-belongs to the account-visible catalog. It never silently replaces a selection.
+Pick templates by **platform + canvas + slotSummary + density**, not by matching
+the beat name to a family named Cover / Point / Steps / Recap / CTA. Page 1
+must still be cover/hook class.
 
 The renderer accepts any supported page count within the platform cap. A newly
 published Page Template can be selected in a new Run without creating a

package/skills/easysociable-slideshow/workflows/CREATE_RUN.md

@@ -1,7 +1,26 @@
 # Create Run
 
-1. Build `content-pack.v1` from the agent's semantic outline.
-2. Check platform hardMin/hardMax.
-3. Call `create_run` or `run create` through Gateway.
-4. Save `runId`, `studioUrl`, and `status=draft`.
-5. Do not call a Deck API or create a carousel template.
+1. Write one arc line (`references/ARC.md`). Forbidden default:
+   Cover → Point → Steps → Recap → CTA.
+2. Build `content-pack.v1` from that argument. Page count follows the beats
+   (TikTok often 4–8), not the number of P0 families.
+3. Check platform hardMin/hardMax.
+4. List published Page Templates. `pages[0]` must be cover/hook class
+   (`supportedRoles` includes `cover` or `hook`). Do not use that class on
+   later pages. Remaining pages: platform + canvas + `slotSummary` + density.
+   `role` is a weak tag.
+5. If `contentSlug` already has a Run: update only when topology matches
+   (same page count and `pageTemplateId`s). Otherwise create a new Run.
+6. **Before** `create_run` / `slideshows create` (every create, not only the
+   first Run): check the knowledge hard gate — Identity Role / What I build /
+   Point of view have no `(fill)` and are non-empty; `boundaries.md` exists
+   with Not covering and Never claim non-empty; if `needs/` exists, ≥3 `N-`
+   rows, else skip. Read the files or run
+   `easysociable engine validate --run <run-dir> --require-knowledge`.
+   Fail → hand back to **easysociable-content** / refuse create; list missing
+   files. User must say **强制继续** / **force continue** to call Gateway.
+   No new Gateway or MCP params.
+7. Call `create_run` / `slideshows create` through Gateway.
+8. Save `runId`, `studioUrl`, and `status=draft`.
+9. Do not call a Deck API, create a carousel template, or send a product
+   `pageSequence` / `arc` field.

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

@@ -1,6 +1,9 @@
 # Out of scope
 
 - DeckTemplate creation, `list_decks`, `CREATE_DECK`, or `BIND_P0_DECKS`.
+- Product-level `arc` / Deck `pageSequence` SKUs (ADR-0026). Structure stays in the Content Pack.
+- Defaulting every Run to Cover → Point → Steps → Recap → CTA.
+- Cover/hook class templates on page 2+ (they belong on `pages[0]` only).
 - ContentDocument as a render input (ADR-0021).
 - Client-side RenderPlan or AST compilation.
 - Full cross-platform Page Template coverage and ad-placement variants.

package/skills/easysociable-template/SKILL.md

@@ -2,18 +2,15 @@
 name: easysociable-template
 description: >
   Create single-page social image templates for EasySociable via the unified
-  Template MCP or `easysociable` CLI, and fill published template slots to Hosted Render
-  (get_template → slots → create_render_job). Default create path is a Layout Family:
+  Template MCP or `easysociable` CLI. Default create path is a Layout Family:
   one master canvas plus derived multi-platform variants (e.g. XHS 3:4, IG/Threads 4:5,
   TikTok 9:16, LinkedIn 1:1) with hand-tuned layouts per preset. Use when the user wants
-  to author a page template from a reference image or text brief (including “做多平台
-  模板”), write a shared visual design philosophy, explore 2–3 professional layout
-  concepts, plan or generate visual assets, co-create Theme/preview tokens with brand-hex
-  palette generation, choose a Surface, pull icons via Template Gateway
-  search_icons/get_icon, run screenshot-based visual QA, attach catalog metadata, open
-  Authoring Studio, publish, or render by filling public slots. Do not use for multi-slide
-  slideshow composition, ContentDocument as render input, local content library, or
-  carousel packs.
+  to author a page template from a reference image or text brief, write a shared visual
+  design philosophy, explore layout concepts, co-create Theme/preview tokens, pull icons
+  via search_icons/get_icon, open Authoring Studio, or publish. Do not use for
+  fill-slots hosted PNG jobs (`create_render_job` is retired), multi-slide slideshow
+  composition, ContentDocument as render input, or carousel packs. Customer PNG packs
+  come from Slideshow Studio Download.
 ---
 
 # EasySociable Template Skill
@@ -22,12 +19,12 @@ The public entry points are the unified `easysociable` CLI and one unified MCP
 server. Do not install or invoke `easysociable-template`, `easysociable-slideshow`,
 `easysociable-content`, or a separate Content/Slideshow MCP in V1.
 
-**This skill owns two single-page paths:**
+**This skill owns template authoring:**
 
 1. **Author** templates as a **Layout Family** (master + multi-platform variants) → Studio + Publish (`workflows/MULTI_PLATFORM_FAMILY.md`).
-2. **Fill slots → Hosted Render** for a published PageTemplate (`workflows/FILL_AND_RENDER.md`).
+2. Fill-slots Hosted Render (`create_render_job`) is **retired** as a paid delivery path. Customer PNG packs come from Slideshow Studio Download.
 
-It is a template factory **and** the Agent surface for single-page fill-slots rendering (ADR-0021). It is **not** a multi-slide slideshow compositor. Single-page ≠ single-platform.
+It is a template factory. It is **not** a multi-slide slideshow compositor and it is **not** a PNG API.
 
 Every published page must carry **P0 catalog metadata** so Agents can filter and fill templates (`references/CATALOG_METADATA.md`).
 
@@ -51,7 +48,7 @@ Out of scope (hand off):
 9. Layout model is **absolute positioning** on a **flat canvas tree** (see prior authoring rules / `AUTHORING_SOURCE.md`).
 10. **Runtime layout CSS:** put exact geometry in JSX inline `style={{...}}`. Never depend on Tailwind arbitrary-value classes for geometry.
 11. Run `scripts/validate-authoring-source.mjs` before every create/update.
-12. `supportedRoles` uses closed **pageRoles**; `platforms` is a multi-select array.
+12. `supportedRoles` uses closed **pageRoles** as a **weak retrieval tag**, not sequence position. Family `name` describes **layout** (Poster / Stack / Count / Stair / Close), not a narrative beat. `platforms` is a multi-select array.
 13. Canvas sizes must follow `references/PLATFORM_SPECS.md`.
 14. **Text-only V2.1 authoring:** `DESIGN_BRIEF` → Philosophy → Concepts → assets/surface → author → Visual QA.
 15. **Visual QA** before Studio handoff when authoring. For `image_reference`, QA **must** side-by-side compare Studio canvas to the reference (`VISUAL_QA.md` § Reference compare).
@@ -59,8 +56,8 @@ Out of scope (hand off):
 16b. **Reference image → template (hard):** follow `workflows/AUTHORING_FROM_IMAGE.md` as SoT. **Read the reference with a vision tool**, write `referenceSpec` + `referenceImageInventory` into `design-plan.json`, and place pictorial regions as **`image` slots** (empty frames matching the boxes). `validate-design-v2.mjs` rejects `image_reference` plans missing those fields or using `css_svg` stand-ins for inventoried pictures. Do not mood-board a different layout.
 17. Preserve `draftId`, `templateId`, `themeId`, `jobId`, `authoringStudioUrl`, and `previewUrl` across steps.
 18. **Theme / Surface confirmation gates** unchanged for authoring (see `PALETTE_REVIEW`, `SURFACE_REVIEW`).
-19. **Fill-slots render (primary consumption path):** `get_template` → fill `slots[]` → `create_render_job({ templateId, slots, output })` → poll Job/Manifest. Image slots always use an account-owned `imageId` from the existing Gateway → R2 + Directus `Image` flow. Never pass a third-party URL, local path, transient `renderAssetId`, ContentDocument or `contentDocumentHash`. See `workflows/FILL_AND_RENDER.md`.
-20. **Hosted Capture first:** default delivery is Hosted Artifact. Local capture only when the error includes `fallback.capture` — follow `workflows/FILL_AND_RENDER.md` §5 (CLI `capture` or same-URL Playwright). Do not use page html-to-image buttons as the Agent primary path.
+19. **Consumption is Slideshow Studio Download**, not fill-slots Hosted Render. `create_render_job` / CLI `renders create` return `HEADLESS_RENDER_DISABLED`. See `workflows/FILL_AND_RENDER.md`.
+20. **Do not** treat Hosted Capture or local html-to-image as the Agent primary PNG path.
 21. **Icons (hard rule — no shortcuts):**
     - Any **recognizable icon** (arrows, chevrons, checkmarks, social glyphs, UI symbols, “next page” cues, etc.) **MUST** use Gateway Icon Catalog:
       `search_icons` / CLI `icons search` → show ≤8 candidates → **user confirm** (or explicit “你定 / 用第 N 个”) → `get_icon` / CLI `icons get --idempotency-key …` → embed returned **`canonicalSvg`** and record **`iconAssetId`** / `iconId` on the decoration node.

package/skills/easysociable-template/references/CATALOG_METADATA.md

@@ -5,9 +5,10 @@ Private AST/bindings stay server-side; this document is the **public selection c
 
 ## Design choices (locked)
 
-1. **One closed `pageRoles` set** (stored as `supportedRoles`) — narrative beat + layout kind in one enum. Do not maintain a second parallel taxonomy.
+1. **One closed `pageRoles` set** (stored as `supportedRoles`) — a **retrieval tag for layout kind**, not page position and not a story recipe. `cover` means poster-like slots, not “must be page 1”. Do not add a parallel `arc` / `pageSequence` taxonomy (ADR-0026).
 2. **`platforms` is a multi-select array**. Include `generic` when the page fits any platform at that aspect.
 3. **P0 fields are required to Publish.** P1 should be filled when known; P2 optional.
+4. **Family `name` describes layout**, not a narrative beat. Prefer Poster / Stack / Count / Stair / Close (plus platform). Do not name families Cover / Point / Steps / Recap / CTA — choosers will glue those five names into one default pack.
 
 Max **1–2** `supportedRoles` per page (primary + optional secondary).
 
@@ -33,25 +34,25 @@ Always also store exact `canvas: { width, height }`. Use `16:9` for X **1200×67
 
 ### Page roles (`supportedRoles` / pageRoles) — pick 1–2
 
-| Role | When to use |
+| Role | Layout kind (not sequence position) |
 |---|---|
-| `cover` | Cover / first-frame poster |
-| `hook` | Scroll-stop hook (often with cover) |
-| `setup` | Setup / problem framing |
-| `context` | Background / context |
-| `value` | Single takeaway / value page |
+| `cover` | Poster / first-frame-capable layout — may open a run, need not |
+| `hook` | Scroll-stop / short-copy layout |
+| `setup` | Problem-framing layout |
+| `context` | Background / context layout |
+| `value` | Single takeaway layout |
 | `point` | One sharp point (lighter than value) |
 | `checklist` | Fixed N text lines (no list binding type) |
-| `proof` | Proof / credibility |
+| `proof` | Proof / credibility layout |
 | `evidence` | Evidence artifacts (data, case) |
-| `compare` | Before/after or A/B compare |
+| `compare` | Before/after or A/B layout — valid as page 1 |
 | `screenshot` | App/web UI screenshot frame |
-| `metric` | Big number / KPI / milestone |
-| `quote` | Pull quote / testimonial |
-| `steps` | Fixed-step howto |
-| `cta` | Call to action |
-| `follow` | Follow / profile CTA |
-| `recap` | Summary / closing recap |
+| `metric` | Big number / KPI — valid as page 1 |
+| `quote` | Pull quote / testimonial — valid as page 1 |
+| `steps` | Fixed-step howto layout |
+| `cta` | Call to action layout |
+| `follow` | Follow / profile CTA layout |
+| `recap` | Summary / closing layout |
 
 Legacy-compatible: `cover`, `setup`, `value`, `proof`, `cta` remain valid.
 
@@ -98,7 +99,7 @@ hero | screenshot | avatar | product
 
 | Field | Type | Notes |
 |---|---|---|
-| `name` | string | Human title |
+| `name` | string | Human title — **layout**, not beat (e.g. `P0 Poster TikTok`, not `P0 Cover TikTok`) |
 | `shortDescription` | string | One sentence for chooser UI |
 | `platforms` | `Platform[]` | Multi-select; use `generic` when truly cross-platform |
 | `canvasPreset` | preset enum | Plus exact `canvas` pixels |
@@ -189,7 +190,7 @@ Agent must produce a `selection-metadata.json` (or equivalent fields on the draf
 
 ```json
 {
-  "name": "XHS metric milestone 3:4",
+  "name": "XHS Count 3:4",
   "shortDescription": "大数字涨粉庆祝页，可选头像",
   "platforms": ["xiaohongshu", "generic"],
   "canvasPreset": "3:4",
@@ -207,7 +208,7 @@ Agent must produce a `selection-metadata.json` (or equivalent fields on the draf
   "visualStyle": "swiss",
   "bestFor": ["涨粉节点", "数据庆祝封面"],
   "notFor": ["长清单干货", "多步教程"],
-  "selectionHints": "Prefer when slide.role is metric or cover and a single KPI dominates.",
+  "selectionHints": "Prefer when slotSummary has one number + short text (KPI / cost hook), any page index.",
   "locale": "zh-CN"
 }
 ```
@@ -219,3 +220,5 @@ Agent must produce a `selection-metadata.json` (or equivalent fields on the draf
 - Checklist without `fixedItemCount`
 - `requiresImage: true` but `imageRoles` empty
 - Platforms empty or inventing values outside the enum
+- Naming a family Cover / Point / Steps / Recap / CTA so choosers assemble that sequence
+- Treating `supportedRoles` as “this page must appear at this beat in every Run”

package/skills/easysociable-template/workflows/FILL_AND_RENDER.md

@@ -1,86 +1,7 @@
-# Fill slots and Hosted Render (published template)
+# Fill slots and Hosted Render — RETIRED
 
-Primary **Agent use** of a published single-page template: read the public slot table, fill values, submit a Hosted Render Job, poll for Artifact / Manifest.
+**Retired as a paid delivery path (2026-09-04).** PNG packs come from Slideshow **Studio Download** (browser ZIP). Gateway `POST /v1/renders`, CLI `renders create|export`, and MCP `create_render_job` return `HEADLESS_RENDER_DISABLED`.
 
-This path belongs to **Template Skill** (ADR-0021 / AC-25～26). Do **not** hand off to Content Skill for single-page fill-slots out图.
+Do not invoke fill-slots render for customer output. Author templates with this skill; consume carousels with Slideshow Skill → Studio → Download.
 
-## Preconditions
-
-```bash
-easysociable auth status --json
-```
-
-Prefer Template MCP tools when available; CLI is the fallback.
-
-## Steps
-
-### 1. Get template + public slots
-
-**MCP:** `get_template({ templateId })`  
-**CLI:** `easysociable templates get --id <id> --json`
-
-Response MUST include `slots[]` with `key`, `type`, `required`, optional `maxCharacters` / `overflow` / `aiHint` / `label`.  
-MUST NOT include AST, Binding Map, or RenderPlan.
-
-### 2. Fill slots
-
-| Slot type | Agent action |
-|---|---|
-| `text` / `number` | Generate from user brief; respect `maxCharacters` / required |
-| `image` | Ask user: upload or choose an existing account image. After confirmation, use `import_template_image` / the unified image import flow so the bytes are stored through Gateway → R2 and the metadata is recorded in the existing Directus `Image` collection; put the returned **`imageId`** in the slot. Never pass temporary Unsplash/Pexels/Pinterest URLs, local paths or transient asset IDs as authority. |
-
-Omit optional empty slots (`null` / `''`) rather than inventing filler.
-
-All V1 image uploads use the account image import flow. There is no separate
-transient render-asset command.
-
-### 3. Create Hosted Render Job
-
-**MCP:** `create_render_job({ templateId, slots, outputFormats, idempotencyKey? })`  
-**CLI:**
-
-```bash
-easysociable renders create \
-  --template-id <id> \
-  --slots '{"title":"Hello","caption":"World"}' \
-  --format png \
-  --idempotency-key fill_1 \
-  --json
-```
-
-**Forbidden inputs:** `ContentDocument`, `contentDocumentHash`, client `RenderPlan`, AST, Binding Map.
-
-### 4. Poll Job / Manifest
-
-**MCP:** `get_render_job({ jobId })` → when completed, `get_render_manifest` if needed  
-**CLI:** `easysociable renders wait --id <id> --json`
-
-Success: signed Artifact URL(s) on the public Manifest.  
-Job may also return `previewUrl` + `capture` (signed Studio-parity page). Deliver the **Hosted Artifact**, not a local screenshot of that preview URL.
-
-### 5. Hosted Capture failure
-
-V1 does not expose a second local capture command. If Hosted Capture fails,
-surface the Gateway error and retry only when it is marked retryable; do not
-invent a browser URL, selector or viewport and do not treat an Authoring Studio
-screenshot as a billable final Artifact.
-
-#### Error-code table
-
-| Code / signal | Local capture? | Agent action |
-|---|---|---|
-| Job `completed` + Manifest Artifact | No | Deliver signed Artifact URL(s) |
-| Retryable worker/queue/5xx error | No | Retry Hosted with the same idempotency key |
-| Rate limit | No | Respect retry-after/backoff and retry once if allowed |
-| `VALIDATION_ERROR` / missing required slots | **No** | Fix slots; no fallback expected |
-| Auth / entitlement / tier denied | **No** | Fix credentials/plan; no fallback |
-Failed jobs without a retryable error are surfaced to the user; no freestyle
-browser screenshot is accepted as final output.
-
-## Anti-patterns
-
-- Building or submitting a local RenderPlan / AST / Binding Map
-- Using ContentDocument export as a render prerequisite
-- Treating Studio html-to-image as Hosted delivery or as the default on success
-- Local capture when Hosted succeeded or when `fallback.capture` is absent
-- Calling Content MCP/CLI for this single-page fill-slots flow
+Public `slots[]` on a published template remain a catalog contract. They are not a PNG API.

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

@@ -10,6 +10,7 @@ If the user asks for any of the following, **do not** execute them under this sk
 | Pick Theme as slideshow “Look” for a whole Run | **easysociable-slideshow** + Profile Theme |
 | Local Obsidian content authoring | Content Skill |
 | UGC/publication/social posting | Deferred in V1 |
-| Submit `contentDocumentHash` / ContentDocument to Template render | **Forbidden** — use fill-slots (`FILL_AND_RENDER.md`) |
+| Submit `contentDocumentHash` / ContentDocument to Template render | **Forbidden** |
+| `create_render_job` / CLI `renders create` for customer PNG | **Forbidden** — Studio Download on a Slideshow Run |
 
-**In scope:** single-page template authoring/publish **and** fill-slots Hosted Render of one published PageTemplate (`get_template` → slots → `create_render_job`).
+**In scope:** single-page template authoring/publish. Customer PNG packs are Slideshow Studio Download.

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

@@ -1,18 +0,0 @@
-# Discovery
-
-Discovery is the intermediate layer between watchlist signals and Topics.
-
-```text
-watchlist → discovery → (explicit promote) → topic → brief
-```
-
-It makes the source understandable before deciding whether the idea belongs to us.
-
-- `Source Digest` is a short natural-language note: what happened, the author's argument, support, native language, and limits.
-- `Source limits` records what the source does not establish.
-- `Decision` stores only workflow status and next action.
-- A source with high engagement can still remain `saved` or `rejected`.
-
-Do not add our audience, product, thesis, ownership, or candidate Topics to a Discovery.
-Do not use 5C as the default Discovery reading format.
-Discovery does not generate publish-ready copy.

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

@@ -1,27 +0,0 @@
-# Discovery index
-
-One row = one analyzed external signal from a watchlist scan. Discovery is not a topic queue.
-
-Newest on top.
-
-| id | date | profile | platform | source_handle | source_url | source_claim | source_role | status | next_action | topic_ids | file |
-|----|------|---------|----------|---------------|------------|--------------|-------------|--------|-------------|-----------|------|
-| -- | ---- | ------- | -------- | ------------- | ---------- | ------------ | ----------- | ------ | ----------- | --------- | ---- |
-
-## Status values
-
-| status | Meaning |
-|--------|---------|
-| `unread` | Signal captured; digest not read |
-| `read` | Source Digest completed |
-| `saved` | Useful reference; no Topic decision yet |
-| `promoted` | User explicitly promoted it to Topic |
-| `rejected` | Not relevant, provable, or ownable |
-
-## Rules
-
-- Watchlist heat is source context, not our evidence.
-- New Discovery records contain only Source Digest, source limits, and workflow state.
-- Do not create a Topic during watchlist scanning; Topic creation requires explicit promotion.
-- Do not store our audience, product, ownership, or candidate opportunities inside Discovery.
-- 5C belongs to Topic evaluation and is never the default Discovery reading surface.

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

@@ -1,41 +0,0 @@
----
-id: D-YYYYMMDD-XX
-date: YYYY-MM-DD
-status: read
-profile: default
-platform: x
-source_role: demand | ally | foil | mechanism
----
-
-# Discovery
-
-One sentence describing the external signal in the source's terms. Do not turn it into our topic here.
-
-## Source
-
-- **handle:**
-- **url:**
-- **captured_at:**
-- **engagement snapshot:** likes / replies / bookmarks / views @ time
-- **why on watchlist:**
-
-## Source Digest
-
-### In one sentence
-
-### What happened
-
-### What the author is arguing
-
-### How the author supports it
-
-### The author's own language
-
-### Source limits
-
-What the source does not establish. Keep this short.
-
-## Decision
-
-- **status:** unread | read | saved | promoted | rejected
-- **next_action:** none | revisit | promote_to_topic

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

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

@@ -1,10 +0,0 @@
-# topics/watchlists/
-
-**One file per profile** + optional shared table.
-
-| Path | Scope |
-|------|--------|
-| `_shared.md` | All profiles (`*`) — merged on every scan |
-| `<profile_id>.md` | Only that profile (e.g. `easysociable-builder.md`) |
-
-Registry / scan rules: `../WATCHLIST.md`.

package/content-engine/starter/topics/watchlists/_shared.md

@@ -1,14 +0,0 @@
-# Watchlist — shared (`*`)
-
-Rows here apply to **every** profile when scanning (merge with `topics/watchlists/<profile_id>.md`).
-
-Use only for handles that are truly cross-positioning. Prefer putting niche-specific radars in the profile file.
-
-| # | platform | handle | niche_tag | why_on_list | weight | status |
-|---|----------|--------|-----------|-------------|--------|--------|
-
-*(empty — add rows only when a handle should appear for all profiles)*
-
-## Id note
-
-Use `#S-01`, `#S-02`, … so shared ids do not collide with profile-local `#1…`.

package/content-engine/starter/topics/watchlists/default.md

@@ -1,6 +0,0 @@
-# Watchlist — profile `default`
-
-Profile-scoped radar. Merge with `topics/watchlists/_shared.md` on every scan.
-
-| # | platform | handle | niche_tag | why_on_list | weight | status |
-|---|----------|--------|-----------|-------------|--------|--------|