From e8981f43515af95b36b1cccaaa4065fc1598c23f Mon Sep 17 00:00:00 2001 From: sepehr-safari Date: Sat, 11 Jul 2026 05:28:03 +0300 Subject: [PATCH] docs: close out S0 (Foundation) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Milestone-boundary audit: mark S0 complete in ROADMAP, move founding docs and ADRs to 'done' in CURRENT_STATE, clear in-progress, and point 'next' at S1 — Engine core. Exit criteria met (CI green on macOS + Linux, native doctor --strict clean). Closes #9 --- CURRENT_STATE.md | 27 +++++++++++++++++---------- ROADMAP.md | 10 +++++----- 2 files changed, 22 insertions(+), 15 deletions(-) diff --git a/CURRENT_STATE.md b/CURRENT_STATE.md index 64f2483..4c49eee 100644 --- a/CURRENT_STATE.md +++ b/CURRENT_STATE.md @@ -8,10 +8,13 @@ ## Active milestone -**S0 — Foundation** (see [ROADMAP.md](ROADMAP.md)). +**S0 — Foundation: complete.** Next up: **S1 — Engine core** (see +[ROADMAP.md](ROADMAP.md)). ## What's done +### S0 — Foundation ✅ + - **Repository genesis** — Apache-2.0 `LICENSE`, `.gitignore`. - **Scaffold + identity** (#5) — native-rendered Native SDK skeleton (`app.zon`, `src/main.zig`, `src/app.native`, `src/tests.zig`), `NOTICE`, `.editorconfig`; @@ -22,30 +25,34 @@ tests / strict check, and a Linux Xvfb `smoke` job that drives the running app through its automation server and uploads a rendered screenshot. `scripts/smoke.sh` is the portable driver. +- **Founding docs & governance** (#7) — README, ROADMAP, CURRENT_STATE, AGENTS, + CONTRIBUTING, CODE_OF_CONDUCT, SECURITY. +- **Architecture decision records** (#8) — ADR-0001..0004: independent + implementation, macOS-first platforms, native-rendered UI, Zig zero-config. + +**Exit criteria met:** CI green on macOS + Linux; `native doctor --strict` clean. ## What's in progress -- **Founding docs & governance** (this PR) — README, ROADMAP, CURRENT_STATE, - AGENTS, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY. +- Nothing in flight — S0 is closed; S1 is next. ## What's next -1. **Architecture decision records** — ADR-0001..0004 capturing the foundational - decisions (independent implementation, macOS-first, native-rendered, Zig). -2. **Close S0** — verify exit criteria, close the milestone. -3. **S1 — Engine core** — the pure-Zig OCPP types, parser, normalizer, and - session correlation. +**S1 — Engine core (0.1.0):** the pure-Zig OCPP engine — canonical `Event` / +`Session` / `Failure` types, the parser (JSON object, JSONL, bare array), the +normalizer (direction inference + timestamp normalization), and session +correlation by transaction id. Headless and testable via `native test`. ## Known blockers / decisions pending -- None. Foundational decisions are captured (or being captured) as ADRs. +- None. Foundational decisions are captured as ADRs. ## Area status | Area | Status | | --- | --- | | `repo` (tooling, CI) | ✅ done for S0 | -| `docs` (docs, ADRs) | 🔄 in progress | +| `docs` (docs, ADRs) | ✅ done for S0 | | `ocpp` (engine) | ⬜ not started (S1) | | `ui` (native views) | ⬜ placeholder (S3) | | `capture` (live proxy) | ⬜ not started (S5) | diff --git a/ROADMAP.md b/ROADMAP.md index 222e219..ab374cd 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -8,19 +8,19 @@ the stable part. | Milestone | Version | Theme | Status | | --- | --- | --- | --- | -| **S0** | 0.0.x | Foundation | ✅ In progress | -| **S1** | 0.1.0 | Engine core | Next | +| **S0** | 0.0.x | Foundation | ✅ Complete | +| **S1** | 0.1.0 | Engine core | Next up | | **S2** | 0.1.0 | Detection + conformance | Planned | | **S3** | 0.2.0 | Inspector UI | Planned | | **S4** | 0.3.0 | Analysis parity+ | Planned | | **S5** | 0.4.0 | Live capture ⭐ | Planned | | **S6** | 1.0.0 | 1.0 polish | Planned | -## S0 — Foundation (0.0.x) +## S0 — Foundation (0.0.x) ✅ Repo, tooling, and CI. A native window that opens, an automation-driven smoke -test, founding docs, and architecture decision records. **Exit:** CI green on -macOS + Linux; `native doctor --strict` clean. +test, founding docs, and architecture decision records. **Exit criteria met:** +CI green on macOS + Linux; `native doctor --strict` clean. ## S1 — Engine core (0.1.0)