@blogic-cz/agent-tools 0.14.47 → 0.14.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.14.47",
+  "version": "0.14.48",
   "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

@@ -61,6 +61,7 @@ import {
   workflowListCommand,
   workflowLogsCommand,
   workflowRerunCommand,
+  workflowRunCommand,
   workflowViewCommand,
   workflowWatchCommand,
 } from "./workflow";
@@ -123,9 +124,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 +174,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/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",
   {