@uniqbit/mate-opencode-plugin 0.15.0-canary.0 → 0.15.0-canary.10

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uniqbit/mate-opencode-plugin",
-  "version": "0.15.0-canary.0",
-  "description": "Mate OpenCode runtime plugins: aggregate regular plugin (./server) and TUI plugin (./tui).",
+  "version": "0.15.0-canary.10",
+  "description": "OpenCode plugin integration for Mate.",
   "license": "MIT",
   "files": [
     "src/",
@@ -28,7 +28,7 @@
     "@opentui/core": "^0.4.5",
     "@opentui/keymap": "^0.4.5",
     "@opentui/solid": "^0.4.5",
-    "@uniqbit/mate-core": "0.15.0-canary.0"
+    "@uniqbit/mate-core": "0.15.0-canary.10"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14"

package/src/companion.ts

@@ -2,9 +2,9 @@ import path from "node:path";
 
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin";
-import { MATE_ENV, parseGuidanceContent, type MateGuidanceFile } from "@uniqbit/mate-core";
+import { MATE_ENV, parseGuidanceContent, type MateGuidanceFile } from "@uniqbit/mate-core/runtime";
 
-import { readContext, type CompanionContext } from "./companion-policy";
+import { readContext, type CompanionContext } from "@uniqbit/mate-core/opencode";
 
 function prependPathEntry(pathValue: string | undefined, entry: string): string {
   const entries = (pathValue ?? "").split(path.delimiter).filter(Boolean);

package/src/server.ts

@@ -2,7 +2,7 @@
 import type { Hooks, Plugin, PluginInput } from "@opencode-ai/plugin";
 
 import { AddDirPlugin } from "./add-dir";
-import { CompanionHooksPlugin } from "./companion-hooks";
+import { CompanionHooksPlugin } from "@uniqbit/mate-core/opencode";
 import { CompanionPlugin } from "./companion";
 
 // Compose the implementation modules in the execution order the previously

package/src/tui.tsx

@@ -1,73 +1 @@
-/** @jsxImportSource @opentui/solid */
-/* oxlint-disable react/no-unknown-property, react/react-in-jsx-scope */
-import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui";
-
-import { readContext } from "./companion-policy";
-
-const MIDNIGHT_PURPLE_BRIGHT = "#c084fc";
-const NARROW_TERMINAL_WIDTH = 80;
-const MATE_VERSION = process.env.MATE_VERSION ?? "unknown";
-
-function SessionContext({
-  api,
-  compact = false,
-  sidebar = false,
-}: {
-  api: TuiPluginApi;
-  compact?: boolean;
-  sidebar?: boolean;
-}) {
-  const context = readContext(process.env.MATE_ARTIFACT_PATH ?? "");
-  const theme = api.theme.current;
-
-  if (compact) {
-    return (
-      <box width="100%" paddingTop={0} flexShrink={0}>
-        <text fg={theme.textMuted}>
-          mate v{MATE_VERSION} | repo: {context.repositoryPath} | mate: {context.companionPath}
-        </text>
-      </box>
-    );
-  }
-
-  return (
-    <box width="100%" maxWidth={75} paddingTop={sidebar ? 0 : 2} paddingBottom={1} flexShrink={0}>
-      <text fg={MIDNIGHT_PURPLE_BRIGHT}>mate v{MATE_VERSION}</text>
-      <text fg={theme.textMuted}>repo: {context.repositoryPath}</text>
-      <text fg={theme.textMuted}>mate: {context.companionPath}</text>
-    </box>
-  );
-}
-
-const tui: TuiPlugin = async (api) => {
-  const context = readContext(process.env.MATE_ARTIFACT_PATH ?? "");
-  if (!context.companionPath || !context.repositoryPath) {
-    return;
-  }
-
-  api.slots.register({
-    order: 0,
-    slots: {
-      home_bottom() {
-        return <SessionContext api={api} />;
-      },
-      sidebar_content() {
-        return <SessionContext api={api} sidebar />;
-      },
-      app_bottom() {
-        if (api.renderer.width >= NARROW_TERMINAL_WIDTH || api.route.current.name !== "session") {
-          return null;
-        }
-
-        return <SessionContext api={api} compact />;
-      },
-    },
-  });
-};
-
-const plugin: TuiPluginModule & { id: string } = {
-  id: "mate-companion-tui",
-  tui,
-};
-
-export default plugin;
+export { tuiPlugin as default } from "@uniqbit/mate-core/opencode";

package/src/companion-hooks.ts

@@ -1,370 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-import type { Hooks, Plugin, PluginInput } from "@opencode-ai/plugin";
-
-import {
-  buildArtifactError,
-  extractPatchPaths,
-  readContext,
-  shouldBlockArtifactWrite,
-  type CompanionContext,
-} from "./companion-policy";
-
-const ARCHIVE_ENTRY_PATTERN = /^\d{4}-\d{2}-\d{2}-.+$/;
-const ARCHIVE_PATH_PATTERN =
-  /(?:^|[\s/"'`,(])openspec\/changes\/archive\/(\d{4}-\d{2}-\d{2}-[^/\s"'`,)]+)/;
-
-function readArchiveEntries(archiveDir: string): Set<string> {
-  try {
-    return new Set(
-      fs
-        .readdirSync(archiveDir, { withFileTypes: true })
-        .filter((entry) => entry.isDirectory() && ARCHIVE_ENTRY_PATTERN.test(entry.name))
-        .map((entry) => entry.name),
-    );
-  } catch {
-    return new Set();
-  }
-}
-
-function shellSplit(command: string): string[] {
-  const parts: string[] = [];
-  let current = "";
-  let quote: "'" | '"' | null = null;
-  let escaping = false;
-
-  for (let index = 0; index < command.length; index += 1) {
-    const char = command[index];
-    if (escaping) {
-      current += char;
-      escaping = false;
-      continue;
-    }
-    if (char === "\\" && quote !== "'") {
-      const next = command[index + 1] ?? "";
-      if (/^[\\\s'"]$/.test(next)) {
-        escaping = true;
-        continue;
-      }
-      current += char;
-      continue;
-    }
-    if ((char === "'" || char === '"') && !quote) {
-      quote = char;
-      continue;
-    }
-    if (quote === char) {
-      quote = null;
-      continue;
-    }
-    if (!quote && /\s/.test(char)) {
-      if (current) {
-        parts.push(current);
-        current = "";
-      }
-      continue;
-    }
-    current += char;
-  }
-
-  if (current) parts.push(current);
-  return parts;
-}
-
-function extractArchivedChangeFromPath(value: string): string | null {
-  const normalized = value.replace(/\\/g, "/");
-  const match = normalized.match(ARCHIVE_PATH_PATTERN);
-  return match ? match[1].replace(/^\d{4}-\d{2}-\d{2}-/, "") : null;
-}
-
-function extractArchiveCommandChange(command: string): string | null {
-  const parts = shellSplit(command);
-  const archiveIndex = parts.findIndex(
-    (part, index) =>
-      part === "archive" &&
-      index > 0 &&
-      (parts[index - 1] === "openspec" || parts[index - 1].endsWith("/openspec")),
-  );
-  if (archiveIndex < 0) return null;
-
-  for (let index = archiveIndex + 1; index < parts.length; index += 1) {
-    const part = parts[index];
-    if (!part || part === "--") continue;
-    if (part.startsWith("-")) {
-      if (part === "--store") index += 1;
-      continue;
-    }
-    return part;
-  }
-  return null;
-}
-
-function extractMoveArchiveChange(commandText: string): string | null {
-  const parts = shellSplit(commandText);
-  const moveCommands = new Set([
-    "mv",
-    "move",
-    "move-item",
-    "cmd",
-    "cmd.exe",
-    "powershell",
-    "powershell.exe",
-    "pwsh",
-    "pwsh.exe",
-  ]);
-  const isPython = (part: string) =>
-    /^python(?:\d(?:\.\d+)*)?(?:\.exe)?$/i.test(part.split(/[\\/]/).pop() ?? part);
-
-  for (let index = 0; index < parts.length; index += 1) {
-    const command = parts[index].toLowerCase();
-    if (moveCommands.has(command)) {
-      for (const part of parts.slice(index + 1)) {
-        const change = extractArchivedChangeFromPath(part);
-        if (change) return change;
-      }
-    }
-    if (isPython(parts[index]) && /(?:shutil\.move|os\.rename|\.rename\s*\()/.test(commandText)) {
-      return extractArchivedChangeFromPath(commandText);
-    }
-  }
-  return null;
-}
-
-function collectCommands(value: unknown): string[] {
-  if (!value || typeof value !== "object") return [];
-  const record = value as Record<string, unknown>;
-  const commands: string[] = [];
-  if (typeof record.command === "string") commands.push(record.command);
-  for (const key of ["args", "tool_input"] as const) {
-    const nested = record[key];
-    if (nested && typeof nested === "object") {
-      const command = (nested as Record<string, unknown>).command;
-      if (typeof command === "string") commands.push(command);
-    }
-  }
-  return commands;
-}
-
-function commandSucceeded(value: unknown): boolean {
-  if (!value || typeof value !== "object") return true;
-  const record = value as Record<string, unknown>;
-  const candidates = [
-    record,
-    record.result,
-    record.output,
-    record.tool_output,
-    record.tool_response,
-  ];
-  for (const candidate of candidates) {
-    if (!candidate || typeof candidate !== "object") continue;
-    const result = candidate as Record<string, unknown>;
-    if (typeof result.success === "boolean") return result.success;
-    for (const key of ["exitCode", "exit_code", "status", "statusCode", "status_code"] as const) {
-      const status = result[key];
-      if (typeof status === "number") return status === 0;
-      if (typeof status === "string" && status.trim()) return Number(status) === 0;
-    }
-  }
-  return true;
-}
-
-function detectCommandArchive(input: unknown, output: unknown): string | null {
-  if (!commandSucceeded(input) || !commandSucceeded(output)) return null;
-  for (const command of [...collectCommands(input), ...collectCommands(output)]) {
-    const change = extractArchiveCommandChange(command) ?? extractMoveArchiveChange(command);
-    if (change) return change;
-  }
-  return null;
-}
-
-function detectNewlyArchivedChanges(archiveDir: string, snapshot: Set<string>): string[] {
-  const current = readArchiveEntries(archiveDir);
-  const newlyArchived = [...current].filter((entry) => !snapshot.has(entry)).toSorted();
-  snapshot.clear();
-  for (const entry of current) snapshot.add(entry);
-  return newlyArchived;
-}
-
-function appendOpenSpecFinishNudge(
-  context: CompanionContext,
-  archiveSnapshot: Set<string>,
-  nudgedCommandChanges: Set<string>,
-  input: { tool?: unknown },
-  output: { output?: string },
-): void {
-  if (!context.gitAutoModeEnabled) return;
-
-  const archiveDir = path.join(context.companionPath, "openspec", "changes", "archive");
-  const changes = detectNewlyArchivedChanges(archiveDir, archiveSnapshot).map((entry) =>
-    entry.slice("YYYY-MM-DD-".length),
-  );
-  const commandChange =
-    String(input.tool ?? "").toLowerCase() === "bash" ? detectCommandArchive(input, output) : null;
-  if (commandChange && !nudgedCommandChanges.has(commandChange)) {
-    changes.push(commandChange);
-    nudgedCommandChanges.add(commandChange);
-  }
-
-  const uniqueChanges = changes.filter((change, index) => changes.indexOf(change) === index);
-  if (uniqueChanges.length === 0) return;
-  const nudges = uniqueChanges.map(
-    (change) =>
-      `ACTION REQUIRED: An openspec change (${change}) was just archived. ` +
-      `Immediately invoke the mate-openspec-artifact-finish skill to complete the finish pipeline ` +
-      "(invoke the CLI as `mate`, never through a companion-local wrapper path or as `" +
-      "$MATE_COMPANION_BIN_PATH/mate`). " +
-      "`mate artifact finish` resumes from the already-archived change and completes the commit, dated tag, and push itself — " +
-      "do not hand-commit, do not hand-tag, and do not re-apply delta specs manually. " +
-      `Follow the skill's guardrails, completing the non-interactive happy path without asking for confirmation.`,
-  );
-  output.output = [output.output, ...nudges]
-    .map((part) => (part ?? "").trim())
-    .filter(Boolean)
-    .join("\n\n");
-}
-
-const REACT_DOCTOR_VERSION = "0.8.1";
-
-const REACT_DOCTOR_NON_LINT_FAILURES = [
-  /No React dependency found/i,
-  /Could not resolve config/i,
-  /is not a git repository/i,
-];
-
-const REACT_DOCTOR_EDIT_TOOLS = new Set(["write", "edit", "apply_patch"]);
-const REACT_DOCTOR_ARGS = [
-  "--yes",
-  "--verbose",
-  "--scope",
-  "changed",
-  "--base",
-  "HEAD",
-  "--blocking",
-  "warning",
-  "--no-score",
-  "--max-duration",
-  "30",
-];
-
-async function runReactDoctorScan(
-  context: CompanionContext,
-  client: PluginInput["client"],
-  $: PluginInput["$"],
-  sessionID: string,
-  scansInFlight: Set<string>,
-): Promise<void> {
-  const repo = context.repositoryPath;
-  if (!repo || scansInFlight.has(sessionID)) return;
-  scansInFlight.add(sessionID);
-  try {
-    const localBin = path.join(repo, "node_modules", ".bin", "react-doctor");
-    const mateBin = process.env.MATE_REACT_DOCTOR_BIN_PATH;
-    const doctorBin = mateBin && fs.existsSync(mateBin) ? mateBin : localBin;
-
-    const result = fs.existsSync(doctorBin)
-      ? await $`${doctorBin} ${REACT_DOCTOR_ARGS}`.cwd(repo).nothrow().quiet()
-      : await $`npx --yes ${`react-doctor@${REACT_DOCTOR_VERSION}`} ${REACT_DOCTOR_ARGS}`
-          .cwd(repo)
-          .nothrow()
-          .quiet();
-
-    if (result.exitCode === 0) return;
-
-    const output = `${result.stdout?.toString() ?? ""}${result.stderr?.toString() ?? ""}`.trim();
-    if (!output || REACT_DOCTOR_NON_LINT_FAILURES.some((re) => re.test(output))) return;
-
-    await client.tui
-      .showToast({
-        query: { directory: repo },
-        body: {
-          title: "React Doctor",
-          message: "Found issues in the changed files — review before finishing.",
-          variant: "warning",
-        },
-      })
-      .catch(() => {});
-    await client.session
-      .promptAsync({
-        path: { id: sessionID },
-        query: { directory: repo },
-        body: {
-          parts: [
-            {
-              type: "text",
-              synthetic: true,
-              text:
-                "React Doctor found issues in the changed files. Review this output and fix " +
-                "the regressions before finishing. For confirmed issues that cannot be fixed " +
-                "now, create GitHub issues with the rule, file/line, confidence, impact, and " +
-                `proposed fix.\n\n${output}`,
-            },
-          ],
-        },
-      })
-      .catch(() => {});
-  } catch {
-    // Never break the session because a diagnostic scan failed.
-  } finally {
-    scansInFlight.delete(sessionID);
-  }
-}
-
-type PluginEventInput = Parameters<NonNullable<Hooks["event"]>>[0];
-type ToolAfterInput = Parameters<NonNullable<Hooks["tool.execute.after"]>>[0];
-type ToolAfterOutput = Parameters<NonNullable<Hooks["tool.execute.after"]>>[1];
-
-export const CompanionHooksPlugin: Plugin = async (pluginInput = {} as PluginInput) => {
-  const { client, $ } = pluginInput;
-  const context = readContext(process.env.MATE_ARTIFACT_PATH ?? "");
-  if (!context.companionPath || !context.repositoryPath) return {};
-
-  const archiveDir = path.join(context.companionPath, "openspec", "changes", "archive");
-  const archiveSnapshot = readArchiveEntries(archiveDir);
-  const nudgedCommandChanges = new Set<string>();
-  const dirtyReactDoctorSessions = new Set<string>();
-  const reactDoctorScansInFlight = new Set<string>();
-
-  return {
-    event: async ({ event }: PluginEventInput) => {
-      if (event.type !== "session.idle") return;
-      const sessionID = event.properties.sessionID;
-      if (
-        !context.reactDoctorEnabled ||
-        reactDoctorScansInFlight.has(sessionID) ||
-        !dirtyReactDoctorSessions.delete(sessionID)
-      ) {
-        return;
-      }
-      await runReactDoctorScan(context, client, $, sessionID, reactDoctorScansInFlight);
-    },
-    "tool.execute.before": async (
-      input: { tool: unknown },
-      output: { args: { filePath?: unknown; patchText?: unknown } | undefined },
-    ) => {
-      const toolName = String(input.tool ?? "");
-      const args = output.args ?? {};
-      if (["write", "edit"].includes(toolName)) {
-        const filePath = String(args.filePath ?? "");
-        if (filePath && shouldBlockArtifactWrite(context, filePath)) {
-          throw new Error(buildArtifactError(context, filePath));
-        }
-      }
-      if (toolName === "apply_patch") {
-        for (const filePath of extractPatchPaths(String(args.patchText ?? ""))) {
-          if (shouldBlockArtifactWrite(context, filePath)) {
-            throw new Error(buildArtifactError(context, filePath));
-          }
-        }
-      }
-    },
-    "tool.execute.after": async (input: ToolAfterInput, output: ToolAfterOutput) => {
-      if (context.reactDoctorEnabled && REACT_DOCTOR_EDIT_TOOLS.has(input.tool)) {
-        dirtyReactDoctorSessions.add(input.sessionID);
-      }
-      appendOpenSpecFinishNudge(context, archiveSnapshot, nudgedCommandChanges, input, output);
-    },
-  };
-};
-
-export default CompanionHooksPlugin;

package/src/companion-policy.ts

@@ -1,177 +0,0 @@
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-
-import { readCompanionRuntimeContext, type CompanionRuntimeContext } from "@uniqbit/mate-core";
-
-export type CompanionContext = CompanionRuntimeContext & {
-  agentsMd: string;
-};
-
-const ARTIFACT_BASENAMES = new Set([
-  "CLAUDE.md",
-  "CONTEXT.md",
-  "design.md",
-  "explore-brief.md",
-  "proposal.md",
-  "spec.md",
-  "tasks.md",
-]);
-const ARTIFACT_SEGMENTS = [
-  "/changes/",
-  "/openspec/",
-  "/specs/",
-  "/docs/adr/",
-  "/docs/adrs/",
-  "/docs/decisions/",
-  "/docs/prd/",
-];
-function normalizedPolicyPath(filePath: string): string {
-  return `/${filePath.replace(/\\/g, "/").replace(/^\/+/, "")}`;
-}
-
-export function isArtifactPath(filePath: string): boolean {
-  const basename = path.basename(filePath);
-  const ext = path.extname(basename).toLowerCase();
-  const normalized = normalizedPolicyPath(filePath);
-
-  if (ARTIFACT_BASENAMES.has(basename)) {
-    return true;
-  }
-
-  if (ARTIFACT_SEGMENTS.some((segment) => normalized.includes(segment))) {
-    return true;
-  }
-
-  if (ext === ".md" && basename !== "README.md") {
-    return true;
-  }
-
-  return false;
-}
-
-export function isProductDocumentationPath(context: CompanionContext, filePath: string): boolean {
-  const normalized = normalizeTargetPath(context, filePath);
-  const relativePath = path.relative(context.repositoryPath, normalized);
-  if (!relativePath || relativePath.startsWith("..")) {
-    return false;
-  }
-
-  const parts = relativePath.split(path.sep);
-  for (let index = 0; index < parts.length; index += 1) {
-    const part = parts[index];
-    if (part === ".storybook" || part === "storybook") {
-      return true;
-    }
-
-    if (part !== "docs") {
-      continue;
-    }
-
-    const docsRoot = path.join(context.repositoryPath, ...parts.slice(0, index + 1));
-    if (fs.existsSync(path.join(docsRoot, "package.json"))) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-export function normalizeTargetPath(context: CompanionContext, filePath: string): string {
-  if (path.isAbsolute(filePath)) {
-    return path.normalize(filePath);
-  }
-
-  return path.normalize(path.join(context.repositoryPath, filePath));
-}
-
-export function isGitignored(context: CompanionContext, filePath: string): boolean {
-  if (!context.repositoryPath) {
-    return false;
-  }
-
-  const normalized = normalizeTargetPath(context, filePath);
-  if (!normalized.startsWith(path.normalize(context.repositoryPath))) {
-    return false;
-  }
-
-  const relativePath = path.relative(context.repositoryPath, normalized);
-  if (!relativePath || relativePath.startsWith("..")) {
-    return false;
-  }
-
-  const result = spawnSync(
-    "git",
-    ["-C", context.repositoryPath, "check-ignore", "--no-index", "-q", "--", relativePath],
-    {
-      encoding: "utf8",
-      stdio: "ignore",
-    },
-  );
-
-  return result.status === 0;
-}
-
-export function shouldBlockArtifactWrite(context: CompanionContext, filePath: string): boolean {
-  if (!filePath) {
-    return false;
-  }
-
-  if (normalizeTargetPath(context, filePath).startsWith(path.normalize(context.companionPath))) {
-    return false;
-  }
-
-  if (isProductDocumentationPath(context, filePath)) {
-    return false;
-  }
-
-  if (!isArtifactPath(filePath)) {
-    return false;
-  }
-
-  return !isGitignored(context, filePath);
-}
-
-const PATCH_FILE_MARKER = /\*\*\* (?:Add|Update|Move to|Delete) File:\s*(.+)$/gm;
-
-export function extractPatchPaths(patchText: string): string[] {
-  const paths: string[] = [];
-  let match;
-  while ((match = PATCH_FILE_MARKER.exec(patchText)) !== null) {
-    const raw = match[1].trim();
-    if (raw) {
-      paths.push(raw);
-    }
-  }
-  return paths;
-}
-
-export function buildArtifactError(context: CompanionContext, filePath: string): string {
-  const rel = path.relative(context.repositoryPath, filePath);
-  const suggested = path.join(context.companionPath, rel);
-
-  return [
-    `${context.frameworkName} guardrail: artifact writes must go to the companion framework path.`,
-    `  target:   ${filePath}`,
-    `  suggested: ${suggested}`,
-    `Rewrite to ${suggested} and retry.`,
-  ].join("\n");
-}
-
-export function readContext(companionPath: string): CompanionContext {
-  const agentsMdPath = path.join(companionPath, "AGENTS.md");
-  let agentsMd = "";
-  try {
-    if (fs.existsSync(agentsMdPath)) {
-      agentsMd = fs.readFileSync(agentsMdPath, "utf8");
-    }
-  } catch {
-    // Ignore read errors; AGENTS.md is optional
-  }
-
-  return {
-    ...readCompanionRuntimeContext(process.env),
-    companionPath,
-    agentsMd,
-  };
-}