@stellar_ai/mcp_fossil_scm 0.2.0 → 0.2.1

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 CHANGED
@@ -181,8 +181,9 @@ fossil-scm -c avf --workspace /path/to/workspace
181
181
  ```bash
182
182
  pnpm build # 編譯 src -> dist(prebuild 會先清空 dist)
183
183
  pnpm typecheck # tsc(tsconfig.json:strict、erasable syntax only、noEmit)
184
- pnpm smoke # 端到端 stdio 測試(各首字母、組合、env 選擇、錯誤輸入)
185
- pnpm test # typecheck + build + smoke
184
+ pnpm make:testbed # 重建 testbed/(demo 倉庫 + check-out)
185
+ pnpm smoke # 端到端 stdio 測試(在 testbed/run 裡跑,涵蓋各首字母、組合、env 選擇、錯誤輸入)
186
+ pnpm test # make:testbed + typecheck + build + check:docs + smoke
186
187
  pnpm pack # prepack 重建 dist 後產出 tarball
187
188
  ```
188
189
 
package/dist/config.js CHANGED
@@ -9,7 +9,7 @@ function readPositiveInt(name, fallback) {
9
9
  }
10
10
  /** Server/product name. The fossil *binary* stays `fossil` (see FOSSIL_BIN). */
11
11
  export const SERVER_NAME = 'fossil-scm';
12
- export const SERVER_VERSION = '0.2.0';
12
+ export const SERVER_VERSION = '0.2.1';
13
13
  /**
14
14
  * The Fossil executable. The command is named `fossil`; only the server/product
15
15
  * name is written `fossil-scm`. Override with FOSSIL_BIN (e.g. a full path on Windows).
@@ -7,7 +7,7 @@ import { clean, workspaceParam, flag, pushOption } from './common.js';
7
7
  const repoPathParam = z
8
8
  .string()
9
9
  .min(1)
10
- .describe('Repository database file. Pass an absolute path, or a path relative to the workspace (no `.fossil` suffix is added).');
10
+ .describe('Repository database file, e.g. `repos/app.fossil`. Absolute paths are used verbatim; relative paths resolve against the workspace. Include the `.fossil` name.');
11
11
  const revealSecretsParam = z
12
12
  .boolean()
13
13
  .default(false)
@@ -72,6 +72,7 @@ export function registerAdminTools(server) {
72
72
  .optional()
73
73
  .describe('Repository file to copy settings from (--template).'),
74
74
  project_desc: z.string().min(1).optional().describe('Project description stored in the repository (--project-desc).'),
75
+ sha1: flag('Use SHA1 instead of SHA3-256 for artifact names (--sha1).'),
75
76
  date_override: z
76
77
  .string()
77
78
  .min(1)
@@ -80,7 +81,7 @@ export function registerAdminTools(server) {
80
81
  reveal_secrets: revealSecretsParam,
81
82
  workspace: workspaceParam,
82
83
  }),
83
- }, async ({ repository, project_name, admin_user, template, project_desc, date_override, reveal_secrets, workspace }) => {
84
+ }, async ({ repository, project_name, admin_user, template, project_desc, sha1, date_override, reveal_secrets, workspace }) => {
84
85
  const workspaceDir = resolveWorkspace(workspace);
85
86
  const repoPath = resolveRepoPath(repository, workspaceDir);
86
87
  const finalProjectName = clean(project_name) ?? (path.basename(workspaceDir) || 'project');
@@ -90,6 +91,8 @@ export function registerAdminTools(server) {
90
91
  pushOption(args, '-A', admin_user);
91
92
  pushOption(args, '--template', template);
92
93
  pushOption(args, '--project-desc', project_desc);
94
+ if (sha1)
95
+ args.push('--sha1');
93
96
  pushOption(args, '--date-override', date_override);
94
97
  const init = await runFossil(args, { workspace: workspaceDir });
95
98
  const rendered = renderOutcome(init, {
@@ -114,9 +117,15 @@ export function registerAdminTools(server) {
114
117
  .min(1)
115
118
  .optional()
116
119
  .describe('Check-out directory passed as --workdir DIR (relative paths resolve against the workspace).'),
120
+ repodir: z
121
+ .string()
122
+ .min(1)
123
+ .optional()
124
+ .describe('Directory that holds the clone when `repository` is a URI (--repodir DIR).'),
125
+ verbose: flag('Print the clone progress when `repository` is a URI (--verbose).'),
117
126
  workspace: workspaceParam,
118
127
  }),
119
- }, async ({ repository, force, keep, nested, empty, no_sync, set_mtime, force_missing, workdir, workspace }) => {
128
+ }, async ({ repository, force, keep, nested, empty, no_sync, set_mtime, force_missing, workdir, repodir, verbose, workspace }) => {
120
129
  const workspaceDir = resolveWorkspace(workspace);
121
130
  const repoPath = resolveRepoPath(repository, workspaceDir);
122
131
  const args = ['open', repoPath];
@@ -134,6 +143,9 @@ export function registerAdminTools(server) {
134
143
  args.push('--setmtime');
135
144
  if (force_missing)
136
145
  args.push('--force-missing');
146
+ if (verbose)
147
+ args.push('--verbose');
148
+ pushOption(args, '--repodir', repodir);
137
149
  const requestedWorkdir = clean(workdir);
138
150
  const checkoutDir = requestedWorkdir ? path.resolve(workspaceDir, requestedWorkdir) : workspaceDir;
139
151
  if (requestedWorkdir)
@@ -173,11 +185,19 @@ export function registerAdminTools(server) {
173
185
  target_file: z
174
186
  .string()
175
187
  .min(1)
176
- .describe('Destination .fossil file (relative paths resolve against the workspace). Missing parent folders are created.'),
188
+ .describe('Destination repository database file, e.g. `repos/app.fossil` (relative paths resolve against the workspace). Missing parent folders are created.'),
177
189
  http_proxy: z.string().min(1).optional().describe('HTTP proxy URL passed as --proxy.'),
178
190
  httpauth: z.string().min(1).optional().describe('HTTP Basic credentials "user:pass" (-B).'),
179
191
  ssl_identity: z.string().min(1).optional().describe('SSL client certificate file (--ssl-identity).'),
180
192
  ssh_command: z.string().min(1).optional().describe('Command used as the ssh client (-c).'),
193
+ transport_command: z
194
+ .string()
195
+ .min(1)
196
+ .optional()
197
+ .describe('External command that moves messages to the server and back (--transport-command).'),
198
+ no_compress: flag('Omit the extra delta compression step (--nocompress).'),
199
+ no_open: flag('Clone only, leaving no check-out (--no-open).'),
200
+ save_http_password: flag('Remember the HTTP password instead of asking for it (--save-http-password).'),
181
201
  workdir: z.string().min(1).optional().describe('Also open a check-out in this directory (--workdir).'),
182
202
  nested: flag('Clone a repository inside an already opened check-out (--nested).'),
183
203
  once: flag('Use the URI once and forget it (--once).'),
@@ -188,7 +208,7 @@ export function registerAdminTools(server) {
188
208
  reveal_secrets: revealSecretsParam,
189
209
  workspace: workspaceParam,
190
210
  }),
191
- }, async ({ repository_uri, target_file, http_proxy, httpauth, ssl_identity, ssh_command, workdir, nested, once, private: privateBranches, admin_user, unversioned, verbose, reveal_secrets, workspace, }) => {
211
+ }, async ({ repository_uri, target_file, http_proxy, httpauth, ssl_identity, ssh_command, transport_command, no_compress, no_open, save_http_password, workdir, nested, once, private: privateBranches, admin_user, unversioned, verbose, reveal_secrets, workspace, }) => {
192
212
  const workspaceDir = resolveWorkspace(workspace);
193
213
  const targetFile = path.resolve(workspaceDir, target_file);
194
214
  await mkdir(path.dirname(targetFile), { recursive: true });
@@ -197,7 +217,14 @@ export function registerAdminTools(server) {
197
217
  pushOption(args, '--httpauth', httpauth);
198
218
  pushOption(args, '--ssl-identity', ssl_identity);
199
219
  pushOption(args, '--ssh-command', ssh_command);
220
+ pushOption(args, '--transport-command', transport_command);
200
221
  pushOption(args, '--workdir', workdir);
222
+ if (no_compress)
223
+ args.push('--nocompress');
224
+ if (no_open)
225
+ args.push('--no-open');
226
+ if (save_http_password)
227
+ args.push('--save-http-password');
201
228
  pushOption(args, '--admin-user', admin_user);
202
229
  if (nested)
203
230
  args.push('--nested');
@@ -379,6 +406,16 @@ export function registerAdminTools(server) {
379
406
  proxy: z.string().min(1).optional().describe('HTTP proxy URL (--proxy).'),
380
407
  httpauth: z.string().min(1).optional().describe('Credentials for the simple HTTP auth protocol, as USER:PASS (--httpauth).'),
381
408
  ssl_identity: z.string().min(1).optional().describe('Client SSL identity file when the remote asks for one (--ssl-identity).'),
409
+ transport_command: z
410
+ .string()
411
+ .min(1)
412
+ .optional()
413
+ .describe('External command that moves messages to the server and back (--transport-command).'),
414
+ no_http_compression: flag('Send HTTP traffic uncompressed (--no-http-compression).'),
415
+ ipv4: flag('Use IPv4 for the connection (--ipv4).'),
416
+ repository: repoPathParam
417
+ .optional()
418
+ .describe('Repository database file to work on (-R), e.g. `repos/app.fossil`; omit to use the repository of the check-out.'),
382
419
  reveal_secrets: revealSecretsParam,
383
420
  workspace: workspaceParam,
384
421
  };
@@ -400,6 +437,12 @@ export function registerAdminTools(server) {
400
437
  pushOption(args, '--proxy', options.proxy);
401
438
  pushOption(args, '--httpauth', options.httpauth);
402
439
  pushOption(args, '--ssl-identity', options.ssl_identity);
440
+ pushOption(args, '--transport-command', options.transport_command);
441
+ pushOption(args, '-R', options.repository);
442
+ if (options.no_http_compression)
443
+ args.push('--no-http-compression');
444
+ if (options.ipv4)
445
+ args.push('--ipv4');
403
446
  return args;
404
447
  };
405
448
  server.registerTool('fossil_push', {
@@ -458,7 +501,7 @@ export function registerAdminTools(server) {
458
501
  inputSchema: z.object({
459
502
  repository: repoPathParam
460
503
  .optional()
461
- .describe('Repository database file; omit to rebuild the repository of the open check-out.'),
504
+ .describe('Repository database file, e.g. `repos/app.fossil`; omit to rebuild the repository of the open check-out.'),
462
505
  ifneeded: flag('Rebuild only when the schema version would change (--ifneeded).'),
463
506
  compress: flag('Shrink the database while rebuilding (--compress).'),
464
507
  compress_only: flag('Only run the compression step (--compress-only).'),
@@ -524,6 +567,9 @@ export function registerAdminTools(server) {
524
567
  .describe('Configuration area; required by export, pull, push and reset.'),
525
568
  file: z.string().min(1).optional().describe('File to read or write; required by export, import and merge.'),
526
569
  url: z.string().min(1).optional().describe('Remote repository for pull/push; the default remote when omitted.'),
570
+ repository: repoPathParam
571
+ .optional()
572
+ .describe('Repository database file to configure (-R), e.g. `repos/app.fossil`; omit to use the repository of the check-out.'),
527
573
  overwrite: flag('Replace local settings with the ones received from the remote (--overwrite).'),
528
574
  workspace: workspaceParam,
529
575
  }),
@@ -560,6 +606,7 @@ export function registerAdminTools(server) {
560
606
  if (input.overwrite)
561
607
  args.push('--overwrite');
562
608
  }
609
+ pushOption(args, '-R', input.repository);
563
610
  const timeoutMs = input.action === 'pull' || input.action === 'push' ? NETWORK_TIMEOUT_MS : undefined;
564
611
  return renderOutcome(await runFossil(args, { workspace: input.workspace, timeoutMs }));
565
612
  });
@@ -5,6 +5,11 @@ import { renderOutcome, renderSections, resolveWorkspace, runFossil, truncateOut
5
5
  import { convertGitignore, renderGlobFile } from '../core/gitignore.js';
6
6
  import { runSql } from '../core/sql.js';
7
7
  import { clean, workspaceParam, filesParam, flag, pushOption } from './common.js';
8
+ const repoOptionParam = z
9
+ .string()
10
+ .min(1)
11
+ .optional()
12
+ .describe('Repository database file to read instead of the open check-out, e.g. `repos/app.fossil` (-R). Absolute paths are used verbatim; relative paths resolve against the workspace.');
8
13
  /** Version-control tools: status, diff, history, commit, branch and workspace state. */
9
14
  /** Join glob patterns into one fossil GLOBLIST argument, quoting patterns that hold a comma. */
10
15
  function globList(patterns) {
@@ -15,8 +20,7 @@ function globList(patterns) {
15
20
  export function registerVersionControlTools(server) {
16
21
  server.registerTool('fossil_status', {
17
22
  title: 'Status',
18
- description: 'Show the change set of the check-out (modified/added/deleted files) plus the list of untracked files. ' +
19
- 'Both queries run in parallel.',
23
+ description: 'Show the change set of the check-out (modified/added/deleted files) plus the list of untracked files.',
20
24
  inputSchema: z.object({
21
25
  dotfiles: flag('Include dot-files in the change and untracked lists (--dotfiles).'),
22
26
  brief: flag('List only the changed file names (fossil changes).'),
@@ -85,10 +89,10 @@ export function registerVersionControlTools(server) {
85
89
  extraArgs.push('--abs-paths');
86
90
  if (rel_paths)
87
91
  extraArgs.push('--rel-paths');
88
- const [status, extra] = await Promise.all([
89
- runFossil(args, { workspace }),
90
- runFossil(extraArgs, { workspace }),
91
- ]);
92
+ // Sequential: two fossil processes on the same repository can collide on
93
+ // the SQLite write lock ("database is locked").
94
+ const status = await runFossil(args, { workspace });
95
+ const extra = await runFossil(extraArgs, { workspace });
92
96
  return renderSections([
93
97
  { title: 'STATUS', outcome: status },
94
98
  { title: 'UNTRACKED (EXTRA)', outcome: extra },
@@ -111,6 +115,8 @@ export function registerVersionControlTools(server) {
111
115
  undo: flag('Diff against the undo buffer (--undo).'),
112
116
  ignore_whitespace: flag('Ignore whitespace-only changes (-w).'),
113
117
  ignore_trailing_space: flag('Ignore changes to end-of-line whitespace (-Z).'),
118
+ strip_trailing_cr: flag('Treat CR at the end of each line as insignificant (--strip-trailing-cr).'),
119
+ new_file: flag('Treat added files as if they already existed with empty content (-N).'),
114
120
  internal: flag('Use the internal diff logic (-i).'),
115
121
  unified: flag('Print a unified diff (--unified).'),
116
122
  versions_header: flag('Show the compared versions in the diff header (-h).'),
@@ -119,7 +125,7 @@ export function registerVersionControlTools(server) {
119
125
  workspace: workspaceParam,
120
126
  }),
121
127
  annotations: { readOnlyHint: true },
122
- }, async ({ from_version, to_version, files, branch, checkin, brief, stat, context: contextLines, side_by_side, verbose, undo, ignore_whitespace, ignore_trailing_space, internal, unified, versions_header, json, width, workspace, }) => {
128
+ }, async ({ from_version, to_version, files, branch, checkin, brief, stat, context: contextLines, side_by_side, verbose, undo, ignore_whitespace, ignore_trailing_space, strip_trailing_cr, new_file, internal, unified, versions_header, json, width, workspace, }) => {
123
129
  const args = ['diff'];
124
130
  pushOption(args, '--from', from_version);
125
131
  pushOption(args, '--to', to_version);
@@ -141,6 +147,10 @@ export function registerVersionControlTools(server) {
141
147
  args.push('-w');
142
148
  if (ignore_trailing_space)
143
149
  args.push('-Z');
150
+ if (strip_trailing_cr)
151
+ args.push('--strip-trailing-cr');
152
+ if (new_file)
153
+ args.push('-N');
144
154
  if (internal)
145
155
  args.push('-i');
146
156
  if (unified)
@@ -161,11 +171,13 @@ export function registerVersionControlTools(server) {
161
171
  inputSchema: z.object({
162
172
  file: z.string().min(1).describe('File path/name inside the repository.'),
163
173
  revision: z.string().min(1).optional().describe('Check-in or revision (-r). Defaults to the checked-out version.'),
174
+ repository: repoOptionParam,
164
175
  workspace: workspaceParam,
165
176
  }),
166
177
  annotations: { readOnlyHint: true },
167
- }, async ({ file, revision, workspace }) => {
178
+ }, async ({ file, revision, repository, workspace }) => {
168
179
  const args = ['cat', file];
180
+ pushOption(args, '-R', repository);
169
181
  pushOption(args, '-r', revision);
170
182
  return renderOutcome(await runFossil(args, { workspace }));
171
183
  });
@@ -385,6 +397,20 @@ export function registerVersionControlTools(server) {
385
397
  branch: z.string().min(1).optional().describe('Place the new check-in on this branch (--branch).'),
386
398
  no_warnings: flag('Omit content warnings (--no-warnings).'),
387
399
  allow_empty: flag('Allow a check-in with no file changes (--allow-empty).'),
400
+ allow_fork: flag('Allow the check-in to fork the branch (--allow-fork).'),
401
+ allow_conflict: flag('Commit with unresolved merge conflicts (--allow-conflict).'),
402
+ allow_older: flag('Store a timestamp older than the ancestor check-in (--allow-older).'),
403
+ integrate: flag('Close every branch merged into this one (--integrate).'),
404
+ private_checkin: flag('Keep the check-in out of pushes (--private).'),
405
+ hash: flag('Detect file changes by hashing instead of size+mtime (--hash).'),
406
+ no_verify: flag('Skip the before-commit hooks (--no-verify).'),
407
+ dry_run: flag('Show what would be committed without writing (--dry-run).'),
408
+ message_file: z
409
+ .string()
410
+ .min(1)
411
+ .optional()
412
+ .describe('Read the commit message from this file (-M); takes precedence over `message`.'),
413
+ mimetype: z.string().min(1).optional().describe('Mimetype of the commit message (--mimetype).'),
388
414
  user_override: z.string().min(1).optional().describe('Record this login as the author (--user-override).'),
389
415
  tags: z.array(z.string().min(1)).optional().describe('Tags to attach to the new check-in (--tag).'),
390
416
  close: flag('Close the branch being committed (--close).'),
@@ -396,13 +422,31 @@ export function registerVersionControlTools(server) {
396
422
  .describe('Check-in timestamp to store instead of now, e.g. "2026-11-17 12:00:00" (--date-override).'),
397
423
  workspace: workspaceParam,
398
424
  }),
399
- }, async ({ message, files, branch, no_warnings, allow_empty, user_override, tags, close, bgcolor, date_override, workspace }) => {
425
+ }, async ({ message, files, branch, no_warnings, allow_empty, allow_fork, allow_conflict, allow_older, integrate, private_checkin, hash, no_verify, dry_run, message_file, mimetype, user_override, tags, close, bgcolor, date_override, workspace }) => {
400
426
  const args = ['commit', '-m', message];
401
- pushOption(args, '--branch', branch);
427
+ pushOption(args, '-M', message_file);
428
+ pushOption(args, '--mimetype', mimetype);
402
429
  if (no_warnings)
403
430
  args.push('--no-warnings');
404
431
  if (allow_empty)
405
432
  args.push('--allow-empty');
433
+ if (allow_fork)
434
+ args.push('--allow-fork');
435
+ if (allow_conflict)
436
+ args.push('--allow-conflict');
437
+ if (allow_older)
438
+ args.push('--allow-older');
439
+ if (integrate)
440
+ args.push('--integrate');
441
+ if (private_checkin)
442
+ args.push('--private');
443
+ if (hash)
444
+ args.push('--hash');
445
+ if (no_verify)
446
+ args.push('--no-verify');
447
+ if (dry_run)
448
+ args.push('--dry-run');
449
+ pushOption(args, '--branch', branch);
406
450
  if (close)
407
451
  args.push('--close');
408
452
  pushOption(args, '--bgcolor', bgcolor);
@@ -577,11 +621,16 @@ export function registerVersionControlTools(server) {
577
621
  temp: flag('Remove only Fossil-generated temporary files (--temp).'),
578
622
  dirs_only: flag('Remove empty directories only, no files (--dirsonly).'),
579
623
  empty_dirs: flag('Remove empty directories after deleting files (--emptydirs).'),
624
+ keep: z.string().min(1).optional().describe('Comma-separated globs of files to spare beyond ignore-glob (--keep).'),
625
+ disable_undo: flag('Do not keep a copy that `fossil undo` can restore (--disable-undo).'),
626
+ all_checkouts: flag('Apply the empty-directory scan to every open check-out (--allckouts).'),
627
+ prompt: flag('Ask before deleting each file (-i).'),
628
+ case_sensitive: z.boolean().optional().describe('Override the case-sensitive setting (--case-sensitive).'),
580
629
  verbose: flag('Report each file as it is removed (-v).'),
581
630
  workspace: workspaceParam,
582
631
  }),
583
632
  annotations: { destructiveHint: true },
584
- }, async ({ all_files, dry_run, dotfiles, ignore, clean: cleanGlob, verily, temp, dirs_only, empty_dirs, verbose, workspace }) => {
633
+ }, async ({ all_files, dry_run, dotfiles, ignore, clean: cleanGlob, verily, temp, dirs_only, empty_dirs, keep, disable_undo, all_checkouts, prompt, case_sensitive, verbose, workspace }) => {
585
634
  const args = ['clean'];
586
635
  if (dry_run)
587
636
  args.push('-n');
@@ -601,6 +650,16 @@ export function registerVersionControlTools(server) {
601
650
  args.push('--dirsonly');
602
651
  if (empty_dirs)
603
652
  args.push('--emptydirs');
653
+ if (keep)
654
+ args.push('--keep', keep);
655
+ if (disable_undo)
656
+ args.push('--disable-undo');
657
+ if (all_checkouts)
658
+ args.push('--allckouts');
659
+ if (prompt)
660
+ args.push('-i');
661
+ if (case_sensitive !== undefined)
662
+ args.push('--case-sensitive', case_sensitive ? '1' : '0');
604
663
  if (verbose)
605
664
  args.push('-v');
606
665
  return renderOutcome(await runFossil(args, { workspace }), { emptyText: 'Nothing to clean.' });
@@ -631,11 +690,13 @@ export function registerVersionControlTools(server) {
631
690
  verbose: flag('List the files changed by each check-in (-v).'),
632
691
  offset: z.number().int().min(0).optional().describe('Skip this many entries before reporting (--offset).'),
633
692
  width: z.number().int().min(20).optional().describe('Width of the output lines (-W).'),
693
+ repository: repoOptionParam,
634
694
  workspace: workspaceParam,
635
695
  }),
636
696
  annotations: { readOnlyHint: true },
637
- }, async ({ limit, path: targetPath, type_filter, branch, current_branch, when, checkin, format, verbose, offset, width, workspace, }) => {
697
+ }, async ({ limit, path: targetPath, type_filter, branch, current_branch, when, checkin, format, verbose, offset, width, repository, workspace, }) => {
638
698
  const args = ['timeline', '-n', String(limit ?? 20)];
699
+ pushOption(args, '-R', repository);
639
700
  pushOption(args, '-p', targetPath);
640
701
  pushOption(args, '-t', type_filter);
641
702
  pushOption(args, '-b', branch);
@@ -660,12 +721,14 @@ export function registerVersionControlTools(server) {
660
721
  inputSchema: z.object({
661
722
  target: z.string().optional().describe('File name, check-in hash or branch. Omit for general repository info.'),
662
723
  verbose: flag('Show extra details, such as the SQLite version and repository size (-v).'),
724
+ repository: repoOptionParam,
663
725
  workspace: workspaceParam,
664
726
  }),
665
727
  annotations: { readOnlyHint: true },
666
- }, async ({ target, verbose, workspace }) => {
728
+ }, async ({ target, verbose, repository, workspace }) => {
667
729
  const targetValue = clean(target);
668
730
  const args = targetValue ? ['info', targetValue] : ['info'];
731
+ pushOption(args, '-R', repository);
669
732
  if (verbose)
670
733
  args.push('-v');
671
734
  return renderOutcome(await runFossil(args, { workspace }));
@@ -803,11 +866,13 @@ export function registerVersionControlTools(server) {
803
866
  set_mtime: flag('Stamp every file with its last-check-in time (--setmtime).'),
804
867
  keep_merge_files: flag('Keep the temporary merge files (-K).'),
805
868
  force_missing: flag('Update even when content of one side is missing (--force-missing).'),
869
+ case_sensitive: z.boolean().optional().describe('Override the case-sensitive setting (--case-sensitive).'),
870
+ width: z.number().int().nonnegative().optional().describe('Output width in columns (-W).'),
806
871
  verbose: flag('Report the state of every file (-v).'),
807
872
  workspace: workspaceParam,
808
873
  }),
809
874
  annotations: { destructiveHint: true },
810
- }, async ({ target, latest, dry_run, no_sync, set_mtime, keep_merge_files, force_missing, verbose, workspace }) => {
875
+ }, async ({ target, latest, dry_run, no_sync, set_mtime, keep_merge_files, force_missing, case_sensitive, width, verbose, workspace }) => {
811
876
  const args = ['update'];
812
877
  if (latest)
813
878
  args.push('--latest');
@@ -821,6 +886,10 @@ export function registerVersionControlTools(server) {
821
886
  args.push('-K');
822
887
  if (force_missing)
823
888
  args.push('--force-missing');
889
+ if (case_sensitive !== undefined)
890
+ args.push('--case-sensitive', case_sensitive ? '1' : '0');
891
+ if (width !== undefined)
892
+ args.push('-W', String(width));
824
893
  if (verbose)
825
894
  args.push('-v');
826
895
  const targetValue = clean(target);
@@ -858,6 +927,9 @@ export function registerVersionControlTools(server) {
858
927
  all: flag('Every managed file, i.e. all change types (--all).'),
859
928
  classify: flag('Start each line with the change type (--classify).'),
860
929
  no_merge: flag('Hide merge contributors (--no-merge).'),
930
+ ignore: z.string().min(1).optional().describe('Ignore files matching these globs (--ignore).'),
931
+ no_classify: flag('Skip the per-file change type (--no-classify).'),
932
+ merge: flag('Show only files with merge conflict markers (--merge).'),
861
933
  hash: flag('Verify file status by hashing instead of size and mtime (--hash).'),
862
934
  header: flag('Print the repository name above a non-empty report (--header).'),
863
935
  verbose: flag('Print "(none)" when the report is empty (-v).'),
@@ -867,7 +939,7 @@ export function registerVersionControlTools(server) {
867
939
  workspace: workspaceParam,
868
940
  }),
869
941
  annotations: { readOnlyHint: true },
870
- }, async ({ files, edited, updated, added, deleted, renamed, conflict, meta, changed, missing, unchanged, extra, differ, all, classify, no_merge, hash, header, verbose, dotfiles, absolute_paths, relative_paths, workspace, }) => {
942
+ }, async ({ files, edited, updated, added, deleted, renamed, conflict, meta, changed, missing, unchanged, extra, differ, all, classify, no_merge, ignore, no_classify, merge, hash, header, verbose, dotfiles, absolute_paths, relative_paths, workspace, }) => {
871
943
  const args = ['changes'];
872
944
  const filters = [
873
945
  [edited, '--edited'],
@@ -891,6 +963,11 @@ export function registerVersionControlTools(server) {
891
963
  args.push('--classify');
892
964
  if (no_merge)
893
965
  args.push('--no-merge');
966
+ pushOption(args, '--ignore', ignore);
967
+ if (no_classify)
968
+ args.push('--no-classify');
969
+ if (merge)
970
+ args.push('--merge');
894
971
  if (hash)
895
972
  args.push('--hash');
896
973
  if (header)
@@ -1023,12 +1100,13 @@ export function registerVersionControlTools(server) {
1023
1100
  all: flag('Include closed leaves as well (-a).'),
1024
1101
  closed: flag('Only closed leaves (-c).'),
1025
1102
  multiple: flag('Only branches with more than one leaf (-m).'),
1103
+ recompute: flag('Recalculate the leaves instead of reading the cache (--recompute).'),
1026
1104
  by_branch: flag('Order the output by branch name (--bybranch).'),
1027
1105
  width: z.number().int().nonnegative().optional().describe('Output width in columns (-W); 0 means one line per entry.'),
1028
1106
  workspace: workspaceParam,
1029
1107
  }),
1030
1108
  annotations: { readOnlyHint: true },
1031
- }, async ({ all, closed, multiple, by_branch, width, workspace }) => {
1109
+ }, async ({ all, closed, multiple, recompute, by_branch, width, workspace }) => {
1032
1110
  const args = ['leaves'];
1033
1111
  if (all)
1034
1112
  args.push('-a');
@@ -1036,6 +1114,8 @@ export function registerVersionControlTools(server) {
1036
1114
  args.push('-c');
1037
1115
  if (multiple)
1038
1116
  args.push('-m');
1117
+ if (recompute)
1118
+ args.push('--recompute');
1039
1119
  if (by_branch)
1040
1120
  args.push('--bybranch');
1041
1121
  if (width !== undefined)
@@ -1048,11 +1128,13 @@ export function registerVersionControlTools(server) {
1048
1128
  inputSchema: z.object({
1049
1129
  checkin: z.string().min(1).optional().describe('Check-in to start from. Omit for the check-out version.'),
1050
1130
  width: z.number().int().nonnegative().optional().describe('Output width in columns (-W); 0 means one line per entry.'),
1131
+ repository: repoOptionParam,
1051
1132
  workspace: workspaceParam,
1052
1133
  }),
1053
1134
  annotations: { readOnlyHint: true },
1054
- }, async ({ checkin, width, workspace }) => {
1135
+ }, async ({ checkin, width, repository, workspace }) => {
1055
1136
  const args = ['descendants'];
1137
+ pushOption(args, '-R', repository);
1056
1138
  const target = clean(checkin);
1057
1139
  if (target)
1058
1140
  args.push(target);
@@ -1143,11 +1225,13 @@ export function registerVersionControlTools(server) {
1143
1225
  verbose: flag('Show extra information, including change status (--verbose).'),
1144
1226
  time_order: flag('Sort by time instead of name (-t).'),
1145
1227
  hash: flag('Verify file status by hashing instead of size and mtime (--hash); adds --verbose.'),
1228
+ repository: repoOptionParam,
1146
1229
  workspace: workspaceParam,
1147
1230
  }),
1148
1231
  annotations: { readOnlyHint: true },
1149
- }, async ({ paths, revision, age, verbose, time_order, hash, workspace }) => {
1232
+ }, async ({ paths, revision, age, verbose, time_order, hash, repository, workspace }) => {
1150
1233
  const args = ['ls'];
1234
+ pushOption(args, '-R', repository);
1151
1235
  pushOption(args, '-r', revision);
1152
1236
  if (age)
1153
1237
  args.push('--age');
@@ -1193,10 +1277,11 @@ export function registerVersionControlTools(server) {
1193
1277
  description: 'Print the raw content of an artifact by its hash, such as the manifest of a check-in or the blob of a file version.',
1194
1278
  inputSchema: z.object({
1195
1279
  artifact: z.string().min(1).describe('Artifact hash, or a unique prefix of it.'),
1280
+ repository: repoOptionParam,
1196
1281
  workspace: workspaceParam,
1197
1282
  }),
1198
1283
  annotations: { readOnlyHint: true },
1199
- }, async ({ artifact, workspace }) => renderOutcome(await runFossil(['artifact', artifact], { workspace })));
1284
+ }, async ({ artifact, repository, workspace }) => renderOutcome(await runFossil(repository ? ['artifact', '-R', repository, artifact] : ['artifact', artifact], { workspace })));
1200
1285
  server.registerTool('fossil_describe', {
1201
1286
  title: 'Describe version',
1202
1287
  description: 'Describe a version as the closest non-propagating tag, the commit count since it and the short hash, or just the hash when no tag applies.',
@@ -1510,11 +1595,16 @@ export function registerVersionControlTools(server) {
1510
1595
  .string()
1511
1596
  .min(1)
1512
1597
  .optional()
1513
- .describe('Repository database to query instead of the one of the check-out (-R).'),
1598
+ .describe('Repository database file, e.g. `repos/app.fossil`, to query instead of the one of the check-out (-R).'),
1599
+ database: z
1600
+ .string()
1601
+ .min(1)
1602
+ .optional()
1603
+ .describe('Standalone SQLite file to query in place of a repository (--no-repository), e.g. a chat archive.'),
1514
1604
  workspace: workspaceParam,
1515
1605
  }),
1516
1606
  annotations: { readOnlyHint: true },
1517
- }, async ({ query, repository, workspace }) => {
1607
+ }, async ({ query, repository, database, workspace }) => {
1518
1608
  const trimmed = query.trim().replace(/;+\s*$/, '');
1519
1609
  if (!/^(select|with|pragma|explain)\b/i.test(trimmed)) {
1520
1610
  return {
@@ -1527,7 +1617,7 @@ export function registerVersionControlTools(server) {
1527
1617
  ],
1528
1618
  };
1529
1619
  }
1530
- const result = await runSql(trimmed, { workspace, readonly: true, repository });
1620
+ const result = await runSql(trimmed, { workspace, readonly: true, repository, database });
1531
1621
  if (!result.ok)
1532
1622
  return { isError: true, content: [{ type: 'text', text: result.error }] };
1533
1623
  if (result.rows.length === 0)
package/docs/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # 文件索引
2
2
 
3
3
  按能力分冊,每冊包含:能力概覽表、通用約定、逐工具的參數表與真實 argv/輸出、典型流程、已知邊界、原始碼位置。
4
- 所有內容在 fossil 2.21 + `@stellar_ai/mcp_fossil_scm@0.2.0` 上實測。
4
+ 所有內容在 fossil 2.21 + `@stellar_ai/mcp_fossil_scm@0.2.1` 上實測。
5
5
 
6
6
  | 文件 | 能力 | `-c` | 工具數 |
7
7
  | --- | --- | --- | --- |
@@ -19,7 +19,7 @@
19
19
 
20
20
  1. [admin.md](./admin.md) §2 —— `workspace` 與 `repository` 兩個概念,所有能力共用,先看這裡。
21
21
  2. [prompts.md](./prompts.md) —— 內建的 MCP 提示,把常用的多步流程寫成一段指示。
22
- 3. 然後按需跳到具體能力分冊。VCS 與內容類能力(`v/f/t/w/c`)以 check-out 為前提;`fossil_sql` 可用 `repository` 直接查詢。
22
+ 3. 然後按需跳到具體能力分冊。VCS 與內容類能力(`v/f/t/w/c`)以 check-out 為前提;只讀工具與 `fossil_sql` 可用 `repository` 直接讀倉庫檔。
23
23
 
24
24
  ## 約定速查
25
25
 
package/docs/admin.md CHANGED
@@ -3,7 +3,7 @@
3
3
  本文件對應 `src/tools/admin.ts`(實現)與 `src/core/fossil.ts`(執行器),描述 `fossil-scm` 在
4
4
  `-c a`(Admin)能力下暴露的 **11 個工具**、它們的確切行為、成功/失敗輸出形態,以及當前已知的邊界問題。
5
5
 
6
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後。
6
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後。
7
7
 
8
8
  > 執行要求:Node.js >= 20。包內是編譯後的 `dist/**/*.js`(無 source map、無 `.d.ts`)。
9
9
 
@@ -68,7 +68,7 @@ FOSSIL_WORKSPACE=/path/to/workspace fossil-scm -c a
68
68
 
69
69
  | 參數 | 類型 | 必填/預設 | 說明 |
70
70
  | --- | --- | --- | --- |
71
- | `repository` | string | **必填** | 倉庫資料庫檔案路徑 |
71
+ | `repository` | string | **必填** | 倉庫資料庫檔案路徑,例如 `repos/app.fossil` |
72
72
 
73
73
  解析規則(`resolveRepoPath`):
74
74
 
@@ -138,6 +138,7 @@ Point `workspace` (or --workspace) at a directory that exists and retry.
138
138
  | `template` | string | — | 複製設定來源的倉庫檔(`--template`) |
139
139
  | `project_desc` | string | — | 寫入倉庫的專案描述(`--project-desc`) |
140
140
  | `date_override` | string | — | 初始 check-in 的時間(`--date-override`) |
141
+ | `sha1` | boolean | `false` | 用 SHA1 而非 SHA3-256 命名 artifact(`--sha1`) |
141
142
  | `reveal_secrets` | boolean | `false` | 原樣返回 admin 初始密碼(預設脫敏為 `***`) |
142
143
  | `workspace` | string | 見 §2.1 | 命令執行目錄 / 相對路徑基準 |
143
144
 
@@ -202,6 +203,8 @@ WORKSPACE: /tmp/ws2
202
203
  | `set_mtime` | boolean | `false` | `--setmtime`:把每個檔案的時間戳設成其 check-in 時間 |
203
204
  | `force_missing` | boolean | `false` | `--force-missing`:內容缺失時仍開啟 |
204
205
  | `workdir` | string | workspace | `--workdir`;**相對路徑以 workspace 為基準**解析成絕對路徑 |
206
+ | `repodir` | string | — | `repository` 是 URL 時,clone 下來的倉庫放在這個目錄(`--repodir DIR`) |
207
+ | `verbose` | boolean | `false` | `repository` 是 URL 時印出 clone 進度(`--verbose`) |
205
208
  | `workspace` | string | 見 §2.1 | 命令執行目錄 |
206
209
 
207
210
  執行:
@@ -287,14 +290,18 @@ WORKSPACE: /tmp/adoc/ws
287
290
  | 參數 | 類型 | 必填/預設 | 說明 |
288
291
  | --- | --- | --- | --- |
289
292
  | `repository_uri` | string | **必填** | 源倉庫 URL 或本地路徑 |
290
- | `target_file` | string | **必填** | 目標 `.fossil`;**相對路徑以 workspace 為基準**,父目錄自動建立 |
293
+ | `target_file` | string | **必填** | 目標倉庫檔,例如 `repos/app.fossil`;**相對路徑以 workspace 為基準**,父目錄自動建立 |
291
294
  | `http_proxy` | string | — | 傳給 `--proxy` |
292
295
  | `httpauth` | string | — | `user:pass`,傳給 `-B` |
293
296
  | `ssl_identity` | string | — | SSL 客戶端憑證檔(`--ssl-identity`) |
294
297
  | `ssh_command` | string | — | 當作 ssh 客戶端的命令(`-c`) |
298
+ | `transport_command` | string | — | 搬運訊息到遠端再搬回來的外部命令(`--transport-command`) |
295
299
  | `workdir` | string | — | 同時在這個目錄開 check-out(`--workdir`) |
296
300
  | `admin_user` | string | — | 把這個使用者設為管理員(`-A`) |
297
301
  | `nested` / `once` / `private` / `unversioned` / `verbose` | boolean | `false` | `--nested` / `--once` / `--private` / `-u` / `-v` |
302
+ | `no_compress` | boolean | `false` | 省掉額外的 delta 壓縮(`--nocompress`) |
303
+ | `no_open` | boolean | `false` | 只克隆,不開 check-out(`--no-open`) |
304
+ | `save_http_password` | boolean | `false` | 記住 HTTP 密碼,之後不再詢問(`--save-http-password`) |
298
305
  | `reveal_secrets` | boolean | `false` | 原樣返回輸出中的憑據 |
299
306
  | `workspace` | string | 見 §2.1 | 命令執行目錄 |
300
307
 
@@ -453,7 +460,7 @@ https://example.com/x.fossil
453
460
  ### 3.7 `fossil_push` / `fossil_pull` / `fossil_sync`
454
461
 
455
462
  ```bash
456
- fossil push [URL] [--all] [--private] [--once] [--verily] [-v] [--proxy P] [--httpauth U:P] [--ssl-identity F]
463
+ fossil push [URL] [--all] [--private] [--once] [--verily] [-v] [--proxy P] [--httpauth U:P] [--ssl-identity F] [-R REPO] [--transport-command CMD] [--no-http-compression] [--ipv4]
457
464
  fossil pull [URL] [--from-parent-project] [--project-code CODE] …同上的網路選項
458
465
  fossil sync [URL] [--unversioned] …同上的網路選項
459
466
  ```
@@ -469,6 +476,10 @@ fossil sync [URL] [--unversioned] …同上的網路選項
469
476
  | `proxy` | string | — | `--proxy` |
470
477
  | `httpauth` | string | — | `--httpauth` 的 `USER:PASS` |
471
478
  | `ssl_identity` | string | — | `--ssl-identity` |
479
+ | `transport_command` | string | — | 搬運訊息到遠端再搬回來的外部命令(`--transport-command`) |
480
+ | `repository` | string | check-out 的倉庫 | 直接指定要操作的倉庫檔(`-R`) |
481
+ | `no_http_compression` | boolean | `false` | HTTP 流量不壓縮(`--no-http-compression`) |
482
+ | `ipv4` | boolean | `false` | 連線只用 IPv4(`--ipv4`) |
472
483
  | `reveal_secrets` | boolean | `false` | 原樣顯示輸出裡的憑據 |
473
484
  | `workspace` | string | 見 §2.1 | — |
474
485
 
@@ -505,7 +516,7 @@ fossil rebuild [--ifneeded] [--compress] [--compress-only] [--vacuum] [--stats]
505
516
 
506
517
  | 參數 | 類型 | 必填/預設 | 說明 |
507
518
  | --- | --- | --- | --- |
508
- | `repository` | string | 目前 check-out 的倉庫 | 要重建的倉庫檔;省略時由 check-out 決定 |
519
+ | `repository` | string | 目前 check-out 的倉庫 | 要重建的倉庫檔,例如 `repos/app.fossil`;省略時由 check-out 決定 |
509
520
  | `ifneeded` | boolean | `false` | 只在 schema 版本會改變時重建(`--ifneeded`) |
510
521
  | `compress` / `compress_only` | boolean | `false` | 一邊重建一邊壓縮 / 只做壓縮 |
511
522
  | `vacuum` / `analyze` | boolean | `false` | 重建後 `VACUUM` / `ANALYZE` |
@@ -550,6 +561,7 @@ fossil config reset <area>
550
561
  | `area` | enum | `export` / `pull` / `push` / `reset` 時必填 | `all` / `email` / `interwiki` / `project` / `shun` / `skin` / `ticket` / `user` / `alias` / `subscriber` |
551
562
  | `file` | string | `export` / `import` / `merge` 時必填 | 要寫出或讀入的檔案 |
552
563
  | `url` | string | 預設遠端 | `pull`/`push` 的來源或目的 |
564
+ | `repository` | string | check-out 的倉庫 | 直接指定要設定哪個倉庫檔(`-R`) |
553
565
  | `overwrite` | boolean | `false` | `pull` 時以遠端內容覆蓋本地設定(`--overwrite`) |
554
566
  | `workspace` | string | 見 §2.1 | — |
555
567
 
package/docs/chat.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Chat 能力(`-c c`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後,fossil 2.21 實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後,fossil 2.21 實測。
4
4
 
5
5
  `-c c` 註冊 4 個工具:`fossil_chat_url` / `fossil_chat_send` / `fossil_chat_pull` / `fossil_chat_read`。
6
6
 
package/docs/forum.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Forum 能力(`-c f`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後,fossil 2.21 實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後,fossil 2.21 實測。
4
4
 
5
5
  `-c f` 註冊 3 個工具,**全部只讀**:`fossil_forum_list` / `fossil_forum_read` / `fossil_forum_search`。
6
6
 
package/docs/tickets.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Tickets 能力(`-c t`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後,fossil 2.21 實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後,fossil 2.21 實測。
4
4
 
5
5
  `-c t` 註冊 4 個工具:`fossil_ticket_list` / `fossil_ticket_show` / `fossil_ticket_create` / `fossil_ticket_update`。
6
6
  (check-out 用 admin 的 `fossil_init` / `fossil_open`,組合啟用寫 `-c at`。)
package/docs/vcs.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # VCS 能力(`-c v`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後。所有行為都在 fossil 2.21 上實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後。所有行為都在 fossil 2.21 上實測。
4
4
 
5
5
  `-c v` 註冊 40 個工具;要連 admin 一起用 `-c av`。
6
6
 
@@ -14,7 +14,7 @@
14
14
  | `fossil_diff` | `fossil diff` |
15
15
  | `fossil_cat` | `fossil cat <file> [-r REV]` |
16
16
  | `fossil_finfo` | `fossil finfo [-i\|-s\|-p\|-l] <file>` |
17
- | `fossil_ls` | `fossil ls [-r REV] [--age] [-v] [-t] [--hash]` |
17
+ | `fossil_ls` | `fossil ls [-R FILE] [-r REV] [--age] [-v] [-t] [--hash]` |
18
18
  | `fossil_extras` | `fossil extras` |
19
19
  | `fossil_timeline` | `fossil timeline -n N` |
20
20
  | `fossil_info` | `fossil info [target]` |
@@ -52,7 +52,7 @@
52
52
  | `fossil_ignore_from_gitignore` | 讀 `.gitignore`,寫 `.fossil-settings/ignore-glob` |
53
53
 
54
54
  標了 `destructiveHint: true` 的是 `fossil_rm` / `fossil_revert` / `fossil_clean` / `fossil_update` / `fossil_undo`:
55
- 它們會覆蓋工作區內容,呼叫方應先確認,或先跑 `dry_run` / `-n` 預覽。除了 `fossil_sql` 可用 `repository` 直接查詢,其餘工具都需要 check-out(見 §2)。
55
+ 它們會覆蓋工作區內容,呼叫方應先確認,或先跑 `dry_run` / `-n` 預覽。`fossil_cat`/`fossil_info`/`fossil_descendants`/`fossil_ls`/`fossil_artifact`/`fossil_timeline` 與 `fossil_sql` 可用 `repository` 直接讀倉庫檔,其餘工具都需要 check-out(見 §2)。
56
56
 
57
57
  ---
58
58
 
@@ -128,7 +128,7 @@ comment: first (user: stellar)
128
128
 
129
129
  ```bash
130
130
  fossil diff [--from X] [--to Y] [--branch B] [-ci C] [--brief] [--numstat]
131
- [-c N] [-y] [-v] [--undo] [-w] [-Z] [-i] [--unified] [-h] [--json] [-W N]
131
+ [-c N] [-y] [-v] [--undo] [-w] [-Z] [--strip-trailing-cr] [-N] [-i] [--unified] [-h] [--json] [-W N]
132
132
  [files...]
133
133
  ```
134
134
 
@@ -147,6 +147,8 @@ fossil diff [--from X] [--to Y] [--branch B] [-ci C] [--brief] [--numstat]
147
147
  | `undo` | boolean | `false` | `--undo` 與 undo 緩衝區比較 |
148
148
  | `ignore_whitespace` | boolean | `false` | `-w` 忽略空白差異 |
149
149
  | `ignore_trailing_space` | boolean | `false` | `-Z` 忽略行尾空白差異 |
150
+ | `strip_trailing_cr` | boolean | `false` | `--strip-trailing-cr` 忽略每行結尾的 CR |
151
+ | `new_file` | boolean | `false` | `-N` 把新增檔案視為本來就是空內容 |
150
152
  | `internal` | boolean | `false` | `-i` 用內建 diff |
151
153
  | `unified` | boolean | `false` | `--unified` 輸出 unified patch |
152
154
  | `versions_header` | boolean | `false` | `-h` 在標頭列出比較的版本 |
@@ -169,6 +171,7 @@ fossil cat <file> [-r REV]
169
171
  | --- | --- | --- | --- |
170
172
  | `file` | string | **必填** | 要列印的檔案 |
171
173
  | `revision` | string | — | 指定 check-in 或版本(`-r`) |
174
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
172
175
  | `workspace` | string | 見 admin §2.1 | — |
173
176
 
174
177
  ### 3.4 `fossil_finfo`
@@ -231,7 +234,7 @@ fossil extras [--dotfiles] [--ignore GLOBS] [--abs-paths|--rel-paths] [--header]
231
234
  ### 3.6 `fossil_timeline`
232
235
 
233
236
  ```bash
234
- fossil timeline -n <limit> [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN CHECKIN] [-F FORMAT] [-v]
237
+ fossil timeline -n <limit> [-R FILE] [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN CHECKIN] [-F FORMAT] [-v]
235
238
  [--offset N] [-W N]
236
239
  ```
237
240
 
@@ -248,6 +251,7 @@ fossil timeline -n <limit> [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN CHECKIN] [
248
251
  | `verbose` | boolean | `false` | 每個 check-in 後面列出變更的檔案(`-v`) |
249
252
  | `offset` | number | — | 跳過前 N 條(`--offset`) |
250
253
  | `width` | number | — | 輸出寬度(`-W`,≥20) |
254
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
251
255
  | `workspace` | string | 見 admin §2.1 | — |
252
256
 
253
257
  真實輸出(`limit: 3`):
@@ -263,7 +267,7 @@ fossil timeline -n <limit> [-p PATH] [-t TYPE] [-b BRANCH] [-c] [WHEN CHECKIN] [
263
267
  ### 3.7 `fossil_info`
264
268
 
265
269
  ```bash
266
- fossil info [target] [-v]
270
+ fossil info [target] [-R FILE] [-v]
267
271
  ```
268
272
 
269
273
  `target` 可以是檔名、check-in 雜湊、分支名;省略時給倉庫/check-out 元資訊(真實輸出見 §3.1 的 STATUS 段同源)。
@@ -273,6 +277,7 @@ fossil info [target] [-v]
273
277
  | --- | --- | --- | --- |
274
278
  | `target` | string | — | 檔名、check-in 雜湊或分支名 |
275
279
  | `verbose` | boolean | `false` | 額外資訊,如 SQLite 版本與倉庫大小(`-v`) |
280
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
276
281
  | `workspace` | string | 見 admin §2.1 | — |
277
282
 
278
283
  ---
@@ -281,7 +286,7 @@ fossil info [target] [-v]
281
286
  ```bash
282
287
  fossil changes [--edited|--updated|--added|--deleted|--renamed|--conflict|--meta]
283
288
  [--changed|--missing|--unchanged|--extra|--differ|--all]
284
- [--classify] [--no-merge] [--hash] [--header] [-v]
289
+ [--classify] [--no-classify] [--no-merge] [--merge] [--ignore GLOBS] [--hash] [--header] [-v]
285
290
  [--dotfiles] [--abs-paths|--rel-paths] [files...]
286
291
  ```
287
292
 
@@ -294,6 +299,9 @@ fossil changes [--edited|--updated|--added|--deleted|--renamed|--conflict|--meta
294
299
  | `changed` / `missing` / `unchanged` / `extra` / `differ` / `all` | boolean | `false` | 其餘變更類型過濾,可疊加 |
295
300
  | `classify` | boolean | `false` | 每行前面加變更類型 |
296
301
  | `no_merge` | boolean | `false` | 隱藏 merge 貢獻者 |
302
+ | `merge` | boolean | `false` | 只列帶合併衝突標記的檔案(`--merge`) |
303
+ | `no_classify` | boolean | `false` | 不加每行的變更類型(`--no-classify`) |
304
+ | `ignore` | string | — | `--ignore` 的 CSG,符合的檔案不列入 |
297
305
  | `hash` | boolean | `false` | 用雜湊而非大小+mtime 判斷狀態(`--hash`) |
298
306
  | `header` | boolean | `false` | 非空報告前印倉庫名(`--header`) |
299
307
  | `verbose` | boolean | `false` | 空報告時印 `(none)`(`-v`) |
@@ -416,7 +424,7 @@ fossil merge-base [--ignore-merges] <v1> <v2> [...]
416
424
  ### 3.13 `fossil_leaves`
417
425
 
418
426
  ```bash
419
- fossil leaves [-a] [-c] [-m] [--bybranch] [-W WIDTH]
427
+ fossil leaves [-a] [-c] [-m] [--recompute] [--bybranch] [-W WIDTH]
420
428
  ```
421
429
 
422
430
  | 參數 | 類型 | 必填/預設 | 說明 |
@@ -424,6 +432,7 @@ fossil leaves [-a] [-c] [-m] [--bybranch] [-W WIDTH]
424
432
  | `all` | boolean | `false` | `-a` 連已關閉的 leaf 一起列 |
425
433
  | `closed` | boolean | `false` | `-c` 只列已關閉的 leaf |
426
434
  | `multiple` | boolean | `false` | `-m` 只列有多個 leaf 的分支 |
435
+ | `recompute` | boolean | `false` | `--recompute` 重算 leaf,不讀快取 |
427
436
  | `by_branch` | boolean | `false` | `--bybranch` 按分支名排序 |
428
437
  | `width` | number | — | `-W` 輸出寬度,`0` 表示一行一筆 |
429
438
  | `workspace` | string | 見 admin §2.1 | — |
@@ -446,6 +455,7 @@ fossil descendants [<checkin>] [-W WIDTH]
446
455
  | --- | --- | --- | --- |
447
456
  | `checkin` | string | — | 起始 check-in;省略時用當前 check-out 的版本 |
448
457
  | `width` | number | — | 輸出寬度(`-W`);`0` 表示一行一筆 |
458
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
449
459
  | `workspace` | string | 見 admin §2.1 | — |
450
460
 
451
461
  真實輸出:
@@ -528,6 +538,7 @@ fossil ls ?PATHS ...? [-r REV] [--age] [-v] [-t] [--hash]
528
538
  | `verbose` | boolean | `false` | 額外資訊:無 `-r` 時是變更狀態,有 `-r` 時是提交時間與大小(`-v`) |
529
539
  | `time_order` | boolean | `false` | 按時間排序(`-t`);搭配 `--age` 或 `-r` 時按提交時間 |
530
540
  | `hash` | boolean | `false` | 用雜湊而非大小+mtime 判斷檔案狀態(`--hash`),自動加上 `--verbose` |
541
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
531
542
  | `workspace` | string | 見 admin §2.1 | — |
532
543
 
533
544
  真實輸出:
@@ -569,12 +580,13 @@ $ fossil search second
569
580
  ### 3.19 `fossil_artifact`
570
581
 
571
582
  ```bash
572
- fossil artifact <ARTIFACT-ID>
583
+ fossil artifact <ARTIFACT-ID> [-R FILE]
573
584
  ```
574
585
 
575
586
  | 參數 | 類型 | 必填/預設 | 說明 |
576
587
  | --- | --- | --- | --- |
577
588
  | `artifact` | string | **必填** | 工件雜湊,可用唯一前綴 |
589
+ | `repository` | string | — | `-R` 直接讀這個倉庫檔案,不需要 check-out |
578
590
  | `workspace` | string | 見 admin §2.1 | — |
579
591
 
580
592
  真實輸出(檔案版本工件):
@@ -815,13 +827,15 @@ $ fossil bisect chart
815
827
  ### 3.27 `fossil_sql`
816
828
 
817
829
  ```bash
818
- fossil sql --readonly -json "<query>"
830
+ fossil sql --readonly [-R FILE] -json "<query>"
831
+ fossil sql --readonly --no-repository FILE -json "<query>"
819
832
  ```
820
833
 
821
834
  | 參數 | 類型 | 必填/預設 | 說明 |
822
835
  | --- | --- | --- | --- |
823
836
  | `query` | string | **必填** | 以 `SELECT` / `WITH` / `PRAGMA` / `EXPLAIN` 開頭的語句;`LIMIT` 寫在 SQL 裡 |
824
- | `repository` | string | check-out 的倉庫 | 直接指定倉庫檔(`-R`),可在沒有 check-out 的目錄查詢 |
837
+ | `repository` | string | check-out 的倉庫 | 直接指定倉庫檔(`-R`),例如 `repos/app.fossil`;可在沒有 check-out 的目錄查詢 |
838
+ | `database` | string | — | 查一般的 SQLite 檔而非倉庫(`--no-repository`),例如 chat 存檔 |
825
839
  | `workspace` | string | 見 admin §2.1 | — |
826
840
 
827
841
  輸出是製表符分隔的表格,最後一行是 `N row(s).`;空結果印 `No rows.`。查詢以 `--readonly` 開啟,
@@ -931,8 +945,10 @@ fossil addremove --reset [-n] [-v] # reset: true
931
945
  ### 4.5 `fossil_commit`
932
946
 
933
947
  ```bash
934
- fossil commit -m <message> [--branch B] [--no-warnings] [--allow-empty] [--close]
935
- [--bgcolor COLOR] [--date-override DATE] [--tag TAG ...] [--user-override U] [files...]
948
+ fossil commit -m <message> [-M FILE] [--mimetype TYPE] [--branch B] [--no-warnings]
949
+ [--allow-empty] [--allow-fork] [--allow-conflict] [--allow-older] [--integrate]
950
+ [--private] [--hash] [--no-verify] [--dry-run] [--close] [--bgcolor COLOR]
951
+ [--date-override DATE] [--tag TAG ...] [--user-override U] [files...]
936
952
  # stdin = "y\na\n"
937
953
  ```
938
954
 
@@ -943,6 +959,16 @@ fossil commit -m <message> [--branch B] [--no-warnings] [--allow-empty] [--close
943
959
  | `branch` | string | — | `--branch` 把新 check-in 放到指定分支 |
944
960
  | `no_warnings` | boolean | `false` | `--no-warnings` |
945
961
  | `allow_empty` | boolean | `false` | `--allow-empty`(無檔案變更也能提交) |
962
+ | `allow_fork` | boolean | `false` | `--allow-fork` 允許這次提交在分支上分叉 |
963
+ | `allow_conflict` | boolean | `false` | `--allow-conflict` 帶著未解決的合併衝突提交 |
964
+ | `allow_older` | boolean | `false` | `--allow-older` 允許比祖先更舊的時間戳記 |
965
+ | `integrate` | boolean | `false` | `--integrate` 關閉所有已併入本分支的分支 |
966
+ | `private_checkin` | boolean | `false` | `--private` 這個 check-in 不隨 push 出去 |
967
+ | `hash` | boolean | `false` | `--hash` 用雜湊而非大小+mtime 判斷檔案變更 |
968
+ | `no_verify` | boolean | `false` | `--no-verify` 跳過提交前的 hook |
969
+ | `dry_run` | boolean | `false` | `--dry-run` 只顯示會提交什麼 |
970
+ | `message_file` | string | — | `-M` 從檔案讀提交訊息,優先於 `message` |
971
+ | `mimetype` | string | — | `--mimetype` 提交訊息的 mimetype |
946
972
  | `close` | boolean | `false` | `--close` 提交後關閉所在分支 |
947
973
  | `bgcolor` | string | — | `--bgcolor` 只套用在這一個 check-in 的背景色 |
948
974
  | `date_override` | string | — | `--date-override` 指定提交時間(如 `2026-11-17 12:00:00`) |
@@ -970,7 +996,8 @@ fossil revert [-r REV] [files...]
970
996
  ### 4.7 `fossil_clean`
971
997
 
972
998
  ```bash
973
- fossil clean [--dotfiles] [--ignore GLOBS] [--clean CSG] [-x] [--temp] [--dirsonly] [--emptydirs] [-v] [-n]
999
+ fossil clean [--dotfiles] [--ignore GLOBS] [--clean CSG] [--keep GLOBS] [-x] [--temp]
1000
+ [--dirsonly] [--emptydirs] [--disable-undo] [--allckouts] [-i] [--case-sensitive 1|0] [-v] [-n]
974
1001
  fossil clean -f # all_files: true
975
1002
  fossil clean --no-prompt # 都不給(預設)
976
1003
  ```
@@ -986,6 +1013,11 @@ fossil clean --no-prompt # 都不給(預設)
986
1013
  | `temp` | boolean | `false` | 連暫存檔一起清(`--temp`) |
987
1014
  | `dirs_only` | boolean | `false` | 只刪空目錄(`--dirsonly`) |
988
1015
  | `empty_dirs` | boolean | `false` | 一併刪除空目錄(`--emptydirs`) |
1016
+ | `keep` | string | — | `--keep` 的 CSG,符合的未管理檔案永不刪除 |
1017
+ | `disable_undo` | boolean | `false` | `--disable-undo` 不留 undo 備份 |
1018
+ | `all_checkouts` | boolean | `false` | `--allckouts` 連巢狀 check-out 的空目錄一起掃 |
1019
+ | `prompt` | boolean | `false` | `-i` 每個檔案都問(等於關閉 undo 備份) |
1020
+ | `case_sensitive` | boolean | 依設定 | `--case-sensitive 1\|0` 覆寫大小寫規則 |
989
1021
  | `verbose` | boolean | `false` | 逐檔回報(`-v`) |
990
1022
  | `workspace` | string | 見 admin §2.1 | — |
991
1023
 
@@ -1097,7 +1129,7 @@ fossil merge [-n] [--integrate] [--cherrypick|--backout] [--baseline V] [--binar
1097
1129
  ### 5.4 `fossil_update`
1098
1130
 
1099
1131
  ```bash
1100
- fossil update [--latest] [--nosync] [--setmtime] [--force-missing] [-K] [-v] [target]
1132
+ fossil update [--latest] [--nosync] [--setmtime] [--force-missing] [--case-sensitive 1|0] [-K] [-W N] [-v] [target]
1101
1133
  fossil update -n [target] # dry_run: true
1102
1134
  ```
1103
1135
 
@@ -1110,6 +1142,8 @@ fossil update -n [target] # dry_run: true
1110
1142
  | `set_mtime` | boolean | `false` | `--setmtime` 把檔案時間戳設成最後一次相關提交的時間 |
1111
1143
  | `keep_merge_files` | boolean | `false` | `-K` 衝突時保留 `*-baseline` / `*-original` / `*-merge` |
1112
1144
  | `force_missing` | boolean | `false` | `--force-missing` 即使有一側內容缺失也更新 |
1145
+ | `case_sensitive` | boolean | 依設定 | `--case-sensitive 1\|0` 覆寫大小寫規則 |
1146
+ | `width` | number | — | `-W` 輸出寬度 |
1113
1147
  | `verbose` | boolean | `false` | `-v` 列出每個檔案的處理結果 |
1114
1148
  | `workspace` | string | 見 admin §2.1 | check-out 目錄 |
1115
1149
 
package/docs/wiki.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Wiki 能力(`-c w`)工具說明
2
2
 
3
- 適用於 `@stellar_ai/mcp_fossil_scm@0.2.0` 及之後,fossil 2.21 實測。
3
+ 適用於 `@stellar_ai/mcp_fossil_scm@0.2.1` 及之後,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,6 +1,6 @@
1
1
  {
2
2
  "name": "@stellar_ai/mcp_fossil_scm",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Capability-scoped MCP server for Fossil SCM: Admin, VCS, Forum, Tickets, Wiki and Chat",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -42,10 +42,12 @@
42
42
  "start": "node dist/index.js",
43
43
  "dev": "pnpm build && node dist/index.js --verbose",
44
44
  "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
45
+ "make:testbed": "node scripts/make-testbed.mjs",
45
46
  "prebuild": "pnpm clean",
46
47
  "smoke": "node scripts/smoke.mjs",
47
48
  "test": "pnpm typecheck && pnpm build && pnpm check:docs && pnpm smoke",
48
49
  "link-local": "bash scripts/link-local.sh",
49
- "check:docs": "node scripts/check-docs.mjs"
50
+ "check:docs": "node scripts/check-docs.mjs",
51
+ "pretest": "pnpm make:testbed"
50
52
  }
51
53
  }