Skip to content

Commit 06cc02a

Browse files
committed
refactor!: rename package to @codemcp/knowledge with ade-knowledge binary
Harmonize naming across the @codemcp/* ecosystem so developers have a consistent, predictable experience. Previously, package names and binary names varied wildly across different tools, forcing users to look up documentation for each one. - Root package renamed from `agentic-knowledge-mcp` to `@codemcp/knowledge` - Binary renamed from `agentic-knowledge` to `ade-knowledge` - MCP server sub-package `bin` field removed (dead weight, binary belongs on root) - All documentation updated to use `npx @codemcp/knowledge` invocation - CLI program name updated to `ade-knowledge` in help output - The routing behavior is unchanged: no args starts MCP server, with args runs CLI - Breaking change for users with MCP configs using the old binary name - Users invoking via `npx @codemcp/knowledge` are unaffected (npm resolves the binary) - Stub package `agentic-knowledge-mcp` should be published pointing to the new name
1 parent 69d6265 commit 06cc02a

10 files changed

Lines changed: 93 additions & 97 deletions

File tree

.vibe/docs/requirements.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ Complex requirements for unwanted behavior also include the If-Then keywords.
183183

184184
- The system SHALL be distributable as NPM package
185185
- The system SHALL provide executable binary for MCP server
186-
- WHEN installed globally THEN the system SHALL be available as "agentic-knowledge-mcp" command
186+
- WHEN installed globally THEN the system SHALL be available as "ade-knowledge" command
187187
- The system SHALL follow semantic versioning for releases
188188
- The system SHALL include TypeScript type definitions for programmatic use
189189

@@ -206,7 +206,7 @@ Complex requirements for unwanted behavior also include the If-Then keywords.
206206

207207
**Acceptance Criteria:**
208208

209-
- WHEN CLI command "agentic-knowledge init {docset-id}" executed THEN the system SHALL clone configured Git repositories
209+
- WHEN CLI command "ade-knowledge init {docset-id}" executed THEN the system SHALL clone configured Git repositories
210210
- WHEN Git repository requires authentication THEN the system SHALL use system Git credentials
211211
- WHEN Git repository URL is invalid THEN the system SHALL return clear error message
212212
- WHEN Git repository is unreachable THEN the system SHALL return network error with retry suggestion
@@ -234,10 +234,10 @@ Complex requirements for unwanted behavior also include the If-Then keywords.
234234

235235
**Acceptance Criteria:**
236236

237-
- WHEN "agentic-knowledge init {docset-id}" executed AND docset has web_sources THEN the system SHALL download all configured sources
238-
- WHEN "agentic-knowledge refresh" executed without docset-id THEN the system SHALL refresh all docsets with web_sources
239-
- WHEN "agentic-knowledge refresh {docset-id}" executed THEN the system SHALL refresh only specified docset
240-
- WHEN "agentic-knowledge status" executed THEN the system SHALL show last update time for each web source
237+
- WHEN "ade-knowledge init {docset-id}" executed AND docset has web_sources THEN the system SHALL download all configured sources
238+
- WHEN "ade-knowledge refresh" executed without docset-id THEN the system SHALL refresh all docsets with web_sources
239+
- WHEN "ade-knowledge refresh {docset-id}" executed THEN the system SHALL refresh only specified docset
240+
- WHEN "ade-knowledge status" executed THEN the system SHALL show last update time for each web source
241241
- WHEN network is unavailable during refresh THEN the system SHALL report error but continue with other sources
242242
- The system SHALL show progress indicators for long-running downloads
243243

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,14 +40,14 @@ Add to your coding agent config something along the lines of
4040

4141
```bash
4242
# For a Git repository
43-
npx agentic-knowledge-mcp create \
43+
npx @codemcp/knowledge create \
4444
--preset git-repo \
4545
--id react-docs \
4646
--name "React Documentation" \
4747
--url https://github.com/facebook/react.git
4848

4949
# Initialize (downloads the docs)
50-
npx agentic-knowledge-mcp init react-docs
50+
npx @codemcp/knowledge init react-docs
5151

5252
# The MCP server starts automatically when Claude Desktop launches
5353
```

TESTING.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,28 +5,32 @@ This guide shows you how to manually test the agentic knowledge MCP server to ve
55
## Quick Test with curl/manual MCP calls
66

77
1. **Start the server in a project with configuration**:
8+
89
```bash
910
cd your-project-with-knowledge-config
10-
npx agentic-knowledge
11+
npx @codemcp/knowledge
1112
```
1213

1314
2. **Test tools/list request**:
15+
1416
```bash
15-
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx agentic-knowledge
17+
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx @codemcp/knowledge
1618
```
1719

1820
Expected response: JSON with `search_docs` and `list_docsets` tools.
1921

2022
3. **Test list_docsets**:
23+
2124
```bash
22-
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_docsets","arguments":{}}}' | npx agentic-knowledge
25+
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_docsets","arguments":{}}}' | npx @codemcp/knowledge
2326
```
2427

2528
Expected response: List of available docsets from your configuration.
2629

2730
4. **Test search_docs**:
31+
2832
```bash
29-
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_docs","arguments":{"docset_id":"your-docset-id","keywords":"search terms","generalized_keywords":"related terms"}}}' | npx agentic-knowledge
33+
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_docs","arguments":{"docset_id":"your-docset-id","keywords":"search terms","generalized_keywords":"related terms"}}}' | npx @codemcp/knowledge
3034
```
3135

3236
Expected response: Intelligent search instructions based on your template.
@@ -53,13 +57,15 @@ This ensures LLMs understand how to properly use the search functionality.
5357
## Performance Validation
5458

5559
The tests validate:
60+
5661
- ✅ Server creation: <1ms
57-
- ✅ E2E response time: <1ms (well under 10ms requirement)
62+
- ✅ E2E response time: <1ms (well under 10ms requirement)
5863
- ✅ Memory usage: <1MB
5964

6065
## What the Tests Cover
6166

6267
### Unit Tests (84 + 11 = 95)
68+
6369
- Configuration discovery and loading
6470
- YAML parsing and validation
6571
- Path calculation and resolution
@@ -68,6 +74,7 @@ The tests validate:
6874
- Server lifecycle and caching
6975

7076
### E2E Tests (12)
77+
7178
- MCP protocol compliance
7279
- Real client-server communication
7380
- Tool schema validation
@@ -79,13 +86,15 @@ The tests validate:
7986
## Expected Test Output
8087

8188
All tests should pass:
89+
8290
```
8391
Test Files 1 passed (1)
8492
Tests 12 passed (12)
8593
Duration ~1.5s
8694
```
8795

8896
If any tests fail, check:
97+
8998
1. All dependencies installed (`pnpm install`)
9099
2. Project built successfully (`pnpm build`)
91-
3. No configuration conflicts in test environment
100+
3. No configuration conflicts in test environment

0 commit comments

Comments
 (0)