fix: Restore original README content

The previous RSR standardization commit accidentally replaced the full
README content with a minimal template. This restores the original
project documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Jonathan D.A. Jewell

README.adoc

@@ -1,76 +1,324 @@
-= preference-injector
-Jonathan D.A. Jewell <jonathan.jewell@gmail.com>
-:toc: macro
-:icons: font
-:source-highlighter: rouge
-:experimental:
-:url-github: https://github.com/hyperpolymath/preference-injector
-:url-gitlab: https://gitlab.com/hyperpolymath/preference-injector
-:url-bitbucket: https://bitbucket.org/hyperpolymath/preference-injector
-:url-codeberg: https://codeberg.org/hyperpolymath/preference-injector
+= Preference Injector
 
-User preference injection for testing
+A powerful, type-safe preference injection system for dynamic configuration management in Node.js and TypeScript applications.
 
-image:https://img.shields.io/badge/RSR-Certified-gold[RSR Certified]
-image:https://img.shields.io/badge/License-AGPL%20v3-blue[License]
+== Features
 
-toc::[]
+- *Multiple Providers*: File-based, environment variables, API, and in-memory storage
+- *Priority System*: Resolve conflicts between providers using customizable strategies
+- *Type Safety*: Full TypeScript support with generic type helpers
+- *Caching*: LRU and TTL caching strategies for performance
+- *Validation*: Schema-based and custom validation rules
+- *Encryption*: AES-256-GCM encryption for sensitive preferences
+- *Audit Logging*: Track all preference operations
+- *Migrations*: Version and migrate preference schemas
+- *React Integration*: Hooks and context providers
+- *Express Middleware*: RESTful API and request helpers
+- *CLI Tool*: Command-line interface for preference management
 
-== Overview
+== Installation
 
-preference-injector is part of the link:https://rhodium.sh[Rhodium Standard] (RSR) ecosystem.
+```bash
+npm install @hyperpolymath/preference-injector
+```
 
-Domain: *software-development*
+== Quick Start
 
-== Installation
+```typescript
+import { PreferenceInjector, MemoryProvider } from '@hyperpolymath/preference-injector';
 
-[source,bash]
-----
-# Clone from GitHub (primary)
-git clone {url-github}
+// Create an injector with an in-memory provider
+const injector = new PreferenceInjector({
+  providers: [new MemoryProvider()],
+});
 
-# Or from mirrors
-git clone {url-gitlab}
-git clone {url-codeberg}
-----
+await injector.initialize();
 
-== RSR Stack
+// Set preferences
+await injector.set('theme', 'dark');
+await injector.set('fontSize', 14);
 
-This project follows RSR conventions:
+// Get preferences
+const theme = await injector.get('theme');
+console.log('Theme:', theme); // 'dark'
 
-* ✅ ReScript for frontend/logic
-* ✅ Deno for JS runtime
-* ✅ WASM for performance-critical code
-* ✅ Rust/OCaml/Haskell for systems/proofs
-* ✅ Guile/Scheme for configuration
-* ❌ No TypeScript
-* ❌ No Go
-* ❌ No npm
+// Get with type safety
+const fontSize = await injector.getTyped<number>('fontSize');
+console.log('Font Size:', fontSize); // 14
+```
 
-== Mirrors
+== Providers
 
-[cols="1,2"]
-|===
-| Platform | URL
+=== Memory Provider
 
-| GitHub (primary) | {url-github}
-| GitLab | {url-gitlab}
-| Bitbucket | {url-bitbucket}
-| Codeberg | {url-codeberg}
-|===
+In-memory storage for runtime preferences:
 
-== License
+```typescript
+import { MemoryProvider, PreferencePriority } from '@hyperpolymath/preference-injector';
+
+const provider = new MemoryProvider(PreferencePriority.NORMAL);
+```
+
+=== File Provider
+
+JSON or .env file-based storage:
+
+```typescript
+import { FileProvider } from '@hyperpolymath/preference-injector';
+
+const provider = new FileProvider({
+  filePath: './config.json',
+  priority: PreferencePriority.NORMAL,
+  watchForChanges: true,
+  format: 'json', // or 'env'
+});
+```
+
+=== Environment Provider
+
+Environment variable integration:
+
+```typescript
+import { EnvProvider } from '@hyperpolymath/preference-injector';
+
+const provider = new EnvProvider({
+  prefix: 'APP_',
+  priority: PreferencePriority.HIGHEST,
+  parseValues: true,
+});
+```
+
+=== API Provider
+
+Remote configuration service:
+
+```typescript
+import { ApiProvider } from '@hyperpolymath/preference-injector';
+
+const provider = new ApiProvider({
+  baseUrl: 'https://config.example.com',
+  apiKey: 'your-api-key',
+  priority: PreferencePriority.NORMAL,
+  timeout: 5000,
+  retries: 3,
+});
+```
+
+== Multi-Provider Setup
+
+Use multiple providers with automatic conflict resolution:
+
+```typescript
+const injector = new PreferenceInjector({
+  providers: [
+    new EnvProvider({ priority: PreferencePriority.HIGHEST }),
+    new FileProvider({ filePath: './config.json', priority: PreferencePriority.NORMAL }),
+    new MemoryProvider(PreferencePriority.LOW),
+  ],
+  conflictResolution: ConflictResolution.HIGHEST_PRIORITY,
+});
+```
+
+== Validation
+
+Add validation rules to ensure preference values are valid:
+
+```typescript
+import { CommonValidationRules } from '@hyperpolymath/preference-injector';
+
+const validator = injector.getValidator();
+
+// Add built-in validation rules
+validator.addRule('email', CommonValidationRules.email());
+validator.addRule('age', CommonValidationRules.numberRange(0, 150));
+validator.addRule('username', CommonValidationRules.stringLength(3, 20));
+
+// Set with validation
+await injector.set('email', 'user@example.com', { validate: true });
+```
+
+== Schema Validation
+
+Define schemas for your preferences:
+
+```typescript
+import { SchemaBuilder } from '@hyperpolymath/preference-injector';
+
+const schema = new SchemaBuilder()
+  .string('apiUrl', { required: true, pattern: /^https?:\/\// })
+  .number('timeout', { min: 0, max: 30000, default: 5000 })
+  .boolean('debug', { default: false })
+  .build();
+
+const schemaValidator = new SchemaValidator(schema);
+```
+
+== Encryption
+
+Encrypt sensitive preferences:
+
+```typescript
+import { AESEncryptionService } from '@hyperpolymath/preference-injector';
+
+const encryptionService = new AESEncryptionService('your-secret-password');
+injector.setEncryptionService(encryptionService);
+
+// Store encrypted
+await injector.set('apiKey', 'secret-key', { encrypt: true });
+
+// Retrieve and decrypt
+const apiKey = await injector.get('apiKey', { decrypt: true });
+```
+
+== Caching
+
+Enable caching for better performance:
 
-Licensed under AGPL-3.0-or-later OR LicenseRef-Palimpsest-0.5.
+```typescript
+const injector = new PreferenceInjector({
+  providers: [provider],
+  enableCache: true,
+  cacheTTL: 3600000, // 1 hour
+});
+```
 
-See link:LICENSE[LICENSE] for details.
+== Audit Logging
+
+Track all preference operations:
+
+```typescript
+const injector = new PreferenceInjector({
+  providers: [provider],
+  enableAudit: true,
+});
+
+// Get audit log
+const auditLogger = injector.getAuditLogger();
+const entries = auditLogger.getEntries();
+```
+
+== React Integration
+
+Use preferences in React applications:
+
+```tsx
+import { PreferenceProvider, usePreference } from '@hyperpolymath/preference-injector';
+
+function App() {
+  return (
+    <PreferenceProvider injector={injector}>
+      <ThemeToggle />
+    </PreferenceProvider>
+  );
+}
+
+function ThemeToggle() {
+  const [theme, setTheme, loading] = usePreference<string>('theme', 'light');
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
+      Current: {theme}
+    </button>
+  );
+}
+```
+
+== Express Integration
+
+Add preference management to Express applications:
+
+```typescript
+import express from 'express';
+import {
+  preferenceMiddleware,
+  createPreferenceRouter,
+} from '@hyperpolymath/preference-injector';
+
+const app = express();
+
+// Attach preferences to requests
+app.use(preferenceMiddleware({ injector }));
+
+// Add REST API
+app.use('/api', createPreferenceRouter(injector));
+
+// Use in routes
+app.get('/config', async (req, res) => {
+  const value = await req.getPreference('setting');
+  res.json({ value });
+});
+```
+
+== CLI Tool
+
+Manage preferences from the command line:
+
+```bash
+= Get a preference
+preference-injector get theme
+
+= Set a preference
+preference-injector set theme dark
+
+= List all preferences
+preference-injector -f config.json list
+
+= Delete a preference
+preference-injector delete old-key
+
+= Clear all preferences
+preference-injector clear
+```
+
+== Migrations
+
+Version and migrate preference schemas:
+
+```typescript
+import { MigrationManager, createMigration } from '@hyperpolymath/preference-injector';
+
+const manager = new MigrationManager();
+
+manager.register(
+  createMigration(
+    1,
+    'rename-theme-to-color-scheme',
+    async (prefs) => {
+      // Migration logic
+      return prefs;
+    },
+    async (prefs) => {
+      // Rollback logic
+      return prefs;
+    }
+  )
+);
+
+await manager.migrateToLatest(preferences, 0);
+```
+
+== API Documentation
+
+For detailed API documentation, see [API.md](./docs/API.md).
+
+== Examples
+
+Check the [examples](./examples) directory for more usage examples:
+
+- [Basic Usage](./examples/basic-usage.ts)
+- [React Integration](./examples/react-example.tsx)
+- [Express Integration](./examples/express-example.ts)
 
 == Contributing
 
-See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc].
+Contributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+== License
+
+MIT
 
-== Metadata
+== Changelog
 
-* Domain: software-development
-* Framework: RSR (Rhodium Standard Repository)
-* Dublin Core: link:.well-known/dc.xml[.well-known/dc.xml]
+See [CHANGELOG.md](./CHANGELOG.md) for release history.