docs(code-runtime-python): remove the ack-gate v8 ignore and align the remaining doc drift

The forged-second-boot-ack regression makes the re-entry guard covered, so its
v8 ignore is removed. Doc drift: the python README and run() JSDoc state the
resolve-with-value/resolve-with-error contract without inversion; the README
Known Limitations gains the setsid-escaped-orphan entry (the settlement note
referenced it); the settlement note drops the stale drops/discard phrasing and
the two 256 MiB references; the fd-3 protocol zh note no longer claims the
codec is undelivered; the code-runtime seam README (en + zh) says both
backends ship. Pairings re-recorded.
This commit is contained in:
Chinesezjc
2026-08-31 15:02:38 +08:00
committed by Tianyi Cui
parent 3e0055edaf
commit d98965fbcc
12 changed files with 27 additions and 26 deletions
@@ -874,11 +874,11 @@ export class PythonCodeRuntime extends CodeRuntime {
}
/**
* Execute one program in a fresh Python subprocess. Every program outcome —
* parse failure, thrown exception, invalid completion, output overflow,
* budget expiry, abort, or substrate death — resolves with `result.error` set
* (classified by `CodeRunFailure.kind`); the method rejects only for seam
* misuse.
* Execute one program in a fresh Python subprocess. Success resolves with
* `result.value` (and no `result.error`); failure — parse failure, thrown
* exception, invalid completion, output overflow, budget expiry, abort, or
* substrate death — resolves with `result.error` set (classified by
* `CodeRunFailure.kind`). The method rejects only for seam misuse.
*/
async run(request: CodeRunRequest): Promise<CodeRunResult> {
if (this.disposed) throw new Error('dsh-code-runtime-python: run() after disposal')
@@ -1995,7 +1995,6 @@ export class PythonCodeRuntime extends CodeRuntime {
}
// Register the ack gate with the frame handler before any data arrives.
bootAckGate.run = (): void => {
/* v8 ignore next -- a forged second boot-ack would re-enter; the honest child sends exactly one. */
if (runSent) return
runSent = true
try {