n2-clotho 2.0.0 → 2.0.2

package/README.md

@@ -1,5 +1,8 @@
 # 🧵 Clotho — The Thread of Fate for AI Agents
 
+[![npm version](https://img.shields.io/npm/v/n2-clotho.svg)](https://www.npmjs.com/package/n2-clotho)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
 > **Markdown rules are dead. Long live `.n2`.**
 
 Clotho is a compiled instruction language for AI agents. It replaces fragile markdown-based rules (GEMINI.md, .cursorrules, CLAUDE.md) with **enforceable, type-checked, deterministic** specifications that agents cannot ignore.
@@ -74,8 +77,24 @@ Clotho introduces `.n2` — a compiled instruction language with:
 
 ### Installation
 
+> 💡 **The easiest way to get started?** Just ask your AI to write a `.n2` file for you.
+
+```bash
+# npm (WASM — use in Node.js)
+npm install n2-clotho
+```
+
+```javascript
+// Usage in Node.js
+const { parse_n2_wasm, validate_n2_wasm, query_n2_wasm } = require('n2-clotho');
+
+const ast = parse_n2_wasm(n2Source);        // Parse → AST JSON
+const result = validate_n2_wasm(n2Source);  // Validate → errors/warnings
+const table = query_n2_wasm(n2Source, 'SELECT * FROM rules');  // SQL query
+```
+
 ```bash
-# From source (Rust required)
+# From source (Rust required — full CLI)
 git clone https://github.com/choihyunsus/n2-clotho.git
 cd n2-clotho/compiler
 cargo build --release
@@ -431,6 +450,7 @@ Apache-2.0 — Free to use, modify, and distribute.
 
 ## 🔗 Links
 
+- [**npm: n2-clotho**](https://www.npmjs.com/package/n2-clotho) — WASM bindings for Node.js
 - [N2 Soul](https://github.com/choihyunsus/soul) — Agent memory & runtime
 - [N2 Arachne](https://github.com/choihyunsus/n2-arachne) — Code context assembly
 - [N2 QLN](https://github.com/choihyunsus/n2-qln) — Tool orchestration & routing

package/n2_compiler.d.ts

@@ -1,2 +1,27 @@
 /* tslint:disable */
 /* eslint-disable */
+
+/**
+ * Extract blacklist patterns from .n2 source — returns JSON array
+ */
+export function extract_blacklist_wasm(source: string): string;
+
+/**
+ * Get compiler version info
+ */
+export function n2c_version(): string;
+
+/**
+ * Parse .n2 source and return AST as JSON string
+ */
+export function parse_n2_wasm(source: string): string;
+
+/**
+ * Query .n2 source with SQL — returns formatted table string
+ */
+export function query_n2_wasm(source: string, sql: string): string;
+
+/**
+ * Validate .n2 source — returns JSON with errors/warnings
+ */
+export function validate_n2_wasm(source: string): string;

package/n2_compiler.js

@@ -1,8 +1,142 @@
 /* @ts-self-types="./n2_compiler.d.ts" */
 
+/**
+ * Extract blacklist patterns from .n2 source — returns JSON array
+ * @param {string} source
+ * @returns {string}
+ */
+function extract_blacklist_wasm(source) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.extract_blacklist_wasm(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+exports.extract_blacklist_wasm = extract_blacklist_wasm;
+
+/**
+ * Get compiler version info
+ * @returns {string}
+ */
+function n2c_version() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.n2c_version();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.n2c_version = n2c_version;
+
+/**
+ * Parse .n2 source and return AST as JSON string
+ * @param {string} source
+ * @returns {string}
+ */
+function parse_n2_wasm(source) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.parse_n2_wasm(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+exports.parse_n2_wasm = parse_n2_wasm;
+
+/**
+ * Query .n2 source with SQL — returns formatted table string
+ * @param {string} source
+ * @param {string} sql
+ * @returns {string}
+ */
+function query_n2_wasm(source, sql) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(sql, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.query_n2_wasm(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+exports.query_n2_wasm = query_n2_wasm;
+
+/**
+ * Validate .n2 source — returns JSON with errors/warnings
+ * @param {string} source
+ * @returns {string}
+ */
+function validate_n2_wasm(source) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.validate_n2_wasm(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+exports.validate_n2_wasm = validate_n2_wasm;
+
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return ret;
+        },
         __wbindgen_init_externref_table: function() {
             const table = wasm.__wbindgen_externrefs;
             const offset = table.grow(4);
@@ -19,6 +153,83 @@ function __wbg_get_imports() {
     };
 }
 
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return decodeText(ptr, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+function decodeText(ptr, len) {
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
 const wasmPath = `${__dirname}/n2_compiler_bg.wasm`;
 const wasmBytes = require('fs').readFileSync(wasmPath);
 const wasmModule = new WebAssembly.Module(wasmBytes);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "n2-clotho",
   "description": "🧵 Compiled instruction language for AI agents. Replace GEMINI.md, .cursorrules, CLAUDE.md with enforceable .n2 rules.",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",