@devframes/service-git 0.9.8 → 0.9.10

package/dist/index.d.mts

@@ -38,7 +38,7 @@ interface Commit {
   body: string;
   /** Ref names pointing at this commit (branches, tags, HEAD). */
   refs: string[];
-  /** Full parent hashes — drives the commit graph. */
+  /** Full parent hashes; drives the commit graph. */
   parents: string[];
 }
 interface GitLog {
@@ -80,7 +80,7 @@ interface Tag {
   /** Short SHA of the commit the tag ultimately points to. */
   sha: string;
   /**
-   * Tag creation date as epoch milliseconds — the tag's own date for
+   * Tag creation date as epoch milliseconds: the tag's own date for
    * annotated tags, the target commit's date for lightweight tags. `0` when
    * the date can't be parsed.
    */
@@ -129,7 +129,7 @@ interface GitDiff {
   files: DiffFile[];
   totalAdditions: number;
   totalDeletions: number;
-  /** Unified patch text — populated when `path` targets a single file. */
+  /** Unified patch text, populated when `path` targets a single file. */
   patch: string | null;
   /** `true` when `patch` was clipped to the internal char limit. */
   truncated: boolean;
@@ -248,11 +248,11 @@ declare module 'devframe' {
   }
 }
 /**
- * The git wire service — read/write git operations shared over RPC by every
+ * The git wire service: read/write git operations shared over RPC by every
  * plugin on the host, generalizing the utilities that used to live inside the
  * git plugin. The exec wrapper and output parsers stay internal; consumers get
  * the typed {@link GitServiceApi} in-process (`ctx.services.get`) and the same
- * ops over `devframes:service:git:*` RPC. Write ops are always exposed —
+ * ops over `devframes:service:git:*` RPC. Write ops are always exposed;
  * authorization is the host's connection-trust boundary. The service defines
  * no `dump`/`snapshot`; a devframe bakes what it needs via `snapshotRpc`.
  */

package/dist/index.mjs

@@ -4,13 +4,13 @@ import { execFile } from "node:child_process";
 import process from "node:process";
 import { promisify } from "node:util";
 //#region package.json
-var version = "0.9.8";
+var version = "0.9.10";
 //#endregion
 //#region src/git.ts
 const execFileAsync = promisify(execFile);
 const MAX_BUFFER = 67108864;
 /**
-* Run a git command in `cwd`. Rejects when git exits non-zero — callers that
+* Run a git command in `cwd`. Rejects when git exits non-zero; callers that
 * tolerate failure (e.g. "no upstream configured") should use {@link tryGit}.
 */
 async function runGit(cwd, args) {
@@ -18,6 +18,7 @@ async function runGit(cwd, args) {
 		cwd,
 		maxBuffer: MAX_BUFFER,
 		windowsHide: true,
+		/** Force plain, locale-independent output so parsers stay stable. */
 		env: {
 			...process.env,
 			GIT_PAGER: "cat",
@@ -95,6 +96,56 @@ function mapCode(code) {
 		default: return "unknown";
 	}
 }
+function applyBranchToken(status, token) {
+	const [, key, ...rest] = token.split(" ");
+	const value = rest.join(" ");
+	switch (key) {
+		case "branch.head":
+			status.detached = value === "(detached)";
+			status.branch = status.detached ? null : value;
+			return;
+		case "branch.oid":
+			if (value !== "(initial)") status.head = value.slice(0, 9);
+			return;
+		case "branch.upstream":
+			status.upstream = value;
+			return;
+		case "branch.ab": {
+			const match = value.match(/\+(\d+)\s+-(\d+)/);
+			if (match) {
+				status.ahead = Number(match[1]);
+				status.behind = Number(match[2]);
+			}
+		}
+	}
+}
+/**
+* Record a tracked change (`1 ` ordinary or `2 ` rename/copy) and return the
+* token index consumed - a rename eats the following NUL token for its origin.
+* Type 1 path begins at field 8; type 2 inserts the rename score at field 8,
+* pushing the path to field 9 and the original to that extra token.
+*/
+function applyTrackedEntry(status, tokens, index) {
+	const fields = tokens[index].split(" ");
+	const [x, y] = fields[1];
+	const renamed = tokens[index].startsWith("2 ");
+	const path = fields.slice(renamed ? 9 : 8).join(" ");
+	const consumed = renamed ? index + 1 : index;
+	const from = renamed ? tokens[consumed] : void 0;
+	if (x !== ".") status.staged.push(from ? {
+		path,
+		from,
+		status: mapCode(x)
+	} : {
+		path,
+		status: mapCode(x)
+	});
+	if (y !== ".") status.unstaged.push({
+		path,
+		status: mapCode(y)
+	});
+	return consumed;
+}
 /**
 * Parse `git status --porcelain=v2 --branch -z` into a structured snapshot.
 * Records are NUL-separated; rename/copy (type `2`) entries consume an extra
@@ -113,56 +164,13 @@ function parseStatus(root, raw) {
 	for (let i = 0; i < tokens.length; i++) {
 		const token = tokens[i];
 		if (!token) continue;
-		if (token.startsWith("# ")) {
-			const [, key, ...rest] = token.split(" ");
-			const value = rest.join(" ");
-			if (key === "branch.head") {
-				if (value === "(detached)") {
-					status.detached = true;
-					status.branch = null;
-				} else status.branch = value;
-			} else if (key === "branch.oid" && value !== "(initial)") status.head = value.slice(0, 9);
-			else if (key === "branch.upstream") status.upstream = value;
-			else if (key === "branch.ab") {
-				const match = value.match(/\+(\d+)\s+-(\d+)/);
-				if (match) {
-					status.ahead = Number(match[1]);
-					status.behind = Number(match[2]);
-				}
-			}
-			continue;
-		}
-		if (token.startsWith("1 ") || token.startsWith("2 ")) {
-			const renamed = token.startsWith("2 ");
-			const fields = token.split(" ");
-			const xy = fields[1];
-			const x = xy[0];
-			const y = xy[1];
-			const path = fields.slice(renamed ? 9 : 8).join(" ");
-			const from = renamed ? tokens[++i] : void 0;
-			if (x !== ".") status.staged.push(from ? {
-				path,
-				from,
-				status: mapCode(x)
-			} : {
-				path,
-				status: mapCode(x)
-			});
-			if (y !== ".") status.unstaged.push({
-				path,
-				status: mapCode(y)
-			});
-			continue;
-		}
-		if (token.startsWith("u ")) {
-			const path = token.split(" ").slice(10).join(" ");
-			status.unstaged.push({
-				path,
-				status: "unmerged"
-			});
-			continue;
-		}
-		if (token.startsWith("? ")) status.untracked.push(token.slice(2));
+		if (token.startsWith("# ")) applyBranchToken(status, token);
+		else if (token.startsWith("1 ") || token.startsWith("2 ")) i = applyTrackedEntry(status, tokens, i);
+		else if (token.startsWith("u ")) status.unstaged.push({
+			path: token.split(" ").slice(10).join(" "),
+			status: "unmerged"
+		});
+		else if (token.startsWith("? ")) status.untracked.push(token.slice(2));
 	}
 	status.clean = status.staged.length === 0 && status.unstaged.length === 0 && status.untracked.length === 0;
 	return status;
@@ -754,11 +762,11 @@ const gitDiffSchema = s.object({
 	truncated: s.boolean()
 });
 /**
-* The git wire service — read/write git operations shared over RPC by every
+* The git wire service: read/write git operations shared over RPC by every
 * plugin on the host, generalizing the utilities that used to live inside the
 * git plugin. The exec wrapper and output parsers stay internal; consumers get
 * the typed {@link GitServiceApi} in-process (`ctx.services.get`) and the same
-* ops over `devframes:service:git:*` RPC. Write ops are always exposed —
+* ops over `devframes:service:git:*` RPC. Write ops are always exposed;
 * authorization is the host's connection-trust boundary. The service defines
 * no `dump`/`snapshot`; a devframe bakes what it needs via `snapshotRpc`.
 */
@@ -768,6 +776,7 @@ function createGitService(options) {
 		version,
 		scope: GIT_SERVICE_SCOPE,
 		options,
+		/** `cwd` deep-merges as a scalar (later installer wins) across declarers. */
 		setup(ctx, { options }) {
 			const ops = createGitOps(options?.cwd ?? ctx.cwd);
 			ctx.rpc.register(defineRpcFunction({
@@ -823,7 +832,7 @@ function createGitService(options) {
 				returns: gitFileSchema,
 				agent: {
 					title: "Git read file",
-					description: "Read the contents of a single file at a commit-ish (default HEAD) — the raw text of a versioned file without checking it out. found is false when no such file exists at the ref; binary blobs return with content omitted. Safe to call freely."
+					description: "Read the contents of a single file at a commit-ish (default HEAD): the raw text of a versioned file without checking it out. found is false when no such file exists at the ref; binary blobs return with content omitted. Safe to call freely."
 				},
 				handler: (args) => ops.readFile(args)
 			}));
@@ -838,7 +847,7 @@ function createGitService(options) {
 				returns: gitDiffSchema,
 				agent: {
 					title: "Git diff",
-					description: "Unified diff of uncommitted changes — the working tree by default, the index with staged: true, one file with path. Safe to call freely."
+					description: "Unified diff of uncommitted changes: the working tree by default, the index with staged: true, one file with path. Safe to call freely."
 				},
 				handler: (args = {}) => ops.diff(args)
 			}));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/service-git",
   "type": "module",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "description": "Devframe wire service exposing read/write git operations (status, log, show, diff, branches, stage, unstage, commit) over RPC.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -28,11 +28,11 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.8"
+    "devframe": "0.9.10"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "devframe": "0.9.8",
+    "devframe": "0.9.10",
     "tsdown": "^0.22.14",
     "vitest": "^4.1.11"
   },