erk 0.4.5__py3-none-any.whl

erk/cli/commands/log_cmd.py

@@ -0,0 +1,137 @@
+"""Log command for querying erk command history.
+
+Provides access to the command audit trail stored in ~/.erk/command_history.jsonl.
+"""
+
+from datetime import UTC, datetime
+
+import click
+
+from erk.core.command_log import (
+    CommandLogEntry,
+    format_relative_time,
+    is_iso_datetime_format,
+    parse_relative_time,
+    read_log_entries,
+)
+
+
+def _parse_since(value: str | None) -> datetime | None:
+    """Parse --since value into datetime.
+
+    Supports:
+    - Relative: "1 hour ago", "2 days ago", "30 minutes ago"
+    - ISO format: "2024-01-01T00:00:00"
+    """
+    if value is None:
+        return None
+
+    value_lower = value.strip().lower()
+
+    # Try relative time parsing
+    delta = parse_relative_time(value_lower)
+    if delta is not None:
+        return datetime.now(UTC) - delta
+
+    # Try ISO format
+    if not is_iso_datetime_format(value_lower):
+        raise click.BadParameter(
+            f"Invalid time format: {value}. Use 'N unit ago' (e.g., '1 hour ago') "
+            "or ISO format (e.g., '2024-01-01T00:00:00')"
+        )
+    return datetime.fromisoformat(value_lower)
+
+
+def _format_entry_line(entry: CommandLogEntry, show_cwd: bool, show_full: bool) -> str:
+    """Format a single log entry for display."""
+    # Get time display
+    if show_full:
+        # For full mode, parse and format as full timestamp
+        if is_iso_datetime_format(entry.timestamp):
+            dt = datetime.fromisoformat(entry.timestamp)
+            time_str = dt.strftime("%Y-%m-%d %H:%M:%S")
+        else:
+            time_str = entry.timestamp[:19]
+    else:
+        time_str = format_relative_time(entry.timestamp)
+
+    # Build command display
+    cmd_display = entry.command
+    if entry.args:
+        cmd_display += " " + " ".join(entry.args)
+
+    # Exit code indicator
+    if entry.exit_code is None:
+        status = click.style("?", fg="yellow")
+    elif entry.exit_code == 0:
+        status = click.style("✓", fg="green")
+    else:
+        status = click.style("✗", fg="red")
+
+    # Format line
+    parts = [
+        click.style(f"[{time_str}]", dim=True),
+        status,
+        cmd_display,
+    ]
+
+    if show_cwd:
+        parts.append(click.style(f"({entry.cwd})", dim=True))
+
+    return " ".join(parts)
+
+
+@click.command("log")
+@click.option("--since", "-s", help="Show entries since time (e.g., '1 hour ago', '2024-01-01')")
+@click.option("--filter", "-f", "command_filter", help="Filter by command substring")
+@click.option("--cwd", "-c", "cwd_filter", help="Filter by working directory")
+@click.option("--limit", "-n", type=int, help="Maximum entries to show (default: 50)")
+@click.option("--full", is_flag=True, help="Show full timestamps and details")
+@click.option("--show-cwd", is_flag=True, help="Show working directory for each entry")
+def log_cmd(
+    since: str | None,
+    command_filter: str | None,
+    cwd_filter: str | None,
+    limit: int | None,
+    full: bool,
+    show_cwd: bool,
+) -> None:
+    """Show erk command history.
+
+    Displays recent erk command invocations with their status.
+
+    \b
+    Examples:
+      erk log                        # Show recent commands
+      erk log --since "1 hour ago"   # Commands from last hour
+      erk log --filter "wt delete"   # Only worktree deletions
+      erk log --cwd /path/to/repo    # Commands from specific directory
+      erk log -n 10                  # Show last 10 commands
+    """
+    # Parse since option
+    since_dt = _parse_since(since)
+
+    # Default limit
+    if limit is None:
+        limit = 50
+
+    # Read entries
+    entries = read_log_entries(
+        since=since_dt,
+        until=None,
+        command_filter=command_filter,
+        cwd_filter=cwd_filter,
+        limit=limit,
+    )
+
+    if not entries:
+        click.echo(click.style("No matching entries found.", dim=True))
+        return
+
+    # Display entries
+    for entry in entries:
+        click.echo(_format_entry_line(entry, show_cwd, full))
+
+    # Show count if there might be more
+    if len(entries) == limit:
+        click.echo(click.style(f"\n(Showing {limit} most recent. Use --limit for more.)", dim=True))

erk/cli/commands/md/__init__.py

@@ -0,0 +1,5 @@
+"""Markdown file commands.
+
+Import from submodules:
+- group: md_group
+"""

erk/cli/commands/md/check.py

@@ -0,0 +1,118 @@
+"""Check AGENTS.md standard compliance command.
+
+This command validates that repositories follow the AGENTS.md standard where:
+- AGENTS.md is the primary context file
+- CLAUDE.md contains '@AGENTS.md' reference for backwards compatibility
+
+See: https://code.claude.com/docs/en/claude-code-on-the-web
+"""
+
+import subprocess
+from pathlib import Path
+
+import click
+
+from erk_shared.output.output import user_output
+
+
+@click.command(name="check")
+def check_command() -> None:
+    """Validate AGENTS.md standard compliance in the repository.
+
+    Checks that:
+    - Every CLAUDE.md file has a peer AGENTS.md file
+    - Every CLAUDE.md file contains '@AGENTS.md' reference
+
+    Exit codes:
+    - 0: All checks passed
+    - 1: Violations found
+    """
+    # Find repository root
+    result = subprocess.run(
+        ["git", "rev-parse", "--show-toplevel"],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    repo_root_str = result.stdout.strip()
+    repo_root_path = Path(repo_root_str)
+
+    if not repo_root_path.exists():
+        user_output(click.style("✗ Error: Repository root not found", fg="red"))
+        raise SystemExit(1)
+
+    # Find all CLAUDE.md and AGENTS.md files
+    claude_files = list(repo_root_path.rglob("CLAUDE.md"))
+    agents_files = list(repo_root_path.rglob("AGENTS.md"))
+
+    if len(claude_files) == 0 and len(agents_files) == 0:
+        message = "ℹ️  No CLAUDE.md or AGENTS.md files found in repository"
+        user_output(click.style(message, fg="cyan"))
+        raise SystemExit(0)
+
+    # Track violations
+    missing_agents: list[Path] = []  # CLAUDE.md without peer AGENTS.md
+    missing_claude: list[Path] = []  # AGENTS.md without peer CLAUDE.md
+    invalid_content: list[Path] = []
+
+    for claude_path in claude_files:
+        # Check for peer AGENTS.md
+        agents_path = claude_path.parent / "AGENTS.md"
+        if not agents_path.exists():
+            missing_agents.append(claude_path.parent)
+            continue
+
+        # Check CLAUDE.md content
+        content = claude_path.read_text(encoding="utf-8")
+        if content.strip() != "@AGENTS.md":
+            invalid_content.append(claude_path)
+
+    # Check that all AGENTS.md files have peer CLAUDE.md
+    for agents_path in agents_files:
+        claude_path = agents_path.parent / "CLAUDE.md"
+        if not claude_path.exists():
+            missing_claude.append(agents_path.parent)
+
+    # Report results
+    violation_count = len(missing_agents) + len(missing_claude) + len(invalid_content)
+    if violation_count == 0:
+        user_output(click.style("✓ AGENTS.md standard: PASSED", fg="green", bold=True))
+        user_output()
+        user_output("All CLAUDE.md and AGENTS.md files properly paired.")
+        user_output()
+        user_output(f"CLAUDE.md files checked: {len(claude_files)}")
+        user_output("Violations: 0")
+        raise SystemExit(0)
+
+    # Found violations
+    user_output(click.style("✗ AGENTS.md standard: FAILED", fg="red", bold=True))
+    user_output()
+    plural = "s" if violation_count != 1 else ""
+    user_output(f"Found {violation_count} violation{plural}:")
+    user_output()
+
+    if len(missing_agents) > 0:
+        user_output(click.style("Missing AGENTS.md:", fg="yellow"))
+        for path in missing_agents:
+            rel_path = path.relative_to(repo_root_path)
+            user_output(f"  • {click.style(str(rel_path) + '/', fg='cyan')}")
+        user_output()
+
+    if len(missing_claude) > 0:
+        user_output(click.style("Missing CLAUDE.md:", fg="yellow"))
+        for path in missing_claude:
+            rel_path = path.relative_to(repo_root_path)
+            user_output(f"  • {click.style(str(rel_path) + '/', fg='cyan')}")
+        user_output()
+
+    if len(invalid_content) > 0:
+        user_output(click.style("Invalid CLAUDE.md content:", fg="yellow"))
+        for path in invalid_content:
+            rel_path = path.relative_to(repo_root_path)
+            content = path.read_text(encoding="utf-8")
+            styled_path = click.style(str(rel_path), fg="cyan")
+            user_output(f"  • {styled_path}: Content is '{content.strip()}', expected '@AGENTS.md'")
+        user_output()
+
+    user_output("Fix these issues and run again.")
+    raise SystemExit(1)

erk/cli/commands/md/group.py

@@ -0,0 +1,14 @@
+"""Markdown file command group."""
+
+import click
+
+from erk.cli.commands.md.check import check_command
+
+
+@click.group(name="md")
+def md_group() -> None:
+    """Manage and validate markdown context files."""
+
+
+# Register commands
+md_group.add_command(check_command)