Skip to content

feat(cli): add GCF as --output gcf format option#409

Open
blackwell-systems wants to merge 1 commit into
deepnote:mainfrom
blackwell-systems:gcf-integration
Open

feat(cli): add GCF as --output gcf format option#409
blackwell-systems wants to merge 1 commit into
deepnote:mainfrom
blackwell-systems:gcf-integration

Conversation

@blackwell-systems

@blackwell-systems blackwell-systems commented Jun 19, 2026 •
edited by coderabbitai Bot
Loading

Copy link
Copy Markdown

Summary

  • Add --output gcf as a new output format option alongside existing json and toon
  • GCF (Graph Compact Format) is an LLM-optimized wire format with higher comprehension accuracy than both JSON and TOON
  • No changes to existing TOON or JSON behavior

Why

LLM comprehension

When CLI output is consumed by LLMs (agents, pipelines, automation), format comprehension accuracy matters. Across 1,700+ evaluations on GPT-4o, GPT-5.5, Claude, and Gemini:

  • GCF: 100% on general data, 90.7% on adversarial payloads
  • TOON: 68.5% on the same adversarial data
  • JSON: 53.6%

Full eval methodology: GCF benchmarks

Data integrity

GCF verified lossless across 33 billion+ round-trips in 5 formats and 6 languages. Zero failures.

Full verification data: Lossless verification

Zero runtime dependencies

@blackwell-systems/gcf has zero runtime dependencies.

Changes

File Change
packages/cli/src/output.ts Add gcfEncode import, 'gcf' to OutputFormat, outputGcf() function
packages/cli/src/commands/inspect.ts Wire --output gcf
packages/cli/src/commands/run.ts Wire --output gcf
packages/cli/src/commands/analyze.ts Wire --output gcf
packages/cli/package.json Add @blackwell-systems/gcf dependency

Links

Summary by CodeRabbit

  • New Features
    • Introduced support for the new GCF output format across CLI commands. The analyze, inspect, and run commands now accept --output gcf to generate structured output in GCF format. This enables seamless integration with external tools, automated processing systems, and platforms that support standardized structured output formats.

@blackwell-systems blackwell-systems requested a review from a team as a code owner June 19, 2026 02:13
@coderabbitai

coderabbitai Bot commented Jun 19, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

Recent review info
Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2eca93ef-897a-4791-9c48-e4070bf19697

Commits

Reviewing files that changed from the base of the PR and between adb1f6a and 52f6070.

Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
Files selected for processing (5)
  • packages/cli/package.json
  • packages/cli/src/commands/analyze.ts
  • packages/cli/src/commands/inspect.ts
  • packages/cli/src/commands/run.ts
  • packages/cli/src/output.ts
Walkthrough

Walkthrough

The CLI gains a third machine-readable output format, gcf, backed by the new @blackwell-systems/gcf runtime dependency. output.ts adds 'gcf' to the OutputFormat union and OUTPUT_FORMATS constant, imports encodeGeneric as gcfEncode, and exports outputGcf(data: unknown): void. The analyze, inspect, and run commands each import outputGcf and add options.output === 'gcf' branches in both their success and error output paths, mirroring the existing json and toon handling.

Estimated code review effort

3 (Moderate) | ~15 minutes

Pre-merge checks | ✅ 4 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Updates Docs ⚠️ Warning PR adds --output gcf format option to CLI commands (inspect, run, analyze) but packages/cli/README.md—the primary CLI documentation—was not updated to document the new format. Update packages/cli/README.md: add gcf to output format descriptions for affected commands and include example usage of the new format.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately and concisely describes the main change: adding GCF as a new output format option to the CLI.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Tip: You can configure your own custom pre-merge checks in the settings.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@coderabbitai coderabbitai[bot] coderabbitai[bot] approved these changes

At least 2 approving reviews are required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@blackwell-systems