draftgo-cli 1.0.0

package/src/index.js

@@ -0,0 +1,53 @@
+'use strict';
+
+const path = require('path');
+const { parse } = require('./cli');
+const log = require('./logger');
+
+async function run(argv) {
+  const { command, positional, flags } = parse(argv);
+
+  // --version / --help shortcuts
+  if (flags.version || flags.v || command === 'version') {
+    console.log(require('./skill').getPackageVersion());
+    return 0;
+  }
+  if (!command || flags.help || flags.h || command === 'help') {
+    require('./commands/help')();
+    return 0;
+  }
+
+  const projectDir = flags.project
+    ? path.resolve(String(flags.project))
+    : process.cwd();
+
+  try {
+    switch (command) {
+      case 'init':
+        return await require('./commands/init')(projectDir, positional, flags);
+      case 'update':
+      case 'upgrade':
+        return await require('./commands/update')(projectDir, positional, flags);
+      case 'uninstall':
+      case 'remove':
+        return await require('./commands/uninstall')(projectDir, positional, flags);
+      case 'status':
+        return require('./commands/status')(projectDir);
+      case 'doctor':
+        return require('./commands/doctor')(projectDir);
+      case 'list-targets':
+      case 'targets':
+        return require('./commands/listTargets')();
+      default:
+        log.err(`未知命令：${command}`);
+        require('./commands/help')();
+        return 1;
+    }
+  } catch (e) {
+    log.err(e.message || String(e));
+    if (process.env.DEBUG) console.error(e.stack);
+    return 1;
+  }
+}
+
+module.exports = { run };

package/src/installers/_entryContent.js

@@ -0,0 +1,45 @@
+'use strict';
+
+// Shared body content for AI-tool entry files.
+// Each entry file is a thin shell that tells the agent: "read the shared
+// skill body at .draftgo/skill/ and follow it". The skill body is the single
+// source of truth and lives outside any AI-tool-specific folder.
+
+function entryMarkdown({ command = '/draftgo' } = {}) {
+  return `---
+name: draftgo
+description: DraftGo 开发助手（由 draftgo-cli 安装）。用户谈及 DraftGo 开发、页面、导航、同步等场景时激活。
+---
+
+# DraftGo
+
+此文件由 \`draftgo-cli\` 管理，是 DraftGo skill 的入口。实际内容在本项目的共享目录：
+
+- 主提示：\`.draftgo/skill/SKILL.md\`
+- 初始化子技能：\`.draftgo/skill/init/SKILL.md\`
+- 同步子技能：\`.draftgo/skill/sync/SKILL.md\`
+- Bug 记录子技能：\`.draftgo/skill/bug/SKILL.md\`
+- 前端开发规范：\`.draftgo/skill/rules/frontend.md\`
+- 页面排错指南：\`.draftgo/skill/rules/debugging-syntax.md\`
+- 运行时脚本：\`.draftgo/skill/scripts/draftgo_init.py\`、\`.draftgo/skill/scripts/draftgo_sync.py\`
+
+## 使用
+
+- 初始化项目：\`${command} init\`
+- 同步到服务器：\`${command} sync pages|nav|db_meta [id]\`
+- 记录 bug：由 \`bug\` 子技能自动处理
+
+## 运行脚本的正确方式
+
+\`\`\`bash
+python .draftgo/skill/scripts/draftgo_init.py --server <server> --token <token>
+python .draftgo/skill/scripts/draftgo_sync.py pages [page_id]
+python .draftgo/skill/scripts/draftgo_sync.py nav   [nav_id]
+python .draftgo/skill/scripts/draftgo_sync.py db_meta [db_meta_id]
+\`\`\`
+
+> 禁止绕过脚本手动调用 API。详细规范以 \`.draftgo/skill/\` 下文档为准。
+`;
+}
+
+module.exports = { entryMarkdown };

package/src/installers/antigravity.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'antigravity';
+const DISPLAY = 'Antigravity';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.agent', 'workflows', 'draftgo.md');
+}
+
+function install(projectDir) {
+  writeManagedFile(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: '.agent/workflows/draftgo.md' };
+}
+
+function uninstall(projectDir) {
+  return removeIfExists(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/base.js

@@ -0,0 +1,54 @@
+'use strict';
+
+// Base helpers for all AI-tool installers.
+// Each installer exports: { name, displayName, install, uninstall, status }
+
+const path = require('path');
+const { exists, writeText, removePath } = require('../fsx');
+
+// Managed-region markers for appending to shared markdown files
+// (used by codex/gemini/copilot targets).
+const BEGIN = '<!-- DRAFTGO:START -->';
+const END   = '<!-- DRAFTGO:END -->';
+
+function writeManagedFile(filePath, body) {
+  writeText(filePath, body);
+}
+
+function writeManagedBlock(filePath, body) {
+  const block = `${BEGIN}\n${body}\n${END}\n`;
+  let current = '';
+  try { current = require('fs').readFileSync(filePath, 'utf8'); } catch { current = ''; }
+  if (!current) {
+    writeText(filePath, block);
+    return;
+  }
+  const re = new RegExp(`${BEGIN}[\\s\\S]*?${END}\\n?`);
+  const next = re.test(current)
+    ? current.replace(re, block)
+    : (current.endsWith('\n') ? current : current + '\n') + '\n' + block;
+  writeText(filePath, next);
+}
+
+function removeManagedBlock(filePath) {
+  if (!exists(filePath)) return false;
+  const current = require('fs').readFileSync(filePath, 'utf8');
+  const re = new RegExp(`\\n*${BEGIN}[\\s\\S]*?${END}\\n?`);
+  if (!re.test(current)) return false;
+  const next = current.replace(re, '').replace(/\n{3,}/g, '\n\n');
+  writeText(filePath, next.trimEnd() + '\n');
+  return true;
+}
+
+function removeIfExists(p) {
+  return removePath(p);
+}
+
+module.exports = {
+  BEGIN,
+  END,
+  writeManagedFile,
+  writeManagedBlock,
+  removeManagedBlock,
+  removeIfExists,
+};

package/src/installers/claudecode.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'claudecode';
+const DISPLAY = 'Claude Code';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.claude', 'skills', 'draftgo', 'SKILL.md');
+}
+
+function install(projectDir) {
+  writeManagedFile(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: '.claude/skills/draftgo/SKILL.md' };
+}
+
+function uninstall(projectDir) {
+  const root = path.join(projectDir, '.claude', 'skills', 'draftgo');
+  return removeIfExists(root);
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/codex.js

@@ -0,0 +1,31 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedBlock, removeManagedBlock } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'codex';
+const DISPLAY = 'Codex CLI';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, 'AGENTS.md');
+}
+
+function install(projectDir) {
+  writeManagedBlock(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: 'AGENTS.md (managed block)' };
+}
+
+function uninstall(projectDir) {
+  return removeManagedBlock(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  const f = entryFile(projectDir);
+  if (!exists(f)) return { installed: false };
+  const content = require('fs').readFileSync(f, 'utf8');
+  return { installed: /DRAFTGO:START[\s\S]*DRAFTGO:END/.test(content) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/copilot.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'copilot';
+const DISPLAY = 'GitHub Copilot';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.github', 'prompts', 'draftgo.prompt.md');
+}
+
+function install(projectDir) {
+  writeManagedFile(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: '.github/prompts/draftgo.prompt.md' };
+}
+
+function uninstall(projectDir) {
+  return removeIfExists(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/cursor.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'cursor';
+const DISPLAY = 'Cursor';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.cursor', 'commands', 'draftgo.md');
+}
+
+function install(projectDir) {
+  writeManagedFile(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: '.cursor/commands/draftgo.md' };
+}
+
+function uninstall(projectDir) {
+  return removeIfExists(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/gemini.js

@@ -0,0 +1,31 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedBlock, removeManagedBlock } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'gemini';
+const DISPLAY = 'Gemini CLI';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, 'GEMINI.md');
+}
+
+function install(projectDir) {
+  writeManagedBlock(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: 'GEMINI.md (managed block)' };
+}
+
+function uninstall(projectDir) {
+  return removeManagedBlock(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  const f = entryFile(projectDir);
+  if (!exists(f)) return { installed: false };
+  const content = require('fs').readFileSync(f, 'utf8');
+  return { installed: /DRAFTGO:START[\s\S]*DRAFTGO:END/.test(content) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/index.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const claudecode  = require('./claudecode');
+const cursor      = require('./cursor');
+const windsurf    = require('./windsurf');
+const antigravity = require('./antigravity');
+const copilot     = require('./copilot');
+const kiro        = require('./kiro');
+const codex       = require('./codex');
+const gemini      = require('./gemini');
+
+const all = [claudecode, cursor, windsurf, antigravity, copilot, kiro, codex, gemini];
+const byName = Object.fromEntries(all.map((i) => [i.name, i]));
+
+function resolveTargets(input) {
+  // input: string | string[] | undefined
+  //   undefined  -> { resolved: [], unknown: [] } (caller triggers auto-detect)
+  //   'all'      -> all installers
+  //   name(s)    -> matching installers + any unknown names
+  if (!input) return { resolved: [], unknown: [] };
+  if (input === 'all') return { resolved: all.slice(), unknown: [] };
+  const list = Array.isArray(input) ? input : [input];
+  if (list.includes('all')) return { resolved: all.slice(), unknown: [] };
+  const resolved = [];
+  const unknown = [];
+  for (const name of list) {
+    if (byName[name]) resolved.push(byName[name]);
+    else unknown.push(name);
+  }
+  return { resolved, unknown };
+}
+
+module.exports = { all, byName, resolveTargets };

package/src/installers/kiro.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'kiro';
+const DISPLAY = 'Kiro';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.kiro', 'steering', 'draftgo.md');
+}
+
+function install(projectDir) {
+  const body = `---
+inclusion: manual
+---
+
+` + entryMarkdown({ command: '/draftgo' });
+  writeManagedFile(entryFile(projectDir), body);
+  return { path: '.kiro/steering/draftgo.md' };
+}
+
+function uninstall(projectDir) {
+  return removeIfExists(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/installers/windsurf.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('path');
+const { exists } = require('../fsx');
+const { writeManagedFile, removeIfExists } = require('./base');
+const { entryMarkdown } = require('./_entryContent');
+
+const NAME = 'windsurf';
+const DISPLAY = 'Windsurf';
+
+function entryFile(projectDir) {
+  return path.join(projectDir, '.windsurf', 'workflows', 'draftgo.md');
+}
+
+function install(projectDir) {
+  writeManagedFile(entryFile(projectDir), entryMarkdown({ command: '/draftgo' }));
+  return { path: '.windsurf/workflows/draftgo.md' };
+}
+
+function uninstall(projectDir) {
+  return removeIfExists(entryFile(projectDir));
+}
+
+function status(projectDir) {
+  return { installed: exists(entryFile(projectDir)) };
+}
+
+module.exports = { name: NAME, displayName: DISPLAY, install, uninstall, status };

package/src/logger.js

@@ -0,0 +1,30 @@
+'use strict';
+
+// Minimal ANSI color helpers — no external deps.
+const isTTY = process.stdout && process.stdout.isTTY;
+const supportsColor = isTTY && !process.env.NO_COLOR;
+
+const wrap = (code) => (s) => supportsColor ? `\x1b[${code}m${s}\x1b[0m` : String(s);
+
+const c = {
+  bold: wrap(1),
+  dim: wrap(2),
+  red: wrap(31),
+  green: wrap(32),
+  yellow: wrap(33),
+  blue: wrap(34),
+  magenta: wrap(35),
+  cyan: wrap(36),
+  gray: wrap(90),
+};
+
+function info(msg) { console.log(`${c.cyan('ℹ')} ${msg}`); }
+function ok(msg) { console.log(`${c.green('✓')} ${msg}`); }
+function warn(msg) { console.warn(`${c.yellow('!')} ${msg}`); }
+function err(msg) { console.error(`${c.red('✗')} ${msg}`); }
+function step(msg) { console.log(`${c.blue('→')} ${msg}`); }
+function title(msg) { console.log(`\n${c.bold(c.magenta(msg))}`); }
+function plain(msg) { console.log(msg); }
+function dim(msg) { console.log(c.dim(msg)); }
+
+module.exports = { c, info, ok, warn, err, step, title, plain, dim };

package/src/paths.js

@@ -0,0 +1,35 @@
+'use strict';
+
+const path = require('path');
+
+// Resource dir inside the package (bundled with npm publish)
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const RESOURCES_DIR = path.join(PACKAGE_ROOT, 'resources');
+
+// In-project paths
+const DG_DIR_NAME = '.draftgo';                  // <project>/.draftgo
+const SKILL_SUBDIR = 'skill';                    // <project>/.draftgo/skill
+const VERSION_FILE = '.version';
+
+function dgDir(projectDir) {
+  return path.join(projectDir, DG_DIR_NAME);
+}
+
+function skillDir(projectDir) {
+  return path.join(dgDir(projectDir), SKILL_SUBDIR);
+}
+
+function versionFile(projectDir) {
+  return path.join(skillDir(projectDir), VERSION_FILE);
+}
+
+module.exports = {
+  PACKAGE_ROOT,
+  RESOURCES_DIR,
+  DG_DIR_NAME,
+  SKILL_SUBDIR,
+  VERSION_FILE,
+  dgDir,
+  skillDir,
+  versionFile,
+};

package/src/python.js

@@ -0,0 +1,27 @@
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+function tryBin(bin) {
+  try {
+    const r = spawnSync(bin, ['--version'], { encoding: 'utf8' });
+    if (r.status === 0 || (r.stdout || '').toLowerCase().includes('python')) {
+      return { bin, version: (r.stdout || r.stderr || '').trim() };
+    }
+  } catch { /* ignore */ }
+  return null;
+}
+
+// Return a usable python command ('python' or 'python3') if found, else null.
+function findPython() {
+  const candidates = process.platform === 'win32'
+    ? ['python', 'python3', 'py']
+    : ['python3', 'python'];
+  for (const b of candidates) {
+    const r = tryBin(b);
+    if (r) return r;
+  }
+  return null;
+}
+
+module.exports = { findPython };

package/src/skill.js

@@ -0,0 +1,83 @@
+'use strict';
+
+// Install/update/uninstall the shared skill body at <project>/.draftgo/skill/.
+// This is the single source that all AI-tool entry files reference.
+
+const path = require('path');
+const { RESOURCES_DIR } = require('./paths');
+const {
+  exists, ensureDir, readText, writeText, copyDir, removePath, appendGitignoreLine,
+} = require('./fsx');
+const paths = require('./paths');
+const log = require('./logger');
+
+// Files/dirs under resources/skill/ that form the skill body.
+const SKILL_SOURCE_DIR = path.join(RESOURCES_DIR, 'skill');
+
+function getPackageVersion() {
+  try {
+    return require(path.join(paths.PACKAGE_ROOT, 'package.json')).version;
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function readInstalledVersion(projectDir) {
+  const f = paths.versionFile(projectDir);
+  return exists(f) ? readText(f).trim() : null;
+}
+
+function writeInstalledVersion(projectDir) {
+  writeText(paths.versionFile(projectDir), getPackageVersion() + '\n');
+}
+
+function installSkillBody(projectDir, { force = false } = {}) {
+  if (!exists(SKILL_SOURCE_DIR)) {
+    throw new Error(
+      `Skill source missing: ${SKILL_SOURCE_DIR}. The CLI package may be broken.`
+    );
+  }
+  const dest = paths.skillDir(projectDir);
+  const alreadyInstalled = exists(dest);
+  if (alreadyInstalled && !force) {
+    log.dim(`  skill body already at .draftgo/skill (use --force to overwrite)`);
+  } else {
+    // Clean install of the skill body (preserves sibling .draftgo/* runtime data).
+    if (alreadyInstalled) removePath(dest);
+    ensureDir(dest);
+    copyDir(SKILL_SOURCE_DIR, dest);
+    writeInstalledVersion(projectDir);
+    log.ok(`.draftgo/skill/ installed (v${getPackageVersion()})`);
+  }
+
+  // Ignore runtime/local files, not the skill body.
+  appendGitignoreLine(projectDir, '.draftgo/config.json');
+  appendGitignoreLine(projectDir, '.draftgo/token');
+
+  return dest;
+}
+
+function updateSkillBody(projectDir) {
+  return installSkillBody(projectDir, { force: true });
+}
+
+function uninstallSkillBody(projectDir, { purge = false } = {}) {
+  const skill = paths.skillDir(projectDir);
+  const removed = removePath(skill);
+  if (removed) log.ok(`removed .draftgo/skill/`);
+  if (purge) {
+    const dg = paths.dgDir(projectDir);
+    if (removePath(dg)) log.ok(`purged .draftgo/`);
+  }
+  return removed;
+}
+
+module.exports = {
+  SKILL_SOURCE_DIR,
+  getPackageVersion,
+  readInstalledVersion,
+  writeInstalledVersion,
+  installSkillBody,
+  updateSkillBody,
+  uninstallSkillBody,
+};