lognexus-mcp 1.3.4__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.
- lognexus_mcp-1.3.4/LICENSE +22 -0
- lognexus_mcp-1.3.4/NOTICE.md +27 -0
- lognexus_mcp-1.3.4/PKG-INFO +432 -0
- lognexus_mcp-1.3.4/README.md +404 -0
- lognexus_mcp-1.3.4/pyproject.toml +56 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp/__init__.py +38 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp/__main__.py +6 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp.egg-info/PKG-INFO +432 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp.egg-info/SOURCES.txt +11 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp.egg-info/dependency_links.txt +1 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp.egg-info/entry_points.txt +3 -0
- lognexus_mcp-1.3.4/python/lognexus_mcp.egg-info/top_level.txt +1 -0
- lognexus_mcp-1.3.4/setup.cfg +4 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 devallibus
|
|
4
|
+
Copyright (c) 2026 Digital Lake and LogNexus contributors
|
|
5
|
+
|
|
6
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
7
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
8
|
+
in the Software without restriction, including without limitation the rights
|
|
9
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
10
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
11
|
+
furnished to do so, subject to the following conditions:
|
|
12
|
+
|
|
13
|
+
The above copyright notice and this permission notice shall be included in all
|
|
14
|
+
copies or substantial portions of the Software.
|
|
15
|
+
|
|
16
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
17
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
18
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
19
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
20
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
21
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
22
|
+
SOFTWARE.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Open Source Notice
|
|
2
|
+
|
|
3
|
+
## LogNexus
|
|
4
|
+
Copyright (c) 2026 Digital Lake and LogNexus contributors.
|
|
5
|
+
|
|
6
|
+
LogNexus is an independent hard fork and continuation of the `shiplog` project created by devallibus.
|
|
7
|
+
- **Original Project:** [devallibus/shiplog](https://github.com/devallibus/shiplog)
|
|
8
|
+
- **Original Author:** devallibus
|
|
9
|
+
- **License:** MIT License (Copyright (c) 2026 devallibus)
|
|
10
|
+
|
|
11
|
+
All enhancements, multi-model routing integration (Gemini & DeepSeek), and runtime architecture additions developed under LogNexus are maintained by Digital Lake and released under the MIT License.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Third-Party Components & Attributions
|
|
16
|
+
|
|
17
|
+
Portions of the commit, brainstorm, and PR workflows in LogNexus incorporate ideas and patterns from:
|
|
18
|
+
|
|
19
|
+
1. **OrchestKit**
|
|
20
|
+
- Repository: `https://github.com/yonatangross/orchestkit`
|
|
21
|
+
- Copyright (c) 2025 Yonatan Gross
|
|
22
|
+
- License: MIT (see `LICENSES/orchestkit-MIT.txt`)
|
|
23
|
+
|
|
24
|
+
2. **Superpowers**
|
|
25
|
+
- Repository: `https://github.com/obra/superpowers`
|
|
26
|
+
- Copyright (c) 2025 Jesse Vincent
|
|
27
|
+
- License: MIT (see `LICENSES/superpowers-MIT.txt`)
|
|
@@ -0,0 +1,432 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: lognexus-mcp
|
|
3
|
+
Version: 1.3.4
|
|
4
|
+
Summary: Universal Git-powered persistent memory, context rules & native MCP server for AI coding agents (Claude, OpenAI, Gemini, DeepSeek) across Linux, macOS, and Windows.
|
|
5
|
+
Author: Digital Lake
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/digital-lake-ai/lognexus#readme
|
|
8
|
+
Project-URL: Repository, https://github.com/digital-lake-ai/lognexus
|
|
9
|
+
Project-URL: Issues, https://github.com/digital-lake-ai/lognexus/issues
|
|
10
|
+
Project-URL: Changelog, https://github.com/digital-lake-ai/lognexus/blob/main/CHANGELOG.md
|
|
11
|
+
Keywords: mcp,mcp-server,model-context-protocol,git,git-notes,ai-agents,claude,cursor,gemini,deepseek,linux,macos,windows,cross-platform
|
|
12
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
13
|
+
Classifier: Environment :: Console
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Operating System :: MacOS
|
|
17
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
18
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
19
|
+
Classifier: Operating System :: OS Independent
|
|
20
|
+
Classifier: Programming Language :: Python :: 3
|
|
21
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
22
|
+
Classifier: Topic :: Software Development :: Version Control :: Git
|
|
23
|
+
Requires-Python: >=3.9
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
License-File: LICENSE
|
|
26
|
+
License-File: NOTICE.md
|
|
27
|
+
Dynamic: license-file
|
|
28
|
+
|
|
29
|
+
<p align="center">
|
|
30
|
+
<img src="docs/assets/logo.png" alt="LogNexus Logo" width="360">
|
|
31
|
+
</p>
|
|
32
|
+
|
|
33
|
+
# LogNexus
|
|
34
|
+
|
|
35
|
+
<p align="center">
|
|
36
|
+
<strong>The Universal, Git-Powered Context & Rules Framework for Native AI Agents</strong>
|
|
37
|
+
</p>
|
|
38
|
+
|
|
39
|
+
<div align="center">
|
|
40
|
+
|
|
41
|
+
[](https://github.com/digital-lake-ai/lognexus/actions/workflows/ci.yml)
|
|
42
|
+
[](https://www.npmjs.com/package/@digital-lake/lognexus)
|
|
43
|
+
[](https://www.npmjs.com/package/@digital-lake/lognexus)
|
|
44
|
+
[](https://glama.ai/mcp/servers/digital-lake-ai/lognexus)
|
|
45
|
+
[](https://github.com/digital-lake-ai)
|
|
46
|
+
[](https://ko-fi.com/digitallake)
|
|
47
|
+
|
|
48
|
+
[](https://www.npmjs.com/package/@digital-lake/lognexus)
|
|
49
|
+
[](https://socket.dev/npm/package/@digital-lake/lognexus)
|
|
50
|
+
[-0d9488)](https://glama.ai/mcp/servers/digital-lake-ai/lognexus)
|
|
51
|
+
[](https://github.com/digital-lake-ai/lognexus)
|
|
52
|
+
[](https://nodejs.org)
|
|
53
|
+
[](#installation--setup)
|
|
54
|
+
[](./docs/TELEMETRY_PRIVACY.md)
|
|
55
|
+
[](./LICENSE)
|
|
56
|
+
|
|
57
|
+
</div>
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## What is LogNexus?
|
|
62
|
+
|
|
63
|
+
As AI coding agents take on complex engineering tasks across different IDEs, they suffer from a fundamental failure mode: **cognitive amnesia**. Between conversation resets, context compactations, model handoffs, and unexpected bugs, the *why* behind design decisions, discarded alternatives, and technical discoveries vanishes.
|
|
64
|
+
|
|
65
|
+
**LogNexus transforms Git and GitHub into a persistent, traceable knowledge graph.** It is a **100% generic, model-agnostic and editor-agnostic framework** that operates directly inside your native AI development environments:
|
|
66
|
+
- **Clients:** Claude Code, Cursor, Codex, Google Antigravity, Kimi Code, VS Code, Zed.
|
|
67
|
+
- **Models:** Google Gemini (`Gemini 4 Argon`, `Gemini 4 Carbon`, `Gemini 3.8 Pro & Flash High`), Moonshot AI (`Kimi K3` / Kimi Code), DeepSeek (`R1`, `V3`, `Chat`), Anthropic Claude, OpenAI.
|
|
68
|
+
- **Supported Platforms:** **Linux**, **macOS**, and **Windows** (`linux`, `darwin`, `win32` — 100% cross-platform Node.js >= 20 & Git >= 2.28, zero native binary dependencies).
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
Issues (Why & Goals) ──▶ Branches (Task Scopes) ──▶ Commits (Context & Diffs) ──▶ PR (Timeline & Review)
|
|
72
|
+
▲ │
|
|
73
|
+
└─────────────────────── Git-Backed Knowledge Graph ──────────────────────────────┘
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
> **Framework, Not an API Proxy:** LogNexus never intercepts network calls or wraps vendor APIs. Your models remain inside their native IDEs with full access to editor buffers, interactive diff viewers, terminals, MCP servers, and local tools.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Key Features
|
|
81
|
+
|
|
82
|
+
- **Universal Multi-Model Support:** Native cognitive guidelines and prompt specifications for **Google Gemini** (`Gemini 4 Argon`, `Gemini 4 Carbon`, `Gemini 3.8 Pro & Flash High`), **Moonshot AI** (`Kimi K3` / Kimi Code), **DeepSeek** (`R1`, `V3`, `Chat`), **Anthropic Claude**, and **OpenAI**.
|
|
83
|
+
- **Universal Client Compatibility:** Drop-in support for **Claude Code**, **Cursor**, **Codex**, **Google Antigravity**, and **Kimi Code / VS Code**.
|
|
84
|
+
- **Atomic Commit Engine (`lognexus commit` & MCP `lognexus_commit`):** Validates subtask file contracts, verifies reviewer separation, injects authorship trailers, commits changes, marks subtasks completed, and attaches Git Notes in a single ~0.15s execution.
|
|
85
|
+
- **Cross-Model Review Gates:** Non-negotiable review separation (`Authored-by:` vs `Reviewed-by:`) enforced both at pre-flight note attachment time and during branch audits. No model merges its own code without independent verification from another model family.
|
|
86
|
+
- **Contract-First Subtasks & Alphanumeric Tickets:** Tasks are bounded by strict decision budgets, file allowlists, and stop conditions—supporting both GitHub issues (`feat(#42/T1)`) and Jira/Linear ticket schemes (`feat(SLM-201/T1)`).
|
|
87
|
+
- **Persistent State & Session Recovery:** Local session state engine (`.lognexus/state.json`) prevents amnesia across context compactations and conversation resets, retaining completed subtask metadata through the closing commit.
|
|
88
|
+
- **Automated Context Handoff (`lognexus handoff`):** Regenerates a complete `.lognexus/handoff.md` from local state — cycle state, active subtask contract, live scope-drift report, completed-subtask table and next required action — so a fresh session (or a different model) resumes without re-deriving context. Auto-refreshed on `state set-task` and on every `--finish-task` commit.
|
|
89
|
+
- **Live Scope-Drift Guard (`lognexus status` / `lognexus doctor`):** Diffs the working tree against the `allowedFiles` of the active contract on every status and diagnostic run, catching out-of-contract writes before they reach a commit.
|
|
90
|
+
- **Memory Recall Filter (`lognexus note search`):** Queries the LogNexus Git Notes history by file, model, issue or free text, returning the newest matches first — the reasoning behind a decision stays retrievable months later.
|
|
91
|
+
- **Startup Update & Legal Terms Gate:** A non-interactive gate surfaces update and legal-terms requirements at CLI startup, consulting the npm registry through `execFileSync` with `shell: false` and a 2500 ms timeout. The MCP transport is exempt.
|
|
92
|
+
- **Git Notes Engine (Quiet Mode / `git-ai` v3):** Attaches structured session payloads and contracts to commits under `refs/notes/lognexus` without changing commit SHAs.
|
|
93
|
+
- **Native MCP Stdio Server (`lognexus mcp`):** Zero-dependency JSON-RPC 2.0 stdio server exposing LogNexus tools, live state resources, and prompts to Claude Desktop, Cursor, and any MCP client.
|
|
94
|
+
- **Journey Timeline & Review Gate Audit:** Reconstructs the complete branch journey into structured PR descriptions (`lognexus timeline --pr-body`) and programmatically audits review gate separation (`lognexus audit`).
|
|
95
|
+
- **Hidden Metadata Envelopes:** HTML comments preserve machine-parseable state (`<!-- lognexus: kind: state ... -->`) without cluttering human-readable markdown.
|
|
96
|
+
- **Scaffolding & Health CLI (`@digital-lake/lognexus`):** Lightweight CLI for repository scaffolding (`init`), health diagnostics (`doctor`), and real-time status inspection (`status`).
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## Model-Tier Routing Matrix
|
|
101
|
+
|
|
102
|
+
LogNexus organizes development phases into three cognitive tiers. You can assign any model or native client to any tier according to your team's workflow and cost preferences:
|
|
103
|
+
|
|
104
|
+
<p align="center">
|
|
105
|
+
<img src="docs/assets/multimodel-routing-costs.png" alt="Multi-Model Routing Cost and Performance Analysis" width="85%">
|
|
106
|
+
</p>
|
|
107
|
+
|
|
108
|
+
### Operational Tiers
|
|
109
|
+
|
|
110
|
+
| Tier | Cognitive Role | Anthropic Claude | OpenAI | Google Gemini | DeepSeek | Primary Activities |
|
|
111
|
+
|---|---|---|---|---|---|---|
|
|
112
|
+
| **tier-1 (Reasoning)** | Deep synthesis, architectural design, narrative review | Claude Opus 3.7 / 4.x | o3, o1, GPT-5 | Gemini 2.5 / 3.8 Pro | DeepSeek R1 | Brainstorming-to-issue planning, PR journey timeline synthesis, cross-model review sign-offs. |
|
|
113
|
+
| **tier-2 (Context & Triage)** | Long context ingestion, discovery triage, structured mapping | Claude Sonnet | GPT-4.1, GPT-4o | Gemini Flash / Pro (1M context) | DeepSeek V3 | Large codebase exploration, discovery classification, knowledge retrieval. |
|
|
114
|
+
| **tier-3 (Execution)** | Surgical implementation, template filling, fast execution | Claude Haiku | GPT-4o-mini | Gemini Flash | DeepSeek Chat (V3) | Subtask commits (`feat(#N/Tk)`), atomic code changes under closed contracts, timeline logging. |
|
|
115
|
+
|
|
116
|
+
### Example Deployment Setups
|
|
117
|
+
|
|
118
|
+
LogNexus adapts to your existing toolstack. Configure your advisory preferences in `.lognexus/routing.md`:
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
┌────────────────────────────────────────────────────────────────────────────────────────┐
|
|
122
|
+
│ POPULAR DEPLOYMENT SETUPS │
|
|
123
|
+
├────────────────────────────────────────────────────────────────────────────────────────┤
|
|
124
|
+
│ Setup A (Anthropic Pure): Claude Opus (t1) + Claude Sonnet (t2) + Claude Haiku (t3) │
|
|
125
|
+
│ Setup B (Google + DeepSeek): Gemini Pro (t1/t2) in Antigravity + DeepSeek Chat in Kimi │
|
|
126
|
+
│ Setup C (OpenAI + DeepSeek): OpenAI o3 (t1) in Cursor + DeepSeek Chat (t3) for code │
|
|
127
|
+
│ Setup D (Claude + OpenAI): Claude Opus (t1) for design + GPT-4o-mini (t3) for tasks │
|
|
128
|
+
└────────────────────────────────────────────────────────────────────────────────────────┘
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## Quickstart & Golden Path
|
|
134
|
+
|
|
135
|
+
LogNexus coordinates the full issue-to-merge lifecycle through intuitive slash commands:
|
|
136
|
+
|
|
137
|
+
### 1. Capture the Plan
|
|
138
|
+
```bash
|
|
139
|
+
/lognexus plan
|
|
140
|
+
```
|
|
141
|
+
Transforms an exploratory brainstorm into a structured GitHub Issue with discrete subtasks (`T1..Tn`), verification criteria, and tier tags.
|
|
142
|
+
|
|
143
|
+
### 2. Start Work on a Clean Branch
|
|
144
|
+
```bash
|
|
145
|
+
/lognexus start <issue-number>
|
|
146
|
+
```
|
|
147
|
+
Creates an ID-prefixed branch (`issue/<id>-<slug>`) from the default branch tip and logs a signed `[lognexus/session-start]` note.
|
|
148
|
+
|
|
149
|
+
### 3. Commit with Traceability
|
|
150
|
+
```bash
|
|
151
|
+
/lognexus commit
|
|
152
|
+
```
|
|
153
|
+
Stages changes and generates structured, task-scoped commits (`feat(#42/T1): ...`) paired with an issue progress update.
|
|
154
|
+
|
|
155
|
+
### 4. Synthesize the Pull Request
|
|
156
|
+
```bash
|
|
157
|
+
/lognexus pr
|
|
158
|
+
```
|
|
159
|
+
Compiles all commits, discoveries, discarded alternatives, and verification steps into a comprehensive Journey Timeline inside the PR description.
|
|
160
|
+
|
|
161
|
+
### 5. Cross-Model Review & Gate Verification
|
|
162
|
+
```bash
|
|
163
|
+
/lognexus review
|
|
164
|
+
```
|
|
165
|
+
An independent model inspects the PR diff, verifies task contracts, and signs off (`Reviewed-by: <model>`) before merge.
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
## Installation & Setup
|
|
170
|
+
|
|
171
|
+
### 1. Scaffold Rules & Manage State with the CLI
|
|
172
|
+
|
|
173
|
+
Initialize `.lognexus/` rules, templates, and routing configuration:
|
|
174
|
+
```bash
|
|
175
|
+
npx @digital-lake/lognexus init
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Verify your environment anytime:
|
|
179
|
+
```bash
|
|
180
|
+
npx @digital-lake/lognexus doctor
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Inspect active branch and tier advisory:
|
|
184
|
+
```bash
|
|
185
|
+
npx @digital-lake/lognexus status
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
Manage persistent agent state (`.lognexus/state.json`) and session recovery:
|
|
189
|
+
```bash
|
|
190
|
+
npx @digital-lake/lognexus state sync
|
|
191
|
+
npx @digital-lake/lognexus state show
|
|
192
|
+
npx @digital-lake/lognexus state set-task T1 "Add user schema"
|
|
193
|
+
npx @digital-lake/lognexus state finish-task T1
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
Execute an **Atomic Commit** (validates subtask contract, enforces review-gate separation, injects trailers, commits, marks subtask completed, and attaches Git Note in a single ~0.15s call):
|
|
197
|
+
```bash
|
|
198
|
+
npx @digital-lake/lognexus commit -m "feat(#42/T1): add user schema" \
|
|
199
|
+
--author "gemini/flash (antigravity)" \
|
|
200
|
+
--reviewer "gemini/pro (lead-architect)" \
|
|
201
|
+
--finish-task
|
|
202
|
+
|
|
203
|
+
# Or read message from file (cross-platform on Linux, macOS, and Windows shells):
|
|
204
|
+
npx @digital-lake/lognexus commit -F commit-msg.txt --finish-task
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Quiet Mode with Git Notes (`refs/notes/lognexus`, standard `git-ai` v3):
|
|
208
|
+
```bash
|
|
209
|
+
npx @digital-lake/lognexus note attach HEAD
|
|
210
|
+
npx @digital-lake/lognexus note show HEAD
|
|
211
|
+
npx @digital-lake/lognexus note push origin
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
Journey Timeline reconstruction and Review Gate audit:
|
|
215
|
+
```bash
|
|
216
|
+
npx @digital-lake/lognexus timeline main
|
|
217
|
+
npx @digital-lake/lognexus timeline main --pr-body
|
|
218
|
+
npx @digital-lake/lognexus audit main
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
Session continuity, scope-drift and memory recall:
|
|
222
|
+
```bash
|
|
223
|
+
# Regenerate .lognexus/handoff.md from live state (--json for machines)
|
|
224
|
+
npx @digital-lake/lognexus handoff
|
|
225
|
+
npx @digital-lake/lognexus handoff --json
|
|
226
|
+
|
|
227
|
+
# Inspect the working tree against the active subtask contract
|
|
228
|
+
npx @digital-lake/lognexus status
|
|
229
|
+
npx @digital-lake/lognexus doctor
|
|
230
|
+
|
|
231
|
+
# Recall past reasoning from Git Notes, newest matches first
|
|
232
|
+
npx @digital-lake/lognexus note search "scope drift"
|
|
233
|
+
npx @digital-lake/lognexus note search --file src/cli.ts
|
|
234
|
+
npx @digital-lake/lognexus note search --issue 30 --limit 5
|
|
235
|
+
npx @digital-lake/lognexus note search --author "deepseek" --json
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
Opt-in Telemetry, Stack Profiling & ROI Cost-Savings Engine (100% local, zero network calls):
|
|
239
|
+
```bash
|
|
240
|
+
# Check telemetry status (disabled by default, 0% overhead)
|
|
241
|
+
npx @digital-lake/lognexus telemetry status
|
|
242
|
+
|
|
243
|
+
# Enable local telemetry (stores metrics only in .lognexus/telemetry.json)
|
|
244
|
+
npx @digital-lake/lognexus telemetry enable
|
|
245
|
+
|
|
246
|
+
# Generate .lognexus/telemetry.md report with ROI metrics
|
|
247
|
+
npx @digital-lake/lognexus telemetry report
|
|
248
|
+
|
|
249
|
+
# Inspect the exact local payload structure
|
|
250
|
+
npx @digital-lake/lognexus telemetry inspect
|
|
251
|
+
|
|
252
|
+
# Disable telemetry immediately
|
|
253
|
+
npx @digital-lake/lognexus telemetry disable
|
|
254
|
+
```
|
|
255
|
+
Telemetry is **strictly local-only**: no endpoint, no dispatch, no upload. The retired `--share --accept-terms` flags now fail with an explicit error, and pre-2.0.0 stores in `community` mode are migrated to `local` on read.
|
|
256
|
+
|
|
257
|
+
*Read our strict Zero-PII, zero-network policy in [`docs/TELEMETRY_PRIVACY.md`](docs/TELEMETRY_PRIVACY.md).*
|
|
258
|
+
|
|
259
|
+
### 2. Connect via Model Context Protocol (MCP)
|
|
260
|
+
|
|
261
|
+
LogNexus includes a native, lightweight JSON-RPC 2.0 stdio server (`lognexus mcp`) with zero external SDK dependencies. Connect it to Claude Desktop, Cursor, Google Antigravity, or any MCP-compliant client:
|
|
262
|
+
|
|
263
|
+
**`claude_desktop_config.json` or Cursor MCP settings** — config file locations per operating system:
|
|
264
|
+
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
265
|
+
- **Linux:** `~/.config/Claude/claude_desktop_config.json`
|
|
266
|
+
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
267
|
+
- **Cursor / VS Code:** `.cursor/mcp.json` or `.vscode/mcp.json`
|
|
268
|
+
|
|
269
|
+
```json
|
|
270
|
+
{
|
|
271
|
+
"mcpServers": {
|
|
272
|
+
"lognexus": {
|
|
273
|
+
"command": "npx",
|
|
274
|
+
"args": ["-y", "@digital-lake/lognexus", "mcp"]
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
**Or install automatically via Smithery:**
|
|
281
|
+
```bash
|
|
282
|
+
npx -y @smithery/cli install @digital-lake/lognexus --client claude
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
**Or run via Python (`uvx` / `pip` from PyPI):**
|
|
286
|
+
```bash
|
|
287
|
+
# Zero-install MCP stdio launch via uvx:
|
|
288
|
+
uvx lognexus-mcp
|
|
289
|
+
|
|
290
|
+
# Or install globally via pip / pipx:
|
|
291
|
+
pip install lognexus-mcp
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
**Exposed Capabilities:**
|
|
295
|
+
- **Tools:** `lognexus_status`, `lognexus_state_get`, `lognexus_state_sync`, `lognexus_state_set_task`, `lognexus_state_finish_task`, `lognexus_state_clear`, `lognexus_commit`, `lognexus_note_show`, `lognexus_note_attach`, `lognexus_timeline`, `lognexus_audit`, `lognexus_telemetry`
|
|
296
|
+
- **Resources:** `lognexus://state`, `lognexus://routing`
|
|
297
|
+
- **Prompts:** `lognexus-plan`, `lognexus-review`
|
|
298
|
+
|
|
299
|
+
### 3. Install Rules in Your Agent Environment
|
|
300
|
+
|
|
301
|
+
- **Claude Code:**
|
|
302
|
+
```bash
|
|
303
|
+
claude plugin add digital-lake-ai/lognexus
|
|
304
|
+
```
|
|
305
|
+
- **Cursor / Codex / Agent Skills:**
|
|
306
|
+
```bash
|
|
307
|
+
npx skills add digital-lake-ai/lognexus
|
|
308
|
+
```
|
|
309
|
+
- **Google Antigravity:** Active automatically via `skills/lognexus/SKILL.md` or workspace skills.
|
|
310
|
+
- **Kimi Code / VS Code:** Active via `.lognexus/` workspace instructions and prompts.
|
|
311
|
+
|
|
312
|
+
---
|
|
313
|
+
|
|
314
|
+
## ⚡ Production Telemetry & Field Benchmark
|
|
315
|
+
|
|
316
|
+
<div align="center">
|
|
317
|
+
|
|
318
|
+
|
|
319
|
+
-238636?style=for-the-badge&labelColor=0d1117)
|
|
320
|
+
|
|
321
|
+
-238636?style=for-the-badge&labelColor=0d1117)
|
|
322
|
+
|
|
323
|
+
</div>
|
|
324
|
+
|
|
325
|
+
LogNexus was battle-tested in a high-intensity production deployment governing the end-to-end engineering of **Taranis**—a deterministic static analysis CLI and AI migration skill operating over **250,000+ lines of legacy code** with 22 AST/CFG rules (`SPH-001`..`SPH-022`).
|
|
326
|
+
|
|
327
|
+
```
|
|
328
|
+
╔══════════════════════════════════════════════════════════════════════════════════════════════╗
|
|
329
|
+
║ LOGNEXUS TELEMETRY HUD // PRODUCTION SWARM BENCHMARK (CASE STUDY: TARANIS) ║
|
|
330
|
+
╠═════════════════════════════════════════════╦════════════════════════════════════════════════╣
|
|
331
|
+
║ ▸ GOVERNED FEATURES 12 Issues (#1-#12) ║ ▸ ORPHAN / UNTRACKED COMMITS 0 (0.0%) ║
|
|
332
|
+
║ ▸ VERIFIED COMMITS 38 / 38 Signed ║ ▸ SELF-APPROVAL VIOLATIONS 0 Blocked ║
|
|
333
|
+
║ ▸ GIT NOTES ATTACHED 100% (git-ai v3) ║ ▸ SCOPE CREEP INCIDENTS 0 (Allowlist) ║
|
|
334
|
+
║ ▸ TEST SUITE INTEGRITY 536 Passed (100%) ║ ▸ ATOMIC COMMIT LATENCY ~0.15s / op ║
|
|
335
|
+
╚═════════════════════════════════════════════╩════════════════════════════════════════════════╝
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
### Multi-Model Swarm Performance Matrix
|
|
339
|
+
|
|
340
|
+
By enforcing **Closed Delegation Contracts** (`allowedFiles`, `forbiddenFiles`, `decisionBudget: "none"`) and **Cross-Model Review Gates**, LogNexus coordinated three distinct AI model families in production without a single context leak or rogue commit:
|
|
341
|
+
|
|
342
|
+
| Model Family | Assigned Tier | Production Strengths Observed | Optimal Contract Fit |
|
|
343
|
+
| :--- | :---: | :--- | :--- |
|
|
344
|
+
| **Google Antigravity / Gemini Pro** | `tier-1` & `tier-2`<br>*(Architect & Orchestrator)* | • Zero-drift multi-branch coordination<br>• Strict review-gate enforcement (`lognexus audit`)<br>• Rapid root-cause regression triage | Architecture synthesis, closed contract authoring, cross-model code review, release governance. |
|
|
345
|
+
| **DeepSeek V3 / R1** | `tier-3`<br>*(Scoped Implementer)* | • Ultra-low latency & token cost<br>• Exceptional at mathematical AST parsing, pushdown automata & CFG tokenization<br>• Strict adherence to stop conditions when hitting out-of-scope test assertions | Algorithmic engines, deterministic parsers, isolated single-file modules (`<500` LOC). |
|
|
346
|
+
| **Kimi K2.7 Code** | `tier-2` & `tier-3`<br>*(High-Context Implementer)* | • Massive context retention with zero file truncation on large modules (`>500` LOC)<br>• Flawless single-shot multi-file generation (rule catalogs + visitors + test suites) | Large-context refactorings, multi-file rule catalogs, CI/CD matrices & standalone packaging. |
|
|
347
|
+
|
|
348
|
+
> **Key Takeaway:** Contract-driven development paired with `refs/notes/lognexus` completely eliminated scope creep by Tier-3 implementers while keeping the public Git commit graph 100% clean and human-readable.
|
|
349
|
+
|
|
350
|
+
---
|
|
351
|
+
|
|
352
|
+
## Disambiguation
|
|
353
|
+
|
|
354
|
+
**LogNexus** by Digital Lake is an open-source development framework and Git memory system for AI agents. It is not affiliated with academic research papers on industrial log compression (e.g. ISSTA 2026).
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
## 🛡️ Verified Quality & Supply-Chain Security
|
|
359
|
+
|
|
360
|
+
<div align="center">
|
|
361
|
+
|
|
362
|
+
[](https://glama.ai/mcp/servers/digital-lake-ai/lognexus)
|
|
363
|
+
|
|
364
|
+
</div>
|
|
365
|
+
|
|
366
|
+
Every published release is continuously measured against independent third-party evaluators. The table below summarises the current external audit snapshot:
|
|
367
|
+
|
|
368
|
+
| Auditor | Scope | Result |
|
|
369
|
+
|---|---|---|
|
|
370
|
+
| **Glama MCP Directory** | Server quality & maintenance score (TDQS) | **Triple A** grading · **TDQS 4.3 / 5.0** (`Grade A`) |
|
|
371
|
+
| **Socket Security** | Vulnerability audit | **100 / 100** — `0 CVEs` |
|
|
372
|
+
| **Socket Security** | Quality & License compliance | **100 / 100** |
|
|
373
|
+
| **Socket Security** | Maintenance health | **96 / 100** |
|
|
374
|
+
| **SLSA Provenance** | Build supply chain | **Verified** (`SLSA Provenance`, OIDC-signed npm publish) |
|
|
375
|
+
| **License & Contribution model** | Open governance | **MIT** — Open Source, Core-Maintained (**Closed to Unsolicited External PRs**) |
|
|
376
|
+
| **Awesome MCP Servers** | Community MCP directory ([`punkpeye/awesome-mcp-servers`](https://github.com/punkpeye/awesome-mcp-servers) / [`HorchataHTML/awesome-mcp-servers`](https://github.com/HorchataHTML/awesome-mcp-servers)) | Listed under *Version Control* (`📇 🏠 🍎 🪟 🐧` — TypeScript, Local, **macOS**, **Windows**, **Linux**) |
|
|
377
|
+
| **Smithery & Claude Plugin** | Native MCP & Plugin registries (`smithery.yaml`, `.claude-plugin/plugin.json`, `skills/lognexus/SKILL.md`) | Verified Cross-Platform (`Linux`, `macOS`, `Windows`) |
|
|
378
|
+
| **MCP Registry & PyPI** | Official `server.json` & Python launcher (`lognexus-mcp`) | Verified (`io.github.digital-lake-ai/lognexus` · `npx` & `uvx` across **Linux**, **macOS**, **Windows**) |
|
|
379
|
+
|
|
380
|
+
> **Local-first by construction:** LogNexus ships `0` runtime network calls, `0` PII, and `0` telemetry endpoints. See [`docs/TELEMETRY_PRIVACY.md`](docs/TELEMETRY_PRIVACY.md) and [`SECURITY.md`](SECURITY.md).
|
|
381
|
+
|
|
382
|
+
### Provenance & Identities
|
|
383
|
+
|
|
384
|
+
Every commit carries signed provenance trailers (`Planned-by:` / `Authored-by:` / `Reviewed-by:`). Identities are declared with their canonical spellings:
|
|
385
|
+
|
|
386
|
+
| Role | Canonical identity |
|
|
387
|
+
|---|---|
|
|
388
|
+
| Master Architecture & Security Orchestrator | `Gemini 4 Argon` |
|
|
389
|
+
| Implementation (VS Code client) | `deepseek/VS Code (kimi-code)` |
|
|
390
|
+
| Cross-model review (Antigravity) | `google/gemini-3.8-flash-high (antigravity)` |
|
|
391
|
+
|
|
392
|
+
The `Planned-by:` trailer documents where an externally authored plan came from. It grants no review authority and no merge rights; an author model never writes its own `Reviewed-by:` trailer.
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## Based on & Acknowledgments
|
|
397
|
+
|
|
398
|
+
LogNexus is an independent hard fork and continuation of [`shiplog`](https://github.com/devallibus/shiplog), originally created by **devallibus** under the MIT License.
|
|
399
|
+
|
|
400
|
+
We extend our deep gratitude to **devallibus** for pioneering the concept of Git-as-knowledge-graph for AI development. LogNexus builds upon that foundation by:
|
|
401
|
+
- Expanding the model ecosystem to provide first-class native support for **Google Gemini** (`Gemini 4 Argon`, `Gemini 4 Carbon`, `Gemini 3.8 Pro & Flash High`), **Moonshot AI** (`Kimi K3` / Kimi Code), and **DeepSeek** (`R1`, `V3`, `Chat`) alongside **Claude** and **OpenAI**.
|
|
402
|
+
- Formalizing the multi-model tier routing taxonomy and closed delegation contracts.
|
|
403
|
+
- Introducing the repository scaffolding CLI, Atomic Commit Engine, and native MCP server (`@digital-lake/lognexus`).
|
|
404
|
+
- Providing seamless backwards-compatibility for existing `.shiplog` envelopes and workflows.
|
|
405
|
+
|
|
406
|
+
The **Master Architecture & Security Plan** governing frontier-model support, supply-chain hardening, and cross-model review governance is authored and signed by **`Gemini 4 Argon`** (*Master Architecture & Security Orchestrator*).
|
|
407
|
+
|
|
408
|
+
Additional inspirations and patterns are derived from [OrchestKit](https://github.com/yonatangross/orchestkit) and [Superpowers](https://github.com/obra/superpowers). Detailed license texts are preserved in the [`LICENSES/`](LICENSES/) directory and in [`NOTICE.md`](NOTICE.md).
|
|
409
|
+
|
|
410
|
+
---
|
|
411
|
+
|
|
412
|
+
<div align="center">
|
|
413
|
+
|
|
414
|
+
### Did you find this project useful? 🤖⚡
|
|
415
|
+
|
|
416
|
+
Maintaining and evolving open-source agentic infrastructure takes time, dedication, and... quite a few **AI tokens** to power multi-model benchmarking, automated testing, and continuous architecture updates.
|
|
417
|
+
|
|
418
|
+
If **LogNexus** saved you time, prevented context amnesia in your workflows, and you'd like to help cover the API and compute costs to keep it evolving, consider fueling the AI with a token:
|
|
419
|
+
|
|
420
|
+
[](https://ko-fi.com/digitallake)
|
|
421
|
+
|
|
422
|
+
*Every contribution goes straight into compute power, multi-model benchmarks, new MCP capabilities, and continuous improvements!*
|
|
423
|
+
|
|
424
|
+
</div>
|
|
425
|
+
|
|
426
|
+
---
|
|
427
|
+
|
|
428
|
+
## License
|
|
429
|
+
|
|
430
|
+
LogNexus is released under the [MIT License](LICENSE).
|
|
431
|
+
Copyright (c) 2026 devallibus
|
|
432
|
+
Copyright (c) 2026 Digital Lake and LogNexus contributors.
|