@g3nomaly/core 0.3.1 → 0.3.3

package/README.md

@@ -0,0 +1,122 @@
+# @g3nomaly/core
+
+`@g3nomaly/core` is the shared runtime behind the g3n installers: [`@g3nomaly/ui`](https://www.npmjs.com/package/@g3nomaly/ui), [`@g3nomaly/mods`](https://www.npmjs.com/package/@g3nomaly/mods) and [`@g3nomaly/skills`](https://www.npmjs.com/package/@g3nomaly/skills). It reads sources from git, npm or a local folder, copies entries into a project, records them in an install manifest and runs the `add`, `update`, `remove`, `ls` and `source` commands those installers share. Use it to build an installer of your own, or to reuse one piece, such as file hashing or the `.g3n.config.json` loader.
+
+## Requirements
+
+- [Bun](https://bun.sh). Core calls `Bun.file` and `Bun.Transpiler`, so it does not run on Node.
+- A CLI or script. `hash` and `config` throw when loaded in a browser.
+
+```sh
+bun add @g3nomaly/core
+```
+
+## What each import gives you
+
+Import from a subpath. The package root exports nothing.
+
+| Import | What it gives you |
+|---|---|
+| `@g3nomaly/core/hash` | SHA-256 of a file or a string, full or 12 characters |
+| `@g3nomaly/core/registry` | A typed registry of entries on a TanStack Store, saved as `.ts` or `.json`, and the base entry schemas |
+| `@g3nomaly/core/config` | Read and write `.g3n.config.json`, with defaults for every section |
+| `@g3nomaly/core/security` | `getSafeObject`, which reads the object a `.ts` file exports without importing the file |
+| `@g3nomaly/core/sources` | Parse `owner/repo`, `npm:pkg` or `./folder` into a source spec and check it out to a folder |
+| `@g3nomaly/core/installer` | Install manifests, reading every source into one registry, resolving names and dependencies, copying files |
+| `@g3nomaly/core/cli` | The shared commands, the prompts they ask, and the terminal theme |
+| `@g3nomaly/core/utils` | `findGitRoot`, `findUp`, `readPackageMeta`, `warnIfOutdated`, `errorMessage` |
+
+## Hashes and registries
+
+An installer hashes each file it copies, so a later `update` can tell which files you changed.
+
+```ts
+import { hashFile } from "@g3nomaly/core/hash";
+import { createRegistryStore, flush, jsonHandler, load, register } from "@g3nomaly/core/registry";
+
+const registry = createRegistryStore({ filePath: "/home/me/app/.installed.json", handler: jsonHandler });
+await load(registry); // a missing file leaves the store empty
+
+register(registry, "button", {
+  name: "button",
+  files: [{ path: "button.tsx", type: "component", hash: await hashFile("/home/me/app/src/button.tsx") }],
+});
+flush(registry); // writes the entries back, sorted by key
+```
+
+`registry.store` is the TanStack Store itself, so you can subscribe to it. Without a handler, `flush` writes a `.ts` file that exports `registry`. Packages add their own fields by extending `BaseRegistryEntrySchema` and `BaseFileEntrySchema`.
+
+## Project config
+
+`.g3n.config.json` holds one section per package: `g3nui`, `g3nerate` and `skills`. `loadConfig` fills in every default. `saveConfig` writes only the sections already in the file or named in the update, so one package's `init` never writes another package's section.
+
+```ts
+import { loadConfig, resolveProjectRoot, saveConfig } from "@g3nomaly/core/config";
+
+const root = resolveProjectRoot() ?? process.cwd(); // nearest folder with .g3n.config.json or .git
+const { skills } = await loadConfig(root);
+await saveConfig(root, { skills: { settings: { targets: ["claude", "codex"] } } });
+```
+
+## Reading a `.ts` file safely
+
+`getSafeObject(filePath, schema, timeoutMs = 1000)` takes the object literal a file exports, evaluates it in a worker and checks the result against the zod schema. It refuses source with `eval`, dynamic `import()` or a nested-quantifier regex, and a result holding functions or too many keys. It drops getters without running them.
+
+## Building an installer
+
+An installer supplies three things: a zod schema for its entries, a function that reads the entries in one checked-out source, and the folder they install into.
+
+```ts
+import path from "node:path";
+import { z } from "zod";
+import { BaseFileEntrySchema } from "@g3nomaly/core/registry";
+import { listFiles, loadInstallManifest, loadSourceRegistry, manifestSources, OriginEntrySchema, type ReadSource } from "@g3nomaly/core/installer";
+import { addFromSources, reportSourceRegistry } from "@g3nomaly/core/cli";
+
+const PromptSchema = OriginEntrySchema.extend({
+  files: z.array(BaseFileEntrySchema.extend({ type: z.literal("prompt") })).min(1),
+});
+type Prompt = z.infer<typeof PromptSchema>;
+
+// Each file under prompts/ in a source is one entry.
+const readPrompts: ReadSource<Prompt> = async (checkout) => ({
+  entries: listFiles(path.join(checkout.dir, "prompts")).map((file): [string, Prompt] => {
+    const name = path.basename(file, ".md");
+    return [name, {
+      name,
+      origin: { source: checkout.name, dir: "prompts", commit: checkout.commit, version: checkout.version },
+      files: [{ path: file, type: "prompt" }],
+    }];
+  }),
+  warnings: [],
+});
+
+const root     = "/home/me/app";
+const manifest = loadInstallManifest(path.join(root, ".prompts.json"), PromptSchema);
+const target   = { label: "project", installDir: path.join(root, "prompts"), store: manifest.store, manifest };
+const builtins = { "my-prompts": { kind: "git" as const, url: "https://github.com/me/prompts.git" } };
+
+const registry = await loadSourceRegistry(manifestSources([manifest], builtins), root, readPrompts);
+reportSourceRegistry(registry); // prints warnings and the sources that failed to load
+try {
+  await addFromSources([target], ["review"], registry, {}, { bin: "my-prompts", noun: "prompt", entrySchema: PromptSchema });
+} finally {
+  registry.dispose(); // removes temporary checkouts
+}
+```
+
+`addFromSources` resolves `review` or `review@my-prompts` across every source, installs its `registryDependencies`, asks before it overwrites a file you changed, and saves `.prompts.json`. `updateFromSources`, `removeFromTargets`, `addSourceEntries`, `lsSources`, `removeSourceEntries`, `lsSourceRegistry` and `lsEntries` cover the other commands. The CLI of [`@g3nomaly/mods`](https://www.npmjs.com/package/@g3nomaly/mods) is a working example, built from these calls.
+
+## Development
+
+Run `bun install` at the repository root first, then every command from this directory.
+
+```sh
+bun run build      # dist/
+bun run typecheck
+bun test
+```
+
+## License
+
+Elastic License 2.0. See `LICENSE`.

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

@@ -1,17 +1,37 @@
 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. */
+/**
+ * @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;
 }[];
 /**
- * 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`.
+ * @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

@@ -1 +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"}
+{"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

@@ -9,9 +9,16 @@ 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());
-/** Hash of the package's current version of a file, derived from its content. */
+/**
+ * @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);
@@ -20,6 +27,12 @@ export function latestHashFrom(source, io) {
         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,
@@ -27,10 +40,18 @@ export function pickerChoices(registry) {
     }));
 }
 /**
- * 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`.
+ * @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();
@@ -45,21 +66,23 @@ export async function addEntries(registry, targets, source, keys, options = {},
             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(get(target.store, key)), io, latestHashFrom(fileSource, io));
-            let decision = ConflictDecision.Keep;
+            const classifications = await classifyFiles(meta.files, target.installDir, recordedHashes(installed), io, latestHashFrom(fileSource, io));
             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 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, force: options.force ?? false }, io);
+            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 — kept ${chalk.dim(`(use ${c.flag("-f")} to overwrite)`)}`));
+                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"})`)}`));
@@ -67,8 +90,8 @@ export async function addEntries(registry, targets, source, keys, options = {},
             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.
+            // 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 })) });
         }
     }

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

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

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

@@ -3,47 +3,76 @@ 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. */
+/**
+ * @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;
 }
-/** What an installer tells the install commands about itself. */
+/**
+ * @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> {
-    /** 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. */
+/**
+ * @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>;
 /**
- * Installs entries or whole groups from a source registry into every target,
+ * @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.
+ * 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>;
 /**
- * Re-installs installed entries from the source each one was installed
+ * @brief 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.
+ * 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>;
 /**
- * Removes installed entries, or whole groups, from every target and saves
+ * @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

@@ -1 +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"}
+{"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"}