@blackwell-systems/gcf 2.1.1 → 2.2.0

package/src/generic.ts

@@ -141,21 +141,149 @@ function sharedArraySchema(arr: unknown[], fieldName: string): string[] | null {
   return canonicalFields;
 }
 
+// ── Nested object flattening (v3.2) ──────────────────────────────────────
+
+interface FlatLeaf {
+  path: string;     // ">" separated path (e.g. "customer>name")
+  keys: string[];   // key chain to traverse from row object
+}
+
+function analyzeFlattenable(arr: unknown[], fieldName: string, parentPath: string): FlatLeaf[] | null {
+  let canonicalShape: Record<string, 'scalar' | 'nested'> | null = null;
+
+  for (const item of arr) {
+    const obj = item as Record<string, unknown>;
+    if (!(fieldName in obj) || obj[fieldName] === null || obj[fieldName] === undefined) continue;
+    const v = obj[fieldName];
+    if (typeof v !== 'object' || Array.isArray(v)) return null;
+
+    const keys = Object.keys(v as Record<string, unknown>);
+
+    if (!canonicalShape) {
+      canonicalShape = {};
+      for (const k of keys) {
+        if (k.includes('>')) return null;
+        const val = (v as Record<string, unknown>)[k];
+        if (val !== null && val !== undefined && typeof val === 'object' && !Array.isArray(val)) {
+          canonicalShape[k] = 'nested';
+        } else if (Array.isArray(val)) {
+          return null;
+        } else {
+          canonicalShape[k] = 'scalar';
+        }
+      }
+    } else {
+      if (keys.length !== Object.keys(canonicalShape).length) return null;
+      for (const k of keys) {
+        if (!(k in canonicalShape)) return null;
+        const val = (v as Record<string, unknown>)[k];
+        const expected = canonicalShape[k];
+        if (expected === 'scalar') {
+          if (val !== null && val !== undefined && typeof val === 'object') return null;
+        } else if (expected === 'nested') {
+          if (val !== null && val !== undefined) {
+            if (typeof val !== 'object' || Array.isArray(val)) return null;
+          }
+        }
+      }
+    }
+  }
+
+  if (!canonicalShape) return null;
+
+  const currentPath = parentPath ? parentPath + '>' + fieldName : fieldName;
+  const parentKeys = parentPath ? [...parentPath.split('>'), fieldName] : [fieldName];
+
+  const leaves: FlatLeaf[] = [];
+  for (const k of Object.keys(canonicalShape)) {
+    if (canonicalShape[k] === 'scalar') {
+      leaves.push({ path: currentPath + '>' + k, keys: [...parentKeys, k] });
+    } else {
+      const subArr = arr.map(item => {
+        const obj = item as Record<string, unknown>;
+        if (!(fieldName in obj) || obj[fieldName] === null || obj[fieldName] === undefined) return {};
+        return obj[fieldName];
+      });
+      const subLeaves = analyzeFlattenable(subArr as unknown[], k, currentPath);
+      if (!subLeaves || subLeaves.length === 0) return null;
+      leaves.push(...subLeaves);
+    }
+  }
+
+  // Guard: reject if any row has non-null object with all-null leaves.
+  if (leaves.length > 0) {
+    for (const item of arr) {
+      const obj = item as Record<string, unknown>;
+      if (!(fieldName in obj) || obj[fieldName] === null || obj[fieldName] === undefined) continue;
+      const allNull = leaves.every(leaf => {
+        const val = resolveKeyChain(item, leaf.keys);
+        return val.exists && val.value === null;
+      });
+      if (allNull) return null;
+    }
+  }
+
+  return leaves;
+}
+
+function resolveKeyChain(item: unknown, keys: string[]): { value: unknown; exists: boolean } {
+  if (keys.length === 0) return { value: undefined, exists: false };
+  const obj = item as Record<string, unknown>;
+  if (typeof obj !== 'object' || obj === null) return { value: undefined, exists: false };
+  if (!(keys[0] in obj)) return { value: undefined, exists: false };
+  let current: unknown = obj[keys[0]];
+  if (current === null || current === undefined) return { value: current, exists: true };
+  for (let i = 1; i < keys.length; i++) {
+    if (typeof current !== 'object' || current === null) return { value: undefined, exists: false };
+    const c = current as Record<string, unknown>;
+    if (!(keys[i] in c)) return { value: undefined, exists: false };
+    current = c[keys[i]];
+  }
+  return { value: current, exists: true };
+}
+
+// ── End flattening helpers ───────────────────────────────────────────────
+
 function encodeTabular(headerPrefix: string, arr: unknown[], fields: string[], depth: number): string {
   const prefix = indent(depth);
 
-  // Pre-compute inline schemas and shared array schemas.
+  // Phase 0: Analyze fields for flattening.
+  const flattenMap = new Map<string, FlatLeaf[]>();
+  for (const f of fields) {
+    const leaves = analyzeFlattenable(arr, f, '');
+    if (leaves && leaves.length > 0) {
+      flattenMap.set(f, leaves);
+    }
+  }
+
+  // Build expanded column list.
+  type ColType = 'flat' | 'original';
+  interface FlatColumn { headerName: string; colType: ColType; field: string; keys: string[]; }
+  const columns: FlatColumn[] = [];
+  for (const f of fields) {
+    const leaves = flattenMap.get(f);
+    if (leaves) {
+      for (const leaf of leaves) {
+        columns.push({ headerName: formatKey(leaf.path), colType: 'flat', field: f, keys: leaf.keys });
+      }
+    } else {
+      columns.push({ headerName: formatKey(f), colType: 'original', field: f, keys: [] });
+    }
+  }
+
+  // Pre-compute inline schemas and shared array schemas (skip flattened fields).
   const inlineSchemas = new Map<string, string[]>();
   const sharedArrSchemas = new Map<string, string[]>();
   for (const f of fields) {
+    if (flattenMap.has(f)) continue;
     const ifs = inlineSchemaFields(arr, f);
     if (ifs) inlineSchemas.set(f, ifs);
     const sas = sharedArraySchema(arr, f);
     if (sas) sharedArrSchemas.set(f, sas);
   }
 
-  const fmtFields = fields.map(f => formatKey(f));
-  let out = `${headerPrefix}[${arr.length}]{${fmtFields.join(',')}}\n`;
+  const headerFields = columns.map(c => c.headerName);
+  let out = `${headerPrefix}[${arr.length}]{${headerFields.join(',')}}\n`;
 
   for (let i = 0; i < arr.length; i++) {
     const obj = arr[i] as Record<string, unknown>;
@@ -163,14 +291,38 @@ function encodeTabular(headerPrefix: string, arr: unknown[], fields: string[], d
     const attachments: { name: string; value: unknown; inline: boolean; inlineFields?: string[] }[] = [];
     let rowHasAttachment = false;
 
-    for (const f of fields) {
+    for (const col of columns) {
+      if (col.colType === 'flat') {
+        // Resolve value via key chain.
+        if (!(col.keys[0] in obj)) {
+          cells.push('~');
+        } else {
+          // Check if top-level field is null.
+          const topVal = obj[col.keys[0]];
+          if (topVal === null || topVal === undefined) {
+            cells.push(topVal === null ? '-' : '~');
+          } else {
+            const resolved = resolveKeyChain(obj, col.keys);
+            if (!resolved.exists) {
+              cells.push('~');
+            } else if (resolved.value === null || resolved.value === undefined) {
+              cells.push('-');
+            } else {
+              cells.push(formatScalar(resolved.value, 0x7c));
+            }
+          }
+        }
+        continue;
+      }
+
+      // Original (non-flattened) field.
+      const f = col.field;
       if (!(f in obj)) { cells.push('~'); continue; }
       const v = obj[f];
       if (v === null || v === undefined) { cells.push('-'); continue; }
       if (typeof v === 'object') {
         const ifs = inlineSchemas.get(f);
         if (ifs && !Array.isArray(v)) {
-          // Inline schema: first row declares, subsequent use bare ^.
           if (i === 0) {
             const fmtIF = ifs.map(k => formatKey(k));
             cells.push(`^{${fmtIF.join(',')}}`);

package/src/scalar.ts

@@ -5,6 +5,7 @@
 
 const JSON_NUMBER_RE = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
 const NUMERIC_LIKE_RE = /^[+-]\.?\d|^\.\d|^0\d/;
+const INLINE_ARRAY_RE = /\[[^\]]*\]\s*:/;
 
 /** Check if a string value must be quoted per Section 2.4. */
 export function needsQuote(s: string): boolean {
@@ -14,6 +15,7 @@ export function needsQuote(s: string): boolean {
   if (NUMERIC_LIKE_RE.test(s)) return true;
   if (s[0] === ' ' || s[s.length - 1] === ' ') return true;
   if (s[0] === '#' || s[0] === '@' || s[0] === '.') return true;
+  if (INLINE_ARRAY_RE.test(s)) return true;
   for (let i = 0; i < s.length; i++) {
     const c = s.charCodeAt(i);
     if (c === 0x22 || c === 0x5c || c < 0x20 || c === 0x0a || c === 0x0d ||

package/dist/cjs/browser.d.ts

@@ -1,9 +0,0 @@
-export type { Symbol, Edge, Payload, DeltaPayload, Components } from './types.js';
-export { KIND_ABBREV, KIND_EXPAND } from './constants.js';
-export { encode } from './encode.js';
-export { decode } from './decode.js';
-export { encodeGeneric } from './generic.js';
-export { decodeGeneric } from './decode_generic.js';
-export { formatScalar, formatKey, parseScalar, needsQuote, quoteString } from './scalar.js';
-export { StreamEncoder, type StreamWriter, type StreamOptions } from './stream.js';
-export { GenericStreamEncoder } from './stream_generic.js';

package/dist/cjs/browser.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenericStreamEncoder = exports.StreamEncoder = exports.quoteString = exports.needsQuote = exports.parseScalar = exports.formatKey = exports.formatScalar = exports.decodeGeneric = exports.encodeGeneric = exports.decode = exports.encode = exports.KIND_EXPAND = exports.KIND_ABBREV = void 0;
-var constants_js_1 = require("./constants.js");
-Object.defineProperty(exports, "KIND_ABBREV", { enumerable: true, get: function () { return constants_js_1.KIND_ABBREV; } });
-Object.defineProperty(exports, "KIND_EXPAND", { enumerable: true, get: function () { return constants_js_1.KIND_EXPAND; } });
-var encode_js_1 = require("./encode.js");
-Object.defineProperty(exports, "encode", { enumerable: true, get: function () { return encode_js_1.encode; } });
-var decode_js_1 = require("./decode.js");
-Object.defineProperty(exports, "decode", { enumerable: true, get: function () { return decode_js_1.decode; } });
-var generic_js_1 = require("./generic.js");
-Object.defineProperty(exports, "encodeGeneric", { enumerable: true, get: function () { return generic_js_1.encodeGeneric; } });
-var decode_generic_js_1 = require("./decode_generic.js");
-Object.defineProperty(exports, "decodeGeneric", { enumerable: true, get: function () { return decode_generic_js_1.decodeGeneric; } });
-var scalar_js_1 = require("./scalar.js");
-Object.defineProperty(exports, "formatScalar", { enumerable: true, get: function () { return scalar_js_1.formatScalar; } });
-Object.defineProperty(exports, "formatKey", { enumerable: true, get: function () { return scalar_js_1.formatKey; } });
-Object.defineProperty(exports, "parseScalar", { enumerable: true, get: function () { return scalar_js_1.parseScalar; } });
-Object.defineProperty(exports, "needsQuote", { enumerable: true, get: function () { return scalar_js_1.needsQuote; } });
-Object.defineProperty(exports, "quoteString", { enumerable: true, get: function () { return scalar_js_1.quoteString; } });
-var stream_js_1 = require("./stream.js");
-Object.defineProperty(exports, "StreamEncoder", { enumerable: true, get: function () { return stream_js_1.StreamEncoder; } });
-var stream_generic_js_1 = require("./stream_generic.js");
-Object.defineProperty(exports, "GenericStreamEncoder", { enumerable: true, get: function () { return stream_generic_js_1.GenericStreamEncoder; } });
-//# sourceMappingURL=browser.js.map

package/dist/cjs/browser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":";;;AAEA,+CAA0D;AAAjD,2GAAA,WAAW,OAAA;AAAE,2GAAA,WAAW,OAAA;AACjC,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,yDAAoD;AAA3C,kHAAA,aAAa,OAAA;AACtB,yCAA4F;AAAnF,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,wGAAA,WAAW,OAAA;AACtE,yCAAmF;AAA1E,0GAAA,aAAa,OAAA;AACtB,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA"}

package/dist/cjs/cli.d.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-/**
- * GCF command-line interface: encode, decode, stats.
- */
-export {};

package/dist/cjs/cli.js

@@ -1,136 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * GCF command-line interface: encode, decode, stats.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_fs_1 = require("node:fs");
-const encode_js_1 = require("./encode.js");
-const decode_js_1 = require("./decode.js");
-const generic_js_1 = require("./generic.js");
-const decode_generic_js_1 = require("./decode_generic.js");
-const USAGE = `gcf - token-optimized wire format for LLM tool responses
-
-Usage:
-  gcf encode [file]           Encode JSON graph payload to GCF (stdin if no file)
-  gcf decode [file]           Decode GCF graph text to JSON (stdin if no file)
-  gcf encode-generic [file]   Encode generic JSON to GCF (stdin if no file)
-  gcf decode-generic [file]   Decode generic GCF 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 encode-generic < data.json
-  gcf decode-generic < data.gcf
-  gcf stats payload.json
-`;
-function readInput(args) {
-    if (args.length > 0 && args[0] !== '-') {
-        return (0, node_fs_1.readFileSync)(args[0], 'utf-8');
-    }
-    return (0, node_fs_1.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((0, encode_js_1.encode)(p));
-}
-function doDecode(data) {
-    const p = (0, decode_js_1.decode)(data);
-    console.log(payloadToJSON(p));
-}
-function doStats(data) {
-    const p = payloadFromJSON(data);
-    const gcfOutput = (0, encode_js_1.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 'encode-generic':
-        process.stdout.write((0, generic_js_1.encodeGeneric)(JSON.parse(readInput(args.slice(1)))));
-        break;
-    case 'decode-generic':
-        console.log(JSON.stringify((0, decode_generic_js_1.decodeGeneric)(readInput(args.slice(1))), null, 2));
-        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/cjs/cli.js.map

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

package/dist/cjs/constants.d.ts

@@ -1,8 +0,0 @@
-/**
- * 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>;

package/dist/cjs/constants.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KIND_EXPAND = exports.KIND_ABBREV = void 0;
-/**
- * KindAbbrev maps full kind names to short GCF abbreviations.
- */
-exports.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.
- */
-exports.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/cjs/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,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;AACU,QAAA,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/cjs/decode.d.ts

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

package/dist/cjs/decode.js

@@ -1,197 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.decode = decode;
-const constants_js_1 = require("./constants.js");
-/**
- * Decode parses GCF text back into a Payload.
- */
-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);
-    // v3.1: tool field is optional (SHOULD be present for MCP tool responses, not required).
-    // Detect delta mode.
-    const isDelta = header.includes(' delta=true');
-    const validDeltaSections = new Set(['removed', 'added', 'edges_removed', 'edges_added']);
-    // 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;
-        // Skip ##! summary trailer.
-        if (line.startsWith('##! '))
-            continue;
-        // Group header.
-        if (line.startsWith('## ')) {
-            let group = line.slice(3);
-            // Strip bracket suffix: "edges [200]" -> "edges"
-            const bracketIdx = group.indexOf(' [');
-            if (bracketIdx >= 0) {
-                group = group.slice(0, bracketIdx);
-            }
-            if (isDelta && !validDeltaSections.has(group)) {
-                throw new Error(`malformed_delta: invalid delta section "${group}"`);
-            }
-            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(`invalid_node_line: 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(`invalid_symbol_id: invalid symbol id "${idStr}"`);
-    }
-    let kind = parts[1];
-    if (constants_js_1.KIND_EXPAND[kind]) {
-        kind = constants_js_1.KIND_EXPAND[kind];
-    }
-    const qname = parts[2];
-    const score = parseFloat(parts[3]);
-    if (isNaN(score)) {
-        throw new Error(`invalid_score: 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(`invalid_edge_syntax: 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(`unknown_edge_reference: 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