agentpack-cli 0.3.26__tar.gz → 0.3.28__tar.gz

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.26
+Version: 0.3.28
 Summary: Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows.
 Project-URL: Homepage, https://github.com/vishal2612200/agentpack
 Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
@@ -60,6 +60,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
+  <a href="https://deepwiki.com/vishal2612200/agentpack"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
   <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/README.md

@@ -13,6 +13,7 @@
 </p>
 
 <p align="center">
+  <a href="https://deepwiki.com/vishal2612200/agentpack"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
   <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.26"
+version = "0.3.28"
 description = "Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/__init__.py

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

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/commands/doctor.py

@@ -321,7 +321,7 @@ def register(app: typer.Typer) -> None:
         if findings:
             for finding in findings:
                 console.print(f"  [yellow]![/] {finding}")
-            ok = False
+            console.print("  [dim]warning only; keep these out of commits/releases.[/]")
         else:
             console.print("  [green]✓[/] no generated release-noise files staged or untracked")
 

agentpack_cli-0.3.28/src/agentpack/commands/upgrade.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import subprocess
+
+import typer
+
+from agentpack.commands._shared import console, _root
+from agentpack.commands.install import (
+    _install_slash_command,
+    _print_global_template_results,
+    _print_install_results,
+)
+from agentpack.integrations import global_install as global_hooks
+from agentpack.integrations.agents import SUPPORTED_AGENTS, expand_agents, install_agent_integration
+
+
+def register(app: typer.Typer) -> None:
+    @app.command()
+    def upgrade(
+        agent: str = typer.Option(
+            "auto",
+            "--agent",
+            help=f"Agent integration to refresh after package upgrade ({' | '.join(SUPPORTED_AGENTS)}).",
+        ),
+        repair_existing_global_hooks: bool = typer.Option(
+            True,
+            "--repair-existing-global-hooks/--no-repair-existing-global-hooks",
+            help="Refresh already-installed global git/shell hooks after upgrading AgentPack.",
+        ),
+    ) -> None:
+        """Refresh existing AgentPack repo/global integration surfaces after a package upgrade."""
+        root = _root()
+        if agent not in SUPPORTED_AGENTS:
+            console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(SUPPORTED_AGENTS)}[/]")
+            raise typer.Exit(1)
+
+        agents = expand_agents(agent, root)
+        if agent == "auto":
+            console.print(f"[dim]Auto-detected agent: {agents[0]}[/]")
+
+        for selected in agents:
+            console.print(f"\n[bold]{selected}[/]")
+            results = install_agent_integration(
+                root,
+                selected,
+                install_slash_command=_install_slash_command,
+            )
+            _print_install_results(selected, results)
+
+        if repair_existing_global_hooks:
+            _repair_existing_global_hooks()
+
+        console.print("\n[bold green]Upgrade integration refresh complete.[/]")
+        console.print(f"  Verify with: [bold]agentpack doctor --agent {agent}[/]")
+
+
+def _repair_existing_global_hooks() -> None:
+    repaired = False
+    if _global_git_templates_are_installed():
+        repaired = True
+        console.print("\n[bold]Refreshing existing global git template hooks...[/]")
+        hook_results = global_hooks.install_git_template_hooks()
+        _print_global_template_results(hook_results)
+        git_cfg_action = global_hooks.configure_git_template_dir(dry_run=False)
+        console.print(f"[green]git config --global init.templateDir {git_cfg_action}.[/]")
+
+    rc_file = global_hooks._detect_rc_file()
+    if rc_file is not None and rc_file.exists() and global_hooks._SHELL_MARKER_START in rc_file.read_text(encoding="utf-8"):
+        repaired = True
+        console.print("\n[bold]Refreshing existing shell cd hook...[/]")
+        action, path = global_hooks.install_shell_hook(rc_file)
+        if path is not None:
+            console.print(f"[green]{path} {action}.[/]")
+
+    if not repaired:
+        console.print("\n[dim]No existing global AgentPack hooks found to refresh.[/]")
+
+
+def _global_git_templates_are_installed() -> bool:
+    hooks_dir = global_hooks._GIT_TEMPLATE_DIR / "hooks"
+    for name in global_hooks._HOOK_SCRIPTS:
+        hook_path = hooks_dir / name
+        if hook_path.exists() and global_hooks._AGENTPACK_MARKER in hook_path.read_text(encoding="utf-8"):
+            return True
+    try:
+        result = subprocess.run(
+            ["git", "config", "--global", "init.templateDir"],
+            capture_output=True,
+            text=True,
+        )
+    except Exception:
+        return False
+    return result.stdout.strip() == str(global_hooks._GIT_TEMPLATE_DIR)

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/core/command_surface.py

@@ -73,6 +73,15 @@ def fallback_agent_guidance() -> str:
     )
 
 
+def prompt_quality_guidance() -> str:
+    return (
+        "Prompt hygiene: for agent-mode coding work, prefer `Task`, `Files`, "
+        "`Acceptance criteria`, `Constraints`, `Validation`, and `Output` sections. "
+        "For short/simple questions, use Ask/Chat mode instead of agent mode. "
+        "Keep routine responses concise unless the user asks for detail."
+    )
+
+
 def installed_cli_status() -> dict[str, object]:
     binary = shutil.which("agentpack")
     status: dict[str, object] = {
@@ -113,7 +122,7 @@ def _commands_from_help(text: str) -> list[str]:
     commands: set[str] = set()
     known = set(available_cli_commands())
     for line in text.splitlines():
-        stripped = line.strip()
+        stripped = line.strip().strip("│").strip()
         if not stripped:
             continue
         first = stripped.split()[0].strip("`")

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/data/codex_plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentpack",
-  "version": "0.3.26",
+  "version": "0.3.28",
   "description": "Thin Codex plugin for AgentPack ranked repo context.",
   "author": {
     "name": "AgentPack",

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/installers/antigravity.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 from agentpack.integrations.git_hooks import install_git_hooks
 from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
@@ -31,7 +31,9 @@ At the start of every coding task:
 
 When the user switches to a different coding task, update `.agentpack/task.md`, then call MCP again or rerun the refresh command before editing.
 
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:block:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/installers/claude.py

@@ -4,7 +4,7 @@ import json
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 
 
 def _agentpack_block() -> str:
@@ -59,7 +59,9 @@ agentpack pack --agent claude --task auto
 
 Then read `.agentpack/context.claude.md`.
 
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:end -->"""
 
 

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/installers/codex.py

@@ -8,7 +8,7 @@ from importlib import resources
 from pathlib import Path
 
 from agentpack import __version__
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 from agentpack.integrations.git_hooks import install_git_hooks
 
 def _agentpack_block() -> str:
@@ -35,7 +35,9 @@ At the start of every coding task:
 
 When the user switches to a different coding task, update `.agentpack/task.md`, then call MCP again or rerun the refresh command before editing.
 
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/installers/cursor.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 from agentpack.integrations.git_hooks import install_git_hooks
 from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
@@ -27,7 +27,8 @@ At the start of every coding task:
 6. Use files listed in context as starting points, but verify with actual code before editing.
 When the user switches to a different coding task, update `.agentpack/task.md`, then call MCP again or rerun the refresh command before editing.
 If context is missing: {commands.context_missing}.
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:rule:end -->"""
 
 _RULE_RE = re.compile(

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/installers/windsurf.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 from agentpack.integrations.git_hooks import install_git_hooks
 from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
@@ -26,7 +26,8 @@ At the start of every coding task:
 5. Use files listed in context as starting points, but verify with actual code before editing.
 When the user switches to a different coding task, update `.agentpack/task.md`, then call MCP again or rerun the refresh command before editing.
 If context is missing: {commands.context_missing}.
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:rule:end -->"""
 
 _RULE_RE = re.compile(

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/router/models.py

@@ -64,6 +64,7 @@ class SkillInventory(BaseModel):
 
 class RouteResult(BaseModel):
     task: str
+    recommended_interaction_mode: str = "agent"
     task_mode: str = "broad_feature"
     task_mode_confidence: float = 0.0
     task_mode_signals: list[str] = Field(default_factory=list)
@@ -74,6 +75,8 @@ class RouteResult(BaseModel):
     suggested_commands: list[CommandSuggestion] = Field(default_factory=list)
     evidence_checklist: list[str] = Field(default_factory=list)
     routing_notes: list[str] = Field(default_factory=list)
+    prompt_quality_warnings: list[str] = Field(default_factory=list)
+    recommended_prompt_template: list[str] = Field(default_factory=list)
     safety_warnings: list[str] = Field(default_factory=list)
     agent_prompt: str = ""
 

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/router/prompt_builder.py

@@ -8,6 +8,7 @@ def build_agent_prompt(result: RouteResult) -> str:
         "Use Agentpack route result before editing.",
         "",
         f"Task: {result.task}",
+        f"Recommended interaction mode: {result.recommended_interaction_mode}",
         f"Task mode: {result.task_mode} (confidence {result.task_mode_confidence:.2f})",
         "",
         "Read these files first:",
@@ -42,6 +43,13 @@ def build_agent_prompt(result: RouteResult) -> str:
         lines += ["", "Safety warnings:"]
         lines.extend(f"- {warning}" for warning in result.safety_warnings)
 
+    if result.prompt_quality_warnings:
+        lines += ["", "Prompt quality warnings:"]
+        lines.extend(f"- {warning}" for warning in result.prompt_quality_warnings)
+        if result.recommended_prompt_template:
+            lines += ["", "Better prompt template:"]
+            lines.extend(f"- {item}" for item in result.recommended_prompt_template)
+
     if result.routing_notes:
         lines += ["", "Routing notes:"]
         lines.extend(f"- {note}" for note in result.routing_notes)
@@ -115,6 +123,7 @@ def render_plain(result: RouteResult) -> str:
         lines.append("- No external side-effect skills selected.")
 
     lines += ["", "Routing:"]
+    lines.append(f"- recommended_interaction_mode: {result.recommended_interaction_mode}")
     lines.append(f"- task_mode: {result.task_mode} (confidence {result.task_mode_confidence:.2f})")
     if result.task_mode_signals:
         lines.append(f"- signals: {', '.join(result.task_mode_signals[:4])}")
@@ -123,6 +132,12 @@ def render_plain(result: RouteResult) -> str:
     if result.evidence_checklist:
         lines.append("- evidence checklist:")
         lines.extend(f"  - {item}" for item in result.evidence_checklist)
+    if result.prompt_quality_warnings:
+        lines.append("- prompt quality warnings:")
+        lines.extend(f"  - {warning}" for warning in result.prompt_quality_warnings)
+    if result.recommended_prompt_template:
+        lines.append("- prompt template:")
+        lines.extend(f"  - {item}" for item in result.recommended_prompt_template)
 
     lines += ["", "Agent prompt:", result.agent_prompt]
     return "\n".join(lines)

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/router/scoring.py

@@ -17,8 +17,8 @@ _GENERAL_CODING_SKILL_TERMS = {
     "surgical", "verification", "verifiable", "writing",
 }
 _STOPWORDS = {
-    "and", "are", "but", "for", "from", "into", "the", "this", "that", "then",
-    "with", "your", "fix", "add", "make", "debug",
+    "and", "are", "but", "can", "for", "from", "into", "the", "this", "that", "then",
+    "with", "you", "your", "fix", "add", "make", "debug",
 }
 _TASK_TYPE_TERMS = {
     "bugfix": {"bug", "broken", "error", "exception", "fail", "failing", "fix", "issue", "regression"},
@@ -92,7 +92,9 @@ def score_skills(
         item = max(pool, key=lambda candidate: (_diverse_score(candidate, selected), candidate.score))
         pool.remove(item)
         if item.skill.side_effect_level == "external" and not allow_external:
-            if len(warnings) < 10:
+            if not _should_warn_blocked_external(item):
+                continue
+            if len(warnings) < 5:
                 warnings.append(
                     f"External side-effect skill not auto-selected: {item.skill.name} ({item.skill.path})"
                 )
@@ -107,6 +109,25 @@ def score_skills(
     return selected, warnings, scored
 
 
+def _should_warn_blocked_external(item: SelectedSkill) -> bool:
+    if item.confidence >= item.skill.confidence_threshold:
+        return True
+    return _has_strong_external_warning_reason(item.reasons)
+
+
+def _has_strong_external_warning_reason(reasons: list[str]) -> bool:
+    for reason in reasons:
+        if reason == "test task match":
+            return True
+        if reason.startswith(("task type match:", "framework match:", "language match:", "path hint match:", "tool match:", "historical success boost:")):
+            return True
+        if reason.startswith("task keyword match:"):
+            matches = [part.strip() for part in reason.split(":", 1)[1].split(",") if part.strip()]
+            if len(matches) >= 2:
+                return True
+    return False
+
+
 def _score_skill(
     skill: SkillArtifact,
     *,

{agentpack_cli-0.3.26 → agentpack_cli-0.3.28}/src/agentpack/router/service.py

@@ -35,6 +35,13 @@ class TaskModeDecision:
     signals: list[str]
 
 
+@dataclass(frozen=True)
+class PromptQualityDecision:
+    recommended_interaction_mode: str
+    warnings: list[str]
+    template: list[str]
+
+
 class RouteService:
     def inventory(self, root: Path, *, use_index: bool = True) -> SkillInventory:
         cfg = load_config(root)
@@ -47,6 +54,7 @@ class RouteService:
         task = _normalize_task(task)
         mode_decision = classify_task_mode(task)
         task_mode = mode_decision.mode
+        prompt_quality = assess_prompt_quality(task, task_mode)
         cfg = load_config(root)
         plan = PackPlanner().plan(PackRequest(
             root=root,
@@ -89,6 +97,7 @@ class RouteService:
 
         result = RouteResult(
             task=task,
+            recommended_interaction_mode=prompt_quality.recommended_interaction_mode,
             task_mode=task_mode,
             task_mode_confidence=mode_decision.confidence,
             task_mode_signals=mode_decision.signals,
@@ -99,6 +108,8 @@ class RouteService:
             suggested_commands=commands,
             evidence_checklist=checklist,
             routing_notes=notes,
+            prompt_quality_warnings=prompt_quality.warnings,
+            recommended_prompt_template=prompt_quality.template,
             safety_warnings=safety_warnings,
         )
         result.agent_prompt = build_agent_prompt(result)
@@ -183,6 +194,110 @@ def classify_task_mode(task: str) -> TaskModeDecision:
     return TaskModeDecision("broad_feature", 0.35, ["fallback"])
 
 
+def assess_prompt_quality(task: str, task_mode: str) -> PromptQualityDecision:
+    lower = task.lower()
+    warnings: list[str] = []
+    words = _task_words(task)
+    has_file_context = _has_file_context(task)
+    has_output_constraint = _has_output_constraint(lower)
+    has_spec_signal = _has_spec_signal(lower)
+    simple_question = _is_simple_question(task, words)
+
+    if not has_file_context and task_mode not in {"pr_review", "runtime_debugging", "integration_readiness"}:
+        warnings.append("No file context detected. Add `#file` references or name the target files before using agent mode.")
+    if _looks_vague_or_repeated(lower, words):
+        warnings.append("Prompt is very short or retry-shaped. Rephrase with concrete files, observed behavior, and acceptance criteria instead of repeating.")
+    if len(words) <= 35 and not has_output_constraint:
+        warnings.append("Short prompt has no output constraint. Ask for concise bullets, no commentary, or a max length to avoid verbose output.")
+    if not has_spec_signal and task_mode in {"broad_feature", "runtime_debugging", "integration_readiness", "release_docs"}:
+        warnings.append("No spec or acceptance criteria detected. Add requirements, constraints, and validation before coding.")
+    if simple_question:
+        warnings.append("Simple question shape detected. Prefer Ask/Chat mode unless files, commands, or edits are required.")
+    if _has_frustration_signal(task):
+        warnings.append("Frustration signal detected. Pause retries and switch to a smaller diagnostic prompt.")
+    if _has_session_drift_signal(lower):
+        warnings.append("Multiple task types detected. Start a fresh focused session when switching between review, debug, release, docs, and feature work.")
+
+    mode = "ask" if simple_question and not has_file_context else "agent"
+    return PromptQualityDecision(
+        recommended_interaction_mode=mode,
+        warnings=warnings,
+        template=_prompt_template() if warnings else [],
+    )
+
+
+def _task_words(task: str) -> list[str]:
+    return re.findall(r"[A-Za-z0-9_#./:-]+", task)
+
+
+def _has_file_context(task: str) -> bool:
+    if "#file" in task.lower():
+        return True
+    return bool(re.search(r"(?:^|\s)[\w./-]+\.(?:py|ts|tsx|js|jsx|go|rs|java|rb|md|json|toml|ya?ml|css|scss)(?=\s|$|[:,])", task))
+
+
+def _has_output_constraint(lower: str) -> bool:
+    return any(term in lower for term in ("concise", "one-line", "one line", "no commentary", "brief", "max ", "bullets", "json only", "short"))
+
+
+def _has_spec_signal(lower: str) -> bool:
+    return any(term in lower for term in ("acceptance", "criteria", "requirements", "constraints", "validation", "must", "ensure", "spec", "plan:"))
+
+
+def _is_simple_question(task: str, words: list[str]) -> bool:
+    lower = task.lower().strip()
+    if len(words) > 14:
+        return False
+    if any(term in lower for term in ("fix", "edit", "change", "implement", "add ", "remove", "update", "release", "run ")):
+        return False
+    return lower.endswith("?") or lower.startswith(("what ", "why ", "how ", "can ", "should ", "is ", "does ", "do "))
+
+
+def _looks_vague_or_repeated(lower: str, words: list[str]) -> bool:
+    if len(words) <= 5:
+        return True
+    return lower.strip() in {
+        "fix this",
+        "try again",
+        "do it again",
+        "not working",
+        "can you fix this",
+        "can you fix these gaps",
+    }
+
+
+def _has_frustration_signal(task: str) -> bool:
+    letters = [char for char in task if char.isalpha()]
+    uppercase_ratio = sum(1 for char in letters if char.isupper()) / len(letters) if letters else 0
+    return "!!!" in task or "???" in task or (len(letters) >= 10 and uppercase_ratio >= 0.65)
+
+
+def _has_session_drift_signal(lower: str) -> bool:
+    task_types = sum(
+        1
+        for terms in (
+            ("review", "pr "),
+            ("debug", "log", "runtime"),
+            ("release", "publish", "changelog"),
+            ("docs", "readme"),
+            ("feature", "implement", "build"),
+        )
+        if any(term in lower for term in terms)
+    )
+    return task_types >= 3
+
+
+def _prompt_template() -> list[str]:
+    return [
+        "Task: <what to change or answer>",
+        "Files: #file:<path> #file:<path> (or name the target files)",
+        "Acceptance criteria: <bullets>",
+        "Constraints: <scope, style, risk limits>",
+        "Validation: <tests/checks to run>",
+        "Output: concise bullets; no extra commentary",
+    ]
+
+
 def _has_any(lower: str, terms: tuple[str, ...], signals: list[str], label: str) -> bool:
     matched = [term.strip() for term in terms if term in lower]
     if matched:

agentpack_cli-0.3.26/src/agentpack/commands/upgrade.py

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-import typer
-
-from agentpack.commands._shared import console, _root
-from agentpack.commands.install import _install_slash_command, _print_install_results
-from agentpack.integrations.agents import SUPPORTED_AGENTS, expand_agents, install_agent_integration
-
-
-def register(app: typer.Typer) -> None:
-    @app.command()
-    def upgrade(
-        agent: str = typer.Option(
-            "auto",
-            "--agent",
-            help=f"Agent integration to refresh after package upgrade ({' | '.join(SUPPORTED_AGENTS)}).",
-        ),
-    ) -> None:
-        """Refresh the detected AgentPack IDE/agent integration after upgrading the package."""
-        root = _root()
-        if agent not in SUPPORTED_AGENTS:
-            console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(SUPPORTED_AGENTS)}[/]")
-            raise typer.Exit(1)
-
-        agents = expand_agents(agent, root)
-        if agent == "auto":
-            console.print(f"[dim]Auto-detected agent: {agents[0]}[/]")
-
-        for selected in agents:
-            console.print(f"\n[bold]{selected}[/]")
-            results = install_agent_integration(
-                root,
-                selected,
-                install_slash_command=_install_slash_command,
-            )
-            _print_install_results(selected, results)
-
-        console.print("\n[bold green]Upgrade integration refresh complete.[/]")