generated from coulomb/repo-seed
chore: add graph explorer make target
This commit is contained in:
21
Makefile
Normal file
21
Makefile
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
PYTHON ?= python3
|
||||||
|
REGISTRY_DB ?= .railiance-fabric/registry.sqlite3
|
||||||
|
HOST ?= 127.0.0.1
|
||||||
|
PORT ?= 8765
|
||||||
|
|
||||||
|
.DEFAULT_GOAL := help
|
||||||
|
|
||||||
|
.PHONY: help graph-explorer registry
|
||||||
|
|
||||||
|
help:
|
||||||
|
@printf "Available targets:\n"
|
||||||
|
@printf " make graph-explorer Start the registry-backed graph explorer on HOST:PORT.\n"
|
||||||
|
@printf " Defaults: HOST=$(HOST), PORT=$(PORT), REGISTRY_DB=$(REGISTRY_DB)\n"
|
||||||
|
@printf " make registry Alias for graph-explorer.\n"
|
||||||
|
|
||||||
|
graph-explorer:
|
||||||
|
@mkdir -p $(dir $(REGISTRY_DB))
|
||||||
|
@echo "Starting Railiance Fabric graph explorer at http://$(HOST):$(PORT)/ui/graph-explorer"
|
||||||
|
$(PYTHON) -m railiance_fabric.server --db "$(REGISTRY_DB)" --host "$(HOST)" --port "$(PORT)"
|
||||||
|
|
||||||
|
registry: graph-explorer
|
||||||
17
README.md
17
README.md
@@ -81,7 +81,22 @@ See `docs/ecosystem-registry-service.md` for the standards comparison and
|
|||||||
service direction for registering repos and interacting with the combined
|
service direction for registering repos and interacting with the combined
|
||||||
ecosystem model. See `docs/registry-api.md` for the current registry HTTP API.
|
ecosystem model. See `docs/registry-api.md` for the current registry HTTP API.
|
||||||
|
|
||||||
Start the first registry service slice with:
|
List available Make targets from the repo root:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
Start the first registry service slice and graph explorer explicitly:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make graph-explorer
|
||||||
|
```
|
||||||
|
|
||||||
|
The target serves `http://127.0.0.1:8765/ui/graph-explorer` by default. Override
|
||||||
|
`PORT`, `HOST`, or `REGISTRY_DB` if the local port or database path differs.
|
||||||
|
|
||||||
|
Equivalent raw command:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
railiance-fabric-registry --db .railiance-fabric/registry.sqlite3 --port 8765
|
railiance-fabric-registry --db .railiance-fabric/registry.sqlite3 --port 8765
|
||||||
|
|||||||
@@ -6,18 +6,38 @@ verified, and how to extract the shared engine once the second adapter is ready.
|
|||||||
|
|
||||||
## Launch
|
## Launch
|
||||||
|
|
||||||
Start the registry against the local SQLite database:
|
List available Make targets from the repo root:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
railiance-fabric-registry --db .railiance-fabric/registry.sqlite3 --port 8765
|
make
|
||||||
```
|
```
|
||||||
|
|
||||||
Open the map:
|
Start the registry-backed graph explorer explicitly:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make graph-explorer
|
||||||
|
```
|
||||||
|
|
||||||
|
This serves the graph explorer at:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
http://127.0.0.1:8765/ui/graph-explorer
|
http://127.0.0.1:8765/ui/graph-explorer
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The target defaults to `.railiance-fabric/registry.sqlite3`, host
|
||||||
|
`127.0.0.1`, and port `8765`. Override those when needed:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make graph-explorer PORT=8876
|
||||||
|
make graph-explorer HOST=0.0.0.0 PORT=8765 REGISTRY_DB=/tmp/railiance-fabric.sqlite3
|
||||||
|
```
|
||||||
|
|
||||||
|
Equivalent raw command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
railiance-fabric-registry --db .railiance-fabric/registry.sqlite3 --port 8765
|
||||||
|
```
|
||||||
|
|
||||||
Useful supporting endpoints:
|
Useful supporting endpoints:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
|
|||||||
44
workplans/ADHOC-2026-06-03.md
Normal file
44
workplans/ADHOC-2026-06-03.md
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
---
|
||||||
|
id: ADHOC-2026-06-03
|
||||||
|
type: workplan
|
||||||
|
title: "Ad Hoc Fixes 2026-06-03"
|
||||||
|
domain: railiance
|
||||||
|
repo: railiance-fabric
|
||||||
|
status: finished
|
||||||
|
owner: codex
|
||||||
|
topic_slug: railiance
|
||||||
|
created: "2026-06-03"
|
||||||
|
updated: "2026-06-03"
|
||||||
|
---
|
||||||
|
|
||||||
|
# ADHOC-2026-06-03 - Ad Hoc Fixes
|
||||||
|
|
||||||
|
## Add Graph Explorer Make Target
|
||||||
|
|
||||||
|
```task
|
||||||
|
id: ADHOC-2026-06-03-T01
|
||||||
|
status: done
|
||||||
|
priority: medium
|
||||||
|
```
|
||||||
|
|
||||||
|
The graph explorer is served by the registry HTTP service, but starting it
|
||||||
|
currently requires remembering the full registry command and database path.
|
||||||
|
|
||||||
|
Add a Makefile target that starts the registry-backed graph explorer from the
|
||||||
|
repo root with defaults for the local database, host, and port. Calling `make`
|
||||||
|
without an explicit target should list available targets rather than start a
|
||||||
|
long-running service. Document the target and available overrides.
|
||||||
|
|
||||||
|
Result: Added `make graph-explorer`, with `registry` as an alias, defaulting to
|
||||||
|
`.railiance-fabric/registry.sqlite3`, `127.0.0.1`, and port `8765`. Plain
|
||||||
|
`make` now prints the available targets instead of starting the service. The
|
||||||
|
target uses `python3 -m railiance_fabric.server`, so it works from the checkout
|
||||||
|
without requiring an installed console script. Updated the README and graph
|
||||||
|
explorer operations guide with the target and override examples.
|
||||||
|
|
||||||
|
Verification:
|
||||||
|
|
||||||
|
- Confirmed plain `make` lists available targets.
|
||||||
|
- Started `make graph-explorer PORT=9877 REGISTRY_DB=/tmp/railiance-fabric-make-test.sqlite3`.
|
||||||
|
- Confirmed `GET http://127.0.0.1:9877/status` returned `status: ok`.
|
||||||
|
- Stopped the temporary verification server on port `9877`.
|
||||||
Reference in New Issue
Block a user