dsh-git-push 2.20.11 → 2.20.18
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 +10 -6
- package/cli-audit.mjs +141 -0
- package/cli-tool.mjs +86 -0
- package/cli.mjs +114 -335
- package/lib/app/command-registry.js +3 -2
- package/lib/app/constants.js +9 -0
- package/lib/app/handlers/clone.js +12 -3
- package/lib/app/handlers/http-constants.js +11 -2
- package/lib/app/handlers/npm.js +4 -2
- package/lib/app/handlers/repos.js +10 -1
- package/lib/app/handlers/settings.js +9 -1
- package/lib/app/http-handlers.js +24 -3
- package/lib/app/schema-audit.js +42 -0
- package/lib/app/schema.js +19 -19
- package/lib/app/settings-bridge.js +51 -0
- package/lib/app/tool-call.js +7 -5
- package/lib/audit-rules/audit-rules-paths.yml +7 -1
- package/lib/audit-ui-sdk/contract.js +117 -0
- package/lib/audit-ui-sdk/index.js +17 -0
- package/lib/checks/regex.js +6 -1
- package/lib/cli/commands-audit.mjs +12 -17
- package/lib/cli/commands-tool.mjs +93 -0
- package/lib/cli/commands-vcs.mjs +2 -1
- package/lib/cli/shared.mjs +448 -0
- package/lib/client-parts/{account.js → git/account.js} +1 -1
- package/lib/client-parts/{actions.js → git/actions.js} +26 -11
- package/lib/client-parts/{apply.js → git/apply.js} +1 -1
- package/lib/client-parts/{browser.js → git/browser.js} +1 -1
- package/lib/client-parts/{const.js → git/const.js} +6 -1
- package/lib/client-parts/{controller.js → git/controller.js} +23 -11
- package/lib/client-parts/{icons.js → git/icons.js} +1 -1
- package/lib/client-parts/{loader.js → git/loader.js} +1 -1
- package/lib/client-parts/{npm.js → git/npm.js} +1 -1
- package/lib/client-parts/{page.js → git/page.js} +11 -21
- package/lib/client-parts/{repo.js → git/repo.js} +1 -1
- package/lib/client-parts/{settings.js → git/settings.js} +1 -1
- package/lib/client-parts/{utils.js → git/utils.js} +1 -1
- package/lib/client.js +75 -354
- package/lib/commit-push/pre-commit-engine.js +388 -0
- package/lib/commit-push.js +42 -20
- package/lib/git/transport.js +31 -10
- package/lib/http/index.js +82 -10
- package/lib/npm/npmrc.js +22 -5
- package/lib/self/index.js +1 -1
- package/package.json +6 -2
- package/scripts/audit-gate.mjs +235 -0
- package/scripts/build-client.mjs +15 -8
- package/scripts/check.mjs +12 -3
- package/scripts/scan-file-io.mjs +5 -1
- package/scripts/scan-version.mjs +10 -7
- package/skills/dev/dsh-git-push.md +62 -0
- package/skills/guide/guide-audit.md +11 -11
- package/skills/guide/guide-cli-scripts.md +3 -3
- package/skills/guide/guide-commit-push.md +2 -2
- package/skills/guide/guide-inject-ui.md +0 -16
- package/assets/start.sh +0 -396
- package/scripts/scan-hardcoded-paths.mjs +0 -125
- /package/lib/client-parts/{audit.js → audit/audit.js} +0 -0
package/README.md
CHANGED
|
@@ -76,12 +76,14 @@ module_splitter({ command, file, plan, dryRun }) // command 必填(analyze
|
|
|
76
76
|
### 独立 CLI(git-sluice)
|
|
77
77
|
|
|
78
78
|
```
|
|
79
|
-
git-sluice account-check
|
|
80
|
-
git-sluice scan <目录>
|
|
81
|
-
git-sluice
|
|
82
|
-
git-sluice
|
|
83
|
-
|
|
84
|
-
|
|
79
|
+
git-sluice account-check # 校验本机 GitHub 凭据
|
|
80
|
+
git-sluice scan <目录> # 列出该目录下的 git 仓库
|
|
81
|
+
git-sluice commit <仓库> --message "msg" # 提交并推送(自动过审计门禁)
|
|
82
|
+
git-sluice help # git 侧全部命令
|
|
83
|
+
|
|
84
|
+
audit-sluice audit <仓库> --full # 全量审计(加 --json 拿明细)
|
|
85
|
+
audit-sluice scope-check [文件] # 查拼接产物同帧重名(无参数时读项目 dshScopeCheck.files)
|
|
86
|
+
tool-sluice self-check # 三入口 HELP/参数/命令集一致性自检
|
|
85
87
|
```
|
|
86
88
|
|
|
87
89
|
## API
|
|
@@ -109,6 +111,8 @@ curl "http://<本机IP>:<端口>/api/git-push/api"
|
|
|
109
111
|
## 文档索引
|
|
110
112
|
|
|
111
113
|
- [docs/SPEC.md](docs/SPEC.md) — 规格唯一入口(工具、接口、设置键、数据文件、规则体系)
|
|
114
|
+
- [docs/功能-审计引擎.md](docs/功能-审计引擎.md) — 审计引擎(规则体系、判定、评分、委托层、豁免)
|
|
115
|
+
- [docs/功能-发布与工具链.md](docs/功能-发布与工具链.md) — 提交推送、克隆、npm 发布、仓库索引、文档生成
|
|
112
116
|
- [docs/FILE-TREE.md](docs/FILE-TREE.md) — 目录结构(自动生成)
|
|
113
117
|
- [docs/CHANGELOG.md](docs/CHANGELOG.md) — 版本列表(自动生成)
|
|
114
118
|
- [docs/FUNCTIONS.md](docs/FUNCTIONS.md) — 函数列表(自动生成)
|
package/cli-audit.mjs
ADDED
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// dsh-skip-i18n: CLI 输出硬编码中文为产品行为(无 i18n 需求)
|
|
3
|
+
/**
|
|
4
|
+
* dsh-git-push 独立 CLI · **审计侧**(bin: audit-sluice)
|
|
5
|
+
* 不依赖 DSH 运行时,可独立运行。
|
|
6
|
+
*
|
|
7
|
+
* 为什么单独一个入口(而不是继续挂在 git-sluice 里):
|
|
8
|
+
* 审计引擎上一轮已经解耦成「可配置子进程」,但入口层如果还共用,用户仍得敲
|
|
9
|
+
* `git-sluice audit` 才能跑到审计——「审计侧独立」只做了一半。现在审计有自己的 CLI,
|
|
10
|
+
* 换引擎(含换语言重写)与换 CLI 组合互不影响。
|
|
11
|
+
*
|
|
12
|
+
* ⚠️⚠️ 两条**纯副作用 import** 是本入口的生命线(删了不报错、少了不报错,只会让功能静默失效):
|
|
13
|
+
* ① ./lib/app/host-doc-checks.js —— 目录树漂移 / 函数列表漂移两类检查器由宿主注入。
|
|
14
|
+
* 漏搬后果:同一棵树上这两类 finding **整类消失**(实测少 4 条),审计照常「通过」。
|
|
15
|
+
* ② ./lib/rule/compilers.js —— 规则编译函数注册(13 种)。
|
|
16
|
+
* 漏搬后果:`ruleset` 命令编译出 0 条规则却报「OK」。
|
|
17
|
+
* (`audit` 走 lib/audit/index.js,那条路径自身也会注册编译器;但 `ruleset` 不走审计编排,
|
|
18
|
+
* 必须靠本文件的显式 import。两处都留是刻意的冗余——这类静默失效不值得省一行 import。)
|
|
19
|
+
*
|
|
20
|
+
* 本文件只保留:命令表 + HELP 文本 + 薄壳。解析/打印/分发/跨侧提示都在 lib/cli/shared.mjs。
|
|
21
|
+
*/
|
|
22
|
+
import './lib/app/host-doc-checks.js'; // 副作用①:文档漂移检查器接线(审计专用)
|
|
23
|
+
import './lib/rule/compilers.js'; // 副作用②:规则编译函数注册(audit / ruleset 依赖)
|
|
24
|
+
|
|
25
|
+
import { VERSION } from './lib/self/index.js';
|
|
26
|
+
import { loadRuleFiles } from './lib/rule/loader.js';
|
|
27
|
+
import { compileAllRules } from './lib/rule/registry.js';
|
|
28
|
+
|
|
29
|
+
import {
|
|
30
|
+
cmdAudit, cmdScan, pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig,
|
|
31
|
+
} from './lib/cli/commands-audit.mjs';
|
|
32
|
+
import { cmdLinkCheck } from './lib/cli/commands-vcs.mjs';
|
|
33
|
+
import { cmdFileIo, cmdTreeDoc, cmdFunctions } from './lib/cli/commands-doc.mjs';
|
|
34
|
+
import {
|
|
35
|
+
CLI_AUDIT, CLI_ENTRIES, printToolResult, parseArgv, parseVia, runAsEntry, runCli,
|
|
36
|
+
} from './lib/cli/shared.mjs';
|
|
37
|
+
|
|
38
|
+
export const CLI_NAME = CLI_AUDIT;
|
|
39
|
+
|
|
40
|
+
/** parseArgv 认识的选项白名单(本侧 HELP 写着的那批;self-check 机器比对本表与 HELP 文本)。
|
|
41
|
+
* 注:**注册表驱动**命令(file-io / link-check / scope-check)的参数由
|
|
42
|
+
* lib/app/command-registry.js 的 params 校验,与本表无关;本侧 HELP 写了的 flag 必须在本表出现。 */
|
|
43
|
+
export const KNOWN_FLAGS = [
|
|
44
|
+
'--allowlist', '--files', '--full', '--history', '--include-ignored', '--json', '--out', '--prefix', '--readme',
|
|
45
|
+
'--repo', '--root', '--ruleset', '--since', '--skip-empty', '--top-level-must-be-empty', '--until', '--weights',
|
|
46
|
+
'--write', '--write-only',
|
|
47
|
+
];
|
|
48
|
+
|
|
49
|
+
const HELP = `audit-sluice v${VERSION} — ${CLI_ENTRIES[CLI_AUDIT].intro}
|
|
50
|
+
|
|
51
|
+
快速开始(第一次用——不用查源码):
|
|
52
|
+
audit-sluice audit . ① 审计当前仓库(默认只看本次改动)
|
|
53
|
+
audit-sluice audit . --full ② 全量审计(评分 + 问题明细)
|
|
54
|
+
audit-sluice ruleset ③ 规则包是否能编译(改规则后先跑它)
|
|
55
|
+
audit-sluice help 全部命令与参数
|
|
56
|
+
|
|
57
|
+
其它 CLI(本入口不含,敲错会给出替代命令):
|
|
58
|
+
git-sluice 提交/推送/克隆/账号/仓库扫描: scan commit clone remote-create rename set-visibility identity-rewrite account-check cred-env gen-ssh-key git api repos index npm-publish unpublish
|
|
59
|
+
tool-sluice 工具链: module-splitter yaml-template readme-template self-check
|
|
60
|
+
|
|
61
|
+
用法(每行写的参数就是该命令真实接受的写法,照抄即可):
|
|
62
|
+
audit-sluice version 查看版本
|
|
63
|
+
audit-sluice audit <root> [--full] [--ruleset <目录>] [--weights <JSON>] [--include-ignored] [--history [--since <提交>] [--until <提交>] [--out <目录>]] [--json]
|
|
64
|
+
审计目录(默认 diff 范围;--full=全量;--ruleset=自定规则目录;--weights=权重覆盖 JSON;
|
|
65
|
+
--include-ignored=连 .gitignore 忽略的文件也扫描;--history=历史提交审计——逐提交快照全量审计并落盘报告,
|
|
66
|
+
--since/--until 起始~结束提交(皆缺省=全部历史、含两端),--out 报告保存目录(缺省=git 根 audit-history/))
|
|
67
|
+
audit-sluice ruleset [槽位...] 编译规则包并输出统计(默认全部槽位)
|
|
68
|
+
audit-sluice file-io [路径] [--write-only]
|
|
69
|
+
文件读写调用扫描(同步 I/O 在异步路径会阻塞;写/删/改名涉及数据安全);--write-only=只看写操作。
|
|
70
|
+
按类型/操作/风险分组的明细走 code_audit 工具的 io_scan 结果
|
|
71
|
+
audit-sluice link-check <路径> 检查 md/文本中的链接有效性(只 warning,flaky 域名打折)
|
|
72
|
+
audit-sluice scope-check [文件...] [--files <文件,文件>] [--repo <目录>] [--prefix <前缀>] [--allowlist <名,名>] [--top-level-must-be-empty] [--json]
|
|
73
|
+
拼接产物作用域撞名(多段 JS 拼进同一作用域):同一函数帧内重名会让后者静默顶掉前者,运行期毫无线索;
|
|
74
|
+
判定按真实作用域帧(两个不同函数里的同名局部变量不算撞名);顶层声明与命名前缀按被查项目自己的 package.json(dshScopeCheck)判定,
|
|
75
|
+
没声明就只查同帧重名(不拿本项目的命名前缀去要求别人);不给文件时取该项目 dshScopeCheck.files
|
|
76
|
+
audit-sluice functions <analyze|apply> [目录] [--skip-empty] [--json]
|
|
77
|
+
函数索引与函数文档:analyze 生成 functions-index.json(含签名/注释槽位);
|
|
78
|
+
apply 读 JSON(人工补 comment 后)生成 docs/函数 下的 md(文件删除归档 _archived,注释不丢)
|
|
79
|
+
audit-sluice tree-doc <sync|gen|check|apply> [--root <目录>] [--readme <路径>] [--write]
|
|
80
|
+
README 目录结构维护:sync 索引同步(新增自动加键/删除自动删键);gen 生成树;
|
|
81
|
+
check 检查漂移;apply 覆盖 README/FILE-TREE 标记块(封装 scripts/doc-tree.mjs)
|
|
82
|
+
audit-sluice help 显示本帮助
|
|
83
|
+
`;
|
|
84
|
+
|
|
85
|
+
/** 子命令:ruleset — 编译规则包输出统计(依赖本文件顶部的 compilers 副作用 import)。 */
|
|
86
|
+
export function cmdRuleset(slots = []) {
|
|
87
|
+
const order = slots.length ? slots : null; // null=动态发现全部槽位
|
|
88
|
+
const { ok, merged, errors, files, order: effective } = loadRuleFiles(order);
|
|
89
|
+
const ctx = { errors: [] };
|
|
90
|
+
const compiled = compileAllRules(merged.rules, ctx);
|
|
91
|
+
if (!ok || ctx.errors.length) {
|
|
92
|
+
console.error('规则编译失败:');
|
|
93
|
+
for (const failure of [...errors, ...ctx.errors]) console.error(' ✗ ' + failure);
|
|
94
|
+
process.exitCode = 1;
|
|
95
|
+
return;
|
|
96
|
+
}
|
|
97
|
+
console.log(`规则包编译 OK(${effective.join('+')})`);
|
|
98
|
+
console.log(` 文件: ${files.length} 个槽位, 规则条目 ${merged.rules.length}, 编译成功 ${compiled.length}`);
|
|
99
|
+
const byKind = {};
|
|
100
|
+
for (const rule of compiled) {
|
|
101
|
+
const kind = rule.kind || rule.type || 'other';
|
|
102
|
+
byKind[kind] = (byKind[kind] || 0) + 1;
|
|
103
|
+
}
|
|
104
|
+
for (const [kind, count] of Object.entries(byKind)) console.log(` ${kind}: ${count}`);
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/** 命令表(本侧独有的 COMMANDS;注册表驱动的 file-io / link-check / scope-check 由 shared 分发)。 */
|
|
108
|
+
export const COMMANDS = new Map([
|
|
109
|
+
['ruleset', (rest) => cmdRuleset(rest)],
|
|
110
|
+
// audit 不走注册表——CLI 独立审计需完整 findings(不依赖宿主 API);工具 code_audit 输出 API 指引
|
|
111
|
+
['audit', parseVia((flags, positional) => cmdAudit(positional[0] || '.', flags))],
|
|
112
|
+
['functions', parseVia((flags, positional) => cmdFunctions(positional[0] || '', positional[1] || '', flags))],
|
|
113
|
+
['tree-doc', parseVia((flags, positional) => cmdTreeDoc(positional[0] || '', flags))],
|
|
114
|
+
// 兼容:scan 属于 git 侧(注册表 git_scan);此处保留导出给老代码直调,不注册进命令表
|
|
115
|
+
]);
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* 入口 main。
|
|
119
|
+
* @param {string[]} argv
|
|
120
|
+
* @returns {Promise<number|undefined>}
|
|
121
|
+
*/
|
|
122
|
+
export async function main(argv = process.argv.slice(2)) {
|
|
123
|
+
return await runCli({
|
|
124
|
+
cliName: CLI_AUDIT,
|
|
125
|
+
argv,
|
|
126
|
+
commands: COMMANDS,
|
|
127
|
+
helpText: HELP,
|
|
128
|
+
getConfig: cliPluginConfig,
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
runAsEntry(import.meta.url, main);
|
|
133
|
+
|
|
134
|
+
// 兼容导出(审计侧实现的老引用路径)
|
|
135
|
+
export { cmdAudit, cmdScan, cmdLinkCheck, cmdFileIo, cmdTreeDoc, cmdFunctions };
|
|
136
|
+
export { pluginEqualAuditOpts, pluginEqualWeights, cliPluginConfig, parseArgv, printToolResult };
|
|
137
|
+
|
|
138
|
+
/** 子命令:version(三入口同一实现,只有名字不同)。 */
|
|
139
|
+
export function cmdVersion() {
|
|
140
|
+
console.log(`audit-sluice v${VERSION} — dsh-git-push(统一函数入口架构)`);
|
|
141
|
+
}
|
package/cli-tool.mjs
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// dsh-skip-i18n: CLI 输出硬编码中文为产品行为(无 i18n 需求)
|
|
3
|
+
/**
|
|
4
|
+
* dsh-git-push 独立 CLI · **工具链侧**(bin: tool-sluice)
|
|
5
|
+
* 不依赖 DSH 运行时,可独立运行。
|
|
6
|
+
*
|
|
7
|
+
* 本侧只有「对项目自身/脚手架」的命令:拆分、模板、自检。它与 git 侧、审计侧都无关,
|
|
8
|
+
* 单独成入口的理由是:这些命令需要读源码/跑 python/写文档,是维护者工具,
|
|
9
|
+
* 不该混进用户日常用的 git/审计 CLI(误敲概率与权限担心都更低)。
|
|
10
|
+
*
|
|
11
|
+
* ⚠️ self-check 会读另两个入口的**源码文本**核对 HELP↔KNOWN_FLAGS,
|
|
12
|
+
* 所以本入口必须能定位到 cli.mjs / cli-audit.mjs(同目录,随包发布)。
|
|
13
|
+
*
|
|
14
|
+
* 本文件只保留:命令表 + HELP 文本 + 薄壳。解析/打印/分发/跨侧提示都在 lib/cli/shared.mjs。
|
|
15
|
+
*/
|
|
16
|
+
import { VERSION } from './lib/self/index.js';
|
|
17
|
+
|
|
18
|
+
import {
|
|
19
|
+
cmdModuleSplitter,
|
|
20
|
+
} from './lib/cli/commands-doc.mjs';
|
|
21
|
+
import { cmdReadmeTemplate, cmdSelfCheck, cmdYamlTemplate } from './lib/cli/commands-tool.mjs';
|
|
22
|
+
import { CLI_TOOL, CLI_ENTRIES, cliPluginConfig, runAsEntry, runCli } from './lib/cli/shared.mjs';
|
|
23
|
+
|
|
24
|
+
export const CLI_NAME = CLI_TOOL;
|
|
25
|
+
|
|
26
|
+
/** parseArgv 认识的选项白名单(本侧 HELP 写着的那批;self-check 机器比对本表与 HELP 文本)。
|
|
27
|
+
* 注:module-splitter 走注册表参数校验(lib/app/command-registry.js 的 params),本表只覆盖
|
|
28
|
+
* 非注册表命令用到的 flag。 */
|
|
29
|
+
export const KNOWN_FLAGS = [
|
|
30
|
+
'--dry-run', '--file', '--plan',
|
|
31
|
+
];
|
|
32
|
+
|
|
33
|
+
const HELP = `tool-sluice v${VERSION} — ${CLI_ENTRIES[CLI_TOOL].intro}
|
|
34
|
+
|
|
35
|
+
快速开始(第一次用——不用查源码):
|
|
36
|
+
tool-sluice self-check ① 自检:版本一致性 + 三入口 HELP↔参数表比对
|
|
37
|
+
tool-sluice module-splitter analyze --file <文件> ② 巨型单文件先出块/依赖图
|
|
38
|
+
tool-sluice yaml-template ③ 打印规则 yml 模板
|
|
39
|
+
tool-sluice help 全部命令与参数
|
|
40
|
+
|
|
41
|
+
其它 CLI(本入口不含,敲错会给出替代命令):
|
|
42
|
+
git-sluice 提交/推送/克隆/账号/仓库扫描: scan commit clone remote-create rename set-visibility identity-rewrite account-check cred-env gen-ssh-key git api repos index npm-publish unpublish
|
|
43
|
+
audit-sluice 审计/规则/静态检查: audit ruleset file-io link-check scope-check functions tree-doc
|
|
44
|
+
|
|
45
|
+
用法(每行写的参数就是该命令真实接受的写法,照抄即可):
|
|
46
|
+
tool-sluice version 查看版本
|
|
47
|
+
tool-sluice module-splitter <analyze|split|verify> [--file <文件>] [--plan <plan.json>] [--dry-run]
|
|
48
|
+
巨型单文件按顶层块拆分(零依赖 python3 实现;analyze 先出块/依赖图 →
|
|
49
|
+
写 plan.json → split 切分 → verify 校验导出面;--dry-run=split 只预演)
|
|
50
|
+
tool-sluice yaml-template 输出规则 yml 模板(含 kind + dimensions 示范)
|
|
51
|
+
tool-sluice readme-template 输出 README 模板(含 name/version 占位符)
|
|
52
|
+
tool-sluice self-check 版本一致性 + 三个入口的 HELP↔参数表机器比对 + 命令覆盖自检
|
|
53
|
+
tool-sluice help 显示本帮助
|
|
54
|
+
`;
|
|
55
|
+
|
|
56
|
+
/** 命令表(注册表驱动的 module-splitter 由 shared 分发;这里只登记非注册表命令)。 */
|
|
57
|
+
export const COMMANDS = new Map([
|
|
58
|
+
['yaml-template', () => cmdYamlTemplate()],
|
|
59
|
+
['readme-template', () => cmdReadmeTemplate()],
|
|
60
|
+
['self-check', () => cmdSelfCheck()],
|
|
61
|
+
]);
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* 入口 main。
|
|
65
|
+
* @param {string[]} argv
|
|
66
|
+
* @returns {Promise<number|undefined>}
|
|
67
|
+
*/
|
|
68
|
+
export async function main(argv = process.argv.slice(2)) {
|
|
69
|
+
return await runCli({
|
|
70
|
+
cliName: CLI_TOOL,
|
|
71
|
+
argv,
|
|
72
|
+
commands: COMMANDS,
|
|
73
|
+
helpText: HELP,
|
|
74
|
+
getConfig: cliPluginConfig,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
runAsEntry(import.meta.url, main);
|
|
79
|
+
|
|
80
|
+
// 兼容导出
|
|
81
|
+
export { cmdModuleSplitter, cmdYamlTemplate, cmdReadmeTemplate, cmdSelfCheck };
|
|
82
|
+
|
|
83
|
+
/** 子命令:version(三入口同一实现,只有名字不同)。 */
|
|
84
|
+
export function cmdVersion() {
|
|
85
|
+
console.log(`tool-sluice v${VERSION} — dsh-git-push(统一函数入口架构)`);
|
|
86
|
+
}
|