Skip to content

History / Lifecycle Agreement Processes

Revisions

  • Add ISO standard links + source info to OPM and Lifecycle chapters (issue #8) Per issue #8 (RobinWikoff), pages referencing ISO standards previously named the standard without a clickable link or full edition/source metadata. Added: Conceptual-Model page (OPM, ISO 19450): - Linked ISO/PAS 19450:2015 to iso.org/standard/62274.html and ISO 19450:2024 (Second edition) to iso.org/standard/83454.html. - Added ICS codes (25.040.40, 35.240.50) and an explicit pointer to the wiki's pinned EBNF transcription at tools/iso-19450-opl.ebnf. - Cited supplementary sources: Dori 2002 (CAiSE) and Dori 2016 (Springer) — the canonical OPL production rules pre-dating the ISO standard and the published textbook treatment. - Linked the iso.org/obp free preview for Clauses 1–3. - Noted the standard's patent acknowledgment per ISO/PAS 19450:2015 Foreword. Lifecycle pages (ISO/IEC/IEEE 15288), four chapters covering Clauses 6.1, 6.2, 6.3, 6.4: - Added a `[NOTE]` block at the top of each chapter linking ISO/IEC/IEEE 15288:2023 to iso.org/standard/81702.html, naming the full title, edition, ICS code (35.080), supersession relationship, and joint publication by ISO, IEC, and IEEE. - Linked the iso.org/obp free preview. All 8 validators pass. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @afflom afflom committed May 14, 2026
  • Phase 4 reconciliation: OPM + ISO 15288 sources, V6/V7/V8 all PASS Lands the three transcribed-standard pin files, all six OPM Conceptual Model OPDs, and all four ISO/IEC/IEEE 15288 lifecycle process-group chapters. The wiki state now matches its declared state in wiki-definition.md: every validator runs (no skip-gap), Stages 3b/3c produce committable output, and Stage 5 idempotence holds. Pin files (tools/): - iso-19450-opl.ebnf — OPL formal syntax in ISO/IEC 14977 EBNF. Workspace-authored transcription of ISO/PAS 19450:2015 Annex A. Each production carries an inline source-attribution comment citing the standard plus seven public corroborating sources (Dori 2002, Dori 2016, OPCAT 3.0 manual, Svensson 2004 thesis, OPCloud linkTypeSelection.ts, Wikipedia, ISO 19450 free preview). Coverage: object/process/state declarations, the four fundamental structural relations, transformation links, enabling links, in-out link pairs, tagged structural links, invocation. Deferred to a later cycle: state-specified link variants, control-link modifiers, in-zoom/unfolding, multiplicity, path labels. - iso-19450-opd-coherence.txt — Maps the three entity-introducing productions to their name-bearing rules (object-declaration → object-name, process-declaration → process-name, state-declaration → state-name). Why these three: per ISO 19450 Clauses 7-9, only these introduce entities into the model; the other 13 sentence kinds reference pre-introduced things. - iso-15288-processes.txt — 30-process catalog across the four process groups (2 + 6 + 8 + 14). Verbatim from ISO/IEC/IEEE 15288:2023 Clause 6 section titles. ISO 15288 lifecycle (src/15288/): Per-process-group AsciiDoc chapters declaring Prism's instance of each of the 30 processes. For each process, the chapter records either (a) the artifact in Prism's architecture that satisfies the process (cross-referencing arc42 sections, ADRs, constraints, or codebase verification artifacts) or (b) "Not applicable to Prism" with the architectural reason for inapplicability. V8 verifies that every process named in the pin file appears as a `===` heading in the corresponding `<group>.adoc` file. OPM Conceptual Model (src/opm/): Six OPDs presenting Prism's static and dynamic conceptual structure: - SD : Top-level system context (chapter 3) - SD1-Prism-Structure : Three containers (chapter 5) - SD2-Principal-Data-Path : Pipeline stages (chapter 6 scenario 1) - SD3-Verification : Replay surface (chapter 6 scenario 2) - SD4-UORassembly-Enforcement : Compile-time bilateral check (scenario 3) - SD5-Distribute-and-Run : Author-to-user handoff (scenario 4) Each OPD comprises an opl.txt (canonical OPL declaration set, V6's input) and an opd.svg (rendering, V7's secondary input). V7 verifies the entity name set declared by opl.txt equals the <text> content set in opd.svg. OPL files for SD, SD1, SD2, SD3 are workspace-authored to match the architecture chapters; OPL for SD4 and SD5 is workspace-authored from chapter 6 scenarios 3 and 4. All six SVGs are generated by tools/opl-to-svg.rb (a developer aid; see below). OPL → SVG generator (tools/opl-to-svg.rb): A one-time / occasional bootstrap helper that produces a deterministic OPM-style SVG from an OPL file. NOT part of the build pipeline — opd.svg is a source artifact, not a build output. The generator classifies each entity as object (rectangle) or process (ellipse) by examining its declaration's essence and its appearances in procedural-link sentences; environmental things render with dashed borders. Layout is a 4-column grid; each entity receives one <text> element whose content matches the OPL declaration verbatim, so V7's coherence check holds by construction on first generation. The author may hand-tune the SVG layout subsequently; V7 catches any edit that drops or alters an entity-name <text>. Sidebar.adoc: Reorganized into three sections matching the three coordinated standards: - Architecture (arc42 + C4): 12 chapters, unchanged - Conceptual Model (OPM ISO 19450): Conceptual-Model - Lifecycle (ISO/IEC/IEEE 15288): four lifecycle pages Validator status (./scripts/validate.sh): V1 — arc42 structural alignment PASS V2 — arc42 build pipeline PASS V3 — Structurizr DSL PASS V4 — CommonMark / GFM PASS (21 files, +6 vs prev) V5 — GitHub-markup rendering PASS (21 files) V6 — OPL syntax PASS (6 OPL files) V7 — OPD/OPL bimodal coherence PASS (6 OPDs) V8 — ISO 15288 process superset PASS (4/4 groups, 30 processes) Build (./scripts/build.sh): Stages 1-5 complete. Stage 5 idempotence holds. Tests (./tests/run-all.sh): test-v6-translator.rb PASS (44 unit tests) test-v7-extractor.rb PASS (11 unit tests) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @afflom afflom committed May 5, 2026