Graph Text Projection

Canonical text projection for graph query results consumed by GPT/Codex and agentic systems.

Graph Text Projection (GTP) is a specification family for projecting graph query results into stable one-dimensional text surfaces. GTP Core targets GPT/Codex and lightweight parsers that need to read object types, relationship direction, property ownership, path steps, variable bindings, statement references, and result completeness without reconstructing graph structure from tables, JSON, XML, or visual layouts.

What GTP Is

GTP Core is an adapter output language. Neo4j, RDF 1.2, and SPARQL 1.2 adapters read explicit projection requests, archive source objects according to their source semantics, and output GTP Core text or diagnostics.

The public specification covers:

• GTP Core canonical surface.
• Projection request and projection kind.
• Adapter contract for Neo4j, RDF 1.2, and SPARQL 1.2.
• SDK/API surface expectations.
• Diagnostics, completeness, ordering, fixtures, and verification.

What GTP Is Not

GTP is not a graph database, query language, exchange format replacement, graph layout engine, Pretty Skin, Agent runtime, context packer, or prompt wrapper. It exposes graph query results as text that reasoning systems can consume; it does not execute queries or guarantee model correctness.

Documentation

The primary document is the GTP Core specification book:

• Source: docs/books/06-gtp-core/book.adoc
• Local build output: docs/build/html/index.html
• Published site: https://michengliang.github.io/graph-text-projection/

Build the documentation locally:

cd docs
pnpm install
pnpm run test
pnpm run build

The generated site entry is:

docs/build/html/index.html

The generated catalog remains available at:

docs/build/html/catalog.html

Package State

graph-text-projection is currently a specification package. It reserves the public npm name and points users to the GTP Core specification. It does not yet export a parser, formatter, validator, adapter implementation, or SDK runtime.

Repository Layout

docs/
  catalog.adoc
  books/
    06-gtp-core/
  scripts/
  test/
packages/
  graph-text-projection/

docs/ is an AsciiDoc book workspace. packages/graph-text-projection is the npm package metadata surface for the future TypeScript-facing implementation.

Development

pnpm install
pnpm check

Useful focused commands:

pnpm --dir docs test
pnpm --dir docs build
pnpm --filter graph-text-projection pack:check

Release State

graph-text-projection is prepared for public npm publishing as a specification package. Tag releases use v<package-version>, run the full check suite, publish the npm package with provenance, and create a GitHub release from CHANGELOG.md.

Changelog

See CHANGELOG.md.

License

Apache License 2.0. See LICENSE.