tribunal-kit 8.0.0 → 9.0.0

package/.opencode/INSTALL.md

@@ -0,0 +1,41 @@
+# Installing Tribunal Kit for OpenCode
+
+## Prerequisites
+
+- [OpenCode.ai](https://opencode.ai) installed
+
+## Installation
+
+Add Tribunal Kit to the `plugin` array in your `opencode.json` (global or project-level):
+
+```json
+{
+  "plugin": ["tribunal-kit@latest"]
+}
+```
+
+Or install from git:
+
+```json
+{
+  "plugin": ["tribunal-kit@git+https://github.com/sunrise/tribunal-kit.git"]
+}
+```
+
+Restart OpenCode. The plugin registers all 184 Tribunal skills and auto-injects Master Governance rules on session start.
+
+## Usage
+
+Use OpenCode's native `skill` tool:
+
+```
+use skill tool to list skills
+use skill tool to load tdd-workflow
+use skill tool to load verification-before-completion
+```
+
+## Subagent-Driven Development (SDD)
+
+OpenCode delegates tasks to subagents via the `task` tool:
+- Implementers execute tasks following `.tribunal/sdd/<plan>/task-<N>-brief.md`.
+- Reviewers evaluate diffs via `tk sdd diff` out-of-band.

package/.opencode/plugins/tribunal.js

@@ -0,0 +1,101 @@
+/**
+ * Tribunal Kit plugin for OpenCode.ai
+ *
+ * Injects Tribunal Master Governance bootstrap context via message transform.
+ * Auto-registers skills directory via config hook (no symlinks needed).
+ */
+
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const extractAndStripFrontmatter = (content) => {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, content };
+
+  const frontmatterStr = match[1];
+  const body = match[2];
+  const frontmatter = {};
+
+  for (const line of frontmatterStr.split('\n')) {
+    const colonIdx = line.indexOf(':');
+    if (colonIdx > 0) {
+      const key = line.slice(0, colonIdx).trim();
+      const value = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, '');
+      frontmatter[key] = value;
+    }
+  }
+
+  return { frontmatter, content: body };
+};
+
+let _bootstrapCache = undefined;
+
+export const TribunalPlugin = async ({ client: _client, directory: _directory } = {}) => {
+  const packageRoot = path.resolve(__dirname, '../..');
+  const tribunalSkillsDir = path.join(packageRoot, '.agent', 'skills');
+  const rulesPath = path.join(packageRoot, '.agent', 'rules', 'GEMINI.md');
+
+  const getBootstrapContent = () => {
+    if (_bootstrapCache !== undefined) return _bootstrapCache;
+
+    let rulesContent = '';
+    if (fs.existsSync(rulesPath)) {
+      const raw = fs.readFileSync(rulesPath, 'utf8');
+      const { content } = extractAndStripFrontmatter(raw);
+      rulesContent = content;
+    } else {
+      rulesContent = '# Tribunal Kit Master Governance Active\nEnforce strict TDD, out-of-band reviews, and 28-specialist waves.';
+    }
+
+    const toolMapping = `**Tool Mapping for OpenCode:**
+When skills or tribunal workflows request actions, map them to OpenCode tools:
+- Create or update tasks/todos → \`todowrite\`
+- Subagent dispatches → \`task\` with \`subagent_type: "general"\` (or \`"explore"\` for read-only exploration)
+- Invoke a skill → OpenCode's native \`skill\` tool
+- Read files → \`read\`
+- Create, edit, or delete files → \`apply_patch\`
+- Run shell commands → \`bash\`
+- Search files → \`grep\`, \`glob\`
+- Fetch a URL → \`webfetch\`
+- Tribunal SDD commands → run via \`bash\` (\`tk sdd brief\`, \`tk sdd diff\`)`;
+
+    _bootstrapCache = `<EXTREMELY_IMPORTANT>
+Tribunal Kit Master Governance is active.
+
+**IMPORTANT: The master governance rules and verification protocols are loaded for this session. Follow them strictly.**
+
+${rulesContent}
+
+${toolMapping}
+</EXTREMELY_IMPORTANT>`;
+
+    return _bootstrapCache;
+  };
+
+  return {
+    config: async (config) => {
+      config.skills = config.skills || {};
+      config.skills.paths = config.skills.paths || [];
+      if (!config.skills.paths.includes(tribunalSkillsDir)) {
+        config.skills.paths.push(tribunalSkillsDir);
+      }
+    },
+
+    'experimental.chat.messages.transform': async (_input, output) => {
+      const bootstrap = getBootstrapContent();
+      if (!bootstrap || !output.messages || !output.messages.length) return;
+      const firstUser = output.messages.find(m => m.info && m.info.role === 'user');
+      if (!firstUser || !firstUser.parts || !firstUser.parts.length) return;
+
+      if (firstUser.parts.some(p => p.type === 'text' && p.text && p.text.includes('EXTREMELY_IMPORTANT'))) return;
+
+      const ref = firstUser.parts[0];
+      firstUser.parts.unshift({ ...ref, type: 'text', text: bootstrap });
+    }
+  };
+};
+
+export default TribunalPlugin;

package/.pi/extensions/tribunal.ts

@@ -0,0 +1,133 @@
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export interface ExtensionAPI {
+  on(event: string, handler: (payload?: any) => Promise<any> | any): void;
+}
+
+const EXTREMELY_IMPORTANT_MARKER = "<EXTREMELY_IMPORTANT>";
+const BOOTSTRAP_MARKER = "tribunal-kit:master-governance bootstrap for pi";
+
+const extensionDir = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(extensionDir, "../..");
+const skillsDir = resolve(packageRoot, ".agent", "skills");
+const rulesPath = resolve(packageRoot, ".agent", "rules", "GEMINI.md");
+
+let cachedBootstrap: string | null | undefined;
+
+export default function tribunalPiExtension(pi: ExtensionAPI) {
+  let injectBootstrap = true;
+
+  pi.on("resources_discover", async () => ({
+    skillPaths: [skillsDir],
+  }));
+
+  pi.on("session_start", async () => {
+    injectBootstrap = true;
+  });
+
+  pi.on("session_compact", async () => {
+    injectBootstrap = true;
+  });
+
+  pi.on("agent_end", async () => {
+    injectBootstrap = false;
+  });
+
+  pi.on("context", async (event: any) => {
+    if (!injectBootstrap) return;
+    if (event?.messages?.some(messageContainsBootstrap)) return;
+
+    const bootstrap = getBootstrapContent();
+    if (!bootstrap) return;
+
+    const bootstrapMessage = {
+      role: "user" as const,
+      content: [{ type: "text" as const, text: bootstrap }],
+      timestamp: Date.now(),
+    };
+
+    const messages = event?.messages || [];
+    const insertAt = firstNonCompactionSummaryIndex(messages);
+
+    return {
+      messages: [
+        ...messages.slice(0, insertAt),
+        bootstrapMessage,
+        ...messages.slice(insertAt),
+      ],
+    };
+  });
+}
+
+function getBootstrapContent(): string | null {
+  if (cachedBootstrap !== undefined) return cachedBootstrap;
+
+  try {
+    let body = "";
+    if (existsSync(rulesPath)) {
+      const raw = readFileSync(rulesPath, "utf8");
+      body = stripFrontmatter(raw);
+    } else {
+      body = "# Tribunal Kit Master Governance Active\nEnforce strict TDD and 28-specialist reviewer waves.";
+    }
+
+    cachedBootstrap = `${EXTREMELY_IMPORTANT_MARKER}
+${BOOTSTRAP_MARKER}
+
+Tribunal Agent Kit Master Governance is active.
+
+The master rules and verification protocols are loaded for this Pi session. Follow them now.
+
+${body}
+
+${piToolMapping()}
+</EXTREMELY_IMPORTANT>`;
+    return cachedBootstrap;
+  } catch {
+    cachedBootstrap = null;
+    return null;
+  }
+}
+
+function stripFrontmatter(content: string): string {
+  const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+  return (match ? match[1] : content).trim();
+}
+
+function piToolMapping(): string {
+  return `## Pi Tool Mapping for Tribunal Kit
+
+Pi has native skills support. When a Tribunal rule or skill applies, load the relevant \`SKILL.md\` with \`read\`, or let a user invoke \`/skill:name\` explicitly.
+
+Pi's built-in coding tools are lowercase: \`read\`, \`write\`, \`edit\`, \`bash\`, plus optional \`grep\`, \`find\`, and \`ls\`. Use those for the corresponding actions: read a file, create or edit files, run shell commands, search file contents, find files by name, and list directories.
+
+Subagent-Driven Development (SDD):
+- To run SDD preparation: use \`bash\` to invoke \`tk sdd brief <plan-path> <task-number>\`.
+- To generate review diffs: use \`bash\` to invoke \`tk sdd diff <plan-path> <base-sha> <head-sha>\`.
+- When delegating to subagents via \`pi-subagents\` or similar tools, supply the generated \`task-<N>-brief.md\` out-of-band and enforce the Iron Law of TDD.`;
+}
+
+function messageContainsBootstrap(message: unknown): boolean {
+  const content = (message as { content?: unknown })?.content;
+  if (typeof content === "string") return content.includes(BOOTSTRAP_MARKER);
+  if (!Array.isArray(content)) return false;
+  return content.some((part) => {
+    return (
+      part &&
+      typeof part === "object" &&
+      (part as { type?: unknown }).type === "text" &&
+      typeof (part as { text?: unknown }).text === "string" &&
+      (part as { text: string }).text.includes(BOOTSTRAP_MARKER)
+    );
+  });
+}
+
+function firstNonCompactionSummaryIndex(messages: unknown[]): number {
+  let index = 0;
+  while ((messages[index] as { role?: unknown } | undefined)?.role === "compactionSummary") {
+    index += 1;
+  }
+  return index;
+}

package/CONTRIBUTING.md

@@ -44,7 +44,7 @@ tribunal-kit/
 ├── .agent/                 # The intelligence payload (agents, skills, workflows)
 │   ├── agents/             # 52 specialist and reviewer agent definitions
 │   ├── skills/             # Reusable skill packs
-│   ├── workflows/          # 40 workflow definitions
+│   ├── workflows/          # 41 workflow definitions
 │   └── scripts/            # Automation scripts
 ├── test/
 │   ├── unit/               # Unit tests (Jest)