@blogic-cz/agent-tools 0.8.18 → 0.10.0

package/package.json

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

package/src/gh-tool/branch.ts

@@ -0,0 +1,91 @@
+import { Command, Flag } from "effect/unstable/cli";
+import { Effect, Option } from "effect";
+
+import { formatOption, logFormatted } from "#shared";
+import type { BranchRenameResult } from "./types";
+import { GitHubService } from "./service";
+
+// ---------------------------------------------------------------------------
+// Internal handlers
+// ---------------------------------------------------------------------------
+
+export const renameBranch = Effect.fn("branch.renameBranch")(function* (opts: {
+  oldName: string;
+  newName: string;
+  confirm: boolean;
+  repo: string | null;
+}) {
+  const gh = yield* GitHubService;
+
+  if (!opts.confirm) {
+    const scope = opts.repo !== null ? ` in ${opts.repo}` : "";
+
+    const dryRun: BranchRenameResult = {
+      renamed: false,
+      oldName: opts.oldName,
+      newName: opts.newName,
+      dryRun: true,
+      message: `Dry run: would rename branch '${opts.oldName}' to '${opts.newName}'${scope}. Re-run with --confirm to execute.`,
+    };
+
+    return dryRun;
+  }
+
+  const repoInfo =
+    opts.repo !== null
+      ? opts.repo
+      : yield* gh.getRepoInfo().pipe(Effect.map((r) => `${r.owner}/${r.name}`));
+
+  const args = [
+    "api",
+    `repos/${repoInfo}/branches/${encodeURIComponent(opts.oldName)}/rename`,
+    "-X",
+    "POST",
+    "-f",
+    `new_name=${opts.newName}`,
+  ];
+
+  yield* gh.runGh(args);
+
+  const result: BranchRenameResult = {
+    renamed: true,
+    oldName: opts.oldName,
+    newName: opts.newName,
+  };
+
+  return result;
+});
+
+// ---------------------------------------------------------------------------
+// CLI Commands
+// ---------------------------------------------------------------------------
+
+export const branchRenameCommand = Command.make(
+  "rename",
+  {
+    confirm: Flag.boolean("confirm").pipe(
+      Flag.withDescription("Actually rename (without this flag, only shows dry-run)"),
+      Flag.withDefault(false),
+    ),
+    format: formatOption,
+    newName: Flag.string("new-name").pipe(Flag.withDescription("New branch name")),
+    oldName: Flag.string("old-name").pipe(Flag.withDescription("Current branch name to rename")),
+    repo: Flag.string("repo").pipe(
+      Flag.withDescription("Target repository (owner/name). Defaults to current repo"),
+      Flag.optional,
+    ),
+  },
+  ({ confirm, format, newName, oldName, repo }) =>
+    Effect.gen(function* () {
+      const result = yield* renameBranch({
+        oldName,
+        newName,
+        confirm,
+        repo: Option.getOrNull(repo),
+      });
+
+      yield* logFormatted(result, format);
+    }),
+).pipe(
+  Command.withDescription("Rename a GitHub branch (dry-run by default, use --confirm to execute)"),
+);

package/src/gh-tool/index.ts

@@ -20,6 +20,7 @@ import {
   prViewCommand,
   prStatusCommand,
   prCreateCommand,
+  prCloseCommand,
   prEditCommand,
   prMergeCommand,
   prThreadsCommand,
@@ -37,6 +38,7 @@ import {
   prReplyAndResolveCommand,
   prReviewTriageCommand,
 } from "./pr/index";
+import { branchRenameCommand } from "./branch";
 import {
   releaseCreateCommand,
   releaseDeleteCommand,
@@ -65,6 +67,7 @@ const prCommand = Command.make("pr", {}).pipe(
     prViewCommand,
     prStatusCommand,
     prCreateCommand,
+    prCloseCommand,
     prEditCommand,
     prMergeCommand,
     prThreadsCommand,
@@ -100,6 +103,11 @@ const issueCommand = Command.make("issue", {}).pipe(
   ]),
 );
 
+const branchCommand = Command.make("branch", {}).pipe(
+  Command.withDescription("Branch operations (rename)"),
+  Command.withSubcommands([branchRenameCommand]),
+);
+
 const repoCommand = Command.make("repo", {}).pipe(
   Command.withDescription("Repository operations"),
   Command.withSubcommands([repoInfoCommand, repoListCommand, repoSearchCodeCommand]),
@@ -162,9 +170,17 @@ WORKFLOW FOR AI AGENTS:
   18. Use 'workflow watch --run N' to watch until completion
   19. Use 'release status' to inspect latest release + repository context
   20. Use 'release create --tag vX.Y.Z --generate-notes' to publish a release
-  21. Use 'release edit/view/list/delete' to maintain existing releases`,
+  21. Use 'release edit/view/list/delete' to maintain existing releases
+  22. Use 'branch rename --old-name X --new-name Y --confirm' to rename a branch`,
   ),
-  Command.withSubcommands([prCommand, issueCommand, repoCommand, workflowCommand, releaseCommand]),
+  Command.withSubcommands([
+    prCommand,
+    issueCommand,
+    repoCommand,
+    branchCommand,
+    workflowCommand,
+    releaseCommand,
+  ]),
 );
 
 const cli = Command.run(mainCommand, {

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

@@ -17,6 +17,7 @@ import {
 } from "#gh/config";
 
 import {
+  closePR,
   createPR,
   detectPRStatus,
   editPR,
@@ -147,6 +148,44 @@ export const prEditCommand = Command.make(
     }),
 ).pipe(Command.withDescription("Edit an existing PR's title, body, or other metadata"));
 
+export const prCloseCommand = Command.make(
+  "close",
+  {
+    comment: Flag.string("comment").pipe(
+      Flag.withDescription("Comment to add when closing"),
+      Flag.optional,
+    ),
+    commentFile: Flag.string("comment-file").pipe(
+      Flag.withDescription("Read close comment from a file path or '-' for stdin"),
+      Flag.optional,
+    ),
+    deleteBranch: Flag.boolean("delete-branch").pipe(
+      Flag.withDescription("Delete the branch after closing"),
+      Flag.withDefault(false),
+    ),
+    format: formatOption,
+    pr: Flag.integer("pr").pipe(Flag.withDescription("PR number to close")),
+  },
+  ({ comment, commentFile, deleteBranch, format, pr }) =>
+    Effect.gen(function* () {
+      const resolvedComment = yield* resolveOptionalTextInput(
+        "gh-tool pr close",
+        Option.getOrNull(comment),
+        Option.getOrNull(commentFile),
+        "--comment",
+        "--comment-file",
+        "comment",
+      );
+
+      const result = yield* closePR({
+        comment: resolvedComment,
+        deleteBranch,
+        pr,
+      });
+      yield* logFormatted(result, format);
+    }),
+).pipe(Command.withDescription("Close a PR with optional comment and branch deletion"));
+
 export const prMergeCommand = Command.make(
   "merge",
   {

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

@@ -606,6 +606,28 @@ export const mergePR = Effect.fn("pr.mergePR")(function* (opts: {
   return result;
 });
 
+export const closePR = Effect.fn("pr.closePR")(function* (opts: {
+  pr: number;
+  comment: string | null;
+  deleteBranch: boolean;
+}) {
+  const gh = yield* GitHubService;
+
+  const args = ["pr", "close", String(opts.pr)];
+
+  if (opts.comment !== null) {
+    args.push("--comment", opts.comment);
+  }
+
+  if (opts.deleteBranch) {
+    args.push("--delete-branch");
+  }
+
+  yield* gh.runGh(args);
+
+  return yield* viewPR(opts.pr);
+});
+
 export const editPR = Effect.fn("pr.editPR")(function* (opts: {
   pr: number;
   title: string | null;

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

@@ -1,6 +1,7 @@
 export {
   prChecksCommand,
   prChecksFailedCommand,
+  prCloseCommand,
   prCommentCommand,
   prCommentsCommand,
   prCreateCommand,

package/src/gh-tool/types.ts

@@ -159,6 +159,14 @@ export type PRStatusNone = {
 
 export type PRStatusResult = PRStatusSingle | PRStatusMultiple | PRStatusNone;
 
+export type BranchRenameResult = {
+  renamed: boolean;
+  oldName: string;
+  newName: string;
+  dryRun?: true;
+  message?: string;
+};
+
 export type CheckRunAnnotation = {
   path: string;
   start_line: number;