@nexus-ai-nexoralabs/cli 0.1.0

package/.env.example

@@ -0,0 +1,16 @@
+# NEXUS AI Application Environment Configuration
+
+# Server / API Port
+PORT=3000
+
+# Environment Mode (development | production | test)
+NODE_ENV=development
+
+# Local Ollama Service URL
+OLLAMA_HOST=http://127.0.0.1:11434
+
+# Data & Persistence Directory
+DATABASE_PATH=./data/nexus.sqlite
+
+# Logging Level (debug | info | warn | error)
+LOG_LEVEL=info

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NEXUS AI Team
+
+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 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/README.md

@@ -0,0 +1,106 @@
+# NEXUS AI — Local-First AI Workstation CLI
+
+NEXUS AI is a local-first, cross-platform AI workstation CLI that orchestrates local language models (via Ollama), retrieves private knowledge (RAG), manages project context, executes permission-controlled tools, and performs full coding-agent workflows — entirely on your own machine.
+
+## Installation
+
+### Requirements
+
+- **Node.js** `>=20.0.0` — [nodejs.org](https://nodejs.org)
+- **Ollama** — [ollama.com/download](https://ollama.com/download)
+- At least one local model (e.g. `qwen2.5:3b`)
+
+### Install NEXUS AI CLI
+
+```bash
+npm install -g @nexus-ai-nexoralabs/cli
+```
+
+### Install a local model (if you haven't already)
+
+```bash
+ollama pull qwen2.5:3b
+```
+
+### Launch NEXUS
+
+```bash
+nexus
+```
+
+That's it. NEXUS will initialize your workspace and configuration automatically on first run.
+
+---
+
+## First-Run Experience
+
+When you run `nexus` for the first time, NEXUS will:
+
+1. Create your personal workspace at `~/NEXUS-Workspace` (Windows: `%USERPROFILE%\NEXUS-Workspace`)
+2. Initialize the local database at `%APPDATA%\NEXUS AI\data\nexus.sqlite` (Windows) or `~/.nexus-ai/data/nexus.sqlite`
+3. Detect available Ollama models
+4. Display the interactive dashboard
+
+If Ollama is not installed or not running, NEXUS will display a clear, actionable setup guide instead of crashing.
+
+---
+
+## CLI Commands
+
+Once inside NEXUS:
+
+| Command | Description |
+|---|---|
+| `/help` | Show all available commands |
+| `/models` | List available local AI models |
+| `/model <id>` | Switch to a specific model |
+| `/tasks` | Show recent tasks |
+| `/preview` | Preview the latest completed web project |
+| `/preview stop` | Stop the preview server |
+| `/clear` | Clear the screen |
+| `/exit` | Exit NEXUS |
+
+---
+
+## Subsystem Architecture
+
+- `src/config/` — Environment configuration & production path resolution
+- `src/storage/` — SQLite persistence & workspace abstraction
+- `src/intelligence/` — Local Ollama gateway & model registry
+- `src/knowledge/` — RAG document indexing & retrieval
+- `src/tools/` — Controlled filesystem, search & terminal adapters
+- `src/orchestration/` — Agent planning, execution & verification
+- `src/preview/` — Local web project preview server
+- `src/api/` — Application API contracts & health checks
+
+---
+
+## Developer Setup
+
+```bash
+# 1. Clone and install
+npm install
+
+# 2. Copy environment template
+cp .env.example .env
+
+# 3. Type check
+npm run typecheck
+
+# 4. Lint
+npm run lint
+
+# 5. Run tests
+npm test
+
+# 6. Build
+npm run build
+
+# 7. Run CLI in development mode
+npm run agent
+```
+
+## License
+
+MIT
+

package/dist/api/index.d.ts

@@ -0,0 +1,81 @@
+import type { SubsystemStatus } from '../storage/index.js';
+import type { AppConfig } from '../config/index.js';
+import { ProjectService } from '../storage/index.js';
+import { IntelligenceService } from '../intelligence/index.js';
+import { KnowledgeEngine } from '../knowledge/index.js';
+import { ToolGateway } from '../tools/index.js';
+import { ConversationService } from '../chat/conversationService.js';
+import { MessageService } from '../chat/messageService.js';
+import { ChatService } from '../chat/chatService.js';
+import { WorkspaceService } from '../config/workspaceService.js';
+import { FirstRunService } from '../config/firstRunService.js';
+import { PreviewService } from '../preview/previewService.js';
+import type { WorkspaceValidationResult } from '../config/workspaceService.js';
+import type { FirstRunReport } from '../config/firstRunHealthCheck.js';
+import type { AgentTaskService, AgentExecutionService, PlanSynthesisService, HumanApprovalService, CodingAgentService } from '../orchestration/index.js';
+export interface SystemHealthReport {
+    overall: 'ok' | 'degraded' | 'error';
+    timestamp: string;
+    config: {
+        environment: string;
+        port: number;
+        ollamaHost: string;
+        databasePath: string;
+    };
+    subsystems: SubsystemStatus[];
+}
+export declare class ApplicationApi {
+    private config;
+    private storage;
+    intelligence: IntelligenceService;
+    knowledge: KnowledgeEngine;
+    projects: ProjectService;
+    conversations: ConversationService;
+    messages: MessageService;
+    chat: ChatService;
+    /** Agent task lifecycle service — exposed from Orchestrator. */
+    tasks: AgentTaskService;
+    /** Agent execution loop service — exposed from Orchestrator. */
+    execution?: AgentExecutionService;
+    /** Plan synthesis service (P5-E) — exposed from Orchestrator. */
+    planner?: PlanSynthesisService;
+    /** Human approval service (P5-F) — exposed from Orchestrator. */
+    approvals?: HumanApprovalService;
+    /** Coding agent service (P6-D) — exposed from Orchestrator. */
+    codingAgent?: CodingAgentService;
+    /** Tool registry and permission authorization gateway. */
+    tools: ToolGateway;
+    /** Workspace service — exposes validateWorkspace for safe consumer use. */
+    workspace: WorkspaceService;
+    /** First-run state management service (available after bootstrap). */
+    firstRun?: FirstRunService;
+    /** Local web project preview service (P7-H). */
+    preview: PreviewService;
+    private orchestrator;
+    private closed;
+    private workspaceResult?;
+    constructor(config: AppConfig);
+    /**
+     * Safe workspace validation — can be called before or after bootstrap.
+     * Never bypasses sandbox or traversal rules.
+     */
+    validateWorkspace(rawPath: string): WorkspaceValidationResult;
+    bootstrap(): Promise<SystemHealthReport>;
+    getHealthReport(): SystemHealthReport;
+    /**
+     * Build a consolidated first-run health report.
+     * Returns null if bootstrap has not been called yet.
+     */
+    getFirstRunReport(): Promise<FirstRunReport | null>;
+    getConfig(): AppConfig;
+    getWorkspaceResult(): WorkspaceValidationResult | undefined;
+    getActivityTimeline(): Array<{
+        id: string;
+        type: 'task_created' | 'state_transition' | 'approval_requested' | 'approval_decision' | 'step_executed';
+        title: string;
+        detail?: string;
+        timestamp: string;
+    }>;
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

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

package/dist/api/index.js

@@ -0,0 +1,224 @@
+import { StorageService, ProjectService } from '../storage/index.js';
+import { IntelligenceService } from '../intelligence/index.js';
+import { KnowledgeEngine } from '../knowledge/index.js';
+import { ToolGateway } from '../tools/index.js';
+import { Orchestrator } from '../orchestration/index.js';
+import { ConversationService } from '../chat/conversationService.js';
+import { MessageService } from '../chat/messageService.js';
+import { ChatService } from '../chat/chatService.js';
+import { WorkspaceService } from '../config/workspaceService.js';
+import { FirstRunService } from '../config/firstRunService.js';
+import { PreviewService } from '../preview/previewService.js';
+import { buildFirstRunReport } from '../config/firstRunHealthCheck.js';
+export class ApplicationApi {
+    config;
+    storage;
+    intelligence;
+    knowledge;
+    projects;
+    conversations;
+    messages;
+    chat;
+    /** Agent task lifecycle service — exposed from Orchestrator. */
+    tasks;
+    /** Agent execution loop service — exposed from Orchestrator. */
+    execution;
+    /** Plan synthesis service (P5-E) — exposed from Orchestrator. */
+    planner;
+    /** Human approval service (P5-F) — exposed from Orchestrator. */
+    approvals;
+    /** Coding agent service (P6-D) — exposed from Orchestrator. */
+    codingAgent;
+    /** Tool registry and permission authorization gateway. */
+    tools;
+    /** Workspace service — exposes validateWorkspace for safe consumer use. */
+    workspace;
+    /** First-run state management service (available after bootstrap). */
+    firstRun;
+    /** Local web project preview service (P7-H). */
+    preview;
+    orchestrator = new Orchestrator();
+    closed = false;
+    workspaceResult;
+    constructor(config) {
+        this.config = config;
+        this.storage = new StorageService(config.databasePath, config.logLevel);
+        this.intelligence = new IntelligenceService(config.ollamaHost, config.logLevel, config.nexusInferenceProvider);
+        this.knowledge = new KnowledgeEngine(config.logLevel);
+        this.tools = new ToolGateway(undefined, config.logLevel);
+        this.workspace = new WorkspaceService(config.logLevel);
+    }
+    /**
+     * Safe workspace validation — can be called before or after bootstrap.
+     * Never bypasses sandbox or traversal rules.
+     */
+    validateWorkspace(rawPath) {
+        return this.workspace.validateWorkspace(rawPath);
+    }
+    async bootstrap() {
+        // Workspace initialization (before tool init so ToolGateway gets canonical root)
+        this.workspaceResult = this.workspace.initializeWorkspace(this.config.workspaceRoot);
+        await this.storage.initialize();
+        await this.intelligence.initialize(this.storage.models);
+        await this.knowledge.initialize(this.storage.knowledge);
+        this.projects = new ProjectService(this.storage.projects, this.config.logLevel);
+        this.conversations = new ConversationService(this.storage.conversations, this.config.logLevel);
+        this.messages = new MessageService(this.storage.messages, this.config.logLevel);
+        this.chat = new ChatService(this.conversations, this.messages, this.intelligence.gateway, this.knowledge.rag, this.config.logLevel);
+        await this.orchestrator.initialize(this.storage.agentTasks, this.tools, this.intelligence.gateway, this.storage.approvals);
+        this.tasks = this.orchestrator.tasks;
+        this.execution = this.orchestrator.execution;
+        this.planner = this.orchestrator.planner;
+        this.approvals = this.orchestrator.approvals;
+        this.codingAgent = this.orchestrator.codingAgent;
+        await this.tools.initialize(this.tasks, this.config.workspaceRoot);
+        // Startup Crash Recovery: recover interrupted active tasks left in transient execution states
+        const transientStates = ['executing', 'observing', 'verifying'];
+        for (const state of transientStates) {
+            const activeTasks = this.tasks.getTasksByState(state);
+            for (const t of activeTasks) {
+                this.tasks.failTask(t.id, {
+                    errorCategory: 'INTERRUPTED_BY_SHUTDOWN',
+                    currentStep: t.currentStep || undefined,
+                });
+            }
+        }
+        // Wire up FirstRunService using the settings repository
+        this.firstRun = new FirstRunService(this.storage.settings, this.config.logLevel);
+        // Initialize Local Web Project Preview Service (P7-H)
+        this.preview = new PreviewService(this.storage.agentTasks, this.config.workspaceRoot, this.config.logLevel);
+        return this.getHealthReport();
+    }
+    getHealthReport() {
+        const subsystems = [
+            this.storage.getStatus(),
+            this.intelligence.getStatus(),
+            this.knowledge.getStatus(),
+            this.tools.getStatus(),
+            this.orchestrator.getStatus(),
+        ];
+        const hasError = subsystems.some((s) => s.status === 'error');
+        const hasDegraded = subsystems.some((s) => s.status === 'degraded');
+        const overallStatus = hasError ? 'error' : hasDegraded ? 'degraded' : 'ok';
+        return {
+            overall: overallStatus,
+            timestamp: new Date().toISOString(),
+            config: {
+                environment: this.config.environment,
+                port: this.config.port,
+                ollamaHost: this.config.ollamaHost,
+                databasePath: this.config.databasePath,
+            },
+            subsystems,
+        };
+    }
+    /**
+     * Build a consolidated first-run health report.
+     * Returns null if bootstrap has not been called yet.
+     */
+    async getFirstRunReport() {
+        if (!this.firstRun || !this.workspaceResult) {
+            return null;
+        }
+        const storageStatus = this.storage.getStatus();
+        const toolGatewayStatus = this.tools.getStatus();
+        const orchestratorStatus = this.orchestrator.getStatus();
+        const knowledgeStatus = this.knowledge.getStatus();
+        const runtimeHealth = await this.intelligence.runtimeManager.getHealth();
+        const availableModels = this.intelligence.registry?.getAvailableModels() ?? [];
+        const availableModelIds = availableModels.map((m) => m.id);
+        // Resolve primary/fallback model readiness
+        const primaryModelId = this.config.primaryModel || availableModelIds[0];
+        const fallbackModelId = this.config.fallbackModel || availableModelIds[1];
+        let primaryModelReadiness = undefined;
+        let fallbackModelReadiness = undefined;
+        if (primaryModelId) {
+            const check = await this.intelligence.runtimeManager.checkModelReadiness(primaryModelId);
+            primaryModelReadiness = check.readiness;
+        }
+        if (fallbackModelId && fallbackModelId !== primaryModelId) {
+            const check = await this.intelligence.runtimeManager.checkModelReadiness(fallbackModelId);
+            fallbackModelReadiness = check.readiness;
+        }
+        const dbOk = storageStatus.status === 'ok';
+        const workspaceOk = this.workspaceResult.state === 'WORKSPACE_READY' || this.workspaceResult.state === 'WORKSPACE_CREATED';
+        const runtimeReady = runtimeHealth.status === 'READY';
+        const hasUsableModel = availableModelIds.length > 0;
+        const firstRunState = this.firstRun.determineState({
+            configOk: true,
+            dbOk,
+            workspaceOk,
+            runtimeReady,
+            hasUsableModel,
+        });
+        const report = buildFirstRunReport({
+            configOk: true,
+            storageStatus,
+            workspaceResult: this.workspaceResult,
+            runtimeHealth,
+            availableModelIds,
+            primaryModelId,
+            primaryModelReadiness,
+            fallbackModelId,
+            fallbackModelReadiness,
+            toolGatewayStatus,
+            orchestratorStatus,
+            knowledgeStatus,
+            firstRunState,
+        });
+        // Persist first-run completion if workspace is valid
+        if (workspaceOk && dbOk) {
+            this.firstRun.markFirstRunCompleted(this.workspaceResult.canonicalPath);
+        }
+        return report;
+    }
+    getConfig() {
+        return this.config;
+    }
+    getWorkspaceResult() {
+        return this.workspaceResult;
+    }
+    getActivityTimeline() {
+        const items = [];
+        const tasks = this.tasks?.listTasks() ?? [];
+        for (const t of tasks) {
+            items.push({
+                id: `act-task-${t.id}`,
+                type: 'task_created',
+                title: `Task Created: "${t.title}"`,
+                detail: `Task ID: ${t.id} | State: ${t.state}`,
+                timestamp: t.createdAt,
+            });
+            if (t.completedAt) {
+                items.push({
+                    id: `act-task-comp-${t.id}`,
+                    type: 'state_transition',
+                    title: `Task Completed: "${t.title}"`,
+                    detail: `Task ID: ${t.id}`,
+                    timestamp: t.completedAt,
+                });
+            }
+        }
+        const approvals = this.approvals?.listPendingApprovals() ?? [];
+        for (const a of approvals) {
+            items.push({
+                id: `act-appr-${a.approvalId}`,
+                type: 'approval_requested',
+                title: `Approval Required: ${a.toolId}`,
+                detail: `Risk Level: ${a.riskLevel.toUpperCase()} | Task: ${a.taskId}`,
+                timestamp: a.createdAt,
+            });
+        }
+        items.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        return items.slice(0, 50);
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        void this.preview?.stop();
+        this.storage.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

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

package/dist/chat/chatService.d.ts

@@ -0,0 +1,49 @@
+import type { ConversationService } from './conversationService.js';
+import type { MessageService } from './messageService.js';
+import type { ModelGateway } from '../intelligence/modelGateway.js';
+import type { RagEngine } from '../knowledge/ragEngine.js';
+import type { Message } from '../storage/repositories/types.js';
+import { type ContextPackage } from './contextBuilder.js';
+import { type RetrievalResultPackage } from '../knowledge/citationService.js';
+import { LogLevel } from '../common/logger.js';
+export interface SendMessageOptions {
+    conversationId: string;
+    userPrompt: string;
+    modelId?: string;
+    customSystemPrompt?: string;
+    maxContextTokens?: number;
+    temperature?: number;
+    timeoutMs?: number;
+    enableRag?: boolean;
+    collectionId?: string;
+}
+export interface ChatStreamEvent {
+    type: 'delta' | 'completion' | 'error' | 'cancellation';
+    conversationId: string;
+    delta?: string;
+    fullText?: string;
+    messageId?: string;
+    error?: string;
+    contextInfo?: {
+        estimatedTokens: number;
+        truncatedCount: number;
+        ragGrounding?: string;
+    };
+}
+export declare class ChatService {
+    private conversationService;
+    private messageService;
+    private modelGateway;
+    private ragEngine?;
+    private logger;
+    private contextBuilder;
+    private citationService;
+    constructor(conversationService: ConversationService, messageService: MessageService, modelGateway: ModelGateway, ragEngine?: RagEngine | undefined, logLevel?: LogLevel);
+    sendMessage(options: SendMessageOptions, onEvent?: (event: ChatStreamEvent) => void, externalSignal?: AbortSignal): Promise<{
+        userMessage: Message;
+        assistantMessage: Message;
+        context: ContextPackage;
+        ragResult?: RetrievalResultPackage;
+    }>;
+}
+//# sourceMappingURL=chatService.d.ts.map

package/dist/chat/chatService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatService.d.ts","sourceRoot":"","sources":["../../src/chat/chatService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE;QACZ,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,WAAW;IAMpB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,SAAS,CAAC;IARpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,eAAe,CAAyB;gBAGtC,mBAAmB,EAAE,mBAAmB,EACxC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,SAAS,YAAA,EAC7B,QAAQ,GAAE,QAAiB;IAKvB,WAAW,CACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAC1C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,cAAc,CAAC;QAAC,SAAS,CAAC,EAAE,sBAAsB,CAAA;KAAE,CAAC;CAsK7H"}