agentpack-cli 0.1.19__tar.gz → 0.1.20__tar.gz

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.19
+Version: 0.1.20
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.19).** 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.20).** 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.
 
@@ -1298,7 +1298,23 @@ Skip writing a task description — agentpack infers it from your branch name, c
 agentpack pack --task auto
 ```
 
-Priority order: branch name → changed file paths → recent commit message. The more descriptive your branch names (`feat/add-rate-limiting` beats `dev`), the better the inferred task.
+Priority order (strongest → weakest):
+
+| Source | Example output |
+|--------|---------------|
+| `task.md` (explicit) | `"migrate DB schema to multi-tenant"` |
+| branch + staged files | `"feat add-rate-limiting: payments, throttle"` |
+| staged files only | `"payments, throttle"` |
+| branch + unstaged | `"feat add-rate-limiting: session, token"` |
+| branch + latest commit | `"feat add-rate-limiting: fix token expiry check"` |
+| branch name alone | `"feat add-rate-limiting"` |
+| unstaged files | `"session, token"` |
+| recent commit messages | `"fix token expiry check; add pagination"` |
+| recently modified files | `"session, payments"` (noisy — last resort) |
+
+The heuristic that fired is logged: `Auto task (branch+staged): feat add-rate-limiting: payments`.
+
+The more descriptive your branch names (`feat/add-rate-limiting` beats `dev`) and the more you stage before running, the more accurate the inference.
 
 ### Concept synonym expansion
 

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/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.19).** 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.20).** 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.
 
@@ -1259,7 +1259,23 @@ Skip writing a task description — agentpack infers it from your branch name, c
 agentpack pack --task auto
 ```
 
-Priority order: branch name → changed file paths → recent commit message. The more descriptive your branch names (`feat/add-rate-limiting` beats `dev`), the better the inferred task.
+Priority order (strongest → weakest):
+
+| Source | Example output |
+|--------|---------------|
+| `task.md` (explicit) | `"migrate DB schema to multi-tenant"` |
+| branch + staged files | `"feat add-rate-limiting: payments, throttle"` |
+| staged files only | `"payments, throttle"` |
+| branch + unstaged | `"feat add-rate-limiting: session, token"` |
+| branch + latest commit | `"feat add-rate-limiting: fix token expiry check"` |
+| branch name alone | `"feat add-rate-limiting"` |
+| unstaged files | `"session, token"` |
+| recent commit messages | `"fix token expiry check; add pagination"` |
+| recently modified files | `"session, payments"` (noisy — last resort) |
+
+The heuristic that fired is logged: `Auto task (branch+staged): feat add-rate-limiting: payments`.
+
+The more descriptive your branch names (`feat/add-rate-limiting` beats `dev`) and the more you stage before running, the more accurate the inference.
 
 ### Concept synonym expansion
 

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.19"
+version = "0.1.20"
 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.19 → agentpack_cli-0.1.20}/src/agentpack/__init__.py

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

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/src/agentpack/commands/hook_cmd.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import re
 import subprocess
 import sys
 from pathlib import Path
@@ -8,9 +9,14 @@ from pathlib import Path
 import typer
 
 from agentpack.commands._shared import _root
+from agentpack.core import git as _git
 
 _TASK_FILE = ".agentpack/task.md"
 _TASK_FILE_DEFAULT_MARKER = "Write or update the current coding task here."
+_CODING_PROMPT_RE = re.compile(
+    r"(?:fix|add|refactor|impl|implement|update|write|debug|test|build|migrate|remove|delete|rename|optimize)\b",
+    re.IGNORECASE,
+)
 
 
 def register(app: typer.Typer) -> None:
@@ -69,12 +75,22 @@ def _load_task_md(root: Path) -> str:
         return ""
 
 
+def _looks_like_coding_prompt(prompt: str) -> bool:
+    """Return True if prompt looks like a coding task (not a slash command or chat)."""
+    stripped = prompt.strip()
+    if stripped.startswith("/"):
+        return False
+    return bool(_CODING_PROMPT_RE.search(stripped))
+
+
 def _resolve_task(root: Path, prompt: str) -> str:
     """Merge task.md + prompt into best task description for repack."""
     task_md = _load_task_md(root)
     if task_md:
         return task_md
-    return prompt[:200].strip() if prompt else "auto"
+    if prompt and _looks_like_coding_prompt(prompt):
+        return prompt[:200].strip()
+    return "auto"
 
 
 def _load_hints(root: Path, n: int = 5) -> list[dict]:
@@ -116,6 +132,15 @@ def _load_pack_task(root: Path) -> str:
         return ""
 
 
+def _infer_live_task(root: Path) -> str:
+    """Live task: git priority chain (no stale metadata). Falls back to 'unknown'."""
+    try:
+        task, _ = _git.infer_task_with_source(root)
+        return task
+    except Exception:
+        return "unknown"
+
+
 def _current_root_hash(root: Path) -> str | None:
     snap = root / ".agentpack" / "snapshots" / "latest.json"
     if not snap.exists():
@@ -179,7 +204,7 @@ def _run_user_prompt_submit(root: Path) -> None:
                 for h in hints
             )
             status_note = "(repacking — call pack_context for fresh results)" if repo_changed else "(index fresh)"
-            current_task = _load_task_md(root) or _load_pack_task(root) or "unknown"
+            current_task = _load_task_md(root) or _infer_live_task(root)
             msg = (
                 f"AgentPack {status_note}\n"
                 f"task: {current_task}\n"
@@ -193,7 +218,7 @@ def _run_user_prompt_submit(root: Path) -> None:
             )
     else:
         hints = _load_hints(root, n=8)
-        current_task = _load_task_md(root) or _load_pack_task(root) or "unknown"
+        current_task = _load_task_md(root) or _infer_live_task(root)
         if hints:
             files_lines = "\n".join(
                 f"  - {h['path']}" + (f" — {h['why']}" if h.get("why") else "")

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/src/agentpack/commands/pack.py

@@ -64,8 +64,19 @@ def _resolve_agent(agent: str) -> str:
 def _resolve_task(task: str) -> str:
     if task != "auto":
         return task
-    inferred = git.infer_task_from_git(_root())
-    console.print(f"[dim]Auto task: {inferred}[/]")
+    root = _root()
+    # task.md takes priority over all git heuristics
+    task_md_path = root / ".agentpack" / "task.md"
+    if task_md_path.exists():
+        content = task_md_path.read_text(encoding="utf-8").strip()
+        lines = [ln for ln in content.splitlines() if ln.strip() and not ln.startswith("#")]
+        body = lines[0].strip() if lines else ""
+        _PLACEHOLDER = "Write or update the current coding task here."
+        if body and _PLACEHOLDER not in body:
+            console.print(f"[dim]Auto task (task.md): {body}[/]")
+            return body
+    inferred, source = git.infer_task_with_source(root)
+    console.print(f"[dim]Auto task ({source}): {inferred}[/]")
     return inferred
 
 

{agentpack_cli-0.1.19 → agentpack_cli-0.1.20}/src/agentpack/core/git.py

@@ -94,12 +94,44 @@ def file_churn_counts(root: Path, max_commits: int = 200) -> dict[str, int]:
     return counts
 
 
-def infer_task_from_git(root: Path) -> str:
-    """Infer a task description from branch name, changed files, and recent commits.
-
-    Priority: branch name + changed files → branch name → changed files →
-              recent commit messages (up to 3) → recently modified files → fallback.
+def staged_files(root: Path) -> set[str]:
+    """Files staged for commit (git index only)."""
+    out = _run(["git", "diff", "--cached", "--name-only"], root)
+    if not out:
+        return set()
+    return {line.strip() for line in out.splitlines() if line.strip()}
+
+
+def infer_task_with_source(root: Path) -> tuple[str, str]:
+    """Infer task description with the heuristic that fired.
+
+    Priority (strongest → weakest):
+      branch+staged    staged files present + branch name
+      staged           staged files, no branch
+      branch+unstaged  unstaged changes + branch name
+      branch+commit    branch + latest commit message
+      branch           branch name alone
+      unstaged         unstaged changes, no branch
+      commits          recent commit messages
+      recently_modified git log history (noisy — last resort)
+      fallback         "general development"
     """
+    if not is_git_repo(root):
+        return "general development", "fallback"
+
+    staged = staged_files(root)
+
+    unstaged_out = _run(["git", "diff", "--name-only"], root)
+    unstaged: set[str] = set()
+    if unstaged_out:
+        for line in unstaged_out.splitlines():
+            line = line.strip()
+            if line:
+                unstaged.add(line)
+
+    staged_topic = _topic_from_paths(staged) if staged else None
+    unstaged_topic = _topic_from_paths(unstaged) if unstaged else None
+
     branch: str | None = None
     branch_out = _run(["git", "rev-parse", "--abbrev-ref", "HEAD"], root)
     if branch_out:
@@ -108,11 +140,6 @@ def infer_task_from_git(root: Path) -> str:
             slug = b.split("/", 1)[-1]
             branch = slug.replace("-", " ").replace("_", " ")
 
-    # Changed files are the strongest signal for *current* work
-    changed = changed_files(root)
-    file_topic = _topic_from_paths(changed) if changed else None
-
-    # Collect recent non-merge commit messages (up to 3) for richer fallback
     commit_msgs: list[str] = []
     log_out = _run(["git", "log", "--oneline", "-10"], root)
     if log_out:
@@ -126,26 +153,36 @@ def infer_task_from_git(root: Path) -> str:
             if len(commit_msgs) == 3:
                 break
 
-    # When branch is clean (no changed files), fall back to recently touched files
-    # so keyword scoring has something to work with beyond the branch name alone.
-    if not file_topic and not branch:
-        recent = recently_modified_files(root, n=10)
-        file_topic = _topic_from_paths(set(recent)) if recent else None
-
-    if branch and file_topic:
-        return f"{branch}: {file_topic}"
+    if branch and staged_topic:
+        return f"{branch}: {staged_topic}", "branch+staged"
+    if staged_topic:
+        return staged_topic, "staged"
+    if branch and unstaged_topic:
+        return f"{branch}: {unstaged_topic}", "branch+unstaged"
     if branch and commit_msgs:
-        # Augment bare branch name with latest commit context
-        return f"{branch}: {commit_msgs[0]}"
+        return f"{branch}: {commit_msgs[0]}", "branch+commit"
     if branch:
-        return branch
-    if file_topic and commit_msgs:
-        return f"{file_topic}: {commit_msgs[0]}"
-    if file_topic:
-        return file_topic
+        return branch, "branch"
+    if unstaged_topic and commit_msgs:
+        return f"{unstaged_topic}: {commit_msgs[0]}", "unstaged+commit"
+    if unstaged_topic:
+        return unstaged_topic, "unstaged"
     if commit_msgs:
-        return "; ".join(commit_msgs[:2])
-    return "general development"
+        return "; ".join(commit_msgs[:2]), "commits"
+
+    # Last resort: historical git log — only fires when no live signal found
+    recent = recently_modified_files(root, n=10)
+    recent_topic = _topic_from_paths(set(recent)) if recent else None
+    if recent_topic:
+        return recent_topic, "recently_modified"
+
+    return "general development", "fallback"
+
+
+def infer_task_from_git(root: Path) -> str:
+    """Infer a task description from git state. See infer_task_with_source for priority chain."""
+    task, _ = infer_task_with_source(root)
+    return task
 
 
 def _topic_from_paths(paths: set[str]) -> str | None: