@elyracode/git-intel 0.5.2

package/README.md

@@ -0,0 +1,36 @@
+# @elyracode/git-intel
+
+Git intelligence for Elyra -- session briefings, commit messages, and PR descriptions.
+
+## Install
+
+```
+elyra install npm:@elyracode/git-intel
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `git_briefing` | Summary of recent commits, changed files, branches, and working tree status |
+| `generate_commit_message` | Analyze staged diff and suggest a conventional commit message |
+| `generate_pr_description` | Analyze branch diff and generate a PR description with what/why/test/checklist |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/briefing` | What changed since your last session? |
+| `/commit` | Generate a commit message from staged changes |
+| `/pr` | Generate a PR description for the current branch |
+
+## Usage
+
+```
+> What changed in this repo since yesterday?
+> Generate a commit message for my staged changes
+> Write a PR description for this branch
+/briefing
+/commit
+/pr
+```

package/extensions/index.ts

@@ -0,0 +1,284 @@
+import { execSync } from "node:child_process";
+import type { ExtensionAPI } from "@elyracode/coding-agent";
+import { Type } from "typebox";
+
+export default function (elyra: ExtensionAPI): void {
+
+	// ── Tool: git_briefing ──
+	elyra.registerTool({
+		name: "git_briefing",
+		label: "Git Briefing",
+		description:
+			"Get a summary of what happened in the git repository since a given time or number of commits. " +
+			"Shows: recent commits by others, files you worked on that changed, branches, and potential conflicts. " +
+			"Use this at the start of a session to understand what changed.",
+		parameters: Type.Object({
+			since: Type.Optional(
+				Type.String({ description: "Time period (e.g., '24 hours ago', 'yesterday', '3 days ago'). Default: '24 hours ago'" }),
+			),
+		}),
+		execute: async (_toolCallId, params) => {
+			try {
+				const cwd = process.cwd();
+				const since = params.since ?? "24 hours ago";
+
+				const lines: string[] = ["# Git Briefing", ""];
+
+				// Current branch
+				const branch = git(cwd, "rev-parse --abbrev-ref HEAD");
+				lines.push(`**Branch**: ${branch}`);
+
+				// Recent commits
+				const commits = git(cwd, `log --oneline --since="${since}" --no-merges`);
+				const commitLines = commits.split("\n").filter((l) => l.trim());
+				lines.push(`**Commits since ${since}**: ${commitLines.length}`, "");
+
+				if (commitLines.length > 0) {
+					lines.push("## Recent Commits");
+					for (const line of commitLines.slice(0, 20)) {
+						lines.push(`- ${line}`);
+					}
+					if (commitLines.length > 20) {
+						lines.push(`- ... and ${commitLines.length - 20} more`);
+					}
+					lines.push("");
+				}
+
+				// Authors
+				const authors = git(cwd, `log --format="%an" --since="${since}" --no-merges`);
+				const authorSet = new Set(authors.split("\n").filter((l) => l.trim()));
+				if (authorSet.size > 0) {
+					lines.push(`**Contributors**: ${[...authorSet].join(", ")}`, "");
+				}
+
+				// Changed files
+				const changedFiles = git(cwd, `diff --name-only HEAD~${Math.min(commitLines.length, 50)}..HEAD 2>/dev/null || echo ""`);
+				const fileList = changedFiles.split("\n").filter((l) => l.trim());
+				if (fileList.length > 0) {
+					lines.push(`## Changed Files (${fileList.length})`);
+					for (const file of fileList.slice(0, 30)) {
+						lines.push(`- ${file}`);
+					}
+					if (fileList.length > 30) {
+						lines.push(`- ... and ${fileList.length - 30} more`);
+					}
+					lines.push("");
+				}
+
+				// Uncommitted changes
+				const status = git(cwd, "status --porcelain");
+				const statusLines = status.split("\n").filter((l) => l.trim());
+				if (statusLines.length > 0) {
+					const modified = statusLines.filter((l) => !l.startsWith("??")).length;
+					const untracked = statusLines.filter((l) => l.startsWith("??")).length;
+					lines.push("## Working Tree");
+					if (modified > 0) lines.push(`- ${modified} modified/staged file${modified > 1 ? "s" : ""}`);
+					if (untracked > 0) lines.push(`- ${untracked} untracked file${untracked > 1 ? "s" : ""}`);
+					lines.push("");
+				}
+
+				// Branches with recent activity
+				const branches = git(cwd, "branch -a --sort=-committerdate --format='%(refname:short) %(committerdate:relative)'");
+				const branchLines = branches.split("\n").filter((l) => l.trim()).slice(0, 10);
+				if (branchLines.length > 1) {
+					lines.push("## Active Branches");
+					for (const b of branchLines) {
+						lines.push(`- ${b}`);
+					}
+					lines.push("");
+				}
+
+				return {
+					content: [{ type: "text", text: lines.join("\n") }],
+					details: { commits: commitLines.length, files: fileList.length },
+				};
+			} catch (error) {
+				const msg = error instanceof Error ? error.message : String(error);
+				return {
+					content: [{ type: "text", text: `Git briefing failed: ${msg}` }],
+					details: {},
+				};
+			}
+		},
+	});
+
+	// ── Tool: generate_commit_message ──
+	elyra.registerTool({
+		name: "generate_commit_message",
+		label: "Generate Commit Message",
+		description:
+			"Analyze staged git changes and generate a conventional commit message. " +
+			"Returns the diff summary and a suggested commit message following the format: " +
+			"type(scope): description. Use this when the user wants to commit changes.",
+		parameters: Type.Object({
+			include_body: Type.Optional(
+				Type.Boolean({ description: "Include detailed body in the commit message (default: false)" }),
+			),
+		}),
+		execute: async (_toolCallId, params) => {
+			try {
+				const cwd = process.cwd();
+
+				// Get staged diff
+				let diff = git(cwd, "diff --cached --stat");
+				if (!diff.trim()) {
+					// Nothing staged, show unstaged
+					diff = git(cwd, "diff --stat");
+					if (!diff.trim()) {
+						return {
+							content: [{ type: "text", text: "No changes to commit (nothing staged or modified)." }],
+							details: {},
+						};
+					}
+					return {
+						content: [{
+							type: "text",
+							text: `No staged changes. Stage files first with \`git add\`.\n\nUnstaged changes:\n${diff}`,
+						}],
+						details: {},
+					};
+				}
+
+				const diffContent = git(cwd, "diff --cached");
+				const truncatedDiff = diffContent.length > 30000
+					? `${diffContent.slice(0, 30000)}\n\n... (truncated)`
+					: diffContent;
+
+				const lines: string[] = [
+					"# Staged Changes",
+					"",
+					"## Summary",
+					diff,
+					"",
+					"## Diff",
+					"```",
+					truncatedDiff,
+					"```",
+					"",
+					"Generate a conventional commit message for these changes.",
+					"Format: type(scope): short description",
+					"",
+					"Types: feat, fix, chore, docs, refactor, test, style, perf",
+					"Scope: the package or area affected",
+					params.include_body
+						? "Include a body explaining what and why (not how)."
+						: "Keep it to a single line.",
+				];
+
+				return {
+					content: [{ type: "text", text: lines.join("\n") }],
+					details: {},
+				};
+			} catch (error) {
+				const msg = error instanceof Error ? error.message : String(error);
+				return {
+					content: [{ type: "text", text: `Commit message generation failed: ${msg}` }],
+					details: {},
+				};
+			}
+		},
+	});
+
+	// ── Tool: generate_pr_description ──
+	elyra.registerTool({
+		name: "generate_pr_description",
+		label: "Generate PR Description",
+		description:
+			"Analyze the current branch diff against main/master and generate a PR description. " +
+			"Includes: what changed, why, how to test, and a checklist. " +
+			"Use this before creating a pull request.",
+		parameters: Type.Object({
+			base: Type.Optional(
+				Type.String({ description: "Base branch to compare against (default: auto-detect main or master)" }),
+			),
+		}),
+		execute: async (_toolCallId, params) => {
+			try {
+				const cwd = process.cwd();
+
+				// Detect base branch
+				let base = params.base;
+				if (!base) {
+					try {
+						git(cwd, "rev-parse --verify main");
+						base = "main";
+					} catch {
+						base = "master";
+					}
+				}
+
+				const currentBranch = git(cwd, "rev-parse --abbrev-ref HEAD");
+				const commits = git(cwd, `log --oneline ${base}..HEAD`);
+				const diffStat = git(cwd, `diff --stat ${base}..HEAD`);
+				const diff = git(cwd, `diff ${base}..HEAD`);
+
+				const truncatedDiff = diff.length > 50000
+					? `${diff.slice(0, 50000)}\n\n... (truncated)`
+					: diff;
+
+				const lines: string[] = [
+					`# PR: ${currentBranch} -> ${base}`,
+					"",
+					"## Commits",
+					commits,
+					"",
+					"## Files Changed",
+					diffStat,
+					"",
+					"## Diff",
+					"```",
+					truncatedDiff,
+					"```",
+					"",
+					"Generate a PR description with:",
+					"- **What**: summary of changes",
+					"- **Why**: motivation and context",
+					"- **How to test**: verification steps",
+					"- **Checklist**: [ ] tests, [ ] docs, [ ] breaking changes",
+				];
+
+				return {
+					content: [{ type: "text", text: lines.join("\n") }],
+					details: { branch: currentBranch, base, commitCount: commits.split("\n").filter((l) => l.trim()).length },
+				};
+			} catch (error) {
+				const msg = error instanceof Error ? error.message : String(error);
+				return {
+					content: [{ type: "text", text: `PR description generation failed: ${msg}` }],
+					details: {},
+				};
+			}
+		},
+	});
+
+	// ── Commands ──
+	elyra.registerCommand("briefing", {
+		description: "Get a git briefing -- what changed since your last session",
+		handler: async (_args, _ctx) => {
+			elyra.sendUserMessage("Give me a git briefing. What changed in this repository recently?");
+		},
+	});
+
+	elyra.registerCommand("commit", {
+		description: "Generate a commit message from staged changes",
+		handler: async (_args, _ctx) => {
+			elyra.sendUserMessage("Generate a conventional commit message for my staged changes.");
+		},
+	});
+
+	elyra.registerCommand("pr", {
+		description: "Generate a PR description from the current branch",
+		handler: async (_args, _ctx) => {
+			elyra.sendUserMessage("Generate a PR description for the current branch.");
+		},
+	});
+}
+
+function git(cwd: string, command: string): string {
+	return execSync(`git --no-pager ${command}`, {
+		cwd,
+		timeout: 15000,
+		encoding: "utf-8",
+		stdio: ["pipe", "pipe", "pipe"],
+	}).trim();
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@elyracode/git-intel",
+  "version": "0.5.2",
+  "description": "Elyra extension for Git intelligence -- session briefings, commit message generation, PR descriptions",
+  "type": "module",
+  "keywords": ["elyra-package", "git", "commit", "pr", "diff", "intelligence"],
+  "license": "MIT",
+  "author": "Knut W. Horne",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kwhorne/elyra.git",
+    "directory": "packages/git-intel"
+  },
+  "elyra": {
+    "extensions": ["./extensions/index.ts"]
+  },
+  "peerDependencies": {
+    "@elyracode/coding-agent": "*",
+    "typebox": "*"
+  },
+  "scripts": {
+    "clean": "echo 'nothing to clean'",
+    "build": "echo 'nothing to build'",
+    "check": "echo 'nothing to check'"
+  }
+}