@reachdevel/opencode-git-commit 0.0.0-stage → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Levent Kurt
+
+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

@@ -1,3 +1,88 @@
-# Temporary Holding Version
+# Git Autocommit Plugin for OpenCode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://badge.fury.io/js/@reachdevel%2Fopencode-git-commit.svg)](https://badge.fury.io/js/@reachdevel%2Fopencode-git-commit)
+
+An OpenCode plugin that automatically commits changes when your coding session becomes idle.
+
+Requires OpenCode v2 (uses the `@opencode/plugin` v2 plugin API).
+
+## What It Does
+
+This plugin monitors your OpenCode session and automatically creates git commits when:
+
+1. The session goes idle (no active operations)
+2. There are uncommitted changes in your working directory
+3. A git repository exists (or can be initialized)
+
+The commit message is intelligently extracted from the last assistant message in your conversation, making commits contextual and meaningful.
+
+## Features
+
+- **Automatic Commits** - Commits changes whenever your session becomes idle
+- **Smart Commit Messages** - Extracts context from your last conversation to create meaningful commit messages
+- **Auto-initialize** - Automatically initializes a git repository if one doesn't exist
+- **Respects .gitignore** - Git handles ignored files automatically
+- **Conventional Commits** - Uses `feat:` or `fix:` prefixes based on message content
+
+## Installation
+
+### Via Command Line
+```bash
+opencode plugin add @reachdevel/opencode-git-commit@latest
+```
+
+### Via Configuration
+Add to your `opencode.json`:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": [
+    "@reachdevel/opencode-git-commit@latest"
+  ]
+}
+```
+
+### Manual Installation
+```bash
+npm install @reachdevel/opencode-git-commit
+```
+
+Then add to `opencode.json`:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": [
+    "file:///path/to/node_modules/@reachdevel/opencode-git-commit/dist/index.js"
+  ]
+}
+```
+
+## How It Works
+
+1. When a `session.idle` event is triggered, the plugin checks for git changes
+2. If changes exist, it fetches the last assistant message from your session
+3. Extracts the first line, sanitizes it, and uses it as the commit message
+4. Stages all changes with `git add .`
+5. Commits with `--no-verify` to bypass hooks
+
+## Configuration
+
+The plugin works out of the box with no configuration needed. Just install and it will start auto-committing.
+
+To disable it for a project, remove its id from the plugin list:
+
+```json
+{
+  "plugins": ["*", "-git-autocommit"]
+}
+```
+
+## Requirements
+
+- OpenCode with plugin support
+- Node.js (for running the plugin)
+- Git installed on your system
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from "@opencode/plugin";
+declare const GitAutocommitPlugin: Plugin.Plugin;
+export { GitAutocommitPlugin };
+export default GitAutocommitPlugin;

package/dist/index.js

@@ -0,0 +1,103 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { Plugin } from "@opencode/plugin";
+const exec = promisify(execFile);
+const SERVICE = "git-autocommit";
+const TERMINAL = new Set([
+    "session.execution.succeeded",
+    "session.execution.failed",
+    "session.execution.interrupted",
+]);
+function isTerminal(event) {
+    return TERMINAL.has(event.type);
+}
+function log(level, message) {
+    const line = `[${SERVICE}] ${message}`;
+    if (level === "error")
+        console.error(line);
+    else
+        console.log(line);
+}
+async function git(cwd, args) {
+    const { stdout } = await exec("git", ["-C", cwd, ...args], { cwd });
+    return stdout;
+}
+async function isRepository(cwd) {
+    try {
+        await git(cwd, ["rev-parse", "--git-dir"]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function commitMessageFrom(messages) {
+    const assistant = [...messages].reverse().find((m) => m.type === "assistant");
+    const text = assistant?.content?.find((part) => part.type === "text")?.text;
+    if (!text)
+        return undefined;
+    const sanitized = text
+        .split("\n")[0]
+        .replace(/[^a-zA-Z0-9 ]/g, "")
+        .substring(0, 50)
+        .trim();
+    return sanitized || undefined;
+}
+function buildCommitMessage(text) {
+    const type = text.toLowerCase().includes("fix") ? "fix" : "feat";
+    return `${type}: ${text}`;
+}
+const GitAutocommitPlugin = Plugin.define({
+    id: "git-autocommit",
+    setup(ctx) {
+        log("info", `Plugin initialized for ${ctx.location.directory}`);
+        const controller = new AbortController();
+        const pending = new Map();
+        const run = (directory, sessionID) => {
+            const previous = pending.get(directory) ?? Promise.resolve();
+            const next = previous.then(async () => {
+                const cwd = directory;
+                // Initialize a repository if the location has none yet
+                if (!(await isRepository(cwd))) {
+                    await git(cwd, ["init"]);
+                    log("info", "Initialized git repository");
+                }
+                const status = await git(cwd, ["status", "--porcelain"]);
+                if (!status.trim()) {
+                    log("debug", "No changes detected");
+                    return;
+                }
+                const messages = await ctx.session.context({ sessionID });
+                const text = commitMessageFrom(messages) ?? "automated update";
+                const message = buildCommitMessage(text);
+                // Stage and commit (git respects .gitignore by default)
+                await git(cwd, ["add", "."]);
+                // Fall back to a bot identity only when the machine has no git identity configured
+                const identity = process.env.GIT_AUTHOR_EMAIL || (await git(cwd, ["config", "--get", "user.email"]).catch(() => ""))
+                    ? []
+                    : ["-c", "user.name=opencode", "-c", "user.email=opencode@localhost"];
+                await git(cwd, [...identity, "commit", "-m", message, "--no-verify"]);
+                log("info", `Committed: ${message}`);
+            });
+            const settled = next.catch((err) => {
+                const message = err instanceof Error ? err.message : String(err);
+                log("error", message);
+            });
+            pending.set(directory, settled);
+            return settled;
+        };
+        void (async () => {
+            for await (const event of ctx.event.subscribe({ signal: controller.signal })) {
+                // OpenCode v2 does not publish session.idle to plugins. The terminal
+                // execution events are what actually signal the session finished.
+                if (!isTerminal(event))
+                    continue;
+                log("debug", `Session finished (${event.type})`);
+                await run(ctx.location.directory, event.data.sessionID);
+            }
+        })();
+        return () => controller.abort();
+    },
+});
+export { GitAutocommitPlugin };
+export default GitAutocommitPlugin;

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@reachdevel/opencode-git-commit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.1",
+  "description": "Zero-config background git auto-commit plugin for OpenCode CLI",
+  "author": "Levent Kurt <reachdevel@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reachdevel/opencode-git-commit.git"
+  },
+  "homepage": "https://github.com/reachdevel/opencode-git-commit#readme",
+  "bugs": {
+    "url": "https://github.com/reachdevel/opencode-git-commit/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "git",
+    "autocommit",
+    "automation"
+  ],
+  "dependencies": {
+    "@opencode/plugin": "^2.0.31"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}