@blogic-cz/agent-tools 0.14.47 → 0.14.49

package/package.json

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

package/src/gh-tool/index.ts

@@ -33,6 +33,7 @@ import {
   prDiscussionSummaryCommand,
   prReplyCommand,
   prResolveCommand,
+  prReviewsCommand,
   prSubmitReviewCommand,
   prChecksCommand,
   prChecksFailedCommand,
@@ -61,6 +62,7 @@ import {
   workflowListCommand,
   workflowLogsCommand,
   workflowRerunCommand,
+  workflowRunCommand,
   workflowViewCommand,
   workflowWatchCommand,
 } from "./workflow";
@@ -78,6 +80,7 @@ const prCommand = Command.make("pr", {}).pipe(
     prWaitMergeableCommand,
     prThreadsCommand,
     prCommentsCommand,
+    prReviewsCommand,
     prIssueCommentsCommand,
     prIssueCommentsLatestCommand,
     prCommentCommand,
@@ -123,9 +126,10 @@ const repoCommand = Command.make("repo", {}).pipe(
 
 const workflowCommand = Command.make("workflow", {}).pipe(
   Command.withDescription(
-    "GitHub Actions workflow operations (list runs, view, jobs, logs, job-logs, annotations, rerun, cancel, watch)",
+    "GitHub Actions workflow operations (run, list, view, jobs, logs, job-logs, annotations, rerun, cancel, watch)",
   ),
   Command.withSubcommands([
+    workflowRunCommand,
     workflowListCommand,
     workflowViewCommand,
     workflowJobsCommand,
@@ -172,16 +176,17 @@ WORKFLOW FOR AI AGENTS:
   10. Use 'issue close --issue N --comment "reason"' to close issues
   11. Use 'issue comment --issue N --body "text"' to comment on issues
   12. Use 'repo info' to get repository metadata
-  13. Use 'workflow list' to list recent workflow runs
-  14. Use 'workflow view --run N' to inspect a specific run with jobs/steps
-  15. Use 'workflow logs --run N' to get logs (failed jobs by default)
-  16. Use 'workflow job-logs --run N --job "build-web-app"' to get clean parsed logs for a specific job
-  17. Use 'workflow annotations --run N' to list CI annotations (errors, warnings, notices)
-  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
-  22. Use 'branch rename --old-name X --new-name Y --confirm' to rename a branch`,
+  13. Use 'workflow run' to dispatch workflow_dispatch workflows
+  14. Use 'workflow list' to list recent workflow runs
+  15. Use 'workflow view --run N' to inspect a specific run with jobs/steps
+  16. Use 'workflow logs --run N' to get logs (failed jobs by default)
+  17. Use 'workflow job-logs --run N --job "build-web-app"' to get clean parsed logs for a specific job
+  18. Use 'workflow annotations --run N' to list CI annotations (errors, warnings, notices)
+  19. Use 'workflow watch --run N' to watch until completion
+  20. Use 'release status' to inspect latest release + repository context
+  21. Use 'release create --tag vX.Y.Z --generate-notes' to publish a release
+  22. Use 'release edit/view/list/delete' to maintain existing releases
+  23. Use 'branch rename --old-name X --new-name Y --confirm' to rename a branch`,
   ),
   Command.withSubcommands([
     prCommand,

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

@@ -46,6 +46,7 @@ import {
   fetchDiscussionSummary,
   fetchIssueComments,
   fetchLatestIssueComment,
+  fetchReviews,
   fetchThreads,
   postIssueComment,
   replyToComment,
@@ -606,6 +607,49 @@ export const prCommentsCommand = Command.make(
     ),
 ).pipe(Command.withDescription("Fetch review comments for a PR (optionally filter by --since)"));
 
+export const prReviewsCommand = Command.make(
+  "reviews",
+  {
+    author: Flag.string("author").pipe(
+      Flag.withDescription("Filter by author login substring"),
+      Flag.optional,
+    ),
+    bodyContains: Flag.string("body-contains").pipe(
+      Flag.withDescription("Filter reviews by body substring"),
+      Flag.optional,
+    ),
+    format: formatOption,
+    pr: Flag.integer("pr").pipe(
+      Flag.withDescription("PR number (default: current branch PR)"),
+      Flag.optional,
+    ),
+    repo: repoOption,
+    state: Flag.string("state").pipe(
+      Flag.withDescription(
+        "Filter by review state (APPROVED, CHANGES_REQUESTED, COMMENTED, DISMISSED)",
+      ),
+      Flag.optional,
+    ),
+  },
+  ({ author, bodyContains, format, pr, repo, state }) =>
+    withRepo(
+      repo,
+      Effect.gen(function* () {
+        const reviews = yield* fetchReviews(
+          Option.getOrNull(pr),
+          Option.getOrNull(author),
+          Option.getOrNull(bodyContains),
+          Option.getOrNull(state),
+        );
+        yield* logFormatted(reviews, format);
+      }),
+    ),
+).pipe(
+  Command.withDescription(
+    "Fetch submitted review summaries (state + body) for a PR — the review bodies that comments/issue-comments do not expose",
+  ),
+);
+
 export const prIssueCommentsCommand = Command.make(
   "issue-comments",
   {

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

@@ -15,6 +15,7 @@ export {
   prRerunChecksCommand,
   prReplyAndResolveCommand,
   prResolveCommand,
+  prReviewsCommand,
   prStatusCommand,
   prSubmitReviewCommand,
   prThreadsCommand,

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

@@ -5,6 +5,7 @@ import type {
   IssueComment,
   IssueCommentId,
   IsoTimestamp,
+  PullRequestReview,
   ReviewComment,
   ReviewThread,
 } from "#gh/types";
@@ -158,6 +159,15 @@ type RawIssueComment = {
   html_url: string;
 };
 
+type RawPullRequestReview = {
+  id: number;
+  user: { login: string } | null;
+  state: string;
+  body: string | null;
+  submitted_at: string | null;
+  html_url: string;
+};
+
 type ReviewCommentById = {
   id: number;
   in_reply_to_id: number | null;
@@ -405,6 +415,55 @@ export const fetchIssueComments = Effect.fn("pr.fetchIssueComments")(function* (
   return comments;
 });
 
+/**
+ * Fetch submitted review summaries (state + top-level body) for a PR via REST API.
+ * Complements `comments` (inline review comments) and `issue-comments` (discussion),
+ * which never expose the submitted review body. Optional author/state/body filters.
+ */
+export const fetchReviews = Effect.fn("pr.fetchReviews")(function* (
+  pr: number | null,
+  author: string | null,
+  bodyContains: string | null,
+  state: string | null,
+) {
+  const service = yield* GitHubService;
+  const repoInfo = yield* service.getRepoInfo();
+
+  const resolvedPr = pr ?? (yield* viewPR(null)).number;
+
+  const raw = yield* fetchAllRestPages<RawPullRequestReview>(
+    `repos/${repoInfo.owner}/${repoInfo.name}/pulls/${resolvedPr}/reviews`,
+    "gh-tool pr reviews",
+    "Failed to parse response",
+  );
+
+  let reviews: PullRequestReview[] = raw.map((review) => ({
+    id: review.id,
+    author: review.user?.login ?? "unknown",
+    state: review.state,
+    body: review.body ?? "",
+    submittedAt: (review.submitted_at ?? null) as IsoTimestamp | null,
+    url: review.html_url,
+  }));
+
+  if (author !== null) {
+    const authorFilter = author.toLowerCase();
+    reviews = reviews.filter((review) => review.author.toLowerCase().includes(authorFilter));
+  }
+
+  if (state !== null) {
+    const stateFilter = state.toLowerCase();
+    reviews = reviews.filter((review) => review.state.toLowerCase() === stateFilter);
+  }
+
+  if (bodyContains !== null) {
+    const bodyFilter = bodyContains.toLowerCase();
+    reviews = reviews.filter((review) => review.body.toLowerCase().includes(bodyFilter));
+  }
+
+  return reviews;
+});
+
 export const fetchLatestIssueComment = Effect.fn("pr.fetchLatestIssueComment")(function* (
   pr: number | null,
   author: string | null,

package/src/gh-tool/types.ts

@@ -66,6 +66,15 @@ export type IssueComment = {
   url: GitHubIssueCommentUrl;
 };
 
+export type PullRequestReview = {
+  id: number;
+  author: string;
+  state: string;
+  body: string;
+  submittedAt: IsoTimestamp | null;
+  url: string;
+};
+
 export type CheckResult = {
   name: string;
   state: string;

package/src/gh-tool/workflow.ts

@@ -1,4 +1,4 @@
-import { Command, Flag } from "effect/unstable/cli";
+import { Command, Flag, Param } from "effect/unstable/cli";
 import { Console, Effect, Option } from "effect";
 
 import { formatOption, logFormatted } from "#shared";
@@ -213,6 +213,34 @@ const cancelRun = Effect.fn("workflow.cancelRun")(function* (runId: number, repo
   };
 });
 
+export const dispatchWorkflow = Effect.fn("workflow.dispatchWorkflow")(function* (opts: {
+  workflow: string;
+  ref: string;
+  fields: ReadonlyArray<string>;
+  repo: string | null;
+}) {
+  const gh = yield* GitHubService;
+  const args = ["workflow", "run", opts.workflow, "--ref", opts.ref];
+
+  if (opts.repo !== null) {
+    args.push("--repo", opts.repo);
+  }
+
+  for (const field of opts.fields) {
+    args.push("-f", field);
+  }
+
+  yield* gh.runGh(args);
+
+  return {
+    dispatched: true as const,
+    workflow: opts.workflow,
+    ref: opts.ref,
+    repo: opts.repo,
+    fields: opts.fields,
+  };
+});
+
 // `gh run watch` has no native timeout (observed hanging 36 min). Block for the caller's --timeout,
 // then fall back to a one-shot snapshot so a timeout never returns nothing.
 const DEFAULT_WATCH_RUN_TIMEOUT_SECONDS = CI_CHECK_WATCH_TIMEOUT_MS / 1000;
@@ -649,6 +677,37 @@ export const workflowCancelCommand = Command.make(
     }),
 ).pipe(Command.withDescription("Cancel an in-progress workflow run"));
 
+export const workflowRunCommand = Command.make(
+  "run",
+  {
+    field: Param.variadic(
+      Param.string(Param.flagKind, "field").pipe(
+        Param.withAlias("f"),
+        Param.withDescription("Workflow input as key=value; may be repeated"),
+      ),
+    ),
+    format: formatOption,
+    ref: Flag.string("ref").pipe(
+      Flag.withDescription("Git ref to run the workflow on (branch, tag, or SHA)"),
+    ),
+    repo: repoOption,
+    workflow: Flag.string("workflow").pipe(
+      Flag.withDescription("Workflow file name (e.g., build.yml) or workflow ID"),
+    ),
+  },
+  ({ field, format, ref, repo, workflow }) =>
+    Effect.gen(function* () {
+      const resolvedRepo = yield* resolveRepoArg(repo);
+      const result = yield* dispatchWorkflow({
+        workflow,
+        ref,
+        fields: field,
+        repo: resolvedRepo,
+      });
+      yield* logFormatted(result, format);
+    }),
+).pipe(Command.withDescription("Dispatch a workflow_dispatch workflow run"));
+
 export const workflowWatchCommand = Command.make(
   "watch",
   {