dsh-git-push 0.0.0-stage → 2.8.4
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 +1482 -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 +262 -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 +191 -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 +662 -0
- package/lib/app/tools.js +40 -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 +207 -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 +131 -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 +144 -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 +470 -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 +167 -0
- package/lib/npm/registry.js +147 -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 +193 -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/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,456 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dsh-git-push — README 目录结构维护脚本(索引自动同步化)
|
|
3
|
+
*
|
|
4
|
+
* 功能(四个子命令):
|
|
5
|
+
* gen —— 用 `git ls-files` 读「所有 git 未忽略文件」,生成目录结构文本
|
|
6
|
+
* (两层折叠:顶层目录全列、子目录只到一层、嵌套用 … 折叠),
|
|
7
|
+
* 每项从 tree-doc.json 取一句话介绍;映射缺失的路径标(待注释)。
|
|
8
|
+
* check —— 解析 README 标记块(<!-- dshgp-tree:start/end -->)内现有树,
|
|
9
|
+
* 与真实文件树对比,报告漂移(新增/删除/改注释),**不改文件**。
|
|
10
|
+
* apply —— 用新生成的树覆盖 README 标记块内容(显式执行才写盘)。
|
|
11
|
+
* sync —— **索引自动同步**:对齐 tree-doc.json 的键集合与真实
|
|
12
|
+
* 文件集——新增文件自动补键(描述=(待注释),等人/AI 补一句介绍);
|
|
13
|
+
* 删除文件自动删键(描述连带删除)。不再需要手动增删键,只补描述。
|
|
14
|
+
*
|
|
15
|
+
* 注释映射:<项目根>/tree-doc.json —— { "路径": "一句话介绍", ... }
|
|
16
|
+
* 键集合(哪些文件被索引)= 脚本自动维护(sync/gen --write);
|
|
17
|
+
* 值(一句话介绍)= 人/AI 手动补:新增文件键值为(待注释),补描述后 git 提交。
|
|
18
|
+
*
|
|
19
|
+
* 用法:
|
|
20
|
+
* node scripts/tree-doc.mjs sync # 索引自动同步(增删键),打印变更统计
|
|
21
|
+
* node scripts/tree-doc.mjs gen # 生成树文本(stdout)
|
|
22
|
+
* node scripts/tree-doc.mjs gen --write # 索引同步 + 补(待注释)后写 tree-doc.json
|
|
23
|
+
* node scripts/tree-doc.mjs gen --all --write # 强制全量追加(等价 sync,显式语义)
|
|
24
|
+
* node scripts/tree-doc.mjs check [--readme README.md] # 检查漂移
|
|
25
|
+
* node scripts/tree-doc.mjs apply [--readme README.md] # 覆盖 README 标记块
|
|
26
|
+
*/
|
|
27
|
+
import { execFileSync } from 'node:child_process';
|
|
28
|
+
import { readFileSync, writeFileSync, existsSync, statSync, readdirSync } from 'node:fs';
|
|
29
|
+
import { join, dirname, resolve, basename } from 'node:path';
|
|
30
|
+
import { fileURLToPath } from 'node:url';
|
|
31
|
+
|
|
32
|
+
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
|
|
33
|
+
const MAPPING_FILE = join(ROOT, 'tree-doc.json');
|
|
34
|
+
const MARK_START = '<!-- dshgp-tree:start -->';
|
|
35
|
+
const MARK_END = '<!-- dshgp-tree:end -->';
|
|
36
|
+
const DEFAULT_README = join(ROOT, 'README.md');
|
|
37
|
+
/** 树标记块(宿主 md 识别用)。 */
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 自动探测「目录树宿主 md」(分体式文档支持):
|
|
41
|
+
* · `--readme` 显式指定 → 直接用(向后兼容)。
|
|
42
|
+
* · 缺省:优先 README.md;README 无标记块时,扫描根下全部 .md
|
|
43
|
+
* (docs/ 优先),找第一个含 dshgp-tree 标记块的文件作为宿主——
|
|
44
|
+
* 即「版本/文件树/函数列表等文档放 docs/、README 只引用」格局下,
|
|
45
|
+
* tree-doc 自动写到 docs/ 里真正承载树的那个 md,不再死认 README.md。
|
|
46
|
+
* · 都无标记块 → 回退 README.md(apply 仍会报「无标记块」提示先插标记)。
|
|
47
|
+
* @param {string} root 项目根
|
|
48
|
+
* @param {string} [explicit] --readme 显式路径(空=自动探测)
|
|
49
|
+
* @returns {string} 宿主 md 绝对路径
|
|
50
|
+
*/
|
|
51
|
+
/** 收集根下全部 .md(排除 .git/node_modules/.dsh 等),含 docs/ 子目录,深度 ≤4。 */
|
|
52
|
+
function collectMdFiles(root) {
|
|
53
|
+
const SKIP_DIRS = new Set(['.git', '.dsh', 'node_modules', 'dist', 'build', '.trash']);
|
|
54
|
+
const out = [];
|
|
55
|
+
const walk = (dir, depth) => {
|
|
56
|
+
if (depth > 4) return;
|
|
57
|
+
let entries = [];
|
|
58
|
+
try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
|
|
59
|
+
for (const e of entries) {
|
|
60
|
+
if (e.isDirectory() && SKIP_DIRS.has(e.name)) continue;
|
|
61
|
+
const full = join(dir, e.name);
|
|
62
|
+
if (e.isDirectory()) walk(full, depth + 1);
|
|
63
|
+
else if (e.name.endsWith('.md')) out.push(full);
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
walk(root, 0);
|
|
67
|
+
return out;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* 探测含指定标记块的「文档宿主 md」(公共函数,tree-doc/版本表/函数列表三类文档复用)。
|
|
72
|
+
* 优先 README.md;README 无该标记块时,扫描根下全部 .md 找第一个含该标记块的文件。
|
|
73
|
+
* 标记块形如 `<!-- <marker>:start --> … <!-- <marker>:end -->`(marker 如 'dshgp-tree')。
|
|
74
|
+
* @param {string} root 项目根
|
|
75
|
+
* @param {string} marker 标记块名(缺省 dshgp-tree)
|
|
76
|
+
* @returns {string} 宿主 md 绝对路径(找不到含块 md 时回退 README.md)
|
|
77
|
+
*/
|
|
78
|
+
export function findMarkedHostMd(root, marker = 'dshgp-tree') {
|
|
79
|
+
const readme = join(root, 'README.md');
|
|
80
|
+
try {
|
|
81
|
+
if (existsSync(readme) && findBlock(readFileSync(readme, 'utf8'), marker)) return readme;
|
|
82
|
+
} catch { /* 不可读则继续探测 */ }
|
|
83
|
+
for (const f of collectMdFiles(root)) {
|
|
84
|
+
try { if (findBlock(readFileSync(f, 'utf8'), marker)) return f; } catch { /* 忽略坏文件 */ }
|
|
85
|
+
}
|
|
86
|
+
return readme;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** 解析「树宿主 md」——README 不再写死为唯一宿主:自动探测含 dshgp-tree 标记块的 md(分体式文档下宿主可随文档拆分迁移,脚本零改动)。 */
|
|
90
|
+
export function resolveTargetMd(root, explicit = '', marker = 'dshgp-tree') {
|
|
91
|
+
if (explicit) return explicit;
|
|
92
|
+
return findMarkedHostMd(root, marker);
|
|
93
|
+
}
|
|
94
|
+
const TOP_DIRS = [
|
|
95
|
+
'lib', 'scripts', 'assets', 'test', 'docs', 'skills',
|
|
96
|
+
'cli.mjs', 'package.json', 'README.md', 'cordis.patch.yml',
|
|
97
|
+
];
|
|
98
|
+
|
|
99
|
+
/* ───────────────────────── git 未忽略文件清单 ───────────────────────── */
|
|
100
|
+
|
|
101
|
+
function gitLsFiles(root = ROOT) {
|
|
102
|
+
try {
|
|
103
|
+
// 已跟踪 + 未跟踪但未忽略(新文件/待提交都算「未忽略文件」,README 目录树应含它们)
|
|
104
|
+
const out = execFileSync('git', ['-c', 'core.quotepath=false', '-C', root, 'ls-files', '--cached', '--others', '--exclude-standard'], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
|
|
105
|
+
return out.split('\n').map((l) => l.trim()).filter(Boolean).filter((p) => {
|
|
106
|
+
// 缺陷修复:--cached 会把「已跟踪但工作区已删」的文件也列出(应只取真实存在的文件)
|
|
107
|
+
// (如 mv 进 .trash 的旧文件仍留在索引),导致 check 误报「真实存在但未列」。
|
|
108
|
+
// 目录树描述的是工作区现状,只保留工作区实际存在的文件。
|
|
109
|
+
try { return statSync(join(root, p)).isFile(); } catch { return false; }
|
|
110
|
+
});
|
|
111
|
+
} catch {
|
|
112
|
+
return [];
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/* ───────────────────────── 注释映射读写 ───────────────────────── */
|
|
117
|
+
|
|
118
|
+
function loadMapping(root = ROOT) {
|
|
119
|
+
const mappingFile = join(root, 'tree-doc.json');
|
|
120
|
+
if (!existsSync(mappingFile)) return {};
|
|
121
|
+
try { return JSON.parse(readFileSync(mappingFile, 'utf8')); } catch { return {}; }
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function writeMapping(map, root = ROOT) {
|
|
125
|
+
writeFileSync(join(root, 'tree-doc.json'), JSON.stringify(map, null, 2) + '\n', 'utf8');
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* 工作区未提交变动文件:git status --porcelain → {path: {status, mtime, note}}。
|
|
130
|
+
* M/A/D + 文件 mtime——**面向开发者/AI 的元数据**:提示「该文件变动了,tree-doc 注释可能需更新」。
|
|
131
|
+
* 与 tree-doc.json 的 `_meta.worktree` 配合;apply 到 README 只同步原描述,不含本信息。
|
|
132
|
+
* @returns {Object<string, {status: string, mtime: string, note: string}>}
|
|
133
|
+
*/
|
|
134
|
+
function gitWorktreeChanges(root = ROOT) {
|
|
135
|
+
try {
|
|
136
|
+
const out = execFileSync(
|
|
137
|
+
'git', ['-c', 'core.quotepath=false', '-C', root, 'status', '--porcelain'],
|
|
138
|
+
{ encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 },
|
|
139
|
+
);
|
|
140
|
+
const res = {};
|
|
141
|
+
for (const raw of out.split('\n')) {
|
|
142
|
+
if (!raw.trim()) continue;
|
|
143
|
+
// status --porcelain:前 2 字符 = 状态两列(index/worktree),第 3 字符 = 空格。
|
|
144
|
+
// 不能 trim 整行再 slice(trim 掉前导空格会错位,实测路径首字符被吃)。
|
|
145
|
+
const cell = raw.slice(0, 2);
|
|
146
|
+
const code = cell === '??' ? 'A' : (cell[0] !== ' ' ? cell[0] : (cell[1] !== ' ' ? cell[1] : '')); // ?? 未跟踪=新增
|
|
147
|
+
const path = raw.slice(3).replace(/^"|"$/g, '').trim();
|
|
148
|
+
if (!path || path === 'tree-doc.json') continue; // 排除映射文件自身
|
|
149
|
+
if (!/^[MAD]$/.test(code)) continue; // 只记 M/A/D(R/C/忽略项不算「需更新注释」的变动)
|
|
150
|
+
let mtime = '';
|
|
151
|
+
try { mtime = statSync(join(root, path)).mtime.toISOString(); } catch { /* 已删文件拿不到 mtime */ }
|
|
152
|
+
res[path] = { status: code, mtime, note: '注释可能需更新' };
|
|
153
|
+
}
|
|
154
|
+
return res;
|
|
155
|
+
} catch { return {}; }
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* 索引自动同步:对齐 tree-doc.json 键集合与真实文件集。
|
|
160
|
+
* - 新增文件(git 未忽略、工作区存在)不在索引 → 自动补键,值=(待注释),等人补描述
|
|
161
|
+
* - 索引里有但文件已删 → 自动删键(描述连带删除),不再产生孤儿
|
|
162
|
+
* - 目录键(目录级注释合法)自动补齐:真实文件的所有父目录(无尾斜杠,与现有键一致)
|
|
163
|
+
* @param {{write?: boolean, files?: string[], map?: object}} [opts] 测试可注入
|
|
164
|
+
* @returns {{added: string[], removed: string[], map: object}}
|
|
165
|
+
*/
|
|
166
|
+
export function syncIndex({ write = true, files = gitLsFiles(), map = loadMapping(), root = ROOT } = {}) {
|
|
167
|
+
const added = [];
|
|
168
|
+
const removed = [];
|
|
169
|
+
const next = { ...map };
|
|
170
|
+
// 真实存在路径:文件 + 父目录链(目录键无尾斜杠,与 tree-doc.json 现有键一致)
|
|
171
|
+
const realFiles = new Set(files);
|
|
172
|
+
const realDirs = new Set();
|
|
173
|
+
for (const f of files) {
|
|
174
|
+
let dir = f.includes('/') ? f.slice(0, f.lastIndexOf('/')) : null;
|
|
175
|
+
while (dir) {
|
|
176
|
+
realDirs.add(dir);
|
|
177
|
+
const i = dir.lastIndexOf('/');
|
|
178
|
+
dir = i === -1 ? null : dir.slice(0, i);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
// 删除孤儿键(文件或目录已不存在;`_meta` 元数据键保留)
|
|
182
|
+
for (const k of Object.keys(next)) {
|
|
183
|
+
if (k === '_meta') continue;
|
|
184
|
+
if (realFiles.has(k) || realDirs.has(k)) continue;
|
|
185
|
+
removed.push(k);
|
|
186
|
+
delete next[k];
|
|
187
|
+
}
|
|
188
|
+
// 补新增键(文件 + 目录),保持插入顺序稳定(先目录后文件:树父在前)
|
|
189
|
+
// 逐个 add 而不是 new Set([...realDirs, ...realFiles]):避免为去重多复制两个数组一遍
|
|
190
|
+
// (性能规则 performance/memory-bomb「展开多个大数组会一次性创建新数组」;插入顺序不变)
|
|
191
|
+
const want = new Set(realDirs);
|
|
192
|
+
for (const f of realFiles) want.add(f);
|
|
193
|
+
for (const p of want) {
|
|
194
|
+
if (p in next) continue;
|
|
195
|
+
next[p] = '(待注释)';
|
|
196
|
+
added.push(p);
|
|
197
|
+
}
|
|
198
|
+
// 工作区变动文件记录进 `_meta.worktree`(mtime + 状态)——面向开发者/AI 的
|
|
199
|
+
// 提示「注释可能需更新」;apply 到 README 只同步原描述(buildTreeText 只查 map[path]),
|
|
200
|
+
// `_meta` 不进 README。工作区干净时清空该段(避免陈旧提示)。
|
|
201
|
+
const wt = gitWorktreeChanges(root);
|
|
202
|
+
const wtKeys = Object.keys(wt);
|
|
203
|
+
const metaChanged = wtKeys.length
|
|
204
|
+
? JSON.stringify(next._meta?.worktree || null) !== JSON.stringify(wt)
|
|
205
|
+
: Boolean(next._meta?.worktree);
|
|
206
|
+
if (wtKeys.length) next._meta = { ...(next._meta || {}), worktree: wt };
|
|
207
|
+
else if (next._meta?.worktree) delete next._meta.worktree;
|
|
208
|
+
if (next._meta && Object.keys(next._meta).length === 0) delete next._meta;
|
|
209
|
+
if (write && (added.length || removed.length || metaChanged)) writeMapping(next, root);
|
|
210
|
+
return { added, removed, map: next, worktreeChanges: wt };
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/* ───────────────────────── 两层树构建 ───────────────────────── */
|
|
214
|
+
|
|
215
|
+
/** 顶层归类:返回 { groups: [{name, entries:[路径]}], rootFiles: [路径] } */
|
|
216
|
+
function buildGroups(files) {
|
|
217
|
+
const groups = new Map(); // 顶层目录名 → 其下文件路径列表
|
|
218
|
+
const rootFiles = [];
|
|
219
|
+
const known = new Set(TOP_DIRS);
|
|
220
|
+
for (const f of files) {
|
|
221
|
+
const top = f.split('/')[0];
|
|
222
|
+
if (!f.includes('/')) rootFiles.push(f); // 根级文件
|
|
223
|
+
else {
|
|
224
|
+
if (!groups.has(top)) groups.set(top, []);
|
|
225
|
+
groups.get(top).push(f);
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
// 未在 TOP_DIRS 的顶层目录也归组(放后面)
|
|
229
|
+
const groupNames = [...groups.keys()];
|
|
230
|
+
const order = [...TOP_DIRS.filter((k) => groups.has(k)), ...groupNames.filter((n) => !TOP_DIRS.includes(n))];
|
|
231
|
+
return { groups, groupNames: order, rootFiles: [...new Set(rootFiles)] };
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/** 目录组 → 两层折叠文本行(子目录只到一层,更深用 …) */
|
|
235
|
+
function groupLines(name, paths, map, prefix = '') {
|
|
236
|
+
const lines = [];
|
|
237
|
+
// 该组下第一层:直接文件 vs 子目录
|
|
238
|
+
const direct = [];
|
|
239
|
+
const subdirs = new Map(); // 子目录名 → 其下文件
|
|
240
|
+
for (const p of paths) {
|
|
241
|
+
const rest = p.slice(name.length + 1); // 去掉顶层
|
|
242
|
+
if (!rest.includes('/')) direct.push(p);
|
|
243
|
+
else {
|
|
244
|
+
const sub = rest.split('/')[0];
|
|
245
|
+
if (!subdirs.has(sub)) subdirs.set(sub, []);
|
|
246
|
+
subdirs.get(sub).push(p);
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
const note = (p) => (map[p] ? map[p] : '(待注释)');
|
|
250
|
+
for (const entry of direct.sort()) lines.push(`│ ├── ${basename(entry)} — ${note(entry)}`);
|
|
251
|
+
for (const [sub, items] of [...subdirs.entries()].sort()) {
|
|
252
|
+
const subPath = `${name}/${sub}`;
|
|
253
|
+
// 第二层直接文件;更深折叠
|
|
254
|
+
const second = items.map((p) => p.slice(subPath.length + 1)).filter((r) => !r.includes('/')).sort();
|
|
255
|
+
const deeper = items.filter((p) => p.slice(subPath.length + 1).includes('/')).length;
|
|
256
|
+
lines.push(`│ ├── ${sub}/ — ${map[subPath] || (second.length ? '' : '(待注释)')}`);
|
|
257
|
+
for (const s of second) lines.push(`│ │ ├── ${s} — ${note(`${subPath}/${s}`)}`);
|
|
258
|
+
if (deeper) lines.push(`│ │ └── …(${deeper} 个更深文件)`);
|
|
259
|
+
}
|
|
260
|
+
return lines;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
/** 生成完整树文本(顶层分组 + 根文件,两层折叠) */
|
|
264
|
+
export function buildTreeText(files = gitLsFiles(), map = loadMapping(), rootLabel = basename(ROOT)) {
|
|
265
|
+
const { groups, groupNames, rootFiles } = buildGroups(files);
|
|
266
|
+
const out = ['```text', rootLabel + '/'];
|
|
267
|
+
for (const groupName of groupNames) {
|
|
268
|
+
out.push(`├── ${groupName}/ — ${map[groupName] || '(待注释)'}`);
|
|
269
|
+
out.push(...groupLines(groupName, groups.get(groupName), map));
|
|
270
|
+
}
|
|
271
|
+
for (const rf of [...rootFiles].sort()) {
|
|
272
|
+
out.push(`├── ${rf} — ${map[rf] || '(待注释)'}`);
|
|
273
|
+
}
|
|
274
|
+
out.push('```');
|
|
275
|
+
return out.join('\n');
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/* ───────────────────────── README 标记块读写 ───────────────────────── */
|
|
279
|
+
|
|
280
|
+
/** 找文本内的标记块(marker 如 'dshgp-tree';块 = <!-- <marker>:start --> … <!-- <marker>:end -->)。 */
|
|
281
|
+
function findBlock(text, marker = 'dshgp-tree') {
|
|
282
|
+
const sMark = `<!-- ${marker}:start -->`;
|
|
283
|
+
const eMark = `<!-- ${marker}:end -->`;
|
|
284
|
+
const s = text.indexOf(sMark);
|
|
285
|
+
const e = text.indexOf(eMark);
|
|
286
|
+
if (s === -1 || e === -1 || e <= s) return null;
|
|
287
|
+
return { start: s, end: e, content: text.slice(s + sMark.length, e) };
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
function readReadme(path) {
|
|
291
|
+
if (!existsSync(path)) throw new Error(`README 不存在: ${path}`);
|
|
292
|
+
return readFileSync(path, 'utf8');
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
function applyBlock(text, newTree) {
|
|
296
|
+
const block = findBlock(text);
|
|
297
|
+
if (!block) throw new Error('README 未找到标记块(<!-- dshgp-tree:start --> … <!-- dshgp-tree:end -->),先插入标记再 apply');
|
|
298
|
+
return text.slice(0, block.start) + MARK_START + '\n' + newTree + '\n' + MARK_END + text.slice(block.end + MARK_END.length);
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
/* ───────────────────────── check:漂移对比 ───────────────────────── */
|
|
302
|
+
|
|
303
|
+
export function checkDrift({ readmePath = DEFAULT_README, root = ROOT } = {}) {
|
|
304
|
+
const text = readReadme(readmePath);
|
|
305
|
+
const block = findBlock(text);
|
|
306
|
+
const real = buildTreeText(gitLsFiles(root), loadMapping(root), basename(root));
|
|
307
|
+
const map = loadMapping(root);
|
|
308
|
+
// 真实树内已解析条目(路径集合)
|
|
309
|
+
const realPaths = new Set(gitLsFiles(root));
|
|
310
|
+
const issues = [];
|
|
311
|
+
if (!block) {
|
|
312
|
+
issues.push({ type: 'no-block', msg: `${basename(readmePath)} 没有目录结构标记块(${MARK_START} … ${MARK_END});可 apply 前先插入标记,或把树写到带标记的 docs/ md(自动探测)` });
|
|
313
|
+
return { ok: false, drift: true, issues, realTree: real };
|
|
314
|
+
}
|
|
315
|
+
// 现有块内容 → 提取完整相对路径(按缩进深度拼层级),目录带尾斜杠
|
|
316
|
+
const inBlock = block.content;
|
|
317
|
+
const seen = new Set();
|
|
318
|
+
const foldedDirs = []; // 折叠点目录(… N 个更深文件 → 该目录下更深文件不逐项核对)
|
|
319
|
+
let stack = [];
|
|
320
|
+
for (const line of inBlock.split('\n')) {
|
|
321
|
+
// 缩进深度 = 前缀 `│ ` 的个数(顶层=0)
|
|
322
|
+
const depth = (line.match(/│ /g) || []).length;
|
|
323
|
+
const lineText = line.replace(/^(\s*)(?:│ )*(?:├──|└──)\s*/, '').trim();
|
|
324
|
+
if (!lineText || lineText.startsWith('```')) continue; // 跳过代码围栏行
|
|
325
|
+
if (lineText.startsWith('…')) {
|
|
326
|
+
// 折叠行:当前目录链即折叠点(其下更深文件除外)
|
|
327
|
+
if (stack.length) foldedDirs.push(stack.join('/') + '/');
|
|
328
|
+
continue;
|
|
329
|
+
}
|
|
330
|
+
// 按「—」切出名字段(trim 后破折号后无空格,split(' — ') 会失效)
|
|
331
|
+
const name = lineText.split('—')[0].trim();
|
|
332
|
+
// 修:树根节点豁免原硬编码本插件名(dsh-git-push)——扫描其它仓库(如
|
|
333
|
+
// dsh-theme-mediascape)时根节点 <repoName>/ 被误判 stale。改为动态豁免当前 git 根目录名。
|
|
334
|
+
const repoRoot = basename(root);
|
|
335
|
+
if (!name || name === repoRoot || name === repoRoot + '/') continue;
|
|
336
|
+
stack = stack.slice(0, depth); // 回退到当前深度
|
|
337
|
+
if (name.endsWith('/')) {
|
|
338
|
+
const dir = name.slice(0, -1);
|
|
339
|
+
seen.add([...stack, dir].join('/') + '/');
|
|
340
|
+
stack = [...stack, dir];
|
|
341
|
+
} else {
|
|
342
|
+
seen.add([...stack, name].join('/'));
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
// 真实路径集合(git 未忽略文件 + 真实目录)
|
|
346
|
+
const realSet = new Set();
|
|
347
|
+
for (const p of realPaths) realSet.add(p);
|
|
348
|
+
const isRealDir = (p) => { try { return statSync(join(root, p.replace(/\/$/, ''))).isDirectory(); } catch { return false; } };
|
|
349
|
+
// 工具自产生成物不追漂移——tree-doc/functions 自产(README 树与索引的
|
|
350
|
+
// 增删由工具维护,不属手写树内容):docs/函数/*(apply 生成/删除常态)、
|
|
351
|
+
// functions-index.json(analyze 产物)。_meta 见 orphan 判定。
|
|
352
|
+
const isToolGenerated = (p) => p === 'functions-index.json' || p === '_meta'
|
|
353
|
+
|| p.startsWith('docs/函数/') || p.includes('_archived/');
|
|
354
|
+
// missing:真实文件不在树上(被折叠的设计除外;工具生成物豁免)
|
|
355
|
+
const missing = [];
|
|
356
|
+
for (const p of realPaths) {
|
|
357
|
+
const folded = foldedDirs.some((d) => p.startsWith(d));
|
|
358
|
+
if (!folded && !seen.has(p) && !isRealDir(p) && !isToolGenerated(p)) missing.push(p);
|
|
359
|
+
}
|
|
360
|
+
// stale:树上列出但真实不存在(文件或目录;工具生成物豁免)
|
|
361
|
+
const stale = [];
|
|
362
|
+
for (const s of seen) {
|
|
363
|
+
if (isToolGenerated(s)) continue;
|
|
364
|
+
if (s.endsWith('/')) { if (!isRealDir(s)) stale.push(s); }
|
|
365
|
+
else if (!realSet.has(s)) stale.push(s);
|
|
366
|
+
}
|
|
367
|
+
// 注释映射孤儿:路径既不是 git 文件,也不是真实目录(目录级注释合法);`_meta`/生成物键跳过
|
|
368
|
+
const orphans = [];
|
|
369
|
+
for (const p of Object.keys(map)) {
|
|
370
|
+
if (isToolGenerated(p)) continue; // _meta 元数据 + docs/函数/ 等工具产物不算孤儿
|
|
371
|
+
const full = join(root, p);
|
|
372
|
+
let realDir = false;
|
|
373
|
+
try { realDir = statSync(full).isDirectory(); } catch { /* 路径不存在:不算真实目录 */ }
|
|
374
|
+
if (!realSet.has(p) && !realDir) orphans.push(p);
|
|
375
|
+
}
|
|
376
|
+
const drift = missing.length > 0 || stale.length > 0 || orphans.length > 0;
|
|
377
|
+
if (missing.length) issues.push({ type: 'missing', msg: `真实存在但 README 未列(新增未更新): ${missing.slice(0, 12).join(', ')}${missing.length > 12 ? `…(+${missing.length - 12})` : ''}` });
|
|
378
|
+
if (stale.length) issues.push({ type: 'stale', msg: `README 列出但真实不存在(已删除): ${stale.join(', ')}` });
|
|
379
|
+
if (orphans.length) issues.push({ type: 'orphan', msg: `tree-doc.json 映射了不存在的路径(运行 tree-doc.mjs sync 自动清理): ${orphans.slice(0, 8).join(', ')}${orphans.length > 8 ? `…(+${orphans.length - 8})` : ''}` });
|
|
380
|
+
return { ok: !drift, drift, issues, realTree: real, worktreeChanges: gitWorktreeChanges(root) };
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
/* ───────────────────────── CLI ───────────────────────── */
|
|
384
|
+
// 仅直接运行时执行(测试 import 本文件不应触发 CLI)
|
|
385
|
+
const isMain = process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1]);
|
|
386
|
+
|
|
387
|
+
if (isMain) {
|
|
388
|
+
const args = process.argv.slice(2);
|
|
389
|
+
const cmd = args[0];
|
|
390
|
+
// `--root <路径>` 支持外调其他项目——其他仓库可直接用本脚本维护自己的
|
|
391
|
+
// README 目录树(`node <dsh-git-push>/scripts/tree-doc.mjs check --root <其他项目根>`)。
|
|
392
|
+
// 缺省 = 自身项目(向后兼容);显式 `--readme` 优先于 root 推导的 README 路径。
|
|
393
|
+
const rootIdx = args.indexOf('--root');
|
|
394
|
+
const rootArg = rootIdx !== -1 && args[rootIdx + 1] ? resolve(args[rootIdx + 1]) : ROOT;
|
|
395
|
+
// README 不再写死——自动探测宿主 md(README 无标记块时找 docs/ 里带标记块的)
|
|
396
|
+
const readmeIdx = args.indexOf('--readme');
|
|
397
|
+
const readmeExplicit = readmeIdx !== -1 && args[readmeIdx + 1] ? resolve(args[readmeIdx + 1]) : '';
|
|
398
|
+
const readmePath = readmeExplicit || resolveTargetMd(rootArg);
|
|
399
|
+
const forceAll = args.includes('--all');
|
|
400
|
+
const filesOf = (r) => gitLsFiles(r);
|
|
401
|
+
const mapOf = (r) => loadMapping(r);
|
|
402
|
+
|
|
403
|
+
switch (cmd) {
|
|
404
|
+
case 'sync': {
|
|
405
|
+
// 索引自动同步:新增补(待注释)、删除自动删键(描述连带删)
|
|
406
|
+
const files = filesOf(rootArg);
|
|
407
|
+
const { added, removed, map } = syncIndex({ write: !args.includes('--dry'), files, map: mapOf(rootArg), root: rootArg });
|
|
408
|
+
const dirs = new Set();
|
|
409
|
+
for (const f of files) {
|
|
410
|
+
let dir = f.includes('/') ? f.slice(0, f.lastIndexOf('/')) : null;
|
|
411
|
+
while (dir) { dirs.add(dir + '/'); const i = dir.lastIndexOf('/'); dir = i === -1 ? null : dir.slice(0, i); }
|
|
412
|
+
}
|
|
413
|
+
const tree = buildTreeText(files, map, basename(rootArg));
|
|
414
|
+
if (added.length) console.log(`✅ 新增索引键 ${added.length} 个(值=(待注释),请补描述):\n ${added.join('\n ')}`);
|
|
415
|
+
if (removed.length) console.log(`🗑 删除索引键 ${removed.length} 个(文件已删,描述连带删除):\n ${removed.join('\n ')}`);
|
|
416
|
+
if (!added.length && !removed.length) console.log('✅ 索引已同步(无新增/删除)');
|
|
417
|
+
if (args.includes('--write-tree')) writeFileSync(readmePath, applyBlock(readReadme(readmePath), tree), 'utf8');
|
|
418
|
+
console.log(`(tree-doc.json 现有 ${Object.keys(map).length} 键;gen 输出见 tree-doc.mjs gen)`);
|
|
419
|
+
break;
|
|
420
|
+
}
|
|
421
|
+
case 'gen': {
|
|
422
|
+
const files = filesOf(rootArg);
|
|
423
|
+
if (args.includes('--write')) {
|
|
424
|
+
// 索引同步 + 补(待注释)(与 sync 同一逻辑——--all 为显式全量语义:显式声明时连已同步键也重写,默认只补缺)
|
|
425
|
+
const { added, removed } = syncIndex({ write: true, files, map: mapOf(rootArg), root: rootArg });
|
|
426
|
+
if (forceAll) console.log('--all:已强制全量追加索引');
|
|
427
|
+
console.log(`tree-doc.json 已同步(新增 ${added.length} / 删除 ${removed.length};${added.length ? '待注释键请补描述' : ''})`);
|
|
428
|
+
} else {
|
|
429
|
+
console.log(buildTreeText(files, mapOf(rootArg), basename(rootArg)));
|
|
430
|
+
}
|
|
431
|
+
break;
|
|
432
|
+
}
|
|
433
|
+
case 'check': {
|
|
434
|
+
const r = checkDrift({ readmePath, root: rootArg });
|
|
435
|
+
if (r.ok) { console.log(`✅ 目录结构与 README 一致(无漂移)${rootArg !== ROOT ? ` @ ${rootArg}` : ''}`); process.exit(0); }
|
|
436
|
+
console.log('❌ 存在漂移:');
|
|
437
|
+
for (const i of r.issues) console.log(' -', i.msg);
|
|
438
|
+
if (r.realTree) console.log('\n═══ 最新树(可用 apply 覆盖)═══\n' + r.realTree);
|
|
439
|
+
process.exit(1);
|
|
440
|
+
}
|
|
441
|
+
case 'apply': {
|
|
442
|
+
// apply 前先同步索引,保证树用最新映射(描述缺失处标(待注释))
|
|
443
|
+
if (args.includes('--sync') || forceAll) syncIndex({ write: true, files: filesOf(rootArg), map: mapOf(rootArg), root: rootArg });
|
|
444
|
+
const tree = buildTreeText(filesOf(rootArg), mapOf(rootArg), basename(rootArg));
|
|
445
|
+
const text = readReadme(readmePath);
|
|
446
|
+
const updated = applyBlock(text, tree);
|
|
447
|
+
writeFileSync(readmePath, updated, 'utf8');
|
|
448
|
+
console.log(`✅ 已覆盖目录结构块: ${readmePath}`);
|
|
449
|
+
if (!readmePath.endsWith('README.md')) console.log(' ℹ️ 宿主为非 README md——确保 README 以链接引用它(分体式文档,见插件 skill「文档组织」节)');
|
|
450
|
+
break;
|
|
451
|
+
}
|
|
452
|
+
default:
|
|
453
|
+
console.log('用法: node scripts/tree-doc.mjs <sync|gen|check|apply> [--root <项目根>] [--readme <路径>] [--write] [--all] [--dry]');
|
|
454
|
+
process.exit(1);
|
|
455
|
+
}
|
|
456
|
+
}
|