Skip to content

armgit / mso

Public Imported from GitHub
0

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.

fix(security): bound Codex component scope

Rahman0f4b141ab662
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 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 scan
diff --git a/docs/SECURITY-ASSURANCE.md b/docs/SECURITY-ASSURANCE.md
index 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:ultimate
The 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 fixtures
diff --git a/security/codex-components.json b/security/codex-components.json
index 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"]
}
]
}