Skip to content

ThomasMoreAI/legal-skills-open / br/litigation/skills/juriscan-brunobracaioli

juriscan-brunobracaioli

Verified

Análise forense de processos judiciais brasileiros. Extrai, classifica e cruza peças processuais, detecta contradições, calcula prazos CPC e gera relatórios de risco com exportação para Obsidian. Use quando mencionar: processo judicial, petição, sentença, acórdão, contradições, prazos, timeline, análise forense, Obsidian.

FileKindSize
.claude/agents/juriscan-advogado-autor.mdmarkdown4.3 KB
.claude/agents/juriscan-advogado-reu.mdmarkdown3.6 KB
.claude/agents/juriscan-auditor-processual.mdmarkdown7.0 KB
.claude/agents/juriscan-echo.mdmarkdown2.0 KB
.claude/agents/juriscan-parser.mdmarkdown4.7 KB
.claude/agents/juriscan-segmenter.mdmarkdown4.9 KB
.claude/agents/juriscan-sintetizador.mdmarkdown3.1 KB
.claude/agents/juriscan-verificador.mdmarkdown4.8 KB
.github/FUNDING.ymlconfig77 B
.github/workflows/ci.ymlconfig1.0 KB
.gitignoreother121 B
CHANGELOG.mdmarkdown20.6 KB
CLAUDE.mdmarkdown10.6 KB
LICENSEother1.0 KB
README.mdmarkdown16.9 KB
SKILL.mdskill md26.3 KB
assets/banner.svgother4.7 KB
docs/architecture.mdmarkdown10.3 KB
docs/index.htmlother4.3 KB
docs/operations.mdmarkdown6.7 KB
docs/subagent_contract.mdmarkdown6.0 KB
docs/subagents.mdmarkdown5.5 KB
install.shscript3.2 KB
pyproject.tomlmanifest272 B
references/agent_schemas/advogado_output.jsonconfig2.7 KB
references/agent_schemas/auditor_output.jsonconfig4.8 KB
references/agent_schemas/echo_output.jsonconfig666 B
references/agent_schemas/parser_output.jsonconfig4.4 KB
references/agent_schemas/recommendations_output.jsonconfig2.5 KB
references/agent_schemas/segmenter_output.jsonconfig2.9 KB
references/agent_schemas/sintetizador_output.jsonconfig2.7 KB
references/agent_schemas/verificador_output.jsonconfig2.3 KB
references/appellate_structure.mdmarkdown2.0 KB
references/binding_precedents.mdmarkdown2.2 KB
references/brazilian_legal_entities.mdmarkdown3.2 KB
references/chunk_analysis_schema.jsonconfig6.7 KB
references/cpc_prazos.jsonconfig4.4 KB
references/feriados_forenses.jsonconfig2.1 KB
references/output_schema.jsonconfig11.0 KB
references/output_schema_v2.jsonconfig11.0 KB
references/output_schema_v3.jsonconfig5.3 KB
references/piece_type_taxonomy.jsonconfig7.5 KB
references/prompt_templates.mdmarkdown11.8 KB
references/risk_scoring_rubric.mdmarkdown2.4 KB
references/whitelist_fontes.jsonconfig1.8 KB
requirements.txtmanifest250 B
scripts/__init__.pyscript0 B
scripts/agent_io.pyscript12.2 KB
scripts/analyzed_init.pyscript3.3 KB
scripts/audit.pyscript4.8 KB
scripts/cleanup_audit.pyscript2.0 KB
scripts/confidence_rules.pyscript6.4 KB
scripts/content_quality_check.pyscript11.1 KB
scripts/enrich_deterministic.pyscript10.3 KB
scripts/extract_and_chunk.pyscript14.3 KB
scripts/finalize.pyscript10.2 KB
scripts/finalize_legacy.pyscript7.4 KB
scripts/generate_report.pyscript29.8 KB
scripts/instance_tracker.pyscript6.7 KB
scripts/integrity_check.pyscript11.0 KB
scripts/integrity_gate.pyscript4.6 KB
scripts/legacy/__init__.pyscript0 B
scripts/legacy/contradiction_report.pyscript11.9 KB
scripts/legacy/risk_scorer.pyscript10.2 KB
scripts/merge_chunk_analysis.pyscript14.8 KB
scripts/migrate_v2_to_v3.pyscript3.1 KB
scripts/obsidian_export.pyscript28.0 KB
scripts/persist_chunks.pyscript6.2 KB
scripts/prazo_calculator.pyscript14.2 KB
scripts/report_metrics.pyscript8.4 KB
scripts/schema_validator.pyscript5.2 KB
scripts/utils/__init__.pyscript0 B
scripts/utils/cnj.pyscript4.4 KB
scripts/utils/dates.pyscript7.8 KB
scripts/utils/filenames.pyscript2.6 KB
scripts/utils/monetary.pyscript5.2 KB
tests/__init__.pyscript0 B
tests/conftest.pyscript1.1 KB
tests/fixtures/agent_io/echo_invalid_missing_field.jsonconfig45 B
tests/fixtures/agent_io/echo_invalid_wrong_const.jsonconfig70 B
tests/fixtures/agent_io/echo_valid.jsonconfig103 B
tests/fixtures/agent_io/segmenter_valid.jsonconfig359 B
tests/fixtures/sample_analyzed.jsonconfig10.0 KB
tests/fixtures/sample_analyzed_with_prazos.jsonconfig470 B
tests/fixtures/sample_chunk_acordao.txtmarkdown3.4 KB
tests/fixtures/sample_chunk_peticao.txtmarkdown3.4 KB
tests/fixtures/sample_chunk_sentenca.txtmarkdown2.9 KB
tests/fixtures/sample_index.jsonconfig1.6 KB
tests/golden/_pdf_builder.pyscript6.1 KB
tests/golden/processo_01_sintetico_simples/expected_invariants.jsonconfig993 B
tests/golden/processo_01_sintetico_simples/source.txtmarkdown3.3 KB
tests/golden/processo_02_sintetico_art942/expected_art_942.jsonconfig898 B
tests/golden/processo_02_sintetico_art942/expected_invariants.jsonconfig1.3 KB
tests/golden/processo_02_sintetico_art942/source.txtmarkdown7.8 KB
tests/test_agent_io.pyscript4.4 KB
tests/test_analyzed_init.pyscript5.6 KB
tests/test_audit.pyscript4.4 KB
tests/test_cnj.pyscript2.9 KB
tests/test_confidence_rules.pyscript4.8 KB
tests/test_content_quality_check.pyscript14.5 KB
tests/test_contradiction_report.pyscript3.5 KB
tests/test_dates.pyscript5.0 KB
tests/test_enrich_deterministic.pyscript6.3 KB
tests/test_filenames.pyscript2.1 KB
tests/test_finalize.pyscript5.8 KB
tests/test_finalize_legacy.pyscript6.5 KB
tests/test_generate_report.pyscript24.0 KB
tests/test_golden_regression.pyscript6.3 KB
tests/test_instance_tracker.pyscript4.2 KB
tests/test_integrity_check.pyscript4.8 KB
tests/test_integrity_gate.pyscript3.6 KB
tests/test_merge_chunk_analysis.pyscript20.9 KB
tests/test_migrate_v2_to_v3.pyscript4.3 KB
tests/test_monetary.pyscript3.4 KB
tests/test_obsidian_export_v3.pyscript6.9 KB
tests/test_persist_chunks.pyscript6.1 KB
tests/test_prazo_calculator.pyscript14.1 KB
tests/test_report_metrics.pyscript5.3 KB
tests/test_risk_scorer.pyscript5.7 KB
tests/test_whitelist_enforcement.pyscript6.1 KB

scripts/report_metrics.py

View on GitHub
"""Aggregate juriscan audit trail into latency + invocation metrics.

Phase 7 Step 7.1. Reads one or more `.juriscan/audit/<run_id>.jsonl` files
and produces:

  - per-subagent p50 / p95 / max latency (ms)
  - total invocations per subagent
  - error count
  - schema_valid rate
  - total invocations for the run (budget gate)
  - elapsed wall-clock (first → last timestamp)

Budget gate (enforced when --enforce is given):

  - p95 latency per run <= --max-p95-ms   (default 600000 = 10 minutes)
  - total invocations per run <= --max-invocations  (default 30)

Exit code non-zero when gate fails. Intended to be called from CI on
completed golden-suite runs.

Usage
-----
    python3 scripts/report_metrics.py --run-id <uuid> [--root .juriscan/audit]
    python3 scripts/report_metrics.py --all-runs
    python3 scripts/report_metrics.py --run-id <uuid> --enforce
"""

from __future__ import annotations

import argparse
import json
import math
import sys
from collections import defaultdict
from datetime import datetime
from pathlib import Path
from typing import Iterable


DEFAULT_ROOT = Path(".juriscan/audit")
DEFAULT_MAX_P95_MS = 10 * 60 * 1000   # 10 minutes
DEFAULT_MAX_INVOCATIONS = 30


def _percentile(values: list[float], p: float) -> float:
    if not values:
        return 0.0
    xs = sorted(values)
    k = (len(xs) - 1) * p
    f = math.floor(k)
    c = math.ceil(k)
    if f == c:
        return xs[int(k)]
    return xs[f] + (xs[c] - xs[f]) * (k - f)


def _load_run(path: Path) -> list[dict]:
    entries: list[dict] = []
    with path.open("r", encoding="utf-8") as fh:
        for line in fh:
            line = line.strip()
            if not line:
                continue
            try:
                entries.append(json.loads(line))
            except json.JSONDecodeError:
                continue
    return entries


def summarize_run(entries: list[dict]) -> dict:
    """Return a structured summary of one audit run."""
    by_agent: dict[str, list[dict]] = defaultdict(list)
    ts_first: datetime | None = None
    ts_last: datetime | None = None
    error_count = 0
    schema_invalid_count = 0
    total_real_invocations = 0

    for e in entries:
        agent = e.get("agent") or "unknown"
        if agent == "__meta__":
            # Meta entries (run start/end) don't count as invocations.
            ts_raw = e.get("timestamp")
            if ts_raw:
                t = datetime.fromisoformat(ts_raw.replace("Z", "+00:00"))
                ts_first = t if ts_first is None or t < ts_first else ts_first
                ts_last = t if ts_last is None or t > ts_last else ts_last
            continue
        total_real_invocations += 1
        by_agent[agent].append(e)
        if e.get("error"):
            error_count += 1
        if e.get("schema_valid") is False:
            schema_invalid_count += 1
        ts_raw = e.get("timestamp")
        if ts_raw:
            t = datetime.fromisoformat(ts_raw.replace("Z", "+00:00"))
            ts_first = t if ts_first is None or t < ts_first else ts_first
            ts_last = t if ts_last is None or t > ts_last else ts_last

    per_agent: dict[str, dict] = {}
    all_latencies: list[float] = []
    for agent, group in by_agent.items():
        latencies = [
            float(e["latency_ms"]) for e in group
            if isinstance(e.get("latency_ms"), (int, float))
        ]
        all_latencies.extend(latencies)
        per_agent[agent] = {
            "invocations": len(group),
            "latency_p50_ms": round(_percentile(latencies, 0.50), 1) if latencies else None,
            "latency_p95_ms": round(_percentile(latencies, 0.95), 1) if latencies else None,
            "latency_max_ms": round(max(latencies), 1) if latencies else None,
            "errors": sum(1 for e in group if e.get("error")),
        }

    elapsed_ms: float | None = None
    if ts_first and ts_last:
        elapsed_ms = (ts_last - ts_first).total_seconds() * 1000.0

    return {
        "total_invocations": total_real_invocations,
        "unique_agents": len(per_agent),
        "error_count": error_count,
        "schema_invalid_count": schema_invalid_count,
        "latency_p50_ms": round(_percentile(all_latencies, 0.50), 1) if all_latencies else None,
        "latency_p95_ms": round(_percentile(all_latencies, 0.95), 1) if all_latencies else None,
        "latency_max_ms": round(max(all_latencies), 1) if all_latencies else None,
        "elapsed_wall_ms": round(elapsed_ms, 1) if elapsed_ms is not None else None,
        "per_agent": per_agent,
    }


def enforce_budget(
    summary: dict,
    *,
    max_p95_ms: int,
    max_invocations: int,
) -> list[str]:
    """Return a list of budget violations (empty if all ok)."""
    violations: list[str] = []
    p95 = summary.get("latency_p95_ms")
    if p95 is not None and p95 > max_p95_ms:
        violations.append(
            f"latency p95 {p95:.0f}ms > limit {max_p95_ms}ms "
            f"({p95 / 1000:.1f}s > {max_p95_ms / 1000:.1f}s)"
        )
    total = summary.get("total_invocations", 0)
    if total > max_invocations:
        violations.append(
            f"total invocations {total} > limit {max_invocations}"
        )
    return violations


def format_summary(summary: dict, run_id: str) -> str:
    lines = [
        f"=== run {run_id} ===",
        f"total invocations : {summary['total_invocations']}",
        f"unique agents     : {summary['unique_agents']}",
        f"errors            : {summary['error_count']}",
        f"schema_invalid    : {summary['schema_invalid_count']}",
        f"latency p50       : {summary['latency_p50_ms']} ms",
        f"latency p95       : {summary['latency_p95_ms']} ms",
        f"latency max       : {summary['latency_max_ms']} ms",
        f"elapsed wall      : {summary['elapsed_wall_ms']} ms",
        "",
        "per agent:",
    ]
    for agent, stats in sorted(summary["per_agent"].items()):
        lines.append(
            f"  {agent:28} n={stats['invocations']:>3} "
            f"p50={stats['latency_p50_ms']} "
            f"p95={stats['latency_p95_ms']} "
            f"max={stats['latency_max_ms']} "
            f"errors={stats['errors']}"
        )
    return "\n".join(lines)


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="Juriscan audit trail metrics")
    parser.add_argument("--root", default=str(DEFAULT_ROOT),
                        help="Audit trail directory (default: .juriscan/audit)")
    parser.add_argument("--run-id", default=None, help="Specific run to report")
    parser.add_argument("--all-runs", action="store_true",
                        help="Report every *.jsonl file under --root")
    parser.add_argument("--json", action="store_true",
                        help="Emit machine-readable JSON on stdout")
    parser.add_argument("--enforce", action="store_true",
                        help="Exit non-zero if budget gates are violated")
    parser.add_argument("--max-p95-ms", type=int, default=DEFAULT_MAX_P95_MS)
    parser.add_argument("--max-invocations", type=int, default=DEFAULT_MAX_INVOCATIONS)
    args = parser.parse_args(argv)

    root = Path(args.root)
    if not root.exists():
        print(f"audit root not found: {root}", file=sys.stderr)
        return 2

    runs: list[Path]
    if args.run_id:
        runs = [root / f"{args.run_id}.jsonl"]
    elif args.all_runs:
        runs = sorted(root.glob("*.jsonl"))
    else:
        print("must pass --run-id or --all-runs", file=sys.stderr)
        return 2

    results: dict[str, dict] = {}
    exit_code = 0

    for run_path in runs:
        if not run_path.exists():
            print(f"missing: {run_path}", file=sys.stderr)
            exit_code = max(exit_code, 2)
            continue
        entries = _load_run(run_path)
        summary = summarize_run(entries)
        run_id = run_path.stem
        results[run_id] = summary
        if not args.json:
            print(format_summary(summary, run_id))
            print()
        if args.enforce:
            violations = enforce_budget(
                summary,
                max_p95_ms=args.max_p95_ms,
                max_invocations=args.max_invocations,
            )
            if violations:
                exit_code = 1
                print(f"[BUDGET FAIL] run {run_id}:", file=sys.stderr)
                for v in violations:
                    print(f"  - {v}", file=sys.stderr)

    if args.json:
        json.dump(results, sys.stdout, ensure_ascii=False, indent=2)
        sys.stdout.write("\n")
    return exit_code


if __name__ == "__main__":
    raise SystemExit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall