@n2world/core 1.1.0

package/index.d.ts

@@ -0,0 +1,65 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export declare function helloWorld(input: string): string
+export declare function lockSharedBuffer(buf: Uint8Array): boolean
+export declare function unlockSharedBuffer(buf: Uint8Array): boolean
+export declare function computeCosineSimilarity(buf: Uint8Array, offsetA: number, offsetB: number, dimensions: number): number
+export declare function readMetaTuple(buf: Uint8Array): string
+export declare function pruneActions(actions: Array<string>, invalidPatterns: Array<string>): Array<string>
+/**
+ * cgroups v2 `cpu.weight` 실제 기입(Linux). 경로가 없거나 권한이 없으면 false 를 반환한다.
+ * 정직 원칙: 비-Linux/비-cgroup 환경에서 "거짓 true"를 돌려주지 않는다(거짓 폴백 금지).
+ * 유효 범위는 cgroups v2 규격상 1..=10000.
+ */
+export declare function setCgroupCpuWeight(cgroupPath: string, weight: number): boolean
+/** 이 시스템에 cgroups v2 단일 계층이 마운트되어 있는가(Linux). 호출자는 이걸로 폴백을 결정한다. */
+export declare function cgroupV2Available(): boolean
+export declare class MctsEngine {
+  constructor(goalX: number, goalY: number)
+  /** 탐험/활용 상수 c_puct 조정(이후 스윕 대상). */
+  setCPuct(c: number): void
+  /** 사전확률 모드: 0 = L0(균등, UCT 퇴화 베이스라인), 1 = L1(휴리스틱). */
+  setPriorMode(mode: number): void
+  /** 동기 MCTS: 진짜 트리를 세워 simulations 회 탐색 후 최선 행동을 반환. */
+  search(startX: number, startY: number, simulations: number): number
+  /** 루트 정규화 가치 v∈[0,1] (스케줄러로 흘려보낼 가치 신호의 발원). */
+  rootValue(): number
+  /** 7-0a top-k 노출(P1 투기적 선실행용): 방문수 상위 행동을 JSON 배열로. */
+  topActionsJson(): string
+  /** 탐색 시작: 영속 트리 초기화(Freeze 대상 상태를 struct에 보존). */
+  begin(startX: number, startY: number): void
+  /**
+   * 1단계(g_fast) 시뮬레이션을 budget회 수행하되, 1·2위 가치차가 margin 미만으로
+   * 불확실해지면 그 리프를 동결(Freeze)하고 제어권을 양보(Yield) — JSON 요청 반환.
+   * 스레드를 블로킹하지 않는다. {"yield":true,...} 또는 {"done":true,...}.
+   */
+  stepUntilYield(budget: number, margin: number): string
+  /** 2단계(LLM) 결과 value∈[0,1]를 받아 동결됐던 리프부터 백업하고 탐색 재개(Resume). */
+  resume(value: number): boolean
+  /**
+   * 비동기 탐색: 진짜 MCTS를 워커 스레드에서 수행하고 실제 최선 행동을 콜백으로 전달
+   * (기존 sleep+문자열 스텁 제거).
+   */
+  searchAsync(startX: number, startY: number, callback: (err: Error | null, arg: string) => any): void
+}
+export declare class HnswIndex {
+  constructor()
+  addItem(filePath: string, vector: Array<number>): void
+  /** 진짜 HNSW 탐색: 상위층 강하 후 층0 빔서치 → top-k 파일 경로. */
+  search(queryVector: Array<number>, topK: number): Array<string>
+  /** 탐색 + 방문 노드 수(JSON). visited << N 이면 전수 스캔이 아님을 증명. */
+  searchWithStats(queryVector: Array<number>, topK: number): string
+  /** recall 비교용 기준선(전수 코사인). HNSW 가 아님 — 정확도 평가에만 사용. */
+  searchBruteforce(queryVector: Array<number>, topK: number): Array<string>
+  len(): number
+}
+export declare class EbpfMapScheduler {
+  constructor()
+  /** MCTS 가치 v 를 thread_id 키로 BPF 맵에 실제 주입. 맵 비활성이면 false. */
+  updateEbpfMap(threadId: number, mctsV: number): boolean
+  /** 실제 BPF 맵이 활성인가(Linux + CAP_BPF). 비-Linux/비-권한이면 false. */
+  mapActive(): boolean
+}

package/index.js

@@ -0,0 +1,325 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'n2world-core.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.android-arm64.node')
+          } else {
+            nativeBinding = require('@n2world/core-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'n2world-core.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@n2world/core-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'n2world-core.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@n2world/core-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'n2world-core.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@n2world/core-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'n2world-core.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@n2world/core-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'n2world-core.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./n2world-core.darwin-universal.node')
+      } else {
+        nativeBinding = require('@n2world/core-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'n2world-core.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.darwin-x64.node')
+          } else {
+            nativeBinding = require('@n2world/core-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'n2world-core.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@n2world/core-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'n2world-core.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./n2world-core.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@n2world/core-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'n2world-core.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./n2world-core.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@n2world/core-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'n2world-core.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./n2world-core.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@n2world/core-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { helloWorld, lockSharedBuffer, unlockSharedBuffer, computeCosineSimilarity, readMetaTuple, MctsEngine, pruneActions, HnswIndex, setCgroupCpuWeight, cgroupV2Available, EbpfMapScheduler } = nativeBinding
+
+module.exports.helloWorld = helloWorld
+module.exports.lockSharedBuffer = lockSharedBuffer
+module.exports.unlockSharedBuffer = unlockSharedBuffer
+module.exports.computeCosineSimilarity = computeCosineSimilarity
+module.exports.readMetaTuple = readMetaTuple
+module.exports.MctsEngine = MctsEngine
+module.exports.pruneActions = pruneActions
+module.exports.HnswIndex = HnswIndex
+module.exports.setCgroupCpuWeight = setCgroupCpuWeight
+module.exports.cgroupV2Available = cgroupV2Available
+module.exports.EbpfMapScheduler = EbpfMapScheduler

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@n2world/core",
+  "version": "1.1.0",
+  "description": "N2World 네이티브 코어 — MCTS·HNSW·코루틴·cgroups/eBPF (napi-rs)",
+  "license": "MIT",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suhopark1-tech/n2world.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "napi": {
+    "name": "n2world-core",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-apple-darwin",
+        "aarch64-apple-darwin",
+        "x86_64-pc-windows-msvc",
+        "aarch64-pc-windows-msvc"
+      ]
+    }
+  },
+  "scripts": {
+    "napi": "napi",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "node -e \"if(!require('fs').readdirSync('.').some(f=>f.endsWith('.node')))throw new Error('publish 거부: .node 프리빌트가 없습니다(번들 전략). release.yml가 전 플랫폼 .node를 수집한 뒤 publish해야 합니다.')\"",
+    "artifacts": "napi artifacts",
+    "universal": "napi universal",
+    "version": "napi version"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4"
+  }
+}