@g3nomaly/core 0.3.0 → 0.3.2

package/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2026 G3NTs - G3nomaly
+
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## 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/dist/cli/commands/add.d.ts

@@ -0,0 +1,37 @@
+import type { BaseFileEntry, BaseRegistry } from "../../registry/types";
+import type { FileSource, InstallerIO } from "../../installer/types";
+import type { AddDialogues, EntrySource, InstallOptions, InstallTarget } from "../types";
+/**
+ * @brief Builds the hasher of a package's current version of each file.
+ *
+ * @param source - Source of each file's content in the package.
+ * @param io - Installer I/O that hashes copied files.
+ * @returns Function giving the hash of a file's package content, empty when the package has none.
+ */
+export declare function latestHashFrom(source: FileSource, io: InstallerIO): (file: BaseFileEntry) => Promise<string>;
+/**
+ * @brief Builds one picker choice per registry key, labelled with its description.
+ *
+ * @param registry - Registry whose keys are offered.
+ * @returns Choices with the key as value.
+ */
+export declare function pickerChoices(registry: BaseRegistry): {
+    value: string;
+    label: string;
+}[];
+/**
+ * @brief Installs entries into every target, keeping locally modified files.
+ *
+ * With no keys and an `onNoValue` dialogue the user picks from the registry. Local
+ * changes prompt restore/fork/skip through `onCollision` unless `--force`.
+ * The caller resolves keys before and saves each target's store after.
+ *
+ * @param registry - Entries available to install, by key.
+ * @param targets - Destinations to install into.
+ * @param source - Source of each entry's files.
+ * @param keys - Keys to install; empty to pick from the registry.
+ * @param options - Force, dry run and preset answers.
+ * @param dialogues - Dialogues for the picker and for local changes.
+ */
+export declare function addEntries(registry: BaseRegistry, targets: InstallTarget[], source: EntrySource, keys: string[], options?: InstallOptions, dialogues?: AddDialogues): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIxE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKrE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAM5G;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAKxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,EAC5B,SAAS,GAAE,YAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/cli/commands/add.js

@@ -0,0 +1,99 @@
+// packages/core/src/cli/commands/add.ts
+import chalk from "chalk";
+import { z } from "zod";
+import { get } from "../../registry/registry.selectors";
+import { register } from "../../registry/registry.mutations";
+import { applyClassifications, classifyFiles, recordedHashes } from "../../installer";
+import { createInstallerIO } from "../../installer/io";
+import { ConflictDecision, FileState } from "../../installer/types";
+import { hashString } from "../../hash/hash";
+import { guardCancel } from "../../utils/prompt";
+import { runDialogueValue } from "../dialogue";
+import { chooseConflict, forkEntry } from "./conflict";
+import { c, lineSuccess, lineWarn, lineInfo } from "../theme";
+const KeysSchema = z.array(z.string());
+/**
+ * @brief Builds the hasher of a package's current version of each file.
+ *
+ * @param source - Source of each file's content in the package.
+ * @param io - Installer I/O that hashes copied files.
+ * @returns Function giving the hash of a file's package content, empty when the package has none.
+ */
+export function latestHashFrom(source, io) {
+    return async (file) => {
+        const content = await source(file);
+        if (content === null)
+            return "";
+        return content.kind === "copy" ? io.hashFile(content.sourcePath) : hashString(content.content);
+    };
+}
+/**
+ * @brief Builds one picker choice per registry key, labelled with its description.
+ *
+ * @param registry - Registry whose keys are offered.
+ * @returns Choices with the key as value.
+ */
+export function pickerChoices(registry) {
+    return Object.entries(registry).map(([key, meta]) => ({
+        value: key,
+        label: `${c.key(key)}  ${chalk.dim("—")}  ${chalk.dim(meta.description ?? meta.name)}`,
+    }));
+}
+/**
+ * @brief Installs entries into every target, keeping locally modified files.
+ *
+ * With no keys and an `onNoValue` dialogue the user picks from the registry. Local
+ * changes prompt restore/fork/skip through `onCollision` unless `--force`.
+ * The caller resolves keys before and saves each target's store after.
+ *
+ * @param registry - Entries available to install, by key.
+ * @param targets - Destinations to install into.
+ * @param source - Source of each entry's files.
+ * @param keys - Keys to install; empty to pick from the registry.
+ * @param options - Force, dry run and preset answers.
+ * @param dialogues - Dialogues for the picker and for local changes.
+ */
+export async function addEntries(registry, targets, source, keys, options = {}, dialogues = {}) {
+    const io = createInstallerIO();
+    if (keys.length === 0 && dialogues.onNoValue !== undefined) {
+        const picked = guardCancel(await runDialogueValue(dialogues.onNoValue, { keyChoices: pickerChoices(registry) }, options.answers));
+        keys = KeysSchema.parse(picked ?? []);
+    }
+    for (const target of targets) {
+        if (targets.length > 1)
+            console.log(c.header(target.label));
+        for (const key of keys) {
+            const meta = registry[key];
+            if (!meta)
+                continue;
+            const installed = get(target.store, key);
+            const fileSource = await source(meta);
+            const classifications = await classifyFiles(meta.files, target.installDir, recordedHashes(installed), io, latestHashFrom(fileSource, io));
+            const hasLocalChanges = classifications.some((cl) => cl.state >= FileState.UserOnly);
+            const choice = hasLocalChanges
+                ? await chooseConflict(dialogues.onCollision, key, installed ?? meta, target, options)
+                : { decision: ConflictDecision.Keep };
+            if (choice.decision === ConflictDecision.Fork) {
+                await forkEntry(target, key, installed ?? meta, choice.forkKey, io);
+                continue;
+            }
+            const result = await applyClassifications(classifications, fileSource, { decision: choice.decision, force: options.force ?? false }, io);
+            for (const file of result.missingSource) {
+                console.log(lineWarn(`No content for ${c.file(file)} in the package source — skipped`));
+            }
+            for (const file of result.kept) {
+                console.log(lineWarn(`${c.file(file)} has local changes — skipped ${chalk.dim(`(use ${c.flag("-f")} to overwrite)`)}`));
+            }
+            if (result.written.length > 0) {
+                console.log(lineSuccess(`Installed ${c.key(key)} ${chalk.dim(`(${result.written.length} file${result.written.length === 1 ? "" : "s"})`)}`));
+            }
+            else if (result.kept.length === 0) {
+                console.log(lineInfo(`${c.key(key)} — already up to date`));
+            }
+            // The recorded hashes are the baseline that lets later runs tell user
+            // edits from package changes; a skipped file keeps its install-time hash.
+            register(target.store, key, { ...meta, files: result.files.map((f) => ({ ...f, version: meta.version })) });
+        }
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,EAAe;IAChE,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE;KACvF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAsB,EACtB,OAAwB,EACxB,MAAmB,EACnB,IAAc,EACd,OAAO,GAAmB,EAAE,EAC5B,SAAS,GAAiB,EAAE;IAE5B,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAE/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAClI,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,SAAS,GAAS,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,UAAU,GAAQ,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YAE1I,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,eAAe;gBAC5B,CAAC,CAAC,MAAM,cAAc,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;gBACtF,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,gBAAgB,CAAC,IAAI,EAAE,CAAC;gBAC9C,MAAM,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACpE,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,eAAe,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAEzI,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAC1F,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1H,CAAC;YACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,QAAQ,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/I,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;YAC9D,CAAC;YAED,sEAAsE;YACtE,0EAA0E;YAC1E,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/commands/conflict.d.ts

@@ -0,0 +1,52 @@
+import type { BaseRegistryEntry } from "../../registry/types";
+import { ConflictDecision } from "../../installer/types";
+import type { InstallerIO } from "../../installer/types";
+import type { Dialogue } from "../dialogue";
+import type { InstallInput, InstallOptions, InstallTarget } from "../types";
+/**
+ * @brief What to do with one entry that has local changes.
+ *
+ * @property decision - Keep (skip), Overwrite (restore) or Fork.
+ * @property forkKey - Key the entry moves to, on a fork only.
+ */
+export type ConflictChoice = {
+    decision: typeof ConflictDecision.Keep | typeof ConflictDecision.Overwrite;
+} | {
+    decision: typeof ConflictDecision.Fork;
+    forkKey: string;
+};
+/**
+ * @brief Returns the key an installed entry was forked from.
+ *
+ * @param entry - Installed entry to check.
+ * @returns The original key, or `undefined` when the entry is no fork.
+ */
+export declare function forkedFrom(entry: BaseRegistryEntry): string | undefined;
+/**
+ * @brief Asks what to do with `key`, whose files in `target` have local changes: restore, fork or skip.
+ *
+ * `--force` restores without asking. No dialogue, a cancelled one, or a fork onto a key the target
+ * already holds skips.
+ *
+ * @param dialogue - Asks for the decision; `undefined` skips.
+ * @param key - Key of the entry with local changes.
+ * @param entry - The entry as installed, or as offered; its `name` seeds the suggested fork key.
+ * @param target - Install target the entry is in.
+ * @param options - Force flag and preset answers.
+ * @returns The decision, with the key a fork moves to.
+ */
+export declare function chooseConflict(dialogue: Dialogue<InstallInput> | undefined, key: string, entry: BaseRegistryEntry, target: InstallTarget, options: InstallOptions): Promise<ConflictChoice>;
+/**
+ * @brief Moves `key` in `target` to the local entry `forkKey`: the files `base` lists that are on disk, each
+ * with its current hash, and `forkedFrom` naming `key`. Writes no file, so imports of the files keep
+ * working.
+ *
+ * @param target - Install target holding the entry.
+ * @param key - Key of the entry being forked.
+ * @param base - The entry as installed, or as offered when the target never recorded it
+ * @param forkKey - Key the local entry takes.
+ * @param io - Installer I/O that hashes the files on disk.
+ * @throws {Error} When none of the entry's files is on disk
+ */
+export declare function forkEntry(target: InstallTarget, key: string, base: BaseRegistryEntry, forkKey: string, io: InstallerIO): Promise<void>;
+//# sourceMappingURL=conflict.d.ts.map

package/dist/cli/commands/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/conflict.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG5E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,OAAO,gBAAgB,CAAC,IAAI,GAAG,OAAO,gBAAgB,CAAC,SAAS,CAAA;CAAE,GAC9E;IAAE,QAAQ,EAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAMhE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAGvE;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,EAC5C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5I"}

package/dist/cli/commands/conflict.js

@@ -0,0 +1,88 @@
+// packages/core/src/cli/commands/conflict.ts
+import path from "node:path";
+import chalk from "chalk";
+import { z } from "zod";
+import { get } from "../../registry/registry.selectors";
+import { register, unregister } from "../../registry/registry.mutations";
+import { ConflictDecision } from "../../installer/types";
+import { runDialogue } from "../dialogue";
+import { c, lineSuccess, lineWarn } from "../theme";
+const SKIP = { decision: ConflictDecision.Keep };
+const ForkSchema = z.object({ forkedFrom: z.string().min(1) });
+/**
+ * @brief Returns the key an installed entry was forked from.
+ *
+ * @param entry - Installed entry to check.
+ * @returns The original key, or `undefined` when the entry is no fork.
+ */
+export function forkedFrom(entry) {
+    const fork = ForkSchema.safeParse(entry);
+    return fork.success ? fork.data.forkedFrom : undefined;
+}
+const ConflictAnswersSchema = z.object({
+    conflict: z.union([z.literal(ConflictDecision.Keep), z.literal(ConflictDecision.Overwrite), z.literal(ConflictDecision.Fork)]),
+    forkName: z.string().trim().min(1).optional(),
+});
+/**
+ * @brief Asks what to do with `key`, whose files in `target` have local changes: restore, fork or skip.
+ *
+ * `--force` restores without asking. No dialogue, a cancelled one, or a fork onto a key the target
+ * already holds skips.
+ *
+ * @param dialogue - Asks for the decision; `undefined` skips.
+ * @param key - Key of the entry with local changes.
+ * @param entry - The entry as installed, or as offered; its `name` seeds the suggested fork key.
+ * @param target - Install target the entry is in.
+ * @param options - Force flag and preset answers.
+ * @returns The decision, with the key a fork moves to.
+ */
+export async function chooseConflict(dialogue, key, entry, target, options) {
+    if (options.force === true)
+        return { decision: ConflictDecision.Overwrite };
+    if (dialogue === undefined)
+        return SKIP;
+    const input = { key: c.key(key), target: c.target(target.label), forkName: `${entry.name}-local` };
+    const record = await runDialogue(dialogue, input, options.answers);
+    if (typeof record === "symbol")
+        return SKIP;
+    const answers = ConflictAnswersSchema.safeParse(record);
+    if (!answers.success)
+        return SKIP;
+    const { conflict, forkName } = answers.data;
+    if (conflict !== ConflictDecision.Fork)
+        return { decision: conflict };
+    if (forkName === undefined)
+        return SKIP;
+    if (get(target.store, forkName) !== undefined) {
+        console.log(lineWarn(`${c.key(forkName)} is already installed — ${c.key(key)} skipped, nothing forked`));
+        return SKIP;
+    }
+    return { decision: ConflictDecision.Fork, forkKey: forkName };
+}
+/**
+ * @brief Moves `key` in `target` to the local entry `forkKey`: the files `base` lists that are on disk, each
+ * with its current hash, and `forkedFrom` naming `key`. Writes no file, so imports of the files keep
+ * working.
+ *
+ * @param target - Install target holding the entry.
+ * @param key - Key of the entry being forked.
+ * @param base - The entry as installed, or as offered when the target never recorded it
+ * @param forkKey - Key the local entry takes.
+ * @param io - Installer I/O that hashes the files on disk.
+ * @throws {Error} When none of the entry's files is on disk
+ */
+export async function forkEntry(target, key, base, forkKey, io) {
+    const files = [];
+    for (const file of base.files) {
+        const destPath = path.join(target.installDir, file.path);
+        if (io.exists(destPath))
+            files.push({ ...file, hash: await io.hashFile(destPath) });
+    }
+    if (files.length === 0)
+        throw new Error(`cannot fork ${key}: none of its files is on disk`);
+    const fork = { ...base, forkedFrom: key, files };
+    unregister(target.store, key);
+    register(target.store, forkKey, fork);
+    console.log(lineSuccess(`Forked ${c.key(key)} as ${c.key(forkKey)} ${chalk.dim("— updates leave it alone")}`));
+}
+//# sourceMappingURL=conflict.js.map

package/dist/cli/commands/conflict.js.map

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

package/dist/cli/commands/installFromSources.d.ts

@@ -0,0 +1,78 @@
+import type { z } from "zod";
+import type { InstallManifest } from "../../installer/manifest";
+import type { OriginEntry } from "../../installer/origin";
+import type { SourceRegistry } from "../../installer/sourceRegistry";
+import type { EntrySource, InstallOptions, InstallTarget } from "../types";
+/**
+ * @brief An install target together with the manifest that backs its store.
+ *
+ * @property manifest - Manifest the store is saved to.
+ */
+export interface ManifestTarget extends InstallTarget {
+    manifest: InstallManifest;
+}
+/**
+ * @brief What an installer tells the install commands about itself.
+ *
+ * @property bin - Installer binary, for the hints it prints, e.g. `g3n-skills`.
+ * @property noun - What one entry is called, e.g. `skill`.
+ * @property entrySchema - Schema installed entries are parsed with.
+ * @property fileSource - Where entry files come from; copying out of each source's checkout (`entrySource`) when absent.
+ */
+export interface InstallCommandContext<T extends OriginEntry> {
+    bin: string;
+    noun: string;
+    entrySchema: z.ZodType<T>;
+    fileSource?: (registry: SourceRegistry<T>) => EntrySource;
+}
+/**
+ * @brief Runs after a target's manifest is saved, with the keys just installed, updated or removed.
+ *
+ * @param target - Target whose manifest was saved.
+ * @param keys - Keys just installed, updated or removed.
+ */
+export type AfterTarget = (target: ManifestTarget, keys: string[]) => void | Promise<void>;
+/**
+ * @brief Installs entries or whole groups from a source registry into every target,
+ * each with its dependencies from any source, and saves each manifest. With
+ * no names the user picks from what the sources offer. A key an installed
+ * fork stands in for is not installed.
+ *
+ * @param names - As typed: `<name>` or `<name>@<source>`, a name being an entry key or a group
+ * @param targets - Install targets, each with its manifest.
+ * @param registry - Source registry the names are resolved against.
+ * @param options - Force, dry run and preset answers.
+ * @param context - What the installer calls itself.
+ * @param after - Runs after each manifest is saved.
+ */
+export declare function addFromSources<T extends OriginEntry>(targets: readonly ManifestTarget[], names: readonly string[], registry: SourceRegistry<T>, options: InstallOptions, context: InstallCommandContext<T>, after?: AfterTarget): Promise<void>;
+/**
+ * @brief Re-installs installed entries from the source each one was installed
+ * from, at that source's current revision; with no names, everything
+ * installed. Forks are reported and left alone. Names installed in no
+ * target are reported first, and the sources are only opened once something
+ * is left to update. Dependencies an entry gained since install are
+ * reported, not installed.
+ *
+ * @param targets - Install targets, each with its manifest.
+ * @param names - Names to update; empty to update everything installed.
+ * @param openRegistry - Opens the source registry; the command disposes it
+ * @param options - Force, dry run and preset answers.
+ * @param context - What the installer calls itself.
+ * @param after - Runs after each manifest is saved.
+ */
+export declare function updateFromSources<T extends OriginEntry>(targets: readonly ManifestTarget[], names: readonly string[], openRegistry: () => Promise<SourceRegistry<T>>, options: InstallOptions, context: InstallCommandContext<T>, after?: AfterTarget): Promise<void>;
+/**
+ * @brief Removes installed entries, or whole groups, from every target and saves
+ * each manifest. Works from the manifests alone, so no source needs to be
+ * reachable; installed dependents are offered for removal too. With no names
+ * the user picks from what is installed.
+ *
+ * @param after - Gets the keys a target no longer holds, to clean up what the installer added beside the files
+ * @param targets - Install targets, each with its manifest.
+ * @param names - Names to remove; empty to pick from what is installed.
+ * @param options - Force flag and preset answers.
+ * @param context - What the installer calls itself.
+ */
+export declare function removeFromTargets<T extends OriginEntry>(targets: readonly ManifestTarget[], names: readonly string[], options: InstallOptions, context: InstallCommandContext<T>, after?: AfterTarget): Promise<void>;
+//# sourceMappingURL=installFromSources.d.ts.map

package/dist/cli/commands/installFromSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installFromSources.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/installFromSources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAMlF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAK3E;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,WAAW;IAC1D,GAAG,EAAU,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA0B3F;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,EACxD,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACjC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAC3D,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAC9C,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACjC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAC3D,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACjC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAkBf"}