doql 0.0.1__tar.gz

doql-0.0.1/LICENSE

@@ -0,0 +1,26 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Softreck
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Full license text: https://www.apache.org/licenses/LICENSE-2.0.txt
+
+   ---
+
+   Note: This Apache 2.0 license covers the `doql` open-core components.
+   Premium plugins (doql-plugin-gxp, doql-plugin-iso17025, doql-plugin-fleet)
+   and enterprise/SaaS hosting are distributed under separate commercial
+   terms — see https://doql.dev/pricing for details.

doql-0.0.1/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: doql
+Version: 0.0.1
+Summary: Declarative OQL — build complete applications from a single .doql file
+Author-email: Softreck <hello@softreck.dev>, Tom Sapletta <tom@sapletta.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/softreck/doql
+Project-URL: Documentation, https://doql.dev
+Project-URL: Repository, https://github.com/softreck/doql
+Project-URL: Issues, https://github.com/softreck/doql/issues
+Project-URL: Changelog, https://github.com/softreck/doql/blob/main/CHANGELOG.md
+Keywords: dsl,code-generation,oqlos,low-code,saas,asset-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: goal>=2.1.0
+Requires-Dist: costs>=0.1.20
+Requires-Dist: pfix>=0.1.60
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: goal>=2.1.0; extra == "dev"
+Requires-Dist: costs>=0.1.20; extra == "dev"
+Requires-Dist: pfix>=0.1.60; extra == "dev"
+Provides-Extra: api
+Requires-Dist: fastapi>=0.104; extra == "api"
+Requires-Dist: sqlalchemy>=2.0; extra == "api"
+Requires-Dist: alembic>=1.13; extra == "api"
+Provides-Extra: lsp
+Requires-Dist: pygls>=1.3; extra == "lsp"
+Requires-Dist: lsprotocol>=2023.0.1; extra == "lsp"
+Dynamic: license-file
+
+# Rodzina OQL — paczka kompletna
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.0.1-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.75-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-8.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.7500 (5 commits)
+- 👤 **Human dev:** ~$871 (8.7h @ $100/h, 30min dedup)
+
+Generated on 2026-04-17 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+**Data wydania:** 2026-04-16  
+**Zawartość:** repo `doql/` + repo `articles/` + ten README
+
+---
+
+## Co jest w tej paczce
+
+### `doql/` — nowy projekt: generator deklaratywny
+Kompletny projekt **doql** — warstwa deklaratywna nad `oqlos`, która z jednego pliku `.doql` generuje aplikacje, dokumenty, kioski, integracje API. Licencja Apache 2.0 (open core).
+
+**Kluczowe dokumenty:**
+- `README.md` — wprowadzenie, quick start, link do wszystkich sekcji
+- `SPEC.md` — pełna specyfikacja języka v0.2 (16 sekcji, wszystkie typy artefaktów)
+- `GLOSSARY.md` — **jednoznaczna semantyka OQL / DOQL / IQL** (niezbędne, jeśli komunikujesz projekt publicznie)
+- `OQLOS-REQUIREMENTS.md` — lista zmian w oqlos (8 wymagań: 5 krytycznych, 3 dodane przy v0.2)
+- `ROADMAP.md` — fazy 0-3 rozwoju, ~8 tygodni do produkcji
+- `CHANGELOG.md` — historia wersji v0.1 i v0.2
+
+**Pięć przykładów (gotowych `.doql`):**
+- `examples/asset-management/` — klon Drägerware, pełen SaaS dla BHP
+- `examples/calibration-lab/` — laboratorium ISO 17025 z 4-eyes i WORM
+- `examples/iot-fleet/` — flota RPi z OTA canary i Prometheus
+- `examples/document-generator/` — **nowy w v0.2** — tylko generator PDF bez backendu
+- `examples/kiosk-station/` — **nowy w v0.2** — stanowisko operatora na tablecie
+
+**Infrastruktura projektu:**
+- `pyproject.toml` — pakowanie Python
+- `doql/cli.py` — szkielet CLI z komendami init/validate/plan/build/run/deploy/sync/export/generate/render/query/kiosk/quadlet/docs
+- `doql/scaffolds/minimal/` — szablon dla `doql init` 
+- `LICENSE` (Apache 2.0)
+- `.gitignore` 
+
+### `articles/` — artykuły WordPress
+Sześć artykułów markdown z YAML front-matter gotowych do publikacji (kompatybilne z `wp-cli` i WordPress REST API). Każdy artykuł to jeden projekt / jedna nowość.
+
+**Lista:**
+1. `01-oqlos-status-2026-q2.md` — status oqlos po refaktorze (CC̄ 3,7→3,2)
+2. `02-testql-status-2026-q2.md` — TestQL, porównanie z Playwright
+3. `03-saas-www-status-2026-q2.md` — SaaS oqlos.com, 5 bugów P0, diagnoza landingu
+4. `04-doql-ogloszenie.md` — ogłoszenie doql v0.1 (SaaS generator)
+5. `05-wizja-ekosystemu-oqlos.md` — wizja całej rodziny (4 warstwy, strategia open-core)
+6. `06-doql-v02-dokumenty-kiosk.md` — doql v0.2 (dokumenty, kiosk, semantyka)
+
+Każdy 800-1800 słów, po polsku, gotowy do kopiuj-wklej do WordPressa.
+
+---
+
+## Jak to odpalić
+
+### Instalacja doql (po sklonowaniu do repo)
+
+```bash
+cd doql/
+pip install -e .
+doql --version
+```
+
+### Szybki test — generator PDF
+
+```bash
+doql init --template document-generator my-lab
+cd my-lab
+cp .env.example .env
+doql validate
+doql plan
+```
+
+### Szybki start z CLI shell
+
+Użyj skryptu `doql.sh` do generowania i uruchamiania aplikacji jedną komendą:
+
+```bash
+# Generuj i uruchom desktop app
+./doql.sh examples/notes-app/app.doql desktop
+
+# Generuj i uruchom web
+./doql.sh examples/notes-app/app.doql web
+
+# Generuj i uruchom API
+./doql.sh examples/notes-app/app.doql api
+
+# Generuj wszystko
+./doql.sh examples/notes-app/app.doql all
+```
+
+CLI shell automatycznie:
+- Waliduje specyfikację
+- Planuje generację
+- Generuje wszystkie artefakty
+- Uruchamia aplikację (desktop/web/api)
+
+### Publikacja artykułów
+
+Opcja A — ręcznie do WP (najprostsze):
+1. Skopiuj treść pliku `.md` bez front-matter
+2. Wklej w edytorze WordPress (tryb Markdown jeśli masz plugin)
+3. Tytuł, slug, kategorie, tagi z YAML front-matter
+
+Opcja B — `wp-cli`:
+```bash
+for file in articles/*.md; do
+  # yq wyciąga pola z front-matter, sed wycina YAML z body
+  title=$(yq -r '.title' "$file")
+  slug=$(yq -r '.slug' "$file")
+  body=$(sed '/^---$/,/^---$/d' "$file")
+  wp post create --post_title="$title" --post_name="$slug" \
+    --post_content="$body" --post_status=publish
+done
+```
+
+Opcja C — GitHub Action z WP REST API (plik `.github/workflows/publish.yml` — nie dołączony, łatwo dopisać).
+
+---
+
+## Architektura — jak się to wszystko łączy
+
+```
+┌─────────────────────────────────────────────┐
+│   doql file (.doql)                         │
+│   deklaracja CO ma powstać                  │
+└──────────────┬──────────────────────────────┘
+               │  doql build
+               ▼
+   ┌───────────┴───────────┬──────────────┬─────────────┐
+   ▼                       ▼              ▼             ▼
+ ┌────┐   ┌────┐   ┌──────────┐   ┌────────┐   ┌──────────┐
+ │API │   │Web │   │ Mobile/  │   │Kiosk   │   │Documents │
+ │    │   │    │   │ Desktop  │   │        │   │PDF/HTML  │
+ └─┬──┘   └────┘   └──────────┘   └────────┘   └──────────┘
+   │
+   │ wywołuje scenariusze .oql
+   ▼
+ ┌────────────────────────────────────┐
+ │ oqlos runtime (interpretuje .oql)  │
+ └──────────────┬─────────────────────┘
+                │ Modbus / MQTT / USB / GPIO
+                ▼
+         ┌────────────┐
+         │  Hardware  │
+         └────────────┘
+```
+
+Testy aplikacji (`.iql`) → testql → Playwright-alternative z integracją hardware.
+
+---
+
+## Co dalej
+
+**Tydzień 1 (najpilniejsze):**
+- Naprawić 5 bugów P0 w www (szczegóły w artykule 03)
+- Uzupełnić `en.json` i dodać `de.json` (targi w Niemczech)
+- Dokończyć parser `.doql` v0.2
+
+**Tydzień 2-4:**
+- Publikować artykuły 01-06 w sekwencji
+- Zaimplementować 3 krytyczne wymagania oqlos dla doql
+- Pierwszy pilot klient dla doql (rozmowy wstępne toczą się)
+
+**Miesiąc 2-3:**
+- Faza 1 doql MVP — pełny generator
+- Wdrożenie pilotażowe (lab kalibracyjny w Gdańsku)
+- Przygotowanie prezentacji na targi w Niemczech
+
+**Q3-Q4:**
+- Marketplace szablonów `.doql` 
+- Premium plugins (GxP, ISO 17025, Fleet)
+- Walidacja drugiego segmentu ICP (pharma / medtech)
+
+---
+
+## Licencja
+
+- **doql** i wszystkie jego przykłady — Apache 2.0
+- **articles** — CC BY 4.0 (można cytować i tłumaczyć z atrybucją)
+
+Premium plugins doql (komercyjne) — osobne warunki, patrz `doql/LICENSE`.
+
+---
+
+## Kontakt
+
+- Repo główne: github.com/softreck/oqlos
+- Repo doql: github.com/softreck/doql
+- Email: hello@softreck.dev
+
+
+## License
+
+Licensed under Apache-2.0.

doql-0.0.1/README.md

@@ -0,0 +1,204 @@
+# Rodzina OQL — paczka kompletna
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.0.1-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.75-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-8.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.7500 (5 commits)
+- 👤 **Human dev:** ~$871 (8.7h @ $100/h, 30min dedup)
+
+Generated on 2026-04-17 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+**Data wydania:** 2026-04-16  
+**Zawartość:** repo `doql/` + repo `articles/` + ten README
+
+---
+
+## Co jest w tej paczce
+
+### `doql/` — nowy projekt: generator deklaratywny
+Kompletny projekt **doql** — warstwa deklaratywna nad `oqlos`, która z jednego pliku `.doql` generuje aplikacje, dokumenty, kioski, integracje API. Licencja Apache 2.0 (open core).
+
+**Kluczowe dokumenty:**
+- `README.md` — wprowadzenie, quick start, link do wszystkich sekcji
+- `SPEC.md` — pełna specyfikacja języka v0.2 (16 sekcji, wszystkie typy artefaktów)
+- `GLOSSARY.md` — **jednoznaczna semantyka OQL / DOQL / IQL** (niezbędne, jeśli komunikujesz projekt publicznie)
+- `OQLOS-REQUIREMENTS.md` — lista zmian w oqlos (8 wymagań: 5 krytycznych, 3 dodane przy v0.2)
+- `ROADMAP.md` — fazy 0-3 rozwoju, ~8 tygodni do produkcji
+- `CHANGELOG.md` — historia wersji v0.1 i v0.2
+
+**Pięć przykładów (gotowych `.doql`):**
+- `examples/asset-management/` — klon Drägerware, pełen SaaS dla BHP
+- `examples/calibration-lab/` — laboratorium ISO 17025 z 4-eyes i WORM
+- `examples/iot-fleet/` — flota RPi z OTA canary i Prometheus
+- `examples/document-generator/` — **nowy w v0.2** — tylko generator PDF bez backendu
+- `examples/kiosk-station/` — **nowy w v0.2** — stanowisko operatora na tablecie
+
+**Infrastruktura projektu:**
+- `pyproject.toml` — pakowanie Python
+- `doql/cli.py` — szkielet CLI z komendami init/validate/plan/build/run/deploy/sync/export/generate/render/query/kiosk/quadlet/docs
+- `doql/scaffolds/minimal/` — szablon dla `doql init` 
+- `LICENSE` (Apache 2.0)
+- `.gitignore` 
+
+### `articles/` — artykuły WordPress
+Sześć artykułów markdown z YAML front-matter gotowych do publikacji (kompatybilne z `wp-cli` i WordPress REST API). Każdy artykuł to jeden projekt / jedna nowość.
+
+**Lista:**
+1. `01-oqlos-status-2026-q2.md` — status oqlos po refaktorze (CC̄ 3,7→3,2)
+2. `02-testql-status-2026-q2.md` — TestQL, porównanie z Playwright
+3. `03-saas-www-status-2026-q2.md` — SaaS oqlos.com, 5 bugów P0, diagnoza landingu
+4. `04-doql-ogloszenie.md` — ogłoszenie doql v0.1 (SaaS generator)
+5. `05-wizja-ekosystemu-oqlos.md` — wizja całej rodziny (4 warstwy, strategia open-core)
+6. `06-doql-v02-dokumenty-kiosk.md` — doql v0.2 (dokumenty, kiosk, semantyka)
+
+Każdy 800-1800 słów, po polsku, gotowy do kopiuj-wklej do WordPressa.
+
+---
+
+## Jak to odpalić
+
+### Instalacja doql (po sklonowaniu do repo)
+
+```bash
+cd doql/
+pip install -e .
+doql --version
+```
+
+### Szybki test — generator PDF
+
+```bash
+doql init --template document-generator my-lab
+cd my-lab
+cp .env.example .env
+doql validate
+doql plan
+```
+
+### Szybki start z CLI shell
+
+Użyj skryptu `doql.sh` do generowania i uruchamiania aplikacji jedną komendą:
+
+```bash
+# Generuj i uruchom desktop app
+./doql.sh examples/notes-app/app.doql desktop
+
+# Generuj i uruchom web
+./doql.sh examples/notes-app/app.doql web
+
+# Generuj i uruchom API
+./doql.sh examples/notes-app/app.doql api
+
+# Generuj wszystko
+./doql.sh examples/notes-app/app.doql all
+```
+
+CLI shell automatycznie:
+- Waliduje specyfikację
+- Planuje generację
+- Generuje wszystkie artefakty
+- Uruchamia aplikację (desktop/web/api)
+
+### Publikacja artykułów
+
+Opcja A — ręcznie do WP (najprostsze):
+1. Skopiuj treść pliku `.md` bez front-matter
+2. Wklej w edytorze WordPress (tryb Markdown jeśli masz plugin)
+3. Tytuł, slug, kategorie, tagi z YAML front-matter
+
+Opcja B — `wp-cli`:
+```bash
+for file in articles/*.md; do
+  # yq wyciąga pola z front-matter, sed wycina YAML z body
+  title=$(yq -r '.title' "$file")
+  slug=$(yq -r '.slug' "$file")
+  body=$(sed '/^---$/,/^---$/d' "$file")
+  wp post create --post_title="$title" --post_name="$slug" \
+    --post_content="$body" --post_status=publish
+done
+```
+
+Opcja C — GitHub Action z WP REST API (plik `.github/workflows/publish.yml` — nie dołączony, łatwo dopisać).
+
+---
+
+## Architektura — jak się to wszystko łączy
+
+```
+┌─────────────────────────────────────────────┐
+│   doql file (.doql)                         │
+│   deklaracja CO ma powstać                  │
+└──────────────┬──────────────────────────────┘
+               │  doql build
+               ▼
+   ┌───────────┴───────────┬──────────────┬─────────────┐
+   ▼                       ▼              ▼             ▼
+ ┌────┐   ┌────┐   ┌──────────┐   ┌────────┐   ┌──────────┐
+ │API │   │Web │   │ Mobile/  │   │Kiosk   │   │Documents │
+ │    │   │    │   │ Desktop  │   │        │   │PDF/HTML  │
+ └─┬──┘   └────┘   └──────────┘   └────────┘   └──────────┘
+   │
+   │ wywołuje scenariusze .oql
+   ▼
+ ┌────────────────────────────────────┐
+ │ oqlos runtime (interpretuje .oql)  │
+ └──────────────┬─────────────────────┘
+                │ Modbus / MQTT / USB / GPIO
+                ▼
+         ┌────────────┐
+         │  Hardware  │
+         └────────────┘
+```
+
+Testy aplikacji (`.iql`) → testql → Playwright-alternative z integracją hardware.
+
+---
+
+## Co dalej
+
+**Tydzień 1 (najpilniejsze):**
+- Naprawić 5 bugów P0 w www (szczegóły w artykule 03)
+- Uzupełnić `en.json` i dodać `de.json` (targi w Niemczech)
+- Dokończyć parser `.doql` v0.2
+
+**Tydzień 2-4:**
+- Publikować artykuły 01-06 w sekwencji
+- Zaimplementować 3 krytyczne wymagania oqlos dla doql
+- Pierwszy pilot klient dla doql (rozmowy wstępne toczą się)
+
+**Miesiąc 2-3:**
+- Faza 1 doql MVP — pełny generator
+- Wdrożenie pilotażowe (lab kalibracyjny w Gdańsku)
+- Przygotowanie prezentacji na targi w Niemczech
+
+**Q3-Q4:**
+- Marketplace szablonów `.doql` 
+- Premium plugins (GxP, ISO 17025, Fleet)
+- Walidacja drugiego segmentu ICP (pharma / medtech)
+
+---
+
+## Licencja
+
+- **doql** i wszystkie jego przykłady — Apache 2.0
+- **articles** — CC BY 4.0 (można cytować i tłumaczyć z atrybucją)
+
+Premium plugins doql (komercyjne) — osobne warunki, patrz `doql/LICENSE`.
+
+---
+
+## Kontakt
+
+- Repo główne: github.com/softreck/oqlos
+- Repo doql: github.com/softreck/doql
+- Email: hello@softreck.dev
+
+
+## License
+
+Licensed under Apache-2.0.

doql-0.0.1/doql/__init__.py

@@ -0,0 +1,7 @@
+"""doql — Declarative OQL.
+
+Build complete applications, documents, kiosks, and API integrations
+from a single .doql declaration file.
+"""
+
+__version__ = "0.1.0a1"

doql-0.0.1/doql/cli/__init__.py

@@ -0,0 +1,19 @@
+"""doql CLI package — modularized command-line interface."""
+from __future__ import annotations
+
+from .context import BuildContext, build_context, load_spec, scaffold_from_template, estimate_file_count
+from .lockfile import read_lockfile, write_lockfile, diff_sections, spec_section_hashes
+from .main import main
+
+__all__ = [
+    "BuildContext",
+    "build_context",
+    "load_spec",
+    "scaffold_from_template",
+    "estimate_file_count",
+    "read_lockfile",
+    "write_lockfile",
+    "diff_sections",
+    "spec_section_hashes",
+    "main",
+]

doql-0.0.1/doql/cli/build.py

@@ -0,0 +1,159 @@
+"""Full build logic for the build command.
+
+This module handles complete rebuilds by running all applicable generators.
+"""
+from __future__ import annotations
+
+import sys
+import argparse
+
+from .. import parser as doql_parser
+from ..generators import api_gen, web_gen, mobile_gen, desktop_gen, infra_gen, document_gen, report_gen, i18n_gen, integrations_gen, workflow_gen, ci_gen
+from .. import plugins as _plugins
+from .context import BuildContext, load_spec
+from .lockfile import write_lockfile
+
+
+def should_generate_interface(name: str, spec) -> bool:
+    """Check if interface should be generated.
+    
+    Args:
+        name: Interface name (api, web, mobile, desktop, infra)
+        spec: Parsed DoqlSpec
+        
+    Returns:
+        True if interface should be generated
+    """
+    if name == "infra":
+        return True
+    return any(i.name == name for i in spec.interfaces)
+
+
+def run_core_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run core interface generators (api, web, mobile, desktop, infra)."""
+    generators = {
+        "api": api_gen.generate,
+        "web": web_gen.generate,
+        "mobile": mobile_gen.generate,
+        "desktop": desktop_gen.generate,
+        "infra": infra_gen.generate,
+    }
+    
+    for name, fn in generators.items():
+        if not should_generate_interface(name, spec):
+            continue
+        
+        print(f"🛠  Generating {name}...")
+        if name == "infra":
+            target_dir = ctx.build_dir / name
+        else:
+            target_dir = ctx.build_dir / name
+        target_dir.mkdir(parents=True, exist_ok=True)
+        fn(spec, env_vars, target_dir)
+
+
+def run_document_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run document generators if documents are defined."""
+    if not spec.documents:
+        return
+    
+    print("🛠  Generating documents...")
+    doc_dir = ctx.build_dir / "documents"
+    doc_dir.mkdir(parents=True, exist_ok=True)
+    document_gen.generate(spec, env_vars, doc_dir, project_root=ctx.root)
+
+
+def run_report_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run report generators if reports are defined."""
+    if not spec.reports:
+        return
+    
+    print("🛠  Generating reports...")
+    rpt_dir = ctx.build_dir / "reports"
+    rpt_dir.mkdir(parents=True, exist_ok=True)
+    report_gen.generate(spec, env_vars, rpt_dir)
+
+
+def run_i18n_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run i18n generators if languages are defined."""
+    if not spec.languages:
+        return
+    
+    print("🛠  Generating i18n...")
+    i18n_dir = ctx.build_dir / "i18n"
+    i18n_dir.mkdir(parents=True, exist_ok=True)
+    i18n_gen.generate(spec, env_vars, i18n_dir)
+
+
+def run_integration_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run integration generators if integrations are defined."""
+    if not (spec.integrations or spec.api_clients or spec.webhooks):
+        return
+    
+    print("🛠  Generating integrations...")
+    svc_dir = ctx.build_dir / "api" / "services"
+    svc_dir.mkdir(parents=True, exist_ok=True)
+    integrations_gen.generate(spec, env_vars, svc_dir)
+
+
+def run_workflow_generators(spec, env_vars, ctx: BuildContext) -> None:
+    """Run workflow generators if workflows are defined."""
+    if not spec.workflows:
+        return
+    
+    print("🛠  Generating workflows...")
+    wf_dir = ctx.build_dir / "api" / "workflows"
+    wf_dir.mkdir(parents=True, exist_ok=True)
+    workflow_gen.generate(spec, env_vars, wf_dir)
+
+
+def run_ci_generator(spec, env_vars, ctx: BuildContext) -> None:
+    """Run CI/CD generator (always into project root)."""
+    print("🛠  Generating CI...")
+    ci_gen.generate(spec, env_vars, ctx.root)
+
+
+def run_plugins(spec, env_vars, ctx: BuildContext) -> None:
+    """Run plugin generators."""
+    _plugins.run_plugins(spec, env_vars, ctx.build_dir, ctx.root)
+
+
+def cmd_build(args: argparse.Namespace) -> int:
+    """Generate all code for the project.
+    
+    This command runs all applicable generators to create a complete build.
+    Validation is performed first unless --force is specified.
+    """
+    ctx = BuildContext(
+        root=__import__('pathlib').Path(getattr(args, "dir", None) or ".").resolve(),
+        doql_file=__import__('pathlib').Path(getattr(args, "dir", None) or ".").resolve() / (getattr(args, "file", None) or "app.doql"),
+        env_file=__import__('pathlib').Path(getattr(args, "dir", None) or ".").resolve() / ".env",
+        build_dir=__import__('pathlib').Path(getattr(args, "dir", None) or ".").resolve() / "build",
+    )
+    
+    spec, env_vars = load_spec(ctx)
+    
+    # Validate unless --force
+    issues = doql_parser.validate(spec, env_vars)
+    errors = [i for i in issues if i.severity == "error"]
+    if errors and not getattr(args, "force", False):
+        print("❌ Validation errors (use --force to ignore):", file=sys.stderr)
+        for e in errors:
+            print(f"   {e.path}: {e.message}", file=sys.stderr)
+        return 1
+    
+    ctx.build_dir.mkdir(parents=True, exist_ok=True)
+    
+    # Run all generators in order
+    run_core_generators(spec, env_vars, ctx)
+    run_document_generators(spec, env_vars, ctx)
+    run_report_generators(spec, env_vars, ctx)
+    run_i18n_generators(spec, env_vars, ctx)
+    run_integration_generators(spec, env_vars, ctx)
+    run_workflow_generators(spec, env_vars, ctx)
+    run_ci_generator(spec, env_vars, ctx)
+    run_plugins(spec, env_vars, ctx)
+    
+    write_lockfile(spec, ctx)
+    print(f"\n✅ Build complete — see {ctx.build_dir}/")
+    return 0