Merge pull request #10 from Beyond-Better/staging

persistent transport sessions; static plugin loading

Author: cngarrison

README.md

@@ -97,7 +97,7 @@ PLUGINS_DISCOVERY_PATHS=./src/plugins
 PLUGINS_AUTOLOAD=true
 
 # Storage
-DENO_KV_PATH=./data/app.db
+STORAGE_DENO_KV_PATH=./data/app.db
 
 # Logging
 LOG_LEVEL=info                 # debug|info|warn|error

deno.jsonc

@@ -86,6 +86,7 @@
     "strict": true,
     "exactOptionalPropertyTypes": true,
     "noImplicitReturns": true,
+    "noUnusedLocals": true,
     "noFallthroughCasesInSwitch": true,
     "noUncheckedIndexedAccess": true,
     "allowUnreachableCode": false,

docs/storage-migration-guide.md

@@ -81,7 +81,7 @@ const eventStore = new TransportEventStore(kv, ['events'], logger);
 **After:**
 ```typescript
 const eventStore = new TransportEventStoreChunked(
-  kv, 
+  kvManager, 
   ['events'], 
   logger, 
   {

examples/.env.example

@@ -150,7 +150,7 @@ PLUGINS_AUTOLOAD=true
 
 # Deno KV Database Path
 # Path to the key-value database file
-DENO_KV_PATH=./data/api-mcp-server.db
+STORAGE_DENO_KV_PATH=./data/api-mcp-server.db
 
 # =============================================================================
 # DEVELOPMENT CONFIGURATION
@@ -286,7 +286,7 @@ TRANSPORT_CLEANUP_INTERVAL_MS=86400000
 # 4. PRODUCTION:
 #    - Set LOG_LEVEL=info or warn
 #    - Set DEV_MODE=false
-#    - Configure appropriate DENO_KV_PATH
+#    - Configure appropriate STORAGE_DENO_KV_PATH
 #    - Review security settings
 
 # 5. CUSTOMIZATION:

examples/1-simple/README.md

@@ -322,7 +322,7 @@ PLUGINS_DISCOVERY_PATHS=./src/plugins
 PLUGINS_AUTOLOAD=true
 
 # Storage
-DENO_KV_PATH=./data/simple-mcp-server.db
+STORAGE_DENO_KV_PATH=./data/simple-mcp-server.db
 ```
 
 ### Development vs Production

examples/1-simple/tests/utils/test-helpers.ts

@@ -333,7 +333,7 @@ export class MockConfigManager {
       'MCP_TRANSPORT': 'stdio',
       'PLUGINS_DISCOVERY_PATHS': './src/plugins',
       'PLUGINS_AUTOLOAD': 'true',
-      'DENO_KV_PATH': ':memory:', // In-memory database for tests
+      'STORAGE_DENO_KV_PATH': ':memory:', // In-memory database for tests
       'DEV_MODE': 'true',
     };
 

examples/2-plugin-workflows/tests/utils/test-helpers.ts

@@ -350,7 +350,7 @@ export class MockConfigManager {
       'MCP_TRANSPORT': 'stdio',
       'PLUGINS_DISCOVERY_PATHS': './src/plugins',
       'PLUGINS_AUTOLOAD': 'true',
-      'DENO_KV_PATH': ':memory:', // In-memory database for tests
+      'STORAGE_DENO_KV_PATH': ':memory:', // In-memory database for tests
       'DEV_MODE': 'true',
     };
 

examples/3-plugin-api-auth/README.md

@@ -233,7 +233,7 @@ HTTP_PORT=3000
 HTTP_HOST=localhost
 
 # Storage Configuration
-DENO_KV_PATH=./examples/3-plugin-api-auth/data/oauth-tokens.db
+STORAGE_DENO_KV_PATH=./examples/3-plugin-api-auth/data/oauth-tokens.db
 
 # API Client Configuration
 THIRDPARTY_API_TIMEOUT=30000

examples/3-plugin-api-auth/instructions.md

@@ -407,7 +407,7 @@ Error: Failed to store OAuth tokens
 **Solution:**
 
 - Check Deno KV database path is writable
-- Verify `DENO_KV_PATH` environment variable
+- Verify `STORAGE_DENO_KV_PATH` environment variable
 - Ensure sufficient disk space
 - Check file permissions
 

examples/4-manual-deps/README.md

@@ -79,7 +79,7 @@ const auditLogger = new AuditLogger({
 }, logger);
 
 const kvManager = new KVManager({
-  kvPath: configManager.get('DENO_KV_PATH', './data/manual-deps.db'),
+  kvPath: configManager.get('STORAGE_DENO_KV_PATH', './data/manual-deps.db'),
 }, logger);
 
 const oauthProvider = new OAuthProvider({
@@ -259,7 +259,7 @@ AUDIT_LOG_ALL_API_CALLS=true
 AUDIT_RETENTION_DAYS=90
 
 # Storage Configuration (manual setup)
-DENO_KV_PATH=./examples/4-manual-deps/data/manual-mcp-server.db
+STORAGE_DENO_KV_PATH=./examples/4-manual-deps/data/manual-mcp-server.db
 ```
 
 #### OAuth Provider Configuration (Manual Setup)
@@ -370,7 +370,7 @@ logger.info('Manually registered workflows:', {
 ```typescript
 // Manual creation of all infrastructure components
 const kvManager = new KVManager({
-  kvPath: configManager.get('DENO_KV_PATH', './data/manual-deps.db'),
+  kvPath: configManager.get('STORAGE_DENO_KV_PATH', './data/manual-deps.db'),
 }, logger);
 
 // Initialize KV connection manually
@@ -388,7 +388,7 @@ const sessionStore = new SessionStore(
 
 // Manual event store setup
 const eventStore = new TransportEventStore(
-  kvManager.getKV(),
+  kvManager),
   ['events'],
   logger,
 );