sentinel-scan-action 1.2.1

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.
@@ -0,0 +1,18 @@
1
+ name: Sentinel Compliance
2
+
3
+ on:
4
+ push:
5
+ pull_request:
6
+
7
+ jobs:
8
+ sentinel:
9
+ runs-on: ubuntu-latest
10
+
11
+ steps:
12
+ - name: Checkout repo
13
+ uses: actions/checkout@v4
14
+
15
+ - name: Run Sentinel scan
16
+ uses: MOXO08/sentinel-scan-action@v1
17
+ with:
18
+ manifest: manifest.json
package/GUIDE.md ADDED
@@ -0,0 +1,46 @@
1
+ # 📘 Mastering EU AI Act Compliance
2
+ **A Developer's Handbook to the 2026 Regulation**
3
+
4
+ ## Introduction
5
+ The EU AI Act is the world's first comprehensive AI law. For developers, this shifts compliance from a "legal problem" to a "technical requirement." Sentinel helps you bridge this gap in seconds.
6
+
7
+ ## ⚖️ The 4 Risk Categories
8
+ 1. **Unacceptable Risk**: (e.g., Social Scoring) — **Banned.**
9
+ 2. **High Risk**: (e.g., Recruitment AI) — **Strict requirements.**
10
+ 3. **Limited Risk**: (e.g., Chatbots) — **Transparency obligations.**
11
+ 4. **Minimal Risk**: (e.g., Spam filters) — **Free use.**
12
+
13
+ ## 🛠️ How to Prepare Your Manifest
14
+ Sentinel uses a `manifest.json` to understand your AI's capabilities. Here is the checklist for a **High-Risk** system:
15
+
16
+ ### 1. Transparency (Art. 13)
17
+ Ensure users know they are interacting with AI.
18
+ - `transparency_disclosure_provided`: true
19
+
20
+ ### 2. Data Governance (Art. 10)
21
+ Verify that your training data is documented and assessed for bias.
22
+ - `bias_assessment_performed`: true
23
+ - `data_governance_policy_documented`: true
24
+
25
+ ### 3. Human Oversight (Art. 14)
26
+ The system must be designed to be overseen by natural persons.
27
+ - `human_oversight_enabled`: true
28
+
29
+ ## 🚀 Integrating Sentinel in 3 Steps
30
+
31
+ ### Step 1: Install
32
+ ```bash
33
+ npx @radu_api/sentinel-scan --init
34
+ ```
35
+
36
+ ### Step 2: Audit
37
+ Run a local audit to find violations Before they reach production.
38
+ ```bash
39
+ npx @radu_api/sentinel-scan ./manifest.json
40
+ ```
41
+
42
+ ### Step 3: Automate
43
+ Add the Sentinel GitHub Action to block non-compliant PRs.
44
+
45
+ ---
46
+ _Need a Pro license for enterprise support? Visit [sentinel-ai.dev](https://sentinel-ai.dev)_
package/LICENSE ADDED
@@ -0,0 +1,26 @@
1
+ # Sentinel Proprietary License
2
+
3
+ Copyright (c) 2026 Sentinel AI. All Rights Reserved.
4
+
5
+ ## 1. OWNERSHIP AND GRANT OF USE
6
+ Sentinel ("the Software"), including its source code, binaries, WebAssembly (WASM) modules, and associated documentation, is the exclusive intellectual property of Sentinel AI ("the Licensor").
7
+
8
+ The Licensor grants you a limited, non-exclusive, non-transferable right to use the Software solely through its official distribution channels (e.g., GitHub Actions). This grant does not include access to the underlying source code.
9
+
10
+ ## 2. RESTRICTIONS
11
+ You are strictly prohibited from:
12
+ - **Reverse Engineering**: You shall not decompile, disassemble, or otherwise attempt to derive the source code from the WASM engine or any obfuscated components.
13
+ - **Redistribution**: You shall not copy, modify, distribute, or create derivative works of the Software without explicit written permission from the Licensor.
14
+ - **Sublicensing**: You shall not sell, rent, or lease the Software to any third party.
15
+
16
+ ## 3. PROPRIETARY RIGHTS
17
+ All intellectual property rights in and to the Software are and shall remain the sole property of the Licensor. Nothing in this License shall be construed as a transfer of ownership.
18
+
19
+ ## 4. TERMINATION
20
+ This License is effective until terminated. Your rights under this License will terminate automatically without notice from the Licensor if you fail to comply with any of its terms.
21
+
22
+ ## 5. DISCLAIMER OF WARRANTY
23
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THE SOFTWARE.
24
+
25
+ ---
26
+ For commercial licensing inquiries, contact: license@sentinel-ai.dev
package/README.md ADDED
@@ -0,0 +1,176 @@
1
+ ![EU AI Act Scan](https://img.shields.io/badge/Sentinel-EU%20AI%20Act%20Scan-blue)
2
+ ![CI Integration](https://img.shields.io/badge/GitHub%20Action-ready-green)
3
+
4
+ # 🛡 Sentinel — Deterministic AI Compliance for CI/CD
5
+
6
+ Sentinel is a compliance-as-code engine that verifies AI repositories against EU AI Act requirements directly inside developer workflows.
7
+
8
+ It performs deterministic regulatory checks during pull requests and CI builds, validates required documentation, and generates audit-ready compliance evidence.
9
+
10
+ Sentinel integrates with GitHub Actions and exports SARIF reports directly into GitHub Security.
11
+
12
+ ---
13
+
14
+ # Why Sentinel Exists
15
+
16
+ The EU AI Act introduces strict compliance obligations for organizations building or deploying AI systems.
17
+
18
+ Companies must prove:
19
+
20
+ • documented risk management
21
+ • traceable training data sources
22
+ • model documentation and governance
23
+ • regulatory audit evidence
24
+ • continuous monitoring of AI systems
25
+
26
+ Most teams only discover compliance gaps during legal reviews or regulatory audits.
27
+
28
+ Sentinel shifts compliance **left** by embedding regulatory checks directly into CI/CD pipelines.
29
+
30
+ Developers get immediate feedback during pull requests before compliance issues reach production.
31
+
32
+ ---
33
+
34
+ # 🚀 Quick Start
35
+
36
+ Add Sentinel to your GitHub workflow.
37
+
38
+ ```yaml
39
+ - name: Sentinel AI Compliance Scan
40
+ uses: MOXO08/sentinel-scan-action@v1
41
+ ```
42
+
43
+ Sentinel will automatically run EU AI Act compliance checks during pull requests and builds.
44
+
45
+ No additional configuration is required for basic scans.
46
+
47
+ ## 📸 How Sentinel Works
48
+
49
+ ### CLI Compliance Scan
50
+ Runs deterministic EU AI Act checks locally. Developers can run scans before pushing code.
51
+ ```bash
52
+ npx sentinel-scan ./manifest.json
53
+ ```
54
+
55
+ ### GitHub Action Integration
56
+ Sentinel runs automatically inside CI pipelines. It scans repositories during pull requests and builds. Results appear directly inside the pull request and GitHub Security tab.
57
+
58
+ ### SARIF Security Reporting
59
+ Sentinel exports compliance findings as SARIF. These appear as native GitHub Security alerts. Developers can review compliance issues exactly like security vulnerabilities.
60
+
61
+ ### Evidence Generation
62
+ Sentinel generates structured documentation templates required for regulatory audits.
63
+ ```bash
64
+ npx sentinel-scan evidence generate --policy-pack eu-ai-act-high-risk
65
+ ```
66
+ This creates `docs/compliance/` with structured compliance documentation templates.
67
+
68
+ ---
69
+
70
+ ## What Sentinel Checks
71
+
72
+ Sentinel enforces compliance policies across AI repositories. It performs:
73
+
74
+ • Manifest verification
75
+ • Policy pack enforcement
76
+ • Baseline-aware compliance checks
77
+ • Documentation validation
78
+ • SARIF security reporting
79
+ • Compliance evidence generation
80
+
81
+ These checks run automatically during CI/CD.
82
+
83
+ ---
84
+
85
+ ## Example GitHub Workflow
86
+
87
+ ```yaml
88
+ name: Sentinel Compliance
89
+
90
+ on:
91
+ pull_request:
92
+ push:
93
+ branches: [ main ]
94
+
95
+ jobs:
96
+ sentinel:
97
+ runs-on: ubuntu-latest
98
+
99
+ permissions:
100
+ security-events: write
101
+ contents: read
102
+
103
+ steps:
104
+ - uses: actions/checkout@v4
105
+
106
+ - name: Sentinel Compliance Scan
107
+ uses: MOXO08/sentinel-scan-action@v1
108
+ with:
109
+ manifest: "./manifest.json"
110
+ policy_pack: "eu-ai-act-high-risk"
111
+ ```
112
+
113
+ ---
114
+
115
+ ## Policy Packs
116
+
117
+ Sentinel ships with built-in regulatory rule sets. Available policy packs:
118
+
119
+ • `eu-ai-act-minimal`
120
+ • `eu-ai-act-high-risk`
121
+
122
+ List installed packs locally:
123
+ ```bash
124
+ npx sentinel-scan policy-pack list
125
+ ```
126
+
127
+ ---
128
+
129
+ ## Sentinel Verified Registry
130
+
131
+ Public AI repositories scanned with Sentinel are listed in the Sentinel Verified registry.
132
+
133
+ [https://moxo08.github.io/sentinel-verified/](https://moxo08.github.io/sentinel-verified/)
134
+
135
+ Projects using Sentinel can appear in the registry of AI systems scanned for EU AI Act readiness.
136
+
137
+ ---
138
+
139
+ ## Sentinel Ecosystem
140
+
141
+ Sentinel consists of multiple components:
142
+
143
+ • Sentinel CLI
144
+ • Sentinel GitHub Action
145
+ • Compliance evidence generator
146
+ • Policy pack engine
147
+
148
+ Main repository: [https://github.com/MOXO08/sentinel](https://github.com/MOXO08/sentinel)
149
+ NPM CLI: [https://www.npmjs.com/package/sentinel-scan](https://www.npmjs.com/package/sentinel-scan)
150
+
151
+ ---
152
+
153
+ ## License
154
+
155
+ UNLICENSED — Commercial use requires a Sentinel subscription. For enterprise licensing contact: [https://gettingsentinel.com](https://gettingsentinel.com)
156
+
157
+ ---
158
+
159
+ ## About
160
+
161
+ Sentinel is a deterministic compliance engine for AI systems. It enables organizations to verify EU AI Act readiness directly inside developer workflows.
162
+
163
+ **Topics:** `ci-cd` • `devsecops` • `ai-compliance` • `ai-governance` • `eu-ai-act` • `ai-risk` • `ai-audit`
164
+
165
+ ---
166
+
167
+ # Who Should Use Sentinel
168
+
169
+ Sentinel is designed for:
170
+
171
+ • **AI startups** preparing for EU market entry
172
+ • **Enterprises** building regulated AI systems
173
+ • **ML teams** shipping production AI models
174
+ • **DevSecOps teams** implementing compliance pipelines
175
+ • **Companies** deploying high-risk AI systems under the EU AI Act
176
+ Test: Sentinel PR comment validation.
package/action.yml ADDED
@@ -0,0 +1,47 @@
1
+ name: "Sentinel AI Compliance Scan"
2
+
3
+ description: "CI guardrail for EU AI Act compliance. Runs policy packs, verifies documentation, generates SARIF security alerts."
4
+
5
+ author: "MOXO08"
6
+
7
+ branding:
8
+ icon: "shield"
9
+ color: "blue"
10
+
11
+ inputs:
12
+ manifest:
13
+ description: "Path to AI manifest.json"
14
+ required: false
15
+ default: "./manifest.json"
16
+
17
+ enforce:
18
+ description: "If true, fails the CI job on compliance violations"
19
+ required: false
20
+ default: "false"
21
+
22
+ policy_pack:
23
+ description: "Sentinel policy pack (eu-ai-act-minimal | eu-ai-act-high-risk)"
24
+ required: false
25
+ default: "eu-ai-act-minimal"
26
+
27
+ baseline:
28
+ description: "Path to baseline file"
29
+ required: false
30
+
31
+ sarif:
32
+ description: "Generate SARIF report for GitHub Security"
33
+ required: false
34
+ default: "true"
35
+
36
+ evidence:
37
+ description: "Generate compliance evidence templates"
38
+ required: false
39
+ default: "false"
40
+
41
+ license_token:
42
+ description: "Sentinel Pro/Enterprise license token"
43
+ required: false
44
+
45
+ runs:
46
+ using: "node20"
47
+ main: "index.js"