v1.0.0
KeygraphHQ/shannonv1.0.0Mar 26, 2026by github-actions[bot]
AI Summary
Initial stable release of Shannon, an AI-powered security analysis tool. This major release includes a complete TypeScript migration, multi-model support across multiple providers (DeepSeek, OpenRouter, Google Vertex AI, AWS Bedrock), a new npx CLI with CI/CD integration, and a unified audit system v3.0 with crash-safety and self-healing capabilities.
Key Highlights
- Complete TypeScript migration for improved type safety and maintainability
- Multi-model support with DeepSeek, OpenRouter, Google Vertex AI, and AWS Bedrock providers
- New npx CLI with monorepo, CI/CD, and ephemeral worker architecture
- Unified audit system v3.0 with crash-safety and self-healing
- Docker improvements including Playwright MCP browser automation and Podman auto-detection
New Features
- Beta release and rollback workflows with cosign signing
- Claude-code-router support for multi-model testing
- Configurable output directory with --output flag
- Configurable pipeline retry and concurrency settings
- Custom base URL support for Anthropic-compatible endpoints
- DeepSeek provider support for claude-code-router
- Environment variable support for Claude Code token limits
- Google Vertex AI support with service account auth
- Model tracking and reporting across pipeline
- Named workspaces and workspace listing
- OpenRouter provider support
- Preflight validation phase with structured error reporting
- Three-tier model system with Bedrock support
- Workflow resume from workspace via --workspace flag
- Unified audit system v3.0 with crash-safety and self-healing
- Migrate to use MCP tools instead of helper scripts
- Expand injection analysis scope to cover LFI/RFI/SSTI/Path Traversal/Deserialization
- Upgrade claude-agent-sdk to 0.2.38
Full Release Notes
# 1.0.0 (2026-03-26) ### Bug Fixes * add cache-busting param to screenshot URL ([#82](https://github.com/KeygraphHQ/shannon/issues/82)) ([4aee8db](https://github.com/KeygraphHQ/shannon/commit/4aee8db3d023414ca03f2d8f6220cf6181f06ed8)) * add chunked writing instructions to all agent prompts ([30b5522](https://github.com/KeygraphHQ/shannon/commit/30b5522647bdb76daa902e161208426f91d95d57)) * add file_path parameter to save_deliverable for large reports ([#123](https://github.com/KeygraphHQ/shannon/issues/123)) ([2f4fa89](https://github.com/KeygraphHQ/shannon/commit/2f4fa89e7b22396a0808421629d6bf100492e677)) * Add Linux support for Docker volume permissions ([11fdb69](https://github.com/KeygraphHQ/shannon/commit/11fdb69826ace61bba718c495fc846f151db7cf6)) * add universal billing error detection for router mode ([9606ffc](https://github.com/KeygraphHQ/shannon/commit/9606ffcf7024a3fd897e722615730e10bcd186c4)) * auto-detect Podman to avoid host-gateway incompatibility ([#117](https://github.com/KeygraphHQ/shannon/issues/117)) ([a5daa07](https://github.com/KeygraphHQ/shannon/commit/a5daa071788fb97a74d88dc236b930947b77d9ee)) * configure git to trust all directories in Docker ([515ade8](https://github.com/KeygraphHQ/shannon/commit/515ade8302716e76f66bbca59e38ab532fea920e)) * copy deliverables to audit-logs once at workflow end instead of per-agent ([7f9c5cc](https://github.com/KeygraphHQ/shannon/commit/7f9c5cc496c3d047ba6c7077bc23c92c3303a62f)) * critical bug - exploitation phase was always skipped ([cfe8dc8](https://github.com/KeygraphHQ/shannon/commit/cfe8dc8bc89f0feacd110b3576bc9a71fd9a0787)) * enable Playwright MCP browser automation in Docker containers ([f40f52f](https://github.com/KeygraphHQ/shannon/commit/f40f52f1181afa22074da4a2f2334e1d6e1903ee)), closes [#docker-playwright-browser-issues](https://github.com/KeygraphHQ/shannon/issues/docker-playwright-browser-issues) * ensure deliverables directory is writable by container user ([#116](https://github.com/KeygraphHQ/shannon/issues/116)) ([24bcd29](https://github.com/KeygraphHQ/shannon/commit/24bcd29d978810fb8515ec6341f57fa8be039b36)) * err handling for claude code session limit ([cc36fe9](https://github.com/KeygraphHQ/shannon/commit/cc36fe933d61ec4618a2dba492034495ad556c4d)) * extend heartbeat timeout to prevent stalls during sub-agent execution ([#108](https://github.com/KeygraphHQ/shannon/issues/108)) ([9809c76](https://github.com/KeygraphHQ/shannon/commit/9809c769e30de19ade691ab21d879a5ea856918b)) * improve resume edge cases and shell quoting ([539bd87](https://github.com/KeygraphHQ/shannon/commit/539bd873cc8f62cf43caa83f7cafa2f21f511071)) * mount repos and configs directories into worker container ([#107](https://github.com/KeygraphHQ/shannon/issues/107)) ([2e9ee2a](https://github.com/KeygraphHQ/shannon/commit/2e9ee2a11e709d7a1e161e35160380f5c29e1d7a)) * pass router env vars to SDK subprocess ([742b74c](https://github.com/KeygraphHQ/shannon/commit/742b74c86f58ce9636b8df37d87a3159d5217406)) * prevent deliverables from being lost during agent retry rollbacks ([#112](https://github.com/KeygraphHQ/shannon/issues/112)) ([efb5368](https://github.com/KeygraphHQ/shannon/commit/efb5368b3c2f22e33396294124f1e98f10fd5ad9)) * removed comments ([23618f1](https://github.com/KeygraphHQ/shannon/commit/23618f1fd1bfcc69501b6400b3e23c094260aa9d)) * renamed agent filename ([bbd9db2](https://github.com/KeygraphHQ/shannon/commit/bbd9db2a61c9f4e470202f15e86bd65214c5bd69)) * resolve Docker build failure and clarify env var configuration ([719bf03](https://github.com/KeygraphHQ/shannon/commit/719bf03293277173ca100ff3ee6729031767e25b)) * resolve named workspace workflow ID in logs command ([759c8d8](https://github.com/KeygraphHQ/shannon/commit/759c8d80932d8e9ef7b7cf51c385c7c5332433bd)) * resolve resume workflow ID in logs command ([2cf237d](https://github.com/KeygraphHQ/shannon/commit/2cf237d6382be3535064fe5df7a8fc199c51e6a8)) * restore CLAUDE_CODE_MAX_OUTPUT_TOKENS env var support ([c169b0d](https://github.com/KeygraphHQ/shannon/commit/c169b0d0a620da5c9b46d9e20f57afe5701addb9)) * set originalWorkflowId in logPhaseTransition and remove path import from agents.ts ([f017a41](https://github.com/KeygraphHQ/shannon/commit/f017a4143614a975531d59b38972244a05520702)) * set write permissions on audit-logs and output directories for container user ([65aa562](https://github.com/KeygraphHQ/shannon/commit/65aa5625f6fde428ded981440513dacad7751157)) * store checkpoint as success commit hash and show cumulative metrics ([1b696ca](https://github.com/KeygraphHQ/shannon/commit/1b696cac1bb3a3b85338ec9a225eec10bdc1275c)) * support absolute config paths in checkpoint manager ([39766d0](https://github.com/KeygraphHQ/shannon/commit/39766d0afc452f1d6b7eb93376130a50ddf38a60)) * update session.json status on workflow completion ([dbcb458](https://github.com/KeygraphHQ/shannon/commit/dbcb4587ee0fe381436363202c68ca98805c19b5)) * use session's original createdAt instead of current time ([f0b8c3a](https://github.com/KeygraphHQ/shannon/commit/f0b8c3aa6e0a707038bb5e1be8595bd79ab7a3c3)) ### Features * add beta release and rollback workflows with cosign signing ([#247](https://github.com/KeygraphHQ/shannon/issues/247)) ([601fbe7](https://github.com/KeygraphHQ/shannon/commit/601fbe7756e078aa309a84eca88e96e4f874d03d)) * add claude-code-router support for multi-model testing ([914860a](https://github.com/KeygraphHQ/shannon/commit/914860a6bdf317b1bb343fd82ed7d66e067d8c91)) * add configurable output directory with --output flag ([#41](https://github.com/KeygraphHQ/shannon/issues/41)) ([8381198](https://github.com/KeygraphHQ/shannon/commit/8381198c418ff91f6a70c567faf73729ea53f353)) * add configurable pipeline retry and concurrency settings ([#157](https://github.com/KeygraphHQ/shannon/issues/157)) ([d67c07d](https://github.com/KeygraphHQ/shannon/commit/d67c07dc557fd2df2f48399c9e987c1c21b00bcf)) * add custom base URL support for Anthropic-compatible endpoints ([#246](https://github.com/KeygraphHQ/shannon/issues/246)) ([ae4bd45](https://github.com/KeygraphHQ/shannon/commit/ae4bd45a301e491dde5a3fe1a77923121e21d562)) * add DeepSeek provider support for claude-code-router ([d925c49](https://github.com/KeygraphHQ/shannon/commit/d925c4942be2001e83f0f63ed7419ba2ebfc5d79)) * add environment variable support for Claude Code token limits ([0b9580a](https://github.com/KeygraphHQ/shannon/commit/0b9580a99aa2d99830505fb6d144252c07fb1bf3)) * add Google Vertex AI support with service account auth ([6a76df2](https://github.com/KeygraphHQ/shannon/commit/6a76df2f4c653778c67dfc375ff07a84696ffcfe)) * add issue templates ([#110](https://github.com/KeygraphHQ/shannon/issues/110)) ([77c5b26](https://github.com/KeygraphHQ/shannon/commit/77c5b26a945af439a17f31cab3cdefac9a529989)) * add model tracking and reporting across pipeline ([cd04c7a](https://github.com/KeygraphHQ/shannon/commit/cd04c7a6d2d34f6bfbc7dcc986c9287a8fac913d)) * add MSYS path fix, Claude Code CLI, and Windows instructions ([e85f6e0](https://github.com/KeygraphHQ/shannon/commit/e85f6e0c73850e4127197e7180ffd9ff88d436cf)) * add named workspaces and workspace listing ([ee5d7b8](https://github.com/KeygraphHQ/shannon/commit/ee5d7b80a0d8b281d52a08195c3a2f70241b6a5e)) * add npx CLI with monorepo, CI/CD, and ephemeral worker architecture ([#256](https://github.com/KeygraphHQ/shannon/issues/256)) ([bc8fd20](https://github.com/KeygraphHQ/shannon/commit/bc8fd203edb0af18b18bdc4bc4efe122262cc743)), closes [#252](https://github.com/KeygraphHQ/shannon/issues/252) [#254](https://github.com/KeygraphHQ/shannon/issues/254) [#255](https://github.com/KeygraphHQ/shannon/issues/255) * add OpenRouter provider support for claude-code-router ([d01980c](https://github.com/KeygraphHQ/shannon/commit/d01980ce4b5fddbb811dc77a36394aabf97c674b)) * add preflight validation phase with structured error reporting ([c0d46cb](https://github.com/KeygraphHQ/shannon/commit/c0d46cb6b9b1ed3cf4ed38b61683296e33b94671)) * add resume header to workflow.log showing previous workflow ID and checkpoint ([9074149](https://github.com/KeygraphHQ/shannon/commit/9074149778d9e78a01c2bdfba5b740ff2cbe4a2c)) * add three-tier model system with Bedrock support ([b62abfe](https://github.com/KeygraphHQ/shannon/commit/b62abfea4c675f83ee3369993add1b78d84bc056)) * add workflow resume from workspace via --workspace flag ([f932fad](https://github.com/KeygraphHQ/shannon/commit/f932fad2edae6b1e539646740062ce0dfbe0a6f0)) * copy deliverables to audit-logs for self-contained audit trail ([80bc8e3](https://github.com/KeygraphHQ/shannon/commit/80bc8e3a44a163aaf4c8c9a71a401386628d66d9)) * expand injection analysis scope to cover LFI/RFI/SSTI/Path Traversal/Deserialization ([d82d1fa](https://github.com/KeygraphHQ/shannon/commit/d82d1fa7530e0663328924dd6c3b3c95bf309ba8)) * implement unified audit system v3.0 with crash-safety and self-healing ([27334a4](https://github.com/KeygraphHQ/shannon/commit/27334a4dd6aedb375351cd8abfbab9c052f296e9)) * improve audit log naming with timestamp and app context ([258830b](https://github.com/KeygraphHQ/shannon/commit/258830b030c802f4a3cbbadcfbb1d30bf8cb1bb7)) * migrate to use MCP tools instead of helper scripts ([eae0b8d](https://github.com/KeygraphHQ/shannon/commit/eae0b8d654e210b06c457e2f5a469a4ae7258a98)) * typescript migration ([#40](https://github.com/KeygraphHQ/shannon/issues/40)) ([3ac07a4](https://github.com/KeygraphHQ/shannon/commit/3ac07a471896a6946a596a6df2d8db523914b8bd)) * upgrade claude-agent-sdk to 0.2.38 and adapt to new SDK types ([#113](https://github.com/KeygraphHQ/shannon/issues/113)) ([3c13a9a](https://github.com/KeygraphHQ/shannon/commit/3c13a9a7e6eb2a2856ad00f59d8cf06f76f56b0d)) ### Reverts * remove '402' billing pattern causing false positives ([63741d7](https://github.com/KeygraphHQ/shannon/commit/63741d780e5b6ccd7a579a1f551a58affbfba94b))