@rotifer/playground 0.8.0 → 0.8.5

package/dist/utils/update-check.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMajorUpgrade = isMajorUpgrade;
+exports.checkForUpdate = checkForUpdate;
+exports.checkCacheSync = checkCacheSync;
+exports.printUpdateNotification = printUpdateNotification;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const palette_js_1 = require("./palette.js");
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+function getConfigDir() {
+    return process.env.ROTIFER_CONFIG_DIR || (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "rotifer");
+}
+function getCacheFile() {
+    return (0, node_path_1.join)(getConfigDir(), "update-check.json");
+}
+const REGISTRY_URL = "https://registry.npmjs.org";
+const FETCH_TIMEOUT_MS = 5000;
+function shouldSkip() {
+    if (process.env.CI)
+        return true;
+    if (process.env.NO_UPDATE_NOTIFIER)
+        return true;
+    if (process.env.ROTIFER_NO_UPDATE_CHECK)
+        return true;
+    if (isRunViaNpx())
+        return true;
+    return false;
+}
+function isRunViaNpx() {
+    const execPath = process.env.npm_execpath || "";
+    const npmCommand = process.env.npm_command || "";
+    return execPath.includes("npx") || npmCommand === "exec";
+}
+function readCache() {
+    try {
+        const f = getCacheFile();
+        if ((0, node_fs_1.existsSync)(f)) {
+            return JSON.parse((0, node_fs_1.readFileSync)(f, "utf-8"));
+        }
+    }
+    catch { /* corrupt cache, regenerate */ }
+    return {};
+}
+function writeCache(cache) {
+    try {
+        (0, node_fs_1.mkdirSync)(getConfigDir(), { recursive: true });
+        (0, node_fs_1.writeFileSync)(getCacheFile(), JSON.stringify(cache, null, 2));
+    }
+    catch { /* non-critical */ }
+}
+async function fetchLatestVersion(pkgName) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const res = await fetch(`${REGISTRY_URL}/${encodeURIComponent(pkgName)}/latest`, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareSemver(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) > (pb[i] || 0))
+            return 1;
+        if ((pa[i] || 0) < (pb[i] || 0))
+            return -1;
+    }
+    return 0;
+}
+function isMajorUpgrade(current, latest) {
+    const curMajor = parseInt(current.split(".")[0], 10);
+    const latMajor = parseInt(latest.split(".")[0], 10);
+    return latMajor > curMajor;
+}
+/**
+ * Non-blocking version check against npm registry.
+ * Returns update info if a newer version exists, null otherwise.
+ * Caches results for 24 hours. Never throws — fails silently.
+ */
+async function checkForUpdate(pkgName, currentVersion) {
+    if (shouldSkip())
+        return null;
+    try {
+        const cache = readCache();
+        const entry = cache[pkgName];
+        if (entry && Date.now() - entry.lastCheck < CHECK_INTERVAL_MS) {
+            if (compareSemver(entry.latest, currentVersion) > 0) {
+                return { current: currentVersion, latest: entry.latest, isMajor: isMajorUpgrade(currentVersion, entry.latest) };
+            }
+            return null;
+        }
+        const latest = await fetchLatestVersion(pkgName);
+        if (!latest)
+            return null;
+        cache[pkgName] = { lastCheck: Date.now(), latest };
+        writeCache(cache);
+        if (compareSemver(latest, currentVersion) > 0) {
+            return { current: currentVersion, latest, isMajor: isMajorUpgrade(currentVersion, latest) };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Synchronous cache-only check. Returns UpdateInfo if cache is fresh and
+ * a newer version exists, null otherwise. Never hits the network.
+ * Use this to register process.on("exit") handlers that survive process.exit().
+ */
+function checkCacheSync(pkgName, currentVersion) {
+    if (shouldSkip())
+        return null;
+    try {
+        const cache = readCache();
+        const entry = cache[pkgName];
+        if (entry && compareSemver(entry.latest, currentVersion) > 0) {
+            return { current: currentVersion, latest: entry.latest, isMajor: isMajorUpgrade(currentVersion, entry.latest) };
+        }
+    }
+    catch { /* non-critical */ }
+    return null;
+}
+function printUpdateNotification(info, pkgName) {
+    const border = palette_js_1.c.warn(palette_js_1.icon.dash.repeat(50));
+    console.error("");
+    console.error(border);
+    console.error(palette_js_1.c.warn("  Update available: ") +
+        palette_js_1.c.error(info.current) +
+        palette_js_1.c.warn(` ${palette_js_1.icon.arrow} `) +
+        palette_js_1.c.success(info.latest));
+    if (info.isMajor) {
+        console.error(palette_js_1.c.error(`  ${palette_js_1.icon.warn} Major version upgrade — review breaking changes first`));
+    }
+    console.error(palette_js_1.c.warn("  Run ") +
+        palette_js_1.c.accent(`npm i -g ${pkgName}@latest`) +
+        palette_js_1.c.warn(" to update"));
+    console.error(palette_js_1.c.warn("  Or: ") +
+        palette_js_1.c.accent("rotifer self-update"));
+    console.error(border);
+    console.error("");
+}
+//# sourceMappingURL=update-check.js.map

package/dist/utils/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/utils/update-check.ts"],"names":[],"mappings":"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"}

package/dist/utils/user-config.d.ts

@@ -0,0 +1,10 @@
+export interface UserConfig {
+    "update-check"?: boolean;
+    "last-version"?: string;
+}
+export declare function isValidKey(key: string): key is keyof UserConfig;
+export declare function loadUserConfig(): UserConfig;
+export declare function saveUserConfig(config: UserConfig): void;
+export declare function getUserConfigValue(key: keyof UserConfig): string;
+export declare function setUserConfigValue(key: keyof UserConfig, value: string): void;
+//# sourceMappingURL=user-config.d.ts.map

package/dist/utils/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,MAAM,UAAU,CAE/D;AAED,wBAAgB,cAAc,IAAI,UAAU,CAQ3C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGvD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,GAAG,MAAM,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7E"}

package/dist/utils/user-config.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidKey = isValidKey;
+exports.loadUserConfig = loadUserConfig;
+exports.saveUserConfig = saveUserConfig;
+exports.getUserConfigValue = getUserConfigValue;
+exports.setUserConfigValue = setUserConfigValue;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+function getConfigDir() {
+    return process.env.ROTIFER_CONFIG_DIR || (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "rotifer");
+}
+function getUserConfigFile() {
+    return (0, node_path_1.join)(getConfigDir(), "config.json");
+}
+const DEFAULTS = {
+    "update-check": true,
+    "last-version": "",
+};
+const VALID_KEYS = new Set(["update-check", "last-version"]);
+function isValidKey(key) {
+    return VALID_KEYS.has(key);
+}
+function loadUserConfig() {
+    try {
+        const f = getUserConfigFile();
+        if ((0, node_fs_1.existsSync)(f)) {
+            return JSON.parse((0, node_fs_1.readFileSync)(f, "utf-8"));
+        }
+    }
+    catch { /* corrupt config, use defaults */ }
+    return {};
+}
+function saveUserConfig(config) {
+    (0, node_fs_1.mkdirSync)(getConfigDir(), { recursive: true });
+    (0, node_fs_1.writeFileSync)(getUserConfigFile(), JSON.stringify(config, null, 2) + "\n");
+}
+function getUserConfigValue(key) {
+    const config = loadUserConfig();
+    const val = config[key] ?? DEFAULTS[key];
+    return String(val);
+}
+function setUserConfigValue(key, value) {
+    const config = loadUserConfig();
+    if (key === "update-check") {
+        config[key] = value === "true" || value === "1";
+    }
+    else {
+        config[key] = value;
+    }
+    saveUserConfig(config);
+}
+//# sourceMappingURL=user-config.js.map

package/dist/utils/user-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":";;AAwBA,gCAEC;AAED,wCAQC;AAED,wCAGC;AAED,gDAIC;AAED,gDAQC;AAzDD,qCAA6E;AAC7E,yCAAiC;AACjC,qCAAkC;AAElC,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAA,gBAAI,EAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAOD,MAAM,QAAQ,GAAyB;IACrC,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;AAE/E,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,GAAG,CAAC,GAAuB,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;QAC9B,IAAI,IAAA,oBAAU,EAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,cAAc,CAAC,MAAkB;IAC/C,IAAA,mBAAS,EAAC,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAA,uBAAa,EAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB;IACtD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;IAClD,CAAC;SAAM,CAAC;QACL,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/validate-gene-name.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validate a gene name for safe filesystem and API usage.
+ * Rejects path traversal sequences, path separators, and non-conforming names.
+ * @throws Error if the name is invalid
+ */
+export declare function validateGeneName(name: string): void;
+//# sourceMappingURL=validate-gene-name.d.ts.map

package/dist/utils/validate-gene-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-gene-name.d.ts","sourceRoot":"","sources":["../../src/utils/validate-gene-name.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkBnD"}

package/dist/utils/validate-gene-name.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGeneName = validateGeneName;
+const GENE_NAME_REGEX = /^[a-z0-9]([a-z0-9._-]*[a-z0-9])?$/;
+const MAX_GENE_NAME_LENGTH = 100;
+/**
+ * Validate a gene name for safe filesystem and API usage.
+ * Rejects path traversal sequences, path separators, and non-conforming names.
+ * @throws Error if the name is invalid
+ */
+function validateGeneName(name) {
+    if (!name || typeof name !== "string") {
+        throw new Error("Gene name must be a non-empty string");
+    }
+    if (name.length > MAX_GENE_NAME_LENGTH) {
+        throw new Error(`Gene name exceeds ${MAX_GENE_NAME_LENGTH} characters: "${name}"`);
+    }
+    if (name.includes("..")) {
+        throw new Error(`Gene name must not contain "..": "${name}"`);
+    }
+    if (name.includes("/") || name.includes("\\") || name.includes("\0")) {
+        throw new Error(`Gene name must not contain path separators or null bytes: "${name}"`);
+    }
+    if (!GENE_NAME_REGEX.test(name)) {
+        throw new Error(`Gene name "${name}" does not match required pattern: lowercase alphanumeric, dots, hyphens, underscores. Must start and end with alphanumeric.`);
+    }
+}
+//# sourceMappingURL=validate-gene-name.js.map

package/dist/utils/validate-gene-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-gene-name.js","sourceRoot":"","sources":["../../src/utils/validate-gene-name.ts"],"names":[],"mappings":";;AAQA,4CAkBC;AA1BD,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAC5D,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,oBAAoB,iBAAiB,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,GAAG,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,8HAA8H,CACjJ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/genes/genesis-code-format/phenotype.json

@@ -18,13 +18,14 @@
     }
   },
   "dependencies": [],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "rotifer-genesis",
   "fidelity": "Native",
   "transparency": "Open",
-  "semantic_requirements": {
+  "semanticRequirements": {
     "timeModel": "Sync",
     "concurrencyModel": "Stateless",
     "failureSemantics": "Fail"
-  }
+  },
+  "tags": ["formatter", "prettier", "typescript", "rust", "genesis"]
 }

package/genes/genesis-file-read/phenotype.json

@@ -18,13 +18,14 @@
     }
   },
   "dependencies": [],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "rotifer-genesis",
   "fidelity": "Native",
   "transparency": "Open",
-  "semantic_requirements": {
+  "semanticRequirements": {
     "timeModel": "Sync",
     "concurrencyModel": "Stateless",
     "failureSemantics": "Fail"
-  }
+  },
+  "tags": ["file-io", "encoding", "base64", "local-files", "genesis"]
 }

package/genes/genesis-l0-constraint/phenotype.json

@@ -26,13 +26,14 @@
     }
   },
   "dependencies": [],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "rotifer-genesis",
   "fidelity": "Native",
   "transparency": "Open",
-  "semantic_requirements": {
+  "semanticRequirements": {
     "timeModel": "Sync",
     "concurrencyModel": "Stateless",
     "failureSemantics": "Fail"
-  }
+  },
+  "tags": ["l0", "constraints", "wasm", "compliance", "sandbox"]
 }

package/genes/genesis-web-search/phenotype.json

@@ -28,14 +28,15 @@
     }
   },
   "dependencies": [],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "rotifer-genesis",
   "fidelity": "Native",
   "transparency": "Open",
-  "streaming_capability": null,
-  "semantic_requirements": {
+  "streamingCapability": null,
+  "semanticRequirements": {
     "timeModel": "Async",
     "concurrencyModel": "Stateless",
     "failureSemantics": "Retry"
-  }
+  },
+  "tags": ["web-search", "results", "snippets", "async", "retrieval"]
 }

package/genes/genesis-web-search-lite/phenotype.json

@@ -16,13 +16,14 @@
     }
   },
   "dependencies": [],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "rotifer-genesis",
   "fidelity": "Native",
   "transparency": "Open",
-  "semantic_requirements": {
+  "semanticRequirements": {
     "timeModel": "Async",
     "concurrencyModel": "Stateless",
     "failureSemantics": "Fallback"
-  }
+  },
+  "tags": ["web-search", "single-answer", "attribution", "lightweight", "async"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.8.0",
+  "version": "0.8.5",
   "description": "Rotifer Protocol Playground — local development environment for gene development, Arena competition, and protocol simulation",
   "license": "Apache-2.0",
   "author": "Rotifer Protocol Contributors",
@@ -33,32 +33,52 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "build": "tsc",
     "build:napi": "cd crates/rotifer-napi && napi build --release",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "sync:plugins": "node scripts/sync-plugin-outputs.mjs",
+    "check:plugins": "node scripts/check-plugin-outputs.mjs",
+    "verify:plugins": "node scripts/verify-plugin-packaging.mjs",
+    "verify:versions": "node scripts/verify-version-alignment.mjs",
+    "bump:plugin-family": "node scripts/bump-plugin-family.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "lint": "tsc --noEmit",
+    "lint": "tsc --noEmit && eslint src/",
+    "lint:names": "eslint src/ --rule '@typescript-eslint/naming-convention: error'",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run lint && npm run test && npm run build",
+    "smoke-test": "npx tsx scripts/post-deploy-smoke-test.ts",
+    "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "npm run verify:versions && npm run lint && npm run test && npm run build",
     "prepack": "npm run build"
   },
   "dependencies": {
+    "@clack/prompts": "^1.2.0",
     "ajv": "^8.17.0",
     "ajv-formats": "^3.0.0",
     "chalk": "^4.1.2",
-    "cli-table3": "^0.6.5",
-    "commander": "^13.0.0",
-    "pg": "^8.20.0"
+    "commander": "^14.0.0"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.5.1",
+    "@napi-rs/cli": "^3.6.0",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.1.2",
+    "eslint": "^10.1.0",
     "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^4.0.0"
+  },
+  "optionalDependencies": {
+    "@rolldown/binding-linux-x64-gnu": "1.0.0-rc.13"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -67,6 +87,7 @@
     "dist/",
     "templates/",
     "genes/",
+    "scripts/postinstall.js",
     "LICENSE",
     "README.md",
     "CHANGELOG.md"

package/scripts/postinstall.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+"use strict";
+
+if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) process.exit(0);
+if (["silent", "warn"].includes(process.env.npm_config_loglevel)) process.exit(0);
+
+let version = "0.0.0";
+try {
+  version = require("../package.json").version;
+} catch {
+  // fallback
+}
+
+const a = "\x1b[38;2;0;201;167m"; // accent #00C9A7
+const d = "\x1b[2m";              // dim
+const b = "\x1b[1m";              // bold
+const r = "\x1b[0m";              // reset
+
+const logo = [
+  "   ____       _   _  __",
+  "  |  _ \\ ___ | |_(_)/ _| ___ _ __",
+  "  | |_) / _ \\| __| | |_ / _ \\ '__|",
+  "  |  _ < (_) | |_| |  _|  __/ |",
+  "  |_| \\_\\___/ \\__|_|_|  \\___|_|   v" + version,
+];
+
+console.log("");
+for (const line of logo) console.log("  " + a + line + r);
+console.log("");
+console.log("  " + a + b + "Code as Gene" + r + " " + d + "— Universal evolution framework for AI agents" + r);
+console.log("");
+console.log("  " + d + "Get started:" + r);
+console.log("    " + a + "rotifer init my-project    " + r + " " + d + "Create a new project" + r);
+console.log("    " + a + "rotifer search             " + r + " " + d + "Browse the gene ecosystem" + r);
+console.log("    " + a + "rotifer --help             " + r + " " + d + "See all commands" + r);
+console.log("");
+console.log("  " + d + "Docs: https://rotifer.dev/docs" + r);
+console.log("");

package/dist/errors/formatter.d.ts

@@ -1,25 +0,0 @@
-export interface RotiferError {
-    code: string;
-    message: string;
-    file?: string;
-    line?: number;
-    column?: number;
-    suggestion?: string;
-    docsUrl?: string;
-}
-export declare function formatError(err: RotiferError): string;
-export declare const ERROR_CODES: {
-    readonly E0001: "Gene directory not found";
-    readonly E0002: "Phenotype validation failed";
-    readonly E0003: "Schema compilation error";
-    readonly E0010: "Phenotype file not found";
-    readonly E0011: "Test execution failed";
-    readonly E0020: "Compilation target not found";
-    readonly E0021: "WASM compilation failed";
-    readonly E0030: "Gene not wrapped";
-    readonly E0031: "Arena submission failed";
-    readonly E0040: "Agent creation failed";
-    readonly E0100: "Config file not found";
-    readonly E0101: "Config file invalid";
-};
-//# sourceMappingURL=formatter.d.ts.map

package/dist/errors/formatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/errors/formatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAwBrD;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAad,CAAC"}

package/dist/errors/formatter.js

@@ -1,43 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_CODES = void 0;
-exports.formatError = formatError;
-const chalk_1 = __importDefault(require("chalk"));
-function formatError(err) {
-    const lines = [];
-    lines.push(chalk_1.default.red.bold(`error[${err.code}]`) + chalk_1.default.bold(`: ${err.message}`));
-    if (err.file) {
-        let location = err.file;
-        if (err.line)
-            location += `:${err.line}`;
-        if (err.column)
-            location += `:${err.column}`;
-        lines.push(chalk_1.default.blue(" --> ") + location);
-    }
-    if (err.suggestion) {
-        lines.push("");
-        lines.push(chalk_1.default.green("help") + `: ${err.suggestion}`);
-    }
-    if (err.docsUrl) {
-        lines.push(chalk_1.default.dim("docs") + `: ${err.docsUrl}`);
-    }
-    return lines.join("\n");
-}
-exports.ERROR_CODES = {
-    E0001: "Gene directory not found",
-    E0002: "Phenotype validation failed",
-    E0003: "Schema compilation error",
-    E0010: "Phenotype file not found",
-    E0011: "Test execution failed",
-    E0020: "Compilation target not found",
-    E0021: "WASM compilation failed",
-    E0030: "Gene not wrapped",
-    E0031: "Arena submission failed",
-    E0040: "Agent creation failed",
-    E0100: "Config file not found",
-    E0101: "Config file invalid",
-};
-//# sourceMappingURL=formatter.js.map

package/dist/errors/formatter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/errors/formatter.ts"],"names":[],"mappings":";;;;;;AAYA,kCAwBC;AApCD,kDAA0B;AAY1B,SAAgB,WAAW,CAAC,GAAiB;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CACR,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CACtE,CAAC;IAEF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;QACxB,IAAI,GAAG,CAAC,IAAI;YAAE,QAAQ,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,GAAG,CAAC,MAAM;YAAE,QAAQ,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,eAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAEY,QAAA,WAAW,GAAG;IACzB,KAAK,EAAE,0BAA0B;IACjC,KAAK,EAAE,6BAA6B;IACpC,KAAK,EAAE,0BAA0B;IACjC,KAAK,EAAE,0BAA0B;IACjC,KAAK,EAAE,uBAAuB;IAC9B,KAAK,EAAE,8BAA8B;IACrC,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,uBAAuB;IAC9B,KAAK,EAAE,uBAAuB;IAC9B,KAAK,EAAE,qBAAqB;CACpB,CAAC"}

package/genes/academic-writer/.cloud-manifest.json

@@ -1,6 +0,0 @@
-{
-  "cloud_id": "6258ceaf-8610-4c2f-bbeb-e62ba3b6664d",
-  "owner": "Rotifer Protocol",
-  "version": "0.1.0",
-  "published_at": "2026-03-17T14:11:44.403Z"
-}

package/genes/academic-writer/.gene-manifest.json

@@ -1,8 +0,0 @@
-{
-  "geneId": "f3f7ed9e0099a055c841c1573024a89b853e17772201a7183ae49760bb2db0a0",
-  "name": "academic-writer",
-  "domain": "content.academic",
-  "fidelity": "Wrapped",
-  "wrappedAt": "2026-02-24T13:23:10.543Z",
-  "fromSkill": "../.cursor/skills/academic-writer/SKILL.md"
-}