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.
- package/.github/workflows/main.yml +18 -0
- package/GUIDE.md +46 -0
- package/LICENSE +26 -0
- package/README.md +176 -0
- package/action.yml +47 -0
- package/dist/index.js +1 -0
- package/dist/licenses.txt +588 -0
- package/dist/sentinel_core_bg.wasm +0 -0
- package/dist/sentinel_engine.wasm +0 -0
- package/examples/workflow.yml +22 -0
- package/index.js +134 -0
- package/lib/index-obfuscated.js +1 -0
- package/lib/pr-comment.js +116 -0
- package/lib/sentinel_core.js +122 -0
- package/lib/sentinel_core_bg.wasm +0 -0
- package/lib/sentinel_engine.wasm +0 -0
- package/manifest.json +7 -0
- package/marketplace-assets/screenshot1-cli-verdict.png +0 -0
- package/marketplace-assets/screenshot2-github-security.png +0 -0
- package/marketplace-assets/screenshot3-evidence-generator.png +0 -0
- package/marketplace-assets/screenshot4-action-result.png +0 -0
- package/package.json +28 -0
- package/test-action-local.js +27 -0
|
@@ -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
|
+

|
|
2
|
+

|
|
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"
|