MARKETING-LOG.txt

# PythonBox — Local Repository & Discoverability Audit Log

**Target Repository:** `dev-bricks/pythonbox`  
**Host:** ASUS-GEI  
**Date:** 2026-09-18  
**Audit Path:** Pfad A (Technische Hygiene, CI-Härtung, PEP 621 Standardisierung, SBOM & Vertragstests)  
**Version:** 1.0.1  
**Lead Framework:** Antigravity / Gemini 3.8 Flash (High)  

---

## 1. Target Personas

- **[PERSONA-01] Lightweight Windows Python Scripter:**
  - *Profile:* Developer or sysadmin writing Python automation scripts on Windows who finds full heavyweight IDEs (VS Code with dozens of extensions, PyCharm) too slow to launch or memory-heavy.
  - *Needs:* Sub-second startup, syntax highlighting, code folding, instant minimap, and reliable local execution without electron bloat.

- **[PERSONA-02] Air-Gapped & High-Compliance Developer:**
  - *Profile:* Engineer working in restricted, regulated, or air-gapped enterprise environments where telemetry, network phone-home, or unvetted cloud extensions are strictly prohibited.
  - *Needs:* 100% offline runtime, verifiable SBOM (LGPL-3.0 dynamic linking / MIT), zero data egress, and unprivileged `RunAsInvoker` execution.

- **[PERSONA-03] Educator, Student & Algorithmic Learner:**
  - *Profile:* Teacher or learner requiring an intuitive, distraction-free environment to understand execution flow, step through code with an interactive PDB debugger, and manage bilingual interfaces (DE/EN).
  - *Needs:* Integrated visual debugger, line-by-line stepping, variable inspection, AST-based linting feedback, and clear code navigation.

- **[PERSONA-04] DevOps & CI/CD Pipeline Engineer:**
  - *Profile:* Automation specialist running batch smoke tests and static linter checks directly against Python scripts.
  - *Needs:* Headless CLI flags (`--run <file>`, `--lint <file>`) for unattended verification, return codes conforming to standard CI tooling.

---

## 2. Competitive & Architectural Matrix

| Dimension | IDLE (Standard Python) | VS Code (+ Python Ext.) | PyCharm Community | PythonBox v1.0.1 |
|---|---|---|---|---|
| **Startup Latency** | Fast (~1.0s) | Moderate (3-8s) | Heavy (8-25s) | **Fast (<1.2s)** |
| **Memory Footprint** | ~50 MB | 250 MB - 1.2 GB | 800 MB - 2.5 GB | **~85 MB** |
| **100% Offline-First** | Yes | Partial (cloud extensions) | Partial (updates, plugins) | **Yes (100% Offline)** |
| **Zero Telemetry** | Yes | Requires opt-out | Requires opt-out | **Guaranteed by design** |
| **Interactive PDB Panel** | Basic shell | Complex DAP | Dedicated engine | **Built-in docked PDB** |
| **Built-in AST/Flake8/Pylint** | No | Via extensions | Built-in | **Built-in Dock & CLI** |
| **Headless CLI Run/Lint** | No | No | No | **Yes (`--run`, `--lint`)** |
| **Git Status & Diff** | No | Built-in | Built-in | **Built-in Git Inspector** |
| **Unprivileged Mode** | Yes | Yes | Yes | **RunAsInvoker** |

---

## 3. Invariants & Contract Testing Compliance

- All 10 core invariants (`INV-LOCAL-01` through `INV-SLA-10`) documented in `THIRD_PARTY_LICENSES.md` verified.
- PEP 621 metadata registered in `pyproject.toml`.
- CI workflows in `.github/workflows/` hardened with concurrency groups and timeouts.
- Bilingual documentation and legal disclaimers (§ 521 BGB) synchronized.

---

## 4. Pfad B Marketing & Discoverability Audit (2026-09-22)

- **Auditor / Host:** Antigravity@ASUS-GEI / Gemini 3.8 Flash (High)
- **Status:** PASS (Full 20/20 topics saturation, bilingual 18-point navigation parity, dual Mermaid architecture)
- **Topics:** Saturated 20/20 on GitHub (`zero-egress` added) and synchronized with `pyproject.toml` keywords.
- **Visuals & Diagrams:** Dual Mermaid diagrams verified via `lint_mermaid.py` (0 syntax issues):
  - Topology Flowchart (`flowchart TD`)
  - Execution & PDB Debugging Lifecycle (`sequenceDiagram` with autonumber, 0 unquoted semicolons)
- **Legal & Governance:** Canonical root `NOTICE` file established; Level 1 SBOM verified in `THIRD_PARTY_LICENSES.md`; unprivileged `RunAsInvoker` certified; German statutory notice (§ 521 BGB Gefälligkeitsrecht) and 48-hour response SLA harmonized across README, README_de, and SECURITY.md.
- **Contract Tests:** Verified 121+ tests green in automated pytest suite.