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

package/dist/helper-registry.js

@@ -1,529 +1,28 @@
 /**
- * Helper plan generators (profile-driven for project-specific paths).
+ * Helper plan generators.
  *
  * Helpers are one-shot plan-v2 producers for small, well-bounded edits.
- * They are dry-run by default and idempotent where the plan engine supports it.
+ * Dry-run by default and idempotent where the plan engine supports it.
  *
- * No helper writes source directly. The output is a structured `IHelperPlan`
- * containing planned ops (using the existing plan-v2 operation set) and a
- * list of advisory conflicts when an expected anchor cannot be resolved.
+ * No helper writes source directly. The output is a structured
+ * `IHelperPlan` containing planned ops (using the existing plan-v2
+ * operation set) and a list of advisory conflicts.
  *
- * Helpers must accept an IPluginLifecycleProfile instead of hardcoded paths,
- * so the engine knows where the key-table / plugin roots live.
- * Project-specific helpers contributed by packs travel in pack-contributed
- * playbooks/scaffolds; the engine just provides the generic shapes.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { CaseStyle, } from '@shrkcrft/plugin-api';
-export var HelperId;
-(function (HelperId) {
-    HelperId["AddPluginKey"] = "core.add-plugin-key";
-    HelperId["RemovePluginKey"] = "core.remove-plugin-key";
-    HelperId["RenamePluginKey"] = "core.rename-plugin-key";
-    HelperId["AddBarrelExport"] = "core.add-barrel-export";
-    HelperId["RemoveBarrelExport"] = "core.remove-barrel-export";
-    HelperId["AddEventEntry"] = "core.add-event-entry";
-    HelperId["RemoveEventEntry"] = "core.remove-event-entry";
-    HelperId["AddDefaultRegistration"] = "core.add-default-registration";
-    HelperId["RemoveDefaultRegistration"] = "core.remove-default-registration";
-    HelperId["AddComposerEntry"] = "core.add-composer-entry";
-    HelperId["RemoveComposerEntry"] = "core.remove-composer-entry";
-    HelperId["RenamePluginFolder"] = "core.rename-plugin-folder";
-    HelperId["RemoveUserPluginEntry"] = "core.remove-user-plugin-entry";
-})(HelperId || (HelperId = {}));
-export const HELPERS = Object.freeze([
-    {
-        id: HelperId.AddPluginKey,
-        description: 'Insert a plugin key-table entry just before the closing `} as const;` brace (profile-driven).',
-        destructive: false,
-        requiresHumanReview: false,
-        requiresProfile: true,
-        variables: [
-            { name: 'key', required: true, description: 'kebab-case plugin key (e.g. user-card).' },
-        ],
-    },
-    {
-        id: HelperId.RemovePluginKey,
-        description: 'Remove a plugin key-table entry (profile-driven). Destructive.',
-        destructive: true,
-        requiresHumanReview: true,
-        requiresProfile: true,
-        variables: [{ name: 'key', required: true, description: 'kebab-case plugin key.' }],
-    },
-    {
-        id: HelperId.RenamePluginKey,
-        description: 'Rename a plugin key-table entry (profile-driven). Destructive.',
-        destructive: true,
-        requiresHumanReview: true,
-        requiresProfile: true,
-        variables: [
-            { name: 'old', required: true, description: 'old kebab-case key.' },
-            { name: 'new', required: true, description: 'new kebab-case key.' },
-        ],
-    },
-    {
-        id: HelperId.AddBarrelExport,
-        description: 'Append an `export * from <module>` to a barrel.',
-        destructive: false,
-        requiresHumanReview: false,
-        variables: [
-            { name: 'barrel', required: true, description: 'project-relative path to the barrel file.' },
-            { name: 'from', required: true, description: 'relative module path to re-export.' },
-        ],
-    },
-    {
-        id: HelperId.RemoveBarrelExport,
-        description: 'Remove a barrel `export * from` line. Destructive.',
-        destructive: true,
-        requiresHumanReview: true,
-        variables: [
-            { name: 'barrel', required: true, description: 'project-relative path to the barrel file.' },
-            { name: 'from', required: true, description: 'relative module path to remove.' },
-        ],
-    },
-    {
-        id: HelperId.AddEventEntry,
-        description: 'Append a typed event entry to a plugin events file (requires `eventsPath` var when no profile root is suitable).',
-        destructive: false,
-        requiresHumanReview: false,
-        variables: [
-            { name: 'plugin', required: true, description: 'host plugin kebab-case.' },
-            { name: 'event', required: true, description: 'PascalCase event name.' },
-            {
-                name: 'eventsPath',
-                required: false,
-                description: 'Override target path. Otherwise derived from the first profile pluginRoot + plugin + /events.ts.',
-            },
-        ],
-    },
-    {
-        id: HelperId.RemoveEventEntry,
-        description: 'Remove a typed event block from a plugin events file. Destructive.',
-        destructive: true,
-        requiresHumanReview: true,
-        variables: [
-            { name: 'plugin', required: true, description: 'host plugin kebab-case.' },
-            { name: 'event', required: true, description: 'PascalCase event name.' },
-            {
-                name: 'eventsPath',
-                required: false,
-                description: 'Override target path. Otherwise derived from the first profile pluginRoot + plugin + /events.ts.',
-            },
-        ],
-    },
-    {
-        id: HelperId.AddDefaultRegistration,
-        description: 'Register default config/state providers (manual checklist; locations vary).',
-        destructive: false,
-        requiresHumanReview: true,
-        variables: [
-            { name: 'name', required: true, description: 'plugin kebab-case.' },
-            { name: 'pascal', required: true, description: 'plugin PascalCase.' },
-        ],
-    },
-    {
-        id: HelperId.RemoveDefaultRegistration,
-        description: 'Remove default config/state provider registration (manual checklist). Destructive.',
-        destructive: true,
-        requiresHumanReview: true,
-        variables: [{ name: 'pascal', required: true, description: 'plugin PascalCase.' }],
-    },
-    {
-        id: HelperId.AddComposerEntry,
-        description: 'Append a composer entry (manual checklist — composer locations vary).',
-        destructive: false,
-        requiresHumanReview: true,
-        variables: [{ name: 'plugin', required: true, description: 'plugin kebab-case.' }],
-    },
-    {
-        id: HelperId.RemoveComposerEntry,
-        description: 'Remove a composer entry (manual checklist).',
-        destructive: true,
-        requiresHumanReview: true,
-        variables: [{ name: 'plugin', required: true, description: 'plugin kebab-case.' }],
-    },
-    {
-        id: HelperId.RenamePluginFolder,
-        description: 'Manual checklist: rename a plugin folder across the profile roots.',
-        destructive: true,
-        requiresHumanReview: true,
-        requiresProfile: true,
-        variables: [
-            { name: 'old', required: true, description: 'old plugin kebab-case.' },
-            { name: 'new', required: true, description: 'new plugin kebab-case.' },
-        ],
-    },
-    {
-        id: HelperId.RemoveUserPluginEntry,
-        description: 'Remove a plugin entry from user-facing key-by-scope tables (heuristic).',
-        destructive: true,
-        requiresHumanReview: true,
-        variables: [{ name: 'key', required: true, description: 'plugin kebab-case.' }],
-    },
-]);
-/**
- * Convert a helper plan into a saved plan (synthetic templateId) so
- * it flows through `shrk apply`. Helper ops are persisted as v2 operation
- * intents; the apply path evaluates them against the live file system.
- * Unsigned by default; call `signPlan` separately when desired.
+ * The engine ships zero built-in helpers. Helpers come from pack
+ * contributions when needed.
  */
+export const HELPERS = Object.freeze([]);
 export const HELPER_SYNTHETIC_TEMPLATE = '__helper__';
-export function helperPlanToSavedPlan(plan, projectRoot) {
-    // Map each helper op to a saved expectedChange. The sizeBytes is the
-    // best-effort post-apply size (zero for inserts whose snippet is empty)
-    // — the live evaluator recomputes the actual size at apply time.
-    const expectedChanges = plan.ops.map((op) => {
-        const kind = typeof op.operation['kind'] === 'string' ? op.operation['kind'] : 'append';
-        let sizeBytes = 0;
-        if (typeof op.operation['snippet'] === 'string') {
-            sizeBytes = Buffer.byteLength(op.operation['snippet'], 'utf8');
-        }
-        else if (typeof op.operation['replaceWith'] === 'string') {
-            sizeBytes = Buffer.byteLength(op.operation['replaceWith'], 'utf8');
-        }
-        else if (typeof op.operation['content'] === 'string') {
-            sizeBytes = Buffer.byteLength(op.operation['content'], 'utf8');
-        }
-        return {
-            type: kind,
-            relativePath: op.targetPath,
-            sizeBytes,
-            operation: op.operation,
-        };
-    });
-    const out = {
-        schema: 'sharkcraft.plan/v2',
-        templateId: HELPER_SYNTHETIC_TEMPLATE,
-        variables: {
-            helperId: plan.helperId,
-            ...plan.variables,
-        },
-        projectRoot,
-        createdAt: new Date().toISOString(),
-        expectedChanges,
-    };
-    if (plan.manualSteps.length > 0) {
-        out.note = `Manual steps required: ${plan.manualSteps.join('; ')}`;
-    }
-    return out;
-}
-function readFileSafe(p) {
-    if (!existsSync(p))
-        return null;
-    try {
-        return readFileSync(p, 'utf8');
-    }
-    catch {
-        return null;
-    }
-}
-function splitWords(input) {
-    if (!input)
-        return [];
-    if (input.includes('-') || input.includes('_'))
-        return input.split(/[-_]/).filter(Boolean);
-    return input.split(/(?=[A-Z])/).map((w) => w.toLowerCase()).filter(Boolean);
-}
-function toCase(input, style) {
-    const words = splitWords(input);
-    if (words.length === 0)
-        return input;
-    switch (style) {
-        case CaseStyle.Kebab:
-            return words.map((w) => w.toLowerCase()).join('-');
-        case CaseStyle.UpperSnake:
-            return words.map((w) => w.toUpperCase()).join('_');
-        case CaseStyle.Pascal:
-            return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
-        case CaseStyle.Camel:
-            return words
-                .map((w, i) => (i === 0 ? w.toLowerCase() : w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()))
-                .join('');
-        default:
-            return input;
-    }
-}
-function escapeRegex(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-function requireProfile(helperId, profile) {
-    if (!profile) {
-        throw new Error(`Helper ${helperId} requires a lifecycle profile. Pass the profile loaded from sharkcraft/plugin-lifecycle-profiles or a pack.`);
-    }
-    return profile;
+export function buildHelperPlan(_input) {
+    throw new Error(`No built-in helpers are registered. Pack-contributed helpers can be installed via a sharkcraft pack.`);
 }
-export function buildHelperPlan(input) {
-    const def = HELPERS.find((h) => h.id === input.helperId);
-    if (!def) {
-        throw new Error(`Unknown helper id: ${input.helperId}`);
-    }
-    for (const v of def.variables) {
-        if (v.required && !input.vars[v.name]) {
-            throw new Error(`Helper ${def.id} requires variable "${v.name}".`);
-        }
-    }
-    const ops = [];
-    const manual = [];
-    const conflicts = [];
-    switch (input.helperId) {
-        case HelperId.AddPluginKey: {
-            const profile = requireProfile(input.helperId, input.profile);
-            if (!profile.keyTable) {
-                conflicts.push(`Profile "${profile.id}" has no keyTable; cannot add a plugin key entry.`);
-                break;
-            }
-            const keyTablePath = profile.keyTable.path;
-            const keyName = input.vars.key;
-            const key = toCase(keyName, profile.keyTable.keyCase);
-            const value = toCase(keyName, profile.keyTable.valueCase);
-            ops.push({
-                targetPath: keyTablePath,
-                operation: {
-                    kind: 'insert-before',
-                    anchor: '} as const;',
-                    snippet: `  ${key}: '${value}',\n`,
-                    ifMissing: `${key}:`,
-                    description: `Register key-table entry ${key} = '${value}'.`,
-                },
-            });
-            break;
-        }
-        case HelperId.RemovePluginKey: {
-            const profile = requireProfile(input.helperId, input.profile);
-            if (!profile.keyTable) {
-                conflicts.push(`Profile "${profile.id}" has no keyTable; nothing to remove.`);
-                break;
-            }
-            const keyTablePath = profile.keyTable.path;
-            const keyName = input.vars.key;
-            const key = toCase(keyName, profile.keyTable.keyCase);
-            const value = toCase(keyName, profile.keyTable.valueCase);
-            const file = join(input.projectRoot, keyTablePath);
-            const content = readFileSafe(file);
-            const re = new RegExp(`\\s*${escapeRegex(key)}:\\s*['"]${escapeRegex(value)}['"],?\\n`);
-            const m = content?.match(re);
-            if (m) {
-                ops.push({
-                    targetPath: keyTablePath,
-                    operation: {
-                        kind: 'replace',
-                        find: m[0],
-                        replaceWith: '',
-                        description: `Remove key-table entry ${key}.`,
-                    },
-                });
-            }
-            else {
-                conflicts.push(`Key-table entry ${key} not found in ${keyTablePath}.`);
-            }
-            break;
-        }
-        case HelperId.RenamePluginKey: {
-            const profile = requireProfile(input.helperId, input.profile);
-            if (!profile.keyTable) {
-                conflicts.push(`Profile "${profile.id}" has no keyTable; nothing to rename.`);
-                break;
-            }
-            const keyTablePath = profile.keyTable.path;
-            const oldName = input.vars.old;
-            const newName = input.vars.new;
-            const oldKey = toCase(oldName, profile.keyTable.keyCase);
-            const newKey = toCase(newName, profile.keyTable.keyCase);
-            const oldValue = toCase(oldName, profile.keyTable.valueCase);
-            const newValue = toCase(newName, profile.keyTable.valueCase);
-            const file = join(input.projectRoot, keyTablePath);
-            const content = readFileSafe(file);
-            const re = new RegExp(`(\\s*)${escapeRegex(oldKey)}:\\s*['"]${escapeRegex(oldValue)}['"](,?\\n)`);
-            const m = content?.match(re);
-            if (m) {
-                ops.push({
-                    targetPath: keyTablePath,
-                    operation: {
-                        kind: 'replace',
-                        find: m[0],
-                        replaceWith: `${m[1]}${newKey}: '${newValue}'${m[2]}`,
-                        description: `Rename key-table entry ${oldKey} → ${newKey}.`,
-                    },
-                });
-            }
-            else {
-                conflicts.push(`Key-table entry ${oldKey} not found.`);
-            }
-            break;
-        }
-        case HelperId.AddBarrelExport: {
-            const barrel = input.vars.barrel;
-            const from = input.vars.from;
-            ops.push({
-                targetPath: barrel,
-                operation: {
-                    kind: 'export',
-                    from,
-                    description: `Append export * from '${from}' to ${barrel}.`,
-                },
-            });
-            break;
-        }
-        case HelperId.RemoveBarrelExport: {
-            const barrel = input.vars.barrel;
-            const from = input.vars.from;
-            const content = readFileSafe(join(input.projectRoot, barrel));
-            const lines = (content ?? '').split('\n');
-            const match = lines.find((l) => l.includes(`'${from}'`) || l.includes(`"${from}"`));
-            if (match) {
-                ops.push({
-                    targetPath: barrel,
-                    operation: {
-                        kind: 'replace',
-                        find: match + '\n',
-                        replaceWith: '',
-                        description: `Remove export * from '${from}' from ${barrel}.`,
-                    },
-                });
-            }
-            else {
-                conflicts.push(`No export referencing '${from}' in ${barrel}.`);
-            }
-            break;
-        }
-        case HelperId.AddEventEntry: {
-            const plugin = input.vars.plugin;
-            const eventPascal = input.vars.event;
-            const upper = toCase(eventPascal, CaseStyle.UpperSnake);
-            let eventsPath = input.vars.eventsPath;
-            if (!eventsPath) {
-                const profile = requireProfile(input.helperId, input.profile);
-                const root = profile.pluginRoots[0];
-                if (!root) {
-                    conflicts.push(`Profile "${profile.id}" has no pluginRoots; cannot derive eventsPath.`);
-                    break;
-                }
-                eventsPath = `${root.path}/${plugin}/events.ts`;
-            }
-            const beginMarker = `// ─── ${eventPascal} event (helper) ───`;
-            const snippet = `\n${beginMarker}\n` +
-                `export interface ${eventPascal}Payload {}\n` +
-                `// ${eventPascal} event entry; wire EventType.${upper} manually.\n` +
-                `// ─── end ${eventPascal} event ───\n`;
-            ops.push({
-                targetPath: eventsPath,
-                operation: {
-                    kind: 'append',
-                    snippet,
-                    ifMissing: beginMarker,
-                    description: `Append ${eventPascal} event block to ${eventsPath}.`,
-                },
-            });
-            manual.push(`Add the EventType.${upper} = '${plugin}.${toCase(eventPascal, CaseStyle.Camel)}' enum entry inside the host's EventType enum.`);
-            break;
-        }
-        case HelperId.RemoveEventEntry: {
-            const plugin = input.vars.plugin;
-            const eventPascal = input.vars.event;
-            let eventsPath = input.vars.eventsPath;
-            if (!eventsPath) {
-                const profile = requireProfile(input.helperId, input.profile);
-                const root = profile.pluginRoots[0];
-                if (!root) {
-                    conflicts.push(`Profile "${profile.id}" has no pluginRoots; cannot derive eventsPath.`);
-                    break;
-                }
-                eventsPath = `${root.path}/${plugin}/events.ts`;
-            }
-            const file = join(input.projectRoot, eventsPath);
-            const content = readFileSafe(file);
-            const beginMarker = `// ─── ${eventPascal} event`;
-            const endMarker = `// ─── end ${eventPascal} event ───`;
-            if (content && content.includes(beginMarker) && content.includes(endMarker)) {
-                const start = content.indexOf(beginMarker);
-                const end = content.indexOf(endMarker) + endMarker.length + 1;
-                const block = content.slice(start, end);
-                ops.push({
-                    targetPath: eventsPath,
-                    operation: {
-                        kind: 'replace',
-                        find: block,
-                        replaceWith: '',
-                        description: `Remove ${eventPascal} event block from ${eventsPath}.`,
-                    },
-                });
-            }
-            else {
-                conflicts.push(`Event block ${eventPascal} not found in ${eventsPath}.`);
-            }
-            break;
-        }
-        case HelperId.AddDefaultRegistration: {
-            const pascal = input.vars.pascal;
-            manual.push(`Register ${pascal} default providers in the runtime composition layer (composer location varies — review manually).`);
-            break;
-        }
-        case HelperId.RemoveDefaultRegistration: {
-            const pascal = input.vars.pascal;
-            manual.push(`Remove ${pascal} default providers from the runtime composition layer (composer location varies — review manually).`);
-            break;
-        }
-        case HelperId.AddComposerEntry: {
-            const plugin = input.vars.plugin;
-            manual.push(`Append ${plugin} entry to the appropriate composer. Composer locations vary — review manually.`);
-            break;
-        }
-        case HelperId.RemoveComposerEntry: {
-            const plugin = input.vars.plugin;
-            manual.push(`Remove ${plugin} entry from the appropriate composer. Composer locations vary — review manually.`);
-            break;
-        }
-        case HelperId.RenamePluginFolder: {
-            const oldName = input.vars.old;
-            const newName = input.vars.new;
-            const profile = requireProfile(input.helperId, input.profile);
-            for (const root of profile.pluginRoots) {
-                manual.push(`git mv ${root.path}/${oldName} ${root.path}/${newName}`);
-            }
-            break;
-        }
-        case HelperId.RemoveUserPluginEntry: {
-            const key = input.vars.key;
-            manual.push(`Search for "${key}" in user-facing key-by-scope tables and remove the corresponding entry. Heuristic — review manually.`);
-            break;
-        }
-    }
-    return {
-        schema: 'sharkcraft.helper-plan/v1',
-        helperId: input.helperId,
-        variables: { ...input.vars },
-        ops,
-        manualSteps: manual,
-        conflicts,
-        destructive: def.destructive,
-        humanReviewRequired: def.requiresHumanReview,
-    };
+export function helperPlanToSavedPlan(plan, _projectRoot) {
+    return plan;
 }
 export function renderHelperPlanText(plan) {
     const lines = [];
-    lines.push(`=== Helper plan: ${plan.helperId} ===`);
-    lines.push(`  destructive   ${plan.destructive ? 'YES' : 'no'}`);
-    lines.push(`  review        ${plan.humanReviewRequired ? 'human review required' : 'auto'}`);
-    lines.push('');
-    lines.push(`Operations (${plan.ops.length}):`);
-    for (const op of plan.ops) {
-        const o = op.operation;
-        lines.push(`  • ${op.targetPath} [${o.kind ?? '?'}]`);
-        if (o.description)
-            lines.push(`      ${o.description}`);
-    }
-    if (plan.manualSteps.length > 0) {
-        lines.push('');
-        lines.push(`Manual steps:`);
-        for (const m of plan.manualSteps)
-            lines.push(`  • ${m}`);
-    }
-    if (plan.conflicts.length > 0) {
-        lines.push('');
-        lines.push(`Conflicts:`);
-        for (const c of plan.conflicts)
-            lines.push(`  • ${c}`);
-    }
-    return lines.join('\n') + '\n';
+    lines.push(`Helper plan: ${String(plan.helperId)}`);
+    lines.push(`Ops: ${plan.ops.length}`);
+    lines.push(`Conflicts: ${plan.conflicts.length}`);
+    return lines.join('\n');
 }

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

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

package/dist/impact-analysis.js

@@ -366,10 +366,10 @@ function affectedPolicies(ctx, affected, boundary) {
             severity: 'warning',
         });
     }
-    if (affected.some((a) => a.kind === AreaKind.Core || a.kind === AreaKind.Kernel)) {
+    if (affected.some((a) => a.kind === AreaKind.Core)) {
         concerns.push({
             policyId: 'core.protected-area',
-            reason: 'Core / kernel area touched; requires elevated review.',
+            reason: 'Core area touched; requires elevated review.',
             severity: 'error',
         });
     }
@@ -442,7 +442,7 @@ function classifyRisk(input) {
         score += 18;
         reasons.push({
             code: 'core-area',
-            message: 'Touches core / kernel area.',
+            message: 'Touches core area.',
         });
     }
     if (input.boundaryCount > 0) {
@@ -579,9 +579,17 @@ export async function analyzeImpact(inspection, input) {
     const presets = affectedPresets(expandedCtx);
     const constructs = affectedConstructs(expandedCtx);
     const { existing: likelyTests, missing: missingTests } = findLikelyTests(inspection.projectRoot, files);
+    // Reverse-import graph: any dependent that is itself a test file genuinely
+    // exercises the changed file — including cross-directory tests the filename
+    // conventions miss (e.g. src/__tests__/foo.test.ts importing src/sub/foo.ts).
+    // So the agent's `tests impact` / `impact` returns the exact minimal set to
+    // run instead of falling back to the whole suite.
+    const TEST_FILE_RE = /\.(spec|test)\.[jt]sx?$/;
+    const dependentTests = unique([...directDependents, ...transitiveDependents].filter((f) => TEST_FILE_RE.test(f)));
+    const minimalTests = unique([...likelyTests, ...dependentTests]);
     // Per-target test suggestion (minimal commands).
     const suggestedTestCommands = unique([
-        ...(likelyTests.length > 0 ? [`bun test ${likelyTests.slice(0, 6).join(' ')}`] : []),
+        ...(minimalTests.length > 0 ? [`bun test ${minimalTests.slice(0, 12).join(' ')}`] : []),
         'bun test',
     ]);
     const suggestedFullTestCommands = unique([
@@ -610,9 +618,8 @@ export async function analyzeImpact(inspection, input) {
     }));
     const publicApi = files.some((f) => f.endsWith('/index.ts') ||
         f.endsWith('main.ts') ||
-        f.includes('plugin-api/') ||
         f.includes('public-api/'));
-    const hitsCore = affectedAreas.some((a) => a.kind === AreaKind.Core || a.kind === AreaKind.Kernel || a.kind === AreaKind.Common);
+    const hitsCore = affectedAreas.some((a) => a.kind === AreaKind.Core);
     const hitsPolicy = files.some((f) => f.includes('policy') || f.includes('policy-engine'));
     const hitsTemplates = templates.length > 0 || pipelines.length > 0;
     const ownershipReview = (ownership?.requiredReviewFiles.length ?? 0) > 0;
@@ -670,7 +677,7 @@ export async function analyzeImpact(inspection, input) {
         affectedPipelines: pipelines,
         affectedPresets: presets,
         affectedConstructs: constructs,
-        likelyTests,
+        likelyTests: minimalTests,
         suggestedTestCommands,
         suggestedFullTestCommands,
         suggestedValidationCommands,

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './doctor-result.js';
+export * from './code-intelligence-doctor.js';
 export * from './project-overview.js';
 export * from './sharkcraft-inspector.js';
 export * from './inspector-cache.js';
@@ -8,6 +9,7 @@ export * from './action-hint-diagnostics.js';
 export * from './ai-readiness.js';
 export * from './pack-doctor.js';
 export * from './task-packet.js';
+export * from './resolve-verification-commands.js';
 export * from './reference-lookup.js';
 export * from './task-ranker.js';
 export * from './drift.js';
@@ -22,6 +24,7 @@ export * from './test-runner.js';
 export * from './plan-review.js';
 export * from './onboarding.js';
 export * from './onboarding-report.js';
+export * from './synthesize-from-onboarding.js';
 export * from './onboarding-drafts.js';
 export * from './onboarding-diff.js';
 export * from './onboarding-adoption.js';
@@ -45,9 +48,9 @@ export * from './dev-session.js';
 export * from './dev-session-report.js';
 export * from './dev-session-html.js';
 export * from './dashboard/dashboard-data.js';
+export * from './dashboard/dashboard-knowledge.js';
 export * from './git-helpers.js';
 export * from './boundaries-changed-only.js';
-export * from './plugin-lifecycle.js';
 export * from './helper-registry.js';
 export * from './pack-author-ux.js';
 export * from './pack-test-runner.js';
@@ -139,6 +142,10 @@ export * from './product-coherence.js';
 export * from './task-risk.js';
 export * from './migration-readiness.js';
 export * from './contract-file-rule.js';
+export * from './check-guardrail-globs.js';
+export * from './delegate-catalog.js';
+export * from './delegate-pack-recipes.js';
+export * from './delegate-doctor.js';
 export * from './agent-contract.js';
 export * from './plan-simulation.js';
 export * from './repo-memory.js';
@@ -174,7 +181,6 @@ export * from './changes-summary.js';
 export * from './pr-summary.js';
 export * from './ci-integrity-report.js';
 export * from './uncertainty.js';
-export * from './plugin-lifecycle-profile-registry.js';
 export * from './contract-template-registry.js';
 export * from './migration-profile-registry.js';
 export * from './profile-registry.js';