@bonesofspring/ai-rules 0.2.23 → 0.2.24

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

@@ -411,7 +411,7 @@ 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\`.
+\`.claude/CLAUDE.md\`, \`.mavis/AGENTS.md\`, and \`.opencode/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.
@@ -422,13 +422,14 @@ owns those files.
 ## Cross-tool setup
 
 - Treat this file as the **shared** entry for any agent (Cursor, Claude Code,
-  Mavis / MiniMax Code, or other).
+  Mavis / MiniMax Code, OpenCode, 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
+npx @bonesofspring/ai-rules init opencode --preset next
 \`\`\`
 
 \`init\` overwrites this file from the preset (\`REPO_AGENTS.md\` → \`AGENTS.md\`).
@@ -476,16 +477,17 @@ After code edits: invoke **\`post-change-lint\`** (requestable). Full gate: agen
 | 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) |
+| OpenCode | \`.opencode/AGENTS.md\` (optional if OpenCode not installed) |
 
-Rules: \`.cursor/rules/\`, \`.claude/rules/\`, or \`.mavis/rules/\`.
-Skills: \`.cursor/skills/\`, \`.claude/skills/\`, or \`.mavis/skills/\`.
+Rules: \`.cursor/rules/\`, \`.claude/rules/\`, \`.mavis/rules/\`, or \`.opencode/rules/\`.
+Skills: \`.cursor/skills/\`, \`.claude/skills/\`, \`.mavis/skills/\`, or \`.opencode/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).
+**\`.cursor/team/conventions.md\`**, **\`.claude/team/conventions.md\`**,
+**\`.mavis/team/conventions.md\`**, and/or **\`.opencode/team/conventions.md\`**
+(fill after init; not overwritten on every dogfood sync when already present).
 
 ## Local overlay (\`.ai.local/\`) — MANDATORY