@easysociable/cli 0.1.0

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@easysociable/cli",
+  "version": "0.1.0",
+  "description": "Agent-first CLI and MCP host for EasySociable Template and Slideshow V1",
+  "type": "module",
+  "license": "MIT",
+  "author": "EasySociable",
+  "homepage": "https://easysociable.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/murphywuwu/8MRR-Project.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/murphywuwu/8MRR-Project/issues"
+  },
+  "keywords": [
+    "easysociable",
+    "cli",
+    "mcp",
+    "social-media",
+    "templates",
+    "slideshow",
+    "agent"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "easysociable": "./bin/easysociable.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "skills",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "commander": "^11.1.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.8.3",
+    "vitest": "^1.3.1",
+    "@easysociable/tsconfig": "0.0.0",
+    "@easysociable/vitest-config": "0.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsup",
+    "pack:check": "npm pack --dry-run"
+  }
+}

package/skills/ONBOARDING.md

@@ -0,0 +1,61 @@
+# EasySociable agent-first onboarding
+
+V1 expects Codex or Claude Code to drive setup. The website is not the primary
+workspace.
+
+## User steps (3)
+
+1. **Install CLI**
+
+   ```bash
+   curl -fsSL https://easysociable.com/install.sh | bash
+   ```
+
+2. **Install hosted Skills + MCP** (Template + Slideshow by default)
+
+   ```bash
+   easysociable install --yes
+   ```
+
+3. **Ask the Agent to create graphics** — account creation is deferred until a
+   hosted operation requires authentication.
+
+Optional later:
+
+```bash
+easysociable install --skills content --yes
+```
+
+Then run the `easysociable-content` setup workflow (Obsidian Vault + Content
+Engine). Skipping Content does **not** block single-page or Slideshow renders.
+
+## Lazy auth (Agent script)
+
+When a Gateway call returns `AUTH_REQUIRED`, `API_KEY_INVALID`, or the CLI says
+`Run easysociable auth login`, respond with:
+
+```text
+EasySociable needs a workspace API key before it can preview or render on the
+Gateway.
+
+1. Open https://my.easysociable.com/auth/signup (or sign in with Google).
+2. Verify your email if you used password signup (required before API keys).
+3. Dashboard → API Keys → Create API key → copy the secret once.
+4. Run: easysociable auth login --api-key <paste-key> --gateway-url https://gateway.easysociable.com
+
+Tell me when that is done and I will continue.
+```
+
+After `auth login` succeeds, retry the failed operation with the same
+idempotency key when applicable.
+
+## What works without auth
+
+- `easysociable install` / `update`
+- Reading installed Skill instructions
+- Public template catalog in the browser (`/templates`)
+
+## What requires auth
+
+- Profiles, Themes, images, drafts, Slideshow Runs
+- Hosted preview sessions and final PNG renders (`hosted_render_page` allowance)

package/skills/easysociable-content/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: easysociable-content
+description: >
+  Set up and operate a local Obsidian-based Content Engine for EasySociable.
+  Obsidian is required. During setup, ask the user to choose 中文 or English;
+  that locale names the engine folders and starter notes. This Skill records
+  Runs, Packs and exports for the Template and Slideshow Skills. It does not
+  provide a hosted content backend, Content API, SQLite runtime, content MCP
+  server or content CLI.
+---
+
+# EasySociable Content Skill
+
+This Skill owns the user's local knowledge base. It is intentionally filesystem-
+first: the Agent writes Markdown and JSON under the user's existing Obsidian
+Vault, while hosted Template and Slideshow operations are performed later by
+the unified `easysociable` CLI/MCP.
+
+## Non-negotiable rules
+
+1. Obsidian must already be installed. If it is missing, stop and give the
+   official installation guidance; do not create a partial vault.
+2. Ask the user to choose **中文 (`zh`)** or **English (`en`)** before the first
+   preview. Do not default the locale silently.
+3. Ask the user to choose an existing Vault. Never create a new Vault silently.
+4. Create or validate only the locale root: `Content Engine/` (`en`) or
+   `内容引擎/` (`zh`). Never create both in one Vault.
+5. Existing Content Engine files are read-only during setup. Report differences
+   and ask before any migration; never auto-repair or overwrite user content.
+6. Do not start a Local API, open SQLite, call Content MCP, or call private
+   Directus/R2/Stripe endpoints.
+7. Every intent/run is saved under the locale runs folder (`runs/<slug>/` or
+   `成稿/<slug>/`). Every platform gets a Pack. Binary outputs belong only
+   under the locale exports folder.
+8. The host Agent owns copy and semantic decisions. Template and Slideshow Skills
+   own template selection, hosted preview and final rendering.
+9. V1 final output is PNG only. Never create ZIP, JPEG, WebP, PDF or video output.
+10. `content-pack.v1` JSON field names, `role` values and slot keys stay English
+    even when the vault language is 中文. Folder names and Markdown notes follow
+    the chosen locale.
+
+## Setup workflow
+
+1. Detect Obsidian.app.
+2. Ask: 内容引擎用中文还是 English？ Map the answer to `--locale zh` or `--locale en`.
+3. Ask for an existing Vault path.
+4. Preview with `scripts/setup.mjs --vault <path> --locale zh|en --preview --json`.
+5. Create the sanitized Starter and generalized `CLAUDE.md` only after confirmation,
+   using `--apply`.
+6. Open the Vault in Obsidian.
+7. Return the Vault path, locale, engine folder name, and the next workflow.
+
+The deterministic setup helper is `scripts/setup.mjs`. Use `--preview` before
+`--apply`; it never overwrites an existing file and refuses to create anything
+when Obsidian is not installed. It is a helper for the host Agent, not a
+separate product CLI.
+
+After setup, read `locale.json` in the engine root (or detect `内容引擎/` vs
+`Content Engine/`) and keep using that tree. Do not switch language later.
+
+The Starter contains empty indexes, templates and operating rules only. It must
+not contain the owner's personal examples, previous Runs or generated media.
+
+## Run and Pack workflow
+
+For each piece of content, create a local Run with:
+
+- a stable slug and title;
+- platform and language;
+- semantic outline and page roles;
+- generated copy and selected media references;
+- the chosen Profile/Theme identifiers when known;
+- links to the corresponding platform Pack and export Manifest.
+
+Write user-facing notes in the vault locale. The Pack is the handoff to
+`easysociable-slideshow`. It contains public page roles and slot values, never
+private AST, Binding Maps, RenderPlans or a hosted ContentDocument:
+
+```json
+{
+  "schemaVersion": "content-pack.v1",
+  "platform": "tiktok",
+  "title": "A short story",
+  "pages": [
+    { "role": "hook", "slots": { "text_0": "Hook", "text_1": "Support" } },
+    { "role": "value", "slots": { "text_0": "One idea" } }
+  ]
+}
+```
+
+## Handoff
+
+For a single image, hand the selected published Page Template and slot values to
+the Template workflow. For a slideshow:
+
+1. write the Pack to the Run folder;
+2. ask the Slideshow Skill to create/update a temporary Run;
+3. let the Agent review the returned Studio URL;
+4. after confirmation, let the Agent call `easysociable slideshows render`;
+5. let the Agent call `easysociable renders export` to atomically write PNGs and
+   `manifest.json` under the Run's exports directory.
+
+Preview is not a final local export and does not consume hosted Render Page
+allowance. The final render does.
+
+Network research is optional. If the host does not expose a search tool, keep
+the source URL in the local note and continue with user-provided evidence; do
+not install an MCP server automatically and do not block vault setup.
+
+## Required references
+
+- `references/PAGE_PACK.md`
+- `references/VAULT.md`
+- `workflows/CONTENT_EXPORT.md`
+- `workflows/MCP_FIRST.md` (for the unified CLI/MCP handoff only)

package/skills/easysociable-content/platforms/claude.md

@@ -0,0 +1,5 @@
+# Claude Desktop
+
+- Install the unified EasySociable Skill bundle. Content remains Obsidian-first;
+  hosted Template/Slideshow calls use the unified `easysociable` CLI/MCP.
+- Prefer the Skill frontmatter in each `SKILL.md`.

package/skills/easysociable-content/platforms/codex.md

@@ -0,0 +1,5 @@
+# Codex
+
+- Install `skills/easysociable-content` under the host skill directory for local content workflows.
+- Install the unified EasySociable Skill bundle; hosted preview/render uses the
+  unified `easysociable` CLI/MCP.

package/skills/easysociable-content/platforms/hermes.md

@@ -0,0 +1,5 @@
+# Hermes overrides
+
+- Point Hermes skill loader at this directory.
+- Prefer explicit Vault paths in multiprocess environments; do not use the
+  retired `--data-dir` Runtime option.

package/skills/easysociable-content/platforms/openclaw.md

@@ -0,0 +1,5 @@
+# OpenClaw overrides
+
+- Register the unified `easysociable` CLI/MCP entry.
+- Keep API Keys and session material out of tool logs. Gateway authentication is
+  owned by the unified client.

package/skills/easysociable-content/references/CLI.md

@@ -0,0 +1,27 @@
+# Content Skill filesystem reference
+
+The Content Skill does not own a Content CLI in V1. It writes the user's
+existing Obsidian Vault directly and uses the unified `easysociable` command only
+for the hosted Template/Slideshow handoff.
+
+## Local workflow
+
+Use the host's filesystem tools to detect Obsidian, ask for 中文 or English,
+choose a Vault, preview the locale engine paths (`Content Engine/` or
+`内容引擎/`) with `--locale zh|en`, create or validate Markdown/JSON files after
+confirmation, and open the Vault in Obsidian.
+
+Do not invent `easysociable-content init/start/doctor` commands and do not pass
+`--data-dir`. Those belong to the retired Content Runtime.
+
+## Hosted handoff
+
+```bash
+easysociable templates list --platforms tiktok --json
+easysociable slideshows create --file ./runs/<slug>/pack-tiktok.json --json
+easysociable slideshows render --id run_xxx --idempotency-key run_xxx-final-1 --json
+easysociable renders wait --id job_xxx --json
+easysociable renders export --id job_xxx --output ./exports/<slug>/tiktok --json
+```
+
+Use the unified MCP first when the host exposes it. The CLI is the fallback.

package/skills/easysociable-content/references/MCP.md

@@ -0,0 +1,20 @@
+# Unified MCP reference
+
+V1 has one MCP server installed by the unified EasySociable installer. It owns
+hosted Template, Image, Profile, Theme, Slideshow and Render tools. The Content
+Skill itself does not require a Content MCP or local MCP bridge.
+
+Use the MCP tool registry exposed by `easysociable mcp serve --transport stdio`. Content work stays
+in the Obsidian filesystem; hosted calls use the same Gateway client and account
+as the CLI.
+
+## Handoff sequence
+
+1. Write a `content-pack.v1` into the local Run folder.
+2. Call `create_slideshow_run` with the Pack.
+3. Open the returned Studio URL and wait for Save.
+4. After confirmation call `render_slideshow_run`.
+5. Poll the render job and export the PNG set into the Vault.
+
+The MCP server must never expose private AST, Binding Maps, RenderPlans, R2
+credentials, Directus credentials, Stripe credentials or Local Runtime tokens.

package/skills/easysociable-content/references/PAGE_PACK.md

@@ -0,0 +1,6 @@
+# PagePack handoff
+
+`content-pack.v1` is the boundary between semantic content and visual
+composition. It contains platform, optional title, and ordered pages with a
+semantic `role` and public `slots`. The Slideshow Skill performs template
+selection and rendering; Content does not call Template APIs.

package/skills/easysociable-content/references/TROUBLESHOOTING.md

@@ -0,0 +1,11 @@
+# Troubleshooting
+
+The V1 Content Skill has no Content CLI, Local API, SQLite runtime or runtime
+token. If setup fails, stop before writing files, show the Obsidian install and
+Vault-selection guidance, and ask the user to retry after the prerequisite is
+ready. Never invent `--data-dir`, `init`, `doctor` or runtime credentials.
+
+If a local Run is incomplete, keep the existing Markdown/JSON intact and report
+the missing file or field. Do not auto-migrate or repair an existing Content
+Engine folder. Publication, metrics, retrospectives and experiments are
+deferred in V1; keep those notes as ordinary Markdown only.

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

@@ -0,0 +1,20 @@
+# Vault layout
+
+Setup asks the user to choose a locale, then creates one engine root:
+
+| Locale | Root | Runs | Exports |
+|---|---|---|---|
+| `en` | `Content Engine/` | `runs/<slug>/` | `exports/<slug>/<platform>/` |
+| `zh` | `内容引擎/` | `成稿/<slug>/` | `导出/<slug>/<platform>/` |
+
+Read `locale.json` in that root after setup:
+
+```json
+{ "locale": "zh" }
+```
+
+English folders stay English (`accounts`, `inbox`, `swipe`, `topics`, …).
+Chinese folders are `账号`, `收件箱`, `拆解`, `选题`, `素材`, `档案`, `已发布`,
+`百科`, `平台`. Platform note filenames stay `x.md`, `threads.md`, `tiktok.md`.
+
+Never create both roots in one Vault. Pack JSON keys stay English.

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

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { ROOT, filesFor } from './starter.mjs'
+
+const LOCALES = new Set(['en', 'zh'])
+
+function obsidianCandidates() {
+  if (process.env.EASYSOCIABLE_OBSIDIAN_APP)
+    return [process.env.EASYSOCIABLE_OBSIDIAN_APP]
+  return [
+    '/Applications/Obsidian.app',
+    join(homedir(), 'Applications/Obsidian.app'),
+    '/System/Applications/Obsidian.app',
+  ].filter(Boolean)
+}
+
+function hasObsidian() {
+  if (process.env.EASYSOCIABLE_SKIP_OBSIDIAN_CHECK === 'true') return true
+  return obsidianCandidates().some((path) => existsSync(path))
+}
+
+function parseArgs(argv) {
+  const options = { vault: '', locale: '', apply: false, validate: false, preview: false, noOpen: false, json: false }
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--vault') options.vault = argv[++i] ?? ''
+    else if (arg === '--locale') options.locale = argv[++i] ?? ''
+    else if (arg === '--apply') options.apply = true
+    else if (arg === '--validate') options.validate = true
+    else if (arg === '--preview') options.preview = true
+    else if (arg === '--no-open') options.noOpen = true
+    else if (arg === '--json') options.json = true
+    else if (arg === '--help' || arg === '-h') options.help = true
+    else throw new Error(`Unknown argument: ${arg}`)
+  }
+  return options
+}
+
+function output(value, json) {
+  process.stdout.write(json ? `${JSON.stringify(value, null, 2)}\n` : `${value.message ?? value}\n`)
+}
+
+function isDir(path) {
+  return existsSync(path) && statSync(path).isDirectory()
+}
+
+function enginePaths(vault) {
+  return { en: join(vault, ROOT.en), zh: join(vault, ROOT.zh) }
+}
+
+function detectedLocale(vault) {
+  const paths = enginePaths(vault)
+  const en = isDir(paths.en)
+  const zh = isDir(paths.zh)
+  if (en && zh) return { code: 'BOTH_ENGINES', message: 'Vault has both Content Engine/ and 内容引擎/. Choose one folder before setup.' }
+  if (zh) return { locale: 'zh' }
+  if (en) return { locale: 'en' }
+  return { locale: '' }
+}
+
+function resolveLocale(vault, requested) {
+  if (requested && !LOCALES.has(requested)) {
+    return { code: 'LOCALE_INVALID', message: 'Choose --locale en or --locale zh.' }
+  }
+  const found = detectedLocale(vault)
+  if (found.code) return found
+  if (requested && found.locale && requested !== found.locale) {
+    return { code: 'LOCALE_MISMATCH', message: `Vault already uses locale ${found.locale}. Do not create the other language tree.` }
+  }
+  const locale = requested || found.locale
+  if (!locale) return { code: 'LOCALE_REQUIRED', message: 'Ask the user to choose 中文 (zh) or English (en), then pass --locale.' }
+  return { locale }
+}
+
+function inventory(root, locale) {
+  const files = filesFor(locale)
+  const engine = join(root, ROOT[locale])
+  const missing = []
+  const existing = []
+  for (const relative of Object.keys(files)) {
+    const path = join(engine, relative)
+    ;(existsSync(path) ? existing : missing).push(relative)
+  }
+  return { engine, locale, rootName: ROOT[locale], missing, existing }
+}
+
+function validateVault(vault, requestedLocale) {
+  const absolute = resolve(vault)
+  const errors = []
+  if (!existsSync(absolute) || !statSync(absolute).isDirectory()) errors.push('Vault path does not exist or is not a directory')
+  const resolved = errors.length ? { locale: requestedLocale || 'en' } : resolveLocale(absolute, requestedLocale)
+  if (resolved.code) return { vault: absolute, valid: false, errors: [resolved.message], ...resolved, created: [] }
+  const result = inventory(absolute, resolved.locale)
+  if (existsSync(result.engine) && !isDir(result.engine)) errors.push(`${result.rootName} exists but is not a directory`)
+  return { vault: absolute, ...result, valid: errors.length === 0, errors }
+}
+
+function applyStarter(vault, locale, noOpen) {
+  const report = validateVault(vault, locale)
+  if (!report.valid) return report
+  const files = filesFor(report.locale)
+  mkdirSync(report.engine, { recursive: true })
+  for (const relative of report.missing) {
+    const path = join(report.engine, relative)
+    mkdirSync(join(path, '..'), { recursive: true })
+    writeFileSync(path, files[relative], { encoding: 'utf8', flag: 'wx' })
+  }
+  if (!noOpen && process.env.EASYSOCIABLE_NO_OPEN !== 'true') {
+    const vaultName = report.vault.split('/').pop() ?? 'Vault'
+    spawnSync('open', [`obsidian://open?vault=${encodeURIComponent(vaultName)}`], { stdio: 'ignore' })
+  }
+  return { ...validateVault(vault, report.locale), created: [...report.missing] }
+}
+
+function printHelp() {
+  process.stdout.write(`Usage: node setup.mjs --vault <existing-vault> --locale en|zh [--preview|--apply|--validate] [--no-open] [--json]\n\nObsidian must be installed. Ask the user to choose English or 中文 before apply. Existing files are never overwritten.\n`)
+}
+
+try {
+  const options = parseArgs(process.argv.slice(2))
+  if (options.help) {
+    printHelp()
+    process.exit(0)
+  }
+  if (!hasObsidian()) {
+    const error = { code: 'OBSIDIAN_REQUIRED', message: 'Obsidian.app is required. Install Obsidian from https://obsidian.md/download before setup.', created: false }
+    output(error, options.json)
+    process.exitCode = 2
+  }
+  else if (!options.vault) {
+    output({ code: 'VAULT_REQUIRED', message: 'Choose an existing Obsidian Vault with --vault.', created: false }, options.json)
+    process.exitCode = 2
+  }
+  else {
+    const report = validateVault(options.vault, options.locale)
+    if (!report.valid) {
+      output({ ...report, created: [] }, options.json)
+      process.exitCode = 2
+    }
+    else if (options.apply) {
+      const applied = applyStarter(options.vault, report.locale, options.noOpen)
+      output({ ...applied, action: 'applied' }, options.json)
+    }
+    else {
+      output({ ...report, action: options.validate ? 'validated' : 'preview', created: [] }, options.json)
+    }
+  }
+}
+catch (error) {
+  output({ code: 'CONTENT_SETUP_FAILED', message: error instanceof Error ? error.message : String(error), created: false }, true)
+  process.exitCode = 1
+}

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

@@ -0,0 +1,71 @@
+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 vault = join(fixture, 'Vault')
+mkdirSync(vault)
+const env = { ...process.env, EASYSOCIABLE_SKIP_OBSIDIAN_CHECK: 'true', EASYSOCIABLE_NO_OPEN: 'true' }
+
+function run(args) {
+  return spawnSync(process.execPath, [script, ...args, '--json'], { encoding: 'utf8', env })
+}
+
+try {
+  const missingObsidian = spawnSync(process.execPath, [script, '--vault', vault, '--locale', 'en', '--apply', '--json'], {
+    encoding: 'utf8',
+    env: { ...env, EASYSOCIABLE_SKIP_OBSIDIAN_CHECK: 'false', EASYSOCIABLE_OBSIDIAN_APP: join(fixture, 'missing-Obsidian.app') },
+  })
+  assert.equal(missingObsidian.status, 2)
+  assert.equal(existsSync(join(vault, 'Content Engine')), false)
+
+  const missingLocale = run(['--vault', vault, '--preview'])
+  assert.equal(missingLocale.status, 2)
+  assert.equal(JSON.parse(missingLocale.stdout).code, 'LOCALE_REQUIRED')
+
+  const preview = run(['--vault', vault, '--locale', 'en', '--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.locale, 'en')
+
+  const apply = run(['--vault', vault, '--locale', 'en', '--apply', '--no-open'])
+  assert.equal(apply.status, 0)
+  const applied = JSON.parse(apply.stdout)
+  assert.equal(applied.action, 'applied')
+  assert.equal(applied.created.length > 5, true)
+  assert.equal(readFileSync(join(vault, 'Content Engine', 'CLAUDE.md'), 'utf8').includes('local Obsidian'), true)
+  assert.equal(JSON.parse(readFileSync(join(vault, 'Content Engine', 'locale.json'), 'utf8')).locale, 'en')
+
+  const sentinel = join(vault, 'Content Engine', 'runs', 'user-note.md')
+  writeFileSync(sentinel, 'keep me', 'utf8')
+  const second = run(['--vault', vault, '--apply', '--no-open'])
+  assert.equal(second.status, 0)
+  assert.equal(readFileSync(sentinel, 'utf8'), 'keep me')
+
+  const mismatch = run(['--vault', vault, '--locale', 'zh', '--apply', '--no-open'])
+  assert.equal(mismatch.status, 2)
+  assert.equal(JSON.parse(mismatch.stdout).code, 'LOCALE_MISMATCH')
+  assert.equal(existsSync(join(vault, '内容引擎')), false)
+
+  const zhVault = join(fixture, 'ZhVault')
+  mkdirSync(zhVault)
+  const zhApply = run(['--vault', zhVault, '--locale', 'zh', '--apply', '--no-open'])
+  assert.equal(zhApply.status, 0)
+  const zhEngine = join(zhVault, '内容引擎')
+  assert.equal(existsSync(join(vault, 'Content Engine')), true)
+  assert.equal(readFileSync(join(zhEngine, 'CLAUDE.md'), 'utf8').includes('内容引擎'), true)
+  assert.equal(existsSync(join(zhEngine, '成稿', '_索引.md')), true)
+  assert.equal(existsSync(join(zhEngine, '选题', '观察清单.md')), true)
+  assert.equal(JSON.parse(readFileSync(join(zhEngine, 'locale.json'), 'utf8')).locale, 'zh')
+  assert.equal(existsSync(join(zhVault, 'Content Engine')), false)
+
+  console.log('Content Skill setup smoke passed.')
+}
+finally {
+  rmSync(fixture, { recursive: true, force: true })
+}

package/skills/easysociable-content/scripts/starter.mjs

@@ -0,0 +1,53 @@
+export const ROOT = { en: 'Content Engine', zh: '内容引擎' }
+
+export const STARTER = {
+  en: {
+    'CLAUDE.md': `# Content Engine\n\nThis folder is the local Obsidian source of truth for EasySociable content runs.\n\n- Keep semantic copy and media references here.\n- Save each run under \`runs/<slug>/\`.\n- Save final PNGs and manifest files only under \`exports/<slug>/<platform>/\`.\n- Do not put private Template AST, Binding Maps or RenderPlans in this vault.\n- Use the unified \`easysociable\` CLI/MCP for hosted Template and Slideshow operations.\n- Pack JSON (\`content-pack.v1\`) field names stay English for the Slideshow handoff.\n`,
+    'accounts/_index.md': '# Accounts\n\nAdd account notes here. Do not store API keys or passwords.\n',
+    'exports/README.md': '# Exports\n\nFinal PNGs and manifests written by the unified render export command.\n',
+    'inbox/README.md': '# Inbox\n\nTemporary notes awaiting triage into topics, swipe files or runs.\n',
+    'inbox/_index.md': '# Inbox Index\n',
+    'profiles/_index.md': '# Profiles\n\nStore local profile references and presentation preferences.\n',
+    'published/_index.md': '# Published\n\nOptional local index of content already published elsewhere.\n',
+    'raw/_index.md': '# Raw\n\nSource notes and imported research.\n',
+    'runs/README.md': '# Runs\n\nEach run stores semantic content, platform Packs and render references.\n',
+    'runs/_index.md': '# Runs Index\n',
+    'swipe/_index.md': '# Swipe\n',
+    'swipe/_template.md': '# Swipe Item\n\n## Source\n\n## Pattern\n\n## Reusable insight\n',
+    'topics/_index.md': '# Topics\n',
+    'topics/WATCHLIST.md': '# Watchlist\n\nKeep links and observations here. Network tools are optional.\n',
+    'topics/_template-item.md': '# Topic\n\n## Thesis\n\n## Audience\n\n## Evidence\n',
+    'wiki/README.md': '# Wiki\n\nStable concepts and operating rules.\n',
+    'platforms/x.md': '# X\n\nKeep X-specific copy and constraints here.\n',
+    'platforms/threads.md': '# Threads\n\nKeep Threads-specific copy and constraints here.\n',
+    'platforms/tiktok.md': '# TikTok\n\nKeep TikTok-specific copy and constraints here.\n',
+  },
+  zh: {
+    'CLAUDE.md': `# 内容引擎\n\n此文件夹是 EasySociable 内容成稿的本地 Obsidian 真相源。\n\n- 在此保存语义文案和素材引用。\n- 每条成稿放在 \`成稿/<slug>/\`。\n- 最终 PNG 和清单只放在 \`导出/<slug>/<platform>/\`。\n- 不要把模板私有 AST、Binding Map 或 RenderPlan 放进此库。\n- 托管的模板与幻灯片操作使用统一的 \`easysociable\` CLI/MCP。\n- Pack JSON（\`content-pack.v1\`）的字段名保持英文，以便交给 Slideshow Skill。\n`,
+    '账号/_索引.md': '# 账号\n\n在此记录账号备注。不要存放 API 密钥或密码。\n',
+    '导出/说明.md': '# 导出\n\n由统一渲染导出命令写入的最终 PNG 和清单文件。\n',
+    '收件箱/说明.md': '# 收件箱\n\n待整理到选题、拆解或成稿的临时笔记。\n',
+    '收件箱/_索引.md': '# 收件箱索引\n',
+    '档案/_索引.md': '# 档案\n\n存放本地档案引用和呈现偏好。\n',
+    '已发布/_索引.md': '# 已发布\n\n可选：已在其他地方发布的内容本地索引。\n',
+    '素材/_索引.md': '# 素材\n\n源笔记和导入的调研。\n',
+    '成稿/说明.md': '# 成稿\n\n每条成稿保存语义内容、各平台 Pack 和渲染引用。\n',
+    '成稿/_索引.md': '# 成稿索引\n',
+    '拆解/_索引.md': '# 拆解\n',
+    '拆解/_模板.md': '# 拆解条目\n\n## 来源\n\n## 模式\n\n## 可复用洞察\n',
+    '选题/_索引.md': '# 选题\n',
+    '选题/观察清单.md': '# 观察清单\n\n在此保存链接和观察。网络检索工具是可选的。\n',
+    '选题/_模板.md': '# 选题\n\n## 论点\n\n## 受众\n\n## 证据\n',
+    '百科/说明.md': '# 百科\n\n稳定概念和操作规则。\n',
+    '平台/x.md': '# X\n\n在此保存 X 平台的文案和约束。\n',
+    '平台/threads.md': '# Threads\n\n在此保存 Threads 平台的文案和约束。\n',
+    '平台/tiktok.md': '# TikTok\n\n在此保存 TikTok 平台的文案和约束。\n',
+  },
+}
+
+export function filesFor(locale) {
+  return {
+    ...STARTER[locale],
+    'locale.json': `${JSON.stringify({ locale }, null, 2)}\n`,
+  }
+}

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

@@ -0,0 +1,8 @@
+# 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.
+
+Template and Slideshow Skills consume the resulting local Pack only after the
+Agent and user agree on the content.

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

@@ -0,0 +1,19 @@
+# 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.
+
+```text
+Obsidian Run
+  → platform Pack
+  → unified Template/Slideshow MCP or CLI
+  → Studio preview
+  → user confirmation
+  → final PNG render
+  → renders export
+  → locale exports/<slug>/<platform>/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.