@digital-lake/lognexus 1.3.6 → 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.
Files changed (87) hide show
  1. package/LICENSE +2 -1
  2. package/NOTICE.md +15 -7
  3. package/README.md +67 -42
  4. package/dist/audit/audit.d.ts +37 -2
  5. package/dist/audit/audit.d.ts.map +1 -1
  6. package/dist/audit/audit.js +483 -57
  7. package/dist/audit/audit.js.map +1 -1
  8. package/dist/cli.d.ts +2 -0
  9. package/dist/cli.d.ts.map +1 -1
  10. package/dist/cli.js +292 -32
  11. package/dist/cli.js.map +1 -1
  12. package/dist/commit.d.ts +6 -0
  13. package/dist/commit.d.ts.map +1 -1
  14. package/dist/commit.js +61 -23
  15. package/dist/commit.js.map +1 -1
  16. package/dist/doctor.d.ts +1 -0
  17. package/dist/doctor.d.ts.map +1 -1
  18. package/dist/doctor.js +31 -16
  19. package/dist/doctor.js.map +1 -1
  20. package/dist/index.d.ts +2 -1
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +2 -1
  23. package/dist/index.js.map +1 -1
  24. package/dist/mcp/prompts.d.ts.map +1 -1
  25. package/dist/mcp/prompts.js +12 -8
  26. package/dist/mcp/prompts.js.map +1 -1
  27. package/dist/notes/attach.d.ts +11 -0
  28. package/dist/notes/attach.d.ts.map +1 -1
  29. package/dist/notes/attach.js +22 -5
  30. package/dist/notes/attach.js.map +1 -1
  31. package/dist/routing/profile.d.ts +44 -0
  32. package/dist/routing/profile.d.ts.map +1 -0
  33. package/dist/routing/profile.js +256 -0
  34. package/dist/routing/profile.js.map +1 -0
  35. package/dist/scaffold.d.ts +2 -2
  36. package/dist/scaffold.d.ts.map +1 -1
  37. package/dist/scaffold.js +22 -17
  38. package/dist/scaffold.js.map +1 -1
  39. package/dist/state/handoff.d.ts +18 -0
  40. package/dist/state/handoff.d.ts.map +1 -1
  41. package/dist/state/handoff.js +60 -10
  42. package/dist/state/handoff.js.map +1 -1
  43. package/dist/state/manager.d.ts.map +1 -1
  44. package/dist/state/manager.js +60 -1
  45. package/dist/state/manager.js.map +1 -1
  46. package/dist/state/schema.d.ts +38 -0
  47. package/dist/state/schema.d.ts.map +1 -1
  48. package/dist/state/schema.js +9 -0
  49. package/dist/state/schema.js.map +1 -1
  50. package/dist/status.d.ts +10 -0
  51. package/dist/status.d.ts.map +1 -1
  52. package/dist/status.js +167 -42
  53. package/dist/status.js.map +1 -1
  54. package/dist/telemetry/benchmark.d.ts +51 -0
  55. package/dist/telemetry/benchmark.d.ts.map +1 -0
  56. package/dist/telemetry/benchmark.js +541 -0
  57. package/dist/telemetry/benchmark.js.map +1 -0
  58. package/dist/telemetry/collector.d.ts +109 -3
  59. package/dist/telemetry/collector.d.ts.map +1 -1
  60. package/dist/telemetry/collector.js +737 -178
  61. package/dist/telemetry/collector.js.map +1 -1
  62. package/dist/telemetry/consent-prompt.d.ts +35 -0
  63. package/dist/telemetry/consent-prompt.d.ts.map +1 -0
  64. package/dist/telemetry/consent-prompt.js +213 -0
  65. package/dist/telemetry/consent-prompt.js.map +1 -0
  66. package/dist/telemetry/detector.d.ts +16 -1
  67. package/dist/telemetry/detector.d.ts.map +1 -1
  68. package/dist/telemetry/detector.js +261 -31
  69. package/dist/telemetry/detector.js.map +1 -1
  70. package/dist/telemetry/index.d.ts +5 -4
  71. package/dist/telemetry/index.d.ts.map +1 -1
  72. package/dist/telemetry/index.js +5 -4
  73. package/dist/telemetry/index.js.map +1 -1
  74. package/dist/telemetry/report.d.ts +3 -2
  75. package/dist/telemetry/report.d.ts.map +1 -1
  76. package/dist/telemetry/report.js +66 -14
  77. package/dist/telemetry/report.js.map +1 -1
  78. package/dist/telemetry/schema.d.ts +305 -2
  79. package/dist/telemetry/schema.d.ts.map +1 -1
  80. package/dist/telemetry/schema.js +142 -4
  81. package/dist/telemetry/schema.js.map +1 -1
  82. package/dist/update/gate.d.ts +1 -1
  83. package/dist/update/gate.d.ts.map +1 -1
  84. package/dist/update/gate.js +2 -0
  85. package/dist/update/gate.js.map +1 -1
  86. package/package.json +4 -4
  87. package/server.json +3 -3
package/LICENSE CHANGED
@@ -1,7 +1,8 @@
1
1
  MIT License
2
2
 
3
+ Copyright (c) 2026 HorchataHTML (https://github.com/HorchataHTML)
4
+ Copyright (c) 2026 Digital Lake (https://github.com/digital-lake-ai) and LogNexus contributors
3
5
  Copyright (c) 2026 devallibus
4
- Copyright (c) 2026 Digital Lake and LogNexus contributors
5
6
 
6
7
  Permission is hereby granted, free of charge, to any person obtaining a copy
7
8
  of this software and associated documentation files (the "Software"), to deal
package/NOTICE.md CHANGED
@@ -1,14 +1,16 @@
1
1
  # Open Source Notice
2
2
 
3
- ## LogNexus
4
- Copyright (c) 2026 Digital Lake and LogNexus contributors.
3
+ ## Lead Author & Core Architecture
5
4
 
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)
5
+ Copyright (c) 2026 [HorchataHTML](https://github.com/HorchataHTML)
6
+ Copyright (c) 2026 [Digital Lake](https://github.com/digital-lake-ai) and LogNexus contributors.
10
7
 
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.
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
+
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
+ - **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).
12
+ - **Cross-Reference CI & Review Governance Specification (`2026-08-04`, commit `cd0582c1`):** Automated cross-reference validation workflow (`.github/workflows/cross-ref-check.yml`), single-source-of-truth consolidation of review/signing and worktree safety blocks, and sub-skill anchor/index normalization authored by **HorchataHTML**.
13
+ - **Master Architecture & Security Orchestration:** Multi-model tier routing, supply-chain hardening, and cross-model review gates (`Authored-by` != `Reviewed-by`) orchestrated with **`Gemini 4 Argon`** and **`Gemini 4 Carbon`**.
12
14
 
13
15
  ---
14
16
 
@@ -25,3 +27,9 @@ Portions of the commit, brainstorm, and PR workflows in LogNexus incorporate ide
25
27
  - Repository: `https://github.com/obra/superpowers`
26
28
  - Copyright (c) 2025 Jesse Vincent
27
29
  - License: MIT (see `LICENSES/superpowers-MIT.txt`)
30
+
31
+ ---
32
+
33
+ ## Legacy Template Copyright Notice
34
+
35
+ Initial baseline markdown skill templates include material distributed under the MIT License: Copyright (c) 2026 devallibus.
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 Argon`, `Gemini 4 Carbon`, `Gemini 3.8 Pro & Flash High`), Moonshot AI (`Kimi K3` / Kimi Code), DeepSeek (`R1`, `V3`, `Chat`), Anthropic Claude, OpenAI.
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 Argon`, `Gemini 4 Carbon`, `Gemini 3.8 Pro & Flash High`), **Moonshot AI** (`Kimi K3` / Kimi Code), **DeepSeek** (`R1`, `V3`, `Chat`), **Anthropic Claude**, and **OpenAI**.
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. No model merges its own code without independent verification from another model family.
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
- ### Example Deployment Setups
90
+ ### Adaptive Routing & Deployment Setups
90
91
 
91
- LogNexus adapts to your existing toolstack. Configure your advisory preferences in `.lognexus/routing.md`:
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 (Google + DeepSeek): Gemini Pro (t1/t2) in Antigravity + DeepSeek Chat in Kimi │
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/flash (antigravity)" \
177
- --reviewer "gemini/pro (lead-architect)" \
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 machines)
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, Stack Profiling & ROI Cost-Savings Engine (100% local, zero network calls):
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 metrics
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 local payload structure
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
- # Disable telemetry immediately
230
- npx @digital-lake/lognexus telemetry disable
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**: 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.
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 / 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). |
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,27 +387,26 @@ 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 Argon` · `Gemini 4 Carbon` |
366
- | Implementation (VS Code client) | `deepseek/VS Code (kimi-code)` |
367
- | Cross-model review (Antigravity) | `Gemini 4 Carbon` · `google/gemini-3.8-flash-high (antigravity)` |
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
 
371
396
  ---
372
397
 
373
- ## Based on & Acknowledgments
398
+ ## Provenance & Acknowledgments
374
399
 
375
- LogNexus is an independent hard fork and continuation of [`shiplog`](https://github.com/devallibus/shiplog), originally created by **devallibus** under the MIT License.
400
+ **LogNexus** is engineered and maintained by **[HorchataHTML](https://github.com/HorchataHTML)** and **[Digital Lake](https://github.com/digital-lake-ai)**, encompassing:
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`).
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**.
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`).
376
404
 
377
- 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:
378
- - 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**.
379
- - Formalizing the multi-model tier routing taxonomy and closed delegation contracts.
380
- - Introducing the repository scaffolding CLI, Atomic Commit Engine, and native MCP server (`@digital-lake/lognexus`).
381
- - Providing seamless backwards-compatibility for existing `.shiplog` envelopes and workflows.
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*).
382
406
 
383
- 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`** and **`Gemini 4 Carbon`** (*Master Architecture & Security Orchestrators*).
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).
384
408
 
385
- 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
+ LogNexus is an independent continuation and full-stack TypeScript, CLI, and native MCP evolution of shiplog.
386
410
 
387
411
  ---
388
412
 
@@ -405,5 +429,6 @@ If **LogNexus** saved you time, prevented context amnesia in your workflows, and
405
429
  ## License
406
430
 
407
431
  LogNexus is released under the [MIT License](LICENSE).
408
- Copyright (c) 2026 devallibus
409
- 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.
434
+ Copyright (c) 2026 devallibus
@@ -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
- export declare function auditBranch(baseBranch?: string, targetDir?: string): AuditResult;
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":"AAMA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EACA,eAAe,GACf,qBAAqB,GACrB,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;AAaF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAqDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAoBnE;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,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,CAc/C;AAyLD,wBAAgB,WAAW,CACzB,UAAU,GAAE,MAAe,EAC3B,SAAS,GAAE,MAAsB,GAChC,WAAW,CA0Bb;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW7D"}
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"}