Repository navigation
Commit b58d937
authored
One REPL execution keeps one physical retained stream, and that stream can
now hold more than one entry. Nothing new is written down to say so: the
protocol already marks the boundary, because an entry's root document is
imported under one durable name on one coroutine and that coroutine closes
once. A segment is the range from a root `import_component("__root__")` yield
on `root` to that range's `close:root`, and only the final one may be
unfinished.
`packages/cli/src/repl/entries.ts` owns that grammar and the private view over
it. `partitionEntrySegments()` validates the complete physical prefix before
any part of it is projected, so a file whose boundaries are not boundaries
refuses as one error with no entries beside it — work outside any entry, a
nested or repeated root admission, a close with nothing open, a second
unfinished range. `EntrySegmentStream` is what one execution is handed:
`readAll()` answers with that range alone, so replay cannot correlate a
repeated coroutine id across entries, and `append()` reaches the physical
stream first and is remembered only once that stream has taken it. A settled
or non-final range refuses every append, and no physical position crosses the
boundary.
`ReplModel` now projects an ordered `entries` collection in admission order.
Each entry owns its `entry-N` key, its immutable source, its root scope, its
transcript, its checkpoints, its outcome and the root bindings in effect after
it — the last value each name was durably published under across the entries
before it, with its own publications over the top. A value published before a
failure or an interruption survives; one the failing block never retained
appears nowhere. Prompt-sequence uniqueness is now checked inside the entry
that owns it, because a sequence counts one execution's Prompts and every
entry is its own execution.
Every retained export name is checked against the parser an authored binding is
checked against, while the eval result is read. A name no block could have bound
refuses the projection there, rather than travelling into a later entry's
environment and failing in a generated preamble as a syntax error about a
document that never wrote it.
Boundaries alone are not enough to show any prefix. Every segment in the
complete file is read semantically before a model escapes, whatever a selection
names, so a later entry whose retained payload this version cannot read refuses
the earlier position too. The alternative is a reader standing in history,
shown a catalog that looks whole, and told the file is broken only on returning
to the head.
The first entry keeps every marker spelling it already had, so every location
anybody has written still resolves to the event it named. Later entries
namespace their segment-local markers with their key — `entry-2:yield:root:0`,
`entry-2:close:root` — so a repeated `close:root` cannot resolve as a global
position.
Core gains one trusted-host input, `ExecutionInitialization`, as the third
argument of `executeInstalled()` and exported only from
`@executablemd/core/host`. Its `initialBindings` record is parsed,
name-validated and recursively copied before any installation or document code
runs, and installed as initial bare root bindings. The copy is the whole of the
isolation and nothing is frozen: a durable eval value is ordinary mutable data,
so an entry that inherits a list and appends to it does what any block does to
any binding, while the caller's own graph stays unreachable and unfrozen. Each
name is *defined* rather than assigned, because `values["__proto__"] = …` reaches
`Object.prototype`'s inherited setter and what that does depends on the engine —
a retained record can carry that name, since `JSON.parse` makes it an own
property, and the same bytes would otherwise become a different environment under
Node and Bun than under Deno.
`props` is the one name that does not cross an entry boundary. Each execution's
props namespace is the one its own root validated, so a value published under
that name stays in the scope that published it, is absent from effective
cross-entry bindings, and is refused outright as an initial binding — rather
than projected as passed and then silently dropped by the execution that already
owns its own.
An ordinary export still replaces an initial binding through the rules that
replace any other, and `execute()` is unchanged.
Consumers of the shared model move mechanically to the collection and enable
nothing: submission still refuses a second entry, the route still names the
one entry, and a session refuses a history holding more than one, because
serially running them is the lifecycle work the next slice owns.
Evidence: `repl-entries.test.ts` (ES1 segments, ES2 atomic refusals including a
selection that must not escape an unreadable later entry, EM1 keys and markers,
EP1 projection, inheritance, the reserved `props` namespace and invalid retained
names, BC1 one-entry compatibility) over journals written by really executing
entries through their own views; EB1 in core's binding suite, over the real host
entrypoint with installations that rewrite the caller's record mid-run, with a
cross-entry mutable array, with `props` and unbindable names refused at the
boundary, and with a retained `__proto__` binding that only a Node run can hold
to account.
1 parent 40346d9 commit b58d937
14 files changed
Lines changed: 2097 additions & 174 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
674 | 674 | | |
675 | 675 | | |
676 | 676 | | |
677 | | - | |
| 677 | + | |
678 | 678 | | |
679 | 679 | | |
680 | 680 | | |
| |||
711 | 711 | | |
712 | 712 | | |
713 | 713 | | |
714 | | - | |
| 714 | + | |
715 | 715 | | |
716 | 716 | | |
717 | 717 | | |
| |||
720 | 720 | | |
721 | 721 | | |
722 | 722 | | |
723 | | - | |
| 723 | + | |
724 | 724 | | |
725 | 725 | | |
726 | 726 | | |
727 | 727 | | |
728 | 728 | | |
729 | | - | |
| 729 | + | |
730 | 730 | | |
731 | 731 | | |
732 | 732 | | |
| |||
1305 | 1305 | | |
1306 | 1306 | | |
1307 | 1307 | | |
1308 | | - | |
| 1308 | + | |
1309 | 1309 | | |
1310 | 1310 | | |
1311 | 1311 | | |
| |||
1316 | 1316 | | |
1317 | 1317 | | |
1318 | 1318 | | |
1319 | | - | |
1320 | | - | |
| 1319 | + | |
| 1320 | + | |
1321 | 1321 | | |
1322 | 1322 | | |
1323 | 1323 | | |
| |||
1500 | 1500 | | |
1501 | 1501 | | |
1502 | 1502 | | |
1503 | | - | |
| 1503 | + | |
1504 | 1504 | | |
1505 | 1505 | | |
1506 | 1506 | | |
| |||
1863 | 1863 | | |
1864 | 1864 | | |
1865 | 1865 | | |
1866 | | - | |
| 1866 | + | |
1867 | 1867 | | |
1868 | 1868 | | |
1869 | 1869 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
| 208 | + | |
| 209 | + | |
| 210 | + | |
| 211 | + | |
| 212 | + | |
| 213 | + | |
| 214 | + | |
| 215 | + | |
| 216 | + | |
| 217 | + | |
| 218 | + | |
| 219 | + | |
| 220 | + | |
| 221 | + | |
| 222 | + | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| 228 | + | |
| 229 | + | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
| 241 | + | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | + | |
| 246 | + | |
| 247 | + | |
| 248 | + | |
| 249 | + | |
| 250 | + | |
| 251 | + | |
| 252 | + | |
| 253 | + | |
| 254 | + | |
| 255 | + | |
| 256 | + | |
| 257 | + | |
| 258 | + | |
| 259 | + | |
| 260 | + | |
| 261 | + | |
| 262 | + | |
| 263 | + | |
| 264 | + | |
| 265 | + | |
| 266 | + | |
| 267 | + | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
| 271 | + | |
| 272 | + | |
| 273 | + | |
| 274 | + | |
| 275 | + | |
| 276 | + | |
| 277 | + | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
| 281 | + | |
| 282 | + | |
| 283 | + | |
| 284 | + | |
| 285 | + | |
| 286 | + | |
| 287 | + | |
| 288 | + | |
| 289 | + | |
| 290 | + | |
| 291 | + | |
| 292 | + | |
| 293 | + | |
| 294 | + | |
| 295 | + | |
| 296 | + | |
| 297 | + | |
| 298 | + | |
| 299 | + | |
| 300 | + | |
0 commit comments