@oka-core/reason 0.2.1 → 0.2.8
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.
- package/README.md +59 -0
- package/dist/index.js +4 -1
- package/package.json +14 -12
package/README.md
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# @oka-core/reason
|
|
2
|
+
|
|
3
|
+
MCP server for institutional knowledge capture, consolidation, and retrieval.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
pnpm add @oka-core/reason
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
Add to your MCP client configuration:
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"reason": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "@oka-core/reason"]
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Tools
|
|
27
|
+
|
|
28
|
+
### Write
|
|
29
|
+
|
|
30
|
+
- **observe** — Record a learning or observation
|
|
31
|
+
- **decision** — Record an architectural decision
|
|
32
|
+
- **deviation** — Record a deviation from established patterns
|
|
33
|
+
- **done** — Mark a task as complete with summary
|
|
34
|
+
- **consolidate** — Trigger knowledge consolidation
|
|
35
|
+
|
|
36
|
+
### Read
|
|
37
|
+
|
|
38
|
+
- **explore** — Explore learnings by area
|
|
39
|
+
- **context** — Get contextual knowledge for a task
|
|
40
|
+
- **patterns** — Get recurring patterns
|
|
41
|
+
- **learnings** — List recent learnings
|
|
42
|
+
- **decisions** — List architectural decisions
|
|
43
|
+
- **priorities** — Get current priorities
|
|
44
|
+
- **suggest** — Get AI-powered suggestions
|
|
45
|
+
- **backlog** — View AI-generated backlog items
|
|
46
|
+
- **semantic_search** — Search by meaning using embeddings
|
|
47
|
+
|
|
48
|
+
### Auth
|
|
49
|
+
|
|
50
|
+
- **login** — Authenticate via browser
|
|
51
|
+
- **whoami** — Check authentication status
|
|
52
|
+
|
|
53
|
+
## Requirements
|
|
54
|
+
|
|
55
|
+
- Node.js >= 20
|
|
56
|
+
|
|
57
|
+
## License
|
|
58
|
+
|
|
59
|
+
UNLICENSED
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
import { createRequire } from "node:module";
|
|
2
3
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
4
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
4
5
|
import { OkaClient } from "./client.js";
|
|
@@ -8,9 +9,11 @@ import { registerAuthTools } from "./tools/auth.js";
|
|
|
8
9
|
import { loadEnvFile } from "./auth.js";
|
|
9
10
|
// Load .env from the project root (cwd), env vars take precedence
|
|
10
11
|
loadEnvFile(process.cwd());
|
|
12
|
+
const require = createRequire(import.meta.url);
|
|
13
|
+
const { version } = require("../package.json");
|
|
11
14
|
const server = new McpServer({
|
|
12
15
|
name: "@oka-core/reason",
|
|
13
|
-
version
|
|
16
|
+
version,
|
|
14
17
|
});
|
|
15
18
|
// Client resolves credentials lazily on each request — no restart needed
|
|
16
19
|
// after login or credential changes.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oka-core/reason",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "MCP server for
|
|
3
|
+
"version": "0.2.8",
|
|
4
|
+
"description": "MCP server for institutional knowledge capture, semantic search, and consolidation",
|
|
5
5
|
"private": false,
|
|
6
6
|
"publishConfig": {
|
|
7
7
|
"access": "restricted"
|
|
@@ -28,6 +28,15 @@
|
|
|
28
28
|
"dist",
|
|
29
29
|
"README.md"
|
|
30
30
|
],
|
|
31
|
+
"scripts": {
|
|
32
|
+
"build": "tsc",
|
|
33
|
+
"check-types": "tsc --noEmit",
|
|
34
|
+
"prepublishOnly": "npm run build",
|
|
35
|
+
"test": "vitest run",
|
|
36
|
+
"test:watch": "vitest",
|
|
37
|
+
"lint": "echo 'lint ok'",
|
|
38
|
+
"typecheck": "tsc --noEmit"
|
|
39
|
+
},
|
|
31
40
|
"keywords": [
|
|
32
41
|
"mcp",
|
|
33
42
|
"reasoning",
|
|
@@ -41,6 +50,7 @@
|
|
|
41
50
|
"url": "https://github.com/datacircuits/agentic.git",
|
|
42
51
|
"directory": "packages/reason"
|
|
43
52
|
},
|
|
53
|
+
"homepage": "https://reason.oka.so",
|
|
44
54
|
"engines": {
|
|
45
55
|
"node": ">=20"
|
|
46
56
|
},
|
|
@@ -51,14 +61,6 @@
|
|
|
51
61
|
"devDependencies": {
|
|
52
62
|
"typescript": "^5.5.0",
|
|
53
63
|
"vitest": "^2.0.0",
|
|
54
|
-
"@oka/typescript-config": "
|
|
55
|
-
},
|
|
56
|
-
"scripts": {
|
|
57
|
-
"build": "tsc",
|
|
58
|
-
"check-types": "tsc --noEmit",
|
|
59
|
-
"test": "vitest run",
|
|
60
|
-
"test:watch": "vitest",
|
|
61
|
-
"lint": "echo 'lint ok'",
|
|
62
|
-
"typecheck": "tsc --noEmit"
|
|
64
|
+
"@oka/typescript-config": "workspace:*"
|
|
63
65
|
}
|
|
64
|
-
}
|
|
66
|
+
}
|