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

tests/test_golden_regression.py

View on GitHub
"""Golden regression suite for juriscan.

Runs both the legacy and (eventually) agents pipelines against synthetic
fixtures in tests/golden/ and asserts structural invariants.

Phase 0 scope: only legacy pipeline. Invariants are intentionally conservative
so they pass with the current regex chunker. Agents-only invariants (e.g.
art. 942 detection) live in separate `expected_art_942.json` files and are
gated by the pipeline mode.
"""

from __future__ import annotations

import json
import shutil
import subprocess
import sys
from pathlib import Path

import pytest

REPO_ROOT = Path(__file__).resolve().parents[1]
GOLDEN_ROOT = REPO_ROOT / "tests" / "golden"
EXTRACT_SCRIPT = REPO_ROOT / "scripts" / "extract_and_chunk.py"


def _discover_fixtures() -> list[Path]:
    fixtures = []
    for child in sorted(GOLDEN_ROOT.iterdir()):
        if not child.is_dir():
            continue
        if child.name.startswith("_"):
            continue
        if (child / "input.pdf").exists() and (child / "expected_invariants.json").exists():
            fixtures.append(child)
    return fixtures


FIXTURES = _discover_fixtures()


@pytest.fixture(scope="module")
def legacy_outputs(tmp_path_factory) -> dict[str, Path]:
    """Run the legacy extract_and_chunk pipeline against every fixture.

    Returns a map { fixture_name: output_dir }.
    """
    out: dict[str, Path] = {}
    root = tmp_path_factory.mktemp("golden_legacy")
    for fixture in FIXTURES:
        out_dir = root / fixture.name
        out_dir.mkdir(parents=True, exist_ok=True)
        result = subprocess.run(
            [
                sys.executable,
                str(EXTRACT_SCRIPT),
                "--input",
                str(fixture / "input.pdf"),
                "--output",
                str(out_dir),
            ],
            capture_output=True,
            text=True,
        )
        assert result.returncode == 0, (
            f"extract_and_chunk failed for {fixture.name}:\n"
            f"stdout={result.stdout}\nstderr={result.stderr}"
        )
        out[fixture.name] = out_dir
    return out


def _load_index(out_dir: Path) -> dict:
    index_path = out_dir / "index.json"
    assert index_path.exists(), f"missing index.json in {out_dir}"
    return json.loads(index_path.read_text(encoding="utf-8"))


def _load_all_chunks_text(out_dir: Path) -> str:
    chunks_dir = out_dir / "chunks"
    assert chunks_dir.exists(), f"missing chunks/ in {out_dir}"
    parts = []
    for chunk_file in sorted(chunks_dir.iterdir()):
        if chunk_file.suffix == ".txt":
            parts.append(chunk_file.read_text(encoding="utf-8"))
    return "\n".join(parts)


@pytest.mark.parametrize("fixture", FIXTURES, ids=lambda f: f.name)
def test_golden_legacy_pipeline(fixture: Path, legacy_outputs: dict[str, Path]) -> None:
    """Run legacy pipeline and validate against expected_invariants.json."""
    invariants = json.loads((fixture / "expected_invariants.json").read_text(encoding="utf-8"))
    if "legacy" not in invariants.get("pipeline_compat", ["legacy"]):
        pytest.skip(f"{fixture.name} not marked legacy-compatible")

    out_dir = legacy_outputs[fixture.name]
    index = _load_index(out_dir)
    all_text = _load_all_chunks_text(out_dir)

    # Extraction lower bound
    min_chars = invariants.get("extraction", {}).get("min_chars")
    if min_chars is not None:
        assert len(all_text) >= min_chars, (
            f"extracted text too short: {len(all_text)} < {min_chars}"
        )

    # Chunk count range
    chunk_min = invariants.get("chunks", {}).get("min_count")
    chunk_max = invariants.get("chunks", {}).get("max_count")
    chunks = index.get("chunks") or index.get("pieces") or []
    chunk_count = len(chunks)
    if chunk_min is not None:
        assert chunk_count >= chunk_min, (
            f"too few chunks: {chunk_count} < {chunk_min}"
        )
    if chunk_max is not None:
        assert chunk_count <= chunk_max, (
            f"too many chunks: {chunk_count} > {chunk_max}"
        )

    # Piece types present
    required_types = invariants.get("piece_types_present", [])
    observed_types = {
        (c.get("tipo_peca") or c.get("label") or "").upper()
        for c in chunks
    }
    for required in required_types:
        # Normalize accents for comparison — legacy labels may vary
        required_upper = required.upper()
        matched = any(required_upper in obs for obs in observed_types)
        assert matched, (
            f"required piece type not found: {required} "
            f"(observed: {sorted(observed_types)})"
        )

    # Text must contain
    for needle in invariants.get("text_must_contain", []):
        assert needle in all_text, f"text missing required substring: {needle!r}"

    # Text must NOT contain
    for needle in invariants.get("text_must_not_contain", []):
        assert needle not in all_text, (
            f"text contains forbidden substring: {needle!r}"
        )


@pytest.mark.parametrize("fixture", FIXTURES, ids=lambda f: f.name)
def test_golden_art942_gate_is_skipped_in_legacy(fixture: Path) -> None:
    """Ensure agents-only invariants (art_942) are properly gated.

    In Phase 0 we only run the legacy pipeline. Any fixture that has an
    expected_art_942.json file MUST declare skip_when_pipeline=legacy,
    otherwise the gate is misconfigured.
    """
    art942_path = fixture / "expected_art_942.json"
    if not art942_path.exists():
        pytest.skip("no art942 invariant for this fixture")

    invariant = json.loads(art942_path.read_text(encoding="utf-8"))
    assert invariant.get("skip_when_pipeline") == "legacy", (
        f"{fixture.name}: expected_art_942.json must declare "
        f"skip_when_pipeline=legacy during Phase 0 "
        f"(got: {invariant.get('skip_when_pipeline')})"
    )
    assert invariant.get("required_when_pipeline") == "agents", (
        f"{fixture.name}: expected_art_942.json must declare "
        f"required_when_pipeline=agents"
    )


def test_golden_fixtures_exist() -> None:
    """Sanity check: make sure the golden suite is not empty."""
    assert len(FIXTURES) >= 2, (
        f"expected at least 2 golden fixtures, found {len(FIXTURES)}: "
        f"{[f.name for f in FIXTURES]}"
    )
    names = {f.name for f in FIXTURES}
    assert "processo_01_sintetico_simples" in names
    assert "processo_02_sintetico_art942" in names
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