svn-agent-mcp 1.0.0

package/dist/tools/selfcheck.d.ts

@@ -0,0 +1,5 @@
+import type { ToolEnvelope } from "../types.js";
+export declare function svnSelfCheck(input: {
+    cwd?: string;
+}): Promise<ToolEnvelope>;
+//# sourceMappingURL=selfcheck.d.ts.map

package/dist/tools/selfcheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfcheck.d.ts","sourceRoot":"","sources":["../../src/tools/selfcheck.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,YAAY,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CA4CjF"}

package/dist/tools/selfcheck.js

@@ -0,0 +1,91 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createEnvelope } from "../envelope.js";
+import { startupProbe } from "../runner.js";
+export async function svnSelfCheck(input) {
+    const root = await projectRoot();
+    const packageJson = JSON.parse(await fs.readFile(path.join(root, "package.json"), "utf8"));
+    const currentPath = path.join(root, "current");
+    const currentTarget = await readLinkTarget(currentPath);
+    const currentRelease = currentTarget ? path.basename(currentTarget) : null;
+    const releaseRoot = path.join(root, "releases", `v${packageJson.version}`);
+    const probe = await startupProbe(input.cwd ?? root);
+    const binFileCount = await countFiles(path.join(releaseRoot, "bin"));
+    const distFileCount = await countFiles(path.join(releaseRoot, "dist"));
+    const releasePrepare = packageJson.scripts?.["release:prepare"] ?? "";
+    const clean = packageJson.scripts?.clean ?? "";
+    const currentMatchesPackage = currentRelease === `v${packageJson.version}`;
+    const toolchainOk = probe.svn.ok && probe.dos2unix.ok && probe.unix2dos.ok;
+    const notes = [
+        currentMatchesPackage ? "" : "current release pointer does not match package version",
+        toolchainOk ? "" : "bundled SVN/EOL toolchain probe failed"
+    ].filter(Boolean);
+    return {
+        ...createEnvelope({
+            ok: currentMatchesPackage && binFileCount > 0 && distFileCount > 0 && toolchainOk,
+            command: "svn_self_check",
+            cwd: root,
+            note: notes.join("; ")
+        }),
+        server_version: packageJson.version,
+        package_version: packageJson.version,
+        current_path: currentPath,
+        current_target: currentTarget,
+        current_release: currentRelease,
+        current_matches_package: currentMatchesPackage,
+        release_root: releaseRoot,
+        bin_file_count: binFileCount,
+        dist_file_count: distFileCount,
+        release_prepare_available: releasePrepare.includes("scripts/prepare-release.mjs"),
+        clean_uses_node: clean.startsWith("node "),
+        toolchain_ok: toolchainOk,
+        startup_probe: probe
+    };
+}
+async function projectRoot() {
+    let current = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
+    while (true) {
+        const candidate = path.join(current, "package.json");
+        try {
+            await fs.access(candidate);
+            return current;
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current) {
+                throw new Error("could not locate package.json");
+            }
+            current = parent;
+        }
+    }
+}
+async function readLinkTarget(value) {
+    try {
+        const target = await fs.readlink(value);
+        return path.resolve(path.dirname(value), target);
+    }
+    catch {
+        return null;
+    }
+}
+async function countFiles(directory) {
+    try {
+        const entries = await fs.readdir(directory, { withFileTypes: true });
+        let count = 0;
+        for (const entry of entries) {
+            const child = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                count += await countFiles(child);
+            }
+            else if (entry.isFile()) {
+                count += 1;
+            }
+        }
+        return count;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=selfcheck.js.map

package/dist/tools/selfcheck.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,66 @@
+export type SvnStatusCode = "M" | "A" | "D" | "R" | "C" | "?" | "!" | "~" | "G" | "U" | "E";
+export interface ChangedPath {
+    status: string;
+    path: string;
+}
+export interface Conflict {
+    path: string;
+    type: "text" | "tree" | "prop";
+}
+export interface Envelope {
+    [key: string]: unknown;
+    ok: boolean;
+    command: string;
+    cwd: string;
+    revision: number | null;
+    changed_paths: ChangedPath[];
+    conflicts: Conflict[];
+    stdout_summary: string;
+    stderr_summary: string;
+    truncated: boolean;
+    note: string;
+}
+export type ToolEnvelope = Envelope;
+export interface WcInfo {
+    url: string | null;
+    repo_root: string | null;
+    wc_root: string | null;
+    revision: number | null;
+}
+export interface RunResult {
+    command: string;
+    cwd: string;
+    executable: string;
+    args: string[];
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    errorCode?: string | undefined;
+    truncated?: boolean | undefined;
+}
+export interface DiffFileSummary {
+    path: string;
+    added: number;
+    removed: number;
+    binary: boolean;
+}
+export interface DiffSummary {
+    per_file: DiffFileSummary[];
+    diff_excerpt: string;
+    truncated: boolean;
+}
+export type EolKind = "crlf" | "lf" | "mixed" | "none" | "binary" | "skipped-too-large" | "not-a-file";
+export interface EolSniff {
+    path: string;
+    kind: EolKind;
+    has_bom: boolean;
+    size: number;
+    sniff: "ok" | "skipped-too-large" | "not-a-file";
+}
+export interface EolCheckResult extends EolSniff {
+    eol_style: string | null;
+    mismatch: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE5F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AAEpC,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAEvG,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,GAAG,mBAAmB,GAAG,YAAY,CAAC;CAClD;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/README.md

@@ -0,0 +1,11 @@
+# Documentation
+
+- `SPEC.md` is the complete implementation contract.
+- `svnrules.md` contains the SVN workflow and commit policy the MCP encodes.
+- `toolrules.md` contains local command and PowerShell rules.
+- `decisions/` contains architecture decision records, including plug-and-play global registration and the external SVN MCP comparison decision.
+- `../CHANGELOG.md` records release history.
+
+Current shipped MCP release is `1.0.0`. Run `npm run prepare:local` after cloning to create the
+local ignored `current` release pointer, then use `svn_self_check` to verify it and the bundled
+runtime. Use `svn_diagnose` for read-only SVN working-copy health checks.