@jetrabbits/agentic 0.4.0 → 0.5.0

package/areas/software/platform/workflows/provision-env.md

@@ -73,5 +73,41 @@ quality-gates:
 - **Output:** environment URL published in PR
 - **Done when:** team has access and teardown instructions
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /provision-env"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  role_4["pm"]
+  step_1["1. Validate Prerequisites"]
+  step_2["2. Plan Infrastructure"]
+  step_3["3. Estimate Cost"]
+  step_4["4. Apply Infrastructure"]
+  step_5["5. Configure DNS & Ingress"]
+  step_6["6. Seed & Smoke Test"]
+  step_7["7. Report"]
+  exit(["Smoke tests green + URL published = environment ready for use."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> step_6
+  step_6 --> step_7
+  step_7 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+  role_3 -. owns .-> step_6
+  role_4 -. owns .-> step_7
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Smoke tests green + URL published = environment ready for use.

package/areas/software/qa/workflows/flakiness-investigation.md

@@ -59,5 +59,35 @@ quality-gates:
 - **Output:** closure note in flakiness log; systemic action item if needed
 - **Done when:** flakiness log updated; test unquarantined or deleted
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /flakiness-investigation"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Collect Failure Signals & Patterns"]
+  step_2["2. Reproduce & Classify Root Cause"]
+  step_3["3. Stabilization Fix"]
+  step_4["4. Stress Re-run & Quarantine Decision"]
+  step_5["5. Policy Review & Closure"]
+  exit(["Stable test in CI + root cause documented + log updated = investigation clo..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Stable test in CI + root cause documented + log updated = investigation closed.

package/areas/software/qa/workflows/performance-audit.md

@@ -55,5 +55,34 @@ quality-gates:
 - **Output:** `performance_report.md`; remediation backlog items created
 - **Done when:** report complete; backlog items assigned
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /performance-audit"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  role_4["pm"]
+  step_1["1. Scenario Definition & Baseline Alignment"]
+  step_2["2. Load/Stress Execution & Monitoring Capture"]
+  step_3["3. Bottleneck Analysis & Fix Proposal"]
+  step_4["4. Prioritization & Delivery Planning"]
+  exit(["Published report + prioritized remediation plan + backlog items created = a..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_4 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published report + prioritized remediation plan + backlog items created = audit complete.

package/areas/software/qa/workflows/regression-suite.md

@@ -55,5 +55,33 @@ quality-gates:
 - **Output:** `regression_report.md`; go/no-go decision
 - **Done when:** recommendation is explicit; stakeholders informed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /regression-suite"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Scope Selection & Environment Readiness"]
+  step_2["2. Suite Execution & Evidence Capture"]
+  step_3["3. Failure Triage & Fixes"]
+  step_4["4. Risk Review & Release Recommendation"]
+  exit(["Go recommendation + regression report = release confidence confirmed."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Go recommendation + regression report = release confidence confirmed.

package/areas/software/qa/workflows/smoke-test.md

@@ -60,5 +60,36 @@ quality-gates:
 - **Output:** `smoke_result_summary.md`; stakeholders informed
 - **Done when:** all parties notified; action taken if needed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /smoke-test"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  role_4["pm"]
+  step_1["1. Prepare Environment & Test Data"]
+  step_2["2. Run Critical Smoke Scenarios"]
+  step_3["3. Defect Triage & Fix"]
+  step_4["4. Operational Risk Assessment"]
+  step_5["5. Communicate Go/No-Go"]
+  exit(["Go status + summary published = deployment validated. No-go + rollback trig..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_4 -. owns .-> step_5
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Go status + summary published = deployment validated. No-go + rollback triggered = incident response starts.

package/areas/software/qa/workflows/test-coverage-report.md

@@ -53,5 +53,33 @@ quality-gates:
 - **Output:** `coverage_report.md`; next sprint coverage actions noted
 - **Done when:** report shared with team; action items logged
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /test-coverage-report"])
+  role_1["qa"]
+  role_2["team-lead"]
+  role_3["developer"]
+  step_1["1. Collect & Compare Metrics"]
+  step_2["2. Identify High-Risk Gaps"]
+  step_3["3. Implement Targeted Tests & Fixes"]
+  step_4["4. Publish Trend & Action Plan"]
+  exit(["Critical paths at threshold + trend published + gaps assigned = coverage cy..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_2
+  role_3 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Critical paths at threshold + trend published + gaps assigned = coverage cycle complete.

package/areas/software/security/workflows/compliance-report.md

@@ -53,5 +53,32 @@ quality-gates:
 - **Output:** compliance report document
 - **Done when:** report complete; human review flag set
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /compliance-report"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  step_1["1. Map Controls"]
+  step_2["2. Collect Evidence"]
+  step_3["3. Evaluate Compliance"]
+  step_4["4. Generate Report"]
+  exit(["Complete control matrix + gap analysis + human review flag = report ready f..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_3 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Complete control matrix + gap analysis + human review flag = report ready for review.

package/areas/software/security/workflows/pen-test-sim.md

@@ -59,5 +59,33 @@ quality-gates:
 - **Output:** `pentest_report_<date>.md`; remediation assignments
 - **Done when:** report reviewed; remediation owners assigned
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /pen-test-sim"])
+  role_1["team-lead"]
+  role_2["qa"]
+  step_1["1. Scope Confirmation"]
+  step_2["2. Passive Recon"]
+  step_3["3. Active Scanning"]
+  step_4["4. Manual Checks"]
+  step_5["5. Report"]
+  exit(["Published report + Critical/High findings assigned = pen-test complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published report + Critical/High findings assigned = pen-test complete.

package/areas/software/security/workflows/secret-rotation.md

@@ -16,9 +16,9 @@ execution:
   initiator: developer
 related-rules:
   - secrets-policy.md
-  - security-posture.md
+  - secure-coding.md
 uses-skills:
-  - secrets-management
+  - crypto-standards
 quality-gates:
   - old credential revoked only after zero auth errors confirmed
   - audit log entry created with rotation metadata
@@ -63,5 +63,36 @@ quality-gates:
 - **Output:** audit record updated
 - **Done when:** inventory current; next rotation scheduled
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /secret-rotation"])
+  role_1["developer"]
+  role_2["team-lead"]
+  step_1["1. Prepare New Secret"]
+  step_2["2. Dual-Read Window"]
+  step_3["3. Deploy New Secret"]
+  step_4["4. Validate"]
+  step_5["5. Revoke Old Secret"]
+  step_6["6. Document"]
+  exit(["Old secret revoked + audit record updated = rotation complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> step_6
+  step_6 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+  role_1 -. owns .-> step_6
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Old secret revoked + audit record updated = rotation complete.

package/areas/software/security/workflows/security-scan.md

@@ -60,5 +60,34 @@ quality-gates:
 - **Output:** `finding_report.md`; PR review comments
 - **Done when:** report published; PR status set per findings
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /security-scan"])
+  role_1["developer"]
+  role_2["qa"]
+  role_3["team-lead"]
+  step_1["1. SAST Scan"]
+  step_2["2. Dependency Audit"]
+  step_3["3. Secret Scanning"]
+  step_4["4. Infrastructure Scan"]
+  step_5["5. Synthesize & Report"]
+  exit(["No unaddressed Critical findings + report saved = scan complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 No unaddressed Critical findings + report saved = scan complete.

package/areas/software/security/workflows/threat-model-review.md

@@ -58,5 +58,35 @@ quality-gates:
 - **Output:** `.security/threat-models/threat-model-<feature>.md` — DFD + STRIDE table + mitigations
 - **Done when:** all Required findings have assigned controls; document complete
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /threat-model-review"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  step_1["1. Parse Feature"]
+  step_2["2. Data Flow Diagram"]
+  step_3["3. STRIDE Analysis"]
+  step_4["4. Prioritize"]
+  step_5["5. Generate Mitigations"]
+  exit(["Published threat model + Required mitigations assigned = secure implementat..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_3 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published threat model + Required mitigations assigned = secure implementation can proceed.

package/docs/agentic-usage.md

@@ -182,7 +182,7 @@ When `opencode` is selected, interactive installs ask whether to enable `Telegra
 
 Non-interactive installs create a disabled config when no config exists. Interactive installs ask for Telegram `botToken` and `chatId` when `telegram-notification` is selected. Those credentials are written to the target project `.agentic.json` under `settings.opencode_plugins.telegram`, not to `~/.config/agentic/opencode-plugins.json`. Treat `.agentic.json` as plaintext secret-bearing project config when Telegram is enabled and do not commit it to public repositories. When enabled, `agent-model-mapper` runs during interactive `agentic install`/`agentic tui`, uses `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup does not load a mapper runtime plugin or prompt for model mapping.
 
-OpenCode model profiles are stored in `extensions/opencode/profiles` and appear in the same optional OpenCode selection menu as the plugin choices. The built-in choices are `OpenAI Model Profile` and `GitHub Copilot Model Profile`; non-interactive installs can choose them with `AGENTIC_OPENCODE_PROFILE=openai` or `AGENTIC_OPENCODE_PROFILE=githubcopilot`. Profile selection merges agent model mappings into `.opencode/opencode.json`, then MCP configuration is merged afterward.
+OpenCode model profiles are stored in `extensions/opencode/profiles` and appear in the same optional OpenCode selection menu as the plugin choices. The built-in choices are `OpenAI Model Profile` and `GitHub Copilot Model Profile`; non-interactive installs can choose them with `AGENTIC_OPENCODE_PROFILE=openai` or `AGENTIC_OPENCODE_PROFILE=githubcopilot`. Users can add local profiles under `$HOME/.config/agentic/opencode/profiles/<profile-id>/opencode.json`; for example, `DT/opencode.json` appears as `DT profile` and `GH/opencode.json` appears as `GH profile`. Profile selection merges agent model mappings into `.opencode/opencode.json`, then MCP configuration is merged afterward.
 
 OpenCode MCP config uses top-level `mcp`, not `mcpServers`. Agentic migrates legacy OpenCode `mcpServers` entries into `mcp` during install. Codex continues to use `.codex/config.toml` with `[mcp_servers.*]` sections.
 

package/docs/catalog.schema.json

@@ -44,7 +44,8 @@
                 "uses_skills",
                 "quality_gates",
                 "examples",
-                "skill_refs"
+                "skill_refs",
+                "workflow_diagram"
               ],
               "properties": {
                 "trigger": {
@@ -104,6 +105,9 @@
                     "type": "string"
                   }
                 },
+                "workflow_diagram": {
+                  "type": "string"
+                },
                 "examples": {
                   "type": "object",
                   "required": [

package/docs/opencode_setup.md

@@ -56,6 +56,16 @@ extensions/opencode/profiles/
 
 The current profiles are `OpenAI Model Profile` (`openai/opencode.json`) and `GitHub Copilot Model Profile` (`githubcopilot/opencode.json`). They appear in the same optional OpenCode selection menu as the plugin choices. Selecting one merges its agent model mapping into `.opencode/opencode.json`; later MCP configuration is merged on top, so profile selection does not block future MCP sections.
 
+Users can add local OpenCode profiles in:
+
+```text
+$HOME/.config/agentic/opencode/profiles/<profile-id>/opencode.json
+```
+
+Local profiles appear below the bundled profiles in the optional OpenCode plugin menu using the label `<profile-id> profile`. For example, `$HOME/.config/agentic/opencode/profiles/DT/opencode.json` appears as `DT profile`, and `$HOME/.config/agentic/opencode/profiles/GH/opencode.json` appears as `GH profile`.
+
+Selecting `none` applies no model profile and does not copy the baseline `extensions/opencode/opencode.json` just for profile selection. If OpenCode MCPs, Telegram notifications, or agent model mapping are selected, `agentic` may still create or update `.opencode/opencode.json` for those explicit options.
+
 For MCP servers, OpenCode uses top-level `mcp` entries. Agentic migrates legacy `mcpServers` in OpenCode configs to `mcp` and removes the invalid key.
 
 For OpenCode targets, `agentic` writes generated operating guidance to `.opencode/AGENTS.md`. If OpenCode is installed

package/docs/site/README.md

@@ -17,11 +17,13 @@ For this repo we keep it lightweight and dependency-minimal:
 - site is static HTML/CSS/JS
 - markdown rendering via `marked` CDN
 - full-text search via `lunr` CDN
+- workflow diagrams rendered via `mermaid` CDN
 
 ## Run locally
 
 ```bash
-python3 scripts/build_docs_catalog.py --output docs/site/catalog.json --validate
+make sync-diagrams
+make build
 python3 -m http.server 8000
 # open http://localhost:8000/docs/site/
 ```
@@ -31,7 +33,9 @@ python3 -m http.server 8000
 - Left menu grouped by area.
 - Full-text search by trigger/name/description/examples.
 - Language switcher: EN only / RU only / EN+RU.
+- Light and dark themes, with light as the default and the selected theme saved in the browser.
 - Workflow page with quality gates and source paths.
+- Generated Mermaid agent interaction diagrams for workflows.
 
 
 ## GitHub Pages
@@ -42,3 +46,13 @@ This site can be published from GitHub Pages via Actions workflow (`.github/work
 ## Workflow mapping
 
 Prompt-to-workflow mapping is command-based: `/workflow-file-name` in prompt text links to `workflows/<workflow-file-name>.md` in the same area.
+
+## Workflow diagrams
+
+Workflow diagrams are generated into `areas/**/workflows/*.md` between `agent-diagram` markers:
+
+```bash
+make sync-diagrams
+```
+
+The catalog builder extracts those Mermaid blocks into `workflow_diagram`, and the static site renders them after Markdown parsing.

package/docs/site/app.js

@@ -2,11 +2,16 @@ let catalog;
 let current = null;
 let idx;
 let docs = [];
+let activeTheme = 'light';
 
 const menuEl = document.getElementById('menu');
 const contentEl = document.getElementById('content');
 const searchEl = document.getElementById('search');
 const langEl = document.getElementById('language');
+const themeToggleEl = document.getElementById('theme-toggle');
+
+applyTheme(getStoredTheme());
+configureMermaid();
 
 init();
 
@@ -91,6 +96,8 @@ ${wf.description || ''}
 ## Roles
 ${(wf.roles || []).map((r) => `<span class="chip">${r}</span>`).join(' ')}
 
+${wf.workflow_diagram ? `## Agent Interaction Diagram\n\n\`\`\`mermaid\n${escapeFence(wf.workflow_diagram)}\n\`\`\`` : ''}
+
 ## Quality gates
 ${(wf.quality_gates || []).map((q) => `- ${q}`).join('\n') || '- —'}
 
@@ -106,12 +113,66 @@ ${examples || '_No examples_'}
 `;
 
   contentEl.innerHTML = marked.parse(md);
+  renderMermaidBlocks();
+}
+
+function getStoredTheme() {
+  try {
+    const theme = window.localStorage.getItem('docs-site-theme');
+    return theme === 'dark' ? 'dark' : 'light';
+  } catch {
+    return 'light';
+  }
+}
+
+function storeTheme(theme) {
+  try {
+    window.localStorage.setItem('docs-site-theme', theme);
+  } catch {
+    // localStorage can be unavailable in private or restricted browser modes.
+  }
+}
+
+function applyTheme(theme) {
+  activeTheme = theme === 'dark' ? 'dark' : 'light';
+  document.documentElement.dataset.theme = activeTheme;
+  if (!themeToggleEl) return;
+  const isDark = activeTheme === 'dark';
+  themeToggleEl.setAttribute('aria-pressed', String(isDark));
+  themeToggleEl.textContent = isDark ? 'Light' : 'Dark';
+}
+
+function configureMermaid() {
+  if (!window.mermaid) return;
+  window.mermaid.initialize({
+    startOnLoad: false,
+    securityLevel: 'strict',
+    theme: activeTheme === 'dark' ? 'dark' : 'default',
+  });
 }
 
 function escapeFence(s) {
   return (s || '').replace(/```/g, '\\\`\\\`\\\`');
 }
 
+async function renderMermaidBlocks() {
+  const blocks = [...contentEl.querySelectorAll('code.language-mermaid')];
+  if (!blocks.length) return;
+
+  const nodes = blocks.map((block) => {
+    const diagram = document.createElement('div');
+    diagram.className = 'mermaid';
+    diagram.textContent = block.textContent;
+    block.parentElement.replaceWith(diagram);
+    return diagram;
+  });
+
+  if (window.mermaid) {
+    configureMermaid();
+    await window.mermaid.run({ nodes });
+  }
+}
+
 searchEl.addEventListener('input', () => {
   const q = searchEl.value.trim();
   if (!q) {
@@ -125,3 +186,10 @@ searchEl.addEventListener('input', () => {
 langEl.addEventListener('change', () => {
   if (current) renderWorkflow(current.id);
 });
+
+themeToggleEl.addEventListener('click', () => {
+  const nextTheme = activeTheme === 'dark' ? 'light' : 'dark';
+  applyTheme(nextTheme);
+  storeTheme(nextTheme);
+  if (current) renderWorkflow(current.id);
+});