/** The command categories the AGENTS.md body can carry. */
export type ProjectScriptCategory = 'build' | 'test' | 'lint';
export type ProjectScriptCommand = {
    readonly category: ProjectScriptCategory;
    /** The script name exactly as it appears in `package.json#scripts`. */
    readonly script: string;
    /** The exact command line to run. */
    readonly command: string;
    /** What the command does — one clause, so an agent can pick the right one. */
    readonly purpose: string;
};
export type ProjectScripts = {
    /** The package manager the command lines are spelled for. */
    readonly packageManager: string;
    /** At most one command per category, in category order. */
    readonly commands: readonly ProjectScriptCommand[];
};
/**
 * The exact commands this project really has, read from `package.json#scripts`.
 *
 * Returns an empty command list for a project without a readable
 * `package.json` — the AGENTS.md body then carries no command section at all,
 * which is the honest outcome for a project with no scripts to name.
 */
export declare function detectProjectScripts(projectRoot: string): ProjectScripts;