dsh-git-push 0.0.0-stage → 2.8.6
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/.auditignore +30 -0
- package/.gitignore +39 -0
- package/LICENSE +21 -0
- package/README.md +1486 -2
- package/cli.mjs +360 -0
- package/cordis.patch.yml +14 -0
- package/lib/ARCHITECTURE.md +34 -0
- package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
- package/lib/app/apply.js +275 -0
- package/lib/app/audit-api.js +158 -0
- package/lib/app/command-registry.js +266 -0
- package/lib/app/constants.js +16 -0
- package/lib/app/handlers/account.js +166 -0
- package/lib/app/handlers/clone.js +168 -0
- package/lib/app/handlers/http-constants.js +9 -0
- package/lib/app/handlers/identity-rewrite.js +94 -0
- package/lib/app/handlers/meta.js +175 -0
- package/lib/app/handlers/npm.js +169 -0
- package/lib/app/handlers/repo-actions.js +143 -0
- package/lib/app/handlers/repos.js +231 -0
- package/lib/app/handlers/settings.js +62 -0
- package/lib/app/host-doc-checks.js +25 -0
- package/lib/app/http-handlers.js +131 -0
- package/lib/app/index.js +30 -0
- package/lib/app/inject-text.js +192 -0
- package/lib/app/scan-root.js +23 -0
- package/lib/app/schema.js +150 -0
- package/lib/app/settings-bridge.js +167 -0
- package/lib/app/slash-commands.js +395 -0
- package/lib/app/slot-stats.js +35 -0
- package/lib/app/tool-call.js +672 -0
- package/lib/app/tools.js +34 -0
- package/lib/ast/brace.js +105 -0
- package/lib/ast/callgraph.js +135 -0
- package/lib/ast/code-lines.js +114 -0
- package/lib/ast/consts.js +12 -0
- package/lib/ast/control-flow.js +461 -0
- package/lib/ast/credential.js +199 -0
- package/lib/ast/dataflow.js +274 -0
- package/lib/ast/dup-code.js +165 -0
- package/lib/ast/index.js +36 -0
- package/lib/ast/io-risk-const.js +95 -0
- package/lib/ast/io-risk-fn.js +208 -0
- package/lib/ast/io-risk-loop.js +308 -0
- package/lib/ast/io-risk.js +314 -0
- package/lib/ast/lang.js +156 -0
- package/lib/ast/line-count.js +52 -0
- package/lib/ast/magic-number.js +272 -0
- package/lib/ast/naming.js +284 -0
- package/lib/ast/perf.js +472 -0
- package/lib/ast/scope.js +241 -0
- package/lib/ast/shell.js +131 -0
- package/lib/ast/size.js +378 -0
- package/lib/ast/symbol-index.js +399 -0
- package/lib/ast/tokenizer.js +341 -0
- package/lib/audit/analysis-coverage.js +98 -0
- package/lib/audit/audit-file.js +182 -0
- package/lib/audit/checks.js +17 -0
- package/lib/audit/client-entry.js +93 -0
- package/lib/audit/collector.js +477 -0
- package/lib/audit/ext-runner.js +80 -0
- package/lib/audit/file-context.js +138 -0
- package/lib/audit/finding.js +50 -0
- package/lib/audit/gitignore-match.js +113 -0
- package/lib/audit/glob.js +63 -0
- package/lib/audit/history-report.js +100 -0
- package/lib/audit/history.js +126 -0
- package/lib/audit/ignore-blind.js +101 -0
- package/lib/audit/index.js +33 -0
- package/lib/audit/orchestrate.js +476 -0
- package/lib/audit/public.js +24 -0
- package/lib/audit/repo-level.js +30 -0
- package/lib/audit/report-yaml.js +86 -0
- package/lib/audit/slot.js +65 -0
- package/lib/audit-defaults.js +18 -0
- package/lib/audit-rules/audit-rules-comment.yml +247 -0
- package/lib/audit-rules/audit-rules-cpp.yml +22 -0
- package/lib/audit-rules/audit-rules-docs.yml +32 -0
- package/lib/audit-rules/audit-rules-dsh.yml +162 -0
- package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
- package/lib/audit-rules/audit-rules-folder.yml +99 -0
- package/lib/audit-rules/audit-rules-frontend.yml +335 -0
- package/lib/audit-rules/audit-rules-go.yml +22 -0
- package/lib/audit-rules/audit-rules-i18n.yml +45 -0
- package/lib/audit-rules/audit-rules-java.yml +105 -0
- package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
- package/lib/audit-rules/audit-rules-npm.yml +187 -0
- package/lib/audit-rules/audit-rules-paths.yml +92 -0
- package/lib/audit-rules/audit-rules-performance.yml +215 -0
- package/lib/audit-rules/audit-rules-php.yml +22 -0
- package/lib/audit-rules/audit-rules-private.yml +24 -0
- package/lib/audit-rules/audit-rules-python.yml +106 -0
- package/lib/audit-rules/audit-rules-robustness.yml +27 -0
- package/lib/audit-rules/audit-rules-rust.yml +22 -0
- package/lib/audit-rules/audit-rules-structure.yml +159 -0
- package/lib/audit-rules/audit-rules-swift.yml +22 -0
- package/lib/audit-rules/audit-rules-template.yml +108 -0
- package/lib/checks/button-bind.js +276 -0
- package/lib/checks/common.js +170 -0
- package/lib/checks/credential-file.js +43 -0
- package/lib/checks/dataflow.js +40 -0
- package/lib/checks/dispatch.js +112 -0
- package/lib/checks/dup-code.js +69 -0
- package/lib/checks/dup-const.js +232 -0
- package/lib/checks/file-health.js +150 -0
- package/lib/checks/filter.js +137 -0
- package/lib/checks/folder.js +173 -0
- package/lib/checks/hardcoded-path.js +98 -0
- package/lib/checks/index.js +46 -0
- package/lib/checks/io.js +66 -0
- package/lib/checks/magic-number.js +42 -0
- package/lib/checks/npm-json.js +273 -0
- package/lib/checks/private.js +63 -0
- package/lib/checks/regex.js +256 -0
- package/lib/checks/semantic.js +134 -0
- package/lib/checks/structural.js +274 -0
- package/lib/cli/commands-account.mjs +107 -0
- package/lib/cli/commands-audit.mjs +144 -0
- package/lib/cli/commands-doc.mjs +127 -0
- package/lib/cli/commands-vcs.mjs +175 -0
- package/lib/client/index.js +162 -0
- package/lib/client-parts/00-loader.js +33 -0
- package/lib/client-parts/01-const.js +207 -0
- package/lib/client-parts/02-utils.js +62 -0
- package/lib/client-parts/03-icons.js +12 -0
- package/lib/client-parts/10-account.js +83 -0
- package/lib/client-parts/11-browser.js +95 -0
- package/lib/client-parts/20-repo.js +374 -0
- package/lib/client-parts/21-audit.js +301 -0
- package/lib/client-parts/22-settings.js +146 -0
- package/lib/client-parts/23-npm.js +383 -0
- package/lib/client-parts/30-page.js +56 -0
- package/lib/client-parts/40-controller.js +1092 -0
- package/lib/client-parts/41-actions.js +279 -0
- package/lib/client-parts/99-apply.js +72 -0
- package/lib/client.js +3195 -0
- package/lib/commit-push.js +148 -0
- package/lib/context/index.js +363 -0
- package/lib/core/atomic-json.js +98 -0
- package/lib/core/config.js +40 -0
- package/lib/core/credentials.js +274 -0
- package/lib/core/endpoints.js +109 -0
- package/lib/core/exec.js +162 -0
- package/lib/exempt/index.js +292 -0
- package/lib/fs/edit-after-read.js +103 -0
- package/lib/fsx.js +87 -0
- package/lib/git/account-status.js +140 -0
- package/lib/git/account.js +233 -0
- package/lib/git/api.js +136 -0
- package/lib/git/atomic-json.js +6 -0
- package/lib/git/browse.js +38 -0
- package/lib/git/clone-download.js +397 -0
- package/lib/git/clone-history-mode.js +143 -0
- package/lib/git/clone-history.js +175 -0
- package/lib/git/clone-jobs.js +250 -0
- package/lib/git/clone-replay-io.js +172 -0
- package/lib/git/clone-replay.js +275 -0
- package/lib/git/clone.js +445 -0
- package/lib/git/cloud.js +46 -0
- package/lib/git/commit-message.js +141 -0
- package/lib/git/config.js +6 -0
- package/lib/git/cred-env.js +88 -0
- package/lib/git/credentials.js +6 -0
- package/lib/git/endpoints.js +6 -0
- package/lib/git/exec.js +6 -0
- package/lib/git/identity-rewrite.js +297 -0
- package/lib/git/identity.js +150 -0
- package/lib/git/ignore.js +69 -0
- package/lib/git/index.js +41 -0
- package/lib/git/module-splitter.js +47 -0
- package/lib/git/post-push.js +101 -0
- package/lib/git/push-diagnose.js +142 -0
- package/lib/git/push.js +476 -0
- package/lib/git/remote-resolve.js +146 -0
- package/lib/git/remote.js +128 -0
- package/lib/git/repo-index.js +512 -0
- package/lib/git/repos.js +235 -0
- package/lib/git/scan-runner.js +159 -0
- package/lib/git/sensitive.js +134 -0
- package/lib/git/transport.js +430 -0
- package/lib/git/visibility.js +35 -0
- package/lib/git/wrapped-git.js +68 -0
- package/lib/http/index.js +170 -0
- package/lib/index.js +24 -0
- package/lib/link-check/index.js +187 -0
- package/lib/npm/account.js +64 -0
- package/lib/npm/install.js +211 -0
- package/lib/npm/npmrc.js +56 -0
- package/lib/npm/publish.js +171 -0
- package/lib/npm/registry.js +168 -0
- package/lib/plugin/auto-detect.js +92 -0
- package/lib/plugin/auto-push.js +154 -0
- package/lib/plugin/index.js +250 -0
- package/lib/readme-templates/readme.yml +38 -0
- package/lib/rule/compilers/credential.js +62 -0
- package/lib/rule/compilers/dataflow.js +38 -0
- package/lib/rule/compilers/file-health.js +75 -0
- package/lib/rule/compilers/frontend.js +86 -0
- package/lib/rule/compilers/func.js +35 -0
- package/lib/rule/compilers/helpers.js +71 -0
- package/lib/rule/compilers/index.js +29 -0
- package/lib/rule/compilers/link-semantic.js +45 -0
- package/lib/rule/compilers/list-kinds.js +12 -0
- package/lib/rule/compilers/numeric-kinds.js +66 -0
- package/lib/rule/compilers/regex.js +78 -0
- package/lib/rule/compilers/structure.js +80 -0
- package/lib/rule/compilers.js +17 -0
- package/lib/rule/homoglyph.js +45 -0
- package/lib/rule/loader.js +270 -0
- package/lib/rule/registry.js +115 -0
- package/lib/rule/scope.js +67 -0
- package/lib/score/docs-score.js +166 -0
- package/lib/score/index.js +140 -0
- package/lib/self/index.js +196 -0
- package/lib/skip-dirs.js +64 -0
- package/lib/tool-probes.json +50 -0
- package/lib/user-requirements.json +14 -0
- package/lib/vendor/js-yaml/LICENSE +21 -0
- package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
- package/package.json +95 -4
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +34 -0
- package/scripts/audit-ext/variable-min-length.mjs +102 -0
- package/scripts/audit-runner.mjs +35 -0
- package/scripts/audit-runtime-check.mjs +129 -0
- package/scripts/browser-page-probe.mjs +271 -0
- package/scripts/build-client.mjs +119 -0
- package/scripts/check.mjs +88 -0
- package/scripts/clean-date-comments.py +102 -0
- package/scripts/cpu-sample.mjs +188 -0
- package/scripts/doc-drift.mjs +200 -0
- package/scripts/doc-func.mjs +212 -0
- package/scripts/doc-tree.mjs +456 -0
- package/scripts/doc-version.mjs +220 -0
- package/scripts/frontend-preview-check.mjs +124 -0
- package/scripts/hot-path-probe-cjs.cjs +71 -0
- package/scripts/hot-path-probe-fs-shim.mjs +28 -0
- package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
- package/scripts/hot-path-probe.mjs +153 -0
- package/scripts/module-splitter.py +800 -0
- package/scripts/platform-scan.mjs +168 -0
- package/scripts/preview-gen.mjs +489 -0
- package/scripts/preview-local-runner.mjs +55 -0
- package/scripts/preview-server-direct.mjs +116 -0
- package/scripts/preview-server.mjs +305 -0
- package/scripts/preview-slot-data.mjs +123 -0
- package/scripts/probe-recheck.mjs +47 -0
- package/scripts/readme-gen.mjs +268 -0
- package/scripts/rename-locator.mjs +97 -0
- package/scripts/rule-switch.mjs +97 -0
- package/scripts/rules-solo-audit.mjs +173 -0
- package/scripts/scan-file-io.mjs +713 -0
- package/scripts/scan-hardcoded-paths.mjs +125 -0
- package/scripts/scan-repos.mjs +167 -0
- package/scripts/scan-version.mjs +122 -0
- package/scripts/scrub-user-wording.mjs +420 -0
- package/scripts/symbol-index.mjs +85 -0
- package/scripts/sync-plugin-install.mjs +223 -0
- package/scripts/sync-plugin.mjs +279 -0
- package/scripts/verify-prestep.mjs +100 -0
- package/skills/dev/audit-rule-authoring.md +58 -0
- package/skills/dev/dsh-git-push.md +323 -0
- package/skills/dev/git-push-live-fix.md +45 -0
- package/skills/dsh-repo-index.md +35 -0
- package/skills/guide/guide-audit.md +167 -0
- package/skills/guide/guide-cli-scripts.md +104 -0
- package/skills/guide/guide-clone-repos.md +173 -0
- package/skills/guide/guide-commit-push.md +156 -0
- package/skills/guide/guide-inject-ui.md +166 -0
- package/skills/guide/guide-slash-completion.md +118 -0
- package/skills/workflow/README.md +21 -0
- package/skills/workflow/git-commit-discipline.md +68 -0
- package/skills/workflow/git-project-startup.md +85 -0
- package/skills/workflow/git-rebuild-process.md +57 -0
- package/skills/workflow/github-operations.md +91 -0
- package/skills/workflow/readme-sync-git-md.md +28 -0
- package/skills/workflow/task-completion-report.md +73 -0
- package/skills/workflow/tool-json-add-ask.md +35 -0
- package/skills/workflow/versioning-rule.md +211 -0
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dsh-git-push 自身总入口
|
|
3
|
+
* dsh-skip-i18n: 插件为中文零依赖 CLI(无 i18n 框架需求),用户可见文案硬编码为产品设计
|
|
4
|
+
*
|
|
5
|
+
* 版本控制(单一事实源)/ README 模板(独立,不走拦截 yml)/ yml 模板 / 独立运行能力(CLI)。
|
|
6
|
+
* 版本一致性:VERSION(本文件)≡ package.json version ≡ cli.mjs HELP 的 v${VERSION},
|
|
7
|
+
* 由 scripts/scan-version.mjs 机器校验(0.1.4)。
|
|
8
|
+
* CLI 一致性:HELP 文本与 parseArgv 白名单机器比对(cli-help-sync),防 --depth 类回归。
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
export const VERSION = '2.8.6'; // 2.8.5:修 runNpm 不传 cwd —— npm pack/publish 会跑在**宿主进程的 cwd**(本机是 DSH 安装目录 /volume1/@appstore/DeepSeekHarness-NAS)而不是目标包目录。
|
|
13
|
+
// 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
|
|
14
|
+
// 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
|
|
15
|
+
// 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
|
|
16
|
+
// 不再判「推送未落地」,改为如实标「推送已完成但未核验」(只有 404 才算远端真的没有该分支)。
|
|
17
|
+
// 2.6.2:克隆「已存在且不完整」时可续传/重来——预览端点回报 partial(有进行中标记且无有效提交),
|
|
18
|
+
// 前端预览框在不完整时给出「重来」(只清 .dsh-parts 分片、不动已下文件与用户内容);忙碌键前缀(clone:/vis:/push:)统一到单一出处。
|
|
19
|
+
// 2.6.1:git_clone 新增 history 参数(真实历史)——用 git fetch --depth 取回原始对象,
|
|
20
|
+
// 克隆结果与远端 HEAD 逐字节一致(可推回远端、可 git log 读演进);默认关,仍走整树快照快路径(行为不变)。
|
|
21
|
+
// 2.6.0:新增热路径探针 scripts/hot-path-probe.mjs(ESM/CJS 双格式自动判断;
|
|
22
|
+
// 统计指定函数的耗时 + 调用次数,并统计 fs 调用次数,用于区分「CPU 重复计算」与「I/O 等待」)。
|
|
23
|
+
// 2.5.7:审计评分保留**三位小数**(lib/score/index.js 的 decimalPlaces 10 → 1000),
|
|
24
|
+
// 便于对照「改一处代码后分数动了多少」;level 档位用同一分值判定。
|
|
25
|
+
// 2.5.5:审计新增「分析覆盖率」**信息项**(lib/audit/analysis-coverage.js)——
|
|
26
|
+
// 覆盖率 = 连边 / 可解析调用(成员调用排除并单独计数)、未解析按原因与按文件归类;
|
|
27
|
+
// **不参与评分**(同一仓库开/关该信息项,summary 与 quality 逐字节一致,有回归测试);
|
|
28
|
+
// 只有完整文件集才可信(diff 范围返回 skipped),args.coverage:false 可整体关闭
|
|
29
|
+
// 2.5.4:新增跨文件符号索引(lib/ast/symbol-index.js + scripts/symbol-index.mjs)——
|
|
30
|
+
// 稳定符号 ID(路径+符号,不含行号)、import 解析到工程内文件(含 TS 的 `./x.js`→`x.ts` 回退)、
|
|
31
|
+
// 跨文件调用三级落地(本地→导入→全工程唯一,歧义不连边)、未使用导出候选、分析覆盖率指标
|
|
32
|
+
// 2.5.3:修「假成功」——后台 job 原先无论结果都返回 completed/'commit+push done',
|
|
33
|
+
// 把 push.js 的 verified 防线盖住了(推送失败/门禁拦截/远端 sha 不一致/无变更 全显示成「完成」)。
|
|
34
|
+
// 现在 job 状态由 pushJobOutcome / cloneJobOutcome 如实映射(失败报失败、未推送写明未推送、核验不一致报 failed)
|
|
35
|
+
// 2.5.2:新增 git_identity_rewrite 工具/CLI(提交身份历史改写:默认 dry-run,
|
|
36
|
+
// 先建备份引用、自检「提交数/工作树/身份全规范」通过才改写,push 用 force-with-lease 且只在远端 sha
|
|
37
|
+
// 等于改写前本地 sha 时执行;只处理 origin 属于登录账号的仓库),并在提交返回里带 legacyIdentity
|
|
38
|
+
// 提醒「该仓库历史还有多少条非规范身份」——只提醒不擅自改历史
|
|
39
|
+
// 2.5.1:提交身份自动用登录账号(仓库已配→尊重;未配→账号身份并写入仓库局部配置;
|
|
40
|
+
// 账号不可用→兜底 DSH Agent 且不落盘),并把身份暴露给 AI(工具返回 identity + 状态端点 commitIdentity +
|
|
41
|
+
// 提示词注入一行),修掉「AI 不知道该用什么身份、只能自己编」的问题
|
|
42
|
+
// 2.5.0 起:架构图生成器按 archify 作者契约重做——抽象层级自适应(细粒度/归并双档)、
|
|
43
|
+
// 网格 row/col 放置(不再手算坐标)、质量档 quality_profile=showcase;版本兼容性同 2.4.x(client 不依赖 settingsScope,特性检测 0.1.6 真 scope / 0.2.0 fallback)
|
|
44
|
+
// 2.4.2:契约与文档加固(不新增功能)——工具公开面契约门禁(含 4 个反向用例验证)、
|
|
45
|
+
// 版本化回归测试(regression-2.4.1.mjs)与工具层端到端测法(test-tools-e2e.mjs)、
|
|
46
|
+
// 版本表量化对比(version-metrics.json)、SECURITY.md + CONTRIBUTING.md、docs/SPEC.md 规格唯一入口、
|
|
47
|
+
// docs/ 重组(设计稿转写为 4 篇功能介绍、11 份开发者文档移入技能仓库归档)、
|
|
48
|
+
// 复杂度长尾:≥20 高风险函数由 20 降到 15(findConstDefs 32 / downloadBlobs 29 / applySettingsToCfg 26 /
|
|
49
|
+
// scanSensitiveFiles 25 / codeCommentRanges 30→12 / stripLiterals 25→12 逐个收口)
|
|
50
|
+
// 2.4.1:纯优化(不新增功能)——误报修复(多行模板跨行 tokenize、duplicate-constant 三类误报豁免)、
|
|
51
|
+
// 审计默认值/常量收口到公共模块(lib/audit-defaults.js、lib/ast/consts.js)、
|
|
52
|
+
// module-splitter 既存 blocker 清理、豁免提示与实际行为一致性修复、4 个高复杂度函数拆分(28/22/21/15 全部达标)
|
|
53
|
+
// 2.4.0:clone 链路三修——① git_clone 工具补传 token(此前漏传走匿名 API,私有库失败/公开库吃 60次/h 限流)
|
|
54
|
+
// + 统一体积上限 ② 工作树内防护前移到联网之前(此前被 HTTP 403 抢先返回,防护形同虚设)
|
|
55
|
+
// ③ 「占用中」互斥判定前移到预览之前并改用全局 snapshot(此前换目录即可绕过互斥)
|
|
56
|
+
// 1.11.4:侧边栏设置页反代空白修复(绕开 isLoopback=memory 陷阱:available/writable 与 scope 快照解耦恒可用恒可写)+ git_sluice 工具化(浅包装 git 透传注册为 AI 直接调用工具,凭据自动注入,返回 status+stdout/stderr)+ 软链安装依赖解析回归测试
|
|
57
|
+
// 1.11.3:新增审计规则 comment/no-date-in-comment——注释禁止写日期(日期属 git commit,注释只解释为什么);@since/@deprecated/@version/@date 白名单豁免
|
|
58
|
+
// 1.11.1:审计误报批量修复(KToolBox/Pawchive 实测驱动)——tokenizer 支持 Python 三引号/`#` 行注释;magic-number 枚举/参数默认/HTTP 状态码/datetime/Field 豁免;repeated i18n/配置键 snake_case 豁免;混淆构建产物自动豁免(单行 >5000 字符);评审①②③④:comment-density 注释密度检测 + 序列化函数长度豁免
|
|
59
|
+
// 1.11.0:审计新增重复代码检测规则(maintainability/no-duplicate-code,激活原死规则)——跨文件 AST 归一化哈希找「同一函数结构 ≥3 处 + ≥5 行」提示抽公共函数;排除参数>5/布尔 flag/test 夹具/纯语法糖;severity 恒 warning
|
|
60
|
+
// 1.10.5:拆分 http-handlers.js 巨型 switch(923→122 行)到 lib/app/handlers/(meta/repos/repo-actions/clone/account/settings 6 模块),file-health L3 清零
|
|
61
|
+
// 1.10.4:工具探测补 node 兜底(execPath)+ 新增 /api/git-push/tool-probes 探测 API + 短变量改名(history/context/button-bind)
|
|
62
|
+
// 1.10.3:魔数规则再修 3 类误报(对象字面量常量定义/rgba 色值/CLI console.log(JSON.stringify) 输出豁免)
|
|
63
|
+
// 1.10.2:审计误报专项优化(重复规则去重/exs 文档豁免/vague 词表剔 res/循环变量豁免)
|
|
64
|
+
// 1.10.1:audit-api 变量命名清理(result→auditResult)+ sync-plugin fileContentEqual 异步化(existsSync→access)
|
|
65
|
+
// 1.10.0:审计结果 API 化 + 自定义聚合(/api/git-push/audit,groupBy=rule/file/severity/slot)+ sync-plugin 补同步 .auditignore
|
|
66
|
+
// 1.9.5:全量审计低风险优化(重复硬编码常量/短变量改名/魔数常量/真高风险 I/O 异步化)
|
|
67
|
+
// 1.9.4:自动推送范围下拉渲染修复(jsx 第三参数是 key 不是 children)
|
|
68
|
+
// 1.9.2:移除伪 peerDependencies(dsh-tools/schemastery 宿主条件提供)——修复市场软链安装误报缺依赖
|
|
69
|
+
// 1.9.1:系统提示词注入配置化(config.json injectUsageText 覆盖)+ 浅包装 git 用法入注入文本
|
|
70
|
+
// 1.9.0:浅包装 git(未知命令透传 + git 子命令 + 自动凭据)——major/minor 另行指定
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* README 模板渲染({{name}} {{description}} {{version}} {{versionTable}} 占位符)。
|
|
74
|
+
* 独立于规则 yml(README 生成不是规则拦截,故不走 audit-rules 槽位)。
|
|
75
|
+
* @returns {{ok: true, template: string, version: string}}
|
|
76
|
+
*/
|
|
77
|
+
export function readmeTemplate({ name = 'dsh-git-push', description = 'DSH git 自动提交推送插件——统一函数入口架构', version = VERSION, versionTable = '' } = {}) {
|
|
78
|
+
const table = versionTable || [
|
|
79
|
+
`| 版本 | 说明 |`,
|
|
80
|
+
`|---|---|`,
|
|
81
|
+
`| **${version}**(当前) | 当前版本:见 [WORKBOARD](docs/WORKBOARD-v2.md) 执行记录与 git log |`,
|
|
82
|
+
].join('\n');
|
|
83
|
+
const template = [
|
|
84
|
+
`# ${name}`,
|
|
85
|
+
``,
|
|
86
|
+
`${description}。`,
|
|
87
|
+
``,
|
|
88
|
+
`> **状态**:开发中(当前 v${version})`,
|
|
89
|
+
`> **CI**:\`npm test\` 一条命令全绿;\`npm run check\` 全量语法检查`,
|
|
90
|
+
``,
|
|
91
|
+
`## 目录`,
|
|
92
|
+
``,
|
|
93
|
+
`- [架构设计](#架构设计)`,
|
|
94
|
+
`- [总入口清单](#总入口清单)`,
|
|
95
|
+
`- [统一问题对象](#统一问题对象)`,
|
|
96
|
+
`- [版本列表](#版本列表)`,
|
|
97
|
+
`- [注意事项](#注意事项)`,
|
|
98
|
+
``,
|
|
99
|
+
`## 架构设计`,
|
|
100
|
+
``,
|
|
101
|
+
`**核心思想:统一函数入口 + 注册表扩展,加能力不破坏主入口。**`,
|
|
102
|
+
``,
|
|
103
|
+
`- **规则总入口**(\`lib/rule/\`):yml 规则槽位统一装载→解析→编译;加字段=加函数+注册一行,\`compileRule\` 主体永不修改`,
|
|
104
|
+
`- **审计总入口**(\`lib/audit/\`):\`auditChanged\`(git 变动,git status --porcelain)/ \`auditFull\`(全量,非 git 目录可查)`,
|
|
105
|
+
`- **git 总入口**(\`lib/git/\`):token / 提交 / 推送(api.github.com Git Data API,401 回退 SSH)/ clone / 建仓 / 可见性`,
|
|
106
|
+
`- **自身总入口**(\`lib/self/\`):版本单一事实源 / README 模板 / yml 模板 / CLI`,
|
|
107
|
+
`- **评分总入口**(\`lib/score/\`):10 维度加权(可读/可维护/健壮/安全/性能/测试/可观测/部署/文档/DX)`,
|
|
108
|
+
`- **豁免总入口**(\`lib/exempt/\`):\`dsh-skip-*\` 注册表 + exemptHint`,
|
|
109
|
+
`- **上下文注入**(\`lib/context/\`):给 AI 会话注入环境`,
|
|
110
|
+
``,
|
|
111
|
+
`## 总入口清单`,
|
|
112
|
+
``,
|
|
113
|
+
`| # | 入口 | 职责 |`,
|
|
114
|
+
`|---|------|------|`,
|
|
115
|
+
`| 1 | 规则总入口 | yml 字段解析 + 字段驱动编译函数指派 |`,
|
|
116
|
+
`| 2 | 审计总入口 | 变动/全量/非 git 目录扫描 |`,
|
|
117
|
+
`| 3 | git 总入口 | token/提交/推送/clone/建仓/可见性 |`,
|
|
118
|
+
`| 4 | 自身总入口 | 版本/README 模板/yml 模板/CLI |`,
|
|
119
|
+
`| 5 | 评分总入口 | 10 维度加权评分 |`,
|
|
120
|
+
`| 6 | 豁免总入口 | dsh-skip-* 注册表 + exemptHint |`,
|
|
121
|
+
`| 7 | 上下文注入 | AI 会话环境注入 |`,
|
|
122
|
+
`| 8 | 测试总入口 | npm test 可复现 |`,
|
|
123
|
+
``,
|
|
124
|
+
`## 统一问题对象`,
|
|
125
|
+
``,
|
|
126
|
+
'```',
|
|
127
|
+
`问题 = { file, line, rule, kind, severity, message, dimensions[], exemptHint, scoreImpact }`,
|
|
128
|
+
'```',
|
|
129
|
+
``,
|
|
130
|
+
`## 版本列表`,
|
|
131
|
+
``,
|
|
132
|
+
table,
|
|
133
|
+
``,
|
|
134
|
+
`## 注意事项`,
|
|
135
|
+
``,
|
|
136
|
+
`- **开发中不推送、不发布**;每次提交前用 \`../dsh-git-push\`(存档版)扫描本目录自检`,
|
|
137
|
+
`- **规则加载器铁律**:加字段 = 加函数 + 注册一行,\`compileRule\` 主体永不修改`,
|
|
138
|
+
`- **命名格式统一**:一个功能一个根词,各层只做格式转换,对外 API 与函数名完全一致`,
|
|
139
|
+
``,
|
|
140
|
+
].join('\n');
|
|
141
|
+
return { ok: true, template, version };
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** yml 规则模板(新规则示范:显式 kind + dimensions 绑定)。 */
|
|
145
|
+
export function yamlTemplate() {
|
|
146
|
+
return [
|
|
147
|
+
`# 规则模板示范`,
|
|
148
|
+
`- id: category/rule-name`,
|
|
149
|
+
` kind: regex # 可省略:按字段自动指派`,
|
|
150
|
+
` name: "规则显示名称"`,
|
|
151
|
+
` category: "readability"`,
|
|
152
|
+
` severity: "warning" # error→blocker / warning→提醒 / info→pass`,
|
|
153
|
+
` pattern: "..."`,
|
|
154
|
+
` dimensions: ["可读性", "可维护性"] # 10 维度绑定,支持一字段多维度`,
|
|
155
|
+
``,
|
|
156
|
+
].join('\n');
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** 独立运行能力:CLI 版本自检(cli.mjs 调用)。 */
|
|
160
|
+
export function selfVersion() {
|
|
161
|
+
return VERSION;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/**
|
|
165
|
+
* 版本一致性校验(scan-version.mjs 调用):本文件 VERSION ≡ package.json version。
|
|
166
|
+
* @param {string|object} pkgJson package.json 的 JSON 文本或含 version 的对象
|
|
167
|
+
* @returns {{ok: boolean, selfVersion: string, pkgVersion: string, error?: string}}
|
|
168
|
+
*/
|
|
169
|
+
export function versionInfo(pkgJson = '') {
|
|
170
|
+
let pkgVersion = '';
|
|
171
|
+
if (typeof pkgJson === 'object' && pkgJson !== null) {
|
|
172
|
+
pkgVersion = String(pkgJson.version || '');
|
|
173
|
+
} else {
|
|
174
|
+
try { pkgVersion = String(JSON.parse(String(pkgJson || '{}')).version || ''); } catch { /* 解析失败按空 */ }
|
|
175
|
+
}
|
|
176
|
+
if (!pkgVersion) return { ok: false, selfVersion: VERSION, pkgVersion: '', error: 'package.json 无 version 字段' };
|
|
177
|
+
if (pkgVersion !== VERSION) {
|
|
178
|
+
return { ok: false, selfVersion: VERSION, pkgVersion, error: `版本不一致:lib/self=${VERSION} vs package.json=${pkgVersion}` };
|
|
179
|
+
}
|
|
180
|
+
return { ok: true, selfVersion: VERSION, pkgVersion };
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* CLI HELP 与 parseArgv 白名单机器比对(cli-help-sync)。
|
|
185
|
+
* 从 HELP 文本提取 --xxx 选项,对照 parseArgv 认识的选项集合,两边不一致即报。
|
|
186
|
+
* @param {string} helpText CLI HELP 全文
|
|
187
|
+
* @param {string[]} knownFlags parseArgv 认识的选项名(含 -- 前缀,如 ['--depth','--full'])
|
|
188
|
+
* @returns {{ok: boolean, missingInHelp: string[], missingInParse: string[], helpFlags: string[]}}
|
|
189
|
+
*/
|
|
190
|
+
export function helpSync(helpText = '', knownFlags = []) {
|
|
191
|
+
const helpFlags = [...new Set([...(String(helpText).match(/--[\w-]+/g) || [])])].sort();
|
|
192
|
+
const known = [...new Set(knownFlags.map((f) => (String(f).startsWith('--') ? String(f) : `--${f}`)))].sort();
|
|
193
|
+
const missingInHelp = known.filter((f) => !helpFlags.includes(f)); // parseArgv 认但 HELP 没写
|
|
194
|
+
const missingInParse = helpFlags.filter((f) => !known.includes(f)); // HELP 写了但 parseArgv 不认
|
|
195
|
+
return { ok: missingInHelp.length === 0 && missingInParse.length === 0, missingInHelp, missingInParse, helpFlags };
|
|
196
|
+
}
|
package/lib/skip-dirs.js
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 统一「无条件跳过目录」名单(收敛)。
|
|
3
|
+
*
|
|
4
|
+
* 组成 = 硬编码基线 + yml 黑名单关键词:
|
|
5
|
+
* - 硬编码基线:**只允许 node_modules 和 .git 两个**——禁止在本文件追加目录名
|
|
6
|
+
* (dist/build/vendor/coverage/.dsh/.trash/.npm/.pnpm-store/.tmp-build 等一律不许写死在代码里)。
|
|
7
|
+
* - yml 黑名单关键词:从审计规则 yml 的 `exclude_dirs` 字段加载(各规则的黑名单目录并集,
|
|
8
|
+
* 如 folder 规则的 dist/build/vendor/.dsh/.trash 等)。要新增跳过目录 → 改 yml,不改代码。
|
|
9
|
+
*
|
|
10
|
+
* 白名单(gitignore negation)不受影响:collector walk 对「被忽略目录」按前缀跳过,
|
|
11
|
+
* 但 gitignore 白名单恢复的目录仍会进入(黑名单初筛 + 白名单补充)。
|
|
12
|
+
*
|
|
13
|
+
* 消费方:lib/audit/collector.js(审计文件收集)、lib/git/sensitive.js(敏感扫描)、
|
|
14
|
+
* scripts/scrub-user-wording.mjs(沟通措辞清洗)。
|
|
15
|
+
*/
|
|
16
|
+
import { existsSync, readFileSync, readdirSync } from 'node:fs';
|
|
17
|
+
import { join, dirname } from 'node:path';
|
|
18
|
+
import { fileURLToPath } from 'node:url';
|
|
19
|
+
import { load as yamlLoad } from './vendor/js-yaml/js-yaml.mjs';
|
|
20
|
+
|
|
21
|
+
/** 硬编码基线:只许这两个(勿改)。 */
|
|
22
|
+
export const SKIP_DIRS = new Set(['node_modules', '.git']);
|
|
23
|
+
|
|
24
|
+
/** 规则 yml 目录(audit-rules-*.yml,与本模块同级的 audit-rules/)。 */
|
|
25
|
+
export function auditRulesDir() {
|
|
26
|
+
return join(dirname(fileURLToPath(import.meta.url)), 'audit-rules');
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
let ymlBlacklistCache = null;
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 从规则 yml 的 exclude_dirs 字段收集黑名单目录关键词(跨 yml 并集)。
|
|
33
|
+
* 加载失败返回空集(不因规则文件损坏阻塞扫描)。
|
|
34
|
+
*/
|
|
35
|
+
export function loadYamlBlacklistDirs() {
|
|
36
|
+
if (ymlBlacklistCache) return ymlBlacklistCache;
|
|
37
|
+
const out = new Set();
|
|
38
|
+
const dir = auditRulesDir();
|
|
39
|
+
try {
|
|
40
|
+
for (const f of readdirSync(dir)) {
|
|
41
|
+
if (!f.endsWith('.yml')) continue;
|
|
42
|
+
let doc;
|
|
43
|
+
try { doc = yamlLoad(readFileSync(join(dir, f), 'utf8')); } catch { continue; }
|
|
44
|
+
const rules = doc && Array.isArray(doc.rules) ? doc.rules : [];
|
|
45
|
+
for (const r of rules) {
|
|
46
|
+
if (Array.isArray(r && r.exclude_dirs)) {
|
|
47
|
+
for (const n of r.exclude_dirs) if (typeof n === 'string' && n.trim()) out.add(n.trim());
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
} catch { /* 目录缺失/不可读:返回空集 */ }
|
|
52
|
+
ymlBlacklistCache = out;
|
|
53
|
+
return out;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* 最终跳过目录集合 = 硬编码基线 ∪ yml 黑名单关键词。
|
|
58
|
+
* 消费方在遍历剪枝时对目录名命中此集合即整棵跳过。
|
|
59
|
+
*/
|
|
60
|
+
export function getSkipSet() {
|
|
61
|
+
const set = new Set(SKIP_DIRS);
|
|
62
|
+
for (const n of loadYamlBlacklistDirs()) set.add(n);
|
|
63
|
+
return set;
|
|
64
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"git": "",
|
|
3
|
+
"node": "",
|
|
4
|
+
"npm": "",
|
|
5
|
+
"python3": "",
|
|
6
|
+
"curl": "",
|
|
7
|
+
"ssh": "",
|
|
8
|
+
"unzip": "",
|
|
9
|
+
"rsync": "",
|
|
10
|
+
"7z": "",
|
|
11
|
+
"tar": "",
|
|
12
|
+
"gzip": "",
|
|
13
|
+
"bzip2": "",
|
|
14
|
+
"xz": "",
|
|
15
|
+
"zstd": "",
|
|
16
|
+
"lz4": "",
|
|
17
|
+
"zip": "",
|
|
18
|
+
"rar": "",
|
|
19
|
+
"unrar": "",
|
|
20
|
+
"synopkg": "",
|
|
21
|
+
"synouser": "",
|
|
22
|
+
"synogroup": "",
|
|
23
|
+
"synoshare": "",
|
|
24
|
+
"synoacltool": "",
|
|
25
|
+
"smartctl": "",
|
|
26
|
+
"mdadm": "",
|
|
27
|
+
"btrfs": "",
|
|
28
|
+
"lvm": "",
|
|
29
|
+
"fnpack": "",
|
|
30
|
+
"appcenter-cli": "",
|
|
31
|
+
"docker": "",
|
|
32
|
+
"ffmpeg": "",
|
|
33
|
+
"pnpm": "",
|
|
34
|
+
"bash": "",
|
|
35
|
+
"wget": "",
|
|
36
|
+
"jq": "",
|
|
37
|
+
"yq": "",
|
|
38
|
+
"rg": "",
|
|
39
|
+
"fd": "",
|
|
40
|
+
"scp": "",
|
|
41
|
+
"tmux": "",
|
|
42
|
+
"screen": "",
|
|
43
|
+
"gcc": "",
|
|
44
|
+
"g++": "",
|
|
45
|
+
"make": "",
|
|
46
|
+
"pkg-config": "",
|
|
47
|
+
"chromium": "",
|
|
48
|
+
"playwright": "",
|
|
49
|
+
"puppeteer": ""
|
|
50
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"user": "默认开发者",
|
|
3
|
+
"description": "默认开发者特殊要求(AI 调用 git_commit_push / git_remote_create 前必须逐条核对达标,全部达标才执行)",
|
|
4
|
+
"items": [
|
|
5
|
+
"提交信息写清做了什么:commit message 必须描述本次实际变更内容(做了什么),禁止空泛词(如 update、fix、改了点东西);格式建议 feat:/fix:/docs:/chore: 前缀 + 具体说明,先在会话和用户讨论经过用户确认",
|
|
6
|
+
"单文件代码非必要不要超过 400 行,否则需要按功能拆分",
|
|
7
|
+
"大文件/产物不入库:node_modules、lock 文件、构建产物、下载的图片/视频等若无引用不入库;如已入库需先清理(.gitignore + 必要时 git rm --cached),tools/tool 文件夹的二进制文件可以豁免,bin 文件夹新增文件第一次提交提醒用户确认是否需要提交",
|
|
8
|
+
"敏感信息不入库:token/密钥/密码/凭据文件不入公开仓库;如涉及需先移出或豁免确认",
|
|
9
|
+
"删除需可恢复:删除文件/目录前先确认有 git 历史或备份(禁 rm -rf 无痕删除),大删除先 commit 检查点",
|
|
10
|
+
"文档对话类措辞:公开仓库文档只写做了什么,不含会话引用/决策来源/AI 许可表述/商量转述等沟通措辞(见 release-docs-rule)",
|
|
11
|
+
"dryRun 先行:批量/破坏性操作(重建历史、删除、迁移)先 dryRun 预演,确认无误再执行",
|
|
12
|
+
"版本号同步:功能变更时同步更新 package.json version 与 README 版本记录表"
|
|
13
|
+
]
|
|
14
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
(The MIT License)
|
|
2
|
+
|
|
3
|
+
Copyright (C) 2011-2015 by Vitaly Puzrin
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
|
13
|
+
all copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
21
|
+
THE SOFTWARE.
|