@easysociable/cli 0.1.2 → 0.1.3

package/skills/easysociable-content/scripts/setup.test.mjs

@@ -1,82 +0,0 @@
-import assert from 'node:assert/strict'
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { join } from 'node:path'
-import { spawnSync } from 'node:child_process'
-
-const script = new URL('./setup.mjs', import.meta.url).pathname
-const fixture = mkdtempSync(join(tmpdir(), 'easysociable-content-'))
-const root = join(fixture, 'Workspace')
-mkdirSync(root)
-const env = { ...process.env, EASYSOCIABLE_NO_OPEN: 'true' }
-
-function run(args) {
-  return spawnSync(process.execPath, [script, ...args, '--json'], { encoding: 'utf8', env })
-}
-
-try {
-  const missingRoot = run(['--preview'])
-  assert.equal(missingRoot.status, 2)
-  assert.equal(JSON.parse(missingRoot.stdout).code, 'ROOT_REQUIRED')
-
-  const preview = run(['--root', root, '--preview'])
-  assert.equal(preview.status, 0)
-  const previewReport = JSON.parse(preview.stdout)
-  assert.equal(previewReport.created.length, 0)
-  assert.equal(previewReport.valid, true)
-  assert.equal(previewReport.rootName, 'Content Engine')
-
-  const apply = run(['--root', root, '--apply', '--no-open'])
-  assert.equal(apply.status, 0, apply.stdout + apply.stderr)
-  const applied = JSON.parse(apply.stdout)
-  assert.equal(applied.action, 'applied')
-  assert.equal(applied.created.length > 10, true)
-  const engine = join(root, 'Content Engine')
-  assert.equal(readFileSync(join(engine, 'CLAUDE.md'), 'utf8').includes('one platform = one Run') || readFileSync(join(engine, 'CLAUDE.md'), 'utf8').includes('One folder = one platform'), true)
-  const engineJson = JSON.parse(readFileSync(join(engine, 'engine.json'), 'utf8'))
-  assert.equal(engineJson.schemaVersion, 'content-engine.v1')
-  assert.equal(engineJson.root, 'Content Engine')
-  assert.equal(engineJson.paths.runs, 'runs')
-  assert.equal(existsSync(join(engine, 'runs', '_template', 'idea.md')), true)
-  assert.equal(existsSync(join(engine, 'runs', '_template', 'run.md')), false)
-  assert.equal(existsSync(join(engine, 'platforms', 'ig.md')), true)
-  assert.equal(existsSync(join(engine, 'discovery', '_template.md')), true)
-  assert.equal(existsSync(join(engine, 'discovery', '_index.md')), true)
-  assert.equal(readFileSync(join(engine, 'CLAUDE.md'), 'utf8').includes('§ Discovery'), true)
-  assert.equal(existsSync(join(engine, 'workbench', 'build.py')), true)
-  assert.equal(existsSync(join(engine, 'workbench', 'template.html')), true)
-  assert.equal(existsSync(join(engine, 'workbench', 'index.html')), true)
-  const sentinel = join(engine, 'runs', 'user-note.md')
-  writeFileSync(sentinel, 'keep me', 'utf8')
-  const customTemplate = join(engine, 'workbench', 'template.html')
-  const before = readFileSync(customTemplate, 'utf8')
-  writeFileSync(customTemplate, `${before}\n<!-- user-custom -->\n`, 'utf8')
-  const second = run(['--root', root, '--apply', '--no-open'])
-  assert.equal(second.status, 0)
-  assert.equal(readFileSync(sentinel, 'utf8'), 'keep me')
-  assert.equal(readFileSync(customTemplate, 'utf8').includes('user-custom'), true)
-  assert.equal(JSON.parse(second.stdout).created.includes('CLAUDE.md'), false)
-
-  const detectRoot = join(fixture, 'DetectRoot')
-  const detectEngine = join(detectRoot, 'MyFolder', 'Content Engine')
-  mkdirSync(detectEngine, { recursive: true })
-  const detect = spawnSync(process.execPath, [script, '--detect', '--json'], {
-    encoding: 'utf8',
-    env: { ...env, EASYSOCIABLE_ENGINE_SEARCH_ROOTS: detectRoot },
-  })
-  assert.equal(detect.status, 0, detect.stdout + detect.stderr)
-  const detectReport = JSON.parse(detect.stdout)
-  assert.equal(detectReport.action, 'detect')
-  assert.equal(detectReport.engines.includes(detectEngine), true)
-
-  const validateOk = run(['--root', root, '--validate'])
-  assert.equal(validateOk.status, 0)
-  rmSync(join(engine, 'engine.json'))
-  const validateMissing = run(['--root', root, '--validate'])
-  assert.equal(validateMissing.status, 2)
-
-  console.log('Content Skill setup smoke passed.')
-}
-finally {
-  rmSync(fixture, { recursive: true, force: true })
-}

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

@@ -1,17 +0,0 @@
-# Local analysis notes
-
-Research before a topic or run exists. Capture still follows engine `CLAUDE.md` § Capture when the user is storing a source.
-
-## 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,24 +0,0 @@
-# Pack and export workflow
-
-The Content Skill records the run and verifies the local export. It does not render.
-
-```text
-one-platform run
-  → pack.md (slideshow, after SHIP)
-  → Slideshow/Template skill writes pack JSON / fill-slots
-  → Studio preview
-  → user confirmation
-  → PNG export
-  → {engine}/exports/<run-slug>/01.png + manifest.json
-```
-
-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

@@ -1,40 +0,0 @@
-# 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,5 +0,0 @@
-# Filesystem-first, then hosted MCP
-
-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 or open SQLite. Do not require Obsidian.

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

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

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

@@ -1,18 +0,0 @@
-# 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,29 +0,0 @@
-# Topic draft
-
-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,19 +0,0 @@
-# Working draft
-
-Write copy for **this run’s platform only**. Full gates: engine `CLAUDE.md` § Open a run.
-
-## 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.