Function processDocSyncQueue

hooks_src/doc-sync.js:219–253

(projectRoot, options = {})

}

function processDocSyncQueue(projectRoot, options = {}) {
  const queuePath = path.join(projectRoot, '.planning', 'telemetry', 'doc-sync-queue.jsonl');
  const detail = readEntries(queuePath);
  if (!detail.exists) {
    return {
      ok: true,
      queuePath,
      reportPath: null,
      exists: false,
      entries: 0,
      malformed: 0,
      summary: { pending: [], files: [], general: [], deleted: [] },
    };
  }

  const summary = summarizeEntries(projectRoot, detail.entries);
  let reportPath = null;
  if (!options.dryRun && (summary.pending.length > 0 || options.writeEmptyReport)) {
    reportPath = writeReport(projectRoot, summary, options);
  }

  if (!options.dryRun && summary.pending.length > 0) {
    updateQueue(queuePath, detail.entries, summary, options);
  }

  return {
    ok: true,
    queuePath,
    reportPath,
    exists: true,
    entries: detail.entries.length,
    malformed: detail.malformed,
    summary,
  };
}

function renderResult(result) {
  if (!result.exists) return '[doc-sync] No queue file found - nothing to process.\n';