All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
1.1.55 - 2026-01-09
- Updated the Coana CLI to v
14.12.148.
1.1.54 - 2026-01-09
- Updated the Coana CLI to v
14.12.143.
1.1.53 - 2026-01-06
- The
scan_typequery argument is now set to'socket_tier1'when runningsocket scan create --reach. This change ensures Tier 1 alerts from scans are ingested into the organization-level alerts correctly.
1.1.52 - 2026-01-02
- Added
--silenceflag tosocket fixto suppress intermediate output and show only the final result.
- Updated the Coana CLI to v
14.12.139.
1.1.51 - 2025-12-23
- Added internal
--reach-lazy-modeflag for reachability analysis.
- Updated the Coana CLI to v
14.12.138.
1.1.50 - 2025-12-19
- Fixed exit code when blocking alerts are found
1.1.49 - 2025-12-17
- Added initial telemetry functionality to track CLI usage and help improve the Socket experience.
- Fixed error propagation when npm package finalization failed in
socket fix.
- Updated the Coana CLI to v
14.12.134.
1.1.48 - 2025-12-16
- Updated the Coana CLI to v
14.12.130.
1.1.47 - 2025-12-15
- Added
--debugflag tosocket fixto enable verbose logging in the Coana CLI.
- Updated the Coana CLI to v
14.12.127.
1.1.46 - 2025-12-12
- Updated the Coana CLI to v
14.12.126.
1.1.45 - 2025-12-10
- Updated the Coana CLI to v
14.12.122.
- Added
--reach-use-only-pregenerated-sbomsto run the Tier 1 reachability based only on pre-computed CDX and SPDX SBOMs (all other manifests are excluded).
1.1.44 - 2025-12-09
- Updated the Coana CLI to v
14.12.118.
1.1.43 - 2025-12-08
- Added
--allflag tosocket fixfor explicitly processing all vulnerabilities in local mode. Cannot be used with--id.
- Running
socket fixin local mode without--allor--idis deprecated. A warning is shown when neither flag is provided. In a future release, one of these flags will be required.
1.1.42 - 2025-12-04
- Added
--ecosystemsflag tosocket fix.
- Updated the Coana CLI to v
14.12.113. - Rename
--limitflag to--pr-limitforsocket fix, but keep old flag as an alias. Note:--pr-limithas no effect in local mode, use--idoptions instead. - Process all vulnerabilities with
socket fixwhen no--idoptions are provided.
1.1.41 - 2025-12-02
- Added
--reach-versionflag tosocket scan createandsocket scan reachto override the @coana-tech/cli version used for reachability analysis. - Added
--fix-versionflag tosocket fixto override the @coana-tech/cli version used for fix analysis.
1.1.40 - 2025-12-02
- Fix a bug where vulnerabilities were not found correctly during
socket fix.
- Updated the Coana CLI to v
14.12.110.
1.1.39 - 2025-12-01
- Added the
--output <scan-report.json>flag tosocket scan reach.
- Updated the Coana CLI to v
14.12.107.
1.1.38 - 2025-11-26
- Enhanced CVE to GHSA conversion with improved error detection and caching for more reliable vulnerability lookups
1.1.37 - 2025-11-26
- Fix a bug where setting target path could cause incorrect manifest file paths for commands
socket scan reach <target>,socket scan create --reach <target>, andsocket fix <target>.
1.1.36 - 2025-11-26
- Fix a bug where the reachability analysis would hang on runs with analysis errors.
- Updated
@coana-tech/clito 14.12.100
1.1.35 - 2025-11-25
- Added
--reach-debugflag to enable verbose logging in the reachability Coana CLI
- Updated
@coana-tech/clito 14.12.100
1.1.34 - 2025-11-21
- The target path is now properly considered when conducting reachability analysis:
socket scan reach <target>andsocket scan create --reach <target>. - Fixed a bug where manifest files
<target>were not included in a scan when the target was pointing to a directory.
1.1.33 - 2025-11-20
- Updated
@coana-tech/clito 14.12.94
- Enhanced error badge visibility with improved text color contrast
1.1.32 - 2025-11-20
- Updated
@coana-tech/clito 14.12.90 - Updated
@cyclonedx/cdxgento 11.11.0
- Resolved
--limitflag behavior to correctly restrict vulnerability processing insocket fixlocal mode - Exclude
.socket.facts.jsonfiles fromsocket fixmanifest uploads
1.1.31 - 2025-11-19
- Enhanced pull request descriptions to remove duplicate package listings for cleaner, more readable output
1.1.30 - 2025-11-18
- Enhanced
SOCKET_CLI_COANA_LOCAL_PATHto support compiled Coana CLI binaries alongside Node.js script files
- Resolved PR creation workflow to properly recreate pull requests after closing or merging
- Corrected API token selection to honor
SOCKET_CLI_API_TOKENenvironment variable in package alert requests
1.1.29 - 2025-11-16
- Added options
--reach-concurrency <number>and--reach-disable-analysis-splittingforsocket scan create --reach
1.1.28 - 2025-11-13
- Backported
socket fixwith--jsonimprovements
1.1.27 - 2025-11-12
- Backported
--excludeand--includeflags forsocket fixcommand from v2
1.1.26 - 2025-11-08
- Debug logging of API requests/responses
1.1.23 - 2025-09-22
- Enhanced
--no-apply-fixesflag naming for improved clarity (previously--dont-apply-fixes) - Streamlined documentation and help text for better user experience
- Improved
pnpm dlxoperations by removing unnecessary--ignore-scriptsflag
- Resolved JSON example formatting in usage documentation
- Enhanced test reliability for cdxgen on Windows platforms
- Improved error handling in optimize command for pnpm environments
1.1.22 - 2025-09-20
- Rename
--only-computeflag to--dont-apply-fixesforsocket fix, but keep old flag as an alias.
- Resolved interactive prompts in
socket optimizewhen using pnpm - Sanitize extracted git repository names to be compatible with the Socket API.
1.1.21 - 2025-09-20
- New
--compact-headerflag for streamlined CLI output display
- Enhanced package manager interception for improved security scanning
- Improved detection of temporary package execution environments
- Enhanced error handling in
socket optimizewith proper exit codes
1.1.20 - 2025-09-19
- Terminal link support for enhanced command output formatting
- Resolved Windows compatibility issues with package manager execution
1.1.19 - 2025-09-19
- Enhanced testing capabilities for malware detection features
1.1.18 - 2025-09-18
- Enhanced compatibility with older Node.js versions
1.1.17 - 2025-09-18
- Enhanced Windows compatibility for package manager operations
1.1.16 - 2025-09-16
- Enhanced pnpm wrapper compatibility with dlx commands
1.1.15 - 2025-09-16
- Improved
socket fixerror messages for missing environment variables
- Resolved path handling issue in
socket optimizecommand
1.1.14 - 2025-09-17
- Enhanced third-party tool integration
1.1.13 - 2025-09-16
- New
--output-fileflag forsocket fixto save computed fixes to a JSON file - New
--only-computeflag forsocket fixto compute fixes without applying them
1.1.12 - 2025-09-15
- Enhanced security alert processing for more reliable operations
1.1.11 - 2025-09-12
- Improved multipart upload reliability with Socket SDK update
1.1.10 - 2025-09-11
- Enhanced command argument filtering for improved compatibility with npm and cdxgen integrations
1.1.9 - 2025-09-11
- Enhanced
socket fix --idto accept CVE IDs and PURLs in addition to GHSA IDs
- Correct SOCKET_CLI_API_TIMEOUT environment variable lookup
1.1.8 - 2025-09-11
- Clearer permission error messages to help resolve access issues
1.1.7 - 2025-09-11
- Control spinner display with new
--no-spinnerflag
- Enhanced proxy support for flexible network configurations
1.1.6 - 2025-09-10
- Improved pull request operations with better cache management
1.1.5 - 2025-09-10
- Enhanced reachability analysis spinner for consistent feedback
- Better working directory control with
--cwdflag improvements
1.1.4 - 2025-09-09
- Track release changes with CHANGELOG.md
- Enhanced development workflow with contributor guidance
- Control scan output detail with
--report-levelflag
1.1.1 - 2025-09-04
- Faster command completion with improved tab functionality
- Smoother user experience with better loading indicators
- Removed legacy
--testand--test-scriptflags fromsocket fix - Continued cleanup of legacy
socket fixcode
1.1.0 - 2025-09-03
- See package versions directly in
socket npmsecurity reports
- Clearer feedback for repeat
socket npminstallations - More reliable handling of scan timeouts
- Streamlined repeat installs by hiding redundant audit info
- More reliable file system operations
- Better configuration value handling
- Cleaned up legacy
socket fixcode
1.0.111 - 2025-09-03
- Reimplemented
--range-styleflag forsocket fix
- Enhanced CI/CD compatibility for reachability analysis and fixes
1.0.110 - 2025-09-03
- Enhanced reachability analysis and
socket fixfor better output handling
1.0.109 - 2025-09-03
- Improved build environment handling for better compatibility
1.0.108 - 2025-09-03
- Cleaner output from wrapped commands for focused results
1.0.107 - 2025-09-02
- Restored build stability for reliable deployments
1.0.106 - 2025-09-02
- Control reachability analysis caching with new
--reach-skip-cacheflag
1.0.104 - 2025-08-29
- Enhanced security advisory resolution for accurate vulnerability tracking
1.0.103 - 2025-08-29
- Improved GitHub Security Advisory processing
1.0.102 - 2025-08-29
- Enhanced command flag processing for better reliability
1.0.100 - 2025-08-29
- Richer debugging output for security advisory analysis
1.0.96 - 2025-08-27
- Streamlined organization selection for reachability analysis
1.0.89 - 2025-08-15
- Comprehensive manifest scanning with
socket scan create --reach
1.0.85 - 2025-08-01
- Flexible npm path configuration via
SOCKET_CLI_NPM_PATHenvironment variable
1.0.82 - 2025-07-30
- Memory optimization controls with
--max-old-space-sizeand--max-semi-space-sizeflags
1.0.80 - 2025-07-29
- Enhanced file discovery feedback in
socket scan create
1.0.73 - 2025-07-14
- Automatic detection of
.socket.facts.jsonconfiguration files
1.0.69 - 2025-07-10
- Skip pull request checks with new
--no-pr-checkflag forsocket fix
1.0.10 - 2025-06-28
- Enhanced performance and reliability across all commands
1.0.9 - 2025-06-28
- Improved stability and command execution speed
1.0.8 - 2025-06-27
- Faster command processing with optimized internals
1.0.7 - 2025-06-25
- Enhanced reliability through improved code quality
1.0.6 - 2025-06-25
- Smoother user experience with targeted improvements
1.0.5 - 2025-06-25
- Faster command execution with performance enhancements
1.0.4 - 2025-06-25
- More stable operations with targeted fixes
1.0.3 - 2025-06-25
- Load npm config as part of
socket fix
1.0.2 - 2025-06-25
- Added spinner to reachability scan
1.0.1 - 2025-06-24
- Package manager version logging to info
- Organization persistence when selecting orgs
- Made
socket fixcommand reuse implementations for better efficiency - Normalized options passed to
socket fix - Improved banner spacing logic
- Enhanced default org feedback and call-to-action
1.0.0 - 2025-06-13
- Official v1.0.0 release
- Added
socket org depsalias command
- Moved dependencies command to a subcommand of organization
- Improved UX for threat-feed and audit-logs
- Removed Node 18 deprecation warnings
- Removed v1 preparation flags
0.15.64 - 2025-06-13
- Improved
socket fixerror handling when server rejects request
- Final pre-v1.0.0 stability improvements
0.15.63 - 2025-06-12
- Enhanced debugging capabilities
0.15.62 - 2025-06-12
- Avoided double installing during
socket fixoperations
0.15.61 - 2025-06-11
- Memory management for
socket fixwith packument cache clearing
0.15.60 - 2025-06-10
- Widened Node.js test matrix
- Removed Node 18 support due to native-ts compatibility
0.15.59 - 2025-06-09
- Reduced Node version restrictions on CLI
0.15.57 - 2025-06-06
- Added
socket threat-feedsearch flags
0.15.56 - 2025-05-07
socket manifest setupfor project configuration- Enhanced debugging output and error handling
0.15.0 - 2025-05-07
- Enhanced
socket threat-feedwith new API endpoints socket.jsonconfiguration support- Improved
socket fixerror handling
- Avoid double installing with
socket fix - CI/CD improvements reducing GitHub Action dependencies for
socket fix
0.14.155 - 2025-05-07
SOCKET_CLI_API_BASE_URLfor base URL configurationDISABLE_GITHUB_CACHEenvironment variablecdxgenlifecycle logging and documentation hyperlinks
- Set
exitCode=1when login steps fail - Fixed Socket package URLs
- Band-aid fix for
socket analytics - Improved handling of non-SDK API calls
- Enhanced JSON-safe API handling
- Updated
cdxgenflags and configuration
0.14.0 - 2024-10-10
socket optimizeto apply Socket registry overrides- Suggestion flows to
socket scan create - JSON/markdown output support for
socket repos list - Enhanced organization command with
--jsonand--markdownflags SOCKET_CLI_NO_API_TOKENenvironment variable support- Improved test snapshot updating
- Spinner management in report flow and after API errors
- API error handling for non-SDK calls
- Package URL corrections
- Added Node permissions for shadow-bin
0.13.0 - 2024-09-06
socket threat-feedfor security threat information
0.12.0 - 2024-08-30
- Diff Scan command for comparing scan results
- Analytics enhancements and data visualization
- Feature to save analytics data to local files
0.11.0 - 2024-08-05
- Organization listing capability
0.10.0 - 2024-07-17
- Analytics command with graphical data visualization
- Interactive charts and graphs
0.9.0 - 2023-12-01
- Automatic latest version fetching for
socket info - Package scoring integration
- Human-readable issue rendering with clickable links
- Enhanced package analysis with scores
- Smart defaults for package version resolution
- Improved issue visualization and reporting
0.8.0 - 2023-08-10
- Configuration-based warnings from settings
- Enhanced
socket npminstallation safety checks
- Dropped Node 14 support (EOL April 2023)
- Added Node 16 manual testing due to c8 segfault issues
0.7.1 - 2023-06-13
- Python report creation capabilities
- CLI login/logout functionality
- Lockfile handling to ensure saves on
socket npm install - Report creation issues
- Python uploads via CLI
- Switched to base64 encoding for certain operations
0.6.0 - 2023-04-11
- Enhanced update notifier for npm wrapper
- TTY IPC to mitigate sub-shell prompts
0.5.0 - 2023-03-16
- npm/npx wrapper commands (
socket npm,socket npx) - npm provenance and publish action support
- Reusable consistent flags across commands
0.4.0 - 2023-01-20
- Persistent authentication - CLI remembers API key for full duration
- Comprehensive TypeScript integration and type checks
- Enhanced development tooling and dependencies
0.3.0 - 2022-12-13
- Support for globbed input and ignores for package scanning
--strictand--allflags to commands- Configuration support using
@socketsecurity/config
- Improved error handling and messaging
- Stricter TypeScript configuration
- Improved tests
0.2.1 - 2022-11-23
- Update notifier to inform users of new CLI versions
0.2.0 - 2022-11-23
- New
socket report viewfor viewing existing reports --viewflag toreport createfor immediate viewing- Enhanced report creation and viewing capabilities
- Synced up report create command with report view functionality
- Synced up info command with report view
- Improved examples in
--helpoutput
- Updated documentation and README with new features
0.1.2 - 2022-11-17
- Node 19 testing support
- Improved documentation
0.1.1 - 2022-11-07
- Extended README documentation
- Removed accidental debug code
0.1.0 - 2022-11-07
- Initial Socket CLI release
socket infofor package security informationsocket report createfor generating security reports- Basic CLI infrastructure and configuration