import type { CliCommandMeta } from '../cli/registry.js';
import type { GuardDefinition } from './guard.js';
import type { MetaphorDefinition } from './metaphor.js';
import type { RoleDefinition } from './roles.js';
import { PAR_THRESHOLDS, SLOPE_FACTORS, SCORE_LABELS, HAZARD_SEVERITY_PENALTIES } from './constants.js';
export interface McpToolParam {
    name: string;
    type: string;
    desc: string;
    required?: boolean;
}
export interface McpToolMeta {
    name: string;
    desc: string;
    params: McpToolParam[];
    requiresStore: boolean;
}
export interface ChangelogChange {
    type: 'feat' | 'fix' | 'chore' | 'docs' | 'refactor' | 'test' | 'other';
    scope?: string;
    description: string;
    breaking: boolean;
    hash?: string;
}
export interface ChangelogEntry {
    version: string;
    date: string;
    changes: ChangelogChange[];
}
export interface ChangelogSection {
    status: 'success' | 'partial' | 'unavailable';
    entries: ChangelogEntry[];
    reason?: string;
}
export type ManifestSection = 'commands' | 'guards' | 'mcpTools' | 'metaphors' | 'roles' | 'constants' | 'changelog';
export interface DocsManifestInput {
    version: string;
    gitSha: string;
    changelog: ChangelogSection;
    commands: readonly CliCommandMeta[];
    mcpTools?: readonly McpToolMeta[];
}
export interface DocsManifest {
    version: string;
    generatedAt: string;
    gitSha: string;
    checksums: Record<ManifestSection, string>;
    commands: readonly CliCommandMeta[];
    guards: GuardDefinition[];
    mcpTools: readonly McpToolMeta[];
    metaphors: MetaphorDefinition[];
    roles: RoleDefinition[];
    constants: {
        parThresholds: typeof PAR_THRESHOLDS;
        slopeFactors: typeof SLOPE_FACTORS;
        scoreLabels: typeof SCORE_LABELS;
        hazardPenalties: typeof HAZARD_SEVERITY_PENALTIES;
    };
    changelog: ChangelogSection;
}
/** Compute a deterministic SHA-256 checksum for a data section */
export declare function computeSectionChecksum(data: unknown): string;
/** Build a complete documentation manifest from pre-computed input. Pure function — no I/O. */
export declare function buildDocsManifest(input: DocsManifestInput): DocsManifest;
//# sourceMappingURL=docs.d.ts.map