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

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