UN-GGCE Portal

Appearance

UN-GGCE ToR2 Decision Log (Shared Memory) ​

This document acts as the authoritative record of strategic decisions, architectural pivots, and stakeholder approvals throughout the ToR2 consulting engagement. All agents (systems-architect, geodetic-researcher, risk-analyst, knowledge-graph-engineer, quality-assurance, and technical-writer) MUST read this file to understand the current context and history of the project.

Instructions for Agents ​

  • READ ONLY: Treat this as a source of truth for current project status and strategic direction.
  • DO NOT MODIFY: Only the lead consultant (Human) or the primary orchestrator should update this file after a decision is finalized.

2026-03-23: Project Setup & Infrastructure ​

  • Decision: All OTel telemetry logs will be stored locally on the server drive to avoid Google Drive sync conflicts and maintain a permanent decision trace.
  • Decision: A Context Graph Data Fabric using RDF-Star and SHACL 1.2 will be the primary architecture for tracking and validating the "Robust Global Geodetic Supply Chain."
  • Decision: A specialized technical-writer agent has been created to ensure all deliverables match the formal UN-GGCE style established in the "State of Geodesy 2026" report.
  • Decision: This decisions.md log will serve as the shared "Drop-box" memory for all agents to ensure consistency across the five work assignments.

2026-03-23: Work Assignment 1 - Principles Selection ​

  • Strategic Pivot (QA Mandate): The quality-assurance agent rejected the initial "best-effort" architectural approach. It is now a mandatory requirement that all "Basic Supply Chain" definitions move beyond scientific cooperation to formalized long-term operational agreements (SLAs/MOUs).
  • Strategic Pivot (QA Mandate): All data centres must strictly adhere to FAIR (Findable, Accessible, Interoperable, Reusable) data principles as defined in JDP Objective 1.2.
  • Strategic Pivot (QA Mandate): Workforce resilience, including mandated succession planning and knowledge transfer, is now a non-negotiable PPTD requirement for any observatory or centre to be included in the "critical path."

2026-03-24: Deliverables Portal & CI/CD Pipeline ​

  • Decision: VitePress is the official static site generator for the UN-GGCE Deliverables Portal, providing a high-performance documentation experience.
  • Decision: The portal is deployed via Docker on Google Cloud Run, utilizing a dedicated build/sync pipeline (sync-docs.sh) for rapid deployment of consulting outputs.
  • Decision: All geodetic workflows and capability models must use Mermaid.js syntax enclosed in standard Markdown (.md) files to ensure proper rendering in the portal.
  • Decision: Raw .mmd files in the outputs/ folder are considered source assets and must be mirrored into Markdown wrappers for publication.

2026-03-24: Work Assignment 1 - Document Traceability & Context ​

  • Decision: Renamed the primary guiding principles document from "Part 1" to "Work Assignment 1: Guiding Principles" to accurately reflect the Terms of Reference (ToR2).
  • Decision: Mandated explicit markdown linking for all foundational UN precedents (IGIF, WMO, Sendai) within the deliverables to ensure direct traceability.
  • Decision: Included a broader research appendix in Work Assignment 1 to formally acknowledge the socio-economic impact studies (EUSPA, London Economics), critical infrastructure risk registers (NIST, UK Risk Register), and enterprise architecture standards (TOGAF, DMBOK, FAIR) that informed the baseline assessment.
  • Decision: Updated the technical-writer and geodetic-researcher agents to actively cite this broader library of references and academic research in future outputs.
  • Decision: Created the "Investment Prioritization and Risk Rubric" (1b_investment_rubric.md) to operationalize the guiding principles. The risk-analyst and roadmap-planner agents have been updated to strictly use this rubric for evaluating gaps and sequencing investment recommendations based on existential risk mitigation.
  • Decision: Conducted a comprehensive scan and download of the primary strategic artifacts from the UN-GGCE website (Strategy and Operating Plan, 1st JDP, Needs Assessment, Hidden Risk Report). These documents have been added to the ./docs directory to serve as the authoritative grounding context for all agent research and drafting activities.

2026-03-25: Geodetic Terminology, Mathematical Prioritization, & Data Provenance ​

  • Decision: Adopted IAG/GGOS Authoritative Terminology: Shifted from IT-centric "nodes" to geodetic "observatories" and "centres" across all documents, reflecting the terminology of the International Association of Geodesy (IAG) and the Global Geodetic Observing System (GGOS). geodesy.science is now the ultimate grounding source for all agents.
  • Decision: Mathematical Translation of the Rubric (Agent Handoff): Documented the explicit mathematical algorithm (Weighted Gap Analysis + Network Criticality Multiplier) in data/mathmatical_rubric.md to translate qualitative PPTD scores into a sequenced JDP roadmap. This establishes a clear workflow: the risk-analyst evaluates the PPTD gap, the knowledge-graph-engineer maps the network topology (EGV bottlenecks, co-location, scarcity), and the roadmap-planner uses SPARQL to compute the Final_Investment_Priority.
  • Decision: W3C PROV-O Implementation for UN Traceability: Upgraded the observatories.json dataset to JSON-LD with strict W3C PROV Ontology tracking (ggsc:provenance). The geodetic-researcher and extraction scripts now log exact source URLs and timestamps for every metadata point (from ITRF, IGS, IVS, ILRS). This ensures the quality-assurance agent can validate all infrastructure data against UN transparency mandates.
  • Decision: Consolidated Core Observatory Network: Refined the raw instrument data into 664 unique physical observatories. Identified 107 "Core Sites" based on GGOS co-location criteria (3+ techniques) and ITRF/IGS official core network designations. Published an interactive component (ObservatoryTable.vue) to the portal for stakeholders to explore this validated infrastructure.
  • Decision: Capability Model Visualization: Replaced the wide, difficult-to-read Mermaid rendering of the Capability Model with a responsive, CSS-grid-based HTML layout directly within Markdown to vastly improve readability on the portal.

2026-03-27: Infrastructure Migration ​

  • Decision: The UN-GGCE Deliverables Portal (Cloud Run instance) has been successfully migrated to the ben@risemarketing.com.au account under the rise-infrastructure-491413 project. The new authoritative deployment URL is https://un-ggce-portal-d2zfxnoqxa-uc.a.run.app. This consolidates the portal hosting under the Rise Marketing infrastructure as requested by the Sysadmin agent.

2026-03-26: EGV-Specific Supply Chain Modeling (Satellite Orbits) ​

  • Decision: EGV-Specific Risk Mapping: Decided to model supply chain risks at the individual Essential Geodetic Variable (EGV) level (starting with GNSS Satellite Orbits) rather than a monolithic view, recognizing that an observatory's criticality varies significantly depending on the specific product pipeline it supports.
  • Decision: 4-Tier Architecture Decomposition: Restructured the Satellite Orbits workflow into four explicit tiers (Tier 0: Acquisition, Tier 1: Archiving, Tier 2: Analysis Centers & Software, Tier 3: Combination & Distribution) to accurately pinpoint institutional and technological bottlenecks.
  • Decision: Software Diversity vs. Maintenance Risk: Formally documented that while the Analysis Center layer is algorithmically secure due to software diversity (Bernese, GipsyX, NAPEOS, PANDA, EPOS.P8), it carries a High "Key Person" maintenance risk due to reliance on niche academic teams.
  • Decision: Identification of Critical Bottlenecks: Identified the Analysis Center Coordinator (ACC) and the SPOCC combination engine workflow is classified as a "High Risk" bottleneck due to process/governance vulnerability, explicitly validated by historical U.S. government shutdowns (2013, 2018-2019).
  • Decision: Stakeholder Accountability Matrix: Shifted workflow documentation from purely institutional to human-centric accountability. Key personnel within the IGS Central Bureau (JPL), Infrastructure Committee (GFZ, EarthScope, CDDIS), and SPOCC development team (GFZ) are now explicitly mapped to their respective supply chain tiers to highlight "Key Person" dependencies.

2026-04-23: Network Operations & Global Network Monitoring Gap ​

  • Strategic Finding: A longitudinal review of the IGS Technical Reports (2013 and 2018) revealed widespread failure across major Analysis Centers, Global Data Centers (SIO, IGN, KASI), and critical Working Groups (e.g., Reference Frame) to submit annual reports.
  • Mapping to Capability Model: This administrative and reporting fragility has been formally mapped as a direct symptom of the low maturity score (2.3) in the "Network Operations" capability.
  • Impact on Supply Chain: The inability to consistently document and report on system health signifies a critical gap in Global Network Monitoring. While data may continue to flow (technical resilience), the lack of systematic monitoring and administrative reporting blinds the supply chain to creeping degradation and capacity constraints, reinforcing the necessity for formalized Service Level Agreements (SLAs).

2026-04-28: QA Review - Work Assignment 2 (EGV Workflow Modeling) ​

  • Finding (Positive) - EGV Progression & Tone: The narrative workflow reports (outputs/itrf_workflow_description.md, outputs/eop_workflow_description.md, outputs/icrf_workflow_description.md, outputs/global_gravity_model_workflow_description.md) excellently model the progression from Level 0 to Level 3 EGVs. Institutional mappings and bottleneck analyses correctly identify Single Points of Failure (e.g., VLBI correlation, ITRS Product Center at IGN) and align perfectly with ToR2 expectations. The professional tone meets UN-GGCE standards.
  • Finding (Positive) - DataBook Adherence: The draft DataBooks (data/shacl/*-workflow.databook.md) correctly implement v0.9 standards, utilizing PROV-O (prov:Activity, prov:wasAssociatedWith) to model the multi-tier supply chains as directed.
  • Remediation Completed - Capability Linking: The DataBooks now explicitly bind to the 59 Phase 1 capability instances in data/ontology/ggsc-capabilities.ttl (e.g., ggsc-cap:VLBIDataAcquisition, ggsc-cap:GeodeticDataProcessing).
  • Remediation Completed - Vendor Neutrality: The process metadata block in the DataBooks has been generalized to use "UN-GGCE LLM Pipeline" and "urn:ggsc:pipeline:llm-v1", complying with the strict vendor-agnostic architecture principle.
  • Remediation Completed - Evidence Traceability: The DataBooks have been updated to include prov:wasDerivedFrom links pointing to authoritative IAG/GGOS primary sources and local narrative descriptions, satisfying the Zero Hallucination and Evidence Mandate.
  • DataBook Approval Gate Status: APPROVED. All remediation items have been successfully addressed. Final sign-off is granted for graph database load.