agentpack-cli 0.3.24__tar.gz → 0.3.26__tar.gz

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.24
+Version: 0.3.26
 Summary: Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows.
 Project-URL: Homepage, https://github.com/vishal2612200/agentpack
 Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
@@ -61,7 +61,9 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
   <a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
   <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
@@ -69,6 +71,8 @@ Description-Content-Type: text/markdown
 <p align="center">
   <code>local preflight</code>
   <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
   <code>tests + commands</code>
   <code>receipts</code>
   <code>no cloud index</code>
@@ -83,6 +87,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
 -> compact context before the agent edits
@@ -101,7 +106,9 @@ No cloud index. No embeddings. No model calls for scan/rank/pack. Just local rep
 
 It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
 
-It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
 
 ## Quick Start
 
@@ -145,6 +152,7 @@ agentpack route --task "fix billing webhook retry handling"
 ```
 
 AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
 
@@ -154,13 +162,16 @@ agentpack pack --task auto
 ```
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
 
 ## What AgentPack Gives Your Agent
 
 - ranked files for current task
+- skill and rule routing for current task
 - likely tests and commands
 - repo rules and agent instructions
 - compact context pack under budget
+- cached summaries for faster repeated orientation
 - omitted-file receipts for review
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
@@ -229,7 +240,8 @@ See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`
 | Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
 | Coding agents | Edit code | AgentPack prepares context before editing |
 | IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
-| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
 
 ## When To Use It
 
@@ -241,6 +253,8 @@ Use AgentPack when:
 - CI or PR review needs reproducible context
 - agents waste tool calls opening irrelevant files
 - tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
 
 Do not use AgentPack when:
 
@@ -252,9 +266,9 @@ Do not use AgentPack when:
 
 ## How It Works
 
-AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
 
-It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
 
 Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
 
@@ -307,7 +321,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.24`.
+Alpha: `0.3.25`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/README.md

@@ -14,7 +14,9 @@
 
 <p align="center">
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
   <a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
   <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
@@ -22,6 +24,8 @@
 <p align="center">
   <code>local preflight</code>
   <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
   <code>tests + commands</code>
   <code>receipts</code>
   <code>no cloud index</code>
@@ -36,6 +40,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
 -> compact context before the agent edits
@@ -54,7 +59,9 @@ No cloud index. No embeddings. No model calls for scan/rank/pack. Just local rep
 
 It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
 
-It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
 
 ## Quick Start
 
@@ -98,6 +105,7 @@ agentpack route --task "fix billing webhook retry handling"
 ```
 
 AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
 
@@ -107,13 +115,16 @@ agentpack pack --task auto
 ```
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
 
 ## What AgentPack Gives Your Agent
 
 - ranked files for current task
+- skill and rule routing for current task
 - likely tests and commands
 - repo rules and agent instructions
 - compact context pack under budget
+- cached summaries for faster repeated orientation
 - omitted-file receipts for review
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
@@ -182,7 +193,8 @@ See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`
 | Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
 | Coding agents | Edit code | AgentPack prepares context before editing |
 | IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
-| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
 
 ## When To Use It
 
@@ -194,6 +206,8 @@ Use AgentPack when:
 - CI or PR review needs reproducible context
 - agents waste tool calls opening irrelevant files
 - tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
 
 Do not use AgentPack when:
 
@@ -205,9 +219,9 @@ Do not use AgentPack when:
 
 ## How It Works
 
-AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
 
-It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
 
 Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
 
@@ -260,7 +274,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.24`.
+Alpha: `0.3.25`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.24"
+version = "0.3.26"
 description = "Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — task-aware context packing for AI coding agents."""
 
-__version__ = "0.3.24"
+__version__ = "0.3.26"

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/application/pack_service.py

@@ -9,6 +9,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
+from agentpack import __version__
 from agentpack.core.config import load_config
 from agentpack.core.changed_paths import clear_changed_paths, read_changed_paths
 from agentpack.core.ignore import DEFAULT_AGENTIGNORE, load_spec
@@ -16,6 +17,7 @@ from agentpack.core.scanner import scan, scan_incremental
 from agentpack.core.snapshot import build_snapshot, save_snapshot, load_snapshot
 from agentpack.core.diff import diff_snapshots
 from agentpack.core import git
+from agentpack.core.command_surface import refresh_commands
 from agentpack.core.context_pack import enrich_call_site_scores, select_files, save_pack_metadata, load_pack_metadata
 from agentpack.core.execution_state import build_execution_state, compact_execution_state
 from agentpack.core.models import (
@@ -1575,7 +1577,12 @@ def _build_freshness_metadata(
 ) -> dict[str, Any]:
     dirty = git.dirty_files(root) if git.is_git_repo(root) else set()
     metadata: dict[str, Any] = {
+        "agentpack_version": __version__,
         "generated_at": datetime.now(timezone.utc).isoformat(),
+        "cwd": str(Path.cwd()),
+        "git_root": str(root),
+        "worktree_path": str(root),
+        "source_command": refresh_commands(request.agent).primary,
         "task_source": request.task_source,
         "changed_files_source": plan.changed_files_source,
         "snapshot_root_hash": snapshot_root_hash,

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/cli.py

@@ -42,6 +42,7 @@ from agentpack.commands import (
     task_cmd,
     threads,
     tune,
+    upgrade,
     verify_wheel,
     watch,
     wrap,
@@ -95,6 +96,7 @@ for mod in [
     diagnose_selection,
     eval_cmd,
     tune,
+    upgrade,
     watch,
     claude_cmd,
     benchmark,

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/benchmark.py

@@ -166,6 +166,7 @@ class E2EResult:
     expected_files_touched: list[str]
     missing_expected_edits: list[str]
     unexpected_files_touched: list[str]
+    agentpack_noise: list[str]
     agent_log_path: str
     test_log_path: str
     workdir: str
@@ -3226,6 +3227,7 @@ def _e2e_strategy_metrics(records: list[dict[str, Any]], strategy: str) -> dict[
     return {
         "runs": float(len(subset)),
         "success_rate": sum(1 for row in subset if row.get("passed")) / len(subset),
+        "noise_rate": sum(1 for row in subset if row.get("agentpack_noise")) / len(subset),
         "expected_touch_rate": expected_touch_rate,
         "avg_input_tokens": avg("input_tokens"),
         "avg_output_tokens": avg("agent_output_tokens"),
@@ -3285,6 +3287,7 @@ def _print_e2e_ab_table(
     table.add_row("runs", f"{base['runs']:.0f}", f"{treat['runs']:.0f}", "-")
     table.add_row("task success", f"{base['success_rate']:.0%}", f"{treat['success_rate']:.0%}", f"{deltas['success_rate_pp']:+.1f} pp")
     table.add_row("expected file touched", f"{base['expected_touch_rate']:.0%}", f"{treat['expected_touch_rate']:.0%}", "-")
+    table.add_row("AgentPack noise cases", f"{base['noise_rate']:.0%}", f"{treat['noise_rate']:.0%}", "-")
     table.add_row("tool calls", f"{base['avg_tool_calls']:.1f}", f"{treat['avg_tool_calls']:.1f}", f"{deltas['tool_calls_saved']:+.1f}")
     table.add_row("tokens", f"{base['avg_total_tokens']:,.0f}", f"{treat['avg_total_tokens']:,.0f}", f"{deltas['tokens_saved']:+,.0f}")
     table.add_row("cost", f"${base['avg_total_cost_usd']:.4f}", f"${treat['avg_total_cost_usd']:.4f}", _fmt_signed_usd(deltas["token_cost_saved_usd"]))
@@ -3317,6 +3320,7 @@ def _e2e_ab_markdown(
         f"| runs | {base['runs']:.0f} | {treat['runs']:.0f} | - |",
         f"| task success | {base['success_rate']:.0%} | {treat['success_rate']:.0%} | {deltas['success_rate_pp']:+.1f} pp |",
         f"| expected file touched | {base['expected_touch_rate']:.0%} | {treat['expected_touch_rate']:.0%} | - |",
+        f"| AgentPack noise cases | {base['noise_rate']:.0%} | {treat['noise_rate']:.0%} | - |",
         f"| tool calls | {base['avg_tool_calls']:.1f} | {treat['avg_tool_calls']:.1f} | {deltas['tool_calls_saved']:+.1f} |",
         f"| tokens | {base['avg_total_tokens']:,.0f} | {treat['avg_total_tokens']:,.0f} | {deltas['tokens_saved']:+,.0f} |",
         f"| token cost | ${base['avg_total_cost_usd']:.4f} | ${treat['avg_total_cost_usd']:.4f} | {_fmt_signed_usd(deltas['token_cost_saved_usd'])} |",
@@ -3410,6 +3414,7 @@ def _run_e2e_case(
     expected_touched = _expected_files_touched(public_changed, case.expected_edit_paths)
     missing_expected = sorted(set(case.expected_edit_paths) - set(expected_touched))
     unexpected_touched = _unexpected_files_touched(public_changed, case.expected_edit_paths)
+    agentpack_noise = _agentpack_noise(strategy, unexpected_touched, missing_expected, public_changed)
     time_to_first_expected_file = _time_to_first_expected_file(repo, expected_touched, agent_start_epoch)
     tool_calls = _estimate_agent_tool_calls(agent)
     duration = time.perf_counter() - start
@@ -3442,6 +3447,7 @@ def _run_e2e_case(
         expected_files_touched=expected_touched,
         missing_expected_edits=missing_expected,
         unexpected_files_touched=unexpected_touched,
+        agentpack_noise=agentpack_noise,
         agent_log_path=str(agent_log_path),
         test_log_path=str(test_log_path),
         workdir=str(work_root),
@@ -3495,6 +3501,20 @@ def _unexpected_files_touched(changed: list[str], expected_edit_paths: list[str]
     return sorted(path for path in changed if path not in expected)
 
 
+def _agentpack_noise(strategy: str, unexpected: list[str], missing_expected: list[str], changed: list[str]) -> list[str]:
+    if "agentpack" not in strategy:
+        return []
+    noise: list[str] = []
+    if unexpected:
+        noise.append(f"unexpected edits: {', '.join(unexpected[:5])}")
+    if missing_expected:
+        noise.append(f"missed expected files: {', '.join(missing_expected[:5])}")
+    generated = [path for path in changed if _is_generated_e2e_path(path)]
+    if generated:
+        noise.append(f"generated AgentPack files changed: {', '.join(generated[:5])}")
+    return noise
+
+
 def _process_output_tokens(result: subprocess.CompletedProcess[str]) -> int:
     return estimate_tokens("\n".join(part for part in (result.stdout, result.stderr) if part))
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/ci_cmd.py

@@ -79,6 +79,8 @@ jobs:
     if: github.event_name == 'push'
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
@@ -86,5 +88,5 @@ jobs:
         with:
           node-version: "20"
       - run: python -m pip install -e ".[dev]" build
-      - run: python -m agentpack.cli release-check
+      - run: python -m agentpack.cli release-check --profile auto
 """

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/doctor.py

@@ -17,6 +17,7 @@ from agentpack.integrations.global_install import (
     _detect_rc_file,
 )
 from agentpack.commands._shared import console, _root
+from agentpack.core.command_surface import available_cli_commands, installed_cli_status, refresh_commands
 from agentpack.core.context_pack import load_pack_metadata
 from agentpack.core.ignore import agentignore_sync_status, format_import_summary
 from agentpack.core.task_freshness import task_freshness
@@ -45,7 +46,12 @@ def register(app: typer.Typer) -> None:
 
         # --- CLI binary ---
         console.print("[bold]CLI[/]")
-        binary = shutil.which("agentpack")
+        cli_status = installed_cli_status()
+        binary = cli_status.get("binary") or shutil.which("agentpack")
+        console.print(f"  [green]✓[/] importable AgentPack version: {cli_status.get('agentpack_version')}")
+        importable = cli_status.get("importable_commands") or []
+        if importable:
+            console.print(f"  [green]✓[/] importable commands: {', '.join(str(cmd) for cmd in importable)}")
         if binary:
             try:
                 result = subprocess.run(["agentpack", "--version"], capture_output=True, text=True)
@@ -56,6 +62,15 @@ def register(app: typer.Typer) -> None:
         else:
             console.print("  [red]✗[/] agentpack not on PATH — run: pipx install agentpack-cli")
             ok = False
+        help_commands = cli_status.get("help_commands") or []
+        if help_commands:
+            console.print(f"  [green]✓[/] installed CLI commands: {', '.join(str(cmd) for cmd in help_commands)}")
+        if binary and "guard" not in set(str(cmd) for cmd in help_commands) and "guard" in set(available_cli_commands()):
+            console.print(
+                "  [yellow]![/] installed CLI command surface may be stale; "
+                f"exact repair: {cli_status.get('repair_command')}"
+            )
+            ok = False
 
         try:
             root = _root()
@@ -147,8 +162,19 @@ def register(app: typer.Typer) -> None:
                         "MCP get_context auto-refreshes this, or run: agentpack pack --task auto"
                     )
                     ok = False
+                meta = load_pack_metadata(root) or {}
+                freshness = meta.get("freshness") or {}
+                if freshness:
+                    console.print(
+                        "  [green]✓[/] context provenance: "
+                        f"task_source={freshness.get('task_source', 'unknown')}, "
+                        f"git_root={freshness.get('git_root', root)}, "
+                        f"worktree={freshness.get('worktree_path', root)}, "
+                        f"branch={freshness.get('git_branch', 'unknown')}, "
+                        f"generated={freshness.get('generated_at', 'unknown')}"
+                    )
             else:
-                console.print("  [yellow]![/] No context pack yet — write .agentpack/task.md, then run: agentpack pack --task auto")
+                console.print(f"  [yellow]![/] No context pack yet — write .agentpack/task.md, then run: {refresh_commands(agent).context_missing}")
 
         # --- Agent-specific config ---
         console.print("\n[bold]Agent config[/]")
@@ -249,6 +275,14 @@ def register(app: typer.Typer) -> None:
                 pass
         if not _local_has_mcp and not _global_has_mcp:
             console.print("  [yellow]![/] MCP server not registered — mcp__agentpack__* tools unavailable")
+            console.print("  [yellow]![/] exact repair: agentpack install --agent claude")
+            ok = False
+        else:
+            console.print(
+                "  [green]✓[/] expected MCP tools: "
+                "readiness, route_task, pack_context, get_context, refresh, get_stats"
+            )
+            console.print("  [green]✓[/] live exposure proof: call MCP tool `readiness` from the agent host")
 
         # --- Agent integration matrix ---
         console.print("\n[bold]Agent integration audit[/]")
@@ -268,8 +302,7 @@ def register(app: typer.Typer) -> None:
                 ok = False
             if not selected_ok:
                 console.print(
-                    f"    [yellow]![/] executable guard repair: "
-                    f"agentpack guard --agent {selected} --repair-stale --refresh-context"
+                    f"    [yellow]![/] exact repair: {refresh_commands(selected).repair}"
                 )
 
         # --- Concurrent threads ---

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/next_cmd.py

@@ -7,6 +7,7 @@ import typer
 from agentpack.commands._shared import console, _root, run_refresh
 from agentpack.commands.diagnose_selection import build_selection_diagnosis, _markdown_report
 from agentpack.commands.guard import _context_is_fresh
+from agentpack.core.command_surface import refresh_commands
 from agentpack.core.config import load_config
 from agentpack.core.context_pack import load_pack_metadata
 from agentpack.core.loop_protocol import load_loop_state
@@ -34,7 +35,7 @@ def register(app: typer.Typer) -> None:
             stats = run_refresh(root, "auto", "balanced", 0)
             if stats:
                 recommendations = [{"kind": "fixed", "command": "agentpack next", "reason": "refreshed stale context"}]
-                fixes.append({"kind": "stale_context", "command": "agentpack guard --agent auto --repair-stale --refresh-context", "returncode": 0})
+                fixes.append({"kind": "stale_context", "command": refresh_commands("auto").repair, "returncode": 0})
         payload = {"recommendations": recommendations, "fixes": fixes, "ok": not recommendations}
         if json_output:
             typer.echo(json.dumps(payload, indent=2, sort_keys=True))
@@ -58,7 +59,7 @@ def _recommendations(root) -> list[dict[str, str]]:
         items.append({"kind": "missing_task", "command": 'agentpack start "describe the task"', "reason": "no concrete task is set"})
     fresh, reason = _context_is_fresh(root)
     if not fresh:
-        items.append({"kind": "stale_context", "command": "agentpack guard --agent auto --repair-stale --refresh-context", "reason": reason})
+        items.append({"kind": "stale_context", "command": refresh_commands("auto").repair, "reason": reason})
     if _has_thread_conflicts(root):
         items.append({"kind": "thread_conflict", "command": "agentpack threads --conflicts", "reason": "active threads overlap on this branch/worktree"})
     if _pack_looks_noisy(root):
@@ -138,7 +139,7 @@ def _fix_all_safe(root, recommendations: list[dict[str, str]]) -> tuple[list[dic
         stats = run_refresh(root, "auto", "balanced", 0)
         fixes.append({
             "kind": "stale_context",
-            "command": "agentpack guard --agent auto --repair-stale --refresh-context",
+            "command": refresh_commands("auto").repair,
             "returncode": 0 if stats else 1,
         })
         recommendations = _recommendations(root)

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/pack.py

@@ -17,6 +17,7 @@ from agentpack.analysis.ranking import suggest_task_rewrite
 from agentpack.application.pack_service import PackRequest, PackService, PackResult
 from agentpack.commands._shared import console, _root, _file_hash, _now_iso
 from agentpack.core.changed_paths import record_changed_paths
+from agentpack.core.command_surface import refresh_commands
 from agentpack.core.modes import MODE_HELP, invalid_mode_message, is_requested_mode
 from agentpack.integrations.agents import check_agent_integration, install_agent_integration
 from agentpack.session.state import TASK_FILE, load_session, save_session, log_activity
@@ -314,7 +315,7 @@ def _agent_integration_warnings(result: PackResult) -> list[str]:
     if not failing:
         return []
     return [
-        f"Agent integration needs repair ({agent}); run `agentpack guard --agent {agent} --repair-stale --refresh-context`."
+        f"Agent integration needs repair ({agent}); run `{refresh_commands(agent).repair}`."
     ]
 
 
@@ -337,7 +338,7 @@ def _auto_repair_stale_agent_rules(agent: str) -> None:
     except Exception as exc:
         console.print(
             f"[yellow]Stale AgentPack integration detected for {agent}; "
-            f"run `agentpack guard --agent {agent} --repair-stale --refresh-context`. ({exc})[/]"
+            f"run `{refresh_commands(agent).repair}`. ({exc})[/]"
         )
 
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/release_check.py

@@ -145,11 +145,44 @@ def _pytest_args_for_profile(root: Path, profile: str) -> list[str]:
 
 
 def _changed_files(root: Path) -> list[str]:
+    ci_changed = _github_event_changed_files(root)
+    if ci_changed:
+        return ci_changed
     tracked = _git_lines(root, ["git", "diff", "--name-only", "HEAD", "--"])
     untracked = _git_lines(root, ["git", "ls-files", "--others", "--exclude-standard"])
     return sorted(set(tracked + untracked))
 
 
+def _github_event_changed_files(root: Path) -> list[str]:
+    event_path = os.environ.get("GITHUB_EVENT_PATH")
+    event_name = os.environ.get("GITHUB_EVENT_NAME", "")
+    if not event_path:
+        return []
+    try:
+        payload = json.loads(Path(event_path).read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return []
+    if not isinstance(payload, dict):
+        return []
+
+    base = ""
+    head = ""
+    if event_name == "push":
+        base = str(payload.get("before") or "")
+        head = str(payload.get("after") or os.environ.get("GITHUB_SHA") or "")
+    elif event_name == "pull_request":
+        pull_request = payload.get("pull_request")
+        if isinstance(pull_request, dict):
+            base_ref = pull_request.get("base")
+            head_ref = pull_request.get("head")
+            if isinstance(base_ref, dict) and isinstance(head_ref, dict):
+                base = str(base_ref.get("sha") or "")
+                head = str(head_ref.get("sha") or "")
+    if not base or not head or set(base) == {"0"}:
+        return []
+    return _git_lines(root, ["git", "diff", "--name-only", base, head, "--"])
+
+
 def _git_lines(root: Path, command: list[str]) -> list[str]:
     result = subprocess.run(command, cwd=root, capture_output=True, text=True)
     if result.returncode != 0:

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/start_cmd.py

@@ -6,6 +6,7 @@ from pathlib import Path
 import typer
 
 from agentpack.commands._shared import console, _root
+from agentpack.core.command_surface import refresh_command_args
 from agentpack.core.context_pack import load_pack_metadata
 from agentpack.core.thread_context import resolve_thread_option, thread_paths
 from agentpack.integrations.platform import cli_module_argv
@@ -42,9 +43,7 @@ def register(app: typer.Typer) -> None:
             if workspace:
                 argv.extend(["--workspace", workspace])
         else:
-            argv = cli_module_argv("guard", "--agent", agent, "--repair-stale", "--refresh-context", "--mode", mode)
-            if budget:
-                argv.extend(["--budget", str(budget)])
+            argv = cli_module_argv(*refresh_command_args(agent, mode, budget))
         if thread_id:
             argv.extend(["--thread", thread_id])
         result = subprocess.run(argv, cwd=root)

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/status.py

@@ -4,6 +4,7 @@ import typer
 import shutil
 
 from agentpack.core.config import load_config
+from agentpack.core.command_surface import refresh_commands
 from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
 from agentpack.core.snapshot import build_snapshot
@@ -98,4 +99,4 @@ def _print_deep_health(root, meta: dict | None) -> None:
         if not check.ok:
             failing.append(check)
     if failing:
-        console.print(f"  [yellow]![/] Guard repair: agentpack guard --agent {agent} --repair-stale --refresh-context")
+        console.print(f"  [yellow]![/] Repair: {refresh_commands(agent).repair}")

{agentpack_cli-0.3.24 → agentpack_cli-0.3.26}/src/agentpack/commands/task_cmd.py

@@ -7,6 +7,7 @@ from pathlib import Path
 import typer
 
 from agentpack.commands._shared import console, _root
+from agentpack.core.command_surface import refresh_command_args
 from agentpack.core.thread_context import resolve_thread_option, thread_paths
 from agentpack.integrations.platform import cli_module_argv
 from agentpack.session.state import TASK_FILE
@@ -47,7 +48,7 @@ def set_task(
     task_text: str = typer.Argument(..., help="Task text to write."),
     thread: str = typer.Option("", "--thread", help="Use thread-scoped task state."),
     pack: bool = typer.Option(False, "--pack", help="Run agentpack pack after writing the task."),
-    guard: bool = typer.Option(False, "--guard", help="Run agentpack guard --repair-stale --refresh-context after writing."),
+    guard: bool = typer.Option(False, "--guard", help="Run the installed refresh/repair command after writing."),
     agent: str = typer.Option("auto", "--agent", help="Agent to pass to pack/guard."),
     mode: str = typer.Option("balanced", "--mode", help="Pack/guard mode."),
 ) -> None:
@@ -63,7 +64,7 @@ def set_task(
 
     thread_id = _thread_id(root, thread)
     if guard:
-        _run_cli(["guard", "--agent", agent, "--repair-stale", "--refresh-context", "--mode", mode], thread_id=thread_id)
+        _run_cli(refresh_command_args(agent, mode), thread_id=thread_id)
     elif pack:
         _run_cli(["pack", "--agent", agent, "--task", "auto", "--mode", mode], thread_id=thread_id)
 

agentpack_cli-0.3.26/src/agentpack/commands/upgrade.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import typer
+
+from agentpack.commands._shared import console, _root
+from agentpack.commands.install import _install_slash_command, _print_install_results
+from agentpack.integrations.agents import SUPPORTED_AGENTS, expand_agents, install_agent_integration
+
+
+def register(app: typer.Typer) -> None:
+    @app.command()
+    def upgrade(
+        agent: str = typer.Option(
+            "auto",
+            "--agent",
+            help=f"Agent integration to refresh after package upgrade ({' | '.join(SUPPORTED_AGENTS)}).",
+        ),
+    ) -> None:
+        """Refresh the detected AgentPack IDE/agent integration after upgrading the package."""
+        root = _root()
+        if agent not in SUPPORTED_AGENTS:
+            console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(SUPPORTED_AGENTS)}[/]")
+            raise typer.Exit(1)
+
+        agents = expand_agents(agent, root)
+        if agent == "auto":
+            console.print(f"[dim]Auto-detected agent: {agents[0]}[/]")
+
+        for selected in agents:
+            console.print(f"\n[bold]{selected}[/]")
+            results = install_agent_integration(
+                root,
+                selected,
+                install_slash_command=_install_slash_command,
+            )
+            _print_install_results(selected, results)
+
+        console.print("\n[bold green]Upgrade integration refresh complete.[/]")