agentpack-cli 0.1.24__tar.gz → 0.1.25__tar.gz

agentpack_cli-0.1.25/.gitignore

@@ -0,0 +1,33 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+.venv/
+venv/
+env/
+
+# agentpack:start
+# AgentPack generated context/cache (safe to ignore)
+.agentpack/cache/
+.agentpack/snapshots/
+.agentpack/context*
+.agentpack/metrics.jsonl
+.agentpack/pack_metadata.json
+.agentpack/activity.log
+.agentpack/.gitignore
+.agentpack/.mcp_reminded
+.agentpack/session.json
+.agentpack/task.md
+.agentpack/benchmark_results.jsonl
+.agent/skills/agentpack/
+# agentpack:end
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+*.dist-info/

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.24
+Version: 0.1.25
 Summary: Task-aware context packing for AI coding agents — Claude, Cursor, Windsurf, Codex, and Antigravity
 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.24).** 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.25).** 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.
 
@@ -642,6 +642,7 @@ agentpack init --share-cache    # commit cache/ to git for team sharing
 
 Creates:
 ```
+.gitignore                # patched idempotently with AgentPack generated artifacts
 .agentignore              # gitignore-style file exclusion rules
 .agentpack/
   config.toml             # configuration (safe to commit)
@@ -1114,8 +1115,11 @@ Works like `.gitignore`. Default rules exclude:
 .agentignore              ✓ commit
 .agentpack/config.toml    ✓ commit
 .agentpack/cache/         ✓ commit if --share-cache (recommended for teams)
+.agentpack/.gitignore     ✗ gitignored
 .agentpack/snapshots/     ✗ gitignored
 .agentpack/context.*      ✗ gitignored
+.agentpack/task.md        ✗ gitignored (local current task)
+.agent/skills/agentpack/  ✗ gitignored (generated Antigravity context)
 ```
 
 ---

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/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.24).** 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.25).** 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.
 
@@ -603,6 +603,7 @@ agentpack init --share-cache    # commit cache/ to git for team sharing
 
 Creates:
 ```
+.gitignore                # patched idempotently with AgentPack generated artifacts
 .agentignore              # gitignore-style file exclusion rules
 .agentpack/
   config.toml             # configuration (safe to commit)
@@ -1075,8 +1076,11 @@ Works like `.gitignore`. Default rules exclude:
 .agentignore              ✓ commit
 .agentpack/config.toml    ✓ commit
 .agentpack/cache/         ✓ commit if --share-cache (recommended for teams)
+.agentpack/.gitignore     ✗ gitignored
 .agentpack/snapshots/     ✗ gitignored
 .agentpack/context.*      ✗ gitignored
+.agentpack/task.md        ✗ gitignored (local current task)
+.agent/skills/agentpack/  ✗ gitignored (generated Antigravity context)
 ```
 
 ---

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/pyproject.toml

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

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/__init__.py

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

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/application/pack_service.py

@@ -16,6 +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.renderers.markdown import render_generic
 from agentpack.analysis.ranking import (
     score_files,
     extract_keyword_weights,
@@ -193,6 +194,7 @@ class PackPlanner:
             previous_snapshot=previous_snap,
             include_globs=cfg.project.include_globs or None,
             exclude_globs=cfg.project.exclude_globs or None,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
         )
         phase_times["scan"] = time.perf_counter() - t0
 
@@ -255,7 +257,7 @@ class AdapterRegistry:
     """Maps agent names to adapter instances; extensible without touching PackService."""
 
     @staticmethod
-    def get(agent: str, cfg: Any) -> Any:
+    def _factories(cfg: Any) -> dict[str, Any]:
         from agentpack.adapters.antigravity import AntigravityAdapter
         from agentpack.adapters.claude import ClaudeAdapter
         from agentpack.adapters.codex import CodexAdapter
@@ -263,15 +265,33 @@ class AdapterRegistry:
         from agentpack.adapters.windsurf import WindsurfAdapter
         from agentpack.adapters.generic import GenericAdapter
 
-        adapters = {
+        return {
             "antigravity": lambda: AntigravityAdapter(),
             "claude": lambda: ClaudeAdapter(cfg.agents.claude.output),
             "cursor": lambda: CursorAdapter(cfg.agents.generic.output),
             "windsurf": lambda: WindsurfAdapter(cfg.agents.generic.output),
             "codex": lambda: CodexAdapter(cfg.agents.generic.output),
+            "generic": lambda: GenericAdapter(cfg.agents.generic.output),
         }
+
+    @staticmethod
+    def get(agent: str, cfg: Any) -> Any:
+        from agentpack.adapters.generic import GenericAdapter
+
+        adapters = AdapterRegistry._factories(cfg)
         return adapters.get(agent, lambda: GenericAdapter(cfg.agents.generic.output))()
 
+    @staticmethod
+    def generated_output_paths(root: Path, cfg: Any) -> set[str]:
+        paths: set[str] = set()
+        for factory in AdapterRegistry._factories(cfg).values():
+            try:
+                out_path = factory().output_path(root)
+                paths.add(str(out_path.relative_to(root)).replace("\\", "/"))
+            except (OSError, ValueError):
+                continue
+        return paths
+
 
 class PackService:
     """Materializes a plan from PackPlanner into a written context file."""
@@ -319,6 +339,7 @@ class PackService:
 
         t0 = time.perf_counter()
         out_path = adapter.write(pack_obj, root)
+        _write_canonical_context(pack_obj, root, out_path)
         plan.phase_times["render"] = time.perf_counter() - t0
 
         save_snapshot(plan.current_snap, root)
@@ -333,6 +354,7 @@ class PackService:
             token_estimate=packed_tokens,
             freshness=freshness,
             freshness_warnings=freshness_warnings,
+            selected_files=_selected_file_metadata(plan.selected),
         )
         excluded_receipts = [r for r in plan.receipts if r.action == "excluded"]
         # Budget-cut: files that scored OK but didn't fit — more useful signal than "score too low"
@@ -368,6 +390,33 @@ class PackService:
         )
 
 
+def _write_canonical_context(pack: ContextPack, root: Path, out_path: Path) -> None:
+    """Keep .agentpack/context.md fresh even when the target agent writes elsewhere."""
+    canonical_path = root / ".agentpack" / "context.md"
+    try:
+        if out_path.resolve() == canonical_path.resolve():
+            return
+    except OSError:
+        if out_path == canonical_path:
+            return
+    canonical_path.parent.mkdir(parents=True, exist_ok=True)
+    canonical_path.write_text(render_generic(pack), encoding="utf-8")
+
+
+def _selected_file_metadata(selected: list[SelectedFile]) -> list[dict[str, Any]]:
+    return [
+        {
+            "path": sf.path,
+            "mode": sf.include_mode,
+            "score": round(sf.score, 1),
+            "why": sf.reasons[0] if sf.reasons else "",
+            "reasons": sf.reasons,
+            "tokens": _sf_tokens(sf),
+        }
+        for sf in selected
+    ]
+
+
 def _sf_tokens(sf: SelectedFile) -> int:
     if sf.content:
         return estimate_tokens(sf.content)

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/claude_cmd.py

@@ -30,6 +30,7 @@ def register(app: typer.Typer) -> None:
             state.last_refresh_at = _now_iso()
             state.refresh_count += 1
             state.last_task_hash = _file_hash(root / TASK_FILE)
+            state.last_resolved_agent = state.agent
             save_session(root, state)
             log_activity(root, f"claude cmd — {result['files']} files, {result['tokens']:,} tokens")
         else:

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/diff.py

@@ -8,6 +8,7 @@ from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
 from agentpack.core.snapshot import build_snapshot, load_snapshot
 from agentpack.core.diff import diff_snapshots
+from agentpack.application.pack_service import AdapterRegistry
 from agentpack.commands._shared import console, _root
 
 
@@ -19,7 +20,12 @@ def register(app: typer.Typer) -> None:
         cfg = load_config(root)
         ignore_spec = load_spec(root / cfg.project.ignore_file)
 
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        scan_result = scan(
+            root,
+            ignore_spec,
+            cfg.context.max_file_tokens,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
+        )
         current = build_snapshot(scan_result.packable)
         previous = load_snapshot(root)
         result = diff_snapshots(previous, current)

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/doctor.py

@@ -16,6 +16,7 @@ from agentpack.integrations.global_install import (
     _detect_rc_file,
 )
 from agentpack.commands._shared import console, _root
+from agentpack.core.context_pack import load_pack_metadata
 
 
 def register(app: typer.Typer) -> None:
@@ -104,11 +105,11 @@ def register(app: typer.Typer) -> None:
             return
 
         config_path = root / ".agentpack" / "config.toml"
-        context_path = root / ".agentpack" / "context.claude.md"
         if not config_path.exists():
             console.print(f"  [yellow]![/] Not initialized in {root} — run: agentpack init")
         else:
             console.print("  [green]✓[/] .agentpack/config.toml present")
+            context_path = _latest_context_path(root)
             if context_path.exists():
                 import time
                 age = time.time() - context_path.stat().st_mtime
@@ -216,6 +217,16 @@ def register(app: typer.Typer) -> None:
         if not _local_has_mcp and not _global_has_mcp:
             console.print("  [yellow]![/] MCP server not registered — mcp__agentpack__* tools unavailable")
 
+        # --- Release hygiene ---
+        console.print("\n[bold]Release hygiene[/]")
+        findings = _release_hygiene_findings(root)
+        if findings:
+            for finding in findings:
+                console.print(f"  [yellow]![/] {finding}")
+            ok = False
+        else:
+            console.print("  [green]✓[/] no generated release-noise files staged or untracked")
+
         # --- Slash command ---
         console.print("\n[bold]Slash command (/agentpack)[/]")
         local_cmd = root / ".claude" / "commands" / "agentpack.md"
@@ -244,6 +255,23 @@ def _check_agent_file(root: Path, filename: str, agent: str) -> None:
         console.print(f"  [dim]-[/] {filename} not present (optional)")
 
 
+def _latest_context_path(root: Path) -> Path:
+    meta = load_pack_metadata(root)
+    if meta and meta.get("context_path"):
+        candidate = root / str(meta["context_path"])
+        if candidate.exists():
+            return candidate
+    for rel in (
+        ".agentpack/context.md",
+        ".agentpack/context.claude.md",
+        ".agent/skills/agentpack/SKILL.md",
+    ):
+        candidate = root / rel
+        if candidate.exists():
+            return candidate
+    return root / ".agentpack" / "context.md"
+
+
 def _source_checkout_warning(
     root: Path,
     package_file: Path,
@@ -268,6 +296,51 @@ def _source_checkout_warning(
     )
 
 
+_RELEASE_NOISE_PREFIXES = (
+    ".agent/",
+    ".agentpack/",
+    ".claude/worktrees/",
+    ".codex/",
+    ".cursor/",
+    ".vscode/",
+)
+_RELEASE_NOISE_FILES = {".coverage"}
+
+
+def _release_hygiene_findings(root: Path) -> list[str]:
+    """Flag local generated artifacts that should not be staged or released."""
+    try:
+        result = subprocess.run(
+            ["git", "status", "--short"],
+            cwd=root,
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return ["could not inspect git status for release hygiene"]
+    if result.returncode != 0:
+        return []
+
+    noisy: list[str] = []
+    for raw in result.stdout.splitlines():
+        if not raw.strip():
+            continue
+        status = raw[:2].strip() or "modified"
+        path = raw[3:].strip()
+        if " -> " in path:
+            path = path.rsplit(" -> ", 1)[1]
+        norm = path.replace("\\", "/")
+        if norm in _RELEASE_NOISE_FILES or any(norm.startswith(prefix) for prefix in _RELEASE_NOISE_PREFIXES):
+            noisy.append(f"{status} {norm}")
+
+    if not noisy:
+        return []
+    sample = ", ".join(noisy[:8])
+    extra = f", ... {len(noisy) - 8} more" if len(noisy) > 8 else ""
+    return [f"generated/local artifacts present: {sample}{extra}"]
+
+
 def _print_summary(ok: bool) -> None:
     console.print("")
     if ok:

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/explain.py

@@ -10,6 +10,7 @@ from agentpack.core.context_pack import select_files
 from agentpack.commands._shared import console, _root
 from agentpack.commands.pack import _resolve_task
 from agentpack.core.config import load_config, ScoringWeights
+from agentpack.analysis.ranking import extract_keyword_weights, generic_task_term_ratio, _GENERIC_TASK_TERMS
 
 
 def _resolve_signal_weight(reason: str, weights: ScoringWeights) -> float:
@@ -111,6 +112,50 @@ def _print_file_detail(
     console.print()
 
 
+def _noise_report(task: str, plan: object) -> list[str]:
+    keyword_weights = extract_keyword_weights(task)
+    generic_terms = sorted(term for term in keyword_weights if term in _GENERIC_TASK_TERMS)
+    specific_terms = sorted(term for term in keyword_weights if term not in _GENERIC_TASK_TERMS)
+    selected = list(plan.selected)  # type: ignore[attr-defined]
+    summary_count = sum(1 for sf in selected if sf.include_mode == "summary")
+    filename_count = sum(1 for sf in selected if "filename keyword match" in sf.reasons)
+    symbol_count = sum(1 for sf in selected if "symbol keyword match" in sf.reasons)
+    excluded = [r for r in plan.receipts if r.action == "excluded"]  # type: ignore[attr-defined]
+    summary_cap = sum(1 for r in excluded if r.reason == "summary cap reached")
+    score_floor = sum(1 for r in excluded if r.reason == "summary score below floor")
+
+    lines = [
+        "## Pack noise report",
+        "",
+        f"- generic task ratio: {generic_task_term_ratio(task):.0%}",
+        f"- generic terms: {', '.join(generic_terms) if generic_terms else '(none)'}",
+        f"- specific terms: {', '.join(specific_terms) if specific_terms else '(none)'}",
+        f"- selected summaries: {summary_count}/{len(selected)}",
+        f"- filename-match selections: {filename_count}/{len(selected)}",
+        f"- symbol-match selections: {symbol_count}/{len(selected)}",
+        f"- excluded by summary cap: {summary_cap}",
+        f"- excluded by weak summary score: {score_floor}",
+        "",
+        "### Sharpen task wording",
+        "",
+    ]
+    if generic_terms:
+        lines.append("- Replace broad terms with subsystem, file, or symptom words.")
+        lines.append(f"- Broad terms driving matches: {', '.join(generic_terms[:8])}.")
+    else:
+        lines.append("- Task terms are already specific; inspect changed files or score weights next.")
+    if summary_count and selected and summary_count / len(selected) >= 0.7:
+        lines.append("- Try `--mode minimal` for edit work, or add exact module/file names.")
+    if filename_count and selected and filename_count / len(selected) >= 0.6:
+        lines.append("- Filename matches dominate; add behavior words that appear inside target files.")
+    return lines
+
+
+def _print_noise_report(task: str, plan: object) -> None:
+    for line in _noise_report(task, plan):
+        console.print(line)
+
+
 def register(app: typer.Typer) -> None:
     @app.command()
     def explain(
@@ -120,6 +165,7 @@ def register(app: typer.Typer) -> None:
         since: Optional[str] = typer.Option(None, "--since", help="Git ref to compare against (e.g. HEAD~1, main)."),
         file: Optional[str] = typer.Option(None, "--file", help="Show detailed score breakdown for a specific file."),
         omitted: bool = typer.Option(False, "--omitted", is_flag=True, help="Show top-10 excluded files and why."),
+        why_noisy: bool = typer.Option(False, "--why-noisy", is_flag=True, help="Explain broad task terms and noisy selection signals."),
     ) -> None:
         """Explain which files would be selected and why, without writing a context file."""
         if mode not in ("minimal", "balanced", "deep"):
@@ -199,6 +245,12 @@ def register(app: typer.Typer) -> None:
             console.print()
             return
 
+        if why_noisy:
+            console.print(f"\n[bold]Task:[/] [cyan]{resolved_task}[/]  [dim]mode={mode}  budget={plan.budget:,}[/]\n")
+            _print_noise_report(resolved_task, plan)
+            console.print()
+            return
+
         console.print(f"\n[bold]Task:[/] [cyan]{resolved_task}[/]  [dim]mode={mode}  budget={plan.budget:,}[/]\n")
 
         console.print("[bold]Top selected files (ranked):[/]")

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/init.py

@@ -10,6 +10,54 @@ from agentpack.core.ignore import DEFAULT_AGENTIGNORE
 from agentpack.commands._shared import console, _root
 from agentpack.session.state import load_session, create_session, SESSION_FILE, TASK_FILE
 
+_GITIGNORE_START = "# agentpack:start"
+_GITIGNORE_END = "# agentpack:end"
+
+
+def _repo_gitignore_block(share_cache: bool = False) -> str:
+    cache_line = "" if share_cache else ".agentpack/cache/\n"
+    return (
+        f"{_GITIGNORE_START}\n"
+        "# AgentPack generated context/cache (safe to ignore)\n"
+        f"{cache_line}"
+        ".agentpack/snapshots/\n"
+        ".agentpack/context*\n"
+        ".agentpack/metrics.jsonl\n"
+        ".agentpack/pack_metadata.json\n"
+        ".agentpack/activity.log\n"
+        ".agentpack/.gitignore\n"
+        ".agentpack/.mcp_reminded\n"
+        ".agentpack/session.json\n"
+        ".agentpack/task.md\n"
+        ".agentpack/benchmark_results.jsonl\n"
+        ".agent/skills/agentpack/\n"
+        f"{_GITIGNORE_END}\n"
+    )
+
+
+def _patch_repo_gitignore(root, share_cache: bool = False) -> str:
+    gitignore = root / ".gitignore"
+    block = _repo_gitignore_block(share_cache)
+    if not gitignore.exists():
+        gitignore.write_text(block, encoding="utf-8")
+        return "created"
+
+    content = gitignore.read_text(encoding="utf-8")
+    start = content.find(_GITIGNORE_START)
+    end = content.find(_GITIGNORE_END)
+    if start != -1 and end != -1 and end >= start:
+        end += len(_GITIGNORE_END)
+        replacement = block.rstrip()
+        updated = content[:start].rstrip() + "\n\n" + replacement + "\n" + content[end:].lstrip("\n")
+        if updated == content:
+            return "unchanged"
+        gitignore.write_text(updated, encoding="utf-8")
+        return "updated"
+
+    prefix = content.rstrip() + "\n\n" if content.strip() else ""
+    gitignore.write_text(prefix + block, encoding="utf-8")
+    return "updated"
+
 
 def register(app: typer.Typer) -> None:
     @app.command()
@@ -48,6 +96,14 @@ def register(app: typer.Typer) -> None:
         else:
             console.print("[dim]Skipped[/] .agentpack/.gitignore (exists)")
 
+        gitignore_action = _patch_repo_gitignore(root, share_cache=share_cache)
+        if gitignore_action == "created":
+            console.print("[green]Created[/] .gitignore [dim](AgentPack generated artifacts ignored)[/]")
+        elif gitignore_action == "updated":
+            console.print("[green]Updated[/] .gitignore [dim](AgentPack generated artifacts ignored)[/]")
+        else:
+            console.print("[dim]Skipped[/] .gitignore (AgentPack block unchanged)")
+
         config_path_file = agentpack_dir / "config.toml"
         if not config_path_file.exists() or force:
             cfg = DEFAULT_CONFIG.model_copy(deep=True)

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/pack.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import time
+from pathlib import Path
 from typing import Optional
 
 import typer
@@ -12,7 +13,8 @@ from rich import box
 from agentpack.core import git
 from agentpack.core.ignore import SENSITIVE_PATTERNS
 from agentpack.application.pack_service import PackRequest, PackService, PackResult
-from agentpack.commands._shared import console, _root
+from agentpack.commands._shared import console, _root, _file_hash, _now_iso
+from agentpack.session.state import TASK_FILE, load_session, save_session, log_activity
 
 
 def register(app: typer.Typer) -> None:
@@ -50,6 +52,7 @@ def register(app: typer.Typer) -> None:
             refresh=refresh,
             task_source=task_source,
         ))
+        _mark_session_refreshed(_root(), result)
         _print_pack_summary(result)
 
 
@@ -177,6 +180,20 @@ def _print_pack_summary(result: PackResult) -> None:
     console.print()
 
 
+def _mark_session_refreshed(root: Path, result: PackResult) -> None:
+    state = load_session(root)
+    if state is None or not state.active:
+        return
+    freshness = result.pack.freshness or {}
+    state.last_refresh_at = freshness.get("generated_at") or _now_iso()
+    state.refresh_count += 1
+    state.last_task_hash = _file_hash(root / TASK_FILE)
+    state.last_git_hash = freshness.get("snapshot_root_hash", "")
+    state.last_resolved_agent = getattr(result.pack, "agent", state.last_resolved_agent)
+    save_session(root, state)
+    log_activity(root, f"pack refresh — {len(result.pack.selected_files)} files, {result.packed_tokens:,} tokens")
+
+
 def _pack_diagnostics(result: PackResult) -> list[str]:
     selected = result.pack.selected_files
     receipts = result.pack.receipts
@@ -186,6 +203,9 @@ def _pack_diagnostics(result: PackResult) -> list[str]:
     symbol_matches = sum(1 for sf in selected if "symbol keyword match" in sf.reasons)
     score_floor_excluded = sum(1 for r in receipts if r.reason == "summary score below floor")
     summary_cap_excluded = sum(1 for r in receipts if r.reason == "summary cap reached")
+    changed_set = set(result.changed_files)
+    top_changed = sum(1 for sf in selected[:10] if sf.path in changed_set)
+    strong_live_signal = bool(changed_set) and top_changed >= min(len(changed_set), 5)
 
     task_words = [
         part for part in result.pack.task.replace("_", " ").replace("-", " ").split()
@@ -195,9 +215,9 @@ def _pack_diagnostics(result: PackResult) -> list[str]:
         diagnostics.append("Task is very short; add subsystem, file, or symptom words for better precision.")
     if not result.changed_files:
         diagnostics.append("No changed files detected; pack relies mostly on task keywords and cached summaries.")
-    if selected and filename_matches / len(selected) >= 0.6:
+    if selected and not strong_live_signal and filename_matches / len(selected) >= 0.6:
         diagnostics.append("Most selected files matched by filename; task terms may be broad.")
-    if selected and summary_count / len(selected) >= 0.7:
+    if selected and not strong_live_signal and summary_count / len(selected) >= 0.7:
         diagnostics.append("Pack is mostly summaries; use minimal mode or a more specific task for edit work.")
     if symbol_matches > 25:
         diagnostics.append(f"Many symbol matches selected ({symbol_matches}); inspect repeated task terms with explain.")
@@ -232,6 +252,7 @@ def _pack_watch(
             root=root, agent=agent, task=task, mode=mode, budget=budget,
             since=since, refresh=False, task_source="watch",
         ))
+        _mark_session_refreshed(root, result)
         _print_pack_summary(result)
 
     _run_pack()

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/scan.py

@@ -6,6 +6,7 @@ from rich.table import Table
 from agentpack.core.config import load_config
 from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
+from agentpack.application.pack_service import AdapterRegistry
 from agentpack.commands._shared import console, _root
 
 
@@ -18,7 +19,12 @@ def register(app: typer.Typer) -> None:
         ignore_spec = load_spec(root / cfg.project.ignore_file)
 
         console.print("[bold]Scanning repository...[/]")
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        scan_result = scan(
+            root,
+            ignore_spec,
+            cfg.context.max_file_tokens,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
+        )
 
         total = len(scan_result.all_files)
         ignored = len(scan_result.ignored) + len(scan_result.binary)

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/stats.py

@@ -1,17 +1,23 @@
 from __future__ import annotations
 
 import json
+from datetime import datetime, timezone
 from pathlib import Path
 
 import typer
 from rich.table import Table
 from rich import box
+from rich.panel import Panel
 
+from agentpack.core import git
 from agentpack.core.config import load_config
 from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
+from agentpack.core.snapshot import build_snapshot
 from agentpack.core.context_pack import load_pack_metadata
+from agentpack.application.pack_service import AdapterRegistry
 from agentpack.commands._shared import console, _root
+from agentpack.session.state import SessionState
 
 
 def register(app: typer.Typer) -> None:
@@ -22,7 +28,12 @@ def register(app: typer.Typer) -> None:
         cfg = load_config(root)
         ignore_spec = load_spec(root / cfg.project.ignore_file)
 
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        scan_result = scan(
+            root,
+            ignore_spec,
+            cfg.context.max_file_tokens,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
+        )
         meta = load_pack_metadata(root)
 
         raw = sum(f.estimated_tokens for f in scan_result.all_files)
@@ -55,6 +66,8 @@ def register(app: typer.Typer) -> None:
             sess_tbl.add_column(style="bold")
             sess_tbl.add_row("active", "[green]yes[/]" if session.active else "[red]no[/]")
             sess_tbl.add_row("agent", session.agent)
+            if session.last_resolved_agent and session.last_resolved_agent != session.agent:
+                sess_tbl.add_row("last pack agent", session.last_resolved_agent)
             sess_tbl.add_row("mode", session.mode)
             if session.started_at:
                 sess_tbl.add_row("started", session.started_at[:19].replace("T", " "))
@@ -75,11 +88,24 @@ def register(app: typer.Typer) -> None:
                 except Exception:
                     pass
 
+        context_path_obj = None
         if meta:
             context_path_obj = root / meta.get("context_path", "")
-            if context_path_obj.exists():
+            top_files = _top_files_from_metadata(meta)
+            if not top_files and context_path_obj.exists():
                 top_files = _parse_top_files(context_path_obj)
 
+        freshness_diagnostics = _freshness_diagnostics(
+            root=root,
+            meta=meta,
+            session=session,
+            current_root_hash=build_snapshot(scan_result.packable)["root_hash"],
+            context_path=context_path_obj,
+        )
+        if freshness_diagnostics:
+            console.print()
+            console.print(_advice_panel("Freshness advice", freshness_diagnostics))
+
         token_by_path = {f.path: f.estimated_tokens for f in scan_result.packable}
         top_estimate = sum(token_by_path.get(path, 0) for path, _mode, _why in top_files[:20])
         if top_estimate <= 0:
@@ -116,6 +142,11 @@ def register(app: typer.Typer) -> None:
 
         # --- Selection accuracy (last 10 runs) ---
         accuracy_rows = _load_accuracy_rows(metrics_path, n=10)
+        noise_diagnostics = _noise_diagnostics(top_files, accuracy_rows)
+        if noise_diagnostics:
+            console.print()
+            console.print(_advice_panel("Pack quality advice", noise_diagnostics))
+
         if accuracy_rows:
             avg_recall = sum(r["selection_recall"] for r in accuracy_rows) / len(accuracy_rows)
             avg_precision = sum(r["selection_precision"] for r in accuracy_rows) / len(accuracy_rows)
@@ -174,6 +205,126 @@ def _load_accuracy_rows(metrics_path: Path, n: int = 10) -> list[dict]:
         return []
 
 
+def _task_md_body(root: Path) -> str | None:
+    path = root / ".agentpack" / "task.md"
+    try:
+        content = path.read_text(encoding="utf-8").strip()
+    except OSError:
+        return None
+    lines = [line for line in content.splitlines() if line.strip() and not line.startswith("#")]
+    body = lines[0].strip() if lines else ""
+    if body and "Write or update the current coding task here." not in body:
+        return body
+    return None
+
+
+def _parse_iso(value: str | None) -> datetime | None:
+    if not value:
+        return None
+    try:
+        parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+        return parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)
+    except ValueError:
+        return None
+
+
+def _freshness_diagnostics(
+    *,
+    root: Path,
+    meta: dict | None,
+    session: SessionState | None,
+    current_root_hash: str,
+    context_path: Path | None,
+) -> list[str]:
+    if not meta:
+        return ["No pack metadata found; run `agentpack pack --task auto`."]
+
+    diagnostics: list[str] = []
+    for warning in meta.get("freshness_warnings") or []:
+        diagnostics.append(str(warning))
+
+    task_md = _task_md_body(root)
+    if task_md and task_md != meta.get("task"):
+        diagnostics.append(".agentpack/task.md differs from the latest packed task.")
+
+    if meta.get("snapshot_root_hash") and meta.get("snapshot_root_hash") != current_root_hash:
+        diagnostics.append("Files changed since the latest pack; refresh before trusting top included files.")
+
+    if git.is_git_repo(root):
+        packed_sha = meta.get("git_sha") or (meta.get("freshness") or {}).get("git_sha")
+        current_sha = git.current_sha(root)
+        if packed_sha and current_sha and packed_sha != current_sha:
+            diagnostics.append("Git HEAD changed since the latest pack.")
+
+    if context_path is not None and not context_path.exists():
+        diagnostics.append(f"Recorded context path is missing: {context_path.relative_to(root)}.")
+
+    if session and session.active:
+        packed_at = _parse_iso(meta.get("generated_at"))
+        refreshed_at = _parse_iso(session.last_refresh_at)
+        if not session.last_refresh_at:
+            diagnostics.append("Session is active but has no last refresh timestamp.")
+        elif packed_at and refreshed_at and refreshed_at < packed_at:
+            diagnostics.append("Session last refresh timestamp is older than latest pack metadata.")
+
+    return diagnostics[:5]
+
+
+def _noise_diagnostics(
+    top_files: list[tuple[str, str, str]],
+    accuracy_rows: list[dict],
+) -> list[str]:
+    diagnostics: list[str] = []
+    if top_files:
+        summary_count = sum(1 for _path, mode, _why in top_files if mode == "summary")
+        filename_matches = sum(1 for _path, _mode, why in top_files if "filename keyword match" in why)
+        if summary_count / len(top_files) >= 0.7:
+            diagnostics.append("Latest pack is mostly summaries; use minimal mode or a narrower task for edit work.")
+        if filename_matches / len(top_files) >= 0.6:
+            diagnostics.append("Top files mostly matched by filename; task terms may be broad.")
+
+    if accuracy_rows:
+        avg_precision = sum(r["selection_precision"] for r in accuracy_rows) / len(accuracy_rows)
+        token_rows = [r for r in accuracy_rows if "selection_token_precision" in r]
+        avg_token_precision = (
+            sum(r["selection_token_precision"] for r in token_rows) / len(token_rows)
+            if token_rows else None
+        )
+        summary_rows = [r for r in accuracy_rows if "selection_token_precision_summary" in r]
+        avg_summary_precision = (
+            sum(r["selection_token_precision_summary"] for r in summary_rows) / len(summary_rows)
+            if summary_rows else None
+        )
+        if avg_precision < 0.05:
+            diagnostics.append("Selection file precision is very low; many selected files were not later changed.")
+        if avg_token_precision is not None and avg_token_precision < 0.2:
+            diagnostics.append("Token precision is low; most packed tokens became noise in recent runs.")
+        if avg_summary_precision == 0:
+            diagnostics.append("Summary token precision is 0%; summary context has not matched later edits.")
+    return diagnostics[:5]
+
+
+def _top_files_from_metadata(meta: dict) -> list[tuple[str, str, str]]:
+    files = meta.get("selected_files_meta") or []
+    if not isinstance(files, list):
+        return []
+    result: list[tuple[str, str, str]] = []
+    for item in files:
+        if not isinstance(item, dict):
+            continue
+        path = item.get("path")
+        mode = item.get("mode")
+        why = item.get("why") or ""
+        if isinstance(path, str) and isinstance(mode, str):
+            result.append((path, mode, str(why)))
+    return result
+
+
+def _advice_panel(title: str, diagnostics: list[str]) -> Panel:
+    body = "\n".join(f"  [cyan]i[/] {line}" for line in diagnostics)
+    return Panel(body, title=f"[bold cyan]{title}[/]", border_style="cyan", padding=(0, 1))
+
+
 def _parse_top_files(context_path: Path) -> list[tuple[str, str, str]]:
     """Parse top selected files from context.md. Returns list of (path, mode, why)."""
     results: list[tuple[str, str, str]] = []

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/status.py

@@ -7,6 +7,7 @@ from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
 from agentpack.core.snapshot import build_snapshot
 from agentpack.core.context_pack import load_pack_metadata
+from agentpack.application.pack_service import AdapterRegistry
 from agentpack.commands._shared import console, _root
 
 
@@ -23,7 +24,12 @@ def register(app: typer.Typer) -> None:
             console.print("[yellow]No context pack found. Run agentpack pack to generate one.[/]")
             raise typer.Exit(1)
 
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        scan_result = scan(
+            root,
+            ignore_spec,
+            cfg.context.max_file_tokens,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
+        )
         current = build_snapshot(scan_result.packable)
 
         if current["root_hash"] == meta.get("snapshot_root_hash"):

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/summarize.py

@@ -5,6 +5,7 @@ import typer
 from agentpack.core.config import load_config
 from agentpack.core.ignore import load_spec
 from agentpack.core.scanner import scan
+from agentpack.application.pack_service import AdapterRegistry
 from agentpack.summaries.base import get_or_build_summary
 from agentpack.commands._shared import console, _root
 
@@ -21,7 +22,12 @@ def register(app: typer.Typer) -> None:
 
         console.print("[bold]Building offline summaries...[/]")
 
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        scan_result = scan(
+            root,
+            ignore_spec,
+            cfg.context.max_file_tokens,
+            always_skip_paths=AdapterRegistry.generated_output_paths(root, cfg),
+        )
         active = scan_result.packable
 
         if refresh:

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/commands/watch.py

@@ -118,6 +118,7 @@ def _run_refresh(root: Path, agent: str, mode: str, budget: int) -> None:
             state.last_refresh_at = _now_iso()
             state.refresh_count += 1
             state.last_task_hash = _file_hash(root / TASK_FILE)
+            state.last_resolved_agent = agent
             save_session(root, state)
             log_activity(root, f"watch refresh — {result['files']} files, {result['tokens']:,} tokens")
     else:

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/core/context_pack.py

@@ -57,6 +57,7 @@ def save_pack_metadata(
     token_estimate: int = 0,
     freshness: dict[str, Any] | None = None,
     freshness_warnings: list[str] | None = None,
+    selected_files: list[dict[str, Any]] | None = None,
 ) -> None:
     generated_at = (
         freshness.get("generated_at")
@@ -72,6 +73,7 @@ def save_pack_metadata(
         "mode": mode,
         "budget": budget,
         "token_estimate": token_estimate,
+        "selected_files_meta": selected_files or [],
         "freshness": freshness or {},
         "freshness_warnings": freshness_warnings or [],
     }

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/core/scanner.py

@@ -91,6 +91,7 @@ def scan(
     previous_snapshot: dict | None = None,
     include_globs: list[str] | None = None,
     exclude_globs: list[str] | None = None,
+    always_skip_paths: set[str] | None = None,
 ) -> ScanResult:
     packable: list[FileInfo] = []
     ignored: list[FileInfo] = []
@@ -98,6 +99,7 @@ def scan(
 
     prev_files: dict[str, dict] = (previous_snapshot or {}).get("files", {})
     inc_spec, exc_spec = _build_glob_specs(include_globs or [], exclude_globs or [])
+    generated_paths = {p.replace("\\", "/") for p in (always_skip_paths or set())}
 
     for abs_path in root.rglob("*"):
         if not abs_path.is_file():
@@ -110,6 +112,8 @@ def scan(
             continue
 
         rel_str = str(rel)
+        if rel_str.replace("\\", "/") in generated_paths:
+            continue
 
         if inc_spec is not None and not inc_spec.match_file(rel_str):
             ignored.append(FileInfo(

{agentpack_cli-0.1.24 → agentpack_cli-0.1.25}/src/agentpack/session/state.py

@@ -34,6 +34,7 @@ class SessionState:
     last_refresh_at: Optional[str] = None
     last_task_hash: str = ""
     last_git_hash: str = ""
+    last_resolved_agent: str = ""
     refresh_count: int = 0
 
 
@@ -53,6 +54,7 @@ def load_session(root: Path) -> Optional[SessionState]:
             last_refresh_at=data.get("last_refresh_at"),
             last_task_hash=data.get("last_task_hash", ""),
             last_git_hash=data.get("last_git_hash", ""),
+            last_resolved_agent=data.get("last_resolved_agent", ""),
             refresh_count=data.get("refresh_count", 0),
         )
     except FileNotFoundError:

agentpack_cli-0.1.24/.gitignore

@@ -1,21 +0,0 @@
-__pycache__/
-*.py[cod]
-*.egg-info/
-dist/
-build/
-.eggs/
-*.egg
-
-.venv/
-venv/
-env/
-
-.agentpack/cache/
-.agentpack/snapshots/
-.agentpack/context.*
-
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-
-*.dist-info/