copilot-agent 0.9.0 → 0.10.0

package/README.md

@@ -12,8 +12,13 @@ Autonomous AI agent manager — auto-resume sessions, discover tasks, run overni
 | **`overnight`** | Run tasks continuously until a deadline (e.g. 07:00) |
 | **`research`** | Architecture, security, and performance analysis |
 | **`report`** | Session activity report — tools, commits, files, tokens |
-| **`dashboard`** | Real-time TUI dashboard (pure terminal) |
+| **`dashboard`** | htop-style TUI dashboard with blessed (scrollable, keyboard nav) |
 | **`web`** | Web dashboard with live updates (Hono + htmx + SSE) |
+| **`config`** | Persistent configuration defaults (global + per-project) |
+| **`proxy`** | Manage copilot-api proxy for Claude Code via Copilot |
+| **`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 |
 
 All commands support `--agent copilot` or `--agent claude` (auto-detects if omitted).
 
@@ -43,7 +48,6 @@ copilot-agent status --active
 
 # Filter by agent
 copilot-agent status --agent claude
-copilot-agent status --agent copilot
 ```
 
 ### Watch & auto-resume
@@ -83,46 +87,82 @@ copilot-agent overnight ~/my-project
 
 # Run with Claude Code
 copilot-agent overnight --agent claude --until 07 --max-premium 200
-
-# Use worktree for parallel tasks
-copilot-agent overnight --worktree
 ```
 
-### Session report
+### Session report & diff
 
 ```bash
-# Latest session
+# Latest session report
 copilot-agent report
 
-# Specific session
-copilot-agent report abc12345-...
+# Show git changes from latest session
+copilot-agent diff
+
+# Show changes from specific session with diffstat
+copilot-agent diff abc12345-... --stat
+```
+
+### Dashboards
+
+```bash
+# htop-style TUI (blessed — scrollable, keyboard nav)
+copilot-agent dashboard
 
-# Multiple recent sessions as JSON
-copilot-agent report -l 5 --json
+# Simple ANSI fallback (no dependencies)
+copilot-agent dashboard --simple
 
-# Filter by project directory
-copilot-agent report --project ~/my-project
+# Web UI (Hono + htmx, opens browser)
+copilot-agent web
 ```
 
-### Research
+### Configuration
 
 ```bash
-# Analyze current project
-copilot-agent research
+# Set persistent defaults
+copilot-agent config set agent claude
+copilot-agent config set steps 50
+copilot-agent config set worktree true
+
+# View all config (defaults + global + project)
+copilot-agent config list
 
-# With Claude Code
-copilot-agent research --agent claude
+# Per-project config: create .copilot-agent.yaml in project root
 ```
 
-### Dashboards
+### Proxy management (Claude Code via Copilot)
 
 ```bash
-# Terminal UI (pure ANSI, no deps)
-copilot-agent dashboard
+# Start copilot-api proxy (auto-detects Copilot OAuth token)
+copilot-agent proxy start
 
-# Web UI (Hono + htmx, opens browser)
-copilot-agent web
-copilot-agent web --port 8080
+# Check status (PID, port, token, model count)
+copilot-agent proxy status
+```
+
+### Usage tracking
+
+```bash
+# Show last 7 days of premium/token usage
+copilot-agent quota
+
+# All-time usage
+copilot-agent quota --all
+
+# Last 30 days
+copilot-agent quota --days 30
+```
+
+### Context handoff (compact)
+
+```bash
+# Generate context summary from latest session
+copilot-agent compact
+
+# Save compact to file
+copilot-agent compact --save
+
+# Get a resume prompt to continue the work
+copilot-agent compact --resume-prompt
 ```
 
 ## How it works
@@ -133,6 +173,7 @@ copilot-agent web --port 8080
 4. **Task discovery** — Detects project type and generates relevant maintenance tasks
 5. **Race prevention** — File locking + process tracking prevents concurrent agents in the same directory
 6. **Worktree isolation** — Optional `--worktree` flag for parallel task execution via `git worktree`
+7. **Config layering** — Defaults → `~/.copilot-agent/config.yaml` → `.copilot-agent.yaml` → CLI flags
 
 ## Supported project types
 

package/dist/index.js

@@ -2830,9 +2830,313 @@ function showDiff(sessionId, opts) {
   console.log();
 }
 
+// src/commands/quota.ts
+import chalk4 from "chalk";
+
+// src/lib/quota.ts
+import { join as join9 } from "path";
+import { homedir as homedir7 } from "os";
+var DATA_DIR = join9(homedir7(), ".copilot-agent");
+var USAGE_FILE = join9(DATA_DIR, "usage.jsonl");
+function buildUsageSummary(days) {
+  const sessions = listAllSessions(500);
+  const cutoff = days ? Date.now() - days * 864e5 : 0;
+  const filtered = sessions.filter((s) => s.mtime >= cutoff);
+  const summary = {
+    total: { sessions: 0, premium: 0, tokens: 0, turns: 0, durationMs: 0 },
+    copilot: { sessions: 0, premium: 0, tokens: 0 },
+    claude: { sessions: 0, premium: 0, tokens: 0 },
+    byDay: {}
+  };
+  for (const s of filtered) {
+    const report = getAgentSessionReport(s.id, s.agent);
+    if (!report) continue;
+    summary.total.sessions++;
+    summary.total.premium += report.premiumRequests;
+    summary.total.tokens += report.outputTokens;
+    summary.total.turns += report.assistantTurns;
+    summary.total.durationMs += report.durationMs;
+    const bucket = s.agent === "claude" ? summary.claude : summary.copilot;
+    bucket.sessions++;
+    bucket.premium += report.premiumRequests;
+    bucket.tokens += report.outputTokens;
+    const day = new Date(s.mtime).toISOString().slice(0, 10);
+    if (!summary.byDay[day]) summary.byDay[day] = { premium: 0, tokens: 0, sessions: 0 };
+    summary.byDay[day].premium += report.premiumRequests;
+    summary.byDay[day].tokens += report.outputTokens;
+    summary.byDay[day].sessions++;
+  }
+  return summary;
+}
+function formatTokens(n) {
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
+  return String(n);
+}
+function formatDurationShort(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/commands/quota.ts
+function registerQuotaCommand(program2) {
+  program2.command("quota").description("Track premium requests, tokens, and usage over time").option("-d, --days <n>", "Number of days to show", "7").option("--all", "Show all-time usage").action((opts) => {
+    const days = opts.all ? void 0 : parseInt(opts.days, 10);
+    const label = days ? `Last ${days} days` : "All time";
+    const summary = buildUsageSummary(days);
+    console.log();
+    console.log(chalk4.bold.cyan(`  \u2B21 Usage Summary \u2014 ${label}`));
+    console.log(chalk4.dim(`  ${"\u2500".repeat(50)}`));
+    console.log();
+    const t = summary.total;
+    console.log(`  ${chalk4.bold("Sessions")}     ${chalk4.white(String(t.sessions))}`);
+    console.log(`  ${chalk4.bold("Premium")}      ${chalk4.yellow("\u2B21 " + String(t.premium))}`);
+    console.log(`  ${chalk4.bold("Tokens")}       ${chalk4.green(formatTokens(t.tokens))}`);
+    console.log(`  ${chalk4.bold("Turns")}        ${chalk4.white(String(t.turns))}`);
+    console.log(`  ${chalk4.bold("Total time")}   ${chalk4.white(formatDurationShort(t.durationMs))}`);
+    console.log();
+    if (summary.copilot.sessions > 0 || summary.claude.sessions > 0) {
+      console.log(chalk4.bold.cyan("  Per Agent"));
+      console.log(chalk4.dim(`  ${"\u2500".repeat(50)}`));
+      if (summary.copilot.sessions > 0) {
+        const c = summary.copilot;
+        console.log(`  ${chalk4.cyan("copilot")}  ${String(c.sessions).padStart(4)} sessions  ${chalk4.yellow("\u2B21" + String(c.premium).padStart(5))}  ${chalk4.green(formatTokens(c.tokens).padStart(7))} tokens`);
+      }
+      if (summary.claude.sessions > 0) {
+        const c = summary.claude;
+        console.log(`  ${chalk4.yellow("claude ")}  ${String(c.sessions).padStart(4)} sessions  ${chalk4.yellow("\u2B21" + String(c.premium).padStart(5))}  ${chalk4.green(formatTokens(c.tokens).padStart(7))} tokens`);
+      }
+      console.log();
+    }
+    const dayEntries = Object.entries(summary.byDay).sort((a, b) => a[0].localeCompare(b[0]));
+    if (dayEntries.length > 0) {
+      console.log(chalk4.bold.cyan("  Daily Usage"));
+      console.log(chalk4.dim(`  ${"\u2500".repeat(50)}`));
+      const maxPremium = Math.max(...dayEntries.map(([, d]) => d.premium), 1);
+      const barWidth = 24;
+      for (const [day, data] of dayEntries.slice(-14)) {
+        const shortDay = day.slice(5);
+        const filled = Math.round(data.premium / maxPremium * barWidth);
+        const bar2 = chalk4.cyan("\u2588".repeat(filled)) + chalk4.dim("\u2591".repeat(barWidth - filled));
+        console.log(`  ${chalk4.dim(shortDay)} ${bar2} ${chalk4.yellow("\u2B21" + String(data.premium).padStart(4))}  ${chalk4.dim(String(data.sessions) + " sess")}`);
+      }
+      console.log();
+    }
+  });
+}
+
+// src/commands/compact.ts
+import chalk5 from "chalk";
+
+// src/lib/compact.ts
+import { writeFileSync as writeFileSync4, existsSync as existsSync8, mkdirSync as mkdirSync6 } from "fs";
+import { join as join10 } from "path";
+import { homedir as homedir8 } from "os";
+var COMPACT_DIR = join10(homedir8(), ".copilot-agent", "compacts");
+function ensureDir2() {
+  if (!existsSync8(COMPACT_DIR)) mkdirSync6(COMPACT_DIR, { recursive: true });
+}
+function compactSession(sessionId, agent) {
+  const report = getAgentSessionReport(sessionId, agent);
+  if (!report) return null;
+  const project = report.cwd?.split("/").pop() || "unknown";
+  const done = [];
+  for (const task of report.taskCompletions) {
+    done.push(task.split("\n")[0].slice(0, 100));
+  }
+  for (const file of report.filesCreated) {
+    done.push(`Created ${file}`);
+  }
+  for (const file of report.filesEdited) {
+    done.push(`Edited ${file}`);
+  }
+  const remaining = [];
+  if (!report.complete) {
+    remaining.push("Session was interrupted before completion");
+  }
+  for (const err of report.errors) {
+    remaining.push(`Fix: ${err.split("\n")[0].slice(0, 100)}`);
+  }
+  const filesChanged = [
+    ...report.filesCreated.map((f) => `+ ${f}`),
+    ...report.filesEdited.map((f) => `~ ${f}`)
+  ];
+  const commits = report.gitCommits.map((c) => c.split("\n")[0].slice(0, 100));
+  const durationMs = report.durationMs;
+  const durationStr = durationMs < 6e4 ? `${Math.round(durationMs / 1e3)}s` : durationMs < 36e5 ? `${Math.round(durationMs / 6e4)}m` : `${Math.floor(durationMs / 36e5)}h ${Math.round(durationMs % 36e5 / 6e4)}m`;
+  const lines = [];
+  lines.push(`## Session Context (auto-generated)`);
+  lines.push(`**Project:** ${project} | **Agent:** ${report.agent} | **Duration:** ${durationStr}`);
+  lines.push(`**Turns:** ${report.assistantTurns} | **Tokens:** ${report.outputTokens.toLocaleString()} | **Premium:** ${report.premiumRequests}`);
+  lines.push("");
+  if (report.summary) {
+    lines.push(`**Task:** ${report.summary}`);
+    lines.push("");
+  }
+  if (done.length > 0) {
+    lines.push("### \u2705 Completed");
+    for (const d of done) lines.push(`- ${d}`);
+    lines.push("");
+  }
+  if (remaining.length > 0) {
+    lines.push("### \u23F3 Remaining");
+    for (const r of remaining) lines.push(`- ${r}`);
+    lines.push("");
+  }
+  if (commits.length > 0) {
+    lines.push("### Git Commits");
+    for (const c of commits) lines.push(`- ${c}`);
+    lines.push("");
+  }
+  if (filesChanged.length > 0) {
+    lines.push("### Files Changed");
+    for (const f of filesChanged) lines.push(`- ${f}`);
+    lines.push("");
+  }
+  if (report.errors.length > 0) {
+    lines.push("### \u26A0\uFE0F Errors Encountered");
+    for (const e of report.errors.slice(0, 5)) lines.push(`- ${e.split("\n")[0]}`);
+    lines.push("");
+  }
+  const topTools = Object.entries(report.toolUsage).sort((a, b) => b[1] - a[1]).slice(0, 5);
+  if (topTools.length > 0) {
+    lines.push("### Tools Used");
+    for (const [tool, count] of topTools) lines.push(`- ${tool}: ${count}x`);
+    lines.push("");
+  }
+  const markdown = lines.join("\n");
+  return {
+    sessionId,
+    agent: report.agent,
+    project,
+    summary: report.summary || "",
+    done,
+    remaining,
+    filesChanged,
+    commits,
+    errors: report.errors.map((e) => e.split("\n")[0]),
+    stats: {
+      turns: report.assistantTurns,
+      tokens: report.outputTokens,
+      premium: report.premiumRequests,
+      duration: durationStr
+    },
+    markdown
+  };
+}
+function saveCompact(compact) {
+  ensureDir2();
+  const filename = `${compact.sessionId.slice(0, 12)}.md`;
+  const filepath = join10(COMPACT_DIR, filename);
+  writeFileSync4(filepath, compact.markdown, "utf-8");
+  return filepath;
+}
+function buildResumePrompt(compact) {
+  const parts = [];
+  parts.push("Continue the previous task. Here is the context from the interrupted session:");
+  parts.push("");
+  if (compact.summary) parts.push(`Task: ${compact.summary}`);
+  if (compact.done.length > 0) {
+    parts.push("Already completed:");
+    for (const d of compact.done.slice(0, 10)) parts.push(`- ${d}`);
+  }
+  if (compact.remaining.length > 0) {
+    parts.push("Still needs to be done:");
+    for (const r of compact.remaining) parts.push(`- ${r}`);
+  }
+  if (compact.errors.length > 0) {
+    parts.push("Errors to address:");
+    for (const e of compact.errors.slice(0, 3)) parts.push(`- ${e}`);
+  }
+  parts.push("");
+  parts.push("Please continue where the previous session left off.");
+  return parts.join("\n");
+}
+
+// src/commands/compact.ts
+function registerCompactCommand(program2) {
+  program2.command("compact [session-id]").description("Generate context summary from a session for handoff/resume").option("--save", "Save compact to ~/.copilot-agent/compacts/").option("--resume-prompt", "Output a resume prompt for the next session").option("-a, --agent <type>", "Agent type: copilot | claude").action((sessionId, opts) => {
+    try {
+      showCompact(sessionId, opts);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(chalk5.red(`  \u2717 ${msg}`));
+    }
+  });
+}
+function showCompact(sessionId, opts) {
+  if (!sessionId) {
+    const sessions = listAllSessions(10);
+    if (sessions.length === 0) {
+      console.log(chalk5.dim("  No sessions found"));
+      return;
+    }
+    sessionId = sessions[0].id;
+    console.log(chalk5.dim(`  Using latest session: ${sessionId.slice(0, 12)}\u2026
+`));
+  }
+  const compact = compactSession(sessionId, opts.agent);
+  if (!compact) {
+    console.log(chalk5.red(`  \u2717 Session not found: ${sessionId}`));
+    return;
+  }
+  if (opts.resumePrompt) {
+    console.log(buildResumePrompt(compact));
+    return;
+  }
+  const agentTag = compact.agent === "claude" ? chalk5.yellow("[claude]") : chalk5.cyan("[copilot]");
+  console.log(chalk5.bold.cyan(`  \u{1F4CB} Session Compact \u2014 ${compact.project}`) + ` ${agentTag}`);
+  console.log(chalk5.dim(`  ${compact.sessionId}`));
+  console.log(chalk5.dim(`  ${"\u2500".repeat(50)}`));
+  console.log();
+  console.log(`  ${chalk5.bold("Duration")}  ${compact.stats.duration}    ${chalk5.bold("Turns")}  ${compact.stats.turns}    ${chalk5.bold("Tokens")}  ${compact.stats.tokens.toLocaleString()}    ${chalk5.bold("Premium")}  ${chalk5.yellow("\u2B21" + compact.stats.premium)}`);
+  console.log();
+  if (compact.summary) {
+    console.log(chalk5.bold("  Task:") + ` ${compact.summary}`);
+    console.log();
+  }
+  if (compact.done.length > 0) {
+    console.log(chalk5.bold.green("  \u2705 Completed:"));
+    for (const d of compact.done.slice(0, 15)) {
+      console.log(chalk5.green(`    \u25CF ${d}`));
+    }
+    if (compact.done.length > 15) console.log(chalk5.dim(`    ... +${compact.done.length - 15} more`));
+    console.log();
+  }
+  if (compact.remaining.length > 0) {
+    console.log(chalk5.bold.yellow("  \u23F3 Remaining:"));
+    for (const r of compact.remaining) {
+      console.log(chalk5.yellow(`    \u25CB ${r}`));
+    }
+    console.log();
+  }
+  if (compact.commits.length > 0) {
+    console.log(chalk5.bold.cyan("  Commits:"));
+    for (const c of compact.commits.slice(0, 8)) {
+      console.log(chalk5.cyan(`    \u25CF ${c}`));
+    }
+    console.log();
+  }
+  if (compact.errors.length > 0) {
+    console.log(chalk5.bold.red("  \u26A0\uFE0F Errors:"));
+    for (const e of compact.errors.slice(0, 5)) {
+      console.log(chalk5.red(`    \u2717 ${e}`));
+    }
+    console.log();
+  }
+  if (opts.save) {
+    const path = saveCompact(compact);
+    console.log(chalk5.green(`  \u2714 Saved to ${path}`));
+    console.log();
+  }
+}
+
 // src/index.ts
 var program = new Command();
-program.name("copilot-agent").version("0.9.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.10.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);
@@ -2844,5 +3148,7 @@ registerWebCommand(program);
 registerConfigCommand(program);
 registerProxyCommand(program);
 registerDiffCommand(program);
+registerQuotaCommand(program);
+registerCompactCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map