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
release: bump Codex Security to 0.1.22 (#694)
Kyle Browncd4cc7e21b17
diff --git a/.github/release-notes.md b/.github/release-notes.mdindex 0249180fd..3349eaa77 100644--- a/.github/release-notes.md+++ b/.github/release-notes.md@@ -1,36 +1,56 @@-<!-- release-version: 0.1.21 -->+<!-- release-version: 0.1.22 -->## Highlights-- Request an advisory assessment of a completed patch with- `patch --assess-patch-risk`. Add `--create-pr` to include its concise summary- in the draft pull request. The assessment is opt-in and does not approve or- merge changes. See- [patching and risk assessment](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#validate-and-patch-findings).-- Import GitHub code scanning alerts through the CLI or SDK for validation- against a local checkout. Imports are read-only and preserve the upstream- alert context. See- [GitHub alert imports](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#import-github-code-scanning-alerts).-- Publish findings from CSV with `publish scan --to cloud --csv PATH`, or- preview the upload without signing in or sending data with `--dry-run`.- See- [Cloud publication](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#publish-findings-to-cloud).-- Improve repeated-scan credential handling on Windows, sign-in recovery- messages, cleanup after interrupted publication, and refreshes of changed- bundled plugins.+- Store complete findings and embeddings in the preview findings service, with+ paginated listing, repository-scoped candidate retrieval, and durable duplicate+ groups. Publish a completed scan with+ `publish scan --to custom --scan SCAN_ID --findings-url URL`, or preview the+ payload with `--dry-run`. See the+ [findings service](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#findings-service-preview)+ and [custom publication](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#publishing-to-a-custom-findings-service).+- Review potential duplicates from the CLI or SDK with+ `dedupe --scan SCAN_ID --findings-url URL`. Reviews run on the calling host and save accepted groups+ without replacing original findings. Searches default to the scan's repository;+ `--all-repositories` explicitly broadens the scope. Add `--workflow-id` to scan,+ custom publication, and deduplication to reuse completed stages and checkpointed+ reviews after interruption. See+ [deduplication](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#deduplication-from-the-sdk-and-cli)+ and [workflow recovery](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#resuming-a-local-findings-workflow).+- Browse stored findings and duplicate groups in the service's read-only+ `/dashboard`, with search, repository filters, sorting, and record details.+ The dashboard shows service-owned data, not local scan or workflow history.+ See the [dashboard guide](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#read-only-dashboard).+- Add a separate findings-service container release and a Compose runner for the+ existing scanner CLI, with persistent state and source mounts. Both images+ support Linux `amd64` and `arm64`. See+ [container releases and the workflow runner](https://github.com/openai/codex-security/blob/npm-v0.1.22/docker/README.md).+- Preserve sealed scan artifacts when optional follow-up instructions fail,+ propagate caller cancellation during cloud publication, respect the exact+ POSIX `PATH` when resolving trusted executables, and retain nested attack-path+ evidence strings in saved finding previews.## Upgrade notes-- Finish operations using older versions before upgrading; credential-home- locks now follow the owning process's lifetime. See- [authentication](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#authentication).-- The bundled Codex runtime and SDK are now `0.149.1`. Custom executables- selected with `CODEX_CLI_PATH` need thread-source attribution support for- both `exec` and `app-server` (Codex `0.149.1+`). See- [runtime configuration](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#environment-variables).-- Existing Windows state with invalid ancestor permissions is not repaired- automatically. Keep the old reports and select a new private state- directory as described in- [scan history and recovery](https://github.com/openai/codex-security/blob/npm-v0.1.21/sdk/typescript/README.md#scan-history-and-reruns).+- The findings API and dashboard have no built-in authentication. Keep the+ service on a trusted local endpoint or behind an authenticated TLS proxy;+ Compose publishes only to host loopback. Nonempty imports send complete finding+ JSON to the OpenAI embeddings API and require an API key. A ChatGPT login is not+ an embedding credential. Duplicate review uses the calling host's Codex+ credentials separately, and embedding and review calls can incur usage charges.+- Stop the findings service and back up its entire state directory before+ upgrading. Startup applies SQLite migrations automatically; rollback requires+ the pre-upgrade backup and previous image. Existing findings are not+ automatically embedded: import them with their repository ID before using+ repository-scoped deduplication. Keep runner state separate from service state.+ See [backups and upgrades](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/README.md#upgrades-and-backups).+- Container publication is separate from npm publication. Use a version or digest+ only after the selected image release is available; source builds remain+ supported. Follow the [container setup](https://github.com/openai/codex-security/blob/npm-v0.1.22/docker/README.md#ghcr-administrator-setup)+ before the first registry release.+- Source checkouts now generate the SDK's bundled plugin from+ `plugins/codex-security`. Contributors should edit the canonical plugin source+ and run `pnpm run build:plugin`; the published npm package still includes the+ runtime payload. See [plugin source ownership](https://github.com/openai/codex-security/blob/npm-v0.1.22/sdk/typescript/TESTING.md).The categorized list below contains the individual changes.diff --git a/sdk/typescript/package.json b/sdk/typescript/package.jsonindex 7d1ea9898..071a62442 100644--- a/sdk/typescript/package.json+++ b/sdk/typescript/package.json@@ -1,6 +1,6 @@{"name": "@openai/codex-security",- "version": "0.1.21",+ "version": "0.1.22","description": "TypeScript SDK and CLI for Codex Security","license": "Apache-2.0","author": "OpenAI",