@remnic/core 1.1.11 → 1.1.13

package/dist/chunk-TMM4S4IJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compat/checks.ts"],"sourcesContent":["import { access, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CompatCheckOptions, CompatCheckResult, CompatReport, CompatRunner } from \"./types.js\";\nimport { compareVersions } from \"../version-utils.js\";\nimport { launchProcess } from \"../runtime/child-process.js\";\nimport { PLUGIN_ID, LEGACY_PLUGIN_ID } from \"../plugin-id.js\";\n\nconst REQUIRED_HOOKS_LEGACY = [\"before_agent_start\", \"agent_end\"];\nconst REQUIRED_HOOKS_NEW = [\"before_prompt_build\", \"agent_end\"];\n\nfunction isSafeCommandToken(command: string): boolean {\n  return /^[a-zA-Z0-9._-]+$/.test(command);\n}\n\nconst defaultRunner: CompatRunner = {\n  async commandExists(command: string): Promise<boolean> {\n    if (!isSafeCommandToken(command)) return false;\n    const binary = process.platform === \"win32\" ? \"where\" : \"which\";\n    const args = [command];\n    return new Promise<boolean>((resolve) => {\n      const child = launchProcess(binary, args, { stdio: \"ignore\" });\n      child.on(\"error\", () => resolve(false));\n      child.on(\"close\", (code) => resolve(code === 0));\n    });\n  },\n};\n\nfunction summarize(checks: CompatCheckResult[]): { ok: number; warn: number; error: number } {\n  const out = { ok: 0, warn: 0, error: 0 };\n  for (const check of checks) {\n    out[check.level] += 1;\n  }\n  return out;\n}\n\nfunction stripCommentsAndStrings(source: string): string {\n  const out: string[] = [];\n  let i = 0;\n  while (i < source.length) {\n    const ch = source[i];\n    const next = source[i + 1];\n\n    if (ch === \"/\" && next === \"/\") {\n      out.push(\" \", \" \");\n      i += 2;\n      while (i < source.length && source[i] !== \"\\n\") {\n        out.push(\" \");\n        i += 1;\n      }\n      continue;\n    }\n\n    if (ch === \"/\" && next === \"*\") {\n      out.push(\" \", \" \");\n      i += 2;\n      while (i < source.length) {\n        const c = source[i];\n        const n = source[i + 1];\n        out.push(c === \"\\n\" ? \"\\n\" : \" \");\n        i += 1;\n        if (c === \"*\" && n === \"/\") {\n          out.push(\" \");\n          i += 1;\n          break;\n        }\n      }\n      continue;\n    }\n\n    if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n      const quote = ch;\n      out.push(\" \");\n      i += 1;\n      while (i < source.length) {\n        const c = source[i];\n        if (c === \"\\\\\") {\n          out.push(\" \");\n          i += 1;\n          if (i < source.length) {\n            out.push(source[i] === \"\\n\" ? \"\\n\" : \" \");\n            i += 1;\n          }\n          continue;\n        }\n        out.push(c === \"\\n\" ? \"\\n\" : \" \");\n        i += 1;\n        if (c === quote) break;\n      }\n      continue;\n    }\n\n    out.push(ch);\n    i += 1;\n  }\n  return out.join(\"\");\n}\n\nfunction parseHookRegistrations(source: string): Set<string> {\n  const hooks = new Set<string>();\n  let i = 0;\n\n  while (i < source.length) {\n    const ch = source[i];\n    const next = source[i + 1];\n\n    if (ch === \"/\" && next === \"/\") {\n      i += 2;\n      while (i < source.length && source[i] !== \"\\n\") i += 1;\n      continue;\n    }\n\n    if (ch === \"/\" && next === \"*\") {\n      i += 2;\n      while (i + 1 < source.length) {\n        if (source[i] === \"*\" && source[i + 1] === \"/\") {\n          i += 2;\n          break;\n        }\n        i += 1;\n      }\n      continue;\n    }\n\n    if (ch === '\"' || ch === \"'\" || ch === \"`\") {\n      const quote = ch;\n      i += 1;\n      while (i < source.length) {\n        if (source[i] === \"\\\\\") {\n          i += 2;\n          continue;\n        }\n        if (source[i] === quote) {\n          i += 1;\n          break;\n        }\n        i += 1;\n      }\n      continue;\n    }\n\n    if (source.startsWith(\"api.on\", i) && (i === 0 || !/[a-zA-Z0-9_$\\.]/.test(source[i - 1]))) {\n      let j = i + \"api.on\".length;\n      while (j < source.length && /\\s/.test(source[j])) j += 1;\n      if (source[j] !== \"(\") {\n        i += 1;\n        continue;\n      }\n\n      j += 1;\n      while (j < source.length && /\\s/.test(source[j])) j += 1;\n      const quote = source[j];\n      if (quote !== '\"' && quote !== \"'\") {\n        i += 1;\n        continue;\n      }\n\n      j += 1;\n      const start = j;\n      while (j < source.length && source[j] !== quote) {\n        if (source[j] === \"\\\\\") {\n          j += 2;\n        } else {\n          j += 1;\n        }\n      }\n      if (j < source.length) {\n        const hook = source.slice(start, j);\n        if (/^[a-z_]+$/.test(hook)) hooks.add(hook);\n        i = j + 1;\n        continue;\n      }\n    }\n\n    i += 1;\n  }\n\n  return hooks;\n}\n\nfunction hasServiceStartRegistration(source: string): boolean {\n  return /api\\.registerService\\s*\\(\\s*\\{[\\s\\S]*?\\bstart\\s*(?::|\\()/m.test(source);\n}\n\nfunction hasCliRegistration(source: string): boolean {\n  return /registerCli\\s*\\([^)]*\\borchestrator\\b[^)]*\\)/m.test(source);\n}\n\nfunction parseCurrentNodeVersion(raw: string): [number, number, number] | null {\n  const normalized = raw.startsWith(\"v\") ? raw.slice(1) : raw;\n  const match = normalized.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n  if (!match) return null;\n  return [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\ntype NodeEngineEvaluation =\n  | { status: \"satisfied\" }\n  | { status: \"unsatisfied\" }\n  | { status: \"unsupported\"; reason: string };\n\ntype ComparatorOperator = \">\" | \">=\" | \"<\" | \"<=\" | \"=\";\n\ninterface ParsedRangeVersion {\n  version: [number, number, number];\n  specifiedParts: number;\n}\n\nfunction parseRangeVersion(raw: string): ParsedRangeVersion | null {\n  const match = raw.trim().match(/^v?(\\d+)(?:\\.(\\d+|x|\\*))?(?:\\.(\\d+|x|\\*))?$/i);\n  if (!match) return null;\n\n  const minor = match[2];\n  const patch = match[3];\n  if (minor && /^(x|\\*)$/i.test(minor)) {\n    return { version: [Number(match[1]), 0, 0], specifiedParts: 1 };\n  }\n  if (patch && /^(x|\\*)$/i.test(patch)) {\n    return {\n      version: [Number(match[1]), Number(minor ?? 0), 0],\n      specifiedParts: 2,\n    };\n  }\n\n  return {\n    version: [Number(match[1]), Number(minor ?? 0), Number(patch ?? 0)],\n    specifiedParts: patch ? 3 : minor ? 2 : 1,\n  };\n}\n\nfunction upperBoundForPartial(\n  parsed: ParsedRangeVersion,\n): [number, number, number] | null {\n  if (parsed.specifiedParts === 1) {\n    return [parsed.version[0] + 1, 0, 0];\n  }\n  if (parsed.specifiedParts === 2) {\n    return [parsed.version[0], parsed.version[1] + 1, 0];\n  }\n  return null;\n}\n\nfunction upperBoundForCaret(\n  parsed: ParsedRangeVersion,\n): [number, number, number] {\n  const [major, minor, patch] = parsed.version;\n  if (parsed.specifiedParts === 1) {\n    return [major + 1, 0, 0];\n  }\n  if (major > 0) return [major + 1, 0, 0];\n  if (parsed.specifiedParts === 2) {\n    return [0, minor + 1, 0];\n  }\n  if (minor > 0) return [0, minor + 1, 0];\n  return [0, 0, patch + 1];\n}\n\nfunction upperBoundForTilde(\n  parsed: ParsedRangeVersion,\n): [number, number, number] {\n  const [major, minor] = parsed.version;\n  if (parsed.specifiedParts === 1) {\n    return [major + 1, 0, 0];\n  }\n  return [major, minor + 1, 0];\n}\n\nfunction compareWithOperator(\n  current: [number, number, number],\n  operator: ComparatorOperator,\n  target: [number, number, number],\n): boolean {\n  const comparison = compareVersions(current, target);\n  switch (operator) {\n    case \">\":\n      return comparison > 0;\n    case \">=\":\n      return comparison >= 0;\n    case \"<\":\n      return comparison < 0;\n    case \"<=\":\n      return comparison <= 0;\n    case \"=\":\n      return comparison === 0;\n  }\n}\n\nfunction evaluateComparatorToken(\n  token: string,\n  current: [number, number, number],\n): NodeEngineEvaluation {\n  const trimmed = token.trim();\n  if (!trimmed || trimmed === \"*\" || /^x$/i.test(trimmed)) {\n    return { status: \"satisfied\" };\n  }\n\n  const shorthand = trimmed.match(/^([~^])\\s*(.+)$/);\n  if (shorthand) {\n    const parsed = parseRangeVersion(shorthand[2]);\n    if (!parsed) {\n      return {\n        status: \"unsupported\",\n        reason: `unsupported node engine comparator \"${trimmed}\"`,\n      };\n    }\n    const upper = shorthand[1] === \"^\"\n      ? upperBoundForCaret(parsed)\n      : upperBoundForTilde(parsed);\n    return compareWithOperator(current, \">=\", parsed.version)\n      && compareWithOperator(current, \"<\", upper)\n      ? { status: \"satisfied\" }\n      : { status: \"unsatisfied\" };\n  }\n\n  const comparator = trimmed.match(/^(>=|<=|>|<|=)?\\s*(.+)$/);\n  if (!comparator) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine comparator \"${trimmed}\"`,\n    };\n  }\n  const operator = (comparator[1] ?? \"=\") as ComparatorOperator;\n  const parsed = parseRangeVersion(comparator[2]);\n  if (!parsed) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine comparator \"${trimmed}\"`,\n    };\n  }\n\n  if (!comparator[1]) {\n    const upper = upperBoundForPartial(parsed);\n    if (upper) {\n      return compareWithOperator(current, \">=\", parsed.version)\n        && compareWithOperator(current, \"<\", upper)\n        ? { status: \"satisfied\" }\n        : { status: \"unsatisfied\" };\n    }\n  }\n\n  const partialUpper = upperBoundForPartial(parsed);\n  if (partialUpper) {\n    switch (operator) {\n      case \"=\":\n        return compareWithOperator(current, \">=\", parsed.version)\n          && compareWithOperator(current, \"<\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \">=\":\n        return compareWithOperator(current, \">=\", parsed.version)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \">\":\n        return compareWithOperator(current, \">=\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \"<=\":\n        return compareWithOperator(current, \"<\", partialUpper)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n      case \"<\":\n        return compareWithOperator(current, \"<\", parsed.version)\n          ? { status: \"satisfied\" }\n          : { status: \"unsatisfied\" };\n    }\n  }\n\n  return compareWithOperator(current, operator, parsed.version)\n    ? { status: \"satisfied\" }\n    : { status: \"unsatisfied\" };\n}\n\nfunction tokenizeRangeAlternative(alternative: string): string[] {\n  const tokens: string[] = [];\n  let i = 0;\n\n  while (i < alternative.length) {\n    while (i < alternative.length && /\\s/.test(alternative[i])) i += 1;\n    if (i >= alternative.length) break;\n\n    let operator = \"\";\n    const ch = alternative[i];\n    if (ch === \">\" || ch === \"<\") {\n      operator = ch;\n      i += 1;\n      if (alternative[i] === \"=\") {\n        operator += \"=\";\n        i += 1;\n      }\n    } else if (ch === \"=\" || ch === \"^\" || ch === \"~\") {\n      operator = ch;\n      i += 1;\n    }\n\n    while (i < alternative.length && /\\s/.test(alternative[i])) i += 1;\n    const versionStart = i;\n    while (i < alternative.length && !/\\s/.test(alternative[i])) i += 1;\n    const version = alternative.slice(versionStart, i);\n    tokens.push(`${operator}${version}`);\n  }\n\n  return tokens;\n}\n\nfunction evaluateHyphenRange(\n  alternative: string,\n  current: [number, number, number],\n): NodeEngineEvaluation | null {\n  const match = alternative.match(/^(.+?)\\s+-\\s+(.+)$/);\n  if (!match) return null;\n\n  const lower = parseRangeVersion(match[1]);\n  const upper = parseRangeVersion(match[2]);\n  if (!lower || !upper) {\n    return {\n      status: \"unsupported\",\n      reason: `unsupported node engine hyphen range \"${alternative}\"`,\n    };\n  }\n\n  const lowerSatisfied = compareWithOperator(current, \">=\", lower.version);\n  const upperBound = upperBoundForPartial(upper);\n  const upperSatisfied = upperBound\n    ? compareWithOperator(current, \"<\", upperBound)\n    : compareWithOperator(current, \"<=\", upper.version);\n  return lowerSatisfied && upperSatisfied\n    ? { status: \"satisfied\" }\n    : { status: \"unsatisfied\" };\n}\n\nfunction evaluateNodeEngineRange(\n  rawRange: string | undefined,\n  currentVersion: [number, number, number],\n): NodeEngineEvaluation {\n  if (!rawRange || rawRange.trim().length === 0) {\n    return { status: \"unsupported\", reason: \"missing node engine range\" };\n  }\n\n  const alternatives = rawRange.split(\"||\").map((part) => part.trim()).filter(Boolean);\n  if (alternatives.length === 0) {\n    return { status: \"unsupported\", reason: \"missing node engine range\" };\n  }\n\n  let firstUnsupported: string | undefined;\n  let hasUnsatisfiedAlternative = false;\n  for (const alternative of alternatives) {\n    const hyphenResult = evaluateHyphenRange(alternative, currentVersion);\n    if (hyphenResult) {\n      if (hyphenResult.status === \"satisfied\") {\n        return { status: \"satisfied\" };\n      }\n      if (hyphenResult.status === \"unsupported\") {\n        firstUnsupported ??= hyphenResult.reason;\n      } else {\n        hasUnsatisfiedAlternative = true;\n      }\n      continue;\n    }\n\n    const tokens = tokenizeRangeAlternative(alternative).filter(Boolean);\n    if (tokens.length === 0) continue;\n    let alternativeSatisfied = true;\n    for (const token of tokens) {\n      const result = evaluateComparatorToken(token, currentVersion);\n      if (result.status === \"unsupported\") {\n        firstUnsupported ??= result.reason;\n        alternativeSatisfied = false;\n        break;\n      }\n      if (result.status === \"unsatisfied\") {\n        hasUnsatisfiedAlternative = true;\n        alternativeSatisfied = false;\n        break;\n      }\n    }\n    if (alternativeSatisfied) {\n      return { status: \"satisfied\" };\n    }\n  }\n\n  if (hasUnsatisfiedAlternative) {\n    return { status: \"unsatisfied\" };\n  }\n  if (firstUnsupported) {\n    return { status: \"unsupported\", reason: firstUnsupported };\n  }\n  return { status: \"unsatisfied\" };\n}\n\nfunction hasMemoryPromptSectionRegistration(source: string): boolean {\n  const apiReceiver = String.raw`(?:\\bapi|\\(\\s*api\\s*\\)|\\(\\s*api\\s+as\\s+[^)]+\\)|\\(\\s*<[^>]+>\\s*api\\s*\\))`;\n  return new RegExp(\n    `${apiReceiver}\\\\s*\\\\??\\\\.\\\\s*registerMemoryPromptSection\\\\s*(?:\\\\?\\\\.)?\\\\s*\\\\(`,\n  ).test(source);\n}\n\nexport async function runCompatChecks(options: CompatCheckOptions): Promise<CompatReport> {\n  const checks: CompatCheckResult[] = [];\n  const runner = options.runner ?? defaultRunner;\n  const pluginJsonPath = path.join(options.repoRoot, \"openclaw.plugin.json\");\n  const packageJsonPath = path.join(options.repoRoot, \"package.json\");\n  const indexPath = path.join(options.repoRoot, \"src\", \"index.ts\");\n\n  let pluginRaw = \"\";\n  let pluginManifestPresent = false;\n  try {\n    pluginRaw = await readFile(pluginJsonPath, \"utf-8\");\n    pluginManifestPresent = true;\n    checks.push({\n      id: \"plugin-manifest-present\",\n      title: \"Plugin manifest present\",\n      level: \"ok\",\n      message: \"Found openclaw.plugin.json\",\n    });\n  } catch {\n    checks.push({\n      id: \"plugin-manifest-present\",\n      title: \"Plugin manifest present\",\n      level: \"error\",\n      message: \"openclaw.plugin.json is missing\",\n      remediation: \"Restore openclaw.plugin.json at repo root with plugin metadata.\",\n    });\n  }\n\n  if (pluginManifestPresent) {\n    try {\n      const plugin = JSON.parse(pluginRaw) as { id?: string; kind?: string };\n      const isValidId = plugin.id === PLUGIN_ID || plugin.id === LEGACY_PLUGIN_ID;\n      if (isValidId && plugin.kind === \"memory\") {\n        checks.push({\n          id: \"plugin-manifest-shape\",\n          title: \"Plugin manifest ID and kind\",\n          level: \"ok\",\n          message: \"Plugin manifest id/kind match expected values.\",\n        });\n      } else {\n        checks.push({\n          id: \"plugin-manifest-shape\",\n          title: \"Plugin manifest ID and kind\",\n          level: \"error\",\n          message: `Unexpected manifest values (id=${String(plugin.id)}, kind=${String(plugin.kind)})`,\n          remediation: `Set manifest id=${PLUGIN_ID} (or ${LEGACY_PLUGIN_ID} for the shim) and kind=memory.`,\n        });\n      }\n    } catch {\n      checks.push({\n        id: \"plugin-manifest-shape\",\n        title: \"Plugin manifest ID and kind\",\n        level: \"error\",\n        message: \"openclaw.plugin.json is not valid JSON\",\n        remediation: \"Fix JSON syntax in openclaw.plugin.json.\",\n      });\n    }\n  }\n\n  let packageRaw = \"\";\n  let packageJsonPresent = false;\n  try {\n    packageRaw = await readFile(packageJsonPath, \"utf-8\");\n    packageJsonPresent = true;\n  } catch {\n    checks.push({\n      id: \"package-json-present\",\n      title: \"package.json present\",\n      level: \"error\",\n      message: \"package.json is missing\",\n      remediation: \"Restore package.json at repo root.\",\n    });\n  }\n\n  if (packageJsonPresent) {\n    try {\n      const pkg = JSON.parse(packageRaw) as {\n        openclaw?: { plugin?: string; extensions?: string[] };\n        engines?: { node?: string };\n      };\n      const pluginPathOk = pkg.openclaw?.plugin === \"./openclaw.plugin.json\";\n      const extOk = Array.isArray(pkg.openclaw?.extensions)\n        && pkg.openclaw?.extensions.includes(\"./dist/index.js\");\n      if (pluginPathOk && extOk) {\n        checks.push({\n          id: \"package-openclaw-exports\",\n          title: \"package.json OpenClaw export wiring\",\n          level: \"ok\",\n          message: \"package.json openclaw.plugin/extensions wiring looks valid.\",\n        });\n      } else {\n        checks.push({\n          id: \"package-openclaw-exports\",\n          title: \"package.json OpenClaw export wiring\",\n          level: \"error\",\n          message: \"package.json openclaw plugin/extension wiring is missing or invalid.\",\n          remediation: \"Set openclaw.plugin to ./openclaw.plugin.json and include ./dist/index.js in openclaw.extensions.\",\n        });\n      }\n\n      const currentNode = options.currentNodeVersion ?? process.version;\n      const currentVersion = parseCurrentNodeVersion(currentNode);\n      const engineEvaluation: NodeEngineEvaluation = currentVersion\n        ? evaluateNodeEngineRange(pkg.engines?.node, currentVersion)\n        : { status: \"unsupported\", reason: \"unable to parse current Node version\" };\n      if (engineEvaluation.status === \"unsupported\") {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"warn\",\n          message: `Unable to evaluate node engine/current version: ${engineEvaluation.reason}.`,\n          remediation: \"Confirm Node version meets package.json engines.node requirement.\",\n          metadata: { enginesNode: pkg.engines?.node, currentNode },\n        });\n      } else if (engineEvaluation.status === \"satisfied\") {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"ok\",\n          message: `Current Node ${currentNode} satisfies engines requirement ${pkg.engines?.node}.`,\n        });\n      } else {\n        checks.push({\n          id: \"node-version-compat\",\n          title: \"Node runtime compatibility\",\n          level: \"error\",\n          message: `Current Node ${currentNode} does not satisfy engines requirement ${pkg.engines?.node}.`,\n          remediation: \"Upgrade Node runtime to meet package.json engines.node minimum.\",\n        });\n      }\n    } catch {\n      checks.push({\n        id: \"package-json-parse\",\n        title: \"package.json parse\",\n        level: \"error\",\n        message: \"package.json is not valid JSON\",\n        remediation: \"Fix JSON syntax in package.json.\",\n      });\n    }\n  }\n\n  try {\n    await access(indexPath);\n    const indexRaw = await readFile(indexPath, \"utf-8\");\n    const structuralSource = stripCommentsAndStrings(indexRaw);\n    const hooks = parseHookRegistrations(indexRaw);\n    const missingLegacy = REQUIRED_HOOKS_LEGACY.filter((hook) => !hooks.has(hook));\n    const missingNew = REQUIRED_HOOKS_NEW.filter((hook) => !hooks.has(hook));\n    // registerMemoryPromptSection is a valid alternative to the recall hook only\n    // when it is registered on the OpenClaw plugin API object.\n    const hasMemoryPromptSection = hasMemoryPromptSectionRegistration(structuralSource);\n    const missingLegacyAdj = hasMemoryPromptSection\n      ? missingLegacy.filter((h) => h !== \"before_agent_start\")\n      : missingLegacy;\n    const missingNewAdj = hasMemoryPromptSection\n      ? missingNew.filter((h) => h !== \"before_prompt_build\")\n      : missingNew;\n    // Accept whichever hook set has fewer missing entries\n    const missingHooks = missingNewAdj.length <= missingLegacyAdj.length ? missingNewAdj : missingLegacyAdj;\n    const hasGatewayStartHook = hooks.has(\"gateway_start\");\n    const hasServiceStart = hasServiceStartRegistration(structuralSource);\n    if (missingHooks.length === 0 && (hasGatewayStartHook || hasServiceStart)) {\n      checks.push({\n        id: \"hook-registration-core\",\n        title: \"Core hook registration\",\n        level: \"ok\",\n        message: \"Core recall/extraction hooks and startup wiring are registered in src/index.ts.\",\n      });\n    } else {\n      const missingParts: string[] = [];\n      if (missingHooks.length > 0) {\n        missingParts.push(`hooks: ${missingHooks.join(\", \")}`);\n      }\n      if (!hasGatewayStartHook && !hasServiceStart) {\n        missingParts.push(\"startup wiring: gateway_start hook or api.registerService({ start })\");\n      }\n      checks.push({\n        id: \"hook-registration-core\",\n        title: \"Core hook registration\",\n        level: \"error\",\n        message: `Missing expected registration(s): ${missingParts.join(\"; \")}`,\n        remediation: \"Ensure src/index.ts registers before_prompt_build (or before_agent_start) and agent_end, plus either gateway_start or api.registerService({ start }).\",\n      });\n    }\n\n    const cliWired = hasCliRegistration(structuralSource);\n    checks.push({\n      id: \"cli-registration\",\n      title: \"CLI registration wiring\",\n      level: cliWired ? \"ok\" : \"warn\",\n      message: cliWired\n        ? \"CLI registration is wired in plugin bootstrap.\"\n        : \"CLI registration call not found in src/index.ts.\",\n      remediation: cliWired ? undefined : \"Call registerCli(api, orchestrator) during plugin registration.\",\n    });\n  } catch {\n    checks.push({\n      id: \"hook-registration-core\",\n      title: \"Core hook registration\",\n      level: \"error\",\n      message: \"src/index.ts is missing; cannot validate hook wiring.\",\n      remediation: \"Restore src/index.ts and register required hooks.\",\n    });\n  }\n\n  const qmdAvailable = await runner.commandExists(\"qmd\");\n  checks.push({\n    id: \"qmd-binary-availability\",\n    title: \"QMD binary availability\",\n    level: qmdAvailable ? \"ok\" : \"warn\",\n    message: qmdAvailable\n      ? \"qmd binary is available in PATH.\"\n      : \"qmd binary is not available in PATH.\",\n    remediation: qmdAvailable ? undefined : \"Install qmd or configure qmdPath in plugin config.\",\n  });\n\n  return {\n    generatedAt: (options.now ?? new Date()).toISOString(),\n    checks,\n    summary: summarize(checks),\n  };\n}\n"],"mappings":"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","names":["parsed"]}

package/dist/chunk-TMQLARTH.js

@@ -0,0 +1,188 @@
+import {
+  scanMemoryDir
+} from "./chunk-MJFNCJXV.js";
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/search/meilisearch-backend.ts
+var MeilisearchBackend = class {
+  host;
+  apiKey;
+  collection;
+  timeoutMs;
+  autoIndex;
+  memoryDir;
+  available = false;
+  client = null;
+  meiliModule = null;
+  constructor(opts) {
+    this.host = opts.host;
+    this.apiKey = opts.apiKey;
+    this.collection = opts.collection;
+    this.timeoutMs = opts.timeoutMs ?? 3e4;
+    this.autoIndex = opts.autoIndex ?? false;
+    this.memoryDir = opts.memoryDir;
+  }
+  async probe() {
+    try {
+      const client = await this.ensureClient();
+      await client.health();
+      this.available = true;
+      return true;
+    } catch (err) {
+      log.debug(`MeilisearchBackend probe failed: ${err}`);
+      this.available = false;
+      return false;
+    }
+  }
+  isAvailable() {
+    return this.available;
+  }
+  debugStatus() {
+    return `backend=meilisearch available=${this.available} host=${this.host}`;
+  }
+  async search(query, collection, maxResults, _options, _execution) {
+    try {
+      return await this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: "default" } }, collection, true);
+    } catch {
+      return this.bm25Search(query, collection, maxResults);
+    }
+  }
+  async searchGlobal(query, maxResults, _execution) {
+    const limit = maxResults ?? 10;
+    if (!this.available) return [];
+    try {
+      const client = await this.ensureClient();
+      const indexes = await client.getIndexes();
+      const queries = (indexes.results ?? []).map((idx) => ({
+        indexUid: idx.uid,
+        q: query,
+        limit,
+        showRankingScore: true
+      }));
+      if (queries.length === 0) return [];
+      const multiResult = await client.multiSearch({ queries });
+      const allResults = [];
+      for (const result of multiResult.results ?? []) {
+        allResults.push(...this.mapHits(result.hits ?? []));
+      }
+      allResults.sort((a, b) => b.score - a.score);
+      return allResults.slice(0, limit);
+    } catch (err) {
+      log.debug(`MeilisearchBackend searchGlobal failed: ${err}`);
+      return [];
+    }
+  }
+  async bm25Search(query, collection, maxResults, _execution) {
+    return this.doSearch(query, maxResults ?? 10, void 0, collection);
+  }
+  async vectorSearch(query, collection, maxResults, _execution) {
+    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 1, embedder: "default" } }, collection);
+  }
+  async hybridSearch(query, collection, maxResults, _execution) {
+    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: "default" } }, collection);
+  }
+  async update(execution) {
+    await this.updateCollection(this.collection, execution);
+  }
+  async updateCollection(collection, _execution) {
+    if (!this.autoIndex || !this.memoryDir) return;
+    if (!this.available) return;
+    try {
+      const client = await this.ensureClient();
+      const docs = await scanMemoryDir(this.memoryDir);
+      const index = client.index(collection);
+      const meilDocs = docs.map((d) => ({
+        id: d.docid,
+        path: d.path,
+        content: d.content,
+        snippet: d.snippet
+      }));
+      const addTask = await index.addDocuments(meilDocs, { primaryKey: "id" });
+      await client.waitForTask(addTask.taskUid, { timeOutMs: this.timeoutMs });
+      const currentIds = new Set(docs.map((d) => d.docid));
+      try {
+        const PAGE_SIZE = 1e3;
+        let offset = 0;
+        let staleIds = [];
+        let hasMore = true;
+        while (hasMore) {
+          const page = await index.getDocuments({ limit: PAGE_SIZE, offset, fields: ["id"] });
+          const results = page.results ?? [];
+          for (const doc of results) {
+            const id = doc.id;
+            if (!currentIds.has(id)) staleIds.push(id);
+          }
+          offset += results.length;
+          hasMore = results.length === PAGE_SIZE;
+        }
+        if (staleIds.length > 0) {
+          const delTask = await index.deleteDocuments(staleIds);
+          await client.waitForTask(delTask.taskUid, { timeOutMs: this.timeoutMs });
+        }
+      } catch {
+      }
+    } catch (err) {
+      log.debug(`MeilisearchBackend update failed: ${err}`);
+    }
+  }
+  async embed() {
+  }
+  async embedCollection(collection) {
+  }
+  async ensureCollection(_memoryDir) {
+    if (!this.available) return "skipped";
+    try {
+      const client = await this.ensureClient();
+      try {
+        await client.getIndex(this.collection);
+        return "present";
+      } catch {
+        await client.createIndex(this.collection, { primaryKey: "id" });
+        return "present";
+      }
+    } catch {
+      return "skipped";
+    }
+  }
+  async ensureClient() {
+    if (this.client) return this.client;
+    if (!this.meiliModule) {
+      this.meiliModule = await import("meilisearch");
+    }
+    const MeiliSearch = this.meiliModule.MeiliSearch ?? this.meiliModule.default?.MeiliSearch;
+    this.client = new MeiliSearch({
+      host: this.host,
+      apiKey: this.apiKey,
+      timeout: this.timeoutMs
+    });
+    return this.client;
+  }
+  async doSearch(query, limit, extra, collection, rethrow = false) {
+    if (!this.available) return [];
+    try {
+      const client = await this.ensureClient();
+      const index = client.index(collection ?? this.collection);
+      const result = await index.search(query, { limit, showRankingScore: true, ...extra });
+      return this.mapHits(result.hits ?? []);
+    } catch (err) {
+      log.debug(`MeilisearchBackend search failed: ${err}`);
+      if (rethrow) throw err;
+      return [];
+    }
+  }
+  mapHits(hits) {
+    return hits.map((hit) => ({
+      docid: hit.id ?? "",
+      path: hit.path ?? "",
+      snippet: hit._formatted?.content ?? hit.snippet ?? hit.content?.slice(0, 200) ?? "",
+      score: hit._rankingScore ?? 0.5
+    }));
+  }
+};
+
+export {
+  MeilisearchBackend
+};
+//# sourceMappingURL=chunk-TMQLARTH.js.map

package/dist/chunk-TMQLARTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/meilisearch-backend.ts"],"sourcesContent":["import { log } from \"../logger.js\";\nimport type { SearchBackend, SearchExecutionOptions, SearchQueryOptions, SearchResult } from \"./port.js\";\nimport { scanMemoryDir } from \"./document-scanner.js\";\n\nexport interface MeilisearchBackendOptions {\n  host: string;\n  apiKey?: string;\n  collection: string;\n  timeoutMs?: number;\n  autoIndex?: boolean;\n  memoryDir?: string;\n}\n\n/**\n * Meilisearch search backend — server-based SDK client.\n *\n * Requires a running Meilisearch instance. Uses the official `meilisearch` SDK.\n * When `autoIndex` is true, update() pushes docs from the local memory directory.\n */\nexport class MeilisearchBackend implements SearchBackend {\n  private readonly host: string;\n  private readonly apiKey?: string;\n  private readonly collection: string;\n  private readonly timeoutMs: number;\n  private readonly autoIndex: boolean;\n  private readonly memoryDir?: string;\n  private available = false;\n  private client: any = null;\n  private meiliModule: any = null;\n\n  constructor(opts: MeilisearchBackendOptions) {\n    this.host = opts.host;\n    this.apiKey = opts.apiKey;\n    this.collection = opts.collection;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n    this.autoIndex = opts.autoIndex ?? false;\n    this.memoryDir = opts.memoryDir;\n  }\n\n  async probe(): Promise<boolean> {\n    try {\n      const client = await this.ensureClient();\n      await client.health();\n      this.available = true;\n      return true;\n    } catch (err) {\n      log.debug(`MeilisearchBackend probe failed: ${err}`);\n      this.available = false;\n      return false;\n    }\n  }\n\n  isAvailable(): boolean {\n    return this.available;\n  }\n\n  debugStatus(): string {\n    return `backend=meilisearch available=${this.available} host=${this.host}`;\n  }\n\n  async search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    _options?: SearchQueryOptions,\n    _execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]> {\n    // Try hybrid first; fall back to plain FTS only if hybrid throws (e.g. no embedder configured)\n    try {\n      return await this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: \"default\" } }, collection, true);\n    } catch {\n      return this.bm25Search(query, collection, maxResults);\n    }\n  }\n\n  async searchGlobal(query: string, maxResults?: number, _execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    const limit = maxResults ?? 10;\n    if (!this.available) return [];\n\n    try {\n      const client = await this.ensureClient();\n      const indexes = await client.getIndexes();\n      const queries = (indexes.results ?? []).map((idx: any) => ({\n        indexUid: idx.uid,\n        q: query,\n        limit,\n        showRankingScore: true,\n      }));\n      if (queries.length === 0) return [];\n\n      const multiResult = await client.multiSearch({ queries });\n      const allResults: SearchResult[] = [];\n      for (const result of multiResult.results ?? []) {\n        allResults.push(...this.mapHits(result.hits ?? []));\n      }\n      allResults.sort((a, b) => b.score - a.score);\n      return allResults.slice(0, limit);\n    } catch (err) {\n      log.debug(`MeilisearchBackend searchGlobal failed: ${err}`);\n      return [];\n    }\n  }\n\n  async bm25Search(query: string, collection?: string, maxResults?: number, _execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, undefined, collection);\n  }\n\n  async vectorSearch(query: string, collection?: string, maxResults?: number, _execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 1.0, embedder: \"default\" } }, collection);\n  }\n\n  async hybridSearch(query: string, collection?: string, maxResults?: number, _execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: \"default\" } }, collection);\n  }\n\n  async update(execution?: SearchExecutionOptions): Promise<void> {\n    await this.updateCollection(this.collection, execution);\n  }\n\n  async updateCollection(collection: string, _execution?: SearchExecutionOptions): Promise<void> {\n    if (!this.autoIndex || !this.memoryDir) return;\n    if (!this.available) return;\n\n    try {\n      const client = await this.ensureClient();\n      const docs = await scanMemoryDir(this.memoryDir);\n      const index = client.index(collection);\n\n      const meilDocs = docs.map((d) => ({\n        id: d.docid,\n        path: d.path,\n        content: d.content,\n        snippet: d.snippet,\n      }));\n\n      // Upsert current docs and wait for the task to complete\n      const addTask = await index.addDocuments(meilDocs, { primaryKey: \"id\" });\n      await client.waitForTask(addTask.taskUid, { timeOutMs: this.timeoutMs });\n\n      // Remove docs that no longer exist on disk (paginated to handle large indexes)\n      const currentIds = new Set(docs.map((d) => d.docid));\n      try {\n        const PAGE_SIZE = 1000;\n        let offset = 0;\n        let staleIds: string[] = [];\n        let hasMore = true;\n        while (hasMore) {\n          const page = await index.getDocuments({ limit: PAGE_SIZE, offset, fields: [\"id\"] });\n          const results = page.results ?? [];\n          for (const doc of results) {\n            const id = doc.id as string;\n            if (!currentIds.has(id)) staleIds.push(id);\n          }\n          offset += results.length;\n          hasMore = results.length === PAGE_SIZE;\n        }\n        if (staleIds.length > 0) {\n          const delTask = await index.deleteDocuments(staleIds);\n          await client.waitForTask(delTask.taskUid, { timeOutMs: this.timeoutMs });\n        }\n      } catch {\n        // Deletion cleanup is best-effort\n      }\n    } catch (err) {\n      log.debug(`MeilisearchBackend update failed: ${err}`);\n    }\n  }\n\n  async embed(): Promise<void> {\n    // Meilisearch handles its own embedding when configured with an embedder\n  }\n\n  async embedCollection(collection: string): Promise<void> {\n    // Meilisearch handles its own embedding when configured with an embedder\n    // The collection parameter is accepted for interface compliance but Meilisearch\n    // manages embeddings server-side per index (collection).\n  }\n\n  async ensureCollection(_memoryDir: string): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\"> {\n    if (!this.available) return \"skipped\";\n    try {\n      const client = await this.ensureClient();\n      try {\n        await client.getIndex(this.collection);\n        return \"present\";\n      } catch {\n        // Index doesn't exist — create it\n        await client.createIndex(this.collection, { primaryKey: \"id\" });\n        return \"present\";\n      }\n    } catch {\n      return \"skipped\";\n    }\n  }\n\n  private async ensureClient(): Promise<any> {\n    if (this.client) return this.client;\n    if (!this.meiliModule) {\n      this.meiliModule = await import(\"meilisearch\");\n    }\n    const MeiliSearch = this.meiliModule.MeiliSearch ?? this.meiliModule.default?.MeiliSearch;\n    this.client = new MeiliSearch({\n      host: this.host,\n      apiKey: this.apiKey,\n      timeout: this.timeoutMs,\n    });\n    return this.client;\n  }\n\n  private async doSearch(query: string, limit: number, extra?: Record<string, unknown>, collection?: string, rethrow = false): Promise<SearchResult[]> {\n    if (!this.available) return [];\n    try {\n      const client = await this.ensureClient();\n      const index = client.index(collection ?? this.collection);\n      const result = await index.search(query, { limit, showRankingScore: true, ...extra });\n      return this.mapHits(result.hits ?? []);\n    } catch (err) {\n      log.debug(`MeilisearchBackend search failed: ${err}`);\n      if (rethrow) throw err;\n      return [];\n    }\n  }\n\n  private mapHits(hits: any[]): SearchResult[] {\n    return hits.map((hit) => ({\n      docid: hit.id ?? \"\",\n      path: hit.path ?? \"\",\n      snippet: hit._formatted?.content ?? hit.snippet ?? hit.content?.slice(0, 200) ?? \"\",\n      score: hit._rankingScore ?? 0.5,\n    }));\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TPDBFYEG.js

@@ -0,0 +1,130 @@
+// src/lcm/queue.ts
+var LcmWorkQueue = class {
+  concurrency;
+  worker;
+  hooks;
+  pending = /* @__PURE__ */ new Map();
+  inFlightSessions = /* @__PURE__ */ new Set();
+  inFlight = 0;
+  idleWaiters = [];
+  sessionIdleWaiters = /* @__PURE__ */ new Map();
+  drainScheduled = false;
+  constructor(options) {
+    this.concurrency = Math.max(1, Math.floor(options.concurrency ?? 1));
+    this.worker = options.worker;
+    this.hooks = options.hooks ?? {};
+  }
+  enqueue(sessionId, messages) {
+    if (messages.length === 0) return;
+    const now = Date.now();
+    const existing = this.pending.get(sessionId);
+    if (existing) {
+      existing.messages.push(...messages.map((message) => ({ ...message })));
+    } else {
+      this.pending.set(sessionId, {
+        sessionId,
+        messages: messages.map((message) => ({ ...message })),
+        enqueuedAt: now
+      });
+    }
+    this.scheduleDrain();
+  }
+  get depth() {
+    return this.pending.size;
+  }
+  get inFlightCount() {
+    return this.inFlight;
+  }
+  async whenIdle() {
+    if (this.depth === 0 && this.inFlight === 0) return;
+    await new Promise((resolve) => {
+      this.idleWaiters.push(resolve);
+    });
+  }
+  async whenSessionIdle(sessionId) {
+    if (!this.pending.has(sessionId) && !this.inFlightSessions.has(sessionId))
+      return;
+    await new Promise((resolve) => {
+      const waiters = this.sessionIdleWaiters.get(sessionId) ?? [];
+      waiters.push(resolve);
+      this.sessionIdleWaiters.set(sessionId, waiters);
+    });
+  }
+  startAvailableJobs() {
+    while (this.inFlight < this.concurrency && this.pending.size > 0) {
+      const next = Array.from(this.pending.entries()).find(
+        ([sessionId2]) => !this.inFlightSessions.has(sessionId2)
+      );
+      if (!next) break;
+      const [sessionId, job] = next;
+      this.pending.delete(sessionId);
+      this.inFlight++;
+      this.inFlightSessions.add(sessionId);
+      const startedAt = Date.now();
+      const waitMs = startedAt - job.enqueuedAt;
+      this.hooks.onJobStart?.({
+        sessionId,
+        depth: this.depth,
+        inFlight: this.inFlight,
+        waitMs
+      });
+      void this.runJob(job, startedAt, waitMs);
+    }
+    this.resolveIdleWaitersIfNeeded();
+  }
+  scheduleDrain() {
+    if (this.drainScheduled) return;
+    this.drainScheduled = true;
+    queueMicrotask(() => {
+      this.drainScheduled = false;
+      this.startAvailableJobs();
+    });
+  }
+  async runJob(job, startedAt, waitMs) {
+    let error;
+    try {
+      await this.worker(job.sessionId, job.messages);
+    } catch (err) {
+      error = err;
+    } finally {
+      const finishedAt = Date.now();
+      const runMs = finishedAt - startedAt;
+      const totalMs = finishedAt - job.enqueuedAt;
+      this.inFlight--;
+      this.inFlightSessions.delete(job.sessionId);
+      this.hooks.onJobFinish?.({
+        sessionId: job.sessionId,
+        depth: this.depth,
+        inFlight: this.inFlight,
+        waitMs,
+        runMs,
+        totalMs,
+        error
+      });
+      if (this.pending.size > 0) {
+        this.scheduleDrain();
+      } else {
+        this.resolveIdleWaitersIfNeeded();
+      }
+      this.resolveSessionIdleWaitersIfNeeded(job.sessionId);
+    }
+  }
+  resolveIdleWaitersIfNeeded() {
+    if (this.depth !== 0 || this.inFlight !== 0) return;
+    const waiters = this.idleWaiters.splice(0, this.idleWaiters.length);
+    for (const resolve of waiters) resolve();
+  }
+  resolveSessionIdleWaitersIfNeeded(sessionId) {
+    if (this.pending.has(sessionId) || this.inFlightSessions.has(sessionId))
+      return;
+    const waiters = this.sessionIdleWaiters.get(sessionId);
+    if (!waiters || waiters.length === 0) return;
+    this.sessionIdleWaiters.delete(sessionId);
+    for (const resolve of waiters) resolve();
+  }
+};
+
+export {
+  LcmWorkQueue
+};
+//# sourceMappingURL=chunk-TPDBFYEG.js.map

package/dist/chunk-TPDBFYEG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lcm/queue.ts"],"sourcesContent":["export interface LcmObserveMessage {\n  role: string;\n  content: string;\n  parts?: import(\"../message-parts/index.js\").LcmMessagePartInput[];\n  rawContent?: unknown;\n  sourceFormat?: import(\"../message-parts/index.js\").MessagePartSourceFormat;\n}\n\nexport interface LcmWorkQueueHooks {\n  onJobStart?: (input: {\n    sessionId: string;\n    depth: number;\n    inFlight: number;\n    waitMs: number;\n  }) => void;\n  onJobFinish?: (input: {\n    sessionId: string;\n    depth: number;\n    inFlight: number;\n    waitMs: number;\n    runMs: number;\n    totalMs: number;\n    error?: unknown;\n  }) => void;\n}\n\nexport interface LcmWorkQueueOptions {\n  concurrency?: number;\n  worker: (sessionId: string, messages: LcmObserveMessage[]) => Promise<void>;\n  hooks?: LcmWorkQueueHooks;\n}\n\ninterface PendingJob {\n  sessionId: string;\n  messages: LcmObserveMessage[];\n  enqueuedAt: number;\n}\n\n/**\n * Small keyed work queue for LCM observe processing.\n *\n * Jobs are coalesced per session while they are pending. A session can have\n * at most one in-flight job at a time, and the queue processes jobs FIFO up to\n * the configured concurrency limit.\n */\nexport class LcmWorkQueue {\n  private readonly concurrency: number;\n  private readonly worker: (\n    sessionId: string,\n    messages: LcmObserveMessage[],\n  ) => Promise<void>;\n  private readonly hooks: LcmWorkQueueHooks;\n  private readonly pending = new Map<string, PendingJob>();\n  private readonly inFlightSessions = new Set<string>();\n  private inFlight = 0;\n  private readonly idleWaiters: Array<() => void> = [];\n  private readonly sessionIdleWaiters = new Map<string, Array<() => void>>();\n  private drainScheduled = false;\n\n  constructor(options: LcmWorkQueueOptions) {\n    this.concurrency = Math.max(1, Math.floor(options.concurrency ?? 1));\n    this.worker = options.worker;\n    this.hooks = options.hooks ?? {};\n  }\n\n  enqueue(sessionId: string, messages: LcmObserveMessage[]): void {\n    if (messages.length === 0) return;\n\n    const now = Date.now();\n    const existing = this.pending.get(sessionId);\n    if (existing) {\n      existing.messages.push(...messages.map((message) => ({ ...message })));\n    } else {\n      this.pending.set(sessionId, {\n        sessionId,\n        messages: messages.map((message) => ({ ...message })),\n        enqueuedAt: now,\n      });\n    }\n\n    this.scheduleDrain();\n  }\n\n  get depth(): number {\n    return this.pending.size;\n  }\n\n  get inFlightCount(): number {\n    return this.inFlight;\n  }\n\n  async whenIdle(): Promise<void> {\n    if (this.depth === 0 && this.inFlight === 0) return;\n    await new Promise<void>((resolve) => {\n      this.idleWaiters.push(resolve);\n    });\n  }\n\n  async whenSessionIdle(sessionId: string): Promise<void> {\n    if (!this.pending.has(sessionId) && !this.inFlightSessions.has(sessionId))\n      return;\n    await new Promise<void>((resolve) => {\n      const waiters = this.sessionIdleWaiters.get(sessionId) ?? [];\n      waiters.push(resolve);\n      this.sessionIdleWaiters.set(sessionId, waiters);\n    });\n  }\n\n  private startAvailableJobs(): void {\n    while (this.inFlight < this.concurrency && this.pending.size > 0) {\n      const next = Array.from(this.pending.entries()).find(\n        ([sessionId]) => !this.inFlightSessions.has(sessionId),\n      );\n      if (!next) break;\n\n      const [sessionId, job] = next;\n      this.pending.delete(sessionId);\n      this.inFlight++;\n      this.inFlightSessions.add(sessionId);\n\n      const startedAt = Date.now();\n      const waitMs = startedAt - job.enqueuedAt;\n      this.hooks.onJobStart?.({\n        sessionId,\n        depth: this.depth,\n        inFlight: this.inFlight,\n        waitMs,\n      });\n\n      void this.runJob(job, startedAt, waitMs);\n    }\n\n    this.resolveIdleWaitersIfNeeded();\n  }\n\n  private scheduleDrain(): void {\n    if (this.drainScheduled) return;\n    this.drainScheduled = true;\n\n    queueMicrotask(() => {\n      this.drainScheduled = false;\n      this.startAvailableJobs();\n    });\n  }\n\n  private async runJob(\n    job: PendingJob,\n    startedAt: number,\n    waitMs: number,\n  ): Promise<void> {\n    let error: unknown;\n\n    try {\n      await this.worker(job.sessionId, job.messages);\n    } catch (err) {\n      error = err;\n    } finally {\n      const finishedAt = Date.now();\n      const runMs = finishedAt - startedAt;\n      const totalMs = finishedAt - job.enqueuedAt;\n\n      this.inFlight--;\n      this.inFlightSessions.delete(job.sessionId);\n      this.hooks.onJobFinish?.({\n        sessionId: job.sessionId,\n        depth: this.depth,\n        inFlight: this.inFlight,\n        waitMs,\n        runMs,\n        totalMs,\n        error,\n      });\n\n      if (this.pending.size > 0) {\n        this.scheduleDrain();\n      } else {\n        this.resolveIdleWaitersIfNeeded();\n      }\n      this.resolveSessionIdleWaitersIfNeeded(job.sessionId);\n    }\n  }\n\n  private resolveIdleWaitersIfNeeded(): void {\n    if (this.depth !== 0 || this.inFlight !== 0) return;\n\n    const waiters = this.idleWaiters.splice(0, this.idleWaiters.length);\n    for (const resolve of waiters) resolve();\n  }\n\n  private resolveSessionIdleWaitersIfNeeded(sessionId: string): void {\n    if (this.pending.has(sessionId) || this.inFlightSessions.has(sessionId))\n      return;\n\n    const waiters = this.sessionIdleWaiters.get(sessionId);\n    if (!waiters || waiters.length === 0) return;\n\n    this.sessionIdleWaiters.delete(sessionId);\n    for (const resolve of waiters) resolve();\n  }\n}\n"],"mappings":"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","names":["sessionId"]}

package/dist/chunk-TPMQ3G6Z.js

@@ -0,0 +1,145 @@
+import {
+  parseIsoTimestamp,
+  validateReplayTurn
+} from "./chunk-2PRQG7PV.js";
+
+// src/replay/runner.ts
+function clampNonNegativeInt(value, defaultValue) {
+  if (!Number.isFinite(value)) return defaultValue;
+  return Math.max(0, Math.floor(value));
+}
+function clampBatchSize(value) {
+  const parsed = clampNonNegativeInt(value, 100);
+  if (parsed < 1) return 1;
+  return Math.min(parsed, 1e3);
+}
+function toWarning(issue) {
+  return {
+    code: issue.code,
+    message: issue.message,
+    index: issue.index
+  };
+}
+function inDateRange(turn, fromTs, toTs) {
+  const turnTs = parseIsoTimestamp(turn.timestamp);
+  if (turnTs === null) return false;
+  if (fromTs !== null && turnTs < fromTs) return false;
+  if (toTs !== null && turnTs > toTs) return false;
+  return true;
+}
+function buildReplayNormalizerRegistry(normalizers) {
+  const registry = {};
+  for (const normalizer of normalizers) {
+    if (!normalizer?.source) {
+      throw new Error("replay normalizer source is required");
+    }
+    if (registry[normalizer.source]) {
+      throw new Error(`duplicate replay normalizer for source '${normalizer.source}'`);
+    }
+    registry[normalizer.source] = normalizer;
+  }
+  return registry;
+}
+async function runReplay(source, input, registry, handlers = {}, options = {}) {
+  const normalizer = registry[source];
+  if (!normalizer) {
+    throw new Error(`missing replay normalizer for source '${source}'`);
+  }
+  return runReplayWithNormalizer(normalizer, input, handlers, options);
+}
+async function runReplayWithNormalizer(normalizer, input, handlers = {}, options = {}) {
+  const parseResult = await normalizer.parse(input, options);
+  if (!parseResult || typeof parseResult !== "object") {
+    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result object`);
+  }
+  if (!Array.isArray(parseResult.turns)) {
+    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result: turns must be an array`);
+  }
+  if (parseResult.warnings != null && !Array.isArray(parseResult.warnings)) {
+    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result: warnings must be an array`);
+  }
+  const warnings = [...parseResult.warnings ?? []];
+  const parsedTurns = parseResult.turns;
+  const validTurns = [];
+  let invalidTurns = 0;
+  for (let i = 0; i < parsedTurns.length; i += 1) {
+    const turn = parsedTurns[i];
+    const issues = validateReplayTurn(turn, i);
+    if (issues.length === 0 && turn.source !== normalizer.source) {
+      issues.push({
+        code: "turn.source.mismatch",
+        message: `Replay turn source '${turn.source}' does not match normalizer source '${normalizer.source}'.`,
+        index: i
+      });
+    }
+    if (issues.length > 0) {
+      invalidTurns += 1;
+      for (const issue of issues) warnings.push(toWarning(issue));
+      continue;
+    }
+    validTurns.push(turn);
+  }
+  const sorted = [...validTurns].sort((a, b) => {
+    const left = parseIsoTimestamp(a.timestamp) ?? 0;
+    const right = parseIsoTimestamp(b.timestamp) ?? 0;
+    return left - right;
+  });
+  const fromTs = options.from ? parseIsoTimestamp(options.from) : null;
+  const toTs = options.to ? parseIsoTimestamp(options.to) : null;
+  if (options.from && fromTs === null) {
+    throw new Error(`invalid replay --from timestamp '${options.from}'`);
+  }
+  if (options.to && toTs === null) {
+    throw new Error(`invalid replay --to timestamp '${options.to}'`);
+  }
+  if (fromTs !== null && toTs !== null && fromTs > toTs) {
+    throw new Error("invalid replay date range: --from is after --to");
+  }
+  const ranged = sorted.filter((turn) => inDateRange(turn, fromTs, toTs));
+  const filteredByDate = sorted.length - ranged.length;
+  const startOffset = clampNonNegativeInt(options.startOffset, 0);
+  const skippedByOffset = Math.min(startOffset, ranged.length);
+  const offsetApplied = ranged.slice(startOffset);
+  const maxTurns = clampNonNegativeInt(options.maxTurns, offsetApplied.length);
+  const selected = offsetApplied.slice(0, maxTurns);
+  const dryRun = options.dryRun === true;
+  const batchSize = clampBatchSize(options.batchSize);
+  let batchCount = 0;
+  if (!dryRun) {
+    for (let i = 0; i < selected.length; i += batchSize) {
+      const batch = selected.slice(i, i + batchSize);
+      batchCount += 1;
+      if (handlers.onBatch) await handlers.onBatch(batch);
+      if (handlers.onTurn) {
+        for (const turn of batch) {
+          await handlers.onTurn(turn);
+        }
+      }
+    }
+  } else if (selected.length > 0) {
+    batchCount = Math.ceil(selected.length / batchSize);
+  }
+  return {
+    source: normalizer.source,
+    parsedTurns: parsedTurns.length,
+    validTurns: sorted.length,
+    invalidTurns,
+    filteredByDate,
+    skippedByOffset,
+    processedTurns: selected.length,
+    batchCount,
+    dryRun,
+    nextOffset: startOffset + selected.length,
+    firstTimestamp: selected[0]?.timestamp,
+    lastTimestamp: selected[selected.length - 1]?.timestamp,
+    warnings
+  };
+}
+
+export {
+  clampBatchSize,
+  buildReplayNormalizerRegistry,
+  runReplay,
+  runReplayWithNormalizer
+};
+//# sourceMappingURL=chunk-TPMQ3G6Z.js.map

package/dist/chunk-TPMQ3G6Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/replay/runner.ts"],"sourcesContent":["import {\n  parseIsoTimestamp,\n  type ReplayNormalizer,\n  type ReplayParseOptions,\n  type ReplaySource,\n  type ReplayTurn,\n  type ReplayWarning,\n  type ReplayValidationIssue,\n  validateReplayTurn,\n} from \"./types.js\";\n\nexport interface ReplayRunOptions extends ReplayParseOptions {\n  dryRun?: boolean;\n  startOffset?: number;\n  maxTurns?: number;\n  batchSize?: number;\n}\n\nexport interface ReplayRunHandlers {\n  onTurn?: (turn: ReplayTurn) => Promise<void> | void;\n  onBatch?: (turns: ReplayTurn[]) => Promise<void> | void;\n}\n\nexport interface ReplayRunSummary {\n  source: ReplaySource;\n  parsedTurns: number;\n  validTurns: number;\n  invalidTurns: number;\n  filteredByDate: number;\n  skippedByOffset: number;\n  processedTurns: number;\n  batchCount: number;\n  dryRun: boolean;\n  nextOffset: number;\n  firstTimestamp?: string;\n  lastTimestamp?: string;\n  warnings: ReplayWarning[];\n}\n\nexport type ReplayNormalizerRegistry = Record<ReplaySource, ReplayNormalizer>;\n\nfunction clampNonNegativeInt(value: number | undefined, defaultValue: number): number {\n  if (!Number.isFinite(value as number)) return defaultValue;\n  return Math.max(0, Math.floor(value as number));\n}\n\nexport function clampBatchSize(value: number | undefined): number {\n  const parsed = clampNonNegativeInt(value, 100);\n  if (parsed < 1) return 1;\n  return Math.min(parsed, 1000);\n}\n\nfunction toWarning(issue: ReplayValidationIssue): ReplayWarning {\n  return {\n    code: issue.code,\n    message: issue.message,\n    index: issue.index,\n  };\n}\n\nfunction inDateRange(turn: ReplayTurn, fromTs: number | null, toTs: number | null): boolean {\n  const turnTs = parseIsoTimestamp(turn.timestamp);\n  if (turnTs === null) return false;\n  if (fromTs !== null && turnTs < fromTs) return false;\n  if (toTs !== null && turnTs > toTs) return false;\n  return true;\n}\n\nexport function buildReplayNormalizerRegistry(normalizers: ReplayNormalizer[]): ReplayNormalizerRegistry {\n  const registry = {} as ReplayNormalizerRegistry;\n  for (const normalizer of normalizers) {\n    if (!normalizer?.source) {\n      throw new Error(\"replay normalizer source is required\");\n    }\n    if (registry[normalizer.source]) {\n      throw new Error(`duplicate replay normalizer for source '${normalizer.source}'`);\n    }\n    registry[normalizer.source] = normalizer;\n  }\n  return registry;\n}\n\nexport async function runReplay(\n  source: ReplaySource,\n  input: unknown,\n  registry: ReplayNormalizerRegistry,\n  handlers: ReplayRunHandlers = {},\n  options: ReplayRunOptions = {},\n): Promise<ReplayRunSummary> {\n  const normalizer = registry[source];\n  if (!normalizer) {\n    throw new Error(`missing replay normalizer for source '${source}'`);\n  }\n  return runReplayWithNormalizer(normalizer, input, handlers, options);\n}\n\nexport async function runReplayWithNormalizer(\n  normalizer: ReplayNormalizer,\n  input: unknown,\n  handlers: ReplayRunHandlers = {},\n  options: ReplayRunOptions = {},\n): Promise<ReplayRunSummary> {\n  const parseResult = await normalizer.parse(input, options);\n  if (!parseResult || typeof parseResult !== \"object\") {\n    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result object`);\n  }\n  if (!Array.isArray(parseResult.turns)) {\n    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result: turns must be an array`);\n  }\n  if (parseResult.warnings != null && !Array.isArray(parseResult.warnings)) {\n    throw new Error(`replay normalizer '${normalizer.source}' returned invalid parse result: warnings must be an array`);\n  }\n  const warnings: ReplayWarning[] = [...(parseResult.warnings ?? [])];\n  const parsedTurns = parseResult.turns;\n\n  const validTurns: ReplayTurn[] = [];\n  let invalidTurns = 0;\n  for (let i = 0; i < parsedTurns.length; i += 1) {\n    const turn = parsedTurns[i];\n    const issues = validateReplayTurn(turn, i);\n    if (issues.length === 0 && turn.source !== normalizer.source) {\n      issues.push({\n        code: \"turn.source.mismatch\",\n        message: `Replay turn source '${turn.source}' does not match normalizer source '${normalizer.source}'.`,\n        index: i,\n      });\n    }\n    if (issues.length > 0) {\n      invalidTurns += 1;\n      for (const issue of issues) warnings.push(toWarning(issue));\n      continue;\n    }\n    validTurns.push(turn);\n  }\n\n  const sorted = [...validTurns].sort((a, b) => {\n    const left = parseIsoTimestamp(a.timestamp) ?? 0;\n    const right = parseIsoTimestamp(b.timestamp) ?? 0;\n    return left - right;\n  });\n\n  const fromTs = options.from ? parseIsoTimestamp(options.from) : null;\n  const toTs = options.to ? parseIsoTimestamp(options.to) : null;\n  if (options.from && fromTs === null) {\n    throw new Error(`invalid replay --from timestamp '${options.from}'`);\n  }\n  if (options.to && toTs === null) {\n    throw new Error(`invalid replay --to timestamp '${options.to}'`);\n  }\n  if (fromTs !== null && toTs !== null && fromTs > toTs) {\n    throw new Error(\"invalid replay date range: --from is after --to\");\n  }\n\n  const ranged = sorted.filter((turn) => inDateRange(turn, fromTs, toTs));\n  const filteredByDate = sorted.length - ranged.length;\n\n  const startOffset = clampNonNegativeInt(options.startOffset, 0);\n  const skippedByOffset = Math.min(startOffset, ranged.length);\n  const offsetApplied = ranged.slice(startOffset);\n\n  const maxTurns = clampNonNegativeInt(options.maxTurns, offsetApplied.length);\n  const selected = offsetApplied.slice(0, maxTurns);\n  const dryRun = options.dryRun === true;\n  const batchSize = clampBatchSize(options.batchSize);\n\n  let batchCount = 0;\n  if (!dryRun) {\n    for (let i = 0; i < selected.length; i += batchSize) {\n      const batch = selected.slice(i, i + batchSize);\n      batchCount += 1;\n      if (handlers.onBatch) await handlers.onBatch(batch);\n      if (handlers.onTurn) {\n        for (const turn of batch) {\n          await handlers.onTurn(turn);\n        }\n      }\n    }\n  } else if (selected.length > 0) {\n    batchCount = Math.ceil(selected.length / batchSize);\n  }\n\n  return {\n    source: normalizer.source,\n    parsedTurns: parsedTurns.length,\n    validTurns: sorted.length,\n    invalidTurns,\n    filteredByDate,\n    skippedByOffset,\n    processedTurns: selected.length,\n    batchCount,\n    dryRun,\n    nextOffset: startOffset + selected.length,\n    firstTimestamp: selected[0]?.timestamp,\n    lastTimestamp: selected[selected.length - 1]?.timestamp,\n    warnings,\n  };\n}\n"],"mappings":"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","names":[]}