datarobot-oss/datarobot-agent-skills / skills/datarobot-gap-analysis
datarobot-gap-analysis
FlaggedUse when the user wants to assess whether an AI agent repository (DataRobot-built or not) is enterprise-ready, run a gap analysis / readiness scan against security, governance, reliability, or regulatory standards, score an agent against EU AI Act requirements, or find and fix gaps (secrets, unpinned models, missing CI, missing guardrails, over-permissioned identity, etc.) before deploying an agent to production. Works on any repository, not only ones built with DataRobot.
scripts/gap_analysis/report_html.py
View on GitHub# Copyright (c) 2026 DataRobot, Inc. All rights reserved.
# SPDX-License-Identifier: Apache-2.0
"""Render the analysis result as a self-contained, styled HTML page.
Same data as report.py (posture, findings, scorecards) — different presentation. One
file, inline CSS + JS, no external assets, no server. Open it in a browser or share it.
All repo-derived text is HTML-escaped (repo content is untrusted).
"""
from __future__ import annotations
import html
import shutil
import sys
from pathlib import Path
from typing import Any
from .agent_prompt import agent_prompt
from .models import PILLARS, AnalysisResult, Finding
from .report import (
CONFORMANCE_ROWS,
_clip,
_short_title,
approval_caveat,
compliance_path,
coverage_lines,
python_label,
usage_rows,
)
_SEV_LABEL = {"critical": "CRITICAL", "high": "HIGH", "medium": "MEDIUM", "low": "LOW"}
_FIX_LABEL = {"auto": "auto-fix", "assisted": "assisted-fix", "advisory": "advisory"}
_RISK_LABEL = {"plumbing": "plumbing", "business_logic": "business-logic"}
_POSTURE = { # recommendation -> (label, css class)
"PATCH": ("PATCH", "patch"),
"HYBRID": ("HYBRID", "hybrid"),
"RE-PLATFORM": ("RE-PLATFORM", "replatform"),
}
def _esc(s: Any) -> str:
return html.escape("" if s is None else str(s))
def _cli_prog() -> str:
"""How to invoke the CLI in the copied commands.
In the vendored-skill case there is no installed console script: the
runnable entrypoint is scripts/run_gap_analysis.py two levels up from this
module, launched through `uv run` (uv is a skill prerequisite), so the
copied command works from any directory with no venv activation. Fall back
to a `gap-analysis` console script for the installed-package case.
"""
launcher = Path(__file__).resolve().parent.parent / "run_gap_analysis.py"
if launcher.exists():
path = str(launcher)
return f'uv run "{path}"' if " " in path else f"uv run {path}"
sibling = Path(sys.executable).resolve().parent / "gap-analysis"
if sibling.exists():
return str(sibling)
return shutil.which("gap-analysis") or "gap-analysis"
def _cmd_target(repo: str) -> str:
"""The repo/path argument for the gap-analysis command (quoted if it has spaces)."""
target = repo or "<repo>"
return f'"{target}"' if " " in target else target
def _quote(path: str) -> str:
return f'"{path}"' if " " in path else path
def _fix_cmd(repo: str, finding: Finding, findings_path: str = "") -> str:
"""The terminal command for one deterministic codemod, reusing the saved
findings so nothing is re-analyzed. The findings file is named by absolute
path because the report is often written far from the shell's cwd."""
return (
f"{_cli_prog()} {_cmd_target(repo)} --fix --select {finding.condition_id} "
f"--from {_quote(findings_path or 'gap-findings.json')}"
)
def _fix_all_cmd(repo: str, findings_path: str = "") -> str:
"""Every deterministic plumbing codemod at once, from the saved findings."""
return (
f"{_cli_prog()} {_cmd_target(repo)} --fix "
f"--from {_quote(findings_path or 'gap-findings.json')}"
)
def _migrate_cmd(repo: str, advice: str = "") -> str:
"""Re-platforming has no CLI flag; it is a request to the coding agent."""
target = repo or "<repo>"
return f"For {target}: {advice} Do not change the agent framework unless I ask."
def _meta_row(items: list[str]) -> str:
"""Header facts as flex items with a divider per item, so a wrapped line
breaks between items instead of stranding a separator at the edge."""
return (
'<p class="meta">'
+ "".join(f'<span class="meta-item">{item}</span>' for item in items)
+ "</p>"
)
def _verification_banner(v: dict[str, Any]) -> str:
"""Post-fix 'is it ready to deploy?' banner: before->after score + verdict."""
ready = bool(v.get("ready"))
cls = "ready" if ready else "notready"
verdict = "✅ Ready to deploy" if ready else "⛔ Not ready to deploy"
b, a = v.get("before", {}), v.get("after", {})
fail_on = ", ".join(v.get("fail_on", [])) or "critical/high"
blocking = v.get("remaining_blocking", 0)
sub = (
f"No {fail_on} gaps remain on the fixed branch."
if ready
else f"{blocking} {fail_on} gap(s) still remain — not safe to ship yet."
)
out = [f'<section class="verify {cls}">']
out.append(
f'<div class="verify-top"><span class="badge">{verdict}</span>'
f'<span class="verify-sub">{_esc(sub)}</span></div>'
)
# before -> after deltas
rows = [
(
f"<b>{v.get('closed', 0)}</b> gaps closed "
f"({b.get('total', 0)} → {a.get('total', 0)} total)"
),
f"posture {_esc(b.get('posture', '?'))} → {_esc(a.get('posture', '?'))}",
]
deltas = []
for sev in ("critical", "high", "medium", "low"):
bc = (b.get("counts") or {}).get(sev, 0)
ac = (a.get("counts") or {}).get(sev, 0)
if bc or ac:
arrow = "▼" if ac < bc else ("▲" if ac > bc else "=")
deltas.append(f"{_SEV_LABEL[sev].title()} {bc}→{ac} {arrow}")
out.append('<p class="verify-line">' + " · ".join(rows) + "</p>")
out.append(
'<p class="verify-line deltas">'
+ " ".join(_esc(d) for d in deltas)
+ "</p>"
)
if v.get("branch") or v.get("workspace"):
out.append(
'<p class="verify-loc">Fixed branch <code>'
+ _esc(v.get("branch", ""))
+ "</code> in <code>"
+ _esc(v.get("workspace", ""))
+ "</code></p>"
)
out.append(
'<p class="verify-note">Note: <code>--fix</code> patches the existing repo in '
"place; it does not adopt the af-component stack. Re-platforming onto "
"af-components is the migration path (RE-PLATFORM posture).</p>"
)
out.append("</section>")
return "\n".join(out)
def render_html(
result: AnalysisResult,
repo: str = "",
policy: dict[str, Any] | None = None,
verification: dict[str, Any] | None = None,
findings_path: str = "",
) -> str:
counts = result.counts()
total = len(result.findings)
inv = result.inventory or {}
body: list[str] = []
# Header
body.append('<header class="hdr">')
body.append(
'<button id="themebtn" class="themebtn" onclick="cycleTheme()" '
'title="Switch theme: auto (system) / light / dark">'
'<span class="glyph">◐</span><span class="lbl">Auto</span></button>'
)
body.append("<h1>Enterprise-Readiness Gap Report</h1>")
meta = []
if repo:
meta.append(f"<b>Repository:</b> {_esc(repo)}")
if inv:
meta.append(f"<b>Files scanned:</b> {inv.get('file_count', 0)}")
meta.append(f"<b>Python:</b> {_esc(python_label(inv))}")
if meta:
body.append(_meta_row(meta))
stack = []
if inv.get("template_sources"):
stack.append("<b>Template:</b> " + _esc(", ".join(inv["template_sources"])))
if inv.get("datarobot_app"):
stack.append(
"<b>Deploys as:</b> DataRobot custom application "
f"(<code>{_esc(inv['datarobot_app']['file'])}</code>)"
)
if inv.get("agent_frameworks"):
stack.append(
"<b>Agent framework:</b> "
+ ", ".join(
f"{_esc(f['name'])} ({'native DataRobot template' if f['native'] else 'Base template'})"
for f in inv["agent_frameworks"]
)
)
if stack:
body.append(_meta_row(stack))
body.append("</header>")
# Post-fix verification banner (deploy-readiness), when this is an "after" report.
if verification:
body.append(_verification_banner(verification))
# Prerequisites note — the fix buttons copy a terminal command; nothing is
# executed from this page.
if result.findings:
body.append(
'<p class="prereq">ℹ️ Nothing runs from this page. Deterministic fixes copy a '
"terminal command that reuses this run's <code>gap-findings.json</code> by its "
"full path, so "
"nothing is re-analyzed, and land on a <code>gap-fixes/*</code> branch. Every other "
"finding copies a prompt for your own coding agent, which can read the repo, "
"edit and run the tests.</p>"
)
# Posture banner
if result.posture:
body.append(_posture_banner(result.posture, repo))
# Severity summary chips (clickable filters)
body.append('<section class="summary">')
body.append(f'<p class="total">{total} gaps</p>')
body.append('<div class="chips">')
body.append(
'<button class="chip chip-all active" data-sev="all" '
'onclick="filterSev(this)">All</button>'
)
for sev in ("critical", "high", "medium", "low"):
body.append(
f'<button class="chip chip-{sev}" data-sev="{sev}" onclick="filterSev(this)">'
f'{_SEV_LABEL[sev]} <span class="n">{counts[sev]}</span></button>'
)
body.append("</div>")
fixable = sum(1 for f in result.findings if f.fix_type in ("auto", "assisted"))
auto = sum(1 for f in result.findings if f.fix_type == "auto")
body.append(
f'<p class="sub">{fixable} of {total} fixable ({auto} automatically). '
"Plumbing fixes are safe to sweep; business-logic fixes are applied only when "
"selected by id.</p>"
)
body.append('<div class="coverage"><b>Coverage of this run</b><ul>')
for c in coverage_lines(result):
cls = ' class="warn"' if "NOT ASSESSED" in c or "skipped" in c else ""
body.append(f"<li{cls}>{_esc(c)}</li>")
body.append("</ul></div>")
body.append("</section>")
# Findings grouped by pillar
body.append('<section class="findings">')
has_auto = any(f.fix_type == "auto" for f in result.findings)
fixall_btn = ""
if has_auto:
fixall_btn = (
f'<button class="fixbtn fixall" data-cmd="{_esc(_fix_all_cmd(repo, findings_path))}" '
'onclick="copyCmd(this)" title="Copies a terminal command that applies '
'all auto-fixable (plumbing) fixes on a gap-fixes/* branch">'
"⧉ Fix all auto-fixable</button>"
)
body.append(
'<div class="findings-head"><h2>Findings</h2><div class="head-actions">'
+ fixall_btn
+ '<button class="toggle-all" onclick="toggleAll()">Collapse all</button>'
"</div></div>"
)
by_pillar: dict[str, list[Finding]] = {}
for f in result.by_severity():
by_pillar.setdefault(f.pillar, []).append(f)
if not result.findings:
body.append('<p class="empty">No gaps detected.</p>')
for pillar in [p for p in PILLARS if p in by_pillar and p != "POL"]:
items = by_pillar[pillar]
body.append('<details class="pillar" open>')
body.append(
f'<summary>{_esc(PILLARS[pillar])} <span class="pill-id">({pillar})</span>'
f'<span class="count">{len(items)}</span></summary>'
)
for f in items:
body.append(_finding_card(f, repo, findings_path))
body.append("</details>")
body.append("</section>")
# Scorecards
found_ids = {f.condition_id for f in result.findings}
body.append(_conformance_section(found_ids, approval_caveat(result)))
body.append(_regulatory_section(result, repo, findings_path))
# Skips & notes
if result.skipped:
body.append(
'<section class="notes"><details><summary><h2>Not Evaluated (skipped) '
f'<span class="count">{len(result.skipped)}</span></h2></summary><ul>'
)
for s in result.skipped:
body.append(
f"<li><b>{_esc(s.condition_id)}</b>: {_esc(_clip(s.reason))}</li>"
)
body.append("</ul></details></section>")
if result.notes:
body.append('<section class="notes"><h2>Engine Notes</h2><ul>')
for n in result.notes:
body.append(f"<li>{_esc(n)}</li>")
body.append("</ul></section>")
if result.usage.get("total", {}).get("calls"):
body.append(_usage_section(result.usage))
body.append(
"<footer>Secret values are never shown. DataRobot risk-management "
"findings are advisory and not legal advice.</footer>"
)
return _DOC.replace("{{BODY}}", "\n".join(body))
def _posture_banner(posture: dict[str, Any], repo: str = "") -> str:
rec = posture.get("recommendation", "PATCH")
label, cls = _POSTURE.get(rec, (rec, "patch"))
pct = round(posture.get("score", 0.0) * 100)
out = [f'<section class="posture {cls}">']
out.append(
f'<div class="posture-top"><span class="badge">{_esc(label)}</span>'
f'<span class="posture-meta">structural risk {pct}% · '
f"{posture.get('structural_count', 0)} of {posture.get('total', 0)} gaps "
f"structural</span></div>"
)
out.append(f'<p class="rationale">{_esc(posture.get("rationale", ""))}</p>')
drivers = posture.get("drivers") or []
if drivers:
out.append(
'<details class="drivers"><summary>Structural drivers '
"(can't be surgically patched)</summary><ul>"
)
for d in drivers:
sev = d.get("severity", "")
out.append(
f'<li><span class="dot dot-{_esc(sev)}"></span>'
f"<b>{_esc(d.get('condition_id'))}</b> {_esc(_SEV_LABEL.get(sev, sev))} — "
f"{_esc(d.get('title'))}</li>"
)
out.append("</ul>")
if rec != "PATCH":
out.append(f'<p class="hint">{_esc(posture.get("advice", ""))}</p>')
out.append(
f'<button class="fixbtn migrate" data-cmd="{_esc(_migrate_cmd(repo, posture.get("advice", "")))}" '
'onclick="copyCmd(this)" title="Copy the request to hand to your coding agent">'
"⧉ Copy re-platform request</button>"
)
out.append("</details>")
out.append("</section>")
return "\n".join(out)
def _finding_card(f: Finding, repo: str = "", findings_path: str = "") -> str:
sev = f.severity.value
loc = (
"repo-wide" if not f.file else (_esc(f.file) + (f":{f.line}" if f.line else ""))
)
fix = _FIX_LABEL.get(f.fix_type, f.fix_type)
risk = _RISK_LABEL.get(f.fix_risk)
risk_html = (
f'<span class="tag tag-{_esc(f.fix_risk)}">{_esc(risk)}</span>' if risk else ""
)
conf = (
""
if f.confidence == "high"
else f'<span class="conf">confidence: {_esc(f.confidence)}</span>'
)
verify_html = (
f'<div class="kv"><span class="k">Verification</span><span class="v">{_esc(f.verification)}</span></div>'
if f.verification
else ""
)
return (
f'<article class="card sev-{sev}" data-sev="{sev}">'
f'<div class="card-head">'
f'<span class="cid">{_esc(f.condition_id)}</span>'
f'<span class="tag tag-sev tag-{sev}">{_SEV_LABEL[sev]}</span>'
f'<span class="tag tag-fix">{_esc(fix)}</span>{risk_html}'
f'<span class="title">{_esc(f.title)}</span>{conf}'
f"</div>"
f'<div class="kv"><span class="k">Where</span><span class="v"><code>{loc}</code></span></div>'
f'<div class="kv"><span class="k">Evidence</span><span class="v">{_esc(f.evidence) or "—"}</span></div>'
f'<div class="kv"><span class="k">Why it matters</span><span class="v">{_esc(f.explanation) or "—"}</span></div>'
f'<div class="kv"><span class="k">Fix</span><span class="v">{_esc(f.remediation) or "—"}</span></div>'
f"{verify_html}"
f"{_fix_details_html(f)}"
f"{_fix_action(f, repo, findings_path)}"
f"</article>"
)
def _fix_details_html(f: Finding) -> str:
out = []
if f.prerequisite:
out.append(
f'<div class="kv"><span class="k">Needs</span><span class="v">{_esc(f.prerequisite)}</span></div>'
)
if f.steps:
items = "".join(f"<li>{_esc(s)}</li>" for s in f.steps)
out.append(
f'<div class="kv"><span class="k">How</span><span class="v"><ol class="steps">{items}</ol></span></div>'
)
docs = _docs_link(f)
if docs:
out.append(
f'<div class="kv"><span class="k">Docs</span><span class="v">{docs}</span></div>'
)
return "".join(out)
def _fix_action(f: Finding, repo: str, findings_path: str = "") -> str:
"""The actionable footer of a card.
Deterministic codemods get a terminal command that reuses the saved
findings. Everything else gets a prompt for the user's own coding agent,
which can read the repo, edit and run tests where a one-shot edit cannot.
"""
if f.fix_type == "auto":
cmd = _fix_cmd(repo, f, findings_path)
return (
'<div class="card-action">'
f'<button class="fixbtn" data-cmd="{_esc(cmd)}" onclick="copyCmd(this)" '
'title="Copy the terminal command that applies this codemod">'
"⧉ Copy fix command</button>"
f'<code class="cmd">{_esc(cmd)}</code><span class="ok">deterministic fix</span>'
"</div>"
)
prompt = agent_prompt(f, repo)
if f.fix_risk == "business_logic":
note = (
'<span class="warn">⚠ touches business logic: the prompt asks the agent to '
"add a test and stop before pushing</span>"
)
elif f.fix_type == "assisted":
note = '<span class="ok">paste into Claude Code, Cursor, opencode or any coding agent</span>'
else:
note = (
'<span class="manual">📝 advisory: the prompt carries the guidance for a '
"human or agent to act on</span>"
)
return (
'<div class="card-action">'
f'<button class="fixbtn" data-cmd="{_esc(prompt)}" data-kind="prompt" '
'onclick="copyCmd(this)" title="Copy a prompt for your coding agent">'
"⧉ Copy agent prompt</button>"
f"{note}"
f'<details class="prompt-preview"><summary>show prompt</summary>'
f"<pre>{_esc(prompt)}</pre></details>"
"</div>"
)
def _usage_section(usage: dict[str, Any]) -> str:
model = usage.get("model") or "?"
effort = usage.get("reasoning_effort")
lead = (
f"Model <code>{_esc(model)}</code>"
+ (
f", reasoning effort <code>{_esc(effort)}</code>"
if effort
else ", no reasoning mode requested"
)
+ ". Tokens as reported by the DataRobot LLM Gateway per call. Cached tokens "
"are already inside Input and reasoning tokens inside Output; the columns "
"break those totals down, they do not add to them."
)
rows = []
for label, row in usage_rows(usage):
cls = ' class="total"' if label == "Total" else ""
rows.append(
f"<tr{cls}><td>{_esc(label)}</td><td>{row.get('calls', 0)}</td>"
f"<td>{row.get('input_tokens', 0):,}</td><td>{row.get('cache_read_tokens', 0):,}</td>"
f"<td>{row.get('output_tokens', 0):,}</td>"
f"<td>{row.get('reasoning_tokens', 0):,}</td></tr>"
)
return (
'<section class="scorecard usage"><h2>LLM Gateway Usage</h2>'
f'<p class="sub">{lead}</p>'
"<table><thead><tr><th>Phase</th><th>Calls</th><th>Input</th><th>of which cached</th>"
"<th>Output</th><th>of which reasoning</th></tr></thead><tbody>"
+ "".join(rows)
+ "</tbody></table></section>"
)
def _conformance_section(found_ids: set[str], caveat: bool = False) -> str:
rows = []
for cid, label in CONFORMANCE_ROWS:
gap = cid in found_ids
pass_label = (
"pass (gateway-served ids treated as approved)"
if caveat and cid in ("ITA-003", "AIG-003")
else "pass"
)
status = _status_html("gap") if gap else _status_html("pass", pass_label)
rows.append(f"<tr><td>{_esc(cid)} — {_esc(label)}</td><td>{status}</td></tr>")
return (
'<section class="scorecard"><h2>IT Conformance Scorecard</h2>'
"<table><thead><tr><th>Control</th><th>Status</th></tr></thead><tbody>"
+ "".join(rows)
+ "</tbody></table></section>"
)
# Status glyphs as inline SVG so they share the text baseline; emoji sit on their own.
_STATUS_TEXT = {
"gap": "gap",
"pass": "evidence found",
"not_assessed": "not assessed",
"not_applicable": "not applicable",
"referenced": "existing deployment",
"unknown_type": "unknown",
}
_STATUS_PATH = {
"gap": "M6 6l12 12M18 6L6 18",
"pass": "M5 12.5l4.5 4.5L19 7",
"not_applicable": "M6 12h12",
"referenced": "M10 14a4 4 0 0 1 0-5.5l2-2a4 4 0 0 1 5.5 5.5l-1 1M14 10a4 4 0 0 1 0 5.5l-2 2A4 4 0 0 1 6.5 12l1-1",
"not_assessed": "M9 9.5a3 3 0 1 1 4.3 2.7c-1 .5-1.3 1.2-1.3 2.3M12 18h.01",
}
def _status_html(status: str, label: str | None = None) -> str:
css = {"gap": "gap", "pass": "pass"}.get(status, "skip")
path = _STATUS_PATH.get(status, _STATUS_PATH["not_assessed"])
svg = (
'<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" '
f'stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="{path}"/></svg>'
)
return f'<span class="st {css}">{svg}{_esc(label or _STATUS_TEXT.get(status, status))}</span>'
def _docs_link(f: Finding, label: str | None = None) -> str:
if f.docs_url:
return (
f'<a href="{_esc(f.docs_url)}" target="_blank" rel="noopener" '
f'onclick="event.stopPropagation()">{_esc(label or f.docs_url)}</a>'
)
if f.docs_topic:
return f'<span class="muted">search docs.datarobot.com for {_esc(repr(f.docs_topic))}</span>'
return ""
def _regulatory_section(
result: AnalysisResult, repo: str = "", findings_path: str = ""
) -> str:
"""Layer 4 in one place: every required mitigation grouped by the step that
closes it, each gap expandable to its evidence and fix; then what passed and
what could not be assessed."""
coverage = result.regulatory_coverage
head = '<section class="scorecard reg"><h2>DataRobot Risk-Management Coverage</h2>'
if not coverage:
return (
head + '<p class="empty">No DataRobot risk-management policy was reachable '
"for this run (see Engine Notes below for why); nothing to show here. "
"There is no local fallback checklist, this section is empty rather "
"than misleadingly reassuring.</p></section>"
)
gaps = [f for f in result.findings if f.pillar == "POL"]
passed = [r for r in coverage if r["status"] == "pass"]
inapplicable = [r for r in coverage if r["status"] == "not_applicable"]
referenced = [r for r in coverage if r["status"] == "referenced"]
unassessed = [
r
for r in coverage
if r["status"] not in ("pass", "gap", "not_applicable", "referenced")
]
out = [
head,
(
f'<p class="sub">{len(coverage)} required mitigation(s): {len(gaps)} gap(s), '
f"{len(passed)} with evidence, {len(referenced)} provided by an existing "
f"deployment, {len(inapplicable)} not applicable, {len(unassessed)} not "
"assessed. Expand a gap for its evidence and fix.</p>"
),
]
for i, step in enumerate(compliance_path(result), start=1):
out.append(
f'<h3 class="step">{i}. {_esc(step["title"])}</h3>'
f'<p class="path-lead">{_esc(step["detail"])}</p>'
)
for f in step["items"]:
out.append(
'<details class="mit"><summary>'
f"{_status_html('gap')}"
f'<span class="mit-title">{_esc(_short_title(f))}</span>'
f"<code>{_esc(f.condition_id)}</code>{_docs_link(f, 'docs')}</summary>"
f"{_finding_card(f, repo, findings_path)}</details>"
)
if passed:
out.append('<h3 class="step">Evidence found</h3><ul class="mit-list">')
out.extend(
f"<li>{_status_html('pass')} {_esc(r['title'])}</li>" for r in passed
)
out.append("</ul>")
if referenced:
out.append(
'<h3 class="step">Provided by an existing deployment</h3>'
'<p class="path-lead">The active program references a deployment another '
"stack owns; verify these on that deployment in DataRobot.</p>"
'<ul class="mit-list">'
)
out.extend(
f"<li>{_status_html('referenced')} {_esc(r['title'])}"
f'<span class="muted"> · {_esc(r.get("reason", ""))}</span></li>'
for r in referenced
)
out.append("</ul>")
if inapplicable:
out.append(
'<h3 class="step">Not applicable to this repo</h3>'
'<p class="path-lead">The platform evaluates these only for certain target '
"types or entities; this repo is outside them.</p>"
'<ul class="mit-list">'
)
out.extend(
f"<li>{_status_html('not_applicable')} {_esc(r['title'])}"
f'<span class="muted"> · {_esc(r.get("reason", ""))}</span></li>'
for r in inapplicable
)
out.append("</ul>")
if unassessed:
out.append('<h3 class="step">Required, not assessed</h3><ul class="mit-list">')
out.extend(
f"<li>{_status_html(r['status'])} {_esc(r['title'])}</li>"
for r in unassessed
)
out.append("</ul>")
out.append("</section>")
return "".join(out)
_DOC = """\
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light dark">
<meta name="darkreader-lock">
<title>Gap Report</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Roboto+Mono:wght@400;500&display=swap" rel="stylesheet">
<script>
try{var _t=localStorage.getItem('gap-theme');
if(_t==='light'||_t==='dark')document.documentElement.setAttribute('data-theme',_t);}catch(e){}
</script>
<style>
:root{
/* dr-ui semantic tokens (alpine-light palette). Severity and state colors are
the theme's destructive / warning / success / muted-foreground roles. */
--dr-radius:0.375rem;
--bg:oklch(0.9817 0.0057 264.53); --card:oklch(1 0 0); --popover:oklch(0.9634 0.0115 264.51);
--muted-bg:oklch(0.9149 0.0146 264.49); --line:oklch(0.8486 0.0248 259.82);
--ink:oklch(0.2352 0.0059 271.16); --muted:oklch(0.5533 0.0224 260.15);
--primary:oklch(0.2352 0.0059 271.16); --primary-ink:oklch(1 0 0);
--accent:oklch(0.6226 0.1981 281.26); --accent-bg:oklch(0.9793 0.0083 271.33);
--link:oklch(0.4667 0.1532 256.44);
--ok:oklch(0.5553 0.1431 152.95); --warn:oklch(0.5533 0.1149 79.08); --bad:oklch(0.5585 0.1652 24.19);
--crit:var(--bad); --high:oklch(0.6702 0.1689 52.07); --med:var(--warn); --med-ink:var(--warn); --low:var(--muted);
--ok-bg:color-mix(in oklch, var(--ok) 12%, var(--card)); --bad-bg:color-mix(in oklch, var(--bad) 12%, var(--card));
--warn-bg:color-mix(in oklch, var(--warn) 12%, var(--card)); --warn-line:color-mix(in oklch, var(--warn) 35%, var(--card));
--warn-ink:var(--warn); --code-bg:oklch(0.9634 0.0115 264.51); --code-ink:oklch(0.2352 0.0059 271.16);
--code-line:oklch(0.8486 0.0248 259.82);
/* saturated fills for banners carry white text in both themes */
--ok-fill:oklch(0.5553 0.1431 152.95); --high-fill:oklch(0.6702 0.1689 52.07); --bad-fill:oklch(0.5585 0.1652 24.19);
--med-fill:oklch(0.5533 0.1149 79.08); --low-fill:oklch(0.5533 0.0224 260.15);
}
@media (prefers-color-scheme: dark){
:root:not([data-theme="light"]){
--bg:oklch(0.2274 0.0108 242.21); --card:oklch(0.2694 0.0104 242.08); --popover:oklch(0.3058 0.0137 248.27);
--muted-bg:oklch(0.3871 0.0165 251.76); --line:oklch(0.3871 0.0165 251.76);
--ink:oklch(0.9383 0.0042 236.5); --muted:oklch(0.6731 0.0174 253.95);
--primary:oklch(1 0 0); --primary-ink:oklch(0.2274 0.0108 242.21);
--accent:oklch(0.7179 0.1312 277.26); --accent-bg:oklch(0.3871 0.0165 251.76);
--code-bg:oklch(0.2274 0.0108 242.21); --code-ink:oklch(0.9383 0.0042 236.5);
--code-line:oklch(0.3871 0.0165 251.76);
--link:oklch(0.7024 0.1524 240.74);
--ok:oklch(0.7242 0.1737 153.06); --warn:oklch(0.8659 0.1555 103.53); --bad:oklch(0.6952 0.1538 21.86);
--high:oklch(0.7828 0.1141 61.47); --low-fill:oklch(0.5784 0.0175 248.13);
}
}
:root[data-theme="dark"]{
--bg:oklch(0.2274 0.0108 242.21); --card:oklch(0.2694 0.0104 242.08); --popover:oklch(0.3058 0.0137 248.27);
--muted-bg:oklch(0.3871 0.0165 251.76); --line:oklch(0.3871 0.0165 251.76);
--ink:oklch(0.9383 0.0042 236.5); --muted:oklch(0.6731 0.0174 253.95);
--primary:oklch(1 0 0); --primary-ink:oklch(0.2274 0.0108 242.21);
--accent:oklch(0.7179 0.1312 277.26); --accent-bg:oklch(0.3871 0.0165 251.76);
--code-bg:oklch(0.2274 0.0108 242.21); --code-ink:oklch(0.9383 0.0042 236.5);
--code-line:oklch(0.3871 0.0165 251.76);
--link:oklch(0.7024 0.1524 240.74);
--ok:oklch(0.7242 0.1737 153.06); --warn:oklch(0.8659 0.1555 103.53); --bad:oklch(0.6952 0.1538 21.86);
--high:oklch(0.7828 0.1141 61.47); --low-fill:oklch(0.5784 0.0175 248.13);
}
*{box-sizing:border-box}
body{margin:0;background:var(--bg);color:var(--ink);
font:14px/1.5 Inter,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif}
a{color:var(--link)} a:hover{text-decoration:underline}
code,.mono{font-family:"Roboto Mono",ui-monospace,Menlo,monospace}
.wrap{max-width:960px;margin:0 auto;padding:28px 20px 60px}
.hdr{position:relative}
.themebtn{position:absolute;top:0;right:0;cursor:pointer;border:1px solid var(--line);width:96px;height:30px;text-align:center;
background:var(--card);color:var(--muted);border-radius:var(--dr-radius);padding:0 12px;line-height:28px;
font-size:12px;font-weight:600}
.themebtn .glyph{display:inline-block;width:1.15em;text-align:center;margin-right:4px}
.themebtn .lbl{display:inline-block}
.themebtn:hover{color:var(--ink)}
.themebtn:focus{outline:none} .themebtn:focus-visible{border-color:var(--accent);color:var(--ink)}
h1{font-size:22px;margin:0 0 6px} h2{font-size:16px;margin:26px 0 12px}
.meta,.sub{color:var(--muted)} .meta{margin:4px 0 0;display:flex;flex-wrap:wrap;row-gap:2px}
.meta-item{padding-right:10px;margin-right:10px;border-right:1px solid var(--line);white-space:normal}
.meta-item:last-child{border-right:0;padding-right:0;margin-right:0}
.prereq{margin:14px 0 0;padding:9px 12px;background:var(--warn-bg);border:1px solid var(--warn-line);
border-radius:8px;color:var(--warn-ink);font-size:13px}
.prereq code{background:var(--code-bg);color:var(--code-ink);padding:1px 6px;border-radius:4px;font-size:12px}
/* post-fix verification */
.verify{margin:14px 0 0;border-radius:12px;padding:16px 18px;color:#fff}
.verify.ready{background:var(--ok-fill)} .verify.notready{background:var(--bad-fill)}
.verify-top{display:flex;align-items:center;gap:12px;flex-wrap:wrap}
.verify .badge{background:rgba(255,255,255,.22);padding:4px 12px;border-radius:999px;
font-weight:800;letter-spacing:.3px}
.verify-sub{opacity:.95} .verify-line{margin:8px 0 0} .verify-line.deltas{font-weight:600}
.verify-loc{margin:8px 0 0;opacity:.95} .verify-note{margin:8px 0 0;opacity:.85;font-size:12px}
.verify code{background:rgba(255,255,255,.22);padding:1px 6px;border-radius:4px}
section{margin-top:18px}
/* posture */
.reg h3.step{font-size:14px;margin:18px 0 2px} .path-lead{margin:0 0 8px;color:var(--muted)}
.mit{border-top:1px solid var(--line);padding:7px 0} .mit summary{cursor:pointer;display:flex;gap:10px;align-items:center;list-style:none}
.mit summary::-webkit-details-marker{display:none} .mit-title{flex:1} .mit .card{margin:8px 0 2px}
.mit-list{margin:0;padding:0;list-style:none} .mit-list li{border-top:1px solid var(--line);padding:7px 0;display:flex;gap:10px}
.muted{color:var(--muted)}
.steps{margin:0;padding-left:18px} .steps li{margin:2px 0}
.posture{border-radius:12px;padding:16px 18px;border:1px solid var(--line);color:#fff}
.posture.patch{background:var(--ok-fill)} .posture.hybrid{background:var(--high-fill)}
.posture.replatform{background:var(--bad-fill)}
.posture-top{display:flex;align-items:center;gap:12px;flex-wrap:wrap}
.posture .badge{background:rgba(255,255,255,.22);padding:4px 12px;border-radius:999px;
font-weight:700;letter-spacing:.5px}
.posture-meta{opacity:.9} .rationale{margin:10px 0 0}
.posture details{margin-top:10px} .posture summary{cursor:pointer;opacity:.95;font-weight:600}
.posture .drivers ul{margin:8px 0 0;padding-left:4px;list-style:none}
.posture .drivers li{padding:3px 0} .posture .hint{opacity:.92;margin:8px 0 0}
.posture code{background:rgba(255,255,255,.22);padding:1px 5px;border-radius:4px}
.dot{display:inline-block;width:9px;height:9px;border-radius:50%;margin-right:7px}
.dot-critical{background:#fff} .dot-high{background:rgba(255,255,255,.75)}
.dot-medium{background:rgba(255,255,255,.55)} .dot-low{background:rgba(255,255,255,.35)}
/* summary */
.total{font-size:18px;font-weight:700;margin:0}
.chips{display:flex;gap:8px;flex-wrap:wrap;margin:10px 0}
.chip{cursor:pointer;border:1px solid var(--line);background:var(--card);border-radius:999px;
padding:5px 12px;font-size:13px;font-weight:600;color:var(--ink)}
.chip .n{opacity:.6;margin-left:4px}
.chip.active{outline:2px solid var(--accent)}
.chip-critical{border-color:var(--crit);color:var(--crit)}
.chip-high{border-color:var(--high);color:var(--high)}
.chip-medium{border-color:var(--med);color:var(--med-ink)}
.chip-low{border-color:var(--low);color:var(--low)}
/* findings */
.findings-head{display:flex;align-items:center;justify-content:space-between}
.toggle-all{cursor:pointer;background:none;border:1px solid var(--line);border-radius:6px;
padding:4px 10px;color:var(--muted)}
details.pillar{background:var(--card);border:1px solid var(--line);border-radius:10px;
margin:10px 0;padding:6px 14px}
details.pillar>summary{cursor:pointer;font-weight:700;padding:6px 0;list-style:none}
details.pillar>summary::-webkit-details-marker{display:none}
.pill-id{color:var(--muted);font-weight:500}
.count{float:right;background:var(--muted-bg);border-radius:999px;padding:1px 9px;color:var(--muted)}
.card{border:1px solid var(--line);border-left:4px solid var(--low);border-radius:8px;
padding:11px 13px;margin:9px 0;background:var(--card)}
.card.sev-critical{border-left-color:var(--crit)}
.card.sev-high{border-left-color:var(--high)}
.card.sev-medium{border-left-color:var(--med)}
.card.sev-low{border-left-color:var(--low)}
.card-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-bottom:6px}
.cid{font-weight:700;font-family:"Roboto Mono",ui-monospace,Menlo,monospace}
.title{font-weight:600} .conf{color:var(--muted);font-size:12px}
.tag{font-size:11px;font-weight:700;border-radius:5px;padding:2px 7px;text-transform:uppercase;
letter-spacing:.3px}
.tag-sev{color:#fff}
.tag-critical{background:var(--bad-fill)} .tag-high{background:var(--high-fill)}
.tag-medium{background:var(--med-fill)} .tag-low{background:var(--low-fill)}
.tag-fix,.tag-plumbing,.tag-business_logic{background:transparent;border:1px solid currentColor;padding:1px 6px}
.tag-fix{color:var(--accent)} .tag-plumbing{color:var(--ok)} .tag-business_logic{color:var(--bad)}
.kv{display:flex;gap:10px;padding:2px 0}
.kv .k{flex:0 0 116px;color:var(--muted);font-size:12px;text-transform:uppercase;
letter-spacing:.3px;padding-top:1px}
.kv .v{flex:1} .kv code{background:var(--bg);padding:1px 5px;border-radius:4px}
.empty{color:var(--muted)}
.coverage{margin-top:10px;font-size:13px}
.coverage ul{margin:4px 0 0;padding-left:18px}
.coverage li{margin:2px 0}
.coverage li.warn{font-weight:600}
.usage table{font-size:13px}
.usage td{padding:6px 12px;color:var(--muted)}
.usage td:first-child{color:var(--ink)}
.usage td:not(:first-child),.usage th:not(:first-child){text-align:right;font-variant-numeric:tabular-nums}
.usage tr.total td{font-weight:500;color:var(--ink);border-top:1px solid var(--line);background:var(--bg)}
/* scorecards */
table{border-collapse:collapse;width:100%;background:var(--card);border:1px solid var(--line);
border-radius:8px;overflow:hidden}
th,td{text-align:left;padding:8px 12px;border-bottom:1px solid var(--line)}
th{background:var(--bg);font-size:12px;text-transform:uppercase;color:var(--muted)}
tr:last-child td{border-bottom:none}
.st{font-weight:700;display:inline-flex;align-items:center;gap:5px;white-space:nowrap}
.st svg{flex:none} .st.gap{color:var(--crit)} .st.pass{color:var(--ok)} .st.skip{color:var(--muted)}
.notes summary{cursor:pointer;list-style:none} .notes summary::-webkit-details-marker{display:none}
.notes summary h2{display:inline-block} .notes summary .count{float:none;margin-left:8px;font-size:12px;vertical-align:middle}
.notes ul{margin:0;padding-left:18px}
footer{margin-top:30px;color:var(--muted);font-size:12px;border-top:1px solid var(--line);
padding-top:12px}
/* fix actions */
.head-actions{display:flex;gap:8px;align-items:center}
.fixbtn{cursor:pointer;border:1px solid var(--accent);background:var(--accent-bg);color:var(--accent);
border-radius:6px;padding:4px 11px;font-size:12px;font-weight:700;white-space:nowrap}
.fixbtn:hover{background:var(--accent);color:var(--card)}
.fixbtn.fixall{border-color:var(--ok);background:var(--ok-bg);color:var(--ok)}
.prompt-preview{flex-basis:100%;margin-top:6px} .prompt-preview summary{cursor:pointer;font-size:12px;color:var(--muted)}
.prompt-preview pre{white-space:pre-wrap;font-size:12px;line-height:1.45;background:var(--code-bg);color:var(--code-ink);border:1px solid var(--code-line);padding:10px 12px;border-radius:4px;margin:6px 0 0}
.fixbtn.fixall:hover{background:var(--ok);color:var(--card)}
.fixbtn.migrate{margin-top:10px;border-color:#fff;background:rgba(255,255,255,.18);color:#fff}
.fixbtn.migrate:hover{background:#fff;color:var(--bad-fill)}
.card-action{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-top:9px;
padding-top:9px;border-top:1px dashed var(--line)}
.card-action .cmd{font-family:"Roboto Mono",ui-monospace,Menlo,monospace;font-size:12px;background:var(--code-bg);
color:var(--code-ink);border:1px solid var(--code-line);padding:3px 8px;border-radius:5px;user-select:all}
.card-action .warn{font-size:12px;color:var(--crit);font-weight:600}
.card-action .ok{font-size:12px;color:var(--ok);font-weight:600}
.card-action .manual{font-size:12px;color:var(--muted)}
#toast{position:fixed;left:50%;bottom:26px;transform:translateX(-50%) translateY(20px);
background:var(--ink);color:var(--bg);padding:10px 16px;border-radius:8px;font-size:13px;
box-shadow:0 6px 24px #0003;opacity:0;pointer-events:none;transition:.2s;max-width:80vw}
#toast.show{opacity:1;transform:translateX(-50%) translateY(0)}
#toast code{background:rgba(255,255,255,.18);padding:1px 6px;border-radius:4px}
</style>
</head>
<body>
<div class="wrap">
{{BODY}}
</div>
<div id="toast"></div>
<script>
var _toastTimer;
function showToast(html){
var t=document.getElementById('toast');
t.innerHTML=html; t.classList.add('show');
clearTimeout(_toastTimer);
_toastTimer=setTimeout(function(){t.classList.remove('show');},4200);
}
function copyCmd(btn){
var cmd=btn.dataset.cmd;
var isPrompt=btn.dataset.kind==='prompt';
function done(){
if(isPrompt){ showToast('Copied. Paste it into your coding agent (Claude Code, Cursor, opencode).'); return; }
showToast('Copied. Paste in your terminal:<br><code>'+cmd.replace(/&/g,'&').replace(/</g,'<')+'</code>');
}
if(navigator.clipboard && navigator.clipboard.writeText){
navigator.clipboard.writeText(cmd).then(done, function(){ fallback(cmd); done(); });
} else { fallback(cmd); done(); }
}
function fallback(cmd){
var ta=document.createElement('textarea'); ta.value=cmd;
ta.style.position='fixed'; ta.style.opacity='0'; document.body.appendChild(ta);
ta.select(); try{document.execCommand('copy');}catch(e){} document.body.removeChild(ta);
}
function filterSev(btn){
document.querySelectorAll('.chip').forEach(c=>c.classList.remove('active'));
btn.classList.add('active');
var sev=btn.dataset.sev;
document.querySelectorAll('.card').forEach(function(c){
c.style.display=(sev==='all'||c.dataset.sev===sev)?'':'none';
});
// hide a pillar block whose cards are all filtered out
document.querySelectorAll('details.pillar').forEach(function(p){
var any=[].some.call(p.querySelectorAll('.card'),x=>x.style.display!=='none');
p.style.display=any?'':'none';
});
}
function toggleAll(){
var ps=document.querySelectorAll('details.pillar');
var anyOpen=[].some.call(ps,p=>p.open);
ps.forEach(p=>p.open=!anyOpen);
document.querySelector('.toggle-all').textContent=anyOpen?'Expand all':'Collapse all';
}
function applyTheme(t){
if(t==='light'||t==='dark'){document.documentElement.setAttribute('data-theme',t);}
else{document.documentElement.removeAttribute('data-theme');t='auto';}
var b=document.getElementById('themebtn');
if(b){
var g=t==='auto'?'\u25d0':(t==='light'?'\u2600':'\u263e');
var l=t==='auto'?'Auto':(t==='light'?'Light':'Dark');
b.innerHTML='<span class="glyph">'+g+'</span><span class="lbl">'+l+'</span>';
}
try{localStorage.setItem('gap-theme',t);}catch(e){}
}
function cycleTheme(){
var cur='auto'; try{cur=localStorage.getItem('gap-theme')||'auto';}catch(e){}
applyTheme(cur==='auto'?'light':(cur==='light'?'dark':'auto'));
}
(function(){var t='auto';try{t=localStorage.getItem('gap-theme')||'auto';}catch(e){}
applyTheme(t);})();
</script>
</body>
</html>
"""
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |