@g3nomaly/core 0.3.0 → 0.3.1

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,17 @@
+import type { BaseFileEntry, BaseRegistry } from "../../registry/types";
+import type { FileSource, InstallerIO } from "../../installer/types";
+import type { AddDialogues, EntrySource, InstallOptions, InstallTarget } from "../types";
+/** Hash of the package's current version of a file, derived from its content. */
+export declare function latestHashFrom(source: FileSource, io: InstallerIO): (file: BaseFileEntry) => Promise<string>;
+export declare function pickerChoices(registry: BaseRegistry): {
+    value: string;
+    label: string;
+}[];
+/**
+ * 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 keep/overwrite through `onCollision` unless `--force`.
+ * The caller resolves keys before and saves each target's store after.
+ */
+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;AAIrE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzF,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAM5G;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAKxF;AAED;;;;;GAKG;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,CA4Cf"}

package/dist/cli/commands/add.js

@@ -0,0 +1,76 @@
+// 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 { c, lineSuccess, lineWarn, lineInfo } from "../theme";
+const KeysSchema = z.array(z.string());
+/** Hash of the package's current version of a file, derived from its content. */
+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);
+    };
+}
+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)}`,
+    }));
+}
+/**
+ * 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 keep/overwrite through `onCollision` unless `--force`.
+ * The caller resolves keys before and saves each target's store after.
+ */
+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 fileSource = await source(meta);
+            const classifications = await classifyFiles(meta.files, target.installDir, recordedHashes(get(target.store, key)), io, latestHashFrom(fileSource, io));
+            let decision = ConflictDecision.Keep;
+            const hasLocalChanges = classifications.some((cl) => cl.state >= FileState.UserOnly);
+            if (hasLocalChanges && !options.force && dialogues.onCollision !== undefined) {
+                const answer = await runDialogueValue(dialogues.onCollision, { key: c.key(key), target: c.target(target.label) }, options.answers);
+                if (answer === ConflictDecision.Overwrite)
+                    decision = ConflictDecision.Overwrite;
+            }
+            const result = await applyClassifications(classifications, fileSource, { 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 — kept ${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`));
+            }
+            // Always record the on-disk state — its hashes are the baseline that
+            // lets later runs tell user edits from package changes.
+            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":"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"}

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

@@ -0,0 +1,49 @@
+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";
+/** An install target together with the manifest that backs its store. */
+export interface ManifestTarget extends InstallTarget {
+    manifest: InstallManifest;
+}
+/** What an installer tells the install commands about itself. */
+export interface InstallCommandContext<T extends OriginEntry> {
+    /** Installer binary, for the hints it prints, e.g. `g3n-skills` */
+    bin: string;
+    /** What one entry is called, e.g. `skill` */
+    noun: string;
+    entrySchema: z.ZodType<T>;
+    /** Where entry files come from; copying out of each source's checkout (`entrySource`) when absent */
+    fileSource?: (registry: SourceRegistry<T>) => EntrySource;
+}
+/** Runs after a target's manifest is saved, with the keys just installed, updated or removed. */
+export type AfterTarget = (target: ManifestTarget, keys: string[]) => void | Promise<void>;
+/**
+ * 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.
+ *
+ * @param names - As typed: `<name>` or `<name>@<source>`, a name being an entry key or a group
+ */
+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>;
+/**
+ * Re-installs installed entries from the source each one was installed
+ * from, at that source's current revision; with no names, everything
+ * installed. 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 openRegistry - Opens the source registry; the command disposes it
+ */
+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>;
+/**
+ * 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
+ */
+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,yEAAyE;AACzE,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,iEAAiE;AACjE,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,WAAW;IAC1D,mEAAmE;IACnE,GAAG,EAAU,MAAM,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAS,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC;CAC3D;AAED,iGAAiG;AACjG,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAc3F;;;;;;GAMG;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,CAgBf;AAYD;;;;;;;;GAQG;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,CA+Cf;AAED;;;;;;;GAOG;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"}

package/dist/cli/commands/installFromSources.js

@@ -0,0 +1,138 @@
+import { installedEntries, saveInstallManifest } from "../../installer/manifest";
+import { installedOrigins, resolveInstalled, resolveRequests, resolveUpdates } from "../../installer/resolve";
+import { entrySource, offerRegistry, offers } from "../../installer/sourceRegistry";
+import { runDialogueValue } from "../dialogue";
+import { cascadeDialogue, incompleteDialogue, notInstalledDialogue, overwriteDialogue, removeChangedDialogue, selectRemovalDialogue } from "../installDialogues";
+import { pickOffers } from "../pick";
+import { reportResolution } from "../report";
+import { c, lineError, lineInfo, lineWarn } from "../theme";
+import { addEntries } from "./add";
+import { removeEntries } from "./remove";
+import { updateEntries } from "./update";
+/** The context's file source for a registry, or a copy out of each source's checkout. */
+function filesFrom(registry, context) {
+    return context.fileSource?.(registry) ?? entrySource(registry);
+}
+/** Installed entries of every target, each key once; the first target wins on a clash. */
+function installedAcross(targets, schema) {
+    const installed = {};
+    for (const target of targets)
+        for (const [key, entry] of Object.entries(installedEntries(target.manifest, schema)))
+            installed[key] ??= entry;
+    return installed;
+}
+/**
+ * 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.
+ *
+ * @param names - As typed: `<name>` or `<name>@<source>`, a name being an entry key or a group
+ */
+export async function addFromSources(targets, names, registry, options, context, after) {
+    const available = offers(registry);
+    const requested = names.length > 0 ? [...names] : await pickOffers(available, context.noun, options.answers);
+    if (requested.length === 0)
+        return;
+    const origins = installedOrigins(targets.map((t) => installedEntries(t.manifest, context.entrySchema)));
+    const resolution = resolveRequests(requested, available, origins);
+    await reportResolution(resolution, context, options.answers);
+    const selected = [...resolution.entries.values()];
+    const keys = selected.map((s) => s.key);
+    await addEntries(offerRegistry(selected), [...targets], filesFrom(registry, context), keys, options, { onCollision: overwriteDialogue });
+    for (const target of targets) {
+        saveInstallManifest(target.manifest, context.entrySchema);
+        await after?.(target, keys);
+    }
+}
+/** Warns about dependencies an entry now has that the target does not hold. */
+function reportNewDependencies(updated, installed, context) {
+    for (const { key, entry } of updated) {
+        const missing = (entry.registryDependencies ?? []).filter((dep) => installed[dep] === undefined);
+        if (missing.length > 0) {
+            console.log(lineWarn(`${c.key(key)} now depends on ${missing.map((m) => c.key(m)).join(", ")}: run ${c.cmd(`${context.bin} add ${key}`)} to install them`));
+        }
+    }
+}
+/**
+ * Re-installs installed entries from the source each one was installed
+ * from, at that source's current revision; with no names, everything
+ * installed. 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 openRegistry - Opens the source registry; the command disposes it
+ */
+export async function updateFromSources(targets, names, openRegistry, options, context, after) {
+    const plans = targets.map((target) => {
+        const installed = installedEntries(target.manifest, context.entrySchema);
+        return { target, installed, ...(names.length > 0 ? resolveInstalled(names, installed) : { keys: Object.keys(installed), unknown: [] }) };
+    });
+    const unknown = [...new Set(plans.flatMap((p) => p.unknown))].filter((name) => plans.every((p) => p.unknown.includes(name)));
+    if (unknown.length > 0) {
+        const list = unknown.map((k) => c.key(k)).join(", ");
+        console.error(lineError(`Not installed: ${list}. Run ${c.cmd(`${context.bin} add`)} to install them.`));
+        const proceed = plans.some((p) => p.keys.length > 0)
+            && (await runDialogueValue(notInstalledDialogue, { unknown: list }, options.answers)) === true;
+        if (!proceed)
+            process.exit(1);
+    }
+    if (plans.every((p) => p.keys.length === 0)) {
+        console.log(lineInfo("Nothing to update."));
+        return;
+    }
+    const registry = await openRegistry();
+    const available = offers(registry);
+    const origins = installedOrigins(plans.map((p) => p.installed));
+    try {
+        for (const plan of plans) {
+            if (targets.length > 1)
+                console.log(c.header(plan.target.label));
+            if (plan.keys.length === 0) {
+                console.log(lineInfo("Nothing to update."));
+                continue;
+            }
+            const { offers: updated, missing } = resolveUpdates(plan.keys, plan.installed, available, origins);
+            reportNewDependencies(updated, plan.installed, context);
+            for (const key of missing) {
+                console.log(lineWarn(`${c.key(key)}: its source ${c.key(plan.installed[key]?.origin.source ?? "")} is not registered or no longer offers it, left as is`));
+            }
+            if (updated.length === 0)
+                continue;
+            const keys = updated.map((u) => u.key);
+            await updateEntries(offerRegistry(updated), [plan.target], filesFrom(registry, context), keys, options, { onCollision: overwriteDialogue });
+            if (options.dryRun !== true) {
+                saveInstallManifest(plan.target.manifest, context.entrySchema);
+                await after?.(plan.target, keys);
+            }
+        }
+    }
+    finally {
+        registry.dispose();
+    }
+}
+/**
+ * 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
+ */
+export async function removeFromTargets(targets, names, options, context, after) {
+    const installed = installedAcross(targets, context.entrySchema);
+    // Unknown names stay in the list so the command reports them as "not installed".
+    const { keys, unknown } = resolveInstalled(names, installed);
+    const before = targets.map((t) => Object.keys(installedEntries(t.manifest, context.entrySchema)));
+    await removeEntries(installed, [...targets], [...keys, ...unknown], options, {
+        onNoValue: selectRemovalDialogue(context.noun),
+        onCascade: cascadeDialogue,
+        onCollision: removeChangedDialogue,
+        onIncomplete: incompleteDialogue,
+    });
+    for (const [index, target] of targets.entries()) {
+        saveInstallManifest(target.manifest, context.entrySchema);
+        const still = installedEntries(target.manifest, context.entrySchema);
+        await after?.(target, (before[index] ?? []).filter((key) => still[key] === undefined));
+    }
+}
+//# sourceMappingURL=installFromSources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installFromSources.js","sourceRoot":"","sources":["../../../src/cli/commands/installFromSources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAEpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjK,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqBzC,yFAAyF;AACzF,SAAS,SAAS,CAAwB,QAA2B,EAAE,OAAiC;IACtG,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,0FAA0F;AAC1F,SAAS,eAAe,CAAwB,OAAkC,EAAE,MAAoB;IACtG,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;IAC7I,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAkC,EAClC,KAAwB,EACxB,QAA2B,EAC3B,OAAuB,EACvB,OAAiC,EACjC,KAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7G,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEnC,MAAM,OAAO,GAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3G,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzI,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,qBAAqB,CAAwB,OAAkC,EAAE,SAA4B,EAAE,OAAiC;IACvJ,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;QACjG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,QAAQ,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC9J,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAkC,EAClC,KAAwB,EACxB,YAA8C,EAC9C,OAAuB,EACvB,OAAiC,EACjC,KAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACzE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3I,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7H,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,kBAAkB,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxG,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;eAC/C,CAAC,MAAM,gBAAgB,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;QACjG,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAI,MAAM,YAAY,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,OAAO,GAAK,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACnG,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACxD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,uDAAuD,CAAC,CAAC,CAAC;YAC7J,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC5I,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC5B,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC/D,MAAM,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAkC,EAClC,KAAwB,EACxB,OAAuB,EACvB,OAAiC,EACjC,KAAmB;IAEnB,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChE,iFAAiF;IACjF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,EAAE;QAC3E,SAAS,EAAK,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC;QACjD,SAAS,EAAK,eAAe;QAC7B,WAAW,EAAG,qBAAqB;QACnC,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { BaseRegistry } from "../../registry/types";
+import type { LSOptions } from "../types";
+import type { OriginEntry } from "../../installer/origin";
+import type { SourceRegistry } from "../../installer/sourceRegistry";
+import type { RegisteredSource } from "../../sources/types";
+/** Lists the entries of a registry, grouped by each entry's `group`. */
+export declare function lsEntries(registry: BaseRegistry, options?: LSOptions): void;
+/**
+ * Lists what each source of a source registry offers: a header per source
+ * with where it comes from when `sources` holds its spec, then its entries by group, `●` marking the ones
+ * `installed` holds. With `json`, prints every offer as `{ key, ...entry }`.
+ *
+ * @param installed - Installed entries by key, to mark; empty to mark nothing
+ */
+export declare function lsSourceRegistry<T extends OriginEntry>(registry: SourceRegistry<T>, sources: readonly RegisteredSource[], installed: Record<string, OriginEntry>, options?: LSOptions): void;
+//# sourceMappingURL=ls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE,SAAc,GAAG,IAAI,CAiB/E;AASD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,OAAO,GAAE,SAAc,GACtB,IAAI,CAwBN"}

package/dist/cli/commands/ls.js

@@ -0,0 +1,65 @@
+// packages/core/src/cli/commands/ls.ts
+import chalk from "chalk";
+import { c } from "../theme";
+import { offers } from "../../installer/sourceRegistry";
+import { describeSource } from "../../sources/checkout";
+/** Lists the entries of a registry, grouped by each entry's `group`. */
+export function lsEntries(registry, options = {}) {
+    if (options.json === true) {
+        console.log(JSON.stringify(registry, null, 2));
+        return;
+    }
+    const byGroup = {};
+    for (const [key, meta] of Object.entries(registry))
+        (byGroup[meta.group ?? "default"] ??= []).push(key);
+    for (const group of Object.keys(byGroup).sort()) {
+        console.log(c.header(group));
+        for (const key of (byGroup[group] ?? []).sort()) {
+            const meta = registry[key];
+            console.log(`  ${c.key(key.padEnd(26))} ${chalk.dim(meta?.description ?? "")}`);
+        }
+        console.log();
+    }
+}
+/** ` at <commit>` or ` v<version>` of the checkout an entry was read from. */
+function revision(origin) {
+    if (origin?.commit !== undefined)
+        return ` at ${origin.commit.slice(0, 7)}`;
+    if (origin?.version !== undefined)
+        return ` v${origin.version}`;
+    return "";
+}
+/**
+ * Lists what each source of a source registry offers: a header per source
+ * with where it comes from when `sources` holds its spec, then its entries by group, `●` marking the ones
+ * `installed` holds. With `json`, prints every offer as `{ key, ...entry }`.
+ *
+ * @param installed - Installed entries by key, to mark; empty to mark nothing
+ */
+export function lsSourceRegistry(registry, sources, installed, options = {}) {
+    if (options.json === true) {
+        console.log(JSON.stringify(offers(registry).map(({ key, entry }) => ({ key, ...entry })), null, 2));
+        return;
+    }
+    for (const [name, store] of registry.sources) {
+        const listed = Object.entries(store.store.state).sort(([a], [b]) => a.localeCompare(b));
+        if (listed.length === 0)
+            continue;
+        const spec = sources.find((s) => s.name === name)?.spec;
+        const from = spec === undefined ? "" : describeSource(spec);
+        console.log(chalk.bold(`${name}  ${chalk.dim(`${from}${revision(listed[0]?.[1].origin)}`)}`));
+        const byGroup = {};
+        for (const [key, entry] of listed)
+            (byGroup[entry.group ?? "default"] ??= []).push([key, entry]);
+        for (const group of Object.keys(byGroup).sort()) {
+            console.log(c.header(group));
+            for (const [key, entry] of byGroup[group] ?? []) {
+                const mark = installed[key]?.origin.source === name ? chalk.green("●") : " ";
+                const label = `${c.key(key)} ${chalk.dim(entry.version ?? "")}`;
+                console.log(`  ${mark} ${label.padEnd(40)} ${chalk.dim(entry.description ?? "")}`);
+            }
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=ls.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { BaseRegistry } from "../../registry/types";
+import type { InstallOptions, InstallTarget, RemoveDialogues } from "../types";
+/**
+ * Removes installed entries and drops them from each target's store. With no
+ * keys and an `onNoValue` dialogue the user picks from what is installed.
+ * Removal is all-or-nothing per entry: local changes prompt keep/remove
+ * through `onCollision` (kept entirely without it), and an entry with files
+ * missing on disk proceeds only when `onIncomplete` confirms. Installed
+ * dependents (via `registryDependencies`) are offered for cascade removal
+ * through `onCascade`. The caller saves each target's store after.
+ */
+export declare function removeEntries(registry: BaseRegistry, targets: InstallTarget[], keys: string[], options?: InstallOptions, dialogues?: RemoveDialogues): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AAO5E,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA0B/E;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,EAC5B,SAAS,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/dist/cli/commands/remove.js

@@ -0,0 +1,109 @@
+// packages/core/src/cli/commands/remove.ts
+import chalk from "chalk";
+import path from "node:path";
+import { z } from "zod";
+import { entries as storeEntries, entryDependencies, get } from "../../registry/registry.selectors";
+import { unregister } from "../../registry/registry.mutations";
+import { recordedHashes, removeInstalledFiles } from "../../installer";
+import { createInstallerIO } from "../../installer/io";
+import { ConflictDecision } from "../../installer/types";
+import { guardCancel } from "../../utils/prompt";
+import { runDialogueValue } from "../dialogue";
+import { c, lineSuccess, lineWarn, lineInfo } from "../theme";
+const KeysSchema = z.array(z.string());
+async function diskState(entry, installDir, io) {
+    const recorded = recordedHashes(entry);
+    const missing = [];
+    const modified = [];
+    for (const file of entry.files) {
+        const destPath = path.join(installDir, file.path);
+        if (!io.exists(destPath)) {
+            missing.push(file.path);
+            continue;
+        }
+        const recordedHash = recorded[file.path];
+        if (recordedHash !== undefined && (await io.hashFile(destPath)) !== recordedHash)
+            modified.push(file.path);
+    }
+    return { missing, modified };
+}
+/**
+ * Removes installed entries and drops them from each target's store. With no
+ * keys and an `onNoValue` dialogue the user picks from what is installed.
+ * Removal is all-or-nothing per entry: local changes prompt keep/remove
+ * through `onCollision` (kept entirely without it), and an entry with files
+ * missing on disk proceeds only when `onIncomplete` confirms. Installed
+ * dependents (via `registryDependencies`) are offered for cascade removal
+ * through `onCascade`. The caller saves each target's store after.
+ */
+export async function removeEntries(registry, targets, keys, options = {}, dialogues = {}) {
+    const io = createInstallerIO();
+    if (keys.length === 0 && dialogues.onNoValue !== undefined) {
+        const installed = [...new Set(targets.flatMap((t) => Object.keys(storeEntries(t.store))))].sort();
+        if (installed.length === 0) {
+            console.log(lineInfo("Nothing installed."));
+            return;
+        }
+        const choices = installed.map((key) => ({ value: key, label: c.key(key) }));
+        const picked = guardCancel(await runDialogueValue(dialogues.onNoValue, { keyChoices: choices }, options.answers));
+        keys = KeysSchema.parse(picked ?? []);
+    }
+    for (const target of targets) {
+        if (targets.length > 1)
+            console.log(c.header(target.label));
+        const targetKeys = Object.keys(storeEntries(target.store));
+        // Mutable queue so cascade confirmations can append dependents mid-loop.
+        const queue = [...keys];
+        let i = 0;
+        while (i < queue.length) {
+            const key = queue[i++];
+            const installed = get(target.store, key);
+            if (!installed) {
+                console.log(lineInfo(`${c.key(key)} — not installed`));
+                continue;
+            }
+            const dependents = entryDependencies(key, registry, targetKeys).filter((d) => !queue.includes(d));
+            if (dependents.length > 0) {
+                console.log(lineWarn(`${dependents.map((d) => c.key(d)).join(", ")} depend${dependents.length === 1 ? "s" : ""} on ${c.key(key)}.`));
+                if (dialogues.onCascade !== undefined) {
+                    const also = await runDialogueValue(dialogues.onCascade, { key: c.key(key), dependents: dependents.map((d) => c.key(d)).join(", ") }, options.answers);
+                    if (also === true)
+                        queue.push(...dependents);
+                }
+            }
+            const state = await diskState(installed, target.installDir, io);
+            if (state.missing.length > 0 && dialogues.onIncomplete !== undefined) {
+                console.log(lineWarn(`${c.key(key)} is incomplete on disk — missing ${state.missing.map((f) => c.file(f)).join(", ")}`));
+                const proceed = await runDialogueValue(dialogues.onIncomplete, { key: c.key(key), target: c.target(target.label), missing: state.missing.map((f) => c.file(f)).join(", ") }, options.answers);
+                if (proceed !== true) {
+                    console.log(lineInfo(`${c.key(key)} — skipped`));
+                    continue;
+                }
+            }
+            let force = options.force ?? false;
+            if (state.modified.length > 0 && !force) {
+                console.log(lineWarn(`${c.key(key)} has local changes in ${state.modified.map((f) => c.file(f)).join(", ")}`));
+                if (dialogues.onCollision !== undefined) {
+                    const answer = await runDialogueValue(dialogues.onCollision, { key: c.key(key), target: c.target(target.label) }, options.answers);
+                    if (answer === ConflictDecision.Overwrite)
+                        force = true;
+                }
+                if (!force) {
+                    console.log(lineInfo(`${c.key(key)} — kept ${chalk.dim(`(use ${c.flag("-f")} to remove)`)}`));
+                    continue;
+                }
+            }
+            const result = await removeInstalledFiles(installed.files, target.installDir, { force }, io);
+            if (result.removed.length > 0) {
+                console.log(lineSuccess(`Removed ${c.key(key)} ${chalk.dim(`(${result.removed.length} file${result.removed.length === 1 ? "" : "s"})`)}`));
+            }
+            if (result.kept.length === 0) {
+                unregister(target.store, key);
+            }
+            else {
+                console.log(lineInfo(`${c.key(key)} kept in manifest (some files were kept)`));
+            }
+        }
+    }
+}
+//# sourceMappingURL=remove.js.map