@lexicallayer/cli 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @lexicallayer/cli
 
-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.
+> Representation Engineering & Authentic Weight Calibration CLI for AI Agents.
+
+## Kurulum ve Kullanım
+
+```bash
+# Kurulum gerektirmeden doğrudan çalıştırma:
+npx @lexicallayer/cli calibrate
+
+# veya global kurulum:
+npm install -g @lexicallayer/cli
+lexicallayer calibrate
+```
+
+## Nasıl Çalışır?
+
+1. CLI çalıştırıldığında bir handshake oturumu başlatır (`lx_sess_...`).
+2. Tarayıcıda LexicalLayer Studio açılır.
+3. Kullanıcı kendi yazılarını, dokümanlarını veya blogunu ekler.
+4. Modelin Rank-16 LoRA $\Delta W$ adaptörü ve Residual Steering vektörleri sentezlenir.
+5. Kullanıcı Studio'da **"Ağırlığı Onayla & Agent'a Kilitle"** butonuna bastığında CLI `.safetensors` dosyasını teslim alarak başarıyla sonlanır.

package/bin/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+/**
+ * @lexicallayer/cli
+ * Representation Engineering & Weight Calibration CLI for AI Agents
+ */
+
+const http = require("http");
+const https = require("https");
+const { exec } = require("child_process");
+
+const args = process.argv.slice(2);
+const command = args[0] || "calibrate";
+
+const STUDIO_BASE_URL = process.env.LEXICALLAYER_STUDIO_URL || "http://localhost:3000";
+const ENGINE_BASE_URL = process.env.LEXICALLAYER_ENGINE_URL || "http://127.0.0.1:8001";
+
+function log(msg) {
+  process.stdout.write(`\x1b[36m[LexicalLayer CLI]\x1b[0m ${msg}\n`);
+}
+
+function requestJSON(url, options = {}, data = null) {
+  return new Promise((resolve, reject) => {
+    const isHttps = url.startsWith("https://");
+    const client = isHttps ? https : http;
+    const urlObj = new URL(url);
+
+    const reqOptions = {
+      hostname: urlObj.hostname,
+      port: urlObj.port || (isHttps ? 443 : 80),
+      path: urlObj.pathname + urlObj.search,
+      method: options.method || "GET",
+      headers: {
+        "Content-Type": "application/json",
+        ...(data ? { "Content-Length": Buffer.byteLength(JSON.stringify(data)) } : {}),
+        ...(options.headers || {})
+      }
+    };
+
+    const req = client.request(reqOptions, (res) => {
+      let body = "";
+      res.on("data", (chunk) => (body += chunk));
+      res.on("end", () => {
+        try {
+          resolve(JSON.parse(body));
+        } catch {
+          resolve({ raw: body });
+        }
+      });
+    });
+
+    req.on("error", reject);
+    if (data) req.write(JSON.stringify(data));
+    req.end();
+  });
+}
+
+function openBrowser(url) {
+  const startCmd = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
+  exec(`${startCmd} "${url}"`);
+}
+
+async function calibrate() {
+  log("\x1b[32mAgent Kimlik Doğrulama ve Ağırlık Kalibrasyonu Başlatılıyor...\x1b[0m");
+
+  const sessionPayload = {
+    agent_name: process.env.AGENT_NAME || "dev-agent",
+    email: process.env.AGENT_EMAIL || "developer@local.workspace"
+  };
+
+  try {
+    const initRes = await requestJSON(`${ENGINE_BASE_URL}/api/session/init`, { method: "POST" }, sessionPayload).catch(() => null);
+    const sessionId = initRes?.session?.id || `lx_sess_${Date.now()}`;
+    const targetUrl = `${STUDIO_BASE_URL}/studio?session=${sessionId}`;
+
+    log(`Oturum Anahtarı: \x1b[33m${sessionId}\x1b[0m`);
+    log(`Tarayıcı Açılıyor: \x1b[34m${targetUrl}\x1b[0m`);
+    log("Kullanıcının Studio üzerinden verilerini girmesi ve ağırlığı onaylaması bekleniyor...");
+
+    openBrowser(targetUrl);
+
+    let approved = false;
+    let attempts = 0;
+    while (!approved && attempts < 180) {
+      await new Promise((r) => setTimeout(r, 2000));
+      attempts++;
+
+      try {
+        const verifyRes = await requestJSON(`${ENGINE_BASE_URL}/api/session/verify/${sessionId}`);
+        if (verifyRes?.session?.approved) {
+          approved = true;
+          log("\n\x1b[32m✓ Başarılı! Kullanıcı Studio üzerinden ağırlıkları onayladı ve kilitledi.\x1b[0m");
+          log(`Bağlanan Adaptör: \x1b[36m${verifyRes.session.adapter_filename || "user_steered_rank16.safetensors"}\x1b[0m`);
+          log("\x1b[32mAgent'ınız artık kullanıcının özgün üslubu ve ağırlıkları ile çalışmaya hazır!\x1b[0m");
+          process.exit(0);
+        }
+      } catch {
+        // Retry
+      }
+      process.stdout.write(".");
+    }
+
+    if (!approved) {
+      log("\n\x1b[31mOturum zaman aşımına uğradı.\x1b[0m");
+      process.exit(1);
+    }
+  } catch (err) {
+    log(`\x1b[31mHata:\x1b[0m ${err.message}`);
+    process.exit(1);
+  }
+}
+
+if (command === "calibrate") {
+  calibrate();
+} else if (command === "--version" || command === "-v") {
+  console.log("0.1.0");
+} else {
+  console.log(`
+LexicalLayer CLI
+Kullanım:
+  lexicallayer calibrate       Studio arayüzünü açar ve agent için ağırlık türetir
+  lexicallayer --version       Versiyon bilgisi
+`);
+}

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@lexicallayer/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "LexicalLayer CLI - Representation engineering and authentic weight calibration for AI agents",
+  "main": "bin/index.js",
+  "bin": {
+    "lexicallayer": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "agents",
+    "lora",
+    "safetensors",
+    "steering-vectors",
+    "representation-engineering",
+    "llm"
+  ],
+  "author": "LexicalLayer Team",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  }
+}