draftgo-cli 1.0.0

package/resources/skill/scripts/draftgo_sync.py

@@ -0,0 +1,150 @@
+#!/usr/bin/env python3
+"""
+DraftGo Sync Script
+推送本地页面 / 导航栏 / DB Meta 修改到云端。
+
+用法：
+  python draftgo_sync.py pages   [page_id ...]
+  python draftgo_sync.py nav     [nav_id ...]
+  python draftgo_sync.py db_meta [db_meta_id ...]
+"""
+import json, sys
+from pathlib import Path
+import urllib.request, urllib.error
+
+SCRIPT_DIR = Path(__file__).resolve().parent
+
+
+def find_project_root(start: Path) -> Path:
+    """向上查找包含 `.draftgo/` 的目录作为项目根。"""
+    cur = start
+    for _ in range(10):
+        if (cur / ".draftgo").is_dir():
+            return cur
+        if cur.parent == cur:
+            break
+        cur = cur.parent
+    return start.parents[3] if len(start.parents) >= 4 else start
+
+
+DEFAULT_ROOT = find_project_root(SCRIPT_DIR)
+
+
+def load_config():
+    cfg_path = DEFAULT_ROOT / ".draftgo/config.json"
+    if not cfg_path.exists():
+        print("ERR: .draftgo/config.json not found, run /draftgo init first", file=sys.stderr)
+        sys.exit(1)
+    cfg = json.loads(cfg_path.read_text(encoding="utf-8"))
+    return cfg["server"].rstrip("/"), cfg["token"]
+
+
+def api_call(method, server, token, path, body):
+    data = json.dumps(body, ensure_ascii=False).encode("utf-8")
+    req = urllib.request.Request(
+        f"{server}{path}",
+        data=data,
+        method=method,
+        headers={
+            "Authorization": f"Bearer {token}",
+            "Content-Type": "application/json",
+        },
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=15) as r:
+            return True, r.status
+    except urllib.error.HTTPError as e:
+        return False, f"HTTP {e.code}: {e.read().decode()}"
+    except Exception as e:
+        return False, str(e)
+
+
+def _load_index(rel_index):
+    """读取 .draftgo/ 下的 index.json；支持旧 (pages/index.json) 与新 (.draftgo/pages/index.json) 两种布局。"""
+    new_path = DEFAULT_ROOT / ".draftgo" / rel_index
+    legacy_path = DEFAULT_ROOT / rel_index
+    path = new_path if new_path.exists() else legacy_path
+    if not path.exists():
+        print(f"ERR: {rel_index} not found under .draftgo/, run /draftgo init first", file=sys.stderr)
+        sys.exit(1)
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def sync_pages(server, token, ids=None):
+    pages = _load_index("pages/index.json")
+    if ids:
+        pages = [p for p in pages if str(p.get("id")) in ids]
+    for page in pages:
+        pid = page.get("id")
+        title = page.get("title", pid)
+        html_file = DEFAULT_ROOT / page.get("html_file", "")
+        if not html_file.exists():
+            print(f"  SKIP [{title}] html_file not found: {page.get('html_file')}")
+            continue
+        html = html_file.read_text(encoding="utf-8")
+        payload = {
+            "title": page.get("title", ""),
+            "route": page.get("route", ""),
+            "tag": page.get("tag"),
+            "menu": page.get("menu"),
+            "status": page.get("status", "active"),
+            "permission": page.get("permission", {}),
+            "value": {"html": html},
+        }
+        ok, info = api_call("PUT", server, token, f"/api/pages/{pid}", payload)
+        print(f"  {'OK' if ok else 'ERR'} [{title}] page_id={pid}{'' if ok else ' -> ' + str(info)}")
+
+
+def sync_db_meta(server, token, ids=None):
+    metas = _load_index("db_meta/index.json")
+    if ids:
+        metas = [m for m in metas if str(m.get("id")) in ids]
+    for meta in metas:
+        mid = meta.get("id")
+        label = meta.get("label", meta.get("type", mid))
+        payload = {
+            "type": meta.get("type"),
+            "label": meta.get("label"),
+            "describe": meta.get("describe"),
+            "schema": meta.get("schema"),
+            "permission": meta.get("permission"),
+            "schema_validation": meta.get("schema_validation", 0),
+            "extra": meta.get("extra"),
+        }
+        ok, info = api_call("PUT", server, token, f"/api/db-meta/{mid}", payload)
+        print(f"  {'OK' if ok else 'ERR'} [{label}] db_meta_id={mid}{'' if ok else ' -> ' + str(info)}")
+
+
+def sync_nav(server, token, ids=None):
+    navs = _load_index("navigations/index.json")
+    if ids:
+        navs = [n for n in navs if str(n.get("id")) in ids]
+    for nav in navs:
+        nid = nav.get("id")
+        name = nav.get("name", nid)
+        html_file = DEFAULT_ROOT / nav.get("html_file", "")
+        if not html_file.exists():
+            print(f"  SKIP [{name}] html_file not found: {nav.get('html_file')}")
+            continue
+        html = html_file.read_text(encoding="utf-8")
+        ok, info = api_call("PUT", server, token, f"/api/navigations/{nid}", {"html": html})
+        print(f"  {'OK' if ok else 'ERR'} [{name}] nav_id={nid}{'' if ok else ' -> ' + str(info)}")
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] not in ("pages", "nav", "db_meta"):
+        print("usage: draftgo_sync.py pages|nav|db_meta [id ...]")
+        sys.exit(1)
+    mode = sys.argv[1]
+    ids = sys.argv[2:] or None
+    server, token = load_config()
+    if mode == "pages":
+        sync_pages(server, token, ids)
+    elif mode == "db_meta":
+        sync_db_meta(server, token, ids)
+    else:
+        sync_nav(server, token, ids)
+
+
+if __name__ == "__main__":
+    main()

package/resources/skill/sync/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: draftgo-sync
+description: Use this skill when the user says "同步页面", "同步导航", "同步数据库", "sync pages", "sync nav", "sync db_meta", "/draftgo sync", or wants to push local page/navigation/db_meta changes to the DraftGo server.
+version: 1.0.0
+allowed-tools: Bash(python:*), Read, Glob
+---
+
+# DraftGo 同步
+
+> **STOP — 禁止手动调用 API、禁止用 curl、禁止自己写 Python 上传逻辑。**
+> 唯一正确方式：运行下方 Python 脚本。脚本已处理所有字段结构、token 读取、错误处理。
+
+脚本固定位于 `.draftgo/skill/scripts/draftgo_sync.py`。
+
+## 同步页面（"同步页面" / "sync pages"）
+
+```
+!python .draftgo/skill/scripts/draftgo_sync.py pages
+!python .draftgo/skill/scripts/draftgo_sync.py pages <page_id>
+```
+
+## 同步数据库元数据（"同步数据库" / "sync db_meta"）
+
+```
+!python .draftgo/skill/scripts/draftgo_sync.py db_meta
+!python .draftgo/skill/scripts/draftgo_sync.py db_meta <db_meta_id>
+```
+
+## 同步导航栏（"同步导航" / "sync nav"）
+
+```
+!python .draftgo/skill/scripts/draftgo_sync.py nav
+!python .draftgo/skill/scripts/draftgo_sync.py nav <nav_id>
+```
+
+脚本会自动读取 `.draftgo/config.json` 和 `.draftgo/token`。
+
+## 同步方式
+
+**必须用 Python 脚本同步，禁止用 curl。**
+
+curl 在 Windows/Git Bash 环境下传输大 HTML 时会报 `Argument list too long`（exit 126）。
+统一使用 `draftgo_sync.py` 或临时 Python 脚本（`urllib.request`）进行同步。
+
+## 接口说明
+
+**页面同步**：`PUT /api/pages/{id}`
+
+payload 必须包含完整元数据（从 `pages/index.json` 读取）+ HTML：
+```json
+{
+  "title": "...",
+  "route": "...",
+  "tag": null,
+  "menu": "...",
+  "status": "active",
+  "permission": { "default": "login", "roles": [...] },
+  "value": { "html": "完整HTML字符串" }
+}
+```
+缺少任何字段会返回 422。`value` 是 `{"html": "..."}` 的 dict，不是字符串。
+
+**导航栏同步**：`PUT /api/navigations/{id}`，payload 为 `{"html": "..."}` 字符串。
+
+## 失败处理
+
+如果报错 `未找到 .draftgo/config.json`，提示用户先运行 `/draftgo init`。
+
+如果报错 HTTP 401，提示：
+```
+⚠️ Token 无效，请重新运行 /draftgo init 更新 token。
+```

package/src/cli.js

@@ -0,0 +1,43 @@
+'use strict';
+
+// Tiny, dependency-free argv parser tailored for draftgo-cli.
+// Supports: subcommand, positional args, --flag, --key=value.
+
+function parse(argv) {
+  const args = argv.slice();
+  const out = { command: null, positional: [], flags: {} };
+  while (args.length) {
+    const a = args.shift();
+    if (a === '--') { out.positional.push(...args); break; }
+    if (a.startsWith('--')) {
+      const raw = a.slice(2);
+      const eq = raw.indexOf('=');
+      if (eq >= 0) {
+        out.flags[raw.slice(0, eq)] = raw.slice(eq + 1);
+      } else {
+        const next = args[0];
+        if (next !== undefined && !next.startsWith('-')) {
+          // Only consume next token as value for a known set of flags.
+          if (['project', 'target'].includes(raw)) {
+            out.flags[raw] = next;
+            args.shift();
+          } else {
+            out.flags[raw] = true;
+          }
+        } else {
+          out.flags[raw] = true;
+        }
+      }
+    } else if (a.startsWith('-') && a.length > 1) {
+      const key = a.slice(1);
+      out.flags[key] = true;
+    } else if (!out.command) {
+      out.command = a;
+    } else {
+      out.positional.push(a);
+    }
+  }
+  return out;
+}
+
+module.exports = { parse };

package/src/commands/doctor.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const log = require('../logger');
+const { all } = require('../installers');
+const { detectTargets } = require('../detect');
+const { findPython } = require('../python');
+const { readInstalledVersion, getPackageVersion } = require('../skill');
+
+function doctor(projectDir) {
+  log.title('draftgo doctor');
+
+  log.info(`Node 版本：${process.version}`);
+  log.info(`平台：${process.platform}`);
+  log.info(`CLI 版本：${getPackageVersion()}`);
+  log.info(`项目目录：${projectDir}`);
+
+  console.log('');
+  const py = findPython();
+  if (py) log.ok(`Python：${py.bin} (${py.version})`);
+  else log.err('Python 未检测到（DraftGo init/sync 脚本需要 Python 3.9+）。');
+
+  console.log('');
+  log.info('项目中检测到的 AI 工具信号：');
+  const hits = detectTargets(projectDir);
+  if (hits.length === 0) log.dim('  （无）');
+  else hits.forEach((n) => log.dim(`  • ${n}`));
+
+  console.log('');
+  log.info(`已装 skill 版本：${readInstalledVersion(projectDir) || '未安装'}`);
+  log.info('各 AI 工具入口状态：');
+  for (const t of all) {
+    const st = t.status(projectDir);
+    const mark = st.installed ? log.c.green('✓') : log.c.gray('·');
+    console.log(`  ${mark} ${t.name.padEnd(12)} ${t.displayName}`);
+  }
+  return 0;
+}
+
+module.exports = doctor;

package/src/commands/help.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const { all } = require('../installers');
+const { getPackageVersion } = require('../skill');
+
+function help() {
+  const targets = all.map((i) => `    ${i.name.padEnd(12)} ${i.displayName}`).join('\n');
+  console.log(`draftgo v${getPackageVersion()} — manage the DraftGo skill across AI coding agents
+
+Usage:
+  draftgo init [<target>...]       Install skill. No target = auto-detect.
+                                    Use "all" to install every target.
+  draftgo update [<target>...]     Update skill body + entry files (preserves
+                                    config/iteration/bugs/local data).
+  draftgo uninstall [<target>...]  Remove entry files for target(s).
+                                    --purge also removes .draftgo/ (runtime data).
+  draftgo status                   Show installed targets and skill version.
+  draftgo doctor                   Diagnose environment (python, targets).
+  draftgo list-targets             List supported AI tools.
+  draftgo -v | --version           Print CLI version.
+  draftgo -h | --help              Show this help.
+
+Flags:
+  --project <dir>    Operate on <dir> instead of the current working directory.
+  --force            Overwrite existing skill body during install/update.
+  --purge            (uninstall) Also remove the entire .draftgo/ directory.
+  --yes              Assume "yes" for interactive prompts.
+
+Targets:
+${targets}
+
+Examples:
+  draftgo init                 # auto-detect AI tools in this project
+  draftgo init claudecode      # install for Claude Code only
+  draftgo init claudecode kiro # install for both
+  draftgo init all             # install for every supported target
+  draftgo update               # refresh skill content to latest
+  draftgo uninstall --purge    # full removal incl. runtime data
+`);
+}
+
+module.exports = help;

package/src/commands/init.js

@@ -0,0 +1,71 @@
+'use strict';
+
+const log = require('../logger');
+const { detectTargets } = require('../detect');
+const { resolveTargets, all } = require('../installers');
+const { installSkillBody } = require('../skill');
+const { findPython } = require('../python');
+
+function warnIfNoPython() {
+  const py = findPython();
+  if (!py) {
+    log.warn('Python 未检测到。DraftGo 的 init/sync 脚本需要 Python 3.9+。');
+    log.dim('  安装后请运行：python .draftgo/skill/scripts/draftgo_init.py --server ... --token ...');
+  } else {
+    log.dim(`  detected ${py.bin} (${py.version})`);
+  }
+}
+
+async function init(projectDir, positional, flags) {
+  log.title('draftgo init');
+
+  // 1) Figure out which targets to install.
+  let resolved = [];
+  let unknown = [];
+
+  if (positional.length === 0) {
+    // Auto-detect
+    const hits = detectTargets(projectDir);
+    if (hits.length === 0) {
+      log.warn('未在当前项目检测到任何支持的 AI 工具目录。');
+      log.dim('  使用 `draftgo init all` 或 `draftgo init <target>` 手动指定。');
+      log.dim(`  支持列表：${all.map((i) => i.name).join(', ')}`);
+      return 1;
+    }
+    ({ resolved, unknown } = resolveTargets(hits));
+    log.info(`自动识别到：${resolved.map((r) => r.displayName).join(', ')}`);
+  } else {
+    ({ resolved, unknown } = resolveTargets(positional));
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      log.dim(`  支持列表：${all.map((i) => i.name).join(', ')}`);
+      return 1;
+    }
+  }
+
+  // 2) Install the shared skill body once.
+  log.step('写入 .draftgo/skill/（共享技能本体）');
+  installSkillBody(projectDir, { force: !!flags.force });
+
+  // 3) Install entry files for each target.
+  log.step('写入各 AI 工具入口文件');
+  for (const t of resolved) {
+    try {
+      const r = t.install(projectDir);
+      log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
+    } catch (e) {
+      log.err(`${t.displayName} 安装失败：${e.message}`);
+    }
+  }
+
+  // 4) Environment check (advisory).
+  log.step('环境检查');
+  warnIfNoPython();
+
+  log.title('完成');
+  log.plain('下一步：在你的 AI 工具里说「初始化 draftgo 项目」，它会引导你配置服务器和 token。');
+  log.dim('或直接运行：python .draftgo/skill/scripts/draftgo_init.py --server <url> --token <token>');
+  return 0;
+}
+
+module.exports = init;

package/src/commands/listTargets.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const { all } = require('../installers');
+
+function listTargets() {
+  console.log('draftgo 支持的 AI 工具（target）:');
+  for (const t of all) {
+    console.log(`  ${t.name.padEnd(12)} ${t.displayName}`);
+  }
+  return 0;
+}
+
+module.exports = listTargets;

package/src/commands/status.js

@@ -0,0 +1,23 @@
+'use strict';
+
+const log = require('../logger');
+const { all } = require('../installers');
+const { readInstalledVersion, getPackageVersion } = require('../skill');
+
+function status(projectDir) {
+  log.title('draftgo status');
+  log.info(`项目目录：${projectDir}`);
+  log.info(`CLI 版本：${getPackageVersion()}`);
+  log.info(`已装 skill 版本：${readInstalledVersion(projectDir) || '（未安装）'}`);
+
+  console.log('');
+  console.log('AI 工具入口：');
+  for (const t of all) {
+    const st = t.status(projectDir);
+    const mark = st.installed ? log.c.green('✓') : log.c.gray('·');
+    console.log(`  ${mark} ${t.name.padEnd(12)} ${t.displayName}`);
+  }
+  return 0;
+}
+
+module.exports = status;

package/src/commands/uninstall.js

@@ -0,0 +1,52 @@
+'use strict';
+
+const log = require('../logger');
+const paths = require('../paths');
+const { all, resolveTargets } = require('../installers');
+const { uninstallSkillBody } = require('../skill');
+const { removePath, exists } = require('../fsx');
+
+async function uninstall(projectDir, positional, flags) {
+  log.title('draftgo uninstall');
+
+  let resolved = [];
+  let unknown = [];
+  if (positional.length === 0 || positional.includes('all')) {
+    resolved = all.slice();
+  } else {
+    ({ resolved, unknown } = resolveTargets(positional));
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      return 1;
+    }
+  }
+
+  log.step('移除入口文件');
+  for (const t of resolved) {
+    try {
+      const removed = t.uninstall(projectDir);
+      if (removed) log.ok(`${t.displayName} 入口已移除`);
+      else log.dim(`${t.displayName} 入口不存在，跳过`);
+    } catch (e) {
+      log.err(`${t.displayName} 卸载失败：${e.message}`);
+    }
+  }
+
+  // Only wipe the shared skill body if removing every target, or user asked.
+  const removedAll = resolved.length === all.length;
+  if (removedAll || flags.purge) {
+    log.step('移除 .draftgo/skill/');
+    uninstallSkillBody(projectDir, { purge: !!flags.purge });
+  } else {
+    log.dim('保留 .draftgo/skill/（仍有其他 AI 工具入口可能在用）。');
+  }
+
+  if (flags.purge) {
+    log.warn('已使用 --purge：.draftgo/（含 config/iteration/bugs 等运行时数据）已删除。');
+  }
+
+  log.title('完成');
+  return 0;
+}
+
+module.exports = uninstall;

package/src/commands/update.js

@@ -0,0 +1,54 @@
+'use strict';
+
+const log = require('../logger');
+const { all, resolveTargets } = require('../installers');
+const { updateSkillBody, readInstalledVersion, getPackageVersion } = require('../skill');
+
+async function update(projectDir, positional, flags) {
+  log.title('draftgo update');
+
+  const prev = readInstalledVersion(projectDir);
+  log.info(`当前已装：${prev || '未安装'}，CLI 版本：${getPackageVersion()}`);
+
+  // Determine which entry files to refresh:
+  //   - no positional → refresh only targets that are currently installed
+  //   - "all"          → refresh every known target
+  //   - names          → refresh the specified targets
+  let resolved = [];
+  let unknown = [];
+
+  if (positional.length === 0) {
+    resolved = all.filter((t) => t.status(projectDir).installed);
+    if (resolved.length === 0) {
+      log.warn('未检测到已安装的入口文件；仅刷新 .draftgo/skill/。');
+    } else {
+      log.info(`刷新已安装入口：${resolved.map((r) => r.displayName).join(', ')}`);
+    }
+  } else {
+    ({ resolved, unknown } = resolveTargets(positional));
+    if (unknown.length) {
+      log.err(`未知 target：${unknown.join(', ')}`);
+      return 1;
+    }
+  }
+
+  log.step('覆盖 .draftgo/skill/ 到 CLI 内置版本');
+  updateSkillBody(projectDir);
+
+  if (resolved.length) {
+    log.step('刷新入口文件');
+    for (const t of resolved) {
+      try {
+        const r = t.install(projectDir);
+        log.ok(`${t.displayName.padEnd(16)} → ${r.path}`);
+      } catch (e) {
+        log.err(`${t.displayName} 更新失败：${e.message}`);
+      }
+    }
+  }
+
+  log.title('完成');
+  return 0;
+}
+
+module.exports = update;

package/src/detect.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('./fsx');
+
+// Each target declares one or more signals (files/dirs). If ANY signal matches,
+// the target is considered "in use" in the current project.
+const SIGNALS = {
+  claudecode: ['.claude', 'CLAUDE.md'],
+  kiro:       ['.kiro'],
+  cursor:     ['.cursor'],
+  windsurf:   ['.windsurf'],
+  antigravity:['.agent'],
+  copilot:    ['.github/prompts', '.github/copilot-instructions.md'],
+  codex:      ['.codex', 'AGENTS.md'],
+  gemini:     ['.gemini', 'GEMINI.md'],
+};
+
+function detectTargets(projectDir) {
+  const hits = [];
+  for (const [name, signals] of Object.entries(SIGNALS)) {
+    if (signals.some((s) => exists(path.join(projectDir, s)))) {
+      hits.push(name);
+    }
+  }
+  return hits;
+}
+
+module.exports = { SIGNALS, detectTargets };

package/src/fsx.js

@@ -0,0 +1,62 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function readText(p) {
+  return fs.readFileSync(p, 'utf8');
+}
+
+function writeText(p, content) {
+  ensureDir(path.dirname(p));
+  fs.writeFileSync(p, content, 'utf8');
+}
+
+function copyFile(src, dest) {
+  ensureDir(path.dirname(dest));
+  fs.copyFileSync(src, dest);
+}
+
+function copyDir(src, dest) {
+  if (!exists(src)) return;
+  ensureDir(dest);
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyDir(s, d);
+    else if (entry.isFile()) copyFile(s, d);
+  }
+}
+
+function removePath(p) {
+  if (!exists(p)) return false;
+  fs.rmSync(p, { recursive: true, force: true });
+  return true;
+}
+
+function appendGitignoreLine(projectDir, line) {
+  const gi = path.join(projectDir, '.gitignore');
+  const content = exists(gi) ? readText(gi) : '';
+  if (content.split(/\r?\n/).some((l) => l.trim() === line)) return;
+  const sep = content && !content.endsWith('\n') ? '\n' : '';
+  fs.appendFileSync(gi, `${sep}${line}\n`);
+}
+
+module.exports = {
+  exists,
+  ensureDir,
+  readText,
+  writeText,
+  copyFile,
+  copyDir,
+  removePath,
+  appendGitignoreLine,
+};