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>