id = "micasa"
name = "Micasa"
homepage = "https://micasa.dev/"
description = "TUI for tracking home projects, maintenance schedules, appliances and quotes"
executables = ["micasa"]

[dotfiles]

# Micasa's configuration reference documents these platform-specific config
# locations (the data database is application state and is intentionally not
# catalogued).
# https://micasa.dev/docs/reference/configuration/
paths = [
  "[configHome]/micasa/config.toml",
  "~/Library/Application Support/micasa/config.toml",
  "%APPDATA%/micasa/config.toml",
]
secret = []

[commands]
format = 1
label = "micasa"
description = "Open the TUI on a database, print its path, back it up, or try the demo. The db, config, eval and pro subcommands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "doc"
kind = "manual"
url = "https://micasa.dev/docs/reference/cli/"
evidence = """
micasa [database-path] [flags]
--print-path Print the resolved database path and exit
"""

[[commands.field]]
id = "database_path"
label = "Database file"
description = "Defaults to the standard location."
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["doc"]

[[commands.field]]
id = "print_path"
label = "Print resolved database path and exit"
type = "boolean"
option = ["--print-path"]
sources = ["doc"]

[[commands.task]]
id = "open"
label = "Open the TUI"
fields = ["database_path"]
required = []

[[commands.task]]
id = "path"
label = "Print database path"
fields = ["print_path"]
required = ["print_path"]
set = { print_path = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["database_path", "print_path"]

[[commands.subcommand]]
path = ["backup"]
label = "Back up the database"

[[commands.subcommand.source]]
id = "doc"
kind = "manual"
url = "https://micasa.dev/docs/reference/cli/"
evidence = """
micasa backup [destination] [flags]
--source Source database path (default: standard location, honors MICASA_DB_PATH)
"""

[[commands.subcommand.field]]
id = "destination"
label = "Backup file"
type = "path"
position = 0
path = { kind = "file", role = "output" }
effect = "overwrite"
sources = ["doc"]

[[commands.subcommand.field]]
id = "source"
label = "Source database"
type = "path"
option = ["--source"]
path = { kind = "file", role = "input" }
sources = ["doc"]

[[commands.subcommand.task]]
id = "backup"
label = "Back up"
fields = ["destination", "source"]
required = ["destination"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["destination", "source"]

[[commands.subcommand]]
path = ["demo"]
label = "Demo with sample data"

[[commands.subcommand.source]]
id = "doc"
kind = "manual"
url = "https://micasa.dev/docs/reference/cli/"
evidence = """
micasa demo [database-path] [flags]
--seed-only Seed data and exit without launching the TUI
--years Generate N years of simulated home ownership data
"""

[[commands.subcommand.field]]
id = "database_path"
label = "Database file"
description = "Without a path, an in-memory database is used."
type = "path"
position = 0
path = { kind = "file", role = "output" }
sources = ["doc"]

[[commands.subcommand.field]]
id = "seed_only"
label = "Seed data and exit"
type = "boolean"
option = ["--seed-only"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "years"
label = "Years of sample data"
type = "integer"
option = ["--years"]
sources = ["doc"]

[[commands.subcommand.task]]
id = "demo"
label = "Launch demo"
fields = ["database_path", "years"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["database_path", "years", "seed_only"]