@bonesofspring/ai-rules 0.2.22 → 0.2.24

package/scripts/sync-dogfood-mavis.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Sync monorepo dogfood root `.mavis/` from Mavis next preset (packages SoT).
+# Also syncs repo-root AGENTS.md from REPO_AGENTS.md.
+# Usage (from repo root or any cwd):
+#   ./packages/ai-rules/scripts/sync-dogfood-mavis.sh
+#   AI_RULES_DOGFOOD_PRESET=next ./packages/ai-rules/scripts/sync-dogfood-mavis.sh
+#
+# Note: `.mavis/` is ai-rules-owned, not a MiniMax-native discovery path. Mavis
+# only ships `next` in `releasedStacks` (see presets/mavis/platform-contract.json).
+# Other stacks stay TBD until WP-F human gate.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+PRESET_NAME="${AI_RULES_DOGFOOD_PRESET:-next}"
+SRC="$ROOT/packages/ai-rules/presets/mavis/$PRESET_NAME"
+DST="$ROOT/.mavis"
+
+if [[ ! -d "$SRC" ]]; then
+  echo "error: preset not found: $SRC" >&2
+  exit 1
+fi
+
+echo "Dogfood sync: $SRC → $DST (preset=$PRESET_NAME)"
+
+mkdir -p "$DST"
+
+# Platform files at preset root
+for f in MAVIS.md MCP.md mcp.json README.md; do
+  if [[ -f "$SRC/$f" ]]; then
+    cp "$SRC/$f" "$DST/$f"
+  fi
+done
+
+# `.mavis/AGENTS.md` is the Mavis entry point (mirrors `.cursor/AGENTS.md`).
+if [[ -f "$SRC/MAVIS.md" && ! -f "$DST/AGENTS.md" ]]; then
+  cp "$SRC/MAVIS.md" "$DST/AGENTS.md"
+  echo "Seeded .mavis/AGENTS.md from MAVIS.md"
+fi
+
+# Repo-root AGENTS.md (cross-tool) from REPO_AGENTS.md
+if [[ -f "$SRC/REPO_AGENTS.md" ]]; then
+  cp "$SRC/REPO_AGENTS.md" "$ROOT/AGENTS.md"
+  echo "Copied REPO_AGENTS.md → $ROOT/AGENTS.md"
+fi
+
+# Directory trees (preserve local team/tasks)
+for dir in agents commands rules skills; do
+  if [[ -d "$SRC/$dir" ]]; then
+    mkdir -p "$DST/$dir"
+    rsync -a --delete "$SRC/$dir/" "$DST/$dir/"
+  fi
+done
+
+# Hooks: only chain-team-phases.sh is shipped; examples / hooks.json are
+# intentionally absent (see presets/mavis/next/adapter-map.json).
+if [[ -d "$SRC/hooks" ]]; then
+  mkdir -p "$DST/hooks"
+  rsync -a --delete "$SRC/hooks/" "$DST/hooks/"
+  if [[ -f "$DST/hooks/chain-team-phases.sh" ]]; then
+    chmod +x "$DST/hooks/chain-team-phases.sh"
+  fi
+fi
+
+if [[ -d "$SRC/team" ]]; then
+  mkdir -p "$DST/team"
+  # Sync fixtures + README; never delete local tasks/
+  if [[ -d "$SRC/team/fixtures" ]]; then
+    mkdir -p "$DST/team/fixtures"
+    rsync -a --delete "$SRC/team/fixtures/" "$DST/team/fixtures/"
+  fi
+  if [[ -f "$SRC/team/README.md" ]]; then
+    cp "$SRC/team/README.md" "$DST/team/README.md"
+  fi
+  if [[ -f "$SRC/team/.gitkeep" ]]; then
+    mkdir -p "$DST/team/tasks"
+    cp "$SRC/team/.gitkeep" "$DST/team/tasks/.gitkeep" 2>/dev/null || true
+  fi
+  # Living conventions: seed if absent; preserve consumer edits
+  if [[ -f "$SRC/team/conventions.md" ]]; then
+    if [[ ! -f "$DST/team/conventions.md" ]]; then
+      cp "$SRC/team/conventions.md" "$DST/team/conventions.md"
+      echo "Seeded team/conventions.md"
+    else
+      echo "Tip: skipped team/conventions.md (already present — living dogfood notes preserved)"
+    fi
+  fi
+fi
+
+echo "Done. Review: git status -- .mavis/ AGENTS.md"
+echo "Tip: run packages/ai-rules/scripts/check-shared-core-drift.sh after core edits."

package/scripts/sync-dogfood-opencode.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# Sync monorepo dogfood root `.opencode/` from OpenCode next preset (packages SoT).
+# Also syncs repo-root AGENTS.md from REPO_AGENTS.md.
+# Usage (from repo root or any cwd):
+#   ./packages/ai-rules/scripts/sync-dogfood-opencode.sh
+#   AI_RULES_DOGFOOD_PRESET=next ./packages/ai-rules/scripts/sync-dogfood-opencode.sh
+#
+# Note: OpenCode only ships `next` in `releasedStacks`.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+PRESET_NAME="${AI_RULES_DOGFOOD_PRESET:-next}"
+SRC="$ROOT/packages/ai-rules/presets/opencode/$PRESET_NAME"
+DST="$ROOT/.opencode"
+
+if [[ ! -d "$SRC" ]]; then
+  echo "error: preset not found: $SRC" >&2
+  exit 1
+fi
+
+echo "Dogfood sync: $SRC → $DST (preset=$PRESET_NAME)"
+
+mkdir -p "$DST"
+
+for f in OPENCODE.md MCP.md opencode.json README.md; do
+  if [[ -f "$SRC/$f" ]]; then
+    cp "$SRC/$f" "$DST/$f"
+  fi
+done
+
+if [[ -f "$SRC/OPENCODE.md" && ! -f "$DST/AGENTS.md" ]]; then
+  cp "$SRC/OPENCODE.md" "$DST/AGENTS.md"
+  echo "Seeded .opencode/AGENTS.md from OPENCODE.md"
+fi
+
+if [[ -f "$SRC/REPO_AGENTS.md" ]]; then
+  cp "$SRC/REPO_AGENTS.md" "$ROOT/AGENTS.md"
+  echo "Copied REPO_AGENTS.md → $ROOT/AGENTS.md"
+fi
+
+if [[ -f "$SRC/opencode.json" ]]; then
+  cp "$SRC/opencode.json" "$ROOT/opencode.json"
+  echo "Copied opencode.json → $ROOT/opencode.json"
+fi
+
+for dir in agents commands rules skills; do
+  if [[ -d "$SRC/$dir" ]]; then
+    mkdir -p "$DST/$dir"
+    rsync -a --delete "$SRC/$dir/" "$DST/$dir/"
+  fi
+done
+
+if [[ -d "$SRC/hooks" ]]; then
+  mkdir -p "$DST/hooks"
+  rsync -a --delete "$SRC/hooks/" "$DST/hooks/"
+  if [[ -f "$DST/hooks/chain-team-phases.sh" ]]; then
+    chmod +x "$DST/hooks/chain-team-phases.sh"
+  fi
+fi
+
+if [[ -d "$SRC/team" ]]; then
+  mkdir -p "$DST/team"
+  if [[ -d "$SRC/team/fixtures" ]]; then
+    mkdir -p "$DST/team/fixtures"
+    rsync -a --delete "$SRC/team/fixtures/" "$DST/team/fixtures/"
+  fi
+  if [[ -f "$SRC/team/README.md" ]]; then
+    cp "$SRC/team/README.md" "$DST/team/README.md"
+  fi
+  if [[ -f "$SRC/team/.gitkeep" ]]; then
+    mkdir -p "$DST/team/tasks"
+    cp "$SRC/team/.gitkeep" "$DST/team/tasks/.gitkeep" 2>/dev/null || true
+  fi
+  if [[ -f "$SRC/team/conventions.md" ]]; then
+    if [[ ! -f "$DST/team/conventions.md" ]]; then
+      cp "$SRC/team/conventions.md" "$DST/team/conventions.md"
+      echo "Seeded team/conventions.md"
+    else
+      echo "Tip: skipped team/conventions.md (already present — living dogfood notes preserved)"
+    fi
+  fi
+fi
+
+echo "Done. Review: git status -- .opencode/ AGENTS.md opencode.json"
+echo "Tip: run packages/ai-rules/scripts/check-shared-core-drift.sh after core edits."

package/scripts/test-agent-task-metrics-hooks.mjs

@@ -9,12 +9,15 @@ import { fileURLToPath } from 'node:url';
 const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageDirectory = path.resolve(scriptDirectory, '..');
 const presetsDirectory = path.join(packageDirectory, 'presets');
-const hooks = [
-  ...fs.readdirSync(path.join(presetsDirectory, 'cursor')).map((stack) => path.join(presetsDirectory, 'cursor', stack, 'hooks', 'chain-team-phases.sh')),
-  ...fs.readdirSync(path.join(presetsDirectory, 'claude')).map((stack) => path.join(presetsDirectory, 'claude', stack, 'hooks', 'chain-team-phases.sh')),
-];
+import { discoverChainHooks, expectedHookCount, loadReleasedMavisStacks, loadReleasedOpencodeStacks, platformFromHook } from './lib/discover-hooks.mjs';
 
-assert.equal(hooks.length, 20, 'expected every packaged Cursor and Claude hook (10 stacks × 2 platforms)');
+const hooks = discoverChainHooks(presetsDirectory);
+
+assert.equal(
+  hooks.length,
+  expectedHookCount(presetsDirectory),
+  `expected ${expectedHookCount(presetsDirectory)} packaged hooks`,
+);
 
 function readJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, 'utf8'));
@@ -55,7 +58,7 @@ function invokeHookAsync(hook, workingDirectory, attemptId) {
 }
 
 function writeTask(root, hook, slug, pipeline, status, metrics, artifacts = {}) {
-  const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+  const platform = platformFromHook(hook);
   const teamRoot = path.join(root, `.${platform}`, 'team');
   const taskDirectory = path.join(teamRoot, 'tasks', slug);
   fs.mkdirSync(taskDirectory, { recursive: true });
@@ -70,7 +73,7 @@ function writeTask(root, hook, slug, pipeline, status, metrics, artifacts = {})
 }
 
 function prepareTask(root, hook) {
-  const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+  const platform = platformFromHook(hook);
   const teamRoot = path.join(root, `.${platform}`, 'team');
   const taskDirectory = path.join(teamRoot, 'tasks', 'reverse-parallel');
   fs.mkdirSync(taskDirectory, { recursive: true });
@@ -162,7 +165,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-retry-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'serial-retry-run';
     const reviewerAttemptId = `${runId}:step-5:security-reviewer:attempt-1`;
     const taskDirectory = writeTask(
@@ -242,7 +245,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-no-chain-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'no-chain-run';
     const attemptId = `${runId}:step-0:feature-developer:attempt-1`;
     const taskDirectory = writeTask(
@@ -293,7 +296,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-mixed-parallel-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'mixed-parallel-run';
     const alphaAttemptId = `${runId}:step-1:code-reviewer:attempt-1`;
     const betaAttemptId = `${runId}:step-1:security-reviewer:attempt-1`;
@@ -360,7 +363,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-skip-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'skip-run';
     const starterAttemptId = `${runId}:step-0:starter:attempt-1`;
     const taskDirectory = writeTask(
@@ -418,6 +421,12 @@ for (const hook of hooks) {
 for (const command of [
   ...fs.readdirSync(path.join(presetsDirectory, 'cursor')).map((stack) => path.join(presetsDirectory, 'cursor', stack, 'commands', 'task-continue.md')),
   ...fs.readdirSync(path.join(presetsDirectory, 'claude')).map((stack) => path.join(presetsDirectory, 'claude', stack, 'commands', 'task-continue.md')),
+  ...loadReleasedMavisStacks(presetsDirectory).map((stack) =>
+    path.join(presetsDirectory, 'mavis', stack, 'commands', 'task-continue.md'),
+  ),
+  ...loadReleasedOpencodeStacks(presetsDirectory).map((stack) =>
+    path.join(presetsDirectory, 'opencode', stack, 'commands', 'task-continue.md'),
+  ),
 ]) {
   const source = fs.readFileSync(command, 'utf8');
   assert.match(source, /action":"end_human_gate"/, `${command}: must invoke installed hook end_human_gate action`);
@@ -436,7 +445,7 @@ for (const hook of hooks) {
   // pre-resume status → hook end_human_gate (no manual pipelineIndex++) → invoke from status.currentAgent.
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-gate-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const stack = path.basename(path.dirname(path.dirname(hook)));
     const presetCommand = path.join(path.dirname(path.dirname(hook)), 'commands', 'task-continue.md');
     const installedHook = path.join(root, `.${platform}`, 'hooks', 'chain-team-phases.sh');
@@ -510,7 +519,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-manifest-reconcile-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'manifest-reconcile-run';
     const reviewerAttemptId = `${runId}:step-1:code-reviewer:attempt-1`;
     const nowIso = '2026-01-01T00:00:00.000Z';
@@ -617,7 +626,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-blocked-receipt-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'blocked-receipt-run';
     const attemptId = `${runId}:step-0:feature-developer:attempt-1`;
     const startedAt = '2026-02-01T00:00:00.000Z';
@@ -708,7 +717,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-stale-receipt-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'stale-receipt-run';
     const attemptId = `${runId}:step-2:code-reviewer:attempt-2`;
     const startedAt = '2026-02-01T00:00:00.000Z';
@@ -903,7 +912,7 @@ for (const hook of hooks) {
 for (const hook of hooks) {
   const root = fs.mkdtempSync(path.join(packageDirectory, '.agent-task-metrics-lock-race-'));
   try {
-    const platform = hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+    const platform = platformFromHook(hook);
     const runId = 'lock-race-run';
     const attemptId = `${runId}:step-0:feature-developer:attempt-1`;
     const taskDirectory = writeTask(

package/scripts/test-chain-team-phases-coverage.mjs

@@ -32,16 +32,24 @@ const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageDirectory = path.resolve(scriptDirectory, '..');
 const presetsDirectory = path.join(packageDirectory, 'presets');
 
-const hooks = [
-  ...fs.readdirSync(path.join(presetsDirectory, 'cursor')).map((stack) => path.join(presetsDirectory, 'cursor', stack, 'hooks', 'chain-team-phases.sh')),
-  ...fs.readdirSync(path.join(presetsDirectory, 'claude')).map((stack) => path.join(presetsDirectory, 'claude', stack, 'hooks', 'chain-team-phases.sh')),
-];
+import { discoverChainHooks, expectedHookCount, platformFromHook } from './lib/discover-hooks.mjs';
 
-assert.equal(hooks.length, 20, `expected 20 packaged hooks (10 stacks × 2 platforms), got ${hooks.length}`);
+const hooks = discoverChainHooks(presetsDirectory);
+
+assert.equal(
+  hooks.length,
+  expectedHookCount(presetsDirectory),
+  `expected ${expectedHookCount(presetsDirectory)} packaged hooks, got ${hooks.length}`,
+);
 
 // mcp-ts does not ship openspec-author (per preset-no-cross-stack-leakage).
 const HOOKS_WITH_OPENSPEC = hooks.filter((hook) => !hook.includes(`${path.sep}mcp-ts${path.sep}`));
-assert.equal(HOOKS_WITH_OPENSPEC.length, 18, 'expected 18 hooks to cover openspec-author');
+const mcpTsHookCount = hooks.filter((hook) => hook.includes(`${path.sep}mcp-ts${path.sep}`)).length;
+assert.equal(
+  HOOKS_WITH_OPENSPEC.length,
+  hooks.length - mcpTsHookCount,
+  `expected ${hooks.length - mcpTsHookCount} hooks to cover openspec-author`,
+);
 
 function readJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, 'utf8'));
@@ -60,7 +68,7 @@ function invokeHook(hook, workingDirectory, attemptId, payload = {}) {
 }
 
 function platformFor(hook) {
-  return hook.includes(`${path.sep}cursor${path.sep}`) ? 'cursor' : 'claude';
+  return platformFromHook(hook);
 }
 
 function writeTask(root, hook, slug, pipeline, status, metrics, artifacts = {}) {