@ai-ecoverse/slicc-kernel 1.143.1 → 1.143.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -375,7 +375,7 @@ The module's default export (or its `main` export) is called with a context and
375
375
  - `'change'`: an existing entry's data or metadata changed (a write, `truncate`, `chmod`, `chown`, `utimes`). A write that creates a file gives `'rename'` and then `'change'`, as on Linux.
376
376
  - `filename` is the entry's name relative to the watched directory (`sub/a.txt` when recursive), or the file's basename for a file watch.
377
377
  - **Overflow:** a watch holds 1,000 events between reads. Beyond that, the rest are dropped, and `{ overflow: true }` follows the ones kept.
378
- - **The watched path itself:** when it is removed or renamed away (or an ancestor is), the watch gets one `'rename'` with its own name, then `{ ended: true }`, and ends. `close()` is safe at any time and idempotent, and nothing is delivered after it returns.
378
+ - **The watched path itself:** like inotify, a watch follows the file or directory it was opened on, not its name. When a directory above it is renamed, the watch stays on the moved path with no event, and later events keep the name it was opened with. When the path itself is renamed, the watch gets one `{ type: 'rename', filename, moved: true }` and stays on the new path. Only a removal ends it: `rm` of the path or a directory above it, or a rename of something else over it gives one `'rename'` with its own name, then `{ ended: true }`. Renames are followed as this kernel makes them ([#1356](https://github.com/ai-ecoverse/slicc-kernel/issues/1356)). `close()` is safe at any time and idempotent, and nothing is delivered after it returns.
379
379
  - **Errors at watch time:** a path the program may not read (under `users`) is `EACCES`, and one that doesn't exist is `ENOENT`. Permission is checked first, so a path under a directory the program can't search is `EACCES` whether or not it exists. A process holds at most 8,192 watches; past that, `ENOSPC`.
380
380
  - **Permissions per event:** under `users`, a program only hears about paths it may reach. An event about `P` below the watched directory is delivered only if the program's user can search every directory down to `P`'s parent and read that parent, as Node's recursive watch would need in order to add a watch there. The check runs when the program takes the events, so another user's `0700` directory stays silent until it's opened up. A consequence is that events inside a directory that is gone by the time the program takes them are dropped: after `rm -r sub` the program sees `rename sub` but not `sub/a`. A watcher should rescan on a directory's `rename`, as Node users do anyway.
381
381
  - **Who counts as a writer:** every process in the kernel, the embedder (`kernel.writeFile` and the like) and the mounts that report changes. A `hostfs` change from the host comes as `'change'`, since the host doesn't say which kind it was.
@@ -1292,7 +1292,7 @@ The tools in `tools/cert-review/`:
1292
1292
  - and record, which re-hashes the candidate's artifact against the pack job's sha256.
1293
1293
  - **The verdict** goes into the commit status on the pull request's head and a comment on the pull request. Certified is green. A FAIL is red with the line, and the pull request needs a fix. **INCOMPLETE** (a job that didn't succeed, no verdict, a suite without results) is red with `re-run the failed jobs`, never a silent pass. Main moving on after a review doesn't trigger another one; a push does.
1294
1294
  - **Merge groups only look up.** On `merge_group`, the job lists the group's pull requests (its merge commits) and requires, for each one, a green status on the head being merged, or no behaviour change. Otherwise it's red, naming the pull request. Then it adds the group's downstream verdict. The group's `ci / test` covers the combined tree.
1295
- - **Downstream, once per merge group:** the `merge group pack` job packs the group's tree with `main`'s tools (`x.y.z-group.<run>`), and `downstream bios canary` calls slicc-bios's `canary.yml` at a pinned full sha (`fcaa9a23…`, never a tag) with that tarball, bound by artifact id, digest and sha256, on the `sweep`, `guard-prompt`, `guard-lagging`, `k4-upgrade`, `k4-agent-modes` and `link-serve` shards, each run once, on the runner the `canary runner` job picks: `.github/runner.mjs`'s `decide()` from `main`, as `ci.yml` uses it, gives `vars.CERT_CANARY_RUNNER` only to a merge group whose entries are all same-repo PRs, and `ubuntu-latest` otherwise, without the variable, or if the decider fails (bios honours a runner only for merge groups and pushes to main in ai-ecoverse, so rolling back is unsetting the variable). The verdict line names the shards, or their count past 32 characters (`6 shards`), so a status description (140 characters) keeps the reason. `downstream.mjs` judges its result (`downstreamOf` in `lib.mjs`), and the lookup requires it. The `merge group` job reads that result as `result.json` from the canary's own artifact, downloaded by the call's `artifact-id` with `digest-mismatch: error`, not from the `result` output: that output can be up to 512 KB, and one environment variable holds 128 KB, so passing it that way stopped the step from starting at all (`Argument list too long`, runs 39166647175 and 39168823799). A missing or unreadable artifact leaves no result, so the group is INCOMPLETE:
1295
+ - **Downstream, once per merge group:** the `merge group pack` job packs the group's tree with `main`'s tools (`x.y.z-group.<run>`), and `downstream bios canary` calls slicc-bios's `canary.yml` at a pinned full sha (`42cdf3a8…`, never a tag) with that tarball, bound by artifact id, digest and sha256, on the `sweep`, `guard-prompt`, `guard-lagging`, `k4-upgrade`, `k4-agent-modes` and `link-serve` shards, each run once, on the runner the `canary runner` job picks: `.github/runner.mjs`'s `decide()` from `main`, as `ci.yml` uses it, gives `vars.CERT_CANARY_RUNNER` only to a merge group whose entries are all same-repo PRs, and `ubuntu-latest` otherwise, without the variable, or if the decider fails (bios honours a runner only for merge groups and pushes to main in ai-ecoverse, so rolling back is unsetting the variable). The verdict line names the shards, or their count past 32 characters (`6 shards`), so a status description (140 characters) keeps the reason. `downstream.mjs` judges its result (`downstreamOf` in `lib.mjs`), and the lookup requires it. The `merge group` job reads that result as `result.json` from the canary's own artifact, downloaded by the call's `artifact-id` with `digest-mismatch: error`, not from the `result` output: that output can be up to 512 KB, and one environment variable holds 128 KB, so passing it that way stopped the step from starting at all (`Argument list too long`, runs 39166647175 and 39168823799). A missing or unreadable artifact leaves no result, so the group is INCOMPLETE:
1296
1296
  - **PASS:** the candidate passes, `downstream: PASS bios … N pass`;
1297
1297
  - **FAIL:** a regression, or a failing test (by the counts, even without its rows) is **not certified**, and the group is red;
1298
1298
  - **INCOMPLETE** blocks too: no result, a result from another bios than the pinned one, a missing shard, a shard that exited without a failing test, a refused candidate, 0 tests run, or no test passed;
@@ -7598,7 +7598,7 @@ function satisfies(version, range2) {
7598
7598
  }
7599
7599
 
7600
7600
  // src/version.ts
7601
- var KERNEL_VERSION = true ? "1.143.1" : "0.0.0-dev";
7601
+ var KERNEL_VERSION = true ? "1.143.2" : "0.0.0-dev";
7602
7602
  var OS_RELEASE = "6.0.0-slicc";
7603
7603
  function procVersion() {
7604
7604
  return `Linux version ${OS_RELEASE} (slicc-kernel ${KERNEL_VERSION}) #1 SMP PREEMPT_DYNAMIC
@@ -10509,7 +10509,7 @@ function route(watch, type, path) {
10509
10509
  }
10510
10510
  function routed(watch, root, type, path) {
10511
10511
  if (path === root || type === "rename" && root !== "/" && under3(root, path)) {
10512
- noted(watch, { type, filename: baseOf3(root) });
10512
+ noted(watch, { type, filename: watch.names.get(root) ?? baseOf3(root) });
10513
10513
  if (type === "rename") noted(watch, { ended: true });
10514
10514
  return true;
10515
10515
  }
@@ -10519,6 +10519,11 @@ function routed(watch, root, type, path) {
10519
10519
  } else return false;
10520
10520
  return true;
10521
10521
  }
10522
+ function remapped(root, from, to) {
10523
+ if (root === from) return to;
10524
+ if (from !== "/" && root.startsWith(`${from}/`)) return to + root.slice(from.length);
10525
+ return void 0;
10526
+ }
10522
10527
  var FsWatchers = class {
10523
10528
  watchers = /* @__PURE__ */ new Set();
10524
10529
  typed = /* @__PURE__ */ new Set();
@@ -10553,6 +10558,7 @@ var FsWatchers = class {
10553
10558
  const other = alias === void 0 ? main : normalizePath(alias);
10554
10559
  const watch = {
10555
10560
  roots: other === main ? [main] : [main, other],
10561
+ names: /* @__PURE__ */ new Map(),
10556
10562
  recursive,
10557
10563
  notes: [],
10558
10564
  overflowed: false,
@@ -10602,6 +10608,35 @@ var FsWatchers = class {
10602
10608
  for (const watch of [...this.typed]) route(watch, type, at);
10603
10609
  }
10604
10610
  }
10611
+ moved(from, to) {
10612
+ const source = normalizePath(from);
10613
+ const target = normalizePath(to);
10614
+ const followed2 = /* @__PURE__ */ new Set();
10615
+ for (const watch of this.typed) {
10616
+ const [main] = watch.roots;
10617
+ const roots = watch.roots.map((root) => remapped(root, source, target) ?? root);
10618
+ if (roots.every((root, i) => root === watch.roots[i])) continue;
10619
+ followed2.add(watch);
10620
+ const names2 = /* @__PURE__ */ new Map();
10621
+ watch.roots.forEach((root, i) => {
10622
+ names2.set(roots[i], watch.names.get(root) ?? baseOf3(root));
10623
+ });
10624
+ watch.names = names2;
10625
+ watch.roots = [...new Set(roots)];
10626
+ if (main === source) {
10627
+ noted(watch, { type: "rename", filename: names2.get(target), moved: true });
10628
+ }
10629
+ }
10630
+ return followed2;
10631
+ }
10632
+ renamed(from, to) {
10633
+ const followed2 = this.moved(from, to);
10634
+ if (this.typed.size === 0) return;
10635
+ for (const path of [from, to]) {
10636
+ const at = normalizePath(path);
10637
+ for (const watch of [...this.typed]) if (!followed2.has(watch)) route(watch, "rename", at);
10638
+ }
10639
+ }
10605
10640
  changed(...paths) {
10606
10641
  this.report(paths);
10607
10642
  this.emit("change", paths);
@@ -10705,7 +10740,16 @@ var FsWatchers = class {
10705
10740
  }
10706
10741
  },
10707
10742
  rm: reshaping(after(fs.rm.bind(fs), (path) => [path], "rename")),
10708
- rename: reshaping(after(fs.rename.bind(fs), (from, to) => [from, to], "rename")),
10743
+ rename: reshaping(async (from, to) => {
10744
+ let done5 = false;
10745
+ try {
10746
+ await fs.rename(from, to);
10747
+ done5 = true;
10748
+ } finally {
10749
+ this.report([from, to]);
10750
+ if (done5) this.renamed(from, to);
10751
+ }
10752
+ }),
10709
10753
  link: reshaping(
10710
10754
  after(
10711
10755
  (from, to, follow2) => fs.link(from, to, follow2),