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

package/dist/i-command-resolve-options.d.ts

@@ -0,0 +1,24 @@
+/**
+ * How a consumer asks the injected command resolver to read ONE string.
+ *
+ * `assumeShrk` — the string is a shrk COMMAND REFERENCE, not free shell text:
+ * a knowledge `command` reference or anchor, an agent test's
+ * `expectedCommands`, anything resolved as the `command` reference kind. A
+ * bare command-word head (`doctor`, `frobnicate zzz`) is then read as
+ * `shrk <…>` — so `doctor` resolves and `frobnicate` is an unknown verb —
+ * unless the head is not a shrk verb but a package manager or a known
+ * executable (`bun test`, `git status`), which stays `not-shrk`.
+ *
+ * Free-text sites (playbook steps, pipeline `cliCommands`, routing-hint
+ * commands) leave it unset: a bare `pytest -q` there is a shell command, not a
+ * dead shrk verb.
+ *
+ * The reading is decided in exactly one place — the CLI's command-string
+ * resolver — and every consumer asks for it through
+ * `resolveShrkCommandReference`, so knowledge-stale, the self-config doctor and
+ * the agent-test runner cannot give two answers for the same string.
+ */
+export interface ICommandResolveOptions {
+    readonly assumeShrk?: boolean;
+}
+//# sourceMappingURL=i-command-resolve-options.d.ts.map

package/dist/i-command-resolve-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-command-resolve-options.d.ts","sourceRoot":"","sources":["../src/i-command-resolve-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/i-command-resolve-options.js

@@ -0,0 +1 @@
+export {};

package/dist/i-command-safety.d.ts

@@ -0,0 +1,13 @@
+import type { commandSafetyLevel } from './command-safety-level.js';
+/**
+ * A command's DECLARED safety: its catalog row's `safetyLevel`, and whether it
+ * writes source by the catalog's own audit predicate (`writesSource ||
+ * safetyLevel === writes-source`). The CLI builds it from COMMAND_CATALOG and
+ * injects it into the ranker; the regex `commandSafetyLevel` is only the
+ * fallback where no catalog is available.
+ */
+export interface ICommandSafety {
+    readonly safetyLevel: ReturnType<typeof commandSafetyLevel>;
+    readonly writesSource: boolean;
+}
+//# sourceMappingURL=i-command-safety.d.ts.map

package/dist/i-command-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-command-safety.d.ts","sourceRoot":"","sources":["../src/i-command-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC5D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC"}

package/dist/i-command-safety.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contribution-accepted-entry.d.ts

@@ -0,0 +1,18 @@
+import type { ContributionKind } from './contribution-kind.js';
+/**
+ * One entry a contribution loader ACCEPTED, attributed to its file — the
+ * other half of the conservation law `accepted + rejected === declared`
+ * (round 12, 12.1). Registry loaders report these through
+ * `collectRegistryOutcomes`, so the contributions inventory lists every
+ * loader-backed kind structurally (never by regex).
+ */
+export interface IContributionAcceptedEntry {
+    readonly kind: ContributionKind;
+    /** Absolute path of the declaring file. */
+    readonly file: string;
+    /** Owning pack, when the file is a pack contribution. */
+    readonly packageName?: string;
+    readonly id: string;
+    readonly title?: string;
+}
+//# sourceMappingURL=i-contribution-accepted-entry.d.ts.map

package/dist/i-contribution-accepted-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contribution-accepted-entry.d.ts","sourceRoot":"","sources":["../src/i-contribution-accepted-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/i-contribution-accepted-entry.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contribution-entry-rejection.d.ts

@@ -0,0 +1,21 @@
+import type { IRejectedEntry } from '@shrkcrft/core';
+import type { ContributionKind } from './contribution-kind.js';
+/**
+ * One rejected contribution entry as THE rejection channel carries it
+ * (`collectContributionRejections`, contribution-load-failures.ts): the
+ * loader's {@link IRejectedEntry} plus the contribution kind that refused it
+ * and the pack that owns the file. Every surface — the list verbs, the
+ * self-config doctor, `packs list|get|doctor|contributions`, `packs test
+ * --load` — reads this one record (round 12, 12.1).
+ */
+export interface IContributionEntryRejection extends IRejectedEntry {
+    readonly kind: ContributionKind;
+    /** Owning pack, when the file is a pack contribution. */
+    readonly packageName?: string;
+    /**
+     * Which evidence reported it: an inspection-time loader diagnostic, a
+     * registry loader, or the gate-plane merge seam (`resolveProjectConfig`).
+     */
+    readonly via: 'loader-diagnostics' | 'registry' | 'config-plane';
+}
+//# sourceMappingURL=i-contribution-entry-rejection.d.ts.map

package/dist/i-contribution-entry-rejection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contribution-entry-rejection.d.ts","sourceRoot":"","sources":["../src/i-contribution-entry-rejection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IACjE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,UAAU,GAAG,cAAc,CAAC;CAClE"}

package/dist/i-contribution-entry-rejection.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contribution-file-issue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A contribution FILE that did not take effect — it failed to import, or a
+ * pack declares it and it is not on disk. The registry loaders that used to
+ * swallow an import failure (`catch { /* ignore *\/ }`: constructs, decisions,
+ * policy checks, feedback rules, context / agent tests) return one of these
+ * instead (round 12, 12.1c); `collectRegistryOutcomes` lifts `load-failed`
+ * into THE load-failure map like every other registry's.
+ */
+export interface IContributionFileIssue {
+    readonly severity: 'warning' | 'error';
+    readonly code: 'load-failed' | 'missing-file';
+    readonly message: string;
+    /** Absolute path of the file. */
+    readonly source: string;
+    /** Owning pack, when the file is a pack contribution. */
+    readonly packageName?: string;
+}
+//# sourceMappingURL=i-contribution-file-issue.d.ts.map

package/dist/i-contribution-file-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contribution-file-issue.d.ts","sourceRoot":"","sources":["../src/i-contribution-file-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/i-contribution-file-issue.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contribution-file-report.d.ts

@@ -0,0 +1,40 @@
+import type { RejectionCause } from '@shrkcrft/core';
+import type { ContributionKind } from './contribution-kind.js';
+import type { UnresolvableReason } from './unresolvable-reason.js';
+/**
+ * One contributed FILE in `shrk packs contributions`' `By file:` report (round
+ * 12, ONE-CHANGE): did what I wrote take effect? Entries accepted, entries
+ * rejected with every reason, and references that could not be checked
+ * because their kind's registry is empty or undeclarable. The conservation
+ * law holds per file: `accepted + rejected.length === declared`.
+ */
+export interface IContributionFileReport {
+    /** Project-relative (absolute when outside the project). */
+    readonly file: string;
+    readonly kind: ContributionKind;
+    readonly packageName?: string;
+    readonly source: 'local' | 'pack';
+    /** `failed` — the file failed to import; `missing` — a pack declares it and it is not on disk. */
+    readonly status: 'loaded' | 'failed' | 'missing';
+    readonly declared: number;
+    readonly accepted: number;
+    readonly acceptedIds: readonly string[];
+    readonly rejected: readonly {
+        readonly index: number;
+        readonly exportName?: string;
+        readonly entryId?: string;
+        readonly reasons: readonly string[];
+        readonly cause: RejectionCause;
+    }[];
+    /** The import error's first line, for a `failed` file. */
+    readonly loadError?: string;
+    /** Declared references in this file that could not be checked, grouped by (source, field, kind, reason). */
+    readonly unresolvableReferences: readonly {
+        readonly sourceId: string;
+        readonly field: string;
+        readonly kind: string;
+        readonly ids: readonly string[];
+        readonly reason: UnresolvableReason;
+    }[];
+}
+//# sourceMappingURL=i-contribution-file-report.d.ts.map

package/dist/i-contribution-file-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contribution-file-report.d.ts","sourceRoot":"","sources":["../src/i-contribution-file-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;KAChC,EAAE,CAAC;IACJ,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4GAA4G;IAC5G,QAAQ,CAAC,sBAAsB,EAAE,SAAS;QACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;KACrC,EAAE,CAAC;CACL"}

package/dist/i-contribution-file-report.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contribution-file-validation.d.ts

@@ -0,0 +1,32 @@
+import type { IRejectedEntry } from '@shrkcrft/core';
+import type { IKnowledgeValidationIssue } from '@shrkcrft/knowledge';
+import type { ContributionKind } from './contribution-kind.js';
+/**
+ * One contribution file validated at BUILD time through the runtime loader (or
+ * THE acceptance predicate) the engine applies to it at load — what `shrk packs
+ * test --load` reports per declared file (round 12, 12.1f). An unannotated
+ * literal is refused exactly as it will be at runtime, with no type-check.
+ */
+export interface IContributionFileValidation {
+    /** The manifest slot that declares the file (`conventionFiles`, …). */
+    readonly slot: string;
+    readonly kind?: ContributionKind;
+    /** Absolute path. */
+    readonly file: string;
+    /** False when the file does not exist or failed to import. */
+    readonly loaded: boolean;
+    readonly loadError?: string;
+    readonly accepted: number;
+    readonly acceptedIds: readonly string[];
+    readonly rejected: readonly IRejectedEntry[];
+    /**
+     * Issues THE knowledge validator (`validateKnowledgeEntries`) reports on
+     * entries the loader ACCEPTED — the entry is kept, and the consumer's doctor
+     * reports the same issue (a non-list `references`, a malformed reference
+     * item). Knowledge-bearing slots only; absent when there are none (round 15).
+     */
+    readonly entryIssues?: readonly IKnowledgeValidationIssue[];
+    /** True when no build-time validator exists for this slot (a reserved slot) — nothing was checked. */
+    readonly unvalidated?: boolean;
+}
+//# sourceMappingURL=i-contribution-file-validation.d.ts.map

package/dist/i-contribution-file-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contribution-file-validation.d.ts","sourceRoot":"","sources":["../src/i-contribution-file-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,sGAAsG;IACtG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/i-contribution-file-validation.js

@@ -0,0 +1 @@
+export {};

package/dist/i-contributions-report.d.ts

@@ -0,0 +1,31 @@
+import type { IVerdictCoverage } from '@shrkcrft/core';
+import type { IContributionFileReport } from './i-contribution-file-report.js';
+/**
+ * THE contributions report (round 12, ONE-CHANGE): every contributed file —
+ * local and pack — with entries accepted, entries rejected and references that
+ * cannot be checked. Built from the contributions inventory, THE rejection
+ * channel and the self-config doctor's own reference probes, so it adds no
+ * parallel resolver.
+ */
+export interface IContributionsReport {
+    readonly files: readonly IContributionFileReport[];
+    readonly totals: Readonly<{
+        files: number;
+        declared: number;
+        accepted: number;
+        rejected: number;
+        /** Files that failed to import. */
+        loadFailed: number;
+        /** Pack-declared files missing on disk. */
+        missing: number;
+        /** Declared reference ids that could not be checked. */
+        unresolvable: number;
+    }>;
+    /**
+     * THE coverage the verdict settles on: declared references probed vs those
+     * that could be checked. Absent when no reference was probed (nothing to
+     * examine is not a shortfall of THIS report).
+     */
+    readonly referenceCoverage?: IVerdictCoverage;
+}
+//# sourceMappingURL=i-contributions-report.d.ts.map

package/dist/i-contributions-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-contributions-report.d.ts","sourceRoot":"","sources":["../src/i-contributions-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,mCAAmC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,2CAA2C;QAC3C,OAAO,EAAE,MAAM,CAAC;QAChB,wDAAwD;QACxD,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CAC/C"}

package/dist/i-contributions-report.js

@@ -0,0 +1 @@
+export {};

package/dist/i-convention-applicability-reason.d.ts

@@ -0,0 +1,29 @@
+import type { ConventionAppliesToFilter } from '@shrkcrft/plugin-api';
+import type { ConventionFilterLevel } from './convention-filter-level.js';
+/** One declared `appliesTo` filter, judged — a line of `conventionApplicability(...).reasons`. */
+export interface IConventionApplicabilityReason {
+    readonly filter: ConventionAppliesToFilter;
+    readonly level: ConventionFilterLevel;
+    /** The values the convention declares for this filter. */
+    readonly declared: readonly string[];
+    /**
+     * What the filter was compared with: the detected profiles / frameworks, the
+     * file's language, the file path — or, over a file list, the distinct values
+     * seen. Empty for a reserved filter and for a per-file filter judged without a file.
+     */
+    readonly observed: readonly string[];
+    /**
+     * Did this filter admit the convention? A reserved filter always does (it is
+     * not evaluated); a per-file filter judged without a file does too (it is
+     * decided per file). Over a file list where no file passed (`conventionScope`),
+     * a per-file filter that admitted at least one file is `true` — it did not
+     * exclude the convention, another filter did — unless EVERY per-file filter
+     * admitted some file and none passed them all: then each is `false` and says
+     * the intersection is empty. So a not-applicable convention's `!matched`
+     * reasons are never empty and never name a filter that excluded nothing.
+     */
+    readonly matched: boolean;
+    /** One printable sentence: `appliesTo.profileIds [has-turborepo]: none detected (detected: has-typescript)`. */
+    readonly message: string;
+}
+//# sourceMappingURL=i-convention-applicability-reason.d.ts.map

package/dist/i-convention-applicability-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-convention-applicability-reason.d.ts","sourceRoot":"","sources":["../src/i-convention-applicability-reason.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,kGAAkG;AAClG,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gHAAgH;IAChH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/i-convention-applicability-reason.js

@@ -0,0 +1 @@
+export {};

package/dist/i-convention-applicability.d.ts

@@ -0,0 +1,9 @@
+import type { IConventionApplicabilityReason } from './i-convention-applicability-reason.js';
+/** THE answer to "does this convention apply here?" — `conventionApplicability` (round 15, 15.1). */
+export interface IConventionApplicability {
+    /** True iff every declared filter matched (an absent or empty filter imposes nothing). */
+    readonly applicable: boolean;
+    /** One judgement per DECLARED filter, workspace filters first — empty when `appliesTo` declares none. */
+    readonly reasons: readonly IConventionApplicabilityReason[];
+}
+//# sourceMappingURL=i-convention-applicability.d.ts.map

package/dist/i-convention-applicability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-convention-applicability.d.ts","sourceRoot":"","sources":["../src/i-convention-applicability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAE7F,qGAAqG;AACrG,MAAM,WAAW,wBAAwB;IACvC,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC7D"}

package/dist/i-convention-applicability.js

@@ -0,0 +1 @@
+export {};

package/dist/i-convention-scope.d.ts

@@ -0,0 +1,19 @@
+import type { IConventionApplicabilityReason } from './i-convention-applicability-reason.js';
+/**
+ * Which of a file list one convention covers — `conventionScope`, the ONE
+ * answer `conventions check` and the rule-graph bridge both read (round 15).
+ */
+export interface IConventionScope {
+    readonly conventionId: string;
+    /**
+     * False when a workspace filter excluded the convention, or when the file
+     * list was non-empty and no file in it passed the per-file filters: the
+     * convention is then never evaluated, and {@link reasons} say why.
+     */
+    readonly applicable: boolean;
+    /** The files of the list the convention covers, in list order (empty when not applicable). */
+    readonly files: readonly string[];
+    /** The declared filters, judged — over the whole list for the per-file ones. */
+    readonly reasons: readonly IConventionApplicabilityReason[];
+}
+//# sourceMappingURL=i-convention-scope.d.ts.map

package/dist/i-convention-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-convention-scope.d.ts","sourceRoot":"","sources":["../src/i-convention-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAE7F;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC7D"}

package/dist/i-convention-scope.js

@@ -0,0 +1 @@
+export {};

package/dist/i-declared-xref-field.d.ts

@@ -0,0 +1,25 @@
+import type { ReferenceKind } from './reference-registry.js';
+/**
+ * One asset field that carries cross-reference ids — a row of
+ * `DECLARED_XREF_FIELDS`, the ONE table of which declared fields hold ids.
+ */
+export interface IDeclaredXrefField {
+    /** The asset kind that declares the field (itself a reference kind). */
+    readonly sourceKind: ReferenceKind;
+    /**
+     * Dotted path of the field on the asset (`actionHints.relatedKnowledge`).
+     * `facets` stands for every construct facet value that declares `resolvesAs`.
+     */
+    readonly field: string;
+    /**
+     * The kinds an id in this field may resolve as. `'any'` = every kind (the
+     * untyped `related` / `seeAlso`); `'declared'` = per value, from the value's
+     * own `resolvesAs` (construct facets).
+     */
+    readonly accepts: readonly ReferenceKind[] | 'any' | 'declared';
+    /** Severity of a dangling or wrong-kind id in this field. */
+    readonly severity: 'error' | 'warning';
+    /** Graph relation the field expresses: `supersedes` for `supersededBy`, else `related`. */
+    readonly relation: 'related' | 'supersedes';
+}
+//# sourceMappingURL=i-declared-xref-field.d.ts.map

package/dist/i-declared-xref-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-declared-xref-field.d.ts","sourceRoot":"","sources":["../src/i-declared-xref-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC;IAChE,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY,CAAC;CAC7C"}

package/dist/i-declared-xref-field.js

@@ -0,0 +1 @@
+export {};

package/dist/i-declared-xref-issue.d.ts

@@ -0,0 +1,25 @@
+import type { ReferenceKind } from './reference-registry.js';
+/**
+ * A problem with a declaration itself rather than with one id's resolution:
+ * a facet naming a reference kind that does not exist (the `$use`-typo shape),
+ * a supersession cycle or chain, a field that is not a list of string ids.
+ */
+export interface IDeclaredXrefIssue {
+    readonly code: 'xref-unknown-kind' | 'xref-superseded-cycle' | 'xref-superseded-chain' | 'xref-malformed';
+    readonly severity: 'error' | 'warning';
+    readonly sourceKind: ReferenceKind;
+    readonly sourceId: string;
+    readonly field: string;
+    /**
+     * The id the issue concerns: the successor of a supersession issue; for
+     * `xref-unknown-kind`, the facet VALUE whose declared kind is typo'd — that
+     * value may well resolve, the KIND is what is wrong.
+     */
+    readonly targetId?: string;
+    /** A facet value's `id` (`facets.<name>` issues): which value of the facet the issue is about. */
+    readonly facetId?: string;
+    readonly file?: string;
+    readonly packageName?: string;
+    readonly message: string;
+}
+//# sourceMappingURL=i-declared-xref-issue.d.ts.map

package/dist/i-declared-xref-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-declared-xref-issue.d.ts","sourceRoot":"","sources":["../src/i-declared-xref-issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EACT,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,GACvB,gBAAgB,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/i-declared-xref-issue.js

@@ -0,0 +1 @@
+export {};

package/dist/i-declared-xref-report.d.ts

@@ -0,0 +1,48 @@
+import type { IDeclaredXrefIssue } from './i-declared-xref-issue.js';
+import type { IDeclaredXrefRow } from './i-declared-xref-row.js';
+import type { ReferenceKind } from './reference-registry.js';
+/**
+ * Every declared cross-reference id in the workspace, resolved — the answer
+ * the self-config doctor, `self-config broken-links`, `packs doctor`, `templates
+ * drift`, `knowledge remove` and `shrk quality` all read.
+ */
+export interface IDeclaredXrefReport {
+    readonly schema: 'sharkcraft.declared-xrefs/v1';
+    /** One row per (source, field, id) — ok ones included, so `examined` is visible. */
+    readonly rows: readonly IDeclaredXrefRow[];
+    readonly issues: readonly IDeclaredXrefIssue[];
+    readonly counts: Readonly<{
+        ids: number;
+        ok: number;
+        dangling: number;
+        wrongKind: number;
+        unverified: number;
+        /** Error-severity dangling / wrong-kind rows plus error issues. */
+        errors: number;
+        /** Warning-severity dangling / wrong-kind rows plus warning issues. */
+        warnings: number;
+    }>;
+    /** What the collector looked at — zero coverage must be visible, never a silent pass. */
+    readonly examined: Readonly<{
+        /** Assets walked (every knowledge entry, construct, boundary rule and template). */
+        sources: number;
+        sourcesByKind: Readonly<Record<string, number>>;
+        /** Declared ids resolved (= rows.length). */
+        ids: number;
+        /** Distinct `<sourceKind>.<field>` that declared at least one id. */
+        fields: number;
+        byField: Readonly<Record<string, Readonly<{
+            ids: number;
+            dangling: number;
+            wrongKind: number;
+            unverified: number;
+        }>>>;
+        /** Facet values with no `resolvesAs` — free-form, counted but not validated. */
+        facetValuesUndeclared: number;
+        /** True when the async registries were warmed before collecting. */
+        cacheWarm: boolean;
+        /** Source kinds that could not be enumerated (constructs, on a cold cache). */
+        unreadSources: readonly ReferenceKind[];
+    }>;
+}
+//# sourceMappingURL=i-declared-xref-report.d.ts.map

package/dist/i-declared-xref-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-declared-xref-report.d.ts","sourceRoot":"","sources":["../src/i-declared-xref-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,mEAAmE;QACnE,MAAM,EAAE,MAAM,CAAC;QACf,uEAAuE;QACvE,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC1B,oFAAoF;QACpF,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,6CAA6C;QAC7C,GAAG,EAAE,MAAM,CAAC;QACZ,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC,CAAC;QACtH,gFAAgF;QAChF,qBAAqB,EAAE,MAAM,CAAC;QAC9B,oEAAoE;QACpE,SAAS,EAAE,OAAO,CAAC;QACnB,+EAA+E;QAC/E,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;KACzC,CAAC,CAAC;CACJ"}

package/dist/i-declared-xref-report.js

@@ -0,0 +1 @@
+export {};

package/dist/i-declared-xref-row.d.ts

@@ -0,0 +1,29 @@
+import type { DeclaredXrefStatus } from './declared-xref-status.js';
+import type { ReferenceKind } from './reference-registry.js';
+/** One declared cross-reference id, resolved against the reference registry. */
+export interface IDeclaredXrefRow {
+    /** The asset kind that declares the id. */
+    readonly sourceKind: ReferenceKind;
+    readonly sourceId: string;
+    /** The field it sits in (`related`, `actionHints.relatedTemplates`, `facets.<name>`). */
+    readonly field: string;
+    /** For a facet value: the value's own id within the facet. */
+    readonly facetId?: string;
+    readonly targetId: string;
+    /** Where the source asset is declared (project-relative when possible). */
+    readonly file?: string;
+    /** Set when the source asset is pack-contributed. */
+    readonly packageName?: string;
+    /** The kinds the field accepts (`'any'` = every kind). */
+    readonly accepts: readonly ReferenceKind[] | 'any';
+    /** EVERY kind whose registry lists the id, most specific first. Empty = resolves nowhere. */
+    readonly resolvedAs: readonly ReferenceKind[];
+    readonly status: DeclaredXrefStatus;
+    /** The field's severity for a dangling / wrong-kind id; `info` for ok and unverified. */
+    readonly severity: 'error' | 'warning' | 'info';
+    readonly relation: 'related' | 'supersedes';
+    readonly message: string;
+    /** Closest registered ids among the accepted kinds (dangling / wrong-kind only). */
+    readonly didYouMean: readonly string[];
+}
+//# sourceMappingURL=i-declared-xref-row.d.ts.map

package/dist/i-declared-xref-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-declared-xref-row.d.ts","sourceRoot":"","sources":["../src/i-declared-xref-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,KAAK,CAAC;IACnD,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC"}

package/dist/i-declared-xref-row.js

@@ -0,0 +1 @@
+export {};

package/dist/i-doctor-verdict.d.ts

@@ -0,0 +1,10 @@
+import type { DoctorVerdictKind } from './doctor-verdict-kind.js';
+/** A doctor run, settled once (`doctorVerdict`). */
+export interface IDoctorVerdict {
+    readonly verdict: DoctorVerdictKind;
+    /** True only for `DoctorVerdictKind.Ready`. */
+    readonly ready: boolean;
+    /** Core's `coverageShortfall` of each doctor coverage record that has one. */
+    readonly shortfalls: readonly string[];
+}
+//# sourceMappingURL=i-doctor-verdict.d.ts.map

package/dist/i-doctor-verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-doctor-verdict.d.ts","sourceRoot":"","sources":["../src/i-doctor-verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC"}

package/dist/i-doctor-verdict.js

@@ -0,0 +1 @@
+export {};

package/dist/i-file-language.d.ts

@@ -0,0 +1,11 @@
+import type { CommentSyntax } from './comment-syntax.js';
+/** One row of THE extension → language table (`FILE_LANGUAGES`, `file-languages.ts`). */
+export interface IFileLanguage {
+    /** The language id — the vocabulary `shrk stats` prints and `appliesTo.languages` names (`typescript`). */
+    readonly id: string;
+    /** File extensions, dot included (`.ts`); matched case-insensitively. */
+    readonly extensions: readonly string[];
+    /** How the language writes comments (`shrk stats` line classification). */
+    readonly comment: CommentSyntax;
+}
+//# sourceMappingURL=i-file-language.d.ts.map

package/dist/i-file-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-file-language.d.ts","sourceRoot":"","sources":["../src/i-file-language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}

package/dist/i-file-language.js

@@ -0,0 +1 @@
+export {};

package/dist/i-kind-outcomes.d.ts

@@ -0,0 +1,13 @@
+import type { IContributionLoadFailure } from './contribution-load-failures.js';
+import type { IContributionEntryRejection } from './i-contribution-entry-rejection.js';
+/**
+ * What the loaders of a few contribution kinds reported in one run
+ * (`collectKindOutcomes`): the entries they refused and the files that never
+ * loaded. A `list` verb prints both after its list, so a file that failed to
+ * import is never a silently empty list (round 12 review, A-4).
+ */
+export interface IKindOutcomes {
+    readonly rejections: readonly IContributionEntryRejection[];
+    readonly loadFailures: readonly IContributionLoadFailure[];
+}
+//# sourceMappingURL=i-kind-outcomes.d.ts.map

package/dist/i-kind-outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-kind-outcomes.d.ts","sourceRoot":"","sources":["../src/i-kind-outcomes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC5D,QAAQ,CAAC,YAAY,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC5D"}

package/dist/i-kind-outcomes.js

@@ -0,0 +1 @@
+export {};

package/dist/i-not-applicable-convention.d.ts

@@ -0,0 +1,17 @@
+import type { ConventionSeverity } from '@shrkcrft/plugin-api';
+import type { IConventionApplicabilityReason } from './i-convention-applicability-reason.js';
+/**
+ * A convention `conventions check` did NOT evaluate because it does not apply
+ * here (round 15, 15.1) — printed in text and in `--json` `notApplicable[]`,
+ * never a silent skip.
+ */
+export interface INotApplicableConvention {
+    readonly conventionId: string;
+    /** The convention's declared severity — THE closed set `IConvention.severity` uses (round 15 follow-up, F8). */
+    readonly severity: ConventionSeverity;
+    readonly sourceFile: string;
+    readonly packageName?: string;
+    /** The declared filters that excluded it (never empty). */
+    readonly reasons: readonly IConventionApplicabilityReason[];
+}
+//# sourceMappingURL=i-not-applicable-convention.d.ts.map

package/dist/i-not-applicable-convention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-not-applicable-convention.d.ts","sourceRoot":"","sources":["../src/i-not-applicable-convention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gHAAgH;IAChH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC7D"}

package/dist/i-not-applicable-convention.js

@@ -0,0 +1 @@
+export {};