Skip to content

Commit c23297f

Browse files
chore: flatten workspace, repo root = project root
The project repo now lives at /mnt/experiments/rohit-kumar-capstone directly (no nested sentinelcloud/ folder). idea.md and the supplied Yogananda School capstone template move into docs/source/ so they are tracked alongside the project as the source-of-truth brief. The .playwright-mcp/ directory and any sc-*.png / page-*.yml screenshot artefacts produced by browser tests stay outside git via .gitignore patterns added in the previous commit. Empty scaffolding folders (api/, infra/, knowledge/, scenarios/) are removed; their contents have been living under web/lib/ since the initial commit.
1 parent 5e190ea commit c23297f

4 files changed

Lines changed: 74 additions & 2 deletions

File tree

docs/CAPSTONE_REPORT.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
**Capstone Mentor:** \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
77
**Submission Window:** May 2026
88
**Live Artifact:** https://sentinelcloud.dmj.one
9-
**Source of Truth:** `/mnt/experiments/rohit-kumar-capstone/sentinelcloud`
9+
**Source of Truth:** `/mnt/experiments/rohit-kumar-capstone`
1010
**Version:** 1.0
1111

1212
---
@@ -776,7 +776,7 @@ This appendix is the runbook a reviewer should follow to reproduce every claim i
776776

777777
### A.1 Environment
778778

779-
The reference environment is Ubuntu 24.04 LTS with Node 20.11 LTS, pnpm 9.x, and the Google Cloud SDK 472.x. The repository is `/mnt/experiments/rohit-kumar-capstone/sentinelcloud`. The reproducibility tag for this report is `report-1.0` (to be applied at the time of submission).
779+
The reference environment is Ubuntu 24.04 LTS with Node 20.11 LTS, pnpm 9.x, and the Google Cloud SDK 472.x. The repository is `/mnt/experiments/rohit-kumar-capstone`. The reproducibility tag for this report is `report-1.0` (to be applied at the time of submission).
780780

781781
### A.2 Stub-Mode Reproduction (No Cloud Account Required)
782782

docs/source/Capstone_Template.docx

76.6 KB
Binary file not shown.

docs/source/idea.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
The Project: "SentinelCloud: An AI-Driven Autonomous DevOps Engineer"
2+
3+
To give you the full breakdown of **SentinelCloud**, we need to view it as a high-level architectural framework that bridges the gap between **Cloud Observability** and **Autonomous Remediation**.
4+
5+
In 2026, a project like SentinelCloud isn't just a collection of scripts; it is a **Closed-Loop Engineering System**. Below are the granular details of its design, functional modules, and operational workflow.
6+
7+
---
8+
9+
## 🏛️ 1. Technical Architecture: The Three-Layer Brain
10+
SentinelCloud operates on a tiered intelligence model that separates "Seeing" from "Thinking" and "Acting."
11+
12+
### A. The Perception Layer (Multimodal Ingestion)
13+
Unlike traditional monitoring that only looks at numbers (CPU/RAM), SentinelCloud ingests:
14+
* **Structured Data:** Telemetry (OpenTelemetry), K8s events, and CloudTrail logs.
15+
* **Unstructured Data:** Slack/Teams discussions during incidents and GitHub PR comments.
16+
* **Vectorized Context:** A RAG (Retrieval-Augmented Generation) database containing your specific infrastructure diagrams, "Golden Paths," and past post-mortems.
17+
18+
### B. The Reasoning Layer (Agentic Orchestration)
19+
This is the "AI Engineer" core. It uses a **Multi-Agent System (MAS)** where agents "debate" a solution:
20+
* **Agent 1 (Analyst):** Identifies the root cause (e.g., "A memory leak in Service A caused by the v2.4 deployment").
21+
* **Agent 2 (Safety/Compliance):** Checks if a proposed fix violates security policies (e.g., "You can't open port 80 to fix this").
22+
* **Agent 3 (The Strategist):** Decides the best action (e.g., "Roll back v2.4 and increase pod memory limits temporarily").
23+
24+
### C. The Actuation Layer (Infrastructure-as-Code)
25+
The AI doesn't click buttons in a UI. It interacts with the environment through:
26+
* **GitOps:** Opening Pull Requests to modify Terraform or Helm charts.
27+
* **Dynamic API Calls:** Scaling clusters or purging CDN caches via SDKs.
28+
* **Service Mesh Toggles:** Adjusting traffic weights in Istio/Linkerd to "quarantine" a failing microservice.
29+
30+
---
31+
32+
## 🛠️ 2. Deep Dive: Key Functional Modules
33+
34+
### 🔄 Module: Autonomous Incident Response (AIR)
35+
* **Function:** Zero-touch resolution of known failure modes.
36+
* **Workflow:** If a database connection pool is exhausted, SentinelCloud doesn't just alert; it identifies the "leaking" service, restarts the specific pods, and creates a Jira ticket with a pre-written analysis of the code line responsible.
37+
38+
### 💰 Module: FinOps Sentinel
39+
* **Function:** Real-time cost-to-performance optimization.
40+
* **Workflow:** It analyzes usage patterns to move non-critical workloads to **Spot Instances** during off-peak hours and automatically "right-sizes" over-provisioned VMs based on 30-day historical peaks.
41+
42+
### 🛡️ Module: Shift-Left Security Warden
43+
* **Function:** Real-time vulnerability suppression.
44+
* **Workflow:** When a new Zero-Day is announced, the Warden scans the entire fleet. If a patch isn't available, it autonomously writes and deploys a **WAF (Web Application Firewall)** rule to block the specific exploit pattern until the code is fixed.
45+
46+
---
47+
48+
## 📊 3. Performance Metrics (KPIs)
49+
A successful SentinelCloud implementation is measured by these four metrics:
50+
51+
| Metric | Definition | Targeted Goal |
52+
| :--- | :--- | :--- |
53+
| **MTTR (Resolution)** | Time from incident start to fully resolved. | < 5 Minutes (Autonomous) |
54+
| **Noise Reduction** | Percentage of alerts suppressed or auto-resolved. | > 90% |
55+
| **Drift Latency** | Time between a manual change and AI reverting it. | < 60 Seconds |
56+
| **Deployment Success** | Percentage of deployments that don't require human rollback. | 99.9% |
57+
58+
---
59+
60+
## ⚠️ 4. The "Trust" Guardrails (The Kill Switch)
61+
To prevent the AI from "hallucinating" and deleting a production database, SentinelCloud employs:
62+
1. **Semantic Validation:** Before any `terraform apply`, the AI must pass a test where a second, independent LLM model predicts the outcome of the change.
63+
2. **Human-on-the-Loop:** For "Critical" severity actions (like deleting resources), the AI pauses and sends a **Natural Language Summary** to an engineer: *"I want to delete these 4 idle load balancers to save $400/mo. Confirm?"*
64+
3. **Immutable Policy Gates:** Hardcoded rules (e.g., "Production must always have at least 3 replicas") that the AI cannot override, regardless of its reasoning.
65+
66+
---
67+
68+
## 💻 5. Implementation Roadmap
69+
1. **Phase 1 (Observer):** Deploy AI to monitor and provide "Advice" only (read-only access).
70+
2. **Phase 2 (Collaborator):** AI suggests PRs; humans click "Merge."
71+
3. **Phase 3 (Autonomous):** AI executes low-risk tasks (restarts, scaling) independently.
72+
4. **Phase 4 (Sentinel):** AI manages full lifecycle, including architectural changes and security response.
0 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)