PostToolUse 到反馈的主循环 深度解析

 45function changesFrom(payload, root) {
 46  const input = payload.tool_input || {};
 47  const filePath = input.file_path || input.path || input.notebook_path;
 48  if (!filePath) return [];
 49
 50  if (isManifest(filePath)) {
 51    const change = wholeFile(root, filePath);
 52    return change ? [change] : [];
 53  }
 54
 55  const edits = Array.isArray(input.edits) ? input.edits : [input];
 56  if (edits.some((edit) => typeof edit.old_string === 'string' || typeof edit.new_string === 'string')) {
 57    return edits.map((edit) => ({ path: filePath, before: edit.old_string || '', after: edit.new_string || '' }));
 58  }
 59
 60  const content = typeof input.content === 'string' ? input.content : input.file_text;
 61  if (typeof content !== 'string') return [];
 62  return [{ path: filePath, before: committedContent(root, filePath) || '', after: content }];
 63}
 64
 65function isNewFile(root, filePath, session) {
 66  if (session.newFiles.includes(relativePosix(root, filePath))) return false;
 67  return committedContent(root, filePath) === null;
 68}

 45function changesFrom(payload, root) {
 46  const input = payload.tool_input || {};
 47  const filePath = input.file_path || input.path || input.notebook_path;
 48  if (!filePath) return [];
 49
 50  if (isManifest(filePath)) {
 51    const change = wholeFile(root, filePath);
 52    return change ? [change] : [];
 53  }
 54
 55  const edits = Array.isArray(input.edits) ? input.edits : [input];
 56  if (edits.some((edit) => typeof edit.old_string === 'string' || typeof edit.new_string === 'string')) {
 57    return edits.map((edit) => ({ path: filePath, before: edit.old_string || '', after: edit.new_string || '' }));
 58  }
 59
 60  const content = typeof input.content === 'string' ? input.content : input.file_text;
 61  if (typeof content !== 'string') return [];
 62  return [{ path: filePath, before: committedContent(root, filePath) || '', after: content }];
 63}
 64
 65function isNewFile(root, filePath, session) {
 66  if (session.newFiles.includes(relativePosix(root, filePath))) return false;
 67  return committedContent(root, filePath) === null;
 68}

111  for (const change of changes) {
112    const relative = relativePosix(root, change.path);
113    if (relative.startsWith('..') || isTestPath(relative)) continue;
114    if (isNewFile(root, change.path, session)) session.newFiles.push(relative);
115    if (!session.touchedFiles.includes(relative)) session.touchedFiles.push(relative);
116
117    const result = inspect(change, context);
118    session.addedLines += result.added.length;
119    session.removedLines += result.removed.length;
120
121    const surviving = baseline.filter(result.findings, accepted, () => relative);
122    for (const finding of surviving) {
123      if (finding.dep && !session.deps.includes(finding.dep)) session.deps.push(finding.dep);
124      const key = fingerprint(finding, relative);
125      if (session.reported.includes(key)) continue;
126      session.reported.push(key);
127      finding.path = relative;
128      session.findings.push(finding);
129      fresh.push(finding);
130    }
131  }
132
133  const overruns = budget.enforce === 'silent' ? [] : budgetFindings(session, budget);
134  writeSession(session);
135
136  const shown = [...fresh, ...overruns].slice(0, MAX_REPORTED);
137  if (!shown.length) return;
138
139  const hidden = fresh.length + overruns.length - shown.length;
140  const body =
141    headline(session, budget, mode) +
142    '\n\n' +
143    alignedFindings(shown) +
144    (hidden > 0 ? '\n\n' + hidden + ' more not shown' : '');
145
146  const blocking =
147    budget.enforce === 'block' &&
148    (overruns.length > 0 || fresh.some((finding) => finding.confidence === CERTAIN));
149
150  if (blocking) {
151    block('PostToolUse', body + '\n\nStrict mode. Revert or shrink this change, or ask the user to raise the budget.');
152    return;
153  }
154
155  emit(
156    'PostToolUse',
157    body + '\n\nFix what applies, then continue. Wrong call? say so, or mark the line with: ratchet-ignore: reason'
158  );