@soulcraft/brainy 3.20.2 → 3.20.4

package/dist/augmentationRegistry.d.ts

@@ -1,38 +0,0 @@
-/**
- * Augmentation Registry (Compatibility Layer)
- *
- * @deprecated This module provides backward compatibility for old augmentation
- * loading code. All new code should use the AugmentationRegistry class directly
- * on Brainy instances.
- */
-import { BrainyAugmentation } from './types/augmentations.js';
-/**
- * Registry of all available augmentations (for compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export declare const availableAugmentations: any[];
-/**
- * Compatibility wrapper for registerAugmentation
- * @deprecated Use brain.augmentations.register instead
- */
-export declare function registerAugmentation<T extends BrainyAugmentation>(augmentation: T): T;
-/**
- * Sets the default pipeline instance (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export declare function setDefaultPipeline(pipeline: any): void;
-/**
- * Initializes the augmentation pipeline (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export declare function initializeAugmentationPipeline(pipelineInstance?: any): any;
-/**
- * Enables or disables an augmentation by name (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export declare function setAugmentationEnabled(name: string, enabled: boolean): boolean;
-/**
- * Gets all augmentations of a specific type (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export declare function getAugmentationsByType(type: any): any[];

package/dist/augmentationRegistry.js

@@ -1,54 +0,0 @@
-/**
- * Augmentation Registry (Compatibility Layer)
- *
- * @deprecated This module provides backward compatibility for old augmentation
- * loading code. All new code should use the AugmentationRegistry class directly
- * on Brainy instances.
- */
-/**
- * Registry of all available augmentations (for compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export const availableAugmentations = [];
-/**
- * Compatibility wrapper for registerAugmentation
- * @deprecated Use brain.augmentations.register instead
- */
-export function registerAugmentation(augmentation) {
-    console.warn('registerAugmentation is deprecated. Use brain.augmentations.register instead.');
-    // For compatibility, just add to the list (but it won't actually do anything)
-    availableAugmentations.push(augmentation);
-    return augmentation;
-}
-/**
- * Sets the default pipeline instance (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export function setDefaultPipeline(pipeline) {
-    console.warn('setDefaultPipeline is deprecated. Use brain.augmentations instead.');
-}
-/**
- * Initializes the augmentation pipeline (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export function initializeAugmentationPipeline(pipelineInstance) {
-    console.warn('initializeAugmentationPipeline is deprecated. Use brain.augmentations instead.');
-    return pipelineInstance || {};
-}
-/**
- * Enables or disables an augmentation by name (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export function setAugmentationEnabled(name, enabled) {
-    console.warn('setAugmentationEnabled is deprecated. Use brain.augmentations instead.');
-    return false;
-}
-/**
- * Gets all augmentations of a specific type (compatibility)
- * @deprecated Use brain.augmentations instead
- */
-export function getAugmentationsByType(type) {
-    console.warn('getAugmentationsByType is deprecated. Use brain.augmentations instead.');
-    return [];
-}
-//# sourceMappingURL=augmentationRegistry.js.map

package/dist/augmentationRegistryLoader.d.ts

@@ -1,146 +0,0 @@
-/**
- * Augmentation Registry Loader
- *
- * This module provides functionality for loading augmentation registrations
- * at build time. It's designed to be used with build tools like webpack or rollup
- * to automatically discover and register augmentations.
- */
-import { IAugmentation } from './types/augmentations.js';
-/**
- * Options for the augmentation registry loader
- */
-export interface AugmentationRegistryLoaderOptions {
-    /**
-     * Whether to automatically initialize the augmentations after loading
-     * @default false
-     */
-    autoInitialize?: boolean;
-    /**
-     * Whether to log debug information during loading
-     * @default false
-     */
-    debug?: boolean;
-}
-/**
- * Result of loading augmentations
- */
-export interface AugmentationLoadResult {
-    /**
-     * The augmentations that were loaded
-     */
-    augmentations: IAugmentation[];
-    /**
-     * Any errors that occurred during loading
-     */
-    errors: Error[];
-}
-/**
- * Loads augmentations from the specified modules
- *
- * This function is designed to be used with build tools like webpack or rollup
- * to automatically discover and register augmentations.
- *
- * @param modules An object containing modules with augmentations to register
- * @param options Options for the loader
- * @returns A promise that resolves with the result of loading the augmentations
- *
- * @example
- * ```typescript
- * // webpack.config.js
- * const { AugmentationRegistryPlugin } = require('brainy/dist/webpack');
- *
- * module.exports = {
- *   // ... other webpack config
- *   plugins: [
- *     new AugmentationRegistryPlugin({
- *       // Pattern to match files containing augmentations
- *       pattern: /augmentation\.js$/,
- *       // Options for the loader
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export declare function loadAugmentationsFromModules(modules: Record<string, any>, options?: AugmentationRegistryLoaderOptions): Promise<AugmentationLoadResult>;
-/**
- * Creates a webpack plugin for automatically loading augmentations
- *
- * @param options Options for the plugin
- * @returns A webpack plugin
- *
- * @example
- * ```typescript
- * // webpack.config.js
- * const { createAugmentationRegistryPlugin } = require('brainy/dist/webpack');
- *
- * module.exports = {
- *   // ... other webpack config
- *   plugins: [
- *     createAugmentationRegistryPlugin({
- *       pattern: /augmentation\.js$/,
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export declare function createAugmentationRegistryPlugin(options: {
-    /**
-     * Pattern to match files containing augmentations
-     */
-    pattern: RegExp;
-    /**
-     * Options for the loader
-     */
-    options?: AugmentationRegistryLoaderOptions;
-}): {
-    name: string;
-    pattern: RegExp;
-    options: AugmentationRegistryLoaderOptions;
-};
-/**
- * Creates a rollup plugin for automatically loading augmentations
- *
- * @param options Options for the plugin
- * @returns A rollup plugin
- *
- * @example
- * ```typescript
- * // rollup.config.js
- * import { createAugmentationRegistryRollupPlugin } from 'brainy/dist/rollup';
- *
- * export default {
- *   // ... other rollup config
- *   plugins: [
- *     createAugmentationRegistryRollupPlugin({
- *       pattern: /augmentation\.js$/,
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export declare function createAugmentationRegistryRollupPlugin(options: {
-    /**
-     * Pattern to match files containing augmentations
-     */
-    pattern: RegExp;
-    /**
-     * Options for the loader
-     */
-    options?: AugmentationRegistryLoaderOptions;
-}): {
-    name: string;
-    pattern: RegExp;
-    options: AugmentationRegistryLoaderOptions;
-};

package/dist/augmentationRegistryLoader.js

@@ -1,213 +0,0 @@
-/**
- * Augmentation Registry Loader
- *
- * This module provides functionality for loading augmentation registrations
- * at build time. It's designed to be used with build tools like webpack or rollup
- * to automatically discover and register augmentations.
- */
-import { registerAugmentation } from './augmentationRegistry.js';
-/**
- * Default options for the augmentation registry loader
- */
-const DEFAULT_OPTIONS = {
-    autoInitialize: false,
-    debug: false
-};
-/**
- * Loads augmentations from the specified modules
- *
- * This function is designed to be used with build tools like webpack or rollup
- * to automatically discover and register augmentations.
- *
- * @param modules An object containing modules with augmentations to register
- * @param options Options for the loader
- * @returns A promise that resolves with the result of loading the augmentations
- *
- * @example
- * ```typescript
- * // webpack.config.js
- * const { AugmentationRegistryPlugin } = require('brainy/dist/webpack');
- *
- * module.exports = {
- *   // ... other webpack config
- *   plugins: [
- *     new AugmentationRegistryPlugin({
- *       // Pattern to match files containing augmentations
- *       pattern: /augmentation\.js$/,
- *       // Options for the loader
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export async function loadAugmentationsFromModules(modules, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const result = {
-        augmentations: [],
-        errors: []
-    };
-    if (opts.debug) {
-        console.log(`[AugmentationRegistryLoader] Loading augmentations from ${Object.keys(modules).length} modules`);
-    }
-    // Process each module
-    for (const [modulePath, module] of Object.entries(modules)) {
-        try {
-            if (opts.debug) {
-                console.log(`[AugmentationRegistryLoader] Processing module: ${modulePath}`);
-            }
-            // Extract augmentations from the module
-            const augmentations = extractAugmentationsFromModule(module);
-            if (augmentations.length === 0) {
-                if (opts.debug) {
-                    console.log(`[AugmentationRegistryLoader] No augmentations found in module: ${modulePath}`);
-                }
-                continue;
-            }
-            // Register each augmentation
-            for (const augmentation of augmentations) {
-                try {
-                    const registered = registerAugmentation(augmentation);
-                    result.augmentations.push(registered);
-                    if (opts.debug) {
-                        console.log(`[AugmentationRegistryLoader] Registered augmentation: ${registered.name}`);
-                    }
-                }
-                catch (error) {
-                    const err = error instanceof Error ? error : new Error(String(error));
-                    result.errors.push(err);
-                    if (opts.debug) {
-                        console.error(`[AugmentationRegistryLoader] Failed to register augmentation: ${err.message}`);
-                    }
-                }
-            }
-        }
-        catch (error) {
-            const err = error instanceof Error ? error : new Error(String(error));
-            result.errors.push(err);
-            if (opts.debug) {
-                console.error(`[AugmentationRegistryLoader] Error processing module ${modulePath}: ${err.message}`);
-            }
-        }
-    }
-    if (opts.debug) {
-        console.log(`[AugmentationRegistryLoader] Loaded ${result.augmentations.length} augmentations with ${result.errors.length} errors`);
-    }
-    return result;
-}
-/**
- * Extracts augmentations from a module
- *
- * @param module The module to extract augmentations from
- * @returns An array of augmentations found in the module
- */
-function extractAugmentationsFromModule(module) {
-    const augmentations = [];
-    // If the module itself is an augmentation, add it
-    if (isAugmentation(module)) {
-        augmentations.push(module);
-    }
-    // Check for exported augmentations
-    if (module && typeof module === 'object') {
-        for (const key of Object.keys(module)) {
-            const exported = module[key];
-            // Skip non-objects and null
-            if (!exported || typeof exported !== 'object') {
-                continue;
-            }
-            // If the exported value is an augmentation, add it
-            if (isAugmentation(exported)) {
-                augmentations.push(exported);
-            }
-            // If the exported value is an array of augmentations, add them
-            if (Array.isArray(exported) && exported.every(isAugmentation)) {
-                augmentations.push(...exported);
-            }
-        }
-    }
-    return augmentations;
-}
-/**
- * Checks if an object is an augmentation
- *
- * @param obj The object to check
- * @returns True if the object is an augmentation
- */
-function isAugmentation(obj) {
-    return (obj &&
-        typeof obj === 'object' &&
-        typeof obj.name === 'string' &&
-        typeof obj.initialize === 'function' &&
-        typeof obj.shutDown === 'function' &&
-        typeof obj.getStatus === 'function');
-}
-/**
- * Creates a webpack plugin for automatically loading augmentations
- *
- * @param options Options for the plugin
- * @returns A webpack plugin
- *
- * @example
- * ```typescript
- * // webpack.config.js
- * const { createAugmentationRegistryPlugin } = require('brainy/dist/webpack');
- *
- * module.exports = {
- *   // ... other webpack config
- *   plugins: [
- *     createAugmentationRegistryPlugin({
- *       pattern: /augmentation\.js$/,
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export function createAugmentationRegistryPlugin(options) {
-    // This is just a placeholder - the actual implementation would depend on the build tool
-    return {
-        name: 'AugmentationRegistryPlugin',
-        pattern: options.pattern,
-        options: options.options || {}
-    };
-}
-/**
- * Creates a rollup plugin for automatically loading augmentations
- *
- * @param options Options for the plugin
- * @returns A rollup plugin
- *
- * @example
- * ```typescript
- * // rollup.config.js
- * import { createAugmentationRegistryRollupPlugin } from 'brainy/dist/rollup';
- *
- * export default {
- *   // ... other rollup config
- *   plugins: [
- *     createAugmentationRegistryRollupPlugin({
- *       pattern: /augmentation\.js$/,
- *       options: {
- *         autoInitialize: true,
- *         debug: true
- *       }
- *     })
- *   ]
- * };
- * ```
- */
-export function createAugmentationRegistryRollupPlugin(options) {
-    // This is just a placeholder - the actual implementation would depend on the build tool
-    return {
-        name: 'augmentation-registry-rollup-plugin',
-        pattern: options.pattern,
-        options: options.options || {}
-    };
-}
-//# sourceMappingURL=augmentationRegistryLoader.js.map

package/dist/augmentations/KnowledgeAugmentation.d.ts

@@ -1,40 +0,0 @@
-/**
- * Knowledge Layer Augmentation for VFS
- *
- * Adds intelligent features to VFS without modifying core functionality:
- * - Event recording for all operations
- * - Semantic versioning based on content changes
- * - Entity and concept extraction
- * - Git bridge for import/export
- *
- * This is a TRUE augmentation - VFS works perfectly without it
- */
-import { Brainy } from '../brainy.js';
-import { BaseAugmentation } from './brainyAugmentation.js';
-export declare class KnowledgeAugmentation extends BaseAugmentation {
-    name: string;
-    timing: 'after';
-    metadata: 'none';
-    operations: any;
-    priority: number;
-    constructor(config?: any);
-    execute<T = any>(operation: string, params: any, next: () => Promise<T>): Promise<T>;
-    private eventRecorder?;
-    private semanticVersioning?;
-    private entitySystem?;
-    private conceptSystem?;
-    private gitBridge?;
-    private originalMethods;
-    initialize(context: any): Promise<void>;
-    augment(brain: Brainy): Promise<void>;
-    /**
-     * Wrap a VFS method to add Knowledge Layer functionality
-     */
-    private wrapMethod;
-    /**
-     * Add Knowledge Layer methods to VFS
-     */
-    private addKnowledgeMethods;
-    private isSemanticChange;
-    cleanup(brain: Brainy): Promise<void>;
-}