@bonesofspring/ai-rules 0.2.28 → 0.2.29

package/scripts/fixtures/cli-golden/opencode/svelte.json

@@ -22,7 +22,7 @@
     ".ai.local/team/fixtures/mockup-review-standalone.json": "edda49b1298e94f9a33496317e9f6ccbbb047659e044e05ba35669bfe800eda6",
     ".ai.local/team/fixtures/ux-design-standalone.json": "528aeb9db4c310d1b5e3eacae0ad39a4fd1dd49c04154b064e7027981488a07a",
     ".ai.local/team/tasks/.gitkeep": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
-    ".opencode/AGENTS.md": "4029dd11c8f36c589eef47490c816340df4c2f7594d644c950d47f20f76808cc",
+    ".opencode/AGENTS.md": "e52d6380b1d7c33dc0c819eb88b535ec28c4376016e0751e91877313de6bd0a2",
     ".opencode/MCP.md": "3a27ce1483e2c6df44a531556738558898f50a20e16450bea02f620c0ad84b54",
     ".opencode/agents/README.md": "8a9a4307b5326db65490cd73ff1e309d9bc8a678477d51b358b86dbc388d9b61",
     ".opencode/agents/accessibility-reviewer.md": "d659f901142486a3240262571f63ab1991565ab6d360f61efaf64028b4134a20",
@@ -82,7 +82,7 @@
     ".opencode/rules/post-change-lint.md": "3781dff4d33b8e9d6c34e0f027450c3d5f8c25a69a67a2e002552ab452bdbd69",
     ".opencode/rules/preset-layering.md": "c63d6b6aa921b70c6c9b531e9d9bcb8b3d81b6a6354da9e4109b5149f5cb8a73",
     ".opencode/rules/preset-no-cross-stack-leakage.md": "8933a929a78af3585c7b546736dc8d068bf9ff2f925c9fccbbdcf82d624d20a0",
-    ".opencode/rules/preset-pr-checklist.md": "6dcfb78d2cf68c11944243e3e4e10f6be210a4dad1497986f4aa439d1c04543f",
+    ".opencode/rules/preset-pr-checklist.md": "014c6bfb23b3db0ec5f46b5cbff8effe7126a1e680103f8e3cdbfaba280eabd3",
     ".opencode/rules/preset-token-budget.md": "d539545f8ab0dc6117f87c76c044fce9a01256d8cdea8a63b69ff48ccb8b7ac0",
     ".opencode/rules/preset-twin-sync.md": "b3061cbb09ff75ecb47e98b7f7fa351240866ee8962a1d128b7c15206ef89dee",
     ".opencode/rules/product-specs-authoring.md": "e355387117e689cd957ec02a0c7c306014f7a21cdcaf0e85f57858c12ad0911e",
@@ -116,7 +116,7 @@
     ".opencode/skills/unit-testing/SKILL.md": "c70f54921d0d90bd4d0f5305317e80dd3517a60b05f3fbc31dc8527eaf75d19d",
     ".opencode/skills/ux-design/SKILL.md": "dcfd7714f6e203eba18b14b334baa872696141ca257c87a72e8a7a45c4f4c91a",
     ".opencode/skills/write-adr/SKILL.md": "3daf61c8d97a7e868e5fe5323f1cfa76dd5b298ea5cb110a9da83884d8d602da",
-    "AGENTS.md": "16e16975c1054cd20df6aae7780d879f7477c6dc4144ed8f12dab9249ee3f580",
+    "AGENTS.md": "0f30e6c4a6c5d3b6cf6460e0e04f2f0c5af780dd98cf04b8e710f98321a87aac",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54",

package/scripts/lib/generate-mavis-adapter.mjs

@@ -166,13 +166,20 @@ Do not write \`~/.minimax/**\`.
 - Roles: \`mcode exec --file .mavis/agents/<role>.md --output-format json\`.
 - Commands: natural-language procedures in \`.mavis/commands/\`, or
   \`mcode exec --file .mavis/commands/task.md "<task>"\`.
-- After a producer receipt, run \`bash .mavis/hooks/chain-team-phases.sh\`.
+- After a producer receipt, run the chain by hand (\`projectHooks\` is \`manual\`, not auto-registered):
+  \`printf '%s\\n' '{"status":"completed"}' | bash .mavis/hooks/chain-team-phases.sh\`.
+  Procedures: \`mcode exec --file .mavis/commands/<name>.md\`. Roles: \`mcode exec --file .mavis/agents/<role>.md\`.
   Agents must not write lifecycle fields in \`status.json\` / \`metrics.json\`.
 
 ## Essential rules (read every turn)
 
 ${essential}
 
+Every turn, probe \`ls -la .ai.local\`, then apply \`.ai.local/rules/*.md\` and
+\`.ai.local/conventions.md\`. Acknowledge \`Using .ai.local: <rule-name>\`.
+Guide: \`docs/LOCAL-OVERLAY.md\`. These essential rules are a prompt contract.
+\`nativeProjectRules\` is \`unknown\` — do not claim engine \`alwaysApply\`.
+
 See \`.mavis/rules/README.md\` for the full catalog and loading strategy.
 
 ## Harness wiring
@@ -203,6 +210,8 @@ npx @bonesofspring/ai-rules init mavis --preset ${stack}
 Copies rules, commands, agents, hooks, skills, \`MAVIS.md\` → \`.mavis/AGENTS.md\`,
 \`MCP.md\`, \`mcp.json\` → \`.mavis/mcp.json\`, plus \`REPO_AGENTS.md\` → root \`AGENTS.md\`.
 Seeds \`.ai.local/team/\`.
+\`freshInit\` is \`unknown\`: \`mcode init\` is TTY-only and a live first \`init mavis\` is not verified.
+MCP mode is \`fallback-manual-import\`: import \`.mavis/mcp.json\` in the MiniMax Code UI. Do not write \`~/.minimax/**\`.
 ${skillsLine}
 `;
 }

package/scripts/lib/generate-opencode-adapter.mjs

@@ -272,13 +272,20 @@ Root \`AGENTS.md\` is native always-on. Read it first, then this file.
 - Other rules: lazy \`Read\` \`.opencode/rules/<stem>.md\` when the task matches.
 - Agents: native \`@name\` / Task from \`.opencode/agents/\`.
 - Commands: native \`/task\` from \`.opencode/commands/\`.
-- After a producer receipt, run \`bash .opencode/hooks/chain-team-phases.sh\`.
+- After a producer receipt, run the chain by hand (\`projectHooks\` is \`manual\`; this preset ships no plugin):
+  \`printf '%s\\n' '{"status":"completed"}' | bash .opencode/hooks/chain-team-phases.sh\`.
+  Slash commands are native (\`/task\` from \`.opencode/commands/\`). Do not assume \`SubagentStop\` auto-chain.
   Agents must not write lifecycle fields in \`status.json\` / \`metrics.json\`.
 
 ## Essential rules (read every turn)
 
 ${essential}
 
+Every turn, probe \`ls -la .ai.local\`, then apply \`.ai.local/rules/*.md\` and
+\`.ai.local/conventions.md\`. Acknowledge \`Using .ai.local: <rule-name>\`.
+Guide: \`docs/LOCAL-OVERLAY.md\`. These essential rules are a prompt contract.
+\`nativeProjectRules\` is \`no-equivalent\` — do not claim engine \`alwaysApply\`.
+
 See \`.opencode/rules/README.md\` for the full catalog and loading strategy.
 
 ## Harness wiring

package/scripts/sync-claude-settings.mjs

@@ -37,9 +37,34 @@ function buildClaudePermissions(bashPermission) {
 function sync(stack) {
   const profile = getStackProfile(stack);
   const permissions = buildClaudePermissions(profile.bashPermission);
+  const hookCommand = (script) =>
+    `\${CLAUDE_PROJECT_DIR}/.claude/hooks/${script}`;
   const settings = {
     $schema: 'https://json.schemastore.org/claude-code-settings.json',
     permissions,
+    hooks: {
+      PreToolUse: [
+        {
+          matcher: 'Bash',
+          hooks: [
+            {
+              type: 'command',
+              command: hookCommand('guard-shell-command.sh'),
+            },
+          ],
+        },
+      ],
+      SubagentStop: [
+        {
+          hooks: [
+            {
+              type: 'command',
+              command: hookCommand('chain-team-phases.sh'),
+            },
+          ],
+        },
+      ],
+    },
   };
   const dest = path.join(presetsRoot, 'claude', stack, 'settings.json');
   fs.mkdirSync(path.dirname(dest), { recursive: true });

package/scripts/sync-dogfood-claude.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# Sync monorepo dogfood root `.claude/` from Claude next preset (packages SoT).
+# Also syncs repo-root AGENTS.md from REPO_AGENTS.md and project `.mcp.json`.
+# Usage (from repo root or any cwd):
+#   ./packages/ai-rules/scripts/sync-dogfood-claude.sh
+#   AI_RULES_DOGFOOD_PRESET=ios-swift ./packages/ai-rules/scripts/sync-dogfood-claude.sh
+#
+# Note: this monorepo dogfood stays `next` (do not sync other released stacks here).
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+PRESET_NAME="${AI_RULES_DOGFOOD_PRESET:-next}"
+SRC="$ROOT/packages/ai-rules/presets/claude/$PRESET_NAME"
+DST="$ROOT/.claude"
+
+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 CLAUDE.md MCP.md settings.json README.md; do
+  if [[ -f "$SRC/$f" ]]; then
+    cp "$SRC/$f" "$DST/$f"
+  fi
+done
+
+if [[ -f "$SRC/REPO_AGENTS.md" ]]; then
+  cp "$SRC/REPO_AGENTS.md" "$ROOT/AGENTS.md"
+  echo "Copied REPO_AGENTS.md → $ROOT/AGENTS.md"
+fi
+
+# Claude init copies mcp.json to the project-root `.mcp.json` (not under .claude/).
+if [[ -f "$SRC/mcp.json" ]]; then
+  cp "$SRC/mcp.json" "$ROOT/.mcp.json"
+  echo "Copied mcp.json → $ROOT/.mcp.json"
+fi
+
+for dir in agents commands hooks rules skills; do
+  if [[ -d "$SRC/$dir" ]]; then
+    mkdir -p "$DST/$dir"
+    rsync -a --delete "$SRC/$dir/" "$DST/$dir/"
+  fi
+done
+
+if [[ -f "$DST/hooks/chain-team-phases.sh" ]]; then
+  chmod +x "$DST/hooks/chain-team-phases.sh"
+fi
+if [[ -f "$DST/hooks/guard-shell-command.sh" ]]; then
+  chmod +x "$DST/hooks/guard-shell-command.sh"
+fi
+
+node -e "
+const { seedAiLocalTeam } = require(process.argv[1]);
+seedAiLocalTeam({ cwd: process.argv[2], presetTeamSrc: process.argv[3] });
+" "$ROOT/packages/ai-rules/bin/lib/seed-ai-local-team.js" "$ROOT" "$SRC/team"
+
+echo "Done. Review: git status -- .claude/ AGENTS.md .mcp.json .ai.local/team"
+echo "Tip: run packages/ai-rules/scripts/check-shared-core-drift.sh after core edits."

package/scripts/test-mavis-orchestration.mjs

@@ -33,9 +33,10 @@ assert.equal(
   false,
   'Mavis must not ship hooks.json',
 );
-assert.equal(contract.nativeCapabilities.projectHooks.status, 'unknown');
+assert.equal(contract.nativeCapabilities.projectHooks.status, 'manual');
+assert.equal(contract.nativeCapabilities.freshInit.status, 'unknown');
 assert.equal(contract.mcp.mode, 'fallback-manual-import');
-console.log('ok P3 semi-auto: projectHooks unknown, no hooks.json');
+console.log('ok P3 semi-auto: projectHooks manual, freshInit unknown, no hooks.json');
 
 function readJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, 'utf8'));