@awebai/oats 0.69.22 → 0.69.24

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.
Files changed (98) hide show
  1. package/bin/oats.mjs +185 -38
  2. package/docs/capabilities.md +365 -7
  3. package/docs/capability-manifest.schema.json +37 -1
  4. package/docs/configuration.md +27 -7
  5. package/docs/container.md +206 -228
  6. package/docs/design/2026-11-19-sandboxes.md +1352 -0
  7. package/docs/design/2026-11-20-provider-home-lifecycle.md +320 -0
  8. package/docs/design/README.md +7 -0
  9. package/docs/desktop-cli-api.md +673 -81
  10. package/docs/desktop.md +241 -65
  11. package/docs/execution-targets.md +186 -3
  12. package/docs/first-team.md +11 -0
  13. package/docs/implementation.md +6 -2
  14. package/docs/integrations.md +3 -3
  15. package/docs/knowledge-capability-authoring.md +10 -7
  16. package/docs/knowledge-reference/acceptance.md +21 -19
  17. package/docs/knowledge-reference/adoption.md +18 -4
  18. package/docs/knowledge-reference/model.md +11 -9
  19. package/docs/knowledge-reference/package-craft.md +2 -2
  20. package/docs/knowledge-reference/proposal.md +127 -0
  21. package/docs/knowledge-reference/provider-mapping.md +10 -10
  22. package/docs/knowledge-reference/reader-capture.md +26 -22
  23. package/docs/knowledge-theory.md +1 -1
  24. package/docs/knowledge.md +25 -16
  25. package/docs/official-catalog.md +4 -4
  26. package/docs/packages.md +13 -13
  27. package/docs/release-notes/v0.69.23.md +231 -0
  28. package/docs/release-notes/v0.69.24.md +264 -0
  29. package/docs/servers.md +10 -6
  30. package/docs/souls-and-instances.md +96 -22
  31. package/docs/tui.md +25 -4
  32. package/docs/upgrading.md +19 -5
  33. package/docs/workspaces.md +14 -6
  34. package/lib/argv.mjs +6 -2
  35. package/lib/capability-contract.mjs +2 -2
  36. package/lib/capability-show.mjs +11 -1
  37. package/lib/command-flags.mjs +40 -3
  38. package/lib/compile-cache.mjs +1 -1
  39. package/lib/core.mjs +1201 -195
  40. package/lib/errors.mjs +4 -1
  41. package/lib/hook-env.mjs +106 -0
  42. package/lib/host-run.mjs +11 -3
  43. package/lib/instance-board.mjs +337 -0
  44. package/lib/instance-events.mjs +48 -10
  45. package/lib/instance-inspect.mjs +44 -0
  46. package/lib/instance-lifecycle.mjs +34 -18
  47. package/lib/instance-listing.mjs +113 -16
  48. package/lib/instance-related-work.mjs +143 -0
  49. package/lib/kernel-features.mjs +13 -1
  50. package/lib/node-version.mjs +9 -0
  51. package/lib/provider-call-child.mjs +60 -0
  52. package/lib/provider-resume.mjs +83 -0
  53. package/lib/provider-test-seams.mjs +20 -0
  54. package/lib/read-call.mjs +2 -0
  55. package/lib/reserved-launch-env.mjs +8 -1
  56. package/lib/retire-admission.mjs +5 -1
  57. package/lib/schedule.mjs +14 -4
  58. package/lib/servers.mjs +151 -17
  59. package/lib/session-inspect.mjs +104 -13
  60. package/lib/session-providers.mjs +528 -0
  61. package/lib/session-resume.mjs +68 -15
  62. package/lib/stable-node.mjs +3 -0
  63. package/lib/triggers.mjs +3 -1
  64. package/package-catalog.json +3 -3
  65. package/package.json +2 -1
  66. package/packages/client/capability-list.mjs +21 -0
  67. package/packages/client/cli-adapter.mjs +19 -4
  68. package/packages/client/cli-locator.mjs +5 -1
  69. package/packages/client/deployment-data.mjs +27 -3
  70. package/packages/client/deployment-panel.mjs +27 -4
  71. package/packages/client/home-board.mjs +33 -19
  72. package/packages/client/inspect-boundary.mjs +18 -8
  73. package/packages/client/instance-acts.mjs +30 -3
  74. package/packages/client/instance-board.mjs +206 -0
  75. package/packages/client/instance-presentation.mjs +55 -0
  76. package/packages/client/instance-tree.mjs +34 -4
  77. package/packages/client/keymap.mjs +5 -0
  78. package/packages/client/liveness.mjs +15 -4
  79. package/packages/client/mail-contract.mjs +130 -0
  80. package/packages/client/own-codes.mjs +5 -1
  81. package/packages/client/panel-views.mjs +7 -7
  82. package/packages/client/related-work.mjs +84 -0
  83. package/packages/client/remote-roster.mjs +9 -3
  84. package/packages/client/session-backends.mjs +31 -0
  85. package/packages/client/session-start.mjs +18 -6
  86. package/packages/client/spawn-apply-cli.mjs +5 -3
  87. package/packages/client/spawn-apply-contract.mjs +25 -2
  88. package/packages/client/spawn-apply.mjs +5 -1
  89. package/packages/client/spawn-messages.mjs +3 -0
  90. package/packages/client/terminal-contract.mjs +4 -0
  91. package/packages/client/waiting-on-you.mjs +12 -2
  92. package/packages/client/workspace-cli.mjs +13 -2
  93. package/packages/tui/lib/model.mjs +14 -3
  94. package/packages/tui/lib/store.mjs +12 -3
  95. package/skills/oats-getting-started/SKILL.md +11 -8
  96. package/docs/knowledge-reference/harvester.md +0 -109
  97. package/lib/instance-same-work.mjs +0 -67
  98. package/packages/client/same-work.mjs +0 -49
package/lib/argv.mjs CHANGED
@@ -4,7 +4,7 @@
4
4
  * Dependency-free. */
5
5
 
6
6
  /** The kernel's switches: a value never rides one (`--yolo=false` must not turn yolo on). */
7
- const KERNEL_SWITCHES = new Set(["allow-child-spawns", "apply", "background", "check", "clear", "composed-skills", "delete-branch", "discard-worktree", "dry-run", "ephemeral", "force", "help", "host", "if-absent", "install-oats", "instructions", "json", "keep-dir", "keep-env", "no-background", "no-child-spawns", "no-default", "no-launch", "no-recursive", "no-yolo", "plan", "policy", "preview", "print", "replace", "run-source", "same-work", "self", "skills", "suggest-name", "verbose", "yes", "yolo"]);
7
+ const KERNEL_SWITCHES = new Set(["allow-child-spawns", "apply", "background", "board", "check", "clear", "composed-skills", "delete-branch", "discard-worktree", "dry-run", "ephemeral", "force", "help", "host", "if-absent", "install-oats", "instructions", "json", "keep-dir", "keep-env", "no-background", "no-child-spawns", "no-default", "no-launch", "no-recursive", "no-yolo", "plan", "policy", "preview", "print", "related-work", "replace", "run-source", "same-work", "self", "skills", "suggest-name", "verbose", "yes", "yolo"]);
8
8
  /** `--flag=value` is `--flag value`: every kernel reader (flag(), valueFlag(), the onboard and
9
9
  * routed-command loops) then applies the spaced form's validation to it. `problem` is an empty
10
10
  * `--flag=`, a switch given a value, or a value that is itself an option (`--model=--yolo`):
@@ -16,8 +16,12 @@ const INLINE_TEXT_FLAGS = new Set(["message"]);
16
16
  /** Free-text flags whose inline value is always kept whole, the empty one included:
17
17
  * `--description=` clears a trigger's or schedule's description. */
18
18
  const INLINE_WHOLE_FLAGS = new Set(["description"]);
19
+ /** A word that is a switch everywhere but one form, where it takes a value: `oats instance board ask
20
+ * --clear <id>` (feature instance-board). There, `--clear=<id>` is `--clear <id>`. */
21
+ const VALUE_IN_FORM = [{ words: ["instance", "board", "ask"], name: "clear" }];
19
22
  export function expandInlineValues(argv) {
20
23
  const out = [];
24
+ const valued = new Set(VALUE_IN_FORM.filter((f) => f.words.every((w, i) => argv[i] === w)).map((f) => f.name));
21
25
  const inline = new Map();
22
26
  let problem;
23
27
  for (const a of argv) {
@@ -25,7 +29,7 @@ export function expandInlineValues(argv) {
25
29
  if (!a.startsWith("--") || eq <= 2) { out.push(a); continue; }
26
30
  const name = a.slice(2, eq), value = a.slice(eq + 1);
27
31
  if (INLINE_WHOLE_FLAGS.has(name) || (INLINE_TEXT_FLAGS.has(name) && value.startsWith("--"))) { inline.set(name, value); out.push(`--${name}`); continue; }
28
- problem ??= KERNEL_SWITCHES.has(name) ? `--${name} takes no value (got ${a})` : value === "" ? `--${name}= needs a value` : value.startsWith("--") ? `--${name}= takes a value, not an option (got ${a})` : undefined;
32
+ problem ??= KERNEL_SWITCHES.has(name) && !valued.has(name) ? `--${name} takes no value (got ${a})` : value === "" ? `--${name}= needs a value` : value.startsWith("--") ? `--${name}= takes a value, not an option (got ${a})` : undefined;
29
33
  out.push(`--${name}`, value);
30
34
  }
31
35
  return { argv: out, problem, inline };
@@ -181,13 +181,13 @@ const DISPOSABLE_HOME_PREFIX_RE = /^\.[A-Za-z0-9_][A-Za-z0-9._-]*-\*$/;
181
181
  * declaration may not cover them: these exact names, and every exact name
182
182
  * starting with one of these prefixes (the events log; the stop, restart and
183
183
  * start receipts and locks; the rollback marker; AGENTS.md backups; the
184
- * attachments directory; the instance colour, `.oats-color.json`; the background record, `.oats-background.json`; the pin, `.oats-pinned.json`; the same-work flag, `.oats-same-work.json`). This is the one list: a new kernel-written top-level
184
+ * attachments directory; the instance colour, `.oats-color.json`; the background record, `.oats-background.json`; the pin, `.oats-pinned.json`; the related-work flag, `.oats-related-work.json`, and `.oats-same-work.json`, the file of the same-work flag it replaced, which the kernel still reads while the new one is absent; the agent's board, `.oats-board.json`, and its lock). This is the one list: a new kernel-written top-level
185
185
  * home entry MUST be added here and to the `not` patterns of
186
186
  * `retirement.disposable.home` in docs/capability-manifest.schema.json. A
187
187
  * prefix declaration can reach none of them except through `.oats-`, which is
188
188
  * refused whole; `.oats-<provider>` as an exact name stays declarable. */
189
189
  const KERNEL_HOME_NAMES = new Set([".oats", ".agents", ".claude"]);
190
- const KERNEL_HOME_NAME_PREFIXES = [".oats-events", ".oats-stop", ".oats-restart", ".oats-rollback", ".oats-agents-md", ".oats-start", ".oats-attachments", ".oats-color", ".oats-background", ".oats-pinned", ".oats-same-work"];
190
+ const KERNEL_HOME_NAME_PREFIXES = [".oats-events", ".oats-stop", ".oats-restart", ".oats-rollback", ".oats-agents-md", ".oats-start", ".oats-attachments", ".oats-color", ".oats-background", ".oats-pinned", ".oats-same-work", ".oats-related-work", ".oats-board"];
191
191
 
192
192
  /** Why `root` is not a declarable home entry: "shape" (not one hidden top-level
193
193
  * name or prefix), "kernel-owned", or undefined when it is sound. */
@@ -32,6 +32,7 @@ import { capabilitySkills, lockedCapability, lockedPackageCapabilities, manifest
32
32
  import { memberRowByKey } from "./workspace.mjs";
33
33
  import { sameRepo } from "./repo-moves.mjs";
34
34
  import { triggerSourcesOf } from "./trigger-sources.mjs";
35
+ import { sessionProvidersOf } from "./session-providers.mjs";
35
36
 
36
37
  export const CAPABILITY_SHOW_API = 1;
37
38
  /** A text is cut to at most this many UTF-8 bytes; binary detection examines this many + 3. */
@@ -194,6 +195,15 @@ function triggerSourceKeys(manifest) {
194
195
  return { triggerSources: manifest.triggerSources, ...(problems.length ? { triggerSourceProblems: problems } : {}) };
195
196
  }
196
197
 
198
+ /** The session providers a manifest declares (lib/session-providers.mjs), as declared, and the problems a
199
+ * `--backend` naming them would get: added keys, each only when there is something to say. A malformed
200
+ * declaration is shown, never refused. */
201
+ function sessionProviderKeys(manifest) {
202
+ if (manifest?.sessionProviders === undefined) return {};
203
+ const { problems } = sessionProvidersOf(manifest);
204
+ return { sessionProviders: manifest.sessionProviders, ...(problems.length ? { sessionProviderProblems: problems } : {}) };
205
+ }
206
+
197
207
  /** The show answer (capabilityShowApi 1): the inject with its text, each skill with its description and files. */
198
208
  export async function capabilityShow(source, { remote, remoteOptions }) {
199
209
  const r = bindRemote(remote, remoteOptions);
@@ -220,7 +230,7 @@ export async function capabilityShow(source, { remote, remoteOptions }) {
220
230
  skills.push({ name: skill.name, path: skill.path, description, files: skill.files, filesTruncated: skill.filesTruncated });
221
231
  }
222
232
  }
223
- return { ...header(source), repoKey: source.repoKey, package: source.package, version: source.version, commit, path: dir, inject, skills, problems, warnings: contractWarnings(source), ...triggerSourceKeys(source.manifest) };
233
+ return { ...header(source), repoKey: source.repoKey, package: source.package, version: source.version, commit, path: dir, inject, skills, problems, warnings: contractWarnings(source), ...triggerSourceKeys(source.manifest), ...sessionProviderKeys(source.manifest) };
224
234
  }
225
235
 
226
236
  /** The `--file` answer: one file the show lists (the inject, or a listed skill file), at the row's commit.
@@ -6,8 +6,28 @@
6
6
  * missing here is not checked. Kernel-private, not exported from `./core`. Dependency-free. */
7
7
 
8
8
  export const RETIRE_DELETE_BRANCH_REFUSED = "oats retire no longer deletes branches: --delete-branch is not accepted. Retire without it; the branch is left in the repository. Inspect it there and delete it with Git if it is no longer wanted.";
9
+ /** The spellings the related-work rename (feature instance-related-work) kept as deprecated aliases
10
+ * (feature instance-same-work, the compatibility layer): `oats spawn … --same-work` is `--related-work`,
11
+ * and `oats instance same-work` is `oats instance related-work`. Each use prints its line on stderr, once,
12
+ * before the command runs or is sent to a --server host (sameWorkDeprecation, the dispatch's), and never
13
+ * in a --json answer. spawnInstance's `sameWork` option is the same alias (lib/core.mjs). */
14
+ export const SAME_WORK_ALIASES = Object.freeze({
15
+ flag: "--same-work is renamed: use --related-work",
16
+ verb: "oats instance same-work is renamed: use oats instance related-work",
17
+ });
18
+
19
+ /** spawnInstance's deprecated option, said as a DeprecationWarning (code OATS_SAME_WORK) by lib/core.mjs. */
20
+ export const SAME_WORK_OPTION_RENAMED = "sameWork is renamed: use relatedWork";
21
+
22
+ /** The deprecation line `argv` (the CLI's argv, after `oats`, as typed) earns by an alias of
23
+ * SAME_WORK_ALIASES, or undefined. */
24
+ export function sameWorkDeprecation(argv) {
25
+ if (argv[0] === "instance" && argv[1] === "same-work") return SAME_WORK_ALIASES.verb;
26
+ if (argv[0] === "spawn" && argv.some((a) => a === "--same-work" || a.startsWith("--same-work="))) return SAME_WORK_ALIASES.flag;
27
+ return undefined;
28
+ }
9
29
  export const RETIRE_USAGE = "usage: oats retire <instance> [--plan] [--plan-revision <rev> --idempotency-key <key>] [--home <path>] [--dir <d>] [--server <id>] [--self] [--discard-worktree] [--keep-dir] [--force] [--json]";
10
- export const SPAWN_USAGE = "usage: oats spawn <agent> [--task <text>|--task-file <f>] [--purpose <slug>|--name <slug>|--suggest-name] [--preview] [--base <ref>] [--model <id>|@native-default] [--allow-child-spawns|--no-child-spawns] [--relation child|sibling|parent|unrelated --relative-to <instance> [--relative-root <agents-root>]] [--parent <instance>] [--same-work] [--repo <r>] [--work worktree|checkout|attached|workspace|directory] [--work-dir <owner-work>] [--harness pi|claude|codex] [--backend tmux] [--yolo|--no-yolo] [--background|--no-background] [--model <m>] [--branch <b>] [--no-launch] [--json]";
30
+ export const SPAWN_USAGE = "usage: oats spawn <agent> [--task <text>|--task-file <f>] [--purpose <slug>|--name <slug>|--suggest-name] [--preview] [--base <ref>] [--model <id>|@native-default] [--allow-child-spawns|--no-child-spawns] [--relation child|sibling|parent|unrelated --relative-to <instance> [--relative-root <agents-root>]] [--parent <instance>] [--related-work|--same-work] [--repo <r>] [--work worktree|checkout|attached|workspace|directory] [--work-dir <owner-work>] [--harness pi|claude|codex] [--backend tmux|<session provider>] [--yolo|--no-yolo] [--background|--no-background] [--model <m>] [--branch <b>] [--no-launch] [--json]";
11
31
  export const SYNC_USAGE = "usage: oats sync [--dir <deployment>] [--plan] [--json]";
12
32
  export const APPROVAL_REMOVED = "package approval was removed; declaring a package in packages: is the trust decision";
13
33
  export const TEAMS_USAGE = "usage: oats teams [--json] | oats teams add <label> --team <id> [--description <d>] [--no-default] | oats teams remove <label> | oats teams default <label> [--if-absent | --expect <label>] [--dir <deployment>] [--json]";
@@ -38,6 +58,16 @@ const waiting = (verb) => ({ command: `instance waiting ${verb}`, operands: [],
38
58
  usage: `usage: oats instance waiting ${verb} --producer <id>${verb === "set" ? " --reason permission|question|attention" : ""} [--message=<text>] [--home <abs>] [--dir <d>] [--json]` });
39
59
  const ATTENTION_USAGE = "usage: oats instance attention [--message=<text>] [--clear] [--json]";
40
60
  const attentionHasNo = (flag) => `oats instance attention has no ${flag}: it records the agent's own claim on the instance it runs in ($OATS_INSTANCE_HOME); ${ATTENTION_USAGE}`;
61
+ /** `oats instance board`'s forms (feature instance-board), each its own usage line; BOARD_USAGE all of them. */
62
+ const BOARD_FORMS = Object.freeze({
63
+ set: "oats instance board set <key> --label <text> --value <text> [--unit <text>] [--link <https-url>] [--json]",
64
+ unset: "oats instance board unset <key> [--json]",
65
+ ask: "oats instance board ask <question> --option <text> --option <text> [--option <text>]… [--id <id>] [--context-file <f>] [--json] | oats instance board ask --clear <id> [--json]",
66
+ });
67
+ export const BOARD_USAGE = `usage: ${Object.values(BOARD_FORMS).join(" | ")}`;
68
+ /** `oats instance board` records on the instance it runs in, as `attention` does: these are refused in its words. */
69
+ const boardRefused = (verb) => Object.freeze(Object.fromEntries(["--home", "--dir", "--server"].map((f) => [f, `oats instance board has no ${f}: it records on the board of the instance it runs in ($OATS_INSTANCE_HOME); usage: ${BOARD_FORMS[verb]}`])));
70
+ const board = (verb, operand, values, required = 1) => ({ command: `instance board ${verb}`, operands: [operand], required, values, switches: ["--json"], refused: boardRefused(verb), usage: `usage: ${BOARD_FORMS[verb]}` });
41
71
  const TRIGGER_RUN_SOURCE = Object.freeze(["--run-source", "--json"]);
42
72
  const SESSION_ADDRESS = Object.freeze(["--home", "--instance", "--server"]);
43
73
  /** Every `oats session` form refuses the captured path's selector in these words (bin's sessionCmd says them
@@ -82,7 +112,7 @@ export const COMMAND_FLAGS = Object.freeze([
82
112
  { command: "spawn", operands: ["soul"],
83
113
  values: ["--agents-root", "--backend", "--base", "--branch", "--dir", "--expect-decision", "--harness", "--herdr-socket", "--idempotency-key", "--instance", "--launch-config", "--max-age", "--model", "--name", "--parent", "--provider", "--purpose", "--relation", "--relative-root", "--relative-to", "--repo", "--runtime", "--server", "--task", "--task-file", "--trigger-event", "--wake-cron", "--wake-every", "--wake-file", "--wake-json", "--wake-message", "--wake-message-file", "--wake-tz", "--work", "--work-dir"],
84
114
  arity: { "--provider": 2 },
85
- switches: ["--allow-child-spawns", "--background", "--json", "--no-background", "--no-child-spawns", "--no-launch", "--no-yolo", "--preview", "--same-work", "--suggest-name", "--yolo"],
115
+ switches: ["--allow-child-spawns", "--background", "--json", "--no-background", "--no-child-spawns", "--no-launch", "--no-yolo", "--preview", "--related-work", "--same-work", "--suggest-name", "--yolo"],
86
116
  // Local souls (local-agents/) are gone with the workspace model: a soul is a member
87
117
  // repository's souls/<name>, so spawn never writes one.
88
118
  refused: { "--instructions-file": SPAWN_REMOVED_SOUL("--instructions-file"), "--def-file": SPAWN_REMOVED_SOUL("--def-file"),
@@ -103,11 +133,18 @@ export const COMMAND_FLAGS = Object.freeze([
103
133
  usage: "usage: oats instance color <instance> (<color> | --clear) [--home <abs>] [--dir <d> | --server <id>] [--json]" },
104
134
  onOff("background"),
105
135
  onOff("pin"),
136
+ onOff("related-work"),
137
+ // The verb's deprecated alias (SAME_WORK_ALIASES): the same arguments.
106
138
  onOff("same-work"),
107
139
  waiting("set"),
108
140
  waiting("clear"),
109
141
  { command: "instance attention", operands: [], values: ["--message"], switches: ["--clear", "--json"],
110
142
  refused: Object.fromEntries(["--home", "--dir", "--producer", "--reason"].map((f) => [f, attentionHasNo(f)])), usage: ATTENTION_USAGE },
143
+ board("set", "key", ["--label", "--value", "--unit", "--link"]),
144
+ board("unset", "key", []),
145
+ // `--clear <id>` takes the id as its value, so the question is optional here; the command refuses a form
146
+ // with neither, or with both.
147
+ board("ask", "question", ["--option", "--id", "--context-file", "--clear"], 0),
111
148
  { command: "instance suggest-name", operands: [], values: ["--soul", "--task", "--task-file", "--harness", "--model", "--launch-config", "--dir"], switches: ["--json"],
112
149
  refused: { "--server": "instance suggest-name takes no --server: it runs this machine's harness, for a spawn that may land on another; the host it lands on makes the name unique (or names an unnamed --suggest-name spawn itself)" },
113
150
  usage: "usage: oats instance suggest-name [--soul <soul>] (--task <t> | --task-file <f>) [--harness claude|pi] [--model <m>] [--launch-config <n>] [--dir <d>] [--json]" },
@@ -121,7 +158,7 @@ export const COMMAND_FLAGS = Object.freeze([
121
158
  refused: { ...NATIVE_RECORD_GONE, "--resume": "--resume exists on session start only: it brings back a session that was lost" },
122
159
  usage: "usage: oats session restart (--home <abs> | --server <id> (--instance <name> | --home <abs>)) [--launch-config <name>|none | --reselect-launch] [--harness pi|claude|codex] [--model <id>] [--yolo|--no-yolo] [--stop-grace <seconds>] [--json]" },
123
160
  { command: "session resume", operands: [], values: ["--deployment"],
124
- refused: { ...NATIVE_RECORD_GONE, "--server": RESUME_LOCAL_ONLY }, switches: ["--plan", "--json"], usage: "usage: oats session resume [--deployment <dir>] [--plan] [--json]" },
161
+ refused: { ...NATIVE_RECORD_GONE, "--server": RESUME_LOCAL_ONLY }, switches: ["--plan", "--without-provider-inspect", "--json"], usage: "usage: oats session resume [--deployment <dir>] [--plan [--without-provider-inspect]] [--json]" },
125
162
  { command: "session input", operands: [], refused: NATIVE_RECORD_GONE, values: ["--home", "--text-file"], switches: ["--json"], usage: "usage: oats session input --home <abs> [--text-file <path>] [--json]" },
126
163
  { command: "session receive", operands: [], refused: NATIVE_RECORD_GONE, values: ["--home", "--name"], switches: ["--json"], usage: "usage: oats session receive --home <abs> --name <file name> [--json]" },
127
164
  { command: "session upload", operands: [], refused: NATIVE_RECORD_GONE, values: ["--file", ...SESSION_ADDRESS], switches: ["--json"],
@@ -1,7 +1,7 @@
1
1
  /** Node's compile cache for the CLI (awebai/oats#1630): V8 keeps the code it compiled for the
2
2
  * kernel's modules, so a command does not recompile them all on every run. Kernel-private, not
3
3
  * exported from `./core` and not a contract: `bin/oats.mjs` calls enableCliCompileCache before it
4
- * imports the kernel (only the dependency-free lib/hot-reads.mjs is parsed before), and in-process
4
+ * imports the kernel (only dependency-free startup helpers are parsed before), and in-process
5
5
  * consumers never call it (they run in their own processes).
6
6
  *
7
7
  * - The cache is `$OATS_HOME_DIR/compile-cache` (`~/.oats/compile-cache`), made 0700 here: Node's