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

package/dist/contribution-kind.js

@@ -0,0 +1,52 @@
+/**
+ * Every contribution kind the engine loads — one per manifest contribution
+ * slot that has a loader (`CONTRIBUTION_FILE_KEYS`, @shrkcrft/plugin-api), plus
+ * `path-convention` / `docs`, whose slots feed the path / knowledge loaders.
+ *
+ * Round 12 (12.1e): the inventory knew only the knowledge family and six
+ * registries, so a registration hint, a gate-plane rule, a delegate recipe or
+ * a construct facet contributed by a pack appeared on no contributions surface
+ * — and neither did a rejected one. Every loader-backed slot now has a kind
+ * (the inventory's `KIND_TO_SLOT` is a `Record` over this enum, so a kind
+ * without a slot is a compile error, and an r76 lock holds every loader-backed
+ * slot to a kind).
+ */
+export var ContributionKind;
+(function (ContributionKind) {
+    ContributionKind["Knowledge"] = "knowledge";
+    ContributionKind["Rule"] = "rule";
+    ContributionKind["Path"] = "path";
+    ContributionKind["PathConvention"] = "path-convention";
+    ContributionKind["Template"] = "template";
+    ContributionKind["Pipeline"] = "pipeline";
+    ContributionKind["Preset"] = "preset";
+    ContributionKind["Boundary"] = "boundary";
+    ContributionKind["ScaffoldPattern"] = "scaffold-pattern";
+    ContributionKind["Policy"] = "policy";
+    ContributionKind["Construct"] = "construct";
+    ContributionKind["ConstructFacet"] = "construct-facet";
+    ContributionKind["Playbook"] = "playbook";
+    ContributionKind["SearchTuning"] = "search-tuning";
+    ContributionKind["FeedbackRule"] = "feedback-rule";
+    ContributionKind["Decision"] = "decision";
+    ContributionKind["ContractTemplate"] = "contract-template";
+    ContributionKind["MigrationProfile"] = "migration-profile";
+    ContributionKind["ContextTest"] = "context-test";
+    ContributionKind["AgentTest"] = "agent-test";
+    ContributionKind["Helper"] = "helper";
+    ContributionKind["TaskRoutingHint"] = "task-routing-hint";
+    ContributionKind["RegistrationHint"] = "registration-hint";
+    ContributionKind["Convention"] = "convention";
+    ContributionKind["Docs"] = "docs";
+    ContributionKind["DelegateRecipe"] = "delegate-recipe";
+    ContributionKind["FrameworkExtractor"] = "framework-extractor";
+    ContributionKind["WiringRule"] = "wiring-rule";
+    ContributionKind["Registry"] = "registry";
+    ContributionKind["RegistrationIdiom"] = "registration-idiom";
+    ContributionKind["PolicyRule"] = "policy-rule";
+    ContributionKind["ReusePrimitive"] = "reuse-primitive";
+    ContributionKind["Baseline"] = "baseline";
+    ContributionKind["GeneratedArtifact"] = "generated-artifact";
+    /** `docReferenceFiles` — the prose doc-reference plane (round 13: a declared slot). */
+    ContributionKind["DocReference"] = "doc-reference";
+})(ContributionKind || (ContributionKind = {}));

package/dist/contribution-load-failures.d.ts

@@ -0,0 +1,106 @@
+import type { IRejectedEntry } from '@shrkcrft/core';
+import { ContributionKind } from './contribution-kind.js';
+import type { LoaderAssetKind } from './inspector-cache.js';
+import type { IContributionEntryRejection } from './i-contribution-entry-rejection.js';
+import type { IKindOutcomes } from './i-kind-outcomes.js';
+import type { IRegistryOutcomes } from './i-registry-outcomes.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export interface IContributionLoadFailure {
+    /** Absolute path of the file that failed to load. */
+    readonly file: string;
+    /** The loader kind that tried it (`knowledge`, `templates`, `helper`, `convention`, …). */
+    readonly kind: string;
+    /** Owning pack, when the file is a pack contribution. */
+    readonly packageName?: string;
+    /** First line of the underlying error. */
+    readonly message: string;
+    /** Which evidence reported it. */
+    readonly via: 'loader-diagnostics' | 'registry';
+}
+/**
+ * A registry entry's `sourceFile` as an absolute path: registries report a
+ * PACK-relative path for pack entries and a PROJECT-relative one for local
+ * entries (`nodePath.resolve` against `process.cwd()` made both cwd-dependent).
+ * The self-config doctor attributes an unresolvable reference to its file
+ * through this same resolution.
+ */
+export declare function resolveEntryFile(inspection: ISharkcraftInspection, file: string, packageName?: string): string;
+/** A contribution file as every surface prints it: project-relative (POSIX), or absolute when outside the project. */
+export declare function contributionFileLabel(projectRoot: string, file: string): string;
+/**
+ * Normalise a registry loader's issues into load failures. Only `load-failed`
+ * counts: `invalid-*` / `duplicate-id` issues concern entries of a file that
+ * DID load (they travel as rejections), and `missing-file` is reported by the
+ * manifest checks.
+ */
+export declare function registryIssuesToLoadFailures(inspection: ISharkcraftInspection, kind: string, issues: readonly {
+    readonly code?: string;
+    readonly message: string;
+    readonly source?: string;
+}[]): IContributionLoadFailure[];
+/** Scaffold-pattern loading reports failures as warning strings; lift the import failures. */
+export declare function scaffoldWarningsToLoadFailures(inspection: ISharkcraftInspection, warnings: readonly string[]): IContributionLoadFailure[];
+/** Lift one loader's `rejected` records into THE channel's shape (absolute file, owning pack attributed). */
+export declare function liftRejections(inspection: ISharkcraftInspection, kind: ContributionKind, rejected: readonly IRejectedEntry[], via?: IContributionEntryRejection['via']): IContributionEntryRejection[];
+/** Every contribution kind a registry loader answers for (the rest report through loader diagnostics). */
+export declare const REGISTRY_BACKED_KINDS: readonly ContributionKind[];
+/**
+ * Run the registry loaders ONCE and return what they reported: load failures,
+ * rejected entries and accepted entries (each attributed to its file). With
+ * `kinds`, only the loaders for those kinds run — a `list` verb asks for its
+ * own kind. Every loader degrades to "nothing" on a throw, never a crash.
+ */
+export declare function collectRegistryOutcomes(inspection: ISharkcraftInspection, options?: {
+    readonly kinds?: readonly ContributionKind[];
+}): Promise<IRegistryOutcomes>;
+/**
+ * Run the async registry loaders once and return their load failures. Callers
+ * that already ran them (the async inventory) pass their own issues instead.
+ */
+export declare function collectRegistryLoadFailures(inspection: ISharkcraftInspection): Promise<readonly IContributionLoadFailure[]>;
+/**
+ * Every known load failure, keyed by absolute file path. `registryFailures`
+ * adds what the async registries reported (see {@link collectRegistryLoadFailures}).
+ */
+export declare function collectContributionLoadFailures(inspection: ISharkcraftInspection, registryFailures?: readonly IContributionLoadFailure[]): ReadonlyMap<string, IContributionLoadFailure>;
+/**
+ * An inspection-time loader's asset kind → the contribution kind its
+ * rejections belong to. A `Record` over {@link LoaderAssetKind}, so a loader
+ * kind added without a row is a compile error.
+ */
+export declare const LOADER_ASSET_KIND_CONTRIBUTION: Readonly<Record<LoaderAssetKind, ContributionKind>>;
+/**
+ * THE contribution kind of a loader's `kind` (round 12 review, R12-X4): a load
+ * failure's / diagnostic's `kind` names the loader that tried the file — the
+ * plural asset kind for the inspection-time loaders (`rules`, `templates`, …),
+ * the contribution kind itself for the registry loaders (`helper`,
+ * `convention`, …). Every reader maps through here — the rejection channel,
+ * `collectKindOutcomes`, the contributions report's rows and `packs
+ * contributions --kind` — so a printed row and the exit read one table.
+ * `undefined` for a kind no loader reports.
+ */
+export declare function contributionKindOfLoader(kind: string): ContributionKind | undefined;
+/**
+ * THE rejection channel (round 12, 12.1): every rejected contribution entry —
+ * the inspection-time loaders' (`loaderDiagnostics[].rejected`) plus what the
+ * registry loaders reported (`registryRejections`, from
+ * {@link collectRegistryOutcomes}) — deduplicated and sorted by file then
+ * position. Every surface reads this list; none re-derives it.
+ */
+export declare function collectContributionRejections(inspection: ISharkcraftInspection, registryRejections?: readonly IContributionEntryRejection[]): readonly IContributionEntryRejection[];
+/**
+ * The rejections AND load failures of `kinds` only, from ONE run of just the
+ * loaders those kinds need — what a `list` verb reads for its `⚠` note. A file
+ * that never loaded drops every entry it declares, so it is said as loudly as
+ * a refused entry (round 12 review, A-4: `conventions list` printed "(none —
+ * contribute via … sharkcraft/conventions.ts)" over the very file that failed).
+ */
+export declare function collectKindOutcomes(inspection: ISharkcraftInspection, kinds: readonly ContributionKind[]): Promise<IKindOutcomes>;
+/** The rejections of `kinds` only — {@link collectKindOutcomes} without the load failures. */
+export declare function collectKindRejections(inspection: ISharkcraftInspection, kinds: readonly ContributionKind[]): Promise<readonly IContributionEntryRejection[]>;
+/**
+ * THE one wording of a rejected entry, used on every surface:
+ * `'conv.b' (default[8]) — severity: severity must be one of: info, warning, error (got undefined)`.
+ */
+export declare function formatEntryRejection(r: Pick<IRejectedEntry, 'entryId' | 'index' | 'exportName' | 'reasons'>): string;
+//# sourceMappingURL=contribution-load-failures.d.ts.map

package/dist/contribution-load-failures.d.ts.map

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