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

package/dist/helper-registry.js

@@ -1,28 +1,529 @@
 /**
- * Helper plan generators.
+ * Helper plan generators (profile-driven for project-specific paths).
  *
  * Helpers are one-shot plan-v2 producers for small, well-bounded edits.
- * Dry-run by default and idempotent where the plan engine supports it.
+ * They are 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.
+ * 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.
  *
- * The engine ships zero built-in helpers. Helpers come from pack
- * contributions when needed.
+ * 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.
  */
-export const HELPERS = Object.freeze([]);
 export const HELPER_SYNTHETIC_TEMPLATE = '__helper__';
-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 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 helperPlanToSavedPlan(plan, _projectRoot) {
-    return plan;
+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 renderHelperPlanText(plan) {
     const lines = [];
-    lines.push(`Helper plan: ${String(plan.helperId)}`);
-    lines.push(`Ops: ${plan.ops.length}`);
-    lines.push(`Conflicts: ${plan.conflicts.length}`);
-    return lines.join('\n');
+    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';
 }

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)) {
+    if (affected.some((a) => a.kind === AreaKind.Core || a.kind === AreaKind.Kernel)) {
         concerns.push({
             policyId: 'core.protected-area',
-            reason: 'Core area touched; requires elevated review.',
+            reason: 'Core / kernel area touched; requires elevated review.',
             severity: 'error',
         });
     }
@@ -442,7 +442,7 @@ function classifyRisk(input) {
         score += 18;
         reasons.push({
             code: 'core-area',
-            message: 'Touches core area.',
+            message: 'Touches core / kernel area.',
         });
     }
     if (input.boundaryCount > 0) {
@@ -610,8 +610,9 @@ 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);
+    const hitsCore = affectedAreas.some((a) => a.kind === AreaKind.Core || a.kind === AreaKind.Kernel || a.kind === AreaKind.Common);
     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;

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

@@ -1 +1 @@
-{"version":3,"file":"impact-render.d.ts","sourceRoot":"","sources":["../src/impact-render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,SAAS,EAAE,CA0Cb;AAiCD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAgER;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAyGR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAiIR"}
+{"version":3,"file":"impact-render.d.ts","sourceRoot":"","sources":["../src/impact-render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,SAAS,EAAE,CAiDb;AAiCD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAgER;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAyGR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAiIR"}

package/dist/impact-render.js

@@ -36,6 +36,11 @@ export function buildImpactTree(impact, opts = {}) {
         for (let i = 0; i < chain.length - 1; i += 1) {
             const importer = chain[i];
             const target = chain[i + 1];
+            // Skip self-references — a file cannot import itself in the
+            // dependency tree we render. (Cycles do exist in import graphs,
+            // but the renderer's job is reviewer clarity, not topology.)
+            if (importer === target)
+                continue;
             const set = importers.get(target) ?? new Set();
             set.add(importer);
             importers.set(target, set);
@@ -45,6 +50,10 @@ export function buildImpactTree(impact, opts = {}) {
     for (const target of impact.normalizedTargets) {
         const set = importers.get(target) ?? new Set();
         for (const dep of impact.directDependents) {
+            // Skip self — a target appearing in its own directDependents list
+            // is a graph artifact, not a real edge to render.
+            if (dep === target)
+                continue;
             // Heuristic: every direct dependent is a candidate importer of every
             // target (the real graph is captured in dependencyPathExamples).
             // We only add direct dependents if they don't already appear as

package/dist/index.d.ts

@@ -22,8 +22,8 @@ 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-drafts-merge.js';
 export * from './onboarding-diff.js';
 export * from './onboarding-adoption.js';
 export * from './adoption-state.js';
@@ -48,6 +48,7 @@ export * from './dev-session-html.js';
 export * from './dashboard/dashboard-data.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';
@@ -174,6 +175,7 @@ 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';