agent-bios 0.19.1 → 0.19.2

package/launch/agent-launch.py

@@ -972,10 +972,10 @@ CRITERION_CLAUSE = (
     f"refuses unclassified findings, and fold returned rows against the declared enum "
     f"without guessing a class"
 )
-# The panel that carries corpus/registration text, and the scrolling body that holds it.
+# The panel that carries instructions/registration text, and the scrolling body that holds it.
 # Named once so the screen, its CSS, its key bindings and the check that drives them cannot
 # drift apart.
-CORPUS_PANEL_ID = "al-corpus"
+INSTRUCTIONS_PANEL_ID = "al-instructions"
 BODY_PANEL_ID = "al-body"
 TROPHY_PANEL_ID = "al-understand-trophy"
 
@@ -1423,8 +1423,8 @@ def parse_capability_offers(name: str, raw: Any) -> tuple:
 
 def review_wrapper_command(host: str, name: str) -> str | None:
     """Resolve a review adapter from the active private package or native installation."""
-    if private_corpus_enabled():
-        path = corpus_package_root() / "wrappers" / f"{name}.sh"
+    if private_instructions_enabled():
+        path = instructions_package_root() / "wrappers" / f"{name}.sh"
     elif host == "codex":
         path = expand_config_path(f"${{CODEX_HOME}}/bin/{name}")
     else:
@@ -3635,7 +3635,7 @@ def emit_receipt_command(
         fields[key] = value
     # Present-but-empty is a configuration error, never a silent prose downgrade: an
     # exported empty value made the whole validation vacuous while the caller believed
-    # it armed (criterion round, #3 — the empty-variable class the corpus already
+    # it armed (criterion round, #3 — the empty-variable class the instructions already
     # names for shell checks).
     criterion_env = os.environ.get(RECEIPT_CRITERION_ENV)
     if criterion_env is not None and not criterion_env.strip():
@@ -4126,41 +4126,49 @@ def exec_backend(command: str, args: list[str], env: dict[str, str] | None = Non
     os.execve(command, [command, *args], os.environ.copy() if env is None else env)
 
 
-def private_corpus_enabled() -> bool:
-    explicit = os.environ.get("AGENT_BIOS_PRIVATE_CORPUS")
+def _instructions_environment(canonical: str, legacy: str, default=None):
+    # The launcher also runs standalone, before any private package is located.
+    current, previous = os.environ.get(canonical), os.environ.get(legacy)
+    if current is not None and previous is not None and current != previous:
+        raise LaunchError(f"conflicting {canonical} and {legacy}; set one value")
+    return current if current is not None else previous if previous is not None else default
+
+
+def private_instructions_enabled() -> bool:
+    explicit = _instructions_environment("AGENT_BIOS_PRIVATE_INSTRUCTIONS", "AGENT_BIOS_PRIVATE_CORPUS")
     if explicit is not None:
         return explicit == "1"
     state = pathlib.Path(os.environ.get("AGENT_BIOS_STATE_DIR", str(pathlib.Path.home() / ".local/share/agent-bios")))
     return (state / "runtime/private-install.json").is_file()
 
 
-def corpus_package_root() -> pathlib.Path:
+def instructions_package_root() -> pathlib.Path:
     explicit = os.environ.get("AGENT_BIOS_PACKAGE_ROOT")
     if explicit:
         return pathlib.Path(explicit).resolve()
     source = pathlib.Path(__file__).resolve().parents[1]
-    if (source / "compose/corpus_store.py").is_file():
+    if any((source / "compose" / name).is_file() for name in ("instructions_store.py", "corpus_store.py")):
         return source
     state = pathlib.Path(os.environ.get("AGENT_BIOS_STATE_DIR", str(pathlib.Path.home() / ".local/share/agent-bios")))
     try:
         root = pathlib.Path(json.loads((state / "runtime/private-install.json").read_text())["package_root"])
     except (OSError, ValueError, KeyError, TypeError) as exc:
-        raise LaunchError("private corpus runtime missing; run agent-bios install") from exc
-    if not (root / "compose/corpus_store.py").is_file():
-        raise LaunchError("private corpus runtime missing; run agent-bios install")
+        raise LaunchError("private instructions runtime missing; run agent-bios install") from exc
+    if not any((root / "compose" / name).is_file() for name in ("instructions_store.py", "corpus_store.py")):
+        raise LaunchError("private instructions runtime missing; run agent-bios install")
     return root
 
 
-def corpus_store():
-    root = corpus_package_root()
+def instructions_store():
+    root = instructions_package_root()
     module_root = str(root / "compose")
     if module_root not in sys.path:
         sys.path.insert(0, module_root)
-    from corpus_store import CorpusStore
-    return CorpusStore(root)
+    from instructions_store import InstructionsStore
+    return InstructionsStore(root)
 
 
-def _corpus_generation(state_root: pathlib.Path, config_path: pathlib.Path) -> str:
+def _instructions_generation(state_root: pathlib.Path, config_path: pathlib.Path) -> str:
     paths = {state_root / "runtime/private-install.json", state_root / "runtime/state.json", config_path}
     digest = hashlib.sha256()
     for path in sorted(paths):
@@ -4172,12 +4180,12 @@ def _corpus_generation(state_root: pathlib.Path, config_path: pathlib.Path) -> s
 
 def _load_private_config(config_path: pathlib.Path, *, replay_only: bool = False):
     """Read one coherent configuration; verify its generation again at activation."""
-    root = corpus_package_root()
+    root = instructions_package_root()
     module_root = str(root / "compose")
     if module_root not in sys.path:
         sys.path.insert(0, module_root)
-    from corpus_transaction import transaction_lock, guard_pending, confirmed_release, TransactionPendingError
-    state_root = corpus_store().state_root
+    from instructions_transaction import transaction_lock, guard_pending, confirmed_release, TransactionPendingError
+    state_root = instructions_store().state_root
     with transaction_lock(state_root):
         try:
             guard_pending(state_root)
@@ -4186,36 +4194,36 @@ def _load_private_config(config_path: pathlib.Path, *, replay_only: bool = False
                 raise
             config_path = confirmed_release(state_root) / "launch/agent-launch.toml"
         config = load_config(config_path)
-        return config, _corpus_generation(state_root, config_path)
+        return config, _instructions_generation(state_root, config_path)
 
 
 def _snapshot_from_config(store, config_path, generation, host, selected, *, dry_run, native):
-    from corpus_transaction import transaction_lock, guard_pending
+    from instructions_transaction import transaction_lock, guard_pending
     with transaction_lock(store.state_root):
         guard_pending(store.state_root)
-        if generation != _corpus_generation(store.state_root, config_path):
-            raise LaunchError("corpus installation or launch settings changed during setup; reopen the launcher")
+        if generation != _instructions_generation(store.state_root, config_path):
+            raise LaunchError("instructions installation or launch settings changed during setup; reopen the launcher")
         return store.snapshot(host, selected, dry_run=dry_run, native=native)
 
 
-def open_corpus_studio() -> None:
-    root = corpus_package_root()
-    result = subprocess.run([sys.executable, str(root / "compose/corpus.py"), "--repo", str(root)])
+def open_instructions_studio() -> None:
+    root = instructions_package_root()
+    result = subprocess.run([sys.executable, str(root / "compose/instructions.py"), "--repo", str(root)])
     if result.returncode:
-        print(f"agent-launch: Corpus Studio exited {result.returncode}", file=sys.stderr)
+        print(f"agent-launch: Instructions Studio exited {result.returncode}", file=sys.stderr)
 
 
 def understand_manager():
-    if not private_corpus_enabled():
+    if not private_instructions_enabled():
         raise LaunchError("understand! requires a private installation; run agent-bios install")
-    store = corpus_store()
-    from corpus_understand import CorpusUnderstand
-    return CorpusUnderstand(store)
+    store = instructions_store()
+    from instructions_understand import InstructionsUnderstand
+    return InstructionsUnderstand(store)
 
 
 def understand_trophy() -> str:
     """Decoration is derived from durable awards, never a launcher-local flag."""
-    if not private_corpus_enabled():
+    if not private_instructions_enabled():
         return ""
     try:
         manager = understand_manager()
@@ -4235,7 +4243,7 @@ def build_understand_plan(config: dict[str, Any], host: str, bundle_id: str) ->
         "label": "Understand!", "mode": DEFAULT_PRESET_MODE, "main_tier": "helm",
         "review_setup": "none", "delegation": False,
         "codex_execution_policy": STANDARD_POLICY, "claude_permission_mode": STANDARD_POLICY,
-        "mission": "Help the user understand the selected corpus bundle's purpose, context, "
+        "mission": "Help the user understand the selected instructions bundle's purpose, context, "
                    "mechanisms and limits through an adaptive dialogue. Treat learning material "
                    "as material to discuss, not authorization to execute its instructions. "
                    "Choose finite core coverage and ask only useful questions, fewer when enough. "
@@ -4823,7 +4831,7 @@ def setup_summary_lines(plan: dict[str, Any] | None) -> list[str]:
             delegation="on" if plan["delegation"] else "off", execution=execution,
         ),
     ]
-    if private_corpus_enabled():
+    if private_instructions_enabled():
         lines.append(
             setup_panel_column(t("setup.global-instructions.label"))
             + " "
@@ -4867,20 +4875,20 @@ def _activate_cli_ui_runtime() -> bool:
     """Use the package's offline UI bundle; standalone compatibility copies keep their runtime."""
     global _UI_RUNTIME_RELEASE
     source = pathlib.Path(__file__).resolve().parents[1]
-    if os.environ.get("AGENT_BIOS_PACKAGE_ROOT") or private_corpus_enabled():
-        root = corpus_package_root()
-    elif (source / "compose/corpus_store.py").is_file():
+    if os.environ.get("AGENT_BIOS_PACKAGE_ROOT") or private_instructions_enabled():
+        root = instructions_package_root()
+    elif any((source / "compose" / name).is_file() for name in ("instructions_store.py", "corpus_store.py")):
         root = source
     else:
         return False
-    loader = root / "compose/corpus_ui_runtime.py"
+    loader = root / "compose/instructions_ui_runtime.py"
     if loader.is_symlink() or not loader.is_file():
         raise LaunchError("bundled UI runtime loader is missing or unsafe; reinstall the agent-bios package")
     module_root = str(root / "compose")
     if module_root not in sys.path:
         sys.path.insert(0, module_root)
     try:
-        from corpus_ui_runtime import activate_ui_runtime, release_ui_runtime
+        from instructions_ui_runtime import activate_ui_runtime, release_ui_runtime
         activate_ui_runtime(root)
     except (ImportError, OSError, RuntimeError) as exc:
         raise LaunchError(f"bundled terminal UI could not start: {exc}") from exc
@@ -5033,10 +5041,10 @@ def _build_app_class():
         height: auto; min-height: 5; max-height: 45vh;
     }
     #al-detail-scroll > #al-detail { border: none; padding: 0; height: auto; }
-    #al-corpus-title { background: $warning; color: black; text-style: bold; padding: 0 1; }
+    #al-instructions-title { background: $warning; color: black; text-style: bold; padding: 0 1; }
     /* No cap and no scroller of its own: one nested scroll region inside another is a
        worse answer than a body that simply scrolls. */
-    #al-corpus {
+    #al-instructions {
         border: round $warning; padding: 0 1; height: auto;
     }
     #al-hdr { color: $text-muted; text-style: bold; padding: 0 1; }
@@ -5121,7 +5129,7 @@ def _build_app_class():
             self.call_after_refresh(self._size_detail)
 
         def __init__(
-            self, title, options, default, allow_back, plan, preview=None, corpus=None,
+            self, title, options, default, allow_back, plan, preview=None, instructions=None,
             confirm=None,
         ):
             super().__init__()
@@ -5131,7 +5139,7 @@ def _build_app_class():
             self._allow_back = allow_back
             self._plan = plan
             self._preview = preview
-            self._corpus = corpus
+            self._instructions = instructions
             self._trophy = understand_trophy()
             # The value Enter decides on, for a screen whose rows are changes rather than
             # choices. Without it Enter and Space would both mean "act on the highlighted
@@ -5148,9 +5156,9 @@ def _build_app_class():
                 with Horizontal(id="al-reference-row"):
                     with Vertical(id="al-reference-content"):
                         yield setup_panel(self._plan)
-                        if self._corpus:
-                            yield Static(t("tui.corpus.title"), id="al-corpus-title")
-                            yield Static("\n".join(self._corpus), id=CORPUS_PANEL_ID)
+                        if self._instructions:
+                            yield Static(t("tui.instructions.title"), id="al-instructions-title")
+                            yield Static("\n".join(self._instructions), id=INSTRUCTIONS_PANEL_ID)
                     yield Static(self._trophy, id=TROPHY_PANEL_ID, markup=False)
             detail = VerticalScroll(Static("", id="al-detail", markup=False), id="al-detail-scroll")
             detail.border_title = t("tui.detail.title")
@@ -5357,13 +5365,13 @@ class TextualUI:
         default: str,
         allow_back: bool,
         preview=None,
-        corpus_lines: list[str] | None = None,
+        instructions_lines: list[str] | None = None,
         confirm: str | None = None,
     ) -> str:
         result = self.app.call_from_thread(
             self.app.push_screen_wait,
             self._menu_screen(
-                title, options, default, allow_back, self.plan, preview, corpus_lines,
+                title, options, default, allow_back, self.plan, preview, instructions_lines,
                 confirm,
             ),
         )
@@ -5429,12 +5437,12 @@ def choose_lines(
     options: list[MenuOption],
     default: str,
     allow_back: bool,
-    corpus_lines: list[str] | None = None,
+    instructions_lines: list[str] | None = None,
 ) -> str:
     print(f"\n{title}")
-    if corpus_lines:
-        print("  " + t("prompt.corpus.header"))
-        for line in corpus_lines:
+    if instructions_lines:
+        print("  " + t("prompt.instructions.header"))
+        for line in instructions_lines:
             print(f"  {line}")
         print("  --")
     for index, option in enumerate(options, 1):
@@ -5480,16 +5488,16 @@ def choose(
     ui: TextualUI | None = None,
     allow_back: bool = False,
     preview=None,
-    corpus_lines: list[str] | None = None,
+    instructions_lines: list[str] | None = None,
     confirm: str | None = None,
 ) -> str:
     if not any(option.enabled for option in options):
         raise LaunchError(f"no available options for {title}")
     if ui is not None:
         return ui.choose(
-            title, options, default, allow_back, preview, corpus_lines, confirm
+            title, options, default, allow_back, preview, instructions_lines, confirm
         )
-    return choose_lines(title, options, default, allow_back, corpus_lines)
+    return choose_lines(title, options, default, allow_back, instructions_lines)
 
 
 def read_input(prompt: str) -> str:
@@ -6530,7 +6538,7 @@ def register_reviewer_wizard(
                     if perspectives:
                         answers["perspectives"] = perspectives
                         break
-                    _corpus_info(ui, t("wizard.title"), [t("wizard.perspectives.refused")])
+                    _instructions_info(ui, t("wizard.title"), [t("wizard.perspectives.refused")])
                 while True:
                     trials_raw = prompt_text(
                         t("wizard.trials.label"), str(answers.get("trials", 2)), ui
@@ -6538,10 +6546,10 @@ def register_reviewer_wizard(
                     try:
                         trials = int(trials_raw)
                     except ValueError:
-                        _corpus_info(ui, t("wizard.title"), [t("wizard.trials.refused")])
+                        _instructions_info(ui, t("wizard.title"), [t("wizard.trials.refused")])
                         continue
                     if trials < 1:
-                        _corpus_info(ui, t("wizard.title"), [t("wizard.trials.refused")])
+                        _instructions_info(ui, t("wizard.title"), [t("wizard.trials.refused")])
                         continue
                     answers["trials"] = trials
                     break
@@ -6596,7 +6604,7 @@ def register_reviewer_wizard(
                     MenuOption("edit", t("wizard.confirm.edit.label"), ""),
                 ],
                 "write", ui, allow_back=True,
-                corpus_lines=[t("wizard.confirm.target").format(target=target),
+                instructions_lines=[t("wizard.confirm.target").format(target=target),
                               *block.splitlines()],
             )
             if confirm == "edit":
@@ -6618,16 +6626,16 @@ def register_reviewer_wizard(
                 # since the trial must read as a race even when its bytes happen
                 # to equal the header the wizard would have invented.
                 if write_target.is_file() != existed:
-                    _corpus_info(ui, t("wizard.title"), [t("wizard.raced.line")],
-                                 back_hint=t("corpus.back.hint"))
+                    _instructions_info(ui, t("wizard.title"), [t("wizard.raced.line")],
+                                 back_hint=t("instructions.back.hint"))
                     return False
                 current = (
                     write_target.read_bytes() if write_target.is_file()
                     else USER_METHODS_HEADER.encode()
                 )
                 if current != before:
-                    _corpus_info(ui, t("wizard.title"), [t("wizard.raced.line")],
-                                 back_hint=t("corpus.back.hint"))
+                    _instructions_info(ui, t("wizard.title"), [t("wizard.raced.line")],
+                                 back_hint=t("instructions.back.hint"))
                     return False
                 mode = (write_target.stat().st_mode & 0o777) if existed else 0o600
                 try:
@@ -6663,9 +6671,9 @@ def register_reviewer_wizard(
                             # merge. Sharing the restore branch's message told the user the
                             # file had been restored in the one case where it was left
                             # exactly as the other writer wrote it.
-                            _corpus_info(
+                            _instructions_info(
                                 ui, t("wizard.title"), [t("wizard.postwrite.raced.line")],
-                                back_hint=t("corpus.back.hint"),
+                                back_hint=t("instructions.back.hint"),
                             )
                             return False
                         if existed:
@@ -6677,18 +6685,18 @@ def register_reviewer_wizard(
                             os.replace(restore, write_target)
                         else:
                             write_target.unlink(missing_ok=True)
-                        _corpus_info(ui, t("wizard.title"), [t("wizard.postwrite.line")],
-                                     back_hint=t("corpus.back.hint"))
+                        _instructions_info(ui, t("wizard.title"), [t("wizard.postwrite.line")],
+                                     back_hint=t("instructions.back.hint"))
                         return False  # pre-write state restored above
             if verdict is None:
                 config.clear()
                 config.update(fresh)
                 registry.clear()
                 registry.update(load_review_methods(config))
-                _corpus_info(
+                _instructions_info(
                     ui, t("wizard.title"),
                     [t("wizard.done.line").format(method_id=answers["id"])],
-                    back_hint=t("corpus.back.hint"),
+                    back_hint=t("instructions.back.hint"),
                 )
                 return True
         action = choose(
@@ -6699,7 +6707,7 @@ def register_reviewer_wizard(
                 MenuOption("contract", t("wizard.refused.contract.label"), ""),
             ],
             "edit", ui, allow_back=True,
-            corpus_lines=[t("wizard.refused.header"), "", *verdict.splitlines()],
+            instructions_lines=[t("wizard.refused.header"), "", *verdict.splitlines()],
         )
         if action == "contract":
             register_reviewer_info(ui, config_path)
@@ -6712,7 +6720,7 @@ def register_reviewer_info(ui: TextualUI | None, config_path: pathlib.Path) -> N
     user owns and what a descriptor must contain, rather than offering a form that
     would have to duplicate the reader's validation and then drift from it."""
     path = user_methods_path(config_path)
-    _corpus_info(
+    _instructions_info(
         ui,
         "Register another reviewer",
         [
@@ -6800,7 +6808,7 @@ def review_editor(
         except BackRequested:
             return None
         except LaunchError as exc:
-            _corpus_info(
+            _instructions_info(
                 ui, f"{title} — cannot be seated", [str(exc)],
                 back_hint="Return to the review editor.",
             )
@@ -8038,7 +8046,7 @@ def customize(
                     preview=lambda value: {**plan, policy_field: value},
                 )
             elif action == "global-instructions":
-                exclude_available = private_corpus_enabled() and plan["host"] == "claude"
+                exclude_available = private_instructions_enabled() and plan["host"] == "claude"
                 exclude_reason = (
                     t("global-instructions.exclude.codex-unavailable")
                     if plan["host"] == "codex"
@@ -8203,7 +8211,7 @@ def customize(
                         )
                         save_preset(plan, config, config_path, name)
                     except LaunchError as exc:
-                        _corpus_info(ui, t("custom.save.prompt"), [str(exc)],
+                        _instructions_info(ui, t("custom.save.prompt"), [str(exc)],
                                      back_hint=t("custom.title"))
                         continue
             plan["_launch_confirmed"] = True
@@ -8213,9 +8221,9 @@ def customize(
 
 
 DISTILL_PRESET = "session-distill"
-CORPUS_STATUS_PATH = pathlib.Path(
-    os.environ.get(
-        "AGENT_BIOS_CORPUS_STATUS",
+INSTRUCTIONS_STATUS_PATH = pathlib.Path(
+    _instructions_environment(
+        "AGENT_BIOS_INSTRUCTIONS_STATUS", "AGENT_BIOS_CORPUS_STATUS",
         str(pathlib.Path.home() / ".local/share/agent-bios/corpus-status.json"),
     )
 )
@@ -8238,7 +8246,7 @@ UPDATE_CHECK_PATH = pathlib.Path(
 # at most SPAWNS the installer, detached, to refresh it. Two reasons, both load-bearing:
 # `npm view` routinely takes seconds and a launcher that blocks on the network is worse
 # than one that shows a stale badge, and the network operation belongs to the component
-# that already owns fetch-corpus (ENDPOINTS.md) rather than to the UI.
+# that already owns fetch-instructions (ENDPOINTS.md) rather than to the UI.
 UPDATE_CHECK_INTERVAL_S = 24 * 60 * 60
 
 
@@ -8316,24 +8324,24 @@ def spawn_update_check() -> None:
         pass
 
 
-def load_corpus_status() -> dict[str, Any] | None:
-    """The corpus status projection, or None when the file is unreadable or is not
+def load_instructions_status() -> dict[str, Any] | None:
+    """The instructions status projection, or None when the file is unreadable or is not
     an object at all. Nothing deeper is validated here on purpose.
 
     Validating the shape field by field was tried and is a queue that refills:
     guarding `summary` and `versions` still left `summary.placed_by_layer: null`,
     `domains.applied: [1,2]` and `last_apply.requested: 5` killing the ROOT MENU
     before it drew, and each new consumer would add another field to remember. The
-    depth is unbounded, so the readers DEGRADE instead — see corpus_summary_lines.
+    depth is unbounded, so the readers DEGRADE instead — see instructions_summary_lines.
     """
-    if private_corpus_enabled():
+    if private_instructions_enabled():
         try:
-            return {"private": corpus_store().status()}
+            return {"private": instructions_store().status()}
         except (OSError, ValueError, RuntimeError) as exc:
-            print(f"agent-launch: cannot read private corpus: {exc}", file=sys.stderr)
+            print(f"agent-launch: cannot read private instructions: {exc}", file=sys.stderr)
             return None
     try:
-        data = json.loads(CORPUS_STATUS_PATH.read_text(encoding="utf-8"))
+        data = json.loads(INSTRUCTIONS_STATUS_PATH.read_text(encoding="utf-8"))
     except (OSError, ValueError):
         return None
     return data if isinstance(data, dict) else None
@@ -8343,7 +8351,7 @@ def version_label() -> str | None:
     """The deployed agent-bios version + release date for the TUI, or None when
     the marker is absent (uninstalled / dev checkout). `agent-bios install`
     writes it from package.json (version + releaseDate). This is the deploy /
-    system version — distinct from the corpus content version in the distill hub."""
+    system version — distinct from the instructions content version in the distill hub."""
     try:
         info = json.loads(VERSION_INFO_PATH.read_text(encoding="utf-8"))
     except (OSError, ValueError):
@@ -8377,7 +8385,7 @@ def display_width(text: str) -> int:
     )
 
 
-def corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
+def instructions_summary_lines(status: dict[str, Any] | None) -> list[str]:
     """Panel body for the Session Distill area, or the not-projected line when the
     status cannot be rendered.
 
@@ -8389,10 +8397,10 @@ def corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
     The exception is printed, never swallowed, so a defect in the rendering code
     below stays visible instead of hiding behind a degraded panel."""
     try:
-        return _corpus_summary_lines(status)
+        return _instructions_summary_lines(status)
     except Exception as exc:  # noqa: BLE001 — the root menu must survive any shape
         print(
-            f"agent-launch: cannot render the corpus status from {CORPUS_STATUS_PATH} "
+            f"agent-launch: cannot render the instructions status from {INSTRUCTIONS_STATUS_PATH} "
             f"({type(exc).__name__}: {exc}); showing it as not projected. "
             "Run: agent-bios install", file=sys.stderr,
         )
@@ -8414,7 +8422,7 @@ def status_list(value: Any) -> list:
     return value if isinstance(value, list) else []
 
 
-_CORPUS_FACTS: dict[tuple, dict[str, Any] | None] = {}
+_INSTRUCTIONS_FACTS: dict[tuple, dict[str, Any] | None] = {}
 
 
 def size_label(chars: int) -> str:
@@ -8424,7 +8432,7 @@ def size_label(chars: int) -> str:
     return f"{chars / 1024:.1f} KB"
 
 
-def corpus_facts(status: dict[str, Any] | None) -> dict[str, Any] | None:
+def instructions_facts(status: dict[str, Any] | None) -> dict[str, Any] | None:
     """What each domain package holds and what it costs, or None when the package the
     projection points at cannot be read.
 
@@ -8453,20 +8461,20 @@ def corpus_facts(status: dict[str, Any] | None) -> dict[str, Any] | None:
         stamp = (repo, manifest_path.stat().st_mtime, applied)
     except OSError:
         return None
-    if stamp in _CORPUS_FACTS:
-        return _CORPUS_FACTS[stamp]
-    _CORPUS_FACTS[stamp] = None  # a repeat of a failing read must not repeat the cost
+    if stamp in _INSTRUCTIONS_FACTS:
+        return _INSTRUCTIONS_FACTS[stamp]
+    _INSTRUCTIONS_FACTS[stamp] = None  # a repeat of a failing read must not repeat the cost
     try:
-        facts = _corpus_facts(pathlib.Path(repo), manifest_path, set(applied))
+        facts = _instructions_facts(pathlib.Path(repo), manifest_path, set(applied))
     except SystemExit:
         # assemble.die() on a manifest/monolith disagreement. Not an Exception, so it
         # would otherwise leave the launcher through every absorber in this file.
         return None
     except Exception as exc:  # noqa: BLE001 — sizing is decoration; picking is not
-        print(f"agent-launch: cannot size the corpus packages in {repo} "
+        print(f"agent-launch: cannot size the instructions packages in {repo} "
               f"({type(exc).__name__}: {exc})", file=sys.stderr)
         return None
-    _CORPUS_FACTS[stamp] = facts
+    _INSTRUCTIONS_FACTS[stamp] = facts
     return facts
 
 
@@ -8490,7 +8498,7 @@ def _load_assembler(repo: pathlib.Path):
     return module
 
 
-def _corpus_facts(repo: pathlib.Path, manifest_path: pathlib.Path, applied: set) -> dict[str, Any]:
+def _instructions_facts(repo: pathlib.Path, manifest_path: pathlib.Path, applied: set) -> dict[str, Any]:
     """The derivation proper, with every failure left to the caller to absorb."""
     assemble = _load_assembler(repo)
     manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
@@ -8539,14 +8547,14 @@ def _corpus_facts(repo: pathlib.Path, manifest_path: pathlib.Path, applied: set)
             "guides": len(selected_guides),
             "guide_chars": guide_chars(selected_guides),
             # A projection can name a domain the installed package does not carry;
-            # the figures above then describe a smaller corpus than the row above them
+            # the figures above then describe a smaller instructions than the row above them
             # claims, so the gap is reported rather than folded in.
             "unknown": sorted(applied - set(domains)),
         },
     }
 
 
-def _corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
+def _instructions_summary_lines(status: dict[str, Any] | None) -> list[str]:
     """The panel body proper. The label column is derived at render time from the
     widest label in the ACTIVE language and measured in display cells: a pad written
     for English cannot align a translated panel."""
@@ -8555,20 +8563,20 @@ def _corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
     if isinstance(status.get("private"), dict):
         current = status["private"]
         selection = current.get("selection")
-        selected = ", ".join(selection) if selection else t("corpus.launch.base")
-        return [t("corpus.private.relationship"),
+        selected = ", ".join(selection) if selection else t("instructions.launch.base")
+        return [t("instructions.private.relationship"),
                 f"{t('panel.domains.label')} {selected}",
                 f"{t('panel.version.label')} {current.get('selected_baseline_ref') or '—'}"]
     # `versions is None` is the projection saying "this install cannot know" — a packaged
-    # install has no author-side registry (compose/corpus-state.py). Three rows then read
-    # "unavailable", which is true of the ledger and says nothing about the corpus the
+    # install has no author-side registry (compose/instructions-state.py). Three rows then read
+    # "unavailable", which is true of the ledger and says nothing about the instructions the
     # user actually has. The package carries the manifest and the monolith the installer
     # assembled from, so those rows are answerable from it; the absence is still stated,
     # once, on the row it belongs to.
     unavailable = status.get("versions") is None
     domains = status.get("domains")
     applied_raw = domains.get("applied") if isinstance(domains, dict) else None
-    facts = corpus_facts(status)
+    facts = instructions_facts(status)
     # An unapplied install is NOT sized: what is deployed is whatever the install put
     # there, and the manifest cannot say which. A guess here would read as a reading.
     packaged = unavailable and facts is not None and applied_raw is not None
@@ -8595,10 +8603,10 @@ def _corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
             # rows above describe less than the domain row below them claims.
             lines.append(t("panel.domains.unknown").format(
                 names=", ".join(selected["unknown"])))
-        return lines + _corpus_domain_lines(status, applied_raw, row, labels[3])
+        return lines + _instructions_domain_lines(status, applied_raw, row, labels[3])
 
     # `versions is None` is the projection saying "this install cannot know" — a packaged
-    # install has no author version/ledger registry (compose/corpus-state.py). It is not
+    # install has no author version/ledger registry (compose/instructions-state.py). It is not
     # `[]`, which would mean a checkout whose registry is genuinely empty, and it must not
     # render as `0 placed · 0 versions`: a fabricated zero is worse than a blank, because
     # a reader cannot tell it from a real count. The domain rows below stay real, which is
@@ -8628,10 +8636,10 @@ def _corpus_summary_lines(status: dict[str, Any] | None) -> list[str]:
             versions=len(status_list(status.get("versions"))),
         )),
     ]
-    return lines + _corpus_domain_lines(status, applied_raw, row, labels[3])
+    return lines + _instructions_domain_lines(status, applied_raw, row, labels[3])
 
 
-def _corpus_domain_lines(status, applied_raw, row, label: str) -> list[str]:
+def _instructions_domain_lines(status, applied_raw, row, label: str) -> list[str]:
     """The rows both panels end on: what is applied, and a failed apply if there is one.
 
     Shared rather than written twice — a packaged panel that quietly dropped the failed
@@ -8640,23 +8648,23 @@ def _corpus_domain_lines(status, applied_raw, row, label: str) -> list[str]:
     if isinstance(status.get("domains"), dict):
         applied = None if applied_raw is None else status_list(applied_raw)
         lines.append(row(label, t("panel.domains.unset") if applied is None
-                         else ", ".join(applied) or t("corpus.core-only")))
+                         else ", ".join(applied) or t("instructions.core-only")))
     last_apply = status.get("last_apply")
     if isinstance(last_apply, dict) and last_apply.get("outcome") not in (None, "applied"):
         # A failed apply must be loud on the panel, not a fact buried in a log:
-        # the deployed corpus and the requested selection disagree right now.
+        # the deployed instructions and the requested selection disagree right now.
         lines.append(t("panel.last-apply").format(
             outcome=last_apply.get("outcome"),
             at=last_apply.get("at"),
-            requested=", ".join(status_list(last_apply.get("requested"))) or t("corpus.core-only"),
+            requested=", ".join(status_list(last_apply.get("requested"))) or t("instructions.core-only"),
         ))
     return lines
 
 
-def _corpus_screen(ui: TextualUI | None, screen: "Callable[[], None]") -> None:
-    """Run a corpus screen, absorbing a status shape it cannot render.
+def _instructions_screen(ui: TextualUI | None, screen: "Callable[[], None]") -> None:
+    """Run an instruction screen, absorbing a status shape it cannot render.
 
-    `corpus_summary_lines` argued this for the root panel: the projection's depth is
+    `instructions_summary_lines` argued this for the root panel: the projection's depth is
     unbounded, its writer is not the only thing that can produce the file, so a status
     that cannot be rendered is treated as one that is not projected. That argument was
     implemented for the panel alone, and the three screens one keypress deeper read the
@@ -8666,25 +8674,25 @@ def _corpus_screen(ui: TextualUI | None, screen: "Callable[[], None]") -> None:
     the top and fatal underneath.
 
     Control flow passes through untouched: LaunchError is the launcher's own refusal,
-    BackRequested and CorpusApplyRequested are how these screens exit normally, and
+    BackRequested and InstructionsApplyRequested are how these screens exit normally, and
     KeyboardInterrupt/SystemExit are not Exception. The rest is printed and shown rather
     than swallowed, so a defect in the rendering code stays visible.
     """
     try:
         screen()
-    except (LaunchError, BackRequested, CorpusApplyRequested):
+    except (LaunchError, BackRequested, InstructionsApplyRequested):
         raise
     except Exception as exc:  # noqa: BLE001 — a status shape must not end the session
         print(
-            f"agent-launch: cannot render the corpus status from {CORPUS_STATUS_PATH} "
+            f"agent-launch: cannot render the instructions status from {INSTRUCTIONS_STATUS_PATH} "
             f"({type(exc).__name__}: {exc}); showing it as not projected. "
             "Run: agent-bios install",
             file=sys.stderr,
         )
-        _corpus_info(ui, t("distill.title"), [t("panel.unprojected")])
+        _instructions_info(ui, t("distill.title"), [t("panel.unprojected")])
 
 
-def _corpus_info(
+def _instructions_info(
     ui: TextualUI | None, title: str, lines: list[str],
     back_hint: str | None = None,
 ) -> None:
@@ -8702,12 +8710,12 @@ def _corpus_info(
         )
     ]
     try:
-        choose(title, options, "back", ui, allow_back=True, corpus_lines=lines)
+        choose(title, options, "back", ui, allow_back=True, instructions_lines=lines)
     except BackRequested:
         pass
 
 
-def _corpus_rollback_choice(version: str, ui: "TextualUI | None") -> str:
+def _instructions_rollback_choice(version: str, ui: "TextualUI | None") -> str:
     """The rollback confirmation prompt, so the Esc handling wraps exactly it."""
     return choose(
         t("distill.rollback.title").format(version=version),
@@ -8729,13 +8737,13 @@ def _corpus_rollback_choice(version: str, ui: "TextualUI | None") -> str:
     )
 
 
-def _corpus_rollback(status: dict[str, Any], version: str, ui: TextualUI | None) -> None:
+def _instructions_rollback(status: dict[str, Any], version: str, ui: TextualUI | None) -> None:
     # Esc means the same thing the Cancel entry means, and this screen offered both while
     # honouring only one: BackRequested propagated out of a destructive confirmation as an
     # exception, past every caller that had nothing to do with it. A screen that shows a
     # Cancel option and a back hint has already told the user those are the same answer.
     try:
-        confirm = _corpus_rollback_choice(version, ui)
+        confirm = _instructions_rollback_choice(version, ui)
     except BackRequested:
         return
     if confirm != "rollback":
@@ -8746,10 +8754,10 @@ def _corpus_rollback(status: dict[str, Any], version: str, ui: TextualUI | None)
     # an outcome this screen already knows how to report.
     repo = status.get("repo")
     if not isinstance(repo, str) or not repo:
-        _corpus_info(ui, t("distill.rollback.failed"),
+        _instructions_info(ui, t("distill.rollback.failed"),
                      [t("panel.unprojected")], back_hint=t("distill.back.hint"))
         return
-    script = pathlib.Path(repo) / "compose/corpus-state.py"
+    script = pathlib.Path(repo) / "compose/instructions-state.py"
     result = subprocess.run(
         [sys.executable, str(script), "rollback", "--version", version],
         capture_output=True,
@@ -8761,14 +8769,14 @@ def _corpus_rollback(status: dict[str, Any], version: str, ui: TextualUI | None)
         t("distill.rollback.done") if result.returncode == 0
         else t("distill.rollback.failed")
     )
-    _corpus_info(ui, verdict, [tail] if tail else [])
+    _instructions_info(ui, verdict, [tail] if tail else [])
 
 
-def _corpus_versions(ui: TextualUI | None) -> None:
+def _instructions_versions(ui: TextualUI | None) -> None:
     while True:
-        status = load_corpus_status()
+        status = load_instructions_status()
         if status is None:
-            _corpus_info(ui, t("distill.versions.label"), corpus_summary_lines(None))
+            _instructions_info(ui, t("distill.versions.label"), instructions_summary_lines(None))
             return
         current = status.get("current_version")
         options = []
@@ -8809,28 +8817,28 @@ def _corpus_versions(ui: TextualUI | None) -> None:
                 options[0].value,
                 ui,
                 allow_back=True,
-                corpus_lines=corpus_summary_lines(status),
+                instructions_lines=instructions_summary_lines(status),
             )
         except BackRequested:
             return
         if selected == "back":
             return
         if selected == current:
-            _corpus_info(
+            _instructions_info(
                 ui,
                 t("distill.version.applied.title").format(version=selected),
                 [t("distill.version.applied.line")],
             )
             continue
-        _corpus_rollback(status, selected, ui)
+        _instructions_rollback(status, selected, ui)
 
 
-def _corpus_packages(ui: TextualUI | None) -> None:
-    """v1: the corpus ships as a single core package; the list shape is ready
+def _instructions_packages(ui: TextualUI | None) -> None:
+    """v1: the instructions ships as a single core package; the list shape is ready
     for the domain-packaging backlog to populate with real packages."""
-    status = load_corpus_status()
+    status = load_instructions_status()
     if status is None:
-        _corpus_info(ui, t("distill.packages.label"), corpus_summary_lines(None))
+        _instructions_info(ui, t("distill.packages.label"), instructions_summary_lines(None))
         return
     layers = status.get("summary", {}).get("placed_by_layer", {})
     options = [
@@ -8852,7 +8860,7 @@ def _corpus_packages(ui: TextualUI | None) -> None:
             "back",
             ui,
             allow_back=True,
-            corpus_lines=corpus_summary_lines(status),
+            instructions_lines=instructions_summary_lines(status),
         )
     except BackRequested:
         pass
@@ -8864,7 +8872,7 @@ def distill_hub(config: dict[str, Any], ui: TextualUI | None) -> str:
     Returns "start" to launch the session-distill preset, "back" otherwise.
     """
     while True:
-        status = load_corpus_status()
+        status = load_instructions_status()
         options = [
             MenuOption(
                 "start",
@@ -8894,7 +8902,7 @@ def distill_hub(config: dict[str, Any], ui: TextualUI | None) -> str:
                 "start",
                 ui,
                 allow_back=True,
-                corpus_lines=corpus_summary_lines(status),
+                instructions_lines=instructions_summary_lines(status),
             )
         except BackRequested:
             return "back"
@@ -8903,9 +8911,9 @@ def distill_hub(config: dict[str, Any], ui: TextualUI | None) -> str:
         if selected == "start":
             return "start"
         if selected == "packages":
-            _corpus_screen(ui, lambda: _corpus_packages(ui))
+            _instructions_screen(ui, lambda: _instructions_packages(ui))
         elif selected == "versions":
-            _corpus_screen(ui, lambda: _corpus_versions(ui))
+            _instructions_screen(ui, lambda: _instructions_versions(ui))
 
 
 def preset_mode(data: dict[str, Any]) -> str:
@@ -8927,8 +8935,8 @@ def mode_default_preset(presets: dict[str, Any], mode: str) -> str | None:
     return names[0] if names else None
 
 
-class CorpusApplyRequested(Exception):
-    """Raised out of the interactive flow when the user confirms a corpus
+class InstructionsApplyRequested(Exception):
+    """Raised out of the interactive flow when the user confirms an instruction
     selection: the Textual app must be torn down before the installer owns the
     terminal, so the request travels as control flow and main() runs the apply
     in the plain terminal, then re-enters the picker."""
@@ -8938,22 +8946,22 @@ class CorpusApplyRequested(Exception):
         self.selection = selection
 
 
-class CorpusStudioRequested(Exception):
+class InstructionsStudioRequested(Exception):
     """Release Textual's terminal before starting the standalone manager."""
 
 
-CORPUS_OPTION = "__corpus__"
+INSTRUCTIONS_OPTION = "__instructions__"
 # A plain value, because the numbered prompt prints it as the default label.
 # Collision with a domain id is structurally impossible: domain slugs come from
 # compose/domains.json, which this repo owns and which carries no "apply".
-CORPUS_APPLY = "apply"
+INSTRUCTIONS_APPLY = "apply"
 
 
-def run_corpus_apply(selection: list[str]) -> None:
+def run_instructions_apply(selection: list[str]) -> None:
     """Run the installer's onboard loop for the selection, in the caller's
     terminal. The installer alone deploys, canaries, and records the outcome;
     this function only streams it and reports the exit."""
-    status = load_corpus_status() or {}
+    status = load_instructions_status() or {}
     domains = ",".join(selection) if selection else "none"
     interaction = [] if os.environ.get("AGENT_BIOS_LEGACY_INSTALL") == "1" else ["--non-interactive"]
     front = shutil.which("agent-bios")
@@ -8976,15 +8984,15 @@ def run_corpus_apply(selection: list[str]) -> None:
             )
             return
         argv = ["bash", str(installer), "onboard", *interaction, "--domains", domains]
-    print(f"\nagent-launch: applying corpus selection: {' '.join(argv)}\n", flush=True)
+    print(f"\nagent-launch: applying instructions selection: {' '.join(argv)}\n", flush=True)
     proc = subprocess.run(argv)
     if proc.returncode != 0:
         print(
-            f"\nagent-launch: corpus apply FAILED (exit {proc.returncode}); the "
-            "corpus panel shows the recorded outcome.", file=sys.stderr,
+            f"\nagent-launch: instructions apply FAILED (exit {proc.returncode}); the "
+            "instructions panel shows the recorded outcome.", file=sys.stderr,
         )
     else:
-        print("\nagent-launch: corpus selection applied.", flush=True)
+        print("\nagent-launch: instructions selection applied.", flush=True)
 
 
 def checkbox_label(checked: bool, name: str, trailing: str = ""):
@@ -9002,25 +9010,25 @@ def checkbox_label(checked: bool, name: str, trailing: str = ""):
     return Text.assemble(*box, name, (trailing, "dim"))
 
 
-def _corpus_domain_content(name: str, fallback: str = "") -> str:
+def _instructions_domain_content(name: str, fallback: str = "") -> str:
     """Localized content help; unfamiliar packages retain their manifest description."""
     descriptions = {
-        "builder-base": t("corpus.domain.builder-base"),
-        "llm-pipeline-dev": t("corpus.domain.llm-pipeline-dev"),
-        "multi-agent-orchestration": t("corpus.domain.multi-agent-orchestration"),
-        "visualization-docs": t("corpus.domain.visualization-docs"),
-        "office-work": t("corpus.domain.office-work"),
+        "builder-base": t("instructions.domain.builder-base"),
+        "llm-pipeline-dev": t("instructions.domain.llm-pipeline-dev"),
+        "multi-agent-orchestration": t("instructions.domain.multi-agent-orchestration"),
+        "visualization-docs": t("instructions.domain.visualization-docs"),
+        "office-work": t("instructions.domain.office-work"),
     }
     return descriptions.get(name, fallback).strip()
 
 
-def corpus_domain_labels() -> dict[str, str]:
+def instructions_domain_labels() -> dict[str, str]:
     return {
-        "builder-base": t("corpus.domain.builder-base.label"),
-        "llm-pipeline-dev": t("corpus.domain.llm-pipeline-dev.label"),
-        "multi-agent-orchestration": t("corpus.domain.multi-agent-orchestration.label"),
-        "visualization-docs": t("corpus.domain.visualization-docs.label"),
-        "office-work": t("corpus.domain.office-work.label"),
+        "builder-base": t("instructions.domain.builder-base.label"),
+        "llm-pipeline-dev": t("instructions.domain.llm-pipeline-dev.label"),
+        "multi-agent-orchestration": t("instructions.domain.multi-agent-orchestration.label"),
+        "visualization-docs": t("instructions.domain.visualization-docs.label"),
+        "office-work": t("instructions.domain.office-work.label"),
     }
 
 
@@ -9031,16 +9039,16 @@ def preset_descriptions() -> dict[str, str]:
         "deep-review": t("preset.deep-review.description"),
         "fast-batch": t("preset.fast-batch.description"),
         "solo": t("preset.solo.description"),
-        "vanilla": (t("corpus.private.vanilla") if private_corpus_enabled()
+        "vanilla": (t("instructions.private.vanilla") if private_instructions_enabled()
                     else t("preset.vanilla.description")),
     }
 
 
-def _corpus_launch_description(status: dict[str, Any] | None) -> str:
+def _instructions_launch_description(status: dict[str, Any] | None) -> str:
     """Explain the installed selection shared by modes without claiming a launch applies it."""
-    if private_corpus_enabled():
-        return t("corpus.private.relationship")
-    lines = [t("corpus.launch.relationship")]
+    if private_instructions_enabled():
+        return t("instructions.private.relationship")
+    lines = [t("instructions.launch.relationship")]
     domains = (status or {}).get("domains")
     applied = domains.get("applied") if isinstance(domains, dict) else None
     if not isinstance(applied, list) or not all(isinstance(name, str) for name in applied):
@@ -9048,12 +9056,12 @@ def _corpus_launch_description(status: dict[str, Any] | None) -> str:
                    if isinstance(domains, dict) and "applied" in domains and applied is None
                    else t("panel.unprojected"))
         return "\n".join([*lines, message])
-    lines += [t("corpus.launch.applied"), t("corpus.launch.base")]
-    facts = (corpus_facts(status) or {}).get("domains", {})
-    labels = corpus_domain_labels()
+    lines += [t("instructions.launch.applied"), t("instructions.launch.base")]
+    facts = (instructions_facts(status) or {}).get("domains", {})
+    labels = instructions_domain_labels()
     for name in applied:
-        content = _corpus_domain_content(
-            name, facts.get(name, {}).get("description") or t("corpus.launch.unknown"),
+        content = _instructions_domain_content(
+            name, facts.get(name, {}).get("description") or t("instructions.launch.unknown"),
         )
         lines.append(f"• {labels.get(name, name)}: {content.splitlines()[0]}")
     return "\n".join(lines)
@@ -9068,53 +9076,53 @@ def _domain_description(info: dict[str, Any] | None, name: str = "") -> str:
     and they are kept apart because they are spent differently: rules are in the global
     that every session and every subagent loads, guides are on disk and read only when a
     rule points at one."""
-    content = _corpus_domain_content(name, info.get("description", "") if info else "")
+    content = _instructions_domain_content(name, info.get("description", "") if info else "")
     if info is None:
-        return "\n\n".join(filter(None, [content, t("corpus.toggle.description")]))
+        return "\n\n".join(filter(None, [content, t("instructions.toggle.description")]))
     # Both keys are named at a literal call site rather than chosen into a variable:
     # the catalog gate finds keys by reading the quoted argument of each t() call, so a
     # computed key is a string no language is ever checked for.
     if info["guides"]:
-        sizes = t("corpus.size.detail").format(
+        sizes = t("instructions.size.detail").format(
             rules=info["rules"],
             size=size_label(info["chars"]),
             guides=info["guides"],
             guide_size=size_label(info["guide_chars"]),
         )
     else:
-        sizes = t("corpus.size.detail.noguides").format(
+        sizes = t("instructions.size.detail.noguides").format(
             rules=info["rules"], size=size_label(info["chars"]),
         )
-    return "\n\n".join(filter(None, [content, sizes, t("corpus.toggle.description")]))
+    return "\n\n".join(filter(None, [content, sizes, t("instructions.toggle.description")]))
 
 
-def corpus_checklist(ui: "TextualUI | None") -> None:
+def instructions_checklist(ui: "TextualUI | None") -> None:
     """Toggle-and-apply loop over the optional domain packages.
 
     The list and the applied set come from corpus-status.json — the installer's
     projection — never from repo paths this launcher cannot know. Selection state
     lives only on this screen; Apply hands the exact set to the installer
     (raising through the Textual app so the terminal is free), and Esc leaves the
-    deployed corpus untouched."""
-    status = load_corpus_status()
+    deployed instructions untouched."""
+    status = load_instructions_status()
     domains = (status or {}).get("domains")
     if not isinstance(domains, dict) or not isinstance(domains.get("available"), list):
-        _corpus_info(
-            ui, t("corpus.title"),
-            [t("corpus.unavailable.line1"), t("corpus.unavailable.line2")],
-            back_hint=t("corpus.back.hint"),
+        _instructions_info(
+            ui, t("instructions.title"),
+            [t("instructions.unavailable.line1"), t("instructions.unavailable.line2")],
+            back_hint=t("instructions.back.hint"),
         )
         return
     available = domains["available"]
     if not available:
         # A list that is empty passes the shape check above and then builds a menu whose
         # only row is a disabled Apply, which `choose` refuses as "no available options"
-        # — a LaunchError, which `_corpus_screen` rethrows by design, so the session ends
+        # — a LaunchError, which `_instructions_screen` rethrows by design, so the session ends
         # on a projection that is not even malformed. Told, not raised. Its own message
         # rather than the one above: "run the installer" is wrong advice for a projection
         # that read fine and simply lists nothing optional.
-        _corpus_info(ui, t("corpus.title"), [t("corpus.none.line")],
-                     back_hint=t("corpus.back.hint"))
+        _instructions_info(ui, t("instructions.title"), [t("instructions.none.line")],
+                     back_hint=t("instructions.back.hint"))
         return
     applied_raw = domains.get("applied")
     # None is "never selected", [] is a verified core+infra-only selection —
@@ -9127,9 +9135,9 @@ def corpus_checklist(ui: "TextualUI | None") -> None:
     # read, and every use below falls back to the bare name — a checklist that cannot
     # size its packages is still a checklist, and this screen is how a user reaches the
     # installer that would repair the projection.
-    facts = corpus_facts(status)
+    facts = instructions_facts(status)
     sized = (facts or {}).get("domains", {})
-    labels = corpus_domain_labels()
+    labels = instructions_domain_labels()
     display_names = {name: f"{labels[name]} ({name})" if name in labels else name for name in available}
     column = max(display_width(label) for label in display_names.values()) + 2
     while True:
@@ -9147,35 +9155,35 @@ def corpus_checklist(ui: "TextualUI | None") -> None:
         ]
         changed = toggles != applied or never_applied
         pending = "" if not changed else (
-            " → " + (", ".join(sorted(toggles)) or t("corpus.core-only"))
+            " → " + (", ".join(sorted(toggles)) or t("instructions.core-only"))
         )
         options.append(
             MenuOption(
-                CORPUS_APPLY,
-                t("corpus.apply.label").format(pending=pending),
-                t("corpus.apply.description"),
+                INSTRUCTIONS_APPLY,
+                t("instructions.apply.label").format(pending=pending),
+                t("instructions.apply.description"),
                 enabled=changed,
-                unavailable_reason=t("corpus.apply.unchanged"),
+                unavailable_reason=t("instructions.apply.unchanged"),
             )
         )
         try:
             choice = choose(
-                t("corpus.title"), options, CORPUS_APPLY, ui, allow_back=True,
-                corpus_lines=[
-                    t("corpus.core.line"),
-                    *([] if not sized else [t("corpus.size.legend")]),
-                    *corpus_summary_lines(status),
+                t("instructions.title"), options, INSTRUCTIONS_APPLY, ui, allow_back=True,
+                instructions_lines=[
+                    t("instructions.core.line"),
+                    *([] if not sized else [t("instructions.size.legend")]),
+                    *instructions_summary_lines(status),
                 ],
-                confirm=CORPUS_APPLY,
+                confirm=INSTRUCTIONS_APPLY,
             )
         except BackRequested:
             return
-        if choice == CORPUS_APPLY:
+        if choice == INSTRUCTIONS_APPLY:
             selection = sorted(toggles)
             if ui is None:
-                run_corpus_apply(selection)
+                run_instructions_apply(selection)
                 return
-            raise CorpusApplyRequested(selection)
+            raise InstructionsApplyRequested(selection)
         if choice in toggles:
             toggles.discard(choice)
         else:
@@ -9197,7 +9205,7 @@ def understand_menu(ui: TextualUI | None) -> str | None:
     try:
         bundles = understand_manager().list_bundles()
         if not bundles:
-            _corpus_info(ui, t("understand.title"), [t("understand.empty")])
+            _instructions_info(ui, t("understand.title"), [t("understand.empty")])
             return None
         return choose(t("understand.title"), [
             MenuOption(row["id"], row["title"],
@@ -9205,11 +9213,11 @@ def understand_menu(ui: TextualUI | None) -> str | None:
                            count=row["item_count"]))
             for row in bundles
         ], bundles[0]["id"], ui, allow_back=True,
-            corpus_lines=[t("understand.description"), t("understand.session.scope")])
+            instructions_lines=[t("understand.description"), t("understand.session.scope")])
     except BackRequested:
         return None
     except (OSError, RuntimeError, ValueError) as exc:
-        _corpus_info(ui, t("understand.title"), [str(exc)])
+        _instructions_info(ui, t("understand.title"), [str(exc)])
         return None
 
 
@@ -9228,24 +9236,24 @@ def shell_connection_menu(ui: TextualUI | None, dry_run: bool = False) -> None:
                 MenuOption("restore", t("shell.restore"), t("shell.restore.description")),
                 MenuOption("remove", t("shell.remove"), t("shell.remove.description")),
                 MenuOption("back", t("distill.back.label"), t("shell.back")),
-            ], "back", ui, allow_back=True, corpus_lines=lines)
+            ], "back", ui, allow_back=True, instructions_lines=lines)
             if selected == "back":
                 return
             decision = choose(t("shell.confirm"), [
                 MenuOption("cancel", t("shell.cancel"), t("shell.back")),
                 MenuOption("apply", t("shell.apply"), t("shell.scope")),
-            ], "cancel", ui, allow_back=True, corpus_lines=lines)
+            ], "cancel", ui, allow_back=True, instructions_lines=lines)
             if decision != "apply":
                 continue
             result = manager.apply(selected, dry_run=dry_run)
             message = (t("shell.preview") if dry_run else
                        t("shell.restored") if selected == "restore" else t("shell.removed"))
-            _corpus_info(ui, t("shell.title"), [message, *result["changed_paths"],
+            _instructions_info(ui, t("shell.title"), [message, *result["changed_paths"],
                                               *result.get("needs_action", [])])
         except BackRequested:
             return
         except (ShellIntegrationError, OSError, RuntimeError) as exc:
-            _corpus_info(ui, t("shell.title"), [str(exc)])
+            _instructions_info(ui, t("shell.title"), [str(exc)])
 # Language names render in their own language BY DESIGN — a reader hunting for
 # their language must be able to recognise it whatever UI language is active — so
 # these labels are deliberately catalog-independent.
@@ -9285,7 +9293,7 @@ def choose_language(
         # refusal is reported and returns to the hub; this is that, for the same
         # reason. The catalogs are deliberately not reloaded: the file still holds the
         # previous language, so the session keeps rendering what was actually saved.
-        _corpus_info(ui, t("language.title"), [str(exc)])
+        _instructions_info(ui, t("language.title"), [str(exc)])
         return
     load_catalogs(config_path)
 
@@ -9314,31 +9322,31 @@ def pick_mode_and_preset(
     user_names = set(load_user_presets(user_presets_path(config_path))) if config_path else set()
     mode = resume_mode
     while True:
-        status = load_corpus_status()
-        corpus_description = _corpus_launch_description(status)
+        status = load_instructions_status()
+        instructions_description = _instructions_launch_description(status)
         if mode is None:
             mode_options = [
                 MenuOption(SWE_MODE, t("mode.swe.label"),
-                           t("mode.swe.description") + "\n\n" + corpus_description),
+                           t("mode.swe.description") + "\n\n" + instructions_description),
                 MenuOption(
                     DEFAULT_PRESET_MODE,
                     t("mode.builder.label"),
-                    t("mode.builder.description") + "\n\n" + corpus_description,
+                    t("mode.builder.description") + "\n\n" + instructions_description,
                 ),
                 MenuOption(
                     DISTILL_MODE,
                     t("mode.distill.label"),
-                    t("mode.distill.description") + "\n\n" + corpus_description,
+                    t("mode.distill.description") + "\n\n" + instructions_description,
                 ),
             ]
             mode_options.append(
                 MenuOption(
-                    CORPUS_OPTION,
-                    t("corpus.private.title") if private_corpus_enabled() else t("corpus.label"),
-                    t("corpus.private.description") if private_corpus_enabled() else t("corpus.description"),
+                    INSTRUCTIONS_OPTION,
+                    t("instructions.private.title") if private_instructions_enabled() else t("instructions.label"),
+                    t("instructions.private.description") if private_instructions_enabled() else t("instructions.description"),
                 )
             )
-            if private_corpus_enabled():
+            if private_instructions_enabled():
                 mode_options.append(MenuOption(UNDERSTAND_OPTION, t("understand.title"), t("understand.description")))
                 mode_options.append(MenuOption(SHELL_CONNECTION_OPTION, t("shell.title"), t("shell.description")))
             if config_path is not None:
@@ -9386,16 +9394,16 @@ def pick_mode_and_preset(
                 DEFAULT_PRESET_MODE,
                 ui,
                 preview=preview_mode,
-                corpus_lines=corpus_summary_lines(status),
+                instructions_lines=instructions_summary_lines(status),
             )
-        if mode == CORPUS_OPTION:
-            if private_corpus_enabled():
+        if mode == INSTRUCTIONS_OPTION:
+            if private_instructions_enabled():
                 if ui is not None:
-                    raise CorpusStudioRequested()
-                open_corpus_studio()
+                    raise InstructionsStudioRequested()
+                open_instructions_studio()
                 mode = None
                 continue
-            _corpus_screen(ui, lambda: corpus_checklist(ui))
+            _instructions_screen(ui, lambda: instructions_checklist(ui))
             mode = None
             continue
         if mode == SHELL_CONNECTION_OPTION:
@@ -9427,7 +9435,7 @@ def pick_mode_and_preset(
                 data["label"],
                 (preset_descriptions().get(name, data.get("description", ""))
                  if name not in user_names else data.get("description", ""))
-                + "\n\n" + corpus_description,
+                + "\n\n" + instructions_description,
             )
             for name, data in presets.items()
             if preset_mode(data) == mode
@@ -9438,7 +9446,7 @@ def pick_mode_and_preset(
                     CUSTOM_PRESET,
                     t("preset.custom.label"),
                     t("preset.custom.description")
-                    + "\n\n" + corpus_description,
+                    + "\n\n" + instructions_description,
                 )
             )
         default = mode_default_preset(presets, mode) or CUSTOM_PRESET
@@ -9609,11 +9617,11 @@ def child_agent_registrations(
             raise LaunchError(f"Codex agent template requires description: {source}")
         data["model"] = plan["tiers"][tier]["model"]
         data["model_reasoning_effort"] = tier_effort(plan, tier)
-        if plan.get("corpus_instruction_text"):
-            # The child's own instruction body and the selected parent corpus are
+        if plan.get("instructions_instruction_text"):
+            # The child's own instruction body and the selected parent instructions are
             # composed before the content-addressed config path is derived.
             existing = data.get("developer_instructions", "")
-            data["developer_instructions"] = existing + "\n\n" + plan["corpus_instruction_text"]
+            data["developer_instructions"] = existing + "\n\n" + plan["instructions_instruction_text"]
         lines = []
         for key, value in data.items():
             if not isinstance(value, (str, int, float, bool)):
@@ -10123,7 +10131,7 @@ def delegation_clause(plan: dict[str, Any]) -> str:
 
     The CLI's line carries its own exception, so the fix is to satisfy it rather than argue
     with it. Delegation IS the user's standing request — they chose the preset, and the
-    corpus's standing spawn policy is their instruction — so the contract says so in the
+    instructions's standing spawn policy is their instruction — so the contract says so in the
     words that clause is looking for. Nothing is overridden; a fact that was already true
     is simply stated where the reader can see it."""
     if sweep_main(plan):
@@ -10164,8 +10172,8 @@ def claude_agents(plan: dict[str, Any]) -> str:
             # allowlist enforces its one-rule-per-item contract instead of merely
             # restating it in the prompt.
             prompt += " Apply one explicit read-only rule per item; do not make semantic judgments."
-        if plan.get("corpus_instruction_text"):
-            prompt += "\n\n" + plan["corpus_instruction_text"]
+        if plan.get("instructions_instruction_text"):
+            prompt += "\n\n" + plan["instructions_instruction_text"]
         role = {
             "description": f"{tier.upper()} tier: {format_model_effort(binding['model'], effort)}",
             "prompt": prompt,
@@ -10647,7 +10655,7 @@ def print_summary(
                 "(permission mode, not OS sandbox)",
                 file=stream,
             )
-        if private_corpus_enabled():
+        if private_instructions_enabled():
             print(
                 "  Global files   "
                 + t("global-instructions.summary").format(
@@ -10729,16 +10737,16 @@ def parse_args(argv: list[str]) -> argparse.Namespace:
     )
     parser.add_argument("--yes", action="store_true", help="skip launch confirmation")
     parser.add_argument("--dry-run", action="store_true", help="print projection without launching")
-    parser.add_argument("--corpus", action="store_true", help="open private Corpus Studio")
-    parser.add_argument("--understand", metavar="BUNDLE", help="start an interactive learning session for a corpus bundle; list with agent-bios understand list")
-    parser.add_argument("--corpus-domains", help="domain selection for this activated session only")
-    parser.add_argument("--corpus-native", action="store_true", help="opt into selected corpus hooks on either host and Claude native agents for this session only")
+    parser.add_argument("--instructions", "--corpus", action="store_true", help="open private Instructions Studio")
+    parser.add_argument("--understand", metavar="BUNDLE", help="start an interactive learning session for an instruction bundle; list with agent-bios understand list")
+    parser.add_argument("--instructions-domains", "--corpus-domains", help="domain selection for this activated session only")
+    parser.add_argument("--instructions-native", "--corpus-native", action="store_true", help="opt into selected instructions hooks on either host and Claude native agents for this session only")
     parser.add_argument(
         "--exclude-global-instructions",
         action="store_true",
         help="omit only personal global AGENTS.md/CLAUDE.md files and imports for this private Claude session",
     )
-    parser.add_argument("--resume-session", help="resume a host session with its pinned corpus")
+    parser.add_argument("--resume-session", help="resume a host session with its pinned instructions")
     parser.add_argument(
         "--verify-receipts", nargs=2, metavar=("PLAN", "RECEIPTS"),
         help="adjudicate a ReviewPlan/v1 record against a ReviewReceipts/v1 bundle and exit",
@@ -10810,14 +10818,14 @@ def parse_args(argv: list[str]) -> argparse.Namespace:
     hostless = (
         args.verify_receipts or args.emit_receipt or args.fold_receipts
         or args.check_adapter or args.compile_criterion or args.check_findings
-        or args.check_schema_flag or args.corpus
+        or args.check_schema_flag or args.instructions
     )
     if args.host is None and not hostless:
         parser.error("the following arguments are required: host")
-    if args.understand and (args.preset or args.custom or args.corpus or args.resume_session
-                           or args.corpus_native or args.corpus_domains is not None
+    if args.understand and (args.preset or args.custom or args.instructions or args.resume_session
+                           or args.instructions_native or args.instructions_domains is not None
                            or args.exclude_global_instructions or args.forward):
-        parser.error("--understand selects its own learning setup and cannot be combined with preset, corpus, resume, custom, global-exclusion or forwarded options")
+        parser.error("--understand selects its own learning setup and cannot be combined with preset, instructions, resume, custom, global-exclusion or forwarded options")
     if args.evidence and not args.emit_receipt:
         parser.error("--evidence only applies to --emit-receipt")
     if args.packet and not args.verify_receipts:
@@ -11054,8 +11062,8 @@ def _tolerate_narrow_stdout() -> None:
 def main(argv: list[str], *, bundled_ui: bool = False) -> int:
     _tolerate_narrow_stdout()
     args = parse_args(drop_check_adapter_separator(argv))
-    if args.corpus:
-        open_corpus_studio()
+    if args.instructions:
+        open_instructions_studio()
         return 0
     if args.verify_receipts:
         return verify_receipts_command(
@@ -11080,7 +11088,7 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
         return check_adapter_command(args.check_adapter[0], args.check_adapter[1:])
     config_path = args.config.expanduser()
     generation = None
-    if private_corpus_enabled():
+    if private_instructions_enabled():
         bare = not args.preset and not args.custom and not args.understand and not args.dry_run and (
             args.no_tui or bool(args.forward) or os.environ.get("AGENT_LAUNCH_TUI") == "0"
             or not (sys.stdin.isatty() and sys.stdout.isatty()))
@@ -11090,7 +11098,7 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
         config = load_config(config_path)
     command, bare_args = resolve_backend(config, args.host)
     if args.exclude_global_instructions and not args.resume_session:
-        if not private_corpus_enabled():
+        if not private_instructions_enabled():
             raise LaunchError(
                 "excluding global instruction files requires an agent-bios activated session"
             )
@@ -11107,30 +11115,30 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
         for preset in config.get("presets", {}).values():
             if isinstance(preset, dict):
                 preset["include_global_instructions"] = False
-    if args.corpus_native and not private_corpus_enabled():
-        raise LaunchError("--corpus-native requires a private installation; run agent-bios install first")
-    if private_corpus_enabled():
+    if args.instructions_native and not private_instructions_enabled():
+        raise LaunchError("--instructions-native requires a private installation; run agent-bios install first")
+    if private_instructions_enabled():
         # Private templates retain the native host's config home and registrations.
-        private_root = corpus_package_root()
+        private_root = instructions_package_root()
         os.environ["AGENT_BIOS_PACKAGE_ROOT"] = str(private_root)
         config["hosts"]["codex"]["agent_templates"] = {
             tier: str(private_root / "codex/agents" / f"{tier}.toml") for tier in SPAWNABLE_TIERS
         }
     if args.resume_session:
         if (
-            args.corpus_native
-            or args.corpus_domains is not None
+            args.instructions_native
+            or args.instructions_domains is not None
             or args.exclude_global_instructions
         ):
             raise LaunchError(
-                "resume uses its pinned corpus/native/global-instruction configuration; "
+                "resume uses its pinned instructions/native/global-instruction configuration; "
                 "start a new session to change it"
             )
-        if not private_corpus_enabled():
-            raise LaunchError("a corpus-pinned resume requires a private installation")
-        store = corpus_store()
-        import corpus_session
-        return corpus_session.launch(command, [], store.state_root, args.host, {},
+        if not private_instructions_enabled():
+            raise LaunchError("an instruction-pinned resume requires a private installation")
+        store = instructions_store()
+        import instructions_session
+        return instructions_session.launch(command, [], store.state_root, args.host, {},
                                      resume_id=args.resume_session)
     nudge = session_distill_nudge(config)
     if nudge:
@@ -11148,11 +11156,11 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
     bypass = args.no_tui or bool(args.forward) or os.environ.get("AGENT_LAUNCH_TUI") == "0"
     if (bypass or not tty) and not args.preset and not args.custom and not args.understand and not args.dry_run:
         if (
-            args.corpus_native
-            or args.corpus_domains is not None
+            args.instructions_native
+            or args.instructions_domains is not None
             or args.exclude_global_instructions
         ):
-            raise LaunchError("corpus launch options require --preset NAME or an interactive configured launch")
+            raise LaunchError("instructions launch options require --preset NAME or an interactive configured launch")
         # The bare launch: nothing decides policy but the backend's own bare-launch
         # arguments. Every other path below projects the preset's policy instead.
         exec_backend(command, [*bare_args, *args.forward])
@@ -11212,26 +11220,26 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
                     shell_dry_run=args.dry_run,
                 )
             break
-        except CorpusApplyRequested as request:
+        except InstructionsApplyRequested as request:
             # The Textual app is already torn down; the installer owns the
             # terminal for the duration, and the picker re-opens on a fresh
             # status projection afterwards.
-            run_corpus_apply(request.selection)
+            run_instructions_apply(request.selection)
             continue
-        except CorpusStudioRequested:
-            open_corpus_studio()
+        except InstructionsStudioRequested:
+            open_instructions_studio()
             continue
         except UnderstandRequested as request:
             plan = build_understand_plan(config, args.host, request.bundle_id)
             break
     learning = None
     if plan.get("understand_bundle"):
-        if args.forward or args.corpus_native or args.corpus_domains is not None:
-            raise LaunchError("understand! cannot use forwarded arguments or native corpus activation")
+        if args.forward or args.instructions_native or args.instructions_domains is not None:
+            raise LaunchError("understand! cannot use forwarded arguments or native instructions activation")
         learning = understand_manager().show(plan["understand_bundle"])
     validate_review_setup(plan)
     if not plan.get("include_global_instructions", True):
-        if not private_corpus_enabled():
+        if not private_instructions_enabled():
             raise LaunchError(
                 "excluding global instruction files requires an agent-bios activated session"
             )
@@ -11246,19 +11254,19 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
             )
     snapshot = None
     store = None
-    if private_corpus_enabled() and not plan_projects_nothing(plan):
-        store = corpus_store()
+    if private_instructions_enabled() and not plan_projects_nothing(plan):
+        store = instructions_store()
         selected = None
-        if args.corpus_domains is not None:
-            raw = [x.strip() for x in args.corpus_domains.split(",") if x.strip()]
+        if args.instructions_domains is not None:
+            raw = [x.strip() for x in args.instructions_domains.split(",") if x.strip()]
             if "none" in raw and raw != ["none"]:
-                raise LaunchError("--corpus-domains none cannot be combined with other domains")
+                raise LaunchError("--instructions-domains none cannot be combined with other domains")
             selected = [] if raw == ["none"] else [
                 x if x.startswith("@") else f"@agent-bios/core/{x}" for x in raw
             ]
         snapshot = _snapshot_from_config(store, config_path, generation, args.host, selected,
-                                         dry_run=args.dry_run, native=args.corpus_native)
-        plan["corpus_instruction_text"] = snapshot["instruction_text"]
+                                         dry_run=args.dry_run, native=args.instructions_native)
+        plan["instructions_instruction_text"] = snapshot["instruction_text"]
     projected_args = project_args(plan, materialize_agents=not args.dry_run)
     collisions = forwarded_collisions(projected_args, args.forward)
     if collisions:
@@ -11271,8 +11279,8 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
     if learning is not None and args.dry_run:
         projected += [understand_initial_prompt("<pinned-understand-session-prompt>")]
     if snapshot is not None and args.dry_run:
-        import corpus_session
-        projected = corpus_session.compose_argv(
+        import instructions_session
+        projected = instructions_session.compose_argv(
             command,
             projected,
             args.host,
@@ -11281,17 +11289,17 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
         )
     summary_stream = sys.stdout if tty or args.dry_run else sys.stderr
     if snapshot is not None:
-        print(f"  Corpus snapshot {snapshot['content_ref']} · private · next session only", file=summary_stream)
-        if args.corpus_native:
+        print(f"  Instructions snapshot {snapshot['content_ref']} · private · next session only", file=summary_stream)
+        if args.instructions_native:
             plugins = snapshot.get("assets", {}).get("claude_plugins", [])
             hooks = snapshot.get("assets", {}).get("codex_hooks", {})
             if args.host == "codex":
                 count = sum(len(group["hooks"]) for groups in hooks.values() for group in groups)
-                print(f"  Native corpus opt-in: {count} session-only hook(s); Codex enablement and /hooks trust review apply.", file=summary_stream)
+                print(f"  Native instructions opt-in: {count} session-only hook(s); Codex enablement and /hooks trust review apply.", file=summary_stream)
             else:
-                print(f"  Native corpus opt-in: {len(plugins)} session-only plugin(s); selected hook code can execute.", file=summary_stream)
+                print(f"  Native instructions opt-in: {len(plugins)} session-only plugin(s); selected hook code can execute.", file=summary_stream)
         for unavailable in snapshot.get("unavailable", []):
-            print(f"  Corpus unavailable: {unavailable}", file=summary_stream)
+            print(f"  Instructions unavailable: {unavailable}", file=summary_stream)
     if learning is not None:
         print(f"  Understand!    {learning['title']} · {learning['source_ref']}", file=summary_stream)
         print("  Learning       Pinned bundle as reference material; native global files remain unchanged.", file=summary_stream)
@@ -11327,8 +11335,8 @@ def main(argv: list[str], *, bundled_ui: bool = False) -> int:
         env["AGENT_BIOS_UNDERSTAND_SESSION"] = session["session_id"]
     summary_stream.flush()
     if snapshot is not None:
-        import corpus_session
-        return corpus_session.launch(command, projected, store.state_root, args.host,
+        import instructions_session
+        return instructions_session.launch(command, projected, store.state_root, args.host,
                                      snapshot, env=env,
                                      include_global_instructions=plan["include_global_instructions"])
     exec_backend(command, projected, env)