Function skill_history

openkb/cli.py:2429–2473

List previous iterations of a skill.

(ctx, name)

@click.argument("name")
@click.pass_context
def skill_history(ctx, name):
    """List previous iterations of a skill."""
    import datetime as _dt

    from openkb.skill.workspace import list_iterations

    kb_dir = _find_kb_dir(ctx.obj.get("kb_dir_override"))
    if kb_dir is None:
        click.echo("No knowledge base found. Run `openkb init` first.", err=True)
        ctx.exit(1)

    err = _validate_skill_name(name)
    if err:
        click.echo(f"[ERROR] {err}", err=True)
        ctx.exit(1)

    iters = list_iterations(kb_dir, name)
    if not iters:
        click.echo(f"No previous iterations for '{name}'.")
        return

    click.echo(f"Iterations of '{name}' ({len(iters)} total):\n")
    click.echo("  N  Path                                                  Created")
    click.echo("  -  --------------------------------------------------    -------")
    for path in iters:
        n = int(path.name.split("-", 1)[1])
        rel = path.relative_to(kb_dir)
        try:
            mtime = _dt.datetime.fromtimestamp(path.stat().st_mtime)
            stamp = mtime.strftime("%Y-%m-%d %H:%M")
        except OSError:
            stamp = "-"
        click.echo(f"  {n}  {rel}  {stamp}")

    from openkb.skill import skill_dir

    current = skill_dir(kb_dir, name)
    if current.is_dir():
        rel_curr = current.relative_to(kb_dir)
        click.echo(f"\n  Current: {rel_curr}/")

    latest_n = int(iters[-1].name.split("-", 1)[1])
    click.echo("\nRestore an iteration:")
    click.echo(f"  openkb skill rollback {name}          # restore latest (iteration-{latest_n})")
    click.echo(f"  openkb skill rollback {name} --to 1   # restore iteration-1")


@skill.command("rollback")