@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/docs/vcs.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # VCS 能力(`-c v`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後。所有行為都在 fossil 2.21 上實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.2` 及之後。所有行為都在 fossil 2.21 上實測。
4
4
 
5
- `-c v` 註冊 40 個工具;要連 admin 一起用 `-c av`。
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` 預覽。`fossil_cat`/`fossil_info`/`fossil_descendants`/`fossil_ls`/`fossil_artifact`/`fossil_timeline` 與 `fossil_sql` 可用 `repository` 直接讀倉庫檔,其餘工具都需要 check-out(見 §2)。
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 `fossil_cat`
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.5 `fossil_extras`
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.6 `fossil_timeline`
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.7 `fossil_info`
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.8 `fossil_changes`
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.9 `fossil_annotate`
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.10 `fossil_grep`
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.13 `fossil_leaves`
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.14 `fossil_descendants`
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.15 `fossil_unpublished`
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.16 `fossil_ignore_from_gitignore`
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.18 `fossil_search`
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.21 `fossil_archive`
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.22 `fossil_unversioned`
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.23 `fossil_touch`
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.24 `fossil_amend`
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.25 `fossil_patch`
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.26 `fossil_bisect`
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. **除 `fossil_sql` 可用 `repository` 直接查詢外,工具都要求已 open 的 check-out**;只有倉庫檔案(.fossil)時用 admin 的 `fossil_open`。
1199
- 9. **`fossil_ignore_from_gitignore` 沿用 fossil 的深度語意**:git 的 `*` 不跨 `/`,fossil 的跨,所以含斜線的樣式
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` | 40 個工具的註冊、參數 schema、argv 拼裝、`renderSections` 分節輸出 |
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` → 本檔案 40 個工具) |
1009
+ | `src/capabilities.ts` | 能力註冊表(`v` → 本檔案 33 個工具) |
package/docs/wiki.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Wiki 能力(`-c w`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後,fossil 2.21 實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.2` 及之後,fossil 2.21 實測。
4
4
 
5
5
  `-c w` 註冊 3 個工具:`fossil_wiki_ls` / `fossil_wiki_read` / `fossil_wiki_write`。
6
6
  (組合啟用:`-c aw`。)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@stellar_ai/mcp_fossil_scm",
3
- "version": "0.2.1",
4
- "description": "Capability-scoped MCP server for Fossil SCM: Admin, VCS, Forum, Tickets, Wiki and Chat",
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": {