commands_cli.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
"""aquin commands list | show | clear"""
 
from __future__ import annotations
 
import json
import sys
from typing import Any
 
from aquin.command_log import clear_records, list_records, load_record
 
 
def _parse_flag(args: list[str], name: str) -> str | None:
    for i, a in enumerate(args):
        if a == name and i + 1 < len(args):
            return args[i + 1]
    return None
 
 
def cmd_commands_list(args: list[str]) -> None:
    last_raw = _parse_flag(args, "--last")
    since = _parse_flag(args, "--since")
    category = _parse_flag(args, "--category")
    model_id = _parse_flag(args, "--model")
    command = _parse_flag(args, "--command")
 
    last = int(last_raw) if last_raw else None
    rows = list_records(last=last, since=since, category=category, model_id=model_id, command=command)
    if not rows:
        print("No tracked commands.")
        return
 
    for row in rows:
        ok = "✓" if row.get("exit_ok", True) else "✗"
        ts = str(row.get("ts", ""))[:19].replace("T", " ")
        print(
            f"{ok} {row['id'][:8]}  {ts}  [{row.get('category', '?')}]  "
            f"{row.get('summary', row.get('command', ''))}"
        )
 
 
def cmd_commands_show(args: list[str]) -> None:
    if not args or args[0] in ("--help", "-h"):
        print("Usage: aquin commands show <id>")
        sys.exit(0 if args and args[0] in ("--help", "-h") else 1)
 
    record_id = args[0]
    rec = load_record(record_id)
    if rec is None:
        matches = [r for r in list_records() if str(r.get("id", "")).startswith(record_id)]
        if len(matches) == 1:
            rec = load_record(str(matches[0]["id"]))
        elif len(matches) > 1:
            print(f"Ambiguous id prefix '{record_id}' — {len(matches)} matches.")
            sys.exit(1)
    if rec is None:
        print(f"Not found: {record_id}")
        sys.exit(1)
    print(json.dumps(rec, indent=2, default=str))
 
 
def cmd_commands_clear(args: list[str]) -> None:
    before = _parse_flag(args, "--before")
    n = clear_records(before=before)
    print(f"Cleared {n} local command record(s).")
 
 
def cmd_commands(args: list[str]) -> None:
    if not args or args[0] in ("--help", "-h", "help"):
        print("Usage: aquin commands <subcommand>")
        print("")
        print("  list   [--last N] [--since 2h] [--category inspection] [--model X]")
        print("  show   <id>")
        print("  clear  [--before 7d]")
        return
 
    sub = args[0]
    rest = args[1:]
    if sub == "list":
        cmd_commands_list(rest)
    elif sub == "show":
        cmd_commands_show(rest)
    elif sub == "send":
        print("'aquin commands send' was removed (web CLI inbox no longer exists).")
        print("Tracked runs stay local: aquin commands list | show")
        sys.exit(1)
    elif sub == "clear":
        cmd_commands_clear(rest)
    else:
        print(f"Unknown subcommand: {sub}")
        print("Use: aquin commands list | show | clear")
        sys.exit(1)