path-cli 0.16.1

CLI for deriving, querying, and visualizing Toolpath provenance (binary: path)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

pub mod artifact;
mod cache;
#[cfg(not(target_os = "emscripten"))]
mod cmd_auth;
mod cmd_cache;
mod cmd_derive;
mod cmd_export;
mod cmd_haiku;
mod cmd_import;
mod cmd_incept;
mod cmd_kind;
mod cmd_list;
mod cmd_merge;
mod cmd_p;
mod cmd_p_query;
#[cfg(not(target_os = "emscripten"))]
mod cmd_pathbase;
mod cmd_project;
mod cmd_query;
mod cmd_render;
#[cfg(not(target_os = "emscripten"))]
pub mod cmd_resume;
#[cfg(not(target_os = "emscripten"))]
mod cmd_share;
#[cfg(not(target_os = "emscripten"))]
mod cmd_show;
mod cmd_track;
mod cmd_validate;
mod config;
mod derive;
#[cfg(not(target_os = "emscripten"))]
mod fuzzy;
#[cfg(not(target_os = "emscripten"))]
pub mod harness;
mod io;
mod kinds;
mod query;
mod schema;
#[cfg(all(not(target_os = "emscripten"), feature = "embedded-picker"))]
mod skim_picker;
mod sync;
mod term;

use anyhow::Result;
use clap::{Parser, Subcommand};

#[derive(Parser, Debug)]
#[command(name = "path", version)]
#[command(about = "Derive, query, and visualize Toolpath provenance documents")]
struct Cli {
    #[command(subcommand)]
    command: Commands,

    /// Pretty-print JSON output
    #[arg(long, global = true)]
    pretty: bool,

    /// Backend for the interactive fuzzy picker used by `share`,
    /// `resume`, and `p import <provider>`. `auto` (default) uses the
    /// embedded skim picker and falls back to external `fzf` only when
    /// skim isn't compiled in; a hint is printed if `fzf` is also on
    /// PATH. `fzf`/`skim` force one backend and error if it isn't
    /// available.
    #[cfg(not(target_os = "emscripten"))]
    #[arg(long, global = true, value_enum, default_value_t = fuzzy::Picker::Auto)]
    picker: fuzzy::Picker,
}

#[derive(Subcommand, Debug)]
enum Commands {
    /// Show a single session as a markdown summary (used by fzf preview)
    #[cfg(not(target_os = "emscripten"))]
    Show {
        #[command(subcommand)]
        source: cmd_show::ShowSource,
        /// Emit ANSI-styled terminal output instead of raw markdown
        /// (bold speakers, dim metadata, colored diffs). Used by the
        /// fzf preview panes.
        #[arg(long)]
        ansi: bool,
    },
    /// Share an agent session to Pathbase via an interactive picker
    #[cfg(not(target_os = "emscripten"))]
    Share {
        #[command(flatten)]
        args: cmd_share::ShareArgs,
    },
    /// Resume an agent session into the chosen harness, projecting the
    /// document and exec'ing the harness's resume command.
    #[cfg(not(target_os = "emscripten"))]
    Resume {
        #[command(flatten)]
        args: cmd_resume::ResumeArgs,
    },
    /// Query the local cache: load every step into one JSON array and
    /// transform it with a jaq (jq) filter
    Query {
        #[command(flatten)]
        args: cmd_query::QueryArgs,
    },
    /// List bundled document kinds, or print a kind's schema (the field
    /// reference for `path query`)
    Kind {
        #[command(flatten)]
        args: cmd_kind::KindArgs,
    },
    /// Manage Pathbase credentials for trace uploads
    #[cfg(not(target_os = "emscripten"))]
    Auth {
        #[command(subcommand)]
        op: cmd_auth::AuthOp,
    },
    /// Plumbing: lower-level operations on documents and sources
    /// (import, export, cache, list, render, merge, validate, derive,
    /// project, incept, track, query)
    P {
        #[command(subcommand)]
        command: cmd_p::PCommand,
    },
    /// Print a random Toolpath haiku
    Haiku,
}

pub fn run() -> Result<()> {
    let cli = Cli::parse();

    #[cfg(not(target_os = "emscripten"))]
    fuzzy::set_picker_override(cli.picker);

    match cli.command {
        Commands::Haiku => {
            cmd_haiku::run();
            Ok(())
        }
        #[cfg(not(target_os = "emscripten"))]
        Commands::Show { source, ansi } => cmd_show::run(source, ansi),
        #[cfg(not(target_os = "emscripten"))]
        Commands::Share { args } => cmd_share::run(args),
        #[cfg(not(target_os = "emscripten"))]
        Commands::Resume { args } => cmd_resume::run(args),
        Commands::Query { args } => cmd_query::run(args, cli.pretty),
        Commands::Kind { args } => cmd_kind::run(args),
        #[cfg(not(target_os = "emscripten"))]
        Commands::Auth { op } => cmd_auth::run(op),
        Commands::P { command } => cmd_p::run(command, cli.pretty),
    }
}