homegraph 1.5.2 → 1.5.4

package/dist/addons/manager.js

@@ -0,0 +1,437 @@
+"use strict";
+/**
+ * Addon install management (npm as the install engine).
+ *
+ * `npm install --prefix <addonsRoot>` handles all package mechanics —
+ * resolution, integrity, transitive dependencies, local paths, git URLs —
+ * so HomeGraph never reimplements package resolution. The registry records
+ * the concrete resolved version (never the requested range) to prevent
+ * silent drift.
+ *
+ * Version policy (v1 of the addon format):
+ * - **No silent downgrades.** Re-installing a name that is already
+ *   registered compares the target version against the installed one and
+ *   refuses anything older — the user must `remove` first.
+ * - **Upgrades preserve the previous version.** The installed package
+ *   directory is renamed aside to a rollback backup before npm runs; a
+ *   failed install/validation restores it, so a bad upgrade can never
+ *   leave the store without the previous working copy.
+ *
+ * Both policies apply to registry packages and local-path packages alike
+ * (a local-path "package" is a symlink npm manages; rename/restore is
+ * symmetric). The one carve-out is the name-resolution fallback path
+ * (git URLs etc., where the package name is only known *after* npm runs) —
+ * it cannot gate or back up in advance.
+ *
+ * @module addons/manager
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalPathSpec = isLocalPathSpec;
+exports.resolvePackageInfo = resolvePackageInfo;
+exports.resolvePackageName = resolvePackageName;
+exports.installAddon = installAddon;
+exports.removeAddon = removeAddon;
+exports.listAddons = listAddons;
+exports.resolveUpdateSpec = resolveUpdateSpec;
+exports.updateAddon = updateAddon;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const errors_1 = require("../errors");
+const paths_1 = require("./paths");
+const registry_1 = require("./registry");
+const validate_1 = require("./validate");
+const semver_1 = require("./semver");
+const index_1 = require("../upgrade/index");
+/**
+ * Run npm with the given arguments.
+ *
+ * On Windows `npm.cmd` cannot be spawned directly — CreateProcess rejects
+ * `.cmd` files with EINVAL (since the CVE-2024-27980 hardening) — and
+ * routing through cmd.exe re-quotes the command line, breaking arguments
+ * that contain spaces (e.g. a repository path under a username with
+ * spaces). Instead run npm's CLI entry with node.exe, which passes the
+ * argument array through verbatim; falls back to the cmd.exe invocation
+ * used by the upgrade path when npm-cli.js is absent.
+ */
+function runNpm(args) {
+    if (process.platform === 'win32') {
+        const npmCli = path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
+        const { cmd, args: cmdArgs } = fs.existsSync(npmCli)
+            ? { cmd: process.execPath, args: [npmCli, ...args] }
+            : (0, index_1.npmInvocation)(process.platform, args);
+        return (0, child_process_1.execFileSync)(cmd, cmdArgs, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+    }
+    return (0, child_process_1.execFileSync)('npm', args, {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+}
+/** Whether an install spec points at a local path (dir or tarball). */
+function isLocalPathSpec(spec) {
+    return (spec.startsWith('./') ||
+        spec.startsWith('../') ||
+        path.isAbsolute(spec) || // POSIX '/…' and Windows drive/UNC absolute paths
+        spec.startsWith('file:'));
+}
+/**
+ * Resolve the npm package name and install source for an install spec, or
+ * `null` when neither a local package.json nor `npm view` yields a name.
+ *
+ * - Local paths (`./x`, `../x`, absolute, `file:`) → read package.json.
+ * - Everything else (names, scoped names, ranges, dist-tags) → `npm view`.
+ */
+function resolvePackageInfo(pkgSpec) {
+    const spec = pkgSpec.trim();
+    if (isLocalPathSpec(spec)) {
+        const dir = spec.startsWith('file:') ? spec.slice('file:'.length) : spec;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(path.resolve(dir), 'package.json'), 'utf-8'));
+            if (typeof pkg.name === 'string' && pkg.name.length > 0) {
+                return { name: pkg.name, source: 'local' };
+            }
+        }
+        catch {
+            // Fall through to npm view for the error path.
+        }
+    }
+    try {
+        const out = runNpm(['view', spec, 'name', '--json']);
+        const parsed = JSON.parse(out.trim());
+        if (typeof parsed === 'string' && parsed.length > 0) {
+            return { name: parsed, source: 'registry' };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Package name only — compatibility shim over {@link resolvePackageInfo}. */
+function resolvePackageName(pkgSpec) {
+    return resolvePackageInfo(pkgSpec)?.name ?? null;
+}
+/**
+ * Resolve the concrete version an install spec would install, used by the
+ * version gate BEFORE npm touches the store. Local specs read package.json
+ * (a missing version resolves to `'0.0.0'` — the same fallback
+ * `validateAddonPackage` uses, so a versionless package is a genuine
+ * downgrade target and correctly refused). Registry specs ask npm
+ * (`npm view <spec> version` — bare specs resolve to the dist-tag).
+ *
+ * Returns `null` when a registry lookup fails (offline / unknown package):
+ * the gate is then SKIPPED — unknown data never refuses an install, and npm
+ * itself reports resolution errors.
+ */
+function resolveTargetVersion(pkgSpec, source) {
+    if (source === 'local') {
+        const spec = pkgSpec.trim();
+        const dir = spec.startsWith('file:') ? spec.slice('file:'.length) : spec;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(path.resolve(dir), 'package.json'), 'utf-8'));
+            return typeof pkg.version === 'string' && pkg.version.length > 0
+                ? pkg.version
+                : '0.0.0';
+        }
+        catch {
+            return '0.0.0';
+        }
+    }
+    try {
+        const out = runNpm(['view', pkgSpec.trim(), 'version', '--json']);
+        const parsed = JSON.parse(out.trim());
+        if (typeof parsed === 'string' && parsed.length > 0)
+            return parsed;
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+/**
+ * List top-level packages currently installed in the addons store
+ * (`node_modules` one level deep, scoped packages two levels).
+ */
+function listTopLevelPackages(addonsRoot) {
+    const out = new Set();
+    const nodeModules = path.join(addonsRoot, 'node_modules');
+    if (!fs.existsSync(nodeModules))
+        return out;
+    for (const entry of fs.readdirSync(nodeModules)) {
+        if (entry.startsWith('@')) {
+            const scopedDir = path.join(nodeModules, entry);
+            let stat;
+            try {
+                stat = fs.statSync(scopedDir);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isDirectory())
+                continue;
+            for (const sub of fs.readdirSync(scopedDir)) {
+                out.add(`${entry}/${sub}`);
+            }
+        }
+        else {
+            out.add(entry);
+        }
+    }
+    return out;
+}
+/**
+ * Preserve an installed package before an upgrade by renaming it out of
+ * `node_modules`. Returns the rollback backup root, or `null` when the
+ * package directory is absent (nothing to preserve).
+ *
+ * Works for real directories and symlinks alike (npm links local-path
+ * packages); the backup lives next to `node_modules` on the same filesystem,
+ * so `renameSync` never crosses a mount boundary. On Windows the rename
+ * target does not exist at call time, which is the case `renameSync` allows.
+ */
+function backupAddonPackage(addonsRoot, name) {
+    const src = path.join(addonsRoot, 'node_modules', name);
+    if (!fs.existsSync(src))
+        return null;
+    const backup = path.join(addonsRoot, `.rollback-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    fs.mkdirSync(backup, { recursive: true });
+    fs.renameSync(src, path.join(backup, path.basename(name)));
+    return backup;
+}
+/**
+ * Restore a backed-up package after a failed upgrade. Removes whatever
+ * partial install npm left behind first (no-op when absent), then renames
+ * the backup back. Failures here are warnings — the registry entry is never
+ * touched by the caller, so the record keeps pointing at the previous
+ * version even if the files cannot be recovered.
+ */
+function restoreAddonPackage(addonsRoot, name, backup) {
+    if (!backup)
+        return;
+    const dest = path.join(addonsRoot, 'node_modules', name);
+    try {
+        fs.rmSync(dest, { recursive: true, force: true });
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.renameSync(path.join(backup, path.basename(name)), dest);
+        // The package moved back out; the backup dir is empty now.
+        fs.rmSync(backup, { recursive: true, force: true });
+    }
+    catch (err) {
+        // On failure the backup keeps its contents — leave it for manual recovery.
+        (0, errors_1.logWarn)(`Failed to restore addon ${name} from backup`, {
+            backup,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/** Delete a rollback backup after a successful upgrade (best effort). */
+function cleanupBackup(backup) {
+    if (!backup)
+        return;
+    try {
+        fs.rmSync(backup, { recursive: true, force: true });
+    }
+    catch {
+        // Best effort — stale backups are inert and named per-attempt.
+    }
+}
+/**
+ * Install an addon package and register it.
+ *
+ * Throws on failure (npm error, invalid addon, unresolvable name, or a
+ * downgrade attempt against an installed version). The registry is written
+ * only after validation succeeds. When re-installing an existing name
+ * (upgrade), the previous files are preserved and restored on failure.
+ */
+async function installAddon(repoRoot, pkgSpec, options) {
+    const addonsRoot = (0, paths_1.addonsRootDir)(repoRoot);
+    fs.mkdirSync(addonsRoot, { recursive: true });
+    // Resolve identity + source from the spec. The CLI pre-resolves the name
+    // (npm view / local package.json) and passes it via options.name to skip a
+    // second resolution — but it must never override the SOURCE: a local-path
+    // spec stays 'local' even when the name was pre-resolved, otherwise
+    // `update --latest` would wrongly apply to a local-path addon.
+    let info = resolvePackageInfo(pkgSpec);
+    if (options.name) {
+        info = { name: options.name, source: info?.source ?? 'registry' };
+    }
+    let name = info?.name ?? null;
+    let source = info?.source ?? 'registry';
+    let backup = null;
+    if (!name) {
+        // Last resort (git URLs, tarballs without a resolvable name): install
+        // first, then diff node_modules. Cannot gate or back up in advance.
+        const before = listTopLevelPackages(addonsRoot);
+        runNpm(['install', '--prefix', addonsRoot, '--no-audit', '--no-fund', pkgSpec]);
+        const added = [...listTopLevelPackages(addonsRoot)].filter((p) => !before.has(p));
+        if (added.length !== 1) {
+            throw new Error(`Cannot resolve the installed package name for "${pkgSpec}" ` +
+                `(${added.length} new package(s) detected). Install by name or a local path.`);
+        }
+        name = added[0];
+        source = 'registry';
+    }
+    else {
+        // Version gate + upgrade backup, both before npm touches the store.
+        const installed = (0, registry_1.readRegistry)(repoRoot).addons.find((e) => e.name === name);
+        if (installed) {
+            const target = resolveTargetVersion(pkgSpec, source);
+            // `null` = version could not be resolved (offline / unknown package):
+            // skip the gate — unknown data never refuses an install.
+            if (target !== null && (0, semver_1.compareSemver)(target, installed.version) < 0) {
+                throw new Error(`${name}@${target} is older than the installed ${name}@${installed.version} — ` +
+                    `remove it first ("homegraph addon remove ${name}") then install the older version`);
+            }
+            backup = backupAddonPackage(addonsRoot, name);
+        }
+        try {
+            runNpm(['install', '--prefix', addonsRoot, '--no-audit', '--no-fund', pkgSpec]);
+        }
+        catch (err) {
+            restoreAddonPackage(addonsRoot, name, backup);
+            throw err;
+        }
+    }
+    const pkgDir = (0, paths_1.addonPkgDir)(repoRoot, name);
+    const validation = await (0, validate_1.validateAddonPackage)(pkgDir);
+    if (!validation.ok) {
+        restoreAddonPackage(addonsRoot, name, backup);
+        if (!backup) {
+            // Fresh install with nothing to restore — uninstall the leftovers so
+            // nothing half-installed lingers.
+            try {
+                runNpm(['uninstall', '--prefix', addonsRoot, '--no-audit', '--no-fund', name]);
+            }
+            catch {
+                // Best effort — unregistered leftovers are inert (never loaded).
+            }
+        }
+        throw new Error(`Installed package is not a valid HomeGraph addon: ${validation.reason}`);
+    }
+    cleanupBackup(backup);
+    const version = validation.version;
+    (0, registry_1.upsertEntry)(repoRoot, { name, version, enabled: options.enable, source });
+    return { name, version };
+}
+/**
+ * Unregister an addon, optionally deleting its files. Returns `false` when
+ * the name was not registered.
+ */
+function removeAddon(repoRoot, name, options) {
+    const removed = (0, registry_1.removeEntry)(repoRoot, name);
+    if (!removed)
+        return false;
+    if (options.purge) {
+        try {
+            runNpm(['uninstall', '--prefix', (0, paths_1.addonsRootDir)(repoRoot), '--no-audit', '--no-fund', name]);
+        }
+        catch (err) {
+            (0, errors_1.logWarn)(`Failed to purge addon files for ${name}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return true;
+}
+/**
+ * List registered addons with their on-disk status (installed vs missing).
+ */
+function listAddons(repoRoot) {
+    const registry = (0, registry_1.readRegistry)(repoRoot);
+    return registry.addons.map((entry) => ({
+        ...entry,
+        installed: fs.existsSync(path.join((0, paths_1.addonPkgDir)(repoRoot, entry.name), 'package.json')),
+    }));
+}
+/** npm spec for an update: bare name follows the recorded range, `@latest` forces the dist-tag. */
+function resolveUpdateSpec(name, latest) {
+    return latest ? `${name}@latest` : name;
+}
+/**
+ * Update registered addon(s) to the latest version within the configured
+ * range (re-running `npm install` on the registered name, then recording the
+ * newly resolved version). Each update preserves the previous files and
+ * restores them on failure, so a bad upgrade never loses the working copy.
+ *
+ * Returns the names+versions that were updated; entries whose validation
+ * failed after install are logged and skipped (previous version kept).
+ */
+async function updateAddon(repoRoot, name, options = {}) {
+    const registry = (0, registry_1.readRegistry)(repoRoot);
+    const targets = name
+        ? registry.addons.filter((e) => e.name === name)
+        : registry.addons;
+    if (name && targets.length === 0) {
+        throw new Error(`Addon not registered: ${name}`);
+    }
+    if (targets.length === 0)
+        return [];
+    const addonsRoot = (0, paths_1.addonsRootDir)(repoRoot);
+    fs.mkdirSync(addonsRoot, { recursive: true });
+    const updated = [];
+    for (const entry of targets) {
+        if (options.latest && entry.source !== 'registry') {
+            throw new Error(`${entry.name} was installed from a local path — ` +
+                `"update --latest" applies to registry packages only`);
+        }
+        const backup = backupAddonPackage(addonsRoot, entry.name);
+        const spec = resolveUpdateSpec(entry.name, !!options.latest);
+        try {
+            runNpm(['install', '--prefix', addonsRoot, '--no-audit', '--no-fund', spec]);
+        }
+        catch (err) {
+            restoreAddonPackage(addonsRoot, entry.name, backup);
+            throw err;
+        }
+        const validation = await (0, validate_1.validateAddonPackage)((0, paths_1.addonPkgDir)(repoRoot, entry.name));
+        if (!validation.ok) {
+            restoreAddonPackage(addonsRoot, entry.name, backup);
+            (0, errors_1.logWarn)(`Addon ${entry.name} failed validation after update — keeping previous version`, {
+                reason: validation.reason,
+            });
+            continue;
+        }
+        cleanupBackup(backup);
+        const to = validation.version ?? entry.version;
+        (0, registry_1.upsertEntry)(repoRoot, { ...entry, version: to });
+        updated.push({ name: entry.name, from: entry.version, to });
+    }
+    return updated;
+}
+//# sourceMappingURL=manager.js.map

package/dist/addons/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/addons/manager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEH,0CAOC;AASD,gDA2BC;AAGD,gDAEC;AA6ID,oCA8EC;AAMD,kCAkBC;AAKD,gCAUC;AAoBD,8CAEC;AAWD,kCAmDC;AAxcD,uCAAyB;AACzB,2CAA6B;AAC7B,iDAA6C;AAC7C,sCAAoC;AACpC,mCAAqD;AACrD,yCAAoE;AACpE,yCAAkD;AAClD,qCAAyC;AACzC,4CAAiD;AAiBjD;;;;;;;;;;GAUG;AACH,SAAS,MAAM,CAAC,IAAc;IAC5B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC9B,cAAc,EACd,KAAK,EACL,KAAK,EACL,YAAY,CACb,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAClD,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE;YACpD,CAAC,CAAC,IAAA,qBAAa,EAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAA,4BAAY,EAAC,GAAG,EAAE,OAAO,EAAE;YAChC,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAA,4BAAY,EAAC,KAAK,EAAE,IAAI,EAAE;QAC/B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAQD,uEAAuE;AACvE,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,kDAAkD;QAC3E,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACjD,CAAC;YACxB,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,kBAAkB,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,oBAAoB,CAC3B,OAAe,EACf,MAA4B;IAE5B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAC9C,CAAC;YAC3B,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAC9D,CAAC,CAAC,GAAG,CAAC,OAAO;gBACb,CAAC,CAAC,OAAO,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,IAAc,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBAAE,SAAS;YAClC,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,UAAkB,EAAE,IAAY;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,UAAU,EACV,aAAa,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAChF,CAAC;IACF,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,IAAY,EACZ,MAAqB;IAErB,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5D,2DAA2D;QAC3D,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2EAA2E;QAC3E,IAAA,gBAAO,EAAC,2BAA2B,IAAI,cAAc,EAAE;YACrD,MAAM;YACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,aAAa,CAAC,MAAqB;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,OAAe,EACf,OAAuB;IAEvB,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAC,QAAQ,CAAC,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,oEAAoE;IACpE,+DAA+D;IAC/D,IAAI,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,UAAU,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;IAC9B,IAAI,MAAM,GAAyB,IAAI,EAAE,MAAM,IAAI,UAAU,CAAC;IAC9D,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,sEAAsE;QACtE,oEAAoE;QACpE,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kDAAkD,OAAO,IAAI;gBAC3D,IAAI,KAAK,CAAC,MAAM,6DAA6D,CAChF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACjB,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,oEAAoE;QACpE,MAAM,SAAS,GAAG,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC7E,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,sEAAsE;YACtE,yDAAyD;YACzD,IAAI,MAAM,KAAK,IAAI,IAAI,IAAA,sBAAa,EAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,IAAI,MAAM,gCAAgC,IAAI,IAAI,SAAS,CAAC,OAAO,KAAK;oBAC7E,4CAA4C,IAAI,mCAAmC,CACtF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9C,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,IAAA,+BAAoB,EAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,mBAAmB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,qEAAqE;YACrE,kCAAkC;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;YACjF,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAQ,CAAC;IACpC,IAAA,sBAAW,EAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CACzB,QAAgB,EAChB,IAAY,EACZ,OAA2B;IAE3B,MAAM,OAAO,GAAG,IAAA,sBAAW,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,IAAA,qBAAa,EAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAA,gBAAO,EAAC,mCAAmC,IAAI,EAAE,EAAE;gBACjD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CACxB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,GAAG,KAAK;QACR,SAAS,EAAE,EAAE,CAAC,UAAU,CACtB,IAAI,CAAC,IAAI,CAAC,IAAA,mBAAW,EAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAC7D;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAmBD,mGAAmG;AACnG,SAAgB,iBAAiB,CAAC,IAAY,EAAE,MAAe;IAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,IAAa,EACb,UAAyB,EAAE;IAE3B,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI;QAClB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;QAChD,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEpB,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAC,QAAQ,CAAC,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,IAAI,qCAAqC;gBAChD,qDAAqD,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAA,+BAAoB,EAAC,IAAA,mBAAW,EAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpD,IAAA,gBAAO,EAAC,SAAS,KAAK,CAAC,IAAI,4DAA4D,EAAE;gBACvF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAC/C,IAAA,sBAAW,EAAC,QAAQ,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/addons/paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Path resolution for the repository-level addon store.
+ *
+ * Layout (next to the spec feature's `commit4spec/` data directory):
+ *
+ *   <repo>/.homegraph/
+ *   ├── addons.json              registry (see ./registry)
+ *   ├── addons/                  npm install --prefix target
+ *   │   └── node_modules/
+ *   │       └── @scope/name/     one directory per installed addon
+ *   └── commit4spec/             spec data (SPEC_DATA_DIR)
+ *
+ * @module addons/paths
+ */
+/** Directory holding all installed addon packages (npm install --prefix target). */
+export declare function addonsRootDir(repoRoot: string): string;
+/**
+ * Resolve an installed addon package directory from its registry name.
+ * Scoped names (`@scope/name`) nest naturally under `node_modules`.
+ */
+export declare function addonPkgDir(repoRoot: string, name: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/addons/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/addons/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/addons/paths.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Path resolution for the repository-level addon store.
+ *
+ * Layout (next to the spec feature's `commit4spec/` data directory):
+ *
+ *   <repo>/.homegraph/
+ *   ├── addons.json              registry (see ./registry)
+ *   ├── addons/                  npm install --prefix target
+ *   │   └── node_modules/
+ *   │       └── @scope/name/     one directory per installed addon
+ *   └── commit4spec/             spec data (SPEC_DATA_DIR)
+ *
+ * @module addons/paths
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addonsRootDir = addonsRootDir;
+exports.addonPkgDir = addonPkgDir;
+const path = __importStar(require("path"));
+const directory_1 = require("../directory");
+/** Directory holding all installed addon packages (npm install --prefix target). */
+function addonsRootDir(repoRoot) {
+    return path.join((0, directory_1.getHomeGraphDir)(repoRoot), 'addons');
+}
+/**
+ * Resolve an installed addon package directory from its registry name.
+ * Scoped names (`@scope/name`) nest naturally under `node_modules`.
+ */
+function addonPkgDir(repoRoot, name) {
+    return path.join(addonsRootDir(repoRoot), 'node_modules', name);
+}
+//# sourceMappingURL=paths.js.map

package/dist/addons/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/addons/paths.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,sCAEC;AAMD,kCAEC;AAdD,2CAA6B;AAC7B,4CAA+C;AAE/C,oFAAoF;AACpF,SAAgB,aAAa,CAAC,QAAgB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAA,2BAAe,EAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,QAAgB,EAAE,IAAY;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/addons/registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Addon registry file I/O — read/write `${getHomeGraphDir(repoRoot)}/addons.json`.
+ *
+ * The registry is a small standalone file, deliberately separate from the
+ * spec feature's `configs.json`, so the top-level `homegraph addon` command
+ * never touches spec configuration. Writes are atomic (tmp file + rename).
+ *
+ * @module addons/registry
+ */
+import { AddonRegistry, AddonRegistryEntry } from './types';
+/** Absolute path of the registry file for a repository. */
+export declare function registryFilePath(repoRoot: string): string;
+/**
+ * Read the registry. A missing file yields an empty registry (the first
+ * `install` may be the very first addon operation); a corrupt file is
+ * ignored with a warning and treated as empty.
+ */
+export declare function readRegistry(repoRoot: string): AddonRegistry;
+/**
+ * Atomically write the registry (tmp file + rename). Creates the HomeGraph
+ * data directory if needed.
+ */
+export declare function writeRegistry(repoRoot: string, registry: AddonRegistry): void;
+/**
+ * Insert or replace an entry by name (re-install updates version/enabled,
+ * preserving the position).
+ */
+export declare function upsertEntry(repoRoot: string, entry: AddonRegistryEntry): void;
+/**
+ * Remove an entry by name. Returns `false` when the name was not registered.
+ */
+export declare function removeEntry(repoRoot: string, name: string): boolean;
+/**
+ * Toggle the `enabled` flag of an entry. Returns `false` when the name was
+ * not registered.
+ */
+export declare function setEntryEnabled(repoRoot: string, name: string, enabled: boolean): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/addons/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/addons/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAK5D,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAcD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAiC5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAM7E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAS7E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAOT"}