@blogic-cz/agent-tools 1.7.5 → 1.9.0

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

@@ -3,7 +3,11 @@ import { Effect } from "effect";
 import type { GitHubIssueCommentUrl, IssueComment, IssueCommentId, IsoTimestamp } from "#gh/types";
 
 import { GitHubCommandError } from "#gh/errors";
-import { GitHubService } from "#gh/service";
+import { GitHubService } from "#gh/read/transport";
+import { reads, resolveRepo } from "#gh/read/reads";
+import { writes } from "#gh/read/writes";
+import { project } from "#gh/read/porcelain";
+import { repoSlug } from "#gh/read/keys";
 
 export type IssueInfo = {
   number: number;
@@ -34,52 +38,6 @@ export type RawIssueComment = {
   html_url: string;
 };
 
-const REST_PAGE_SIZE = 100;
-
-const parseJson = <T>(
-  stdout: string,
-  command: string,
-  parseFailurePrefix: string,
-): Effect.Effect<T, GitHubCommandError> =>
-  Effect.try({
-    try: () => JSON.parse(stdout) as T,
-    catch: (error) =>
-      new GitHubCommandError({
-        command,
-        exitCode: 0,
-        stderr: `${parseFailurePrefix}: ${error instanceof Error ? error.message : String(error)}`,
-        message: `${parseFailurePrefix}: ${error instanceof Error ? error.message : String(error)}`,
-      }),
-  });
-
-const fetchAllRestPages = Effect.fn("issue.fetchAllRestPages")(function* <T>(
-  endpoint: string,
-  command: string,
-  parseFailurePrefix: string,
-) {
-  const service = yield* GitHubService;
-
-  const results: T[] = [];
-  let page = 1;
-
-  while (true) {
-    const separator = endpoint.includes("?") ? "&" : "?";
-    const result = yield* service.runGh([
-      "api",
-      `${endpoint}${separator}per_page=${REST_PAGE_SIZE}&page=${page}`,
-    ]);
-
-    const rawPage = yield* parseJson<T[]>(result.stdout, command, parseFailurePrefix);
-    results.push(...rawPage);
-
-    if (rawPage.length < REST_PAGE_SIZE) {
-      return results;
-    }
-
-    page += 1;
-  }
-});
-
 const mapRawIssueComment = (comment: RawIssueComment): IssueComment => ({
   id: comment.id as IssueCommentId,
   commitSha: null,
@@ -94,36 +52,25 @@ export const listIssues = Effect.fn("issue.listIssues")(function* (opts: {
   state: string;
   labels: string | null;
   limit: number;
+  includeBody?: boolean;
+  fresh?: boolean;
 }) {
-  const gh = yield* GitHubService;
-
-  const args = [
-    "issue",
-    "list",
-    "--state",
-    opts.state,
-    "--limit",
-    String(opts.limit),
-    "--json",
-    "number,title,state,url,labels,createdAt",
-  ];
-
-  if (opts.labels !== null) {
-    args.push("--label", opts.labels);
-  }
-
-  return yield* gh.runGhJson<IssueListItem[]>(args);
+  const { fresh, ...filter } = opts;
+  return yield* reads.issueList(yield* resolveRepo(null), filter, fresh ? "origin" : "cached");
 });
 
 export const viewIssue = Effect.fn("issue.viewIssue")(function* (issueNumber: number) {
-  const gh = yield* GitHubService;
-
-  return yield* gh.runGhJson<IssueInfo>([
-    "issue",
-    "view",
-    String(issueNumber),
-    "--json",
-    "number,title,state,url,labels,assignees,author,createdAt,closedAt",
+  const value = yield* reads.issueView(yield* resolveRepo(null), issueNumber);
+  return project(value, [
+    "number",
+    "title",
+    "state",
+    "url",
+    "labels",
+    "assignees",
+    "author",
+    "createdAt",
+    "closedAt",
   ]);
 });
 
@@ -133,14 +80,7 @@ export const fetchIssueComments = Effect.fn("issue.fetchIssueComments")(function
   author: string | null,
   bodyContains: string | null,
 ) {
-  const gh = yield* GitHubService;
-  const repoInfo = yield* gh.getRepoInfo();
-
-  const raw = yield* fetchAllRestPages<RawIssueComment>(
-    `repos/${repoInfo.owner}/${repoInfo.name}/issues/${issueNumber}/comments`,
-    "gh-tool issue comments",
-    "Failed to parse response",
-  );
+  const raw = yield* reads.issueComments(yield* resolveRepo(null), issueNumber);
 
   let comments = raw.map(mapRawIssueComment);
 
@@ -167,46 +107,40 @@ export const closeIssue = Effect.fn("issue.closeIssue")(function* (opts: {
   comment: string | null;
   reason: string;
 }) {
-  const gh = yield* GitHubService;
-
   const args = ["issue", "close", String(opts.issue), "--reason", opts.reason];
 
   if (opts.comment !== null) {
     args.push("--comment", opts.comment);
   }
 
-  yield* gh.runGh(args);
-
-  return yield* gh.runGhJson<IssueInfo>([
-    "issue",
-    "view",
-    String(opts.issue),
-    "--json",
-    "number,title,state,url,labels,assignees,author,createdAt,closedAt",
+  const repo = yield* resolveRepo(null);
+  yield* writes.run(args, [
+    `issue:${repoSlug(repo)}#${opts.issue}`,
+    `issues:${repoSlug(repo)}`,
+    `issue-comments:${repoSlug(repo)}#${opts.issue}`,
   ]);
+
+  return yield* viewIssue(opts.issue);
 });
 
 export const reopenIssue = Effect.fn("issue.reopenIssue")(function* (opts: {
   issue: number;
   comment: string | null;
 }) {
-  const gh = yield* GitHubService;
-
   const args = ["issue", "reopen", String(opts.issue)];
 
   if (opts.comment !== null) {
     args.push("--comment", opts.comment);
   }
 
-  yield* gh.runGh(args);
-
-  return yield* gh.runGhJson<IssueInfo>([
-    "issue",
-    "view",
-    String(opts.issue),
-    "--json",
-    "number,title,state,url,labels,assignees,author,createdAt,closedAt",
+  const repo = yield* resolveRepo(null);
+  yield* writes.run(args, [
+    `issue:${repoSlug(repo)}#${opts.issue}`,
+    `issues:${repoSlug(repo)}`,
+    `issue-comments:${repoSlug(repo)}#${opts.issue}`,
   ]);
+
+  return yield* viewIssue(opts.issue);
 });
 
 export const commentOnIssue = Effect.fn("issue.commentOnIssue")(function* (opts: {
@@ -227,14 +161,20 @@ export const commentOnIssue = Effect.fn("issue.commentOnIssue")(function* (opts:
     );
   }
 
-  const result = yield* gh.runGh([
-    "api",
-    "-X",
-    "POST",
-    `repos/${repoInfo.owner}/${repoInfo.name}/issues/${opts.issue}/comments`,
-    "-f",
-    `body=${opts.body}`,
-  ]);
+  const result = yield* writes.run(
+    [
+      "api",
+      "-X",
+      "POST",
+      `repos/${repoInfo.owner}/${repoInfo.name}/issues/${opts.issue}/comments`,
+      "-f",
+      `body=${opts.body}`,
+    ],
+    [
+      `issue-comments:${repoInfo.owner.toLowerCase()}/${repoInfo.name.toLowerCase()}#${opts.issue}`,
+      `issue:${repoInfo.owner.toLowerCase()}/${repoInfo.name.toLowerCase()}#${opts.issue}`,
+    ],
+  );
 
   const rawComment = yield* Effect.try({
     try: () => JSON.parse(result.stdout) as RawIssueComment,
@@ -262,8 +202,6 @@ export const createIssue = Effect.fn("issue.createIssue")(function* (opts: {
   assignee: string | null;
   labels: string | null;
 }) {
-  const gh = yield* GitHubService;
-
   const args = ["issue", "create", "--title", opts.title, "--body", opts.body];
 
   if (opts.assignee !== null) {
@@ -273,7 +211,8 @@ export const createIssue = Effect.fn("issue.createIssue")(function* (opts: {
     args.push("--label", opts.labels);
   }
 
-  const result = yield* gh.runGh(args);
+  const repo = yield* resolveRepo(null);
+  const result = yield* writes.run(args, [`repo:${repoSlug(repo)}`]);
 
   const urlMatch = result.stdout.match(/\/issues\/(\d+)/);
   if (!urlMatch?.[1]) {
@@ -299,8 +238,6 @@ export const editIssue = Effect.fn("issue.editIssue")(function* (opts: {
   addAssignee: string | null;
   removeAssignee: string | null;
 }) {
-  const gh = yield* GitHubService;
-
   const args = ["issue", "edit", String(opts.issue)];
 
   if (opts.title !== null) {
@@ -322,13 +259,12 @@ export const editIssue = Effect.fn("issue.editIssue")(function* (opts: {
     args.push("--remove-assignee", opts.removeAssignee);
   }
 
-  yield* gh.runGh(args);
-
-  return yield* gh.runGhJson<IssueInfo>([
-    "issue",
-    "view",
-    String(opts.issue),
-    "--json",
-    "number,title,state,url,labels,assignees,author,createdAt,closedAt",
+  const repo = yield* resolveRepo(null);
+  yield* writes.run(args, [
+    `issue:${repoSlug(repo)}#${opts.issue}`,
+    `issues:${repoSlug(repo)}`,
+    `issue-comments:${repoSlug(repo)}#${opts.issue}`,
   ]);
+
+  return yield* viewIssue(opts.issue);
 });

package/src/gh-tool/issue/triage.ts

@@ -4,10 +4,11 @@ import { Effect, Option, Schema } from "effect";
 import type { CheckResult, IssueComment, PRViewInfo, ReviewThread } from "#gh/types";
 
 import { formatOption, logFormatted } from "#shared";
-import { GitHubService } from "#gh/service";
+import { GitHubService } from "#gh/read/transport";
 import { fetchReviewTriage } from "#gh/pr/commands";
 
 import { fetchIssueComments } from "./core";
+import { reads, resolveRepo } from "#gh/read/reads";
 
 const repoOption = Flag.String("repo").pipe(
   Flag.withDescription("Target repository profile name or owner/name"),
@@ -23,19 +24,6 @@ const withRepo = <A, E, R>(repo: Option.Option<string>, effect: Effect.Effect<A,
 const TriageVerbosity = Schema.Literals(["compact", "full"]);
 type TriageVerbosity = typeof TriageVerbosity.Type;
 
-type RawTriageIssue = {
-  number: number;
-  title: string;
-  state: string;
-  url: string;
-  labels: Array<{ name: string }>;
-  assignees: Array<{ login: string }>;
-  author: { login: string };
-  body: string;
-  createdAt: string;
-  closedAt: string | null;
-};
-
 type TriageIssue = {
   number: number;
   title: string;
@@ -114,19 +102,9 @@ export const fetchIssueTriage = Effect.fn("issue.fetchIssueTriage")(function* (o
   issue: number;
   verbosity: TriageVerbosity;
 }) {
-  const gh = yield* GitHubService;
-
+  const repo = yield* resolveRepo(null);
   const [rawIssue, comments] = yield* Effect.all(
-    [
-      gh.runGhJson<RawTriageIssue>([
-        "issue",
-        "view",
-        String(opts.issue),
-        "--json",
-        "number,title,state,url,labels,assignees,author,body,createdAt,closedAt",
-      ]),
-      fetchIssueComments(opts.issue, null, null, null),
-    ],
+    [reads.issueView(repo, opts.issue), fetchIssueComments(opts.issue, null, null, null)],
     { concurrency: "unbounded" },
   );
 

package/src/gh-tool/label.ts

@@ -0,0 +1,57 @@
+import { Command, Flag } from "effect/cli";
+import { Effect, Option } from "effect";
+
+import { formatOption, logFormatted } from "#shared";
+import { GitHubService } from "#gh/read/transport";
+import { resolveRepo } from "#gh/read/reads";
+import { repoSlug } from "#gh/read/keys";
+import { writes } from "#gh/read/writes";
+
+export const createLabel = Effect.fn("label.createLabel")(function* (opts: {
+  name: string;
+  color: string;
+  description: string;
+  force: boolean;
+}) {
+  const repo = yield* resolveRepo(null);
+  const args = [
+    "label",
+    "create",
+    opts.name,
+    "--color",
+    opts.color,
+    "--description",
+    opts.description,
+  ];
+  if (opts.force) args.push("--force");
+  yield* writes.run(args, [`repo:${repoSlug(repo)}`]);
+  return { name: opts.name };
+});
+
+export const labelCreateCommand = Command.make(
+  "create",
+  {
+    name: Flag.String("name").pipe(Flag.withDescription("Label name")),
+    color: Flag.String("color").pipe(Flag.withDescription("Six-character hexadecimal color")),
+    description: Flag.String("description").pipe(Flag.withDefault("")),
+    force: Flag.Boolean("force").pipe(
+      Flag.withDescription("Update the label if it already exists"),
+      Flag.withDefault(false),
+    ),
+    repo: Flag.String("repo").pipe(
+      Flag.withDescription("Target repository profile name or owner/name"),
+      Flag.optional,
+    ),
+    format: formatOption,
+  },
+  ({ format, repo, ...opts }) =>
+    Effect.gen(function* () {
+      const gh = yield* GitHubService;
+      yield* gh.withRepoTarget(
+        Option.getOrNull(repo),
+        Effect.gen(function* () {
+          yield* logFormatted(yield* createLabel(opts), format);
+        }),
+      );
+    }),
+).pipe(Command.withDescription("Create a repository label"));

package/src/gh-tool/main.ts

@@ -71,8 +71,16 @@ import {
   releaseStatusCommand,
   releaseViewCommand,
 } from "./release";
-import { repoInfoCommand, repoListCommand, repoSearchCodeCommand } from "./repo";
-import { GitHubService } from "./service";
+import {
+  repoCommitAuthorCommand,
+  repoInfoCommand,
+  repoListCommand,
+  repoSearchCodeCommand,
+} from "./repo";
+import { labelCreateCommand } from "./label";
+import { GitHubService } from "./read/transport";
+import { withReadCache } from "./read";
+import { cacheCommand } from "./read/commands";
 import {
   workflowAnnotationsCommand,
   workflowCancelCommand,
@@ -151,7 +159,17 @@ const branchCommand = Command.make("branch", {}).pipe(
 
 const repoCommand = Command.make("repo", {}).pipe(
   Command.withDescription("Repository operations"),
-  Command.withSubcommands([repoInfoCommand, repoListCommand, repoSearchCodeCommand]),
+  Command.withSubcommands([
+    repoInfoCommand,
+    repoListCommand,
+    repoSearchCodeCommand,
+    repoCommitAuthorCommand,
+  ]),
+);
+
+const labelCommand = Command.make("label", {}).pipe(
+  Command.withDescription("Repository label operations"),
+  Command.withSubcommands([labelCreateCommand]),
 );
 
 const workflowCommand = Command.make("workflow", {}).pipe(
@@ -235,11 +253,13 @@ WORKFLOW FOR AI AGENTS:
     prCommand,
     issueCommand,
     repoCommand,
+    labelCommand,
     branchCommand,
     workflowCommand,
     releaseCommand,
     gistCommand,
     commandsCommand,
+    cacheCommand,
   ]),
 );
 
@@ -254,7 +274,7 @@ const MainLayer = GitHubService.layer.pipe(
   Layer.provideMerge(ConfigServiceLayer),
 );
 
-const program = withRedactedOutput(withAudit("gh", cli)).pipe(
+const program = withReadCache(withRedactedOutput(withAudit("gh", cli))).pipe(
   Effect.provide(MainLayer),
   Effect.tapCause(renderCauseToStderr),
 );

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

@@ -1,10 +1,12 @@
+import { reads, writes } from "#gh/read/index";
+import { repoSlug } from "#gh/read/keys";
 import { Command, Flag, Param } from "effect/cli";
 import { Console, Effect, Option } from "effect";
 
 import type { CheckResult, PRStatusResult } from "#gh/types";
 
 import { formatOption, logFormatted, logText } from "#shared";
-import { GitHubService } from "#gh/service";
+import { GitHubService } from "#gh/read/transport";
 import { GitHubCommandError } from "#gh/errors";
 
 const emptyBatchError = (batch: string) =>
@@ -152,20 +154,20 @@ export const requestReview = (pr: number, reviewers: string) =>
     const repo = yield* gh.getRepoInfo();
     // ponytail: not atomic — a concurrent request between GET and POST misreports newlyRequested.
     const pendingBefore = new Set(
-      (yield* confirmedReviewers(
-        yield* gh.runGhJson<RequestedReviewersResponse>([
-          "api",
-          `repos/${repo.owner}/${repo.name}/pulls/${pr}`,
-        ]),
-      )).map((login) => login.toLowerCase()),
+      (yield* confirmedReviewers(yield* reads.reviewGuards.requestedReviewers(repo, pr))).map(
+        (login) => login.toLowerCase(),
+      ),
+    );
+    const response = yield* writes.json<RequestedReviewersResponse>(
+      [
+        "api",
+        "--method",
+        "POST",
+        `repos/${repo.owner}/${repo.name}/pulls/${pr}/requested_reviewers`,
+        ...submittedReviewers.flatMap((reviewer) => ["-f", `reviewers[]=${reviewer}`]),
+      ],
+      [`pr:${repoSlug(repo)}#${pr}`, `reviews:${repoSlug(repo)}#${pr}`, `pulls:${repoSlug(repo)}`],
     );
-    const response = yield* gh.runGhJson<RequestedReviewersResponse>([
-      "api",
-      "--method",
-      "POST",
-      `repos/${repo.owner}/${repo.name}/pulls/${pr}/requested_reviewers`,
-      ...submittedReviewers.flatMap((reviewer) => ["-f", `reviewers[]=${reviewer}`]),
-    ]);
     return {
       pr,
       submittedReviewers,
@@ -239,7 +241,7 @@ const withStableHead = Effect.fn("pr.withStableHead")(function* <A, E, R>(
     initial,
     (info) => collect(info.number, info.headSha),
     (info) =>
-      fetchPRView(info.number).pipe(
+      fetchPRView(info.number, "origin").pipe(
         Effect.map((refreshed) => ({ ...refreshed, baseSha: initial.baseSha })),
       ),
     (before, after) => after.headSha === before.headSha,