code-abyss 1.7.3 → 1.7.4

package/README.md

@@ -25,7 +25,7 @@ npx code-abyss
 交互式菜单（方向键选择，回车确认）：
 
 ```
-☠️ Code Abyss v1.7.2
+☠️ Code Abyss v1.7.3
 
 ? 请选择操作 (Use arrow keys)
 ❯ 安装到 Claude Code (~/.claude/)
@@ -101,7 +101,7 @@ Code Abyss 是一套 **Claude Code / Codex CLI 个性化配置包**，一条命
 - 🔥 **邪修人格** — 宿命压迫叙事 + 道语标签 + 渡劫协议
 - ⚔️ **安全工程知识体系** — 红队/蓝队/紫队三脉道统，11 领域 56 篇专业秘典
 - ⚖️ **5 个校验关卡** — 安全扫描、模块完整性、变更分析、代码质量、文档生成
-- ✅ **66 单元测试** — Jest 框架，GitHub Actions CI (Node 18/20/22)
+- ✅ **单元测试覆盖** — Jest 框架，GitHub Actions CI (Node 18/20/22)
 - ⚡ **三级授权** — T1/T2/T3 分级，零确认直接执行
 
 ---
@@ -154,6 +154,8 @@ Code Abyss 是一套 **Claude Code / Codex CLI 个性化配置包**，一条命
 
 ## ⚙️ 推荐配置
 
+### Claude `settings.json` 推荐模板
+
 安装时选择「精细合并」会自动写入，也可手动参考 [`config/settings.example.json`](config/settings.example.json)：
 
 ```json
@@ -183,6 +185,53 @@ Code Abyss 是一套 **Claude Code / Codex CLI 个性化配置包**，一条命
 
 ---
 
+### Codex `config.toml` 推荐模板
+
+安装 `--target codex`（尤其 `-y`）时会写入以下模板到 `~/.codex/config.toml`：
+
+```toml
+model_provider = "custom"
+model = "gpt-5.2-codex"
+model_reasoning_effort = "high"
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+disable_response_storage = true
+
+[model_providers.custom]
+name = "custom"
+base_url = "https://your-api-endpoint.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+
+[tools]
+web_search = true
+
+[features]
+multi_agent = true
+```
+
+
+### 兼容性说明
+
+- 模板已对齐新版 Codex 配置风格：`[tools].web_search` 与 `[features].multi_agent`
+- 若你本地已有旧配置，安装器不会强制覆盖已有 `~/.codex/config.toml`
+- 建议在升级后执行一次 `codex --help` / 启动自检，确认无 deprecation warning
+
+---
+
+## 🧩 适配器解耦（Claude / Codex）
+
+为避免过度耦合，安装器按目标 CLI 拆分适配层：
+
+- `bin/install.js`：保留通用编排（参数解析、安装/卸载流程、备份恢复）
+- `bin/adapters/claude.js`：Claude 侧认证检测、settings merge、可选配置流程
+- `bin/lib/ccline.js`：Claude 侧状态栏与 ccline 集成
+- `bin/adapters/codex.js`：Codex 侧认证检测、核心文件映射、config 模板流程
+
+当前 Claude/Codex 安装映射分别由 `getClaudeCoreFiles()` 与 `getCodexCoreFiles()` 提供，避免在主流程硬编码目标细节。
+
+---
+
 ## 🎯 授权分级
 
 | 级别 | 范围 | 行为 |

package/bin/adapters/claude.js

@@ -0,0 +1,150 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const SETTINGS_TEMPLATE = {
+  $schema: 'https://json.schemastore.org/claude-code-settings.json',
+  env: {
+    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
+    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1'
+  },
+  alwaysThinkingEnabled: true,
+  model: 'opus',
+  outputStyle: 'abyss-cultivator',
+  attribution: { commit: '', pr: '' },
+  permissions: {
+    allow: [
+      'Bash', 'LS', 'Read', 'Agent', 'Write', 'Edit', 'MultiEdit',
+      'Glob', 'Grep', 'WebFetch', 'WebSearch', 'TodoWrite',
+      'NotebookRead', 'NotebookEdit'
+    ]
+  }
+};
+
+const CCLINE_CMD = process.platform === 'win32' ? 'ccline' : '~/.claude/ccline/ccline';
+const CCLINE_STATUS_LINE = {
+  statusLine: {
+    type: 'command',
+    command: CCLINE_CMD,
+    padding: 0
+  }
+};
+
+function getClaudeCoreFiles() {
+  return [
+    { src: 'config/CLAUDE.md', dest: 'CLAUDE.md' },
+    { src: 'output-styles', dest: 'output-styles' },
+    { src: 'skills', dest: 'skills' },
+  ];
+}
+
+function detectClaudeAuth({
+  settings = {},
+  HOME,
+  env = process.env,
+  warn = () => {}
+}) {
+  const settingsEnv = settings.env || {};
+  if (settingsEnv.ANTHROPIC_BASE_URL && settingsEnv.ANTHROPIC_AUTH_TOKEN) {
+    return { type: 'custom', detail: settingsEnv.ANTHROPIC_BASE_URL };
+  }
+  if (env.ANTHROPIC_API_KEY) return { type: 'env', detail: 'ANTHROPIC_API_KEY' };
+  if (env.ANTHROPIC_BASE_URL && env.ANTHROPIC_AUTH_TOKEN) {
+    return { type: 'env-custom', detail: env.ANTHROPIC_BASE_URL };
+  }
+
+  const cred = path.join(HOME, '.claude', '.credentials.json');
+  if (fs.existsSync(cred)) {
+    try {
+      const cc = JSON.parse(fs.readFileSync(cred, 'utf8'));
+      if (cc.claudeAiOauth || cc.apiKey) return { type: 'login', detail: 'claude login' };
+    } catch (e) {
+      warn(`凭证文件损坏: ${cred}`);
+    }
+  }
+
+  return null;
+}
+
+async function configureCustomProvider(ctx, { ok }) {
+  const { confirm, input } = await import('@inquirer/prompts');
+  const doCfg = await confirm({ message: '配置自定义 provider?', default: false });
+  if (!doCfg) return;
+
+  if (!ctx.settings.env) ctx.settings.env = {};
+  const url = await input({ message: 'ANTHROPIC_BASE_URL:' });
+  const token = await input({ message: 'ANTHROPIC_AUTH_TOKEN:' });
+  if (url) ctx.settings.env.ANTHROPIC_BASE_URL = url;
+  if (token) ctx.settings.env.ANTHROPIC_AUTH_TOKEN = token;
+
+  fs.writeFileSync(ctx.settingsPath, JSON.stringify(ctx.settings, null, 2) + '\n');
+  ok('provider 已配置');
+}
+
+function mergeSettings(ctx, { deepMergeNew, printMergeLog, c, ok }) {
+  const log = [];
+  deepMergeNew(ctx.settings, SETTINGS_TEMPLATE, '', log);
+  printMergeLog(log, c);
+  fs.writeFileSync(ctx.settingsPath, JSON.stringify(ctx.settings, null, 2) + '\n');
+  ok('settings.json 合并完成');
+}
+
+async function postClaude({
+  ctx,
+  autoYes,
+  HOME,
+  PKG_ROOT,
+  step,
+  ok,
+  warn,
+  info,
+  c,
+  deepMergeNew,
+  printMergeLog,
+  installCcline
+}) {
+  step(2, 3, '认证检测');
+  const auth = detectClaudeAuth({ settings: ctx.settings, HOME, warn });
+  if (auth) {
+    ok(`${c.b(auth.type)} → ${auth.detail}`);
+  } else {
+    warn('未检测到 API 认证');
+    info(`支持: ${c.cyn('claude login')} | ${c.cyn('ANTHROPIC_API_KEY')} | ${c.cyn('自定义 provider')}`);
+    if (!autoYes) await configureCustomProvider(ctx, { ok });
+  }
+
+  step(3, 3, '可选配置');
+  if (autoYes) {
+    info('自动模式: 合并推荐配置');
+    mergeSettings(ctx, { deepMergeNew, printMergeLog, c, ok });
+    await installCcline(ctx, { HOME, PKG_ROOT, CCLINE_STATUS_LINE, ok, warn, info, c });
+    return;
+  }
+
+  const { checkbox } = await import('@inquirer/prompts');
+  const choices = await checkbox({
+    message: '选择要安装的配置 (空格选择, 回车确认)',
+    choices: [
+      { name: '精细合并推荐 settings.json (保留现有配置)', value: 'settings', checked: true },
+      { name: '安装 ccline 状态栏 (需要 Nerd Font)', value: 'ccline', checked: true },
+    ],
+  });
+
+  if (choices.includes('settings')) {
+    mergeSettings(ctx, { deepMergeNew, printMergeLog, c, ok });
+  }
+  if (choices.includes('ccline')) {
+    await installCcline(ctx, { HOME, PKG_ROOT, CCLINE_STATUS_LINE, ok, warn, info, c });
+  }
+}
+
+module.exports = {
+  SETTINGS_TEMPLATE,
+  CCLINE_STATUS_LINE,
+  getClaudeCoreFiles,
+  detectClaudeAuth,
+  configureCustomProvider,
+  mergeSettings,
+  postClaude,
+};

package/bin/adapters/codex.js

@@ -0,0 +1,97 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function detectCodexAuth({
+  HOME,
+  env = process.env,
+  warn = () => {}
+}) {
+  if (env.OPENAI_API_KEY) return { type: 'env', detail: 'OPENAI_API_KEY' };
+
+  const auth = path.join(HOME, '.codex', 'auth.json');
+  if (fs.existsSync(auth)) {
+    try {
+      const a = JSON.parse(fs.readFileSync(auth, 'utf8'));
+      if (a.token || a.api_key) return { type: 'login', detail: 'codex login' };
+    } catch (e) {
+      warn(`凭证文件损坏: ${auth}`);
+    }
+  }
+
+  const cfg = path.join(HOME, '.codex', 'config.toml');
+  if (fs.existsSync(cfg) && fs.readFileSync(cfg, 'utf8').includes('base_url')) {
+    return { type: 'custom', detail: 'config.toml' };
+  }
+
+  return null;
+}
+
+function getCodexCoreFiles() {
+  return [
+    { src: 'config/AGENTS.md', dest: 'AGENTS.md' },
+    { src: 'skills', dest: 'skills' },
+  ];
+}
+
+async function postCodex({
+  autoYes,
+  HOME,
+  PKG_ROOT,
+  step,
+  ok,
+  warn,
+  info,
+  c
+}) {
+  const { confirm } = await import('@inquirer/prompts');
+  const cfgPath = path.join(HOME, '.codex', 'config.toml');
+  const exists = fs.existsSync(cfgPath);
+
+  step(2, 3, '认证检测');
+  const auth = detectCodexAuth({ HOME, warn });
+  if (auth) {
+    ok(`${c.b(auth.type)} → ${auth.detail}`);
+  } else {
+    warn('未检测到 API 认证');
+    info(`支持: ${c.cyn('codex login')} | ${c.cyn('OPENAI_API_KEY')} | ${c.cyn('自定义 provider')}`);
+  }
+
+  step(3, 3, '可选配置');
+  if (autoYes) {
+    if (!exists) {
+      const src = path.join(PKG_ROOT, 'config', 'codex-config.example.toml');
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, cfgPath);
+        ok('写入: ~/.codex/config.toml (模板)');
+        warn('请编辑 base_url 和 model');
+      }
+    } else {
+      ok('config.toml 已存在');
+    }
+    return;
+  }
+
+  if (!exists) {
+    warn('未检测到 ~/.codex/config.toml');
+    const doWrite = await confirm({ message: '写入推荐 config.toml (含自定义 provider 模板)?', default: true });
+    if (doWrite) {
+      const src = path.join(PKG_ROOT, 'config', 'codex-config.example.toml');
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, cfgPath);
+        ok('写入: ~/.codex/config.toml');
+        warn('请编辑 base_url 和 model');
+      }
+    }
+  } else {
+    ok('config.toml 已存在');
+  }
+}
+
+module.exports = {
+  detectCodexAuth,
+  getCodexCoreFiles,
+  postCodex,
+};
+

package/bin/install.js

@@ -18,6 +18,17 @@ const PKG_ROOT = fs.realpathSync(path.join(__dirname, '..'));
 const { shouldSkip, copyRecursive, rmSafe, deepMergeNew, printMergeLog, parseFrontmatter } =
   require(path.join(__dirname, 'lib', 'utils.js'));
 const { detectCclineBin, installCcline: _installCcline } = require(path.join(__dirname, 'lib', 'ccline.js'));
+const {
+  detectCodexAuth: detectCodexAuthImpl,
+  getCodexCoreFiles,
+  postCodex: postCodexFlow,
+} = require(path.join(__dirname, 'adapters', 'codex.js'));
+const {
+  SETTINGS_TEMPLATE,
+  getClaudeCoreFiles,
+  detectClaudeAuth: detectClaudeAuthImpl,
+  postClaude: postClaudeFlow,
+} = require(path.join(__dirname, 'adapters', 'claude.js'));
 
 // ── ANSI ──
 
@@ -66,68 +77,15 @@ function fail(msg) { console.log(`  ${c.red('✘')} ${msg}`); }
 // ── 认证 ──
 
 function detectClaudeAuth(settings) {
-  const env = settings.env || {};
-  if (env.ANTHROPIC_BASE_URL && env.ANTHROPIC_AUTH_TOKEN) return { type: 'custom', detail: env.ANTHROPIC_BASE_URL };
-  if (process.env.ANTHROPIC_API_KEY) return { type: 'env', detail: 'ANTHROPIC_API_KEY' };
-  if (process.env.ANTHROPIC_BASE_URL && process.env.ANTHROPIC_AUTH_TOKEN) {
-    return { type: 'env-custom', detail: process.env.ANTHROPIC_BASE_URL };
-  }
-  const cred = path.join(HOME, '.claude', '.credentials.json');
-  if (fs.existsSync(cred)) {
-    try {
-      const cc = JSON.parse(fs.readFileSync(cred, 'utf8'));
-      if (cc.claudeAiOauth || cc.apiKey) return { type: 'login', detail: 'claude login' };
-    } catch (e) { warn(`凭证文件损坏: ${cred}`); }
-  }
-  return null;
+  return detectClaudeAuthImpl({ settings, HOME, warn });
 }
 
 function detectCodexAuth() {
-  if (process.env.OPENAI_API_KEY) return { type: 'env', detail: 'OPENAI_API_KEY' };
-  const auth = path.join(HOME, '.codex', 'auth.json');
-  if (fs.existsSync(auth)) {
-    try {
-      const a = JSON.parse(fs.readFileSync(auth, 'utf8'));
-      if (a.token || a.api_key) return { type: 'login', detail: 'codex login' };
-    } catch (e) { warn(`凭证文件损坏: ${auth}`); }
-  }
-  const cfg = path.join(HOME, '.codex', 'config.toml');
-  if (fs.existsSync(cfg)) {
-    if (fs.readFileSync(cfg, 'utf8').includes('base_url')) return { type: 'custom', detail: 'config.toml' };
-  }
-  return null;
+  return detectCodexAuthImpl({ HOME, warn });
 }
 
 // ── 模板 ──
 
-const SETTINGS_TEMPLATE = {
-  $schema: 'https://json.schemastore.org/claude-code-settings.json',
-  env: {
-    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
-    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1'
-  },
-  alwaysThinkingEnabled: true,
-  model: 'opus',
-  outputStyle: 'abyss-cultivator',
-  attribution: { commit: '', pr: '' },
-  permissions: {
-    allow: [
-      'Bash', 'LS', 'Read', 'Agent', 'Write', 'Edit', 'MultiEdit',
-      'Glob', 'Grep', 'WebFetch', 'WebSearch', 'TodoWrite',
-      'NotebookRead', 'NotebookEdit'
-    ]
-  }
-};
-
-const CCLINE_CMD = process.platform === 'win32' ? 'ccline' : '~/.claude/ccline/ccline';
-const CCLINE_STATUS_LINE = {
-  statusLine: {
-    type: 'command',
-    command: CCLINE_CMD,
-    padding: 0
-  }
-};
-
 // ── CLI 参数 ──
 
 const args = process.argv.slice(2);
@@ -322,12 +280,9 @@ function installCore(tgt) {
   step(1, 3, `安装核心文件 → ${c.cyn(targetDir)}`);
   fs.mkdirSync(backupDir, { recursive: true });
 
-  const filesToInstall = [
-    { src: 'config/CLAUDE.md', dest: tgt === 'claude' ? 'CLAUDE.md' : null },
-    { src: 'config/AGENTS.md', dest: tgt === 'codex' ? 'AGENTS.md' : null },
-    { src: 'output-styles', dest: tgt === 'claude' ? 'output-styles' : null },
-    { src: 'skills', dest: 'skills' },
-  ].filter(f => f.dest !== null);
+  const filesToInstall = tgt === 'codex'
+    ? getCodexCoreFiles()
+    : getClaudeCoreFiles();
 
   const manifest = {
     manifest_version: 1, version: VERSION, target: tgt,
@@ -389,108 +344,36 @@ function installCore(tgt) {
 
 // ── Claude 后续 ──
 
-async function configureCustomProvider(ctx) {
-  const { confirm, input } = await import('@inquirer/prompts');
-  const doCfg = await confirm({ message: '配置自定义 provider?', default: false });
-  if (!doCfg) return;
-  if (!ctx.settings.env) ctx.settings.env = {};
-  const url = await input({ message: 'ANTHROPIC_BASE_URL:' });
-  const token = await input({ message: 'ANTHROPIC_AUTH_TOKEN:' });
-  if (url) ctx.settings.env.ANTHROPIC_BASE_URL = url;
-  if (token) ctx.settings.env.ANTHROPIC_AUTH_TOKEN = token;
-  fs.writeFileSync(ctx.settingsPath, JSON.stringify(ctx.settings, null, 2) + '\n');
-  ok('provider 已配置');
-}
-
-function mergeSettings(ctx) {
-  const log = [];
-  deepMergeNew(ctx.settings, SETTINGS_TEMPLATE, '', log);
-  printMergeLog(log, c);
-  fs.writeFileSync(ctx.settingsPath, JSON.stringify(ctx.settings, null, 2) + '\n');
-  ok('settings.json 合并完成');
-}
-
 async function postClaude(ctx) {
-  step(2, 3, '认证检测');
-  const auth = detectClaudeAuth(ctx.settings);
-  if (auth) {
-    ok(`${c.b(auth.type)} → ${auth.detail}`);
-  } else {
-    warn('未检测到 API 认证');
-    info(`支持: ${c.cyn('claude login')} | ${c.cyn('ANTHROPIC_API_KEY')} | ${c.cyn('自定义 provider')}`);
-    if (!autoYes) await configureCustomProvider(ctx);
-  }
-
-  step(3, 3, '可选配置');
-  if (autoYes) {
-    info('自动模式: 合并推荐配置');
-    mergeSettings(ctx);
-    await installCcline(ctx);
-    return;
-  }
-
-  const { checkbox } = await import('@inquirer/prompts');
-  const choices = await checkbox({
-    message: '选择要安装的配置 (空格选择, 回车确认)',
-    choices: [
-      { name: '精细合并推荐 settings.json (保留现有配置)', value: 'settings', checked: true },
-      { name: '安装 ccline 状态栏 (需要 Nerd Font)', value: 'ccline', checked: true },
-    ],
+  await postClaudeFlow({
+    ctx,
+    autoYes,
+    HOME,
+    PKG_ROOT,
+    step,
+    ok,
+    warn,
+    info,
+    c,
+    deepMergeNew,
+    printMergeLog,
+    installCcline: _installCcline,
   });
-
-  if (choices.includes('settings')) mergeSettings(ctx);
-  if (choices.includes('ccline')) await installCcline(ctx);
-}
-
-async function installCcline(ctx) {
-  await _installCcline(ctx, { HOME, PKG_ROOT, CCLINE_STATUS_LINE, ok, warn, info, fail, c });
 }
 
 // ── Codex 后续 ──
 
 async function postCodex() {
-  const { confirm } = await import('@inquirer/prompts');
-  const cfgPath = path.join(HOME, '.codex', 'config.toml');
-  const exists = fs.existsSync(cfgPath);
-
-  step(2, 3, '认证检测');
-  const auth = detectCodexAuth();
-  if (auth) {
-    ok(`${c.b(auth.type)} → ${auth.detail}`);
-  } else {
-    warn('未检测到 API 认证');
-    info(`支持: ${c.cyn('codex login')} | ${c.cyn('OPENAI_API_KEY')} | ${c.cyn('自定义 provider')}`);
-  }
-
-  step(3, 3, '可选配置');
-  if (autoYes) {
-    if (!exists) {
-      const src = path.join(PKG_ROOT, 'config', 'codex-config.example.toml');
-      if (fs.existsSync(src)) {
-        fs.copyFileSync(src, cfgPath);
-        ok('写入: ~/.codex/config.toml (模板)');
-        warn('请编辑 base_url 和 model');
-      }
-    } else {
-      ok('config.toml 已存在');
-    }
-    return;
-  }
-
-  if (!exists) {
-    warn('未检测到 ~/.codex/config.toml');
-    const doWrite = await confirm({ message: '写入推荐 config.toml (含自定义 provider 模板)?', default: true });
-    if (doWrite) {
-      const src = path.join(PKG_ROOT, 'config', 'codex-config.example.toml');
-      if (fs.existsSync(src)) {
-        fs.copyFileSync(src, cfgPath);
-        ok('写入: ~/.codex/config.toml');
-        warn('请编辑 base_url 和 model');
-      }
-    }
-  } else {
-    ok('config.toml 已存在');
-  }
+  await postCodexFlow({
+    autoYes,
+    HOME,
+    PKG_ROOT,
+    step,
+    ok,
+    warn,
+    info,
+    c,
+  });
 }
 
 // ── 主流程 ──

package/config/codex-config.example.toml

@@ -1,24 +1,18 @@
-# Code Abyss - Codex CLI 推荐配置
-# 请根据实际情况修改 model_provider 和 base_url
-
-model_provider = "custom"
-model = "gpt-5.2"
-model_reasoning_effort = "high"
-model_reasoning_summary = "auto"
-model_personality = "pragmatic"
-disable_response_storage = true
-approval_policy = "never"
-sandbox_mode = "danger-full-access"
-
-[model_providers.custom]
-name = "custom"
-base_url = "https://your-api-endpoint.com/v1"
-wire_api = "responses"
-requires_openai_auth = true
-
-web_search = "live"
-
-[features]
-unified_exec = true
-shell_snapshot = true
-steer = true
+model_provider = "custom"
+model = "gpt-5.2-codex"
+model_reasoning_effort = "high"
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+disable_response_storage = true
+
+[model_providers.custom]
+name = "custom"
+base_url = "https://your-api-endpoint.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+
+[tools]
+web_search = true
+
+[features]
+multi_agent = true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-abyss",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "邪修红尘仙·宿命深渊 - 一键为 Claude Code / Codex CLI 注入邪修人格与安全工程知识体系",
   "keywords": [
     "claude",

package/skills/tools/gen-docs/scripts/doc_generator.js

@@ -403,7 +403,7 @@ function main() {
   const result = generateDocs(args.path, args.force);
 
   if (args.json) {
-    console.log(JSON.stringify(result, null, 2));
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
   } else {
     console.log('='.repeat(50));
     console.log('文档生成报告');
@@ -414,7 +414,22 @@ function main() {
     console.log('='.repeat(50));
   }
 
-  process.exit(result.status === 'success' ? 0 : 1);
+  process.exitCode = result.status === 'success' ? 0 : 1;
 }
 
-main();
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  parseGitignore,
+  shouldIgnore,
+  rglob,
+  detectLanguage,
+  analyzeModule,
+  generateReadme,
+  generateDesign,
+  generateDocs,
+  parseArgs,
+  main,
+};