@foundation0/git 1.0.0 → 1.2.1

package/packages/fs/src/index.ts

@@ -1,33 +0,0 @@
-export { createGitFs, defaultGitFs, promises } from './git-fs'
-export {
-  access,
-  accessSync,
-  appendFile,
-  appendFileSync,
-  copyFile,
-  copyFileSync,
-  exists,
-  existsSync,
-  lstat,
-  lstatSync,
-  mkdir,
-  mkdirSync,
-  readFile,
-  readFileSync,
-  readdir,
-  readdirSync,
-  rename,
-  renameSync,
-  rm,
-  rmSync,
-  rmdir,
-  rmdirSync,
-  stat,
-  statSync,
-  unlink,
-  unlinkSync,
-  writeFile,
-  writeFileSync,
-} from './git-fs'
-export { mountGitFs, type MountedGitFsHandle } from './mount'
-export type { GitFsOptions, GitFsDirentLike, GitFsStats, GitFsInstance } from './git-fs'

package/packages/fs/src/mount.ts

@@ -1,297 +0,0 @@
-import { createRequire } from 'node:module'
-import { createGitFs, type GitFsOptions } from './git-fs'
-
-type MountedFuse = {
-  mount: (path: string, operations: Record<string, unknown>, callback: (error?: Error | null) => void) => void
-  unmount: (path: string, callback: (error?: Error | null) => void) => void
-}
-
-type MountBackend = 'auto' | 'fuse-bindings' | 'node-fuse-bindings' | 'dokan' | 'winfsp'
-
-type GitFsMountOptions = GitFsOptions & {
-  mountPoint: string
-  backend?: MountBackend
-  readOnly?: boolean
-}
-
-type MountedGitFsHandle = {
-  unmount(): Promise<void>
-}
-
-type FuseErrorMap = Record<string, number>
-
-const errnoMap: FuseErrorMap = {
-  EACCES: -13,
-  EEXIST: -17,
-  EIO: -5,
-  EISDIR: -21,
-  ENOENT: -2,
-  ENOTEMPTY: -39,
-  ENOTDIR: -20,
-  ENOSYS: -38,
-  EROFS: -30,
-}
-
-const toFuseErrno = (error: unknown): number => {
-  const code = (error as { code?: unknown })?.code
-  if (typeof code === 'string' && code in errnoMap) {
-    return errnoMap[code]
-  }
-
-  return -5
-}
-
-const toFileData = (value: unknown): Buffer => {
-  if (Buffer.isBuffer(value)) {
-    return value
-  }
-
-  if (typeof value === 'string') {
-    return Buffer.from(value)
-  }
-
-  return Buffer.from([])
-}
-
-const toFuseNames = (entries: (string | { name: string })[]): string[] =>
-  entries.map((entry) => (typeof entry === 'string' ? entry : entry.name))
-
-const getBackendOrder = (backend?: MountBackend): string[] => {
-  if (backend === 'dokan') {
-    return ['node-fuse-bindings']
-  }
-
-  if (backend === 'winfsp') {
-    return ['node-fuse-bindings', 'fuse-bindings']
-  }
-
-  if (backend === 'fuse-bindings' || backend === 'node-fuse-bindings') {
-    return [backend]
-  }
-
-  if (process.platform === 'win32') {
-    return ['node-fuse-bindings', 'fuse-bindings']
-  }
-
-  return ['fuse-bindings']
-}
-
-const getBackendName = (backend?: MountBackend): string => {
-  if (!backend || backend === 'auto') {
-    return process.platform === 'win32' ? 'dokan-or-fuse' : 'fuse'
-  }
-
-  return backend
-}
-
-const loadFuseBindings = (backend?: MountBackend): MountedFuse => {
-  const require = createRequire(import.meta.url)
-  const attemptOrder = getBackendOrder(backend)
-  const isBunRuntime = Boolean(process.versions.bun)
-  const errors: { name: string; error: unknown }[] = []
-
-  for (const name of attemptOrder) {
-    try {
-      return require(name) as MountedFuse
-    } catch (error) {
-      errors.push({ name, error })
-    }
-  }
-
-  const winfspHint = process.platform === 'win32'
-    ? 'For Windows, install Dokany + node-fuse-bindings (backend=dokan) or try installing fuse-bindings from source.'
-    : ''
-
-  const bunHint = isBunRuntime && process.platform === 'win32'
-    ? 'Bun uses a separate native ABI (24.x in this environment) and these FUSE packages are not loading successfully under Bun.'
-      + '\nUse Node.js runtime instead (for example via a TS runner) or WSL.'
-    : ''
-
-  const details = errors
-    .map(({ name, error }) => {
-      const message = error instanceof Error ? error.message : String(error)
-      return `- ${name}: ${message}`
-    })
-    .join('\n')
-
-  throw new Error(
-    `mount backend ${getBackendName(backend)} could not be loaded from ${attemptOrder.join(', ')}.\n`
-    + `Missing dependency or failed native binding installation.\n${details}\n${winfspHint}\n${bunHint}`
-      .trim(),
-  )
-}
-
-const runFuseOp = async <T>(task: () => Promise<T>, cb: (code: number, value?: T) => void): Promise<void> => {
-  try {
-    const value = await task()
-    cb(0, value)
-  } catch (error) {
-    cb(toFuseErrno(error))
-  }
-
-  return Promise.resolve()
-}
-
-export { type MountedGitFsHandle }
-
-export const mountGitFs = async (options: GitFsMountOptions): Promise<MountedGitFsHandle> => {
-  const {
-    mountPoint,
-    readOnly = false,
-    backend,
-    ...fsOptions
-  } = options
-  const fs = createGitFs(fsOptions)
-  const fuse = loadFuseBindings(backend)
-
-  const readonlyError = () => toFuseErrno({ code: 'EROFS' })
-  const operations: Record<string, unknown> = {
-    readdir: (path: string, cb: (code: number, names?: string[]) => void) => {
-      void runFuseOp(async () => {
-        const entries = await fs.readdir(path)
-        return ['.', '..', ...toFuseNames(entries)]
-      }, cb)
-    },
-
-    getattr: (path: string, cb: (code: number, stats?: unknown) => void) => {
-      void runFuseOp(async () => {
-        const stats = await fs.stat(path)
-        return {
-          mtime: stats.mtime,
-          atime: stats.atime,
-          ctime: stats.ctime,
-          nlink: stats.isDirectory() ? 2 : 1,
-          size: stats.size,
-          mode: stats.isDirectory() ? 0o040755 : 0o100644,
-          uid: 0,
-          gid: 0,
-        }
-      }, cb)
-    },
-
-    open: (_path: string, cb: (code: number, fd?: number) => void) => {
-      cb(0, 0)
-    },
-
-    release: (_path: string, _fd: number, cb: (code: number) => void) => {
-      cb(0)
-    },
-
-    read: (
-      path: string,
-      _fd: number,
-      buffer: Buffer,
-      length: number,
-      offset: number,
-      cb: (code: number, bytesRead?: number) => void,
-    ) => {
-      void runFuseOp(async () => {
-        const data = toFileData(await fs.readFile(path))
-        const bytesRead = data.slice(offset, offset + length).copy(buffer)
-        return bytesRead
-      }, cb)
-    },
-
-    write: readOnly
-      ? (_: string, _fd: number, _buffer: Buffer, _length: number, _offset: number, cb: (code: number, bytes?: number) => void) => {
-          cb(readonlyError())
-        }
-      : (
-          path: string,
-          _fd: number,
-          buffer: Buffer,
-          length: number,
-          offset: number,
-          cb: (code: number, bytes?: number) => void,
-        ) => {
-          void runFuseOp(async () => {
-            const current = await fs.readFile(path).catch(() => Buffer.from([]))
-            const existing = toFileData(current)
-            const incoming = Buffer.from(buffer).slice(0, length)
-            const merged = Buffer.alloc(Math.max(existing.length, offset + incoming.length))
-            existing.copy(merged)
-            incoming.copy(merged, offset)
-            await fs.writeFile(path, merged)
-            return incoming.length
-          }, cb)
-        },
-
-    create: readOnly
-      ? (_: string, _mode: number, cb: (code: number, fd?: number) => void) => {
-          cb(readonlyError())
-        }
-      : async (path: string, _mode: number, cb: (code: number, fd?: number) => void) => {
-          void runFuseOp(async () => {
-            await fs.writeFile(path, '')
-            return 0
-          }, cb)
-        },
-
-    truncate: readOnly
-      ? (_path: string, _size: number, cb: (code: number) => void) => {
-          cb(readonlyError())
-        }
-      : async (path: string, size: number, cb: (code: number) => void) => {
-          void runFuseOp(async () => {
-            const bytes = toFileData(await fs.readFile(path))
-            await fs.writeFile(path, bytes.slice(0, size))
-          }, cb as (code: number, _value?: void) => void)
-        },
-
-    unlink: readOnly
-      ? (_path: string, cb: (code: number) => void) => {
-          cb(readonlyError())
-        }
-      : async (path: string, cb: (code: number) => void) => {
-          void runFuseOp(async () => {
-            await fs.unlink(path)
-          }, cb as (code: number, _value?: void) => void)
-        },
-
-    rmdir: readOnly
-      ? (_path: string, cb: (code: number) => void) => {
-          cb(readonlyError())
-        }
-      : async (path: string, cb: (code: number) => void) => {
-          void runFuseOp(async () => {
-            await fs.rmdir(path)
-          }, cb as (code: number, _value?: void) => void)
-        },
-
-    rename: readOnly
-      ? (_source: string, _destination: string, cb: (code: number) => void) => {
-          cb(readonlyError())
-        }
-      : async (source: string, destination: string, cb: (code: number) => void) => {
-          void runFuseOp(async () => {
-            await fs.rename(source, destination)
-          }, cb as (code: number, _value?: void) => void)
-        },
-  }
-
-  await new Promise<void>((resolve, reject) => {
-    fuse.mount(mountPoint, operations, (error?: Error | null) => {
-      if (error) {
-        reject(error)
-        return
-      }
-
-      resolve()
-    })
-  })
-
-  return {
-    unmount: () => {
-      return new Promise<void>((resolve, reject) => {
-        fuse.unmount(mountPoint, (error?: Error | null) => {
-          if (error) {
-            reject(error)
-            return
-          }
-
-          resolve()
-        })
-      })
-    },
-  }
-}

package/packages/fs/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "types": ["node"]
-  },
-  "include": ["src"]
-}

package/packages/git/mcp/tests/e2e/git-mcp-e2e.spec.ts

@@ -1,157 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it } from 'vitest'
-import { resolve } from 'node:path'
-
-import { GitMcpClient } from '../../src'
-
-const fixturePath = resolve(process.cwd(), 'tests/e2e/server.fixture.ts')
-
-const connectClient = async (args: string[] = []): Promise<GitMcpClient> => {
-  const client = new GitMcpClient({
-    name: 'mcp-e2e-client',
-    version: '1.0.0',
-  })
-
-  await client.connect('bun', ['run', fixturePath, ...args])
-  return client
-}
-
-describe('mcp e2e server/client', () => {
-  let client: GitMcpClient
-
-  beforeEach(async () => {
-    client = await connectClient()
-  })
-
-  afterEach(async () => {
-    await client.close()
-  })
-
-  it('registers issue tools', async () => {
-    const tools = await client.listTools()
-
-    expect(tools).toContain('repo.issue.create')
-    expect(tools).toContain('repo.issue.list')
-    expect(tools).toContain('repo.contents.create')
-    expect(tools).toContain('repo.contents.view')
-    expect(tools).toContain('repo.contents.list')
-    expect(tools).toContain('repo.contents.update')
-    expect(tools).toContain('repo.contents.delete')
-  })
-
-  it('executes an api tool and returns execution payload', async () => {
-    const response = await client.call('repo.issue.create', {
-      options: {
-        data: {
-          title: 'Bug report',
-          body: 'Crash repro steps',
-        },
-      },
-    })
-
-    expect(response.isError).toBe(false)
-    expect(response.data).toMatchObject({
-      status: 201,
-      ok: true,
-      body: {
-        ok: true,
-        action: 'issue.create',
-        method: 'POST',
-      },
-    })
-  })
-
-  it('executes contents create and list tools', async () => {
-    const createResponse = await client.call('repo.contents.create', {
-      args: ['README.md'],
-      options: {
-        data: {
-          content: 'cmVhZGVtZSBmaWxl',
-          message: 'create file',
-        },
-      },
-    })
-
-    expect(createResponse.isError).toBe(false)
-    expect(createResponse.data).toMatchObject({
-      status: 200,
-      ok: true,
-      body: {
-        action: 'repo-mock',
-        method: 'POST',
-        path: '/repos/example-org/example-repo/contents/README.md',
-      },
-    })
-
-    const viewResponse = await client.call('repo.contents.view', {
-      args: ['README.md'],
-    })
-
-    expect(viewResponse.isError).toBe(false)
-    expect(viewResponse.data).toMatchObject({
-      status: 200,
-      ok: true,
-      body: {
-        action: 'repo-mock',
-        method: 'GET',
-        path: '/repos/example-org/example-repo/contents/README.md',
-      },
-    })
-
-    const listResponse = await client.call('repo.contents.list', {
-      args: ['docs'],
-    })
-
-    expect(listResponse.isError).toBe(false)
-    expect(listResponse.data).toMatchObject({
-      status: 200,
-      ok: true,
-      body: {
-        action: 'repo-mock',
-        method: 'GET',
-        path: '/repos/example-org/example-repo/contents/docs',
-      },
-    })
-  })
-
-  it('honors tool name prefix in server configuration', async () => {
-    const prefixedClient = await connectClient(['--tools-prefix=git'])
-    const tools = await prefixedClient.listTools()
-
-    await prefixedClient.close()
-
-    expect(tools).toContain('git.repo.issue.create')
-  })
-
-  it('registers and executes batch tool', async () => {
-    const tools = await client.listTools()
-    const response = await client.call('batch', {
-      calls: [
-        {
-          tool: 'repo.issue.create',
-          options: {
-            data: {
-              title: 'Bug report from batch',
-              body: 'Crash repro steps',
-            },
-          },
-        },
-        {
-          tool: 'repo.contents.list',
-          args: ['docs'],
-        },
-      ],
-    })
-
-    expect(tools).toContain('batch')
-    expect(response.isError).toBe(false)
-    expect(Array.isArray(response.data)).toBe(true)
-    expect(response.data).toMatchObject([
-      { index: 0, tool: 'repo.issue.create', isError: false },
-      { index: 1, tool: 'repo.contents.list', isError: false },
-    ])
-  })
-
-  it('throws a transport error for unknown tools', async () => {
-    await expect(client.call('repo.issue.invalid')).rejects.toThrow()
-  })
-})

package/packages/git/mcp/tests/e2e/server.fixture.ts

@@ -1,109 +0,0 @@
-import { createGitMcpServer } from '../../src/server'
-
-const toolsPrefixArg = process.argv.find((value) => value.startsWith('--tools-prefix='))
-const toolsPrefix = toolsPrefixArg?.slice('--tools-prefix='.length)
-const toolsPrefixNormalized = toolsPrefix && toolsPrefix.trim().length > 0 ? toolsPrefix : undefined
-
-type MockResponseBody = Record<string, unknown>
-
-const jsonResponse = (body: MockResponseBody, status = 200): Response =>
-  new Response(JSON.stringify(body), {
-    status,
-    headers: {
-      'content-type': 'application/json',
-    },
-  })
-
-const parseJsonBody = async (body: BodyInit | null | undefined): Promise<unknown> => {
-  if (body === null || body === undefined) {
-    return null
-  }
-
-  if (typeof body === 'string' || body instanceof String) {
-    try {
-      return JSON.parse(String(body))
-    } catch {
-      return String(body)
-    }
-  }
-
-  try {
-    return await new Response(body).json()
-  } catch {
-    return String(body)
-  }
-}
-
-// Lightweight transport-safe mock for fetch so the MCP fixture never touches the network.
-globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {
-  const requestUrl = String(input)
-  const method = (init?.method ?? 'GET').toUpperCase()
-  const parsedUrl = new URL(requestUrl)
-  const body = await parseJsonBody(init?.body)
-
-  const query: Record<string, string> = Object.fromEntries(parsedUrl.searchParams.entries())
-
-  if (parsedUrl.pathname.endsWith('/repos/example-org/example-repo/issues')) {
-    if (method === 'POST') {
-      return jsonResponse(
-        {
-          ok: true,
-          action: 'issue.create',
-          method,
-          path: parsedUrl.pathname,
-          query,
-          body,
-        },
-        201,
-      )
-    }
-
-    return jsonResponse({
-      ok: true,
-      action: 'issue.list',
-      method,
-      path: parsedUrl.pathname,
-      query,
-      body,
-    })
-  }
-
-  if (parsedUrl.pathname.includes('/api/v1/repos/example-org/example-repo')) {
-    return jsonResponse({
-      ok: true,
-      action: 'repo-mock',
-      method,
-      path: parsedUrl.pathname,
-      query,
-      body,
-    })
-  }
-
-  return jsonResponse({
-    ok: true,
-    action: 'generic',
-    method,
-    path: parsedUrl.pathname,
-    query,
-    body,
-  })
-}
-
-const fixture = createGitMcpServer({
-  toolsPrefix: toolsPrefixNormalized,
-  config: {
-    platform: 'GITEA',
-    giteaHost: 'https://gitea.example.com',
-    giteaToken: 'e2e-token',
-  },
-  defaultOwner: 'example-org',
-  defaultRepo: 'example-repo',
-})
-
-await fixture.run()
-
-await new Promise<void>((resolve) => {
-  process.stdin.on('close', resolve)
-  process.on('SIGINT', resolve)
-  process.on('SIGTERM', resolve)
-})

package/packages/git/node_modules/.bin/tsc

@@ -1,21 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/node_modules"
-else
-  export NODE_PATH="/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/node_modules:$NODE_PATH"
-fi
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
-else
-  exec node  "$basedir/../typescript/bin/tsc" "$@"
-fi

package/packages/git/node_modules/.bin/tsc.CMD

@@ -1,12 +0,0 @@
-@SETLOCAL
-@IF NOT DEFINED NODE_PATH (
-  @SET "NODE_PATH=C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\bin\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\node_modules"
-) ELSE (
-  @SET "NODE_PATH=C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\bin\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\node_modules;%NODE_PATH%"
-)
-@IF EXIST "%~dp0\node.exe" (
-  "%~dp0\node.exe"  "%~dp0\..\typescript\bin\tsc" %*
-) ELSE (
-  @SET PATHEXT=%PATHEXT:;.JS;=;%
-  node  "%~dp0\..\typescript\bin\tsc" %*
-)

package/packages/git/node_modules/.bin/tsc.ps1

@@ -1,41 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-$pathsep=":"
-$env_node_path=$env:NODE_PATH
-$new_node_path="C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\bin\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules\typescript\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\typescript@5.9.3\node_modules;C:\Users\marko\Dev\F0\git\node_modules\.pnpm\node_modules"
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-  $pathsep=";"
-} else {
-  $new_node_path="/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/typescript@5.9.3/node_modules:/mnt/c/Users/marko/Dev/F0/git/node_modules/.pnpm/node_modules"
-}
-if ([string]::IsNullOrEmpty($env_node_path)) {
-  $env:NODE_PATH=$new_node_path
-} else {
-  $env:NODE_PATH="$new_node_path$pathsep$env_node_path"
-}
-
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-}
-$env:NODE_PATH=$env_node_path
-exit $ret