@uniqbit/mate-core 0.18.3-canary.0 → 0.18.3

package/src/lib/orchestrator/companion-store.ts

@@ -1,94 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-import { FRAMEWORK_NAME } from "../../framework";
-import { CompanionRegistryStore } from "./companion-registry-store";
-import { ConfigStore } from "./config-store";
-import { pathIsDirectory, writeRepoLocalRegistryEntry } from "./repo-local-registry";
-import { type CompanionSource, ConfigError, type LinkedRepository } from "./types";
-
-/** Builds a {@link CompanionStore} whose config/registry files live under `<companionPath>/.mate/config`, regardless of `process.cwd()`. */
-export function companionRootedStore(companionPath: string): CompanionStore {
-  const configDir = path.join(path.resolve(companionPath), `.${FRAMEWORK_NAME}`, "config");
-  return new CompanionStore(
-    new ConfigStore(path.join(configDir, "framework.yaml")),
-    new CompanionRegistryStore(path.join(configDir, "registry.yaml")),
-  );
-}
-
-export class CompanionStore {
-  constructor(
-    private readonly configStore = new ConfigStore(),
-    private readonly companionRegistryStore = new CompanionRegistryStore(),
-  ) {}
-
-  async registerRepository(
-    repository: LinkedRepository,
-    options: { companionSource?: CompanionSource } = {},
-  ): Promise<LinkedRepository> {
-    const stats = await fs.stat(repository.path).catch(() => null);
-    if (!stats?.isDirectory()) {
-      throw new ConfigError(
-        `Linked repository path must exist and be a directory: ${repository.path}`,
-      );
-    }
-
-    // A companion's registry.yaml may not exist yet (its first-ever link):
-    // that is not a real error here, unlike a working repo reading its own
-    // missing config, so fall back to an empty registry instead of throwing.
-    const working = await this.companionRegistryStore.load().catch((error) => {
-      if (error instanceof ConfigError) return CompanionRegistryStore.defaultConfig();
-      throw error;
-    });
-
-    // Prune dead entries (path no longer a directory) as part of this same
-    // write, piggybacking on the load/save that registration already does
-    // rather than adding a separate scan; never runs on a read-only list.
-    const checked = await Promise.all(
-      working.repos.map(async (repo) => ({ repo, exists: await pathIsDirectory(repo.path) })),
-    );
-    const survivors: LinkedRepository[] = [];
-    for (const entry of checked) {
-      if (entry.exists) survivors.push(entry.repo);
-    }
-
-    const existing = survivors.findIndex((r) => r.id === repository.id);
-    if (existing >= 0) {
-      survivors[existing] = repository;
-    } else {
-      survivors.push(repository);
-    }
-    working.repos = survivors;
-    await this.companionRegistryStore.save(working);
-
-    // Repo-local registry write is a cache, not the source of truth: the
-    // companion-side write above already succeeded, so a failure here (e.g. a
-    // read-only working tree) must not fail the overall link operation.
-    try {
-      const companionRoot = path.resolve(path.dirname(this.configStore.configPath), "..", "..");
-      await writeRepoLocalRegistryEntry(
-        repository.path,
-        companionRoot,
-        repository,
-        options.companionSource ?? "git",
-      );
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.error(
-        `mate: warning: failed to write repo-local registry for ${repository.path}: ${message}`,
-      );
-    }
-
-    return repository;
-  }
-
-  async getRepository(repositoryId: string): Promise<LinkedRepository | undefined> {
-    const working = await this.companionRegistryStore.load();
-    return working.repos.find((r) => r.id === repositoryId);
-  }
-
-  async listRepositories(): Promise<LinkedRepository[]> {
-    const working = await this.companionRegistryStore.load();
-    return working.repos;
-  }
-}

package/src/lib/orchestrator/repo-local-registry.ts

@@ -1,143 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-import { parse } from "yaml";
-
-import {
-  ancestorDirectories,
-  repoLocalDirName,
-  repoLocalRegistryPath,
-  type RepoLocalRegistryFile,
-} from "../../runtime/repo-local";
-import { firstFailure } from "./projection-types";
-import { normalizeLinkedRepository } from "./repo-local-store";
-import { project } from "./working-repo-projection";
-import type { RepoLocalRegistry } from "./repo-local-store";
-import type { CompanionSource, LinkedRepository } from "./types";
-
-export {
-  repoLocalDirPath,
-  repoLocalFrameworkPath,
-  repoLocalRegistryPath,
-} from "../../runtime/repo-local";
-export { pathIsDirectory } from "../fs-utils";
-export {
-  RepoLocalRegistryStore,
-  upsertRepoLocalCompanionPointer,
-  writeRepoLocalFrameworkConfig,
-  type RepoLocalCompanionPointer,
-  type RepoLocalRegistry,
-} from "./repo-local-store";
-
-const repoLocalScanSkipDirNames = () =>
-  new Set([
-    ".git",
-    repoLocalDirName(),
-    "node_modules",
-    "dist",
-    "build",
-    ".next",
-    ".turbo",
-    ".venv",
-    "venv",
-    "target",
-    ".cache",
-  ]);
-
-/**
- * Records a Repository Link. Deliberately writes no projection file: wrapping is
- * an explicit act, which is why the scope and not the inputs picks the entries.
- * Throws on the first failed entry — this caller's own callers warn on it, so
- * the owner's per-entry best-effort report must not silently become success.
- */
-export async function writeRepoLocalRegistryEntry(
-  repoPath: string,
-  companionPath: string,
-  repository: LinkedRepository,
-  source: CompanionSource,
-): Promise<void> {
-  const { outcomes } = await project("link", { repoPath, companionPath, repository, source });
-  const failure = firstFailure(outcomes);
-  if (failure) throw failure.error ?? new Error(`failed to project ${failure.path}`);
-}
-
-export async function findRepoLocalLinkedRepository(cwd: string): Promise<LinkedRepository | null> {
-  const found = await findRepoLocalRegistryFile(cwd);
-  if (!found) return null;
-
-  try {
-    const raw = await fs.readFile(found.registryPath, "utf8");
-    const parsed = parse(raw) as Partial<RepoLocalRegistry> | null;
-    if (!parsed?.repository) return null;
-    return normalizeLinkedRepository(parsed.repository);
-  } catch {
-    return null;
-  }
-}
-
-/** Walks up from `cwd` looking for the nearest ancestor holding a repo-local registry file. */
-export async function findRepoLocalRegistryFile(
-  cwd: string,
-): Promise<RepoLocalRegistryFile | null> {
-  for (const dir of ancestorDirectories(cwd)) {
-    const candidate = repoLocalRegistryPath(dir);
-    try {
-      if ((await fs.stat(candidate)).isFile()) return { repoRoot: dir, registryPath: candidate };
-    } catch {
-      // keep walking up
-    }
-  }
-  return null;
-}
-
-/** Finds repo-local registries strictly beneath `rootPath`, skipping noisy directories. */
-export async function findDescendantRepoLocalRegistries(rootPath: string): Promise<string[]> {
-  const resolvedRootPath = path.resolve(rootPath);
-  const pending = [resolvedRootPath];
-  const registryCandidates: Array<{ registryPath: string; shadowedPath: string }> = [];
-
-  while (pending.length > 0) {
-    const currentPath = pending.pop();
-    if (!currentPath) continue;
-
-    const entries = await (async () => {
-      try {
-        return await fs.readdir(currentPath, { withFileTypes: true });
-      } catch {
-        return null;
-      }
-    })();
-    if (!entries) continue;
-
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-
-      const entryPath = path.join(currentPath, entry.name);
-      if (entry.name === repoLocalDirName()) {
-        if (currentPath !== resolvedRootPath) {
-          registryCandidates.push({
-            registryPath: path.join(entryPath, "config", "registry.yaml"),
-            shadowedPath: currentPath,
-          });
-        }
-        continue;
-      }
-      if (repoLocalScanSkipDirNames().has(entry.name)) continue;
-
-      pending.push(entryPath);
-    }
-  }
-
-  const shadowedPaths = await Promise.all(
-    registryCandidates.map(async ({ registryPath, shadowedPath }) => {
-      try {
-        const stats = await fs.stat(registryPath);
-        return stats.isFile() ? shadowedPath : null;
-      } catch {
-        // A missing or unreadable registry is not a shadowed link.
-        return null;
-      }
-    }),
-  );
-  return shadowedPaths.filter((candidate): candidate is string => candidate !== null).sort();
-}

package/src/templates/capabilities/react-doctor/claude/hooks/react-doctor.sh

@@ -1,144 +0,0 @@
-#!/bin/sh
-set -u
-
-input_file=$(mktemp "${TMPDIR:-/tmp}/react-doctor-agent-hook.XXXXXX")
-output_file=$(mktemp "${TMPDIR:-/tmp}/react-doctor-agent-hook-output.XXXXXX")
-trap 'rm -f "$input_file" "$output_file"' EXIT
-cat > "$input_file"
-
-script_dir=$(CDPATH='' cd "$(dirname "$0")" && pwd)
-project_root=${CLAUDE_PROJECT_DIR:-}
-if [ -z "$project_root" ] && command -v node >/dev/null 2>&1; then
-  project_root=$(node - "$input_file" <<'NODE'
-const fs = require('node:fs');
-try {
-  const input = JSON.parse(fs.readFileSync(process.argv[2], 'utf8') || '{}');
-  if (typeof input.cwd === 'string') process.stdout.write(input.cwd);
-} catch {
-  // Fall back to the current working directory or the hook location below.
-}
-NODE
-)
-fi
-if [ -z "$project_root" ]; then
-  project_root=${PWD:-}
-fi
-if [ -z "$project_root" ]; then
-  project_root=$(CDPATH='' cd "$script_dir/../.." && pwd)
-fi
-if ! cd "$project_root"; then
-  exit 0
-fi
-
-should_scan() {
-  if ! command -v node >/dev/null 2>&1; then
-    return 1
-  fi
-
-  node - "$input_file" "$project_root" <<'NODE'
-const crypto = require('node:crypto');
-const { spawnSync } = require('node:child_process');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const inputPath = process.argv[2];
-const projectRoot = process.argv[3];
-const editToolNames = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit', 'ApplyPatch']);
-try {
-  const input = JSON.parse(fs.readFileSync(inputPath, 'utf8') || '{}');
-  const eventName = input.hook_event_name || input.eventName || input.event_name;
-  const sessionId = input.session_id || input.sessionId;
-  if (!sessionId) process.exit(10);
-
-  const markerDir = path.join(process.env.TMPDIR || os.tmpdir(), 'mate-react-doctor-hooks');
-  const markerKey = crypto
-    .createHash('sha256')
-    .update(`${projectRoot}\0${sessionId}`)
-    .digest('hex');
-  const markerPath = path.join(markerDir, markerKey);
-
-  const hasWorkingTreeChanges = () => {
-    const result = spawnSync('git', ['status', '--porcelain', '--untracked-files=all'], {
-      cwd: projectRoot,
-      encoding: 'utf8',
-    });
-    // Preserve the existing scan behavior when git is unavailable or the
-    // project is not a git repository; React Doctor will handle that case.
-    if (result.error || result.status !== 0) return true;
-    return Boolean(result.stdout.trim());
-  };
-
-  if (eventName === 'PostToolUse') {
-    const toolName = input.tool_name || input.toolName || input.tool;
-    if (!editToolNames.has(toolName)) process.exit(10);
-    fs.mkdirSync(markerDir, { recursive: true, mode: 0o700 });
-    fs.writeFileSync(markerPath, '', { mode: 0o600 });
-    process.exit(10);
-  }
-
-  if (eventName !== 'Stop' || !fs.existsSync(markerPath)) process.exit(10);
-  fs.unlinkSync(markerPath);
-  if (!hasWorkingTreeChanges()) process.exit(10);
-  process.exit(0);
-} catch {
-  process.exit(10);
-}
-NODE
-}
-
-REACT_DOCTOR_VERSION=${REACT_DOCTOR_VERSION:-0.9.13}
-
-run_react_doctor() {
-  if [ -n "${MATE_REACT_DOCTOR_BIN_PATH:-}" ] && [ -x "$MATE_REACT_DOCTOR_BIN_PATH" ]; then
-    "$MATE_REACT_DOCTOR_BIN_PATH" --yes --verbose --scope changed --base HEAD --blocking warning --no-score --max-duration 30
-    return
-  fi
-
-  if [ -x ./node_modules/.bin/react-doctor ]; then
-    ./node_modules/.bin/react-doctor --yes --verbose --scope changed --base HEAD --blocking warning --no-score --max-duration 30
-    return
-  fi
-
-  if command -v react-doctor >/dev/null 2>&1; then
-    react-doctor --yes --verbose --scope changed --base HEAD --blocking warning --no-score --max-duration 30
-    return
-  fi
-
-  printf '%s\n' "react-doctor: executable unavailable; install react-doctor@${REACT_DOCTOR_VERSION} in Mate or the project, then retry."
-  return 127
-}
-
-if ! should_scan; then
-  exit 0
-fi
-
-if run_react_doctor > "$output_file" 2>&1; then
-  exit 0
-fi
-
-node - "$input_file" "$output_file" <<'NODE'
-const fs = require('node:fs');
-const outputPath = process.argv[3];
-const scanOutput = fs.readFileSync(outputPath, 'utf8').trim();
-if (!scanOutput) process.exit(0);
-
-const NON_LINT_FAILURES = [
-  /No React dependency found/i,
-  /Could not resolve config/i,
-  /is not a git repository/i,
-];
-if (NON_LINT_FAILURES.some((re) => re.test(scanOutput))) process.exit(0);
-
-if (/^react-doctor: executable unavailable/i.test(scanOutput)) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'Stop',
-      additionalContext: `${scanOutput}\nReact Doctor was not run. Install the pinned Mate runtime dependency with \`bun install\` in the Mate checkout, or install \`react-doctor@0.9.13\` in the project root, then retry.`,
-    },
-  }));
-  process.exit(0);
-}
-
-const message = `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${scanOutput}`;
-console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'Stop', additionalContext: message } }));
-NODE

package/src/templates/capabilities/react-doctor/skill/SKILL.md

@@ -1,51 +0,0 @@
----
-name: react-doctor
-description: Use when finishing a feature, fixing a bug, before committing React code, or when the user types `/doctor`, asks to scan, triage, or clean up React diagnostics. Covers lint, accessibility, bundle size, architecture. Includes a regression check and a full local-triage workflow that fetches the canonical playbook.
-version: "1.2.0"
----
-
-# React Doctor
-
-Scans React codebases for security, performance, correctness, and architecture issues. Outputs a 0–100 health score.
-
-## After making React code changes:
-
-Run `npx react-doctor@latest --verbose --scope changed` and check the score did not regress.
-
-If the score dropped, fix the regressions before committing.
-
-## For general cleanup or code improvement:
-
-Run `npx react-doctor@latest --verbose` (the default `--scope full`) to scan the full codebase. Fix issues by severity — errors first, then warnings.
-
-## /doctor — full local triage workflow
-
-When the user types `/doctor`, says "run react doctor", or asks for a full triage / cleanup pass (not just a regression check), fetch the canonical local-triage playbook and follow every step in it:
-
-```bash
-curl --fail --silent --show-error \
-  --header 'Cache-Control: no-cache' \
-  https://www.react.doctor/prompts/react-doctor-agent.md
-```
-
-The playbook is the single source of truth — a scan → filter → triage → fix → validate loop that edits the working tree directly (never commits, never opens PRs). Updating the prompt at its source updates every agent on its next fetch — no skill reinstall needed.
-
-Pair it with the matching per-rule prompts at `https://www.react.doctor/prompts/rules/<plugin>/<rule>.md` (fetched on demand inside the playbook) so each fix uses the canonical, reviewer-tested recipe.
-
-## Configuring or explaining rules
-
-When the user wants to understand a rule, disagrees with one, or wants to disable / tune which rules run (not fix code), read [references/explain.md](references/explain.md) and follow it. Start with `npx react-doctor@latest rules explain <rule>`, then apply the narrowest control via `npx react-doctor@latest rules disable|set|category|ignore-tag …`, which edits your `doctor.config.*` (or `package.json#reactDoctor`).
-
-## Command
-
-```bash
-npx react-doctor@latest --verbose --scope changed
-```
-
-| Flag              | Purpose                                                          |
-| ----------------- | ---------------------------------------------------------------- |
-| `.`               | Scan current directory                                           |
-| `--verbose`       | Show affected files and line numbers per rule                    |
-| `--scope changed` | Only report issues introduced vs the base branch (default: full) |
-| `--scope lines`   | Only report issues on the changed lines                          |
-| `--score`         | Output only the numeric score                                    |

package/src/templates/report-assets/README.md

@@ -1,32 +0,0 @@
-# Report assets
-
-Vendored browser assets inlined into `mate report` HTML output. Nothing here is
-imported as a module or linted, formatted, or typechecked — these files are read
-as strings at render time.
-
-## `mermaid.min.js`
-
-|          |                                                                          |
-| -------- | ------------------------------------------------------------------------ |
-| Upstream | [`mermaid`](https://www.npmjs.com/package/mermaid) `dist/mermaid.min.js` |
-| Version  | `12.0.0`                                                                 |
-| License  | MIT — see `mermaid.LICENSE`                                              |
-| Form     | esbuild IIFE, self-contained, zero dynamic `import()` calls              |
-| Size     | 5.58 MB raw                                                              |
-
-The IIFE build is vendored rather than installed because `@uniqbit/mate-core`
-publishes raw `src/` with no build step, and only mermaid's ESM build lazily
-loads per-diagram chunks. It is inlined into a report document only when that
-report carries a mermaid payload.
-
-### Bumping
-
-```sh
-npm pack mermaid@<version>
-tar -xzf mermaid-<version>.tgz package/dist/mermaid.min.js package/LICENSE
-cp package/dist/mermaid.min.js packages/mate-core/src/templates/report-assets/mermaid.min.js
-cp package/LICENSE packages/mate-core/src/templates/report-assets/mermaid.LICENSE
-```
-
-Update the version above, confirm `grep -c 'import('` on the bundle stays `0`,
-then re-run the report renderer tests.

package/src/templates/report-assets/mermaid.LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2014 - 2022 Knut Sveidqvist
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.