@kb-labs/devkit 1.0.0

package/tsconfig/dist/utils/env.js

@@ -0,0 +1,25 @@
+/**
+ * @module @kb-labs/core/utils/env
+ * Small helpers to convert ENV strings to typed values.
+ */
+export function toBool(v) {
+    if (v === undefined) {
+        return undefined;
+    }
+    const s = v.trim().toLowerCase();
+    if (s === "1" || s === "true" || s === "yes" || s === "on") {
+        return true;
+    }
+    if (s === "0" || s === "false" || s === "no" || s === "off") {
+        return false;
+    }
+    return undefined; // unknown → let caller decide default
+}
+export function toInt(v) {
+    if (v === undefined) {
+        return undefined;
+    }
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+//# sourceMappingURL=env.js.map

package/tsconfig/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,MAAM,CAAC,CAAqB;IACxC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,SAAS,CAAC;IAAA,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAAA,OAAO,IAAI,CAAC;IAAA,CAAC;IAC1E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;QAAA,OAAO,KAAK,CAAC;IAAA,CAAC;IAC5E,OAAO,SAAS,CAAC,CAAC,sCAAsC;AAC5D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,CAAqB;IACvC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,SAAS,CAAC;IAAA,CAAC;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/tsconfig/dist/utils/fs-atomic.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module @kb-labs/core/config/utils/fs-atomic
+ * Atomic file write operations using tmp+rename pattern
+ */
+/**
+ * Write file atomically using tmp+rename pattern
+ * This ensures that the file is never partially written in case of crashes
+ */
+export declare function writeFileAtomic(path: string, data: string | Uint8Array): Promise<void>;
+/**
+ * Ensure a path is within the workspace root
+ * Throws ERR_PATH_OUTSIDE_WORKSPACE if the path escapes the workspace
+ */
+export declare function ensureWithinWorkspace(targetPath: string, workspaceRoot: string): void;
+//# sourceMappingURL=fs-atomic.d.ts.map

package/tsconfig/dist/utils/fs-atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/fs-atomic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,UAAU,GACxB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAYrF"}

package/tsconfig/dist/utils/fs-atomic.js

@@ -0,0 +1,45 @@
+/**
+ * @module @kb-labs/core/config/utils/fs-atomic
+ * Atomic file write operations using tmp+rename pattern
+ */
+import { promises as fs } from 'node:fs';
+import { resolve } from 'node:path';
+import { KbError } from '../errors/kb-error';
+import { dirname } from 'node:path';
+/**
+ * Write file atomically using tmp+rename pattern
+ * This ensures that the file is never partially written in case of crashes
+ */
+export async function writeFileAtomic(path, data) {
+    const tmp = `${path}.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    try {
+        // Ensure parent directory exists
+        await fs.mkdir(dirname(path), { recursive: true });
+        // Write to temp file
+        await fs.writeFile(tmp, data, 'utf-8');
+        // Atomic rename
+        await fs.rename(tmp, path);
+    }
+    catch (error) {
+        // Clean up temp file if it exists
+        try {
+            await fs.unlink(tmp);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Ensure a path is within the workspace root
+ * Throws ERR_PATH_OUTSIDE_WORKSPACE if the path escapes the workspace
+ */
+export function ensureWithinWorkspace(targetPath, workspaceRoot) {
+    const absTarget = resolve(targetPath);
+    const absRoot = resolve(workspaceRoot);
+    if (!absTarget.startsWith(absRoot)) {
+        throw new KbError('ERR_PATH_OUTSIDE_WORKSPACE', `Refusing to write outside workspace: ${targetPath}`, 'Check cwd or use a relative path within the workspace', { targetPath, workspaceRoot });
+    }
+}
+//# sourceMappingURL=fs-atomic.js.map

package/tsconfig/dist/utils/fs-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/fs-atomic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAyB;IAEzB,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/E,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,qBAAqB;QACrB,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAEvC,gBAAgB;QAChB,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kCAAkC;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,aAAqB;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,OAAO,CACf,4BAA4B,EAC5B,wCAAwC,UAAU,EAAE,EACpD,uDAAuD,EACvD,EAAE,UAAU,EAAE,aAAa,EAAE,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/tsconfig/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './env';
+export * from './product-normalize';
+//# sourceMappingURL=index.d.ts.map

package/tsconfig/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,qBAAqB,CAAA"}

package/tsconfig/dist/utils/index.js

@@ -0,0 +1,3 @@
+export * from './env';
+export * from './product-normalize';
+//# sourceMappingURL=index.js.map

package/tsconfig/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,qBAAqB,CAAA"}

package/tsconfig/dist/utils/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Get profiles root directory
+ */
+export declare function getProfilesRootDir(cwd: string): string;
+/**
+ * Get product configuration directory
+ */
+export declare function getProductConfigDir(cwd: string, fsProduct: string): string;
+/**
+ * Get product configuration file path
+ */
+export declare function getProductConfigPath(cwd: string, fsProduct: string): string;
+/**
+ * Get .kb root directory
+ */
+export declare function getKbRootDir(cwd: string): string;
+/**
+ * Get lockfile path
+ */
+export declare function getLockfilePath(cwd: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/tsconfig/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/tsconfig/dist/utils/paths.js

@@ -0,0 +1,32 @@
+import path from 'node:path';
+/**
+ * Get profiles root directory
+ */
+export function getProfilesRootDir(cwd) {
+    return path.join(cwd, '.kb', 'profiles');
+}
+/**
+ * Get product configuration directory
+ */
+export function getProductConfigDir(cwd, fsProduct) {
+    return path.join(cwd, '.kb', fsProduct);
+}
+/**
+ * Get product configuration file path
+ */
+export function getProductConfigPath(cwd, fsProduct) {
+    return path.join(getProductConfigDir(cwd, fsProduct), `${fsProduct}.config.json`);
+}
+/**
+ * Get .kb root directory
+ */
+export function getKbRootDir(cwd) {
+    return path.join(cwd, '.kb');
+}
+/**
+ * Get lockfile path
+ */
+export function getLockfilePath(cwd) {
+    return path.join(getKbRootDir(cwd), 'lock.json');
+}
+//# sourceMappingURL=paths.js.map

package/tsconfig/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,SAAiB;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,SAAiB;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,cAAc,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC"}

package/tsconfig/dist/utils/product-normalize.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module @kb-labs/core/config/utils/product-normalize
+ * Product ID normalization between code (camelCase) and filesystem (kebab-case)
+ */
+import type { ProductId } from '../types/types';
+export type { ProductId } from '../types/types';
+/**
+ * Convert ProductId to filesystem kebab-case format
+ * @param id ProductId in camelCase
+ * @returns kebab-case string for filesystem paths
+ */
+export declare function toFsProduct(id: ProductId): string;
+/**
+ * Convert filesystem kebab-case key to ProductId
+ * @param fsKey kebab-case string from filesystem
+ * @returns ProductId in camelCase
+ */
+export declare function toConfigProduct(fsKey: string): ProductId;
+/**
+ * Check if a string is a valid ProductId
+ */
+export declare function isValidProductId(value: string): value is ProductId;
+/**
+ * Get all valid ProductId values
+ */
+export declare function getAllProductIds(): ProductId[];
+//# sourceMappingURL=product-normalize.d.ts.map

package/tsconfig/dist/utils/product-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-normalize.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/product-normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAUhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAKxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}

package/tsconfig/dist/utils/product-normalize.js

@@ -0,0 +1,45 @@
+/**
+ * @module @kb-labs/core/config/utils/product-normalize
+ * Product ID normalization between code (camelCase) and filesystem (kebab-case)
+ */
+const FS_MAP = new Map([
+    ['aiReview', 'ai-review'],
+    ['aiDocs', 'ai-docs'],
+    ['devlink', 'devlink'],
+    ['release', 'release'],
+    ['devkit', 'devkit'],
+]);
+/**
+ * Convert ProductId to filesystem kebab-case format
+ * @param id ProductId in camelCase
+ * @returns kebab-case string for filesystem paths
+ */
+export function toFsProduct(id) {
+    return FS_MAP.get(id) ?? id;
+}
+/**
+ * Convert filesystem kebab-case key to ProductId
+ * @param fsKey kebab-case string from filesystem
+ * @returns ProductId in camelCase
+ */
+export function toConfigProduct(fsKey) {
+    for (const [k, v] of FS_MAP) {
+        if (v === fsKey) {
+            return k;
+        }
+    }
+    return fsKey;
+}
+/**
+ * Check if a string is a valid ProductId
+ */
+export function isValidProductId(value) {
+    return FS_MAP.has(value);
+}
+/**
+ * Get all valid ProductId values
+ */
+export function getAllProductIds() {
+    return Array.from(FS_MAP.keys());
+}
+//# sourceMappingURL=product-normalize.js.map

package/tsconfig/dist/utils/product-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-normalize.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/utils/product-normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IACrB,CAAC,UAAU,EAAE,WAAW,CAAC;IACzB,CAAC,QAAQ,EAAE,SAAS,CAAC;IACrB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACrB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAa;IACvC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAAA,OAAO,CAAc,CAAC;QAAA,CAAC;IAC3C,CAAC;IACD,OAAO,KAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,MAAM,CAAC,GAAG,CAAC,KAAkB,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAgB,CAAC;AAClD,CAAC"}

package/tsconfig/dist/validation/validate-config.d.ts

@@ -0,0 +1,7 @@
+import type { ProductId } from '../types';
+export type ValidationResult = {
+    ok: boolean;
+    errors: any[] | null;
+};
+export declare function validateProductConfig(product: ProductId, config: unknown): ValidationResult;
+//# sourceMappingURL=validate-config.d.ts.map

package/tsconfig/dist/validation/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/validation/validate-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAU1C,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAcrE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAO3F"}

package/tsconfig/dist/validation/validate-config.js

@@ -0,0 +1,22 @@
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { review as reviewSchema, docs as docsSchema, tests as testsSchema, assistant as assistantSchema, devlink as devlinkSchema, } from '@kb-labs/profile-schemas';
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+const schemaMap = {
+    aiReview: reviewSchema,
+    aiDocs: docsSchema,
+    devlink: devlinkSchema,
+    devkit: testsSchema, // placeholder mapping
+    release: assistantSchema, // placeholder mapping
+    // extend with more products as needed
+};
+export function validateProductConfig(product, config) {
+    const schema = schemaMap[product];
+    if (!schema)
+        return { ok: true, errors: null };
+    const validate = ajv.compile(schema);
+    const ok = validate(config);
+    return { ok: !!ok, errors: validate.errors || null };
+}
+//# sourceMappingURL=validate-config.js.map

package/tsconfig/dist/validation/validate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/validation/validate-config.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,MAAM,IAAI,YAAY,EACtB,IAAI,IAAI,UAAU,EAClB,KAAK,IAAI,WAAW,EACpB,SAAS,IAAI,eAAe,EAC5B,OAAO,IAAI,aAAa,GAEzB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,UAAU,CAAC,GAAG,CAAC,CAAC;AAEhB,MAAM,SAAS,GAAoC;IACjD,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,WAAW,EAAE,sBAAsB;IAC3C,OAAO,EAAE,eAAe,EAAE,sBAAsB;IAChD,sCAAsC;CACvC,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,OAAkB,EAAE,MAAe;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/tsconfig/lib.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "stripInternal": true
+  },
+  "include": [
+    "src"
+  ]
+}

package/tsconfig/node.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src"
+  ]
+}

package/tsconfig/react-app.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"]
+  }
+}
+

package/tsconfig/react-lib.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "lib": ["ES2022"]
+  }
+}
+

package/tsconfig/test.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./node.json",
+  "compilerOptions": {
+    "types": [
+      "vitest/globals",
+      "node"
+    ]
+  },
+  "include": [
+    "**/__tests__/**/*",
+    "**/*.{test,spec}.ts",
+    "**/*.{test,spec}.mts",
+    "**/*.{test,spec}.cts"
+  ]
+}

package/tsup/bin.js

@@ -0,0 +1,172 @@
+import { defineConfig } from 'tsup';
+
+/**
+ * Preset for bin/executable builds.
+ *
+ * ## Overview
+ *
+ * This preset bundles ALL code (workspace packages + node_modules) into a single
+ * standalone executable. Only Node.js built-ins remain external.
+ *
+ * ## Features
+ *
+ * - **Format**: CommonJS (better compatibility with bundled deps)
+ * - **Bundling**: ALL dependencies included (workspace packages, node_modules)
+ * - **Externals**: Only Node.js built-ins (fs, path, crypto, etc.)
+ * - **Shebang**: Automatically adds `#!/usr/bin/env node`
+ * - **Node.js built-ins plugin**: Handles both `node:*` and bare imports (e.g., `readline/promises`)
+ * - **No types**: Binaries don't need .d.ts files
+ *
+ * ## When to use
+ *
+ * ✅ **Use for:**
+ * - CLI binaries (cli-bin)
+ * - Daemon binaries (core-state-daemon)
+ * - Standalone executables
+ * - Any script that needs to run without installing workspace packages
+ *
+ * ❌ **DO NOT use for:**
+ * - Libraries (use tsup/node.js instead)
+ * - Packages meant to be imported by other packages
+ *
+ * ## Important Notes
+ *
+ * 1. **Remove shebang from source**: Don't include `#!/usr/bin/env node` in src/bin.ts
+ *    The preset adds it automatically via banner.
+ *
+ * 2. **Update package.json bin path**: Point to .cjs file:
+ *    ```json
+ *    "bin": { "my-cli": "./dist/bin.cjs" }
+ *    ```
+ *
+ * 3. **Bundle size**: Expect 500KB-5MB depending on dependencies.
+ *    This is normal for standalone executables.
+ *
+ * 4. **Dynamic imports**: Preserved! Plugins can still be loaded dynamically
+ *    from filesystem. Only the core code is bundled.
+ *
+ * ## Basic Example
+ *
+ * ```typescript
+ * import { defineConfig } from 'tsup';
+ * import binPreset from '@kb-labs/devkit/tsup/bin.js';
+ *
+ * export default defineConfig({
+ *   ...binPreset,
+ *   tsconfig: "tsconfig.build.json",
+ *   entry: { bin: 'src/bin.ts' },
+ * });
+ * ```
+ *
+ * ## Dual Build Example (Library + Bin)
+ *
+ * For packages that provide both a library and executable:
+ *
+ * ```typescript
+ * // tsup.bin.config.ts
+ * import { defineConfig } from 'tsup';
+ * import binPreset from '@kb-labs/devkit/tsup/bin.js';
+ *
+ * export default defineConfig({
+ *   ...binPreset,
+ *   tsconfig: "tsconfig.build.json",
+ *   entry: { bin: 'src/bin.ts' },
+ * });
+ * ```
+ *
+ * ```typescript
+ * // tsup.lib.config.ts
+ * import { defineConfig } from 'tsup';
+ * import nodePreset from '@kb-labs/devkit/tsup/node.js';
+ *
+ * export default defineConfig({
+ *   ...nodePreset,
+ *   tsconfig: "tsconfig.build.json",
+ *   entry: { index: 'src/index.ts' },
+ *   clean: false, // Already cleaned by bin build
+ * });
+ * ```
+ *
+ * ```json
+ * // package.json
+ * {
+ *   "scripts": {
+ *     "build": "pnpm clean && tsup --config tsup.bin.config.ts && tsup --config tsup.lib.config.ts"
+ *   }
+ * }
+ * ```
+ *
+ * ## Troubleshooting
+ *
+ * ### Error: "Cannot find module 'readline/promises'"
+ * This is handled automatically by the esbuild plugin. If you still see this error,
+ * it might be a Node.js built-in not in the NODE_BUILTINS list. Report it!
+ *
+ * ### Error: "Dynamic require is not supported"
+ * This happens when bundling CJS packages with dynamic requires. The preset uses
+ * CJS format specifically to avoid this. If you see this error, check if you're
+ * using format: ['esm'] by mistake.
+ *
+ * ### Shebang appearing twice
+ * Remove `#!/usr/bin/env node` from your src/bin.ts source file. The preset
+ * adds it automatically.
+ */
+// List of Node.js built-in modules (without node: prefix)
+const NODE_BUILTINS = [
+  'assert', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console',
+  'constants', 'crypto', 'dgram', 'diagnostics_channel', 'dns', 'domain',
+  'events', 'fs', 'http', 'http2', 'https', 'inspector', 'module', 'net',
+  'os', 'path', 'perf_hooks', 'process', 'punycode', 'querystring', 'readline',
+  'repl', 'stream', 'string_decoder', 'sys', 'timers', 'tls', 'trace_events',
+  'tty', 'url', 'util', 'v8', 'vm', 'wasi', 'worker_threads', 'zlib',
+];
+
+export default defineConfig({
+  format: ['cjs'], // Use CJS for better compatibility with bundled deps
+  target: 'es2022',
+  platform: 'node', // Treat as Node.js environment
+  sourcemap: true,
+  clean: true,
+  dts: false, // Binaries don't need type definitions
+  treeshake: true,
+  minify: false,
+  outDir: 'dist',
+  splitting: false,
+
+  // Bundle EVERYTHING (workspace packages, node_modules, etc)
+  noExternal: [/.*/],
+
+  // CRITICAL: Use 'require' condition for dual-format packages
+  // When bundling CJS, we want to resolve to .cjs files, not .js (ESM)
+  // This prevents "Could not resolve" errors for dual-format workspace packages
+  esbuildOptions(options) {
+    options.conditions = ['require', 'node'];
+  },
+
+  // esbuild plugin to mark Node.js built-ins as external
+  esbuildPlugins: [
+    {
+      name: 'node-builtins-external',
+      setup(build) {
+        // Match Node.js built-ins with or without node: prefix, including subpaths
+        const builtinRegex = new RegExp(`^(node:)?(${NODE_BUILTINS.join('|')})(\\/.*)?$`);
+
+        build.onResolve({ filter: builtinRegex }, (args) => {
+          return { path: args.path, external: true };
+        });
+      },
+    },
+  ],
+
+  // ONLY externalize Node.js built-ins and native modules
+  // Note: The esbuild plugin above handles most cases, but we keep this as a safety net
+  external: [
+    // Native modules that can't be bundled
+    'fsevents',
+  ],
+
+  // Add shebang for executables
+  banner: {
+    js: '#!/usr/bin/env node',
+  },
+});