Metadata-Version: 2.4
Name: aegis-ai-suite
Version: 1.0.3
Summary: aegisCore AI Workspace Suite — Enterprise Multi-Agent Core CRM, Standalone Companion Chat, and Local Companion Agent
Author-email: Sachin Bose Pulikkathara <sachin.bose.p@gmail.com>
License: Open Commercial and Internal Use
Project-URL: Homepage, https://pypi.org/project/aegis-ai-suite/
Project-URL: Documentation, https://github.com/sachin-bose-p
Project-URL: Repository, https://github.com/sachin-bose-p
Project-URL: Author LinkedIn, https://www.linkedin.com/in/sachin-bose-p/
Project-URL: Bug Tracker, https://github.com/sachin-bose-p
Keywords: aegis,aegis-ai,aegis-ai-suite,ai-agents,sdlc,crm,devops,coding-assistant,companion-chat,multi-agent,fastapi
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn[standard]>=0.29.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: pydantic-settings>=2.2.0
Requires-Dist: email-validator>=2.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: bcrypt>=4.1.0
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: markdown>=3.5.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: truststore>=0.9.0
Requires-Dist: PyJWT>=2.8.0
Requires-Dist: langchain==0.3.0
Requires-Dist: langchain-community==0.3.0
Requires-Dist: langchain-core==0.3.0
Requires-Dist: langchain-chroma
Requires-Dist: langchain-huggingface
Requires-Dist: langchain-openai<0.3.0,>=0.2.0
Requires-Dist: langchain-anthropic<0.3.0,>=0.2.0
Requires-Dist: langchain-google-genai<2.1.0,>=2.0.0
Requires-Dist: langchain-groq<0.3.0,>=0.2.0
Requires-Dist: langchain-ollama<0.3.0,>=0.2.0
Requires-Dist: chromadb
Requires-Dist: pypdfium2>=4.30.0
Requires-Dist: pypdf>=4.0.0
Requires-Dist: openapi-spec-validator>=0.7.0
Requires-Dist: openpyxl
Requires-Dist: python-docx
Requires-Dist: python-pptx
Requires-Dist: pytesseract
Requires-Dist: Pillow>=10.0.0
Requires-Dist: sentence-transformers
Requires-Dist: transformers<4.47.0,>=4.46.0
Requires-Dist: tokenizers>=0.20.3
Requires-Dist: huggingface-hub>=0.28.1
Requires-Dist: accelerate
Requires-Dist: pywebpush
Requires-Dist: APScheduler
Requires-Dist: faster-whisper==1.2.1
Requires-Dist: ptts==0.4.2
Requires-Dist: beautifulsoup4>=4.13.0
Requires-Dist: feedparser==6.0.14
Requires-Dist: feedparser-sgmllib==2.1.0
Requires-Dist: SQLAlchemy<2.1,>=2.0
Requires-Dist: psycopg2-binary
Requires-Dist: pyotp
Requires-Dist: qrcode[pil]
Requires-Dist: radon>=6.0.1
Requires-Dist: lizard>=1.24.0
Requires-Dist: psycopg[binary]>=3.2.0
Requires-Dist: pgvector>=0.3.0
Requires-Dist: openai>=1.20.0
Requires-Dist: anthropic>=0.18.0
Requires-Dist: google-genai>=0.1.0
Requires-Dist: langgraph<0.3.0,>=0.2.0
Requires-Dist: langgraph-checkpoint-postgres<3.0.0,>=2.0.0
Requires-Dist: psycopg-pool>=3.2.0
Requires-Dist: asyncpg>=0.29.0
Requires-Dist: mcp<3,>=2
Requires-Dist: sqlglot>=25.0.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: tzdata>=2024.1; sys_platform == "win32"
Requires-Dist: pywinpty; sys_platform == "win32"
Requires-Dist: ptyprocess>=0.7.0
Requires-Dist: websockets>=12.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: av>=11
Requires-Dist: playwright
Requires-Dist: markitdown
Requires-Dist: tree-sitter<0.27,>=0.22.0
Requires-Dist: tree-sitter-python>=0.21.0
Requires-Dist: tree-sitter-javascript>=0.21.0
Requires-Dist: tree-sitter-typescript>=0.21.0
Requires-Dist: tree-sitter-java==0.23.5
Requires-Dist: tree-sitter-c-sharp==0.23.1
Requires-Dist: tree-sitter-go==0.23.4
Requires-Dist: tree-sitter-rust==0.23.2
Requires-Dist: tree-sitter-php==0.23.11
Requires-Dist: tree-sitter-ruby==0.23.1
Requires-Dist: tree-sitter-cpp==0.23.4
Requires-Dist: tree-sitter-c==0.23.2
Requires-Dist: tree-sitter-kotlin==1.1.0
Requires-Dist: tree-sitter-swift==0.7.4
Requires-Dist: tree-sitter-scala==0.23.4
Requires-Dist: tinycss2>=1.2.1
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: pyflakes>=3.2.0

<div align="center">

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/hero.png" alt="aegis — Omniscience & Real-time Intelligent Operation Node" width="100%" />

<br />
<br />

[![PyPI Version](https://img.shields.io/badge/pypi-v1.0.3-232E7A?style=for-the-badge&logo=python&logoColor=white)](https://pypi.org/project/aegis-ai-suite/)
[![Wheel](https://img.shields.io/badge/wheel-universal%20py3--none--any-059669?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/aegis-ai-suite/#files)
[![Download Analytics](https://img.shields.io/badge/analytics-ClickPy%20%7C%20PePy-D97706?style=for-the-badge&logo=clickhouse&logoColor=white)](https://clickpy.clickhouse.com/dashboard/aegis-ai-suite)
[![Python](https://img.shields.io/badge/Python-3.11%20%7C%203.12%20%7C%203.13-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://pypi.org/project/aegis-ai-suite/)
[![Platform](https://img.shields.io/badge/OS-macOS%20%7C%20Windows%20%7C%20Linux-4F46E5?style=for-the-badge)](https://pypi.org/project/aegis-ai-suite/)
[![FastAPI](https://img.shields.io/badge/FastAPI-009688?style=for-the-badge&logo=fastapi&logoColor=white)](https://pypi.org/project/aegis-ai-suite/)
[![React](https://img.shields.io/badge/React-18-61DAFB?style=for-the-badge&logo=react&logoColor=black)](https://pypi.org/project/aegis-ai-suite/)
[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-pgvector-4169E1?style=for-the-badge&logo=postgresql&logoColor=white)](https://pypi.org/project/aegis-ai-suite/)
[![Local LLMs](https://img.shields.io/badge/Local%20LLMs-Ollama%20%7C%20vLLM-000000?style=for-the-badge&logo=ollama&logoColor=white)](https://pypi.org/project/aegis-ai-suite/)

### **aegis (`aegis-ai-suite`) — Omniscience & Real-time Intelligent Operation Node**
*Orchestrate Projects with Intelligent Agents — Multi-Agent · Domain-Aware · Human-Governed · Enterprise-Integrated · Outcome-Driven*

</div>

---

**aegis** connects your issue tracker (**Jira, Backlog, Redmine, GitHub, GitLab**), your Git repositories (**GitHub, GitLab, Bitbucket Cloud & Data Center**), and your AI models (**OpenAI, Anthropic Claude, Google Gemini, Groq, GitHub Copilot CLI, Claude Code, Codex, Aider, Jira Rovo, or 100% local Ollama / LM Studio**) in one unified workspace.

Click **Start Fix** on a ticket and a deterministic 8-stage pipeline of **13 Operational Agent Squads (120+ specialized agents)** prepares the branch, synthesizes failing TDD tests, implements the code change in an isolated Git worktree, runs real runtime/lint/security gates (**Semgrep, Trivy, Horusec**), and presents a unified diff for human approval before anything reaches your branch.

---

## ⚡ 30-Second Quick Install & Launch (macOS · Windows CMD · Linux)

Install the single cross-platform Python package and launch the entire suite from your terminal:

```bash
# 1. Install the universal Python package from PyPI
pip install aegis-ai-suite

# 2. Launch Core CRM + Backend + Local Companion Agent + Standalone Chat
aegis-ai
# (or `aegis-crm`)

# 3. Or launch the dedicated Standalone Companion Chat directly
aegis-chat
```

### Included Applications & Default Ports

| Application | CLI Command | Default URL | What It Runs |
| :--- | :--- | :--- | :--- |
| **aegis Core CRM & Full Enterprise Suite** | `aegis-ai` / `aegis-crm` | `http://localhost:8020` | Full 13-Squad Multi-Agent CRM, Upstream AI Studio, Project Control Tower, Browser IDE, QA & Testing Center, 33 Built-in Reports, and Admin Governance |
| **Standalone Companion Chat** | `aegis-chat` | `http://localhost:5185` | Distraction-free chat-first engineering desktop UI powered by **Aegis Pinky** (Rapid) & **Aegis Brain** (Deep Reasoning) with live tool streams and inline Git worktree diffs |
| **Local Companion Agent** | *(Auto-started)* | `http://localhost:47771` | Host-level Git worktree sandbox manager, AST code-graph engine, Playwright visual QA runner, and coding CLI bridge |

### CLI Options (`aegis-ai` / `aegis-workspace`)

```bash
aegis-ai                                   # Start Core CRM (:8020), Companion Chat (:5185) & Agent (:47771)
aegis-chat                                 # Start & open Standalone Companion Chat (:5185)
aegis-ai --both                            # Open both Core CRM and Standalone Companion Chat in browser tabs
aegis-ai --no-browser                      # Run all servers headlessly without opening a browser window
aegis-ai --port 8020 --chat-port 5185      # Customize Core CRM, Chat, or Agent (--agent-port 47771) ports
aegis-ai --docker-db                       # Auto-start PostgreSQL 16 + pgvector in Docker & apply 120+ SQL files
aegis-ai --setup-db --db-url "postgresql://user:pass@localhost:5432/aegis"  # Initialize any PostgreSQL DB
aegis-ai --update aegis-ai-suite           # Self-update to the latest release via pip
```

### 🗄️ How Database Setup Works (3 Flexible Modes)

1. **Mode 1 — Instant Zero-Config Mode (Default Out-of-the-Box):**  
   Just run `aegis-ai`. If PostgreSQL is not configured yet, aegis **automatically creates a local embedded database** at `~/.nilswa-workspace-crm/data/devops.db`, seeds the default `Demo Workspace`, `IT Admin` role, and Admin account, and starts immediately!
2. **Mode 2 — 1-Command Docker PostgreSQL 16 + `pgvector` (`--docker-db`):**  
   Have Docker running? Run one command and aegis automatically starts a `pgvector/pgvector:pg16` container, enables `vector` + `pg_trgm`, applies all **120+ bundled SQL schema, Row-Level Security (RLS), and 143 AI Agent seed files**, and saves `DATABASE_URL` in `~/.nilswa-workspace-crm/settings.json`:
   ```bash
   aegis-ai --docker-db
   ```
3. **Mode 3 — Bring Your Own PostgreSQL (Local / AWS RDS / Supabase / Neon):**  
   Point `aegis-ai` at any existing PostgreSQL 16+ database to initialize the full schema and persist the connection URL:
   ```bash
   aegis-ai --setup-db --db-url "postgresql://postgres:password@localhost:5432/aegis"
   ```

---

## 📊 Platform Scale at a Glance

| Metric | Scale | Scope |
| :--- | :---: | :--- |
| **Native Integrations** | **15+** | Jira, Backlog, Redmine, Confluence, GitHub, GitLab, Bitbucket, MS Teams, Slack, Outlook/M365, Entra ID, MCP & Cloud/Local LLMs |
| **Operational Squads** | **13** | L1–L6 corporate engineering hierarchy with dedicated Squad Managers & Directors |
| **Autonomous Agents** | **120+** | Specialized domain personas equipped with 107 real repository & workspace tools |
| **Software Factory Stages** | **8** | Deterministic quality gates from Spec Analysis & Red-State TDD to Security Audit & Merge |
| **Built-in Reports** | **33+** | Google TimesFM Predictive Forecasting, Cross-Tracker Analytics, AI Summarization & Dynamic Builder |
| **Real Security Scanners** | **3+** | Semgrep SAST, Trivy CVE/SCA, Horusec Secret Detection, Gitleaks & Bandit on every change |
| **Interface Languages** | **31** | Full i18n localization across English, Japanese (`日本語`), Chinese, Korean, Indic, European & RTL languages |

---

## ✨ Core Capabilities & Product Studios

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/features.png" alt="Coding Assistant, Testing Assistant, Manager Assistant, Report Engine and Integrations" width="100%" />

### 1. 🏛️ Upstream AI Enablement & Solution Studio (For BAs, PMs & Architects)
Six dedicated upstream workspaces turn raw stakeholder workshops and business briefs into production-ready specifications:
- **Meeting Minutes & Consensus Synthesizer:** Converts raw transcripts into action items, architectural decisions, and Jira / Backlog / Redmine tickets.
- **Requirements & BRD/BDD Structurer:** Generates Functional Requirements (`機能要件`), Non-Functional Requirements (`非機能要件`), Gherkin scenarios, and ambiguity alerts.
- **WBS & Man-Month Estimator:** Computes Function Points, Story Points, and P10/P50/P90 Person-Days (`人日`) & Man-Months (`人月`) with role-based cost projections.
- **Design Document Guardian:** Audits Basic Design (`基本設計`) and Detailed Design (`詳細設計`) for requirement traceability, concurrency, and SLA gaps.
- **Client Playback & Wireframe Prototype Generator:** Builds interactive screen flows and records stakeholder sign-offs before coding starts.
- **UAT Acceptance Evidence Pack & Partner Survey Builder:** Exports traceability matrices and RFP/vendor evaluation surveys to CSV/Excel.

### 2. 🧑‍💻 Polyglot Coding Assistant & DevMate (For Developers)
- **One-Click `Start Fix` Delivery Workflow:** Branch → Plan → Red-State TDD → AST Implementation → Runtime Tests → Security Gate → Adversarial Diff Review → Human Approval → Commit & Tracker Sync.
- **DevMate Developer Companion:** Pre-plans assigned tickets, heals failing tests and CI runs inside an isolated Git worktree, reviews local changes, and dry-runs pull requests.
- **Fix from a Screenshot (Visual Bug-to-Code):** Upload images, GIFs, or screen recordings — aegis extracts keyframes, runs English/Japanese OCR, maps the UI back to the exact source files, and proposes a verified fix.
- **Bring Your Own Coding CLI or Local LLM:** Run tasks through **GitHub Copilot CLI, Claude Code, OpenAI Codex, Google Antigravity, Aider, or Jira Rovo**, or run **100% offline/air-gapped** with **Ollama, LM Studio, vLLM, or llama.cpp**.
- **Living Code Graph & AI Code Guardian:** Answer *"What breaks if I change this symbol?"* across callers, API routes, SQL tables, and tests, plus generate 10 comprehensive repository health & security reports.
- **Browser IDE + Native IDE Extensions:** Built-in Monaco editor, Git staging tree, and PTY terminal in the browser, alongside **VS Code / Cursor, JetBrains, and Eclipse** extensions.

### 3. 🧪 QA & Testing Center (For QA Engineers & SDETs)
- **AI Test Case Generator Studio (BRD / HLD / LLD / Design Docs):** Upload a BRD, High-Level Design (HLD), Low-Level Design (LLD), UI/UX Design Document (PDF, DOCX, PPTX, MD, OpenAPI), or verbal write-up. Select your AI Model, QA Specialist Agent, and Domain Skills to synthesize **8-vector test suites** (Positive, Negative, Boundary, E2E Browser, API, Security, WCAG Accessibility, Performance).
- **Right-Side Live Test Specification Preview:** Inspect the generated Requirement Traceability Matrix, edit test steps inline, and export Markdown specifications or import directly into project test suites.
- **8 One-Click Ticket QA Actions:** *Analyze Issue, Generate Test Cases, Generate Test Data, Assess Blast Radius, Audit AC & BDD, Check History & Logs, Scaffold Tests, and Verify Coverage*.
- **Runnable Test Scaffolding & Visual Self-Healing Recorder:** Generate executable **Playwright (Python), PyTest, or Postman v2.1** suites, record browser flows across ~30 step types with Set-of-Mark visual AI selector self-healing, and generate PII-safe synthetic test data (including Japanese full-width / kana edge cases).

### 4. 🤝 Always-On Companions Mode, Standalone Chat (`:5185`) & Voice Director
- **Standalone Companion Chat (`aegis-chat` on `:5185`):** Dedicated chat-first engineering app featuring the **2×2 Aegis Execution Matrix** — **Aegis Pinky** (Rapid Execution) and **Aegis Brain** (Deep Multi-File Reasoning), live tool-call telemetry, and dirty-worktree resolution (*Commit, Stash, or Clean*).
- **Strategy Co-Pilot Manager Sentinel:** Watches PR review bottlenecks, multi-sprint blockers, and SLA breach horizons; synthesizes daily async standups and weekly executive digests to Teams, Slack, or Outlook.
- **Aegis Voice Director (`/aegis`):** Local neural speech-to-text (**faster-whisper**) and text-to-speech (**Gradium Phonon 31M**) for hands-free spoken workspace briefings and voice command orchestration.

---

## 🏢 The 13 Operational AI Agent Squads (120+ Specialized Personas)

| # | Operational Squad | Squad Leader Persona | Hierarchy | Primary SDLC Stage & Deliverables |
| :-: | :--- | :--- | :---: | :--- |
| **1** | **Testing & QA Squad** (10 agents) | Test Operations Director Agent | L5 Director | **Stages 3, 6 & 7:** BRD/HLD/LLD 8-vector test synthesis, Red-State TDD, Playwright E2E & flaky test RCA |
| **2** | **Polyglot Coding Squad** (12 agents) | Chief Software Architect Agent | L4 Principal | **Stages 3–4:** Syntax-gated AST patches across Python, Java, C#, TypeScript/React, Go & SQL in isolated worktrees |
| **3** | **Code Review & Governance Squad** (9 agents) | Code Review Squad Manager Agent | L6 Director | **Stages 5–6:** Semgrep SAST, Trivy CVE, Horusec secrets, cyclomatic complexity audit & adversarial PR review |
| **4** | **Ticket Management & Intake Squad** (8 agents) | Ticket Squad Manager Agent | L6 Director | **Stage 1:** Jira/Backlog/Redmine/GitHub intake triage, attachment OCR, INVEST validation & subtask breakdown |
| **5** | **L1/L2 Support & Incident Squad** (9 agents) | Director Support & Reliability Agent | L5 Director | **24/7 Triage:** Stack-trace-to-commit RCA isolation, supervised rollback runbooks & post-mortem synthesis |
| **6** | **Agile Ceremonies & Status Squad** (8 agents) | Scrum Master Agent | L3 Lead | **Continuous DORA:** Async daily standups, Google TimesFM velocity forecasting & reviewer load balancing |
| **7** | **ETL & Data Warehouse Squad** (9 agents) | Chief Data Architect Agent | L4 Principal | **Data Engineering:** Kimball/Inmon star schemas, dbt/SQLMesh DAGs, column-level lineage & schema drift guards |
| **8** | **Snowflake & DB Modernization Squad** (8 agents) | Lead Snowflake DBA Agent | L3 Lead | **DB Modernization:** Cross-dialect SQL transpilation (Oracle/SQL Server/Teradata → Snowflake) & FinOps tuning |
| **9** | **Cloud Delivery & DevOps Squad** (10 agents) | Cloud Delivery Squad Manager Agent | L6 Director | **Stage 8:** Multi-cloud IaC (AWS/GCP/Azure), Docker/K8s manifests, blue-green/canary rollouts & squash merges |
| **10** | **Travel & Airline Domain BA Squad** (9 agents) | Principal Travel Domain Expert Agent | L3 Senior BA | **Stages 1–2:** Aviation FAR 117 crew legality, PNR lifecycle, IATA NDC / ONE Order, MRO & loyalty rule audits |
| **11** | **Workspace Delivery Automation Squad** (9 agents) | Workspace Governance Manager Agent | L6 Architect | **Git Hygiene:** Ephemeral worktree orchestration, dirty-tree resolution, monorepo guards & contract drift checks |
| **12** | **SRE & Production Ops Squad** (10 agents) | Incident Operations Squad Manager | L6 Director | **Closed-Loop SRE:** CloudWatch/Prometheus anomaly correlation & automated hotfix dispatch to Squads 2 & 3 |
| **13** | **Product Management & Solution Squad** (10 agents) | Product Management Squad Manager | L6 Director | **Pre-Dev Studio:** Idea-to-Epic/Story/Subtask synthesis, Hexagonal blueprints, DDL design & WBS cost estimates |

---

## 📈 33 Built-In Reports, TimesFM Forecasting & Enterprise Integrations

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/reports.png" alt="33 built-in reports: TimesFM Predictive, Cross-Tracker, General Analytics and AI Summarization" width="100%" />

<br />
<br />

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/integrations.png" alt="Integrations: Jira, Backlog, Redmine, GitHub, GitLab, Bitbucket, Teams, Slack, Outlook, Entra ID, Confluence, MCP and AI model providers" width="100%" />

---

## 📸 Product Screen Gallery

<table>
  <tr>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/project-details.jpg" alt="Project Details & Control Tower" /><br />
      <b>Project Details & Control Tower</b><br />
      <sub>Unified Jira/Backlog/Redmine tickets with one-click Start Fix and 8-action AI Assistant</sub>
    </td>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/project-ai-assistant.jpg" alt="AI Ticket Assistant" /><br />
      <b>AI Ticket Assistant</b><br />
      <sub>Analyze Issue, Generate Tests, Blast Radius, BDD Audit & Scaffold Tests on any issue</sub>
    </td>
  </tr>
  <tr>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/workflow-studio.jpg" alt="Visual Multi-Agent Workflow Studio" /><br />
      <b>Visual Multi-Agent Workflow Studio</b><br />
      <sub>8-stage deterministic delivery pipelines edited on an interactive React Flow canvas</sub>
    </td>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/testing-center.jpg" alt="QA & Testing Center" /><br />
      <b>QA & Testing Center</b><br />
      <sub>BRD/HLD/LLD AI Test Generator, live right-side spec preview, Playwright runner & traceability</sub>
    </td>
  </tr>
  <tr>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/reports-analytics.jpg" alt="Reports & TimesFM Predictive Analytics" /><br />
      <b>Reports & TimesFM Predictive Analytics</b><br />
      <sub>33 built-in reports across TimesFM velocity forecasting, cross-tracker SLA & AI summaries</sub>
    </td>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/standalone-chat.jpg" alt="Standalone Companion Chat (:5185)" /><br />
      <b>Standalone Companion Chat (<code>aegis-chat</code>)</b><br />
      <sub>Chat-first coding with Aegis Pinky & Aegis Brain, live tool streams & inline Git worktree diffs</sub>
    </td>
  </tr>
  <tr>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/companion-inbox.jpg" alt="Companion Inbox — DevMate & Strategy Co-Pilot" /><br />
      <b>Companion Inbox (DevMate & Strategy Co-Pilot)</b><br />
      <sub>Always-on background branch preparation, CI healing, standups & human approval queue</sub>
    </td>
    <td width="50%" align="center">
      <img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/ai-models.jpg" alt="AI Model Governance & Local LLM Registry" /><br />
      <b>AI Model Governance & Local LLM Registry</b><br />
      <sub>Cloud LLMs, Ollama/LM Studio local models, Copilot/Rovo CLIs & token budget guardrails</sub>
    </td>
  </tr>
</table>

---

## 🏗️ System Architecture & 8-Stage Deterministic Pipeline

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/architecture.png" alt="aegis System Architecture" width="100%" />

<br />
<br />

<img src="https://raw.githubusercontent.com/sachin-bose-p/sachin-bose-p/main/assets/aegis/flow.png" alt="8-Stage Deterministic Software Factory Pipeline" width="100%" />

### Real Pipeline Quality Gates (Zero Simulation)

Every agent run executes inside an isolated Git worktree (`~/.nilswa-workspace-agent/worktrees/`) and must clear four deterministic gates before human merge approval:

| Gate | Tools Executed by Local Companion Agent | Blocking Policy |
| :--- | :--- | :--- |
| **1. Runtime Gate** | Auto-detected project suites: `pytest`, `npm test` / `jest` / `vitest`, `go test`, `dotnet test`, `cargo test`, `mvn test`, `gradle test` | Blocks on any failing test suite (*"No tests found"* is marked skipped, never falsely passed) |
| **2. Lint & Type Gate** | `ruff`, `mypy`, `eslint`, `prettier`, `sqlfluff` & AST syntax parser | Blocks on syntax/parse errors and `mypy` type errors |
| **3. Security Gate** | `gitleaks`, `semgrep`, `trivy`, `bandit`, `pip-audit`, `npm audit` + built-in secret/sink scanner | Blocks on any finding at or above `AEGIS_SECURITY_FAIL_ON` (default `high`) in modified files |
| **4. Integration Gate** | Real Git commit inside the isolated worktree + Human-in-the-Loop approval packet | Refuses commit if Runtime or Security gate failed |

---

## 🛠️ Technology Stack

| Layer | Technologies |
| :--- | :--- |
| **Frontend Applications** | React 18, Vite, Tailwind CSS, Monaco Editor, xterm.js, Recharts, React Flow, 31-Language i18n |
| **Backend & Orchestration** | Python 3.11–3.13, FastAPI, SQLAlchemy 2.0, LangChain, LangGraph, PostgreSQL Checkpointer, MCP Server/Client |
| **Data & Vector Engine** | PostgreSQL 16+ with `pgvector` & `pg_trgm` (Row-Level Security) + automatic local JSON store fallback |
| **Local Companion Agent** | FastAPI host daemon (`:47771`), Git worktree isolator, Tree-sitter polyglot AST engine (12 languages), Playwright Chromium |
| **AI & Local Intelligence** | Sentence-Transformers + Cross-Encoder Reranker (RAG), `faster-whisper` (STT), Gradium Phonon 31M (TTS), Google TimesFM, Tesseract OCR (EN/JA) |

---

## 📄 Author & License

- **Creator & Principal Architect:** Sachin Bose Pulikkathara (<sachin.bose.p@gmail.com>)
- **GitHub:** [https://github.com/sachin-bose-p](https://github.com/sachin-bose-p)
- **LinkedIn:** [https://www.linkedin.com/in/sachin-bose-p/](https://www.linkedin.com/in/sachin-bose-p/)
- **License:** Open Commercial & Internal Use (see root `LICENSE`).
