@blackwell-systems/gcf 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blackwell Systems
+
+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,177 @@
+<p align="center">
+  <a href="https://github.com/blackwell-systems"><img src="https://raw.githubusercontent.com/blackwell-systems/blackwell-docs-theme/main/badge-trademark.svg" alt="Blackwell Systems"></a>
+  <a href="https://github.com/blackwell-systems/gcf-typescript/actions"><img src="https://github.com/blackwell-systems/gcf-typescript/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+</p>
+
+# gcf-typescript
+
+TypeScript implementation of [GCF (Graph Compact Format)](https://github.com/blackwell-systems/gcf).
+
+**84% fewer tokens than JSON. 32% fewer than TOON. 100% LLM comprehension accuracy at 500 symbols, where JSON fails.**
+
+## Install
+
+```
+npm install @blackwell-systems/gcf
+```
+
+Zero dependencies. TypeScript-first. Includes CLI.
+
+## CLI
+
+```bash
+npx @blackwell-systems/gcf encode < payload.json    # JSON to GCF
+npx @blackwell-systems/gcf decode < payload.gcf     # GCF to JSON
+npx @blackwell-systems/gcf stats  < payload.json    # token comparison
+```
+
+```
+Payload: 50 symbols, 20 edges
+
+  JSON  ██████████████████████████████  4,200 tokens
+  GCF   ████████░░░░░░░░░░░░░░░░░░░░░░  1,150 tokens
+
+  Savings: 73% fewer tokens with GCF
+```
+
+Or install globally: `npm install -g @blackwell-systems/gcf` then use `gcf` directly.
+
+## Library
+
+### Quick Start
+
+```typescript
+import { encode, type Payload } from '@blackwell-systems/gcf';
+
+const p: Payload = {
+  tool: 'context_for_task',
+  tokenBudget: 5000,
+  tokensUsed: 1847,
+  symbols: [
+    { qualifiedName: 'pkg.AuthMiddleware', kind: 'function', score: 0.78, provenance: 'lsp_resolved', distance: 0 },
+    { qualifiedName: 'pkg.NewServer', kind: 'function', score: 0.54, provenance: 'lsp_resolved', distance: 1 },
+  ],
+  edges: [
+    { source: 'pkg.NewServer', target: 'pkg.AuthMiddleware', edgeType: 'calls' },
+  ],
+};
+
+const output = encode(p);
+```
+
+Output:
+```
+GCF tool=context_for_task budget=5000 tokens=1847 symbols=2
+## targets
+@0 fn pkg.AuthMiddleware 0.78 lsp_resolved
+## related
+@1 fn pkg.NewServer 0.54 lsp_resolved
+## edges
+@0<@1 calls
+```
+
+## Decode
+
+```typescript
+import { decode } from '@blackwell-systems/gcf';
+
+const p = decode(input);
+console.log(p.tool, p.symbols.length, 'symbols', p.edges.length, 'edges');
+```
+
+## Session Deduplication
+
+Track transmitted symbols across multiple tool responses. Previously-sent symbols become bare references instead of full declarations:
+
+```typescript
+import { Session, encodeWithSession } from '@blackwell-systems/gcf';
+
+const sess = new Session();
+
+const out1 = encodeWithSession(payload1, sess); // full declarations
+const out2 = encodeWithSession(payload2, sess); // reused symbols as "@N  # previously transmitted"
+```
+
+By the 5th call in a session: 92.7% token savings vs JSON.
+
+## Delta Encoding
+
+When the consumer already has a prior context pack, send only what changed:
+
+```typescript
+import { encodeDelta, type DeltaPayload } from '@blackwell-systems/gcf';
+
+const delta: DeltaPayload = {
+  tool: 'context_for_task',
+  baseRoot: 'aaa111',
+  newRoot: 'bbb222',
+  removed: [{ qualifiedName: 'pkg.OldFunc', kind: 'function', score: 0, provenance: '', distance: 0 }],
+  added: [{ qualifiedName: 'pkg.NewFunc', kind: 'function', score: 0.85, provenance: 'rwr', distance: 0 }],
+  removedEdges: [],
+  addedEdges: [],
+  deltaTokens: 30,
+  fullTokens: 200,
+};
+
+const output = encodeDelta(delta);
+```
+
+81.2% savings on re-queries where the pack changed slightly.
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `encode(p: Payload): string` | Encode a payload to GCF text |
+| `decode(input: string): Payload` | Parse GCF text back to a Payload |
+| `encodeWithSession(p: Payload, s: Session): string` | Encode with session deduplication |
+| `encodeDelta(d: DeltaPayload): string` | Encode a delta (added/removed only) |
+| `new Session()` | Create a new session tracker |
+
+## Types
+
+| Type | Purpose |
+|------|---------|
+| `Payload` | Full GCF payload: tool, budget, symbols, edges, pack root |
+| `Symbol` | Graph node: qualified name, kind, score, provenance, distance |
+| `Edge` | Directed relationship: source, target, edge type |
+| `DeltaPayload` | Diff between two packs: added/removed symbols and edges |
+| `Session` | Tracker for multi-call deduplication |
+| `KIND_ABBREV` / `KIND_EXPAND` | Bidirectional kind abbreviation maps |
+
+## Comprehension Eval
+
+A rigorous 3-way benchmark (GCF vs TOON vs JSON) at 500 symbols, 200 edges. Six structured extraction questions sent to an LLM:
+
+| Format | Accuracy | Tokens | vs JSON |
+|--------|----------|--------|---------|
+| **GCF** | **100%** (6/6) | **11,090** | **79% fewer** |
+| TOON | 100% (6/6) | 16,378 | 69% fewer |
+| JSON | 66.7% (4/6) | 53,341 | baseline |
+
+JSON failed on counting tasks. GCF and TOON both achieved perfect accuracy. GCF does it in 32% fewer tokens.
+
+## Token Efficiency (TOON's Own Benchmark)
+
+Running [TOON's benchmark harness](https://github.com/blackwell-systems/toon/tree/gcf-comparison) with GCF inserted (their datasets, their tokenizer):
+
+| Track | GCF | TOON | Result |
+|-------|-----|------|--------|
+| Mixed-structure (nested, semi-uniform) | 169,554 | 227,896 | **GCF 34% smaller** |
+| Flat-only (tabular) | 66,026 | 67,837 | **GCF 3% smaller** |
+| Semi-uniform event logs | 107,269 | 154,032 | **GCF 44% smaller** |
+
+GCF wins on every dataset except deeply nested config (75 tokens on a 618-token payload). On semi-uniform data, GCF uses 44% fewer tokens than TOON.
+
+Reproducible: [blackwell-systems/toon@gcf-comparison](https://github.com/blackwell-systems/toon/tree/gcf-comparison)
+
+## Related
+
+- [Specification](https://github.com/blackwell-systems/gcf) (grammar, encoding rules, design constraints)
+- [gcf-go](https://github.com/blackwell-systems/gcf-go) (Go implementation)
+- [TOON benchmark fork](https://github.com/blackwell-systems/toon/tree/gcf-comparison) (reproducible token counts)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * GCF command-line interface: encode, decode, stats.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * GCF command-line interface: encode, decode, stats.
+ */
+import { readFileSync } from 'node:fs';
+import { encode } from './encode.js';
+import { decode } from './decode.js';
+const USAGE = `gcf - token-optimized wire format for LLM tool responses
+
+Usage:
+  gcf encode [file]    Encode JSON payload to GCF (stdin if no file)
+  gcf decode [file]    Decode GCF text to JSON (stdin if no file)
+  gcf stats  [file]    Compare token counts: JSON vs GCF (stdin if no file)
+  gcf version          Print version
+
+Examples:
+  gcf encode < payload.json
+  gcf decode < payload.gcf
+  gcf stats payload.json
+`;
+function readInput(args) {
+    if (args.length > 0 && args[0] !== '-') {
+        return readFileSync(args[0], 'utf-8');
+    }
+    return readFileSync(0, 'utf-8');
+}
+function payloadFromJSON(data) {
+    const obj = JSON.parse(data);
+    return {
+        tool: obj.tool ?? '',
+        tokenBudget: obj.tokenBudget ?? 0,
+        tokensUsed: obj.tokensUsed ?? 0,
+        packRoot: obj.packRoot ?? '',
+        symbols: (obj.symbols ?? []).map((s) => ({
+            qualifiedName: s.qualifiedName,
+            kind: s.kind,
+            score: s.score,
+            provenance: s.provenance,
+            distance: s.distance ?? 0,
+        })),
+        edges: (obj.edges ?? []).map((e) => ({
+            source: e.source,
+            target: e.target,
+            edgeType: e.edgeType,
+            status: e.status ?? '',
+        })),
+    };
+}
+function payloadToJSON(p) {
+    return JSON.stringify({
+        tool: p.tool,
+        tokensUsed: p.tokensUsed,
+        tokenBudget: p.tokenBudget,
+        packRoot: p.packRoot ?? '',
+        symbols: p.symbols.map(s => ({
+            qualifiedName: s.qualifiedName,
+            kind: s.kind,
+            score: s.score,
+            provenance: s.provenance,
+            distance: s.distance,
+        })),
+        edges: p.edges.map(e => ({
+            source: e.source,
+            target: e.target,
+            edgeType: e.edgeType,
+            ...(e.status ? { status: e.status } : {}),
+        })),
+    }, null, 2);
+}
+function doEncode(data) {
+    const p = payloadFromJSON(data);
+    process.stdout.write(encode(p));
+}
+function doDecode(data) {
+    const p = decode(data);
+    console.log(payloadToJSON(p));
+}
+function doStats(data) {
+    const p = payloadFromJSON(data);
+    const gcfOutput = encode(p);
+    const jsonTokens = Math.floor(data.trim().length / 4);
+    const gcfTokens = Math.floor(gcfOutput.trim().length / 4);
+    const savings = jsonTokens > 0 ? 100 * (1 - gcfTokens / jsonTokens) : 0;
+    const barWidth = 30;
+    const jsonBar = '█'.repeat(barWidth);
+    const gcfFilled = jsonTokens > 0 ? Math.round((gcfTokens * barWidth) / jsonTokens) : 0;
+    const gcfBar = '█'.repeat(gcfFilled) + '░'.repeat(barWidth - gcfFilled);
+    console.log(`Payload: ${p.symbols.length} symbols, ${p.edges.length} edges\n`);
+    console.log(`  JSON  ${jsonBar}  ${jsonTokens} tokens`);
+    console.log(`  GCF   ${gcfBar}  ${gcfTokens} tokens`);
+    console.log(`\n  Savings: ${Math.round(savings)}% fewer tokens with GCF`);
+}
+const args = process.argv.slice(2);
+const cmd = args[0];
+switch (cmd) {
+    case 'encode':
+        doEncode(readInput(args.slice(1)));
+        break;
+    case 'decode':
+        doDecode(readInput(args.slice(1)));
+        break;
+    case 'stats':
+        doStats(readInput(args.slice(1)));
+        break;
+    case 'version':
+        console.log('gcf 0.1.0');
+        break;
+    case '-h':
+    case '--help':
+    case 'help':
+        process.stdout.write(USAGE);
+        break;
+    default:
+        if (!cmd) {
+            process.stderr.write(USAGE);
+            process.exit(1);
+        }
+        process.stderr.write(`unknown command: ${cmd}\n\n`);
+        process.stderr.write(USAGE);
+        process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * KindAbbrev maps full kind names to short GCF abbreviations.
+ */
+export declare const KIND_ABBREV: Record<string, string>;
+/**
+ * KindExpand is the reverse of KindAbbrev: maps abbreviations back to full kind names.
+ */
+export declare const KIND_EXPAND: Record<string, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiB9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiB9C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,43 @@
+/**
+ * KindAbbrev maps full kind names to short GCF abbreviations.
+ */
+export const KIND_ABBREV = {
+    function: 'fn',
+    type: 'type',
+    method: 'method',
+    interface: 'iface',
+    var: 'var',
+    const: 'const',
+    resource: 'resource',
+    table: 'table',
+    class: 'class',
+    selector: 'selector',
+    field: 'field',
+    route_handler: 'route',
+    external: 'ext',
+    file: 'file',
+    package: 'pkg',
+    service: 'svc',
+};
+/**
+ * KindExpand is the reverse of KindAbbrev: maps abbreviations back to full kind names.
+ */
+export const KIND_EXPAND = {
+    fn: 'function',
+    type: 'type',
+    method: 'method',
+    iface: 'interface',
+    var: 'var',
+    const: 'const',
+    resource: 'resource',
+    table: 'table',
+    class: 'class',
+    selector: 'selector',
+    field: 'field',
+    route: 'route_handler',
+    ext: 'external',
+    file: 'file',
+    pkg: 'package',
+    svc: 'service',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,OAAO;IAClB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,OAAO;IACtB,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,eAAe;IACtB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC"}

package/dist/decode.d.ts

@@ -0,0 +1,6 @@
+import type { Payload } from './types.js';
+/**
+ * Decode parses GCF text back into a Payload.
+ */
+export declare function decode(input: string): Payload;
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,OAAO,EAAU,MAAM,YAAY,CAAC;AAGxD;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA6E7C"}

package/dist/decode.js

@@ -0,0 +1,179 @@
+import { KIND_EXPAND } from './constants.js';
+/**
+ * Decode parses GCF text back into a Payload.
+ */
+export function decode(input) {
+    const lines = input.split('\n');
+    if (lines.length === 0) {
+        throw new Error('gcf: empty input');
+    }
+    const header = lines[0];
+    if (!header.startsWith('GCF ')) {
+        throw new Error(`gcf: invalid header, expected 'GCF ...' got "${header}"`);
+    }
+    const p = {
+        tool: '',
+        tokenBudget: 0,
+        tokensUsed: 0,
+        symbols: [],
+        edges: [],
+    };
+    // Parse header fields.
+    parseHeader(header.slice(4), p);
+    // Parse body: symbols and edges.
+    const symbols = [];
+    const symByID = new Map();
+    let currentDistance = 0;
+    let inEdges = false;
+    for (let i = 1; i < lines.length; i++) {
+        let line = lines[i].replace(/\r$/, '');
+        if (line === '')
+            continue;
+        // Group header.
+        if (line.startsWith('## ')) {
+            const group = line.slice(3);
+            inEdges = group === 'edges';
+            if (!inEdges) {
+                switch (group) {
+                    case 'targets':
+                        currentDistance = 0;
+                        break;
+                    case 'related':
+                        currentDistance = 1;
+                        break;
+                    case 'extended':
+                        currentDistance = 2;
+                        break;
+                    default:
+                        if (group.startsWith('distance_')) {
+                            const d = parseInt(group.slice(9), 10);
+                            if (!isNaN(d)) {
+                                currentDistance = d;
+                            }
+                        }
+                        break;
+                }
+            }
+            continue;
+        }
+        // Comment.
+        if (line.startsWith('# ')) {
+            continue;
+        }
+        if (inEdges) {
+            const edge = parseEdgeLine(line, symByID);
+            p.edges.push(edge);
+        }
+        else {
+            const { symbol, id } = parseSymbolLine(line, currentDistance);
+            symbols.push(symbol);
+            symByID.set(id, symbol);
+        }
+    }
+    p.symbols = symbols;
+    return p;
+}
+function parseHeader(fields, p) {
+    const parts = fields.split(/\s+/);
+    for (const part of parts) {
+        const eqIdx = part.indexOf('=');
+        if (eqIdx < 0)
+            continue;
+        const key = part.slice(0, eqIdx);
+        const value = part.slice(eqIdx + 1);
+        switch (key) {
+            case 'tool':
+                p.tool = value;
+                break;
+            case 'budget': {
+                const v = parseInt(value, 10);
+                if (isNaN(v))
+                    throw new Error(`gcf: invalid budget "${value}"`);
+                p.tokenBudget = v;
+                break;
+            }
+            case 'tokens': {
+                const v = parseInt(value, 10);
+                if (isNaN(v))
+                    throw new Error(`gcf: invalid tokens "${value}"`);
+                p.tokensUsed = v;
+                break;
+            }
+            case 'pack_root':
+                p.packRoot = value;
+                break;
+            case 'symbols':
+                // Informational, reconstructed from parsed symbols.
+                break;
+        }
+    }
+}
+function parseSymbolLine(line, distance) {
+    if (!line.startsWith('@')) {
+        throw new Error(`gcf: expected symbol line starting with @, got "${line}"`);
+    }
+    const parts = line.split(/\s+/);
+    if (parts.length < 5) {
+        throw new Error(`gcf: symbol line needs at least 5 fields, got ${parts.length} in "${line}"`);
+    }
+    const idStr = parts[0].slice(1); // strip @
+    const id = parseInt(idStr, 10);
+    if (isNaN(id)) {
+        throw new Error(`gcf: invalid symbol id "${idStr}"`);
+    }
+    let kind = parts[1];
+    if (KIND_EXPAND[kind]) {
+        kind = KIND_EXPAND[kind];
+    }
+    const qname = parts[2];
+    const score = parseFloat(parts[3]);
+    if (isNaN(score)) {
+        throw new Error(`gcf: invalid score "${parts[3]}"`);
+    }
+    const provenance = parts[4];
+    return {
+        symbol: {
+            qualifiedName: qname,
+            kind,
+            score,
+            provenance,
+            distance,
+        },
+        id,
+    };
+}
+function parseEdgeLine(line, symByID) {
+    const parts = line.split(/\s+/);
+    if (parts.length < 2) {
+        throw new Error(`gcf: edge line needs at least 2 fields, got "${line}"`);
+    }
+    const ref = parts[0];
+    const ltIdx = ref.indexOf('<');
+    if (ltIdx < 0) {
+        throw new Error(`gcf: edge line missing '<' separator in "${ref}"`);
+    }
+    const targetIDStr = ref.slice(1, ltIdx); // strip leading @
+    const sourceIDStr = ref.slice(ltIdx + 2); // strip <@
+    const targetID = parseInt(targetIDStr, 10);
+    if (isNaN(targetID)) {
+        throw new Error(`gcf: invalid target id "${targetIDStr}"`);
+    }
+    const sourceID = parseInt(sourceIDStr, 10);
+    if (isNaN(sourceID)) {
+        throw new Error(`gcf: invalid source id "${sourceIDStr}"`);
+    }
+    const targetSym = symByID.get(targetID);
+    const sourceSym = symByID.get(sourceID);
+    if (!targetSym || !sourceSym) {
+        throw new Error(`gcf: edge references unknown symbol id(s): target=${targetID} source=${sourceID}`);
+    }
+    const edgeType = parts[1];
+    const status = parts.length >= 3 ? parts[2] : undefined;
+    return {
+        source: sourceSym.qualifiedName,
+        target: targetSym.qualifiedName,
+        edgeType,
+        status,
+    };
+}
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,MAAM,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,GAAY;QACjB,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,uBAAuB;IACvB,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhC,iCAAiC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAE1B,gBAAgB;QAChB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO,GAAG,KAAK,KAAK,OAAO,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,KAAK,EAAE,CAAC;oBACd,KAAK,SAAS;wBACZ,eAAe,GAAG,CAAC,CAAC;wBACpB,MAAM;oBACR,KAAK,SAAS;wBACZ,eAAe,GAAG,CAAC,CAAC;wBACpB,MAAM;oBACR,KAAK,UAAU;wBACb,eAAe,GAAG,CAAC,CAAC;wBACpB,MAAM;oBACR;wBACE,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;4BAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACvC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gCACd,eAAe,GAAG,CAAC,CAAC;4BACtB,CAAC;wBACH,CAAC;wBACD,MAAM;gBACV,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,WAAW;QACX,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,CAAU;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAEpC,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM;gBACT,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;gBACf,MAAM;YACR,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,KAAK,CAAC,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;gBAChE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,KAAK,CAAC,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;gBAChE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,WAAW;gBACd,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR,KAAK,SAAS;gBACZ,oDAAoD;gBACpD,MAAM;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,QAAgB;IAEhB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,iDAAiD,KAAK,CAAC,MAAM,QAAQ,IAAI,GAAG,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5B,OAAO;QACL,MAAM,EAAE;YACN,aAAa,EAAE,KAAK;YACpB,IAAI;YACJ,KAAK;YACL,UAAU;YACV,QAAQ;SACT;QACD,EAAE;KACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAA4B;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,GAAG,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,GAAG,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,kBAAkB;IAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;IAErD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,qDAAqD,QAAQ,WAAW,QAAQ,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExD,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,aAAa;QAC/B,MAAM,EAAE,SAAS,CAAC,aAAa;QAC/B,QAAQ;QACR,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/delta.d.ts

@@ -0,0 +1,6 @@
+import type { DeltaPayload } from './types.js';
+/**
+ * EncodeDelta serializes a DeltaPayload into GCF delta format.
+ */
+export declare function encodeDelta(d: DeltaPayload): string;
+//# sourceMappingURL=delta.d.ts.map

package/dist/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../src/delta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAgDnD"}

package/dist/delta.js

@@ -0,0 +1,46 @@
+import { KIND_ABBREV } from './constants.js';
+/**
+ * EncodeDelta serializes a DeltaPayload into GCF delta format.
+ */
+export function encodeDelta(d) {
+    const lines = [];
+    // Header.
+    let savings = 0;
+    if (d.fullTokens > 0) {
+        savings = Math.round(100 * (1 - d.deltaTokens / d.fullTokens));
+    }
+    lines.push(`GCF tool=${d.tool} delta=true base_root=${d.baseRoot} new_root=${d.newRoot} tokens=${d.deltaTokens} savings=${savings}%`);
+    // Removed symbols: short references (consumer already has the full declaration).
+    if (d.removed.length > 0) {
+        lines.push('## removed');
+        for (const s of d.removed) {
+            const kind = KIND_ABBREV[s.kind] || s.kind;
+            lines.push(`${kind} ${s.qualifiedName}`);
+        }
+    }
+    // Added symbols: full declarations (consumer doesn't have these).
+    if (d.added.length > 0) {
+        lines.push('## added');
+        for (let i = 0; i < d.added.length; i++) {
+            const s = d.added[i];
+            const kind = KIND_ABBREV[s.kind] || s.kind;
+            lines.push(`@${i} ${kind} ${s.qualifiedName} ${s.score.toFixed(2)} ${s.provenance}`);
+        }
+    }
+    // Removed edges.
+    if (d.removedEdges.length > 0) {
+        lines.push('## edges_removed');
+        for (const e of d.removedEdges) {
+            lines.push(`${e.source} -> ${e.target} ${e.edgeType}`);
+        }
+    }
+    // Added edges.
+    if (d.addedEdges.length > 0) {
+        lines.push('## edges_added');
+        for (const e of d.addedEdges) {
+            lines.push(`${e.source} -> ${e.target} ${e.edgeType}`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=delta.js.map

package/dist/delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../src/delta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,CAAe;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,UAAU;IACV,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,CAAC,IAAI,CACR,YAAY,CAAC,CAAC,IAAI,yBAAyB,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,YAAY,OAAO,GAAG,CAC1H,CAAC;IAEF,iFAAiF;IACjF,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}