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

package/dist/file-languages.js

@@ -0,0 +1,91 @@
+/**
+ * THE per-file extension → language authority (round 15, 15.1).
+ *
+ * Promoted from `shrk stats` (`repository-stats.ts`, where it was
+ * module-private), because a convention's `appliesTo.languages` filter needs a
+ * per-file language and the tree had four unrelated maps with four different
+ * vocabularies. This is the widest one and the vocabulary `shrk stats` prints
+ * (`typescript`, `javascript`, `python`, …), so an author can read the ids
+ * they may write off `shrk stats`. `shrk stats`, `conventionApplicability` and
+ * the self-config doctor's language-id check read this table and nothing else.
+ *
+ * (The polyglot `LanguageId` enum, `languages/`, is a different, workspace-level
+ * question — which toolchains a repo runs — and keeps its own seven ids.)
+ */
+import * as nodePath from 'node:path';
+import { CommentSyntax } from "./comment-syntax.js";
+export const FILE_LANGUAGES = Object.freeze([
+    { id: 'typescript', extensions: ['.ts', '.tsx', '.mts', '.cts'], comment: CommentSyntax.CFamily },
+    { id: 'javascript', extensions: ['.js', '.jsx', '.mjs', '.cjs'], comment: CommentSyntax.CFamily },
+    { id: 'java', extensions: ['.java'], comment: CommentSyntax.CFamily },
+    { id: 'kotlin', extensions: ['.kt', '.kts'], comment: CommentSyntax.CFamily },
+    { id: 'scala', extensions: ['.scala'], comment: CommentSyntax.CFamily },
+    { id: 'groovy', extensions: ['.groovy'], comment: CommentSyntax.CFamily },
+    { id: 'csharp', extensions: ['.cs'], comment: CommentSyntax.CFamily },
+    { id: 'cpp', extensions: ['.cpp', '.cc', '.cxx', '.hpp', '.hh', '.hxx'], comment: CommentSyntax.CFamily },
+    { id: 'c', extensions: ['.c', '.h'], comment: CommentSyntax.CFamily },
+    { id: 'go', extensions: ['.go'], comment: CommentSyntax.CFamily },
+    { id: 'rust', extensions: ['.rs'], comment: CommentSyntax.CFamily },
+    { id: 'swift', extensions: ['.swift'], comment: CommentSyntax.CFamily },
+    { id: 'php', extensions: ['.php'], comment: CommentSyntax.CFamily },
+    { id: 'dart', extensions: ['.dart'], comment: CommentSyntax.CFamily },
+    { id: 'python', extensions: ['.py', '.pyi'], comment: CommentSyntax.Hash },
+    { id: 'ruby', extensions: ['.rb'], comment: CommentSyntax.Hash },
+    { id: 'shell', extensions: ['.sh', '.bash', '.zsh', '.fish'], comment: CommentSyntax.Hash },
+    { id: 'perl', extensions: ['.pl', '.pm'], comment: CommentSyntax.Hash },
+    { id: 'r', extensions: ['.r', '.R'], comment: CommentSyntax.Hash },
+    { id: 'yaml', extensions: ['.yaml', '.yml'], comment: CommentSyntax.Hash },
+    { id: 'toml', extensions: ['.toml'], comment: CommentSyntax.Hash },
+    { id: 'ini', extensions: ['.ini', '.cfg', '.conf'], comment: CommentSyntax.Hash },
+    { id: 'dockerfile', extensions: ['.dockerfile'], comment: CommentSyntax.Hash },
+    { id: 'makefile', extensions: ['.mk'], comment: CommentSyntax.Hash },
+    { id: 'html', extensions: ['.html', '.htm'], comment: CommentSyntax.Html },
+    { id: 'xml', extensions: ['.xml', '.xsd', '.xsl'], comment: CommentSyntax.Html },
+    { id: 'vue', extensions: ['.vue'], comment: CommentSyntax.Html },
+    { id: 'svelte', extensions: ['.svelte'], comment: CommentSyntax.Html },
+    { id: 'sql', extensions: ['.sql'], comment: CommentSyntax.Sql },
+    { id: 'css', extensions: ['.css', '.scss', '.sass', '.less'], comment: CommentSyntax.CFamily },
+    { id: 'lua', extensions: ['.lua'], comment: CommentSyntax.Lua },
+    { id: 'elixir', extensions: ['.ex', '.exs'], comment: CommentSyntax.Hash },
+    { id: 'clojure', extensions: ['.clj', '.cljs'], comment: CommentSyntax.Lisp },
+    { id: 'lisp', extensions: ['.lisp', '.lsp', '.el'], comment: CommentSyntax.Lisp },
+    { id: 'json', extensions: ['.json', '.jsonc'], comment: CommentSyntax.None },
+    { id: 'markdown', extensions: ['.md', '.mdx'], comment: CommentSyntax.None },
+    { id: 'text', extensions: ['.txt'], comment: CommentSyntax.None },
+]);
+const EXTENSION_INDEX = (() => {
+    const m = new Map();
+    for (const def of FILE_LANGUAGES) {
+        for (const ext of def.extensions)
+            m.set(ext.toLowerCase(), def);
+    }
+    return m;
+})();
+/** Extension-less files named for their language (case-insensitive basename). */
+const BASENAME_OVERRIDES = new Map([
+    ['dockerfile', 'dockerfile'],
+    ['makefile', 'makefile'],
+    ['gnumakefile', 'makefile'],
+]);
+/** The language of `path` (absolute or project-relative): a basename override, else its extension; `null` when unknown. */
+export function fileLanguageOf(path) {
+    const override = BASENAME_OVERRIDES.get(nodePath.basename(path).toLowerCase());
+    if (override) {
+        const def = FILE_LANGUAGES.find((d) => d.id === override);
+        if (def)
+            return def;
+    }
+    const ext = nodePath.extname(path).toLowerCase();
+    if (!ext)
+        return null;
+    return EXTENSION_INDEX.get(ext) ?? null;
+}
+/** The language whose table row lists `extension` (`.ts` or `ts`), or `null`. */
+export function fileLanguageForExtension(extension) {
+    const ext = (extension.startsWith('.') ? extension : `.${extension}`).toLowerCase();
+    return EXTENSION_INDEX.get(ext) ?? null;
+}
+/** Every language id of the table, in table order — THE vocabulary `appliesTo.languages` may name. */
+export function fileLanguageIds() {
+    return FILE_LANGUAGES.map((d) => d.id);
+}

package/dist/fix-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fix-preview.d.ts","sourceRoot":"","sources":["../src/fix-preview.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,oBAAY,OAAO;IACjB,WAAW,iBAAiB;IAC5B,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,UAAU,gBAAgB;IAC1B,YAAY,kBAAkB;IAC9B,kBAAkB,yBAAyB;IAC3C,kBAAkB,yBAAyB;IAC3C,0BAA0B,iCAAiC;IAC3D,wBAAwB,+BAA+B;IACvD,uBAAuB,8BAA8B;IACrD,wBAAwB,gCAAgC;IACxD,0BAA0B,kCAAkC;IAC5D,qBAAqB,4BAA4B;CAClD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClF,OAAO,EAAE,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAuCjC;AAoCD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAoFnB;AA4CD;;4CAE4C;AAC5C,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAsF5B;AAED,wBAAgB,YAAY,IAAI,SAAS;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAkBhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA+B1E"}
+{"version":3,"file":"fix-preview.d.ts","sourceRoot":"","sources":["../src/fix-preview.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,oBAAY,OAAO;IACjB,WAAW,iBAAiB;IAC5B,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,UAAU,gBAAgB;IAC1B,YAAY,kBAAkB;IAC9B,kBAAkB,yBAAyB;IAC3C,kBAAkB,yBAAyB;IAC3C,0BAA0B,iCAAiC;IAC3D,wBAAwB,+BAA+B;IACvD,uBAAuB,8BAA8B;IACrD,wBAAwB,gCAAgC;IACxD,0BAA0B,kCAAkC;IAC5D,qBAAqB,4BAA4B;CAClD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClF,OAAO,EAAE,SAAS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAuCjC;AA+GD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAyEnB;AA4CD;;4CAE4C;AAC5C,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAsF5B;AAED,wBAAgB,YAAY,IAAI,SAAS;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAkBhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA+B1E"}

package/dist/fix-preview.js

@@ -15,7 +15,11 @@
  * Read-only at the inspector level. Schema: sharkcraft.fix-preview/v1
  */
 import { diagnoseActionHints, } from "./action-hint-diagnostics.js";
+import { KnowledgeSourceFormat } from '@shrkcrft/knowledge';
 import { buildKnowledgeStaleReport, ReferenceCheckOutcome, } from "./knowledge-stale.js";
+import { knowledgeRenameCommand } from "./knowledge-rename-command.js";
+import { KnowledgeRenameVerb } from "./knowledge-rename-verb.js";
+import { ReferenceFailure } from "./reference-failure.js";
 import { buildTemplateDriftReport } from "./template-drift.js";
 export const FIX_PREVIEW_SCHEMA = 'sharkcraft.fix-preview/v1';
 export var FixKind;
@@ -107,6 +111,73 @@ function buildActionHintFix(issue) {
 function slug(s) {
     return s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
 }
+/**
+ * One non-ok stale-check row as a fix suggestion (round 15 follow-up, F4).
+ *
+ * Every command it suggests is one the dispatcher RUNS: `knowledge
+ * rename-file` / `rename-symbol` are read-only previews already (they take no
+ * `--dry-run` — the suggestion used to name it, and the dispatcher refused it),
+ * and `fix preview` takes the entry as `--target <id>` (it takes no positional:
+ * `--knowledge-stale <id>` read the id as the flag's value and previewed every
+ * kind). An entry `shrk fix --knowledge-stale --apply` cannot edit — declared
+ * in Markdown (a `references:` frontmatter list), or contributed by a pack —
+ * says so in its description and gets no `--apply` command.
+ */
+function buildKnowledgeStaleFix(c, declaredBy) {
+    const ref = c.reference;
+    // A `command:` reference names its target in `command` (it read `→ <unknown>`).
+    const target = ref.id ?? ref.path ?? ref.symbol ?? ref.command ?? '<unknown>';
+    const failing = c.outcome === ReferenceCheckOutcome.Stale || c.outcome === ReferenceCheckOutcome.Missing;
+    const notAutoFixable = declaredBy?.pack !== undefined
+        ? `not auto-fixable here: pack ${declaredBy.pack} contributes ${c.entryId} (${declaredBy.source}) — fix it upstream in the pack`
+        : declaredBy?.sourceFormat === KnowledgeSourceFormat.Markdown
+            ? `not auto-fixable: ${c.entryId} is declared in Markdown (${declaredBy.source}) — \`shrk fix --knowledge-stale --apply\` edits TypeScript entries only; edit its references: frontmatter list by hand`
+            : undefined;
+    const replaceWith = c.replaceWith;
+    const hasRenameTarget = replaceWith !== undefined &&
+        (replaceWith.path !== undefined || replaceWith.id !== undefined || replaceWith.symbol !== undefined);
+    // A rename answers a MOVED target only — a path that is gone (`rename-file`
+    // matches any reference by its `path`) or a symbol no longer declared in its
+    // file (`rename-symbol`), never a content / count mismatch on a file that is
+    // still there. And only for an entry `--apply` can edit: a rename plan lands
+    // through `shrk fix --knowledge-stale --apply`, which refuses a Markdown or a
+    // pack entry — a pack's reference is fixed in the pack, never renamed onto
+    // this tree (the stale engine offers it no rename candidate either).
+    const renameCommand = !failing || notAutoFixable !== undefined
+        ? undefined
+        : c.failure === ReferenceFailure.PathMissing && typeof ref.path === 'string'
+            ? knowledgeRenameCommand(KnowledgeRenameVerb.RenameFile, ref.path, replaceWith?.path)
+            : c.failure === ReferenceFailure.AnchorMissing && ref.kind === 'symbol' && typeof ref.symbol === 'string'
+                ? knowledgeRenameCommand(KnowledgeRenameVerb.RenameSymbol, ref.symbol, replaceWith?.symbol)
+                : undefined;
+    const applyCommand = failing && notAutoFixable === undefined
+        ? hasRenameTarget
+            ? 'shrk fix --knowledge-stale --apply'
+            : `shrk fix --knowledge-stale --apply ${c.outcome === ReferenceCheckOutcome.Missing ? '--drop-missing' : '--drop-stale'}`
+        : undefined;
+    const what = failing
+        ? 'Stale reference'
+        : c.outcome === ReferenceCheckOutcome.Invalid
+            ? 'Malformed reference'
+            : 'Unverifiable reference';
+    return {
+        kind: FixKind.KnowledgeStale,
+        targetId: c.entryId,
+        severity: c.outcome === ReferenceCheckOutcome.Missing ? 'error' : 'warning',
+        title: `${what} ${c.entryId} → ${target}`,
+        description: notAutoFixable !== undefined ? `${c.message} — ${notAutoFixable}.` : c.message,
+        nextCommands: [
+            `shrk knowledge references ${c.entryId}`,
+            ...(renameCommand !== undefined ? [renameCommand] : []),
+            `shrk fix preview --knowledge-stale --target ${c.entryId}`,
+            ...(applyCommand !== undefined ? [applyCommand] : []),
+        ],
+        ...(c.suggestion ? { draftBody: `// suggestion: ${c.suggestion}` } : {}),
+        ...(notAutoFixable !== undefined ? { humanReviewRequired: true, reason: notAutoFixable } : {}),
+        previewFileName: `knowledge-stale-${slug(c.entryId)}.preview.md`,
+        stubbed: true,
+    };
+}
 export function buildFixPreview(inspection, options = {}) {
     const defaultKinds = [
         FixKind.ActionHints,
@@ -126,25 +197,13 @@ export function buildFixPreview(inspection, options = {}) {
     }
     if (kinds.has(FixKind.KnowledgeStale)) {
         const stale = buildKnowledgeStaleReport(inspection);
+        // The entry's declaring file, format and pack — what decides whether
+        // `--apply` can edit it (round 15 follow-up, F4).
+        const declared = new Map(stale.entryVerdicts.map((v) => [v.entryId, v]));
         for (const c of stale.referenceChecks) {
             if (c.outcome === ReferenceCheckOutcome.Ok)
                 continue;
-            const target = c.reference.id ?? c.reference.path ?? c.reference.symbol ?? '<unknown>';
-            suggestions.push({
-                kind: FixKind.KnowledgeStale,
-                targetId: c.entryId,
-                severity: c.outcome === ReferenceCheckOutcome.Missing ? 'error' : 'warning',
-                title: `Stale reference ${c.entryId} → ${target}`,
-                description: c.message,
-                nextCommands: [
-                    `shrk knowledge references ${c.entryId}`,
-                    `shrk knowledge rename-symbol <old> <new> --dry-run`,
-                    `shrk fix preview --knowledge-stale ${c.entryId}`,
-                ],
-                ...(c.suggestion ? { draftBody: `// suggestion: ${c.suggestion}` } : {}),
-                previewFileName: `knowledge-stale-${slug(c.entryId)}.preview.md`,
-                stubbed: true,
-            });
+            suggestions.push(buildKnowledgeStaleFix(c, declared.get(c.entryId)));
         }
     }
     if (kinds.has(FixKind.TemplateDrift)) {
@@ -162,7 +221,9 @@ export function buildFixPreview(inspection, options = {}) {
                     nextCommands: [
                         `shrk templates get ${e.templateId}`,
                         `shrk paths list`,
-                        `shrk fix preview --template-drift ${e.templateId} --write-preview`,
+                        // `--target <id>`: `fix` takes no positional, so `--template-drift <id>`
+                        // read the id as the flag's value and previewed every kind (F4).
+                        `shrk fix preview --template-drift --target ${e.templateId} --write-preview`,
                     ],
                     ...(i.suggestedFix ? { draftBody: `// suggestion: ${i.suggestedFix}` } : {}),
                     previewFileName: `template-drift-${slug(e.templateId)}-${i.code}.preview.md`,

package/dist/fuzzy-impact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fuzzy-impact.d.ts","sourceRoot":"","sources":["../src/fuzzy-impact.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,cAAc,EAEd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAKvE,eAAO,MAAM,8BAA8B,0CAA0C,CAAC;AAEtF,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,OAAO,aAAa;IACpB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,8BAA8B,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kCAAkC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAqaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,CA+BxB"}
+{"version":3,"file":"fuzzy-impact.d.ts","sourceRoot":"","sources":["../src/fuzzy-impact.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,cAAc,EAEd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAKvE,eAAO,MAAM,8BAA8B,0CAA0C,CAAC;AAEtF,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,OAAO,aAAa;IACpB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,8BAA8B,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kCAAkC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAqaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,CA+BxB"}

package/dist/fuzzy-impact.js

@@ -25,6 +25,7 @@
  */
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
+import { knowledgeReferences } from '@shrkcrft/knowledge';
 import { QueryMatchKind, resolveQuery, } from "./query-resolver.js";
 import { HELPERS } from "./helper-registry.js";
 import { listConstructs } from "./construct-registry.js";
@@ -129,7 +130,7 @@ function knowledgeFileReferences(inspection, knowledgeId) {
     if (!k)
         return [];
     const out = [];
-    for (const ref of k.references ?? []) {
+    for (const ref of knowledgeReferences(k)) {
         if (ref.kind === 'file' && ref.path)
             out.push(ref.path);
     }

package/dist/git-helpers.d.ts

@@ -20,6 +20,26 @@ export interface IGitStatusSummary {
 export declare function isGitRepo(cwd: string): boolean;
 export declare function getGitRoot(cwd: string): string | null;
 export declare function getGitBranch(cwd: string): string | null;
+/**
+ * The files a change touched, RELATIVE TO THE PROJECT ROOT `cwd` belongs to
+ * (`changedScopeRoot` — the root every caller resolves them against), sorted.
+ * git names a path relative to the work-tree TOP LEVEL. That is always true of
+ * `status --porcelain`, and of `diff` too once `diff.relative` is forced off,
+ * so a user's config cannot change the spelling. For a project nested in a
+ * larger repository (prefix `app/`), the top-level spelling `app/src/a.ts`
+ * resolved to `<root>/app/src/a.ts`, a file that does not exist. A
+ * changed-scope check (`conventions check --staged`, `--since`, and every
+ * other changed-scope reader) then checked nothing (round 15 lane B, B4). Every
+ * path is now mapped to root-relative. A change outside the project's subtree
+ * (a sibling package of the larger repository) is not in scope.
+ *
+ * Root-relative, never `cwd`-relative (lane B review): a command run from a
+ * subdirectory (`--cwd src`, a shell in `src/`) inspects the project root
+ * `detectProjectRoot` walks up to, so a `cwd`-relative `a.ts` resolved to
+ * `<root>/a.ts` — `validate-change`, `ownership affected`, `brief`, `tests
+ * impact` and `finish` read the wrong files where the top-level spelling had
+ * read the right ones.
+ */
 export declare function getChangedFiles(cwd: string, opts?: IGitChangedOptions): string[];
 /**
  * True when `ref` resolves to a commit in `cwd`'s repo. Lets a caller tell a
@@ -30,10 +50,15 @@ export declare function getChangedFiles(cwd: string, opts?: IGitChangedOptions):
  */
 export declare function refExists(cwd: string, ref: string): boolean;
 /**
- * The content of `relPath` at `ref` (e.g. `git show HEAD:src/x.ts`), or `null`
- * when the path did not exist at that ref (a newly-added file) or git failed.
- * `relPath` is repo-root-relative. Used to diff a file's PAST state against the
- * working tree without a checkout — e.g. to see what a now-edited file used to
+ * The content of `relPath` at `ref` (e.g. `git show HEAD:./src/x.ts`), or
+ * `null` when the path did not exist at that ref (a newly-added file) or git
+ * failed. `relPath` is relative to the project root `cwd` belongs to — the
+ * spelling `getChangedFiles` returns: git runs from that root and the `./` form
+ * resolves the path against it, so a project nested in a larger repository
+ * reads its own file (round 15 lane B, B4; the bare `<ref>:<path>` form is
+ * top-level-relative), and so does a caller whose `cwd` is a subdirectory
+ * (lane B review). Used to diff a file's PAST state against the working tree
+ * without a checkout — e.g. to see what a now-edited file used to
  * provide/register.
  */
 export declare function gitShowFile(cwd: string, ref: string, relPath: string): string | null;

package/dist/git-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-helpers.d.ts","sourceRoot":"","sources":["../src/git-helpers.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAqBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,EAAE,CAwBpF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyC/D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CA6BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}
+{"version":3,"file":"git-helpers.d.ts","sourceRoot":"","sources":["../src/git-helpers.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAqBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AA4BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,EAAE,CA+BpF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyC/D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CA6BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}

package/dist/git-helpers.js

@@ -1,6 +1,7 @@
 import { spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
+import { detectProjectRoot } from '@shrkcrft/workspace';
 // 512 MB — the same generous ceiling @shrkcrft/shared's runGitLines uses. A
 // `diff`/`log --name-only` listing on a large changeset overflows Node's 1 MB
 // default `maxBuffer` and dies with ENOBUFS; a name listing never approaches
@@ -38,22 +39,75 @@ export function getGitBranch(cwd) {
     const out = r.stdout.trim();
     return out.length > 0 ? out : null;
 }
+/**
+ * Where `dir` sits inside its git work tree (`git rev-parse --show-prefix`):
+ * `''` at the top level, `app/` for a project nested in a larger repository.
+ * `''` too when git cannot tell (the paths are then used as git printed them).
+ */
+function gitPrefix(dir) {
+    const r = runGit(dir, ['rev-parse', '--show-prefix']);
+    return r.ok ? r.stdout.trim() : '';
+}
+/** A top-level-relative git path as a root-relative one, or `undefined` outside the root's subtree. */
+function underPrefix(prefix, gitPath) {
+    if (prefix === '')
+        return gitPath;
+    return gitPath.startsWith(prefix) && gitPath.length > prefix.length ? gitPath.slice(prefix.length) : undefined;
+}
+/**
+ * The project root `cwd` belongs to — THE root `inspectSharkcraft` reads
+ * (`detectProjectRoot`: the nearest ancestor holding a root marker, `.git`
+ * included, so it never climbs out of the work tree). Every changed-scope path
+ * is spelled relative to it, from whichever subdirectory a command runs.
+ */
+function changedScopeRoot(cwd) {
+    return detectProjectRoot(cwd).root;
+}
+/**
+ * The files a change touched, RELATIVE TO THE PROJECT ROOT `cwd` belongs to
+ * (`changedScopeRoot` — the root every caller resolves them against), sorted.
+ * git names a path relative to the work-tree TOP LEVEL. That is always true of
+ * `status --porcelain`, and of `diff` too once `diff.relative` is forced off,
+ * so a user's config cannot change the spelling. For a project nested in a
+ * larger repository (prefix `app/`), the top-level spelling `app/src/a.ts`
+ * resolved to `<root>/app/src/a.ts`, a file that does not exist. A
+ * changed-scope check (`conventions check --staged`, `--since`, and every
+ * other changed-scope reader) then checked nothing (round 15 lane B, B4). Every
+ * path is now mapped to root-relative. A change outside the project's subtree
+ * (a sibling package of the larger repository) is not in scope.
+ *
+ * Root-relative, never `cwd`-relative (lane B review): a command run from a
+ * subdirectory (`--cwd src`, a shell in `src/`) inspects the project root
+ * `detectProjectRoot` walks up to, so a `cwd`-relative `a.ts` resolved to
+ * `<root>/a.ts` — `validate-change`, `ownership affected`, `brief`, `tests
+ * impact` and `finish` read the wrong files where the top-level spelling had
+ * read the right ones.
+ */
 export function getChangedFiles(cwd, opts = {}) {
     if (!isGitRepo(cwd))
         return [];
-    const args = ['diff', '--name-only'];
+    const root = changedScopeRoot(cwd);
+    const prefix = gitPrefix(root);
+    const args = ['-c', 'diff.relative=false', 'diff', '--name-only'];
     if (opts.staged)
         args.push('--cached');
     if (opts.since)
         args.push(opts.since);
-    const a = runGit(cwd, args);
-    const set = new Set(parseLines(a.stdout));
+    const a = runGit(root, args);
+    const set = new Set();
+    const add = (gitPath) => {
+        const rel = underPrefix(prefix, gitPath);
+        if (rel !== undefined)
+            set.add(rel);
+    };
+    for (const p of parseLines(a.stdout))
+        add(p);
     if (opts.includeWorktree && !opts.staged && !opts.since) {
         // Include untracked + working-tree changes via `git status --porcelain`.
         // `-uall` expands untracked directories to individual files (default
         // `--porcelain` collapses them to a single `dir/` entry, which undercounts);
         // `.gitignore` is still honored.
-        const s = runGit(cwd, ['status', '--porcelain', '-uall']);
+        const s = runGit(root, ['status', '--porcelain', '-uall']);
         if (s.ok) {
             for (const line of s.stdout.split('\n')) {
                 // Strip the two-char XY status + leading space, then take the new path
@@ -61,7 +115,7 @@ export function getChangedFiles(cwd, opts = {}) {
                 const raw = line.slice(3).trim();
                 const path = raw.includes(' -> ') ? raw.slice(raw.indexOf(' -> ') + 4).trim() : raw;
                 if (path)
-                    set.add(path);
+                    add(path);
             }
         }
     }
@@ -81,14 +135,19 @@ export function refExists(cwd, ref) {
     return r.ok && r.stdout.trim().length > 0;
 }
 /**
- * The content of `relPath` at `ref` (e.g. `git show HEAD:src/x.ts`), or `null`
- * when the path did not exist at that ref (a newly-added file) or git failed.
- * `relPath` is repo-root-relative. Used to diff a file's PAST state against the
- * working tree without a checkout — e.g. to see what a now-edited file used to
+ * The content of `relPath` at `ref` (e.g. `git show HEAD:./src/x.ts`), or
+ * `null` when the path did not exist at that ref (a newly-added file) or git
+ * failed. `relPath` is relative to the project root `cwd` belongs to — the
+ * spelling `getChangedFiles` returns: git runs from that root and the `./` form
+ * resolves the path against it, so a project nested in a larger repository
+ * reads its own file (round 15 lane B, B4; the bare `<ref>:<path>` form is
+ * top-level-relative), and so does a caller whose `cwd` is a subdirectory
+ * (lane B review). Used to diff a file's PAST state against the working tree
+ * without a checkout — e.g. to see what a now-edited file used to
  * provide/register.
  */
 export function gitShowFile(cwd, ref, relPath) {
-    const r = runGit(cwd, ['show', `${ref}:${relPath}`]);
+    const r = runGit(changedScopeRoot(cwd), ['show', `${ref}:./${relPath.replace(/^\.\//, '')}`]);
     return r.ok ? r.stdout : null;
 }
 export function getStatusSummary(cwd) {

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

@@ -1,4 +1,5 @@
 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
@@ -18,6 +19,13 @@ export interface IContributionFileValidation {
     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;
 }

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

@@ -1 +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,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,sGAAsG;IACtG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC"}
+{"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-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-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-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 {};

package/dist/i-reference-pack-origin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The pack that contributed an asset — the provenance a `root: pack`
+ * reference resolves against (round 15 follow-up, F7).
+ */
+export interface IReferencePackOrigin {
+    /** The pack's published package name. */
+    readonly packageName: string;
+    /** Absolute path of the pack's package directory, as pack discovery resolved it. */
+    readonly packageRoot: string;
+    /** {@link packageRoot} relative to the project root (`node_modules/@x/y`) — what rows print. */
+    readonly displayRoot: string;
+}
+//# sourceMappingURL=i-reference-pack-origin.d.ts.map

package/dist/i-reference-pack-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-reference-pack-origin.d.ts","sourceRoot":"","sources":["../src/i-reference-pack-origin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gGAAgG;IAChG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/i-reference-pack-origin.js

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