/**
 * Documentation dimension — declarative scoring spec.
 *
 * Methodology: subtractive checklist over documentation artifacts
 * (README, doc-comment density, API docs, architecture docs,
 * CONTRIBUTING, CHANGELOG). Baseline 100; each missing or
 * substandard artifact deducts points sized by the artifact's
 * importance to repository understandability. README + doc-comment
 * density weigh heaviest (foundational artifacts a customer reads
 * first), CHANGELOG lightest.
 *
 * No Layer-1 standard prescribes specific point allocations for
 * dxkit's set of artifacts; the values are dxkit's own choice
 * documented in `src/scoring/STANDARDS.md` Layer 3.
 *
 * The "subtractive over checklist" framing (rather than the
 * additive-from-zero shape used pre-2.4.7) means
 * `ScoreResult.deductions` reads as missing items the customer can
 * fix — uniform actionable semantics across all six dimensions.
 * The numeric score is unchanged from the pre-inversion additive
 * form (baseline 100 minus penalties is mathematically equivalent
 * to baseline 0 plus bonuses, with the same per-rule values).
 *
 * No caps in this spec. The baseline + penalty distribution enforce
 * the rating contract by construction.
 */
import type { DimensionScoringSpec } from '../spec';
/**
 * Partition of every signal the Documentation scorer reads. The
 * adapter builds this shape; the spec stays consumer-agnostic.
 */
export interface DocumentationScoreInput {
    /** Total source files; denominator for `docCommentFiles` density. */
    sourceFiles: number;
    /** Does the repo have a README.md (or README.rst / README.txt)? */
    readmeExists: boolean;
    /** Line count of the discovered README. Tier-penalized at 20/50/100. */
    readmeLines: number;
    /** Count of source files with documentation comments
     *  (JSDoc / docstrings / Rustdoc / etc.). Density-penalized. */
    docCommentFiles: number;
    /** API documentation directory present (docs/api/, openapi.{yaml,json},
     *  Swagger UI, etc.). */
    apiDocsExist: boolean;
    /** Architecture documentation present (docs/architecture/, ARCHITECTURE.md). */
    architectureDocsExist: boolean;
    /** CONTRIBUTING.md present. */
    contributingExists: boolean;
    /** CHANGELOG.md present. */
    changelogExists: boolean;
}
export declare const DOCUMENTATION_SCORING_SPEC: DimensionScoringSpec<DocumentationScoreInput>;
//# sourceMappingURL=documentation.d.ts.map