@mmerterden/multi-agent-pipeline 12.7.0 → 12.8.0

package/pipeline/scripts/sync-parity-check.sh

@@ -1,135 +0,0 @@
-#!/usr/bin/env bash
-# sync-parity-check.sh  -  detect drift between two pipeline mirror trees.
-#
-# Use case: after editing the pipeline locally (e.g. ~/.claude/commands/multi-agent/),
-# verify that the open-source repo (~/multi-agent-pipeline/pipeline/) and the
-# Copilot mirror (~/.copilot/multi-agent/) are still byte-identical for the
-# files that should be shared.
-#
-# Why this exists:
-#   The sync-instructions skill is the official "copy from A to B" tool, but
-#   nothing currently catches drift if the user forgets to run it. This script
-#   is the watchdog  -  run it before committing or as part of a pre-push hook.
-#
-# Usage:
-#   sync-parity-check.sh <left-dir> <right-dir> [--ignore <regex>]...
-#
-# Examples:
-#   # Compare Claude personal copy vs. open-source repo:
-#   sync-parity-check.sh \
-#     ~/.claude/commands/multi-agent \
-#     ~/multi-agent-pipeline/pipeline/commands/multi-agent
-#
-#   # Compare Claude vs. Copilot mirrors, ignoring help.md if it intentionally
-#   # diverges:
-#   sync-parity-check.sh \
-#     ~/.claude/commands/multi-agent \
-#     ~/.copilot/multi-agent \
-#     --ignore '/help\.md$'
-#
-# Exit codes:
-#   0  -  perfect parity (or only ignored files differ)
-#   1  -  drift detected (lists differing + missing-from-each-side)
-#   2  -  usage error
-
-set -uo pipefail
-
-if [ "$#" -lt 2 ]; then
-  echo "usage: sync-parity-check.sh <left-dir> <right-dir> [--ignore <regex>]..." >&2
-  exit 2
-fi
-
-LEFT="$1"; shift
-RIGHT="$1"; shift
-
-IGNORES=()
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --ignore)
-      IGNORES+=("$2"); shift 2 ;;
-    *)
-      echo "unknown arg: $1" >&2; exit 2 ;;
-  esac
-done
-
-[ -d "$LEFT"  ] || { echo "error: left dir not found: $LEFT"  >&2; exit 2; }
-[ -d "$RIGHT" ] || { echo "error: right dir not found: $RIGHT" >&2; exit 2; }
-
-# Resolve to absolute, normalized paths.
-LEFT="$(cd "$LEFT"  && pwd)"
-RIGHT="$(cd "$RIGHT" && pwd)"
-
-is_ignored() {
-  local rel="$1"
-  for pat in "${IGNORES[@]+"${IGNORES[@]}"}"; do
-    if [[ "$rel" =~ $pat ]]; then return 0; fi
-  done
-  return 1
-}
-
-# Collect file lists, relative to each root.
-LEFT_FILES=$(cd "$LEFT" && find . -type f | sort)
-RIGHT_FILES=$(cd "$RIGHT" && find . -type f | sort)
-
-# Files only on one side.
-ONLY_LEFT=$(comm -23 <(echo "$LEFT_FILES") <(echo "$RIGHT_FILES"))
-ONLY_RIGHT=$(comm -13 <(echo "$LEFT_FILES") <(echo "$RIGHT_FILES"))
-COMMON=$(comm -12 <(echo "$LEFT_FILES") <(echo "$RIGHT_FILES"))
-
-# Report and tally.
-DRIFT=0
-MISSING_RIGHT=0
-MISSING_LEFT=0
-DIFFERS=0
-IGNORED=0
-
-# Files only on the LEFT (missing from RIGHT).
-while IFS= read -r f; do
-  [ -z "$f" ] && continue
-  rel="${f#./}"
-  if is_ignored "$rel"; then IGNORED=$((IGNORED+1)); continue; fi
-  echo "MISSING-FROM-RIGHT  $rel"
-  MISSING_RIGHT=$((MISSING_RIGHT+1))
-  DRIFT=1
-done <<< "$ONLY_LEFT"
-
-# Files only on the RIGHT (missing from LEFT).
-while IFS= read -r f; do
-  [ -z "$f" ] && continue
-  rel="${f#./}"
-  if is_ignored "$rel"; then IGNORED=$((IGNORED+1)); continue; fi
-  echo "MISSING-FROM-LEFT   $rel"
-  MISSING_LEFT=$((MISSING_LEFT+1))
-  DRIFT=1
-done <<< "$ONLY_RIGHT"
-
-# Files present on both sides  -  content compare.
-while IFS= read -r f; do
-  [ -z "$f" ] && continue
-  rel="${f#./}"
-  if is_ignored "$rel"; then IGNORED=$((IGNORED+1)); continue; fi
-  if ! diff -q "$LEFT/$rel" "$RIGHT/$rel" >/dev/null 2>&1; then
-    echo "DIFFERS             $rel"
-    DIFFERS=$((DIFFERS+1))
-    DRIFT=1
-  fi
-done <<< "$COMMON"
-
-echo ""
-echo "── parity summary ──"
-echo "left:               $LEFT"
-echo "right:              $RIGHT"
-echo "files differ:       $DIFFERS"
-echo "missing from right: $MISSING_RIGHT"
-echo "missing from left:  $MISSING_LEFT"
-echo "ignored:            $IGNORED"
-
-if [ "$DRIFT" -eq 0 ]; then
-  echo "result:             PARITY"
-  exit 0
-else
-  echo "result:             DRIFT"
-  echo ""
-  echo "fix: run /sync-instructions full to bring mirrors back in sync." >&2
-  exit 1
-fi

package/pipeline/scripts/test-gap-rules/android.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "stack": "android",
-  "description": "Android / Jetpack Compose / Kotlin test gap rules. Sources in *.kt; tests under app/src/test/ or app/src/androidTest/.",
-  "sourceExtensions": [".kt", ".java"],
-  "testPathSuffixes": ["Test.kt", "Tests.kt", "Test.java"],
-  "testPathContains": ["/src/test/", "/src/androidTest/", "/test/", "/tests/"],
-  "excludePathGlobs": ["build/", ".gradle/", "generated/", "**/BuildConfig.java", "**/R.java"],
-  "publicApiPatterns": [
-    { "id": "open_class", "regex": "\\bopen\\s+class\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "open_fun", "regex": "\\bopen\\s+fun\\s+([a-z_][A-Za-z0-9_]*)" },
-    { "id": "public_fun", "regex": "^\\s*(?:public\\s+)?fun\\s+([a-z_][A-Za-z0-9_]*)" },
-    { "id": "public_class", "regex": "^\\s*(?:public\\s+)?class\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "jvmstatic", "regex": "@JvmStatic\\b" },
-    { "id": "interface", "regex": "^\\s*(?:public\\s+)?interface\\s+([A-Z][A-Za-z0-9_]*)" }
-  ],
-  "composablePatterns": [
-    {
-      "id": "composable_fun",
-      "regex": "@Composable\\s+(?:public\\s+|internal\\s+)?fun\\s+([A-Z][A-Za-z0-9_]*)"
-    }
-  ],
-  "expectedTestKindsForComposable": ["compose-ui-test"],
-  "hint": "Cover @Composable functions with createComposeRule() + onNodeWithText/Tag/ContentDescription assertions; ViewModels with runTest + Turbine."
-}

package/pipeline/scripts/test-gap-rules/ios.json

@@ -1,34 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "stack": "ios",
-  "description": "iOS / SwiftUI / UIKit test gap rules. Source files in *.swift; tests in *Tests.swift. Snapshot/ViewInspector tests are also recognised when the source is a SwiftUI View.",
-  "sourceExtensions": [".swift"],
-  "testPathSuffixes": ["Tests.swift", "Test.swift"],
-  "testPathContains": ["/Tests/", "/UnitTests/", "/SnapshotTests/"],
-  "excludePathGlobs": [
-    "Pods/",
-    "Carthage/",
-    ".build/",
-    "DerivedData/",
-    "Generated/",
-    "Sourcery/",
-    "_Generated.swift",
-    "Tests/Fixtures/"
-  ],
-  "publicApiPatterns": [
-    { "id": "public_func", "regex": "\\bpublic\\s+func\\s+([A-Za-z_][A-Za-z0-9_]*)" },
-    { "id": "public_class", "regex": "\\bpublic\\s+(?:final\\s+)?class\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "public_struct", "regex": "\\bpublic\\s+struct\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "public_enum", "regex": "\\bpublic\\s+enum\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "public_proto", "regex": "\\bpublic\\s+protocol\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "public_init", "regex": "\\bpublic\\s+init\\b" },
-    { "id": "objc_export", "regex": "@objc(?:Members)?\\s+(?:public\\s+)?(?:func|class|var)" }
-  ],
-  "swiftUiViewPatterns": [
-    { "id": "view_struct", "regex": "struct\\s+([A-Z][A-Za-z0-9_]*)\\s*:\\s*View\\b" },
-    { "id": "config_struct", "regex": "struct\\s+([A-Z][A-Za-z0-9_]*Configuration)\\b" }
-  ],
-  "expectedTestKindsForView": ["snapshot", "viewinspector", "unit"],
-  "snapshotPathHints": ["SnapshotTests", "__Snapshots__"],
-  "hint": "Cover with a 3-layer test (structural ViewInspector + snapshot + unit) per swiftui-qa.md."
-}

package/pipeline/scripts/test-gap-rules/node.json

@@ -1,29 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "stack": "node",
-  "description": "Node.js / TypeScript test gap rules. Sources in *.ts/*.tsx/*.js/*.mjs; tests in *.test.* / *.spec.* / __tests__/.",
-  "sourceExtensions": [".ts", ".tsx", ".js", ".mjs", ".cjs"],
-  "testPathSuffixes": [
-    ".test.ts",
-    ".test.tsx",
-    ".test.js",
-    ".test.mjs",
-    ".spec.ts",
-    ".spec.tsx",
-    ".spec.js",
-    ".spec.mjs"
-  ],
-  "testPathContains": ["/__tests__/", "/test/", "/tests/"],
-  "excludePathGlobs": ["node_modules/", "dist/", "build/", ".next/", "coverage/", "*.d.ts"],
-  "publicApiPatterns": [
-    {
-      "id": "named_export",
-      "regex": "^export\\s+(?:async\\s+)?(?:function|class|const|let|interface|type|enum)\\s+([A-Za-z_$][A-Za-z0-9_$]*)"
-    },
-    {
-      "id": "default_export",
-      "regex": "^export\\s+default\\s+(?:async\\s+)?(?:function|class)\\s+([A-Za-z_$][A-Za-z0-9_$]*)"
-    }
-  ],
-  "hint": "Cover named exports with vitest/jest test('<name>', ...). React components: React Testing Library (render + screen + userEvent)."
-}

package/pipeline/scripts/test-gap-rules/python.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "stack": "python",
-  "description": "Python test gap rules. Sources in *.py; tests in test_*.py / *_test.py / tests/.",
-  "sourceExtensions": [".py"],
-  "testPathSuffixes": ["_test.py"],
-  "testPathPrefixes": ["test_"],
-  "testPathContains": ["/tests/", "/test/"],
-  "excludePathGlobs": [
-    "__pycache__/",
-    ".venv/",
-    "venv/",
-    ".tox/",
-    "build/",
-    "dist/",
-    "*.egg-info/",
-    "**/migrations/**"
-  ],
-  "publicApiPatterns": [
-    { "id": "top_def", "regex": "^def\\s+([a-z_][a-z0-9_]*)" },
-    { "id": "top_class", "regex": "^class\\s+([A-Z][A-Za-z0-9_]*)" },
-    { "id": "async_def", "regex": "^async\\s+def\\s+([a-z_][a-z0-9_]*)" }
-  ],
-  "hint": "Cover with pytest test_<symbol> style. Async with pytest-asyncio. Avoid name collision with private helpers (prefix _)."
-}

package/pipeline/scripts/validate-schemas.mjs

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-// Shallow schema sanity check for pipeline/schemas/*.schema.json.
-//
-// Zero dependencies  -  uses only Node.js built-ins. This keeps the shipped
-// npm package fully self-contained (no ajv / ajv-formats / anything).
-// CI runs this on every push; you can run it locally with:
-//
-//   node pipeline/scripts/validate-schemas.mjs
-//
-// Checks (enough to catch the regressions we care about):
-//   1. file parses as JSON
-//   2. declares $schema pointing at json-schema.org
-//   3. has $id, title, and type
-//   4. if type === "object", has properties
-//
-// For deeper structural correctness (type-aware compile, format validators,
-// cross-reference resolution), use ajv locally:
-//   npx ajv compile -s pipeline/schemas/agent-state.schema.json
-// We intentionally don't bundle ajv because this package must stay zero-dep.
-
-import { readdirSync, readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const schemaDir = join(here, "..", "schemas");
-
-function fail(file, reason) {
-  console.error(`FAIL: ${file}  -  ${reason}`);
-  return 1;
-}
-
-function pass(file) {
-  console.log(`PASS: ${file}`);
-  return 0;
-}
-
-function validate(file, schema) {
-  if (typeof schema !== "object" || schema === null) {
-    return fail(file, "top-level is not an object");
-  }
-  if (typeof schema.$schema !== "string" || !schema.$schema.includes("json-schema.org")) {
-    return fail(file, "missing or invalid $schema (expected a json-schema.org URL)");
-  }
-  if (typeof schema.$id !== "string" || !schema.$id) {
-    return fail(file, "missing $id");
-  }
-  if (typeof schema.title !== "string" || !schema.title) {
-    return fail(file, "missing title");
-  }
-  if (typeof schema.type !== "string") {
-    return fail(file, "missing type");
-  }
-  if (
-    schema.type === "object" &&
-    (typeof schema.properties !== "object" || schema.properties === null)
-  ) {
-    return fail(file, 'type is "object" but no properties block');
-  }
-  return pass(file);
-}
-
-let files;
-try {
-  files = readdirSync(schemaDir).filter((f) => f.endsWith(".schema.json"));
-} catch (err) {
-  console.error(`FAIL: cannot read schema directory ${schemaDir}  -  ${err.message}`);
-  process.exit(1);
-}
-
-if (files.length === 0) {
-  console.log("No schemas found under pipeline/schemas/  -  nothing to validate.");
-  process.exit(0);
-}
-
-let failCount = 0;
-for (const file of files) {
-  let schema;
-  try {
-    schema = JSON.parse(readFileSync(join(schemaDir, file), "utf-8"));
-  } catch (err) {
-    failCount += fail(file, `JSON parse error: ${err.message}`);
-    continue;
-  }
-  failCount += validate(file, schema);
-}
-
-process.exit(failCount === 0 ? 0 : 1);