@shrkcrft/inspector 0.1.0-alpha.7 → 0.1.0-alpha.8

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/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.

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.

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"}