@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 +3 -2
- package/dist/config.js +1 -1
- package/dist/tools/admin.js +53 -6
- package/dist/tools/version-control.js +112 -22
- package/docs/README.md +2 -2
- package/docs/admin.md +17 -5
- package/docs/chat.md +1 -1
- package/docs/forum.md +1 -1
- package/docs/tickets.md +1 -1
- package/docs/vcs.md +49 -15
- package/docs/wiki.md +1 -1
- package/package.json +4 -2
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
|
|
185
|
-
pnpm
|
|
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.
|
|
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).
|
package/dist/tools/admin.js
CHANGED
|
@@ -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.
|
|
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
|
|
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
|
|
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
|
-
|
|
89
|
-
|
|
90
|
-
|
|
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, '
|
|
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.
|
|
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
|
|
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.
|
|
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 | **必填** |
|
|
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 的倉庫 |
|
|
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
package/docs/forum.md
CHANGED
package/docs/tickets.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Tickets 能力(`-c t`)工具說明
|
|
2
2
|
|
|
3
|
-
適用於 `@stellar_ai/mcp_fossil_scm@0.2.
|
|
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.
|
|
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`
|
|
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
|
|
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> [
|
|
935
|
-
[--
|
|
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] [
|
|
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
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stellar_ai/mcp_fossil_scm",
|
|
3
|
-
"version": "0.2.
|
|
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
|
}
|