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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.25
+Version: 0.1.26
 Summary: Task-aware context packing for AI coding agents — Claude, Cursor, Windsurf, Codex, and Antigravity
 License: MIT
 License-File: LICENSE
@@ -377,7 +377,7 @@ Configures:
 - `CLAUDE.md` — tells Claude to read the context pack before each task
 - `.claude/settings.json` — two hooks:
   - `SessionStart`: clears injection sentinel so first prompt gets context
-  - `UserPromptSubmit`: runs `agentpack hook` — detects repo changes via `root_hash`, triggers background repack using your prompt as task. With MCP: emits Option-B hint (~100 tokens, task + top files). Without MCP: emits capped fallback (top 8 files, ≤3k chars)
+  - `UserPromptSubmit`: runs `agentpack hook` — detects repo changes via `root_hash`, detects clear task switches, updates `.agentpack/task.md`, and triggers background repack using your prompt as task. With MCP: emits Option-B hint (~100 tokens, task + top files). Without MCP: emits capped fallback (top 8 files, ≤3k chars)
 
 After this, context is injected automatically into every Claude Code session. No `/agentpack` command needed — it just happens.
 
@@ -388,7 +388,7 @@ agentpack install --agent cursor
 ```
 
 Configures:
-- `.cursorrules` — rule: read `.agentpack/context.md` before every conversation
+- `.cursorrules` — rule: write current task, run `agentpack pack --task auto`, then read `.agentpack/context.md`
 - `.cursor/rules/agentpack.mdc` — `alwaysApply: true` rule (Cursor v0.43+)
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
@@ -400,7 +400,7 @@ agentpack install --agent windsurf
 ```
 
 Configures:
-- `.windsurfrules` — rule: read `.agentpack/context.md` before every conversation
+- `.windsurfrules` — rule: write current task, run `agentpack pack --task auto`, then read `.agentpack/context.md`
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
@@ -411,7 +411,7 @@ agentpack install --agent codex
 ```
 
 Configures:
-- `AGENTS.md` — tells Codex to read the context pack before each task
+- `AGENTS.md` — tells Codex to write current task, repack, and read the context pack before each task
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 
 ### Antigravity
@@ -422,7 +422,7 @@ agentpack install --agent antigravity
 
 Configures:
 - `.agent/skills/agentpack/SKILL.md` — AgentPack context as a Skill; Antigravity activates it automatically for coding tasks
-- `GEMINI.md` — registers the agentpack skill reference
+- `GEMINI.md` — registers the agentpack skill reference and task-switch protocol
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
@@ -1063,6 +1063,10 @@ include_tests = true
 include_configs = true
 include_receipts = true
 
+[hooks]
+task_switch_detection = true
+task_switch_min_terms = 1
+
 [agents.claude]
 output = ".agentpack/context.claude.md"
 patch_claude_md = true

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/README.md

@@ -338,7 +338,7 @@ Configures:
 - `CLAUDE.md` — tells Claude to read the context pack before each task
 - `.claude/settings.json` — two hooks:
   - `SessionStart`: clears injection sentinel so first prompt gets context
-  - `UserPromptSubmit`: runs `agentpack hook` — detects repo changes via `root_hash`, triggers background repack using your prompt as task. With MCP: emits Option-B hint (~100 tokens, task + top files). Without MCP: emits capped fallback (top 8 files, ≤3k chars)
+  - `UserPromptSubmit`: runs `agentpack hook` — detects repo changes via `root_hash`, detects clear task switches, updates `.agentpack/task.md`, and triggers background repack using your prompt as task. With MCP: emits Option-B hint (~100 tokens, task + top files). Without MCP: emits capped fallback (top 8 files, ≤3k chars)
 
 After this, context is injected automatically into every Claude Code session. No `/agentpack` command needed — it just happens.
 
@@ -349,7 +349,7 @@ agentpack install --agent cursor
 ```
 
 Configures:
-- `.cursorrules` — rule: read `.agentpack/context.md` before every conversation
+- `.cursorrules` — rule: write current task, run `agentpack pack --task auto`, then read `.agentpack/context.md`
 - `.cursor/rules/agentpack.mdc` — `alwaysApply: true` rule (Cursor v0.43+)
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
@@ -361,7 +361,7 @@ agentpack install --agent windsurf
 ```
 
 Configures:
-- `.windsurfrules` — rule: read `.agentpack/context.md` before every conversation
+- `.windsurfrules` — rule: write current task, run `agentpack pack --task auto`, then read `.agentpack/context.md`
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
@@ -372,7 +372,7 @@ agentpack install --agent codex
 ```
 
 Configures:
-- `AGENTS.md` — tells Codex to read the context pack before each task
+- `AGENTS.md` — tells Codex to write current task, repack, and read the context pack before each task
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 
 ### Antigravity
@@ -383,7 +383,7 @@ agentpack install --agent antigravity
 
 Configures:
 - `.agent/skills/agentpack/SKILL.md` — AgentPack context as a Skill; Antigravity activates it automatically for coding tasks
-- `GEMINI.md` — registers the agentpack skill reference
+- `GEMINI.md` — registers the agentpack skill reference and task-switch protocol
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
@@ -1024,6 +1024,10 @@ include_tests = true
 include_configs = true
 include_receipts = true
 
+[hooks]
+task_switch_detection = true
+task_switch_min_terms = 1
+
 [agents.claude]
 output = ".agentpack/context.claude.md"
 patch_claude_md = true

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

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

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

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/commands/hook_cmd.py

@@ -10,6 +10,7 @@ import typer
 
 from agentpack.commands._shared import _root
 from agentpack.core import git as _git
+from agentpack.core.config import load_config
 
 _TASK_FILE = ".agentpack/task.md"
 _TASK_FILE_DEFAULT_MARKER = "Write or update the current coding task here."
@@ -17,6 +18,37 @@ _CODING_PROMPT_RE = re.compile(
     r"(?:fix|add|refactor|impl|implement|update|write|debug|test|build|migrate|remove|delete|rename|optimize)\b",
     re.IGNORECASE,
 )
+_TASK_STOPWORDS = {
+    "add",
+    "all",
+    "and",
+    "bug",
+    "build",
+    "can",
+    "change",
+    "changes",
+    "code",
+    "delete",
+    "fix",
+    "for",
+    "implement",
+    "improve",
+    "make",
+    "please",
+    "refactor",
+    "remove",
+    "task",
+    "test",
+    "that",
+    "the",
+    "these",
+    "this",
+    "update",
+    "with",
+    "work",
+    "write",
+    "you",
+}
 
 
 def register(app: typer.Typer) -> None:
@@ -83,13 +115,66 @@ def _looks_like_coding_prompt(prompt: str) -> bool:
     return bool(_CODING_PROMPT_RE.search(stripped))
 
 
-def _resolve_task(root: Path, prompt: str) -> str:
+def _prompt_task(prompt: str) -> str:
+    if not prompt or not _looks_like_coding_prompt(prompt):
+        return ""
+    task = " ".join(prompt.strip().split())[:200]
+    if not _task_terms(task):
+        return ""
+    return task
+
+
+def _task_terms(text: str) -> set[str]:
+    terms: set[str] = set()
+    for raw in re.findall(r"[A-Za-z0-9][A-Za-z0-9_-]*", text.lower()):
+        for part in re.split(r"[-_]", raw):
+            if len(part) >= 3 and part not in _TASK_STOPWORDS:
+                terms.add(part)
+    return terms
+
+
+def _looks_like_task_switch(current_task: str, prompt: str, min_terms: int = 1) -> bool:
+    """Heuristic: a coding prompt with disjoint concrete terms likely starts a new task."""
+    prompt_task = _prompt_task(prompt)
+    if not current_task or not prompt_task:
+        return False
+    if current_task.strip().lower() == prompt_task.lower():
+        return False
+    current_terms = _task_terms(current_task)
+    prompt_terms = _task_terms(prompt_task)
+    required_terms = max(1, min_terms)
+    if len(current_terms) < required_terms or len(prompt_terms) < required_terms:
+        return False
+    return bool(current_terms and prompt_terms and current_terms.isdisjoint(prompt_terms))
+
+
+def _write_task_md(root: Path, task: str) -> None:
+    task_path = root / _TASK_FILE
+    task_path.parent.mkdir(parents=True, exist_ok=True)
+    task_path.write_text(task.strip() + "\n", encoding="utf-8")
+
+
+def _resolve_task(
+    root: Path,
+    prompt: str,
+    *,
+    task_switch_detection: bool = True,
+    task_switch_min_terms: int = 1,
+) -> str:
     """Merge task.md + prompt into best task description for repack."""
     task_md = _load_task_md(root)
+    prompt_task = _prompt_task(prompt)
+    if (
+        task_switch_detection
+        and task_md
+        and prompt_task
+        and _looks_like_task_switch(task_md, prompt_task, min_terms=task_switch_min_terms)
+    ):
+        return prompt_task
     if task_md:
         return task_md
-    if prompt and _looks_like_coding_prompt(prompt):
-        return prompt[:200].strip()
+    if prompt_task:
+        return prompt_task
     return "auto"
 
 
@@ -177,13 +262,37 @@ def _run_user_prompt_submit(root: Path) -> None:
     except Exception:
         prompt = ""
 
-    task = _resolve_task(root, prompt)
+    cfg = load_config(root)
+    task_md = _load_task_md(root)
+    task_switched = bool(
+        cfg.hooks.task_switch_detection
+        and _looks_like_task_switch(
+            task_md,
+            prompt,
+            min_terms=cfg.hooks.task_switch_min_terms,
+        )
+    )
+    task = _resolve_task(
+        root,
+        prompt,
+        task_switch_detection=cfg.hooks.task_switch_detection,
+        task_switch_min_terms=cfg.hooks.task_switch_min_terms,
+    )
+    if task_switched and task != "auto":
+        try:
+            _write_task_md(root, task)
+        except Exception:
+            pass
 
     current_hash = _current_root_hash(root)
     reminded_hash = snap_sentinel.read_text().strip() if snap_sentinel.exists() else None
     repo_changed = current_hash != reminded_hash
+    packed_task = _load_pack_task(root)
+    pack_task_changed = bool(task != "auto" and packed_task and packed_task != task)
+
+    should_repack = repo_changed or task_switched or pack_task_changed
 
-    if repo_changed:
+    if should_repack:
         subprocess.Popen(
             ["agentpack", "pack", "--task", task, "--mode", "balanced", "--since", "HEAD~1"],
             stdout=subprocess.DEVNULL,
@@ -203,7 +312,7 @@ def _run_user_prompt_submit(root: Path) -> None:
                 f"  - {h['path']}" + (f" — {h['why']}" if h.get("why") else "")
                 for h in hints
             )
-            status_note = "(repacking — call pack_context for fresh results)" if repo_changed else "(index fresh)"
+            status_note = "(repacking — call pack_context for fresh results)" if should_repack else "(index fresh)"
             current_task = _load_task_md(root) or _infer_live_task(root)
             msg = (
                 f"AgentPack {status_note}\n"
@@ -224,7 +333,7 @@ def _run_user_prompt_submit(root: Path) -> None:
                 f"  - {h['path']}" + (f" — {h['why']}" if h.get("why") else "")
                 for h in hints
             )
-            changed_note = " (repacking in background)" if repo_changed else ""
+            changed_note = " (repacking in background)" if should_repack else ""
             msg = (
                 f"AgentPack context{changed_note}\n"
                 f"task: {current_task}\n"

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

@@ -245,7 +245,10 @@ def _freshness_diagnostics(
 
     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.")
+        diagnostics.append(
+            ".agentpack/task.md differs from the latest packed task "
+            f"(packed: {meta.get('task')}; current: {task_md})."
+        )
 
     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.")

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

@@ -11,6 +11,24 @@ from agentpack.application.pack_service import AdapterRegistry
 from agentpack.commands._shared import console, _root
 
 
+def _task_md_body(root) -> str:
+    path = root / ".agentpack" / "task.md"
+    if not path.exists():
+        return ""
+    try:
+        lines = [
+            line.strip()
+            for line in path.read_text(encoding="utf-8").splitlines()
+            if line.strip() and not line.startswith("#")
+        ]
+    except OSError:
+        return ""
+    body = lines[0] if lines else ""
+    if "Write or update the current coding task here." in body:
+        return ""
+    return body
+
+
 def register(app: typer.Typer) -> None:
     @app.command()
     def status() -> None:
@@ -32,12 +50,19 @@ def register(app: typer.Typer) -> None:
         )
         current = build_snapshot(scan_result.packable)
 
-        if current["root_hash"] == meta.get("snapshot_root_hash"):
+        task_md = _task_md_body(root)
+        task_changed = bool(task_md and task_md != meta.get("task"))
+        if current["root_hash"] == meta.get("snapshot_root_hash") and not task_changed:
             console.print("[green]Context pack is up to date.[/]")
             console.print(f"  Task: {meta.get('task')}")
             console.print(f"  Generated: {meta.get('generated_at')}")
         else:
-            console.print("[yellow]Context pack is STALE.[/] Files changed since last pack.")
+            if task_changed:
+                console.print("[yellow]Context pack is STALE.[/] .agentpack/task.md changed since last pack.")
+                console.print(f"  Packed task: {meta.get('task')}")
+                console.print(f"  Current task: {task_md}")
+            else:
+                console.print("[yellow]Context pack is STALE.[/] Files changed since last pack.")
             console.print(f"  Last generated: {meta.get('generated_at')}")
             console.print("  Run [bold]agentpack pack[/] to refresh.")
             raise typer.Exit(1)

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/core/config.py

@@ -36,6 +36,11 @@ class SummaryConfig(BaseModel):
     schema_version: int = 1
 
 
+class HooksConfig(BaseModel):
+    task_switch_detection: bool = True
+    task_switch_min_terms: int = 1
+
+
 class AgentConfig(BaseModel):
     output: str
     patch_claude_md: bool = False
@@ -78,6 +83,7 @@ class Config(BaseModel):
     project: ProjectConfig = Field(default_factory=ProjectConfig)
     context: ContextConfig = Field(default_factory=ContextConfig)
     summary: SummaryConfig = Field(default_factory=SummaryConfig)
+    hooks: HooksConfig = Field(default_factory=HooksConfig)
     agents: AgentsConfig = Field(default_factory=AgentsConfig)
     scoring: ScoringWeights = Field(default_factory=ScoringWeights)
 
@@ -105,6 +111,12 @@ include_tests = true
 include_configs = true
 include_receipts = true
 
+[hooks]
+# Claude UserPromptSubmit can detect a clearly different coding prompt,
+# update .agentpack/task.md, and repack even if files did not change.
+task_switch_detection = true
+task_switch_min_terms = 1
+
 [scoring]
 # Scoring weights — higher wins budget allocation.
 # Tune these to make agentpack favour your team's file layout.

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/data/agentpack.md

@@ -33,9 +33,9 @@ Pack repo context and immediately start working on the task.
 
 If a session is already running (`.agentpack/session.json` exists and `"active": true`):
 
-1. Read `.agentpack/context.md` — context is already fresh.
-2. If the user gives a new coding task, write a one-line summary to `.agentpack/task.md`.
-3. Re-read `.agentpack/context.md` after watch mode refreshes it (a few seconds).
+1. If the user gives a new coding task, write a one-line summary to `.agentpack/task.md`.
+2. Run `agentpack pack --task auto` unless watch mode already refreshed after the task write.
+3. Read `.agentpack/context.md` — context now matches the current task.
 4. Proceed with the task using the context you just read.
 
 To start a session:
@@ -95,8 +95,9 @@ test -f .agentpack/config.toml || agentpack init --yes
 ### Step 3: Determine workflow
 
 **Session active** (`.agentpack/session.json` exists, `"active": true`):
-- Read `.agentpack/context.md`
 - Update `.agentpack/task.md` if task changed
+- Run `agentpack pack --task auto` unless watch already refreshed it
+- Read `.agentpack/context.md`
 - Proceed immediately
 
 **No session**:

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/installers/antigravity.py

@@ -10,6 +10,14 @@ _GEMINI_BLOCK = """\
 <!-- agentpack:block:start -->
 skills:
   - agentpack
+
+At the start of every coding task:
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Run `agentpack pack --task auto` to refresh context for that task.
+3. Read `.agent/skills/agentpack/SKILL.md`.
+4. Use files listed in context as starting points, but verify with actual code before editing.
+
+When the user switches to a different coding task, repeat steps 1-3 before editing.
 <!-- agentpack:block:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/installers/codex.py

@@ -15,6 +15,8 @@ At the start of every coding task:
 2. Run `agentpack pack --task auto` to refresh context.
 3. Read `.agentpack/context.md` — it lists the files most relevant to your task.
 4. Use those files as starting points, but verify with actual code before editing.
+
+When the user switches to a different coding task, repeat steps 1-3 before editing.
 <!-- agentpack:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/installers/cursor.py

@@ -10,8 +10,10 @@ _CURSOR_RULE = """\
 <!-- agentpack:rule:start -->
 At the start of every coding task:
 1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
-2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
-3. Use files listed in context as starting points, but verify with actual code before editing.
+2. Run `agentpack pack --task auto` to refresh context for that task.
+3. Read `.agentpack/context.md`.
+4. Use files listed in context as starting points, but verify with actual code before editing.
+When the user switches to a different coding task, repeat steps 1-3 before editing.
 If context is missing: `agentpack pack --agent cursor --task "<task>"`
 <!-- agentpack:rule:end -->"""
 
@@ -58,8 +60,11 @@ alwaysApply: true
 At the start of every coding task:
 
 1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
-2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
-3. Use files listed in context as starting points, but verify with actual code before editing.
+2. Run `agentpack pack --task auto` to refresh context for that task.
+3. Read `.agentpack/context.md`.
+4. Use files listed in context as starting points, but verify with actual code before editing.
+
+When the user switches to a different coding task, repeat steps 1-3 before editing.
 
 If context is missing: `agentpack pack --agent cursor --task "<task>"`
 """

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/installers/windsurf.py

@@ -10,8 +10,10 @@ _WINDSURF_RULE = """\
 <!-- agentpack:rule:start -->
 At the start of every coding task:
 1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
-2. Read `.agentpack/context.md` — git hooks keep it fresh automatically.
-3. Use files listed in context as starting points, but verify with actual code before editing.
+2. Run `agentpack pack --task auto` to refresh context for that task.
+3. Read `.agentpack/context.md`.
+4. Use files listed in context as starting points, but verify with actual code before editing.
+When the user switches to a different coding task, repeat steps 1-3 before editing.
 If context is missing: `agentpack pack --agent windsurf --task "<task>"`
 <!-- agentpack:rule:end -->"""
 

{agentpack_cli-0.1.25 → agentpack_cli-0.1.26}/src/agentpack/renderers/markdown.py

@@ -104,8 +104,9 @@ def render_claude(pack: ContextPack) -> str:
         "Priority order: changed files → keyword-matched files → dependencies → summaries.\n"
         "Files marked `full` contain complete source. Files marked `symbols` contain relevant "
         "function/class bodies. Files marked `summary` are unchanged context.\n"
-        "If the pack looks stale (changed files list is empty but you expect changes), "
-        "ask the user to run `agentpack pack --task \"<task>\"` to refresh."
+        "If this pack's task does not match the user's current task, write the new task to "
+        "`.agentpack/task.md`, run `agentpack pack --task auto`, re-read the context, then proceed. "
+        "If the pack looks stale (changed files list is empty but you expect changes), refresh the pack before editing."
     )
     sections.append("")