@digital-lake/lognexus 1.3.7 → 1.4.0
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 +61 -36
- package/dist/audit/audit.d.ts +37 -2
- package/dist/audit/audit.d.ts.map +1 -1
- package/dist/audit/audit.js +483 -57
- package/dist/audit/audit.js.map +1 -1
- package/dist/cli.d.ts +2 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +292 -32
- 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 +12 -8
- 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 +256 -0
- package/dist/routing/profile.js.map +1 -0
- package/dist/scaffold.d.ts +2 -2
- package/dist/scaffold.d.ts.map +1 -1
- package/dist/scaffold.js +22 -17
- 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 +167 -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 +213 -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 +261 -31
- 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
|
@@ -36,7 +36,7 @@ As AI coding agents take on complex engineering tasks across different IDEs, the
|
|
|
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
38
|
- **Clients:** Claude Code, Cursor, Codex, Google Antigravity, Kimi Code, VS Code, Zed.
|
|
39
|
-
- **Models:** Google Gemini (`Gemini 4
|
|
39
|
+
- **Models:** 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`), Anthropic Claude, OpenAI.
|
|
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
|
|
54
|
+
- **Universal Multi-Model Support:** Native cognitive guidelines and prompt specifications for **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), **DeepSeek** (`R1`, `V3`, `Chat`), **Anthropic Claude**, and **OpenAI**.
|
|
55
55
|
- **Universal Client Compatibility:** Drop-in support for **Claude Code**, **Cursor**, **Codex**, **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) 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 both cross-vendor review and intra-fleet distinct-model review (`Neon`/`Carbon`/`Argon` reviewing `Hydrogen`/`Flash`), 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.
|
|
@@ -82,20 +83,31 @@ 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 Opus 3.7 / 4.x | o3, o1, GPT-5 | Gemini 4 Carbon / Argon, 3.8 Pro | DeepSeek R1 | Brainstorming-to-issue planning, PR journey timeline synthesis, cross-model review sign-offs. |
|
|
86
|
-
| **tier-2 (Context & Triage)** | Long context ingestion, discovery triage, structured mapping | Claude Sonnet | GPT-4.1, GPT-4o | Gemini 3.8 Flash High / Pro (1M) | DeepSeek V3 | Large codebase exploration, discovery classification, knowledge retrieval. |
|
|
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 Opus 3.7 / 4.x / 5.5 | o3, o1, 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 | GPT-4.1, 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 | 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:
|
|
93
|
+
|
|
94
|
+
```markdown
|
|
95
|
+
routing: confirm
|
|
96
|
+
orchestration: auto
|
|
97
|
+
review_gate: auto
|
|
98
|
+
implementer: auto
|
|
99
|
+
reviewer: auto
|
|
100
|
+
```
|
|
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).
|
|
92
104
|
|
|
93
105
|
```
|
|
94
106
|
┌────────────────────────────────────────────────────────────────────────────────────────┐
|
|
95
107
|
│ POPULAR DEPLOYMENT SETUPS │
|
|
96
108
|
├────────────────────────────────────────────────────────────────────────────────────────┤
|
|
97
109
|
│ Setup A (Anthropic Pure): Claude Opus (t1) + Claude Sonnet (t2) + Claude Haiku (t3) │
|
|
98
|
-
│ Setup B (
|
|
110
|
+
│ Setup B (Antigravity Fleet): Gemini 4 Neon/Carbon/Argon (t1) + Hydrogen/Flash (t2/t3) │
|
|
99
111
|
│ Setup C (OpenAI + DeepSeek): OpenAI o3 (t1) in Cursor + DeepSeek Chat (t3) for code │
|
|
100
112
|
│ Setup D (Claude + OpenAI): Claude Opus (t1) for design + GPT-4o-mini (t3) for tasks │
|
|
101
113
|
└────────────────────────────────────────────────────────────────────────────────────────┘
|
|
@@ -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
|
|
|
@@ -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 Opus 5.5` · `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 **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`), **Anthropic Claude**, and **OpenAI**.
|
|
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;AAkMD,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;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,IAAI,GAAE,uBAAuC,GAC5C,qBAAqB,CAwDvB;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"}
|