svn-agent-mcp 1.0.0

package/README.md

@@ -0,0 +1,143 @@
+# svn-agent MCP
+
+Strict SVN Model Context Protocol server for agent-safe status, diff, EOL diagnosis, precommit checks, and guarded SVN mutations.
+
+The implementation contract lives in `docs/SPEC.md`. Version `1.0.0` is the first public open-source release and can prepare a self-contained local runtime bundle under `releases/v1.0.0`.
+
+Requirements: Windows, Node.js 20 or newer, Git, and access to the public npm registry. The bundled
+SlikSVN and dos2unix runtime payload is Windows-only.
+
+## Quick Start
+
+```powershell
+git clone https://github.com/shrishailrana-maker/svn-agent-mcp-v1.git
+cd svn-agent-mcp-v1
+npm install
+npm run prepare:local
+npm test
+```
+
+## Agent Setup From GitHub
+
+Tell an agent:
+
+```text
+Get the SVN MCP from https://github.com/shrishailrana-maker/svn-agent-mcp-v1, clone it to C:\MCP\svn-agent-mcp-v1, run npm install, run npm run prepare:local, then configure the MCP command as node C:\MCP\svn-agent-mcp-v1\current\dist\index.js.
+```
+
+The setup commands are:
+
+```powershell
+git clone https://github.com/shrishailrana-maker/svn-agent-mcp-v1.git C:\MCP\svn-agent-mcp-v1
+cd C:\MCP\svn-agent-mcp-v1
+npm install
+npm run prepare:local
+```
+
+Then configure the MCP client to run:
+
+```text
+node C:\MCP\svn-agent-mcp-v1\current\dist\index.js
+```
+
+### Claude Desktop Config Example
+
+Add this under `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "svn": {
+      "command": "node",
+      "args": ["C:\\MCP\\svn-agent-mcp-v1\\current\\dist\\index.js"]
+    }
+  }
+}
+```
+
+### Codex Config Example
+
+```toml
+[mcp_servers.svn]
+command = "node"
+args = ["C:\\MCP\\svn-agent-mcp-v1\\current\\dist\\index.js"]
+startup_timeout_sec = 120
+```
+
+Restart the MCP client after changing the config.
+
+## Start The MCP
+
+For development from this working copy:
+
+```powershell
+cd <path-to-svn-agent-mcp-v1>
+npm install
+npm run prepare:local
+node .\current\dist\index.js
+```
+
+The source tree includes `bin/` with the full SlikSVN `bin` payload plus the full dos2unix `bin` payload. Releases copy that folder to `current/bin`, so normal Windows clients do not need to locate or install `svn`, `svnversion`, `svnadmin`, `dos2unix`, `unix2dos`, or their required DLLs. See `THIRD_PARTY_NOTICES.md` and `THIRD_PARTY_CHECKSUMS.txt` for bundled binary notices and SHA256 hashes.
+
+## Plug-And-Play Client Config
+
+Register the MCP once globally. Do not set `cwd` and do not set environment variables:
+
+Generic client example:
+
+```json
+{
+  "mcpServers": {
+    "svn": {
+      "command": "node",
+      "args": ["C:\\MCP\\svn-agent-mcp-v1\\current\\dist\\index.js"]
+    }
+  }
+}
+```
+
+The MCP is not tied to one SVN checkout. If a tool call supplies absolute paths and omits `cwd`, the server finds the nearest SVN working copy for those paths. Relative paths require explicit per-call `cwd`.
+
+Client registration is static: configure the MCP once, and working-copy discovery happens per tool call. The server does not rewrite client configuration at runtime.
+
+Environment variables are not required for normal use. They are development/test escape hatches only: `SVN_AGENT_BIN_DIR`, `SVN_AGENT_SVN_PATH`, `SVN_AGENT_DOS2UNIX_DIR`, `SVN_AGENT_TIMEOUT_MS`, and `SVN_AGENT_MAX_DIFF_LINES`.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `npm run dev` | Run the TypeScript entry point during development |
+| `npm run typecheck` | Check TypeScript without emitting build output |
+| `npm run build` | Compile `src/` into `dist/` |
+| `npm test` | Run the Jest test suite |
+| `npm run prepare:local` | Build and prepare the local `current` runtime |
+| `npm run release:prepare` | Copy `dist/` and `bin/` into `releases/v<version>` and repoint `current` |
+| `npm run clean` | Remove root `dist/` with the Node clean script |
+
+## Operator Diagnostics
+
+Use `svn_self_check` to verify the MCP package, `current` release pointer, bundled binaries, and release scripts. Use `svn_diagnose` on a working-copy path when SVN itself is acting strange; it checks local status, remote status, HEAD info, latest log reachability, and returns actionable notes for authentication, network, lock, and working-copy database failures.
+
+For SVN property work, use `svn_propget` and guarded `svn_propset` instead of raw `svn propget`/`svn propset`. `svn_propset_eol_style` remains the safer shortcut for `svn:eol-style` normalization.
+
+## Changelog
+
+Release history is maintained in `CHANGELOG.md`.
+
+## Layout
+
+| Path | Purpose |
+| --- | --- |
+| `src/` | MCP server implementation |
+| `src/parse/` | SVN XML/text parsers |
+| `src/tools/` | MCP tool families |
+| `tests/` | Unit and temp-repository integration tests |
+| `.svn-mcp-policy.json` | Repo-local guard exceptions for this MCP's intentional runtime payloads |
+| `bin/` | Versioned Windows SVN and EOL converter runtime binaries |
+| `THIRD_PARTY_NOTICES.md` | Notices for bundled binary payloads |
+| `docs/` | Spec, local rules, and decisions |
+| `releases/` | Generated versioned runtime release payloads, ignored by Git |
+
+## Usage Model
+
+Register one global MCP server and use explicit paths or per-call `cwd` values when working across SVN checkouts. The server does not assume a product name, project name, or fixed working copy.

package/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+Security fixes target the latest released version on the default branch. Older releases may receive
+fixes when the issue is severe and the patch is low risk.
+
+## Reporting A Vulnerability
+
+Please report suspected vulnerabilities through GitHub private vulnerability reporting or a private
+security advisory for this repository. If private reporting is not enabled, open a minimal public
+issue asking for a security contact without including exploit details.
+
+Useful reports include:
+
+- Affected version or commit
+- Impact and attacker capabilities
+- Reproduction steps or proof of concept
+- Whether the issue affects read-only, mutating, or release-packaging behavior
+
+Please do not publish exploit details until a fix or mitigation is available.

package/THIRD_PARTY_CHECKSUMS.txt

@@ -0,0 +1,52 @@
+# SHA256 checksums for bundled third-party binaries
+#
+# Generated from the files under bin/ for release v1.0.0.
+
+95bbe265f53f94d60a99bd5660bcdd97de96045cddf508ae43482f91bfdb4755  bin/dos2unix.exe
+0f369ba0c0807a79216ad641a63c16b8f3d5ed1248d9db5a2447082f4cd984cd  bin/engines/capi.dll
+9139acb63399e18ab72fca074a622e8ace829fee8db8682bb4bca7b34e8b380a  bin/libsvnjavahl-1.dll
+95bbe265f53f94d60a99bd5660bcdd97de96045cddf508ae43482f91bfdb4755  bin/mac2unix.exe
+b129bfd13bd5670df96bf0397d177efa9ad5b9fa91621c97c90004812414becb  bin/SlikSvn-DB44-20-x64.dll
+9cbfed910b3fb430eb4b61291789bde267f4d3092a2208802c2767a3aac63949  bin/SlikSvn-libapr-1.dll
+2bd71134611e9272da9c1ff6092b2165985bd532d76bcc4ad505eb3c8b0951c3  bin/SlikSvn-libaprutil-1.dll
+716e5f8c8d8137c011d00a1f6523889c196818397bc52eea14aa78e422eea1c3  bin/SlikSvn-libcrypto-3-x64.dll
+0c4157d7baeba7f86f77fc328e8a691532e6a4ec36a36da51b2373e67653624c  bin/SlikSvn-libintl.dll
+6e4dbf1efbb79809b251b7c52969c884d610a9543ccd1f16781e7e58480ab510  bin/SlikSvn-libsasl21.dll
+ab5efd7d65de64dcc6c4e2e95132b4121f172db9732896f3504579682884420a  bin/SlikSvn-libssl-3-x64.dll
+858250c5c29c55c65e07cccd9967352af0bc7c309b7395aee6c7f2a6e50d9de4  bin/SlikSvn-libsvn_client-1.dll
+975effba24809ad1f147177185b0c9c63a40b1061470f4f7f834e55503a323fe  bin/SlikSvn-libsvn_delta-1.dll
+c54cedfb3f1eadd6041f33c4c3cfba02db6159eccfc78a5ce050a7fb16f37a8b  bin/SlikSvn-libsvn_diff-1.dll
+372ebba0d4d5accb10740a7fe9663e3c8665dc5259dbbc9728004996c0ebfb68  bin/SlikSvn-libsvn_fs_base-1.dll
+5d8c506a7eb80cb213b7ecd3561ca95fb76744fb58909fa89495978ccda84a90  bin/SlikSvn-libsvn_fs_fs-1.dll
+9d4d5a58c9bbc5e69e9fe01a2d8178d4bc4c9028175fce2686c869866705bae7  bin/SlikSvn-libsvn_fs_util-1.dll
+48b75956165dbe942490cede7892dab6bb52670acee9027f44d4a899031668e9  bin/SlikSvn-libsvn_fs_x-1.dll
+e634ee8a101ba346fb247a6372a991686a687061b87c09624d3992efec17ef77  bin/SlikSvn-libsvn_fs-1.dll
+a9ffe2294a096e67b3d0d2efc4863620ad22fe85f531259105ca5c2a733af8da  bin/SlikSvn-libsvn_ra-1.dll
+58a5785830ded90a25dc5adb31762ac7517024e508849b7d8aa8b3e99fb2e02a  bin/SlikSvn-libsvn_repos-1.dll
+8110c65db3b6aedcd7493a20d0c738a1c3bfb53f14c184d06629228606a253b3  bin/SlikSvn-libsvn_subr-1.dll
+2e06518de783feb649b58bc9c133f06ee44da36881e0d875f371ef4c800461ff  bin/SlikSvn-libsvn_wc-1.dll
+f38a7ca7b76928629041a384fddc0848adfa5afb8df1bb98b38a4202561790df  bin/svn-populate-node-origins-index.exe
+916151f9bb570efe36000cfab907c6737f83e7c82b915044b48b2d616dbe437a  bin/svn.exe
+4a3505693ebc84aaa873c13b78cdea450abf83ec6d4912987c043b925e43756b  bin/svnadmin.exe
+26c66fd3f576c158102df4039a67c9e7f07e6e2ff47a1a107a28a23efe943082  bin/svnauthz-validate.exe
+385ed3e415755e2fb8e4950ced1f9e14d5970057b97e4bbcde15f3e11153c5b5  bin/svnauthz.exe
+d3aecf83ec9fd28c05de7fcedd0570fda2ee7cce33fd0f060ee86cf2933f69db  bin/svnbench.exe
+c3142577dae6ee2fbb97a9bc0f0cc550574dc61960c5222d7a0567cd95a01fc8  bin/svndumpfilter.exe
+1f23f8cb3b6b601edf1af6ad20923aa1ce3ee0b653e50083f250d2ce289eb663  bin/svnfsfs.exe
+cbf19f684a206816bc7b51e01764b946ffcb4df6e54904c1dea8ff59b487faed  bin/svnlook.exe
+ee7564335c8400393e894d8eab697dcd85c53e96ac4cf4e14a2e85c2e1aa997e  bin/svnmucc.exe
+0500e301dbc811a230fa95a0680241595ebedb302f6c456adb03d6945c060244  bin/svnrdump.exe
+19a6eefde4c0aa6634e17dc591f4b5d4e9e051831268a65fc78538e8455fc1e5  bin/svnserve.exe
+414cd24d79f4b6a9c045e951af4376d9bc17d473efbf690daefa8977d58299db  bin/svnsync.exe
+1a17ddd90872494fafb37118c7e8a5bcd49d8198f763590c46ec2a7b73143c25  bin/svnversion.exe
+50d513a4e954b157b773f3419ef736c41529e782c3dc5bf2894d3be905b25183  bin/System64/concrt140.dll
+2c03cf78553689ca0523a3ef7c3161939b8f4a2fe246d9e90efa9cfef95c59a7  bin/System64/msvcp140_1.dll
+b583a041271b247c61676396640e7e455388fda580d13a35c1cca592ee4c8080  bin/System64/msvcp140_2.dll
+5d547fd143b5d399f9fe69fe759543e69a140e3a999aae3cde361e7912a0e5e4  bin/System64/msvcp140_atomic_wait.dll
+e763bd3f595d7869190b799cdb23eff7951c6ed224492c40ff9d7b2f7f843050  bin/System64/msvcp140_codecvt_ids.dll
+256492fbbcf3dc63987318f83e5f49eaacdbb6a9a5be54e403f0ddb437582881  bin/System64/msvcp140.dll
+64cc19775dd40aee09ca8b35326a113892b0f251d3e7ea03b0ca7e3045464e60  bin/System64/vccorlib140.dll
+0d719fbe25194e3faa037bd736e07ec9184ab68e521ebbd72c2b13aed89b47a9  bin/System64/vcruntime140_1.dll
+c51c64dfb7c445ecf0001f69c27e13299ddcfba0780efa72b866a7487b7491c7  bin/System64/vcruntime140.dll
+192e3735de62e8488a474b63087544879d8c37522a76c79fb717b250082137d6  bin/unix2dos.exe
+192e3735de62e8488a474b63087544879d8c37522a76c79fb717b250082137d6  bin/unix2mac.exe

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,46 @@
+# Third-Party Notices
+
+This project includes a bundled Windows runtime payload in `bin/` so MCP clients can run without
+end-user SVN or EOL-converter installation. The project source is licensed under Apache-2.0; the
+bundled third-party binaries remain under their upstream licenses.
+
+## SlikSVN / Apache Subversion
+
+- Files: `bin/svn*.exe`, `bin/svnauthz*.exe`, `bin/SlikSvn-*.dll`, `bin/libsvn*.dll`,
+  `bin/engines/**`, `bin/System64/**`
+- Bundled version observed by `bin/svn.exe --version --quiet`: `1.14.5-SlikSvn`
+- Upstream: https://sliksvn.com/ and https://subversion.apache.org/
+- License: Apache License, Version 2.0
+
+SlikSVN packages Apache Subversion command-line tools for Windows. Apache Subversion is an Apache
+Software Foundation project licensed under Apache-2.0. Keep upstream license and notice obligations
+in mind when redistributing the binary payload.
+
+### OpenSSL runtime DLLs included by SlikSVN
+
+- Files: `bin/SlikSvn-libssl-3-x64.dll`, `bin/SlikSvn-libcrypto-3-x64.dll`,
+  `bin/engines/capi.dll`
+- Observed DLL product version: `3.0.16`
+- Upstream: https://openssl-library.org/
+- License: Apache License, Version 2.0
+
+### Microsoft Visual C++ runtime support files included by SlikSVN
+
+- Files: `bin/System64/*.dll`
+- These files are copied unmodified from the SlikSVN Windows installer payload.
+- Microsoft redistributable runtime license terms apply to these files.
+
+## dos2unix / unix2dos
+
+- Files: `bin/dos2unix.exe`, `bin/unix2dos.exe`, `bin/mac2unix.exe`, `bin/unix2mac.exe`,
+  as shipped by the upstream Windows 64-bit package
+- Bundled version observed by `bin/dos2unix.exe --version`: `7.5.6`
+- Upstream: https://dos2unix.sourceforge.io/ and https://waterlander.net/dos2unix/
+- License: FreeBSD-style license, GPL-compatible
+
+dos2unix is maintained by Erwin Waterlander. The upstream project publishes its distribution
+license as `COPYING.txt`; consult the upstream source distribution for the complete text.
+
+## Binary checksums
+
+SHA256 checksums for the bundled files are recorded in `THIRD_PARTY_CHECKSUMS.txt`.

package/dist/envelope.d.ts

@@ -0,0 +1,39 @@
+import type { ChangedPath, Conflict, Envelope, RunResult } from "./types.js";
+export declare function redactArgv(executable: string, args: string[]): string;
+export declare function quoteArgForDisplay(arg: string): string;
+export declare function redactText(value: string): string;
+export declare function summarizeText(text: string, maxLines?: number): {
+    text: string;
+    truncated: boolean;
+};
+export declare function createEnvelope(input: {
+    ok: boolean;
+    command: string;
+    cwd: string;
+    revision?: number | null | undefined;
+    changed_paths?: ChangedPath[] | undefined;
+    conflicts?: Conflict[] | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+    truncated?: boolean | undefined;
+    note?: string | undefined;
+}): Envelope;
+export declare function envelopeFromRun(input: {
+    ok?: boolean | undefined;
+    run: RunResult;
+    revision?: number | null | undefined;
+    changed_paths?: ChangedPath[] | undefined;
+    conflicts?: Conflict[] | undefined;
+    note?: string | undefined;
+    truncated?: boolean | undefined;
+}): Envelope;
+export declare function failEnvelope(command: string, cwd: string, note: string, extra?: Partial<Envelope>): Envelope;
+export declare function noteFromRun(run: RunResult): string;
+export declare function toToolResult<T extends Envelope>(payload: T): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: T;
+};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI7E,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBrE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAelH;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GAAG,QAAQ,CAgBX;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,EAAE,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,GAAG,QAAQ,CAaX;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAc5G;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAiClD;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,OAAO,EAAE,CAAC,GAAG;IAC5D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,CAAC,CAAC;CACtB,CAUA"}

package/dist/envelope.js

@@ -0,0 +1,137 @@
+const DEFAULT_SUMMARY_LINES = 200;
+export function redactArgv(executable, args) {
+    const redacted = [executable, ...args];
+    for (let index = 0; index < redacted.length; index += 1) {
+        const value = redacted[index] ?? "";
+        const arg = value.toLowerCase();
+        if ((arg === "--password" || arg === "--username") && index + 1 < redacted.length) {
+            redacted[index + 1] = "***";
+            continue;
+        }
+        if (arg.startsWith("--password=") || arg.startsWith("--username=")) {
+            const equalsIndex = value.indexOf("=");
+            redacted[index] = `${value.slice(0, equalsIndex)}=***`;
+            continue;
+        }
+        redacted[index] = redactText(redacted[index] ?? "");
+    }
+    return redacted.map(quoteArgForDisplay).join(" ");
+}
+export function quoteArgForDisplay(arg) {
+    if (arg.length === 0) {
+        return '""';
+    }
+    if (/[\s"]/.test(arg)) {
+        return `"${arg.replace(/"/g, '\\"')}"`;
+    }
+    return arg;
+}
+export function redactText(value) {
+    const withSafeUrl = redactUrlUserinfo(value);
+    return withSafeUrl.replace(/([?&](?:access_token|api[_-]?key|auth|key|pass(?:word)?|secret|token)=)[^&#\s]*/gi, "$1***");
+}
+function redactUrlUserinfo(value) {
+    return value.replace(/([a-z][a-z0-9+.-]*:\/\/)(?:[^\s/?#]*@)+/gi, "$1***:***@");
+}
+export function summarizeText(text, maxLines = DEFAULT_SUMMARY_LINES) {
+    if (!text) {
+        return { text: "", truncated: false };
+    }
+    const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const lines = normalized.split("\n");
+    if (lines.length <= maxLines) {
+        return { text: normalized, truncated: false };
+    }
+    return {
+        text: lines.slice(0, maxLines).join("\n"),
+        truncated: true
+    };
+}
+export function createEnvelope(input) {
+    const stdout = summarizeText(redactText(input.stdout ?? ""));
+    const stderr = summarizeText(redactText(input.stderr ?? ""));
+    return {
+        ok: input.ok,
+        command: input.command,
+        cwd: input.cwd,
+        revision: input.revision ?? null,
+        changed_paths: input.changed_paths ?? [],
+        conflicts: input.conflicts ?? [],
+        stdout_summary: stdout.text,
+        stderr_summary: stderr.text,
+        truncated: Boolean(input.truncated || stdout.truncated || stderr.truncated),
+        note: input.note ?? ""
+    };
+}
+export function envelopeFromRun(input) {
+    return createEnvelope({
+        ok: input.ok ?? input.run.exitCode === 0,
+        command: input.run.command,
+        cwd: input.run.cwd,
+        revision: input.revision ?? null,
+        changed_paths: input.changed_paths,
+        conflicts: input.conflicts,
+        stdout: input.run.stdout,
+        stderr: input.run.stderr,
+        truncated: input.truncated ?? input.run.truncated,
+        note: input.note ?? noteFromRun(input.run)
+    });
+}
+export function failEnvelope(command, cwd, note, extra) {
+    return {
+        ...createEnvelope({
+            ok: false,
+            command,
+            cwd,
+            note
+        }),
+        ...extra,
+        ok: false,
+        command,
+        cwd,
+        note
+    };
+}
+export function noteFromRun(run) {
+    if (run.timedOut) {
+        return "svn timed out";
+    }
+    if (run.errorCode === "ENOENT" || run.errorCode === "EACCES" || run.errorCode === "EPERM") {
+        return "MCP svn runtime unavailable (executable failed to launch) - failsafe: use scoped raw svn CLI for this session per svnrules; guard refusals are not failures and must never be bypassed via CLI";
+    }
+    const text = `${run.stderr}\n${run.stdout}`;
+    if (/E155004|E155036/.test(text)) {
+        return "working copy locked - run svn_cleanup";
+    }
+    if (/E215004|No more credentials|we tried too many times|E170001|authorization failed|Authentication failed/i.test(text)) {
+        return "authentication failed - fix svn cached auth outside the MCP";
+    }
+    if (/E175002|Unable to connect|Connection refused|Network is unreachable|Could not resolve hostname/i.test(text)) {
+        return "network or repository connection failed";
+    }
+    if (/E155007/.test(text)) {
+        return "path is not inside a working copy";
+    }
+    if (/E135000|inconsistent newlines|inconsistent line ending style/i.test(text)) {
+        return "inconsistent line endings - run eol_fix_verified on affected files";
+    }
+    if (/E200009|is not a working copy|unversioned/i.test(text)) {
+        return "target not versioned";
+    }
+    if (/E200030|sqlite|database is locked|database disk image is malformed/i.test(text)) {
+        return "working copy database problem - run svn_cleanup";
+    }
+    return run.exitCode === 0 ? "" : "svn command failed";
+}
+export function toToolResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2)
+            }
+        ],
+        structuredContent: payload
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"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"}

package/dist/eol.d.ts

@@ -0,0 +1,15 @@
+import type { EolCheckResult, EolKind, EolSniff, RunResult } from "./types.js";
+export declare function sniffEol(filePath: string, limitBytes?: number): Promise<EolSniff>;
+export declare function makeEolCheck(filePath: string, eolStyle: string | null): Promise<EolCheckResult>;
+export declare function convertEol(input: {
+    filePath: string;
+    target: "crlf" | "lf";
+    removeBom: boolean;
+    cwd: string;
+}): Promise<RunResult>;
+export declare function normalizeEolTarget(value: "crlf" | "lf" | undefined, eolStyle?: string | null): "crlf" | "lf";
+export declare function converterForEolTarget(target: "crlf" | "lf"): "unix2dos" | "dos2unix";
+export declare function expectedEolKind(eolStyle?: string | null): "crlf" | "lf" | null;
+export declare function isBinaryKind(kind: EolKind): boolean;
+export declare function displayPath(filePath: string, cwd: string): string;
+//# sourceMappingURL=eol.d.ts.map

package/dist/eol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eol.d.ts","sourceRoot":"","sources":["../src/eol.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK/E,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwClG;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CASrG;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,SAAS,CAAC,CAIrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAE5G;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,UAAU,CAEpF;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAe9E;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjE"}