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

package/dist/rule-scaffold.js

@@ -131,11 +131,19 @@ function buildTsBody(input, defaults) {
     const advisoryBlock = defaults.advisory ? `\n  metadata: { advisory: true },` : '';
     const verificationLine = verification.length > 0 ? `\n      verificationCommands: ${tsArrayLiteral(verification)},` : '';
     const forbiddenLine = forbidden.length > 0 ? `\n      forbiddenActions: ${tsArrayLiteral(forbidden)},` : '';
-    return `import { defineRule } from '@shrkcrft/rules';
-import { KnowledgePriority } from '@shrkcrft/knowledge';
-
-// Generated by \`shrk rules scaffold --id ${id}\`. Preview-only — review,
+    return `// Generated by \`shrk rules scaffold --id ${id}\`. Preview-only — review,
 // then move into \`sharkcraft/rules.ts\` (or your pack's rules file).
+// Self-contained — no @shrkcrft/* imports required.
+
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+function defineRule<T>(rule: T): T { return rule; }
+
 export const ${idToConst(id)} = defineRule({
   id: ${JSON.stringify(id)},
   title: ${JSON.stringify(title)},

package/dist/scaffold-patterns.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;
-};
 /**
  * Scaffold pattern registry + loader.
  *
@@ -15,13 +7,13 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
  */
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { importModuleViaLoader } from '@shrkcrft/core';
 import { isRecognizedScaffoldStrategy, } from '@shrkcrft/plugin-api';
 export async function loadScaffoldPatternsFromFile(file) {
     if (!existsSync(file))
         return { patterns: [], warnings: [`scaffold pattern file missing: ${file}`] };
     try {
-        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(file).href + '?t=' + Date.now())));
+        const mod = await importModuleViaLoader(file);
         const raw = mod.default ?? mod;
         if (!Array.isArray(raw)) {
             return {

package/dist/search-tuning-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-tuning-registry.d.ts","sourceRoot":"","sources":["../src/search-tuning-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,oBAAoB,yCAAyC,CAAC;AAE3E,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0GD,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;CAAE,CAAC,CA4DlG;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,kBAAkB,EAAE,CAGjG;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,wBAAwB,EAAE,CAG7G;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACnD,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqBD;;;;;;;iCAOiC;AACjC,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3E,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,kBAAkB,CAoGpB"}
+{"version":3,"file":"search-tuning-registry.d.ts","sourceRoot":"","sources":["../src/search-tuning-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,oBAAoB,yCAAyC,CAAC;AAE3E,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0GD,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;CAAE,CAAC,CA4DlG;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,kBAAkB,EAAE,CAGjG;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,wBAAwB,EAAE,CAG7G;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACnD,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqBD;;;;;;;iCAOiC;AACjC,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3E,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,kBAAkB,CAoGpB"}

package/dist/search-tuning-registry.js

@@ -1,19 +1,11 @@
-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 { importModuleViaLoader } from '@shrkcrft/core';
 export const SEARCH_TUNING_SCHEMA = 'sharkcraft.search-tuning-registry/v1';
 const CACHE = new Map();
 const MAX_BOOST = 5;
 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/self-config-doctor-v2.d.ts

@@ -9,7 +9,7 @@ export declare enum SelfConfigSeverityV2 {
  * Source / target kind taxonomy. Open string for forward-compat with
  * pack-contributed kinds, but the engine emits one of these values.
  */
-export type SelfConfigKind = 'knowledge' | 'command' | 'helper' | 'template' | 'playbook' | 'pipeline' | 'policy' | 'rule' | 'path' | 'convention' | 'registration-hint' | 'routing-hint' | 'agent-test' | 'decision' | 'profile' | 'migration-profile' | 'plugin-lifecycle-profile' | 'contract-template' | 'pack' | 'schema' | 'file' | 'unknown';
+export type SelfConfigKind = 'knowledge' | 'command' | 'helper' | 'template' | 'playbook' | 'pipeline' | 'policy' | 'rule' | 'path' | 'convention' | 'registration-hint' | 'routing-hint' | 'agent-test' | 'decision' | 'profile' | 'migration-profile' | 'contract-template' | 'pack' | 'schema' | 'file' | 'unknown';
 /**
  * Edge relation taxonomy. Open string to allow future relations.
  */

package/dist/self-config-doctor-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-config-doctor-v2.d.ts","sourceRoot":"","sources":["../src/self-config-doctor-v2.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAE/E,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,SAAS,GACT,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,MAAM,GACN,YAAY,GACZ,mBAAmB,GACnB,cAAc,GACd,YAAY,GACZ,UAAU,GACV,SAAS,GACT,mBAAmB,GACnB,0BAA0B,GAC1B,mBAAmB,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,4BAA4B,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAChD,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AA8qBD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAyCpC;AAsBD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CA+BtF;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAChC,MAAM,CAqBR"}
+{"version":3,"file":"self-config-doctor-v2.d.ts","sourceRoot":"","sources":["../src/self-config-doctor-v2.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAE/E,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,SAAS,GACT,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,MAAM,GACN,YAAY,GACZ,mBAAmB,GACnB,cAAc,GACd,YAAY,GACZ,UAAU,GACV,SAAS,GACT,mBAAmB,GACnB,mBAAmB,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,4BAA4B,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAChD,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAwqBD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAyCpC;AAsBD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CA+BtF;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAChC,MAAM,CAqBR"}

package/dist/self-config-doctor-v2.js

@@ -18,7 +18,6 @@
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { listConventions } from "./convention-registry.js";
-import { listPluginLifecycleProfiles } from "./plugin-lifecycle-profile-registry.js";
 import { loadAllContractTemplates } from "./contract-template-registry.js";
 import { listMigrationProfilesFromPacks } from "./migration-profile-registry.js";
 import { listPackHelpers } from "./pack-helper-registry.js";
@@ -42,7 +41,6 @@ async function buildLookupsV2(inspection) {
     const templates = new Set(inspection.templateRegistry?.list?.().map((t) => t.id) ?? []);
     const pipelines = new Set(inspection.pipelineRegistry?.list?.().map((p) => p.id) ?? []);
     const conventions = new Set((await listConventions(inspection)).map((e) => e.convention.id));
-    const lifecycleProfiles = new Set((await listPluginLifecycleProfiles(inspection)).map((e) => e.profile.id));
     const contractTemplatesPair = await loadAllContractTemplates(inspection);
     const contractTemplates = new Set(contractTemplatesPair.entries.map((e) => e.template.id));
     const migrationProfiles = new Set((await listMigrationProfilesFromPacks(inspection)).map((p) => p.id));
@@ -103,7 +101,6 @@ async function buildLookupsV2(inspection) {
         conventions,
         contractTemplates,
         migrationProfiles,
-        pluginLifecycleProfiles: lifecycleProfiles,
         helpers,
         routingHints,
         registrationHints,
@@ -177,7 +174,6 @@ async function checkSearchTuning(inspection, lookups, findings) {
                     lookups.templates.has(targetId) ||
                     lookups.pipelines.has(targetId) ||
                     lookups.contractTemplates.has(targetId) ||
-                    lookups.pluginLifecycleProfiles.has(targetId) ||
                     lookups.conventions.has(targetId) ||
                     lookups.playbooks.has(targetId) ||
                     lookups.helpers.has(targetId) ||
@@ -276,18 +272,18 @@ function checkTemplateMetadata(inspection, lookups, findings) {
             });
         }
         for (const id of m.requiredProfileIds ?? []) {
-            if (lookups.pluginLifecycleProfiles.has(id))
+            if (lookups.migrationProfiles.has(id))
                 continue;
             pushFinding(findings, {
                 severity: SelfConfigSeverityV2.Warning,
                 code: 'template-profile-missing',
                 sourceKind: 'template',
                 sourceId: t.id,
-                targetKind: 'plugin-lifecycle-profile',
+                targetKind: 'profile',
                 targetId: id,
                 relation: 'requires',
-                message: `Template "${t.id}" requires plugin-lifecycle profile "${id}" but it is not registered.`,
-                nextCommand: 'shrk plugin lifecycle profiles',
+                message: `Template "${t.id}" requires profile "${id}" but it is not registered.`,
+                nextCommand: 'shrk profiles list',
             });
         }
         for (const id of m.registrationHintIds ?? []) {
@@ -333,7 +329,7 @@ async function checkRoutingHints(inspection, lookups, findings) {
         probe(rec.templates, 'template', lookups.templates);
         probe(rec.helpers, 'helper', lookups.helpers);
         probe(rec.conventions, 'convention', lookups.conventions);
-        probe(rec.profiles, 'plugin-lifecycle-profile', lookups.pluginLifecycleProfiles);
+        probe(rec.profiles, 'profile', lookups.migrationProfiles);
         probe(rec.commands, 'command', lookups.commands);
         probe(rec.playbooks, 'playbook', lookups.playbooks);
     }
@@ -437,7 +433,7 @@ async function checkRegistrationHints(inspection, lookups, findings) {
         };
         probe(h.relatedTemplateIds, 'template', lookups.templates);
         probe(h.relatedConventionIds, 'convention', lookups.conventions);
-        probe(h.relatedProfileIds, 'plugin-lifecycle-profile', lookups.pluginLifecycleProfiles);
+        probe(h.relatedProfileIds, 'profile', lookups.migrationProfiles);
     }
 }
 /**

package/dist/self-config-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-config-doctor.d.ts","sourceRoot":"","sources":["../src/self-config-doctor.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAE5E,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACvD;AAgXD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAsClC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAwC3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAyBlF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAoBtF"}
+{"version":3,"file":"self-config-doctor.d.ts","sourceRoot":"","sources":["../src/self-config-doctor.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAE5E,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACvD;AA0WD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAsClC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAyBlF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAoBtF"}

package/dist/self-config-doctor.js

@@ -14,7 +14,6 @@ import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { buildPackContributionsInventory } from "./pack-contributions-inventory.js";
 import { listConventions } from "./convention-registry.js";
-import { listPluginLifecycleProfiles } from "./plugin-lifecycle-profile-registry.js";
 import { loadAllContractTemplates } from "./contract-template-registry.js";
 import { listMigrationProfilesFromPacks } from "./migration-profile-registry.js";
 import { listPackHelpers } from "./pack-helper-registry.js";
@@ -35,7 +34,6 @@ async function buildLookups(inspection) {
     const pipelines = new Set(inspection.pipelineRegistry?.list?.().map((p) => p.id) ?? []);
     // Convention/profile/contract registries return entries asynchronously.
     const conventions = new Set((await listConventions(inspection)).map((e) => e.convention.id));
-    const lifecycleProfiles = new Set((await listPluginLifecycleProfiles(inspection)).map((e) => e.profile.id));
     const contractTemplatesPair = await loadAllContractTemplates(inspection);
     const contractTemplates = new Set(contractTemplatesPair.entries.map((e) => e.template.id));
     const migrationProfiles = new Set((await listMigrationProfilesFromPacks(inspection)).map((p) => p.id));
@@ -56,7 +54,6 @@ async function buildLookups(inspection) {
         conventions,
         contractTemplates,
         migrationProfiles,
-        pluginLifecycleProfiles: lifecycleProfiles,
         helpers,
         routingHints,
         registrationHints,
@@ -108,7 +105,6 @@ async function checkSearchTuningTargets(inspection, lookups, findings) {
                     lookups.templates.has(targetId) ||
                     lookups.pipelines.has(targetId) ||
                     lookups.contractTemplates.has(targetId) ||
-                    lookups.pluginLifecycleProfiles.has(targetId) ||
                     lookups.conventions.has(targetId);
                 if (!exists) {
                     findings.push({
@@ -183,7 +179,7 @@ async function checkPackContributionConflicts(inspection, findings) {
  *   - `metadata.requiredConventionIds` → conventions registry
  *   - `metadata.requiredHelperIds` → helpers registry
  *   - `metadata.registrationHintIds` → registration-hints registry
- *   - `metadata.requiredProfileIds` → plugin-lifecycle-profiles registry
+ *   - `metadata.requiredProfileIds` → profile registry
  */
 async function checkTemplateMetadataReferences(inspection, lookups, findings) {
     const templates = (inspection.templates ?? []);
@@ -218,15 +214,15 @@ async function checkTemplateMetadataReferences(inspection, lookups, findings) {
             }
         }
         for (const id of m.requiredProfileIds ?? []) {
-            if (!lookups.pluginLifecycleProfiles.has(id)) {
+            if (!lookups.migrationProfiles.has(id)) {
                 findings.push({
                     severity: SelfConfigSeverity.Warning,
                     code: 'template-profile-missing',
-                    message: `Template "${t.id}" requires plugin-lifecycle profile "${id}" but it is not registered.`,
+                    message: `Template "${t.id}" requires profile "${id}" but it is not registered.`,
                     referencingId: t.id,
                     referencedId: id,
-                    referencedKind: 'plugin-lifecycle-profile',
-                    nextCommand: `shrk plugin lifecycle profiles`,
+                    referencedKind: 'profile',
+                    nextCommand: `shrk profiles list`,
                 });
             }
         }
@@ -289,14 +285,14 @@ async function checkRoutingHintTargets(inspection, lookups, findings) {
             }
         }
         for (const id of rec.profiles ?? []) {
-            if (!lookups.pluginLifecycleProfiles.has(id)) {
+            if (!lookups.migrationProfiles.has(id)) {
                 findings.push({
                     severity: SelfConfigSeverity.Info,
                     code: 'routing-hint-profile-missing',
                     message: `Routing hint "${e.hint.id}" recommends profile "${id}" but it is not registered.`,
                     referencingId: e.hint.id,
                     referencedId: id,
-                    referencedKind: 'plugin-lifecycle-profile',
+                    referencedKind: 'profile',
                 });
             }
         }
@@ -353,8 +349,6 @@ export async function buildSelfConfigGraph(inspection) {
         nodes.push({ id, kind: 'convention' });
     for (const id of lookups.contractTemplates)
         nodes.push({ id, kind: 'contract-template' });
-    for (const id of lookups.pluginLifecycleProfiles)
-        nodes.push({ id, kind: 'plugin-lifecycle-profile' });
     for (const id of lookups.migrationProfiles)
         nodes.push({ id, kind: 'migration-profile' });
     // Edges from knowledge → referenced ids (best-effort).

package/dist/sharkcraft-inspector.d.ts

@@ -10,6 +10,20 @@ import { PresetRegistry } from '@shrkcrft/presets';
 import { BoundaryRegistry } from '@shrkcrft/boundaries';
 import { type IDoctorResult } from './doctor-result.js';
 import { type ILoaderDiagnostic } from './loader-diagnostics.js';
+/**
+ * Find SharkCraft packs that live IN the repo but are not discovered (i.e.
+ * not linked into node_modules). Discovery scans node_modules; an unlinked
+ * in-repo pack is invisible to it, which silently disables every pack
+ * contribution. We do a bounded one-level scan of the conventional pack
+ * homes rather than a full recursive walk, so this stays cheap on large
+ * monorepos. A "pack dir" is one that has a `sharkcraft.plugin.*` manifest
+ * (at its root or under `src/`) or a `package.json` with a `sharkcraft`
+ * field. Returns only packs whose package name is NOT already discovered.
+ */
+export declare function findUnlinkedInRepoPacks(projectRoot: string, discoveredPackNames: ReadonlySet<string>): Array<{
+    packageName: string;
+    relPath: string;
+}>;
 export interface ISharkcraftInspection {
     projectRoot: string;
     workspace: IWorkspaceSummary;

package/dist/sharkcraft-inspector.d.ts.map

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

package/dist/sharkcraft-inspector.js

@@ -1,4 +1,4 @@
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { createImportContext, DEFAULT_SAFE_IMPORT_TIMEOUT_MS, } from '@shrkcrft/core';
 import { inspectWorkspace } from '@shrkcrft/workspace';
@@ -13,9 +13,75 @@ import { BUILTIN_PRESETS, loadPresetsFromFile, PresetRegistry } from '@shrkcrft/
 import { BoundaryRegistry, loadBoundaryRulesFromFile } from '@shrkcrft/boundaries';
 import { DoctorSeverity } from "./doctor-result.js";
 import { diagnoseActionHints } from "./action-hint-diagnostics.js";
+import { buildCodeIntelligenceChecks } from "./code-intelligence-doctor.js";
+import { buildDelegateRecipeChecks } from "./delegate-doctor.js";
 import { computeFileFingerprint, createInspectorCache, } from "./inspector-cache.js";
 import { DEFAULT_SLOW_LOADER_THRESHOLD_MS, LARGE_FILE_THRESHOLD_BYTES, } from "./loader-diagnostics.js";
 import { suggestSurfaceProfile } from "./surface-profile-detect.js";
+/**
+ * Find SharkCraft packs that live IN the repo but are not discovered (i.e.
+ * not linked into node_modules). Discovery scans node_modules; an unlinked
+ * in-repo pack is invisible to it, which silently disables every pack
+ * contribution. We do a bounded one-level scan of the conventional pack
+ * homes rather than a full recursive walk, so this stays cheap on large
+ * monorepos. A "pack dir" is one that has a `sharkcraft.plugin.*` manifest
+ * (at its root or under `src/`) or a `package.json` with a `sharkcraft`
+ * field. Returns only packs whose package name is NOT already discovered.
+ */
+export function findUnlinkedInRepoPacks(projectRoot, discoveredPackNames) {
+    const out = [];
+    const seen = new Set();
+    const manifestRelCandidates = [
+        'sharkcraft.plugin.ts',
+        'sharkcraft.plugin.mjs',
+        'sharkcraft.plugin.js',
+        nodePath.join('src', 'sharkcraft.plugin.ts'),
+        nodePath.join('src', 'sharkcraft.plugin.mjs'),
+        nodePath.join('src', 'sharkcraft.plugin.js'),
+    ];
+    for (const parent of ['tools', 'packages', 'libs', '.']) {
+        const parentAbs = nodePath.resolve(projectRoot, parent);
+        let dirs;
+        try {
+            dirs = readdirSync(parentAbs, { withFileTypes: true })
+                .filter((d) => d.isDirectory() && d.name !== 'node_modules')
+                .map((d) => d.name);
+        }
+        catch {
+            continue;
+        }
+        for (const dir of dirs) {
+            const packRoot = nodePath.join(parentAbs, dir);
+            const hasManifestFile = manifestRelCandidates.some((c) => existsSync(nodePath.join(packRoot, c)));
+            let packageName;
+            let hasSharkcraftField = false;
+            const pkgJsonPath = nodePath.join(packRoot, 'package.json');
+            if (existsSync(pkgJsonPath)) {
+                try {
+                    const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+                    if (typeof pkg.name === 'string')
+                        packageName = pkg.name;
+                    hasSharkcraftField = pkg.sharkcraft != null;
+                }
+                catch {
+                    /* unreadable package.json — ignore */
+                }
+            }
+            if (!hasManifestFile && !hasSharkcraftField)
+                continue;
+            if (!packageName || seen.has(packageName))
+                continue;
+            seen.add(packageName);
+            if (!discoveredPackNames.has(packageName)) {
+                out.push({
+                    packageName,
+                    relPath: nodePath.relative(projectRoot, packRoot) || '.',
+                });
+            }
+        }
+    }
+    return out;
+}
 function suggestNextCommand(kind, packName) {
     if (packName)
         return 'shrk packs doctor --release';
@@ -615,6 +681,28 @@ export function runDoctor(inspection) {
                 : `${v} valid, ${i} invalid pack(s). See \`shrk packs doctor\`.`,
         });
     }
+    else {
+        // Zero packs discovered. The costly silent-failure case: the repo SHIPS
+        // a pack (e.g. tools/sharkcraft-pack) but it is not linked into
+        // node_modules, where discovery scans. When that happens every
+        // contribution — templates, boundaries, knowledge — goes dark and doctor
+        // otherwise collapses to "No templates registered / no boundary rules"
+        // with no hint about the real cause. Detect it and make it actionable.
+        const discoveredNames = new Set(inspection.packs.discoveredPacks.map((p) => p.packageName));
+        const unlinked = findUnlinkedInRepoPacks(inspection.projectRoot, discoveredNames);
+        const first = unlinked[0];
+        if (first) {
+            const list = unlinked.map((u) => `${u.packageName} (${u.relPath})`).join(', ');
+            const up = first.packageName.startsWith('@') ? '../../' : '../';
+            checks.push({
+                id: 'packs',
+                title: 'packs',
+                severity: DoctorSeverity.Warning,
+                message: `In-repo pack(s) present but NOT discovered: ${list}. shrk discovers packs by scanning node_modules, so an unlinked in-repo pack loads nothing — templates, boundary rules, and knowledge all go dark even though the assets exist on disk.`,
+                fix: `Link it into node_modules so discovery sees it: \`mkdir -p node_modules/$(dirname ${first.packageName}) && ln -sfn ${up}${first.relPath} node_modules/${first.packageName}\` — or add a \`"${first.packageName}": "file:${first.relPath}"\` dependency. Then re-run \`shrk packs list\`.`,
+            });
+        }
+    }
     if (inspection.pipelines.length === 0) {
         checks.push({
             id: 'pipelines',
@@ -697,6 +785,7 @@ export function runDoctor(inspection) {
                 id: `actionhints-${i.code}-${i.entryId}`,
                 title: `Action-hint quality (${i.code})`,
                 severity: DoctorSeverity.Warning,
+                advisory: true,
                 message: i.message,
                 fix: i.suggestion,
                 category: 'action-hint-quality',
@@ -706,6 +795,19 @@ export function runDoctor(inspection) {
             });
         }
     }
+    // Code-intelligence package health (graph, rule-graph, api-surface,
+    // quality-gates, migrations). Each finding reads a stable on-disk
+    // state file under `.sharkcraft/` and stays silent when the user has
+    // not opted into the relevant feature.
+    for (const c of buildCodeIntelligenceChecks(inspection.projectRoot)) {
+        checks.push(c);
+    }
+    // Delegate-worker recipe health: surface any recipe that isn't safely
+    // delegatable (unbound / missing verification). Silent when the repo hasn't
+    // opted into a `delegation` block.
+    for (const c of buildDelegateRecipeChecks(inspection.config)) {
+        checks.push(c);
+    }
     const summary = { ok: 0, info: 0, warnings: 0, errors: 0, advisoryCount: 0 };
     for (const c of checks) {
         if (c.severity === DoctorSeverity.Ok)

package/dist/start-here.d.ts

@@ -1,7 +1,7 @@
 /**
  * `shrk start-here` — the human entry point.
  *
- * SharkCraft ships 200+ commands. New adopters need a 30-second answer to
+ * SharkCraft ships 200+ commands. New consumers need a 30-second answer to
  * "what should I run first?". This module is the deterministic source of
  * that answer. It does not call any external system, does not read the
  * project state, and never writes — it's a curated list.
@@ -12,7 +12,7 @@
  */
 export declare const START_HERE_SCHEMA = "sharkcraft.start-here/v1";
 export declare const PRIMARY_COMMANDS_SCHEMA = "sharkcraft.primary-commands/v1";
-export type StartHereFlow = 'onboard' | 'brief' | 'dev' | 'review' | 'governance' | 'packs' | 'release';
+export type StartHereFlow = 'onboard' | 'investigate' | 'brief' | 'dev' | 'review' | 'governance' | 'packs' | 'release';
 export type SafetyLevel = 'read-only' | 'writes-drafts' | 'writes-source';
 export interface IStartHereFlow {
     id: StartHereFlow;

package/dist/start-here.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-here.d.ts","sourceRoot":"","sources":["../src/start-here.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAC5D,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,OAAO,GACP,KAAK,GACL,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,iBAAiB,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,aAAa,EAAE,SAAS,cAAc,EAAE,CAAC;IACzC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC;AAwLD,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,gBAAgB,CAiBlF;AAED,wBAAgB,0BAA0B,IAAI,sBAAsB,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkCpE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAQhF"}
+{"version":3,"file":"start-here.d.ts","sourceRoot":"","sources":["../src/start-here.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAC5D,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,aAAa,GACb,OAAO,GACP,KAAK,GACL,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,iBAAiB,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,aAAa,EAAE,SAAS,cAAc,EAAE,CAAC;IACzC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC;AAwMD,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,gBAAgB,CAiBlF;AAED,wBAAgB,0BAA0B,IAAI,sBAAsB,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkCpE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAQhF"}

package/dist/start-here.js

@@ -1,7 +1,7 @@
 /**
  * `shrk start-here` — the human entry point.
  *
- * SharkCraft ships 200+ commands. New adopters need a 30-second answer to
+ * SharkCraft ships 200+ commands. New consumers need a 30-second answer to
  * "what should I run first?". This module is the deterministic source of
  * that answer. It does not call any external system, does not read the
  * project state, and never writes — it's a curated list.
@@ -27,6 +27,21 @@ const FLOWS_PRIMARY = [
         docsLink: 'docs/onboarding.md',
         nextCommand: 'shrk brief "<first task you want the agent to handle>"',
     },
+    {
+        id: 'investigate',
+        title: 'Understand existing code (before you edit)',
+        whenToUse: 'You need to know who calls a symbol, where it is used (file:line), what breaks if you change a file, whether code A is wired to code B, or who implements an interface — use the graph instead of grep.',
+        commands: [
+            'shrk graph index',
+            'shrk graph callers <symbol>',
+            'shrk graph path <from> <to>',
+            'shrk graph context <file-or-symbol>',
+            'shrk graph impact <file-or-symbol> --full',
+        ],
+        safety: 'read-only',
+        docsLink: 'docs/overview.md',
+        nextCommand: 'shrk graph callers <symbol>',
+    },
     {
         id: 'brief',
         title: 'Prepare an AI agent brief',

package/dist/synthesize-from-onboarding.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Convert an {@link IOnboardingPlan} into populated `sharkcraft/*.ts`
+ * file contents — the engine behind `shrk init --infer --write`.
+ *
+ * Design goals:
+ *
+ *   - **Populated, not advisory.** The existing `writeOnboardingDrafts`
+ *     emits files into `sharkcraft/onboarding/` and asks the user to
+ *     adopt by hand. This module emits directly to `sharkcraft/`-root
+ *     files so a `shrk init --infer --write` user gets a working
+ *     project on day 1.
+ *
+ *   - **Honest about confidence.** Inferred entries are tagged with
+ *     their source signal and confidence; medium-confidence rows get a
+ *     `// TODO: review` marker on the emitted line. The user can see
+ *     exactly what was inferred vs hand-curated. Low-confidence rows
+ *     are dropped from the populated file and reported in the
+ *     companion `.inferred-report.md` so the user can find them.
+ *
+ *   - **Self-contained output.** Generated files declare their own
+ *     `defineKnowledgeEntry` / `definePathConvention` stubs — no
+ *     `@shrkcrft/*` imports, matching the local-mirror pattern from
+ *     `packages/presets/src/emit/synthesize-files.ts`.
+ *
+ *   - **Deterministic.** Same input → same output, byte-for-byte.
+ *     Sort lists by id where they're rendered together.
+ *
+ *   - **Idempotent at the file level.** The caller decides write vs
+ *     dry-run + force; this module only produces strings.
+ */
+import type { IOnboardingPlan } from './onboarding.js';
+export interface IInferredFile {
+    /** Path relative to sharkcraft/. */
+    path: string;
+    content: string;
+    /** Which kind of file this is — drives default naming in the report. */
+    kind: 'config' | 'paths' | 'rules' | 'boundaries' | 'pipelines' | 'knowledge' | 'report-md' | 'report-json';
+}
+export interface IInferenceConfidenceReport {
+    /** Entries adopted directly into the populated files (high confidence). */
+    adoptedHigh: readonly IConfidenceLine[];
+    /** Entries adopted with a `// TODO: review` marker (medium confidence). */
+    adoptedMedium: readonly IConfidenceLine[];
+    /** Entries left out of the populated files (low confidence / no signal). */
+    dropped: readonly IConfidenceLine[];
+    /** Author-by-hand suggestions — things shrk can't infer. */
+    notInferable: readonly string[];
+}
+export interface IConfidenceLine {
+    kind: 'rule' | 'path' | 'boundary' | 'pipeline' | 'template' | 'verification';
+    id: string;
+    title: string;
+    /** Why this signal fired (from the onboarding plan). */
+    reason: string;
+}
+export interface IInferenceResult {
+    files: readonly IInferredFile[];
+    report: IInferenceConfidenceReport;
+}
+/**
+ * Convert an {@link IOnboardingPlan} into a populated set of
+ * `sharkcraft/*.ts` files plus a companion confidence report.
+ *
+ * The caller is responsible for actually writing the files; this
+ * function is pure (input plan → output strings).
+ */
+export declare function synthesizeFromOnboarding(plan: IOnboardingPlan): IInferenceResult;
+//# sourceMappingURL=synthesize-from-onboarding.d.ts.map

package/dist/synthesize-from-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-from-onboarding.d.ts","sourceRoot":"","sources":["../src/synthesize-from-onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;CAC7G;AAED,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACxC,2EAA2E;IAC3E,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,4EAA4E;IAC5E,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,4DAA4D;IAC5D,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,0BAA0B,CAAC;CACpC;AAkXD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,eAAe,GACpB,gBAAgB,CA6KlB"}