// src/cli.rs
pub mod link;
pub mod coll;
pub mod view;
pub mod state;
pub mod task;
pub mod remind;
pub mod annotate;
pub mod version;
pub mod event;

use clap::{Parser, Subcommand, ValueEnum};
use clap_complete::Shell;

/// Output format for commands.
#[derive(ValueEnum, Clone, Copy, Debug)]
pub enum Format {
    Text,
    Json,
}

/// Marlin – metadata-driven file explorer (CLI utilities)
#[derive(Parser, Debug)]
#[command(author, version, about, propagate_version = true)]
pub struct Cli {
    /// Enable debug logging and extra output
    #[arg(long)]
    pub verbose: bool,

    /// Output format (text or JSON)
    #[arg(long, default_value = "text", value_enum, global = true)]
    pub format: Format,

    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Initialise the database (idempotent)
    Init,

    /// Scan one or more directories and populate the file index
    Scan {
        /// Directories to scan (defaults to cwd)
        paths: Vec<std::path::PathBuf>,
    },

    /// Tag files matching a glob pattern (hierarchical tags use `/`)
    Tag {
        /// Glob or path pattern
        pattern: String,
        /// Hierarchical tag name (`foo/bar`)
        tag_path: String,
    },

    /// Manage custom attributes
    Attr {
        #[command(subcommand)]
        action: AttrCmd,
    },

    /// Full-text search; `--exec CMD` runs CMD on each hit (`{}` placeholder)
    Search {
        query: String,
        #[arg(long)]
        exec: Option<String>,
    },

    /// Create a timestamped backup of the database
    Backup,

    /// Restore from a backup file (overwrites current DB)
    Restore {
        backup_path: std::path::PathBuf,
    },

    /// Generate shell completions (hidden)
    #[command(hide = true)]
    Completions {
        /// Which shell to generate for
        #[arg(value_enum)]
        shell: Shell,
    },

    /// File-to-file links
    #[command(subcommand)]
    Link(link::LinkCmd),

    /// Collections (groups) of files
    #[command(subcommand)]
    Coll(coll::CollCmd),

    /// Smart views (saved queries)
    #[command(subcommand)]
    View(view::ViewCmd),

    /// Workflow states on files
    #[command(subcommand)]
    State(state::StateCmd),

    /// TODO/tasks management
    #[command(subcommand)]
    Task(task::TaskCmd),

    /// Reminders on files
    #[command(subcommand)]
    Remind(remind::RemindCmd),

    /// File annotations and highlights
    #[command(subcommand)]
    Annotate(annotate::AnnotateCmd),

    /// Version diffs
    #[command(subcommand)]
    Version(version::VersionCmd),

    /// Calendar events & timelines
    #[command(subcommand)]
    Event(event::EventCmd),
}

#[derive(Subcommand, Debug)]
pub enum AttrCmd {
    Set { pattern: String, key: String, value: String },
    Ls  { path: std::path::PathBuf },
}