Add S-CORE v1.0 roadmap, release-gate docs, and overall-status SKILL (#230)

* improve ref integration documentation

* Fix CI: write quality reports to docs/verification_report

The path docs/s_core_v_1/verification did not exist and was not created,
causing the unit-test/coverage script to crash with FileNotFoundError.
Use the existing docs/verification_report directory (and create it if
missing) for both the script output and the workflow summary step.

* docs: add missing pages to root toctree

Sphinx (warnings-as-errors) failed because
docs/s_core_v_1/index.rst and docs/verification_report/platform_verification_report.rst
were referenced via grid-cards but not listed in any toctree.

* docs(roadmap): refresh overall_status against pinned score ref

- Repin score from 5b8a1e34 to 1b51518e (81 source-link URLs)
- Baselibs PA3 Component Architecture: 164/166 -> 165/167

skill(overall-status): clean up and fix checklist counter

- Restructure SKILL.md (1063 -> 517 lines): drop migration notes,
  duplicated callouts, and the empty 'Complete RST Snapshot' section.
- Specify counting model in plain prose (no formulas).
- Fix count_checklist_status: chklst_*.rst stores :status: indented
  inside the .. document:: block, not at column 0. Updated section
  3.3 and the Step-2 helper accordingly.

* docs(roadmap): add per-PA release-progress SVG figures and document generation in SKILL

- Add docs/_assets/pa{2,3,4,5}_*.svg charts showing release evolution
  (v0.5.0-beta -> v0.6.0 -> v0.7.0 -> current main) above each PA
  module-tracker table in overall_status.rst.
- Embed via .. figure:: directives with alt text and width.
- Extend .github/skills/overall-status/SKILL.md (sec. 6a) with:
  - release pinning recipe (annotated-tag deref, known_good schema diffs,
    'now' = known_good.json on main of reference_integration)
  - per-chart metric table and SVG generation workflow
  - Communication vs. Some/IP double-count guard (applies to all PAs)
  - rule that charts use TOTAL directive count, not valid-only
  - PA5 split: historical bars from TEST-macro regex, 'now' bar from
    PA5 RST table column sums; documented divergences.

* docs(overall_status): refine PA1/PA5 layout, add platform-ver admonition, fix label warnings

- PA1: render FR issue titles next to the issue number; restrict #549
  to Baselibs; add #757 'qualified json-parser' to Baselibs (no
  milestone); drop #914/#917 from Communication (local IPC scope only)
- PA5: drop per-module Platform Ver. Rpt column; add prominent
  Platform Verification Report admonition after the table
- PA5: split test counts onto a separate line-block line below the
  status emoji
- PA5: add reader notes for C0/C1 coverage source and Static/Dynamic
  analysis semantics
- Add cross-reference labels (overall_status_pa2..pa5) to fix six
  Sphinx 'undefined label' warnings from pi1/pi2/pi3
- custom.css: neutralise blockquote/line-block styling inside list
  tables so secondary lines blend into the cell; style new
  .platform-ver-report admonition

Sphinx build now reports 0 warnings, 0 errors.
SKILL.md updated to document all of the above (sections 4.0, 4.2,
5.0, 5.1, 5.2).

* docs: mark overall_status as AI-generated and indicative

* docs(overall_status): enlarge status headings and add rollout progress bar

- Style 'Process Status' rubrics with new .status-heading class for larger,
  bolder appearance.
- Replace 'Implementation status: ...' rubrics with an inline 'Rollout status'
  row containing label, percentage, progress bar and detail text in one line.
- Add corresponding CSS in docs/_assets/custom.css (.status-heading,
  .impl-status-row and .impl-status-bar/.impl-status-fill).

* docs(roadmap): add Planning Approach page

- New planning_approach.rst summarising how v1.0 is planned: GitHub project,
  Product Increment tickets per Feature Team / Community mapped to milestones,
  sub-tickets and the GitHub project's process area attribute for grouping.
- Link to the authoritative Platform Management Plan as primary reference.
- Add the page to the roadmap toctree (after Overall Status).

* docs(roadmap): refine PI1 work breakdown for Release Gate v0.8

- Clarify automation checks are part of docs-as-code toolchain (//:docs)
- Add CI/CD workflow item for requirement/architecture validation
- Add inspection checklist completion item with team and process area
- Add Module Verification Report completion item (pa5_verification)
- Add outstanding implementation tickets item (pa4_impl)
- Replace 'component' attribute references with 'team'
- Remove Feasibility Check section

* docs(pi1): expand v0.8 work breakdown with TL-circle review and unified Bazel targets

* docs(roadmap): add platform/toolchain bullet, ref-int integration item, and Terminology section

* Address SKILL.md review findings (PR #230)

- Fix --paginate being embedded in URL string; pass it as a real CLI flag
- Renumber duplicate ### 5.4 (Rollout status row) to ### 5.5
- Fix stray 'e|' prefix on the PA5 Static Analysis row
- Add overall_status_pa1 to the required-labels list (§5.0)
- Clarify in §3.4 that the per-cell LOC uses the §6a.2 byte÷30 method
- Document why the Time keyword in KW_FALLBACK has a leading space

* Add overall_status_pa1 anchor to overall_status.rst (PR #230)

Matches the PA2-PA5 pattern so :ref:`overall_status_pa1` from PI pages
resolves without warnings.

* Fix four obvious bugs from PR #230 review (#256)

* Fix four obvious bugs found in review of PR #230

- SKILL.md §6 Step 6: stale §5.4 cross-reference updated to §5.5 after
  the Rollout status heading was renumbered (§5.4 is now Pie chart row)
- SKILL.md comp_req_cell(): trlc=True with both counts zero returned
  "✅ Available (0/0 comp_req [TRLC])" instead of "❌ Open" because the
  zero-guard only fired when parts was empty, but trlc forced a part entry;
  fix: check ct==0 and at==0 unconditionally before building parts
- SKILL.md §6a.2: count_directives() was referenced but never defined;
  replaced with count_directives_with_status(...)[1]
- quality_runners.py: zip() paired unit-test and coverage dicts by
  position, silently dropping rust coverage exit codes beyond the first
  module; replaced with a flat check over the merged dict

* style: collapse any() to single line to satisfy ruff

* Address remaining PR #230 review findings

- §1: clarify NM and Diagnostic Services are PA1-only (no own repo,
  no known_good.json key); their PA2-PA5 cells render ❌ Open by
  design and they contribute 0 to the per-PA progress charts.
- §2: cross-reference note explaining why no rows exist for them
  and what to do once their repos are created.
- §4 PA5: drop the orphaned 5th pipe column on the Static Analysis
  row (silently dropped by Markdown renderers); promote the
  no-link discipline note to a blockquote below the table covering
  both Static and Dynamic Analysis.

* Roadmap: add Safety Analysis and Safety Management to Qualifiable State

Addresses PR #230 review comments by @aschemmel-tech and @masc2023:

- Add **Safety Analysis** to the mandatory process areas list — it is
  already highlighted (blue) in the Development grid below, the prose
  list was inconsistent.
- Add **Safety Management** to the mandatory list and switch its
  Management-grid card from card-pa-grey to card-pa-highlight. Safety
  Management produces the safety manuals and the safety (release)
  package required for qualification, so it is a mandatory condition
  for the Qualifiable State.
- Add a short rationale paragraph explaining why both PAs are
  mandatory.

---------

Co-authored-by: Alexander Lanin <Alexander.Lanin@etas.com>

Author: antonkri

.github/skills/overall-status/SKILL.md

@@ -0,0 +1,295 @@
+/* *******************************************************************************
+ * Copyright (c) 2026 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * *****************************************************************************/
+
+/* ---------------------------------------------------------------------------
+ * Compact process-area overview tables (used in feature_and_process_status.rst)
+ * ---------------------------------------------------------------------------*/
+
+.compact-overview-wrapper {
+    overflow-x: auto;
+}
+
+.compact-overview-table td:nth-child(1),
+.compact-overview-table th:nth-child(1),
+.compact-overview-table td:nth-child(5),
+.compact-overview-table th:nth-child(5),
+.compact-overview-table td:nth-child(6),
+.compact-overview-table th:nth-child(6) {
+    text-align: center;
+    vertical-align: middle;
+}
+
+.compact-overview-table {
+    width: 100%;
+    table-layout: fixed;
+    max-width: 100%;
+}
+
+.compact-overview-table td {
+    width: 33%;
+    overflow: hidden;
+}
+
+.compact-overview-table td:has(img[id^="needpie-"]) {
+    vertical-align: middle;
+    text-align: center;
+}
+
+/* Override the fixed pixel size sphinx-needs writes into the img attributes */
+.small-pie-cell img,
+.compact-overview-table td img,
+img[id^="needpie-"] {
+    width: 100% !important;
+    max-width: 100% !important;
+    height: auto !important;
+    display: block;
+    margin: 0 auto;
+}
+
+/* ---------------------------------------------------------------------------
+ * Module phase tracker table (also used in feature_and_process_status.rst)
+ * ---------------------------------------------------------------------------*/
+
+.module-phase-tracker-table td,
+.module-phase-tracker-table th {
+    vertical-align: middle;
+    white-space: nowrap;
+}
+
+.module-phase-tracker-table td:first-child {
+    font-weight: 600;
+}
+
+/* ---------------------------------------------------------------------------
+ * Wide content area: pages that opt in via a `wide-content-page` body class
+ * get a full-width article container.
+ * ---------------------------------------------------------------------------*/
+
+body.wide-content-page .bd-content .bd-article-container {
+    max-width: 100%;
+}
+
+/* ---------------------------------------------------------------------------
+ * Process-area cards (used in roadmap.rst — Qualifiable State section)
+ * ---------------------------------------------------------------------------*/
+
+.card-pa-grey {
+    background-color: #e8e8e8 !important;
+    border-color: #c8c8c8 !important;
+    font-size: 0.82rem;
+}
+
+.card-pa-grey .sd-card-header {
+    background-color: #e8e8e8 !important;
+    border-color: #c8c8c8 !important;
+    font-size: 0.82rem;
+    font-weight: 600;
+    padding: 0.4rem 0.6rem;
+}
+
+.card-pa-grey .sd-card-body {
+    background-color: #e8e8e8 !important;
+    color: #444;
+    padding: 0.4rem 0.6rem;
+    font-size: 0.78rem;
+}
+
+/* Thin border around each process-area grid group (Management / Development / Support) */
+.score-grid {
+    border: 1px solid #c0c8d4;
+    border-radius: 6px;
+    padding: 0.6rem 0.6rem 0.2rem 0.6rem;
+    margin-bottom: 1.2rem;
+}
+
+/* Compact card grid (Management section) — approximately half the visual size */
+.score-grid-compact .sd-card {
+    min-height: unset;
+}
+
+.score-grid-compact .sd-card-header {
+    padding: 0.2rem 0.35rem !important;
+    font-size: 0.68rem !important;
+}
+
+.score-grid-compact .sd-card-body {
+    padding: 0.2rem 0.35rem !important;
+    font-size: 0.62rem !important;
+}
+
+/* Highlighted process-area cards (Requirements Engineering, Architecture Design,
+   Implementation, Verification) */
+.card-pa-highlight {
+    background-color: #1a5fa8 !important;
+    border-color: #134a87 !important;
+    font-size: 0.82rem;
+}
+
+.card-pa-highlight .sd-card-header {
+    background-color: #1a5fa8 !important;
+    border-color: #134a87 !important;
+    font-size: 0.82rem;
+    font-weight: 600;
+    padding: 0.4rem 0.6rem;
+    color: #ffffff !important;
+}
+
+.card-pa-highlight .sd-card-header a,
+.card-pa-highlight .sd-card-header a:visited {
+    color: #ffffff !important;
+}
+
+.card-pa-highlight .sd-card-body {
+    background-color: #1a5fa8 !important;
+    color: #e8f0fc !important;
+    padding: 0.4rem 0.6rem;
+    font-size: 0.78rem;
+}
+
+/* ---------------------------------------------------------------------------
+ * Landing-page grid cards (docs/index.rst): white text, original background.
+ * ---------------------------------------------------------------------------*/
+
+.landing-grid .sd-card *,
+.landing-grid .sd-card a,
+.landing-grid .sd-card a:visited,
+.landing-grid .sd-card a:hover {
+    color: #ffffff !important;
+}
+
+/* ---------------------------------------------------------------------------
+ * RST line-blocks inside list-tables (used in overall_status.rst PA cells):
+ * Sphinx wraps the indented "| ..." continuation in a <blockquote>, which
+ * adds a left border and a tinted background. Inside a status table we want
+ * those secondary lines (test counts, coverage values, links) to look like
+ * regular text — same color, no border, no inset background.
+ * ---------------------------------------------------------------------------*/
+
+table.docutils blockquote,
+table blockquote {
+    margin: 0 !important;
+    padding: 0 !important;
+    border: none !important;
+    background: transparent !important;
+    box-shadow: none !important;
+}
+
+table.docutils blockquote > div,
+table blockquote > div {
+    margin: 0 !important;
+    padding: 0 !important;
+}
+
+table.docutils .line-block,
+table .line-block {
+    margin: 0 !important;
+    padding: 0 !important;
+    border: none !important;
+    background: transparent !important;
+}
+
+table.docutils .line-block .line,
+table .line-block .line {
+    margin: 0 !important;
+    padding: 0 !important;
+    border: none !important;
+    background: transparent !important;
+}
+
+/* ---------------------------------------------------------------------------
+ * Platform Verification Report admonition (overall_status.rst PA5):
+ * make this single project-wide deliverable visually prominent.
+ * ---------------------------------------------------------------------------*/
+
+.admonition.platform-ver-report {
+    font-size: 1.15rem;
+    border-left: 6px solid #1a5fa8;
+    background-color: #eef4fb;
+    padding: 0.8rem 1rem;
+    margin: 1.2rem 0;
+}
+
+.admonition.platform-ver-report > .admonition-title {
+    font-size: 1.25rem;
+    font-weight: 700;
+    color: #1a5fa8;
+    margin-bottom: 0.3rem;
+}
+
+.admonition.platform-ver-report p {
+    margin: 0;
+    font-size: 1.1rem;
+}
+
+/* ---------------------------------------------------------------------------
+ * Process / Implementation status headings (overall_status.rst):
+ * make rubric headings visually larger, and render the implementation
+ * status as a single inline row with a progress bar.
+ * ---------------------------------------------------------------------------*/
+
+p.rubric.status-heading,
+.rubric.status-heading {
+    font-size: 1.35rem;
+    font-weight: 700;
+    margin-top: 1.2rem;
+    margin-bottom: 0.6rem;
+    color: #1a5fa8;
+}
+
+.impl-status-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 0.6rem;
+    font-size: 1.35rem;
+    font-weight: 700;
+    color: #1a5fa8;
+    margin: 1.2rem 0 0.8rem 0;
+}
+
+.impl-status-row .impl-status-label {
+    white-space: nowrap;
+}
+
+.impl-status-row .impl-status-icon {
+    font-size: 1.25rem;
+}
+
+.impl-status-row .impl-status-percent {
+    min-width: 3.5rem;
+    text-align: right;
+}
+
+.impl-status-row .impl-status-bar {
+    flex: 1 1 200px;
+    min-width: 160px;
+    max-width: 360px;
+    height: 14px;
+    background-color: #e3e8ef;
+    border: 1px solid #c0c8d4;
+    border-radius: 7px;
+    overflow: hidden;
+}
+
+.impl-status-row .impl-status-fill {
+    height: 100%;
+    background: linear-gradient(90deg, #1a5fa8 0%, #4a90d9 100%);
+    border-radius: 6px 0 0 6px;
+}
+
+.impl-status-row .impl-status-detail {
+    font-size: 1rem;
+    font-weight: 500;
+    color: #444;
+    white-space: nowrap;
+}