@bonesofspring/ai-rules 0.2.23 → 0.2.24

package/scripts/lib/discover-hooks.mjs

@@ -10,6 +10,15 @@ export function loadReleasedMavisStacks(presetsRoot) {
   return Array.isArray(contract.releasedStacks) ? contract.releasedStacks : [];
 }
 
+export function loadReleasedOpencodeStacks(presetsRoot) {
+  const contractPath = path.join(presetsRoot, 'opencode', 'platform-contract.json');
+  if (!fs.existsSync(contractPath)) {
+    return [];
+  }
+  const contract = JSON.parse(fs.readFileSync(contractPath, 'utf8'));
+  return Array.isArray(contract.releasedStacks) ? contract.releasedStacks : [];
+}
+
 export function discoverChainHooks(presetsRoot) {
   const hooks = [];
   for (const platform of ['cursor', 'claude']) {
@@ -30,6 +39,12 @@ export function discoverChainHooks(presetsRoot) {
       hooks.push(hook);
     }
   }
+  for (const stack of loadReleasedOpencodeStacks(presetsRoot)) {
+    const hook = path.join(presetsRoot, 'opencode', stack, 'hooks', 'chain-team-phases.sh');
+    if (fs.existsSync(hook)) {
+      hooks.push(hook);
+    }
+  }
   return hooks;
 }
 
@@ -42,6 +57,9 @@ export function platformFromHook(hookPath) {
   if (hookPath.includes(`${path.sep}mavis${path.sep}`)) {
     return 'mavis';
   }
+  if (hookPath.includes(`${path.sep}opencode${path.sep}`)) {
+    return 'opencode';
+  }
   if (hookPath.includes(`${path.sep}cursor${path.sep}`)) {
     return 'cursor';
   }
@@ -66,7 +84,11 @@ export function expectedLegacyHookCount(presetsRoot) {
 }
 
 export function expectedHookCount(presetsRoot) {
-  return expectedLegacyHookCount(presetsRoot) + loadReleasedMavisStacks(presetsRoot).filter((stack) =>
+  const mavisCount = loadReleasedMavisStacks(presetsRoot).filter((stack) =>
     fs.existsSync(path.join(presetsRoot, 'mavis', stack, 'hooks', 'chain-team-phases.sh')),
   ).length;
+  const opencodeCount = loadReleasedOpencodeStacks(presetsRoot).filter((stack) =>
+    fs.existsSync(path.join(presetsRoot, 'opencode', stack, 'hooks', 'chain-team-phases.sh')),
+  ).length;
+  return expectedLegacyHookCount(presetsRoot) + mavisCount + opencodeCount;
 }

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,7 +9,7 @@ import { fileURLToPath } from 'node:url';
 const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageDirectory = path.resolve(scriptDirectory, '..');
 const presetsDirectory = path.join(packageDirectory, 'presets');
-import { discoverChainHooks, expectedHookCount, loadReleasedMavisStacks, platformFromHook } from './lib/discover-hooks.mjs';
+import { discoverChainHooks, expectedHookCount, loadReleasedMavisStacks, loadReleasedOpencodeStacks, platformFromHook } from './lib/discover-hooks.mjs';
 
 const hooks = discoverChainHooks(presetsDirectory);
 
@@ -424,6 +424,9 @@ for (const command of [
   ...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`);

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

@@ -44,7 +44,12 @@ assert.equal(
 
 // 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, 19, 'expected 19 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'));

package/scripts/test-cli-init-clean.mjs

@@ -236,6 +236,111 @@ if (!fs.existsSync(mavisGoldenPath)) {
   assert.deepEqual(mavisFiles, expectedMavis.files, 'mavis/next golden drifted');
 }
 
+const ocFresh = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-fresh-'));
+const ocInitOut = execFileSync(
+  process.execPath,
+  [cli, 'init', 'opencode', '--preset', 'next', '--cwd', ocFresh],
+  { encoding: 'utf8' },
+);
+assert.match(ocInitOut, /\.opencode installed/);
+assert.equal(fs.existsSync(path.join(ocFresh, 'AGENTS.md')), true);
+assert.equal(fs.existsSync(path.join(ocFresh, '.opencode', 'AGENTS.md')), true);
+assert.equal(fs.existsSync(path.join(ocFresh, '.opencode', 'rules', 'next-app-core.md')), true);
+assert.equal(fs.existsSync(path.join(ocFresh, '.opencode', 'hooks', 'chain-team-phases.sh')), true);
+assert.equal(fs.existsSync(path.join(ocFresh, 'opencode.json')), true);
+assert.equal(fs.existsSync(path.join(ocFresh, '.opencode', 'adapter-map.json')), false);
+assert.equal(fs.existsSync(path.join(ocFresh, 'docs', 'specs', 'INDEX.md')), true);
+const ocManifest = readJson(path.join(ocFresh, '.opencode', '.ai-rules-install.json'));
+assert.equal(ocManifest.schemaVersion, 1);
+assert.equal(ocManifest.platform, 'opencode');
+assert.equal(ocManifest.preset, 'next');
+assert.ok(ocManifest.managedFiles['AGENTS.md']);
+assert.ok(ocManifest.shippedMcpServerIds.includes('context7'));
+assert.equal(ocManifest.docsSeed.seeded, true);
+
+const ocAgents = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-agents-'));
+fs.writeFileSync(path.join(ocAgents, 'AGENTS.md'), '# consumer agents\n');
+runInit(cli, ocAgents, 'opencode', 'next');
+assert.match(fs.readFileSync(path.join(ocAgents, 'AGENTS.md'), 'utf8'), /OpenCode load map/);
+
+const ocSpecs = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-specs-'));
+fs.mkdirSync(path.join(ocSpecs, 'docs', 'specs'), { recursive: true });
+runInit(cli, ocSpecs, 'opencode', 'next');
+assert.equal(fs.existsSync(path.join(ocSpecs, 'docs', 'specs', 'INDEX.md')), false);
+assert.equal(
+  readJson(path.join(ocSpecs, '.opencode', '.ai-rules-install.json')).docsSeed.reason,
+  'directory-exists',
+);
+
+writeJson(path.join(ocFresh, 'opencode.json'), {
+  $schema: 'https://opencode.ai/config.json',
+  mcp: {
+    context7: {
+      type: 'local',
+      command: ['npx', '-y', '@upstash/context7-mcp@old'],
+      environment: { CONTEXT7_API_KEY: 'keep-me' },
+    },
+    storybook: { type: 'remote', url: 'http://localhost:6006/mcp' },
+  },
+  localOnly: true,
+});
+const ocRepeat = runInit(cli, ocFresh, 'opencode', 'next');
+assert.match(ocRepeat, /kept extra servers: storybook/);
+const ocMerged = readJson(path.join(ocFresh, 'opencode.json'));
+assert.equal(ocMerged.localOnly, true);
+assert.ok(ocMerged.mcp.storybook);
+assert.equal(ocMerged.mcp.context7.environment.CONTEXT7_API_KEY, 'keep-me');
+
+ocMerged.localNote = true;
+writeJson(path.join(ocFresh, 'opencode.json'), ocMerged);
+const ocModifiedRel = path.join(ocFresh, '.opencode', 'rules', 'next-app-core.md');
+fs.appendFileSync(ocModifiedRel, '\n# local overlay note\n');
+runClean(ocFresh, 'opencode');
+assert.equal(fs.existsSync(ocModifiedRel), true);
+assert.equal(fs.existsSync(path.join(ocFresh, '.opencode', '.ai-rules-install.json')), false);
+assert.equal(fs.existsSync(path.join(ocFresh, 'AGENTS.md')), false);
+assert.ok(readJson(path.join(ocFresh, 'opencode.json')).mcp.storybook);
+assert.equal(readJson(path.join(ocFresh, 'opencode.json')).mcp.context7, undefined);
+assert.equal(readJson(path.join(ocFresh, 'opencode.json')).localNote, true);
+
+const ocMissing = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-missing-'));
+fs.writeFileSync(path.join(ocMissing, 'keep.txt'), 'safe\n');
+const ocMissingClean = runCli(ocMissing, ['clean', 'opencode']);
+assert.equal(ocMissingClean.status, 1);
+assert.match(`${ocMissingClean.stderr}${ocMissingClean.stdout}`, /nothing removed/);
+assert.equal(fs.readFileSync(path.join(ocMissing, 'keep.txt'), 'utf8'), 'safe\n');
+
+const ocRollback = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-rollback-'));
+fs.writeFileSync(path.join(ocRollback, 'AGENTS.md'), '# prior\n');
+const ocFail = runCli(ocRollback, ['init', 'opencode', '--preset', 'next'], {
+  AI_RULES_OPENCODE_FAIL_PHASE: 'write',
+});
+assert.equal(ocFail.status, 1);
+assert.equal(fs.readFileSync(path.join(ocRollback, 'AGENTS.md'), 'utf8'), '# prior\n');
+assert.equal(fs.existsSync(path.join(ocRollback, '.opencode')), false);
+
+const ocUnreleased = runCli(ocFresh, ['init', 'opencode', '--preset', 'nuxt']);
+assert.equal(ocUnreleased.status, 1);
+assert.match(`${ocUnreleased.stderr}${ocUnreleased.stdout}`, /not released yet/i);
+
+const ocGoldenDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-rules-opencode-golden-'));
+runInit(cli, ocGoldenDir, 'opencode', 'next');
+const ocFiles = snapshotInstall(ocGoldenDir);
+delete ocFiles['.opencode/.ai-rules-install.json'];
+const ocGoldenPath = path.join(goldenRoot, 'opencode', 'next.json');
+if (!fs.existsSync(ocGoldenPath)) {
+  writeJson(ocGoldenPath, {
+    schemaVersion: 1,
+    tool: 'opencode',
+    preset: 'next',
+    files: ocFiles,
+  });
+} else {
+  const expectedOc = readJson(ocGoldenPath);
+  delete expectedOc.files['.opencode/.ai-rules-install.json'];
+  assert.deepEqual(ocFiles, expectedOc.files, 'opencode/next golden drifted');
+}
+
 for (const dir of [
   isolatedHome,
   fresh,
@@ -249,6 +354,12 @@ for (const dir of [
   failManifest,
   toolFirst,
   mavisGoldenDir,
+  ocFresh,
+  ocAgents,
+  ocSpecs,
+  ocMissing,
+  ocRollback,
+  ocGoldenDir,
 ]) {
   fs.rmSync(dir, { recursive: true, force: true });
 }

package/scripts/test-opencode-context-budget.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * P1 context budget: root AGENTS + .opencode/AGENTS combined nonempty lines ≤ 170.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadReleasedOpencodeStacks } from './lib/discover-hooks.mjs';
+
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const presetsRoot = path.join(scriptDirectory, '..', 'presets');
+const LINE_CAP = 170;
+const SENTINELS = [
+  'next-app-core',
+  'package-manager',
+  'code-quality-and-refactoring',
+  'ai-local-overlay',
+  '.opencode/AGENTS.md',
+  'status.json',
+];
+
+function nonemptyLines(text) {
+  return text.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+}
+
+const stacks = loadReleasedOpencodeStacks(presetsRoot);
+if (stacks.length === 0) {
+  console.log('ok opencode context-budget: no released stacks');
+  process.exit(0);
+}
+
+let failed = 0;
+for (const stack of stacks) {
+  const root = path.join(presetsRoot, 'opencode', stack);
+  const repoAgents = fs.readFileSync(path.join(root, 'REPO_AGENTS.md'), 'utf8');
+  const opencodeAgents = fs.readFileSync(path.join(root, 'OPENCODE.md'), 'utf8');
+  const combined = `${repoAgents}\n${opencodeAgents}`;
+  const count = nonemptyLines(repoAgents) + nonemptyLines(opencodeAgents);
+  if (count > LINE_CAP) {
+    console.error(`FAIL opencode/${stack}: entry nonempty lines ${count} > ${LINE_CAP}`);
+    failed += 1;
+  } else {
+    console.log(`ok opencode/${stack}: entry nonempty lines ${count} (cap ${LINE_CAP})`);
+  }
+  for (const sentinel of SENTINELS) {
+    if (!combined.includes(sentinel)) {
+      console.error(`FAIL opencode/${stack}: missing critical sentinel ${sentinel}`);
+      failed += 1;
+    }
+  }
+}
+
+process.exit(failed === 0 ? 0 : 1);