# VibeShield — Node.js CI Starter

This is the first milestone: a minimal Node.js backend with a simple GitHub Actions CI pipeline. It deliberately has no third-party runtime dependencies so the starting pipeline is easy to reproduce.

## Endpoints
- `GET /health` — health check
- `GET /api/v1` — demo API metadata
- Unknown paths return JSON `404`

## Run locally
Requirements: Node.js 20+ (CI uses Node.js 22).

```bash
npm ci
npm test
npm run build
npm start
```

Then visit `http://localhost:3000/health`.

## CI pipeline
On pushes and pull requests, GitHub Actions:
1. Checks out the repository.
2. Sets up Node.js.
3. Runs `npm ci`.
4. Runs automated tests.
5. Validates JavaScript syntax.

## Next VibeShield milestones
1. Add Express + Jest/Supertest if desired, retaining a lockfile.
2. Add Layer 1 security controls incrementally: Semgrep, Gitleaks, dependency scanning and Trivy.
3. Add SonarQube quality-gate integration.
4. Add Docker image scanning and Kubernetes manifest policies.
5. Add optional AWS ECR/EKS deployment using least-privilege OIDC.
6. Build the separate financial security test pack.

This starter is not a security scanner and does not claim OWASP Top 10 coverage yet. Those checks will be added in later milestones.
