Metadata-Version: 2.4
Name: it-solutions-suite
Version: 1.0.0
Summary: Autonomous Corporate Enterprise Suite: CorePulse + NexusShield + EchoStream
Home-page: https://github.com/itsolutions-corp/it-solutions-suite
Author: IT Solutions Global Corporation
Author-email: IT Solutions Global Corporation <engineering@itsolutions.corp>
License-Expression: MIT
Project-URL: Homepage, https://github.com/itsolutions-corp/it-solutions-suite
Project-URL: Repository, https://github.com/itsolutions-corp/it-solutions-suite
Keywords: productivity,executive-cockpit,security-scanner,sast,speech-perception,dlp,omnibar,workflow-automation
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Office/Business
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# IT Solutions Global Corporate Triad
### Autonomous Executive Life OS, Code Security & Speech Perception Engine
*Engineered in 100% Pure Python Standard Library • Zero External Dependencies • 100% Local-First Privacy*

---

[![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20(Pure%20Python%20stdlib)-8b5cf6?style=for-the-badge&logo=python&logoColor=white)](https://github.com/itsolutions-corp/enterprise-suite)
[![Python Version](https://img.shields.io/badge/Python-3.8%2B-38bdf8?style=for-the-badge&logo=python&logoColor=white)](https://github.com/itsolutions-corp/enterprise-suite)
[![Tests Passing](https://img.shields.io/badge/Tests-94%2F94%20Passing-22c55e?style=for-the-badge&logo=checkmarx&logoColor=white)](https://github.com/itsolutions-corp/enterprise-suite)
[![License MIT](https://img.shields.io/badge/License-MIT-amber?style=for-the-badge)](LICENSE)
[![Security Audited](https://img.shields.io/badge/Security-Audited%20%26%20Zero--Leak-00f2fe?style=for-the-badge&logo=shield&logoColor=white)](https://github.com/itsolutions-corp/enterprise-suite)
[![Architecture](https://img.shields.io/badge/Architecture-100%25%20Local--First-f43f5e?style=for-the-badge&logo=lock&logoColor=white)](https://github.com/itsolutions-corp/enterprise-suite)

---

```
  ___ _____   ____   ___  _    _   _ _____ ___ ___  _   _ ____  
 |_ _|_   _| / ___| / _ \| |  | | | |_   _|_ _/ _ \| \ | / ___| 
  | |  | |   \___ \| | | | |  | | | | | |  | | | | |  \| \___ \ 
  | |  | |    ___) | |_| | |__| |_| | | |  | | |_| | |\  |___) |
 |___| |_|   |____/ \___/|_____\___/  |_| |___\___/|_| \_|____/ 
                                                                
     ====================================================
      THE CORPORATE TRIAD: ACTION • DEFENSE • PERCEPTION
     ====================================================
```

> **Company Motto**: *"Serve humanity by solving real problems with uncompromising utility; earn deep trust and habituation before asking for reward."*

---

## ⚡ What is the Corporate Triad?

Modern knowledge workers and engineering teams lose over **40% of their productive day** to cognitive fragmentation: context switching between disjointed apps, manual terminal drudgery, meeting note-taking anxiety, and the constant fear of accidental API key leaks.

The **Corporate Triad** unifies your daily digital workflow into a single, cohesive, local-first operating system powered entirely by Python's standard library:

```mermaid
graph TD
    subgraph Enterprise_Workstation ["The Autonomous Corporate Triad (Local-First)"]
        ES["EchoStream v1.0<br/><b>System of Perception</b><br/>• VoiceGuard Secret DLP<br/>• Drop Ingestion (data/transcripts/)<br/>• Sub-150ms Meeting Triage"]
        CP["CorePulse v1.0<br/><b>System of Action</b><br/>• Executive Glassmorphic Cockpit (:8080)<br/>• Desktop Omnibar (Ctrl+Shift+Space)<br/>• High-Throughput SQLite WAL Engine"]
        NS["NexusShield v1.0<br/><b>System of Defense</b><br/>• Shannon Entropy Scanner (H >= 4.5)<br/>• Offline CVE Dependency Auditor<br/>• Git Pre-Commit Quality Gate"]
    end

    Input["Spontaneous Thoughts & Audio"] --> Omni["Omnibar (Ctrl+Shift+Space)"]
    Input --> Drop["data/transcripts/ Drop"]
    Drop --> ES
    Omni --> CP
    ES -- "Auto-Staged Tasks" --> CP
    ES -- "Verbal Secret Redaction" --> NS
    CP -- "1-Click /scan Trigger" --> NS
    CP --> SQLite[("Local SQLite WAL Store")]
    NS --> SecurityAudit[("Local SAST & Secret Audit")]
```

1. **⚡ CorePulse v1.0 (Action)**: Desktop executive workspace cockpit, habit streak engine, 1-click workflow automation, and SQLite WAL persistence.
2. **🛡️ NexusShield v1.0 (Defense)**: High-entropy Shannon secret interceptor, offline dependency CVE auditor, and automated Git pre-commit enforcement.
3. **🎙️ EchoStream v1.0 (Perception)**: Speech transcript triage, VoiceGuard credential DLP redaction, and zero-click meeting ingestion.

---

## 🚀 60-Second Quickstart

No `pip install` requirements, no Docker containers, no node_modules, and zero network tracking. Runs on any computer with **Python 3.8+**.

### 1. Clone & Verify Suite
```bash
git clone https://github.com/itsolutions-corp/enterprise-suite.git
cd enterprise-suite
```

### 2. Launch CorePulse Executive Cockpit
```bash
# Launch via Unified Multi-Product CLI:
python products/cli.py pulse --port 8080

# Or via Platform Batch Script (Windows):
.\products\corepulse.bat
```
👉 Open your browser to: **`http://127.0.0.1:8080/`**

### 3. Run Instant Code Security Scan (NexusShield)
```bash
python products/cli.py shield scan . --fail-under 85
```

### 4. Test Zero-Click Meeting Ingestion (EchoStream)
```bash
python products/cli.py stream demo
```

---

## 🌟 Feature Showcase

### 1. Desktop Quick-Capture Omnibar (`Ctrl+Shift+Space`)
Summon an omnipresent floating input HUD in **<15ms** from any active window on your workstation. Capture spontaneous thoughts, strategic deliverables, or trigger security audits in under **800ms**:

```
[ Ctrl + Shift + Space ]  -->  "Deploy auth patch by 4 PM !p1 #security ~30m"
```
- **Shorthand Syntax**:
  - `!p1`, `!p2`, `!p3`, `!p4` $\rightarrow$ Priority mapping (Critical to Low).
  - `#engineering`, `#security`, `#client` $\rightarrow$ Dynamic category tags.
  - `~15m`, `~30m`, `~1h` $\rightarrow$ Automatic time duration estimates.
  - `/scan` or `!scan` $\rightarrow$ **1-Click Workspace Security Audit** without opening a terminal!

---

### 2. Ambient "Drop-and-Forget" Meeting Ingestion (`data/transcripts/`)
Never type meeting notes or action items manually again.

```
Zoom / Teams / Meet Transcript (.txt, .vtt, .json)
                       │
                       ▼
           [ data/transcripts/ ]
                       │
                       ▼  (Automatic Autonomous Ingestion)
      ┌────────────────────────────────┐
      │  VoiceGuard DLP Sanitization   │  <-- Intercepts exposed keys
      ├────────────────────────────────┤
      │  SemanticStreamParser Action   │  <-- Isolates deliverables & owners
      ├────────────────────────────────┤
      │  Direct CorePulse Task Stage   │  <-- Written to SQLite WAL Store
      └────────────────────────────────┘
```
- Drop any call transcript or voice memo into `data/transcripts/`.
- EchoStream sanitizes credentials with **VoiceGuard**, parses action items, and stages them directly into CorePulse with **zero clicks**—reclaiming **~45 minutes per call**.

---

### 3. NexusShield: Zero-Leak Code Security & SAST
Stop leaked AWS keys, OpenAI tokens, and vulnerable dependencies before they enter git history:
- **Shannon Entropy Detection**: $H(X) = -\sum P(x_i) \log_2 P(x_i) \ge 4.5$ mathematically detects arbitrary high-entropy secrets regardless of variable names.
- **Automated Safe Redaction**: Sensitive keys are masked in-memory (`sk-proj-ab...7890`).
- **Offline Dependency CVE Auditing**: Evaluates `requirements.txt` and `package.json` without leaking package manifests to external servers.
- **Git Pre-Commit Hook**: 1-line installation prevents accidental leaks:
  ```bash
  python products/cli.py shield scan . --fail-under 85
  ```

---

### 4. CorePulse Executive Cockpit & SQLite WAL Concurrency
- **Glassmorphic Dark-Mode Cockpit**: Responsive UI featuring live uptime heartbeat, habit flame badges, velocity metrics, and terminal execution audit logs.
- **Enterprise SQLite WAL Engine**: Employs `PRAGMA journal_mode=WAL` with sub-millisecond concurrent read/write throughput (benchmarked across 20+ simultaneous threads with 0 lock errors).
- **1-Click Workflow Automations**:
  - *Morning Focus Protocol*: Syncs calendars, compacts meeting fragmentation, mutes distractions, and spawns dev terminals (`25m saved`).
  - *Inbox Zero Triage*: Scans, classifies, auto-archives low-priority noise, and drafts VIP replies (`40m saved`).
  - *Deep Work Shield*: Engages distraction firewalls and Pomodoro acoustic soundscapes (`35m saved`).

---

## ⌨️ Universal Keyboard Cheatsheet

| Shortcut (Win / Linux) | Shortcut (macOS) | Action | Target System |
| :--- | :--- | :--- | :--- |
| **`Ctrl + Shift + Space`** | **`Cmd + Shift + Space`** | **Universal Quick-Capture Omnibar** | CorePulse / Omnibar |
| **`Ctrl + Space`** | **`Cmd + K`** | **Command Palette HUD** | CorePulse Cockpit |
| **`Alt + 1`** | **`Option + 1`** | Trigger: **Morning Focus Protocol** | CorePulse Workflows |
| **`Alt + 2`** | **`Option + 2`** | Trigger: **Inbox Zero Triage** | CorePulse Workflows |
| **`Alt + 3`** | **`Option + 3`** | Trigger: **Deep Work Distraction Shield**| CorePulse Workflows |
| **`Alt + 4`** | **`Option + 4`** | Trigger: **Weekly Velocity Audit** | CorePulse Workflows |
| **`Space`** | **`Space`** | Toggle habit completion / Increment streak | CorePulse Habits |
| **`Esc`** | **`Esc`** | Dismiss Omnibar or active modal | Global |

---

## 🧪 Comprehensive Verification & Test Suite

All 94 automated unit, integration, and concurrency tests pass with 100% success in under **3.5 seconds**:

```powershell
# Run full suite across all products
python -m unittest discover products/corepulse/tests -v
python -m unittest discover products/nexusshield/tests -v
python -m unittest discover products/echostream/tests -v
python -m unittest discover products/tests -v
```

```
======================================================================
TEST SUITE SUMMARY:
  • corepulse (API, WAL Concurrency, Omnibar, Security):  47 / 47 PASSED
  • nexusshield (Shannon Entropy, CVEs, Pre-Commit):      11 / 11 PASSED
  • echostream (VoiceGuard DLP, Semantic Parser, Drops):  25 / 25 PASSED
  • unified cli harness (Multi-product orchestration):    11 / 11 PASSED
TOTAL: 94 / 94 TESTS PASSED (100% Success Rate)
======================================================================
```

---

## 📁 Repository Directory Structure

```
it-solutions/
├── products/
│   ├── cli.py               # Unified multi-product CLI harness (it-solutions)
│   ├── corepulse/           # System of Action: Executive Life OS & Habit Engine
│   │   ├── corepulse/       # REST API, SQLite WAL, Workflows, Glassmorphic UI
│   │   └── tests/           # 47 unit & concurrency tests
│   ├── nexusshield/         # System of Defense: Local SAST & Secret Interceptor
│   │   ├── nexusshield/     # Entropy engine, CVE database, Scanner, Scorer
│   │   └── tests/           # 11 unit & regression tests
│   ├── echostream/          # System of Perception: Audio Triage & VoiceGuard
│   │   ├── echostream/      # VoiceGuard DLP, Semantic Parser, Ingestion Pipeline
│   │   └── tests/           # 25 unit & drop tests
│   └── tests/               # 11 CLI integration tests
├── data/
│   ├── transcripts/         # Drop-and-forget ingestion folder
│   └── corepulse.sqlite3    # Enterprise SQLite database in WAL mode
├── company/
│   ├── growth/              # GTM strategy, product docs, public launch kit
│   ├── product/             # Approved PRDs for CorePulse, NexusShield, EchoStream
│   └── reports/             # Permanent corporate memory & daily reports
└── README.md                # Global documentation & quickstart
```

---

## 🔒 Privacy & Zero-Cloud Telemetry Guarantee

Every product in this repository is built on a strict privacy pledge:
- **Zero Remote Telemetry**: No analytics beacons, no tracking pixels, no user tracking.
- **Local Compute Only**: Text parsing, secret detection, and habit tracking execute 100% on your machine.
- **Your Data Remains Yours**: Local SQLite database files (`corepulse.sqlite3`) stay strictly on your local disk.

---

## 📄 License

This enterprise suite is licensed under the **MIT License**. Free for individuals, developers, and organizations forever.

---
*Autonomous Enterprise Architecture by IT Solutions Global Corporation*
