Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
fix(security): bound Codex component scope
Rahman0f4b141ab662
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 2e3eda07..93c6eefd 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -8,6 +8,7 @@ this is the *what*, and it is what Settings → About shows as “What's new”.**Fixed**+- `security` bound Codex component scope- `security` use complete Codex component scans- `security` size Codex budget for full scandiff --git a/docs/SECURITY-ASSURANCE.md b/docs/SECURITY-ASSURANCE.mdindex a7d1e1c6..6e9de7cf 100644--- a/docs/SECURITY-ASSURANCE.md+++ b/docs/SECURITY-ASSURANCE.md@@ -16,7 +16,7 @@ The standing baseline is informed by **OWASP ASVS 5.0.0**. MSO does not claim an| Git history secrets | Gitleaks | Secret patterns across full Git history | Any non-reviewed finding fails || Shell safety | ShellCheck | Warning/error-level shell defects in executable scripts | Warning/error finding fails except two documented non-security false-positive classes || DAST | OWASP ZAP Baseline | Passive browser-facing scan of the live HTTPS surface | Baseline scan must complete; alert policy is reviewed before promotion |-| AI-assisted code audit | OpenAI Codex Security `scan-components` | Ten explicit component scans covering the tracked repository, followed by cross-component root-cause matching | Every component and matching must complete; High/Critical groups fail |+| AI-assisted code audit | OpenAI Codex Security `scan-components` | Nineteen explicit component scans covering the tracked repository, followed by cross-component root-cause matching | Every component and matching must complete; High/Critical groups fail || Supply chain | OpenSSF Scorecard | Public repository security posture: pinned dependencies, branch protection, review process and related heuristics | Score is published as external evidence, not self-awarded || Dependency changes | GitHub Dependency Review | Vulnerabilities newly introduced by pull requests | High/Critical introduced dependency fails || SBOM | Trivy CycloneDX | Machine-readable component inventory | Generated on Security Core workflow |@@ -47,7 +47,7 @@ bun run security:ultimateThe command creates a `0700` private run directory under `~/.mso/security-assurance`, snapshots **tracked files only**, and runs the repository verification plus Trivy, OSV-Scanner, Gitleaks, Semgrep, ShellCheck, the official Codex Security component scan across the full tracked repository and the passive ZAP baseline. Detailed scanner output stays outside the repository. A failing scanner produces a failing command; the script does not convert scanner outages into security passes.-Codex Security is intentionally not an automatic per-commit hosted gate because it consumes model/API budget. MSO uses OpenAI's official `scan-components` command because repeated monolithic Standard scans of this repository reached bounded spend limits without producing a terminal coverage result. The committed [`security/codex-components.json`](../security/codex-components.json) plan was generated by the official planner and covers all tracked files through ten non-overlapping components. Each component receives a Standard scan, then Codex Security performs cross-component root-cause matching; incomplete component coverage or incomplete matching fails closed. The default guard is $5 **per component**, with two concurrent workers, and can be changed explicitly through `CODEX_SECURITY_COMPONENT_MAX_COST_USD` and `CODEX_SECURITY_COMPONENT_WORKERS`. The result gate independently validates `summary.json` and the combined `findings.json`; High/Critical groups fail the run. A maintainer can explicitly skip the lane with `MSO_SECURITY_SKIP_CODEX=1`, but a run with a skipped lane must not be advertised as the full ultimate gate. ZAP is likewise skippable for offline development, but not for a published assurance run.+Codex Security is intentionally not an automatic per-commit hosted gate because it consumes model/API budget. MSO uses OpenAI's official `scan-components` command because repeated monolithic Standard scans of this repository reached bounded spend limits without producing a terminal coverage result. The committed [`security/codex-components.json`](../security/codex-components.json) plan was generated by the official planner and covers all tracked files through nineteen non-overlapping components. The official auto-plan was refined along subsystem boundaries after bounded trial scans proved that its two largest groups were too broad to reach a terminal result within the per-component guard. Each component receives a Standard scan, then Codex Security performs cross-component root-cause matching; incomplete component coverage or incomplete matching fails closed. The default guard is $5 **per component**, with two concurrent workers, and can be changed explicitly through `CODEX_SECURITY_COMPONENT_MAX_COST_USD` and `CODEX_SECURITY_COMPONENT_WORKERS`. The result gate independently validates `summary.json` and the combined `findings.json`; High/Critical groups fail the run. A maintainer can explicitly skip the lane with `MSO_SECURITY_SKIP_CODEX=1`, but a run with a skipped lane must not be advertised as the full ultimate gate. ZAP is likewise skippable for offline development, but not for a published assurance run.## Reviewed Gitleaks fixturesdiff --git a/security/codex-components.json b/security/codex-components.jsonindex 5f3b3ef3..909e4f6c 100644--- a/security/codex-components.json+++ b/security/codex-components.json@@ -1,113 +1,80 @@{"components": [{- "name": "server-routes-and-core-services",- "paths": [- "app",- "lib",- "instrumentation.ts",- "instrumentation.test.ts",- "proxy.ts",- "proxy.test.ts",- "proxy-websocket.test.ts"- ]- },- {- "name": "desktop-shell-and-system-ui",- "paths": [- "frontend/slices/appshell",- "frontend/slices/os-shell",- "frontend/slices/os-settings",- "frontend/slices/shell-settings",- "frontend/slices/system-monitor",- "frontend/slices/quicklinks"- ]- },- {- "name": "assistant-auth-and-app-management-ui",- "paths": [- "frontend/slices/assistant",- "frontend/slices/auth",- "frontend/slices/app-store",- "frontend/slices/create-app",- "frontend/slices/managed-apps",- "frontend/slices/docs"- ]+ "name": "application-routes-and-proxy",+ "paths": ["app", "instrumentation.ts", "instrumentation.test.ts", "proxy.ts", "proxy.test.ts", "proxy-websocket.test.ts"]},{- "name": "workspace-browser-and-terminal-ui",- "paths": [- "frontend/slices/camoufox-browser",- "frontend/slices/code-editor",- "frontend/slices/files-manager",- "frontend/slices/os-terminal"- ]+ "name": "host-filesystem-and-execution",+ "paths": ["lib/host"]+ },+ {+ "name": "authentication-mcp-and-os-api",+ "paths": ["lib/auth", "lib/mcp", "lib/os-api", "lib/config", "lib/security-store-lock.ts", "lib/path.ts", "lib/path.test.ts"]+ },+ {+ "name": "managed-app-lifecycle",+ "paths": ["lib/managed-apps"]+ },+ {+ "name": "appearance-models-and-preferences",+ "paths": ["lib/appearance", "lib/prefs", "lib/quicklinks", "lib/models", "lib/utils.ts", "lib/demo.ts"]+ },+ {+ "name": "skills-ai-and-integrations",+ "paths": ["lib/skills", "lib/ai", "lib/camoufox", "lib/agent", "lib/install-contract.test.ts", "lib/onboard-contract.test.ts", "lib/skill-market.test.ts"]+ },+ {+ "name": "appshell-rendering-components",+ "paths": ["frontend/slices/appshell/components"]+ },+ {+ "name": "appshell-state-and-runtime",+ "paths": ["frontend/slices/appshell/lib", "frontend/slices/appshell/hooks", "frontend/slices/appshell/provider", "frontend/slices/appshell/registry", "frontend/slices/appshell/responsive", "frontend/slices/appshell/runtime", "frontend/slices/appshell/defaults.ts", "frontend/slices/appshell/index.ts"]},{- "name": "media-and-image-editing-ui",- "paths": [- "frontend/slices/image-editor",- "frontend/slices/image-picker",- "frontend/slices/media-studio",- "frontend/slices/media-viewer",- "frontend/slices/reel-editor"- ]+ "name": "appshell-features-and-primitives",+ "paths": ["frontend/slices/appshell/design", "frontend/slices/appshell/features", "frontend/slices/appshell/primitives"]},{- "name": "shared-ui-and-hooks",- "paths": [- "components",- "hooks",- "components.json"- ]+ "name": "system-shell-and-settings",+ "paths": ["frontend/slices/os-shell", "frontend/slices/os-settings", "frontend/slices/shell-settings", "frontend/slices/system-monitor", "frontend/slices/quicklinks"]},{- "name": "os-browser-package",- "paths": [- "os-browser"- ]+ "name": "assistant-auth-and-app-store-ui",+ "paths": ["frontend/slices/assistant", "frontend/slices/auth", "frontend/slices/app-store", "frontend/slices/create-app", "frontend/slices/docs"]},{- "name": "skills-and-extension-content",- "paths": [- "claude-skills",- "skill-market",- "skills",- "templates"- ]+ "name": "managed-apps-ui",+ "paths": ["frontend/slices/managed-apps"]+ },+ {+ "name": "workspace-browser-and-terminal-ui",+ "paths": ["frontend/slices/camoufox-browser", "frontend/slices/code-editor", "frontend/slices/files-manager", "frontend/slices/os-terminal"]+ },+ {+ "name": "image-editor-and-picker-ui",+ "paths": ["frontend/slices/image-editor", "frontend/slices/image-picker"]+ },+ {+ "name": "media-studio-viewer-and-reel-ui",+ "paths": ["frontend/slices/media-studio", "frontend/slices/media-viewer", "frontend/slices/reel-editor"]+ },+ {+ "name": "shared-ui-browser-and-extension-content",+ "paths": ["components", "hooks", "components.json", "os-browser", "claude-skills", "skill-market", "skills", "templates"]},{"name": "automation-ci-and-security-tooling",- "paths": [- ".github",- "bin",- "scripts",- "security",- ".env.example",- ".gitignore",- ".gitleaksignore",- ".nvmrc",- "bun.lock",- "eslint.config.mjs",- "global.d.ts",- "next.config.mjs",- "package.json",- "postcss.config.mjs",- "tsconfig.json",- "vitest.config.mts"- ]- },- {- "name": "documentation-and-static-assets",- "paths": [- "docs",- "public",- "CLAUDE.md",- "CONTRIBUTING.md",- "LICENSE",- "README.md",- "SECURITY.md"- ]+ "paths": [".github", "bin", "scripts", "security", ".env.example", ".gitignore", ".gitleaksignore", ".nvmrc", "bun.lock", "eslint.config.mjs", "global.d.ts", "next.config.mjs", "package.json", "postcss.config.mjs", "tsconfig.json", "vitest.config.mts"]+ },+ {+ "name": "documentation-and-policy",+ "paths": ["docs", "CLAUDE.md", "CONTRIBUTING.md", "LICENSE", "README.md", "SECURITY.md"]+ },+ {+ "name": "public-static-assets",+ "paths": ["public"]}]}