Merge branch 'main' into feat/sdk-wrapper

Author: Patrick-Ehimen

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        # Use the pnpm version from package.json's packageManager
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: "pnpm"
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run lint
+      - run: pnpm run format:check

.husky/pre-commit

@@ -0,0 +1,6 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --yes lint-staged
+
+

.prettierignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+coverage
+*.min.js
+*.d.ts
+
+

.prettierrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "eslint.useFlatConfig": true,
+  "eslint.validate": ["javascript", "typescript", "typescriptreact"],
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  }
+}

CONTRIBUTING.md

@@ -32,9 +32,9 @@ pnpm dev
 
 This project is a monorepo managed by pnpm workspaces. The project is organized as follows:
 
--   `apps/`: Contains the applications, such as the documentation and the main server.
--   `packages/`: Contains the shared packages and libraries used by the applications.
--   `tools/`: Contains the tooling and configuration for the project, such as ESLint and TypeScript configurations.
+- `apps/`: Contains the applications, such as the documentation and the main server.
+- `packages/`: Contains the shared packages and libraries used by the applications.
+- `tools/`: Contains the tooling and configuration for the project, such as ESLint and TypeScript configurations.
 
 ## Commit Message Conventions
 
@@ -52,14 +52,14 @@ Each commit message consists of a **header**, a **body**, and a **footer**. The
 
 The **type** must be one of the following:
 
--   `feat`: A new feature
--   `fix`: A bug fix
--   `docs`: Documentation only changes
--   `style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
--   `refactor`: A code change that neither fixes a bug nor adds a feature
--   `perf`: A code change that improves performance
--   `test`: Adding missing tests or correcting existing tests
--   `chore`: Changes to the build process or auxiliary tools and libraries such as documentation generation
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to the build process or auxiliary tools and libraries such as documentation generation
 
 ## Code Style
 

README.md

@@ -1,3 +1,17 @@
+# lighthouse-agent-tooling
+
+Lighthouse Agent Tooling – A set of connectors, IDE extensions, and AI-native developer tools to seamlessly integrate Lighthouse into AI-powered workflows. Supports MCP (Model Context Protocol) connectors, Cursor/IDE extensions for pinning and encrypting datasets/models.
+
+## Code Style
+
+This repo uses ESLint (flat config) and Prettier for consistent code quality and formatting.
+
+- Run lint: `pnpm lint`
+- Auto-fix: `pnpm lint:fix`
+- Format: `pnpm format`
+
+Pre-commit hooks via Husky run lint-staged to format and lint changed files.
+
 # Lighthouse Agent Tooling
 
 Lighthouse Agent Tooling – A set of connectors, IDE extensions, and AI-native developer tools to seamlessly integrate Lighthouse into AI-powered workflows. Supports MCP (Model Context Protocol) connectors, Cursor/IDE extensions for pinning and encrypting datasets/models.
@@ -70,19 +84,14 @@ The `@lighthouse-tooling/types` package provides comprehensive TypeScript interf
 ### Usage
 
 ```typescript
-import { 
-  UploadResult, 
-  Dataset, 
-  AuthConfig,
-  LIGHTHOUSE_MCP_TOOLS 
-} from '@lighthouse-tooling/types';
+import { UploadResult, Dataset, AuthConfig, LIGHTHOUSE_MCP_TOOLS } from "@lighthouse-tooling/types";
 
 // Create upload result
 const uploadResult: UploadResult = {
-  cid: 'QmHash...',
+  cid: "QmHash...",
   size: 1024,
   encrypted: true,
-  uploadedAt: new Date()
+  uploadedAt: new Date(),
 };
 ```
 

apps/docs/TECHNICAL_PROPOSAL.md

@@ -122,8 +122,7 @@ interface LighthouseMCPServer {
 const LIGHTHOUSE_MCP_TOOLS = [
   {
     name: "lighthouse_upload_file",
-    description:
-      "Upload a file to IPFS via Lighthouse with optional encryption",
+    description: "Upload a file to IPFS via Lighthouse with optional encryption",
     inputSchema: {
       type: "object",
       properties: {
@@ -294,11 +293,7 @@ class LighthouseAISDK {
       });
 
       // Save key shards with access conditions
-      await this.saveEncryptionKeys(
-        uploadResult.Hash,
-        keyShards,
-        accessConditions
-      );
+      await this.saveEncryptionKeys(uploadResult.Hash, keyShards, accessConditions);
 
       return {
         cid: uploadResult.Hash,
@@ -356,14 +351,12 @@ class LighthouseAISDK {
 #### Deliverables:
 
 1. **Lighthouse MCP Server Core**
-
    - Basic MCP protocol implementation
    - Lighthouse SDK integration
    - Authentication management
    - File upload/download tools
 
 2. **Core SDK Wrapper**
-
    - Unified interface for Lighthouse and Kavach SDKs
    - Progress tracking and event emission
    - Error handling and retry logic
@@ -389,7 +382,7 @@ class LighthouseMCPServer extends Server {
           tools: {},
           resources: {},
         },
-      }
+      },
     );
 
     this.setRequestHandler(ListToolsRequestSchema, this.handleListTools);
@@ -402,9 +395,7 @@ class LighthouseMCPServer extends Server {
     };
   }
 
-  private async handleCallTool(
-    request: CallToolRequest
-  ): Promise<CallToolResult> {
+  private async handleCallTool(request: CallToolRequest): Promise<CallToolResult> {
     const { name, arguments: args } = request.params;
 
     switch (name) {
@@ -426,14 +417,12 @@ class LighthouseMCPServer extends Server {
 #### Deliverables:
 
 1. **Enhanced VSCode Extension**
-
    - AI agent command interface
    - Workspace context provider
    - Progress streaming to AI
    - MCP server integration
 
 2. **Cursor IDE Extension**
-
    - Port core functionality to Cursor
    - Cursor-specific UI adaptations
    - AI assistant integration hooks
@@ -468,28 +457,16 @@ export class LighthouseExtension {
 
   private registerAICommands(context: vscode.ExtensionContext) {
     const commands = [
-      vscode.commands.registerCommand(
-        "lighthouse.ai.uploadFile",
-        this.aiUploadFile
-      ),
-      vscode.commands.registerCommand(
-        "lighthouse.ai.createDataset",
-        this.aiCreateDataset
-      ),
-      vscode.commands.registerCommand(
-        "lighthouse.ai.fetchFile",
-        this.aiFetchFile
-      ),
+      vscode.commands.registerCommand("lighthouse.ai.uploadFile", this.aiUploadFile),
+      vscode.commands.registerCommand("lighthouse.ai.createDataset", this.aiCreateDataset),
+      vscode.commands.registerCommand("lighthouse.ai.fetchFile", this.aiFetchFile),
     ];
 
     context.subscriptions.push(...commands);
   }
 
   private async aiUploadFile(params: any) {
-    const result = await this.mcpClient.callTool(
-      "lighthouse_upload_file",
-      params
-    );
+    const result = await this.mcpClient.callTool("lighthouse_upload_file", params);
 
     // Notify AI of completion
     this.aiHooks.notifyCompletion("upload", result);
@@ -506,13 +483,11 @@ export class LighthouseExtension {
 #### Deliverables:
 
 1. **Advanced Encryption Features**
-
    - Threshold encryption with Kavach integration
    - Access condition management
    - Key sharing and revocation
 
 2. **Dataset Management System**
-
    - Version control for datasets
    - ML model lifecycle management
    - Collaborative dataset sharing
@@ -527,10 +502,7 @@ export class LighthouseExtension {
 ```typescript
 // Advanced Encryption Service
 class AdvancedEncryptionService {
-  async encryptWithConditions(
-    file: Buffer,
-    conditions: AccessCondition[]
-  ): Promise<EncryptedFile> {
+  async encryptWithConditions(file: Buffer, conditions: AccessCondition[]): Promise<EncryptedFile> {
     // Generate threshold keys
     const { masterKey, keyShards } = await this.kavach.generate(3, 5);
 
@@ -542,15 +514,15 @@ class AdvancedEncryptionService {
       this.auth.address,
       encryptedContent.cid,
       this.auth.token,
-      conditions
+      conditions,
     );
 
     // Save key shards with conditions
     await this.kavach.saveShards(
       this.auth.address,
       encryptedContent.cid,
       this.auth.token,
-      keyShards
+      keyShards,
     );
 
     return {
@@ -570,13 +542,11 @@ class AdvancedEncryptionService {
 #### Deliverables:
 
 1. **Performance Optimization**
-
    - Caching strategies for AI workflows
    - Batch operations for large datasets
    - Connection pooling and request optimization
 
 2. **Security Hardening**
-
    - Authentication token management
    - Secure key storage for AI agents
    - Rate limiting and abuse prevention
@@ -744,7 +714,6 @@ const claudeLighthouseTools = [
 ### Authentication & Authorization
 
 1. **Multi-layer Authentication**
-
    - API key authentication for Lighthouse services
    - Wallet-based authentication for encryption operations
    - JWT token management with refresh cycles
@@ -757,7 +726,6 @@ const claudeLighthouseTools = [
 ### Data Protection
 
 1. **Encryption at Rest and Transit**
-
    - AES-256 encryption for sensitive data
    - TLS 1.3 for all network communications
    - Threshold cryptography for distributed key management
@@ -770,7 +738,6 @@ const claudeLighthouseTools = [
 ### AI Agent Security
 
 1. **Sandboxed Operations**
-
    - Restrict AI agents to authorized file operations
    - Rate limiting and quota management
    - Audit logging for all AI-initiated actions
@@ -812,9 +779,7 @@ const claudeLighthouseTools = [
    class BatchOperationManager {
      async uploadBatch(files: FileUpload[]): Promise<BatchResult> {
        // Process files in parallel with concurrency limit
-       const results = await Promise.allSettled(
-         files.map((file) => this.uploadWithRetry(file))
-       );
+       const results = await Promise.allSettled(files.map((file) => this.uploadWithRetry(file)));
 
        return this.processBatchResults(results);
      }
@@ -913,7 +878,6 @@ describe("Full Workflow Tests", () => {
 ### Package Distribution
 
 1. **NPM Packages**
-
    - `@lighthouse/mcp-server`: Standalone MCP server
    - `@lighthouse/ide-core`: Shared extension core
    - `@lighthouse/vscode-extension`: VSCode marketplace package

apps/mcp-server/eslint.config.mjs

@@ -0,0 +1,3 @@
+import { config as baseConfig } from "../../tools/eslint-config/base.js";
+
+export default [...baseConfig];

apps/mcp-server/package.json

@@ -1,9 +1,30 @@
 {
   "name": "@lighthouse-tooling/mcp-server",
   "version": "0.1.0",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "clean": "rm -rf dist",
+    "dev": "ts-node src/index.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
   "dependencies": {
     "@lighthouse-tooling/sdk-wrapper": "workspace:*",
     "@lighthouse-tooling/types": "workspace:*",
     "@modelcontextprotocol/sdk": "latest"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "@types/jest": "^29.5.5",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0",
+    "@lighthouse-tooling/shared": "workspace:*"
   }
 }