@easysociable/cli 0.1.2 → 0.1.3

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

@@ -1,40 +0,0 @@
-# Content Skill filesystem reference
-
-The Content Skill does not own a Content CLI. It writes `Content Engine/` on disk and uses the unified `easysociable` command only for hosted Template/Slideshow handoff.
-
-## Local workflow
-
-Ask for a parent directory (or existing engine path). Do not ask language. Do not require Obsidian.
-
-Do not invent `easysociable-content init/start/doctor`.
-
-## Setup
-
-```bash
-node scripts/setup.mjs --detect --json
-node scripts/setup.mjs --root <parent-or-engine> --preview --json
-node scripts/setup.mjs --root <parent-or-engine> --apply --json
-node scripts/setup.mjs --root <parent-or-engine> --validate --json
-node scripts/workbench.mjs start --engine <Content Engine> --json
-node scripts/workbench.mjs build --engine <Content Engine> --json
-```
-
-`--no-open` skips the browser and the workbench server.
-
-## 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 slideshows export --id run_xxx --output ./exports/<slug> --json
-```
-
-Validate before slideshow create:
-
-```bash
-node scripts/validate-run.mjs --run ./runs/<slug> --require-pack --json
-node scripts/validate-pack.mjs --file ./runs/<slug>/pack-tiktok.json --json
-```
-
-Use unified MCP first when the host exposes it. CLI is the fallback.

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

@@ -1,42 +0,0 @@
-# Contract sync
-
-Pack validation in this skill mirrors the hosted public contract. When those
-contracts change, update this skill in the same PR.
-
-## Source of truth
-
-| Contract | Repository path |
-|---|---|
-| `content-pack.v1` schema | `packages/template-public-contracts/src/index.ts` → `contentPackSchema` |
-| Platform page caps | `slideshowPlatformCaps` in the same file |
-| Page roles | `pageRoleSchema` in the same file |
-
-## Mirrored in skill
-
-| Skill file | What to sync |
-|---|---|
-| `scripts/contracts.mjs` | caps, roles, forbidden keys, validate logic |
-| `references/PAGE_PACK.md` | Agent-facing summary + examples |
-| `references/PLATFORM_GUIDE.md` | slideshow vs template routing |
-
-## Maintainer checklist
-
-Before merging contract changes:
-
-1. Diff `contentPackSchema` / `slideshowPlatformCaps` / `pageRoleSchema`.
-2. Update `contracts.mjs` and `PAGE_PACK.md`.
-3. Run:
-
-   ```bash
-   node skills/easysociable-content/scripts/validate.test.mjs
-   node skills/easysociable-content/scripts/fixture.test.mjs
-   node skills/easysociable-content/scripts/setup.test.mjs
-   ```
-
-4. If caps or roles changed, refresh `fixtures/golden-run-en/pack-tiktok.json` when needed.
-
-## Optional hard sync (future)
-
-Import `contentPackSchema` from `@easysociable/template-public-contracts` in
-`validate-pack.mjs` once skill scripts run through the monorepo toolchain. Until
-then, `contracts.mjs` is the portable mirror (marked with `ponytail:`).

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

@@ -1,15 +0,0 @@
-# Unified MCP reference
-
-V1 has one MCP server from the unified EasySociable installer. It owns hosted Template, Image, Profile, Theme, Slideshow and Render tools. This Content Skill does not require a Content MCP.
-
-Content work stays on disk under `Content Engine/`. Hosted calls use the same Gateway client as the CLI.
-
-## Handoff sequence
-
-1. After SHIP, write `pack.md` (slideshow) or slot values (single-page).
-2. Slideshow skill writes `content-pack.v1` into the run folder, then `create_slideshow_run`.
-3. Open Studio URL; wait for Save.
-4. After confirmation call `render_slideshow_run`.
-5. Export PNGs into `exports/<run-slug>/`.
-
-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

@@ -1,129 +0,0 @@
-# PagePack handoff (`content-pack.v1`)
-
-The Pack is the boundary between semantic content (Content Skill) and visual
-composition (Template / Slideshow Skills). Content writes slots and roles;
-downstream skills choose Page Templates and render.
-
-**Source of truth for caps and roles:** `packages/template-public-contracts`
-(`contentPackSchema`). This file is the Agent-facing summary.
-
-## Schema
-
-```json
-{
-  "schemaVersion": "content-pack.v1",
-  "platform": "tiktok",
-  "title": "Optional title",
-  "pages": [
-    {
-      "role": "hook",
-      "slots": { "text_0": "Hook line", "text_1": "Support" },
-      "pageTemplateId": "tpl_selected_at_handoff"
-    }
-  ]
-}
-```
-
-| Field | Required | Notes |
-|---|---|---|
-| `schemaVersion` | yes | Must be `content-pack.v1` |
-| `platform` | yes | See platform table below |
-| `title` | no | Display title for Studio |
-| `pages` | yes | Ordered array, length within platform caps |
-| `pages[].role` | yes | Closed `pageRoles` enum |
-| `pages[].slots` | yes | Public slot key → string/number/boolean/null |
-| `pages[].pageTemplateId` | yes | Published Page Template selected by Slideshow before `create` |
-
-## Forbidden in Pack
-
-Never include:
-
-- `deck_template_id` / Deck references
-- Template AST, Binding Maps, RenderPlans
-- `ContentDocument` / `contentDocumentHash`
-- Private gateway credentials or image URLs as slot values (use `imageId` after import)
-
-## Platform page caps
-
-| Platform | Min pages | Max pages | V1 Slideshow |
-|---|---:|---:|---|
-| `tiktok` | 4 | 35 | yes |
-| `instagram` | 2 | 20 | yes |
-| `linkedin` | 2 | 300 | yes |
-| `threads` | 2 | 20 | yes |
-| `xiaohongshu` | — | — | not a Content Pack route in V1; use Template single-page |
-
-`x` is not a Pack platform. Use Template fill-slots for single-page X graphics.
-
-## Page roles (closed set)
-
-`cover`, `hook`, `setup`, `context`, `value`, `point`, `checklist`, `proof`,
-`evidence`, `compare`, `screenshot`, `metric`, `quote`, `steps`, `cta`, `follow`, `recap`
-
-Pick roles that match the narrative arc. Slideshow maps each page to a published
-Page Template with compatible `supportedRoles`.
-
-## File naming
-
-During the run, write vault-native pack markdown:
-
-```text
-pack.md
-pack-<platform>.md
-```
-
-`content-pack.v1` JSON is created **at Slideshow/Template handoff**, not during draft:
-
-```text
-pack-<platform>.json
-```
-
-Example: `pack-tiktok.json`. Pure X text has no pack.
-
-## Validation
-
-```bash
-node scripts/validate-pack.mjs --file ./pack-tiktok.json --platform tiktok --json
-```
-
-Before Slideshow `create`, also run:
-
-```bash
-node scripts/validate-pack.mjs --file ./pack-tiktok.json --require-page-template-id --json
-```
-
-## Examples
-
-### English — TikTok (4 pages, content stage)
-
-```json
-{
-  "schemaVersion": "content-pack.v1",
-  "platform": "tiktok",
-  "title": "Morning routine tips",
-  "pages": [
-    { "role": "hook", "pageTemplateId": "tpl_hook_001", "slots": { "text_0": "Stop scrolling — this changed my mornings" } },
-    { "role": "value", "pageTemplateId": "tpl_value_001", "slots": { "text_0": "Wake at the same time", "text_1": "No phone for 20 minutes" } },
-    { "role": "value", "pageTemplateId": "tpl_value_001", "slots": { "text_0": "Move before caffeine", "text_1": "Even 5 minutes counts" } },
-    { "role": "cta", "pageTemplateId": "tpl_cta_001", "slots": { "text_0": "Save this for tomorrow" } }
-  ]
-}
-```
-
-### 中文 — TikTok（4 页，内容阶段）
-
-```json
-{
-  "schemaVersion": "content-pack.v1",
-  "platform": "tiktok",
-  "title": "晨间习惯三条",
-  "pages": [
-    { "role": "hook", "pageTemplateId": "tpl_hook_001", "slots": { "text_0": "别再瞎忙了——我靠这三条稳住早晨" } },
-    { "role": "value", "pageTemplateId": "tpl_value_001", "slots": { "text_0": "固定起床时间", "text_1": "醒来先别碰手机" } },
-    { "role": "value", "pageTemplateId": "tpl_value_001", "slots": { "text_0": "喝咖啡前先动一动", "text_1": "五分钟也算数" } },
-    { "role": "cta", "pageTemplateId": "tpl_cta_001", "slots": { "text_0": "先收藏，明早试" } }
-  ]
-}
-```
-
-JSON field names and `role` values stay English even when slot copy is 中文.

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

@@ -1,36 +0,0 @@
-# Platform guide
-
-Use this matrix before opening a run. **Ask** if the user did not name a platform. Multi-select → **N runs**.
-
-| Platform | Slideshow (V1) | Pack platform key | Page cap (slideshow) | Default path |
-|---|---|---|---:|---|
-| TikTok | yes | `tiktok` | 4–35 | Slideshow |
-| Instagram | yes | `instagram` (`ig`) | 2–20 | Slideshow |
-| LinkedIn | yes | `linkedin` | 2–300 | Slideshow |
-| Threads | yes | `threads` | 2–20 | Slideshow |
-| X | **no** | — (no Pack) | — | Template single-page or text-only |
-| Xiaohongshu | **no** (V1) | — | — | Template single-page |
-
-Craft notes live under `Content Engine/platforms/`. Map: `instagram` → `ig.md`. Read the file before brief/draft/editor.
-
-## Routing
-
-```text
-1 page                          → easysociable-template
-2+ pages + slideshow platform   → easysociable-slideshow
-x                               → easysociable-template only (if images)
-xiaohongshu                     → easysociable-template until slideshow ships
-```
-
-## Canvas hints (for downstream skills)
-
-| Platform | Typical canvas | Notes |
-|---|---|---|
-| tiktok | 9:16 @ 1080×1920 | Photo Mode carousel |
-| instagram / ig | 4:5 or 1:1 @ 1080 | Feed carousel |
-| linkedin | 4:5 or 1:1 | Document-style decks |
-| threads | 4:5 or 1:1 | Conversational copy |
-| x | 16:9 or 1:1 | Single image post |
-| xiaohongshu | 3:4 @ 1080×1440 | See Template `PLATFORM_SPECS` |
-
-Content Skill does not pick Page Templates — only platform, roles and slot copy. Pack JSON is written at Slideshow/Template handoff, not during draft.

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

@@ -1,73 +0,0 @@
-# Run layout
-
-Copy `runs/_template/` to `runs/<YYYY-MM-DD-short-slug[-platform]>/`.
-
-**One folder = one platform.** Same Topic on another network = another folder sharing `topic_id`.
-
-```text
-Content Engine/runs/<slug>/
-```
-
-## Core files
-
-| File | Purpose |
-|---|---|
-| `idea.md` | Run id, status, **this** platform, selection (`swipe_id` / `atoms` / `claim_id`) |
-| `brief.md` | Angle, constraints, selection why |
-| `packet.md` | Writer context (pillar + voice + audience + craft notes) |
-| `draft.md` | Copy for **this platform only** |
-| `editor.md` | REVISE / APPROVE |
-| `rubric.md` | 6 × 0–2; SHIP ≥ 8 |
-| `pack.md` | Image deck slots after SHIP (slideshow platforms) |
-| `feedback.md` | URL + `win`/`flat`/`loss` after publish |
-| `pack-<platform>.json` | Complete `content-pack.v1` — **only at render handoff** |
-
-## `idea.md` frontmatter
-
-```yaml
----
-run_id: RUN-YYYYMMDD-slug
-status: RUN_OPEN
-created: YYYY-MM-DD
----
-```
-
-Body must include `primary_platform` equal to `platforms` (single value) and the three selection fields. `none` is allowed with why.
-
-### File status vs index status
-
-| `idea.md` | `runs/_index.md` |
-|---|---|
-| `RUN_OPEN` | `open` |
-| `BRIEF_WAIT` | `brief` |
-| `DRAFTED` / `EDIT_WAIT` | `draft` |
-| `SCORED` | `scored` |
-| `READY_TO_POST` | `ready` |
-| `PUBLISHED` | `published` |
-| `HOLD` / `KILLED` / `SUPERSEDED` | `hold` / `killed` / `superseded` |
-
-Do not use index status `partial` for new runs.
-
-## Validation
-
-Semantic run (no Pack JSON yet):
-
-```bash
-node scripts/validate-run.mjs --run <run-dir> --json
-```
-
-Slideshow handoff (Pack JSON required):
-
-```bash
-node scripts/validate-run.mjs --run <run-dir> --require-pack --json
-node scripts/validate-pack.mjs --file <run-dir>/pack-<platform>.json --platform <platform> --json
-```
-
-## Export path
-
-Final PNGs at the **engine root**, not inside the run folder:
-
-```text
-Content Engine/exports/<run-slug>/01.png
-Content Engine/exports/<run-slug>/<platform>/01.png   # optional subfolder
-```

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

@@ -1,13 +0,0 @@
-# Troubleshooting
-
-No Content CLI, Local API, SQLite, or Obsidian requirement.
-
-If setup fails, stop before overwriting files. `python3` missing → install Python 3; starter files may already be written.
-
-If port 8765 is in use, reuse `http://127.0.0.1:8765/workbench/` — do not start a second server. Rebuild with `python3 workbench/build.py`.
-
-Never overwrite an existing `workbench/template.html`. `--apply` only adds missing files.
-
-If a run is incomplete, keep existing markdown and report the missing file. `validate-run.mjs` / `validate-pack.mjs` list concrete gaps. Do not auto-migrate an existing engine.
-
-Deferred features: `workflows/OUT_OF_SCOPE.md`.

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

@@ -1,40 +0,0 @@
-# Engine layout
-
-The skill creates one English root:
-
-```text
-<parent>/Content Engine/
-```
-
-`--root` is the **parent** directory, or the `Content Engine/` path itself.
-
-```json
-{
-  "schemaVersion": "content-engine.v1",
-  "locale": "en",
-  "root": "Content Engine",
-  "paths": { "runs": "runs", "exports": "exports", "workbench": "workbench" }
-}
-```
-
-Folders: `accounts`, `inbox`, `swipe`, `topics`, `discovery`, `raw`, `profiles`, `published`, `wiki`, `platforms`, `runs`, `exports`, `workbench`.
-
-Platform craft files: `x.md`, `ig.md` (`instagram` → `ig.md`), `tiktok.md`, `linkedin.md`, `threads.md`, `xiaohongshu.md`.
-
-## Workbench
-
-Copied from the skill package **only when missing**. Never overwrite an existing `workbench/template.html`.
-
-```text
-http://127.0.0.1:8765/workbench/
-```
-
-Rebuild with `python3 workbench/build.py` after markdown writes.
-
-## Export path
-
-```text
-Content Engine/exports/<run-slug>/01.png
-```
-
-Exports are **not** nested under `runs/<slug>/`. See `references/RUN_LAYOUT.md`.

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

@@ -1,16 +0,0 @@
-# Local voice vs hosted Profile
-
-| Concept | Where | When | Purpose |
-|---|---|---|---|
-| **Local voice** | `profiles/<id>/voice.md` | First draft (optional) | Identity + tone for the Agent |
-| **Local profile** | `profiles/<id>/` | Multi-brand | Pillars + audience + voice |
-| **Hosted Brand Profile** | Gateway (`easysociable profiles …`) | First render | Visual identity: Theme, logo, quotas |
-
-## Rules
-
-1. **Setup does not create a hosted Profile.**
-2. **Local voice is optional.** Ask once; user may skip.
-3. **Hosted Profile is required for render**, owned by Template/Slideshow skills.
-4. Never store API keys, passwords or Stripe tokens in `profiles/` or `accounts/`.
-
-When writing `draft.md` or pack slots, read the resolved voice file and audience **core + this platform**.

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

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-
-import { cpSync, existsSync, mkdirSync, rmSync } from 'node:fs'
-import { join, relative, resolve, sep } from 'node:path'
-
-const skillRoot = resolve(new URL('..', import.meta.url).pathname)
-const include = ['SKILL.md', 'INSTALL.md', 'scripts', 'references', 'workflows', 'platforms', 'fixtures', 'starter', 'workbench']
-
-function parseArgs(argv) {
-  let output = ''
-  let force = false
-  for (let i = 0; i < argv.length; i += 1) {
-    if (argv[i] === '--output') output = argv[++i] ?? ''
-    else if (argv[i] === '--force') force = true
-    else if (argv[i] === '--help' || argv[i] === '-h') return { help: true }
-    else throw new Error(`Unknown argument: ${argv[i]}`)
-  }
-  return { output, force }
-}
-
-try {
-  const options = parseArgs(process.argv.slice(2))
-  if (options.help) {
-    process.stdout.write('Usage: node package-skill.mjs --output <destination-dir> [--force]\n')
-    process.exit(0)
-  }
-  if (!options.output) throw new Error('--output is required')
-
-  const dest = resolve(options.output)
-  const sourceToDest = relative(skillRoot, dest)
-  const destToSource = relative(dest, skillRoot)
-  const touchesSource = dest === skillRoot
-    || (!sourceToDest.startsWith(`..${sep}`) && sourceToDest !== '..')
-    || (!destToSource.startsWith(`..${sep}`) && destToSource !== '..')
-  if (touchesSource) throw new Error('--output must be outside the skill source directory')
-  if (existsSync(dest) && !options.force) throw new Error('Output already exists; pass --force to replace it')
-  if (existsSync(dest)) rmSync(dest, { recursive: true, force: true })
-  mkdirSync(dest, { recursive: true })
-
-  for (const name of include) {
-    cpSync(join(skillRoot, name), join(dest, name), { recursive: true })
-  }
-
-  process.stdout.write(`Packaged skill → ${dest}\n`)
-}
-catch (error) {
-  console.error(error instanceof Error ? error.message : String(error))
-  process.exitCode = 1
-}

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

@@ -1,200 +0,0 @@
-#!/usr/bin/env node
-
-import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { basename, join, resolve } from 'node:path'
-import { ENGINE_ROOT, filesFor } from './starter.mjs'
-import { buildWorkbench, ensureWorkbench, python3Bin, startWorkbench } from './workbench.mjs'
-
-function parseArgs(argv) {
-  const options = {
-    root: '', engine: '', apply: false, validate: false, preview: false,
-    detect: false, noOpen: false, json: false, workbench: false,
-  }
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i]
-    if (arg === '--root') options.root = argv[++i] ?? ''
-    else if (arg === '--engine') options.engine = 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 === '--detect') options.detect = true
-    else if (arg === '--no-open') options.noOpen = true
-    else if (arg === '--workbench') options.workbench = 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 isEngine(path) {
-  return isDir(path) && existsSync(join(path, 'CLAUDE.md')) && isDir(join(path, 'runs'))
-}
-
-function resolveEngine(rootOrEngine) {
-  const absolute = resolve(rootOrEngine)
-  if (isEngine(absolute) || basename(absolute) === ENGINE_ROOT) return absolute
-  return join(absolute, ENGINE_ROOT)
-}
-
-function searchRoots() {
-  const extra = (process.env.EASYSOCIABLE_ENGINE_SEARCH_ROOTS || '')
-    .split(process.platform === 'win32' ? ';' : ':')
-    .map((item) => item.trim())
-    .filter(Boolean)
-  const home = homedir()
-  return [...extra, join(home, 'Documents'), home]
-}
-
-function detectEngines() {
-  const found = []
-  for (const root of searchRoots()) {
-    if (!isDir(root)) continue
-    const direct = join(root, ENGINE_ROOT)
-    if (isEngine(direct) || isDir(direct)) found.push(direct)
-    try {
-      for (const name of readdirSync(root)) {
-        const child = join(root, name, ENGINE_ROOT)
-        if (isDir(child)) found.push(child)
-      }
-    }
-    catch {
-      continue
-    }
-  }
-  return [...new Set(found)]
-}
-
-function inventory(engine) {
-  const files = filesFor()
-  const missing = []
-  const existing = []
-  for (const relative of Object.keys(files)) {
-    const path = join(engine, relative)
-    ;(existsSync(path) ? existing : missing).push(relative)
-  }
-  return {
-    engine,
-    engineExists: isDir(engine),
-    rootName: ENGINE_ROOT,
-    missing,
-    existing,
-    starterComplete: missing.length === 0,
-  }
-}
-
-function validateRoot(rootOrEngine, { strict = false } = {}) {
-  const engine = resolveEngine(rootOrEngine)
-  const parent = resolve(engine, '..')
-  const errors = []
-  if (!existsSync(parent) || !statSync(parent).isDirectory()) {
-    errors.push('Parent directory does not exist')
-    return { engine, valid: false, errors, created: [] }
-  }
-  const result = inventory(engine)
-  if (existsSync(engine) && !isDir(engine)) errors.push('Content Engine exists but is not a directory')
-  if (strict) {
-    if (!result.engineExists) errors.push('Content Engine/ folder does not exist')
-    else if (result.missing.length > 0) {
-      errors.push(`Starter incomplete: ${result.missing.length} file(s) missing (use --apply to add only missing files)`)
-    }
-  }
-  return { ...result, valid: errors.length === 0, errors, created: [] }
-}
-
-async function applyStarter(rootOrEngine, noOpen) {
-  const engine = resolveEngine(rootOrEngine)
-  const checked = validateRoot(engine)
-  if (checked.code) return { ...checked, created: [] }
-  mkdirSync(engine, { recursive: true })
-  const report = inventory(engine)
-  const created = []
-  const files = filesFor()
-  for (const relative of report.missing) {
-    const path = join(engine, relative)
-    mkdirSync(join(path, '..'), { recursive: true })
-    writeFileSync(path, files[relative], { encoding: 'utf8', flag: 'wx' })
-    created.push(relative)
-  }
-  const workbench = ensureWorkbench(engine)
-  const python = python3Bin()
-  if (!python) {
-    return {
-      ...validateRoot(engine),
-      created,
-      workbench,
-      action: 'applied',
-      valid: false,
-      code: 'PYTHON3_REQUIRED',
-      errors: ['python3 is required for the workbench. Install Python 3 and retry. Starter files were written; workbench was not started.'],
-    }
-  }
-  const built = buildWorkbench(engine)
-  let started = { skipped: true, build: built }
-  if (!noOpen && process.env.EASYSOCIABLE_NO_OPEN !== 'true') {
-    started = await startWorkbench(engine, { noOpen: false })
-  }
-  return { ...validateRoot(engine), created, workbench, workbenchBuild: built, workbenchStart: started, action: 'applied' }
-}
-
-function printHelp() {
-  process.stdout.write(`Usage:
-  node setup.mjs --detect [--json]
-  node setup.mjs --root <parent-or-engine> [--preview|--apply|--validate] [--workbench] [--no-open] [--json]
-
-English Content Engine/ only. Existing files are never overwritten.
-`)
-}
-
-try {
-  const options = parseArgs(process.argv.slice(2))
-  if (options.help) {
-    printHelp()
-    process.exit(0)
-  }
-  if (options.detect) {
-    output({ action: 'detect', engines: detectEngines() }, options.json)
-    process.exit(0)
-  }
-  const target = options.engine || options.root
-  if (!target) {
-    output({ code: 'ROOT_REQUIRED', message: 'Choose a parent directory or Content Engine path with --root.', created: false }, options.json)
-    process.exitCode = 2
-  }
-  else if (options.apply) {
-    const applied = await applyStarter(target, options.noOpen)
-    output(applied, options.json)
-    if (applied.code) process.exitCode = 2
-  }
-  else if (options.workbench) {
-    const engine = resolveEngine(target)
-    if (!isEngine(engine) && !isDir(engine)) {
-      output({ code: 'ENGINE_MISSING', message: 'Content Engine/ not found. Run --apply first.', created: false }, options.json)
-      process.exitCode = 2
-    }
-    else {
-      const started = await startWorkbench(engine, { noOpen: options.noOpen })
-      output({ action: 'workbench', ...started, engine }, options.json)
-      if (!started.ok) process.exitCode = 2
-    }
-  }
-  else {
-    const report = validateRoot(target, { strict: options.validate })
-    const action = options.validate ? 'validated' : 'preview'
-    output({ ...report, action, created: [] }, options.json)
-    if (report.code || (options.validate && !report.valid)) process.exitCode = 2
-  }
-}
-catch (error) {
-  output({ code: 'CONTENT_SETUP_FAILED', message: error instanceof Error ? error.message : String(error), created: false }, true)
-  process.exitCode = 1
-}