@g3nomaly/core 0.3.0 → 0.3.2

package/dist/config/config.js

@@ -0,0 +1,107 @@
+// packages/core/src/config/config.ts
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { deepMerge } from "../utils/merge";
+import { G3nConfigFileSchema, G3nConfigSchema, } from "./types";
+if ("window" in globalThis) {
+    throw new Error("@g3nomaly/core config utilities are CLI-only");
+}
+// ---------------------------------------------------------------------------
+// Path helper
+// ---------------------------------------------------------------------------
+const CONFIG_FILE = ".g3n.config.json";
+/** Returns the path of `.g3n.config.json` inside a project root. */
+export function getConfigPath(projectRoot) {
+    return join(projectRoot, CONFIG_FILE);
+}
+/**
+ * @brief Finds the directory that owns the project's `.g3n.config.json`: the nearest ancestor
+ * of `fromDir` holding the config file, else the root of the git repository containing `fromDir`.
+ *
+ * @param fromDir - Directory to search up from, the working directory by default.
+ * @returns The project root, or `null` outside a git repository when no config exists on the way up.
+ */
+export function resolveProjectRoot(fromDir = process.cwd()) {
+    let dir = fromDir;
+    while (true) {
+        if (existsSync(join(dir, CONFIG_FILE)))
+            return dir;
+        if (existsSync(join(dir, ".git")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+// ---------------------------------------------------------------------------
+// Read
+// ---------------------------------------------------------------------------
+/**
+ * @brief Reads and validates `.g3n.config.json`, or returns an empty file view when it is missing.
+ *
+ * @returns The sections present on disk, none when the file is missing.
+ */
+async function readConfigFile(projectRoot) {
+    const file = Bun.file(getConfigPath(projectRoot));
+    if (!(await file.exists()))
+        return {};
+    return G3nConfigFileSchema.parse(await file.json());
+}
+/**
+ * @brief Loads `.g3n.config.json` from the project root as a fully-defaulted view.
+ *
+ * Sections missing on disk read as their defaults.
+ *
+ * @returns The config with every section defaulted.
+ */
+export async function loadConfig(projectRoot) {
+    return G3nConfigSchema.parse(await readConfigFile(projectRoot));
+}
+/**
+ * @brief Deep-merges updates into the existing config file and writes back to disk.
+ *
+ * Only sections already on disk or named in `updates` are written — a
+ * package's init never materializes another package's section.
+ *
+ * @param updates - Partial config to merge, with every key optional at every depth.
+ * @returns The saved config with every section defaulted.
+ */
+export async function saveConfig(projectRoot, updates) {
+    const existing = await readConfigFile(projectRoot);
+    const merged = G3nConfigFileSchema.parse(deepMerge(existing, updates));
+    await Bun.write(getConfigPath(projectRoot), JSON.stringify(merged, null, 2));
+    return G3nConfigSchema.parse(merged);
+}
+// ---------------------------------------------------------------------------
+// Section accessors
+// ---------------------------------------------------------------------------
+/**
+ * @brief Loads the `g3nui` section with its defaults applied.
+ *
+ * @returns The section, defaulted where missing on disk.
+ */
+export async function loadG3nuiConfig(projectRoot) {
+    return (await loadConfig(projectRoot)).g3nui;
+}
+/**
+ * @brief Loads the `g3nerate` section with its defaults applied.
+ *
+ * @returns The section, defaulted where missing on disk.
+ */
+export async function loadG3nerateConfig(projectRoot) {
+    return (await loadConfig(projectRoot)).g3nerate;
+}
+/**
+ * @brief Loads the `skills` section with its defaults applied.
+ *
+ * @returns The section, defaulted where missing on disk.
+ */
+export async function loadSkillsConfig(projectRoot) {
+    return (await loadConfig(projectRoot)).skills;
+}
+/** Tells whether `.g3n.config.json` exists in a project root. */
+export async function configExists(projectRoot) {
+    return Bun.file(getConfigPath(projectRoot)).exists();
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export type { G3nuiSettings, G3nuiConfig, G3nerateSettings, G3nerateConfig, SkillTarget, SkillsInstallDirs, SkillsSettings, SkillsConfig, G3nConfigFile, G3nConfig, } from "./types";
+export { G3nuiSettingsSchema, G3nuiConfigSchema, G3nerateSettingsSchema, G3nerateConfigSchema, SkillTargetSchema, SkillsInstallDirsSchema, SkillsSettingsSchema, SkillsConfigSchema, G3nConfigFileSchema, G3nConfigSchema, } from "./types";
+export { getConfigPath, resolveProjectRoot, loadConfig, saveConfig, loadG3nuiConfig, loadG3nerateConfig, loadSkillsConfig, configExists, } from "./config";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { G3nuiSettingsSchema, G3nuiConfigSchema, G3nerateSettingsSchema, G3nerateConfigSchema, SkillTargetSchema, SkillsInstallDirsSchema, SkillsSettingsSchema, SkillsConfigSchema, G3nConfigFileSchema, G3nConfigSchema, } from "./types";
+export { getConfigPath, resolveProjectRoot, loadConfig, saveConfig, loadG3nuiConfig, loadG3nerateConfig, loadSkillsConfig, configExists, } from "./config";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,182 @@
+import { z } from "zod";
+export declare const G3nuiSettingsSchema: z.ZodObject<{
+    componentsDir: z.ZodDefault<z.ZodString>;
+    includeDebugFiles: z.ZodDefault<z.ZodBoolean>;
+    includeMetaFiles: z.ZodDefault<z.ZodBoolean>;
+    registeredPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const G3nuiConfigSchema: z.ZodObject<{
+    settings: z.ZodDefault<z.ZodObject<{
+        componentsDir: z.ZodDefault<z.ZodString>;
+        includeDebugFiles: z.ZodDefault<z.ZodBoolean>;
+        includeMetaFiles: z.ZodDefault<z.ZodBoolean>;
+        registeredPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const G3nerateSettingsSchema: z.ZodObject<{
+    outputDir: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const G3nerateConfigSchema: z.ZodObject<{
+    settings: z.ZodDefault<z.ZodObject<{
+        outputDir: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SkillTargetSchema: z.ZodEnum<{
+    claude: "claude";
+    codex: "codex";
+}>;
+export declare const SkillsInstallDirsSchema: z.ZodObject<{
+    claude: z.ZodDefault<z.ZodString>;
+    codex: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const SkillsSettingsSchema: z.ZodObject<{
+    filetreeRoot: z.ZodDefault<z.ZodString>;
+    targets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+    }>>>;
+    installDirs: z.ZodDefault<z.ZodObject<{
+        claude: z.ZodDefault<z.ZodString>;
+        codex: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SkillsConfigSchema: z.ZodObject<{
+    settings: z.ZodDefault<z.ZodObject<{
+        filetreeRoot: z.ZodDefault<z.ZodString>;
+        targets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+        }>>>;
+        installDirs: z.ZodDefault<z.ZodObject<{
+            claude: z.ZodDefault<z.ZodString>;
+            codex: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** What `.g3n.config.json` holds on disk: only the sections a package's init has written. */
+export declare const G3nConfigFileSchema: z.ZodObject<{
+    g3nui: z.ZodOptional<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            componentsDir: z.ZodDefault<z.ZodString>;
+            includeDebugFiles: z.ZodDefault<z.ZodBoolean>;
+            includeMetaFiles: z.ZodDefault<z.ZodBoolean>;
+            registeredPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    g3nerate: z.ZodOptional<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            outputDir: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    skills: z.ZodOptional<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            filetreeRoot: z.ZodDefault<z.ZodString>;
+            targets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+            }>>>;
+            installDirs: z.ZodDefault<z.ZodObject<{
+                claude: z.ZodDefault<z.ZodString>;
+                codex: z.ZodDefault<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The fully-defaulted view every consumer reads through `loadConfig`. */
+export declare const G3nConfigSchema: z.ZodObject<{
+    g3nui: z.ZodDefault<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            componentsDir: z.ZodDefault<z.ZodString>;
+            includeDebugFiles: z.ZodDefault<z.ZodBoolean>;
+            includeMetaFiles: z.ZodDefault<z.ZodBoolean>;
+            registeredPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    g3nerate: z.ZodDefault<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            outputDir: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    skills: z.ZodDefault<z.ZodObject<{
+        settings: z.ZodDefault<z.ZodObject<{
+            filetreeRoot: z.ZodDefault<z.ZodString>;
+            targets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+            }>>>;
+            installDirs: z.ZodDefault<z.ZodObject<{
+                claude: z.ZodDefault<z.ZodString>;
+                codex: z.ZodDefault<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * @brief Settings of the `g3nui` section.
+ *
+ * @property componentsDir - Where components are installed in the user's project.
+ * @property includeDebugFiles - Whether to copy `.debug.ts` files alongside components.
+ * @property includeMetaFiles - Whether to copy `.meta.ts` files alongside components.
+ * @property registeredPackages - External package adapters to load, e.g. `["shadcn"]`.
+ */
+export type G3nuiSettings = z.infer<typeof G3nuiSettingsSchema>;
+/**
+ * @brief Config of the `g3nui` section.
+ *
+ * @property settings - Settings of the section, defaulted where missing on disk.
+ */
+export type G3nuiConfig = z.infer<typeof G3nuiConfigSchema>;
+/**
+ * @brief Settings of the `g3nerate` section.
+ *
+ * @property outputDir - Output directory for generated files.
+ */
+export type G3nerateSettings = z.infer<typeof G3nerateSettingsSchema>;
+/**
+ * @brief Config of the `g3nerate` section.
+ *
+ * @property settings - Settings of the section, defaulted where missing on disk.
+ */
+export type G3nerateConfig = z.infer<typeof G3nerateConfigSchema>;
+/**
+ * @brief Agent harness that skills are installed for: `claude` or `codex`.
+ */
+export type SkillTarget = z.infer<typeof SkillTargetSchema>;
+/**
+ * @brief Skill install directory per harness.
+ *
+ * @property claude - Skill install directory for Claude Code, relative to the project root.
+ * @property codex - Skill install directory for Codex, relative to the project root.
+ */
+export type SkillsInstallDirs = z.infer<typeof SkillsInstallDirsSchema>;
+/**
+ * @brief Settings of the `skills` section.
+ *
+ * @property filetreeRoot - Where the plan, phase and task tree lives, relative to the project root.
+ * @property targets - Agent harnesses skills are installed for.
+ * @property installDirs - Install directory per target; the skills.json registry sits next to each.
+ */
+export type SkillsSettings = z.infer<typeof SkillsSettingsSchema>;
+/**
+ * @brief Config of the `skills` section.
+ *
+ * @property settings - Settings of the section, defaulted where missing on disk.
+ */
+export type SkillsConfig = z.infer<typeof SkillsConfigSchema>;
+/**
+ * @brief Shape of `.g3n.config.json` on disk: only the sections a package's init has written.
+ *
+ * @property g3nui - The `g3nui` section, when written.
+ * @property g3nerate - The `g3nerate` section, when written.
+ * @property skills - The `skills` section, when written.
+ */
+export type G3nConfigFile = z.infer<typeof G3nConfigFileSchema>;
+/**
+ * @brief The fully-defaulted config every consumer reads through `loadConfig`.
+ *
+ * @property g3nui - The `g3nui` section.
+ * @property g3nerate - The `g3nerate` section.
+ * @property skills - The `skills` section.
+ */
+export type G3nConfig = z.infer<typeof G3nConfigSchema>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;iBAE5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAE/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;EAA8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAE7B,CAAC;AAMH,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI9B,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AAMH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAS,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAW,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACpE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAM,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACzE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAW,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACpE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAK,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC1E;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAU,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAS,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAa,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/config/types.js

@@ -0,0 +1,51 @@
+// packages/core/src/config/types.ts
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Per-package section schemas — settings only. Package metadata (version,
+// description, license) lives in each package's package.json and is read at
+// runtime via `readPackageMeta`, never persisted here.
+// ---------------------------------------------------------------------------
+export const G3nuiSettingsSchema = z.object({
+    componentsDir: z.string().default("src/components/ui"),
+    includeDebugFiles: z.boolean().default(false),
+    includeMetaFiles: z.boolean().default(false),
+    registeredPackages: z.array(z.string()).default([]),
+});
+export const G3nuiConfigSchema = z.object({
+    settings: G3nuiSettingsSchema.default(() => G3nuiSettingsSchema.parse({})),
+});
+export const G3nerateSettingsSchema = z.object({
+    outputDir: z.string().default("src/generated"),
+});
+export const G3nerateConfigSchema = z.object({
+    settings: G3nerateSettingsSchema.default(() => G3nerateSettingsSchema.parse({})),
+});
+export const SkillTargetSchema = z.enum(["claude", "codex"]);
+export const SkillsInstallDirsSchema = z.object({
+    claude: z.string().default(".claude/skills"),
+    codex: z.string().default(".agents/skills"),
+});
+export const SkillsSettingsSchema = z.object({
+    filetreeRoot: z.string().default("docs/task-manager"),
+    targets: z.array(SkillTargetSchema).min(1).default(["claude"]),
+    installDirs: SkillsInstallDirsSchema.default(() => SkillsInstallDirsSchema.parse({})),
+});
+export const SkillsConfigSchema = z.object({
+    settings: SkillsSettingsSchema.default(() => SkillsSettingsSchema.parse({})),
+});
+// ---------------------------------------------------------------------------
+// Root config schemas
+// ---------------------------------------------------------------------------
+/** What `.g3n.config.json` holds on disk: only the sections a package's init has written. */
+export const G3nConfigFileSchema = z.object({
+    g3nui: G3nuiConfigSchema.optional(),
+    g3nerate: G3nerateConfigSchema.optional(),
+    skills: SkillsConfigSchema.optional(),
+});
+/** The fully-defaulted view every consumer reads through `loadConfig`. */
+export const G3nConfigSchema = z.object({
+    g3nui: G3nuiConfigSchema.default(() => G3nuiConfigSchema.parse({})),
+    g3nerate: G3nerateConfigSchema.default(() => G3nerateConfigSchema.parse({})),
+    skills: SkillsConfigSchema.default(() => SkillsConfigSchema.parse({})),
+});
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,uDAAuD;AACvD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACtD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CAC3E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACjF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAK,iBAAiB,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAI,kBAAkB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAK,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,MAAM,EAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACzE,CAAC,CAAC"}

package/dist/hash/hash.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @brief Hashes a file's contents using SHA-256.
+ *
+ * Uses Bun's native file API + Web Crypto — no external dependencies.
+ *
+ * @param filePath - Absolute or relative path to the file
+ * @returns Lowercase hex SHA-256 digest
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * @brief Hashes an arbitrary string using SHA-256.
+ *
+ * Useful for hashing in-memory content before writing to disk.
+ *
+ * @param content - String to hash
+ * @returns Lowercase hex SHA-256 digest
+ */
+export declare function hashString(content: string): Promise<string>;
+/** Short (first 12 chars) SHA-256 hash of a file — for display purposes. */
+export declare function hashFileShort(filePath: string): Promise<string>;
+/** Short (first 12 chars) SHA-256 hash of a string — for display purposes. */
+export declare function hashStringShort(content: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/hash/hash.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhE;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjE;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE"}

package/dist/hash/hash.js

@@ -0,0 +1,43 @@
+// packages/core/src/hash/hash.ts
+if ("window" in globalThis) {
+    throw new Error("@g3nomaly/core hash utilities are CLI-only");
+}
+/**
+ * @brief Hashes a file's contents using SHA-256.
+ *
+ * Uses Bun's native file API + Web Crypto — no external dependencies.
+ *
+ * @param filePath - Absolute or relative path to the file
+ * @returns Lowercase hex SHA-256 digest
+ */
+export async function hashFile(filePath) {
+    const file = Bun.file(filePath);
+    const buffer = await file.arrayBuffer();
+    const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+ * @brief Hashes an arbitrary string using SHA-256.
+ *
+ * Useful for hashing in-memory content before writing to disk.
+ *
+ * @param content - String to hash
+ * @returns Lowercase hex SHA-256 digest
+ */
+export async function hashString(content) {
+    const encoder = new TextEncoder();
+    const buffer = encoder.encode(content);
+    const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** Short (first 12 chars) SHA-256 hash of a file — for display purposes. */
+export async function hashFileShort(filePath) {
+    return (await hashFile(filePath)).substring(0, 12);
+}
+/** Short (first 12 chars) SHA-256 hash of a string — for display purposes. */
+export async function hashStringShort(content) {
+    return (await hashString(content)).substring(0, 12);
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/hash/hash.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;IAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,OAAO,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,OAAO,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/hash/index.d.ts

@@ -0,0 +1,2 @@
+export { hashFile, hashString, hashFileShort, hashStringShort } from "./hash";
+//# sourceMappingURL=index.d.ts.map

package/dist/hash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hash/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC"}

package/dist/hash/index.js

@@ -0,0 +1,3 @@
+// packages/core/src/hash/index.ts
+export { hashFile, hashString, hashFileShort, hashStringShort } from "./hash";
+//# sourceMappingURL=index.js.map

package/dist/hash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hash/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+// packages/core/src/index.ts
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/installer/classify.d.ts

@@ -0,0 +1,33 @@
+import type { BaseFileEntry, BaseRegistryEntry } from "../registry/types";
+import type { FileClassification, InstallerIO } from "./types";
+/**
+ * @brief Maps each file path of a manifest entry to the hash it was installed with.
+ *
+ * @param entry - Manifest entry to read. `undefined` when the package was never installed.
+ * @returns `path → hash` map, e.g. `{ "SKILL.md": "a1b2" }`. Empty when no file has a hash.
+ */
+export declare function recordedHashes(entry: Pick<BaseRegistryEntry, "files"> | undefined): Record<string, string>;
+/**
+ * @brief Classifies one file against its copy on disk and the install-time record.
+ *
+ * @param file - Registry entry of the file. Its `hash` is the package's current hash, or `undefined` to resolve it.
+ * @param installDir - Absolute folder the package is installed into.
+ * @param recordedHash - Hash recorded in the user manifest at install time. `undefined` when never installed.
+ * @param io - Filesystem boundary used to test for the file and hash it.
+ * @param resolveLatestHash - Looks up the package hash when `file.hash` is not set.
+ * @returns Classification that `applyClassifications` consumes.
+ * @throws {Error} When `file` has no hash and no `resolveLatestHash` is given.
+ */
+export declare function classifyFile<F extends BaseFileEntry>(file: F, installDir: string, recordedHash: string | undefined, io: InstallerIO, resolveLatestHash?: (file: F) => Promise<string>): Promise<FileClassification<F>>;
+/**
+ * @brief Classifies every file in a registry entry, in the order given.
+ *
+ * @param files - Registry entries to classify.
+ * @param installDir - Absolute folder the package is installed into.
+ * @param recorded - Install-time hashes by file path, e.g. `{ "SKILL.md": "a1b2" }`. Missing paths were never installed.
+ * @param io - Filesystem boundary used to test for each file and hash it.
+ * @param resolveLatestHash - Looks up the package hash for files whose `hash` is not set.
+ * @returns One classification per file, in the same order.
+ */
+export declare function classifyFiles<F extends BaseFileEntry>(files: readonly F[], installDir: string, recorded: Record<string, string | undefined>, io: InstallerIO, resolveLatestHash?: (file: F) => Promise<string>): Promise<FileClassification<F>[]>;
+//# sourceMappingURL=classify.d.ts.map

package/dist/installer/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/installer/classify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1G;AA6BD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,aAAa,EACxD,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,EAAE,EAAE,WAAW,EACf,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAC/C,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAUhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,aAAa,EACzD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC5C,EAAE,EAAE,WAAW,EACf,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAC/C,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAMlC"}

package/dist/installer/classify.js

@@ -0,0 +1,82 @@
+// packages/core/src/installer/classify.ts
+import path from "node:path";
+import { FileState } from "./types";
+/**
+ * @brief Maps each file path of a manifest entry to the hash it was installed with.
+ *
+ * @param entry - Manifest entry to read. `undefined` when the package was never installed.
+ * @returns `path → hash` map, e.g. `{ "SKILL.md": "a1b2" }`. Empty when no file has a hash.
+ */
+export function recordedHashes(entry) {
+    const map = {};
+    for (const file of entry?.files ?? []) {
+        if (file.hash)
+            map[file.path] = file.hash;
+    }
+    return map;
+}
+/**
+ * @brief Decides a file's state from what is on disk, what was recorded and what the package ships now.
+ *
+ * @param exists - Whether the file is on disk.
+ * @param currentHash - Hash of the file on disk. `null` when it does not exist.
+ * @param recordedHash - Hash recorded at install time. `undefined` when the file was never installed.
+ * @param latestHash - Hash of the package's current version of the file.
+ * @returns State that decides whether the file is written, kept or flagged as a conflict.
+ */
+function resolveState(exists, currentHash, recordedHash, latestHash) {
+    if (!exists)
+        return FileState.SafeUpdate;
+    if (recordedHash === undefined) {
+        return currentHash === latestHash ? FileState.UpToDate : FileState.Conflict;
+    }
+    const userModified = currentHash !== recordedHash;
+    const registryChanged = latestHash !== recordedHash;
+    if (!userModified && !registryChanged)
+        return FileState.UpToDate;
+    if (!userModified)
+        return FileState.SafeUpdate;
+    if (!registryChanged)
+        return FileState.UserOnly;
+    return FileState.Conflict;
+}
+/**
+ * @brief Classifies one file against its copy on disk and the install-time record.
+ *
+ * @param file - Registry entry of the file. Its `hash` is the package's current hash, or `undefined` to resolve it.
+ * @param installDir - Absolute folder the package is installed into.
+ * @param recordedHash - Hash recorded in the user manifest at install time. `undefined` when never installed.
+ * @param io - Filesystem boundary used to test for the file and hash it.
+ * @param resolveLatestHash - Looks up the package hash when `file.hash` is not set.
+ * @returns Classification that `applyClassifications` consumes.
+ * @throws {Error} When `file` has no hash and no `resolveLatestHash` is given.
+ */
+export async function classifyFile(file, installDir, recordedHash, io, resolveLatestHash) {
+    const destPath = path.join(installDir, file.path);
+    const latestHash = file.hash ?? (await resolveLatestHash?.(file));
+    if (latestHash === undefined) {
+        throw new Error(`no hash for "${file.path}" and no resolveLatestHash provided`);
+    }
+    const exists = io.exists(destPath);
+    const currentHash = exists ? await io.hashFile(destPath) : null;
+    const state = resolveState(exists, currentHash, recordedHash, latestHash);
+    return { file, destPath, state, exists, currentHash, recordedHash, latestHash };
+}
+/**
+ * @brief Classifies every file in a registry entry, in the order given.
+ *
+ * @param files - Registry entries to classify.
+ * @param installDir - Absolute folder the package is installed into.
+ * @param recorded - Install-time hashes by file path, e.g. `{ "SKILL.md": "a1b2" }`. Missing paths were never installed.
+ * @param io - Filesystem boundary used to test for each file and hash it.
+ * @param resolveLatestHash - Looks up the package hash for files whose `hash` is not set.
+ * @returns One classification per file, in the same order.
+ */
+export async function classifyFiles(files, installDir, recorded, io, resolveLatestHash) {
+    const classifications = [];
+    for (const file of files) {
+        classifications.push(await classifyFile(file, installDir, recorded[file.path], io, resolveLatestHash));
+    }
+    return classifications;
+}
+//# sourceMappingURL=classify.js.map

package/dist/installer/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/installer/classify.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGnC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmD;IAChF,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAA;IAC3C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,YAAY,CACnB,MAAe,EACf,WAA0B,EAC1B,YAAgC,EAChC,UAAkB;IAElB,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC,UAAU,CAAA;IACxC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAA;IAC7E,CAAC;IACD,MAAM,YAAY,GAAM,WAAW,KAAK,YAAY,CAAA;IACpD,MAAM,eAAe,GAAG,UAAU,KAAM,YAAY,CAAA;IACpD,IAAI,CAAC,YAAY,IAAI,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAChE,IAAI,CAAC,YAAY;QAAsB,OAAO,SAAS,CAAC,UAAU,CAAA;IAClE,IAAI,CAAC,eAAe;QAAmB,OAAO,SAAS,CAAC,QAAQ,CAAA;IAChE,OAAO,SAAS,CAAC,QAAQ,CAAA;AAC3B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAO,EACP,UAAkB,EAClB,YAAgC,EAChC,EAAe,EACf,iBAAgD;IAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IACjE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,IAAI,qCAAqC,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,MAAM,GAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC/D,MAAM,KAAK,GAAS,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;IAC/E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA;AACjF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB,EACnB,UAAkB,EAClB,QAA4C,EAC5C,EAAe,EACf,iBAAgD;IAEhD,MAAM,eAAe,GAA4B,EAAE,CAAA;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,eAAe,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;IACxG,CAAC;IACD,OAAO,eAAe,CAAA;AACxB,CAAC"}

package/dist/installer/files.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @brief What `listFiles` leaves out. `node_modules` and `.git` are always skipped.
+ *
+ * @property skipDirs - Folder names, or folder paths relative to the listed root, e.g. `tests` or `.claude-plugin/types`.
+ * @property skipFiles - Tested against each file name, e.g. `/\.test\.tsx?$/`.
+ */
+export interface FileFilter {
+    skipDirs?: readonly string[];
+    skipFiles?: RegExp;
+}
+/**
+ * @brief Lists every file below a folder, leaving out the folders and files `filter` names.
+ *
+ * @param dir - Absolute folder to list.
+ * @param filter - Folders and files to skip.
+ * @returns Paths relative to `dir`, sorted.
+ */
+export declare function listFiles(dir: string, filter?: FileFilter): string[];
+//# sourceMappingURL=files.d.ts.map

package/dist/installer/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/installer/files.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAG,SAAS,MAAM,EAAE,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,EAAE,CAUxE"}