@baselineos/frame 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@baselineos/frame",
+  "version": "0.1.0",
+  "description": "Baseline Frame — Context & Control Layer",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@baselineos/protocol-core": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,15 @@
+import { describe, it, expect } from 'vitest';
+import { BaselineFrameSystem } from '../index.js';
+
+describe('frame', () => {
+  it('should instantiate BaselineFrameSystem', () => {
+    const frame = new BaselineFrameSystem();
+    expect(frame).toBeDefined();
+  });
+
+  it('should report initialized status', () => {
+    const frame = new BaselineFrameSystem();
+    const status = frame.getStatus();
+    expect(status.initialized).toBe(true);
+  });
+});

package/src/__tests__/workflow.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { BaselineFrameSystem } from '../index.js';
+
+describe('frame workflow', () => {
+  it('switches context and processes a command', () => {
+    const frame = new BaselineFrameSystem();
+    const switched = frame.switchContext('default');
+    expect(switched.success).toBe(true);
+
+    const result = frame.processCommand('status');
+    expect(result.success).toBe(true);
+    expect(result.context).toBe('default');
+  });
+
+  it('denies commands when context/mode permissions are insufficient', () => {
+    const frame = new BaselineFrameSystem();
+    const switched = frame.switchContext('system');
+    expect(switched.success).toBe(true);
+
+    const result = frame.processCommand('write:config');
+    expect(result.success).toBe(false);
+    expect(result.error).toBe('Permission denied by context/mode');
+  });
+
+  it('supports context lifecycle create/activate/archive', () => {
+    const frame = new BaselineFrameSystem();
+    const manager = frame.getContextManager();
+
+    const created = manager.createContext('temp', {
+      description: 'Temp context',
+      mode: 'development',
+      environment: 'dev',
+      permissions: ['read'],
+      authority: 'user',
+    });
+    expect(created).toBe(true);
+
+    const activated = manager.activateContext('temp');
+    expect(activated).toBe(true);
+    expect(manager.getCurrentContext()?.name).toBe('temp');
+
+    const archived = manager.archiveContext('temp');
+    expect(archived).toBe(true);
+    expect(manager.getCurrentContext()).toBe(null);
+  });
+});

package/src/config/frame-system-config.json

@@ -0,0 +1,313 @@
+{
+  "system": {
+    "name": "Baseline Frame System",
+    "version": "1.0.0",
+    "description": "Context and control layer for Baseline Protocol",
+    "type": "frame-layer",
+    "architecture": "context-control"
+  },
+  "modes": {
+    "development": {
+      "description": "Development mode with full access and debugging capabilities",
+      "permissions": ["read", "write", "execute", "debug", "test"],
+      "environment": "dev",
+      "features": ["hot-reload", "debugging", "testing", "profiling", "logging"],
+      "security": "relaxed",
+      "performance": "development"
+    },
+    "production": {
+      "description": "Production mode with restricted access and security focus",
+      "permissions": ["read", "execute", "monitor"],
+      "environment": "prod",
+      "features": ["monitoring", "logging", "security", "performance", "scalability"],
+      "security": "strict",
+      "performance": "optimized"
+    },
+    "testing": {
+      "description": "Testing mode for validation and quality assurance",
+      "permissions": ["read", "write", "execute", "test"],
+      "environment": "test",
+      "features": ["validation", "testing", "reporting", "coverage", "mocking"],
+      "security": "moderate",
+      "performance": "testing"
+    },
+    "maintenance": {
+      "description": "Maintenance mode for system operations and administration",
+      "permissions": ["read", "write", "execute", "admin", "system"],
+      "environment": "maintenance",
+      "features": ["backup", "restore", "upgrade", "repair", "diagnostics"],
+      "security": "elevated",
+      "performance": "maintenance"
+    },
+    "staging": {
+      "description": "Staging mode for pre-production testing and validation",
+      "permissions": ["read", "write", "execute", "test", "monitor"],
+      "environment": "staging",
+      "features": ["validation", "testing", "monitoring", "performance", "security"],
+      "security": "moderate",
+      "performance": "production-like"
+    }
+  },
+  "contexts": {
+    "default": {
+      "description": "Default application context for general operations",
+      "mode": "development",
+      "environment": "dev",
+      "permissions": ["read", "write", "execute"],
+      "authority": "user",
+      "scope": "application"
+    },
+    "user": {
+      "description": "User-specific context with personalized settings",
+      "mode": "development",
+      "environment": "dev",
+      "permissions": ["read", "write", "execute"],
+      "authority": "user",
+      "scope": "user"
+    },
+    "system": {
+      "description": "System-level context for core operations",
+      "mode": "production",
+      "environment": "prod",
+      "permissions": ["read", "execute", "monitor"],
+      "authority": "system",
+      "scope": "system"
+    },
+    "admin": {
+      "description": "Administrative context for system management",
+      "mode": "maintenance",
+      "environment": "maintenance",
+      "permissions": ["read", "write", "execute", "admin"],
+      "authority": "admin",
+      "scope": "system"
+    },
+    "developer": {
+      "description": "Developer context for development and testing",
+      "mode": "development",
+      "environment": "dev",
+      "permissions": ["read", "write", "execute", "debug", "test"],
+      "authority": "developer",
+      "scope": "development"
+    },
+    "tester": {
+      "description": "Testing context for quality assurance",
+      "mode": "testing",
+      "environment": "test",
+      "permissions": ["read", "write", "execute", "test"],
+      "authority": "developer",
+      "scope": "testing"
+    },
+    "deployment": {
+      "description": "Deployment context for release management",
+      "mode": "staging",
+      "environment": "staging",
+      "permissions": ["read", "write", "execute", "deploy"],
+      "authority": "admin",
+      "scope": "deployment"
+    }
+  },
+  "authorities": {
+    "user": {
+      "level": 1,
+      "permissions": ["read", "write"],
+      "description": "Standard user permissions for basic operations",
+      "scope": "user",
+      "restrictions": ["system", "admin"]
+    },
+    "developer": {
+      "level": 2,
+      "permissions": ["read", "write", "execute", "debug", "test"],
+      "description": "Developer permissions for development and testing",
+      "scope": "development",
+      "restrictions": ["system", "admin"]
+    },
+    "admin": {
+      "level": 3,
+      "permissions": ["read", "write", "execute", "admin", "deploy"],
+      "description": "Administrative permissions for system management",
+      "scope": "system",
+      "restrictions": ["system"]
+    },
+    "system": {
+      "level": 4,
+      "permissions": ["read", "write", "execute", "admin", "system", "core"],
+      "description": "System-level permissions for core operations",
+      "scope": "core",
+      "restrictions": []
+    },
+    "superuser": {
+      "level": 5,
+      "permissions": ["read", "write", "execute", "admin", "system", "core", "override"],
+      "description": "Superuser permissions with override capabilities",
+      "scope": "all",
+      "restrictions": []
+    }
+  },
+  "environments": {
+    "dev": {
+      "name": "dev",
+      "type": "development",
+      "description": "Development environment for active development",
+      "variables": {
+        "NODE_ENV": "development",
+        "DEBUG": "true",
+        "LOG_LEVEL": "debug",
+        "API_URL": "http://localhost:3000",
+        "DATABASE_URL": "mongodb://localhost:27017/dev",
+        "CACHE_TTL": "300"
+      },
+      "features": ["hot-reload", "debugging", "profiling"]
+    },
+    "test": {
+      "name": "test",
+      "type": "testing",
+      "description": "Testing environment for quality assurance",
+      "variables": {
+        "NODE_ENV": "test",
+        "DEBUG": "true",
+        "LOG_LEVEL": "debug",
+        "API_URL": "http://localhost:3001",
+        "DATABASE_URL": "mongodb://localhost:27017/test",
+        "CACHE_TTL": "60"
+      },
+      "features": ["testing", "mocking", "coverage"]
+    },
+    "staging": {
+      "name": "staging",
+      "type": "staging",
+      "description": "Staging environment for pre-production validation",
+      "variables": {
+        "NODE_ENV": "staging",
+        "DEBUG": "false",
+        "LOG_LEVEL": "info",
+        "API_URL": "https://staging-api.example.com",
+        "DATABASE_URL": "mongodb://staging-db:27017/staging",
+        "CACHE_TTL": "1800"
+      },
+      "features": ["monitoring", "validation", "performance"]
+    },
+    "prod": {
+      "name": "prod",
+      "type": "production",
+      "description": "Production environment for live operations",
+      "variables": {
+        "NODE_ENV": "production",
+        "DEBUG": "false",
+        "LOG_LEVEL": "warn",
+        "API_URL": "https://api.example.com",
+        "DATABASE_URL": "mongodb://prod-db:27017/production",
+        "CACHE_TTL": "3600"
+      },
+      "features": ["monitoring", "security", "scalability"]
+    },
+    "maintenance": {
+      "name": "maintenance",
+      "type": "maintenance",
+      "description": "Maintenance environment for system operations",
+      "variables": {
+        "NODE_ENV": "maintenance",
+        "DEBUG": "true",
+        "LOG_LEVEL": "info",
+        "API_URL": "http://localhost:3002",
+        "DATABASE_URL": "mongodb://localhost:27017/maintenance",
+        "CACHE_TTL": "0"
+      },
+      "features": ["backup", "restore", "diagnostics"]
+    }
+  },
+  "permissions": {
+    "read": {
+      "description": "Read access to resources and data",
+      "scope": "data",
+      "level": 1
+    },
+    "write": {
+      "description": "Write access to resources and data",
+      "scope": "data",
+      "level": 2
+    },
+    "execute": {
+      "description": "Execute commands and operations",
+      "scope": "operations",
+      "level": 2
+    },
+    "debug": {
+      "description": "Debug and development capabilities",
+      "scope": "development",
+      "level": 2
+    },
+    "test": {
+      "description": "Testing and validation capabilities",
+      "scope": "testing",
+      "level": 2
+    },
+    "monitor": {
+      "description": "Monitoring and observation capabilities",
+      "scope": "monitoring",
+      "level": 1
+    },
+    "admin": {
+      "description": "Administrative and management capabilities",
+      "scope": "system",
+      "level": 3
+    },
+    "deploy": {
+      "description": "Deployment and release capabilities",
+      "scope": "deployment",
+      "level": 3
+    },
+    "system": {
+      "description": "System-level capabilities",
+      "scope": "core",
+      "level": 4
+    },
+    "core": {
+      "description": "Core system capabilities",
+      "scope": "core",
+      "level": 4
+    },
+    "override": {
+      "description": "Override and emergency capabilities",
+      "scope": "all",
+      "level": 5
+    }
+  },
+  "security": {
+    "authentication": {
+      "required": true,
+      "methods": ["token", "oauth", "sso"],
+      "timeout": 3600
+    },
+    "authorization": {
+      "required": true,
+      "method": "role-based",
+      "audit": true
+    },
+    "encryption": {
+      "data_at_rest": true,
+      "data_in_transit": true,
+      "algorithm": "AES-256"
+    },
+    "logging": {
+      "enabled": true,
+      "level": "info",
+      "retention": "90d"
+    }
+  },
+  "performance": {
+    "caching": {
+      "enabled": true,
+      "strategy": "lru",
+      "max_size": "100MB"
+    },
+    "monitoring": {
+      "enabled": true,
+      "metrics": ["cpu", "memory", "response_time"],
+      "alerts": true
+    },
+    "optimization": {
+      "enabled": true,
+      "strategies": ["compression", "minification", "bundling"]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+export {
+  BaselineFrameSystem,
+  ContextManager,
+  ModeManager,
+  AuthorityManager,
+  EnvironmentManager,
+} from './system.js';
+
+export type {
+  FrameSystemConfig,
+  ModeConfig,
+  ContextConfig,
+  AuthorityConfig,
+  ContextEntry,
+  ModeEntry,
+  AuthorityEntry,
+  EnvironmentEntry,
+  FrameCommandResult,
+  FrameStatus,
+} from './system.js';