@stellar_ai/mcp_fossil_scm 0.2.1 → 0.2.2
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 +32 -30
- package/dist/capabilities.js +30 -22
- package/dist/cli.js +11 -11
- package/dist/config.js +1 -1
- package/dist/core/gitignore.js +7 -4
- package/dist/index.js +1 -1
- package/dist/prompts.js +28 -30
- package/dist/tools/admin.js +54 -54
- package/dist/tools/utils.js +237 -0
- package/dist/tools/version-control.js +1 -231
- package/docs/README.md +6 -5
- package/docs/admin.md +45 -43
- package/docs/chat.md +1 -1
- package/docs/forum.md +1 -1
- package/docs/prompts.md +4 -4
- package/docs/tickets.md +1 -1
- package/docs/utils.md +262 -0
- package/docs/vcs.md +28 -235
- package/docs/wiki.md +1 -1
- package/package.json +2 -2
package/docs/vcs.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# VCS 能力(`-c v`)工具說明
|
|
2
2
|
|
|
3
|
-
適用於 `@stellar_ai/mcp_fossil_scm@0.2.
|
|
3
|
+
適用於 `@stellar_ai/mcp_fossil_scm@0.2.2` 及之後。所有行為都在 fossil 2.21 上實測。
|
|
4
4
|
|
|
5
|
-
`-c v` 註冊
|
|
5
|
+
`-c v` 註冊 33 個工具;要連 admin 與 utils 一起用 `-c auv`。
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -12,7 +12,6 @@
|
|
|
12
12
|
| --- | --- |
|
|
13
13
|
| `fossil_status` | `fossil status` + `fossil extra` |
|
|
14
14
|
| `fossil_diff` | `fossil diff` |
|
|
15
|
-
| `fossil_cat` | `fossil cat <file> [-r REV]` |
|
|
16
15
|
| `fossil_finfo` | `fossil finfo [-i\|-s\|-p\|-l] <file>` |
|
|
17
16
|
| `fossil_ls` | `fossil ls [-R FILE] [-r REV] [--age] [-v] [-t] [--hash]` |
|
|
18
17
|
| `fossil_extras` | `fossil extras` |
|
|
@@ -33,14 +32,10 @@
|
|
|
33
32
|
| `fossil_undo` | `fossil undo [-n]` |
|
|
34
33
|
| `fossil_changes` | `fossil changes` |
|
|
35
34
|
| `fossil_annotate` | `fossil blame\|annotate\|praise <file>` |
|
|
36
|
-
| `fossil_grep` | `fossil grep <pattern> <files>` |
|
|
37
|
-
| `fossil_whatis` | `fossil whatis <name>` |
|
|
38
35
|
| `fossil_merge_base` | `fossil merge-base <v1> <v2>` |
|
|
39
36
|
| `fossil_leaves` | `fossil leaves` |
|
|
40
37
|
| `fossil_descendants` | `fossil descendants [checkin]` |
|
|
41
38
|
| `fossil_unpublished` | `fossil unpublished` |
|
|
42
|
-
| `fossil_search` | `fossil search [-a] [-n N] [-W WIDTH] <pattern>` |
|
|
43
|
-
| `fossil_artifact` | `fossil artifact <hash>` |
|
|
44
39
|
| `fossil_describe` | `fossil describe [version]` |
|
|
45
40
|
| `fossil_archive` | `fossil tarball\|zip <version> <outfile>` |
|
|
46
41
|
| `fossil_unversioned` | `fossil unversioned list\|cat\|add\|remove\|touch` |
|
|
@@ -48,11 +43,9 @@
|
|
|
48
43
|
| `fossil_amend` | `fossil amend <check-in> --comment/--tag/…` |
|
|
49
44
|
| `fossil_patch` | `fossil patch create\|diff\|apply <file>` |
|
|
50
45
|
| `fossil_bisect` | `fossil bisect good\|bad\|skip\|next\|log\|chart\|options\|reset\|run` |
|
|
51
|
-
| `fossil_sql` | `fossil sql --readonly -json <query>` |
|
|
52
|
-
| `fossil_ignore_from_gitignore` | 讀 `.gitignore`,寫 `.fossil-settings/ignore-glob` |
|
|
53
46
|
|
|
54
47
|
標了 `destructiveHint: true` 的是 `fossil_rm` / `fossil_revert` / `fossil_clean` / `fossil_update` / `fossil_undo`:
|
|
55
|
-
它們會覆蓋工作區內容,呼叫方應先確認,或先跑 `dry_run` / `-n` 預覽。`
|
|
48
|
+
它們會覆蓋工作區內容,呼叫方應先確認,或先跑 `dry_run` / `-n` 預覽。`fossil_info`/`fossil_descendants`/`fossil_ls`/`fossil_timeline` 可用 `repository` 直接讀倉庫檔,其餘工具都需要 check-out(見 §2)。原始工件、檔案內容與 SQL 查詢屬於 utils 能力(`-c u`)。
|
|
56
49
|
|
|
57
50
|
---
|
|
58
51
|
|
|
@@ -81,13 +74,13 @@ WORKSPACE: /tmp/vd
|
|
|
81
74
|
|
|
82
75
|
### 3.1 `fossil_status`
|
|
83
76
|
|
|
84
|
-
|
|
77
|
+
一次呼叫依序執行兩條命令,輸出分兩段:
|
|
85
78
|
|
|
86
79
|
```bash
|
|
87
80
|
fossil status|changes [--dotfiles] [--ignore GLOBS] [--hash] [--abs-paths|--rel-paths]
|
|
88
81
|
[--edited|--updated|--changed|--missing|--added|--deleted|--renamed|--conflict
|
|
89
82
|
|--meta|--unchanged|--all|--differ|--extra ...] [--classify] [--header] [-v]
|
|
90
|
-
fossil extra [--dotfiles] [--ignore GLOBS] # cwd = workspace,未指定 select
|
|
83
|
+
fossil extra [--dotfiles] [--ignore GLOBS] # cwd = workspace,未指定 select 時執行
|
|
91
84
|
```
|
|
92
85
|
|
|
93
86
|
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
@@ -159,22 +152,7 @@ fossil diff [--from X] [--to Y] [--branch B] [-ci C] [--brief] [--numstat]
|
|
|
159
152
|
不給版本時是“工作區 vs 最近一次 check-in”。版本名寫錯時 fossil 報
|
|
160
153
|
`cannot resolve name: tip-1`(`tip-1` 不是合法表示式,用雜湊前綴或 `tip`)。空輸出 → `No differences found.`
|
|
161
154
|
|
|
162
|
-
### 3.3 `
|
|
163
|
-
|
|
164
|
-
```bash
|
|
165
|
-
fossil cat <file> [-r REV]
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
列印檔案內容。`revision` 省略時讀當前 check-out 的版本。
|
|
169
|
-
|
|
170
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
171
|
-
| --- | --- | --- | --- |
|
|
172
|
-
| `file` | string | **必填** | 要列印的檔案 |
|
|
173
|
-
| `revision` | string | — | 指定 check-in 或版本(`-r`) |
|
|
174
|
-
| `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
|
|
175
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
176
|
-
|
|
177
|
-
### 3.4 `fossil_finfo`
|
|
155
|
+
### 3.3 `fossil_finfo`
|
|
178
156
|
|
|
179
157
|
```bash
|
|
180
158
|
fossil finfo [-l|-i|-s|-p] [-b] [-n N] [--offset P] [-r REV] [-v] <file>
|
|
@@ -213,7 +191,7 @@ unchanged 5f3e19ce7a
|
|
|
213
191
|
`-b` / `-n` / `--offset` 只在 `log` 模式送出,`-r` 只在 `id` 與 `print` 模式送出,`-v` 只在 `id` 模式送出;
|
|
214
192
|
其餘組合 fossil 會回 `unrecognized command-line option or missing argument`。
|
|
215
193
|
|
|
216
|
-
### 3.
|
|
194
|
+
### 3.4 `fossil_extras`
|
|
217
195
|
|
|
218
196
|
```bash
|
|
219
197
|
fossil extras [--dotfiles] [--ignore GLOBS] [--abs-paths|--rel-paths] [--header] [--case-sensitive 1|0]
|
|
@@ -231,7 +209,7 @@ fossil extras [--dotfiles] [--ignore GLOBS] [--abs-paths|--rel-paths] [--header]
|
|
|
231
209
|
|
|
232
210
|
空輸出 → `No untracked files.`。Node 專案建議提交 `.fossil-settings/ignore-glob`(見 admin §6.3)。
|
|
233
211
|
|
|
234
|
-
### 3.
|
|
212
|
+
### 3.5 `fossil_timeline`
|
|
235
213
|
|
|
236
214
|
```bash
|
|
237
215
|
fossil timeline -n <limit> [-R FILE] [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN CHECKIN] [-F FORMAT] [-v]
|
|
@@ -264,7 +242,7 @@ fossil timeline -n <limit> [-R FILE] [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN
|
|
|
264
242
|
+++ no more data (3) +++
|
|
265
243
|
```
|
|
266
244
|
|
|
267
|
-
### 3.
|
|
245
|
+
### 3.6 `fossil_info`
|
|
268
246
|
|
|
269
247
|
```bash
|
|
270
248
|
fossil info [target] [-R FILE] [-v]
|
|
@@ -281,7 +259,7 @@ fossil info [target] [-R FILE] [-v]
|
|
|
281
259
|
| `workspace` | string | 見 admin §2.1 | — |
|
|
282
260
|
|
|
283
261
|
---
|
|
284
|
-
### 3.
|
|
262
|
+
### 3.7 `fossil_changes`
|
|
285
263
|
|
|
286
264
|
```bash
|
|
287
265
|
fossil changes [--edited|--updated|--added|--deleted|--renamed|--conflict|--meta]
|
|
@@ -322,7 +300,7 @@ ADDED src/tools/notes.ts
|
|
|
322
300
|
變更偵測靠 mtime + 大小,改動若落在上一次 commit 的同一秒內,`changes` / `status` / `diff` 都還看不到,
|
|
323
301
|
`touch` 檔案後才出現。
|
|
324
302
|
|
|
325
|
-
### 3.
|
|
303
|
+
### 3.8 `fossil_annotate`
|
|
326
304
|
|
|
327
305
|
```bash
|
|
328
306
|
fossil blame|annotate|praise <file> [-r REV] [-o ORIGIN] [-n LIMIT] [--filevers] [-l] [-w] [-Z]
|
|
@@ -349,64 +327,7 @@ fossil blame|annotate|praise <file> [-r REV] [-o ORIGIN] [-n LIMIT] [--filevers]
|
|
|
349
327
|
|
|
350
328
|
`fossil blame` 的行是 `<hash> <date> <line>: <text>`,praise/blame 的 `<text>` 是 `作者: 內容`。
|
|
351
329
|
|
|
352
|
-
### 3.
|
|
353
|
-
|
|
354
|
-
```bash
|
|
355
|
-
fossil grep [-i] [-c] [-l] [--once] [-v] [-s] [--verbose] <pattern> <files...>
|
|
356
|
-
```
|
|
357
|
-
|
|
358
|
-
在檔案的**歷史版本**裡搜尋(由新到舊),不是工作區。
|
|
359
|
-
|
|
360
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
361
|
-
| --- | --- | --- | --- |
|
|
362
|
-
| `pattern` | string | 必填 | POSIX 延伸正規表示式 |
|
|
363
|
-
| `files` | string[] | 必填,至少 1 | 要搜的檔案 |
|
|
364
|
-
| `ignore_case` | boolean | `false` | `-i` |
|
|
365
|
-
| `count` | boolean | `false` | `-c` 只印匹配檔案數 |
|
|
366
|
-
| `files_with_matches` | boolean | `false` | `-l` 每個匹配檔案印一個 artifact |
|
|
367
|
-
| `once` | boolean | `false` | `--once` 第一次命中就停 |
|
|
368
|
-
| `invert_match` | boolean | `false` | `-v` 只列沒有命中的檔案 |
|
|
369
|
-
| `no_messages` | boolean | `false` | `-s` 靜音讀檔訊息 |
|
|
370
|
-
| `verbose` | boolean | `false` | `--verbose` 邊分析邊回報 |
|
|
371
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
372
|
-
|
|
373
|
-
真實輸出(`fossil grep alpha a.txt`):
|
|
374
|
-
|
|
375
|
-
```
|
|
376
|
-
== 2026-11-17 02:06 a.txt f3a27a552e checkin 86454b6394
|
|
377
|
-
1:alpha
|
|
378
|
-
```
|
|
379
|
-
|
|
380
|
-
空輸出 → `No matches.`
|
|
381
|
-
|
|
382
|
-
### 3.11 `fossil_whatis`
|
|
383
|
-
|
|
384
|
-
```bash
|
|
385
|
-
fossil whatis [-f] [--type ci|t|w|g|e] [-v] <name>
|
|
386
|
-
```
|
|
387
|
-
|
|
388
|
-
把名字(標籤、分支、雜湊前綴、檔名)解析成 artifact。
|
|
389
|
-
|
|
390
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
391
|
-
| --- | --- | --- | --- |
|
|
392
|
-
| `name` | string | 必填 | 要解析的名字 |
|
|
393
|
-
| `file` | boolean | `false` | `-f` 把 `name` 當檔名,查內容雜湊 |
|
|
394
|
-
| `type` | `ci` \| `t` \| `w` \| `g` \| `e` | — | `--type` 只匹配該 artifact 類型 |
|
|
395
|
-
| `verbose` | boolean | `false` | `-v` 附內部 record id |
|
|
396
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
397
|
-
|
|
398
|
-
真實輸出(`name: 'tip'`):
|
|
399
|
-
|
|
400
|
-
```
|
|
401
|
-
name: tip
|
|
402
|
-
artifact: 86454b6394a3b2d2e2c0e2c7a6ee2f4e0b3b5a1a5f2e0d6a0e0f0a1b2c3d4e5f
|
|
403
|
-
size: 340 bytes
|
|
404
|
-
tags: trunk
|
|
405
|
-
type: Check-in by stellar on 2026-11-17 02:06:59
|
|
406
|
-
comment: second commit
|
|
407
|
-
```
|
|
408
|
-
|
|
409
|
-
### 3.12 `fossil_merge_base`
|
|
330
|
+
### 3.9 `fossil_merge_base`
|
|
410
331
|
|
|
411
332
|
```bash
|
|
412
333
|
fossil merge-base [--ignore-merges] <v1> <v2> [...]
|
|
@@ -421,7 +342,7 @@ fossil merge-base [--ignore-merges] <v1> <v2> [...]
|
|
|
421
342
|
真實輸出:`pivot=86454b6394a3b2d2e2c0e2c7a6ee2f4e0b3b5a1a5f2e0d6a0e0f0a1b2c3d4e5f`
|
|
422
343
|
(無共同祖先時 fossil 回 `merge-base: no common ancestor` 並以非零結束)。
|
|
423
344
|
|
|
424
|
-
### 3.
|
|
345
|
+
### 3.10 `fossil_leaves`
|
|
425
346
|
|
|
426
347
|
```bash
|
|
427
348
|
fossil leaves [-a] [-c] [-m] [--recompute] [--bybranch] [-W WIDTH]
|
|
@@ -443,7 +364,7 @@ fossil leaves [-a] [-c] [-m] [--recompute] [--bybranch] [-W WIDTH]
|
|
|
443
364
|
(1) 2026-11-17 02:06:59 [86454b6394] second commit (user: stellar tags: trunk)
|
|
444
365
|
```
|
|
445
366
|
|
|
446
|
-
### 3.
|
|
367
|
+
### 3.11 `fossil_descendants`
|
|
447
368
|
|
|
448
369
|
```bash
|
|
449
370
|
fossil descendants [<checkin>] [-W WIDTH]
|
|
@@ -466,7 +387,7 @@ fossil descendants [<checkin>] [-W WIDTH]
|
|
|
466
387
|
+++ end of timeline (1) +++
|
|
467
388
|
```
|
|
468
389
|
|
|
469
|
-
### 3.
|
|
390
|
+
### 3.12 `fossil_unpublished`
|
|
470
391
|
|
|
471
392
|
```bash
|
|
472
393
|
fossil unpublished [--all]
|
|
@@ -481,50 +402,7 @@ fossil unpublished [--all]
|
|
|
481
402
|
|
|
482
403
|
---
|
|
483
404
|
|
|
484
|
-
### 3.
|
|
485
|
-
|
|
486
|
-
把 `.gitignore` 的規則翻成 `ignore-glob` 認得的 glob 清單,可選擇寫成 `.fossil-settings/ignore-glob`。
|
|
487
|
-
|
|
488
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
489
|
-
| --- | --- | --- | --- |
|
|
490
|
-
| `source` | string | `.gitignore` | 要轉換的檔案,相對 workspace |
|
|
491
|
-
| `write` | boolean | `false` | 寫入 `.fossil-settings/ignore-glob` |
|
|
492
|
-
| `overwrite` | boolean | `false` | 覆蓋已存在的 `.fossil-settings/ignore-glob` |
|
|
493
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
494
|
-
|
|
495
|
-
| `.gitignore` 寫法 | 產出的 glob | 原因 |
|
|
496
|
-
| --- | --- | --- |
|
|
497
|
-
| `# 註解`、空行 | 丟棄 | `ignore-glob` 只有樣式 |
|
|
498
|
-
| `!name` | 略過,並在 `NOTE:` 列出 | `ignore-glob` 沒有否定 |
|
|
499
|
-
| `name` | `name`、`*/name` | 沒有斜線的規則在 git 是任意深度,fossil 比對完整路徑 |
|
|
500
|
-
| `*.log` | `*.log` | 開頭就是萬用字元,fossil 的 `*` 已跨目錄 |
|
|
501
|
-
| `dir/` | `dir` | fossil 命中目錄即略過整個子樹 |
|
|
502
|
-
| `/name` | `name` | 錨定在該 `.gitignore` 所在目錄,前綴沿用目錄名 |
|
|
503
|
-
| `a/**/b` | `a/b`、`a/*/b` | `**` 展開成零層與多層兩條 |
|
|
504
|
-
| 含逗號、空白、引號 | 用 `'…'` 或 `"…"` 包住 | fossil 的清單以空白與逗號分隔 |
|
|
505
|
-
|
|
506
|
-
真實輸出:
|
|
507
|
-
|
|
508
|
-
```
|
|
509
|
-
Converted 5 rules from .gitignore into 7 ignore-glob patterns.
|
|
510
|
-
|
|
511
|
-
node_modules
|
|
512
|
-
*/node_modules
|
|
513
|
-
*.log
|
|
514
|
-
doc/gen
|
|
515
|
-
doc/*/gen
|
|
516
|
-
dist
|
|
517
|
-
*/dist
|
|
518
|
-
|
|
519
|
-
NOTE: `**` in doc/**/gen expanded to 2 patterns.
|
|
520
|
-
NOTE: negation !keep.log skipped: ignore-glob has no negation, so the path stays visible.
|
|
521
|
-
```
|
|
522
|
-
|
|
523
|
-
`write: true` 時第 2 行是 `Wrote .fossil-settings/ignore-glob.`;檔案落地後立刻生效,`fossil_extras` 不再列出被忽略的路徑。
|
|
524
|
-
|
|
525
|
-
---
|
|
526
|
-
|
|
527
|
-
### 3.17 `fossil_ls`
|
|
405
|
+
### 3.13 `fossil_ls`
|
|
528
406
|
|
|
529
407
|
```bash
|
|
530
408
|
fossil ls ?PATHS ...? [-r REV] [--age] [-v] [-t] [--hash]
|
|
@@ -551,56 +429,7 @@ $ fossil ls -r tip
|
|
|
551
429
|
a.txt
|
|
552
430
|
```
|
|
553
431
|
|
|
554
|
-
### 3.
|
|
555
|
-
|
|
556
|
-
```bash
|
|
557
|
-
fossil search [-a] [-n N] [-W WIDTH] pattern
|
|
558
|
-
```
|
|
559
|
-
|
|
560
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
561
|
-
| --- | --- | --- | --- |
|
|
562
|
-
| `pattern` | string | **必填** | 要搜尋的字詞;全部都要命中 |
|
|
563
|
-
| `all` | boolean | `false` | 輸出全部命中,而不是只給高分者(`--all`) |
|
|
564
|
-
| `limit` | number | — | 最多輸出幾筆(`-n`) |
|
|
565
|
-
| `width` | number | — | 輸出寬度,`0` 表示不折行(`-W`) |
|
|
566
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
567
|
-
|
|
568
|
-
真實輸出:
|
|
569
|
-
|
|
570
|
-
```
|
|
571
|
-
$ fossil search second
|
|
572
|
-
=== 2026-11-17 ===
|
|
573
|
-
02:24:18 [5f3e19ce7a] *CURRENT* second
|
|
574
|
-
+++ no more data (1) +++
|
|
575
|
-
```
|
|
576
|
-
|
|
577
|
-
沒有命中時 fossil 只印 `+++ no more data (0) +++` 並以 0 結束,工具改寫成 `No matches.`。
|
|
578
|
-
搜尋範圍是 timeline / event 的註解,不含檔案內容、文件或論壇文章。
|
|
579
|
-
|
|
580
|
-
### 3.19 `fossil_artifact`
|
|
581
|
-
|
|
582
|
-
```bash
|
|
583
|
-
fossil artifact <ARTIFACT-ID> [-R FILE]
|
|
584
|
-
```
|
|
585
|
-
|
|
586
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
587
|
-
| --- | --- | --- | --- |
|
|
588
|
-
| `artifact` | string | **必填** | 工件雜湊,可用唯一前綴 |
|
|
589
|
-
| `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
|
|
590
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
591
|
-
|
|
592
|
-
真實輸出(檔案版本工件):
|
|
593
|
-
|
|
594
|
-
```
|
|
595
|
-
$ fossil artifact 17995fe087b0f2ff8b60d47f4005eb1fbab7aa3bc9e3061b09f4a446a5f5dcb8
|
|
596
|
-
hi
|
|
597
|
-
more
|
|
598
|
-
```
|
|
599
|
-
|
|
600
|
-
對 check-in 的雜湊則會印出 manifest 原文(`D`/`F`/`P`/`U` 等卡片行)。
|
|
601
|
-
雜湊可由 `fossil_finfo { mode: "id" }`、`fossil_whatis` 或 `fossil_leaves` 取得。
|
|
602
|
-
|
|
603
|
-
### 3.20 `fossil_describe`
|
|
432
|
+
### 3.14 `fossil_describe`
|
|
604
433
|
|
|
605
434
|
```bash
|
|
606
435
|
fossil describe ?VERSION? [--digits N] [--dirty] [--long] [--match GLOB]
|
|
@@ -629,7 +458,7 @@ smoke-tag-0-3c24269ef1 # <標籤>-<其後提交數>-<短雜湊>
|
|
|
629
458
|
標籤打在祖先 check-in 上時同樣是 `<標籤>-<N>-<短雜湊>`;`match` 限制參與計算的標籤 glob
|
|
630
459
|
(`match: '*'` 會把 `trunk` 這類傳播標籤也算進來)。
|
|
631
460
|
|
|
632
|
-
### 3.
|
|
461
|
+
### 3.15 `fossil_archive`
|
|
633
462
|
|
|
634
463
|
```bash
|
|
635
464
|
fossil tarball <version> <outfile> [-l] [--name DIR] [-X GLOBLIST] [--include GLOBLIST]
|
|
@@ -663,7 +492,7 @@ Wrote snap.zip from tip.
|
|
|
663
492
|
|
|
664
493
|
`--name` 省略時頂層目錄名由專案名、check-in 時間與 artifact id 組成;`--include` 與 `-X` 同時命中時以排除為準。
|
|
665
494
|
|
|
666
|
-
### 3.
|
|
495
|
+
### 3.16 `fossil_unversioned`
|
|
667
496
|
|
|
668
497
|
```bash
|
|
669
498
|
fossil unversioned list|remove [--glob PATTERN] [--like PATTERN]
|
|
@@ -699,7 +528,7 @@ $ fossil unversioned cat uv-note.txt
|
|
|
699
528
|
unversioned body
|
|
700
529
|
```
|
|
701
530
|
|
|
702
|
-
### 3.
|
|
531
|
+
### 3.17 `fossil_touch`
|
|
703
532
|
|
|
704
533
|
```bash
|
|
705
534
|
fossil touch [--now|-c|--checkin|-C|--checkout] [-g GLOBS] [-G] [-v] [-n] [-q] [FILES...]
|
|
@@ -719,7 +548,7 @@ fossil touch [--now|-c|--checkin|-C|--checkout] [-g GLOBS] [-G] [-v] [-n] [-q] [
|
|
|
719
548
|
Fossil 用檔案大小與 mtime 判斷是否變更,所以在同一個時間戳內改檔案可能被忽略;`fossil_touch { mode: "now" }`
|
|
720
549
|
強制重新掃描。指令本身沒有輸出。
|
|
721
550
|
|
|
722
|
-
### 3.
|
|
551
|
+
### 3.18 `fossil_amend`
|
|
723
552
|
|
|
724
553
|
```bash
|
|
725
554
|
fossil amend <check-in> [-n] [-m COMMENT|-M FILE] [--author USER] [--date WHEN]
|
|
@@ -758,7 +587,7 @@ T +sym-smoke-tag ead8e69115b0d294ee8168d741d226ccd54fdc5eb22ff535b6a14018c66f1a0
|
|
|
758
587
|
U stellar
|
|
759
588
|
```
|
|
760
589
|
|
|
761
|
-
### 3.
|
|
590
|
+
### 3.19 `fossil_patch`
|
|
762
591
|
|
|
763
592
|
```bash
|
|
764
593
|
fossil patch create [-f] <file>
|
|
@@ -790,7 +619,7 @@ $ fossil patch diff smoke.patch
|
|
|
790
619
|
check-out 有未提交改動時 `fossil patch apply` 會以 `there are unsaved changes in the current check-out` 失敗,
|
|
791
620
|
要先 `fossil_revert` 或傳 `force: true`。
|
|
792
621
|
|
|
793
|
-
### 3.
|
|
622
|
+
### 3.20 `fossil_bisect`
|
|
794
623
|
|
|
795
624
|
```bash
|
|
796
625
|
fossil bisect good|bad|skip [<version>]
|
|
@@ -824,39 +653,6 @@ $ fossil bisect chart
|
|
|
824
653
|
|
|
825
654
|
`reset` 清掉整段 bisect 記錄,之後 `next` 才會重新從兩端算起點。
|
|
826
655
|
|
|
827
|
-
### 3.27 `fossil_sql`
|
|
828
|
-
|
|
829
|
-
```bash
|
|
830
|
-
fossil sql --readonly [-R FILE] -json "<query>"
|
|
831
|
-
fossil sql --readonly --no-repository FILE -json "<query>"
|
|
832
|
-
```
|
|
833
|
-
|
|
834
|
-
| 參數 | 類型 | 必填/預設 | 說明 |
|
|
835
|
-
| --- | --- | --- | --- |
|
|
836
|
-
| `query` | string | **必填** | 以 `SELECT` / `WITH` / `PRAGMA` / `EXPLAIN` 開頭的語句;`LIMIT` 寫在 SQL 裡 |
|
|
837
|
-
| `repository` | string | check-out 的倉庫 | 直接指定倉庫檔(`-R`),例如 `repos/app.fossil`;可在沒有 check-out 的目錄查詢 |
|
|
838
|
-
| `database` | string | — | 查一般的 SQLite 檔而非倉庫(`--no-repository`),例如 chat 存檔 |
|
|
839
|
-
| `workspace` | string | 見 admin §2.1 | — |
|
|
840
|
-
|
|
841
|
-
輸出是製表符分隔的表格,最後一行是 `N row(s).`;空結果印 `No rows.`。查詢以 `--readonly` 開啟,
|
|
842
|
-
`fossil sql` 的錯誤(例如 `no such column: name`)由工具轉成 `isError`。
|
|
843
|
-
|
|
844
|
-
真實輸出:
|
|
845
|
-
|
|
846
|
-
```
|
|
847
|
-
$ fossil sql --readonly -json "SELECT count(*) AS n FROM event"
|
|
848
|
-
n
|
|
849
|
-
2
|
|
850
|
-
|
|
851
|
-
1 row(s).
|
|
852
|
-
```
|
|
853
|
-
|
|
854
|
-
以 `DELETE` / `UPDATE` 開頭的語句在交給 fossil 前就被拒絕:
|
|
855
|
-
|
|
856
|
-
```
|
|
857
|
-
ERROR: the query must start with SELECT, WITH, PRAGMA or EXPLAIN.
|
|
858
|
-
```
|
|
859
|
-
|
|
860
656
|
## 4. 暫存與提交
|
|
861
657
|
|
|
862
658
|
### 4.1 `fossil_add`
|
|
@@ -1185,7 +981,7 @@ fossil_timeline { limit: 5 }
|
|
|
1185
981
|
|
|
1186
982
|
## 7. 已知邊界
|
|
1187
983
|
|
|
1188
|
-
1. **`fossil_status` 的未跟蹤檔案來自第二條命令**(`fossil extra
|
|
984
|
+
1. **`fossil_status` 的未跟蹤檔案來自第二條命令**(`fossil extra`)。單條失敗時該段渲染成
|
|
1189
985
|
`--- STATUS ---` + `ERROR: …`,但 `isError` 只為 `true` 當**兩段都失敗**(`renderSections` 的規則)。
|
|
1190
986
|
2. **`commit` 自動回答兩個互動提示**:未知檔名參數的 `continue (y/N)?` 答 `y`,內容警告的
|
|
1191
987
|
`Commit anyhow (a=all/y/N)?` 答 `a`(all);二進位制檔案與忽略規則的衝突一律照交。
|
|
@@ -1195,11 +991,8 @@ fossil_timeline { limit: 5 }
|
|
|
1195
991
|
5. **`tag cancel` / `branch new` 的預設值**(`tip` / `current`)是工具補的,不是 fossil 原生預設。
|
|
1196
992
|
6. **版本表示式**只支援 fossil 自身語法(`tip`、雜湊前綴、`branch:name` 等);`tip-1` 這類寫法會失敗。
|
|
1197
993
|
7. **路徑原樣傳遞**:以 `-` 開頭的檔名需要 `./` 前綴。
|
|
1198
|
-
8.
|
|
1199
|
-
9. **`
|
|
1200
|
-
(`src/*.o`)在 fossil 會連更深的路徑一起匹配。
|
|
1201
|
-
10. **`ignore-glob` 沒有否定**:`!` 開頭的行只能略過並在 `NOTE:` 說明,被 git 重新納入的檔案在 fossil 仍被忽略。
|
|
1202
|
-
11. **`fossil_mv` 的 `--hard`**:目標位置已有未管理的同名檔案時,該檔案被覆寫;來源在先前
|
|
994
|
+
8. **帶 `repository` 的工具讀倉庫檔,其餘要求已 open 的 check-out**;只有倉庫檔案(.fossil)時用 admin 的 `fossil_open`。
|
|
995
|
+
9. **`fossil_mv` 的 `--hard`**:目標位置已有未管理的同名檔案時,該檔案被覆寫;來源在先前
|
|
1203
996
|
`hard: false` 只記錄 RENAME 後已不在磁碟上,`--hard` 會以 `cannot open "…" for reading` 失敗,
|
|
1204
997
|
但 RENAME 事件已寫入。
|
|
1205
998
|
|
|
@@ -1209,8 +1002,8 @@ fossil_timeline { limit: 5 }
|
|
|
1209
1002
|
|
|
1210
1003
|
| 檔案 | 內容 |
|
|
1211
1004
|
| --- | --- |
|
|
1212
|
-
| `src/tools/version-control.ts` |
|
|
1005
|
+
| `src/tools/version-control.ts` | 33 個工具的註冊、參數 schema、argv 拼裝、`renderSections` 分節輸出 |
|
|
1213
1006
|
| `src/tools/common.ts` | `workspaceParam`、`flag()`、`clean()`、`pushOption()` 等共享片段 |
|
|
1214
1007
|
| `src/core/fossil.ts` | `runFossil`(spawn + 超時 + 輸出截斷)、`renderOutcome`、`formatFailure` |
|
|
1215
1008
|
| `src/config.ts` | `FOSSIL_BIN`、`FOSSIL_TIMEOUT_MS`、`FOSSIL_MAX_CAPTURE_BYTES` 等 |
|
|
1216
|
-
| `src/capabilities.ts` | 能力註冊表(`v` → 本檔案
|
|
1009
|
+
| `src/capabilities.ts` | 能力註冊表(`v` → 本檔案 33 個工具) |
|
package/docs/wiki.md
CHANGED
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stellar_ai/mcp_fossil_scm",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "Capability-scoped MCP server for Fossil SCM: Admin,
|
|
3
|
+
"version": "0.2.2",
|
|
4
|
+
"description": "Capability-scoped MCP server for Fossil SCM: Admin, Utils, VCS, Tickets, Chat, Forum and Wiki",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|