@shrkcrft/inspector 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/onboarding-drafts-merge.js

@@ -1,174 +0,0 @@
-/**
- * Three-way merge for onboarding drafts.
- *
- * When `shrk onboard --write-drafts` re-runs against a project that has
- * hand-edited drafts, the safe behaviour is to merge the new proposal
- * against the user's current file and the snapshot we wrote last time:
- *
- *   - base    : `.sharkcraft/onboarding-drafts-snapshots/<file>` (what we
- *               wrote last). When absent, the merge degrades to a strict
- *               "matches proposal → no-op, otherwise conflict" rule.
- *   - ours    : the current `sharkcraft/onboarding/<file>` content.
- *   - theirs  : the freshly rendered proposal we are about to write.
- *
- * The merge always returns an intended `body`. The caller decides whether
- * to write it (e.g. `abortOnConflict` keeps the file unchanged).
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import * as nodePath from 'node:path';
-export var DraftMergeStatus;
-(function (DraftMergeStatus) {
-    /** File did not exist; the proposal was written verbatim. */
-    DraftMergeStatus["Created"] = "created";
-    /** Current file already matches the proposal — nothing to do. */
-    DraftMergeStatus["Unchanged"] = "unchanged";
-    /** Current file matches the snapshot; the proposal was applied. */
-    DraftMergeStatus["CleanUpdate"] = "clean-update";
-    /** Proposal matches the snapshot; the user's edits were kept. */
-    DraftMergeStatus["UserKept"] = "user-kept";
-    /** Disjoint single-region edits on both sides; auto-merged. */
-    DraftMergeStatus["AutoMerged"] = "auto-merged";
-    /** Both sides changed the same region — conflict markers emitted. */
-    DraftMergeStatus["Conflict"] = "conflict";
-    /** Both sides changed but `abortOnConflict` was set — file untouched. */
-    DraftMergeStatus["Aborted"] = "aborted";
-})(DraftMergeStatus || (DraftMergeStatus = {}));
-/**
- * Resolve the snapshot path for a given draft file.
- *
- * @param projectRoot Absolute repo root.
- * @param draftPath   Absolute path of the draft file.
- */
-export function snapshotPathFor(projectRoot, draftPath) {
-    const rel = nodePath.relative(nodePath.join(projectRoot, 'sharkcraft', 'onboarding'), draftPath);
-    return nodePath.join(projectRoot, '.sharkcraft', 'onboarding-drafts-snapshots', rel);
-}
-export function readSnapshot(snapshotPath) {
-    if (!existsSync(snapshotPath))
-        return null;
-    try {
-        return readFileSync(snapshotPath, 'utf8');
-    }
-    catch {
-        return null;
-    }
-}
-export function writeSnapshot(snapshotPath, body) {
-    mkdirSync(nodePath.dirname(snapshotPath), { recursive: true });
-    writeFileSync(snapshotPath, body, 'utf8');
-}
-/**
- * Three-way merge a single draft file.
- *
- * Truth table:
- *   - !exists(ours)           → Created (body = theirs)
- *   - ours === theirs         → Unchanged
- *   - base === null:
- *       - ours === theirs     → Unchanged
- *       - otherwise           → Conflict (or Aborted)
- *   - ours === base           → CleanUpdate (body = theirs)
- *   - theirs === base         → UserKept (body = ours)
- *   - otherwise               → diff3Lines → AutoMerged | Conflict | Aborted
- */
-export function threeWayMergeDraft(base, ours, theirs, options = {}) {
-    if (ours === null) {
-        return { status: DraftMergeStatus.Created, body: theirs, conflictRegions: 0 };
-    }
-    if (ours === theirs) {
-        return { status: DraftMergeStatus.Unchanged, body: ours, conflictRegions: 0 };
-    }
-    if (base === null) {
-        return wholeFileConflict(ours, theirs, options);
-    }
-    if (ours === base) {
-        return { status: DraftMergeStatus.CleanUpdate, body: theirs, conflictRegions: 0 };
-    }
-    if (theirs === base) {
-        return { status: DraftMergeStatus.UserKept, body: ours, conflictRegions: 0 };
-    }
-    return diff3Lines(base, ours, theirs, options);
-}
-/**
- * Coarse-grained line-level three-way merge.
- *
- * Strips the common prefix and suffix lines, then inspects the centre:
- *   - centre(ours) === centre(base)   → take theirs
- *   - centre(theirs) === centre(base) → take ours
- *   - centre(ours) === centre(theirs) → take either
- *   - otherwise                       → emit conflict markers around the centre
- *
- * Multiple disjoint edit regions fall through to conflict; that's a
- * deliberate trade-off — anything subtler than a single contiguous edit
- * is exactly the case a human should review.
- */
-function diff3Lines(base, ours, theirs, options) {
-    const baseLines = base.split('\n');
-    const oursLines = ours.split('\n');
-    const theirsLines = theirs.split('\n');
-    let prefix = 0;
-    const maxPrefix = Math.min(baseLines.length, oursLines.length, theirsLines.length);
-    while (prefix < maxPrefix &&
-        baseLines[prefix] === oursLines[prefix] &&
-        baseLines[prefix] === theirsLines[prefix]) {
-        prefix += 1;
-    }
-    let suffix = 0;
-    const maxSuffix = Math.min(baseLines.length, oursLines.length, theirsLines.length) - prefix;
-    while (suffix < maxSuffix &&
-        baseLines[baseLines.length - 1 - suffix] === oursLines[oursLines.length - 1 - suffix] &&
-        baseLines[baseLines.length - 1 - suffix] === theirsLines[theirsLines.length - 1 - suffix]) {
-        suffix += 1;
-    }
-    const baseCentre = baseLines.slice(prefix, baseLines.length - suffix).join('\n');
-    const oursCentre = oursLines.slice(prefix, oursLines.length - suffix).join('\n');
-    const theirsCentre = theirsLines.slice(prefix, theirsLines.length - suffix).join('\n');
-    const headLines = oursLines.slice(0, prefix);
-    const tailLines = oursLines.slice(oursLines.length - suffix);
-    if (oursCentre === baseCentre) {
-        // Only theirs diverged.
-        const merged = [...headLines, ...theirsLines.slice(prefix, theirsLines.length - suffix), ...tailLines].join('\n');
-        return { status: DraftMergeStatus.AutoMerged, body: merged, conflictRegions: 0 };
-    }
-    if (theirsCentre === baseCentre) {
-        // Only ours diverged.
-        return { status: DraftMergeStatus.UserKept, body: ours, conflictRegions: 0 };
-    }
-    if (oursCentre === theirsCentre) {
-        // Both sides made identical changes.
-        const merged = [...headLines, ...oursLines.slice(prefix, oursLines.length - suffix), ...tailLines].join('\n');
-        return { status: DraftMergeStatus.AutoMerged, body: merged, conflictRegions: 0 };
-    }
-    if (options.abortOnConflict) {
-        return { status: DraftMergeStatus.Aborted, body: ours, conflictRegions: 1 };
-    }
-    const oursLabel = options.oursLabel ?? 'ours';
-    const theirsLabel = options.theirsLabel ?? 'incoming proposal';
-    const markerOpen = `<<<<<<< ${oursLabel}`;
-    const markerMid = '=======';
-    const markerClose = `>>>>>>> ${theirsLabel}`;
-    const conflictBlock = [
-        markerOpen,
-        oursCentre,
-        markerMid,
-        theirsCentre,
-        markerClose,
-    ];
-    const body = [...headLines, ...conflictBlock, ...tailLines].join('\n');
-    return { status: DraftMergeStatus.Conflict, body, conflictRegions: 1 };
-}
-function wholeFileConflict(ours, theirs, options) {
-    if (options.abortOnConflict) {
-        return { status: DraftMergeStatus.Aborted, body: ours, conflictRegions: 1 };
-    }
-    const oursLabel = options.oursLabel ?? 'ours';
-    const theirsLabel = options.theirsLabel ?? 'incoming proposal';
-    const body = [
-        `<<<<<<< ${oursLabel}`,
-        ours.replace(/\n$/, ''),
-        '=======',
-        theirs.replace(/\n$/, ''),
-        `>>>>>>> ${theirsLabel}`,
-        '',
-    ].join('\n');
-    return { status: DraftMergeStatus.Conflict, body, conflictRegions: 1 };
-}

package/dist/plugin-lifecycle-profile-registry.d.ts

@@ -1,52 +0,0 @@
-import { type IPluginLifecycleProfile } from '@shrkcrft/plugin-api';
-import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
-export declare const PLUGIN_LIFECYCLE_PROFILE_REGISTRY_SCHEMA = "sharkcraft.plugin-lifecycle-profile-registry/v1";
-export declare enum PluginLifecycleProfileSource {
-    Local = "local",
-    Pack = "pack",
-    Fixture = "fixture"
-}
-export interface IPluginLifecycleProfileEntry {
-    readonly profile: IPluginLifecycleProfile;
-    readonly source: PluginLifecycleProfileSource;
-    readonly packageName?: string;
-    readonly sourceFile: string;
-}
-export declare enum ProfileDoctorSeverity {
-    Info = "info",
-    Warning = "warning",
-    Error = "error"
-}
-export interface IPluginLifecycleProfileDoctorIssue {
-    readonly severity: ProfileDoctorSeverity;
-    readonly code: string;
-    readonly message: string;
-    readonly profileId?: string;
-    readonly source?: string;
-}
-export declare function loadPluginLifecycleProfiles(inspection: ISharkcraftInspection): Promise<{
-    entries: readonly IPluginLifecycleProfileEntry[];
-    issues: readonly IPluginLifecycleProfileDoctorIssue[];
-}>;
-export declare function listPluginLifecycleProfiles(inspection: ISharkcraftInspection): Promise<readonly IPluginLifecycleProfileEntry[]>;
-export declare function findPluginLifecycleProfile(inspection: ISharkcraftInspection, id: string): Promise<IPluginLifecycleProfileEntry | null>;
-export declare function listPluginLifecycleProfileIssues(inspection: ISharkcraftInspection): Promise<readonly IPluginLifecycleProfileDoctorIssue[]>;
-export declare function clearPluginLifecycleProfileCache(projectRoot?: string): void;
-export interface IResolveProfileOptions {
-    /** Explicit profile id (e.g. from --profile). */
-    readonly profileId?: string;
-    /** If true and there is exactly one profile, return it implicitly. */
-    readonly allowSingleDefault?: boolean;
-}
-export interface IResolveProfileResult {
-    readonly entry?: IPluginLifecycleProfileEntry;
-    readonly error?: string;
-    readonly availableIds: readonly string[];
-}
-/**
- * Pick a profile from the registry. If `profileId` is supplied, look it up.
- * If not and exactly one profile is registered and `allowSingleDefault` is
- * true, return it. Otherwise emit an explanatory error string and list ids.
- */
-export declare function resolvePluginLifecycleProfile(inspection: ISharkcraftInspection, options?: IResolveProfileOptions): Promise<IResolveProfileResult>;
-//# sourceMappingURL=plugin-lifecycle-profile-registry.d.ts.map

package/dist/plugin-lifecycle-profile-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-lifecycle-profile-registry.d.ts","sourceRoot":"","sources":["../src/plugin-lifecycle-profile-registry.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,wCAAwC,oDACF,CAAC;AAEpD,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsCD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,OAAO,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACjD,MAAM,EAAE,SAAS,kCAAkC,EAAE,CAAC;CACvD,CAAC,CAoGD;AAED,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC,CAGlD;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAG9C;AAED,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,kCAAkC,EAAE,CAAC,CAGxD;AAED,wBAAgB,gCAAgC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC"}

package/dist/plugin-lifecycle-profile-registry.js

@@ -1,202 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-/**
- * Plugin lifecycle profile registry.
- *
- * Loads pack-contributed and locally configured `IPluginLifecycleProfile`
- * entries. Duplicate ids and invalid profiles surface as doctor issues.
- * Source attribution lets the CLI tell the user where a profile came from.
- */
-import { existsSync } from 'node:fs';
-import * as nodePath from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { validatePluginLifecycleProfile, } from '@shrkcrft/plugin-api';
-export const PLUGIN_LIFECYCLE_PROFILE_REGISTRY_SCHEMA = 'sharkcraft.plugin-lifecycle-profile-registry/v1';
-export var PluginLifecycleProfileSource;
-(function (PluginLifecycleProfileSource) {
-    PluginLifecycleProfileSource["Local"] = "local";
-    PluginLifecycleProfileSource["Pack"] = "pack";
-    PluginLifecycleProfileSource["Fixture"] = "fixture";
-})(PluginLifecycleProfileSource || (PluginLifecycleProfileSource = {}));
-export var ProfileDoctorSeverity;
-(function (ProfileDoctorSeverity) {
-    ProfileDoctorSeverity["Info"] = "info";
-    ProfileDoctorSeverity["Warning"] = "warning";
-    ProfileDoctorSeverity["Error"] = "error";
-})(ProfileDoctorSeverity || (ProfileDoctorSeverity = {}));
-const CACHE = new Map();
-async function importDefaultProfiles(file) {
-    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(file).href)));
-    if (Array.isArray(mod.default))
-        return mod.default;
-    if (mod.default && typeof mod.default === 'object')
-        return [mod.default];
-    if (Array.isArray(mod.pluginLifecycleProfiles))
-        return mod.pluginLifecycleProfiles;
-    return [];
-}
-function localProfileFiles(inspection) {
-    const out = [];
-    const dir = inspection.sharkcraftDir;
-    if (!dir)
-        return [];
-    for (const name of ['plugin-lifecycle-profiles.ts', 'plugin-lifecycle-profiles/index.ts']) {
-        const full = nodePath.join(dir, name);
-        if (existsSync(full))
-            out.push(full);
-    }
-    const cfg = inspection.config;
-    for (const rel of cfg?.pluginLifecycleProfileFiles ?? []) {
-        out.push(nodePath.isAbsolute(rel) ? rel : nodePath.join(dir, rel));
-    }
-    return out;
-}
-export async function loadPluginLifecycleProfiles(inspection) {
-    const cacheKey = `${inspection.projectRoot}:${(inspection.packs.validPacks ?? [])
-        .map((p) => p.packageName + '@' + p.packageVersion)
-        .join(',')}`;
-    const cached = CACHE.get(inspection.projectRoot);
-    if (cached && cached.cacheKey === cacheKey) {
-        return { entries: cached.entries, issues: cached.issues };
-    }
-    const seen = new Map();
-    const entries = [];
-    const issues = [];
-    const ingest = (profile, source, packageName, sourceFile) => {
-        const validation = validatePluginLifecycleProfile(profile);
-        if (!validation.valid) {
-            for (const issue of validation.issues) {
-                issues.push({
-                    severity: ProfileDoctorSeverity.Error,
-                    code: 'invalid-profile',
-                    message: `${issue.field}: ${issue.message}`,
-                    profileId: typeof profile.id === 'string' ? profile.id : undefined,
-                    source: sourceFile,
-                });
-            }
-            return;
-        }
-        const existing = seen.get(profile.id);
-        if (existing) {
-            issues.push({
-                severity: ProfileDoctorSeverity.Error,
-                code: 'duplicate-id',
-                message: `Profile id "${profile.id}" already loaded from ${existing.sourceFile} (source=${existing.source}); skipping duplicate from ${sourceFile} (source=${source}).`,
-                profileId: profile.id,
-                source: sourceFile,
-            });
-            return;
-        }
-        const entry = {
-            profile,
-            source,
-            ...(packageName ? { packageName } : {}),
-            sourceFile,
-        };
-        seen.set(profile.id, entry);
-        entries.push(entry);
-    };
-    for (const file of localProfileFiles(inspection)) {
-        try {
-            const list = await importDefaultProfiles(file);
-            const rel = nodePath.relative(inspection.projectRoot, file) || file;
-            for (const raw of list) {
-                ingest(raw, PluginLifecycleProfileSource.Local, undefined, rel);
-            }
-        }
-        catch (e) {
-            issues.push({
-                severity: ProfileDoctorSeverity.Warning,
-                code: 'load-failed',
-                message: `Failed to load ${file}: ${e.message}`,
-                source: file,
-            });
-        }
-    }
-    for (const pack of inspection.packs.validPacks ?? []) {
-        const contributions = (pack.manifest?.contributions ?? {});
-        for (const rel of contributions.pluginLifecycleProfileFiles ?? []) {
-            const file = nodePath.resolve(pack.packageRoot, rel);
-            if (!existsSync(file)) {
-                issues.push({
-                    severity: ProfileDoctorSeverity.Warning,
-                    code: 'missing-file',
-                    message: `Pack ${pack.packageName} declares profile file ${rel} but it is missing.`,
-                    source: file,
-                });
-                continue;
-            }
-            try {
-                const list = await importDefaultProfiles(file);
-                for (const raw of list) {
-                    ingest(raw, PluginLifecycleProfileSource.Pack, pack.packageName, rel);
-                }
-            }
-            catch (e) {
-                issues.push({
-                    severity: ProfileDoctorSeverity.Warning,
-                    code: 'load-failed',
-                    message: `Pack ${pack.packageName} (${rel}): ${e.message}`,
-                    source: file,
-                });
-            }
-        }
-    }
-    CACHE.set(inspection.projectRoot, { cacheKey, entries, issues });
-    return { entries, issues };
-}
-export async function listPluginLifecycleProfiles(inspection) {
-    const { entries } = await loadPluginLifecycleProfiles(inspection);
-    return entries;
-}
-export async function findPluginLifecycleProfile(inspection, id) {
-    const entries = await listPluginLifecycleProfiles(inspection);
-    return entries.find((e) => e.profile.id === id) ?? null;
-}
-export async function listPluginLifecycleProfileIssues(inspection) {
-    const { issues } = await loadPluginLifecycleProfiles(inspection);
-    return issues;
-}
-export function clearPluginLifecycleProfileCache(projectRoot) {
-    if (projectRoot)
-        CACHE.delete(projectRoot);
-    else
-        CACHE.clear();
-}
-/**
- * Pick a profile from the registry. If `profileId` is supplied, look it up.
- * If not and exactly one profile is registered and `allowSingleDefault` is
- * true, return it. Otherwise emit an explanatory error string and list ids.
- */
-export async function resolvePluginLifecycleProfile(inspection, options = {}) {
-    const entries = await listPluginLifecycleProfiles(inspection);
-    const availableIds = entries.map((e) => e.profile.id);
-    if (options.profileId) {
-        const found = entries.find((e) => e.profile.id === options.profileId);
-        if (found)
-            return { entry: found, availableIds };
-        return {
-            error: `Unknown plugin lifecycle profile "${options.profileId}". Available: ${availableIds.length === 0 ? '(none registered)' : availableIds.join(', ')}. Contribute one via a pack manifest "pluginLifecycleProfileFiles" entry or sharkcraft/plugin-lifecycle-profiles.ts.`,
-            availableIds,
-        };
-    }
-    if (entries.length === 0) {
-        return {
-            error: 'No plugin lifecycle profiles registered. Contribute one via a pack manifest "pluginLifecycleProfileFiles" entry or sharkcraft/plugin-lifecycle-profiles.ts.',
-            availableIds,
-        };
-    }
-    if (entries.length === 1 && options.allowSingleDefault) {
-        return { entry: entries[0], availableIds };
-    }
-    return {
-        error: `--profile required. Available: ${availableIds.join(', ')}.`,
-        availableIds,
-    };
-}

package/dist/plugin-lifecycle.d.ts

@@ -1,132 +0,0 @@
-/**
- * Plan-only plugin lifecycle helpers driven by a resolved profile.
- *
- * Lifecycle helpers never write source directly. They emit a structured plan
- * containing:
- *   - replaceOps:    safe `replace` plan operations against the profile's
- *                    key-table file, barrels, and other registry files.
- *   - manualSteps:   things the planned-operation model cannot do today
- *                    (rename a folder, delete a folder) when folder ops are
- *                    not requested or not safe.
- *   - conflicts:     anchors that could not be found — surfaced as advisory
- *                    hints (no failure).
- *   - destructive:   `true` for remove; `true` for rename when files need to
- *                    be renamed on disk.
- *
- * The engine has no project-specific knowledge: every path / key style / barrel
- * comes from the supplied `IPluginLifecycleProfile`. A pack contributes the
- * profile via `pluginLifecycleProfileFiles` on the manifest.
- */
-import { type IPluginLifecycleProfile } from '@shrkcrft/plugin-api';
-export declare enum PluginLifecycleAction {
-    Rename = "rename",
-    Remove = "remove"
-}
-export interface IPluginLifecycleManualStep {
-    kind: 'delete-file' | 'delete-folder' | 'rename-file' | 'rename-folder';
-    targetPath: string;
-    newPath?: string;
-    reason: string;
-}
-export interface IPluginLifecycleReplaceOp {
-    targetPath: string;
-    operation: {
-        kind: 'replace';
-        find: string;
-        replaceWith: string;
-        description: string;
-    };
-}
-export interface IPluginLifecycleFolderOp {
-    kind: 'rename-folder' | 'delete-folder';
-    targetPath: string;
-    newPath?: string;
-    safety: 'safe' | 'unsafe';
-    safetyReason?: string;
-    reason: string;
-}
-export interface IPluginLifecyclePlan {
-    schema: 'sharkcraft.plugin-lifecycle/v1';
-    action: PluginLifecycleAction;
-    /** Profile id (e.g. "my-monorepo"). Engine does not constrain this to a literal. */
-    profile: string;
-    oldName: string;
-    newName?: string;
-    destructive: boolean;
-    humanApprovalRequired: boolean;
-    replaceOps: ReadonlyArray<IPluginLifecycleReplaceOp>;
-    manualSteps: ReadonlyArray<IPluginLifecycleManualStep>;
-    /** Structured folder operations when --emit-folder-ops is requested. */
-    folderOps?: ReadonlyArray<IPluginLifecycleFolderOp>;
-    conflicts: ReadonlyArray<string>;
-    validationCommands: ReadonlyArray<string>;
-}
-export interface IBuildPluginRenameInput {
-    projectRoot: string;
-    profile: IPluginLifecycleProfile;
-    oldName: string;
-    newName: string;
-    /** When true, also emit structured folder rename ops in `folderOps[]`. */
-    emitFolderOps?: boolean;
-}
-export declare function buildPluginRenamePlan(input: IBuildPluginRenameInput): IPluginLifecyclePlan;
-export interface IBuildPluginRemoveInput {
-    projectRoot: string;
-    profile: IPluginLifecycleProfile;
-    oldName: string;
-    /** When true, also emit structured folder delete ops in `folderOps[]`. */
-    emitFolderOps?: boolean;
-}
-export declare function buildPluginRemovePlan(input: IBuildPluginRemoveInput): IPluginLifecyclePlan;
-/**
- * Convert a plugin-lifecycle plan into a saved plan (synthetic
- * templateId) so it can flow through `shrk apply`. ReplaceOps become
- * `expectedChanges` carrying their operation intent; folderOps[] is copied
- * through. The plan is unsigned by this helper; call `signPlan` separately.
- */
-export declare const PLUGIN_LIFECYCLE_SYNTHETIC_TEMPLATE = "__plugin-lifecycle__";
-export declare function pluginLifecyclePlanToSavedPlan(plan: IPluginLifecyclePlan, projectRoot: string): {
-    schema: 'sharkcraft.plan/v2';
-    templateId: string;
-    name?: string;
-    variables: Record<string, string>;
-    projectRoot: string;
-    createdAt: string;
-    expectedChanges: {
-        type: string;
-        relativePath: string;
-        sizeBytes: number;
-        operation: IPluginLifecycleReplaceOp['operation'];
-    }[];
-    folderOps?: {
-        kind: 'rename-folder' | 'delete-folder';
-        targetPath: string;
-        newPath?: string;
-        reason?: string;
-    }[];
-    note?: string;
-};
-export declare function renderPluginLifecyclePlanText(plan: IPluginLifecyclePlan): string;
-export interface IPluginLifecycleListingInput {
-    projectRoot: string;
-    profile: IPluginLifecycleProfile;
-}
-export declare function buildPluginLifecycleListing(input: IPluginLifecycleListingInput): {
-    pluginsByLayer: Readonly<Record<string, ReadonlyArray<string>>>;
-    pluginKeys: ReadonlyArray<{
-        key: string;
-        value: string;
-    }>;
-};
-/**
- * Doctor check: a profile is valid if every declared file exists and the
- * key-table file (if any) parses. This stays read-only; no fs mutations.
- */
-export interface IPluginLifecycleProfileDoctorEntry {
-    readonly id: 'missing-key-table' | 'missing-barrel' | 'missing-plugin-root' | 'ok';
-    readonly severity: 'info' | 'warning' | 'error';
-    readonly path?: string;
-    readonly message: string;
-}
-export declare function checkPluginLifecycleProfileHealth(projectRoot: string, profile: IPluginLifecycleProfile): readonly IPluginLifecycleProfileDoctorEntry[];
-//# sourceMappingURL=plugin-lifecycle.d.ts.map

package/dist/plugin-lifecycle.d.ts.map

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