WS MusingsStructured public-interest research
Search
v7.34 development candidate · Architecture & Defensibility

Research System Architecture

WS Musings behaves as a governed research compiler: one versioned substrate supports evidence-led research objects, bounded analytical views, local research workflow, and reproducible public outputs.

Architecture manifestManifest schemaOpen architecture index
Actual governed flow · textual diagram

One substrate, several bounded consumers

  1. 01

    Governed inputs

    Sources, issue records, evidence objects, stakeholder identities, and relationship semantics remain independently addressable.

  2. 02

    Deterministic transformations

    Observatory counts, K=2–7 intersections, Decision Lens comparisons, and the Lighthouse compiler operate on declared stable-ID inputs.

  3. 03

    Canonical Research Object

    One versioned object keeps sourced propositions, calculated views, explicit gaps, provenance, and export identities separate.

  4. 04

    Research surfaces

    The web route, local Workspace, Brief Builder, Open Data, citations, and exports consume the same governed object under explicit contracts.

  5. 05

    Reproducibility controls

    The architecture manifest, BOM, lineage, build fingerprint, impact analysis, and qualification harness make drift inspectable and fail closed.

Interpretation. Arrows represent declared data or consumer dependencies. They indicate potential propagation, not proof that a semantic output changed merely because a generator reran.

Manifest inventory

18 system-defining components

The inventory stays at the architectural level; it does not duplicate the repository file tree or every helper function.

Analytical Transform 3
  • component:v734:decision-transform — Decision Lens deterministic comparison CALCULATED · PUBLIC
  • component:v734:intersection-transform — Intersectionality Studio deterministic set analysis CALCULATED · PUBLIC
  • component:v734:observatory-transform — Insight Observatory deterministic transforms CALCULATED · PUBLIC
Architecture Control 1
  • component:v734:architecture-compiler — Architecture contract compiler BUILD_METADATA · BUILD_ONLY
Canonical Research Object 1
  • component:v734:lighthouse-object — Latinidad Worker Power Lighthouse Research Object MIXED_EXPLICIT_BOUNDARIES · PUBLIC
Export Surface 1
  • component:v734:research-exports — Research object citation and export surfaces MIXED_EXPLICIT_BOUNDARIES · PUBLIC
Generator 1
  • component:v734:lighthouse-compiler — Lighthouse Research Object compiler MIXED_EXPLICIT_BOUNDARIES · BUILD_ONLY
Governed Input 1
  • component:v734:source-governance — Governed source registry SOURCED · PUBLIC
Governed Registry 4
  • component:v734:evidence-registry — Evidence object registry SOURCED · PUBLIC
  • component:v734:issue-registry — Canonical issue registry MIXED_EXPLICIT_BOUNDARIES · PUBLIC
  • component:v734:relationship-registry — Governed issue–stakeholder relationships MIXED_EXPLICIT_BOUNDARIES · PUBLIC
  • component:v734:stakeholder-registry — Canonical stakeholder registry MIXED_EXPLICIT_BOUNDARIES · PUBLIC
Local Private Workspace 1
  • component:v734:workspace-boundary — Research Workspace local privacy boundary USER_LOCAL · LOCAL_PRIVATE
Public Research Surface 3
  • component:v734:architecture-public-surface — Research System Architecture inspector BUILD_METADATA · PUBLIC
  • component:v734:brief-builder — Brief Builder MIXED_EXPLICIT_BOUNDARIES · LOCAL_PRIVATE
  • component:v734:web-research-surface — Static research web surfaces MIXED_EXPLICIT_BOUNDARIES · PUBLIC
Public Static Api 1
  • component:v734:open-data — Static Open Data surface MIXED_EXPLICIT_BOUNDARIES · PUBLIC
Schema 1
  • component:v734:research-object-schema — Canonical Research Object schema BUILD_METADATA · PUBLIC
Integrity contracts

Sourced, calculated, and user-local remain different things

SOURCED

Evidence-backed material keeps evidence/source identity, locator, status, verification scope, and limitations.

CALCULATED

Counts, intersections, and comparisons keep methods, input scope, denominators where applicable, and non-exhaustive boundaries.

USER-LOCAL

Notes, collections, and saved analyses stay in the browser and are excluded from public generated artifacts.

Inspect 10 contract boundaries · Inspect null/unknown semantics · Inspect the provenance contract

Principal architecture test case

The Lighthouse object through the system

research-object:v733:latinidad-worker-power resolves to 1 evidence object, 3 stakeholders, 3 governed relationships, three analytical consumers, a local Workspace/Brief path, a static API, and three public export forms plus canonical JSON.

Lineage graphResearch Object BOMEnd-to-end traceInspect inside the object
Independent verification

Rebuild and detect drift

The reproducibility manifest specifies bounded toolchain requirements, generation and validation commands, expected artifact hashes, and deterministic exceptions without credentials or machine-specific paths.

Fingerprint
6da08b445c054fa9df2dbd508ae014ebd5be3d29c45293ea2f68610f95713932
Algorithm
Canonical sorted UTF-8 JSON + SHA-256
Network required
No
Production status
Not authorized

Reproducibility manifest · Build fingerprint · Change-impact analysis · Generator inventory