devkb 0.2.1__tar.gz → 0.2.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. {devkb-0.2.1/devkb.egg-info → devkb-0.2.3}/PKG-INFO +5 -2
  2. {devkb-0.2.1 → devkb-0.2.3}/README.md +4 -1
  3. {devkb-0.2.1 → devkb-0.2.3}/devkb/init.py +20 -0
  4. {devkb-0.2.1 → devkb-0.2.3/devkb.egg-info}/PKG-INFO +5 -2
  5. {devkb-0.2.1 → devkb-0.2.3}/pyproject.toml +1 -1
  6. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_init.py +13 -0
  7. {devkb-0.2.1 → devkb-0.2.3}/LICENSE +0 -0
  8. {devkb-0.2.1 → devkb-0.2.3}/NOTICE +0 -0
  9. {devkb-0.2.1 → devkb-0.2.3}/devkb/__init__.py +0 -0
  10. {devkb-0.2.1 → devkb-0.2.3}/devkb/audit.py +0 -0
  11. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/add_packs.py +0 -0
  12. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/cli_tasks.py +0 -0
  13. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/confirm_tasks.py +0 -0
  14. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/module_truth.py +0 -0
  15. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/oco_tasks.py +0 -0
  16. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/pipeline.py +0 -0
  17. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/process_tasks.py +0 -0
  18. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/report.py +0 -0
  19. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/run.py +0 -0
  20. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/truth_check.py +0 -0
  21. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_report.py +0 -0
  22. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_run.py +0 -0
  23. {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_tasks.py +0 -0
  24. {devkb-0.2.1 → devkb-0.2.3}/devkb/build.py +0 -0
  25. {devkb-0.2.1 → devkb-0.2.3}/devkb/build_symbols.py +0 -0
  26. {devkb-0.2.1 → devkb-0.2.3}/devkb/call_recall.py +0 -0
  27. {devkb-0.2.1 → devkb-0.2.3}/devkb/cli.py +0 -0
  28. {devkb-0.2.1 → devkb-0.2.3}/devkb/coverage.py +0 -0
  29. {devkb-0.2.1 → devkb-0.2.3}/devkb/cpp_symbols.py +0 -0
  30. {devkb-0.2.1 → devkb-0.2.3}/devkb/edge_truth.py +0 -0
  31. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/backlog.py +0 -0
  32. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/component_subsystem.py +0 -0
  33. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/configuration.py +0 -0
  34. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/files_tests.py +0 -0
  35. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/flows.py +0 -0
  36. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/lifecycle.py +0 -0
  37. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/members.py +0 -0
  38. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/pull_requests.py +0 -0
  39. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/releases.py +0 -0
  40. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/source_baseline.py +0 -0
  41. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/spec_docs.py +0 -0
  42. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/symbol_tests.py +0 -0
  43. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/test_inventory.py +0 -0
  44. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/ticket_similarity.py +0 -0
  45. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/tickets_git.py +0 -0
  46. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/warnings.py +0 -0
  47. {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/work_units.py +0 -0
  48. {devkb-0.2.1 → devkb-0.2.3}/devkb/github.py +0 -0
  49. {devkb-0.2.1 → devkb-0.2.3}/devkb/gitutil.py +0 -0
  50. {devkb-0.2.1 → devkb-0.2.3}/devkb/index.py +0 -0
  51. {devkb-0.2.1 → devkb-0.2.3}/devkb/mcp_server.py +0 -0
  52. {devkb-0.2.1 → devkb-0.2.3}/devkb/model.py +0 -0
  53. {devkb-0.2.1 → devkb-0.2.3}/devkb/module_file_bridge.py +0 -0
  54. {devkb-0.2.1 → devkb-0.2.3}/devkb/ontology.md +0 -0
  55. {devkb-0.2.1 → devkb-0.2.3}/devkb/packs.py +0 -0
  56. {devkb-0.2.1 → devkb-0.2.3}/devkb/process_api.py +0 -0
  57. {devkb-0.2.1 → devkb-0.2.3}/devkb/project_context.py +0 -0
  58. {devkb-0.2.1 → devkb-0.2.3}/devkb/query.py +0 -0
  59. {devkb-0.2.1 → devkb-0.2.3}/devkb/service.py +0 -0
  60. {devkb-0.2.1 → devkb-0.2.3}/devkb/startup.py +0 -0
  61. {devkb-0.2.1 → devkb-0.2.3}/devkb/test_discovery.py +0 -0
  62. {devkb-0.2.1 → devkb-0.2.3}/devkb/ts_symbols.py +0 -0
  63. {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/SOURCES.txt +0 -0
  64. {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/dependency_links.txt +0 -0
  65. {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/entry_points.txt +0 -0
  66. {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/requires.txt +0 -0
  67. {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/top_level.txt +0 -0
  68. {devkb-0.2.1 → devkb-0.2.3}/setup.cfg +0 -0
  69. {devkb-0.2.1 → devkb-0.2.3}/tests/test_bench_pipeline_detail.py +0 -0
  70. {devkb-0.2.1 → devkb-0.2.3}/tests/test_claude_plugin.py +0 -0
  71. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_ablation_process_odsf316.py +0 -0
  72. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_audit_efficiency_odsf314.py +0 -0
  73. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_authoring_odsf311.py +0 -0
  74. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bench_odsf308.py +0 -0
  75. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_baseline_symbols_odsf042.py +0 -0
  76. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_containment_errors_criticality_odsf043.py +0 -0
  77. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_crossfile_ts_api_odsf043.py +0 -0
  78. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_linkage_workunits_odsf042.py +0 -0
  79. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_similarity_flows_specs_odsf043.py +0 -0
  80. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_builder_checkout_odsf104.py +0 -0
  81. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_call_resolution_odsf305.py +0 -0
  82. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_confirmatory_truth_odsf315.py +0 -0
  83. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_coverage_classes_odsf313.py +0 -0
  84. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_coverage_odsf304.py +0 -0
  85. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_files_tests_odsf032.py +0 -0
  86. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_mcp_odsf307.py +0 -0
  87. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_process_api_odsf306.py +0 -0
  88. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_process_api_odsf309.py +0 -0
  89. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_product_graph_odsf312.py +0 -0
  90. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_pull_requests_adr007.py +0 -0
  91. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_similarity_ranking_odsf059.py +0 -0
  92. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_submodules_odsf312.py +0 -0
  93. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_typed_calls_odsf312.py +0 -0
  94. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_warnings_odsf033.py +0 -0
  95. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_workflow_bench_odsf310.py +0 -0
  96. {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_workflows_odsf310.py +0 -0
  97. {devkb-0.2.1 → devkb-0.2.3}/tests/test_module_truth_routes.py +0 -0
  98. {devkb-0.2.1 → devkb-0.2.3}/tests/test_reexports_module_calls.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: devkb
3
- Version: 0.2.1
3
+ Version: 0.2.3
4
4
  Summary: A software-process knowledge graph for software development agents: extraction, pre-computed context packs, and an MCP server
5
5
  Author: Hung T. Le
6
6
  License-Expression: Apache-2.0
@@ -108,11 +108,14 @@ add a repository: [`docs/BENCHMARK.md`](docs/BENCHMARK.md).
108
108
  ## 3. Set up
109
109
 
110
110
  ```bash
111
- pip install "devkb[mcp]"
111
+ uv tool install "devkb[mcp]" # or: pipx install "devkb[mcp]"
112
112
  cd your-repo
113
113
  devkb init --hooks
114
114
  ```
115
115
 
116
+ Install it as a tool, as above, so the `devkb` command is on your PATH: agents start the server from there, and a
117
+ devkb installed only inside a virtual environment never starts (`devkb init` warns if that is the case).
118
+
116
119
  This builds the graph into `.devkb/`, adds a short devkb section to `AGENTS.md` and `CLAUDE.md`, registers the MCP
117
120
  server in `.mcp.json`, and rebuilds the graph after each commit. Your own content in those files is kept;
118
121
  `devkb init --remove` undoes it.
@@ -72,11 +72,14 @@ add a repository: [`docs/BENCHMARK.md`](docs/BENCHMARK.md).
72
72
  ## 3. Set up
73
73
 
74
74
  ```bash
75
- pip install "devkb[mcp]"
75
+ uv tool install "devkb[mcp]" # or: pipx install "devkb[mcp]"
76
76
  cd your-repo
77
77
  devkb init --hooks
78
78
  ```
79
79
 
80
+ Install it as a tool, as above, so the `devkb` command is on your PATH: agents start the server from there, and a
81
+ devkb installed only inside a virtual environment never starts (`devkb init` warns if that is the case).
82
+
80
83
  This builds the graph into `.devkb/`, adds a short devkb section to `AGENTS.md` and `CLAUDE.md`, registers the MCP
81
84
  server in `.mcp.json`, and rebuilds the graph after each commit. Your own content in those files is kept;
82
85
  `devkb init --remove` undoes it.
@@ -154,6 +154,23 @@ def run(root: Path, toolset: str | None, hooks: bool, dry_run: bool) -> list[str
154
154
  return p.changes
155
155
 
156
156
 
157
+ def server_command_problem() -> str | None:
158
+ """Why agents could not start the `devkb` command that `.mcp.json` names, or None. Claude Code, Cursor and Codex
159
+ start it from the user's normal PATH, so a devkb installed only inside a virtual environment never starts and the
160
+ agent silently has no devkb tools (found dogfooding, 2026-11-15)."""
161
+ import shutil # noqa: PLC0415
162
+ import sys # noqa: PLC0415
163
+ found = shutil.which("devkb")
164
+ fix = 'install it as a tool so it is on your PATH everywhere: `uv tool install "devkb[mcp]"` (or `pipx install "devkb[mcp]"`)'
165
+ if found is None:
166
+ return f"the `devkb` command is not on your PATH, so agents cannot start the devkb server; {fix}"
167
+ in_venv = sys.prefix != getattr(sys, "base_prefix", sys.prefix)
168
+ if in_venv and Path(found).resolve().is_relative_to(Path(sys.prefix).resolve()):
169
+ return (f"`devkb` is only on the PATH of this virtual environment ({sys.prefix}); agents start it from your "
170
+ f"normal PATH and will not find it; {fix}")
171
+ return None
172
+
173
+
157
174
  def main(argv: list[str] | None = None) -> int:
158
175
  ap = argparse.ArgumentParser(prog="devkb init", description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
159
176
  ap.add_argument("--project", default=".")
@@ -166,6 +183,9 @@ def main(argv: list[str] | None = None) -> int:
166
183
  root = Path(a.project).resolve()
167
184
  changes = run(root, None if a.remove else a.toolset, a.hooks, a.dry_run)
168
185
  print(("would " if a.dry_run else "") + ("\n".join(changes) if changes else "nothing to change"))
186
+ problem = None if a.remove else server_command_problem()
187
+ if problem:
188
+ print(f"WARNING: {problem}", file=sys.stderr)
169
189
  if not (a.remove or a.no_build or a.dry_run):
170
190
  from devkb import cli # noqa: PLC0415
171
191
  return cli.main(["build", "--project", str(root)])
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: devkb
3
- Version: 0.2.1
3
+ Version: 0.2.3
4
4
  Summary: A software-process knowledge graph for software development agents: extraction, pre-computed context packs, and an MCP server
5
5
  Author: Hung T. Le
6
6
  License-Expression: Apache-2.0
@@ -108,11 +108,14 @@ add a repository: [`docs/BENCHMARK.md`](docs/BENCHMARK.md).
108
108
  ## 3. Set up
109
109
 
110
110
  ```bash
111
- pip install "devkb[mcp]"
111
+ uv tool install "devkb[mcp]" # or: pipx install "devkb[mcp]"
112
112
  cd your-repo
113
113
  devkb init --hooks
114
114
  ```
115
115
 
116
+ Install it as a tool, as above, so the `devkb` command is on your PATH: agents start the server from there, and a
117
+ devkb installed only inside a virtual environment never starts (`devkb init` warns if that is the case).
118
+
116
119
  This builds the graph into `.devkb/`, adds a short devkb section to `AGENTS.md` and `CLAUDE.md`, registers the MCP
117
120
  server in `.mcp.json`, and rebuilds the graph after each commit. Your own content in those files is kept;
118
121
  `devkb init --remove` undoes it.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "devkb"
7
- version = "0.2.1"
7
+ version = "0.2.3"
8
8
  description = "A software-process knowledge graph for software development agents: extraction, pre-computed context packs, and an MCP server"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -81,3 +81,16 @@ def test_the_file_pack_lists_what_depends_on_a_file_and_the_tests_reaching_it(tm
81
81
  assert "## Functions other files call (2 of 3)" in text and "`RuntimeStore.add_edge` — 2 file(s): `app/routes.py:6" in text
82
82
  assert "`app/routes.py`" in text and "tests/test_store.py" in text
83
83
  assert "The graph has no code" in Packer(_api(tmp_path / "x", monkeypatch)).file("nowhere.py")
84
+
85
+
86
+ def test_init_warns_when_agents_could_not_start_the_devkb_command(monkeypatch, capsys):
87
+ import shutil
88
+ import sys as _sys
89
+ monkeypatch.setattr(shutil, "which", lambda name: None)
90
+ assert "not on your PATH" in init.server_command_problem()
91
+ venv = Path(_sys.prefix)
92
+ monkeypatch.setattr(shutil, "which", lambda name: str(venv / "bin" / "devkb"))
93
+ monkeypatch.setattr(_sys, "base_prefix", "/usr")
94
+ assert "only on the PATH of this virtual environment" in init.server_command_problem()
95
+ monkeypatch.setattr(shutil, "which", lambda name: "/opt/tools/bin/devkb")
96
+ assert init.server_command_problem() is None
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes