@digital-lake/lognexus 1.3.7 → 1.4.1
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/LICENSE +2 -2
- package/NOTICE.md +2 -2
- package/README.md +72 -47
- package/dist/audit/audit.d.ts +37 -2
- package/dist/audit/audit.d.ts.map +1 -1
- package/dist/audit/audit.js +540 -57
- package/dist/audit/audit.js.map +1 -1
- package/dist/cli.d.ts +9 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +342 -34
- package/dist/cli.js.map +1 -1
- package/dist/commit.d.ts +6 -0
- package/dist/commit.d.ts.map +1 -1
- package/dist/commit.js +61 -23
- package/dist/commit.js.map +1 -1
- package/dist/doctor.d.ts +1 -0
- package/dist/doctor.d.ts.map +1 -1
- package/dist/doctor.js +31 -8
- package/dist/doctor.js.map +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/prompts.d.ts.map +1 -1
- package/dist/mcp/prompts.js +14 -10
- package/dist/mcp/prompts.js.map +1 -1
- package/dist/notes/attach.d.ts +11 -0
- package/dist/notes/attach.d.ts.map +1 -1
- package/dist/notes/attach.js +22 -5
- package/dist/notes/attach.js.map +1 -1
- package/dist/routing/profile.d.ts +44 -0
- package/dist/routing/profile.d.ts.map +1 -0
- package/dist/routing/profile.js +261 -0
- package/dist/routing/profile.js.map +1 -0
- package/dist/scaffold.d.ts +3 -3
- package/dist/scaffold.d.ts.map +1 -1
- package/dist/scaffold.js +31 -19
- package/dist/scaffold.js.map +1 -1
- package/dist/state/handoff.d.ts +18 -0
- package/dist/state/handoff.d.ts.map +1 -1
- package/dist/state/handoff.js +60 -10
- package/dist/state/handoff.js.map +1 -1
- package/dist/state/manager.d.ts.map +1 -1
- package/dist/state/manager.js +60 -1
- package/dist/state/manager.js.map +1 -1
- package/dist/state/schema.d.ts +38 -0
- package/dist/state/schema.d.ts.map +1 -1
- package/dist/state/schema.js +9 -0
- package/dist/state/schema.js.map +1 -1
- package/dist/status.d.ts +10 -0
- package/dist/status.d.ts.map +1 -1
- package/dist/status.js +171 -42
- package/dist/status.js.map +1 -1
- package/dist/telemetry/benchmark.d.ts +51 -0
- package/dist/telemetry/benchmark.d.ts.map +1 -0
- package/dist/telemetry/benchmark.js +541 -0
- package/dist/telemetry/benchmark.js.map +1 -0
- package/dist/telemetry/collector.d.ts +109 -3
- package/dist/telemetry/collector.d.ts.map +1 -1
- package/dist/telemetry/collector.js +737 -178
- package/dist/telemetry/collector.js.map +1 -1
- package/dist/telemetry/consent-prompt.d.ts +35 -0
- package/dist/telemetry/consent-prompt.d.ts.map +1 -0
- package/dist/telemetry/consent-prompt.js +215 -0
- package/dist/telemetry/consent-prompt.js.map +1 -0
- package/dist/telemetry/detector.d.ts +16 -1
- package/dist/telemetry/detector.d.ts.map +1 -1
- package/dist/telemetry/detector.js +362 -38
- package/dist/telemetry/detector.js.map +1 -1
- package/dist/telemetry/index.d.ts +5 -4
- package/dist/telemetry/index.d.ts.map +1 -1
- package/dist/telemetry/index.js +5 -4
- package/dist/telemetry/index.js.map +1 -1
- package/dist/telemetry/report.d.ts +3 -2
- package/dist/telemetry/report.d.ts.map +1 -1
- package/dist/telemetry/report.js +66 -14
- package/dist/telemetry/report.js.map +1 -1
- package/dist/telemetry/schema.d.ts +305 -2
- package/dist/telemetry/schema.d.ts.map +1 -1
- package/dist/telemetry/schema.js +142 -4
- package/dist/telemetry/schema.js.map +1 -1
- package/dist/update/gate.d.ts +1 -1
- package/dist/update/gate.d.ts.map +1 -1
- package/dist/update/gate.js +2 -0
- package/dist/update/gate.js.map +1 -1
- package/package.json +2 -2
- package/server.json +3 -3
package/LICENSE
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
MIT License
|
|
2
2
|
|
|
3
|
-
Copyright (c) 2026 HorchataHTML (https://github.com/
|
|
4
|
-
Copyright (c) 2026 Digital Lake and LogNexus contributors
|
|
3
|
+
Copyright (c) 2026 HorchataHTML (https://github.com/HorchataHTML)
|
|
4
|
+
Copyright (c) 2026 Digital Lake (https://github.com/digital-lake-ai) and LogNexus contributors
|
|
5
5
|
Copyright (c) 2026 devallibus
|
|
6
6
|
|
|
7
7
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
package/NOTICE.md
CHANGED
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
## Lead Author & Core Architecture
|
|
4
4
|
|
|
5
|
-
Copyright (c) 2026 [HorchataHTML](https://github.com/
|
|
5
|
+
Copyright (c) 2026 [HorchataHTML](https://github.com/HorchataHTML)
|
|
6
6
|
Copyright (c) 2026 [Digital Lake](https://github.com/digital-lake-ai) and LogNexus contributors.
|
|
7
7
|
|
|
8
|
-
**LogNexus** is designed, engineered, and maintained by **[HorchataHTML](https://github.com/
|
|
8
|
+
**LogNexus** is designed, engineered, and maintained by **[HorchataHTML](https://github.com/HorchataHTML)** and **[Digital Lake](https://github.com/digital-lake-ai)** under the MIT License, including:
|
|
9
9
|
|
|
10
10
|
- **Core Runtime & Tooling:** Full TypeScript architecture, repository scaffolding and health diagnostics CLI (`lognexus init`, `doctor`, `status`), Persistent Agent State Engine (`.lognexus/state.json`), Automated Context Handoff (`lognexus handoff`), and optional Multi-Model Token Shield (`init --protect-tokens`).
|
|
11
11
|
- **Traceability, FinOps & Native MCP Server:** Atomic Commit Engine (`lognexus commit`), Git Notes memory graph (`refs/notes/lognexus` / `git-ai` v3), local-first FinOps telemetry & ROI cost-savings engine, and zero-dependency JSON-RPC 2.0 stdio MCP server (`@digital-lake/lognexus` on npm / `lognexus-mcp` on PyPI).
|
package/README.md
CHANGED
|
@@ -35,8 +35,8 @@
|
|
|
35
35
|
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.
|
|
36
36
|
|
|
37
37
|
**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:
|
|
38
|
-
- **Clients:** Claude Code, Cursor, Codex, Google Antigravity, Kimi Code, VS Code, Zed.
|
|
39
|
-
- **Models:** Google Gemini (`Gemini 4
|
|
38
|
+
- **Clients:** Claude Code, Cursor, Codex, GitHub Copilot, Google Antigravity, Kimi Code, VS Code, Zed.
|
|
39
|
+
- **Models:** Anthropic Claude (`Claude Fable 5.2`, `Claude Mythos 5.2`, `Claude Opus / Sonnet / Haiku 5.5`), OpenAI (`GPT-6.2 Astra`, `GPT-6.2 Sol`, `GPT-6 Luna`, `codex-mini`, `o3` / `o4`), Google Gemini (`Gemini 4 Neon`, `Gemini 4 Carbon`, `Gemini 4 Argon`, `Gemini 4 Hydrogen`, `Gemini 3.8 Pro & Flash`), Moonshot AI (`Kimi K3` / Kimi Code), DeepSeek (`R1`, `V3`, `Chat`).
|
|
40
40
|
- **Supported Platforms:** **Linux**, **macOS**, and **Windows** (`linux`, `darwin`, `win32` — 100% cross-platform Node.js >= 20 & Git >= 2.28, zero native binary dependencies).
|
|
41
41
|
|
|
42
42
|
```
|
|
@@ -51,10 +51,11 @@ Issues (Why & Goals) ──▶ Branches (Task Scopes) ──▶ Commits (Context
|
|
|
51
51
|
|
|
52
52
|
## Key Features
|
|
53
53
|
|
|
54
|
-
- **Universal Multi-Model Support:** Native cognitive guidelines and prompt specifications for **Google Gemini** (`Gemini 4
|
|
55
|
-
- **Universal Client Compatibility:** Drop-in support for **Claude Code**, **Cursor**, **Codex**, **Google Antigravity**, and **Kimi Code / VS Code**.
|
|
54
|
+
- **Universal Multi-Model Support:** Native cognitive guidelines and prompt specifications for **Anthropic Claude** (`Claude Fable 5.2`, `Claude Mythos 5.2`, `Claude 5.5`), **OpenAI** (`GPT-6.2 Astra`, `GPT-6.2 Sol`, `GPT-6 Luna`, `codex-mini`, `o3` / `o4`), **Google Gemini** (`Gemini 4 Neon` / `Orchestrator (Neon)`, `Gemini 4 Carbon`, `Gemini 4 Argon`, `Gemini 4 Hydrogen`, `Gemini 3.8 Pro & Flash`), **Moonshot AI** (`Kimi K3` / Kimi Code), and **DeepSeek** (`R1`, `V3`, `Chat`).
|
|
55
|
+
- **Universal Client Compatibility:** Drop-in support for **Claude Code**, **Cursor**, **Codex**, **GitHub Copilot** (`.github/copilot-instructions.md`), **Google Antigravity**, and **Kimi Code / VS Code**.
|
|
56
|
+
- **Adaptive Ecosystem Routing & Native Swarm Coordination:** Declarative `.lognexus/routing.md` (`orchestration: auto | swarm | subagent | off`, `review_gate: auto | intra-fleet | cross-vendor | advisory | off`, `implementer: auto`, `reviewer: auto`) with Hard Turn-1 Discovery Probes (`> 3` files), immediate Swarm UI handoff, and native Swarm contract flags (`--assignee`, `--isolation swarm`, `--swarm-workers`, `--swarm-posts`).
|
|
56
57
|
- **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.
|
|
57
|
-
- **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.
|
|
58
|
+
- **Cross-Model & Intra-Fleet Distinct-Model Review Gates:** Non-negotiable review separation (`Authored-by:` vs `Reviewed-by:`) enforced both at pre-flight note attachment time and during branch audits. Supports cross-vendor review, intra-fleet distinct-model review (`Neon`/`Carbon`/`Argon` reviewing `Hydrogen`/`Flash`; `GPT-6.2 Astra` reviewing `Sol`/`Luna`; `Fable`/`Opus` reviewing `Sonnet`), shared-weights blocking (`Fable <-> Mythos`), and `advisory` / `off` modes for single-session ChatGPT or solo workflows—never forcing cross-vendor review—with strict anti-spoofing and mandatory `--no-ff` merges.
|
|
58
59
|
- **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)`).
|
|
59
60
|
- **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.
|
|
60
61
|
- **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.
|
|
@@ -66,7 +67,7 @@ Issues (Why & Goals) ──▶ Branches (Task Scopes) ──▶ Commits (Context
|
|
|
66
67
|
- **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`).
|
|
67
68
|
- **Hidden Metadata Envelopes:** HTML comments preserve machine-parseable state (`<!-- lognexus: kind: state ... -->`) without cluttering human-readable markdown.
|
|
68
69
|
- **Scaffolding & Health CLI (`@digital-lake/lognexus`):** Lightweight CLI for repository scaffolding (`init`), health diagnostics (`doctor`), and real-time status inspection (`status`).
|
|
69
|
-
- **Optional Multi-Model Token Shield (`init --protect-tokens`):** Opt-in, zero-runtime-overhead workspace hygiene flag that scaffolds official context-exclusion and read-deny rules (`.geminiignore`, `.aiexclude`, `.cursorignore`, `.claude/settings.json
|
|
70
|
+
- **Optional Multi-Model Token Shield (`init --protect-tokens`):** Opt-in, zero-runtime-overhead workspace hygiene flag that scaffolds official context-exclusion and read-deny rules (`.geminiignore`, `.aiexclude`, `.cursorignore`, `.claude/settings.json` covering `node_modules/**`, lockfiles, `dist/**`, `dist-pypi/**`, `.next/**`, `.venv/**`, `__pycache__/**`, `.rooignore`, `.codeiumignore`, `.aiderignore`) tailored to the agent ecosystems detected in your repository—preventing accidental token leakage on lockfiles and build artifacts, translating directly into lower context costs without touching the MCP server.
|
|
70
71
|
|
|
71
72
|
---
|
|
72
73
|
|
|
@@ -82,23 +83,34 @@ LogNexus organizes development phases into three cognitive tiers. You can assign
|
|
|
82
83
|
|
|
83
84
|
| Tier | Cognitive Role | Anthropic Claude | OpenAI | Google Gemini | DeepSeek | Primary Activities |
|
|
84
85
|
|---|---|---|---|---|---|---|
|
|
85
|
-
| **tier-1 (Reasoning)** | Deep synthesis, architectural design, narrative review | Claude
|
|
86
|
-
| **tier-2 (Context & Triage)** | Long context ingestion, discovery triage, structured mapping | Claude Sonnet | GPT-
|
|
87
|
-
| **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. |
|
|
86
|
+
| **tier-1 (Reasoning)** | Deep synthesis, architectural design, narrative review | Claude Fable 5.2 / Mythos 5.2 / Opus 5.5 | GPT-6.2 Astra, o3, o4, GPT-5 | Gemini 4 Neon / Carbon / Argon, 3.8 Pro | DeepSeek R1 | Brainstorming-to-issue planning, PR journey timeline synthesis, cross-model & intra-fleet review sign-offs. |
|
|
87
|
+
| **tier-2 (Context & Triage)** | Long context ingestion, discovery triage, structured mapping | Claude Sonnet 5.5 | GPT-6.2 Sol, Codex, gpt-oss, GPT-4o | Gemini 4 Hydrogen, Gemini 3.8 Flash High / Pro (1M) | DeepSeek V3 | Large codebase exploration, discovery classification, scoped implementation, knowledge retrieval. |
|
|
88
|
+
| **tier-3 (Execution)** | Surgical implementation, template filling, fast execution | Claude Haiku 5.5 | GPT-6 Luna, codex-mini, o4-mini, GPT-4o-mini | Gemini 3.8 Flash, `gemini-flash-worker-agy` | DeepSeek Chat (V3) | Subtask commits (`feat(#N/Tk)`), atomic code changes under closed contracts, timeline logging. |
|
|
88
89
|
|
|
89
|
-
###
|
|
90
|
+
### Adaptive Routing & Deployment Setups
|
|
90
91
|
|
|
91
|
-
LogNexus adapts to
|
|
92
|
+
LogNexus adapts automatically to single-provider and multi-vendor toolstacks. Configure `.lognexus/routing.md` with linear `O(n)` directives:
|
|
92
93
|
|
|
94
|
+
```markdown
|
|
95
|
+
routing: confirm
|
|
96
|
+
orchestration: auto
|
|
97
|
+
review_gate: auto
|
|
98
|
+
implementer: auto
|
|
99
|
+
reviewer: auto
|
|
93
100
|
```
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
│
|
|
101
|
-
|
|
101
|
+
|
|
102
|
+
- `orchestration`: `auto | swarm | subagent | off` (`auto` activates native `swarm` under Antigravity `Orchestrator` after plan confirmation).
|
|
103
|
+
- `review_gate`: `auto | cross-vendor | intra-fleet | advisory | off` (`auto` resolves to `intra-fleet` distinct-model verification when running in a single-provider fleet; ChatGPT / OpenAI Codex workflows never force cross-vendor review, and single-session solo workflows may use `advisory` or `off`).
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
┌──────────────────────────────────────────────────────────────────────────────────────────┐
|
|
107
|
+
│ POPULAR DEPLOYMENT SETUPS │
|
|
108
|
+
├──────────────────────────────────────────────────────────────────────────────────────────┤
|
|
109
|
+
│ Setup A (Claude Code): Claude Fable 5.2 / Opus 5.5 (t1) + Sonnet (t2) + Haiku (t3) │
|
|
110
|
+
│ Setup B (Antigravity Fleet): Gemini 4 Neon/Carbon/Argon (t1) + Hydrogen/Flash (t2/t3) │
|
|
111
|
+
│ Setup C (ChatGPT / Codex): GPT-6.2 Astra (t1) + GPT-6.2 Sol (t2) + GPT-6 Luna (t3) │
|
|
112
|
+
│ Setup D (Cross-Vendor): Claude Fable 5.2 / Opus (t1) + GPT-6 Luna / DeepSeek (t3) │
|
|
113
|
+
└──────────────────────────────────────────────────────────────────────────────────────────┘
|
|
102
114
|
```
|
|
103
115
|
|
|
104
116
|
---
|
|
@@ -150,40 +162,49 @@ npx @digital-lake/lognexus init
|
|
|
150
162
|
# Optional: scaffold official multi-model context-exclusion rules (zero runtime overhead)
|
|
151
163
|
# to prevent agents from burning tokens on lockfiles or build directories:
|
|
152
164
|
npx @digital-lake/lognexus init --protect-tokens
|
|
165
|
+
|
|
166
|
+
# Optional: pre-seal local telemetry consent in an interactive human terminal
|
|
167
|
+
npx @digital-lake/lognexus init --enable-telemetry
|
|
168
|
+
npx @digital-lake/lognexus init --no-telemetry
|
|
153
169
|
```
|
|
154
170
|
|
|
155
|
-
Verify your environment anytime:
|
|
171
|
+
Verify your environment anytime (including multi-manifest SemVer drift checks):
|
|
156
172
|
```bash
|
|
157
173
|
npx @digital-lake/lognexus doctor
|
|
158
174
|
```
|
|
159
175
|
|
|
160
|
-
Inspect active branch and tier advisory:
|
|
176
|
+
Inspect active branch, ecosystem profile, review gate mode, and tier advisory:
|
|
161
177
|
```bash
|
|
162
178
|
npx @digital-lake/lognexus status
|
|
163
179
|
```
|
|
164
180
|
|
|
165
|
-
Manage persistent agent state (`.lognexus/state.json`) and session recovery:
|
|
181
|
+
Manage persistent agent state (`.lognexus/state.json`), native swarm contracts, and session recovery:
|
|
166
182
|
```bash
|
|
167
183
|
npx @digital-lake/lognexus state sync
|
|
168
184
|
npx @digital-lake/lognexus state show
|
|
169
|
-
npx @digital-lake/lognexus state set-task T1 "Add user schema"
|
|
185
|
+
npx @digital-lake/lognexus state set-task T1 "Add user schema" \
|
|
186
|
+
--assignee "google/gemini-4-hydrogen-high (antigravity)" \
|
|
187
|
+
--isolation swarm --swarm-workers 2 --swarm-posts 4 \
|
|
188
|
+
--allowed "src/schema.ts,tests/schema.test.ts" \
|
|
189
|
+
--verify "npm test"
|
|
170
190
|
npx @digital-lake/lognexus state finish-task T1
|
|
171
191
|
```
|
|
172
192
|
|
|
173
193
|
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):
|
|
174
194
|
```bash
|
|
175
195
|
npx @digital-lake/lognexus commit -m "feat(#42/T1): add user schema" \
|
|
176
|
-
--author "gemini
|
|
177
|
-
--
|
|
196
|
+
--author "google/gemini-4-hydrogen-high (antigravity)" \
|
|
197
|
+
--stage-allowed \
|
|
198
|
+
--swarm-workers 2 --swarm-posts 4 \
|
|
178
199
|
--finish-task
|
|
179
200
|
|
|
180
201
|
# Or read message from file (cross-platform on Linux, macOS, and Windows shells):
|
|
181
|
-
npx @digital-lake/lognexus commit -F commit-msg.txt --finish-task
|
|
202
|
+
npx @digital-lake/lognexus commit -F commit-msg.txt --stage-allowed --finish-task
|
|
182
203
|
```
|
|
183
204
|
|
|
184
205
|
Quiet Mode with Git Notes (`refs/notes/lognexus`, standard `git-ai` v3):
|
|
185
206
|
```bash
|
|
186
|
-
npx @digital-lake/lognexus note attach HEAD
|
|
207
|
+
npx @digital-lake/lognexus note attach HEAD --swarm-workers 2 --swarm-posts 4
|
|
187
208
|
npx @digital-lake/lognexus note show HEAD
|
|
188
209
|
npx @digital-lake/lognexus note push origin
|
|
189
210
|
```
|
|
@@ -197,8 +218,9 @@ npx @digital-lake/lognexus audit main
|
|
|
197
218
|
|
|
198
219
|
Session continuity, scope-drift and memory recall:
|
|
199
220
|
```bash
|
|
200
|
-
# Regenerate .lognexus/handoff.md from live state (--json for
|
|
221
|
+
# Regenerate .lognexus/handoff.md from live state (--json or --prompt for compact agent dispatch)
|
|
201
222
|
npx @digital-lake/lognexus handoff
|
|
223
|
+
npx @digital-lake/lognexus handoff --prompt
|
|
202
224
|
npx @digital-lake/lognexus handoff --json
|
|
203
225
|
|
|
204
226
|
# Inspect the working tree against the active subtask contract
|
|
@@ -212,24 +234,27 @@ npx @digital-lake/lognexus note search --issue 30 --limit 5
|
|
|
212
234
|
npx @digital-lake/lognexus note search --author "deepseek" --json
|
|
213
235
|
```
|
|
214
236
|
|
|
215
|
-
Opt-in Telemetry,
|
|
237
|
+
Opt-in Telemetry 2.0, LOC-Weighted ROI & Cohort Benchmarks (100% local, zero network calls):
|
|
216
238
|
```bash
|
|
217
|
-
# Check telemetry status (disabled by default, 0% overhead)
|
|
239
|
+
# Check telemetry status (disabled by default, 0% overhead; interactive [y/N] Policy v2.0.0 gate on human TTY)
|
|
218
240
|
npx @digital-lake/lognexus telemetry status
|
|
219
241
|
|
|
220
|
-
# Enable local telemetry (stores metrics only in .lognexus/telemetry.json)
|
|
242
|
+
# Enable or disable local telemetry (stores metrics only in .lognexus/telemetry.json, schemaVersion 2.0.0)
|
|
221
243
|
npx @digital-lake/lognexus telemetry enable
|
|
244
|
+
npx @digital-lake/lognexus telemetry disable
|
|
222
245
|
|
|
223
|
-
# Generate .lognexus/telemetry.md report with ROI
|
|
246
|
+
# Generate .lognexus/telemetry.md report with LOC-weighted ROI (optionally scoped in-memory)
|
|
224
247
|
npx @digital-lake/lognexus telemetry report
|
|
248
|
+
npx @digital-lake/lognexus telemetry report --issue 42 --since 2026-11-01T00:00:00Z --branch main
|
|
225
249
|
|
|
226
|
-
# Inspect the exact
|
|
227
|
-
npx @digital-lake/lognexus telemetry inspect
|
|
250
|
+
# Inspect the exact Zero-PII payload structure (optionally scoped in-memory)
|
|
251
|
+
npx @digital-lake/lognexus telemetry inspect --issue 42
|
|
228
252
|
|
|
229
|
-
#
|
|
230
|
-
npx @digital-lake/lognexus telemetry
|
|
253
|
+
# Export an offline Zero-PII snapshot and aggregate multi-repo cohort benchmarks locally
|
|
254
|
+
npx @digital-lake/lognexus telemetry snapshot -o .lognexus/snapshot-v2.json --issue 42
|
|
255
|
+
npx @digital-lake/lognexus telemetry benchmark ./snapshots -o .lognexus/cohort.md --json
|
|
231
256
|
```
|
|
232
|
-
Telemetry is **strictly local-only**:
|
|
257
|
+
Telemetry 2.0 is **strictly local-only**: zero network egress, zero PII, and `O(1)` fail-silent passive hooks (100% silent in automated agent sessions). Sealed GDPR consent (`Policy v2.0.0`) pauses automatically on material policy bumps until a human re-confirms in an interactive terminal. The retired `--share --accept-terms` flags fail with an explicit error, and pre-2.0.0 stores migrate to `local` / `schemaVersion: "2.0.0"` on save.
|
|
233
258
|
|
|
234
259
|
*Read our strict Zero-PII, zero-network policy in [`docs/TELEMETRY_PRIVACY.md`](docs/TELEMETRY_PRIVACY.md).*
|
|
235
260
|
|
|
@@ -284,7 +309,7 @@ pip install lognexus-mcp
|
|
|
284
309
|
npx skills add digital-lake-ai/lognexus
|
|
285
310
|
```
|
|
286
311
|
- **Google Antigravity:** Active automatically via `skills/lognexus/SKILL.md` or workspace skills.
|
|
287
|
-
- **
|
|
312
|
+
- **GitHub Copilot / VS Code / Kimi Code:** Active via `.github/copilot-instructions.md` and `.lognexus/` workspace instructions and prompts.
|
|
288
313
|
|
|
289
314
|
---
|
|
290
315
|
|
|
@@ -319,7 +344,7 @@ By enforcing **Closed Delegation Contracts** (`allowedFiles`, `forbiddenFiles`,
|
|
|
319
344
|
| Model Family | Assigned Tier | Production Strengths Observed | Optimal Contract Fit |
|
|
320
345
|
| :--- | :---: | :--- | :--- |
|
|
321
346
|
| **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. |
|
|
322
|
-
| **DeepSeek V3
|
|
347
|
+
| **DeepSeek V3 (Chat)** | `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). |
|
|
323
348
|
| **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. |
|
|
324
349
|
|
|
325
350
|
> **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.
|
|
@@ -362,9 +387,9 @@ Every commit carries signed provenance trailers (`Planned-by:` / `Authored-by:`
|
|
|
362
387
|
|
|
363
388
|
| Role | Canonical identity |
|
|
364
389
|
|---|---|
|
|
365
|
-
| Master Architecture & Security Orchestrators | `Gemini 4
|
|
366
|
-
| Implementation (VS Code
|
|
367
|
-
| Cross-
|
|
390
|
+
| Master Architecture & Security Orchestrators | `Gemini 4 Neon` (`Orchestrator (Neon)`) · `Gemini 4 Carbon` · `Gemini 4 Argon` |
|
|
391
|
+
| Implementation (Antigravity / VS Code clients) | `google/gemini-4-hydrogen-high (antigravity)` · `google/gemini-3.8-flash-high (antigravity)` · `deepseek/VS Code (kimi-code)` |
|
|
392
|
+
| Independent review (Cross-Vendor & Intra-Fleet) | `Claude Fable 5.2` · `Claude Opus 5.5` · `OpenAI GPT-6.2 Astra` · `Gemini 4 Neon` · `Gemini 4 Carbon` · `Gemini 4 Argon` |
|
|
368
393
|
|
|
369
394
|
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.
|
|
370
395
|
|
|
@@ -372,12 +397,12 @@ The `Planned-by:` trailer documents where an externally authored plan came from.
|
|
|
372
397
|
|
|
373
398
|
## Provenance & Acknowledgments
|
|
374
399
|
|
|
375
|
-
**LogNexus** is engineered and maintained by **[HorchataHTML](https://github.com/
|
|
400
|
+
**LogNexus** is engineered and maintained by **[HorchataHTML](https://github.com/HorchataHTML)** and **[Digital Lake](https://github.com/digital-lake-ai)**, encompassing:
|
|
376
401
|
- The full TypeScript runtime, repository scaffolding & diagnostic CLI, Persistent Agent State Engine, Atomic Commit Engine, Git Notes memory layer (`refs/notes/lognexus`), local-first FinOps telemetry, Multi-Model Token Shield, and native JSON-RPC 2.0 stdio MCP server (`@digital-lake/lognexus` / `lognexus-mcp`).
|
|
377
|
-
- First-class multi-model tier routing and closed delegation contracts across **Google Gemini** (`Gemini 4
|
|
402
|
+
- First-class multi-model tier routing and closed delegation contracts across **Anthropic Claude** (`Fable 5.2`, `Mythos 5.2`, `Opus / Sonnet / Haiku 5.5`), **OpenAI** (`GPT-6.2 Astra`, `GPT-6.2 Sol`, `GPT-6 Luna`, `codex-mini`, `o3` / `o4`), **Google Gemini** (`Gemini 4 Neon`, `Gemini 4 Carbon`, `Gemini 4 Argon`, `Gemini 4 Hydrogen`, `Gemini 3.8 Pro & Flash`), **Moonshot AI** (`Kimi K3` / Kimi Code), and **DeepSeek** (`R1`, `V3`, `Chat`).
|
|
378
403
|
- The cross-reference CI validation workflow (`.github/workflows/cross-ref-check.yml`), single-source-of-truth review/signing block architecture, and sub-skill anchor normalization authored by **HorchataHTML** (`2026-08-04`, commit `cd0582c1`).
|
|
379
404
|
|
|
380
|
-
The **Master Architecture & Security Plan** governing frontier-model support, supply-chain hardening, and cross-model review governance is authored and signed by **`Gemini 4
|
|
405
|
+
The **Master Architecture & Security Plan** governing frontier-model support, supply-chain hardening, and cross-model review governance is authored and signed by **`Gemini 4 Neon`**, **`Gemini 4 Carbon`**, and **`Gemini 4 Argon`** (*Master Architecture & Security Orchestrators*).
|
|
381
406
|
|
|
382
407
|
Additional workflow inspirations and patterns are derived from [OrchestKit](https://github.com/yonatangross/orchestkit) and [Superpowers](https://github.com/obra/superpowers). Detailed license texts and notices are preserved in the [`LICENSES/`](LICENSES/) directory and in [`NOTICE.md`](NOTICE.md).
|
|
383
408
|
|
|
@@ -404,6 +429,6 @@ If **LogNexus** saved you time, prevented context amnesia in your workflows, and
|
|
|
404
429
|
## License
|
|
405
430
|
|
|
406
431
|
LogNexus is released under the [MIT License](LICENSE).
|
|
407
|
-
Copyright (c) 2026 HorchataHTML (https://github.com/
|
|
408
|
-
Copyright (c) 2026 Digital Lake and LogNexus contributors.
|
|
432
|
+
Copyright (c) 2026 HorchataHTML (https://github.com/HorchataHTML)
|
|
433
|
+
Copyright (c) 2026 Digital Lake (https://github.com/digital-lake-ai) and LogNexus contributors.
|
|
409
434
|
Copyright (c) 2026 devallibus
|
package/dist/audit/audit.d.ts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
|
+
import { type EffectiveReviewGateMode } from "../routing/profile.js";
|
|
1
2
|
export interface AuditViolation {
|
|
2
3
|
commitSha: string;
|
|
3
4
|
shortSha: string;
|
|
4
|
-
rule: "commit-format" | "authored-by-trailer" | "git-note-presence" | "contract-files" | "review-gate-separation" | "base-branch-range" | "tier-routing-violation";
|
|
5
|
+
rule: "commit-format" | "authored-by-trailer" | "invalid-identity" | "git-note-presence" | "contract-files" | "review-gate-separation" | "base-branch-range" | "tier-routing-violation";
|
|
5
6
|
message: string;
|
|
6
7
|
severity: "error" | "warn";
|
|
7
8
|
}
|
|
@@ -22,15 +23,49 @@ export interface Identity {
|
|
|
22
23
|
full: string;
|
|
23
24
|
family: string;
|
|
24
25
|
}
|
|
26
|
+
/**
|
|
27
|
+
* Strips matched outer parenthesis pairs (`((...))` -> `...`) in a single linear pass
|
|
28
|
+
* without removing sibling groups such as `(a) (b)`.
|
|
29
|
+
*/
|
|
30
|
+
export declare function unwrapOuterBalancedParens(input: string): string;
|
|
31
|
+
/**
|
|
32
|
+
* Rejects template or placeholder agent identities (`auto`, bare `orchestrator`,
|
|
33
|
+
* `unknown`, `unknown/other`, or `<provider>/<model>` placeholders) while keeping
|
|
34
|
+
* empty/omitted strings (`false`) and qualified orchestrators (`Orchestrator (Carbon)`) distinct.
|
|
35
|
+
*/
|
|
36
|
+
export declare function isInvalidPlaceholderIdentity(raw?: string | null): boolean;
|
|
25
37
|
export declare function parseIdentity(value: string | null): Identity | null;
|
|
26
38
|
export declare function extractTrailers(commitBody: string): {
|
|
27
39
|
author: string | null;
|
|
28
40
|
reviewer: string | null;
|
|
29
41
|
};
|
|
42
|
+
export interface ReviewGateCheckResult {
|
|
43
|
+
violated: boolean;
|
|
44
|
+
severity: "error" | "warn";
|
|
45
|
+
message?: string;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Derives vendor strictly from the normalized model family prefix before `/`,
|
|
49
|
+
* never from parenthetical client qualifiers.
|
|
50
|
+
*/
|
|
51
|
+
export declare function extractVendor(identity: Identity): string;
|
|
52
|
+
/**
|
|
53
|
+
* Evaluates review-gate separation under the resolved `review_gate` mode.
|
|
54
|
+
* Identical full identity (`author.full === reviewer.full`) is an unbreakable error floor in all modes.
|
|
55
|
+
*/
|
|
56
|
+
export declare function checkReviewGate(authorStr: string | null, reviewerStr: string | null, mode?: EffectiveReviewGateMode): ReviewGateCheckResult;
|
|
30
57
|
export declare function checkSelfApproval(authorStr: string | null, reviewerStr: string | null): {
|
|
31
58
|
isSelfApproval: boolean;
|
|
32
59
|
message?: string;
|
|
33
60
|
};
|
|
34
|
-
|
|
61
|
+
/**
|
|
62
|
+
* Matches a normalized repository path against a contract rule (`dir/`, exact path,
|
|
63
|
+
* intra-segment `*` wildcards, or `**` directory-crossing segments) in deterministic
|
|
64
|
+
* linear time without `new RegExp`.
|
|
65
|
+
*/
|
|
66
|
+
export declare function matchesPath(file: string, rule: string): boolean;
|
|
67
|
+
export declare function auditBranch(baseBranch?: string, targetDir?: string, options?: {
|
|
68
|
+
reviewGateMode?: EffectiveReviewGateMode;
|
|
69
|
+
}): AuditResult;
|
|
35
70
|
export declare function formatAuditResult(result: AuditResult): string;
|
|
36
71
|
//# sourceMappingURL=audit.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/audit/audit.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/audit/audit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,uBAAuB,EAG7B,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EACA,eAAe,GACf,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,wBAAwB,GACxB,mBAAmB,GACnB,wBAAwB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAGD,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AACrE,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,qBAAqB,QAEjC,CAAC;AACF,eAAO,MAAM,oBAAoB,QAGhC,CAAC;AAeF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B/D;AA2BD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CA2BzE;AA0PD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAEnE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAqBA;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,IAAI,GAAE,uBAAuC,GAC5C,qBAAqB,CAgEvB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAG/C;AAmCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA+C/D;AAkPD,wBAAgB,WAAW,CACzB,UAAU,GAAE,MAAe,EAC3B,SAAS,GAAE,MAAsB,EACjC,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,uBAAuB,CAAA;CAAE,GACrD,WAAW,CAiCb;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW7D"}
|