David Snelling
8ff382ca3b
CRITICAL CHECKPOINT - DO NOT PUSH TO GITHUB Recovery Status: - Successfully recovered brainy.ts from compiled JavaScript - All core v3.0 API methods functional (add, get, update, delete, relate, find, etc.) - Neural subsystem intact (562KB embedded patterns, NLP working) - Augmentation pipeline operational (20+ augmentations) - HNSW clustering system complete - Triple Intelligence compiled (needs constructor fix) - Test suite validates functionality Changes preserved: - 898 files with changes from last 3 days - 144,475 insertions - All augmentation improvements - All test coverage enhancements - Complete v3.0 feature set This is a LOCAL checkpoint only - contains recovered work after corruption incident. Created backup in .backups/brainy-full-20250910-151314.tar.gz Branch: recovery-checkpoint-20250910-151433 Date: Wed Sep 10 03:18:04 PM PDT 2025
94 lines
2.6 KiB
TypeScript
94 lines
2.6 KiB
TypeScript
/**
|
|
* Augmentation Metadata Contract System
|
|
*
|
|
* Prevents accidental metadata corruption while allowing intentional enrichment
|
|
* Each augmentation declares its metadata intentions upfront
|
|
*/
|
|
export interface AugmentationMetadataContract {
|
|
name: string;
|
|
version: string;
|
|
reads?: {
|
|
userFields?: string[];
|
|
internalFields?: string[];
|
|
augmentationFields?: string[];
|
|
};
|
|
writes?: {
|
|
userFields?: Array<{
|
|
field: string;
|
|
type: 'create' | 'update' | 'merge' | 'delete';
|
|
description: string;
|
|
example?: any;
|
|
}>;
|
|
augmentationFields?: Array<{
|
|
field: string;
|
|
description: string;
|
|
}>;
|
|
internalFields?: Array<{
|
|
field: string;
|
|
permission: 'granted' | 'requested';
|
|
reason: string;
|
|
}>;
|
|
};
|
|
conflictResolution?: {
|
|
strategy: 'error' | 'warn' | 'merge' | 'skip' | 'override';
|
|
priority?: number;
|
|
};
|
|
guarantees?: {
|
|
preservesExisting?: boolean;
|
|
reversible?: boolean;
|
|
idempotent?: boolean;
|
|
validatesTypes?: boolean;
|
|
};
|
|
}
|
|
/**
|
|
* Runtime metadata safety enforcer
|
|
*/
|
|
export declare class MetadataSafetyEnforcer {
|
|
private contracts;
|
|
private modifications;
|
|
/**
|
|
* Register an augmentation's contract
|
|
*/
|
|
registerContract(contract: AugmentationMetadataContract): void;
|
|
/**
|
|
* Check if an augmentation can modify a field
|
|
*/
|
|
canModifyField(augName: string, field: string, value: any): {
|
|
allowed: boolean;
|
|
reason?: string;
|
|
warnings?: string[];
|
|
};
|
|
/**
|
|
* Create safe metadata proxy for an augmentation
|
|
*/
|
|
createSafeProxy(metadata: any, augName: string): any;
|
|
}
|
|
/**
|
|
* Example augmentation contracts
|
|
*/
|
|
export declare const EXAMPLE_CONTRACTS: Record<string, AugmentationMetadataContract>;
|
|
/**
|
|
* Augmentation base class with safety
|
|
*/
|
|
export declare abstract class SafeAugmentation {
|
|
protected enforcer: MetadataSafetyEnforcer;
|
|
protected contract: AugmentationMetadataContract;
|
|
constructor(contract: AugmentationMetadataContract);
|
|
/**
|
|
* Get safe metadata proxy
|
|
*/
|
|
protected getSafeMetadata(metadata: any): any;
|
|
/**
|
|
* Abstract method to implement augmentation logic
|
|
*/
|
|
abstract execute(metadata: any): Promise<any>;
|
|
}
|
|
/**
|
|
* Example: Category enricher implementation
|
|
*/
|
|
export declare class CategoryEnricherAugmentation extends SafeAugmentation {
|
|
constructor();
|
|
execute(metadata: any): Promise<any>;
|
|
private detectCategory;
|
|
private detectSubcategories;
|
|
}
|