@devframes/plugin-git 0.9.1 → 0.9.3

package/README.md

@@ -9,9 +9,10 @@ repository dashboard with a **Next.js App Router + shadcn/ui** SPA over
 type-safe RPC. The host process shells out to `git` and exposes the repository;
 the same bundle runs as a live dev server or a fully static deployment.
 
-Status, a SourceTree-style **commit graph**, branches, and diffs are read-only;
-staging, unstaging, and committing are available when write mode is enabled. The
-UI follows the system **light/dark** preference with a manual toggle.
+Status, a SourceTree-style **commit graph**, branches, and diffs, plus staging,
+unstaging, and committing — all through the shared
+[`@devframes/service-git`](../../services/git) wire service. The UI follows the
+system **light/dark** preference with a manual toggle.
 
 ## Install
 
@@ -25,7 +26,6 @@ Run the dashboard against the current repository:
 
 ```sh
 pnpx @devframes/plugin-git         # dev server (live RPC over WebSocket)
-pnpx @devframes/plugin-git --write # also enable staging / committing from the UI
 pnpx @devframes/plugin-git build   # static deploy → dist-static/
 pnpx @devframes/plugin-git --port 4000
 ```
@@ -48,30 +48,32 @@ await createCac(createGitDevframe({ repoRoot: process.cwd() })).parse()
 | `basePath` | adapter-resolved | Mount path (`/` standalone, `/__git/` hosted). |
 | `distDir` | bundled SPA | Override the served SPA directory. |
 | `port` | `9710` | Preferred dev-server port. |
-| `write` | `false` | Enable staging, unstaging, and committing from the UI. |
 
 ## RPC surface
 
-The read functions are each a `query` with `snapshot: true`: resolved live over
-WebSocket in dev, and served from a snapshot baked at build time for static
-deploys. Each degrades to an empty, `isRepo: false` result outside a git
-repository.
-
-- `devframes:plugin:git:status` — branch, upstream tracking (ahead/behind), staged / unstaged /
-  untracked files, parsed from `git status --porcelain=v2`. Reports `canWrite`.
-- `devframes:plugin:git:log` — paginated commit history (`limit` / `skip`) including parent
+All git work runs through the [`@devframes/service-git`](../../services/git)
+wire service, which this devframe declares (`services`) and its SPA calls
+directly over `devframes:service:git:*`. The read functions are `query`
+functions that degrade to an empty, `isRepo: false` result outside a git
+repository; the definition opts them into the static build via `rpc.snapshot`
+(resolved live over WebSocket in dev, served from a build-time snapshot for
+static deploys).
+
+- `devframes:service:git:status` — branch, upstream tracking (ahead/behind), staged / unstaged /
+  untracked files, parsed from `git status --porcelain=v2`.
+- `devframes:service:git:log` — paginated commit history (`limit` / `skip`) including parent
   hashes, which drive the commit graph.
-- `devframes:plugin:git:branches` — local branches with SHA, upstream, ahead/behind, tip subject.
-- `devframes:plugin:git:diff` — per-file added/deleted counts for the working tree or index, plus
+- `devframes:service:git:branches` — local branches with SHA, upstream, ahead/behind, tip subject.
+- `devframes:service:git:diff` — per-file added/deleted counts for the working tree or index, plus
   a unified patch for a selected file.
 
-Write actions are `action` functions, registered only when write mode is enabled
-(`createGitDevframe({ write: true })` or the `--write` flag) and gated behind
-`status.canWrite` in the UI. Each returns fresh status (commit returns a result):
+Write actions are `action` functions — always exposed by the service, with
+write authorization governed by the host's connection-trust boundary. Each
+returns fresh status (commit returns a result):
 
-- `devframes:plugin:git:stage` — `git add` the given paths.
-- `devframes:plugin:git:unstage` — `git restore --staged` the given paths.
-- `devframes:plugin:git:commit` — commit the staged changes with a message.
+- `devframes:service:git:stage` — `git add` the given paths.
+- `devframes:service:git:unstage` — `git restore --staged` the given paths.
+- `devframes:service:git:commit` — commit the staged changes with a message.
 
 ## Develop
 

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as createGitDevframe } from "./src-CyRmAQrb.mjs";
+import { t as createGitDevframe } from "./src-E7rY0DjA.mjs";
 import process from "node:process";
 import { createCac } from "devframe/adapters/cac";
 //#region src/cli.ts

package/dist/index.d.mts

@@ -1,180 +1,4 @@
 import { DevframeDefinition } from "devframe";
-//#region src/rpc/functions/branches.d.ts
-interface Branch {
-  name: string;
-  current: boolean;
-  sha: string;
-  upstream: string | null;
-  subject: string;
-  ahead: number;
-  behind: number;
-  /** `true` when the upstream branch no longer exists. */
-  gone: boolean;
-}
-interface GitBranches {
-  isRepo: boolean;
-  current: string | null;
-  branches: Branch[];
-}
-//#endregion
-//#region src/rpc/functions/status.d.ts
-type FileStatusCode = 'modified' | 'added' | 'deleted' | 'renamed' | 'copied' | 'type-changed' | 'unmerged' | 'unknown';
-interface StatusFileEntry {
-  path: string;
-  /** Previous path, present for renames and copies. */
-  from?: string;
-  status: FileStatusCode;
-}
-interface GitStatus {
-  /** `false` when the working directory is not inside a git repository. */
-  isRepo: boolean;
-  root: string | null;
-  /** Current branch name, or `null` when HEAD is detached. */
-  branch: string | null;
-  detached: boolean;
-  /** Short HEAD object name. */
-  head: string | null;
-  upstream: string | null;
-  ahead: number;
-  behind: number;
-  staged: StatusFileEntry[];
-  unstaged: StatusFileEntry[];
-  untracked: string[];
-  /** `true` when there are no staged, unstaged, or untracked changes. */
-  clean: boolean;
-  /** `true` when stage / unstage / commit actions are available. */
-  canWrite: boolean;
-}
-//#endregion
-//#region src/rpc/functions/commit.d.ts
-interface CommitArgs {
-  /** Commit message. */
-  message: string;
-}
-interface CommitResult {
-  /** `true` when the commit succeeded. */
-  ok: boolean;
-  /** Short hash of the new commit, or `null` on failure. */
-  hash: string | null;
-  /** Human-readable outcome (e.g. "nothing to commit"). */
-  message: string;
-  /** Working-tree status after the attempt. */
-  status: GitStatus;
-}
-//#endregion
-//#region src/rpc/functions/diff.d.ts
-interface DiffFile {
-  path: string;
-  additions: number;
-  deletions: number;
-  binary: boolean;
-}
-interface GitDiff {
-  isRepo: boolean;
-  staged: boolean;
-  path: string | null;
-  files: DiffFile[];
-  totalAdditions: number;
-  totalDeletions: number;
-  /** Unified patch text — populated when `path` targets a single file. */
-  patch: string | null;
-  /** `true` when `patch` was clipped to {@link PATCH_CHAR_LIMIT}. */
-  truncated: boolean;
-}
-interface DiffArgs {
-  /** Limit the diff to a single path; omit for the whole tree. */
-  path?: string;
-  /** Diff the index against HEAD instead of the working tree. */
-  staged?: boolean;
-}
-//#endregion
-//#region src/rpc/functions/log.d.ts
-interface Commit {
-  hash: string;
-  shortHash: string;
-  author: string;
-  email: string;
-  /** Author date as epoch milliseconds. */
-  date: number;
-  subject: string;
-  body: string;
-  /** Ref names pointing at this commit (branches, tags, HEAD). */
-  refs: string[];
-  /** Full parent hashes — drives the commit graph. */
-  parents: string[];
-}
-interface GitLog {
-  isRepo: boolean;
-  commits: Commit[];
-  limit: number;
-  skip: number;
-  /** `true` when the page filled to `limit`, hinting at further history. */
-  hasMore: boolean;
-}
-interface LogArgs {
-  /** Number of commits to return (clamped to 1–200, default 30). */
-  limit?: number;
-  /** Commits to skip from the tip, for pagination (default 0). */
-  skip?: number;
-  /** Optional ref/branch to read history from (default: current HEAD). */
-  ref?: string;
-}
-//#endregion
-//#region src/rpc/functions/show.d.ts
-interface CommitFile {
-  path: string;
-  additions: number;
-  deletions: number;
-  binary: boolean;
-  /** Change kind relative to the parent (add / modify / delete / rename …). */
-  status: FileStatusCode;
-}
-interface CommitDetail {
-  /** `false` when the working directory is not inside a git repository. */
-  isRepo: boolean;
-  /** `false` when the hash does not resolve to a commit. */
-  found: boolean;
-  hash: string;
-  shortHash: string;
-  author: string;
-  email: string;
-  /** Author date as epoch milliseconds. */
-  date: number;
-  committer: string;
-  committerEmail: string;
-  /** Commit date as epoch milliseconds. */
-  commitDate: number;
-  subject: string;
-  body: string;
-  parents: string[];
-  refs: string[];
-  files: CommitFile[];
-  totalAdditions: number;
-  totalDeletions: number;
-  /** Unified patch text for the commit, or `null` when omitted/unavailable. */
-  patch: string | null;
-  /** `true` when `patch` was clipped to {@link PATCH_CHAR_LIMIT}. */
-  truncated: boolean;
-}
-interface ShowArgs {
-  /** Commit-ish to inspect (full or short hash). */
-  hash: string;
-  /** Include the full unified patch (default `true`). */
-  patch?: boolean;
-}
-//#endregion
-//#region src/rpc/functions/stage.d.ts
-interface StageArgs {
-  /** Paths to stage (`git add`). */
-  paths: string[];
-}
-//#endregion
-//#region src/rpc/functions/unstage.d.ts
-interface UnstageArgs {
-  /** Paths to unstage (`git restore --staged`). */
-  paths: string[];
-}
-//#endregion
 //#region src/index.d.ts
 interface GitDevframeOptions {
   /** Repository directory to inspect. Defaults to the devframe `cwd`. */
@@ -188,11 +12,6 @@ interface GitDevframeOptions {
   distDir?: string;
   /** Preferred dev-server port (default 9710). */
   port?: number;
-  /**
-   * Enable staging, unstaging, and committing from the UI. Read-only by
-   * default; the standalone CLI also accepts a `--write` flag.
-   */
-  write?: boolean;
   /**
    * Require the trust handshake on the standalone server. Enabled by
    * default — `--open` embeds the current OTP in the opened URL, so the
@@ -202,12 +21,15 @@ interface GitDevframeOptions {
   auth?: boolean;
 }
 /**
- * Create the Git dashboard devframe. Mount it into any host via devframe's
- * adapters, or run it standalone with the bundled CLI (`devframe-git`).
+ * Create the Git dashboard devframe. All git work runs through the
+ * `@devframes/service-git` wire service (declared below); the SPA calls its
+ * `devframes:service:git:*` RPC directly. Mount it into any host via
+ * devframe's adapters, or run it standalone with the bundled CLI
+ * (`devframe-git`).
  *
  * @experimental This plugin is experimental and may change without a major
  * version bump until it stabilizes.
  */
 declare function createGitDevframe(options?: GitDevframeOptions): DevframeDefinition;
 //#endregion
-export { type Branch, type Commit, type CommitArgs, type CommitDetail, type CommitFile, type CommitResult, type DiffArgs, type DiffFile, type FileStatusCode, type GitBranches, GitDevframeOptions, type GitDiff, type GitLog, type GitStatus, type LogArgs, type ShowArgs, type StageArgs, type StatusFileEntry, type UnstageArgs, createGitDevframe, createGitDevframe as default };
+export { GitDevframeOptions, createGitDevframe, createGitDevframe as default };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { t as createGitDevframe } from "./src-CyRmAQrb.mjs";
+import { t as createGitDevframe } from "./src-E7rY0DjA.mjs";
 export { createGitDevframe, createGitDevframe as default };

package/dist/src-E7rY0DjA.mjs

@@ -0,0 +1,74 @@
+import process from "node:process";
+import { defineDevframe } from "devframe";
+import { resolve } from "pathe";
+//#region package.json
+var name = "@devframes/plugin-git";
+var version = "0.9.3";
+var description = "Devframe plugin that shows a Git dashboard for status, log, branches, and diffs.";
+var homepage = "https://github.com/devframes/devframe#readme";
+//#endregion
+//#region src/index.ts
+const remoteAssets = {
+	package: `${name}--assets`,
+	version
+};
+const GIT_SERVICE = "@devframes/service-git";
+/**
+* Create the Git dashboard devframe. All git work runs through the
+* `@devframes/service-git` wire service (declared below); the SPA calls its
+* `devframes:service:git:*` RPC directly. Mount it into any host via
+* devframe's adapters, or run it standalone with the bundled CLI
+* (`devframe-git`).
+*
+* @experimental This plugin is experimental and may change without a major
+* version bump until it stabilizes.
+*/
+function createGitDevframe(options = {}) {
+	const distDir = options.distDir ?? remoteAssets;
+	const cwd = options.repoRoot ? resolve(process.cwd(), options.repoRoot) : void 0;
+	return defineDevframe({
+		id: "devframes_plugin_git",
+		name: "Git",
+		version,
+		packageName: name,
+		importMetaUrl: import.meta.url,
+		homepage,
+		description,
+		icon: "ph:git-branch-duotone",
+		basePath: options.basePath,
+		cli: {
+			command: "devframe-git",
+			port: options.port ?? 9710,
+			distDir,
+			auth: options.auth ?? true
+		},
+		services: [{
+			package: GIT_SERVICE,
+			...cwd ? { options: { cwd } } : {}
+		}, { package: "@devframes/service-shiki" }],
+		rpc: { snapshot: [
+			"devframes:service:git:status",
+			"devframes:service:git:branches",
+			"devframes:service:git:diff",
+			{
+				method: "devframes:service:git:log",
+				inputs: [[{ limit: 200 }]]
+			},
+			{
+				method: "devframes:service:git:show",
+				inputs: async (ctx) => {
+					const git = ctx.services.get(GIT_SERVICE);
+					if (!git) return [];
+					const { commits } = await git.log({ limit: 200 });
+					return commits.map((commit) => [{
+						hash: commit.hash,
+						patch: false
+					}]);
+				}
+			}
+		] },
+		setup() {}
+	});
+}
+//#endregion
+export { createGitDevframe as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-git",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Devframe plugin that shows a Git dashboard for status, log, branches, and diffs.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-git--assets": "0.9.1"
+    "@devframes/plugin-git--assets": "0.9.3"
   },
   "peerDependenciesMeta": {
     "@devframes/plugin-git--assets": {
@@ -43,35 +43,38 @@
   "dependencies": {
     "cac": "^7.0.0",
     "pathe": "^2.0.3",
-    "devframe": "0.9.1"
+    "@devframes/service-git": "0.9.3",
+    "@devframes/service-shiki": "0.9.3",
+    "devframe": "0.9.3"
   },
   "devDependencies": {
     "@antfu/design": "^0.3.4",
     "@floating-ui/react": "^0.27.20",
     "@iconify-json/catppuccin": "^1.2.17",
-    "@pierre/diffs": "^1.2.12",
     "@radix-ui/react-scroll-area": "^1.2.18",
     "@radix-ui/react-slot": "^1.3.3",
-    "@storybook/addon-a11y": "^10.5.7",
-    "@storybook/addon-docs": "^10.5.7",
-    "@storybook/react-vite": "^10.5.7",
+    "@storybook/addon-a11y": "^10.5.8",
+    "@storybook/addon-docs": "^10.5.8",
+    "@storybook/react-vite": "^10.5.8",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
     "@unocss/postcss": "^66.7.5",
     "@vitejs/plugin-react-oxc": "^0.4.3",
     "clsx": "^2.1.1",
     "colorjs.io": "^0.7.1",
+    "diff": "^9.0.0",
     "h3": "^2.0.1-rc.26",
-    "next": "^16.3.0",
+    "next": "^16.3.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "storybook": "^10.5.7",
+    "shiki": "^4.4.3",
+    "storybook": "^10.5.8",
     "tailwind-merge": "^3.6.0",
     "tsdown": "^0.22.14",
     "unocss": "^66.7.5",
     "vitest": "^4.1.10",
     "ws": "^8.21.3",
-    "@devframes/plugin-git--assets": "0.9.1"
+    "@devframes/plugin-git--assets": "0.9.3"
   },
   "scripts": {
     "build": "tsdown && pnpm run build:spa",

package/dist/src-CyRmAQrb.mjs

@@ -1,933 +0,0 @@
-import { defineDevframe, defineRpcFunction } from "devframe";
-import { resolve } from "pathe";
-import { execFile } from "node:child_process";
-import process from "node:process";
-import { promisify } from "node:util";
-import { s } from "devframe/utils/simple-schema";
-//#region package.json
-var name = "@devframes/plugin-git";
-var version = "0.9.1";
-var description = "Devframe plugin that shows a Git dashboard for status, log, branches, and diffs.";
-var homepage = "https://github.com/devframes/devframe#readme";
-//#endregion
-//#region src/node/git.ts
-const execFileAsync = promisify(execFile);
-const MAX_BUFFER = 67108864;
-/**
-* 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) {
-	const { stdout, stderr } = await execFileAsync("git", args, {
-		cwd,
-		maxBuffer: MAX_BUFFER,
-		windowsHide: true,
-		env: {
-			...process.env,
-			GIT_PAGER: "cat",
-			GIT_OPTIONAL_LOCKS: "0",
-			LC_ALL: "C"
-		}
-	});
-	return {
-		stdout,
-		stderr
-	};
-}
-/** Run a git command, returning trimmed stdout or `null` when it fails. */
-async function tryGit(cwd, args) {
-	try {
-		const { stdout } = await runGit(cwd, args);
-		return stdout.replace(/\n$/, "");
-	} catch {
-		return null;
-	}
-}
-/**
-* Client-supplied revisions must not start with `-`, which Git would parse as
-* an option before it treats the value as a revision.
-*/
-function isSafeRevision(rev) {
-	return rev.length > 0 && !rev.startsWith("-");
-}
-/** Resolve the repository root for `cwd`, or `null` when `cwd` is outside a repo. */
-async function resolveRepoRoot(cwd) {
-	return tryGit(cwd, ["rev-parse", "--show-toplevel"]);
-}
-/** Split git output on a separator, dropping the trailing empty segment. */
-function splitClean(input, separator) {
-	return input.split(separator).filter((part) => part.length > 0);
-}
-/**
-* Extract a concise, single-line message from a failed `execFile` error.
-* git writes useful text (e.g. "nothing to commit") to stdout/stderr.
-*/
-function gitErrorMessage(error) {
-	const e = error;
-	return (e?.stderr || e?.stdout || e?.message || "git command failed").trim().split("\n")[0];
-}
-//#endregion
-//#region src/rpc/context.ts
-const configs = /* @__PURE__ */ new WeakMap();
-const contexts = /* @__PURE__ */ new WeakMap();
-/**
-* Record the working directory for a context. Called from the devframe
-* `setup` before any RPC handler runs, so {@link getGitContext} can honor a
-* `repoRoot` override instead of the raw `ctx.cwd`.
-*/
-function configureGit(ctx, config) {
-	configs.set(ctx, config);
-}
-/**
-* Per-`DevframeNodeContext` git state. Each RPC function file pulls its
-* working directory and (memoized) repo-root lookup from here instead of
-* re-resolving on every call.
-*/
-function getGitContext(ctx) {
-	let existing = contexts.get(ctx);
-	if (existing) return existing;
-	const config = configs.get(ctx);
-	const cwd = config?.cwd ?? ctx.cwd;
-	const write = config?.write ?? false;
-	let rootPromise;
-	existing = {
-		cwd,
-		write,
-		resolveRoot: () => {
-			rootPromise ??= resolveRepoRoot(cwd);
-			return rootPromise;
-		}
-	};
-	contexts.set(ctx, existing);
-	return existing;
-}
-//#endregion
-//#region src/rpc/functions/branches.ts
-const FORMAT$1 = [
-	"%(refname:short)",
-	"%(objectname:short)",
-	"%(HEAD)",
-	"%(upstream:short)",
-	"%(upstream:track)",
-	"%(contents:subject)"
-].join("");
-function parseTrack(track) {
-	if (track.includes("gone")) return {
-		ahead: 0,
-		behind: 0,
-		gone: true
-	};
-	const ahead = track.match(/ahead (\d+)/);
-	const behind = track.match(/behind (\d+)/);
-	return {
-		ahead: ahead ? Number(ahead[1]) : 0,
-		behind: behind ? Number(behind[1]) : 0,
-		gone: false
-	};
-}
-const branches = defineRpcFunction({
-	name: "devframes:plugin:git:branches",
-	type: "query",
-	snapshot: true,
-	jsonSerializable: true,
-	agent: {
-		description: "List local and remote branches of the inspected repository with tracking state (ahead/behind, gone upstreams) and the current branch. Safe to call freely.",
-		title: "Git branches"
-	},
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async () => {
-			if (!await git.resolveRoot()) return {
-				isRepo: false,
-				current: null,
-				branches: []
-			};
-			const raw = await tryGit(git.cwd, [
-				"for-each-ref",
-				`--format=${FORMAT$1}`,
-				"refs/heads"
-			]);
-			if (!raw) return {
-				isRepo: true,
-				current: null,
-				branches: []
-			};
-			let current = null;
-			const branches = splitClean(raw, "\n").map((line) => {
-				const [name, sha, head, upstream, track, subject] = line.split("");
-				const isCurrent = head === "*";
-				if (isCurrent) current = name;
-				return {
-					name,
-					current: isCurrent,
-					sha,
-					upstream: upstream || null,
-					subject: subject ?? "",
-					...parseTrack(track ?? "")
-				};
-			});
-			branches.sort((a, b) => Number(b.current) - Number(a.current));
-			return {
-				isRepo: true,
-				current,
-				branches
-			};
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/status.ts
-const EMPTY_STATUS = {
-	isRepo: false,
-	root: null,
-	branch: null,
-	detached: false,
-	head: null,
-	upstream: null,
-	ahead: 0,
-	behind: 0,
-	staged: [],
-	unstaged: [],
-	untracked: [],
-	clean: true,
-	canWrite: false
-};
-function mapCode(code) {
-	switch (code) {
-		case "M": return "modified";
-		case "A": return "added";
-		case "D": return "deleted";
-		case "R": return "renamed";
-		case "C": return "copied";
-		case "T": return "type-changed";
-		case "U": return "unmerged";
-		default: return "unknown";
-	}
-}
-/**
-* Parse `git status --porcelain=v2 --branch -z` into a structured snapshot.
-* Records are NUL-separated; rename/copy (type `2`) entries consume an extra
-* token for the original path.
-*/
-function parseStatus(root, raw) {
-	const tokens = raw.split("\0");
-	const status = {
-		...EMPTY_STATUS,
-		isRepo: true,
-		root,
-		staged: [],
-		unstaged: [],
-		untracked: []
-	};
-	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));
-	}
-	status.clean = status.staged.length === 0 && status.unstaged.length === 0 && status.untracked.length === 0;
-	return status;
-}
-/**
-* Read the working-tree status for a git context. Shared by the `devframes:plugin:git:status`
-* query and the write actions (which return fresh status after mutating).
-*/
-async function readStatus(git) {
-	const root = await git.resolveRoot();
-	if (!root) return {
-		...EMPTY_STATUS,
-		canWrite: false
-	};
-	const { stdout } = await runGit(git.cwd, [
-		"status",
-		"--porcelain=v2",
-		"--branch",
-		"-z"
-	]);
-	const status = parseStatus(root, stdout);
-	status.canWrite = git.write;
-	return status;
-}
-const status = defineRpcFunction({
-	name: "devframes:plugin:git:status",
-	type: "query",
-	snapshot: true,
-	jsonSerializable: true,
-	agent: {
-		description: "Working-tree status of the inspected repository: current branch, ahead/behind counts, and every staged/unstaged/untracked file. Call this first to orient before reading diffs or history. Safe to call freely.",
-		title: "Git status"
-	},
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: () => readStatus(git) };
-	}
-});
-//#endregion
-//#region src/rpc/functions/commit.ts
-const commit = defineRpcFunction({
-	name: "devframes:plugin:git:commit",
-	type: "action",
-	jsonSerializable: true,
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args) => {
-			const message = (args?.message ?? "").trim();
-			if (!await git.resolveRoot()) return {
-				ok: false,
-				hash: null,
-				message: "Not a git repository.",
-				status: await readStatus(git)
-			};
-			if (!message) return {
-				ok: false,
-				hash: null,
-				message: "Commit message is required.",
-				status: await readStatus(git)
-			};
-			try {
-				await runGit(git.cwd, [
-					"commit",
-					"-m",
-					message
-				]);
-				return {
-					ok: true,
-					hash: await tryGit(git.cwd, [
-						"rev-parse",
-						"--short",
-						"HEAD"
-					]),
-					message: "Committed.",
-					status: await readStatus(git)
-				};
-			} catch (error) {
-				return {
-					ok: false,
-					hash: null,
-					message: gitErrorMessage(error),
-					status: await readStatus(git)
-				};
-			}
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/diff.ts
-/** Hard cap on the returned patch text to keep payloads bounded. */
-const PATCH_CHAR_LIMIT$1 = 2e5;
-const diffFileSchema = s.object({
-	path: s.string(),
-	additions: s.number(),
-	deletions: s.number(),
-	binary: s.boolean()
-});
-const gitDiffSchema = s.object({
-	isRepo: s.boolean(),
-	staged: s.boolean(),
-	path: s.nullable(s.string()),
-	files: s.array(diffFileSchema),
-	totalAdditions: s.number(),
-	totalDeletions: s.number(),
-	patch: s.nullable(s.string()),
-	truncated: s.boolean()
-});
-function parseNumstat$1(raw) {
-	return splitClean(raw, "\n").map((line) => {
-		const [add, del, ...rest] = line.split("	");
-		const binary = add === "-" || del === "-";
-		return {
-			path: rest.join("	"),
-			additions: binary ? 0 : Number(add),
-			deletions: binary ? 0 : Number(del),
-			binary
-		};
-	});
-}
-const diff = defineRpcFunction({
-	name: "devframes:plugin:git:diff",
-	type: "query",
-	snapshot: true,
-	jsonSerializable: true,
-	args: [s.object({
-		path: s.optional(s.string()),
-		staged: s.optional(s.boolean())
-	})],
-	returns: gitDiffSchema,
-	agent: {
-		description: "Unified diff of uncommitted changes in the inspected repository — the working tree by default, the index with staged: true, one file with path. Call before summarizing or reviewing in-progress work. Safe to call freely.",
-		title: "Git diff"
-	},
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args = {}) => {
-			const { path, staged = false } = args;
-			if (!await git.resolveRoot()) return {
-				isRepo: false,
-				staged,
-				path: path ?? null,
-				files: [],
-				totalAdditions: 0,
-				totalDeletions: 0,
-				patch: null,
-				truncated: false
-			};
-			const base = staged ? ["diff", "--cached"] : ["diff"];
-			const scope = path ? ["--", path] : [];
-			const numstatRaw = await tryGit(git.cwd, [
-				...base,
-				"--numstat",
-				...scope
-			]);
-			const files = numstatRaw ? parseNumstat$1(numstatRaw) : [];
-			const totalAdditions = files.reduce((sum, f) => sum + f.additions, 0);
-			const totalDeletions = files.reduce((sum, f) => sum + f.deletions, 0);
-			let patch = null;
-			let truncated = false;
-			if (path) {
-				const { stdout } = await runGit(git.cwd, [...base, ...scope]);
-				if (stdout.length > PATCH_CHAR_LIMIT$1) {
-					patch = stdout.slice(0, PATCH_CHAR_LIMIT$1);
-					truncated = true;
-				} else patch = stdout;
-			}
-			return {
-				isRepo: true,
-				staged,
-				path: path ?? null,
-				files,
-				totalAdditions,
-				totalDeletions,
-				patch,
-				truncated
-			};
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/log.ts
-const commitSchema = s.object({
-	hash: s.string(),
-	shortHash: s.string(),
-	author: s.string(),
-	email: s.string(),
-	date: s.number(),
-	subject: s.string(),
-	body: s.string(),
-	refs: s.array(s.string()),
-	parents: s.array(s.string())
-});
-const gitLogSchema = s.object({
-	isRepo: s.boolean(),
-	commits: s.array(commitSchema),
-	limit: s.number(),
-	skip: s.number(),
-	hasMore: s.boolean()
-});
-const FORMAT = [
-	"%H",
-	"%h",
-	"%P",
-	"%an",
-	"%ae",
-	"%aI",
-	"%D",
-	"%s",
-	"%b"
-].join("") + "";
-function clamp(value, min, max) {
-	return Math.min(Math.max(value, min), max);
-}
-function parseLog(raw) {
-	return splitClean(raw, "").map((record) => {
-		const [hash, shortHash, parents, author, email, isoDate, refs, subject, body] = record.replace(/^\n/, "").split("");
-		return {
-			hash,
-			shortHash,
-			author,
-			email,
-			date: Date.parse(isoDate),
-			subject,
-			body: (body ?? "").trim(),
-			refs: refs ? refs.split(", ").map((r) => r.trim()).filter(Boolean) : [],
-			parents: parents ? parents.split(" ").filter(Boolean) : []
-		};
-	});
-}
-const SNAPSHOT_LIMIT$1 = 200;
-const log = defineRpcFunction({
-	name: "devframes:plugin:git:log",
-	type: "query",
-	jsonSerializable: true,
-	args: [s.object({
-		limit: s.optional(s.number()),
-		skip: s.optional(s.number()),
-		ref: s.optional(s.string())
-	})],
-	returns: gitLogSchema,
-	agent: {
-		description: "Commit history of the inspected repository, newest first. Paginate with limit (1-200, default 30) and skip; pass ref to read another branch. Call before reasoning about recent changes. Safe to call freely.",
-		title: "Git log"
-	},
-	dump: async (_ctx, handler) => {
-		const baked = {
-			...await handler({
-				limit: SNAPSHOT_LIMIT$1,
-				skip: 0
-			}),
-			hasMore: false
-		};
-		return {
-			records: [{
-				inputs: [],
-				output: baked
-			}],
-			fallback: baked
-		};
-	},
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args = {}) => {
-			const limit = clamp(Math.trunc(args.limit ?? 30), 1, 200);
-			const skip = Math.max(0, Math.trunc(args.skip ?? 0));
-			const ref = args.ref?.trim() || void 0;
-			if (!await git.resolveRoot()) return {
-				isRepo: false,
-				commits: [],
-				limit,
-				skip,
-				hasMore: false
-			};
-			const command = [
-				"log",
-				"--topo-order",
-				`--max-count=${limit}`,
-				`--skip=${skip}`,
-				`--pretty=format:${FORMAT}`
-			];
-			if (ref) {
-				if (!isSafeRevision(ref)) return {
-					isRepo: true,
-					commits: [],
-					limit,
-					skip,
-					hasMore: false
-				};
-				command.push("--end-of-options", ref);
-			}
-			const raw = await tryGit(git.cwd, command);
-			const commits = raw ? parseLog(raw) : [];
-			return {
-				isRepo: true,
-				commits,
-				limit,
-				skip,
-				hasMore: commits.length === limit
-			};
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/show.ts
-/** Hard cap on the returned patch text to keep payloads bounded. */
-const PATCH_CHAR_LIMIT = 2e5;
-/** Matches the window `devframes:plugin:git:log` bakes, so any visible commit has a snapshot. */
-const SNAPSHOT_LIMIT = 200;
-/** Read-only git detail work can run in parallel without overwhelming builds. */
-const DUMP_CONCURRENCY = 8;
-const fileStatusCodeSchema = s.picklist([
-	"modified",
-	"added",
-	"deleted",
-	"renamed",
-	"copied",
-	"type-changed",
-	"unmerged",
-	"unknown"
-]);
-const commitFileSchema = s.object({
-	path: s.string(),
-	additions: s.number(),
-	deletions: s.number(),
-	binary: s.boolean(),
-	status: fileStatusCodeSchema
-});
-const commitDetailSchema = s.object({
-	isRepo: s.boolean(),
-	found: s.boolean(),
-	hash: s.string(),
-	shortHash: s.string(),
-	author: s.string(),
-	email: s.string(),
-	date: s.number(),
-	committer: s.string(),
-	committerEmail: s.string(),
-	commitDate: s.number(),
-	subject: s.string(),
-	body: s.string(),
-	parents: s.array(s.string()),
-	refs: s.array(s.string()),
-	files: s.array(commitFileSchema),
-	totalAdditions: s.number(),
-	totalDeletions: s.number(),
-	patch: s.nullable(s.string()),
-	truncated: s.boolean()
-});
-const EMPTY_DETAIL = {
-	isRepo: false,
-	found: false,
-	hash: "",
-	shortHash: "",
-	author: "",
-	email: "",
-	date: 0,
-	committer: "",
-	committerEmail: "",
-	commitDate: 0,
-	subject: "",
-	body: "",
-	parents: [],
-	refs: [],
-	files: [],
-	totalAdditions: 0,
-	totalDeletions: 0,
-	patch: null,
-	truncated: false
-};
-const SHOW_FORMAT = [
-	"%H",
-	"%h",
-	"%P",
-	"%an",
-	"%ae",
-	"%aI",
-	"%cn",
-	"%ce",
-	"%cI",
-	"%D",
-	"%s",
-	"%b"
-].join("");
-function mapStatusCode(code) {
-	switch (code[0]) {
-		case "M": return "modified";
-		case "A": return "added";
-		case "D": return "deleted";
-		case "R": return "renamed";
-		case "C": return "copied";
-		case "T": return "type-changed";
-		case "U": return "unmerged";
-		default: return "unknown";
-	}
-}
-/**
-* Parse `git diff-tree --name-status` into a `path → status` map. Rename/copy
-* rows carry a similarity score and both old + new paths; the new path (last
-* field) keys the map so it aligns with the numstat entry.
-*/
-function parseNameStatus(raw) {
-	const map = /* @__PURE__ */ new Map();
-	for (const line of splitClean(raw, "\n")) {
-		const [code, ...paths] = line.split("	");
-		const path = paths[paths.length - 1];
-		if (path) map.set(path, mapStatusCode(code));
-	}
-	return map;
-}
-function parseNumstat(raw, status) {
-	return splitClean(raw, "\n").map((line) => {
-		const [add, del, ...rest] = line.split("	");
-		const binary = add === "-" || del === "-";
-		const path = rest.join("	");
-		return {
-			path,
-			additions: binary ? 0 : Number(add),
-			deletions: binary ? 0 : Number(del),
-			binary,
-			status: status.get(path) ?? "modified"
-		};
-	});
-}
-async function readCommit(git, hash, includePatch) {
-	if (!isSafeRevision(hash)) return {
-		...EMPTY_DETAIL,
-		isRepo: true
-	};
-	const meta = await tryGit(git.cwd, [
-		"show",
-		"-s",
-		`--format=${SHOW_FORMAT}`,
-		"--end-of-options",
-		hash
-	]);
-	if (meta == null) return {
-		...EMPTY_DETAIL,
-		isRepo: true
-	};
-	const [fullHash, shortHash, parents, author, email, authorDate, committer, committerEmail, committerDate, refs, subject, body] = meta.split("");
-	const numstat = await tryGit(git.cwd, [
-		"diff-tree",
-		"--no-commit-id",
-		"--numstat",
-		"-r",
-		"--root",
-		"--end-of-options",
-		hash
-	]);
-	const nameStatusRaw = await tryGit(git.cwd, [
-		"diff-tree",
-		"--no-commit-id",
-		"--name-status",
-		"-r",
-		"--root",
-		"--end-of-options",
-		hash
-	]);
-	const files = numstat ? parseNumstat(numstat, nameStatusRaw ? parseNameStatus(nameStatusRaw) : /* @__PURE__ */ new Map()) : [];
-	const totalAdditions = files.reduce((sum, f) => sum + f.additions, 0);
-	const totalDeletions = files.reduce((sum, f) => sum + f.deletions, 0);
-	let patch = null;
-	let truncated = false;
-	if (includePatch) {
-		const raw = await tryGit(git.cwd, [
-			"diff-tree",
-			"-p",
-			"--no-commit-id",
-			"-r",
-			"--root",
-			"--end-of-options",
-			hash
-		]);
-		if (raw != null) {
-			if (raw.length > PATCH_CHAR_LIMIT) {
-				patch = raw.slice(0, PATCH_CHAR_LIMIT);
-				truncated = true;
-			} else patch = raw;
-		}
-	}
-	return {
-		isRepo: true,
-		found: true,
-		hash: fullHash,
-		shortHash,
-		author,
-		email,
-		date: Date.parse(authorDate),
-		committer,
-		committerEmail,
-		commitDate: Date.parse(committerDate),
-		subject,
-		body: (body ?? "").trim(),
-		parents: parents ? parents.split(" ").filter(Boolean) : [],
-		refs: refs ? refs.split(", ").map((r) => r.trim()).filter(Boolean) : [],
-		files,
-		totalAdditions,
-		totalDeletions,
-		patch,
-		truncated
-	};
-}
-const show = defineRpcFunction({
-	name: "devframes:plugin:git:show",
-	type: "query",
-	jsonSerializable: true,
-	args: [s.object({
-		hash: s.string(),
-		patch: s.optional(s.boolean())
-	})],
-	returns: commitDetailSchema,
-	agent: {
-		description: "Full detail of one commit by hash (from the git log tool): metadata, changed files, and the unified patch (pass patch: false to skip it for large commits). Safe to call freely.",
-		title: "Git show"
-	},
-	dump: async (ctx, _handler) => {
-		const git = getGitContext(ctx);
-		if (!await git.resolveRoot()) return {
-			records: [],
-			fallback: EMPTY_DETAIL
-		};
-		const raw = await tryGit(git.cwd, [
-			"log",
-			"--topo-order",
-			`--max-count=${SNAPSHOT_LIMIT}`,
-			"--pretty=format:%H"
-		]);
-		const hashes = raw ? raw.split("\n").filter(Boolean) : [];
-		const records = [];
-		for (let i = 0; i < hashes.length; i += DUMP_CONCURRENCY) {
-			const batch = hashes.slice(i, i + DUMP_CONCURRENCY);
-			const outputs = await Promise.all(batch.map((hash) => readCommit(git, hash, false)));
-			batch.forEach((hash, index) => {
-				records.push({
-					inputs: [{ hash }],
-					output: outputs[index]
-				});
-			});
-		}
-		return {
-			records,
-			fallback: records[0]?.output ?? {
-				...EMPTY_DETAIL,
-				isRepo: true
-			}
-		};
-	},
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args) => {
-			const hash = (args?.hash ?? "").trim();
-			const includePatch = args?.patch ?? true;
-			if (!await git.resolveRoot() || !hash) return EMPTY_DETAIL;
-			return readCommit(git, hash, includePatch);
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/stage.ts
-const stage = defineRpcFunction({
-	name: "devframes:plugin:git:stage",
-	type: "action",
-	jsonSerializable: true,
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args) => {
-			const paths = args?.paths ?? [];
-			if (await git.resolveRoot() && paths.length > 0) await runGit(git.cwd, [
-				"add",
-				"--",
-				...paths
-			]);
-			return readStatus(git);
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/functions/unstage.ts
-const unstage = defineRpcFunction({
-	name: "devframes:plugin:git:unstage",
-	type: "action",
-	jsonSerializable: true,
-	setup: (ctx) => {
-		const git = getGitContext(ctx);
-		return { handler: async (args) => {
-			const paths = args?.paths ?? [];
-			if (await git.resolveRoot() && paths.length > 0) await runGit(git.cwd, [
-				"restore",
-				"--staged",
-				"--",
-				...paths
-			]);
-			return readStatus(git);
-		} };
-	}
-});
-//#endregion
-//#region src/rpc/index.ts
-/** Read-only RPC — always registered. */
-const readFunctions = [
-	status,
-	log,
-	show,
-	branches,
-	diff
-];
-/** Mutating RPC — registered only when write actions are enabled. */
-const writeFunctions = [
-	stage,
-	unstage,
-	commit
-];
-//#endregion
-//#region src/index.ts
-const remoteAssets = {
-	package: `${name}--assets`,
-	version,
-	resolveFrom: import.meta.url
-};
-/**
-* Create the Git dashboard devframe. Mount it into any host via devframe's
-* adapters, or run it standalone with the bundled CLI (`devframe-git`).
-*
-* @experimental This plugin is experimental and may change without a major
-* version bump until it stabilizes.
-*/
-function createGitDevframe(options = {}) {
-	const distDir = options.distDir ?? remoteAssets;
-	return defineDevframe({
-		id: "devframes_plugin_git",
-		name: "Git",
-		version,
-		packageName: name,
-		homepage,
-		description,
-		icon: "ph:git-branch-duotone",
-		basePath: options.basePath,
-		cli: {
-			command: "devframe-git",
-			port: options.port ?? 9710,
-			distDir,
-			auth: options.auth ?? true,
-			configure(cli) {
-				cli.option("--write", "Enable staging, unstaging, and committing from the UI");
-			}
-		},
-		setup(ctx, info) {
-			const write = options.write ?? info?.flags?.write === true;
-			configureGit(ctx, {
-				cwd: options.repoRoot ? resolve(options.repoRoot) : ctx.cwd,
-				write
-			});
-			for (const fn of readFunctions) ctx.rpc.register(fn);
-			if (write) for (const fn of writeFunctions) ctx.rpc.register(fn);
-		}
-	});
-}
-//#endregion
-export { createGitDevframe as t };