nsauditor-ai 0.1.74 โ 0.1.76
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,15 +17,15 @@ NSAuditor AI is the open-source core of a privacy-first security intelligence pl
|
|
|
17
17
|
|
|
18
18
|
## What's New
|
|
19
19
|
|
|
20
|
-
**Latest: CE 0.1.
|
|
20
|
+
**Latest: CE 0.1.75 + Enterprise 0.13.0** (May 2026)
|
|
21
21
|
|
|
22
|
-
- ๐ **
|
|
22
|
+
- ๐ **CIS Critical Security Controls v8** (Center for Internet Security, May 2021; v8.1 errata June 2024) is now the **sixth** supported compliance framework in Enterprise โ alongside SOC 2, HIPAA, NIST CSF 2.0, PCI DSS v4.0.1, and ISO/IEC 27001:2022. Per-Safeguard mapping (the atomic, attestable unit): 17 covered + 21 partial + 115 OOS across **153 Safeguards / 18 Controls / 3 cumulative Implementation Groups**. **Implementation Group cumulative discipline** โ IG1=56 (the cyber-insurance baseline; ~50-70% of mid-market policies require IG1 attestation), IG2 cumulative=130, IG3 cumulative=153. **No-certification-body attestation discipline** โ engine output is INPUT to your CSAT / CIS-CAT Pro self-attestation (or a SOC 2 auditor cross-validating CIS scope), never "CIS certified." Cloud Companion Guide v8 shared-responsibility-model boundary + CIS-Hardened-Image substrate-evidence credit (Safeguards 4.1/4.2/4.6) + 5 Security Functions (NOT 6 โ no Govern) + MS-ISAC/EI-ISAC/H-ISAC sector baselines. Generate evidence for any combination from a single scan: `--compliance soc2,hipaa,nist-csf,pci-dss,iso-27001,cis-v8` (Enterprise only).
|
|
23
|
+
- ๐ **ISO/IEC 27001:2022** (added in EE 0.12.0) โ per-Annex-A-code mapping (auditor-canonical for ISO/IEC 17021-1 certification body assessors): 17 covered + 14 partial + 62 OOS across 93 Annex A controls. Statement of Applicability per Clause 6.1.3.d discipline + ISMS Clauses 4-10 OOS-by-design with 7 Major Nonconformity classes (absence of internal audit per Clause 9.2 or management review per Clause 9.3 = auto-fail Stage 2) + 11 NEW 2022 controls + 5-attribute taxonomy.
|
|
23
24
|
- ๐ณ **PCI DSS v4.0.1** (added in EE 0.11.0) โ Defined-vs-Customized Approach discipline per Appendix E. CDE scope operator-attested. Card-brand AOC enforcement priority view (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC).
|
|
24
|
-
- ๐ **Statement of Applicability per Clause 6.1.3.d discipline** for ISO 27001:2022 โ engine produces substrate for INCLUDED controls; SoA inclusion/exclusion is operator-side. **ISMS Clauses 4-10 OOS-by-design** with 7 Major Nonconformity classes (absence of internal audit per Clause 9.2 or management review per Clause 9.3 = auto-fail Stage 2). Skill #18 `audit-iso-27001-2022-statement-of-applicability` authored 2026-05-24 via /skill-creator (Per-Framework Adversarial-Audit Skill Pairing institutional pattern).
|
|
25
25
|
- โก **NIST Cybersecurity Framework 2.0** (added in EE 0.10.0) โ 13 covered + 10 partial + 83 OOS Subcategories across 106 of CSF 2.0's 107 Subcategories.
|
|
26
26
|
- ๐ฅ **HIPAA Security Rule ยง164.312** (added in EE 0.9.0) โ Zero BAA required; your ePHI never leaves your infrastructure.
|
|
27
|
-
- โ๏ธ **24 cloud plugins** across AWS, Azure, GCP โ fully integrated SOC 2 / HIPAA / NIST CSF 2.0 / PCI DSS v4.0.1 evidence pipeline (Enterprise).
|
|
28
|
-
- ๐ฌ **Per-Framework Adversarial-Audit Skill Pairing** (
|
|
27
|
+
- โ๏ธ **24 cloud plugins** across AWS, Azure, GCP โ fully integrated SOC 2 / HIPAA / NIST CSF 2.0 / PCI DSS v4.0.1 / ISO 27001 / CIS Controls v8 evidence pipeline (Enterprise).
|
|
28
|
+
- ๐ฌ **Per-Framework Adversarial-Audit Skill Pairing** (institutional pattern) โ Enterprise now ships with **10 authored Claude Code skills** (Phase-4 Compliance/GRC chain **7-of-7 COMPLETE** for all shipped frameworks). Each framework cycle is paired with a dedicated adversarial-audit skill authored in the same cycle: CIS Controls v8 pairs with NEW `audit-cis-controls-v8-implementation-group-perspective` (Skill #19) โ surfacing 16 ship-blocker classes pre-author for a clean ship.
|
|
29
29
|
|
|
30
30
|
โ Full release history: **[CHANGELOG.md](./CHANGELOG.md)**
|
|
31
31
|
โ See a sample EE scan output: **[walk-through with synthetic Acme Corp AWS account](https://www.nsauditor.com/ai/docs/sample-scan/)** (no signup required)
|
|
@@ -54,20 +54,22 @@ NSAuditor AI is available in three editions: Community (free, MIT-licensed, no r
|
|
|
54
54
|
|
|
55
55
|
### Why upgrade to Enterprise?
|
|
56
56
|
|
|
57
|
-
If you're heading into a **SOC 2, HIPAA, NIST CSF 2.0,
|
|
57
|
+
If you're heading into a **SOC 2, HIPAA, NIST CSF 2.0, PCI DSS, ISO 27001, or CIS Controls v8 audit** โ or need to satisfy customer security questionnaires citing those frameworks, or an IG1 attestation for cyber-insurance renewal โ Enterprise turns scan output into **auditor-ready evidence packs** that pass institutional scrutiny:
|
|
58
58
|
|
|
59
59
|
- โ๏ธ **24 cloud plugins** across AWS / Azure / GCP โ find the configuration risks an auditor will flag, before they do (CloudTrail integrity, KMS custody, S3 Object Lock, IAM shadow-admin paths, GCP IAM impersonation chains, Azure RBAC sprawl, and more)
|
|
60
|
-
- ๐ **
|
|
60
|
+
- ๐ **6 compliance frameworks shipped** โ generate any combination from a single scan:
|
|
61
61
|
- **SOC 2** (AICPA TSC 2017) โ 10 fully-covered + 4 partial controls
|
|
62
62
|
- **HIPAA Security Rule ยง164.312** โ 7 covered + 3 partial Technical Safeguards; **Zero BAA required** (ePHI never leaves your infrastructure)
|
|
63
63
|
- **NIST CSF 2.0 Core** (NIST CSWP 29, Feb 2024) โ 13 covered + 10 partial Subcategories across 106 of CSF 2.0's 107 Subcategories; Subcategory-level mapping (auditor-canonical, not high-level Function/Category claims)
|
|
64
64
|
- **PCI DSS v4.0.1** (PCI SSC, June 2024 errata; v3.2.1 retired March 31, 2024) โ **20 covered + 8 partial + 39 OOS sub-requirements across 67 of ~250 (MVP-67)**; sub-requirement-level mapping for QSA Report on Compliance workflow; Defined-vs-Customized Approach discipline per Appendix E (15 Defined-only sub-requirements enforced at schema layer); CHD Scope operator-attested via CDE Data Flow Diagram per Req 1.2.4; Card-brand AOC enforcement priority view (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC)
|
|
65
|
+
- **ISO/IEC 27001:2022** (ISO + IEC, Oct 2022; 2013 edition retired Oct 31, 2025) โ **17 covered + 14 partial + 62 OOS across 93 Annex A controls** (the complete Annex A universe); per-Annex-A-code mapping auditor-canonical for ISO/IEC 17021-1 certification body assessors; Statement of Applicability per Clause 6.1.3.d discipline + ISMS Clauses 4-10 OOS-by-design with 7 Major Nonconformity classes
|
|
66
|
+
- **CIS Critical Security Controls v8** (CIS, May 2021; v8.1 errata June 2024) โ **17 covered + 21 partial + 115 OOS across 153 Safeguards / 18 Controls**; per-Safeguard mapping with the **Implementation Group cumulative discipline** (IG1=56 cyber-insurance baseline / IG2 cumulative=130 / IG3 cumulative=153); no-certification-body attestation discipline (INPUT to your CSAT / CIS-CAT Pro self-attestation, never "CIS certified"); Cloud Companion Guide v8 shared-responsibility + CIS-Hardened-Image substrate-evidence credit (4.1/4.2/4.6)
|
|
65
67
|
- ๐ **Cryptographically signed evidence** โ SHA-256 chain-of-custody + RFC 3161 trusted timestamps + Ed25519 suppression signing. Non-repudiation, not just integrity. Auditors can verify offline.
|
|
66
68
|
- ๐๏ธ **Zero Data Exfiltration architecture** โ your scan data never leaves your infrastructure. Air-gapped deployment supported. AI analysis happens locally (Ollama) or via your own API keys. Important for PCI DSS CDE-isolation threat models.
|
|
67
69
|
- ๐ **Native GRC platform integration** โ push evidence directly to **Vanta** (live; Drata + Secureframe planned). Idempotent retries, per-tenant token rotation, rate-limit handling, signed-envelope round-trip integrity.
|
|
68
70
|
- ๐๏ธ **WORM evidence storage** โ S3 Object Lock COMPLIANCE-mode for SEC Rule 17a-4(f) / FINRA 4511 retention compliance
|
|
69
71
|
- ๐ **SLA / MTTR tracking + recurring-scan attestation** โ the **Type II operating-effectiveness evidence** auditors actually demand (not just point-in-time snapshots)
|
|
70
|
-
- ๐ฏ **
|
|
72
|
+
- ๐ฏ **10 adversarial-audit Claude Code skills** authored per the Per-Framework Adversarial-Audit Skill Pairing institutional pattern โ Phase-4 Compliance/GRC chain 7-of-7 COMPLETE for all shipped frameworks (SOC 2 + HIPAA + NIST CSF + PCI DSS + ISO 27001 + CIS Controls v8 + GRC connector)
|
|
71
73
|
|
|
72
74
|
โ **[See sample EE scan output](https://www.nsauditor.com/ai/docs/sample-scan/)** โ full evidence pack against synthetic Acme Corp AWS account (no signup required)
|
|
73
75
|
โ **[Buy NSAuditor AI Enterprise Edition](https://www.nsauditor.com/ai/pricing/)** โ $2k / $5k / $10k+ per year for 5 / 25 / unlimited seats + custom SLA. Onboarding call included.
|
|
@@ -89,12 +91,14 @@ If you're heading into a **SOC 2, HIPAA, NIST CSF 2.0, or PCI DSS audit** โ or
|
|
|
89
91
|
| **Enterprise โ cloud scanning** | | | |
|
|
90
92
|
| 24 cloud plugins (AWS / Azure / GCP) | โ | โ | โ
|
|
|
91
93
|
| Zero Trust assessment | โ | โ | โ
|
|
|
92
|
-
| **Enterprise โ compliance** | | | |
|
|
94
|
+
| **Enterprise โ compliance (6 frameworks)** | | | |
|
|
93
95
|
| SOC 2 (AICPA TSC 2017) โ 10 covered + 4 partial controls | โ | โ | โ
|
|
|
94
96
|
| HIPAA Security Rule ยง164.312 โ Zero BAA required | โ | โ | โ
|
|
|
95
|
-
| NIST CSF 2.0 Core โ Subcategory-level mapping | โ | โ | โ
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
97
|
+
| NIST CSF 2.0 Core โ Subcategory-level mapping (106 of 107 Subcategories) | โ | โ | โ
|
|
|
98
|
+
| PCI DSS v4.0.1 โ Sub-requirement-level mapping for QSA RoC (MVP-67) | โ | โ | โ
|
|
|
99
|
+
| ISO/IEC 27001:2022 โ per-Annex-A-code mapping + SoA discipline (93 Annex A controls) | โ | โ | โ
|
|
|
100
|
+
| **CIS Critical Security Controls v8** โ per-Safeguard mapping + IG-cumulative discipline (153 Safeguards / 18 Controls) (NEW) | โ | โ | โ
|
|
|
101
|
+
| Multi-framework `--compliance soc2,hipaa,nist-csf,pci-dss,iso-27001,cis-v8` from one scan | โ | โ | โ
|
|
|
98
102
|
| **Enterprise โ auditor-grade evidence** | | | |
|
|
99
103
|
| Signed evidence packs (SHA-256 + RFC 3161 timestamps) | โ | โ | โ
|
|
|
100
104
|
| Ed25519 suppression signing | โ | โ | โ
|
|
|
@@ -217,7 +221,7 @@ Results land in `./out/<host>_<timestamp>/`:
|
|
|
217
221
|
|
|
218
222
|
### Pro/Enterprise Plugins (via @nsasoft/nsauditor-ai-ee)
|
|
219
223
|
|
|
220
|
-
**
|
|
224
|
+
**25 enterprise plugins** across AWS, GCP, and Azure substrate audits โ all mapped to AICPA Trust Services Criteria 2017 (10 covered + 4 partial controls). EE plugins live in the disjoint 1000+ ID range; CE reserves 001-099. Once licensed, the EE package installs alongside the CE binary and discovers automatically.
|
|
221
225
|
|
|
222
226
|
โ **[Watch a sample scan run end-to-end](https://www.nsauditor.com/ai/docs/sample-scan/)** โ synthetic Acme Corp AWS account + home-office router. Real EE 0.6.7 output, no signup required. See the transitive SG chain reachability finding, the multi-region GuardDuty audit, the dnsmasq CVE detection, and what the signed evidence pack actually looks like.
|
|
223
227
|
|
|
@@ -257,10 +261,13 @@ Results land in `./out/<host>_<timestamp>/`:
|
|
|
257
261
|
| 1180 | AWS ElastiCache Redis | Enterprise | 6 dimensions: transit encryption, at-rest + KMS custody (four-tier ladder), Redis AUTH / IAM user groups (Redis 7+ ACL), Multi-AZ, snapshot retention cadence, subnet placement. Cross-plugin sister to plugin 1170 for cache-tier perimeter. **CC6.1 / CC6.2 / CC6.6 / A1.2 / C1.1** |
|
|
258
262
|
| 1190 | AWS SES Email Integrity | Enterprise | 6 dimensions: DKIM enablement + CNAME DNS resolution + key-fingerprint pin, DMARC TXT parsing + alignment classifier, custom MailFrom alignment, config-set TLS enforcement, sending-auth policy wildcards, dedicated IP pool, suppression list (count-only โ ZDE invariant: never reads addresses). **CC6.1 / CC6.6 / C1.1 / CC7.1 / Privacy** |
|
|
259
263
|
| 1200 | AWS Inspector2 / GuardDuty Enablement | Enterprise | 4 dimensions across all opted-in regions (17+ incl. GovCloud / ISO): GuardDuty Detector + protection features (S3 / EKS / EBS-malware / RDS-login / Lambda / RuntimeMonitoring), Inspector2 enablement, scan-target coverage. Plus alerting-destination dim (EventBridge or SecurityHub) and per-target liveness probes for Lambda / SNS / SQS / IAM / API destination / CloudWatch Logs. **CC7.1 / CC7.2** |
|
|
264
|
+
| 1210 | AWS EC2 Instance (**EE 0.13.1**) | Enterprise | Multi-region (DescribeRegions; single-region fallback emits an evidence-gap) EC2 instance audit: IMDSv1 enabled (IMDSv2-only enforcement; hop-limit > 1 container-escape) + EBS volume + account-default encryption + public-IP exposure (incl. IPv6 GUA + secondary-ENI/EIP) + instance-store evidence-gap. **AMI inventory โ CIS-Hardened-Image detection** on CIS Safeguards 4.1/4.2/4.6 โ the AWS producer; Azure (1022) + GCP (1021) feed the same `cisImageInventory` contract. **CC6.1 / C1.1 / CC6.6** |
|
|
260
265
|
| โ | SOC 2 Compliance Engine | Enterprise | AICPA TSC 2017 mapping (10 covered + 4 partial controls), chain-of-custody, RFC 3161 timestamps, suppression workflow with Ed25519 signing. |
|
|
261
266
|
| โ | **HIPAA Compliance Engine (EE 0.9.0)** | Enterprise | HIPAA Security Rule ยง164.312 Technical Safeguards mapping (7 covered + 3 partial + 45 OOS within ยง164.312 + entire ยง164.308 + entire ยง164.310). HHS Required/Addressable discipline per control. Same institutional-grade evidence infrastructure as SOC 2 (chain-of-custody, RFC 3161 timestamps, Ed25519 suppression signing). Use `--compliance hipaa` or `--compliance soc2,hipaa` for dual-framework reports from a single scan. **Zero BAA required** โ Zero Data Exfiltration architecture means ePHI never leaves customer infrastructure. |
|
|
262
267
|
| โ | **NIST CSF 2.0 Compliance Engine (EE 0.10.0)** | Enterprise | NIST Cybersecurity Framework 2.0 Core mapping at the auditor-canonical Subcategory level โ 13 covered + 10 partial + 83 OOS across 106 of CSF 2.0's 107 Subcategories. Govern function OOS-by-design (GV.SC-04 partial as substrate exception); Respond function OOS-entirely; Implementation Tiers 1-4 OOS as organizational-maturity claims. NIST SP 800-53 Rev. 5 + CIS Critical Security Controls v8 cross-references baked into `informativeReferences`. Use `--compliance nist-csf` or `--compliance soc2,hipaa,nist-csf` for triple-framework reports from a single scan. |
|
|
263
268
|
| โ | **PCI DSS v4.0.1 Compliance Engine (NEW EE 0.11.0)** | Enterprise | PCI DSS v4.0.1 (PCI SSC, June 2024 errata; supersedes v4.0 March 2022; v3.2.1 retired March 31, 2024) mapping at the auditor-canonical sub-requirement level for QSA Report on Compliance workflow โ **20 covered + 8 partial + 39 OOS across 67 of ~250 sub-requirements (MVP-67 density)**. Req 12 Information Security Program OOS-by-design entirely. Req 5 anti-malware + Req 9 physical OOS-entirely. **Defined-vs-Customized Approach discipline per Appendix E** โ 15 Defined-only sub-requirements enforced at schema layer. **Cardholder Data Environment (CDE) scope operator-attested** via CDE Data Flow Diagram per Req 1.2.4 + Req 12.5.1. **Card-brand AOC enforcement priority view** (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC). **4 load-bearing schema enrichments** per control: `controlType` + `approachEligibility` + `cloudProviderAttestation` (AWS / Azure / GCP currently-named AOCs) + `cdeScope`. CAO MVP-deferred to EE 0.11.1. Use `--compliance pci-dss` or `--compliance soc2,hipaa,nist-csf,pci-dss` for quad-framework reports from a single scan. |
|
|
269
|
+
| โ | **ISO/IEC 27001:2022 Compliance Engine (EE 0.12.0)** | Enterprise | ISO/IEC 27001:2022 (ISO + IEC, October 2022; 2013 edition retired October 31, 2025) Annex A mapping at the auditor-canonical per-Annex-A-code level for ISO/IEC 17021-1 certification body assessors โ **17 covered + 14 partial + 62 OOS across 93 Annex A controls** (the complete Annex A universe across 4 themes: A.5 Organizational 37 + A.6 People 8 + A.7 Physical 14 + A.8 Technological 34). **Statement of Applicability per Clause 6.1.3.d discipline** โ engine produces substrate for INCLUDED controls; SoA inclusion/exclusion is operator-side. **ISMS Clauses 4-10 OOS-by-design** with 7 Major Nonconformity classes (absence of internal audit per Clause 9.2 OR management review per Clause 9.3 = auto-fail Stage 2). 11 NEW 2022 controls + 5-attribute taxonomy (cybersecurityConcepts 5 categories, NOT 6 like NIST CSF) + 2013-to-2022 transition discipline + Cloud-Provider Certificate Inheritance Matrix. Use `--compliance iso-27001` or any combination for multi-framework reports from a single scan. |
|
|
270
|
+
| โ | **CIS Critical Security Controls v8 Compliance Engine (NEW EE 0.13.0)** | Enterprise | CIS Controls v8 (Center for Internet Security, May 2021; v8.1 errata June 2024) mapping at the per-Safeguard level (the atomic, attestable unit; coverage claimed at the SAFEGUARD level, never the Control level) โ **17 covered + 21 partial + 115 OOS across 153 Safeguards / 18 Controls**. **Implementation Group cumulative discipline** โ IG1=56 (cyber-insurance baseline; ~50-70% of mid-market policies require IG1 attestation), IG2 cumulative=130, IG3 cumulative=153; smallest-IG-membership tagging (NEVER report IG2 as 74-of-74 in isolation). **No-certification-body attestation discipline** โ engine output is INPUT to CSAT / CIS-CAT Pro self-attestation OR a SOC 2 auditor cross-validating CIS scope, never "CIS certified." Cloud Companion Guide v8 shared-responsibility-model boundary + CIS-Hardened-Image substrate-evidence credit (Safeguards 4.1/4.2/4.6) + 5 Security Functions (NOT 6 โ no Govern) + 6 Asset Types + MS-ISAC/EI-ISAC/H-ISAC sector baselines + v7.1-to-v8 cross-reference. Use `--compliance cis-v8` or `--compliance soc2,hipaa,nist-csf,pci-dss,iso-27001,cis-v8` for hexa-framework reports from a single scan. |
|
|
264
271
|
| โ | SLA & MTTR Tracking | Enterprise | Per-severity SLA targets, compensating-control flow, finding lifecycle, Type II rolling-quarter cadence. |
|
|
265
272
|
| โ | Recurring-Scan Attestation | Enterprise | Multi-scan chronological matrix, cadence gap detection, scope-drift surface (CC8.1). |
|
|
266
273
|
| โ | GRC Platform Connector | Enterprise | Native API push to Vanta / Drata / Secureframe with retry/backoff, idempotency, rate-limit handling, per-tenant token rotation. |
|
|
@@ -573,7 +580,7 @@ nsauditor-ai --version (or -v, or `version`)
|
|
|
573
580
|
| `--interval <min>` | Rescan interval in minutes (requires `--watch`) | `60` |
|
|
574
581
|
| `--webhook-url <url>` | Webhook URL for delta alerts | โ |
|
|
575
582
|
| `--alert-severity <sev>` | Minimum severity for webhook alerts | `high` |
|
|
576
|
-
| `--compliance <fw>` | Compliance framework to map findings into. Accepts CSV for multi-framework runs (e.g. `soc2`, `hipaa`, `nist-csf`, `pci-dss`, `iso-27001`, or any combination like `soc2,hipaa,nist-csf,pci-dss,iso-27001`). **Enterprise license required.** Supported frameworks as of EE 0.
|
|
583
|
+
| `--compliance <fw>` | Compliance framework to map findings into. Accepts CSV for multi-framework runs (e.g. `soc2`, `hipaa`, `nist-csf`, `pci-dss`, `iso-27001`, `cis-v8`, or any combination like `soc2,hipaa,nist-csf,pci-dss,iso-27001,cis-v8`). **Enterprise license required.** Supported frameworks as of EE 0.13.0: `soc2` (AICPA TSC 2017) + `hipaa` (HIPAA Security Rule ยง164.312 Technical Safeguards) + `nist-csf` (NIST Cybersecurity Framework 2.0 Core, CSWP 29 Feb 2024) + `pci-dss` (PCI DSS v4.0.1, PCI SSC June 2024 errata) + `iso-27001` (ISO/IEC 27001:2022, ISO + IEC October 2022) + `cis-v8` (CIS Critical Security Controls v8, CIS May 2021 / v8.1 errata June 2024). See `@nsasoft/nsauditor-ai-ee` README for per-framework coverage details. | โ |
|
|
577
584
|
| `--compliance-scope <path>` | Optional JSON file describing the assessment scope (passed to the compliance engine for cover-page attestation) | โ |
|
|
578
585
|
| `--help`, `-h` | Print usage block (subcommands, flags, env vars, examples) and exit 0 | โ |
|
|
579
586
|
| `--version`, `-v` | Print `nsauditor-ai <version>` and exit 0 | โ |
|