n2-qln 3.2.0 → 3.3.1

package/README.ko.md

@@ -380,7 +380,7 @@ module.exports = {
 };
 ```
 
-[n2-soul 클라우드 스토리지](https://github.com/choihyunsus/n2-soul#%EF%B8%8F-cloud-storage--store-your-ai-memory-anywhere)와 동일한 방식입니다. SQLite 파일이 해당 폴더에 저장되고, 동기화 서비스가 나머지를 처리합니다.
+[n2-soul 클라우드 스토리지](https://github.com/choihyunsus/soul#%EF%B8%8F-cloud-storage--store-your-ai-memory-anywhere)와 동일한 방식입니다. SQLite 파일이 해당 폴더에 저장되고, 동기화 서비스가 나머지를 처리합니다.
 
 ---
 
@@ -420,11 +420,11 @@ n2-qln/
 
 | 프로젝트 | 관계 |
 |---------|------|
-| [n2-soul](https://github.com/choihyunsus/n2-soul) | AI 에이전트 오케스트레이터 — QLN은 Soul의 "도구 브레인" 역할 |
+| [n2-soul](https://github.com/choihyunsus/soul) | AI 에이전트 오케스트레이터 — QLN은 Soul의 "도구 브레인" 역할 |
 
 ## 실전 검증 완료
 
-주말 프로토타입이 아닙니다. QLN은 **2개월 이상 운영 환경에서 검증**되었으며, [n2-soul](https://github.com/choihyunsus/n2-soul)의 핵심 도구 라우터로 매일 실사용되고 있습니다.
+주말 프로토타입이 아닙니다. QLN은 **2개월 이상 운영 환경에서 검증**되었으며, [n2-soul](https://github.com/choihyunsus/soul)의 핵심 도구 라우터로 매일 실사용되고 있습니다.
 
 **Rose** 🌹 제작 — N2의 첫 번째 AI 에이전트. 하루에 수백 번 QLN을 통해 라우팅합니다.
 

package/README.md

@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-Same approach as [n2-soul Cloud Storage](https://github.com/choihyunsus/n2-soul#%EF%B8%8F-cloud-storage--store-your-ai-memory-anywhere). SQLite file lives in that folder — your sync service handles the rest.
+Same approach as [n2-soul Cloud Storage](https://github.com/choihyunsus/soul#%EF%B8%8F-cloud-storage--store-your-ai-memory-anywhere). SQLite file lives in that folder — your sync service handles the rest.
 
 ---
 
@@ -440,11 +440,11 @@ n2-qln/
 
 | Project | Relationship |
 |---------|-------------|
-| [n2-soul](https://github.com/choihyunsus/n2-soul) | AI agent orchestrator — QLN serves as Soul's "tool brain" |
+| [n2-soul](https://github.com/choihyunsus/soul) | AI agent orchestrator — QLN serves as Soul's "tool brain" |
 
 ## Built & Battle-Tested
 
-This isn't a weekend prototype. QLN has been **tested in production for 2+ months** and is actively used every day as the core tool router for [n2-soul](https://github.com/choihyunsus/n2-soul).
+This isn't a weekend prototype. QLN has been **tested in production for 2+ months** and is actively used every day as the core tool router for [n2-soul](https://github.com/choihyunsus/soul).
 
 Written by **Rose** 🌹 — N2's first AI agent, and the one who routes through QLN hundreds of times a day.
 

package/index.js

@@ -6,6 +6,7 @@ const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio
 const { z } = require('zod');
 
 // Core
+const path = require('path');
 const { loadConfig } = require('./lib/config');
 const { Store } = require('./lib/store');
 const { Embedding } = require('./lib/embedding');
@@ -13,6 +14,7 @@ const { Registry } = require('./lib/registry');
 const { VectorIndex } = require('./lib/vector-index');
 const { Router } = require('./lib/router');
 const { Executor } = require('./lib/executor');
+const { loadProviders } = require('./lib/provider-loader');
 
 // MCP Tool (unified)
 const { registerQlnCall } = require('./tools/qln-call');
@@ -31,6 +33,18 @@ async function main() {
     const registry = new Registry(store, embedding);
     registry.load();
 
+    // 1.5. Provider auto-indexing (providers/*.json → registry)
+    if (config.providers?.enabled !== false) {
+        const provDir = config.providers?.dir || path.join(__dirname, 'providers');
+        const provResult = loadProviders(provDir, registry);
+        if (provResult.loaded > 0) {
+            console.error(`[QLN] Providers: ${provResult.loaded} tools from ${provResult.details.filter(d => d.status === 'loaded').length} files`);
+        }
+        if (provResult.failed > 0) {
+            console.error(`[QLN] Provider warnings: ${provResult.failed} files failed to load`);
+        }
+    }
+
     const vectorIndex = new VectorIndex();
     const router = new Router(registry, vectorIndex, embedding);
     const executor = new Executor(config.executor || {});

package/lib/config.js

@@ -20,6 +20,12 @@ const defaults = {
         timeout: 20000,
     },
 
+    /** Provider manifest auto-indexing */
+    providers: {
+        enabled: true,
+        dir: path.join(__dirname, '..', 'providers'),
+    },
+
     /** Search configuration */
     search: {
         defaultTopK: 5,

package/lib/provider-loader.js

@@ -0,0 +1,126 @@
+// QLN — Provider manifest loader (providers/*.json → registry auto-registration)
+const fs = require('fs');
+const path = require('path');
+const { inferCategory } = require('./schema');
+
+/**
+ * Required fields for a valid provider manifest.
+ * @type {string[]}
+ */
+const REQUIRED_MANIFEST_FIELDS = ['provider', 'tools'];
+
+/**
+ * Required fields for each tool entry within a manifest.
+ * @type {string[]}
+ */
+const REQUIRED_TOOL_FIELDS = ['name', 'description'];
+
+/**
+ * Load all provider manifests from a directory and register their tools.
+ *
+ * @param {string} providersDir - Absolute path to providers/ directory
+ * @param {import('./registry').Registry} registry - QLN registry instance
+ * @returns {{ loaded: number, skipped: number, failed: number, details: object[] }}
+ */
+function loadProviders(providersDir, registry) {
+    const result = { loaded: 0, skipped: 0, failed: 0, details: [] };
+
+    if (!fs.existsSync(providersDir)) return result;
+
+    /** @type {string[]} */
+    const files = fs.readdirSync(providersDir)
+        .filter(f => f.endsWith('.json'));
+
+    if (files.length === 0) return result;
+
+    for (const file of files) {
+        const filePath = path.join(providersDir, file);
+        try {
+            const manifest = _parseManifest(filePath);
+            if (!manifest) {
+                result.skipped++;
+                result.details.push({ file, status: 'skipped', reason: 'invalid manifest' });
+                continue;
+            }
+
+            const tools = _normalizeTools(manifest);
+            if (tools.length === 0) {
+                result.skipped++;
+                result.details.push({ file, status: 'skipped', reason: 'no valid tools' });
+                continue;
+            }
+
+            // Idempotent: purge old entries from this provider before re-registering
+            registry.purgeBySource(`provider:${manifest.provider}`);
+
+            const count = registry.registerBatch(tools);
+            result.loaded += count;
+            result.details.push({
+                file,
+                status: 'loaded',
+                provider: manifest.provider,
+                toolCount: count,
+            });
+        } catch (err) {
+            result.failed++;
+            result.details.push({ file, status: 'failed', reason: err.message });
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Parse and validate a manifest JSON file.
+ *
+ * @param {string} filePath - Absolute path to JSON file
+ * @returns {object|null} Parsed manifest or null if invalid
+ */
+function _parseManifest(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const manifest = JSON.parse(raw);
+
+    // Validate required fields
+    for (const field of REQUIRED_MANIFEST_FIELDS) {
+        if (!manifest[field]) return null;
+    }
+
+    // tools must be a non-empty array
+    if (!Array.isArray(manifest.tools)) return null;
+
+    return manifest;
+}
+
+/**
+ * Normalize tool entries from a manifest for registry registration.
+ * Injects provider metadata and assigns source = "provider:{name}".
+ *
+ * @param {object} manifest - Validated manifest object
+ * @returns {object[]} Array of normalized tool entries ready for registerBatch()
+ */
+function _normalizeTools(manifest) {
+    const providerName = manifest.provider;
+    const tools = [];
+
+    for (const raw of manifest.tools) {
+        // Skip tools missing required fields
+        if (!raw.name || !raw.description) continue;
+
+        tools.push({
+            name: raw.name,
+            description: raw.description,
+            source: `provider:${providerName}`,
+            category: raw.category || inferCategory(raw.name, 'provider'),
+            provider: providerName,
+            inputSchema: raw.inputSchema || null,
+            triggers: raw.triggers || undefined, // let schema.js extract
+            tags: raw.tags || [],
+            examples: raw.examples || [],
+            endpoint: raw.endpoint || '',
+        });
+    }
+
+    return tools;
+}
+
+module.exports = { loadProviders };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "n2-qln",
-    "version": "3.2.0",
+    "version": "3.3.1",
     "description": "Query Layer Network — Semantic tool dispatcher for MCP. Route 1000 tools through 1 router.",
     "main": "index.js",
     "bin": {