#!/usr/bin/env perl

use strict;
use warnings;

use FindBin qw($Bin);
use lib "$Bin/../lib";

use Developer::Dashboard::CLI::Query qw(run_query_command);

# main(@ARGV)
# Runs the TOML query command for Developer Dashboard.
# Input: command-line arguments from @ARGV and optional STDIN.
# Output: prints the selected TOML value, then exits.
run_query_command( command => 'tomq', args => \@ARGV );

__END__

=pod

=head1 NAME

tomq - TOML query command for Developer Dashboard

=head1 SYNOPSIS

  dashboard tomq [path] [file]

=head1 DESCRIPTION

This command provides TOML path extraction for Developer Dashboard.

=for comment FULL-POD-DOC START

=head1 PURPOSE

This staged helper owns the public C<dashboard tomq> command. It accepts an
optional dotted TOML path plus an optional input file, then hands the request
to the shared query runtime so parsing, file-vs-STDIN handling, and output
formatting stay consistent with the rest of the dashboard toolchain.

=head1 WHY IT EXISTS

It exists because the dashboard ships a private, repo-local TOML inspection tool instead of depending on a globally installed parser binary. Keeping C<tomq> as a staged helper also preserves the thin-switchboard contract in C<bin/dashboard>.

=head1 WHEN TO USE

Use this file when you are changing how C<dashboard tomq> chooses between STDIN and files, how it reports parse errors, or how the staged helper is wired into the shared query implementation.

=head1 HOW TO USE

Users run C<dashboard tomq [path] [file]>. The staged helper selects the TOML
backend in the shared query runtime, which accepts the file and path in either
order, reads STDIN when no file is given, prints scalar hits as plain text, and
prints the whole parsed document when the path is C<$d> or C<.>.

=head1 WHAT USES IT

It is used by the public C<dashboard tomq> command, by shell snippets that want a runtime-local TOML query tool, by integration smoke runs, and by the focused query-helper coverage under C<t/>.

=head1 EXAMPLES

  printf '[alpha]\nbeta = 4\n' | dashboard tomq alpha.beta
  dashboard tomq settings.toml '$d'
  dashboard tomq '$d' settings.toml
  printf '[service]\nname = "demo"\n' | dashboard tomq service.name

=for comment FULL-POD-DOC END

=cut
