#!/usr/bin/env perl

use strict;
use warnings;
use utf8;

use Capture::Tiny qw(capture);
use Cwd qw(cwd);
use FindBin qw($Bin);
use Getopt::Long qw(GetOptionsFromArray);
use lib "$Bin/../lib";

use Developer::Dashboard::Collector;
use Developer::Dashboard::Config;
use Developer::Dashboard::FileRegistry;
use Developer::Dashboard::IndicatorStore;
use Developer::Dashboard::PathRegistry;
use Developer::Dashboard::Prompt;

binmode STDOUT, ':encoding(UTF-8)';
binmode STDERR, ':encoding(UTF-8)';

# _default_roots()
# Resolves the standard workspace roots used by the lightweight prompt helper.
# Input: none.
# Output: ordered list of existing directory path strings.
sub _default_roots {
    my $home = $ENV{HOME} || '';
    return grep { defined && -d } map { "$home/$_" } qw(projects src work);
}

# _tmux_ticket_ref()
# Reads TICKET_REF from the active tmux session environment when available.
# Input: none.
# Output: ticket string or undef when tmux does not expose one.
sub _tmux_ticket_ref {
    my ( $stdout, undef, $exit_code ) = capture {
        system 'tmux', 'show-environment', 'TICKET_REF';
        return $? >> 8;
    };
    return if $exit_code != 0;
    return if !defined $stdout || $stdout eq '';
    for my $line ( split /\n/, $stdout ) {
        next if !defined $line || $line eq '' || $line =~ /^-/;
        return $1 if $line =~ /^TICKET_REF=(.+)$/;
    }
    return;
}

# _prime_ticket_ref_env()
# Seeds TICKET_REF from tmux when the shell has not already exported it.
# Input: none.
# Output: true after best-effort environment priming.
sub _prime_ticket_ref_env {
    return 1 if defined $ENV{TICKET_REF} && $ENV{TICKET_REF} ne '';
    my $ticket = _tmux_ticket_ref();
    $ENV{TICKET_REF} = $ticket if defined $ticket && $ticket ne '';
    return 1;
}

# main(@ARGV)
# Runs the prompt renderer helper for Developer Dashboard.
# Input: command-line arguments from @ARGV.
# Output: prints one prompt string suitable for shell command substitution.
my $jobs = 0;
my $cwd  = cwd();
my $mode = 'compact';
my $color = 0;
my $max_age = 300;
GetOptionsFromArray(
    \@ARGV,
    'jobs=i'    => \$jobs,
    'cwd=s'     => \$cwd,
    'mode=s'    => \$mode,
    'color!'    => \$color,
    'max-age=i' => \$max_age,
);

my @roots = _default_roots();
my $paths = Developer::Dashboard::PathRegistry->new(
    home            => ( $ENV{HOME} || '' ),
    cwd             => $cwd,
    workspace_roots => \@roots,
    project_roots   => \@roots,
);
my $files = Developer::Dashboard::FileRegistry->new( paths => $paths );
my $config = Developer::Dashboard::Config->new( files => $files, paths => $paths );
my $indicators = Developer::Dashboard::IndicatorStore->new( paths => $paths );
my $collectors = Developer::Dashboard::Collector->new( paths => $paths );
my $prompt = Developer::Dashboard::Prompt->new(
    indicators => $indicators,
    paths      => $paths,
);

$indicators->sync_collectors( $config->collectors );
_prime_ticket_ref_env();

print $prompt->render(
    jobs    => $jobs,
    cwd     => $cwd,
    mode    => $mode,
    color   => $color,
    max_age => $max_age,
);

__END__

=pod

=head1 NAME

ps1 - private prompt helper for Developer Dashboard

=head1 SYNOPSIS

  dashboard ps1 [--jobs N] [--cwd DIR] [--mode compact|extended] [--color] [--max-age N]

=head1 DESCRIPTION

This private helper is staged under F<~/.developer-dashboard/cli/dd/> so the main
C<dashboard> command can keep prompt rendering on a lightweight handoff path.

=for comment FULL-POD-DOC START

=head1 PURPOSE

This staged helper exposes C<dashboard ps1>, the prompt-rendering command used by generated shell bootstraps. It is the CLI face of the prompt subsystem.

=head1 WHY IT EXISTS

It exists because prompt rendering is built into the product, but the prompt text should come from the prompt module rather than from shell code or the public switchboard.

=head1 WHEN TO USE

Use this file when changing prompt CLI flags, compact versus extended mode handling, or the handoff from the helper into the prompt renderer.

=head1 HOW TO USE

Users or shell bootstrap functions run C<dashboard ps1 ...>. The staged helper forwards the request into the private runtime, which loads indicator and collector state and prints the rendered prompt fragment.

=head1 WHAT USES IT

It is used by generated bash/zsh/sh/PowerShell prompts, by prompt smoke tests, and by contributors checking prompt output while iterating on indicator behavior.

=head1 EXAMPLES

Example 1:

  dashboard shell ps1

Run the public built-in command path that stages or re-enters this helper.

Example 2:

  ~/.developer-dashboard/cli/dd/ps1 --help

Inspect the staged helper directly after C<dashboard init> or helper extraction has populated the home runtime.

Example 3:

  prove -lv t/05-cli-smoke.t t/30-dashboard-loader.t

Rerun the focused staged-helper and thin-loader tests after changing helper dispatch behavior.

Example 4:

  prove -lr t

Verify that the helper still behaves correctly inside the complete repository suite.


=for comment FULL-POD-DOC END

=cut
