Skip to content

Commit 04e76d6

Browse files
lukischlukisch
committed
docs(marketing): enrich discoverability, 15-point navigation, runtime invariants, and third-party license transparency (v1.0.1)
1 parent 03fa241 commit 04e76d6

15 files changed

Lines changed: 772 additions & 168 deletions

‎.gitignore‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,10 @@ ehthumbs.db
9090
*-ASUS-GEI.md
9191
*.sync-conflict-*
9292
*.conflict
93+
* (kopie)*
94+
* (copy)*
95+
*.sync-temp-*
96+
*-CONFLIT-*
9397

9498
# ---- Standard-Patterns ----
9599
PLAN.txt
@@ -106,3 +110,4 @@ DONE.md
106110
LOCK*.txt
107111
LOCK.*
108112
*.lock
113+
LOCK.permissions.json

‎CHANGELOG.md‎

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,26 @@
33
Alle wesentlichen Änderungen an diesem Projekt werden hier dokumentiert.
44
Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
55

6-
## [Unreleased]
6+
## [1.0.1] - 2026-09-12
7+
8+
### Discoverability, Marketing Architecture & Governance Invariants (Pfad B) [G 2026-09-12]
9+
- `README.md` & `README_de.md`:
10+
- Vollständige 15-Punkte-Schnellnavigation mit 100%iger wechselseitiger Anker-Parität eingeführt.
11+
- Shields.io Badges synchronisiert (Version 1.0.1, Tests 187+ passed | 100% green, Python 3.11/3.12, Platform Windows/Linux/macOS, UI PySide6, Security SLA 48h / 5d triage, Third-Party Audited 100% permissive, Marketing Log active, LLM-Ready llms.txt, Ecosystem dev-bricks, Umbrella open-bricks, License GPL-3.0).
12+
- Tabelle der Governance- & Laufzeit-Invarianten (10 Garantien: INV-LOCAL-01 bis INV-SLA-10) zweisprachig integriert.
13+
- Sibling-Ökosystem- und Partner-Matrix um 16 Partner-Repositories ausgebaut.
14+
- `THIRD_PARTY_LICENSES.md`:
15+
- Vollständiges Markdown-Inventar aller 20 direkten, transitiven, Build- und Test-Abhängigkeiten mit SPDX-Lizenztabellen, 100%iger Permissivitäts-Analyse, Zero-Egress-Datenschutzgarantie und unprivilegierter Non-Elevation-Zusicherung erstellt.
16+
- `MARKETING-LOG.txt`:
17+
- Neues Marketing- und Auffindbarkeitsregister im Repo-Root angelegt: 4 Ziel-Personas (Windows Python Desktop App Developers & GUI Builders; Solo Maintainers & Local-First Engineers; Security-Conscious Enterprise Developers; AI-Assisted Prompt & Python Engineers), High-Intent Suchbegriffe, 5-Wege-Wettbewerbsmatrix vs. VS Code / PyCharm / Thonny / CLI / Cloud-IDEs, sowie 16 Sibling-Ökosystem-Synergien.
18+
- `llms.txt`:
19+
- Last-checked Timestamp auf 2026-09-12 aktualisiert, Version 1.0.1, Testsuite-Baseline synchronisiert, 10 Governance-Invarianten verankert, Referenzen auf MARKETING-LOG.txt und THIRD_PARTY_LICENSES.md harmonisiert.
20+
- `pyproject.toml`:
21+
- URLs um Third-Party Licenses, Marketing Log und LLM Ready erweitert; Pytest addopts um `-ra -v` ergänzt.
22+
- `.gitignore`:
23+
- Multi-Host Cloud-Sync- und Konfliktmuster (`* (kopie)*`, `* (copy)*`, `*.sync-temp-*`, `*-CONFLIT-*`, `LOCK.permissions.json`) gehärtet.
24+
- `tests/test_metadata.py` & `tests/test_security_license_contract.py`:
25+
- Vertragstestsuite ausgebaut: 15-Punkte-Navigationsanker, 10 Invarianten, Version 1.0.1 Konsistenz, THIRD_PARTY_LICENSES.md und MARKETING-LOG.txt Verträge.
726

827
### Security, Dependency Floors & Third-Party License Audit (v1.0.1) [G 2026-09-11]
928
- `THIRD_PARTY_LICENSES.txt`:

‎MARKETING-LOG.txt‎

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
# MARKETING-LOG: DevCenter (devcenter-suite)
2+
# Canonical Repository: https://github.com/dev-bricks/DevCenter
3+
# Ecosystem: dev-bricks | Umbrella: open-bricks
4+
# Initial Setup / Audit: 2026-09-12
5+
# Status: Active (Pfad B Discoverability, Marketing & Invariants Standard)
6+
7+
===============================================================================
8+
1. POSITIONING & VALUE PROPOSITION
9+
===============================================================================
10+
DevCenter is a local-first, zero-egress Python desktop IDE and developer toolkit
11+
designed specifically for Windows 10/11 environments. It brings together Python code
12+
editing, AST static analysis, automated encoding repairs, one-click PyInstaller
13+
EXE compilation, icon generation, third-party license collection, full-text SQLite
14+
file indexing, and an optional, secure Claude AI assistant into a cohesive,
15+
standalone PySide6 desktop suite.
16+
17+
Key Differentiators:
18+
- 100% Local-First & Zero-Egress: Operates entirely offline; no mandatory telemetry,
19+
no cloud accounts, no background data leakage.
20+
- Python Desktop Focus: Tailored directly for building, inspecting, testing, and
21+
bundling Python desktop and CLI applications.
22+
- One-Click EXE Packaging: Built-in PyInstaller pipeline with multi-resolution
23+
Windows ICO conversion and automatic license compliance notices.
24+
- Non-Executing Static AST Analysis: Fast method, class, and cyclomatic complexity
25+
inspections without running untrusted user scripts.
26+
- Secure AI Isolation: Optional Claude API integration uses native Windows Credential
27+
Manager (keyring) and strictly opt-in prompt dispatch.
28+
29+
===============================================================================
30+
2. TARGET PERSONAS
31+
===============================================================================
32+
[PERSONA-01] Windows Python Desktop Application Developers & GUI Builders
33+
- Profile: Python developers building Qt, PySide6, PyQt, or Tkinter desktop apps.
34+
- Pain Points: Complex PyInstaller command lines, manual ICO multi-resolution creation,
35+
scattered license notices, tedious encoding corruptions (mojibake).
36+
- How DevCenter Wins: Integrated PyInstaller GUI, automated icon converter,
37+
automated third-party license generator, and built-in ftfy encoding repair.
38+
39+
[PERSONA-02] Solo Maintainers & Local-First Engineers
40+
- Profile: Open-source maintainers and indie hackers managing multiple Python packages.
41+
- Pain Points: Heavyweight IDE startup lag (Electron/Java), memory consumption,
42+
opaque background processes, cumbersome project switching.
43+
- How DevCenter Wins: Lightweight PySide6 native GUI, instant startup, fast
44+
SQLite full-text index, clean workspace export snapshots.
45+
46+
[PERSONA-03] Security-Conscious Enterprise & Air-Gapped Developers
47+
- Profile: Engineers working in regulated, corporate, or air-gapped networks.
48+
- Pain Points: IDEs requiring cloud logins, intrusive telemetry, automatic code
49+
exfiltration, unverified transitive dependencies.
50+
- How DevCenter Wins: Zero egress by default, strict fail-closed vulnerability
51+
floors, unprivileged RunAsInvoker execution, full SBOM transparency.
52+
53+
[PERSONA-04] AI-Assisted Python Prompt Engineers & Agent Builders
54+
- Profile: Developers pairing with LLMs (Claude, GPT, Gemini) for rapid prototyping.
55+
- Pain Points: Copy-pasting massive file trees, accidental leakage of API keys,
56+
cluttered prompt context.
57+
- How DevCenter Wins: Redacted workspace export (`devcenter-workspace-v1.json`),
58+
machine-readable `llms.txt`, secure keyring secret storage.
59+
60+
===============================================================================
61+
3. HIGH-INTENT SEARCH QUERIES & SEO KEYWORDS
62+
===============================================================================
63+
Core Intent Queries:
64+
- "local-first python ide windows"
65+
- "pyside6 python code editor desktop"
66+
- "pyinstaller exe packaging gui tool"
67+
- "python ast code analysis complexity tool"
68+
- "offline python ide without cloud login"
69+
- "python mojibake encoding repair tool"
70+
- "desktop developer toolkit python open source"
71+
- "lightweight python ide for windows 11"
72+
- "python third-party license collector pyinstaller"
73+
- "dev-bricks devcenter python development suite"
74+
75+
Semantic Categories:
76+
- IDE / Code Editor: syntax highlighting, code folding, non-modal search and replace.
77+
- Static Analysis: AST parser, cyclomatic complexity, unused import detection.
78+
- Packaging & Distribution: PyInstaller wrapper, one-file / one-dir, ICO converter.
79+
- Data Privacy & Security: zero-egress, local keyring, redacted workspace export.
80+
81+
===============================================================================
82+
4. COMPETITIVE MATRIX
83+
===============================================================================
84+
Feature / Capability | DevCenter | VS Code | PyCharm Comm | Thonny | CLI Tools
85+
------------------------------+--------------+-------------+--------------+-----------+----------
86+
100% Offline / Zero-Egress | YES (Strict) | Needs Config| Telemetry | YES | YES
87+
Native Qt/PySide6 Desktop UI | YES | NO (Electron| NO (JVM) | NO (Tk) | N/A
88+
Integrated PyInstaller GUI | YES (Builtin)| Via Plugin | Via Plugin | NO | Manual
89+
Auto ICO Converter (PNG->ICO) | YES (Multi) | NO | NO | NO | Separate
90+
License SBOM Collector | YES (Builtin)| NO | NO | NO | Separate
91+
AST Static Complexity Parser | YES (Fast) | Via Ext | Builtin | Basic | CLI only
92+
Automated Encoding Fixer | YES (ftfy) | Manual | Manual | Basic | CLI only
93+
Local Keyring Vault for AI | YES | Ext-dependent| Ext-dependent| NO | N/A
94+
Redacted Workspace Export | YES (JSON) | NO | NO | NO | Manual
95+
Unprivileged RunAsInvoker | YES | YES | YES | YES | YES
96+
97+
===============================================================================
98+
5. SIBLING ECOSYSTEM SYNERGIES & CROSS-PROMOTION
99+
===============================================================================
100+
DevCenter acts as the primary developer cockpit within the dev-bricks ecosystem,
101+
seamlessly interoperating with sibling tools:
102+
103+
Ecosystem Org | Sibling Repository | Synergy / Interoperability Role
104+
--------------+----------------------------+-----------------------------------
105+
dev-bricks | DevCenter | Flagship Python IDE & Build Suite
106+
dev-bricks | MethodenAnalyser | Standalone deep AST complexity engine
107+
dev-bricks | CodeBox | Ultra-fast single-file code viewer
108+
dev-bricks | pythonbox | Lightweight interactive debugger
109+
dev-bricks | safe-start-for-codex | Secure preflight environment launcher
110+
dev-bricks | automizer-for-claude-desktop | Claude Desktop automation bridge
111+
dev-bricks | automation-master | Flotten-Orchestrierung & Governance
112+
ellmos-ai | ellmos-core | AI coordination kernel & task broker
113+
ellmos-ai | clutch | Subprocess management & PTY bridge
114+
ellmos-ai | coma | Conflict resolution & state sync
115+
ellmos-ai | swarm-ai | Swarm coordination & multi-node tasks
116+
ellmos-ai | ellmos-controlcenter-mcp | MCP fleet management & tool governance
117+
file-bricks | ProFiler | High-speed multi-tab file explorer
118+
file-bricks | ExplorerPro | Enhanced Windows Explorer companion
119+
file-bricks | ProSync | SQLite-aware backup & sync manager
120+
doc-bricks | DokuZen | Markdown workspace & PDF documentation
121+
doc-bricks | PDFtoPDFocr | Local OCR layer injection for PDFs
122+
open-bricks | open-bricks | Umbrella index & ecosystem directory
123+
124+
===============================================================================
125+
6. OPERATIONAL & MARKETING CAMPAIGN LOG
126+
===============================================================================
127+
2026-02-24 [REL 1.0.0] Initial public release of DevCenter suite.
128+
2026-08-21 [HYG P-006] Tier-2 multi-language expansion (DE, EN, ES, ZH, JA, RU).
129+
2026-08-24 [HYG Pfad A] CI multi-OS hardening, ruff gate, PEP 621 metadata parity.
130+
2026-09-08 [HYG B-005] Workspace export parser hardening & screenreader a11y.
131+
2026-09-11 [SEC v1.0.1] Third-party license audit, CVE floors, security contract.
132+
2026-09-12 [MKT Pfad B] Release 1.0.1: Full Marketing & Discoverability standard:
133+
- 15-point bilingual quick navigation with 100% anchor parity.
134+
- Shields.io badge suite (1.0.1, 187+ passed tests 100% green).
135+
- 10 Governance & Runtime Invariants table (INV-LOCAL-01 to INV-SLA-10).
136+
- THIRD_PARTY_LICENSES.md rich markdown SBOM with SPDX mapping.
137+
- MARKETING-LOG.txt local marketing intelligence & personas register.
138+
- Sibling ecosystem matrix expanded to 16 partner tools.
139+
- Machine-readable llms.txt synchronized to 2026-09-12 baseline.

0 commit comments

Comments
 (0)