gitwise-cli 0.24.2__py3-none-any.whl

gitwise/setup_agents/state.py

@@ -0,0 +1,141 @@
+"""State detection for setup-agents: path classification, symlink support, GPG readiness."""
+
+import os
+import platform
+import re
+from pathlib import Path
+
+from gitwise.git import config as git_config
+from gitwise.i18n import t
+from gitwise.setup_agents.types import PathState, StateDict
+
+_AGENTS_MD = "AGENTS.md"
+_CLAUDE_MD = "CLAUDE.md"
+_MARKER_RE = re.compile(
+    r"^##\s+(Convenciones git para este proyecto|Git conventions for this project)\b",
+    re.MULTILINE,
+)
+
+_supports_symlinks_cache: dict[Path, bool] = {}
+
+
+def _gpg_ready(root: Path) -> bool:
+    import shutil
+
+    if not (shutil.which("gpg") or shutil.which("gpg2")):
+        return False
+    return git_config("commit.gpgsign", cwd=root) == "true" and bool(
+        git_config("user.signingkey", cwd=root)
+    )
+
+
+def _classify_path(p: Path) -> PathState:
+    if p.is_symlink():
+        return "symlink_valid" if p.exists() else "symlink_broken"
+    if p.exists():
+        return "regular"
+    return "absent"
+
+
+def _supports_symlinks(root: Path) -> bool:
+    if platform.system() == "Windows":
+        return False
+    if root in _supports_symlinks_cache:
+        return _supports_symlinks_cache[root]
+    try:
+        import tempfile
+
+        with tempfile.TemporaryDirectory(dir=root) as td:
+            link = Path(td) / "_test_link"
+            link.symlink_to("_nonexistent")
+            link.unlink()
+        _supports_symlinks_cache[root] = True
+    except (OSError, NotImplementedError):
+        _supports_symlinks_cache[root] = False
+    return _supports_symlinks_cache[root]
+
+
+def _has_marker(p: Path) -> bool:
+    try:
+        text = p.read_text(encoding="utf-8")
+        return bool(_MARKER_RE.search(text))
+    except OSError:
+        return False
+
+
+def _files_equal(a: Path, b: Path) -> bool:
+    try:
+        return a.read_text(encoding="utf-8") == b.read_text(encoding="utf-8")
+    except OSError:
+        return False
+
+
+def _detect_rules(root: Path) -> list[str]:
+    """Validates .claude/rules/*.md for required globs: frontmatter field."""
+    rules_dir = root / ".claude" / "rules"
+    warnings: list[str] = []
+    if not rules_dir.is_dir():
+        return warnings
+    root_real = Path(os.path.realpath(str(root)))
+    for f in sorted(rules_dir.glob("*.md")):
+        f_real = Path(os.path.realpath(str(f)))
+        if not f_real.is_relative_to(root_real):
+            warnings.append(t("symlink_outside_repo", name=f.name))
+            continue
+        try:
+            if f.stat().st_size > 64_000:
+                warnings.append(t("file_too_large", name=f.name))
+                continue
+        except OSError:
+            continue
+        try:
+            text = f.read_text(encoding="utf-8-sig")
+        except OSError:
+            continue
+        has_frontmatter = text.startswith("---\n")
+        fm_end = text.find("\n---\n", 4) if has_frontmatter else -1
+        has_globs = "globs:" in text[4:fm_end] if fm_end > 0 else False
+        if not (has_frontmatter and has_globs):
+            warnings.append(t("missing_globs_frontmatter", name=f.name))
+    return warnings
+
+
+def reset_caches() -> None:
+    _supports_symlinks_cache.clear()
+
+
+def _detect_state(root: Path) -> StateDict:
+    agents_md = root / _AGENTS_MD
+    claude_md = root / _CLAUDE_MD
+    agents_dir = root / ".agents"
+    skills_dir = root / ".claude" / "skills"
+
+    a_state = _classify_path(agents_md)
+    c_state = _classify_path(claude_md)
+    errors: list[str] = []
+
+    if a_state == "symlink_broken":
+        errors.append(t("symlink_conflict_broken", file=_AGENTS_MD))
+    if c_state == "symlink_broken":
+        errors.append(t("symlink_conflict_broken", file=_CLAUDE_MD))
+
+    skills_state = _classify_path(skills_dir)
+    skills_target: str | None = None
+    if skills_state == "symlink_valid":
+        try:
+            skills_target = os.readlink(skills_dir)
+        except OSError as e:
+            errors.append(t("symlink_read_failed", file=".claude/skills", error=str(e)))
+    elif skills_state == "symlink_broken":
+        errors.append(t("symlink_conflict_broken", file=".claude/skills"))
+
+    return {
+        "a_state": a_state,
+        "c_state": c_state,
+        "agents_dir": agents_dir.is_dir() and not agents_dir.is_symlink(),
+        "skills_state": skills_state,
+        "skills_target": skills_target,
+        "supports_symlinks": _supports_symlinks(root),
+        "errors": errors,
+        "rules_warnings": _detect_rules(root),
+    }

gitwise/setup_agents/types.py

@@ -0,0 +1,48 @@
+"""Typed structures for the setup-agents pipeline (actions, state, plan results)."""
+
+from typing import Any, Literal, TypedDict
+
+ActionDict = dict[str, Any]
+
+
+PathState = Literal["absent", "regular", "symlink_valid", "symlink_broken"]
+
+
+class StateDict(TypedDict):
+    a_state: PathState
+    c_state: PathState
+    agents_dir: bool
+    skills_state: PathState
+    skills_target: str | None
+    supports_symlinks: bool
+    errors: list[str]
+    rules_warnings: list[str]
+
+
+class ActionSummary(TypedDict):
+    created: int
+    appended: int
+    symlinked: int
+    skipped: int
+    errored: int
+
+
+def build_action_summary(actions: list[ActionDict]) -> ActionSummary:
+    summary: ActionSummary = {
+        "created": 0,
+        "appended": 0,
+        "symlinked": 0,
+        "skipped": 0,
+        "errored": 0,
+    }
+    for a in actions:
+        match a.get("action"):
+            case "create" | "managed-block-create" | "adapter-create":
+                summary["created"] += 1
+            case "append" | "merge":
+                summary["appended"] += 1
+            case "symlink-create":
+                summary["symlinked"] += 1
+            case "skip" | "symlink-skip" | "managed-block-skip":
+                summary["skipped"] += 1
+    return summary

gitwise/share/agents/skills/git-audit/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: git-audit
+description: Diagnostica el repositorio git (ramas stale, commit-graph, fsmonitor, blobs grandes, stashes viejos) y reporta hallazgos priorizados con fixes recomendados. Usa cuando el usuario pida auditar, revisar salud o diagnosticar el repo.
+argument-hint: "[--quick]"
+allowed-tools: Bash(gitwise audit*)
+disable-model-invocation: true
+---
+
+# git-audit
+
+## Contexto
+
+Resultado de `gitwise audit --json`:
+
+!`gitwise audit --json`
+
+## Tarea
+
+Eres un asistente experto en git. Analiza el JSON anterior y produce un reporte breve y accionable:
+
+1. **Resumen ejecutivo** (1 línea): estado general del repo.
+2. **Hallazgos priorizados**: lista cada `finding` ordenado por `severity` (critical > high > medium > low > info). Para cada uno indica: `message`, `fix` sugerido, `cost_of_ignore`.
+3. **Acción recomendada**: el comando exacto a ejecutar primero (típicamente el `fix` del finding más severo). NO lo ejecutes — solo recomiéndalo.
+
+Si `findings` está vacío, responde "Repo en buen estado" y termina. No inventes hallazgos no presentes en el JSON.

gitwise/share/agents/skills/git-clean/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: git-clean
+description: Lista en dry-run las ramas locales cuyo upstream fue eliminado ([gone]) y reporta cuáles son seguras de borrar. Usa cuando el usuario pida limpiar ramas stale, huérfanas o merged.
+argument-hint: "(sin argumentos)"
+allowed-tools: Bash(gitwise clean --branches --dry-run --json)
+disable-model-invocation: true
+---
+
+# git-clean
+
+## Contexto
+
+Resultado de `gitwise clean --branches --dry-run --json`:
+
+!`gitwise clean --branches --dry-run --json`
+
+## Tarea
+
+1. Reporta el conteo y nombres de ramas en `deletable` y `skipped` (con su `reason`).
+2. Si `deletable` está vacío, responde "No hay ramas stale eliminables" y termina.
+3. Si hay ramas eliminables, sugiere al usuario el comando para borrarlas tras revisión: `gitwise clean --branches --yes`.
+4. NUNCA ejecutes el borrado tú mismo. La versión `--yes` NO está en `allowed-tools` por diseño — requiere confirmación humana explícita.

gitwise/share/agents/skills/git-optimize/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: git-optimize
+description: Muestra qué optimizaciones aplicaría gitwise (commit-graph, repack -A -d, prune) en modo dry-run. Usa cuando el usuario pida optimizar git, acelerar log/status, o cuando audit reporte commit-graph ausente.
+argument-hint: "(sin argumentos)"
+allowed-tools: Bash(gitwise optimize --dry-run --json)
+disable-model-invocation: true
+---
+
+# git-optimize
+
+## Contexto
+
+Plan de optimización (dry-run):
+
+!`gitwise optimize --dry-run --json`
+
+## Tarea
+
+1. Lista los `steps` que se ejecutarían (`name`, `desc`).
+2. Estima impacto: commit-graph acelera `git log` 2-10x; repack reduce tamaño y crea bitmap-index; prune libera objetos no referenciados.
+3. Recomienda al usuario ejecutar `gitwise optimize --yes` para aplicarlas. NO ejecutes la versión `--yes` tú mismo: `disable-model-invocation: true` + `allowed-tools` restrictivo lo previenen por diseño.

gitwise/share/aider/CONVENTIONS.md.template

@@ -0,0 +1,8 @@
+## Git conventions
+
+- Diff: `gitwise diff` (= `git diff --name-status HEAD`). Never raw `git diff`.
+- Log: `git --no-pager log --oneline -n 20`. Never without a limit.
+- Commits: conventional format `feat/fix/refactor/docs/chore: description`.
+- Commits: always GPG-signed. Never `--no-gpg-sign`.
+- Branch switch: `gitwise worktree new <branch>`. Never `git stash + checkout`.
+- Before large commits: `gitwise audit --quick`.

gitwise/share/aider/aider.conf.yml.template

@@ -0,0 +1,4 @@
+# .aider.conf.yml — generated by gitwise setup-agents
+read:
+  - AGENTS.md
+  - CONVENTIONS.md

gitwise/share/claude/CLAUDE.md.template

@@ -0,0 +1,9 @@
+## Git conventions for this project
+
+- Diff: `git diff --stat` or `gitwise summarize`. Never raw `git diff`.
+- Log: `git --no-pager log --oneline -n 20`. Never without a limit.
+- Commits: conventional format `feat/fix/refactor/docs/chore: description`.
+- Commits: always GPG-signed. Never `--no-gpg-sign`.
+- Branch switch: `gitwise worktree new <branch>`. Never `git stash + checkout`.
+- Changed files: `gitwise diff` (= `git diff --name-status HEAD`). Never raw `git diff`.
+- Before large commits: `gitwise audit --quick`.

gitwise/share/claude/rules/gitwise.md

@@ -0,0 +1,16 @@
+---
+name: gitwise
+description: Use gitwise CLI for git operations — gitwise diff, summarize, worktree
+globs: "**/*"
+---
+
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+
+## Shell note
+
+`gw` is a terminal alias only — use `gitwise` or `python -m gitwise` in Bash tool calls.

gitwise/share/claude/settings.json.template

@@ -0,0 +1,47 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gitwise *)",
+      "Bash(python -m gitwise *)",
+      "Bash(git status*)",
+      "Bash(git --no-pager log*)",
+      "Bash(git --no-pager diff --stat*)",
+      "Bash(git --no-pager diff --name-status*)",
+      "Bash(git --no-pager diff --shortstat*)",
+      "Bash(git diff --staged*)",
+      "Bash(git show*)",
+      "Bash(git blame*)",
+      "Bash(git for-each-ref*)",
+      "Bash(git rev-parse*)",
+      "Bash(git ls-files*)",
+      "Bash(git branch*)",
+      "Bash(git worktree*)",
+      "Bash(git add*)",
+      "Bash(git commit -S*)",
+      "Bash(git commit -m*)"
+    ],
+    "ask": [
+      "Bash(git push*)",
+      "Bash(git rebase*)",
+      "Bash(git reset*)",
+      "Bash(git commit --amend*)"
+    ],
+    "deny": [
+      "Bash(git push --force*)",
+      "Bash(git filter-branch*)",
+      "Bash(git clean -fdx*)",
+      "Bash(git commit --no-gpg-sign*)",
+      "Bash(git commit --no-verify*)",
+      "Bash(git commit --allow-empty*)",
+      "Bash(git -c commit.gpgsign=false*)",
+      "Bash(git -c gpg.format=*)",
+      "Bash(git -c core.hooksPath*)",
+      "Read(./.env*)",
+      "Read(./secrets/**)",
+      "Read(**/*.key)",
+      "Read(**/*.pem)",
+      "Read(**/*.p12)",
+      "Read(**/*.pfx)"
+    ]
+  }
+}

gitwise/share/claude/skills/git-audit/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: git-audit
+description: Diagnostica el repositorio git (ramas stale, commit-graph, fsmonitor, blobs grandes, stashes viejos) y reporta hallazgos priorizados con fixes recomendados. Usa cuando el usuario pida auditar, revisar salud o diagnosticar el repo.
+argument-hint: "[--quick]"
+allowed-tools: Bash(gitwise audit*)
+disable-model-invocation: true
+---
+
+# git-audit
+
+## Contexto
+
+Resultado de `gitwise audit --json`:
+
+!`gitwise audit --json`
+
+## Tarea
+
+Eres un asistente experto en git. Analiza el JSON anterior y produce un reporte breve y accionable:
+
+1. **Resumen ejecutivo** (1 línea): estado general del repo.
+2. **Hallazgos priorizados**: lista cada `finding` ordenado por `severity` (critical > high > medium > low > info). Para cada uno indica: `message`, `fix` sugerido, `cost_of_ignore`.
+3. **Acción recomendada**: el comando exacto a ejecutar primero (típicamente el `fix` del finding más severo). NO lo ejecutes — solo recomiéndalo.
+
+Si `findings` está vacío, responde "Repo en buen estado" y termina. No inventes hallazgos no presentes en el JSON.

gitwise/share/claude/skills/git-clean/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: git-clean
+description: Lista en dry-run las ramas locales cuyo upstream fue eliminado ([gone]) y reporta cuáles son seguras de borrar. Usa cuando el usuario pida limpiar ramas stale, huérfanas o merged.
+argument-hint: "(sin argumentos)"
+allowed-tools: Bash(gitwise clean --branches --dry-run --json)
+disable-model-invocation: true
+---
+
+# git-clean
+
+## Contexto
+
+Resultado de `gitwise clean --branches --dry-run --json`:
+
+!`gitwise clean --branches --dry-run --json`
+
+## Tarea
+
+1. Reporta el conteo y nombres de ramas en `deletable` y `skipped` (con su `reason`).
+2. Si `deletable` está vacío, responde "No hay ramas stale eliminables" y termina.
+3. Si hay ramas eliminables, sugiere al usuario el comando para borrarlas tras revisión: `gitwise clean --branches --yes`.
+4. NUNCA ejecutes el borrado tú mismo. La versión `--yes` NO está en `allowed-tools` por diseño — requiere confirmación humana explícita.

gitwise/share/claude/skills/git-optimize/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: git-optimize
+description: Muestra qué optimizaciones aplicaría gitwise (commit-graph, repack -A -d, prune) en modo dry-run. Usa cuando el usuario pida optimizar git, acelerar log/status, o cuando audit reporte commit-graph ausente.
+argument-hint: "(sin argumentos)"
+allowed-tools: Bash(gitwise optimize --dry-run --json)
+disable-model-invocation: true
+---
+
+# git-optimize
+
+## Contexto
+
+Plan de optimización (dry-run):
+
+!`gitwise optimize --dry-run --json`
+
+## Tarea
+
+1. Lista los `steps` que se ejecutarían (`name`, `desc`).
+2. Estima impacto: commit-graph acelera `git log` 2-10x; repack reduce tamaño y crea bitmap-index; prune libera objetos no referenciados.
+3. Recomienda al usuario ejecutar `gitwise optimize --yes` para aplicarlas. NO ejecutes la versión `--yes` tú mismo: `disable-model-invocation: true` + `allowed-tools` restrictivo lo previenen por diseño.

gitwise/share/codex/agents/gitwise.toml.template

@@ -0,0 +1,18 @@
+name = "gitwise"
+description = "Git workflow conventions — use gitwise CLI for git operations"
+model = "inherit"
+model_reasoning_effort = "inherit"
+sandbox_mode = "inherit"
+
+developer_instructions = """
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+
+## Shell note
+
+`gw` is a terminal alias only — use `gitwise` or `python -m gitwise` in Bash tool calls.
+"""

gitwise/share/continue/rules/gitwise.md.template

@@ -0,0 +1,14 @@
+---
+name: gitwise
+description: Use gitwise CLI for git operations — gitwise diff, summarize, worktree
+---
+
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Audit: `gitwise audit --quick` — before large commits
+- Clean: `gitwise clean --branches` — remove stale branches
+- Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

gitwise/share/cursor/rules/gitwise.mdc.template

@@ -0,0 +1,16 @@
+---
+description: Use gitwise CLI for git operations — gitwise diff, summarize, worktree
+globs:
+  - "**/*"
+alwaysApply: true
+---
+
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Audit: `gitwise audit --quick` — before large commits
+- Clean: `gitwise clean --branches` — remove stale branches
+- Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

gitwise/share/git-config-modern.txt

@@ -0,0 +1,48 @@
+# Subset of GitButler "How Core Git Devs Configure Git" (Chacon, feb 2025)
+# Applied by: gitwise setup
+# Reference: https://blog.gitbutler.com/how-git-core-devs-configure-git/
+
+[core]
+    # macOS/Windows only — gitwise setup detects platform before applying
+    # fsmonitor = true
+    untrackedCache = true
+    preloadindex = true
+
+[fetch]
+    prune = true
+    prunetags = true
+    all = true
+
+[merge]
+    conflictstyle = zdiff3
+
+[diff]
+    algorithm = histogram
+    colorMoved = default
+
+[rerere]
+    enabled = true
+    autoupdate = true
+
+[branch]
+    sort = -committerdate
+
+[tag]
+    sort = -version:refname
+
+[push]
+    default = current
+    autoSetupRemote = true
+
+[commit]
+    verbose = true
+
+[maintenance]
+    auto = false
+    strategy = incremental
+
+# Excluded (matter of taste per GitButler):
+# pull.rebase = true
+
+# Gated on git >= 2.40:
+# feature.manyFiles = true

gitwise/share/hooks/commit-msg

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# gitwise commit-msg hook: verifies conventional commit format
+# Installed by: gitwise setup (legacy core.hooksPath or native Git config hooks)
+set -euo pipefail
+
+# Skip format check for git-generated merge/revert/squash/cherry-pick commits
+GIT_DIR="$(git rev-parse --git-dir 2>/dev/null || true)"
+[ -f "${GIT_DIR}/MERGE_HEAD" ] && exit 0
+[ -f "${GIT_DIR}/REBASE_HEAD" ] && exit 0
+[ -f "${GIT_DIR}/CHERRY_PICK_HEAD" ] && exit 0
+[ -f "${GIT_DIR}/SQUASH_MSG" ] && exit 0
+
+MSG="$(cat "$1")"
+PATTERN="^(feat|fix|refactor|docs|chore|test|style|perf|ci|build|revert)(\(.+\))?: .{1,72}"
+
+if ! printf '%s\n' "$MSG" | grep -qE "$PATTERN"; then
+    printf 'gitwise: el mensaje no sigue el formato de conventional commits\n' >&2
+    printf '  Esperado: feat: desc  |  fix(scope): desc  |  docs: corrección\n' >&2
+    printf '  Ejemplos: docs: corrige typo en README  |  fix: maneja nil en parse\n' >&2
+    printf '  Recibido: %s\n' "$MSG" >&2
+    exit 1
+fi

gitwise/share/hooks/pre-commit

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# gitwise pre-commit hook: verifies GPG signing configuration
+# Installed by: gitwise setup (legacy core.hooksPath or native Git config hooks)
+set -euo pipefail
+
+gpgsign_val=$(git config --get commit.gpgsign 2>/dev/null || true)
+if [ "$gpgsign_val" = "true" ]; then
+    if ! git config --get user.signingkey > /dev/null 2>&1; then
+        printf 'gitwise: GPG signing activo pero sin user.signingkey configurado\n' >&2
+        printf '  Ejecuta: git config user.signingkey <tu-key-id>\n' >&2
+        exit 1
+    fi
+    signing_key="$(git config user.signingkey)"
+    if ! gpg --list-secret-keys "$signing_key" > /dev/null 2>&1; then
+        printf 'gitwise: GPG key no encontrada en el keyring: %s\n' "$signing_key" >&2
+        printf '  Verifica con: gpg --list-secret-keys\n' >&2
+        exit 1
+    fi
+fi

gitwise/share/opencode/agents/gitwise.md.template

@@ -0,0 +1,14 @@
+---
+name: gitwise
+description: Use gitwise CLI for git operations — gitwise diff, summarize, worktree
+---
+
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Audit: `gitwise audit --quick` — before large commits
+- Clean: `gitwise clean --branches` — remove stale branches
+- Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

gitwise/share/pi/skills/gitwise.md.template

@@ -0,0 +1,14 @@
+---
+name: gitwise
+description: Use gitwise CLI for git operations — gitwise diff, summarize, worktree
+---
+
+## Use gitwise commands in tool calls
+
+- Changed files: `gitwise diff` — never raw `git diff`
+- Status + log: `gitwise summarize` — never raw `git status` or `git log`
+- Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
+- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Audit: `gitwise audit --quick` — before large commits
+- Clean: `gitwise clean --branches` — remove stale branches
+- Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

gitwise/share/schemas/v1/input/audit.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitwise.dev/schemas/v1/input/audit.json",
+  "title": "gitwise audit cli input",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "lang": {
+      "type": "string",
+      "enum": [
+        "es",
+        "en"
+      ],
+      "description": "output language (default: auto-detect from locale)"
+    },
+    "theme": {
+      "type": "string",
+      "enum": [
+        "dark",
+        "light",
+        "auto"
+      ],
+      "description": "color theme: dark, light, or auto-detect (default: auto)"
+    },
+    "json": {
+      "type": "boolean",
+      "description": "output JSON",
+      "default": false
+    },
+    "json_pretty": {
+      "type": "boolean",
+      "description": "pretty-print JSON output",
+      "default": false
+    },
+    "quick": {
+      "type": "boolean",
+      "default": false
+    }
+  }
+}