@shrkcrft/core 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SharkCraft contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @shrkcrft/core
+
+SharkCraft core primitives: Result, AppError, logger, file-system abstraction, path/string/object utils, IDs.
+
+Part of [SharkCraft](https://github.com/shrkcrft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
+
+## Install
+
+```bash
+bun add @shrkcrft/core
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/context/execution-context.d.ts

@@ -0,0 +1,18 @@
+import type { ILogger } from '../logger/logger.js';
+import type { IFileSystem } from '../fs/file-system.js';
+export interface IExecutionContext {
+    readonly cwd: string;
+    readonly logger: ILogger;
+    readonly fs: IFileSystem;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly now: () => Date;
+}
+export interface CreateExecutionContextOptions {
+    cwd?: string;
+    logger: ILogger;
+    fs: IFileSystem;
+    env?: Record<string, string | undefined>;
+    now?: () => Date;
+}
+export declare function createExecutionContext(options: CreateExecutionContextOptions): IExecutionContext;
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/context/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,iBAAiB,CAQhG"}

package/dist/context/execution-context.js

@@ -0,0 +1,9 @@
+export function createExecutionContext(options) {
+    return {
+        cwd: options.cwd ?? process.cwd(),
+        logger: options.logger,
+        fs: options.fs,
+        env: options.env ?? process.env,
+        now: options.now ?? (() => new Date()),
+    };
+}

package/dist/fs/bun-file-system.d.ts

@@ -0,0 +1,22 @@
+import { type Result } from '../result/result.js';
+import { type AppError } from '../result/errors.js';
+import type { DirEntry, FileStat, IFileSystem, RemoveOptions, WriteOptions } from './file-system.js';
+export declare class BunFileSystem implements IFileSystem {
+    private readonly _cwd;
+    constructor(cwd?: string);
+    cwd(): string;
+    resolve(...parts: string[]): string;
+    relative(from: string, to: string): string;
+    exists(path: string): Promise<boolean>;
+    isFile(path: string): Promise<boolean>;
+    isDirectory(path: string): Promise<boolean>;
+    readFile(path: string): Promise<Result<string, AppError>>;
+    writeFile(path: string, contents: string, options?: WriteOptions): Promise<Result<void, AppError>>;
+    ensureDir(path: string): Promise<Result<void, AppError>>;
+    readDir(path: string): Promise<Result<DirEntry[], AppError>>;
+    remove(path: string, options?: RemoveOptions): Promise<Result<void, AppError>>;
+    stat(path: string): Promise<Result<FileStat, AppError>>;
+}
+export declare function getFileSystem(): IFileSystem;
+export declare function setFileSystem(fs: IFileSystem): void;
+//# sourceMappingURL=bun-file-system.d.ts.map

package/dist/fs/bun-file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-file-system.d.ts","sourceRoot":"","sources":["../../src/fs/bun-file-system.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,GAAG,CAAC,EAAE,MAAM;IAIxB,GAAG,IAAI,MAAM;IAIb,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAIpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAezD,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IA2B5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAexD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IAsB5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAelF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CAmB9D;AAID,wBAAgB,aAAa,IAAI,WAAW,CAG3C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAEnD"}

package/dist/fs/bun-file-system.js

@@ -0,0 +1,120 @@
+import * as nodePath from 'node:path';
+import * as fs from 'node:fs/promises';
+import { existsSync, statSync } from 'node:fs';
+import { err, ok } from "../result/result.js";
+import { AppErrorImpl, ERROR_CODES } from "../result/errors.js";
+export class BunFileSystem {
+    _cwd;
+    constructor(cwd) {
+        this._cwd = cwd ?? process.cwd();
+    }
+    cwd() {
+        return this._cwd;
+    }
+    resolve(...parts) {
+        return nodePath.resolve(this._cwd, ...parts);
+    }
+    relative(from, to) {
+        return nodePath.relative(from, to);
+    }
+    async exists(path) {
+        return existsSync(path);
+    }
+    async isFile(path) {
+        try {
+            const st = statSync(path);
+            return st.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    async isDirectory(path) {
+        try {
+            const st = statSync(path);
+            return st.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    async readFile(path) {
+        try {
+            const text = await fs.readFile(path, 'utf8');
+            return ok(text);
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.FILE_READ_ERROR, `Failed to read file: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+    async writeFile(path, contents, options = {}) {
+        try {
+            if (options.createDirs !== false) {
+                await fs.mkdir(nodePath.dirname(path), { recursive: true });
+            }
+            if (options.overwrite === false && existsSync(path)) {
+                return err(new AppErrorImpl(ERROR_CODES.TARGET_FILE_EXISTS, `Target file exists: ${path}`, { details: { path }, suggestion: 'Pass overwrite:true or use --force' }));
+            }
+            await fs.writeFile(path, contents, 'utf8');
+            return ok(undefined);
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.FILE_WRITE_ERROR, `Failed to write file: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+    async ensureDir(path) {
+        try {
+            await fs.mkdir(path, { recursive: true });
+            return ok(undefined);
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.IO_ERROR, `Failed to ensure directory: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+    async readDir(path) {
+        try {
+            const entries = await fs.readdir(path, { withFileTypes: true });
+            return ok(entries.map((e) => ({
+                name: e.name,
+                isDirectory: e.isDirectory(),
+                isFile: e.isFile(),
+                isSymlink: e.isSymbolicLink(),
+            })));
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.IO_ERROR, `Failed to read directory: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+    async remove(path, options = {}) {
+        try {
+            await fs.rm(path, { recursive: options.recursive ?? false, force: true });
+            return ok(undefined);
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.IO_ERROR, `Failed to remove: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+    async stat(path) {
+        try {
+            const st = await fs.stat(path);
+            return ok({
+                size: st.size,
+                isFile: st.isFile(),
+                isDirectory: st.isDirectory(),
+                mtimeMs: st.mtimeMs,
+            });
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.IO_ERROR, `Failed to stat: ${path}`, { details: { path }, cause: e }));
+        }
+    }
+}
+let defaultFs = null;
+export function getFileSystem() {
+    if (!defaultFs)
+        defaultFs = new BunFileSystem();
+    return defaultFs;
+}
+export function setFileSystem(fs) {
+    defaultFs = fs;
+}

package/dist/fs/file-system.d.ts

@@ -0,0 +1,36 @@
+import type { Result } from '../result/result.js';
+import type { AppError } from '../result/errors.js';
+export interface DirEntry {
+    name: string;
+    isDirectory: boolean;
+    isFile: boolean;
+    isSymlink: boolean;
+}
+export interface IFileSystem {
+    exists(path: string): Promise<boolean>;
+    isFile(path: string): Promise<boolean>;
+    isDirectory(path: string): Promise<boolean>;
+    readFile(path: string): Promise<Result<string, AppError>>;
+    writeFile(path: string, contents: string, options?: WriteOptions): Promise<Result<void, AppError>>;
+    ensureDir(path: string): Promise<Result<void, AppError>>;
+    readDir(path: string): Promise<Result<DirEntry[], AppError>>;
+    remove(path: string, options?: RemoveOptions): Promise<Result<void, AppError>>;
+    stat(path: string): Promise<Result<FileStat, AppError>>;
+    cwd(): string;
+    resolve(...parts: string[]): string;
+    relative(from: string, to: string): string;
+}
+export interface WriteOptions {
+    overwrite?: boolean;
+    createDirs?: boolean;
+}
+export interface RemoveOptions {
+    recursive?: boolean;
+}
+export interface FileStat {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+    mtimeMs: number;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/fs/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/fs/file-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxD,GAAG,IAAI,MAAM,CAAC;IACd,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/fs/file-system.js

@@ -0,0 +1 @@
+export {};

package/dist/ids/id.d.ts

@@ -0,0 +1,4 @@
+export declare function generateId(prefix?: string): string;
+export declare function isValidKnowledgeId(id: string): boolean;
+export declare function normalizeKnowledgeId(id: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/ids/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/ids/id.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,MAAM,SAAO,GAAG,MAAM,CAKhD;AAID,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/dist/ids/id.js

@@ -0,0 +1,19 @@
+let monotonicCounter = 0;
+export function generateId(prefix = 'id') {
+    monotonicCounter += 1;
+    const ts = Date.now().toString(36);
+    const rand = Math.floor(Math.random() * 1e9).toString(36);
+    return `${prefix}_${ts}_${rand}_${monotonicCounter.toString(36)}`;
+}
+const KNOWLEDGE_ID_RE = /^[a-z0-9]+(?:[.-][a-z0-9]+)*$/;
+export function isValidKnowledgeId(id) {
+    return KNOWLEDGE_ID_RE.test(id);
+}
+export function normalizeKnowledgeId(id) {
+    return id
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-z0-9.-]/g, '')
+        .replace(/^[-.]+|[-.]+$/g, '');
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './result/result.js';
+export * from './result/errors.js';
+export * from './logger/log-level.js';
+export * from './logger/logger.js';
+export * from './fs/file-system.js';
+export * from './fs/bun-file-system.js';
+export * from './path/path-utils.js';
+export * from './path/safe-target-path.js';
+export * from './string/string-utils.js';
+export * from './object/object-utils.js';
+export * from './ids/id.js';
+export * from './context/execution-context.js';
+export * from './load/safe-import.js';
+export * from './load/import-context.js';
+//# 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":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./result/result.js";
+export * from "./result/errors.js";
+export * from "./logger/log-level.js";
+export * from "./logger/logger.js";
+export * from "./fs/file-system.js";
+export * from "./fs/bun-file-system.js";
+export * from "./path/path-utils.js";
+export * from "./path/safe-target-path.js";
+export * from "./string/string-utils.js";
+export * from "./object/object-utils.js";
+export * from "./ids/id.js";
+export * from "./context/execution-context.js";
+export * from "./load/safe-import.js";
+export * from "./load/import-context.js";

package/dist/load/import-context.d.ts

@@ -0,0 +1,13 @@
+import { type SafeImportResult } from './safe-import.js';
+export interface IImportContext {
+    readonly timeoutMs: number;
+    size(): number;
+    load<T = Record<string, unknown>>(filePath: string): Promise<SafeImportResult<T>>;
+    hasSettled(filePath: string): boolean;
+    entries(): IterableIterator<[string, SafeImportResult]>;
+}
+export interface IImportContextOptions {
+    timeoutMs?: number;
+}
+export declare function createImportContext(options?: IImportContextOptions): IImportContext;
+//# sourceMappingURL=import-context.d.ts.map

package/dist/load/import-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-context.d.ts","sourceRoot":"","sources":["../../src/load/import-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,IAAI,IAAI,MAAM,CAAC;IACf,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAEvF"}

package/dist/load/import-context.js

@@ -0,0 +1,33 @@
+import { DEFAULT_SAFE_IMPORT_TIMEOUT_MS, safeImport, } from "./safe-import.js";
+class ImportContext {
+    timeoutMs;
+    _pending = new Map();
+    _settled = new Map();
+    constructor(options = {}) {
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_SAFE_IMPORT_TIMEOUT_MS;
+    }
+    size() {
+        return this._pending.size;
+    }
+    hasSettled(filePath) {
+        return this._settled.has(filePath);
+    }
+    async load(filePath) {
+        const existing = this._pending.get(filePath);
+        if (existing)
+            return existing;
+        const p = safeImport(filePath, { timeoutMs: this.timeoutMs });
+        const wrapped = p.then((r) => {
+            this._settled.set(filePath, r);
+            return r;
+        });
+        this._pending.set(filePath, wrapped);
+        return wrapped;
+    }
+    entries() {
+        return this._settled.entries();
+    }
+}
+export function createImportContext(options = {}) {
+    return new ImportContext(options);
+}

package/dist/load/safe-import.d.ts

@@ -0,0 +1,21 @@
+export interface ISafeImportSuccess<T = Record<string, unknown>> {
+    ok: true;
+    module: T;
+    elapsedMs: number;
+}
+export interface ISafeImportFailure {
+    ok: false;
+    error: Error;
+    elapsedMs: number;
+    timedOut: boolean;
+}
+export type SafeImportResult<T = Record<string, unknown>> = ISafeImportSuccess<T> | ISafeImportFailure;
+export interface ISafeImportOptions {
+    /** Max ms to wait for the dynamic import before timing out. */
+    timeoutMs?: number;
+    /** Skip the existsSync pre-check (caller already verified). */
+    skipExistsCheck?: boolean;
+}
+export declare const DEFAULT_SAFE_IMPORT_TIMEOUT_MS = 8000;
+export declare function safeImport<T = Record<string, unknown>>(filePath: string, options?: ISafeImportOptions): Promise<SafeImportResult<T>>;
+//# sourceMappingURL=safe-import.d.ts.map

package/dist/load/safe-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-import.d.ts","sourceRoot":"","sources":["../../src/load/safe-import.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpD,kBAAkB,CAAC,CAAC,CAAC,GACrB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA+C9B"}

package/dist/load/safe-import.js

@@ -0,0 +1,55 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+export const DEFAULT_SAFE_IMPORT_TIMEOUT_MS = 8000;
+export async function safeImport(filePath, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_SAFE_IMPORT_TIMEOUT_MS;
+    const start = Date.now();
+    if (!options.skipExistsCheck && !existsSync(filePath)) {
+        return {
+            ok: false,
+            error: new Error(`file not found: ${filePath}`),
+            elapsedMs: Date.now() - start,
+            timedOut: false,
+        };
+    }
+    let timer = null;
+    const timeoutPromise = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            resolve({
+                ok: false,
+                error: new Error(`import timed out after ${timeoutMs}ms: ${filePath}`),
+                elapsedMs: Date.now() - start,
+                timedOut: true,
+            });
+        }, timeoutMs);
+        if (timer && typeof timer.unref === 'function') {
+            timer.unref();
+        }
+    });
+    const importPromise = (async () => {
+        try {
+            const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(filePath).href)));
+            return { ok: true, module: mod, elapsedMs: Date.now() - start };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                error: e instanceof Error ? e : new Error(String(e)),
+                elapsedMs: Date.now() - start,
+                timedOut: false,
+            };
+        }
+    })();
+    const result = await Promise.race([importPromise, timeoutPromise]);
+    if (timer)
+        clearTimeout(timer);
+    return result;
+}

package/dist/logger/log-level.d.ts

@@ -0,0 +1,10 @@
+export declare enum LogLevel {
+    Silent = 0,
+    Error = 1,
+    Warn = 2,
+    Info = 3,
+    Debug = 4,
+    Trace = 5
+}
+export declare function parseLogLevel(value: string | undefined, fallback?: LogLevel): LogLevel;
+//# sourceMappingURL=log-level.d.ts.map

package/dist/logger/log-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.d.ts","sourceRoot":"","sources":["../../src/logger/log-level.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,MAAM,IAAI;IACV,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,QAAwB,GAAG,QAAQ,CAkBrG"}

package/dist/logger/log-level.js

@@ -0,0 +1,29 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Silent"] = 0] = "Silent";
+    LogLevel[LogLevel["Error"] = 1] = "Error";
+    LogLevel[LogLevel["Warn"] = 2] = "Warn";
+    LogLevel[LogLevel["Info"] = 3] = "Info";
+    LogLevel[LogLevel["Debug"] = 4] = "Debug";
+    LogLevel[LogLevel["Trace"] = 5] = "Trace";
+})(LogLevel || (LogLevel = {}));
+export function parseLogLevel(value, fallback = LogLevel.Info) {
+    if (!value)
+        return fallback;
+    switch (value.toLowerCase()) {
+        case 'silent':
+            return LogLevel.Silent;
+        case 'error':
+            return LogLevel.Error;
+        case 'warn':
+            return LogLevel.Warn;
+        case 'info':
+            return LogLevel.Info;
+        case 'debug':
+            return LogLevel.Debug;
+        case 'trace':
+            return LogLevel.Trace;
+        default:
+            return fallback;
+    }
+}

package/dist/logger/logger.d.ts

@@ -0,0 +1,33 @@
+import { LogLevel } from './log-level.js';
+export interface ILogger {
+    level: LogLevel;
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    trace(message: string, meta?: Record<string, unknown>): void;
+    child(scope: string): ILogger;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    scope?: string;
+    writer?: (line: string) => void;
+    json?: boolean;
+}
+export declare class Logger implements ILogger {
+    level: LogLevel;
+    private readonly scope;
+    private readonly writer;
+    private readonly json;
+    constructor(options?: LoggerOptions);
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    trace(message: string, meta?: Record<string, unknown>): void;
+    child(scope: string): ILogger;
+    private emit;
+}
+export declare function getDefaultLogger(): ILogger;
+export declare function setDefaultLogger(logger: ILogger): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,MAAO,YAAW,OAAO;IACpC,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEnB,OAAO,GAAE,aAAkB;IAOvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAW7B,OAAO,CAAC,IAAI;CAgBb;AAID,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEtD"}

package/dist/logger/logger.js

@@ -0,0 +1,69 @@
+import { LogLevel } from "./log-level.js";
+export class Logger {
+    level;
+    scope;
+    writer;
+    json;
+    constructor(options = {}) {
+        this.level = options.level ?? LogLevel.Info;
+        this.scope = options.scope ?? '';
+        this.writer = options.writer ?? ((line) => process.stderr.write(line + '\n'));
+        this.json = options.json ?? false;
+    }
+    error(message, meta) {
+        if (this.level >= LogLevel.Error)
+            this.emit('error', message, meta);
+    }
+    warn(message, meta) {
+        if (this.level >= LogLevel.Warn)
+            this.emit('warn', message, meta);
+    }
+    info(message, meta) {
+        if (this.level >= LogLevel.Info)
+            this.emit('info', message, meta);
+    }
+    debug(message, meta) {
+        if (this.level >= LogLevel.Debug)
+            this.emit('debug', message, meta);
+    }
+    trace(message, meta) {
+        if (this.level >= LogLevel.Trace)
+            this.emit('trace', message, meta);
+    }
+    child(scope) {
+        const nested = this.scope ? `${this.scope}:${scope}` : scope;
+        const child = new Logger({
+            level: this.level,
+            scope: nested,
+            writer: this.writer,
+            json: this.json,
+        });
+        return child;
+    }
+    emit(level, message, meta) {
+        if (this.json) {
+            const payload = {
+                ts: new Date().toISOString(),
+                level,
+                scope: this.scope || undefined,
+                message,
+                ...(meta ? { meta } : {}),
+            };
+            this.writer(JSON.stringify(payload));
+            return;
+        }
+        const prefix = this.scope ? `[${level}] [${this.scope}]` : `[${level}]`;
+        const metaStr = meta && Object.keys(meta).length ? ' ' + JSON.stringify(meta) : '';
+        this.writer(`${prefix} ${message}${metaStr}`);
+    }
+}
+let defaultLogger = null;
+export function getDefaultLogger() {
+    if (!defaultLogger) {
+        defaultLogger = new Logger({ level: LogLevel.Info });
+    }
+    return defaultLogger;
+}
+export function setDefaultLogger(logger) {
+    defaultLogger = logger;
+}

package/dist/object/object-utils.d.ts

@@ -0,0 +1,8 @@
+export declare function deepFreeze<T>(value: T): Readonly<T>;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function merge<A extends Record<string, unknown>, B extends Record<string, unknown>>(a: A, b: B): A & B;
+export declare function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
+export declare function omit<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
+export declare function uniqueBy<T, K>(items: readonly T[], keyFn: (item: T) => K): T[];
+export declare function groupBy<T, K extends string | number>(items: readonly T[], keyFn: (item: T) => K): Record<K, T[]>;
+//# sourceMappingURL=object-utils.d.ts.map

package/dist/object/object-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-utils.d.ts","sourceRoot":"","sources":["../../src/object/object-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CASnD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxF,CAAC,EAAE,CAAC,EACJ,CAAC,EAAE,CAAC,GACH,CAAC,GAAG,CAAC,CAYP;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMhG;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAShG;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAW9E;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAClD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAOhB"}

package/dist/object/object-utils.js

@@ -0,0 +1,69 @@
+export function deepFreeze(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    for (const key of Object.keys(value)) {
+        const v = value[key];
+        if (v && typeof v === 'object' && !Object.isFrozen(v)) {
+            deepFreeze(v);
+        }
+    }
+    return Object.freeze(value);
+}
+export function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === null || proto === Object.prototype;
+}
+export function merge(a, b) {
+    const result = { ...a };
+    for (const key of Object.keys(b)) {
+        const av = result[key];
+        const bv = b[key];
+        if (isPlainObject(av) && isPlainObject(bv)) {
+            result[key] = merge(av, bv);
+        }
+        else if (bv !== undefined) {
+            result[key] = bv;
+        }
+    }
+    return result;
+}
+export function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj)
+            result[key] = obj[key];
+    }
+    return result;
+}
+export function omit(obj, keys) {
+    const keySet = new Set(keys);
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        if (!keySet.has(key)) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+export function uniqueBy(items, keyFn) {
+    const seen = new Set();
+    const out = [];
+    for (const item of items) {
+        const key = keyFn(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(item);
+        }
+    }
+    return out;
+}
+export function groupBy(items, keyFn) {
+    const out = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        (out[key] ??= []).push(item);
+    }
+    return out;
+}

package/dist/path/path-utils.d.ts

@@ -0,0 +1,13 @@
+export declare function joinPath(...parts: string[]): string;
+export declare function resolvePath(...parts: string[]): string;
+export declare function normalizePath(p: string): string;
+export declare function isAbsolutePath(p: string): boolean;
+export declare function basename(p: string, ext?: string): string;
+export declare function dirname(p: string): string;
+export declare function extname(p: string): string;
+export declare function relativePath(from: string, to: string): string;
+export declare function isPathInside(child: string, parent: string): boolean;
+export declare function ensureTrailingSlash(p: string): string;
+export declare function stripTrailingSlash(p: string): string;
+export declare function toPosix(p: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/path/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/path/path-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/path/path-utils.js

@@ -0,0 +1,38 @@
+import * as nodePath from 'node:path';
+export function joinPath(...parts) {
+    return nodePath.join(...parts);
+}
+export function resolvePath(...parts) {
+    return nodePath.resolve(...parts);
+}
+export function normalizePath(p) {
+    return nodePath.normalize(p);
+}
+export function isAbsolutePath(p) {
+    return nodePath.isAbsolute(p);
+}
+export function basename(p, ext) {
+    return ext === undefined ? nodePath.basename(p) : nodePath.basename(p, ext);
+}
+export function dirname(p) {
+    return nodePath.dirname(p);
+}
+export function extname(p) {
+    return nodePath.extname(p);
+}
+export function relativePath(from, to) {
+    return nodePath.relative(from, to);
+}
+export function isPathInside(child, parent) {
+    const rel = nodePath.relative(parent, child);
+    return rel !== '' && !rel.startsWith('..') && !nodePath.isAbsolute(rel);
+}
+export function ensureTrailingSlash(p) {
+    return p.endsWith('/') ? p : p + '/';
+}
+export function stripTrailingSlash(p) {
+    return p.length > 1 && p.endsWith('/') ? p.slice(0, -1) : p;
+}
+export function toPosix(p) {
+    return p.split(nodePath.sep).join('/');
+}

package/dist/path/safe-target-path.d.ts

@@ -0,0 +1,29 @@
+export interface ISafePathResult {
+    /** Resolved absolute path. */
+    absolutePath: string;
+    /** Relative path from projectRoot to absolutePath. */
+    relativePath: string;
+}
+export declare class UnsafeTargetPathError extends Error {
+    readonly code: 'absolute-path-rejected' | 'traversal-detected' | 'outside-project-root' | 'empty-path';
+    readonly rawPath: string;
+    constructor(code: UnsafeTargetPathError['code'], rawPath: string, message: string);
+}
+/**
+ * Resolve a template-supplied target path against the project root, refusing
+ * anything that escapes the project boundary.
+ *
+ * Rules (in order):
+ *   1. Empty / non-string input → reject.
+ *   2. Absolute paths → reject unless `allowAbsolute: true`.
+ *   3. Normalize the path (collapses ../ and ./).
+ *   4. The resolved path must be inside (or equal to) projectRoot.
+ *
+ * This is the single chokepoint for all generator file writes.
+ */
+export declare function safeResolveTargetPath(rawPath: string, projectRoot: string, options?: {
+    allowAbsolute?: boolean;
+}): ISafePathResult;
+/** True if a string contains `..` segments. Used for early diagnostics. */
+export declare function containsTraversal(rawPath: string): boolean;
+//# sourceMappingURL=safe-target-path.d.ts.map

package/dist/path/safe-target-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-target-path.d.ts","sourceRoot":"","sources":["../../src/path/safe-target-path.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EACT,wBAAwB,GACxB,oBAAoB,GACpB,sBAAsB,GACtB,YAAY,CAAC;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAGvB,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM;CAOlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,eAAe,CA+BjB;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/path/safe-target-path.js

@@ -0,0 +1,46 @@
+import * as nodePath from 'node:path';
+export class UnsafeTargetPathError extends Error {
+    code;
+    rawPath;
+    constructor(code, rawPath, message) {
+        super(message);
+        this.name = 'UnsafeTargetPathError';
+        this.code = code;
+        this.rawPath = rawPath;
+    }
+}
+/**
+ * Resolve a template-supplied target path against the project root, refusing
+ * anything that escapes the project boundary.
+ *
+ * Rules (in order):
+ *   1. Empty / non-string input → reject.
+ *   2. Absolute paths → reject unless `allowAbsolute: true`.
+ *   3. Normalize the path (collapses ../ and ./).
+ *   4. The resolved path must be inside (or equal to) projectRoot.
+ *
+ * This is the single chokepoint for all generator file writes.
+ */
+export function safeResolveTargetPath(rawPath, projectRoot, options = {}) {
+    if (typeof rawPath !== 'string' || rawPath.length === 0) {
+        throw new UnsafeTargetPathError('empty-path', String(rawPath), 'Target path is empty');
+    }
+    const resolvedProjectRoot = nodePath.resolve(projectRoot);
+    const normalized = nodePath.normalize(rawPath);
+    if (nodePath.isAbsolute(normalized) && !options.allowAbsolute) {
+        throw new UnsafeTargetPathError('absolute-path-rejected', rawPath, `Absolute target path "${rawPath}" is not allowed without explicit opt-in`);
+    }
+    const absolute = nodePath.isAbsolute(normalized)
+        ? normalized
+        : nodePath.resolve(resolvedProjectRoot, normalized);
+    // Final containment check — protects against ../../escape and symlink-style tricks.
+    const relative = nodePath.relative(resolvedProjectRoot, absolute);
+    if (relative === '' || (!relative.startsWith('..') && !nodePath.isAbsolute(relative))) {
+        return { absolutePath: absolute, relativePath: relative === '' ? '.' : relative };
+    }
+    throw new UnsafeTargetPathError('outside-project-root', rawPath, `Target path "${rawPath}" resolves to "${absolute}" which is outside project root "${resolvedProjectRoot}"`);
+}
+/** True if a string contains `..` segments. Used for early diagnostics. */
+export function containsTraversal(rawPath) {
+    return nodePath.normalize(rawPath).split(/[\\/]+/).includes('..');
+}

package/dist/result/errors.d.ts

@@ -0,0 +1,43 @@
+export declare const ERROR_CODES: {
+    readonly UNKNOWN: "SHRK_UNKNOWN";
+    readonly INVALID_INPUT: "SHRK_INVALID_INPUT";
+    readonly NOT_FOUND: "SHRK_NOT_FOUND";
+    readonly ALREADY_EXISTS: "SHRK_ALREADY_EXISTS";
+    readonly CONFIG_NOT_FOUND: "SHRK_CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "SHRK_CONFIG_INVALID";
+    readonly PROJECT_ROOT_NOT_FOUND: "SHRK_PROJECT_ROOT_NOT_FOUND";
+    readonly SHARKCRAFT_FOLDER_NOT_FOUND: "SHRK_FOLDER_NOT_FOUND";
+    readonly PACKAGE_JSON_NOT_FOUND: "SHRK_PACKAGE_JSON_NOT_FOUND";
+    readonly KNOWLEDGE_ENTRY_NOT_FOUND: "SHRK_KNOWLEDGE_NOT_FOUND";
+    readonly KNOWLEDGE_DUPLICATE_ID: "SHRK_KNOWLEDGE_DUPLICATE_ID";
+    readonly TEMPLATE_NOT_FOUND: "SHRK_TEMPLATE_NOT_FOUND";
+    readonly TEMPLATE_VARIABLE_MISSING: "SHRK_TEMPLATE_VAR_MISSING";
+    readonly TARGET_FILE_EXISTS: "SHRK_TARGET_EXISTS";
+    readonly PATH_OUTSIDE_PROJECT: "SHRK_PATH_OUTSIDE_PROJECT";
+    readonly MCP_INVALID_INPUT: "SHRK_MCP_INVALID_INPUT";
+    readonly UNSUPPORTED_COMMAND: "SHRK_UNSUPPORTED_COMMAND";
+    readonly FILE_READ_ERROR: "SHRK_FILE_READ_ERROR";
+    readonly FILE_WRITE_ERROR: "SHRK_FILE_WRITE_ERROR";
+    readonly LOADER_ERROR: "SHRK_LOADER_ERROR";
+    readonly IO_ERROR: "SHRK_IO_ERROR";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export interface AppError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    readonly suggestion?: string | undefined;
+}
+export interface AppErrorOptions {
+    details?: Record<string, unknown>;
+    suggestion?: string;
+    cause?: unknown;
+}
+export declare class AppErrorImpl extends Error implements AppError {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    readonly suggestion?: string | undefined;
+    constructor(code: ErrorCode, message: string, options?: AppErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export declare function makeError(code: ErrorCode, message: string, options?: AppErrorOptions): AppError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/result/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/result/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAsBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAM,YAAW,QAAQ;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE7B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAQ3E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAEV"}

package/dist/result/errors.js

@@ -0,0 +1,47 @@
+export const ERROR_CODES = {
+    UNKNOWN: 'SHRK_UNKNOWN',
+    INVALID_INPUT: 'SHRK_INVALID_INPUT',
+    NOT_FOUND: 'SHRK_NOT_FOUND',
+    ALREADY_EXISTS: 'SHRK_ALREADY_EXISTS',
+    CONFIG_NOT_FOUND: 'SHRK_CONFIG_NOT_FOUND',
+    CONFIG_INVALID: 'SHRK_CONFIG_INVALID',
+    PROJECT_ROOT_NOT_FOUND: 'SHRK_PROJECT_ROOT_NOT_FOUND',
+    SHARKCRAFT_FOLDER_NOT_FOUND: 'SHRK_FOLDER_NOT_FOUND',
+    PACKAGE_JSON_NOT_FOUND: 'SHRK_PACKAGE_JSON_NOT_FOUND',
+    KNOWLEDGE_ENTRY_NOT_FOUND: 'SHRK_KNOWLEDGE_NOT_FOUND',
+    KNOWLEDGE_DUPLICATE_ID: 'SHRK_KNOWLEDGE_DUPLICATE_ID',
+    TEMPLATE_NOT_FOUND: 'SHRK_TEMPLATE_NOT_FOUND',
+    TEMPLATE_VARIABLE_MISSING: 'SHRK_TEMPLATE_VAR_MISSING',
+    TARGET_FILE_EXISTS: 'SHRK_TARGET_EXISTS',
+    PATH_OUTSIDE_PROJECT: 'SHRK_PATH_OUTSIDE_PROJECT',
+    MCP_INVALID_INPUT: 'SHRK_MCP_INVALID_INPUT',
+    UNSUPPORTED_COMMAND: 'SHRK_UNSUPPORTED_COMMAND',
+    FILE_READ_ERROR: 'SHRK_FILE_READ_ERROR',
+    FILE_WRITE_ERROR: 'SHRK_FILE_WRITE_ERROR',
+    LOADER_ERROR: 'SHRK_LOADER_ERROR',
+    IO_ERROR: 'SHRK_IO_ERROR',
+};
+export class AppErrorImpl extends Error {
+    code;
+    details;
+    suggestion;
+    constructor(code, message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = 'AppError';
+        this.code = code;
+        this.details = options.details;
+        this.suggestion = options.suggestion;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            suggestion: this.suggestion,
+        };
+    }
+}
+export function makeError(code, message, options = {}) {
+    return new AppErrorImpl(code, message, options);
+}

package/dist/result/result.d.ts

@@ -0,0 +1,20 @@
+import { type AppError } from './errors.js';
+export type Result<T, E = AppError> = ResultOk<T> | ResultErr<E>;
+export interface ResultOk<T> {
+    readonly ok: true;
+    readonly value: T;
+}
+export interface ResultErr<E> {
+    readonly ok: false;
+    readonly error: E;
+}
+export declare function ok<T>(value: T): ResultOk<T>;
+export declare function err<E>(error: E): ResultErr<E>;
+export declare function isOk<T, E>(r: Result<T, E>): r is ResultOk<T>;
+export declare function isErr<T, E>(r: Result<T, E>): r is ResultErr<E>;
+export declare function unwrap<T, E>(r: Result<T, E>): T;
+export declare function map<T, U, E>(r: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+export declare function flatMap<T, U, E>(r: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
+export declare function tryAsync<T>(fn: () => Promise<T>): Promise<Result<T, AppError>>;
+export declare function trySync<T>(fn: () => T): Result<T, AppError>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/result/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE3C;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAE7C;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAE5D;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAE9D;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAG/C;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/E;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9F;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAYpF;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAY3D"}

package/dist/result/result.js

@@ -0,0 +1,40 @@
+import { AppErrorImpl, ERROR_CODES } from "./errors.js";
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export function isOk(r) {
+    return r.ok === true;
+}
+export function isErr(r) {
+    return r.ok === false;
+}
+export function unwrap(r) {
+    if (r.ok)
+        return r.value;
+    throw r.error instanceof Error ? r.error : new Error(JSON.stringify(r.error));
+}
+export function map(r, fn) {
+    return r.ok ? ok(fn(r.value)) : r;
+}
+export function flatMap(r, fn) {
+    return r.ok ? fn(r.value) : r;
+}
+export async function tryAsync(fn) {
+    try {
+        return ok(await fn());
+    }
+    catch (e) {
+        return err(new AppErrorImpl(ERROR_CODES.UNKNOWN, e instanceof Error ? e.message : String(e), { cause: e }));
+    }
+}
+export function trySync(fn) {
+    try {
+        return ok(fn());
+    }
+    catch (e) {
+        return err(new AppErrorImpl(ERROR_CODES.UNKNOWN, e instanceof Error ? e.message : String(e), { cause: e }));
+    }
+}

package/dist/string/string-utils.d.ts

@@ -0,0 +1,11 @@
+export declare function toKebabCase(input: string): string;
+export declare function toPascalCase(input: string): string;
+export declare function toCamelCase(input: string): string;
+export declare function toSnakeCase(input: string): string;
+export declare function indent(text: string, spaces?: number): string;
+export declare function trimIndent(text: string): string;
+export declare function truncate(text: string, max: number, suffix?: string): string;
+export declare function singleLine(text: string): string;
+export declare function pluralize(count: number, singular: string, plural?: string): string;
+export declare function safeStringify(value: unknown, indentSpaces?: number): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/string/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/string/string-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAMvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAGxE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM,CAgBtE"}

package/dist/string/string-utils.js

@@ -0,0 +1,69 @@
+export function toKebabCase(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .replace(/[_\s]+/g, '-')
+        .toLowerCase()
+        .replace(/^-+|-+$/g, '');
+}
+export function toPascalCase(input) {
+    const cleaned = input.replace(/[-_\s]+/g, ' ').trim();
+    return cleaned
+        .split(' ')
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+export function toCamelCase(input) {
+    const pascal = toPascalCase(input);
+    return pascal.length === 0 ? pascal : pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+export function toSnakeCase(input) {
+    return toKebabCase(input).replace(/-/g, '_');
+}
+export function indent(text, spaces = 2) {
+    const pad = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map((line) => (line.length > 0 ? pad + line : line))
+        .join('\n');
+}
+export function trimIndent(text) {
+    const lines = text.split('\n');
+    while (lines.length > 0 && lines[0].trim() === '')
+        lines.shift();
+    while (lines.length > 0 && lines[lines.length - 1].trim() === '')
+        lines.pop();
+    const indents = lines
+        .filter((l) => l.trim().length > 0)
+        .map((l) => l.match(/^(\s*)/)?.[1]?.length ?? 0);
+    const minIndent = indents.length > 0 ? Math.min(...indents) : 0;
+    if (minIndent === 0)
+        return lines.join('\n');
+    return lines.map((l) => l.slice(minIndent)).join('\n');
+}
+export function truncate(text, max, suffix = '…') {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, Math.max(0, max - suffix.length)) + suffix;
+}
+export function singleLine(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+export function pluralize(count, singular, plural) {
+    return count === 1 ? singular : (plural ?? singular + 's');
+}
+export function safeStringify(value, indentSpaces = 2) {
+    const seen = new WeakSet();
+    return JSON.stringify(value, (_key, val) => {
+        if (typeof val === 'object' && val !== null) {
+            if (seen.has(val))
+                return '[Circular]';
+            seen.add(val);
+        }
+        if (val instanceof Error) {
+            return { name: val.name, message: val.message, stack: val.stack };
+        }
+        return val;
+    }, indentSpaces);
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@shrkcrft/core",
+  "version": "0.1.0-alpha.2",
+  "description": "SharkCraft core primitives: Result, AppError, logger, file-system abstraction, path/string/object utils, IDs.",
+  "license": "MIT",
+  "author": "SharkCraft contributors",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shrkcrft/sharkcraft.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/shrkcrft/sharkcraft",
+  "bugs": {
+    "url": "https://github.com/shrkcrft/sharkcraft/issues"
+  },
+  "keywords": [
+    "sharkcraft",
+    "core",
+    "result",
+    "error",
+    "logger",
+    "path"
+  ],
+  "engines": {
+    "bun": ">=1.1.0",
+    "node": ">=18"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}