import { type DiagnosticId } from "./diagnostic-ids.js";
import type { Diagnostic, Finding, RepairConstraint, VerificationStep } from "./types/diagnostics.js";
interface CatalogFindingDefinition {
    code: DiagnosticId;
    title: string;
    category: Finding["category"];
    severity: Finding["severity"];
    confidence: Finding["confidence"];
    whyItMatters: string;
    remediation: string;
    repairConstraints: readonly RepairConstraint[];
    verificationSteps: readonly VerificationStep[];
    llmHint: string;
}
type CatalogFindingDefinitionRegistry<Definitions extends readonly CatalogFindingDefinition[]> = {
    readonly [Definition in Definitions[number] as Definition["code"]]: Definition;
};
export declare const CATALOG_FINDING_DEFINITIONS: CatalogFindingDefinitionRegistry<readonly [{
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Lifecycle status is part of the repository governance contract. Invalid status values make it harder for humans and agents to understand whether a skill, context asset, or support file is experimental, stable, suspended, revoked, deprecated, or archived.";
    readonly remediation: "Use one of the supported lifecycle status values: experimental, stable, suspended, revoked, deprecated, archived. Do not use migration or relationship states such as active or delegated as lifecycle status.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep lifecycle status separate from provenance, delegation, or replacement relationships.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Replace invalid lifecycle status values with supported values. If a file was replaced by a shared context asset, consider a deprecated lifecycle status plus a separate supersession reference. Skills use metadata.renma.status and metadata.renma.superseded-by; non-Skills keep status and superseded_by. Pre-0.16 Skill fields are migration input only.";
    readonly code: "META-INVALID-STATUS";
    readonly title: "Asset metadata uses an invalid lifecycle status";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Freshness metadata is a human review contract. Invalid dates or unsupported review cycles make deterministic freshness checks unreliable.";
    readonly remediation: "Use ISO date values such as 2026-06-28 for last_reviewed_at and expires_at, and day-based ISO 8601 durations such as P90D for review_cycle.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer freshness from file modification time.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm freshness metadata reflects human review.";
    }];
    readonly llmHint: "Repair only the explicit freshness metadata fields. Do not add modified_at or infer review freshness from Git history.";
    readonly code: "META-INVALID-LAST-REVIEWED-AT";
    readonly title: "Freshness metadata uses an invalid last review date";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Freshness metadata is a human review contract. Invalid dates or unsupported review cycles make deterministic freshness checks unreliable.";
    readonly remediation: "Use ISO date values such as 2026-06-28 for last_reviewed_at and expires_at, and day-based ISO 8601 durations such as P90D for review_cycle.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer freshness from file modification time.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm freshness metadata reflects human review.";
    }];
    readonly llmHint: "Repair only the explicit freshness metadata fields. Do not add modified_at or infer review freshness from Git history.";
    readonly code: "META-INVALID-EXPIRES-AT";
    readonly title: "Freshness metadata uses an invalid expiration date";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Freshness metadata is a human review contract. Invalid dates or unsupported review cycles make deterministic freshness checks unreliable.";
    readonly remediation: "Use ISO date values such as 2026-06-28 for last_reviewed_at and expires_at, and day-based ISO 8601 durations such as P90D for review_cycle.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer freshness from file modification time.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm freshness metadata reflects human review.";
    }];
    readonly llmHint: "Repair only the explicit freshness metadata fields. Do not add modified_at or infer review freshness from Git history.";
    readonly code: "META-INVALID-REVIEW-CYCLE";
    readonly title: "Freshness metadata uses an unsupported review cycle";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly code: "META-INVALID-RENMA-FRONTMATTER";
    readonly title: "Non-Skill Renma frontmatter is invalid or ambiguous";
    readonly severity: "high";
    readonly whyItMatters: "Malformed YAML or duplicate operational keys cannot provide deterministic catalog and governance metadata.";
    readonly remediation: "Repair the exact Renma frontmatter envelope and keep one valid YAML declaration per operational field.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not recover metadata values from raw lines.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not broaden the exact non-Skill delimiter contract.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not guess which duplicate declaration was intended.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Confirm the frontmatter parses as one YAML mapping without duplicate operational keys.";
    }];
    readonly llmHint: "Repair the YAML structure or duplicate declaration only after preserving and confirming the intended metadata value.";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-INVALID-STATUS-CHANGED-AT";
    readonly title: "Lifecycle metadata uses an invalid status transition date";
    readonly severity: "medium";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-SUSPENDED-STATUS-METADATA-INCOMPLETE";
    readonly title: "Suspended lifecycle metadata is incomplete";
    readonly severity: "medium";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-REQUIRED-SUSPENDED-DEPENDENCY";
    readonly title: "Required dependency targets a suspended asset";
    readonly severity: "medium";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-OPTIONAL-SUSPENDED-DEPENDENCY";
    readonly title: "Optional dependency targets a suspended asset";
    readonly severity: "low";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-REVOKED-STATUS-METADATA-INCOMPLETE";
    readonly title: "Revoked lifecycle metadata is incomplete";
    readonly severity: "medium";
    readonly whyItMatters: "Revocation is an explicit withdrawal of trust or authorization because of a known problem. Without a reviewed reason and transition date, that negative trust decision is not auditable.";
    readonly remediation: "Record the reviewed revocation reason and real transition date without changing the revoked status or inventing evidence.";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-REQUIRED-REVOKED-DEPENDENCY";
    readonly title: "Required dependency targets a revoked asset";
    readonly severity: "medium";
    readonly whyItMatters: "An active asset requires a target whose trust or authorization for use has been explicitly withdrawn because of a known problem.";
    readonly remediation: "Review the direct dependency and choose an evidence-backed outcome; Renma does not propagate lifecycle status or prescribe one repair.";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-OPTIONAL-REVOKED-DEPENDENCY";
    readonly title: "Optional dependency targets a revoked asset";
    readonly severity: "low";
    readonly whyItMatters: "An active asset optionally references a target whose trust or authorization for use has been explicitly withdrawn because of a known problem.";
    readonly remediation: "Review whether to retain a justified exception, remove or retarget the optional declaration, or handle the target through a separate reviewed lifecycle decision.";
}, {
    readonly category: "maintenance";
    readonly severity: "low";
    readonly confidence: "high";
    readonly whyItMatters: "Frontmatter metadata is part of the LLM-facing catalog surface. Overgrown metadata increases token use and catalog noise, and often means detailed guidance belongs in the markdown body or a referenced context asset instead.";
    readonly remediation: "Keep frontmatter as a compact deterministic index. Move long explanations, routing prose, examples, procedures, and detailed policy text into the markdown body or referenced context assets.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not add new metadata fields to hide long prose.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not delete substantive guidance just to satisfy the check.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Preserve detailed knowledge in the asset body or referenced context assets.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep metadata useful for deterministic cataloging, graph checks, readiness checks, and security diagnostics.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm the frontmatter is shorter and detailed guidance remains preserved outside metadata.";
    }];
    readonly llmHint: "Shorten metadata without losing knowledge: keep concise routing/index fields in frontmatter, move long prose into body sections or referenced context assets, and preserve existing references.";
    readonly code: "META-FRONTMATTER-TOO-LARGE";
    readonly title: "Frontmatter metadata is too large";
}, {
    readonly category: "maintenance";
    readonly severity: "low";
    readonly confidence: "high";
    readonly whyItMatters: "Frontmatter metadata is part of the LLM-facing catalog surface. Overgrown metadata increases token use and catalog noise, and often means detailed guidance belongs in the markdown body or a referenced context asset instead.";
    readonly remediation: "Keep frontmatter as a compact deterministic index. Move long explanations, routing prose, examples, procedures, and detailed policy text into the markdown body or referenced context assets.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not add new metadata fields to hide long prose.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not delete substantive guidance just to satisfy the check.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Preserve detailed knowledge in the asset body or referenced context assets.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep metadata useful for deterministic cataloging, graph checks, readiness checks, and security diagnostics.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm the frontmatter is shorter and detailed guidance remains preserved outside metadata.";
    }];
    readonly llmHint: "Shorten metadata without losing knowledge: keep concise routing/index fields in frontmatter, move long prose into body sections or referenced context assets, and preserve existing references.";
    readonly code: "META-LIST-ITEM-TOO-LONG";
    readonly title: "Metadata list item is too long";
}, {
    readonly category: "maintenance";
    readonly severity: "low";
    readonly confidence: "high";
    readonly whyItMatters: "Usage boundaries are part of the deterministic catalog surface for shared context assets. Missing or placeholder boundaries force humans and agents to infer when reusable knowledge applies, which increases over-application risk.";
    readonly remediation: "Add compact, reviewed when_to_use and when_not_to_use entries. Keep detailed routing explanations, examples, procedures, and rationale in the markdown body or referenced context assets.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer missing boundaries from broad body prose.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not replace missing boundaries with TODO, TBD, unknown, none, or similar placeholders.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep metadata compact and preserve detailed guidance outside frontmatter.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm shared context assets declare compact positive and negative usage boundaries.";
    }];
    readonly llmHint: "Ask the asset owner for concise positive and negative usage boundaries. Do not invent domain exclusions, owners, policies, or runtime routing behavior.";
    readonly code: "META-CONTEXT-MISSING-WHEN-TO-USE";
    readonly title: "Shared context asset is missing when_to_use metadata";
}, {
    readonly category: "maintenance";
    readonly severity: "low";
    readonly confidence: "high";
    readonly whyItMatters: "Usage boundaries are part of the deterministic catalog surface for shared context assets. Missing or placeholder boundaries force humans and agents to infer when reusable knowledge applies, which increases over-application risk.";
    readonly remediation: "Add compact, reviewed when_to_use and when_not_to_use entries. Keep detailed routing explanations, examples, procedures, and rationale in the markdown body or referenced context assets.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer missing boundaries from broad body prose.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not replace missing boundaries with TODO, TBD, unknown, none, or similar placeholders.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep metadata compact and preserve detailed guidance outside frontmatter.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm shared context assets declare compact positive and negative usage boundaries.";
    }];
    readonly llmHint: "Ask the asset owner for concise positive and negative usage boundaries. Do not invent domain exclusions, owners, policies, or runtime routing behavior.";
    readonly code: "META-CONTEXT-MISSING-WHEN-NOT-TO-USE";
    readonly title: "Shared context asset is missing when_not_to_use metadata";
}, {
    readonly category: "maintenance";
    readonly severity: "low";
    readonly confidence: "high";
    readonly whyItMatters: "Usage boundaries are part of the deterministic catalog surface for shared context assets. Missing or placeholder boundaries force humans and agents to infer when reusable knowledge applies, which increases over-application risk.";
    readonly remediation: "Add compact, reviewed when_to_use and when_not_to_use entries. Keep detailed routing explanations, examples, procedures, and rationale in the markdown body or referenced context assets.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer missing boundaries from broad body prose.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not replace missing boundaries with TODO, TBD, unknown, none, or similar placeholders.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Keep metadata compact and preserve detailed guidance outside frontmatter.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Confirm shared context assets declare compact positive and negative usage boundaries.";
    }];
    readonly llmHint: "Ask the asset owner for concise positive and negative usage boundaries. Do not invent domain exclusions, owners, policies, or runtime routing behavior.";
    readonly code: "META-CONTEXT-PLACEHOLDER-USAGE-BOUNDARY";
    readonly title: "Shared context usage-boundary metadata contains placeholders";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-MISSING-ID";
    readonly title: "Asset is missing an id";
}, {
    readonly category: "maintenance";
    readonly confidence: "high";
    readonly code: "META-POLICY-REQUIRED-FIELD-MISSING";
    readonly title: "Repository-required metadata is missing or invalid";
    readonly severity: "high";
    readonly whyItMatters: "The repository explicitly requires this declared metadata field for every applicable catalog asset. Missing, empty, invalid, ambiguous, legacy, or inherited values do not meet that governance contract.";
    readonly remediation: "Add the reviewed field using the exact Skill metadata.renma.* spelling or registered top-level non-Skill spelling identified in the finding. Do not infer or fabricate a value.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not infer metadata from Git history, filesystem ownership, CODEOWNERS, nearby files, or inherited effective values.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not rewrite or add metadata during scan.";
    }, {
        readonly kind: "must_preserve";
        readonly text: "Preserve portable Agent Skills validity and use only canonical metadata.renma.* Skill declarations.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan . --format json.";
        readonly command: "renma scan";
    }, {
        readonly text: "Confirm the required field is valid, non-empty, and explicitly declared on the asset.";
    }];
    readonly llmHint: "Use the expectedSerializedKey in finding details and obtain a human-reviewed value. Do not invent metadata or use inherited ownership as a declaration.";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-UNKNOWN-DEPENDENCY";
    readonly title: "Metadata dependency target is unknown";
}, {
    readonly category: "maintenance";
    readonly severity: "medium";
    readonly confidence: "high";
    readonly whyItMatters: "Catalog metadata is part of the repository governance contract. Missing or malformed metadata makes asset ownership, lifecycle, and relationships harder to review and validate.";
    readonly remediation: "Update the asset metadata so catalog construction can identify the asset and validate declared relationships.";
    readonly repairConstraints: readonly [{
        readonly kind: "must_not_change";
        readonly text: "Do not introduce runtime context resolution.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not create prompt packages.";
    }, {
        readonly kind: "must_not_change";
        readonly text: "Do not silently rewrite metadata during scan.";
    }];
    readonly verificationSteps: readonly [{
        readonly text: "Run renma scan.";
        readonly command: "renma scan";
    }, {
        readonly text: "Run renma catalog.";
        readonly command: "renma catalog";
        readonly expected: "Catalog output resolves relevant assets and dependencies.";
    }, {
        readonly text: "Run any project-specific validation checks that apply to this repository.";
    }];
    readonly llmHint: "Add or correct asset governance metadata using the repository's existing frontmatter style, then rerun scan and catalog.";
    readonly code: "META-INACTIVE-DEPENDENCY";
    readonly title: "Metadata dependency targets an inactive asset";
}]>;
export declare const CATALOG_FINDING_DIAGNOSTIC_CODES: readonly ["META-INVALID-STATUS", "META-INVALID-LAST-REVIEWED-AT", "META-INVALID-EXPIRES-AT", "META-INVALID-REVIEW-CYCLE", "META-INVALID-RENMA-FRONTMATTER", "META-INVALID-STATUS-CHANGED-AT", "META-SUSPENDED-STATUS-METADATA-INCOMPLETE", "META-REQUIRED-SUSPENDED-DEPENDENCY", "META-OPTIONAL-SUSPENDED-DEPENDENCY", "META-REVOKED-STATUS-METADATA-INCOMPLETE", "META-REQUIRED-REVOKED-DEPENDENCY", "META-OPTIONAL-REVOKED-DEPENDENCY", "META-FRONTMATTER-TOO-LARGE", "META-LIST-ITEM-TOO-LONG", "META-CONTEXT-MISSING-WHEN-TO-USE", "META-CONTEXT-MISSING-WHEN-NOT-TO-USE", "META-CONTEXT-PLACEHOLDER-USAGE-BOUNDARY", "META-MISSING-ID", "META-POLICY-REQUIRED-FIELD-MISSING", "META-UNKNOWN-DEPENDENCY", "META-INACTIVE-DEPENDENCY"];
/**
 * Resolve a stable catalog diagnostic's built-in scan-Finding severity without
 * requiring that a repository happen to emit the diagnostic. Undefined means
 * the producer can use more than one built-in severity for the same ID.
 */
export declare function catalogDiagnosticDefaultFindingSeverity(diagnosticId: string): Finding["severity"] | undefined;
/** Convert catalog diagnostics by stable producer identity, never by prose. */
export declare function catalogDiagnosticFindings(diagnostics: readonly Diagnostic[]): Finding[];
export {};