@uniqbit/mate-core 0.15.3 → 0.15.4-canary.10

package/src/templates/capabilities/openspec-cap/claude/hooks/mate-artifact-finish.sh

@@ -1,161 +0,0 @@
-#!/bin/sh
-set -u
-
-input_file=$(mktemp "${TMPDIR:-/tmp}/mate-artifact-finish.XXXXXX")
-trap 'rm -f "$input_file"' EXIT
-cat >"$input_file"
-
-node -e '
-const fs = require("node:fs");
-
-const inputFile = process.argv[1];
-const archivePathPattern = /(?:^|[\s\/"\x27`,(])openspec\/changes\/archive\/(\d{4}-\d{2}-\d{2}-[^\/\s"\x27`,)]+)/;
-
-function shellSplit(command) {
-  const parts = [];
-  const singleQuote = String.fromCharCode(39);
-  let current = "";
-  let quote = 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 !== singleQuote) {
-      const next = command[index + 1] || "";
-      if (next === "\\" || /\s/.test(next) || next === singleQuote || next === String.fromCharCode(34)) {
-        escaping = true;
-        continue;
-      }
-    }
-    if ((char === singleQuote || char === String.fromCharCode(34)) && !quote) {
-      quote = char;
-      continue;
-    }
-    if (quote === char) {
-      quote = null;
-      continue;
-    }
-    const next = command[index + 1] || "";
-    const previous = command[index - 1] || "";
-    const isControlOperator = !quote && (
-      char === ";" || char === "|" ||
-      (char === "&" && next !== ">" && previous !== ">" && previous !== "<")
-    );
-    if (isControlOperator) {
-      if (current) parts.push(current);
-      current = "";
-      if ((char === "|" || char === "&") && next === char) {
-        parts.push(char + next);
-        index += 1;
-      } else {
-        parts.push(char);
-      }
-      continue;
-    }
-    if (!quote && /\s/.test(char)) {
-      if (current) parts.push(current);
-      current = "";
-      continue;
-    }
-    current += char;
-  }
-  if (current) parts.push(current);
-  return parts;
-}
-
-function extractChangeFromPath(value) {
-  const match = value.replace(/\\/g, "/").match(archivePathPattern);
-  return match ? match[1].replace(/^\d{4}-\d{2}-\d{2}-/, "") : null;
-}
-
-// Shell syntax tokens are never change-name positionals: separators end the
-// archive invocation, redirections are skipped (a bare operator also consumes
-// its target token).
-const separatorPattern = /^(\|\|?|&&?|;)$/;
-const redirectionPattern = /^(\d*(>>?|<)|&>>?)/;
-const bareRedirectionPattern = /^(\d*(>>?|<)|&>>?)$/;
-
-function extractArchiveCommand(command) {
-  const parts = shellSplit(command);
-  const index = parts.findIndex((part, position) =>
-    part === "archive" && position > 0 &&
-    (parts[position - 1] === "openspec" || parts[position - 1].endsWith("/openspec")));
-  if (index < 0) return null;
-  for (let position = index + 1; position < parts.length; position += 1) {
-    const part = parts[position];
-    if (!part || part === "--") continue;
-    if (separatorPattern.test(part)) return null;
-    if (redirectionPattern.test(part)) {
-      if (bareRedirectionPattern.test(part)) position += 1;
-      continue;
-    }
-    if (part.startsWith("-")) {
-      if (part === "--store") position += 1;
-      continue;
-    }
-    return part;
-  }
-  return null;
-}
-
-function extractMoveCommand(command) {
-  const parts = shellSplit(command);
-  const moveCommands = new Set([
-    "mv", "move", "move-item", "cmd", "cmd.exe", "powershell", "powershell.exe", "pwsh", "pwsh.exe",
-  ]);
-  const isPython = (part) => /^python(?:\d(?:\.\d+)*)?(?:\.exe)?$/i.test(part.split(/[\\/]/).pop() || part);
-  for (let index = 0; index < parts.length; index += 1) {
-    if (moveCommands.has(parts[index].toLowerCase())) {
-      for (const part of parts.slice(index + 1)) {
-        const change = extractChangeFromPath(part);
-        if (change) return change;
-      }
-    }
-    if (isPython(parts[index]) && /(?:shutil\.move|os\.rename|\.rename\s*\()/.test(command)) {
-      return extractChangeFromPath(command);
-    }
-  }
-  return null;
-}
-
-// Nudge only on apparent success: stay silent on a clear failure indication,
-// nudge when success is indicated or indeterminate.
-function isClearFailure(response) {
-  if (!response || typeof response !== "object") return false;
-  if (response.success === false || response.is_error === true) return true;
-  if (typeof response.error === "string" && response.error) return true;
-  if (response.interrupted === true) return true;
-  const exitCode = response.exit_code ?? response.exitCode;
-  return typeof exitCode === "number" && exitCode !== 0;
-}
-
-let input = {};
-try {
-  input = JSON.parse(fs.readFileSync(inputFile, "utf8") || "{}");
-} catch {}
-
-if (input.hook_event_name !== "PostToolUse" || input.tool_name !== "Bash") process.exit(0);
-const command = input.tool_input && typeof input.tool_input.command === "string"
-  ? input.tool_input.command
-  : "";
-const change = extractArchiveCommand(command) || extractMoveCommand(command);
-if (!change) process.exit(0);
-if (isClearFailure(input.tool_response)) process.exit(0);
-
-const mateCommand = process.env.MATE_COMMAND || "mate";
-const context =
-  "OpenSpec change " + change + " was just archived. Invoke the mate-artifact-finish " +
-  "skill, then run `" + mateCommand + " artifact finish \"" + change + "\" --json` to complete the " +
-  "finish workflow (commit, tag, and push).";
-process.stdout.write(JSON.stringify({
-  hookSpecificOutput: {
-    hookEventName: "PostToolUse",
-    additionalContext: context,
-  },
-}));
-' "$input_file"
-exit 0

package/src/templates/providers/claude/.claude/hooks/mate-session-banner

@@ -1,28 +0,0 @@
-#!/usr/bin/env python3
-"""Show the active Mate companion paths in Claude Code."""
-
-from __future__ import annotations
-
-import json
-import os
-import sys
-
-
-def main() -> int:
-    repo_path = os.environ.get("MATE_REPO_PATH")
-    artifact_path = os.environ.get("MATE_ARTIFACT_PATH")
-    if not repo_path or not artifact_path:
-        return 0
-
-    mate_version = os.environ.get("MATE_VERSION", "unknown")
-    message = (
-        f"mate v{mate_version}\n"
-        f"  repo:     {repo_path}\n"
-        f"  mate: {artifact_path}"
-    )
-    print(json.dumps({"systemMessage": message}))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/src/templates/providers/claude/.claude/hooks/validate-artifact-path

@@ -1,242 +0,0 @@
-#!/usr/bin/env python3
-"""Block artifact writes outside the companion framework path.
-
-Artifact-like files may be written in the working repository only when the
-target path is already ignored by git. That keeps local-only scratch files
-possible without weakening the default repo split.
-
-Editing a file that already exists is always allowed: the guard exists to
-stop new agent artifacts from landing in the working repo, not to freeze
-files that are already part of it.
-"""
-
-from __future__ import annotations
-
-import json
-import os
-import pathlib
-import re
-import subprocess
-import sys
-from typing import Any
-
-
-KNOWN_ARTIFACT_BASENAMES = {
-    "CLAUDE.md",
-    "CONTEXT.md",
-    "design.md",
-    "explore-brief.md",
-    "proposal.md",
-    "spec.md",
-    "tasks.md",
-}
-
-ARTIFACT_PATH_MARKERS = (
-    "/changes/",
-    "/openspec/",
-    "/specs/",
-    "/docs/adr/",
-    "/docs/adrs/",
-    "/docs/decisions/",
-    "/docs/prd/",
-)
-MD_REDIRECT_RE = re.compile(r">{1,2}\s*([^\s;|&<>]+\.md)\b")
-MD_TEE_RE = re.compile(r"\btee\s+(?:-a\s+)?([^\s;|&<>]+\.md)\b")
-
-
-def read_payload() -> dict[str, Any]:
-    try:
-        return json.load(sys.stdin)
-    except json.JSONDecodeError:
-        return {}
-
-
-def artifact_like_path(file_path: str) -> bool:
-    if not file_path:
-        return False
-
-    basename = os.path.basename(file_path)
-    normalized = "/" + file_path.replace("\\", "/").lstrip("/")
-    if basename in KNOWN_ARTIFACT_BASENAMES:
-        return True
-
-    if any(marker in normalized for marker in ARTIFACT_PATH_MARKERS):
-        return True
-
-    if basename.endswith(".md") and basename != "README.md":
-        return True
-
-    return False
-
-
-def repo_root() -> str:
-    return os.environ.get("MATE_REPO_PATH") or os.getcwd()
-
-
-def companion_root() -> str | None:
-    companion = os.environ.get("MATE_ARTIFACT_PATH")
-    return os.path.normpath(companion) if companion else None
-
-
-def claude_config_root() -> str:
-    """Claude Code's own config/state directory (plan files, settings, todos).
-    Writes there are agent-runtime state, never Mate artifacts."""
-    configured = os.environ.get("CLAUDE_CONFIG_DIR")
-    if configured:
-        return os.path.normpath(configured)
-    return os.path.normpath(os.path.join(os.path.expanduser("~"), ".claude"))
-
-
-def normalize_path(file_path: str) -> str:
-    if os.path.isabs(file_path):
-        return os.path.normpath(file_path)
-    return os.path.normpath(os.path.join(repo_root(), file_path))
-
-
-def is_under(path: str, root: str) -> bool:
-    try:
-        return os.path.commonpath([os.path.normpath(path), os.path.normpath(root)]) == os.path.normpath(root)
-    except ValueError:
-        return False
-
-
-def is_gitignored(path: str) -> bool:
-    root = repo_root()
-    if not is_under(path, root):
-        return False
-
-    rel_path = os.path.relpath(path, root)
-    try:
-        result = subprocess.run(
-            ["git", "-C", root, "check-ignore", "--no-index", "-q", "--", rel_path],
-            stdout=subprocess.DEVNULL,
-            stderr=subprocess.DEVNULL,
-            check=False,
-        )
-    except FileNotFoundError:
-        return False
-    return result.returncode == 0
-
-
-def is_git_tracked(path: str) -> bool:
-    """A file already tracked in the working repo is product code being edited,
-    not a new agent artifact (e.g. packaged SKILL.md/spec.md template sources)."""
-    root = repo_root()
-    if not is_under(path, root):
-        return False
-
-    rel_path = os.path.relpath(path, root)
-    try:
-        result = subprocess.run(
-            ["git", "-C", root, "ls-files", "--error-unmatch", "--", rel_path],
-            stdout=subprocess.DEVNULL,
-            stderr=subprocess.DEVNULL,
-            check=False,
-        )
-    except FileNotFoundError:
-        return False
-    return result.returncode == 0
-
-
-def is_product_documentation_path(path: str) -> bool:
-    root = repo_root()
-    if not is_under(path, root):
-        return False
-
-    rel_path = os.path.relpath(path, root)
-    parts = pathlib.Path(rel_path).parts
-    for index, part in enumerate(parts):
-        if part in {".storybook", "storybook"}:
-            return True
-
-        if part != "docs":
-            continue
-
-        docs_root = os.path.join(root, *parts[: index + 1])
-        if os.path.exists(os.path.join(docs_root, "package.json")):
-            return True
-
-    return False
-
-
-def block_write(target: str, companion: str) -> None:
-    print("Mate guardrail: artifact writes must go to the companion framework path.", file=sys.stderr)
-    print(f" target: {target}", file=sys.stderr)
-    print(f" companion: {companion}", file=sys.stderr)
-    print("Use an absolute path under MATE_ARTIFACT_PATH instead.", file=sys.stderr)
-
-    if os.path.basename(target) == "CLAUDE.md":
-        print(
-            f"Note: CLAUDE.md already lives in the companion repo at {companion}/CLAUDE.md.",
-            file=sys.stderr,
-        )
-
-    raise SystemExit(2)
-
-
-def check_file_path(file_path: str, companion: str | None, allow_existing: bool = False) -> None:
-    if not file_path or not companion:
-        return
-
-    normalized = normalize_path(file_path)
-    if normalized.startswith(companion):
-        return
-
-    if is_under(normalized, claude_config_root()):
-        return
-
-    if allow_existing and os.path.isfile(normalized):
-        return
-
-    if is_product_documentation_path(normalized):
-        return
-
-    if not artifact_like_path(file_path):
-        return
-
-    if is_under(normalized, repo_root()) and (
-        is_gitignored(normalized) or is_git_tracked(normalized)
-    ):
-        return
-
-    block_write(file_path, companion)
-
-
-def command_matches(command: str) -> list[str]:
-    targets: list[str] = []
-    for pattern in (MD_REDIRECT_RE, MD_TEE_RE):
-        for match in pattern.finditer(command):
-            target = match.group(1).strip().strip('"\'')
-            if target:
-                targets.append(target)
-    return targets
-
-
-def main() -> int:
-    companion = companion_root()
-    if not companion:
-        return 0
-
-    payload = read_payload()
-    tool_name = payload.get("tool_name", "")
-    tool_input = payload.get("tool_input", {})
-
-    if tool_name in {"Write", "Edit", "MultiEdit"}:
-        check_file_path(
-            str(tool_input.get("file_path", "")),
-            companion,
-            allow_existing=tool_name in {"Edit", "MultiEdit"},
-        )
-        return 0
-
-    if tool_name == "Bash":
-        command = str(tool_input.get("command", ""))
-        for target in command_matches(command):
-            check_file_path(target, companion)
-        return 0
-
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/src/tools/setup/dynamic-plugins/pin-store.ts

@@ -1,30 +0,0 @@
-import { YamlFileStore } from "../../../lib/orchestrator/yaml-file-store";
-import { pluginPinFilePath } from "./paths";
-
-/** Committed record of one declared plugin's resolved install. */
-export interface PluginPin {
-  package: string;
-  declaredVersion: string;
-  resolvedVersion: string;
-  integrity?: string;
-}
-
-export interface PluginPinFile {
-  plugins: PluginPin[];
-}
-
-export class PluginPinStore extends YamlFileStore<PluginPinFile> {
-  constructor(companionPath: string) {
-    super(pluginPinFilePath(companionPath));
-  }
-
-  override async load(): Promise<PluginPinFile> {
-    const parsed = await super.load();
-    return { plugins: Array.isArray(parsed?.plugins) ? parsed.plugins : [] };
-  }
-
-  protected onMissing(): Promise<PluginPinFile> {
-    // The pin file appears only once install records a resolved plugin.
-    return Promise.resolve({ plugins: [] });
-  }
-}