agentpack-cli 0.3.5__tar.gz → 0.3.8__tar.gz

agentpack_cli-0.3.5/README.md → agentpack_cli-0.3.8/PKG-INFO

@@ -1,3 +1,42 @@
+Metadata-Version: 2.4
+Name: agentpack-cli
+Version: 0.3.8
+Summary: Local context engine for AI coding agents that ranks relevant files and builds task-focused context packs.
+License: MIT
+License-File: LICENSE
+Keywords: ai,ai-coding-agents,antigravity,ci,codex,context,context-engine,context-packing,cursor,developer-tools,llm,mcp,packing,prompt-context,repo-analysis,windsurf
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tiktoken>=0.7.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: all
+Requires-Dist: mcp>=1.0.0; extra == 'all'
+Requires-Dist: watchdog>=4.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: watch
+Requires-Dist: watchdog>=4.0.0; extra == 'watch'
+Description-Content-Type: text/markdown
+
 # AgentPack
 
 [![PyPI version](https://img.shields.io/pypi/v/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
@@ -7,7 +46,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.3.5).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Public benchmark proof exists for the current suite, but broader repo coverage is still growing. API may change before 1.0.
+> **Status: alpha (v0.3.8).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Public benchmark proof exists for the current suite, but broader repo coverage is still growing. API may change before 1.0.
 >
 > **Platform note:** macOS, Linux, and Windows are supported. Windows support targets PowerShell plus Git for Windows. `cmd.exe` and bare Git setups are not a supported path yet.
 
@@ -109,7 +148,19 @@ printf '%s\n' "fix auth token expiry" > .agentpack/task.md
 agentpack pack
 ```
 
-This creates `.agentpack/` state, installs the requested agent integration, generates a ranked context pack, and writes the adapter output for that agent. For active local work, keep context fresh with:
+This creates `.agentpack/` state, installs the requested agent integration, seeds `.agentignore` with safe defaults, imports obvious generated/noisy rules from git ignore sources, generates a ranked context pack, and writes the adapter output for that agent.
+
+Task text matters. Good task text names the concrete feature, route, service, or file you are about to change. Bad task text uses repo-meta words like `improve context`, `pack quality`, `stats`, or `ignore`, which can pull README or tool internals by keyword.
+
+```bash
+# good
+printf '%s\n' "fix billing webhook retry handling in app/api/billing/route.ts" > .agentpack/task.md
+
+# too broad
+printf '%s\n' "improve context pack quality from stats" > .agentpack/task.md
+```
+
+For active local work, keep context fresh with:
 
 ```bash
 agentpack watch
@@ -202,6 +253,23 @@ agentpack explain --task "fix billing webhook" --budget-plan
 
 This is the core reliability loop: pack, measure recall, inspect misses, then tune task wording, `.agentignore`, or scoring weights.
 
+If top includes look noisy:
+
+1. Rewrite `.agentpack/task.md` with concrete domain nouns, entrypoints, or filenames.
+2. Re-pack and re-check `agentpack stats`.
+3. If generated output still dominates, add that path to `.agentignore` or run `agentpack ignore sync`.
+4. Use `agentpack explain --file <path>` on repeat offenders before changing scoring.
+
+`.agentignore` is for AgentPack ranking noise, not general git hygiene. `agentpack init` seeds it with safe defaults and imports obvious generated/noisy entries from the root `.gitignore`, nested `.gitignore` files, `.git/info/exclude`, and your global git ignore when they look safe to carry over. You should still add repo-specific outputs such as deploy artifacts, exports, or generated SDK folders when they are not useful context.
+
+When ignore sources change later, re-sync with:
+
+```bash
+agentpack ignore sync
+agentpack ignore sync --dry-run
+agentpack ignore sync --check
+```
+
 ## MCP-First Workflow
 
 For MCP-capable agents, the preferred workflow is pull-based:
@@ -817,6 +885,20 @@ agentpack quickstart --task "fix auth token expiry" --write
 
 ---
 
+### `agentpack ignore sync`
+
+Refresh imported generated/noisy rules inside `.agentignore` without touching your manual entries.
+
+```bash
+agentpack ignore sync
+agentpack ignore sync --dry-run
+agentpack ignore sync --check
+```
+
+Use this after editing `.gitignore`, nested workspace ignores, or `.git/info/exclude`. `doctor` also warns when the imported `.agentignore` block is stale.
+
+---
+
 ### `agentpack watch`
 
 Watch for file and task changes, refresh context automatically.

agentpack_cli-0.3.5/PKG-INFO → agentpack_cli-0.3.8/README.md

@@ -1,42 +1,3 @@
-Metadata-Version: 2.4
-Name: agentpack-cli
-Version: 0.3.5
-Summary: Local context engine for AI coding agents that ranks relevant files and builds task-focused context packs.
-License: MIT
-License-File: LICENSE
-Keywords: ai,ai-coding-agents,antigravity,ci,claude,claude-code,codex,context,context-engine,context-packing,cursor,developer-tools,llm,mcp,packing,prompt-context,repo-analysis,windsurf
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Requires-Dist: pathspec>=0.12.1
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: tiktoken>=0.7.0
-Requires-Dist: tomli-w>=1.0.0
-Requires-Dist: tomli>=2.0.0; python_version < '3.11'
-Requires-Dist: typer>=0.12.0
-Provides-Extra: all
-Requires-Dist: mcp>=1.0.0; extra == 'all'
-Requires-Dist: watchdog>=4.0.0; extra == 'all'
-Provides-Extra: dev
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.0.0; extra == 'mcp'
-Provides-Extra: watch
-Requires-Dist: watchdog>=4.0.0; extra == 'watch'
-Description-Content-Type: text/markdown
-
 # AgentPack
 
 [![PyPI version](https://img.shields.io/pypi/v/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
@@ -46,7 +7,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.3.5).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Public benchmark proof exists for the current suite, but broader repo coverage is still growing. API may change before 1.0.
+> **Status: alpha (v0.3.8).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Public benchmark proof exists for the current suite, but broader repo coverage is still growing. API may change before 1.0.
 >
 > **Platform note:** macOS, Linux, and Windows are supported. Windows support targets PowerShell plus Git for Windows. `cmd.exe` and bare Git setups are not a supported path yet.
 
@@ -148,7 +109,19 @@ printf '%s\n' "fix auth token expiry" > .agentpack/task.md
 agentpack pack
 ```
 
-This creates `.agentpack/` state, installs the requested agent integration, generates a ranked context pack, and writes the adapter output for that agent. For active local work, keep context fresh with:
+This creates `.agentpack/` state, installs the requested agent integration, seeds `.agentignore` with safe defaults, imports obvious generated/noisy rules from git ignore sources, generates a ranked context pack, and writes the adapter output for that agent.
+
+Task text matters. Good task text names the concrete feature, route, service, or file you are about to change. Bad task text uses repo-meta words like `improve context`, `pack quality`, `stats`, or `ignore`, which can pull README or tool internals by keyword.
+
+```bash
+# good
+printf '%s\n' "fix billing webhook retry handling in app/api/billing/route.ts" > .agentpack/task.md
+
+# too broad
+printf '%s\n' "improve context pack quality from stats" > .agentpack/task.md
+```
+
+For active local work, keep context fresh with:
 
 ```bash
 agentpack watch
@@ -241,6 +214,23 @@ agentpack explain --task "fix billing webhook" --budget-plan
 
 This is the core reliability loop: pack, measure recall, inspect misses, then tune task wording, `.agentignore`, or scoring weights.
 
+If top includes look noisy:
+
+1. Rewrite `.agentpack/task.md` with concrete domain nouns, entrypoints, or filenames.
+2. Re-pack and re-check `agentpack stats`.
+3. If generated output still dominates, add that path to `.agentignore` or run `agentpack ignore sync`.
+4. Use `agentpack explain --file <path>` on repeat offenders before changing scoring.
+
+`.agentignore` is for AgentPack ranking noise, not general git hygiene. `agentpack init` seeds it with safe defaults and imports obvious generated/noisy entries from the root `.gitignore`, nested `.gitignore` files, `.git/info/exclude`, and your global git ignore when they look safe to carry over. You should still add repo-specific outputs such as deploy artifacts, exports, or generated SDK folders when they are not useful context.
+
+When ignore sources change later, re-sync with:
+
+```bash
+agentpack ignore sync
+agentpack ignore sync --dry-run
+agentpack ignore sync --check
+```
+
 ## MCP-First Workflow
 
 For MCP-capable agents, the preferred workflow is pull-based:
@@ -856,6 +846,20 @@ agentpack quickstart --task "fix auth token expiry" --write
 
 ---
 
+### `agentpack ignore sync`
+
+Refresh imported generated/noisy rules inside `.agentignore` without touching your manual entries.
+
+```bash
+agentpack ignore sync
+agentpack ignore sync --dry-run
+agentpack ignore sync --check
+```
+
+Use this after editing `.gitignore`, nested workspace ignores, or `.git/info/exclude`. `doctor` also warns when the imported `.agentignore` block is stale.
+
+---
+
 ### `agentpack watch`
 
 Watch for file and task changes, refresh context automatically.

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.5"
+version = "0.3.8"
 description = "Local context engine for AI coding agents that ranks relevant files and builds task-focused context packs."
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "MIT"}
-keywords = ["ai-coding-agents", "developer-tools", "repo-analysis", "context-engine", "context-packing", "prompt-context", "mcp", "ci", "claude-code", "codex", "cursor", "windsurf", "antigravity", "ai", "llm", "context", "packing", "claude"]
+keywords = ["ai-coding-agents", "developer-tools", "repo-analysis", "context-engine", "context-packing", "prompt-context", "mcp", "ci", "codex", "cursor", "windsurf", "antigravity", "ai", "llm", "context", "packing"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/__init__.py

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

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/analysis/ranking.py

@@ -21,10 +21,12 @@ _GENERIC_TASK_TERMS = {
     "add", "added", "change", "changed", "changes", "clean", "cleanup",
     "code", "commit", "context", "debug", "dev", "development", "doc",
     "docs", "eval", "evals", "feature", "fix", "freshness", "general",
-    "impl", "implement", "implementation", "improve", "issue", "metric", "metrics",
-    "noise", "noisy", "package", "pack", "packs", "release", "repo",
-    "source", "sync", "task", "tasks", "test", "tests", "update", "use",
-    "useful", "usefulness", "version", "workflow", "workflows",
+    "gap", "gaps", "generic", "impl", "implement", "implementation", "improve",
+    "issue", "metric", "metrics", "noise", "noisy", "package", "pack", "packs",
+    "quality", "release", "remaining", "repo", "root", "rule", "rules",
+    "source", "stat", "stats", "sync", "task", "tasks", "test", "tests",
+    "text", "update", "use", "useful", "usefulness", "version", "visibility",
+    "workflow", "workflows", "wording",
 }
 
 _CONCEPT_MAP: dict[str, frozenset[str]] = {

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/application/pack_service.py

@@ -223,7 +223,12 @@ class FileRanker:
         scored = boost_cross_layer_related(scored, keyword_weights, weights=cfg.scoring)
         scored = boost_paired_tests(scored, weights=cfg.scoring)
         if root is not None:
-            scored = _apply_history_penalties(root, scored, changes.all_changed)
+            scored = _apply_history_penalties(
+                root,
+                scored,
+                changes.all_changed,
+                generic_ratio=generic_ratio,
+            )
         return RankResult(
             keywords=keywords,
             generic_ratio=generic_ratio,
@@ -324,6 +329,13 @@ class PackPlanner:
                 no_live_changes=not changes.all_changed,
                 effective_budget=effective_budget,
             ),
+            max_weak_signal_files=_guarded_weak_signal_cap(
+                root,
+                request.mode,
+                rank_result.generic_ratio,
+                no_live_changes=not changes.all_changed,
+                effective_budget=effective_budget,
+            ),
         )
         phase_times["select"] = time.perf_counter() - t0
 
@@ -581,6 +593,7 @@ def _apply_history_penalties(
     scored: list[tuple[Any, float, list[str]]],
     changed_paths: set[str],
     *,
+    generic_ratio: float = 0.0,
     window: int = 20,
 ) -> list[tuple[Any, float, list[str]]]:
     """Downrank paths that recent packs proved noisy for later edits."""
@@ -597,7 +610,11 @@ def _apply_history_penalties(
         if count <= 0:
             adjusted.append((fi, score, reasons))
             continue
-        penalty = min(25.0, count * 4.0)
+        has_strong = any(reason.startswith(_NO_LIVE_STRONG_SIGNALS) for reason in reasons)
+        if generic_ratio >= 0.35 and count >= 4 and not has_strong:
+            adjusted.append((fi, 0.0, [*reasons, "repeat noise path suppressed"]))
+            continue
+        penalty = min(45.0, count * 6.0 + max(0, count - 2) * 4.0)
         adjusted.append((fi, max(0.0, score - penalty), [*reasons, f"history noise penalty -{penalty:.0f}"]))
     return adjusted
 
@@ -649,10 +666,7 @@ _NO_LIVE_STRONG_SIGNALS = (
     "content keyword match",
     "matched entrypoint",
     "matched external system",
-    "matched role keyword",
     "matched domain",
-    "matched ranking keyword",
-    "matched define",
     "matched env read",
     "matched side effect",
     "direct dependency",
@@ -663,6 +677,11 @@ _NO_LIVE_STRONG_SIGNALS = (
     "knowledge/architecture doc",
     "historically co-changed",
 )
+_NO_LIVE_META_ONLY_SIGNALS = (
+    "matched role keyword",
+    "matched ranking keyword",
+    "matched define",
+)
 
 
 def _apply_no_live_precision_guard(
@@ -676,19 +695,22 @@ def _apply_no_live_precision_guard(
     filename-only hits, and avoid letting broad task words fan out across repo.
     """
     adjusted: list[tuple[Any, float, list[str]]] = []
-    broad_task = generic_ratio >= 0.35
+    broad_task = generic_ratio >= 0.3
     for fi, score, reasons in scored:
         has_filename = any(reason.startswith("filename keyword match") for reason in reasons)
         has_strong = any(reason.startswith(_NO_LIVE_STRONG_SIGNALS) for reason in reasons)
+        has_meta_only = any(reason.startswith(_NO_LIVE_META_ONLY_SIGNALS) for reason in reasons)
+        if broad_task and has_filename and not has_strong:
+            damped = min(score, max(0.0, score * 0.2))
+            adjusted.append((fi, damped, [*reasons, "broad-task weak-signal dampening"]))
+            continue
         if has_filename and not has_strong:
             damped = min(score, max(0.0, score * 0.35))
             adjusted.append((fi, damped, [*reasons, "no-live filename-only dampening"]))
             continue
-        if broad_task and has_filename and not any(
-            reason.startswith(("symbol keyword match", "content keyword match", "historically co-changed"))
-            for reason in reasons
-        ):
-            adjusted.append((fi, max(0.0, score - 30), [*reasons, "broad-task filename dampening"]))
+        if broad_task and has_meta_only and not has_strong:
+            damped = max(0.0, score * 0.45 - 15)
+            adjusted.append((fi, damped, [*reasons, "broad-task meta-summary dampening"]))
             continue
         adjusted.append((fi, score, reasons))
     return adjusted
@@ -813,6 +835,57 @@ def _guarded_summary_cap(
     return min(cap, strict_cap)
 
 
+def _recent_token_precision(root: Path, window: int = 10) -> tuple[float, int]:
+    metrics_path = root / ".agentpack" / "metrics.jsonl"
+    if not metrics_path.exists():
+        return 1.0, 0
+    values: list[float] = []
+    try:
+        lines = metrics_path.read_text(encoding="utf-8").splitlines()
+    except OSError:
+        return 1.0, 0
+    for line in reversed(lines):
+        try:
+            rec = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        value = rec.get("selection_token_precision")
+        if isinstance(value, int | float):
+            values.append(float(value))
+            if len(values) >= window:
+                break
+    if not values:
+        return 1.0, 0
+    return sum(values) / len(values), len(values)
+
+
+def _guarded_weak_signal_cap(
+    root: Path,
+    mode: str,
+    generic_ratio: float,
+    *,
+    no_live_changes: bool = False,
+    effective_budget: int = 0,
+) -> int:
+    if not no_live_changes:
+        return 0
+    if generic_ratio >= 0.5:
+        base = {"minimal": 0, "balanced": 1, "deep": 2}.get(mode, 1)
+    elif generic_ratio >= 0.35:
+        base = {"minimal": 1, "balanced": 2, "deep": 3}.get(mode, 2)
+    else:
+        base = {"minimal": 2, "balanced": 4, "deep": 6}.get(mode, 3)
+    avg_precision, rows = _recent_token_precision(root)
+    if rows >= 3:
+        if avg_precision <= 0.1:
+            base = min(base, 0 if mode == "minimal" else 1)
+        elif avg_precision <= 0.2:
+            base = min(base, 1 if mode != "deep" else 2)
+    if effective_budget and effective_budget <= 2500:
+        base = min(base, 1)
+    return max(0, base)
+
+
 def _recent_summary_token_precision(root: Path, window: int = 10) -> tuple[float, int]:
     metrics_path = root / ".agentpack" / "metrics.jsonl"
     if not metrics_path.exists():

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/cli.py

@@ -9,6 +9,7 @@ from agentpack.commands import (
     explain,
     guard,
     hook_cmd,
+    ignore_cmd,
     init,
     install,
     mcp_cmd,
@@ -45,6 +46,7 @@ def _main(
 
 for mod in [
     init,
+    ignore_cmd,
     scan,
     diff,
     status,

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/commands/doctor.py

@@ -18,6 +18,7 @@ from agentpack.integrations.global_install import (
 )
 from agentpack.commands._shared import console, _root
 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
 from agentpack.integrations.agents import SUPPORTED_AGENTS, check_agent_integration, expand_agents
 
@@ -121,6 +122,12 @@ def register(app: typer.Typer) -> None:
             console.print(f"  [yellow]![/] Not initialized in {root} — run: agentpack init")
         else:
             console.print("  [green]✓[/] .agentpack/config.toml present")
+            for finding in _agentignore_sync_findings(root):
+                if finding.startswith("synced:"):
+                    console.print(f"  [green]✓[/] {finding.split(':', 1)[1].strip()}")
+                else:
+                    console.print(f"  [yellow]![/] {finding}")
+                    ok = False
             context_path = _latest_context_path(root)
             if context_path.exists():
                 import time
@@ -405,6 +412,17 @@ def _publish_secret_findings(root: Path, env: Mapping[str, str] | None = None) -
     return findings
 
 
+def _agentignore_sync_findings(root: Path) -> list[str]:
+    status = agentignore_sync_status(root)
+    if status.action == "create":
+        return ["missing .agentignore; run `agentpack init` or `agentpack ignore sync`."]
+    if status.is_stale:
+        return ["imported .agentignore rules are stale; run `agentpack ignore sync`."]
+    if status.imported_rules:
+        return [f"synced: {format_import_summary(status)}"]
+    return ["synced: .agentignore present; no imported generated/noisy rules detected."]
+
+
 def _print_summary(ok: bool) -> None:
     console.print("")
     if ok:

agentpack_cli-0.3.8/src/agentpack/commands/ignore_cmd.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import typer
+
+from agentpack.commands._shared import console, _root
+from agentpack.core.ignore import agentignore_sync_status, format_import_summary
+
+
+def register(app: typer.Typer) -> None:
+    ignore_app = typer.Typer(help="Inspect and sync AgentPack ignore rules.")
+
+    @ignore_app.command("sync")
+    def sync(
+        dry_run: bool = typer.Option(False, "--dry-run", help="Show the planned .agentignore update without writing."),
+        check: bool = typer.Option(False, "--check", help="Exit non-zero when .agentignore is stale."),
+    ) -> None:
+        """Sync imported generated/noisy rules into .agentignore."""
+        root = _root()
+        status = agentignore_sync_status(root)
+
+        if dry_run:
+            console.print(f"[bold]Action:[/] {status.action}")
+            if status.imported_rules:
+                console.print(f"[dim]{format_import_summary(status)}[/]")
+            else:
+                console.print("[dim]Imported 0 generated/noisy rules.[/]")
+            raise typer.Exit(0)
+
+        if check:
+            if status.action == "unchanged":
+                console.print("[green].agentignore is in sync.[/]")
+                raise typer.Exit(0)
+            console.print("[yellow].agentignore is stale; run `agentpack ignore sync`.[/]")
+            raise typer.Exit(1)
+
+        previous_action = status.action
+        if previous_action != "unchanged":
+            status.path.parent.mkdir(parents=True, exist_ok=True)
+            status.path.write_text(status.desired_content, encoding="utf-8")
+            status = agentignore_sync_status(root)
+
+        if previous_action == "create":
+            console.print("[green]Created .agentignore.[/]")
+        elif previous_action == "update":
+            console.print("[green]Updated .agentignore.[/]")
+        else:
+            console.print("[green].agentignore already in sync.[/]")
+        if status.imported_rules:
+            console.print(f"[dim]{format_import_summary(status)}[/]")
+
+    app.add_typer(ignore_app, name="ignore")

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/commands/init.py

@@ -8,7 +8,11 @@ from typing import Optional
 import typer
 
 from agentpack.core.config import DEFAULT_CONFIG, CONFIG_TEMPLATE
-from agentpack.core.ignore import DEFAULT_AGENTIGNORE
+from agentpack.core.ignore import (
+    AgentIgnoreSyncStatus,
+    agentignore_sync_status,
+    format_import_summary,
+)
 from agentpack.commands._shared import console, _root
 from agentpack.integrations.agents import check_agent_integration, install_agent_integration
 from agentpack.session.state import load_session, create_session, SESSION_FILE, TASK_FILE
@@ -147,6 +151,24 @@ def _patch_repo_gitignore(root: Path, share_cache: bool = False, agent: str = "g
     return "updated"
 
 
+def _patch_agentignore(
+    root: Path,
+    *,
+    force: bool = False,
+    backups: list[InitResult] | None = None,
+) -> tuple[str, AgentIgnoreSyncStatus]:
+    status = agentignore_sync_status(root)
+    if force and status.path.exists() and backups is not None:
+        backup = _backup_file(status.path)
+        backups.append(InitResult(str(backup.relative_to(root)), "created"))
+    if status.action == "unchanged":
+        return "unchanged", status
+    status.path.parent.mkdir(parents=True, exist_ok=True)
+    status.path.write_text(status.desired_content, encoding="utf-8")
+    action = "created" if status.action == "create" else "updated"
+    return action, agentignore_sync_status(root)
+
+
 def _install_agent_integration(root, agent: str) -> dict[str, str]:
     """Install repo-local agent integration files after `agentpack init`."""
     return install_agent_integration(root, agent)
@@ -222,6 +244,7 @@ def _planned_action(path: Path, expected: str | None = None) -> str:
 
 def _print_dry_run(root: Path, agent: str, share_cache: bool, mode: str | None, budget: int) -> None:
     console.print("[bold yellow]Dry run — no files will be changed.[/]\n")
+    ignore_status = agentignore_sync_status(root)
     items = [
         InitResult(".agentpack/", "ensure"),
         InitResult(".agentpack/snapshots/", "ensure"),
@@ -229,7 +252,7 @@ def _print_dry_run(root: Path, agent: str, share_cache: bool, mode: str | None,
         InitResult(".agentpack/.gitignore", _planned_action(root / ".agentpack" / ".gitignore")),
         InitResult(".gitignore", _planned_action(root / ".gitignore")),
         InitResult(".agentpack/config.toml", _planned_action(root / ".agentpack" / "config.toml")),
-        InitResult(".agentignore", _planned_action(root / ".agentignore", DEFAULT_AGENTIGNORE)),
+        InitResult(".agentignore", ignore_status.action),
         InitResult(SESSION_FILE, _planned_action(root / SESSION_FILE)),
         InitResult(TASK_FILE, _planned_action(root / TASK_FILE)),
     ]
@@ -240,6 +263,8 @@ def _print_dry_run(root: Path, agent: str, share_cache: bool, mode: str | None,
     console.print(f"  Mode: {mode or DEFAULT_CONFIG.context.default_mode}")
     console.print(f"  Budget: {budget or DEFAULT_CONFIG.context.default_budget:,}")
     console.print(f"  Share cache: {'yes' if share_cache else 'no'}")
+    if ignore_status.imported_rules:
+        console.print(f"  {format_import_summary(ignore_status)}")
 
 
 def _print_init_summary(title: str, results: list[InitResult]) -> None:
@@ -369,12 +394,8 @@ def register(app: typer.Typer) -> None:
         else:
             results.append(InitResult(".agentpack/config.toml", "unchanged"))
 
-        ignore_path = root / ".agentignore"
-        if not ignore_path.exists() or force:
-            action = _write_text(root, ignore_path, DEFAULT_AGENTIGNORE, force=force, backups=backups)
-            results.append(InitResult(".agentignore", action))
-        else:
-            results.append(InitResult(".agentignore", "unchanged"))
+        ignore_action, ignore_status = _patch_agentignore(root, force=force, backups=backups)
+        results.append(InitResult(".agentignore", ignore_action))
 
         # Bootstrap session so `agentpack watch` works immediately — no separate `session start` needed
         from agentpack.core.config import load_config
@@ -402,6 +423,8 @@ def register(app: typer.Typer) -> None:
         if backups:
             _print_init_summary("Backups", backups)
         _print_init_summary("Init Summary", results)
+        if ignore_status.imported_rules:
+            console.print(f"  [dim]{format_import_summary(ignore_status)}[/]")
         if health_check:
             _print_health(root, resolved_agent)
         console.print(f"\n[bold green]AgentPack initialized.[/] [dim]agent={resolved_agent} mode={resolved_mode}[/]")

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/commands/pack.py

@@ -233,8 +233,11 @@ def _pack_diagnostics(result: PackResult) -> list[str]:
         part for part in result.pack.task.replace("_", " ").replace("-", " ").split()
         if len(part) >= 3
     ]
+    generic_ratio = float((result.pack.freshness or {}).get("generic_task_ratio") or 0.0)
     if len(task_words) <= 3:
         diagnostics.append("Task is very short; add subsystem, file, or symptom words for better precision.")
+    if generic_ratio >= 0.5:
+        diagnostics.append("Task terms are broad/generic; name concrete file, route, service, or symptom words.")
     if not result.changed_files:
         diagnostics.append("No changed files detected; pack relies mostly on task keywords and cached summaries.")
     if selected and not strong_live_signal and filename_matches / len(selected) >= 0.6:

{agentpack_cli-0.3.5 → agentpack_cli-0.3.8}/src/agentpack/commands/stats.py

@@ -346,6 +346,7 @@ def _noise_diagnostics(
             diagnostics.append("Latest pack is mostly summaries; use minimal mode or a narrower task for edit work.")
         if filename_matches / len(visible_top) >= 0.6:
             diagnostics.append("Top files mostly matched by filename; task terms may be broad.")
+            diagnostics.append("Rewrite `.agentpack/task.md` with concrete file, route, service, or symptom words.")
 
     if accuracy_rows:
         avg_precision = sum(r["selection_precision"] for r in accuracy_rows) / len(accuracy_rows)
@@ -380,9 +381,9 @@ def _noise_diagnostics(
             first_path = noisy[0][0]
             diagnostics.append(
                 f"Inspect top noisy path: `agentpack explain --file {first_path} --task auto`; "
-                "add generated/vendor paths to `.agentignore` or tighten task wording if it is not useful."
+                "add generated/vendor paths to `.agentignore`, run `agentpack ignore sync`, or tighten task wording if it is not useful."
             )
-    return diagnostics[:8]
+    return diagnostics[:9]
 
 
 def _top_files_from_metadata(meta: dict) -> list[tuple[str, str, str]]: