agentpack-cli 0.1.14__tar.gz → 0.1.16__tar.gz

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.14
+Version: 0.1.16
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.11).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
+> **Status: alpha (v0.1.17).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
 >
 > **Platform note:** macOS and Linux are fully supported. Windows support is not yet implemented (git hooks use POSIX shell; the Claude Code session hooks use `python3`/`rm -f`). Contributions welcome.
 
@@ -297,7 +297,7 @@ Configures:
 - `CLAUDE.md` — tells Claude to read the context pack before each task
 - `.claude/settings.json` — two hooks:
   - `SessionStart`: clears injection sentinel so first prompt gets context
-  - `UserPromptSubmit`: auto-repacks when stale, injects context once per session
+  - `UserPromptSubmit`: detects repo changes via content hash (not file mtime), triggers background repack using your prompt as the task description so keyword scoring matches the current conversation
 
 After this, context is injected automatically into every Claude Code session. No `/agentpack` command needed — it just happens.
 
@@ -354,7 +354,7 @@ The Skill descriptor activates AgentPack automatically — no `--task` flag requ
 |---|---|---|---|---|---|
 | Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` |
 | Auto-inject on startup | ✅ `UserPromptSubmit` hook | ✅ `alwaysApply` | ✅ rules file | ✅ `AGENTS.md` | ✅ Skill auto-activation |
-| Auto-repack when stale | ✅ hook (snapshot hash, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
+| Auto-repack when stale | ✅ hook (content hash via `root_hash`, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
 | Manual repack shortcut | ✅ `/agentpack` slash cmd | ✅ VS Code task | ✅ VS Code task | `agentpack pack` | ✅ VS Code task |
 
 ---
@@ -640,7 +640,7 @@ Options:
 
 ### `agentpack session` _(removed)_
 
-Session management was removed in v0.1.11. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
+Session management was removed in v0.1.12. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
 
 ---
 
@@ -826,13 +826,13 @@ Tokens after ignore:  210,000
 
 ### `agentpack stats`
 
-Show session state and token statistics for the last pack.
+Show session state, token statistics, and selection accuracy for the last pack.
 
 ```bash
 agentpack stats
 ```
 
-When a session is active, shows session panel (agent, mode, started, refresh count) above token stats. Also lists top included files by score.
+When a session is active, shows session panel (agent, mode, started, refresh count) above token stats. Also lists top included files by score and avg recall/precision/F1 over the last 10 runs.
 
 ---
 
@@ -910,8 +910,10 @@ agentpack monitor --clear
 | Direct dependency of changed file | +50 |
 | Reverse dependency | +40 |
 | Has related tests | +35 |
+| Knowledge/architecture doc (DECISIONS.md, ADR-*.md, ARCHITECTURE.md, docs/adr/, docs/decisions/, docs/rfcs/) | +30 |
 | Config file | +25 |
 | Recently modified | +20 |
+| High churn (top 10% by commit frequency) | +15 |
 | Large unrelated file | −50 |
 | Ignored/binary | −100 |
 
@@ -960,8 +962,10 @@ content_keyword_max       = 60
 direct_dep                = 50
 reverse_dep               = 40
 related_test              = 35
+knowledge_file            = 30   # DECISIONS.md, ADR-*.md, ARCHITECTURE.md, docs/adr/ etc.
 config_file               = 25
 recently_modified         = 20
+churn_high                = 15   # top 10% by commit frequency
 large_unrelated_penalty   = -50
 ignored_penalty           = -100
 ```

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.11).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
+> **Status: alpha (v0.1.17).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
 >
 > **Platform note:** macOS and Linux are fully supported. Windows support is not yet implemented (git hooks use POSIX shell; the Claude Code session hooks use `python3`/`rm -f`). Contributions welcome.
 
@@ -258,7 +258,7 @@ Configures:
 - `CLAUDE.md` — tells Claude to read the context pack before each task
 - `.claude/settings.json` — two hooks:
   - `SessionStart`: clears injection sentinel so first prompt gets context
-  - `UserPromptSubmit`: auto-repacks when stale, injects context once per session
+  - `UserPromptSubmit`: detects repo changes via content hash (not file mtime), triggers background repack using your prompt as the task description so keyword scoring matches the current conversation
 
 After this, context is injected automatically into every Claude Code session. No `/agentpack` command needed — it just happens.
 
@@ -315,7 +315,7 @@ The Skill descriptor activates AgentPack automatically — no `--task` flag requ
 |---|---|---|---|---|---|
 | Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` |
 | Auto-inject on startup | ✅ `UserPromptSubmit` hook | ✅ `alwaysApply` | ✅ rules file | ✅ `AGENTS.md` | ✅ Skill auto-activation |
-| Auto-repack when stale | ✅ hook (snapshot hash, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
+| Auto-repack when stale | ✅ hook (content hash via `root_hash`, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
 | Manual repack shortcut | ✅ `/agentpack` slash cmd | ✅ VS Code task | ✅ VS Code task | `agentpack pack` | ✅ VS Code task |
 
 ---
@@ -601,7 +601,7 @@ Options:
 
 ### `agentpack session` _(removed)_
 
-Session management was removed in v0.1.11. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
+Session management was removed in v0.1.12. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
 
 ---
 
@@ -787,13 +787,13 @@ Tokens after ignore:  210,000
 
 ### `agentpack stats`
 
-Show session state and token statistics for the last pack.
+Show session state, token statistics, and selection accuracy for the last pack.
 
 ```bash
 agentpack stats
 ```
 
-When a session is active, shows session panel (agent, mode, started, refresh count) above token stats. Also lists top included files by score.
+When a session is active, shows session panel (agent, mode, started, refresh count) above token stats. Also lists top included files by score and avg recall/precision/F1 over the last 10 runs.
 
 ---
 
@@ -871,8 +871,10 @@ agentpack monitor --clear
 | Direct dependency of changed file | +50 |
 | Reverse dependency | +40 |
 | Has related tests | +35 |
+| Knowledge/architecture doc (DECISIONS.md, ADR-*.md, ARCHITECTURE.md, docs/adr/, docs/decisions/, docs/rfcs/) | +30 |
 | Config file | +25 |
 | Recently modified | +20 |
+| High churn (top 10% by commit frequency) | +15 |
 | Large unrelated file | −50 |
 | Ignored/binary | −100 |
 
@@ -921,8 +923,10 @@ content_keyword_max       = 60
 direct_dep                = 50
 reverse_dep               = 40
 related_test              = 35
+knowledge_file            = 30   # DECISIONS.md, ADR-*.md, ARCHITECTURE.md, docs/adr/ etc.
 config_file               = 25
 recently_modified         = 20
+churn_high                = 15   # top 10% by commit frequency
 large_unrelated_penalty   = -50
 ignored_penalty           = -100
 ```

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.14"
+version = "0.1.16"
 description = "Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex"
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — token-aware context packing for AI coding agents."""
 
-__version__ = "0.1.14"
+__version__ = "0.1.17"

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/analysis/ranking.py

@@ -283,6 +283,7 @@ def score_files(
     include_configs: bool = True,
     weights: ScoringWeights | None = None,
     summaries: dict | None = None,
+    churn_counts: dict[str, int] | None = None,
 ) -> list[tuple[FileInfo, float, list[str]]]:
     from agentpack.core.models import DependencyGraph as _DG
     if not isinstance(dep_graph, _DG):
@@ -292,6 +293,12 @@ def score_files(
     results: list[tuple[FileInfo, float, list[str]]] = []
     recently_set = set(recently_modified[:20])
 
+    churn_threshold: int | None = None
+    if churn_counts:
+        vals = sorted(churn_counts.values(), reverse=True)
+        cutoff_idx = max(0, len(vals) // 10 - 1)  # top 10%
+        churn_threshold = vals[cutoff_idx] if vals else None
+
     for fi in files:
         if fi.ignored or fi.binary:
             results.append((fi, w.ignored_penalty, ["ignored/binary"]))
@@ -368,10 +375,20 @@ def score_files(
             score += w.config_file
             reasons.append("config file")
 
+        if _is_knowledge_file(fi.path):
+            score += w.knowledge_file
+            reasons.append("knowledge/architecture doc")
+
         if fi.path in recently_set:
             score += w.recently_modified
             reasons.append("recently modified")
 
+        if churn_counts and churn_threshold is not None:
+            count = churn_counts.get(fi.path, 0)
+            if count >= churn_threshold:
+                score += w.churn_high
+                reasons.append(f"high churn ({count} commits)")
+
         if fi.too_large and score < 50:
             score += w.large_unrelated_penalty
             reasons.append("large unrelated file")
@@ -381,6 +398,43 @@ def score_files(
     return results
 
 
+def boost_paired_tests(
+    scored: list[tuple[FileInfo, float, list[str]]],
+    weights: ScoringWeights | None = None,
+) -> list[tuple[FileInfo, float, list[str]]]:
+    """Boost test files that pair with high-scoring source files.
+
+    Only applies to test files not already boosted by changed_paths.
+    Threshold: source must score above the median non-test score.
+    """
+    w = weights or _DEFAULT_WEIGHTS
+    non_test_scores = [
+        score for fi, score, _ in scored
+        if not fi.ignored and not fi.binary and not _is_test_file(fi.path) and score > 0
+    ]
+    if not non_test_scores:
+        return scored
+    threshold = sorted(non_test_scores)[len(non_test_scores) // 2]  # median
+
+    source_scores = {
+        fi.path: score for fi, score, _ in scored
+        if not _is_test_file(fi.path) and score >= threshold
+    }
+
+    result = []
+    for fi, score, reasons in scored:
+        if _is_test_file(fi.path):
+            already_boosted = any("test for" in r for r in reasons)
+            if not already_boosted:
+                for src_path, src_score in source_scores.items():
+                    if _test_matches_source(fi.path, src_path):
+                        score += w.related_test
+                        reasons = reasons + [f"test for high-scoring {src_path}"]
+                        break
+        result.append((fi, score, reasons))
+    return result
+
+
 def _is_test_file(path: str) -> bool:
     p = Path(path)
     return (
@@ -405,3 +459,24 @@ def _is_config_file(path: str) -> bool:
         p.suffix.lower() in CONFIG_EXTENSIONS
         or p.stem.lower() in CONFIG_NAMES
     )
+
+
+_KNOWLEDGE_NAMES = {
+    "decisions", "adr", "architecture", "contributing", "design",
+    "technical", "tradeoffs", "rfc", "proposal",
+}
+_KNOWLEDGE_DIRS = {"adr", "adrs", "decisions", "rfcs", "proposals", "design"}
+
+
+def _is_knowledge_file(path: str) -> bool:
+    p = Path(path)
+    stem_lower = p.stem.lower()
+    # Match ADR-NNN.md patterns and known doc names
+    if stem_lower in _KNOWLEDGE_NAMES:
+        return p.suffix.lower() == ".md"
+    if re.match(r"adr[-_]?\d+", stem_lower):
+        return True
+    # Any .md file in a known docs dir
+    if any(part.lower() in _KNOWLEDGE_DIRS for part in p.parts):
+        return p.suffix.lower() == ".md"
+    return False

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/application/pack_service.py

@@ -16,7 +16,7 @@ from agentpack.core import git
 from agentpack.core.context_pack import select_files, save_pack_metadata
 from agentpack.core.models import ContextPack, DependencyGraph, FileInfo, ScanResult, SelectedFile, Receipt
 from agentpack.core.token_estimator import estimate_tokens
-from agentpack.analysis.ranking import score_files, extract_keywords, enrich_keywords_from_files
+from agentpack.analysis.ranking import score_files, extract_keywords, enrich_keywords_from_files, boost_paired_tests
 from agentpack.analysis.tests import find_related_tests
 from agentpack.analysis import dependency_graph as dep_graph_mod
 from agentpack.summaries.base import build_all_summaries
@@ -128,7 +128,9 @@ class FileRanker:
         task: str,
         cfg: Any,
         summaries: dict | None = None,
+        root: Path | None = None,
     ) -> RankResult:
+        from agentpack.core import git as _git
         keywords = extract_keywords(task)
         keywords = enrich_keywords_from_files(keywords, changes.all_changed, packable)
         all_paths = {f.path for f in packable}
@@ -137,6 +139,10 @@ class FileRanker:
             tests = find_related_tests(fi.path, all_paths)
             dep_graph.nodes[fi.path].tests = tests
 
+        churn_counts: dict[str, int] = {}
+        if root is not None and _git.is_git_repo(root):
+            churn_counts = _git.file_churn_counts(root)
+
         scored = score_files(
             packable,
             changed_paths=changes.all_changed,
@@ -148,7 +154,9 @@ class FileRanker:
             include_configs=cfg.context.include_configs,
             weights=cfg.scoring,
             summaries=summaries,
+            churn_counts=churn_counts,
         )
+        scored = boost_paired_tests(scored, weights=cfg.scoring)
         return RankResult(keywords=keywords, scored=scored)
 
 
@@ -188,7 +196,7 @@ class PackPlanner:
         phase_times["changes"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()
-        rank_result = FileRanker().rank(packable, changes, dep_graph, request.task, cfg, summaries=summaries)
+        rank_result = FileRanker().rank(packable, changes, dep_graph, request.task, cfg, summaries=summaries, root=root)
         phase_times["rank"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()
@@ -295,6 +303,7 @@ class PackService:
             budget=plan.budget,
             token_estimate=packed_tokens,
         )
+        excluded_receipts = [r for r in plan.receipts if r.action == "excluded"]
         _record_metrics(
             root,
             task=request.task,
@@ -307,6 +316,8 @@ class PackService:
             changed_count=len(plan.all_changed),
             selected_paths=[sf.path for sf in plan.selected],
             current_changed=plan.all_changed,
+            excluded_count=len(excluded_receipts),
+            excluded_paths=[r.path for r in excluded_receipts if r.reason == "score too low"][:10],
         )
 
         return PackResult(
@@ -396,6 +407,8 @@ def _record_metrics(
     changed_count: int,
     selected_paths: list[str],
     current_changed: set[str],
+    excluded_count: int = 0,
+    excluded_paths: list[str] | None = None,
 ) -> None:
     metrics_path = root / ".agentpack" / "metrics.jsonl"
     accuracy = _compute_selection_accuracy(root, metrics_path, selected_paths, current_changed)
@@ -408,6 +421,8 @@ def _record_metrics(
         "saving_pct": round(saving_pct, 1),
         "selected_files": selected_count,
         "changed_files": changed_count,
+        "excluded_files": excluded_count,
+        "excluded_paths": excluded_paths or [],
         "selected_paths": selected_paths,
         "phases": {k: round(v, 3) for k, v in phase_times.items()},
         "total_s": round(sum(phase_times.values()), 3),

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/commands/doctor.py

@@ -149,6 +149,35 @@ def register(app: typer.Typer) -> None:
         if _local_has_hooks and not _global_has_hooks:
             console.print("  [yellow]![/] Hooks local-only — context won't auto-inject in other repos. Run: agentpack install --agent claude --global")
 
+        # --- MCP server ---
+        console.print("\n[bold]MCP server[/]")
+        mcp_json = root / ".mcp.json"
+        global_claude_settings_for_mcp = Path.home() / ".claude" / "settings.json"
+        _local_has_mcp = False
+        _global_has_mcp = False
+        if mcp_json.exists():
+            try:
+                mcp_data = _json.loads(mcp_json.read_text())
+                if "agentpack" in mcp_data.get("mcpServers", {}):
+                    console.print(f"  [green]✓[/] MCP server registered (local): {mcp_json}")
+                    _local_has_mcp = True
+                else:
+                    console.print("  [yellow]![/] .mcp.json exists but agentpack missing — run: agentpack install --agent claude")
+            except Exception:
+                console.print(f"  [yellow]![/] Could not parse {mcp_json}")
+        else:
+            console.print("  [dim]-[/] .mcp.json not present (run: agentpack install --agent claude)")
+        if global_claude_settings_for_mcp.exists():
+            try:
+                global_data = _json.loads(global_claude_settings_for_mcp.read_text())
+                if "agentpack" in global_data.get("mcpServers", {}):
+                    console.print(f"  [green]✓[/] MCP server registered (global): {global_claude_settings_for_mcp}")
+                    _global_has_mcp = True
+            except Exception:
+                pass
+        if not _local_has_mcp and not _global_has_mcp:
+            console.print("  [yellow]![/] MCP server not registered — mcp__agentpack__* tools unavailable")
+
         # --- Slash command ---
         console.print("\n[bold]Slash command (/agentpack)[/]")
         local_cmd = root / ".claude" / "commands" / "agentpack.md"

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/commands/install.py

@@ -51,6 +51,10 @@ def register(app: typer.Typer) -> None:
             scope = "~/.claude/settings.json" if global_install else ".claude/settings.json"
             console.print(f"[green]{scope} {hook_action}.[/]")
 
+            mcp_action = installer.patch_mcp_server(root, global_install)
+            mcp_scope = "~/.claude/settings.json" if global_install else ".mcp.json"
+            console.print(f"[green]{mcp_scope} mcpServers.agentpack {mcp_action}.[/]")
+
             if slash_command:
                 _install_slash_command(root, global_install)
 
@@ -74,8 +78,9 @@ def register(app: typer.Typer) -> None:
             installer = CodexInstaller()
             action = installer.patch_agents_md(root)
             console.print(f"[green]AGENTS.md {action}.[/]")
-            _print_auto_repack_results(installer.install_auto_repack(root))
-            console.print("  Run [bold]agentpack pack --task \"<task>\"[/] to generate context.")
+            if not global_install:
+                _print_auto_repack_results(installer.install_auto_repack(root))
+            console.print("  Run [bold]agentpack pack --agent codex --task \"<task>\"[/] to generate context.")
 
         elif agent == "antigravity":
             installer = AntigravityInstaller()
@@ -163,11 +168,14 @@ def register(app: typer.Typer) -> None:
         # --- Agent-specific config ---
         if agent == "claude":
             if not dry_run:
-                hook_action = ClaudeInstaller().patch_claude_settings(root, global_install=True)
+                inst = ClaudeInstaller()
+                hook_action = inst.patch_claude_settings(root, global_install=True)
                 console.print(f"\n[green]~/.claude/settings.json {hook_action}.[/]")
+                mcp_action = inst.patch_mcp_server(root, global_install=True)
+                console.print(f"[green]~/.claude/settings.json mcpServers.agentpack {mcp_action}.[/]")
                 _install_slash_command(root, global_install=True)
             else:
-                console.print("\n[dim]Would patch: ~/.claude/settings.json (hooks)[/]")
+                console.print("\n[dim]Would patch: ~/.claude/settings.json (hooks + mcpServers for global)[/]")
                 console.print("[dim]Would install: ~/.claude/commands/agentpack.md (slash command)[/]")
 
         elif agent == "cursor":

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/core/config.py

@@ -61,7 +61,9 @@ class ScoringWeights(BaseModel):
     reverse_dep: float = 40
     related_test: float = 35
     config_file: float = 25
+    knowledge_file: float = 30
     recently_modified: float = 20
+    churn_high: float = 15   # file appears in top 10% by churn
     large_unrelated_penalty: float = -50
     ignored_penalty: float = -100
 
@@ -106,7 +108,9 @@ direct_dep            = 50
 reverse_dep           = 40
 related_test          = 35
 config_file           = 25
+knowledge_file        = 30
 recently_modified     = 20
+churn_high            = 15
 large_unrelated_penalty = -50
 ignored_penalty       = -100
 """

{agentpack_cli-0.1.14 → agentpack_cli-0.1.16}/src/agentpack/core/git.py

@@ -74,6 +74,26 @@ def changed_files_since(root: Path, ref: str) -> set[str]:
     return result
 
 
+def file_churn_counts(root: Path, max_commits: int = 200) -> dict[str, int]:
+    """Return commit count per file from the last max_commits commits.
+
+    Uses a single git log call — O(1) subprocess, not O(n files).
+    Returns empty dict if not a git repo or git unavailable.
+    """
+    out = _run(
+        ["git", "log", "--name-only", "--format=", f"-{max_commits}"],
+        root,
+    )
+    if not out:
+        return {}
+    counts: dict[str, int] = {}
+    for line in out.splitlines():
+        line = line.strip()
+        if line:
+            counts[line] = counts.get(line, 0) + 1
+    return counts
+
+
 def infer_task_from_git(root: Path) -> str:
     """Infer a task description from branch name, changed files, and recent commits.