@shrkcrft/inspector 0.1.0-alpha.2

package/dist/helper-registry.js

@@ -0,0 +1,529 @@
+/**
+ * Helper plan generators (profile-driven for project-specific paths).
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * 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 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) {
+    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: ${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

@@ -0,0 +1,150 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import type { IAreaMap } from './area-map.js';
+import { AreaKind } from './area-map.js';
+import { type IOwnershipImpact } from './ownership.js';
+export declare const IMPACT_ANALYSIS_SCHEMA = "sharkcraft.impact-analysis/v2";
+export declare enum ImpactRisk {
+    Low = "low",
+    Medium = "medium",
+    High = "high",
+    Critical = "critical"
+}
+export declare enum ImpactInputKind {
+    File = "file",
+    Files = "files",
+    Specifier = "specifier",
+    Since = "since",
+    Staged = "staged",
+    Plan = "plan",
+    Bundle = "bundle",
+    Task = "task",
+    Mixed = "mixed",
+    Empty = "empty"
+}
+export interface IImpactAnalysisInput {
+    task?: string;
+    files?: readonly string[];
+    planTargets?: readonly string[];
+    specifier?: string;
+    /** Hint: how the caller produced the file list. */
+    inputKind?: ImpactInputKind;
+    areaMap?: IAreaMap;
+    /** Cap on transitive depth. Default: 5. */
+    maxDepth?: number;
+    /** Max items in each list (truncation guard). Default: 200. */
+    limit?: number;
+}
+export interface IImpactDependentPath {
+    /** Direct importer file. */
+    from: string;
+    /** Ultimate target file in the input set (or the file reached through specifier). */
+    to: string;
+    /** Files visited on the way from `from` → `to`. */
+    via: readonly string[];
+}
+export interface IImpactAreaSummary {
+    id: string;
+    kind: AreaKind;
+    fileCount: number;
+}
+export interface IImpactWorkspaceSummary {
+    name: string;
+    directory: string;
+    fileCount: number;
+}
+export interface IImpactPolicyConcern {
+    policyId: string;
+    reason: string;
+    severity: 'info' | 'warning' | 'error';
+}
+export interface IImpactBoundaryConcern {
+    ruleId: string;
+    reason: string;
+    severity: 'info' | 'warning' | 'error';
+}
+export interface IImpactReason {
+    code: string;
+    message: string;
+    detail?: string;
+}
+export interface IImpactTruncation {
+    list: string;
+    total: number;
+    shown: number;
+}
+export interface IImpactAnalysis {
+    schema: typeof IMPACT_ANALYSIS_SCHEMA;
+    task: string;
+    inputKind: ImpactInputKind;
+    /** Files / paths that the caller is asking about (normalized, relative to projectRoot). */
+    normalizedTargets: readonly string[];
+    /** Specifier the caller passed in, when --specifier was used. */
+    specifier?: string;
+    /** Files mentioned in the original input (kept for the legacy field name). */
+    affectedFiles: readonly string[];
+    /** Direct dependents — files that import one of the targets directly. */
+    directDependents: readonly string[];
+    /** Transitive dependents — files reachable via repeated importer edges. */
+    transitiveDependents: readonly string[];
+    /** Example dependency paths (truncated by `limit`). */
+    dependencyPathExamples: readonly IImpactDependentPath[];
+    /** Areas the target/dependents touch. */
+    affectedAreas: readonly IImpactAreaSummary[];
+    /** Workspace packages the target/dependents touch. */
+    affectedPackages: readonly IImpactWorkspaceSummary[];
+    /** Path conventions the target/dependents touch. */
+    affectedPathConventions: readonly string[];
+    /** Boundary rules potentially impacted. */
+    potentialBoundaryRisks: readonly IImpactBoundaryConcern[];
+    /** Policy checks potentially affected. */
+    affectedPolicies: readonly IImpactPolicyConcern[];
+    /** Ownership entries touched (best-effort summary). */
+    affectedOwnership: IOwnershipImpact | null;
+    /** Templates likely affected by changes. */
+    affectedTemplates: readonly {
+        id: string;
+        name: string;
+    }[];
+    /** Pipelines likely affected. */
+    affectedPipelines: readonly {
+        id: string;
+        title: string;
+    }[];
+    /** Presets likely affected. */
+    affectedPresets: readonly {
+        id: string;
+        name: string;
+    }[];
+    /** Constructs likely affected. */
+    affectedConstructs: readonly {
+        id: string;
+        type: string;
+        title: string;
+    }[];
+    /** Heuristic likely-test files (existing + suggested). */
+    likelyTests: readonly string[];
+    /** Suggested commands. */
+    suggestedTestCommands: readonly string[];
+    suggestedFullTestCommands: readonly string[];
+    suggestedValidationCommands: readonly string[];
+    suggestedReviewCommands: readonly string[];
+    /** Related rules / templates for the task. */
+    relatedRules: readonly {
+        id: string;
+        title: string;
+    }[];
+    relatedTemplates: readonly {
+        id: string;
+        name: string;
+    }[];
+    /** Risk classification + reasons. */
+    risk: ImpactRisk;
+    riskReasons: readonly IImpactReason[];
+    explanation: string;
+    /** Truncation notes for over-limit lists. */
+    truncations: readonly IImpactTruncation[];
+    /** Diagnostics (warnings emitted while computing the report). */
+    diagnostics: readonly string[];
+}
+export declare function analyzeImpact(inspection: ISharkcraftInspection, input: IImpactAnalysisInput): Promise<IImpactAnalysis>;
+//# sourceMappingURL=impact-analysis.d.ts.map

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

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