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): split documentation scan scope

Rahmanf7ffcac312b8
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 93c6eefd..daa58695 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` split documentation scan scope
- `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 6e9de7cf..f9103eab 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` | 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 |
+| AI-assisted code audit | OpenAI Codex Security `scan-components` | Twenty 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 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.
+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 twenty 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 909e4f6c..9f6c1dcc 100644
--- a/security/codex-components.json
+++ b/security/codex-components.json
@@ -2,79 +2,219 @@
"components": [
{
"name": "application-routes-and-proxy",
- "paths": ["app", "instrumentation.ts", "instrumentation.test.ts", "proxy.ts", "proxy.test.ts", "proxy-websocket.test.ts"]
+ "paths": [
+ "app",
+ "instrumentation.ts",
+ "instrumentation.test.ts",
+ "proxy.ts",
+ "proxy.test.ts",
+ "proxy-websocket.test.ts"
+ ]
},
{
"name": "host-filesystem-and-execution",
- "paths": ["lib/host"]
+ "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"]
+ "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"]
+ "paths": [
+ "lib/managed-apps"
+ ]
},
{
"name": "appearance-models-and-preferences",
- "paths": ["lib/appearance", "lib/prefs", "lib/quicklinks", "lib/models", "lib/utils.ts", "lib/demo.ts"]
+ "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"]
+ "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"]
+ "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"]
+ "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": "appshell-features-and-primitives",
- "paths": ["frontend/slices/appshell/design", "frontend/slices/appshell/features", "frontend/slices/appshell/primitives"]
+ "paths": [
+ "frontend/slices/appshell/design",
+ "frontend/slices/appshell/features",
+ "frontend/slices/appshell/primitives"
+ ]
},
{
"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"]
+ "paths": [
+ "frontend/slices/os-shell",
+ "frontend/slices/os-settings",
+ "frontend/slices/shell-settings",
+ "frontend/slices/system-monitor",
+ "frontend/slices/quicklinks"
+ ]
},
{
"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"]
+ "paths": [
+ "frontend/slices/assistant",
+ "frontend/slices/auth",
+ "frontend/slices/app-store",
+ "frontend/slices/create-app",
+ "frontend/slices/docs"
+ ]
},
{
"name": "managed-apps-ui",
- "paths": ["frontend/slices/managed-apps"]
+ "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"]
+ "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"]
+ "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"]
+ "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"]
+ "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-policy",
- "paths": ["docs", "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": "security-architecture-and-operations-docs",
+ "paths": [
+ "docs/9ROUTER-INTEGRATION.md",
+ "docs/ARCHITECTURE.md",
+ "docs/AUDIT-2026-06-11.md",
+ "docs/AUDIT-2026-08-24.md",
+ "docs/CHATGPT-PLUGIN.md",
+ "docs/CONNECTORS-GATEWAY-INTEGRATION.md",
+ "docs/DEVELOPMENT.md",
+ "docs/FAQ.md",
+ "docs/HERMES-INTEGRATION.md",
+ "docs/INSTALL.md",
+ "docs/MANAGED-APPS.md",
+ "docs/MCP.md",
+ "docs/MODELS-INTEGRATION.md",
+ "docs/OPENCLAW-INTEGRATION.md",
+ "docs/SECURITY-ASSURANCE.md",
+ "docs/TROUBLESHOOTING.md",
+ "SECURITY.md"
+ ]
+ },
+ {
+ "name": "product-history-and-media-docs",
+ "paths": [
+ "docs/CHANGELOG.md",
+ "docs/CLI.md",
+ "docs/DEMO-SCRIPT.md",
+ "docs/DRAWER-MENU-BYOK-PLAN.md",
+ "docs/PRODUCT_HUNT.md",
+ "docs/PROGRESS.md",
+ "docs/README.md",
+ "docs/SHELL-FIDELITY-PLAN.md",
+ "docs/SLICE-CATALOG.md",
+ "docs/media",
+ "CLAUDE.md",
+ "CONTRIBUTING.md",
+ "LICENSE",
+ "README.md"
+ ]
},
{
"name": "public-static-assets",
- "paths": ["public"]
+ "paths": [
+ "public"
+ ]
}
]
}