OpenAI's Codex Security CLI and TypeScript SDK for finding, validating, and fixing security vulnerabilities. npm: https://www.npmjs.com/package/@openai/codex-security
TypeScript ai-securityapplication-securityclicode-scanningcodexcodex-securitycybersecuritydevsecopsnodejsnpmopenaisdksecuritytypescriptvulnerability-scanning
chore(release): 0.6.0
github-actions[bot]13dcc6fec00a
diff --git a/.github/release-notes.md b/.github/release-notes.mdindex 39d5f6e6e..75b91cc8d 100644--- a/.github/release-notes.md+++ b/.github/release-notes.md@@ -1,27 +1,23 @@-<!-- release-version: 0.5.1 -->+<!-- release-version: 0.6.0 --><!-- release-section: highlights:start -->## Highlights-Codex Security 0.5.1 adds hosted patch generation and fix verification, and improves saved-scan replay, Deep Scan recovery, and Windows setup.+Codex Security 0.6.0 adds vendor report imports, optional owner suggestions, and hosted remediation commands. Severity classification now uses a built-in rubric and three independent reviews by default; review the model-access and cost changes below before upgrading.-- **Hosted patching and verification.** Integrations can generate patches and independently verify candidate fixes through `runHostedRemediation()` and its JSON-RPC adapter using a supplied executor. Hosts own checkout isolation, sandbox enforcement, candidate patch identity, and publication. See the [hosted remediation guide](https://github.com/openai/codex-security/blob/npm-v0.5.1/sdk/typescript/docs/hosted-remediation.md). ([#1684](https://github.com/openai/codex-security/pull/1684))-- **Saved scan settings.** Daybreak selections persist across scans and remediation, including fresh and resumed Deep Scan workers. Saved Bedrock scans retain the effective AWS region and profile, and inline patches preserve the selected profile's provider settings. Severity classification uses the saved repository to select helpers. ([#1740](https://github.com/openai/codex-security/pull/1740), [#1811](https://github.com/openai/codex-security/pull/1811), [#1810](https://github.com/openai/codex-security/pull/1810), [#1815](https://github.com/openai/codex-security/pull/1815))-- **Deep Scan recovery and progress.** Reports retain accepted worker coverage and its original evidence, including coverage recovered after cancellation or a discovery deadline. Standard and diff scans refresh phase and review counts from saved state even when the model emits no new progress markers. ([#1593](https://github.com/openai/codex-security/pull/1593), [#1757](https://github.com/openai/codex-security/pull/1757))-- **Windows setup.** Runtime preparation uses private workspaces in the state directory so elevated-sandbox permissions on `TEMP` do not prevent scans from starting. Policy generation supports the default elevated Windows sandbox; see the access details below. Update notices also recognize global installations managed by nvm-windows. ([#1803](https://github.com/openai/codex-security/pull/1803), [#1741](https://github.com/openai/codex-security/pull/1741), [#1801](https://github.com/openai/codex-security/pull/1801))-- **Reliable command results.** Optional logging, update notices, and scratch cleanup no longer override completed scan, import, or publication outcomes. Failed commands do not print success output, and patch and verification commands wait for required output writes to finish. ([#1800](https://github.com/openai/codex-security/pull/1800), [#1818](https://github.com/openai/codex-security/pull/1818), [#1824](https://github.com/openai/codex-security/pull/1824), [#1826](https://github.com/openai/codex-security/pull/1826), [#1775](https://github.com/openai/codex-security/pull/1775), [#1777](https://github.com/openai/codex-security/pull/1777))+- **Import vendor findings.** Import supported Wiz, Snyk Open Source, Semgrep Code, and Endor Labs reports with `publish findings --to local`, or publish them with `--to cloud`. Read local evidence with `findings imported`. Local imports require no Cloud login or model call and remain separate from assessed scan findings. See the [Wiz](https://github.com/openai/codex-security/blob/npm-v0.6.0/sdk/typescript/docs/cli.md#import-wiz-findings), [Snyk](https://github.com/openai/codex-security/blob/npm-v0.6.0/docs/scanner-imports/snyk.md), [Semgrep](https://github.com/openai/codex-security/blob/npm-v0.6.0/docs/scanner-imports/semgrep.md), and [Endor](https://github.com/openai/codex-security/blob/npm-v0.6.0/docs/scanner-imports/endor.md) format guides.+- **Configurable severity reviews.** `classify-severity` uses a bundled rubric when no custom rubric is supplied. `--runs N` selects 1–10 independent reviews, with three by default. The most common severity wins, with the highest severity breaking ties. ([#1765](https://github.com/openai/codex-security/pull/1765))+- **Optional owner suggestions.** `scan --owner-suggestions` writes a separate owner-suggestion report after supported committed Git scans. Suggestions preserve the completed scan and do not assign users. Owner enrichment is skipped when a scan cost limit is set. ([#1760](https://github.com/openai/codex-security/pull/1760))+- **Hosted patching and source-only verification.** `patch --host` and `verify-fix --host` expose the hosted remediation protocol through the CLI. Ordinary patch and verification commands accept `--verification-mode static` to assess source evidence; omitting it preserves standard verification. Static mode sets the assessment scope and does not enforce a command-execution boundary. See the [hosted remediation guide](https://github.com/openai/codex-security/blob/npm-v0.6.0/sdk/typescript/docs/hosted-remediation.md). ([#1854](https://github.com/openai/codex-security/pull/1854))+- **Policy previews without Python.** Policy diffs now run in Node while preserving diff formatting, cancellation, and source freshness checks. ([#1837](https://github.com/openai/codex-security/pull/1837))<details>-<summary>Other fixes</summary>+<summary>Other improvements</summary>-- Saved scopes, component scans, CSV imports, and activity displays preserve literal paths. Helper values beginning with `-` and literal TOML strings retain their values. ([#1812](https://github.com/openai/codex-security/pull/1812), [#1814](https://github.com/openai/codex-security/pull/1814), [#1786](https://github.com/openai/codex-security/pull/1786), [#1827](https://github.com/openai/codex-security/pull/1827), [#1809](https://github.com/openai/codex-security/pull/1809), [#1792](https://github.com/openai/codex-security/pull/1792))-- Basic patching supports Git repositories before their first commit. Directory inventories exclude `.svn` metadata, and component scans include tracked files matched by `.gitignore`. ([#1552](https://github.com/openai/codex-security/pull/1552), [#1768](https://github.com/openai/codex-security/pull/1768))-- Scan history, feedback selection, and automatic matching consistently use scan start times when choosing and comparing results. ([#1772](https://github.com/openai/codex-security/pull/1772), [#1774](https://github.com/openai/codex-security/pull/1774), [#1776](https://github.com/openai/codex-security/pull/1776), [#1779](https://github.com/openai/codex-security/pull/1779))-- SARIF exports preserve sealed scan artifacts. CSV processing preserves large quoted fields and finalized Deep Scan candidate metadata. ([#1769](https://github.com/openai/codex-security/pull/1769), [#1785](https://github.com/openai/codex-security/pull/1785), [#1828](https://github.com/openai/codex-security/pull/1828))-- Canceled fix verification restores an already applied patch's state. Deduplication reviews retry temporary Codex rate-limit errors, and cancellation is honored around embedding callbacks and saved result writes. ([#1819](https://github.com/openai/codex-security/pull/1819), [#1767](https://github.com/openai/codex-security/pull/1767), [#1789](https://github.com/openai/codex-security/pull/1789), [#1821](https://github.com/openai/codex-security/pull/1821))-- Runtime telemetry preserves analytics and OpenTelemetry controls across workers and remediation. ([#1691](https://github.com/openai/codex-security/pull/1691))-- Release automation waits for npm, installed-package checks, the GitHub Action, and container publication. Containers retain their place in the publication queue. ([#1796](https://github.com/openai/codex-security/pull/1796), [#1806](https://github.com/openai/codex-security/pull/1806))+- Patch project-trust overrides are serialized correctly for Codex. ([#1861](https://github.com/openai/codex-security/pull/1861))+- Update Hono and the Linear SDK dependencies. ([#1831](https://github.com/openai/codex-security/pull/1831), [#1852](https://github.com/openai/codex-security/pull/1852))+- Release verification runs test shards in parallel and reports publication progress on the release PR. ([#1798](https://github.com/openai/codex-security/pull/1798))</details>@@ -31,26 +27,20 @@ Codex Security 0.5.1 adds hosted patch generation and fix verification, and impr## Upgrade notes-### Windows policy generation+### Severity classification requires model access-With the elevated Windows sandbox, policy generation can read other local source, including sibling components. The policy prompt retains the selected component's scope. Credential, configuration, and Git metadata denials, read-only access, and disabled network access remain enforced. Explicit sandbox choices and Unix read scope are unchanged. ([#1741](https://github.com/openai/codex-security/pull/1741))+Classification without `--rubric` previously inherited the scanner's severity without model work. It now requires Codex authentication and model access, using three model calls per uncached finding by default. Set `--runs 1` (SDK: `classificationRuns: 1`) for a single review. All requested reviews must succeed; failures do not fall back to the scanner's severity or save a partial vote.-### Saved scans of SVN working copies+Older classification checkpoints without a recorded review count, and former inherited assessments without a rubric hash, are reclassified on the next classification request. Changing the review count or rubric also invalidates matching checkpoints. Existing results remain readable, and publication does not silently classify findings. Use `--reprocess` when changing only the model or reasoning effort. See the [classification guide](https://github.com/openai/codex-security/blob/npm-v0.6.0/sdk/typescript/docs/cli.md#classify-finding-severity).-Directory scans and patch identities now exclude `.svn` metadata. If a saved scan or patch included that metadata and no longer matches its source, restart the scan or regenerate the patch. Git diff and working-tree scans still require Git. ([#1552](https://github.com/openai/codex-security/pull/1552))+### Policy preview interpreter selection is deprecated-### Custom component and CSV scan clients+`securityPolicyDiff(draft, python, signal)` retains its call shape, but interpreter strings and paths returned by resolver callbacks no longer select or validate an executable. `previewPolicy()` no longer resolves Python, and `pythonPath` and `PYTHON` do not affect previews. Update integrations that relied on an invalid interpreter failing or a custom executable producing the diff. Explicit resolver callbacks still run for changed drafts and propagate their errors. Omit the second argument in new code, or pass `undefined` when supplying a cancellation signal. Python-dependent generation and other operations are unchanged.-Custom component clients and clients handling explicit CSV scopes now receive absolute scan targets. Component callers intentionally using home shorthand should supply an absolute path inside the repository. Saved plans and receipts retain their existing formats, and completed campaign receipts remain reusable. ([#1814](https://github.com/openai/codex-security/pull/1814))+### Import identity and earlier upgrades-### GitHub Action+Keep a stable source key and acquisition format across vendor imports. Switching formats can create separate records or replace richer evidence with less detail; omitted findings remain stored. Review each provider's format guide before changing inputs.-The Marketplace display name is now **OpenAI Codex Security**. Use `openai/[email protected]`, or pin the full distribution commit recorded in the Action release manifest. The npm package name remains `@openai/codex-security`. Marketplace publication is a separate step after the automated release. ([#1797](https://github.com/openai/codex-security/pull/1797))--### Upgrading from earlier releases--If upgrading from before 0.5.0, also review the [0.5.0 upgrade notes](https://github.com/openai/codex-security/releases/tag/npm-v0.5.0), including custom capability-preflight integrations and selected-profile approval settings.--If upgrading from before 0.4.0, upgrade CLI and plugin installations together when they share a Codex Security state directory. The shared issue-history migration preserves existing Linear receipts, but older publishers cannot write to the migrated database. ([#1426](https://github.com/openai/codex-security/pull/1426))+If upgrading from before 0.5.1, also review the [0.5.1 upgrade notes](https://github.com/openai/codex-security/releases/tag/npm-v0.5.1) and their guidance for earlier versions. Use `openai/[email protected]` for the matching GitHub Action, or pin the distribution commit in its companion release after publication.<!-- release-section: upgrades:end -->diff --git a/.github/release-pr-state.json b/.github/release-pr-state.jsonindex fb51847ba..27c58405f 100644--- a/.github/release-pr-state.json+++ b/.github/release-pr-state.json@@ -1,13 +1,13 @@{- "baseVersion": "0.5.0",- "baseCommit": "03414ad84e91a8638bde85af08c47fe957dc9323",+ "baseVersion": "0.5.1",+ "baseCommit": "b2fa51576d81cda5e311e7eb89131ffb13daad8b","sections": {"highlights": {- "generatedHash": "00960febb6fad941070c8071c18fa9d209d884b3e9e5d5f4ad264b24fe263aae",+ "generatedHash": "9c17957f706150b5ebfb2effc42159606c808ed05bc44f80320bd0fb1518c5fc","humanOwned": true},"upgrades": {- "generatedHash": "f0e089f37da057fc30882ef40dfe50f6b52abdc17018bf2d70c34afb22c66fe2",+ "generatedHash": "cdbfb62364372edf0e5202f7db41239aa0301d69187e022b9e9a9c9b0fcab298","humanOwned": true}}diff --git a/examples/github-actions/codex-security.yml b/examples/github-actions/codex-security.ymlindex 9df456414..23accb76e 100644--- a/examples/github-actions/codex-security.yml+++ b/examples/github-actions/codex-security.yml@@ -32,7 +32,7 @@ jobs:security-events: writeactions: readenv:- CODEX_SECURITY_VERSION: "0.5.1"+ CODEX_SECURITY_VERSION: "0.6.0"BEDROCK_MODEL_ID: ${{ vars.BEDROCK_MODEL_ID }}# Report-only by default. Set to "high" to fail on high/critical findings.FAIL_ON_SEVERITY: ""diff --git a/github-action/package-lock.json b/github-action/package-lock.jsonindex 66cf288d0..55e9a7d3e 100644--- a/github-action/package-lock.json+++ b/github-action/package-lock.json@@ -1,12 +1,12 @@{"name": "codex-security-action",- "version": "0.5.1",+ "version": "0.6.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "codex-security-action",- "version": "0.5.1",+ "version": "0.6.0","dependencies": {"@actions/artifact": "6.3.1","@actions/core": "3.0.1",diff --git a/github-action/package.json b/github-action/package.jsonindex 062f2fe4e..1bec738f0 100644--- a/github-action/package.json+++ b/github-action/package.json@@ -1,6 +1,6 @@{"name": "codex-security-action",- "version": "0.5.1",+ "version": "0.6.0","private": true,"type": "module","description": "Run Codex Security in GitHub Actions with explicit scope, budgets, and scan health reporting",diff --git a/sdk/typescript/package.json b/sdk/typescript/package.jsonindex f25e9d973..b2722e263 100644--- a/sdk/typescript/package.json+++ b/sdk/typescript/package.json@@ -1,6 +1,6 @@{"name": "@openai/codex-security",- "version": "0.5.1",+ "version": "0.6.0","description": "TypeScript SDK and CLI for Codex Security","license": "Apache-2.0","author": "OpenAI",