@jetrabbits/agentic 0.3.3 → 0.5.0

package/docs/site/index.html

@@ -27,13 +27,16 @@
           </div>
         </div>
 
-        <div class="toolbar" aria-label="Search docs">
+        <div class="toolbar" aria-label="Docs controls">
           <input id="search" type="search" placeholder="Search trigger, workflow, examples..." />
           <select id="language" aria-label="Language">
             <option value="both">EN + RU</option>
             <option value="en">EN only</option>
             <option value="ru">RU only</option>
           </select>
+          <button id="theme-toggle" class="theme-toggle" type="button" aria-pressed="false">
+            Dark
+          </button>
         </div>
       </div>
     </header>
@@ -47,6 +50,7 @@
 
     <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/lunr/lunr.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
     <script src="./app.js" type="module"></script>
   </body>
 </html>

package/docs/site/styles.css

@@ -1,5 +1,18 @@
 :root {
-  color-scheme: light dark;
+  color-scheme: light;
+  --bg: #f8fafc;
+  --fg: #0f172a;
+  --muted: #64748b;
+  --accent: #15803d;
+  --panel: rgba(255, 255, 255, 0.86);
+  --panel-strong: #ffffff;
+  --border: #cbd5e1;
+  --code-bg: #e2e8f0;
+  --code-fg: #0f172a;
+  --mermaid-bg: rgba(226, 232, 240, 0.45);
+}
+html[data-theme="dark"] {
+  color-scheme: dark;
   --bg: #0f172a;
   --fg: #e2e8f0;
   --muted: #94a3b8;
@@ -8,6 +21,8 @@
   --panel-strong: #1e293b;
   --border: #334155;
   --code-bg: #020617;
+  --code-fg: #e2e8f0;
+  --mermaid-bg: rgba(2, 6, 23, 0.35);
 }
 body {
   margin: 0;
@@ -90,7 +105,8 @@ body {
   padding: 0.45rem 0.65rem;
   border: 1px solid var(--border);
   border-radius: 10px;
-  background: rgba(2, 6, 23, 0.75);
+  background: var(--code-bg);
+  color: var(--code-fg);
   font-size: 0.75rem;
   line-height: 1.35;
   overflow-wrap: anywhere;
@@ -131,12 +147,43 @@ input, select {
   border-radius: 10px;
   padding: 0.5rem 0.75rem;
 }
+.theme-toggle {
+  flex: 0 0 auto;
+  min-width: 5rem;
+  background: var(--panel-strong);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 0.5rem 0.75rem;
+  cursor: pointer;
+}
+.theme-toggle:hover {
+  border-color: var(--accent);
+}
+.theme-toggle[aria-pressed="true"] {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: #ffffff;
+}
 .area-title { font-size: .85rem; text-transform: uppercase; color: var(--muted); margin: 1rem 0 .4rem; }
 .wf-btn { width: 100%; text-align: left; margin-bottom: .4rem; background: var(--panel-strong); color: var(--fg); border: 1px solid var(--border); border-radius: 8px; padding: .5rem; cursor: pointer; }
 .wf-btn:hover { border-color: var(--accent); }
-code, pre { background: var(--code-bg); border-radius: 8px; }
+code, pre { background: var(--code-bg); color: var(--code-fg); border-radius: 8px; }
 .chip { display:inline-block; border:1px solid var(--border); border-radius:999px; padding:.15rem .5rem; margin:.15rem; color:var(--muted); font-size:.82rem; }
 .meta { color: var(--muted); }
+.mermaid {
+  max-width: 100%;
+  margin: 1rem 0;
+  padding: 1rem;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--mermaid-bg);
+  overflow-x: auto;
+}
+.mermaid svg {
+  display: block;
+  max-width: none;
+}
 
 @media (max-width: 980px) {
   .site-header__inner {
@@ -162,7 +209,8 @@ code, pre { background: var(--code-bg); border-radius: 8px; }
     flex-wrap: wrap;
   }
   .toolbar input,
-  .toolbar select {
+  .toolbar select,
+  .theme-toggle {
     width: 100%;
     flex-basis: 100%;
   }

package/extensions/opencode/opencode.json

@@ -1,7 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "plugin": [
-    "sound-notification",
     "telegram-notification"
   ],
   "agent": {

package/extensions/opencode/profiles/githubcopilot/opencode.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "telegram-notification"
+  ],
+  "agent": {
+    "product-owner": {
+      "description": "Main coordinator for feature development workflow",
+      "mode": "primary",
+      "model": "github-copilot/gpt-5.5",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "pm": "allow",
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow",
+          "instruction_reviewer": "allow",
+          "memory_curator": "allow"
+        }
+      }
+    },
+    "pm": {
+      "description": "Project Manager - coordinates workflow",
+      "mode": "subagent",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "team-lead": {
+      "description": "Team Lead - planning and code review",
+      "mode": "all",
+      "model": "github-copilot/claude-opus-4.8",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "developer": {
+      "description": "Developer - implements code",
+      "mode": "all",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": []
+    },
+    "devops-engineer": {
+      "description": "DevOps Engineer - infrastructure, CI/CD, and platform reliability",
+      "mode": "all",
+      "model": "github-copilot/claude-sonnet-4.6",
+      "fallback": []
+    },
+    "instruction_reviewer": {
+      "description": "Instruction Reviewer - post-task review of instruction effectiveness and tool discipline",
+      "mode": "all",
+      "model": "github-copilot/claude-sonnet-4.6",
+      "fallback": []
+    },
+    "memory_curator": {
+      "description": "Memory Curator - post-task memory hygiene recommendations without automatic writes",
+      "mode": "all",
+      "model": "github-copilot/gpt-5-mini",
+      "fallback": []
+    },
+    "qa": {
+      "description": "QA Engineer - runs tests",
+      "mode": "subagent",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": []
+    },
+    "designer": {
+      "description": "Designer - UI/UX validation",
+      "mode": "subagent",
+      "model": "github-copilot/gemini-3.5-flash",
+      "fallback": []
+    }
+  }
+}

package/extensions/opencode/profiles/openai/opencode.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "telegram-notification"
+  ],
+  "small_model": "openai/gpt-5-nano",
+  "agent": {
+    "product-owner": {
+      "description": "Main coordinator for feature development workflow",
+      "mode": "primary",
+      "model": "openai/gpt-5.5",
+      "fallback": ["openai/gpt-5.4"],
+      "permission": {
+        "task": {
+          "pm": "allow",
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow",
+          "instruction_reviewer": "allow",
+          "memory_curator": "allow"
+        }
+      }
+    },
+    "pm": {
+      "description": "Project Manager - coordinates workflow",
+      "mode": "subagent",
+      "model": "openai/gpt-5.4-mini",
+      "fallback": ["openai/gpt-5.4"],
+      "permission": {
+        "task": {
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "team-lead": {
+      "description": "Team Lead - planning and code review",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": ["openai/gpt-5.4"],
+      "permission": {
+        "task": {
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "developer": {
+      "description": "Developer - implements code",
+      "mode": "all",
+      "model": "openai/gpt-5.4-mini",
+      "fallback": ["openai/gpt-5.4"]
+    },
+    "devops-engineer": {
+      "description": "DevOps Engineer - infrastructure, CI/CD, and platform reliability",
+      "mode": "all",
+      "model": "openai/gpt-5.4-mini",
+      "fallback": ["openai/gpt-5.4"]
+    },
+    "instruction_reviewer": {
+      "description": "Instruction Reviewer - post-task review of instruction effectiveness and tool discipline",
+      "mode": "all",
+      "model": "openai/gpt-5-nano",
+      "fallback": ["openai/gpt-5.4-nano"]
+    },
+    "memory_curator": {
+      "description": "Memory Curator - post-task memory hygiene recommendations without automatic writes",
+      "mode": "all",
+      "model": "openai/gpt-5-nano",
+      "fallback": ["openai/gpt-5.4-nano"]
+    },
+    "qa": {
+      "description": "QA Engineer - runs tests",
+      "mode": "subagent",
+      "model": "openai/gpt-5.4-nano",
+      "fallback": ["openai/gpt-5.4-mini"]
+    },
+    "designer": {
+      "description": "Designer - UI/UX validation",
+      "mode": "subagent",
+      "model": "openai/gpt-5.4-nano",
+      "fallback": ["openai/gpt-5.4-mini"]
+    },
+    "plan": {
+      "description": "Planning mode",
+      "mode": "primary",
+      "model": "openai/gpt-5.5",
+      "fallback": ["openai/gpt-5.4"]
+    },
+    "build": {
+      "description": "Build mode",
+      "mode": "primary",
+      "model": "openai/gpt-5.4-mini",
+      "fallback": ["openai/gpt-5.4"]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetrabbits/agentic",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Agent Intelligence Configuration CLI",
   "bin": {
     "agentic": "bin/agentic.js"

package/scripts/build_docs_catalog.py

@@ -31,6 +31,10 @@ PLACEHOLDER_STRINGS = (
     "Goal: execute workflow steps end-to-end",
     "Use when: run workflow",
 )
+WORKFLOW_DIAGRAM_RE = re.compile(
+    r"<!-- agent-diagram:start -->\n```mermaid\n(.*?)\n```\n<!-- agent-diagram:end -->",
+    re.DOTALL,
+)
 
 
 def _parse_yaml_list(frontmatter: str, key: str) -> List[str]:
@@ -76,6 +80,7 @@ class Workflow:
     uses_skills: List[str]
     quality_gates: List[str]
     skill_refs: List[dict]
+    workflow_diagram: str
 
 
 @dataclass
@@ -126,9 +131,15 @@ def parse_workflow(path: Path) -> Workflow:
         uses_skills=uses_skills,
         quality_gates=_parse_yaml_list(front, "quality-gates"),
         skill_refs=_resolve_skill_paths(area, uses_skills),
+        workflow_diagram=_extract_workflow_diagram(text),
     )
 
 
+def _extract_workflow_diagram(text: str) -> str:
+    match = WORKFLOW_DIAGRAM_RE.search(text)
+    return match.group(1).strip() if match else ""
+
+
 def parse_prompt(path: Path) -> Prompt:
     text = path.read_text(encoding="utf-8")
     frontmatter = PROMPT_FRONTMATTER_RE.match(text)
@@ -242,12 +253,13 @@ def build_catalog(validate: bool = False) -> Tuple[dict, List[str]]:
                 "uses_skills": wf.uses_skills,
                 "skill_refs": wf.skill_refs,
                 "quality_gates": wf.quality_gates,
+                "workflow_diagram": wf.workflow_diagram,
                 "examples": {"both": [asdict(e) for e in (pr.examples if pr else [])]},
             }
         )
 
     catalog = {
-        "version": "1.1.0",
+        "version": "1.2.0",
         "generated_from": "areas/**/{workflows,prompts}",
         "areas": list(areas_out.values()),
         "stats": {

package/scripts/sync_workflow_diagrams.py

@@ -0,0 +1,199 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import re
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Iterable
+
+ROOT = Path(__file__).resolve().parents[1]
+AREAS_DIR = ROOT / "areas"
+
+FRONTMATTER_RE = re.compile(r"^---\n(.*?)\n---\n", re.DOTALL)
+TRIGGER_RE = re.compile(r"^trigger:\s*(.+)$", re.MULTILINE)
+INITIATOR_RE = re.compile(r"^\s{2}initiator:\s*(.+)$", re.MULTILINE)
+H3_RE = re.compile(r"^###\s+(.+)$", re.MULTILINE)
+H2_RE = re.compile(r"^##\s+(.+)$", re.MULTILINE)
+ROLE_MENTION_RE = re.compile(r"`@([^`]+)`")
+GENERATED_SECTION_RE = re.compile(
+    r"\n?## Agent Interaction Diagram\n\n"
+    r"<!-- agent-diagram:start -->\n"
+    r"```mermaid\n.*?\n```\n"
+    r"<!-- agent-diagram:end -->\n?",
+    re.DOTALL,
+)
+
+
+@dataclass
+class Step:
+    label: str
+    roles: list[str]
+
+
+def _parse_yaml_list(frontmatter: str, key: str) -> list[str]:
+    m = re.search(rf"^{re.escape(key)}:\s*\n((?:\s*-\s.*\n)+)", frontmatter, re.MULTILINE)
+    if not m:
+        inline = re.search(rf"^{re.escape(key)}:\s*\[(.*?)\]\s*$", frontmatter, re.MULTILINE)
+        if not inline:
+            return []
+        return [x.strip().strip("'\"") for x in inline.group(1).split(",") if x.strip()]
+    return [line.strip()[1:].strip().strip("'\"") for line in m.group(1).splitlines() if line.strip().startswith("-")]
+
+
+def _clean_role(role: str) -> str:
+    return role.strip().strip("'\"").removeprefix("@").strip()
+
+
+def _clean_step_label(raw: str) -> str:
+    label = re.sub(r"\s+[—-]\s+`@[^`]+`(?:\s*\+\s*`@[^`]+`)*.*$", "", raw).strip()
+    label = re.sub(r"`@[^`]+`", "", label).strip()
+    label = re.sub(r"^Step\s+", "", label, flags=re.IGNORECASE)
+    return label
+
+
+def _extract_steps(text: str, fallback_roles: list[str]) -> list[Step]:
+    steps: list[Step] = []
+    for match in H3_RE.finditer(text):
+        heading = match.group(1).strip()
+        roles = [_clean_role(role) for role in ROLE_MENTION_RE.findall(heading)]
+        roles = [role for role in roles if role]
+        steps.append(Step(label=_clean_step_label(heading), roles=roles or fallback_roles))
+    return steps
+
+
+def _extract_exit(text: str) -> str:
+    match = re.search(r"^## Exit\n\n?(.+?)(?:\n## |\Z)", text, re.MULTILINE | re.DOTALL)
+    if not match:
+        return "Workflow complete"
+    first_line = next((line.strip() for line in match.group(1).splitlines() if line.strip()), "")
+    return first_line or "Workflow complete"
+
+
+def _has_loop(text: str) -> bool:
+    return bool(re.search(r"^##\s+(Iteration Loop|Rollback|Rollbacks?)\b", text, re.MULTILINE))
+
+
+def _node_id(prefix: str, index: int) -> str:
+    return f"{prefix}_{index}"
+
+
+def _mermaid_label(value: str, max_len: int = 78) -> str:
+    compact = re.sub(r"\s+", " ", value).strip()
+    compact = compact.replace("`", "").replace("**", "")
+    if len(compact) > max_len:
+        compact = compact[: max_len - 3].rstrip() + "..."
+    return compact.replace("\\", "\\\\").replace('"', '\\"')
+
+
+def _unique(values: Iterable[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for value in values:
+        if value and value not in seen:
+            seen.add(value)
+            out.append(value)
+    return out
+
+
+def build_diagram(text: str) -> str:
+    front = FRONTMATTER_RE.search(text)
+    frontmatter = front.group(1) if front else ""
+    trigger = TRIGGER_RE.search(frontmatter)
+    initiator = INITIATOR_RE.search(frontmatter)
+
+    trigger_label = trigger.group(1).strip() if trigger else "/workflow"
+    roles = [_clean_role(role) for role in _parse_yaml_list(frontmatter, "roles")]
+    if initiator:
+        roles = _unique([_clean_role(initiator.group(1)), *roles])
+    steps = _extract_steps(text, roles)
+
+    lines = ["flowchart TD", f'  start(["Start { _mermaid_label(trigger_label) }"])']
+    role_ids: dict[str, str] = {}
+    for index, role in enumerate(_unique(role for step in steps for role in step.roles), 1):
+        role_id = _node_id("role", index)
+        role_ids[role] = role_id
+        lines.append(f'  {role_id}["{_mermaid_label(role)}"]')
+
+    if steps:
+        for index, step in enumerate(steps, 1):
+            lines.append(f'  step_{index}["{_mermaid_label(step.label)}"]')
+        lines.append(f'  exit(["{_mermaid_label(_extract_exit(text))}"])')
+        lines.append("  start --> step_1")
+        for index in range(1, len(steps)):
+            lines.append(f"  step_{index} --> step_{index + 1}")
+        lines.append(f"  step_{len(steps)} --> exit")
+        for index, step in enumerate(steps, 1):
+            for role in step.roles:
+                role_id = role_ids.get(role)
+                if role_id:
+                    lines.append(f"  {role_id} -. owns .-> step_{index}")
+        if _has_loop(text) and len(steps) > 1:
+            lines.append(f"  step_{len(steps)} -. iterate if blocked .-> step_1")
+    else:
+        lines.append(f'  exit(["{_mermaid_label(_extract_exit(text))}"])')
+        lines.append("  start --> exit")
+        for role, role_id in role_ids.items():
+            lines.append(f"  {role_id} -. owns .-> exit")
+
+    return "\n".join(lines)
+
+
+def _section(diagram: str) -> str:
+    return (
+        "## Agent Interaction Diagram\n\n"
+        "<!-- agent-diagram:start -->\n"
+        "```mermaid\n"
+        f"{diagram}\n"
+        "```\n"
+        "<!-- agent-diagram:end -->\n"
+    )
+
+
+def _insert_index(text: str) -> int:
+    text_without_existing = GENERATED_SECTION_RE.sub("\n", text)
+    candidates = []
+    for match in H2_RE.finditer(text_without_existing):
+        heading = match.group(1).strip().lower()
+        if heading.startswith(("iteration loop", "rollback", "exit", "mandatory role delegation")):
+            candidates.append(match.start())
+    if candidates:
+        return candidates[0]
+    return len(text_without_existing.rstrip()) + 1
+
+
+def sync_text(text: str) -> str:
+    diagram = build_diagram(text)
+    text = GENERATED_SECTION_RE.sub("\n", text).rstrip() + "\n"
+    section = _section(diagram)
+    idx = _insert_index(text)
+    before = text[:idx].rstrip()
+    after = text[idx:].lstrip("\n")
+    if after:
+        return f"{before}\n\n{section}\n{after}"
+    return f"{before}\n\n{section}"
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--check", action="store_true", help="Fail if any workflow diagram is out of date.")
+    args = parser.parse_args()
+
+    changed: list[Path] = []
+    for path in sorted(AREAS_DIR.glob("**/workflows/*.md")):
+        original = path.read_text(encoding="utf-8")
+        updated = sync_text(original)
+        if updated != original:
+            changed.append(path)
+            if not args.check:
+                path.write_text(updated, encoding="utf-8")
+
+    if changed:
+        for path in changed:
+            print(path.relative_to(ROOT))
+        return 1 if args.check else 0
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/extensions/opencode/plugins/sound-notification.ts

@@ -1,13 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin"
-
-export const SoundNotificationPlugin: Plugin = async ({ $ }) => {
-  return {
-    event: async ({ event }) => {
-      if (event.type === "session.idle") {
-        try {
-          await $`afplay /System/Library/Sounds/Glass.aiff`
-        } catch {}
-      }
-    },
-  }
-}