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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.28
+Version: 0.3.29
 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/

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

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

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

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/adapters/codex.py

@@ -25,5 +25,8 @@ class CodexAdapter(BaseAdapter):
     def patch_codex_hooks(self, root: Path) -> str:
         return CodexInstaller().patch_codex_hooks(root)
 
+    def patch_codex_mcp_config(self, *, codex_home: Path | None = None) -> str:
+        return CodexInstaller().patch_codex_mcp_config(codex_home=codex_home)
+
     def install_auto_repack(self, root: Path) -> dict[str, str]:
         return CodexInstaller().install_auto_repack(root)

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/application/pack_service.py

@@ -67,6 +67,7 @@ from agentpack.analysis.tests import find_related_tests
 from agentpack.analysis import dependency_graph as dep_graph_mod
 from agentpack.summaries.base import build_all_summaries
 from agentpack.session.events import record_event
+from agentpack.session.references import collect_repo_issue_references
 
 
 @dataclass
@@ -829,11 +830,14 @@ class PackService:
             output_path=cfg.runtime.pack_registry_output,
             max_records=cfg.runtime.max_registry_records,
         )
+        issue_reference_details = collect_repo_issue_references(root, request.task)
         record_event(
             root,
             "pack",
             {
                 "task": request.task,
+                "issue_references": [item.ref for item in issue_reference_details],
+                "issue_reference_details": [item.to_dict() for item in issue_reference_details],
                 "agent": request.agent,
                 "mode": plan.mode,
                 "packed_tokens": packed_tokens,

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

@@ -334,18 +334,25 @@ def register(app: typer.Typer) -> None:
         else:
             console.print("  [green]✓[/] npm publish token available in environment")
 
-        # --- Slash command ---
-        console.print("\n[bold]Slash command (/agentpack)[/]")
-        local_cmd = root / ".claude" / "commands" / "agentpack.md"
-        global_cmd = Path.home() / ".claude" / "commands" / "agentpack.md"
-        if local_cmd.exists():
-            console.print(f"  [green]✓[/] Slash command installed (local): {local_cmd}")
-        else:
-            console.print("  [dim]-[/] Slash command not installed locally — run: agentpack install --agent claude")
-        if global_cmd.exists():
-            console.print(f"  [green]✓[/] Slash command installed (global): {global_cmd}")
-        else:
-            console.print("  [dim]-[/] Slash command not installed globally — run: agentpack install --agent claude --global")
+        # --- Slash commands ---
+        console.print("\n[bold]Slash commands (/agentpack, /agentpack-learn)[/]")
+        for filename in ("agentpack.md", "agentpack-learn.md"):
+            local_cmd = root / ".claude" / "commands" / filename
+            global_cmd = Path.home() / ".claude" / "commands" / filename
+            if local_cmd.exists():
+                console.print(f"  [green]✓[/] Slash command installed (local): {local_cmd}")
+            else:
+                console.print(
+                    f"  [dim]-[/] Slash command not installed locally: {local_cmd} — "
+                    "run: agentpack install --agent claude"
+                )
+            if global_cmd.exists():
+                console.print(f"  [green]✓[/] Slash command installed (global): {global_cmd}")
+            else:
+                console.print(
+                    f"  [dim]-[/] Slash command not installed globally: {global_cmd} — "
+                    "run: agentpack install --agent claude --global"
+                )
 
         _print_summary(ok)
 

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/commands/init.py

@@ -206,6 +206,10 @@ def _patch_agentignore(
 
 def _install_agent_integration(root, agent: str) -> dict[str, str]:
     """Install repo-local agent integration files after `agentpack init`."""
+    if agent == "claude":
+        from agentpack.commands.install import _install_slash_command
+
+        return install_agent_integration(root, agent, install_slash_command=_install_slash_command)
     return install_agent_integration(root, agent)
 
 
@@ -246,7 +250,13 @@ def _resolve_init_agent(root: Path, agent: str, *, force: bool = False) -> str:
 
 def _agent_integration_paths(agent: str) -> tuple[str, ...]:
     if agent == "claude":
-        return ("CLAUDE.md", ".claude/settings.json", ".mcp.json")
+        return (
+            "CLAUDE.md",
+            ".claude/settings.json",
+            ".mcp.json",
+            ".claude/commands/agentpack.md",
+            ".claude/commands/agentpack-learn.md",
+        )
     if agent == "cursor":
         return (".cursorrules", ".cursor/rules/agentpack.mdc", ".vscode/tasks.json")
     if agent == "windsurf":

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/commands/install.py

@@ -47,8 +47,8 @@ def _print_install_results(agent: str, results: dict[str, str]) -> None:
             console.print(f"[green].git/hooks/{key[4:]} {action}.[/]")
         elif key == "vscode:tasks":
             console.print(f"[green].vscode/tasks.json {action}.[/]")
-        elif key == "/agentpack":
-            console.print(f"[green]/agentpack slash command {action}.[/]")
+        elif key.startswith("/"):
+            console.print(f"[green]{key} slash command {action}.[/]")
         else:
             console.print(f"[green]{key} {action}.[/]")
 
@@ -66,7 +66,7 @@ def _print_dry_run_agent(agent: str) -> None:
     elif agent == "windsurf":
         console.print("\n[dim]Would patch: .windsurfrules, VS Code task, git hooks[/]")
     elif agent == "codex":
-        console.print("\n[dim]Would patch: AGENTS.md, .codex/hooks.json, git hooks[/]")
+        console.print("\n[dim]Would patch: AGENTS.md, .codex/hooks.json, Codex MCP config, git hooks[/]")
     elif agent == "antigravity":
         console.print("\n[dim]Would patch: GEMINI.md, VS Code task, git hooks[/]")
     elif agent == "generic":
@@ -256,18 +256,24 @@ def register(app: typer.Typer) -> None:
             console.print("  Current repo hooks now delegate through AgentPack's safe GitAutoRepack path.")
 
 
-def _install_slash_command(root: Path, global_install: bool) -> str:
-    import importlib.resources
-
+def _install_slash_command(root: Path, global_install: bool) -> dict[str, str]:
     commands_dir = Path.home() / ".claude" / "commands" if global_install else root / ".claude" / "commands"
     commands_dir.mkdir(parents=True, exist_ok=True)
-    dest = commands_dir / "agentpack.md"
+    return {
+        "/agentpack": _install_slash_command_file(commands_dir, "agentpack.md"),
+        "/agentpack-learn": _install_slash_command_file(commands_dir, "agentpack-learn.md"),
+    }
+
+
+def _install_slash_command_file(commands_dir: Path, filename: str) -> str:
+    import importlib.resources
 
+    dest = commands_dir / filename
     try:
-        pkg_files = importlib.resources.files("agentpack") / "data" / "agentpack.md"
+        pkg_files = importlib.resources.files("agentpack") / "data" / filename
         source_text = pkg_files.read_text(encoding="utf-8")
     except Exception:
-        source_text = (Path(__file__).parent.parent / "data" / "agentpack.md").read_text(encoding="utf-8")
+        source_text = (Path(__file__).parent.parent / "data" / filename).read_text(encoding="utf-8")
 
     existed = dest.exists()
     if existed and dest.read_text(encoding="utf-8") == source_text:

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/commands/learn.py

@@ -248,6 +248,8 @@ def register(app: typer.Typer) -> None:
             "learn",
             {
                 "task": report.task,
+                "issue_references": report.issue_references,
+                "issue_reference_details": report.issue_reference_details,
                 "changed_files": len(report.source_files),
                 "concepts": report.concepts,
                 "selected_hits": len(report.selected_hits),

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/commands/memory.py

@@ -9,6 +9,7 @@ from rich import box
 
 from agentpack.commands._shared import _root, console
 from agentpack.core.config import load_config
+from agentpack.session.references import merge_issue_reference_objects, merge_issue_references
 from agentpack.session.events import read_events
 
 
@@ -26,8 +27,29 @@ def register(app: typer.Typer) -> None:
             for concept in (event.get("concepts") or [])
             if isinstance(concept, str)
         )
+        issue_references = merge_issue_references(
+            ref
+            for event in events
+            for ref in (event.get("issue_references") or [])
+            if isinstance(ref, str)
+        )
+        top_issue_references = Counter(
+            ref
+            for event in events
+            for ref in (event.get("issue_references") or [])
+            if isinstance(ref, str)
+        ).most_common(20)
+        issue_reference_details = merge_issue_reference_objects(
+            item
+            for event in events
+            for item in (event.get("issue_reference_details") or [])
+            if isinstance(item, dict)
+        )
         payload = {
             "recent_tasks": tasks[-20:],
+            "recent_issue_references": issue_references[-20:],
+            "issue_reference_details": [item.to_dict() for item in issue_reference_details[-20:]],
+            "top_issue_references": top_issue_references,
             "top_concepts": concepts.most_common(20),
             "event_count": len(events),
         }
@@ -40,6 +62,15 @@ def register(app: typer.Typer) -> None:
         table.add_row("events", str(len(events)))
         for task in tasks[-10:]:
             table.add_row("task", task)
+        for ref in issue_references[-10:]:
+            table.add_row("issue", ref)
+        for item in issue_reference_details[-10:]:
+            label = item.ref
+            if item.title:
+                label += f" — {item.title}"
+            if item.state:
+                label += f" ({item.state})"
+            table.add_row("issue detail", label)
         for concept, count in concepts.most_common(10):
             table.add_row("concept", f"{concept} ({count})")
         console.print(table)

agentpack_cli-0.3.29/src/agentpack/data/agentpack-learn.md

@@ -0,0 +1,66 @@
+---
+description: Learn one thing from the current local AgentPack session context.
+---
+
+# AgentPack Learn
+
+Use current local agent session context to teach what the user asks to learn.
+
+Keep this prompt prefix stable for caching. Do not move the user learning statement above the final line.
+
+## Freshness Check
+
+Check whether current AgentPack context is present and current:
+
+```bash
+agentpack status
+```
+
+If `agentpack status` fails, says context is stale/missing, or `.agentpack/context.compact.md` is absent, refresh once:
+
+```bash
+agentpack pack --task auto
+```
+
+Do not loop on refresh. If refresh fails, continue from whatever local context exists and state that context may be stale.
+
+## Context Source
+
+Use only local files first:
+
+```bash
+test -f .agentpack/context.compact.md && sed -n '1,220p' .agentpack/context.compact.md
+test -f .agentpack/task.md && sed -n '1,40p' .agentpack/task.md
+test -f .agentpack/session.json && sed -n '1,120p' .agentpack/session.json
+test -f .agentpack/learning.md && sed -n '1,220p' .agentpack/learning.md
+test -f .agentpack/agent-lessons.md && sed -n '1,160p' .agentpack/agent-lessons.md
+test -f .agentpack/skills-progress.json && sed -n '1,120p' .agentpack/skills-progress.json
+test -f .agentpack/session-events.jsonl && tail -n 40 .agentpack/session-events.jsonl
+```
+
+Use `.agentpack/context.md` only when compact context lacks needed detail.
+Do not invent repo facts not present in local context or checked files.
+
+## Teaching Modes
+
+Choose the smallest mode that matches the user's learning statement.
+
+Learning Curve Destroyer: use when user wants to become functional fast. You only have 4 hours with them and will never see them again. No theory without practical use. No lists. Tell them what to learn first, what to ignore, and one exercise that puts them ahead of most people studying for months.
+
+Real Error Simulator: use when user wants practice with a concept. Do not explain first. Drop them into a real situation from local context where they would use it and likely get it wrong. When they make a mistake, ask a question that exposes where thinking broke. Reveal answer only after at least two tries. Repeat until they get it right without hesitating.
+
+Confusion Breaker: use when user says content or context is confusing. Before explaining, give one sentence that makes everything click. Explain only that sentence first using an everyday analogy with zero technical terms. Ask 3 questions only someone who truly gets it can answer. Do not move on until they pass all three.
+
+Personal Learning Path: use when user gives a real goal, desired result, deadline, or current knowledge. Build a 7-day path. Each day has one 45-minute task, a clear correctness check, and what not to do that day. If path does not lead to goal, rebuild it.
+
+Forced Feynman Method: use when user says they studied something or wants to explain back. Let them explain as if to a 10-year-old. Stop them when they use unknown words, skip reasoning, or oversimplify until wrong. End with exactly what mistakes reveal about weak understanding.
+
+## Output Rules
+
+- Be practical and interactive.
+- Ground examples in local agent session context when useful.
+- Ask for missing goal/deadline/current-knowledge only if needed for the selected mode.
+- Do not dump generic theory.
+- Do not produce long lists unless the selected mode explicitly requires a 7-day path.
+
+User learning statement: $ARGUMENTS

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

@@ -1,6 +1,6 @@
 {
   "name": "agentpack",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Thin Codex plugin for AgentPack ranked repo context.",
   "author": {
     "name": "AgentPack",
@@ -29,6 +29,7 @@
     "defaultPrompt": [
       "@agentpack-route fix auth token expiry",
       "@agentpack-pack fix auth token expiry",
+      "@agentpack-learn retry handling in this repo",
       "@agentpack-review"
     ],
     "brandColor": "#1F6FEB"

agentpack_cli-0.3.29/src/agentpack/data/codex_plugin/skills/agentpack-learn.md

@@ -0,0 +1,67 @@
+---
+name: agentpack-learn
+description: Learn one thing from current local AgentPack session context.
+---
+
+# AgentPack Learn
+
+Use when the user invokes `/agentpack-learn <statement>` or `@agentpack-learn <statement>`.
+
+Use current local agent session context to teach what the user asks to learn.
+
+Keep prompt prefix stable for caching. Treat the user's learning statement as the only variable and keep it at the end when constructing any reusable prompt.
+
+## Freshness Check
+
+Check whether current AgentPack context is present and current:
+
+```bash
+agentpack status
+```
+
+If `agentpack status` fails, says context is stale/missing, or `.agentpack/context.compact.md` is absent, refresh once:
+
+```bash
+agentpack pack --task auto
+```
+
+Do not loop on refresh. If refresh fails, continue from whatever local context exists and state that context may be stale.
+
+## Context Source
+
+Use only local files first:
+
+```bash
+test -f .agentpack/context.compact.md && sed -n '1,220p' .agentpack/context.compact.md
+test -f .agentpack/task.md && sed -n '1,40p' .agentpack/task.md
+test -f .agentpack/session.json && sed -n '1,120p' .agentpack/session.json
+test -f .agentpack/learning.md && sed -n '1,220p' .agentpack/learning.md
+test -f .agentpack/agent-lessons.md && sed -n '1,160p' .agentpack/agent-lessons.md
+test -f .agentpack/skills-progress.json && sed -n '1,120p' .agentpack/skills-progress.json
+test -f .agentpack/session-events.jsonl && tail -n 40 .agentpack/session-events.jsonl
+```
+
+Use `.agentpack/context.md` only when compact context lacks needed detail.
+Do not invent repo facts not present in local context or checked files.
+
+## Teaching Modes
+
+Choose the smallest mode that matches the user's learning statement.
+
+Learning Curve Destroyer: use when user wants to become functional fast. You only have 4 hours with them and will never see them again. No theory without practical use. No lists. Tell them what to learn first, what to ignore, and one exercise that puts them ahead of most people studying for months.
+
+Real Error Simulator: use when user wants practice with a concept. Do not explain first. Drop them into a real situation from local context where they would use it and likely get it wrong. When they make a mistake, ask a question that exposes where thinking broke. Reveal answer only after at least two tries. Repeat until they get it right without hesitating.
+
+Confusion Breaker: use when user says content or context is confusing. Before explaining, give one sentence that makes everything click. Explain only that sentence first using an everyday analogy with zero technical terms. Ask 3 questions only someone who truly gets it can answer. Do not move on until they pass all three.
+
+Personal Learning Path: use when user gives a real goal, desired result, deadline, or current knowledge. Build a 7-day path. Each day has one 45-minute task, a clear correctness check, and what not to do that day. If path does not lead to goal, rebuild it.
+
+Forced Feynman Method: use when user says they studied something or wants to explain back. Let them explain as if to a 10-year-old. Stop them when they use unknown words, skip reasoning, or oversimplify until wrong. End with exactly what mistakes reveal about weak understanding.
+
+## Output Rules
+
+- Be practical and interactive.
+- Ground examples in local agent session context when useful.
+- Ask for missing goal/deadline/current-knowledge only if needed for the selected mode.
+- Do not dump generic theory.
+- Do not produce long lists unless the selected mode explicitly requires a 7-day path.

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

@@ -57,6 +57,25 @@ _USER_PROMPT_SUBMIT_HOOK = {
     "statusMessage": "Checking agentpack index...",
 }
 
+_CODEX_MCP_BLOCK = """\
+# agentpack:mcp:start
+[mcp_servers.agentpack]
+command = "agentpack"
+args = ["mcp"]
+startup_timeout_sec = 30
+tool_timeout_sec = 120
+enabled = true
+# agentpack:mcp:end
+"""
+
+_CODEX_MCP_BLOCK_RE = re.compile(
+    r"# agentpack:mcp:start\n.*?# agentpack:mcp:end\n?",
+    re.DOTALL,
+)
+_CODEX_MCP_TABLE_RE = re.compile(
+    r"(?ms)^\[mcp_servers\.agentpack\]\n.*?(?=^\[[^\n]+\]\n|\Z)",
+)
+
 
 class CodexInstaller:
     """Configures Codex/OpenAI-specific repo files and auto-repack hooks."""
@@ -125,6 +144,18 @@ class CodexInstaller:
         results.update({f"git:{k}": v for k, v in hook_results.items()})
         return results
 
+    def patch_codex_mcp_config(self, *, codex_home: Path | None = None) -> str:
+        """Install AgentPack's MCP server in Codex's user config."""
+        config_path = _codex_config_path(codex_home)
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+        existed = config_path.exists()
+        content = config_path.read_text(encoding="utf-8") if existed else ""
+        desired = _patch_codex_mcp_config_text(content)
+        if content == desired:
+            return "unchanged"
+        config_path.write_text(desired, encoding="utf-8")
+        return "updated" if existed else "created"
+
     def install_codex_plugin(self, *, codex_home: Path | None = None) -> dict[str, str]:
         """Install AgentPack's thin Codex plugin package into the local Codex cache."""
         source = _codex_plugin_source()
@@ -133,11 +164,28 @@ class CodexInstaller:
         return {str(target): action}
 
 
+def _patch_codex_mcp_config_text(content: str) -> str:
+    normalized_block = _CODEX_MCP_BLOCK
+    if _CODEX_MCP_BLOCK_RE.search(content):
+        return _CODEX_MCP_BLOCK_RE.sub(normalized_block, content)
+    if _CODEX_MCP_TABLE_RE.search(content):
+        return _CODEX_MCP_TABLE_RE.sub(normalized_block, content)
+    prefix = content.rstrip()
+    if not prefix:
+        return normalized_block
+    return prefix + "\n\n" + normalized_block
+
+
 def _codex_plugin_target(codex_home: Path | None = None) -> Path:
     root = codex_home or Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
     return root / "plugins" / "cache" / "local" / "agentpack" / __version__
 
 
+def _codex_config_path(codex_home: Path | None = None) -> Path:
+    root = codex_home or Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
+    return root / "config.toml"
+
+
 def _codex_plugin_source() -> Path:
     checkout_source = Path(__file__).resolve().parents[3] / "src" / "agentpack" / "data" / "codex_plugin"
     if checkout_source.exists():

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/integrations/agents.py

@@ -62,7 +62,11 @@ def install_agent_integration(
             ),
         }
         if slash_command and install_slash_command is not None:
-            results["/agentpack"] = install_slash_command(root, global_install)
+            slash_results = install_slash_command(root, global_install)
+            if isinstance(slash_results, dict):
+                results.update(slash_results)
+            else:
+                results["/agentpack"] = slash_results
         return results
 
     if agent == "cursor":
@@ -88,6 +92,7 @@ def install_agent_integration(
         results = {
             "AGENTS.md": installer.patch_agents_md(root),
             "~/.codex/plugins/cache/local/agentpack": next(iter(plugin_result.values())),
+            "~/.codex/config.toml:mcp_servers.agentpack": installer.patch_codex_mcp_config(),
         }
         if not global_install:
             results.update(installer.install_auto_repack(root))
@@ -126,6 +131,7 @@ def check_agent_integration(root: Path, agent: str) -> list[AgentCheck]:
         return [
             _current_rule_file(root, agent, "AGENTS.md", "agentpack repair --agent codex"),
             _codex_hooks(root),
+            _codex_mcp_config(),
             *_check_git_hooks(root, agent),
         ]
     if agent == "antigravity":
@@ -313,3 +319,27 @@ def _codex_hooks(root: Path) -> AgentCheck:
         "Codex app lifecycle hooks present" if ok else "missing SessionStart/UserPromptSubmit hooks",
         None if ok else "agentpack repair --agent codex",
     )
+
+
+def _codex_mcp_config() -> AgentCheck:
+    import os
+
+    path = Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser() / "config.toml"
+    if not path.exists():
+        return AgentCheck("codex", "~/.codex/config.toml", False, "missing Codex MCP config", "agentpack repair --agent codex")
+    try:
+        content = path.read_text(encoding="utf-8")
+    except OSError:
+        return AgentCheck("codex", "~/.codex/config.toml", False, "unreadable", "agentpack repair --agent codex")
+    ok = (
+        "[mcp_servers.agentpack]" in content
+        and 'command = "agentpack"' in content
+        and 'args = ["mcp"]' in content
+    )
+    return AgentCheck(
+        "codex",
+        "~/.codex/config.toml",
+        ok,
+        "Codex MCP server registered" if ok else "agentpack MCP server missing",
+        None if ok else "agentpack repair --agent codex",
+    )

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/learning/collector.py

@@ -5,6 +5,7 @@ from pathlib import Path
 
 from agentpack.core import git
 from agentpack.core.context_pack import load_pack_metadata
+from agentpack.session.references import collect_repo_issue_references
 from agentpack.session.state import TASK_FILE
 
 
@@ -18,6 +19,8 @@ class LearningInputs:
     redaction_warnings: list[str] = field(default_factory=list)
     selected_files: list[str] = field(default_factory=list)
     selected_modes: dict[str, str] = field(default_factory=dict)
+    issue_references: list[str] = field(default_factory=list)
+    issue_reference_details: list[dict] = field(default_factory=list)
 
 
 def collect_learning_inputs(
@@ -46,6 +49,7 @@ def collect_learning_inputs(
         diffs[path] = diff
         warnings.extend(redaction_warnings)
     selected_files, selected_modes = _latest_selected_files(root)
+    issue_reference_details = collect_repo_issue_references(root, task)
     return LearningInputs(
         task=task,
         since=since,
@@ -55,6 +59,8 @@ def collect_learning_inputs(
         redaction_warnings=warnings,
         selected_files=selected_files,
         selected_modes=selected_modes,
+        issue_references=[item.ref for item in issue_reference_details],
+        issue_reference_details=[item.to_dict() for item in issue_reference_details],
     )
 
 

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/learning/extractor.py

@@ -65,6 +65,8 @@ def build_learning_report(
         task=inputs.task,
         scope="task",
         since=inputs.since,
+        issue_references=inputs.issue_references,
+        issue_reference_details=inputs.issue_reference_details,
         source_files=source_files,
         summary=summary,
         concepts=concepts,

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/learning/models.py

@@ -94,6 +94,8 @@ class LearningReport(BaseModel):
     task: str
     scope: str
     since: str | None = None
+    issue_references: list[str] = Field(default_factory=list)
+    issue_reference_details: list[dict] = Field(default_factory=list)
     source_files: list[LearningSourceFile] = Field(default_factory=list)
     summary: list[str] = Field(default_factory=list)
     concepts: list[str] = Field(default_factory=list)

{agentpack_cli-0.3.28 → agentpack_cli-0.3.29}/src/agentpack/learning/renderers.py

@@ -60,9 +60,10 @@ def render_provider_preview_markdown(report: LearningReport) -> str:
         "",
         f"Task: {report.task}",
         f"Scope: {report.scope}",
-        "",
-        "## Changed File Evidence",
     ]
+    if report.issue_references:
+        lines.append("Issue references: " + ", ".join(report.issue_references))
+    lines.extend(["", "## Changed File Evidence"])
     for source in report.source_files:
         concepts = ", ".join(source.concepts) if source.concepts else "none"
         lines.append(f"- `{source.path}` ({source.change_kind}) concepts: {concepts}")
@@ -316,6 +317,8 @@ def render_learning_markdown(report: LearningReport) -> str:
     ]
     if report.since:
         lines.append(f"**Since:** `{report.since}`")
+    if report.issue_references:
+        lines.append("**Issue references:** " + ", ".join(report.issue_references))
     lines.extend(["", "## Summary"])
     lines.extend(f"- {item}" for item in report.summary)
     lines.extend(["", "## Changed Files"])

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

@@ -11,6 +11,8 @@ from pathlib import Path
 from agentpack.core import git
 from agentpack.application.pack_service import PackPlanner, PackRequest
 from agentpack.core.config import load_config
+from agentpack.session.events import read_events
+from agentpack.session.references import extract_issue_references, merge_issue_references
 from agentpack.router.discovery import discover_inventory, inventory_for_route
 from agentpack.router.models import (
     AppliedRule,
@@ -52,6 +54,7 @@ class RouteService:
 
     def route_task(self, root: Path, task: str) -> RouteResult:
         task = _normalize_task(task)
+        routing_task = _task_with_recent_issue_context(root, task)
         mode_decision = classify_task_mode(task)
         task_mode = mode_decision.mode
         prompt_quality = assess_prompt_quality(task, task_mode)
@@ -59,7 +62,7 @@ class RouteService:
         plan = PackPlanner().plan(PackRequest(
             root=root,
             agent="generic",
-            task=task,
+            task=routing_task,
             mode="balanced",
             budget=0,
             since=None,
@@ -94,6 +97,8 @@ class RouteService:
         commands = _suggest_commands(task, selected_paths)
         checklist = _evidence_checklist(task_mode)
         notes = _routing_notes(task_mode, pr_paths)
+        if routing_task != task:
+            notes.append("Used recent issue references from AgentPack memory as routing hints.")
 
         result = RouteResult(
             task=task,
@@ -164,6 +169,22 @@ def _normalize_task(task: str) -> str:
     return normalized
 
 
+def _task_with_recent_issue_context(root: Path, task: str) -> str:
+    if extract_issue_references(task):
+        return task
+    cfg = load_config(root)
+    events = read_events(root, output_path=cfg.runtime.session_events_output, limit=50)
+    refs = merge_issue_references(
+        ref
+        for event in events
+        for ref in (event.get("issue_references") or [])
+        if isinstance(ref, str)
+    )
+    if not refs:
+        return task
+    return f"{task} issue references {' '.join(refs[-5:])}"
+
+
 def _selected_file_dict(item) -> dict:
     return {
         "path": item.path,