cerber-core 1.0.0 → 1.0.2
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 +111 -1
- package/package.json +1 -1
- package/solo/README.md +1 -1
- package/team/README.md +1 -1
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
7
|
[](https://github.com/Agaslez/cerber-core)
|
|
8
8
|
|
|
9
|
-
**
|
|
9
|
+
**Owner:** Agata Ślęzak | **Creator:** Stefan Pitek
|
|
10
10
|
**Status:** Production-ready ✅
|
|
11
11
|
**License:** MIT
|
|
12
12
|
|
|
@@ -882,6 +882,88 @@ git commit # Guardian validates
|
|
|
882
882
|
|
|
883
883
|
---
|
|
884
884
|
|
|
885
|
+
## 📖 BIBLE.md - Your Project's Single Source of Truth
|
|
886
|
+
|
|
887
|
+
**BIBLE.md** is your project's master map - the ONE place where everything is documented.
|
|
888
|
+
|
|
889
|
+
### Why BIBLE.md?
|
|
890
|
+
|
|
891
|
+
With AI coding, teams can diverge quickly. Everyone works fast, but in different directions. BIBLE.md keeps everyone aligned:
|
|
892
|
+
|
|
893
|
+
- **All modules documented** - What exists, who owns it, what it does
|
|
894
|
+
- **All connections mapped** - How modules talk to each other
|
|
895
|
+
- **Team responsibilities clear** - Who works on what
|
|
896
|
+
- **Architecture decisions recorded** - Why things are built this way
|
|
897
|
+
|
|
898
|
+
### How It Works
|
|
899
|
+
|
|
900
|
+
```bash
|
|
901
|
+
# 1. Copy template
|
|
902
|
+
cp node_modules/cerber-core/team/templates/BIBLE_TEMPLATE.md .cerber/BIBLE.md
|
|
903
|
+
|
|
904
|
+
# 2. Describe your architecture
|
|
905
|
+
nano .cerber/BIBLE.md
|
|
906
|
+
|
|
907
|
+
# 3. Keep it updated when adding modules
|
|
908
|
+
# 4. Reference in code reviews
|
|
909
|
+
```
|
|
910
|
+
|
|
911
|
+
### What's Inside BIBLE.md?
|
|
912
|
+
|
|
913
|
+
```markdown
|
|
914
|
+
# PROJECT BIBLE - Master Map
|
|
915
|
+
|
|
916
|
+
## Architecture Overview
|
|
917
|
+
[Visual diagram of your system]
|
|
918
|
+
|
|
919
|
+
## Modules Index
|
|
920
|
+
1. **auth-service** - Authentication & JWT
|
|
921
|
+
- Owner: Alice
|
|
922
|
+
- Files: `src/modules/auth/`
|
|
923
|
+
|
|
924
|
+
2. **payment-service** - Stripe integration
|
|
925
|
+
- Owner: Bob
|
|
926
|
+
- Files: `src/modules/payment/`
|
|
927
|
+
|
|
928
|
+
## Connections Map
|
|
929
|
+
- `auth-service` → `user-service`: validateToken()
|
|
930
|
+
- `payment-service` → `notification-service`: sendReceipt()
|
|
931
|
+
|
|
932
|
+
## Team Responsibilities
|
|
933
|
+
- Alice: auth, user management
|
|
934
|
+
- Bob: payments, billing
|
|
935
|
+
```
|
|
936
|
+
|
|
937
|
+
### Integration with Cerber
|
|
938
|
+
|
|
939
|
+
Cerber automatically reads BIBLE.md from `.cerber/BIBLE.md` when running health checks:
|
|
940
|
+
|
|
941
|
+
```typescript
|
|
942
|
+
// server.ts
|
|
943
|
+
import { createHealthEndpoint } from 'cerber-core';
|
|
944
|
+
|
|
945
|
+
const healthChecks = {
|
|
946
|
+
// Cerber automatically validates against .cerber/BIBLE.md
|
|
947
|
+
architecture: async () => {
|
|
948
|
+
// Checks if actual modules match BIBLE structure
|
|
949
|
+
return await validateArchitectureAgainstBible();
|
|
950
|
+
}
|
|
951
|
+
};
|
|
952
|
+
|
|
953
|
+
app.get('/api/health', createHealthEndpoint(healthChecks));
|
|
954
|
+
```
|
|
955
|
+
|
|
956
|
+
**What Cerber checks:**
|
|
957
|
+
- **Guardian** validates modules match BIBLE structure (pre-commit)
|
|
958
|
+
- **Focus Mode** uses BIBLE to isolate context (500 LOC vs 10K LOC)
|
|
959
|
+
- **Module checks** ensure boundaries defined in BIBLE are respected
|
|
960
|
+
- **Morning checks** verify BIBLE is up-to-date with codebase
|
|
961
|
+
- **Runtime health** checks architecture drift from BIBLE
|
|
962
|
+
|
|
963
|
+
**Result:** Your team stays aligned even when coding at AI speed! 🚀
|
|
964
|
+
|
|
965
|
+
---
|
|
966
|
+
|
|
885
967
|
## 🏆 Why Cerber Core?
|
|
886
968
|
|
|
887
969
|
### Unique Innovations
|
|
@@ -1376,4 +1458,32 @@ Deploy:
|
|
|
1376
1458
|
|
|
1377
1459
|
Made with 🛡️ by developers, for developers
|
|
1378
1460
|
|
|
1461
|
+
---
|
|
1462
|
+
|
|
1463
|
+
## 👥 About the Project
|
|
1464
|
+
|
|
1465
|
+
**Founded by Agata Ślęzak**, created and developed by **Stefan Pitek**
|
|
1466
|
+
|
|
1467
|
+
### 🎯 The Story
|
|
1468
|
+
|
|
1469
|
+
**Stefan Pitek** - Career changer who started coding in May 2025
|
|
1470
|
+
- 30 years professional experience: 12 years banking, 8 years hospitality, 8 years business, 2 years as chef
|
|
1471
|
+
- Co-owned restaurant with Agata
|
|
1472
|
+
- First line of code: May 2025
|
|
1473
|
+
- 8 months later: 3 production SaaS apps + this open-source tool
|
|
1474
|
+
- Built entirely with AI assistance (Claude, ChatGPT, Copilot)
|
|
1475
|
+
|
|
1476
|
+
**Agata Ślęzak** - Business owner and project sponsor
|
|
1477
|
+
- Former restaurant co-owner
|
|
1478
|
+
- Provides business direction and funding
|
|
1479
|
+
- Handles legal and financial aspects
|
|
1480
|
+
- **Most importantly:** Believed in Stefan's potential when he had zero coding experience
|
|
1481
|
+
- Continues to support and encourage through every challenge
|
|
1482
|
+
|
|
1483
|
+
**Partnership:** 90/10 split reflecting business ownership and technical contribution.
|
|
1484
|
+
|
|
1485
|
+
> *"None of this would exist without Agata's unwavering belief and support. When I wrote my first `console.log`, she saw a future developer. Eight months later, here we are."* — Stefan
|
|
1486
|
+
|
|
1487
|
+
**From restaurants to SaaS** - bringing the same attention to quality and customer experience that we learned in hospitality.
|
|
1488
|
+
|
|
1379
1489
|
</div>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cerber-core",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Dual-layer code quality & production health monitoring - Guardian (pre-commit) + Cerber (runtime) + SOLO (automation) + TEAM (collaboration)",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
package/solo/README.md
CHANGED