opencode-kolchoz-loop 1.0.4 → 1.3.0

package/README.md

@@ -136,6 +136,14 @@ Agents use `claude-sonnet-4` by default. Override in `opencode.json`:
 
 Recommendation: Anetka and Areczek should use different models. Cross-model review reduces shared blind spots.
 
+## Commit gate
+
+Before Areczek can submit a story for review, `kolchoz_submit_for_review` validates Git:
+- no uncommitted changes in the working tree
+- latest commit message starts with `feat(<storyId>):`
+
+If either check fails, submission is blocked until Areczek creates the correct commit.
+
 ## Compound engineering
 
 The system builds knowledge in `AGENTS.md` automatically:
@@ -144,6 +152,28 @@ The system builds knowledge in `AGENTS.md` automatically:
 2. Anetka discovers a gotcha -> `kolchoz_learn("gotcha", "...")`
 3. Future sessions read AGENTS.md -> better context -> better outcomes
 
+## Release automation
+
+This repository includes GitHub Actions workflows for a release cycle:
+
+1. Run `Prepare Release Draft` manually from GitHub Actions on `main` or `master`.
+2. Choose `RELEASE_TYPE`: `major`, `minor`, or `patch`.
+3. Workflow bumps `package.json` version, commits it, creates a tag, and opens a draft release.
+4. Publish the draft release in GitHub Releases.
+5. Publishing the release triggers npm publishing from the release tag.
+
+Workflow files:
+- `.github/workflows/prepare-release.yml`
+- `.github/workflows/publish-on-release.yml`
+
+Required npm setup:
+- Configure npm Trusted Publisher for this GitHub repository and workflow file `publish-on-release.yml`.
+- Trusted publishing uses GitHub OIDC, so `NPM_TOKEN` is not required for package publishing.
+
+Important:
+- `Prepare Release Draft` guarantees matching `tag` and `package.json` version.
+- If branch protection blocks direct pushes by Actions, allow `GITHUB_TOKEN` pushes for this workflow.
+
 ## License
 
 MIT

package/dist/agents/agents/areczek.md

@@ -41,6 +41,9 @@ Use these capabilities consistently:
 - Commit format: `feat(story-id): short description`
 - Always inspect `git diff` before committing
 - If something goes wrong: `git stash` or `git reset`
+- `kolchoz_submit_for_review` is hard-gated by Git checks:
+  - working tree must be clean (no pending changes)
+  - latest commit message must match current story: `feat(<storyId>): ...`
 
 ### Tests
 - Run existing tests after changes: `npm test` / `bun test` / equivalent

package/dist/agents/anetka.md

@@ -1,7 +1,6 @@
 ---
 description: "Code reviewer and quality gate. Reviews Areczek's work: tests, linting, typecheck, and diff review. Decides pass/fail."
 mode: subagent
-model: anthropic/claude-sonnet-4-20250514
 temperature: 0.1
 color: "#f43f5e"
 tools:

package/dist/agents/areczek.md

@@ -1,7 +1,6 @@
 ---
 description: "Lead implementer. Writes code, runs tests, commits changes. Has full access to tools, browser MCP, and Git. Executes PRD user stories."
 mode: subagent
-model: anthropic/claude-sonnet-4-20250514
 temperature: 0.1
 color: "#22d3ee"
 steps: 50
@@ -42,6 +41,9 @@ Use these capabilities consistently:
 - Commit format: `feat(story-id): short description`
 - Always inspect `git diff` before committing
 - If something goes wrong: `git stash` or `git reset`
+- `kolchoz_submit_for_review` is hard-gated by Git checks:
+  - working tree must be clean (no pending changes)
+  - latest commit message must match current story: `feat(<storyId>): ...`
 
 ### Tests
 - Run existing tests after changes: `npm test` / `bun test` / equivalent

package/dist/agents/grazynka.md

@@ -1,7 +1,6 @@
 ---
 description: "Requirements analyst. Clarifies requests from Januszek, analyzes the codebase, and creates a structured PRD with user stories and acceptance criteria."
 mode: subagent
-model: anthropic/claude-sonnet-4-20250514
 temperature: 0.2
 color: "#a855f7"
 tools:

package/dist/agents/januszek.md

@@ -1,7 +1,6 @@
 ---
 description: "Main Kolchoz Loop orchestrator. Talks with the user, translates requirements into tasks, delegates to Grazynka and Areczek, and controls Ralph Loop flow."
 mode: primary
-model: anthropic/claude-sonnet-4-20250514
 temperature: 0.3
 color: "#ff6b35"
 tools:

package/dist/index.js

@@ -2,6 +2,9 @@ import { tool } from "@opencode-ai/plugin/tool";
 import { readFile, writeFile, mkdir, readdir, copyFile, stat } from "fs/promises";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
 // ── Filesystem helpers ──
 async function ensureDir(dir) {
     await mkdir(dir, { recursive: true });
@@ -41,6 +44,30 @@ async function appendProgress(dir, message) {
         await writeFile(file, line, "utf-8");
     }
 }
+async function runGit(projectRoot, args) {
+    const { stdout } = await execFileAsync("git", args, { cwd: projectRoot });
+    return stdout.trim();
+}
+async function validateStoryCommit(projectRoot, storyId) {
+    try {
+        await runGit(projectRoot, ["rev-parse", "--is-inside-work-tree"]);
+    }
+    catch {
+        return "ERROR: Git repository not found. Commit is required before review.";
+    }
+    const status = await runGit(projectRoot, ["status", "--porcelain"]);
+    if (status.length > 0) {
+        return (`ERROR: Uncommitted changes detected. Commit all changes for ${storyId} before review.\n` +
+            `Hint: git add -A && git commit -m "feat(${storyId}): short description"`);
+    }
+    const lastCommitMessage = await runGit(projectRoot, ["log", "-1", "--pretty=%s"]);
+    const requiredPrefix = `feat(${storyId}):`;
+    if (!lastCommitMessage.startsWith(requiredPrefix)) {
+        return (`ERROR: Last commit message must start with "${requiredPrefix}".\n` +
+            `Current: "${lastCommitMessage}"`);
+    }
+    return null;
+}
 // ── Agent provisioning ──
 // Copies bundled .md agent files to .opencode/agents/
 // so OpenCode discovers them as real agents.
@@ -121,16 +148,29 @@ export const KolchozLoop = async ({ project, client, $, directory, worktree }) =
                     stories: tool.schema.string(), // JSON array
                 },
                 async execute(args) {
-                    const stories = JSON.parse(args.stories).map((s, i) => ({
-                        id: s.id || `story-${i + 1}`,
-                        title: s.title || `Story ${i + 1}`,
-                        description: s.description || "",
-                        acceptanceCriteria: s.acceptanceCriteria || [],
-                        priority: s.priority || "medium",
-                        status: "pending",
-                        assignedTo: "areczek",
-                        iteration: 0,
-                    }));
+                    let parsed;
+                    try {
+                        const raw = JSON.parse(args.stories);
+                        if (!Array.isArray(raw))
+                            throw new Error("stories must be a JSON array");
+                        parsed = raw;
+                    }
+                    catch (err) {
+                        return `ERROR: Invalid stories JSON — ${err instanceof Error ? err.message : String(err)}`;
+                    }
+                    const stories = parsed.map((value, i) => {
+                        const s = value;
+                        return {
+                            id: s.id || `story-${i + 1}`,
+                            title: s.title || `Story ${i + 1}`,
+                            description: s.description || "",
+                            acceptanceCriteria: s.acceptanceCriteria || [],
+                            priority: s.priority || "medium",
+                            status: "pending",
+                            assignedTo: "areczek",
+                            iteration: 0,
+                        };
+                    });
                     const prd = {
                         title: args.title,
                         createdBy: "grazynka",
@@ -202,6 +242,11 @@ export const KolchozLoop = async ({ project, client, $, directory, worktree }) =
                     const story = prd.userStories.find((s) => s.id === args.storyId);
                     if (!story)
                         return `ERROR: Story ${args.storyId} not found.`;
+                    const commitValidationError = await validateStoryCommit(projectRoot, args.storyId);
+                    if (commitValidationError) {
+                        await appendProgress(stateDir, `[Areczek] Submission blocked for ${args.storyId}: missing/invalid commit`);
+                        return commitValidationError;
+                    }
                     story.status = "review";
                     await writeJson(stateDir, "prd.json", prd);
                     const state = await readJson(stateDir, "loop-state.json", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-kolchoz-loop",
-  "version": "1.0.4",
+  "version": "1.3.0",
   "description": "Multi-agent Ralph Loop plugin for OpenCode - Januszek, Grazynka, Areczek, Anetka",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,11 +27,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "latest"
+    "@opencode-ai/plugin": "^1.2.7"
   },
   "devDependencies": {
-    "@types/node": "latest",
-    "typescript": "latest"
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
   },
   "files": [
     "dist/**/*",

package/src/agents/areczek.md

@@ -41,6 +41,9 @@ Use these capabilities consistently:
 - Commit format: `feat(story-id): short description`
 - Always inspect `git diff` before committing
 - If something goes wrong: `git stash` or `git reset`
+- `kolchoz_submit_for_review` is hard-gated by Git checks:
+  - working tree must be clean (no pending changes)
+  - latest commit message must match current story: `feat(<storyId>): ...`
 
 ### Tests
 - Run existing tests after changes: `npm test` / `bun test` / equivalent