@blogic-cz/agent-tools 0.14.46 → 0.14.48

package/README.md

@@ -312,7 +312,19 @@ All settings are optional — audit works out of the box with sensible defaults.
 
 ## Configuration
 
-Config is loaded from `agent-tools.json5` (or `agent-tools.json`) by walking up from the current working directory. Missing config = zero-config mode (works for `gh-tool`; others require config).
+Config is loaded by walking up from the current working directory to the nearest regular config file:
+
+1. `agent-tools.json`
+2. `agent-tools.json5`
+
+That nearest regular config is the base. Local override files are then merged from that directory down to the current working directory:
+
+1. `agent-tools.local.json`
+2. `agent-tools.local.json5`
+
+Later files override earlier files. Objects are merged deeply; arrays and primitive values are replaced. Missing config = zero-config mode (works for `gh-tool`; others require config).
+
+Use `agent-tools.local.json5` for machine-specific ports, paths, and worktree overrides. Keep local files gitignored.
 
 ### Global Settings
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.14.46",
+  "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/config/loader.ts

@@ -194,8 +194,12 @@ const AgentToolsConfigSchema = Schema.Struct({
   github: Schema.optionalKey(Schema.Record(Schema.String, GitHubRepoConfigSchema)),
 });
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 function stripUnknownTopLevelKeys(parsed: unknown): unknown {
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+  if (!isRecord(parsed)) {
     return parsed;
   }
 
@@ -223,40 +227,101 @@ export function decodeConfig(
   }
 }
 
-async function findConfigFile(startDirectory: string = process.cwd()): Promise<string | undefined> {
+const BASE_CONFIG_FILES = ["agent-tools.json", "agent-tools.json5"] as const;
+const LOCAL_CONFIG_FILES = ["agent-tools.local.json", "agent-tools.local.json5"] as const;
+
+async function existingFile(filePath: string): Promise<string | undefined> {
+  return (await Bun.file(filePath).exists()) ? filePath : undefined;
+}
+
+async function findBaseConfigDirectory(
+  startDirectory: string = process.cwd(),
+): Promise<string | undefined> {
   let currentDirectory = startDirectory;
 
   while (true) {
-    const json5Path = `${currentDirectory}/agent-tools.json5`;
-    // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
-    if (await Bun.file(json5Path).exists()) {
-      return json5Path;
+    for (const fileName of BASE_CONFIG_FILES) {
+      // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
+      if (await Bun.file(`${currentDirectory}/${fileName}`).exists()) {
+        return currentDirectory;
+      }
     }
 
-    const jsonPath = `${currentDirectory}/agent-tools.json`;
-    // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
-    if (await Bun.file(jsonPath).exists()) {
-      return jsonPath;
+    const parentDirectory = dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return undefined;
+    }
+    currentDirectory = parentDirectory;
+  }
+}
+
+async function findConfigFiles(startDirectory: string = process.cwd()): Promise<readonly string[]> {
+  const baseDirectory = await findBaseConfigDirectory(startDirectory);
+  if (!baseDirectory) {
+    return [];
+  }
+
+  const directories: string[] = [];
+  let currentDirectory = startDirectory;
+  while (true) {
+    directories.push(currentDirectory);
+    if (currentDirectory === baseDirectory) {
+      break;
     }
 
     const parentDirectory = dirname(currentDirectory);
     if (parentDirectory === currentDirectory) {
-      return undefined;
+      return [];
     }
     currentDirectory = parentDirectory;
   }
+  directories.reverse();
+
+  const configFiles: string[] = [];
+  for (const directory of directories) {
+    const fileNames =
+      directory === baseDirectory
+        ? [...BASE_CONFIG_FILES, ...LOCAL_CONFIG_FILES]
+        : LOCAL_CONFIG_FILES;
+
+    for (const fileName of fileNames) {
+      // eslint-disable-next-line eslint/no-await-in-loop -- config precedence is directory/file order
+      const filePath = await existingFile(`${directory}/${fileName}`);
+      if (filePath) {
+        configFiles.push(filePath);
+      }
+    }
+  }
+
+  return configFiles;
+}
+
+function mergeConfigValue(left: unknown, right: unknown): unknown {
+  if (!isRecord(left) || !isRecord(right)) {
+    return right;
+  }
+
+  const merged: Record<string, unknown> = { ...left };
+  for (const [key, value] of Object.entries(right)) {
+    merged[key] = key in merged ? mergeConfigValue(merged[key], value) : value;
+  }
+  return merged;
 }
 
 export async function loadConfig(): Promise<AgentToolsConfig | undefined> {
-  const configPath = await findConfigFile();
-  if (!configPath) {
+  const configPaths = await findConfigFiles();
+  if (configPaths.length === 0) {
     return undefined;
   }
 
-  const fileContent = await Bun.file(configPath).text();
-  const parsed = Bun.JSON5.parse(fileContent);
+  let parsed: unknown = {};
+  for (const configPath of configPaths) {
+    // eslint-disable-next-line eslint/no-await-in-loop -- config precedence is file order
+    const fileContent = await Bun.file(configPath).text();
+    parsed = mergeConfigValue(parsed, Bun.JSON5.parse(fileContent));
+  }
 
-  return decodeConfig(parsed, configPath);
+  return decodeConfig(parsed, configPaths.join(", "));
 }
 
 export class ConfigService extends Context.Service<ConfigService, AgentToolsConfig | undefined>()(

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",
   {