@blogic-cz/agent-tools 0.14.37 → 0.14.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.14.37",
+  "version": "0.14.38",
   "description": "CLI tools for AI coding agent workflows — GitHub, database, Kubernetes, Azure DevOps, logs, sessions, and audit",
   "keywords": [
     "agent",

package/schemas/agent-tools.schema.json

@@ -95,6 +95,29 @@
         "repo": {
           "type": "string",
           "description": "Repository name."
+        },
+        "prTitle": {
+          "$ref": "#/definitions/GitHubPrTitlePolicy"
+        }
+      }
+    },
+    "GitHubPrTitlePolicy": {
+      "description": "Optional pull request title validation policy for this repository profile.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pattern", "expected"],
+      "properties": {
+        "pattern": {
+          "type": "string",
+          "description": "JavaScript regular expression source that valid PR titles must match."
+        },
+        "expected": {
+          "type": "string",
+          "description": "Human-readable required title format shown when validation fails."
+        },
+        "example": {
+          "type": "string",
+          "description": "Example valid title shown when validation fails."
         }
       }
     },

package/src/config/index.ts

@@ -11,6 +11,7 @@ export type {
   AuditConfig,
   CliToolOverride,
   CredentialGuardConfig,
+  GitHubPrTitlePolicy,
   GitHubRepoConfig,
 } from "./types";
 

package/src/config/loader.ts

@@ -141,6 +141,13 @@ const AuditConfigSchema = Schema.Struct({
 const GitHubRepoConfigSchema = Schema.Struct({
   owner: Schema.String,
   repo: Schema.String,
+  prTitle: Schema.optionalKey(
+    Schema.Struct({
+      pattern: Schema.String,
+      expected: Schema.String,
+      example: Schema.optionalKey(Schema.String),
+    }),
+  ),
 });
 
 const KNOWN_TOP_LEVEL_KEYS = new Set([

package/src/config/types.ts

@@ -154,9 +154,16 @@ export type AuditConfig = {
 };
 
 /** Single GitHub repository configuration */
+export type GitHubPrTitlePolicy = {
+  pattern: string;
+  expected: string;
+  example?: string;
+};
+
 export type GitHubRepoConfig = {
   owner: string;
   repo: string;
+  prTitle?: GitHubPrTitlePolicy;
 };
 
 /**

package/src/gh-tool/pr/core.ts

@@ -21,6 +21,45 @@ import { runLocalCommand } from "./helpers";
 const CHECK_JSON_FIELDS = "name,state,bucket,link";
 const GITHUB_ACTIONS_RUN_ID_RE = /github\.com\/[^/]+\/[^/]+\/actions\/runs\/(\d+)/;
 
+const validatePRTitle = Effect.fn("pr.validatePRTitle")(function* (title: string) {
+  const gh = yield* GitHubService;
+  const repoConfig = yield* gh.getRepoConfig();
+  const policy = repoConfig?.prTitle;
+
+  if (!policy) {
+    return;
+  }
+
+  const pattern = yield* Effect.try({
+    try: () => new RegExp(policy.pattern),
+    catch: (error) =>
+      new GitHubCommandError({
+        command: "pr title validation",
+        exitCode: 1,
+        stderr: `Invalid PR title policy regex: ${error instanceof Error ? error.message : String(error)}`,
+        message: "Invalid PR title policy regex",
+      }),
+  });
+
+  if (pattern.test(title)) {
+    return;
+  }
+
+  const lines = [
+    "PR title does not match the required format.",
+    `Got: ${title}`,
+    `Expected: ${policy.expected}`,
+    ...(policy.example ? [`Example: ${policy.example}`] : []),
+  ];
+
+  return yield* new GitHubCommandError({
+    command: "pr title validation",
+    exitCode: 1,
+    stderr: lines.join("\n"),
+    message: lines[0] ?? "PR title does not match the required format.",
+  });
+});
+
 type WorkflowRunJobsForRerun = {
   databaseId: number;
   jobs: Array<{
@@ -422,6 +461,7 @@ export const createPR = Effect.fn("pr.createPR")(function* (opts: {
   head: string | null;
 }) {
   const gh = yield* GitHubService;
+  yield* validatePRTitle(opts.title);
 
   // When --head is provided (e.g. GitButler workspace), use `gh pr list --head`
   // to find existing PR since `gh pr view` relies on the current git branch.
@@ -719,6 +759,10 @@ export const editPR = Effect.fn("pr.editPR")(function* (opts: {
   }
 
   const gh = yield* GitHubService;
+  if (opts.title !== null) {
+    yield* validatePRTitle(opts.title);
+  }
+
   const repo = yield* gh.getRepoInfo();
 
   const editArgs = [

package/src/gh-tool/service.ts

@@ -1,11 +1,12 @@
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
 import { Context, Effect, Layer, Stream } from "effect";
 
+import type { GitHubRepoConfig } from "#config";
 import type { RepoInfo } from "./types";
 
 import { GH_BINARY } from "./config";
 import { GitHubAuthError, GitHubCommandError, GitHubNotFoundError } from "./errors";
-import { ConfigService, resolveGitHubRepoTarget } from "#config";
+import { ConfigService, getGitHubConfig, resolveGitHubRepoTarget } from "#config";
 
 type GhResult = {
   stdout: string;
@@ -24,6 +25,7 @@ export class GitHubService extends Context.Service<
       query: string,
       variables: Record<string, string | number | null>,
     ) => Effect.Effect<unknown, GhError>;
+    readonly getRepoConfig: () => Effect.Effect<GitHubRepoConfig | undefined, never>;
     readonly getRepoInfo: () => Effect.Effect<RepoInfo, GhError>;
     readonly withRepoTarget: <A, E, R>(
       target: string | null,
@@ -76,6 +78,22 @@ export class GitHubService extends Context.Service<
             return yield* effect.pipe(Effect.provideService(RepoTarget, resolved));
           });
 
+        const getRepoConfig = Effect.fn("GitHubService.getRepoConfig")(function* () {
+          const ghRepo = yield* RepoTarget;
+          const repos = config?.github;
+
+          if (repos && ghRepo) {
+            const repoConfig = Object.values(repos).find(
+              (repo) => `${repo.owner}/${repo.repo}` === ghRepo,
+            );
+            if (repoConfig) {
+              return repoConfig;
+            }
+          }
+
+          return getGitHubConfig(config);
+        });
+
         const executeGh = (args: string[]) =>
           Effect.scoped(
             Effect.gen(function* () {
@@ -242,7 +260,7 @@ export class GitHubService extends Context.Service<
           return repoInfo;
         });
 
-        return { runGh, runGhJson, runGraphQL, getRepoInfo, withRepoTarget };
+        return { runGh, runGhJson, runGraphQL, getRepoConfig, getRepoInfo, withRepoTarget };
       }),
     ),
   );