@digital-lake/lognexus 0.0.0-stage → 1.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 devallibus
+Copyright (c) 2026 Digital Lake and LogNexus contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,27 @@
+# Open Source Notice
+
+## LogNexus
+Copyright (c) 2026 Digital Lake and LogNexus contributors.
+
+LogNexus is an independent hard fork and continuation of the `shiplog` project created by devallibus.
+- **Original Project:** [devallibus/shiplog](https://github.com/devallibus/shiplog)
+- **Original Author:** devallibus
+- **License:** MIT License (Copyright (c) 2026 devallibus)
+
+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.
+
+---
+
+## Third-Party Components & Attributions
+
+Portions of the commit, brainstorm, and PR workflows in LogNexus incorporate ideas and patterns from:
+
+1. **OrchestKit**
+   - Repository: `https://github.com/yonatangross/orchestkit`
+   - Copyright (c) 2025 Yonatan Gross
+   - License: MIT (see `LICENSES/orchestkit-MIT.txt`)
+
+2. **Superpowers**
+   - Repository: `https://github.com/obra/superpowers`
+   - Copyright (c) 2025 Jesse Vincent
+   - License: MIT (see `LICENSES/superpowers-MIT.txt`)

package/README.md

@@ -1,3 +1,185 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="docs/assets/logo.png" alt="LogNexus Logo" width="360">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# LogNexus
+
+<p align="center">
+  <strong>The Git-Powered Memory Nexus for AI Agents</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/digital-lake-ai/lognexus/actions"><img src="https://img.shields.io/github/actions/workflow/status/digital-lake-ai/lognexus/ci.yml?branch=main&label=CI" alt="CI Status"></a>
+  <a href="https://www.npmjs.com/package/@digital-lake/lognexus"><img src="https://img.shields.io/npm/v/@digital-lake/lognexus.svg?color=blue" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://github.com/digital-lake-ai/lognexus"><img src="https://img.shields.io/badge/org-Digital%20Lake-indigo.svg" alt="Digital Lake"></a>
+</p>
+
+---
+
+## What is LogNexus?
+
+As AI coding agents take on multi-step engineering tasks, 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.
+
+**LogNexus transforms Git and GitHub into a persistent, traceable knowledge graph.** It turns every brainstorm into an issue, every issue into a scoped branch, every commit into an annotated milestone, and every Pull Request into an auditable timeline of the entire development journey.
+
+```
+Issues (Why & Goals) ──▶ Branches (Task Scopes) ──▶ Commits (Context & Diffs) ──▶ PR (Timeline & Review)
+         ▲                                                                                 │
+         └─────────────────────── Git-Backed Knowledge Graph ──────────────────────────────┘
+```
+
+---
+
+## Key Features
+
+- **Dual-Layer Architecture:**
+  - **Skill Layer (Markdown):** Drop-in compatibility with **Claude Code**, **Cursor**, **Codex**, **Antigravity**, and **Gemini CLI**.
+  - **Runtime Layer (TypeScript):** Lightweight, zero-heavy-dependency runtime with native `fetch` and a flexible **Strategy/Factory** pattern.
+- **Native Multi-Model Routing:**
+  - Route planning, PR synthesis, and cross-review to high-reasoning tiers (**Gemini / Claude Opus / DeepSeek Reasoner**).
+  - Ingest massive codebases using long-context windows (**Gemini** with 1M tokens).
+  - Delegate closed-contract implementation tasks to cost-effective execution engines (**DeepSeek Chat** at marginal cost).
+- **Cross-Model Review Gates:** Enforce non-negotiable review separation (`Authored-by:` vs `Reviewed-by:`). No model merges its own code without independent verification.
+- **Contract-First Subtasks:** Tasks are bounded by strict decision budgets, file allowlists, and stop conditions (`feat(#42/T1)`).
+- **Hidden Metadata Envelopes:** HTML comments preserve machine-parseable state (`<!-- lognexus: kind: state ... -->`) without cluttering human-readable markdown.
+
+---
+
+## Why Multi-Model Routing?
+
+Empirical benchmarks and community data demonstrate that routing specialized agent tasks to provider tiers according to context, reasoning, and execution profiles drastically reduces operating costs while improving quality.
+
+<p align="center">
+  <img src="docs/assets/multimodel-routing-costs.png" alt="Multi-Model Routing Cost and Performance Analysis" width="85%">
+</p>
+
+### Operational Tiers
+
+| Tier | Default Provider / Model | Primary Role |
+|---|---|---|
+| **tier-1 (Reasoning)** | Gemini Pro/Flash (High) · DeepSeek Reasoner · Claude Opus | Architectural design, brainstorm synthesis, PR timelines, and cross-model review gates. |
+| **tier-2 (Context)** | Gemini (1M Context Window) | Rapid codebase exploration, large context loading, discovery triage, and documentation. |
+| **tier-3 (Execution)** | DeepSeek Chat | Routine implementation under closed delegation contracts, subtask commits, and timeline logging. |
+
+---
+
+## Architecture & Competitive Positioning
+
+LogNexus advances agentic development workflows beyond passive markdown instructions into an active, verifiable development platform.
+
+<p align="center">
+  <img src="docs/assets/competitive-gap-map.png" alt="Competitive Gap Map and Roadmap" width="85%">
+</p>
+
+---
+
+## Quickstart & Golden Path
+
+LogNexus coordinates the full issue-to-merge lifecycle through intuitive slash commands:
+
+### 1. Capture the Plan
+```bash
+/lognexus plan
+```
+Transforms an exploratory brainstorm into a structured GitHub Issue with discrete subtasks (`T1..Tn`), verification criteria, and tier tags.
+
+### 2. Start Work on a Clean Branch
+```bash
+/lognexus start <issue-number>
+```
+Creates an ID-prefixed branch (`issue/<id>-<slug>`) from the default branch tip and logs a signed `[lognexus/session-start]` note.
+
+### 3. Commit with Traceability
+```bash
+/lognexus commit
+```
+Stages changes and generates structured, task-scoped commits (`feat(#42/T1): ...`) paired with an issue progress update.
+
+### 4. Synthesize the Pull Request
+```bash
+/lognexus pr
+```
+Compiles all commits, discoveries, discarded alternatives, and verification steps into a comprehensive Journey Timeline inside the PR description.
+
+### 5. Cross-Model Review & Gate Verification
+```bash
+/lognexus review
+```
+An independent model inspects the PR diff, verifies task contracts, and signs off (`Reviewed-by: <model>`) before merge.
+
+---
+
+## Installation
+
+### As a Claude Code Plugin
+```bash
+# From repository
+claude plugin add digital-lake-ai/lognexus
+
+# Or link locally
+claude plugin add ./path/to/lognexus
+```
+
+### Via Agent Skills (Antigravity / Cursor / Codex)
+```bash
+npx -y skills add digital-lake-ai/lognexus
+```
+
+### Via Global CLI
+```bash
+npm install -g @digital-lake/lognexus
+lognexus doctor
+```
+
+---
+
+## Configuration
+
+Configure your active provider in `.lognexus/config.json` or through environment variables:
+
+```bash
+# Provider selection
+export LOGNEXUS_PROVIDER=gemini        # 'gemini' or 'deepseek'
+
+# Google Gemini
+export GEMINI_API_KEY="your-api-key"
+export GEMINI_MODEL="gemini-3.8-flash"
+
+# DeepSeek
+export DEEPSEEK_API_KEY="your-api-key"
+export DEEPSEEK_BASE_URL="https://api.deepseek.com"
+export DEEPSEEK_MODEL="deepseek-chat"
+```
+
+Verify your environment anytime:
+```bash
+lognexus doctor
+```
+
+---
+
+## Disambiguation
+
+**LogNexus** by Digital Lake is an open-source development orchestrator and Git memory system for AI agents. It is not affiliated with academic research papers on industrial log compression (e.g. ISSTA 2026).
+
+---
+
+## Based on & Acknowledgments
+
+LogNexus is an independent hard fork and continuation of [`shiplog`](https://github.com/devallibus/shiplog), originally created by **devallibus** under the MIT License.
+
+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 introducing:
+- Multi-model routing with native **Google Gemini** and **DeepSeek** provider strategies.
+- A standalone TypeScript runtime and automated verification CLI.
+- Resilient backwards-compatibility for existing `.shiplog` envelopes and workflows.
+
+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).
+
+---
+
+## License
+
+LogNexus is released under the [MIT License](LICENSE).  
+Copyright (c) 2026 devallibus  
+Copyright (c) 2026 Digital Lake and LogNexus contributors.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { execSync } from "node:child_process";
+import { loadConfig } from "./config/loadConfig.js";
+import { createProvider } from "./providers/factory.js";
+import { resolveTier } from "./routing/tierRouter.js";
+function printHeader() {
+    console.log("\n🔷 LogNexus CLI v1.0.0-alpha.0 — Digital Lake\n");
+}
+function redactKey(key) {
+    if (!key)
+        return "❌ (not set)";
+    if (key.length <= 8)
+        return "•••••••• (set)";
+    return `${key.slice(0, 4)}••••${key.slice(-4)}`;
+}
+async function runDoctor(args) {
+    printHeader();
+    console.log("Running diagnostics...\n");
+    const live = args.includes("--live");
+    // 1. Git Check
+    try {
+        const gitVer = execSync("git --version", { encoding: "utf-8" }).trim();
+        const isRepo = execSync("git rev-parse --is-inside-work-tree", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+        console.log(`[PASS] Git: ${gitVer} (inside git repository: ${isRepo})`);
+    }
+    catch {
+        console.log("[FAIL] Git: Git command failed or not in a git repository");
+    }
+    // 2. GitHub CLI Check
+    try {
+        const ghVer = execSync("gh --version", { encoding: "utf-8" }).split("\n")[0];
+        console.log(`[PASS] GitHub CLI: ${ghVer}`);
+    }
+    catch {
+        console.log("[WARN] GitHub CLI: 'gh' not found in PATH or not installed");
+    }
+    // 3. Load Configuration
+    const config = loadConfig();
+    console.log(`\n[INFO] Active Provider Strategy: ${config.provider.toUpperCase()}`);
+    console.log(`  - Gemini Key:   ${redactKey(config.gemini.apiKey)}`);
+    console.log(`  - Gemini Model: ${config.gemini.model}`);
+    console.log(`  - DeepSeek Key: ${redactKey(config.deepseek.apiKey)}`);
+    console.log(`  - DeepSeek Model: ${config.deepseek.model}`);
+    // 4. Live Provider Connectivity Check (Optional)
+    if (live) {
+        console.log("\nTesting live API connectivity...");
+        if (config.gemini.apiKey) {
+            const gemini = createProvider("gemini", config);
+            const health = await gemini.healthCheck();
+            console.log(`  - Gemini Live: ${health.ok ? "✅ PASS" : "❌ FAIL"} — ${health.message}`);
+        }
+        if (config.deepseek.apiKey) {
+            const deepseek = createProvider("deepseek", config);
+            const health = await deepseek.healthCheck();
+            console.log(`  - DeepSeek Live: ${health.ok ? "✅ PASS" : "❌ FAIL"} — ${health.message}`);
+        }
+    }
+    else {
+        console.log("\nTip: Pass --live to verify API keys with real connectivity checks.");
+    }
+    console.log("\nDiagnostic complete.\n");
+}
+function runRoute(args) {
+    const tierArg = args[0];
+    if (!tierArg || !["tier-1", "tier-2", "tier-3"].includes(tierArg)) {
+        console.error("Usage: lognexus route <tier-1 | tier-2 | tier-3>");
+        process.exit(1);
+    }
+    const tier = tierArg;
+    const config = loadConfig();
+    const assignment = resolveTier(tier, config);
+    console.log(`\n🔷 LogNexus Tier Route: [${assignment.tier}]`);
+    console.log(`Provider: ${assignment.provider.id}`);
+    console.log(`Model:    ${assignment.model}`);
+    console.log(`Purpose:  ${assignment.description}\n`);
+}
+function runHelp() {
+    printHeader();
+    console.log("Usage: lognexus <command> [options]\n");
+    console.log("Commands:");
+    console.log("  doctor [--live]     Run environment and credentials diagnostic");
+    console.log("  route <tier>        Resolve assigned model/provider for a tier (tier-1, tier-2, tier-3)");
+    console.log("  config              Display sanitized configuration");
+    console.log("  help                Show this help message\n");
+}
+async function main() {
+    const command = process.argv[2] || "help";
+    const args = process.argv.slice(3);
+    switch (command) {
+        case "doctor":
+            await runDoctor(args);
+            break;
+        case "route":
+            runRoute(args);
+            break;
+        case "config":
+            printHeader();
+            console.log(JSON.stringify({
+                ...loadConfig(),
+                gemini: { ...loadConfig().gemini, apiKey: redactKey(loadConfig().gemini.apiKey) },
+                deepseek: { ...loadConfig().deepseek, apiKey: redactKey(loadConfig().deepseek.apiKey) },
+            }, null, 2));
+            break;
+        default:
+            runHelp();
+            break;
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config/loadConfig.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const ProviderTypeSchema: z.ZodEnum<{
+    deepseek: "deepseek";
+    gemini: "gemini";
+}>;
+export type ProviderType = z.infer<typeof ProviderTypeSchema>;
+export declare const GeminiConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    apiBaseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const DeepSeekConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    apiBaseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const LogNexusConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        deepseek: "deepseek";
+        gemini: "gemini";
+    }>>;
+    gemini: z.ZodDefault<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        apiBaseUrl: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    deepseek: z.ZodDefault<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        apiBaseUrl: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LogNexusConfig = z.infer<typeof LogNexusConfigSchema>;
+export declare function loadConfigFile(customPath?: string): Partial<LogNexusConfig>;
+export declare function loadConfig(customConfigPath?: string, env?: NodeJS.ProcessEnv): LogNexusConfig;
+//# sourceMappingURL=loadConfig.d.ts.map

package/dist/config/loadConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;EAAiC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;iBAU/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB3E;AAED,wBAAgB,UAAU,CACxB,gBAAgB,CAAC,EAAE,MAAM,EACzB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,cAAc,CAsBhB"}

package/dist/config/loadConfig.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+export const ProviderTypeSchema = z.enum(["gemini", "deepseek"]);
+export const GeminiConfigSchema = z.object({
+    apiKey: z.string().optional(),
+    model: z.string().default("gemini-3.8-flash"),
+    apiBaseUrl: z.string().default("https://generativelanguage.googleapis.com/v1beta"),
+});
+export const DeepSeekConfigSchema = z.object({
+    apiKey: z.string().optional(),
+    model: z.string().default("deepseek-chat"),
+    apiBaseUrl: z.string().default("https://api.deepseek.com"),
+});
+export const LogNexusConfigSchema = z.object({
+    provider: ProviderTypeSchema.default("gemini"),
+    gemini: GeminiConfigSchema.default({
+        model: "gemini-3.8-flash",
+        apiBaseUrl: "https://generativelanguage.googleapis.com/v1beta",
+    }),
+    deepseek: DeepSeekConfigSchema.default({
+        model: "deepseek-chat",
+        apiBaseUrl: "https://api.deepseek.com",
+    }),
+});
+export function loadConfigFile(customPath) {
+    const candidates = customPath
+        ? [customPath]
+        : [
+            path.resolve(process.cwd(), ".lognexus/config.json"),
+            path.resolve(process.cwd(), ".shiplog/config.json"),
+        ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            try {
+                const raw = fs.readFileSync(candidate, "utf-8");
+                return JSON.parse(raw);
+            }
+            catch {
+                // ignore parse errors and proceed to next/defaults
+            }
+        }
+    }
+    return {};
+}
+export function loadConfig(customConfigPath, env = process.env) {
+    const fileConfig = loadConfigFile(customConfigPath);
+    const merged = {
+        provider: env.LOGNEXUS_PROVIDER || fileConfig.provider || "gemini",
+        gemini: {
+            apiKey: env.GEMINI_API_KEY || fileConfig.gemini?.apiKey,
+            model: env.GEMINI_MODEL || fileConfig.gemini?.model || "gemini-3.8-flash",
+            apiBaseUrl: env.GEMINI_BASE_URL ||
+                fileConfig.gemini?.apiBaseUrl ||
+                "https://generativelanguage.googleapis.com/v1beta",
+        },
+        deepseek: {
+            apiKey: env.DEEPSEEK_API_KEY || fileConfig.deepseek?.apiKey,
+            model: env.DEEPSEEK_MODEL || fileConfig.deepseek?.model || "deepseek-chat",
+            apiBaseUrl: env.DEEPSEEK_BASE_URL || fileConfig.deepseek?.apiBaseUrl || "https://api.deepseek.com",
+        },
+    };
+    return LogNexusConfigSchema.parse(merged);
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/config/loadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.js","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./config/loadConfig.js";
+export * from "./providers/deepseek.js";
+export * from "./providers/factory.js";
+export * from "./providers/gemini.js";
+export * from "./providers/openaiCompatible.js";
+export * from "./providers/types.js";
+export * from "./routing/tierRouter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./config/loadConfig.js";
+export * from "./providers/deepseek.js";
+export * from "./providers/factory.js";
+export * from "./providers/gemini.js";
+export * from "./providers/openaiCompatible.js";
+export * from "./providers/types.js";
+export * from "./routing/tierRouter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,10 @@
+import { OpenAICompatibleProvider } from "./openaiCompatible.js";
+export interface DeepSeekProviderOptions {
+    apiKey?: string;
+    model?: string;
+    apiBaseUrl?: string;
+}
+export declare class DeepSeekProvider extends OpenAICompatibleProvider {
+    constructor(options?: DeepSeekProviderOptions);
+}
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/providers/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,YAAY,OAAO,GAAE,uBAA4B,EAQhD;CACF"}

package/dist/providers/deepseek.js

@@ -0,0 +1,13 @@
+import { OpenAICompatibleProvider } from "./openaiCompatible.js";
+export class DeepSeekProvider extends OpenAICompatibleProvider {
+    constructor(options = {}) {
+        const opts = {
+            id: "deepseek",
+            apiKey: options.apiKey,
+            model: options.model || "deepseek-chat",
+            apiBaseUrl: options.apiBaseUrl || "https://api.deepseek.com",
+        };
+        super(opts);
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAQ/F,MAAM,OAAO,gBAAiB,SAAQ,wBAAwB;IAC5D,YAAY,OAAO,GAA4B,EAAE;QAC/C,MAAM,IAAI,GAA4B;YACpC,EAAE,EAAE,UAAU;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,eAAe;YACvC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,0BAA0B;SAC7D,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;CACF"}

package/dist/providers/factory.d.ts

@@ -0,0 +1,4 @@
+import type { LogNexusConfig, ProviderType } from "../config/loadConfig.js";
+import type { LLMProvider } from "./types.js";
+export declare function createProvider(type: ProviderType, config: LogNexusConfig): LLMProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,CAmBtF"}

package/dist/providers/factory.js

@@ -0,0 +1,23 @@
+import { DeepSeekProvider } from "./deepseek.js";
+import { GeminiProvider } from "./gemini.js";
+export function createProvider(type, config) {
+    switch (type) {
+        case "gemini":
+            return new GeminiProvider({
+                apiKey: config.gemini.apiKey,
+                model: config.gemini.model,
+                apiBaseUrl: config.gemini.apiBaseUrl,
+            });
+        case "deepseek":
+            return new DeepSeekProvider({
+                apiKey: config.deepseek.apiKey,
+                model: config.deepseek.model,
+                apiBaseUrl: config.deepseek.apiBaseUrl,
+            });
+        default: {
+            const exhaustiveCheck = type;
+            throw new Error(`Unsupported provider: ${exhaustiveCheck}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,MAAsB;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC;gBACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;gBAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;gBAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;aACrC,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,IAAI,gBAAgB,CAAC;gBAC1B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gBAC9B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;gBAC5B,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;aACvC,CAAC,CAAC;QACL,SAAS,CAAC;YACR,MAAM,eAAe,GAAU,IAAI,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yBAAyB,eAAe,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,17 @@
+import type { GenerateRequest, LLMProvider, LLMResponse, ProviderHealth } from "./types.js";
+export interface GeminiProviderOptions {
+    apiKey?: string;
+    model?: string;
+    apiBaseUrl?: string;
+}
+export declare class GeminiProvider implements LLMProvider {
+    readonly id = "gemini";
+    private apiKey?;
+    private defaultModel;
+    private apiBaseUrl;
+    constructor(options?: GeminiProviderOptions);
+    private mapRole;
+    generate(req: GenerateRequest): Promise<LLMResponse>;
+    healthCheck(): Promise<ProviderHealth>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EACX,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,EAAE,YAAY;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAE3B,YAAY,OAAO,GAAE,qBAA0B,EAI9C;IAED,OAAO,CAAC,OAAO;IAIF,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAuFhE;IAEY,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAyBlD;CACF"}

package/dist/providers/gemini.js

@@ -0,0 +1,105 @@
+export class GeminiProvider {
+    id = "gemini";
+    apiKey;
+    defaultModel;
+    apiBaseUrl;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey;
+        this.defaultModel = options.model || "gemini-3.8-flash";
+        this.apiBaseUrl = options.apiBaseUrl || "https://generativelanguage.googleapis.com/v1beta";
+    }
+    mapRole(role) {
+        return role === "assistant" ? "model" : "user";
+    }
+    async generate(req) {
+        if (!this.apiKey) {
+            throw new Error("Gemini API key is required. Set GEMINI_API_KEY in your environment or .lognexus/config.json");
+        }
+        const model = req.model || this.defaultModel;
+        const url = `${this.apiBaseUrl}/models/${encodeURIComponent(model)}:generateContent`;
+        const systemMessages = req.messages.filter((m) => m.role === "system");
+        const nonSystemMessages = req.messages.filter((m) => m.role !== "system");
+        const contents = nonSystemMessages.map((msg) => ({
+            role: this.mapRole(msg.role),
+            parts: [{ text: msg.content }],
+        }));
+        const payload = {
+            contents,
+        };
+        if (systemMessages.length > 0) {
+            payload.systemInstruction = {
+                parts: [{ text: systemMessages.map((m) => m.content).join("\n\n") }],
+            };
+        }
+        if (req.temperature !== undefined || req.maxTokens !== undefined) {
+            payload.generationConfig = {
+                ...(req.temperature !== undefined ? { temperature: req.temperature } : {}),
+                ...(req.maxTokens !== undefined ? { maxOutputTokens: req.maxTokens } : {}),
+            };
+        }
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-goog-api-key": this.apiKey,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            let errorDetails = `HTTP ${res.status} ${res.statusText}`;
+            try {
+                const errorJson = (await res.json());
+                if (errorJson.error?.message) {
+                    errorDetails = errorJson.error.message;
+                }
+            }
+            catch {
+                // Fallback to status text
+            }
+            throw new Error(`Gemini API Error: ${errorDetails}`);
+        }
+        const data = (await res.json());
+        const text = data.candidates?.[0]?.content?.parts?.[0]?.text ?? "";
+        const usage = data.usageMetadata
+            ? {
+                promptTokens: data.usageMetadata.promptTokenCount ?? 0,
+                completionTokens: data.usageMetadata.candidatesTokenCount ?? 0,
+                totalTokens: data.usageMetadata.totalTokenCount ?? 0,
+            }
+            : undefined;
+        return {
+            text,
+            usage,
+            model,
+            provider: this.id,
+            raw: data,
+        };
+    }
+    async healthCheck() {
+        if (!this.apiKey) {
+            return {
+                ok: false,
+                message: "Missing GEMINI_API_KEY in environment or configuration",
+            };
+        }
+        const start = Date.now();
+        try {
+            await this.generate({
+                messages: [{ role: "user", content: "Ping" }],
+                maxTokens: 1,
+            });
+            return {
+                ok: true,
+                message: `Connected successfully to Gemini (${this.defaultModel})`,
+                latencyMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                message: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"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"}

package/dist/providers/openaiCompatible.d.ts

@@ -0,0 +1,17 @@
+import type { GenerateRequest, LLMProvider, LLMResponse, ProviderHealth } from "./types.js";
+export interface OpenAICompatibleOptions {
+    id?: string;
+    apiKey?: string;
+    model: string;
+    apiBaseUrl: string;
+}
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    readonly id: string;
+    protected apiKey?: string;
+    protected defaultModel: string;
+    protected apiBaseUrl: string;
+    constructor(options: OpenAICompatibleOptions);
+    generate(req: GenerateRequest): Promise<LLMResponse>;
+    healthCheck(): Promise<ProviderHealth>;
+}
+//# sourceMappingURL=openaiCompatible.d.ts.map

package/dist/providers/openaiCompatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatible.d.ts","sourceRoot":"","sources":["../../src/providers/openaiCompatible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,wBAAyB,YAAW,WAAW;IAC1D,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7B,YAAY,OAAO,EAAE,uBAAuB,EAK3C;IAEY,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAmFhE;IAEY,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAyBlD;CACF"}

package/dist/providers/openaiCompatible.js

@@ -0,0 +1,100 @@
+export class OpenAICompatibleProvider {
+    id;
+    apiKey;
+    defaultModel;
+    apiBaseUrl;
+    constructor(options) {
+        this.id = options.id || "openai-compatible";
+        this.apiKey = options.apiKey;
+        this.defaultModel = options.model;
+        this.apiBaseUrl = options.apiBaseUrl.replace(/\/+$/, "");
+    }
+    async generate(req) {
+        if (!this.apiKey) {
+            throw new Error(`API key is required for provider "${this.id}". Set appropriate environment variable or .lognexus/config.json`);
+        }
+        const model = req.model || this.defaultModel;
+        const url = `${this.apiBaseUrl}/chat/completions`;
+        const payload = {
+            model,
+            messages: req.messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })),
+        };
+        if (req.temperature !== undefined) {
+            payload.temperature = req.temperature;
+        }
+        if (req.maxTokens !== undefined) {
+            payload.max_tokens = req.maxTokens;
+        }
+        if (req.responseFormat === "json") {
+            payload.response_format = { type: "json_object" };
+        }
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        const res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            let errorDetails = `HTTP ${res.status} ${res.statusText}`;
+            try {
+                const errorJson = (await res.json());
+                if (errorJson.error?.message) {
+                    errorDetails = errorJson.error.message;
+                }
+            }
+            catch {
+                // Fallback
+            }
+            throw new Error(`${this.id} API Error: ${errorDetails}`);
+        }
+        const data = (await res.json());
+        const text = data.choices?.[0]?.message?.content ?? "";
+        const usage = data.usage
+            ? {
+                promptTokens: data.usage.prompt_tokens ?? 0,
+                completionTokens: data.usage.completion_tokens ?? 0,
+                totalTokens: data.usage.total_tokens ?? 0,
+            }
+            : undefined;
+        return {
+            text,
+            usage,
+            model,
+            provider: this.id,
+            raw: data,
+        };
+    }
+    async healthCheck() {
+        if (!this.apiKey) {
+            return {
+                ok: false,
+                message: `Missing API key for provider "${this.id}"`,
+            };
+        }
+        const start = Date.now();
+        try {
+            await this.generate({
+                messages: [{ role: "user", content: "Ping" }],
+                maxTokens: 1,
+            });
+            return {
+                ok: true,
+                message: `Connected successfully to ${this.id} (${this.defaultModel})`,
+                latencyMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                message: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=openaiCompatible.js.map

package/dist/providers/openaiCompatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatible.js","sourceRoot":"","sources":["../../src/providers/openaiCompatible.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,wBAAwB;IACnB,EAAE,CAAS;IACjB,MAAM,CAAU;IAChB,YAAY,CAAS;IACrB,UAAU,CAAS;IAE7B,YAAY,OAAgC;QAC1C,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,mBAAmB,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,GAAoB;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,CAAC,EAAE,kEAAkE,CAC/G,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAC7C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,mBAAmB,CAAC;QAElD,MAAM,OAAO,GAA4B;YACvC,KAAK;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;SACJ,CAAC;QAEF,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACxC,CAAC;QAED,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC;QACrC,CAAC;QAED,IAAI,GAAG,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACvC,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,YAAY,GAAG,QAAQ,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqC,CAAC;gBACzE,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;oBAC7B,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,eAAe,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAW7B,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;YACtB,CAAC,CAAC;gBACE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC;gBAC3C,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC;gBACnD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC;aAC1C;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO;YACL,IAAI;YACJ,KAAK;YACL,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,GAAG,EAAE,IAAI;SACV,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,iCAAiC,IAAI,CAAC,EAAE,GAAG;aACrD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC7C,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;YACH,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,6BAA6B,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,GAAG;gBACtE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/providers/types.d.ts

@@ -0,0 +1,35 @@
+export type MessageRole = "system" | "user" | "assistant";
+export interface LLMMessage {
+    role: MessageRole;
+    content: string;
+}
+export interface GenerateRequest {
+    messages: LLMMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: "text" | "json";
+}
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+export interface LLMResponse {
+    text: string;
+    usage?: TokenUsage;
+    model: string;
+    provider: string;
+    raw?: unknown;
+}
+export interface ProviderHealth {
+    ok: boolean;
+    message: string;
+    latencyMs?: number;
+}
+export interface LLMProvider {
+    readonly id: string;
+    generate(req: GenerateRequest): Promise<LLMResponse>;
+    healthCheck(): Promise<ProviderHealth>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACxC"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/routing/tierRouter.d.ts

@@ -0,0 +1,11 @@
+import type { LogNexusConfig } from "../config/loadConfig.js";
+import type { LLMProvider } from "../providers/types.js";
+export type OperationTier = "tier-1" | "tier-2" | "tier-3";
+export interface TierAssignment {
+    tier: OperationTier;
+    provider: LLMProvider;
+    model: string;
+    description: string;
+}
+export declare function resolveTier(tier: OperationTier, config: LogNexusConfig): TierAssignment;
+//# sourceMappingURL=tierRouter.d.ts.map

package/dist/routing/tierRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierRouter.d.ts","sourceRoot":"","sources":["../../src/routing/tierRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CAuCvF"}

package/dist/routing/tierRouter.js

@@ -0,0 +1,42 @@
+import { createProvider } from "../providers/factory.js";
+export function resolveTier(tier, config) {
+    switch (tier) {
+        case "tier-1": {
+            // Tier 1 (Reasoning): Gemini Pro/Flash High or DeepSeek Reasoner
+            if (config.provider === "deepseek") {
+                return {
+                    tier,
+                    provider: createProvider("deepseek", config),
+                    model: "deepseek-reasoner",
+                    description: "High-reasoning architecture & review (DeepSeek Reasoner)",
+                };
+            }
+            return {
+                tier,
+                provider: createProvider("gemini", config),
+                model: config.gemini.model,
+                description: `High-reasoning architecture & review (Gemini: ${config.gemini.model})`,
+            };
+        }
+        case "tier-2": {
+            // Tier 2 (Context): Ingestion, discovery, knowledge
+            return {
+                tier,
+                provider: createProvider("gemini", config),
+                model: config.gemini.model,
+                description: `Long-context codebase exploration & triage (Gemini: ${config.gemini.model})`,
+            };
+        }
+        case "tier-3": {
+            // Tier 3 (Execution): DeepSeek Chat (or configured background provider)
+            const providerType = config.deepseek.apiKey ? "deepseek" : config.provider;
+            return {
+                tier,
+                provider: createProvider(providerType, config),
+                model: providerType === "deepseek" ? config.deepseek.model : config.gemini.model,
+                description: `Fast execution under closed delegation contract (${providerType})`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=tierRouter.js.map

package/dist/routing/tierRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierRouter.js","sourceRoot":"","sources":["../../src/routing/tierRouter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAYzD,MAAM,UAAU,WAAW,CAAC,IAAmB,EAAE,MAAsB;IACrE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,EAAE,CAAC;YACd,iEAAiE;YACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACnC,OAAO;oBACL,IAAI;oBACJ,QAAQ,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC;oBAC5C,KAAK,EAAE,mBAAmB;oBAC1B,WAAW,EAAE,0DAA0D;iBACxE,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;gBAC1B,WAAW,EAAE,iDAAiD,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG;aACrF,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,oDAAoD;YACpD,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;gBAC1B,WAAW,EAAE,uDAAuD,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG;aAC3F,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,wEAAwE;YACxE,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC3E,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC;gBAC9C,KAAK,EAAE,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK;gBAChF,WAAW,EAAE,oDAAoD,YAAY,GAAG;aACjF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@digital-lake/lognexus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-alpha.0",
+  "description": "The Git-powered memory nexus for AI agents. Multi-model routing, durable cognitive logs, and traceable pull requests.",
+  "type": "module",
+  "bin": {
+    "lognexus": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "lint": "biome check .",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "git",
+    "ai",
+    "agents",
+    "orchestrator",
+    "gemini",
+    "deepseek",
+    "claude",
+    "memory",
+    "traceability",
+    "knowledge-graph"
+  ],
+  "author": {
+    "name": "Digital Lake",
+    "url": "https://github.com/digital-lake-ai"
+  },
+  "contributors": [
+    {
+      "name": "devallibus",
+      "url": "https://github.com/devallibus"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digital-lake-ai/lognexus.git"
+  },
+  "homepage": "https://github.com/digital-lake-ai/lognexus#readme",
+  "bugs": {
+    "url": "https://github.com/digital-lake-ai/lognexus/issues"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.6.2",
+    "@types/node": "^26.6.5",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
+}