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

package/dist/feedback-ingestion.js

@@ -14,7 +14,7 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { importModuleViaLoader } from '@shrkcrft/core';
+import { importModuleViaLoader, RejectionCause } from '@shrkcrft/core';
 export const FEEDBACK_INGESTION_SCHEMA = 'sharkcraft.feedback-ingestion/v1';
 export var FeedbackBucket;
 (function (FeedbackBucket) {
@@ -141,7 +141,7 @@ const KEYWORD_RULES = [
         pattern: /\b(mcp|tool[s]?)\b/i,
         tags: ['mcp'],
         targetArea: 'mcp',
-        suggestedCommands: ['shrk commands list --filter mcp'],
+        suggestedCommands: ['shrk commands search mcp'],
     },
     {
         pattern: /\b(helper[s]?)\b/i,
@@ -305,41 +305,90 @@ export function ingestFeedbackFile(projectRoot, file, options = {}) {
  * Packs contribute via `feedbackRuleFiles[]` in their manifest.
  */
 export async function loadFeedbackRules(inspection) {
+    return (await loadFeedbackRulesWithIssues(inspection)).rules;
+}
+/**
+ * THE feedback-rule acceptance predicate (round 12, 12.1): a non-empty string
+ * `id` — `[]` means accepted. An id-less rule used to be dropped with no signal.
+ */
+export function feedbackRuleRejectionReasons(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return ['(entry): must be an object'];
+    const id = raw.id;
+    return typeof id === 'string' && id.length > 0 ? [] : ['id: must be a non-empty string'];
+}
+/**
+ * {@link loadFeedbackRules} WITH what did not take effect (round 12, 12.1): a
+ * rules file that failed to import (it was swallowed to `[]`), and every
+ * declared rule the loader refused — invalid, or a duplicate id.
+ */
+export async function loadFeedbackRulesWithIssues(inspection) {
     const out = [];
-    const seen = new Set();
-    const add = (r) => {
-        if (!r?.id || seen.has(r.id))
+    const entries = [];
+    const issues = [];
+    const rejected = [];
+    const seen = new Map();
+    const readInto = async (file, packageName) => {
+        const r = await importDefaultArray(file);
+        if (r.error !== undefined) {
+            const rel = nodePath.relative(inspection.projectRoot, file) || file;
+            issues.push({
+                severity: 'warning',
+                code: 'load-failed',
+                message: `${packageName ? `Pack ${packageName} (${rel})` : `Failed to load ${rel}`}: ${r.error}`,
+                source: file,
+                ...(packageName ? { packageName } : {}),
+            });
             return;
-        seen.add(r.id);
-        out.push(r);
+        }
+        r.items.forEach((item, index) => {
+            const reasons = feedbackRuleRejectionReasons(item);
+            if (reasons.length > 0) {
+                rejected.push({ file, index, exportName: 'default', reasons, cause: RejectionCause.Invalid });
+                return;
+            }
+            const rule = item;
+            const prev = seen.get(rule.id);
+            if (prev !== undefined) {
+                rejected.push({
+                    file,
+                    index,
+                    exportName: 'default',
+                    entryId: rule.id,
+                    reasons: [`id: "${rule.id}" is already declared in ${prev}`],
+                    cause: RejectionCause.DuplicateId,
+                });
+                return;
+            }
+            seen.set(rule.id, nodePath.relative(inspection.projectRoot, file) || file);
+            out.push(rule);
+            entries.push({ id: rule.id, file, ...(packageName ? { packageName } : {}) });
+        });
     };
     // Local file.
     if (inspection.sharkcraftDir) {
-        const local = nodePath.join(inspection.sharkcraftDir, 'feedback-rules.ts');
-        for (const r of await importDefaultArray(local))
-            add(r);
+        await readInto(nodePath.join(inspection.sharkcraftDir, 'feedback-rules.ts'));
     }
     // Pack contributions.
     const packs = inspection.packs?.validPacks ?? [];
     for (const pack of packs) {
         const c = (pack.manifest?.contributions ?? {});
         for (const rel of c.feedbackRuleFiles ?? []) {
-            const full = nodePath.resolve(pack.packageRoot, rel);
-            for (const r of await importDefaultArray(full))
-                add(r);
+            await readInto(nodePath.resolve(pack.packageRoot, rel), pack.packageName);
         }
     }
-    return out;
+    return { rules: out, entries, issues, rejected };
 }
+/** A rules file's default array; `error` (first line) when the import threw. A missing file is `[]`. */
 async function importDefaultArray(absPath) {
+    if (!existsSync(absPath))
+        return { items: [] };
     try {
-        if (!existsSync(absPath))
-            return [];
         const mod = (await importModuleViaLoader(absPath));
-        return Array.isArray(mod.default) ? mod.default : [];
+        return { items: Array.isArray(mod.default) ? mod.default : [] };
     }
-    catch {
-        return [];
+    catch (e) {
+        return { items: [], error: (e.message ?? String(e)).split('\n')[0].trim() };
     }
 }
 export function renderFeedbackBacklog(report) {

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,CAkF5B;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":"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"}

package/dist/fix-preview.js

@@ -237,13 +237,14 @@ export async function buildFixPreviewExtended(inspection, options = {}) {
     const kinds = new Set(options.kinds ?? sync.kinds);
     const suggestions = [...sync.suggestions];
     if (kinds.has(FixKind.SelfConfig)) {
-        const { buildSelfConfigDoctorReport } = await import("./self-config-doctor.js");
-        const report = await buildSelfConfigDoctorReport(inspection);
+        // THE doctor (v2) — the same checks `shrk self-config doctor` runs.
+        const { buildSelfConfigDoctorReportV2 } = await import("./self-config-doctor-v2.js");
+        const report = await buildSelfConfigDoctorReportV2(inspection);
         for (const f of report.findings) {
             const severity = f.severity === 'error' ? 'error' : f.severity === 'warning' ? 'warning' : 'info';
             suggestions.push({
                 kind: FixKind.SelfConfig,
-                targetId: f.referencingId ?? f.referencedId ?? f.code,
+                targetId: f.sourceId || f.targetId || f.code,
                 severity,
                 title: `Self-config: ${f.code}`,
                 description: f.message,
@@ -253,8 +254,11 @@ export async function buildFixPreviewExtended(inspection, options = {}) {
         }
     }
     if (kinds.has(FixKind.PackConflict) || kinds.has(FixKind.StalePackSignature)) {
-        const { buildPackContributionsInventory } = await import("./pack-contributions-inventory.js");
-        const inv = buildPackContributionsInventory(inspection);
+        // The async inventory: loader-backed extraction, so a conflict preview is
+        // built from the ids the registries really load (the sync regex scrape
+        // marks them unverified).
+        const { buildPackContributionsInventoryAsync } = await import("./pack-contributions-inventory.js");
+        const inv = await buildPackContributionsInventoryAsync(inspection);
         for (const c of inv.conflicts) {
             if (c.kind === 'stale-signature' && kinds.has(FixKind.StalePackSignature)) {
                 suggestions.push({

package/dist/framework-extractor-outcomes.d.ts

@@ -0,0 +1,27 @@
+import { type IRejectedEntry } from '@shrkcrft/core';
+import type { IContributionFileIssue } from './i-contribution-file-issue.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+/**
+ * Every pack `frameworkExtractorFiles` candidate, read through THE shared
+ * reading (`frameworkExtractorExports`) and shape predicate
+ * (`frameworkExtractorRejectionReasons`, both @shrkcrft/plugin-api) — the
+ * same two the runtime loader (`loadPackExtractors`, @shrkcrft/framework-
+ * scanners) applies. The inspector cannot import that loader (it sits above
+ * this layer via @shrkcrft/graph), so this is how framework extractors join
+ * THE rejection channel (round 12, 12.1).
+ *
+ * A candidate whose `framework` collides with a BUILT-IN extractor (nestjs,
+ * react, …) is refused only by the runtime loader, which alone knows the
+ * built-in registry; a collision between two contributed extractors is
+ * refused here too (the runtime keeps the first).
+ */
+export declare function loadFrameworkExtractorOutcomes(inspection: ISharkcraftInspection): Promise<{
+    readonly accepted: readonly {
+        readonly id: string;
+        readonly file: string;
+        readonly packageName: string;
+    }[];
+    readonly rejected: readonly IRejectedEntry[];
+    readonly issues: readonly IContributionFileIssue[];
+}>;
+//# sourceMappingURL=framework-extractor-outcomes.d.ts.map

package/dist/framework-extractor-outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-extractor-outcomes.d.ts","sourceRoot":"","sources":["../src/framework-extractor-outcomes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,8BAA8B,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAC/F,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3G,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD,CAAC,CA+DD"}

package/dist/framework-extractor-outcomes.js

@@ -0,0 +1,83 @@
+import { existsSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { importModuleViaLoader, RejectionCause } from '@shrkcrft/core';
+import { frameworkExtractorExports, frameworkExtractorRejectionReasons } from '@shrkcrft/plugin-api';
+/**
+ * Every pack `frameworkExtractorFiles` candidate, read through THE shared
+ * reading (`frameworkExtractorExports`) and shape predicate
+ * (`frameworkExtractorRejectionReasons`, both @shrkcrft/plugin-api) — the
+ * same two the runtime loader (`loadPackExtractors`, @shrkcrft/framework-
+ * scanners) applies. The inspector cannot import that loader (it sits above
+ * this layer via @shrkcrft/graph), so this is how framework extractors join
+ * THE rejection channel (round 12, 12.1).
+ *
+ * A candidate whose `framework` collides with a BUILT-IN extractor (nestjs,
+ * react, …) is refused only by the runtime loader, which alone knows the
+ * built-in registry; a collision between two contributed extractors is
+ * refused here too (the runtime keeps the first).
+ */
+export async function loadFrameworkExtractorOutcomes(inspection) {
+    const accepted = [];
+    const rejected = [];
+    const issues = [];
+    const seen = new Map();
+    for (const pack of inspection.packs.validPacks ?? []) {
+        const files = pack.manifest?.contributions
+            ?.frameworkExtractorFiles;
+        for (const rel of files ?? []) {
+            const file = nodePath.resolve(pack.packageRoot, rel);
+            if (!existsSync(file)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'missing-file',
+                    message: `Pack ${pack.packageName} declares ${rel} but the file is missing.`,
+                    source: file,
+                    packageName: pack.packageName,
+                });
+                continue;
+            }
+            let mod;
+            try {
+                mod = await importModuleViaLoader(file);
+            }
+            catch (e) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'load-failed',
+                    message: `Pack ${pack.packageName} (${rel}): ${(e.message ?? String(e)).split('\n')[0].trim()}`,
+                    source: file,
+                    packageName: pack.packageName,
+                });
+                continue;
+            }
+            for (const c of frameworkExtractorExports(mod)) {
+                const reasons = frameworkExtractorRejectionReasons(c.value);
+                const framework = c.value?.framework;
+                const at = { file, index: c.index, exportName: c.exportName };
+                if (reasons.length > 0) {
+                    rejected.push({
+                        ...at,
+                        ...(typeof framework === 'string' ? { entryId: framework } : {}),
+                        reasons,
+                        cause: RejectionCause.Invalid,
+                    });
+                    continue;
+                }
+                const name = framework;
+                const prev = seen.get(name);
+                if (prev !== undefined) {
+                    rejected.push({
+                        ...at,
+                        entryId: name,
+                        reasons: [`framework: "${name}" is already registered by ${prev}`],
+                        cause: RejectionCause.DuplicateId,
+                    });
+                    continue;
+                }
+                seen.set(name, `${pack.packageName} (${rel})`);
+                accepted.push({ id: name, file, packageName: pack.packageName });
+            }
+        }
+    }
+    return { accepted, rejected, issues };
+}

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;AAGvE,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;AA+aD,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":"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"}

package/dist/fuzzy-impact.js

@@ -27,6 +27,8 @@ import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { QueryMatchKind, resolveQuery, } from "./query-resolver.js";
 import { HELPERS } from "./helper-registry.js";
+import { listConstructs } from "./construct-registry.js";
+import { listPlaybooks } from "./playbook-registry.js";
 export const FUZZY_IMPACT_RESOLUTION_SCHEMA = 'sharkcraft.fuzzy-impact-resolution/v1';
 export var FuzzyImpactSourceKind;
 (function (FuzzyImpactSourceKind) {
@@ -45,22 +47,11 @@ export var FuzzyImpactSourceKind;
     FuzzyImpactSourceKind["Unresolved"] = "unresolved";
 })(FuzzyImpactSourceKind || (FuzzyImpactSourceKind = {}));
 function listConstructsFrom(inspection) {
-    // 1) Pre-warmed sync cache.
-    const direct = inspection.constructs;
-    if (direct && direct.length > 0)
-        return direct;
-    // 2) Registry with list() — duck-typed.
-    const reg = inspection
-        .constructRegistry;
-    if (reg && typeof reg.list === 'function') {
-        try {
-            return reg.list();
-        }
-        catch {
-            return [];
-        }
-    }
-    return [];
+    // One source. The two structural casts that used to precede this
+    // (`inspection.constructs`, then `inspection.constructRegistry.list()`) read
+    // properties nothing assigns, so this function returned [] in production
+    // while tests that faked those properties passed.
+    return listConstructs(inspection);
 }
 function constructFor(inspection, id) {
     return listConstructsFrom(inspection).find((c) => c.id === id);
@@ -145,10 +136,10 @@ function knowledgeFileReferences(inspection, knowledgeId) {
     return out;
 }
 function playbookFiles(inspection, playbookId) {
-    const reg = inspection.playbookRegistry;
-    if (!reg || typeof reg.get !== 'function')
-        return [];
-    const playbook = reg.get(playbookId);
+    // `listPlaybooks` is the same source `shrk playbooks list` reads. The
+    // previous `inspection.playbookRegistry?.get()` cast pointed at a property
+    // nothing ever assigned, so every playbook expanded to zero files.
+    const playbook = listPlaybooks(inspection).find((p) => p.id === playbookId);
     if (!playbook)
         return [];
     const out = [];
@@ -388,7 +379,7 @@ function buildResolution(inspection, query, resolution, opts) {
             resolvedLabel: best.label,
             alternatives,
             shouldRunImpact: false,
-            followUpCommands: [`shrk commands get ${best.id}`, `shrk ${best.id} --help`],
+            followUpCommands: [`shrk help ${best.id}`, `shrk ${best.id} --help`],
             diagnostics: [
                 `"${best.id}" resolves to a CLI command, not a code construct. Use \`shrk impact <file>\` to analyse files this command would touch.`,
             ],

package/dist/healing-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"healing-plan.d.ts","sourceRoot":"","sources":["../src/healing-plan.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAoQD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAMzE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAcvE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAqB3E;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,YAAY,CAQd;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAsB7D;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAiBjE"}
+{"version":3,"file":"healing-plan.d.ts","sourceRoot":"","sources":["../src/healing-plan.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAmQD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAMzE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAcvE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAqB3E;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,YAAY,CAQd;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAsB7D;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAiBjE"}

package/dist/healing-plan.js

@@ -15,7 +15,7 @@ export var HealingInputKind;
     HealingInputKind["Report"] = "report";
     HealingInputKind["Command"] = "command";
 })(HealingInputKind || (HealingInputKind = {}));
-const GENERIC_NEXT = 'shrk diagnostics suggest "<paste error text here>"';
+const GENERIC_NEXT = 'shrk recommend --from-error <stderr-file>';
 function inferFromKeywords(text) {
     const causes = [];
     const recover = [];
@@ -58,8 +58,7 @@ function inferFromKeywords(text) {
     if (lower.includes('migration') && (lower.includes('readiness') || lower.includes('blocker'))) {
         causes.push('Migration readiness gate reported a blocker.');
         recover.push('Resolve each blocker before re-running the gate.');
-        cmds.push('shrk migration readiness --profile <id>');
-        cmds.push('shrk migration profiles');
+        cmds.push('shrk migrate plan <id>');
         docs.push('docs/migration-readiness.md');
     }
     // Unknown command.
@@ -202,7 +201,7 @@ function buildPlan(ctx) {
     const safeRecoverySteps = [
         'Re-read the failing command output carefully (do not skip).',
         'Reproduce the failure locally before changing code.',
-        'If unsure, run `shrk doctor` and `shrk diagnostics suggest`.',
+        'If unsure, run `shrk doctor` and `shrk recommend --from-error <stderr-file>`.',
     ];
     for (const r of inferred.recover)
         safeRecoverySteps.push(r);

package/dist/helper-catalog.d.ts

@@ -0,0 +1,25 @@
+import { type IRejectedEntry } from '@shrkcrft/core';
+import type { IHelperView } from './helper-view.js';
+import { type IPackHelperDoctorIssue } from './pack-helper-registry.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export interface IHelperCatalog {
+    /** Every helper, deduped by id: built-ins first, then local, then pack (loader order). */
+    readonly entries: readonly IHelperView[];
+    /** load-failed / missing-file / invalid-helper / duplicate-id / helper-warning issues. */
+    readonly issues: readonly IPackHelperDoctorIssue[];
+    /** Every helper FILE considered (local `helpers.ts` + pack `helperFiles[]`) and whether it loaded. */
+    readonly files: readonly {
+        readonly file: string;
+        readonly status: 'loaded' | 'failed' | 'missing';
+    }[];
+    /**
+     * Every declared helper that did not make the catalog (round 12, 12.1): the
+     * loader's refusals plus a contributed helper shadowed by a built-in id.
+     */
+    readonly rejected: readonly IRejectedEntry[];
+}
+/** Build the catalog. One pack-helper load per call (it returns entries AND issues). */
+export declare function listAllHelpers(inspection: ISharkcraftInspection): Promise<IHelperCatalog>;
+/** One helper by id, from the same catalog `helper list` prints. */
+export declare function findHelper(inspection: ISharkcraftInspection, id: string): Promise<IHelperView | null>;
+//# sourceMappingURL=helper-catalog.d.ts.map

package/dist/helper-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-catalog.d.ts","sourceRoot":"","sources":["../src/helper-catalog.ts"],"names":[],"mappings":"AAWA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,sGAAsG;IACtG,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACvG;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAED,wFAAwF;AACxF,wBAAsB,cAAc,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsE/F;AAED,oEAAoE;AACpE,wBAAsB,UAAU,CAC9B,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}

package/dist/helper-catalog.js

@@ -0,0 +1,91 @@
+/**
+ * THE helper catalog — built-in helpers ∪ pack/local-contributed helpers.
+ *
+ * `helper list|get|plan` used to read only the built-in `HELPERS` (which ships
+ * empty), while the id resolver, universal search and the MCP pack-helper tools
+ * read the pack loader — two authorities answering "which helpers exist", so
+ * the self-config doctor saw a helper that `helper get` called unknown. Every
+ * helper surface now reads this one catalog; `warmReferenceRegistries` derives
+ * the resolver's `helper` ids from it, so list ≡ resolve by construction.
+ */
+import * as nodePath from 'node:path';
+import { RejectionCause } from '@shrkcrft/core';
+import { HELPERS } from "./helper-registry.js";
+import { loadPackHelpers } from "./pack-helper-registry.js";
+/** Build the catalog. One pack-helper load per call (it returns entries AND issues). */
+export async function listAllHelpers(inspection) {
+    const entries = [];
+    const issues = [];
+    const seen = new Set();
+    for (const h of HELPERS) {
+        seen.add(h.id);
+        entries.push({
+            id: h.id,
+            title: h.id,
+            description: h.description,
+            source: 'builtin',
+            destructive: h.destructive,
+            requiresHumanReview: h.requiresHumanReview,
+            requiresProfile: h.requiresProfile === true,
+            outputKind: 'plan',
+            variables: h.variables.map((v) => ({ name: v.name, required: v.required, description: v.description })),
+            operations: [],
+            manualChecklist: [],
+            tags: [],
+        });
+    }
+    const loaded = await loadPackHelpers(inspection);
+    issues.push(...loaded.issues);
+    const rejected = [...loaded.rejected];
+    for (const e of loaded.entries) {
+        const h = e.helper;
+        if (seen.has(h.id)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate-id',
+                message: `Helper "${h.id}" from ${e.sourceFile} duplicates a built-in helper — the built-in wins.`,
+                helperId: h.id,
+                source: e.sourceFile,
+            });
+            const packRoot = e.packageName
+                ? inspection.packs.validPacks.find((p) => p.packageName === e.packageName)?.packageRoot
+                : undefined;
+            rejected.push({
+                file: nodePath.resolve(packRoot ?? inspection.projectRoot, e.sourceFile),
+                index: -1,
+                entryId: h.id,
+                reasons: [`id: "${h.id}" is a built-in helper — the built-in wins`],
+                cause: RejectionCause.DuplicateId,
+            });
+            continue;
+        }
+        seen.add(h.id);
+        entries.push({
+            id: h.id,
+            title: h.title,
+            description: h.description,
+            source: e.source,
+            ...(e.packageName ? { packageName: e.packageName } : {}),
+            sourceFile: e.sourceFile,
+            destructive: h.safety.destructivePotential === true,
+            requiresHumanReview: h.safety.requiresHumanReview === true,
+            requiresProfile: h.safety.requiresProfile === true,
+            outputKind: h.safety.outputKind,
+            variables: (h.variables ?? []).map((v) => ({
+                name: v.name,
+                required: v.required,
+                description: v.description,
+                ...(v.defaultValue !== undefined ? { defaultValue: v.defaultValue } : {}),
+            })),
+            operations: h.operations ?? [],
+            manualChecklist: h.manualChecklist ?? [],
+            tags: h.tags ?? [],
+        });
+    }
+    return { entries, issues, files: loaded.files, rejected };
+}
+/** One helper by id, from the same catalog `helper list` prints. */
+export async function findHelper(inspection, id) {
+    const catalog = await listAllHelpers(inspection);
+    return catalog.entries.find((h) => h.id === id) ?? null;
+}

package/dist/helper-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper-registry.d.ts","sourceRoot":"","sources":["../src/helper-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAED,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAqB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAItE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAM9D"}
+{"version":3,"file":"helper-registry.d.ts","sourceRoot":"","sources":["../src/helper-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAED,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAqB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAItE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoB9D"}

package/dist/helper-registry.js

@@ -23,6 +23,22 @@ export function renderHelperPlanText(plan) {
     const lines = [];
     lines.push(`Helper plan: ${String(plan.helperId)}`);
     lines.push(`Ops: ${plan.ops.length}`);
+    for (const op of plan.ops) {
+        const where = op.anchor ? ` (anchor ${JSON.stringify(op.anchor)})` : op.fromPattern ? ` (find ${JSON.stringify(op.fromPattern)})` : '';
+        lines.push(`  • ${op.kind} ${op.targetPath}${where}`);
+        if (op.snippet !== undefined) {
+            for (const l of (op.snippet.length > 0 ? op.snippet : '(empty — removes the match)').split('\n')) {
+                lines.push(`      ${l}`);
+            }
+        }
+    }
+    if (plan.manualSteps.length > 0) {
+        lines.push(`Manual steps: ${plan.manualSteps.length}`);
+        for (const s of plan.manualSteps)
+            lines.push(`  • ${s.description}`);
+    }
     lines.push(`Conflicts: ${plan.conflicts.length}`);
-    return lines.join('\n');
+    for (const c of plan.conflicts)
+        lines.push(`  ! ${c}`);
+    return lines.join('\n') + '\n';
 }

package/dist/helper-view.d.ts

@@ -0,0 +1,33 @@
+import type { IPackHelperOperationInput } from '@shrkcrft/plugin-api';
+/**
+ * One helper as every helper surface shows it — built-in (`HELPERS`) and
+ * pack/local-contributed (`helperFiles[]`) alike. `helper list|get|plan|doctor`
+ * and the MCP helper tools all read this one shape from `listAllHelpers`, so
+ * "which helpers exist" has one answer.
+ */
+export interface IHelperView {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    /** Where the helper came from. */
+    readonly source: 'builtin' | 'local' | 'pack' | 'fixture';
+    readonly packageName?: string;
+    /** Pack-relative (pack) or project-relative (local) file the helper was loaded from. */
+    readonly sourceFile?: string;
+    /** From `safety.destructivePotential` (pack) / `destructive` (builtin). */
+    readonly destructive: boolean;
+    readonly requiresHumanReview: boolean;
+    readonly requiresProfile: boolean;
+    readonly outputKind: 'preview' | 'plan' | 'checklist';
+    readonly variables: readonly {
+        readonly name: string;
+        readonly required: boolean;
+        readonly description: string;
+        readonly defaultValue?: string;
+    }[];
+    /** Declarative operations (pack helpers); empty for builtins. */
+    readonly operations: readonly IPackHelperOperationInput[];
+    readonly manualChecklist: readonly string[];
+    readonly tags: readonly string[];
+}
+//# sourceMappingURL=helper-view.d.ts.map

package/dist/helper-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-view.d.ts","sourceRoot":"","sources":["../src/helper-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,EAAE,CAAC;IACJ,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC"}

package/dist/helper-view.js

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

package/dist/i-asset-doctor-flags.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The flags an asset doctor's proposal reads (round 13) — `registrations
+ * doctor`, `scaffolds doctor`, `search tuning doctor`, `self-config
+ * doctor|report` and their MCP twins (which pass both `false`).
+ */
+export interface IAssetDoctorFlags {
+    /**
+     * `--strict`: a warning issue fails (1). It never promotes a went-live
+     * `expectEmpty` marker — only `check boundaries`, where `--strict` is already
+     * the warning promoter for selector units, does that.
+     */
+    readonly strict: boolean;
+    /** `--fail-on-dead-units`: a dead selector unit, or a stale LOCAL `expectEmpty` marker, fails (1). */
+    readonly failOnDeadUnits: boolean;
+}
+//# sourceMappingURL=i-asset-doctor-flags.d.ts.map

package/dist/i-asset-doctor-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-asset-doctor-flags.d.ts","sourceRoot":"","sources":["../src/i-asset-doctor-flags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,sGAAsG;IACtG,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC"}

package/dist/i-asset-doctor-flags.js

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

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

@@ -0,0 +1,22 @@
+import type { CommandResolutionStatus } from './command-resolution-status.js';
+/**
+ * The answer to "does this command string resolve?" — produced by the CLI's
+ * command-string resolver and read by every inspector consumer through
+ * `resolveCommandReference`.
+ */
+export interface ICommandResolution {
+    readonly status: CommandResolutionStatus;
+    /**
+     * Nearest real alternatives (full command strings, e.g. `shrk check wiring`
+     * or `bun run test`), best first. Present on the unknown-* statuses when
+     * something is close enough to suggest.
+     */
+    readonly closest?: readonly string[];
+    /** The proven shrk command path (`check wiring`), when a verb chain matched. */
+    readonly matched?: string;
+    /** The `&&` / `;` / `|` segment that decided the status, for multi-command strings. */
+    readonly segment?: string;
+    /** One-line human explanation of the status. */
+    readonly reason?: string;
+}
+//# sourceMappingURL=i-command-resolution.d.ts.map