<?php
/**
 * Operating guide ability schema.
 *
 * @package LolaCoreForBricks
 */

declare(strict_types=1);

namespace LolaCoreForBricks\Schemas;

use LolaCoreForBricks\AbilitiesProvider;

/**
 * Door 1 schema for getBricksOperatingGuide.
 */
class OperatingGuideSchemas
{
    /**
     * @return array<string, array<string, mixed>>
     */
    public static function define(): array
    {
        return [
            'getBricksOperatingGuide' => [
                'description' => 'Return the Bricks domain SOP and architect guidance by topic (naming, composition, templates, batch, shop, bootstrap).',
                'category'    => AbilitiesProvider::CATEGORY,
                'keywords'    => [
                    'exact' => ['bricks operating guide', 'bricks sop', 'guía bricks'],
                    'stem'  => ['guide', 'sop', 'playbook'],
                ],
                'parameters'  => [
                    'type'       => 'object',
                    'properties' => [
                        'topic' => [
                            'type'        => 'string',
                            'description' => 'Optional topic: naming, variables_vs_values, merge_criteria, composition, templates_components, batch, shop, project_bootstrap.',
                        ],
                    ],
                ],
            ],
        ];
    }
}
