homegraph 1.5.3 → 1.5.5

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"}

package/dist/addons/registry.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * 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
+ */
+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.registryFilePath = registryFilePath;
+exports.readRegistry = readRegistry;
+exports.writeRegistry = writeRegistry;
+exports.upsertEntry = upsertEntry;
+exports.removeEntry = removeEntry;
+exports.setEntryEnabled = setEntryEnabled;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const errors_1 = require("../errors");
+const directory_1 = require("../directory");
+/** Registry file name relative to the HomeGraph data dir. */
+const REGISTRY_FILE = 'addons.json';
+/** Absolute path of the registry file for a repository. */
+function registryFilePath(repoRoot) {
+    return path.join((0, directory_1.getHomeGraphDir)(repoRoot), REGISTRY_FILE);
+}
+function isValidEntry(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const entry = value;
+    return (typeof entry.name === 'string' &&
+        entry.name.length > 0 &&
+        typeof entry.version === 'string' &&
+        typeof entry.enabled === 'boolean' &&
+        (entry.source === 'registry' || entry.source === 'local'));
+}
+/**
+ * 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.
+ */
+function readRegistry(repoRoot) {
+    const file = registryFilePath(repoRoot);
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        return { addons: [] };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('top-level value must be an object');
+        }
+        const rawAddons = parsed.addons;
+        if (!Array.isArray(rawAddons))
+            return { addons: [] };
+        const addons = rawAddons.filter(isValidEntry);
+        if (addons.length !== rawAddons.length) {
+            // Entries from a pre-`source` registry are dropped outright (no
+            // compatibility path) — surface it so a vanishing addon is diagnosable.
+            (0, errors_1.logWarn)(`Dropped ${rawAddons.length - addons.length} entry(ies) from ${file}: ` +
+                'missing "source" (registry format changed — reinstall them with "homegraph addon install")');
+        }
+        return { addons };
+    }
+    catch (err) {
+        (0, errors_1.logWarn)(`Ignoring ${file}: not a valid addon registry`, {
+            file,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return { addons: [] };
+    }
+}
+/**
+ * Atomically write the registry (tmp file + rename). Creates the HomeGraph
+ * data directory if needed.
+ */
+function writeRegistry(repoRoot, registry) {
+    const file = registryFilePath(repoRoot);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(registry, null, 2) + '\n', 'utf-8');
+    fs.renameSync(tmp, file);
+}
+/**
+ * Insert or replace an entry by name (re-install updates version/enabled,
+ * preserving the position).
+ */
+function upsertEntry(repoRoot, entry) {
+    const registry = readRegistry(repoRoot);
+    const index = registry.addons.findIndex((e) => e.name === entry.name);
+    if (index >= 0) {
+        registry.addons[index] = entry;
+    }
+    else {
+        registry.addons.push(entry);
+    }
+    writeRegistry(repoRoot, registry);
+}
+/**
+ * Remove an entry by name. Returns `false` when the name was not registered.
+ */
+function removeEntry(repoRoot, name) {
+    const registry = readRegistry(repoRoot);
+    const next = registry.addons.filter((e) => e.name !== name);
+    if (next.length === registry.addons.length)
+        return false;
+    writeRegistry(repoRoot, { addons: next });
+    return true;
+}
+/**
+ * Toggle the `enabled` flag of an entry. Returns `false` when the name was
+ * not registered.
+ */
+function setEntryEnabled(repoRoot, name, enabled) {
+    const registry = readRegistry(repoRoot);
+    const entry = registry.addons.find((e) => e.name === name);
+    if (!entry)
+        return false;
+    entry.enabled = enabled;
+    writeRegistry(repoRoot, registry);
+    return true;
+}
+//# sourceMappingURL=registry.js.map

package/dist/addons/registry.js.map

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

package/dist/addons/semver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Minimal semver comparison for addon version gating.
+ *
+ * HomeGraph deliberately does not depend on a semver library: the versions
+ * compared here always come from npm (`npm view`) or a package.json that
+ * `validateAddonPackage` already accepted, so they are well-formed semver.
+ * Only the comparisons needed for the install gate (`<`, `=`, `>`) are
+ * implemented — no ranges, no coercion, no build-metadata significance.
+ *
+ * @module addons/semver
+ */
+/**
+ * Compare two semver strings: negative when `a < b`, zero when equal,
+ * positive when `a > b`. Build metadata (`+...`) is ignored.
+ *
+ * A version that does not parse as semver compares equal to anything
+ * (returns 0) — callers treat an unparseable version conservatively as
+ * "not a downgrade" rather than refusing the install.
+ */
+export declare function compareSemver(a: string, b: string): number;
+//# sourceMappingURL=semver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/addons/semver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyCH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW1D"}

package/dist/addons/semver.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Minimal semver comparison for addon version gating.
+ *
+ * HomeGraph deliberately does not depend on a semver library: the versions
+ * compared here always come from npm (`npm view`) or a package.json that
+ * `validateAddonPackage` already accepted, so they are well-formed semver.
+ * Only the comparisons needed for the install gate (`<`, `=`, `>`) are
+ * implemented — no ranges, no coercion, no build-metadata significance.
+ *
+ * @module addons/semver
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareSemver = compareSemver;
+/** x.y.z with optional prerelease and build metadata (build metadata ignored). */
+const SEMVER_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+/**
+ * Compare prerelease identifiers (semver §11.4).
+ *
+ * `undefined` (no prerelease) sorts after any prerelease: `1.0.0 > 1.0.0-alpha`.
+ * Numeric identifiers compare numerically, alphanumeric compare ASCII, and
+ * numeric < alphanumeric. A shorter list sorts first when otherwise equal.
+ */
+function comparePrerelease(a, b) {
+    if (a === undefined && b === undefined)
+        return 0;
+    if (a === undefined)
+        return 1;
+    if (b === undefined)
+        return -1;
+    const as = a.split('.');
+    const bs = b.split('.');
+    const len = Math.max(as.length, bs.length);
+    for (let i = 0; i < len; i++) {
+        const x = as[i];
+        const y = bs[i];
+        if (x === undefined)
+            return -1;
+        if (y === undefined)
+            return 1;
+        const xn = /^\d+$/.test(x);
+        const yn = /^\d+$/.test(y);
+        if (xn && yn) {
+            const nx = parseInt(x, 10);
+            const ny = parseInt(y, 10);
+            if (nx !== ny)
+                return nx < ny ? -1 : 1;
+        }
+        else {
+            if (xn !== yn)
+                return xn ? -1 : 1;
+            if (x !== y)
+                return x < y ? -1 : 1;
+        }
+    }
+    return 0;
+}
+/**
+ * Compare two semver strings: negative when `a < b`, zero when equal,
+ * positive when `a > b`. Build metadata (`+...`) is ignored.
+ *
+ * A version that does not parse as semver compares equal to anything
+ * (returns 0) — callers treat an unparseable version conservatively as
+ * "not a downgrade" rather than refusing the install.
+ */
+function compareSemver(a, b) {
+    const ma = SEMVER_RE.exec(a.trim());
+    const mb = SEMVER_RE.exec(b.trim());
+    if (!ma || !mb)
+        return 0;
+    for (let i = 1; i <= 3; i++) {
+        const x = parseInt(ma[i], 10);
+        const y = parseInt(mb[i], 10);
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return comparePrerelease(ma[4], mb[4]);
+}
+//# sourceMappingURL=semver.js.map

package/dist/addons/semver.js.map

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

package/dist/addons/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HomeGraph addon registry types.
+ *
+ * The addon registry is repository-level state stored in
+ * `${getHomeGraphDir(repoRoot)}/addons.json`. The loader only ever loads
+ * addons that are explicitly registered AND enabled — scanning installed
+ * packages is deliberately unsupported (an addon is executable code; loading
+ * it requires an explicit user action).
+ *
+ * @module addons/types
+ */
+/** A single registered addon entry in `addons.json`. */
+export interface AddonRegistryEntry {
+    /**
+     * npm package name — the registry primary key
+     * (e.g. `"@scope/homegraph-jira"`).
+     */
+    name: string;
+    /**
+     * Concrete version resolved at install time — never a range, so the
+     * registry stays reproducible and audit-friendly.
+     */
+    version: string;
+    /** Whether the addon is loaded at runtime. */
+    enabled: boolean;
+    /**
+     * Where the package was installed from. Drives the install version gate
+     * (a local path is re-pointed by npm, never downgraded by us) and
+     * `update --latest` (registry packages only — local paths have no dist-tag).
+     */
+    source: 'registry' | 'local';
+}
+/** Shape of the repository-level addon registry file. */
+export interface AddonRegistry {
+    addons: AddonRegistryEntry[];
+}
+/**
+ * An addon that passed validation and was loaded at runtime. Consumers
+ * filter by export shape (e.g. spec-mine looks for `enrich`/`buildPrompt`);
+ * the generic layer does not know about any specific hook.
+ */
+export interface LoadedAddon {
+    name: string;
+    version: string;
+    /**
+     * Module namespace. A `default` export is merged into the namespace so
+     * both `export default { ... }` and named exports work.
+     */
+    module: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/addons/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/addons/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * HomeGraph addon registry types.
+ *
+ * The addon registry is repository-level state stored in
+ * `${getHomeGraphDir(repoRoot)}/addons.json`. The loader only ever loads
+ * addons that are explicitly registered AND enabled — scanning installed
+ * packages is deliberately unsupported (an addon is executable code; loading
+ * it requires an explicit user action).
+ *
+ * @module addons/types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/addons/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/addons/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}

package/dist/addons/validate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Addon package validation.
+ *
+ * An addon package must:
+ *   1. have a parseable `package.json`,
+ *   2. declare `"homegraph": { "addon": true, "api": 1 }` (contract version),
+ *   3. resolve to a loadable entry point (exports / main / index.js),
+ *   4. export `enrich` or `buildPrompt` (at least one).
+ *
+ * Used both at install time (fail fast, before registering) and at runtime
+ * (skip with a warning, never crash the host flow).
+ *
+ * @module addons/validate
+ */
+/** Result of validating an installed addon package. */
+export interface AddonValidation {
+    ok: boolean;
+    /** Human-readable reason when `ok` is false. */
+    reason?: string;
+    /** Package version from package.json (set when `ok`). */
+    version?: string;
+    /** Resolved entry point relative to the package dir (set when `ok`). */
+    entryPoint?: string;
+    /** Loaded module namespace (set when `ok`). */
+    module?: Record<string, unknown>;
+}
+/**
+ * Resolve the addon entry point from package.json:
+ * `exports` (string | { "." | "import" | "default" | nested conditions })
+ * → `main` → `index.js`.
+ */
+export declare function resolveEntryPoint(pkg: unknown): string | null;
+/**
+ * Validate an installed addon package directory. Async because validation
+ * loads the module (which also double-checks the export shape).
+ */
+export declare function validateAddonPackage(pkgDir: string): Promise<AddonValidation>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/addons/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAsB7D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA8E1B"}