copilot-agent 0.10.0 → 0.11.0

package/README.md

@@ -19,6 +19,8 @@ Autonomous AI agent manager — auto-resume sessions, discover tasks, run overni
 | **`diff`** | Show git changes made by an agent session |
 | **`quota`** | Track premium requests, tokens, and usage over time |
 | **`compact`** | Generate context summary for session handoff/resume |
+| **`hooks`** | Event-driven automation (on_task_complete, on_error, etc.) |
+| **`pr`** | Auto-create GitHub Pull Request from session changes |
 
 All commands support `--agent copilot` or `--agent claude` (auto-detects if omitted).
 
@@ -165,6 +167,43 @@ copilot-agent compact --save
 copilot-agent compact --resume-prompt
 ```
 
+### Hooks (event-driven automation)
+
+```bash
+# Show configured hooks
+copilot-agent hooks list
+
+# Test-run hooks for an event
+copilot-agent hooks test on_task_complete
+```
+
+Create `~/.copilot-agent/hooks.yaml` or `.copilot-agent/hooks.yaml`:
+
+```yaml
+on_task_complete:
+  - command: "npm test"
+    name: "Run tests"
+on_session_end:
+  - command: "git push origin HEAD"
+    name: "Auto-push"
+on_error:
+  - command: "curl -X POST $SLACK_WEBHOOK -d '{\"text\":\"Agent error!\"}'"
+    name: "Notify Slack"
+```
+
+### Auto-create Pull Request
+
+```bash
+# Create PR from latest session
+copilot-agent pr
+
+# Dry-run (preview without creating)
+copilot-agent pr --dry-run
+
+# Create ready (non-draft) PR
+copilot-agent pr --no-draft
+```
+
 ## How it works
 
 1. **Agent abstraction** — Unified interface for both Copilot CLI and Claude Code

package/dist/index.js

@@ -3134,9 +3134,283 @@ function showCompact(sessionId, opts) {
   }
 }
 
+// src/commands/hooks.ts
+import chalk6 from "chalk";
+
+// src/lib/hooks.ts
+import { readFileSync as readFileSync6, existsSync as existsSync9 } from "fs";
+import { join as join11 } from "path";
+import { homedir as homedir9 } from "os";
+import { parse as parseYaml2 } from "yaml";
+import { findUpSync as findUpSync2 } from "find-up";
+import { execaCommand } from "execa";
+var GLOBAL_HOOKS = join11(homedir9(), ".copilot-agent", "hooks.yaml");
+var PROJECT_HOOKS = ".copilot-agent/hooks.yaml";
+function loadHooksConfig(cwd) {
+  const configs = [];
+  if (existsSync9(GLOBAL_HOOKS)) {
+    try {
+      const parsed = parseYaml2(readFileSync6(GLOBAL_HOOKS, "utf-8"));
+      if (parsed) configs.push(parsed);
+    } catch {
+    }
+  }
+  const projectPath = findUpSync2(PROJECT_HOOKS, { cwd: cwd || process.cwd(), type: "file" });
+  if (projectPath) {
+    try {
+      const parsed = parseYaml2(readFileSync6(projectPath, "utf-8"));
+      if (parsed) configs.push(parsed);
+    } catch {
+    }
+  }
+  const merged = {};
+  for (const cfg of configs) {
+    for (const event of ["on_session_start", "on_task_complete", "on_session_end", "on_error", "on_resume"]) {
+      const hooks = cfg[event];
+      if (hooks && Array.isArray(hooks)) {
+        if (!merged[event]) merged[event] = [];
+        merged[event].push(...hooks);
+      }
+    }
+  }
+  return merged;
+}
+async function runHooks(event, cwd, env) {
+  const config = loadHooksConfig(cwd);
+  const hooks = config[event];
+  if (!hooks || hooks.length === 0) return [];
+  const results = [];
+  for (const hook of hooks) {
+    const start = Date.now();
+    try {
+      const result = await execaCommand(hook.command, {
+        cwd: cwd || process.cwd(),
+        timeout: (hook.timeout || 30) * 1e3,
+        env: { ...process.env, ...env },
+        reject: false
+      });
+      results.push({
+        hook,
+        event,
+        success: result.exitCode === 0,
+        output: result.stdout?.slice(0, 500),
+        error: result.exitCode !== 0 ? result.stderr?.slice(0, 500) : void 0,
+        durationMs: Date.now() - start
+      });
+    } catch (err) {
+      results.push({
+        hook,
+        event,
+        success: false,
+        error: err instanceof Error ? err.message : String(err),
+        durationMs: Date.now() - start
+      });
+    }
+  }
+  return results;
+}
+function getHooksSummary(config) {
+  const events = ["on_session_start", "on_task_complete", "on_session_end", "on_error", "on_resume"];
+  return events.map((e) => ({ event: e, count: config[e]?.length || 0 })).filter((e) => e.count > 0);
+}
+
+// src/commands/hooks.ts
+function registerHooksCommand(program2) {
+  const cmd = program2.command("hooks").description("Manage event-driven automation hooks");
+  cmd.command("list").description("Show all configured hooks").action(() => {
+    const config = loadHooksConfig();
+    const summary = getHooksSummary(config);
+    console.log(chalk6.bold.cyan("\n  \u26A1 Hooks Configuration\n"));
+    if (summary.length === 0) {
+      console.log(chalk6.dim("  No hooks configured"));
+      console.log(chalk6.dim("\n  Create ~/.copilot-agent/hooks.yaml or .copilot-agent/hooks.yaml:"));
+      console.log(chalk6.dim("  on_task_complete:"));
+      console.log(chalk6.dim('    - command: "npm test"'));
+      console.log(chalk6.dim('      name: "Run tests"'));
+      console.log();
+      return;
+    }
+    const events = ["on_session_start", "on_task_complete", "on_session_end", "on_error", "on_resume"];
+    for (const event of events) {
+      const hooks = config[event];
+      if (!hooks || hooks.length === 0) continue;
+      console.log(chalk6.bold(`  ${event}`) + chalk6.dim(` (${hooks.length})`));
+      for (const h of hooks) {
+        const name = h.name ? chalk6.white(h.name) : chalk6.dim("unnamed");
+        const timeout = h.timeout ? chalk6.dim(` (${h.timeout}s)`) : "";
+        console.log(`    ${chalk6.green("\u25CF")} ${name}: ${chalk6.cyan(h.command)}${timeout}`);
+      }
+      console.log();
+    }
+  });
+  cmd.command("test <event>").description("Test-run hooks for a specific event").action(async (event) => {
+    const validEvents = ["on_session_start", "on_task_complete", "on_session_end", "on_error", "on_resume"];
+    if (!validEvents.includes(event)) {
+      console.log(chalk6.red(`  \u2717 Invalid event: ${event}`));
+      console.log(chalk6.dim(`  Valid events: ${validEvents.join(", ")}`));
+      return;
+    }
+    console.log(chalk6.cyan(`
+  Running hooks for ${chalk6.bold(event)}...
+`));
+    const results = await runHooks(event);
+    if (results.length === 0) {
+      console.log(chalk6.dim(`  No hooks configured for ${event}`));
+      return;
+    }
+    for (const r of results) {
+      const icon = r.success ? chalk6.green("\u2714") : chalk6.red("\u2717");
+      const name = r.hook.name || r.hook.command;
+      const time = chalk6.dim(`${r.durationMs}ms`);
+      console.log(`  ${icon} ${name} ${time}`);
+      if (r.output) console.log(chalk6.dim(`    ${r.output.split("\n")[0]}`));
+      if (r.error) console.log(chalk6.red(`    ${r.error.split("\n")[0]}`));
+    }
+    console.log();
+  });
+}
+
+// src/commands/pr.ts
+import chalk7 from "chalk";
+import { execaCommandSync as execaCommandSync2 } from "execa";
+function registerPrCommand(program2) {
+  program2.command("pr [session-id]").description("Create a GitHub Pull Request from agent session changes").option("--draft", "Create as draft PR (default: true)", true).option("--no-draft", "Create as ready PR").option("-b, --base <branch>", "Base branch (default: main)").option("-a, --agent <type>", "Agent type: copilot | claude").option("--dry-run", "Show PR details without creating").action((sessionId, opts) => {
+    try {
+      createPr(sessionId, opts);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(chalk7.red(`  \u2717 ${msg}`));
+    }
+  });
+}
+function createPr(sessionId, opts) {
+  const sessions = listAllSessions(50);
+  let targetSession;
+  if (sessionId) {
+    targetSession = sessions.find((s) => s.id.startsWith(sessionId));
+  } else {
+    targetSession = sessions[0];
+    if (targetSession) {
+      console.log(chalk7.dim(`  Using latest session: ${targetSession.id.slice(0, 12)}\u2026
+`));
+    }
+  }
+  if (!targetSession) {
+    console.log(chalk7.red("  \u2717 No session found"));
+    return;
+  }
+  const agentType = opts.agent || targetSession.agent;
+  const report = getAgentSessionReport(targetSession.id, agentType);
+  if (!report) {
+    console.log(chalk7.red("  \u2717 Could not load session report"));
+    return;
+  }
+  const cwd = report.cwd;
+  if (!cwd || !isGitRepo(cwd)) {
+    console.log(chalk7.red("  \u2717 Not a git repository"));
+    return;
+  }
+  const currentBranch = gitCurrentBranch(cwd);
+  const baseBranch = opts.base || "main";
+  if (!currentBranch || currentBranch === baseBranch) {
+    console.log(chalk7.yellow(`  \u26A0 Currently on ${baseBranch} \u2014 switch to a feature branch first`));
+    return;
+  }
+  const agentName = report.agent === "claude" ? "Claude" : "Copilot";
+  const title = report.summary ? report.summary.slice(0, 72) : `[${agentName}] ${currentBranch.replace("agent/", "").replace(/-/g, " ").slice(0, 60)}`;
+  const bodyParts = [];
+  bodyParts.push(`## \u{1F916} Auto-generated by copilot-agent (${report.agent})
+`);
+  if (report.summary) {
+    bodyParts.push(`**Task:** ${report.summary}
+`);
+  }
+  bodyParts.push("### Stats");
+  bodyParts.push(`- **Duration:** ${formatDur(report.durationMs)}`);
+  bodyParts.push(`- **Turns:** ${report.assistantTurns}`);
+  bodyParts.push(`- **Tokens:** ${report.outputTokens.toLocaleString()}`);
+  bodyParts.push(`- **Premium requests:** ${report.premiumRequests}`);
+  bodyParts.push("");
+  if (report.gitCommits.length > 0) {
+    bodyParts.push("### Commits");
+    for (const c of report.gitCommits.slice(0, 20)) {
+      bodyParts.push(`- ${c.split("\n")[0]}`);
+    }
+    bodyParts.push("");
+  }
+  if (report.filesCreated.length > 0 || report.filesEdited.length > 0) {
+    bodyParts.push("### Files Changed");
+    for (const f of report.filesCreated.slice(0, 15)) bodyParts.push(`- \u2795 ${f}`);
+    for (const f of report.filesEdited.slice(0, 15)) bodyParts.push(`- \u270F\uFE0F ${f}`);
+    bodyParts.push("");
+  }
+  if (report.taskCompletions.length > 0) {
+    bodyParts.push("### Tasks Completed");
+    for (const t of report.taskCompletions.slice(0, 10)) {
+      bodyParts.push(`- \u2705 ${t.split("\n")[0]}`);
+    }
+    bodyParts.push("");
+  }
+  bodyParts.push(`---
+*Session: \`${report.id.slice(0, 12)}\u2026\`*`);
+  const body = bodyParts.join("\n");
+  console.log(chalk7.bold.cyan("  \u{1F4DD} Pull Request Preview\n"));
+  console.log(`  ${chalk7.bold("Title:")}  ${title}`);
+  console.log(`  ${chalk7.bold("Branch:")} ${chalk7.cyan(currentBranch)} \u2192 ${chalk7.green(baseBranch)}`);
+  console.log(`  ${chalk7.bold("Draft:")}  ${opts.draft ? "yes" : "no"}`);
+  console.log(`  ${chalk7.bold("Agent:")}  ${report.agent}`);
+  console.log(`  ${chalk7.bold("Files:")}  ${chalk7.green(`+${report.filesCreated.length}`)} created, ${chalk7.yellow(`~${report.filesEdited.length}`)} edited`);
+  console.log(`  ${chalk7.bold("Commits:")} ${report.gitCommits.length}`);
+  console.log();
+  if (opts.dryRun) {
+    console.log(chalk7.dim("  (dry run \u2014 PR not created)"));
+    console.log(chalk7.dim("\n  Body preview:"));
+    console.log(chalk7.dim(body.split("\n").map((l) => `    ${l}`).join("\n")));
+    return;
+  }
+  try {
+    console.log(chalk7.dim("  Pushing branch..."));
+    execaCommandSync2(`git push -u origin ${currentBranch}`, { cwd });
+  } catch {
+  }
+  try {
+    const ghArgs = [
+      "gh",
+      "pr",
+      "create",
+      "--title",
+      title,
+      "--body",
+      body,
+      "--base",
+      baseBranch,
+      "--label",
+      "automated"
+    ];
+    if (opts.draft) ghArgs.push("--draft");
+    const result = execaCommandSync2(
+      ghArgs.map((a) => a.includes(" ") ? `"${a}"` : a).join(" "),
+      { cwd }
+    );
+    const prUrl = result.stdout.trim();
+    console.log(chalk7.green(`  \u2714 PR created: ${prUrl}`));
+  } catch (err) {
+    const msg = err instanceof Error ? err.stderr || err.message : String(err);
+    console.log(chalk7.red(`  \u2717 Failed to create PR: ${msg}`));
+    console.log(chalk7.dim("  Make sure gh CLI is installed and authenticated"));
+  }
+}
+function formatDur(ms) {
+  if (ms < 6e4) return `${Math.round(ms / 1e3)}s`;
+  if (ms < 36e5) return `${Math.round(ms / 6e4)}m`;
+  const h = Math.floor(ms / 36e5);
+  const m = Math.round(ms % 36e5 / 6e4);
+  return `${h}h ${m}m`;
+}
+
 // src/index.ts
 var program = new Command();
-program.name("copilot-agent").version("0.10.0").description("Autonomous AI agent manager \u2014 auto-resume, task discovery, overnight runs. Supports GitHub Copilot CLI + Claude Code.");
+program.name("copilot-agent").version("0.11.0").description("Autonomous AI agent manager \u2014 auto-resume, task discovery, overnight runs. Supports GitHub Copilot CLI + Claude Code.");
 registerStatusCommand(program);
 registerWatchCommand(program);
 registerRunCommand(program);
@@ -3150,5 +3424,7 @@ registerProxyCommand(program);
 registerDiffCommand(program);
 registerQuotaCommand(program);
 registerCompactCommand(program);
+registerHooksCommand(program);
+registerPrCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map