agentpack-cli 0.3.18__tar.gz → 0.3.19__tar.gz

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.18
+Version: 0.3.19
 Summary: Local MCP context router for Claude Code, Codex, Cursor, and AI coding agents.
 License: MIT
 License-File: LICENSE
@@ -55,7 +55,7 @@ Claude Code, Codex, Cursor, and other coding agents can waste tool calls redisco
 
 AgentPack gives them a ranked map of likely relevant files, tests, rules, and skills for each task. It analyzes your repo locally and packages compact context for CLI and MCP workflows.
 
-No cloud indexing. No embeddings required. No API calls for scan, summarize, rank, pack, stats, or benchmark. AgentPack is a context preparation tool, not a coding agent.
+How it works: AgentPack compresses repo context into ranked packs, caches scans/summaries/pack metadata for fast refreshes, and retrieves exact file or symbol blocks later when an agent needs more detail. Rendered packs also put stable instructions before volatile task, timestamp, git, and file sections so provider prompt-prefix caches can reuse the front of repeated refreshes. No cloud indexing, embeddings, or API calls are required for scan, summarize, rank, pack, stats, or benchmark.
 
 Try the read-only task router without writing context files:
 

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/README.md

@@ -14,7 +14,7 @@ Claude Code, Codex, Cursor, and other coding agents can waste tool calls redisco
 
 AgentPack gives them a ranked map of likely relevant files, tests, rules, and skills for each task. It analyzes your repo locally and packages compact context for CLI and MCP workflows.
 
-No cloud indexing. No embeddings required. No API calls for scan, summarize, rank, pack, stats, or benchmark. AgentPack is a context preparation tool, not a coding agent.
+How it works: AgentPack compresses repo context into ranked packs, caches scans/summaries/pack metadata for fast refreshes, and retrieves exact file or symbol blocks later when an agent needs more detail. Rendered packs also put stable instructions before volatile task, timestamp, git, and file sections so provider prompt-prefix caches can reuse the front of repeated refreshes. No cloud indexing, embeddings, or API calls are required for scan, summarize, rank, pack, stats, or benchmark.
 
 Try the read-only task router without writing context files:
 

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.18"
+version = "0.3.19"
 description = "Local MCP context router for Claude Code, Codex, Cursor, and AI coding agents."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/src/agentpack/__init__.py

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

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/src/agentpack/renderers/compact.py

@@ -34,6 +34,17 @@ def render_compact(pack: ContextPack) -> str:
 
     sections.append("# AgentPack Context")
     sections.append("")
+    sections.append("<!-- agentpack:stable-prefix:start -->")
+    sections.append("")
+    sections.append("## instructions")
+    sections.append("")
+    sections.append("- Prefer selected files first.")
+    sections.append("- Include modes: full, diff, symbols, skeleton, summary.")
+    sections.append("- If task changes significantly, update `.agentpack/task.md`.")
+    sections.append("- Run `agentpack session refresh` if context seems stale.")
+    sections.append("")
+    sections.append("<!-- agentpack:stable-prefix:end -->")
+    sections.append("")
     sections.append(f"task: {pack.task}")
     sections.append(f"mode: {pack.mode}")
     sections.append(f"task_class: {pack.task_class}")
@@ -78,11 +89,4 @@ def render_compact(pack: ContextPack) -> str:
         sections.append("(none)")
         sections.append("")
 
-    sections.append("## instructions")
-    sections.append("")
-    sections.append("- Prefer selected files first.")
-    sections.append("- If task changes significantly, update `.agentpack/task.md`.")
-    sections.append("- Run `agentpack session refresh` if context seems stale.")
-    sections.append("")
-
     return "\n".join(sections)

{agentpack_cli-0.3.18 → agentpack_cli-0.3.19}/src/agentpack/renderers/markdown.py

@@ -68,6 +68,10 @@ def _omitted_relevant_lines(pack: ContextPack, limit: int = 10) -> list[str]:
     )[:limit]
     lines = ["## Omitted But Relevant Files", ""]
     lines.append("These files matched the task but were not included due to token budget.")
+    lines.append(
+        "Do not assume omitted relevant files are safe. If a selected function/class has omitted callers, "
+        "tests, routes, schemas, or configs, inspect them before finalizing the fix."
+    )
     lines.append(
         "Before finalizing changes, inspect high-risk omitted files if your fix changes shared behavior, "
         "function signatures, data models, API contracts, or side effects."
@@ -241,11 +245,34 @@ def _has_task_stale_warning(pack: ContextPack) -> bool:
     )
 
 
+def _stable_prefix_lines(agent_name: str) -> list[str]:
+    return [
+        f"# AgentPack Context for {agent_name}",
+        "",
+        "<!-- agentpack:stable-prefix:start -->",
+        "",
+        f"## Instructions for {agent_name}",
+        "",
+        (
+            "This is a task-focused context pack. Act on it immediately:\n\n"
+            "1. **Orient** — identify the changed files and key symbols relevant to the task.\n"
+            "2. **Diagnose or plan** — find the root cause (bug fix) or outline the approach (feature).\n"
+            "3. **Work** — edit files, write code, fix the issue. Do not wait for more instructions.\n\n"
+            "Priority order: changed files → keyword matches → dependencies → summaries.\n"
+            "Modes: `full` source, `diff` hunks, `symbols` or `skeleton` interfaces, `summary` brief context.\n"
+            "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."
+        ),
+        "",
+        "<!-- agentpack:stable-prefix:end -->",
+        "",
+    ]
+
+
 def render_claude(pack: ContextPack) -> str:
-    sections: list[str] = []
+    sections: list[str] = _stable_prefix_lines("Claude")
 
-    sections.append("# AgentPack Context for Claude")
-    sections.append("")
     sections.append(_machine_freshness_block(pack))
     sections.append("")
 
@@ -303,28 +330,6 @@ def render_claude(pack: ContextPack) -> str:
         sections.append(pack.agent_lessons)
         sections.append("")
 
-    sections.append("## Instructions for Claude")
-    sections.append("")
-    sections.append(
-        "This is a task-focused context pack. Act on it immediately:\n\n"
-        "1. **Orient** — identify the changed files and key symbols relevant to the task.\n"
-        "2. **Diagnose or plan** — find the root cause (bug fix) or outline the approach (feature).\n"
-        "3. **Work** — edit files, write code, fix the issue. Do not wait for more instructions.\n\n"
-        "Priority order: changed files → keyword-matched files → dependencies → summaries.\n"
-        "Files marked `full` contain complete source. Files marked `diff` contain relevant changed hunks. "
-        "Files marked `symbols` contain relevant function/class bodies. Files marked `skeleton` contain imports/signatures. "
-        "Files marked `summary` are unchanged context.\n"
-        "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."
-    )
-    if pack.omitted_relevant_files:
-        sections.append(
-            "Do not assume omitted relevant files are safe. If a selected function/class has omitted callers, "
-            "tests, routes, schemas, or configs, inspect them before finalizing the fix."
-        )
-    sections.append("")
-
     sections.append("## Token Stats")
     sections.append("")
     sections.append(f"Raw repo tokens: {pack.raw_repo_tokens:,}")
@@ -399,13 +404,19 @@ def render_claude(pack: ContextPack) -> str:
 
 
 def render_generic(pack: ContextPack) -> str:
-    return render_claude(pack).replace("# AgentPack Context for Claude", "# AgentPack Context")
+    return (
+        render_claude(pack)
+        .replace("# AgentPack Context for Claude", "# AgentPack Context")
+        .replace("## Instructions for Claude", "## Instructions for Agent")
+    )
 
 
 def render_antigravity(pack: ContextPack) -> str:
     """Render context as an Antigravity SKILL.md with required frontmatter."""
-    body = render_claude(pack).replace(
-        "# AgentPack Context for Claude", "# AgentPack Context"
+    body = (
+        render_claude(pack)
+        .replace("# AgentPack Context for Claude", "# AgentPack Context")
+        .replace("## Instructions for Claude", "## Instructions for Agent")
     )
     frontmatter = (
         "---\n"