@blogic-cz/agent-tools 0.5.5 → 0.5.7

package/package.json

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

package/schemas/agent-tools.schema.json

@@ -57,9 +57,26 @@
     "defaultEnvironment": {
       "description": "Optional default environment name used by tools when no --env flag is provided.",
       "type": "string"
+    },
+    "github": {
+      "type": "object",
+      "description": "Named GitHub repository profiles as Record<string, GitHubRepoConfig>. Use 'default' key for single-repo projects. Multiple profiles can be selected via --repo <name>.",
+      "additionalProperties": {
+        "$ref": "#/definitions/GitHubRepoConfig"
+      }
     }
   },
   "definitions": {
+    "GitHubRepoConfig": {
+      "description": "A single GitHub repository target.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["owner", "repo"],
+      "properties": {
+        "owner": { "type": "string", "description": "GitHub organization or user name." },
+        "repo": { "type": "string", "description": "Repository name." }
+      }
+    },
     "AzureConfig": {
       "description": "Azure DevOps profile configuration.",
       "type": "object",

package/src/config/index.ts

@@ -8,6 +8,7 @@ export type {
   AuditConfig,
   CliToolOverride,
   CredentialGuardConfig,
+  GitHubRepoConfig,
 } from "./types.ts";
 
 export {
@@ -15,5 +16,6 @@ export {
   ConfigServiceLayer,
   getToolConfig,
   getDefaultEnvironment,
+  getGitHubConfig,
   loadConfig,
 } from "./loader";

package/src/config/loader.ts

@@ -2,7 +2,7 @@ import { dirname } from "node:path";
 
 import { Data, Effect, Layer, Schema, ServiceMap } from "effect";
 
-import type { AgentToolsConfig } from "./types.ts";
+import type { AgentToolsConfig, GitHubRepoConfig } from "./types.ts";
 
 const CliToolOverrideSchema = Schema.Struct({
   tool: Schema.String,
@@ -59,6 +59,11 @@ const AuditConfigSchema = Schema.Struct({
   dbPath: Schema.optionalKey(Schema.String),
 });
 
+const GitHubRepoConfigSchema = Schema.Struct({
+  owner: Schema.String,
+  repo: Schema.String,
+});
+
 const AgentToolsConfigSchema = Schema.Struct({
   $schema: Schema.optionalKey(Schema.String),
   azure: Schema.optionalKey(Schema.Record(Schema.String, AzureConfigSchema)),
@@ -73,6 +78,7 @@ const AgentToolsConfigSchema = Schema.Struct({
   audit: Schema.optionalKey(AuditConfigSchema),
   credentialGuard: Schema.optionalKey(CredentialGuardConfigSchema),
   defaultEnvironment: Schema.optionalKey(Schema.String),
+  github: Schema.optionalKey(Schema.Record(Schema.String, GitHubRepoConfigSchema)),
 });
 
 async function findConfigFile(startDirectory: string = process.cwd()): Promise<string | undefined> {
@@ -183,3 +189,22 @@ export function getToolConfig<T>(
 export function getDefaultEnvironment(config: AgentToolsConfig | undefined): string | undefined {
   return config?.defaultEnvironment;
 }
+
+export function getGitHubConfig(
+  config: AgentToolsConfig | undefined,
+  profile?: string,
+): GitHubRepoConfig | undefined {
+  const repos = config?.github;
+  if (!repos) return undefined;
+
+  const keys = Object.keys(repos);
+  if (keys.length === 0) return undefined;
+
+  if (profile) return repos[profile];
+  if (keys.length === 1) return repos[keys[0] ?? ""];
+  if ("default" in repos) return repos.default;
+
+  throw new Error(
+    `Multiple github profiles found: [${keys.join(", ")}]. Use --repo <name> to select one.`,
+  );
+}

package/src/config/types.ts

@@ -61,6 +61,12 @@ export type AuditConfig = {
   dbPath?: string;
 };
 
+/** Single GitHub repository configuration */
+export type GitHubRepoConfig = {
+  owner: string;
+  repo: string;
+};
+
 /**
  * Root agent-tools configuration.
  *
@@ -89,4 +95,6 @@ export type AgentToolsConfig = {
   credentialGuard?: CredentialGuardConfig;
   /** Optional default environment name (local|test|prod) used by tools when no --env flag is provided */
   defaultEnvironment?: string;
+  /** Named GitHub repository profiles. e.g. { default: { owner: "...", repo: "..." } } */
+  github?: Record<string, GitHubRepoConfig>;
 };

package/src/credential-guard/index.ts

@@ -45,6 +45,7 @@ export type CredentialGuard = {
   isDangerousBashCommand: (command: string) => boolean;
   getBlockedCliTool: (command: string) => { name: string; wrapper: string } | null;
   isGhCommandAllowed: (command: string) => boolean;
+  detectSleepPolling: (command: string) => string | null;
 };
 
 // ============================================================================
@@ -184,6 +185,34 @@ const DEFAULT_BLOCKED_CLI_TOOLS: BlockedCliTool[] = [
   },
 ];
 
+type PollingDetectionRule = {
+  pattern: RegExp;
+  suggestion: string;
+};
+
+const DEFAULT_POLLING_DETECTION_RULES: PollingDetectionRule[] = [
+  {
+    pattern: /workflow\s+(?:list|view|jobs|logs|job-logs)\b/,
+    suggestion: "bun agent-tools-gh workflow watch --run <ID>",
+  },
+  {
+    pattern: /pr\s+checks(?![\w-])(?!.*--watch)/,
+    suggestion: "bun agent-tools-gh pr checks --pr <N> --watch",
+  },
+  {
+    pattern: /pr\s+rerun-checks\b/,
+    suggestion: "bun agent-tools-gh pr checks --pr <N> --watch (after rerun completes)",
+  },
+  {
+    pattern: /kubectl\b/,
+    suggestion: 'bun agent-tools-k8s kubectl --env <env> --cmd "wait --for=condition=..."',
+  },
+  {
+    pattern: /\bpipelines?\s+runs?\b/,
+    suggestion: "bun agent-tools-az build summary --build-id <ID>",
+  },
+];
+
 /**
  * Read-only gh subcommands safe on external repos with -R flag.
  */
@@ -325,6 +354,17 @@ export function createCredentialGuard(config?: CredentialGuardConfig): Credentia
     return ghSegments.every((segment) => isGhCommandAllowed(segment.trim()));
   }
 
+  function detectSleepPolling(command: string): string | null {
+    if (!/\bsleep\s+\d+/.test(command)) return null;
+
+    for (const { pattern, suggestion } of DEFAULT_POLLING_DETECTION_RULES) {
+      if (pattern.test(command)) {
+        return suggestion;
+      }
+    }
+    return null;
+  }
+
   function getBlockedCliTool(command: string): { name: string; wrapper: string } | null {
     for (const { pattern, name, wrapper } of blockedCliTools) {
       if (pattern.test(command)) {
@@ -390,6 +430,17 @@ export function createCredentialGuard(config?: CredentialGuardConfig): Credentia
         );
       }
 
+      const sleepSuggestion = detectSleepPolling(command);
+      if (sleepSuggestion) {
+        throw new Error(
+          `\u{26A0}\u{FE0F} Sleep-polling detected.\n\n` +
+            `Instead of polling with sleep, use the built-in watch command:\n\n` +
+            `Use instead: ${sleepSuggestion}\n\n` +
+            `Watch commands block until completion — no polling needed.\n\n` +
+            `→ Skill "agent-tools"`,
+        );
+      }
+
       const blockedTool = getBlockedCliTool(command);
       if (blockedTool) {
         throw new Error(
@@ -412,6 +463,7 @@ export function createCredentialGuard(config?: CredentialGuardConfig): Credentia
     isDangerousBashCommand,
     getBlockedCliTool,
     isGhCommandAllowed,
+    detectSleepPolling,
   };
 }
 
@@ -441,3 +493,6 @@ export const getBlockedCliTool = defaultGuard.getBlockedCliTool;
 
 /** Check if a gh command is allowed (default guard). */
 export const isGhCommandAllowed = defaultGuard.isGhCommandAllowed;
+
+/** Detect sleep-polling with agent-tools wrapper commands (default guard). */
+export const detectSleepPolling = defaultGuard.detectSleepPolling;

package/src/gh-tool/index.ts

@@ -5,6 +5,7 @@ import { Effect, Layer } from "effect";
 
 import { renderCauseToStderr, VERSION } from "#shared";
 import { AuditServiceLayer, withAudit } from "#shared/audit";
+import { ConfigServiceLayer } from "#config";
 import {
   issueCloseCommand,
   issueCommentCommand,
@@ -166,6 +167,7 @@ const cli = Command.run(mainCommand, {
 const MainLayer = GitHubService.layer.pipe(
   Layer.provideMerge(BunServices.layer),
   Layer.provideMerge(AuditServiceLayer),
+  Layer.provideMerge(ConfigServiceLayer),
 );
 
 const program = withAudit("gh", cli).pipe(

package/src/gh-tool/service.ts

@@ -5,6 +5,7 @@ import type { RepoInfo } from "./types";
 
 import { GH_BINARY } from "./config";
 import { GitHubAuthError, GitHubCommandError, GitHubNotFoundError } from "./errors";
+import { ConfigService, getGitHubConfig } from "#config";
 
 type GhResult = {
   stdout: string;
@@ -31,6 +32,9 @@ export class GitHubService extends ServiceMap.Service<
     Effect.scoped(
       Effect.gen(function* () {
         const executor = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const config = yield* ConfigService;
+        const ghRepoConfig = getGitHubConfig(config);
+        const ghRepo = ghRepoConfig ? `${ghRepoConfig.owner}/${ghRepoConfig.repo}` : undefined;
 
         let cachedRepoInfo: RepoInfo | null = null;
 
@@ -40,6 +44,7 @@ export class GitHubService extends ServiceMap.Service<
               const command = ChildProcess.make(GH_BINARY, args, {
                 stdout: "pipe",
                 stderr: "pipe",
+                ...(ghRepo ? { env: { GH_REPO: ghRepo }, extendEnv: true } : {}),
               });
 
               const proc = yield* executor.spawn(command);