@shrkcrft/inspector 0.1.0-alpha.1

package/dist/playbook-registry.d.ts

@@ -0,0 +1,25 @@
+import type { IPlaybookInput, IPlaybookStep } from '@shrkcrft/plugin-api';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const PLAYBOOK_REGISTRY_SCHEMA = "sharkcraft.playbook-registry/v1";
+export interface IPlaybook extends IPlaybookInput {
+    source: 'local' | 'pack';
+    packageName?: string;
+    sourceFile?: string;
+}
+export declare function loadPlaybooks(inspection: ISharkcraftInspection): Promise<readonly IPlaybook[]>;
+export declare function listPlaybooks(inspection: ISharkcraftInspection): readonly IPlaybook[];
+export declare function warmPlaybookCache(inspection: ISharkcraftInspection): Promise<void>;
+export interface IPlaybookRunbook {
+    playbookId: string;
+    title: string;
+    steps: readonly IPlaybookStep[];
+    notes: readonly string[];
+}
+export declare function buildRunbook(playbook: IPlaybook): IPlaybookRunbook;
+export interface IPlaybookRecommendation {
+    playbook: IPlaybook;
+    score: number;
+    reasons: readonly string[];
+}
+export declare function recommendPlaybooks(playbooks: readonly IPlaybook[], task: string): readonly IPlaybookRecommendation[];
+//# sourceMappingURL=playbook-registry.d.ts.map

package/dist/playbook-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-registry.d.ts","sourceRoot":"","sources":["../src/playbook-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmCD,wBAAsB,aAAa,CACjC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAiD/B;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,SAAS,EAAE,CAGrF;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,gBAAgB,CAWlE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,IAAI,EAAE,MAAM,GACX,SAAS,uBAAuB,EAAE,CA+BpC"}

package/dist/playbook-registry.js

@@ -0,0 +1,148 @@
+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;
+};
+import { existsSync, readFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { pathToFileURL } from 'node:url';
+export const PLAYBOOK_REGISTRY_SCHEMA = 'sharkcraft.playbook-registry/v1';
+const CACHE = new Map();
+async function importDefault(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.playbooks))
+        return mod.playbooks;
+    return [];
+}
+function localPlaybookFiles(inspection) {
+    const out = [];
+    const dir = inspection.sharkcraftDir;
+    if (!dir)
+        return [];
+    for (const f of ['playbooks.ts', 'playbooks/index.ts']) {
+        const full = nodePath.join(dir, f);
+        if (existsSync(full))
+            out.push(full);
+    }
+    const cfg = inspection.config;
+    if (cfg?.playbookFiles) {
+        for (const rel of cfg.playbookFiles)
+            out.push(nodePath.join(dir, rel));
+    }
+    return out;
+}
+export async function loadPlaybooks(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 cached.list;
+    const out = [];
+    for (const file of localPlaybookFiles(inspection)) {
+        try {
+            const list = await importDefault(file);
+            for (const p of list) {
+                if (!p?.id)
+                    continue;
+                out.push({
+                    ...p,
+                    source: 'local',
+                    sourceFile: nodePath.relative(inspection.projectRoot, file),
+                });
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    for (const pack of inspection.packs.validPacks ?? []) {
+        const contributions = (pack.manifest?.contributions ?? {});
+        const packRoot = pack.packageRoot;
+        if (!packRoot)
+            continue;
+        for (const rel of contributions.playbookFiles ?? []) {
+            const file = nodePath.resolve(packRoot, rel);
+            if (!existsSync(file))
+                continue;
+            try {
+                const list = await importDefault(file);
+                for (const p of list) {
+                    if (!p?.id)
+                        continue;
+                    out.push({
+                        ...p,
+                        source: 'pack',
+                        packageName: pack.packageName,
+                        sourceFile: rel,
+                    });
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    CACHE.set(inspection.projectRoot, { cacheKey, list: out });
+    return out;
+}
+export function listPlaybooks(inspection) {
+    const cached = CACHE.get(inspection.projectRoot);
+    return cached?.list ?? [];
+}
+export async function warmPlaybookCache(inspection) {
+    await loadPlaybooks(inspection);
+}
+export function buildRunbook(playbook) {
+    const notes = [];
+    if (playbook.steps.length === 0) {
+        notes.push('Playbook has no steps — add at least one in `definePlaybook`.');
+    }
+    return {
+        playbookId: playbook.id,
+        title: playbook.title ?? playbook.id,
+        steps: playbook.steps,
+        notes,
+    };
+}
+export function recommendPlaybooks(playbooks, task) {
+    const lower = task.toLowerCase();
+    const out = [];
+    for (const p of playbooks) {
+        let score = 0;
+        const reasons = [];
+        if ((p.title ?? p.id).toLowerCase().includes(lower)) {
+            score += 10;
+            reasons.push('title matches task');
+        }
+        for (const t of p.tags ?? []) {
+            if (lower.includes(t.toLowerCase())) {
+                score += 3;
+                reasons.push(`tag ${t}`);
+            }
+        }
+        for (const k of p.taskKinds ?? []) {
+            if (lower.includes(k.toLowerCase())) {
+                score += 4;
+                reasons.push(`taskKind ${k}`);
+            }
+        }
+        for (const ex of p.examples ?? []) {
+            if (lower.includes(ex.toLowerCase()) || ex.toLowerCase().includes(lower)) {
+                score += 3;
+                reasons.push('example matches');
+            }
+        }
+        if (score > 0)
+            out.push({ playbook: p, score, reasons });
+    }
+    return out.sort((a, b) => b.score - a.score);
+}
+void readFileSync;

package/dist/playbook-script.d.ts

@@ -0,0 +1,60 @@
+import type { IPlaybook } from './playbook-registry.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const PLAYBOOK_SCRIPT_SCHEMA = "sharkcraft.playbook-script/v1";
+export declare const PLAYBOOK_VALIDATION_SCHEMA = "sharkcraft.playbook-validation/v1";
+export interface IPlaybookScriptInput {
+    /** Optional task description to render in the script header. */
+    task?: string;
+}
+export interface IPlaybookScript {
+    schema: typeof PLAYBOOK_SCRIPT_SCHEMA;
+    playbookId: string;
+    title: string;
+    task: string | null;
+    /** Bash-like preview. */
+    script: string;
+    /** Step ids → commands actually rendered. */
+    steps: readonly {
+        id: string;
+        title: string;
+        humanReview: boolean;
+        commands: readonly string[];
+    }[];
+    /** Aggregated verification commands collected across steps. */
+    verificationCommands: readonly string[];
+}
+export interface IPlaybookValidationIssue {
+    severity: 'info' | 'warning' | 'error';
+    code: string;
+    message: string;
+    stepId?: string;
+}
+export interface IPlaybookValidation {
+    schema: typeof PLAYBOOK_VALIDATION_SCHEMA;
+    playbookId: string;
+    issues: readonly IPlaybookValidationIssue[];
+    passed: boolean;
+}
+export declare function buildPlaybookScript(playbook: IPlaybook, input?: IPlaybookScriptInput): IPlaybookScript;
+export interface IPlaybookPreview {
+    playbookId: string;
+    title: string;
+    description: string | null;
+    steps: readonly {
+        id: string;
+        title: string;
+        description?: string;
+        commands: readonly string[];
+        mcpTools: readonly string[];
+        humanReview: boolean;
+        verificationCommands: readonly string[];
+        safetyNotes: readonly string[];
+    }[];
+    recommendedPresetIds: readonly string[];
+    recommendedPipelineIds: readonly string[];
+    recommendedTemplateIds: readonly string[];
+    outputs: readonly string[];
+}
+export declare function buildPlaybookPreview(playbook: IPlaybook): IPlaybookPreview;
+export declare function validatePlaybook(playbook: IPlaybook, inspection: ISharkcraftInspection): IPlaybookValidation;
+//# sourceMappingURL=playbook-script.d.ts.map

package/dist/playbook-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-script.d.ts","sourceRoot":"","sources":["../src/playbook-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACnG,+DAA+D;IAC/D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,0BAA0B,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC5C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,EACnB,KAAK,GAAE,oBAAyB,GAC/B,eAAe,CA4DjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,SAAS;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC;QACrB,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;KAChC,EAAE,CAAC;IACJ,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,GAAG,gBAAgB,CAoB1E;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,qBAAqB,GAChC,mBAAmB,CA0ErB"}

package/dist/playbook-script.js

@@ -0,0 +1,161 @@
+export const PLAYBOOK_SCRIPT_SCHEMA = 'sharkcraft.playbook-script/v1';
+export const PLAYBOOK_VALIDATION_SCHEMA = 'sharkcraft.playbook-validation/v1';
+export function buildPlaybookScript(playbook, input = {}) {
+    const lines = [];
+    const verification = new Set();
+    const steps = [];
+    lines.push('#!/usr/bin/env bash');
+    lines.push('# Playbook script preview — generated by `shrk playbooks script`.');
+    lines.push('# This script is NEVER executed by SharkCraft. Review and run manually.');
+    lines.push('# set -euo pipefail is intentionally omitted; uncomment if you want to run it.');
+    lines.push(`# playbook: ${playbook.id}`);
+    if (input.task)
+        lines.push(`# task:     ${input.task}`);
+    lines.push('');
+    lines.push(`echo "Playbook: ${playbook.title.replace(/"/g, '\\"')}"`);
+    if (playbook.description)
+        lines.push(`echo "${playbook.description.replace(/"/g, '\\"')}"`);
+    lines.push('');
+    for (const step of playbook.steps) {
+        lines.push(`# === step ${step.id} — ${step.title} ===`);
+        if (step.description)
+            lines.push(`#   ${step.description}`);
+        if (step.humanReview) {
+            lines.push('# ⚠ HUMAN REVIEW REQUIRED before running the commands below.');
+        }
+        for (const tool of step.mcpTools ?? []) {
+            lines.push(`# MCP tool suggestion: ${tool}`);
+        }
+        const cmds = step.commands ?? [];
+        if (cmds.length === 0) {
+            lines.push(`# (no commands; manual step)`);
+        }
+        else {
+            for (const c of cmds) {
+                lines.push(c);
+            }
+        }
+        if (step.safetyNotes?.length) {
+            for (const n of step.safetyNotes)
+                lines.push(`# safety: ${n}`);
+        }
+        if (step.verificationCommands?.length) {
+            lines.push('# verify:');
+            for (const v of step.verificationCommands) {
+                lines.push(`#   $ ${v}`);
+                verification.add(v);
+            }
+        }
+        lines.push('');
+        steps.push({
+            id: step.id,
+            title: step.title,
+            humanReview: Boolean(step.humanReview),
+            commands: cmds,
+        });
+    }
+    lines.push('echo "Playbook complete. Run any verification commands listed above."');
+    return {
+        schema: PLAYBOOK_SCRIPT_SCHEMA,
+        playbookId: playbook.id,
+        title: playbook.title,
+        task: input.task ?? null,
+        script: lines.join('\n') + '\n',
+        steps,
+        verificationCommands: [...verification],
+    };
+}
+export function buildPlaybookPreview(playbook) {
+    return {
+        playbookId: playbook.id,
+        title: playbook.title ?? playbook.id,
+        description: playbook.description ?? null,
+        steps: playbook.steps.map((s) => ({
+            id: s.id,
+            title: s.title,
+            ...(s.description ? { description: s.description } : {}),
+            commands: s.commands ?? [],
+            mcpTools: s.mcpTools ?? [],
+            humanReview: Boolean(s.humanReview),
+            verificationCommands: s.verificationCommands ?? [],
+            safetyNotes: s.safetyNotes ?? [],
+        })),
+        recommendedPresetIds: playbook.recommendedPresetIds ?? [],
+        recommendedPipelineIds: playbook.recommendedPipelineIds ?? [],
+        recommendedTemplateIds: playbook.recommendedTemplateIds ?? [],
+        outputs: playbook.outputs ?? [],
+    };
+}
+export function validatePlaybook(playbook, inspection) {
+    const issues = [];
+    if (!playbook.steps || playbook.steps.length === 0) {
+        issues.push({
+            severity: 'error',
+            code: 'no-steps',
+            message: 'Playbook has no steps.',
+        });
+    }
+    const seenSteps = new Set();
+    for (const s of playbook.steps ?? []) {
+        if (!s.id) {
+            issues.push({
+                severity: 'error',
+                code: 'step-missing-id',
+                message: `Step is missing an id (title="${s.title ?? ''}")`,
+            });
+            continue;
+        }
+        if (seenSteps.has(s.id)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate-step-id',
+                message: `Duplicate step id "${s.id}"`,
+                stepId: s.id,
+            });
+        }
+        seenSteps.add(s.id);
+        if (!s.title) {
+            issues.push({
+                severity: 'warning',
+                code: 'step-missing-title',
+                message: `Step "${s.id}" has no title.`,
+                stepId: s.id,
+            });
+        }
+        const hasAction = (s.commands && s.commands.length > 0) || (s.mcpTools && s.mcpTools.length > 0);
+        if (!hasAction && !s.humanReview) {
+            issues.push({
+                severity: 'warning',
+                code: 'step-empty',
+                message: `Step "${s.id}" has no commands, MCP tools, or humanReview marker.`,
+                stepId: s.id,
+            });
+        }
+    }
+    // Cross-reference recommended templates / pipelines / presets against the registries.
+    for (const t of playbook.recommendedTemplateIds ?? []) {
+        if (!inspection.templateRegistry.get(t)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing-template',
+                message: `recommendedTemplateIds references template "${t}" that is not registered.`,
+            });
+        }
+    }
+    for (const p of playbook.recommendedPipelineIds ?? []) {
+        if (!inspection.pipelineRegistry.get(p)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing-pipeline',
+                message: `recommendedPipelineIds references pipeline "${p}" that is not registered.`,
+            });
+        }
+    }
+    const passed = issues.filter((i) => i.severity === 'error').length === 0;
+    return {
+        schema: PLAYBOOK_VALIDATION_SCHEMA,
+        playbookId: playbook.id,
+        issues,
+        passed,
+    };
+}

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

@@ -0,0 +1,52 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,202 @@
+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,
+    };
+}