@foss.global/gitmanager 0.2.0

package/.smartconfig.json

@@ -0,0 +1,42 @@
+{
+  "@git.zone/cli": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "foss.global",
+      "gitrepo": "gitmanager",
+      "description": "Headless Git manager for the foss.global Git platform, with a TypeScript API and Rust engine.",
+      "npmPackagename": "@foss.global/gitmanager",
+      "license": "MIT",
+      "projectDomain": "foss.global",
+      "keywords": [
+        "foss.global",
+        "git",
+        "gitmanager",
+        "forge",
+        "rust",
+        "typescript",
+        "smartrust",
+        "tsrust"
+      ]
+    },
+    "release": {
+      "targets": {
+        "npm": {
+          "registries": [
+            "https://verdaccio.lossless.digital",
+            "https://registry.npmjs.org"
+          ],
+          "accessLevel": "public"
+        }
+      }
+    },
+    "schemaVersion": 2
+  },
+  "@git.zone/tsrust": {
+    "targets": [
+      "linux_amd64",
+      "linux_arm64"
+    ]
+  }
+}

package/changelog.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 2026-06-22 - 0.2.0
+
+### Features
+
+- add TypeScript facade and Rust-backed Git repository engine (core)
+  - Add GitManager lifecycle, status, repository, ref, tree, file, and commit APIs.
+  - Implement a typed smartrust bridge and Rust IPC management loop for local Git operations.
+  - Add package configuration, Rust workspace setup, and integration tests.

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@foss.global/gitmanager',
+    version: '0.2.0',
+    description: 'Headless Git manager for the foss.global Git platform, with a TypeScript API and Rust engine.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLCtGQUErRjtDQUM3RyxDQUFBIn0=

package/dist_ts/classes.gitmanager.d.ts

@@ -0,0 +1,23 @@
+import * as plugins from './plugins.js';
+import type { IGitManagerCommitSummary, IGitManagerFileContent, IGitManagerImportMirrorRequest, IGitManagerInitBareRepositoryRequest, IGitManagerListCommitsRequest, IGitManagerReadFileRequest, IGitManagerRef, IGitManagerRefRequest, IGitManagerRepositoryInfo, IGitManagerStatus, IGitManagerTreeEntry, IGitManagerTreeRequest, IGitManagerOptions } from './models.js';
+export declare class GitManager extends plugins.EventEmitter {
+    private bridge;
+    private started;
+    private startPromise;
+    private stopRequested;
+    private config;
+    constructor(optionsArg?: IGitManagerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): Promise<IGitManagerStatus>;
+    get running(): boolean;
+    initBareRepository(requestArg: IGitManagerInitBareRepositoryRequest): Promise<IGitManagerRepositoryInfo>;
+    importMirror(requestArg: IGitManagerImportMirrorRequest): Promise<IGitManagerRepositoryInfo>;
+    listRepositories(): Promise<IGitManagerRepositoryInfo[]>;
+    listRefs(requestArg: IGitManagerRefRequest): Promise<IGitManagerRef[]>;
+    listTree(requestArg: IGitManagerTreeRequest): Promise<IGitManagerTreeEntry[]>;
+    readFile(requestArg: IGitManagerReadFileRequest): Promise<IGitManagerFileContent>;
+    listCommits(requestArg: IGitManagerListCommitsRequest): Promise<IGitManagerCommitSummary[]>;
+    private startInternal;
+    private assertRunning;
+}

package/dist_ts/classes.gitmanager.js

@@ -0,0 +1,130 @@
+import * as plugins from './plugins.js';
+import { RustGitManagerBridge } from './rust-gitmanager-bridge.js';
+export class GitManager extends plugins.EventEmitter {
+    constructor(optionsArg = {}) {
+        super();
+        this.bridge = new RustGitManagerBridge();
+        this.started = false;
+        this.startPromise = null;
+        this.stopRequested = false;
+        this.config = {
+            dataDir: optionsArg.dataDir ?? plugins.path.resolve(process.cwd(), '.nogit', 'gitmanager'),
+        };
+        this.bridge.on('exit', (code, signal) => {
+            this.started = false;
+            this.emit('exit', code, signal);
+        });
+        this.bridge.on('stderr', (line) => {
+            this.emit('stderr', line);
+        });
+    }
+    async start() {
+        if (this.started) {
+            throw new Error('GitManager is already running');
+        }
+        if (this.startPromise) {
+            throw new Error('GitManager is already starting');
+        }
+        this.stopRequested = false;
+        this.startPromise = this.startInternal();
+        try {
+            await this.startPromise;
+        }
+        finally {
+            this.startPromise = null;
+        }
+    }
+    async stop() {
+        this.stopRequested = true;
+        if (this.startPromise) {
+            await this.startPromise.catch(() => undefined);
+        }
+        if (!this.bridge.running) {
+            this.started = false;
+            return;
+        }
+        try {
+            await this.bridge.stopGitManager();
+        }
+        finally {
+            this.bridge.kill();
+            this.started = false;
+        }
+    }
+    async getStatus() {
+        if (!this.bridge.running) {
+            return {
+                running: false,
+                dataDir: this.config.dataDir,
+                uptimeMs: 0,
+            };
+        }
+        return this.bridge.getStatus();
+    }
+    get running() {
+        return this.started && this.bridge.running;
+    }
+    async initBareRepository(requestArg) {
+        this.assertRunning();
+        return this.bridge.initBareRepository(requestArg);
+    }
+    async importMirror(requestArg) {
+        this.assertRunning();
+        return this.bridge.importMirror(requestArg);
+    }
+    async listRepositories() {
+        this.assertRunning();
+        return this.bridge.listRepositories();
+    }
+    async listRefs(requestArg) {
+        this.assertRunning();
+        return this.bridge.listRefs(requestArg);
+    }
+    async listTree(requestArg) {
+        this.assertRunning();
+        return this.bridge.listTree(requestArg);
+    }
+    async readFile(requestArg) {
+        this.assertRunning();
+        return this.bridge.readFile(requestArg);
+    }
+    async listCommits(requestArg) {
+        this.assertRunning();
+        return this.bridge.listCommits(requestArg);
+    }
+    async startInternal() {
+        const spawned = await this.bridge.spawn();
+        if (!spawned) {
+            throw new Error('Failed to spawn rustgitmanager binary');
+        }
+        if (this.stopRequested) {
+            this.bridge.kill();
+            throw new Error('GitManager start was cancelled');
+        }
+        try {
+            await this.bridge.startGitManager(this.config);
+            if (this.stopRequested) {
+                try {
+                    await this.bridge.stopGitManager();
+                }
+                finally {
+                    this.bridge.kill();
+                    this.started = false;
+                }
+                throw new Error('GitManager start was cancelled');
+            }
+            this.started = true;
+        }
+        catch (error) {
+            this.bridge.kill();
+            this.started = false;
+            throw error;
+        }
+    }
+    assertRunning() {
+        if (!this.running) {
+            throw new Error('GitManager is not running');
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5naXRtYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5naXRtYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBaUJ4QyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVuRSxNQUFNLE9BQU8sVUFBVyxTQUFRLE9BQU8sQ0FBQyxZQUFZO0lBT2xELFlBQVksYUFBaUMsRUFBRTtRQUM3QyxLQUFLLEVBQUUsQ0FBQztRQVBGLFdBQU0sR0FBRyxJQUFJLG9CQUFvQixFQUFFLENBQUM7UUFDcEMsWUFBTyxHQUFHLEtBQUssQ0FBQztRQUNoQixpQkFBWSxHQUF5QixJQUFJLENBQUM7UUFDMUMsa0JBQWEsR0FBRyxLQUFLLENBQUM7UUFLNUIsSUFBSSxDQUFDLE1BQU0sR0FBRztZQUNaLE9BQU8sRUFBRSxVQUFVLENBQUMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsRUFBRSxRQUFRLEVBQUUsWUFBWSxDQUFDO1NBQzNGLENBQUM7UUFDRixJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxJQUFtQixFQUFFLE1BQXFCLEVBQUUsRUFBRTtZQUNwRSxJQUFJLENBQUMsT0FBTyxHQUFHLEtBQUssQ0FBQztZQUNyQixJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDbEMsQ0FBQyxDQUFDLENBQUM7UUFDSCxJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxJQUFZLEVBQUUsRUFBRTtZQUN4QyxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUM1QixDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFF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

package/dist_ts/index.d.ts

@@ -0,0 +1,3 @@
+export * from './models.js';
+export * from './rust-gitmanager-bridge.js';
+export * from './classes.gitmanager.js';

package/dist_ts/index.js

@@ -0,0 +1,4 @@
+export * from './models.js';
+export * from './rust-gitmanager-bridge.js';
+export * from './classes.gitmanager.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMseUJBQXlCLENBQUMifQ==

package/dist_ts/models.d.ts

@@ -0,0 +1,12 @@
+export interface IGitManagerOptions {
+    dataDir?: string;
+}
+export interface IRustGitManagerConfig {
+    dataDir: string;
+}
+export interface IGitManagerStatus {
+    running: boolean;
+    dataDir: string;
+    uptimeMs: number;
+}
+export type { IGitManagerCommitSummary, IGitManagerFileContent, IGitManagerImportMirrorRequest, IGitManagerInitBareRepositoryRequest, IGitManagerListCommitsRequest, IGitManagerReadFileRequest, IGitManagerRef, IGitManagerRefRequest, IGitManagerRepositoryInfo, IGitManagerRepositorySelector, IGitManagerTreeEntry, IGitManagerTreeRequest, TGitManagerObjectType, TGitManagerRefType, TGitManagerTreeEntryType, } from '@foss.global/interfaces';

package/dist_ts/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9kZWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvbW9kZWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts/plugins.d.ts

@@ -0,0 +1,6 @@
+import { EventEmitter } from 'node:events';
+import * as path from 'node:path';
+import * as url from 'node:url';
+export { EventEmitter, path, url };
+import * as smartrust from '@push.rocks/smartrust';
+export { smartrust };

package/dist_ts/plugins.js

@@ -0,0 +1,9 @@
+// node native scope
+import { EventEmitter } from 'node:events';
+import * as path from 'node:path';
+import * as url from 'node:url';
+export { EventEmitter, path, url };
+// @push.rocks scope
+import * as smartrust from '@push.rocks/smartrust';
+export { smartrust };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDM0MsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFDbEMsT0FBTyxLQUFLLEdBQUcsTUFBTSxVQUFVLENBQUM7QUFFaEMsT0FBTyxFQUFFLFlBQVksRUFBRSxJQUFJLEVBQUUsR0FBRyxFQUFFLENBQUM7QUFFbkMsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxTQUFTLE1BQU0sdUJBQXVCLENBQUM7QUFFbkQsT0FBTyxFQUFFLFNBQVMsRUFBRSxDQUFDIn0=

package/dist_ts/rust-gitmanager-bridge.d.ts

@@ -0,0 +1,19 @@
+import * as plugins from './plugins.js';
+import type { IGitManagerCommitSummary, IGitManagerFileContent, IGitManagerImportMirrorRequest, IGitManagerInitBareRepositoryRequest, IGitManagerListCommitsRequest, IGitManagerReadFileRequest, IGitManagerRef, IGitManagerRefRequest, IGitManagerRepositoryInfo, IGitManagerStatus, IGitManagerTreeEntry, IGitManagerTreeRequest, IRustGitManagerConfig } from './models.js';
+export declare class RustGitManagerBridge extends plugins.EventEmitter {
+    private bridge;
+    constructor();
+    spawn(): Promise<boolean>;
+    kill(): void;
+    get running(): boolean;
+    startGitManager(configArg: IRustGitManagerConfig): Promise<void>;
+    stopGitManager(): Promise<void>;
+    getStatus(): Promise<IGitManagerStatus>;
+    initBareRepository(requestArg: IGitManagerInitBareRepositoryRequest): Promise<IGitManagerRepositoryInfo>;
+    importMirror(requestArg: IGitManagerImportMirrorRequest): Promise<IGitManagerRepositoryInfo>;
+    listRepositories(): Promise<IGitManagerRepositoryInfo[]>;
+    listRefs(requestArg: IGitManagerRefRequest): Promise<IGitManagerRef[]>;
+    listTree(requestArg: IGitManagerTreeRequest): Promise<IGitManagerTreeEntry[]>;
+    readFile(requestArg: IGitManagerReadFileRequest): Promise<IGitManagerFileContent>;
+    listCommits(requestArg: IGitManagerListCommitsRequest): Promise<IGitManagerCommitSummary[]>;
+}

package/dist_ts/rust-gitmanager-bridge.js

@@ -0,0 +1,83 @@
+import * as plugins from './plugins.js';
+function getPackageRoot() {
+    const thisDir = plugins.path.dirname(plugins.url.fileURLToPath(import.meta.url));
+    return plugins.path.resolve(thisDir, '..');
+}
+function getTsrustPlatformSuffix() {
+    const archMap = { x64: 'amd64', arm64: 'arm64' };
+    const osMap = { linux: 'linux', darwin: 'macos' };
+    const os = osMap[process.platform];
+    const arch = archMap[process.arch];
+    return os && arch ? `${os}_${arch}` : null;
+}
+function buildLocalPaths() {
+    const packageRoot = getPackageRoot();
+    const suffix = getTsrustPlatformSuffix();
+    const paths = [];
+    if (suffix) {
+        paths.push(plugins.path.join(packageRoot, 'dist_rust', `rustgitmanager_${suffix}`));
+    }
+    paths.push(plugins.path.join(packageRoot, 'dist_rust', 'rustgitmanager'));
+    paths.push(plugins.path.resolve(process.cwd(), 'rust', 'target', 'release', 'rustgitmanager'));
+    paths.push(plugins.path.resolve(process.cwd(), 'rust', 'target', 'debug', 'rustgitmanager'));
+    return paths;
+}
+export class RustGitManagerBridge extends plugins.EventEmitter {
+    constructor() {
+        super();
+        this.bridge = new plugins.smartrust.RustBridge({
+            binaryName: 'rustgitmanager',
+            envVarName: 'GITMANAGER_RUST_BINARY',
+            platformPackagePrefix: '@foss.global/gitmanager',
+            localPaths: buildLocalPaths(),
+            requestTimeoutMs: 130000,
+            readyTimeoutMs: 10000,
+        });
+        this.bridge.on('exit', (code, signal) => {
+            this.emit('exit', code, signal);
+        });
+        this.bridge.on('stderr', (line) => {
+            this.emit('stderr', line);
+        });
+    }
+    async spawn() {
+        return this.bridge.spawn();
+    }
+    kill() {
+        this.bridge.kill();
+    }
+    get running() {
+        return this.bridge.running;
+    }
+    async startGitManager(configArg) {
+        await this.bridge.sendCommand('start', { config: configArg });
+    }
+    async stopGitManager() {
+        await this.bridge.sendCommand('stop', {});
+    }
+    async getStatus() {
+        return this.bridge.sendCommand('getStatus', {});
+    }
+    async initBareRepository(requestArg) {
+        return this.bridge.sendCommand('initBareRepository', requestArg);
+    }
+    async importMirror(requestArg) {
+        return this.bridge.sendCommand('importMirror', requestArg);
+    }
+    async listRepositories() {
+        return this.bridge.sendCommand('listRepositories', {});
+    }
+    async listRefs(requestArg) {
+        return this.bridge.sendCommand('listRefs', requestArg);
+    }
+    async listTree(requestArg) {
+        return this.bridge.sendCommand('listTree', requestArg);
+    }
+    async readFile(requestArg) {
+        return this.bridge.sendCommand('readFile', requestArg);
+    }
+    async listCommits(requestArg) {
+        return this.bridge.sendCommand('listCommits', requestArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVzdC1naXRtYW5hZ2VyLWJyaWRnZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3J1c3QtZ2l0bWFuYWdlci1icmlkZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUE4QnhDLFNBQVMsY0FBYztJQUNyQixNQUFNLE9BQU8sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUM7SUFDakYsT0FBTyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLEVBQUUsSUFBSSxDQUFDLENBQUM7QUFDN0MsQ0FBQztBQUVELFNBQVMsdUJBQXVCO0lBQzlCLE1BQU0sT0FBTyxHQUEyQixFQUFFLEdBQUcsRUFBRSxPQUFPLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxDQUFDO0lBQ3pFLE1BQU0sS0FBSyxHQUEyQixFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFDO0lBQzFFLE1BQU0sRUFBRSxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDbkMsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNuQyxPQUFPLEVBQUUsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLEdBQUcsRUFBRSxJQUFJLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7QUFDN0MsQ0FBQztBQUVELFNBQVMsZUFBZTtJQUN0QixNQUFNLFdBQVcsR0FBRyxjQUFjLEVBQUUsQ0FBQztJQUNyQyxNQUFNLE1BQU0sR0FBRyx1QkFBdUIsRUFBRSxDQUFDO0lBQ3pDLE1BQU0sS0FBSyxHQUFhLEVBQUUsQ0FBQztJQUUzQixJQUFJLE1BQU0sRUFBRSxD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

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Task Venture Capital GmbH
+
+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/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@foss.global/gitmanager",
+  "version": "0.2.0",
+  "private": false,
+  "description": "Headless Git manager for the foss.global Git platform, with a TypeScript API and Rust engine.",
+  "exports": {
+    ".": "./dist_ts/index.js"
+  },
+  "type": "module",
+  "author": "Task Venture Capital GmbH",
+  "license": "MIT",
+  "dependencies": {
+    "@foss.global/interfaces": "^0.2.0",
+    "@push.rocks/smartrust": "^1.4.0"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsdoc": "^2.1.1",
+    "@git.zone/tsrun": "^2.0.4",
+    "@git.zone/tsrust": "^1.5.0",
+    "@git.zone/tstest": "^3.6.6",
+    "@types/node": "^26.0.0"
+  },
+  "files": [
+    "ts/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_rust/**/*",
+    ".smartconfig.json",
+    "readme.md",
+    "changelog.md",
+    "license.md",
+    "thirdparty.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@code.foss.global:29419/foss.global/gitmanager.git"
+  },
+  "bugs": {
+    "url": "https://code.foss.global/foss.global/gitmanager/issues"
+  },
+  "homepage": "https://code.foss.global/foss.global/gitmanager#readme",
+  "keywords": [
+    "foss.global",
+    "git",
+    "gitmanager",
+    "forge",
+    "rust",
+    "typescript",
+    "smartrust",
+    "tsrust"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "scripts": {
+    "pretest": "(tsrust)",
+    "test": "tstest test/ --verbose --logfile --timeout 60",
+    "test:rust": "(cd rust && cargo test)",
+    "build": "(tsbuild tsfolders) && (tsrust)",
+    "buildDocs": "tsdoc"
+  }
+}

package/readme.md

@@ -0,0 +1,115 @@
+# @foss.global/gitmanager
+
+Headless Git manager for the foss.global Git platform.
+
+This package follows the push.rocks Rust-backed package pattern: TypeScript owns the public package API and lifecycle, while Rust owns the Git/storage/protocol engine. TypeScript controls the Rust binary through `@push.rocks/smartrust`, and builds use `@git.zone/tsrust`.
+
+The current implementation provides lifecycle IPC plus initial local bare repository management and read APIs. Git protocol serving, mirror refresh, authorization, and write/admin features are planned in `../readme.plan.md`.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## Install
+
+```bash
+pnpm add @foss.global/gitmanager
+```
+
+## Usage
+
+```ts
+import { GitManager } from '@foss.global/gitmanager';
+
+const gitManager = new GitManager({
+  dataDir: '/var/lib/foss-global/gitmanager',
+});
+
+await gitManager.start();
+const status = await gitManager.getStatus();
+console.log(status.running, status.dataDir);
+
+await gitManager.importMirror({
+  org: 'foss.global',
+  repo: 'interfaces',
+  remoteUrl: 'ssh://git@code.foss.global:29419/foss.global/interfaces.git',
+});
+
+const refs = await gitManager.listRefs({ org: 'foss.global', repo: 'interfaces' });
+const tree = await gitManager.listTree({ org: 'foss.global', repo: 'interfaces', ref: 'main' });
+const readme = await gitManager.readFile({
+  org: 'foss.global',
+  repo: 'interfaces',
+  ref: 'main',
+  path: 'readme.md',
+});
+
+await gitManager.stop();
+```
+
+## Public API
+
+- `GitManager`: TypeScript facade for the Rust engine lifecycle.
+- `GitManager.start()`: spawns the Rust binary through `smartrust` and starts the engine.
+- `GitManager.stop()`: asks the engine to stop and always kills the bridge process in cleanup.
+- `GitManager.getStatus()`: returns `{ running, dataDir, uptimeMs }`.
+- `GitManager.initBareRepository()`: creates an empty local bare repository.
+- `GitManager.importMirror()`: imports a remote repository with `git clone --mirror`. Supported remote forms are `https://`, `http://`, `ssh://`, `git://`, `file://`, and SCP-like `git@host:org/repo.git` URLs.
+- `GitManager.listRepositories()`: lists local repositories managed below the configured data directory.
+- `GitManager.listRefs()`: lists branch and tag refs.
+- `GitManager.listTree()`: lists tree entries at a ref and optional path.
+- `GitManager.readFile()`: reads a blob as base64 after checking the blob size limit.
+- `GitManager.listCommits()`: lists commit summaries for a ref.
+- `GitManager.running`: local facade running state.
+- `RustGitManagerBridge`: lower-level typed bridge around `@push.rocks/smartrust`.
+- `IGitManagerOptions`, `IGitManagerStatus`, `IRustGitManagerConfig`: exported option/status contracts.
+
+Repository/read DTO contracts are re-exported from the published `@foss.global/interfaces` package.
+
+Read/list APIs go through JSON IPC. Git packfile streaming for clone/fetch/push must not go through JSON IPC; future Git HTTP/SSH transport work belongs in the Rust engine or controlled Git subprocesses.
+
+The initial read APIs use the system `git` CLI with explicit arguments, non-interactive environment variables, command timeouts, ref-to-object-id resolution, path validation, bounded stdout/stderr capture, ref/tree result caps, and a 1 MiB file read cap.
+
+## Rust Build
+
+The package builds a Rust binary named `rustgitmanager` from `rust/` using `@git.zone/tsrust`.
+
+Configured targets:
+
+- `linux_amd64`
+- `linux_arm64`
+
+The ARM64 target uses `rust/.cargo/config.toml` with `aarch64-linux-gnu-gcc` as linker.
+
+## Testing
+
+```bash
+pnpm test
+pnpm run test:rust
+pnpm run build
+```
+
+`pnpm test` runs the `pretest` hook first, which builds the Rust binaries with `tsrust`, and then runs lifecycle plus local mirror import/read API tests through `smartrust`.
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.
+
+Bundled Rust binaries include third-party Rust crates under their respective licenses. See `thirdparty.md` for the packaged notice list.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH<br>
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/thirdparty.md

@@ -0,0 +1,70 @@
+# Third-Party Notices
+
+This package bundles Rust binaries in `dist_rust/`. Those binaries are built from the Rust crates listed below. Each dependency remains licensed by its respective authors under the stated license expression.
+
+| Crate | Version | License |
+| --- | --- | --- |
+| aho-corasick | 1.1.4 | MIT OR Unlicense |
+| anstream | 1.0.0 | Apache-2.0 OR MIT |
+| anstyle | 1.0.14 | Apache-2.0 OR MIT |
+| anstyle-parse | 1.0.0 | Apache-2.0 OR MIT |
+| anstyle-query | 1.1.5 | Apache-2.0 OR MIT |
+| anstyle-wincon | 3.0.11 | Apache-2.0 OR MIT |
+| anyhow | 1.0.102 | Apache-2.0 OR MIT |
+| base64 | 0.22.1 | Apache-2.0 OR MIT |
+| bitflags | 2.13.0 | Apache-2.0 OR MIT |
+| bytes | 1.12.0 | MIT |
+| cfg-if | 1.0.4 | Apache-2.0 OR MIT |
+| clap | 4.6.1 | Apache-2.0 OR MIT |
+| clap_builder | 4.6.0 | Apache-2.0 OR MIT |
+| clap_derive | 4.6.1 | Apache-2.0 OR MIT |
+| clap_lex | 1.1.0 | Apache-2.0 OR MIT |
+| colorchoice | 1.0.5 | Apache-2.0 OR MIT |
+| errno | 0.3.14 | Apache-2.0 OR MIT |
+| heck | 0.5.0 | Apache-2.0 OR MIT |
+| is_terminal_polyfill | 1.70.2 | Apache-2.0 OR MIT |
+| itoa | 1.0.18 | Apache-2.0 OR MIT |
+| lazy_static | 1.5.0 | Apache-2.0 OR MIT |
+| libc | 0.2.186 | Apache-2.0 OR MIT |
+| lock_api | 0.4.14 | Apache-2.0 OR MIT |
+| log | 0.4.33 | Apache-2.0 OR MIT |
+| matchers | 0.2.0 | MIT |
+| memchr | 2.8.2 | MIT OR Unlicense |
+| mio | 1.2.1 | MIT |
+| nu-ansi-term | 0.50.3 | MIT |
+| once_cell | 1.21.4 | Apache-2.0 OR MIT |
+| once_cell_polyfill | 1.70.2 | Apache-2.0 OR MIT |
+| parking_lot | 0.12.5 | Apache-2.0 OR MIT |
+| parking_lot_core | 0.9.12 | Apache-2.0 OR MIT |
+| pin-project-lite | 0.2.17 | Apache-2.0 OR MIT |
+| proc-macro2 | 1.0.106 | Apache-2.0 OR MIT |
+| quote | 1.0.45 | Apache-2.0 OR MIT |
+| redox_syscall | 0.5.18 | MIT |
+| regex-automata | 0.4.14 | Apache-2.0 OR MIT |
+| regex-syntax | 0.8.11 | Apache-2.0 OR MIT |
+| scopeguard | 1.2.0 | Apache-2.0 OR MIT |
+| serde | 1.0.228 | Apache-2.0 OR MIT |
+| serde_core | 1.0.228 | Apache-2.0 OR MIT |
+| serde_derive | 1.0.228 | Apache-2.0 OR MIT |
+| serde_json | 1.0.150 | Apache-2.0 OR MIT |
+| sharded-slab | 0.1.7 | MIT |
+| signal-hook-registry | 1.4.8 | Apache-2.0 OR MIT |
+| smallvec | 1.15.2 | Apache-2.0 OR MIT |
+| socket2 | 0.6.4 | Apache-2.0 OR MIT |
+| strsim | 0.11.1 | MIT |
+| syn | 2.0.118 | Apache-2.0 OR MIT |
+| thread_local | 1.1.9 | Apache-2.0 OR MIT |
+| tokio | 1.52.3 | MIT |
+| tokio-macros | 2.7.0 | MIT |
+| tracing | 0.1.44 | MIT |
+| tracing-attributes | 0.1.31 | MIT |
+| tracing-core | 0.1.36 | MIT |
+| tracing-log | 0.2.0 | MIT |
+| tracing-subscriber | 0.3.23 | MIT |
+| unicode-ident | 1.0.24 | (Apache-2.0 OR MIT) AND Unicode-3.0 |
+| utf8parse | 0.2.2 | Apache-2.0 OR MIT |
+| valuable | 0.1.1 | MIT |
+| wasi | 0.11.1+wasi-snapshot-preview1 | Apache-2.0 OR Apache-2.0 WITH LLVM-exception OR MIT |
+| windows-link | 0.2.1 | Apache-2.0 OR MIT |
+| windows-sys | 0.61.2 | Apache-2.0 OR MIT |
+| zmij | 1.0.21 | MIT |

package/ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@foss.global/gitmanager',
+  version: '0.2.0',
+  description: 'Headless Git manager for the foss.global Git platform, with a TypeScript API and Rust engine.'
+}

package/ts/classes.gitmanager.ts

@@ -0,0 +1,159 @@
+import * as plugins from './plugins.js';
+import type {
+  IGitManagerCommitSummary,
+  IGitManagerFileContent,
+  IGitManagerImportMirrorRequest,
+  IGitManagerInitBareRepositoryRequest,
+  IGitManagerListCommitsRequest,
+  IGitManagerReadFileRequest,
+  IGitManagerRef,
+  IGitManagerRefRequest,
+  IGitManagerRepositoryInfo,
+  IGitManagerStatus,
+  IGitManagerTreeEntry,
+  IGitManagerTreeRequest,
+  IGitManagerOptions,
+  IRustGitManagerConfig,
+} from './models.js';
+import { RustGitManagerBridge } from './rust-gitmanager-bridge.js';
+
+export class GitManager extends plugins.EventEmitter {
+  private bridge = new RustGitManagerBridge();
+  private started = false;
+  private startPromise: Promise<void> | null = null;
+  private stopRequested = false;
+  private config: IRustGitManagerConfig;
+
+  constructor(optionsArg: IGitManagerOptions = {}) {
+    super();
+    this.config = {
+      dataDir: optionsArg.dataDir ?? plugins.path.resolve(process.cwd(), '.nogit', 'gitmanager'),
+    };
+    this.bridge.on('exit', (code: number | null, signal: string | null) => {
+      this.started = false;
+      this.emit('exit', code, signal);
+    });
+    this.bridge.on('stderr', (line: string) => {
+      this.emit('stderr', line);
+    });
+  }
+
+  public async start(): Promise<void> {
+    if (this.started) {
+      throw new Error('GitManager is already running');
+    }
+    if (this.startPromise) {
+      throw new Error('GitManager is already starting');
+    }
+
+    this.stopRequested = false;
+    this.startPromise = this.startInternal();
+    try {
+      await this.startPromise;
+    } finally {
+      this.startPromise = null;
+    }
+  }
+
+  public async stop(): Promise<void> {
+    this.stopRequested = true;
+    if (this.startPromise) {
+      await this.startPromise.catch(() => undefined);
+    }
+    if (!this.bridge.running) {
+      this.started = false;
+      return;
+    }
+    try {
+      await this.bridge.stopGitManager();
+    } finally {
+      this.bridge.kill();
+      this.started = false;
+    }
+  }
+
+  public async getStatus(): Promise<IGitManagerStatus> {
+    if (!this.bridge.running) {
+      return {
+        running: false,
+        dataDir: this.config.dataDir,
+        uptimeMs: 0,
+      };
+    }
+    return this.bridge.getStatus();
+  }
+
+  public get running(): boolean {
+    return this.started && this.bridge.running;
+  }
+
+  public async initBareRepository(requestArg: IGitManagerInitBareRepositoryRequest): Promise<IGitManagerRepositoryInfo> {
+    this.assertRunning();
+    return this.bridge.initBareRepository(requestArg);
+  }
+
+  public async importMirror(requestArg: IGitManagerImportMirrorRequest): Promise<IGitManagerRepositoryInfo> {
+    this.assertRunning();
+    return this.bridge.importMirror(requestArg);
+  }
+
+  public async listRepositories(): Promise<IGitManagerRepositoryInfo[]> {
+    this.assertRunning();
+    return this.bridge.listRepositories();
+  }
+
+  public async listRefs(requestArg: IGitManagerRefRequest): Promise<IGitManagerRef[]> {
+    this.assertRunning();
+    return this.bridge.listRefs(requestArg);
+  }
+
+  public async listTree(requestArg: IGitManagerTreeRequest): Promise<IGitManagerTreeEntry[]> {
+    this.assertRunning();
+    return this.bridge.listTree(requestArg);
+  }
+
+  public async readFile(requestArg: IGitManagerReadFileRequest): Promise<IGitManagerFileContent> {
+    this.assertRunning();
+    return this.bridge.readFile(requestArg);
+  }
+
+  public async listCommits(requestArg: IGitManagerListCommitsRequest): Promise<IGitManagerCommitSummary[]> {
+    this.assertRunning();
+    return this.bridge.listCommits(requestArg);
+  }
+
+  private async startInternal(): Promise<void> {
+    const spawned = await this.bridge.spawn();
+    if (!spawned) {
+      throw new Error('Failed to spawn rustgitmanager binary');
+    }
+    if (this.stopRequested) {
+      this.bridge.kill();
+      throw new Error('GitManager start was cancelled');
+    }
+
+    try {
+      await this.bridge.startGitManager(this.config);
+      if (this.stopRequested) {
+        try {
+          await this.bridge.stopGitManager();
+        } finally {
+          this.bridge.kill();
+          this.started = false;
+        }
+        throw new Error('GitManager start was cancelled');
+      }
+      this.started = true;
+    } catch (error) {
+      this.bridge.kill();
+      this.started = false;
+      throw error;
+    }
+  }
+
+  private assertRunning(): void {
+    if (!this.running) {
+      throw new Error('GitManager is not running');
+    }
+  }
+}

package/ts/index.ts

@@ -0,0 +1,3 @@
+export * from './models.js';
+export * from './rust-gitmanager-bridge.js';
+export * from './classes.gitmanager.js';

package/ts/models.ts

@@ -0,0 +1,31 @@
+export interface IGitManagerOptions {
+  dataDir?: string;
+}
+
+export interface IRustGitManagerConfig {
+  dataDir: string;
+}
+
+export interface IGitManagerStatus {
+  running: boolean;
+  dataDir: string;
+  uptimeMs: number;
+}
+
+export type {
+  IGitManagerCommitSummary,
+  IGitManagerFileContent,
+  IGitManagerImportMirrorRequest,
+  IGitManagerInitBareRepositoryRequest,
+  IGitManagerListCommitsRequest,
+  IGitManagerReadFileRequest,
+  IGitManagerRef,
+  IGitManagerRefRequest,
+  IGitManagerRepositoryInfo,
+  IGitManagerRepositorySelector,
+  IGitManagerTreeEntry,
+  IGitManagerTreeRequest,
+  TGitManagerObjectType,
+  TGitManagerRefType,
+  TGitManagerTreeEntryType,
+} from '@foss.global/interfaces';

package/ts/plugins.ts

@@ -0,0 +1,11 @@
+// node native scope
+import { EventEmitter } from 'node:events';
+import * as path from 'node:path';
+import * as url from 'node:url';
+
+export { EventEmitter, path, url };
+
+// @push.rocks scope
+import * as smartrust from '@push.rocks/smartrust';
+
+export { smartrust };

package/ts/rust-gitmanager-bridge.ts

@@ -0,0 +1,132 @@
+import * as plugins from './plugins.js';
+import type {
+  IGitManagerCommitSummary,
+  IGitManagerFileContent,
+  IGitManagerImportMirrorRequest,
+  IGitManagerInitBareRepositoryRequest,
+  IGitManagerListCommitsRequest,
+  IGitManagerReadFileRequest,
+  IGitManagerRef,
+  IGitManagerRefRequest,
+  IGitManagerRepositoryInfo,
+  IGitManagerStatus,
+  IGitManagerTreeEntry,
+  IGitManagerTreeRequest,
+  IRustGitManagerConfig,
+} from './models.js';
+
+type TGitManagerCommands = {
+  start: { params: { config: IRustGitManagerConfig }; result: Record<string, never> };
+  stop: { params: Record<string, never>; result: Record<string, never> };
+  getStatus: { params: Record<string, never>; result: IGitManagerStatus };
+  initBareRepository: { params: IGitManagerInitBareRepositoryRequest; result: IGitManagerRepositoryInfo };
+  importMirror: { params: IGitManagerImportMirrorRequest; result: IGitManagerRepositoryInfo };
+  listRepositories: { params: Record<string, never>; result: IGitManagerRepositoryInfo[] };
+  listRefs: { params: IGitManagerRefRequest; result: IGitManagerRef[] };
+  listTree: { params: IGitManagerTreeRequest; result: IGitManagerTreeEntry[] };
+  readFile: { params: IGitManagerReadFileRequest; result: IGitManagerFileContent };
+  listCommits: { params: IGitManagerListCommitsRequest; result: IGitManagerCommitSummary[] };
+};
+
+function getPackageRoot(): string {
+  const thisDir = plugins.path.dirname(plugins.url.fileURLToPath(import.meta.url));
+  return plugins.path.resolve(thisDir, '..');
+}
+
+function getTsrustPlatformSuffix(): string | null {
+  const archMap: Record<string, string> = { x64: 'amd64', arm64: 'arm64' };
+  const osMap: Record<string, string> = { linux: 'linux', darwin: 'macos' };
+  const os = osMap[process.platform];
+  const arch = archMap[process.arch];
+  return os && arch ? `${os}_${arch}` : null;
+}
+
+function buildLocalPaths(): string[] {
+  const packageRoot = getPackageRoot();
+  const suffix = getTsrustPlatformSuffix();
+  const paths: string[] = [];
+
+  if (suffix) {
+    paths.push(plugins.path.join(packageRoot, 'dist_rust', `rustgitmanager_${suffix}`));
+  }
+  paths.push(plugins.path.join(packageRoot, 'dist_rust', 'rustgitmanager'));
+  paths.push(plugins.path.resolve(process.cwd(), 'rust', 'target', 'release', 'rustgitmanager'));
+  paths.push(plugins.path.resolve(process.cwd(), 'rust', 'target', 'debug', 'rustgitmanager'));
+
+  return paths;
+}
+
+export class RustGitManagerBridge extends plugins.EventEmitter {
+  private bridge: plugins.smartrust.RustBridge<TGitManagerCommands>;
+
+  constructor() {
+    super();
+    this.bridge = new plugins.smartrust.RustBridge<TGitManagerCommands>({
+      binaryName: 'rustgitmanager',
+      envVarName: 'GITMANAGER_RUST_BINARY',
+      platformPackagePrefix: '@foss.global/gitmanager',
+      localPaths: buildLocalPaths(),
+      requestTimeoutMs: 130000,
+      readyTimeoutMs: 10000,
+    });
+
+    this.bridge.on('exit', (code: number | null, signal: string | null) => {
+      this.emit('exit', code, signal);
+    });
+    this.bridge.on('stderr', (line: string) => {
+      this.emit('stderr', line);
+    });
+  }
+
+  public async spawn(): Promise<boolean> {
+    return this.bridge.spawn();
+  }
+
+  public kill(): void {
+    this.bridge.kill();
+  }
+
+  public get running(): boolean {
+    return this.bridge.running;
+  }
+
+  public async startGitManager(configArg: IRustGitManagerConfig): Promise<void> {
+    await this.bridge.sendCommand('start', { config: configArg });
+  }
+
+  public async stopGitManager(): Promise<void> {
+    await this.bridge.sendCommand('stop', {});
+  }
+
+  public async getStatus(): Promise<IGitManagerStatus> {
+    return this.bridge.sendCommand('getStatus', {});
+  }
+
+  public async initBareRepository(requestArg: IGitManagerInitBareRepositoryRequest): Promise<IGitManagerRepositoryInfo> {
+    return this.bridge.sendCommand('initBareRepository', requestArg);
+  }
+
+  public async importMirror(requestArg: IGitManagerImportMirrorRequest): Promise<IGitManagerRepositoryInfo> {
+    return this.bridge.sendCommand('importMirror', requestArg);
+  }
+
+  public async listRepositories(): Promise<IGitManagerRepositoryInfo[]> {
+    return this.bridge.sendCommand('listRepositories', {});
+  }
+
+  public async listRefs(requestArg: IGitManagerRefRequest): Promise<IGitManagerRef[]> {
+    return this.bridge.sendCommand('listRefs', requestArg);
+  }
+
+  public async listTree(requestArg: IGitManagerTreeRequest): Promise<IGitManagerTreeEntry[]> {
+    return this.bridge.sendCommand('listTree', requestArg);
+  }
+
+  public async readFile(requestArg: IGitManagerReadFileRequest): Promise<IGitManagerFileContent> {
+    return this.bridge.sendCommand('readFile', requestArg);
+  }
+
+  public async listCommits(requestArg: IGitManagerListCommitsRequest): Promise<IGitManagerCommitSummary[]> {
+    return this.bridge.sendCommand('listCommits', requestArg);
+  }
+}