@bonesofspring/ai-rules 0.2.22 → 0.2.24

package/presets/opencode/next/team/fixtures/metrics-scenarios/tasks/serial-retry/metrics.json

@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": {
+    "runId": "serial-retry-run",
+    "slug": "serial-retry",
+    "preset": "ai-rules",
+    "stack": "next",
+    "platform": "cursor",
+    "intent": "feature",
+    "profile": "full"
+  },
+  "events": [
+    {
+      "eventId": "serial-retry-run:task",
+      "type": "task_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:2:code-reviewer:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "attemptId": "serial-retry-run:step-2:code-reviewer:attempt-1",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "code-reviewer",
+      "role": "review",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:2:code-reviewer:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T14:01:00.000Z",
+      "attemptId": "serial-retry-run:step-2:code-reviewer:attempt-1",
+      "outcome": "changes_requested",
+      "durationMs": 60000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:retry:1",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T14:01:00.000Z",
+      "attemptId": "serial-retry-run:step-2:code-reviewer:attempt-1",
+      "nextAgent": "feature-developer",
+      "retryAfterFix": "code-reviewer",
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:1:feature-developer:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T14:01:00.000Z",
+      "attemptId": "serial-retry-run:step-1:feature-developer:attempt-1",
+      "stepIndex": 1,
+      "stepLabel": null,
+      "agent": "feature-developer",
+      "role": "implementation",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:1:feature-developer:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T14:03:00.000Z",
+      "attemptId": "serial-retry-run:step-1:feature-developer:attempt-1",
+      "outcome": "completed",
+      "durationMs": 120000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:retry:2",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T14:03:00.000Z",
+      "attemptId": "serial-retry-run:step-1:feature-developer:attempt-1",
+      "nextAgent": "code-reviewer",
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:2:code-reviewer:2:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T14:03:00.000Z",
+      "attemptId": "serial-retry-run:step-2:code-reviewer:attempt-2",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "code-reviewer",
+      "role": "review",
+      "attempt": 2,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:2:code-reviewer:2:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T14:04:00.000Z",
+      "attemptId": "serial-retry-run:step-2:code-reviewer:attempt-2",
+      "outcome": "completed",
+      "durationMs": 60000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "serial-retry-run:done",
+      "type": "task_completed",
+      "at": "2026-07-31T14:04:00.000Z",
+      "outcome": "completed",
+      "source": "hook",
+      "attributionConfidence": "high"
+    }
+  ]
+}

package/presets/opencode/next/team/fixtures/metrics-scenarios/tasks/validation-failed/metrics.json

@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": {
+    "runId": "validation-failed-run",
+    "slug": "validation-failed",
+    "preset": "ai-rules",
+    "stack": "next",
+    "platform": "cursor",
+    "intent": "feature",
+    "profile": "full"
+  },
+  "events": [
+    {
+      "eventId": "validation-failed-run:task",
+      "type": "task_started",
+      "at": "2026-07-31T15:00:00.000Z",
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:00:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "build-verifier",
+      "role": "validation",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "outcome": "validation_failed",
+      "durationMs": 120000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:retry:1",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "nextAgent": "feature-developer",
+      "retryAfterFix": "build-verifier",
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:1:feature-developer:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "stepIndex": 1,
+      "stepLabel": null,
+      "agent": "feature-developer",
+      "role": "implementation",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:1:feature-developer:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "outcome": "completed",
+      "durationMs": 180000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:retry:2",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "nextAgent": "build-verifier",
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:2:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-2",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "build-verifier",
+      "role": "validation",
+      "attempt": 2,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:2:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:06:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-2",
+      "outcome": "completed",
+      "durationMs": 60000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:done",
+      "type": "task_completed",
+      "at": "2026-07-31T15:06:00.000Z",
+      "outcome": "completed",
+      "source": "hook",
+      "attributionConfidence": "high"
+    }
+  ]
+}

package/presets/opencode/next/team/fixtures/metrics.example.json

@@ -0,0 +1,54 @@
+{
+  "schemaVersion": 1,
+  "task": {
+    "runId": "example-run-1",
+    "slug": "example-feature-full",
+    "preset": "ai-rules",
+    "stack": "next",
+    "platform": "cursor",
+    "intent": "feature",
+    "profile": "full"
+  },
+  "events": [
+    {
+      "eventId": "example-run-1:task_started",
+      "type": "task_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:attempt-1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "attemptId": "example-run-1:step-0:task-analyst:attempt-1",
+      "stepIndex": 0,
+      "stepLabel": "Clarify and decompose",
+      "agent": "task-analyst",
+      "role": "planning",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:attempt-1:end",
+      "type": "attempt_finished",
+      "at": "2026-07-31T14:02:00.000Z",
+      "attemptId": "example-run-1:step-0:task-analyst:attempt-1",
+      "outcome": "completed",
+      "durationMs": 120000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:task_completed",
+      "type": "task_completed",
+      "at": "2026-07-31T14:02:00.000Z",
+      "outcome": "completed",
+      "source": "hook",
+      "attributionConfidence": "high"
+    }
+  ]
+}

package/presets/opencode/next/team/fixtures/mockup-review-fail-embedded-status.json

@@ -0,0 +1,8 @@
+{
+  "slug": "example-mockup-fail-gate",
+  "state": "awaiting_approval",
+  "currentAgent": "mockup-reviewer",
+  "awaitingHumanGate": true,
+  "retryAfterFix": null,
+  "note": "Embedded mockup FAIL: hook must NOT set retryAfterFix to feature-developer. Resume only via /task-continue."
+}

package/presets/opencode/next/team/fixtures/mockup-review-standalone.json

@@ -0,0 +1,14 @@
+{
+  "slug": "example-mockup-review-standalone",
+  "intent": "mockup-review",
+  "profile": "light",
+  "summary": "Standalone Figma mockup review (report-only)",
+  "steps": [
+    { "agent": "mockup-reviewer", "label": "Figma mockup review", "model": "strong" }
+  ],
+  "humanGates": [],
+  "autoChain": true,
+  "skipped": [
+    { "agent": "feature-developer", "reason": "Standalone mockup-review is report-only" }
+  ]
+}

package/presets/opencode/next/team/fixtures/ux-design-standalone.json

@@ -0,0 +1,15 @@
+{
+  "slug": "example-ux-design-standalone",
+  "intent": "ux-design",
+  "profile": "light",
+  "summary": "Standalone behavioral UX design (analyst + skill ux-design; report-only; no developer)",
+  "steps": [
+    { "agent": "task-analyst", "label": "UX design (skill ux-design)" }
+  ],
+  "humanGates": [],
+  "autoChain": true,
+  "skipped": [
+    { "agent": "feature-developer", "reason": "Standalone ux-design is report-only" },
+    { "agent": "mockup-reviewer", "reason": "No figma.com URL; not a mockup review" }
+  ]
+}

package/presets/opencode/platform-contract.json

@@ -0,0 +1,131 @@
+{
+  "schemaVersion": 1,
+  "id": "opencode",
+  "runtimeExecutable": "opencode",
+  "sourceRoot": "presets/opencode",
+  "managedRoot": ".opencode",
+  "releasedStacks": ["next"],
+  "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/capture-cli-golden.mjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Capture init file-tree goldens. Run before and after CLI refactors.
+ *
+ *   node scripts/capture-cli-golden.mjs cursor next
+ *   node scripts/capture-cli-golden.mjs claude next
+ *   node scripts/capture-cli-golden.mjs mavis next
+ *   node scripts/capture-cli-golden.mjs opencode next
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { goldenDocument, runInit, snapshotInstall } from './lib/cli-golden.mjs';
+
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const packageDirectory = path.resolve(scriptDirectory, '..');
+const cli = path.join(packageDirectory, 'bin', 'cli.js');
+
+const tool = process.argv[2];
+const preset = process.argv[3] || 'next';
+if (!tool) {
+  console.error('Usage: node scripts/capture-cli-golden.mjs <cursor|claude|mavis|opencode> [preset]');
+  process.exit(1);
+}
+
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), `ai-rules-golden-${tool}-`));
+try {
+  runInit(cli, tmp, tool, preset);
+  const files = snapshotInstall(tmp);
+  if (tool === 'mavis') {
+    delete files['.mavis/.ai-rules-install.json'];
+  }
+  if (tool === 'opencode') {
+    delete files['.opencode/.ai-rules-install.json'];
+  }
+  const golden = goldenDocument({
+    tool,
+    preset,
+    files,
+  });
+  const dest = path.join(scriptDirectory, 'fixtures', 'cli-golden', tool, `${preset}.json`);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.writeFileSync(dest, `${JSON.stringify(golden, null, 2)}\n`);
+  console.log(`wrote ${path.relative(packageDirectory, dest)} (${Object.keys(golden.files).length} files)`);
+} finally {
+  fs.rmSync(tmp, { recursive: true, force: true });
+}

package/scripts/check-chain-hook-coverage.sh

@@ -45,6 +45,8 @@ STACKS_WITH_OPENSPEC = {
     ("claude", "php-hexagonal"),
     ("claude", "php-laravel"),
     ("claude", "svelte"),
+    ("mavis", "next"),
+    ("opencode", "next"),
 }
 
 # Agents used only outside the pipeline (no chain hook entry expected).