me2lon 0.0.0-stage → 0.1.0

package/dist/workspace-source.js

@@ -0,0 +1,387 @@
+import { createHash } from "node:crypto";
+import { lstat, open, readFile, readlink, realpath } from "node:fs/promises";
+import { constants } from "node:fs";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { spawn } from "node:child_process";
+import { Me2lonClientError } from "./errors.js";
+import { LOCAL_SOURCE_LIMITS, SOURCE_SCHEMA_VERSION, SNAPSHOT_SCHEMA_VERSION, } from "./types.js";
+const MAX_GIT_OUTPUT_BYTES = 64 * 1024 * 1024;
+const exactCommitPattern = /^[0-9a-f]{40}$/u;
+const utf8Decoder = new TextDecoder("utf-8", { fatal: true });
+async function runGit(root, args) {
+    return await new Promise((resolvePromise, reject) => {
+        const child = spawn("git", ["-C", root, ...args], {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: "0", LC_ALL: "C" },
+            windowsHide: true,
+        });
+        const stdout = [];
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        child.stdout.on("data", (chunk) => {
+            stdoutBytes += chunk.length;
+            if (stdoutBytes > MAX_GIT_OUTPUT_BYTES) {
+                child.kill();
+                reject(new Me2lonClientError("ME2LON_GIT_OUTPUT_LIMIT", "Git produced more repository metadata than the Me2lon client accepts."));
+                return;
+            }
+            stdout.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderrBytes += chunk.length;
+            if (stderrBytes > 64 * 1024) {
+                child.kill();
+            }
+        });
+        child.once("error", (error) => {
+            reject(new Me2lonClientError("ME2LON_GIT_UNAVAILABLE", "The Me2lon client could not run Git.", { cause: error }));
+        });
+        child.once("close", (code) => {
+            if (code !== 0) {
+                reject(new Me2lonClientError("ME2LON_GIT_FAILURE", "Git could not inspect the bound workspace and base commit."));
+                return;
+            }
+            resolvePromise(Buffer.concat(stdout));
+        });
+    });
+}
+export async function discoverWorkspace(directory) {
+    const root = await realpath(decodeUtf8(await runGit(resolve(directory), ["rev-parse", "--show-toplevel"]), "Git root").trim());
+    const head = decodeUtf8(await runGit(root, ["rev-parse", "--verify", "HEAD^{commit}"]), "Git HEAD").trim();
+    if (!exactCommitPattern.test(head))
+        throw new Me2lonClientError("ME2LON_BASE_COMMIT_INVALID", "A local Git repository with an initial commit is required.");
+    const branch = decodeUtf8(await runGit(root, ["rev-parse", "--abbrev-ref", "HEAD"]), "Git branch").trim();
+    return { root, head, branch: branch === "HEAD" ? null : branch };
+}
+async function snapshotFile(root, path, maximumBytes) {
+    const absolute = pathInsideRoot(root, path);
+    let parent = root;
+    for (const part of path.split("/")) {
+        parent = resolve(parent, part);
+        if ((await lstat(parent)).isSymbolicLink()) {
+            throw new Me2lonClientError("ME2LON_SOURCE_SYMLINK_UNSUPPORTED", `Symbolic link ${path} cannot be uploaded in a full snapshot.`);
+        }
+    }
+    if (!(await lstat(absolute)).isFile())
+        throw new Me2lonClientError("ME2LON_SOURCE_KIND_UNSUPPORTED", `Path ${path} is not a regular file; submodules and special files are unsupported.`);
+    const handle = await open(absolute, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+    try {
+        const before = await handle.stat();
+        if (!before.isFile() || before.size > maximumBytes)
+            throw new Me2lonClientError("ME2LON_SOURCE_FILE_LIMIT", `File ${path} is unsupported or exceeds the upload limit.`);
+        const buffer = Buffer.alloc(maximumBytes + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const { bytesRead } = await handle.read(buffer, length, buffer.length - length, null);
+            if (bytesRead === 0)
+                break;
+            length += bytesRead;
+        }
+        if (length > maximumBytes)
+            throw new Me2lonClientError("ME2LON_SOURCE_FILE_LIMIT", `File ${path} exceeds the upload limit.`);
+        const bytes = buffer.subarray(0, length);
+        const after = await handle.stat();
+        if (before.size !== after.size || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs ||
+            await realpath(absolute) !== absolute) {
+            throw new Me2lonClientError("ME2LON_WORKSPACE_CHANGED_DURING_READ", "The workspace changed during capture; retry the check.");
+        }
+        return bytes;
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Capture every supported Git-visible file, and verify the complete capture twice. */
+export async function buildWorkspaceSnapshot(workspace, limits = LOCAL_SOURCE_LIMITS) {
+    const before = await discoverWorkspace(workspace.root);
+    if (before.root !== workspace.root)
+        throw new Me2lonClientError("ME2LON_WORKSPACE_NOT_ROOT", "The bound Git root changed.");
+    const visible = await gitVisiblePaths(before.root);
+    const flags = await trackedPathFlags(before.root);
+    assertCompleteWorktree(flags);
+    const paths = [...await currentExistingPaths(before.root, visible)].sort(comparePaths);
+    checkLimits(paths.length, 0, 0, limits);
+    const files = [];
+    const captured = new Map();
+    let totalReplacementBytes = 0;
+    for (const path of paths) {
+        const bytes = await snapshotFile(before.root, path, limits.maxFileBytes);
+        totalReplacementBytes += bytes.length;
+        checkLimits(files.length + 1, bytes.length, totalReplacementBytes, limits);
+        const content = decodeUtf8(bytes, `File ${path}`);
+        if (content.includes("\0"))
+            throw new Me2lonClientError("ME2LON_SOURCE_NOT_UTF8", `File ${path} contains NUL bytes and cannot be uploaded.`);
+        files.push({ path, content });
+        captured.set(path, bytes);
+    }
+    for (const [path, bytes] of captured) {
+        if (!bytes.equals(await snapshotFile(before.root, path, limits.maxFileBytes))) {
+            throw new Me2lonClientError("ME2LON_WORKSPACE_CHANGED_DURING_READ", "The workspace changed during capture; retry the check.");
+        }
+    }
+    const after = await discoverWorkspace(before.root);
+    if (before.head !== after.head || before.branch !== after.branch ||
+        !visible.equals(await gitVisiblePaths(before.root)) || !flags.equals(await trackedPathFlags(before.root))) {
+        throw new Me2lonClientError("ME2LON_WORKSPACE_CHANGED_DURING_READ", "Git changed during capture; retry the check.");
+    }
+    if (files.length === 0)
+        throw new Me2lonClientError("ME2LON_SOURCE_EMPTY", "The project has no files to upload.");
+    return {
+        schemaVersion: SNAPSHOT_SCHEMA_VERSION, baseCommitSha: before.head, branchLabel: before.branch, files,
+        totalReplacementBytes,
+        digest: `sha256:${createHash("sha256").update(JSON.stringify({ head: before.head, files })).digest("hex")}`,
+    };
+}
+function decodeUtf8(bytes, context) {
+    try {
+        return utf8Decoder.decode(bytes);
+    }
+    catch (error) {
+        throw new Me2lonClientError("ME2LON_SOURCE_NOT_UTF8", `${context} is not valid UTF-8 and cannot be represented by ${SOURCE_SCHEMA_VERSION}.`, { cause: error });
+    }
+}
+function parseNullDelimited(bytes, context) {
+    const decoded = decodeUtf8(bytes, context);
+    const values = decoded.split("\0");
+    if (values.at(-1) === "") {
+        values.pop();
+    }
+    return values;
+}
+function validateGitPath(path) {
+    if (path === "" ||
+        path.includes("\0") ||
+        isAbsolute(path) ||
+        path.split("/").some((part) => part === "..") ||
+        path === ".git" ||
+        path.startsWith(".git/")) {
+        throw new Me2lonClientError("ME2LON_SOURCE_PATH_INVALID", "Git reported a path that cannot be uploaded safely.");
+    }
+}
+function pathInsideRoot(root, gitPath) {
+    validateGitPath(gitPath);
+    const absolutePath = resolve(root, ...gitPath.split("/"));
+    const fromRoot = relative(root, absolutePath);
+    if (fromRoot.startsWith(`..${sep}`) || fromRoot === ".." || isAbsolute(fromRoot)) {
+        throw new Me2lonClientError("ME2LON_SOURCE_PATH_INVALID", "Git reported a path outside the bound workspace.");
+    }
+    return absolutePath;
+}
+function comparePaths(left, right) {
+    return Buffer.compare(Buffer.from(left, "utf8"), Buffer.from(right, "utf8"));
+}
+async function baseTree(workspace) {
+    const raw = await runGit(workspace.root, [
+        "ls-tree",
+        "-r",
+        "-z",
+        "--full-tree",
+        workspace.baseCommitSha,
+    ]);
+    const entries = new Map();
+    for (const record of parseNullDelimited(raw, "A Git tree path")) {
+        const tab = record.indexOf("\t");
+        if (tab === -1) {
+            throw new Me2lonClientError("ME2LON_GIT_METADATA_INVALID", "Git returned an invalid base-tree record.");
+        }
+        const metadata = record.slice(0, tab).split(" ");
+        const path = record.slice(tab + 1);
+        validateGitPath(path);
+        const [mode, type, oid] = metadata;
+        if (!mode || !type || !oid) {
+            throw new Me2lonClientError("ME2LON_GIT_METADATA_INVALID", "Git returned incomplete base-tree metadata.");
+        }
+        entries.set(path, { mode, type, oid });
+    }
+    return entries;
+}
+async function gitVisiblePaths(root) {
+    return await runGit(root, [
+        "ls-files",
+        "-z",
+        "--cached",
+        "--others",
+        "--exclude-standard",
+    ]);
+}
+async function trackedPathFlags(root) {
+    return await runGit(root, ["ls-files", "-v", "-z"]);
+}
+function assertCompleteWorktree(raw) {
+    for (const record of parseNullDelimited(raw, "A Git tracked-path flag")) {
+        const tag = record.at(0);
+        if (tag === "S" || (tag !== undefined && /^[a-z]$/u.test(tag))) {
+            throw new Me2lonClientError("ME2LON_INCOMPLETE_WORKTREE", "The bound repository uses skip-worktree or assume-unchanged entries, so Me2lon cannot construct a complete source revision.");
+        }
+    }
+}
+async function changedPaths(workspace) {
+    return await runGit(workspace.root, [
+        "diff",
+        "--name-only",
+        "-z",
+        "--no-renames",
+        "--no-ext-diff",
+        "--no-textconv",
+        workspace.baseCommitSha,
+        "--",
+    ]);
+}
+async function currentExistingPaths(root, raw) {
+    const result = new Set();
+    for (const path of parseNullDelimited(raw, "A Git worktree path")) {
+        validateGitPath(path);
+        const absolutePath = pathInsideRoot(root, path);
+        try {
+            await lstat(absolutePath);
+            result.add(path);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    return result;
+}
+async function readBaseBlob(root, oid) {
+    return await runGit(root, ["cat-file", "blob", oid]);
+}
+function checkLimits(changes, fileBytes, totalBytes, limits) {
+    if (changes > limits.maxChanges) {
+        throw new Me2lonClientError("ME2LON_SOURCE_CHANGE_LIMIT", `The workspace revision exceeds the ${limits.maxChanges}-change client limit.`);
+    }
+    if (fileBytes > limits.maxFileBytes) {
+        throw new Me2lonClientError("ME2LON_SOURCE_FILE_LIMIT", `A replacement exceeds the ${limits.maxFileBytes}-byte client limit.`);
+    }
+    if (totalBytes > limits.maxTotalBytes) {
+        throw new Me2lonClientError("ME2LON_SOURCE_TOTAL_LIMIT", `The workspace revision exceeds the ${limits.maxTotalBytes}-byte aggregate client limit.`);
+    }
+}
+export async function bindWorkspace(requestedRoot, repositoryId, requestedBaseCommit) {
+    if (!repositoryId.trim()) {
+        throw new Me2lonClientError("ME2LON_REPOSITORY_REQUIRED", "A repository id is required.");
+    }
+    if (!exactCommitPattern.test(requestedBaseCommit)) {
+        throw new Me2lonClientError("ME2LON_BASE_COMMIT_NOT_EXACT", "The base commit must be a full 40-character hexadecimal Git commit id, not a branch or abbreviated revision.");
+    }
+    const root = await realpath(resolve(requestedRoot));
+    const reportedRoot = decodeUtf8(await runGit(root, ["rev-parse", "--show-toplevel"]), "The Git workspace root").trim();
+    const canonicalRoot = await realpath(reportedRoot);
+    if (canonicalRoot !== root) {
+        throw new Me2lonClientError("ME2LON_WORKSPACE_NOT_ROOT", "The MCP workspace must be bound to the Git repository root, not a parent or subdirectory.");
+    }
+    const canonicalCommit = decodeUtf8(await runGit(root, [
+        "rev-parse",
+        "--verify",
+        `${requestedBaseCommit}^{commit}`,
+    ]), "The Git base commit").trim();
+    if (!exactCommitPattern.test(canonicalCommit)) {
+        throw new Me2lonClientError("ME2LON_BASE_COMMIT_INVALID", "Git did not resolve the requested object to an exact commit id.");
+    }
+    return {
+        root,
+        repositoryId: repositoryId.trim(),
+        baseCommitSha: canonicalCommit,
+    };
+}
+export async function buildWorkspaceSource(workspace, limits = LOCAL_SOURCE_LIMITS) {
+    const [tree, visibleBeforeRaw, changedBeforeRaw, pathFlagsRaw] = await Promise.all([
+        baseTree(workspace),
+        gitVisiblePaths(workspace.root),
+        changedPaths(workspace),
+        trackedPathFlags(workspace.root),
+    ]);
+    assertCompleteWorktree(pathFlagsRaw);
+    const visible = await currentExistingPaths(workspace.root, visibleBeforeRaw);
+    const candidatePaths = new Set(parseNullDelimited(changedBeforeRaw, "A changed Git path"));
+    for (const path of visible) {
+        if (!tree.has(path)) {
+            candidatePaths.add(path);
+        }
+    }
+    for (const path of tree.keys()) {
+        if (!visible.has(path)) {
+            candidatePaths.add(path);
+        }
+    }
+    const changes = [];
+    let replacementCount = 0;
+    let deletionCount = 0;
+    let totalReplacementBytes = 0;
+    for (const path of [...candidatePaths].sort(comparePaths)) {
+        validateGitPath(path);
+        const base = tree.get(path);
+        if (!visible.has(path)) {
+            if (base) {
+                changes.push({ operation: "delete", path });
+                deletionCount += 1;
+                checkLimits(changes.length, 0, totalReplacementBytes, limits);
+            }
+            continue;
+        }
+        const absolutePath = pathInsideRoot(workspace.root, path);
+        const before = await lstat(absolutePath);
+        if (before.isSymbolicLink()) {
+            if (!base || base.mode !== "120000" || base.type !== "blob") {
+                throw new Me2lonClientError("ME2LON_SOURCE_SYMLINK_UNSUPPORTED", `Changed symbolic link ${path} cannot be represented by ${SOURCE_SCHEMA_VERSION}.`);
+            }
+            const [target, original] = await Promise.all([
+                readlink(absolutePath, "utf8"),
+                readBaseBlob(workspace.root, base.oid),
+            ]);
+            if (!Buffer.from(target, "utf8").equals(original)) {
+                throw new Me2lonClientError("ME2LON_SOURCE_SYMLINK_UNSUPPORTED", `Changed symbolic link ${path} cannot be represented by ${SOURCE_SCHEMA_VERSION}.`);
+            }
+            continue;
+        }
+        if (base?.type === "commit") {
+            throw new Me2lonClientError("ME2LON_SOURCE_SUBMODULE_UNSUPPORTED", `Changed submodule ${path} cannot be represented by ${SOURCE_SCHEMA_VERSION}.`);
+        }
+        if (!before.isFile()) {
+            throw new Me2lonClientError("ME2LON_SOURCE_KIND_UNSUPPORTED", `Changed path ${path} is not a regular UTF-8 file.`);
+        }
+        checkLimits(changes.length, before.size, totalReplacementBytes, limits);
+        const bytes = await readFile(absolutePath);
+        const after = await lstat(absolutePath);
+        if (before.size !== after.size ||
+            before.mtimeMs !== after.mtimeMs ||
+            before.ctimeMs !== after.ctimeMs) {
+            throw new Me2lonClientError("ME2LON_WORKSPACE_CHANGED_DURING_READ", "The workspace changed while Me2lon was preparing its revision; retry the check.");
+        }
+        checkLimits(changes.length + 1, bytes.length, totalReplacementBytes + bytes.length, limits);
+        if (base?.type === "blob") {
+            const original = await readBaseBlob(workspace.root, base.oid);
+            if (bytes.equals(original)) {
+                continue;
+            }
+        }
+        const content = decodeUtf8(bytes, `Replacement ${path}`);
+        changes.push({ operation: "replace", path, content });
+        replacementCount += 1;
+        totalReplacementBytes += bytes.length;
+    }
+    const [visibleAfterRaw, changedAfterRaw] = await Promise.all([
+        gitVisiblePaths(workspace.root),
+        changedPaths(workspace),
+    ]);
+    if (!visibleBeforeRaw.equals(visibleAfterRaw) ||
+        !changedBeforeRaw.equals(changedAfterRaw)) {
+        throw new Me2lonClientError("ME2LON_WORKSPACE_CHANGED_DURING_READ", "The workspace changed while Me2lon was preparing its revision; retry the check.");
+    }
+    const digestPayload = JSON.stringify({
+        schemaVersion: SOURCE_SCHEMA_VERSION,
+        baseCommitSha: workspace.baseCommitSha,
+        changes,
+    });
+    return {
+        schemaVersion: SOURCE_SCHEMA_VERSION,
+        baseCommitSha: workspace.baseCommitSha,
+        changes,
+        digest: `sha256:${createHash("sha256").update(digestPayload).digest("hex")}`,
+        replacementCount,
+        deletionCount,
+        totalReplacementBytes,
+    };
+}
+//# sourceMappingURL=workspace-source.js.map

package/dist/workspace-source.js.map

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

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "me2lon",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "CLI and portable agent skill for the Me2lon API",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "bin": {
+    "me2lon": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/mcp.ts",
+    "skill",
+    "README.md",
+    "LICENSE",
+    "tsconfig.json",
+    "tsconfig.build.json"
+  ],
+  "scripts": {
+    "build": "node --input-type=module -e \"import {rm} from 'node:fs/promises'; await rm('dist', {recursive:true, force:true})\" && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test test/*.test.ts",
+    "verify": "npm run typecheck && npm test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0",
+    "@modelcontextprotocol/sdk": "1.32.2",
+    "zod": "4.6.7"
+  },
+  "license": "MIT",
+  "homepage": "https://me2lon.clarus.me/cli"
+}

package/skill/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guillaume Claret
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skill/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: me2lon
+description: Analyze a local JavaScript or TypeScript backend through the Me2lon CLI, retrieve findings, and explain their evidence and limitations. Use when the user requests Me2lon analysis or results.
+---
+
+# Me2lon
+
+Use the installed `me2lon` CLI. Install with `npm install -g me2lon` when requested.
+The default service is https://me2lon.clarus.me and currently requires an invited GitHub identity.
+
+1. Work from the intended Git root, with an initial commit. Snapshots include tracked and nonignored untracked files and uncommitted changes. Limits: 2,000 files, 1 MiB per file, 8 MiB total. Binary files, symlinks, submodules and sparse/assume-unchanged entries are rejected. Do not change ignore rules or omit source just to make analysis pass. `--project-root` selects analysis scope; it does not filter the upload.
+2. If authorization is needed, run `me2lon setup --json`. Give the browser link and code from stderr to the human and keep setup running while they approve. Never approve on their behalf or ask them to paste tokens. Renewal preserves project history; a revoked credential needs `setup --new-credential`.
+3. Run `me2lon analyze --wait --json`, optionally with `--project-root PATH`. Progress goes to stderr; the final result is JSON on stdout. Preserve job and workspace revision IDs. For ambiguous selection, use `analyze --revision-id ID --project-root PATH` on the existing snapshot.
+4. Resume with `me2lon get-job --job-id ID --wait --json`. The default waiting timeout is two hours; use `--timeout-seconds` if needed. Interrupting the client does not cancel the job. Cancellation requires `me2lon cancel-job --job-id ID` and the user's intent to cancel.
+5. Explain findings, checked scope, limitations, and unsupported or pending work. `jobStatus` is execution state; `resultStatus` is the analysis assessment. A successful job does not mean every property is proved. Distinguish formal evidence from AI assessments and unsuccessful attempts; general analysis does not establish policy compliance.
+6. After requested source changes, analyze again to capture the new revision. Do not edit the source or repeatedly resubmit failed jobs without a concrete reason within the user's task.
+
+Credentials live outside the source tree. Never print their contents. Use `me2lon --help` for additional commands; policy approval remains a human action.