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 CHANGED
@@ -6,7 +6,7 @@
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
7
  [![GitHub](https://img.shields.io/badge/GitHub-cerber--core-blue.svg)](https://github.com/Agaslez/cerber-core)
8
8
 
9
- **Author:** Stefan Pitek
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.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
@@ -4,7 +4,7 @@
4
4
 
5
5
  Extends Cerber Core (Guardian 1.0 + Cerber 2.1) with intelligent automation specifically designed for solo developers.
6
6
 
7
- **Author:** Stefan Pitek
7
+ **Owner:** Agata Ślęzak | **Creator:** Stefan Pitek
8
8
  **Version:** 2.0
9
9
 
10
10
  ---
package/team/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Team collaboration layer for large codebases**
4
4
 
5
- Author: Stefan Pitek
5
+ Owner: Agata Ślęzak | Creator: Stefan Pitek
6
6
  Version: 2.0-team
7
7
 
8
8
  ---