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.
- {devkb-0.2.1/devkb.egg-info → devkb-0.2.3}/PKG-INFO +5 -2
- {devkb-0.2.1 → devkb-0.2.3}/README.md +4 -1
- {devkb-0.2.1 → devkb-0.2.3}/devkb/init.py +20 -0
- {devkb-0.2.1 → devkb-0.2.3/devkb.egg-info}/PKG-INFO +5 -2
- {devkb-0.2.1 → devkb-0.2.3}/pyproject.toml +1 -1
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_init.py +13 -0
- {devkb-0.2.1 → devkb-0.2.3}/LICENSE +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/NOTICE +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/__init__.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/audit.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/add_packs.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/cli_tasks.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/confirm_tasks.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/module_truth.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/oco_tasks.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/pipeline.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/process_tasks.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/report.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/run.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/truth_check.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_report.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_run.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/bench/workflow_tasks.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/build.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/build_symbols.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/call_recall.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/cli.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/coverage.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/cpp_symbols.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/edge_truth.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/backlog.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/component_subsystem.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/configuration.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/files_tests.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/flows.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/lifecycle.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/members.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/pull_requests.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/releases.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/source_baseline.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/spec_docs.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/symbol_tests.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/test_inventory.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/ticket_similarity.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/tickets_git.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/warnings.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/extractors/work_units.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/github.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/gitutil.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/index.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/mcp_server.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/model.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/module_file_bridge.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/ontology.md +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/packs.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/process_api.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/project_context.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/query.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/service.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/startup.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/test_discovery.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb/ts_symbols.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/SOURCES.txt +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/dependency_links.txt +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/entry_points.txt +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/requires.txt +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/devkb.egg-info/top_level.txt +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/setup.cfg +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_bench_pipeline_detail.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_claude_plugin.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_ablation_process_odsf316.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_audit_efficiency_odsf314.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_authoring_odsf311.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bench_odsf308.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_baseline_symbols_odsf042.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_containment_errors_criticality_odsf043.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_crossfile_ts_api_odsf043.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_linkage_workunits_odsf042.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_bl_similarity_flows_specs_odsf043.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_builder_checkout_odsf104.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_call_resolution_odsf305.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_confirmatory_truth_odsf315.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_coverage_classes_odsf313.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_coverage_odsf304.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_files_tests_odsf032.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_mcp_odsf307.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_process_api_odsf306.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_process_api_odsf309.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_product_graph_odsf312.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_pull_requests_adr007.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_similarity_ranking_odsf059.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_submodules_odsf312.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_typed_calls_odsf312.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_warnings_odsf033.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_workflow_bench_odsf310.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_devkb_workflows_odsf310.py +0 -0
- {devkb-0.2.1 → devkb-0.2.3}/tests/test_module_truth_routes.py +0 -0
- {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.
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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
|
-
|
|
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.
|
|
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
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|