claude-attribution 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claude-attribution",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "AI code attribution tracking for Claude Code sessions — checkpoint-based line diff approach",
 	"type": "module",
 	"bin": {

package/src/cli.ts

@@ -50,18 +50,40 @@ switch (cmd) {
 			case "post-commit":
 				await import("./attribution/commit.ts");
 				break;
-			case "pre-push":
-				try {
-					await execFileAsync("git", [
-						"push",
-						"origin",
-						"refs/notes/claude-attribution",
-					]);
-				} catch {
-					// Ignore — notes push failure must not block git push
+			case "pre-push": {
+				// Git passes pushed refs on stdin: "<local-ref> <local-sha> <remote-ref> <remote-sha>\n..."
+				// Skip notes push for tag-only and notes pushes to avoid SSH connection conflicts.
+				const stdin = await new Promise<string>((resolve) => {
+					let data = "";
+					process.stdin.setEncoding("utf8");
+					process.stdin.on("data", (chunk: string) => (data += chunk));
+					process.stdin.on("end", () => resolve(data));
+				});
+				const isBranchPush = stdin
+					.trim()
+					.split("\n")
+					.filter(Boolean)
+					.some((line) => {
+						const remoteRef = line.split(" ")[2] ?? "";
+						return (
+							!remoteRef.startsWith("refs/tags/") &&
+							!remoteRef.startsWith("refs/notes/")
+						);
+					});
+				if (isBranchPush) {
+					try {
+						await execFileAsync("git", [
+							"push",
+							"origin",
+							"refs/notes/claude-attribution",
+						]);
+					} catch {
+						// Ignore — notes push failure must not block git push
+					}
 				}
 				process.exit(0);
 				break;
+			}
 			default:
 				console.error(`Unknown hook: ${rest[0]}`);
 				process.exit(1);

package/src/setup/install.ts

@@ -86,7 +86,7 @@ function detectHookManager(repoRoot: string): "husky" | "lefthook" | "none" {
 
 async function installPrePushHook(repoRoot: string): Promise<void> {
 	const manager = detectHookManager(repoRoot);
-	const runLine = `"${CLI_BIN}" hook pre-push || true`;
+	const runLine = `claude-attribution hook pre-push || true`;
 
 	if (manager === "husky") {
 		const huskyHook = join(repoRoot, ".husky", "pre-push");
@@ -126,14 +126,12 @@ async function installPrePushHook(repoRoot: string): Promise<void> {
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "pre-push.sh"),
 		"utf8",
 	);
-	const template = rawTemplate.replace(/\{\{CLI_BIN\}\}/g, () => CLI_BIN);
-
 	if (existsSync(hookDest)) {
 		const existing = await readFile(hookDest, "utf8");
 		if (!existing.includes("claude-attribution")) {
 			await writeFile(
 				hookDest,
-				existing.trimEnd() + "\n\n# claude-attribution\n" + template,
+				existing.trimEnd() + "\n\n# claude-attribution\n" + rawTemplate,
 			);
 			await chmod(hookDest, 0o755);
 			return;
@@ -141,13 +139,13 @@ async function installPrePushHook(repoRoot: string): Promise<void> {
 		// Already ours — replace
 	}
 
-	await writeFile(hookDest, template);
+	await writeFile(hookDest, rawTemplate);
 	await chmod(hookDest, 0o755);
 }
 
 async function installGitHook(repoRoot: string): Promise<void> {
 	const manager = detectHookManager(repoRoot);
-	const runLine = `"${CLI_BIN}" hook post-commit || true`;
+	const runLine = `claude-attribution hook post-commit || true`;
 
 	if (manager === "husky") {
 		// Husky: add post-commit file to .husky/ directory
@@ -189,14 +187,13 @@ async function installGitHook(repoRoot: string): Promise<void> {
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "post-commit.sh"),
 		"utf8",
 	);
-	const newContent = template.replace(/\{\{CLI_BIN\}\}/g, () => CLI_BIN);
 
 	if (existsSync(hookDest)) {
 		const existing = await readFile(hookDest, "utf8");
 		if (!existing.includes("claude-attribution")) {
 			await writeFile(
 				hookDest,
-				existing.trimEnd() + "\n\n# claude-attribution\n" + newContent,
+				existing.trimEnd() + "\n\n# claude-attribution\n" + template,
 			);
 			await chmod(hookDest, 0o755);
 			return;
@@ -204,7 +201,7 @@ async function installGitHook(repoRoot: string): Promise<void> {
 		// Already ours — replace
 	}
 
-	await writeFile(hookDest, newContent);
+	await writeFile(hookDest, template);
 	await chmod(hookDest, 0o755);
 }
 
@@ -245,9 +242,7 @@ async function main() {
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "hooks.json"),
 		"utf8",
 	);
-	const hooksConfig = JSON.parse(
-		hooksTemplate.replace(/\{\{CLI_BIN\}\}/g, () => CLI_BIN),
-	) as HooksConfig;
+	const hooksConfig = JSON.parse(hooksTemplate) as HooksConfig;
 
 	await mergeHooks(settingsPath, hooksConfig);
 	console.log("✓ Merged hooks into .claude/settings.json");
@@ -288,27 +283,21 @@ async function main() {
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "metrics-command.md"),
 		"utf8",
 	);
-	const metricsContent = metricsTemplate.replace(
-		/\{\{CLI_BIN\}\}/g,
-		() => CLI_BIN,
-	);
-	await writeFile(join(commandsDir, "metrics.md"), metricsContent);
+	await writeFile(join(commandsDir, "metrics.md"), metricsTemplate);
 	console.log("✓ Installed .claude/commands/metrics.md (/metrics command)");
 
 	const startTemplate = await readFile(
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "start-command.md"),
 		"utf8",
 	);
-	const startContent = startTemplate.replace(/\{\{CLI_BIN\}\}/g, () => CLI_BIN);
-	await writeFile(join(commandsDir, "start.md"), startContent);
+	await writeFile(join(commandsDir, "start.md"), startTemplate);
 	console.log("✓ Installed .claude/commands/start.md (/start command)");
 
 	const prTemplate = await readFile(
 		join(ATTRIBUTION_ROOT, "src", "setup", "templates", "pr-command.md"),
 		"utf8",
 	);
-	const prContent = prTemplate.replace(/\{\{CLI_BIN\}\}/g, () => CLI_BIN);
-	await writeFile(join(commandsDir, "pr.md"), prContent);
+	await writeFile(join(commandsDir, "pr.md"), prTemplate);
 	console.log("✓ Installed .claude/commands/pr.md (/pr command)");
 
 	console.log("\nDone! claude-attribution is active for this repo.");

package/src/setup/templates/hooks.json

@@ -5,7 +5,7 @@
 			"hooks": [
 				{
 					"type": "command",
-					"command": "\"{{CLI_BIN}}\" hook pre-tool-use"
+					"command": "claude-attribution hook pre-tool-use"
 				}
 			]
 		}
@@ -16,7 +16,7 @@
 			"hooks": [
 				{
 					"type": "command",
-					"command": "\"{{CLI_BIN}}\" hook post-tool-use"
+					"command": "claude-attribution hook post-tool-use"
 				}
 			]
 		}
@@ -27,7 +27,7 @@
 			"hooks": [
 				{
 					"type": "command",
-					"command": "\"{{CLI_BIN}}\" hook subagent"
+					"command": "claude-attribution hook subagent"
 				}
 			]
 		}
@@ -38,7 +38,7 @@
 			"hooks": [
 				{
 					"type": "command",
-					"command": "\"{{CLI_BIN}}\" hook subagent"
+					"command": "claude-attribution hook subagent"
 				}
 			]
 		}
@@ -49,7 +49,7 @@
 			"hooks": [
 				{
 					"type": "command",
-					"command": "\"{{CLI_BIN}}\" hook stop"
+					"command": "claude-attribution hook stop"
 				}
 			]
 		}

package/src/setup/templates/metrics-command.md

@@ -7,7 +7,7 @@ Generate session metrics for PR documentation.
 Run the metrics calculator:
 
 ```bash
-"{{CLI_BIN}}" metrics
+claude-attribution metrics
 ```
 
 This outputs PR-ready markdown covering:
@@ -21,7 +21,7 @@ This outputs PR-ready markdown covering:
 To run with a specific session ID:
 
 ```bash
-"{{CLI_BIN}}" metrics <session-id>
+claude-attribution metrics <session-id>
 ```
 
 Session IDs are in `.claude/logs/tool-usage.jsonl`.

package/src/setup/templates/post-commit.sh

@@ -1,4 +1,4 @@
 #!/bin/sh
 # Auto-installed by claude-attribution
 # Runs attribution analysis after each git commit
-"{{CLI_BIN}}" hook post-commit || true
+claude-attribution hook post-commit || true

package/src/setup/templates/pr-command.md

@@ -5,7 +5,7 @@ Run this when you're ready to open a pull request. Collects AI metrics and creat
 ## Instructions
 
 ```bash
-"{{CLI_BIN}}" pr "feat: your PR title"
+claude-attribution pr "feat: your PR title"
 ```
 
 This will:
@@ -17,9 +17,9 @@ This will:
 ## Options
 
 ```bash
-"{{CLI_BIN}}" pr "feat: title" --draft          # Open as draft PR
-"{{CLI_BIN}}" pr "feat: title" --base develop   # Target a different base branch
-"{{CLI_BIN}}" pr                                # Title derived from branch name
+claude-attribution pr "feat: title" --draft          # Open as draft PR
+claude-attribution pr "feat: title" --base develop   # Target a different base branch
+claude-attribution pr                                # Title derived from branch name
 ```
 
 ## Requirements

package/src/setup/templates/pre-push.sh

@@ -1,4 +1,4 @@
 #!/bin/sh
 # Auto-installed by claude-attribution
 # Pushes attribution git notes to origin so GitHub Actions can read them
-"{{CLI_BIN}}" hook pre-push || true
+claude-attribution hook pre-push || true

package/src/setup/templates/start-command.md

@@ -6,7 +6,7 @@ Records a start timestamp so /metrics only counts activity from this point forwa
 ## Instructions
 
 ```bash
-"{{CLI_BIN}}" start
+claude-attribution start
 ```
 
 This writes a marker to `.claude/attribution-state/session-start` with the current