graphvault-studio 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.2
+
+- Publish the Studio CLI under the unscoped `graphvault-studio` npm package name for a reliable `npx graphvault-studio` install path.
+
+## 0.1.1
+
+- Patch npm package metadata so the `graphvault-studio` CLI binary is preserved on publish.
+
+## 0.1.0
+
+- Initial GraphVault Studio package.
+- Embedded graphical admin client for GraphVault stores.
+- Root hierarchy browser, parent path lookup, search, graph view, paged object listing, verification, backup, maintenance, transactions, and journal views.
+- Controlled primitive-field editing with mutation preview and optional confirmation token.
+- CLI and programmatic server startup.

package/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+Thanks for helping improve GraphVault Studio.
+
+## Local Development
+
+```bash
+npm ci
+npm test
+```
+
+`npm test` builds the TypeScript sources and runs a smoke test against a generated GraphVault store. It verifies the admin client, search, store verification, and the embedded HTTP API.
+
+## Pull Request Checklist
+
+- keep admin modules focused and avoid growing one large UI or server file unnecessarily
+- preserve generic object graph wording rather than app-specific language
+- check narrow and wide layouts when changing the embedded UI
+- add or update a smoke test when API behavior changes
+- run `npm test` before opening the PR
+
+## Release Checklist
+
+1. Update `CHANGELOG.md`.
+2. Run `npm test`.
+3. Run `npm run pack:dry-run` and inspect the packaged files.
+4. Publish with an npm account that owns `graphvault-studio`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# GraphVault Studio
+
+[![CI](https://github.com/Sprengmeister-dev/graphvault-studio/actions/workflows/ci.yml/badge.svg)](https://github.com/Sprengmeister-dev/graphvault-studio/actions/workflows/ci.yml)
+![Node](https://img.shields.io/badge/node-%3E%3D20-3c7a52)
+![TypeScript](https://img.shields.io/badge/TypeScript-first-315c92)
+![License](https://img.shields.io/badge/license-MIT-2f2f2f)
+
+GraphVault Studio is the graphical admin client for [GraphVault](https://github.com/Sprengmeister-dev/graphvault-library) stores. It lets you inspect, search, verify, maintain, back up, and carefully edit object graph data without pretending the store is a table database.
+
+![GraphVault Studio screenshot](./assets/studio-screenshot.png)
+
+```bash
+git clone https://github.com/Sprengmeister-dev/graphvault-studio.git
+cd graphvault-studio
+npm ci
+npm run demo:store
+npx graphvault-studio --dir ./graphvault-studio-demo-store --port 4177 --allow-mutations --confirm-token confirm
+```
+
+Open `http://127.0.0.1:4177` and try the search, hierarchy, parent path, GVQL, verification, and editable-field flows against a real demo object graph.
+
+## Why Not Just Use A Normal Database Admin Tool?
+
+Database admin tools are great when your data is records, rows, documents, or key-value entries. GraphVault stores a live object graph: a root object, nested structures, references, shared children, multiple parents, class metadata, transactions, manifests, and object records. A normal SQL or document browser cannot show that shape honestly.
+
+Studio is useful when you need to answer questions like:
+
+- what object is this reference pointing to?
+- how do I get from this object back to the root?
+- which parents directly reference this object?
+- what did the latest transaction write?
+- does the store verify cleanly?
+- can I make a small controlled data correction without hand-writing field paths and JSON?
+
+It is deliberately generic. It does not assume customers, orders, tickets, CMS pages, or any other application domain. It works with object paths, values, types, references, transactions, and graph relationships.
+
+## Features
+
+- root-first hierarchy browser
+- search across encoded paths and values
+- parent path lookup from object to root
+- support for objects with multiple direct parents
+- paged object browser for large stores
+- graph edge view
+- GVQL query console for graph queries and batch-update previews
+- editable primitive fields with preview and confirmation-token safety
+- verification, maintenance, backup, transaction and journal views
+- optional bearer-token protection
+- zero frontend build step; the UI is embedded in the TypeScript package
+
+## Install
+
+From npm:
+
+```bash
+npm install graphvault-studio
+```
+
+GraphVault Studio requires Node.js 20 or newer. The npm package is scoped, but the executable remains the short `graphvault-studio` command.
+
+## Run
+
+### Demo Store
+
+Create a realistic demo store with shared owners, categories, document links, tags, dates, metrics, and multiple parent paths:
+
+```bash
+npm run demo:store
+npx graphvault-studio --dir ./graphvault-studio-demo-store --port 4177 --allow-mutations --confirm-token confirm
+```
+
+### File-Based Store
+
+The CLI reads a local GraphVault storage directory. This is the common setup for a service, desktop app, or local development environment.
+
+```bash
+npx graphvault-studio --dir ./data --port 4177
+```
+
+Mutation APIs are opt-in:
+
+```bash
+npx graphvault-studio \
+  --dir ./data \
+  --port 4177 \
+  --allow-mutations \
+  --confirm-token confirm
+```
+
+Optional auth:
+
+```bash
+GRAPHVAULT_ADMIN_TOKEN=secret npx graphvault-studio --dir ./data
+```
+
+Then open:
+
+```text
+http://127.0.0.1:4177
+```
+
+## Documentation
+
+- [GVQL examples](./docs/GVQL.md) - ready-to-run query and mutation-preview examples for Studio.
+- [Remote and custom storage](./docs/REMOTE_STORAGE.md) - programmatic server setup with HTTP, S3-compatible, SQL, or custom targets.
+- [Release notes](./docs/RELEASE_NOTES_0.1.0.md) - package overview for the first public release.
+- [Publishing checklist](./docs/PUBLISHING.md) - local release checks, tagging, npm provenance, and GitHub topics.
+
+## Relationship To GraphVault Library
+
+The storage engine lives in [graphvault-library](https://github.com/Sprengmeister-dev/graphvault-library). Studio is intentionally separate so applications can depend on the lightweight persistence library without bundling an admin UI.
+
+## Developer Notes
+
+- Studio is a pure TypeScript package with no frontend build toolchain.
+- The UI is served from the embedded admin server, so `npx graphvault-studio --dir ./data` is enough to inspect a store.
+- The package depends on GraphVault Library for storage layout, verification, parent index reading, and storage targets.
+- Run `npm test` to type-check, emit `dist/`, create a real store, exercise the admin client, and verify the embedded HTTP API.
+- CI runs on Node.js 20 and 22.

package/dist/admin-cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+export interface ParsedAdminCliArgs {
+    storageDirectory?: string;
+    host: string;
+    port: number;
+    allowMutations: boolean;
+    authToken?: string;
+    mutationConfirmToken?: string;
+    help: boolean;
+}
+export declare function parseAdminCliArgs(argv: readonly string[], env?: NodeJS.ProcessEnv): ParsedAdminCliArgs;
+export declare function adminCliHelp(): string;

package/dist/admin-cli.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import { startAdminServer } from "./admin-server.js";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 4177;
+export function parseAdminCliArgs(argv, env = process.env) {
+    const parsed = {
+        host: DEFAULT_HOST,
+        port: DEFAULT_PORT,
+        allowMutations: false,
+        help: false,
+    };
+    if (env["GRAPHVAULT_ADMIN_TOKEN"]) {
+        parsed.authToken = env["GRAPHVAULT_ADMIN_TOKEN"];
+    }
+    if (env["GRAPHVAULT_ADMIN_CONFIRM_TOKEN"]) {
+        parsed.mutationConfirmToken = env["GRAPHVAULT_ADMIN_CONFIRM_TOKEN"];
+    }
+    for (let index = 0; index < argv.length; index++) {
+        const arg = argv[index];
+        if (arg === "--help" || arg === "-h") {
+            parsed.help = true;
+            continue;
+        }
+        if (arg === "--allow-mutations") {
+            parsed.allowMutations = true;
+            continue;
+        }
+        if (arg === "--dir" || arg === "--storage-directory") {
+            parsed.storageDirectory = readValue(argv, ++index, arg);
+            continue;
+        }
+        if (arg === "--host") {
+            parsed.host = readValue(argv, ++index, arg);
+            continue;
+        }
+        if (arg === "--port") {
+            parsed.port = parsePort(readValue(argv, ++index, arg));
+            continue;
+        }
+        if (arg === "--token" || arg === "--auth-token") {
+            parsed.authToken = readValue(argv, ++index, arg);
+            continue;
+        }
+        if (arg === "--confirm-token" || arg === "--mutation-confirm-token") {
+            parsed.mutationConfirmToken = readValue(argv, ++index, arg);
+            continue;
+        }
+        throw new Error(`Unknown option: ${arg}`);
+    }
+    return parsed;
+}
+export function adminCliHelp() {
+    return [
+        "Usage: graphvault-admin --dir <storage-directory> [options]",
+        "",
+        "Options:",
+        "  --dir, --storage-directory <path>      Storage directory to inspect.",
+        "  --host <host>                         Host to bind. Defaults to 127.0.0.1.",
+        "  --port <port>                         Port to bind. Defaults to 4177.",
+        "  --token, --auth-token <token>         Bearer token for UI/API access.",
+        "  --confirm-token <token>               Token required to commit mutations.",
+        "  --allow-mutations                     Enable maintenance and data mutation APIs.",
+        "  -h, --help                            Show this help.",
+        "",
+        "Environment:",
+        "  GRAPHVAULT_ADMIN_TOKEN                Default bearer token.",
+        "  GRAPHVAULT_ADMIN_CONFIRM_TOKEN        Default mutation confirmation token.",
+    ].join("\n");
+}
+async function main(argv) {
+    const options = parseAdminCliArgs(argv);
+    if (options.help) {
+        console.log(adminCliHelp());
+        return;
+    }
+    if (!options.storageDirectory) {
+        throw new Error("Missing required --dir <storage-directory> option.");
+    }
+    const serverOptions = {
+        storageDirectory: options.storageDirectory,
+        host: options.host,
+        port: options.port,
+        allowMutations: options.allowMutations,
+    };
+    const running = await startAdminServer({
+        ...serverOptions,
+        ...(options.authToken ? { authToken: options.authToken } : {}),
+        ...(options.mutationConfirmToken ? { mutationConfirmToken: options.mutationConfirmToken } : {}),
+    });
+    console.log(`GraphVault Studio: ${running.url}`);
+    console.log(`Storage directory: ${options.storageDirectory}`);
+    console.log(`Mutations: ${options.allowMutations ? "enabled" : "disabled"}`);
+    if (options.authToken) {
+        console.log("Auth: bearer token required");
+    }
+    if (options.mutationConfirmToken) {
+        console.log("Mutation confirmation: required");
+    }
+    let closing = false;
+    const close = () => {
+        if (closing) {
+            return;
+        }
+        closing = true;
+        void running.close().finally(() => process.exit(0));
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+}
+function readValue(argv, index, option) {
+    const value = argv[index];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`Missing value for ${option}.`);
+    }
+    return value;
+}
+function parsePort(value) {
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`Invalid port: ${value}`);
+    }
+    return port;
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main(process.argv.slice(2)).catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(adminCliHelp());
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=admin-cli.js.map

package/dist/admin-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-cli.js","sourceRoot":"","sources":["../src/admin-cli.ts"],"names":[],"mappings":"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"}

package/dist/admin-client.d.ts

@@ -0,0 +1,49 @@
+import type { BackupResult, MaintenanceResult, ObjectRecord, StorageTarget, TransactionRecord, TypeDictionary, VerificationResult } from "@sprengmeister/graphvault/internal/core/types";
+import type { GvqlExecutionOptions, GvqlResult } from "@sprengmeister/graphvault/internal/gvql/gvql";
+import type { AdminGraph, AdminHierarchyPath, AdminMutation, AdminMutationPreview, AdminObjectChild, AdminObjectListItem, AdminObjectPage, AdminRootReference, AdminSearchResult, AdminSummary, StorageAdminClientOptions } from "./admin-types.js";
+export type { AdminGraph, AdminGraphEdge, AdminGraphNode, AdminHierarchyPath, AdminHierarchyPathItem, AdminMutation, AdminMutationPreview, GvqlResult, AdminObjectChild, AdminObjectListItem, AdminObjectPage, AdminObjectParent, AdminRootReference, AdminSearchResult, AdminSummary, StorageAdminClientOptions, } from "./admin-types.js";
+export declare class StorageAdminClient {
+    private readonly options;
+    private readonly target;
+    private readonly layout;
+    private readonly reader;
+    private readonly writer;
+    private readonly allowMutations;
+    private parentIndex;
+    constructor(options: StorageAdminClientOptions);
+    summary(options?: {
+        verify?: boolean;
+    }): Promise<AdminSummary>;
+    listObjects(): Promise<AdminObjectListItem[]>;
+    listObjectPage(options?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<AdminObjectPage>;
+    getObject(objectId: string): Promise<ObjectRecord>;
+    rootReference(): Promise<AdminRootReference>;
+    listObjectChildren(objectId: string): Promise<AdminObjectChild[]>;
+    hierarchyPath(targetObjectId: string): Promise<AdminHierarchyPath>;
+    graph(): Promise<AdminGraph>;
+    search(query: string, options?: {
+        limit?: number;
+    }): Promise<AdminSearchResult[]>;
+    gvql(query: string, options?: GvqlExecutionOptions): Promise<GvqlResult>;
+    listTransactions(): Promise<TransactionRecord[]>;
+    readJournal(): Promise<string>;
+    readTypeDictionary(): Promise<TypeDictionary | undefined>;
+    verify(): Promise<VerificationResult>;
+    maintain(options?: {
+        keepSnapshots?: number;
+    }): Promise<MaintenanceResult>;
+    backup(destination: {
+        storageDirectory: string;
+        storageTarget?: StorageTarget;
+    }): Promise<BackupResult>;
+    previewMutation(mutation: AdminMutation): Promise<AdminMutationPreview>;
+    mutate(mutation: AdminMutation): Promise<TransactionRecord>;
+    private requireManifest;
+    private compact;
+    private collectGarbage;
+    private assertMutationsAllowed;
+    private parentIndexFor;
+}