@bonesofspring/ai-rules 0.2.23 → 0.2.25

package/scripts/fixtures/opencode-platform-contract/invalid-released-unknown-stack.json

@@ -0,0 +1,133 @@
+{
+  "schemaVersion": 1,
+  "id": "opencode",
+  "runtimeExecutable": "opencode",
+  "sourceRoot": "presets/opencode",
+  "managedRoot": ".opencode",
+  "releasedStacks": [
+    "not-a-stack"
+  ],
+  "entryFiles": [
+    {
+      "source": "REPO_AGENTS.md",
+      "destination": "AGENTS.md"
+    },
+    {
+      "source": "OPENCODE.md",
+      "destination": ".opencode/AGENTS.md"
+    }
+  ],
+  "directoryMappings": [
+    {
+      "source": "rules",
+      "destination": ".opencode/rules"
+    },
+    {
+      "source": "agents",
+      "destination": ".opencode/agents"
+    },
+    {
+      "source": "skills",
+      "destination": ".opencode/skills"
+    },
+    {
+      "source": "commands",
+      "destination": ".opencode/commands"
+    },
+    {
+      "source": "hooks",
+      "destination": ".opencode/hooks"
+    },
+    {
+      "source": "team",
+      "destination": ".opencode/team"
+    }
+  ],
+  "mcp": {
+    "source": "opencode.json",
+    "fallbackDestination": "opencode.json",
+    "mode": "merge-opencode-json"
+  },
+  "docsSeed": {
+    "source": "presets/_shared/assets/docs-specs",
+    "behavior": "absent-only"
+  },
+  "cleanStrategy": "manifest-owned",
+  "nativeCapabilities": {
+    "cliVersion": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "rootAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "explicitAgentFile": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "structuredOutput": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "referencedRule": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "referencedSkill": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "freshInit": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeProjectRules": {
+      "status": "no-equivalent",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeWorkspaceSkills": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "nativeWorkspaceAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "projectMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "projectHooks": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "slashCommands": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/commands"
+    },
+    "pluginSkillMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "nativeTeam": {
+      "status": "partial",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/team"
+    }
+  }
+}

package/scripts/fixtures/opencode-platform-contract/invalid-unknown-native-path.json

@@ -0,0 +1,131 @@
+{
+  "schemaVersion": 1,
+  "id": "opencode",
+  "runtimeExecutable": "opencode",
+  "sourceRoot": "presets/opencode",
+  "managedRoot": ".opencode",
+  "releasedStacks": [],
+  "entryFiles": [
+    {
+      "source": "REPO_AGENTS.md",
+      "destination": "AGENTS.md"
+    },
+    {
+      "source": "OPENCODE.md",
+      "destination": ".opencode/AGENTS.md"
+    }
+  ],
+  "directoryMappings": [
+    {
+      "source": "rules",
+      "destination": ".opencode/rules"
+    },
+    {
+      "source": "agents",
+      "destination": ".opencode/agents"
+    },
+    {
+      "source": "skills",
+      "destination": ".opencode/skills"
+    },
+    {
+      "source": "commands",
+      "destination": ".opencode/commands"
+    },
+    {
+      "source": "hooks",
+      "destination": ".opencode/hooks"
+    },
+    {
+      "source": "team",
+      "destination": ".opencode/team"
+    }
+  ],
+  "mcp": {
+    "source": "opencode.json",
+    "fallbackDestination": "opencode.json",
+    "mode": "merge-opencode-json"
+  },
+  "docsSeed": {
+    "source": "presets/_shared/assets/docs-specs",
+    "behavior": "absent-only"
+  },
+  "cleanStrategy": "manifest-owned",
+  "nativeCapabilities": {
+    "cliVersion": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "rootAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "explicitAgentFile": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "structuredOutput": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "referencedRule": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "referencedSkill": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "freshInit": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeProjectRules": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "docs/imagined-native-rules"
+    },
+    "nativeWorkspaceSkills": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "nativeWorkspaceAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "projectMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "projectHooks": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "slashCommands": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/commands"
+    },
+    "pluginSkillMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "nativeTeam": {
+      "status": "partial",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/team"
+    }
+  }
+}

package/scripts/fixtures/opencode-platform-contract/invalid-version-pin.json

@@ -0,0 +1,132 @@
+{
+  "schemaVersion": 1,
+  "id": "opencode",
+  "runtimeExecutable": "opencode",
+  "sourceRoot": "presets/opencode",
+  "managedRoot": ".opencode",
+  "releasedStacks": [],
+  "entryFiles": [
+    {
+      "source": "REPO_AGENTS.md",
+      "destination": "AGENTS.md"
+    },
+    {
+      "source": "OPENCODE.md",
+      "destination": ".opencode/AGENTS.md"
+    }
+  ],
+  "directoryMappings": [
+    {
+      "source": "rules",
+      "destination": ".opencode/rules"
+    },
+    {
+      "source": "agents",
+      "destination": ".opencode/agents"
+    },
+    {
+      "source": "skills",
+      "destination": ".opencode/skills"
+    },
+    {
+      "source": "commands",
+      "destination": ".opencode/commands"
+    },
+    {
+      "source": "hooks",
+      "destination": ".opencode/hooks"
+    },
+    {
+      "source": "team",
+      "destination": ".opencode/team"
+    }
+  ],
+  "mcp": {
+    "source": "opencode.json",
+    "fallbackDestination": "opencode.json",
+    "mode": "merge-opencode-json"
+  },
+  "docsSeed": {
+    "source": "presets/_shared/assets/docs-specs",
+    "behavior": "absent-only"
+  },
+  "cleanStrategy": "manifest-owned",
+  "nativeCapabilities": {
+    "cliVersion": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "rootAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "explicitAgentFile": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "structuredOutput": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "referencedRule": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "referencedSkill": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "freshInit": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeProjectRules": {
+      "status": "no-equivalent",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeWorkspaceSkills": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "nativeWorkspaceAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "projectMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "projectHooks": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "slashCommands": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/commands"
+    },
+    "pluginSkillMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "nativeTeam": {
+      "status": "partial",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/team"
+    }
+  },
+  "requiredCliVersion": "1.0.0"
+}

package/scripts/fixtures/opencode-platform-contract/valid.json

@@ -0,0 +1,131 @@
+{
+  "schemaVersion": 1,
+  "id": "opencode",
+  "runtimeExecutable": "opencode",
+  "sourceRoot": "presets/opencode",
+  "managedRoot": ".opencode",
+  "releasedStacks": [],
+  "entryFiles": [
+    {
+      "source": "REPO_AGENTS.md",
+      "destination": "AGENTS.md"
+    },
+    {
+      "source": "OPENCODE.md",
+      "destination": ".opencode/AGENTS.md"
+    }
+  ],
+  "directoryMappings": [
+    {
+      "source": "rules",
+      "destination": ".opencode/rules"
+    },
+    {
+      "source": "agents",
+      "destination": ".opencode/agents"
+    },
+    {
+      "source": "skills",
+      "destination": ".opencode/skills"
+    },
+    {
+      "source": "commands",
+      "destination": ".opencode/commands"
+    },
+    {
+      "source": "hooks",
+      "destination": ".opencode/hooks"
+    },
+    {
+      "source": "team",
+      "destination": ".opencode/team"
+    }
+  ],
+  "mcp": {
+    "source": "opencode.json",
+    "fallbackDestination": "opencode.json",
+    "mode": "merge-opencode-json"
+  },
+  "docsSeed": {
+    "source": "presets/_shared/assets/docs-specs",
+    "behavior": "absent-only"
+  },
+  "cleanStrategy": "manifest-owned",
+  "nativeCapabilities": {
+    "cliVersion": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "rootAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "explicitAgentFile": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "structuredOutput": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "referencedRule": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "AGENTS.md"
+    },
+    "referencedSkill": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "freshInit": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeProjectRules": {
+      "status": "no-equivalent",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "nativeWorkspaceSkills": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/skills"
+    },
+    "nativeWorkspaceAgents": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/agents"
+    },
+    "projectMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "projectHooks": {
+      "status": "unknown",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": null
+    },
+    "slashCommands": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/commands"
+    },
+    "pluginSkillMcp": {
+      "status": "confirmed",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": "opencode.json"
+    },
+    "nativeTeam": {
+      "status": "partial",
+      "evidence": "docs/OPENCODE-COMPATIBILITY.md",
+      "nativePath": ".opencode/team"
+    }
+  }
+}

package/scripts/generate-mavis-next.mjs

@@ -231,15 +231,15 @@ function main() {
 
     if (source === 'REPO_AGENTS.md') {
       const target = 'REPO_AGENTS.md';
-      writeFile(target, buildRepoAgents(sourceText));
+      writeFile(target, sourceText);
       entries.push(
         entry({
           source,
           target,
           category: 'entry',
-          disposition: 'transform',
+          disposition: 'copy',
           loadMode: 'root-entry',
-          reason: 'Root AGENTS.md compatibility floor plus explicit .mavis/AGENTS.md pointer',
+          reason: 'Canonical cross-tool root AGENTS.md; identical for all platforms',
           sourceText,
         }),
       );
@@ -407,104 +407,6 @@ function dropLeadingHeading(text) {
     .replace(/^Short Cursor entry point\.[^\n]*\n+/, '');
 }
 
-function buildRepoAgents(_sourceText) {
-  return `# Next.js — agent instructions
-
-Cross-tool repo-root guide. Tool-specific maps stay under \`.cursor/AGENTS.md\`,
-\`.claude/CLAUDE.md\`, and \`.mavis/AGENTS.md\`.
-
-**.mavis/** is an ai-rules-owned namespace, not a MiniMax-native discovery path.
-When this Mavis preset is installed, read \`.mavis/AGENTS.md\` on every turn.
-Do not write \`~/.minimax/**\`. Do not mutate
-\`.mavis/team/tasks/<slug>/status.json\` or \`metrics.json\` — the chain runner
-owns those files.
-
-## Cross-tool setup
-
-- Treat this file as the **shared** entry for any agent (Cursor, Claude Code,
-  Mavis / MiniMax Code, or other).
-- Install:
-
-\`\`\`bash
-npx @bonesofspring/ai-rules init cursor --preset next
-npx @bonesofspring/ai-rules init claude --preset next
-npx @bonesofspring/ai-rules init mavis --preset next
-\`\`\`
-
-\`init\` overwrites this file from the preset (\`REPO_AGENTS.md\` → \`AGENTS.md\`).
-Living gotchas belong in \`team/conventions.md\`, not here.
-
-## Mavis compatibility entry
-
-After install, also read:
-
-- \`.mavis/AGENTS.md\` — Mavis load map, roles, and procedures
-- \`.mavis/rules/next-app-core.md\`
-- \`.mavis/rules/package-manager.md\`
-- \`.mavis/rules/code-quality-and-refactoring.md\`
-- \`.mavis/rules/ai-local-overlay.md\`
-
-Launch roles with \`mcode exec --file .mavis/agents/<role>.md\`. Start work with
-the task procedure in \`.mavis/commands/task.md\`.
-
-## Commands (test / lint / build)
-
-Working directory for app scripts: **\`app/\`**. Detect the package manager from
-lockfile / \`packageManager\` (\`package-manager\` rule).
-
-| Gate | Typical command |
-|------|-----------------|
-| Lint JS | \`yarn lint:js\` (or project equivalent) from \`app/\` |
-| Lint CSS | \`yarn lint:css\` from \`app/\` |
-| Unit tests | project unit script under \`app/\` |
-| Build | project \`build\` under \`app/\` |
-
-After code edits: invoke **\`post-change-lint\`** (requestable). Full gate: agent
-\`build-verifier\`.
-
-## Security basics
-
-- Do not commit secrets (\`.env\`, tokens, credentials).
-- Review destructive git (\`reset --hard\`, force-push) before running; respect
-  shell hooks.
-- Do not weaken CI or skip hooks unless the user explicitly asks.
-
-## Tool entry points
-
-| Tool | Map |
-|------|-----|
-| Cursor | \`.cursor/AGENTS.md\` (optional if Cursor not installed) |
-| Claude Code | \`.claude/CLAUDE.md\` (optional if Claude Code not installed) |
-| Mavis | \`.mavis/AGENTS.md\` (optional if Mavis not installed) |
-
-Rules: \`.cursor/rules/\`, \`.claude/rules/\`, or \`.mavis/rules/\`.
-Skills: \`.cursor/skills/\`, \`.claude/skills/\`, or \`.mavis/skills/\`.
-
-## Living conventions
-
-Gotchas, local patterns, and team decisions:
-**\`.cursor/team/conventions.md\`**, **\`.claude/team/conventions.md\`**, and/or
-**\`.mavis/team/conventions.md\`** (fill after init; not overwritten on every
-dogfood sync when already present).
-
-## Local overlay (\`.ai.local/\`) — MANDATORY
-
-A \`.ai.local/\` directory MAY exist at the repo root or at any nesting depth in
-monorepos. **All agents MUST read and apply it on every turn.** Rules there
-override preset rules; in conflicts, the local rule wins.
-\`override: kill <preset-rule-name>\` drops the named preset rule from the
-agent's context entirely.
-
-Plain markdown rules under \`.ai.local/rules/*.md\` are read by the agent with
-higher priority than preset rules. Living gotchas live in
-\`.ai.local/conventions.md\`.
-
-Authoring guide: \`docs/LOCAL-OVERLAY.md\` in the \`@bonesofspring/ai-rules\`
-package. The \`ai-local-overlay\` rule is the mechanism; this \`MANDATORY\`
-section is the reinforcement.
-`;
-}
-
 function stripInstallSection(body) {
   const index = body.search(/^## Install\r?\n/m);
   if (index < 0) {
@@ -533,6 +435,7 @@ under \`.mavis/skills/**\`. This file is ai-rules-owned (\`.mavis/AGENTS.md\`),
 not a MiniMax-reserved filename.
 
 Root \`AGENTS.md\` is the compatibility floor. Read it first, then this file.
+Do not write \`~/.minimax/**\`.
 
 ## How to load