v0.3.6 66b4767d25

v0.3.6 — v0.4 milestone: Edge + Messaging + Language-Derived Docs Stable

cloudinit-bot released this 2026-08-05 16:22:58 +00:00 | -11 commits to main since this release

v0.4 — Edge + Messaging + Language-Derived Docs (Milestone Release)

Tag: v0.3.6 (NFR milestone — final patch IS the deliverable; no separate minor tag per branch-strategy.md)
Milestone branch: milestone/v0.4-edge-quantum-langs (merged to main, deleted post-merge)

Summary

The 4th Atelier milestone extends the domain tree with two new top-level domains (edge, messaging — 20 new P-rules) and extends languages/ from first-principles-only stubs to full derived-doc trees (16 new derived docs across 4 languages). All content is docs-only markdown with illustrative code fences (D-020 — no runtime code).

Phases

Phase	Name	Tag	Requirements	Status
P0	Pre-Execution	v0.3.0	(specify, clarify, research, ideate, plan, grill)	complete
P1	Edge Domain	v0.3.1	ATELIER-92..96 (5)	complete
P2	Messaging Domain	v0.3.2	ATELIER-97..101 (5)	complete
P3	Language-Derived Extension	v0.3.3	ATELIER-102..105 (4)	complete
P4	Matrix + Review + Manifest + Architecture	v0.3.4	ATELIER-106..111, 117 (7)	complete
P5	Examples + Cross-Links	v0.3.5	ATELIER-112..114 (3)	complete
P6	Final Review + Ship	v0.3.6	ATELIER-115, 116 (2)	complete

Requirements

All 26 requirements (ATELIER-92..117) covered. 0 partial.

New Content

Domains (2 new, 20 new P-rules)

domains/edge/ — first-principles + cdn, offline-first, iot, sync (10 P-rules: P1 Proximity, P2 Offline, P3 Constrained Resources, P4 Bounded Sync, P5 Idempotent Ops, P6 Explicit Cache Invalidation, P7 Engineered Partial Degradation, P8 Geographic Distribution, P9 Constrained Identity, P10 Partition-Survivable Observability)
domains/messaging/ — first-principles + queues, pubsub, streams, delivery-semantics (10 P-rules: P1 Contracts, P2 Ordering, P3 Idempotent Consumers, P4 Explicit Delivery Semantics, P5 Dead-Letter Handling, P6 Bounded Backpressure, P7 Intentional Partitioning, P8 Replay/Retention, P9 Compatible Schema Evolution, P10 Observable Messaging)

Languages (16 new derived docs + 4 stubs extended)

TypeScript: ts-types, ts-tooling, ts-async, ts-testing
Python: py-types, py-tooling, py-async, py-testing
Go: go-types, go-tooling, go-concurrency, go-testing
Rust: rs-ownership, rs-tooling, rs-async, rs-testing

Integration

matrix/principles-matrix.md: 170 → 190 P-rules across 19 domains (G-014 honored: verified 170 pre-existing, no phantom 171st row)
matrix/domain-coverage.md: per-domain v0.4 table + updated Core Principle Coverage + new Languages Coverage sub-table (exactly 16 rows)
review/agent-checklist.md + peer-review-checklist.md: +3 trigger sections (Edge, Messaging, Language-Derived)
review/anti-patterns.md: +6 chaos anti-patterns + 4 language-derived anti-patterns + 20 domain-specific + v0.4 artifact types (.ts/.py/.go/.rs)
MANIFEST.md: +2 domains + new ## Languages section (closes pre-existing v0.1 drift) + "19 domains, 190 P-rules post-v0.4"
ARCHITECTURE.md: component tree extended + v0.4 Domain Additions section

Examples (4 new)

good/edge-offline-sync.md, good/messaging-idempotent-consumer.md
bad/edge-sync-loop.md (P4 single-breach), bad/messaging-shared-subscription.md (P2 primary + P3 consequence, single-breach named)

Decisions

D-054..D-075 (specify, clarify, research, ideate, plan) + G-013..G-018 (grill binding). All at full autonomy (zero HITL).

Audit

Final review PASS (all 5 personas). Audit PASS (6 checks). 1 P0 fix applied (MANIFEST examples drift — 4 v0.4 examples unlisted, fixed). 0 P1+ flagged. Matrix row-count test: exactly 190. MANIFEST reconstruction: clean. ARCHITECTURE component-tree: clean.

Boundary Decisions Honored

D-061: edge owns proximity/location angle (not generic perf/concurrency)
D-062: messaging owns cross-process/network-failure-model (not in-process concurrency)
D-063: language-derived docs apply (not derive) — no new P-rules, no new matrix rows
G-014: matrix pre-existing = exactly 170 (not 171); post-v0.4 = 190

v0.4 Phase 5 — Examples + Cross-Links (P5)

Add 2 good + 2 bad examples (D-068 — pre-named, highest illustration value) and verify cross-domain links. Examples are markdown with fenced code only (no standalone .ts/.py/.go/.rs — D-020). Bad examples are single-breach citing the specific breached P-rule (D-068).

Files

examples/good/edge-offline-sync.md — demonstrates offline-first + CRDT/LWW sync (edge P2, P4, P5, P10)
examples/good/messaging-idempotent-consumer.md — demonstrates exactly-once-via-idempotency-keys + dedup (messaging P3, P4, P5, P10)
examples/bad/edge-sync-loop.md — single-breach: edge P4 (Sync Conflicts are Bounded, Not Infinite) — livelock, not eventual consistency
examples/bad/messaging-shared-subscription.md — single-breach: messaging P2 (Ordering is a Property) primary; P3 compounding consequence

Cross-link audit (ATELIER-114)

57 cross-links verified across 26 new derived docs — all resolve to MANIFEST-listed docs
edge↔messaging bidirectional: edge/iot.md → messaging/queues.md (MQTT QoS) AND messaging/streams.md → edge/iot.md both resolve (IDEATE-40)
Language-derived docs link to both new (edge/messaging) and existing domains (IDEATE-40)
0 back-link edits to v0.1/v0.2/v0.3 content (D-026 extended)

Requirements covered

ATELIER-112, ATELIER-113, ATELIER-114 (3/3)

v0.4 Phase 4 — Matrix + Review + Manifest + Architecture (P4)

Close the traceability loop and make the manifest + architecture authoritative for v0.4. 3 waves: matrix → coverage → ARCHITECTURE (sequential); 3 review docs (parallel); MANIFEST (sequential after settled).

Files

matrix/principles-matrix.md — +20 rows (10 edge + 10 messaging); 170 → 190 P-rules across 19 domains (G-014 honored: verified 170 pre-existing, no phantom 171st row)
matrix/domain-coverage.md — per-domain v0.4 table + updated Core Principle Coverage table + new Languages Coverage sub-table (exactly 16 rows, one per language-derived doc)
.ciagent/atelier/ARCHITECTURE.md — component tree extended (edge/, messaging/, languages/); v0.4 Domain Additions section
review/agent-checklist.md — +3 trigger sections (Edge 10 checks, Messaging 10 checks, Language-Derived 5 checks)
review/peer-review-checklist.md — +3 reviewer-voice sections + 3 scope checks (D-061, D-062, D-063/D-066)
review/anti-patterns.md — +6 chaos anti-patterns + 4 language-derived anti-patterns + 10 edge + 10 messaging domain-specific + v0.4 artifact types (.ts/.py/.go/.rs)
MANIFEST.md — +2 domains + new ## Languages section (4 v0.1 stubs + 16 derived docs, closes pre-existing drift); Cross-Cutting summary = "19 domains, 190 P-rules post-v0.4"

Requirements covered

ATELIER-106, ATELIER-107, ATELIER-108, ATELIER-109, ATELIER-110, ATELIER-111, ATELIER-117 (7/7)

Verify (P4)

Structural: matrix 190 P-rows (170 + 20); Languages Coverage 16 rows; ARCHITECTURE v0.4 section; MANIFEST Languages section
Behavioral: every new edge+messaging P-rule has a matrix row; Coverage Summary "19 domains, 190 P-rules"
Security: anti-patterns cover all 6 chaos + edge P9 + messaging P1 + language-derived runtime-artifact
Quality: MANIFEST authoritative; checklist parity; matrix row-count test passes (exactly 190)

v0.4 Phase 3 — Language-Derived Extension (P3)

Extend each languages/*.md from a first-principles-only stub to a full derived-doc tree. 4 languages × (extend stub + 4 derived docs) = 16 new derived docs. Language-derived docs apply (not derive) domain principles — NO new P-rules (D-063), NO new matrix rows (D-066); each section traces to existing domain P-rules via the section-header-trace pattern.

Files

4 stubs extended (typescript.md, python.md, go.md, rust.md) — each gains a Derived Docs section; existing structure preserved (no P1-P10 numbering)
16 new derived docs:
- TypeScript: ts-types, ts-tooling, ts-async, ts-testing
- Python: py-types, py-tooling, py-async, py-testing
- Go: go-types, go-tooling, go-concurrency, go-testing (Go gets concurrency, not async — distinctive strength)
- Rust: rs-ownership, rs-tooling, rs-async, rs-testing (Rust gets ownership, not types — distinctive strength)

Requirements covered

ATELIER-102, ATELIER-103, ATELIER-104, ATELIER-105 (4/4)

Verify (P3)

Structural: 20 language files (4 stubs + 16 derived)
Behavioral: every derived-doc section header names >=1 traced domain P-rule AND C-rule inline (D-063); no new P-rules; no P1-P10 numbering
Security: no standalone .ts/.py/.go/.rs runtime artifacts (D-020)
Quality: each derived doc >=1 outbound cross-link; 4 async/concurrency docs link to new edge/messaging domains (IDEATE-40)

v0.4 Phase 2 — Messaging Domain (P2)

Author the domains/messaging/ tree: 10 first principles + 4 derived docs. Messaging owns the cross-process / network-failure-model angle (D-062): messages as contracts, explicit delivery semantics, idempotent consumers, bounded backpressure, observable lag.

Files

domains/messaging/first-principles.md — 10 P-rules (P1 Contracts, P2 Ordering, P3 Idempotent Consumers, P4 Explicit Delivery Semantics, P5 Dead-Letter Handling, P6 Bounded Backpressure, P7 Intentional Partitioning, P8 Replay/Retention, P9 Compatible Schema Evolution, P10 Observable Messaging); traces to 7 core C-rules (C1, C2, C4, C5, C6, C7, C8)
domains/messaging/queues.md — at-least-once/at-most-once/exactly-once comparison table (D-069)
domains/messaging/pubsub.md — fan-out + shared vs independent subscriptions
domains/messaging/streams.md — Kafka/Kinesis/Pulsar/NATS JetStream comparison (D-069) + consumer-group rebalance strategies (IDEATE-41)
domains/messaging/delivery-semantics.md — dead-letter strategy comparison (D-069) + fenced idempotency-key dedup-store example (IDEATE-39)

Requirements covered

ATELIER-97, ATELIER-98, ATELIER-99, ATELIER-100, ATELIER-101 (5/5)

Boundary

D-062: messaging owns cross-process/network-failure-model; concurrency owns in-process/crash-failure-model. No duplication.
Edge↔messaging bidirectionality resolved: edge/iot.md → messaging/queues link (P1) now resolves.

v0.4 Phase 1 — Edge Domain (P1)

Author the domains/edge/ tree: 10 first principles + 4 derived docs. Edge owns the proximity/location angle (D-061): compute near the user/data, offline as a first-class state, constrained resources declared, sync conflicts bounded, partition-survivable telemetry.

Files

domains/edge/first-principles.md — 10 P-rules (P1 Proximity, P2 Offline, P3 Constrained Resources, P4 Bounded Sync, P5 Idempotent Ops, P6 Explicit Cache Invalidation, P7 Engineered Partial Degradation, P8 Geographic Distribution, P9 Constrained Identity, P10 Partition-Survivable Observability); traces to 7 core C-rules (C1, C3, C4, C5, C6, C7, C8)
domains/edge/cdn.md — CDN/edge-cache + edge-cache-vs-origin decision matrix (D-069)
domains/edge/offline-first.md — offline state + testing-pyramid-tier mapping (IDEATE-38)
domains/edge/iot.md — constrained devices (MQTT/CoAP) + device provisioning
domains/edge/sync.md — CRDT vs LWW + CRDT-vs-LWW decision matrix (D-069)

Requirements covered

ATELIER-92, ATELIER-93, ATELIER-94, ATELIER-95, ATELIER-96 (5/5)

Verify (P1)

Structural: 5 files exist under domains/edge/
Behavioral: 10 P-rules trace to >=1 C-rule (broad-derivation 7 C-rules)
Security: P9 + P6 sections present
Quality: 2 decision matrices (cdn, sync); offline-first maps to testing pyramid; each derived doc >=1 outbound cross-link; no duplication of performance/concurrency/observability P-rules (D-061 boundary)

v0.4 Pre-Execution Phase (P0)

Milestone v0.4 — Edge + Messaging + Language-Derived Docs begins. This release is the pre-execution phase 0: all planning artifacts are committed; no framework content has changed yet.

Stages completed

SPECIFY — v0.4 scope (edge + messaging + 16 language-derived docs), 7 decisions (D-054..D-060)
CLARIFY — 9 ambiguities auto-resolved at full autonomy (D-061..D-069)
RESEARCH — 20 P-rules proposed (10 edge + 10 messaging, each traces to >=1 C-rule), persona roster (edge-engineer P1, languages-engineer P3), decision matrices pre-specified (D-070..D-072)
IDEATE — 13 ideas generated, 13 accepted (12 refinements + 1 new req ATELIER-117 ARCHITECTURE.md update); 0 deferred (D-073)
PLAN — 46-task vertical-slice plan across P1-P6 (D-074..D-075)
GRILL — conditional proceed; 1 false-premise fix (G-014: matrix has exactly 170 rows, not 171; corrected in plan/requirements/ideate); 6 binding decisions (G-013..G-018)

Requirements

26 requirements (ATELIER-92..117) — all pending (execution phases P1-P6 will cover them)
NFR milestone; tags run on v0.3.x line; v0.3.6 will be the v0.4 release

Files

.ciagent/atelier/PROJECT.md, REQUIREMENTS.md, ROADMAP.md (v0.4 sections added)
.ciagent/atelier/CLARIFY-v0.4.md, RESEARCH-v0.4.md, IDEATE-v0.4.md, PLAN-v0.4.md, GRILL-v0.4.md (new)
.ciagent/atelier/PERSONAS.md (updated: +2 phase-specific personas)
.ciagent/config.json (milestone -> v0.4, status -> active)

P1: Edge domain (domains/edge/{first-principles, cdn, offline-first, iot, sync}.md) -> v0.3.1
P2: Messaging domain -> v0.3.2
P3: Language-derived extension (16 derived docs) -> v0.3.3
P4: Matrix + review + manifest + architecture -> v0.3.4
P5: Examples + cross-links -> v0.3.5
P6: Final review + ship (IS the v0.4 release) -> v0.3.6

Downloads

v0.2.6 9ebc9c8868

v0.2.6: v0.3 Milestone Release — GitOps+Operators, AI/ML, i18n, Compliance Stable

cloudinit-bot released this 2026-08-05 03:45:38 +00:00 | 2 commits to main since this release

Atelier v0.3 Milestone Release

Summary

v0.3 extends the Atelier first-principles framework with 4 new top-level domains: GitOps + Operators, AI/ML, i18n, and Compliance. The principles matrix grows from 130 to 170 P-rules across 13 to 17 domains, all tracing to the 8 universal core principles (C1-C8).

Milestone Type

NFR (documentation-only, no runtime code)

Phases Shipped

Phase	Tag	Content
P0	v0.2.0	Pre-execution (specify, clarify, research, ideate, plan, grill)
P1	v0.2.1	GitOps + Operators domain (5 docs)
P2	v0.2.2	AI/ML domain (5 docs)
P3	v0.2.3	i18n + Compliance domains (10 docs)
P4	v0.2.4	Matrix + Review + Manifest integration (40 new mappings)
P5	v0.2.5	Examples + Cross-Links (4 new examples)
P6	v0.2.6	Final review + ship (IS the milestone release)

Requirements Covered (32)

ATELIER-60..91 — all covered, 0 partial

New Domains

domains/gitops-operators/ — ArgoCD, Flux, Operators, Progressive Delivery (10 P-rules)
domains/ai-ml/ — data versioning, model evaluation, serving, drift (10 P-rules)
domains/i18n/ — locale resources, formatting, rtl-bidi, testing (10 P-rules)
domains/compliance/ — audit logs, retention, policy-as-code, evidence (10 P-rules)

Matrix Impact

130 → 170 P-rules across 13 → 17 domains. Every new P-rule traces to ≥1 core C-rule.

Ideation

14 ideas generated (IDEATE-17..30), all accepted. 1 new requirement (ATELIER-91: MANIFEST examples/ listing). 14 refinements baked into execute-phase deliverables.

Grill

Verdict: PROCEED (confidence 0.80). 12 binding decisions (G-001..G-012), 0 escalations.

Review + Audit

Multi-persona review: PASS (5 axes, 1 P0 fix — coverage C8 contradiction)
Project health audit: PASS (stale REQUIREMENTS status + missing decisions auto-fixed)

Key Constraints Enforced

D-020: docs-only (no runtime artifacts)
D-023: AI/ML = engineering discipline, not algorithm design
D-024: Compliance framework-agnostic, not regulation-specific
D-026: 40 new matrix mappings (10 per domain)
ESC-002 closed: MANIFEST now lists examples/ directory

Phase P5: Examples + Cross-Links

Milestone: v0.3

Requirements Covered (3)

ATELIER-86: 2 good examples (gitops-pr, ai-ml-reproducibility)
ATELIER-87: 2 bad examples (i18n-string-concat, compliance-audit-log — 2 breaches P1+P9 per IDEATE-26)
ATELIER-88: Cross-link audit — 16/16 derived docs have outbound cross-links

Verification: PASS

D-023 enforced on ai-ml example (no algorithm content)
MANIFEST examples/ status promoted pending→✓
All cross-links resolve

Downloads

v0.2.4 61043dea1b

v0.2.4: v0.3 P4 — Matrix + Review + Manifest Integration Stable

cloudinit-bot released this 2026-08-05 03:35:26 +00:00 | -6 commits to main since this release

Phase P4: Matrix + Review + Manifest Integration

Milestone: v0.3

Requirements Covered (6)

ATELIER-80: matrix extended 130→170 P-rules (40 new mappings, 4 domains)
ATELIER-81: domain-coverage extended (17 domains, 170 P-rules, Core Principle Coverage table)
ATELIER-82: agent-checklist +4 domain sections
ATELIER-83: peer-review-checklist +4 domain sections (parity)
ATELIER-84: anti-patterns +4 chaos +16 domain-specific + v0.3 artifact types
ATELIER-85: MANIFEST +20 v0.3 docs + examples/ section (closes ESC-002)

Verification: PASS

P0 fix: domain-coverage contradictions with matrix auto-fixed
All 40 new C-rule mappings verified correct
All cross-references resolve

Downloads

28 Releases 28 Tags

v0.3.6 — v0.4 milestone: Edge + Messaging + Language-Derived Docs Stable

v0.4 — Edge + Messaging + Language-Derived Docs (Milestone Release)

Summary

Phases

Requirements

New Content

Domains (2 new, 20 new P-rules)

Languages (16 new derived docs + 4 stubs extended)

Integration

Examples (4 new)

Decisions

Audit

Boundary Decisions Honored

Next

v0.3.5 — v0.4 examples + cross-links Stable

v0.4 Phase 5 — Examples + Cross-Links (P5)

Files

Cross-link audit (ATELIER-114)

Requirements covered

Next

v0.3.4 — v0.4 matrix+review+manifest+architecture Stable

v0.4 Phase 4 — Matrix + Review + Manifest + Architecture (P4)

Files

Requirements covered

Verify (P4)

Next

v0.3.3 — v0.4 language-derived extension Stable

v0.4 Phase 3 — Language-Derived Extension (P3)

Files

Requirements covered

Verify (P3)

Next

v0.3.2 — v0.4 messaging domain Stable

v0.4 Phase 2 — Messaging Domain (P2)

Files

Requirements covered

Boundary

Next

v0.3.1 — v0.4 edge domain Stable

v0.4 Phase 1 — Edge Domain (P1)

Files

Requirements covered

Verify (P1)

Next

v0.3.0 — v0.4 pre-execution phase Stable

v0.4 Pre-Execution Phase (P0)

Stages completed

Requirements

Files

Next

v0.2.6: v0.3 Milestone Release — GitOps+Operators, AI/ML, i18n, Compliance Stable

Atelier v0.3 Milestone Release

Summary

Milestone Type

Phases Shipped

Requirements Covered (32)

New Domains

Matrix Impact

Ideation

Grill

Review + Audit

Key Constraints Enforced

Next

v0.2.5: v0.3 P5 — Examples + Cross-Links Stable

Phase P5: Examples + Cross-Links

Requirements Covered (3)

Verification: PASS

v0.2.4: v0.3 P4 — Matrix + Review + Manifest Integration Stable

Phase P4: Matrix + Review + Manifest Integration

Requirements Covered (6)

Verification: PASS