docs: REABSORB-WHEN comment on hir_builder_emit_awaited_call_tail_c

SonicField · SonicField · commit 149b7e2d40ca · 2026-04-22T11:04:03.000-07:00
Per pythia python#78 python#2 [chat L1986] orphan-bridge risk + supervisor [chat L1990] authorization (option b) + theologian [chat L1991] volunteer + landing. Adds a 5-line comment block above the bridge function that names the PartialConversion artifact origin + the trigger condition for reabsorbing the bridge into a full emitAnyCall C body. Comment text: PARTIAL CONVERSION ARTIFACT — emitAnyCall await-tail extracted while emitAnyCall opcode-switch + 3 INVOKE_* sub-methods (emitInvokeFunction, emitInvokeNative, emitInvokeMethod) remain C++. REABSORB WHEN: Tier 6 INVOKE_* family fully converts to C; then emitAnyCall fully converts and this bridge can inline back into the full C body. Addresses pythia python#78 python#2 'orphan-bridge if Tier 6 INVOKE_* defers' concern by anchoring the reabsorb-trigger in source (not just chat history), ensuring future readers can locate the architectural decision context without scrollback. Authorship: theologian (volunteered + drafted); generalist (committed per role boundary — theologian = design/advisory, generalist = commits). Authorization chain: - pythia python#78 python#2 surfaced bridge orphan-risk: chat L1986 - supervisor authorized option (b) source-comment: chat L1990 - theologian volunteered + drafted comment: chat L1991, L1995
diff --git a/Python/jit/hir/builder_emit_c.c b/Python/jit/hir/builder_emit_c.c
@@ -3364,6 +3364,11 @@ extern void hir_builder_emit_get_awaitable_c(
 extern void hir_builder_emit_yield_from_method_c(
     PhxTranslationContext *tc, void *out, int code_flags);
 
+/* PARTIAL CONVERSION ARTIFACT — emitAnyCall await-tail extracted while
+ * emitAnyCall opcode-switch + 3 INVOKE_* sub-methods (emitInvokeFunction,
+ * emitInvokeNative, emitInvokeMethod) remain C++. REABSORB WHEN: Tier 6
+ * INVOKE_* family fully converts to C; then emitAnyCall fully converts and
+ * this bridge can inline back into the full C body. */
 void hir_builder_emit_awaited_call_tail_c(
         PhxTranslationContext *tc,
         void *func,
