generated from coulomb/repo-seed
tegwick
8f6cb694ad
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 <noreply@anthropic.com>
38 lines
1.6 KiB
Markdown
38 lines
1.6 KiB
Markdown
# vantage-point
|
|
|
|
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.
|