From 8f6cb694adddb2c03a1cbecddc1e4c24f0998196 Mon Sep 17 00:00:00 2001 From: tegwick Date: Tue, 7 Jul 2026 01:34:42 +0200 Subject: [PATCH] Replace stale repo-seed template README with a real one Written from SCOPE.md/INTENT.md and direct source inspection. Requested during reuse-surface REUSE-WP-0017-T05 review follow-up. Co-Authored-By: Claude Sonnet 5 --- README.md | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fcd7b8f..0e27c33 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,37 @@ -# repo-seed +# vantage-point -A git repository template to bootstrap coulomb projects from. \ No newline at end of file +Generic system for exploring, analyzing, and reasoning about dependency +structures across arbitrary domains, treated as **Network-Based Graph +Models (NBGM)** — typed graphs of entities (nodes) and relationships +(edges) enriched with attributes, provenance, and semantics. + +Vantage Point is a **multi-perspective exploration environment**: the same +underlying graph can be viewed from different "vantage points" to answer +domain-specific questions, rather than binding one fixed visualization or +domain vocabulary to the model. The vocabulary is grounded in Tamara +Munzner's nested design model and the NBGM framing from Meyer, Sedlmair, +and Munzner (BELIV 2012). + +## Status + +**Specification stage — no implementation yet.** `docs/nbgm-spec-v0.1.md` +is a substantial (670-line) draft baseline defining core identity/typing +rules for nodes and edges, the attribute model and namespaces, provenance +and lineage, a baseline catalog of inspection operations, and alignment +notes for repo-native graph bindings (e.g. Railiance Fabric). Storage +engines, query languages, visualization encodings, and domain-specific +type catalogs are explicitly out of scope for v0.1. + +## Getting oriented + +- **Intent:** `INTENT.md` — full rationale and grounding in the NBGM + research literature +- **Scope and boundaries:** `SCOPE.md` +- **The spec:** `docs/nbgm-spec-v0.1.md` +- **Build history:** `workplans/` + +## In scope + +NBGM specs, registry, and exploratory docs; State Hub workplans for graph +exploration features; alignment with `repo-scoping` and `railiance-fabric` +graph models. See `SCOPE.md` for the full in/out-of-scope breakdown.