kup-cli 0.0.0-alpha.4 → 0.1.0-beta.3

package/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 cssmagic and other contributors
+Copyright (c) 2022 cssmagic
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,9 +1,145 @@
 # Kup
 
-> A CLI tool to post Markdown files to GitHub as issues.
+<img src="https://user-images.githubusercontent.com/1231359/171321963-e8e73bdf-f9c8-435b-9707-318e92f1805a.png" width="150" height="80" align="right" alt="Kup logo">
 
-## Installation
+> A CLI tool to sync local Markdown files to GitHub issues.
+>
+> 这款命令行工具可以把本地的 Markdown 文件同步到 GitHub issue。
+
+## 谁需要它
+
+* 利用 GitHub issue 写博客的作者们，可以方便地在本地编辑原稿，并随时发布新博文或更新已有博文。
+* 通过 GitHub issue 发布文档的开源软件作者们，可以把代码仓库中的文档更新到指定 issue。
+* 其它需要频繁更新 GitHub issue 的人。
+
+
+## 安装
+
+需要全局安装，以便随时在命令行调用：
 
 ```sh
 npm i -g kup-cli
 ```
+
+（当 Kup 发布新版时，可以再次运行这行命令升级已安装的版本。）
+
+
+## 使用方法
+
+### 发布新 issue
+
+```sh
+kup ./path/to/file.md --repo foo/bar
+```
+
+Kup 会把 `file.md` 文件的内容发布为 `foo/bar` 仓库的一个新 issue，发布成功后会告知新 issue 的编号。
+
+### 更新已有 issue
+
+```sh
+kup ./path/to/file.md --repo foo/bar --id 123
+```
+
+Kup 会把 `file.md` 文件的内容更新到 `foo/bar` 仓库的编号为 `123` 的 issue。
+
+### 准备工作
+
+操作 GitHub issue 是需要权限认证的，因此你需要向 Kup 提供 GitHub token，以便 Kup 调用 GitHub API。
+
+1. 在 GitHub 的 “[Personal access tokens](https://github.com/settings/tokens)” 页面生成一个新 token，权限范围需要选中 “repo”。（详细说明参见 [这篇文档](https://github.com/cssmagic/kup/issues/17)。）
+
+2. 把获取到的 token 写入环境变量：
+
+	```sh
+	export GITHUB_TOKEN=ghp_**********
+	```
+
+如果 Kup 未能从环境变量获取 token，会在命令行向你询问。
+
+
+## 命令行参数
+
+参数 | 短名 | 值类型 | 含义 | 备注
+---|---|---|---|---
+`--repo` | `-r` | 字符串 | 指定 GitHub 仓库
+`--id` | `-i` | 整数 | 指定 issue 的编号 | <li>指定编号表示更新已有 issue<li>未指定编号则表示发布新 issue
+`--version` | `-v` | - | 显示版本号
+`--help` | `-h` | - | 显示帮助信息
+
+
+## 进阶
+
+### 如何更方便地指定 `repo` 参数？
+
+有以下方式可以指定 `repo` 参数，优先级递减：
+
+1. 调用命令行时指定的 `--repo` 参数。
+1. Markdown 文件内的 [元数据](https://github.com/cssmagic/kup/issues/1) 的 `repo` 字段。
+1. 当前项目的 `package.json` 文件内的 `kup.repo` 字段。Kup 会从当前目录向上逐级寻找 `package.json` 文件。
+
+如果整个项目的同步目标都是同一个仓库，则可以采用最后一种方式统一指定 `repo` 参数。
+
+### 如何更方便地指定 `id` 参数？
+
+有以下方式可以指定 `id` 参数，优先级递减：
+
+1. 调用命令行时指定的 `--id` 参数。
+1. Markdown 文件内的元数据的 `id` 字段。
+
+当一个文件发布成功后，建议立即把 id 写入它的元数据。
+
+### Issue 的标题是怎么确定的？
+
+Kup 通过以下线索来确定 issue 的标题，优先级递减：
+
+1. Markdown 文件内的元数据的 `title` 字段。
+1. Markdown 正文的第一个标记如果是一级标题（`# Title` 格式），则取它的内容（在这种情况下，这个一级标题在同步时会从内容中排除）。
+
+如果通过以上方式无法确定 issue 标题，Kup 会怎么处理？
+
+* 如果是在发布新 issue，则 Kup 会自己生成一个标题。
+* 如果是在更新已有 issue，则 Kup 会忽略标题（也就是说，不会修改已有标题）。
+
+### 如何为 issue 指定 label？
+
+不论是在写博客，还是在发表 issue，你常常都会有打标签的需求。于是 Kup 也实现了这个功能。
+
+你需要在 Markdown 文件的元数据中添加 `tags` 字段，指定一个或多个 label。这些 label 不需要事先在 GitHub 仓库里创建好——如果你指定了不存在的 label，会在发布 issue 时自动创建。
+
+如果元数据中没有 `tags` 字段，Kup 会怎么处理？
+
+* 如果是在发布新 issue，则 Kup 不会为 issue 设置任何 label。
+* 如果是在更新已有 issue 时，Kup 会忽略标签（也就是说，不会修改已有标签）。
+
+在更新已有 issue 时，如果元数据指定的标签与 issue 现有标签不一致，则前者会完全替代后者。
+
+## 文档
+
+* [Markdown 文件内的元数据示例](https://github.com/cssmagic/kup/issues/1)
+* [如何为 Kup 生成合适的 GitHub token](https://github.com/cssmagic/kup/issues/17)
+
+
+## 其它
+
+### 开发计划
+
+请参考 [本项目的 issue](https://github.com/cssmagic/kup/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)。欢迎提出你的需求，或参与 RFC 讨论。
+
+### 关于名字
+
+* Kup 取自 “皮卡” 的英文词 pickup，喻意是 “轻便地运载”。
+* Kup 是变形金刚人物 “杯子” 的英文名。
+
+### 关于 Logo
+
+* 作者 [Fasil](https://freeicons.io/profile/722)，由 [freeicons.io](https://freeicons.io/icon/e-commerce-icons/pickup-truck-icon-26893) 免费提供。
+
+***
+
+## License
+
+> Any code contributed to this project is considered authorized for commercial use by the project authors and their affiliated companies and distributed under this project's license.
+>
+> 任何贡献到本项目的代码，均视为授权本项目作者及其名下公司用于商业用途、并按本项目协议分发。
+
+MIT

package/bin/cli.js

@@ -1,4 +1,50 @@
 #!/usr/bin/env node
-'use strict'
+import yargs from 'yargs'
+import { hideBin } from 'yargs/helpers'
+import { isDebugging } from '../lib/util.js'
+import { main } from '../lib/main.js'
+import { validate } from '../lib/validate.js'
 
-console.log('OK')
+if (isDebugging()) {
+	console.log('[Kup] [Debug] Debug Mode is ON!')
+	console.log('')
+}
+
+const argv = yargs(hideBin(process.argv))
+	.scriptName('kup')
+	.usage('Kup -- A CLI tool to sync local Markdown files to GitHub issues.')
+	.usage('Usage: $0 <file> [options]')
+	.example('kup foo.md --repo aaa/bbb --id 123', '// sync foo.md to GitHub issue aaa/bbb#123')
+	.option('repo', {
+		alias: 'r',
+		type: 'string',
+		description: 'Specify GitHub repository',
+	})
+	.option('id', {
+		alias: 'i',
+		type: 'number',
+		description: 'Specify GitHub issue ID',
+	})
+	.option('parse-only', {
+		alias: 'p',
+		type: 'boolean',
+		description: 'Only parse file, without posting or syncing',
+		hidden: true,
+	})
+	.alias('v', 'version')
+	.alias('h', 'help')
+	.parse()
+
+// debug
+if (isDebugging()) {
+	console.log('[Kup] [Debug] argv =', argv)
+}
+
+// validate args
+if (!validate(argv)) process.exit(1)
+
+// do the job
+main(argv)
+	.then(() => {
+		console.log('[Kup] Done!')
+	})

package/index.js

@@ -1,5 +1,3 @@
-'use strict'
-
-module.exports = function () {
+export default function () {
 	console.warn('Warning: This package is a CLI tool, you should install it globally! See README.md for more information.')
 }

package/lib/file.js

@@ -0,0 +1,21 @@
+import fsPromises from 'fs/promises'
+
+function readTextFile(pathname) {
+	return fsPromises.readFile(pathname)
+		.then((bin) => {
+			// 去除 utf-8 文本文件的 BOM
+			if (bin[0] === 0xEF && bin[1] === 0xBB && bin[2] === 0xBF) {
+				bin = bin.slice(3)
+			}
+			return bin.toString('utf-8')
+		})
+}
+
+function writeTextFile(pathname, content) {
+	fsPromises.writeFile(pathname, content)
+}
+
+export {
+	readTextFile,
+	writeTextFile,
+}

package/lib/main.js

@@ -0,0 +1,57 @@
+import { isDebugging } from './util.js'
+import { readTextFile } from './file.js'
+import { parse } from './parse.js'
+import { getRepo } from './repo.js'
+import { updateIssue, postIssue } from './sync.js'
+import { getToken } from './token.js'
+
+async function main(argv) {
+	const {
+		id = 0,
+		repo = '',
+		_: files,
+	} = argv
+
+	// 目前只处理第一个文件
+	const file = files[0]
+	let content = ''
+	try {
+		content = await readTextFile(file)
+	} catch (e) {
+		console.error(`[Kup] [Error] Cannot read file "${ file }"!`)
+		console.error(e.message)
+		process.exit(1)
+	}
+
+	const fileInfo = parse(content)
+
+	if (argv.parseOnly || isDebugging()) {
+		console.log('[Kup] [Debug] fileInfo =', fileInfo)
+		// 如果有 p 参数，则提前退出，不需要走后面的步骤
+		if (argv.parseOnly) return
+	}
+
+	// 通过各种方式获取 repo
+	// 优先级： 命令行参数 > 文件元数据 > 文件所在项目的 package.json 中的 `kup.repo` 字段
+	let repoReal = repo || fileInfo.meta.repo
+	if (!repoReal) repoReal = await getRepo(file)
+	if (!repoReal) {
+		console.error('[Kup] [Error] Cannot get `repo` to sync to!')
+		process.exit(1)
+	}
+
+	// 检查 TOKEN
+	if (await getToken()) {
+		// 调用 GitHub API
+		const idReal = id || fileInfo.meta.id
+		if (idReal) {
+			await updateIssue(fileInfo, repoReal, idReal)
+		} else {
+			await postIssue(fileInfo, repoReal)
+		}
+	}
+}
+
+export {
+	main,
+}

package/lib/parse.js

@@ -1,7 +1,120 @@
-'use strict'
+import YAML from 'yaml'
+
+import { isPlainObject } from './util.js'
 
 // parse markdown file:
 // - extract metadata in yaml format
 // - extract main title from h1
 
-// todo
+const SEPARATOR = '---'
+const SEPARATOR_END_ALT = '...'
+const LF = '\n'
+
+function parse(text) {
+	// trim leading LF
+	const lines = text.trimStart().split(LF)
+
+	// console.log(_detectMetaSectionLineQty(lines))
+	const metaLineQty = _detectMetaSectionLineQty(lines)
+	let meta = {}
+	if (metaLineQty > 2) {
+		meta = _parseMetaSection(lines, metaLineQty)
+	}
+
+	// 注意：这个函数会修改原数组
+	_stripMetaSection(lines, metaLineQty)
+
+	// 从正文中获取一级标题作为备用 title
+	let title = _getTitleFromMainBody(lines[0])
+	// 如果采用正文的一级标题作为最终 title，则从正文中去除一级标题，以免复重
+	if (!meta.title && title) lines[0] = ''
+
+	// console.log(lines)
+	return {
+		meta,
+		title,
+		content: lines.join(LF).trimStart(),
+	}
+}
+
+function _detectMetaSectionLineQty(lines) {
+	const hasSeparatorStart = lines[0].trimEnd() === SEPARATOR
+	const noEmptyLineAfterSeparatorStart = !!lines[1].trimEnd()
+	const hasYamlKey = /^#?\s*[\w\-]+:/.test(lines[1].trim())
+
+	let metaLineQty = 0
+	if (hasSeparatorStart && noEmptyLineAfterSeparatorStart && hasYamlKey) {
+		// 从第二行 (i = 1) 开始扫描
+		for (let i = 1; i < lines.length; i++) {
+			let line = lines[i].trimEnd()
+			// 遇到结束分隔符，则可以得出行数并退出
+			if (line === SEPARATOR || line === SEPARATOR_END_ALT) {
+				metaLineQty = i + 1
+				break
+			}
+			// 在遇到结束分隔符之前遇到空行，则视为元数据不存在
+			if (!line) break
+		}
+	}
+	return metaLineQty
+}
+
+function _parseMetaSection(lines, metaLineQty) {
+	// 把分隔符之间的 YAML 代码取出来
+	const metaLines = lines.slice(1, metaLineQty - 1)
+	const yaml = metaLines.join(LF)
+	let result = {}
+	try {
+		result = YAML.parse(yaml)
+	} catch (e) {
+		console.error(`[Kup] [Error] Cannot parse YAML meta section:`)
+		console.error(SEPARATOR)
+		console.error(yaml)
+		console.error(SEPARATOR)
+		console.error(e.message)
+		process.exit(1)
+	}
+	// console.log(result)
+	if (!isPlainObject(result)) {
+		console.error(`[Kup] [Error] YAML data must be an Object!`)
+		process.exit(1)
+	}
+
+	// format
+	const tags = result.tags
+	if (!tags) {
+		delete result.tags
+	} else if (!Array.isArray(tags)) {
+		result.tags = [String(tags)]
+	}
+
+	return result
+}
+
+// 注意：这个函数会修改原数组
+function _stripMetaSection(lines, metaLineQty) {
+	lines.splice(0, metaLineQty)
+
+	// trim leading empty lines
+	let emptyLineQty = 0
+	for (let i = 0; i < lines.length; i++) {
+		let line = lines[i].trimEnd()
+		if (line) {
+			break
+		} else {
+			emptyLineQty++
+		}
+	}
+	if (emptyLineQty) lines.splice(0, emptyLineQty)
+}
+
+function _getTitleFromMainBody(firstLine) {
+	const re = /^#([^#].*)/
+	const result = re.exec(firstLine.trim())
+	const title = result ? result[1].trim() : ''
+	return title
+}
+
+export {
+	parse,
+}

package/lib/repo.js

@@ -0,0 +1,52 @@
+import findUp from 'find-up'
+import path from 'path'
+
+import { readTextFile } from './file.js'
+import { validateRepo } from './validate.js'
+
+async function getRepo(sourceFile = '') {
+	// 目前只实现这一种方式
+	return await _getRepoFromPkgKup(sourceFile)
+}
+
+async function _getRepoFromPkgKup(sourceFile = '') {
+	const json = await _getPkg(sourceFile)
+	const repo = json?.kup?.repo
+	const result = validateRepo(repo)
+	return result.status ? repo : ''
+}
+async function _getRepoFromPkgRepo() {
+	// TODO
+}
+async function _getRepoFromGit() {
+	// TODO
+}
+
+async function _getPkg(sourceFile = '') {
+	const cwd = sourceFile ? path.resolve(path.dirname(sourceFile)) : process.cwd()
+	const file = await findUp('package.json', { cwd })
+
+	let pkg = ''
+	try {
+		pkg = await readTextFile(file)
+	} catch (e) {
+		console.error(`[Kup] [Error] Cannot read file "${ file }"!`)
+		console.error(e.message)
+	}
+
+	let json = null
+	try {
+		json = JSON.parse(pkg)
+	} catch (e) {
+		console.error('[Kup] [Error] Cannot parse `package.json` to JSON!')
+		console.error(e.message)
+	}
+	return json
+}
+
+export {
+	getRepo,
+	// __getRepoFromPkgKup: _getRepoFromPkgKup,
+	// __getRepoFromPkgRepo: _getRepoFromPkgRepo,
+	// __getRepoFromGit: _getRepoFromGit,
+}

package/lib/sync.js

@@ -0,0 +1,115 @@
+import ghGot from 'gh-got'
+import inquirer from 'inquirer'
+
+import { isDebugging } from '../lib/util.js'
+
+let proxyOptionsForGot = {}
+if (isDebugging()) {
+	const { HttpsProxyAgent } = await import('https-proxy-agent')
+	const CHARLES_PROXY = 'http://127.0.0.1:8888'
+	const agent = new HttpsProxyAgent(CHARLES_PROXY)
+	proxyOptionsForGot = {
+		agent: {
+			https: agent,
+		},
+		// 由于 Charles 证书无法通过校验，需要通过这个选项来放行
+		rejectUnauthorized: false,
+	}
+}
+
+async function updateIssue(fileInfo, repo, id) {
+	// prepare fields
+	// 因为接口是 PATCH 方法，只需要提供需要更新的字段
+	// Markdown 文件未提供的字段就不提交了，而不是提交空值，以免清空已有值
+	const title = fileInfo.meta.title || fileInfo.title
+	const body = fileInfo.content
+	const data = { body }
+	if (title) data.title = title
+	if (fileInfo.meta.tags) data.labels = fileInfo.meta.tags
+	if (isDebugging()) {
+		console.log('[Kup] [Debug] requestBody =', data)
+	}
+
+	// post
+	const api = `/repos/${ repo }/issues/${ id }`
+	const method = 'PATCH'
+	let response = null
+	console.log(`[Kup] Updating "${ repo }#${ id }"...`)
+	try {
+		response = await ghGot(api, {
+			method,
+			body: data,
+			token: process.env.GITHUB_TOKEN,
+			...proxyOptionsForGot,
+		})
+	} catch (e) {
+		console.error('[Kup] [Error] Request error:', e.message)
+		process.exit(1)
+	}
+
+	// handle response
+	if (response) {
+		const url = `https://github.com/${ repo }/issues/${ id }`
+		console.log(`[Kup] [Success] Updated to "${ repo }#${ id }"!`)
+		console.log(`[Kup] [Success] URL: ${ url }`)
+	}
+}
+
+async function postIssue(fileInfo, repo) {
+	// prepare fields
+	const title = fileInfo.meta.title || fileInfo.title || 'Issue posted by Kup @' + new Date().toISOString()
+	const body = fileInfo.content
+	const data = { title, body }
+	if (fileInfo.meta.tags) data.labels = fileInfo.meta.tags
+	if (isDebugging()) {
+		console.log('[Kup] [Debug] requestBody =', data)
+	}
+
+	// ask user if Kup should post a new issue
+	const answer = await inquirer.prompt([
+		{
+			name: 'postNewIssue',
+			type: 'confirm',
+			message: `Kup is going to post a new issue to "${ repo }", OK?`,
+			default: true,
+		},
+	])
+
+	// post
+	const api = `/repos/${ repo }/issues`
+	const method = 'POST'
+	let response = null
+	if (answer.postNewIssue) {
+		console.log(`[Kup] Posting to "${ repo }"...`)
+		try {
+			response = await ghGot(api, {
+				method,
+				body: data,
+				token: process.env.GITHUB_TOKEN,
+				...proxyOptionsForGot,
+			})
+		} catch (e) {
+			console.error('[Kup] [Error] Request error:', e.message)
+			process.exit(1)
+		}
+	} else {
+		console.log('[Kup] Aborted!')
+		process.exit(1)
+	}
+
+	// handle response
+	if (response) {
+		const id = response?.body?.number
+		const url = `https://github.com/${ repo }/issues/${ id }`
+		console.log(`[Kup] [Success] Posted to "${ repo }#${ id }"!`)
+		console.log(`[Kup] [Success] URL: ${ url }`)
+
+		// write back meta data
+		// TODO
+	}
+}
+
+export {
+	updateIssue,
+	postIssue,
+}

package/lib/token.js

@@ -0,0 +1,46 @@
+import inquirer from 'inquirer'
+
+async function getToken() {
+	let token = process.env.GITHUB_TOKEN
+	if (!token) {
+		console.error(`[Kup] Cannot find GitHub Token via env variable $GITHUB_TOKEN!`)
+		token = await _askToken()
+		// 把用户提供的 token 写入环境变量，不过只对当前进程有效
+		process.env.GITHUB_TOKEN = token
+	} else if (!_validateToken(token)) {
+		console.error('[Kup] [Error] The GitHub token you provide is invalid!')
+		console.error('[Kup] [Error] The GitHub token must be a "Personal Access Token"!')
+		process.exit(1)
+	}
+	return token
+}
+
+async function _askToken() {
+	const answer = await inquirer.prompt([
+		{
+			name: 'token',
+			type: 'input',
+			message: `Please input your GitHub token here:`,
+		},
+	])
+	const token = answer.token
+	if (!token) {
+		console.log('[Kup] Aborted!')
+		process.exit(1)
+	} else if (!_validateToken(token)) {
+		console.error('[Kup] [Error] The GitHub token you provide is invalid!')
+		console.error('[Kup] [Error] The GitHub token must be a "Personal Access Token"!')
+		process.exit(1)
+	}
+	return token
+}
+
+function _validateToken(token) {
+	const RE = /^ghp_\w+$/
+	return RE.test(token)
+}
+
+
+export {
+	getToken,
+}

package/lib/util.js

@@ -0,0 +1,19 @@
+// 考虑到输入源的类型有限，这里只是做了一个简化的实现
+function isPlainObject(obj) {
+	if (!obj) return false
+	if (typeof obj !== 'object') return false
+	if (Array.isArray(obj)) return false
+	return true
+}
+
+
+// run this line in shell to active debug mode:
+// `export KUP_DEBUG_MODE=1`
+function isDebugging() {
+	return !!Number(process.env.KUP_DEBUG_MODE)
+}
+
+export {
+	isPlainObject,
+	isDebugging,
+}

package/lib/validate.js

@@ -0,0 +1,69 @@
+function validate(argv) {
+	const {
+		id,
+		repo,
+		_: files,
+	} = argv
+
+	let results = []
+	if ('id' in argv) results.push(validateId(id))
+	if ('repo' in argv) results.push(validateRepo(repo))
+	results.push(validateFiles(files))
+	// 筛选出有错误的结果
+	const errorResults = results.filter((result) => result.status === false)
+
+	// 处理校验结果
+	errorResults.forEach((result) => {
+		console.error('[Kup] [Error] ' + result.errorMsg)
+	})
+
+	// 目前只能处理第一个文件，因此提示用户
+	if (files.length > 1) {
+		console.warn('[Kup] [Warning] Limitation: only first file will be handled!')
+	}
+
+	return errorResults.length < 1
+}
+
+function validateId(id) {
+	let errorMsg = ''
+	if (id <= 0 || !Number.isInteger(id)) {
+		errorMsg = '`id` must be a positive integer!'
+	}
+	return {
+		status: !errorMsg,
+		errorMsg,
+	}
+}
+function validateRepo(repo) {
+	const REPO_PATTERN = /^[\w\-]+\/[\w\-]+$/
+	let errorMsg = ''
+	if (!repo) {
+		errorMsg = '`repo` must be a string!'
+	} else if (!REPO_PATTERN.test(repo)) {
+		errorMsg = '`repo` must match `{owner}/{repo}` pattern!'
+	}
+	return {
+		status: !errorMsg,
+		errorMsg,
+	}
+}
+function validateFiles(files) {
+	let errorMsg = ''
+	if (!files.length) {
+		errorMsg = 'Must specify a local file!'
+	} else if (files.some((item) => !item)) {
+		errorMsg = 'File name must not be empty!'
+	}
+	return {
+		status: !errorMsg,
+		errorMsg,
+	}
+}
+
+export {
+	validate,
+	validateId,
+	validateRepo,
+	validateFiles,
+}

package/package.json

@@ -1,15 +1,20 @@
 {
 	"name": "kup-cli",
-	"version": "0.0.0-alpha.4",
-	"description": "A CLI tool to post Markdown files to GitHub as issues.",
+	"version": "0.1.0-beta.3",
+	"description": "A CLI tool to sync local Markdown files to GitHub issues.",
+	"type": "module",
 	"bin": {
-		"kup": "./bin/cli.js"
+		"kup": "bin/cli.js"
 	},
 	"scripts": {
-		"postpublish": "npm-mirror-sync",
+		"debug": "export KUP_DEBUG_MODE=1",
+		"postpublish": "npx npm-mirror-sync",
 		"test": "echo \"Error: no test specified\" && exit 1"
 	},
-	"repository": "cssmagic/kup",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/cssmagic/kup.git"
+	},
 	"keywords": [
 		"cli",
 		"markdown",
@@ -19,13 +24,18 @@
 	"author": "cssmagic <cssmagic.cn@gmail.com>",
 	"license": "MIT",
 	"engines": {
-		"node": ">=12"
+		"node": ">=18"
 	},
 	"dependencies": {
+		"find-up": "^5.0.0",
 		"gh-got": "^9.0.0",
+		"inquirer": "^8.2.4",
 		"yaml": "^2.1.0",
 		"yargs": "^17.5.0"
 	},
+	"devDependencies": {
+		"https-proxy-agent": "^5.0.1"
+	},
 	"files": [
 		"*.js",
 		"lib/",