harn-cli 0.8.15

CLI for the Harn programming language — run, test, REPL, format, and lint
Documentation
use clap::{Args, Subcommand};

#[derive(Debug, Args)]
pub(crate) struct SessionArgs {
    #[command(subcommand)]
    pub command: SessionCommand,
}

#[derive(Debug, Subcommand)]
pub(crate) enum SessionCommand {
    /// Export a persisted run record as a portable Harn session bundle.
    Export(SessionExportArgs),
    /// Import a Harn session bundle back into a local run record.
    Import(SessionImportArgs),
    /// Validate a Harn session bundle without importing it.
    Validate(SessionValidateArgs),
    /// Print or check the generated session-bundle JSON Schema.
    Schema(SessionSchemaArgs),
}

#[derive(Debug, Args)]
pub(crate) struct SessionExportArgs {
    /// Path to the run record JSON file to export.
    pub run_record: String,
    /// Write the bundle to this path. Prints JSON to stdout when omitted.
    #[arg(long, value_name = "PATH")]
    pub out: Option<String>,
    /// Preserve local-only content instead of applying the default redaction policy.
    #[arg(long, conflicts_with = "replay_only")]
    pub local: bool,
    /// Export replay metadata with prompt/tool payloads withheld.
    #[arg(long, conflicts_with = "local")]
    pub replay_only: bool,
    /// Include artifact payloads in the bundle. Omitted by default for share safety.
    #[arg(long)]
    pub include_attachments: bool,
}

#[derive(Debug, Args)]
pub(crate) struct SessionImportArgs {
    /// Path to a Harn session bundle JSON file.
    pub bundle: String,
    /// Write the imported run record to this path.
    #[arg(long, value_name = "PATH")]
    pub out: Option<String>,
    /// Allow bundles that still contain high-confidence secret markers.
    #[arg(long)]
    pub allow_unsafe_secret_markers: bool,
}

#[derive(Debug, Args)]
pub(crate) struct SessionValidateArgs {
    /// Path to a Harn session bundle JSON file.
    pub bundle: String,
    /// Allow bundles that still contain high-confidence secret markers.
    #[arg(long)]
    pub allow_unsafe_secret_markers: bool,
    /// Print a compact JSON summary on success.
    #[arg(long)]
    pub json: bool,
}

#[derive(Debug, Args)]
pub(crate) struct SessionSchemaArgs {
    /// Check that the checked-in schema file is up to date.
    #[arg(long)]
    pub check: bool,
    /// Schema path used by --check, or write destination when --check is absent.
    #[arg(long, value_name = "PATH")]
    pub out: Option<String>,
}