@arodroz/odin 1.27.0

package/LICENSE.md

@@ -0,0 +1,53 @@
+# odin — End User License Agreement
+
+Copyright © 2026 Antonio Rodriguez (Anteras). All rights reserved.
+
+This agreement covers the `odin` command-line program and MCP server, the
+`@arodroz/odin` npm packages that distribute it, and the `odin` plugin for
+Claude Code and Codex (together, "the Software"). By installing or using the
+Software you accept these terms.
+
+## 1. Free use
+
+You may install and use the Software free of charge, for any purpose,
+including commercial work, on any number of machines.
+
+## 2. Restrictions
+
+You may not:
+
+- sell, rent, sublicense or redistribute the Software, modified or not, except
+  by pointing others to the official distribution channels (npmjs.com
+  `@arodroz/odin`, github.com/arodroz/odin-plugins);
+- modify, decompile, disassemble or reverse engineer the binaries, except where
+  applicable law expressly permits it despite this restriction;
+- remove or alter this notice or any copyright notice.
+
+## 3. Licensed features
+
+Some features, such as GESStabs generation, require a separate paid license
+key. This agreement does not grant that license.
+
+## 4. Your data
+
+The Software analyses the files you give it on your own machine and never
+uploads your scripts or their content. Its only network traffic is the license
+check for licensed features, which sends your license key and a machine
+instance name to the license provider (Lemon Squeezy).
+
+## 5. No warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NON-INFRINGEMENT. Diagnostics are an aid, not a guarantee that a questionnaire
+behaves correctly in production.
+
+## 6. Limitation of liability
+
+TO THE EXTENT PERMITTED BY LAW, THE AUTHOR IS NOT LIABLE FOR ANY DAMAGES
+ARISING FROM THE USE OF, OR INABILITY TO USE, THE SOFTWARE.
+
+## 7. Termination
+
+This license ends automatically if you breach it. On termination you must stop
+using and delete the Software.

package/README.md

@@ -0,0 +1,36 @@
+# @arodroz/odin
+
+The canonical NIPO ODIN analysis engine as a command-line tool and MCP server:
+ground-truth diagnostics, the structural map of a questionnaire, corpus audits,
+and the language reference — the same engine behind the ODIN VS Code extension.
+
+```sh
+npm install -g @arodroz/odin
+odin check path/to/script.odin     # diagnostics, or "clean"
+odin explain '*PUT'                # reference for a command, function or operator
+odin mcp                           # MCP server over stdio
+```
+
+Prebuilt for Windows x64, macOS x64/arm64 and Linux x64/arm64; npm installs
+only the binary for your platform. Requires Node.js 18 or later.
+
+## Use it from Claude Code or Codex
+
+Install the `odin` plugin, which runs this package for you — no global install
+needed:
+
+```text
+# Claude Code
+/plugin marketplace add arodroz/odin-plugins
+/plugin install odin@anteras-odin
+
+# Codex
+codex plugin marketplace add arodroz/odin-plugins
+codex plugin add odin@anteras-odin
+```
+
+Or register only the MCP server: `claude mcp add odin -- npx -y @arodroz/odin mcp`.
+
+## License
+
+Free to use; not open source. See [LICENSE.md](LICENSE.md).

package/bin/odin.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict';
+// Launcher for the prebuilt `odin` binary. npm installs exactly one of the
+// @arodroz/odin-<platform> optional dependencies (their os/cpu fields filter the
+// rest); this finds it and runs it with stdio passed straight through, so
+// `odin mcp` speaks MCP over the same pipes the client opened.
+
+const { spawnSync } = require('child_process');
+
+const PLATFORMS = {
+  'win32 x64': '@arodroz/odin-win32-x64',
+  'darwin x64': '@arodroz/odin-darwin-x64',
+  'darwin arm64': '@arodroz/odin-darwin-arm64',
+  'linux x64': '@arodroz/odin-linux-x64',
+  'linux arm64': '@arodroz/odin-linux-arm64',
+};
+
+// resolveBinary maps a host to its binary path, or to an error message that
+// says what to do. resolve is require.resolve, injectable for tests.
+function resolveBinary(platform, arch, resolve) {
+  const host = `${platform} ${arch}`;
+  const pkg = PLATFORMS[host];
+  if (!pkg) {
+    return { error: `@arodroz/odin: no prebuilt odin binary for ${host}. Supported: ${Object.keys(PLATFORMS).join(', ')}.` };
+  }
+  const file = `${pkg}/bin/odin${platform === 'win32' ? '.exe' : ''}`;
+  try {
+    return { path: resolve(file) };
+  } catch {
+    return {
+      error: `@arodroz/odin: the platform package ${pkg} is not installed. ` +
+        'It is an optional dependency: reinstall without --no-optional / --omit=optional.',
+    };
+  }
+}
+
+function main() {
+  const r = resolveBinary(process.platform, process.arch, require.resolve);
+  if (r.error) {
+    console.error(r.error);
+    process.exit(2);
+  }
+  // Resolve-only mode, for callers that run the binary themselves: the plugin's
+  // hook resolves once through npx, caches the path, and skips npm's startup
+  // cost on every later edit.
+  if (process.env.ANTERAS_ODIN_PRINT_PATH === '1') {
+    process.stdout.write(r.path + '\n');
+    process.exit(0);
+  }
+  const child = spawnSync(r.path, process.argv.slice(2), { stdio: 'inherit' });
+  if (child.error) {
+    console.error(`@arodroz/odin: cannot run ${r.path}: ${child.error.message}`);
+    process.exit(2);
+  }
+  if (child.signal) process.kill(process.pid, child.signal);
+  process.exit(child.status === null ? 1 : child.status);
+}
+
+if (require.main === module) main();
+
+module.exports = { resolveBinary, PLATFORMS };

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@arodroz/odin",
+  "version": "1.27.0",
+  "description": "The canonical NIPO ODIN analysis engine: diagnostics, structural map, corpus audit and language reference, as a CLI and MCP server.",
+  "bin": {
+    "odin": "bin/odin.js"
+  },
+  "optionalDependencies": {
+    "@arodroz/odin-win32-x64": "1.27.0",
+    "@arodroz/odin-darwin-x64": "1.27.0",
+    "@arodroz/odin-darwin-arm64": "1.27.0",
+    "@arodroz/odin-linux-x64": "1.27.0",
+    "@arodroz/odin-linux-arm64": "1.27.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://github.com/arodroz/odin-plugins",
+  "keywords": [
+    "odin",
+    "nipo",
+    "nfield",
+    "survey",
+    "questionnaire",
+    "mcp",
+    "mcp-server"
+  ]
+}