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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.14
+Version: 0.1.15
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE

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

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.14"
+version = "0.1.15"
 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.15}/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.15}/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()

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

@@ -74,8 +74,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()

{agentpack_cli-0.1.14 → agentpack_cli-0.1.15}/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.15}/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.
 

{agentpack_cli-0.1.14 → agentpack_cli-0.1.15}/src/agentpack/installers/claude.py

@@ -8,14 +8,13 @@ _AGENTPACK_BLOCK = """\
 <!-- agentpack:start -->
 ## AgentPack Context
 
-AgentPack keeps context fresh automatically. When a session is running:
+At the start of every coding task:
 
-1. Check `.agentpack/session.json` — if `"active": true`, read `.agentpack/context.md`.
-2. When the user gives you a new coding task, write a one-line summary to `.agentpack/task.md`.
-3. Re-read `.agentpack/context.md` after watch mode refreshes it (a few seconds).
-4. Prefer files listed in context, but verify with actual code before editing.
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Read `.agentpack/context.claude.md` — context is injected automatically via session hooks.
+3. Use files listed in context as starting points, but verify with actual code before editing.
 
-If no session is running, generate context manually:
+If context is missing or stale, regenerate manually:
 
 ```bash
 agentpack pack --agent claude --task "<task>"

{agentpack_cli-0.1.14 → agentpack_cli-0.1.15}/src/agentpack/installers/codex.py

@@ -9,13 +9,12 @@ _AGENTPACK_BLOCK = """\
 <!-- agentpack:start -->
 ## AgentPack Context
 
-If `.agentpack/session.json` exists and `"active": true`:
+At the start of every coding task:
 
-1. Read `.agentpack/context.md` before making code changes.
-2. For a new coding task, write a one-line summary to `.agentpack/task.md`.
-3. Re-read `.agentpack/context.md` after watch mode refreshes it.
-4. Use AgentPack-selected files as starting points, not as absolute truth.
-5. If context is missing or stale: `agentpack session refresh`
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Run `agentpack pack --task auto` to refresh context.
+3. Read `.agentpack/context.md` — it lists the files most relevant to your task.
+4. Use those files as starting points, but verify with actual code before editing.
 <!-- agentpack:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.1.14 → agentpack_cli-0.1.15}/src/agentpack/installers/cursor.py

@@ -8,9 +8,11 @@ from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
 _CURSOR_RULE = """\
 <!-- agentpack:rule:start -->
-If `.agentpack/session.json` exists and active, read `.agentpack/context.md` at the start of every conversation.
-For a new task, update `.agentpack/task.md` with a one-line summary.
-If context is stale or missing: agentpack session refresh
+At the start of every coding task:
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
+3. Use files listed in context as starting points, but verify with actual code before editing.
+If context is missing: `agentpack pack --agent cursor --task "<task>"`
 <!-- agentpack:rule:end -->"""
 
 _RULE_RE = re.compile(
@@ -53,12 +55,13 @@ description: AgentPack session context injection
 alwaysApply: true
 ---
 
-When working in this repository:
+At the start of every coding task:
 
-1. Check `.agentpack/session.json` — if `"active": true`, read `.agentpack/context.md` before editing code.
-2. For a new user task, write a one-line summary to `.agentpack/task.md`.
-3. Prefer files with high AgentPack scores as starting points.
-4. If context seems unrelated to the task, run: `agentpack session refresh`
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
+3. Use files listed in context as starting points, but verify with actual code before editing.
+
+If context is missing: `agentpack pack --agent cursor --task "<task>"`
 """
         already = mdc_path.exists()
         if already and mdc_path.read_text() == content:

{agentpack_cli-0.1.14 → agentpack_cli-0.1.15}/src/agentpack/installers/windsurf.py

@@ -8,9 +8,11 @@ from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
 _WINDSURF_RULE = """\
 <!-- agentpack:rule:start -->
-If `.agentpack/session.json` exists and active, read `.agentpack/context.md` at the start of every conversation.
-For a new task, update `.agentpack/task.md` with a one-line summary.
-If context is stale or missing: agentpack session refresh
+At the start of every coding task:
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
+3. Use files listed in context as starting points, but verify with actual code before editing.
+If context is missing: `agentpack pack --agent windsurf --task "<task>"`
 <!-- agentpack:rule:end -->"""
 
 _RULE_RE = re.compile(