tribunal-kit 5.7.0 → 5.8.0

package/.agent/rules/GEMINI.md

@@ -9,6 +9,43 @@ Rule priority: this file (P0) agent .md file (P1) skill SKILL.md (P2)
 
 ---
 
+## Step 0 — Fabel Protocol (Before Everything)
+
+Before classifying the request or routing to any agent, execute this cognitive loop:
+
+### 0a. Epistemic Check
+
+```
+Do I KNOW this, or am I GUESSING?
+  → Guessing → mark // VERIFY: [reason] and search before answering.
+Has this information possibly changed since my training?
+  → Yes → Search before answering. Never serve stale facts.
+Am I importing a package/method that exists?
+  → Verify against package.json / requirements.txt / official docs.
+```
+
+### 0b. Response Format Decision
+
+```
+Is the answer a single fact?       → 1 sentence. No preamble.
+Is it a technical explanation?     → 1-3 paragraphs of prose. No bullets unless 4+ items.
+Is it code (≤20 lines)?           → Inline in response.
+Is it code (>20 lines)?           → Create a file.
+Is it multifaceted (3+ points)?   → Structured format justified.
+Would the user scroll past this?  → Make it scannable, not decorative.
+```
+
+### 0c. Precision Budget
+
+```
+Simple fact      → 1 tool call max
+Medium task      → 3-5 tool calls
+Deep research    → 5-10 tool calls
+20+ tool calls   → Stop. Escalate to human. Scope is too large.
+```
+
+---
+
 ## Step 1 — Classify Every Request
 
 Before any action, identify request type:
@@ -97,17 +134,18 @@ For any complex build, new feature, or unclear request — stop and ask before w
 
 **Required questions by type:**
 
-| Request              | Minimum Questions                               |
-| -------------------- | ----------------------------------------------- |
-| New feature or build | 3+ strategic questions about goal, stack, scope |
-| Code edit or bug fix | Confirm understanding + ask about impact        |
-| Vague request        | Ask about purpose, users, and scope             |
-| Full orchestration   | Block all subagents until plan is confirmed     |
+| Request              | Questions                                                    |
+| -------------------- | ------------------------------------------------------------ |
+| New feature or build | 1-2 targeted questions about the highest-ambiguity decisions |
+| Code edit or bug fix | Confirm understanding of the root cause before fixing        |
+| Vague request        | 1 question about the core goal, then infer the rest          |
+| Full orchestration   | Block all subagents until plan is confirmed                  |
 
 **Rules:**
 
-- Never assume. If even 1% is unclear → ask.
-- Even if the user provides a detailed spec list → still ask about edge cases or tradeoffs
+- Ask only what you cannot infer from context. Check the conversation first.
+- Max 2 questions per response. If you need more, prioritize the most blocking one.
+- Never ask what the user already told you. Never ask generic "what stack?" if the repo shows it.
 - Do not write a single line of code until the gate is cleared
 
 ---
@@ -124,6 +162,18 @@ Never generate entire applications in one shot — one module at a time
 Never guess database column or table names
 ```
 
+### Fabel Coding Discipline
+
+```
+Read the relevant SKILL.md BEFORE writing any code — unconditional, no exceptions.
+After every file edit, re-read the file. Prior context may be stale.
+Short code (≤20 lines) → inline. Long code (>20 lines) → create file.
+Every uncertain API call gets // VERIFY: [reason] comment.
+Scale tool calls to complexity: 1 fact, 3-5 medium, 5-10 deep, escalate beyond.
+Never dump entire files into agent context — excerpt only the relevant function.
+Prose first. Bullets only when 4+ distinct items. No decorative formatting.
+```
+
 ### Code Quality
 
 ```

package/.agent/scripts/_colors.js

@@ -9,33 +9,48 @@
  *   const C = require('./_colors');   // C.RED, C.banner('Title'), etc.
  */
 
-'use strict';
+"use strict";
 
 // ── Core ANSI Escape Codes ──────────────────────────────────────────────────
-const GREEN   = '\x1b[92m';
-const YELLOW  = '\x1b[93m';
-const CYAN    = '\x1b[96m';
-const RED     = '\x1b[91m';
-const BLUE    = '\x1b[94m';
-const MAGENTA = '\x1b[95m';
-const WHITE   = '\x1b[97m';
-const GRAY    = '\x1b[90m';
-const BOLD    = '\x1b[1m';
-const DIM     = '\x1b[2m';
-const ITALIC  = '\x1b[3m';
-const UNDERLINE = '\x1b[4m';
-const RESET   = '\x1b[0m';
+const GREEN = "\x1b[92m";
+const YELLOW = "\x1b[93m";
+const CYAN = "\x1b[96m";
+const RED = "\x1b[91m";
+const BLUE = "\x1b[94m";
+const MAGENTA = "\x1b[95m";
+const WHITE = "\x1b[97m";
+const GRAY = "\x1b[90m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const ITALIC = "\x1b[3m";
+const UNDERLINE = "\x1b[4m";
+const RESET = "\x1b[0m";
 
 // ── Box Drawing Characters ──────────────────────────────────────────────────
 const BOX = {
-    TL: '╔', TR: '╗', BL: '╚', BR: '╝',
-    H:  '═', V:  '║',
-    tl: '┌', tr: '┐', bl: '└', br: '┘',
-    h:  '─', v:  '│',
-    cross: '┼', teeL: '├', teeR: '┤', teeT: '┬', teeB: '┴',
-    bullet: '●', bulletEmpty: '○',
-    arrow: '→', arrowLeft: '←',
-    check: '✔', cross_mark: '✖',
+  TL: "╔",
+  TR: "╗",
+  BL: "╚",
+  BR: "╝",
+  H: "═",
+  V: "║",
+  tl: "┌",
+  tr: "┐",
+  bl: "└",
+  br: "┘",
+  h: "─",
+  v: "│",
+  cross: "┼",
+  teeL: "├",
+  teeR: "┤",
+  teeT: "┬",
+  teeB: "┴",
+  bullet: "●",
+  bulletEmpty: "○",
+  arrow: "→",
+  arrowLeft: "←",
+  check: "✔",
+  cross_mark: "✖",
 };
 
 // ── Branded Output Helpers ──────────────────────────────────────────────────
@@ -47,21 +62,21 @@ const BOX = {
  * @returns {string} Formatted banner string
  */
 function banner(title, meta = {}) {
-    const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
-    const lines = [
-        `  ${BOLD}${CYAN}⚖️  TRIBUNAL KIT${RESET} ${DIM}— ${title}${RESET}`,
-    ];
-
-    const metaEntries = Object.entries(meta);
-    if (metaEntries.length > 0) {
-        for (const [key, value] of metaEntries) {
-            lines.push(`  ${DIM}${key}:${RESET} ${value}`);
-        }
+  const timestamp = new Date().toISOString().replace("T", " ").slice(0, 19);
+  const lines = [
+    `  ${BOLD}${CYAN}⚖️  TRIBUNAL KIT${RESET} ${DIM}— ${title}${RESET}`,
+  ];
+
+  const metaEntries = Object.entries(meta);
+  if (metaEntries.length > 0) {
+    for (const [key, value] of metaEntries) {
+      lines.push(`  ${DIM}${key}:${RESET} ${value}`);
     }
-    lines.push(`  ${DIM}${timestamp}${RESET}`);
+  }
+  lines.push(`  ${DIM}${timestamp}${RESET}`);
 
-    const divider = `${CYAN}${'━'.repeat(56)}${RESET}`;
-    return `\n${divider}\n${lines.join('\n')}\n${divider}`;
+  const divider = `${CYAN}${"━".repeat(56)}${RESET}`;
+  return `\n${divider}\n${lines.join("\n")}\n${divider}`;
 }
 
 /**
@@ -72,9 +87,9 @@ function banner(title, meta = {}) {
  * @returns {string}
  */
 function sectionHeader(title, index, ms) {
-    const num = index != null ? `${index} — ` : '';
-    const timing = ms != null ? `${DIM} (${formatMs(ms)})${RESET}` : '';
-    return `\n${BOLD}${BLUE}━━━ ${num}${title} ━━━${RESET}${timing}`;
+  const num = index != null ? `${index} — ` : "";
+  const timing = ms != null ? `${DIM} (${formatMs(ms)})${RESET}` : "";
+  return `\n${BOLD}${BLUE}━━━ ${num}${title} ━━━${RESET}${timing}`;
 }
 
 /**
@@ -83,27 +98,37 @@ function sectionHeader(title, index, ms) {
  * @returns {string}
  */
 function formatMs(ms) {
-    if (ms < 1000) return `${ms}ms`;
-    if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-    return `${Math.floor(ms / 60000)}m ${Math.round((ms % 60000) / 1000)}s`;
+  if (ms < 1000) return `${ms}ms`;
+  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+  return `${Math.floor(ms / 60000)}m ${Math.round((ms % 60000) / 1000)}s`;
 }
 
 // ── Status Indicator Helpers ────────────────────────────────────────────────
 
 /** @param {string} msg */
-function ok(msg) { console.log(`  ${GREEN}✅ ${msg}${RESET}`); }
+function ok(msg) {
+  console.log(`  ${GREEN}✅ ${msg}${RESET}`);
+}
 
 /** @param {string} msg */
-function fail(msg) { console.log(`  ${RED}❌ ${msg}${RESET}`); }
+function fail(msg) {
+  console.log(`  ${RED}❌ ${msg}${RESET}`);
+}
 
 /** @param {string} msg */
-function warn(msg) { console.log(`  ${YELLOW}⚠️  ${msg}${RESET}`); }
+function warn(msg) {
+  console.log(`  ${YELLOW}⚠️  ${msg}${RESET}`);
+}
 
 /** @param {string} msg */
-function skip(msg) { console.log(`  ${YELLOW}⏭️  ${msg}${RESET}`); }
+function skip(msg) {
+  console.log(`  ${YELLOW}⏭️  ${msg}${RESET}`);
+}
 
 /** @param {string} msg */
-function info(msg) { console.log(`  ${BLUE}ℹ️  ${msg}${RESET}`); }
+function info(msg) {
+  console.log(`  ${BLUE}ℹ️  ${msg}${RESET}`);
+}
 
 // ── Summary Table Builder ───────────────────────────────────────────────────
 
@@ -112,34 +137,34 @@ function info(msg) { console.log(`  ${BLUE}ℹ️  ${msg}${RESET}`); }
  * @param {Array<{name: string, status: 'pass'|'fail'|'skip'|'warn', ms?: number}>} rows
  */
 function summaryTable(rows) {
-    const maxName = Math.max(...rows.map(r => r.name.length), 18);
-    const colW = maxName + 2;
-
-    const statusIcon = (s) => {
-        if (s === 'pass') return `${GREEN} ✅ ${RESET}`;
-        if (s === 'fail') return `${RED} ❌ ${RESET}`;
-        if (s === 'skip') return `${YELLOW} ⏭️  ${RESET}`;
-        if (s === 'warn') return `${YELLOW} ⚠️  ${RESET}`;
-        return `${DIM} — ${RESET}`;
-    };
-
-    const pad = (str, len) => str + ' '.repeat(Math.max(0, len - str.length));
-    const top  = `  ${BOX.tl}${BOX.h.repeat(colW)}${BOX.teeT}${BOX.h.repeat(6)}${BOX.teeT}${BOX.h.repeat(10)}${BOX.tr}`;
-    const mid  = `  ${BOX.teeL}${BOX.h.repeat(colW)}${BOX.cross}${BOX.h.repeat(6)}${BOX.cross}${BOX.h.repeat(10)}${BOX.teeR}`;
-    const bot  = `  ${BOX.bl}${BOX.h.repeat(colW)}${BOX.teeB}${BOX.h.repeat(6)}${BOX.teeB}${BOX.h.repeat(10)}${BOX.br}`;
-    const hdr  = `  ${BOX.v} ${BOLD}${pad('Check', colW - 2)}${RESET} ${BOX.v}${BOLD} Res ${RESET}${BOX.v} ${BOLD}${pad('Time', 8)}${RESET}${BOX.v}`;
-
-    console.log(top);
-    console.log(hdr);
-    console.log(mid);
-
-    for (const row of rows) {
-        const time = row.ms != null ? formatMs(row.ms) : '—';
-        const line = `  ${BOX.v} ${pad(row.name, colW - 2)} ${BOX.v}${statusIcon(row.status)}${BOX.v} ${pad(time, 8)}${BOX.v}`;
-        console.log(line);
-    }
-
-    console.log(bot);
+  const maxName = Math.max(...rows.map((r) => r.name.length), 18);
+  const colW = maxName + 2;
+
+  const statusIcon = (s) => {
+    if (s === "pass") return `${GREEN} ✅ ${RESET}`;
+    if (s === "fail") return `${RED} ❌ ${RESET}`;
+    if (s === "skip") return `${YELLOW} ⏭️  ${RESET}`;
+    if (s === "warn") return `${YELLOW} ⚠️  ${RESET}`;
+    return `${DIM} — ${RESET}`;
+  };
+
+  const pad = (str, len) => str + " ".repeat(Math.max(0, len - str.length));
+  const top = `  ${BOX.tl}${BOX.h.repeat(colW)}${BOX.teeT}${BOX.h.repeat(6)}${BOX.teeT}${BOX.h.repeat(10)}${BOX.tr}`;
+  const mid = `  ${BOX.teeL}${BOX.h.repeat(colW)}${BOX.cross}${BOX.h.repeat(6)}${BOX.cross}${BOX.h.repeat(10)}${BOX.teeR}`;
+  const bot = `  ${BOX.bl}${BOX.h.repeat(colW)}${BOX.teeB}${BOX.h.repeat(6)}${BOX.teeB}${BOX.h.repeat(10)}${BOX.br}`;
+  const hdr = `  ${BOX.v} ${BOLD}${pad("Check", colW - 2)}${RESET} ${BOX.v}${BOLD} Res ${RESET}${BOX.v} ${BOLD}${pad("Time", 8)}${RESET}${BOX.v}`;
+
+  console.log(top);
+  console.log(hdr);
+  console.log(mid);
+
+  for (const row of rows) {
+    const time = row.ms != null ? formatMs(row.ms) : "—";
+    const line = `  ${BOX.v} ${pad(row.name, colW - 2)} ${BOX.v}${statusIcon(row.status)}${BOX.v} ${pad(time, 8)}${BOX.v}`;
+    console.log(line);
+  }
+
+  console.log(bot);
 }
 
 // ── High-Precision Timer ────────────────────────────────────────────────────
@@ -149,22 +174,39 @@ function summaryTable(rows) {
  * @returns {function(): number}
  */
 function timer() {
-    const start = process.hrtime.bigint();
-    return () => Number(process.hrtime.bigint() - start) / 1e6;
+  const start = process.hrtime.bigint();
+  return () => Number(process.hrtime.bigint() - start) / 1e6;
 }
 
 module.exports = {
-    // Core colors
-    GREEN, YELLOW, CYAN, RED, BLUE, MAGENTA, WHITE, GRAY,
-    BOLD, DIM, ITALIC, UNDERLINE, RESET,
-    // Box drawing
-    BOX,
-    // Branded helpers
-    banner, sectionHeader, formatMs,
-    // Status indicators
-    ok, fail, warn, skip, info,
-    // Summary
-    summaryTable,
-    // Timing
-    timer,
+  // Core colors
+  GREEN,
+  YELLOW,
+  CYAN,
+  RED,
+  BLUE,
+  MAGENTA,
+  WHITE,
+  GRAY,
+  BOLD,
+  DIM,
+  ITALIC,
+  UNDERLINE,
+  RESET,
+  // Box drawing
+  BOX,
+  // Branded helpers
+  banner,
+  sectionHeader,
+  formatMs,
+  // Status indicators
+  ok,
+  fail,
+  warn,
+  skip,
+  info,
+  // Summary
+  summaryTable,
+  // Timing
+  timer,
 };