@shelken/pi-co-authored-by 0.2.6

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Bruno Garcia
+Modifications Copyright (c) 2026 shelken
+
+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/README.md

@@ -0,0 +1,22 @@
+# pi-co-authored-by
+
+agent 通过 bash 工具执行 `git commit` 时，自动追加：
+
+- `Co-Authored-By: <model> <noreply@pi.dev>`
+- `Generated-By: pi <version>`
+
+实现方式：session 级临时 `core.hooksPath` + `prepare-commit-msg` hook。
+
+初始 fork 自 [bruno-garcia/pi-co-authored-by](https://github.com/bruno-garcia/pi-co-authored-by)；本仓库有本地改动。
+
+## 安装
+
+```bash
+pi install npm:@shelken/pi-co-authored-by
+```
+
+## 验证
+
+```bash
+bun --filter @shelken/pi-co-authored-by test
+```

package/index.ts

@@ -0,0 +1,39 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { isToolCallEventType, VERSION } from "@earendil-works/pi-coding-agent";
+import {
+	createCommitHookDirectory,
+	removeCommitHookDirectory,
+	wrapBashWithCommitHook,
+} from "./lib/commit.ts";
+
+export default function (pi: ExtensionAPI) {
+	let hooksDir: string | undefined;
+
+	function ensureHooksDir(): string {
+		hooksDir ??= createCommitHookDirectory();
+		return hooksDir;
+	}
+
+	pi.on("session_start", async () => {
+		ensureHooksDir();
+	});
+
+	pi.on("session_shutdown", async () => {
+		removeCommitHookDirectory(hooksDir);
+		hooksDir = undefined;
+	});
+
+	pi.on("tool_call", async (event, ctx) => {
+		if (!isToolCallEventType("bash", event)) return;
+
+		const model = ctx.model;
+		const modelName = model ? (model.name || `${model.provider}/${model.id}`) : "unknown";
+
+		event.input.command = wrapBashWithCommitHook(
+			event.input.command,
+			ensureHooksDir(),
+			modelName,
+			VERSION,
+		);
+	});
+}

package/lib/commit.ts

@@ -0,0 +1,97 @@
+import { chmodSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+export const CO_AUTHOR_NAME = "Co-Authored-By";
+export const GENERATED_BY_NAME = "Generated-By";
+
+/** Create a session-scoped Git hooks directory for commit trailer injection. */
+export function createCommitHookDirectory(): string {
+	const hooksDir = mkdtempSync(join(tmpdir(), "pi-co-authored-by-hooks-"));
+	const hookPath = join(hooksDir, "prepare-commit-msg");
+	writeFileSync(hookPath, buildPrepareCommitMsgHook(), { mode: 0o755 });
+	chmodSync(hookPath, 0o755);
+	return hooksDir;
+}
+
+/** Remove the session-scoped Git hooks directory. */
+export function removeCommitHookDirectory(hooksDir: string | undefined): void {
+	if (!hooksDir) return;
+	rmSync(hooksDir, { recursive: true, force: true });
+}
+
+/** Add process-local Git hook configuration and trailer metadata to a bash command. */
+export function wrapBashWithCommitHook(
+	cmd: string,
+	hooksDir: string,
+	modelName: string,
+	piVersion: string,
+): string {
+	const coAuthor = `${CO_AUTHOR_NAME}: ${modelName} <noreply@pi.dev>`;
+	const generatedBy = `${GENERATED_BY_NAME}: pi ${piVersion}`;
+
+	return `${buildEnvironmentPrefix(hooksDir, coAuthor, generatedBy)}\n${cmd}`;
+}
+
+function buildEnvironmentPrefix(
+	hooksDir: string,
+	coAuthor: string,
+	generatedBy: string,
+): string {
+	return `__pi_co_authored_by_git_config_index="\${GIT_CONFIG_COUNT:-0}"
+export PI_CO_AUTHORED_BY_GIT_CONFIG_INDEX="$__pi_co_authored_by_git_config_index"
+export PI_CO_AUTHORED_BY_CO_AUTHOR=${shellQuote(coAuthor)}
+export PI_CO_AUTHORED_BY_GENERATED_BY=${shellQuote(generatedBy)}
+export "GIT_CONFIG_KEY_\${__pi_co_authored_by_git_config_index}=core.hooksPath"
+export "GIT_CONFIG_VALUE_\${__pi_co_authored_by_git_config_index}=${escapeDoubleQuotedAssignmentValue(hooksDir)}"
+export GIT_CONFIG_COUNT="$((__pi_co_authored_by_git_config_index + 1))"
+unset __pi_co_authored_by_git_config_index`;
+}
+
+function buildPrepareCommitMsgHook(): string {
+	return `#!/bin/sh
+set -u
+
+message_file="$1"
+
+if [ -n "\${PI_CO_AUTHORED_BY_CO_AUTHOR:-}" ] && [ -n "\${PI_CO_AUTHORED_BY_GENERATED_BY:-}" ]; then
+  git \
+    -c trailer.co-authored-by.ifExists=addIfDifferent \
+    -c trailer.generated-by.ifExists=replace \
+    interpret-trailers \
+    --in-place \
+    --trailer "$PI_CO_AUTHORED_BY_CO_AUTHOR" \
+    --trailer "$PI_CO_AUTHORED_BY_GENERATED_BY" \
+    "$message_file"
+fi
+
+if [ -n "\${PI_CO_AUTHORED_BY_GIT_CONFIG_INDEX:-}" ]; then
+  __pi_config_index="$PI_CO_AUTHORED_BY_GIT_CONFIG_INDEX"
+  unset "GIT_CONFIG_KEY_$__pi_config_index"
+  unset "GIT_CONFIG_VALUE_$__pi_config_index"
+  export GIT_CONFIG_COUNT="$__pi_config_index"
+fi
+
+original_hooks_path="$(git config --get core.hooksPath || true)"
+if [ -n "$original_hooks_path" ]; then
+  case "$original_hooks_path" in
+    /*) original_hook="$original_hooks_path/prepare-commit-msg" ;;
+    *) original_hook="$(git rev-parse --show-toplevel)/$original_hooks_path/prepare-commit-msg" ;;
+  esac
+else
+  original_hook="$(git rev-parse --git-path hooks/prepare-commit-msg)"
+fi
+
+if [ -x "$original_hook" ] && [ "$original_hook" != "$0" ]; then
+  "$original_hook" "$@"
+fi
+`;
+}
+
+function shellQuote(value: string): string {
+	return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+
+function escapeDoubleQuotedAssignmentValue(value: string): string {
+	return value.replace(/[\\"$`]/g, "\\$&");
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@shelken/pi-co-authored-by",
+  "version": "0.2.6",
+  "description": "agent 执行 git commit 时自动追加 Co-Authored-By / Generated-By trailer",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    "lib/commit.ts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shelken/pi-extensions.git",
+    "directory": "extensions/pi-co-authored-by"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run"
+  },
+  "keywords": [
+    "pi-package",
+    "git",
+    "co-authored-by"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  }
+}