@easysociable/cli 0.1.1 → 0.1.2

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

@@ -1,38 +1,26 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readdirSync, 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))
-}
+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 = { vault: '', locale: '', apply: false, validate: false, preview: false, noOpen: false, json: false }
+  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 === '--vault') options.vault = argv[++i] ?? ''
-    else if (arg === '--locale') options.locale = 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}`)
@@ -48,76 +36,123 @@ function isDir(path) {
   return existsSync(path) && statSync(path).isDirectory()
 }
 
-function enginePaths(vault) {
-  return { en: join(vault, ROOT.en), zh: join(vault, ROOT.zh) }
+function isEngine(path) {
+  return isDir(path) && existsSync(join(path, 'CLAUDE.md')) && isDir(join(path, 'runs'))
 }
 
-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 resolveEngine(rootOrEngine) {
+  const absolute = resolve(rootOrEngine)
+  if (isEngine(absolute) || basename(absolute) === ENGINE_ROOT) return absolute
+  return join(absolute, ENGINE_ROOT)
 }
 
-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 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 inventory(root, locale) {
-  const files = filesFor(locale)
-  const engine = join(root, ROOT[locale])
+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, locale, rootName: ROOT[locale], missing, existing }
+  return {
+    engine,
+    engineExists: isDir(engine),
+    rootName: ENGINE_ROOT,
+    missing,
+    existing,
+    starterComplete: missing.length === 0,
+  }
 }
 
-function validateVault(vault, requestedLocale) {
-  const absolute = resolve(vault)
+function validateRoot(rootOrEngine, { strict = false } = {}) {
+  const engine = resolveEngine(rootOrEngine)
+  const parent = resolve(engine, '..')
   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 }
+  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: [] }
 }
 
-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 })
+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(report.engine, relative)
+    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') {
-    const vaultName = report.vault.split('/').pop() ?? 'Vault'
-    spawnSync('open', [`obsidian://open?vault=${encodeURIComponent(vaultName)}`], { stdio: 'ignore' })
+    started = await startWorkbench(engine, { noOpen: false })
   }
-  return { ...validateVault(vault, report.locale), created: [...report.missing] }
+  return { ...validateRoot(engine), created, workbench, workbenchBuild: built, workbenchStart: started, action: 'applied' }
 }
 
 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`)
+  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 {
@@ -126,29 +161,38 @@ try {
     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
+  if (options.detect) {
+    output({ action: 'detect', engines: detectEngines() }, options.json)
+    process.exit(0)
   }
-  else if (!options.vault) {
-    output({ code: 'VAULT_REQUIRED', message: 'Choose an existing Obsidian Vault with --vault.', created: false }, options.json)
+  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 {
-    const report = validateVault(options.vault, options.locale)
-    if (!report.valid) {
-      output({ ...report, created: [] }, options.json)
+  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 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)
+      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)

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

@@ -6,63 +6,74 @@ 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' }
+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 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 missingRoot = run(['--preview'])
+  assert.equal(missingRoot.status, 2)
+  assert.equal(JSON.parse(missingRoot.stdout).code, 'ROOT_REQUIRED')
 
-  const preview = run(['--vault', vault, '--locale', 'en', '--preview'])
+  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.locale, 'en')
+  assert.equal(previewReport.rootName, 'Content Engine')
 
-  const apply = run(['--vault', vault, '--locale', 'en', '--apply', '--no-open'])
-  assert.equal(apply.status, 0)
+  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 > 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')
+  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 second = run(['--vault', vault, '--apply', '--no-open'])
+  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 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 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 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)
+  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.')
 }

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

@@ -1,53 +1,55 @@
-export const ROOT = { en: 'Content Engine', zh: '内容引擎' }
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
+import { join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
-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 const ENGINE_ROOT = 'Content Engine'
+export const STARTER_DIR = fileURLToPath(new URL('../starter/', import.meta.url))
+export const WORKBENCH_SRC = fileURLToPath(new URL('../workbench/', import.meta.url))
+export const WORKBENCH_FILES = ['template.html', 'build.py', 'serve.py']
+
+export const ENGINE_PATHS = {
+  runs: 'runs',
+  exports: 'exports',
+  topics: 'topics',
+  discovery: 'discovery',
+  swipe: 'swipe',
+  profiles: 'profiles',
+  inbox: 'inbox',
+  accounts: 'accounts',
+  raw: 'raw',
+  published: 'published',
+  wiki: 'wiki',
+  platforms: 'platforms',
+  workbench: 'workbench',
+}
+
+export function engineJson() {
+  return `${JSON.stringify({
+    schemaVersion: 'content-engine.v1',
+    locale: 'en',
+    root: ENGINE_ROOT,
+    paths: ENGINE_PATHS,
+  }, null, 2)}\n`
+}
+
+function walkFiles(dir) {
+  const out = []
+  if (!existsSync(dir)) return out
+  for (const name of readdirSync(dir)) {
+    if (name === '.DS_Store') continue
+    const path = join(dir, name)
+    if (statSync(path).isDirectory()) out.push(...walkFiles(path))
+    else out.push(path)
+  }
+  return out
 }
 
-export function filesFor(locale) {
-  return {
-    ...STARTER[locale],
-    'locale.json': `${JSON.stringify({ locale }, null, 2)}\n`,
+export function filesFor() {
+  const files = {}
+  for (const path of walkFiles(STARTER_DIR)) {
+    const relativePath = relative(STARTER_DIR, path).split('\\').join('/')
+    files[relativePath] = readFileSync(path, 'utf8')
   }
+  files['engine.json'] = engineJson()
+  return files
 }

package/skills/easysociable-content/scripts/validate-export.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+import { resolve } from 'node:path'
+import { validateExportDirectory } from './export-contracts.mjs'
+
+function parseArgs(argv) {
+  const options = { exportDir: '', expectedPages: undefined, json: false }
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--export') options.exportDir = argv[++i] ?? ''
+    else if (arg === '--expected-pages') options.expectedPages = Number(argv[++i])
+    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`)
+}
+
+try {
+  const options = parseArgs(process.argv.slice(2))
+  if (options.help) {
+    output({ usage: 'node validate-export.mjs --export <export-dir> [--expected-pages N] [--json]' }, false)
+    process.exit(0)
+  }
+  if (!options.exportDir) {
+    output({ code: 'EXPORT_REQUIRED', message: 'Pass --export <export-dir>.', valid: false }, options.json)
+    process.exitCode = 2
+  }
+  else {
+    const report = validateExportDirectory(resolve(options.exportDir), { expectedPages: options.expectedPages })
+    output({ ...report, action: 'validated', export: resolve(options.exportDir) }, options.json)
+    if (!report.valid) process.exitCode = 2
+  }
+}
+catch (error) {
+  output({ code: 'EXPORT_VALIDATE_FAILED', message: error instanceof Error ? error.message : String(error), valid: false }, true)
+  process.exitCode = 1
+}

package/skills/easysociable-content/scripts/validate-pack.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { validateContentPack } from './contracts.mjs'
+
+function parseArgs(argv) {
+  const options = { file: '', platform: '', requirePageTemplateId: false, json: false }
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--file') options.file = argv[++i] ?? ''
+    else if (arg === '--platform') options.platform = argv[++i] ?? ''
+    else if (arg === '--require-page-template-id') options.requirePageTemplateId = 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`)
+}
+
+try {
+  const options = parseArgs(process.argv.slice(2))
+  if (options.help) {
+    output({ usage: 'node validate-pack.mjs --file <pack.json> [--platform tiktok] [--require-page-template-id] [--json]' }, false)
+    process.exit(0)
+  }
+  if (!options.file) {
+    output({ code: 'FILE_REQUIRED', message: 'Pass --file <pack.json>.', valid: false }, options.json)
+    process.exitCode = 2
+  }
+  else {
+    const pack = JSON.parse(readFileSync(resolve(options.file), 'utf8'))
+    const report = validateContentPack(pack, {
+      requirePageTemplateId: options.requirePageTemplateId,
+      platform: options.platform || undefined,
+    })
+    output({ ...report, action: 'validated', file: resolve(options.file) }, options.json)
+    if (!report.valid) process.exitCode = 2
+  }
+}
+catch (error) {
+  output({ code: 'PACK_VALIDATE_FAILED', message: error instanceof Error ? error.message : String(error), valid: false }, true)
+  process.exitCode = 1
+}