@vibgrate/cli 2026.801.1 → 2026.803.3

package/dist/{chunk-B3OMGYZZ.js → chunk-PXM3VZYR.js}

@@ -1,6 +1,6 @@
 import { resolveIngestHost } from './chunk-HTLDXEHW.js';
-import { VERSION } from './chunk-TGDHOAXX.js';
-import { cacheDir } from './chunk-ZKNB4YH4.js';
+import { VERSION } from './chunk-7KNFG44U.js';
+import { cacheDir } from './chunk-QMME6TB4.js';
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
@@ -212,5 +212,5 @@ var StatsSharer = class {
 };
 
 export { StatsSharer, installId, isCI, statsEndpoint, telemetryOptOut };
-//# sourceMappingURL=chunk-B3OMGYZZ.js.map
-//# sourceMappingURL=chunk-B3OMGYZZ.js.map
+//# sourceMappingURL=chunk-PXM3VZYR.js.map
+//# sourceMappingURL=chunk-PXM3VZYR.js.map

package/dist/{chunk-B3OMGYZZ.js.map → chunk-PXM3VZYR.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/engine/stats-share.ts"],"names":[],"mappings":"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","file":"chunk-B3OMGYZZ.js","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { cacheDir } from './cache.js';\nimport { VERSION } from '../version.js';\nimport { resolveIngestHost } from '../reporting/regions.js';\nimport type { SavingEntry, Source, Outcome } from './savings.js';\n\n/**\n * Opt-in usage-stats sharing for `vg serve --share-stats`.\n *\n * This is the ONLY path in `vg serve` that sends anything off the machine, and\n * it is off unless the operator explicitly asks for it. What we send is the\n * same counts-only ledger `vg savings` reports locally — per (source, client,\n * tool, outcome): how many calls and the vg-vs-grep token figures — plus the vg\n * version, OS/arch, and a random per-install id. We never send code, file paths,\n * question text, repo identity, or any credential. See GUARDRAILS §3.4.\n *\n * Even when the flag is passed, the universal `DO_NOT_TRACK` opt-out (or\n * `VIBGRATE_TELEMETRY=0`) wins: nothing is uploaded and no install id is ever\n * minted or persisted (see `telemetryOptOut` / `installId`).\n *\n * Design:\n *  - The local ledger (savings.jsonl) is the single source of truth; the flusher\n *    reads only the tail past a persisted byte offset, so a batch is sent once.\n *  - Fire-and-forget with a short timeout. A network problem never blocks a tool\n *    call and never throws — the offset only advances on a confirmed 2xx, so a\n *    failed batch is retried on the next flush.\n *  - Fully offline-safe: under `--local` the sharer is never constructed.\n */\n\n/** Payload schema version — must match the server's `mcpUsageStatsSchema`. */\nconst SCHEMA_VERSION = '1';\n/** Where the offset (and cached install id) live, per repo, beside the ledger. */\nconst OFFSET_FILE = 'stats-share.json';\n/** The machine-global anonymous install id lives here (stable across repos). */\nconst INSTALL_ID_DIR = path.join(os.homedir(), '.vibgrate');\nconst INSTALL_ID_FILE = path.join(INSTALL_ID_DIR, 'install-id');\n/** Give a flush POST a hard ceiling so a hung endpoint never stalls shutdown. */\nconst SEND_TIMEOUT_MS = 4000;\n\n/** One aggregated row of the shared batch — counts only. */\nexport interface StatsRow {\n  source: Source;\n  client: string;\n  tool: string;\n  outcome: Outcome;\n  calls: number;\n  vgTokens: number;\n  baselineTokens: number;\n}\n\n/** The counts-only batch POSTed to the ingest endpoint. */\nexport interface StatsBatch {\n  schemaVersion: string;\n  installId: string;\n  vgVersion: string;\n  os: string;\n  arch: string;\n  windowStart: string;\n  windowEnd: string;\n  totalCalls: number;\n  rows: StatsRow[];\n}\n\n/**\n * The universal opt-out (https://consoledonottrack.com) plus a tool-specific\n * alias, honoured even when `--share-stats` is passed explicitly. Pure function\n * of the environment for testability. Returns the name of the variable that\n * opted out (for the disclosure message), or null when sharing may proceed.\n */\nexport function telemetryOptOut(env: NodeJS.ProcessEnv = process.env): string | null {\n  const dnt = (env.DO_NOT_TRACK ?? '').trim().toLowerCase();\n  if (dnt !== '' && dnt !== '0' && dnt !== 'false') return 'DO_NOT_TRACK';\n  const vt = (env.VIBGRATE_TELEMETRY ?? '').trim().toLowerCase();\n  if (vt === '0' || vt === 'false' || vt === 'off') return 'VIBGRATE_TELEMETRY';\n  return null;\n}\n\n/** Common CI environment markers — a CI runner is never an interactive session. */\nconst CI_ENV_VARS = [\n  'CI',\n  'GITHUB_ACTIONS',\n  'GITLAB_CI',\n  'CIRCLECI',\n  'TRAVIS',\n  'BUILDKITE',\n  'JENKINS_URL',\n  'TF_BUILD',\n] as const;\n\n/** True when running under a recognised CI system. Pure function of the env. */\nexport function isCI(env: NodeJS.ProcessEnv = process.env): boolean {\n  return CI_ENV_VARS.some((v) => {\n    const val = (env[v] ?? '').trim().toLowerCase();\n    return val !== '' && val !== '0' && val !== 'false';\n  });\n}\n\n/**\n * Read (or lazily create) the anonymous per-install id — a random UUID stored in\n * `~/.vibgrate/install-id`. It is *not* tied to the user, the repo, or any\n * account; it only lets us de-duplicate batches from the same install when\n * aggregating. If the home dir isn't writable we fall back to an ephemeral id\n * so sharing still works (it just can't be de-duplicated across restarts).\n *\n * Under an env opt-out no id is ever read or persisted (the sharing path isn't\n * reached then either — this is defence in depth), and on CI runners the id is\n * ephemeral: a persisted id on a shared/throwaway runner would be meaningless\n * for de-duplication and would leave state behind on machines we don't own.\n */\nexport function installId(env: NodeJS.ProcessEnv = process.env): string {\n  if (telemetryOptOut(env) !== null || isCI(env)) return randomUuid();\n  try {\n    const existing = fs.readFileSync(INSTALL_ID_FILE, 'utf8').trim();\n    if (isUuid(existing)) return existing;\n  } catch {\n    /* not created yet */\n  }\n  const id = randomUuid();\n  try {\n    fs.mkdirSync(INSTALL_ID_DIR, { recursive: true });\n    fs.writeFileSync(INSTALL_ID_FILE, id + '\\n', { mode: 0o600 });\n  } catch {\n    /* home dir read-only — use the ephemeral id for this process */\n  }\n  return id;\n}\n\nfunction isUuid(s: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(s);\n}\n\nfunction randomUuid(): string {\n  return randomUUID();\n}\n\n/** Resolve the ingest endpoint: env override wins, else the default region host. */\nexport function statsEndpoint(): string {\n  const override = process.env.VIBGRATE_STATS_ENDPOINT;\n  if (override && /^https?:\\/\\//.test(override)) return override;\n  return `https://${resolveIngestHost()}/v1/ingest/cli-mcp-usage`;\n}\n\nfunction offsetPath(root: string): string {\n  return path.join(cacheDir(root), OFFSET_FILE);\n}\n\nfunction ledgerFilePath(root: string): string {\n  return path.join(cacheDir(root), 'savings.jsonl');\n}\n\nfunction readOffset(root: string): number {\n  try {\n    const raw = JSON.parse(fs.readFileSync(offsetPath(root), 'utf8')) as { offset?: number };\n    return typeof raw.offset === 'number' && raw.offset >= 0 ? raw.offset : 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction writeOffset(root: string, offset: number): void {\n  try {\n    fs.mkdirSync(cacheDir(root), { recursive: true });\n    fs.writeFileSync(offsetPath(root), JSON.stringify({ offset }) + '\\n');\n  } catch {\n    /* best-effort; a lost offset just means one batch may re-send */\n  }\n}\n\n/**\n * Aggregate the ledger entries after `fromOffset` into a counts-only batch.\n * Returns the batch (or null if there's nothing new) and the new byte offset to\n * persist once the batch is confirmed sent.\n */\nexport function buildBatch(\n  root: string,\n  fromOffset: number,\n  id = installId(),\n): { batch: StatsBatch | null; newOffset: number } {\n  const file = ledgerFilePath(root);\n  let size = 0;\n  try {\n    size = fs.statSync(file).size;\n  } catch {\n    return { batch: null, newOffset: 0 };\n  }\n  // The ledger was truncated/recreated under us — re-read from the top.\n  const start = fromOffset > size ? 0 : fromOffset;\n  if (start >= size) return { batch: null, newOffset: size };\n\n  let text = '';\n  try {\n    const fd = fs.openSync(file, 'r');\n    try {\n      const buf = Buffer.alloc(size - start);\n      fs.readSync(fd, buf, 0, buf.length, start);\n      text = buf.toString('utf8');\n    } finally {\n      fs.closeSync(fd);\n    }\n  } catch {\n    return { batch: null, newOffset: fromOffset };\n  }\n\n  // Only whole lines are complete; a trailing partial line (mid-append) is left\n  // for the next flush by rewinding the offset to the last newline.\n  const lastNl = text.lastIndexOf('\\n');\n  if (lastNl < 0) return { batch: null, newOffset: start };\n  const consumed = start + lastNl + 1;\n  const rows = new Map<string, StatsRow>();\n  let total = 0;\n  let minTs = Infinity;\n  let maxTs = -Infinity;\n  for (const line of text.slice(0, lastNl).split('\\n')) {\n    if (!line.trim()) continue;\n    let e: SavingEntry;\n    try {\n      e = JSON.parse(line) as SavingEntry;\n    } catch {\n      continue;\n    }\n    const source: Source = e.source ?? 'mcp';\n    const client = e.client ?? 'unknown';\n    const outcome: Outcome = e.outcome ?? 'complete';\n    const key = `${source}|${client}|${e.tool}|${outcome}`;\n    const row = rows.get(key) ?? {\n      source,\n      client,\n      tool: e.tool,\n      outcome,\n      calls: 0,\n      vgTokens: 0,\n      baselineTokens: 0,\n    };\n    row.calls++;\n    row.vgTokens += e.vgTokens ?? 0;\n    row.baselineTokens += e.baselineTokens ?? 0;\n    rows.set(key, row);\n    total++;\n    if (typeof e.ts === 'number') {\n      if (e.ts < minTs) minTs = e.ts;\n      if (e.ts > maxTs) maxTs = e.ts;\n    }\n  }\n  if (total === 0 || !Number.isFinite(minTs)) return { batch: null, newOffset: consumed };\n  const batch: StatsBatch = {\n    schemaVersion: SCHEMA_VERSION,\n    installId: id,\n    vgVersion: VERSION,\n    os: process.platform,\n    arch: process.arch,\n    windowStart: new Date(minTs).toISOString(),\n    windowEnd: new Date(maxTs).toISOString(),\n    totalCalls: total,\n    rows: [...rows.values()],\n  };\n  return { batch, newOffset: consumed };\n}\n\n/**\n * POST a batch to the endpoint. Never throws; returns whether it was accepted.\n * A short timeout keeps a hung endpoint from stalling the caller (e.g. shutdown).\n */\nasync function postBatch(batch: StatsBatch): Promise<boolean> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), SEND_TIMEOUT_MS);\n  timer.unref?.();\n  try {\n    const res = await fetch(statsEndpoint(), {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', Connection: 'close' },\n      body: JSON.stringify(batch),\n      signal: controller.signal,\n    });\n    return res.ok;\n  } catch {\n    return false;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/**\n * Periodic + on-shutdown flusher for one serve session. Holds the install id and\n * the persisted offset so each flush reads only new ledger lines and advances the\n * offset only when the batch is confirmed sent.\n */\nexport class StatsSharer {\n  private readonly id = installId();\n  private offset: number;\n  private flushing = false;\n\n  constructor(private readonly root: string) {\n    this.offset = readOffset(root);\n  }\n\n  /**\n   * Flush any new ledger entries. Single-flight (a slow POST won't overlap the\n   * next tick). Best-effort: any failure is swallowed and retried next time.\n   */\n  async flush(): Promise<void> {\n    if (this.flushing) return;\n    this.flushing = true;\n    try {\n      const { batch, newOffset } = buildBatch(this.root, this.offset, this.id);\n      if (!batch) {\n        // Nothing to send, but still advance past consumed blank/partial space.\n        if (newOffset > this.offset) {\n          this.offset = newOffset;\n          writeOffset(this.root, newOffset);\n        }\n        return;\n      }\n      const ok = await postBatch(batch);\n      if (ok) {\n        this.offset = newOffset;\n        writeOffset(this.root, newOffset);\n      }\n    } catch {\n      /* never let sharing break serving */\n    } finally {\n      this.flushing = false;\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/engine/stats-share.ts"],"names":[],"mappings":"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","file":"chunk-PXM3VZYR.js","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { cacheDir } from './cache.js';\nimport { VERSION } from '../version.js';\nimport { resolveIngestHost } from '../reporting/regions.js';\nimport type { SavingEntry, Source, Outcome } from './savings.js';\n\n/**\n * Opt-in usage-stats sharing for `vg serve --share-stats`.\n *\n * This is the ONLY path in `vg serve` that sends anything off the machine, and\n * it is off unless the operator explicitly asks for it. What we send is the\n * same counts-only ledger `vg savings` reports locally — per (source, client,\n * tool, outcome): how many calls and the vg-vs-grep token figures — plus the vg\n * version, OS/arch, and a random per-install id. We never send code, file paths,\n * question text, repo identity, or any credential. See GUARDRAILS §3.4.\n *\n * Even when the flag is passed, the universal `DO_NOT_TRACK` opt-out (or\n * `VIBGRATE_TELEMETRY=0`) wins: nothing is uploaded and no install id is ever\n * minted or persisted (see `telemetryOptOut` / `installId`).\n *\n * Design:\n *  - The local ledger (savings.jsonl) is the single source of truth; the flusher\n *    reads only the tail past a persisted byte offset, so a batch is sent once.\n *  - Fire-and-forget with a short timeout. A network problem never blocks a tool\n *    call and never throws — the offset only advances on a confirmed 2xx, so a\n *    failed batch is retried on the next flush.\n *  - Fully offline-safe: under `--local` the sharer is never constructed.\n */\n\n/** Payload schema version — must match the server's `mcpUsageStatsSchema`. */\nconst SCHEMA_VERSION = '1';\n/** Where the offset (and cached install id) live, per repo, beside the ledger. */\nconst OFFSET_FILE = 'stats-share.json';\n/** The machine-global anonymous install id lives here (stable across repos). */\nconst INSTALL_ID_DIR = path.join(os.homedir(), '.vibgrate');\nconst INSTALL_ID_FILE = path.join(INSTALL_ID_DIR, 'install-id');\n/** Give a flush POST a hard ceiling so a hung endpoint never stalls shutdown. */\nconst SEND_TIMEOUT_MS = 4000;\n\n/** One aggregated row of the shared batch — counts only. */\nexport interface StatsRow {\n  source: Source;\n  client: string;\n  tool: string;\n  outcome: Outcome;\n  calls: number;\n  vgTokens: number;\n  baselineTokens: number;\n}\n\n/** The counts-only batch POSTed to the ingest endpoint. */\nexport interface StatsBatch {\n  schemaVersion: string;\n  installId: string;\n  vgVersion: string;\n  os: string;\n  arch: string;\n  windowStart: string;\n  windowEnd: string;\n  totalCalls: number;\n  rows: StatsRow[];\n}\n\n/**\n * The universal opt-out (https://consoledonottrack.com) plus a tool-specific\n * alias, honoured even when `--share-stats` is passed explicitly. Pure function\n * of the environment for testability. Returns the name of the variable that\n * opted out (for the disclosure message), or null when sharing may proceed.\n */\nexport function telemetryOptOut(env: NodeJS.ProcessEnv = process.env): string | null {\n  const dnt = (env.DO_NOT_TRACK ?? '').trim().toLowerCase();\n  if (dnt !== '' && dnt !== '0' && dnt !== 'false') return 'DO_NOT_TRACK';\n  const vt = (env.VIBGRATE_TELEMETRY ?? '').trim().toLowerCase();\n  if (vt === '0' || vt === 'false' || vt === 'off') return 'VIBGRATE_TELEMETRY';\n  return null;\n}\n\n/** Common CI environment markers — a CI runner is never an interactive session. */\nconst CI_ENV_VARS = [\n  'CI',\n  'GITHUB_ACTIONS',\n  'GITLAB_CI',\n  'CIRCLECI',\n  'TRAVIS',\n  'BUILDKITE',\n  'JENKINS_URL',\n  'TF_BUILD',\n] as const;\n\n/** True when running under a recognised CI system. Pure function of the env. */\nexport function isCI(env: NodeJS.ProcessEnv = process.env): boolean {\n  return CI_ENV_VARS.some((v) => {\n    const val = (env[v] ?? '').trim().toLowerCase();\n    return val !== '' && val !== '0' && val !== 'false';\n  });\n}\n\n/**\n * Read (or lazily create) the anonymous per-install id — a random UUID stored in\n * `~/.vibgrate/install-id`. It is *not* tied to the user, the repo, or any\n * account; it only lets us de-duplicate batches from the same install when\n * aggregating. If the home dir isn't writable we fall back to an ephemeral id\n * so sharing still works (it just can't be de-duplicated across restarts).\n *\n * Under an env opt-out no id is ever read or persisted (the sharing path isn't\n * reached then either — this is defence in depth), and on CI runners the id is\n * ephemeral: a persisted id on a shared/throwaway runner would be meaningless\n * for de-duplication and would leave state behind on machines we don't own.\n */\nexport function installId(env: NodeJS.ProcessEnv = process.env): string {\n  if (telemetryOptOut(env) !== null || isCI(env)) return randomUuid();\n  try {\n    const existing = fs.readFileSync(INSTALL_ID_FILE, 'utf8').trim();\n    if (isUuid(existing)) return existing;\n  } catch {\n    /* not created yet */\n  }\n  const id = randomUuid();\n  try {\n    fs.mkdirSync(INSTALL_ID_DIR, { recursive: true });\n    fs.writeFileSync(INSTALL_ID_FILE, id + '\\n', { mode: 0o600 });\n  } catch {\n    /* home dir read-only — use the ephemeral id for this process */\n  }\n  return id;\n}\n\nfunction isUuid(s: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(s);\n}\n\nfunction randomUuid(): string {\n  return randomUUID();\n}\n\n/** Resolve the ingest endpoint: env override wins, else the default region host. */\nexport function statsEndpoint(): string {\n  const override = process.env.VIBGRATE_STATS_ENDPOINT;\n  if (override && /^https?:\\/\\//.test(override)) return override;\n  return `https://${resolveIngestHost()}/v1/ingest/cli-mcp-usage`;\n}\n\nfunction offsetPath(root: string): string {\n  return path.join(cacheDir(root), OFFSET_FILE);\n}\n\nfunction ledgerFilePath(root: string): string {\n  return path.join(cacheDir(root), 'savings.jsonl');\n}\n\nfunction readOffset(root: string): number {\n  try {\n    const raw = JSON.parse(fs.readFileSync(offsetPath(root), 'utf8')) as { offset?: number };\n    return typeof raw.offset === 'number' && raw.offset >= 0 ? raw.offset : 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction writeOffset(root: string, offset: number): void {\n  try {\n    fs.mkdirSync(cacheDir(root), { recursive: true });\n    fs.writeFileSync(offsetPath(root), JSON.stringify({ offset }) + '\\n');\n  } catch {\n    /* best-effort; a lost offset just means one batch may re-send */\n  }\n}\n\n/**\n * Aggregate the ledger entries after `fromOffset` into a counts-only batch.\n * Returns the batch (or null if there's nothing new) and the new byte offset to\n * persist once the batch is confirmed sent.\n */\nexport function buildBatch(\n  root: string,\n  fromOffset: number,\n  id = installId(),\n): { batch: StatsBatch | null; newOffset: number } {\n  const file = ledgerFilePath(root);\n  let size = 0;\n  try {\n    size = fs.statSync(file).size;\n  } catch {\n    return { batch: null, newOffset: 0 };\n  }\n  // The ledger was truncated/recreated under us — re-read from the top.\n  const start = fromOffset > size ? 0 : fromOffset;\n  if (start >= size) return { batch: null, newOffset: size };\n\n  let text = '';\n  try {\n    const fd = fs.openSync(file, 'r');\n    try {\n      const buf = Buffer.alloc(size - start);\n      fs.readSync(fd, buf, 0, buf.length, start);\n      text = buf.toString('utf8');\n    } finally {\n      fs.closeSync(fd);\n    }\n  } catch {\n    return { batch: null, newOffset: fromOffset };\n  }\n\n  // Only whole lines are complete; a trailing partial line (mid-append) is left\n  // for the next flush by rewinding the offset to the last newline.\n  const lastNl = text.lastIndexOf('\\n');\n  if (lastNl < 0) return { batch: null, newOffset: start };\n  const consumed = start + lastNl + 1;\n  const rows = new Map<string, StatsRow>();\n  let total = 0;\n  let minTs = Infinity;\n  let maxTs = -Infinity;\n  for (const line of text.slice(0, lastNl).split('\\n')) {\n    if (!line.trim()) continue;\n    let e: SavingEntry;\n    try {\n      e = JSON.parse(line) as SavingEntry;\n    } catch {\n      continue;\n    }\n    const source: Source = e.source ?? 'mcp';\n    const client = e.client ?? 'unknown';\n    const outcome: Outcome = e.outcome ?? 'complete';\n    const key = `${source}|${client}|${e.tool}|${outcome}`;\n    const row = rows.get(key) ?? {\n      source,\n      client,\n      tool: e.tool,\n      outcome,\n      calls: 0,\n      vgTokens: 0,\n      baselineTokens: 0,\n    };\n    row.calls++;\n    row.vgTokens += e.vgTokens ?? 0;\n    row.baselineTokens += e.baselineTokens ?? 0;\n    rows.set(key, row);\n    total++;\n    if (typeof e.ts === 'number') {\n      if (e.ts < minTs) minTs = e.ts;\n      if (e.ts > maxTs) maxTs = e.ts;\n    }\n  }\n  if (total === 0 || !Number.isFinite(minTs)) return { batch: null, newOffset: consumed };\n  const batch: StatsBatch = {\n    schemaVersion: SCHEMA_VERSION,\n    installId: id,\n    vgVersion: VERSION,\n    os: process.platform,\n    arch: process.arch,\n    windowStart: new Date(minTs).toISOString(),\n    windowEnd: new Date(maxTs).toISOString(),\n    totalCalls: total,\n    rows: [...rows.values()],\n  };\n  return { batch, newOffset: consumed };\n}\n\n/**\n * POST a batch to the endpoint. Never throws; returns whether it was accepted.\n * A short timeout keeps a hung endpoint from stalling the caller (e.g. shutdown).\n */\nasync function postBatch(batch: StatsBatch): Promise<boolean> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), SEND_TIMEOUT_MS);\n  timer.unref?.();\n  try {\n    const res = await fetch(statsEndpoint(), {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', Connection: 'close' },\n      body: JSON.stringify(batch),\n      signal: controller.signal,\n    });\n    return res.ok;\n  } catch {\n    return false;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/**\n * Periodic + on-shutdown flusher for one serve session. Holds the install id and\n * the persisted offset so each flush reads only new ledger lines and advances the\n * offset only when the batch is confirmed sent.\n */\nexport class StatsSharer {\n  private readonly id = installId();\n  private offset: number;\n  private flushing = false;\n\n  constructor(private readonly root: string) {\n    this.offset = readOffset(root);\n  }\n\n  /**\n   * Flush any new ledger entries. Single-flight (a slow POST won't overlap the\n   * next tick). Best-effort: any failure is swallowed and retried next time.\n   */\n  async flush(): Promise<void> {\n    if (this.flushing) return;\n    this.flushing = true;\n    try {\n      const { batch, newOffset } = buildBatch(this.root, this.offset, this.id);\n      if (!batch) {\n        // Nothing to send, but still advance past consumed blank/partial space.\n        if (newOffset > this.offset) {\n          this.offset = newOffset;\n          writeOffset(this.root, newOffset);\n        }\n        return;\n      }\n      const ok = await postBatch(batch);\n      if (ok) {\n        this.offset = newOffset;\n        writeOffset(this.root, newOffset);\n      }\n    } catch {\n      /* never let sharing break serving */\n    } finally {\n      this.flushing = false;\n    }\n  }\n}\n"]}

package/dist/chunk-QMME6TB4.js

@@ -0,0 +1,457 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+// src/engine/serialize.ts
+function serializeGraph(graph, opts) {
+  const indent = opts?.compact ? 0 : 2;
+  return `${stableStringify(graph, indent)}
+`;
+}
+function slimGraphForExport(graph) {
+  return {
+    ...graph,
+    areas: graph.areas.map((a) => ({
+      ...a,
+      members: []
+      // member id lists dominate XL exports; area id still on nodes
+    })),
+    grounding: void 0,
+    facts: graph.facts
+    // Keep summaries/unknowns — small and useful to agents.
+  };
+}
+function stableStringify(value, indent = 2) {
+  return JSON.stringify(sortKeys(value), null, indent);
+}
+function sortKeys(value) {
+  if (Array.isArray(value)) return value.map(sortKeys);
+  if (value && typeof value === "object") {
+    const input = value;
+    const out = {};
+    for (const key of Object.keys(input).sort()) {
+      const v = input[key];
+      if (v === void 0) continue;
+      out[key] = sortKeys(v);
+    }
+    return out;
+  }
+  return value;
+}
+function parseGraph(json) {
+  return JSON.parse(json);
+}
+var CACHE_VERSION = "vg-parse-cache/4";
+function cacheDir(root) {
+  return path.join(root, ".vibgrate", "cache");
+}
+function cachePath(root) {
+  return path.join(cacheDir(root), "parse-cache.json");
+}
+function loadCache(root, opts) {
+  const file = cachePath(root);
+  let data = {
+    version: CACHE_VERSION,
+    toolVersion: opts.toolVersion,
+    grammars: opts.grammars,
+    entries: {}
+  };
+  if (!opts.disabled && fs.existsSync(file)) {
+    try {
+      const loaded = JSON.parse(fs.readFileSync(file, "utf8"));
+      if ((loaded.version === CACHE_VERSION || loaded.version === "vg-parse-cache/3") && loaded.toolVersion === opts.toolVersion && loaded.grammars === opts.grammars && loaded.entries) {
+        data = { ...loaded, version: CACHE_VERSION };
+      }
+    } catch {
+    }
+  }
+  return {
+    get(rel, hash) {
+      const entry = data.entries[rel];
+      return entry && entry.hash === hash ? entry.parse : void 0;
+    },
+    getByStat(rel, mtimeMs, size) {
+      const entry = data.entries[rel];
+      if (!entry) return void 0;
+      if (entry.mtimeMs === mtimeMs && entry.size === size && entry.parse) {
+        return { parse: entry.parse, hash: entry.hash };
+      }
+      return void 0;
+    },
+    set(rel, parse, stat) {
+      data.entries[rel] = {
+        hash: parse.hash,
+        parse,
+        mtimeMs: stat?.mtimeMs,
+        size: stat?.size
+      };
+    },
+    prune(currentRels) {
+      for (const rel of Object.keys(data.entries)) {
+        if (!currentRels.has(rel)) delete data.entries[rel];
+      }
+    },
+    save() {
+      fs.mkdirSync(cacheDir(root), { recursive: true });
+      fs.writeFileSync(file, stableStringify(data, 0));
+    }
+  };
+}
+
+// src/engine/concepts.ts
+var WEAK_TERMS = /* @__PURE__ */ new Set([
+  "add",
+  "adds",
+  "added",
+  "adding",
+  "create",
+  "creates",
+  "created",
+  "creating",
+  "make",
+  "makes",
+  "making",
+  "made",
+  "new",
+  "newly",
+  "remove",
+  "removes",
+  "removed",
+  "removing",
+  "delete",
+  "deletes",
+  "deleted",
+  "deleting",
+  "update",
+  "updates",
+  "updated",
+  "updating",
+  "change",
+  "changes",
+  "changed",
+  "changing",
+  "set",
+  "sets",
+  "setting",
+  "setup",
+  "get",
+  "gets",
+  "getting",
+  "use",
+  "uses",
+  "used",
+  "using",
+  "want",
+  "wants",
+  "wanted",
+  "do",
+  "does",
+  "doing",
+  "done",
+  "support",
+  "supports",
+  "supported",
+  "supporting",
+  "enable",
+  "enables",
+  "enabled",
+  "enabling",
+  "disable",
+  "disables",
+  "disabled",
+  "disabling",
+  "allow",
+  "allows",
+  "allowed",
+  "implement",
+  "implements",
+  "implemented",
+  "implementing",
+  "build",
+  "builds",
+  "building",
+  "built",
+  "via",
+  "through",
+  "into",
+  "onto",
+  "way",
+  "ways",
+  "thing",
+  "things",
+  "stuff",
+  "feature",
+  "features",
+  "functionality",
+  "method",
+  "methods",
+  "option",
+  "options",
+  "ability",
+  "help",
+  "start",
+  "begin",
+  "work",
+  "works",
+  "working",
+  "also",
+  "currently",
+  "properly",
+  "correctly",
+  "please",
+  "happens",
+  "happen",
+  "something",
+  "somewhere",
+  "step",
+  "steps",
+  "flow",
+  "process",
+  "you",
+  "can"
+]);
+var CONCEPTS = {
+  // ---- payments / billing ----
+  payment: ["stripe", "billing", "invoice", "checkout", "charge", "subscription", "refund", "payout", "card", "debit", "mandate"],
+  pay: ["payment", "stripe", "charge", "billing", "invoice"],
+  paid: ["payment", "invoice", "charge"],
+  billing: ["invoice", "payment", "subscription", "stripe", "charge", "renewal"],
+  checkout: ["stripe", "payment", "cart", "session"],
+  debit: ["mandate", "sepa", "bacs", "ach", "bank", "payment"],
+  mandate: ["sepa", "bacs", "debit"],
+  sepa: ["mandate", "debit", "iban", "bank"],
+  bacs: ["mandate", "debit", "bank"],
+  ach: ["mandate", "debit", "bank"],
+  stripe: ["payment", "billing", "checkout", "webhook", "charge", "card"],
+  refund: ["payment", "invoice", "stripe", "charge"],
+  invoice: ["billing", "payment", "refund", "subscription"],
+  subscription: ["billing", "renewal", "invoice", "plan", "recurring"],
+  recurring: ["subscription", "renewal", "mandate", "debit"],
+  renewal: ["subscription", "billing", "renew"],
+  card: ["payment", "charge", "stripe"],
+  credit: ["card", "payment", "charge"],
+  bank: ["debit", "mandate", "sepa", "iban", "account"],
+  charge: ["payment", "card", "stripe"],
+  webhook: ["event", "handler", "callback"],
+  price: ["payment", "billing", "plan"],
+  customer: ["billing", "account", "user"],
+  // ---- auth ----
+  auth: ["login", "session", "token", "oauth", "password", "credential"],
+  authentication: ["auth", "login", "session", "token", "password"],
+  authenticated: ["auth", "login", "session"],
+  login: ["auth", "session", "password", "signin", "oauth"],
+  signin: ["login", "auth", "session"],
+  signup: ["register", "onboard", "account"],
+  logout: ["session", "auth", "signout"],
+  password: ["auth", "login", "credential", "hash"],
+  session: ["auth", "login", "token"],
+  token: ["session", "auth", "jwt"],
+  oauth: ["auth", "login", "callback", "provider"],
+  google: ["oauth", "login", "auth"],
+  github: ["oauth", "login", "auth"],
+  sso: ["oauth", "auth", "saml", "login"],
+  credential: ["auth", "password", "token", "secret"],
+  // ---- dependencies / supply chain ----
+  dependency: ["package", "audit", "vulnerability", "advisory", "lockfile", "version"],
+  package: ["dependency", "audit", "vulnerability", "advisory", "lockfile"],
+  vulnerability: ["advisory", "cve", "osv", "audit", "vulnerable"],
+  vulnerable: ["vulnerability", "advisory", "audit", "cve"],
+  advisory: ["vulnerability", "cve", "osv", "audit"],
+  cve: ["vulnerability", "advisory", "osv"],
+  risk: ["vulnerability", "audit", "advisory"],
+  security: ["vulnerability", "audit", "advisory"],
+  audit: ["dependency", "vulnerability", "advisory"],
+  scan: ["audit", "vulnerability", "scanner"],
+  // ---- notifications / messaging ----
+  email: ["mail", "smtp", "sender", "template", "message"],
+  mail: ["email", "smtp", "sender"],
+  notification: ["notify", "email", "sms", "push", "alert"],
+  notify: ["notification", "email", "alert"],
+  sms: ["notification", "message", "twilio"],
+  // ---- e-commerce ----
+  cart: ["checkout", "order", "shop", "basket", "discount"],
+  basket: ["cart", "checkout", "order"],
+  order: ["cart", "shipment", "fulfillment", "shop", "checkout"],
+  ship: ["order", "fulfillment", "delivery", "shipment"],
+  shipment: ["order", "fulfillment", "delivery", "track"],
+  shipping: ["order", "fulfillment", "delivery", "shipment"],
+  shipped: ["order", "fulfillment", "shipment"],
+  inventory: ["stock", "product", "catalog", "restock"],
+  stock: ["inventory", "product", "restock"],
+  product: ["catalog", "inventory", "shop"],
+  discount: ["coupon", "promo", "cart", "price"],
+  coupon: ["discount", "promo", "code"],
+  // ---- chat / social ----
+  chat: ["message", "room", "conversation", "presence"],
+  message: ["chat", "sms", "notification", "thread"],
+  conversation: ["chat", "message", "thread"],
+  presence: ["online", "typing", "status"],
+  online: ["presence", "status"],
+  typing: ["presence", "indicator", "broadcast"],
+  // ---- media / streaming ----
+  video: ["media", "transcode", "playback", "stream", "thumbnail"],
+  stream: ["video", "playback", "manifest", "media"],
+  streaming: ["video", "playback", "manifest", "media"],
+  playback: ["video", "stream", "media", "watch"],
+  transcode: ["video", "media", "encode"],
+  thumbnail: ["video", "image", "media"],
+  media: ["video", "stream", "playback", "asset"],
+  // ---- analytics ----
+  analytics: ["event", "track", "metric", "funnel", "report"],
+  event: ["track", "analytics", "webhook"],
+  track: ["event", "analytics"],
+  funnel: ["conversion", "analytics", "event"],
+  conversion: ["funnel", "analytics"],
+  report: ["metrics", "export", "analytics"],
+  // ---- content / CMS ----
+  article: ["publish", "content", "post", "cms"],
+  publish: ["article", "release", "post", "content"],
+  post: ["article", "publish", "message"],
+  blog: ["article", "publish", "post", "cms"],
+  content: ["cms", "article", "markdown"],
+  markdown: ["render", "article", "content"],
+  cms: ["article", "content", "publish"],
+  // ---- CI / deployment ----
+  deploy: ["release", "rollback", "pipeline", "deployment"],
+  deployment: ["deploy", "release", "rollback", "pipeline"],
+  release: ["deploy", "version", "rollback"],
+  rollback: ["deploy", "release", "deployment"],
+  pipeline: ["stage", "deploy", "runner", "ci"],
+  canary: ["deploy", "rollout", "release"],
+  // ---- mobile ----
+  push: ["notification", "device", "token", "mobile"],
+  device: ["push", "token", "mobile", "register"],
+  deeplink: ["link", "route", "universal"],
+  mobile: ["push", "device", "deeplink", "app"],
+  ios: ["mobile", "universal", "link", "app"],
+  android: ["mobile", "push", "device", "app"],
+  // ---- batch / ETL / mainframe ----
+  batch: ["settlement", "job", "etl", "reconcile"],
+  settlement: ["batch", "reconcile", "ledger", "clearing"],
+  reconcile: ["ledger", "settlement", "batch"],
+  ledger: ["settlement", "reconcile", "balance", "journal"],
+  mainframe: ["batch", "settlement", "ebcdic", "cobol", "fixed"],
+  ebcdic: ["mainframe", "record", "convert", "legacy"],
+  cobol: ["mainframe", "batch", "ebcdic"],
+  etl: ["batch", "pipeline", "extract", "load", "transform"],
+  nightly: ["batch", "cron", "schedule", "job"],
+  // ---- geo / maps ----
+  geocode: ["address", "location", "map", "geo"],
+  address: ["geocode", "location"],
+  map: ["geo", "route", "location"],
+  route: ["distance", "path", "planner", "geo"],
+  distance: ["route", "haversine", "geo"],
+  location: ["geo", "geocode", "map"],
+  arrival: ["route", "eta", "estimate"],
+  // ---- i18n ----
+  translation: ["locale", "i18n", "language", "translate"],
+  translate: ["translation", "locale", "language"],
+  locale: ["translation", "i18n", "language", "format"],
+  i18n: ["translation", "locale", "language"],
+  language: ["locale", "translation", "i18n"],
+  localized: ["locale", "translation", "format"],
+  // ---- observability ----
+  metric: ["counter", "prometheus", "telemetry", "export"],
+  prometheus: ["metric", "exporter", "monitoring"],
+  trace: ["span", "telemetry", "observability"],
+  span: ["trace", "telemetry"],
+  monitoring: ["metric", "trace", "alert", "observability"],
+  telemetry: ["metric", "trace", "span"],
+  counter: ["metric", "increment"],
+  // ---- feature flags / experimentation ----
+  flag: ["feature", "rollout", "toggle", "experiment"],
+  rollout: ["flag", "percentage", "release", "experiment"],
+  toggle: ["flag", "feature", "switch"],
+  experiment: ["variant", "assign", "flag", "exposure"],
+  variant: ["experiment", "assign"],
+  // ---- generic infrastructure ----
+  database: ["schema", "migration", "sql", "query", "orm"],
+  db: ["database", "schema", "migration", "sql"],
+  migration: ["database", "schema", "migrate", "sql"],
+  cache: ["redis", "ttl", "store"],
+  queue: ["job", "worker", "task", "batch"],
+  job: ["queue", "worker", "cron"],
+  upload: ["file", "storage", "blob", "asset"],
+  storage: ["file", "upload", "bucket", "blob"],
+  permission: ["role", "rbac", "acl", "access", "grant"],
+  role: ["permission", "rbac", "access"],
+  error: ["exception", "failure", "handler"],
+  config: ["settings", "env", "configuration"]
+};
+var BIGRAM_CONCEPTS = {
+  "direct debit": ["debit", "mandate", "sepa", "bacs", "bank"],
+  "direct debits": ["debit", "mandate", "sepa", "bacs", "bank"],
+  "sign in": ["login", "signin", "auth", "session"],
+  "signs in": ["login", "signin", "auth", "session"],
+  "log in": ["login", "auth", "session"],
+  "logs in": ["login", "auth", "session"],
+  "logged in": ["login", "auth", "session"],
+  "sign up": ["signup", "register", "account"],
+  "credit card": ["card", "payment", "charge", "stripe"],
+  "credit cards": ["card", "payment", "charge", "stripe"],
+  "bank transfer": ["bank", "payment", "sepa", "transfer"],
+  "rate limit": ["ratelimit", "throttle", "quota"],
+  "two factor": ["totp", "mfa", "otp", "auth"],
+  "payment method": ["payment", "stripe", "card", "debit"],
+  "payment methods": ["payment", "stripe", "card", "debit"],
+  "push notification": ["push", "device", "token", "notification"],
+  "push notifications": ["push", "device", "token", "notification"],
+  "deep link": ["deeplink", "link", "route"],
+  "deep links": ["deeplink", "link", "route"],
+  "universal link": ["deeplink", "link", "universal"],
+  "universal links": ["deeplink", "link", "universal"],
+  "feature flag": ["flag", "rollout", "toggle", "experiment"],
+  "feature flags": ["flag", "rollout", "toggle", "experiment"],
+  "shopping cart": ["cart", "checkout", "order"],
+  "roll back": ["rollback", "deploy", "release"],
+  "rolled back": ["rollback", "deploy", "release"],
+  "ab test": ["experiment", "variant"],
+  "sign out": ["logout", "session", "auth"],
+  "fixed width": ["record", "export", "mainframe", "batch"]
+};
+function lexiconKey(token) {
+  if (token in CONCEPTS) return token;
+  if (token.endsWith("ies")) {
+    const singular = token.slice(0, -3) + "y";
+    if (singular in CONCEPTS) return singular;
+  }
+  if (token.endsWith("s")) {
+    const singular = token.slice(0, -1);
+    if (singular in CONCEPTS) return singular;
+  }
+  return null;
+}
+function expandConcepts(orderedTokens) {
+  const present = new Set(orderedTokens);
+  const out = [];
+  const emitted = /* @__PURE__ */ new Set();
+  const emit = (term, from) => {
+    if (present.has(term) || emitted.has(term)) return;
+    emitted.add(term);
+    out.push({ term, from });
+  };
+  for (let i = 0; i + 1 < orderedTokens.length; i++) {
+    const bigram = `${orderedTokens[i]} ${orderedTokens[i + 1]}`;
+    const terms = BIGRAM_CONCEPTS[bigram];
+    if (terms) for (const t of terms) emit(t, bigram);
+  }
+  for (const token of orderedTokens) {
+    const key = lexiconKey(token);
+    if (key) for (const t of CONCEPTS[key]) emit(t, token);
+  }
+  return out;
+}
+function bigramConsumedTokens(orderedTokens) {
+  const consumed = /* @__PURE__ */ new Set();
+  for (let i = 0; i + 1 < orderedTokens.length; i++) {
+    const bigram = `${orderedTokens[i]} ${orderedTokens[i + 1]}`;
+    if (!BIGRAM_CONCEPTS[bigram]) continue;
+    for (const tok of [orderedTokens[i], orderedTokens[i + 1]]) {
+      if (!lexiconKey(tok)) consumed.add(tok);
+    }
+  }
+  return consumed;
+}
+
+export { WEAK_TERMS, bigramConsumedTokens, cacheDir, expandConcepts, loadCache, parseGraph, serializeGraph, slimGraphForExport, stableStringify };
+//# sourceMappingURL=chunk-QMME6TB4.js.map
+//# sourceMappingURL=chunk-QMME6TB4.js.map