agentpack-cli 0.3.33__tar.gz → 0.3.35__tar.gz

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.33
+Version: 0.3.35
 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/
@@ -83,6 +83,14 @@ Description-Content-Type: text/markdown
 
 ---
 
+<p align="center">
+  <img src="docs/assets/agentpack-demo.gif" alt="Terminal demo: AgentPack refreshes context, routes a task to ranked files and warnings, then runs a focused test." width="840">
+</p>
+
+<p align="center">
+  <a href="docs/assets/agentpack-demo.mp4">MP4 demo</a>
+</p>
+
 You know the pattern. You ask an agent to fix one bug. It `rg`s half the repo, opens the wrong files, misses the test, then rediscovers the architecture you already had.
 
 AgentPack does the repo-orientation pass first.
@@ -90,6 +98,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> why those files, and why common candidates were skipped
 -> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
@@ -124,12 +133,15 @@ Inside your repo:
 
 ```bash
 agentpack init --yes
-agentpack route --task "fix auth token expiry"
-agentpack task set "fix auth token expiry"
-agentpack pack --task auto
+agentpack start "fix auth token expiry"
+agentpack next
+agentpack doctor --agent auto
 ```
 
 Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
+Core onboarding is `quickstart`, `start`, `next`, and `doctor`. Use `route`,
+`pack`, and `benchmark` when you need deeper inspection or measurement.
+Everything else is an advanced workflow or release/diagnostic helper.
 
 For one-shot use without installing:
 
@@ -146,6 +158,13 @@ npx @vishal2612200/agentpack task set "fix auth token expiry"
 npx @vishal2612200/agentpack pack --task auto
 ```
 
+## New Contributors
+
+Start with [`good first issue`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22) or [`help wanted`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22help%20wanted%22) issues.
+If this would be your first open-source contribution, use the smaller
+[`first-timers-only`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22first-timers-only%22) queue.
+Contribution setup and review expectations are in [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## Quick Demo
 
 Route task first:
@@ -154,7 +173,7 @@ Route task first:
 agentpack route --task "fix billing webhook retry handling"
 ```
 
-AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+AgentPack returns likely files, why-selected and why-not-selected notes, tests, rules, commands, and warnings without changing source files.
 It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
@@ -166,6 +185,7 @@ agentpack pack --task auto
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, token stats, and `.agentpack/citations.json` source provenance for the packed claims.
 It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
+Run `agentpack doctor` when an agent integration, MCP setup, hook, or installed CLI path looks stale.
 
 ## What AgentPack Gives Your Agent
 
@@ -183,14 +203,14 @@ It reuses cached file summaries and snapshot metadata so repeated packs do not s
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
 
-## What's Current In 0.3.33
+## What's Current In 0.3.35
 
-- Grounded broad context now supports review, sharing, audit, and repo-overview tasks with citation checks and scoped safety gates.
-- Review workflows now push agents through preflight, understanding, and findings stages instead of letting review prompts answer inline.
-- Pack and route fallbacks are stricter about stale context, missing MCP surfaces, and source provenance.
-- The npm wrapper preserves the selected Python descriptor when creating the versioned CLI environment.
-- Packaged Codex plugin metadata, docs URLs, and scanner automation now score cleanly in local HOL scans.
-- Light fixture recall improved by keeping correlated source/deploy summaries and using concrete owner terms in fixture tasks.
+- First-run output is clearer: `quickstart`, `next`, and top-level help now point new users through one core path before optional diagnostics.
+- `doctor`, `repair`, `guard`, and `review --check` now print more explicit failure, impact, repair command, and safe-to-continue guidance.
+- Review inline posting is safer: live GitHub comments require a matching `--dry-run-post` payload hash before `--post-inline-comments`.
+- MCP structured outputs and TOON validation are stricter, including canonical TOON output for agents that need repairable structured responses.
+- Route output now explains both why files were selected and why common candidates were omitted.
+- Codex, Claude, Cursor, Windsurf, and Antigravity detection and distributed guidance were refreshed so active-agent and fallback behavior are easier to audit.
 
 ## Proof So Far
 
@@ -210,6 +230,8 @@ Source: [`benchmarks/results/2026-06-25-public.md`](benchmarks/results/2026-06-2
 
 This is useful but not magic. It says AgentPack often gets meaningful files into a small pack. It does not replace source inspection, tests, runtime evidence, or review. Agent success A/B benchmarks should report task success, tool calls, token cost, validation quality, and time-to-first-correct-file.
 
+E2E outcome proof is tracked separately in [`benchmarks/results/e2e-ab-status.md`](benchmarks/results/e2e-ab-status.md). Do not treat file-selection results as task-success or cost-savings proof.
+
 ## What We Want To Prove Next
 
 AgentPack should eventually show:
@@ -346,7 +368,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.33`.
+Alpha: `0.3.35`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 
@@ -354,6 +376,11 @@ Platform support targets macOS, Linux, and Windows PowerShell with Git for Windo
 
 Name note: PyPI package is `agentpack-cli`, npm package is `@vishal2612200/agentpack`, and command is `agentpack`. This project is unrelated to AgentPack dataset papers or other repos with the same name.
 
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for setup, validation, and PR expectations.
+Community behavior is covered by [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
+
 ## License
 
 MIT

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/README.md

@@ -36,6 +36,14 @@
 
 ---
 
+<p align="center">
+  <img src="docs/assets/agentpack-demo.gif" alt="Terminal demo: AgentPack refreshes context, routes a task to ranked files and warnings, then runs a focused test." width="840">
+</p>
+
+<p align="center">
+  <a href="docs/assets/agentpack-demo.mp4">MP4 demo</a>
+</p>
+
 You know the pattern. You ask an agent to fix one bug. It `rg`s half the repo, opens the wrong files, misses the test, then rediscovers the architecture you already had.
 
 AgentPack does the repo-orientation pass first.
@@ -43,6 +51,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> why those files, and why common candidates were skipped
 -> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
@@ -77,12 +86,15 @@ Inside your repo:
 
 ```bash
 agentpack init --yes
-agentpack route --task "fix auth token expiry"
-agentpack task set "fix auth token expiry"
-agentpack pack --task auto
+agentpack start "fix auth token expiry"
+agentpack next
+agentpack doctor --agent auto
 ```
 
 Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
+Core onboarding is `quickstart`, `start`, `next`, and `doctor`. Use `route`,
+`pack`, and `benchmark` when you need deeper inspection or measurement.
+Everything else is an advanced workflow or release/diagnostic helper.
 
 For one-shot use without installing:
 
@@ -99,6 +111,13 @@ npx @vishal2612200/agentpack task set "fix auth token expiry"
 npx @vishal2612200/agentpack pack --task auto
 ```
 
+## New Contributors
+
+Start with [`good first issue`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22) or [`help wanted`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22help%20wanted%22) issues.
+If this would be your first open-source contribution, use the smaller
+[`first-timers-only`](https://github.com/vishal2612200/agentpack/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22first-timers-only%22) queue.
+Contribution setup and review expectations are in [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## Quick Demo
 
 Route task first:
@@ -107,7 +126,7 @@ Route task first:
 agentpack route --task "fix billing webhook retry handling"
 ```
 
-AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+AgentPack returns likely files, why-selected and why-not-selected notes, tests, rules, commands, and warnings without changing source files.
 It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
@@ -119,6 +138,7 @@ agentpack pack --task auto
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, token stats, and `.agentpack/citations.json` source provenance for the packed claims.
 It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
+Run `agentpack doctor` when an agent integration, MCP setup, hook, or installed CLI path looks stale.
 
 ## What AgentPack Gives Your Agent
 
@@ -136,14 +156,14 @@ It reuses cached file summaries and snapshot metadata so repeated packs do not s
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
 
-## What's Current In 0.3.33
+## What's Current In 0.3.35
 
-- Grounded broad context now supports review, sharing, audit, and repo-overview tasks with citation checks and scoped safety gates.
-- Review workflows now push agents through preflight, understanding, and findings stages instead of letting review prompts answer inline.
-- Pack and route fallbacks are stricter about stale context, missing MCP surfaces, and source provenance.
-- The npm wrapper preserves the selected Python descriptor when creating the versioned CLI environment.
-- Packaged Codex plugin metadata, docs URLs, and scanner automation now score cleanly in local HOL scans.
-- Light fixture recall improved by keeping correlated source/deploy summaries and using concrete owner terms in fixture tasks.
+- First-run output is clearer: `quickstart`, `next`, and top-level help now point new users through one core path before optional diagnostics.
+- `doctor`, `repair`, `guard`, and `review --check` now print more explicit failure, impact, repair command, and safe-to-continue guidance.
+- Review inline posting is safer: live GitHub comments require a matching `--dry-run-post` payload hash before `--post-inline-comments`.
+- MCP structured outputs and TOON validation are stricter, including canonical TOON output for agents that need repairable structured responses.
+- Route output now explains both why files were selected and why common candidates were omitted.
+- Codex, Claude, Cursor, Windsurf, and Antigravity detection and distributed guidance were refreshed so active-agent and fallback behavior are easier to audit.
 
 ## Proof So Far
 
@@ -163,6 +183,8 @@ Source: [`benchmarks/results/2026-06-25-public.md`](benchmarks/results/2026-06-2
 
 This is useful but not magic. It says AgentPack often gets meaningful files into a small pack. It does not replace source inspection, tests, runtime evidence, or review. Agent success A/B benchmarks should report task success, tool calls, token cost, validation quality, and time-to-first-correct-file.
 
+E2E outcome proof is tracked separately in [`benchmarks/results/e2e-ab-status.md`](benchmarks/results/e2e-ab-status.md). Do not treat file-selection results as task-success or cost-savings proof.
+
 ## What We Want To Prove Next
 
 AgentPack should eventually show:
@@ -299,7 +321,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.33`.
+Alpha: `0.3.35`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 
@@ -307,6 +329,11 @@ Platform support targets macOS, Linux, and Windows PowerShell with Git for Windo
 
 Name note: PyPI package is `agentpack-cli`, npm package is `@vishal2612200/agentpack`, and command is `agentpack`. This project is unrelated to AgentPack dataset papers or other repos with the same name.
 
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for setup, validation, and PR expectations.
+Community behavior is covered by [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
+
 ## License
 
 MIT

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.33"
+version = "0.3.35"
 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"
@@ -69,6 +69,14 @@ markers = [
     "slow: marks tests as slow (deselect with '-m \"not slow\"')",
 ]
 
+[tool.mypy]
+python_version = "3.10"
+files = [
+  "src/agentpack/core/e2e_benchmark.py",
+  "src/agentpack/core/modes.py",
+  "src/agentpack/router/models.py",
+]
+
 [tool.coverage.run]
 source = [
   "src/agentpack/core",

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/src/agentpack/__init__.py

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

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/src/agentpack/adapters/detect.py

@@ -10,34 +10,45 @@ def detect_agent(root: Path) -> str:
     Priority:
       1. AGENTPACK_AGENT env var (explicit override)
       2. CLAUDECODE / CLAUDE_CODE_ENTRYPOINT env → claude
-      3. ANTIGRAVITY env var present → antigravity
-      4. .agent/skills/ dir exists → antigravity
-      5. GEMINI.md exists → antigravity
-      6. OPENAI_CODEX / CODEX_ENVIRONMENT env → codex
-      7. .cursor/ dir or .cursorrules exists → cursor
-      8. .windsurfrules exists → windsurf
-      9. Fallback → claude
+      3. Codex env markers → codex
+      4. ANTIGRAVITY env var present → antigravity
+      5. Codex project markers → codex
+      6. .agent/skills/ dir exists → antigravity
+      7. GEMINI.md exists → antigravity
+      8. .cursor/ dir or .cursorrules exists → cursor
+      9. .windsurfrules exists → windsurf
+      10. Fallback → claude
     """
     if override := os.environ.get("AGENTPACK_AGENT"):
         return override
 
+    # Host env wins over repository files. Multi-agent repos can contain every
+    # rule file, so project artifacts are only fallback hints.
     # Claude Code sets CLAUDECODE=1 and CLAUDE_CODE_ENTRYPOINT in its shell env
     if os.environ.get("CLAUDECODE") or os.environ.get("CLAUDE_CODE_ENTRYPOINT"):
         return "claude"
 
+    if (
+        os.environ.get("OPENAI_CODEX")
+        or os.environ.get("CODEX_ENVIRONMENT")
+        or os.environ.get("CODEX_SHELL")
+        or os.environ.get("CODEX_CI")
+        or os.environ.get("CODEX_THREAD_ID")
+    ):
+        return "codex"
+
     if os.environ.get("ANTIGRAVITY"):
         return "antigravity"
 
+    if _has_codex_project_markers(root):
+        return "codex"
+
     if (root / ".agent" / "skills").is_dir():
         return "antigravity"
 
     if (root / "GEMINI.md").exists():
         return "antigravity"
 
-    # Codex sets OPENAI_CODEX=1 or CODEX_ENVIRONMENT in its shell env
-    if os.environ.get("OPENAI_CODEX") or os.environ.get("CODEX_ENVIRONMENT"):
-        return "codex"
-
     if (root / ".cursor").is_dir() or (root / ".cursorrules").exists():
         return "cursor"
 
@@ -45,3 +56,11 @@ def detect_agent(root: Path) -> str:
         return "windsurf"
 
     return "claude"
+
+
+def _has_codex_project_markers(root: Path) -> bool:
+    return (
+        (root / ".codex").is_dir()
+        or (root / ".codex-plugin" / "plugin.json").exists()
+        or (root / ".codexignore").exists()
+    )

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/src/agentpack/analysis/monorepo.py

@@ -27,7 +27,15 @@ def detect_workspace_roots(root: Path) -> list[str]:
 
 
 def detect_workspace_dependency_edges(root: Path, workspace_roots: list[str]) -> dict[str, set[str]]:
-    """Return workspace -> workspace dependency edges from package.json files."""
+    """Return workspace -> workspace dependency edges from common package manifests."""
+    edges: dict[str, set[str]] = {workspace: set() for workspace in workspace_roots}
+    _add_package_json_edges(root, workspace_roots, edges)
+    _add_cargo_edges(root, workspace_roots, edges)
+    _add_go_edges(root, workspace_roots, edges)
+    return edges
+
+
+def _add_package_json_edges(root: Path, workspace_roots: list[str], edges: dict[str, set[str]]) -> None:
     package_names: dict[str, str] = {}
     for workspace in workspace_roots:
         package_json = root / workspace / "package.json"
@@ -41,7 +49,6 @@ def detect_workspace_dependency_edges(root: Path, workspace_roots: list[str]) ->
         if isinstance(name, str) and name:
             package_names[name] = workspace
 
-    edges: dict[str, set[str]] = {workspace: set() for workspace in workspace_roots}
     for workspace in workspace_roots:
         package_json = root / workspace / "package.json"
         if not package_json.exists():
@@ -59,7 +66,153 @@ def detect_workspace_dependency_edges(root: Path, workspace_roots: list[str]) ->
             dep_workspace = package_names.get(name)
             if dep_workspace and dep_workspace != workspace:
                 edges.setdefault(workspace, set()).add(dep_workspace)
-    return edges
+
+
+def _add_cargo_edges(root: Path, workspace_roots: list[str], edges: dict[str, set[str]]) -> None:
+    for workspace in workspace_roots:
+        manifest = root / workspace / "Cargo.toml"
+        if not manifest.exists():
+            continue
+        try:
+            import tomllib
+        except ImportError:
+            import tomli as tomllib  # type: ignore[no-redef]
+        try:
+            data = tomllib.loads(manifest.read_text(encoding="utf-8"))
+        except (OSError, tomllib.TOMLDecodeError):
+            continue
+        for section in ("dependencies", "dev-dependencies", "build-dependencies"):
+            raw = data.get(section)
+            if isinstance(raw, dict):
+                _add_cargo_section_edges(root, workspace, raw, workspace_roots, edges)
+        target = data.get("target")
+        if isinstance(target, dict):
+            for target_data in target.values():
+                if not isinstance(target_data, dict):
+                    continue
+                for section in ("dependencies", "dev-dependencies", "build-dependencies"):
+                    raw = target_data.get(section)
+                    if isinstance(raw, dict):
+                        _add_cargo_section_edges(root, workspace, raw, workspace_roots, edges)
+
+
+def _add_cargo_section_edges(
+    root: Path,
+    workspace: str,
+    dependencies: dict[str, object],
+    workspace_roots: list[str],
+    edges: dict[str, set[str]],
+) -> None:
+    workspace_dir = root / workspace
+    for spec in dependencies.values():
+        if not isinstance(spec, dict):
+            continue
+        raw_path = spec.get("path")
+        if not isinstance(raw_path, str) or not raw_path:
+            continue
+        dep_workspace = _workspace_from_relative_path(root, workspace_dir / raw_path, workspace_roots)
+        if dep_workspace and dep_workspace != workspace:
+            edges.setdefault(workspace, set()).add(dep_workspace)
+
+
+def _add_go_edges(root: Path, workspace_roots: list[str], edges: dict[str, set[str]]) -> None:
+    module_to_workspace: dict[str, str] = {}
+    replacements_by_workspace: dict[str, dict[str, str]] = {}
+    requires_by_workspace: dict[str, set[str]] = {}
+    for workspace in workspace_roots:
+        go_mod = root / workspace / "go.mod"
+        if not go_mod.exists():
+            continue
+        try:
+            text = go_mod.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        module = _go_module_name(text)
+        if module:
+            module_to_workspace[module] = workspace
+        replacements_by_workspace[workspace] = _go_replacements(root, root / workspace, text, workspace_roots)
+        requires_by_workspace[workspace] = _go_requires(text)
+
+    for workspace, requires in requires_by_workspace.items():
+        replacements = replacements_by_workspace.get(workspace, {})
+        for module in requires:
+            dep_workspace = replacements.get(module) or module_to_workspace.get(module)
+            if dep_workspace and dep_workspace != workspace:
+                edges.setdefault(workspace, set()).add(dep_workspace)
+
+
+def _go_module_name(text: str) -> str | None:
+    match = re.search(r"^module\s+(\S+)", text, flags=re.MULTILINE)
+    return match.group(1) if match else None
+
+
+def _go_requires(text: str) -> set[str]:
+    modules: set[str] = set()
+    in_block = False
+    for raw in text.splitlines():
+        line = raw.strip()
+        if not line or line.startswith("//"):
+            continue
+        if line == "require (":
+            in_block = True
+            continue
+        if in_block and line == ")":
+            in_block = False
+            continue
+        if line.startswith("require "):
+            modules.add(line.split()[1])
+        elif in_block:
+            modules.add(line.split()[0])
+    return modules
+
+
+def _go_replacements(root: Path, workspace_dir: Path, text: str, workspace_roots: list[str]) -> dict[str, str]:
+    replacements: dict[str, str] = {}
+    in_block = False
+    for raw in text.splitlines():
+        line = raw.strip()
+        if not line or line.startswith("//"):
+            continue
+        if line == "replace (":
+            in_block = True
+            continue
+        if in_block and line == ")":
+            in_block = False
+            continue
+        if line.startswith("replace "):
+            _add_go_replacement(root, workspace_dir, line.removeprefix("replace ").strip(), workspace_roots, replacements)
+        elif in_block:
+            _add_go_replacement(root, workspace_dir, line, workspace_roots, replacements)
+    return replacements
+
+
+def _add_go_replacement(
+    root: Path,
+    workspace_dir: Path,
+    line: str,
+    workspace_roots: list[str],
+    replacements: dict[str, str],
+) -> None:
+    if "=>" not in line:
+        return
+    left, right = [part.strip() for part in line.split("=>", 1)]
+    module = left.split()[0]
+    target = right.split()[0]
+    if not target.startswith((".", "/")):
+        return
+    target_path = Path(target)
+    candidate = target_path if target_path.is_absolute() else workspace_dir / target_path
+    dep_workspace = _workspace_from_relative_path(root, candidate, workspace_roots)
+    if dep_workspace:
+        replacements[module] = dep_workspace
+
+
+def _workspace_from_relative_path(root: Path, candidate: Path, workspace_roots: list[str]) -> str | None:
+    try:
+        rel = candidate.resolve().relative_to(root.resolve()).as_posix()
+    except (OSError, ValueError):
+        return None
+    return workspace_for_path(rel, workspace_roots)
 
 
 def workspace_for_path(path: str, workspace_roots: list[str]) -> str | None:

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/src/agentpack/analysis/symbols.py

@@ -97,6 +97,8 @@ _JS_EXPORTED_VAR = re.compile(
     r"\bexport\s+(?:declare\s+)?(?:const|let|var)\s+(\w+)\s*(?::[^=;]+)?=",
 )
 _JS_CLASS = re.compile(r"(?:export\s+)?class\s+(\w+)")
+_GO_FUNC = re.compile(r"^func\s+(?:\(([^)]+)\)\s*)?(\w+)\s*\(([^)]*)\)")
+_GO_TYPE = re.compile(r"^type\s+(\w+)\s+(struct|interface)\b")
 
 
 def extract_js_symbols(path: Path) -> list[Symbol]:
@@ -137,11 +139,73 @@ def extract_js_symbols(path: Path) -> list[Symbol]:
     return symbols
 
 
+def extract_go_symbols(path: Path) -> list[Symbol]:
+    try:
+        lines = path.read_text(errors="replace").splitlines()
+    except OSError:
+        return []
+
+    symbols: list[Symbol] = []
+    for i, line in enumerate(lines, 1):
+        stripped = line.strip()
+        func_match = _GO_FUNC.match(stripped)
+        if func_match:
+            receiver, name, _args = func_match.groups()
+            symbol_name = f"{_go_receiver_name(receiver)}.{name}" if receiver else name
+            symbols.append(
+                Symbol(
+                    name=symbol_name,
+                    kind="method" if receiver else "function",
+                    start_line=i,
+                    end_line=_go_symbol_end_line(lines, i),
+                    signature=stripped[:120],
+                    body="\n".join(lines[i - 1 : min(i + 49, len(lines))]),
+                )
+            )
+            continue
+        type_match = _GO_TYPE.match(stripped)
+        if type_match:
+            name, type_kind = type_match.groups()
+            symbols.append(
+                Symbol(
+                    name=name,
+                    kind="class",
+                    start_line=i,
+                    end_line=_go_symbol_end_line(lines, i),
+                    signature=stripped[:120],
+                    summary=f"Go {type_kind}",
+                    body="\n".join(lines[i - 1 : min(i + 49, len(lines))]),
+                )
+            )
+    return symbols
+
+
+def _go_receiver_name(receiver: str | None) -> str:
+    if not receiver:
+        return ""
+    parts = receiver.replace("*", " ").split()
+    return parts[-1] if parts else receiver.strip()
+
+
+def _go_symbol_end_line(lines: list[str], start_line: int) -> int:
+    depth = 0
+    saw_open = False
+    for index in range(start_line - 1, len(lines)):
+        line = lines[index]
+        depth += line.count("{") - line.count("}")
+        saw_open = saw_open or "{" in line
+        if saw_open and depth <= 0:
+            return index + 1
+    return start_line
+
+
 def extract_symbols(path: Path, language: str | None) -> list[Symbol]:
     if language == "python":
         return extract_python_symbols(path)
     if language in ("javascript", "typescript"):
         return extract_js_symbols(path)
+    if language == "go":
+        return extract_go_symbols(path)
     return []
 
 

{agentpack_cli-0.3.33 → agentpack_cli-0.3.35}/src/agentpack/application/pack_service.py

@@ -748,6 +748,7 @@ class AdapterRegistry:
                 cfg.learning.episodic_cases_output,
                 cfg.runtime.pack_registry_output,
                 cfg.runtime.session_events_output,
+                ".agent/skills/agentpack/citations.json",
             }
         )
         return paths