create-clis 0.1.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -14
- package/README.zh-CN.md +22 -14
- package/assets/manifest.json +7 -2
- package/assets/template/.github/ISSUE_TEMPLATE/bug_report.yml +15 -29
- package/assets/template/.github/ISSUE_TEMPLATE/feature_request.yml +6 -12
- package/assets/template/.github/PULL_REQUEST_TEMPLATE.md +3 -3
- package/assets/template/.github/workflows/ci.yml +69 -7
- package/assets/template/.github/workflows/release.yml +23 -23
- package/assets/template/.gitignorerc.json +1 -8
- package/assets/template/.oxlintrc.json +1 -6
- package/assets/template/.prettierignore +0 -1
- package/assets/template/.releaserc.json +6 -1
- package/assets/template/.vscode/launch.json +1 -1
- package/assets/template/.vscode/settings.json +1 -0
- package/assets/template/.vscode/tasks.json +45 -0
- package/assets/template/AGENTS.md +4 -4
- package/assets/template/CONTRIBUTING.md +6 -4
- package/assets/template/CONTRIBUTING.zh-CN.md +6 -4
- package/assets/template/_gitignore +7 -405
- package/assets/template/bunfig.toml +2 -11
- package/assets/template/docs/README.md +6 -6
- package/assets/template/docs/adrs/README.md +4 -2
- package/assets/template/docs/development.md +15 -9
- package/assets/template/lefthook.yml +20 -30
- package/assets/template/package.json +5 -6
- package/assets/template/packages/{{NAME}}/README.md +4 -4
- package/assets/template/packages/{{NAME}}/README.zh-CN.md +2 -2
- package/assets/template/packages/{{NAME}}/package.json +3 -1
- package/assets/template/packages/{{NAME}}/scripts/build.ts +50 -14
- package/assets/template/packages/{{NAME}}/scripts/verify-release.test.ts +140 -15
- package/assets/template/packages/{{NAME}}/scripts/verify-release.ts +27 -14
- package/assets/template/packages/{{NAME}}/tsconfig.build.json +1 -1
- package/assets/template/packages/{{NAME}}-cli/README.md +6 -6
- package/assets/template/packages/{{NAME}}-cli/README.zh-CN.md +2 -2
- package/assets/template/packages/{{NAME}}-cli/bin/bunfig.toml +3 -0
- package/assets/template/packages/{{NAME}}-cli/bin/{{BIN_NAME}} +43 -21
- package/assets/template/packages/{{NAME}}-cli/bin/{{BIN_NAME}}.cmd +8 -17
- package/assets/template/packages/{{NAME}}-cli/bin/{{BIN_NAME}}.d.mts +6 -3
- package/assets/template/packages/{{NAME}}-cli/bin/{{BIN_NAME}}.mjs +189 -107
- package/assets/template/packages/{{NAME}}-cli/package.json +3 -2
- package/assets/template/packages/{{NAME}}-cli/scripts/release-artifact.ts +24 -73
- package/assets/template/packages/{{NAME}}-cli/scripts/release.fixtures.ts +8 -3
- package/assets/template/packages/{{NAME}}-cli/scripts/verify-release.test.ts +16 -10
- package/assets/template/packages/{{NAME}}-cli/scripts/verify-release.ts +8 -52
- package/assets/template/packages/{{NAME}}-cli/scripts/write-dist-manifest.test.ts +3 -3
- package/assets/template/packages/{{NAME}}-cli/scripts/write-dist-manifest.ts +8 -68
- package/assets/template/scripts/ci.ts +285 -64
- package/assets/template/scripts/install-git-hooks.mjs +10 -0
- package/assets/template/scripts/install-git-hooks.test.ts +1 -1
- package/assets/template/scripts/lib/npm-trust-parse.ts +169 -0
- package/assets/template/scripts/lib/release-cli.ts +299 -0
- package/assets/template/scripts/lib/release-verify.ts +148 -15
- package/assets/template/scripts/lib/workspace.test.ts +63 -1
- package/assets/template/scripts/lib/workspace.ts +132 -42
- package/assets/template/scripts/lint-dependency-direction.test.ts +131 -0
- package/assets/template/scripts/lint-dependency-direction.ts +130 -0
- package/assets/template/scripts/lint-doc-examples.test.ts +45 -9
- package/assets/template/scripts/lint-doc-examples.ts +227 -50
- package/assets/template/scripts/lint-doc-references.test.ts +36 -0
- package/assets/template/scripts/lint-doc-references.ts +142 -57
- package/assets/template/scripts/lint-doc-shared.ts +26 -23
- package/assets/template/scripts/lint-stray-backups.test.ts +3 -1
- package/assets/template/scripts/lint-stray-backups.ts +7 -3
- package/assets/template/scripts/npm-trust-guard.test.ts +56 -8
- package/assets/template/scripts/npm-trust-guard.ts +116 -200
- package/assets/template/scripts/safe-install.ts +28 -23
- package/assets/template/scripts/transcription/api-harness.ts +28 -206
- package/assets/template/scripts/transcription/compare.test.ts +84 -0
- package/assets/template/scripts/transcription/compare.ts +4 -4
- package/assets/template/scripts/transcription/corpus.ts +9 -3
- package/assets/template/scripts/transcription/fixture.ts +2 -4
- package/assets/template/scripts/transcription/make-mutants.ts +116 -37
- package/assets/template/scripts/transcription/run-conformance.ts +57 -34
- package/assets/template/scripts/transcription/validate-coverage.test.ts +11 -14
- package/assets/template/scripts/transcription/validate-coverage.ts +8 -10
- package/assets/template/scripts/transcription/validate.ts +18 -3
- package/assets/template/tsconfig.json +2 -20
- package/assets/template/turbo.jsonc +7 -52
- package/bin/bunfig.toml +3 -0
- package/bin/create-clis.mjs +165 -104
- package/dist/create-clis.js +48 -87681
- package/dist/manifest.json +3 -3
- package/package.json +9 -5
- package/assets/template/packages/{{NAME}}/docs/README.md +0 -21
- package/assets/template/packages/{{NAME}}-cli/docs/README.md +0 -21
- package/bin/create-clis +0 -35
- package/bin/create-clis.cmd +0 -32
package/dist/manifest.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"commit": "
|
|
3
|
+
"commit": "748a48f01856e965556f0c69d29c5d408cd7a6ad",
|
|
4
4
|
"dirty": false,
|
|
5
|
-
"cliSha256": "
|
|
6
|
-
"builtAt": "2026-
|
|
5
|
+
"cliSha256": "00b20e23adfa38e233e8154217bca61fefd675bfb465d24c5204c26759b92f48",
|
|
6
|
+
"builtAt": "2026-11-20T04:00:54.805Z"
|
|
7
7
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-clis",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Scaffold a standalone clis collection repository from the clis skeleton snapshot: capability tiers, generic vocabulary, green CI out of the box. clis 集合仓生成器。",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|
|
@@ -31,7 +31,8 @@
|
|
|
31
31
|
"create-clis": "bin/create-clis.mjs"
|
|
32
32
|
},
|
|
33
33
|
"files": [
|
|
34
|
-
"bin",
|
|
34
|
+
"bin/create-clis.mjs",
|
|
35
|
+
"bin/bunfig.toml",
|
|
35
36
|
"dist",
|
|
36
37
|
"assets"
|
|
37
38
|
],
|
|
@@ -43,15 +44,18 @@
|
|
|
43
44
|
"registry": "https://registry.npmjs.org/"
|
|
44
45
|
},
|
|
45
46
|
"scripts": {
|
|
46
|
-
"build": "bun scripts/build-template.ts && bun build src/cli.ts --target=node --outfile=dist/create-clis.js && bun scripts/write-dist-manifest.ts",
|
|
47
|
+
"build": "bun scripts/build-template.ts && bun build src/cli.ts --target=node --minify-whitespace --minify-syntax --external prettier --external @trivago/prettier-plugin-sort-imports --outfile=dist/create-clis.js && bun scripts/write-dist-manifest.ts",
|
|
47
48
|
"prepublishOnly": "npm run build && npm run verify:release && npm run heavy-smoke",
|
|
48
49
|
"verify:release": "bun scripts/verify-release.ts",
|
|
49
50
|
"heavy-smoke": "bun scripts/heavy-smoke.ts",
|
|
50
|
-
"typecheck": "
|
|
51
|
-
"test": "bun test
|
|
51
|
+
"typecheck": "bun check",
|
|
52
|
+
"test": "bun test src scripts"
|
|
52
53
|
},
|
|
53
54
|
"dependencies": {
|
|
54
55
|
"@trivago/prettier-plugin-sort-imports": "6.0.2",
|
|
55
56
|
"prettier": "3.9.9"
|
|
57
|
+
},
|
|
58
|
+
"devDependencies": {
|
|
59
|
+
"@iyowei/cli-updater": "1.0.0"
|
|
56
60
|
}
|
|
57
61
|
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# {{SCOPE}}/{{NAME}} (API 包) 文档
|
|
2
|
-
|
|
3
|
-
> 文档类型: 包级文档入口
|
|
4
|
-
|
|
5
|
-
`{{SCOPE}}/{{NAME}}` 是示例包的可编程 API: 换成自己的领域逻辑后, 在此登记包内文档与包级 ADR。使用面见[包 README](../README.md)。
|
|
6
|
-
|
|
7
|
-
## 包内文档
|
|
8
|
-
|
|
9
|
-
| 文档 | 一句话 |
|
|
10
|
-
| -------- | ------------------------------------ |
|
|
11
|
-
| (待登记) | 新项目在这里登记包级设计文档的第一篇 |
|
|
12
|
-
|
|
13
|
-
## 包级 ADR
|
|
14
|
-
|
|
15
|
-
| 编号 | 标题 |
|
|
16
|
-
| -------- | ----------------------------- |
|
|
17
|
-
| (待登记) | 包级 ADR 与仓库级共用一套编号 |
|
|
18
|
-
|
|
19
|
-
## 仓库级关联
|
|
20
|
-
|
|
21
|
-
- [仓库文档索引](../../../docs/README.md) / [设计文档索引](../../../docs/designs/README.md)。
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# {{SCOPE}}/{{NAME}}-cli (CLI 包) 文档
|
|
2
|
-
|
|
3
|
-
> 文档类型: 包级文档入口
|
|
4
|
-
|
|
5
|
-
`{{SCOPE}}/{{NAME}}-cli` 是示例工具的命令行薄壳: 换成自己的命令后, 在此登记包内文档与包级 ADR。使用面见[包 README](../README.md)。
|
|
6
|
-
|
|
7
|
-
## 包内文档
|
|
8
|
-
|
|
9
|
-
| 文档 | 一句话 |
|
|
10
|
-
| -------- | ------------------------------------ |
|
|
11
|
-
| (待登记) | 新项目在这里登记包级设计文档的第一篇 |
|
|
12
|
-
|
|
13
|
-
## 包级 ADR
|
|
14
|
-
|
|
15
|
-
| 编号 | 标题 |
|
|
16
|
-
| -------- | ----------------------------- |
|
|
17
|
-
| (待登记) | 包级 ADR 与仓库级共用一套编号 |
|
|
18
|
-
|
|
19
|
-
## 仓库级关联
|
|
20
|
-
|
|
21
|
-
- [仓库文档索引](../../../docs/README.md) / [设计文档索引](../../../docs/designs/README.md)。
|
package/bin/create-clis
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
#!/bin/sh
|
|
2
|
-
# create-clis 启动器: 挑选运行时 (Bun 优先, 其次 Node) 后交给 npm 分发入口 (bin/create-clis.mjs)。
|
|
3
|
-
# 经 ~/.local/bin/create-clis 软链调用; readlink 解出仓库内路径 (BSD / GNU 皆可)。
|
|
4
|
-
#
|
|
5
|
-
# 为什么不像既有 CLI 包那样直接 exec 真实入口: 生成器只认产物 (dist/create-clis.js, 无源码回退),
|
|
6
|
-
# 而产物必须先与 dist/manifest.json 的摘要对账才许执行; 该自证逻辑只在 bin/create-clis.mjs 一处
|
|
7
|
-
# 实现, 三个入口全部经它, 免得 sh / cmd 两份 shell 各自复刻判定 (复刻即分叉)。
|
|
8
|
-
#
|
|
9
|
-
# 运行时解析防劫持 (安全审计项 runtime-resolution:bare-name-cwd-precedence-windows):
|
|
10
|
-
# 本入口的 command -v 与 exec 都按 shell 的 PATH 查找; shell 层无法过滤 PATH 中的空 / 相对
|
|
11
|
-
# 条目 (两者在 POSIX 下均意为当前目录), 该边界属已知前提: 本入口只负责把控制权交给
|
|
12
|
-
# bin/create-clis.mjs, 真正解析「跑产物的那个运行时」在那一侧完成 (按 PATH 解析绝对路径并跳过
|
|
13
|
-
# 这两类条目), 防御落在那一侧。对照实测与本条的证据面见
|
|
14
|
-
# packages/sweep-node-modules-cli/src/launcher.runtime-resolution.test.ts (同款逻辑的钉住用例);
|
|
15
|
-
# win32 侧的对应处理见 bin/create-clis.cmd 与 bin/create-clis.mjs 的文件头。
|
|
16
|
-
|
|
17
|
-
# readlink 为空 = 未经软链直跑, 此时 $0 即自身路径
|
|
18
|
-
target=$(readlink "$0" 2>/dev/null)
|
|
19
|
-
case "$target" in
|
|
20
|
-
"") target=$0 ;;
|
|
21
|
-
/*) ;;
|
|
22
|
-
*) target="$(dirname "$0")/$target" ;;
|
|
23
|
-
esac
|
|
24
|
-
root=$(cd "$(dirname "$target")/.." && pwd)
|
|
25
|
-
|
|
26
|
-
if command -v bun >/dev/null 2>&1; then
|
|
27
|
-
exec bun "$root/bin/create-clis.mjs" "$@"
|
|
28
|
-
fi
|
|
29
|
-
|
|
30
|
-
if command -v node >/dev/null 2>&1; then
|
|
31
|
-
exec node "$root/bin/create-clis.mjs" "$@"
|
|
32
|
-
fi
|
|
33
|
-
|
|
34
|
-
echo "create-clis: 未找到 bun 或 node, 请至少安装其一" >&2
|
|
35
|
-
exit 1
|
package/bin/create-clis.cmd
DELETED
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
@echo off
|
|
2
|
-
rem create-clis 启动器 (Windows): 挑选运行时 (Bun 优先, 其次 Node) 后交给 npm 分发入口
|
|
3
|
-
rem (bin/create-clis.mjs, 内含产物自证)。与 sh 启动器 (bin/create-clis) 同逻辑; 未经 Windows
|
|
4
|
-
rem 真机验证 (证据缺口)。
|
|
5
|
-
rem 分支结构全程只用单行 if 判定 (不用标签与括号块), 与 sh 启动器一一对应。
|
|
6
|
-
rem
|
|
7
|
-
rem 运行时解析防劫持 (安全审计项 runtime-resolution:bare-name-cwd-precedence-windows):
|
|
8
|
-
rem 裸名执行与 where 的默认搜索都含当前目录 (官方文档: by default, where searches the current
|
|
9
|
-
rem directory and the paths that are specified in the PATH environment variable; path 命令页:
|
|
10
|
-
rem the current directory is always searched before the directories specified in the command path),
|
|
11
|
-
rem 而本生成器的调用现场在用户自己的目录里: 目录内放一个同名 bun.exe / bun.cmd 即可顶替真实
|
|
12
|
-
rem 运行时。故改用 for 的 PATH 展开修饰符 (官方 for 文档: Searches the directories listed in the
|
|
13
|
-
rem PATH environment variable and expands 变量 to the fully qualified name of the first directory
|
|
14
|
-
rem found): 只搜 PATH, 不搜当前目录, 也不派生任何子进程; 解析出的绝对路径交给末行执行, 带路径
|
|
15
|
-
rem 的命令不再触发搜索序。候选扩展名取 .com / .exe: 扩展名相对序 (.com 先于 .exe) 与 libuv 一致;
|
|
16
|
-
rem 搜索粒度则不同: 本实现扩展名优先 (.com 扫完全部 PATH 目录再试 .exe), npm 启动器
|
|
17
|
-
rem (bin/create-clis.mjs, 走 Node 的 libuv 搜索) 目录优先 (逐目录内先 .com 再 .exe); 仅当多个
|
|
18
|
-
rem PATH 目录分别存在不同扩展名的 bun / node 时, 三入口可能选中不同二进制 (与既有 CLI 包同款
|
|
19
|
-
rem 登记, 见 packages/sweep-node-modules/docs/adrs/0007-platform-portability.md)。
|
|
20
|
-
setlocal
|
|
21
|
-
set "ROOT=%~dp0.."
|
|
22
|
-
set "ENTRY=%ROOT%\bin\create-clis.mjs"
|
|
23
|
-
set "RUNNER="
|
|
24
|
-
|
|
25
|
-
for %%I in (bun.com bun.exe) do if not defined RUNNER set "RUNNER=%%~$PATH:I"
|
|
26
|
-
if not defined RUNNER for %%I in (node.com node.exe) do if not defined RUNNER set "RUNNER=%%~$PATH:I"
|
|
27
|
-
|
|
28
|
-
if not defined RUNNER echo create-clis: 未找到 bun 或 node, 请至少安装其一 1>&2
|
|
29
|
-
if not defined RUNNER exit /b 1
|
|
30
|
-
|
|
31
|
-
"%RUNNER%" "%ENTRY%" %*
|
|
32
|
-
exit /b %errorlevel%
|