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

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

@@ -1,3 +1,42 @@
+Metadata-Version: 2.4
+Name: agentpack-cli
+Version: 0.3.9
+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.9).** 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:
@@ -539,6 +607,7 @@ Command map:
 | `agentpack monitor` | Review recent pack runs and quality signals |
 | `agentpack scan` | Inspect packable, ignored, binary, and largest files |
 | `agentpack global-install` | Install opt-in global hooks for initialized repos |
+| `agentpack global-repair-hooks` | Repair stale global template hooks and current repo git hooks |
 
 ### `agentpack global-install`
 
@@ -554,7 +623,7 @@ agentpack global-install --agent antigravity   # Antigravity
 ```
 
 What it does:
-- **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout`: silently repacks **only if `.agentpack/config.toml` exists** — no-op in repos that haven't opted in.
+- **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout` they call AgentPack's cross-platform `GitAutoRepack` hook runner and always exit cleanly. Repacking still happens only in opted-in repos; fresh clones without `.agentpack/config.toml` remain a safe no-op.
 - **Shell cd hook** (`~/.zshrc`, `~/.bashrc`, or the PowerShell profile on Windows) — on `cd` or prompt refresh, repacks if stale **only in opted-in repos**. Never touches repos without `.agentpack/config.toml`. Never auto-inits.
 - **Agent config** — same agent-specific files that `agentpack init --agent <x>` or `agentpack install --agent <x>` writes for the current project.
 
@@ -576,6 +645,27 @@ Preview before committing:
 agentpack global-install --dry-run
 ```
 
+If you installed an older AgentPack build and want to refresh copied git hooks after an upgrade, run:
+
+```bash
+agentpack global-repair-hooks
+```
+
+That repairs `~/.git-templates/hooks/`, reasserts `git config --global init.templateDir`, and updates the current repo's `.git/hooks/` to the safe `GitAutoRepack` path.
+
+### `agentpack global-repair-hooks`
+
+Refresh AgentPack's global git template hooks and the current repo's local git hooks after an upgrade.
+
+```bash
+agentpack global-repair-hooks
+```
+
+Use this when:
+- old template hooks were copied before the `GitAutoRepack` runner existed
+- a stale hook script still shells out directly instead of calling `agentpack hook`
+- you want new clones and the current repo to pick up the latest non-destructive hook behavior immediately
+
 ---
 
 ### `agentpack global-uninstall`
@@ -817,6 +907,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.9/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.9).** 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:
@@ -578,6 +568,7 @@ Command map:
 | `agentpack monitor` | Review recent pack runs and quality signals |
 | `agentpack scan` | Inspect packable, ignored, binary, and largest files |
 | `agentpack global-install` | Install opt-in global hooks for initialized repos |
+| `agentpack global-repair-hooks` | Repair stale global template hooks and current repo git hooks |
 
 ### `agentpack global-install`
 
@@ -593,7 +584,7 @@ agentpack global-install --agent antigravity   # Antigravity
 ```
 
 What it does:
-- **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout`: silently repacks **only if `.agentpack/config.toml` exists** — no-op in repos that haven't opted in.
+- **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout` they call AgentPack's cross-platform `GitAutoRepack` hook runner and always exit cleanly. Repacking still happens only in opted-in repos; fresh clones without `.agentpack/config.toml` remain a safe no-op.
 - **Shell cd hook** (`~/.zshrc`, `~/.bashrc`, or the PowerShell profile on Windows) — on `cd` or prompt refresh, repacks if stale **only in opted-in repos**. Never touches repos without `.agentpack/config.toml`. Never auto-inits.
 - **Agent config** — same agent-specific files that `agentpack init --agent <x>` or `agentpack install --agent <x>` writes for the current project.
 
@@ -615,6 +606,27 @@ Preview before committing:
 agentpack global-install --dry-run
 ```
 
+If you installed an older AgentPack build and want to refresh copied git hooks after an upgrade, run:
+
+```bash
+agentpack global-repair-hooks
+```
+
+That repairs `~/.git-templates/hooks/`, reasserts `git config --global init.templateDir`, and updates the current repo's `.git/hooks/` to the safe `GitAutoRepack` path.
+
+### `agentpack global-repair-hooks`
+
+Refresh AgentPack's global git template hooks and the current repo's local git hooks after an upgrade.
+
+```bash
+agentpack global-repair-hooks
+```
+
+Use this when:
+- old template hooks were copied before the `GitAutoRepack` runner existed
+- a stale hook script still shells out directly instead of calling `agentpack hook`
+- you want new clones and the current repo to pick up the latest non-destructive hook behavior immediately
+
 ---
 
 ### `agentpack global-uninstall`
@@ -856,6 +868,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.9}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.5"
+version = "0.3.9"
 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.9}/src/agentpack/__init__.py

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