@shrkcrft/inspector 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/registration-hint-registry.d.ts

@@ -1,5 +1,7 @@
 import { type IRegistrationHint, type IRegistrationHintOperation } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IRejectedEntry, type ISettledUnitLiveness, type IVerdictCoverage } from '@shrkcrft/core';
+import { RegistrationHintDiscoveryStatus } from './registration-hint-discovery-status.js';
 export declare const REGISTRATION_HINT_REGISTRY_SCHEMA = "sharkcraft.registration-hint-registry/v1";
 export declare enum RegistrationHintSource {
     Local = "local",
@@ -18,10 +20,19 @@ export interface IRegistrationHintDoctorIssue {
     readonly message: string;
     readonly hintId?: string;
     readonly source?: string;
+    /** What the finding is about: the dead selector, the missing anchor, `(discovery)`. */
+    readonly target?: string;
 }
+/**
+ * THE registration-hint acceptance predicate (round 12, 12.1): every issue of
+ * `validateRegistrationHint`, `<field>: <message>` — `[]` means accepted.
+ */
+export declare function registrationHintRejectionReasons(raw: unknown): readonly string[];
 export declare function loadRegistrationHints(inspection: ISharkcraftInspection): Promise<{
     entries: readonly IRegistrationHintEntry[];
     issues: readonly IRegistrationHintDoctorIssue[];
+    /** Every declared hint the loader refused — invalid or a duplicate id (round 12, 12.1). */
+    rejected: readonly IRejectedEntry[];
 }>;
 export declare function listRegistrationHints(inspection: ISharkcraftInspection): Promise<readonly IRegistrationHintEntry[]>;
 export declare function getRegistrationHint(inspection: ISharkcraftInspection, hintId: string): Promise<IRegistrationHintEntry | null>;
@@ -46,10 +57,79 @@ export interface IRegistrationHintPreview {
     readonly safetyNotes: readonly string[];
     readonly validationCommands: readonly string[];
     readonly nextCommand: string;
+    /** Set when the discovery walk hit its directory cap: `candidates` is incomplete. */
+    readonly discoveryCapped?: true;
 }
 export interface IRegistrationHintPreviewOptions {
     readonly variables?: Readonly<Record<string, string>>;
 }
 export declare function previewRegistrationHint(inspection: ISharkcraftInspection, hintId: string, options?: IRegistrationHintPreviewOptions): Promise<IRegistrationHintPreview | null>;
+/** What THE discovery authority found for one hint. */
+export interface IRegistrationHintCandidates {
+    /** `fixed` = `discovery.targetFile`; `glob` = `discovery.targetGlobs`; `none` = neither. */
+    readonly mode: 'fixed' | 'glob' | 'none';
+    /** Distinct project-relative candidate files, in discovery order (a fixed target only when it exists). */
+    readonly candidates: readonly string[];
+    /** Per selector — the fixed `targetFile`, or each glob — how many files it matched. */
+    readonly perGlob: readonly {
+        readonly glob: string;
+        readonly matched: number;
+    }[];
+    /** True when a walk hit its directory cap: the candidate set is incomplete. */
+    readonly capped: boolean;
+}
+/**
+ * THE discovery authority for a registration hint: `registrations preview`
+ * acts on it and the doctor classifies it, so "what would this hint target?"
+ * has one answer. A fixed `targetFile` counts as a candidate only when it
+ * exists (preview still names it either way).
+ */
+export declare function resolveRegistrationHintCandidates(inspection: ISharkcraftInspection, hint: IRegistrationHint): IRegistrationHintCandidates;
+/** One hint's discovery, classified — what `registrations doctor --json` lists per hint. */
+export interface IRegistrationHintStatus {
+    readonly id: string;
+    readonly discovery: IRegistrationHintCandidates['mode'];
+    readonly candidates: number;
+    readonly status: RegistrationHintDiscoveryStatus;
+    readonly source: string;
+}
+/** The registration-hint doctor: load issues + per-hint discovery + coverage. */
+export interface IRegistrationHintDoctorReport {
+    readonly issues: readonly IRegistrationHintDoctorIssue[];
+    readonly hints: readonly IRegistrationHintStatus[];
+    readonly totals: Readonly<{
+        hints: number;
+        verified: number;
+        ambiguous: number;
+        dead: number;
+        unverified: number;
+        intendedEmpty: number;
+    }>;
+    /**
+     * `discovery selectors` — THE settle's records (round 13): record A over every
+     * fixed `targetFile` and every glob not marked intended-empty (examined =
+     * those matching at least one file; a dead selector is a shortfall, so "0
+     * issues" can never be read as "every hint verified"), and — when a marked
+     * selector matches nothing — record B, its printed `acceptedBy: expectEmpty`
+     * acceptance.
+     */
+    readonly coverage: readonly IVerdictCoverage[];
+    /** Every UNMARKED dead selector, labelled `registration hint <hint>: <selector>` — THE settle's `dead`. */
+    readonly deadUnits: readonly string[];
+    /**
+     * THE settle over every hint's discovery selectors (round 13): each unit's
+     * state (live / dead / intended-empty / went-live / unproven) and mark —
+     * what `--fail-on-dead-units` decides on (`selectorUnitFails`).
+     */
+    readonly liveness: ISettledUnitLiveness;
+}
+/**
+ * Verify every hint's discovery against the live tree through THE discovery
+ * authority. Fixed targets used to be the only ones checked; glob discovery —
+ * used precisely when the author was unsure of the target — got none, so a
+ * dead, an ambiguous and an anchor-less glob hint all read "OK".
+ */
+export declare function buildRegistrationHintDoctorReport(inspection: ISharkcraftInspection): Promise<IRegistrationHintDoctorReport>;
+/** Load issues + discovery findings — {@link buildRegistrationHintDoctorReport}'s issue list. */
 export declare function listRegistrationHintIssues(inspection: ISharkcraftInspection): Promise<readonly IRegistrationHintDoctorIssue[]>;
 //# sourceMappingURL=registration-hint-registry.d.ts.map

package/dist/registration-hint-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registration-hint-registry.d.ts","sourceRoot":"","sources":["../src/registration-hint-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registration-hint-registry.d.ts","sourceRoot":"","sources":["../src/registration-hint-registry.ts"],"names":[],"mappings":"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"}