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): split documentation scan scope
Rahmanf7ffcac312b8
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 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 scandiff --git a/docs/SECURITY-ASSURANCE.md b/docs/SECURITY-ASSURANCE.mdindex 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: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 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 fixturesdiff --git a/security/codex-components.json b/security/codex-components.jsonindex 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"+ ]}]}