@explyt/ai-agent 0.3.1-dogfood.4 → 0.3.2

package/README.md

@@ -17,8 +17,8 @@ explyt update                # install the newer latest, then restart open sessi
 For a one-off pinned run:
 
 ```bash
-npx -y "@explyt/ai-agent@0.3.1"          # start the terminal UI
-npx -y "@explyt/ai-agent@0.3.1" login    # store a provider credential, once
+npx -y "@explyt/ai-agent@0.3.2"          # start the terminal UI
+npx -y "@explyt/ai-agent@0.3.2" login    # store a provider credential, once
 ```
 
 The agent runs with exactly the extensions this build ships with and ignores any
@@ -28,4 +28,4 @@ you get.
 IDE (ACP) integration is not part of this package: it is provided by the Explyt
 managed backend, which the Neo plugin downloads and manages.
 
-Run `npx -y @explyt/ai-agent@0.3.1 --help` for the available options.
+Run `npx -y @explyt/ai-agent@0.3.2 --help` for the available options.

package/agent-docs/README.md

@@ -15,7 +15,7 @@ it. Read the whole file before editing anything it describes.
 | `agents.md` | helper agents and model profiles: where the files live, every field, which model a helper runs on, disabling one |
 | `mcp.md` | MCP servers: the two `mcp.json` files, the entry shape, disabling a server or a tool |
 | `web-search.md` | web search and page fetch: `web-search.json`, where requests go, keys, switching search off, failures |
-| `plugins.md` | Marketplace plugins: the project manifest, the `explyt plugin` command, plugin values |
+| `plugins.md` | Marketplace plugins (dogfood builds only; a stable build has neither this file nor `explyt plugin`): the project manifest, the `explyt plugin` command, plugin values |
 | `telegram.md` | the Telegram remote for terminal sessions (dogfood builds only; a stable build has neither this file nor `/telegram`): setup and pairing, `/telegram` and its subcommands, notifications, its files, what leaves the machine |
 
 ## User configuration lives under `.explyt/`
@@ -37,11 +37,13 @@ all projects, and in the project directory for one project:
 <project>/.explyt/mcp.json           MCP servers for this project
 <project>/.explyt/agents/*.md        helper agents for this project
 <project>/.explyt/models/*.md        model profiles for this project
-<project>/.explyt/plugins.json       Marketplace plugins enabled for this project
+<project>/.explyt/plugins.json       Marketplace plugins enabled for this project (dogfood builds only)
 ```
 
 Installed plugin payloads and plugin values are not user configuration files: they live in the
-product data directory and change only through `explyt plugin` (see `plugins.md`).
+product data directory and change only through `explyt plugin` (see `plugins.md`). Marketplace
+plugins ship in dogfood builds only: if `plugins.md` is absent here, this build has no `explyt
+plugin`, does not read `plugins.json`, and no plugin adds rules, Skills or MCP servers.
 
 Create these files and directories when they do not exist; nothing has to be registered anywhere
 for them to take effect.

package/agent-docs/mcp.md

@@ -9,7 +9,7 @@ An MCP server gives the agent extra tools, resources and prompts. Servers are de
 | global | `~/.explyt/mcp.json` | the user |
 | project | `<project>/.explyt/mcp.json` | the user |
 | session | the `mcpServers` field of the IDE's session request | the IDE |
-| plugin | the Marketplace plugins `<project>/.explyt/plugins.json` enables | the plugin author |
+| plugin | the Marketplace plugins `<project>/.explyt/plugins.json` enables (dogfood builds only) | the plugin author |
 
 These four and nothing else. Other tools' MCP files are **not** read — not `~/.config/mcp/mcp.json`,
 not `~/.agents/mcp.json`, not `<project>/.mcp.json`, and not the legacy

package/agent-docs/rules.md

@@ -15,7 +15,8 @@ does not repeat them in every conversation.
 | `<project>/.claude/CLAUDE.md` | `project:.claude/CLAUDE.md` | plain Markdown |
 | `<project>/CLAUDE.local.md` | `project:CLAUDE.local.md` | plain Markdown |
 
-Only these locations, plus the rules of the Marketplace plugins the project enables. A `CLAUDE.md`
+Only these locations, plus the rules of the Marketplace plugins the project enables (dogfood builds
+only). A `CLAUDE.md`
 or `AGENTS.md` in a subdirectory is not picked up, and there is no search up the directory tree —
 the project is the session's working directory.
 

package/agent-docs/skills.md

@@ -27,7 +27,7 @@ project. No root outranks another, and the tool a Skill was written for is never
 
 The project root is the session's working directory; there is no search up the directory tree.
 
-The Marketplace plugins the project enables add their own Skills: each `skills/<name>/SKILL.md` of
+In a dogfood build, the Marketplace plugins the project enables add their own Skills: each `skills/<name>/SKILL.md` of
 the enabled plugin version. A plugin Skill is part of the plugin — do not edit or copy it;
 `plugins.md` describes how a plugin is enabled.
 

package/dist/cli/brand-profile.js

@@ -0,0 +1,95 @@
+/**
+ * The brand profile of this built tree, generated by scripts/build-release.mjs from
+ * cli/brand-profile.mjs (spec #344, RQ-20). The tree is built for one brand: it does not read
+ * AGENT_BRAND and carries no other brand's values.
+ */
+
+/** The brand this tree was built for. */
+const STAMPED_BRAND = "explyt";
+
+/** @typedef {typeof STAMPED_BRAND} BrandId */
+
+/** The brands of this tree: its own. */
+export const BRAND_IDS = Object.freeze([STAMPED_BRAND]);
+
+/** @param {any} value */
+function freeze(value) {
+  for (const inner of Object.values(value)) if (inner && typeof inner === "object") freeze(inner);
+  return Object.freeze(value);
+}
+
+const PROFILE = freeze({
+  "id": "explyt",
+  "command": "explyt",
+  "cliPackage": "@explyt/ai-agent",
+  "adapterPackage": "@explyt/acp-adapter",
+  "stateDir": "explyt-ai-agent",
+  "productName": "Explyt AI Agent",
+  "developer": "Explyt",
+  "site": "explyt.ai",
+  "configDir": ".explyt",
+  "sourceRepository": "explyt/explyt-ai-agent",
+  "starters": {
+    "kind": "github",
+    "repository": "explyt/explyt-ai-agent-distribution"
+  },
+  "starterUrlBase": "https://raw.githubusercontent.com/explyt/explyt-ai-agent-distribution/main/",
+  "managedBackend": {
+    "repository": "explyt/explyt-ai-agent-distribution"
+  },
+  "telemetryEndpoint": "https://plugin.explyt.ai/telemetry",
+  "mcpAlias": "explyt-mcp",
+  "loginCommand": "explyt login",
+  "githubCloneDir": "explyt-github-repos",
+  "agentDirEnv": "EXPLYT_CODING_AGENT_DIR",
+  "updateCheckEnv": "EXPLYT_UPDATE_CHECK",
+  "oauth": {
+    "keyringService": "pi-mcp-adapter.oauth",
+    "redirectUri": "http://127.0.0.1:34517/callback",
+    "clientName": "Explyt"
+  },
+  "environments": {
+    "npmPublish": "npm-publish",
+    "npmPublishDogfood": "npm-publish-dogfood"
+  },
+  "localIds": {
+    "build": "explyt-local-build",
+    "release": "explyt-local-release"
+  },
+  "localNames": {
+    "build": "Explyt AI Agent LOCAL BUILD",
+    "release": "Explyt AI Agent LOCAL RELEASE"
+  },
+  "account": {
+    "providerId": "explyt",
+    "name": "Explyt",
+    "keycloakBase": "https://app.explyt.ai/keycloak",
+    "realm": "explyt",
+    "clientId": "plugin-client",
+    "cabinetApi": "https://app.explyt.ai/api/v1/data",
+    "personalAccount": "https://app.explyt.ai/",
+    "modelBase": "https://plugin.explyt.ai/openai/api/v1"
+  },
+  "language": {
+    "default": "en",
+    "selectable": false
+  }
+});
+
+export const BRAND_PROFILES = Object.freeze({ [STAMPED_BRAND]: PROFILE });
+
+/** @param {string} id */
+export function brandProfile(id) {
+  if (id !== STAMPED_BRAND) throw new Error(`unknown brand "${id}"; this tree is built for ${STAMPED_BRAND}`);
+  return PROFILE;
+}
+
+/** A built tree's brand is fixed: it ignores AGENT_BRAND. */
+export function selectBrand() {
+  return STAMPED_BRAND;
+}
+
+/** This module is a built tree's stamped copy. */
+export const BUILT = true;
+
+export const BRAND = PROFILE;

package/dist/cli/engine.js

@@ -23,6 +23,7 @@ import {
 import { basename, delimiter, dirname, isAbsolute, join, posix, resolve, sep, win32 } from "node:path";
 import { homedir, platform, tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
+import { BRAND } from "./brand-profile.js";
 import { createHash, randomBytes } from "node:crypto";
 
 export const ENGINE_PACKAGE = "@earendil-works/pi-coding-agent";
@@ -35,8 +36,11 @@ export const ENGINE_PACKAGE = "@earendil-works/pi-coding-agent";
  * variable from this string (`${name.toUpperCase()}_CODING_AGENT_DIR`,
  * `dist/config.js`), and a space would put a space into an environment variable
  * name. The full product name goes into the header our own extension draws.
+ *
+ * It is the brand's terminal command (spec #344, RQ-6), so the engine's `/help` and exit hints
+ * name the command a user actually types.
  */
-export const ENGINE_BRAND = "explyt";
+export const ENGINE_BRAND = BRAND.command;
 
 /**
  * Engine variable naming the directory it keeps its configuration in, as the
@@ -70,6 +74,17 @@ export const AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
  */
 export const BRANDED_AGENT_DIR_ENV = `${ENGINE_BRAND.toUpperCase()}_CODING_AGENT_DIR`;
 
+/**
+ * Marks which brand set PI_CODING_AGENT_DIR (spec #344, RQ-18, RQ-23).
+ *
+ * The wrapper sets it to its brand id whenever it sets the agent directory. A process of the
+ * other brand started from inside this one (a run of the other brand's command from this
+ * session's bash tool)
+ * inherits PI_CODING_AGENT_DIR; the marker is how it tells the inherited directory from a
+ * user's deliberate export, which carries no marker and keeps winning (spec 010 RQ-4).
+ */
+export const AGENT_DIR_BRAND_ENV = "AGENT_DIR_BRAND";
+
 /**
  * Silences the engine's "New version X is available. Run `<name> update`" banner.
  *
@@ -92,7 +107,7 @@ export const ENGINE_TELEMETRY_ENV = "PI_TELEMETRY";
  * `initialize` and a restored session's id (`vendor/pi-acp/src/acp/translate/telemetry-env.ts`), plus
  * the launching turn a subagent manager hands its child
  * (`packages/shared/src/telemetry/correlation.ts`). Spelled here because `cli/` ships without
- * those modules. A tool of an ACP engine inherits all three, so an `explyt` it runs would report
+ * those modules. A tool of an ACP engine inherits all three, so a product command it runs would report
  * the IDE's client and conversation; a terminal session is `terminal` (spec 022 RQ-6), so the
  * terminal launch removes them. `EXPLYT_TELEMETRY_RECORD_FILE` is not here: RQ-32 wants it
  * inherited.
@@ -368,12 +383,19 @@ export function agentConfigDir(env = process.env, home = homedir()) {
  * directory in MSYS form on Windows gets a split until that is confirmed on a machine.
  */
 export function withAgentDir(env, home = homedir()) {
+  // A PI_CODING_AGENT_DIR another brand's wrapper set is that brand's state, not an explicit
+  // choice (spec #344, RQ-23): only that inherited value is ignored. This brand's own variable
+  // (set by its launch file for a non-default installation root) is still honoured, the same
+  // rule cli/launch.mjs applies. Without a marker the value is a user's export, honoured as before.
+  const marker = env[AGENT_DIR_BRAND_ENV];
+  const inheritedFromOtherBrand = typeof marker === "string" && marker !== "" && marker !== BRAND.id;
   // The unbranded name wins when both are set and disagree: it is the one every
   // reader in the process understands, and two different directories in one process
   // is the split this function exists to prevent.
-  const explicit = explicitAgentDir(env[AGENT_DIR_ENV], home) ?? explicitAgentDir(env[BRANDED_AGENT_DIR_ENV], home);
+  const unbranded = inheritedFromOtherBrand ? null : explicitAgentDir(env[AGENT_DIR_ENV], home);
+  const explicit = unbranded ?? explicitAgentDir(env[BRANDED_AGENT_DIR_ENV], home);
   const dir = explicit ?? agentConfigDir(env, home);
-  return { ...env, [AGENT_DIR_ENV]: dir, [BRANDED_AGENT_DIR_ENV]: dir };
+  return { ...env, [AGENT_DIR_ENV]: dir, [BRANDED_AGENT_DIR_ENV]: dir, [AGENT_DIR_BRAND_ENV]: BRAND.id };
 }
 
 /** The engine's reading of an explicit agent-directory value; null when it counts as unset. */
@@ -516,7 +538,7 @@ export function ensureAgentSettings(agentDir, {
 const WEB_SEARCH_CONFIG_FILE = "web-search.json";
 
 /** Last path segment of the directory GitHub repositories are cloned into (spec 015, RQ-3). */
-const GITHUB_CLONE_DIR_NAME = "explyt-github-repos";
+const GITHUB_CLONE_DIR_NAME = BRAND.githubCloneDir;
 
 const isPlainObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 
@@ -976,7 +998,7 @@ export const TERMINAL_ISOLATION_FLAGS = ["--no-extensions", "--no-skills", "--no
  * Engine flag that keeps a run out of the session store.
  *
  * `login` is not a work session: nothing said in it is worth resuming, and the engine's
- * exit hint ("To resume this session: explyt --session <id>") would advertise a session
+ * exit hint ("To resume this session: <command> --session <id>") would advertise a session
  * nobody wants back. Ephemeral, the engine writes no session file and prints no hint.
  * The bare TUI keeps its sessions -- there resuming is a feature.
  */
@@ -1183,22 +1205,34 @@ export function parseArgs(argv) {
   return { command, help, version, rest, terminalLogin };
 }
 
-export function helpText() {
+/**
+ * The usage text. `marketplace` says whether this installation carries the `plugin` command: the
+ * Marketplace ships in dogfood and debug builds only (scripts/extension-classification.mjs), so a
+ * stable build does not advertise it. Off unless the caller found the command.
+ */
+export function helpText({ marketplace = false } = {}) {
+  const { command: cmd, cliPackage: pkg, developer, productName } = BRAND;
+  // Column alignment is part of the text: the existing lines stay byte-identical (spec #344,
+  // RQ-17), and a longer or shorter command or package shifts the description columns.
+  const pad = (text, width) => text.padEnd(Math.max(width, text.length + 1));
+  const npxWidth = 48;
+  const cmdWidth = 21;
+  const installWidth = 49;
   return [
-    "Explyt AI Agent",
+    productName,
     "",
-    "Install with the Explyt installer, then run explyt:",
-    "  explyt install [--channel stable|dogfood]      install or update the managed installation",
+    `Install with the ${developer} installer, then run ${cmd}:`,
+    `${pad(`  ${cmd} install [--channel stable|dogfood]`, installWidth)}install or update the managed installation`,
     "Or run a pinned version without installing:",
-    "  npx -y @explyt/ai-agent@<version>             start the terminal UI",
-    "  npx -y @explyt/ai-agent@<version> tui         start the terminal UI",
-    "  npx -y @explyt/ai-agent@<version> login       store a provider credential",
-    "  npx -y @explyt/ai-agent@<version> logout      remove stored credentials",
+    `${pad(`  npx -y ${pkg}@<version>`, npxWidth)}start the terminal UI`,
+    `${pad(`  npx -y ${pkg}@<version> tui`, npxWidth)}start the terminal UI`,
+    `${pad(`  npx -y ${pkg}@<version> login`, npxWidth)}store a provider credential`,
+    `${pad(`  npx -y ${pkg}@<version> logout`, npxWidth)}remove stored credentials`,
     "",
-    "Commands: explyt tui | login | logout | plugin | install | update | config",
-    "  explyt update      update the managed installation now (same as install)",
-    "  explyt config set updateChannel stable|dogfood | autoUpdate true|false",
-    "  explyt plugin      manage Marketplace plugins (explyt plugin help)",
+    `Commands: ${cmd} tui | login | logout | ${marketplace ? "plugin | " : ""}install | update | config`,
+    `${pad(`  ${cmd} update`, cmdWidth)}update the managed installation now (same as install)`,
+    `  ${cmd} config set updateChannel stable|dogfood | autoUpdate true|false`,
+    ...(marketplace ? [`${pad(`  ${cmd} plugin`, cmdWidth)}manage Marketplace plugins (${cmd} plugin help)`] : []),
     "  --permission-mode default|paranoid|bypassPermissions   start the terminal UI in that mode",
     "  -h, --help         show this message",
     "  -v, --version      print the version",
@@ -1206,7 +1240,7 @@ export function helpText() {
     "Credentials and sessions are separate from other agents: logging in to a pi you run",
     "by hand does not log in here, so run login once for this agent.",
     "The terminal UI notes a newer version at startup; PI_OFFLINE=1 turns the check off.",
-    "IDE (ACP) integration is set up by the Explyt installer, which places the adapter",
+    `IDE (ACP) integration is set up by the ${developer} installer, which places the adapter`,
     "next to this package; it is not part of this package.",
     "",
   ].join("\n");

package/dist/cli/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-// The single user-facing entry point of @explyt/ai-agent.
+// The single user-facing entry point of the CLI package (the brand's `cliPackage`, spec #344).
 //
 // The public npm package is a TERMINAL product:
 //
-//   npx @explyt/ai-agent          a human: start the terminal UI
-//   npx @explyt/ai-agent tui      the same, spelled explicitly
-//   npx @explyt/ai-agent login    a human, once: store a provider credential
-//   npx @explyt/ai-agent logout   a human: remove the stored credentials
+//   npx <cli package>          a human: start the terminal UI
+//   npx <cli package> tui      the same, spelled explicitly
+//   npx <cli package> login    a human, once: store a provider credential
+//   npx <cli package> logout   a human: remove the stored credentials
 //
-// ACP is NOT part of this package: the adapter is the separate package
-// `@explyt/acp-adapter` (spec 019). `acp` loads it when the installer placed it next to
+// ACP is NOT part of this package: the adapter is the brand's separate adapter package
+// (spec 019). `acp` loads it when the installer placed it next to
 // this CLI in an installed release, or from the backend and debug trees, which carry it
 // inside this package root; otherwise `acp` refuses and names the installer. The CLI
 // never depends on the adapter (RQ-1).
@@ -29,6 +29,7 @@
 // only. Any stray write corrupts the stream and the client drops the connection, so
 // all diagnostics in this file go to stderr.
 
+import { BRAND } from "./brand-profile.js";
 import { installationRoot, secondRootWarning } from "./install-roots.js";
 // The installer, `config` and the update helpers are imported in the branches that use them:
 // `acp` uses none, and their ~20 modules plus semver would be files every cold ACP start opens.
@@ -74,12 +75,18 @@ if (args.terminalLogin) {
 }
 
 function fail(message, code = 1) {
-  process.stderr.write(`explyt: ${message}\n`);
+  process.stderr.write(`${BRAND.command}: ${message}\n`);
   process.exit(code);
 }
 
 if (!packageRoot) fail("cannot locate the package root (no package.json above this file)");
 
+// The `plugin` command's module: bundled beside this file in a tree that carries the Marketplace,
+// the TypeScript source in a checkout. A stable build carries neither (the Marketplace is
+// dogfood-only, scripts/extension-classification.mjs), so it neither offers nor runs the command.
+const pluginEntry = [join(here, "plugin.js"), join(packageRoot, "extensions", "plugins", "cli.ts")]
+  .find((candidate) => existsSync(candidate));
+
 /**
  * How to reach the engine that ships alongside this package.
  *
@@ -108,7 +115,7 @@ async function findEngine() {
   // the installed manifest. A failed shim is reported and the engine runs unbranded.
   const shim = ensureEngineShim(engineDir, engineShimDir(process.env, undefined, engineDir));
   if (shim.status === "failed") {
-    process.stderr.write(`explyt: engine keeps its own name: ${shim.detail}\n`);
+    process.stderr.write(`${BRAND.command}: engine keeps its own name: ${shim.detail}\n`);
   }
   return { engineDir, entrypoint, binDir, shimDir: shim.shimDir };
 }
@@ -118,9 +125,9 @@ async function requireEngine() {
   if (engine) return engine;
   fail(
     `the agent engine is missing (looked for ${ENGINE_PACKAGE} next to ${packageRoot}).\n` +
-    "  A global install: reinstall it with npm i -g @explyt/ai-agent@<version>.\n" +
+    `  A global install: reinstall it with npm i -g ${BRAND.cliPackage}@<version>.\n` +
     "  An npx run: npx reuses its cached copy, so delete the _npx directory inside\n" +
-    "  the npm cache (npm config get cache) and run npx -y @explyt/ai-agent@<version> again.\n" +
+    `  the npm cache (npm config get cache) and run npx -y ${BRAND.cliPackage}@<version> again.\n` +
     "  The engine is a peer dependency: with legacy-peer-deps=true in an npmrc (or\n" +
     "  --legacy-peer-deps) npm skips it, so remove that setting before reinstalling.",
   );
@@ -145,7 +152,7 @@ if (args.command === "acp" && (args.help || args.version)) {
 }
 
 if (args.help) {
-  process.stdout.write(helpText());
+  process.stdout.write(helpText({ marketplace: pluginEntry !== undefined }));
   process.exit(0);
 }
 
@@ -155,7 +162,7 @@ if (args.version) {
   process.stdout.write(`${version}\n`);
   // RQ-46: a second installation root is named on stderr; stdout stays the version.
   const secondRoot = secondRootWarning({ root: installationRoot() });
-  if (secondRoot) process.stderr.write(`explyt: warning: ${secondRoot}\n`);
+  if (secondRoot) process.stderr.write(`${BRAND.command}: warning: ${secondRoot}\n`);
   process.exit(0);
 }
 
@@ -181,10 +188,8 @@ if (args.command === "config") {
 // tree carries them bundled beside this file, a source checkout runs the module itself through
 // Node's type stripping.
 if (args.command === "plugin") {
-  const candidates = [join(here, "plugin.js"), join(packageRoot, "extensions", "plugins", "cli.ts")];
-  const entry = candidates.find((candidate) => existsSync(candidate));
-  if (!entry) fail("the plugin command is missing from this installation");
-  const { runPluginCli } = await import(pathToFileURL(entry).href);
+  if (!pluginEntry) fail("the plugin command is not available in this build: Marketplace plugins ship in dogfood builds only", 2);
+  const { runPluginCli } = await import(pathToFileURL(pluginEntry).href);
   const code = await runPluginCli(args.rest, {
     stdout: (text) => process.stdout.write(text),
     stderr: (text) => process.stderr.write(text),
@@ -207,7 +212,7 @@ const wantsTui = args.command === "tui" || (!args.command && !wantsAcp);
 if (!args.command && args.rest[0] && !args.rest[0].startsWith("-")) {
   // An unknown first word is a mistyped command, not a request to start the UI.
   // Flags are forwarded to the engine untouched.
-  fail(`unknown command: ${args.rest[0]}\n\n${helpText()}`, 2);
+  fail(`unknown command: ${args.rest[0]}\n\n${helpText({ marketplace: pluginEntry !== undefined })}`, 2);
 }
 
 // `logout` is the disposal half of `login`: it deletes the credential file inside
@@ -226,8 +231,8 @@ if (wantsLogout) {
     fail(`cannot remove the stored credentials at ${authFile}: ${error.message}`);
   }
   process.stderr.write(existed
-    ? `explyt: credentials removed (${authFile})\n`
-    : `explyt: no stored credentials at ${authFile}\n`);
+    ? `${BRAND.command}: credentials removed (${authFile})\n`
+    : `${BRAND.command}: no stored credentials at ${authFile}\n`);
   process.exit(0);
 }
 
@@ -260,7 +265,7 @@ if (wantsTui || wantsLogin) {
   // The engine's own header must not flash before ours; see SEEDED_SETTINGS.
   const settings = ensureAgentSettings(env[AGENT_DIR_ENV]);
   if (settings.status === "failed") {
-    process.stderr.write(`explyt: engine settings not seeded: ${settings.detail}\n`);
+    process.stderr.write(`${BRAND.command}: engine settings not seeded: ${settings.detail}\n`);
   }
   // The web tools' configuration (spec 015, RQ-14): before the engine, which fixes its path on load.
   seedWebSearchConfig(env[AGENT_DIR_ENV], warnOnStderr);
@@ -291,13 +296,15 @@ if (wantsTui || wantsLogin) {
 //   1. the candidate paths inside this package root -- the backend and debug trees:
 //        backend artifact: dist/cli/index.js  ->  dist/acp/index.js
 //        dev source:       cli/index.mjs      ->  vendor/pi-acp/dist/index.js
-//   2. an installed release npm produced from `@explyt/acp-adapter`:
-//        hoisted  <modules>/@explyt/acp-adapter next to <modules>/@explyt/ai-agent
+//   2. an installed release npm produced from the brand's adapter package:
+//        hoisted  <modules>/<scope>/acp-adapter next to <modules>/<scope>/ai-agent
 //        nested   the package whose node_modules holds this CLI
 // Never NODE_PATH, the working directory, PATH, a workspace link or a global prefix:
 // plain Node resolution would honour NODE_PATH and would follow this checkout's
 // workspace link to the unobfuscated submodule.
-const ADAPTER_PACKAGE = "@explyt/acp-adapter";
+const ADAPTER_PACKAGE = BRAND.adapterPackage;
+/** The npm scope both brand packages live in (`@<brand>`), and the adapter's directory name in it. */
+const [ADAPTER_SCOPE, ADAPTER_DIR] = ADAPTER_PACKAGE.split("/");
 
 /** The adapter's `main` entry in `dir`, or null when `dir` is not the adapter package. */
 function adapterMain(dir) {
@@ -324,7 +331,7 @@ function installedReleaseAdapter(root) {
   }
   const scope = dirname(real);
   const modules = dirname(scope);
-  if (basename(scope) !== "@explyt" || basename(modules) !== "node_modules") return null;
+  if (basename(scope) !== ADAPTER_SCOPE || basename(modules) !== "node_modules") return null;
   const accept = (dir) => {
     try {
       // The package directory itself must be real: npm installs packages, a link is a workspace.
@@ -335,7 +342,7 @@ function installedReleaseAdapter(root) {
     return adapterMain(dir);
   };
   // hoisted: a sibling in the same node_modules
-  const hoisted = accept(join(modules, "@explyt", "acp-adapter"));
+  const hoisted = accept(join(modules, ADAPTER_SCOPE, ADAPTER_DIR));
   if (hoisted) return hoisted;
   // nested: the package whose node_modules holds this CLI
   const owner = dirname(modules);
@@ -353,8 +360,8 @@ if (!adapter) {
   // What an old IDE entry, or a terminal-only install, runs (RQ-27).
   fail(
     "no ACP adapter is installed next to this package.\n" +
-    "  IDE integration is set up by the Explyt installer, which installs the adapter\n" +
-    "  together with this CLI; the Neo plugin runs it for you. See `explyt --help`.",
+    `  IDE integration is set up by the ${BRAND.developer} installer, which installs the adapter\n` +
+    `  together with this CLI; the Neo plugin runs it for you. See \`${BRAND.command} --help\`.`,
   );
 }
 
@@ -370,7 +377,7 @@ const engine = await requireEngine();
 // value inherited from an unrelated session must not mask a broken install (RQ-6, RQ-50).
 const explicitEngineCommand = process.env.PI_ACP_PI_COMMAND;
 if (!engine.binDir && !(explicitEngineCommand && existsSync(explicitEngineCommand))) {
-  fail(`the agent engine's pi bin is missing (looked for node_modules/.bin/pi next to ${engine.engineDir}); reinstall with the Explyt installer`);
+  fail(`the agent engine's pi bin is missing (looked for node_modules/.bin/pi next to ${engine.engineDir}); reinstall with the ${BRAND.developer} installer`);
 }
 // Exactly one PATH key (RQ-6): the engine's `.bin` first, then this Node's directory, so
 // the engine's `#!/usr/bin/env node` finds the same Node even when the caller's PATH has

package/dist/cli/install-auto.js

@@ -7,6 +7,10 @@
 import { openSync, readFileSync } from "node:fs";
 import { join, sep } from "node:path";
 import { isOffline } from "./update.js";
+import { BRAND } from "./brand-profile.js";
+
+/** The npm scope and directory of the brand's CLI package (`@<scope>/ai-agent`). */
+const [CLI_SCOPE, CLI_DIR] = BRAND.cliPackage.split("/");
 
 export const AUTO_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
 export const AUTO_CHECK_BACKOFF_MS = 60 * 60 * 1000;
@@ -17,7 +21,7 @@ export function managedRelease(packageRoot) {
   const parts = packageRoot.split(/[\\/]/);
   const n = parts.length;
   if (n < 7) return null;
-  if (parts[n - 1] !== "ai-agent" || parts[n - 2] !== "@explyt" || parts[n - 3] !== "node_modules") return null;
+  if (parts[n - 1] !== CLI_DIR || parts[n - 2] !== CLI_SCOPE || parts[n - 3] !== "node_modules") return null;
   if (parts[n - 5] !== "releases" || parts[n - 6] !== "install") return null;
   const release = parts[n - 4];
   if (!release || release.startsWith(".")) return null;
@@ -49,7 +53,7 @@ function samePair(a, b) {
 }
 
 export function updateNoticeText(resolved) {
-  return `Explyt AI Agent ${resolved.cliVersion} is available. Install it with the Explyt installer (explyt install).`;
+  return `${BRAND.productName} ${resolved.cliVersion} is available. Install it with the ${BRAND.developer} installer (${BRAND.command} install).`;
 }
 
 /**
@@ -90,7 +94,7 @@ export async function autoUpdate({ packageRoot, env = process.env, now = Date.no
   return "installer";
 }
 
-/** The detached `explyt install --json` a TUI starts (RQ-33). */
+/** The detached `<command> install --json` a TUI starts (RQ-33). */
 export function installerCommand({ root, platform = process.platform }) {
   const install = join(root, "install");
   const file = readFileSync(join(install, "node.txt"), "utf8").trim();
@@ -105,7 +109,7 @@ export function installerCommand({ root, platform = process.platform }) {
 /** The restart notice (RQ-34), or null when the TUI runs the current release. */
 export function restartNotice({ running, current }) {
   if (!running || !current || running.release === current.release) return null;
-  return `Explyt AI Agent ${current.cliVersion} is installed. Restart with explyt --continue to resume this session on it.`;
+  return `${BRAND.productName} ${current.cliVersion} is installed. Restart with ${BRAND.command} --continue to resume this session on it.`;
 }
 
 /**

package/dist/cli/install-cleanup.js

@@ -9,6 +9,7 @@ import { join } from "node:path";
 import { randomBytes } from "node:crypto";
 import { isLive } from "./install-lock.js";
 import { withFileRetry } from "./install-file-retry.js";
+import { BRAND } from "./brand-profile.js";
 
 export { withFileRetry };
 
@@ -49,7 +50,7 @@ export function readLeases(root, release) {
 
 /** The Node version an installed release's CLI manifest names (`explyt.node`). */
 export function releaseNodeVersion(releaseDir) {
-  const manifest = readJson(join(releaseDir, "node_modules", "@explyt", "ai-agent", "package.json"));
+  const manifest = readJson(join(releaseDir, "node_modules", ...BRAND.cliPackage.split("/"), "package.json"));
   const node = manifest?.explyt?.node;
   return typeof node === "string" ? node : null;
 }

package/dist/cli/install-command.js

@@ -1,14 +1,18 @@
 // The terminal command and its PATH entry (spec 019, RQ-35, RQ-7).
 //
-// `~/.local/bin/explyt` (POSIX sh) or `%USERPROFILE%\.local\bin\explyt.cmd` runs the Node of
+// `~/.local/bin/<command>` (POSIX sh) or `%USERPROFILE%\.local\bin\<command>.cmd` runs the Node of
 // `install/node.txt` with `install/launch.js`. Its content depends only on the installation
 // root, so a switch never rewrites a command a running shell or cmd is reading.
 import { existsSync, mkdirSync, readFileSync, renameSync, chmodSync, writeFileSync, rmSync } from "node:fs";
 import { dirname, posix, win32 } from "node:path";
 import { randomBytes } from "node:crypto";
+import { BRAND } from "./brand-profile.js";
 import { PRODUCT_NAME } from "./package-name.js";
 
-export const COMMAND_MARKER = `${PRODUCT_NAME} terminal command, managed by the Explyt installer`;
+/** The brand's command name (spec #344, RQ-6); the shell variable below is named after it too. */
+const CMD = BRAND.command;
+
+export const COMMAND_MARKER = `${PRODUCT_NAME} terminal command, managed by the ${BRAND.developer} installer`;
 export const PATH_LINE = 'export PATH="$HOME/.local/bin:$PATH"';
 
 function pathApi(platform) {
@@ -17,7 +21,7 @@ function pathApi(platform) {
 
 export function commandPath({ home, platform = process.platform }) {
   const p = pathApi(platform);
-  return p.join(home, ".local", "bin", platform === "win32" ? "explyt.cmd" : "explyt");
+  return p.join(home, ".local", "bin", platform === "win32" ? `${CMD}.cmd` : CMD);
 }
 
 function shQuote(text) {
@@ -44,10 +48,10 @@ export function terminalCommand({ root, platform = process.platform }) {
     "#!/bin/sh",
     `# ${COMMAND_MARKER}`,
     `install_dir=${shQuote(install)}`,
-    'IFS= read -r explyt_node < "$install_dir/node.txt" || { echo "explyt: $install_dir/node.txt is missing; run the Explyt installer" >&2; exit 1; }',
-    'PATH="$(dirname "$explyt_node"):$PATH"',
+    `IFS= read -r ${CMD}_node < "$install_dir/node.txt" || { echo "${CMD}: $install_dir/node.txt is missing; run the ${BRAND.developer} installer" >&2; exit 1; }`,
+    `PATH="$(dirname "$${CMD}_node"):$PATH"`,
     "export PATH",
-    'exec "$explyt_node" "$install_dir/launch.js" "$@"',
+    `exec "$${CMD}_node" "$install_dir/launch.js" "$@"`,
     "",
   ].join("\n");
 }
@@ -120,10 +124,10 @@ export async function ensureCommandOnPath({ home, env = process.env, platform =
   return { pathInstruction: null, warnings: [] };
 }
 
-/** An earlier `explyt` on PATH than the managed command, or null. */
+/** An earlier brand command on PATH than the managed command, or null. */
 export function findShadowing({ env = process.env, platform = process.platform, commandFile, exists = existsSync }) {
   const p = pathApi(platform);
-  const names = platform === "win32" ? ["explyt.cmd", "explyt.exe", "explyt.bat", "explyt.ps1", "explyt"] : ["explyt"];
+  const names = platform === "win32" ? [`${CMD}.cmd`, `${CMD}.exe`, `${CMD}.bat`, `${CMD}.ps1`, CMD] : [CMD];
   for (const entry of pathEntries(env, platform)) {
     for (const name of names) {
       const candidate = p.join(entry, name);