mirror-mind 0.35.0 → 0.36.0

package/ts/src/runtime/wiring.ts

@@ -29,6 +29,18 @@
 //               the shipped wrapper.
 //   Antigravity `agy plugin install <plugin dir>` stages the plugin with its
 //               agy-native layer in one step (CV21.DS7.US1, agy 1.4.2).
+//   Grok Build  `grok plugin install <plugin dir> --trust` copies the plugin
+//               under `~/.grok/installed-plugins/` and enables it: its skills,
+//               the hooks, and the MCP server, with no prompt left to answer
+//               (CV21.DS10.US1, probed on grok 1.0.62). Then a link under
+//               `~/.grok/rules/` carries the Operating Instructions as a rule
+//               Grok loads in every project (~2.2k tokens by Grok's count):
+//               Grok shows a SessionStart hook's context on screen only and
+//               ignores a prompt hook's (DS12.TS4 L2/L3), so the plugin's
+//               session-start delivery of D13 does not reach its model. Two
+//               steps. The shapes not chosen -- the Claude link alone (skills,
+//               no hooks), a link in `~/.grok/plugins/` (loads nothing until
+//               a config entry is hand-written) -- are in decisions.md.
 //
 // Gemini CLI had an entry here (a skills link, then four hooks merged into
 // `~/.gemini/settings.json` by absolute path) until CV21.DS8.US1 retired the
@@ -37,7 +49,7 @@
 import { join } from "node:path";
 import { commandOnPath } from "#util/paths.ts";
 
-export type RuntimeName = "pi" | "claude" | "codex" | "antigravity";
+export type RuntimeName = "pi" | "claude" | "codex" | "antigravity" | "grok";
 
 /**
  * The one Codex level-up command (CV21.DS4.TS6). Codex 0.163.0 has no
@@ -48,6 +60,29 @@ export type RuntimeName = "pi" | "claude" | "codex" | "antigravity";
  */
 export const CODEX_PLUGIN_ADD_COMMAND = "codex plugin add mirror-mind@mirror-mind";
 
+/** Where the plugin directory lives below an installed package. */
+export function pluginDirectory(root: string): string {
+  return join(root, "plugins/mirror-mind");
+}
+
+/**
+ * The one Grok level-up command (CV21.DS10.US1). Grok copies a local-path
+ * plugin and keys the copy by the path STRING: `grok plugin update` is a
+ * no-op for it (it answers "local symlink, already live" over a real copy,
+ * grok 1.0.62), an install over the same string is refused as already
+ * installed, and a differently spelt string installs a second copy beside
+ * the first. So the level-up is uninstall, then install with the path `init`
+ * printed -- a function of the root, so `diagnose` and `update` cannot spell
+ * it differently (the CR071 lesson at the string level).
+ */
+export function grokPluginReinstallCommand(root: string): string {
+  return `grok plugin uninstall mirror-mind --confirm && ${grokPluginInstallCommand(root)}`;
+}
+
+function grokPluginInstallCommand(root: string): string {
+  return `grok plugin install "${pluginDirectory(root)}" --trust`;
+}
+
 export interface RuntimeWiring {
   /** The runtime, as a person names it. */
   readonly title: string;
@@ -67,8 +102,11 @@ export const RUNTIME_WIRING: Readonly<Record<RuntimeName, RuntimeWiring>> = {
     title: "Claude Code",
     command: "claude",
     steps: [
+      // `mkdir -p` first: a home that has never held a personal skill has no
+      // ~/.claude/skills/ yet, and the link alone fails there (CV21.DS5.US2's
+      // route, on the extensions plugin's step; the same line, paid here).
       (root) => [
-        `ln -s "${join(root, "plugins/mirror-mind")}" ~/.claude/skills/mirror-mind`,
+        `mkdir -p ~/.claude/skills && ln -s "${pluginDirectory(root)}" ~/.claude/skills/mirror-mind`,
         "(the plugin loads every session: its skills, the hooks, and the MCP server)",
       ],
     ],
@@ -86,6 +124,29 @@ export const RUNTIME_WIRING: Readonly<Record<RuntimeName, RuntimeWiring>> = {
       (root) => [`agy plugin install "${root}/plugins/mirror-mind"`],
     ],
   },
+  grok: {
+    title: "Grok Build",
+    command: "grok",
+    steps: [
+      // CV21.DS10.US1, probed on grok 1.0.62: one command copies the plugin
+      // and enables it. Consent lives in the line: what --trust activates,
+      // and that Grok asks nothing afterwards (Codex's note says Codex asks
+      // once; Grok's must say it does not).
+      (root) => [
+        grokPluginInstallCommand(root),
+        "(--trust activates the plugin's hooks and MCP server, and Grok does not ask again;",
+        "Grok keeps a copy of the plugin, so after an update `mirror runtime diagnose`",
+        "names the command that brings it level)",
+      ],
+      // The Operating Instructions (D13) as a home-level rule. Grok loads
+      // every *.md under ~/.grok/rules/ in every project, link or file.
+      (root) => [
+        `ln -s "${join(root, "AGENTS.md")}" ~/.grok/rules/mirror-mind.md`,
+        "(the Operating Instructions, loaded as a rule in every Grok session, in",
+        "every project: about 2.2k tokens per session)",
+      ],
+    ],
+  },
   codex: {
     title: "Codex",
     command: "codex",
@@ -100,7 +161,7 @@ export const RUNTIME_WIRING: Readonly<Record<RuntimeName, RuntimeWiring>> = {
   },
 };
 
-const ORDER: readonly RuntimeName[] = ["pi", "claude", "codex", "antigravity"];
+const ORDER: readonly RuntimeName[] = ["pi", "claude", "codex", "antigravity", "grok"];
 
 /** The runtimes whose command is on the PATH, in display order. */
 export function detectRuntimes(
@@ -124,3 +185,74 @@ export function runtimeWiringLines(runtime: RuntimeName, root: string): string[]
   });
   return lines;
 }
+
+// ---------------------------------------------------------------------------
+// The per-home extensions plugin (CV21.DS5.US2). A Mirror home's installed
+// extensions reach the four plugin runtimes as one generated plugin per home,
+// `<home>/runtime/plugin/mirror-ext-<user>/`, in the canonical plugin's format
+// but carrying skills only (DS5.TS1's decision). Each runtime takes it the way
+// it takes the canonical plugin, and the three that copy it (Codex, agy, Grok)
+// need one command per change to bring the copy level — measured in TS1.
+// `mirror init` prints none of this: at init there is no extension. The
+// `extensions` verbs print the step a runtime still needs, and `runtime
+// diagnose` names the reinstall for a stale copy. Printing is not automating.
+
+export interface ExtensionPluginPaths {
+  /** The plugin directory: linked by Claude Code, installed by agy and Grok. */
+  readonly dir: string;
+  /** The marketplace root Codex adds: the plugin's parent, carrying `.agents/plugins/marketplace.json`. */
+  readonly marketplace: string;
+  /** `mirror-ext-<user>`: the plugin's name and its marketplace's. */
+  readonly name: string;
+}
+
+/** The consent line printed under Grok's step: what `--trust` would activate here, which is nothing. */
+export const EXTENSION_PLUGIN_GROK_TRUST_NOTE =
+  "(this plugin carries skills only — no hooks and no MCP server for --trust to activate)";
+
+/** The one-time wiring per runtime; Pi takes extensions through its own catalog and needs none. */
+export function extensionPluginWiringSteps(
+  runtime: RuntimeName,
+  paths: ExtensionPluginPaths,
+): string[] {
+  switch (runtime) {
+    case "claude":
+      // `mkdir -p` first: a home that has never held a personal skill has no
+      // ~/.claude/skills/ yet, and the link alone fails there (measured, US2's route).
+      return [`mkdir -p ~/.claude/skills && ln -s "${paths.dir}" ~/.claude/skills/${paths.name}`];
+    case "codex":
+      return [
+        `codex plugin marketplace add "${paths.marketplace}"`,
+        `codex plugin add ${paths.name}@${paths.name}`,
+      ];
+    case "antigravity":
+      return [`agy plugin install "${paths.dir}"`];
+    case "grok":
+      return [`grok plugin install "${paths.dir}" --trust`];
+    case "pi":
+      return [];
+  }
+}
+
+/**
+ * What brings a runtime's copy level after the plugin changed, measured in
+ * DS5.TS1: Codex re-adds at the same version when the marketplace serves the
+ * live directory; agy installs again; Grok refuses an install over the same
+ * path and must uninstall first. Claude Code links and has no copy.
+ */
+export function extensionPluginReinstallCommand(
+  runtime: RuntimeName,
+  paths: ExtensionPluginPaths,
+): string | null {
+  switch (runtime) {
+    case "claude":
+    case "pi":
+      return null;
+    case "codex":
+      return `codex plugin add ${paths.name}@${paths.name}`;
+    case "antigravity":
+      return `agy plugin install "${paths.dir}"`;
+    case "grok":
+      return `grok plugin uninstall ${paths.name} --confirm && grok plugin install "${paths.dir}" --trust`;
+  }
+}