@shrkcrft/inspector 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/task-ranker.js

@@ -29,33 +29,8 @@ const VERB_HINTS = [
 // ── Domain hints (what *kind of thing* is being worked on) ──────────────
 // These boost rules/templates/pipelines whose own `appliesWhen` or `tags`
 // declare the same domain — much higher signal than verb hints alone for
-// "create a user profile *plugin*" vs "add pagination *capability*".
+// "create a *service*" vs "add a *utility*".
 const DOMAIN_HINTS = [
-    {
-        token: 'plugin',
-        appliesWhen: ['create-plugin', 'generate-plugin', 'plugin-dev', 'register-plugin'],
-        tags: ['plugin'],
-    },
-    {
-        token: 'defaults',
-        appliesWhen: ['register-defaults', 'create-defaults', 'plugin-defaults'],
-        tags: ['defaults'],
-    },
-    {
-        token: 'capability',
-        appliesWhen: ['create-capability', 'generate-capability'],
-        tags: ['capability'],
-    },
-    {
-        token: 'policy',
-        appliesWhen: ['create-policy', 'generate-policy'],
-        tags: ['policy'],
-    },
-    {
-        token: 'adapter',
-        appliesWhen: ['create-adapter', 'generate-adapter'],
-        tags: ['adapter'],
-    },
     {
         token: 'service',
         appliesWhen: ['generate-service'],
@@ -81,11 +56,6 @@ const DOMAIN_HINTS = [
         appliesWhen: ['generate-route'],
         tags: ['http', 'routes', 'api'],
     },
-    {
-        token: 'kernel',
-        appliesWhen: ['create-kernel-service'],
-        tags: ['kernel'],
-    },
 ];
 function tokenize(s) {
     return s

package/dist/task-routing-hint-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-routing-hint-registry.d.ts","sourceRoot":"","sources":["../src/task-routing-hint-registry.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,iCAAiC,6CAA6C,CAAC;AAE5F,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4BD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAA;CAAE,CAAC,CAoFxG;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAG3C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAGjD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA0C7C"}
+{"version":3,"file":"task-routing-hint-registry.d.ts","sourceRoot":"","sources":["../src/task-routing-hint-registry.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,iCAAiC,6CAA6C,CAAC;AAE5F,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4BD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAA;CAAE,CAAC,CAoFxG;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAG3C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAGjD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA0C7C"}

package/dist/task-routing-hint-registry.js

@@ -1,11 +1,3 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
 /**
  * Task routing hint registry. Pack- and local-contributed task
  * routing hints bias the recommender output toward project-specific
@@ -15,8 +7,8 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
  */
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { pathToFileURL } from 'node:url';
 import { validateTaskRoutingHint, } from '@shrkcrft/plugin-api';
+import { importModuleViaLoader } from '@shrkcrft/core';
 export const TASK_ROUTING_HINT_REGISTRY_SCHEMA = 'sharkcraft.task-routing-hint-registry/v1';
 export var TaskRoutingHintSource;
 (function (TaskRoutingHintSource) {
@@ -25,7 +17,7 @@ export var TaskRoutingHintSource;
     TaskRoutingHintSource["Fixture"] = "fixture";
 })(TaskRoutingHintSource || (TaskRoutingHintSource = {}));
 async function importDefault(file) {
-    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(file).href)));
+    const mod = (await importModuleViaLoader(file));
     if (Array.isArray(mod.default))
         return mod.default;
     if (mod.default && typeof mod.default === 'object')

package/dist/template-drift.d.ts

@@ -35,5 +35,12 @@ export interface ITemplateDriftCheckOptions {
     /** Sample variable values for templates with required vars (key→string). */
     sampleVars?: Readonly<Record<string, string>>;
 }
+/**
+ * A rendered sample path "matches" a path convention when it IS the
+ * convention's canonical target, or lives directly under it. The trailing
+ * slash guard stops `libs/nge/core` from spuriously matching
+ * `libs/nge/core-extra`.
+ */
+export declare function samplePathMatchesConvention(samplePath: string, conventionPath: string): boolean;
 export declare function buildTemplateDriftReport(inspection: ISharkcraftInspection, options?: ITemplateDriftCheckOptions): ITemplateDriftReport;
 //# sourceMappingURL=template-drift.d.ts.map

package/dist/template-drift.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-drift.d.ts","sourceRoot":"","sources":["../src/template-drift.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C;AAkSD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CA8DtB"}
+{"version":3,"file":"template-drift.d.ts","sourceRoot":"","sources":["../src/template-drift.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C;AAoFD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET;AAoND,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CA8DtB"}

package/dist/template-drift.js

@@ -99,6 +99,15 @@ function safeRender(template, values) {
     }
     return { paths, warnings, ops };
 }
+/**
+ * A rendered sample path "matches" a path convention when it IS the
+ * convention's canonical target, or lives directly under it. The trailing
+ * slash guard stops `libs/nge/core` from spuriously matching
+ * `libs/nge/core-extra`.
+ */
+export function samplePathMatchesConvention(samplePath, conventionPath) {
+    return samplePath === conventionPath || samplePath.startsWith(`${conventionPath}/`);
+}
 function checkPathConventions(inspection, paths) {
     const issues = [];
     // Path conventions are name patterns; we only flag a path that obviously
@@ -111,12 +120,11 @@ function checkPathConventions(inspection, paths) {
     for (const p of paths) {
         let matched = false;
         for (const c of conventions) {
-            const pattern = c.pattern;
-            if (!pattern)
-                continue;
-            // very lightweight substring check — these are heuristics.
-            const cleaned = pattern.replace(/\{.*?\}/g, '').replace(/[.*+?^${}()|[\]\\]/g, '');
-            if (cleaned.length > 4 && p.includes(cleaned)) {
+            // Path conventions carry their canonical path in `metadata.path`
+            // (IPathConvention), NOT a `pattern` field. A sample path matches a
+            // convention when it IS that target or lives under it.
+            const target = c.metadata?.path;
+            if (target && samplePathMatchesConvention(p, target)) {
                 matched = true;
                 break;
             }

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

@@ -1 +1 @@
-{"version":3,"file":"test-impact.d.ts","sourceRoot":"","sources":["../src/test-impact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,qEAAqE;IACrE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oCAAoC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,0DAA0D;IAC1D,eAAe,EAAE,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,gBAAgB,GACtB,WAAW,CAyEb;AAoDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD"}
+{"version":3,"file":"test-impact.d.ts","sourceRoot":"","sources":["../src/test-impact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,qEAAqE;IACrE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oCAAoC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,0DAA0D;IAC1D,eAAe,EAAE,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAoCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,gBAAgB,GACtB,WAAW,CAyEb;AAoDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/dist/test-impact.js

@@ -7,8 +7,11 @@ const TEST_PATTERNS = [
     (f) => f.replace(/^src\//, 'tests/').replace(/\.(ts|tsx|js|jsx)$/, '.test.$1'),
     (f) => f.replace(/\.([tj]s)$/, '.spec.$1'),
     (f) => f.replace(/\.([tj]s)$/, '.test.$1'),
-    (f) => f.replace(/\.tsx$/, '.test.tsx'),
-    (f) => f.replace(/\.tsx$/, '.spec.tsx'),
+    // Guard on `.tsx`: a bare `.replace(/\.tsx$/, …)` is a no-op on a `.ts`
+    // file, so it would echo the input source file back as its own "test"
+    // (existing on disk → falsely confidence 100%, runs zero tests).
+    (f) => (/\.tsx$/.test(f) ? f.replace(/\.tsx$/, '.test.tsx') : null),
+    (f) => (/\.tsx$/.test(f) ? f.replace(/\.tsx$/, '.spec.tsx') : null),
     (f) => {
         const parsed = nodePath.parse(f);
         if (!parsed.name)

package/dist/test-runner.d.ts.map

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

package/dist/test-runner.js

@@ -1,24 +1,16 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { pathToFileURL } from 'node:url';
 import { buildContext } from '@shrkcrft/context';
 import { buildTaskPacket } from "./task-packet.js";
 import { rankKnowledgeEntries } from "./task-ranker.js";
 import { buildProjectOverview, renderOverviewText } from "./project-overview.js";
 import { HELPERS } from "./helper-registry.js";
+import { importModuleViaLoader } from '@shrkcrft/core';
 async function importDefaultArray(absPath) {
     if (!existsSync(absPath))
         return [];
     try {
-        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(absPath).href)));
+        const mod = (await importModuleViaLoader(absPath));
         return Array.isArray(mod.default) ? mod.default : [];
     }
     catch {
@@ -152,14 +144,17 @@ function buildMissingIncludeSuggestions(id, existsInRegistry, task) {
     }
     return [
         `Entry "${id}" exists but did not make the context for task "${task}".`,
-        `Try adding domain-aligned appliesWhen values (create-plugin / generate-service / register-defaults / …).`,
-        `Add task-relevant tags (plugin / capability / adapter / …).`,
+        `Try adding domain-aligned appliesWhen values (generate-service / generate-utility / create-pipeline / …).`,
+        `Add task-relevant tags (service / utility / route / …).`,
         `Reference the entry from a preset's includes.knowledgeIds / ruleIds so it ranks higher.`,
         `Or raise its priority / shorten the title to include task-relevant tokens.`,
     ];
 }
 export function runAgentContractTest(inspection, test, registries) {
-    const packet = buildTaskPacket(inspection, test.task, { maxTokens: 3500 });
+    // Self-tests assert specific rules/templates appear for a task — they
+    // test semantics, not packet size. Opt out of the compact cap so the
+    // assertions see the full ranking.
+    const packet = buildTaskPacket(inspection, test.task, { maxTokens: 3500, compact: false });
     const actualPipelines = packet.recommendedPipelines.map((p) => p.pipelineId);
     const missingTemplates = (test.expectedTemplates ?? []).filter((id) => !packet.relevantTemplates.some((t) => t.id === id));
     const missingRules = (test.expectedRules ?? []).filter((id) => !packet.relevantRules.some((r) => r.id === id));
@@ -227,7 +222,7 @@ export function runAgentContractTest(inspection, test, registries) {
                 suggestions: exists
                     ? [
                         `Template "${id}" exists but the ranker did not place it in the top results.`,
-                        'Add task-aligned tags/appliesWhen to the template (e.g. tags:["plugin"], appliesWhen:["create-plugin"]).',
+                        'Add task-aligned tags/appliesWhen to the template (e.g. tags:["service"], appliesWhen:["generate-service"]).',
                         'Reference the template from a preset that matches the task profile (includes.templateIds).',
                         'Reference it from a pipeline step (`step.references`).',
                     ]
@@ -245,8 +240,8 @@ export function runAgentContractTest(inspection, test, registries) {
                 suggestions: exists
                     ? [
                         `Rule "${id}" exists but the ranker did not surface it for "${test.task}".`,
-                        'Align its appliesWhen with the domain (e.g. create-plugin / register-defaults / generate-service).',
-                        'Add domain tags (plugin / capability / adapter / defaults).',
+                        'Align its appliesWhen with the domain (e.g. generate-service / generate-utility / create-pipeline).',
+                        'Add domain tags (service / utility / route / pipeline).',
                         'Reference it from actionHints.relatedTemplates on a rule that *is* ranking, or include it in a preset.',
                     ]
                     : [
@@ -477,7 +472,7 @@ async function importDefaultIdsArray(absPath) {
     if (!existsSync(absPath))
         return [];
     try {
-        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(absPath).href)));
+        const mod = (await importModuleViaLoader(absPath));
         return Array.isArray(mod.default) ? mod.default : [];
     }
     catch {

package/dist/universal-search.d.ts

@@ -17,7 +17,6 @@ export declare enum SearchResultKind {
     ScaffoldPattern = "scaffold-pattern",
     ContractTemplate = "contract-template",
     MigrationProfile = "migration-profile",
-    PluginLifecycleProfile = "plugin-lifecycle-profile",
     FeedbackRule = "feedback-rule",
     TaskRoutingHint = "task-routing-hint",
     Docs = "docs",

package/dist/universal-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"universal-search.d.ts","sourceRoot":"","sources":["../src/universal-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"universal-search.d.ts","sourceRoot":"","sources":["../src/universal-search.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAgC,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,aAAa;IACpB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IACtC,gBAAgB,sBAAsB;IACtC,YAAY,kBAAkB;IAC9B,eAAe,sBAAsB;IACrC,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AA+CD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA4NjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAmDhF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA8BpF"}

package/dist/universal-search.js

@@ -17,7 +17,6 @@ import { buildPackContributionsInventory } from "./pack-contributions-inventory.
 import { listConventions } from "./convention-registry.js";
 import { listPackHelpers } from "./pack-helper-registry.js";
 import { explainTaskRouting } from "./task-routing-hint-registry.js";
-import { listPluginLifecycleProfiles } from "./plugin-lifecycle-profile-registry.js";
 import { uncertaintyReportFromSummary } from "./uncertainty-report.js";
 import { buildUncertaintySummary } from "./uncertainty.js";
 import { buildTaskPacket } from "./task-packet.js";
@@ -39,7 +38,6 @@ export var SearchResultKind;
     SearchResultKind["ScaffoldPattern"] = "scaffold-pattern";
     SearchResultKind["ContractTemplate"] = "contract-template";
     SearchResultKind["MigrationProfile"] = "migration-profile";
-    SearchResultKind["PluginLifecycleProfile"] = "plugin-lifecycle-profile";
     SearchResultKind["FeedbackRule"] = "feedback-rule";
     SearchResultKind["TaskRoutingHint"] = "task-routing-hint";
     SearchResultKind["Docs"] = "docs";
@@ -89,7 +87,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
     const conventions = await listConventions(inspection);
     const helpers = await listPackHelpers(inspection);
     const routing = await explainTaskRouting(inspection, q);
-    const lifecycle = await listPluginLifecycleProfiles(inspection);
     const knowledgeEntries = inspection.knowledgeEntries;
     const allHits = [];
     // Knowledge
@@ -113,13 +110,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
             allHits.push(makeHit(SearchResultKind.Helper, h.helper.id, h.helper.title, h.source === 'pack' ? 'pack' : 'local', h.packageName, s, `shrk helper plan ${h.helper.id}`));
         }
     }
-    // Plugin lifecycle profiles
-    for (const p of lifecycle) {
-        const s = score(`${p.profile.id} ${p.profile.title} ${(p.profile.tags ?? []).join(' ')}`, q);
-        if (s.score > 0) {
-            allHits.push(makeHit(SearchResultKind.PluginLifecycleProfile, p.profile.id, p.profile.title, p.source === 'pack' ? 'pack' : 'local', p.packageName, s, `shrk plugin lifecycle profile ${p.profile.id}`));
-        }
-    }
     // Pack contributions (catch-all for kinds we didn't iterate above)
     for (const e of inv.entries) {
         if (allHits.find((h) => h.id === e.id && String(h.kind) === e.kind))
@@ -140,7 +130,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
                 decision: SearchResultKind.Decision,
                 'contract-template': SearchResultKind.ContractTemplate,
                 'migration-profile': SearchResultKind.MigrationProfile,
-                'plugin-lifecycle-profile': SearchResultKind.PluginLifecycleProfile,
                 'feedback-rule': SearchResultKind.FeedbackRule,
                 'task-routing-hint': SearchResultKind.TaskRoutingHint,
                 helper: SearchResultKind.Helper,
@@ -184,7 +173,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
             SearchResultKind.Policy,
             SearchResultKind.ContractTemplate,
             SearchResultKind.MigrationProfile,
-            SearchResultKind.PluginLifecycleProfile,
             SearchResultKind.ScaffoldPattern,
             SearchResultKind.FeedbackRule,
             SearchResultKind.TaskRoutingHint,

package/dist/why-file.js

@@ -23,7 +23,7 @@ export function buildWhyReport(input) {
     const inferredPackage = inferPackage(target.relativePath);
     const inferredLayer = inferLayer(target.relativePath);
     const pathConventions = matchPathConventions(input.inspection, target);
-    const rules = matchRules(input.inspection, target, limit);
+    const rules = matchRules(input.inspection, target, limit, inferredPackage, inferredLayer);
     const boundaries = matchBoundaries(input.inspection, target);
     const knowledge = matchKnowledge(input.inspection, target, limit);
     const suggestedNext = buildSuggestions(target, rules, knowledge);
@@ -78,14 +78,20 @@ function inferLayer(relPath) {
         return segments[1];
     return undefined;
 }
+/** Does `targetRel` equal, or live under, the canonical directory/file path? */
+function pathCovers(targetRel, canonical) {
+    const normalized = canonical.replace(/^\.\//, '').replace(/\/+$/, '');
+    if (!normalized)
+        return false;
+    return targetRel === normalized || targetRel.startsWith(`${normalized}/`);
+}
 function matchPathConventions(inspection, target) {
     const out = [];
     for (const p of inspection.pathService.list()) {
         const canonical = p.metadata?.path ?? '';
         if (!canonical)
             continue;
-        const normalized = canonical.replace(/^\.\//, '');
-        if (target.relativePath === normalized || target.relativePath.startsWith(normalized.endsWith('/') ? normalized : `${normalized}/`)) {
+        if (pathCovers(target.relativePath, canonical)) {
             out.push({
                 id: p.id,
                 title: p.title,
@@ -96,30 +102,74 @@ function matchPathConventions(inspection, target) {
     }
     return out;
 }
-function matchRules(inspection, target, limit) {
-    const tokens = pathTokens(target.relativePath);
+/**
+ * Precise PATH evidence that a rule applies to a file — not topical token
+ * overlap (scope/tags/appliesWhen are free-form labels, so the old
+ * intersection attached nearly every rule to every file). Priority order:
+ * explicit file/dir references → path-glob scope/tag → package reference →
+ * scope/tag equal to the inferred package or layer.
+ */
+function ruleReasonForFile(r, target, inferredPackage, inferredLayer) {
+    const rel = target.relativePath;
+    // 1. Explicit file/directory references that cover the target.
+    for (const ref of r.references ?? []) {
+        const p = (ref.path ?? '').replace(/^\.\//, '');
+        if ((ref.kind === 'file' || ref.kind === 'directory') && p && pathCovers(rel, p)) {
+            return ref.kind === 'directory' ? `directory reference ${p}` : `file reference ${p}`;
+        }
+    }
+    // 1b. Anchors that point at a covering path.
+    for (const a of r.anchors ?? []) {
+        const p = (a.path ?? '').replace(/^\.\//, '');
+        if (p && pathCovers(rel, p))
+            return `anchor path ${p}`;
+    }
+    // 2. Scope/tag values that are themselves path globs matching the target.
+    const pathish = [...(r.scope ?? []), ...(r.tags ?? [])].filter((s) => /[/*?[]/.test(s));
+    if (pathish.length > 0) {
+        const hit = pathish.find((g) => matchesAny(rel, [g]));
+        if (hit)
+            return `path pattern ${hit}`;
+    }
+    // 3. Package reference / scope-or-tag equal to the inferred package or layer.
+    const labels = [...(r.scope ?? []), ...(r.tags ?? [])];
+    if (inferredPackage) {
+        for (const ref of r.references ?? []) {
+            if (ref.kind === 'package' && ref.id && samePath(ref.id, inferredPackage)) {
+                return `package reference ${ref.id}`;
+            }
+        }
+        if (labels.some((l) => samePath(l, inferredPackage)))
+            return `scoped to package ${inferredPackage}`;
+    }
+    if (inferredLayer && labels.some((l) => l.toLowerCase() === inferredLayer.toLowerCase())) {
+        return `scoped to layer ${inferredLayer}`;
+    }
+    return undefined;
+}
+function samePath(a, b) {
+    const n = (s) => s.replace(/^\.?\/+/, '').replace(/\/+$/, '').toLowerCase();
+    return n(a) === n(b);
+}
+function matchRules(inspection, target, limit, inferredPackage, inferredLayer) {
     const out = [];
     for (const rule of inspection.ruleService.list()) {
         const r = rule;
-        const scope = r.scope ?? [];
-        const tags = r.tags ?? [];
-        const appliesWhen = r.appliesWhen ?? [];
-        const allTokens = new Set([...scope, ...tags, ...appliesWhen].map((t) => t.toLowerCase()));
-        const hits = tokens.filter((t) => allTokens.has(t.toLowerCase()));
-        if (hits.length === 0)
+        const reason = ruleReasonForFile(r, target, inferredPackage, inferredLayer);
+        if (!reason)
             continue;
         out.push({
             id: r.id,
             title: r.title,
             priority: r.priority ?? 'medium',
-            scope,
-            tags,
-            appliesWhen,
-            reason: `Matches on: ${hits.join(', ')}`,
+            scope: r.scope ?? [],
+            tags: r.tags ?? [],
+            appliesWhen: r.appliesWhen ?? [],
+            reason,
             ...sourceField(inspection, r.id),
         });
     }
-    // Sort by priority weight desc, then by hit count desc.
+    // Sort by priority weight desc (stable for equal weights).
     const weight = { critical: 4, high: 3, medium: 2, low: 1 };
     out.sort((a, b) => (weight[b.priority] ?? 2) - (weight[a.priority] ?? 2));
     return out.slice(0, limit);
@@ -183,12 +233,6 @@ function buildSuggestions(target, rules, knowledge) {
     out.push(`shrk impact "${target.relativePath}"`);
     return out;
 }
-function pathTokens(relPath) {
-    return relPath
-        .replace(/\.[^./]+$/, '') // drop extension
-        .split(/[/\\.\-_]/)
-        .filter((t) => t.length > 0);
-}
 function sourceField(inspection, id) {
     let map;
     if (inspection && 'entrySources' in inspection) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/inspector",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.20",
   "description": "SharkCraft inspector: project overview, doctor checks, AI-agent instructions.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -42,22 +42,22 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.2",
-    "@shrkcrft/config": "^0.1.0-alpha.2",
-    "@shrkcrft/workspace": "^0.1.0-alpha.2",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.2",
-    "@shrkcrft/rules": "^0.1.0-alpha.2",
-    "@shrkcrft/paths": "^0.1.0-alpha.2",
-    "@shrkcrft/templates": "^0.1.0-alpha.2",
-    "@shrkcrft/context": "^0.1.0-alpha.2",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.2",
-    "@shrkcrft/packs": "^0.1.0-alpha.2",
-    "@shrkcrft/presets": "^0.1.0-alpha.2",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.2",
-    "@shrkcrft/generator": "^0.1.0-alpha.2",
-    "@shrkcrft/importer": "^0.1.0-alpha.2",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.2",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.2",
+    "@shrkcrft/core": "^0.1.0-alpha.20",
+    "@shrkcrft/config": "^0.1.0-alpha.20",
+    "@shrkcrft/workspace": "^0.1.0-alpha.20",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.20",
+    "@shrkcrft/rules": "^0.1.0-alpha.20",
+    "@shrkcrft/paths": "^0.1.0-alpha.20",
+    "@shrkcrft/templates": "^0.1.0-alpha.20",
+    "@shrkcrft/context": "^0.1.0-alpha.20",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.20",
+    "@shrkcrft/packs": "^0.1.0-alpha.20",
+    "@shrkcrft/presets": "^0.1.0-alpha.20",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.20",
+    "@shrkcrft/generator": "^0.1.0-alpha.20",
+    "@shrkcrft/importer": "^0.1.0-alpha.20",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.20",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.20",
     "typescript": "^5.6.0"
   },
   "publishConfig": {

package/dist/plugin-lifecycle-profile-registry.d.ts

@@ -1,52 +0,0 @@
-import { type IPluginLifecycleProfile } from '@shrkcrft/plugin-api';
-import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
-export declare const PLUGIN_LIFECYCLE_PROFILE_REGISTRY_SCHEMA = "sharkcraft.plugin-lifecycle-profile-registry/v1";
-export declare enum PluginLifecycleProfileSource {
-    Local = "local",
-    Pack = "pack",
-    Fixture = "fixture"
-}
-export interface IPluginLifecycleProfileEntry {
-    readonly profile: IPluginLifecycleProfile;
-    readonly source: PluginLifecycleProfileSource;
-    readonly packageName?: string;
-    readonly sourceFile: string;
-}
-export declare enum ProfileDoctorSeverity {
-    Info = "info",
-    Warning = "warning",
-    Error = "error"
-}
-export interface IPluginLifecycleProfileDoctorIssue {
-    readonly severity: ProfileDoctorSeverity;
-    readonly code: string;
-    readonly message: string;
-    readonly profileId?: string;
-    readonly source?: string;
-}
-export declare function loadPluginLifecycleProfiles(inspection: ISharkcraftInspection): Promise<{
-    entries: readonly IPluginLifecycleProfileEntry[];
-    issues: readonly IPluginLifecycleProfileDoctorIssue[];
-}>;
-export declare function listPluginLifecycleProfiles(inspection: ISharkcraftInspection): Promise<readonly IPluginLifecycleProfileEntry[]>;
-export declare function findPluginLifecycleProfile(inspection: ISharkcraftInspection, id: string): Promise<IPluginLifecycleProfileEntry | null>;
-export declare function listPluginLifecycleProfileIssues(inspection: ISharkcraftInspection): Promise<readonly IPluginLifecycleProfileDoctorIssue[]>;
-export declare function clearPluginLifecycleProfileCache(projectRoot?: string): void;
-export interface IResolveProfileOptions {
-    /** Explicit profile id (e.g. from --profile). */
-    readonly profileId?: string;
-    /** If true and there is exactly one profile, return it implicitly. */
-    readonly allowSingleDefault?: boolean;
-}
-export interface IResolveProfileResult {
-    readonly entry?: IPluginLifecycleProfileEntry;
-    readonly error?: string;
-    readonly availableIds: readonly string[];
-}
-/**
- * Pick a profile from the registry. If `profileId` is supplied, look it up.
- * If not and exactly one profile is registered and `allowSingleDefault` is
- * true, return it. Otherwise emit an explanatory error string and list ids.
- */
-export declare function resolvePluginLifecycleProfile(inspection: ISharkcraftInspection, options?: IResolveProfileOptions): Promise<IResolveProfileResult>;
-//# sourceMappingURL=plugin-lifecycle-profile-registry.d.ts.map

package/dist/plugin-lifecycle-profile-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-lifecycle-profile-registry.d.ts","sourceRoot":"","sources":["../src/plugin-lifecycle-profile-registry.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,wCAAwC,oDACF,CAAC;AAEpD,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsCD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,OAAO,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACjD,MAAM,EAAE,SAAS,kCAAkC,EAAE,CAAC;CACvD,CAAC,CAoGD;AAED,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC,CAGlD;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAG9C;AAED,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,kCAAkC,EAAE,CAAC,CAGxD;AAED,wBAAgB,gCAAgC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC"}