Download the PHP package tacman/gcf-php without Composer
On this page you can find all versions of the php package tacman/gcf-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tacman/gcf-php
More information about tacman/gcf-php
Files in tacman/gcf-php
Package gcf-php
Short Description PHP implementation of GCF (Graph Compact Format), the AI-native wire format for structured data. Generic and graph profiles, delta encoding, session dedup, streaming.
License MIT
Homepage https://github.com/tacman/gcf-php
Informations about the package gcf-php
gcf-php
A PHP implementation of GCF (Graph Compact Format) — a token-efficient wire format for structured data designed for LLM agent loops. Lossless conversion to/from JSON, 50-92% fewer tokens depending on data shape.
GCF is specified and maintained by blackwell-systems/gcf,
with reference implementations in Go, Rust, TypeScript, Python, Swift, and Kotlin. This is an
independent PHP port, targeting spec version 3.5.1 (see spec/SPEC.md, vendored
from the source commit noted in spec/SOURCE-COMMIT.txt). It was ported
from gcf-python v2.3.0 and tracks its public API
1:1 — both profiles, delta encoding, session dedup, streaming, and the CLI.
Requirements
PHP 8.5+. Zero runtime dependencies — matching the other six official implementations' permanent zero-dependency commitment.
Usage
Generic profile — arbitrary structured data (tabular arrays, keyed maps, nested objects)
Graph profile — symbols/edges (code graphs, context packs)
Session dedup — reuse symbols as bare references across multiple calls
Delta encoding — send only what changed
Gcf\Generic\Delta\GenericDeltaSession automates the delta-vs-full-reanchor decision across turns
(Reanchor::fixedN(n) / Reanchor::sizeGuard() policies).
Streaming — emit rows incrementally, zero buffering
Pack root — canonical content hash for delta base/new root comparisons
CLI
Conformance
tests/conformance/ is vendored from the spec repo's shared fixture suite (JSON files with
input/expected/operation — the same fixtures used to validate the other 6 implementations).
Five PHPUnit test classes cover every vendored fixture 1:1, split by concern:
| Test class | Fixture directories |
|---|---|
ConformanceTest |
generic-profile full snapshot: arrays, attachments, containers, decode, errors-v2 (non-graph), flatten, inline-schema, keyed-map, keys, numbers, roots, scalar, whitespace |
GraphConformanceTest |
graph-encode, graph-decode, graph-pack-root, graph-scoped errors-v2 |
GenericDeltaConformanceTest |
generic-delta, generic-delta-session, generic-pack-root |
GraphDeltaSessionConformanceTest |
graph-delta, graph-session, malformed-delta error |
StreamingConformanceTest |
streaming-v2 |
Run the whole suite: vendor/bin/phpunit.
License
MIT. See LICENSE. Format specification and prior art by Dayna Blackwell / blackwell-systems.