@uniqbit/mate-core 0.15.4-canary.0 → 0.15.4-canary.11

package/claude-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,4 @@
+{
+  "name": "mate",
+  "description": "Mate-managed Claude Code hooks: artifact-path guardrail, session banner, and the OpenSpec archive-finish nudge. Ships inside @uniqbit/mate-core and is loaded per managed launch via --plugin-dir; it is never published separately."
+}

package/claude-plugin/hooks/artifact-finish-nudge.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Thin shim: hook logic lives in src/hooks/artifact-finish-nudge.ts, loaded
+// through ts-loader.mjs because the installed plugin sits inside node_modules
+// where node's native type stripping is disabled.
+import "./ts-loader.mjs";
+
+const { run } = await import("../../src/hooks/artifact-finish-nudge.ts");
+process.exitCode = await run();

package/claude-plugin/hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "description": "Mate hooks — PreToolUse artifact-path guardrail, SessionStart banner, PostToolUse OpenSpec archive-finish nudge (self-gated at runtime)",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/validate-artifact-path.mjs\""
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-banner.mjs\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/artifact-finish-nudge.mjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/claude-plugin/hooks/session-banner.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Thin shim: hook logic lives in src/hooks/session-banner.ts, loaded through
+// ts-loader.mjs because the installed plugin sits inside node_modules where
+// node's native type stripping is disabled.
+import "./ts-loader.mjs";
+
+const { run } = await import("../../src/hooks/session-banner.ts");
+process.exitCode = run();

package/claude-plugin/hooks/ts-loader.mjs

@@ -0,0 +1,28 @@
+// Synchronous module loader that strips TypeScript types itself. Node's
+// built-in .ts loading refuses files under node_modules
+// (ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING), which is exactly where the
+// published plugin lives — so the hook shims register this loader before
+// importing their src/hooks/*.ts implementation.
+import fs from "node:fs";
+import { registerHooks, stripTypeScriptTypes } from "node:module";
+import { fileURLToPath } from "node:url";
+
+// stripTypeScriptTypes emits an ExperimentalWarning; hooks must keep stderr
+// clean because Claude Code surfaces it to the user on non-zero exits.
+const emitWarning = process.emitWarning;
+process.emitWarning = (warning, ...args) => {
+  if (String(warning).includes("stripTypeScriptTypes")) return;
+  emitWarning.call(process, warning, ...args);
+};
+
+registerHooks({
+  load(url, context, next) {
+    if (!url.endsWith(".ts")) return next(url, context);
+    const source = fs.readFileSync(fileURLToPath(url), "utf8");
+    return {
+      format: "module",
+      source: stripTypeScriptTypes(source),
+      shortCircuit: true,
+    };
+  },
+});

package/claude-plugin/hooks/validate-artifact-path.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Thin shim: hook logic lives in src/hooks/validate-artifact-path.ts, loaded
+// through ts-loader.mjs because the installed plugin sits inside node_modules
+// where node's native type stripping is disabled.
+import "./ts-loader.mjs";
+
+const { run } = await import("../../src/hooks/validate-artifact-path.ts");
+process.exitCode = await run();

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@uniqbit/mate-core",
-  "version": "0.15.4-canary.0",
+  "version": "0.15.4-canary.11",
   "description": "Core framework and plugin APIs for Mate.",
   "license": "MIT",
   "files": [
     "src/",
     "wrappers/",
+    "claude-plugin/",
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx"
   ],
@@ -14,7 +15,8 @@
     ".": "./src/index.ts",
     "./plugins": "./src/plugins.ts",
     "./runtime": "./src/runtime/index.ts",
-    "./opencode": "./src/opencode/index.ts"
+    "./opencode": "./src/opencode/index.ts",
+    "./tui": "./src/tui.ts"
   },
   "publishConfig": {
     "access": "public",

package/src/cli/commands/artifact/finish/openspec.ts

@@ -61,10 +61,7 @@ async function capSync(context: FinishContext): Promise<boolean> {
   const previous = process.exitCode;
   process.exitCode = 0;
   const previousEnv = new Map(
-    ["MATE_ARTIFACT_PATH", "MATE_REPO_PATH", "MATE_REPO_ID", "MATE_REPO_PROFILE"].map((key) => [
-      key,
-      process.env[key],
-    ]),
+    ["MATE_ARTIFACT_PATH", "MATE_REPO_PATH", "MATE_REPO_ID"].map((key) => [key, process.env[key]]),
   );
 
   // Pass both sides of the companion/working-repo boundary explicitly. Capability
@@ -73,7 +70,6 @@ async function capSync(context: FinishContext): Promise<boolean> {
   if (context.repository) {
     process.env.MATE_REPO_PATH = context.repository.path;
     process.env.MATE_REPO_ID = context.repository.id;
-    process.env.MATE_REPO_PROFILE = context.repository.profile;
   }
   try {
     await runIndexCapCommand([]);

package/src/cli/commands/cap/openspec.ts

@@ -79,7 +79,26 @@ export async function runOpenspecCapCommand(
     readOpenSpecProjectSchema(companionPath),
   );
 
-  const result = spawnSync("openspec", forwardedArgs, { cwd, stdio: "inherit" });
+  if (forwardedArgs[0] === "init" || forwardedArgs[0] === "update") {
+    const reset = spawnSync("openspec", ["config", "reset", "--all", "-y"], {
+      cwd,
+      stdio: "inherit",
+    });
+    if (reset.error) {
+      process.stderr.write(`Failed to reset openspec config: ${reset.error.message}\n`);
+      process.exitCode = 1;
+      return;
+    }
+    if (reset.status !== 0) {
+      process.exitCode = reset.status ?? 1;
+      return;
+    }
+  }
+
+  const result = spawnSync("openspec", forwardedArgs, {
+    cwd,
+    stdio: "inherit",
+  });
   if (result.error) {
     process.stderr.write(`Failed to run openspec: ${result.error.message}\n`);
     process.exitCode = 1;

package/src/cli/commands/companion/hub.ts

@@ -0,0 +1,100 @@
+import readline from "node:readline/promises";
+
+import {
+  addHubMember,
+  discoverHubSource,
+  initializeCompanionHub,
+  syncHub,
+  updateHubPlugins,
+} from "../../../lib/orchestrator/companion-hub";
+import { GlobalConfigStore } from "../../../lib/orchestrator/global-config-store";
+
+function positionalArgs(argv: string[]): string[] {
+  const values: string[] = [];
+  const valueFlags = new Set(["id", "path", "url", "companion", "ref"]);
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index]!;
+    if (!value.startsWith("--")) {
+      values.push(value);
+      continue;
+    }
+    if (valueFlags.has(value.slice(2))) index += 1;
+  }
+  return values;
+}
+
+function flagValue(argv: string[], name: string): string | undefined {
+  const index = argv.indexOf(`--${name}`);
+  return index >= 0 ? argv[index + 1] : undefined;
+}
+
+async function selectRegisteredCompanion(): Promise<string> {
+  const companions = await new GlobalConfigStore().list();
+  if (companions.length === 0) throw new Error("No registered companions are available.");
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("hub add requires a source path or Git URL outside a TTY.");
+  }
+  const prompt = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log("Registered companions:");
+    companions.forEach((candidate, index) => console.log(`  ${index + 1}. ${candidate}`));
+    const answer = await prompt.question("Select a companion: ");
+    const selected = companions[Number.parseInt(answer, 10) - 1];
+    if (!selected) throw new Error("Invalid companion selection.");
+    return selected;
+  } finally {
+    prompt.close();
+  }
+}
+
+async function runHubInit(argv: string[]): Promise<void> {
+  const folder = positionalArgs(argv)[0] ?? process.cwd();
+  const hubPath = await initializeCompanionHub(folder);
+  await updateHubPlugins(hubPath);
+  console.log(`Initialized companion hub: ${hubPath}`);
+}
+
+async function runHubAdd(argv: string[]): Promise<void> {
+  const sourceArg =
+    positionalArgs(argv)[0] ?? flagValue(argv, "url") ?? flagValue(argv, "companion");
+  const source = discoverHubSource(sourceArg ?? (await selectRegisteredCompanion()));
+  const ref = flagValue(argv, "ref");
+  if (ref && source.kind === "git") source.ref = ref;
+  const member = await addHubMember(process.cwd(), source, {
+    id: flagValue(argv, "id"),
+    memberPath: flagValue(argv, "path"),
+  });
+  console.log(`Added hub member ${member.id}: ${member.path}`);
+}
+
+async function runHubSync(argv: string[]): Promise<void> {
+  const results = await syncHub(process.cwd());
+  const plugins = await updateHubPlugins(process.cwd());
+  if (argv.includes("--json")) {
+    console.log(JSON.stringify({ companions: results, plugins }));
+    return;
+  }
+  for (const result of results) console.log(`${result.id}: ${result.status} (${result.message})`);
+  for (const plugin of plugins) {
+    const detail = plugin.status === "failed" ? `: ${plugin.error ?? "failed"}` : "";
+    console.log(`hub plugin ${plugin.package}: ${plugin.status}${detail}`);
+  }
+  if (plugins.some((plugin) => plugin.status === "failed")) process.exitCode = 1;
+}
+
+export async function runHubCommand(argv: string[]): Promise<void> {
+  const [subcommand, ...rest] = argv;
+  switch (subcommand) {
+    case "init":
+      await runHubInit(rest);
+      return;
+    case "add":
+      await runHubAdd(rest);
+      return;
+    case "sync":
+      await runHubSync(rest);
+      return;
+    default:
+      throw new Error("Usage: mate hub <init|add|sync>");
+  }
+}

package/src/cli/commands/companion/link.ts

@@ -10,7 +10,6 @@ import {
   type CompanionLinkWizardOptions,
 } from "../../companion-link-wizard";
 import { extractRepoName } from "../artifact/extract-repo-name";
-import { defaultConfig } from "../../../lib/orchestrator/config-store";
 import { GlobalConfigStore } from "../../../lib/orchestrator/global-config-store";
 import { CompanionResolver } from "../../../lib/orchestrator/companion-resolver";
 import { inspectSetupPreflight } from "../../../lib/orchestrator/setup-preflight";
@@ -131,7 +130,6 @@ export async function runCompanionLinkCommandWithDeps(
 
   const cwd = path.resolve(process.cwd());
   const existingMatch = await resolveCompanion(cwd);
-  const profiles = Object.keys(defaultConfig().profiles);
   const companionsDir = companionsHomeDir();
   const candidatePaths = new Set(await listCompanions());
   if (existingMatch) candidatePaths.add(existingMatch.companionPath);
@@ -148,7 +146,6 @@ export async function runCompanionLinkCommandWithDeps(
   ).filter((candidate): candidate is string => candidate !== null);
 
   const inputs = await selectInputs({
-    profiles,
     existingCompanions,
   });
   if (!inputs) {
@@ -241,7 +238,6 @@ export async function runCompanionLinkCommandWithDeps(
   const repository: LinkedRepository = {
     id: path.basename(cwd),
     path: cwd,
-    profile: inputs.profile,
   };
 
   const registerRepository =
@@ -292,6 +288,5 @@ export async function runCompanionLinkCommandWithDeps(
     console.log(`  Companion: ${companionPath}`);
   }
   console.log(`  Source: ${persistedSource}`);
-  console.log(`  Profile: ${repository.profile}`);
   console.log("  Workspace: run `mate companion open` to open the workspace in your editor");
 }

package/src/cli/commands/companion/tui.ts

@@ -2,12 +2,14 @@ import { spawn } from "node:child_process";
 import { accessSync } from "node:fs";
 
 import { getActiveDistribution } from "../../../distribution";
+import { FRAMEWORK_NAME } from "../../../framework";
 import { resolveFrameworkContext } from "../../../lib/orchestrator/framework-context";
 import { findRepoLocalLinkedRepository } from "../../../lib/orchestrator/repo-local-registry";
 import { ensureUnambiguousCompanion } from "../launch/shared";
 
 export function renderBanner(repoPath: string, companionPath: string): string {
-  const { name, version } = getActiveDistribution().config;
+  const { version } = getActiveDistribution().config;
+  const name = FRAMEWORK_NAME;
   const lines = [`${name} v${version}`, "", `repo: ${repoPath}`, `${name}: ${companionPath}`];
   const contentWidth = Math.max(...lines.map((l) => l.length));
   const pad = (text: string) => `│ ${text.padEnd(contentWidth)} │`;
@@ -79,7 +81,6 @@ export async function runCompanionTuiCommand(): Promise<void> {
   if (repository) {
     process.env.MATE_REPO_PATH = repository.path;
     process.env.MATE_REPO_ID = repository.id;
-    process.env.MATE_REPO_PROFILE = repository.profile;
   }
 
   console.log(renderBanner(repoPath, companionPath));