@nklisch/pi-enhanced 0.2.2 → 0.2.4

package/node_modules/@nklisch/pi-plugins/dist/application/native-failure-presenter.d.ts

@@ -1,12 +0,0 @@
-import type { NativeDiagnostic, SafeDisplayField } from "./native-inspection-contract.js";
-import type { MarketplaceAddRejectionCode } from "./marketplace-management-contract.js";
-/**
- * Compose plain-language lines for the diagnostics a user must see. Blocking
- * errors first; the umbrella SOURCE_INVALID code is skipped whenever more
- * specific lines exist.
- */
-export declare function presentNativeDiagnostics(diagnostics: readonly NativeDiagnostic[]): readonly SafeDisplayField[];
-/** Actionable human text for a rejected marketplace registration. */
-export declare function presentMarketplaceAddFailure(code: MarketplaceAddRejectionCode): SafeDisplayField;
-/** Human text for control-level failure codes that carry no detail context. */
-export declare function presentControlFailure(code: string): SafeDisplayField | undefined;

package/node_modules/@nklisch/pi-plugins/dist/application/native-failure-presenter.js

@@ -1,179 +0,0 @@
-import { NativeDisplayLimits, toSafeDisplayField } from "./native-inspection-display.js";
-/**
- * User-facing failure text. Everything here speaks in marketplace/plugin
- * terms — Claude and Codex documents, skills, hooks, MCP servers — never in
- * implementation vocabulary (claim conflicts, provenance, digests).
- */
-function safe(value) {
-    return toSafeDisplayField(value, { maxScalars: NativeDisplayLimits.descriptionScalars });
-}
-function factValue(diagnostic, key) {
-    const fact = diagnostic.facts.find((candidate) => candidate.key === key);
-    return fact?.value.text;
-}
-function documentLabel(provenance) {
-    if (provenance === undefined)
-        return undefined;
-    const host = provenance.host === "claude" ? "Claude" : "Codex";
-    return `\`${provenance.path.text}\` (${host})`;
-}
-function reasonSentence(reason) {
-    switch (reason) {
-        case "invalid-json": return "isn't valid JSON";
-        case "wrong-shape": return "doesn't match the expected format for that file";
-        case "missing-target": return "points at a file or directory that isn't in the plugin";
-        case "path-escape": return "points outside the plugin's own directory, which isn't allowed";
-        case "field-conflict": return "";
-        case "source-unreachable": return "couldn't be fetched or resolved";
-        case "content-mismatch": return "doesn't match its expected content hash";
-        default: return "couldn't be read";
-    }
-}
-function fieldLabel(field) {
-    if (field === undefined)
-        return "the same setting";
-    const friendly = {
-        description: "the plugin description",
-        version: "the plugin version",
-        name: "the plugin name",
-        "policy.availability": "the installation policy",
-        "policy.authentication": "the authentication policy",
-    };
-    return friendly[field] ?? `\`${field}\``;
-}
-function lineFor(diagnostic) {
-    const first = diagnostic.provenance[0];
-    const second = diagnostic.provenance[1];
-    const document = documentLabel(first);
-    switch (diagnostic.code) {
-        case "SOURCE_DOCUMENT_INVALID": {
-            const reason = reasonSentence(factValue(diagnostic, "reason"));
-            return document === undefined
-                ? `A plugin document ${reason}.`
-                : `${document} ${reason}.`;
-        }
-        case "SOURCE_DECLARATION_CONFLICT": {
-            const field = fieldLabel(factValue(diagnostic, "field"));
-            const left = documentLabel(first);
-            const right = documentLabel(second);
-            if (left !== undefined && right !== undefined && left !== right) {
-                return `${left} and ${right} disagree about ${field}.`;
-            }
-            return left === undefined
-                ? `Two plugin declarations disagree about ${field}.`
-                : `${left} disagrees with another declaration about ${field}.`;
-        }
-        case "SOURCE_CONTENT_UNSAFE": {
-            const reason = reasonSentence(factValue(diagnostic, "reason"));
-            return document === undefined
-                ? `The plugin source ${reason}.`
-                : `${document} ${reason}.`;
-        }
-        case "SOURCE_INVALID":
-            // Umbrella code: specifics (if any) render their own lines.
-            return undefined;
-        case "SOURCE_UNAVAILABLE":
-            return "The plugin's content isn't available right now; retry in a moment.";
-        case "COMPATIBILITY_INCOMPATIBLE":
-            // Fires for unsupported declarations AND for capabilities missing from
-            // this session; the requirement lines carry the specifics.
-            return "Something this plugin declares can't run in this pi session.";
-        case "RUNTIME_REQUIREMENT_UNAVAILABLE":
-            return "A capability this plugin needs isn't available in this pi session.";
-        case "MCP_RUNTIME_UNAVAILABLE": {
-            const reason = factValue(diagnostic, "reason");
-            if (reason === undefined)
-                return "The MCP runtime is unavailable for an enabled MCP plugin. Update pi-plugins and pi-mcp-adapter together; they are released jointly.";
-            const separator = /[.!?]$/u.test(reason) ? " " : ". ";
-            return `The MCP runtime is unavailable for an enabled MCP plugin: ${reason}${separator}Update pi-plugins and pi-mcp-adapter together; they are released jointly.`;
-        }
-        case "TRUST_REQUIRED":
-            return "This exact plugin revision needs your trust approval first.";
-        case "TRUST_REVOKED":
-            return "Trust for this exact plugin revision was revoked.";
-        case "CONFIGURATION_REQUIRED":
-            return "This plugin needs configuration values before it can run.";
-        case "PROJECT_UNTRUSTED":
-            return "This project isn't trusted, so project-scope changes are refused.";
-        case "CATALOG_UNAVAILABLE":
-            return "The marketplace catalog isn't available; refresh the marketplace and retry.";
-        case "CATALOG_STALE":
-            return "The marketplace catalog is stale; refresh the marketplace and retry.";
-        case "CATALOG_CORRUPT":
-            return "The marketplace catalog is corrupt; remove and re-add the marketplace.";
-        case "CANDIDATE_MISSING":
-            return "That plugin is no longer in the marketplace; refresh and browse again.";
-        case "PLUGIN_DEGRADED":
-            return "This plugin is degraded; repair it or roll back to its previous revision.";
-        case "PLUGIN_FALLBACK_ACTIVE":
-            return "This plugin is running its previous revision; repair the selected revision or keep this fallback with rollback.";
-        case "CONVERGENCE_BLOCKED":
-            return "Startup convergence could not finish; inspect the plugin host and retry repair.";
-        default:
-            return undefined;
-    }
-}
-/**
- * Compose plain-language lines for the diagnostics a user must see. Blocking
- * errors first; the umbrella SOURCE_INVALID code is skipped whenever more
- * specific lines exist.
- */
-export function presentNativeDiagnostics(diagnostics) {
-    const lines = [];
-    for (const diagnostic of diagnostics) {
-        if (diagnostic.severity !== "error")
-            continue;
-        const line = lineFor(diagnostic);
-        if (line !== undefined && !lines.includes(line))
-            lines.push(line);
-    }
-    if (lines.length === 0 && diagnostics.some((diagnostic) => diagnostic.code === "SOURCE_INVALID")) {
-        lines.push("The plugin couldn't be read; inspect its source for details.");
-    }
-    return Object.freeze(lines.map((line) => safe(line)));
-}
-/** Actionable human text for a rejected marketplace registration. */
-export function presentMarketplaceAddFailure(code) {
-    switch (code) {
-        case "INVALID_SOURCE":
-            return safe("That repository address isn't valid. For GitHub, use `owner/repository`; for a Git URL, use the complete `https://…` or `ssh://…` address.");
-        case "PROJECT_UNTRUSTED":
-            return safe("This project isn't trusted, so it can't register a project marketplace. Trust the project or add the marketplace globally.");
-        case "NOT_PORTABLE":
-            return safe("A local checkout can't be registered for a project because other machines couldn't resolve it. Use a GitHub repository or Git URL instead.");
-        case "NAME_CONFLICT":
-            return safe("This catalog uses the same marketplace name as a different configured source. Remove the existing marketplace or give one catalog a distinct name.");
-        case "SOURCE_NAME_CHANGED":
-            return safe("This repository now declares a different marketplace name. Remove its existing registration, then add it again.");
-        case "SOURCE_UNAVAILABLE":
-            return safe("The repository couldn't be fetched or resolved. Check that it exists, that this machine can access it, and that private-repository credentials are available.");
-        case "CATALOG_INVALID":
-            return safe("The repository was fetched, but its marketplace catalog is missing, invalid, or internally conflicting. Check `.claude-plugin/marketplace.json` or `.agents/plugins/marketplace.json`.");
-        case "PROMOTION_FAILED":
-            return safe("The catalog was fetched, but pi couldn't save its verified content locally. Check the plugin-host storage permissions and available disk space, then retry.");
-        case "STATE_CORRUPT":
-            return safe("The plugin host's marketplace state couldn't be read safely. Run `/plugins doctor` before retrying.");
-        case "STATE_STALE":
-            return safe("Marketplace state changed while the source was being added. Refresh and retry.");
-    }
-}
-/** Human text for control-level failure codes that carry no detail context. */
-export function presentControlFailure(code) {
-    switch (code) {
-        case "CONTROL_TARGET_SELECTION_FAILED":
-            // Selection fails for any lifecycle action (add/update/enable/remove),
-            // so the text must not name install specifically.
-            return safe("That couldn't start — the plugin's current details couldn't be loaded. Refresh and try again.");
-        case "CONTROL_SELECTION_UNAVAILABLE":
-            return safe("That plugin can't be inspected right now; refresh the marketplace and retry.");
-        case "CONTROL_READINESS_BLOCKED":
-            return safe("The plugin host isn't ready yet; retry in a moment.");
-        case "CONTROL_REQUEST_INVALID":
-            return safe("That command didn't parse; plugins are named `<name>@<marketplace>` (for example `agile-workflow@nklisch-skills`).");
-        case "CONFIRMATION_REQUIRED":
-            return safe("That action needs confirmation.");
-        default:
-            return undefined;
-    }
-}
-//# sourceMappingURL=native-failure-presenter.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/native-failure-presenter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-failure-presenter.js","sourceRoot":"","sources":["../../src/application/native-failure-presenter.ts"],"names":[],"mappings":"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"}