yggdrasil-memory 0.1.0

package/LICENSE

@@ -0,0 +1,99 @@
+Yggdrasil is licensed under the Elastic License 2.0.
+
+Copyright (c) 2026 Yggdrasil contributors (the "Licensor").
+
+Canonical text: https://www.elastic.co/licensing/elastic-license
+
+-------------------------------------------------------------------------------
+
+Elastic License 2.0
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of legal
+claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion of
+it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+**control** means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,35 @@
+# yggdrasil-memory (npm launcher)
+
+> One shared, durable memory for all your AI coding agents — MCP, local-first, zero-dependency.
+
+This npm package is a **thin launcher**. Yggdrasil's engine is pure Python; this
+package makes sure a runner is available (it prefers [`uv`](https://docs.astral.sh/uv/),
+which can fetch a managed Python on its own) and then runs the Python package
+[`yggdrasil-memory`](https://pypi.org/project/yggdrasil-memory/), forwarding every
+argument. So this works even on a machine with no Python installed:
+
+```bash
+npx yggdrasil-memory install      # guided setup: models, background service, MCP registration
+```
+
+Everything after `install` is forwarded to the `ygg` CLI:
+
+```bash
+npx yggdrasil-memory doctor
+npx yggdrasil-memory recall --query "flaky websocket reconnect"
+```
+
+Or install the launcher globally to get the `ygg` command:
+
+```bash
+npm install -g yggdrasil-memory
+ygg install
+```
+
+**Prefer the native channels?** `uvx --from yggdrasil-memory ygg install`,
+`pipx install yggdrasil-memory`, `pip install yggdrasil-memory`, or
+`brew install VonderVuflya/tap/yggdrasil` — they all install the same engine.
+
+Full docs, FAQ, and translations: **https://github.com/VonderVuflya/yggdrasil**
+
+Licensed under the Elastic License 2.0 (source-available). See `LICENSE`.

package/bin/ygg.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+'use strict';
+
+/*
+ * Yggdrasil npm launcher.
+ *
+ * Yggdrasil's engine is pure Python. This package is a thin launcher: it makes
+ * sure a runner is available (prefers `uv`/`uvx`, which can fetch a managed
+ * Python on its own), then runs the published Python package `yggdrasil-memory`
+ * and forwards every argument. So `npx yggdrasil-memory install` works even on
+ * a machine without Python.
+ *
+ * Env overrides:
+ *   YGG_NPM_SOURCE   install source for uvx/pipx (default: "yggdrasil-memory").
+ *                    Use a wheel path or "git+https://github.com/VonderVuflya/yggdrasil.git" to test.
+ *   YGG_NO_BOOTSTRAP set to "1" to never auto-install uv.
+ */
+
+const { spawnSync } = require('child_process');
+const os = require('os');
+const path = require('path');
+
+const SOURCE = process.env.YGG_NPM_SOURCE || 'yggdrasil-memory';
+const args = process.argv.slice(2);
+
+function has(cmd) {
+  const r = spawnSync(cmd, ['--version'], { stdio: 'ignore' });
+  return !r.error && r.status === 0;
+}
+
+function run(cmd, cmdArgs) {
+  const r = spawnSync(cmd, cmdArgs, { stdio: 'inherit' });
+  if (r.error) return null;
+  return r.status === null ? 1 : r.status;
+}
+
+function ensureUv() {
+  if (process.env.YGG_NO_BOOTSTRAP === '1') return false;
+  process.stderr.write(
+    'yggdrasil: uv not found — installing it once via https://astral.sh/uv ...\n'
+  );
+  const r = process.platform === 'win32'
+    ? spawnSync('powershell', ['-NoProfile', '-ExecutionPolicy', 'ByPass', '-Command',
+        'irm https://astral.sh/uv/install.ps1 | iex'], { stdio: 'inherit' })
+    : spawnSync('sh', ['-c', 'curl -LsSf https://astral.sh/uv/install.sh | sh'], { stdio: 'inherit' });
+  return !r.error && r.status === 0;
+}
+
+function freshUvBin() {
+  // uv's installer drops the binary in ~/.local/bin by default.
+  const home = os.homedir();
+  return process.platform === 'win32'
+    ? path.join(home, '.local', 'bin', 'uv.exe')
+    : path.join(home, '.local', 'bin', 'uv');
+}
+
+let code = null;
+if (has('uvx')) {
+  code = run('uvx', ['--from', SOURCE, 'ygg', ...args]);
+} else if (has('uv')) {
+  code = run('uv', ['tool', 'run', '--from', SOURCE, 'ygg', ...args]);
+} else if (has('pipx')) {
+  code = run('pipx', ['run', '--spec', SOURCE, 'ygg', ...args]);
+} else if (ensureUv()) {
+  // PATH in this process may not see the freshly installed uv yet — call it directly.
+  code = run(freshUvBin(), ['tool', 'run', '--from', SOURCE, 'ygg', ...args]);
+  if (code === null && has('uv')) {
+    code = run('uv', ['tool', 'run', '--from', SOURCE, 'ygg', ...args]);
+  }
+}
+
+if (code === null) {
+  process.stderr.write(
+    '\nyggdrasil: could not find or bootstrap a runner.\n' +
+    'Install one of these, then re-run:\n' +
+    '  - uv    https://docs.astral.sh/uv/   (recommended; handles Python for you)\n' +
+    '  - pipx  https://pipx.pypa.io/\n' +
+    'Or install the Python package directly:  pip install yggdrasil-memory\n'
+  );
+  process.exit(1);
+}
+process.exit(code);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "yggdrasil-memory",
+  "version": "0.1.0",
+  "description": "Installer/launcher for Yggdrasil — one shared, durable memory for your AI coding agents (MCP, local-first). Bootstraps the Python core via uv, so `npx yggdrasil-memory` works even without a preinstalled Python.",
+  "bin": {
+    "ygg": "bin/ygg.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai-agents",
+    "claude",
+    "codex",
+    "local-first",
+    "obsidian",
+    "yggdrasil"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://github.com/VonderVuflya/yggdrasil#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VonderVuflya/yggdrasil.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VonderVuflya/yggdrasil/issues"
+  }
+}