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

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

@@ -697,6 +697,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',

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