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

package/dist/scaffold-pattern-doctor-report.js

@@ -0,0 +1,54 @@
+import { ContributionKind } from "./contribution-kind.js";
+import { collectKindRejections } from "./contribution-load-failures.js";
+import { doctorScaffoldPatterns, enumerateScaffoldPatternCandidates, loadScaffoldPatternsFromInspection, scaffoldPatternCoverage, } from "./scaffold-patterns.js";
+const NO_ENUMERATION = { byPattern: new Map(), firstMatch: [], walked: 0 };
+/**
+ * THE scaffold-pattern doctor (round 13): load (THE rejection channel names
+ * every refused pattern), validate the definitions, walk ONCE with THE
+ * enumeration `infer templates` attributes candidates with, and settle every
+ * `matchPaths` glob and every pattern through THE liveness authority.
+ *
+ * `shrk scaffolds doctor` and MCP `get_scaffold_pattern_doctor` both read it
+ * and propose through `assetDoctorProposedExit` — the MCP tool used to drop
+ * the patterns the loader refused and to return no verdict, so it answered
+ * "0 errors" where the CLI exited 1.
+ *
+ * `emptyAcceptance` is the CLI's `--allow-empty` valve for zero patterns (`{}`
+ * from MCP: nothing declared is NOT VERIFIED).
+ */
+export async function buildScaffoldPatternDoctorReport(inspection, emptyAcceptance = {}) {
+    const result = await loadScaffoldPatternsFromInspection(inspection);
+    const enumeration = result.patterns.length > 0 ? enumerateScaffoldPatternCandidates(inspection.projectRoot, result.patterns) : undefined;
+    const issues = doctorScaffoldPatterns(result.patterns, inspection, enumeration);
+    const measured = scaffoldPatternCoverage(result.patterns, enumeration ?? NO_ENUMERATION);
+    const coverage = result.patterns.length === 0
+        ? [
+            ...measured.coverage,
+            {
+                unit: 'scaffold patterns',
+                expected: 0,
+                examined: 0,
+                reason: 'no scaffold patterns declared',
+                ...emptyAcceptance,
+            },
+        ]
+        : measured.coverage;
+    // A pattern the loader REFUSED never reaches `doctorScaffoldPatterns` (it is
+    // not loaded) — it is an error here (round 12, 12.1).
+    const rejected = await collectKindRejections(inspection, [ContributionKind.ScaffoldPattern]);
+    return {
+        patterns: result.patterns,
+        loadWarnings: result.warnings,
+        rejected,
+        issues,
+        errors: issues.filter((i) => i.severity === 'error').length + rejected.length,
+        warnings: issues.filter((i) => i.severity === 'warning').length,
+        measured,
+        coverage,
+        patternCoverage: [...(enumeration?.byPattern.values() ?? [])].map((c) => ({
+            patternId: c.patternId,
+            files: c.files.length,
+            perMatchPath: c.perMatchPath,
+        })),
+    };
+}

package/dist/scaffold-patterns.d.ts

@@ -1,3 +1,4 @@
+import { type IRejectedEntry, type ISettledUnitLiveness, type IVerdictCoverage } from '@shrkcrft/core';
 import { type IScaffoldPattern } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection, ISourceInfo } from './sharkcraft-inspector.js';
 export interface IScaffoldPatternWithSource {
@@ -6,11 +7,29 @@ export interface IScaffoldPatternWithSource {
 }
 export interface IScaffoldPatternsLoadResult {
     patterns: IScaffoldPatternWithSource[];
+    /** FILE-level problems (missing, not an array, failed to import). */
     warnings: string[];
+    /**
+     * Every declared pattern the loader refused — invalid or a duplicate id —
+     * with its position and every reason (round 12, 12.1). These used to be
+     * unstructured warning strings the self-config doctor discarded.
+     */
+    rejected: IRejectedEntry[];
 }
+/**
+ * THE scaffold-pattern acceptance predicate (round 12, 12.1 / 12.1d): `id`,
+ * `templateId`, a non-empty `matchPaths` and a `confidence` from the closed
+ * set — `[]` means accepted. `confidence` was checked only by `scaffolds
+ * doctor`, so a pattern without one was ACCEPTED and `scaffolds list` crashed
+ * on it (`p.pattern.confidence.padEnd`).
+ */
+export declare function scaffoldPatternRejectionReasons(raw: unknown): readonly string[];
 export declare function loadScaffoldPatternsFromFile(file: string): Promise<{
     patterns: IScaffoldPattern[];
+    /** Each accepted pattern's position in the file's array (parallel to `patterns`). */
+    indices: number[];
     warnings: string[];
+    rejected: IRejectedEntry[];
 }>;
 /**
  * Walk the inspection's discovered packs and load every `scaffoldPatternFiles`
@@ -22,14 +41,69 @@ export interface IScaffoldPatternIssue {
     field: string;
     severity: 'error' | 'warning' | 'info';
     message: string;
+    /** Set on the coverage findings: `matchPaths-matched-nothing` / `pattern-dead`. */
+    code?: string;
+    /** The selector the finding is about (the dead `matchPaths` glob). */
+    target?: string;
 }
-export declare function doctorScaffoldPatterns(patterns: readonly IScaffoldPatternWithSource[], inspection: ISharkcraftInspection): readonly IScaffoldPatternIssue[];
+/**
+ * `coverage` (optional, from {@link enumerateScaffoldPatternCandidates}) adds
+ * the per-unit dead-selector checks: a `matchPaths` glob matching no file, and
+ * a pattern matching no file after `excludePaths`. Without it only the
+ * definitions are validated (back-compat).
+ */
+export declare function doctorScaffoldPatterns(patterns: readonly IScaffoldPatternWithSource[], inspection: ISharkcraftInspection, coverage?: IScaffoldPatternEnumeration): readonly IScaffoldPatternIssue[];
 /**
  * Convert a glob-like pattern (only `*` and `**` are recognized) into a
  * RegExp. Kept tiny — we don't depend on `minimatch`.
  */
 export declare function globToRegExp(glob: string): RegExp;
 export declare function matchScaffoldPattern(pattern: IScaffoldPattern, relativePath: string): boolean;
+/**
+ * THE scaffold candidate walker: every file under `root` once (skipping
+ * vendor/build/VCS and test dirs), with its project-relative POSIX path.
+ * `infer templates` and the scaffold doctor both read it, so the doctor's
+ * per-pattern counts equal infer's candidates by construction. Returns the
+ * number of files visited.
+ */
+export declare function walkScaffoldCandidateFiles(root: string, onFile: (abs: string, rel: string) => void): number;
+/** One pattern's matches: files after `excludePaths`, and raw hits per `matchPaths` glob. */
+export interface IScaffoldPatternCoverage {
+    readonly patternId: string;
+    readonly files: readonly string[];
+    readonly perMatchPath: readonly {
+        readonly glob: string;
+        readonly files: number;
+    }[];
+}
+/** What one walk found for every pattern. */
+export interface IScaffoldPatternEnumeration {
+    readonly byPattern: ReadonlyMap<string, IScaffoldPatternCoverage>;
+    /** Walk order, attributed to the FIRST pattern (in input order) that matches — infer's attribution. */
+    readonly firstMatch: readonly {
+        readonly file: string;
+        readonly patternId: string;
+    }[];
+    readonly walked: number;
+}
+/**
+ * Walk once and count, per pattern, the files it matches (the runtime matcher,
+ * `excludePaths` honoured) and the files each `matchPaths` glob matches on its
+ * own (`globToRegExp` — the pattern's own dialect, not the boundaries one).
+ */
+export declare function enumerateScaffoldPatternCandidates(projectRoot: string, patterns: readonly IScaffoldPatternWithSource[]): IScaffoldPatternEnumeration;
+/**
+ * Per-unit coverage over an enumeration, from THE settles
+ * (`scaffoldPatternLiveness`): `matchPaths globs` (examined = globs matching a
+ * file; an intended-empty glob is its own printed acceptance) and `patterns`
+ * (examined = patterns matching a file after `excludePaths`). Empty when there
+ * are no patterns.
+ */
+export declare function scaffoldPatternCoverage(patterns: readonly IScaffoldPatternWithSource[], enumeration: IScaffoldPatternEnumeration): {
+    coverage: IVerdictCoverage[];
+    deadUnits: string[];
+    liveness: readonly ISettledUnitLiveness[];
+};
 export interface IExtractedVariables {
     values: Record<string, string>;
     warnings: string[];

package/dist/scaffold-patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-patterns.d.ts","sourceRoot":"","sources":["../src/scaffold-patterns.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEpF,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0C/D;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAiDtC;AAID,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,EAC/C,UAAU,EAAE,qBAAqB,GAChC,SAAS,qBAAqB,EAAE,CA6DlC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBjD;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAST;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,qBAAqB,GAChC,mBAAmB,CAuCrB"}
+{"version":3,"file":"scaffold-patterns.d.ts","sourceRoot":"","sources":["../src/scaffold-patterns.ts"],"names":[],"mappings":"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"}